@adminiumjs/engine 0.1.0-rc.1

package/dist/snapshot/diff.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Snapshot diff engine — 05-introspection-engine.md §9 `diffModels`.
+ *
+ * Pure structural diff between two `DatabaseModel`s. All output arrays are
+ * sorted (tables/relations by id, columns by name) so the diff itself is
+ * canonical and safe to hash/golden-test.
+ *
+ * NOT IMPLEMENTED HERE (deliberately, per 05 §9): rename detection.
+ * `rename-detect.ts` is a separate M3-follow-up — a removed+added column
+ * pair with identical logicalType+nullability and (same ordinal or
+ * Levenshtein ≤ 2 or snake/camel variant) becomes a `renamedColumns`
+ * suggestion at confidence 0.7, never auto-applied. Until it lands,
+ * `renamedColumns` is always `[]` and a drop+add reads as exactly that.
+ */
+import { z } from 'zod';
+import { type DatabaseModel } from '../schema-model.js';
+export declare const changedTableSchema: z.ZodObject<{
+    addedColumns: z.ZodArray<z.ZodString>;
+    removedColumns: z.ZodArray<z.ZodString>;
+    typeChanged: z.ZodArray<z.ZodObject<{
+        column: z.ZodString;
+        from: z.ZodEnum<{
+            bigint: "bigint";
+            boolean: "boolean";
+            text: "text";
+            varchar: "varchar";
+            integer: "integer";
+            decimal: "decimal";
+            float: "float";
+            date: "date";
+            time: "time";
+            timestamp: "timestamp";
+            timestamptz: "timestamptz";
+            interval: "interval";
+            uuid: "uuid";
+            json: "json";
+            binary: "binary";
+            enum: "enum";
+            geometry: "geometry";
+            inet: "inet";
+            unknown: "unknown";
+        }>;
+        to: z.ZodEnum<{
+            bigint: "bigint";
+            boolean: "boolean";
+            text: "text";
+            varchar: "varchar";
+            integer: "integer";
+            decimal: "decimal";
+            float: "float";
+            date: "date";
+            time: "time";
+            timestamp: "timestamp";
+            timestamptz: "timestamptz";
+            interval: "interval";
+            uuid: "uuid";
+            json: "json";
+            binary: "binary";
+            enum: "enum";
+            geometry: "geometry";
+            inet: "inet";
+            unknown: "unknown";
+        }>;
+    }, z.core.$strict>>;
+    nullabilityChanged: z.ZodArray<z.ZodObject<{
+        column: z.ZodString;
+        nowNullable: z.ZodBoolean;
+    }, z.core.$strict>>;
+    enumValuesChanged: z.ZodArray<z.ZodObject<{
+        enumId: z.ZodString;
+        added: z.ZodArray<z.ZodString>;
+        removed: z.ZodArray<z.ZodString>;
+    }, z.core.$strict>>;
+    pkChanged: z.ZodBoolean;
+    renamedColumns: z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+        confidence: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ChangedTable = z.infer<typeof changedTableSchema>;
+export declare const schemaDiffSchema: z.ZodObject<{
+    addedTables: z.ZodArray<z.ZodString>;
+    removedTables: z.ZodArray<z.ZodString>;
+    changedTables: z.ZodRecord<z.ZodString, z.ZodObject<{
+        addedColumns: z.ZodArray<z.ZodString>;
+        removedColumns: z.ZodArray<z.ZodString>;
+        typeChanged: z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            from: z.ZodEnum<{
+                bigint: "bigint";
+                boolean: "boolean";
+                text: "text";
+                varchar: "varchar";
+                integer: "integer";
+                decimal: "decimal";
+                float: "float";
+                date: "date";
+                time: "time";
+                timestamp: "timestamp";
+                timestamptz: "timestamptz";
+                interval: "interval";
+                uuid: "uuid";
+                json: "json";
+                binary: "binary";
+                enum: "enum";
+                geometry: "geometry";
+                inet: "inet";
+                unknown: "unknown";
+            }>;
+            to: z.ZodEnum<{
+                bigint: "bigint";
+                boolean: "boolean";
+                text: "text";
+                varchar: "varchar";
+                integer: "integer";
+                decimal: "decimal";
+                float: "float";
+                date: "date";
+                time: "time";
+                timestamp: "timestamp";
+                timestamptz: "timestamptz";
+                interval: "interval";
+                uuid: "uuid";
+                json: "json";
+                binary: "binary";
+                enum: "enum";
+                geometry: "geometry";
+                inet: "inet";
+                unknown: "unknown";
+            }>;
+        }, z.core.$strict>>;
+        nullabilityChanged: z.ZodArray<z.ZodObject<{
+            column: z.ZodString;
+            nowNullable: z.ZodBoolean;
+        }, z.core.$strict>>;
+        enumValuesChanged: z.ZodArray<z.ZodObject<{
+            enumId: z.ZodString;
+            added: z.ZodArray<z.ZodString>;
+            removed: z.ZodArray<z.ZodString>;
+        }, z.core.$strict>>;
+        pkChanged: z.ZodBoolean;
+        renamedColumns: z.ZodArray<z.ZodObject<{
+            from: z.ZodString;
+            to: z.ZodString;
+            confidence: z.ZodNumber;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    relationChanges: z.ZodObject<{
+        added: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                override: "override";
+                "declared-fk": "declared-fk";
+                "inferred-name": "inferred-name";
+                "inferred-join-table": "inferred-join-table";
+                manifest: "manifest";
+            }>;
+            cardinality: z.ZodEnum<{
+                "one-to-one": "one-to-one";
+                "one-to-many": "one-to-many";
+                "many-to-many": "many-to-many";
+            }>;
+            from: z.ZodObject<{
+                tableId: z.ZodString;
+                columns: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            to: z.ZodObject<{
+                tableId: z.ZodString;
+                columns: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            through: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                tableId: z.ZodString;
+                fromColumns: z.ZodArray<z.ZodString>;
+                toColumns: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+            onDelete: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                cascade: "cascade";
+                restrict: "restrict";
+                "set-null": "set-null";
+                "set-default": "set-default";
+                "no-action": "no-action";
+            }>>>;
+            onUpdate: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                cascade: "cascade";
+                restrict: "restrict";
+                "set-null": "set-null";
+                "set-default": "set-default";
+                "no-action": "no-action";
+            }>>>;
+            selfReferential: z.ZodDefault<z.ZodBoolean>;
+            confidence: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+        removed: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                override: "override";
+                "declared-fk": "declared-fk";
+                "inferred-name": "inferred-name";
+                "inferred-join-table": "inferred-join-table";
+                manifest: "manifest";
+            }>;
+            cardinality: z.ZodEnum<{
+                "one-to-one": "one-to-one";
+                "one-to-many": "one-to-many";
+                "many-to-many": "many-to-many";
+            }>;
+            from: z.ZodObject<{
+                tableId: z.ZodString;
+                columns: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            to: z.ZodObject<{
+                tableId: z.ZodString;
+                columns: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>;
+            through: z.ZodDefault<z.ZodNullable<z.ZodObject<{
+                tableId: z.ZodString;
+                fromColumns: z.ZodArray<z.ZodString>;
+                toColumns: z.ZodArray<z.ZodString>;
+            }, z.core.$strict>>>;
+            onDelete: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                cascade: "cascade";
+                restrict: "restrict";
+                "set-null": "set-null";
+                "set-default": "set-default";
+                "no-action": "no-action";
+            }>>>;
+            onUpdate: z.ZodDefault<z.ZodNullable<z.ZodEnum<{
+                cascade: "cascade";
+                restrict: "restrict";
+                "set-null": "set-null";
+                "set-default": "set-default";
+                "no-action": "no-action";
+            }>>>;
+            selfReferential: z.ZodDefault<z.ZodBoolean>;
+            confidence: z.ZodDefault<z.ZodNumber>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>;
+    breaking: z.ZodBoolean;
+}, z.core.$strict>;
+export type SchemaDiff = z.infer<typeof schemaDiffSchema>;
+export interface DiffOptions {
+    /**
+     * Is this target path (`schema.table` or `schema.table.column`) referenced
+     * by current pages/overrides? `breaking` is only set for referenced
+     * removals/type changes. Callers without page knowledge (the engine in
+     * isolation) get the conservative default: everything is referenced.
+     */
+    isReferenced?: (targetPath: string) => boolean;
+}
+/**
+ * §9 `diffModels(a, b)`: what changed going FROM `a` TO `b`. Pure; stable
+ * ordering throughout; empty diff = `{ addedTables: [], … breaking: false }`.
+ */
+export declare function diffModels(a: DatabaseModel, b: DatabaseModel, options?: DiffOptions): SchemaDiff;
+/** True when the diff carries no change at all. */
+export declare function isEmptyDiff(diff: SchemaDiff): boolean;
+//# sourceMappingURL=diff.d.ts.map

package/dist/snapshot/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/snapshot/diff.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAGL,KAAK,aAAa,EAInB,MAAM,oBAAoB,CAAC;AAM5B,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAe7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAU3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAChD;AAiFD;;;GAGG;AACH,wBAAgB,UAAU,CACxB,CAAC,EAAE,aAAa,EAChB,CAAC,EAAE,aAAa,EAChB,OAAO,GAAE,WAAgB,GACxB,UAAU,CA2CZ;AAED,mDAAmD;AACnD,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAQrD"}

package/dist/snapshot/diff.js

@@ -0,0 +1,151 @@
+/**
+ * Snapshot diff engine — 05-introspection-engine.md §9 `diffModels`.
+ *
+ * Pure structural diff between two `DatabaseModel`s. All output arrays are
+ * sorted (tables/relations by id, columns by name) so the diff itself is
+ * canonical and safe to hash/golden-test.
+ *
+ * NOT IMPLEMENTED HERE (deliberately, per 05 §9): rename detection.
+ * `rename-detect.ts` is a separate M3-follow-up — a removed+added column
+ * pair with identical logicalType+nullability and (same ordinal or
+ * Levenshtein ≤ 2 or snake/camel variant) becomes a `renamedColumns`
+ * suggestion at confidence 0.7, never auto-applied. Until it lands,
+ * `renamedColumns` is always `[]` and a drop+add reads as exactly that.
+ */
+import { z } from 'zod';
+import { logicalTypeSchema, relationSchema, } from '../schema-model.js';
+// ---------------------------------------------------------------------------
+// Diff shape (§9) — Zod schema so the §11 diff route can validate responses
+// ---------------------------------------------------------------------------
+export const changedTableSchema = z.strictObject({
+    addedColumns: z.array(z.string()),
+    removedColumns: z.array(z.string()),
+    typeChanged: z.array(z.strictObject({ column: z.string(), from: logicalTypeSchema, to: logicalTypeSchema })),
+    nullabilityChanged: z.array(z.strictObject({ column: z.string(), nowNullable: z.boolean() })),
+    enumValuesChanged: z.array(z.strictObject({ enumId: z.string(), added: z.array(z.string()), removed: z.array(z.string()) })),
+    pkChanged: z.boolean(),
+    /** Suggestions only; always [] until rename-detect.ts lands (see header). */
+    renamedColumns: z.array(z.strictObject({ from: z.string(), to: z.string(), confidence: z.number().min(0).max(1) })),
+});
+export const schemaDiffSchema = z.strictObject({
+    addedTables: z.array(z.string()),
+    removedTables: z.array(z.string()),
+    changedTables: z.record(z.string(), changedTableSchema),
+    relationChanges: z.strictObject({
+        added: z.array(relationSchema),
+        removed: z.array(relationSchema),
+    }),
+    /** Any removal/typeChange referenced by current pages/overrides (§9). */
+    breaking: z.boolean(),
+});
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+const sortStrings = (values) => [...values].sort((a, b) => a.localeCompare(b));
+const byId = (a, b) => a.id.localeCompare(b.id);
+function diffTable(a, b, modelA, modelB) {
+    const aColumns = new Map(a.columns.map((c) => [c.name, c]));
+    const bColumns = new Map(b.columns.map((c) => [c.name, c]));
+    const addedColumns = sortStrings([...bColumns.keys()].filter((name) => !aColumns.has(name)));
+    const removedColumns = sortStrings([...aColumns.keys()].filter((name) => !bColumns.has(name)));
+    const typeChanged = [];
+    const nullabilityChanged = [];
+    const enumValuesChanged = [];
+    const enumsA = new Map(modelA.enums.map((e) => [e.id, e]));
+    const enumsB = new Map(modelB.enums.map((e) => [e.id, e]));
+    const seenEnumIds = new Set();
+    for (const name of sortStrings([...aColumns.keys()].filter((n) => bColumns.has(n)))) {
+        const before = aColumns.get(name);
+        const after = bColumns.get(name);
+        if (before.logicalType !== after.logicalType) {
+            typeChanged.push({ column: name, from: before.logicalType, to: after.logicalType });
+        }
+        if (before.nullable !== after.nullable) {
+            nullabilityChanged.push({ column: name, nowNullable: after.nullable });
+        }
+        // Enum drift is reported on the table(s) whose columns reference the enum.
+        const enumId = after.enumRef ?? before.enumRef;
+        if (enumId !== null && !seenEnumIds.has(enumId)) {
+            seenEnumIds.add(enumId);
+            const valuesA = enumsA.get(before.enumRef ?? enumId)?.values ?? [];
+            const valuesB = enumsB.get(after.enumRef ?? enumId)?.values ?? [];
+            const setA = new Set(valuesA);
+            const setB = new Set(valuesB);
+            const added = sortStrings(valuesB.filter((v) => !setA.has(v)));
+            const removed = sortStrings(valuesA.filter((v) => !setB.has(v)));
+            if (added.length > 0 || removed.length > 0) {
+                enumValuesChanged.push({ enumId, added, removed });
+            }
+        }
+    }
+    enumValuesChanged.sort((x, y) => x.enumId.localeCompare(y.enumId));
+    const pkChanged = a.primaryKey.length !== b.primaryKey.length ||
+        a.primaryKey.some((column, i) => column !== b.primaryKey[i]);
+    if (addedColumns.length === 0 &&
+        removedColumns.length === 0 &&
+        typeChanged.length === 0 &&
+        nullabilityChanged.length === 0 &&
+        enumValuesChanged.length === 0 &&
+        !pkChanged) {
+        return null;
+    }
+    return {
+        addedColumns,
+        removedColumns,
+        typeChanged,
+        nullabilityChanged,
+        enumValuesChanged,
+        pkChanged,
+        renamedColumns: [], // rename detection deferred — see module header
+    };
+}
+/**
+ * §9 `diffModels(a, b)`: what changed going FROM `a` TO `b`. Pure; stable
+ * ordering throughout; empty diff = `{ addedTables: [], … breaking: false }`.
+ */
+export function diffModels(a, b, options = {}) {
+    const isReferenced = options.isReferenced ?? (() => true);
+    const tablesA = new Map(a.tables.map((t) => [t.id, t]));
+    const tablesB = new Map(b.tables.map((t) => [t.id, t]));
+    const addedTables = sortStrings([...tablesB.keys()].filter((id) => !tablesA.has(id)));
+    const removedTables = sortStrings([...tablesA.keys()].filter((id) => !tablesB.has(id)));
+    const changedTables = {};
+    for (const id of sortStrings([...tablesA.keys()].filter((tid) => tablesB.has(tid)))) {
+        const changed = diffTable(tablesA.get(id), tablesB.get(id), a, b);
+        if (changed !== null)
+            changedTables[id] = changed;
+    }
+    const relationsA = new Map(a.relations.map((r) => [r.id, r]));
+    const relationsB = new Map(b.relations.map((r) => [r.id, r]));
+    const added = [...relationsB.values()].filter((r) => !relationsA.has(r.id)).sort(byId);
+    const removed = [...relationsA.values()]
+        .filter((r) => !relationsB.has(r.id))
+        .sort(byId);
+    let breaking = removedTables.some((id) => isReferenced(id));
+    if (!breaking) {
+        for (const [id, changed] of Object.entries(changedTables)) {
+            if (changed.removedColumns.some((column) => isReferenced(`${id}.${column}`)) ||
+                changed.typeChanged.some((change) => isReferenced(`${id}.${change.column}`)) ||
+                (changed.pkChanged && isReferenced(id))) {
+                breaking = true;
+                break;
+            }
+        }
+    }
+    return {
+        addedTables,
+        removedTables,
+        changedTables,
+        relationChanges: { added, removed },
+        breaking,
+    };
+}
+/** True when the diff carries no change at all. */
+export function isEmptyDiff(diff) {
+    return (diff.addedTables.length === 0 &&
+        diff.removedTables.length === 0 &&
+        Object.keys(diff.changedTables).length === 0 &&
+        diff.relationChanges.added.length === 0 &&
+        diff.relationChanges.removed.length === 0);
+}
+//# sourceMappingURL=diff.js.map

package/dist/snapshot/diff.js.map

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

package/dist/snapshot/hash.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Canonical model JSON + sha256 — 05-introspection-engine.md §9.
+ *
+ * `model_hash` in `adminium_schema_snapshots` is "sha256 over canonical
+ * JSON: sorted keys, stripped volatile fields
+ * introspectedAt/stats/warnings/rowCountEstimate/activity/sizeBytes".
+ * Identical hash to the latest snapshot → the meta-store writes no new row.
+ *
+ * Beyond the doc's letter we also sort the model's collection arrays by
+ * their stable keys (tables/relations/enums by id, columns/indexes by name)
+ * so two introspections that enumerate the catalog in a different order
+ * still hash identically.
+ */
+import type { DatabaseModel } from '../schema-model.js';
+/**
+ * The canonical (hash-input) JSON string for a model: volatile fields
+ * stripped, keys sorted, collections sorted by stable key. Pure — the input
+ * model is never mutated (operates on a deep clone).
+ */
+export declare function canonicalModelJson(model: DatabaseModel): string;
+/** sha256 hex digest of {@link canonicalModelJson}. */
+export declare function hashModel(model: DatabaseModel): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/snapshot/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/snapshot/hash.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAwBxD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAgB/D;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAEtD"}

package/dist/snapshot/hash.js

@@ -0,0 +1,47 @@
+import { sha256Hex } from './sha256.js';
+/** Top-level fields stripped before hashing (§9). */
+const VOLATILE_MODEL_FIELDS = ['introspectedAt', 'stats', 'warnings'];
+/** Per-table fields stripped before hashing (§9). */
+const VOLATILE_TABLE_FIELDS = ['rowCountEstimate', 'activity', 'sizeBytes'];
+function sortKeysDeep(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeysDeep);
+    if (value !== null && typeof value === 'object') {
+        const record = value;
+        const sorted = {};
+        for (const key of Object.keys(record).sort()) {
+            sorted[key] = sortKeysDeep(record[key]);
+        }
+        return sorted;
+    }
+    return value;
+}
+const byId = (a, b) => a.id.localeCompare(b.id);
+const byName = (a, b) => a.name.localeCompare(b.name);
+/**
+ * The canonical (hash-input) JSON string for a model: volatile fields
+ * stripped, keys sorted, collections sorted by stable key. Pure — the input
+ * model is never mutated (operates on a deep clone).
+ */
+export function canonicalModelJson(model) {
+    const plain = JSON.parse(JSON.stringify(model));
+    for (const field of VOLATILE_MODEL_FIELDS)
+        delete plain[field];
+    const tables = (plain['tables'] ?? []);
+    for (const table of tables) {
+        for (const field of VOLATILE_TABLE_FIELDS)
+            delete table[field];
+        table['columns']?.sort(byName);
+        table['indexes']?.sort(byName);
+    }
+    tables.sort(byId);
+    plain['relations']?.sort(byId);
+    plain['enums']?.sort(byId);
+    plain['schemas']?.sort();
+    return JSON.stringify(sortKeysDeep(plain));
+}
+/** sha256 hex digest of {@link canonicalModelJson}. */
+export function hashModel(model) {
+    return sha256Hex(canonicalModelJson(model));
+}
+//# sourceMappingURL=hash.js.map

package/dist/snapshot/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/snapshot/hash.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qDAAqD;AACrD,MAAM,qBAAqB,GAAG,CAAC,gBAAgB,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAC/E,qDAAqD;AACrD,MAAM,qBAAqB,GAAG,CAAC,kBAAkB,EAAE,UAAU,EAAE,WAAW,CAAU,CAAC;AAErF,SAAS,YAAY,CAAC,KAAc;IAClC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IACzD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,MAAM,MAAM,GAAG,KAAgC,CAAC;QAChD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC7C,MAAM,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,CAAiB,EAAE,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAChF,MAAM,MAAM,GAAG,CAAC,CAAmB,EAAE,CAAmB,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAE1F;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAoB;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAA4B,CAAC;IAC3E,KAAK,MAAM,KAAK,IAAI,qBAAqB;QAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAiD,CAAC;IACvF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,KAAK,IAAI,qBAAqB;YAAE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9D,KAAK,CAAC,SAAS,CAAoC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClE,KAAK,CAAC,SAAS,CAAoC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,WAAW,CAAkC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,KAAK,CAAC,OAAO,CAAkC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,KAAK,CAAC,SAAS,CAA0B,EAAE,IAAI,EAAE,CAAC;IAEnD,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,KAAoB;IAC5C,OAAO,SAAS,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC;AAC9C,CAAC"}

package/dist/snapshot/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Snapshot module — 05-introspection-engine.md §9 (M3-T02 diff half /
+ * 05-T09 engine side).
+ *
+ * The engine computes checksums and diffs; PERSISTENCE is owned by
+ * `@adminium/meta` (`adminium_schema_snapshots` — 07-meta-store.md). The
+ * store's dedupe rule uses `Snapshot.checksum`: identical checksum to the
+ * latest snapshot → no new row, just touch `checked_at`.
+ */
+import type { DatabaseModel } from '../schema-model.js';
+import { type DiffOptions, type SchemaDiff } from './diff.js';
+export { canonicalModelJson, hashModel } from './hash.js';
+export { sha256Hex } from './sha256.js';
+export { changedTableSchema, diffModels, isEmptyDiff, schemaDiffSchema, type ChangedTable, type DiffOptions, type SchemaDiff, } from './diff.js';
+/** An in-memory snapshot: the model plus its canonical sha256 checksum. */
+export interface Snapshot {
+    /** sha256 hex over canonical JSON (volatile fields stripped — hash.ts). */
+    checksum: string;
+    model: DatabaseModel;
+}
+/** Build a snapshot for a model. Pure; the model is not copied or mutated. */
+export declare function snapshotFromModel(model: DatabaseModel): Snapshot;
+/**
+ * Diff two snapshots (FROM `a` TO `b`). Equal checksums short-circuit to an
+ * empty diff without walking the models.
+ */
+export declare function diffSnapshots(a: Snapshot, b: Snapshot, options?: DiffOptions): SchemaDiff;
+//# sourceMappingURL=index.d.ts.map

package/dist/snapshot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EAAc,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,GAChB,MAAM,WAAW,CAAC;AAEnB,2EAA2E;AAC3E,MAAM,WAAW,QAAQ;IACvB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,aAAa,CAAC;CACtB;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,QAAQ,CAEhE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,UAAU,CAWzF"}

package/dist/snapshot/index.js

@@ -0,0 +1,26 @@
+import { hashModel } from './hash.js';
+import { diffModels } from './diff.js';
+export { canonicalModelJson, hashModel } from './hash.js';
+export { sha256Hex } from './sha256.js';
+export { changedTableSchema, diffModels, isEmptyDiff, schemaDiffSchema, } from './diff.js';
+/** Build a snapshot for a model. Pure; the model is not copied or mutated. */
+export function snapshotFromModel(model) {
+    return { checksum: hashModel(model), model };
+}
+/**
+ * Diff two snapshots (FROM `a` TO `b`). Equal checksums short-circuit to an
+ * empty diff without walking the models.
+ */
+export function diffSnapshots(a, b, options) {
+    if (a.checksum === b.checksum) {
+        return {
+            addedTables: [],
+            removedTables: [],
+            changedTables: {},
+            relationChanges: { added: [], removed: [] },
+            breaking: false,
+        };
+    }
+    return diffModels(a.model, b.model, options);
+}
+//# sourceMappingURL=index.js.map

package/dist/snapshot/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/snapshot/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAqC,MAAM,WAAW,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,WAAW,EACX,gBAAgB,GAIjB,MAAM,WAAW,CAAC;AASnB,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB,CAAC,KAAoB;IACpD,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC;AAC/C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,CAAW,EAAE,CAAW,EAAE,OAAqB;IAC3E,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,WAAW,EAAE,EAAE;YACf,aAAa,EAAE,EAAE;YACjB,aAAa,EAAE,EAAE;YACjB,eAAe,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC3C,QAAQ,EAAE,KAAK;SAChB,CAAC;IACJ,CAAC;IACD,OAAO,UAAU,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC"}

package/dist/snapshot/sha256.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal, dependency-free SHA-256 (FIPS 180-4) over a UTF-8 string.
+ *
+ * Why not `node:crypto`: `@adminium/engine` src is environment-agnostic —
+ * it declares no node types and its subpaths may be bundled client-side
+ * (01-architecture.md §2.3.2). Web Crypto's `subtle.digest` is async, which
+ * would poison the pure/sync snapshot API for no benefit at these input
+ * sizes (a 500-table model is < 10 MB; SHA-256 of that is milliseconds).
+ *
+ * Verified against the FIPS test vectors in test/snapshot.test.ts.
+ */
+/** SHA-256 hex digest of the UTF-8 encoding of `input`. */
+export declare function sha256Hex(input: string): string;
+//# sourceMappingURL=sha256.d.ts.map

package/dist/snapshot/sha256.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sha256.d.ts","sourceRoot":"","sources":["../../src/snapshot/sha256.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyCH,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CA0D/C"}