zenstack-kit 0.1.1

package/dist/schema/snapshot.js

@@ -0,0 +1,278 @@
+/**
+ * Schema snapshot utilities for ZenStack schemas
+ *
+ * Uses ZenStack's AST to create a stable, diffable schema snapshot.
+ */
+import { loadDocument } from "@zenstackhq/language";
+import { isDataField, isDataModel, isEnum } from "@zenstackhq/language/ast";
+function getAttribute(node, name) {
+    return node.attributes.find((attr) => attr.decl.$refText === name);
+}
+function getAttributeStringArg(attr, names) {
+    if (!attr)
+        return undefined;
+    for (const arg of attr.args) {
+        const paramName = arg.$resolvedParam?.name;
+        if (paramName && names.includes(paramName)) {
+            if (arg.value?.$type === "StringLiteral") {
+                return arg.value.value;
+            }
+        }
+    }
+    const firstArg = attr.args[0];
+    if (firstArg?.value?.$type === "StringLiteral") {
+        return firstArg.value.value;
+    }
+    return undefined;
+}
+function getAttributeArrayRefs(attr, name) {
+    if (!attr)
+        return undefined;
+    const arg = attr.args.find((item) => item.$resolvedParam?.name === name) ?? attr.args[0];
+    if (!arg?.value || arg.value.$type !== "ArrayExpr") {
+        return undefined;
+    }
+    const refs = arg.value.items
+        .filter((item) => item.$type === "ReferenceExpr")
+        .map((item) => item.target.$refText);
+    return refs.length > 0 ? refs : undefined;
+}
+function getDefaultValue(field) {
+    const attr = getAttribute(field, "@default");
+    if (!attr) {
+        return { hasDefault: false };
+    }
+    const valueArg = attr.args.find((arg) => arg.$resolvedParam?.name === "value") ?? attr.args[0];
+    const expr = valueArg?.value;
+    if (!expr) {
+        return { hasDefault: true };
+    }
+    if (expr.$type === "StringLiteral") {
+        return { hasDefault: true, default: expr.value };
+    }
+    if (expr.$type === "NumberLiteral") {
+        return { hasDefault: true, default: Number(expr.value) };
+    }
+    if (expr.$type === "BooleanLiteral") {
+        return { hasDefault: true, default: expr.value };
+    }
+    // Handle function calls like autoincrement(), now(), etc.
+    if (expr.$type === "InvocationExpr") {
+        const funcName = expr.function.$refText;
+        if (funcName === "autoincrement") {
+            return { hasDefault: true, isAutoincrement: true };
+        }
+        if (funcName === "now") {
+            return { hasDefault: true, default: "now()" };
+        }
+        // Return function name for other functions
+        return { hasDefault: true, default: `${funcName}()` };
+    }
+    return { hasDefault: true };
+}
+function getTableName(model) {
+    const mapAttr = getAttribute(model, "@@map");
+    const mapped = getAttributeStringArg(mapAttr, ["name", "map"]);
+    return mapped ?? model.name.toLowerCase();
+}
+function getColumnName(field) {
+    const mapAttr = getAttribute(field, "@map");
+    return getAttributeStringArg(mapAttr, ["name", "map"]) ?? field.name;
+}
+function mapFieldTypeToSQL(fieldType) {
+    const typeMap = {
+        String: "text",
+        Int: "integer",
+        Float: "double precision",
+        Boolean: "boolean",
+        DateTime: "timestamp",
+        BigInt: "bigint",
+        Decimal: "decimal",
+        Json: "json",
+        Bytes: "blob",
+    };
+    return typeMap[fieldType] ?? "text";
+}
+/**
+ * Prisma-compatible constraint naming conventions
+ *
+ * Prisma uses PostgreSQL-aligned naming:
+ * - Primary Key: {Table}_pkey
+ * - Unique: {Table}_{columns}_key
+ * - Index: {Table}_{columns}_idx
+ * - Foreign Key: {Table}_{columns}_fkey
+ */
+function buildPrimaryKeyName(tableName, explicitName) {
+    return explicitName ?? `${tableName}_pkey`;
+}
+function buildUniqueName(tableName, columns, explicitName) {
+    if (explicitName)
+        return explicitName;
+    return `${tableName}_${columns.join("_")}_key`;
+}
+function buildIndexName(tableName, columns, explicitName) {
+    if (explicitName)
+        return explicitName;
+    return `${tableName}_${columns.join("_")}_idx`;
+}
+function buildForeignKeyName(tableName, columns, _referencedTable, _referencedColumns, explicitName) {
+    if (explicitName)
+        return explicitName;
+    // Prisma uses {Table}_{columns}_fkey (doesn't include referenced table/columns in name)
+    return `${tableName}_${columns.join("_")}_fkey`;
+}
+function getFieldType(field) {
+    const ref = field.type.reference?.ref;
+    if (ref && isDataModel(ref)) {
+        return { type: ref.name, isRelation: true };
+    }
+    if (ref && isEnum(ref)) {
+        return { type: ref.name, isRelation: false };
+    }
+    return { type: field.type.type ?? "String", isRelation: false };
+}
+function getRelationFieldNames(field) {
+    const relationAttr = getAttribute(field, "@relation");
+    if (!relationAttr)
+        return null;
+    const fields = getAttributeArrayRefs(relationAttr, "fields");
+    const references = getAttributeArrayRefs(relationAttr, "references");
+    if (!fields || !references)
+        return null;
+    const mapName = getAttributeStringArg(relationAttr, ["map", "name"]);
+    return { fields, references, mapName };
+}
+function buildFieldNameMap(model) {
+    const map = new Map();
+    for (const field of model.fields) {
+        if (!isDataField(field))
+            continue;
+        map.set(field.name, getColumnName(field));
+    }
+    return map;
+}
+function parseModel(model) {
+    const tableName = getTableName(model);
+    const columns = [];
+    const fieldNameMap = buildFieldNameMap(model);
+    for (const field of model.fields) {
+        if (!isDataField(field))
+            continue;
+        const typeInfo = getFieldType(field);
+        if (typeInfo.isRelation) {
+            continue;
+        }
+        const defaultInfo = getDefaultValue(field);
+        const columnName = getColumnName(field);
+        const sqlType = mapFieldTypeToSQL(typeInfo.type);
+        columns.push({
+            name: columnName,
+            type: sqlType,
+            notNull: !field.type.optional,
+            isArray: field.type.array ?? false,
+            default: defaultInfo.default,
+            isAutoincrement: defaultInfo.isAutoincrement,
+        });
+    }
+    const modelIdAttr = getAttribute(model, "@@id");
+    const modelIdFields = getAttributeArrayRefs(modelIdAttr, "fields");
+    const modelIdName = getAttributeStringArg(modelIdAttr, ["name", "map"]);
+    const primaryKeyColumns = modelIdFields?.map((name) => fieldNameMap.get(name) ?? name) ?? [];
+    const fieldIdColumns = model.fields
+        .filter((field) => isDataField(field))
+        .filter((field) => !!getAttribute(field, "@id"))
+        .map((field) => getColumnName(field));
+    const resolvedPrimaryKeyColumns = primaryKeyColumns.length > 0 ? primaryKeyColumns : fieldIdColumns;
+    const primaryKey = resolvedPrimaryKeyColumns.length > 0
+        ? {
+            name: buildPrimaryKeyName(tableName, modelIdName),
+            columns: resolvedPrimaryKeyColumns,
+        }
+        : undefined;
+    const uniqueConstraints = [];
+    const uniqueAttrs = model.attributes.filter((attr) => attr.decl.$refText === "@@unique");
+    for (const attr of uniqueAttrs) {
+        const columns = getAttributeArrayRefs(attr, "fields");
+        if (!columns || columns.length === 0)
+            continue;
+        const resolvedColumns = columns.map((name) => fieldNameMap.get(name) ?? name);
+        const explicitName = getAttributeStringArg(attr, ["name", "map"]);
+        uniqueConstraints.push({
+            name: buildUniqueName(tableName, resolvedColumns, explicitName),
+            columns: resolvedColumns,
+        });
+    }
+    for (const field of model.fields) {
+        if (!isDataField(field))
+            continue;
+        if (!getAttribute(field, "@unique"))
+            continue;
+        const columnName = getColumnName(field);
+        const constraintName = buildUniqueName(tableName, [columnName]);
+        if (!uniqueConstraints.some((constraint) => constraint.name === constraintName)) {
+            uniqueConstraints.push({ name: constraintName, columns: [columnName] });
+        }
+    }
+    const indexes = [];
+    const indexAttrs = model.attributes.filter((attr) => attr.decl.$refText === "@@index");
+    for (const attr of indexAttrs) {
+        const columns = getAttributeArrayRefs(attr, "fields");
+        if (!columns || columns.length === 0)
+            continue;
+        const resolvedColumns = columns.map((name) => fieldNameMap.get(name) ?? name);
+        const explicitName = getAttributeStringArg(attr, ["name", "map"]);
+        indexes.push({
+            name: buildIndexName(tableName, resolvedColumns, explicitName),
+            columns: resolvedColumns,
+        });
+    }
+    const foreignKeys = [];
+    for (const field of model.fields) {
+        if (!isDataField(field))
+            continue;
+        const relation = getRelationFieldNames(field);
+        if (!relation)
+            continue;
+        const refModel = field.type.reference?.ref;
+        if (!refModel || !isDataModel(refModel))
+            continue;
+        const referencedTable = getTableName(refModel);
+        const referencedFieldMap = buildFieldNameMap(refModel);
+        const referencedColumnNames = relation.references.map((name) => referencedFieldMap.get(name) ?? name);
+        const columnNames = relation.fields.map((name) => fieldNameMap.get(name) ?? name);
+        foreignKeys.push({
+            name: buildForeignKeyName(tableName, columnNames, referencedTable, referencedColumnNames, relation.mapName),
+            columns: columnNames,
+            referencedTable,
+            referencedColumns: referencedColumnNames,
+        });
+    }
+    const sortedColumns = columns.sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        name: tableName,
+        columns: sortedColumns,
+        primaryKey,
+        uniqueConstraints: uniqueConstraints.sort((a, b) => a.name.localeCompare(b.name)),
+        indexes: indexes.sort((a, b) => a.name.localeCompare(b.name)),
+        foreignKeys: foreignKeys.sort((a, b) => a.name.localeCompare(b.name)),
+    };
+}
+export async function generateSchemaSnapshot(schemaPath) {
+    const loadResult = await loadDocument(schemaPath);
+    if (!loadResult.success) {
+        const messages = loadResult.errors.map((error) => String(error)).join("\n");
+        throw new Error(`Failed to load schema:\n${messages}`);
+    }
+    const dataModels = loadResult.model.declarations.filter(isDataModel);
+    const tables = dataModels
+        .map((model) => parseModel(model))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    return { tables };
+}
+export function createSnapshot(schema) {
+    return {
+        version: 2,
+        createdAt: new Date().toISOString(),
+        schema,
+    };
+}

package/dist/schema-snapshot.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Schema snapshot utilities for ZenStack schemas
+ *
+ * Uses ZenStack's AST to create a stable, diffable schema snapshot.
+ */
+export interface SchemaColumn {
+    name: string;
+    type: string;
+    notNull: boolean;
+    isArray: boolean;
+    default?: string | number | boolean;
+}
+export interface SchemaConstraint {
+    name: string;
+    columns: string[];
+}
+export interface SchemaIndex {
+    name: string;
+    columns: string[];
+}
+export interface SchemaForeignKey {
+    name: string;
+    columns: string[];
+    referencedTable: string;
+    referencedColumns: string[];
+}
+export interface SchemaTable {
+    name: string;
+    columns: SchemaColumn[];
+    primaryKey?: SchemaConstraint;
+    uniqueConstraints: SchemaConstraint[];
+    indexes: SchemaIndex[];
+    foreignKeys: SchemaForeignKey[];
+}
+export interface SchemaSnapshot {
+    tables: SchemaTable[];
+}
+export interface SchemaSnapshotFile {
+    version: 2;
+    createdAt: string;
+    schema: SchemaSnapshot;
+}
+export declare function generateSchemaSnapshot(schemaPath: string): Promise<SchemaSnapshot>;
+export declare function createSnapshot(schema: SchemaSnapshot): SchemaSnapshotFile;
+//# sourceMappingURL=schema-snapshot.d.ts.map

package/dist/schema-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-snapshot.d.ts","sourceRoot":"","sources":["../src/schema-snapshot.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;IACtC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;CACxB;AAmTD,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAaxF;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,kBAAkB,CAMzE"}

package/dist/schema-snapshot.js

@@ -0,0 +1,265 @@
+/**
+ * Schema snapshot utilities for ZenStack schemas
+ *
+ * Uses ZenStack's AST to create a stable, diffable schema snapshot.
+ */
+import { loadDocument } from "@zenstackhq/language";
+import { isDataField, isDataModel, isEnum } from "@zenstackhq/language/ast";
+function getAttribute(node, name) {
+    return node.attributes.find((attr) => attr.decl.$refText === name);
+}
+function getAttributeStringArg(attr, names) {
+    if (!attr)
+        return undefined;
+    for (const arg of attr.args) {
+        const paramName = arg.$resolvedParam?.name;
+        if (paramName && names.includes(paramName)) {
+            if (arg.value?.$type === "StringLiteral") {
+                return arg.value.value;
+            }
+        }
+    }
+    const firstArg = attr.args[0];
+    if (firstArg?.value?.$type === "StringLiteral") {
+        return firstArg.value.value;
+    }
+    return undefined;
+}
+function getAttributeArrayRefs(attr, name) {
+    if (!attr)
+        return undefined;
+    const arg = attr.args.find((item) => item.$resolvedParam?.name === name) ?? attr.args[0];
+    if (!arg?.value || arg.value.$type !== "ArrayExpr") {
+        return undefined;
+    }
+    const refs = arg.value.items
+        .filter((item) => item.$type === "ReferenceExpr")
+        .map((item) => item.target.$refText);
+    return refs.length > 0 ? refs : undefined;
+}
+function getDefaultValue(field) {
+    const attr = getAttribute(field, "@default");
+    if (!attr) {
+        return { hasDefault: false };
+    }
+    const valueArg = attr.args.find((arg) => arg.$resolvedParam?.name === "value") ?? attr.args[0];
+    const expr = valueArg?.value;
+    if (!expr) {
+        return { hasDefault: true };
+    }
+    if (expr.$type === "StringLiteral") {
+        return { hasDefault: true, default: expr.value };
+    }
+    if (expr.$type === "NumberLiteral") {
+        return { hasDefault: true, default: Number(expr.value) };
+    }
+    if (expr.$type === "BooleanLiteral") {
+        return { hasDefault: true, default: expr.value };
+    }
+    return { hasDefault: true };
+}
+function getTableName(model) {
+    const mapAttr = getAttribute(model, "@@map");
+    const mapped = getAttributeStringArg(mapAttr, ["name", "map"]);
+    return mapped ?? model.name.toLowerCase();
+}
+function getColumnName(field) {
+    const mapAttr = getAttribute(field, "@map");
+    return getAttributeStringArg(mapAttr, ["name", "map"]) ?? field.name;
+}
+function mapFieldTypeToSQL(fieldType) {
+    const typeMap = {
+        String: "text",
+        Int: "integer",
+        Float: "double precision",
+        Boolean: "boolean",
+        DateTime: "timestamp",
+        BigInt: "bigint",
+        Decimal: "decimal",
+        Json: "json",
+        Bytes: "blob",
+    };
+    return typeMap[fieldType] ?? "text";
+}
+/**
+ * Prisma-compatible constraint naming conventions
+ *
+ * Prisma uses PostgreSQL-aligned naming:
+ * - Primary Key: {Table}_pkey
+ * - Unique: {Table}_{columns}_key
+ * - Index: {Table}_{columns}_idx
+ * - Foreign Key: {Table}_{columns}_fkey
+ */
+function buildPrimaryKeyName(tableName, explicitName) {
+    return explicitName ?? `${tableName}_pkey`;
+}
+function buildUniqueName(tableName, columns, explicitName) {
+    if (explicitName)
+        return explicitName;
+    return `${tableName}_${columns.join("_")}_key`;
+}
+function buildIndexName(tableName, columns, explicitName) {
+    if (explicitName)
+        return explicitName;
+    return `${tableName}_${columns.join("_")}_idx`;
+}
+function buildForeignKeyName(tableName, columns, _referencedTable, _referencedColumns, explicitName) {
+    if (explicitName)
+        return explicitName;
+    // Prisma uses {Table}_{columns}_fkey (doesn't include referenced table/columns in name)
+    return `${tableName}_${columns.join("_")}_fkey`;
+}
+function getFieldType(field) {
+    const ref = field.type.reference?.ref;
+    if (ref && isDataModel(ref)) {
+        return { type: ref.name, isRelation: true };
+    }
+    if (ref && isEnum(ref)) {
+        return { type: ref.name, isRelation: false };
+    }
+    return { type: field.type.type ?? "String", isRelation: false };
+}
+function getRelationFieldNames(field) {
+    const relationAttr = getAttribute(field, "@relation");
+    if (!relationAttr)
+        return null;
+    const fields = getAttributeArrayRefs(relationAttr, "fields");
+    const references = getAttributeArrayRefs(relationAttr, "references");
+    if (!fields || !references)
+        return null;
+    const mapName = getAttributeStringArg(relationAttr, ["map", "name"]);
+    return { fields, references, mapName };
+}
+function buildFieldNameMap(model) {
+    const map = new Map();
+    for (const field of model.fields) {
+        if (!isDataField(field))
+            continue;
+        map.set(field.name, getColumnName(field));
+    }
+    return map;
+}
+function parseModel(model) {
+    const tableName = getTableName(model);
+    const columns = [];
+    const fieldNameMap = buildFieldNameMap(model);
+    for (const field of model.fields) {
+        if (!isDataField(field))
+            continue;
+        const typeInfo = getFieldType(field);
+        if (typeInfo.isRelation) {
+            continue;
+        }
+        const defaultInfo = getDefaultValue(field);
+        const columnName = getColumnName(field);
+        const sqlType = mapFieldTypeToSQL(typeInfo.type);
+        columns.push({
+            name: columnName,
+            type: sqlType,
+            notNull: !field.type.optional,
+            isArray: field.type.array ?? false,
+            default: defaultInfo.default,
+        });
+    }
+    const modelIdAttr = getAttribute(model, "@@id");
+    const modelIdFields = getAttributeArrayRefs(modelIdAttr, "fields");
+    const modelIdName = getAttributeStringArg(modelIdAttr, ["name", "map"]);
+    const primaryKeyColumns = modelIdFields?.map((name) => fieldNameMap.get(name) ?? name) ?? [];
+    const fieldIdColumns = model.fields
+        .filter((field) => isDataField(field))
+        .filter((field) => !!getAttribute(field, "@id"))
+        .map((field) => getColumnName(field));
+    const resolvedPrimaryKeyColumns = primaryKeyColumns.length > 0 ? primaryKeyColumns : fieldIdColumns;
+    const primaryKey = resolvedPrimaryKeyColumns.length > 0
+        ? {
+            name: buildPrimaryKeyName(tableName, modelIdName),
+            columns: resolvedPrimaryKeyColumns,
+        }
+        : undefined;
+    const uniqueConstraints = [];
+    const uniqueAttrs = model.attributes.filter((attr) => attr.decl.$refText === "@@unique");
+    for (const attr of uniqueAttrs) {
+        const columns = getAttributeArrayRefs(attr, "fields");
+        if (!columns || columns.length === 0)
+            continue;
+        const resolvedColumns = columns.map((name) => fieldNameMap.get(name) ?? name);
+        const explicitName = getAttributeStringArg(attr, ["name", "map"]);
+        uniqueConstraints.push({
+            name: buildUniqueName(tableName, resolvedColumns, explicitName),
+            columns: resolvedColumns,
+        });
+    }
+    for (const field of model.fields) {
+        if (!isDataField(field))
+            continue;
+        if (!getAttribute(field, "@unique"))
+            continue;
+        const columnName = getColumnName(field);
+        const constraintName = buildUniqueName(tableName, [columnName]);
+        if (!uniqueConstraints.some((constraint) => constraint.name === constraintName)) {
+            uniqueConstraints.push({ name: constraintName, columns: [columnName] });
+        }
+    }
+    const indexes = [];
+    const indexAttrs = model.attributes.filter((attr) => attr.decl.$refText === "@@index");
+    for (const attr of indexAttrs) {
+        const columns = getAttributeArrayRefs(attr, "fields");
+        if (!columns || columns.length === 0)
+            continue;
+        const resolvedColumns = columns.map((name) => fieldNameMap.get(name) ?? name);
+        const explicitName = getAttributeStringArg(attr, ["name", "map"]);
+        indexes.push({
+            name: buildIndexName(tableName, resolvedColumns, explicitName),
+            columns: resolvedColumns,
+        });
+    }
+    const foreignKeys = [];
+    for (const field of model.fields) {
+        if (!isDataField(field))
+            continue;
+        const relation = getRelationFieldNames(field);
+        if (!relation)
+            continue;
+        const refModel = field.type.reference?.ref;
+        if (!refModel || !isDataModel(refModel))
+            continue;
+        const referencedTable = getTableName(refModel);
+        const referencedFieldMap = buildFieldNameMap(refModel);
+        const referencedColumnNames = relation.references.map((name) => referencedFieldMap.get(name) ?? name);
+        const columnNames = relation.fields.map((name) => fieldNameMap.get(name) ?? name);
+        foreignKeys.push({
+            name: buildForeignKeyName(tableName, columnNames, referencedTable, referencedColumnNames, relation.mapName),
+            columns: columnNames,
+            referencedTable,
+            referencedColumns: referencedColumnNames,
+        });
+    }
+    const sortedColumns = columns.sort((a, b) => a.name.localeCompare(b.name));
+    return {
+        name: tableName,
+        columns: sortedColumns,
+        primaryKey,
+        uniqueConstraints: uniqueConstraints.sort((a, b) => a.name.localeCompare(b.name)),
+        indexes: indexes.sort((a, b) => a.name.localeCompare(b.name)),
+        foreignKeys: foreignKeys.sort((a, b) => a.name.localeCompare(b.name)),
+    };
+}
+export async function generateSchemaSnapshot(schemaPath) {
+    const loadResult = await loadDocument(schemaPath);
+    if (!loadResult.success) {
+        const messages = loadResult.errors.map((error) => String(error)).join("\n");
+        throw new Error(`Failed to load schema:\n${messages}`);
+    }
+    const dataModels = loadResult.model.declarations.filter(isDataModel);
+    const tables = dataModels
+        .map((model) => parseModel(model))
+        .sort((a, b) => a.name.localeCompare(b.name));
+    return { tables };
+}
+export function createSnapshot(schema) {
+    return {
+        version: 2,
+        createdAt: new Date().toISOString(),
+        schema,
+    };
+}

package/dist/sql/compiler.d.ts

@@ -0,0 +1,74 @@
+/**
+ * SQL Compiler - Generates raw SQL from schema operations using Kysely's compile()
+ *
+ * Uses Kysely with DummyDriver to compile schema operations to dialect-specific SQL
+ * without requiring a database connection.
+ */
+import type { KyselyDialect } from "./kysely-adapter.js";
+import type { SchemaTable, SchemaColumn } from "../schema/snapshot.js";
+export interface SqlMigration {
+    up: string[];
+    down: string[];
+}
+export interface CompileSqlOptions {
+    dialect: KyselyDialect;
+}
+/**
+ * Compile a CREATE TABLE statement to SQL
+ */
+export declare function compileCreateTable(model: SchemaTable, options: CompileSqlOptions): string;
+/**
+ * Compile a DROP TABLE statement to SQL
+ */
+export declare function compileDropTable(tableName: string, options: CompileSqlOptions): string;
+/**
+ * Compile an ADD COLUMN statement to SQL
+ */
+export declare function compileAddColumn(tableName: string, column: SchemaColumn, options: CompileSqlOptions): string;
+/**
+ * Compile a DROP COLUMN statement to SQL
+ */
+export declare function compileDropColumn(tableName: string, columnName: string, options: CompileSqlOptions): string;
+/**
+ * Compile a RENAME TABLE statement to SQL
+ */
+export declare function compileRenameTable(fromName: string, toName: string, options: CompileSqlOptions): string;
+/**
+ * Compile a RENAME COLUMN statement to SQL
+ */
+export declare function compileRenameColumn(tableName: string, fromName: string, toName: string, options: CompileSqlOptions): string;
+/**
+ * Compile a CREATE INDEX statement to SQL
+ */
+export declare function compileCreateIndex(tableName: string, indexName: string, columns: string[], options: CompileSqlOptions): string;
+/**
+ * Compile a DROP INDEX statement to SQL
+ */
+export declare function compileDropIndex(indexName: string, options: CompileSqlOptions): string;
+/**
+ * Compile an ADD CONSTRAINT (unique) statement to SQL
+ */
+export declare function compileAddUniqueConstraint(tableName: string, constraintName: string, columns: string[], options: CompileSqlOptions): string;
+/**
+ * Compile a DROP CONSTRAINT statement to SQL
+ */
+export declare function compileDropConstraint(tableName: string, constraintName: string, options: CompileSqlOptions): string;
+/**
+ * Compile an ADD FOREIGN KEY CONSTRAINT statement to SQL
+ */
+export declare function compileAddForeignKeyConstraint(tableName: string, constraintName: string, columns: string[], referencedTable: string, referencedColumns: string[], options: CompileSqlOptions): string;
+/**
+ * Compile an ADD PRIMARY KEY CONSTRAINT statement to SQL
+ */
+export declare function compileAddPrimaryKeyConstraint(tableName: string, constraintName: string, columns: string[], options: CompileSqlOptions): string;
+/**
+ * Compile ALTER COLUMN statements for type/nullability/default changes
+ */
+export declare function compileAlterColumn(tableName: string, columnName: string, changes: {
+    setType?: string;
+    setNotNull?: boolean;
+    dropNotNull?: boolean;
+    setDefault?: string | number | boolean;
+    dropDefault?: boolean;
+}, options: CompileSqlOptions): string[];
+//# sourceMappingURL=compiler.d.ts.map

package/dist/sql/compiler.d.ts.map

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