mcp-server-framework 1.0.0

package/build/config/extensions.js

@@ -0,0 +1,152 @@
+/**
+ * Config Extensions
+ *
+ * Allows consumer projects to register custom config sections that
+ * are recognized during config file loading and validated with
+ * consumer-provided Zod schemas.
+ *
+ * This enables consumer-specific config file sections (e.g., `[myapp]`)
+ * without the framework warning about "unknown sections".
+ *
+ * @example
+ * ```typescript
+ * import { registerConfigSection, getAppConfig, z } from 'mcp-server-framework';
+ *
+ * // Register a custom section with a Zod schema
+ * registerConfigSection('myapp', z.object({
+ *   url: z.string().url(),
+ *   timeout_ms: z.number().int().positive().optional(),
+ * }));
+ *
+ * // After config is loaded, retrieve the validated section data
+ * const appConfig = getAppConfig<{ url: string; timeout_ms?: number }>('myapp');
+ * ```
+ *
+ * @module config/extensions
+ */
+import { ConfigurationError } from "../errors/categories/validation.js";
+import { isConfigInitialized } from "./config-cache.js";
+import { CONFIG_FILE_SECTIONS } from "./file/index.js";
+// ============================================================================
+// Registry
+// ============================================================================
+/** Registered consumer config sections */
+const registeredSections = new Map();
+/** Reserved section names derived from the framework config file schema */
+const RESERVED_SECTIONS = new Set(Object.keys(CONFIG_FILE_SECTIONS));
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Register a custom config section for consumer use.
+ *
+ * Must be called **before** config initialization (i.e., before the
+ * first call to `getFrameworkConfig()`). Registered sections:
+ *
+ * 1. Are recognized in config files (no "unknown section" warning)
+ * 2. Are validated against the provided Zod schema
+ * 3. Can be retrieved via `getAppConfig(name)`
+ *
+ * @param name - Section name as it appears in the config file (e.g., 'myapp')
+ * @param schema - Zod schema to validate the section data
+ * @throws {ConfigurationError} If the section name is reserved, already registered,
+ *   or config has already been initialized
+ *
+ * @example
+ * ```typescript
+ * registerConfigSection('myapp', z.object({
+ *   url: z.string().url(),
+ *   api_key: z.string().optional(),
+ * }));
+ * ```
+ */
+export function registerConfigSection(name, schema) {
+    const sectionName = name.toLowerCase();
+    // Guard: Must be called before config initialization
+    if (isConfigInitialized()) {
+        throw ConfigurationError.invalid(`Cannot register config section '${sectionName}': config has already been initialized. ` +
+            "Call registerConfigSection() before the first getFrameworkConfig() call.");
+    }
+    if (RESERVED_SECTIONS.has(sectionName)) {
+        throw ConfigurationError.invalid(`Cannot register config section '${sectionName}': reserved by the framework`);
+    }
+    if (registeredSections.has(sectionName)) {
+        throw ConfigurationError.invalid(`Config section '${sectionName}' is already registered`);
+    }
+    registeredSections.set(sectionName, { schema, data: undefined });
+}
+/**
+ * Retrieve the validated data for a registered config section.
+ *
+ * Returns `undefined` if:
+ * - The section was not present in the config file
+ * - Config has not been loaded yet
+ *
+ * @param name - Section name (case-insensitive)
+ * @returns The validated section data, or `undefined`
+ *
+ * @example
+ * ```typescript
+ * interface MyAppConfig {
+ *   url: string;
+ *   timeout_ms?: number;
+ * }
+ * const config = getAppConfig<MyAppConfig>('myapp');
+ * if (config) {
+ *   console.log(config.url);
+ * }
+ * ```
+ */
+// eslint-disable-next-line @typescript-eslint/no-unnecessary-type-parameters -- Intentional: T enables consumer-side type inference
+export function getAppConfig(name) {
+    const section = registeredSections.get(name.toLowerCase());
+    // @type-narrowing — section.data is `unknown`; caller provides generic T for domain-specific typing
+    return section?.data;
+}
+// ============================================================================
+// Internal API (used by loader)
+// ============================================================================
+/**
+ * Get all registered consumer section names.
+ *
+ * Used by the config file loader to recognize consumer sections
+ * and suppress "unknown section" warnings.
+ *
+ * @internal
+ */
+export function getRegisteredSectionNames() {
+    return new Set(registeredSections.keys());
+}
+/**
+ * Get the Zod schema for a registered section.
+ *
+ * @internal
+ */
+export function getRegisteredSectionSchema(name) {
+    return registeredSections.get(name.toLowerCase())?.schema;
+}
+/**
+ * Store validated data for a registered section.
+ *
+ * Called by the config file loader after parsing and validating
+ * a consumer section from the config file.
+ *
+ * @internal
+ */
+export function setRegisteredSectionData(name, data) {
+    const section = registeredSections.get(name.toLowerCase());
+    if (section) {
+        section.data = data;
+    }
+}
+/**
+ * Reset all registered config sections.
+ *
+ * Intended for testing — clears all registrations and data.
+ *
+ * @internal
+ */
+export function resetConfigExtensions() {
+    registeredSections.clear();
+}
+//# sourceMappingURL=extensions.js.map

package/build/config/extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/config/extensions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAkBvD,+EAA+E;AAC/E,WAAW;AACX,+EAA+E;AAE/E,0CAA0C;AAC1C,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA6B,CAAC;AAEhE,2EAA2E;AAC3E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAErE,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY,EAAE,MAAkB;IACpE,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEvC,qDAAqD;IACrD,IAAI,mBAAmB,EAAE,EAAE,CAAC;QAC1B,MAAM,kBAAkB,CAAC,OAAO,CAC9B,mCAAmC,WAAW,0CAA0C;YACtF,0EAA0E,CAC7E,CAAC;IACJ,CAAC;IAED,IAAI,iBAAiB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACvC,MAAM,kBAAkB,CAAC,OAAO,CAAC,mCAAmC,WAAW,8BAA8B,CAAC,CAAC;IACjH,CAAC;IAED,IAAI,kBAAkB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;QACxC,MAAM,kBAAkB,CAAC,OAAO,CAAC,mBAAmB,WAAW,yBAAyB,CAAC,CAAC;IAC5F,CAAC;IAED,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,oIAAoI;AACpI,MAAM,UAAU,YAAY,CAAc,IAAY;IACpD,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3D,oGAAoG;IACpG,OAAO,OAAO,EAAE,IAAqB,CAAC;AACxC,CAAC;AAED,+EAA+E;AAC/E,gCAAgC;AAChC,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,IAAI,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,OAAO,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,EAAE,MAAM,CAAC;AAC5D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,IAAa;IAClE,MAAM,OAAO,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAC3D,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC;IACtB,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,kBAAkB,CAAC,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/build/config/file/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Config File Module Barrel Export
+ *
+ * @module config/file
+ */
+export { loadConfigFile } from "./loader.js";
+export { configFileSchema, CONFIG_FILE_SECTIONS, mapConfigToEnvKeys, CONFIG_FILE_ENV_VAR, DISCOVERY_FILENAMES, type ConfigFileData, type ConfigFileFormat, type ConfigFileResult, type ConfigSource, } from "./schema.js";
+//# sourceMappingURL=index.d.ts.map

package/build/config/file/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/file/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,YAAY,GAClB,MAAM,aAAa,CAAC"}

package/build/config/file/index.js

@@ -0,0 +1,10 @@
+/**
+ * Config File Module Barrel Export
+ *
+ * @module config/file
+ */
+// Loader (main entry point)
+export { loadConfigFile } from "./loader.js";
+// Schema, types & constants
+export { configFileSchema, CONFIG_FILE_SECTIONS, mapConfigToEnvKeys, CONFIG_FILE_ENV_VAR, DISCOVERY_FILENAMES, } from "./schema.js";
+//# sourceMappingURL=index.js.map

package/build/config/file/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/file/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,4BAA4B;AAC5B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,4BAA4B;AAC5B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,GAKpB,MAAM,aAAa,CAAC"}

package/build/config/file/loader.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Config File Loader
+ *
+ * Orchestrates the config file loading pipeline:
+ * 1. Discover config file (explicit path or auto-discovery)
+ * 2. Parse raw content (TOML, YAML, or JSON)
+ * 3. Validate against schema (lenient — unknown keys are stripped)
+ * 4. Warn about unknown keys (typo detection without crashing)
+ * 5. Map nested structure to flat `FrameworkEnvConfig` overrides
+ *
+ * Returns `undefined` when no config file is found — this is the
+ * normal case for servers that rely solely on environment variables.
+ *
+ * @module config/file/loader
+ */
+import type { ConfigFileResult } from "./schema.js";
+/**
+ * Load and validate a config file.
+ *
+ * This is the single entry point for the config file subsystem.
+ * The result contains `Partial<FrameworkEnvConfig>` overrides that
+ * can be applied via `applyConfigOverrides()`.
+ *
+ * Unknown keys are stripped during validation and logged as warnings
+ * so typos are visible without preventing the server from starting.
+ *
+ * @returns Config file result with overrides and metadata, or `undefined` if no file found
+ * @throws {ConfigurationError} On discovery, parse, or validation errors
+ */
+export declare function loadConfigFile(): ConfigFileResult | undefined;
+//# sourceMappingURL=loader.d.ts.map

package/build/config/file/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/config/file/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH,OAAO,KAAK,EAAoB,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAMtE;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,GAAG,SAAS,CA0B7D"}

package/build/config/file/loader.js

@@ -0,0 +1,313 @@
+/**
+ * Config File Loader
+ *
+ * Orchestrates the config file loading pipeline:
+ * 1. Discover config file (explicit path or auto-discovery)
+ * 2. Parse raw content (TOML, YAML, or JSON)
+ * 3. Validate against schema (lenient — unknown keys are stripped)
+ * 4. Warn about unknown keys (typo detection without crashing)
+ * 5. Map nested structure to flat `FrameworkEnvConfig` overrides
+ *
+ * Returns `undefined` when no config file is found — this is the
+ * normal case for servers that rely solely on environment variables.
+ *
+ * @module config/file/loader
+ */
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { resolve, extname } from "node:path";
+import { parse as tomlParse } from "smol-toml";
+import { parse as yamlParse } from "yaml";
+import { z } from "zod";
+import { ConfigurationError } from "../../errors/categories/validation.js";
+import { addStartupWarning } from "../startup-warnings.js";
+import { getRegisteredSectionNames, getRegisteredSectionSchema, setRegisteredSectionData } from "../extensions.js";
+import { configFileSchema, CONFIG_FILE_SECTIONS, mapConfigToOverrides, CONFIG_FILE_ENV_VAR, DISCOVERY_FILENAMES, EXTENSION_FORMAT_MAP, } from "./schema.js";
+// ============================================================================
+// Loader (Public API)
+// ============================================================================
+/**
+ * Load and validate a config file.
+ *
+ * This is the single entry point for the config file subsystem.
+ * The result contains `Partial<FrameworkEnvConfig>` overrides that
+ * can be applied via `applyConfigOverrides()`.
+ *
+ * Unknown keys are stripped during validation and logged as warnings
+ * so typos are visible without preventing the server from starting.
+ *
+ * @returns Config file result with overrides and metadata, or `undefined` if no file found
+ * @throws {ConfigurationError} On discovery, parse, or validation errors
+ */
+export function loadConfigFile() {
+    // Step 1: Discover
+    const filePath = discoverConfigFile();
+    if (!filePath) {
+        return undefined;
+    }
+    // Step 2: Parse
+    const { data, format } = parseConfigFile(filePath);
+    // Step 3: Warn about unknown keys (before schema strips them)
+    warnUnknownKeys(data, filePath);
+    // Step 4: Validate framework sections (unknown keys are silently stripped by Zod defaults)
+    const parseResult = configFileSchema.safeParse(data);
+    if (!parseResult.success) {
+        throw ConfigurationError.fileValidationFailed(filePath, parseResult.error);
+    }
+    // Step 5: Validate and store registered consumer sections
+    processConsumerSections(data, filePath);
+    // Step 6: Map to overrides
+    const overrides = mapConfigToOverrides(parseResult.data);
+    return { overrides, sourcePath: filePath, format };
+}
+// ============================================================================
+// Discovery
+// ============================================================================
+/**
+ * Discover the config file path.
+ *
+ * Resolution order:
+ * 1. `MCP_CONFIG_FILE` env var — explicit path (must exist, must be supported format)
+ * 2. Auto-discovery in `process.cwd()` — first match from {@link DISCOVERY_FILENAMES}
+ *
+ * @returns Absolute path to the config file, or `undefined` if none found
+ * @throws {ConfigurationError} If explicit path doesn't exist or has unsupported extension
+ */
+function discoverConfigFile() {
+    const explicitPath = process.env[CONFIG_FILE_ENV_VAR];
+    if (explicitPath) {
+        return resolveExplicitPath(explicitPath);
+    }
+    return autoDiscover();
+}
+/**
+ * Resolve an explicitly specified config file path.
+ *
+ * An explicit path MUST exist and MUST have a supported extension.
+ * This is strict by design — if the user explicitly points to a file,
+ * a missing file or wrong extension is always an error.
+ */
+function resolveExplicitPath(rawPath) {
+    const absolutePath = resolve(rawPath);
+    const ext = extname(absolutePath).toLowerCase();
+    if (!EXTENSION_FORMAT_MAP[ext]) {
+        throw ConfigurationError.unsupportedFormat(ext);
+    }
+    if (!existsSync(absolutePath)) {
+        throw ConfigurationError.fileNotFound(absolutePath);
+    }
+    try {
+        const stat = statSync(absolutePath);
+        if (!stat.isFile()) {
+            throw ConfigurationError.fileNotFound(absolutePath);
+        }
+    }
+    catch (error) {
+        if (error instanceof ConfigurationError)
+            throw error;
+        throw ConfigurationError.fileNotFound(absolutePath);
+    }
+    return absolutePath;
+}
+/**
+ * Auto-discover a config file in the current working directory.
+ *
+ * Iterates {@link DISCOVERY_FILENAMES} in priority order.
+ * Returns `undefined` if no config file is found — this is the normal
+ * case for servers that rely solely on environment variables.
+ */
+function autoDiscover() {
+    const cwd = process.cwd();
+    for (const filename of DISCOVERY_FILENAMES) {
+        const candidate = resolve(cwd, filename);
+        if (existsSync(candidate)) {
+            try {
+                const stat = statSync(candidate);
+                if (stat.isFile()) {
+                    return candidate;
+                }
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return undefined;
+}
+// ============================================================================
+// Parser
+// ============================================================================
+/**
+ * Parse a config file into a raw object.
+ *
+ * Delegates to the appropriate parser based on file extension.
+ * Returns a plain object — validation/mapping happens in the schema layer.
+ *
+ * @param filePath - Absolute path to the config file
+ * @returns Parsed raw object and detected format
+ * @throws {ConfigurationError} On read errors, unsupported format, or parse failures
+ */
+function parseConfigFile(filePath) {
+    const ext = extname(filePath).toLowerCase();
+    const format = EXTENSION_FORMAT_MAP[ext];
+    if (!format) {
+        throw ConfigurationError.unsupportedFormat(ext);
+    }
+    const content = readFileSafe(filePath);
+    const data = parseContent(content, format, filePath);
+    return { data, format };
+}
+/** Read file content with error wrapping */
+function readFileSafe(filePath) {
+    try {
+        return readFileSync(filePath, "utf-8");
+    }
+    catch (cause) {
+        throw ConfigurationError.fileReadFailed(filePath, cause instanceof Error ? cause : undefined);
+    }
+}
+/** Parse content based on format */
+function parseContent(content, format, filePath) {
+    try {
+        switch (format) {
+            case "toml":
+                return tomlParse(content);
+            case "yaml":
+                return parseYamlSafe(content);
+            case "json":
+                return parseJsonSafe(content);
+        }
+    }
+    catch (cause) {
+        if (cause instanceof ConfigurationError)
+            throw cause;
+        throw ConfigurationError.fileParseFailed(filePath, cause instanceof Error ? cause : undefined);
+    }
+}
+/**
+ * Parse YAML content with type guard.
+ *
+ * YAML can parse to scalars, arrays, or null — we require a mapping (object).
+ */
+function parseYamlSafe(content) {
+    const result = yamlParse(content);
+    if (result === null || result === undefined || typeof result !== "object" || Array.isArray(result)) {
+        throw ConfigurationError.fileParseFailed("config", new Error("Config file must contain a mapping (object), not a scalar or array"));
+    }
+    // @type-narrowing — runtime check above validates object type, but TS keeps `unknown`
+    return result;
+}
+/**
+ * Parse JSON content with type guard.
+ *
+ * `JSON.parse()` can return any JSON value — we require a plain object.
+ */
+function parseJsonSafe(content) {
+    const result = JSON.parse(content);
+    if (result === null || result === undefined || typeof result !== "object" || Array.isArray(result)) {
+        throw ConfigurationError.fileParseFailed("config", new Error("Config file must contain a JSON object, not a scalar or array"));
+    }
+    // @type-narrowing — runtime check above validates object type, but TS keeps `unknown`
+    return result;
+}
+// ============================================================================
+// Unknown Key Detection
+// ============================================================================
+/**
+ * Known section names derived from the config file schema.
+ *
+ * This ensures sync with `configFileSchema` — no manual duplication needed.
+ */
+const KNOWN_SECTIONS = Object.freeze(new Set(Object.keys(CONFIG_FILE_SECTIONS)));
+/**
+ * Known keys per section derived from the section Zod schemas.
+ *
+ * Introspects each section's `ZodObject.shape` to extract valid key names.
+ * Falls back to an empty set for non-object schemas (defensive).
+ */
+const KNOWN_KEYS = Object.freeze(Object.fromEntries(Object.entries(CONFIG_FILE_SECTIONS).map(([name, schema]) => {
+    const shape = extractShapeKeys(schema);
+    return [name, shape];
+})));
+/**
+ * Extract key names from a Zod schema, handling `.partial()` wrappers.
+ */
+function extractShapeKeys(schema) {
+    if ("shape" in schema && typeof schema.shape === "object" && schema.shape !== null) {
+        // @type-narrowing — runtime check validates shape is a non-null object; Zod exposes shape as untyped
+        return new Set(Object.keys(schema.shape));
+    }
+    return new Set();
+}
+/**
+ * Detect and warn about unknown keys in the raw config file data.
+ *
+ * Compares the raw parsed data against known schema keys and registered
+ * consumer sections, logging warnings for any unrecognized keys.
+ * This catches typos without preventing the server from starting.
+ *
+ * @param data - Raw parsed config file data
+ * @param filePath - Path to the config file (for log context)
+ */
+function warnUnknownKeys(data, filePath) {
+    if (!data || typeof data !== "object")
+        return;
+    // @type-narrowing — runtime guard above ensures data is a non-null object
+    const root = data;
+    const consumerSections = getRegisteredSectionNames();
+    for (const key of Object.keys(root)) {
+        if (KNOWN_SECTIONS.has(key)) {
+            const section = root[key];
+            if (!section || typeof section !== "object")
+                continue;
+            const knownKeys = KNOWN_KEYS[key];
+            if (!knownKeys || knownKeys.size === 0)
+                continue;
+            // @type-narrowing — section type-checked to be a non-null object above
+            for (const sectionKey of Object.keys(section)) {
+                if (!knownKeys.has(sectionKey)) {
+                    addStartupWarning(`[config] Unknown key '${sectionKey}' in [${key}] section of ${filePath} — ignored`);
+                }
+            }
+            continue;
+        }
+        if (consumerSections.has(key)) {
+            continue;
+        }
+        addStartupWarning(`[config] Unknown section '${key}' in ${filePath} — ignored`);
+    }
+}
+// ============================================================================
+// Consumer Section Processing
+// ============================================================================
+/**
+ * Process registered consumer sections from the raw config file data.
+ *
+ * For each registered section found in the config file:
+ * 1. Validate against the registered Zod schema
+ * 2. Store the validated data for retrieval via `getAppConfig()`
+ *
+ * @param data - Raw parsed config file data
+ * @param filePath - Path to the config file (for error context)
+ * @throws {ConfigurationError} If a consumer section fails validation
+ */
+function processConsumerSections(data, filePath) {
+    if (!data || typeof data !== "object")
+        return;
+    // @type-narrowing — runtime guard above ensures data is a non-null object
+    const root = data;
+    const consumerSections = getRegisteredSectionNames();
+    for (const sectionName of consumerSections) {
+        const sectionData = root[sectionName];
+        if (sectionData === undefined)
+            continue;
+        const schema = getRegisteredSectionSchema(sectionName);
+        if (!schema)
+            continue;
+        const parseResult = schema.safeParse(sectionData);
+        if (!parseResult.success) {
+            throw ConfigurationError.fileValidationFailed(filePath, parseResult.error);
+        }
+        setRegisteredSectionData(sectionName, parseResult.data);
+    }
+}
+//# sourceMappingURL=loader.js.map

package/build/config/file/loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.js","sourceRoot":"","sources":["../../../src/config/file/loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACnH,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc;IAC5B,mBAAmB;IACnB,MAAM,QAAQ,GAAG,kBAAkB,EAAE,CAAC;IACtC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,gBAAgB;IAChB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEnD,8DAA8D;IAC9D,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEhC,2FAA2F;IAC3F,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,kBAAkB,CAAC,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;IAC7E,CAAC;IAED,0DAA0D;IAC1D,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAExC,2BAA2B;IAC3B,MAAM,SAAS,GAAG,oBAAoB,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAEzD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AACrD,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,SAAS,kBAAkB;IACzB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAEtD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAAC,OAAe;IAC1C,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAEhD,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,kBAAkB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACnB,MAAM,kBAAkB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB;YAAE,MAAM,KAAK,CAAC;QACrD,MAAM,kBAAkB,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;;;;GAMG;AACH,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAE1B,KAAK,MAAM,QAAQ,IAAI,mBAAmB,EAAE,CAAC;QAC3C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAEzC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;gBACjC,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;oBAClB,OAAO,SAAS,CAAC;gBACnB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,SAAS,eAAe,CAAC,QAAgB;IAIvC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,kBAAkB,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;IAErD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,4CAA4C;AAC5C,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,kBAAkB,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAChG,CAAC;AACH,CAAC;AAED,oCAAoC;AACpC,SAAS,YAAY,CAAC,OAAe,EAAE,MAAwB,EAAE,QAAgB;IAC/E,IAAI,CAAC;QACH,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;YAC5B,KAAK,MAAM;gBACT,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;YAChC,KAAK,MAAM;gBACT,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,kBAAkB;YAAE,MAAM,KAAK,CAAC;QACrD,MAAM,kBAAkB,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjG,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,MAAM,GAAY,SAAS,CAAC,OAAO,CAAC,CAAC;IAE3C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnG,MAAM,kBAAkB,CAAC,eAAe,CACtC,QAAQ,EACR,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAChF,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CAAC,OAAe;IACpC,MAAM,MAAM,GAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACnG,MAAM,kBAAkB,CAAC,eAAe,CACtC,QAAQ,EACR,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAC3E,CAAC;IACJ,CAAC;IAED,sFAAsF;IACtF,OAAO,MAAiC,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,cAAc,GAAwB,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAEtG;;;;;GAKG;AACH,MAAM,UAAU,GAAkD,MAAM,CAAC,MAAM,CAC7E,MAAM,CAAC,WAAW,CAChB,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,EAAE;IAC1D,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACvB,CAAC,CAAC,CACH,CACF,CAAC;AAEF;;GAEG;AACH,SAAS,gBAAgB,CAAC,MAAoB;IAC5C,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QACnF,qGAAqG;QACrG,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAgC,CAAC,CAAC,CAAC;IACvE,CAAC;IACD,OAAO,IAAI,GAAG,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,eAAe,CAAC,IAAa,EAAE,QAAgB;IACtD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO;IAE9C,0EAA0E;IAC1E,MAAM,IAAI,GAAG,IAA+B,CAAC;IAC7C,MAAM,gBAAgB,GAAG,yBAAyB,EAAE,CAAC;IAErD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,IAAI,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;gBAAE,SAAS;YAEtD,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,CAAC,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,CAAC;gBAAE,SAAS;YAEjD,uEAAuE;YACvE,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,OAAkC,CAAC,EAAE,CAAC;gBACzE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC/B,iBAAiB,CAAC,yBAAyB,UAAU,SAAS,GAAG,gBAAgB,QAAQ,YAAY,CAAC,CAAC;gBACzG,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,IAAI,gBAAgB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,iBAAiB,CAAC,6BAA6B,GAAG,QAAQ,QAAQ,YAAY,CAAC,CAAC;IAClF,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,8BAA8B;AAC9B,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,SAAS,uBAAuB,CAAC,IAAa,EAAE,QAAgB;IAC9D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO;IAE9C,0EAA0E;IAC1E,MAAM,IAAI,GAAG,IAA+B,CAAC;IAC7C,MAAM,gBAAgB,GAAG,yBAAyB,EAAE,CAAC;IAErD,KAAK,MAAM,WAAW,IAAI,gBAAgB,EAAE,CAAC;QAC3C,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACtC,IAAI,WAAW,KAAK,SAAS;YAAE,SAAS;QAExC,MAAM,MAAM,GAAG,0BAA0B,CAAC,WAAW,CAAC,CAAC;QACvD,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,kBAAkB,CAAC,oBAAoB,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC;QAC7E,CAAC;QAED,wBAAwB,CAAC,WAAW,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;IAC1D,CAAC;AACH,CAAC"}