@agent-native/core 0.26.8 → 0.27.0

package/dist/client/db-admin/cell-format.js

@@ -0,0 +1,223 @@
+/** Sentinel meaning "store SQL NULL". */
+export const NULL_VALUE = null;
+const NUMBER_TYPES = [
+    "int",
+    "integer",
+    "smallint",
+    "bigint",
+    "serial",
+    "bigserial",
+    "smallserial",
+    "decimal",
+    "numeric",
+    "real",
+    "double",
+    "float",
+    "money",
+];
+const BOOLEAN_TYPES = ["bool", "boolean"];
+const JSON_TYPES = ["json", "jsonb"];
+const TIMESTAMP_TYPES = [
+    "timestamp",
+    "timestamptz",
+    "datetime",
+    "date",
+    "time",
+    "timetz",
+];
+const UUID_TYPES = ["uuid", "guid"];
+function normalizeType(col) {
+    return (col.type || "").toString().trim().toLowerCase();
+}
+/**
+ * Try to pull allowed enum values out of a column definition.
+ *
+ * The base contract column shape (`DbAdminColumn`) only carries a `type`
+ * string, but introspection may attach extra fields per dialect. We probe a
+ * few likely shapes and also parse a Postgres/MySQL-style inline list embedded
+ * in the type string, e.g. `enum('a','b')`.
+ */
+export function inferEnumValues(col) {
+    const anyCol = col;
+    const candidates = [anyCol.enumValues, anyCol.values, anyCol.options];
+    for (const candidate of candidates) {
+        if (Array.isArray(candidate) && candidate.length > 0) {
+            return candidate.map((v) => String(v));
+        }
+    }
+    const type = (col.type || "").toString();
+    const match = type.match(/^\s*(?:enum|set)\s*\((.+)\)\s*$/i);
+    if (match) {
+        const items = match[1]
+            .split(",")
+            .map((s) => s.trim().replace(/^['"]|['"]$/g, ""))
+            .filter((s) => s.length > 0);
+        if (items.length > 0)
+            return items;
+    }
+    return null;
+}
+/** Infer which editor UI a column should use. */
+export function inferEditorKind(col) {
+    const type = normalizeType(col);
+    if (inferEnumValues(col))
+        return "enum";
+    if (UUID_TYPES.some((t) => type.includes(t)))
+        return "uuid";
+    if (BOOLEAN_TYPES.some((t) => type === t || type.includes(t)))
+        return "boolean";
+    if (JSON_TYPES.some((t) => type === t || type.includes(t)))
+        return "json";
+    if (TIMESTAMP_TYPES.some((t) => type.includes(t)))
+        return "timestamp";
+    if (NUMBER_TYPES.some((t) => type.includes(t)))
+        return "number";
+    return "text";
+}
+/** Whether a value is SQL NULL (vs empty string, 0, false, etc). */
+export function isNull(value) {
+    return value === null || value === undefined;
+}
+/**
+ * Format a DB value for compact in-cell display. Returns a marker the cell uses
+ * to render NULL distinctly; for plain string consumers the text is "NULL".
+ */
+export function formatCellValue(value, kind) {
+    if (isNull(value))
+        return { text: "NULL", isNull: true };
+    switch (kind) {
+        case "boolean":
+            return { text: value === true ? "true" : "false", isNull: false };
+        case "json":
+            return { text: formatJsonCompact(value), isNull: false };
+        case "timestamp":
+            return { text: formatTimestamp(value), isNull: false };
+        case "number":
+            return { text: String(value), isNull: false };
+        default:
+            return { text: String(value), isNull: false };
+    }
+}
+/** Compact single-line JSON for cell display. */
+export function formatJsonCompact(value) {
+    if (typeof value === "string") {
+        try {
+            return JSON.stringify(JSON.parse(value));
+        }
+        catch {
+            return value;
+        }
+    }
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+/** Pretty multi-line JSON for the expanded editor. */
+export function formatJsonPretty(value) {
+    if (isNull(value))
+        return "";
+    if (typeof value === "string") {
+        try {
+            return JSON.stringify(JSON.parse(value), null, 2);
+        }
+        catch {
+            return value;
+        }
+    }
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+/** Human-readable timestamp; tolerant of strings, numbers, and Dates. */
+export function formatTimestamp(value) {
+    if (isNull(value))
+        return "";
+    const date = value instanceof Date
+        ? value
+        : typeof value === "number"
+            ? new Date(value)
+            : new Date(String(value));
+    if (Number.isNaN(date.getTime()))
+        return String(value);
+    const pad = (n) => String(n).padStart(2, "0");
+    return (`${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` +
+        `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`);
+}
+/** Convert a DB value to the string an editor input should start with. */
+export function valueToEditString(value, kind) {
+    if (isNull(value))
+        return "";
+    if (kind === "json")
+        return formatJsonPretty(value);
+    if (kind === "timestamp")
+        return formatTimestamp(value);
+    if (kind === "boolean")
+        return value === true ? "true" : "false";
+    return String(value);
+}
+export class ParseError extends Error {
+}
+/**
+ * Parse an edited string back into the JS value sent in the mutation payload.
+ *
+ * `allowEmptyString` distinguishes "" → empty string from "" → NULL. For most
+ * types empty means NULL; for text the editor decides.
+ */
+export function parseEditValue(raw, kind, opts = {}) {
+    if (raw === "") {
+        if (kind === "text" && opts.allowEmptyString)
+            return "";
+        return NULL_VALUE;
+    }
+    const trimmed = raw.trim();
+    switch (kind) {
+        case "number": {
+            const n = Number(trimmed);
+            if (trimmed === "" || Number.isNaN(n)) {
+                throw new ParseError(`"${raw}" is not a valid number`);
+            }
+            return n;
+        }
+        case "boolean": {
+            const v = trimmed.toLowerCase();
+            if (["true", "t", "1", "yes", "y"].includes(v))
+                return true;
+            if (["false", "f", "0", "no", "n"].includes(v))
+                return false;
+            if (v === "null")
+                return NULL_VALUE;
+            throw new ParseError(`"${raw}" is not a valid boolean`);
+        }
+        case "json": {
+            // Accept ANY valid JSON value, including scalars.
+            try {
+                return JSON.parse(trimmed);
+            }
+            catch (err) {
+                throw new ParseError(`Invalid JSON: ${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        case "timestamp":
+        case "uuid":
+        case "enum":
+        case "text":
+        default:
+            // Preserve intentional spaces for text; trim structured types.
+            return kind === "text" ? raw : trimmed;
+    }
+}
+/** Cycle a tri-state boolean: null → true → false → null. */
+export function cycleTriStateBoolean(value) {
+    if (value === null || value === undefined)
+        return true;
+    if (value === true)
+        return false;
+    return null;
+}
+//# sourceMappingURL=cell-format.js.map

package/dist/client/db-admin/cell-format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cell-format.js","sourceRoot":"","sources":["../../../src/client/db-admin/cell-format.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DbAdminColumn } from \"../../db-admin/types.js\";\n\n/**\n * Type-aware cell formatting and parsing helpers for the DB admin grid.\n *\n * These are intentionally dialect-agnostic: they look at the column's `type`\n * string and normalize it into one of a small set of editor \"kinds\" that drive\n * which editor UI is rendered and how values are parsed back into the mutation\n * payload.\n */\n\nexport type EditorKind =\n  | \"text\"\n  | \"number\"\n  | \"boolean\"\n  | \"json\"\n  | \"timestamp\"\n  | \"enum\"\n  | \"uuid\";\n\n/** Sentinel meaning \"store SQL NULL\". */\nexport const NULL_VALUE = null;\n\nconst NUMBER_TYPES = [\n  \"int\",\n  \"integer\",\n  \"smallint\",\n  \"bigint\",\n  \"serial\",\n  \"bigserial\",\n  \"smallserial\",\n  \"decimal\",\n  \"numeric\",\n  \"real\",\n  \"double\",\n  \"float\",\n  \"money\",\n];\n\nconst BOOLEAN_TYPES = [\"bool\", \"boolean\"];\nconst JSON_TYPES = [\"json\", \"jsonb\"];\nconst TIMESTAMP_TYPES = [\n  \"timestamp\",\n  \"timestamptz\",\n  \"datetime\",\n  \"date\",\n  \"time\",\n  \"timetz\",\n];\nconst UUID_TYPES = [\"uuid\", \"guid\"];\n\nfunction normalizeType(col: DbAdminColumn): string {\n  return (col.type || \"\").toString().trim().toLowerCase();\n}\n\n/**\n * Try to pull allowed enum values out of a column definition.\n *\n * The base contract column shape (`DbAdminColumn`) only carries a `type`\n * string, but introspection may attach extra fields per dialect. We probe a\n * few likely shapes and also parse a Postgres/MySQL-style inline list embedded\n * in the type string, e.g. `enum('a','b')`.\n */\nexport function inferEnumValues(col: DbAdminColumn): string[] | null {\n  const anyCol = col as unknown as Record<string, unknown>;\n  const candidates = [anyCol.enumValues, anyCol.values, anyCol.options];\n  for (const candidate of candidates) {\n    if (Array.isArray(candidate) && candidate.length > 0) {\n      return candidate.map((v) => String(v));\n    }\n  }\n  const type = (col.type || \"\").toString();\n  const match = type.match(/^\\s*(?:enum|set)\\s*\\((.+)\\)\\s*$/i);\n  if (match) {\n    const items = match[1]\n      .split(\",\")\n      .map((s) => s.trim().replace(/^['\"]|['\"]$/g, \"\"))\n      .filter((s) => s.length > 0);\n    if (items.length > 0) return items;\n  }\n  return null;\n}\n\n/** Infer which editor UI a column should use. */\nexport function inferEditorKind(col: DbAdminColumn): EditorKind {\n  const type = normalizeType(col);\n\n  if (inferEnumValues(col)) return \"enum\";\n  if (UUID_TYPES.some((t) => type.includes(t))) return \"uuid\";\n  if (BOOLEAN_TYPES.some((t) => type === t || type.includes(t)))\n    return \"boolean\";\n  if (JSON_TYPES.some((t) => type === t || type.includes(t))) return \"json\";\n  if (TIMESTAMP_TYPES.some((t) => type.includes(t))) return \"timestamp\";\n  if (NUMBER_TYPES.some((t) => type.includes(t))) return \"number\";\n  return \"text\";\n}\n\n/** Whether a value is SQL NULL (vs empty string, 0, false, etc). */\nexport function isNull(value: unknown): boolean {\n  return value === null || value === undefined;\n}\n\n/**\n * Format a DB value for compact in-cell display. Returns a marker the cell uses\n * to render NULL distinctly; for plain string consumers the text is \"NULL\".\n */\nexport function formatCellValue(\n  value: unknown,\n  kind: EditorKind,\n): { text: string; isNull: boolean } {\n  if (isNull(value)) return { text: \"NULL\", isNull: true };\n\n  switch (kind) {\n    case \"boolean\":\n      return { text: value === true ? \"true\" : \"false\", isNull: false };\n    case \"json\":\n      return { text: formatJsonCompact(value), isNull: false };\n    case \"timestamp\":\n      return { text: formatTimestamp(value), isNull: false };\n    case \"number\":\n      return { text: String(value), isNull: false };\n    default:\n      return { text: String(value), isNull: false };\n  }\n}\n\n/** Compact single-line JSON for cell display. */\nexport function formatJsonCompact(value: unknown): string {\n  if (typeof value === \"string\") {\n    try {\n      return JSON.stringify(JSON.parse(value));\n    } catch {\n      return value;\n    }\n  }\n  try {\n    return JSON.stringify(value);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Pretty multi-line JSON for the expanded editor. */\nexport function formatJsonPretty(value: unknown): string {\n  if (isNull(value)) return \"\";\n  if (typeof value === \"string\") {\n    try {\n      return JSON.stringify(JSON.parse(value), null, 2);\n    } catch {\n      return value;\n    }\n  }\n  try {\n    return JSON.stringify(value, null, 2);\n  } catch {\n    return String(value);\n  }\n}\n\n/** Human-readable timestamp; tolerant of strings, numbers, and Dates. */\nexport function formatTimestamp(value: unknown): string {\n  if (isNull(value)) return \"\";\n  const date =\n    value instanceof Date\n      ? value\n      : typeof value === \"number\"\n        ? new Date(value)\n        : new Date(String(value));\n  if (Number.isNaN(date.getTime())) return String(value);\n  const pad = (n: number) => String(n).padStart(2, \"0\");\n  return (\n    `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` +\n    `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`\n  );\n}\n\n/** Convert a DB value to the string an editor input should start with. */\nexport function valueToEditString(value: unknown, kind: EditorKind): string {\n  if (isNull(value)) return \"\";\n  if (kind === \"json\") return formatJsonPretty(value);\n  if (kind === \"timestamp\") return formatTimestamp(value);\n  if (kind === \"boolean\") return value === true ? \"true\" : \"false\";\n  return String(value);\n}\n\nexport class ParseError extends Error {}\n\n/**\n * Parse an edited string back into the JS value sent in the mutation payload.\n *\n * `allowEmptyString` distinguishes \"\" → empty string from \"\" → NULL. For most\n * types empty means NULL; for text the editor decides.\n */\nexport function parseEditValue(\n  raw: string,\n  kind: EditorKind,\n  opts: { allowEmptyString?: boolean } = {},\n): unknown {\n  if (raw === \"\") {\n    if (kind === \"text\" && opts.allowEmptyString) return \"\";\n    return NULL_VALUE;\n  }\n\n  const trimmed = raw.trim();\n\n  switch (kind) {\n    case \"number\": {\n      const n = Number(trimmed);\n      if (trimmed === \"\" || Number.isNaN(n)) {\n        throw new ParseError(`\"${raw}\" is not a valid number`);\n      }\n      return n;\n    }\n    case \"boolean\": {\n      const v = trimmed.toLowerCase();\n      if ([\"true\", \"t\", \"1\", \"yes\", \"y\"].includes(v)) return true;\n      if ([\"false\", \"f\", \"0\", \"no\", \"n\"].includes(v)) return false;\n      if (v === \"null\") return NULL_VALUE;\n      throw new ParseError(`\"${raw}\" is not a valid boolean`);\n    }\n    case \"json\": {\n      // Accept ANY valid JSON value, including scalars.\n      try {\n        return JSON.parse(trimmed);\n      } catch (err) {\n        throw new ParseError(\n          `Invalid JSON: ${err instanceof Error ? err.message : String(err)}`,\n        );\n      }\n    }\n    case \"timestamp\":\n    case \"uuid\":\n    case \"enum\":\n    case \"text\":\n    default:\n      // Preserve intentional spaces for text; trim structured types.\n      return kind === \"text\" ? raw : trimmed;\n  }\n}\n\n/** Cycle a tri-state boolean: null → true → false → null. */\nexport function cycleTriStateBoolean(value: unknown): boolean | null {\n  if (value === null || value === undefined) return true;\n  if (value === true) return false;\n  return null;\n}\n"]}

package/dist/client/db-admin/changeset.d.ts

@@ -0,0 +1,74 @@
+import type { DbAdminTableSchema, DbAdminMutation } from "../../db-admin/types.js";
+/**
+ * The staged-changeset model — the production-grade core of the table editor.
+ *
+ * Edits are NOT committed on blur. Instead every cell edit, new row, and
+ * deletion accumulates here until the user explicitly commits (Cmd/Ctrl+S or
+ * the Commit button), at which point {@link buildMutation} maps the staged
+ * state into a single {@link DbAdminMutation}. Until then the grid renders the
+ * staged values overlaid on the fetched rows, and the user can discard
+ * everything.
+ *
+ * Rows are keyed by a stable primary-key string (the table's PK column values
+ * joined). If a table has no primary key, edits target a full-row `where`
+ * match instead, and the consumer should warn / disable editing.
+ */
+/** New rows get a temporary client id so the grid can track them pre-insert. */
+export interface NewRow {
+    /** Stable client-only id, e.g. `new:0`. Never sent to the server. */
+    _localId: string;
+    values: Record<string, unknown>;
+}
+export interface Changeset {
+    /** rowPkString → { column → newValue }. */
+    edits: Map<string, Record<string, unknown>>;
+    /** Staged inserts. */
+    newRows: NewRow[];
+    /** rowPkString of rows staged for deletion. */
+    deletedKeys: Set<string>;
+}
+export interface UseChangesetResult {
+    edits: Map<string, Record<string, unknown>>;
+    newRows: NewRow[];
+    deletedKeys: Set<string>;
+    /** Whether editing is possible (requires a primary key on the table). */
+    canEdit: boolean;
+    /** Stage a single cell edit on an existing row. */
+    setCell: (pk: string, col: string, value: unknown) => void;
+    /** Stage many cell edits on one existing row at once. */
+    setCells: (pk: string, values: Record<string, unknown>) => void;
+    /** Append a blank new row (optionally seeded) and return its local id. */
+    addRow: (seed?: Record<string, unknown>) => string;
+    /** Patch a staged new row's values. */
+    setNewRowCell: (localId: string, col: string, value: unknown) => void;
+    /** Remove a staged new row entirely. */
+    removeNewRow: (localId: string) => void;
+    /** Stage existing rows for deletion (by pk string). Toggles off if re-staged. */
+    deleteRows: (pks: string[]) => void;
+    /** Un-stage a deletion. */
+    undeleteRows: (pks: string[]) => void;
+    /** Clear a single staged cell edit (revert to original). */
+    revertCell: (pk: string, col: string) => void;
+    /** Drop everything. */
+    discardAll: () => void;
+    /** Whether a given existing-row cell is dirty. */
+    isCellDirty: (pk: string, col: string) => boolean;
+    /** The staged value for a cell, if any. */
+    getStagedCell: (pk: string, col: string) => {
+        value: unknown;
+    } | undefined;
+    /** Whether an existing row is staged for deletion. */
+    isDeleted: (pk: string) => boolean;
+    isDirty: boolean;
+    /** Total count of pending changes (edited rows + new rows + deletions). */
+    pendingCount: number;
+    /**
+     * Build the mutation payload. `originalRows` maps pk string → the original
+     * fetched row, used to construct the `where` clause for updates/deletes.
+     */
+    buildMutation: (originalRows: Map<string, Record<string, unknown>>, dryRun?: boolean) => DbAdminMutation;
+}
+/** Compute the stable pk string for a row given the schema's primary key. */
+export declare function pkStringFor(schema: DbAdminTableSchema | undefined, row: Record<string, unknown>): string;
+export declare function useChangeset(schema: DbAdminTableSchema | undefined): UseChangesetResult;
+//# sourceMappingURL=changeset.d.ts.map

package/dist/client/db-admin/changeset.d.ts.map

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

package/dist/client/db-admin/changeset.js

@@ -0,0 +1,169 @@
+import { useCallback, useMemo, useState } from "react";
+/** Compute the stable pk string for a row given the schema's primary key. */
+export function pkStringFor(schema, row) {
+    const cols = schema && schema.primaryKey.length > 0
+        ? schema.primaryKey
+        : // No PK: fall back to a full-row signature so each row is distinct.
+            Object.keys(row).sort();
+    return JSON.stringify(cols.map((c) => row[c] ?? null));
+}
+/** Build the `where` object that uniquely identifies an existing row. */
+function whereFor(schema, row) {
+    if (schema && schema.primaryKey.length > 0) {
+        const where = {};
+        for (const col of schema.primaryKey)
+            where[col] = row[col] ?? null;
+        return where;
+    }
+    // No PK — match the full original row.
+    return { ...row };
+}
+export function useChangeset(schema) {
+    const [edits, setEdits] = useState(() => new Map());
+    const [newRows, setNewRows] = useState([]);
+    const [deletedKeys, setDeletedKeys] = useState(() => new Set());
+    const canEdit = !!schema && schema.primaryKey.length > 0;
+    const setCell = useCallback((pk, col, value) => {
+        setEdits((prev) => {
+            const next = new Map(prev);
+            const row = { ...(next.get(pk) ?? {}) };
+            row[col] = value;
+            next.set(pk, row);
+            return next;
+        });
+    }, []);
+    const setCells = useCallback((pk, values) => {
+        setEdits((prev) => {
+            const next = new Map(prev);
+            const row = { ...(next.get(pk) ?? {}), ...values };
+            next.set(pk, row);
+            return next;
+        });
+    }, []);
+    const revertCell = useCallback((pk, col) => {
+        setEdits((prev) => {
+            if (!prev.has(pk))
+                return prev;
+            const next = new Map(prev);
+            const row = { ...next.get(pk) };
+            delete row[col];
+            if (Object.keys(row).length === 0)
+                next.delete(pk);
+            else
+                next.set(pk, row);
+            return next;
+        });
+    }, []);
+    const addRow = useCallback((seed) => {
+        const localId = `new:${Math.random().toString(36).slice(2)}`;
+        setNewRows((prev) => [...prev, { _localId: localId, values: seed ?? {} }]);
+        return localId;
+    }, []);
+    const setNewRowCell = useCallback((localId, col, value) => {
+        setNewRows((prev) => prev.map((r) => r._localId === localId
+            ? { ...r, values: { ...r.values, [col]: value } }
+            : r));
+    }, []);
+    const removeNewRow = useCallback((localId) => {
+        setNewRows((prev) => prev.filter((r) => r._localId !== localId));
+    }, []);
+    const deleteRows = useCallback((pks) => {
+        setDeletedKeys((prev) => {
+            const next = new Set(prev);
+            for (const pk of pks) {
+                if (next.has(pk))
+                    next.delete(pk);
+                else
+                    next.add(pk);
+            }
+            return next;
+        });
+    }, []);
+    const undeleteRows = useCallback((pks) => {
+        setDeletedKeys((prev) => {
+            const next = new Set(prev);
+            for (const pk of pks)
+                next.delete(pk);
+            return next;
+        });
+    }, []);
+    const discardAll = useCallback(() => {
+        setEdits(new Map());
+        setNewRows([]);
+        setDeletedKeys(new Set());
+    }, []);
+    const isCellDirty = useCallback((pk, col) => edits.has(pk) && Object.prototype.hasOwnProperty.call(edits.get(pk), col), [edits]);
+    const getStagedCell = useCallback((pk, col) => {
+        const row = edits.get(pk);
+        if (row && Object.prototype.hasOwnProperty.call(row, col)) {
+            return { value: row[col] };
+        }
+        return undefined;
+    }, [edits]);
+    const isDeleted = useCallback((pk) => deletedKeys.has(pk), [deletedKeys]);
+    const pendingCount = useMemo(() => {
+        // An edited row that is also deleted only counts once (as a deletion).
+        let editedNotDeleted = 0;
+        for (const pk of edits.keys()) {
+            if (!deletedKeys.has(pk))
+                editedNotDeleted += 1;
+        }
+        return editedNotDeleted + newRows.length + deletedKeys.size;
+    }, [edits, newRows, deletedKeys]);
+    const isDirty = pendingCount > 0;
+    const buildMutation = useCallback((originalRows, dryRun) => {
+        const inserts = newRows
+            .map((r) => r.values)
+            .filter((v) => Object.keys(v).length > 0);
+        const updates = [];
+        for (const [pk, set] of edits.entries()) {
+            if (deletedKeys.has(pk))
+                continue; // deletion supersedes edit
+            const original = originalRows.get(pk);
+            if (!original)
+                continue;
+            if (Object.keys(set).length === 0)
+                continue;
+            updates.push({ where: whereFor(schema, original), set });
+        }
+        const deletes = [];
+        for (const pk of deletedKeys) {
+            const original = originalRows.get(pk);
+            if (!original)
+                continue;
+            deletes.push(whereFor(schema, original));
+        }
+        const mutation = {};
+        if (inserts.length)
+            mutation.inserts = inserts;
+        if (updates.length)
+            mutation.updates = updates;
+        if (deletes.length)
+            mutation.deletes = deletes;
+        if (dryRun)
+            mutation.dryRun = true;
+        return mutation;
+    }, [edits, newRows, deletedKeys, schema]);
+    return {
+        edits,
+        newRows,
+        deletedKeys,
+        canEdit,
+        setCell,
+        setCells,
+        addRow,
+        setNewRowCell,
+        removeNewRow,
+        deleteRows,
+        undeleteRows,
+        revertCell,
+        discardAll,
+        isCellDirty,
+        getStagedCell,
+        isDeleted,
+        isDirty,
+        pendingCount,
+        buildMutation,
+    };
+}
+//# sourceMappingURL=changeset.js.map

package/dist/client/db-admin/changeset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeset.js","sourceRoot":"","sources":["../../../src/client/db-admin/changeset.ts"],"names":[],"mappings":"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","sourcesContent":["import { useCallback, useMemo, useState } from \"react\";\nimport type {\n  DbAdminTableSchema,\n  DbAdminMutation,\n} from \"../../db-admin/types.js\";\n\n/**\n * The staged-changeset model — the production-grade core of the table editor.\n *\n * Edits are NOT committed on blur. Instead every cell edit, new row, and\n * deletion accumulates here until the user explicitly commits (Cmd/Ctrl+S or\n * the Commit button), at which point {@link buildMutation} maps the staged\n * state into a single {@link DbAdminMutation}. Until then the grid renders the\n * staged values overlaid on the fetched rows, and the user can discard\n * everything.\n *\n * Rows are keyed by a stable primary-key string (the table's PK column values\n * joined). If a table has no primary key, edits target a full-row `where`\n * match instead, and the consumer should warn / disable editing.\n */\n\n/** New rows get a temporary client id so the grid can track them pre-insert. */\nexport interface NewRow {\n  /** Stable client-only id, e.g. `new:0`. Never sent to the server. */\n  _localId: string;\n  values: Record<string, unknown>;\n}\n\nexport interface Changeset {\n  /** rowPkString → { column → newValue }. */\n  edits: Map<string, Record<string, unknown>>;\n  /** Staged inserts. */\n  newRows: NewRow[];\n  /** rowPkString of rows staged for deletion. */\n  deletedKeys: Set<string>;\n}\n\nexport interface UseChangesetResult {\n  edits: Map<string, Record<string, unknown>>;\n  newRows: NewRow[];\n  deletedKeys: Set<string>;\n\n  /** Whether editing is possible (requires a primary key on the table). */\n  canEdit: boolean;\n\n  /** Stage a single cell edit on an existing row. */\n  setCell: (pk: string, col: string, value: unknown) => void;\n  /** Stage many cell edits on one existing row at once. */\n  setCells: (pk: string, values: Record<string, unknown>) => void;\n  /** Append a blank new row (optionally seeded) and return its local id. */\n  addRow: (seed?: Record<string, unknown>) => string;\n  /** Patch a staged new row's values. */\n  setNewRowCell: (localId: string, col: string, value: unknown) => void;\n  /** Remove a staged new row entirely. */\n  removeNewRow: (localId: string) => void;\n  /** Stage existing rows for deletion (by pk string). Toggles off if re-staged. */\n  deleteRows: (pks: string[]) => void;\n  /** Un-stage a deletion. */\n  undeleteRows: (pks: string[]) => void;\n  /** Clear a single staged cell edit (revert to original). */\n  revertCell: (pk: string, col: string) => void;\n  /** Drop everything. */\n  discardAll: () => void;\n\n  /** Whether a given existing-row cell is dirty. */\n  isCellDirty: (pk: string, col: string) => boolean;\n  /** The staged value for a cell, if any. */\n  getStagedCell: (pk: string, col: string) => { value: unknown } | undefined;\n  /** Whether an existing row is staged for deletion. */\n  isDeleted: (pk: string) => boolean;\n\n  isDirty: boolean;\n  /** Total count of pending changes (edited rows + new rows + deletions). */\n  pendingCount: number;\n\n  /**\n   * Build the mutation payload. `originalRows` maps pk string → the original\n   * fetched row, used to construct the `where` clause for updates/deletes.\n   */\n  buildMutation: (\n    originalRows: Map<string, Record<string, unknown>>,\n    dryRun?: boolean,\n  ) => DbAdminMutation;\n}\n\n/** Compute the stable pk string for a row given the schema's primary key. */\nexport function pkStringFor(\n  schema: DbAdminTableSchema | undefined,\n  row: Record<string, unknown>,\n): string {\n  const cols =\n    schema && schema.primaryKey.length > 0\n      ? schema.primaryKey\n      : // No PK: fall back to a full-row signature so each row is distinct.\n        Object.keys(row).sort();\n  return JSON.stringify(cols.map((c) => row[c] ?? null));\n}\n\n/** Build the `where` object that uniquely identifies an existing row. */\nfunction whereFor(\n  schema: DbAdminTableSchema | undefined,\n  row: Record<string, unknown>,\n): Record<string, unknown> {\n  if (schema && schema.primaryKey.length > 0) {\n    const where: Record<string, unknown> = {};\n    for (const col of schema.primaryKey) where[col] = row[col] ?? null;\n    return where;\n  }\n  // No PK — match the full original row.\n  return { ...row };\n}\n\nexport function useChangeset(\n  schema: DbAdminTableSchema | undefined,\n): UseChangesetResult {\n  const [edits, setEdits] = useState<Map<string, Record<string, unknown>>>(\n    () => new Map(),\n  );\n  const [newRows, setNewRows] = useState<NewRow[]>([]);\n  const [deletedKeys, setDeletedKeys] = useState<Set<string>>(() => new Set());\n\n  const canEdit = !!schema && schema.primaryKey.length > 0;\n\n  const setCell = useCallback((pk: string, col: string, value: unknown) => {\n    setEdits((prev) => {\n      const next = new Map(prev);\n      const row = { ...(next.get(pk) ?? {}) };\n      row[col] = value;\n      next.set(pk, row);\n      return next;\n    });\n  }, []);\n\n  const setCells = useCallback(\n    (pk: string, values: Record<string, unknown>) => {\n      setEdits((prev) => {\n        const next = new Map(prev);\n        const row = { ...(next.get(pk) ?? {}), ...values };\n        next.set(pk, row);\n        return next;\n      });\n    },\n    [],\n  );\n\n  const revertCell = useCallback((pk: string, col: string) => {\n    setEdits((prev) => {\n      if (!prev.has(pk)) return prev;\n      const next = new Map(prev);\n      const row = { ...next.get(pk)! };\n      delete row[col];\n      if (Object.keys(row).length === 0) next.delete(pk);\n      else next.set(pk, row);\n      return next;\n    });\n  }, []);\n\n  const addRow = useCallback((seed?: Record<string, unknown>) => {\n    const localId = `new:${Math.random().toString(36).slice(2)}`;\n    setNewRows((prev) => [...prev, { _localId: localId, values: seed ?? {} }]);\n    return localId;\n  }, []);\n\n  const setNewRowCell = useCallback(\n    (localId: string, col: string, value: unknown) => {\n      setNewRows((prev) =>\n        prev.map((r) =>\n          r._localId === localId\n            ? { ...r, values: { ...r.values, [col]: value } }\n            : r,\n        ),\n      );\n    },\n    [],\n  );\n\n  const removeNewRow = useCallback((localId: string) => {\n    setNewRows((prev) => prev.filter((r) => r._localId !== localId));\n  }, []);\n\n  const deleteRows = useCallback((pks: string[]) => {\n    setDeletedKeys((prev) => {\n      const next = new Set(prev);\n      for (const pk of pks) {\n        if (next.has(pk)) next.delete(pk);\n        else next.add(pk);\n      }\n      return next;\n    });\n  }, []);\n\n  const undeleteRows = useCallback((pks: string[]) => {\n    setDeletedKeys((prev) => {\n      const next = new Set(prev);\n      for (const pk of pks) next.delete(pk);\n      return next;\n    });\n  }, []);\n\n  const discardAll = useCallback(() => {\n    setEdits(new Map());\n    setNewRows([]);\n    setDeletedKeys(new Set());\n  }, []);\n\n  const isCellDirty = useCallback(\n    (pk: string, col: string) =>\n      edits.has(pk) && Object.prototype.hasOwnProperty.call(edits.get(pk), col),\n    [edits],\n  );\n\n  const getStagedCell = useCallback(\n    (pk: string, col: string) => {\n      const row = edits.get(pk);\n      if (row && Object.prototype.hasOwnProperty.call(row, col)) {\n        return { value: row[col] };\n      }\n      return undefined;\n    },\n    [edits],\n  );\n\n  const isDeleted = useCallback(\n    (pk: string) => deletedKeys.has(pk),\n    [deletedKeys],\n  );\n\n  const pendingCount = useMemo(() => {\n    // An edited row that is also deleted only counts once (as a deletion).\n    let editedNotDeleted = 0;\n    for (const pk of edits.keys()) {\n      if (!deletedKeys.has(pk)) editedNotDeleted += 1;\n    }\n    return editedNotDeleted + newRows.length + deletedKeys.size;\n  }, [edits, newRows, deletedKeys]);\n\n  const isDirty = pendingCount > 0;\n\n  const buildMutation = useCallback(\n    (\n      originalRows: Map<string, Record<string, unknown>>,\n      dryRun?: boolean,\n    ): DbAdminMutation => {\n      const inserts: Record<string, unknown>[] = newRows\n        .map((r) => r.values)\n        .filter((v) => Object.keys(v).length > 0);\n\n      const updates: DbAdminMutation[\"updates\"] = [];\n      for (const [pk, set] of edits.entries()) {\n        if (deletedKeys.has(pk)) continue; // deletion supersedes edit\n        const original = originalRows.get(pk);\n        if (!original) continue;\n        if (Object.keys(set).length === 0) continue;\n        updates.push({ where: whereFor(schema, original), set });\n      }\n\n      const deletes: Record<string, unknown>[] = [];\n      for (const pk of deletedKeys) {\n        const original = originalRows.get(pk);\n        if (!original) continue;\n        deletes.push(whereFor(schema, original));\n      }\n\n      const mutation: DbAdminMutation = {};\n      if (inserts.length) mutation.inserts = inserts;\n      if (updates.length) mutation.updates = updates;\n      if (deletes.length) mutation.deletes = deletes;\n      if (dryRun) mutation.dryRun = true;\n      return mutation;\n    },\n    [edits, newRows, deletedKeys, schema],\n  );\n\n  return {\n    edits,\n    newRows,\n    deletedKeys,\n    canEdit,\n    setCell,\n    setCells,\n    addRow,\n    setNewRowCell,\n    removeNewRow,\n    deleteRows,\n    undeleteRows,\n    revertCell,\n    discardAll,\n    isCellDirty,\n    getStagedCell,\n    isDeleted,\n    isDirty,\n    pendingCount,\n    buildMutation,\n  };\n}\n"]}

package/dist/client/db-admin/export-utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Serialization + download helpers for exporting SQL editor results.
+ *
+ * Kept dependency-free and SSR-safe: `downloadFile` no-ops outside the browser.
+ */
+/** Render rows as RFC-4180-style CSV with a header row of the given columns. */
+export declare function toCSV(columns: string[], rows: Record<string, unknown>[]): string;
+/** Render rows as a pretty-printed JSON array. */
+export declare function toJSON(rows: Record<string, unknown>[]): string;
+/**
+ * Trigger a client-side download of `content` as a file named `name` with the
+ * given MIME type. No-ops during SSR.
+ */
+export declare function downloadFile(name: string, mime: string, content: string): void;
+//# sourceMappingURL=export-utils.d.ts.map

package/dist/client/db-admin/export-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-utils.d.ts","sourceRoot":"","sources":["../../../src/client/db-admin/export-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH,gFAAgF;AAChF,wBAAgB,KAAK,CACnB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAC9B,MAAM,CAMR;AAED,kDAAkD;AAClD,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,IAAI,CAiBN"}

package/dist/client/db-admin/export-utils.js

@@ -0,0 +1,62 @@
+/**
+ * Serialization + download helpers for exporting SQL editor results.
+ *
+ * Kept dependency-free and SSR-safe: `downloadFile` no-ops outside the browser.
+ */
+function cellToCSV(value) {
+    if (value === null || value === undefined)
+        return "";
+    let str;
+    if (typeof value === "object") {
+        try {
+            str = JSON.stringify(value);
+        }
+        catch {
+            str = String(value);
+        }
+    }
+    else {
+        str = String(value);
+    }
+    // Quote when the value contains a comma, quote, CR, or LF. Escape embedded
+    // double-quotes by doubling them (RFC 4180).
+    if (/[",\r\n]/.test(str)) {
+        return `"${str.replace(/"/g, '""')}"`;
+    }
+    return str;
+}
+/** Render rows as RFC-4180-style CSV with a header row of the given columns. */
+export function toCSV(columns, rows) {
+    const header = columns.map(cellToCSV).join(",");
+    const body = rows.map((row) => columns.map((col) => cellToCSV(row[col])).join(","));
+    return [header, ...body].join("\r\n");
+}
+/** Render rows as a pretty-printed JSON array. */
+export function toJSON(rows) {
+    return JSON.stringify(rows, null, 2);
+}
+/**
+ * Trigger a client-side download of `content` as a file named `name` with the
+ * given MIME type. No-ops during SSR.
+ */
+export function downloadFile(name, mime, content) {
+    if (typeof window === "undefined" || typeof document === "undefined")
+        return;
+    try {
+        const blob = new Blob([content], { type: mime });
+        const url = URL.createObjectURL(blob);
+        const anchor = document.createElement("a");
+        anchor.href = url;
+        anchor.download = name;
+        anchor.style.display = "none";
+        document.body.appendChild(anchor);
+        anchor.click();
+        document.body.removeChild(anchor);
+        // Revoke on the next tick so the click has a chance to start the download.
+        setTimeout(() => URL.revokeObjectURL(url), 0);
+    }
+    catch {
+        // Best-effort — nothing actionable if the browser blocks the download.
+    }
+}
+//# sourceMappingURL=export-utils.js.map

package/dist/client/db-admin/export-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-utils.js","sourceRoot":"","sources":["../../../src/client/db-admin/export-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,GAAW,CAAC;IAChB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IACD,2EAA2E;IAC3E,6CAA6C;IAC7C,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,KAAK,CACnB,OAAiB,EACjB,IAA+B;IAE/B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAC5B,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CACpD,CAAC;IACF,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,MAAM,CAAC,IAA+B;IACpD,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACvC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,IAAY,EACZ,OAAe;IAEf,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW;QAAE,OAAO;IAC7E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,MAAM,GAAG,GAAG,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,GAAG,GAAG,CAAC;QAClB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,2EAA2E;QAC3E,UAAU,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;IACzE,CAAC;AACH,CAAC","sourcesContent":["/**\n * Serialization + download helpers for exporting SQL editor results.\n *\n * Kept dependency-free and SSR-safe: `downloadFile` no-ops outside the browser.\n */\n\nfunction cellToCSV(value: unknown): string {\n  if (value === null || value === undefined) return \"\";\n  let str: string;\n  if (typeof value === \"object\") {\n    try {\n      str = JSON.stringify(value);\n    } catch {\n      str = String(value);\n    }\n  } else {\n    str = String(value);\n  }\n  // Quote when the value contains a comma, quote, CR, or LF. Escape embedded\n  // double-quotes by doubling them (RFC 4180).\n  if (/[\",\\r\\n]/.test(str)) {\n    return `\"${str.replace(/\"/g, '\"\"')}\"`;\n  }\n  return str;\n}\n\n/** Render rows as RFC-4180-style CSV with a header row of the given columns. */\nexport function toCSV(\n  columns: string[],\n  rows: Record<string, unknown>[],\n): string {\n  const header = columns.map(cellToCSV).join(\",\");\n  const body = rows.map((row) =>\n    columns.map((col) => cellToCSV(row[col])).join(\",\"),\n  );\n  return [header, ...body].join(\"\\r\\n\");\n}\n\n/** Render rows as a pretty-printed JSON array. */\nexport function toJSON(rows: Record<string, unknown>[]): string {\n  return JSON.stringify(rows, null, 2);\n}\n\n/**\n * Trigger a client-side download of `content` as a file named `name` with the\n * given MIME type. No-ops during SSR.\n */\nexport function downloadFile(\n  name: string,\n  mime: string,\n  content: string,\n): void {\n  if (typeof window === \"undefined\" || typeof document === \"undefined\") return;\n  try {\n    const blob = new Blob([content], { type: mime });\n    const url = URL.createObjectURL(blob);\n    const anchor = document.createElement(\"a\");\n    anchor.href = url;\n    anchor.download = name;\n    anchor.style.display = \"none\";\n    document.body.appendChild(anchor);\n    anchor.click();\n    document.body.removeChild(anchor);\n    // Revoke on the next tick so the click has a chance to start the download.\n    setTimeout(() => URL.revokeObjectURL(url), 0);\n  } catch {\n    // Best-effort — nothing actionable if the browser blocks the download.\n  }\n}\n"]}

package/dist/client/db-admin/index.d.ts

@@ -0,0 +1,7 @@
+export { DbAdminPage } from "./DbAdminPage.js";
+export { DevDatabaseLink, type DevDatabaseLinkProps, } from "./DevDatabaseLink.js";
+export { dbAdminBasePath, dbAdminGet, dbAdminPost, useOverview, useTableSchema, useTableRows, mutateTable, runQuery, type DbAdminOverview, type DbAdminQueryState, } from "./useDbAdmin.js";
+export { loadGridState, saveGridState, getLS, setLS, removeLS, type GridState, } from "./storage.js";
+export { useDbAdminAgentSync, useNavigateConsumer, type DbAdminNavigationState, } from "./useAgentSync.js";
+export { TableBrowser, type TableBrowserProps } from "./TableBrowser.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/db-admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/db-admin/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,eAAe,EACf,UAAU,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,aAAa,EACb,aAAa,EACb,KAAK,EACL,KAAK,EACL,QAAQ,EACR,KAAK,SAAS,GACf,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,sBAAsB,GAC5B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}