@kysera/migrations 0.7.3 → 0.8.0

package/README.md

@@ -9,6 +9,7 @@
 ## Features
 
 ### Core Migration Management
+
 - **Simple API** - Intuitive migration creation and execution
 - **Type-safe** - Full TypeScript support with Kysely integration
 - **State tracking** - Automatic migration history in database
@@ -16,6 +17,7 @@
 - **Dry run mode** - Preview changes before execution
 
 ### Advanced Features
+
 - **Rollback support** - Roll back one or multiple migrations
 - **Partial migration** - Run up to specific migration
 - **Status reporting** - View executed and pending migrations
@@ -24,12 +26,14 @@
 - **Duplicate detection** - Validates unique migration names
 
 ### Developer Experience (v0.5.0+)
+
 - **`defineMigrations()`** - Object-based migration definition
 - **`runMigrations()`** - One-liner to run pending migrations
 - **`rollbackMigrations()`** - One-liner for rollbacks
 - **Migration metadata** - Description, breaking flag, tags, timing
 
 ### Plugin System (v0.5.0+)
+
 - **Plugin hooks** - Before/after migration events
 - **Built-in plugins** - Logging and metrics plugins
 - **Extensible** - Create custom plugins for your needs
@@ -38,18 +42,20 @@
 
 ```bash
 # pnpm (recommended)
-pnpm add @kysera/migrations kysely
+pnpm add @kysera/migrations kysely zod
 
 # npm
-npm install @kysera/migrations kysely
+npm install @kysera/migrations kysely zod
 
 # yarn
-yarn add @kysera/migrations kysely
+yarn add @kysera/migrations kysely zod
 
 # bun
-bun add @kysera/migrations kysely
+bun add @kysera/migrations kysely zod
 ```
 
+**Note:** Zod is a **required peer dependency** (not optional) for schema validation in the migration system.
+
 ## Quick Start
 
 ### Basic Usage
@@ -62,7 +68,7 @@ import { createMigrationRunner, createMigration } from '@kysera/migrations'
 const migrations = [
   createMigration(
     '001_create_users',
-    async (db) => {
+    async db => {
       await db.schema
         .createTable('users')
         .addColumn('id', 'serial', col => col.primaryKey())
@@ -70,14 +76,14 @@ const migrations = [
         .addColumn('name', 'varchar(255)', col => col.notNull())
         .execute()
     },
-    async (db) => {
+    async db => {
       await db.schema.dropTable('users').execute()
     }
   ),
 
   createMigration(
     '002_create_posts',
-    async (db) => {
+    async db => {
       await db.schema
         .createTable('posts')
         .addColumn('id', 'serial', col => col.primaryKey())
@@ -87,14 +93,16 @@ const migrations = [
         .addColumn('title', 'varchar(255)', col => col.notNull())
         .execute()
     },
-    async (db) => {
+    async db => {
       await db.schema.dropTable('posts').execute()
     }
   )
 ]
 
 // Create migration runner
-const db = new Kysely<Database>({ /* ... */ })
+const db = new Kysely<Database>({
+  /* ... */
+})
 const runner = createMigrationRunner(db, migrations)
 
 // Run all pending migrations
@@ -117,30 +125,30 @@ import { defineMigrations, runMigrations } from '@kysera/migrations'
 const migrations = defineMigrations({
   '001_create_users': {
     description: 'Create users table with email and name',
-    up: async (db) => {
+    up: async db => {
       await db.schema
         .createTable('users')
         .addColumn('id', 'serial', col => col.primaryKey())
         .addColumn('email', 'varchar(255)', col => col.notNull().unique())
         .execute()
     },
-    down: async (db) => {
+    down: async db => {
       await db.schema.dropTable('users').execute()
-    },
+    }
   },
 
   '002_create_posts': {
     description: 'Create posts table',
     breaking: false,
     tags: ['schema'],
-    up: async (db) => {
+    up: async db => {
       await db.schema
         .createTable('posts')
         .addColumn('id', 'serial', col => col.primaryKey())
         .addColumn('title', 'varchar(255)', col => col.notNull())
         .execute()
-    },
-  },
+    }
+  }
 })
 
 // One-liner to run all migrations
@@ -178,10 +186,10 @@ interface Migration {
 
 ```typescript
 interface MigrationWithMeta extends Migration {
-  description?: string      // Shown in logs
-  breaking?: boolean        // Shows warning
+  description?: string // Shown in logs
+  breaking?: boolean // Shows warning
   estimatedDuration?: number // In milliseconds
-  tags?: string[]           // For categorization
+  tags?: string[] // For categorization
 }
 ```
 
@@ -199,11 +207,11 @@ interface MigrationStatus {
 
 ```typescript
 interface MigrationResult {
-  executed: string[]   // Successfully executed
-  skipped: string[]    // Already executed or no down()
-  failed: string[]     // Failed migrations
-  duration: number     // Total time in ms
-  dryRun: boolean      // Whether dry run mode
+  executed: string[] // Successfully executed
+  skipped: string[] // Already executed or no down()
+  failed: string[] // Failed migrations
+  duration: number // Total time in ms
+  dryRun: boolean // Whether dry run mode
 }
 ```
 
@@ -211,11 +219,11 @@ interface MigrationResult {
 
 ```typescript
 interface MigrationRunnerOptions {
-  dryRun?: boolean          // Preview only (default: false)
-  logger?: KyseraLogger     // Logger instance from @kysera/core (default: silentLogger)
+  dryRun?: boolean // Preview only (default: false)
+  logger?: KyseraLogger // Logger instance from @kysera/core (default: silentLogger)
   useTransactions?: boolean // Wrap in transactions (default: false)
-  stopOnError?: boolean     // Stop on first error (default: true)
-  verbose?: boolean         // Show metadata (default: true)
+  stopOnError?: boolean // Stop on first error (default: true)
+  verbose?: boolean // Show metadata (default: true)
 }
 ```
 
@@ -249,7 +257,10 @@ interface MigrationRunnerWithPluginsOptions extends MigrationRunnerOptions {
 #### `MigrationErrorCode`
 
 ```typescript
-type MigrationErrorCode = 'MIGRATION_UP_FAILED' | 'MIGRATION_DOWN_FAILED' | 'MIGRATION_VALIDATION_FAILED'
+type MigrationErrorCode =
+  | 'MIGRATION_UP_FAILED'
+  | 'MIGRATION_DOWN_FAILED'
+  | 'MIGRATION_VALIDATION_FAILED'
 ```
 
 ### Factory Functions
@@ -261,8 +272,12 @@ Create a simple migration:
 ```typescript
 const migration = createMigration(
   '001_create_users',
-  async (db) => { /* up */ },
-  async (db) => { /* down */ }
+  async db => {
+    /* up */
+  },
+  async db => {
+    /* down */
+  }
 )
 ```
 
@@ -276,8 +291,12 @@ const migration = createMigrationWithMeta('001_create_users', {
   breaking: true,
   tags: ['schema', 'users'],
   estimatedDuration: 5000,
-  up: async (db) => { /* ... */ },
-  down: async (db) => { /* ... */ },
+  up: async db => {
+    /* ... */
+  },
+  down: async db => {
+    /* ... */
+  }
 })
 ```
 
@@ -289,7 +308,7 @@ Create a MigrationRunner instance:
 const runner = createMigrationRunner(db, migrations, {
   dryRun: false,
   logger: console.log,
-  useTransactions: true,
+  useTransactions: true
 })
 ```
 
@@ -300,7 +319,7 @@ Create a MigrationRunner with plugin support (async factory):
 ```typescript
 const runner = await createMigrationRunnerWithPlugins(db, migrations, {
   plugins: [createLoggingPlugin(), createMetricsPlugin()],
-  useTransactions: true,
+  useTransactions: true
 })
 
 // Runner is ready with plugins initialized via onInit
@@ -317,9 +336,13 @@ Define migrations using object syntax:
 const migrations = defineMigrations({
   '001_users': {
     description: 'Create users',
-    up: async (db) => { /* ... */ },
-    down: async (db) => { /* ... */ },
-  },
+    up: async db => {
+      /* ... */
+    },
+    down: async db => {
+      /* ... */
+    }
+  }
 })
 ```
 
@@ -337,8 +360,8 @@ const result = await runMigrations(db, migrations, { dryRun: true })
 Rollback migrations:
 
 ```typescript
-await rollbackMigrations(db, migrations)        // Last 1
-await rollbackMigrations(db, migrations, 3)     // Last 3
+await rollbackMigrations(db, migrations) // Last 1
+await rollbackMigrations(db, migrations, 3) // Last 3
 await rollbackMigrations(db, migrations, 1, { dryRun: true })
 ```
 
@@ -368,8 +391,8 @@ console.log(`Executed: ${result.executed.length} migrations`)
 Rollback last N migrations:
 
 ```typescript
-await runner.down(1)   // Rollback last one
-await runner.down(3)   // Rollback last three
+await runner.down(1) // Rollback last one
+await runner.down(3) // Rollback last three
 ```
 
 #### `status(): Promise<MigrationStatus>`
@@ -386,7 +409,7 @@ const status = await runner.status()
 Rollback all migrations:
 
 ```typescript
-await runner.reset()  // Dangerous! Rolls back everything
+await runner.reset() // Dangerous! Rolls back everything
 ```
 
 #### `upTo(targetName): Promise<MigrationResult>`
@@ -448,9 +471,17 @@ interface MigrationPlugin {
   // Called once when runner is initialized (consistent with repository Plugin.onInit)
   onInit?(runner: MigrationRunner): Promise<void> | void
   beforeMigration?(migration: Migration, operation: 'up' | 'down'): Promise<void> | void
-  afterMigration?(migration: Migration, operation: 'up' | 'down', duration: number): Promise<void> | void
+  afterMigration?(
+    migration: Migration,
+    operation: 'up' | 'down',
+    duration: number
+  ): Promise<void> | void
   // Unknown error type for consistency with repository Plugin.onError
-  onMigrationError?(migration: Migration, operation: 'up' | 'down', error: unknown): Promise<void> | void
+  onMigrationError?(
+    migration: Migration,
+    operation: 'up' | 'down',
+    error: unknown
+  ): Promise<void> | void
 }
 ```
 
@@ -463,7 +494,7 @@ import { createLoggingPlugin } from '@kysera/migrations'
 
 const loggingPlugin = createLoggingPlugin(console.log)
 // or with custom logger
-const loggingPlugin = createLoggingPlugin((msg) => logger.info(msg))
+const loggingPlugin = createLoggingPlugin(msg => logger.info(msg))
 ```
 
 #### Metrics Plugin
@@ -503,7 +534,7 @@ const notificationPlugin: MigrationPlugin = {
     // Error is unknown type - handle appropriately
     const message = error instanceof Error ? error.message : String(error)
     await pagerduty.alert(`Migration failed: ${message}`)
-  },
+  }
 }
 ```
 
@@ -588,8 +619,12 @@ try {
 ```typescript
 createMigration(
   '001_create_users',
-  async (db) => { /* up */ },
-  async (db) => { /* down - always provide this! */ }
+  async db => {
+    /* up */
+  },
+  async db => {
+    /* down - always provide this! */
+  }
 )
 ```
 
@@ -598,9 +633,11 @@ createMigration(
 ```typescript
 createMigrationWithMeta('005_big_refactor', {
   description: 'Refactors user permissions system',
-  breaking: true,  // Will show warning
+  breaking: true, // Will show warning
   tags: ['breaking', 'permissions'],
-  up: async (db) => { /* ... */ },
+  up: async db => {
+    /* ... */
+  }
 })
 ```
 
@@ -618,7 +655,7 @@ await runMigrations(db, migrations)
 
 ```typescript
 const runner = createMigrationRunner(db, migrations, {
-  useTransactions: true,  // Each migration wrapped in transaction
+  useTransactions: true // Each migration wrapped in transaction
 })
 ```
 
@@ -628,7 +665,12 @@ const runner = createMigrationRunner(db, migrations, {
 // scripts/migrate.ts
 import { Kysely, PostgresDialect } from 'kysely'
 import { Pool } from 'pg'
-import { runMigrations, rollbackMigrations, getMigrationStatus, defineMigrations } from '@kysera/migrations'
+import {
+  runMigrations,
+  rollbackMigrations,
+  getMigrationStatus,
+  defineMigrations
+} from '@kysera/migrations'
 
 const migrations = defineMigrations({
   // ... your migrations
@@ -694,58 +736,51 @@ main()
 ### PostgreSQL
 
 ```typescript
-createMigration(
-  '001_create_users',
-  async (db) => {
-    await db.schema
-      .createTable('users')
-      .addColumn('id', 'serial', col => col.primaryKey())
-      .addColumn('created_at', 'timestamp', col =>
-        col.notNull().defaultTo(db.fn('now'))
-      )
-      .execute()
-  }
-)
+createMigration('001_create_users', async db => {
+  await db.schema
+    .createTable('users')
+    .addColumn('id', 'serial', col => col.primaryKey())
+    .addColumn('created_at', 'timestamp', col => col.notNull().defaultTo(db.fn('now')))
+    .execute()
+})
 ```
 
 ### MySQL
 
 ```typescript
-createMigration(
-  '001_create_users',
-  async (db) => {
-    await db.schema
-      .createTable('users')
-      .addColumn('id', 'integer', col =>
-        col.primaryKey().autoIncrement()
-      )
-      .addColumn('created_at', 'datetime', col =>
-        col.notNull().defaultTo(db.fn('now'))
-      )
-      .execute()
-  }
-)
+createMigration('001_create_users', async db => {
+  await db.schema
+    .createTable('users')
+    .addColumn('id', 'integer', col => col.primaryKey().autoIncrement())
+    .addColumn('created_at', 'datetime', col => col.notNull().defaultTo(db.fn('now')))
+    .execute()
+})
 ```
 
 ### SQLite
 
 ```typescript
-createMigration(
-  '001_create_users',
-  async (db) => {
-    await db.schema
-      .createTable('users')
-      .addColumn('id', 'integer', col =>
-        col.primaryKey().autoIncrement()
-      )
-      .addColumn('created_at', 'text', col =>
-        col.notNull().defaultTo(sql`CURRENT_TIMESTAMP`)
-      )
-      .execute()
-  }
-)
+createMigration('001_create_users', async db => {
+  await db.schema
+    .createTable('users')
+    .addColumn('id', 'integer', col => col.primaryKey().autoIncrement())
+    .addColumn('created_at', 'text', col => col.notNull().defaultTo(sql`CURRENT_TIMESTAMP`))
+    .execute()
+})
 ```
 
+## Implementation Details
+
+### Version File Fallback Pattern
+
+The migration system uses a robust version file fallback pattern to ensure compatibility across different build environments:
+
+1. **Primary:** Try to load `version.ts` (development/source code)
+2. **Fallback:** Try to load `version.js` (compiled/production code)
+3. **Default:** Use `'0.0.0-dev'` if both fail
+
+This pattern ensures migrations work correctly in both development and production environments without requiring specific build configurations.
+
 ## Changelog
 
 ### v0.5.1
@@ -758,6 +793,7 @@ createMigration(
 - **Added** `MigrationDefinition` and `MigrationDefinitions` type exports
 - **Added** `MigrationRunnerWithPluginsOptions` interface export
 - **Added** `DatabaseError` and `BadRequestError` re-exports from `@kysera/core`
+- **Added** Version file fallback pattern for cross-environment compatibility
 - **Changed** Validation errors now throw `BadRequestError` instead of generic `Error`
 
 ### v0.5.0

package/dist/index.d.ts

@@ -121,10 +121,12 @@ declare function setupMigrations(db: Kysely<unknown>): Promise<void>;
  * defaults to unknown for maximum flexibility
  */
 declare class MigrationRunner<DB = unknown> {
-    private db;
-    private migrations;
-    private logger;
-    private options;
+    protected logger: KyseraLogger;
+    protected runnerOptions: Required<Omit<MigrationRunnerOptions, 'logger'>> & {
+        logger: KyseraLogger;
+    };
+    protected db: Kysely<DB>;
+    protected migrations: Migration<DB>[];
     constructor(db: Kysely<DB>, migrations: Migration<DB>[], options?: MigrationRunnerOptions);
     /**
      * Get list of executed migrations from database
@@ -144,11 +146,11 @@ declare class MigrationRunner<DB = unknown> {
     /**
      * Log migration metadata if available
      */
-    private logMigrationMeta;
+    protected logMigrationMeta(migration: Migration<DB>): void;
     /**
      * Execute a single migration with optional transaction wrapping
      */
-    private executeMigration;
+    protected executeMigration(migration: Migration<DB>, operation: 'up' | 'down'): Promise<void>;
     /**
      * Run all pending migrations
      */
@@ -261,6 +263,9 @@ declare function createMigrationRunnerWithPlugins<DB = unknown>(db: Kysely<DB>,
  * Extended migration runner with plugin support
  * Generic DB type allows type-safe migrations when schema is known,
  * defaults to unknown for maximum flexibility
+ *
+ * This class overrides up() and down() to call plugin lifecycle hooks
+ * (beforeMigration, afterMigration, onMigrationError) around each migration execution.
  */
 declare class MigrationRunnerWithPlugins<DB = unknown> extends MigrationRunner<DB> {
     private plugins;
@@ -284,6 +289,16 @@ declare class MigrationRunnerWithPlugins<DB = unknown> extends MigrationRunner<D
      * Get the list of registered plugins
      */
     getPlugins(): MigrationPlugin<DB>[];
+    /**
+     * Run all pending migrations with plugin hooks
+     * Overrides parent to call beforeMigration/afterMigration/onMigrationError hooks
+     */
+    up(): Promise<MigrationResult>;
+    /**
+     * Rollback last N migrations with plugin hooks
+     * Overrides parent to call beforeMigration/afterMigration/onMigrationError hooks
+     */
+    down(steps?: number): Promise<MigrationResult>;
 }
 /**
  * Logging plugin - logs migration events with timing
@@ -296,12 +311,12 @@ declare function createLoggingPlugin<DB = unknown>(logger?: KyseraLogger): Migra
  */
 declare function createMetricsPlugin<DB = unknown>(): MigrationPlugin<DB> & {
     getMetrics(): {
-        migrations: Array<{
+        migrations: {
             name: string;
             operation: string;
             duration: number;
             success: boolean;
-        }>;
+        }[];
     };
 };
 

package/dist/index.js

@@ -1,2 +1,2 @@
-import {sql}from'kysely';import {silentLogger,DatabaseError,BadRequestError,NotFoundError}from'@kysera/core';export{BadRequestError,DatabaseError,NotFoundError,silentLogger}from'@kysera/core';import {z as z$1}from'zod';var d=z$1.object({dryRun:z$1.boolean().default(false),logger:z$1.any().optional(),useTransactions:z$1.boolean().default(false),stopOnError:z$1.boolean().default(true),verbose:z$1.boolean().default(true)}),m=z$1.object({name:z$1.string().min(1,"Migration name is required"),description:z$1.string().optional(),breaking:z$1.boolean().default(false),tags:z$1.array(z$1.string()).default([]),estimatedDuration:z$1.string().optional()}),x=z$1.object({logger:z$1.any().optional()}),D=z$1.object({name:z$1.string().min(1,"Plugin name is required"),version:z$1.string().min(1,"Plugin version is required"),onInit:z$1.any().optional(),beforeMigration:z$1.any().optional(),afterMigration:z$1.any().optional(),onMigrationError:z$1.any().optional()}),b=z$1.object({executed:z$1.array(z$1.string()),pending:z$1.array(z$1.string()),total:z$1.number().int().nonnegative()}),P=z$1.object({executed:z$1.array(z$1.string()),skipped:z$1.array(z$1.string()),failed:z$1.array(z$1.string()),duration:z$1.number().nonnegative(),dryRun:z$1.boolean()}),B=d.extend({plugins:z$1.array(D).optional()});function k(e){return d.parse(e)}function O(e){return d.safeParse(e)}function E(e){return m.parse(e)}function v(e){return m.safeParse(e)}var f=class extends DatabaseError{migrationName;operation;constructor(n,i,t,o){let a=t==="up"?"MIGRATION_UP_FAILED":"MIGRATION_DOWN_FAILED";super(n,a,i),this.name="MigrationError",this.migrationName=i,this.operation=t,o&&(this.cause=o);}toJSON(){let n=this.cause instanceof Error?this.cause:void 0;return {...super.toJSON(),migrationName:this.migrationName,operation:this.operation,cause:n?.message}}};async function c(e){await e.schema.createTable("migrations").ifNotExists().addColumn("name","varchar(255)",n=>n.primaryKey()).addColumn("executed_at","timestamp",n=>n.notNull().defaultTo(sql`CURRENT_TIMESTAMP`)).execute();}function h(e){return "description"in e||"breaking"in e||"tags"in e}function M(e){return e instanceof Error?e.message:String(e)}function N(e){let n=new Set;for(let i of e){if(n.has(i.name))throw new BadRequestError(`Duplicate migration name: ${i.name}`);n.add(i.name);}}var p=class{constructor(n,i,t={}){this.db=n;this.migrations=i;let o=d.safeParse(t);if(!o.success)throw new BadRequestError(`Invalid migration runner options: ${o.error.message}`);this.logger=t.logger??silentLogger,this.options={dryRun:o.data.dryRun,logger:this.logger,useTransactions:o.data.useTransactions,stopOnError:o.data.stopOnError,verbose:o.data.verbose},N(i);}logger;options;async getExecutedMigrations(){return await c(this.db),(await this.db.selectFrom("migrations").select("name").orderBy("executed_at","asc").execute()).map(i=>i.name)}async markAsExecuted(n){await this.db.insertInto("migrations").values({name:n}).execute();}async markAsRolledBack(n){await this.db.deleteFrom("migrations").where("name","=",n).execute();}logMigrationMeta(n){if(!this.options.verbose||!h(n))return;let i=n;if(i.description&&this.logger.info(`  Description: ${i.description}`),i.breaking&&this.logger.warn("  BREAKING CHANGE - Review carefully before proceeding"),i.tags&&i.tags.length>0&&this.logger.info(`  Tags: ${i.tags.join(", ")}`),i.estimatedDuration){let t=(i.estimatedDuration/1e3).toFixed(1);this.logger.info(`  Estimated: ${t}s`);}}async executeMigration(n,i){let t=i==="up"?n.up:n.down;t&&(this.options.useTransactions?await this.db.transaction().execute(async o=>{await t(o);}):await t(this.db));}async up(){let n=Date.now(),i={executed:[],skipped:[],failed:[],duration:0,dryRun:this.options.dryRun};await c(this.db);let t=await this.getExecutedMigrations();if(this.migrations.filter(a=>!t.includes(a.name)).length===0)return this.logger.info("No pending migrations"),i.skipped=t,i.duration=Date.now()-n,i;this.options.dryRun&&this.logger.info("DRY RUN - No changes will be made");for(let a of this.migrations){if(t.includes(a.name)){this.logger.info(`${a.name} (already executed)`),i.skipped.push(a.name);continue}try{this.logger.info(`Running ${a.name}...`),this.logMigrationMeta(a),this.options.dryRun||(await this.executeMigration(a,"up"),await this.markAsExecuted(a.name)),this.logger.info(`${a.name} completed`),i.executed.push(a.name);}catch(g){let s=M(g);if(this.logger.error(`${a.name} failed: ${s}`),i.failed.push(a.name),this.options.stopOnError)throw new f(`Migration ${a.name} failed: ${s}`,a.name,"up",g instanceof Error?g:void 0)}}return this.options.dryRun?this.logger.info("Dry run completed - no changes made"):this.logger.info("All migrations completed successfully"),i.duration=Date.now()-n,i}async down(n=1){let i=Date.now(),t={executed:[],skipped:[],failed:[],duration:0,dryRun:this.options.dryRun};await c(this.db);let o=await this.getExecutedMigrations();if(o.length===0)return this.logger.warn("No executed migrations to rollback"),t.duration=Date.now()-i,t;let a=o.slice(-n).reverse();this.options.dryRun&&this.logger.info("DRY RUN - No changes will be made");for(let g of a){let s=this.migrations.find(u=>u.name===g);if(!s){this.logger.warn(`Migration ${g} not found in codebase`),t.skipped.push(g);continue}if(!s.down){this.logger.warn(`Migration ${g} has no down method - skipping`),t.skipped.push(g);continue}try{this.logger.info(`Rolling back ${g}...`),this.logMigrationMeta(s),this.options.dryRun||(await this.executeMigration(s,"down"),await this.markAsRolledBack(g)),this.logger.info(`${g} rolled back`),t.executed.push(g);}catch(u){let l=M(u);if(this.logger.error(`${g} rollback failed: ${l}`),t.failed.push(g),this.options.stopOnError)throw new f(`Rollback of ${g} failed: ${l}`,g,"down",u instanceof Error?u:void 0)}}return this.options.dryRun?this.logger.info("Dry run completed - no changes made"):this.logger.info("Rollback completed successfully"),t.duration=Date.now()-i,t}async status(){await c(this.db);let n=await this.getExecutedMigrations(),i=this.migrations.filter(t=>!n.includes(t.name)).map(t=>t.name);if(this.logger.info("Migration Status:"),this.logger.info(`  Executed: ${n.length}`),this.logger.info(`  Pending: ${i.length}`),this.logger.info(`  Total: ${this.migrations.length}`),n.length>0){this.logger.info("Executed migrations:");for(let t of n){let o=this.migrations.find(a=>a.name===t);o&&h(o)&&o.description?this.logger.info(`  ${t} - ${o.description}`):this.logger.info(`  ${t}`);}}if(i.length>0){this.logger.info("Pending migrations:");for(let t of i){let o=this.migrations.find(a=>a.name===t);if(o&&h(o)){let a=o,g=a.breaking?" BREAKING":"",s=a.description?` - ${a.description}`:"";this.logger.info(`  ${t}${s}${g}`);}else this.logger.info(`  ${t}`);}}return {executed:n,pending:i,total:this.migrations.length}}async reset(){let n=Date.now();await c(this.db);let i=await this.getExecutedMigrations();if(i.length===0)return this.logger.warn("No migrations to reset"),{executed:[],skipped:[],failed:[],duration:Date.now()-n,dryRun:this.options.dryRun};if(this.logger.warn(`Resetting ${i.length} migrations...`),this.options.dryRun){this.logger.info("DRY RUN - Would rollback the following migrations:");for(let o of [...i].reverse())this.migrations.find(g=>g.name===o)?.down?this.logger.info(`  ${o}`):this.logger.warn(`  ${o} (no down method - would be skipped)`);return this.logger.info("Dry run completed - no changes made"),{executed:[],skipped:i,failed:[],duration:Date.now()-n,dryRun:true}}let t=await this.down(i.length);return this.logger.info("All migrations reset"),t}async upTo(n){let i=Date.now(),t={executed:[],skipped:[],failed:[],duration:0,dryRun:this.options.dryRun};await c(this.db);let o=await this.getExecutedMigrations(),a=this.migrations.findIndex(s=>s.name===n);if(a===-1)throw new NotFoundError("Migration",{name:n});let g=this.migrations.slice(0,a+1);this.options.dryRun&&this.logger.info("DRY RUN - No changes will be made");for(let s of g){if(o.includes(s.name)){this.logger.info(`${s.name} (already executed)`),t.skipped.push(s.name);continue}try{this.logger.info(`Running ${s.name}...`),this.logMigrationMeta(s),this.options.dryRun||(await this.executeMigration(s,"up"),await this.markAsExecuted(s.name)),this.logger.info(`${s.name} completed`),t.executed.push(s.name);}catch(u){let l=M(u);throw this.logger.error(`${s.name} failed: ${l}`),t.failed.push(s.name),new f(`Migration ${s.name} failed: ${l}`,s.name,"up",u instanceof Error?u:void 0)}}return this.options.dryRun?this.logger.info(`Dry run completed - would migrate up to ${n}`):this.logger.info(`Migrated up to ${n}`),t.duration=Date.now()-i,t}};function z(e,n,i){return new p(e,n,i)}function _(e,n,i){let t={name:e,up:n};return i!==void 0&&(t.down=i),t}function F(e,n){let i={name:e,up:n.up};return n.down!==void 0&&(i.down=n.down),n.description!==void 0&&(i.description=n.description),n.breaking!==void 0&&(i.breaking=n.breaking),n.estimatedDuration!==void 0&&(i.estimatedDuration=n.estimatedDuration),n.tags!==void 0&&(i.tags=n.tags),i}function j(e){return Object.entries(e).map(([n,i])=>{let t={name:n,up:i.up};return i.down!==void 0&&(t.down=i.down),i.description!==void 0&&(t.description=i.description),i.breaking!==void 0&&(t.breaking=i.breaking),i.estimatedDuration!==void 0&&(t.estimatedDuration=i.estimatedDuration),i.tags!==void 0&&(t.tags=i.tags),t})}async function G(e,n,i){return new p(e,n,i).up()}async function q(e,n,i=1,t){return new p(e,n,t).down(i)}async function C(e,n,i){return new p(e,n,i).status()}async function U(e,n,i){let t=new y(e,n,i);if(i?.plugins){for(let o of i.plugins)if(o.onInit){let a=o.onInit(t);a instanceof Promise&&await a;}}return t}var y=class extends p{plugins;constructor(n,i,t={}){super(n,i,t),this.plugins=t.plugins??[];}async runBeforeHooks(n,i){for(let t of this.plugins)t.beforeMigration&&await t.beforeMigration(n,i);}async runAfterHooks(n,i,t){for(let o of this.plugins)o.afterMigration&&await o.afterMigration(n,i,t);}async runErrorHooks(n,i,t){for(let o of this.plugins)o.onMigrationError&&await o.onMigrationError(n,i,t);}getPlugins(){return [...this.plugins]}};function H(e=silentLogger){return {name:"@kysera/migrations/logging",version:"0.5.1",beforeMigration(n,i){e.info(`Starting ${i} for ${n.name}`);},afterMigration(n,i,t){e.info(`Completed ${i} for ${n.name} in ${t}ms`);},onMigrationError(n,i,t){let o=t instanceof Error?t.message:String(t);e.error(`Error during ${i} for ${n.name}: ${o}`);}}}function Y(){let e=[];return {name:"@kysera/migrations/metrics",version:"0.5.1",afterMigration(n,i,t){e.push({name:n.name,operation:i,duration:t,success:true});},onMigrationError(n,i){e.push({name:n.name,operation:i,duration:0,success:false});},getMetrics(){return {migrations:[...e]}}}}export{m as MigrationDefinitionSchema,f as MigrationError,x as MigrationPluginOptionsSchema,D as MigrationPluginSchema,P as MigrationResultSchema,p as MigrationRunner,d as MigrationRunnerOptionsSchema,y as MigrationRunnerWithPlugins,B as MigrationRunnerWithPluginsOptionsSchema,b as MigrationStatusSchema,H as createLoggingPlugin,Y as createMetricsPlugin,_ as createMigration,z as createMigrationRunner,U as createMigrationRunnerWithPlugins,F as createMigrationWithMeta,j as defineMigrations,C as getMigrationStatus,E as parseMigrationDefinition,k as parseMigrationRunnerOptions,q as rollbackMigrations,G as runMigrations,v as safeParseMigrationDefinition,O as safeParseMigrationRunnerOptions,c as setupMigrations};//# sourceMappingURL=index.js.map
+import {sql}from'kysely';import {silentLogger,DatabaseError,BadRequestError,NotFoundError}from'@kysera/core';export{BadRequestError,DatabaseError,NotFoundError,silentLogger}from'@kysera/core';import {z}from'zod';var R="__VERSION__",h=R.startsWith("__")?"0.0.0-dev":R;var x=z.object({trace:z.function(),debug:z.function(),info:z.function(),warn:z.function(),error:z.function(),fatal:z.function()}).passthrough(),f=z.object({dryRun:z.boolean().default(false),logger:x.optional(),useTransactions:z.boolean().default(false),stopOnError:z.boolean().default(true),verbose:z.boolean().default(true)}),M=z.object({name:z.string().min(1,"Migration name is required"),description:z.string().optional(),breaking:z.boolean().default(false),tags:z.array(z.string()).default([]),estimatedDuration:z.string().optional()}),B=z.object({logger:x.optional()}),b=z.object({name:z.string().min(1,"Plugin name is required"),version:z.string().min(1,"Plugin version is required"),onInit:z.function().optional(),beforeMigration:z.function().optional(),afterMigration:z.function().optional(),onMigrationError:z.function().optional()}),P=z.object({executed:z.array(z.string()),pending:z.array(z.string()),total:z.number().int().nonnegative()}),E=z.object({executed:z.array(z.string()),skipped:z.array(z.string()),failed:z.array(z.string()),duration:z.number().nonnegative(),dryRun:z.boolean()}),$=f.extend({plugins:z.array(b).optional()});function v(o){return f.parse(o)}function S(o){return f.safeParse(o)}function I(o){return M.parse(o)}function N(o){return M.safeParse(o)}var p=class extends DatabaseError{migrationName;operation;constructor(i,n,t,r){let e=t==="up"?"MIGRATION_UP_FAILED":"MIGRATION_DOWN_FAILED";super(i,e,n),this.name="MigrationError",this.migrationName=n,this.operation=t,r&&(this.cause=r);}toJSON(){let i=this.cause instanceof Error?this.cause:void 0;return {...super.toJSON(),migrationName:this.migrationName,operation:this.operation,cause:i?.message}}};async function c(o){await o.schema.createTable("migrations").ifNotExists().addColumn("name","varchar(255)",i=>i.primaryKey()).addColumn("executed_at","timestamp",i=>i.notNull().defaultTo(sql`CURRENT_TIMESTAMP`)).execute();try{await o.schema.createIndex("idx_migrations_name").on("migrations").column("name").execute();}catch{}}function y(o){return "description"in o||"breaking"in o||"tags"in o}function m(o){return o instanceof Error?o.message:String(o)}function W(o){let i=new Set;for(let n of o){if(i.has(n.name))throw new BadRequestError(`Duplicate migration name: ${n.name}`);i.add(n.name);}}var l=class{logger;runnerOptions;db;migrations;constructor(i,n,t={}){let r=f.safeParse(t);if(!r.success)throw new BadRequestError(`Invalid migration runner options: ${r.error.message}`);this.db=i,this.migrations=n,this.logger=t.logger??silentLogger,this.runnerOptions={dryRun:r.data.dryRun,logger:this.logger,useTransactions:r.data.useTransactions,stopOnError:r.data.stopOnError,verbose:r.data.verbose},W(n);}async getExecutedMigrations(){return await c(this.db),(await this.db.selectFrom("migrations").select("name").orderBy("executed_at","asc").execute()).map(n=>n.name)}async markAsExecuted(i){await this.db.insertInto("migrations").values({name:i}).execute();}async markAsRolledBack(i){await this.db.deleteFrom("migrations").where("name","=",i).execute();}logMigrationMeta(i){if(!this.runnerOptions.verbose||!y(i))return;let n=i;if(n.description&&this.logger.info(`  Description: ${n.description}`),n.breaking&&this.logger.warn("  BREAKING CHANGE - Review carefully before proceeding"),n.tags&&n.tags.length>0&&this.logger.info(`  Tags: ${n.tags.join(", ")}`),n.estimatedDuration){let t=(n.estimatedDuration/1e3).toFixed(1);this.logger.info(`  Estimated: ${t}s`);}}async executeMigration(i,n){let t=n==="up"?i.up:i.down;t&&(this.runnerOptions.useTransactions?await this.db.transaction().execute(async r=>{await t(r);}):await t(this.db));}async up(){let i=Date.now(),n={executed:[],skipped:[],failed:[],duration:0,dryRun:this.runnerOptions.dryRun};await c(this.db);let t=await this.getExecutedMigrations();if(this.migrations.filter(e=>!t.includes(e.name)).length===0)return this.logger.info("No pending migrations"),n.skipped=t,n.duration=Date.now()-i,n;this.runnerOptions.dryRun&&this.logger.info("DRY RUN - No changes will be made");for(let e of this.migrations){if(t.includes(e.name)){this.logger.info(`${e.name} (already executed)`),n.skipped.push(e.name);continue}try{this.logger.info(`Running ${e.name}...`),this.logMigrationMeta(e),this.runnerOptions.dryRun||(await this.executeMigration(e,"up"),await this.markAsExecuted(e.name)),this.logger.info(`${e.name} completed`),n.executed.push(e.name);}catch(g){let s=m(g);if(this.logger.error(`${e.name} failed: ${s}`),n.failed.push(e.name),this.runnerOptions.stopOnError)throw new p(`Migration ${e.name} failed: ${s}`,e.name,"up",g instanceof Error?g:void 0)}}return this.runnerOptions.dryRun?this.logger.info("Dry run completed - no changes made"):this.logger.info("All migrations completed successfully"),n.duration=Date.now()-i,n}async down(i=1){let n=Date.now(),t={executed:[],skipped:[],failed:[],duration:0,dryRun:this.runnerOptions.dryRun};await c(this.db);let r=await this.getExecutedMigrations();if(r.length===0)return this.logger.warn("No executed migrations to rollback"),t.duration=Date.now()-n,t;let e=r.slice(-i).reverse();this.runnerOptions.dryRun&&this.logger.info("DRY RUN - No changes will be made");for(let g of e){let s=this.migrations.find(u=>u.name===g);if(!s){this.logger.warn(`Migration ${g} not found in codebase`),t.skipped.push(g);continue}if(!s.down){this.logger.warn(`Migration ${g} has no down method - skipping`),t.skipped.push(g);continue}try{this.logger.info(`Rolling back ${g}...`),this.logMigrationMeta(s),this.runnerOptions.dryRun||(await this.executeMigration(s,"down"),await this.markAsRolledBack(g)),this.logger.info(`${g} rolled back`),t.executed.push(g);}catch(u){let d=m(u);if(this.logger.error(`${g} rollback failed: ${d}`),t.failed.push(g),this.runnerOptions.stopOnError)throw new p(`Rollback of ${g} failed: ${d}`,g,"down",u instanceof Error?u:void 0)}}return this.runnerOptions.dryRun?this.logger.info("Dry run completed - no changes made"):this.logger.info("Rollback completed successfully"),t.duration=Date.now()-n,t}async status(){await c(this.db);let i=await this.getExecutedMigrations(),n=this.migrations.filter(t=>!i.includes(t.name)).map(t=>t.name);if(this.logger.info("Migration Status:"),this.logger.info(`  Executed: ${i.length}`),this.logger.info(`  Pending: ${n.length}`),this.logger.info(`  Total: ${this.migrations.length}`),i.length>0){this.logger.info("Executed migrations:");for(let t of i){let r=this.migrations.find(e=>e.name===t);r&&y(r)&&r.description?this.logger.info(`  ${t} - ${r.description}`):this.logger.info(`  ${t}`);}}if(n.length>0){this.logger.info("Pending migrations:");for(let t of n){let r=this.migrations.find(e=>e.name===t);if(r&&y(r)){let e=r,g=e.breaking?" BREAKING":"",s=e.description?` - ${e.description}`:"";this.logger.info(`  ${t}${s}${g}`);}else this.logger.info(`  ${t}`);}}return {executed:i,pending:n,total:this.migrations.length}}async reset(){let i=Date.now();await c(this.db);let n=await this.getExecutedMigrations();if(n.length===0)return this.logger.warn("No migrations to reset"),{executed:[],skipped:[],failed:[],duration:Date.now()-i,dryRun:this.runnerOptions.dryRun};if(this.logger.warn(`Resetting ${n.length} migrations...`),this.runnerOptions.dryRun){this.logger.info("DRY RUN - Would rollback the following migrations:");for(let r of [...n].reverse())this.migrations.find(g=>g.name===r)?.down?this.logger.info(`  ${r}`):this.logger.warn(`  ${r} (no down method - would be skipped)`);return this.logger.info("Dry run completed - no changes made"),{executed:[],skipped:n,failed:[],duration:Date.now()-i,dryRun:true}}let t=await this.down(n.length);return this.logger.info("All migrations reset"),t}async upTo(i){let n=Date.now(),t={executed:[],skipped:[],failed:[],duration:0,dryRun:this.runnerOptions.dryRun};await c(this.db);let r=await this.getExecutedMigrations(),e=this.migrations.findIndex(s=>s.name===i);if(e===-1)throw new NotFoundError("Migration",{name:i});let g=this.migrations.slice(0,e+1);this.runnerOptions.dryRun&&this.logger.info("DRY RUN - No changes will be made");for(let s of g){if(r.includes(s.name)){this.logger.info(`${s.name} (already executed)`),t.skipped.push(s.name);continue}try{this.logger.info(`Running ${s.name}...`),this.logMigrationMeta(s),this.runnerOptions.dryRun||(await this.executeMigration(s,"up"),await this.markAsExecuted(s.name)),this.logger.info(`${s.name} completed`),t.executed.push(s.name);}catch(u){let d=m(u);throw this.logger.error(`${s.name} failed: ${d}`),t.failed.push(s.name),new p(`Migration ${s.name} failed: ${d}`,s.name,"up",u instanceof Error?u:void 0)}}return this.runnerOptions.dryRun?this.logger.info(`Dry run completed - would migrate up to ${i}`):this.logger.info(`Migrated up to ${i}`),t.duration=Date.now()-n,t}};function G(o,i,n){return new l(o,i,n)}function q(o,i,n){let t={name:o,up:i};return n!==void 0&&(t.down=n),t}function C(o,i){let n={name:o,up:i.up};return i.down!==void 0&&(n.down=i.down),i.description!==void 0&&(n.description=i.description),i.breaking!==void 0&&(n.breaking=i.breaking),i.estimatedDuration!==void 0&&(n.estimatedDuration=i.estimatedDuration),i.tags!==void 0&&(n.tags=i.tags),n}function Y(o){return Object.entries(o).map(([i,n])=>{let t={name:i,up:n.up};return n.down!==void 0&&(t.down=n.down),n.description!==void 0&&(t.description=n.description),n.breaking!==void 0&&(t.breaking=n.breaking),n.estimatedDuration!==void 0&&(t.estimatedDuration=n.estimatedDuration),n.tags!==void 0&&(t.tags=n.tags),t})}async function V(o,i,n){return await new l(o,i,n).up()}async function J(o,i,n=1,t){return await new l(o,i,t).down(n)}async function Q(o,i,n){return await new l(o,i,n).status()}async function X(o,i,n){let t=new w(o,i,n);if(n?.plugins){for(let r of n.plugins)if(r.onInit){let e=r.onInit(t);e instanceof Promise&&await e;}}return t}var w=class extends l{plugins;constructor(i,n,t={}){super(i,n,t),this.plugins=t.plugins??[];}async runBeforeHooks(i,n){for(let t of this.plugins)t.beforeMigration&&await t.beforeMigration(i,n);}async runAfterHooks(i,n,t){for(let r of this.plugins)r.afterMigration&&await r.afterMigration(i,n,t);}async runErrorHooks(i,n,t){for(let r of this.plugins)r.onMigrationError&&await r.onMigrationError(i,n,t);}getPlugins(){return [...this.plugins]}async up(){let i=Date.now(),n={executed:[],skipped:[],failed:[],duration:0,dryRun:this.runnerOptions.dryRun};await c(this.db);let t=await this.getExecutedMigrations();if(this.migrations.filter(e=>!t.includes(e.name)).length===0)return this.logger.info("No pending migrations"),n.skipped=t,n.duration=Date.now()-i,n;this.runnerOptions.dryRun&&this.logger.info("DRY RUN - No changes will be made");for(let e of this.migrations){if(t.includes(e.name)){this.logger.info(`${e.name} (already executed)`),n.skipped.push(e.name);continue}let g=Date.now();try{await this.runBeforeHooks(e,"up"),this.logger.info(`Running ${e.name}...`),this.logMigrationMeta(e),this.runnerOptions.dryRun||(await this.executeMigration(e,"up"),await this.markAsExecuted(e.name));let s=Date.now()-g;await this.runAfterHooks(e,"up",s),this.logger.info(`${e.name} completed`),n.executed.push(e.name);}catch(s){await this.runErrorHooks(e,"up",s);let u=m(s);if(this.logger.error(`${e.name} failed: ${u}`),n.failed.push(e.name),this.runnerOptions.stopOnError)throw new p(`Migration ${e.name} failed: ${u}`,e.name,"up",s instanceof Error?s:void 0)}}return this.runnerOptions.dryRun?this.logger.info("Dry run completed - no changes made"):this.logger.info("All migrations completed successfully"),n.duration=Date.now()-i,n}async down(i=1){let n=Date.now(),t={executed:[],skipped:[],failed:[],duration:0,dryRun:this.runnerOptions.dryRun};await c(this.db);let r=await this.getExecutedMigrations();if(r.length===0)return this.logger.warn("No executed migrations to rollback"),t.duration=Date.now()-n,t;let e=r.slice(-i).reverse();this.runnerOptions.dryRun&&this.logger.info("DRY RUN - No changes will be made");for(let g of e){let s=this.migrations.find(d=>d.name===g);if(!s){this.logger.warn(`Migration ${g} not found in codebase`),t.skipped.push(g);continue}if(!s.down){this.logger.warn(`Migration ${g} has no down method - skipping`),t.skipped.push(g);continue}let u=Date.now();try{await this.runBeforeHooks(s,"down"),this.logger.info(`Rolling back ${g}...`),this.logMigrationMeta(s),this.runnerOptions.dryRun||(await this.executeMigration(s,"down"),await this.markAsRolledBack(g));let d=Date.now()-u;await this.runAfterHooks(s,"down",d),this.logger.info(`${g} rolled back`),t.executed.push(g);}catch(d){await this.runErrorHooks(s,"down",d);let D=m(d);if(this.logger.error(`${g} rollback failed: ${D}`),t.failed.push(g),this.runnerOptions.stopOnError)throw new p(`Rollback of ${g} failed: ${D}`,g,"down",d instanceof Error?d:void 0)}}return this.runnerOptions.dryRun?this.logger.info("Dry run completed - no changes made"):this.logger.info("Rollback completed successfully"),t.duration=Date.now()-n,t}};function Z(o=silentLogger){return {name:"@kysera/migrations/logging",version:h,beforeMigration(i,n){o.info(`Starting ${n} for ${i.name}`);},afterMigration(i,n,t){o.info(`Completed ${n} for ${i.name} in ${t}ms`);},onMigrationError(i,n,t){let r=t instanceof Error?t.message:String(t);o.error(`Error during ${n} for ${i.name}: ${r}`);}}}function nn(){let o=[];return {name:"@kysera/migrations/metrics",version:h,afterMigration(i,n,t){o.push({name:i.name,operation:n,duration:t,success:true});},onMigrationError(i,n){o.push({name:i.name,operation:n,duration:0,success:false});},getMetrics(){return {migrations:[...o]}}}}export{M as MigrationDefinitionSchema,p as MigrationError,B as MigrationPluginOptionsSchema,b as MigrationPluginSchema,E as MigrationResultSchema,l as MigrationRunner,f as MigrationRunnerOptionsSchema,w as MigrationRunnerWithPlugins,$ as MigrationRunnerWithPluginsOptionsSchema,P as MigrationStatusSchema,Z as createLoggingPlugin,nn as createMetricsPlugin,q as createMigration,G as createMigrationRunner,X as createMigrationRunnerWithPlugins,C as createMigrationWithMeta,Y as defineMigrations,Q as getMigrationStatus,I as parseMigrationDefinition,v as parseMigrationRunnerOptions,J as rollbackMigrations,V as runMigrations,N as safeParseMigrationDefinition,S as safeParseMigrationRunnerOptions,c as setupMigrations};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map