@decaf-ts/for-nest 0.1.1 → 0.1.2

package/lib/request/DecafHandlerExecutor.cjs

@@ -0,0 +1,80 @@
+"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

@@ -0,0 +1,52 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,47 @@
+"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

@@ -0,0 +1,26 @@
+/**
+ * @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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,19 @@
+"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

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

package/lib/request/index.js.map

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

package/lib/types.d.ts

@@ -1,5 +1,13 @@
 import { Adapter } from "@decaf-ts/core";
 import { Constructor } from "@decaf-ts/decoration";
+import { Type } from "@nestjs/common";
+export interface RequestContextAccessor {
+    set(key: string | symbol, value: any): void;
+    get<T = any>(key: string | symbol): T | undefined;
+}
+export interface DecafRequestHandler {
+    handle(context: RequestContextAccessor, req: Request): Promise<void>;
+}
 /**
  * @publicApi
  */
@@ -8,4 +16,5 @@ export type DecafModuleOptions<CONF = any, A extends Adapter<CONF, any, any, any
     conf: CONF;
     alias?: string;
     autoControllers: boolean;
+    handlers?: Type<DecafRequestHandler>[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decaf-ts/for-nest",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "NestJS decaf integration",
   "type": "module",
   "exports": {

package/lib/RepoFactory.cjs

@@ -1,27 +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.RepoFactory = void 0;
-const decorator_validation_1 = require("@decaf-ts/decorator-validation");
-const db_decorators_1 = require("@decaf-ts/db-decorators");
-const core_1 = require("@decaf-ts/core");
-const common_1 = require("@nestjs/common");
-let RepoFactory = class RepoFactory {
-    for(model) {
-        model = typeof model === "string" ? decorator_validation_1.Model.get(model) : model;
-        if (!model) {
-            throw new db_decorators_1.InternalError(`Failed to find repository for ${model}`);
-        }
-        return core_1.Repository.forModel(model);
-    }
-};
-exports.RepoFactory = RepoFactory;
-exports.RepoFactory = RepoFactory = __decorate([
-    (0, common_1.Injectable)()
-], RepoFactory);
-//# sourceMappingURL=RepoFactory.js.map

package/lib/RepoFactory.d.ts

@@ -1,6 +0,0 @@
-import { Model } from "@decaf-ts/decorator-validation";
-import { Repo } from "@decaf-ts/core";
-import { Constructor } from "@decaf-ts/decoration";
-export declare class RepoFactory {
-    for<M extends Model>(model: string | Constructor<M>): Repo<M>;
-}

package/lib/RepoFactory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RepoFactory.js","sourceRoot":"","sources":["../src/RepoFactory.ts"],"names":[],"mappings":";;;;;;;;;AAAA,yEAAuD;AACvD,2DAAwD;AACxD,yCAAkD;AAElD,2CAA4C;AAGrC,IAAM,WAAW,GAAjB,MAAM,WAAW;IACtB,GAAG,CAAkB,KAA8B;QACjD,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,4BAAK,CAAC,GAAG,CAAC,KAAK,CAAS,CAAC,CAAC,CAAC,KAAK,CAAC;QACtE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,6BAAa,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,iBAAU,CAAC,QAAQ,CAAC,KAAuB,CAAC,CAAC;IACtD,CAAC;CACF,CAAA;AARY,kCAAW;sBAAX,WAAW;IADvB,IAAA,mBAAU,GAAE;GACA,WAAW,CAQvB"}

package/lib/esm/RepoFactory.d.ts

@@ -1,6 +0,0 @@
-import { Model } from "@decaf-ts/decorator-validation";
-import { Repo } from "@decaf-ts/core";
-import { Constructor } from "@decaf-ts/decoration";
-export declare class RepoFactory {
-    for<M extends Model>(model: string | Constructor<M>): Repo<M>;
-}

package/lib/esm/RepoFactory.js

@@ -1,24 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-import { Model } from "@decaf-ts/decorator-validation";
-import { InternalError } from "@decaf-ts/db-decorators";
-import { Repository } from "@decaf-ts/core";
-import { Injectable } from "@nestjs/common";
-let RepoFactory = class RepoFactory {
-    for(model) {
-        model = typeof model === "string" ? Model.get(model) : model;
-        if (!model) {
-            throw new InternalError(`Failed to find repository for ${model}`);
-        }
-        return Repository.forModel(model);
-    }
-};
-RepoFactory = __decorate([
-    Injectable()
-], RepoFactory);
-export { RepoFactory };
-//# sourceMappingURL=RepoFactory.js.map

package/lib/esm/RepoFactory.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"RepoFactory.js","sourceRoot":"","sources":["../../src/RepoFactory.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gCAAgC,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAQ,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAGrC,IAAM,WAAW,GAAjB,MAAM,WAAW;IACtB,GAAG,CAAkB,KAA8B;QACjD,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,GAAG,CAAC,KAAK,CAAS,CAAC,CAAC,CAAC,KAAK,CAAC;QACtE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,aAAa,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC,KAAuB,CAAC,CAAC;IACtD,CAAC;CACF,CAAA;AARY,WAAW;IADvB,UAAU,EAAE;GACA,WAAW,CAQvB"}