@cqrs-ddd/nestjs 0.5.0

package/README.md

@@ -0,0 +1,46 @@
+# @cqrs-ddd/nestjs
+
+The NestJS adapter of the [`@cqrs-ddd`](https://github.com/aristoteliss/ddd-cqrs) packages.
+Your application keeps NestJS and official `@nestjs/cqrs`; this package adds what NestJS
+lacks:
+
+- `PipelineModule.forRoot({ globalBehaviors, sources, diagnostics })` runs every
+  `@nestjs/cqrs` handler through the behaviors of its `@UsePipeline`. Each module provides
+  the behaviors it configures under their class; startup fails on a missing or doubly
+  provided behavior and on a request-scoped handler that runs behaviors.
+- `ErrorFilter` (global, `APP_FILTER`) answers every `@cqrs-ddd` error as a NestJS
+  `HttpException` with NestJS's body (`statusCode`, `message`, `error`); `toHttpException`
+  and `httpAnswer` do the conversion alone.
+- `@cqrs-ddd/nestjs/correlation`: `CorrelationMiddleware`.
+- `@cqrs-ddd/nestjs/job-context`: `JobContextModule.forRoot({ principal, tenants, sources })`.
+
+```ts
+@Module({
+  imports: [
+    CqrsModule.forRoot(),
+    PipelineModule.forRoot({
+      sources: { tenantId: tenantSource, correlationId: correlationSource },
+      globalBehaviors: [{ scope: 'all', before: [logging()] }],
+    }),
+  ],
+  providers: [
+    { provide: LoggingBehavior, useFactory: () => new LoggingBehavior(new Logger('Pipeline')) },
+    { provide: APP_FILTER, useClass: ErrorFilter },
+  ],
+})
+export class AppModule {}
+```
+
+## Install
+
+```bash
+pnpm add @cqrs-ddd/nestjs @cqrs-ddd/pipeline @cqrs-ddd/core
+```
+
+Peers: `@nestjs/common`, `@nestjs/core` and `@nestjs/cqrs` 12, `@cqrs-ddd/pipeline` and
+`@cqrs-ddd/core` 0.5. The behavior packages (`-zod`, `-casl`, `-feature-flags`,
+`-rate-limit`, `-idempotency`, `-correlation`, `-job-context`) are optional peers: their
+errors are converted when they are installed. Node.js 22.12 or newer.
+
+Guide: https://aristoteliss.github.io/ddd-cqrs/packages/nestjs/. A complete NestJS
+application: [nestjs-pipeline `api/`](https://github.com/aristoteliss/nestjs-pipeline/tree/master/api).

package/dist/correlation.d.ts

@@ -0,0 +1,22 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { type NestMiddleware } from '@nestjs/common';
+/**
+ * Takes the correlation id of every request from its header, or creates one,
+ * runs the request with it so the pipelines it starts take it, and echoes it
+ * on the response: `httpCorrelation()` of `@cqrs-ddd/pipeline-correlation` as
+ * a NestJS middleware.
+ *
+ * @example
+ * ```ts
+ * export class AppModule implements NestModule {
+ *   configure(consumer: MiddlewareConsumer) {
+ *     consumer.apply(CorrelationMiddleware).forRoutes('*');
+ *   }
+ * }
+ * ```
+ */
+export declare class CorrelationMiddleware implements NestMiddleware {
+    private readonly correlate;
+    use(request: IncomingMessage, response: ServerResponse, next: () => void): void;
+}
+//# sourceMappingURL=correlation.d.ts.map

package/dist/correlation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.d.ts","sourceRoot":"","sources":["../src/correlation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AACH,qBACa,qBAAsB,YAAW,cAAc;IAC1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAE/C,GAAG,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,IAAI,QAEvE;CACF"}

package/dist/correlation.js

@@ -0,0 +1,35 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { httpCorrelation } from '@cqrs-ddd/pipeline-correlation';
+import { Injectable } from '@nestjs/common';
+/**
+ * Takes the correlation id of every request from its header, or creates one,
+ * runs the request with it so the pipelines it starts take it, and echoes it
+ * on the response: `httpCorrelation()` of `@cqrs-ddd/pipeline-correlation` as
+ * a NestJS middleware.
+ *
+ * @example
+ * ```ts
+ * export class AppModule implements NestModule {
+ *   configure(consumer: MiddlewareConsumer) {
+ *     consumer.apply(CorrelationMiddleware).forRoutes('*');
+ *   }
+ * }
+ * ```
+ */
+let CorrelationMiddleware = class CorrelationMiddleware {
+    correlate = httpCorrelation();
+    use(request, response, next) {
+        this.correlate(request, response, next);
+    }
+};
+CorrelationMiddleware = __decorate([
+    Injectable()
+], CorrelationMiddleware);
+export { CorrelationMiddleware };
+//# sourceMappingURL=correlation.js.map

package/dist/correlation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation.js","sourceRoot":"","sources":["../src/correlation.ts"],"names":[],"mappings":"AAAA,sEAAsE;;;;;;;AAGtE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAuB,MAAM,gBAAgB,CAAC;AAEjE;;;;;;;;;;;;;;GAcG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IACf,SAAS,GAAG,eAAe,EAAE,CAAC;IAE/C,GAAG,CAAC,OAAwB,EAAE,QAAwB,EAAE,IAAgB;QACtE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF,CAAA;AANY,qBAAqB;IADjC,UAAU,EAAE;GACA,qBAAqB,CAMjC"}

package/dist/filters/error.filter.d.ts

@@ -0,0 +1,19 @@
+import { type ArgumentsHost } from '@nestjs/common';
+import { BaseExceptionFilter } from '@nestjs/core';
+/**
+ * Answers every error through NestJS's own exception handling: an error of a
+ * `@cqrs-ddd` package is first converted to its NestJS `HttpException` (see
+ * `httpAnswer`), with its headers such as `Retry-After`; anything else is
+ * handled exactly as Nest handles it by default. It works on Express and
+ * Fastify, also for errors thrown in middleware.
+ *
+ * @example
+ * ```ts
+ * @Module({ providers: [{ provide: APP_FILTER, useClass: ErrorFilter }] })
+ * export class AppModule {}
+ * ```
+ */
+export declare class ErrorFilter extends BaseExceptionFilter {
+    catch(exception: unknown, host: ArgumentsHost): void;
+}
+//# sourceMappingURL=error.filter.d.ts.map

package/dist/filters/error.filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.filter.d.ts","sourceRoot":"","sources":["../../src/filters/error.filter.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAA0B,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAGnD;;;;;;;;;;;;GAYG;AACH,qBACa,WAAY,SAAQ,mBAAmB;IAClD,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAWnD;CACF"}

package/dist/filters/error.filter.js

@@ -0,0 +1,42 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Catch } from '@nestjs/common';
+import { BaseExceptionFilter } from '@nestjs/core';
+import { httpAnswer } from './http-exception.js';
+/**
+ * Answers every error through NestJS's own exception handling: an error of a
+ * `@cqrs-ddd` package is first converted to its NestJS `HttpException` (see
+ * `httpAnswer`), with its headers such as `Retry-After`; anything else is
+ * handled exactly as Nest handles it by default. It works on Express and
+ * Fastify, also for errors thrown in middleware.
+ *
+ * @example
+ * ```ts
+ * @Module({ providers: [{ provide: APP_FILTER, useClass: ErrorFilter }] })
+ * export class AppModule {}
+ * ```
+ */
+let ErrorFilter = class ErrorFilter extends BaseExceptionFilter {
+    catch(exception, host) {
+        const answer = httpAnswer(exception);
+        if (answer) {
+            const adapter = (this.httpAdapterHost?.httpAdapter ??
+                this.applicationRef);
+            const response = host.getArgByIndex(1);
+            for (const [name, value] of Object.entries(answer.headers)) {
+                adapter.setHeader(response, name, value);
+            }
+        }
+        super.catch(answer?.exception ?? exception, host);
+    }
+};
+ErrorFilter = __decorate([
+    Catch()
+], ErrorFilter);
+export { ErrorFilter };
+//# sourceMappingURL=error.filter.js.map

package/dist/filters/error.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.filter.js","sourceRoot":"","sources":["../../src/filters/error.filter.ts"],"names":[],"mappings":"AAAA,sEAAsE;;;;;;;AAEtE,OAAO,EAAsB,KAAK,EAAmB,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;;;;;;;;;GAYG;AAEI,IAAM,WAAW,GAAjB,MAAM,WAAY,SAAQ,mBAAmB;IAClD,KAAK,CAAC,SAAkB,EAAE,IAAmB;QAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,WAAW;gBAChD,IAAI,CAAC,cAAc,CAAe,CAAC;YACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YACvC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3D,OAAO,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,IAAI,SAAS,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;CACF,CAAA;AAbY,WAAW;IADvB,KAAK,EAAE;GACK,WAAW,CAavB"}

package/dist/filters/http-exception.d.ts

@@ -0,0 +1,53 @@
+import { HttpException } from '@nestjs/common';
+/** A NestJS exception for a package error, and the headers its answer carries. */
+export interface HttpAnswer {
+    readonly exception: HttpException;
+    readonly headers: Readonly<Record<string, string>>;
+}
+/** The flattened issues a `ZodValidationError` carries in `details`. */
+export interface ValidationDetails {
+    readonly formErrors: readonly string[];
+    readonly fieldErrors: Readonly<Record<string, readonly string[] | undefined>>;
+}
+/**
+ * The validation messages of NestJS's `StandardSchemaValidationPipe` for
+ * flattened Zod issues: a form error as it is, a field error as
+ * `field: message`.
+ *
+ * @example
+ * ```ts
+ * validationMessages({ formErrors: [], fieldErrors: { email: ['Invalid email'] } });
+ * // ['email: Invalid email']
+ * ```
+ */
+export declare function validationMessages(details: ValidationDetails): string[];
+/**
+ * The NestJS exception and headers for an error of a `@cqrs-ddd` package, or
+ * `undefined` for any other error. A `ZodValidationError` becomes the
+ * `BadRequestException` NestJS's validation pipe throws (`message` lists the
+ * issues); a denied action, a disabled feature, an exceeded rate limit and an
+ * idempotency conflict take the status, body and headers their package's
+ * `toHttpResponse` defines; a `@cqrs-ddd/core` domain error takes
+ * `domainErrorHttpStatus`. Every body has NestJS's `statusCode`, `message` and
+ * `error`.
+ *
+ * @example
+ * ```ts
+ * const answer = httpAnswer(new RateLimitExceededError(details));
+ * answer?.exception.getStatus(); // 429
+ * answer?.headers; // { 'Retry-After': '3' }
+ * ```
+ */
+export declare function httpAnswer(error: unknown): HttpAnswer | undefined;
+/**
+ * The NestJS `HttpException` for an error of a `@cqrs-ddd` package, or
+ * `undefined` for any other error; see {@link httpAnswer}, which also gives the
+ * headers.
+ *
+ * @example
+ * ```ts
+ * throw toHttpException(error) ?? error;
+ * ```
+ */
+export declare function toHttpException(error: unknown): HttpException | undefined;
+//# sourceMappingURL=http-exception.d.ts.map

package/dist/filters/http-exception.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-exception.d.ts","sourceRoot":"","sources":["../../src/filters/http-exception.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEpE,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACpD;AAED,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;CAC/E;AAUD;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAOvE;AAmFD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAMjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAEzE"}

package/dist/filters/http-exception.js

@@ -0,0 +1,118 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { createRequire } from 'node:module';
+import { domainErrorHttpStatus } from '@cqrs-ddd/core/http';
+import { BadRequestException, HttpException } from '@nestjs/common';
+/**
+ * The validation messages of NestJS's `StandardSchemaValidationPipe` for
+ * flattened Zod issues: a form error as it is, a field error as
+ * `field: message`.
+ *
+ * @example
+ * ```ts
+ * validationMessages({ formErrors: [], fieldErrors: { email: ['Invalid email'] } });
+ * // ['email: Invalid email']
+ * ```
+ */
+export function validationMessages(details) {
+    return [
+        ...details.formErrors,
+        ...Object.entries(details.fieldErrors).flatMap(([field, messages]) => (messages ?? []).map((message) => `${field}: ${message}`)),
+    ];
+}
+const require = createRequire(import.meta.url);
+function installed(name) {
+    try {
+        require.resolve(name);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function optional(name) {
+    return installed(name)
+        ? require(name)
+        : undefined;
+}
+// Errors are matched by name, not by class, so an error from a second copy of its
+// package (a bundled one) converts too; every package error sets its `name`.
+function named(error, name) {
+    return error instanceof Error && error.name === name;
+}
+function packageConverter(name, errorName) {
+    const toHttpResponse = optional(`${name}/http`)?.toHttpResponse;
+    if (!toHttpResponse)
+        return undefined;
+    return (error) => {
+        if (!named(error, errorName))
+            return undefined;
+        const { status, body, headers } = toHttpResponse(error);
+        return { exception: new HttpException(body, status), headers };
+    };
+}
+const validationConverter = (error) => named(error, 'ZodValidationError')
+    ? {
+        exception: new BadRequestException(validationMessages(error.details)),
+        headers: {},
+    }
+    : undefined;
+const domainConverter = (error) => {
+    const status = domainErrorHttpStatus(error);
+    if (!status)
+        return undefined;
+    const { statusCode, error: reason, message } = status;
+    return {
+        exception: new HttpException({ statusCode, message, error: reason }, statusCode),
+        headers: {},
+    };
+};
+// Behavior packages are optional peers: each converts only when installed.
+const converters = [
+    validationConverter,
+    ...[
+        packageConverter('@cqrs-ddd/pipeline-casl', 'UnauthorizedActionException'),
+        packageConverter('@cqrs-ddd/pipeline-feature-flags', 'FeatureDisabledError'),
+        packageConverter('@cqrs-ddd/pipeline-rate-limit', 'RateLimitExceededError'),
+        packageConverter('@cqrs-ddd/pipeline-idempotency', 'IdempotencyConflictError'),
+    ].filter((convert) => convert !== undefined),
+    domainConverter,
+];
+/**
+ * The NestJS exception and headers for an error of a `@cqrs-ddd` package, or
+ * `undefined` for any other error. A `ZodValidationError` becomes the
+ * `BadRequestException` NestJS's validation pipe throws (`message` lists the
+ * issues); a denied action, a disabled feature, an exceeded rate limit and an
+ * idempotency conflict take the status, body and headers their package's
+ * `toHttpResponse` defines; a `@cqrs-ddd/core` domain error takes
+ * `domainErrorHttpStatus`. Every body has NestJS's `statusCode`, `message` and
+ * `error`.
+ *
+ * @example
+ * ```ts
+ * const answer = httpAnswer(new RateLimitExceededError(details));
+ * answer?.exception.getStatus(); // 429
+ * answer?.headers; // { 'Retry-After': '3' }
+ * ```
+ */
+export function httpAnswer(error) {
+    for (const convert of converters) {
+        const answer = convert(error);
+        if (answer)
+            return answer;
+    }
+    return undefined;
+}
+/**
+ * The NestJS `HttpException` for an error of a `@cqrs-ddd` package, or
+ * `undefined` for any other error; see {@link httpAnswer}, which also gives the
+ * headers.
+ *
+ * @example
+ * ```ts
+ * throw toHttpException(error) ?? error;
+ * ```
+ */
+export function toHttpException(error) {
+    return httpAnswer(error)?.exception;
+}
+//# sourceMappingURL=http-exception.js.map

package/dist/filters/http-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-exception.js","sourceRoot":"","sources":["../../src/filters/http-exception.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * The NestJS adapter: `PipelineModule` runs official `@nestjs/cqrs` handlers through
+ * their pipelines, and `ErrorFilter` answers every package error as a NestJS
+ * `HttpException`. Correlation and job context are the `@cqrs-ddd/nestjs/correlation`
+ * and `@cqrs-ddd/nestjs/job-context` entry points.
+ *
+ * @module main
+ */
+export { ErrorFilter } from './filters/error.filter.js';
+export { type HttpAnswer, httpAnswer, toHttpException, type ValidationDetails, validationMessages, } from './filters/http-exception.js';
+export { PIPELINE_OPTIONS, PipelineBootstrap, type PipelineOptions, } from './pipeline/pipeline.bootstrap.js';
+export { PipelineModule } from './pipeline/pipeline.module.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EACL,KAAK,UAAU,EACf,UAAU,EACV,eAAe,EACf,KAAK,iBAAiB,EACtB,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,eAAe,GACrB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+/**
+ * The NestJS adapter: `PipelineModule` runs official `@nestjs/cqrs` handlers through
+ * their pipelines, and `ErrorFilter` answers every package error as a NestJS
+ * `HttpException`. Correlation and job context are the `@cqrs-ddd/nestjs/correlation`
+ * and `@cqrs-ddd/nestjs/job-context` entry points.
+ *
+ * @module main
+ */
+export { ErrorFilter } from './filters/error.filter.js';
+export { httpAnswer, toHttpException, validationMessages, } from './filters/http-exception.js';
+export { PIPELINE_OPTIONS, PipelineBootstrap, } from './pipeline/pipeline.bootstrap.js';
+export { PipelineModule } from './pipeline/pipeline.module.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAEL,UAAU,EACV,eAAe,EAEf,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/job-context.d.ts

@@ -0,0 +1,39 @@
+import { type IJobPrincipal, type JobContextSources } from '@cqrs-ddd/pipeline-job-context';
+import { type DynamicModule, type ModuleMetadata, type Type } from '@nestjs/common';
+/** How `JobContextModule` registers the job context. */
+export interface JobContextModuleOptions {
+    /** Modules that provide the principal's dependencies. */
+    readonly imports?: ModuleMetadata['imports'];
+    /** The provider that loads a job's principal again. */
+    readonly principal: Type<IJobPrincipal>;
+    /** The tenants a job may name, or a function read when the module starts. */
+    readonly tenants: readonly string[] | (() => readonly string[]);
+    /** Where the tenant and correlation id are read and restored. */
+    readonly sources: JobContextSources;
+}
+/**
+ * Lets the jobs a request enqueues carry its tenant, correlation id and
+ * principal (`withJobContext`), and restores them in processors
+ * (`@InJobContext()`): registers the application's job principal, tenants and
+ * context sources with `@cqrs-ddd/pipeline-job-context` when the module starts,
+ * and unregisters them on shutdown.
+ *
+ * @example
+ * ```ts
+ * @Module({
+ *   imports: [
+ *     JobContextModule.forRoot({
+ *       imports: [AuthsModule],
+ *       principal: SessionJobPrincipal,
+ *       tenants: () => persistenceConfig().tenants,
+ *       sources: { tenantId: tenantSource, correlationId: correlationSource },
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+export declare class JobContextModule {
+    static forRoot(options: JobContextModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=job-context.d.ts.map

package/dist/job-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-context.d.ts","sourceRoot":"","sources":["../src/job-context.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,iBAAiB,EAEvB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,aAAa,EAIlB,KAAK,cAAc,EAEnB,KAAK,IAAI,EACV,MAAM,gBAAgB,CAAC;AAExB,wDAAwD;AACxD,MAAM,WAAW,uBAAuB;IACtC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC7C,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,aAAa,CAAC,CAAC;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,CAAC,MAAM,SAAS,MAAM,EAAE,CAAC,CAAC;IAChE,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AAkBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBACa,gBAAgB;IAC3B,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,uBAAuB,GAAG,aAAa,CAmB9D;CACF"}

package/dist/job-context.js

@@ -0,0 +1,81 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var JobContextModule_1;
+import { registerJobContext, } from '@cqrs-ddd/pipeline-job-context';
+import { Inject, Injectable, Module, } from '@nestjs/common';
+const JOB_PRINCIPAL = Symbol('JOB_PRINCIPAL');
+const JOB_CONTEXT = Symbol('JOB_CONTEXT');
+let JobContextRegistration = class JobContextRegistration {
+    unregister;
+    constructor(options) {
+        this.unregister = registerJobContext(options);
+    }
+    onApplicationShutdown() {
+        this.unregister();
+    }
+};
+JobContextRegistration = __decorate([
+    Injectable(),
+    __param(0, Inject(JOB_CONTEXT)),
+    __metadata("design:paramtypes", [Object])
+], JobContextRegistration);
+/**
+ * Lets the jobs a request enqueues carry its tenant, correlation id and
+ * principal (`withJobContext`), and restores them in processors
+ * (`@InJobContext()`): registers the application's job principal, tenants and
+ * context sources with `@cqrs-ddd/pipeline-job-context` when the module starts,
+ * and unregisters them on shutdown.
+ *
+ * @example
+ * ```ts
+ * @Module({
+ *   imports: [
+ *     JobContextModule.forRoot({
+ *       imports: [AuthsModule],
+ *       principal: SessionJobPrincipal,
+ *       tenants: () => persistenceConfig().tenants,
+ *       sources: { tenantId: tenantSource, correlationId: correlationSource },
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+let JobContextModule = JobContextModule_1 = class JobContextModule {
+    static forRoot(options) {
+        const { tenants, sources } = options;
+        return {
+            module: JobContextModule_1,
+            imports: options.imports ?? [],
+            providers: [
+                { provide: JOB_PRINCIPAL, useClass: options.principal },
+                {
+                    provide: JOB_CONTEXT,
+                    inject: [JOB_PRINCIPAL],
+                    useFactory: (principal) => ({
+                        principal,
+                        tenants: typeof tenants === 'function' ? tenants() : tenants,
+                        sources,
+                    }),
+                },
+                JobContextRegistration,
+            ],
+        };
+    }
+};
+JobContextModule = JobContextModule_1 = __decorate([
+    Module({})
+], JobContextModule);
+export { JobContextModule };
+//# sourceMappingURL=job-context.js.map

package/dist/job-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-context.js","sourceRoot":"","sources":["../src/job-context.ts"],"names":[],"mappings":"AAAA,sEAAsE;;;;;;;;;;;;;;AAEtE,OAAO,EAIL,kBAAkB,GACnB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAEL,MAAM,EACN,UAAU,EACV,MAAM,GAIP,MAAM,gBAAgB,CAAC;AAcxB,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,CAAC,CAAC;AAC9C,MAAM,WAAW,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC;AAE1C,IACM,sBAAsB,GAD5B,MACM,sBAAsB;IACT,UAAU,CAAa;IAExC,YAAiC,OAA0B;QACzD,IAAI,CAAC,UAAU,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,qBAAqB;QACnB,IAAI,CAAC,UAAU,EAAE,CAAC;IACpB,CAAC;CACF,CAAA;AAVK,sBAAsB;IAD3B,UAAU,EAAE;IAIE,WAAA,MAAM,CAAC,WAAW,CAAC,CAAA;;GAH5B,sBAAsB,CAU3B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEI,IAAM,gBAAgB,wBAAtB,MAAM,gBAAgB;IACpB,AAAP,MAAM,CAAC,OAAO,CAAC,OAAgC;QAC7C,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QACrC,OAAO;YACL,MAAM,oBAAkB;YACxB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC,SAAS,EAAE;gBACvD;oBACE,OAAO,EAAE,WAAW;oBACpB,MAAM,EAAE,CAAC,aAAa,CAAC;oBACvB,UAAU,EAAE,CAAC,SAAwB,EAAqB,EAAE,CAAC,CAAC;wBAC5D,SAAS;wBACT,OAAO,EAAE,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO;wBAC5D,OAAO;qBACR,CAAC;iBACH;gBACD,sBAAsB;aACvB;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AArBY,gBAAgB;IAD5B,MAAM,CAAC,EAAE,CAAC;GACE,gBAAgB,CAqB5B"}

package/dist/pipeline/pipeline.bootstrap.d.ts

@@ -0,0 +1,38 @@
+import { type ContextSources, type GlobalBehaviorsOptions } from '@cqrs-ddd/pipeline';
+import { type OnApplicationBootstrap, type OnModuleDestroy } from '@nestjs/common';
+import { DiscoveryService } from '@nestjs/core';
+/** What every handler's pipeline shares. */
+export interface PipelineOptions {
+    readonly globalBehaviors?: GlobalBehaviorsOptions | GlobalBehaviorsOptions[];
+    readonly sources?: ContextSources;
+    /** `'strict'` (default) fails startup on a contract violation, `'warn'` logs it. */
+    readonly diagnostics?: 'strict' | 'warn' | 'off';
+}
+export declare const PIPELINE_OPTIONS: unique symbol;
+/**
+ * Wraps every `@nestjs/cqrs` handler that runs behaviors with its pipeline, at
+ * application bootstrap: `execute` of command and query handlers, `handle` of
+ * event handlers. The buses read the method at call time, so they dispatch
+ * through the pipeline unchanged.
+ *
+ * A handler's pipeline comes from its `@UsePipeline`/`@SkipPipeline` and the
+ * global behaviors, compiled once. Each behavior instance is the one provider a
+ * module registers under the behavior class; this provider never builds one.
+ * Startup fails when a behavior has no provider or several, when a handler that
+ * runs behaviors is request-scoped (Nest builds such a handler per request, so a
+ * wrapped instance would never run), and, in `'strict'` mode, when a behavior's
+ * contract is broken. Only this application's own handler instances are wrapped,
+ * never their class, and they are restored when the application closes.
+ */
+export declare class PipelineBootstrap implements OnApplicationBootstrap, OnModuleDestroy {
+    private readonly discovery;
+    private readonly options;
+    private readonly logger;
+    private readonly restores;
+    constructor(discovery: DiscoveryService, options: PipelineOptions);
+    onApplicationBootstrap(): void;
+    onModuleDestroy(): void;
+    private wrapHandlers;
+    private wrap;
+}
+//# sourceMappingURL=pipeline.bootstrap.d.ts.map

package/dist/pipeline/pipeline.bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.bootstrap.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.bootstrap.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,cAAc,EAInB,KAAK,sBAAsB,EAM5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;CAClD;AAED,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAwB3D;;;;;;;;;;;;;;GAcG;AACH,qBACa,iBACX,YAAW,sBAAsB,EAAE,eAAe;IAMhD,OAAO,CAAC,QAAQ,CAAC,SAAS;IACA,OAAO,CAAC,QAAQ,CAAC,OAAO;IALpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyB;IAElD,YACmB,SAAS,EAAE,gBAAgB,EACD,OAAO,EAAE,eAAe,EACjE;IAEJ,sBAAsB,IAAI,IAAI,CAO7B;IAED,eAAe,IAAI,IAAI,CAEtB;IAED,OAAO,CAAC,YAAY;IA0CpB,OAAO,CAAC,IAAI;CA2Eb"}