@askdb/config 1.0.0-beta.16 → 1.0.0-beta.18

package/dist/runtime-config.d.ts

@@ -1,178 +1,10 @@
-import type { AskDbDialectId, AskDbIntrospectionProvider, AskDbRagStore, AskDbStudioExecuteProvider } from "./constants.js";
-import type { AskDbConfig } from "./types.js";
-/** One resolved `ai` section: its provider, the connection it uses, its model, and an env view built from that connection only. */
-export type AskDbRuntimeAiSection = {
-    provider: string;
-    /** Connection name within `ai.providerConfig.<provider>`. */
-    connection: string;
-    model: string | undefined;
-    /** `AiEnv` for `@askdb/ai` registry calls, built from this section's connection only. */
-    env: Record<string, string | undefined>;
-};
-/**
- * Typed AI runtime settings for `@askdb/core` (not `process.env`).
- */
-export type AskDbRuntimeAiConfig = {
-    /**
-     * Flat env-shaped map built from the runtime snapshot: the language view plus every other
-     * canonical key. Pass to `@askdb/ai` registry methods such as `resolveAiConfig` and
-     * `createLanguageModelFromEnv`.
-     */
-    aiEnv: Record<string, string | undefined>;
-    /** `ai.language`: the language model. `model` is undefined only for a custom provider with no model set. */
-    language: AskDbRuntimeAiSection & {
-        modelFamily: string | undefined;
-    };
-    /**
-     * `ai.embedding`: the embedding model. Undefined unless `rag.embedder` is `"ai"`. Pass `env`
-     * to `resolveEmbeddingConfig` / `createEmbeddingModelFromEnv`, and `{ dimensions }` as the
-     * latter's options: `env` holds the connection and model, not the width.
-     */
-    embedding: (AskDbRuntimeAiSection & {
-        model: string;
-        /**
-         * `ai.embedding.dimensions`: the vector size to request from the provider. Undefined
-         * leaves the width to the model; `detectEmbeddingDimensions` in `@askdb/rag` learns it.
-         */
-        dimensions: number | undefined;
-    }) | undefined;
-};
-/**
- * OpenAI embedder settings for the `askdb-rag` CLI. Filled from `ai.embedding` when its provider
- * is `openai`; otherwise only from the OpenAI language connection.
- */
-export type AskDbRuntimeRagEmbedderConfig = {
-    apiKey: string | undefined;
-    baseURL: string | undefined;
-    model: string | undefined;
-};
-export type AskDbRuntimeRagConfig = {
-    embedder: AskDbRuntimeRagEmbedderConfig;
-    /** `rag.store`, or `"memory"` when the config has no `rag` block. Read this rather than `structured.rag`, which is `undefined` when the block is omitted. */
-    store: AskDbRagStore;
-    /** `rag.storeConfig` as written, with no defaults filled in; `{}` when the config has no `rag` block or the block has no `storeConfig`. */
-    storeConfig: NonNullable<AskDbConfig["rag"]>["storeConfig"];
-};
-export type AskDbRuntimeLoggingConfig = {
-    level: string | undefined;
-    correlationId: string | undefined;
-    logFile: string | undefined;
-    logStdout: boolean;
-};
-export type AskDbRuntimeHttpApiConfig = {
-    listen: {
-        port: number;
-        host: string;
-    };
-    /** Whether `POST /ask` accepts a per-request `schemaJson` override. Default `false`. */
-    allowSchemaOverride: boolean;
-    /** Model-call timeout per `POST /ask` request, in milliseconds (1 to 2147483647). Default `60000`. */
-    requestTimeoutMs: number;
-};
-export type AskDbRuntimeIntrospectionConfig = {
-    provider: AskDbIntrospectionProvider;
-    /**
-     * Resolved Postgres connection URL when `provider === "postgres"`:
-     * `providerConfig.postgres.databaseUrl`, or its flat key `ASKDB_INTROSPECT_POSTGRES_URL`. Never read from `process.env`.
-     * `undefined` for non-Postgres providers.
-     */
-    postgresDatabaseUrl: string | undefined;
-    /** Resolved from `introspection.providerConfig.prisma.schemaPath`; `undefined` triggers auto-discovery in `@askdb/prisma`. */
-    prismaSchemaPath: string | undefined;
-    /**
-     * Resolved MySQL connection URL when `provider === "mysql"`:
-     * `providerConfig.mysql.databaseUrl`, or its flat key `ASKDB_INTROSPECT_MYSQL_URL`. Never read from `process.env`.
-     * `undefined` for non-MySQL providers.
-     */
-    mysqlDatabaseUrl: string | undefined;
-    /**
-     * Schemas (MySQL/MariaDB: databases) to introspect, for every provider:
-     * `introspection.schemas` → `ASKDB_INTROSPECT_SCHEMAS` (comma-separated).
-     * `undefined` means the engine's default. `askdb introspect --schemas` overrides it.
-     */
-    schemas: string[] | undefined;
-    /**
-     * Resolved SQLite file path when `provider === "sqlite"`:
-     * `providerConfig.sqlite.file`, or its flat key `ASKDB_INTROSPECT_SQLITE_FILE`. Never read from `process.env`.
-     * `undefined` for non-SQLite providers.
-     */
-    sqliteFile: string | undefined;
-    /**
-     * Resolved SQL Server connection URL when `provider === "sqlserver"`:
-     * `providerConfig.sqlserver.databaseUrl`, or its flat key `ASKDB_INTROSPECT_SQLSERVER_URL`. Never read from `process.env`.
-     * `undefined` for non-SQL Server providers.
-     */
-    sqlserverDatabaseUrl: string | undefined;
-    /** Resolved from `introspection.outputDir`; falls back to the package default (`./askdb/`). */
-    outputDir: string;
-};
-export type AskDbRuntimeDevConfig = {
-    mockSql: string | undefined;
-};
-export type AskDbRuntimeModesConfig = {
-    askdbMode: string | undefined;
-    omitSensitiveFromPrompt: boolean;
-};
-export type AskDbRuntimeNlToSqlConfig = {
-    /**
-     * Optional NL→SQL dialect override from `askdb.config.ts`. When set, hosts
-     * (CLI / HTTP API / Studio) pass this to `ask({ dialect })` instead of
-     * inferring from the introspection provider.
-     */
-    dialect: AskDbDialectId | undefined;
-};
-export type AskDbRuntimeStudioConfig = {
-    execute: {
-        /**
-         * Resolved execute provider. Falls back to the active introspection provider when it
-         * is a live engine (`postgres`, `mysql`, `sqlite`, `sqlserver`), then defaults to
-         * `"postgres"` for backward compatibility.
-         */
-        provider: AskDbStudioExecuteProvider;
-        /** Connection URL used by the Studio playground query runner for network databases. */
-        databaseUrl: string | undefined;
-        /** SQLite file path used when `provider === "sqlite"`. */
-        file: string | undefined;
-        /** Whether `POST /api/execute` is allowed. Default `false` (opt-in). */
-        enabled: boolean;
-        /**
-         * Whether `databaseUrl` / `file` may fall back to the active introspection
-         * connection. Default `false`.
-         */
-        useIntrospectionConnection: boolean;
-        /**
-         * True when the introspection config has a connection for this provider that
-         * Studio did not use because `useIntrospectionConnection` is off. Lets hosts
-         * explain why execute reports "not configured".
-         */
-        introspectionConnectionAvailable: boolean;
-        /** Per-query timeout in milliseconds. Default `30000`. */
-        timeoutMs: number;
-        /** Maximum rows returned per query. Default `500`. */
-        maxRows: number;
-    };
-};
-/**
- * Typed runtime view over the bootstrapped AskDB config snapshot.
- */
-export type AskDbRuntimeConfig = {
-    readonly structured: Readonly<AskDbConfig>;
-    /** Canonical flattened map (subprocess env via {@link mergeAskDbFlatIntoEnvMap}). */
-    readonly flat: Readonly<Record<string, string>>;
-    ai: AskDbRuntimeAiConfig;
-    introspection: AskDbRuntimeIntrospectionConfig;
-    rag: AskDbRuntimeRagConfig;
-    logging: AskDbRuntimeLoggingConfig;
-    httpApi: AskDbRuntimeHttpApiConfig;
-    dev: AskDbRuntimeDevConfig;
-    modes: AskDbRuntimeModesConfig;
-    nlToSql: AskDbRuntimeNlToSqlConfig;
-    studio: AskDbRuntimeStudioConfig;
-    /** One message per deprecated config key in use (it names the old and new key, never a value). */
-    deprecations: readonly string[];
-};
+import type { AskDbRuntimeConfig } from "./runtime-types.js";
 /**
  * Returns typed runtime configuration from the snapshot installed by {@link bootstrapAskDbEnv}.
+ *
+ * Every value is resolved from the snapshot's structured config. The snapshot's own flat map is
+ * never read back: another copy of `@askdb/config` may have installed it (ADR 0005), so `flat`
+ * and `ai.aiEnv` are this copy's projection of the same structured config.
  */
 export declare function getAskDbRuntimeConfig(): AskDbRuntimeConfig;
 //# sourceMappingURL=runtime-config.d.ts.map

package/dist/runtime-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-config.d.ts","sourceRoot":"","sources":["../src/runtime-config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"runtime-config.d.ts","sourceRoot":"","sources":["../src/runtime-config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAe7D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAU1D"}

package/dist/runtime-config.js

@@ -1,235 +1,31 @@
-import { ASKDB_STUDIO_EXECUTE_PROVIDERS } from "./constants.js";
-import { DEFAULT_HTTP_API_REQUEST_TIMEOUT_MS, DEFAULT_INTROSPECT_OUTPUT_DIR, DEFAULT_STUDIO_EXECUTE_MAX_ROWS, DEFAULT_STUDIO_EXECUTE_TIMEOUT_MS, parseHttpApiListenPort, parseHttpApiRequestTimeoutMs, parsePositiveInteger, } from "./defaults.js";
-import { aiEmbeddingEnv, aiLanguageEnv } from "./flatten.js";
-import { normalizeAskDbConfig } from "./normalize.js";
-import { flatToAiEnv, getAskDbRuntimeStore } from "./runtime-store.js";
-function isTruthyFlag(raw) {
-    return raw !== undefined && ["1", "true", "yes"].includes(raw.toLowerCase());
-}
-/** Normalization is pure, so it runs once per installed config object. */
-const normalizedByConfig = new WeakMap();
-function normalizedFor(structured) {
-    let normalized = normalizedByConfig.get(structured);
-    if (!normalized) {
-        normalized = normalizeAskDbConfig(structured);
-        normalizedByConfig.set(structured, normalized);
+import { resolveAskDbConfig } from "./resolve.js";
+import { getAskDbRuntimeStore } from "./runtime-store.js";
+/** Resolution is pure, so it runs once per installed config object. */
+const resolutionByConfig = new WeakMap();
+function resolutionFor(structured) {
+    let resolution = resolutionByConfig.get(structured);
+    if (!resolution) {
+        resolution = resolveAskDbConfig(structured);
+        resolutionByConfig.set(structured, resolution);
     }
-    return normalized;
-}
-/** The runtime view of a resolved `ai` section, with `env` built from its connection only. */
-function runtimeSection(section, env) {
-    return { provider: section.provider, connection: section.connection.name, model: section.model, env };
-}
-function pickFlat(flat, key) {
-    const v = flat[key];
-    if (v === undefined || v.trim() === "")
-        return undefined;
-    return v.trim();
+    return resolution;
 }
 /**
  * Returns typed runtime configuration from the snapshot installed by {@link bootstrapAskDbEnv}.
+ *
+ * Every value is resolved from the snapshot's structured config. The snapshot's own flat map is
+ * never read back: another copy of `@askdb/config` may have installed it (ADR 0005), so `flat`
+ * and `ai.aiEnv` are this copy's projection of the same structured config.
  */
 export function getAskDbRuntimeConfig() {
-    const { structured, flat } = getAskDbRuntimeStore();
-    const aiEnv = flatToAiEnv(flat);
-    const { config: normalized, deprecations } = normalizedFor(structured);
-    const language = normalized.ai.language;
-    const embeddingSection = normalized.ai.embedding;
-    const embedding = embeddingSection
-        ? {
-            ...runtimeSection(embeddingSection, aiEmbeddingEnv(embeddingSection)),
-            dimensions: embeddingSection.dimensions,
-        }
-        : undefined;
-    // The RAG CLI's OpenAI embedder never reads another provider's key or base URL.
-    const openaiEmbedding = embedding?.provider === "openai" ? embedding : undefined;
-    const logStdoutRaw = pickFlat(flat, "ASKDB_LOG_STDOUT");
-    const logStdout = isTruthyFlag(logStdoutRaw);
-    const port = parseHttpApiListenPort(structured.httpApi?.listen?.port, "httpApi.listen.port") ??
-        parseHttpApiListenPort(pickFlat(flat, "PORT"), "PORT") ??
-        3000;
-    const host = structured.httpApi?.listen?.host ?? pickFlat(flat, "HOST") ?? "127.0.0.1";
-    const omitRaw = pickFlat(flat, "ASKDB_OMIT_SENSITIVE_FROM_PROMPT");
-    const omitFromFlat = isTruthyFlag(omitRaw);
-    const prismaSchemaPathRaw = structured.introspection.provider === "prisma"
-        ? structured.introspection.providerConfig?.prisma?.schemaPath?.trim()
-        : undefined;
-    // Per-engine connection lookup. We deliberately only resolve the field for
-    // the active provider so the runtime view stays minimal and other branches
-    // surface `undefined` (cheap exhaustiveness check at the consumer).
-    const postgresDatabaseUrl = structured.introspection.provider === "postgres"
-        ? structured.introspection.providerConfig?.postgres?.databaseUrl?.trim() ||
-            pickFlat(flat, "ASKDB_INTROSPECT_POSTGRES_URL")
-        : undefined;
-    const mysqlDatabaseUrl = structured.introspection.provider === "mysql"
-        ? structured.introspection.providerConfig?.mysql?.databaseUrl?.trim() ||
-            pickFlat(flat, "ASKDB_INTROSPECT_MYSQL_URL")
-        : undefined;
-    const schemas = (structured.introspection.schemas ?? pickFlat(flat, "ASKDB_INTROSPECT_SCHEMAS")?.split(","))
-        ?.map((s) => s.trim())
-        .filter(Boolean);
-    const sqliteFile = structured.introspection.provider === "sqlite"
-        ? structured.introspection.providerConfig?.sqlite?.file?.trim() ||
-            pickFlat(flat, "ASKDB_INTROSPECT_SQLITE_FILE")
-        : undefined;
-    const sqlserverDatabaseUrl = structured.introspection.provider === "sqlserver"
-        ? structured.introspection.providerConfig?.sqlserver?.databaseUrl?.trim() ||
-            pickFlat(flat, "ASKDB_INTROSPECT_SQLSERVER_URL")
-        : undefined;
+    const { structured } = getAskDbRuntimeStore();
+    const { resolved, flat, deprecations } = resolutionFor(structured);
     return {
         structured,
         flat,
-        ai: {
-            aiEnv,
-            language: { ...runtimeSection(language, aiLanguageEnv(language)), modelFamily: language.modelFamily },
-            embedding,
-        },
-        introspection: {
-            provider: structured.introspection.provider,
-            postgresDatabaseUrl,
-            prismaSchemaPath: prismaSchemaPathRaw || undefined,
-            mysqlDatabaseUrl,
-            schemas: schemas?.length ? schemas : undefined,
-            sqliteFile,
-            sqlserverDatabaseUrl,
-            outputDir: pickFlat(flat, "ASKDB_INTROSPECT_OUT") ??
-                structured.introspection.outputDir?.trim() ??
-                DEFAULT_INTROSPECT_OUTPUT_DIR,
-        },
-        rag: {
-            embedder: openaiEmbedding
-                ? {
-                    apiKey: openaiEmbedding.env.OPENAI_API_KEY,
-                    baseURL: openaiEmbedding.env.OPENAI_BASE_URL,
-                    model: openaiEmbedding.model,
-                }
-                : {
-                    apiKey: pickFlat(flat, "OPENAI_API_KEY"),
-                    baseURL: pickFlat(flat, "OPENAI_BASE_URL"),
-                    model: undefined,
-                },
-            store: normalized.rag.store,
-            storeConfig: normalized.rag.storeConfig,
-        },
-        logging: {
-            level: structured.logging?.level ?? pickFlat(flat, "ASKDB_LOG_LEVEL"),
-            correlationId: structured.logging?.correlationId ?? pickFlat(flat, "ASKDB_CORRELATION_ID"),
-            logFile: structured.logging?.logFile ?? pickFlat(flat, "ASKDB_LOG_FILE"),
-            logStdout,
-        },
-        httpApi: {
-            listen: { port, host },
-            // Only a real boolean counts: flattening rejects anything else, so a store installed
-            // without it falls back to the flat key, which is set only for `true`.
-            allowSchemaOverride: typeof structured.httpApi?.allowSchemaOverride === "boolean"
-                ? structured.httpApi.allowSchemaOverride
-                : isTruthyFlag(pickFlat(flat, "ASKDB_HTTP_ALLOW_SCHEMA_OVERRIDE")),
-            requestTimeoutMs: parseHttpApiRequestTimeoutMs(structured.httpApi?.requestTimeoutMs, "httpApi.requestTimeoutMs") ??
-                parseHttpApiRequestTimeoutMs(pickFlat(flat, "ASKDB_HTTP_REQUEST_TIMEOUT_MS"), "ASKDB_HTTP_REQUEST_TIMEOUT_MS") ??
-                DEFAULT_HTTP_API_REQUEST_TIMEOUT_MS,
-        },
-        dev: {
-            mockSql: structured.dev?.mockSql ?? pickFlat(flat, "ASKDB_MOCK_SQL"),
-        },
-        modes: {
-            askdbMode: structured.modes?.askdbMode ?? pickFlat(flat, "ASKDB_MODE"),
-            omitSensitiveFromPrompt: Boolean(structured.modes?.omitSensitiveFromPrompt) || omitFromFlat,
-        },
-        nlToSql: {
-            dialect: structured.dialect,
-        },
-        studio: {
-            execute: resolveStudioExecuteConfig(structured, flat),
-        },
+        ...resolved,
+        ai: { aiEnv: { ...flat }, ...resolved.ai },
         deprecations,
     };
 }
-function resolveStudioExecuteConfig(structured, flat) {
-    // 1. Explicit provider from structured config or env.
-    const providerRaw = structured.studio?.execute?.provider ??
-        pickFlat(flat, "ASKDB_STUDIO_EXECUTE_PROVIDER");
-    let provider;
-    if (providerRaw !== undefined && ASKDB_STUDIO_EXECUTE_PROVIDERS.includes(providerRaw)) {
-        provider = providerRaw;
-    }
-    else {
-        // 2. Fall back to introspection provider when it is a live execute provider.
-        const introspectionProvider = structured.introspection?.provider;
-        if (introspectionProvider !== undefined && ASKDB_STUDIO_EXECUTE_PROVIDERS.includes(introspectionProvider)) {
-            provider = introspectionProvider;
-        }
-        else {
-            // 3. Default to postgres for backward compatibility.
-            provider = "postgres";
-        }
-    }
-    const execute = structured.studio?.execute;
-    const enabled = (typeof execute?.enabled === "boolean" ? execute.enabled : undefined) ??
-        parseFlatBoolean(pickFlat(flat, "ASKDB_STUDIO_EXECUTE_ENABLED")) ??
-        false;
-    const useIntrospectionConnection = (typeof execute?.useIntrospectionConnection === "boolean" ? execute.useIntrospectionConnection : undefined) ??
-        parseFlatBoolean(pickFlat(flat, "ASKDB_STUDIO_EXECUTE_USE_INTROSPECTION_CONNECTION")) ??
-        false;
-    const timeoutMs = parsePositiveInteger(execute?.timeoutMs) ??
-        parsePositiveInteger(pickFlat(flat, "ASKDB_STUDIO_EXECUTE_TIMEOUT_MS")) ??
-        DEFAULT_STUDIO_EXECUTE_TIMEOUT_MS;
-    const maxRows = parsePositiveInteger(execute?.maxRows) ??
-        parsePositiveInteger(pickFlat(flat, "ASKDB_STUDIO_EXECUTE_MAX_ROWS")) ??
-        DEFAULT_STUDIO_EXECUTE_MAX_ROWS;
-    // Connection resolution — each provider draws from its own structured field
-    // first, then the relevant flat env key. The introspection connection is only
-    // reused when `useIntrospectionConnection` is explicitly on, so turning execute
-    // on never silently runs ad-hoc SQL with introspection credentials.
-    const introspectionConnection = introspectionConnectionFor(provider, structured, flat);
-    let databaseUrl;
-    let file;
-    if (provider === "sqlite") {
-        file = execute?.file?.trim() || pickFlat(flat, "ASKDB_STUDIO_SQLITE_FILE");
-    }
-    else {
-        databaseUrl = execute?.databaseUrl?.trim() || pickFlat(flat, "ASKDB_STUDIO_DATABASE_URL");
-    }
-    const explicit = provider === "sqlite" ? file : databaseUrl;
-    if (!explicit && useIntrospectionConnection && introspectionConnection) {
-        if (provider === "sqlite")
-            file = introspectionConnection;
-        else
-            databaseUrl = introspectionConnection;
-    }
-    return {
-        provider,
-        databaseUrl,
-        file,
-        enabled,
-        useIntrospectionConnection,
-        introspectionConnectionAvailable: !explicit && !useIntrospectionConnection && introspectionConnection !== undefined,
-        timeoutMs,
-        maxRows,
-    };
-}
-function introspectionConnectionFor(provider, structured, flat) {
-    const intro = structured.introspection;
-    if (intro?.provider !== provider)
-        return undefined;
-    switch (provider) {
-        case "postgres":
-            return intro.providerConfig?.postgres?.databaseUrl?.trim() || pickFlat(flat, "ASKDB_INTROSPECT_POSTGRES_URL");
-        case "mysql":
-            return intro.providerConfig?.mysql?.databaseUrl?.trim() || pickFlat(flat, "ASKDB_INTROSPECT_MYSQL_URL");
-        case "sqlserver":
-            return intro.providerConfig?.sqlserver?.databaseUrl?.trim() || pickFlat(flat, "ASKDB_INTROSPECT_SQLSERVER_URL");
-        case "sqlite":
-            return intro.providerConfig?.sqlite?.file?.trim() || pickFlat(flat, "ASKDB_INTROSPECT_SQLITE_FILE");
-    }
-}
-function parseFlatBoolean(raw) {
-    if (raw === undefined)
-        return undefined;
-    const v = raw.toLowerCase();
-    if (["1", "true", "yes", "on"].includes(v))
-        return true;
-    if (["0", "false", "no", "off"].includes(v))
-        return false;
-    return undefined;
-}
 //# sourceMappingURL=runtime-config.js.map

package/dist/runtime-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-config.js","sourceRoot":"","sources":["../src/runtime-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,8BAA8B,EAAE,MAAM,gBAAgB,CAAC;AAEhE,OAAO,EACL,mCAAmC,EACnC,6BAA6B,EAC7B,+BAA+B,EAC/B,iCAAiC,EACjC,sBAAsB,EACtB,4BAA4B,EAC5B,oBAAoB,GACrB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAA+B,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAyLvE,SAAS,YAAY,CAAC,GAAuB;IAC3C,OAAO,GAAG,KAAK,SAAS,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC;AAC/E,CAAC;AAED,0EAA0E;AAC1E,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAmD,CAAC;AAE1F,SAAS,aAAa,CAAC,UAAiC;IACtD,IAAI,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,oBAAoB,CAAC,UAAyB,CAAC,CAAC;QAC7D,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,8FAA8F;AAC9F,SAAS,cAAc,CACrB,OAA2E,EAC3E,GAA2B;IAE3B,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;AACxG,CAAC;AAED,SAAS,QAAQ,CAAC,IAAsC,EAAE,GAAW;IACnE,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACpB,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IACzD,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,oBAAoB,EAAE,CAAC;IACpD,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,UAAU,CAAC,EAAE,CAAC,QAAQ,CAAC;IACxC,MAAM,gBAAgB,GAAG,UAAU,CAAC,EAAE,CAAC,SAAS,CAAC;IACjD,MAAM,SAAS,GAAG,gBAAgB;QAChC,CAAC,CAAC;YACE,GAAG,cAAc,CAAC,gBAAgB,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;YACrE,UAAU,EAAE,gBAAgB,CAAC,UAAU;SACxC;QACH,CAAC,CAAC,SAAS,CAAC;IACd,gFAAgF;IAChF,MAAM,eAAe,GAAG,SAAS,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;IAE7C,MAAM,IAAI,GACR,sBAAsB,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,qBAAqB,CAAC;QAC/E,sBAAsB,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QACtD,IAAI,CAAC;IACP,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,WAAW,CAAC;IAEvF,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC,CAAC;IACnE,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAE3C,MAAM,mBAAmB,GACvB,UAAU,CAAC,aAAa,CAAC,QAAQ,KAAK,QAAQ;QAC5C,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE;QACrE,CAAC,CAAC,SAAS,CAAC;IAEhB,2EAA2E;IAC3E,2EAA2E;IAC3E,oEAAoE;IACpE,MAAM,mBAAmB,GACvB,UAAU,CAAC,aAAa,CAAC,QAAQ,KAAK,UAAU;QAC9C,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE;YACtE,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC;QACjD,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,gBAAgB,GACpB,UAAU,CAAC,aAAa,CAAC,QAAQ,KAAK,OAAO;QAC3C,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE;YACnE,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;QAC9C,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,OAAO,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1G,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACrB,MAAM,CAAC,OAAO,CAAC,CAAC;IACnB,MAAM,UAAU,GACd,UAAU,CAAC,aAAa,CAAC,QAAQ,KAAK,QAAQ;QAC5C,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;YAC7D,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;QAChD,CAAC,CAAC,SAAS,CAAC;IAChB,MAAM,oBAAoB,GACxB,UAAU,CAAC,aAAa,CAAC,QAAQ,KAAK,WAAW;QAC/C,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE;YACvE,QAAQ,CAAC,IAAI,EAAE,gCAAgC,CAAC;QAClD,CAAC,CAAC,SAAS,CAAC;IAEhB,OAAO;QACL,UAAU;QACV,IAAI;QACJ,EAAE,EAAE;YACF,KAAK;YACL,QAAQ,EAAE,EAAE,GAAG,cAAc,CAAC,QAAQ,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE;YACrG,SAAS;SACV;QACD,aAAa,EAAE;YACb,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,QAAQ;YAC3C,mBAAmB;YACnB,gBAAgB,EAAE,mBAAmB,IAAI,SAAS;YAClD,gBAAgB;YAChB,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS;YAC9C,UAAU;YACV,oBAAoB;YACpB,SAAS,EACP,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;gBACtC,UAAU,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,EAAE;gBAC1C,6BAA6B;SAChC;QACD,GAAG,EAAE;YACH,QAAQ,EAAE,eAAe;gBACvB,CAAC,CAAC;oBACE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,cAAc;oBAC1C,OAAO,EAAE,eAAe,CAAC,GAAG,CAAC,eAAe;oBAC5C,KAAK,EAAE,eAAe,CAAC,KAAK;iBAC7B;gBACH,CAAC,CAAC;oBACE,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;oBACxC,OAAO,EAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;oBAC1C,KAAK,EAAE,SAAS;iBACjB;YACL,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK;YAC3B,WAAW,EAAE,UAAU,CAAC,GAAG,CAAC,WAAW;SACxC;QACD,OAAO,EAAE;YACP,KAAK,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;YACrE,aAAa,EAAE,UAAU,CAAC,OAAO,EAAE,aAAa,IAAI,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;YAC1F,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;YACxE,SAAS;SACV;QACD,OAAO,EAAE;YACP,MAAM,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;YACtB,qFAAqF;YACrF,uEAAuE;YACvE,mBAAmB,EACjB,OAAO,UAAU,CAAC,OAAO,EAAE,mBAAmB,KAAK,SAAS;gBAC1D,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,mBAAmB;gBACxC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,IAAI,EAAE,kCAAkC,CAAC,CAAC;YACtE,gBAAgB,EACd,4BAA4B,CAAC,UAAU,CAAC,OAAO,EAAE,gBAAgB,EAAE,0BAA0B,CAAC;gBAC9F,4BAA4B,CAAC,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC,EAAE,+BAA+B,CAAC;gBAC9G,mCAAmC;SACtC;QACD,GAAG,EAAE;YACH,OAAO,EAAE,UAAU,CAAC,GAAG,EAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;SACrE;QACD,KAAK,EAAE;YACL,SAAS,EAAE,UAAU,CAAC,KAAK,EAAE,SAAS,IAAI,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;YACtE,uBAAuB,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,EAAE,uBAAuB,CAAC,IAAI,YAAY;SAC5F;QACD,OAAO,EAAE;YACP,OAAO,EAAE,UAAU,CAAC,OAAO;SAC5B;QACD,MAAM,EAAE;YACN,OAAO,EAAE,0BAA0B,CAAC,UAAU,EAAE,IAAI,CAAC;SACtD;QACD,YAAY;KACb,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,UAAiC,EACjC,IAAsC;IAEtC,sDAAsD;IACtD,MAAM,WAAW,GACf,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,QAAQ;QACpC,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC;IAElD,IAAI,QAAoC,CAAC;IACzC,IAAI,WAAW,KAAK,SAAS,IAAK,8BAAwD,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;QACjH,QAAQ,GAAG,WAAyC,CAAC;IACvD,CAAC;SAAM,CAAC;QACN,6EAA6E;QAC7E,MAAM,qBAAqB,GAAG,UAAU,CAAC,aAAa,EAAE,QAAQ,CAAC;QACjE,IAAI,qBAAqB,KAAK,SAAS,IAAK,8BAAwD,CAAC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,CAAC;YACrI,QAAQ,GAAG,qBAAmD,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,qDAAqD;YACrD,QAAQ,GAAG,UAAU,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3C,MAAM,OAAO,GACX,CAAC,OAAO,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACrE,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAC;QAChE,KAAK,CAAC;IACR,MAAM,0BAA0B,GAC9B,CAAC,OAAO,OAAO,EAAE,0BAA0B,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,SAAS,CAAC;QAC3G,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,mDAAmD,CAAC,CAAC;QACrF,KAAK,CAAC;IACR,MAAM,SAAS,GACb,oBAAoB,CAAC,OAAO,EAAE,SAAS,CAAC;QACxC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;QACvE,iCAAiC,CAAC;IACpC,MAAM,OAAO,GACX,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC;QACtC,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC;QACrE,+BAA+B,CAAC;IAElC,4EAA4E;IAC5E,8EAA8E;IAC9E,gFAAgF;IAChF,oEAAoE;IACpE,MAAM,uBAAuB,GAAG,0BAA0B,CAAC,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACvF,IAAI,WAA+B,CAAC;IACpC,IAAI,IAAwB,CAAC;IAE7B,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;IAC7E,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,2BAA2B,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,QAAQ,GAAG,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC;IAC5D,IAAI,CAAC,QAAQ,IAAI,0BAA0B,IAAI,uBAAuB,EAAE,CAAC;QACvE,IAAI,QAAQ,KAAK,QAAQ;YAAE,IAAI,GAAG,uBAAuB,CAAC;;YACrD,WAAW,GAAG,uBAAuB,CAAC;IAC7C,CAAC;IAED,OAAO;QACL,QAAQ;QACR,WAAW;QACX,IAAI;QACJ,OAAO;QACP,0BAA0B;QAC1B,gCAAgC,EAC9B,CAAC,QAAQ,IAAI,CAAC,0BAA0B,IAAI,uBAAuB,KAAK,SAAS;QACnF,SAAS;QACT,OAAO;KACR,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,QAAoC,EACpC,UAAiC,EACjC,IAAsC;IAEtC,MAAM,KAAK,GAAG,UAAU,CAAC,aAAa,CAAC;IACvC,IAAI,KAAK,EAAE,QAAQ,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACnD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,KAAK,CAAC,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC;QAChH,KAAK,OAAO;YACV,OAAO,KAAK,CAAC,cAAc,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAC;QAC1G,KAAK,WAAW;YACd,OAAO,KAAK,CAAC,cAAc,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,gCAAgC,CAAC,CAAC;QAClH,KAAK,QAAQ;YACX,OAAO,KAAK,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC,CAAC;IACxG,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAuB;IAC/C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5B,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACxD,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IAC1D,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"runtime-config.js","sourceRoot":"","sources":["../src/runtime-config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAA8B,MAAM,cAAc,CAAC;AAE9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,uEAAuE;AACvE,MAAM,kBAAkB,GAAG,IAAI,OAAO,EAAiC,CAAC;AAExE,SAAS,aAAa,CAAC,UAAiC;IACtD,IAAI,UAAU,GAAG,kBAAkB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACpD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,UAAU,GAAG,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC5C,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,MAAM,EAAE,UAAU,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAC9C,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,aAAa,CAAC,UAAU,CAAC,CAAC;IACnE,OAAO;QACL,UAAU;QACV,IAAI;QACJ,GAAG,QAAQ;QACX,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE;QAC1C,YAAY;KACb,CAAC;AACJ,CAAC"}

package/dist/runtime-store.d.ts

@@ -1,26 +1,29 @@
 import type { AskDbConfig } from "./types.js";
 export type AskDbRuntimeStore = {
     readonly structured: AskDbConfig;
-    /** Canonical string map from {@link flattenAskDbConfig} (same keys as former merged `process.env`). */
+    /**
+     * Canonical string map from {@link flattenAskDbConfig}. Written for copies of `@askdb/config`
+     * that still read it; this copy resolves every value from `structured` and never reads it back.
+     */
     readonly flat: Readonly<Record<string, string>>;
 };
 export declare function setAskDbRuntime(data: AskDbRuntimeStore): void;
-export declare function clearAskDbRuntime(): void;
 /**
  * `true` once `bootstrapAskDbEnv()` (or another installer) has set the runtime snapshot.
  * A host-facing factory can use it to bootstrap only when its host hasn't already done so.
  */
 export declare function isAskDbRuntimeInitialized(): boolean;
 export declare function getAskDbRuntimeStore(): AskDbRuntimeStore;
-/** Build an env-shaped map for `@askdb/core` from the flattened runtime snapshot (not `process.env`). */
-export declare function flatToAiEnv(flat: Readonly<Record<string, string>>): Record<string, string | undefined>;
 /**
  * Merge AskDB flat keys into a base env map (e.g. for spawning child processes).
  * Does not read `process.env` itself.
  */
 export declare function mergeAskDbFlatIntoEnvMap(base: NodeJS.ProcessEnv, flat: Readonly<Record<string, string>>): NodeJS.ProcessEnv;
-/** @internal Tests only — replaces the runtime store without loading from disk. */
-export declare function setAskDbRuntimeForTests(data: AskDbRuntimeStore): void;
+/**
+ * @internal Tests only — installs `config` as `bootstrapAskDbEnv()` installs a loaded file,
+ * without reading the disk. Throws the same `askdb.config: …` errors as `defineConfig`.
+ */
+export declare function setAskDbRuntimeForTests(config: AskDbConfig): void;
 /** @internal Tests only. */
 export declare function resetAskDbRuntimeForTests(): void;
 //# sourceMappingURL=runtime-store.d.ts.map

package/dist/runtime-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-store.d.ts","sourceRoot":"","sources":["../src/runtime-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,uGAAuG;IACvG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD,CAAC;AAYF,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAE7D;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CASxD;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAEtG;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,UAAU,EACvB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACrC,MAAM,CAAC,UAAU,CAQnB;AAED,mFAAmF;AACnF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAErE;AAED,4BAA4B;AAC5B,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}
+{"version":3,"file":"runtime-store.d.ts","sourceRoot":"","sources":["../src/runtime-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACjD,CAAC;AAYF,wBAAgB,eAAe,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,OAAO,CAEnD;AAED,wBAAgB,oBAAoB,IAAI,iBAAiB,CASxD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,CAAC,UAAU,EACvB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GACrC,MAAM,CAAC,UAAU,CAQnB;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAGjE;AAED,4BAA4B;AAC5B,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/runtime-store.js

@@ -1,3 +1,4 @@
+import { defineConfig } from "./projection.js";
 /**
  * The snapshot lives on `globalThis` under a registered symbol, not in a module variable, so every
  * copy of `@askdb/config` in a process shares it: a host that bootstraps with its own version is
@@ -9,9 +10,6 @@ const runtimeHolder = globalThis;
 export function setAskDbRuntime(data) {
     runtimeHolder[RUNTIME_STORE_KEY] = data;
 }
-export function clearAskDbRuntime() {
-    delete runtimeHolder[RUNTIME_STORE_KEY];
-}
 /**
  * `true` once `bootstrapAskDbEnv()` (or another installer) has set the runtime snapshot.
  * A host-facing factory can use it to bootstrap only when its host hasn't already done so.
@@ -27,10 +25,6 @@ export function getAskDbRuntimeStore() {
     }
     return stored;
 }
-/** Build an env-shaped map for `@askdb/core` from the flattened runtime snapshot (not `process.env`). */
-export function flatToAiEnv(flat) {
-    return { ...flat };
-}
 /**
  * Merge AskDB flat keys into a base env map (e.g. for spawning child processes).
  * Does not read `process.env` itself.
@@ -44,12 +38,16 @@ export function mergeAskDbFlatIntoEnvMap(base, flat) {
     }
     return out;
 }
-/** @internal Tests only — replaces the runtime store without loading from disk. */
-export function setAskDbRuntimeForTests(data) {
-    setAskDbRuntime(data);
+/**
+ * @internal Tests only — installs `config` as `bootstrapAskDbEnv()` installs a loaded file,
+ * without reading the disk. Throws the same `askdb.config: …` errors as `defineConfig`.
+ */
+export function setAskDbRuntimeForTests(config) {
+    const { config: structured, entries } = defineConfig(config);
+    setAskDbRuntime({ structured, flat: { ...entries } });
 }
 /** @internal Tests only. */
 export function resetAskDbRuntimeForTests() {
-    clearAskDbRuntime();
+    delete runtimeHolder[RUNTIME_STORE_KEY];
 }
 //# sourceMappingURL=runtime-store.js.map

package/dist/runtime-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-store.js","sourceRoot":"","sources":["../src/runtime-store.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,iBAAiB,GAAkB,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAE1E,MAAM,aAAa,GAAG,UAA6E,CAAC;AAEpG,MAAM,UAAU,eAAe,CAAC,IAAuB;IACrD,aAAa,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,aAAa,CAAC,iBAAiB,CAAC,KAAK,SAAS,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,MAAM,MAAM,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,4HAA4H;YAC1H,mEAAmE,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,WAAW,CAAC,IAAsC;IAChE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAuB,EACvB,IAAsC;IAEtC,MAAM,GAAG,GAAsB,EAAE,GAAG,IAAI,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,uBAAuB,CAAC,IAAuB;IAC7D,eAAe,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,yBAAyB;IACvC,iBAAiB,EAAE,CAAC;AACtB,CAAC"}
+{"version":3,"file":"runtime-store.js","sourceRoot":"","sources":["../src/runtime-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAY/C;;;;;GAKG;AACH,MAAM,iBAAiB,GAAkB,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;AAE1E,MAAM,aAAa,GAAG,UAA6E,CAAC;AAEpG,MAAM,UAAU,eAAe,CAAC,IAAuB;IACrD,aAAa,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,aAAa,CAAC,iBAAiB,CAAC,KAAK,SAAS,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,MAAM,MAAM,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,4HAA4H;YAC1H,mEAAmE,CACtE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,IAAuB,EACvB,IAAsC;IAEtC,MAAM,GAAG,GAAsB,EAAE,GAAG,IAAI,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACpB,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAmB;IACzD,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAC7D,eAAe,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,yBAAyB;IACvC,OAAO,aAAa,CAAC,iBAAiB,CAAC,CAAC;AAC1C,CAAC"}