@askdb/config 1.0.0-beta.11 → 1.0.0-beta.13

package/dist/runtime-config.js

@@ -1,6 +1,25 @@
 import { ASKDB_STUDIO_EXECUTE_PROVIDERS } from "./constants.js";
-import { DEFAULT_INTROSPECT_OUTPUT_DIR } from "./defaults.js";
+import { DEFAULT_HTTP_API_REQUEST_TIMEOUT_MS, DEFAULT_INTROSPECT_OUTPUT_DIR, DEFAULT_STUDIO_EXECUTE_MAX_ROWS, DEFAULT_STUDIO_EXECUTE_TIMEOUT_MS, 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);
+    }
+    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() === "")
@@ -13,15 +32,26 @@ function pickFlat(flat, key) {
 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 = logStdoutRaw !== undefined && ["1", "true", "yes"].includes(logStdoutRaw.toLowerCase());
+    const logStdout = isTruthyFlag(logStdoutRaw);
     const portRaw = pickFlat(flat, "PORT");
     const portParsed = portRaw !== undefined ? Number(portRaw) : NaN;
     const port = structured.httpApi?.listen?.port ??
         (!Number.isNaN(portParsed) ? portParsed : 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 = omitRaw !== undefined && ["1", "true", "yes"].includes(omitRaw.toLowerCase());
+    const omitFromFlat = isTruthyFlag(omitRaw);
     const prismaSchemaPathRaw = structured.introspection.provider === "prisma"
         ? structured.introspection.providerConfig?.prisma?.schemaPath?.trim()
         : undefined;
@@ -36,6 +66,9 @@ export function getAskDbRuntimeConfig() {
         ? 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")
@@ -49,12 +82,15 @@ export function getAskDbRuntimeConfig() {
         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") ??
@@ -62,15 +98,19 @@ export function getAskDbRuntimeConfig() {
                 DEFAULT_INTROSPECT_OUTPUT_DIR,
         },
         rag: {
-            embedder: {
-                apiKey: pickFlat(flat, "ASKDB_RAG_EMBEDDER_API_KEY") ??
-                    pickFlat(flat, "ASKDB_AI_API_KEY") ??
-                    pickFlat(flat, "OPENAI_API_KEY"),
-                baseURL: pickFlat(flat, "ASKDB_RAG_EMBEDDER_BASE_URL") ??
-                    pickFlat(flat, "ASKDB_AI_BASE_URL") ??
-                    pickFlat(flat, "OPENAI_BASE_URL"),
-                model: pickFlat(flat, "ASKDB_RAG_EMBEDDER_MODEL"),
-            },
+            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"),
@@ -80,6 +120,14 @@ export function getAskDbRuntimeConfig() {
         },
         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"),
@@ -94,6 +142,7 @@ export function getAskDbRuntimeConfig() {
         studio: {
             execute: resolveStudioExecuteConfig(structured, flat),
         },
+        deprecations,
     };
 }
 function resolveStudioExecuteConfig(structured, flat) {
@@ -115,46 +164,73 @@ function resolveStudioExecuteConfig(structured, flat) {
             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.
+    // 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 === "postgres") {
-        databaseUrl =
-            structured.studio?.execute?.databaseUrl?.trim() ||
-                pickFlat(flat, "ASKDB_STUDIO_DATABASE_URL") ||
-                (structured.introspection?.provider === "postgres"
-                    ? structured.introspection.providerConfig?.postgres?.databaseUrl?.trim() ||
-                        pickFlat(flat, "ASKDB_INTROSPECT_POSTGRES_URL")
-                    : undefined);
+    if (provider === "sqlite") {
+        file = execute?.file?.trim() || pickFlat(flat, "ASKDB_STUDIO_SQLITE_FILE");
     }
-    else if (provider === "mysql") {
-        databaseUrl =
-            structured.studio?.execute?.databaseUrl?.trim() ||
-                pickFlat(flat, "ASKDB_STUDIO_DATABASE_URL") ||
-                (structured.introspection?.provider === "mysql"
-                    ? structured.introspection.providerConfig?.mysql?.databaseUrl?.trim() ||
-                        pickFlat(flat, "ASKDB_INTROSPECT_MYSQL_URL")
-                    : undefined);
+    else {
+        databaseUrl = execute?.databaseUrl?.trim() || pickFlat(flat, "ASKDB_STUDIO_DATABASE_URL");
     }
-    else if (provider === "sqlserver") {
-        databaseUrl =
-            structured.studio?.execute?.databaseUrl?.trim() ||
-                pickFlat(flat, "ASKDB_STUDIO_DATABASE_URL") ||
-                (structured.introspection?.provider === "sqlserver"
-                    ? structured.introspection.providerConfig?.sqlserver?.databaseUrl?.trim() ||
-                        pickFlat(flat, "ASKDB_INTROSPECT_SQLSERVER_URL")
-                    : undefined);
+    const explicit = provider === "sqlite" ? file : databaseUrl;
+    if (!explicit && useIntrospectionConnection && introspectionConnection) {
+        if (provider === "sqlite")
+            file = introspectionConnection;
+        else
+            databaseUrl = introspectionConnection;
     }
-    else if (provider === "sqlite") {
-        file =
-            structured.studio?.execute?.file?.trim() ||
-                pickFlat(flat, "ASKDB_STUDIO_SQLITE_FILE") ||
-                (structured.introspection?.provider === "sqlite"
-                    ? structured.introspection.providerConfig?.sqlite?.file?.trim() ||
-                        pickFlat(flat, "ASKDB_INTROSPECT_SQLITE_FILE")
-                    : undefined);
+    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");
     }
-    return { provider, databaseUrl, 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":"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"}
+{"version":3,"file":"runtime-config.js","sourceRoot":"","sources":["../src/runtime-config.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/ai.d.ts

@@ -0,0 +1,30 @@
+import { type AskDbAiProviderId } from "../constants.js";
+/** An env var a scaffolded config reads through `env()`. */
+export type AskDbScaffoldEnvVar = {
+    name: string;
+    /** Short description for `.env.example` and setup UIs. */
+    purpose: string;
+};
+export type AskDbAiConfigScaffoldInput = {
+    provider: AskDbAiProviderId;
+    /** Env var NAME for the API key. */
+    keyEnv: string;
+    /** Env var NAME for the language model (the deployment name on Azure). Omit to use the provider's default model. */
+    modelEnv?: string;
+};
+export type AskDbAiConfigScaffold = {
+    /** The `ai: { … },` property, indented for the top level of `defineConfig({ … })`. */
+    source: string;
+    /** Every env var `source` reads, in order. */
+    envVars: AskDbScaffoldEnvVar[];
+};
+/**
+ * Renders the `ai` block of a new `askdb.config.ts` (a provider connection, plus
+ * `ai.language` when a model env var is given), plus the env vars it reads. `askdb init` and Studio's setup wizard both call this, so the fields
+ * a provider needs to start (e.g. Azure's `resourceName`) live in one place.
+ *
+ * Every value is emitted as a JSON string literal: the generated file is
+ * executed when the config loads, so a raw quote in a name must not inject code.
+ */
+export declare function renderAskDbAiConfigScaffold(input: AskDbAiConfigScaffoldInput): AskDbAiConfigScaffold;
+//# sourceMappingURL=ai.d.ts.map

package/dist/scaffold/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/scaffold/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE7E,4DAA4D;AAC5D,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,oCAAoC;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,oHAAoH;IACpH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,sFAAsF;IACtF,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAChC,CAAC;AAYF;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,0BAA0B,GAAG,qBAAqB,CAmCpG"}

package/dist/scaffold/ai.js

@@ -0,0 +1,54 @@
+import { ASKDB_AI_PROVIDERS } from "../constants.js";
+function isAiProvider(provider) {
+    return ASKDB_AI_PROVIDERS.includes(provider);
+}
+/**
+ * Env var the scaffold reads `resourceName` from. It's also the name the Azure
+ * adapter reads when there's no config file.
+ */
+const AZURE_RESOURCE_NAME_ENV = "AZURE_RESOURCE_NAME";
+/**
+ * Renders the `ai` block of a new `askdb.config.ts` (a provider connection, plus
+ * `ai.language` when a model env var is given), plus the env vars it reads. `askdb init` and Studio's setup wizard both call this, so the fields
+ * a provider needs to start (e.g. Azure's `resourceName`) live in one place.
+ *
+ * Every value is emitted as a JSON string literal: the generated file is
+ * executed when the config loads, so a raw quote in a name must not inject code.
+ */
+export function renderAskDbAiConfigScaffold(input) {
+    const { provider, keyEnv, modelEnv } = input;
+    // The provider id is emitted as an object key, so only known ids get through.
+    if (!isAiProvider(provider)) {
+        throw new Error(`Unknown AI provider: ${JSON.stringify(provider)}`);
+    }
+    const envVars = [{ name: keyEnv, purpose: `${provider} API key` }];
+    const fields = [`apiKey: env(${JSON.stringify(keyEnv)}),`];
+    // The provider connection holds the key and endpoint only; the model choice lives in `ai.language`.
+    let language = "";
+    if (modelEnv) {
+        envVars.push({ name: modelEnv, purpose: `${provider} model override` });
+        language = `
+    language: {
+      model: env(${JSON.stringify(modelEnv)}),
+    },`;
+    }
+    // `AzureConnection` / `FoundryConnection` need `resourceName` or `baseUrl`; the
+    // adapter refuses to start without one. Scaffold the resource-name form.
+    if (provider === "azure" || provider === "foundry") {
+        envVars.push({
+            name: AZURE_RESOURCE_NAME_ENV,
+            purpose: 'Azure resource name, e.g. "my-resource" for https://my-resource.openai.azure.com',
+        });
+        fields.push(`resourceName: env(${JSON.stringify(AZURE_RESOURCE_NAME_ENV)}),`);
+    }
+    const source = `  ai: {
+    provider: ${JSON.stringify(provider)},
+    providerConfig: {
+      ${provider}: {
+${fields.map((field) => `        ${field}`).join("\n")}
+      },
+    },${language}
+  },`;
+    return { source, envVars };
+}
+//# sourceMappingURL=ai.js.map

package/dist/scaffold/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/scaffold/ai.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAA0B,MAAM,iBAAiB,CAAC;AAwB7E,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAQ,kBAAwC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,uBAAuB,GAAG,qBAAqB,CAAC;AAEtD;;;;;;;GAOG;AACH,MAAM,UAAU,2BAA2B,CAAC,KAAiC;IAC3E,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC7C,8EAA8E;IAC9E,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,MAAM,OAAO,GAA0B,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,UAAU,EAAE,CAAC,CAAC;IAC1F,MAAM,MAAM,GAAG,CAAC,eAAe,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC3D,oGAAoG;IACpG,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,QAAQ,iBAAiB,EAAE,CAAC,CAAC;QACxE,QAAQ,GAAG;;mBAEI,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;OACpC,CAAC;IACN,CAAC;IACD,gFAAgF;IAChF,yEAAyE;IACzE,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC;YACX,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,kFAAkF;SAC5F,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,qBAAqB,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,MAAM,GAAG;gBACD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;;QAEhC,QAAQ;EACd,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;QAE9C,QAAQ;KACX,CAAC;IACJ,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC"}

package/dist/scaffold/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `@askdb/config/scaffold`: helpers for tools that write a new `askdb.config.ts`
+ * (`askdb init`, Studio's setup wizard). Kept off the main entry, which user
+ * configs import, so tooling can change without touching the config API.
+ */
+export { renderAskDbAiConfigScaffold } from "./ai.js";
+export type { AskDbAiConfigScaffold, AskDbAiConfigScaffoldInput, AskDbScaffoldEnvVar } from "./ai.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/scaffold/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/dist/scaffold/index.js

@@ -0,0 +1,7 @@
+/**
+ * `@askdb/config/scaffold`: helpers for tools that write a new `askdb.config.ts`
+ * (`askdb init`, Studio's setup wizard). Kept off the main entry, which user
+ * configs import, so tooling can change without touching the config API.
+ */
+export { renderAskDbAiConfigScaffold } from "./ai.js";
+//# sourceMappingURL=index.js.map

package/dist/scaffold/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC"}