@askdb/config 1.0.0-beta.15 → 1.0.0-beta.17

package/README.md

@@ -49,7 +49,7 @@ export default defineConfig({
 
 `defineConfig` types the object as `AskDbConfig`. A plain `export default { … }` loads too: the loader runs it through `defineConfig`, so it gets the same normalizing, checks and deprecation warnings. A config without its required `ai` or `introspection` block fails to load with an error that names the file and the block.
 
-Your `.env` can use friendly names (`MY_OPENAI_API_KEY`, …). `defineConfig` runs `flattenAskDbConfig`, which maps the nested object onto the canonical environment variable names used in the **runtime flat map** (and in `aiEnv` for `@askdb/ai`). **Unset optional fields get defaults inside `flattenAskDbConfig`** (language model, introspection output dir, database URL fallbacks, the mock embedder's vector width, file-store base path, pgvector index strategy, etc. — see `packages/config/src/defaults.ts`).
+Your `.env` can use friendly names (`MY_OPENAI_API_KEY`, …). `defineConfig` resolves the config once: it checks each setting, translates deprecated keys and fills in the defaults (language model, introspection output dir, HTTP API port and host, Studio execute limits, pgvector index strategy, etc. — see `packages/config/src/defaults.ts`). A value of the wrong type fails to load with an error that names its config key: a boolean setting must be `true` or `false`, so the string `"false"` fails. `getAskDbRuntimeConfig()` returns the resolved settings, and the **runtime flat map** (and `aiEnv` for `@askdb/ai`) maps the same settings onto canonical environment variable names, in the same pass. `getAskDbRuntimeConfig()` never reads a setting back from a flat map.
 
 The `rag` block is optional. Omit it when you don't use retrieval: AskDB then uses the mock embedder and the in-memory store, as if `rag: { embedder: "mock", store: "memory", storeConfig: {} }` were set. Setting `ai.embedding` without the block is an error, since nothing would use that model.
 
@@ -86,17 +86,17 @@ const embeddingModel = config.ai.embedding
 
 ## API
 
-- `getAskDbRuntimeConfig()` — **primary API for library packages**. Returns a typed `AskDbRuntimeConfig` from the bootstrapped snapshot (`structured`, `flat`-derived fields, `ai.aiEnv` for `@askdb/core`, the resolved `ai.language` and `ai.embedding` sections, `rag.store` and `rag.storeConfig` (the vector store, `"memory"` when `rag` is omitted), and `deprecations`, the config's deprecation messages).
+- `getAskDbRuntimeConfig()` — **primary API for library packages**. Returns a typed `AskDbRuntimeConfig` from the bootstrapped snapshot (`structured`, the settings resolved from it, `flat` and `ai.aiEnv` for `@askdb/ai`, the resolved `ai.language` and `ai.embedding` sections, `rag.store` and `rag.storeConfig` (the vector store, `"memory"` when `rag` is omitted), and `deprecations`, the config's deprecation messages).
 - `env(name)` / `requiredEnv(name)` — read `process.env` while authoring `askdb.config.*` only.
 - `isAskDbDebugEnabled()` — `true` when the `ASKDB_DEBUG` shell variable is `1` or `true`. Binaries use it to print stack traces; it reads `process.env` directly so it works even when the config fails to load.
 - `defineConfig(config)` — returns an `AskDbEnvProjection` with `config` (structured) and `entries` (flattened canonical map).
-- `flattenAskDbConfig(config)` — nested config → flat canonical map (translates deprecated keys, applies defaults for optional values).
+- `flattenAskDbConfig(config)` — nested config → flat canonical map, for a child process's env. Resolves the config first, so it throws the same errors as `defineConfig`.
 - `bootstrapAskDbEnv(options?)` / `bootstrapAskDbRuntime` — load dotenv, load config, install the runtime snapshot.
 - `isAskDbRuntimeInitialized()` — `true` once the runtime snapshot is installed. Code that may run before or after its host's bootstrap uses it to call `bootstrapAskDbEnv()` only when needed, as `@askdb/http-api`'s `createAskDbHttpServer()` does. The snapshot is process-wide: every copy of `@askdb/config` in the process sees the same one.
 - `loadAskDbConfigProjection(cwd)` / `loadAskDbConfigProjectionSync(cwd)` — load projection without installing the singleton (advanced / tests).
 - `discoverAskDbConfigPath(cwd)` — returns the resolved config path, if any.
 - `mergeAskDbFlatIntoEnvMap(base, flat)` — merge AskDB flat entries into an env map for **child processes** (does not read `process.env` itself). Use `getAskDbRuntimeConfig().flat` as `flat` after bootstrap.
-- `setAskDbRuntimeForTests` / `resetAskDbRuntimeForTests` — test helpers for the runtime snapshot.
+- `setAskDbRuntimeForTests(config)` / `resetAskDbRuntimeForTests()` — test helpers: install an authored `AskDbConfig` as `bootstrapAskDbEnv()` installs a loaded file, without reading the disk, and remove it.
 
 ## License
 

package/dist/ai-env.d.ts

@@ -0,0 +1,31 @@
+import type { AskDbAiReasoningConfig } from "./types.js";
+/** Every setting a built-in provider connection can carry, besides its name. */
+export declare const CONNECTION_FIELDS: readonly ["apiKey", "secondaryApiKey", "resourceName", "baseUrl", "apiVersion"];
+export type ConnectionSettings = {
+    [Field in (typeof CONNECTION_FIELDS)[number]]?: string;
+};
+/** A provider connection after resolution: its settings, trimmed, plus its name. */
+export type NormalizedAiConnection = ConnectionSettings & {
+    name: string;
+};
+/** Writes `value`, trimmed, under `key` unless it's unset or blank. */
+export declare function setEnvKey(out: Record<string, string>, key: string, value: string | undefined): void;
+/** The `ai.language` section as the env view needs it. */
+export type AiLanguageEnvSection = {
+    provider: string;
+    connection: NormalizedAiConnection;
+    model: string | undefined;
+    modelFamily: string | undefined;
+    reasoning: AskDbAiReasoningConfig | undefined;
+};
+/** The `ai.embedding` section as the env view needs it. */
+export type AiEmbeddingEnvSection = {
+    provider: string;
+    connection: NormalizedAiConnection;
+    model: string;
+};
+/** The env view of `ai.language`: its provider, its connection only, its model and reasoning. */
+export declare function aiLanguageEnv(section: AiLanguageEnvSection): Record<string, string>;
+/** The env view of `ai.embedding`: its provider, its connection only, and its model. Nothing from the language side. */
+export declare function aiEmbeddingEnv(section: AiEmbeddingEnvSection): Record<string, string>;
+//# sourceMappingURL=ai-env.d.ts.map

package/dist/ai-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-env.d.ts","sourceRoot":"","sources":["../src/ai-env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,gFAAgF;AAChF,eAAO,MAAM,iBAAiB,iFAAkF,CAAC;AAEjH,MAAM,MAAM,kBAAkB,GAAG;KAAG,KAAK,IAAI,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM;CAAE,CAAC;AAE5F,oFAAoF;AACpF,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3E,uEAAuE;AACvE,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAKnG;AAuCD,0DAA0D;AAC1D,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,sBAAsB,CAAC;IACnC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAC/C,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,sBAAsB,CAAC;IACnC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAwBF,iGAAiG;AACjG,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOnF;AAED,wHAAwH;AACxH,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMrF"}

package/dist/ai-env.js

@@ -0,0 +1,88 @@
+/** Every setting a built-in provider connection can carry, besides its name. */
+export const CONNECTION_FIELDS = ["apiKey", "secondaryApiKey", "resourceName", "baseUrl", "apiVersion"];
+/** Writes `value`, trimmed, under `key` unless it's unset or blank. */
+export function setEnvKey(out, key, value) {
+    if (value === undefined)
+        return;
+    const t = value.trim();
+    if (t === "")
+        return;
+    out[key] = t;
+}
+/** Writes a connection's settings under the env keys `provider`'s `@askdb/ai` adapter reads. */
+function applyAiConnection(out, provider, connection) {
+    switch (provider) {
+        case "openai":
+            setEnvKey(out, "OPENAI_API_KEY", connection.apiKey);
+            setEnvKey(out, "OPENAI_BASE_URL", connection.baseUrl);
+            return;
+        case "anthropic":
+            setEnvKey(out, "ANTHROPIC_API_KEY", connection.apiKey);
+            setEnvKey(out, "ANTHROPIC_BASE_URL", connection.baseUrl);
+            return;
+        case "google":
+            setEnvKey(out, "GOOGLE_GENERATIVE_AI_API_KEY", connection.apiKey);
+            setEnvKey(out, "GOOGLE_AI_BASE_URL", connection.baseUrl);
+            return;
+        case "gateway":
+            setEnvKey(out, "AI_GATEWAY_API_KEY", connection.apiKey);
+            setEnvKey(out, "ASKDB_AI_BASE_URL", connection.baseUrl);
+            return;
+        case "azure":
+        case "foundry":
+            // `@askdb/core` treats `foundry` like Azure for env parsing.
+            setEnvKey(out, "AZURE_OPENAI_API_KEY", connection.apiKey);
+            setEnvKey(out, "AZURE_OPENAI_API_KEY_SECONDARY", connection.secondaryApiKey);
+            setEnvKey(out, "ASKDB_AI_AZURE_RESOURCE_NAME", connection.resourceName);
+            setEnvKey(out, "AZURE_OPENAI_BASE_URL", connection.baseUrl);
+            setEnvKey(out, "AZURE_OPENAI_API_VERSION", connection.apiVersion);
+            return;
+        default:
+            // Custom/third-party provider: the universal ASKDB_AI_* keys that @askdb/ai's
+            // resolveBaseConfig honors for every registered adapter. Works end to end only when the
+            // host registry contains an adapter with this provider name.
+            setEnvKey(out, "ASKDB_AI_API_KEY", connection.apiKey);
+            setEnvKey(out, "ASKDB_AI_BASE_URL", connection.baseUrl);
+    }
+}
+function applyLanguageModel(out, section) {
+    const { provider, model } = section;
+    if (provider === "openai") {
+        setEnvKey(out, "OPENAI_MODEL", model);
+        setEnvKey(out, "ASKDB_MODEL", model);
+    }
+    else if (provider === "azure" || provider === "foundry") {
+        setEnvKey(out, "AZURE_OPENAI_DEPLOYMENT", model);
+        setEnvKey(out, "AZURE_DEPLOYMENT_NAME", model);
+        setEnvKey(out, "ASKDB_AI_MODEL", model);
+        setEnvKey(out, "ASKDB_AI_AZURE_MODEL_FAMILY", section.modelFamily);
+    }
+    else {
+        setEnvKey(out, "ASKDB_AI_MODEL", model);
+    }
+}
+function applyReasoningAi(out, reasoning) {
+    if (!reasoning)
+        return;
+    setEnvKey(out, "ASKDB_AI_REASONING_EFFORT", reasoning.effort);
+    setEnvKey(out, "ASKDB_AI_REASONING_EFFORT_NL_TO_SQL", reasoning.nlToSql);
+    setEnvKey(out, "ASKDB_AI_REASONING_EFFORT_ENRICHMENT", reasoning.enrichment);
+}
+/** The env view of `ai.language`: its provider, its connection only, its model and reasoning. */
+export function aiLanguageEnv(section) {
+    const out = {};
+    setEnvKey(out, "ASKDB_AI_PROVIDER", section.provider);
+    applyAiConnection(out, section.provider, section.connection);
+    applyLanguageModel(out, section);
+    applyReasoningAi(out, section.reasoning);
+    return out;
+}
+/** The env view of `ai.embedding`: its provider, its connection only, and its model. Nothing from the language side. */
+export function aiEmbeddingEnv(section) {
+    const out = {};
+    setEnvKey(out, "ASKDB_AI_PROVIDER", section.provider);
+    applyAiConnection(out, section.provider, section.connection);
+    setEnvKey(out, "ASKDB_AI_EMBEDDING_MODEL", section.model);
+    return out;
+}
+//# sourceMappingURL=ai-env.js.map

package/dist/ai-env.js.map

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

package/dist/defaults.d.ts

@@ -1,6 +1,5 @@
 /**
- * Canonical defaults applied in {@link flattenAskDbConfig} when optional env-backed
- * fields are unset (missing, blank, or invalid after trim).
+ * Defaults the config resolver (`resolve.ts`) fills in when an optional field is unset.
  */
 export declare const DEFAULT_OPENAI_LANGUAGE_MODEL = "gpt-4o-mini";
 /** @deprecated Use DEFAULT_OPENAI_LANGUAGE_MODEL. Removed at 1.0. */
@@ -28,16 +27,12 @@ export declare const MAX_HTTP_API_REQUEST_TIMEOUT_MS = 2147483647;
  * model a legacy `rag.embedder: "openai"` config translates to. Removed at 1.0.
  */
 export declare const DEFAULT_RAG_EMBEDDING_MODEL = "text-embedding-3-small";
-/** Under the same visible tree as {@link DEFAULT_INTROSPECT_OUTPUT_DIR} (`./askdb/…`). */
-export declare const DEFAULT_RAG_FILE_BASE_PATH = "./askdb/rag";
 export declare const DEFAULT_MOCK_RAG_EMBEDDING_DIMENSIONS = 64;
 export declare const DEFAULT_PGVECTOR_INDEX_STRATEGY: "hnsw";
 /** Default per-query statement timeout for Studio execute (`studio.execute.timeoutMs`). */
 export declare const DEFAULT_STUDIO_EXECUTE_TIMEOUT_MS = 30000;
 /** Default row cap for Studio execute results (`studio.execute.maxRows`). */
 export declare const DEFAULT_STUDIO_EXECUTE_MAX_ROWS = 500;
-export declare const PGVECTOR_INDEX_STRATEGIES: readonly ["ivfflat", "hnsw", "none"];
-export type PgvectorIndexStrategyId = (typeof PGVECTOR_INDEX_STRATEGIES)[number];
 /**
  * The width earlier versions assumed for an embedding model: 3072 for `text-embedding-3-large`,
  * else 1536, whatever the provider.
@@ -46,12 +41,4 @@ export type PgvectorIndexStrategyId = (typeof PGVECTOR_INDEX_STRATEGIES)[number]
  * (`detectEmbeddingDimensions` in `@askdb/rag`). Removed at 1.0.
  */
 export declare function defaultRagEmbeddingDimensions(model: string): number;
-export declare function parsePositiveInteger(value: string | number | undefined): number | undefined;
-/**
- * Parse `httpApi.requestTimeoutMs` (or its flat key `ASKDB_HTTP_REQUEST_TIMEOUT_MS`).
- * Returns `undefined` when unset; throws naming `source` unless the value is a positive
- * integer no larger than {@link MAX_HTTP_API_REQUEST_TIMEOUT_MS}.
- */
-export declare function parseHttpApiRequestTimeoutMs(value: string | number | undefined, source: string): number | undefined;
-export declare function normalizePgvectorIndexStrategy(raw: string | undefined): PgvectorIndexStrategyId;
 //# sourceMappingURL=defaults.d.ts.map

package/dist/defaults.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,6BAA6B,gBAAgB,CAAC;AAC3D,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,gBAAgC,CAAC;AACvE,eAAO,MAAM,+BAA+B,gBAAgB,CAAC;AAC7D,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AACpE,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,sBAAmC,CAAC;AAC7E,eAAO,MAAM,6BAA6B,qBAAqB,CAAC;AAChE,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,qBAAgC,CAAC;AACvE,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AACnE,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,uBAAiC,CAAC;AACzE,eAAO,MAAM,6BAA6B,aAAa,CAAC;AACxD,iGAAiG;AACjG,eAAO,MAAM,mCAAmC,QAAS,CAAC;AAC1D;;;GAGG;AACH,eAAO,MAAM,+BAA+B,aAAgB,CAAC;AAC7D;;;GAGG;AACH,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,0FAA0F;AAC1F,eAAO,MAAM,0BAA0B,gBAAgB,CAAC;AACxD,eAAO,MAAM,qCAAqC,KAAK,CAAC;AACxD,eAAO,MAAM,+BAA+B,EAAG,MAAe,CAAC;AAC/D,2FAA2F;AAC3F,eAAO,MAAM,iCAAiC,QAAS,CAAC;AACxD,6EAA6E;AAC7E,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD,eAAO,MAAM,yBAAyB,sCAAuC,CAAC;AAC9E,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAU3F;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUnH;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,uBAAuB,CAO/F"}
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,6BAA6B,gBAAgB,CAAC;AAC3D,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,gBAAgC,CAAC;AACvE,eAAO,MAAM,+BAA+B,gBAAgB,CAAC;AAC7D,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AACpE,wEAAwE;AACxE,eAAO,MAAM,4BAA4B,sBAAmC,CAAC;AAC7E,eAAO,MAAM,6BAA6B,qBAAqB,CAAC;AAChE,qEAAqE;AACrE,eAAO,MAAM,yBAAyB,qBAAgC,CAAC;AACvE,eAAO,MAAM,8BAA8B,uBAAuB,CAAC;AACnE,sEAAsE;AACtE,eAAO,MAAM,0BAA0B,uBAAiC,CAAC;AACzE,eAAO,MAAM,6BAA6B,aAAa,CAAC;AACxD,iGAAiG;AACjG,eAAO,MAAM,mCAAmC,QAAS,CAAC;AAC1D;;;GAGG;AACH,eAAO,MAAM,+BAA+B,aAAgB,CAAC;AAC7D;;;GAGG;AACH,eAAO,MAAM,2BAA2B,2BAA2B,CAAC;AACpE,eAAO,MAAM,qCAAqC,KAAK,CAAC;AACxD,eAAO,MAAM,+BAA+B,EAAG,MAAe,CAAC;AAC/D,2FAA2F;AAC3F,eAAO,MAAM,iCAAiC,QAAS,CAAC;AACxD,6EAA6E;AAC7E,eAAO,MAAM,+BAA+B,MAAM,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnE"}

package/dist/defaults.js

@@ -1,6 +1,5 @@
 /**
- * Canonical defaults applied in {@link flattenAskDbConfig} when optional env-backed
- * fields are unset (missing, blank, or invalid after trim).
+ * Defaults the config resolver (`resolve.ts`) fills in when an optional field is unset.
  */
 export const DEFAULT_OPENAI_LANGUAGE_MODEL = "gpt-4o-mini";
 /** @deprecated Use DEFAULT_OPENAI_LANGUAGE_MODEL. Removed at 1.0. */
@@ -28,15 +27,12 @@ export const MAX_HTTP_API_REQUEST_TIMEOUT_MS = 2_147_483_647;
  * model a legacy `rag.embedder: "openai"` config translates to. Removed at 1.0.
  */
 export const DEFAULT_RAG_EMBEDDING_MODEL = "text-embedding-3-small";
-/** Under the same visible tree as {@link DEFAULT_INTROSPECT_OUTPUT_DIR} (`./askdb/…`). */
-export const DEFAULT_RAG_FILE_BASE_PATH = "./askdb/rag";
 export const DEFAULT_MOCK_RAG_EMBEDDING_DIMENSIONS = 64;
 export const DEFAULT_PGVECTOR_INDEX_STRATEGY = "hnsw";
 /** Default per-query statement timeout for Studio execute (`studio.execute.timeoutMs`). */
 export const DEFAULT_STUDIO_EXECUTE_TIMEOUT_MS = 30_000;
 /** Default row cap for Studio execute results (`studio.execute.maxRows`). */
 export const DEFAULT_STUDIO_EXECUTE_MAX_ROWS = 500;
-export const PGVECTOR_INDEX_STRATEGIES = ["ivfflat", "hnsw", "none"];
 /**
  * The width earlier versions assumed for an embedding model: 3072 for `text-embedding-3-large`,
  * else 1536, whatever the provider.
@@ -47,41 +43,4 @@ export const PGVECTOR_INDEX_STRATEGIES = ["ivfflat", "hnsw", "none"];
 export function defaultRagEmbeddingDimensions(model) {
     return model.trim() === "text-embedding-3-large" ? 3072 : 1536;
 }
-export function parsePositiveInteger(value) {
-    if (value === undefined)
-        return undefined;
-    if (typeof value === "number") {
-        return Number.isInteger(value) && value > 0 ? value : undefined;
-    }
-    const t = value.trim();
-    if (t === "")
-        return undefined;
-    const n = Number(t);
-    if (!Number.isInteger(n) || n <= 0)
-        return undefined;
-    return n;
-}
-/**
- * Parse `httpApi.requestTimeoutMs` (or its flat key `ASKDB_HTTP_REQUEST_TIMEOUT_MS`).
- * Returns `undefined` when unset; throws naming `source` unless the value is a positive
- * integer no larger than {@link MAX_HTTP_API_REQUEST_TIMEOUT_MS}.
- */
-export function parseHttpApiRequestTimeoutMs(value, source) {
-    if (value === undefined)
-        return undefined;
-    // A JavaScript config can pass any type; only numbers and numeric strings are parsed.
-    const n = typeof value === "number" || typeof value === "string" ? parsePositiveInteger(value) : undefined;
-    if (n === undefined || n > MAX_HTTP_API_REQUEST_TIMEOUT_MS) {
-        throw new Error(`askdb.config: invalid ${source} ${JSON.stringify(value)} (expected a positive integer number of milliseconds, at most ${MAX_HTTP_API_REQUEST_TIMEOUT_MS}).`);
-    }
-    return n;
-}
-export function normalizePgvectorIndexStrategy(raw) {
-    if (raw === undefined || raw.trim() === "")
-        return DEFAULT_PGVECTOR_INDEX_STRATEGY;
-    const v = raw.trim().toLowerCase();
-    if (v === "ivfflat" || v === "hnsw" || v === "none")
-        return v;
-    throw new Error(`askdb.config: invalid rag.storeConfig.pgvector.indexStrategy "${raw}" (expected one of: ivfflat, hnsw, none).`);
-}
 //# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -1 +1 @@
-{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,aAAa,CAAC;AAC3D,qEAAqE;AACrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AACvE,MAAM,CAAC,MAAM,+BAA+B,GAAG,aAAa,CAAC;AAC7D,MAAM,CAAC,MAAM,gCAAgC,GAAG,mBAAmB,CAAC;AACpE,wEAAwE;AACxE,MAAM,CAAC,MAAM,4BAA4B,GAAG,gCAAgC,CAAC;AAC7E,MAAM,CAAC,MAAM,6BAA6B,GAAG,kBAAkB,CAAC;AAChE,qEAAqE;AACrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,6BAA6B,CAAC;AACvE,MAAM,CAAC,MAAM,8BAA8B,GAAG,oBAAoB,CAAC;AACnE,sEAAsE;AACtE,MAAM,CAAC,MAAM,0BAA0B,GAAG,8BAA8B,CAAC;AACzE,MAAM,CAAC,MAAM,6BAA6B,GAAG,UAAU,CAAC;AACxD,iGAAiG;AACjG,MAAM,CAAC,MAAM,mCAAmC,GAAG,MAAM,CAAC;AAC1D;;;GAGG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,aAAa,CAAC;AAC7D;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AACpE,MAAM,CAAC,MAAM,qCAAqC,GAAG,EAAE,CAAC;AACxD,MAAM,CAAC,MAAM,+BAA+B,GAAG,MAAe,CAAC;AAC/D,2FAA2F;AAC3F,MAAM,CAAC,MAAM,iCAAiC,GAAG,MAAM,CAAC;AACxD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAa;IACzD,OAAO,KAAK,CAAC,IAAI,EAAE,KAAK,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AACjE,CAAC"}

package/dist/index.d.ts

@@ -5,14 +5,14 @@ export type { BootstrapAskDbEnvOptions } from "./bootstrap.js";
 export { env, requiredEnv } from "./env.js";
 export { isAskDbDebugEnabled } from "./diagnostics.js";
 export { getAskDbRuntimeConfig, } from "./runtime-config.js";
-export type { AskDbRuntimeConfig, AskDbRuntimeAiConfig, AskDbRuntimeAiSection, AskDbRuntimeIntrospectionConfig, AskDbRuntimeRagConfig, AskDbRuntimeRagEmbedderConfig, AskDbRuntimeLoggingConfig, AskDbRuntimeHttpApiConfig, AskDbRuntimeDevConfig, AskDbRuntimeModesConfig, AskDbRuntimeNlToSqlConfig, AskDbRuntimeStudioConfig, } from "./runtime-config.js";
+export type { AskDbRuntimeConfig, AskDbRuntimeAiConfig, AskDbRuntimeAiSection, AskDbRuntimeIntrospectionConfig, AskDbRuntimeRagConfig, AskDbRuntimeRagEmbedderConfig, AskDbRuntimeLoggingConfig, AskDbRuntimeHttpApiConfig, AskDbRuntimeDevConfig, AskDbRuntimeModesConfig, AskDbRuntimeNlToSqlConfig, AskDbRuntimeStudioConfig, } from "./runtime-types.js";
 export { isAskDbRuntimeInitialized, mergeAskDbFlatIntoEnvMap, resetAskDbRuntimeForTests, setAskDbRuntimeForTests, } from "./runtime-store.js";
-export { DEFAULT_ANTHROPIC_CHAT_MODEL, DEFAULT_ANTHROPIC_LANGUAGE_MODEL, DEFAULT_AZURE_OPENAI_DEPLOYMENT, DEFAULT_GATEWAY_CHAT_MODEL, DEFAULT_GATEWAY_LANGUAGE_MODEL, DEFAULT_GOOGLE_CHAT_MODEL, DEFAULT_GOOGLE_LANGUAGE_MODEL, DEFAULT_HTTP_API_REQUEST_TIMEOUT_MS, DEFAULT_INTROSPECT_OUTPUT_DIR, DEFAULT_MOCK_RAG_EMBEDDING_DIMENSIONS, DEFAULT_OPENAI_CHAT_MODEL, DEFAULT_OPENAI_LANGUAGE_MODEL, DEFAULT_PGVECTOR_INDEX_STRATEGY, DEFAULT_RAG_EMBEDDING_MODEL, DEFAULT_RAG_FILE_BASE_PATH, DEFAULT_STUDIO_EXECUTE_MAX_ROWS, DEFAULT_STUDIO_EXECUTE_TIMEOUT_MS, defaultRagEmbeddingDimensions, } from "./defaults.js";
+export { DEFAULT_ANTHROPIC_CHAT_MODEL, DEFAULT_ANTHROPIC_LANGUAGE_MODEL, DEFAULT_AZURE_OPENAI_DEPLOYMENT, DEFAULT_GATEWAY_CHAT_MODEL, DEFAULT_GATEWAY_LANGUAGE_MODEL, DEFAULT_GOOGLE_CHAT_MODEL, DEFAULT_GOOGLE_LANGUAGE_MODEL, DEFAULT_HTTP_API_REQUEST_TIMEOUT_MS, DEFAULT_INTROSPECT_OUTPUT_DIR, DEFAULT_MOCK_RAG_EMBEDDING_DIMENSIONS, DEFAULT_OPENAI_CHAT_MODEL, DEFAULT_OPENAI_LANGUAGE_MODEL, DEFAULT_PGVECTOR_INDEX_STRATEGY, DEFAULT_RAG_EMBEDDING_MODEL, DEFAULT_STUDIO_EXECUTE_MAX_ROWS, DEFAULT_STUDIO_EXECUTE_TIMEOUT_MS, defaultRagEmbeddingDimensions, } from "./defaults.js";
 export { defineConfig, isAskDbEnvProjection, ASKDB_ENV_PROJECTION } from "./projection.js";
 export type { AskDbEnvProjection } from "./projection.js";
 export { loadAskDbConfigProjection, loadAskDbConfigProjectionSync } from "./load-merge.js";
 export type { AskDbConfig, AskDbAiConfig, AskDbAiLanguageConfig, AskDbAiEmbeddingConfig, AskDbAiReasoningConfig, AiProviderConnections, AiConnections, AiNamedConnection, OpenaiConnection, AzureConnection, FoundryConnection, AnthropicConnection, GoogleConnection, GatewayConnection, CustomConnection, OpenaiAiConfig, AzureAiConfig, FoundryAiConfig, AnthropicAiConfig, GoogleAiConfig, GatewayAiConfig, OpenaiConfig, AzureConfig, FoundryConfig, AnthropicConfig, GoogleConfig, GatewayConfig, AskDbIntrospectionConfig, PostgresIntrospectionConfig, PrismaIntrospectionConfig, OpenaiRagEmbedderConfig, FileStoreConfig, MemoryStoreConfig, PgvectorStoreConfig, } from "./types.js";
-export { flattenAskDbConfig } from "./flatten.js";
+export { flattenAskDbConfig } from "./projection.js";
 export { ASKDB_MODES_V1, ASKDB_LOG_LEVELS, ASKDB_RAG_EMBEDDERS, ASKDB_RAG_STORES, ASKDB_AI_PROVIDERS, ASKDB_INTROSPECTION_PROVIDERS, ASKDB_DIALECTS, ASKDB_STUDIO_EXECUTE_PROVIDERS, ASKDB_REASONING_EFFORTS, } from "./constants.js";
 export type { AskDbModeV1, AskDbLogLevel, AskDbRagEmbedder, AskDbRagStore, AskDbAiProviderId, AskDbIntrospectionProvider, AskDbDialectId, AskDbStudioExecuteProvider, AskDbReasoningEffort, } from "./constants.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC3F,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,+BAA+B,EAC/B,0BAA0B,EAC1B,8BAA8B,EAC9B,yBAAyB,EACzB,6BAA6B,EAC7B,mCAAmC,EACnC,6BAA6B,EAC7B,qCAAqC,EACrC,yBAAyB,EACzB,6BAA6B,EAC7B,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,+BAA+B,EAC/B,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EACV,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EACd,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAC3F,YAAY,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC1E,YAAY,EAAE,wBAAwB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,6BAA6B,EAC7B,yBAAyB,EACzB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,EACzB,wBAAwB,GACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,+BAA+B,EAC/B,0BAA0B,EAC1B,8BAA8B,EAC9B,yBAAyB,EACzB,6BAA6B,EAC7B,mCAAmC,EACnC,6BAA6B,EAC7B,qCAAqC,EACrC,yBAAyB,EACzB,6BAA6B,EAC7B,+BAA+B,EAC/B,2BAA2B,EAC3B,+BAA+B,EAC/B,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAC3F,YAAY,EACV,WAAW,EACX,aAAa,EACb,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,qBAAqB,EACrB,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,WAAW,EACX,aAAa,EACb,eAAe,EACf,YAAY,EACZ,aAAa,EACb,wBAAwB,EACxB,2BAA2B,EAC3B,yBAAyB,EACzB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EACd,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,0BAA0B,EAC1B,cAAc,EACd,0BAA0B,EAC1B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -4,9 +4,9 @@ export { env, requiredEnv } from "./env.js";
 export { isAskDbDebugEnabled } from "./diagnostics.js";
 export { getAskDbRuntimeConfig, } from "./runtime-config.js";
 export { isAskDbRuntimeInitialized, mergeAskDbFlatIntoEnvMap, resetAskDbRuntimeForTests, setAskDbRuntimeForTests, } from "./runtime-store.js";
-export { DEFAULT_ANTHROPIC_CHAT_MODEL, DEFAULT_ANTHROPIC_LANGUAGE_MODEL, DEFAULT_AZURE_OPENAI_DEPLOYMENT, DEFAULT_GATEWAY_CHAT_MODEL, DEFAULT_GATEWAY_LANGUAGE_MODEL, DEFAULT_GOOGLE_CHAT_MODEL, DEFAULT_GOOGLE_LANGUAGE_MODEL, DEFAULT_HTTP_API_REQUEST_TIMEOUT_MS, DEFAULT_INTROSPECT_OUTPUT_DIR, DEFAULT_MOCK_RAG_EMBEDDING_DIMENSIONS, DEFAULT_OPENAI_CHAT_MODEL, DEFAULT_OPENAI_LANGUAGE_MODEL, DEFAULT_PGVECTOR_INDEX_STRATEGY, DEFAULT_RAG_EMBEDDING_MODEL, DEFAULT_RAG_FILE_BASE_PATH, DEFAULT_STUDIO_EXECUTE_MAX_ROWS, DEFAULT_STUDIO_EXECUTE_TIMEOUT_MS, defaultRagEmbeddingDimensions, } from "./defaults.js";
+export { DEFAULT_ANTHROPIC_CHAT_MODEL, DEFAULT_ANTHROPIC_LANGUAGE_MODEL, DEFAULT_AZURE_OPENAI_DEPLOYMENT, DEFAULT_GATEWAY_CHAT_MODEL, DEFAULT_GATEWAY_LANGUAGE_MODEL, DEFAULT_GOOGLE_CHAT_MODEL, DEFAULT_GOOGLE_LANGUAGE_MODEL, DEFAULT_HTTP_API_REQUEST_TIMEOUT_MS, DEFAULT_INTROSPECT_OUTPUT_DIR, DEFAULT_MOCK_RAG_EMBEDDING_DIMENSIONS, DEFAULT_OPENAI_CHAT_MODEL, DEFAULT_OPENAI_LANGUAGE_MODEL, DEFAULT_PGVECTOR_INDEX_STRATEGY, DEFAULT_RAG_EMBEDDING_MODEL, DEFAULT_STUDIO_EXECUTE_MAX_ROWS, DEFAULT_STUDIO_EXECUTE_TIMEOUT_MS, defaultRagEmbeddingDimensions, } from "./defaults.js";
 export { defineConfig, isAskDbEnvProjection, ASKDB_ENV_PROJECTION } from "./projection.js";
 export { loadAskDbConfigProjection, loadAskDbConfigProjectionSync } from "./load-merge.js";
-export { flattenAskDbConfig } from "./flatten.js";
+export { flattenAskDbConfig } from "./projection.js";
 export { ASKDB_MODES_V1, ASKDB_LOG_LEVELS, ASKDB_RAG_EMBEDDERS, ASKDB_RAG_STORES, ASKDB_AI_PROVIDERS, ASKDB_INTROSPECTION_PROVIDERS, ASKDB_DIALECTS, ASKDB_STUDIO_EXECUTE_PROVIDERS, ASKDB_REASONING_EFFORTS, } from "./constants.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAe7B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,+BAA+B,EAC/B,0BAA0B,EAC1B,8BAA8B,EAC9B,yBAAyB,EACzB,6BAA6B,EAC7B,mCAAmC,EACnC,6BAA6B,EAC7B,qCAAqC,EACrC,yBAAyB,EACzB,6BAA6B,EAC7B,+BAA+B,EAC/B,2BAA2B,EAC3B,0BAA0B,EAC1B,+BAA+B,EAC/B,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE3F,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAqC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EACd,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iCAAiC,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAE3F,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EACL,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAe7B,OAAO,EACL,yBAAyB,EACzB,wBAAwB,EACxB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,+BAA+B,EAC/B,0BAA0B,EAC1B,8BAA8B,EAC9B,yBAAyB,EACzB,6BAA6B,EAC7B,mCAAmC,EACnC,6BAA6B,EAC7B,qCAAqC,EACrC,yBAAyB,EACzB,6BAA6B,EAC7B,+BAA+B,EAC/B,2BAA2B,EAC3B,+BAA+B,EAC/B,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,YAAY,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAE3F,OAAO,EAAE,yBAAyB,EAAE,6BAA6B,EAAE,MAAM,iBAAiB,CAAC;AAqC3F,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,6BAA6B,EAC7B,cAAc,EACd,8BAA8B,EAC9B,uBAAuB,GACxB,MAAM,gBAAgB,CAAC"}

package/dist/load-merge.js

@@ -1,7 +1,7 @@
 import { createJiti } from "jiti";
 import { pathToFileURL } from "node:url";
 import { discoverAskDbConfigPath } from "./discover.js";
-import { isPlainObject } from "./normalize.js";
+import { isPlainObject } from "./resolve.js";
 import { defineConfig, isAskDbEnvProjection } from "./projection.js";
 const CONFIG_FORMS = 'export default { ... } or defineConfig({ ... }) from "@askdb/config"';
 /**

package/dist/load-merge.js.map

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

package/dist/projection.d.ts

@@ -29,5 +29,11 @@ export type AskDbEnvProjection = {
  * Throws an `askdb.config: …` error for a config that can't load.
  */
 export declare function defineConfig<const T extends AskDbConfig>(config: T): AskDbEnvProjection;
+/**
+ * Flattens a nested {@link AskDbConfig} into the canonical env keys of the runtime snapshot
+ * (`AskDbEnvProjection.entries`), for example to build a child process's env. An optional key is
+ * written only when the config sets it. Throws the same `askdb.config: …` errors as `defineConfig`.
+ */
+export declare function flattenAskDbConfig(config: AskDbConfig): Record<string, string>;
 export declare function isAskDbEnvProjection(value: unknown): value is AskDbEnvProjection;
 //# sourceMappingURL=projection.d.ts.map

package/dist/projection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,eAAO,MAAM,oBAAoB,eAAoC,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IACtC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,kBAAkB,CAQvF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAYhF"}
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG9C,eAAO,MAAM,oBAAoB,eAAoC,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;IACtC,iFAAiF;IACjF,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD;;;OAGG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC3C,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,MAAM,EAAE,CAAC,GAAG,kBAAkB,CAQvF;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAE9E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAYhF"}

package/dist/projection.js

@@ -1,5 +1,4 @@
-import { flattenNormalizedAskDbConfig } from "./flatten.js";
-import { normalizeAskDbConfig } from "./normalize.js";
+import { resolveAskDbConfig } from "./resolve.js";
 export const ASKDB_ENV_PROJECTION = Symbol.for("askdb.envProjection");
 /**
  * Wraps a nested {@link AskDbConfig} for bootstrap merge. Check the object with TypeScript’s
@@ -19,14 +18,22 @@ export const ASKDB_ENV_PROJECTION = Symbol.for("askdb.envProjection");
  * Throws an `askdb.config: …` error for a config that can't load.
  */
 export function defineConfig(config) {
-    const { config: normalized, deprecations } = normalizeAskDbConfig(config);
+    const { flat, deprecations } = resolveAskDbConfig(config);
     return {
         [ASKDB_ENV_PROJECTION]: true,
         config,
-        entries: flattenNormalizedAskDbConfig(normalized),
+        entries: flat,
         deprecations,
     };
 }
+/**
+ * Flattens a nested {@link AskDbConfig} into the canonical env keys of the runtime snapshot
+ * (`AskDbEnvProjection.entries`), for example to build a child process's env. An optional key is
+ * written only when the config sets it. Throws the same `askdb.config: …` errors as `defineConfig`.
+ */
+export function flattenAskDbConfig(config) {
+    return resolveAskDbConfig(config).flat;
+}
 export function isAskDbEnvProjection(value) {
     return (typeof value === "object" &&
         value !== null &&

package/dist/projection.js.map

@@ -1 +1 @@
-{"version":3,"file":"projection.js","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AActE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAA8B,MAAS;IACjE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC1E,OAAO;QACL,CAAC,oBAAoB,CAAC,EAAE,IAAI;QAC5B,MAAM;QACN,OAAO,EAAE,4BAA4B,CAAC,UAAU,CAAC;QACjD,YAAY;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,oBAAoB,IAAI,KAAK;QAC5B,KAA4B,CAAC,oBAAoB,CAAC,KAAK,IAAI;QAC5D,OAAQ,KAA4B,CAAC,OAAO,KAAK,QAAQ;QACxD,KAA4B,CAAC,OAAO,KAAK,IAAI;QAC9C,QAAQ,IAAI,KAAK;QACjB,OAAQ,KAA4B,CAAC,MAAM,KAAK,QAAQ;QACvD,KAA4B,CAAC,MAAM,KAAK,IAAI,CAC9C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../src/projection.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,CAAC,MAAM,oBAAoB,GAAG,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AActE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,YAAY,CAA8B,MAAS;IACjE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC1D,OAAO;QACL,CAAC,oBAAoB,CAAC,EAAE,IAAI;QAC5B,MAAM;QACN,OAAO,EAAE,IAAI;QACb,YAAY;KACb,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO,kBAAkB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,oBAAoB,IAAI,KAAK;QAC5B,KAA4B,CAAC,oBAAoB,CAAC,KAAK,IAAI;QAC5D,OAAQ,KAA4B,CAAC,OAAO,KAAK,QAAQ;QACxD,KAA4B,CAAC,OAAO,KAAK,IAAI;QAC9C,QAAQ,IAAI,KAAK;QACjB,OAAQ,KAA4B,CAAC,MAAM,KAAK,QAAQ;QACvD,KAA4B,CAAC,MAAM,KAAK,IAAI,CAC9C,CAAC;AACJ,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,36 @@
+import type { AskDbRuntimeConfig, AskDbRuntimeAiConfig } from "./runtime-types.js";
+import type { AskDbConfig } from "./types.js";
+/**
+ * The config resolver: the one place that checks, translates and defaults every `askdb.config`
+ * setting. Each setting's runtime value and its flat-map key come out of the same pass, so
+ * `defineConfig` and `getAskDbRuntimeConfig` agree, and `@askdb/config` never reads a setting
+ * back from a flat map.
+ */
+/**
+ * Every {@link AskDbRuntimeConfig} section, checked, translated and defaulted. Not `structured`,
+ * `flat` or `ai.aiEnv`, which is built from `flat`.
+ */
+export type ResolvedAskDbConfig = Omit<AskDbRuntimeConfig, "structured" | "flat" | "ai" | "deprecations"> & {
+    ai: Omit<AskDbRuntimeAiConfig, "aiEnv">;
+};
+export declare function isMember<T extends readonly string[]>(value: unknown, allowed: T): value is T[number];
+/**
+ * A plain `{ ... }` object: not null, an array, a Promise or a module namespace. Read through
+ * `Object.prototype.toString`, so an object from another realm still counts.
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/** What {@link resolveAskDbConfig} returns. */
+export type AskDbConfigResolution = {
+    resolved: ResolvedAskDbConfig;
+    /** The flat map: each setting's canonical env key, written in the same pass that checks it. */
+    flat: Record<string, string>;
+    deprecations: string[];
+};
+/**
+ * Resolves every setting of an authored config: checks it, translates deprecated keys and fills in
+ * defaults, and writes its flat key. Pure: it reads no environment. Returns one deprecation
+ * message per legacy key in use. Throws `askdb.config: …` errors that name the config key for a
+ * config that can't load (the loader adds the file name).
+ */
+export declare function resolveAskDbConfig(config: AskDbConfig): AskDbConfigResolution;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAmCA,OAAO,KAAK,EACV,kBAAkB,EAKlB,oBAAoB,EAGrB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAA0B,WAAW,EAAE,MAAM,YAAY,CAAC;AAEtE;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,IAAI,CAAC,kBAAkB,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,GAAG,cAAc,CAAC,GAAG;IAC1G,EAAE,EAAE,IAAI,CAAC,oBAAoB,EAAE,OAAO,CAAC,CAAC;CACzC,CAAC;AAkEF,wBAAgB,QAAQ,CAAC,CAAC,SAAS,SAAS,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,MAAM,CAAC,CAEpG;AAMD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE9E;AAo3BD,+CAA+C;AAC/C,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,+FAA+F;IAC/F,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,qBAAqB,CA6B7E"}