@cqrs-ddd/pipeline 0.5.0

package/dist/services/pipeline-contracts.js

@@ -0,0 +1,102 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { untyped } from '@cqrs-ddd/untyped';
+import { getBehaviorId } from '../helpers/behavior-id.js';
+import { PIPELINE_BEHAVIOR_CONTRACT, } from '../interfaces/pipeline-behavior-contract.interface.js';
+/**
+ * Validates the ordering rules and option contracts that behavior classes declare
+ * through `PIPELINE_BEHAVIOR_CONTRACT`, appending a diagnostic per violation. Framework
+ * adapters call it at bootstrap; `createPipeline()` calls it when a function is wrapped.
+ *
+ * @example
+ * ```ts
+ * const diagnostics: PipelineBehaviorDiagnostic[] = [];
+ * validateBehaviorContracts({ ...plan, handlerType, handlerName, requestKind, resolvedBehaviors, diagnostics });
+ * ```
+ */
+export function validateBehaviorContracts(params) {
+    const { handlerType, handlerName, requestKind, behaviorTypes, resolvedBehaviors, mergedOptions, handlerOptions, globalOptions, handlerBehaviorTypes, globalBehaviorIds, diagnostics, } = params;
+    for (let i = 0; i < behaviorTypes.length; i++) {
+        const BehaviorClass = behaviorTypes[i];
+        const id = getBehaviorId(BehaviorClass);
+        const instance = resolvedBehaviors.get(i);
+        const contract = (instance &&
+            untyped(instance)[PIPELINE_BEHAVIOR_CONTRACT]) ??
+            untyped(BehaviorClass)[PIPELINE_BEHAVIOR_CONTRACT];
+        if (!contract)
+            continue;
+        const isHandlerDeclared = (handlerBehaviorTypes ?? []).some((t) => getBehaviorId(t) === id);
+        const isGlobalDeclared = globalBehaviorIds.has(id);
+        const declarationSource = isHandlerDeclared && isGlobalDeclared
+            ? 'both'
+            : isHandlerDeclared
+                ? 'handler'
+                : 'global';
+        const rawMerged = mergedOptions.get(id);
+        const effectiveOptions = instance && resolvesOptions(instance)
+            ? instance.resolveEffectiveOptions(rawMerged)
+            : rawMerged;
+        const validationCtx = {
+            handlerType,
+            handlerName: handlerName,
+            requestKind,
+            declarationSource,
+            effectiveOptions,
+            handlerOptions: handlerOptions?.get(id),
+            globalOptions: globalOptions.get(id),
+            effectiveBehaviorTypes: behaviorTypes,
+            behaviorInstance: instance,
+        };
+        // 1. Validate ordering constraints
+        const orderRule = typeof contract.order === 'function'
+            ? contract.order(validationCtx)
+            : contract.order;
+        if (orderRule) {
+            const edges = [];
+            if (orderRule.after) {
+                for (const target of orderRule.after) {
+                    edges.push({ target, direction: 'after' });
+                }
+            }
+            if (orderRule.before) {
+                for (const target of orderRule.before) {
+                    edges.push({ target, direction: 'before' });
+                }
+            }
+            for (const { target, direction } of edges) {
+                const targetIdx = behaviorTypes.findIndex((b) => typeof target === 'string'
+                    ? getBehaviorId(b) === target || b.name === target
+                    : b === target || getBehaviorId(b) === getBehaviorId(target));
+                // Relative position only: an absent target has no position to
+                // violate. A behavior that needs a peer to exist checks
+                // effectiveBehaviorTypes in its own validate().
+                if (targetIdx === -1)
+                    continue;
+                const isViolation = direction === 'after' ? i <= targetIdx : i >= targetIdx;
+                if (isViolation) {
+                    const targetName = behaviorTypes[targetIdx].name;
+                    diagnostics.push({
+                        handlerName: handlerName,
+                        behaviorName: BehaviorClass.name,
+                        message: direction === 'after'
+                            ? `${BehaviorClass.name} is positioned before ${targetName} in the pipeline chain, but must execute after it`
+                            : `${BehaviorClass.name} is positioned after ${targetName} in the pipeline chain, but must execute before it`,
+                        fix: direction === 'after'
+                            ? `Reorder the pipeline behaviors so that ${targetName} runs before ${BehaviorClass.name}.`
+                            : `Reorder the pipeline behaviors so that ${BehaviorClass.name} runs before ${targetName}.`,
+                    });
+                }
+            }
+        }
+        // 2. Validate behavior options and intent
+        if (typeof contract.validate === 'function') {
+            const result = contract.validate(validationCtx);
+            if (Array.isArray(result))
+                diagnostics.push(...result);
+        }
+    }
+}
+function resolvesOptions(instance) {
+    return (typeof instance
+        .resolveEffectiveOptions === 'function');
+}
+//# sourceMappingURL=pipeline-contracts.js.map

package/dist/services/pipeline-contracts.js.map

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

package/dist/services/pipeline-plan.d.ts

@@ -0,0 +1,49 @@
+import { type BehaviorId } from '../helpers/behavior-id.js';
+import type { IPipelineBehavior } from '../interfaces/pipeline.behavior.interface.js';
+import type { GlobalBehaviorsOptions } from '../options/global-behaviors.options.js';
+import type { Constructor } from '../types.js';
+/** The request kinds a pipeline distinguishes; `unknown` matches only `scope: 'all'`. */
+export type RequestKind = 'command' | 'query' | 'event' | 'unknown';
+/** What a handler, or a wrapped function, declares for its pipeline. */
+export interface PipelineDeclaration {
+    /** Name used in configuration error messages. */
+    handlerName: string;
+    requestKind: RequestKind;
+    /** Behaviors declared on the handler, deduplicated, in order. */
+    handlerBehaviorTypes?: Constructor<IPipelineBehavior>[];
+    /** Options of the handler's tuple entries. */
+    handlerOptions?: Map<BehaviorId, Record<string, unknown>>;
+    /** Global behaviors the handler opts out of. */
+    skippedBehaviorTypes?: Constructor<IPipelineBehavior>[];
+    globalBehaviors?: GlobalBehaviorsOptions | GlobalBehaviorsOptions[];
+}
+/**
+ * Compiles a pipeline declaration into its effective, ordered behaviors and merged
+ * options, without resolving instances. Global `before` behaviors come first, then
+ * the handler's own, then global `after` ones; a handler entry for a global behavior
+ * supplies options at the global position.
+ *
+ * @throws Error when one behavior is both skipped and declared.
+ * @example
+ * ```ts
+ * const plan = compilePipelinePlan({
+ *   handlerName: 'getPrice',
+ *   requestKind: 'query',
+ *   handlerBehaviorTypes: [CacheBehavior],
+ *   globalBehaviors: { before: [LoggingBehavior] },
+ * });
+ * plan.behaviorTypes; // [LoggingBehavior, CacheBehavior]
+ * ```
+ */
+export declare function compilePipelinePlan(declaration: PipelineDeclaration): {
+    behaviorTypes: Constructor<IPipelineBehavior<unknown, unknown>>[];
+    mergedOptions: Map<BehaviorId, Record<string, unknown>>;
+    hasPipeline: boolean;
+    handlerOptions: Map<BehaviorId, Record<string, unknown>> | undefined;
+    globalOptions: Map<BehaviorId, Record<string, unknown>>;
+    handlerBehaviorTypes: Constructor<IPipelineBehavior<unknown, unknown>>[] | undefined;
+    globalBehaviorIds: Set<BehaviorId>;
+};
+/** Normalizes the single-object and array forms of `globalBehaviors`. */
+export declare function toGlobalConfigs(globalBehaviors: GlobalBehaviorsOptions | GlobalBehaviorsOptions[] | undefined): GlobalBehaviorsOptions[];
+//# sourceMappingURL=pipeline-plan.d.ts.map

package/dist/services/pipeline-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-plan.d.ts","sourceRoot":"","sources":["../../src/services/pipeline-plan.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,KAAK,UAAU,EAAiB,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,yFAAyF;AACzF,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;AAEpE,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,iEAAiE;IACjE,oBAAoB,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,EAAE,CAAC;IACxD,8CAA8C;IAC9C,cAAc,CAAC,EAAE,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC1D,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,WAAW,CAAC,iBAAiB,CAAC,EAAE,CAAC;IACxD,eAAe,CAAC,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;CACrE;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,mBAAmB;;;;;;;;EAkFnE;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAC7B,eAAe,EACX,sBAAsB,GACtB,sBAAsB,EAAE,GACxB,SAAS,GACZ,sBAAsB,EAAE,CAG1B"}

package/dist/services/pipeline-plan.js

@@ -0,0 +1,111 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { normalizeBehaviorEntries, } from '../helpers/behavior-entries.js';
+import { getBehaviorId } from '../helpers/behavior-id.js';
+/**
+ * Compiles a pipeline declaration into its effective, ordered behaviors and merged
+ * options, without resolving instances. Global `before` behaviors come first, then
+ * the handler's own, then global `after` ones; a handler entry for a global behavior
+ * supplies options at the global position.
+ *
+ * @throws Error when one behavior is both skipped and declared.
+ * @example
+ * ```ts
+ * const plan = compilePipelinePlan({
+ *   handlerName: 'getPrice',
+ *   requestKind: 'query',
+ *   handlerBehaviorTypes: [CacheBehavior],
+ *   globalBehaviors: { before: [LoggingBehavior] },
+ * });
+ * plan.behaviorTypes; // [LoggingBehavior, CacheBehavior]
+ * ```
+ */
+export function compilePipelinePlan(declaration) {
+    const { handlerName, requestKind, handlerBehaviorTypes, handlerOptions, skippedBehaviorTypes, globalBehaviors, } = declaration;
+    if (skippedBehaviorTypes && skippedBehaviorTypes.length > 0) {
+        const handlerBehaviorIds = new Set((handlerBehaviorTypes ?? []).map(getBehaviorId));
+        for (const skippedType of skippedBehaviorTypes) {
+            const id = getBehaviorId(skippedType);
+            if (handlerBehaviorIds.has(id) || handlerOptions?.has(id)) {
+                throw new Error(`Handler ${handlerName} has contradictory pipeline configuration: ` +
+                    `behavior ${skippedType.name} is both skipped and declared. ` +
+                    `Remove either the skip or the declaration.`);
+            }
+        }
+    }
+    const { beforeTypes, afterTypes, globalOptions } = resolveGlobalBehaviors(globalBehaviors, requestKind);
+    const skippedBehaviorIds = new Set((skippedBehaviorTypes ?? []).map(getBehaviorId));
+    const effectiveBeforeTypes = beforeTypes.filter((type) => !skippedBehaviorIds.has(getBehaviorId(type)));
+    const effectiveAfterTypes = afterTypes.filter((type) => !skippedBehaviorIds.has(getBehaviorId(type)));
+    // Handler declarations override options for a global behavior of the same
+    // class, but must not relocate it. A global security guard configured in
+    // `before` must remain outside handler-level cache/idempotency behaviors
+    // that can short-circuit without calling next().
+    const globalBehaviorIds = new Set([...effectiveBeforeTypes, ...effectiveAfterTypes].map(getBehaviorId));
+    const handlerOnlyTypes = (handlerBehaviorTypes ?? []).filter((type) => !globalBehaviorIds.has(getBehaviorId(type)));
+    // Effective order: globalBefore → non-global handler behaviors → globalAfter.
+    // Matching handler entries supply options at their original global position.
+    const behaviorTypes = [
+        ...effectiveBeforeTypes,
+        ...handlerOnlyTypes,
+        ...effectiveAfterTypes,
+    ];
+    // Handler options shallowly override global options; nested values are replaced.
+    const mergedOptions = new Map(globalOptions);
+    for (const [id, options] of handlerOptions ?? []) {
+        const inherited = mergedOptions.get(id);
+        mergedOptions.set(id, inherited ? { ...inherited, ...options } : options);
+    }
+    for (const skippedId of skippedBehaviorIds) {
+        mergedOptions.delete(skippedId);
+    }
+    return {
+        behaviorTypes,
+        mergedOptions,
+        hasPipeline: behaviorTypes.length > 0,
+        handlerOptions,
+        globalOptions,
+        handlerBehaviorTypes,
+        globalBehaviorIds,
+    };
+}
+/** Normalizes the single-object and array forms of `globalBehaviors`. */
+export function toGlobalConfigs(globalBehaviors) {
+    if (!globalBehaviors)
+        return [];
+    return Array.isArray(globalBehaviors) ? globalBehaviors : [globalBehaviors];
+}
+/**
+ * Resolves global before/after behaviors that match the given handler kind.
+ * `globalBehaviors` may be a single `GlobalBehaviorsOptions` object or an array.
+ * Each entry is filtered by its `scope` ('all' | 'commands' | 'queries' | 'events').
+ * Matching entries are merged — behaviors accumulate across all matching configs.
+ *
+ * @returns Behavior types to prepend/append plus any inline options from tuple entries.
+ */
+function resolveGlobalBehaviors(globalBehaviors, requestKind) {
+    const configs = toGlobalConfigs(globalBehaviors);
+    const beforeTypes = [];
+    const afterTypes = [];
+    // One accumulator pair across every matching config and both chain positions,
+    // so the first occurrence fixes placement while a later tuple can still
+    // supply options without the behavior running more than once.
+    const accumulators = {
+        seen: new Set(),
+        options: new Map(),
+    };
+    const parseEntries = (entries) => normalizeBehaviorEntries(entries, `globalBehaviors for ${requestKind}`, true, accumulators).types;
+    for (const config of configs) {
+        const scope = config.scope ?? 'all';
+        // Scope filtering — skip entries that don't match the handler kind
+        if (scope === 'commands' && requestKind !== 'command')
+            continue;
+        if (scope === 'queries' && requestKind !== 'query')
+            continue;
+        if (scope === 'events' && requestKind !== 'event')
+            continue;
+        beforeTypes.push(...parseEntries(config.before ?? []));
+        afterTypes.push(...parseEntries(config.after ?? []));
+    }
+    return { beforeTypes, afterTypes, globalOptions: accumulators.options };
+}
+//# sourceMappingURL=pipeline-plan.js.map

package/dist/services/pipeline-plan.js.map

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

package/dist/services/pipeline-runner.d.ts

@@ -0,0 +1,26 @@
+import type { ContextSources } from '../interfaces/context-source.interface.js';
+import type { IPipelineBehavior } from '../interfaces/pipeline.behavior.interface.js';
+import type { PipelineHandlerMeta } from '../interfaces/pipeline-handler-meta.interface.js';
+/**
+ * Runs one execution: `request` is what behaviors see; `args`, when given, are the
+ * arguments the handler receives instead of `request` alone.
+ */
+export type PipelineRunner = (self: unknown, request: unknown, args?: readonly unknown[]) => Promise<unknown>;
+/**
+ * Builds the runner of one handler: each call creates a pipeline context, takes the
+ * tenant and correlation id from `sources` or the enclosing pipeline, composes the
+ * behaviors around the handler, and runs them inside those values. Framework adapters
+ * use it; `createPipeline()` is the entry point for applications.
+ *
+ * @param behaviors - Resolved instances, or a resolver called per execution (a
+ *   framework adapter's request-scoped instances).
+ * @param meta - Fixed handler metadata, or a function deriving it from the request and
+ *   the receiver of the call.
+ * @example
+ * ```ts
+ * const run = createPipelineRunner(handler.execute, meta, [logging], true, sources);
+ * await run(handler, command);
+ * ```
+ */
+export declare function createPipelineRunner(originalMethod: (this: unknown, ...args: any[]) => unknown, meta: PipelineHandlerMeta | ((request: unknown, self: unknown) => PipelineHandlerMeta), behaviors: readonly IPipelineBehavior[] | ((self: unknown, request: unknown) => Promise<IPipelineBehavior[]>), hasPipeline: boolean, sources?: ContextSources): PipelineRunner;
+//# sourceMappingURL=pipeline-runner.d.ts.map

package/dist/services/pipeline-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-runner.d.ts","sourceRoot":"","sources":["../../src/services/pipeline-runner.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAEV,cAAc,EACf,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EACV,iBAAiB,EAElB,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AAG5F;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,KACtB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAElC,cAAc,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,EAC1D,IAAI,EACA,mBAAmB,GACnB,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,KAAK,mBAAmB,CAAC,EAC9D,SAAS,EACL,SAAS,iBAAiB,EAAE,GAC5B,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC,EACvE,WAAW,EAAE,OAAO,EACpB,OAAO,GAAE,cAAmB,GAC3B,cAAc,CA2DhB"}

package/dist/services/pipeline-runner.js

@@ -0,0 +1,68 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { uuidv7 } from '@cqrs-ddd/uuidv7';
+import { pipelineStore, SET_CORRELATION_ID, SET_RESPONSE, SET_TENANT_ID, } from '../constants/pipeline-context.constants.js';
+import { PipelineContext } from '../pipeline.context.js';
+/**
+ * Builds the runner of one handler: each call creates a pipeline context, takes the
+ * tenant and correlation id from `sources` or the enclosing pipeline, composes the
+ * behaviors around the handler, and runs them inside those values. Framework adapters
+ * use it; `createPipeline()` is the entry point for applications.
+ *
+ * @param behaviors - Resolved instances, or a resolver called per execution (a
+ *   framework adapter's request-scoped instances).
+ * @param meta - Fixed handler metadata, or a function deriving it from the request and
+ *   the receiver of the call.
+ * @example
+ * ```ts
+ * const run = createPipelineRunner(handler.execute, meta, [logging], true, sources);
+ * await run(handler, command);
+ * ```
+ */
+export function createPipelineRunner(
+// biome-ignore lint/suspicious/noExplicitAny: the handler's arguments are opaque here
+originalMethod, meta, behaviors, hasPipeline, sources = {}) {
+    const invoke = (self, request, args) => args
+        ? originalMethod.apply(self, [...args])
+        : originalMethod.call(self, request);
+    return async (self, request, args) => {
+        if (!hasPipeline)
+            return invoke(self, request, args);
+        const context = new PipelineContext(request, typeof meta === 'function' ? meta(request, self) : meta);
+        const localBehaviors = typeof behaviors === 'function'
+            ? await behaviors(self, request)
+            : behaviors;
+        const parent = pipelineStore.getStore();
+        const { tenantId: tenant, correlationId: correlation } = sources;
+        const tenantId = tenant ? tenant.current() : parent?.tenantId;
+        const correlationId = correlation
+            ? (correlation.current() ?? correlation.create())
+            : (parent?.correlationId ?? uuidv7());
+        context[SET_CORRELATION_ID](correlationId);
+        if (tenantId !== undefined)
+            context[SET_TENANT_ID](tenantId);
+        let chain = async () => {
+            // A behavior that replaced the request hands the handler the replacement.
+            const current = context.request;
+            const replaced = current !== request;
+            const result = await invoke(self, current, args && replaced
+                ? args.length === 1
+                    ? [current]
+                    : current
+                : args);
+            context[SET_RESPONSE](result);
+            return result;
+        };
+        for (let i = localBehaviors.length - 1; i >= 0; i--) {
+            const behavior = localBehaviors[i];
+            const nextInChain = chain;
+            chain = () => behavior.handle(context, nextInChain);
+        }
+        // Behaviors and the handler run inside this execution's values, so a
+        // nested dispatch inherits them and cannot see a different tenant.
+        return pipelineStore.run(context, () => within(tenant, context.tenantId, () => within(correlation, context.correlationId, chain)));
+    };
+}
+function within(source, value, fn) {
+    return source ? source.run(value, fn) : fn();
+}
+//# sourceMappingURL=pipeline-runner.js.map

package/dist/services/pipeline-runner.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+/** A class, as `new` accepts it. Behaviors, requests and handlers are identified by theirs. */
+export type Constructor<T = unknown> = new (...args: any[]) => T;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,+FAA+F;AAE/F,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,sEAAsE"}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@cqrs-ddd/pipeline",
+  "version": "0.5.0",
+  "description": "Framework-neutral pipeline engine: wrap functions and methods with behaviors such as logging, caching or idempotency",
+  "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/pipeline"
+  },
+  "homepage": "https://aristoteliss.github.io/ddd-cqrs/packages/pipeline/",
+  "bugs": {
+    "url": "https://github.com/aristoteliss/ddd-cqrs/issues"
+  },
+  "keywords": [
+    "pipeline",
+    "behaviors",
+    "cqrs",
+    "ddd",
+    "decorators",
+    "middleware"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "LICENSE",
+    "COMMERCIAL_LICENSE.txt"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@cqrs-ddd/safe-stringify": "^0.5.0",
+    "@cqrs-ddd/uuidv7": "^0.5.0",
+    "@cqrs-ddd/untyped": "^0.5.0"
+  },
+  "devDependencies": {
+    "@vitest/coverage-v8": "^5.0.3",
+    "vitest": "^5.0.3"
+  },
+  "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"
+  }
+}