@askdb/introspect 0.3.0-beta.17 → 0.3.0-beta.18

package/dist/kit/label.js

@@ -0,0 +1,110 @@
+/**
+ * Connection labels: the credential-free text shown for a configured database
+ * connection (Studio's `GET /api/introspect/status` `sourceLabel`).
+ *
+ * A label is built only from parts an engine's parser extracted cleanly — host,
+ * port, database, or a SQLite file path — and only when each part passes the
+ * allowlist below. No other substring of the input is ever copied. Input that
+ * does not parse cleanly, or a part that fails its allowlist, becomes
+ * `configured <engine> connection`. Nothing here masks: see
+ * docs/adrs/0011-connection-labels-from-parsed-parts.md for why.
+ */
+const HOST = /^(?:[A-Za-z0-9_](?:[A-Za-z0-9_.-]*[A-Za-z0-9_])?|\[[0-9A-Fa-f:.]+\])$/;
+const PORT = /^[0-9]{1,5}$/;
+const DATABASE = /^[A-Za-z0-9_$.-]+$/;
+// A plain filesystem path: no control characters, and none of the characters
+// that would make it a URI query/fragment, a `key=value` list, or userinfo.
+const FILE = /^[^\u0000-\u001f\u007f?#;=@]+$/;
+/**
+ * Build a connection label from parsed parts: `<engine>://host[:port][/database]`
+ * for network engines, the path itself for a file. Returns
+ * `configured <engine> connection` when `parts` is `undefined` (the input did
+ * not parse) or any part fails its allowlist. The shape is checked at runtime
+ * too, because a plain-JS adapter can return anything: a value that isn't a
+ * plain object (a string, an array, a `URL`), or a part that isn't a string,
+ * also gets the fallback instead of throwing.
+ */
+export function formatConnectionLabel(engine, parts) {
+    const fallback = `configured ${engine} connection`;
+    if (!isPlainObject(parts))
+        return fallback;
+    if ("file" in parts) {
+        const { file } = parts;
+        return typeof file === "string" && FILE.test(file) && !file.includes("://") ? file : fallback;
+    }
+    const raw = parts;
+    if (![raw.host, raw.port, raw.database].every((part) => part === undefined || typeof part === "string")) {
+        return fallback;
+    }
+    const { host, port, database } = raw;
+    if (host === undefined && database === undefined)
+        return fallback;
+    if (host !== undefined && !HOST.test(host))
+        return fallback;
+    if (port !== undefined && (host === undefined || !PORT.test(port)))
+        return fallback;
+    if (database !== undefined && !DATABASE.test(database))
+        return fallback;
+    return `${engine}://${host ?? ""}${port === undefined ? "" : `:${port}`}${database === undefined ? "" : `/${database}`}`;
+}
+function isPlainObject(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+// scheme://authority[/path][?query] — no fragment, and the whole input must match.
+const URL_FORM = /^([A-Za-z][A-Za-z0-9+.-]*):\/\/([^/?#]*)(\/[^?#]*)?(?:\?[^#]*)?$/;
+/**
+ * Parse a standard `scheme://[user[:password]@]host[:port][/database][?query]`
+ * connection URL (Postgres, MySQL, SQL Server `mssql://`) into label parts.
+ * Userinfo and the query string are never returned. Returns `undefined` —
+ * so the label falls back — when:
+ *
+ * - the scheme is not one of `schemes` (so `jdbc:postgresql://…`, a quoted
+ *   URL, and `postgres:/…` all fall back);
+ * - the input contains whitespace, a control character, or a `#`;
+ * - an `@` appears after the authority (a password containing `/`, `?` or `#`
+ *   cut the authority short, so where it ends is unknown);
+ * - the host is not a single `host[:port]`, or the path has more than one segment.
+ */
+export function parseConnectionUrl(input, schemes) {
+    if (/[\s\u0000-\u001f\u007f]/.test(input))
+        return undefined;
+    const match = URL_FORM.exec(input);
+    if (!match)
+        return undefined;
+    const [, scheme = "", authority = "", path = ""] = match;
+    if (!schemes.includes(scheme.toLowerCase()))
+        return undefined;
+    const authorityEnd = scheme.length + "://".length + authority.length;
+    if (input.includes("@", authorityEnd))
+        return undefined;
+    const hostPort = splitHostPort(authority.slice(authority.lastIndexOf("@") + 1));
+    if (!hostPort)
+        return undefined;
+    const database = path.length > 1 ? path.slice(1) : undefined;
+    if (database?.includes("/"))
+        return undefined;
+    return {
+        ...(hostPort.host === "" ? {} : { host: hostPort.host }),
+        ...(hostPort.port === undefined ? {} : { port: hostPort.port }),
+        ...(database === undefined ? {} : { database }),
+    };
+}
+function splitHostPort(value) {
+    if (value.startsWith("[")) {
+        const close = value.indexOf("]");
+        if (close === -1)
+            return undefined;
+        const rest = value.slice(close + 1);
+        if (rest === "")
+            return { host: value.slice(0, close + 1) };
+        return rest.startsWith(":") ? { host: value.slice(0, close + 1), port: rest.slice(1) } : undefined;
+    }
+    const pieces = value.split(":");
+    if (pieces.length > 2)
+        return undefined;
+    return pieces.length === 2 ? { host: pieces[0], port: pieces[1] } : { host: value };
+}
+//# sourceMappingURL=label.js.map

package/dist/kit/label.js.map

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

package/dist/kit/provider.d.ts

@@ -0,0 +1,57 @@
+import type { ConnectorProviderAdapter, ConnectorProviderId, ConnectorRuntimeConfig } from "../registry.js";
+import type { CatalogQueryRunner, Connector, IntrospectionFilters } from "../types.js";
+import type { ConnectionLabelParts } from "./label.js";
+/** Input shape of a live-only catalog connector: `{ mode: "live", runner, filters? }`. */
+export type LiveCatalogInput = {
+    mode: "live";
+    runner: CatalogQueryRunner;
+    filters?: IntrospectionFilters;
+};
+export type LiveConnectorProviderSpec = {
+    provider: ConnectorProviderId;
+    /** Engine name used in error messages, e.g. `"MySQL"`. */
+    displayName: string;
+    /**
+     * Key in `runtime.introspection` (from `@askdb/config`) holding the configured
+     * connection, e.g. `"mysqlDatabaseUrl"`. An explicit `url` always wins.
+     */
+    runtimeKey: string;
+    /** What `config.url` holds, for the missing-url error: `"a connection URL"`, `"a file path"`. */
+    connectionNoun: string;
+    /**
+     * Error when the caller passes an export bundle (`--from-export`), which a
+     * live-only engine can't read. Defaults to
+     * `--from-export is not supported for --engine <provider>.`
+     */
+    fromExportUnsupported?: string;
+    /**
+     * Error when neither an explicit URL nor a configured one exists: `cli` names
+     * `askdb introspect` flags, `config` names `askdb.config.ts` keys.
+     */
+    missingConnection: {
+        cli: string;
+        config: string;
+    };
+    createConnector(): Connector<LiveCatalogInput>;
+    createRunner(url: string): CatalogQueryRunner;
+    /**
+     * The display-safe parts of a connection string (`{ host?, port?, database? }`
+     * or `{ file }`), parsed by the engine's own rules, or `undefined` when it
+     * doesn't parse cleanly. Becomes the adapter's `connectionLabelParts`; the
+     * registry builds the label from it (ADR 0011).
+     */
+    connectionLabelParts(url: string): ConnectionLabelParts | undefined;
+};
+/**
+ * Build the `ConnectorProviderAdapter` for an engine that introspects a live
+ * database through a `CatalogQueryRunner` only (no export bundle, no schema
+ * file) — the shape shared by `@askdb/mysql`, `@askdb/sqlite`, and
+ * `@askdb/sqlserver`.
+ */
+export declare function defineLiveConnectorProvider(spec: LiveConnectorProviderSpec): ConnectorProviderAdapter;
+/**
+ * Read a non-empty string from `runtime.introspection[key]` — the shape
+ * `@askdb/config` resolves per-engine connection values into.
+ */
+export declare function runtimeIntrospectionString(runtime: ConnectorRuntimeConfig, key: string): string | undefined;
+//# sourceMappingURL=provider.d.ts.map

package/dist/kit/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../../src/kit/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC5G,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,0FAA0F;AAC1F,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,0DAA0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,iGAAiG;IACjG,cAAc,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B;;;OAGG;IACH,iBAAiB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,eAAe,IAAI,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC/C,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAC9C;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS,CAAC;CACrE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,yBAAyB,GAAG,wBAAwB,CAkCrG;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,sBAAsB,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG3G"}

package/dist/kit/provider.js

@@ -0,0 +1,50 @@
+/**
+ * Build the `ConnectorProviderAdapter` for an engine that introspects a live
+ * database through a `CatalogQueryRunner` only (no export bundle, no schema
+ * file) — the shape shared by `@askdb/mysql`, `@askdb/sqlite`, and
+ * `@askdb/sqlserver`.
+ */
+export function defineLiveConnectorProvider(spec) {
+    return {
+        provider: spec.provider,
+        createConnector(config) {
+            if (!config.url) {
+                throw new Error(`${spec.displayName} connector requires ${spec.connectionNoun} (config.url).`);
+            }
+            const input = {
+                mode: "live",
+                runner: spec.createRunner(config.url),
+                filters: config.filters,
+            };
+            return { mode: "live", input, connector: spec.createConnector() };
+        },
+        resolveConnection({ explicit = {}, runtime, surface }) {
+            const url = explicit.url ?? runtimeIntrospectionString(runtime, spec.runtimeKey);
+            if (!url) {
+                return {
+                    ok: false,
+                    error: surface === "cli" ? spec.missingConnection.cli : spec.missingConnection.config,
+                };
+            }
+            if (explicit.fromExport) {
+                return {
+                    ok: false,
+                    error: spec.fromExportUnsupported ?? `--from-export is not supported for --engine ${spec.provider}.`,
+                };
+            }
+            return { ok: true, connection: { url } };
+        },
+        connectionLabelParts({ url }) {
+            return url === undefined ? undefined : spec.connectionLabelParts(url);
+        },
+    };
+}
+/**
+ * Read a non-empty string from `runtime.introspection[key]` — the shape
+ * `@askdb/config` resolves per-engine connection values into.
+ */
+export function runtimeIntrospectionString(runtime, key) {
+    const value = runtime.introspection[key];
+    return typeof value === "string" && value !== "" ? value : undefined;
+}
+//# sourceMappingURL=provider.js.map

package/dist/kit/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/kit/provider.ts"],"names":[],"mappings":"AA4CA;;;;;GAKG;AACH,MAAM,UAAU,2BAA2B,CAAC,IAA+B;IACzE,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,eAAe,CAAC,MAAM;YACpB,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,WAAW,uBAAuB,IAAI,CAAC,cAAc,gBAAgB,CAAC,CAAC;YACjG,CAAC;YACD,MAAM,KAAK,GAAqB;gBAC9B,IAAI,EAAE,MAAM;gBACZ,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC;gBACrC,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;YACF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,eAAe,EAAwB,EAAE,CAAC;QAC1F,CAAC;QACD,iBAAiB,CAAC,EAAE,QAAQ,GAAG,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;YACnD,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,IAAI,0BAA0B,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACjF,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM;iBACtF,CAAC;YACJ,CAAC;YACD,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACxB,OAAO;oBACL,EAAE,EAAE,KAAK;oBACT,KAAK,EAAE,IAAI,CAAC,qBAAqB,IAAI,+CAA+C,IAAI,CAAC,QAAQ,GAAG;iBACrG,CAAC;YACJ,CAAC;YACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,EAAE,CAAC;QAC3C,CAAC;QACD,oBAAoB,CAAC,EAAE,GAAG,EAAE;YAC1B,OAAO,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC;QACxE,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAA+B,EAAE,GAAW;IACrF,MAAM,KAAK,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvE,CAAC"}

package/dist/kit/rows.d.ts

@@ -0,0 +1,42 @@
+import type { CatalogQueryResult, SqlForeignKeyAction } from "../types.js";
+export type RowsToRecordsOptions = {
+    /**
+     * Columns the caller's SQL promises to return. When set, only these columns
+     * are copied into each record, and a result that lacks one of them throws —
+     * that signals a runner or bundle that does not match the query's contract.
+     * When omitted, every returned column is copied.
+     */
+    expectedColumns?: readonly string[];
+    /** Prefix for the missing-column error, e.g. `"@askdb/postgres"`. */
+    source?: string;
+};
+/**
+ * Turn a positional `CatalogQueryResult` into one record per row keyed by
+ * column name. A result with zero rows yields `[]` even when the runner
+ * omitted the column headers (some drivers / fake runners don't populate them
+ * on empty result sets).
+ */
+export declare function rowsToRecords<T>(result: CatalogQueryResult, options?: RowsToRecordsOptions): T[];
+/** Group rows by key, preserving first-seen key order and row order within a group. */
+export declare function groupBy<T, K>(rows: Iterable<T>, key: (row: T) => K): Map<K, T[]>;
+/**
+ * Group rows by key, order each group by `position` (e.g. a constraint's
+ * column ordinal), and build one named object per group; `build` may return
+ * `undefined` to drop a group. The result is sorted by name — the shape every
+ * multi-column constraint/index builder needs for deterministic output.
+ */
+export declare function buildOrderedGroups<T, K, R extends {
+    name: string;
+}>(rows: Iterable<T>, key: (row: T) => K, position: (row: T) => number, build: (key: K, ordered: T[]) => R | undefined): R[];
+/** Comparator: `localeCompare` on `.name`. */
+export declare function byName<T extends {
+    name: string;
+}>(a: T, b: T): number;
+/** Deduplicate and `localeCompare`-sort. */
+export declare function sortedUnique(values: Iterable<string>): string[];
+/**
+ * Map an SQL-standard referential action name (`CASCADE`, `SET NULL`, …;
+ * case-insensitive) to the Schema v2 action. Unknown or empty → `undefined`.
+ */
+export declare function mapFkAction(rule: string | null | undefined): SqlForeignKeyAction | undefined;
+//# sourceMappingURL=rows.d.ts.map

package/dist/kit/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../src/kit/rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE3E,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;;OAKG;IACH,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,kBAAkB,EAAE,OAAO,GAAE,oBAAyB,GAAG,CAAC,EAAE,CAsBpG;AAED,uFAAuF;AACvF,wBAAgB,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAShF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACjE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EACjB,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAClB,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,EAC5B,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,CAAC,GAAG,SAAS,GAC7C,CAAC,EAAE,CAOL;AAED,8CAA8C;AAC9C,wBAAgB,MAAM,CAAC,CAAC,SAAS;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,MAAM,CAErE;AAED,4CAA4C;AAC5C,wBAAgB,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAE/D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS,CAS5F"}

package/dist/kit/rows.js

@@ -0,0 +1,86 @@
+/**
+ * Turn a positional `CatalogQueryResult` into one record per row keyed by
+ * column name. A result with zero rows yields `[]` even when the runner
+ * omitted the column headers (some drivers / fake runners don't populate them
+ * on empty result sets).
+ */
+export function rowsToRecords(result, options = {}) {
+    if (result.rows.length === 0)
+        return [];
+    const indexByName = new Map();
+    if (options.expectedColumns) {
+        for (const name of options.expectedColumns) {
+            const idx = result.columns.indexOf(name);
+            if (idx === -1) {
+                const prefix = options.source ? `${options.source}: ` : "";
+                throw new Error(`${prefix}result is missing column '${name}' (got [${result.columns.join(", ")}])`);
+            }
+            indexByName.set(name, idx);
+        }
+    }
+    else {
+        for (let i = 0; i < result.columns.length; i++)
+            indexByName.set(result.columns[i], i);
+    }
+    return result.rows.map((row) => {
+        const record = {};
+        for (const [name, idx] of indexByName)
+            record[name] = row[idx];
+        return record;
+    });
+}
+/** Group rows by key, preserving first-seen key order and row order within a group. */
+export function groupBy(rows, key) {
+    const out = new Map();
+    for (const row of rows) {
+        const k = key(row);
+        const list = out.get(k) ?? [];
+        list.push(row);
+        out.set(k, list);
+    }
+    return out;
+}
+/**
+ * Group rows by key, order each group by `position` (e.g. a constraint's
+ * column ordinal), and build one named object per group; `build` may return
+ * `undefined` to drop a group. The result is sorted by name — the shape every
+ * multi-column constraint/index builder needs for deterministic output.
+ */
+export function buildOrderedGroups(rows, key, position, build) {
+    const out = [];
+    for (const [k, list] of groupBy(rows, key)) {
+        const built = build(k, list.slice().sort((a, b) => position(a) - position(b)));
+        if (built !== undefined)
+            out.push(built);
+    }
+    return out.sort(byName);
+}
+/** Comparator: `localeCompare` on `.name`. */
+export function byName(a, b) {
+    return a.name.localeCompare(b.name);
+}
+/** Deduplicate and `localeCompare`-sort. */
+export function sortedUnique(values) {
+    return Array.from(new Set(values)).sort((a, b) => a.localeCompare(b));
+}
+/**
+ * Map an SQL-standard referential action name (`CASCADE`, `SET NULL`, …;
+ * case-insensitive) to the Schema v2 action. Unknown or empty → `undefined`.
+ */
+export function mapFkAction(rule) {
+    if (!rule)
+        return undefined;
+    const r = rule.toLowerCase();
+    if (r === "cascade")
+        return "cascade";
+    if (r === "restrict")
+        return "restrict";
+    if (r === "set null")
+        return "set null";
+    if (r === "set default")
+        return "set default";
+    if (r === "no action")
+        return "no action";
+    return undefined;
+}
+//# sourceMappingURL=rows.js.map

package/dist/kit/rows.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,144 @@
+import { type ConnectionLabelParts } from "./kit/label.js";
+import type { Connector, IntrospectionFilters, SqlTemplateBundle } from "./types.js";
+/** Provider ids of the first-party engine packages (`@askdb/<id>`). */
+export declare const BUILT_IN_CONNECTOR_PROVIDERS: readonly ["postgres", "prisma", "mysql", "sqlite", "sqlserver"];
+export type BuiltInConnectorProvider = (typeof BUILT_IN_CONNECTOR_PROVIDERS)[number];
+/**
+ * A connector provider id. Open: any string is valid, so a third-party engine
+ * package registers its own id without editing AskDB. The built-in ids stay in
+ * the type for editor autocompletion.
+ */
+export type ConnectorProviderId = BuiltInConnectorProvider | (string & {});
+/**
+ * Unified config passed to a connector provider adapter. The registry converts
+ * this into the engine-specific connector + input pair consumed by `introspect()`.
+ */
+export type ConnectorConfig = {
+    provider: ConnectorProviderId;
+    /** Connection URL for live introspection (postgres, mysql, sqlserver) or file path (sqlite). */
+    url?: string;
+    /** Bundle directory path for from-export mode (postgres only). */
+    fromExport?: string;
+    /** Prisma schema file path or directory containing `.prisma` files (prisma only). */
+    schemaPath?: string;
+    filters?: IntrospectionFilters;
+    /** Schema ID embedded in the resulting `SqlSchema`. Defaults to `"introspected"`. */
+    schemaId?: string;
+};
+/** Connector + typed input pair returned by a provider adapter. */
+export type ConnectorResult = {
+    connector: Connector<unknown>;
+    input: unknown;
+    /** Informational mode string (e.g. `"live"`, `"from-export"`, `"prisma-schema"`). */
+    mode: string;
+};
+/** Where a connection comes from: the three `ConnectorConfig` source fields. */
+export type ConnectorConnection = Pick<ConnectorConfig, "url" | "fromExport" | "schemaPath">;
+/**
+ * The AskDB runtime configuration an adapter resolves its connection from.
+ * Structurally typed so engine packages need not depend on `@askdb/config`;
+ * pass `getAskDbRuntimeConfig()` from `@askdb/config` as-is.
+ */
+export type ConnectorRuntimeConfig = {
+    /**
+     * Resolved introspection values (`getAskDbRuntimeConfig().introspection`),
+     * e.g. `postgresDatabaseUrl`, `sqliteFile`, `prismaSchemaPath` — config file
+     * first, then the engine's env var, as resolved by `@askdb/config`.
+     */
+    readonly introspection: Readonly<Record<string, unknown>>;
+    /**
+     * The authoring-time config (`getAskDbRuntimeConfig().structured`). Engines
+     * without a first-class runtime field read their own block from
+     * `structured.introspection.providerConfig.<id>` here: `@askdb/config` passes
+     * it through unchanged, though its typed config doesn't declare third-party
+     * ids yet.
+     */
+    readonly structured?: unknown;
+};
+export type ConnectorConnectionRequest = {
+    /** Values the caller passed explicitly (e.g. CLI flags). They take precedence over config. */
+    explicit?: ConnectorConnection;
+    /** AskDB runtime configuration to fall back to. */
+    runtime: ConnectorRuntimeConfig;
+    /**
+     * The surface asking, so errors can point at the right fix: `"cli"` names
+     * `askdb introspect` flags; anything else (e.g. `"studio"`) names config keys.
+     */
+    surface?: "cli" | "studio" | (string & {});
+};
+/**
+ * What an adapter's `resolveConnection` returns: the connection, or an error.
+ * The error is shown to users as-is, so it must never echo the connection
+ * string. There is no label here: the registry builds it (ADR 0011).
+ */
+export type ConnectorConnectionResult = {
+    ok: true;
+    connection: ConnectorConnection;
+} | {
+    ok: false;
+    error: string;
+};
+/** What `registry.resolveConnection` returns: the adapter's result plus the registry-built label. */
+export type ConnectorConnectionResolution = {
+    ok: true;
+    connection: ConnectorConnection;
+    /**
+     * Credential-free description of the source, safe to show in a UI or log:
+     * `registry.connectionLabel(provider, connection)`.
+     */
+    sourceLabel: string;
+} | {
+    ok: false;
+    error: string;
+};
+export type ConnectorProviderAdapter = {
+    provider: ConnectorProviderId;
+    createConnector(config: ConnectorConfig): ConnectorResult;
+    /** Returns the engine's catalog SQL template bundle, if the engine supports it. */
+    getTemplates?(): SqlTemplateBundle;
+    /**
+     * Turn explicit values + AskDB runtime config into this engine's connection
+     * (URL, export bundle, or schema path), applying the engine's precedence and
+     * validation. Hosts (CLI, Studio) call this instead of switching on the engine.
+     * When omitted, the registry passes `explicit` through unchanged.
+     */
+    resolveConnection?(request: ConnectorConnectionRequest): ConnectorConnectionResult;
+    /**
+     * The parts of `connection` that are safe to display (host, port, database,
+     * or a file path), parsed by the engine's own rules; `undefined` when the
+     * connection doesn't parse cleanly. The registry turns them into the label
+     * with `formatConnectionLabel`, so an adapter never supplies label text
+     * itself (ADR 0011).
+     */
+    connectionLabelParts?(connection: ConnectorConnection): ConnectionLabelParts | undefined;
+};
+export type ConnectorProviderAdapters = readonly ConnectorProviderAdapter[] | Readonly<Record<string, ConnectorProviderAdapter | undefined>>;
+export type ConnectorRegistry = {
+    hasProvider(provider: string): boolean;
+    /** Registered provider ids, in registration order. */
+    providers(): ConnectorProviderId[];
+    createConnector(config: ConnectorConfig): ConnectorResult;
+    /**
+     * Returns the catalog SQL template bundle for the given provider, or `undefined`
+     * if the provider is not registered or does not support templates.
+     */
+    getTemplates(provider: string): SqlTemplateBundle | undefined;
+    /**
+     * Resolve a provider's connection via its adapter's `resolveConnection` hook
+     * (or pass `explicit` through when the adapter has none), with `sourceLabel`
+     * from `connectionLabel`. A blank explicit value (empty or whitespace-only)
+     * counts as absent, so the configured connection applies. Throws when the
+     * provider is not registered.
+     */
+    resolveConnection(provider: string, request: ConnectorConnectionRequest): ConnectorConnectionResolution;
+    /**
+     * A credential-free label for a connection, safe to show in a UI or log:
+     * `formatConnectionLabel(provider, parts)` over the adapter's
+     * `connectionLabelParts`. A provider that is not registered, has no hook, or
+     * returns `undefined` gets `configured <provider> connection`.
+     */
+    connectionLabel(provider: string, connection: ConnectorConnection): string;
+};
+export declare function createConnectorRegistry(adapters: ConnectorProviderAdapters): ConnectorRegistry;
+export declare function connectorProviderMissingMessage(provider: string): string;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

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

package/dist/registry.js

@@ -0,0 +1,91 @@
+import { formatConnectionLabel } from "./kit/label.js";
+/** Provider ids of the first-party engine packages (`@askdb/<id>`). */
+export const BUILT_IN_CONNECTOR_PROVIDERS = [
+    "postgres",
+    "prisma",
+    "mysql",
+    "sqlite",
+    "sqlserver",
+];
+export function createConnectorRegistry(adapters) {
+    const byProvider = normalizeAdapters(adapters);
+    function adapterFor(provider) {
+        const adapter = byProvider.get(provider);
+        if (!adapter)
+            throw new Error(connectorProviderMissingMessage(provider));
+        return adapter;
+    }
+    return {
+        hasProvider(provider) {
+            return byProvider.has(provider);
+        },
+        providers() {
+            return [...byProvider.keys()];
+        },
+        createConnector(config) {
+            return adapterFor(config.provider).createConnector(config);
+        },
+        getTemplates(provider) {
+            return byProvider.get(provider)?.getTemplates?.();
+        },
+        resolveConnection(provider, request) {
+            const adapter = adapterFor(provider);
+            // A blank explicit value (an empty form field or env var a host forwards)
+            // is absent, so the configured connection still applies.
+            const normalized = { ...request, explicit: withoutBlankValues(request.explicit) };
+            const result = adapter.resolveConnection
+                ? adapter.resolveConnection(normalized)
+                : { ok: true, connection: { ...normalized.explicit } };
+            if (!result.ok)
+                return result;
+            return { ...result, sourceLabel: labelFor(adapter, provider, result.connection) };
+        },
+        connectionLabel(provider, connection) {
+            return labelFor(byProvider.get(provider), provider, connection);
+        },
+    };
+}
+function labelFor(adapter, provider, connection) {
+    try {
+        return formatConnectionLabel(provider, adapter?.connectionLabelParts?.(connection));
+    }
+    catch {
+        // A throwing parser, or parts whose getter or Proxy trap throws while
+        // being read, get the fallback. The message may quote the connection
+        // string, so it must never become user-visible text.
+        return formatConnectionLabel(provider, undefined);
+    }
+}
+export function connectorProviderMissingMessage(provider) {
+    const install = BUILT_IN_CONNECTOR_PROVIDERS.includes(provider)
+        ? `Install @askdb/${provider}`
+        : "Install the package that provides it";
+    return (`Connector provider "${provider}" is not registered. ` +
+        `${install} and pass its connector provider adapter to createConnectorRegistry().`);
+}
+function withoutBlankValues(explicit) {
+    if (explicit === undefined)
+        return undefined;
+    return Object.fromEntries(Object.entries(explicit).filter(([, value]) => typeof value !== "string" || value.trim() !== ""));
+}
+function normalizeAdapters(adapters) {
+    const entries = Array.isArray(adapters)
+        ? adapters.map((a) => [a.provider, a])
+        : Object.entries(adapters).filter(isAdapterEntry);
+    const byProvider = new Map();
+    for (const [provider, adapter] of entries) {
+        if (adapter.provider !== provider) {
+            throw new Error(`Connector provider adapter mismatch: registry key "${provider}" points to adapter "${adapter.provider}".`);
+        }
+        // A second adapter for the same id would silently replace the first one.
+        if (byProvider.has(provider)) {
+            throw new Error(`Connector provider "${provider}" is registered twice. Pass one adapter per provider id to createConnectorRegistry().`);
+        }
+        byProvider.set(provider, adapter);
+    }
+    return byProvider;
+}
+function isAdapterEntry(entry) {
+    return entry[1] !== undefined;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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