@cqrs-ddd/pipeline 0.5.0

package/README.md

@@ -0,0 +1,42 @@
+# @cqrs-ddd/pipeline
+
+A framework-neutral pipeline engine: wrap plain functions and class methods with
+behaviors such as logging, validation, authorization, caching or idempotency, and declare
+the behaviors of handler classes with `@UsePipeline` and `@SkipPipeline`. No
+framework, no dependency-injection container and no CQRS infrastructure are required;
+the `@cqrs-ddd/pipeline-<name>` packages provide the behaviors.
+
+**Documentation:** [guide](https://aristoteliss.github.io/ddd-cqrs/packages/pipeline/) · [API reference](https://aristoteliss.github.io/ddd-cqrs/api/cqrs-ddd/pipeline/) · [all packages](https://aristoteliss.github.io/ddd-cqrs/)
+
+## Installation
+
+```bash
+pnpm add @cqrs-ddd/pipeline
+```
+
+Requires Node.js 22.12 or later, or another runtime with `AsyncLocalStorage` (Bun, Deno).
+Published as an ES module; a CommonJS application loads it with `require()`.
+
+## Example
+
+```ts
+import { createPipeline, logging } from '@cqrs-ddd/pipeline';
+
+const pipeline = createPipeline({
+  globalBehaviors: { before: [logging({ requestResponseLogLevel: 'log' })] },
+});
+
+export const getPrice = pipeline.wrap({ name: 'getPrice', kind: 'query' })(
+  async (sku: string) => prices.find(sku),
+);
+```
+
+A method can be decorated instead, in either TypeScript decorator mode:
+`@pipeline.wrap({ kind: 'query' })`. A plain function needs a `name`, which keys and logs
+use to tell operations apart, and a `kind`: a `query` reads, a `command` changes state,
+an `event` reacts.
+
+## License
+
+Dual-licensed under **AGPLv3** and a **Commercial License**. See `LICENSE` and
+`COMMERCIAL_LICENSE.txt`.

package/dist/behaviors/logging.behavior.d.ts

@@ -0,0 +1,195 @@
+import { IPipelineBehavior, NextDelegate } from '../interfaces/pipeline.behavior.interface.js';
+import { IPipelineContext } from '../interfaces/pipeline.context.interface.js';
+import type { LogLevel, PipelineLogger } from '../logger.js';
+/**
+ * An error class used as a `mapLogLevel` key. It is matched with `instanceof`, so
+ * it also covers its subclasses.
+ */
+export type ErrorClass = abstract new (...args: never[]) => Error;
+/**
+ * Configuration options for the logging behavior.
+ *
+ * Levels use {@link LogLevel} names (`'verbose'`, `'debug'`, `'log'`,
+ * `'warn'`, `'error'`, `'fatal'`).
+ * When using `nestjs-pino`, these map to pino levels:
+ * `'verbose'` → `trace`, `'debug'` → `debug`, `'log'` → `info`, `'warn'` → `warn`,
+ * `'error'` → `error`, `'fatal'` → `fatal`.
+ * Use `'none'` to suppress a message entirely.
+ *
+ * @example Structured application logging with safe payload visibility
+ * ```ts
+ * export const createUser = pipeline.wrap(
+ *   { name: 'createUser', kind: 'command' },
+ *   [LoggingBehavior, {
+ *     logFormat: 'structured',
+ *     requestResponseLogLevel: 'debug',
+ *     excludeRequestObj: false,
+ *     excludeResponseObj: true,
+ *     redactKeys: ['code'],
+ *     mapLogLevel: new Map([[UniqueEmailException, 'warn']]),
+ *   }],
+ * )(async (command: CreateUserCommand) => users.create(command));
+ * ```
+ */
+export interface LoggingBehaviorOptions {
+    /**
+     * Log level for the post-success metric line (correlation ID, request
+     * kind/name, handler name, and elapsed duration in ms). Emitted once
+     * `next()` resolves without throwing.
+     * Uses LogLevel names or 'none' to suppress.
+     * Default: 'log'.
+     */
+    metricLogLevel?: LogLevel | 'none';
+    /**
+     * Log level used when the wrapped handler throws.
+     * Uses LogLevel names or 'none' to suppress.
+     * Overridden per error type when `mapLogLevel` has a matching entry.
+     * Default: 'error'.
+     */
+    errorLogLevel?: LogLevel | 'none';
+    /**
+     * Per-exception-type log level override, keyed by error class.
+     *
+     * When the thrown error is an `instanceof` more than one registered key,
+     * the most specific (most derived) matching class wins — e.g. with both
+     * `Error` and `ForbiddenException` registered, a thrown `ForbiddenException`
+     * logs at the `ForbiddenException` level, regardless of the order the
+     * entries were inserted into the Map. Falls back to `errorLogLevel` when
+     * no key matches.
+     * Example: `new Map([[Error, 'error'], [ForbiddenException, 'warn']])`
+     */
+    mapLogLevel?: Map<ErrorClass, LogLevel | 'none'>;
+    /**
+     * Log level for request/response payloads.
+     * Uses LogLevel names or 'none' to suppress.
+     * Default: 'debug'.
+     */
+    requestResponseLogLevel?: LogLevel | 'none';
+    /**
+     * Keys to exclude from request/response logs.
+     * Passed to `safeStringify`/`safeSanitize` as a `Set<string>` for filtering object properties.
+     * Supports dot notation for nested properties (e.g. `'ctx.sessionUser'`).
+     * Example: `['password', 'token', 'ctx.sessionUser']` omits those fields from the log output.
+     * Default: [] (no keys excluded).
+     */
+    excludeKeys?: string[];
+    /**
+     * Additional keys or dot-paths to mask with `[REDACTED]` when request/response
+     * payload logging is enabled. Unlike {@link excludeKeys}, redacted properties
+     * stay in the payload so its shape remains visible.
+     *
+     * This option is additive and has no effect unless configured.
+     *
+     * @example
+     * ```ts
+     * logging({
+     *   excludeRequestObj: false,
+     *   redactKeys: ['profile.email', 'payment.cardToken'],
+     * });
+     * ```
+     */
+    redactKeys?: string[];
+    /**
+     * Masks the core {@link DEFAULT_REDACT_KEYS} (password, token, authorization,
+     * cookie, API keys, card data, etc.) in request/response payload logs. Custom
+     * {@link redactKeys} are merged on top.
+     *
+     * Defaults to `true`. Set it to `false` only when raw payload logging is an
+     * explicit application requirement and the caller owns the resulting exposure
+     * risk.
+     *
+     * @default true
+     *
+     * @example Opting out, deliberately
+     * ```ts
+     * logging({ excludeRequestObj: false, redactSensitiveKeys: false });
+     * ```
+     */
+    redactSensitiveKeys?: boolean;
+    /**
+     * If true, omits the request payload from logs entirely, logging the
+     * placeholder `'[exclude request obj]'` instead.
+     * Default: true.
+     */
+    excludeRequestObj?: boolean;
+    /**
+     * If true, omits the response payload from logs entirely, logging the
+     * placeholder `'[exclude response obj]'` instead.
+     * Default: true.
+     */
+    excludeResponseObj?: boolean;
+    /**
+     * Output shape for request/response/metric/error logs.
+     * - 'text': single interpolated string (default).
+     * - 'structured': plain object payload (e.g. `{ msg, request }` for
+     *   request/response, or `{ message, stack, ... }` for errors), suitable
+     *   for structured loggers like nestjs-pino/pino that serialize objects
+     *   into JSON fields.
+     * Default: 'text'.
+     */
+    logFormat?: 'text' | 'structured';
+}
+/**
+ * Pipeline behavior that logs each request/response and execution timing.
+ *
+ * Emits the incoming request, a completion metric (duration), and the response,
+ * each at a configurable log level (see `LoggingBehaviorOptions`). Request and
+ * response payloads are excluded by default and can be opted in, with key-based
+ * exclusion/redaction. Logging and serialization failures do not change the
+ * handler result or error. If the wrapped handler throws,
+ * the error is logged — including its stack trace and, when present, the error's
+ * `optionalParams` (see `ErrorWithOptionalParams`) — and then re-thrown
+ * unchanged. Writes through the logger passed to the constructor, or `console`.
+ *
+ * @example
+ * ```ts
+ * const pipeline = createPipeline({ behaviors: [new LoggingBehavior(pinoAdapter)] });
+ * ```
+ */
+export declare class LoggingBehavior implements IPipelineBehavior {
+    private readonly logger;
+    constructor(logger?: PipelineLogger);
+    /**
+     * Logs the request, a duration metric, and the response or error around
+     * `next()`, using the options from `context.getBehaviorOptions(LoggingBehavior)`
+     * and the defaults documented on {@link LoggingBehaviorOptions}.
+     *
+     * @param context - The pipeline context for the current request.
+     * @param next - Delegate that invokes the next behavior/handler in the chain.
+     * @returns The value resolved by `next()`.
+     * @throws Whatever `next()` throws, unchanged, after logging it. A logging
+     *   or serialization failure never changes the returned value or the error.
+     */
+    handle(context: IPipelineContext, next: NextDelegate): Promise<unknown>;
+    private observe;
+    /**
+     * Builds the sanitizer configuration for payload logging.
+     *
+     * The default sensitive keys are masked unless `redactSensitiveKeys` is
+     * false; keys listed in `redactKeys` are always masked. With no key to mask,
+     * only the exclusion set applies.
+     */
+    private buildSanitizeOptions;
+    /**
+     * Dispatches `message` (and any `optionalParams`) to the logger method
+     * matching `level` — e.g. `level: 'warn'` calls `this.logger.warn(...)`.
+     * No-op when `level` is `'none'` or the underlying logger doesn't
+     * implement that method.
+     */
+    private log;
+    /**
+     * Extracts extra, loggable context from an error matching
+     * `ErrorWithOptionalParams`: a non-null object exposing a defined
+     * `optionalParams` property. `handle`'s `catch` branch uses this to decide
+     * whether the error log should be enriched with that extra context.
+     *
+     * The value is normalized into an array so it can be spread into the error
+     * log payload: passed through as-is if it's already an array, or wrapped in a
+     * single-element array otherwise.
+     *
+     * @returns The normalized `optionalParams`, or `undefined` when the error is
+     *   not an object or does not define `optionalParams`.
+     */
+    private optionalParamsOf;
+}
+//# sourceMappingURL=logging.behavior.d.ts.map

package/dist/behaviors/logging.behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.behavior.d.ts","sourceRoot":"","sources":["../../src/behaviors/logging.behavior.ts"],"names":[],"mappings":"AASA,OAAO,EACL,iBAAiB,EACjB,YAAY,EACb,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,KAAK,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEnC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAElC;;;;;;;;;;OAUG;IACH,WAAW,CAAC,EAAE,GAAG,CAAC,UAAU,EAAE,QAAQ,GAAG,MAAM,CAAC,CAAC;IAEjD;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAE5C;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB;;;;;;;;;;;;;;OAcG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;;;;;;;;;;;;;OAeG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B;;;;;;;;OAQG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;CACnC;AAOD;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,YAAW,iBAAiB;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC,YAAY,MAAM,CAAC,EAAE,cAAc,EAElC;IAED;;;;;;;;;;OAUG;IACG,MAAM,CACV,OAAO,EAAE,gBAAgB,EACzB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,OAAO,CAAC,CA6HlB;IAED,OAAO,CAAC,OAAO;IAsBf;;;;;;OAMG;IACH,OAAO,CAAC,oBAAoB;IAiB5B;;;;;OAKG;IACH,OAAO,CAAC,GAAG;IAeX;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,gBAAgB;CAMzB"}

package/dist/behaviors/logging.behavior.js

@@ -0,0 +1,206 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { performance } from 'node:perf_hooks';
+import { DEFAULT_REDACT_KEYS, safeSanitize, safeStringify, } from '@cqrs-ddd/safe-stringify';
+/**
+ * Pipeline behavior that logs each request/response and execution timing.
+ *
+ * Emits the incoming request, a completion metric (duration), and the response,
+ * each at a configurable log level (see `LoggingBehaviorOptions`). Request and
+ * response payloads are excluded by default and can be opted in, with key-based
+ * exclusion/redaction. Logging and serialization failures do not change the
+ * handler result or error. If the wrapped handler throws,
+ * the error is logged — including its stack trace and, when present, the error's
+ * `optionalParams` (see `ErrorWithOptionalParams`) — and then re-thrown
+ * unchanged. Writes through the logger passed to the constructor, or `console`.
+ *
+ * @example
+ * ```ts
+ * const pipeline = createPipeline({ behaviors: [new LoggingBehavior(pinoAdapter)] });
+ * ```
+ */
+export class LoggingBehavior {
+    logger;
+    constructor(logger) {
+        this.logger = logger ?? console;
+    }
+    /**
+     * Logs the request, a duration metric, and the response or error around
+     * `next()`, using the options from `context.getBehaviorOptions(LoggingBehavior)`
+     * and the defaults documented on {@link LoggingBehaviorOptions}.
+     *
+     * @param context - The pipeline context for the current request.
+     * @param next - Delegate that invokes the next behavior/handler in the chain.
+     * @returns The value resolved by `next()`.
+     * @throws Whatever `next()` throws, unchanged, after logging it. A logging
+     *   or serialization failure never changes the returned value or the error.
+     */
+    async handle(context, next) {
+        const options = context.getBehaviorOptions(LoggingBehavior);
+        const metricLogLevel = options?.metricLogLevel ?? 'log';
+        const requestResponseLogLevel = options?.requestResponseLogLevel ?? 'debug';
+        const errorLogLevel = options?.errorLogLevel ?? 'error';
+        const excludeKeys = new Set(options?.excludeKeys);
+        const sanitizeOptions = this.buildSanitizeOptions(options, excludeKeys);
+        const excludeRequestObj = options?.excludeRequestObj ?? true;
+        const excludeResponseObj = options?.excludeResponseObj ?? true;
+        const logFormat = options?.logFormat ?? 'text';
+        const structured = logFormat === 'structured';
+        this.observe(() => {
+            if (requestResponseLogLevel === 'none')
+                return;
+            const requestPayload = excludeRequestObj
+                ? '[exclude request obj]'
+                : structured
+                    ? safeSanitize(context.request, sanitizeOptions)
+                    : safeStringify(context.request, sanitizeOptions);
+            this.log(requestResponseLogLevel, structured
+                ? { msg: `Request → ${context.handlerName}`, request: requestPayload }
+                : `Request: ${requestPayload}`, context.handlerName);
+        });
+        const startTime = performance.now();
+        try {
+            const result = await next();
+            this.observe(() => {
+                const duration = (performance.now() - startTime).toFixed(2);
+                const metricMsg = `[${context.correlationId}] ${context.requestKind.toUpperCase()} ` +
+                    `${context.requestName} → ${context.handlerName} completed in ${duration}ms`;
+                this.log(metricLogLevel, structured
+                    ? {
+                        msg: metricMsg,
+                        correlationId: context.correlationId,
+                        requestKind: context.requestKind,
+                        requestName: context.requestName,
+                        handlerName: context.handlerName,
+                        durationMs: Number(duration),
+                    }
+                    : metricMsg, context.handlerName);
+                if (requestResponseLogLevel === 'none')
+                    return;
+                const responsePayload = excludeResponseObj
+                    ? '[exclude response obj]'
+                    : result != null
+                        ? structured
+                            ? safeSanitize(result, sanitizeOptions)
+                            : safeStringify(result, sanitizeOptions)
+                        : '(void)';
+                this.log(requestResponseLogLevel, structured
+                    ? {
+                        msg: `Response ← ${context.handlerName}`,
+                        response: responsePayload,
+                    }
+                    : `Response: ${responsePayload}`, context.handlerName);
+            });
+            return result;
+        }
+        catch (error) {
+            this.observe(() => {
+                const duration = (performance.now() - startTime).toFixed(2);
+                const err = error instanceof Error ? error : undefined;
+                let logLevel = errorLogLevel;
+                if (options?.mapLogLevel) {
+                    let bestMatch;
+                    for (const [errorType, level] of options.mapLogLevel.entries()) {
+                        if (!(error instanceof errorType))
+                            continue;
+                        if (!bestMatch || errorType.prototype instanceof bestMatch) {
+                            bestMatch = errorType;
+                            logLevel = level;
+                        }
+                    }
+                }
+                const message = `[${context.correlationId}] ${context.requestKind.toUpperCase()} ` +
+                    `${context.requestName} → ${context.handlerName} failed after ${duration}ms: ` +
+                    `${err ? `${err.name}: ${err.message}` : String(error)}`;
+                const params = this.optionalParamsOf(error);
+                const optionalParams = params
+                    ? safeSanitize(params, sanitizeOptions)
+                    : undefined;
+                if (structured) {
+                    const payload = {
+                        message,
+                        ...(err?.stack ? { stack: err.stack } : {}),
+                        ...(optionalParams ? { optionalParams } : {}),
+                    };
+                    this.log(logLevel, payload, context.handlerName);
+                }
+                else {
+                    this.log(logLevel, message, ...(err?.stack ? [err.stack] : []), ...(optionalParams ?? []), context.handlerName);
+                }
+            });
+            throw error;
+        }
+    }
+    observe(write) {
+        try {
+            write();
+        }
+        catch (error) {
+            // Observability failures must not alter business execution or error
+            // identity, but they must not be invisible either: a payload that always
+            // throws would otherwise silence a handler's logging with no trace.
+            try {
+                this.log('warn', `LoggingBehavior suppressed a log write: ${error instanceof Error
+                    ? `${error.name}: ${error.message}`
+                    : 'unknown error'}`);
+            }
+            catch {
+                // The logger itself is unusable; nothing further is safe to attempt.
+            }
+        }
+    }
+    /**
+     * Builds the sanitizer configuration for payload logging.
+     *
+     * The default sensitive keys are masked unless `redactSensitiveKeys` is
+     * false; keys listed in `redactKeys` are always masked. With no key to mask,
+     * only the exclusion set applies.
+     */
+    buildSanitizeOptions(options, excludeKeys) {
+        const redactKeys = [
+            ...(options?.redactSensitiveKeys === false ? [] : DEFAULT_REDACT_KEYS),
+            ...(options?.redactKeys ?? []),
+        ];
+        if (redactKeys.length === 0)
+            return excludeKeys;
+        return {
+            excludeKeys,
+            redactKeys,
+        };
+    }
+    /**
+     * Dispatches `message` (and any `optionalParams`) to the logger method
+     * matching `level` — e.g. `level: 'warn'` calls `this.logger.warn(...)`.
+     * No-op when `level` is `'none'` or the underlying logger doesn't
+     * implement that method.
+     */
+    log(level, message, ...optionalParams) {
+        if (level === 'none')
+            return;
+        const method = this.logger[level];
+        if (typeof method === 'function') {
+            method.call(this.logger, message, ...optionalParams);
+        }
+    }
+    /**
+     * Extracts extra, loggable context from an error matching
+     * `ErrorWithOptionalParams`: a non-null object exposing a defined
+     * `optionalParams` property. `handle`'s `catch` branch uses this to decide
+     * whether the error log should be enriched with that extra context.
+     *
+     * The value is normalized into an array so it can be spread into the error
+     * log payload: passed through as-is if it's already an array, or wrapped in a
+     * single-element array otherwise.
+     *
+     * @returns The normalized `optionalParams`, or `undefined` when the error is
+     *   not an object or does not define `optionalParams`.
+     */
+    optionalParamsOf(error) {
+        if (typeof error !== 'object' || error === null)
+            return undefined;
+        const { optionalParams } = error;
+        if (optionalParams === undefined)
+            return undefined;
+        return Array.isArray(optionalParams) ? optionalParams : [optionalParams];
+    }
+}
+//# sourceMappingURL=logging.behavior.js.map

package/dist/behaviors/logging.behavior.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.behavior.js","sourceRoot":"","sources":["../../src/behaviors/logging.behavior.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EACL,mBAAmB,EAEnB,YAAY,EACZ,aAAa,GACd,MAAM,0BAA0B,CAAC;AAwJlC;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,eAAe;IACT,MAAM,CAAiB;IAExC,YAAY,MAAuB;QACjC,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,OAAO,CAAC;IAClC,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,MAAM,CACV,OAAyB,EACzB,IAAkB;QAElB,MAAM,OAAO,GACX,OAAO,CAAC,kBAAkB,CAAyB,eAAe,CAAC,CAAC;QACtE,MAAM,cAAc,GAAG,OAAO,EAAE,cAAc,IAAI,KAAK,CAAC;QACxD,MAAM,uBAAuB,GAAG,OAAO,EAAE,uBAAuB,IAAI,OAAO,CAAC;QAC5E,MAAM,aAAa,GAAG,OAAO,EAAE,aAAa,IAAI,OAAO,CAAC;QACxD,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,OAAO,EAAE,WAAW,CAAC,CAAC;QAC1D,MAAM,eAAe,GAAG,IAAI,CAAC,oBAAoB,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACxE,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,IAAI,CAAC;QAC7D,MAAM,kBAAkB,GAAG,OAAO,EAAE,kBAAkB,IAAI,IAAI,CAAC;QAC/D,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,MAAM,CAAC;QAC/C,MAAM,UAAU,GAAG,SAAS,KAAK,YAAY,CAAC;QAE9C,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YAChB,IAAI,uBAAuB,KAAK,MAAM;gBAAE,OAAO;YAC/C,MAAM,cAAc,GAAG,iBAAiB;gBACtC,CAAC,CAAC,uBAAuB;gBACzB,CAAC,CAAC,UAAU;oBACV,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC;oBAChD,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;YAEtD,IAAI,CAAC,GAAG,CACN,uBAAuB,EACvB,UAAU;gBACR,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,OAAO,CAAC,WAAW,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE;gBACtE,CAAC,CAAC,YAAY,cAAc,EAAE,EAChC,OAAO,CAAC,WAAW,CACpB,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAEpC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBAChB,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAE5D,MAAM,SAAS,GACb,IAAI,OAAO,CAAC,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG;oBAClE,GAAG,OAAO,CAAC,WAAW,MAAM,OAAO,CAAC,WAAW,iBAAiB,QAAQ,IAAI,CAAC;gBAE/E,IAAI,CAAC,GAAG,CACN,cAAc,EACd,UAAU;oBACR,CAAC,CAAC;wBACE,GAAG,EAAE,SAAS;wBACd,aAAa,EAAE,OAAO,CAAC,aAAa;wBACpC,WAAW,EAAE,OAAO,CAAC,WAAW;wBAChC,WAAW,EAAE,OAAO,CAAC,WAAW;wBAChC,WAAW,EAAE,OAAO,CAAC,WAAW;wBAChC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC;qBAC7B;oBACH,CAAC,CAAC,SAAS,EACb,OAAO,CAAC,WAAW,CACpB,CAAC;gBAEF,IAAI,uBAAuB,KAAK,MAAM;oBAAE,OAAO;gBAC/C,MAAM,eAAe,GAAG,kBAAkB;oBACxC,CAAC,CAAC,wBAAwB;oBAC1B,CAAC,CAAC,MAAM,IAAI,IAAI;wBACd,CAAC,CAAC,UAAU;4BACV,CAAC,CAAC,YAAY,CAAC,MAAM,EAAE,eAAe,CAAC;4BACvC,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,eAAe,CAAC;wBAC1C,CAAC,CAAC,QAAQ,CAAC;gBAEf,IAAI,CAAC,GAAG,CACN,uBAAuB,EACvB,UAAU;oBACR,CAAC,CAAC;wBACE,GAAG,EAAE,cAAc,OAAO,CAAC,WAAW,EAAE;wBACxC,QAAQ,EAAE,eAAe;qBAC1B;oBACH,CAAC,CAAC,aAAa,eAAe,EAAE,EAClC,OAAO,CAAC,WAAW,CACpB,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;gBAChB,MAAM,QAAQ,GAAG,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC5D,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;gBACvD,IAAI,QAAQ,GAAG,aAAa,CAAC;gBAE7B,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;oBACzB,IAAI,SAAiC,CAAC;oBACtC,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,CAAC;wBAC/D,IAAI,CAAC,CAAC,KAAK,YAAY,SAAS,CAAC;4BAAE,SAAS;wBAC5C,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,SAAS,YAAY,SAAS,EAAE,CAAC;4BAC3D,SAAS,GAAG,SAAS,CAAC;4BACtB,QAAQ,GAAG,KAAK,CAAC;wBACnB,CAAC;oBACH,CAAC;gBACH,CAAC;gBAED,MAAM,OAAO,GACX,IAAI,OAAO,CAAC,aAAa,KAAK,OAAO,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG;oBAClE,GAAG,OAAO,CAAC,WAAW,MAAM,OAAO,CAAC,WAAW,iBAAiB,QAAQ,MAAM;oBAC9E,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;gBAE3D,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;gBAC5C,MAAM,cAAc,GAAG,MAAM;oBAC3B,CAAC,CAAE,YAAY,CAAC,MAAM,EAAE,eAAe,CAAe;oBACtD,CAAC,CAAC,SAAS,CAAC;gBAEd,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,OAAO,GAA4B;wBACvC,OAAO;wBACP,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC3C,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;qBAC9C,CAAC;oBACF,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC;gBACnD,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC,GAAG,CACN,QAAQ,EACR,OAAO,EACP,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAClC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC,EACzB,OAAO,CAAC,WAAW,CACpB,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAEO,OAAO,CAAC,KAAiB;QAC/B,IAAI,CAAC;YACH,KAAK,EAAE,CAAC;QACV,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,oEAAoE;YACpE,yEAAyE;YACzE,oEAAoE;YACpE,IAAI,CAAC;gBACH,IAAI,CAAC,GAAG,CACN,MAAM,EACN,2CACE,KAAK,YAAY,KAAK;oBACpB,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE;oBACnC,CAAC,CAAC,eACN,EAAE,CACH,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,qEAAqE;YACvE,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,oBAAoB,CAC1B,OAA2C,EAC3C,WAAwB;QAExB,MAAM,UAAU,GAAG;YACjB,GAAG,CAAC,OAAO,EAAE,mBAAmB,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC;YACtE,GAAG,CAAC,OAAO,EAAE,UAAU,IAAI,EAAE,CAAC;SAC/B,CAAC;QAEF,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,WAAW,CAAC;QAEhD,OAAO;YACL,WAAW;YACX,UAAU;SACX,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACK,GAAG,CACT,KAAwB,EACxB,OAAgB,EAChB,GAAG,cAAyB;QAE5B,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO;QAE7B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAA6B,CAAC,CAAC;QAC1D,IAAI,OAAO,MAAM,KAAK,UAAU,EAAE,CAAC;YAE/B,MACD,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,GAAG,cAAc,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACK,gBAAgB,CAAC,KAAc;QACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,SAAS,CAAC;QAClE,MAAM,EAAE,cAAc,EAAE,GAAG,KAAgC,CAAC;QAC5D,IAAI,cAAc,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACnD,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/constants/pipeline-context.constants.d.ts

@@ -0,0 +1,34 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import { IPipelineContext } from '../interfaces/pipeline.context.interface.js';
+/**
+ * Async-local store that propagates pipeline context across the async call chain.
+ * When a saga or nested CommandBus.execute() triggers a child handler,
+ * the child's PipelineContext inherits the parent's correlationId automatically.
+ *
+ * Stores a reference to the live context object so child pipelines inherit the
+ * same immutable correlation ID.
+ *
+ * Uses Node.js built-in `AsyncLocalStorage` — zero external dependencies.
+ */
+export declare const pipelineStore: AsyncLocalStorage<IPipelineContext<unknown, unknown>>;
+/**
+ * Symbol-keyed setter for `response`. Only code that imports this symbol
+ * can write to `context.response` — keeping it readonly for behaviors.
+ *
+ * @internal Used by the pipeline runner.
+ */
+export declare const SET_RESPONSE: unique symbol;
+/** @internal Sets the correlation ID before execution begins. */
+export declare const SET_CORRELATION_ID: unique symbol;
+/**
+ * Symbol-keyed setter for `tenantId`. The runner assigns the tenant before the
+ * behavior chain starts; a custom runner may assign it on a context it
+ * constructs. The tenant is write-once: assigning a different value throws.
+ */
+export declare const SET_TENANT_ID: unique symbol;
+/**
+ * Symbol-keyed setter for `request`, through which a behavior hands the handler a
+ * replacement input, such as a parsed copy; see `replaceRequest`.
+ */
+export declare const SET_REQUEST: unique symbol;
+//# sourceMappingURL=pipeline-context.constants.d.ts.map

package/dist/constants/pipeline-context.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-context.constants.d.ts","sourceRoot":"","sources":["../../src/constants/pipeline-context.constants.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAE/E;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,uDAA4C,CAAC;AAEvE;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,MAEjC,CAAC;AAEF,iEAAiE;AACjE,eAAO,MAAM,kBAAkB,EAAE,OAAO,MAEvC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,OAAO,MAElC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,OAAO,MAA6C,CAAC"}

package/dist/constants/pipeline-context.constants.js

@@ -0,0 +1,34 @@
+/* Copyright (C) 2026-present Aristotelis — see repository license. */
+import { AsyncLocalStorage } from 'node:async_hooks';
+/**
+ * Async-local store that propagates pipeline context across the async call chain.
+ * When a saga or nested CommandBus.execute() triggers a child handler,
+ * the child's PipelineContext inherits the parent's correlationId automatically.
+ *
+ * Stores a reference to the live context object so child pipelines inherit the
+ * same immutable correlation ID.
+ *
+ * Uses Node.js built-in `AsyncLocalStorage` — zero external dependencies.
+ */
+export const pipelineStore = new AsyncLocalStorage();
+/**
+ * Symbol-keyed setter for `response`. Only code that imports this symbol
+ * can write to `context.response` — keeping it readonly for behaviors.
+ *
+ * @internal Used by the pipeline runner.
+ */
+export const SET_RESPONSE = Symbol('PipelineContext.setResponse');
+/** @internal Sets the correlation ID before execution begins. */
+export const SET_CORRELATION_ID = Symbol('PipelineContext.setCorrelationId');
+/**
+ * Symbol-keyed setter for `tenantId`. The runner assigns the tenant before the
+ * behavior chain starts; a custom runner may assign it on a context it
+ * constructs. The tenant is write-once: assigning a different value throws.
+ */
+export const SET_TENANT_ID = Symbol('PipelineContext.setTenantId');
+/**
+ * Symbol-keyed setter for `request`, through which a behavior hands the handler a
+ * replacement input, such as a parsed copy; see `replaceRequest`.
+ */
+export const SET_REQUEST = Symbol('PipelineContext.setRequest');
+//# sourceMappingURL=pipeline-context.constants.js.map

package/dist/constants/pipeline-context.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-context.constants.js","sourceRoot":"","sources":["../../src/constants/pipeline-context.constants.ts"],"names":[],"mappings":"AAAA,sEAAsE;AAEtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAGrD;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,iBAAiB,EAAoB,CAAC;AAEvE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAkB,MAAM,CAC/C,6BAA6B,CAC9B,CAAC;AAEF,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAkB,MAAM,CACrD,kCAAkC,CACnC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB,MAAM,CAChD,6BAA6B,CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAkB,MAAM,CAAC,4BAA4B,CAAC,CAAC"}

package/dist/create-pipeline.d.ts

@@ -0,0 +1,122 @@
+import type { PipelineBehaviorEntry } from './entries.js';
+import type { ContextSources } from './interfaces/context-source.interface.js';
+import type { IPipelineBehavior } from './interfaces/pipeline.behavior.interface.js';
+import type { PipelineLogger } from './logger.js';
+import type { GlobalBehaviorsOptions } from './options/global-behaviors.options.js';
+import { type RequestKind } from './services/pipeline-plan.js';
+import type { Constructor } from './types.js';
+/** The kinds a wrapped function or a request declares. */
+export type DeclaredKind = Exclude<RequestKind, 'unknown'>;
+/**
+ * Brand by which a request tells a pipeline its kind, so a wrapped method needs no
+ * `kind` option; the request's class name then names the operation. `@cqrs-ddd/core`
+ * puts it on `BaseCommand`, `BaseQuery` and `DomainEvent`; any class can declare it.
+ *
+ * @example
+ * ```ts
+ * class GetPriceQuery {
+ *   get [REQUEST_KIND]() {
+ *     return 'query' as const;
+ *   }
+ *   constructor(readonly sku: string) {}
+ * }
+ * ```
+ */
+export declare const REQUEST_KIND: unique symbol;
+/** Configuration of {@link createPipeline}. */
+export interface PipelineOptions {
+    /**
+     * Instances of the behaviors that need dependencies, one per behavior class. A placed
+     * behavior without an instance is constructed with no arguments.
+     */
+    behaviors?: readonly IPipelineBehavior[];
+    /**
+     * Behaviors applied to every wrapped function, by scope: `before` the call-site
+     * entries, `after` them. A behavior placed here and at a call site runs once, at its
+     * global position, with the call-site options shallowly merged over these.
+     */
+    globalBehaviors?: GlobalBehaviorsOptions | GlobalBehaviorsOptions[];
+    /** Where executions take their tenant and correlation id from. */
+    sources?: ContextSources;
+    /**
+     * What a behavior contract violation does when a function or method is wrapped (module
+     * load or class definition): throw (`'strict'`), log a warning (`'warn'`), or nothing
+     * (`'off'`).
+     * @default 'strict'
+     */
+    diagnostics?: 'strict' | 'warn' | 'off';
+    /**
+     * Receives the `'warn'` diagnostics, and is the logger of a `LoggingBehavior` the pipeline
+     * constructs itself (one placed without an instance in `behaviors`).
+     * @default console
+     */
+    logger?: PipelineLogger;
+}
+/** Options of one {@link Pipeline.wrap} call. */
+export interface WrapOptions {
+    /**
+     * The operation name, used in keys and logs. Required for a plain function; a method
+     * defaults to `Class.method`, or to the class name of a branded request.
+     */
+    name?: string;
+    /**
+     * What the operation does: a `query` reads, a `command` changes state, an `event`
+     * reacts. Required unless every request carries {@link REQUEST_KIND}.
+     */
+    kind?: DeclaredKind;
+    /** Global behaviors this operation opts out of. */
+    skip?: readonly Constructor<IPipelineBehavior>[];
+}
+type AnyFunction = (...args: any[]) => unknown;
+/**
+ * What {@link Pipeline.wrap} returns: wraps a plain function, or decorates a method in
+ * the standard and the `experimentalDecorators` mode. The wrapped function returns a
+ * promise.
+ */
+export interface Wrap {
+    <F extends AnyFunction>(fn: F): (...args: Parameters<F>) => Promise<Awaited<ReturnType<F>>>;
+    <F extends AnyFunction>(method: F, context: ClassMethodDecoratorContext): F;
+    (target: object, propertyKey: string | symbol, descriptor: PropertyDescriptor): PropertyDescriptor;
+}
+/** A configured pipeline; see {@link createPipeline}. */
+export interface Pipeline {
+    /**
+     * Prepares the behaviors of one operation: entries are behavior classes or
+     * `[Behavior, options]` tuples, outermost first, such as `cache({ key })`.
+     *
+     * @throws TypeError on a malformed entry or an unknown `kind`.
+     * @throws PipelineConfigurationError in `'strict'` mode when the result wraps a function
+     *   or method of a declared `kind` whose behaviors violate a contract.
+     */
+    wrap(...entries: PipelineBehaviorEntry[]): Wrap;
+    wrap(options: WrapOptions, ...entries: PipelineBehaviorEntry[]): Wrap;
+}
+/**
+ * Creates a pipeline: behaviors that wrap plain functions and class methods with
+ * cross-cutting concerns, with no framework and no dependency-injection container.
+ *
+ * Global behaviors are constructed when the pipeline is created, so a behavior whose
+ * required dependency is missing fails here rather than at its first call.
+ *
+ * @throws TypeError on a malformed global entry or two instances of one behavior class.
+ * @example
+ * ```ts
+ * const pipeline = createPipeline({
+ *   behaviors: [new CacheBehavior(buildCache({}))],
+ *   globalBehaviors: { before: [logging({ requestResponseLogLevel: 'log' })] },
+ * });
+ *
+ * export const getPrice = pipeline.wrap(
+ *   { name: 'getPrice', kind: 'query' },
+ *   cache({ key }),
+ * )(async (sku: string) => prices.find(sku));
+ *
+ * class Prices {
+ *   @pipeline.wrap({ kind: 'query' }, cache({ key }))
+ *   async find(sku: string) {}
+ * }
+ * ```
+ */
+export declare function createPipeline(options?: PipelineOptions): Pipeline;
+export {};
+//# sourceMappingURL=create-pipeline.d.ts.map

package/dist/create-pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-pipeline.d.ts","sourceRoot":"","sources":["../src/create-pipeline.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAM1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0CAA0C,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAKrF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF,OAAO,EAEL,KAAK,WAAW,EAEjB,MAAM,6BAA6B,CAAC;AAKrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;AAI3D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,YAAY,eAAuC,CAAC;AAEjE,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B;;;OAGG;IACH,SAAS,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACzC;;;;OAIG;IACH,eAAe,CAAC,EAAE,sBAAsB,GAAG,sBAAsB,EAAE,CAAC;IACpE,kEAAkE;IAClE,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,CAAC;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,mDAAmD;IACnD,IAAI,CAAC,EAAE,SAAS,WAAW,CAAC,iBAAiB,CAAC,EAAE,CAAC;CAClD;AAGD,KAAK,WAAW,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,CAAC,CAAC,SAAS,WAAW,EACpB,EAAE,EAAE,CAAC,GACJ,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,2BAA2B,GAAG,CAAC,CAAC;IAC5E,CACE,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAAG,MAAM,EAC5B,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAAC;CACvB;AAED,yDAAyD;AACzD,MAAM,WAAW,QAAQ;IACvB;;;;;;;OAOG;IACH,IAAI,CAAC,GAAG,OAAO,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC;CACvE;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,eAAoB,GAAG,QAAQ,CA0KtE"}