zenstack-kit 0.1.4 → 0.1.7

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

@@ -0,0 +1,32 @@
+import type { SchemaSnapshot } from "../../schema/snapshot.js";
+import { type SchemaSnapshotFile } from "../../schema/snapshot.js";
+/**
+ * Get paths for snapshot file
+ */
+export declare function getSnapshotPaths(outputPath: string): {
+    metaDir: string;
+    snapshotPath: string;
+};
+/**
+ * Read existing snapshot
+ */
+export declare function readSnapshot(snapshotPath: string): Promise<SchemaSnapshotFile | null>;
+/**
+ * Write snapshot to file
+ */
+export declare function writeSnapshot(snapshotPath: string, schema: SchemaSnapshot): Promise<void>;
+/**
+ * Check if snapshot exists
+ */
+export declare function hasSnapshot(outputPath: string): Promise<boolean>;
+/**
+ * Initialize snapshot from schema without generating migration
+ */
+export declare function initializeSnapshot(options: {
+    schemaPath: string;
+    outputPath: string;
+}): Promise<{
+    snapshotPath: string;
+    tableCount: number;
+}>;
+//# sourceMappingURL=snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../../src/migrations/prisma/snapshot.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAkB,KAAK,kBAAkB,EAA0B,MAAM,0BAA0B,CAAC;AAE3G;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM;;;EAMlD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAc3F;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/F;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQtE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAUxD"}

package/dist/migrations/prisma/snapshot.js

@@ -0,0 +1,65 @@
+import * as fs from "fs/promises";
+import * as path from "path";
+import { createSnapshot, generateSchemaSnapshot } from "../../schema/snapshot.js";
+/**
+ * Get paths for snapshot file
+ */
+export function getSnapshotPaths(outputPath) {
+    const metaDir = path.join(outputPath, "meta");
+    return {
+        metaDir,
+        snapshotPath: path.join(metaDir, "_snapshot.json"),
+    };
+}
+/**
+ * Read existing snapshot
+ */
+export async function readSnapshot(snapshotPath) {
+    try {
+        const content = await fs.readFile(snapshotPath, "utf-8");
+        const snapshot = JSON.parse(content);
+        if (!snapshot || snapshot.version !== 2 || !snapshot.schema) {
+            throw new Error("Snapshot format is invalid");
+        }
+        return snapshot;
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT") {
+            return null;
+        }
+        throw error;
+    }
+}
+/**
+ * Write snapshot to file
+ */
+export async function writeSnapshot(snapshotPath, schema) {
+    const snapshot = createSnapshot(schema);
+    await fs.mkdir(path.dirname(snapshotPath), { recursive: true });
+    await fs.writeFile(snapshotPath, JSON.stringify(snapshot, null, 2), "utf-8");
+}
+/**
+ * Check if snapshot exists
+ */
+export async function hasSnapshot(outputPath) {
+    const { snapshotPath } = getSnapshotPaths(outputPath);
+    try {
+        await fs.access(snapshotPath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Initialize snapshot from schema without generating migration
+ */
+export async function initializeSnapshot(options) {
+    const currentSchema = await generateSchemaSnapshot(options.schemaPath);
+    const { snapshotPath } = getSnapshotPaths(options.outputPath);
+    await writeSnapshot(snapshotPath, currentSchema);
+    return {
+        snapshotPath,
+        tableCount: currentSchema.tables.length,
+    };
+}

package/dist/migrations/prisma.d.ts

@@ -1,203 +1,6 @@
-/**
- * Prisma-compatible migrations
- *
- * Generates migrations in Prisma format:
- * - Folder structure: migrations/<timestamp>_<name>/migration.sql
- * - Tracks migrations in _prisma_migrations table
- * - Compatible with `prisma migrate deploy`
- */
-import type { KyselyDialect } from "../sql/kysely-adapter.js";
-import type { SchemaSnapshot } from "../schema/snapshot.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 ApplyPrismaMigrationsOptions {
-    /** Migrations folder path */
-    migrationsFolder: string;
-    /** Database dialect */
-    dialect: KyselyDialect;
-    /** Database connection URL */
-    connectionUrl?: string;
-    /** SQLite database path */
-    databasePath?: string;
-    /** Migrations table name (default: _prisma_migrations) */
-    migrationsTable?: string;
-    /** Migrations schema (PostgreSQL only, default: public) */
-    migrationsSchema?: string;
-}
-export interface ApplyPrismaMigrationsResult {
-    applied: Array<{
-        migrationName: string;
-        duration: number;
-    }>;
-    alreadyApplied: string[];
-    failed?: {
-        migrationName: string;
-        error: string;
-    };
-    coherenceErrors?: MigrationCoherenceError[];
-}
-export interface MigrationCoherenceError {
-    type: "missing_from_log" | "missing_from_db" | "missing_from_disk" | "order_mismatch" | "checksum_mismatch";
-    migrationName: string;
-    details: string;
-}
-export interface MigrationCoherenceResult {
-    isCoherent: boolean;
-    errors: MigrationCoherenceError[];
-}
-export interface PreviewPrismaMigrationsResult {
-    pending: Array<{
-        name: string;
-        sql: string;
-    }>;
-    alreadyApplied: string[];
-}
-/**
- * Generate timestamp string for migration folder name
- */
-export declare function generateTimestamp(): string;
-/**
- * Get paths for snapshot file
- */
-declare function getSnapshotPaths(outputPath: string): {
-    metaDir: string;
-    snapshotPath: string;
-};
-/**
- * Write snapshot to file
- */
-export declare function writeSnapshot(snapshotPath: string, schema: SchemaSnapshot): Promise<void>;
-/**
- * Create a Prisma-compatible migration
- */
-export declare function createPrismaMigration(options: PrismaMigrationOptions): Promise<PrismaMigration | null>;
-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;
-}
-/**
- * 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>;
-/**
- * Calculate SHA256 checksum of migration SQL
- */
-export declare function calculateChecksum(sql: string): string;
-/**
- * Apply pending Prisma migrations
- */
-export declare function applyPrismaMigrations(options: ApplyPrismaMigrationsOptions): Promise<ApplyPrismaMigrationsResult>;
-/**
- * Preview pending migrations without applying them
- */
-export declare function previewPrismaMigrations(options: ApplyPrismaMigrationsOptions): Promise<PreviewPrismaMigrationsResult>;
-/**
- * Check if there are schema changes
- */
-export declare function hasPrismaSchemaChanges(options: {
-    schemaPath: string;
-    outputPath: string;
-}): Promise<boolean>;
-export interface PotentialTableRename {
-    from: string;
-    to: string;
-}
-export interface PotentialColumnRename {
-    table: string;
-    from: string;
-    to: string;
-}
-export interface PotentialRenames {
-    tables: PotentialTableRename[];
-    columns: PotentialColumnRename[];
-}
-/**
- * Detect potential renames by finding removed+added pairs.
- * A table rename is detected when one table is removed and one is added.
- * A column rename is detected when within the same table, one column is removed and one is added.
- */
-export declare function detectPotentialRenames(options: {
-    schemaPath: string;
-    outputPath: string;
-}): Promise<PotentialRenames>;
-export interface MigrationLogEntry {
-    /** Migration folder name e.g. "20260108120000_init" */
-    name: string;
-    /** SHA256 checksum of migration.sql content (64 hex chars) */
-    checksum: string;
-}
-/**
- * Get the path to the migration log file
- */
-export declare function getMigrationLogPath(outputPath: string): string;
-/**
- * Read migration log file
- */
-export declare function readMigrationLog(outputPath: string): Promise<MigrationLogEntry[]>;
-/**
- * Write migration log file
- */
-export declare function writeMigrationLog(outputPath: string, entries: MigrationLogEntry[]): Promise<void>;
-/**
- * Append a single entry to the migration log
- */
-export declare function appendToMigrationLog(outputPath: string, entry: MigrationLogEntry): Promise<void>;
-/**
- * Scan migration folders and compute checksums for each
- */
-export declare function scanMigrationFolders(outputPath: string): Promise<MigrationLogEntry[]>;
-/**
- * Check if snapshot exists
- */
-export declare function hasSnapshot(outputPath: string): Promise<boolean>;
-/**
- * Initialize snapshot from schema without generating migration
- */
-export declare function initializeSnapshot(options: {
-    schemaPath: string;
-    outputPath: string;
-}): Promise<{
-    snapshotPath: string;
-    tableCount: number;
-}>;
-/**
- * Export getSnapshotPaths for external use
- */
-export { getSnapshotPaths };
+export { createPrismaMigration, createInitialMigration, hasPrismaSchemaChanges, type PrismaMigrationOptions, type PrismaMigration, type CreateInitialMigrationOptions, } from "./prisma/create.js";
+export { applyPrismaMigrations, previewPrismaMigrations, type ApplyPrismaMigrationsOptions, type ApplyPrismaMigrationsResult, type PreviewPrismaMigrationsResult, type MigrationCoherenceError, type MigrationCoherenceResult, } from "./prisma/apply.js";
+export { readMigrationLog, writeMigrationLog, appendToMigrationLog, scanMigrationFolders, getMigrationLogPath, calculateChecksum, type MigrationLogEntry, } from "./prisma/log.js";
+export { initializeSnapshot, hasSnapshot, getSnapshotPaths, writeSnapshot, } from "./prisma/snapshot.js";
+export { detectPotentialRenames, type PotentialTableRename, type PotentialColumnRename, type PotentialRenames, } from "./prisma/rename.js";
 //# sourceMappingURL=prisma.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/migrations/prisma.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prisma.d.ts","sourceRoot":"","sources":["../../src/migrations/prisma.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,eAAe,EACpB,KAAK,6BAA6B,GACnC,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,2BAA2B,EAChC,KAAK,6BAA6B,EAClC,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,GAC9B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,iBAAiB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,aAAa,GACd,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,sBAAsB,EACtB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAC"}