zenstack-kit 0.1.4 → 0.1.5

package/dist/migrations/prisma/create.d.ts

@@ -0,0 +1,63 @@
+import type { KyselyDialect } from "../../sql/kysely-adapter.js";
+export interface PrismaMigrationOptions {
+    /** Migration name */
+    name: string;
+    /** Path to ZenStack schema file */
+    schemaPath: string;
+    /** Output directory for migration files */
+    outputPath: string;
+    /** Database dialect for SQL generation */
+    dialect: KyselyDialect;
+    /** Table rename mappings */
+    renameTables?: Array<{
+        from: string;
+        to: string;
+    }>;
+    /** Column rename mappings */
+    renameColumns?: Array<{
+        table: string;
+        from: string;
+        to: string;
+    }>;
+}
+export interface PrismaMigration {
+    /** Migration folder name (timestamp_name) */
+    folderName: string;
+    /** Full path to migration folder */
+    folderPath: string;
+    /** SQL content */
+    sql: string;
+    /** Timestamp */
+    timestamp: number;
+}
+export interface CreateInitialMigrationOptions {
+    /** Migration name (default: "init") */
+    name?: string;
+    /** Path to ZenStack schema file */
+    schemaPath: string;
+    /** Output directory for migration files */
+    outputPath: string;
+    /** Database dialect for SQL generation */
+    dialect: KyselyDialect;
+}
+/**
+ * Generate timestamp string for migration folder name
+ */
+export declare function generateTimestamp(): string;
+/**
+ * Create a Prisma-compatible migration
+ */
+export declare function createPrismaMigration(options: PrismaMigrationOptions): Promise<PrismaMigration | null>;
+/**
+ * Create an initial migration that creates all tables from scratch.
+ * This is used when initializing a project where the database is empty.
+ */
+export declare function createInitialMigration(options: CreateInitialMigrationOptions): Promise<PrismaMigration>;
+/**
+ * Check if there are schema changes
+ */
+export declare function hasPrismaSchemaChanges(options: {
+    schemaPath: string;
+    outputPath: string;
+}): Promise<boolean>;
+//# sourceMappingURL=create.d.ts.map

package/dist/migrations/prisma/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/migrations/prisma/create.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAMjE,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,4BAA4B;IAC5B,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,6BAA6B;IAC7B,aAAa,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,OAAO,EAAE,aAAa,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAU1C;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAiDjC;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,eAAe,CAAC,CAwC1B;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE;IACpD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,OAAO,CAAC,CAqBnB"}

package/dist/migrations/prisma/create.js

@@ -0,0 +1,119 @@
+import * as fs from "fs/promises";
+import * as path from "path";
+import { generateSchemaSnapshot } from "../../schema/snapshot.js";
+import { applyRenameMappings, buildSqlStatements, diffSchemas } from "./diff.js";
+import { appendToMigrationLog, calculateChecksum } from "./log.js";
+import { getSnapshotPaths, readSnapshot, writeSnapshot } from "./snapshot.js";
+/**
+ * Generate timestamp string for migration folder name
+ */
+export function generateTimestamp() {
+    const now = new Date();
+    return [
+        now.getFullYear(),
+        String(now.getMonth() + 1).padStart(2, "0"),
+        String(now.getDate()).padStart(2, "0"),
+        String(now.getHours()).padStart(2, "0"),
+        String(now.getMinutes()).padStart(2, "0"),
+        String(now.getSeconds()).padStart(2, "0"),
+    ].join("");
+}
+/**
+ * Create a Prisma-compatible migration
+ */
+export async function createPrismaMigration(options) {
+    const currentSchema = await generateSchemaSnapshot(options.schemaPath);
+    const { snapshotPath } = getSnapshotPaths(options.outputPath);
+    const previousSnapshot = await readSnapshot(snapshotPath);
+    const diff = applyRenameMappings(diffSchemas(previousSnapshot?.schema ?? null, currentSchema), options.renameTables, options.renameColumns);
+    const { up } = buildSqlStatements(diff, options.dialect);
+    if (up.length === 0) {
+        return null;
+    }
+    const timestamp = Date.now();
+    const timestampStr = generateTimestamp();
+    const safeName = options.name.replace(/[^a-z0-9]/gi, "_").toLowerCase();
+    const folderName = `${timestampStr}_${safeName}`;
+    const folderPath = path.join(options.outputPath, folderName);
+    // Build migration.sql content with comments
+    const sqlContent = [
+        `-- Migration: ${options.name}`,
+        `-- Generated at: ${new Date(timestamp).toISOString()}`,
+        "",
+        ...up,
+        "",
+    ].join("\n");
+    // Create migration folder and file
+    await fs.mkdir(folderPath, { recursive: true });
+    await fs.writeFile(path.join(folderPath, "migration.sql"), sqlContent, "utf-8");
+    // Update snapshot
+    await writeSnapshot(snapshotPath, currentSchema);
+    // Append to migration log
+    const checksum = calculateChecksum(sqlContent);
+    await appendToMigrationLog(options.outputPath, { name: folderName, checksum });
+    return {
+        folderName,
+        folderPath,
+        sql: sqlContent,
+        timestamp,
+    };
+}
+/**
+ * Create an initial migration that creates all tables from scratch.
+ * This is used when initializing a project where the database is empty.
+ */
+export async function createInitialMigration(options) {
+    const currentSchema = await generateSchemaSnapshot(options.schemaPath);
+    const { snapshotPath } = getSnapshotPaths(options.outputPath);
+    // Diff against empty schema to get full creation SQL
+    const diff = diffSchemas(null, currentSchema);
+    const { up } = buildSqlStatements(diff, options.dialect);
+    const timestamp = Date.now();
+    const timestampStr = generateTimestamp();
+    const safeName = (options.name ?? "init").replace(/[^a-z0-9]/gi, "_").toLowerCase();
+    const folderName = `${timestampStr}_${safeName}`;
+    const folderPath = path.join(options.outputPath, folderName);
+    // Build migration.sql content with comments
+    const sqlContent = [
+        `-- Migration: ${options.name ?? "init"}`,
+        `-- Generated at: ${new Date(timestamp).toISOString()}`,
+        "",
+        ...up,
+        "",
+    ].join("\n");
+    // Create migration folder and file
+    await fs.mkdir(folderPath, { recursive: true });
+    await fs.writeFile(path.join(folderPath, "migration.sql"), sqlContent, "utf-8");
+    // Update snapshot
+    await writeSnapshot(snapshotPath, currentSchema);
+    // Append to migration log
+    const checksum = calculateChecksum(sqlContent);
+    await appendToMigrationLog(options.outputPath, { name: folderName, checksum });
+    return {
+        folderName,
+        folderPath,
+        sql: sqlContent,
+        timestamp,
+    };
+}
+/**
+ * Check if there are schema changes
+ */
+export async function hasPrismaSchemaChanges(options) {
+    const currentSchema = await generateSchemaSnapshot(options.schemaPath);
+    const { snapshotPath } = getSnapshotPaths(options.outputPath);
+    const previousSnapshot = await readSnapshot(snapshotPath);
+    const diff = diffSchemas(previousSnapshot?.schema ?? null, currentSchema);
+    return (diff.addedModels.length > 0 ||
+        diff.removedModels.length > 0 ||
+        diff.addedFields.length > 0 ||
+        diff.removedFields.length > 0 ||
+        diff.alteredFields.length > 0 ||
+        diff.addedUniqueConstraints.length > 0 ||
+        diff.removedUniqueConstraints.length > 0 ||
+        diff.addedIndexes.length > 0 ||
+        diff.removedIndexes.length > 0 ||
+        diff.addedForeignKeys.length > 0 ||
+        diff.removedForeignKeys.length > 0 ||
+        diff.primaryKeyChanges.length > 0);
+}

package/dist/migrations/prisma/diff.d.ts

@@ -0,0 +1,104 @@
+import type { KyselyDialect } from "../../sql/kysely-adapter.js";
+import type { SchemaSnapshot, SchemaTable, SchemaColumn } from "../../schema/snapshot.js";
+export declare function diffSchemas(previous: SchemaSnapshot | null, current: SchemaSnapshot): {
+    addedModels: SchemaTable[];
+    removedModels: SchemaTable[];
+    addedFields: {
+        tableName: string;
+        column: SchemaColumn;
+    }[];
+    removedFields: {
+        tableName: string;
+        column: SchemaColumn;
+    }[];
+    alteredFields: {
+        tableName: string;
+        columnName: string;
+        previous: SchemaColumn;
+        current: SchemaColumn;
+    }[];
+    addedUniqueConstraints: {
+        tableName: string;
+        constraint: {
+            name: string;
+            columns: string[];
+        };
+    }[];
+    removedUniqueConstraints: {
+        tableName: string;
+        constraint: {
+            name: string;
+            columns: string[];
+        };
+    }[];
+    addedIndexes: {
+        tableName: string;
+        index: {
+            name: string;
+            columns: string[];
+        };
+    }[];
+    removedIndexes: {
+        tableName: string;
+        index: {
+            name: string;
+            columns: string[];
+        };
+    }[];
+    addedForeignKeys: {
+        tableName: string;
+        foreignKey: {
+            name: string;
+            columns: string[];
+            referencedTable: string;
+            referencedColumns: string[];
+        };
+    }[];
+    removedForeignKeys: {
+        tableName: string;
+        foreignKey: {
+            name: string;
+            columns: string[];
+            referencedTable: string;
+            referencedColumns: string[];
+        };
+    }[];
+    primaryKeyChanges: {
+        tableName: string;
+        previous?: {
+            name: string;
+            columns: string[];
+        };
+        current?: {
+            name: string;
+            columns: string[];
+        };
+    }[];
+    renamedTables: Array<{
+        from: string;
+        to: string;
+    }>;
+    renamedColumns: Array<{
+        tableName: string;
+        from: string;
+        to: string;
+    }>;
+};
+type PrismaDiff = ReturnType<typeof diffSchemas>;
+export declare function applyRenameMappings(diff: PrismaDiff, renameTables?: Array<{
+    from: string;
+    to: string;
+}>, renameColumns?: Array<{
+    table: string;
+    from: string;
+    to: string;
+}>): PrismaDiff;
+/**
+ * Build SQL statements from diff
+ */
+export declare function buildSqlStatements(diff: ReturnType<typeof diffSchemas>, dialect: KyselyDialect): {
+    up: string[];
+    down: string[];
+};
+export {};
+//# sourceMappingURL=diff.d.ts.map

package/dist/migrations/prisma/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/migrations/prisma/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAyK1F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAAE,OAAO,EAAE,cAAc;;;;mBAsB5C,MAAM;gBAAU,YAAY;;;mBAC1B,MAAM;gBAAU,YAAY;;;mBAEvD,MAAM;oBACL,MAAM;kBACR,YAAY;iBACb,YAAY;;;mBAGV,MAAM;oBACL;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE;;;mBAGpC,MAAM;oBACL;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE;;;mBAGpC,MAAM;eACV;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE;;;mBAG/B,MAAM;eACV;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE;;;mBAG/B,MAAM;oBACL;YACV,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,eAAe,EAAE,MAAM,CAAC;YACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;SAC7B;;;mBAGU,MAAM;oBACL;YACV,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,eAAe,EAAE,MAAM,CAAC;YACxB,iBAAiB,EAAE,MAAM,EAAE,CAAC;SAC7B;;;mBAGU,MAAM;mBACN;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE;kBACpC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE;;mBAiCxB,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;oBAClC,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;EAE/E;AAED,KAAK,UAAU,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAkGjD,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,UAAU,EAChB,YAAY,GAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAM,EACtD,aAAa,GAAE,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAM,GACrE,UAAU,CA8FZ;AA2CD;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,EACpC,OAAO,EAAE,aAAa,GACrB;IAAE,EAAE,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAkNlC"}