mcp-server-framework 1.0.0

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

@@ -0,0 +1,583 @@
+/**
+ * Config File Schema, Types & Mapper
+ *
+ * This module is the single source of truth for:
+ * - Config file types and constants (formats, discovery filenames, result types)
+ * - Zod schemas for config file sections
+ * - Mapping between nested config file structure and flat `FrameworkEnvConfig`
+ *
+ * The schema is **lenient** regarding unknown keys: unrecognized
+ * fields are silently stripped during validation. The loader
+ * detects stripped keys and emits warnings so typos are visible
+ * without crashing the server.
+ *
+ * All fields are optional — you only configure what you need.
+ *
+ * Intentionally excluded from config file support:
+ * - `MCP_CONFIG_FILE` — meta-config (chicken-egg problem)
+ * - `NODE_ENV` — runtime concern, not file-config
+ * - `VERSION` — build/deployment concern
+ *
+ * @module config/file/schema
+ */
+import { z } from "zod";
+import type { FrameworkEnvConfig } from "../env.js";
+/** Supported config file formats */
+export type ConfigFileFormat = "toml" | "yaml" | "json";
+/**
+ * Config file names for auto-discovery (ordered by priority).
+ *
+ * The first file found in `process.cwd()` wins.
+ * TOML is preferred over YAML since it's more explicit for server configuration.
+ * JSON has lowest priority since it doesn't support comments.
+ */
+export declare const DISCOVERY_FILENAMES: readonly ["config.toml", "config.yaml", "config.yml", "config.json"];
+/**
+ * Environment variable to explicitly specify a config file path.
+ *
+ * When set, auto-discovery is skipped and this path is used directly.
+ * The file must exist — an explicit path that doesn't resolve is an error.
+ *
+ * This is a meta-config variable and intentionally NOT part of `FrameworkEnvConfig`.
+ */
+export declare const CONFIG_FILE_ENV_VAR: "MCP_CONFIG_FILE";
+/**
+ * Maps file extensions to their format.
+ *
+ * Frozen at runtime to prevent
+ * accidental mutation of framework constants.
+ */
+export declare const EXTENSION_FORMAT_MAP: Readonly<Record<string, ConfigFileFormat>>;
+/**
+ * Result of loading and parsing a config file.
+ *
+ * Contains the overrides to apply to `FrameworkEnvConfig` and metadata
+ * about the source file (for logging after logger initialization).
+ */
+export interface ConfigFileResult {
+    /** Partial overrides to merge into the framework config */
+    readonly overrides: Partial<FrameworkEnvConfig>;
+    /** Absolute path to the config file that was loaded */
+    readonly sourcePath: string;
+    /** Format of the loaded file */
+    readonly format: ConfigFileFormat;
+}
+/**
+ * Metadata about which config source is active.
+ *
+ * Stored alongside the cached config so the server can log
+ * which source was used after the logger is initialized.
+ */
+export interface ConfigSource {
+    /** How the config was loaded */
+    readonly type: "env" | "file";
+    /** Absolute path to the config file (only when type is 'file') */
+    readonly path?: string;
+    /** Format of the config file (only when type is 'file') */
+    readonly format?: ConfigFileFormat;
+    /** Whether a `.env` file was found and loaded */
+    readonly dotenvLoaded: boolean;
+}
+/**
+ * Map of section names to their Zod schemas.
+ *
+ * Used by the loader to derive known section names and keys
+ * instead of maintaining a manual duplicate list.
+ *
+ * Also the single source of truth for `configFileSchema` — the root
+ * schema is derived from this map via `z.object(…).partial()`.
+ *
+ * @internal
+ */
+export declare const CONFIG_FILE_SECTIONS: Readonly<{
+    transport: z.ZodObject<{
+        mode: z.ZodOptional<z.ZodEnum<["stdio", "http", "https"]>>;
+        port: z.ZodOptional<z.ZodNumber>;
+        host: z.ZodOptional<z.ZodString>;
+        sse_enabled: z.ZodOptional<z.ZodBoolean>;
+        stateless: z.ZodOptional<z.ZodBoolean>;
+        json_response: z.ZodOptional<z.ZodBoolean>;
+        tls: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            cert_path: z.ZodOptional<z.ZodString>;
+            key_path: z.ZodOptional<z.ZodString>;
+            ca_path: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        }, {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        mode?: "http" | "stdio" | "https" | undefined;
+        host?: string | undefined;
+        port?: number | undefined;
+        sse_enabled?: boolean | undefined;
+        stateless?: boolean | undefined;
+        json_response?: boolean | undefined;
+        tls?: {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        } | undefined;
+    }, {
+        mode?: "http" | "stdio" | "https" | undefined;
+        host?: string | undefined;
+        port?: number | undefined;
+        sse_enabled?: boolean | undefined;
+        stateless?: boolean | undefined;
+        json_response?: boolean | undefined;
+        tls?: {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        } | undefined;
+    }>;
+    security: z.ZodObject<{
+        allowed_hosts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        rate_limit_max: z.ZodOptional<z.ZodNumber>;
+        rate_limit_window_ms: z.ZodOptional<z.ZodNumber>;
+        trust_proxy: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        cors_origin: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        cors_credentials: z.ZodOptional<z.ZodBoolean>;
+        helmet_hsts: z.ZodOptional<z.ZodBoolean>;
+        helmet_csp: z.ZodOptional<z.ZodString>;
+        helmet_frame_options: z.ZodOptional<z.ZodEnum<["DENY", "SAMEORIGIN", "false"]>>;
+        body_size_limit: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        allowed_hosts?: string[] | undefined;
+        rate_limit_max?: number | undefined;
+        rate_limit_window_ms?: number | undefined;
+        trust_proxy?: string | number | undefined;
+        cors_origin?: string[] | undefined;
+        cors_credentials?: boolean | undefined;
+        helmet_hsts?: boolean | undefined;
+        helmet_csp?: string | undefined;
+        helmet_frame_options?: "DENY" | "SAMEORIGIN" | "false" | undefined;
+        body_size_limit?: string | undefined;
+    }, {
+        allowed_hosts?: string[] | undefined;
+        rate_limit_max?: number | undefined;
+        rate_limit_window_ms?: number | undefined;
+        trust_proxy?: string | number | undefined;
+        cors_origin?: string[] | undefined;
+        cors_credentials?: boolean | undefined;
+        helmet_hsts?: boolean | undefined;
+        helmet_csp?: string | undefined;
+        helmet_frame_options?: "DENY" | "SAMEORIGIN" | "false" | undefined;
+        body_size_limit?: string | undefined;
+    }>;
+    session: z.ZodObject<{
+        max_sessions: z.ZodOptional<z.ZodNumber>;
+        max_streamable_http_sessions: z.ZodOptional<z.ZodNumber>;
+        max_sse_sessions: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_sessions?: number | undefined;
+        max_streamable_http_sessions?: number | undefined;
+        max_sse_sessions?: number | undefined;
+    }, {
+        max_sessions?: number | undefined;
+        max_streamable_http_sessions?: number | undefined;
+        max_sse_sessions?: number | undefined;
+    }>;
+    logging: z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<["trace", "debug", "info", "warn", "error"]>>;
+        format: z.ZodOptional<z.ZodEnum<["text", "json"]>>;
+        timestamp: z.ZodOptional<z.ZodBoolean>;
+        component: z.ZodOptional<z.ZodBoolean>;
+        dir: z.ZodOptional<z.ZodString>;
+        max_file_size: z.ZodOptional<z.ZodString>;
+        max_files: z.ZodOptional<z.ZodNumber>;
+        retention_days: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        component?: boolean | undefined;
+        level?: "error" | "trace" | "debug" | "info" | "warn" | undefined;
+        format?: "text" | "json" | undefined;
+        timestamp?: boolean | undefined;
+        dir?: string | undefined;
+        max_file_size?: string | undefined;
+        max_files?: number | undefined;
+        retention_days?: number | undefined;
+    }, {
+        component?: boolean | undefined;
+        level?: "error" | "trace" | "debug" | "info" | "warn" | undefined;
+        format?: "text" | "json" | undefined;
+        timestamp?: boolean | undefined;
+        dir?: string | undefined;
+        max_file_size?: string | undefined;
+        max_files?: number | undefined;
+        retention_days?: number | undefined;
+    }>;
+    telemetry: z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        service_name: z.ZodOptional<z.ZodString>;
+        exporter_endpoint: z.ZodOptional<z.ZodString>;
+        traces_exporter: z.ZodOptional<z.ZodString>;
+        logs_exporter: z.ZodOptional<z.ZodString>;
+        log_level: z.ZodOptional<z.ZodString>;
+        metric_export_interval: z.ZodOptional<z.ZodNumber>;
+        metrics_exporter: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        enabled?: boolean | undefined;
+        service_name?: string | undefined;
+        exporter_endpoint?: string | undefined;
+        traces_exporter?: string | undefined;
+        logs_exporter?: string | undefined;
+        log_level?: string | undefined;
+        metric_export_interval?: number | undefined;
+        metrics_exporter?: string | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        service_name?: string | undefined;
+        exporter_endpoint?: string | undefined;
+        traces_exporter?: string | undefined;
+        logs_exporter?: string | undefined;
+        log_level?: string | undefined;
+        metric_export_interval?: number | undefined;
+        metrics_exporter?: string | undefined;
+    }>;
+    auth: z.ZodObject<{
+        required_scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        resource_metadata_url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        required_scopes?: string[] | undefined;
+        resource_metadata_url?: string | undefined;
+    }, {
+        required_scopes?: string[] | undefined;
+        resource_metadata_url?: string | undefined;
+    }>;
+}>;
+/**
+ * Config file root schema.
+ *
+ * Nested, section-based structure that maps to `FrameworkEnvConfig`.
+ * `.strict()` is intentionally NOT used — unknown keys are stripped
+ * during parsing and surfaced as warnings by the loader, so typos
+ * are visible but don't prevent the server from starting.
+ *
+ * Derived from `CONFIG_FILE_SECTIONS` to avoid duplicate
+ * section listings (DRY).
+ *
+ * @example TOML
+ * ```toml
+ * [transport]
+ * mode = "http"
+ * port = 3000
+ *
+ * [logging]
+ * level = "debug"
+ * format = "json"
+ * ```
+ *
+ * @example YAML
+ * ```yaml
+ * transport:
+ *   mode: http
+ *   port: 3000
+ * logging:
+ *   level: debug
+ * ```
+ */
+export declare const configFileSchema: z.ZodObject<{
+    readonly transport: z.ZodOptional<z.ZodObject<{
+        mode: z.ZodOptional<z.ZodEnum<["stdio", "http", "https"]>>;
+        port: z.ZodOptional<z.ZodNumber>;
+        host: z.ZodOptional<z.ZodString>;
+        sse_enabled: z.ZodOptional<z.ZodBoolean>;
+        stateless: z.ZodOptional<z.ZodBoolean>;
+        json_response: z.ZodOptional<z.ZodBoolean>;
+        tls: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            cert_path: z.ZodOptional<z.ZodString>;
+            key_path: z.ZodOptional<z.ZodString>;
+            ca_path: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        }, {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        }>>>;
+    }, "strip", z.ZodTypeAny, {
+        mode?: "http" | "stdio" | "https" | undefined;
+        host?: string | undefined;
+        port?: number | undefined;
+        sse_enabled?: boolean | undefined;
+        stateless?: boolean | undefined;
+        json_response?: boolean | undefined;
+        tls?: {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        } | undefined;
+    }, {
+        mode?: "http" | "stdio" | "https" | undefined;
+        host?: string | undefined;
+        port?: number | undefined;
+        sse_enabled?: boolean | undefined;
+        stateless?: boolean | undefined;
+        json_response?: boolean | undefined;
+        tls?: {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        } | undefined;
+    }>>;
+    readonly security: z.ZodOptional<z.ZodObject<{
+        allowed_hosts: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        rate_limit_max: z.ZodOptional<z.ZodNumber>;
+        rate_limit_window_ms: z.ZodOptional<z.ZodNumber>;
+        trust_proxy: z.ZodOptional<z.ZodUnion<[z.ZodNumber, z.ZodString]>>;
+        cors_origin: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        cors_credentials: z.ZodOptional<z.ZodBoolean>;
+        helmet_hsts: z.ZodOptional<z.ZodBoolean>;
+        helmet_csp: z.ZodOptional<z.ZodString>;
+        helmet_frame_options: z.ZodOptional<z.ZodEnum<["DENY", "SAMEORIGIN", "false"]>>;
+        body_size_limit: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        allowed_hosts?: string[] | undefined;
+        rate_limit_max?: number | undefined;
+        rate_limit_window_ms?: number | undefined;
+        trust_proxy?: string | number | undefined;
+        cors_origin?: string[] | undefined;
+        cors_credentials?: boolean | undefined;
+        helmet_hsts?: boolean | undefined;
+        helmet_csp?: string | undefined;
+        helmet_frame_options?: "DENY" | "SAMEORIGIN" | "false" | undefined;
+        body_size_limit?: string | undefined;
+    }, {
+        allowed_hosts?: string[] | undefined;
+        rate_limit_max?: number | undefined;
+        rate_limit_window_ms?: number | undefined;
+        trust_proxy?: string | number | undefined;
+        cors_origin?: string[] | undefined;
+        cors_credentials?: boolean | undefined;
+        helmet_hsts?: boolean | undefined;
+        helmet_csp?: string | undefined;
+        helmet_frame_options?: "DENY" | "SAMEORIGIN" | "false" | undefined;
+        body_size_limit?: string | undefined;
+    }>>;
+    readonly session: z.ZodOptional<z.ZodObject<{
+        max_sessions: z.ZodOptional<z.ZodNumber>;
+        max_streamable_http_sessions: z.ZodOptional<z.ZodNumber>;
+        max_sse_sessions: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        max_sessions?: number | undefined;
+        max_streamable_http_sessions?: number | undefined;
+        max_sse_sessions?: number | undefined;
+    }, {
+        max_sessions?: number | undefined;
+        max_streamable_http_sessions?: number | undefined;
+        max_sse_sessions?: number | undefined;
+    }>>;
+    readonly logging: z.ZodOptional<z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<["trace", "debug", "info", "warn", "error"]>>;
+        format: z.ZodOptional<z.ZodEnum<["text", "json"]>>;
+        timestamp: z.ZodOptional<z.ZodBoolean>;
+        component: z.ZodOptional<z.ZodBoolean>;
+        dir: z.ZodOptional<z.ZodString>;
+        max_file_size: z.ZodOptional<z.ZodString>;
+        max_files: z.ZodOptional<z.ZodNumber>;
+        retention_days: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        component?: boolean | undefined;
+        level?: "error" | "trace" | "debug" | "info" | "warn" | undefined;
+        format?: "text" | "json" | undefined;
+        timestamp?: boolean | undefined;
+        dir?: string | undefined;
+        max_file_size?: string | undefined;
+        max_files?: number | undefined;
+        retention_days?: number | undefined;
+    }, {
+        component?: boolean | undefined;
+        level?: "error" | "trace" | "debug" | "info" | "warn" | undefined;
+        format?: "text" | "json" | undefined;
+        timestamp?: boolean | undefined;
+        dir?: string | undefined;
+        max_file_size?: string | undefined;
+        max_files?: number | undefined;
+        retention_days?: number | undefined;
+    }>>;
+    readonly telemetry: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        service_name: z.ZodOptional<z.ZodString>;
+        exporter_endpoint: z.ZodOptional<z.ZodString>;
+        traces_exporter: z.ZodOptional<z.ZodString>;
+        logs_exporter: z.ZodOptional<z.ZodString>;
+        log_level: z.ZodOptional<z.ZodString>;
+        metric_export_interval: z.ZodOptional<z.ZodNumber>;
+        metrics_exporter: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        enabled?: boolean | undefined;
+        service_name?: string | undefined;
+        exporter_endpoint?: string | undefined;
+        traces_exporter?: string | undefined;
+        logs_exporter?: string | undefined;
+        log_level?: string | undefined;
+        metric_export_interval?: number | undefined;
+        metrics_exporter?: string | undefined;
+    }, {
+        enabled?: boolean | undefined;
+        service_name?: string | undefined;
+        exporter_endpoint?: string | undefined;
+        traces_exporter?: string | undefined;
+        logs_exporter?: string | undefined;
+        log_level?: string | undefined;
+        metric_export_interval?: number | undefined;
+        metrics_exporter?: string | undefined;
+    }>>;
+    readonly auth: z.ZodOptional<z.ZodObject<{
+        required_scopes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        resource_metadata_url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        required_scopes?: string[] | undefined;
+        resource_metadata_url?: string | undefined;
+    }, {
+        required_scopes?: string[] | undefined;
+        resource_metadata_url?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    transport?: {
+        mode?: "http" | "stdio" | "https" | undefined;
+        host?: string | undefined;
+        port?: number | undefined;
+        sse_enabled?: boolean | undefined;
+        stateless?: boolean | undefined;
+        json_response?: boolean | undefined;
+        tls?: {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        } | undefined;
+    } | undefined;
+    session?: {
+        max_sessions?: number | undefined;
+        max_streamable_http_sessions?: number | undefined;
+        max_sse_sessions?: number | undefined;
+    } | undefined;
+    logging?: {
+        component?: boolean | undefined;
+        level?: "error" | "trace" | "debug" | "info" | "warn" | undefined;
+        format?: "text" | "json" | undefined;
+        timestamp?: boolean | undefined;
+        dir?: string | undefined;
+        max_file_size?: string | undefined;
+        max_files?: number | undefined;
+        retention_days?: number | undefined;
+    } | undefined;
+    security?: {
+        allowed_hosts?: string[] | undefined;
+        rate_limit_max?: number | undefined;
+        rate_limit_window_ms?: number | undefined;
+        trust_proxy?: string | number | undefined;
+        cors_origin?: string[] | undefined;
+        cors_credentials?: boolean | undefined;
+        helmet_hsts?: boolean | undefined;
+        helmet_csp?: string | undefined;
+        helmet_frame_options?: "DENY" | "SAMEORIGIN" | "false" | undefined;
+        body_size_limit?: string | undefined;
+    } | undefined;
+    telemetry?: {
+        enabled?: boolean | undefined;
+        service_name?: string | undefined;
+        exporter_endpoint?: string | undefined;
+        traces_exporter?: string | undefined;
+        logs_exporter?: string | undefined;
+        log_level?: string | undefined;
+        metric_export_interval?: number | undefined;
+        metrics_exporter?: string | undefined;
+    } | undefined;
+    auth?: {
+        required_scopes?: string[] | undefined;
+        resource_metadata_url?: string | undefined;
+    } | undefined;
+}, {
+    transport?: {
+        mode?: "http" | "stdio" | "https" | undefined;
+        host?: string | undefined;
+        port?: number | undefined;
+        sse_enabled?: boolean | undefined;
+        stateless?: boolean | undefined;
+        json_response?: boolean | undefined;
+        tls?: {
+            cert_path?: string | undefined;
+            key_path?: string | undefined;
+            ca_path?: string | undefined;
+        } | undefined;
+    } | undefined;
+    session?: {
+        max_sessions?: number | undefined;
+        max_streamable_http_sessions?: number | undefined;
+        max_sse_sessions?: number | undefined;
+    } | undefined;
+    logging?: {
+        component?: boolean | undefined;
+        level?: "error" | "trace" | "debug" | "info" | "warn" | undefined;
+        format?: "text" | "json" | undefined;
+        timestamp?: boolean | undefined;
+        dir?: string | undefined;
+        max_file_size?: string | undefined;
+        max_files?: number | undefined;
+        retention_days?: number | undefined;
+    } | undefined;
+    security?: {
+        allowed_hosts?: string[] | undefined;
+        rate_limit_max?: number | undefined;
+        rate_limit_window_ms?: number | undefined;
+        trust_proxy?: string | number | undefined;
+        cors_origin?: string[] | undefined;
+        cors_credentials?: boolean | undefined;
+        helmet_hsts?: boolean | undefined;
+        helmet_csp?: string | undefined;
+        helmet_frame_options?: "DENY" | "SAMEORIGIN" | "false" | undefined;
+        body_size_limit?: string | undefined;
+    } | undefined;
+    telemetry?: {
+        enabled?: boolean | undefined;
+        service_name?: string | undefined;
+        exporter_endpoint?: string | undefined;
+        traces_exporter?: string | undefined;
+        logs_exporter?: string | undefined;
+        log_level?: string | undefined;
+        metric_export_interval?: number | undefined;
+        metrics_exporter?: string | undefined;
+    } | undefined;
+    auth?: {
+        required_scopes?: string[] | undefined;
+        resource_metadata_url?: string | undefined;
+    } | undefined;
+}>;
+/** Validated config file type */
+export type ConfigFileData = z.infer<typeof configFileSchema>;
+/**
+ * Map validated config file data to `FrameworkEnvConfig` overrides.
+ *
+ * Only explicitly defined values become overrides — `undefined` fields
+ * are omitted so they don't clobber environment-based defaults.
+ *
+ * The mapping is flat and explicit: each config file key maps to exactly
+ * one `FrameworkEnvConfig` key. No implicit behavior, no magic.
+ *
+ * @param config - Validated config file data
+ * @returns Partial overrides for `FrameworkEnvConfig`
+ */
+export declare function mapConfigToOverrides(config: ConfigFileData): Partial<FrameworkEnvConfig>;
+/**
+ * Serialize typed config overrides back to string key-value pairs.
+ *
+ * This is the reverse of what Zod coercion does. It converts typed
+ * `Partial<FrameworkEnvConfig>` values back to the string format that
+ * `parseFrameworkEnv()` expects, so config-file values can be merged
+ * into the env source dict alongside `.env` and `process.env` entries.
+ *
+ * Used by `initializeConfig()` to implement 12-Factor priority:
+ * `{ ...dotenvValues, ...mapConfigToEnvKeys(fileOverrides), ...process.env }`
+ *
+ * @param overrides - Typed config overrides from `mapConfigToOverrides()`
+ * @returns String key-value pairs suitable for Zod env parsing
+ */
+export declare function mapConfigToEnvKeys(overrides: Partial<FrameworkEnvConfig>): Record<string, string>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/config/file/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAOpD,oCAAoC;AACpC,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,sEAAuE,CAAC;AAExG;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,EAAG,iBAA0B,CAAC;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAK1E,CAAC;AAEH;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAChD,uDAAuD;IACvD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;CACnC;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IAC9B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;CAChC;AAqID;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAOkB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA2C,CAAC;AAEzE,iCAAiC;AACjC,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAM9D;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAiFxF;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBjG"}