zenstack-kit 0.1.1

package/dist/migrations/prisma.d.ts

@@ -0,0 +1,193 @@
+/**
+ * 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;
+    };
+}
+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 };
+//# sourceMappingURL=prisma.d.ts.map

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

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