@decaf-ts/integrations 0.10.5 → 0.11.0

package/lib/esm/loader/ObjectLoader.js

@@ -12,12 +12,26 @@ function isPathLikeSource(source) {
  * @description Base loader and concrete family loaders for dynamically
  * resolving Decaf integration objects without forcing callers to duplicate
  * import, selection, or post-load hook logic.
+ *
+ * ## Tree-shaking / build-time references
+ *
+ * Dynamic imports are resolved at runtime, so a bundler cannot see which modules
+ * are actually reachable and may drop them from the output. To keep a module
+ * available, keep a *static* reference to it somewhere in the entry graph (for
+ * example a `loaderManifest` object or a side-effect import) while the runtime
+ * lookup still goes through {@link ObjectLoader.loadModule}. Prefer passing the
+ * specifier as a variable (`import(specifier)`) instead of a string literal:
+ * bundlers leave non-literal dynamic imports untouched, which preserves the
+ * lazy/runtime semantics. See {@link moduleReference} for a small helper that
+ * encodes this pattern.
  */
 export class ObjectLoader {
     constructor(options = {}) {
         this.family = options.family ?? "generic";
         this.defaultExportName = options.defaultExportName ?? "default";
         this.hooks = options.hooks ?? [];
+        this.beforeResolveHooks = options.beforeResolveHooks ?? [];
+        this.metadata = options.metadata ?? {};
     }
     normalizeSource(source) {
         if (source instanceof URL) {
@@ -44,9 +58,13 @@ export class ObjectLoader {
             if (exportedNames.length === 1) {
                 return module[exportedNames[0]];
             }
+            // Pre-existing raw Error kept for backward compatibility. New code paths
+            // must throw a decaf error hierarchy subclass instead.
             throw new Error(`Module "${source}" does not expose a default export.`);
         }
         if (!(exportName in module)) {
+            // Pre-existing raw Error kept for backward compatibility. New code paths
+            // must throw a decaf error hierarchy subclass instead.
             throw new Error(`Module "${source}" does not export "${exportName}".`);
         }
         return module[exportName];
@@ -61,6 +79,43 @@ export class ObjectLoader {
         }
         return current;
     }
+    /**
+     * @summary Build the hook context for a load operation.
+     * @description Concrete loaders call this to build a context that carries the
+     * load phase and any loader-specific metadata into hooks.
+     */
+    createContext(source, exportName, module, phase, metadata = this.metadata) {
+        return {
+            family: this.family,
+            source,
+            exportName,
+            module,
+            loaderName: this.constructor.name,
+            phase,
+            metadata,
+        };
+    }
+    /**
+     * @summary Run the configured export hooks against a value.
+     * @description Exposed to concrete loaders that load content (assets, configs)
+     * instead of importing a module, so they can reuse the same hook pipeline.
+     */
+    async runHooks(value, context, options = {}) {
+        const hooks = [...this.hooks, ...(options.hooks ?? [])];
+        return this.applyHooks(value, context, hooks);
+    }
+    /**
+     * @summary Run the configured pre-resolve hooks against a module namespace.
+     */
+    async runBeforeResolveHooks(module, context, options = {}) {
+        const hooks = [
+            ...this.beforeResolveHooks,
+            ...(options.beforeResolveHooks ?? []),
+        ];
+        if (!hooks.length)
+            return module;
+        return this.applyHooks(module, context, hooks);
+    }
     createInstance(options) {
         const Loader = this.constructor;
         return new Loader(options);
@@ -70,17 +125,12 @@ export class ObjectLoader {
     }
     async loadExport(source, exportName = this.defaultExportName, options = {}) {
         const normalizedSource = this.normalizeSource(source);
-        const module = await this.importModule(normalizedSource);
+        const imported = await this.importModule(normalizedSource);
+        const beforeResolveContext = this.createContext(normalizedSource, exportName, imported, "beforeResolve", options.metadata ?? this.metadata);
+        const module = await this.runBeforeResolveHooks(imported, beforeResolveContext, options);
         const resolved = this.resolveExport(module, exportName, normalizedSource);
-        const hookContext = {
-            family: this.family,
-            source: normalizedSource,
-            exportName,
-            module,
-            loaderName: this.constructor.name,
-        };
-        const hooks = [...this.hooks, ...(options.hooks ?? [])];
-        return this.applyHooks(resolved, hookContext, hooks);
+        const afterResolveContext = this.createContext(normalizedSource, exportName, module, "afterResolve", options.metadata ?? this.metadata);
+        return this.runHooks(resolved, afterResolveContext, options);
     }
     async loadDefault(source, options = {}) {
         return this.loadExport(source, this.defaultExportName, options);
@@ -93,6 +143,17 @@ export class ObjectLoader {
             family: this.family,
             defaultExportName: this.defaultExportName,
             hooks: [...this.hooks, ...hooks],
+            beforeResolveHooks: [...this.beforeResolveHooks],
+            metadata: this.metadata,
+        });
+    }
+    withBeforeResolveHooks(...hooks) {
+        return this.createInstance({
+            family: this.family,
+            defaultExportName: this.defaultExportName,
+            hooks: [...this.hooks],
+            beforeResolveHooks: [...this.beforeResolveHooks, ...hooks],
+            metadata: this.metadata,
         });
     }
     withOptions(options) {
@@ -100,16 +161,38 @@ export class ObjectLoader {
             family: options.family ?? this.family,
             defaultExportName: options.defaultExportName ?? this.defaultExportName,
             hooks: [...this.hooks, ...(options.hooks ?? [])],
+            beforeResolveHooks: [
+                ...this.beforeResolveHooks,
+                ...(options.beforeResolveHooks ?? []),
+            ],
+            metadata: { ...this.metadata, ...(options.metadata ?? {}) },
         });
     }
 }
-export function createLoaderHookContext(loader, module, source, exportName) {
+export function createLoaderHookContext(loader, module, source, exportName, phase = "afterResolve", metadata = {}) {
     return {
         family: loader.family,
         source,
         exportName,
         module,
         loaderName: loader.constructor.name,
+        phase,
+        metadata,
     };
 }
+/**
+ * @summary Build a lazy module reference that survives bundling.
+ * @description Pass a *variable* specifier to `import()` so bundlers do not
+ * statically inline or drop the target. Pair it with a static reference in your
+ * entry graph when the module must be retained:
+ *
+ * ```ts
+ * export const loaderManifest = { feature: "./feature/index.js" } as const;
+ * const reference = moduleReference(loaderManifest.feature);
+ * const module = await reference();
+ * ```
+ */
+export function moduleReference(specifier) {
+    return () => import(/* @vite-ignore */ specifier);
+}
 //# sourceMappingURL=ObjectLoader.js.map

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

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

package/lib/esm/loader/assets.js

@@ -0,0 +1,155 @@
+import { readFile } from "node:fs/promises";
+import { basename, extname, isAbsolute, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { UnsupportedError } from "@decaf-ts/core";
+import { ObjectLoader } from "./ObjectLoader.js";
+const TEXT_EXTENSIONS = new Set([
+    ".txt",
+    ".md",
+    ".csv",
+    ".html",
+    ".htm",
+    ".xml",
+    ".yaml",
+    ".yml",
+    ".graphql",
+    ".sql",
+]);
+const IMAGE_EXTENSIONS = new Set([
+    ".png",
+    ".jpg",
+    ".jpeg",
+    ".gif",
+    ".webp",
+    ".bmp",
+    ".ico",
+    ".avif",
+    ".tiff",
+]);
+const CONTENT_TYPES = {
+    ".json": "application/json",
+    ".txt": "text/plain",
+    ".md": "text/markdown",
+    ".csv": "text/csv",
+    ".html": "text/html",
+    ".htm": "text/html",
+    ".xml": "application/xml",
+    ".yaml": "application/yaml",
+    ".yml": "application/yaml",
+    ".sql": "application/sql",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".bmp": "image/bmp",
+    ".ico": "image/x-icon",
+    ".avif": "image/avif",
+    ".tiff": "image/tiff",
+};
+function contentTypeFor(extension) {
+    return CONTENT_TYPES[extension] ?? "application/octet-stream";
+}
+/**
+ * @summary Load asset files as content instead of importing a class.
+ * @description Assets (locale files, images, templates, ...) are *not* modules;
+ * they are read from disk and decoded. Hooks run on the {@link LoadedAsset}
+ * record so callers can inspect or replace content before it enters the system.
+ *
+ * A `"json"` encoding parses the file content, `"utf8"` returns text,
+ * `"base64"` returns a base64 string, and `"binary"` returns the raw
+ * `Buffer`. `"auto"` picks `json` for `.json`, `utf8` for known text
+ * extensions, and `binary` otherwise.
+ */
+export class AssetObjectLoader extends ObjectLoader {
+    constructor(options = {}) {
+        super({ ...options, family: "asset" });
+    }
+    async loadAsset(source, options = {}) {
+        const path = this.toFilePath(source);
+        const name = basename(path);
+        const extension = extname(path).toLowerCase();
+        const encoding = this.resolveEncoding(extension, options.encoding ?? "auto");
+        const buffer = await readFile(path);
+        const content = this.decode(buffer, encoding);
+        const asset = {
+            source: this.normalizeSource(source),
+            path,
+            name,
+            extension,
+            encoding,
+            contentType: contentTypeFor(extension),
+            content,
+        };
+        const context = this.createContext(asset.source, name, {}, "afterResolve", {
+            ...this.metadata,
+            ...(options.metadata ?? {}),
+            encoding,
+            contentType: asset.contentType,
+        });
+        return this.runHooks(asset, context, options);
+    }
+    async loadText(source, options = {}) {
+        const asset = await this.loadAsset(source, {
+            ...options,
+            encoding: options.encoding && options.encoding !== "auto"
+                ? options.encoding
+                : "utf8",
+        });
+        return asset.content;
+    }
+    async loadJson(source, options = {}) {
+        const asset = await this.loadAsset(source, {
+            ...options,
+            encoding: "json",
+        });
+        return asset.content;
+    }
+    async loadBinary(source, options = {}) {
+        const asset = await this.loadAsset(source, {
+            ...options,
+            encoding: "binary",
+        });
+        return asset.content;
+    }
+    resolveEncoding(extension, requested) {
+        if (requested !== "auto")
+            return requested;
+        if (extension === ".json")
+            return "json";
+        if (TEXT_EXTENSIONS.has(extension))
+            return "utf8";
+        if (IMAGE_EXTENSIONS.has(extension))
+            return "binary";
+        return "binary";
+    }
+    decode(buffer, encoding) {
+        switch (encoding) {
+            case "json":
+                return JSON.parse(buffer.toString("utf8"));
+            case "base64":
+                return buffer.toString("base64");
+            case "binary":
+                return buffer;
+            case "utf8":
+            default:
+                return buffer.toString("utf8");
+        }
+    }
+    toFilePath(source) {
+        if (source instanceof URL) {
+            if (source.protocol !== "file:") {
+                throw new UnsupportedError(`AssetObjectLoader only supports local file sources, received "${source.href}".`);
+            }
+            return fileURLToPath(source);
+        }
+        if (source.startsWith("file:")) {
+            return fileURLToPath(source);
+        }
+        if (/^[a-z][a-z0-9+.-]*:\/\//i.test(source)) {
+            throw new UnsupportedError(`AssetObjectLoader only supports local file sources, received "${source}".`);
+        }
+        return isAbsolute(source) ? source : resolve(source);
+    }
+}
+//# sourceMappingURL=assets.js.map

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

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

package/lib/esm/loader/config.js

@@ -0,0 +1,202 @@
+import { readFile } from "node:fs/promises";
+import { basename, isAbsolute, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { UnsupportedError } from "@decaf-ts/core";
+import { ConflictError, NotFoundError } from "@decaf-ts/db-decorators";
+import { ObjectLoader } from "./ObjectLoader.js";
+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.
+ */
+export 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 UnsupportedError(`The global config registry is frozen; cannot register key "${key}".`);
+        }
+        if (this.store.has(key) && !options.override) {
+            throw new 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 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;
+    }
+}
+/** Process-wide config registry used by default. */
+export const 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}.
+ */
+export class ConfigObjectLoader extends ObjectLoader {
+    constructor(options = {}) {
+        super({ ...options, family: "config" });
+        this.registry = options.registry ?? 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 UnsupportedError(`Remote config source "${source}" requires a global fetch implementation.`);
+            }
+            const response = await fetch(source);
+            if (!response.ok) {
+                throw new UnsupportedError(`Remote config source "${source}" responded with ${response.status}.`);
+            }
+            return response.text();
+        }
+        const path = source.startsWith("file:")
+            ? fileURLToPath(source)
+            : isAbsolute(source)
+                ? source
+                : resolve(source);
+        return readFile(path, "utf8");
+    }
+    async loadYaml() {
+        try {
+            return (await import(/* @vite-ignore */ YAML_SPECIFIER));
+        }
+        catch (error) {
+            throw new 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)
+            ? 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>";
+    }
+}
+//# sourceMappingURL=config.js.map

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

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

package/lib/esm/loader/families.js

@@ -1,10 +1,28 @@
+import { ValidationError } from "@decaf-ts/db-decorators";
 import { ObjectLoader } from "./ObjectLoader.js";
+/**
+ * @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`.
+ */
+export function assertConstructor(value, family, source, exportName) {
+    if (typeof value !== "function") {
+        throw new 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.
+ */
 export class ModelObjectLoader extends 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);
     }
 }
 export class AdapterObjectLoader extends ObjectLoader {
@@ -23,12 +41,17 @@ export class RepositoryObjectLoader extends ObjectLoader {
         return this.loadExport(source, exportName, options);
     }
 }
+/**
+ * Concrete service loader. Resolves a service constructor from a module source and
+ * runs the shared hook pipeline before returning it.
+ */
 export class ServiceObjectLoader extends 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);
     }
 }
 export class ControllerObjectLoader extends ObjectLoader {
@@ -55,12 +78,4 @@ export class AngularComponentObjectLoader extends ObjectLoader {
         return this.loadExport(source, exportName, options);
     }
 }
-export class GraphNodeObjectLoader extends ObjectLoader {
-    constructor(options = {}) {
-        super({ ...options, family: "node" });
-    }
-    async loadNode(source, exportName = this.defaultExportName, options = {}) {
-        return this.loadExport(source, exportName, options);
-    }
-}
 //# sourceMappingURL=families.js.map

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

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

package/lib/esm/loader/index.js

@@ -8,4 +8,7 @@
 export * from "./types.js";
 export * from "./ObjectLoader.js";
 export * from "./families.js";
+export * from "./assets.js";
+export * from "./nest.js";
+export * from "./config.js";
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/loader/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,2BAAwB;AACxB,kCAA+B;AAC/B,8BAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/loader/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,2BAAwB;AACxB,kCAA+B;AAC/B,8BAA2B;AAC3B,4BAAyB;AACzB,0BAAuB;AACvB,4BAAyB"}