@decaf-ts/integrations 0.10.8 → 0.12.0

package/lib/cjs/loader/config.cjs

@@ -0,0 +1,241 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigObjectLoader = exports.globalConfig = exports.GlobalConfigRegistry = void 0;
+const promises_1 = require("node:fs/promises");
+const node_path_1 = require("node:path");
+const node_url_1 = require("node:url");
+const core_1 = require("@decaf-ts/core");
+const db_decorators_1 = require("@decaf-ts/db-decorators");
+const ObjectLoader_js_1 = require("./ObjectLoader.cjs");
+const YAML_SPECIFIER = "yaml";
+/**
+ * @summary Minimal global config registry.
+ * @description A process-wide key/value store that concrete loaders register
+ * loaded configuration into. It is intentionally small: register a value under a
+ * key, read it back, list it, snapshot it, and optionally freeze it once boot
+ * configuration is complete.
+ *
+ * `GlobalConfigRegistry.reset()` clears the contents but keeps the singleton
+ * instance, so a `globalConfig` reference captured at import time stays valid.
+ */
+class GlobalConfigRegistry {
+    constructor() {
+        this.store = new Map();
+        this.frozen = false;
+    }
+    static get instance() {
+        if (!GlobalConfigRegistry.current) {
+            GlobalConfigRegistry.current = new GlobalConfigRegistry();
+        }
+        return GlobalConfigRegistry.current;
+    }
+    static reset() {
+        if (GlobalConfigRegistry.current) {
+            GlobalConfigRegistry.current.clear();
+        }
+    }
+    register(key, value, options = {}) {
+        if (this.frozen) {
+            throw new core_1.UnsupportedError(`The global config registry is frozen; cannot register key "${key}".`);
+        }
+        if (this.store.has(key) && !options.override) {
+            throw new db_decorators_1.ConflictError(`Global config key "${key}" is already registered. Pass override: true to replace it.`);
+        }
+        this.store.set(key, value);
+        return this;
+    }
+    get(key) {
+        return this.store.get(key);
+    }
+    require(key) {
+        if (!this.store.has(key)) {
+            throw new db_decorators_1.NotFoundError(`Global config key "${key}" is not registered.`);
+        }
+        return this.store.get(key);
+    }
+    has(key) {
+        return this.store.has(key);
+    }
+    keys() {
+        return [...this.store.keys()];
+    }
+    entries() {
+        return [...this.store.entries()];
+    }
+    snapshot() {
+        return Object.freeze(Object.fromEntries(this.store));
+    }
+    clear() {
+        this.store.clear();
+    }
+    freeze() {
+        this.frozen = true;
+        return this;
+    }
+    get isFrozen() {
+        return this.frozen;
+    }
+}
+exports.GlobalConfigRegistry = GlobalConfigRegistry;
+/** Process-wide config registry used by default. */
+exports.globalConfig = GlobalConfigRegistry.instance;
+function isPlainObject(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        !Array.isArray(value) &&
+        !(value instanceof URL));
+}
+function isSourceLike(source) {
+    return typeof source === "string" || source instanceof URL;
+}
+/**
+ * @summary Load config sources into the global config registry.
+ * @description Supports inline objects, `.json` files, optional `.yaml`/`.yml`
+ * files, and JS/TS modules. Loaded configs run through the shared hook
+ * pipeline, then register under a key so the rest of the system can read them
+ * from {@link globalConfig}.
+ */
+class ConfigObjectLoader extends ObjectLoader_js_1.ObjectLoader {
+    constructor(options = {}) {
+        super({ ...options, family: "config" });
+        this.registry = options.registry ?? exports.globalConfig;
+    }
+    createInstance(options) {
+        return new ConfigObjectLoader({
+            ...options,
+            registry: this.registry,
+        });
+    }
+    /**
+     * @summary Load a config source, run hooks, and register it globally.
+     */
+    async loadConfig(source, options = {}) {
+        const { key, namespace, override, format = "auto", registry = this.registry, ...loadOptions } = options;
+        const value = await this.readConfig(source, format);
+        const resolvedKey = key ?? this.deriveKey(source, namespace);
+        const context = this.createContext(this.describeSource(source), resolvedKey, isPlainObject(value) ? value : {}, "afterResolve", {
+            ...this.metadata,
+            ...(options.metadata ?? {}),
+            key: resolvedKey,
+            namespace,
+        });
+        const processed = await this.runHooks(value, context, loadOptions);
+        registry.register(resolvedKey, processed, { override });
+        return processed;
+    }
+    /**
+     * @summary Alias for {@link ConfigObjectLoader.loadConfig}.
+     */
+    async loadAndRegister(source, options = {}) {
+        return this.loadConfig(source, options);
+    }
+    register(key, value, options = {}) {
+        const registry = options.registry ?? this.registry;
+        registry.register(key, value, { override: options.override });
+        return this;
+    }
+    get(key) {
+        return this.registry.get(key);
+    }
+    async readConfig(source, format) {
+        if (isPlainObject(source)) {
+            return source;
+        }
+        const normalized = this.normalizeSource(source);
+        const resolvedFormat = format === "auto" ? this.detectFormat(normalized) : format;
+        if (resolvedFormat === "json") {
+            return JSON.parse(await this.readText(normalized));
+        }
+        if (resolvedFormat === "yaml") {
+            const yaml = await this.loadYaml();
+            return yaml.parse(await this.readText(normalized));
+        }
+        const module = await this.importModule(normalized);
+        return this.resolveExport(module, this.defaultExportName, normalized);
+    }
+    detectFormat(source) {
+        const path = source.split("?")[0].toLowerCase();
+        if (path.endsWith(".json"))
+            return "json";
+        if (path.endsWith(".yaml") || path.endsWith(".yml"))
+            return "yaml";
+        return "module";
+    }
+    async readText(source) {
+        if (/^https?:\/\//i.test(source)) {
+            if (typeof fetch !== "function") {
+                throw new core_1.UnsupportedError(`Remote config source "${source}" requires a global fetch implementation.`);
+            }
+            const response = await fetch(source);
+            if (!response.ok) {
+                throw new core_1.UnsupportedError(`Remote config source "${source}" responded with ${response.status}.`);
+            }
+            return response.text();
+        }
+        const path = source.startsWith("file:")
+            ? (0, node_url_1.fileURLToPath)(source)
+            : (0, node_path_1.isAbsolute)(source)
+                ? source
+                : (0, node_path_1.resolve)(source);
+        return (0, promises_1.readFile)(path, "utf8");
+    }
+    async loadYaml() {
+        try {
+            return (await Promise.resolve(`${YAML_SPECIFIER}`).then(s => __importStar(require(s))));
+        }
+        catch (error) {
+            throw new core_1.UnsupportedError(`YAML config sources require the optional "yaml" package. ` +
+                `Install "yaml" or provide JSON/module config sources instead. ` +
+                `Cause: ${error?.message ?? String(error)}`);
+        }
+    }
+    deriveKey(source, namespace) {
+        const name = isSourceLike(source)
+            ? (0, node_path_1.basename)(this.describeSource(source)).replace(/\.[^.]+$/, "")
+            : "config";
+        return namespace ? `${namespace}:${name}` : name;
+    }
+    describeSource(source) {
+        if (source instanceof URL)
+            return source.href;
+        if (typeof source === "string")
+            return this.normalizeSource(source);
+        return "<inline>";
+    }
+}
+exports.ConfigObjectLoader = ConfigObjectLoader;
+//# sourceMappingURL=config.js.map
+//# sourceMappingURL=config.cjs.map

package/lib/cjs/loader/config.cjs.map

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

package/lib/cjs/loader/families.cjs

@@ -1,13 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.GraphNodeObjectLoader = exports.AngularComponentObjectLoader = exports.EnvironmentObjectLoader = exports.ControllerObjectLoader = exports.ServiceObjectLoader = exports.RepositoryObjectLoader = exports.AdapterObjectLoader = exports.ModelObjectLoader = void 0;
+exports.AngularComponentObjectLoader = exports.EnvironmentObjectLoader = exports.ControllerObjectLoader = exports.ServiceObjectLoader = exports.RepositoryObjectLoader = exports.AdapterObjectLoader = exports.ModelObjectLoader = void 0;
+exports.assertConstructor = assertConstructor;
+const db_decorators_1 = require("@decaf-ts/db-decorators");
 const ObjectLoader_js_1 = require("./ObjectLoader.cjs");
+/**
+ * @summary Assert a loaded export is a constructor.
+ * @description Concrete class loaders (models, services, Nest controllers) only
+ * make sense for constructor exports. Throwing a decaf {@link ValidationError}
+ * keeps the failure inside the decaf error hierarchy instead of a raw `Error`.
+ */
+function assertConstructor(value, family, source, exportName) {
+    if (typeof value !== "function") {
+        throw new db_decorators_1.ValidationError(`Loaded ${family} export "${exportName}" from "${source}" is not a constructor.`);
+    }
+    return value;
+}
+/**
+ * Concrete model loader. Resolves a model constructor from a module source and
+ * runs the shared hook pipeline before returning it.
+ */
 class ModelObjectLoader extends ObjectLoader_js_1.ObjectLoader {
     constructor(options = {}) {
         super({ ...options, family: "model" });
     }
     async loadModel(source, exportName = this.defaultExportName, options = {}) {
-        return this.loadExport(source, exportName, options);
+        const value = await this.loadExport(source, exportName, options);
+        return assertConstructor(value, this.family, this.normalizeSource(source), exportName);
     }
 }
 exports.ModelObjectLoader = ModelObjectLoader;
@@ -29,12 +48,17 @@ class RepositoryObjectLoader extends ObjectLoader_js_1.ObjectLoader {
     }
 }
 exports.RepositoryObjectLoader = RepositoryObjectLoader;
+/**
+ * Concrete service loader. Resolves a service constructor from a module source and
+ * runs the shared hook pipeline before returning it.
+ */
 class ServiceObjectLoader extends ObjectLoader_js_1.ObjectLoader {
     constructor(options = {}) {
         super({ ...options, family: "service" });
     }
     async loadService(source, exportName = this.defaultExportName, options = {}) {
-        return this.loadExport(source, exportName, options);
+        const value = await this.loadExport(source, exportName, options);
+        return assertConstructor(value, this.family, this.normalizeSource(source), exportName);
     }
 }
 exports.ServiceObjectLoader = ServiceObjectLoader;
@@ -65,14 +89,5 @@ class AngularComponentObjectLoader extends ObjectLoader_js_1.ObjectLoader {
     }
 }
 exports.AngularComponentObjectLoader = AngularComponentObjectLoader;
-class GraphNodeObjectLoader extends ObjectLoader_js_1.ObjectLoader {
-    constructor(options = {}) {
-        super({ ...options, family: "node" });
-    }
-    async loadNode(source, exportName = this.defaultExportName, options = {}) {
-        return this.loadExport(source, exportName, options);
-    }
-}
-exports.GraphNodeObjectLoader = GraphNodeObjectLoader;
 //# sourceMappingURL=families.js.map
 //# sourceMappingURL=families.cjs.map

package/lib/cjs/loader/families.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loader/families.cjs","sourceRoot":"","sources":["loader/families.js"],"names":[],"mappings":"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"}
+{"version":3,"file":"loader/families.cjs","sourceRoot":"","sources":["loader/families.js"],"names":[],"mappings":"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"}

package/lib/cjs/loader/index.cjs

@@ -24,5 +24,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types.cjs"), exports);
 __exportStar(require("./ObjectLoader.cjs"), exports);
 __exportStar(require("./families.cjs"), exports);
+__exportStar(require("./assets.cjs"), exports);
+__exportStar(require("./nest.cjs"), exports);
+__exportStar(require("./config.cjs"), exports);
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.cjs.map

package/lib/cjs/loader/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"loader/index.cjs","sourceRoot":"","sources":["loader/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,6CAA2B;AAC3B,oDAAkC;AAClC,gDAA8B;AAC9B,iCAAiC"}
+{"version":3,"file":"loader/index.cjs","sourceRoot":"","sources":["loader/index.js"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;GAMG;AACH,6CAA2B;AAC3B,oDAAkC;AAClC,gDAA8B;AAC9B,8CAA4B;AAC5B,4CAA0B;AAC1B,8CAA4B;AAC5B,iCAAiC"}