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

package/dist/runtime-types.d.ts

@@ -0,0 +1,176 @@
+import type { AskDbDialectId, AskDbIntrospectionProvider, AskDbLogLevel, AskDbModeV1, 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 = {
+    /** `logging.level`; `undefined` leaves the level to each tool (the CLI and the HTTP API server differ). */
+    level: AskDbLogLevel | 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`. 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`. Never read from `process.env`.
+     * `undefined` for non-MySQL providers.
+     */
+    mysqlDatabaseUrl: string | undefined;
+    /**
+     * Schemas (MySQL/MariaDB: databases) to introspect, for every provider: `introspection.schemas`.
+     * `undefined` means the engine's default. `askdb introspect --schemas` overrides it.
+     */
+    schemas: string[] | undefined;
+    /**
+     * Resolved SQLite file path when `provider === "sqlite"`:
+     * `providerConfig.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`. 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 = {
+    /** `modes.askdbMode`; `undefined` means `"schema_only"`. */
+    askdbMode: AskDbModeV1 | 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"`.
+         */
+        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. Every field is resolved from
+ * `structured`; `flat` and `ai.aiEnv` are projections of the same resolution, never read back.
+ */
+export type AskDbRuntimeConfig = {
+    readonly structured: Readonly<AskDbConfig>;
+    /** Canonical flattened map (subprocess env via {@link mergeAskDbFlatIntoEnvMap}), built from `structured`. */
+    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[];
+};
+//# sourceMappingURL=runtime-types.d.ts.map

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

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

package/dist/runtime-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-types.js.map

package/dist/runtime-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-types.js","sourceRoot":"","sources":["../src/runtime-types.ts"],"names":[],"mappings":""}

package/dist/scaffold/ai.d.ts

@@ -25,6 +25,9 @@ export type AskDbAiConfigScaffold = {
  *
  * 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.
+ *
+ * @experimental Tooling for `askdb init` and AskDB Studio: a minor release of
+ * `@askdb/config` may change it (ADR 0030).
  */
 export declare function renderAskDbAiConfigScaffold(input: AskDbAiConfigScaffoldInput): AskDbAiConfigScaffold;
 //# sourceMappingURL=ai.d.ts.map

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

@@ -1 +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"}
+{"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;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,0BAA0B,GAAG,qBAAqB,CAmCpG"}

package/dist/scaffold/ai.js

@@ -14,6 +14,9 @@ const AZURE_RESOURCE_NAME_ENV = "AZURE_RESOURCE_NAME";
  *
  * 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.
+ *
+ * @experimental Tooling for `askdb init` and AskDB Studio: a minor release of
+ * `@askdb/config` may change it (ADR 0030).
  */
 export function renderAskDbAiConfigScaffold(input) {
     const { provider, keyEnv, modelEnv } = input;

package/dist/scaffold/ai.js.map

@@ -1 +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"}
+{"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;;;;;;;;;;GAUG;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

@@ -1,8 +1,17 @@
 /**
- * `@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.
+ * `@askdb/config/scaffold`: helpers for tools that set up a project and write a new
+ * `askdb.config.ts` (`askdb init`, Studio's setup wizard): the planner, which turns a
+ * project's answers into its config, `.env.example` and installs, and the package-manager
+ * helpers that run the installs. Kept off the main entry, which user configs import, so
+ * tooling can change without touching the config API.
+ *
+ * @experimental Tooling for `askdb init` and AskDB Studio: a minor release of
+ * `@askdb/config` may change these exports (ADR 0030).
  */
 export { renderAskDbAiConfigScaffold } from "./ai.js";
 export type { AskDbAiConfigScaffold, AskDbAiConfigScaffoldInput, AskDbScaffoldEnvVar } from "./ai.js";
+export { AskDbScaffoldInputError, isAskDbScaffoldEnvName, planAskDbScaffold } from "./plan.js";
+export type { AskDbScaffoldAnswers, AskDbScaffoldPlan, ScaffoldValue } from "./plan.js";
+export { detectPackageManager, findNearestPackageJsonDir, formatInstallCommand, isLikelyWorkspaceRoot, lockfilePackageManager, packageManagerAddArgs, packageManagerSpawnSpec, supportedBuildApprovals, } from "./package-manager.js";
+export type { PackageManager, PackageManagerSpawnSpec } from "./package-manager.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACtG,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/F,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/scaffold/index.js

@@ -1,7 +1,14 @@
 /**
- * `@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.
+ * `@askdb/config/scaffold`: helpers for tools that set up a project and write a new
+ * `askdb.config.ts` (`askdb init`, Studio's setup wizard): the planner, which turns a
+ * project's answers into its config, `.env.example` and installs, and the package-manager
+ * helpers that run the installs. Kept off the main entry, which user configs import, so
+ * tooling can change without touching the config API.
+ *
+ * @experimental Tooling for `askdb init` and AskDB Studio: a minor release of
+ * `@askdb/config` may change these exports (ADR 0030).
  */
 export { renderAskDbAiConfigScaffold } from "./ai.js";
+export { AskDbScaffoldInputError, isAskDbScaffoldEnvName, planAskDbScaffold } from "./plan.js";
+export { detectPackageManager, findNearestPackageJsonDir, formatInstallCommand, isLikelyWorkspaceRoot, lockfilePackageManager, packageManagerAddArgs, packageManagerSpawnSpec, supportedBuildApprovals, } from "./package-manager.js";
 //# sourceMappingURL=index.js.map

package/dist/scaffold/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scaffold/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAEtD,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE/F,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,sBAAsB,CAAC"}

package/dist/scaffold/package-manager.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Package-manager helpers for the tools that set up a project: `askdb init` and
+ * Studio's setup wizard and execute-driver install. One copy, so the two front
+ * ends detect, format and spawn the same way.
+ *
+ * @experimental Tooling for `askdb init` and AskDB Studio: a minor release of
+ * `@askdb/config` may change these exports (ADR 0030).
+ *
+ * Only allowlisted package names ever reach these helpers, never user- or
+ * browser-supplied strings, but {@link packageManagerSpawnSpec} re-checks every
+ * argument anyway because Windows needs `shell: true` (see below).
+ */
+/** @experimental See the module note. */
+export type PackageManager = "pnpm" | "npm" | "yarn" | "bun";
+/**
+ * The nearest directory at or above `startDir` that holds a `package.json`.
+ *
+ * @experimental See the module note.
+ */
+export declare function findNearestPackageJsonDir(startDir: string): string | undefined;
+/**
+ * Whether `packageDir` looks like a monorepo or workspace root (a `pnpm-workspace.yaml`,
+ * or a `workspaces` field), whose `package.json` setup tools leave alone.
+ *
+ * @experimental See the module note.
+ */
+export declare function isLikelyWorkspaceRoot(packageDir: string): boolean;
+/**
+ * The package manager implied by a lockfile directly inside `dir`, if any.
+ *
+ * @experimental See the module note.
+ */
+export declare function lockfilePackageManager(dir: string): PackageManager | null;
+/**
+ * The package manager to install with in `packageDir`, from the first of these that
+ * names one:
+ *
+ * 1. a lockfile in `packageDir` or a parent (pnpm, then Bun, Yarn, npm in one directory);
+ * 2. the nearest `package.json`, walking up, that declares a manager: its `packageManager`
+ *    field (Corepack's `pnpm@11.28.10`), then `devEngines.packageManager` (`{ name }` or a
+ *    list of them; `pnpm init` writes it);
+ * 3. `npm_config_user_agent` in `env`, which `pnpm dlx`, `yarn dlx`, `npx` and `bunx` set;
+ * 4. npm.
+ *
+ * An existing lockfile wins, so a project's install never switches managers.
+ *
+ * @experimental See the module note.
+ */
+export declare function detectPackageManager(packageDir: string, env?: Readonly<Record<string, string | undefined>>): PackageManager;
+/**
+ * Arguments that add `packages` as dependencies with the given package manager.
+ * `allowBuilds` are dependencies whose install scripts pnpm must be told to run
+ * (`--allow-build=<name>`; pnpm 11 exits 1 on an unapproved one). npm and Yarn
+ * run install scripts, and Bun skips untrusted ones without failing, so only
+ * pnpm gets them.
+ *
+ * @experimental See the module note.
+ */
+export declare function packageManagerAddArgs(pm: PackageManager, packages: readonly string[], allowBuilds?: readonly string[]): string[];
+/**
+ * The build approvals to pass `pm` in `dir`: `allowBuilds`, or none for a pnpm older
+ * than 10.4.0, whose `add` rejects `--allow-build` (pnpm 9 runs install scripts, and
+ * 10.0 to 10.3 skip unapproved ones without failing). A pnpm whose version can't be
+ * read keeps them.
+ *
+ * @experimental See the module note.
+ */
+export declare function supportedBuildApprovals(pm: PackageManager, dir: string, allowBuilds: readonly string[]): string[];
+/**
+ * Human-readable install command, e.g. `pnpm add pg`.
+ *
+ * @experimental See the module note.
+ */
+export declare function formatInstallCommand(pm: PackageManager, packages: readonly string[], allowBuilds?: readonly string[]): string;
+/** @experimental See the module note. */
+export type PackageManagerSpawnSpec = {
+    command: string;
+    args: string[];
+    shell: boolean;
+};
+/**
+ * How to spawn a package manager on this platform.
+ *
+ * On Windows, package managers are `.cmd` shims, and Node refuses to spawn
+ * `.cmd`/`.bat` files without a shell (EINVAL since Node 18.20.2 / 20.12.2,
+ * CVE-2024-27980). So Windows gets `shell: true` with the bare command name.
+ * Arguments are validated against a strict allowlist pattern first, so the
+ * shell never sees anything it could interpret.
+ *
+ * @experimental See the module note.
+ */
+export declare function packageManagerSpawnSpec(pm: PackageManager, args: readonly string[], platform?: NodeJS.Platform): PackageManagerSpawnSpec;
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/scaffold/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/scaffold/package-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,yCAAyC;AACzC,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,CAAC;AAK7D;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE9E;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAUjE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAMzE;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,GAAG,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAe,GAC9D,cAAc,CAWhB;AAuCD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,WAAW,GAAE,SAAS,MAAM,EAAO,GAClC,MAAM,EAAE,CAIV;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAMjH;AAQD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,WAAW,GAAE,SAAS,MAAM,EAAO,GAClC,MAAM,CAER;AAED,yCAAyC;AACzC,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAQF;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,QAAQ,GAAE,MAAM,CAAC,QAA2B,GAC3C,uBAAuB,CAUzB"}

package/dist/scaffold/package-manager.js

@@ -0,0 +1,200 @@
+/**
+ * Package-manager helpers for the tools that set up a project: `askdb init` and
+ * Studio's setup wizard and execute-driver install. One copy, so the two front
+ * ends detect, format and spawn the same way.
+ *
+ * @experimental Tooling for `askdb init` and AskDB Studio: a minor release of
+ * `@askdb/config` may change these exports (ADR 0030).
+ *
+ * Only allowlisted package names ever reach these helpers, never user- or
+ * browser-supplied strings, but {@link packageManagerSpawnSpec} re-checks every
+ * argument anyway because Windows needs `shell: true` (see below).
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+/** How far up the helpers walk looking for a `package.json` or lockfile. */
+const MAX_WALK_UP = 40;
+/**
+ * The nearest directory at or above `startDir` that holds a `package.json`.
+ *
+ * @experimental See the module note.
+ */
+export function findNearestPackageJsonDir(startDir) {
+    return ancestors(startDir).find((dir) => existsSync(join(dir, "package.json")));
+}
+/**
+ * Whether `packageDir` looks like a monorepo or workspace root (a `pnpm-workspace.yaml`,
+ * or a `workspaces` field), whose `package.json` setup tools leave alone.
+ *
+ * @experimental See the module note.
+ */
+export function isLikelyWorkspaceRoot(packageDir) {
+    if (existsSync(join(packageDir, "pnpm-workspace.yaml")) || existsSync(join(packageDir, "pnpm-workspace.yml"))) {
+        return true;
+    }
+    try {
+        const pkg = JSON.parse(readFileSync(join(packageDir, "package.json"), "utf8"));
+        return pkg.workspaces !== undefined && pkg.workspaces !== null;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The package manager implied by a lockfile directly inside `dir`, if any.
+ *
+ * @experimental See the module note.
+ */
+export function lockfilePackageManager(dir) {
+    if (existsSync(join(dir, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(dir, "bun.lockb")) || existsSync(join(dir, "bun.lock")))
+        return "bun";
+    if (existsSync(join(dir, "yarn.lock")))
+        return "yarn";
+    if (existsSync(join(dir, "package-lock.json")))
+        return "npm";
+    return null;
+}
+/**
+ * The package manager to install with in `packageDir`, from the first of these that
+ * names one:
+ *
+ * 1. a lockfile in `packageDir` or a parent (pnpm, then Bun, Yarn, npm in one directory);
+ * 2. the nearest `package.json`, walking up, that declares a manager: its `packageManager`
+ *    field (Corepack's `pnpm@11.28.10`), then `devEngines.packageManager` (`{ name }` or a
+ *    list of them; `pnpm init` writes it);
+ * 3. `npm_config_user_agent` in `env`, which `pnpm dlx`, `yarn dlx`, `npx` and `bunx` set;
+ * 4. npm.
+ *
+ * An existing lockfile wins, so a project's install never switches managers.
+ *
+ * @experimental See the module note.
+ */
+export function detectPackageManager(packageDir, env = process.env) {
+    const dirs = ancestors(packageDir);
+    for (const dir of dirs) {
+        const pm = lockfilePackageManager(dir);
+        if (pm)
+            return pm;
+    }
+    for (const dir of dirs) {
+        const pm = declaredPackageManager(dir);
+        if (pm)
+            return pm;
+    }
+    return knownPackageManager(env.npm_config_user_agent?.split("/")[0]) ?? "npm";
+}
+/** `dir` and its parents, nearest first, at most {@link MAX_WALK_UP} of them. */
+function ancestors(dir) {
+    const dirs = [resolve(dir)];
+    while (dirs.length < MAX_WALK_UP) {
+        const parent = dirname(dirs[dirs.length - 1]);
+        if (parent === dirs[dirs.length - 1])
+            break;
+        dirs.push(parent);
+    }
+    return dirs;
+}
+/** The manager `dir/package.json` declares in `packageManager` or `devEngines.packageManager`. */
+function declaredPackageManager(dir) {
+    let pkg;
+    try {
+        pkg = JSON.parse(readFileSync(join(dir, "package.json"), "utf8"));
+    }
+    catch {
+        return null;
+    }
+    if (pkg === null || typeof pkg !== "object")
+        return null;
+    if (typeof pkg.packageManager === "string") {
+        const pm = knownPackageManager(pkg.packageManager.split("@")[0]);
+        if (pm)
+            return pm;
+    }
+    const devEngine = pkg.devEngines?.packageManager;
+    for (const entry of Array.isArray(devEngine) ? devEngine : [devEngine]) {
+        const name = entry !== null && typeof entry === "object" ? entry.name : undefined;
+        const pm = knownPackageManager(name);
+        if (pm)
+            return pm;
+    }
+    return null;
+}
+function knownPackageManager(name) {
+    return name === "pnpm" || name === "npm" || name === "yarn" || name === "bun" ? name : null;
+}
+/**
+ * Arguments that add `packages` as dependencies with the given package manager.
+ * `allowBuilds` are dependencies whose install scripts pnpm must be told to run
+ * (`--allow-build=<name>`; pnpm 11 exits 1 on an unapproved one). npm and Yarn
+ * run install scripts, and Bun skips untrusted ones without failing, so only
+ * pnpm gets them.
+ *
+ * @experimental See the module note.
+ */
+export function packageManagerAddArgs(pm, packages, allowBuilds = []) {
+    if (pm === "npm")
+        return ["install", "--save", ...packages];
+    if (pm === "pnpm")
+        return ["add", ...allowBuilds.map((name) => `--allow-build=${name}`), ...packages];
+    return ["add", ...packages];
+}
+/**
+ * The build approvals to pass `pm` in `dir`: `allowBuilds`, or none for a pnpm older
+ * than 10.4.0, whose `add` rejects `--allow-build` (pnpm 9 runs install scripts, and
+ * 10.0 to 10.3 skip unapproved ones without failing). A pnpm whose version can't be
+ * read keeps them.
+ *
+ * @experimental See the module note.
+ */
+export function supportedBuildApprovals(pm, dir, allowBuilds) {
+    if (pm !== "pnpm" || allowBuilds.length === 0)
+        return [...allowBuilds];
+    const match = /^(\d+)\.(\d+)\./.exec(pnpmVersion(dir) ?? "");
+    if (!match)
+        return [...allowBuilds];
+    const [major, minor] = [Number(match[1]), Number(match[2])];
+    return major > 10 || (major === 10 && minor >= 4) ? [...allowBuilds] : [];
+}
+function pnpmVersion(dir) {
+    const { command, args, shell } = packageManagerSpawnSpec("pnpm", ["--version"]);
+    const result = spawnSync(command, args, { cwd: dir, encoding: "utf8", shell, stdio: ["ignore", "pipe", "ignore"], timeout: 15_000 });
+    return result.status === 0 ? result.stdout.trim() : null;
+}
+/**
+ * Human-readable install command, e.g. `pnpm add pg`.
+ *
+ * @experimental See the module note.
+ */
+export function formatInstallCommand(pm, packages, allowBuilds = []) {
+    return [pm, ...packageManagerAddArgs(pm, packages, allowBuilds)].join(" ");
+}
+// npm package names (optionally scoped, optionally with a version/range suffix),
+// simple `--flag` arguments, and pnpm's `--allow-build=<package name>`. Nothing a
+// shell would interpret.
+const SAFE_ARG = /^(?:--[a-z][a-z-]*|--allow-build=(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*|(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*(?:@[a-z0-9.^~<>=*_-]+)?|add|install)$/i;
+/**
+ * How to spawn a package manager on this platform.
+ *
+ * On Windows, package managers are `.cmd` shims, and Node refuses to spawn
+ * `.cmd`/`.bat` files without a shell (EINVAL since Node 18.20.2 / 20.12.2,
+ * CVE-2024-27980). So Windows gets `shell: true` with the bare command name.
+ * Arguments are validated against a strict allowlist pattern first, so the
+ * shell never sees anything it could interpret.
+ *
+ * @experimental See the module note.
+ */
+export function packageManagerSpawnSpec(pm, args, platform = process.platform) {
+    for (const arg of args) {
+        if (!SAFE_ARG.test(arg)) {
+            throw new Error(`Refusing to pass unsafe argument to ${pm}: ${JSON.stringify(arg)}`);
+        }
+    }
+    if (platform === "win32") {
+        return { command: pm, args: [...args], shell: true };
+    }
+    return { command: pm, args: [...args], shell: false };
+}
+//# sourceMappingURL=package-manager.js.map

package/dist/scaffold/package-manager.js.map

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