@cqrs-ddd/nestjs 0.5.0

package/dist/pipeline/pipeline.bootstrap.js

@@ -0,0 +1,189 @@
+/* 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 PipelineBootstrap_1;
+import { compilePipelinePlan, createPipelineRunner, PipelineConfigurationError, pipelineOf, validateBehaviorContracts, } from '@cqrs-ddd/pipeline';
+import { Inject, Injectable, Logger, } from '@nestjs/common';
+import { DiscoveryService } from '@nestjs/core';
+import { CommandHandler, EventsHandler, QueryHandler } from '@nestjs/cqrs';
+export const PIPELINE_OPTIONS = Symbol('PIPELINE_OPTIONS');
+// @nestjs/cqrs keeps its handler metadata keys private, so each public handler
+// decorator is applied to a throwaway class to read the one key it records.
+function metadataKey(decorate) {
+    const target = class {
+    };
+    decorate(target);
+    const keys = Reflect.getOwnMetadataKeys(target);
+    if (keys.length !== 1) {
+        throw new Error('A @nestjs/cqrs handler decorator recorded no single metadata key; the installed @nestjs/cqrs is not supported.');
+    }
+    return keys[0];
+}
+const HANDLER_KINDS = [
+    [metadataKey((target) => CommandHandler(class {
+        })(target)), 'command'],
+    [metadataKey((target) => QueryHandler(class {
+        })(target)), 'query'],
+    [metadataKey((target) => EventsHandler(class {
+        })(target)), 'event'],
+];
+/**
+ * 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.
+ */
+let PipelineBootstrap = PipelineBootstrap_1 = class PipelineBootstrap {
+    discovery;
+    options;
+    logger = new Logger(PipelineBootstrap_1.name);
+    restores = [];
+    constructor(discovery, options) {
+        this.discovery = discovery;
+        this.options = options;
+    }
+    onApplicationBootstrap() {
+        try {
+            this.wrapHandlers();
+        }
+        catch (error) {
+            this.onModuleDestroy();
+            throw error;
+        }
+    }
+    onModuleDestroy() {
+        while (this.restores.length > 0)
+            this.restores.pop()?.();
+    }
+    wrapHandlers() {
+        const providers = this.discovery.getProviders();
+        const mode = this.options.diagnostics ?? 'strict';
+        const found = [];
+        const behaviors = new Map();
+        const behavior = (type, handler) => {
+            let instance = behaviors.get(type);
+            if (!instance) {
+                instance = registeredBehavior(providers, type, handler);
+                behaviors.set(type, instance);
+            }
+            return instance;
+        };
+        for (const provider of providers) {
+            const type = handlerType(provider);
+            if (!type)
+                continue;
+            for (const [key, kind] of HANDLER_KINDS) {
+                if (!Reflect.getMetadata(key, type))
+                    continue;
+                this.wrap(provider, type, kind, behavior, mode === 'off' ? undefined : found);
+            }
+        }
+        if (found.length > 0 && mode === 'strict') {
+            throw new PipelineConfigurationError(found);
+        }
+        for (const d of found) {
+            this.logger.warn(`[Pipeline Diagnostic] Handler '${d.handlerName}' with behavior '${d.behaviorName}': ${d.message}. Fix: ${d.fix}`);
+        }
+    }
+    wrap(provider, type, kind, behavior, diagnostics) {
+        const handlerName = type.name;
+        const declared = pipelineOf(type);
+        const plan = compilePipelinePlan({
+            handlerName,
+            requestKind: kind,
+            handlerBehaviorTypes: declared.types,
+            handlerOptions: declared.options,
+            skippedBehaviorTypes: declared.skipped,
+            globalBehaviors: this.options.globalBehaviors,
+        });
+        if (!plan.hasPipeline)
+            return;
+        if (!provider.isDependencyTreeStatic()) {
+            throw new Error(`${handlerName} runs pipeline behaviors but is request-scoped, itself or through a dependency; ` +
+                'Nest builds it per request, so its pipeline would never run. Make it a singleton and read ' +
+                'request data from async context.');
+        }
+        const method = kind === 'event' ? 'handle' : 'execute';
+        const instance = provider.instance;
+        const original = instance[method];
+        const resolved = plan.behaviorTypes.map((t) => behavior(t, handlerName));
+        if (diagnostics) {
+            validateBehaviorContracts({
+                ...plan,
+                handlerType: type,
+                handlerName,
+                requestKind: kind,
+                resolvedBehaviors: new Map(resolved.map((b, i) => [i, b])),
+                diagnostics,
+            });
+        }
+        this.logger.debug(`Wrapping ${handlerName}.${method}() [${kind}] with pipeline: [${plan.behaviorTypes.map((t) => t.name).join(' → ')}]`);
+        const run = createPipelineRunner(original, {
+            handlerType: type,
+            handlerName,
+            requestKind: kind,
+            behaviorOptions: plan.mergedOptions.size > 0 ? plan.mergedOptions : undefined,
+        }, resolved, true, this.options.sources);
+        const own = Object.getOwnPropertyDescriptor(instance, method);
+        Object.defineProperty(instance, method, {
+            configurable: true,
+            writable: true,
+            value: (request) => run(instance, request),
+        });
+        this.restores.push(() => {
+            if (own)
+                Object.defineProperty(instance, method, own);
+            else
+                Reflect.deleteProperty(instance, method);
+        });
+    }
+};
+PipelineBootstrap = PipelineBootstrap_1 = __decorate([
+    Injectable(),
+    __param(1, Inject(PIPELINE_OPTIONS)),
+    __metadata("design:paramtypes", [DiscoveryService, Object])
+], PipelineBootstrap);
+export { PipelineBootstrap };
+function handlerType(provider) {
+    const type = provider.instance?.constructor ?? provider.metatype;
+    return typeof type === 'function' && type !== Object
+        ? type
+        : undefined;
+}
+function registeredBehavior(providers, type, handler) {
+    const registered = providers.filter((provider) => provider.token === type);
+    if (registered.length === 0) {
+        throw new Error(`${type.name} runs in the pipeline of ${handler}, but no module provides it. Register it as a ` +
+            'provider of the module that configures it.');
+    }
+    if (registered.length > 1) {
+        const modules = registered.map((p) => p.host?.name ?? 'an unknown module');
+        throw new Error(`${type.name} is provided by ${modules.join(' and ')}; exactly one module provides each behavior, ` +
+            'otherwise which instance a handler gets would depend on import order.');
+    }
+    const [provider] = registered;
+    if (!provider.isDependencyTreeStatic() || !provider.instance) {
+        throw new Error(`${type.name} must be a singleton provider: a pipeline takes one instance of each behavior.`);
+    }
+    return provider.instance;
+}
+//# sourceMappingURL=pipeline.bootstrap.js.map

package/dist/pipeline/pipeline.bootstrap.js.map

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

package/dist/pipeline/pipeline.module.d.ts

@@ -0,0 +1,28 @@
+import { type DynamicModule } from '@nestjs/common';
+import { type PipelineOptions } from './pipeline.bootstrap.js';
+/**
+ * Runs the `@nestjs/cqrs` handlers through their `@cqrs-ddd/pipeline`
+ * pipelines. It places the global behaviors and the context sources; the
+ * behavior instances are providers of the modules that configure them, under
+ * their behavior class.
+ *
+ * @example
+ * ```ts
+ * @Module({
+ *   imports: [
+ *     PipelineModule.forRoot({
+ *       sources: contextSources,
+ *       globalBehaviors: [{ scope: 'all', before: [logging()] }],
+ *     }),
+ *   ],
+ *   providers: [
+ *     { provide: LoggingBehavior, useFactory: () => new LoggingBehavior(new Logger('Pipeline')) },
+ *   ],
+ * })
+ * export class ObservabilityModule {}
+ * ```
+ */
+export declare class PipelineModule {
+    static forRoot(options?: PipelineOptions): DynamicModule;
+}
+//# sourceMappingURL=pipeline.module.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.module.d.ts","sourceRoot":"","sources":["../../src/pipeline/pipeline.module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAGL,KAAK,eAAe,EACrB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBACa,cAAc;IACzB,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,eAAoB,GAAG,aAAa,CAS3D;CACF"}

package/dist/pipeline/pipeline.module.js

@@ -0,0 +1,50 @@
+/* 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 PipelineModule_1;
+import { Module } from '@nestjs/common';
+import { DiscoveryModule } from '@nestjs/core';
+import { PIPELINE_OPTIONS, PipelineBootstrap, } from './pipeline.bootstrap.js';
+/**
+ * Runs the `@nestjs/cqrs` handlers through their `@cqrs-ddd/pipeline`
+ * pipelines. It places the global behaviors and the context sources; the
+ * behavior instances are providers of the modules that configure them, under
+ * their behavior class.
+ *
+ * @example
+ * ```ts
+ * @Module({
+ *   imports: [
+ *     PipelineModule.forRoot({
+ *       sources: contextSources,
+ *       globalBehaviors: [{ scope: 'all', before: [logging()] }],
+ *     }),
+ *   ],
+ *   providers: [
+ *     { provide: LoggingBehavior, useFactory: () => new LoggingBehavior(new Logger('Pipeline')) },
+ *   ],
+ * })
+ * export class ObservabilityModule {}
+ * ```
+ */
+let PipelineModule = PipelineModule_1 = class PipelineModule {
+    static forRoot(options = {}) {
+        return {
+            module: PipelineModule_1,
+            imports: [DiscoveryModule],
+            providers: [
+                { provide: PIPELINE_OPTIONS, useValue: options },
+                PipelineBootstrap,
+            ],
+        };
+    }
+};
+PipelineModule = PipelineModule_1 = __decorate([
+    Module({})
+], PipelineModule);
+export { PipelineModule };
+//# sourceMappingURL=pipeline.module.js.map

package/dist/pipeline/pipeline.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.module.js","sourceRoot":"","sources":["../../src/pipeline/pipeline.module.ts"],"names":[],"mappings":"AAAA,sEAAsE;;;;;;;;AAEtE,OAAO,EAAsB,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EACL,gBAAgB,EAChB,iBAAiB,GAElB,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEI,IAAM,cAAc,sBAApB,MAAM,cAAc;IAClB,AAAP,MAAM,CAAC,OAAO,CAAC,OAAO,GAAoB,EAAE;QAC1C,OAAO;YACL,MAAM,kBAAgB;YACtB,OAAO,EAAE,CAAC,eAAe,CAAC;YAC1B,SAAS,EAAE;gBACT,EAAE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,OAAO,EAAE;gBAChD,iBAAiB;aAClB;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AAXY,cAAc;IAD1B,MAAM,CAAC,EAAE,CAAC;GACE,cAAc,CAW1B"}

package/package.json

@@ -0,0 +1,119 @@
+{
+  "name": "@cqrs-ddd/nestjs",
+  "version": "0.5.0",
+  "description": "NestJS adapter for the @cqrs-ddd packages: runs @nestjs/cqrs handlers through their pipelines, answers every package error as a NestJS HttpException, and wires correlation and job context",
+  "author": "Aristotelis",
+  "license": "SEE LICENSE IN LICENSE",
+  "type": "module",
+  "engines": {
+    "node": ">=22.12.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aristoteliss/ddd-cqrs.git",
+    "directory": "packages/nestjs"
+  },
+  "homepage": "https://aristoteliss.github.io/ddd-cqrs/packages/nestjs/",
+  "bugs": {
+    "url": "https://github.com/aristoteliss/ddd-cqrs/issues"
+  },
+  "keywords": [
+    "nestjs",
+    "cqrs",
+    "ddd",
+    "pipeline",
+    "cqrs-ddd"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./correlation": {
+      "types": "./dist/correlation.d.ts",
+      "default": "./dist/correlation.js"
+    },
+    "./job-context": {
+      "types": "./dist/job-context.d.ts",
+      "default": "./dist/job-context.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "COMMERCIAL_LICENSE.txt"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^12.1.1",
+    "@nestjs/core": "^12.1.1",
+    "@nestjs/cqrs": "^12.1.0",
+    "@cqrs-ddd/pipeline-feature-flags": "^0.5.0",
+    "@cqrs-ddd/core": "^0.5.0",
+    "@cqrs-ddd/pipeline-idempotency": "^0.5.0",
+    "@cqrs-ddd/pipeline-job-context": "^0.5.0",
+    "@cqrs-ddd/pipeline-casl": "^0.5.0",
+    "@cqrs-ddd/pipeline-correlation": "^0.5.0",
+    "@cqrs-ddd/pipeline-rate-limit": "^0.5.0",
+    "@cqrs-ddd/pipeline-zod": "^0.5.0",
+    "@cqrs-ddd/pipeline": "^0.5.0"
+  },
+  "peerDependenciesMeta": {
+    "@cqrs-ddd/pipeline-casl": {
+      "optional": true
+    },
+    "@cqrs-ddd/pipeline-correlation": {
+      "optional": true
+    },
+    "@cqrs-ddd/pipeline-feature-flags": {
+      "optional": true
+    },
+    "@cqrs-ddd/pipeline-idempotency": {
+      "optional": true
+    },
+    "@cqrs-ddd/pipeline-job-context": {
+      "optional": true
+    },
+    "@cqrs-ddd/pipeline-rate-limit": {
+      "optional": true
+    },
+    "@cqrs-ddd/pipeline-zod": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@casl/ability": "^7.0.1",
+    "@nestjs/common": "^12.1.1",
+    "@nestjs/core": "^12.1.1",
+    "@nestjs/cqrs": "^12.1.0",
+    "@openfeature/server-sdk": "^1.23.0",
+    "@vitest/coverage-v8": "^5.0.3",
+    "reflect-metadata": "^0.2.2",
+    "rxjs": "^7.8.2",
+    "vitest": "^5.0.3",
+    "zod": "^4.6.5",
+    "@cqrs-ddd/pipeline": "0.5.0",
+    "@cqrs-ddd/pipeline-casl": "0.5.0",
+    "@cqrs-ddd/pipeline-feature-flags": "0.5.0",
+    "@cqrs-ddd/pipeline-correlation": "0.5.0",
+    "@cqrs-ddd/pipeline-idempotency": "0.5.0",
+    "@cqrs-ddd/pipeline-zod": "0.5.0",
+    "@cqrs-ddd/pipeline-job-context": "0.5.0",
+    "@cqrs-ddd/core": "0.5.0",
+    "@cqrs-ddd/pipeline-rate-limit": "0.5.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "build:watch": "tsc -p tsconfig.build.json --watch",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "rebuild": "pnpm run clean && pnpm run build",
+    "lint": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}