@decaf-ts/for-nest 0.1.2 → 0.1.3

package/lib/interceptors/DecafRequestHandlerInterceptor.d.ts

@@ -1,53 +0,0 @@
-import { CallHandler, ExecutionContext, NestInterceptor } from "@nestjs/common";
-import { DecafHandlerExecutor } from "../request";
-/**
- * @description
- * Interceptor responsible for executing all registered Decaf request handlers
- * before the controller method is invoked.
- *
- * @summary
- * The {@link DecafRequestHandlerInterceptor} integrates the Decaf request-handling pipeline
- * into NestJS' interceptor mechanism. Before passing execution to the next handler in the
- * NestJS chain, it delegates request processing to the {@link DecafHandlerExecutor}, which
- * sequentially runs all registered {@link DecafRequestHandler} instances. This allows
- * behaviors such as authentication, logging, tenant resolution, or metadata enrichment
- * to occur prior to controller execution.
- *
- * @class DecafRequestHandlerInterceptor
- *
- * @example
- * ```ts
- * // Apply globally:
- * app.useGlobalInterceptors(new DecafRequestHandlerInterceptor(executor));
- *
- * // Or in a module:
- * @Module({
- *   providers: [
- *     DecafHandlerExecutor,
- *     {
- *       provide: APP_INTERCEPTOR,
- *       useClass: DecafRequestHandlerInterceptor,
- *     },
- *   ],
- * })
- * export class AppModule {}
- * ```
- *
- * @mermaid
- * sequenceDiagram
- *     participant Client
- *     participant Interceptor
- *     participant Executor
- *     participant Controller
- *
- *     Client->>Interceptor: HTTP Request
- *     Interceptor->>Executor: exec(request)
- *     Executor-->>Interceptor: handlers completed
- *     Interceptor->>Controller: next.handle()
- *     Controller-->>Client: Response
- */
-export declare class DecafRequestHandlerInterceptor implements NestInterceptor {
-    private readonly executor;
-    constructor(executor: DecafHandlerExecutor);
-    intercept(ctx: ExecutionContext, next: CallHandler): Promise<import("rxjs").Observable<any>>;
-}

package/lib/interceptors/DecafRequestHandlerInterceptor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DecafRequestHandlerInterceptor.js","sourceRoot":"","sources":["../../src/interceptors/DecafRequestHandlerInterceptor.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAMwB;AACxB,oDAAkD;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEI,IAAM,8BAA8B,GAApC,MAAM,8BAA8B;IACzC,YAA6B,QAA8B;QAA9B,aAAQ,GAAR,QAAQ,CAAsB;IAAG,CAAC;IAE/D,KAAK,CAAC,SAAS,CAAC,GAAqB,EAAE,IAAiB;QACtD,MAAM,GAAG,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;QAC5C,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IACvB,CAAC;CACF,CAAA;AARY,wEAA8B;yCAA9B,8BAA8B;IAD1C,IAAA,mBAAU,EAAC,EAAE,KAAK,EAAE,cAAK,CAAC,OAAO,EAAE,CAAC;qCAEI,8BAAoB;GADhD,8BAA8B,CAQ1C"}

package/lib/interceptors/index.cjs

@@ -1,18 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./DecafRequestHandlerInterceptor.cjs"), exports);
-//# sourceMappingURL=index.js.map

package/lib/interceptors/index.d.ts

@@ -1 +0,0 @@
-export * from "./DecafRequestHandlerInterceptor";

package/lib/interceptors/index.js.map

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

package/lib/request/DecafHandlerExecutor.cjs

@@ -1,80 +0,0 @@
-"use strict";
-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); }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DecafHandlerExecutor = void 0;
-const common_1 = require("@nestjs/common");
-const DecafRequestContext_1 = require("./DecafRequestContext.cjs");
-const constants_1 = require("./../constants.cjs");
-/**
- * @description
- * Executes all registered {@link DecafRequestHandler} instances for the current request,
- * providing them with a shared {@link DecafRequestContext}.
- *
- * @summary
- * The {@link DecafHandlerExecutor} class is responsible for orchestrating and executing
- * a sequence of request handlers. Each handler receives the same request-scoped context,
- * allowing coordinated processing such as authentication, metadata extraction, auditing,
- * and custom pipeline behavior. Handlers are injected via the {@link DECAF_HANDLERS} token,
- * ensuring extensibility and loose coupling.
- *
- * @class DecafHandlerExecutor
- *
- * @example
- * ```ts
- * // Example handler:
- * class AuthHandler implements DecafRequestHandler {
- *   async handle(context: DecafRequestContext, req: Request) {
- *     const token = req.headers["authorization"];
- *     const result = MyService.doSomething(token);
- *     context.set("my-key", result);
- *   }
- * }
- *
- * // Executor usage in a request:
- * await executor.exec(request);
- * // All handlers will run in sequence
- * ```
- *
- * @mermaid
- * sequenceDiagram
- *     participant Client
- *     participant Executor
- *     participant HandlerA
- *     participant HandlerB
- *
- *     Client->>Executor: exec(req)
- *     Executor->>HandlerA: handle(context, req)
- *     HandlerA-->>Executor: completed
- *     Executor->>HandlerB: handle(context, req)
- *     HandlerB-->>Executor: completed
- *     Executor-->>Client: processing finished
- */
-let DecafHandlerExecutor = class DecafHandlerExecutor {
-    constructor(handlers, context) {
-        this.handlers = handlers;
-        this.context = context;
-    }
-    async exec(req) {
-        for (const handler of this.handlers) {
-            await handler.handle(this.context, req);
-        }
-    }
-};
-exports.DecafHandlerExecutor = DecafHandlerExecutor;
-exports.DecafHandlerExecutor = DecafHandlerExecutor = __decorate([
-    (0, common_1.Injectable)({ scope: common_1.Scope.REQUEST }),
-    __param(0, (0, common_1.Inject)(constants_1.DECAF_HANDLERS)),
-    __metadata("design:paramtypes", [Array, DecafRequestContext_1.DecafRequestContext])
-], DecafHandlerExecutor);
-//# sourceMappingURL=DecafHandlerExecutor.js.map

package/lib/request/DecafHandlerExecutor.d.ts

@@ -1,52 +0,0 @@
-import { DecafRequestContext } from "./DecafRequestContext";
-import { type DecafRequestHandler } from "../types";
-/**
- * @description
- * Executes all registered {@link DecafRequestHandler} instances for the current request,
- * providing them with a shared {@link DecafRequestContext}.
- *
- * @summary
- * The {@link DecafHandlerExecutor} class is responsible for orchestrating and executing
- * a sequence of request handlers. Each handler receives the same request-scoped context,
- * allowing coordinated processing such as authentication, metadata extraction, auditing,
- * and custom pipeline behavior. Handlers are injected via the {@link DECAF_HANDLERS} token,
- * ensuring extensibility and loose coupling.
- *
- * @class DecafHandlerExecutor
- *
- * @example
- * ```ts
- * // Example handler:
- * class AuthHandler implements DecafRequestHandler {
- *   async handle(context: DecafRequestContext, req: Request) {
- *     const token = req.headers["authorization"];
- *     const result = MyService.doSomething(token);
- *     context.set("my-key", result);
- *   }
- * }
- *
- * // Executor usage in a request:
- * await executor.exec(request);
- * // All handlers will run in sequence
- * ```
- *
- * @mermaid
- * sequenceDiagram
- *     participant Client
- *     participant Executor
- *     participant HandlerA
- *     participant HandlerB
- *
- *     Client->>Executor: exec(req)
- *     Executor->>HandlerA: handle(context, req)
- *     HandlerA-->>Executor: completed
- *     Executor->>HandlerB: handle(context, req)
- *     HandlerB-->>Executor: completed
- *     Executor-->>Client: processing finished
- */
-export declare class DecafHandlerExecutor {
-    private readonly handlers;
-    private readonly context;
-    constructor(handlers: DecafRequestHandler[], context: DecafRequestContext);
-    exec(req: Request): Promise<void>;
-}

package/lib/request/DecafHandlerExecutor.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DecafHandlerExecutor.js","sourceRoot":"","sources":["../../src/request/DecafHandlerExecutor.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA2D;AAC3D,mEAA4D;AAE5D,kDAA8C;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,YAC2C,QAA+B,EACvD,OAA4B;QADJ,aAAQ,GAAR,QAAQ,CAAuB;QACvD,YAAO,GAAP,OAAO,CAAqB;IAC5C,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,GAAY;QACrB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;CACF,CAAA;AAXY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,mBAAU,EAAC,EAAE,KAAK,EAAE,cAAK,CAAC,OAAO,EAAE,CAAC;IAGhC,WAAA,IAAA,eAAM,EAAC,0BAAc,CAAC,CAAA;4CACG,yCAAmB;GAHpC,oBAAoB,CAWhC"}

package/lib/request/DecafRequestContext.cjs

@@ -1,47 +0,0 @@
-"use strict";
-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;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DecafRequestContext = void 0;
-const common_1 = require("@nestjs/common");
-/**
- * @description
- * Request-scoped context used to store arbitrary values for the duration of a single request.
- *
- * @summary
- * The {@link DecafRequestContext} class provides an isolated per-request key-value cache,
- * enabling services and controllers to share state or metadata without relying on global
- * or static variables. Keys may be strings or symbols, and cached values may hold any
- * serializable or non-serializable object.
- *
- * @class DecafRequestContext
- *
- * @example
- * ```ts
- * // Saving a value in the request context:
- * context.set("tenantId", "abc123");
- *
- * // Retrieving it later in the request lifecycle:
- * const tenantId = context.get<string>("tenantId");
- * ```
- */
-let DecafRequestContext = class DecafRequestContext {
-    constructor() {
-        this.cache = new Map();
-    }
-    set(key, value) {
-        this.cache.set(key, value);
-    }
-    get(key) {
-        return this.cache.get(key);
-    }
-};
-exports.DecafRequestContext = DecafRequestContext;
-exports.DecafRequestContext = DecafRequestContext = __decorate([
-    (0, common_1.Injectable)({ scope: common_1.Scope.REQUEST })
-], DecafRequestContext);
-//# sourceMappingURL=DecafRequestContext.js.map

package/lib/request/DecafRequestContext.d.ts

@@ -1,26 +0,0 @@
-/**
- * @description
- * Request-scoped context used to store arbitrary values for the duration of a single request.
- *
- * @summary
- * The {@link DecafRequestContext} class provides an isolated per-request key-value cache,
- * enabling services and controllers to share state or metadata without relying on global
- * or static variables. Keys may be strings or symbols, and cached values may hold any
- * serializable or non-serializable object.
- *
- * @class DecafRequestContext
- *
- * @example
- * ```ts
- * // Saving a value in the request context:
- * context.set("tenantId", "abc123");
- *
- * // Retrieving it later in the request lifecycle:
- * const tenantId = context.get<string>("tenantId");
- * ```
- */
-export declare class DecafRequestContext {
-    private cache;
-    set(key: string | symbol, value: any): void;
-    get<T = any>(key: string | symbol): T | undefined;
-}

package/lib/request/DecafRequestContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"DecafRequestContext.js","sourceRoot":"","sources":["../../src/request/DecafRequestContext.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAmD;AAEnD;;;;;;;;;;;;;;;;;;;;GAoBG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAAzB;QACG,UAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IASlD,CAAC;IAPC,GAAG,CAAC,GAAoB,EAAE,KAAU;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,GAAG,CAAU,GAAoB;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;CACF,CAAA;AAVY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,EAAC,EAAE,KAAK,EAAE,cAAK,CAAC,OAAO,EAAE,CAAC;GACxB,mBAAmB,CAU/B"}

package/lib/request/index.cjs

@@ -1,19 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./DecafRequestContext.cjs"), exports);
-__exportStar(require("./DecafHandlerExecutor.cjs"), exports);
-//# sourceMappingURL=index.js.map

package/lib/request/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./DecafRequestContext";
-export * from "./DecafHandlerExecutor";

package/lib/request/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/request/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4DAAsC;AACtC,6DAAuC"}