@askdb/studio 0.2.0-beta.4 → 0.2.0-beta.40

package/dist/execute-registry.js

@@ -0,0 +1,445 @@
+/**
+ * Studio execute-driver registry.
+ *
+ * Each entry describes a live execute provider — how to dynamically import the
+ * driver package, what connection shape it expects, and how to normalize its
+ * results into the shared `ExecuteResponse` DTO.
+ *
+ * Drivers are optional peers. The registry never imports a driver at module
+ * load time; every import lives inside an `executeXxx()` function so a missing
+ * package only fails when the user actually tries to execute a query.
+ *
+ * Safety model (every engine):
+ *
+ * 1. The server validates SQL with `@askdb/core`'s `validateSelectSql` before it
+ *    reaches a runner ({@link validateExecuteSql}). Runners receive the
+ *    normalized single statement (no trailing semicolon, no comments).
+ * 2. Each runner executes the SQL read-only: inside a read-only transaction
+ *    (Postgres, MySQL/MariaDB), on a read-only file handle (SQLite), or inside
+ *    an always-rolled-back transaction (SQL Server). Postgres, MySQL/MariaDB,
+ *    and SQLite run a single statement; SQL Server runs the SQL as part of a
+ *    batch. Step 1 rejects a second statement written without `;` there, except
+ *    one that starts with `FETCH`, or with `END`, `GET` or `MOVE CONVERSATION`.
+ *    Every engine except SQLite (whose queries can't be interrupted) enforces
+ *    a statement timeout.
+ * 3. Each runner fetches at most `maxRows + 1` rows and reports `truncated`.
+ *
+ * None of this replaces a read-only database role — point Studio at one.
+ */
+import { getDialectSpec, validateSelectSql, } from "@askdb/core";
+import { loadPgDriver, isPgDriverInstalled } from "@askdb/postgres";
+import { loadMysql2Driver, isMysql2DriverInstalled } from "@askdb/mysql";
+import { loadBetterSqlite3Driver, isBetterSqlite3DriverInstalled } from "@askdb/sqlite";
+import { loadMssqlDriver, isMssqlDriverInstalled, resolveConnectionInput, } from "@askdb/sqlserver";
+export const DEFAULT_EXECUTE_TIMEOUT_MS = 30_000;
+export const DEFAULT_EXECUTE_MAX_ROWS = 500;
+/** Alias for the row-cap subquery wrapper. */
+const ROW_LIMIT_ALIAS = "askdb_q";
+// ---------------------------------------------------------------------------
+// Validation
+// ---------------------------------------------------------------------------
+/** Built-in dialects each execute provider can run. The first is the default. */
+const PROVIDER_DIALECTS = {
+    postgres: ["postgres", "cockroachdb"],
+    mysql: ["mysql", "mariadb"],
+    sqlite: ["sqlite"],
+    sqlserver: ["sqlserver"],
+};
+/**
+ * The dialect spec used to validate SQL for `provider`. A configured NL→SQL
+ * dialect override (`dialect` in `askdb.config.ts`) is honored when it belongs
+ * to the same engine family (e.g. `mariadb` on the `mysql` provider).
+ */
+export function executeDialectFor(provider, dialectOverride) {
+    const family = PROVIDER_DIALECTS[provider];
+    const id = dialectOverride && family.includes(dialectOverride)
+        ? dialectOverride
+        : family[0];
+    return getDialectSpec(id);
+}
+/**
+ * Run `@askdb/core`'s read-only SELECT guardrail for the provider's dialect.
+ * Returns the single statement without its trailing `;`, so runners can wrap it
+ * in a row cap; throws `SqlValidationError`.
+ */
+export function validateExecuteSql(provider, sql, dialectOverride) {
+    // `validateSelectSql` keeps a trailing `;`; it is the only `;` left once the
+    // statement passes, so dropping it can't touch a string or identifier. Its
+    // result is trimmed, so the `;` is the last character. No `\s*;` pattern: it
+    // backtracks quadratically on a long whitespace run.
+    return validateSelectSql(executeDialectFor(provider, dialectOverride), sql).replace(/;$/, "").trimEnd();
+}
+// ---------------------------------------------------------------------------
+// Normalization helpers
+// ---------------------------------------------------------------------------
+function resolveLimits(input) {
+    const timeoutMs = positiveInt(input.timeoutMs) ?? DEFAULT_EXECUTE_TIMEOUT_MS;
+    const maxRows = positiveInt(input.maxRows) ?? DEFAULT_EXECUTE_MAX_ROWS;
+    return { timeoutMs, maxRows, fetchLimit: maxRows + 1 };
+}
+function positiveInt(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0 ? value : undefined;
+}
+/**
+ * Wrap a validated single SELECT so the database returns at most `fetchLimit`
+ * rows. Used for engines with `LIMIT` (Postgres, MySQL). The newlines keep the
+ * wrapper intact even if the statement ends in something unexpected.
+ */
+export function wrapWithRowLimit(sql, fetchLimit) {
+    return `SELECT * FROM (\n${sql}\n) AS ${ROW_LIMIT_ALIAS} LIMIT ${fetchLimit}`;
+}
+function buildOkResponse(columns, rows, maxRows, durationMs) {
+    const truncated = rows.length > maxRows;
+    const shown = truncated ? rows.slice(0, maxRows) : rows;
+    return {
+        ok: true,
+        columns,
+        rows: shown,
+        rowCount: shown.length,
+        durationMs,
+        truncated,
+        rowLimit: maxRows,
+    };
+}
+function toRowArray(row, columns) {
+    if (Array.isArray(row))
+        return row;
+    const record = (row ?? {});
+    return columns.map((c) => record[c]);
+}
+function errorResponse(err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+}
+/**
+ * Race `promise` against a timer. On timeout, run `onTimeout` (cancel/destroy
+ * the connection) and reject. A client-side backstop for server-side timeouts.
+ */
+async function withTimeout(promise, ms, onTimeout) {
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            try {
+                onTimeout();
+            }
+            catch {
+                // best effort
+            }
+            reject(new Error(`Query timed out after ${ms} ms.`));
+        }, ms);
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Grace period before the client-side backstop fires after the server-side timeout. */
+const CLIENT_TIMEOUT_GRACE_MS = 2_000;
+async function executePostgres(input) {
+    const { connectionString, sql, params, projectRoot } = input;
+    const { timeoutMs, maxRows, fetchLimit } = resolveLimits(input);
+    if (!connectionString) {
+        return { ok: false, error: "No connection URL configured for Postgres execute. Set studio.execute.databaseUrl in askdb.config.ts." };
+    }
+    let pgMod;
+    try {
+        pgMod = await loadPgDriver({ resolveFrom: projectRoot });
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    const client = new pgMod.Client({
+        connectionString,
+        connectionTimeoutMillis: timeoutMs,
+        // Client-side backstop; the server-side statement_timeout below fires first.
+        query_timeout: timeoutMs + CLIENT_TIMEOUT_GRACE_MS,
+    });
+    try {
+        await client.connect();
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    const startMs = Date.now();
+    try {
+        // Session default + explicit read-only transaction: even a statement that
+        // slipped past validation cannot write, and cannot COMMIT its way out
+        // (the extended protocol below runs exactly one statement).
+        await client.query("SET default_transaction_read_only = on");
+        await client.query("BEGIN READ ONLY");
+        await client.query(`SET LOCAL statement_timeout = ${timeoutMs}`);
+        const result = await client.query({
+            text: wrapWithRowLimit(sql, fetchLimit),
+            values: params,
+            queryMode: "extended",
+            name: "askdb_studio_execute",
+            rowMode: "array",
+        });
+        await client.query("ROLLBACK");
+        const durationMs = Date.now() - startMs;
+        const columns = result.fields.map((f) => f.name);
+        const rows = result.rows.map((r) => toRowArray(r, columns));
+        return buildOkResponse(columns, rows, maxRows, durationMs);
+    }
+    catch (err) {
+        await client.query("ROLLBACK").catch(() => { });
+        return errorResponse(err);
+    }
+    finally {
+        await client.end().catch(() => { });
+    }
+}
+/** MySQL uses `max_execution_time` (ms); MariaDB uses `max_statement_time` (seconds). */
+async function applyMysqlTimeout(conn, timeoutMs) {
+    try {
+        await conn.query(`SET SESSION MAX_EXECUTION_TIME = ${timeoutMs}`);
+        return;
+    }
+    catch {
+        // Not MySQL 5.7.8+ — try MariaDB.
+    }
+    try {
+        await conn.query(`SET SESSION max_statement_time = ${Math.max(timeoutMs / 1000, 0.001)}`);
+    }
+    catch {
+        // Neither variable exists; the client-side backstop still applies.
+    }
+}
+async function executeMySQL(input) {
+    const { connectionString, sql, params, projectRoot } = input;
+    const { timeoutMs, maxRows, fetchLimit } = resolveLimits(input);
+    if (!connectionString) {
+        return { ok: false, error: "No connection URL configured for MySQL execute. Set studio.execute.databaseUrl in askdb.config.ts." };
+    }
+    let mysql2Mod;
+    try {
+        mysql2Mod = await loadMysql2Driver({ resolveFrom: projectRoot });
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    let conn;
+    try {
+        conn = await mysql2Mod.createConnection({
+            uri: connectionString,
+            multipleStatements: false,
+            connectTimeout: timeoutMs,
+        });
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    const startMs = Date.now();
+    try {
+        await applyMysqlTimeout(conn, timeoutMs);
+        await conn.query("SET SESSION TRANSACTION READ ONLY");
+        await conn.query("START TRANSACTION READ ONLY");
+        // `execute` uses the binary prepared-statement protocol: one statement only.
+        const [rowsRaw, fields] = await withTimeout(conn.execute({ sql: wrapWithRowLimit(sql, fetchLimit), values: params, rowsAsArray: true }), timeoutMs + CLIENT_TIMEOUT_GRACE_MS, () => conn.destroy?.());
+        await conn.query("ROLLBACK");
+        const durationMs = Date.now() - startMs;
+        const columns = (fields ?? []).map((f) => f.name);
+        const rows = (rowsRaw ?? []).map((r) => toRowArray(r, columns));
+        return buildOkResponse(columns, rows, maxRows, durationMs);
+    }
+    catch (err) {
+        await conn.query("ROLLBACK").catch(() => { });
+        return errorResponse(err);
+    }
+    finally {
+        await conn.end().catch(() => { });
+    }
+}
+async function executeSQLite(input) {
+    const { file, sql, params, projectRoot } = input;
+    const { timeoutMs, maxRows, fetchLimit } = resolveLimits(input);
+    if (!file) {
+        return { ok: false, error: "No SQLite file path configured for execute. Set studio.execute.file in askdb.config.ts." };
+    }
+    let Sqlite3;
+    try {
+        const mod = await loadBetterSqlite3Driver({ resolveFrom: projectRoot });
+        Sqlite3 = mod.default;
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    const startMs = Date.now();
+    let db;
+    try {
+        // Read-only handle. `timeout` is only the busy (lock-wait) timeout —
+        // better-sqlite3 runs queries synchronously and cannot interrupt them.
+        db = new Sqlite3(file, { readonly: true, fileMustExist: true, timeout: timeoutMs });
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    try {
+        // `prepare` rejects strings containing more than one statement.
+        const stmt = db.prepare(sql);
+        if (!stmt.reader) {
+            return { ok: false, error: "Only statements that return rows can be executed." };
+        }
+        stmt.raw(true);
+        const columns = stmt.columns().map((c) => c.name);
+        const rows = [];
+        // Stream rows and stop at the cap — never materialize the full result.
+        for (const row of stmt.iterate(...params)) {
+            rows.push(toRowArray(row, columns));
+            if (rows.length >= fetchLimit)
+                break;
+        }
+        const durationMs = Date.now() - startMs;
+        return buildOkResponse(columns, rows, maxRows, durationMs);
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    finally {
+        db.close();
+    }
+}
+/**
+ * Rewrite `$1`, `$2`, ... or bare `?` positional params to MSSQL `@p0`, `@p1`, ...
+ * and return an object of named bindings. SQL that already uses `@pN` markers (from
+ * `ask()` with the sqlserver dialect) is bound as written: rewriting it would turn a `?`
+ * or `$…` inside a string literal, or a money literal, into a marker.
+ */
+function rewriteSqlServerParams(sql, params) {
+    if (params.length === 0)
+        return { sql, bindings: {} };
+    const bindings = {};
+    params.forEach((value, idx) => {
+        bindings[`p${idx}`] = value;
+    });
+    if (/@p\d/.test(sql))
+        return { sql, bindings };
+    // Replace $N placeholders (1-indexed) first, then bare ? placeholders.
+    let idx = 0;
+    const rewritten = sql
+        .replace(/\$\d+/g, () => `@p${idx++}`)
+        .replace(/\?/g, () => `@p${idx++}`);
+    return { sql: rewritten, bindings };
+}
+/**
+ * SQL Server has no read-only transaction mode, so the statement runs inside a
+ * transaction that is always rolled back. `XACT_ABORT` rolls back on any error;
+ * `ROWCOUNT` caps the rows returned (SQL Server has no `LIMIT`, and wrapping in
+ * a derived table would reject unnamed columns such as `COUNT(*)`).
+ */
+export function buildSqlServerBatch(sql, fetchLimit) {
+    return [
+        "SET XACT_ABORT ON;",
+        `SET ROWCOUNT ${fetchLimit};`,
+        "BEGIN TRANSACTION;",
+        sql,
+        ";",
+        "IF @@TRANCOUNT > 0 ROLLBACK TRANSACTION;",
+        "SET ROWCOUNT 0;",
+    ].join("\n");
+}
+function recordsetColumns(recordset) {
+    if (recordset.columns) {
+        return Object.values(recordset.columns)
+            .sort((a, b) => a.index - b.index)
+            .map((c) => c.name);
+    }
+    return recordset.length > 0 ? Object.keys(recordset[0]) : [];
+}
+async function executeSQLServer(input) {
+    const { connectionString, sql, params, projectRoot } = input;
+    const { timeoutMs, maxRows, fetchLimit } = resolveLimits(input);
+    if (!connectionString) {
+        return { ok: false, error: "No connection URL configured for SQL Server execute. Set studio.execute.databaseUrl in askdb.config.ts." };
+    }
+    let mssqlMod;
+    try {
+        mssqlMod = await loadMssqlDriver({ resolveFrom: projectRoot });
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    let pool;
+    try {
+        pool = await new mssqlMod.ConnectionPool(resolveConnectionInput(connectionString)).connect();
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    const startMs = Date.now();
+    try {
+        const { sql: rewrittenSql, bindings } = rewriteSqlServerParams(sql, params);
+        const req = pool.request();
+        for (const [name, value] of Object.entries(bindings)) {
+            req.input(name, value);
+        }
+        const result = await withTimeout(req.query(buildSqlServerBatch(rewrittenSql, fetchLimit)), timeoutMs, () => req.cancel?.());
+        const durationMs = Date.now() - startMs;
+        const recordset = result.recordset ?? result.recordsets?.[0] ?? [];
+        const columns = recordsetColumns(recordset);
+        const rows = recordset.map((r) => toRowArray(r, columns));
+        return buildOkResponse(columns, rows, maxRows, durationMs);
+    }
+    catch (err) {
+        return errorResponse(err);
+    }
+    finally {
+        await pool.close().catch(() => { });
+    }
+}
+// ---------------------------------------------------------------------------
+// Registry
+// ---------------------------------------------------------------------------
+export const EXECUTE_DRIVER_REGISTRY = {
+    postgres: {
+        provider: "postgres",
+        label: "Postgres",
+        packageName: "pg",
+        installCommand: "pnpm add pg",
+        execute: executePostgres,
+    },
+    mysql: {
+        provider: "mysql",
+        label: "MySQL",
+        packageName: "mysql2",
+        installCommand: "pnpm add mysql2",
+        execute: executeMySQL,
+    },
+    sqlite: {
+        provider: "sqlite",
+        label: "SQLite",
+        packageName: "better-sqlite3",
+        installCommand: "pnpm add better-sqlite3",
+        execute: executeSQLite,
+    },
+    sqlserver: {
+        provider: "sqlserver",
+        label: "SQL Server",
+        packageName: "mssql",
+        installCommand: "pnpm add mssql",
+        execute: executeSQLServer,
+    },
+};
+/** True when `value` is a registry key (own property — rejects `constructor`, `__proto__`, …). */
+export function isStudioExecuteProvider(value) {
+    return typeof value === "string" && Object.hasOwn(EXECUTE_DRIVER_REGISTRY, value);
+}
+/**
+ * Check whether a driver package is resolvable from the user's project root.
+ */
+export function isDriverInstalled(packageName, projectRoot) {
+    switch (packageName) {
+        case "pg":
+            return isPgDriverInstalled({ resolveFrom: projectRoot });
+        case "mysql2":
+            return isMysql2DriverInstalled({ resolveFrom: projectRoot });
+        case "better-sqlite3":
+            return isBetterSqlite3DriverInstalled({ resolveFrom: projectRoot });
+        case "mssql":
+            return isMssqlDriverInstalled({ resolveFrom: projectRoot });
+        default:
+            return false;
+    }
+}
+//# sourceMappingURL=execute-registry.js.map

package/dist/execute-registry.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { createStudioServer, serializeWorkspace } from "./server.js";
 export type { StudioOptions, StudioServer } from "./server.js";
 export { runStudioCli } from "./cli.js";
+export { runStudioBin } from "./bin.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,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
 export { createStudioServer, serializeWorkspace } from "./server.js";
 export { runStudioCli } from "./cli.js";
+export { runStudioBin } from "./bin.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,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAErE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}

package/dist/introspection.d.ts

@@ -0,0 +1,35 @@
+import { type ConnectorProviderId } from "@askdb/introspect";
+export type StudioIntrospectionPlan = {
+    ok: true;
+    engine: ConnectorProviderId;
+    sourceLabel: string;
+} | {
+    ok: false;
+    engine: ConnectorProviderId | null;
+    error: string;
+};
+/**
+ * Resolve what a server-side introspection run would do, from the runtime
+ * config alone: the config's provider (its adapter loaded), and the connection its adapter's
+ * `resolveConnection` hook resolves (the same registry call the CLI makes).
+ * Never includes credentials in `sourceLabel` — it is shown in the UI.
+ */
+export declare function resolveStudioIntrospectionPlan(): Promise<StudioIntrospectionPlan>;
+export type StudioIntrospectionRun = {
+    engine: ConnectorProviderId;
+    schemaId: string;
+    tables: number;
+    warnings: string[];
+};
+/**
+ * Run introspection server-side into `outDir`, preserving any existing
+ * enrichment markdown (the writer keeps `tables/*.md`, `concepts.md`, and
+ * `tenant-policy.md` when `existingArtifactDir` is supplied — the same
+ * guarantee `askdb introspect` gives).
+ */
+export declare function runStudioIntrospection(options: {
+    outDir: string;
+    schemaId?: string;
+    hasExistingArtifact: boolean;
+}): Promise<StudioIntrospectionRun>;
+//# sourceMappingURL=introspection.d.ts.map

package/dist/introspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspection.d.ts","sourceRoot":"","sources":["../src/introspection.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,mBAAmB,EAEzB,MAAM,mBAAmB,CAAC;AA+B3B,MAAM,MAAM,uBAAuB,GAC/B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErE;;;;;GAKG;AACH,wBAAsB,8BAA8B,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAevF;AAaD,MAAM,MAAM,sBAAsB,GAAG;IACnC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,EAAE,OAAO,CAAC;CAC9B,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAoClC"}

package/dist/introspection.js

@@ -0,0 +1,106 @@
+import { basename } from "node:path";
+import { getAskDbRuntimeConfig } from "@askdb/config";
+import { connectorPackageMissingMessage, createConnectorRegistry, introspect, } from "@askdb/introspect";
+import { createOptionalDriverLoader, rethrowDriverImportError } from "@askdb/introspect/kit";
+import { postgresConnectorProvider } from "@askdb/postgres";
+import { mysqlConnectorProvider } from "@askdb/mysql";
+import { sqliteConnectorProvider } from "@askdb/sqlite";
+import { sqlServerConnectorProvider } from "@askdb/sqlserver";
+import { PRISMA_BUILD_APPROVALS } from "./prisma-install.js";
+/**
+ * `@askdb/prisma` is an optional peer of Studio, as of `askdb` (#259). It is imported
+ * only when the config selects the prisma engine, from Studio's install first, then
+ * from the project in the working directory. The CLI registers it the same way.
+ */
+const prismaPackage = createOptionalDriverLoader({
+    packageName: "@askdb/prisma",
+    importDriver: () => import("@askdb/prisma").catch(rethrowDriverImportError),
+    missingMessage: connectorPackageMissingMessage({
+        provider: "prisma",
+        packageName: "@askdb/prisma",
+        allowBuilds: PRISMA_BUILD_APPROVALS,
+    }),
+});
+const connectorRegistry = createConnectorRegistry([
+    postgresConnectorProvider,
+    mysqlConnectorProvider,
+    sqliteConnectorProvider,
+    sqlServerConnectorProvider,
+    { provider: "prisma", load: async () => (await prismaPackage.load()).prismaConnectorProvider },
+]);
+/**
+ * Resolve what a server-side introspection run would do, from the runtime
+ * config alone: the config's provider (its adapter loaded), and the connection its adapter's
+ * `resolveConnection` hook resolves (the same registry call the CLI makes).
+ * Never includes credentials in `sourceLabel` — it is shown in the UI.
+ */
+export async function resolveStudioIntrospectionPlan() {
+    const rt = getAskDbRuntimeConfig();
+    const engine = rt.introspection.provider;
+    if (!connectorRegistry.hasProvider(engine)) {
+        return { ok: false, engine: null, error: `Unsupported introspection provider: ${engine}` };
+    }
+    try {
+        // Imports an optional engine package (`@askdb/prisma`); a missing one is the plan's error.
+        await connectorRegistry.load(engine);
+    }
+    catch (error) {
+        return { ok: false, engine, error: error instanceof Error ? error.message : String(error) };
+    }
+    const connection = resolveConnection(engine);
+    if (!connection.ok)
+        return { ok: false, engine, error: connection.error };
+    return { ok: true, engine, sourceLabel: connection.sourceLabel };
+}
+/**
+ * The engine's adapter resolves its connection from askdb.config/env (the same
+ * hook the CLI uses) and phrases missing-config errors in terms of config keys.
+ */
+function resolveConnection(engine) {
+    return connectorRegistry.resolveConnection(engine, {
+        runtime: getAskDbRuntimeConfig(),
+        surface: "studio",
+    });
+}
+/**
+ * Run introspection server-side into `outDir`, preserving any existing
+ * enrichment markdown (the writer keeps `tables/*.md`, `concepts.md`, and
+ * `tenant-policy.md` when `existingArtifactDir` is supplied — the same
+ * guarantee `askdb introspect` gives).
+ */
+export async function runStudioIntrospection(options) {
+    const plan = await resolveStudioIntrospectionPlan();
+    if (!plan.ok)
+        throw new Error(plan.error);
+    const connection = resolveConnection(plan.engine);
+    if (!connection.ok)
+        throw new Error(connection.error);
+    const schemaId = options.schemaId ?? inferSchemaId(options.outDir);
+    // Resync reads the same schema list `askdb introspect` does (introspection.schemas).
+    const schemas = getAskDbRuntimeConfig().introspection.schemas;
+    const connectorConfig = {
+        provider: plan.engine,
+        ...connection.connection,
+        schemaId,
+        ...(schemas ? { filters: { schemas } } : {}),
+    };
+    const runConfig = connectorRegistry.createConnector(connectorConfig);
+    const connector = runConfig.connector;
+    const result = await introspect(runConfig.input, {
+        outDir: options.outDir,
+        schemaId,
+        existingArtifactDir: options.hasExistingArtifact ? options.outDir : undefined,
+    }, { connector });
+    return {
+        engine: plan.engine,
+        schemaId,
+        tables: result.schema.schemas.reduce((sum, namespace) => sum + namespace.tables.length, 0),
+        warnings: result.warnings.map((warning) => typeof warning === "string" ? warning : JSON.stringify(warning)),
+    };
+}
+function inferSchemaId(path) {
+    const name = basename(path);
+    const inferred = name.endsWith(".schema") ? name.slice(0, -".schema".length) : name;
+    return inferred || "introspected";
+}
+//# sourceMappingURL=introspection.js.map

package/dist/introspection.js.map

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