@weave-kit/engine 0.1.0

package/dist/core/storage/inspect.d.ts

@@ -0,0 +1,55 @@
+import type { Pool } from 'pg';
+export interface ActualColumn {
+    name: string;
+    dataType: string;
+    isNullable: boolean;
+    columnDefault: string | null;
+    /** pg type name (`udt_name`): distinguishes arrays (`_text`), enums, domains */
+    udtName?: string;
+    /** numeric precision (numeric/decimal); null when not numeric */
+    numericPrecision?: number | null;
+    /** numeric scale (numeric/decimal); null when not numeric */
+    numericScale?: number | null;
+    /** enum labels when the column is a user-defined enum (detail only) */
+    enumLabels?: string[];
+    /** column comment (detail only) */
+    comment?: string;
+}
+export interface ActualFk {
+    column: string;
+    refTable: string;
+    refColumn: string;
+    /** FK ON DELETE action (detail only): cascade | set_null | restrict | no_action | set_default */
+    onDelete?: string;
+}
+export interface ActualTable {
+    name: string;
+    columns: ActualColumn[];
+    pk: string[];
+    fks: ActualFk[];
+    indexNames: string[];
+    /** owning role name (for RLS ownership gating); present when the table exists */
+    owner?: string;
+    /** whether row-level security is enabled */
+    rlsEnabled?: boolean;
+    /** policy names on the table */
+    rlsPolicies?: string[];
+    /** roles granted SELECT (for the restricted-SQL role grant) */
+    selectGrantedTo?: string[];
+    /** table comment (detail only) */
+    comment?: string;
+    /** single-column unique (non-primary) columns (detail only) */
+    uniqueColumns?: string[];
+}
+export interface InspectOptions {
+    /**
+     * fetch extra catalog detail used by reverse modeling (`weave introspect`):
+     * enum labels, table/column comments, single-column unique constraints and
+     * FK on-delete actions. Off by default so `migrate`/drift checks run zero
+     * extra queries.
+     */
+    detail?: boolean;
+}
+/** read the current schema of every table in the connection's schema */
+export declare function inspectSchema(pool: Pool, options?: InspectOptions): Promise<Map<string, ActualTable>>;
+//# sourceMappingURL=inspect.d.ts.map

package/dist/core/storage/inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../../src/core/storage/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,uEAAuE;IACvE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,EAAE,EAAE,MAAM,EAAE,CAAC;IACb,GAAG,EAAE,QAAQ,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,iFAAiF;IACjF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4CAA4C;IAC5C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,+DAA+D;IAC/D,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAWD,wEAAwE;AACxE,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CA8H/G"}

package/dist/core/storage/inspect.js

@@ -0,0 +1,163 @@
+/** map a pg `confdeltype` char to a readable action name */
+const FK_DELETE_ACTIONS = {
+    a: 'no_action',
+    r: 'restrict',
+    c: 'cascade',
+    n: 'set_null',
+    d: 'set_default',
+};
+/** read the current schema of every table in the connection's schema */
+export async function inspectSchema(pool, options = {}) {
+    const tables = new Map();
+    const cols = await pool.query(`SELECT table_name, column_name, data_type, is_nullable, column_default,
+            udt_name, numeric_precision, numeric_scale
+       FROM information_schema.columns
+      WHERE table_schema = current_schema()`);
+    for (const row of cols.rows) {
+        const t = tables.get(row.table_name) ?? {
+            name: row.table_name,
+            columns: [],
+            pk: [],
+            fks: [],
+            indexNames: [],
+            owner: '',
+            rlsEnabled: false,
+            rlsPolicies: [],
+            selectGrantedTo: [],
+        };
+        t.columns.push({
+            name: row.column_name,
+            dataType: row.data_type,
+            isNullable: row.is_nullable === 'YES',
+            columnDefault: row.column_default,
+            udtName: row.udt_name ?? undefined,
+            numericPrecision: row.numeric_precision,
+            numericScale: row.numeric_scale,
+        });
+        tables.set(row.table_name, t);
+    }
+    const pkRows = await pool.query(`SELECT tc.table_name, kcu.column_name
+       FROM information_schema.table_constraints tc
+       JOIN information_schema.key_column_usage kcu
+         ON tc.constraint_name = kcu.constraint_name AND tc.constraint_schema = kcu.constraint_schema
+      WHERE tc.constraint_type = 'PRIMARY KEY' AND tc.table_schema = current_schema()`);
+    for (const row of pkRows.rows) {
+        tables.get(row.table_name)?.pk.push(row.column_name);
+    }
+    const fkRows = await pool.query(`SELECT tc.table_name, kcu.column_name, ccu.table_name AS ref_table, ccu.column_name AS ref_column
+       FROM information_schema.table_constraints tc
+       JOIN information_schema.key_column_usage kcu
+         ON tc.constraint_name = kcu.constraint_name AND tc.constraint_schema = kcu.constraint_schema
+       JOIN information_schema.constraint_column_usage ccu
+         ON tc.constraint_name = ccu.constraint_name AND tc.constraint_schema = ccu.constraint_schema
+      WHERE tc.constraint_type = 'FOREIGN KEY' AND tc.table_schema = current_schema()`);
+    for (const row of fkRows.rows) {
+        tables.get(row.table_name)?.fks.push({
+            column: row.column_name,
+            refTable: row.ref_table,
+            refColumn: row.ref_column,
+        });
+    }
+    const idxRows = await pool.query(`SELECT tablename, indexname FROM pg_indexes WHERE schemaname = current_schema()`);
+    for (const row of idxRows.rows) {
+        tables.get(row.tablename)?.indexNames.push(row.indexname);
+    }
+    // RLS state + ownership per table
+    const rlsRows = await pool.query(`SELECT c.relname, c.relrowsecurity, r.rolname AS owner
+       FROM pg_class c
+       JOIN pg_roles r ON c.relowner = r.oid
+      WHERE c.relkind = 'r' AND c.relnamespace = current_schema()::regnamespace`);
+    for (const row of rlsRows.rows) {
+        const t = tables.get(row.relname);
+        if (t !== undefined) {
+            t.rlsEnabled = row.relrowsecurity;
+            t.owner = row.owner;
+        }
+    }
+    const policyRows = await pool.query(`SELECT tablename, policyname FROM pg_policies WHERE schemaname = current_schema()`);
+    for (const row of policyRows.rows) {
+        const t = tables.get(row.tablename);
+        if (t !== undefined)
+            (t.rlsPolicies ??= []).push(row.policyname);
+    }
+    // roles granted SELECT (for the restricted-SQL role grant; PUBLIC grants are
+    // ignored — if PUBLIC has SELECT the role inherits it, and a redundant GRANT
+    // would just be emitted)
+    const grantRows = await pool.query(`SELECT c.relname AS table_name, r.rolname AS role
+       FROM pg_class c
+       JOIN pg_namespace n ON c.relnamespace = n.oid
+       CROSS JOIN LATERAL aclexplode(COALESCE(c.relacl, acldefault('r', c.relowner))) acl
+       JOIN pg_roles r ON r.oid = acl.grantee
+      WHERE n.nspname = current_schema() AND acl.privilege_type = 'SELECT'`);
+    for (const row of grantRows.rows) {
+        const t = tables.get(row.table_name);
+        if (t !== undefined)
+            (t.selectGrantedTo ??= []).push(row.role);
+    }
+    if (options.detail === true) {
+        await loadDetail(pool, tables);
+    }
+    return tables;
+}
+/**
+ * Extra catalog reads for reverse modeling (enum labels, comments, single-column
+ * unique constraints, FK on-delete actions). Runs only when `detail` is set so
+ * `migrate`/drift checks stay query-lean.
+ */
+async function loadDetail(pool, tables) {
+    const enumRows = await pool.query(`SELECT c.relname AS table_name, a.attname AS column_name, e.enumlabel AS label
+       FROM pg_attribute a
+       JOIN pg_class c ON a.attrelid = c.oid
+       JOIN pg_namespace n ON c.relnamespace = n.oid
+       JOIN pg_type t ON a.atttypid = t.oid
+       JOIN pg_enum e ON e.enumtypid = t.oid
+      WHERE n.nspname = current_schema() AND a.attnum > 0 AND NOT a.attisdropped
+      ORDER BY c.relname, a.attnum, e.enumsortorder`);
+    for (const row of enumRows.rows) {
+        const col = tables.get(row.table_name)?.columns.find((c) => c.name === row.column_name);
+        if (col !== undefined)
+            (col.enumLabels ??= []).push(row.label);
+    }
+    const tableComments = await pool.query(`SELECT c.relname AS table_name, obj_description(c.oid, 'pg_class') AS comment
+       FROM pg_class c
+       JOIN pg_namespace n ON c.relnamespace = n.oid
+      WHERE n.nspname = current_schema() AND c.relkind = 'r'`);
+    for (const row of tableComments.rows) {
+        const t = tables.get(row.table_name);
+        if (t !== undefined && row.comment !== null)
+            t.comment = row.comment;
+    }
+    const columnComments = await pool.query(`SELECT c.relname AS table_name, a.attname AS column_name, col_description(c.oid, a.attnum) AS comment
+       FROM pg_class c
+       JOIN pg_namespace n ON c.relnamespace = n.oid
+       JOIN pg_attribute a ON a.attrelid = c.oid AND a.attnum > 0 AND NOT a.attisdropped
+      WHERE n.nspname = current_schema() AND c.relkind = 'r'`);
+    for (const row of columnComments.rows) {
+        const col = tables.get(row.table_name)?.columns.find((c) => c.name === row.column_name);
+        if (col !== undefined && row.comment !== null)
+            col.comment = row.comment;
+    }
+    const uniqueRows = await pool.query(`SELECT c.relname AS table_name, a.attname AS column_name
+       FROM pg_index i
+       JOIN pg_class c ON i.indrelid = c.oid
+       JOIN pg_namespace n ON c.relnamespace = n.oid
+       JOIN pg_attribute a ON a.attrelid = c.oid AND a.attnum = ANY(i.indkey)
+      WHERE n.nspname = current_schema() AND i.indisunique AND NOT i.indisprimary AND i.indnkeyatts = 1`);
+    for (const row of uniqueRows.rows) {
+        const t = tables.get(row.table_name);
+        if (t !== undefined)
+            (t.uniqueColumns ??= []).push(row.column_name);
+    }
+    const fkDeleteRows = await pool.query(`SELECT c.relname AS table_name, a.attname AS column_name, con.confdeltype
+       FROM pg_constraint con
+       JOIN pg_class c ON con.conrelid = c.oid
+       JOIN pg_namespace n ON c.relnamespace = n.oid
+       JOIN pg_attribute a ON a.attrelid = con.conrelid AND a.attnum = ANY(con.conkey)
+      WHERE con.contype = 'f' AND n.nspname = current_schema()`);
+    for (const row of fkDeleteRows.rows) {
+        const fk = tables.get(row.table_name)?.fks.find((f) => f.column === row.column_name);
+        if (fk !== undefined)
+            fk.onDelete = FK_DELETE_ACTIONS[row.confdeltype] ?? 'restrict';
+    }
+}
+//# sourceMappingURL=inspect.js.map

package/dist/core/storage/inspect.js.map

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

package/dist/core/storage/introspect.d.ts

@@ -0,0 +1,36 @@
+import type { ObjectDefinition } from '../types/index.js';
+import type { ActualTable } from './inspect.js';
+/** one object produced by reverse modeling (already validated) */
+export interface IntrospectedObject {
+    /** object name (= table name) */
+    name: string;
+    /** source table name */
+    table: string;
+    /** validated object definition (ready to serialize to `objects/<name>/schema.json`) */
+    schema: ObjectDefinition;
+}
+/** a table that was not converted (with a human-readable reason) */
+export interface IntrospectSkip {
+    table: string;
+    reason: string;
+}
+export interface IntrospectReport {
+    objects: IntrospectedObject[];
+    skipped: IntrospectSkip[];
+    warnings: string[];
+    suggestions: string[];
+}
+export interface IntrospectMapOptions {
+    /** only convert these tables (table names) */
+    include?: string[];
+    /** never convert these tables (table names) */
+    exclude?: string[];
+}
+/**
+ * Reverse-model live PostgreSQL tables into engine object drafts. Pure (no I/O):
+ * feed it an `inspectSchema(pool, { detail: true })` map. Objects that fail
+ * validation (composite/missing PK, non-snake_case names, unsupported PK type)
+ * are reported in `skipped`, never silently dropped.
+ */
+export declare function mapToSchema(tables: Map<string, ActualTable>, options?: IntrospectMapOptions): IntrospectReport;
+//# sourceMappingURL=introspect.d.ts.map

package/dist/core/storage/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../../src/core/storage/introspect.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA8B,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACtF,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,cAAc,CAAC;AAE9D,kEAAkE;AAClE,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,wBAAwB;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,uFAAuF;IACvF,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAED,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,kBAAkB,EAAE,CAAC;IAC9B,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AA0ID;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAE,oBAAyB,GAAG,gBAAgB,CA2ElH"}

package/dist/core/storage/introspect.js

@@ -0,0 +1,223 @@
+import { validateObject } from '../object/validate.js';
+import { FIELD_TYPES, ON_DELETE_ACTIONS } from '../types/values.js';
+const SNAKE_CASE = /^[a-z][a-z0-9_]*$/;
+/** PostgreSQL `information_schema.columns.data_type` → engine field type (primitives only) */
+const PG_TO_FIELD = {
+    'character varying': FIELD_TYPES.STRING,
+    character: FIELD_TYPES.STRING,
+    bpchar: FIELD_TYPES.STRING,
+    text: FIELD_TYPES.TEXT,
+    integer: FIELD_TYPES.INTEGER,
+    smallint: FIELD_TYPES.INTEGER,
+    bigint: FIELD_TYPES.NUMBER,
+    numeric: FIELD_TYPES.NUMBER,
+    decimal: FIELD_TYPES.NUMBER,
+    real: FIELD_TYPES.NUMBER,
+    'double precision': FIELD_TYPES.NUMBER,
+    boolean: FIELD_TYPES.BOOLEAN,
+    'timestamp with time zone': FIELD_TYPES.DATETIME,
+    'timestamp without time zone': FIELD_TYPES.DATETIME,
+    date: FIELD_TYPES.DATE,
+    json: FIELD_TYPES.JSON,
+    jsonb: FIELD_TYPES.JSON,
+    uuid: FIELD_TYPES.STRING,
+};
+/** readable on-delete action (from `inspect.ts`) → engine `ON_DELETE_ACTIONS` (restrict is the default and omitted) */
+const FK_ON_DELETE = {
+    cascade: ON_DELETE_ACTIONS.CASCADE,
+    set_null: ON_DELETE_ACTIONS.SET_NULL,
+};
+/** normalize a PostgreSQL column default into an engine-field default (or mark it unrepresentable) */
+function normalizeDefault(raw, type) {
+    const trimmed = raw.trim();
+    if (/^now\(\)$/i.test(trimmed) || /^current_timestamp$/i.test(trimmed)) {
+        return type === FIELD_TYPES.DATETIME || type === FIELD_TYPES.DATE ? { value: 'now' } : { unsupported: true };
+    }
+    // any other function call (nextval(...), gen_random_uuid(), ...) is not representable
+    if (/\(/.test(trimmed))
+        return { unsupported: true };
+    const withoutCast = trimmed.replace(/::[\s\S]+$/, '').trim();
+    const quoted = /^'(.*)'$/.exec(withoutCast);
+    const literal = quoted !== null ? quoted[1].replace(/''/g, "'") : withoutCast;
+    switch (type) {
+        case FIELD_TYPES.BOOLEAN:
+            if (literal === 'true')
+                return { value: true };
+            if (literal === 'false')
+                return { value: false };
+            return { unsupported: true };
+        case FIELD_TYPES.INTEGER:
+        case FIELD_TYPES.NUMBER:
+        case FIELD_TYPES.CURRENCY: {
+            const n = Number(literal);
+            return Number.isFinite(n) ? { value: n } : { unsupported: true };
+        }
+        case FIELD_TYPES.DATETIME:
+        case FIELD_TYPES.DATE:
+        case FIELD_TYPES.STRING:
+        case FIELD_TYPES.TEXT:
+        case FIELD_TYPES.ENUM:
+        case FIELD_TYPES.FIRST_NAME:
+        case FIELD_TYPES.LAST_NAME:
+        case FIELD_TYPES.EMAIL:
+        case FIELD_TYPES.PHONE:
+        case FIELD_TYPES.IMAGE:
+            return { value: literal };
+        default:
+            return { unsupported: true };
+    }
+}
+/** map one PostgreSQL column to an engine field (undefined = unsupported; a warning is pushed) */
+function mapColumn(col, table, warnings) {
+    const base = { name: col.name };
+    if (col.comment !== undefined)
+        base.label = col.comment;
+    const required = col.isNullable ? undefined : true;
+    const unique = table.uniqueColumns?.includes(col.name) === true && !table.pk.includes(col.name);
+    const fk = table.fks.find((f) => f.column === col.name);
+    if (fk !== undefined) {
+        if (!SNAKE_CASE.test(fk.refTable)) {
+            warnings.push(`column "${table.name}.${col.name}": FK target table "${fk.refTable}" is not a valid object name — skipped`);
+            return undefined;
+        }
+        const field = { ...base, type: FIELD_TYPES.RELATION, target: fk.refTable };
+        if (required === true)
+            field.required = true;
+        if (unique)
+            field.unique = true;
+        const onDelete = fk.onDelete === undefined ? undefined : FK_ON_DELETE[fk.onDelete];
+        if (onDelete !== undefined)
+            field.onDelete = onDelete;
+        return field;
+    }
+    // user-defined enum (labels come from the detail inspect)
+    if (col.enumLabels !== undefined && col.enumLabels.length > 0) {
+        const field = { ...base, type: FIELD_TYPES.ENUM, options: [...col.enumLabels] };
+        if (required === true)
+            field.required = true;
+        if (unique)
+            field.unique = true;
+        if (col.columnDefault !== null) {
+            const def = normalizeDefault(col.columnDefault, FIELD_TYPES.ENUM);
+            if (def.value !== undefined)
+                field.default = def.value;
+            else if (def.unsupported === true)
+                warnings.push(`column "${table.name}.${col.name}": default "${col.columnDefault}" not representable — omitted`);
+        }
+        return field;
+    }
+    if (col.udtName?.startsWith('_') === true || col.dataType === 'ARRAY') {
+        warnings.push(`column "${table.name}.${col.name}": array type not supported — skipped`);
+        return undefined;
+    }
+    const fieldType = PG_TO_FIELD[col.dataType];
+    if (fieldType === undefined) {
+        warnings.push(`column "${table.name}.${col.name}": type "${col.dataType}" not supported — skipped`);
+        return undefined;
+    }
+    if (col.dataType === 'bigint')
+        warnings.push(`column "${table.name}.${col.name}": bigint mapped to number`);
+    if (col.dataType === 'uuid')
+        warnings.push(`column "${table.name}.${col.name}": uuid mapped to string (no engine uuid type)`);
+    const field = { ...base, type: fieldType };
+    if (required === true)
+        field.required = true;
+    if (unique)
+        field.unique = true;
+    if (fieldType === FIELD_TYPES.NUMBER && col.numericPrecision !== undefined && col.numericPrecision !== null) {
+        field.precision = col.numericPrecision;
+    }
+    if (col.columnDefault !== null) {
+        const def = normalizeDefault(col.columnDefault, fieldType);
+        if (def.value !== undefined)
+            field.default = def.value;
+        else if (def.unsupported === true)
+            warnings.push(`column "${table.name}.${col.name}": default "${col.columnDefault}" not representable — omitted`);
+    }
+    return field;
+}
+/**
+ * Reverse-model live PostgreSQL tables into engine object drafts. Pure (no I/O):
+ * feed it an `inspectSchema(pool, { detail: true })` map. Objects that fail
+ * validation (composite/missing PK, non-snake_case names, unsupported PK type)
+ * are reported in `skipped`, never silently dropped.
+ */
+export function mapToSchema(tables, options = {}) {
+    const include = options.include === undefined ? undefined : new Set(options.include);
+    const exclude = options.exclude === undefined ? undefined : new Set(options.exclude);
+    const objects = [];
+    const skipped = [];
+    const warnings = [];
+    const suggestions = [];
+    for (const name of [...tables.keys()].sort()) {
+        if (include !== undefined && !include.has(name))
+            continue;
+        if (exclude?.has(name) === true)
+            continue;
+        const table = tables.get(name);
+        if (table === undefined)
+            continue;
+        if (!SNAKE_CASE.test(name)) {
+            skipped.push({ table: name, reason: 'table name is not snake_case (object name must match ^[a-z][a-z0-9_]*$)' });
+            continue;
+        }
+        if (table.pk.length !== 1) {
+            skipped.push({
+                table: name,
+                reason: table.pk.length === 0 ? 'missing primary key' : 'composite primary key not supported',
+            });
+            continue;
+        }
+        const pkName = table.pk[0];
+        const pkCol = table.columns.find((c) => c.name === pkName);
+        if (pkCol === undefined) {
+            skipped.push({ table: name, reason: `primary key column "${pkName}" not found` });
+            continue;
+        }
+        let badColumn;
+        for (const col of table.columns) {
+            if (col.name === pkName)
+                continue;
+            if (!SNAKE_CASE.test(col.name)) {
+                badColumn = col.name;
+                break;
+            }
+        }
+        if (badColumn !== undefined) {
+            skipped.push({ table: name, reason: `column name "${badColumn}" is not snake_case` });
+            continue;
+        }
+        const pkField = mapColumn(pkCol, table, warnings);
+        if (pkField === undefined) {
+            skipped.push({ table: name, reason: `primary key column "${pkName}" type not supported` });
+            continue;
+        }
+        pkField.primary = true;
+        const fields = [pkField];
+        for (const col of table.columns) {
+            if (col.name === pkName)
+                continue;
+            const mapped = mapColumn(col, table, warnings);
+            if (mapped !== undefined)
+                fields.push(mapped);
+        }
+        const schema = { name, alter: false, fields };
+        if (table.comment !== undefined)
+            schema.label = table.comment;
+        try {
+            const validated = validateObject(schema, { nameHint: name });
+            objects.push({ name, table: name, schema: validated });
+            for (const f of validated.fields) {
+                if (f.name === 'owner_id' && f.ownership !== true)
+                    suggestions.push(`"${name}.owner_id": consider marking ownership: true`);
+                if (f.name === 'team_id' && f.team !== true)
+                    suggestions.push(`"${name}.team_id": consider marking team: true`);
+            }
+        }
+        catch (error) {
+            skipped.push({ table: name, reason: error instanceof Error ? error.message : String(error) });
+        }
+    }
+    return { objects, skipped, warnings, suggestions };
+}
+//# sourceMappingURL=introspect.js.map

package/dist/core/storage/introspect.js.map

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

package/dist/core/storage/map.d.ts

@@ -0,0 +1,30 @@
+import type { FieldDefinition } from '../types/index.js';
+/**
+ * Map a field's declared type to a PostgreSQL column type.
+ * `targetPkType` is the mapped PK type of the target object (for `relation`).
+ */
+export declare function pgType(field: FieldDefinition, targetPkType: string | undefined): string;
+/** SQL DEFAULT expression for a field's `default` value, or undefined (no default) */
+export declare function defaultExpr(field: FieldDefinition): string | undefined;
+/**
+ * Compare a declared column type (`pgType()` output, e.g. `VARCHAR(255)`,
+ * `NUMERIC(12,2)`, `TEXT[]`) against a live `information_schema` column, for
+ * the `weave schema:map` drift report. Length on `VARCHAR` is ignored (brownfield
+ * tables often declare an unbounded/bespoke varchar); numeric precision/scale is
+ * compared only when the declared type specifies them.
+ */
+export declare function pgTypeMatches(expected: string, actual: {
+    dataType: string;
+    udtName?: string;
+    numericPrecision?: number | null;
+    numericScale?: number | null;
+}): boolean;
+/**
+ * Map a declared `onDelete` action value to the SQL `ON DELETE` clause fragment.
+ * Values are the single source `ON_DELETE_ACTIONS` (`cascade`/`restrict`/
+ * `set_null`); the SQL spelling differs for `set_null` → `SET NULL` (a bare
+ * `SET_NULL` is invalid PostgreSQL). Unknown values fall back to `RESTRICT`
+ * (the DDL default) so a stray value never emits broken SQL.
+ */
+export declare function onDeleteClause(action: string | undefined): string;
+//# sourceMappingURL=map.d.ts.map

package/dist/core/storage/map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map.d.ts","sourceRoot":"","sources":["../../../src/core/storage/map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAuCvF;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS,CA6BtE;AASD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE;IACN,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GACA,OAAO,CA8CT;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAUjE"}