@pristine-ts/configuration 2.0.3 → 2.0.5

package/dist/lib/cjs/configuration.module.js

@@ -18,6 +18,7 @@ exports.ConfigurationModule = void 0;
 const configuration_module_keyname_1 = require("./configuration.module.keyname");
 __exportStar(require("./errors/errors"), exports);
 __exportStar(require("./interfaces/interfaces"), exports);
+__exportStar(require("./loaders/loaders"), exports);
 __exportStar(require("./managers/managers"), exports);
 __exportStar(require("./parsers/parsers"), exports);
 __exportStar(require("./resolvers/resolvers"), exports);

package/dist/lib/cjs/configuration.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.module.js","sourceRoot":"","sources":["../../../src/configuration.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,iFAA0E;AAE1E,kDAAgC;AAChC,0DAAwC;AACxC,sDAAoC;AACpC,oDAAkC;AAClC,wDAAsC;AACtC,gDAA8B;AAC9B,gDAA8B;AAC9B,iEAA+C;AAElC,QAAA,mBAAmB,GAAoB;IAClD,OAAO,EAAE,yDAA0B;IAEnC,aAAa,EAAE,EAAE;CAClB,CAAA"}
+{"version":3,"file":"configuration.module.js","sourceRoot":"","sources":["../../../src/configuration.module.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,iFAA0E;AAE1E,kDAAgC;AAChC,0DAAwC;AACxC,oDAAkC;AAClC,sDAAoC;AACpC,oDAAkC;AAClC,wDAAsC;AACtC,gDAA8B;AAC9B,gDAA8B;AAC9B,iEAA+C;AAElC,QAAA,mBAAmB,GAAoB;IAClD,OAAO,EAAE,yDAA0B;IAEnC,aAAa,EAAE,EAAE;CAClB,CAAA"}

package/dist/lib/cjs/errors/configuration-definition-already-exists.error.js

@@ -5,13 +5,9 @@ const common_1 = require("@pristine-ts/common");
 /**
  * This Error represents a configuration error when a configuration definition already exists.
  */
-class ConfigurationDefinitionAlreadyExistsError extends common_1.LoggableError {
+class ConfigurationDefinitionAlreadyExistsError extends common_1.PristineError {
     constructor(message, parameterName) {
-        super(message, { parameterName });
-        // Set the prototype explicitly.
-        // As specified in the documentation in TypeScript
-        // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
-        Object.setPrototypeOf(this, ConfigurationDefinitionAlreadyExistsError.prototype);
+        super(message, { details: { parameterName } });
     }
 }
 exports.ConfigurationDefinitionAlreadyExistsError = ConfigurationDefinitionAlreadyExistsError;

package/dist/lib/cjs/errors/configuration-definition-already-exists.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration-definition-already-exists.error.js","sourceRoot":"","sources":["../../../../src/errors/configuration-definition-already-exists.error.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAElD;;GAEG;AACH,MAAa,yCAA0C,SAAQ,sBAAa;IAC1E,YAAmB,OAAe,EAAE,aAAqB;QACvD,KAAK,CAAC,OAAO,EAAE,EAAC,aAAa,EAAC,CAAC,CAAC;QAEhC,gCAAgC;QAChC,kDAAkD;QAClD,gIAAgI;QAChI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,yCAAyC,CAAC,SAAS,CAAC,CAAC;IACnF,CAAC;CACF;AATD,8FASC"}
+{"version":3,"file":"configuration-definition-already-exists.error.js","sourceRoot":"","sources":["../../../../src/errors/configuration-definition-already-exists.error.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAElD;;GAEG;AACH,MAAa,yCAA0C,SAAQ,sBAAa;IAC1E,YAAmB,OAAe,EAAE,aAAqB;QACvD,KAAK,CAAC,OAAO,EAAE,EAAC,OAAO,EAAE,EAAC,aAAa,EAAC,EAAC,CAAC,CAAC;IAAE,CAAC;CACjD;AAHD,8FAGC"}

package/dist/lib/cjs/errors/configuration-resolver.error.js

@@ -5,16 +5,12 @@ const common_1 = require("@pristine-ts/common");
 /**
  * This Error represents a configuration error when an error occurs in a resolver.
  */
-class ConfigurationResolverError extends common_1.LoggableError {
+class ConfigurationResolverError extends common_1.PristineError {
     constructor(message, value) {
-        super(message, {
-            value,
-            type: typeof (value),
-        });
-        // Set the prototype explicitly.
-        // As specified in the documentation in TypeScript
-        // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
-        Object.setPrototypeOf(this, ConfigurationResolverError.prototype);
+        super(message, { details: {
+                value,
+                type: typeof (value),
+            } });
     }
 }
 exports.ConfigurationResolverError = ConfigurationResolverError;

package/dist/lib/cjs/errors/configuration-resolver.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration-resolver.error.js","sourceRoot":"","sources":["../../../../src/errors/configuration-resolver.error.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAElD;;GAEG;AACH,MAAa,0BAA2B,SAAQ,sBAAa;IAC3D,YAAmB,OAAe,EAAE,KAAU;QAC5C,KAAK,CAAC,OAAO,EAAE;YACb,KAAK;YACL,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC;SACrB,CAAC,CAAC;QAEH,gCAAgC;QAChC,kDAAkD;QAClD,gIAAgI;QAChI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACpE,CAAC;CACF;AAZD,gEAYC"}
+{"version":3,"file":"configuration-resolver.error.js","sourceRoot":"","sources":["../../../../src/errors/configuration-resolver.error.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAElD;;GAEG;AACH,MAAa,0BAA2B,SAAQ,sBAAa;IAC3D,YAAmB,OAAe,EAAE,KAAU;QAC5C,KAAK,CAAC,OAAO,EAAE,EAAC,OAAO,EAAE;gBACvB,KAAK;gBACL,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC;aACrB,EAAC,CAAC,CAAC;IAAE,CAAC;CACV;AAND,gEAMC"}

package/dist/lib/cjs/errors/configuration-validation.error.js

@@ -5,13 +5,9 @@ const common_1 = require("@pristine-ts/common");
 /**
  * This Error represents a configuration error when a validation fails.
  */
-class ConfigurationValidationError extends common_1.LoggableError {
+class ConfigurationValidationError extends common_1.PristineError {
     constructor(messages) {
         super(messages.join("\n"));
-        // Set the prototype explicitly.
-        // As specified in the documentation in TypeScript
-        // https://github.com/Microsoft/TypeScript/wiki/Breaking-Changes#extending-built-ins-like-error-array-and-map-may-no-longer-work
-        Object.setPrototypeOf(this, ConfigurationValidationError.prototype);
     }
 }
 exports.ConfigurationValidationError = ConfigurationValidationError;

package/dist/lib/cjs/errors/configuration-validation.error.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration-validation.error.js","sourceRoot":"","sources":["../../../../src/errors/configuration-validation.error.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAElD;;GAEG;AACH,MAAa,4BAA6B,SAAQ,sBAAa;IAC7D,YAAmB,QAAkB;QACnC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAE3B,gCAAgC;QAChC,kDAAkD;QAClD,gIAAgI;QAChI,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,4BAA4B,CAAC,SAAS,CAAC,CAAC;IACtE,CAAC;CACF;AATD,oEASC"}
+{"version":3,"file":"configuration-validation.error.js","sourceRoot":"","sources":["../../../../src/errors/configuration-validation.error.ts"],"names":[],"mappings":";;;AAAA,gDAAkD;AAElD;;GAEG;AACH,MAAa,4BAA6B,SAAQ,sBAAa;IAC7D,YAAmB,QAAkB;QACnC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAAE,CAAC;CACjC;AAHD,oEAGC"}

package/dist/lib/cjs/loaders/loaders.js

@@ -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("./pristine-config-file.interface"), exports);
+__exportStar(require("./pristine-config-file.loader"), exports);
+//# sourceMappingURL=loaders.js.map

package/dist/lib/cjs/loaders/loaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loaders.js","sourceRoot":"","sources":["../../../../src/loaders/loaders.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mEAAiD;AACjD,gEAA8C"}

package/dist/lib/cjs/loaders/pristine-config-file.interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=pristine-config-file.interface.js.map

package/dist/lib/cjs/loaders/pristine-config-file.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pristine-config-file.interface.js","sourceRoot":"","sources":["../../../../src/loaders/pristine-config-file.interface.ts"],"names":[],"mappings":""}

package/dist/lib/cjs/loaders/pristine-config-file.loader.js

@@ -0,0 +1,130 @@
+"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 __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PristineConfigFileLoader = void 0;
+const tsyringe_1 = require("tsyringe");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+/**
+ * Locates and dynamically imports `pristine.config.{ts,js}`. Lives in
+ * `@pristine-ts/configuration` so both the configuration manager (reads the `config:`
+ * block during kernel boot) and the CLI bootstrap (reads the `cli:` block before the
+ * kernel exists) share one walker, one importer, and one cache — avoiding drift between
+ * two separate readers seeing different files.
+ *
+ * **Memoized per absolute path**: once a config file is found at a given path, the
+ * parsed object is cached for the process lifetime. Repeated calls from different parts
+ * of the codebase (configuration manager, CLI bootstrap, plugin loader) parse the file
+ * exactly once.
+ *
+ * **Optional**: if no file is found, `load()` returns `undefined`. Callers degrade
+ * gracefully — the configuration manager falls back to its other resolution sources, the
+ * CLI falls back to a `CliModule`-only AppModule.
+ */
+let PristineConfigFileLoader = class PristineConfigFileLoader {
+    constructor() {
+        this.configFileNames = [
+            "pristine.config.ts",
+            "pristine.config.js",
+        ];
+        this.cache = new Map();
+        /**
+         * Wraps Node's real dynamic `import()` so it survives both tsc's CJS lowering and
+         * esbuild's bundling. Both otherwise rewrite `await import(x)` into `require(x)`, which
+         * fails for ESM-only packages and `file://` URLs. The Function constructor's body is
+         * opaque to those transforms, so the `import()` inside it goes through unrewritten.
+         */
+        this.dynamicImport = new Function("specifier", "return import(specifier);");
+    }
+    /**
+     * Finds the nearest `pristine.config.{ts,js}` walking up from `startDir` (defaults to
+     * `process.cwd()`), dynamic-imports it, and returns the parsed object. Returns
+     * `undefined` when no file is found anywhere up the directory tree — callers must
+     * treat absence as "no overrides," not as an error.
+     */
+    load() {
+        return __awaiter(this, arguments, void 0, function* (startDir = process.cwd()) {
+            const filePath = this.findConfigFile(startDir);
+            if (filePath === undefined) {
+                return undefined;
+            }
+            const cached = this.cache.get(filePath);
+            if (cached !== undefined) {
+                return cached;
+            }
+            const parsed = yield this.importConfigFile(filePath);
+            this.cache.set(filePath, parsed);
+            return parsed;
+        });
+    }
+    /**
+     * Walks up from `startDir` looking for any of the supported config file names. Stops at
+     * the first match. Walking up matters in monorepos: a tool invoked in `packages/foo/`
+     * should still find a `pristine.config.ts` at the repo root.
+     */
+    findConfigFile(startDir) {
+        let current = path_1.default.resolve(startDir);
+        while (true) {
+            for (const name of this.configFileNames) {
+                const candidate = path_1.default.join(current, name);
+                if (fs_1.default.existsSync(candidate) && fs_1.default.statSync(candidate).isFile()) {
+                    return candidate;
+                }
+            }
+            const parent = path_1.default.dirname(current);
+            // path.dirname of root === root; we've hit the filesystem boundary.
+            if (parent === current)
+                return undefined;
+            current = parent;
+        }
+    }
+    /**
+     * Loads the config file via the appropriate mechanism for its extension: jiti for `.ts`
+     * (in-process TS transform with no build step needed), native dynamic import for `.js`.
+     * Extracts the default export, falling back to a named `pristineConfig` export.
+     */
+    importConfigFile(absolutePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            const ext = path_1.default.extname(absolutePath).toLowerCase();
+            let loaded;
+            if (ext === ".ts") {
+                const jitiModule = yield this.dynamicImport("jiti");
+                const createJiti = (_b = (_a = jitiModule.default) !== null && _a !== void 0 ? _a : jitiModule.createJiti) !== null && _b !== void 0 ? _b : jitiModule;
+                const jiti = createJiti(absolutePath, { interopDefault: true });
+                loaded = jiti(absolutePath);
+            }
+            else {
+                loaded = yield this.dynamicImport(`file://${absolutePath}`);
+            }
+            const parsed = (_d = (_c = loaded === null || loaded === void 0 ? void 0 : loaded.default) !== null && _c !== void 0 ? _c : loaded === null || loaded === void 0 ? void 0 : loaded.pristineConfig) !== null && _d !== void 0 ? _d : loaded;
+            if (!parsed || typeof parsed !== "object") {
+                throw new Error(`[pristine] Config file at '${absolutePath}' did not export a valid configuration. ` +
+                    `Use \`export default defineConfig({ ... })\` or \`export const pristineConfig = { ... }\`.`);
+            }
+            return parsed;
+        });
+    }
+};
+exports.PristineConfigFileLoader = PristineConfigFileLoader;
+exports.PristineConfigFileLoader = PristineConfigFileLoader = __decorate([
+    (0, tsyringe_1.injectable)()
+], PristineConfigFileLoader);
+//# sourceMappingURL=pristine-config-file.loader.js.map

package/dist/lib/cjs/loaders/pristine-config-file.loader.js.map

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

package/dist/lib/cjs/managers/configuration.manager.js

@@ -23,9 +23,11 @@ const tsyringe_1 = require("tsyringe");
 const configuration_definition_already_exists_error_1 = require("../errors/configuration-definition-already-exists.error");
 const configuration_parser_1 = require("../parsers/configuration.parser");
 const configuration_validation_error_1 = require("../errors/configuration-validation.error");
+const pristine_config_file_loader_1 = require("../loaders/pristine-config-file.loader");
 let ConfigurationManager = class ConfigurationManager {
-    constructor(configurationParser) {
+    constructor(configurationParser, pristineConfigFileLoader) {
         this.configurationParser = configurationParser;
+        this.pristineConfigFileLoader = pristineConfigFileLoader;
         this.configurationDefinitions = {};
     }
     /**
@@ -41,28 +43,63 @@ let ConfigurationManager = class ConfigurationManager {
         this.configurationDefinitions[configurationDefinition.parameterName] = configurationDefinition;
     }
     /**
-     * This method loads the configuration values passed dynamically when instantiating the Kernel. This method
-     * will verify that a corresponding configurationDefinition exists and if it does, it will resolve the value.
+     * Loads configuration values into the container using the precedence chain:
      *
-     * This method will also check to make sure that all the expected values are being passed. For example, if a module expects
-     * a configuration value to be passed, this method will throw if none are passed.
+     *   1. `moduleConfigurationValues` — explicit overrides passed to `kernel.start()`.
+     *      Highest precedence; wins all conflicts.
+     *   2. `pristine.config.ts:config` — values from the user-authored config file.
+     *      Beats `configDefaults` and the resolver chain.
+     *   3. `configDefaults` — merged from every module's `ModuleInterface.configDefaults`.
+     *      Beats the resolver chain.
+     *   4. `configurationDefinition.defaultResolvers` — per-key resolver list (env vars,
+     *      secrets manager, etc.). First successful resolver wins.
+     *   5. `configurationDefinition.defaultValue` — hard fallback.
      *
-     * @param moduleConfigurationValues
-     * @param container
+     * Conflicts:
+     *   - **Same key in `moduleConfigurationValues` and the file** → stderr warning naming
+     *     both sources (never the value, which may be a secret); the overrides win.
+     *   - **Unknown key** in any of the explicit sources (overrides / file / configDefaults)
+     *     → validation error; throws at end of `load`.
+     *   - **Two modules' `configDefaults` disagree** — handled by the kernel before this
+     *     method runs (throws at registration). The merged `configDefaults` reaching this
+     *     method is already conflict-free.
+     *
+     * @param moduleConfigurationValues Explicit overrides from `kernel.start()`.
+     * @param container The DI container to register resolved values into.
+     * @param configDefaults Merged `ModuleInterface.configDefaults` from every module in the
+     *   graph. Optional; defaults to empty.
      */
-    load(moduleConfigurationValues, container) {
-        return __awaiter(this, void 0, void 0, function* () {
+    load(moduleConfigurationValues_1, container_1) {
+        return __awaiter(this, arguments, void 0, function* (moduleConfigurationValues, container, configDefaults = {}) {
             const validationErrors = [];
+            const fileConfig = yield this.readFileConfigSafely();
+            // Build the merged "explicit value" map by precedence, lowest to highest, so each
+            // later layer overwrites earlier ones. (1) configDefaults < (2) file < (3) overrides.
+            const mergedValues = {};
+            for (const key of Object.keys(configDefaults)) {
+                mergedValues[key] = configDefaults[key];
+            }
+            for (const key of Object.keys(fileConfig)) {
+                mergedValues[key] = fileConfig[key];
+            }
             for (const key of Object.keys(moduleConfigurationValues)) {
-                if (moduleConfigurationValues.hasOwnProperty(key) === false) {
-                    continue;
+                if (fileConfig.hasOwnProperty(key)) {
+                    // Warn (never log values — could be secrets). The overrides win regardless.
+                    process.stderr.write(`[pristine] WARNING: Configuration key '${key}' is set in BOTH:\n` +
+                        `  - the explicit overrides passed to kernel.start()\n` +
+                        `  - pristine.config.ts:config\n` +
+                        `Using the value from the explicit overrides. Set the key in only one place to silence this warning.\n`);
                 }
+                mergedValues[key] = moduleConfigurationValues[key];
+            }
+            // Process every merged value against the registered definitions. Unknown keys land in
+            // validationErrors so multiple typos surface in a single throw at the end.
+            for (const key of Object.keys(mergedValues)) {
                 if (this.configurationDefinitions.hasOwnProperty(key) === false) {
                     validationErrors.push("There are no ConfigurationDefinition in any of the modules for the following key: '" + key + "'.");
                     continue;
                 }
-                const moduleConfigurationValue = moduleConfigurationValues[key];
-                const resolvedConfigurationValue = yield this.configurationParser.resolve(moduleConfigurationValue, container);
+                const resolvedConfigurationValue = yield this.configurationParser.resolve(mergedValues[key], container);
                 // Register the configuration in the container
                 this.registerConfigurationValue(key, resolvedConfigurationValue, container);
                 // Remove the configurationDefinition for the key
@@ -148,10 +185,41 @@ let ConfigurationManager = class ConfigurationManager {
         // Register the configuration in the container
         container.registerInstance("%" + configurationKey + "%", value);
     }
+    /**
+     * Reads the `config:` block from `pristine.config.{ts,js}` (if present). The file is
+     * optional — its absence is not an error, just produces an empty map. Failures to
+     * parse a present file are also swallowed (and reported via stderr) so misconfigured
+     * config files don't take down the whole boot.
+     */
+    readFileConfigSafely() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const parsed = yield this.pristineConfigFileLoader.load();
+                if (parsed === undefined) {
+                    return {};
+                }
+                const block = parsed.config;
+                if (block === undefined || block === null) {
+                    return {};
+                }
+                if (typeof block !== "object" || Array.isArray(block)) {
+                    process.stderr.write(`[pristine] WARNING: pristine.config.ts:config is not a plain object. Ignoring file-based configuration overrides.\n`);
+                    return {};
+                }
+                return block;
+            }
+            catch (error) {
+                process.stderr.write(`[pristine] WARNING: Failed to load pristine.config.ts for runtime configuration: ${error.message}\n` +
+                    `Continuing without file-based configuration overrides.\n`);
+                return {};
+            }
+        });
+    }
 };
 exports.ConfigurationManager = ConfigurationManager;
 exports.ConfigurationManager = ConfigurationManager = __decorate([
     (0, tsyringe_1.injectable)(),
-    __metadata("design:paramtypes", [configuration_parser_1.ConfigurationParser])
+    __metadata("design:paramtypes", [configuration_parser_1.ConfigurationParser,
+        pristine_config_file_loader_1.PristineConfigFileLoader])
 ], ConfigurationManager);
 //# sourceMappingURL=configuration.manager.js.map

package/dist/lib/cjs/managers/configuration.manager.js.map

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

package/dist/lib/cjs/parsers/configuration.parser.js

@@ -39,7 +39,10 @@ let ConfigurationParser = class ConfigurationParser {
                 //  If the object is DynamicConfigurationResolverInterface
                 if (dynamicConfigurationResolver.dynamicResolve !== undefined && typeof dynamicConfigurationResolver.dynamicResolve === "function") {
                     let instantiatedClass;
-                    // Resolve the instantiated class from the dependency container based on the injection token provided.
+                    // ── container.resolve, justified ──────────────────────────────────────────
+                    // Per CLAUDE.md: framework-internal dynamic resolution. The injection token
+                    // is data carried on the configuration definition — not known when this parser
+                    // was constructed and resolvable only at parse time. Standard factory pattern.
                     if (dynamicConfigurationResolver.injectionToken) {
                         instantiatedClass = container.resolve(dynamicConfigurationResolver.injectionToken);
                     }

package/dist/lib/cjs/parsers/configuration.parser.js.map

@@ -1 +1 @@
-{"version":3,"file":"configuration.parser.js","sourceRoot":"","sources":["../../../../src/parsers/configuration.parser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,6FAAsF;AACtF,uCAAyD;AAKlD,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAE9B;;;;;OAKG;IACG,OAAO,CAAC,wBAAkD,EAAE,SAA8B;;YAC9F,0FAA0F;YAC1F,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;YAErE,gHAAgH;YAChH,IAAI,OAAO,aAAa,KAAK,SAAS,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;gBACjH,OAAO,aAAa,CAAC;YACvB,CAAC;YAED,4IAA4I;YAC5I,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;gBACtC,MAAM,4BAA4B,GAAI,aAA4D,CAAA;gBAElG,0DAA0D;gBAC1D,IAAI,4BAA4B,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,4BAA4B,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;oBACnI,IAAI,iBAAiB,CAAC;oBAEtB,sGAAsG;oBACtG,IAAI,4BAA4B,CAAC,cAAc,EAAE,CAAC;wBAChD,iBAAiB,GAAG,SAAS,CAAC,OAAO,CAAC,4BAA4B,CAAC,cAAc,CAAC,CAAC;oBACrF,CAAC;oBAED,+GAA+G;oBAC/G,OAAO,OAAO,CAAC,OAAO,CAAC,4BAA4B,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBACzF,CAAC;gBACD,sFAAsF;qBACjF,IAAI,OAAQ,aAAwC,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBACjF,OAAO,OAAO,CAAC,OAAO,CAAE,aAAwC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;YAED,MAAM,IAAI,6DAA4B,CAAC,CAAC,kFAAkF,GAAG,OAAO,aAAa,GAAG,GAAG,CAAC,CAAC,CAAA;QAC3J,CAAC;KAAA;CACF,CAAA;AAzCY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,qBAAU,GAAE;GACA,mBAAmB,CAyC/B"}
+{"version":3,"file":"configuration.parser.js","sourceRoot":"","sources":["../../../../src/parsers/configuration.parser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAAA,6FAAsF;AACtF,uCAAyD;AAKlD,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAE9B;;;;;OAKG;IACG,OAAO,CAAC,wBAAkD,EAAE,SAA8B;;YAC9F,0FAA0F;YAC1F,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,wBAAwB,CAAC,CAAA;YAErE,gHAAgH;YAChH,IAAI,OAAO,aAAa,KAAK,SAAS,IAAI,OAAO,aAAa,KAAK,QAAQ,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;gBACjH,OAAO,aAAa,CAAC;YACvB,CAAC;YAED,4IAA4I;YAC5I,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;gBACtC,MAAM,4BAA4B,GAAI,aAA4D,CAAA;gBAElG,0DAA0D;gBAC1D,IAAI,4BAA4B,CAAC,cAAc,KAAK,SAAS,IAAI,OAAO,4BAA4B,CAAC,cAAc,KAAK,UAAU,EAAE,CAAC;oBACnI,IAAI,iBAAiB,CAAC;oBAEtB,6EAA6E;oBAC7E,4EAA4E;oBAC5E,+EAA+E;oBAC/E,+EAA+E;oBAC/E,IAAI,4BAA4B,CAAC,cAAc,EAAE,CAAC;wBAChD,iBAAiB,GAAG,SAAS,CAAC,OAAO,CAAC,4BAA4B,CAAC,cAAc,CAAC,CAAC;oBACrF,CAAC;oBAED,+GAA+G;oBAC/G,OAAO,OAAO,CAAC,OAAO,CAAC,4BAA4B,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBACzF,CAAC;gBACD,sFAAsF;qBACjF,IAAI,OAAQ,aAAwC,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;oBACjF,OAAO,OAAO,CAAC,OAAO,CAAE,aAAwC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC9E,CAAC;YACH,CAAC;YAED,MAAM,IAAI,6DAA4B,CAAC,CAAC,kFAAkF,GAAG,OAAO,aAAa,GAAG,GAAG,CAAC,CAAC,CAAA;QAC3J,CAAC;KAAA;CACF,CAAA;AA5CY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,qBAAU,GAAE;GACA,mBAAmB,CA4C/B"}