zenstack-kit 0.1.4 → 0.1.7

package/README.md

@@ -79,7 +79,7 @@ The `init` command offers two options:
 ### 4. Generate migrations
 
 ```bash
-zenstack-kit migrate:generate --name add_posts
+zenstack-kit migrate create --name add_posts
 ```
 
 This creates a migration in Prisma format:
@@ -95,7 +95,7 @@ prisma/migrations/
 ### 5. Apply migrations
 
 ```bash
-zenstack-kit migrate:apply
+zenstack-kit migrate apply
 ```
 
 Migrations are tracked in the `_prisma_migrations` table, making them compatible with `prisma migrate deploy`.
@@ -124,13 +124,14 @@ 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`
+### `zenstack-kit migrate create`
 
 Generate a new SQL migration from schema changes.
 
 ```bash
-zenstack-kit migrate:generate --name add_users
+zenstack-kit migrate create --name add_users
 ```
 
 Options:
@@ -138,13 +139,14 @@ 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`
+### `zenstack-kit migrate apply`
 
 Apply pending migrations to the database.
 
 ```bash
-zenstack-kit migrate:apply
+zenstack-kit migrate apply
 ```
 
 Options:
@@ -153,6 +155,9 @@ 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
+- `--mark-applied` - Mark pending migrations as applied without running SQL
+- `-c, --config <path>` - Path to zenstack-kit config file
 
 ### `zenstack-kit pull`
 
@@ -166,6 +171,8 @@ Options:
 - `-o, --output <path>` - Output path for schema (default: `./schema.zmodel`)
 - `--dialect <dialect>` - Database dialect
 - `--url <url>` - Database connection URL
+- `--preview` - Preview generated schema and diff without writing files
+- `-c, --config <path>` - Path to zenstack-kit config file
 
 Features:
 - Detects tables, columns, and types
@@ -289,6 +296,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;AA6SH,wBAAgB,MAAM,SAkBrB"}

package/dist/cli/app.js

@@ -74,9 +74,15 @@ function parseArgs() {
         else if (arg === "--preview") {
             options.preview = true;
         }
+        else if (arg === "--mark-applied") {
+            options.markApplied = true;
+        }
         else if (arg === "--force" || arg === "-f") {
             options.force = true;
         }
+        else if (arg === "--config" || arg === "-c") {
+            options.config = args[++i];
+        }
     }
     return { command, options };
 }
@@ -98,7 +104,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: "--mark-applied           Mark pending migrations as applied without running SQL" }), _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

@@ -19,7 +19,9 @@ export interface CommandOptions {
     baseline?: boolean;
     createInitial?: boolean;
     preview?: boolean;
+    markApplied?: 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":"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"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/cli/commands.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands.js

@@ -6,6 +6,8 @@
  */
 import * as fs from "fs";
 import * as path from "path";
+import * as os from "os";
+import { execFileSync } from "child_process";
 import { loadConfig } from "../config/loader.js";
 import { pullSchema } from "../schema/pull.js";
 import { createPrismaMigration, applyPrismaMigrations, previewPrismaMigrations, hasPrismaSchemaChanges, hasSnapshot, scanMigrationFolders, writeMigrationLog, initializeSnapshot, createInitialMigration, detectPotentialRenames, } from "../migrations/prisma.js";
@@ -19,8 +21,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 +126,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
@@ -144,9 +150,12 @@ export async function runMigrateApply(ctx) {
         throw new CommandError("Database connection URL is required for non-sqlite dialects.");
     }
     const databasePath = dialect === "sqlite" ? connectionUrl : undefined;
+    if (ctx.options.preview && ctx.options.markApplied) {
+        throw new CommandError("Cannot use --preview and --mark-applied together.");
+    }
     // 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,13 +171,26 @@ 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", `SQL:\n${migration.sql}`);
+            const statementCount = migration.sql
+                .split(/;(?:\s*\n|\s*$)/)
+                .map((s) => s.trim())
+                .filter((s) => s.length > 0 && !s.startsWith("--")).length;
+            ctx.log("info", `Migration: ${migration.name} (${statementCount} statement${statementCount === 1 ? "" : "s"})`);
         }
+        ctx.log("info", "Use the migration.sql files to review full SQL.");
         return;
     }
-    ctx.log("info", "Applying migrations...");
+    if (ctx.options.markApplied) {
+        ctx.log("info", "Marking migrations as applied (no SQL will be executed)...");
+    }
+    else {
+        ctx.log("info", "Applying migrations...");
+    }
     const result = await applyPrismaMigrations({
         migrationsFolder: outputPath,
         dialect,
@@ -176,6 +198,7 @@ export async function runMigrateApply(ctx) {
         databasePath,
         migrationsTable,
         migrationsSchema,
+        markApplied: ctx.options.markApplied,
     });
     // Handle coherence errors
     if (result.coherenceErrors && result.coherenceErrors.length > 0) {
@@ -202,7 +225,8 @@ export async function runMigrateApply(ctx) {
         return;
     }
     for (const item of result.applied) {
-        ctx.log("success", `Applied: ${item.migrationName} (${item.duration}ms)`);
+        const action = ctx.options.markApplied ? "Marked applied" : "Applied";
+        ctx.log("success", `${action}: ${item.migrationName} (${item.duration}ms)`);
     }
     if (result.failed) {
         throw new CommandError(`Migration failed: ${result.failed.migrationName} - ${result.failed.error}`);
@@ -326,6 +350,42 @@ export async function runPull(ctx) {
             return;
         }
     }
+    if (ctx.options.preview) {
+        ctx.log("info", "Preview mode - no files will be written.");
+        const result = await pullSchema({
+            dialect,
+            connectionUrl,
+            databasePath,
+            outputPath: schemaOutputPath,
+            writeFile: false,
+        });
+        if (fs.existsSync(schemaOutputPath)) {
+            const diffOutput = await buildSchemaDiff(schemaOutputPath, result.schema);
+            if (diffOutput) {
+                const { text, truncated } = truncateLines(diffOutput, 200);
+                ctx.log("info", `Diff (existing -> generated):\n${text}`);
+                if (truncated) {
+                    ctx.log("info", "Diff truncated. Use --output to write and inspect the full schema.");
+                }
+            }
+            else {
+                ctx.log("info", "Diff unavailable; showing generated schema preview.");
+                const { text, truncated } = truncateLines(result.schema, 200);
+                ctx.log("info", `Generated schema:\n${text}`);
+                if (truncated) {
+                    ctx.log("info", "Preview truncated. Use --output to write and inspect the full schema.");
+                }
+            }
+        }
+        else {
+            const { text, truncated } = truncateLines(result.schema, 200);
+            ctx.log("info", `Generated schema:\n${text}`);
+            if (truncated) {
+                ctx.log("info", "Preview truncated. Use --output to write and inspect the full schema.");
+            }
+        }
+        return;
+    }
     ctx.log("info", "Pulling schema from database...");
     const result = await pullSchema({
         dialect,
@@ -335,8 +395,39 @@ 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.");
     }
 }
+async function buildSchemaDiff(existingPath, nextSchema) {
+    const tempDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "zenstack-kit-pull-"));
+    const nextPath = path.join(tempDir, "schema.zmodel");
+    try {
+        await fs.promises.writeFile(nextPath, nextSchema, "utf-8");
+        try {
+            return execFileSync("git", ["diff", "--no-index", "--no-color", "--", existingPath, nextPath], { encoding: "utf-8" });
+        }
+        catch (error) {
+            const stdout = error.stdout;
+            if (stdout) {
+                return stdout.toString();
+            }
+            return null;
+        }
+    }
+    finally {
+        await fs.promises.rm(tempDir, { recursive: true, force: true });
+    }
+}
+function truncateLines(text, maxLines) {
+    const lines = text.split("\n");
+    if (lines.length <= maxLines) {
+        return { text, truncated: false };
+    }
+    return {
+        text: lines.slice(0, maxLines).join("\n"),
+        truncated: true,
+    };
+}

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

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/cli/prompts.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,gBAAgB,CAAC;AACjF,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,CAAC;AAsCzC;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,CAyBhE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAyB3D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BjF;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,eAAe,CAAC;AA2CtD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,GAAE,MAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAc5F;AAED,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkCnG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyBvF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,YAAY,CAAC,CAyBvB"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/cli/prompts.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,cAAc,GAAG,UAAU,GAAG,gBAAgB,CAAC;AACjF,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,IAAI,CAAC;AAsCzC;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,UAAU,CAAC,CAyBhE;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,UAAU,CAAC,CAyB3D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CA+BjF;AAED,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,eAAe,CAAC;AAyCtD;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,GAAE,MAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAc5F;AAED,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEzD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAkCnG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAyBvF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,YAAY,CAAC,CAyBvB"}

package/dist/cli/prompts.js

@@ -3,7 +3,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * Interactive prompts for the init command using ink
  */
 import React, { useState } from "react";
-import { render, Box, Text } from "ink";
+import { render, Box, Text, useInput } from "ink";
 import SelectInput from "ink-select-input";
 function SelectPrompt({ message, items, onSelect }) {
     const [selectedIndex, setSelectedIndex] = useState(0);
@@ -101,8 +101,6 @@ function TextInputPrompt({ message, placeholder, onSubmit, }) {
             setValue((prev) => prev + input);
         }
     };
-    // Use ink's useInput hook
-    const { useInput } = require("ink");
     useInput(handleInput);
     return (_jsx(Box, { flexDirection: "column", children: _jsxs(Box, { children: [_jsx(Text, { color: "cyan", children: "? " }), _jsxs(Text, { children: [message, " "] }), _jsxs(Text, { dimColor: true, children: ["(", placeholder, "): "] }), _jsx(Text, { children: value }), _jsx(Text, { color: "gray", children: "\u2588" })] }) }));
 }

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,54 @@
+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;
+    /** Mark migrations as applied without executing SQL */
+    markApplied?: boolean;
+}
+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;IAC1B,uDAAuD;IACvD,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;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,CAyHtC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,6BAA6B,CAAC,CA0DxC"}