zenstack-kit 0.1.4 → 0.1.5

package/README.md

@@ -124,6 +124,7 @@ Options:
 - `-m, --migrations <path>` - Migrations directory
 - `--baseline` - Create snapshot only, no migration
 - `--create-initial` - Create snapshot and initial migration
+- `-c, --config <path>` - Path to zenstack-kit config file
 
 ### `zenstack-kit migrate:generate`
 
@@ -138,6 +139,7 @@ Options:
 - `-s, --schema <path>` - Path to ZenStack schema
 - `-m, --migrations <path>` - Migrations directory
 - `--dialect <dialect>` - Database dialect (`sqlite`, `postgres`, `mysql`)
+- `-c, --config <path>` - Path to zenstack-kit config file
 
 ### `zenstack-kit migrate:apply`
 
@@ -153,6 +155,8 @@ Options:
 - `--url <url>` - Database connection URL (overrides config)
 - `--table <name>` - Migrations table name (default: `_prisma_migrations`)
 - `--db-schema <name>` - Database schema for migrations table (PostgreSQL only, default: `public`)
+- `--preview` - Preview pending migrations without applying
+- `-c, --config <path>` - Path to zenstack-kit config file
 
 ### `zenstack-kit pull`
 
@@ -166,6 +170,7 @@ Options:
 - `-o, --output <path>` - Output path for schema (default: `./schema.zmodel`)
 - `--dialect <dialect>` - Database dialect
 - `--url <url>` - Database connection URL
+- `-c, --config <path>` - Path to zenstack-kit config file
 
 Features:
 - Detects tables, columns, and types
@@ -289,6 +294,11 @@ const { db, destroy } = await createKyselyAdapter({
 await destroy();
 ```
 
+## Experimental
+
+The `introspectSchema` API is experimental and uses a simplified parser. Expect
+limitations with complex schemas.
+
 ## Prisma Compatibility
 
 zenstack-kit is designed to be compatible with Prisma's migration system:

package/dist/cli/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/cli/app.tsx"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAuSH,wBAAgB,MAAM,SAkBrB"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/cli/app.tsx"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AA0SH,wBAAgB,MAAM,SAkBrB"}

package/dist/cli/app.js

@@ -77,6 +77,9 @@ function parseArgs() {
         else if (arg === "--force" || arg === "-f") {
             options.force = true;
         }
+        else if (arg === "--config" || arg === "-c") {
+            options.config = args[++i];
+        }
     }
     return { command, options };
 }
@@ -98,7 +101,7 @@ function Status({ type, message }) {
 }
 // Help display component
 function HelpDisplay() {
-    return (_jsxs(Box, { flexDirection: "column", paddingY: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "zenstack-kit" }), _jsx(Text, { dimColor: true, children: "Database tooling for ZenStack schemas" }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Commands:" }), commands.filter(c => c.value !== "exit").map((cmd) => (_jsxs(Box, { marginLeft: 2, children: [_jsx(Box, { width: 20, children: _jsx(Text, { color: "yellow", children: cmd.label }) }), _jsx(Text, { dimColor: true, children: cmd.description })] }, cmd.value))), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Options:" }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "-s, --schema <path>     Path to ZenStack schema" }), _jsx(Text, { dimColor: true, children: "-m, --migrations <path>  Migrations directory" }), _jsx(Text, { dimColor: true, children: "-n, --name <name>        Migration name" }), _jsx(Text, { dimColor: true, children: "--dialect <dialect>      Database dialect (sqlite, postgres, mysql)" }), _jsx(Text, { dimColor: true, children: "--url <url>              Database connection URL" }), _jsx(Text, { dimColor: true, children: "--create-initial         Create initial migration (skip prompt)" }), _jsx(Text, { dimColor: true, children: "--baseline               Create baseline only (skip prompt)" }), _jsx(Text, { dimColor: true, children: "--preview                Preview pending migrations without applying" }), _jsx(Text, { dimColor: true, children: "-f, --force              Force operation without confirmation" })] })] }));
+    return (_jsxs(Box, { flexDirection: "column", paddingY: 1, children: [_jsx(Text, { bold: true, color: "cyan", children: "zenstack-kit" }), _jsx(Text, { dimColor: true, children: "Database tooling for ZenStack schemas" }), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Commands:" }), commands.filter(c => c.value !== "exit").map((cmd) => (_jsxs(Box, { marginLeft: 2, children: [_jsx(Box, { width: 20, children: _jsx(Text, { color: "yellow", children: cmd.label }) }), _jsx(Text, { dimColor: true, children: cmd.description })] }, cmd.value))), _jsx(Text, { children: " " }), _jsx(Text, { bold: true, children: "Options:" }), _jsxs(Box, { marginLeft: 2, flexDirection: "column", children: [_jsx(Text, { dimColor: true, children: "-s, --schema <path>     Path to ZenStack schema" }), _jsx(Text, { dimColor: true, children: "-m, --migrations <path>  Migrations directory" }), _jsx(Text, { dimColor: true, children: "-n, --name <name>        Migration name" }), _jsx(Text, { dimColor: true, children: "--dialect <dialect>      Database dialect (sqlite, postgres, mysql)" }), _jsx(Text, { dimColor: true, children: "--url <url>              Database connection URL" }), _jsx(Text, { dimColor: true, children: "--create-initial         Create initial migration (skip prompt)" }), _jsx(Text, { dimColor: true, children: "--baseline               Create baseline only (skip prompt)" }), _jsx(Text, { dimColor: true, children: "--preview                Preview pending migrations without applying" }), _jsx(Text, { dimColor: true, children: "-f, --force              Force operation without confirmation" }), _jsx(Text, { dimColor: true, children: "-c, --config <path>     Path to zenstack-kit config file" })] })] }));
 }
 function CliApp({ initialCommand, options }) {
     const { exit } = useApp();

package/dist/cli/commands.d.ts

@@ -20,6 +20,7 @@ export interface CommandOptions {
     createInitial?: boolean;
     preview?: boolean;
     force?: boolean;
+    config?: string;
 }
 export interface CommandContext {
     cwd: string;

package/dist/cli/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,MAAM,KAAK,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAE9F,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,cAAc,CAAC;IACxB,GAAG,EAAE,KAAK,CAAC;IACX,oBAAoB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,cAAc,CAAC,CAAC;IAC9D,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,GAAG,gBAAgB,CAAC,CAAC;IAC/D,iBAAiB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACxE,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACxF,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/D,sBAAsB,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACrF;AAED,qBAAa,YAAa,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC;IAChE,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;CAC1C,CAAC,CAkBD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,QAAQ,GAAG,UAAU,GAAG,OAAO,GACvC,MAAM,GAAG,SAAS,CAKpB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoF3E;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAsGxE;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA0FhE;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAkEhE"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands.js

@@ -19,8 +19,11 @@ export class CommandError extends Error {
  * Load and validate config, returning resolved paths
  */
 export async function resolveConfig(ctx) {
-    const loaded = await loadConfig(ctx.cwd);
+    const loaded = await loadConfig(ctx.cwd, ctx.options.config);
     if (!loaded) {
+        if (ctx.options.config) {
+            throw new CommandError(`Config file not found: ${ctx.options.config}`);
+        }
         throw new CommandError("No zenstack-kit config file found.");
     }
     const { config, configDir } = loaded;
@@ -121,6 +124,7 @@ export async function runMigrateGenerate(ctx) {
     }
     ctx.log("success", `Migration created: ${migration.folderName}/migration.sql`);
     ctx.log("info", `Path: ${migration.folderPath}`);
+    ctx.log("info", "Next: run 'zenstack-kit migrate apply' (or --preview to review SQL).");
 }
 /**
  * migrate:apply command
@@ -146,7 +150,7 @@ export async function runMigrateApply(ctx) {
     const databasePath = dialect === "sqlite" ? connectionUrl : undefined;
     // Preview mode - show pending migrations without applying
     if (ctx.options.preview) {
-        ctx.log("info", "Preview mode - showing pending migrations:");
+        ctx.log("info", "Preview mode - no changes will be applied.");
         const preview = await previewPrismaMigrations({
             migrationsFolder: outputPath,
             dialect,
@@ -162,8 +166,12 @@ export async function runMigrateApply(ctx) {
             }
             return;
         }
+        ctx.log("info", `Pending migrations: ${preview.pending.length}`);
+        if (preview.alreadyApplied.length > 0) {
+            ctx.log("info", `${preview.alreadyApplied.length} migration(s) already applied`);
+        }
         for (const migration of preview.pending) {
-            ctx.log("info", `Pending: ${migration.name}`);
+            ctx.log("info", `Migration: ${migration.name}`);
             ctx.log("info", `SQL:\n${migration.sql}`);
         }
         return;
@@ -335,6 +343,7 @@ export async function runPull(ctx) {
     });
     ctx.log("success", `Schema generated: ${result.outputPath}`);
     ctx.log("info", `${result.tableCount} table(s) introspected`);
+    ctx.log("info", "Next: review the schema, then run 'zenstack-kit init' to reset the snapshot.");
     // If we have existing migrations, warn about resetting
     if (snapshotExists || migrations.length > 0) {
         ctx.log("warning", "You should run 'zenstack-kit init' to reset the snapshot after reviewing the schema.");

package/dist/config/loader.d.ts

@@ -7,5 +7,5 @@ export interface LoadedConfig {
     configPath: string;
     configDir: string;
 }
-export declare function loadConfig(cwd: string): Promise<LoadedConfig | null>;
+export declare function loadConfig(cwd: string, configPath?: string): Promise<LoadedConfig | null>;
 //# sourceMappingURL=loader.d.ts.map

package/dist/config/loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAUpD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA4B1E"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/config/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAUpD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA+B/F"}

package/dist/config/loader.js

@@ -10,32 +10,34 @@ const CONFIG_FILES = [
     "zenstack-kit.config.mjs",
     "zenstack-kit.config.cjs",
 ];
-export async function loadConfig(cwd) {
-    const configPath = CONFIG_FILES.map((file) => path.join(cwd, file)).find((file) => fs.existsSync(file));
-    if (!configPath) {
+export async function loadConfig(cwd, configPath) {
+    const resolvedConfigPath = configPath ? path.resolve(cwd, configPath) : null;
+    const configPathToLoad = resolvedConfigPath ??
+        CONFIG_FILES.map((file) => path.join(cwd, file)).find((file) => fs.existsSync(file));
+    if (!configPathToLoad) {
         return null;
     }
-    const ext = path.extname(configPath);
+    const ext = path.extname(configPathToLoad);
     let config;
     if (ext === ".cjs") {
         const require = createRequire(import.meta.url);
-        const loaded = require(configPath);
+        const loaded = require(configPathToLoad);
         config = (loaded.default ?? loaded);
     }
     else if (ext === ".js" || ext === ".mjs") {
-        const loaded = await import(pathToFileUrl(configPath));
+        const loaded = await import(pathToFileUrl(configPathToLoad));
         config = (loaded.default ?? loaded);
     }
     else {
         const { default: jiti } = await import("jiti");
         const loader = jiti(import.meta.url, { interopDefault: true });
-        const loaded = loader(configPath);
+        const loaded = loader(configPathToLoad);
         config = (loaded.default ?? loaded);
     }
     return {
         config,
-        configPath,
-        configDir: path.dirname(configPath),
+        configPath: configPathToLoad,
+        configDir: path.dirname(configPathToLoad),
     };
 }
 function pathToFileUrl(filePath) {

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

@@ -0,0 +1,52 @@
+import type { KyselyDialect } from "../../sql/kysely-adapter.js";
+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[];
+}
+/**
+ * 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>;
+//# sourceMappingURL=apply.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply.d.ts","sourceRoot":"","sources":["../../../src/migrations/prisma/apply.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAIjE,MAAM,WAAW,4BAA4B;IAC3C,6BAA6B;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,8BAA8B;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,KAAK,CAAC;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5D,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,MAAM,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAClD,eAAe,CAAC,EAAE,uBAAuB,EAAE,CAAC;CAC7C;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,mBAAmB,CAAC;IAC5G,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,uBAAuB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,6BAA6B;IAC5C,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC9C,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AA2QD;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,2BAA2B,CAAC,CAuHtC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,6BAA6B,CAAC,CA0DxC"}

package/dist/migrations/prisma/apply.js

@@ -0,0 +1,382 @@
+import * as fs from "fs/promises";
+import * as path from "path";
+import * as crypto from "crypto";
+import { sql } from "kysely";
+import { createKyselyAdapter } from "../../sql/kysely-adapter.js";
+import { calculateChecksum, readMigrationLog } from "./log.js";
+/**
+ * Ensure _prisma_migrations table exists
+ */
+async function ensureMigrationsTable(db, tableName, schema, dialect) {
+    const fullTableName = schema && dialect === "postgres" ? `${schema}.${tableName}` : tableName;
+    if (dialect === "sqlite") {
+        await sql `
+      CREATE TABLE IF NOT EXISTS ${sql.raw(`"${tableName}"`)} (
+        id TEXT PRIMARY KEY,
+        checksum TEXT NOT NULL,
+        finished_at TEXT,
+        migration_name TEXT NOT NULL,
+        logs TEXT,
+        rolled_back_at TEXT,
+        started_at TEXT NOT NULL DEFAULT (datetime('now')),
+        applied_steps_count INTEGER NOT NULL DEFAULT 0
+      )
+    `.execute(db);
+    }
+    else if (dialect === "postgres") {
+        await sql `
+      CREATE TABLE IF NOT EXISTS ${sql.raw(`"${schema}"."${tableName}"`)} (
+        id VARCHAR(36) PRIMARY KEY,
+        checksum VARCHAR(64) NOT NULL,
+        finished_at TIMESTAMPTZ,
+        migration_name VARCHAR(255) NOT NULL,
+        logs TEXT,
+        rolled_back_at TIMESTAMPTZ,
+        started_at TIMESTAMPTZ NOT NULL DEFAULT now(),
+        applied_steps_count INTEGER NOT NULL DEFAULT 0
+      )
+    `.execute(db);
+    }
+    else {
+        await sql `
+      CREATE TABLE IF NOT EXISTS ${sql.raw(`\`${tableName}\``)} (
+        id VARCHAR(36) PRIMARY KEY,
+        checksum VARCHAR(64) NOT NULL,
+        finished_at DATETIME,
+        migration_name VARCHAR(255) NOT NULL,
+        logs TEXT,
+        rolled_back_at DATETIME,
+        started_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+        applied_steps_count INTEGER NOT NULL DEFAULT 0
+      )
+    `.execute(db);
+    }
+}
+/**
+ * Get list of applied migrations from _prisma_migrations table
+ */
+async function getAppliedMigrations(db, tableName, schema, dialect) {
+    let result;
+    if (dialect === "postgres" && schema) {
+        result = await sql `
+      SELECT * FROM ${sql.raw(`"${schema}"."${tableName}"`)}
+      WHERE rolled_back_at IS NULL AND finished_at IS NOT NULL
+    `.execute(db);
+    }
+    else if (dialect === "sqlite") {
+        result = await sql `
+      SELECT * FROM ${sql.raw(`"${tableName}"`)}
+      WHERE rolled_back_at IS NULL AND finished_at IS NOT NULL
+    `.execute(db);
+    }
+    else {
+        result = await sql `
+      SELECT * FROM ${sql.raw(`\`${tableName}\``)}
+      WHERE rolled_back_at IS NULL AND finished_at IS NOT NULL
+    `.execute(db);
+    }
+    return new Map(result.rows.map((row) => [row.migration_name, row]));
+}
+/**
+ * Record a migration in _prisma_migrations table
+ */
+async function recordMigration(db, tableName, schema, dialect, migrationName, checksum) {
+    const id = crypto.randomUUID();
+    if (dialect === "postgres" && schema) {
+        await sql `
+      INSERT INTO ${sql.raw(`"${schema}"."${tableName}"`)} (id, checksum, migration_name, finished_at, applied_steps_count)
+      VALUES (${id}, ${checksum}, ${migrationName}, now(), 1)
+    `.execute(db);
+    }
+    else if (dialect === "sqlite") {
+        await sql `
+      INSERT INTO ${sql.raw(`"${tableName}"`)} (id, checksum, migration_name, finished_at, applied_steps_count)
+      VALUES (${id}, ${checksum}, ${migrationName}, datetime('now'), 1)
+    `.execute(db);
+    }
+    else {
+        await sql `
+      INSERT INTO ${sql.raw(`\`${tableName}\``)} (id, checksum, migration_name, finished_at, applied_steps_count)
+      VALUES (${id}, ${checksum}, ${migrationName}, NOW(), 1)
+    `.execute(db);
+    }
+}
+/**
+ * Validate that the database's applied migrations are coherent with the migration log.
+ *
+ * Coherence rules:
+ * 1. Every migration applied in the DB must exist in the migration log
+ * 2. Applied migrations must be a prefix of the log (no gaps)
+ * 3. Checksums must match for applied migrations
+ */
+function validateMigrationCoherence(appliedMigrations, migrationLog, migrationFolders) {
+    const errors = [];
+    // Build a set of log migration names for quick lookup
+    const logMigrationNames = new Set(migrationLog.map((e) => e.name));
+    const folderNames = new Set(migrationFolders);
+    for (const entry of migrationLog) {
+        if (!folderNames.has(entry.name)) {
+            errors.push({
+                type: "missing_from_disk",
+                migrationName: entry.name,
+                details: `Migration "${entry.name}" exists in migration log but not on disk`,
+            });
+        }
+    }
+    // Check 1: Every applied migration must exist in the log
+    for (const [migrationName] of appliedMigrations) {
+        if (!logMigrationNames.has(migrationName)) {
+            errors.push({
+                type: "missing_from_log",
+                migrationName,
+                details: `Migration "${migrationName}" exists in database but not in migration log`,
+            });
+        }
+    }
+    // If there are migrations missing from the log, return early
+    // (other checks don't make sense if the log is incomplete)
+    if (errors.length > 0) {
+        return { isCoherent: false, errors };
+    }
+    // Check 2: Applied migrations should be a continuous prefix of the log
+    // i.e., if migration N is applied, all migrations before N in the log must also be applied
+    let lastAppliedIndex = -1;
+    for (let i = 0; i < migrationLog.length; i++) {
+        const logEntry = migrationLog[i];
+        const isApplied = appliedMigrations.has(logEntry.name);
+        if (isApplied) {
+            // Check for gaps: if this is applied, all previous should be applied
+            if (lastAppliedIndex !== i - 1) {
+                // There's a gap - find the missing migrations
+                for (let j = lastAppliedIndex + 1; j < i; j++) {
+                    const missing = migrationLog[j];
+                    errors.push({
+                        type: "order_mismatch",
+                        migrationName: missing.name,
+                        details: `Migration "${missing.name}" is in the log but not applied, yet later migration "${logEntry.name}" is applied`,
+                    });
+                }
+            }
+            lastAppliedIndex = i;
+            // Check 3: Checksum validation for applied migrations
+            const dbRow = appliedMigrations.get(logEntry.name);
+            if (dbRow.checksum !== logEntry.checksum) {
+                errors.push({
+                    type: "checksum_mismatch",
+                    migrationName: logEntry.name,
+                    details: `Checksum mismatch for "${logEntry.name}": database has ${dbRow.checksum.slice(0, 8)}..., log has ${logEntry.checksum.slice(0, 8)}...`,
+                });
+            }
+        }
+    }
+    return {
+        isCoherent: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Execute raw SQL using the database driver directly
+ * This bypasses Kysely for DDL statements which don't work reliably with sql.raw()
+ */
+async function executeRawSql(dialect, sqlContent, options) {
+    if (dialect === "sqlite") {
+        const { default: Database } = await import("better-sqlite3");
+        const sqliteDb = new Database(options.databasePath || ":memory:");
+        try {
+            // better-sqlite3's exec() handles multiple statements properly
+            sqliteDb.exec(sqlContent);
+        }
+        finally {
+            sqliteDb.close();
+        }
+    }
+    else if (dialect === "postgres") {
+        const { Pool } = await import("pg");
+        const pool = new Pool({ connectionString: options.connectionUrl });
+        const client = await pool.connect();
+        try {
+            // PostgreSQL supports transactional DDL, so wrap migration in a transaction
+            await client.query("BEGIN");
+            await client.query(sqlContent);
+            await client.query("COMMIT");
+        }
+        catch (error) {
+            await client.query("ROLLBACK");
+            throw error;
+        }
+        finally {
+            client.release();
+            await pool.end();
+        }
+    }
+    else if (dialect === "mysql") {
+        // Use mysql2 with promise wrapper
+        const mysql = await import("mysql2");
+        const pool = mysql.createPool({ uri: options.connectionUrl });
+        const promisePool = pool.promise();
+        try {
+            // MySQL needs statements executed one at a time
+            const statements = sqlContent
+                .split(/;(?:\s*\n|\s*$)/)
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0 && !s.startsWith("--"));
+            for (const statement of statements) {
+                await promisePool.query(statement);
+            }
+        }
+        finally {
+            await pool.promise().end();
+        }
+    }
+}
+/**
+ * Apply pending Prisma migrations
+ */
+export async function applyPrismaMigrations(options) {
+    const migrationsTable = options.migrationsTable ?? "_prisma_migrations";
+    const migrationsSchema = options.migrationsSchema ?? "public";
+    const { db, destroy } = await createKyselyAdapter({
+        dialect: options.dialect,
+        connectionUrl: options.connectionUrl,
+        databasePath: options.databasePath,
+    });
+    try {
+        // Ensure migrations table exists
+        await ensureMigrationsTable(db, migrationsTable, migrationsSchema, options.dialect);
+        // Get already applied migrations
+        const appliedMigrations = await getAppliedMigrations(db, migrationsTable, migrationsSchema, options.dialect);
+        // Read migration folders
+        const entries = await fs.readdir(options.migrationsFolder, { withFileTypes: true });
+        const migrationFolders = entries
+            .filter((e) => e.isDirectory() && /^\d{14}_/.test(e.name))
+            .map((e) => e.name)
+            .sort();
+        const migrationFoldersWithSql = [];
+        for (const folderName of migrationFolders) {
+            const sqlPath = path.join(options.migrationsFolder, folderName, "migration.sql");
+            try {
+                await fs.access(sqlPath);
+                migrationFoldersWithSql.push(folderName);
+            }
+            catch {
+                // Missing migration.sql; coherence check will flag if it's in the log
+            }
+        }
+        // Read migration log and validate coherence
+        const migrationLog = await readMigrationLog(options.migrationsFolder);
+        const coherence = validateMigrationCoherence(appliedMigrations, migrationLog, migrationFoldersWithSql);
+        if (!coherence.isCoherent) {
+            return {
+                applied: [],
+                alreadyApplied: [],
+                coherenceErrors: coherence.errors,
+            };
+        }
+        const result = {
+            applied: [],
+            alreadyApplied: [],
+        };
+        for (const folderName of migrationFoldersWithSql) {
+            if (appliedMigrations.has(folderName)) {
+                result.alreadyApplied.push(folderName);
+                continue;
+            }
+            const sqlPath = path.join(options.migrationsFolder, folderName, "migration.sql");
+            let sqlContent;
+            try {
+                sqlContent = await fs.readFile(sqlPath, "utf-8");
+            }
+            catch {
+                continue; // Skip if no migration.sql
+            }
+            const checksum = calculateChecksum(sqlContent);
+            // Verify checksum against migration log (migrationLog already read above)
+            const logEntry = migrationLog.find((m) => m.name === folderName);
+            if (logEntry && logEntry.checksum !== checksum) {
+                result.failed = {
+                    migrationName: folderName,
+                    error: `Checksum mismatch for migration ${folderName}.\n` +
+                        `Expected: ${logEntry.checksum}\n` +
+                        `Found: ${checksum}\n` +
+                        `The migration file may have been modified after generation.`,
+                };
+                break;
+            }
+            const startTime = Date.now();
+            try {
+                // Execute the migration SQL using direct driver access
+                await executeRawSql(options.dialect, sqlContent, {
+                    connectionUrl: options.connectionUrl,
+                    databasePath: options.databasePath,
+                });
+                // Record the migration (still use Kysely for this since it's simple INSERT)
+                await recordMigration(db, migrationsTable, migrationsSchema, options.dialect, folderName, checksum);
+                result.applied.push({
+                    migrationName: folderName,
+                    duration: Date.now() - startTime,
+                });
+            }
+            catch (error) {
+                result.failed = {
+                    migrationName: folderName,
+                    error: error instanceof Error ? error.message : String(error),
+                };
+                break; // Stop on first failure
+            }
+        }
+        return result;
+    }
+    finally {
+        await destroy();
+    }
+}
+/**
+ * Preview pending migrations without applying them
+ */
+export async function previewPrismaMigrations(options) {
+    const migrationsTable = options.migrationsTable ?? "_prisma_migrations";
+    const migrationsSchema = options.migrationsSchema ?? "public";
+    const { db, destroy } = await createKyselyAdapter({
+        dialect: options.dialect,
+        connectionUrl: options.connectionUrl,
+        databasePath: options.databasePath,
+    });
+    try {
+        // Ensure migrations table exists
+        await ensureMigrationsTable(db, migrationsTable, migrationsSchema, options.dialect);
+        // Get already applied migrations
+        const appliedMigrations = await getAppliedMigrations(db, migrationsTable, migrationsSchema, options.dialect);
+        // Read migration folders
+        const entries = await fs.readdir(options.migrationsFolder, { withFileTypes: true });
+        const migrationFolders = entries
+            .filter((e) => e.isDirectory() && /^\d{14}_/.test(e.name))
+            .map((e) => e.name)
+            .sort();
+        const result = {
+            pending: [],
+            alreadyApplied: [],
+        };
+        for (const folderName of migrationFolders) {
+            if (appliedMigrations.has(folderName)) {
+                result.alreadyApplied.push(folderName);
+                continue;
+            }
+            const sqlPath = path.join(options.migrationsFolder, folderName, "migration.sql");
+            let sqlContent;
+            try {
+                sqlContent = await fs.readFile(sqlPath, "utf-8");
+            }
+            catch {
+                continue; // Skip if no migration.sql
+            }
+            result.pending.push({
+                name: folderName,
+                sql: sqlContent,
+            });
+        }
+        return result;
+    }
+    finally {
+        await destroy();
+    }
+}