@decaf-ts/integrations 0.10.5 → 0.11.0

package/lib/esm/loader/nest.js

@@ -0,0 +1,292 @@
+import { UnsupportedError } from "@decaf-ts/core";
+import { ValidationError } from "@decaf-ts/db-decorators";
+import { ObjectLoader } from "./ObjectLoader.js";
+/**
+ * @module integrations/loader/nest
+ * @summary Lazy NestJS loaders.
+ * @description Resolves NestJS controller classes and their route definitions
+ * from dynamically loaded modules. `@nestjs/common` and `reflect-metadata` are
+ * optional at runtime: both are dynamically imported/checked and the loaders
+ * degrade with a decaf {@link UnsupportedError} when they are unavailable.
+ *
+ * ## Tree-shaking
+ * The NestJS runtime is imported through a non-literal specifier so bundlers keep
+ * it as a runtime import and never inline it into the loader chunk. Nest
+ * applications already keep `@nestjs/common` in their entry graph, so the loader
+ * does not need a static reference of its own.
+ */
+/**
+ * Stable NestJS metadata keys. Declared as literals so this module never
+ * hard-depends on `@nestjs/common/constants` (a CommonJS-only subpath).
+ */
+export const NEST_PATH_METADATA = "path";
+export const NEST_METHOD_METADATA = "method";
+export const NEST_CONTROLLER_WATERMARK = "__controller__";
+export const NEST_MODULE_CONTROLLERS = "controllers";
+export const NEST_MODULE_IMPORTS = "imports";
+const NEST_COMMON_SPECIFIER = "@nestjs/common";
+const HTTP_METHOD_NAMES = {
+    0: "GET",
+    1: "POST",
+    2: "PUT",
+    3: "DELETE",
+    4: "PATCH",
+    5: "ALL",
+    6: "OPTIONS",
+    7: "HEAD",
+    8: "SEARCH",
+    9: "PROPFIND",
+    10: "PROPPATCH",
+    11: "MKCOL",
+    12: "COPY",
+    13: "MOVE",
+    14: "LOCK",
+    15: "UNLOCK",
+    16: "QUERY",
+};
+let nestCommonPromise;
+/**
+ * @summary Lazily resolve the NestJS runtime.
+ * @description Uses a non-literal dynamic import so bundlers do not inline or
+ * drop `@nestjs/common`. Throws a decaf {@link UnsupportedError} when the
+ * package cannot be resolved.
+ */
+export async function loadNestCommon() {
+    if (!nestCommonPromise) {
+        nestCommonPromise = import(/* @vite-ignore */ NEST_COMMON_SPECIFIER)
+            .then((module) => {
+            const resolved = module;
+            if (typeof resolved.Controller !== "function") {
+                throw new UnsupportedError(`NestJS integration is not available: "${NEST_COMMON_SPECIFIER}" does not expose the expected exports.`);
+            }
+            return resolved;
+        })
+            .catch((error) => {
+            nestCommonPromise = undefined;
+            if (error instanceof UnsupportedError)
+                throw error;
+            throw new UnsupportedError(`NestJS integration is not available: "${NEST_COMMON_SPECIFIER}" could not be resolved. ` +
+                `Install @nestjs/common and reflect-metadata to use the Nest loaders. ` +
+                `Cause: ${error?.message ?? String(error)}`);
+        });
+    }
+    return nestCommonPromise;
+}
+function metadataReader() {
+    const reflect = Reflect;
+    if (typeof reflect.getMetadata !== "function") {
+        throw new UnsupportedError("NestJS metadata is not available: reflect-metadata must be loaded before using the Nest loaders.");
+    }
+    return reflect;
+}
+function methodNameFor(method) {
+    return HTTP_METHOD_NAMES[method] ?? `METHOD_${method}`;
+}
+function normalizeSegment(segment) {
+    return segment.replace(/^\/+|\/+$/g, "");
+}
+function joinRoutePaths(controllerPath, routePath) {
+    const segments = [controllerPath, routePath]
+        .filter((value) => typeof value === "string")
+        .map(normalizeSegment)
+        .filter(Boolean);
+    return `/${segments.join("/")}`;
+}
+/**
+ * @summary Resolve NestJS controller classes from dynamically loaded modules.
+ * @description Extends the generic controller family with NestJS metadata
+ * awareness. Requires `@nestjs/common` and `reflect-metadata` at runtime.
+ */
+export class NestControllerObjectLoader extends ObjectLoader {
+    constructor(options = {}) {
+        super({ ...options, family: "controller" });
+    }
+    async loadController(source, exportName = this.defaultExportName, options = {}) {
+        await loadNestCommon();
+        const value = await this.loadExport(source, exportName, options);
+        return this.assertController(value, this.normalizeSource(source), exportName);
+    }
+    /**
+     * @summary Load every controller exported by a module.
+     */
+    async loadControllers(source, options = {}) {
+        await loadNestCommon();
+        const module = await this.loadModule(source);
+        const controllers = this.collectControllers(module, options.recursive);
+        const context = this.createContext(this.normalizeSource(source), "*", module, "afterResolve", {
+            ...this.metadata,
+            ...(options.metadata ?? {}),
+            controllerCount: controllers.length,
+        });
+        return this.runHooks(controllers, context, options);
+    }
+    /**
+     * @summary Scan a NestJS module (or namespace) for controller classes.
+     * @description Synchronous metadata scan. Requires `reflect-metadata` but not
+     * `@nestjs/common`; call {@link loadNestCommon} first when the module must be
+     * imported.
+     */
+    collectControllers(value, recursive = true) {
+        const result = [];
+        const seen = new Set();
+        this.scanControllers(value, result, seen, recursive);
+        return result;
+    }
+    isController(value) {
+        if (typeof value !== "function")
+            return false;
+        const reader = metadataReader();
+        return (reader.getMetadata(NEST_CONTROLLER_WATERMARK, value) === true ||
+            typeof reader.getMetadata(NEST_PATH_METADATA, value) !== "undefined");
+    }
+    getControllerPath(controller) {
+        const value = metadataReader().getMetadata(NEST_PATH_METADATA, controller);
+        return typeof value === "string" ? value : undefined;
+    }
+    assertController(value, source, exportName) {
+        if (!this.isController(value)) {
+            throw new ValidationError(`Loaded controller export "${exportName}" from "${source}" is not a NestJS controller.`);
+        }
+        return value;
+    }
+    scanControllers(value, result, seen, recursive) {
+        if (value === null || typeof value !== "object") {
+            if (this.isController(value) && !result.includes(value)) {
+                result.push(value);
+            }
+            return;
+        }
+        if (seen.has(value))
+            return;
+        seen.add(value);
+        const record = value;
+        const controllers = record[NEST_MODULE_CONTROLLERS];
+        if (Array.isArray(controllers)) {
+            for (const controller of controllers) {
+                if (this.isController(controller) &&
+                    !result.includes(controller)) {
+                    result.push(controller);
+                }
+            }
+        }
+        if (recursive) {
+            const imports = record[NEST_MODULE_IMPORTS];
+            if (Array.isArray(imports)) {
+                for (const imported of imports) {
+                    if (imported &&
+                        typeof imported.then === "function") {
+                        continue;
+                    }
+                    this.scanControllers(imported, result, seen, recursive);
+                }
+            }
+        }
+        for (const key of Object.keys(record)) {
+            const candidate = record[key];
+            if (this.isController(candidate) && !result.includes(candidate)) {
+                result.push(candidate);
+            }
+        }
+    }
+}
+/**
+ * @summary Resolve route definitions from dynamically loaded NestJS modules.
+ */
+export class NestRouteObjectLoader extends ObjectLoader {
+    constructor(options = {}) {
+        super({ ...options, family: "route" });
+    }
+    /**
+     * @summary Load every route declared by a controller exported from a module.
+     */
+    async loadControllerRoutes(source, exportName = this.defaultExportName, options = {}) {
+        await loadNestCommon();
+        const value = await this.loadExport(source, exportName, options);
+        const controller = this.assertController(value, this.normalizeSource(source), exportName);
+        const routes = this.getRoutes(controller);
+        const context = this.createContext(this.normalizeSource(source), exportName, {}, "afterResolve", {
+            ...this.metadata,
+            ...(options.metadata ?? {}),
+            routeCount: routes.length,
+        });
+        return this.runHooks(routes, context, options);
+    }
+    /**
+     * @summary Load every route declared by every controller in a module.
+     */
+    async loadRoutes(source, options = {}) {
+        await loadNestCommon();
+        const module = await this.loadModule(source);
+        const controllerLoader = new NestControllerObjectLoader({
+            hooks: this.hooks,
+            beforeResolveHooks: this.beforeResolveHooks,
+        });
+        const controllers = controllerLoader.collectControllers(module);
+        const routes = [];
+        for (const controller of controllers) {
+            routes.push(...this.getRoutes(controller));
+        }
+        const context = this.createContext(this.normalizeSource(source), "*", module, "afterResolve", {
+            ...this.metadata,
+            ...(options.metadata ?? {}),
+            routeCount: routes.length,
+        });
+        return this.runHooks(routes, context, options);
+    }
+    /**
+     * @summary Extract route definitions from a controller class.
+     * @description Synchronous metadata scan. Requires `reflect-metadata`.
+     */
+    getRoutes(controller, controllerPath) {
+        const reader = metadataReader();
+        const resolvedControllerPath = controllerPath ?? this.getControllerPath(controller);
+        const prototype = controller.prototype;
+        const keys = [
+            ...Object.getOwnPropertyNames(prototype),
+            ...Object.getOwnPropertySymbols(prototype),
+        ];
+        const routes = [];
+        for (const propertyKey of keys) {
+            if (propertyKey === "constructor")
+                continue;
+            const handler = prototype[propertyKey];
+            if (typeof handler !== "function")
+                continue;
+            const method = reader.getMetadata(NEST_METHOD_METADATA, handler);
+            if (typeof method !== "number")
+                continue;
+            const routePath = reader.getMetadata(NEST_PATH_METADATA, handler);
+            const path = typeof routePath === "string" ? routePath : "";
+            routes.push({
+                controller,
+                controllerName: controller.name,
+                controllerPath: resolvedControllerPath || undefined,
+                propertyKey,
+                handler: handler,
+                method,
+                methodName: methodNameFor(method),
+                path,
+                fullPath: joinRoutePaths(resolvedControllerPath, path),
+            });
+        }
+        return routes;
+    }
+    isController(value) {
+        if (typeof value !== "function")
+            return false;
+        const reader = metadataReader();
+        return (reader.getMetadata(NEST_CONTROLLER_WATERMARK, value) === true ||
+            typeof reader.getMetadata(NEST_PATH_METADATA, value) !== "undefined");
+    }
+    getControllerPath(controller) {
+        const value = metadataReader().getMetadata(NEST_PATH_METADATA, controller);
+        return typeof value === "string" ? value : undefined;
+    }
+    assertController(value, source, exportName) {
+        if (!this.isController(value)) {
+            throw new ValidationError(`Loaded controller export "${exportName}" from "${source}" is not a NestJS controller.`);
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=nest.js.map

package/lib/esm/loader/nest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest.js","sourceRoot":"","sources":["../../../src/loader/nest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,OAAO,EAAE,YAAY,EAAE,0BAAuB;AAO9C;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AACzC,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAQ,CAAC;AAC7C,MAAM,CAAC,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;AAC1D,MAAM,CAAC,MAAM,uBAAuB,GAAG,aAAa,CAAC;AACrD,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAC;AAE7C,MAAM,qBAAqB,GAAG,gBAAgB,CAAC;AAE/C,MAAM,iBAAiB,GAA2B;IAChD,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,QAAQ;IACX,CAAC,EAAE,UAAU;IACb,EAAE,EAAE,WAAW;IACf,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,MAAM;IACV,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,OAAO;CACZ,CAAC;AAMF,IAAI,iBAAyE,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAGlC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,iBAAiB,GAAG,MAAM,CAAC,kBAAkB,CAAC,qBAAqB,CAAC;aACjE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,MAAM,QAAQ,GAAG,MAA2C,CAAC;YAC7D,IAAI,OAAO,QAAQ,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBAC9C,MAAM,IAAI,gBAAgB,CACxB,yCAAyC,qBAAqB,yCAAyC,CACxG,CAAC;YACJ,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxB,iBAAiB,GAAG,SAAS,CAAC;YAC9B,IAAI,KAAK,YAAY,gBAAgB;gBAAE,MAAM,KAAK,CAAC;YACnD,MAAM,IAAI,gBAAgB,CACxB,yCAAyC,qBAAqB,2BAA2B;gBACvF,uEAAuE;gBACvE,UAAW,KAAe,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CACzD,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc;IACrB,MAAM,OAAO,GAAG,OAA6C,CAAC;IAC9D,IAAI,OAAO,OAAO,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;QAC9C,MAAM,IAAI,gBAAgB,CACxB,kGAAkG,CACnG,CAAC;IACJ,CAAC;IACD,OAAO,OAAyB,CAAC;AACnC,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO,iBAAiB,CAAC,MAAM,CAAC,IAAI,UAAU,MAAM,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAe;IACvC,OAAO,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,cAAc,CAAC,cAAuB,EAAE,SAAkB;IACjE,MAAM,QAAQ,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC;SACzC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC;SAC7D,GAAG,CAAC,gBAAgB,CAAC;SACrB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;AAClC,CAAC;AA2BD;;;;GAIG;AACH,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IAC1D,YAAmB,UAA+B,EAAE;QAClD,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC9C,CAAC;IAEM,KAAK,CAAC,cAAc,CACzB,MAA0B,EAC1B,aAAqB,IAAI,CAAC,iBAAiB,EAC3C,UAAmC,EAAE;QAErC,MAAM,cAAc,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAU,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1E,OAAO,IAAI,CAAC,gBAAgB,CAC1B,KAAK,EACL,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAC5B,UAAU,CACX,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,eAAe,CAC1B,MAA0B,EAC1B,UAAqC,EAAE;QAEvC,MAAM,cAAc,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAI,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAChC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAC5B,GAAG,EACH,MAAM,EACN,cAAc,EACd;YACE,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC3B,eAAe,EAAE,WAAW,CAAC,MAAM;SACpC,CACF,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACI,kBAAkB,CACvB,KAAc,EACd,SAAS,GAAG,IAAI;QAEhB,MAAM,MAAM,GAAQ,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;QAChC,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,YAAY,CAAC,KAAc;QAChC,IAAI,OAAO,KAAK,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC;QAC9C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,OAAO,CACL,MAAM,CAAC,WAAW,CAAC,yBAAyB,EAAE,KAAK,CAAC,KAAK,IAAI;YAC7D,OAAO,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE,KAAK,CAAC,KAAK,WAAW,CACrE,CAAC;IACJ,CAAC;IAEM,iBAAiB,CAAC,UAAuB;QAC9C,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC,WAAW,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;QAC3E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IAES,gBAAgB,CACxB,KAAc,EACd,MAAc,EACd,UAAkB;QAElB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,eAAe,CACvB,6BAA6B,UAAU,WAAW,MAAM,+BAA+B,CACxF,CAAC;QACJ,CAAC;QACD,OAAO,KAAU,CAAC;IACpB,CAAC;IAES,eAAe,CACvB,KAAc,EACd,MAAW,EACX,IAAkB,EAClB,SAAkB;QAElB,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAChD,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAU,CAAC,EAAE,CAAC;gBAC7D,MAAM,CAAC,IAAI,CAAC,KAAU,CAAC,CAAC;YAC1B,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO;QAC5B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEhB,MAAM,MAAM,GAAG,KAAyC,CAAC;QACzD,MAAM,WAAW,GAAG,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACpD,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,IACE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC;oBAC7B,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAe,CAAC,EACjC,CAAC;oBACD,MAAM,CAAC,IAAI,CAAC,UAAe,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;QACH,CAAC;QAED,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,OAAO,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC;YAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC3B,KAAK,MAAM,QAAQ,IAAI,OAAO,EAAE,CAAC;oBAC/B,IACE,QAAQ;wBACR,OAAQ,QAA6B,CAAC,IAAI,KAAK,UAAU,EACzD,CAAC;wBACD,SAAS;oBACX,CAAC;oBACD,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;gBAC1D,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACtC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9B,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAc,CAAC,EAAE,CAAC;gBACrE,MAAM,CAAC,IAAI,CAAC,SAAc,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,qBAAsB,SAAQ,YAAY;IACrD,YAAmB,UAA+B,EAAE;QAClD,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,oBAAoB,CAC/B,MAA0B,EAC1B,aAAqB,IAAI,CAAC,iBAAiB,EAC3C,UAAmC,EAAE;QAErC,MAAM,cAAc,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,UAAU,CAAU,MAAM,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QAC1E,MAAM,UAAU,GAAG,IAAI,CAAC,gBAAgB,CACtC,KAAK,EACL,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAC5B,UAAU,CACX,CAAC;QACF,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAChC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAC5B,UAAU,EACV,EAAE,EACF,cAAc,EACd;YACE,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC3B,UAAU,EAAE,MAAM,CAAC,MAAM;SAC1B,CACF,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,UAAU,CACrB,MAA0B,EAC1B,UAAmC,EAAE;QAErC,MAAM,cAAc,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,gBAAgB,GAAG,IAAI,0BAA0B,CAAC;YACtD,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;SAC5C,CAAC,CAAC;QACH,MAAM,WAAW,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,MAAM,GAA0B,EAAE,CAAC;QACzC,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7C,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAChC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAC5B,GAAG,EACH,MAAM,EACN,cAAc,EACd;YACE,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,CAAC,OAAO,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC3B,UAAU,EAAE,MAAM,CAAC,MAAM;SAC1B,CACF,CAAC;QACF,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACI,SAAS,CACd,UAAuB,EACvB,cAAuB;QAEvB,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,sBAAsB,GAC1B,cAAc,IAAI,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACvD,MAAM,SAAS,GAAG,UAAU,CAAC,SAA6C,CAAC;QAC3E,MAAM,IAAI,GAAwB;YAChC,GAAG,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC;YACxC,GAAG,MAAM,CAAC,qBAAqB,CAAC,SAAS,CAAC;SAC3C,CAAC;QACF,MAAM,MAAM,GAA0B,EAAE,CAAC;QACzC,KAAK,MAAM,WAAW,IAAI,IAAI,EAAE,CAAC;YAC/B,IAAI,WAAW,KAAK,aAAa;gBAAE,SAAS;YAC5C,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;YACvC,IAAI,OAAO,OAAO,KAAK,UAAU;gBAAE,SAAS;YAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;YACjE,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,SAAS;YACzC,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;YAClE,MAAM,IAAI,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5D,MAAM,CAAC,IAAI,CAAC;gBACV,UAAU;gBACV,cAAc,EAAE,UAAU,CAAC,IAAI;gBAC/B,cAAc,EAAE,sBAAsB,IAAI,SAAS;gBACnD,WAAW;gBACX,OAAO,EAAE,OAA0C;gBACnD,MAAM;gBACN,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC;gBACjC,IAAI;gBACJ,QAAQ,EAAE,cAAc,CAAC,sBAAsB,EAAE,IAAI,CAAC;aACvD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEM,YAAY,CAAC,KAAc;QAChC,IAAI,OAAO,KAAK,KAAK,UAAU;YAAE,OAAO,KAAK,CAAC;QAC9C,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,OAAO,CACL,MAAM,CAAC,WAAW,CAAC,yBAAyB,EAAE,KAAK,CAAC,KAAK,IAAI;YAC7D,OAAO,MAAM,CAAC,WAAW,CAAC,kBAAkB,EAAE,KAAK,CAAC,KAAK,WAAW,CACrE,CAAC;IACJ,CAAC;IAEM,iBAAiB,CAAC,UAAuB;QAC9C,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC,WAAW,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;QAC3E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IAES,gBAAgB,CACxB,KAAc,EACd,MAAc,EACd,UAAkB;QAElB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,eAAe,CACvB,6BAA6B,UAAU,WAAW,MAAM,+BAA+B,CACxF,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/lib/esm/redis/RedisContextLock.js

@@ -0,0 +1,180 @@
+import { ContextLock } from "@decaf-ts/core";
+import { ConflictError } from "@decaf-ts/db-decorators";
+import { WatchError } from "redis";
+/**
+ * @description Redis-native transaction lock for the Redis adapter
+ * @summary Backs `@transactional()` with a dedicated Redis connection carrying a
+ * native `MULTI` command queue plus an in-memory read cache. Every CRUD write
+ * performed under an active transaction is queued on the native `MULTI` object and
+ * mirrored into the read cache, so the transaction observes its own writes
+ * (read-your-writes) while remaining invisible to every other connection until
+ * {@link RedisContextLock.commit} issues `WATCH` and `EXEC`. If a watched table
+ * changed concurrently, `EXEC` aborts and the transaction raises a
+ * `ConflictError` instead of silently overwriting the concurrent write.
+ *
+ * A dedicated connection is required: `WATCH` is per-connection state on the
+ * node-redis client, so a `WATCH` issued on the shared, multiplexed adapter
+ * client would be cleared or replaced by any concurrent adapter operation (and a
+ * concurrent write to a watched key would abort an unrelated transaction).
+ * @class RedisContextLock
+ * @category Redis
+ */
+export class RedisContextLock extends ContextLock {
+    constructor() {
+        super(...arguments);
+        this.readCache = new Map();
+    }
+    /**
+     * @description Whether a Redis transaction is currently open
+     * @return {boolean} True while a transaction is active
+     */
+    get active() {
+        return !!this.txClient;
+    }
+    /**
+     * @description Returns the buffered entry for a record, when present
+     * @param {string} table - The table (model) name
+     * @param {string} id - The record id
+     * @return {{found: boolean, value?: RedisBufferedValue}} The buffered entry state
+     */
+    getRecord(table, id) {
+        const entries = this.readCache.get(table);
+        if (!entries || !entries.has(id))
+            return { found: false };
+        return { found: true, value: entries.get(id) };
+    }
+    /**
+     * @description Queues a serialized record on the native transaction and buffers it for reads
+     * @param {string} table - The table (model) name
+     * @param {string} id - The record id
+     * @param {string} value - The serialized record
+     * @return {void}
+     */
+    setRecord(table, id, value) {
+        let entries = this.readCache.get(table);
+        if (!entries) {
+            entries = new Map();
+            this.readCache.set(table, entries);
+        }
+        entries.set(id, value);
+        if (!this.multi)
+            return;
+        const key = this.adapter.recordKey(table);
+        if (value === null)
+            this.multi.hDel(key, id);
+        else
+            this.multi.hSet(key, id, value);
+    }
+    /**
+     * @description Queues a record deletion on the native transaction and buffers it
+     * @param {string} table - The table (model) name
+     * @param {string} id - The record id
+     * @return {void}
+     */
+    deleteRecord(table, id) {
+        this.setRecord(table, id, null);
+    }
+    /**
+     * @description Returns the buffered writes for a table, when any exist
+     * @param {string} table - The table (model) name
+     * @return {Map<string, RedisBufferedValue> | undefined} The buffered entries
+     */
+    tableEntries(table) {
+        return this.readCache.get(table);
+    }
+    /**
+     * @description Starts the transaction, opening a dedicated connection and native queue
+     * @summary Delegates to the base implementation so `maxConcurrentTransactions`
+     * continues to gate concurrency, then opens a dedicated connection and its native
+     * `MULTI` command queue.
+     * @param {Context<any>} context - The context the transaction is starting under
+     * @return {Promise<void>} A promise that resolves once the transaction is open
+     */
+    async begin(context) {
+        await super.begin(context);
+        try {
+            const client = this.adapter.client.duplicate();
+            await client.connect();
+            this.txClient = client;
+            this.multi = this.txClient.multi();
+        }
+        catch (e) {
+            await super.rollback(e, context);
+            throw e;
+        }
+    }
+    /**
+     * @description Flushes the queued writes atomically and ends the transaction
+     * @summary `WATCH`es every touched table on the dedicated connection, then runs
+     * the native `MULTI` queue with `EXEC`. If a watched table changed concurrently,
+     * `EXEC` aborts with a `WatchError` and the transaction raises a
+     * `ConflictError`. On success (or conflict) the dedicated connection is released
+     * and the concurrency permit returned.
+     * @param {Context<any>} context - The context the transaction ran under
+     * @return {Promise<void>} A promise that resolves once the transaction ends
+     */
+    async commit(context) {
+        if (!this.txClient || !this.multi) {
+            await super.commit(context);
+            return;
+        }
+        const watched = [...this.readCache.keys()].map((table) => this.adapter.recordKey(table));
+        try {
+            if (watched.length)
+                await this.txClient.watch(watched);
+            await this.multi.exec();
+        }
+        catch (e) {
+            if (e instanceof WatchError)
+                throw new ConflictError("Redis transaction aborted: a watched record changed concurrently");
+            throw e;
+        }
+        finally {
+            await this.releaseTx();
+            await super.commit(context);
+        }
+    }
+    /**
+     * @description Discards the queued writes and ends the transaction
+     * @param {Error} err - The error that triggered the rollback
+     * @param {Context<any>} context - The context the transaction ran under
+     * @return {Promise<void>} A promise that resolves once the transaction ends
+     */
+    async rollback(err, context) {
+        await this.releaseTx();
+        await super.rollback(err, context);
+    }
+    /**
+     * @description Releases the dedicated transaction connection and clears state
+     * @summary Unwatches and closes the dedicated connection, then clears the native
+     * queue and read cache so queued writes are never applied after rollback or after
+     * an already flushed commit.
+     * @return {Promise<void>} A promise that resolves once the connection is released
+     */
+    async releaseTx() {
+        const client = this.txClient;
+        this.txClient = undefined;
+        this.multi = undefined;
+        this.readCache.clear();
+        if (!client)
+            return;
+        try {
+            await client.unwatch();
+        }
+        catch {
+            // the connection may already be gone; nothing left to unwatch
+        }
+        try {
+            await client.quit();
+        }
+        catch {
+            try {
+                client.destroy();
+            }
+            catch {
+                // connection already closed
+            }
+        }
+    }
+}
+//# sourceMappingURL=RedisContextLock.js.map

package/lib/esm/redis/RedisContextLock.js.map

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

package/lib/esm/redis/RedisDispatch.js

@@ -0,0 +1,127 @@
+import { Dispatch } from "@decaf-ts/core";
+import { OperationKeys } from "@decaf-ts/db-decorators";
+import { Model } from "@decaf-ts/decorator-validation";
+import { randomUUID } from "crypto";
+import { RedisEventsChannel } from "./constants.js";
+/**
+ * @description Dispatcher for Redis change events
+ * @summary Extends the core `Dispatch` to broadcast record changes over Redis
+ * pub/sub so that every process sharing the same database refreshes its observers.
+ * Local observer updates are still performed synchronously through the base class;
+ * the published message carries an `origin` id so a process ignores the echo of its
+ * own events and never notifies its observers twice.
+ * @class RedisDispatch
+ * @category Redis
+ */
+export class RedisDispatch extends Dispatch {
+    constructor() {
+        super(...arguments);
+        this.origin = randomUUID();
+        /**
+         * @description Whether the pub/sub subscription is currently active
+         */
+        this.active = false;
+    }
+    /**
+     * @description Initializes the dispatcher and opens the pub/sub subscription
+     * @summary Proxies the adapter's CRUD methods through the base implementation,
+     * then opens a dedicated subscriber connection listening for change events.
+     * @param {...ContextualArgs} args - Contextual arguments
+     * @return {Promise<void>} A promise that resolves once initialization is complete
+     */
+    async initialize(...args) {
+        await super.initialize(...args);
+        if (!this.adapter)
+            return;
+        try {
+            const subscriber = this.adapter.client.duplicate();
+            await subscriber.connect();
+            await subscriber.subscribe(RedisEventsChannel, (message) => void this.changeHandler(message));
+            this.subscriber = subscriber;
+            this.active = true;
+        }
+        catch (e) {
+            this.log
+                .for(this.initialize)
+                .error(`Failed to subscribe to Redis change events: ${e}`);
+        }
+    }
+    /**
+     * @description Closes the dispatcher and releases the pub/sub subscription
+     * @param {...ContextualArgs} args - Contextual arguments
+     * @return {Promise<void>} A promise that resolves once the dispatcher is closed
+     */
+    async close(...args) {
+        this.active = false;
+        const subscriber = this.subscriber;
+        this.subscriber = undefined;
+        if (subscriber) {
+            try {
+                await subscriber.unsubscribe(RedisEventsChannel);
+            }
+            catch (e) {
+                this.log
+                    .for(this.close)
+                    .error(`Failed to unsubscribe from Redis change events: ${e}`);
+            }
+            try {
+                await subscriber.quit();
+            }
+            catch (e) {
+                this.log
+                    .for(this.close)
+                    .error(`Failed to close Redis change subscriber: ${e}`);
+            }
+        }
+        return super.close(...args);
+    }
+    /**
+     * @description Notifies local observers and broadcasts the event to other processes
+     * @summary Performs the base local refresh, then publishes the change to the
+     * Redis pub/sub channel. Remote processes receive the event and refresh their own
+     * observers; the originating process ignores its own message.
+     * @param {Constructor<any> | string} model - The model (or table name) that changed
+     * @param {OperationKeys | BulkCrudOperationKeys | string} event - The operation that occurred
+     * @param {any} id - The identifier(s) of the affected record(s)
+     * @param {...ContextualArgs} args - Contextual arguments
+     * @return {Promise<void>} A promise that resolves once observers are notified
+     */
+    async updateObservers(model, event, id, ...args) {
+        await super.updateObservers(model, event, id, ...args);
+        if (!this.adapter)
+            return;
+        const table = model && typeof model === "string" ? model : Model.tableName(model);
+        try {
+            await this.adapter.client.publish(RedisEventsChannel, JSON.stringify({ origin: this.origin, table, event: String(event), id }));
+        }
+        catch (e) {
+            this.log
+                .for(this.updateObservers)
+                .error(`Failed to publish Redis change event: ${e}`);
+        }
+    }
+    /**
+     * @description Handles an incoming Redis change event
+     * @summary Ignores the echo of locally published events and refreshes the
+     * observers of this process for events published elsewhere.
+     * @param {string} message - The raw JSON pub/sub payload
+     * @return {Promise<void>} A promise that resolves once observers are notified
+     */
+    async changeHandler(message) {
+        try {
+            const parsed = JSON.parse(message);
+            if (parsed.origin === this.origin)
+                return;
+            if (!this.adapter)
+                return;
+            const ctx = await this.adapter.context(OperationKeys.UPDATE, {}, Model);
+            await super.updateObservers(parsed.table, parsed.event, parsed.id, ctx);
+        }
+        catch (e) {
+            this.log
+                .for(this.changeHandler)
+                .error(`Failed to process Redis change event: ${e}`);
+        }
+    }
+}
+//# sourceMappingURL=RedisDispatch.js.map

package/lib/esm/redis/RedisDispatch.js.map

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