callman-core 1.29.0 → 1.30.0

package/dist/diagram/database/fromSchema.js

@@ -0,0 +1,182 @@
+// Introspection → model (import, refresh) and typed nodes → model (an AI
+// CREATE or an MCP create_diagram that wrote db.* nodes with columns).
+import { columnFromInput } from "./edit.js";
+import { emptyDatabaseModel, findColumn, findEntity, newColumnId, newEntityId, newRelationshipId, } from "./model.js";
+import { dbEdgeData, dbNodeData, isDatabaseType, kindForDatabaseType } from "./types.js";
+export const dialectForConnectionType = (type) => {
+    switch (type) {
+        case "postgres":
+        case "postgresql":
+            return "postgres";
+        case "mysql":
+            return "mysql";
+        case "mssql":
+            return "mssql";
+        case "oracle":
+            return "oracle";
+        case "mongo":
+        case "mongodb":
+            return "mongo";
+        default:
+            return "generic";
+    }
+};
+const lower = (value) => (value ?? "").toLowerCase();
+const sameTable = (entity, table) => lower(entity.name) === lower(table.name) && (lower(entity.schema) === lower(table.schema) || !entity.schema || !table.schema);
+// Same column set (order-insensitive)?
+const sameSet = (a, b) => a.length === b.length && [...a].sort().join("\u0000") === [...b].sort().join("\u0000");
+const cardinalityForForeignKey = (table, fkColumns) => {
+    if (fkColumns.length > 0 && sameSet(fkColumns, table.primaryKey))
+        return "1:1";
+    if (table.indexes.some((index) => index.unique && sameSet(index.columns, fkColumns)))
+        return "1:1";
+    if (fkColumns.length === 1 && table.columns.find((column) => column.name === fkColumns[0])?.unique)
+        return "1:1";
+    return "N:1";
+};
+export const databaseModelFromSchema = (schema, options = {}) => {
+    const model = emptyDatabaseModel(dialectForConnectionType(schema.dialect));
+    const previous = options.previous;
+    if (options.connection) {
+        model.connection = {
+            ...options.connection,
+            ...(schema.database ? { database: schema.database } : {}),
+            ...(schema.schemas.length > 0 ? { schemas: schema.schemas } : {}),
+            capturedAt: schema.capturedAt,
+        };
+    }
+    for (const table of schema.tables) {
+        const kept = previous?.entities.find((entity) => sameTable(entity, table));
+        const id = kept && !model.entities.some((entity) => entity.id === kept.id) ? kept.id : newEntityId(model, table.name, table.schema);
+        const entity = { id, name: table.name, ...(table.schema ? { schema: table.schema } : {}), kind: table.kind, columns: [] };
+        const taken = new Set();
+        for (const column of table.columns) {
+            const keptColumn = kept?.columns.find((candidate) => lower(candidate.name) === lower(column.name));
+            const columnId = keptColumn && !taken.has(keptColumn.id) ? keptColumn.id : newColumnId({ columns: [...entity.columns, ...[...taken].map((t) => ({ id: t }))] }, column.name);
+            taken.add(columnId);
+            entity.columns.push({
+                id: columnId,
+                name: column.name,
+                dataType: column.dataType,
+                ...(column.nullable ? { nullable: true } : {}),
+                ...(column.primaryKey ? { primaryKey: true } : {}),
+                ...(column.unique ? { unique: true } : {}),
+                ...(column.defaultValue !== undefined ? { defaultValue: column.defaultValue } : {}),
+                ...(column.autoIncrement ? { autoIncrement: true } : {}),
+                ...(column.comment ? { comment: column.comment } : {}),
+                ...(column.metadata ? { metadata: column.metadata } : {}),
+            });
+        }
+        const indexes = table.indexes
+            .filter((index) => !index.primary)
+            .map((index) => ({ name: index.name, columns: index.columns.map((name) => findColumn(entity, name)?.id).filter((v) => Boolean(v)), ...(index.unique ? { unique: true } : {}) }))
+            .filter((index) => index.columns.length > 0);
+        if (indexes.length > 0)
+            entity.indexes = indexes;
+        if (table.comment)
+            entity.comment = table.comment;
+        if (table.rowCountEstimate !== undefined)
+            entity.metadata = { rowCountEstimate: table.rowCountEstimate };
+        model.entities.push(entity);
+    }
+    // Relationships from the foreign keys whose both ends were imported.
+    for (const table of schema.tables) {
+        const source = model.entities.find((entity) => sameTable(entity, table));
+        if (!source)
+            continue;
+        for (const fk of table.foreignKeys) {
+            const target = model.entities.find((entity) => lower(entity.name) === lower(fk.refTable) && (!fk.refSchema || !entity.schema || lower(entity.schema) === lower(fk.refSchema)));
+            if (!target)
+                continue;
+            const sourceColumns = fk.columns.map((name) => findColumn(source, name)?.id).filter((v) => Boolean(v));
+            const targetColumns = fk.refColumns.map((name) => findColumn(target, name)?.id).filter((v) => Boolean(v));
+            const keptRelationship = previous?.relationships.find((relationship) => relationship.kind === "foreignKey" && relationship.source.entityId === source.id && relationship.target.entityId === target.id && sameSet(relationship.source.columnIds, sourceColumns));
+            const id = keptRelationship && !model.relationships.some((relationship) => relationship.id === keptRelationship.id) ? keptRelationship.id : newRelationshipId(model, source.id, target.id, fk.name);
+            const relationship = {
+                id,
+                source: { entityId: source.id, columnIds: sourceColumns },
+                target: { entityId: target.id, columnIds: targetColumns },
+                cardinality: cardinalityForForeignKey(table, fk.columns),
+                kind: "foreignKey",
+                ...(fk.name ? { name: fk.name } : {}),
+                ...(keptRelationship?.label ? { label: keptRelationship.label } : {}),
+                ...(fk.onDelete ? { onDelete: fk.onDelete } : {}),
+                ...(fk.onUpdate ? { onUpdate: fk.onUpdate } : {}),
+            };
+            model.relationships.push(relationship);
+        }
+    }
+    // Manual relationships of the previous model survive a refresh when both
+    // ends still exist.
+    for (const manual of previous?.relationships.filter((relationship) => relationship.kind === "manual") ?? []) {
+        const source = findEntity(model, manual.source.entityId);
+        const target = findEntity(model, manual.target.entityId);
+        if (!source || !target || model.relationships.some((relationship) => relationship.id === manual.id))
+            continue;
+        model.relationships.push({
+            ...manual,
+            source: { entityId: source.id, columnIds: manual.source.columnIds.filter((id) => source.columns.some((column) => column.id === id)) },
+            target: { entityId: target.id, columnIds: manual.target.columnIds.filter((id) => target.columns.some((column) => column.id === id)) },
+        });
+    }
+    return model;
+};
+// Typed nodes (db.* with `data.db.columns` as column inputs, edges with
+// `data.db` naming columns) → model. The authoring path for AI CREATE and
+// MCP create_diagram: the caller then stores the model as the source.
+export const databaseModelFromDocument = (doc, dialect) => {
+    const model = emptyDatabaseModel(dialect);
+    const entityByNode = new Map();
+    for (const node of doc.nodes) {
+        if (!isDatabaseType(node.type))
+            continue;
+        const data = dbNodeData(node.data);
+        const raw = (node.data?.db ?? {});
+        const name = (data?.name ?? node.label ?? node.id).trim() || node.id;
+        const schema = typeof raw.schema === "string" && raw.schema.trim() ? raw.schema.trim() : undefined;
+        const id = model.entities.some((entity) => entity.id === node.id) ? newEntityId(model, name, schema) : node.id;
+        const entity = { id, name, ...(schema ? { schema } : {}), kind: kindForDatabaseType(node.type), columns: [] };
+        const inputs = Array.isArray(raw.columns) ? raw.columns : Array.isArray(raw.columnInputs) ? raw.columnInputs : [];
+        const taken = new Set();
+        for (const input of inputs) {
+            if (!input || typeof input !== "object")
+                continue;
+            const columnInput = input;
+            if (typeof columnInput.name !== "string" || !columnInput.name.trim())
+                continue;
+            try {
+                entity.columns.push(columnFromInput(entity, { ...columnInput, dataType: columnInput.dataType ?? columnInput.type ?? "" }, taken));
+            }
+            catch {
+                // A duplicate column in the input: keep the first.
+            }
+        }
+        if (typeof raw.comment === "string" && raw.comment.trim())
+            entity.comment = raw.comment.trim();
+        model.entities.push(entity);
+        entityByNode.set(node.id, entity);
+    }
+    for (const edge of doc.edges) {
+        if (!edge.source || !edge.target)
+            continue;
+        const source = entityByNode.get(edge.source);
+        const target = entityByNode.get(edge.target);
+        if (!source || !target)
+            continue;
+        const data = dbEdgeData(edge.data);
+        const raw = (edge.data?.db ?? {});
+        const columnIds = (entity, refs) => (Array.isArray(refs) ? refs : []).map((ref) => (typeof ref === "string" ? findColumn(entity, ref)?.id : undefined)).filter((v) => Boolean(v));
+        const cardinality = data?.cardinality && ["1:1", "1:N", "N:1", "N:M"].includes(data.cardinality) ? data.cardinality : "N:1";
+        model.relationships.push({
+            id: model.relationships.some((relationship) => relationship.id === edge.id) ? newRelationshipId(model, source.id, target.id) : edge.id,
+            source: { entityId: source.id, columnIds: columnIds(source, raw.sourceColumns) },
+            target: { entityId: target.id, columnIds: columnIds(target, raw.targetColumns) },
+            cardinality,
+            kind: raw.kind === "foreignKey" ? "foreignKey" : "manual",
+            ...(typeof raw.name === "string" && raw.name ? { name: raw.name } : {}),
+            ...(edge.label ? { label: edge.label } : {}),
+        });
+    }
+    return model;
+};
+//# sourceMappingURL=fromSchema.js.map

package/dist/diagram/database/fromSchema.js.map

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

package/dist/diagram/database/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./model.js";
+export * from "./types.js";
+export * from "./edit.js";
+export * from "./fromSchema.js";
+export * from "./derive.js";
+export * from "./diff.js";
+export * from "./place.js";
+export { patchDatabaseSource, type DatabasePatchContext, type DatabasePatchResult } from "./patch.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/diagram/database/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/diagram/database/index.ts"],"names":[],"mappings":"AAKA,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAE,KAAK,oBAAoB,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/diagram/database/index.js

@@ -0,0 +1,14 @@
+// Database Diagram (ERD) as a diagram SOURCE format: the JSON database model
+// (entities, columns, keys, relationships) is the structure truth; the
+// nodes/edges hold layout and visibility. Introspection (host/db) builds the
+// model from a real database, the desktop edits it on an ERD canvas, the AI
+// and MCP edit it through semantic ops — all on this one model.
+export * from "./model.js";
+export * from "./types.js";
+export * from "./edit.js";
+export * from "./fromSchema.js";
+export * from "./derive.js";
+export * from "./diff.js";
+export * from "./place.js";
+export { patchDatabaseSource } from "./patch.js";
+//# sourceMappingURL=index.js.map

package/dist/diagram/database/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/diagram/database/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,uEAAuE;AACvE,6EAA6E;AAC7E,4EAA4E;AAC5E,gEAAgE;AAChE,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,mBAAmB,EAAuD,MAAM,YAAY,CAAC"}

package/dist/diagram/database/model.d.ts

@@ -0,0 +1,93 @@
+export declare const DATABASE_MODEL_FORMAT = "callman-database";
+export declare const DATABASE_GRAMMAR_VERSION = "1";
+export type DatabaseDialect = "postgres" | "mysql" | "mssql" | "oracle" | "mongo" | "generic";
+export declare const DATABASE_DIALECTS: readonly DatabaseDialect[];
+export type DatabaseEntityKind = "table" | "view" | "collection";
+export declare const DATABASE_ENTITY_KINDS: readonly DatabaseEntityKind[];
+export type DatabaseCardinality = "1:1" | "1:N" | "N:1" | "N:M";
+export declare const DATABASE_CARDINALITIES: readonly DatabaseCardinality[];
+export type DatabaseRelationshipKind = "foreignKey" | "manual";
+export interface DatabaseColumn {
+    id: string;
+    name: string;
+    dataType: string;
+    nullable?: boolean;
+    primaryKey?: boolean;
+    unique?: boolean;
+    defaultValue?: string;
+    autoIncrement?: boolean;
+    comment?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface DatabaseIndex {
+    name: string;
+    columns: string[];
+    unique?: boolean;
+    primary?: boolean;
+}
+export interface DatabaseEntity {
+    id: string;
+    name: string;
+    schema?: string;
+    kind: DatabaseEntityKind;
+    columns: DatabaseColumn[];
+    indexes?: DatabaseIndex[];
+    comment?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface DatabaseRelationshipEnd {
+    entityId: string;
+    columnIds: string[];
+}
+export interface DatabaseRelationship {
+    id: string;
+    source: DatabaseRelationshipEnd;
+    target: DatabaseRelationshipEnd;
+    cardinality: DatabaseCardinality;
+    kind: DatabaseRelationshipKind;
+    name?: string;
+    label?: string;
+    onDelete?: string;
+    onUpdate?: string;
+}
+export interface DatabaseConnectionRef {
+    connectionId: string;
+    name?: string;
+    provider?: string;
+    database?: string;
+    schemas?: string[];
+    capturedAt?: string;
+    selection?: string[];
+}
+export interface DatabaseModel {
+    format: typeof DATABASE_MODEL_FORMAT;
+    version: 1;
+    dialect?: DatabaseDialect;
+    connection?: DatabaseConnectionRef;
+    entities: DatabaseEntity[];
+    relationships: DatabaseRelationship[];
+}
+export declare const emptyDatabaseModel: (dialect?: DatabaseDialect) => DatabaseModel;
+export declare const entityQualifiedName: (entity: Pick<DatabaseEntity, "name" | "schema">) => string;
+export declare const findEntity: (model: DatabaseModel, ref: string) => DatabaseEntity | undefined;
+export declare const findColumn: (entity: DatabaseEntity, ref: string) => DatabaseColumn | undefined;
+export declare const findRelationship: (model: DatabaseModel, ref: string) => DatabaseRelationship | undefined;
+export declare const parseColumnRef: (ref: string) => {
+    table: string;
+    column?: string;
+};
+export declare const newEntityId: (model: DatabaseModel, name: string, schema?: string) => string;
+export declare const newColumnId: (entity: Pick<DatabaseEntity, "columns">, name: string) => string;
+export declare const newRelationshipId: (model: DatabaseModel, sourceEntityId: string, targetEntityId: string, name?: string) => string;
+export declare const compactDatabaseModel: (model: DatabaseModel) => DatabaseModel;
+export declare const serializeDatabaseModel: (model: DatabaseModel) => string;
+export interface ParsedDatabaseModel {
+    ok: boolean;
+    model: DatabaseModel;
+    errors: string[];
+    warnings: string[];
+}
+export declare const looksLikeDatabaseModel: (text: string) => boolean;
+export declare const parseDatabaseModel: (text: string) => ParsedDatabaseModel;
+export declare const cloneDatabaseModel: (model: DatabaseModel) => DatabaseModel;
+//# sourceMappingURL=model.d.ts.map

package/dist/diagram/database/model.d.ts.map

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

package/dist/diagram/database/model.js

@@ -0,0 +1,294 @@
+// The canonical Database Diagram model: what an ERD KNOWS about a database —
+// entities (tables, views, collections), their columns, keys and indexes, and
+// the relationships between them. It is the STRUCTURE truth of a database
+// diagram and lives as JSON text in `document.source` (format "database");
+// positions, sizes, colors, hidden/collapsed states live on the nodes and
+// edges, never here — a schema refresh replaces this model and leaves the
+// layout alone.
+//
+// Ids are stable slugs (entity "users", column "user_id", relationship
+// "fk-orders-users"); a rename keeps the id, so relationships, node positions
+// and MCP references survive it.
+import { slugify } from "../ids.js";
+export const DATABASE_MODEL_FORMAT = "callman-database";
+export const DATABASE_GRAMMAR_VERSION = "1";
+export const DATABASE_DIALECTS = ["postgres", "mysql", "mssql", "oracle", "mongo", "generic"];
+export const DATABASE_ENTITY_KINDS = ["table", "view", "collection"];
+export const DATABASE_CARDINALITIES = ["1:1", "1:N", "N:1", "N:M"];
+export const emptyDatabaseModel = (dialect) => ({
+    format: DATABASE_MODEL_FORMAT,
+    version: 1,
+    ...(dialect ? { dialect } : {}),
+    entities: [],
+    relationships: [],
+});
+// --- names and lookups ------------------------------------------------------------
+export const entityQualifiedName = (entity) => entity.schema ? `${entity.schema}.${entity.name}` : entity.name;
+const lower = (value) => (value ?? "").toLowerCase();
+// An entity by id, then by qualified name, then by bare name (case-insensitive).
+export const findEntity = (model, ref) => {
+    const wanted = ref.trim();
+    if (!wanted)
+        return undefined;
+    const byId = model.entities.find((entity) => entity.id === wanted);
+    if (byId)
+        return byId;
+    const lowered = wanted.toLowerCase();
+    return (model.entities.find((entity) => lower(entityQualifiedName(entity)) === lowered) ??
+        model.entities.find((entity) => lower(entity.name) === lowered) ??
+        model.entities.find((entity) => entity.id.toLowerCase() === lowered));
+};
+export const findColumn = (entity, ref) => {
+    const wanted = ref.trim();
+    if (!wanted)
+        return undefined;
+    return entity.columns.find((column) => column.id === wanted) ?? entity.columns.find((column) => lower(column.name) === wanted.toLowerCase()) ?? entity.columns.find((column) => column.id.toLowerCase() === wanted.toLowerCase());
+};
+export const findRelationship = (model, ref) => {
+    const wanted = ref.trim();
+    return model.relationships.find((relationship) => relationship.id === wanted) ?? model.relationships.find((relationship) => relationship.name === wanted);
+};
+// "users.id" → { table: "users", column: "id" }; "public.users.id" → table
+// "public.users". A bare "users" names the table only.
+export const parseColumnRef = (ref) => {
+    const trimmed = ref.trim();
+    const dot = trimmed.lastIndexOf(".");
+    if (dot <= 0 || dot === trimmed.length - 1)
+        return { table: trimmed };
+    return { table: trimmed.slice(0, dot), column: trimmed.slice(dot + 1) };
+};
+// --- ids ------------------------------------------------------------------------
+const uniqueId = (base, taken, fallback) => {
+    const root = base || fallback;
+    let candidate = root;
+    let suffix = 2;
+    while (taken.has(candidate)) {
+        candidate = `${root}-${suffix}`;
+        suffix += 1;
+    }
+    return candidate;
+};
+export const newEntityId = (model, name, schema) => {
+    const taken = new Set(model.entities.map((entity) => entity.id));
+    const bare = slugify(name);
+    if (bare && !taken.has(bare))
+        return bare;
+    const qualified = schema ? slugify(`${schema}-${name}`) : "";
+    if (qualified && !taken.has(qualified))
+        return qualified;
+    return uniqueId(bare || qualified, taken, "table");
+};
+export const newColumnId = (entity, name) => uniqueId(slugify(name), new Set(entity.columns.map((column) => column.id)), "column");
+export const newRelationshipId = (model, sourceEntityId, targetEntityId, name) => {
+    const taken = new Set(model.relationships.map((relationship) => relationship.id));
+    const preferred = name ? slugify(name) : "";
+    if (preferred && !taken.has(preferred))
+        return preferred;
+    return uniqueId(slugify(`fk-${sourceEntityId}-${targetEntityId}`), taken, "rel");
+};
+// --- serialize / parse -------------------------------------------------------------
+const compactColumn = (column) => ({
+    id: column.id,
+    name: column.name,
+    dataType: column.dataType,
+    ...(column.nullable ? { nullable: true } : {}),
+    ...(column.primaryKey ? { primaryKey: true } : {}),
+    ...(column.unique ? { unique: true } : {}),
+    ...(column.defaultValue !== undefined ? { defaultValue: column.defaultValue } : {}),
+    ...(column.autoIncrement ? { autoIncrement: true } : {}),
+    ...(column.comment ? { comment: column.comment } : {}),
+    ...(column.metadata && Object.keys(column.metadata).length > 0 ? { metadata: column.metadata } : {}),
+});
+const compactEntity = (entity) => ({
+    id: entity.id,
+    name: entity.name,
+    ...(entity.schema ? { schema: entity.schema } : {}),
+    kind: entity.kind,
+    columns: entity.columns.map(compactColumn),
+    ...(entity.indexes && entity.indexes.length > 0
+        ? { indexes: entity.indexes.map((index) => ({ name: index.name, columns: [...index.columns], ...(index.unique ? { unique: true } : {}), ...(index.primary ? { primary: true } : {}) })) }
+        : {}),
+    ...(entity.comment ? { comment: entity.comment } : {}),
+    ...(entity.metadata && Object.keys(entity.metadata).length > 0 ? { metadata: entity.metadata } : {}),
+});
+const compactRelationship = (relationship) => ({
+    id: relationship.id,
+    source: { entityId: relationship.source.entityId, columnIds: [...relationship.source.columnIds] },
+    target: { entityId: relationship.target.entityId, columnIds: [...relationship.target.columnIds] },
+    cardinality: relationship.cardinality,
+    kind: relationship.kind,
+    ...(relationship.name ? { name: relationship.name } : {}),
+    ...(relationship.label ? { label: relationship.label } : {}),
+    ...(relationship.onDelete ? { onDelete: relationship.onDelete } : {}),
+    ...(relationship.onUpdate ? { onUpdate: relationship.onUpdate } : {}),
+});
+// A model with a fixed key order and no empty optionals — the same model
+// always serializes to the same bytes (hashes, diffs and undo rely on it).
+export const compactDatabaseModel = (model) => ({
+    format: DATABASE_MODEL_FORMAT,
+    version: 1,
+    ...(model.dialect ? { dialect: model.dialect } : {}),
+    ...(model.connection
+        ? {
+            connection: {
+                connectionId: model.connection.connectionId,
+                ...(model.connection.name ? { name: model.connection.name } : {}),
+                ...(model.connection.provider ? { provider: model.connection.provider } : {}),
+                ...(model.connection.database ? { database: model.connection.database } : {}),
+                ...(model.connection.schemas && model.connection.schemas.length > 0 ? { schemas: [...model.connection.schemas] } : {}),
+                ...(model.connection.capturedAt ? { capturedAt: model.connection.capturedAt } : {}),
+                ...(model.connection.selection && model.connection.selection.length > 0 ? { selection: [...model.connection.selection] } : {}),
+            },
+        }
+        : {}),
+    entities: model.entities.map(compactEntity),
+    relationships: model.relationships.map(compactRelationship),
+});
+export const serializeDatabaseModel = (model) => `${JSON.stringify(compactDatabaseModel(model), null, 2)}\n`;
+const isObject = (value) => value !== null && typeof value === "object" && !Array.isArray(value);
+const isStr = (value) => typeof value === "string";
+const optStr = (value) => (isStr(value) && value.length > 0 ? value : undefined);
+const optBool = (value) => (typeof value === "boolean" ? value : undefined);
+const strList = (value) => (Array.isArray(value) ? value.filter(isStr) : []);
+// Cheap sniff for file import: JSON whose root names our format.
+export const looksLikeDatabaseModel = (text) => {
+    const trimmed = text.trim();
+    if (!trimmed.startsWith("{"))
+        return false;
+    return trimmed.includes(`"${DATABASE_MODEL_FORMAT}"`) || (trimmed.includes('"entities"') && trimmed.includes('"relationships"'));
+};
+// Tolerant reader: structural problems are errors (the model is then empty),
+// dangling references are dropped with a warning (the model is still usable).
+export const parseDatabaseModel = (text) => {
+    const errors = [];
+    const warnings = [];
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch (error) {
+        return { ok: false, model: emptyDatabaseModel(), errors: [`Not valid JSON: ${error instanceof Error ? error.message : String(error)}`], warnings };
+    }
+    if (!isObject(raw))
+        return { ok: false, model: emptyDatabaseModel(), errors: ["The database model must be a JSON object."], warnings };
+    if (raw.format !== undefined && raw.format !== DATABASE_MODEL_FORMAT)
+        errors.push(`format must be "${DATABASE_MODEL_FORMAT}".`);
+    if (!Array.isArray(raw.entities))
+        errors.push("entities must be an array.");
+    if (raw.relationships !== undefined && !Array.isArray(raw.relationships))
+        errors.push("relationships must be an array.");
+    if (errors.length > 0)
+        return { ok: false, model: emptyDatabaseModel(), errors, warnings };
+    const dialect = isStr(raw.dialect) && DATABASE_DIALECTS.includes(raw.dialect) ? raw.dialect : undefined;
+    const model = emptyDatabaseModel(dialect);
+    if (isObject(raw.connection) && isStr(raw.connection.connectionId)) {
+        model.connection = {
+            connectionId: raw.connection.connectionId,
+            ...(optStr(raw.connection.name) ? { name: String(raw.connection.name) } : {}),
+            ...(optStr(raw.connection.provider) ? { provider: String(raw.connection.provider) } : {}),
+            ...(optStr(raw.connection.database) ? { database: String(raw.connection.database) } : {}),
+            ...(strList(raw.connection.schemas).length > 0 ? { schemas: strList(raw.connection.schemas) } : {}),
+            ...(optStr(raw.connection.capturedAt) ? { capturedAt: String(raw.connection.capturedAt) } : {}),
+            ...(strList(raw.connection.selection).length > 0 ? { selection: strList(raw.connection.selection) } : {}),
+        };
+    }
+    const entityIds = new Set();
+    raw.entities.forEach((item, index) => {
+        if (!isObject(item) || !isStr(item.name)) {
+            errors.push(`entities[${index}] needs a name.`);
+            return;
+        }
+        const name = item.name;
+        const schema = optStr(item.schema);
+        const kind = isStr(item.kind) && DATABASE_ENTITY_KINDS.includes(item.kind) ? item.kind : "table";
+        const entity = { id: "", name, ...(schema ? { schema } : {}), kind, columns: [] };
+        entity.id = isStr(item.id) && item.id.trim() && !entityIds.has(item.id.trim()) ? item.id.trim() : newEntityId(model, name, schema);
+        if (isStr(item.id) && item.id.trim() && entityIds.has(item.id.trim()))
+            warnings.push(`Duplicate entity id "${item.id}" — renamed to "${entity.id}".`);
+        entityIds.add(entity.id);
+        const columnIds = new Set();
+        if (Array.isArray(item.columns)) {
+            item.columns.forEach((columnRaw, columnIndex) => {
+                if (!isObject(columnRaw) || !isStr(columnRaw.name)) {
+                    warnings.push(`${entityQualifiedName(entity)}: columns[${columnIndex}] has no name — dropped.`);
+                    return;
+                }
+                const requested = isStr(columnRaw.id) && columnRaw.id.trim() ? columnRaw.id.trim() : "";
+                const id = requested && !columnIds.has(requested) ? requested : newColumnId(entity, columnRaw.name);
+                columnIds.add(id);
+                entity.columns.push({
+                    id,
+                    name: columnRaw.name,
+                    dataType: optStr(columnRaw.dataType) ?? optStr(columnRaw.type) ?? "",
+                    ...(optBool(columnRaw.nullable) ? { nullable: true } : {}),
+                    ...(optBool(columnRaw.primaryKey) ? { primaryKey: true } : {}),
+                    ...(optBool(columnRaw.unique) ? { unique: true } : {}),
+                    ...(columnRaw.defaultValue !== undefined && columnRaw.defaultValue !== null ? { defaultValue: String(columnRaw.defaultValue) } : {}),
+                    ...(optBool(columnRaw.autoIncrement) ? { autoIncrement: true } : {}),
+                    ...(optStr(columnRaw.comment) ? { comment: String(columnRaw.comment) } : {}),
+                    ...(isObject(columnRaw.metadata) ? { metadata: columnRaw.metadata } : {}),
+                });
+            });
+        }
+        if (Array.isArray(item.indexes)) {
+            const indexes = [];
+            for (const indexRaw of item.indexes) {
+                if (!isObject(indexRaw) || !isStr(indexRaw.name))
+                    continue;
+                const columns = strList(indexRaw.columns).map((ref) => findColumn(entity, ref)?.id).filter((id) => Boolean(id));
+                indexes.push({ name: indexRaw.name, columns, ...(optBool(indexRaw.unique) ? { unique: true } : {}), ...(optBool(indexRaw.primary) ? { primary: true } : {}) });
+            }
+            if (indexes.length > 0)
+                entity.indexes = indexes;
+        }
+        if (optStr(item.comment))
+            entity.comment = String(item.comment);
+        if (isObject(item.metadata))
+            entity.metadata = item.metadata;
+        model.entities.push(entity);
+    });
+    const relationshipIds = new Set();
+    const readEnd = (value, relationshipLabel) => {
+        if (!isObject(value) || !isStr(value.entityId)) {
+            warnings.push(`${relationshipLabel}: an end has no entityId — dropped.`);
+            return null;
+        }
+        const entity = findEntity(model, value.entityId);
+        if (!entity) {
+            warnings.push(`${relationshipLabel}: entity "${value.entityId}" does not exist — dropped.`);
+            return null;
+        }
+        const columnIds = strList(value.columnIds).map((ref) => findColumn(entity, ref)?.id).filter((id) => Boolean(id));
+        return { entityId: entity.id, columnIds };
+    };
+    for (const item of Array.isArray(raw.relationships) ? raw.relationships : []) {
+        if (!isObject(item))
+            continue;
+        const label = `relationship ${isStr(item.id) ? item.id : "(no id)"}`;
+        const source = readEnd(item.source, label);
+        const target = readEnd(item.target, label);
+        if (!source || !target)
+            continue;
+        const cardinality = isStr(item.cardinality) && DATABASE_CARDINALITIES.includes(item.cardinality) ? item.cardinality : "N:1";
+        const kind = item.kind === "manual" ? "manual" : "foreignKey";
+        const requested = isStr(item.id) && item.id.trim() ? item.id.trim() : "";
+        const id = requested && !relationshipIds.has(requested) ? requested : newRelationshipId(model, source.entityId, target.entityId, optStr(item.name));
+        relationshipIds.add(id);
+        model.relationships.push({
+            id,
+            source,
+            target,
+            cardinality,
+            kind,
+            ...(optStr(item.name) ? { name: String(item.name) } : {}),
+            ...(optStr(item.label) ? { label: String(item.label) } : {}),
+            ...(optStr(item.onDelete) ? { onDelete: String(item.onDelete) } : {}),
+            ...(optStr(item.onUpdate) ? { onUpdate: String(item.onUpdate) } : {}),
+        });
+    }
+    return { ok: errors.length === 0, model, errors, warnings };
+};
+// Deep copy through the compact form (models are small JSON; edits clone
+// before they mutate so callers keep their previous model intact).
+export const cloneDatabaseModel = (model) => JSON.parse(JSON.stringify(compactDatabaseModel(model)));
+//# sourceMappingURL=model.js.map