abinnovision/nestjs-commons

A collection of common packages for NestJS.

Goals

The packages in this repo share a deliberate house style:

• Class-based DI — no string tokens; injection sites are typed and refactor-safe.
• Schema-driven types — Standard Schema (Zod, ArkType, …) and TypeScript module augmentation, not call-site generics.
• Testable by default — every public token is overrideProvider-friendly; dedicated fakes where it helps.
• Thin wrappers — we glue best-in-class upstream libraries into Nest, not replace them.

Packages

Package	Version	Description
@abinnovision/nestjs-configx		Type-safe configuration for NestJS using Standard Schema.
@abinnovision/nestjs-exceptions		Standardized NestJS exception handling with entity-focused exceptions, HTTP awareness, and built-in support for GraphQL and REST APIs.
@abinnovision/nestjs-flydrive		NestJS integration for flydrive with class-token disks, eager fail-fast startup, and a fakes API for tests.
@abinnovision/nestjs-hatchet		NestJS integration for Hatchet workflow orchestration.
@abinnovision/nestjs-healthz		Self-mounting health check module with cross-module attestor discovery and Kubernetes-style probes.
@abinnovision/nestjs-toolkit		NestJS utility library providing Remeda functional helpers, string manipulation, and UUID operations for common development tasks.

See each package README for installation and usage instructions.

Compatibility

• NestJS 11+
• Node.js 24+
• Module formats — ESM and CJS dual builds; types for both
• License — Apache-2.0

Examples

Runnable Nest apps under examples/:

• configuration — @abinnovision/nestjs-configx end-to-end.
• hatchet-integration — @abinnovision/nestjs-hatchet workflows + events.

Versioning

Each package is versioned independently via release-please — versions in the table above are not aligned.

Development

Yarn 4 monorepo with Turbo.

Prerequisites

• Node.js 24+ (see .tool-versions)
• Corepack enabled (corepack enable)
• Docker (for hatchet integration tests)

Setup

yarn install

For hatchet integration tests, copy the example env file and start the required services:

cp .env.example .env
docker compose up -d

Commands

yarn build          # Build all packages
yarn check          # Lint + format checks
yarn fix            # Auto-fix lint/format
yarn test           # Run all tests
yarn test-unit      # Run unit tests only

License

Apache-2.0