@warlock.js/cascade 5.19.1 → 5.21.0

package/esm/events/model-events.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"model-events.mjs","names":[],"sources":["../../../../../../../cascade/src/events/model-events.ts"],"sourcesContent":["import { type QueryBuilderContract } from \"../contracts\";\r\nimport type { Model } from \"../model/model\";\r\nimport { type DeleteStrategy } from \"../types\";\r\n\r\ntype OnValidatingEventContext = {\r\n  isInsert: boolean;\r\n  mode: \"insert\" | \"update\";\r\n};\r\n\r\ntype OnSavingEventContext = {\r\n  isInsert: boolean;\r\n  mode: \"insert\" | \"update\";\r\n};\r\n\r\ntype OnDeletingEventContext = {\r\n  strategy: DeleteStrategy;\r\n  primaryKeyValue: string | number;\r\n  primaryKey: string;\r\n};\r\n\r\nexport type OnDeletedEventContext = OnDeletingEventContext & {\r\n  deletedCount: number;\r\n  trashRecord?: Record<string, unknown>;\r\n};\r\n\r\ntype OnFetchingEventContext = {\r\n  table: string;\r\n  modelClass: any;\r\n};\r\n\r\ntype OnHydratingEventContext = {\r\n  query: QueryBuilderContract;\r\n  hydrateCallback?: (data: any, index: number) => any;\r\n};\r\n\r\ntype OnFetchedEventContext = {\r\n  query: QueryBuilderContract;\r\n  rawRecords: any[];\r\n  duration: number;\r\n};\r\n\r\n/**\r\n * Lifecycle events understood by Cascade models.\r\n *\r\n * The list mirrors the hooks in the legacy ORM so downstream code can subscribe\r\n * with consistent semantics.\r\n */\r\nexport type ModelEventName =\r\n  | \"initializing\"\r\n  | \"fetching\"\r\n  | \"hydrating\"\r\n  | \"fetched\"\r\n  | \"validating\"\r\n  | \"validated\"\r\n  | \"saving\"\r\n  | \"saved\"\r\n  | \"creating\"\r\n  | \"created\"\r\n  | \"updating\"\r\n  | \"updated\"\r\n  | \"deleting\"\r\n  | \"deleted\"\r\n  | \"restoring\"\r\n  | \"restored\";\r\n\r\n/** Signature of an event listener registered against a model lifecycle hook. */\r\nexport type ModelEventListener<TModel, TContext = unknown> = (\r\n  model: TModel,\r\n  context: TContext,\r\n) => void | Promise<void>;\r\n\r\n/**\r\n * Light-weight async event emitter used to power model lifecycle hooks.\r\n *\r\n * The implementation intentionally avoids any external dependency so we can\r\n * re-use it in drivers, writers, and other core services without pulling in\r\n * heavier event libraries.\r\n */\r\nexport class ModelEvents<TModel> {\r\n  public readonly listeners = new Map<ModelEventName, Set<ModelEventListener<TModel>>>();\r\n\r\n  /**\r\n   * Register a listener for the given event.\r\n   * Returns an unsubscribe function for convenience.\r\n   */\r\n  public on<TContext = unknown>(\r\n    event: ModelEventName,\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    const listeners = this.ensureListenerSet(event);\r\n    listeners.add(listener as ModelEventListener<TModel>);\r\n    return () => this.off(event, listener);\r\n  }\r\n\r\n  /**\r\n   * Register a listener that automatically unsubscribes after the first call.\r\n   */\r\n  public once<TContext = unknown>(\r\n    event: ModelEventName,\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    const wrapper: ModelEventListener<TModel, TContext> = async (model, context) => {\r\n      try {\r\n        await listener(model, context);\r\n      } finally {\r\n        this.off(event, wrapper);\r\n      }\r\n    };\r\n    return this.on(event, wrapper);\r\n  }\r\n\r\n  /**\r\n   * Deregister a listener for the given event.\r\n   */\r\n  public off<TContext = unknown>(\r\n    event: ModelEventName,\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): void {\r\n    const listeners = this.listeners.get(event);\r\n    if (!listeners) {\r\n      return;\r\n    }\r\n    listeners.delete(listener as ModelEventListener<TModel>);\r\n    if (listeners.size === 0) {\r\n      this.listeners.delete(event);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Emit an event to all registered listeners.\r\n   */\r\n  public async emit<TContext = unknown>(\r\n    event: ModelEventName,\r\n    model: TModel,\r\n    context: TContext,\r\n  ): Promise<void> {\r\n    const listeners = this.listeners.get(event);\r\n    if (!listeners || listeners.size === 0) {\r\n      return;\r\n    }\r\n    for (const listener of Array.from(listeners)) {\r\n      await listener(model, context);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Emit events for fetching\r\n   */\r\n  public async emitFetching<TContext = unknown>(\r\n    query: QueryBuilderContract,\r\n    context?: TContext,\r\n  ): Promise<void> {\r\n    await this.emit(\"fetching\", query as any, context);\r\n  }\r\n\r\n  /**\r\n   * Remove all registered listeners.\r\n   */\r\n  public clear(): void {\r\n    this.listeners.clear();\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"saving\" event.\r\n   *\r\n   * Fired before a model is persisted (both insert and update), and before validation.\r\n   * Use this hook for data enrichment and preparation (e.g., setting createdBy, updatedBy).\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onSaving<TContext = OnSavingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"saving\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"saved\" event.\r\n   *\r\n   * Fired after a model has been successfully persisted.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onSaved<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void {\r\n    return this.on(\"saved\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"creating\" event.\r\n   *\r\n   * Fired before a new model is inserted into the database.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onCreating<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"creating\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"created\" event.\r\n   *\r\n   * Fired after a new model has been successfully inserted.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onCreated<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void {\r\n    return this.on(\"created\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"updating\" event.\r\n   *\r\n   * Fired before an existing model is updated in the database.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onUpdating<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"updating\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"updated\" event.\r\n   *\r\n   * Fired after an existing model has been successfully updated.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onUpdated<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void {\r\n    return this.on(\"updated\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"deleting\" event.\r\n   *\r\n   * Fired before a model is deleted from the database.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onDeleting<TContext = OnDeletingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"deleting\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"deleted\" event.\r\n   *\r\n   * Fired after a model has been successfully deleted.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onDeleted<TContext = OnDeletedEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"deleted\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"validating\" event.\r\n   *\r\n   * Fired before model validation is performed.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onValidating<TContext = OnValidatingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"validating\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"validated\" event.\r\n   *\r\n   * Fired after model validation has completed.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onValidated<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"validated\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"fetching\" event.\r\n   *\r\n   * Fired before a query is executed to fetch models.\r\n   * Receives the query builder instance, allowing modification before execution.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onFetching<TContext = OnFetchingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"fetching\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"hydrating\" event.\r\n   *\r\n   * Fired after raw records are fetched but before they are hydrated into model instances.\r\n   * Allows modification of raw data before hydration.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onHydrating<TContext = OnHydratingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"hydrating\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"fetched\" event.\r\n   *\r\n   * Fired after models have been fetched and hydrated.\r\n   * Receives hydrated model instances and query context.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onFetched<TContext = OnFetchedEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"fetched\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"restoring\" event.\r\n   *\r\n   * Fired before a soft-deleted model is restored.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onRestoring<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"restoring\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"restored\" event.\r\n   *\r\n   * Fired after a soft-deleted model has been successfully restored.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onRestored<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"restored\", listener);\r\n  }\r\n\r\n  /**\r\n   * Ensures a listener set exists for the given event.\r\n   *\r\n   * @param event - The event name\r\n   * @returns The listener set for the event\r\n   * @private\r\n   */\r\n  private ensureListenerSet(event: ModelEventName): Set<ModelEventListener<TModel>> {\r\n    let listeners = this.listeners.get(event);\r\n    if (!listeners) {\r\n      listeners = new Set();\r\n      this.listeners.set(event, listeners);\r\n    }\r\n    return listeners;\r\n  }\r\n}\r\n\r\n/**\r\n * Global event emitter invoked for every model instance, regardless of type.\r\n * Useful for cross-cutting concerns like auditing or request-scoped enrichment.\r\n */\r\nexport const globalModelEvents = new ModelEvents<Model>();\r\n"],"mappings":";;;;;;;;AA8EA,IAAa,cAAb,MAAiC;CAC/B,AAAgB,4BAAY,IAAI,IAAqD;;;;;CAMrF,AAAO,GACL,OACA,UACY;EAEZ,AADkB,KAAK,kBAAkB,KACjC,CAAC,CAAC,IAAI,QAAsC;EACpD,aAAa,KAAK,IAAI,OAAO,QAAQ;CACvC;;;;CAKA,AAAO,KACL,OACA,UACY;EACZ,MAAM,UAAgD,OAAO,OAAO,YAAY;GAC9E,IAAI;IACF,MAAM,SAAS,OAAO,OAAO;GAC/B,UAAU;IACR,KAAK,IAAI,OAAO,OAAO;GACzB;EACF;EACA,OAAO,KAAK,GAAG,OAAO,OAAO;CAC/B;;;;CAKA,AAAO,IACL,OACA,UACM;EACN,MAAM,YAAY,KAAK,UAAU,IAAI,KAAK;EAC1C,IAAI,CAAC,WACH;EAEF,UAAU,OAAO,QAAsC;EACvD,IAAI,UAAU,SAAS,GACrB,KAAK,UAAU,OAAO,KAAK;CAE/B;;;;CAKA,MAAa,KACX,OACA,OACA,SACe;EACf,MAAM,YAAY,KAAK,UAAU,IAAI,KAAK;EAC1C,IAAI,CAAC,aAAa,UAAU,SAAS,GACnC;EAEF,KAAK,MAAM,YAAY,MAAM,KAAK,SAAS,GACzC,MAAM,SAAS,OAAO,OAAO;CAEjC;;;;CAKA,MAAa,aACX,OACA,SACe;EACf,MAAM,KAAK,KAAK,YAAY,OAAc,OAAO;CACnD;;;;CAKA,AAAO,QAAc;EACnB,KAAK,UAAU,MAAM;CACvB;;;;;;;;;;CAWA,AAAO,SACL,UACY;EACZ,OAAO,KAAK,GAAG,UAAU,QAAQ;CACnC;;;;;;;;;CAUA,AAAO,QAA4B,UAA4D;EAC7F,OAAO,KAAK,GAAG,SAAS,QAAQ;CAClC;;;;;;;;;CAUA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;;CAUA,AAAO,UAA8B,UAA4D;EAC/F,OAAO,KAAK,GAAG,WAAW,QAAQ;CACpC;;;;;;;;;CAUA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;;CAUA,AAAO,UAA8B,UAA4D;EAC/F,OAAO,KAAK,GAAG,WAAW,QAAQ;CACpC;;;;;;;;;CAUA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;;CAUA,AAAO,UACL,UACY;EACZ,OAAO,KAAK,GAAG,WAAW,QAAQ;CACpC;;;;;;;;;CAUA,AAAO,aACL,UACY;EACZ,OAAO,KAAK,GAAG,cAAc,QAAQ;CACvC;;;;;;;;;CAUA,AAAO,YACL,UACY;EACZ,OAAO,KAAK,GAAG,aAAa,QAAQ;CACtC;;;;;;;;;;CAWA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;;;CAWA,AAAO,YACL,UACY;EACZ,OAAO,KAAK,GAAG,aAAa,QAAQ;CACtC;;;;;;;;;;CAWA,AAAO,UACL,UACY;EACZ,OAAO,KAAK,GAAG,WAAW,QAAQ;CACpC;;;;;;;;;CAUA,AAAO,YACL,UACY;EACZ,OAAO,KAAK,GAAG,aAAa,QAAQ;CACtC;;;;;;;;;CAUA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;CASA,AAAQ,kBAAkB,OAAwD;EAChF,IAAI,YAAY,KAAK,UAAU,IAAI,KAAK;EACxC,IAAI,CAAC,WAAW;GACd,4BAAY,IAAI,IAAI;GACpB,KAAK,UAAU,IAAI,OAAO,SAAS;EACrC;EACA,OAAO;CACT;AACF;;;;;AAMA,MAAa,oBAAoB,IAAI,YAAmB"}
+{"version":3,"file":"model-events.mjs","names":[],"sources":["../../../../../../../cascade/src/events/model-events.ts"],"sourcesContent":["import { type QueryBuilderContract } from \"../contracts\";\r\nimport type { Model } from \"../model/model\";\r\nimport { type DeleteStrategy } from \"../types\";\r\n\r\ntype OnValidatingEventContext = {\r\n  isInsert: boolean;\r\n  mode: \"insert\" | \"update\";\r\n};\r\n\r\ntype OnSavingEventContext = {\r\n  isInsert: boolean;\r\n  mode: \"insert\" | \"update\";\r\n};\r\n\r\ntype OnDeletingEventContext = {\r\n  strategy: DeleteStrategy;\r\n  primaryKeyValue: string | number;\r\n  primaryKey: string;\r\n};\r\n\r\nexport type OnDeletedEventContext = OnDeletingEventContext & {\r\n  deletedCount: number;\r\n  trashRecord?: Record<string, unknown>;\r\n};\r\n\r\ntype OnFetchingEventContext = {\r\n  table: string;\r\n  modelClass: any;\r\n};\r\n\r\ntype OnHydratingEventContext = {\r\n  query: QueryBuilderContract;\r\n  hydrateCallback?: (data: any, index: number) => any;\r\n};\r\n\r\ntype OnFetchedEventContext = {\r\n  query: QueryBuilderContract;\r\n  rawRecords: any[];\r\n  duration: number;\r\n};\r\n\r\n/**\r\n * Lifecycle events understood by Cascade models.\r\n *\r\n * The list mirrors the hooks in the legacy ORM so downstream code can subscribe\r\n * with consistent semantics.\r\n */\r\nexport type ModelEventName =\r\n  | \"fetching\"\r\n  | \"hydrating\"\r\n  | \"fetched\"\r\n  | \"validating\"\r\n  | \"validated\"\r\n  | \"saving\"\r\n  | \"saved\"\r\n  | \"creating\"\r\n  | \"created\"\r\n  | \"updating\"\r\n  | \"updated\"\r\n  | \"deleting\"\r\n  | \"deleted\"\r\n  | \"restoring\"\r\n  | \"restored\";\r\n\r\n/** Signature of an event listener registered against a model lifecycle hook. */\r\nexport type ModelEventListener<TModel, TContext = unknown> = (\r\n  model: TModel,\r\n  context: TContext,\r\n) => void | Promise<void>;\r\n\r\n/**\r\n * Light-weight async event emitter used to power model lifecycle hooks.\r\n *\r\n * The implementation intentionally avoids any external dependency so we can\r\n * re-use it in drivers, writers, and other core services without pulling in\r\n * heavier event libraries.\r\n */\r\nexport class ModelEvents<TModel> {\r\n  public readonly listeners = new Map<ModelEventName, Set<ModelEventListener<TModel>>>();\r\n\r\n  /**\r\n   * Register a listener for the given event.\r\n   * Returns an unsubscribe function for convenience.\r\n   */\r\n  public on<TContext = unknown>(\r\n    event: ModelEventName,\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    const listeners = this.ensureListenerSet(event);\r\n    listeners.add(listener as ModelEventListener<TModel>);\r\n    return () => this.off(event, listener);\r\n  }\r\n\r\n  /**\r\n   * Register a listener that automatically unsubscribes after the first call.\r\n   */\r\n  public once<TContext = unknown>(\r\n    event: ModelEventName,\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    const wrapper: ModelEventListener<TModel, TContext> = async (model, context) => {\r\n      try {\r\n        await listener(model, context);\r\n      } finally {\r\n        this.off(event, wrapper);\r\n      }\r\n    };\r\n    return this.on(event, wrapper);\r\n  }\r\n\r\n  /**\r\n   * Deregister a listener for the given event.\r\n   */\r\n  public off<TContext = unknown>(\r\n    event: ModelEventName,\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): void {\r\n    const listeners = this.listeners.get(event);\r\n    if (!listeners) {\r\n      return;\r\n    }\r\n    listeners.delete(listener as ModelEventListener<TModel>);\r\n    if (listeners.size === 0) {\r\n      this.listeners.delete(event);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Emit an event to all registered listeners.\r\n   */\r\n  public async emit<TContext = unknown>(\r\n    event: ModelEventName,\r\n    model: TModel,\r\n    context: TContext,\r\n  ): Promise<void> {\r\n    const listeners = this.listeners.get(event);\r\n    if (!listeners || listeners.size === 0) {\r\n      return;\r\n    }\r\n    for (const listener of Array.from(listeners)) {\r\n      await listener(model, context);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Emit events for fetching\r\n   */\r\n  public async emitFetching<TContext = unknown>(\r\n    query: QueryBuilderContract,\r\n    context?: TContext,\r\n  ): Promise<void> {\r\n    await this.emit(\"fetching\", query as any, context);\r\n  }\r\n\r\n  /**\r\n   * Remove all registered listeners.\r\n   */\r\n  public clear(): void {\r\n    this.listeners.clear();\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"saving\" event.\r\n   *\r\n   * Fired before a model is persisted (both insert and update), and before validation.\r\n   * Use this hook for data enrichment and preparation (e.g., setting createdBy, updatedBy).\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onSaving<TContext = OnSavingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"saving\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"saved\" event.\r\n   *\r\n   * Fired after a model has been successfully persisted.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onSaved<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void {\r\n    return this.on(\"saved\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"creating\" event.\r\n   *\r\n   * Fired before a new model is inserted into the database.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onCreating<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"creating\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"created\" event.\r\n   *\r\n   * Fired after a new model has been successfully inserted.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onCreated<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void {\r\n    return this.on(\"created\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"updating\" event.\r\n   *\r\n   * Fired before an existing model is updated in the database.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onUpdating<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"updating\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"updated\" event.\r\n   *\r\n   * Fired after an existing model has been successfully updated.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onUpdated<TContext = unknown>(listener: ModelEventListener<TModel, TContext>): () => void {\r\n    return this.on(\"updated\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"deleting\" event.\r\n   *\r\n   * Fired before a model is deleted from the database.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onDeleting<TContext = OnDeletingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"deleting\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"deleted\" event.\r\n   *\r\n   * Fired after a model has been successfully deleted.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onDeleted<TContext = OnDeletedEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"deleted\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"validating\" event.\r\n   *\r\n   * Fired before model validation is performed.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onValidating<TContext = OnValidatingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"validating\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"validated\" event.\r\n   *\r\n   * Fired after model validation has completed.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onValidated<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"validated\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"fetching\" event.\r\n   *\r\n   * Fired before a query is executed to fetch models.\r\n   * Receives the query builder instance, allowing modification before execution.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onFetching<TContext = OnFetchingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"fetching\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"hydrating\" event.\r\n   *\r\n   * Fired after raw records are fetched but before they are hydrated into model instances.\r\n   * Allows modification of raw data before hydration.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onHydrating<TContext = OnHydratingEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"hydrating\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"fetched\" event.\r\n   *\r\n   * Fired after models have been fetched and hydrated.\r\n   * Receives hydrated model instances and query context.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onFetched<TContext = OnFetchedEventContext>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"fetched\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"restoring\" event.\r\n   *\r\n   * Fired before a soft-deleted model is restored.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onRestoring<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"restoring\", listener);\r\n  }\r\n\r\n  /**\r\n   * Registers a listener for the \"restored\" event.\r\n   *\r\n   * Fired after a soft-deleted model has been successfully restored.\r\n   *\r\n   * @param listener - The callback to invoke\r\n   * @returns An unsubscribe function\r\n   */\r\n  public onRestored<TContext = unknown>(\r\n    listener: ModelEventListener<TModel, TContext>,\r\n  ): () => void {\r\n    return this.on(\"restored\", listener);\r\n  }\r\n\r\n  /**\r\n   * Ensures a listener set exists for the given event.\r\n   *\r\n   * @param event - The event name\r\n   * @returns The listener set for the event\r\n   * @private\r\n   */\r\n  private ensureListenerSet(event: ModelEventName): Set<ModelEventListener<TModel>> {\r\n    let listeners = this.listeners.get(event);\r\n    if (!listeners) {\r\n      listeners = new Set();\r\n      this.listeners.set(event, listeners);\r\n    }\r\n    return listeners;\r\n  }\r\n}\r\n\r\n/**\r\n * Global event emitter invoked for every model instance, regardless of type.\r\n * Useful for cross-cutting concerns like auditing or request-scoped enrichment.\r\n */\r\nexport const globalModelEvents = new ModelEvents<Model>();\r\n"],"mappings":";;;;;;;;AA6EA,IAAa,cAAb,MAAiC;CAC/B,AAAgB,4BAAY,IAAI,IAAqD;;;;;CAMrF,AAAO,GACL,OACA,UACY;EAEZ,AADkB,KAAK,kBAAkB,KACjC,CAAC,CAAC,IAAI,QAAsC;EACpD,aAAa,KAAK,IAAI,OAAO,QAAQ;CACvC;;;;CAKA,AAAO,KACL,OACA,UACY;EACZ,MAAM,UAAgD,OAAO,OAAO,YAAY;GAC9E,IAAI;IACF,MAAM,SAAS,OAAO,OAAO;GAC/B,UAAU;IACR,KAAK,IAAI,OAAO,OAAO;GACzB;EACF;EACA,OAAO,KAAK,GAAG,OAAO,OAAO;CAC/B;;;;CAKA,AAAO,IACL,OACA,UACM;EACN,MAAM,YAAY,KAAK,UAAU,IAAI,KAAK;EAC1C,IAAI,CAAC,WACH;EAEF,UAAU,OAAO,QAAsC;EACvD,IAAI,UAAU,SAAS,GACrB,KAAK,UAAU,OAAO,KAAK;CAE/B;;;;CAKA,MAAa,KACX,OACA,OACA,SACe;EACf,MAAM,YAAY,KAAK,UAAU,IAAI,KAAK;EAC1C,IAAI,CAAC,aAAa,UAAU,SAAS,GACnC;EAEF,KAAK,MAAM,YAAY,MAAM,KAAK,SAAS,GACzC,MAAM,SAAS,OAAO,OAAO;CAEjC;;;;CAKA,MAAa,aACX,OACA,SACe;EACf,MAAM,KAAK,KAAK,YAAY,OAAc,OAAO;CACnD;;;;CAKA,AAAO,QAAc;EACnB,KAAK,UAAU,MAAM;CACvB;;;;;;;;;;CAWA,AAAO,SACL,UACY;EACZ,OAAO,KAAK,GAAG,UAAU,QAAQ;CACnC;;;;;;;;;CAUA,AAAO,QAA4B,UAA4D;EAC7F,OAAO,KAAK,GAAG,SAAS,QAAQ;CAClC;;;;;;;;;CAUA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;;CAUA,AAAO,UAA8B,UAA4D;EAC/F,OAAO,KAAK,GAAG,WAAW,QAAQ;CACpC;;;;;;;;;CAUA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;;CAUA,AAAO,UAA8B,UAA4D;EAC/F,OAAO,KAAK,GAAG,WAAW,QAAQ;CACpC;;;;;;;;;CAUA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;;CAUA,AAAO,UACL,UACY;EACZ,OAAO,KAAK,GAAG,WAAW,QAAQ;CACpC;;;;;;;;;CAUA,AAAO,aACL,UACY;EACZ,OAAO,KAAK,GAAG,cAAc,QAAQ;CACvC;;;;;;;;;CAUA,AAAO,YACL,UACY;EACZ,OAAO,KAAK,GAAG,aAAa,QAAQ;CACtC;;;;;;;;;;CAWA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;;;CAWA,AAAO,YACL,UACY;EACZ,OAAO,KAAK,GAAG,aAAa,QAAQ;CACtC;;;;;;;;;;CAWA,AAAO,UACL,UACY;EACZ,OAAO,KAAK,GAAG,WAAW,QAAQ;CACpC;;;;;;;;;CAUA,AAAO,YACL,UACY;EACZ,OAAO,KAAK,GAAG,aAAa,QAAQ;CACtC;;;;;;;;;CAUA,AAAO,WACL,UACY;EACZ,OAAO,KAAK,GAAG,YAAY,QAAQ;CACrC;;;;;;;;CASA,AAAQ,kBAAkB,OAAwD;EAChF,IAAI,YAAY,KAAK,UAAU,IAAI,KAAK;EACxC,IAAI,CAAC,WAAW;GACd,4BAAY,IAAI,IAAI;GACpB,KAAK,UAAU,IAAI,OAAO,SAAS;EACrC;EACA,OAAO;CACT;AACF;;;;;AAMA,MAAa,oBAAoB,IAAI,YAAmB"}

package/esm/index.d.mts

@@ -13,7 +13,7 @@ import { EmbedKey, ModelSyncConfig, ModelSyncContract, ModelSyncOperationContrac
 import { Model } from "./model/model.mjs";
 import { ConnectionOptions, DatabaseDriver, ModelDefaultConfig, connectToDatabase, getDatabaseDriver, transaction } from "./utils/connect-to-database.mjs";
 import { ForeignKeyBuilder } from "./migration/foreign-key-builder.mjs";
-import { AlterSchema, ColumnMap, IndexEntry, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, OperationType, PendingOperation, UniqueEntry, migrate } from "./migration/migration.mjs";
+import { AlterSchema, ColumnMap, IndexEntry, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, MigrationStep, OperationType, PendingOperation, UniqueEntry, migrate } from "./migration/migration.mjs";
 import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, DriverQuery, GroupByInput, HavingInput, JoinOptions, LeanDocument, LockForUpdateOptions, OrderDirection, PaginationOptions, PaginationResult, QueryBuilderContract, RawExpression, UnwindOptions, WhereCallback, WhereObject, WhereOperator } from "./contracts/query-builder.contract.mjs";
 import { SyncAdapterContract } from "./contracts/sync-adapter.contract.mjs";
 import { AtomicUpdate, AtomicUpdateOptions, CreateDatabaseOptions, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverTransactionContract, DropDatabaseOptions, FindOneAndUpdateOptions, InsertResult, RawQueryResult, TransactionContext, UpdateOperations, UpdatePipeline, UpdateResult } from "./contracts/database-driver.contract.mjs";
@@ -24,6 +24,7 @@ import { BuildUpdateOperationsResult, WriterContract, WriterOptions, WriterResul
 import { DataSource, DataSourceOptions } from "./data-source/data-source.mjs";
 import { databaseDataSourceContext } from "./context/database-data-source-context.mjs";
 import { databaseTransactionContext } from "./context/database-transaction-context.mjs";
+import { afterCommit } from "./transactions/after-commit.mjs";
 import { DataSourceRegistryEvent, DataSourceRegistryListener, dataSourceRegistry } from "./data-source/data-source-registry.mjs";
 import { MissingDataSourceError } from "./errors/missing-data-source.error.mjs";
 import { TransactionRollbackError } from "./errors/transaction-rollback.error.mjs";
@@ -33,7 +34,7 @@ import { UnsafeRawExpressionError } from "./errors/unsafe-raw-expression.error.m
 import { UnsupportedLeanOperationError } from "./errors/unsupported-lean-operation.error.mjs";
 import { UnsupportedQueryOperationError } from "./errors/unsupported-query-operation.error.mjs";
 import { UnsupportedUpdateOperationError } from "./errors/unsupported-update-operation.error.mjs";
-import { ModelRef, RegisterModel, RegisterModelOptions, cleanupModelsRegistery, getAllModelsFromRegistry, getModelFromRegistry, registerModelInRegistry, removeModelFromRegistery, resolveModelClass, resolveModelName, tryResolveModelClass, verifyRegisteredRelations } from "./model/register-model.mjs";
+import { ModelRef, RegisterModel, RegisterModelOptions, cleanupModelsRegistery, getAllModelsFromRegistry, getModelFromRegistry, registerModelInRegistry, removeModelFromRegistery, requireModelClass, resolveModelClass, resolveModelName, tryResolveModelClass, verifyRegisteredRelations } from "./model/register-model.mjs";
 import { BelongsTo, BelongsToMany, HasMany, HasOne, RELATION_METADATA_KEY } from "./model/relation-decorators.mjs";
 import { DatabaseRemover } from "./remover/database-remover.mjs";
 import { DatabaseRestorer } from "./restorer/database-restorer.mjs";
@@ -58,21 +59,20 @@ import { ModelTransformCallback, useModelTransformer } from "./utils/database-wr
 import { DefineModelOptions, ModelType, defineModel } from "./utils/define-model.mjs";
 import { onceConnected, onceDisconnected } from "./utils/once-connected.mjs";
 import { MigrationRecord, MigrationResult, MigrationRunnerOptions, MigrationStatus, RollbackOptions, RunMigrationsOptions } from "./migration/types.mjs";
-import { MigrationRunner, migrationRunner } from "./migration/migration-runner.mjs";
+import { MigrationRunner, inferMigrationName, migrationRunner } from "./migration/migration-runner.mjs";
 import { CreateDatabaseResult, DropAllTablesResult, createDatabase, dropAllTables } from "./operations/database.mjs";
 import { ExportMigrationsSQLOptions, PendingMigration, RollbackMigrationsOptions, exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations } from "./operations/migrations.mjs";
 import { MongoMigrationDriver } from "./drivers/mongodb/mongodb-migration-driver.mjs";
 import { SqlDialectContract } from "./drivers/sql/sql-dialect.contract.mjs";
 import { SqlAggregateFunction, SqlDeleteOperation, SqlGroupClause, SqlHavingClause, SqlInsertOperation, SqlJoinClause, SqlJoinType, SqlOrderClause, SqlQueryConfig, SqlQueryResult, SqlSelectClause, SqlUpdateOperation, SqlWhereOperation, SqlWhereType } from "./drivers/sql/sql-types.mjs";
-import { PostgresDialect } from "./drivers/postgres/postgres-dialect.mjs";
+import { PostgresDialect, escapeSqlLiteral } from "./drivers/postgres/postgres-dialect.mjs";
 import { PostgresConnectionConfig, PostgresCopyOptions, PostgresIsolationLevel, PostgresNotification, PostgresOperation, PostgresPoolConfig, PostgresQueryResult, PostgresTransactionOptions, PostgresWhereClause } from "./drivers/postgres/types.mjs";
 import { PostgresDriver, buildPostgresPoolConfig } from "./drivers/postgres/postgres-driver.mjs";
 import { PostgresBlueprint } from "./drivers/postgres/postgres-blueprint.mjs";
 import { PostgresMigrationDriver } from "./drivers/postgres/postgres-migration-driver.mjs";
 import { PostgresQueryBuilder } from "./drivers/postgres/postgres-query-builder.mjs";
 import { PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresQueryParser } from "./drivers/postgres/postgres-query-parser.mjs";
-import { PostgresSyncAdapter } from "./drivers/postgres/postgres-sync-adapter.mjs";
 import { MongoClientOptions, TransactionOptions } from "mongodb";
-export { $agg, $expr, AggregateExpression, AggregateFunction, AlterSchema, ArithmeticExpression, AtomicUpdate, AtomicUpdateOptions, type BaseQueryRuleOptions, type BaseUniqueRuleOptions, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToOptions, BuildUpdateOperationsResult, type ChildModel, ChunkCallback, ColumnBuilder, ColumnDefinition, ColumnExpression, ColumnExpressionInput, ColumnExpressionType, ColumnMap, ColumnRefExpression, ColumnType, ConnectionOptions, CreateDatabaseOptions, CreateDatabaseResult, CursorPaginationOptions, CursorPaginationResult, DEFAULT_MAX_SYNC_DEPTH, DataSource, DataSourceOptions, DataSourceRegistryEvent, DataSourceRegistryListener, DatabaseDirtyTracker, DatabaseDriver, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DefineModelOptions, DeleteStrategy, DetachedColumnBuilder, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverQuery, DriverTransactionContract, DropAllTablesResult, DropDatabaseOptions, type EmbedKey, type ExistsRuleOptions, ExportMigrationsSQLOptions, FindOneAndUpdateOptions, ForeignKeyBuilder, ForeignKeyDefinition, FullTextIndexOptions, GenerateIdOptions, GeoIndexOptions, type GlobalScopeDefinition, type GlobalScopeOptions, GroupByInput, HasMany, type HasManyOptions, HasOne, type HasOneOptions, HavingInput, IdGeneratorContract, IndexDefinition, IndexEntry, InsertResult, JoinOptions, LeanDocument, LiteralExpression, type LoadedRelationResult, type LoadedRelationsMap, type LocalScopeCallback, LockForUpdateOptions, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, MigrationDefaults, MigrationDriverContract, MigrationDriverFactory, type MigrationRecord, type MigrationResult, MigrationRunner, type MigrationRunnerOptions, type MigrationStatus, MissingDataSourceError, Model, ModelDefaultConfig, ModelDefaults, ModelEventListener, ModelEventName, ModelEvents, ModelRef, type ModelSchema, type ModelSnapshot, type ModelSyncConfig, type ModelSyncContract, ModelSyncOperation, type ModelSyncOperationContract, ModelTransformCallback, ModelType, type MongoClientOptions, MongoDbDriver, MongoDriverOptions, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, NamingConvention, OnDeletedEventContext, Operation, OperationType, OrderDirection, PaginationOptions, PaginationResult, PendingMigration, PendingOperation, PipelineStage, type PivotData, type PivotIds, PivotOperations, PostgresBlueprint, PostgresConnectionConfig, PostgresCopyOptions, PostgresDialect, PostgresDriver, PostgresIsolationLevel, PostgresMigrationDriver, PostgresNotification, PostgresOperation, PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresPoolConfig, PostgresQueryBuilder, PostgresQueryParser, PostgresQueryResult, PostgresSyncAdapter, PostgresTransactionOptions, PostgresWhereClause, QueryBuilderContract, RELATION_METADATA_KEY, RawColumnExpression, RawExpression, RawQueryResult, RegisterModel, RegisterModelOptions, type RelationConstraintCallback, type RelationConstraints, RelationDefaults, type RelationDefinition, type RelationDefinitions, RelationHydrator, RelationLoader, type RelationType, RemoverContract, RemoverOptions, RemoverResult, RestorerContract, RestorerOptions, RestorerResult, RollbackMigrationsOptions, type RollbackOptions, type RunMigrationsOptions, type ScopeTiming, type SerializedRelation, SqlAggregateFunction, SqlDeleteOperation, SqlDialectContract, SqlGroupClause, SqlHavingClause, SqlInsertOperation, SqlJoinClause, SqlJoinType, SqlOrderClause, SqlQueryConfig, SqlQueryResult, SqlSelectClause, SqlUpdateOperation, SqlWhereOperation, SqlWhereType, StrictMode, SyncAdapterContract, type SyncConfig, type SyncContext, SyncContextManager, type SyncEventPayload, SyncInstruction, type SyncInstructionOptions, SyncManager, type SyncResult, type TableIndexInformation, TransactionContext, type TransactionOptions, TransactionRollbackError, UndefinedWhereValueError, UniqueEntry, type UniqueRuleOptions, UnsafeFilterError, UnsafeRawExpressionError, UnsupportedLeanOperationError, UnsupportedQueryOperationError, UnsupportedUpdateOperationError, UnwindOptions, UpdateOperations, UpdatePipeline, UpdateResult, UuidStrategy, VectorIndexOptions, WhereCallback, WhereObject, WhereOperator, WriterContract, WriterOptions, WriterResult, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, assertDefined, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };
+export { $agg, $expr, AggregateExpression, AggregateFunction, AlterSchema, ArithmeticExpression, AtomicUpdate, AtomicUpdateOptions, type BaseQueryRuleOptions, type BaseUniqueRuleOptions, BelongsTo, BelongsToMany, type BelongsToManyOptions, type BelongsToOptions, BuildUpdateOperationsResult, type ChildModel, ChunkCallback, ColumnBuilder, ColumnDefinition, ColumnExpression, ColumnExpressionInput, ColumnExpressionType, ColumnMap, ColumnRefExpression, ColumnType, ConnectionOptions, CreateDatabaseOptions, CreateDatabaseResult, CursorPaginationOptions, CursorPaginationResult, DEFAULT_MAX_SYNC_DEPTH, DataSource, DataSourceOptions, DataSourceRegistryEvent, DataSourceRegistryListener, DatabaseDirtyTracker, DatabaseDriver, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DefineModelOptions, DeleteStrategy, DetachedColumnBuilder, DriverAtomicUpdateOptions, DriverContract, DriverEvent, DriverEventListener, DriverQuery, DriverTransactionContract, DropAllTablesResult, DropDatabaseOptions, type EmbedKey, type ExistsRuleOptions, ExportMigrationsSQLOptions, FindOneAndUpdateOptions, ForeignKeyBuilder, ForeignKeyDefinition, FullTextIndexOptions, GenerateIdOptions, GeoIndexOptions, type GlobalScopeDefinition, type GlobalScopeOptions, GroupByInput, HasMany, type HasManyOptions, HasOne, type HasOneOptions, HavingInput, IdGeneratorContract, IndexDefinition, IndexEntry, InsertResult, JoinOptions, LeanDocument, LiteralExpression, type LoadedRelationResult, type LoadedRelationsMap, type LocalScopeCallback, LockForUpdateOptions, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, MigrationDefaults, MigrationDriverContract, MigrationDriverFactory, type MigrationRecord, type MigrationResult, MigrationRunner, type MigrationRunnerOptions, type MigrationStatus, MigrationStep, MissingDataSourceError, Model, ModelDefaultConfig, ModelDefaults, ModelEventListener, ModelEventName, ModelEvents, ModelRef, type ModelSchema, type ModelSnapshot, type ModelSyncConfig, type ModelSyncContract, ModelSyncOperation, type ModelSyncOperationContract, ModelTransformCallback, ModelType, type MongoClientOptions, MongoDbDriver, MongoDriverOptions, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, NamingConvention, OnDeletedEventContext, Operation, OperationType, OrderDirection, PaginationOptions, PaginationResult, PendingMigration, PendingOperation, PipelineStage, type PivotData, type PivotIds, PivotOperations, PostgresBlueprint, PostgresConnectionConfig, PostgresCopyOptions, PostgresDialect, PostgresDriver, PostgresIsolationLevel, PostgresMigrationDriver, PostgresNotification, PostgresOperation, PostgresOperationType, PostgresParserOperation, PostgresParserOptions, PostgresPoolConfig, PostgresQueryBuilder, PostgresQueryParser, PostgresQueryResult, PostgresTransactionOptions, PostgresWhereClause, QueryBuilderContract, RELATION_METADATA_KEY, RawColumnExpression, RawExpression, RawQueryResult, RegisterModel, RegisterModelOptions, type RelationConstraintCallback, type RelationConstraints, RelationDefaults, type RelationDefinition, type RelationDefinitions, RelationHydrator, RelationLoader, type RelationType, RemoverContract, RemoverOptions, RemoverResult, RestorerContract, RestorerOptions, RestorerResult, RollbackMigrationsOptions, type RollbackOptions, type RunMigrationsOptions, type ScopeTiming, type SerializedRelation, SqlAggregateFunction, SqlDeleteOperation, SqlDialectContract, SqlGroupClause, SqlHavingClause, SqlInsertOperation, SqlJoinClause, SqlJoinType, SqlOrderClause, SqlQueryConfig, SqlQueryResult, SqlSelectClause, SqlUpdateOperation, SqlWhereOperation, SqlWhereType, StrictMode, SyncAdapterContract, type SyncConfig, type SyncContext, SyncContextManager, type SyncEventPayload, SyncInstruction, type SyncInstructionOptions, SyncManager, type SyncResult, type TableIndexInformation, TransactionContext, type TransactionOptions, TransactionRollbackError, UndefinedWhereValueError, UniqueEntry, type UniqueRuleOptions, UnsafeFilterError, UnsafeRawExpressionError, UnsupportedLeanOperationError, UnsupportedQueryOperationError, UnsupportedUpdateOperationError, UnwindOptions, UpdateOperations, UpdatePipeline, UpdateResult, UuidStrategy, VectorIndexOptions, WhereCallback, WhereObject, WhereOperator, WriterContract, WriterOptions, WriterResult, afterCommit, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, assertDefined, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, escapeSqlLiteral, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, inferMigrationName, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, requireModelClass, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };
 import "./validation/plugins/database-rules-plugin.mjs";
 import "./validation/plugins/embed-validator-plugin.mjs";

package/esm/index.mjs

@@ -1,5 +1,6 @@
 import { databaseDataSourceContext } from "./context/database-data-source-context.mjs";
 import { databaseTransactionContext } from "./context/database-transaction-context.mjs";
+import { afterCommit } from "./transactions/after-commit.mjs";
 import { DataSource } from "./data-source/data-source.mjs";
 import { MissingDataSourceError } from "./errors/missing-data-source.error.mjs";
 import { dataSourceRegistry } from "./data-source/data-source-registry.mjs";
@@ -13,7 +14,7 @@ import { UnsupportedUpdateOperationError } from "./errors/unsupported-update-ope
 import { DatabaseDirtyTracker } from "./database-dirty-tracker.mjs";
 import { ModelEvents, globalModelEvents } from "./events/model-events.mjs";
 import { BelongsTo, BelongsToMany, HasMany, HasOne, RELATION_METADATA_KEY } from "./model/relation-decorators.mjs";
-import { RegisterModel, cleanupModelsRegistery, getAllModelsFromRegistry, getModelFromRegistry, registerModelInRegistry, removeModelFromRegistery, resolveModelClass, resolveModelName, tryResolveModelClass, verifyRegisteredRelations } from "./model/register-model.mjs";
+import { RegisterModel, cleanupModelsRegistery, getAllModelsFromRegistry, getModelFromRegistry, registerModelInRegistry, removeModelFromRegistery, requireModelClass, resolveModelClass, resolveModelName, tryResolveModelClass, verifyRegisteredRelations } from "./model/register-model.mjs";
 import { RelationLoader } from "./relations/relation-loader.mjs";
 import { DEFAULT_MAX_SYNC_DEPTH, SyncContextManager } from "./sync/sync-context.mjs";
 import { SyncManager } from "./sync/sync-manager.mjs";
@@ -38,11 +39,10 @@ import { MongoQueryBuilder } from "./drivers/mongodb/mongodb-query-builder.mjs";
 import { MongoSyncAdapter } from "./drivers/mongodb/mongodb-sync-adapter.mjs";
 import { MongoDbDriver, isMongoDBDriverLoaded } from "./drivers/mongodb/mongodb-driver.mjs";
 import { PostgresBlueprint } from "./drivers/postgres/postgres-blueprint.mjs";
-import { PostgresDialect } from "./drivers/postgres/postgres-dialect.mjs";
+import { PostgresDialect, escapeSqlLiteral } from "./drivers/postgres/postgres-dialect.mjs";
 import { PostgresMigrationDriver } from "./drivers/postgres/postgres-migration-driver.mjs";
 import { PostgresQueryParser } from "./drivers/postgres/postgres-query-parser.mjs";
 import { PostgresQueryBuilder } from "./drivers/postgres/postgres-query-builder.mjs";
-import { PostgresSyncAdapter } from "./drivers/postgres/postgres-sync-adapter.mjs";
 import { PostgresDriver, buildPostgresPoolConfig } from "./drivers/postgres/postgres-driver.mjs";
 import "./drivers/postgres/index.mjs";
 import { connectToDatabase, getDatabaseDriver, transaction } from "./utils/connect-to-database.mjs";
@@ -53,10 +53,10 @@ import { ColumnBuilder } from "./migration/column-builder.mjs";
 import { ForeignKeyBuilder } from "./migration/foreign-key-builder.mjs";
 import { DetachedColumnBuilder, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, bigInt, bigInteger, binary, blobCol, boolCol, char, date, dateTime, decimal, double, enumCol, float, geometry, int, integer, ipAddress, json, lineString, longText, macAddress, mediumText, objectCol, point, polygon, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, ulid, uuid, vector, year } from "./migration/column-helpers.mjs";
 import { Migration, migrate } from "./migration/migration.mjs";
-import { MigrationRunner, migrationRunner } from "./migration/migration-runner.mjs";
+import { MigrationRunner, inferMigrationName, migrationRunner } from "./migration/migration-runner.mjs";
 import "./migration/index.mjs";
 import { createDatabase, dropAllTables } from "./operations/database.mjs";
 import { exportMigrationsSQL, freshMigrate, listExecutedMigrations, listPendingMigrations, rollbackMigrations, runMigrations } from "./operations/migrations.mjs";
 import "./operations/index.mjs";
 
-export { $agg, $expr, BelongsTo, BelongsToMany, ColumnBuilder, DEFAULT_MAX_SYNC_DEPTH, DataSource, DatabaseDirtyTracker, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DetachedColumnBuilder, ForeignKeyBuilder, HasMany, HasOne, Migration, MigrationRunner, MissingDataSourceError, Model, ModelEvents, ModelSyncOperation, MongoDbDriver, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, PivotOperations, PostgresBlueprint, PostgresDialect, PostgresDriver, PostgresMigrationDriver, PostgresQueryBuilder, PostgresQueryParser, PostgresSyncAdapter, RELATION_METADATA_KEY, RegisterModel, RelationHydrator, RelationLoader, SyncContextManager, SyncManager, TransactionRollbackError, UndefinedWhereValueError, UnsafeFilterError, UnsafeRawExpressionError, UnsupportedLeanOperationError, UnsupportedQueryOperationError, UnsupportedUpdateOperationError, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, assertDefined, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };
+export { $agg, $expr, BelongsTo, BelongsToMany, ColumnBuilder, DEFAULT_MAX_SYNC_DEPTH, DataSource, DatabaseDirtyTracker, DatabaseRemover, DatabaseRestorer, DatabaseWriter, DatabaseWriterValidationError, DetachedColumnBuilder, ForeignKeyBuilder, HasMany, HasOne, Migration, MigrationRunner, MissingDataSourceError, Model, ModelEvents, ModelSyncOperation, MongoDbDriver, MongoIdGenerator, MongoMigrationDriver, MongoQueryBuilder, MongoSyncAdapter, PivotOperations, PostgresBlueprint, PostgresDialect, PostgresDriver, PostgresMigrationDriver, PostgresQueryBuilder, PostgresQueryParser, RELATION_METADATA_KEY, RegisterModel, RelationHydrator, RelationLoader, SyncContextManager, SyncManager, TransactionRollbackError, UndefinedWhereValueError, UnsafeFilterError, UnsafeRawExpressionError, UnsupportedLeanOperationError, UnsupportedQueryOperationError, UnsupportedUpdateOperationError, afterCommit, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, assertDefined, bigInt, bigInteger, binary, blobCol, boolCol as bool, boolCol, buildPostgresPoolConfig, char, cleanupModelsRegistery, connectToDatabase, createDatabase, createPivotOperations, dataSourceRegistry, databaseDataSourceContext, databaseTransactionContext, date, dateTime, decimal, defineModel, double, dropAllTables, enumCol, escapeRegex, escapeSqlLiteral, exportMigrationsSQL, float, freshMigrate, geometry, getAllModelsFromRegistry, getDatabaseDriver, getModelFromRegistry, globalModelEvents, inferMigrationName, int, integer, ipAddress, isAggregateExpression, isColumnExpression, isMongoDBDriverLoaded, json, likePatternToRegexSource, lineString, listExecutedMigrations, listPendingMigrations, longText, macAddress, mediumText, migrate, migrationRunner, modelSync, objectCol, onceConnected, onceDisconnected, point, polygon, registerModelInRegistry, removeModelFromRegistery, requireModelClass, resolveLikePattern, resolveModelClass, resolveModelName, rollbackMigrations, runMigrations, sanitizeFilter, sanitizeFilterValue, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, toColumnExpression, transaction, tryResolveModelClass, ulid, useModelTransformer, uuid, vector, verifyRegisteredRelations, year };

package/esm/migration/column-builder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"column-builder.d.mts","names":[],"sources":["../../../../../../../cascade/src/migration/column-builder.ts"],"mappings":";;;;;AAKgD;;KAM3C,aAAA;EACH,eAAA,CAAgB,KAAA;IAAS,OAAA;IAAmB,MAAA;EAAA;EAC5C,sBAAA,CAAuB,EAAA,EAAI,oBAAA;EAC3B,qBAAA,EAAuB,MAAA,UAAgB,OAAA,EAAS,IAAA,CAAK,kBAAA;AAAA;;;;;;;;;;;;AAA6B;AAqCpF;;;;;;;;;;cAAa,aAAA;EAAA,iBAmBQ,SAAA;EAklBK;EAAA,iBAnmBP,UAAA;EAmmBuB;EAAA,QAhmBhC,YAAA;EAHS;EAAA,QAMT,mBAAA;EAAA;;;;;;;;cAWW,SAAA,EAAW,aAAA,EAC5B,IAAA,UACA,IAAA,EAAM,UAAA,EACN,OAAA,GAAS,OAAA,CACP,IAAA,CAAK,gBAAA;EAAA;;;;;;;;;;EAyBF,QAAA;EAuIA;;;;;;;EA3HA,WAAA;EAoOA;;;;;;;;;;;;;;;;;EA1MA,OAAA,CAAQ,KAAA;EA0WC;;;;;;;;;;;AAqKwB;;;;EA1fjC,aAAA,CAAc,KAAA;;;;;;;;;;;;;EAkBd,UAAA;;;;;;;;;;;;;EAiBA,kBAAA;;;;;;;;;;;;;EAqBA,MAAA;;;;;;;;;;;;;EAoBA,KAAA;;;;;;;;;;;;;;EAoBA,WAAA,CAAY,OAAA,GAAS,IAAA,CAAK,kBAAA;;;;;;;;;;;EAwB1B,OAAA;;;;;;;;;;;;;;EAkBA,aAAA;;;;;;;;;;;;;EAqBA,QAAA;;;;;;;;;;;;;;EAsBA,OAAA,CAAQ,IAAA;;;;;;;;EAgBR,KAAA,CAAM,UAAA,UAAoB,IAAA;;;;;;;;;;;;;;EAyB1B,KAAA,CAAM,UAAA;;;;;;;;;;;;;EAiBN,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCA,UAAA,CAAW,YAAA;IAAyB,KAAA;EAAA;;;;;;;;;;;;;;EA2BpC,EAAA,CAAG,MAAA;;;;;;;;;;;;;;EAoBH,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;;EAoBjB,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;EAmBjB,UAAA;;;;;;;;;;;;;;;;;;;;;EAgCA,MAAA;;;;EAkCA,MAAA;;;;;;;;;;;;;;;;;;;;;;;EA8BA,WAAA,CAAY,UAAA;;;;;;;;EAYZ,MAAA;;;;;;;;EAiBA,OAAA;;;;;;;;EAqBA,aAAA,IAAiB,gBAAA;AAAA"}
+{"version":3,"file":"column-builder.d.mts","names":[],"sources":["../../../../../../../cascade/src/migration/column-builder.ts"],"mappings":";;;;;AAKgD;;KAM3C,aAAA;EACH,eAAA,CAAgB,KAAA;IAAS,OAAA;IAAmB,MAAA;EAAA;EAC5C,sBAAA,CAAuB,EAAA,EAAI,oBAAA;EAC3B,qBAAA,EAAuB,MAAA,UAAgB,OAAA,EAAS,IAAA,CAAK,kBAAA;AAAA;;;;;;;;;;;;AAA6B;AAqCpF;;;;;;;;;;cAAa,aAAA;EAAA,iBAmBQ,SAAA;EAslBK;EAAA,iBAvmBP,UAAA;EAumBuB;EAAA,QApmBhC,YAAA;EAHS;EAAA,QAMT,mBAAA;EAAA;;;;;;;;cAWW,SAAA,EAAW,aAAA,EAC5B,IAAA,UACA,IAAA,EAAM,UAAA,EACN,OAAA,GAAS,OAAA,CACP,IAAA,CAAK,gBAAA;EAAA;;;;;;;;;;EAyBF,QAAA;EAuIA;;;;;;;EA3HA,WAAA;EAoOA;;;;;;;;;;;;;;;;;EA1MA,OAAA,CAAQ,KAAA;EA0WC;;;;;;;;;;;AAyKwB;;;;EA9fjC,aAAA,CAAc,KAAA;;;;;;;;;;;;;EAkBd,UAAA;;;;;;;;;;;;;EAiBA,kBAAA;;;;;;;;;;;;;EAqBA,MAAA;;;;;;;;;;;;;EAoBA,KAAA;;;;;;;;;;;;;;EAoBA,WAAA,CAAY,OAAA,GAAS,IAAA,CAAK,kBAAA;;;;;;;;;;;EAwB1B,OAAA;;;;;;;;;;;;;;EAkBA,aAAA;;;;;;;;;;;;;EAqBA,QAAA;;;;;;;;;;;;;;EAsBA,OAAA,CAAQ,IAAA;;;;;;;;EAgBR,KAAA,CAAM,UAAA,UAAoB,IAAA;;;;;;;;;;;;;;EAyB1B,KAAA,CAAM,UAAA;;;;;;;;;;;;;EAiBN,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCA,UAAA,CAAW,YAAA;IAAyB,KAAA;EAAA;;;;;;;;;;;;;;EA2BpC,EAAA,CAAG,MAAA;;;;;;;;;;;;;;EAoBH,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;;EAoBjB,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;EAmBjB,UAAA;;;;;;;;;;;;;;;;;;;;;EAgCA,MAAA;;;;EAsCA,MAAA;;;;;;;;;;;;;;;;;;;;;;;EA8BA,WAAA,CAAY,UAAA;;;;;;;;EAYZ,MAAA;;;;;;;;EAiBA,OAAA;;;;;;;;EAqBA,aAAA,IAAiB,gBAAA;AAAA"}

package/esm/migration/column-builder.mjs

@@ -441,8 +441,8 @@ var ColumnBuilder = class {
 	*/
 	change() {
 		const operations = this.migration.pendingOperations;
-		const lastOp = operations[operations.length - 1];
-		if (lastOp?.type === "addColumn" && lastOp.payload === this.definition) operations.pop();
+		const addIndex = operations.findIndex((op) => op.type === "addColumn" && op.payload === this.definition);
+		if (addIndex !== -1) operations.splice(addIndex, 1);
 		let pendingFkOp;
 		if (this.fkDefinition) {
 			const tail = operations[operations.length - 1];

package/esm/migration/column-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"column-builder.mjs","names":[],"sources":["../../../../../../../cascade/src/migration/column-builder.ts"],"sourcesContent":["import type {\n  ColumnDefinition,\n  ColumnType,\n  ForeignKeyDefinition,\n  VectorIndexOptions,\n} from \"../contracts/migration-driver.contract\";\n\n/**\n * Reference to the Migration type to avoid circular imports.\n * The actual type is injected at runtime.\n */\ntype MigrationLike = {\n  addPendingIndex(index: { columns: string[]; unique?: boolean }): void;\n  addForeignKeyOperation(fk: ForeignKeyDefinition): void;\n  addPendingVectorIndex?(column: string, options: Omit<VectorIndexOptions, \"column\">): void;\n};\n\n/**\n * Mutable foreign key definition being built via ColumnBuilder.\n */\ninterface MutableForeignKeyDefinition {\n  name?: string;\n  column: string;\n  referencesTable: string;\n  referencesColumn: string;\n  onDelete: ForeignKeyDefinition[\"onDelete\"];\n  onUpdate: ForeignKeyDefinition[\"onUpdate\"];\n}\n\n/**\n * Fluent builder for defining column properties.\n *\n * Allows chaining modifiers like `.nullable()`, `.unique()`, `.default()`.\n * Each column builder is bound to a parent migration and accumulates\n * the column definition through method chains.\n *\n * @example\n * ```typescript\n * this.string(\"email\")\n *   .nullable()\n *   .unique()\n *   .default(\"guest@example.com\");\n * ```\n *\n * @example\n * ```typescript\n * this.integer(\"age\")\n *   .unsigned()\n *   .comment(\"User's age in years\");\n * ```\n */\nexport class ColumnBuilder {\n  /** Mutable column definition being accumulated */\n  private readonly definition: ColumnDefinition;\n\n  /** Mutable foreign key definition, set when .references() is called */\n  private fkDefinition?: MutableForeignKeyDefinition;\n\n  /** Temporary storage for generated expression before .stored() or .virtual() is called */\n  private generatedExpression?: string;\n\n  /**\n   * Create a new column builder.\n   *\n   * @param migration - Parent migration instance for index registration\n   * @param name - Column name\n   * @param type - Column data type\n   * @param options - Optional initial configuration\n   */\n  public constructor(\n    private readonly migration: MigrationLike,\n    name: string,\n    type: ColumnType,\n    options: Partial<\n      Pick<ColumnDefinition, \"length\" | \"precision\" | \"scale\" | \"dimensions\" | \"values\">\n    > = {},\n  ) {\n    this.definition = {\n      name,\n      type,\n      nullable: false,\n      ...options,\n    };\n  }\n\n  // ============================================================================\n  // NULLABILITY\n  // ============================================================================\n\n  /**\n   * Mark column as nullable (allows NULL values).\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"middleName\").nullable();\n   * ```\n   */\n  public nullable(): this {\n    this.definition.nullable = true;\n    return this;\n  }\n\n  /**\n   * Mark column as not nullable (disallows NULL values).\n   *\n   * This is the default, but can be used for clarity.\n   *\n   * @returns This builder for chaining\n   */\n  public notNullable(): this {\n    this.definition.nullable = false;\n    return this;\n  }\n\n  // ============================================================================\n  // DEFAULT VALUES\n  // ============================================================================\n\n  /**\n   * Set default value for the column as a raw SQL expression.\n   *\n   * The value will be used as-is in the SQL statement without escaping.\n   * Use this for database functions and expressions.\n   *\n   * @param value - Default value (SQL expression, number, or boolean)\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.uuid(\"id\").default(\"gen_random_uuid()\");\n   * this.timestamp(\"created_at\").default(\"NOW()\");\n   * this.integer(\"version\").default(1);\n   * this.boolean(\"is_active\").default(true);\n   * ```\n   */\n  public default(value: string | number | boolean): this {\n    this.definition.defaultValue = value;\n    this.definition.isRawDefault = true;\n    return this;\n  }\n\n  /**\n   * Set default value for the column as a literal string.\n   *\n   * The value will be properly escaped and quoted in the SQL statement.\n   * Use this for literal string values, not SQL expressions.\n   *\n   * @param value - Default string value (will be escaped)\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.text(\"status\").defaultString(\"active\");\n   * this.text(\"greeting\").defaultString(\"Hello, World!\");\n   * ```\n   */\n  public defaultString(value: string): this {\n    this.definition.defaultValue = value;\n    this.definition.isRawDefault = false;\n    return this;\n  }\n\n  /**\n   * Set default value to the current timestamp.\n   *\n   * Database-agnostic. Generates NOW() / CURRENT_TIMESTAMP / GETDATE() based on driver.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.timestamp(\"created_at\").useCurrent();\n   * ```\n   */\n  public useCurrent(): this {\n    this.definition.defaultValue = { __type: \"CURRENT_TIMESTAMP\" };\n    return this;\n  }\n\n  /**\n   * Set column to update to current timestamp on row update.\n   *\n   * MySQL only. Other databases ignore this.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.timestamp(\"updated_at\").useCurrent().useCurrentOnUpdate();\n   * ```\n   */\n  public useCurrentOnUpdate(): this {\n    this.definition.onUpdateCurrent = true;\n    return this;\n  }\n\n  // ============================================================================\n  // INDEXES\n  // ============================================================================\n\n  /**\n   * Add unique constraint/index on this column.\n   *\n   * Registers a pending unique index with the parent migration.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"email\").unique();\n   * ```\n   */\n  public unique(): this {\n    this.migration.addPendingIndex({\n      columns: [this.definition.name],\n      unique: true,\n    });\n    return this;\n  }\n\n  /**\n   * Add regular index on this column.\n   *\n   * Registers a pending index with the parent migration.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"email\").index();\n   * ```\n   */\n  public index(): this {\n    this.migration.addPendingIndex({\n      columns: [this.definition.name],\n    });\n    return this;\n  }\n\n  /**\n   * Add a vector search index on this column.\n   *\n   * Registers a pending vector index with the parent migration.\n   *\n   * @param options - Vector index options\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.vector(1536).vectorIndex({ similarity: \"cosine\" });\n   * ```\n   */\n  public vectorIndex(options: Omit<VectorIndexOptions, \"dimensions\"> = {}): this {\n    if (this.migration.addPendingVectorIndex) {\n      this.migration.addPendingVectorIndex(this.definition.name, {\n        ...options,\n        dimensions: this.definition.dimensions || 0,\n      });\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // PRIMARY KEY & AUTO INCREMENT\n  // ============================================================================\n\n  /**\n   * Mark as primary key.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary();\n   * ```\n   */\n  public primary(): this {\n    this.definition.primary = true;\n    return this;\n  }\n\n  /**\n   * Mark as auto-increment (numeric types only).\n   *\n   * SQL databases will use native AUTO_INCREMENT/SERIAL.\n   * NoSQL databases ignore this.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary().autoIncrement();\n   * ```\n   */\n  public autoIncrement(): this {\n    this.definition.autoIncrement = true;\n    return this;\n  }\n\n  // ============================================================================\n  // NUMERIC MODIFIERS\n  // ============================================================================\n\n  /**\n   * Mark as unsigned (numeric types only).\n   *\n   * Disallows negative values and doubles the positive range.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"age\").unsigned();\n   * ```\n   */\n  public unsigned(): this {\n    this.definition.unsigned = true;\n    return this;\n  }\n\n  // ============================================================================\n  // METADATA\n  // ============================================================================\n\n  /**\n   * Add comment/description to column.\n   *\n   * Stored as column metadata in the database.\n   *\n   * @param text - Comment text\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"sku\").comment(\"Stock Keeping Unit code\");\n   * ```\n   */\n  public comment(text: string): this {\n    this.definition.comment = text;\n    return this;\n  }\n\n  // ============================================================================\n  // CONSTRAINTS\n  // ============================================================================\n\n  /**\n   * Add a CHECK constraint scoped to this column.\n   *\n   * @param expression - SQL CHECK expression (can reference the column by name)\n   * @param name - Constraint name (defaults to `check_<column>`)\n   * @returns This builder for chaining\n   */\n  public check(expression: string, name?: string): this {\n    this.definition.checkConstraint = {\n      expression,\n      name: name ?? `check_${this.definition.name}`,\n    };\n    return this;\n  }\n\n  // ============================================================================\n  // COLUMN POSITIONING (MySQL/MariaDB only)\n  // ============================================================================\n\n  /**\n   * Position this column after another column.\n   *\n   * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.\n   *\n   * @param columnName - Column to position after\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"middle_name\").after(\"first_name\");\n   * ```\n   */\n  public after(columnName: string): this {\n    this.definition.after = columnName;\n    return this;\n  }\n\n  /**\n   * Position this column as the first column in the table.\n   *\n   * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary().first();\n   * ```\n   */\n  public first(): this {\n    this.definition.first = true;\n    return this;\n  }\n\n  // ============================================================================\n  // FOREIGN KEY\n  // ============================================================================\n\n  /**\n   * Declare a foreign key constraint on this column.\n   *\n   * Accepts either a raw table-name string or a Model class (anything with a\n   * static `table` property). Using a Model class is preferred — it is\n   * type-safe and automatically tracks table renames.\n   *\n   * Pushes an `addForeignKey` operation immediately using a mutable reference —\n   * subsequent `.on()`, `.onDelete()`, `.onUpdate()` calls mutate the same\n   * definition that is already queued, so no `.add()` terminator is needed.\n   *\n   * Referenced column defaults to `\"id\"` — use `.on()` to override.\n   *\n   * @param tableOrModel - Referenced table name OR a Model class with a static `table` property\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * // Preferred — model class reference (type-safe, rename-proof)\n   * this.uuid(\"organization_id\").references(Organization).onDelete(\"cascade\");\n   *\n   * // Also supported — raw table string\n   * this.uuid(\"organization_id\").references(\"organizations\").onDelete(\"cascade\");\n   * this.uuid(\"organization_id\").references(Organization.table).onDelete(\"cascade\");\n   * ```\n   */\n  public references(tableOrModel: string | { table: string }): this {\n    const tableName = typeof tableOrModel === \"string\" ? tableOrModel : tableOrModel.table;\n\n    this.fkDefinition = {\n      column: this.definition.name,\n      referencesTable: tableName,\n      referencesColumn: \"id\",\n      onDelete: \"restrict\",\n      onUpdate: \"restrict\",\n    };\n    this.migration.addForeignKeyOperation(this.fkDefinition as ForeignKeyDefinition);\n    return this;\n  }\n\n  /**\n   * Set the referenced column for the foreign key.\n   *\n   * Only meaningful after `.references()`. Defaults to `\"id\"` if omitted.\n   *\n   * @param column - Referenced column name\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").on(\"custom_id\");\n   * ```\n   */\n  public on(column: string): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.referencesColumn = column;\n    }\n    return this;\n  }\n\n  /**\n   * Set the ON DELETE action for the foreign key.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @param action - Action when the referenced row is deleted\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").onDelete(\"cascade\");\n   * ```\n   */\n  public onDelete(action: ForeignKeyDefinition[\"onDelete\"]): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onDelete = action;\n    }\n    return this;\n  }\n\n  /**\n   * Set the ON UPDATE action for the foreign key.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @param action - Action when the referenced row's key is updated\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").onUpdate(\"cascade\");\n   * ```\n   */\n  public onUpdate(action: ForeignKeyDefinition[\"onUpdate\"]): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onUpdate = action;\n    }\n    return this;\n  }\n\n  /**\n   * Shorthand for `.onDelete(\"cascade\").onUpdate(\"cascade\")`.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").cascadeAll();\n   * ```\n   */\n  public cascadeAll(): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onDelete = \"cascade\";\n      this.fkDefinition.onUpdate = \"cascade\";\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // COLUMN MODIFICATION\n  // ============================================================================\n\n  /**\n   * Mark this column definition as a modification of an existing column.\n   *\n   * Pushes a `modifyColumn` operation instead of `addColumn`.\n   * This method breaks the builder chain and returns the parent migration.\n   *\n   * @returns The parent migration instance (breaks builder chain)\n   *\n   * @example\n   * ```typescript\n   * // Make email nullable\n   * this.string(\"email\").nullable().change();\n   *\n   * // Increase length\n   * this.string(\"name\", 255).change();\n   *\n   * // Change type\n   * this.text(\"description\").change();\n   * ```\n   */\n  public change(): unknown {\n    const operations = (this.migration as any).pendingOperations;\n\n    // Remove the addColumn pushed by the column type method (e.g. uuid(), string())\n    const lastOp = operations[operations.length - 1];\n    if (lastOp?.type === \"addColumn\" && lastOp.payload === this.definition) {\n      operations.pop();\n    }\n\n    // If .references() was called before .change(), the addForeignKey op is now\n    // last in the queue. We must pop it, push modifyColumn first, then re-push\n    // the FK — because SQL requires: ALTER COLUMN (type change) → ADD CONSTRAINT (FK).\n    let pendingFkOp: (typeof operations)[number] | undefined;\n    if (this.fkDefinition) {\n      const tail = operations[operations.length - 1];\n      if (tail?.type === \"addForeignKey\" && tail.payload === this.fkDefinition) {\n        pendingFkOp = operations.pop();\n      }\n    }\n\n    // Push modifyColumn — it must precede the FK constraint\n    operations.push({ type: \"modifyColumn\", payload: this.definition });\n\n    // Re-queue the FK after the column modification\n    if (pendingFkOp) {\n      operations.push(pendingFkOp);\n    }\n\n    return this.migration;\n  }\n\n  /**\n   * @alias change\n   */\n  public modify(): unknown {\n    return this.change();\n  }\n\n  // ============================================================================\n  // GENERATED COLUMNS\n  // ============================================================================\n\n  /**\n   * Mark this column as a generated column with the given SQL expression.\n   *\n   * Must be followed by `.stored()` or `.virtual()` to specify storage type.\n   *\n   * PostgreSQL: GENERATED ALWAYS AS (...) STORED\n   * MySQL: GENERATED ALWAYS AS (...) STORED | VIRTUAL\n   *\n   * @param expression - SQL expression to compute the value\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"full_name\")\n   *   .generatedAs(\"CONCAT(first_name, ' ', last_name)\")\n   *   .stored();\n   *\n   * this.decimal(\"price_with_tax\")\n   *   .generatedAs(\"price * 1.2\")\n   *   .virtual();\n   * ```\n   */\n  public generatedAs(expression: string): this {\n    this.generatedExpression = expression;\n    return this;\n  }\n\n  /**\n   * Mark the generated column as stored (computed and persisted to disk).\n   *\n   * Must be called after `.generatedAs()`.\n   *\n   * @returns This builder for chaining\n   */\n  public stored(): this {\n    if (this.generatedExpression) {\n      this.definition.generated = {\n        expression: this.generatedExpression,\n        stored: true,\n      };\n    }\n    return this;\n  }\n\n  /**\n   * Mark the generated column as virtual (computed on read, not stored).\n   *\n   * Must be called after `.generatedAs()`. Not supported by PostgreSQL.\n   *\n   * @returns This builder for chaining\n   */\n  public virtual(): this {\n    if (this.generatedExpression) {\n      this.definition.generated = {\n        expression: this.generatedExpression,\n        stored: false,\n      };\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // ACCESSOR\n  // ============================================================================\n\n  /**\n   * Get the built column definition.\n   *\n   * Called internally by the Migration class to extract the final definition.\n   *\n   * @returns The accumulated column definition\n   */\n  public getDefinition(): ColumnDefinition {\n    return this.definition;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"column-builder.mjs","names":[],"sources":["../../../../../../../cascade/src/migration/column-builder.ts"],"sourcesContent":["import type {\n  ColumnDefinition,\n  ColumnType,\n  ForeignKeyDefinition,\n  VectorIndexOptions,\n} from \"../contracts/migration-driver.contract\";\n\n/**\n * Reference to the Migration type to avoid circular imports.\n * The actual type is injected at runtime.\n */\ntype MigrationLike = {\n  addPendingIndex(index: { columns: string[]; unique?: boolean }): void;\n  addForeignKeyOperation(fk: ForeignKeyDefinition): void;\n  addPendingVectorIndex?(column: string, options: Omit<VectorIndexOptions, \"column\">): void;\n};\n\n/**\n * Mutable foreign key definition being built via ColumnBuilder.\n */\ninterface MutableForeignKeyDefinition {\n  name?: string;\n  column: string;\n  referencesTable: string;\n  referencesColumn: string;\n  onDelete: ForeignKeyDefinition[\"onDelete\"];\n  onUpdate: ForeignKeyDefinition[\"onUpdate\"];\n}\n\n/**\n * Fluent builder for defining column properties.\n *\n * Allows chaining modifiers like `.nullable()`, `.unique()`, `.default()`.\n * Each column builder is bound to a parent migration and accumulates\n * the column definition through method chains.\n *\n * @example\n * ```typescript\n * this.string(\"email\")\n *   .nullable()\n *   .unique()\n *   .default(\"guest@example.com\");\n * ```\n *\n * @example\n * ```typescript\n * this.integer(\"age\")\n *   .unsigned()\n *   .comment(\"User's age in years\");\n * ```\n */\nexport class ColumnBuilder {\n  /** Mutable column definition being accumulated */\n  private readonly definition: ColumnDefinition;\n\n  /** Mutable foreign key definition, set when .references() is called */\n  private fkDefinition?: MutableForeignKeyDefinition;\n\n  /** Temporary storage for generated expression before .stored() or .virtual() is called */\n  private generatedExpression?: string;\n\n  /**\n   * Create a new column builder.\n   *\n   * @param migration - Parent migration instance for index registration\n   * @param name - Column name\n   * @param type - Column data type\n   * @param options - Optional initial configuration\n   */\n  public constructor(\n    private readonly migration: MigrationLike,\n    name: string,\n    type: ColumnType,\n    options: Partial<\n      Pick<ColumnDefinition, \"length\" | \"precision\" | \"scale\" | \"dimensions\" | \"values\">\n    > = {},\n  ) {\n    this.definition = {\n      name,\n      type,\n      nullable: false,\n      ...options,\n    };\n  }\n\n  // ============================================================================\n  // NULLABILITY\n  // ============================================================================\n\n  /**\n   * Mark column as nullable (allows NULL values).\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"middleName\").nullable();\n   * ```\n   */\n  public nullable(): this {\n    this.definition.nullable = true;\n    return this;\n  }\n\n  /**\n   * Mark column as not nullable (disallows NULL values).\n   *\n   * This is the default, but can be used for clarity.\n   *\n   * @returns This builder for chaining\n   */\n  public notNullable(): this {\n    this.definition.nullable = false;\n    return this;\n  }\n\n  // ============================================================================\n  // DEFAULT VALUES\n  // ============================================================================\n\n  /**\n   * Set default value for the column as a raw SQL expression.\n   *\n   * The value will be used as-is in the SQL statement without escaping.\n   * Use this for database functions and expressions.\n   *\n   * @param value - Default value (SQL expression, number, or boolean)\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.uuid(\"id\").default(\"gen_random_uuid()\");\n   * this.timestamp(\"created_at\").default(\"NOW()\");\n   * this.integer(\"version\").default(1);\n   * this.boolean(\"is_active\").default(true);\n   * ```\n   */\n  public default(value: string | number | boolean): this {\n    this.definition.defaultValue = value;\n    this.definition.isRawDefault = true;\n    return this;\n  }\n\n  /**\n   * Set default value for the column as a literal string.\n   *\n   * The value will be properly escaped and quoted in the SQL statement.\n   * Use this for literal string values, not SQL expressions.\n   *\n   * @param value - Default string value (will be escaped)\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.text(\"status\").defaultString(\"active\");\n   * this.text(\"greeting\").defaultString(\"Hello, World!\");\n   * ```\n   */\n  public defaultString(value: string): this {\n    this.definition.defaultValue = value;\n    this.definition.isRawDefault = false;\n    return this;\n  }\n\n  /**\n   * Set default value to the current timestamp.\n   *\n   * Database-agnostic. Generates NOW() / CURRENT_TIMESTAMP / GETDATE() based on driver.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.timestamp(\"created_at\").useCurrent();\n   * ```\n   */\n  public useCurrent(): this {\n    this.definition.defaultValue = { __type: \"CURRENT_TIMESTAMP\" };\n    return this;\n  }\n\n  /**\n   * Set column to update to current timestamp on row update.\n   *\n   * MySQL only. Other databases ignore this.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.timestamp(\"updated_at\").useCurrent().useCurrentOnUpdate();\n   * ```\n   */\n  public useCurrentOnUpdate(): this {\n    this.definition.onUpdateCurrent = true;\n    return this;\n  }\n\n  // ============================================================================\n  // INDEXES\n  // ============================================================================\n\n  /**\n   * Add unique constraint/index on this column.\n   *\n   * Registers a pending unique index with the parent migration.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"email\").unique();\n   * ```\n   */\n  public unique(): this {\n    this.migration.addPendingIndex({\n      columns: [this.definition.name],\n      unique: true,\n    });\n    return this;\n  }\n\n  /**\n   * Add regular index on this column.\n   *\n   * Registers a pending index with the parent migration.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"email\").index();\n   * ```\n   */\n  public index(): this {\n    this.migration.addPendingIndex({\n      columns: [this.definition.name],\n    });\n    return this;\n  }\n\n  /**\n   * Add a vector search index on this column.\n   *\n   * Registers a pending vector index with the parent migration.\n   *\n   * @param options - Vector index options\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.vector(1536).vectorIndex({ similarity: \"cosine\" });\n   * ```\n   */\n  public vectorIndex(options: Omit<VectorIndexOptions, \"dimensions\"> = {}): this {\n    if (this.migration.addPendingVectorIndex) {\n      this.migration.addPendingVectorIndex(this.definition.name, {\n        ...options,\n        dimensions: this.definition.dimensions || 0,\n      });\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // PRIMARY KEY & AUTO INCREMENT\n  // ============================================================================\n\n  /**\n   * Mark as primary key.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary();\n   * ```\n   */\n  public primary(): this {\n    this.definition.primary = true;\n    return this;\n  }\n\n  /**\n   * Mark as auto-increment (numeric types only).\n   *\n   * SQL databases will use native AUTO_INCREMENT/SERIAL.\n   * NoSQL databases ignore this.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary().autoIncrement();\n   * ```\n   */\n  public autoIncrement(): this {\n    this.definition.autoIncrement = true;\n    return this;\n  }\n\n  // ============================================================================\n  // NUMERIC MODIFIERS\n  // ============================================================================\n\n  /**\n   * Mark as unsigned (numeric types only).\n   *\n   * Disallows negative values and doubles the positive range.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"age\").unsigned();\n   * ```\n   */\n  public unsigned(): this {\n    this.definition.unsigned = true;\n    return this;\n  }\n\n  // ============================================================================\n  // METADATA\n  // ============================================================================\n\n  /**\n   * Add comment/description to column.\n   *\n   * Stored as column metadata in the database.\n   *\n   * @param text - Comment text\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"sku\").comment(\"Stock Keeping Unit code\");\n   * ```\n   */\n  public comment(text: string): this {\n    this.definition.comment = text;\n    return this;\n  }\n\n  // ============================================================================\n  // CONSTRAINTS\n  // ============================================================================\n\n  /**\n   * Add a CHECK constraint scoped to this column.\n   *\n   * @param expression - SQL CHECK expression (can reference the column by name)\n   * @param name - Constraint name (defaults to `check_<column>`)\n   * @returns This builder for chaining\n   */\n  public check(expression: string, name?: string): this {\n    this.definition.checkConstraint = {\n      expression,\n      name: name ?? `check_${this.definition.name}`,\n    };\n    return this;\n  }\n\n  // ============================================================================\n  // COLUMN POSITIONING (MySQL/MariaDB only)\n  // ============================================================================\n\n  /**\n   * Position this column after another column.\n   *\n   * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.\n   *\n   * @param columnName - Column to position after\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"middle_name\").after(\"first_name\");\n   * ```\n   */\n  public after(columnName: string): this {\n    this.definition.after = columnName;\n    return this;\n  }\n\n  /**\n   * Position this column as the first column in the table.\n   *\n   * MySQL/MariaDB only. Ignored by PostgreSQL and NoSQL drivers.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"id\").primary().first();\n   * ```\n   */\n  public first(): this {\n    this.definition.first = true;\n    return this;\n  }\n\n  // ============================================================================\n  // FOREIGN KEY\n  // ============================================================================\n\n  /**\n   * Declare a foreign key constraint on this column.\n   *\n   * Accepts either a raw table-name string or a Model class (anything with a\n   * static `table` property). Using a Model class is preferred — it is\n   * type-safe and automatically tracks table renames.\n   *\n   * Pushes an `addForeignKey` operation immediately using a mutable reference —\n   * subsequent `.on()`, `.onDelete()`, `.onUpdate()` calls mutate the same\n   * definition that is already queued, so no `.add()` terminator is needed.\n   *\n   * Referenced column defaults to `\"id\"` — use `.on()` to override.\n   *\n   * @param tableOrModel - Referenced table name OR a Model class with a static `table` property\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * // Preferred — model class reference (type-safe, rename-proof)\n   * this.uuid(\"organization_id\").references(Organization).onDelete(\"cascade\");\n   *\n   * // Also supported — raw table string\n   * this.uuid(\"organization_id\").references(\"organizations\").onDelete(\"cascade\");\n   * this.uuid(\"organization_id\").references(Organization.table).onDelete(\"cascade\");\n   * ```\n   */\n  public references(tableOrModel: string | { table: string }): this {\n    const tableName = typeof tableOrModel === \"string\" ? tableOrModel : tableOrModel.table;\n\n    this.fkDefinition = {\n      column: this.definition.name,\n      referencesTable: tableName,\n      referencesColumn: \"id\",\n      onDelete: \"restrict\",\n      onUpdate: \"restrict\",\n    };\n    this.migration.addForeignKeyOperation(this.fkDefinition as ForeignKeyDefinition);\n    return this;\n  }\n\n  /**\n   * Set the referenced column for the foreign key.\n   *\n   * Only meaningful after `.references()`. Defaults to `\"id\"` if omitted.\n   *\n   * @param column - Referenced column name\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").on(\"custom_id\");\n   * ```\n   */\n  public on(column: string): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.referencesColumn = column;\n    }\n    return this;\n  }\n\n  /**\n   * Set the ON DELETE action for the foreign key.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @param action - Action when the referenced row is deleted\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").onDelete(\"cascade\");\n   * ```\n   */\n  public onDelete(action: ForeignKeyDefinition[\"onDelete\"]): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onDelete = action;\n    }\n    return this;\n  }\n\n  /**\n   * Set the ON UPDATE action for the foreign key.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @param action - Action when the referenced row's key is updated\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").onUpdate(\"cascade\");\n   * ```\n   */\n  public onUpdate(action: ForeignKeyDefinition[\"onUpdate\"]): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onUpdate = action;\n    }\n    return this;\n  }\n\n  /**\n   * Shorthand for `.onDelete(\"cascade\").onUpdate(\"cascade\")`.\n   *\n   * Only meaningful after `.references()`.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.integer(\"user_id\").references(\"users\").cascadeAll();\n   * ```\n   */\n  public cascadeAll(): this {\n    if (this.fkDefinition) {\n      this.fkDefinition.onDelete = \"cascade\";\n      this.fkDefinition.onUpdate = \"cascade\";\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // COLUMN MODIFICATION\n  // ============================================================================\n\n  /**\n   * Mark this column definition as a modification of an existing column.\n   *\n   * Pushes a `modifyColumn` operation instead of `addColumn`.\n   * This method breaks the builder chain and returns the parent migration.\n   *\n   * @returns The parent migration instance (breaks builder chain)\n   *\n   * @example\n   * ```typescript\n   * // Make email nullable\n   * this.string(\"email\").nullable().change();\n   *\n   * // Increase length\n   * this.string(\"name\", 255).change();\n   *\n   * // Change type\n   * this.text(\"description\").change();\n   * ```\n   */\n  public change(): unknown {\n    const operations = (this.migration as any).pendingOperations;\n\n    // Remove the addColumn pushed by the column type method (e.g. uuid(), string())\n    // (by identity, anywhere in the queue: .unique()/.index() may have pushed ops after it)\n    const addIndex = operations.findIndex(\n      (op: { type: string; payload: unknown }) =>\n        op.type === \"addColumn\" && op.payload === this.definition,\n    );\n    if (addIndex !== -1) {\n      operations.splice(addIndex, 1);\n    }\n\n    // If .references() was called before .change(), the addForeignKey op is now\n    // last in the queue. We must pop it, push modifyColumn first, then re-push\n    // the FK — because SQL requires: ALTER COLUMN (type change) → ADD CONSTRAINT (FK).\n    let pendingFkOp: (typeof operations)[number] | undefined;\n    if (this.fkDefinition) {\n      const tail = operations[operations.length - 1];\n      if (tail?.type === \"addForeignKey\" && tail.payload === this.fkDefinition) {\n        pendingFkOp = operations.pop();\n      }\n    }\n\n    // Push modifyColumn — it must precede the FK constraint\n    operations.push({ type: \"modifyColumn\", payload: this.definition });\n\n    // Re-queue the FK after the column modification\n    if (pendingFkOp) {\n      operations.push(pendingFkOp);\n    }\n\n    return this.migration;\n  }\n\n  /**\n   * @alias change\n   */\n  public modify(): unknown {\n    return this.change();\n  }\n\n  // ============================================================================\n  // GENERATED COLUMNS\n  // ============================================================================\n\n  /**\n   * Mark this column as a generated column with the given SQL expression.\n   *\n   * Must be followed by `.stored()` or `.virtual()` to specify storage type.\n   *\n   * PostgreSQL: GENERATED ALWAYS AS (...) STORED\n   * MySQL: GENERATED ALWAYS AS (...) STORED | VIRTUAL\n   *\n   * @param expression - SQL expression to compute the value\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.string(\"full_name\")\n   *   .generatedAs(\"CONCAT(first_name, ' ', last_name)\")\n   *   .stored();\n   *\n   * this.decimal(\"price_with_tax\")\n   *   .generatedAs(\"price * 1.2\")\n   *   .virtual();\n   * ```\n   */\n  public generatedAs(expression: string): this {\n    this.generatedExpression = expression;\n    return this;\n  }\n\n  /**\n   * Mark the generated column as stored (computed and persisted to disk).\n   *\n   * Must be called after `.generatedAs()`.\n   *\n   * @returns This builder for chaining\n   */\n  public stored(): this {\n    if (this.generatedExpression) {\n      this.definition.generated = {\n        expression: this.generatedExpression,\n        stored: true,\n      };\n    }\n    return this;\n  }\n\n  /**\n   * Mark the generated column as virtual (computed on read, not stored).\n   *\n   * Must be called after `.generatedAs()`. Not supported by PostgreSQL.\n   *\n   * @returns This builder for chaining\n   */\n  public virtual(): this {\n    if (this.generatedExpression) {\n      this.definition.generated = {\n        expression: this.generatedExpression,\n        stored: false,\n      };\n    }\n    return this;\n  }\n\n  // ============================================================================\n  // ACCESSOR\n  // ============================================================================\n\n  /**\n   * Get the built column definition.\n   *\n   * Called internally by the Migration class to extract the final definition.\n   *\n   * @returns The accumulated column definition\n   */\n  public getDefinition(): ColumnDefinition {\n    return this.definition;\n  }\n}\n"],"mappings":"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"}

package/esm/migration/index.d.mts

@@ -1,6 +1,6 @@
 import { ColumnBuilder } from "./column-builder.mjs";
 import { DetachedColumnBuilder, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, bigInt, bigInteger, binary, blobCol, boolCol, char, date, dateTime, decimal, double, enumCol, float, geometry, int, integer, ipAddress, json, lineString, longText, macAddress, mediumText, objectCol, point, polygon, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, ulid, uuid, vector, year } from "./column-helpers.mjs";
 import { ForeignKeyBuilder } from "./foreign-key-builder.mjs";
-import { AlterSchema, ColumnMap, IndexEntry, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, OperationType, PendingOperation, UniqueEntry, migrate } from "./migration.mjs";
+import { AlterSchema, ColumnMap, IndexEntry, Migration, MigrationAlterOptions, MigrationConstructor, MigrationContract, MigrationCreateOptions, MigrationStep, OperationType, PendingOperation, UniqueEntry, migrate } from "./migration.mjs";
 import { MigrationRecord, MigrationResult, MigrationRunnerOptions, MigrationStatus, RollbackOptions, RunMigrationsOptions } from "./types.mjs";
-import { MigrationRunner, migrationRunner } from "./migration-runner.mjs";
+import { MigrationRunner, inferMigrationName, migrationRunner } from "./migration-runner.mjs";

package/esm/migration/index.mjs

@@ -2,6 +2,6 @@ import { ColumnBuilder } from "./column-builder.mjs";
 import { ForeignKeyBuilder } from "./foreign-key-builder.mjs";
 import { DetachedColumnBuilder, arrayBigInt, arrayBoolean, arrayDate, arrayDecimal, arrayFloat, arrayInt, arrayJson, arrayText, arrayTimestamp, arrayUuid, bigInt, bigInteger, binary, blobCol, boolCol, char, date, dateTime, decimal, double, enumCol, float, geometry, int, integer, ipAddress, json, lineString, longText, macAddress, mediumText, objectCol, point, polygon, setCol, smallInt, smallInteger, string, text, time, timestamp, tinyInt, tinyInteger, ulid, uuid, vector, year } from "./column-helpers.mjs";
 import { Migration, migrate } from "./migration.mjs";
-import { MigrationRunner, migrationRunner } from "./migration-runner.mjs";
+import { MigrationRunner, inferMigrationName, migrationRunner } from "./migration-runner.mjs";
 
 export {  };

package/esm/migration/migration-order.mjs

@@ -5,10 +5,13 @@ import { compareCreatedAt } from "./parse-created-at.mjs";
 * Comparator for applying migrations — oldest first.
 *
 * Priority:
-*   1. `createdAt` timestamp (older = earlier)
-*   2. Alphabetical by migration name (last resort)
+*   1. `order` override (lower = earlier, default 0)
+*   2. `createdAt` timestamp (older = earlier)
+*   3. Alphabetical by migration name (last resort)
 */
 function sortMigrations(a, b) {
+	const byOrder = (a.order ?? 0) - (b.order ?? 0);
+	if (byOrder !== 0) return byOrder;
 	const byCreatedAt = compareCreatedAt(a.createdAt, b.createdAt);
 	if (byCreatedAt !== void 0) return byCreatedAt;
 	return a.migrationName.localeCompare(b.migrationName);

package/esm/migration/migration-order.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"migration-order.mjs","names":[],"sources":["../../../../../../../cascade/src/migration/migration-order.ts"],"sourcesContent":["import { compareCreatedAt } from \"./parse-created-at\";\n\n/** The minimum shape ordering needs — the runner passes full migration classes. */\ntype Orderable = {\n  createdAt?: string;\n  migrationName: string;\n};\n\n/**\n * Comparator for applying migrations — oldest first.\n *\n * Priority:\n *   1. `createdAt` timestamp (older = earlier)\n *   2. Alphabetical by migration name (last resort)\n */\nexport function sortMigrations(a: Orderable, b: Orderable): number {\n  const byCreatedAt = compareCreatedAt(a.createdAt, b.createdAt);\n\n  if (byCreatedAt !== undefined) {\n    return byCreatedAt;\n  }\n\n  // Last resort: alphabetical\n  return a.migrationName.localeCompare(b.migrationName);\n}\n\n/**\n * Comparator for rolling migrations back — newest first, the exact inverse of\n * {@link sortMigrations}.\n *\n * A rollback has to undo migrations in the reverse of the order they were\n * applied, or a `down()` will hit schema its predecessor already removed —\n * dropping a table before dropping the column that was added to it.\n *\n * This must be an explicit descending sort rather than a `.reverse()` of the\n * executed list: that list is read back ordered by `batch, name`, so it is\n * alphabetical rather than chronological, and reversing it merely produces\n * reverse-alphabetical order.\n */\nexport function sortMigrationsForRollback(a: Orderable, b: Orderable): number {\n  return sortMigrations(b, a);\n}\n"],"mappings":";;;;;;;;;;AAeA,SAAgB,eAAe,GAAc,GAAsB;CACjE,MAAM,cAAc,iBAAiB,EAAE,WAAW,EAAE,SAAS;CAE7D,IAAI,gBAAgB,QAClB,OAAO;CAIT,OAAO,EAAE,cAAc,cAAc,EAAE,aAAa;AACtD;;;;;;;;;;;;;;AAeA,SAAgB,0BAA0B,GAAc,GAAsB;CAC5E,OAAO,eAAe,GAAG,CAAC;AAC5B"}
+{"version":3,"file":"migration-order.mjs","names":[],"sources":["../../../../../../../cascade/src/migration/migration-order.ts"],"sourcesContent":["import { compareCreatedAt } from \"./parse-created-at\";\n\n/** The minimum shape ordering needs — the runner passes full migration classes. */\ntype Orderable = {\n  createdAt?: string;\n  migrationName: string;\n  order?: number;\n};\n\n/**\n * Comparator for applying migrations — oldest first.\n *\n * Priority:\n *   1. `order` override (lower = earlier, default 0)\n *   2. `createdAt` timestamp (older = earlier)\n *   3. Alphabetical by migration name (last resort)\n */\nexport function sortMigrations(a: Orderable, b: Orderable): number {\n  const byOrder = (a.order ?? 0) - (b.order ?? 0);\n\n  if (byOrder !== 0) {\n    return byOrder;\n  }\n\n  const byCreatedAt = compareCreatedAt(a.createdAt, b.createdAt);\n\n  if (byCreatedAt !== undefined) {\n    return byCreatedAt;\n  }\n\n  // Last resort: alphabetical\n  return a.migrationName.localeCompare(b.migrationName);\n}\n\n/**\n * Comparator for rolling migrations back — newest first, the exact inverse of\n * {@link sortMigrations}.\n *\n * A rollback has to undo migrations in the reverse of the order they were\n * applied, or a `down()` will hit schema its predecessor already removed —\n * dropping a table before dropping the column that was added to it.\n *\n * This must be an explicit descending sort rather than a `.reverse()` of the\n * executed list: that list is read back ordered by `batch, name`, so it is\n * alphabetical rather than chronological, and reversing it merely produces\n * reverse-alphabetical order.\n */\nexport function sortMigrationsForRollback(a: Orderable, b: Orderable): number {\n  return sortMigrations(b, a);\n}\n"],"mappings":";;;;;;;;;;;AAiBA,SAAgB,eAAe,GAAc,GAAsB;CACjE,MAAM,WAAW,EAAE,SAAS,MAAM,EAAE,SAAS;CAE7C,IAAI,YAAY,GACd,OAAO;CAGT,MAAM,cAAc,iBAAiB,EAAE,WAAW,EAAE,SAAS;CAE7D,IAAI,gBAAgB,QAClB,OAAO;CAIT,OAAO,EAAE,cAAc,cAAc,EAAE,aAAa;AACtD;;;;;;;;;;;;;;AAeA,SAAgB,0BAA0B,GAAc,GAAsB;CAC5E,OAAO,eAAe,GAAG,CAAC;AAC5B"}

package/esm/migration/migration-runner.d.mts

@@ -36,7 +36,18 @@ type RegisterableMigration = (new () => MigrationContract) & {
 type ExecuteOptions = {
   /** Run in dry-run mode (no actual changes) */readonly dryRun?: boolean; /** Record to migrations table (default: true for batch, false for single) */
   readonly record?: boolean;
+  /**
+   * Rollback only: delete the `_migrations` rows whose migration file is no
+   * longer registered, instead of failing on them.
+   */
+  readonly pruneMissing?: boolean;
 };
+/**
+ * Derive a migration name from a file path: drop everything after the first dot
+ * and strip a trailing `-migration` / `_migration` suffix. Shared by every CLI
+ * so the same file is recorded under the same name.
+ */
+declare function inferMigrationName(file: string): string;
 /**
  * Migration runner that executes migrations.
  *
@@ -76,8 +87,8 @@ declare class MigrationRunner {
   readonly migrations: MigrationClass[];
   /** Data source to use */
   private dataSource?;
-  /** Cached migration driver */
-  private cachedMigrationDriver?;
+  /** Cached migration drivers, one per data source */
+  private readonly migrationDrivers;
   /** Table name for tracking migrations */
   private readonly migrationsTable;
   /** Whether to log operations */
@@ -104,6 +115,34 @@ declare class MigrationRunner {
    * Get the migration driver.
    */
   private getMigrationDriver;
+  /**
+   * Resolve a migration's declared data source (name or instance).
+   * Falls back to the runner's own data source when it declares none.
+   */
+  private resolveDataSource;
+  /** Data source a registered migration class runs against. */
+  private sourceOf;
+  /** Distinct data sources across the registered migrations (runner's own included). */
+  private getSources;
+  /**
+   * Resolve whether a migration runs in a transaction:
+   * 1. migration-level flag (instance, else the static from `Migration.create/alter`)
+   * 2. `CONCURRENTLY` statements cannot run in a transaction block
+   * 3. data-source config
+   * 4. driver default
+   */
+  private resolveTransactional;
+  /** Locks held by the run in progress (Mongo TTL heartbeat). */
+  private activeLocks;
+  /** Extend every held lock's TTL; called between migrations. */
+  private refreshLocks;
+  /**
+   * Run `callback` while holding a migration lock on every given data source, so
+   * concurrent `migrate` invocations (replicas, init containers) serialize.
+   */
+  private withLock;
+  /** Acquire the lock for one data source; `undefined` when its driver has no lock support. */
+  private acquireLock;
   /**
    * Register a migration.
    *
@@ -178,6 +217,7 @@ declare class MigrationRunner {
    * ```
    */
   runAll(options?: ExecuteOptions): Promise<MigrationResult[]>;
+  private runAllUnlocked;
   /**
    * Export migrations as phase-ordered SQL files in database/sql/ directory.
    * By default, it exports all registered migrations. Use `pendingOnly: true` to export only pending ones.
@@ -201,6 +241,7 @@ declare class MigrationRunner {
    * @returns Results for each migration
    */
   rollbackBatches(batches: number, options?: ExecuteOptions): Promise<MigrationResult[]>;
+  private rollbackBatchesUnlocked;
   /**
    * Rollback all executed migrations.
    *
@@ -280,7 +321,9 @@ declare class MigrationRunner {
    *
    * @see listPendingMigrations
    */
-  getPendingMigrations(): Promise<MigrationClass[]>;
+  getPendingMigrations(options?: {
+    readOnly?: boolean;
+  }): Promise<MigrationClass[]>;
   /**
    * Get migrations to rollback, newest-first.
    *
@@ -299,7 +342,9 @@ declare class MigrationRunner {
   /**
    * Get executed migration records.
    */
-  getExecutedMigrations(): Promise<MigrationRecord[]>;
+  getExecutedMigrations(dataSource?: DataSource, options?: {
+    readOnly?: boolean;
+  }): Promise<MigrationRecord[]>;
   /**
    * Record a migration.
    */
@@ -315,5 +360,5 @@ declare class MigrationRunner {
 }
 declare const migrationRunner: MigrationRunner;
 //#endregion
-export { MigrationRunner, migrationRunner };
+export { MigrationRunner, inferMigrationName, migrationRunner };
 //# sourceMappingURL=migration-runner.d.mts.map

package/esm/migration/migration-runner.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"migration-runner.d.mts","names":[],"sources":["../../../../../../../cascade/src/migration/migration-runner.ts"],"mappings":";;;;;;;AAW2E;KAKtE,cAAA,cAA4B,SAAS;EACxC,aAAA;EACA,SAAA;AAAA;;;;AAAS;AAAA;;;;;;;;AAqBA;AAAA;;;KAFN,qBAAA,cAAmC,iBAAiB;EACvD,aAAA;EACA,SAAA;AAAA;;;;KAgBG,cAAA;EA8H6B,uDA5HvB,MAAA,YA4LS;EAAA,SA1LT,MAAM;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqCJ,eAAA;;WAEK,UAAA,EAAY,cAAA;EAqBX;EAAA,QAlBT,UAAA;EAoBJ;EAAA,QAjBI,qBAAA;EAgCD;EAAA,iBA7BU,eAAA;EA6BI;EAAA,iBA1BJ,OAAA;EA6CT;;;;;cArCN,OAAA;IACE,UAAA,GAAa,UAAA;IACb,eAAA;IACA,OAAA;EAAA;EA4Hc;;;EA7GX,aAAA,CAAc,UAAA,EAAY,UAAA;EA+G9B;;;EAAA,QAtGK,aAAA;EA0HN;;;EAAA,QAhHM,kBAAA;EAkHG;;;;;;;;;;;;;;;EAxFJ,QAAA,CAAS,cAAA,EAAgB,qBAAA;EAyZnB;;;;;;EAjYN,YAAA,CAAa,UAAA,EAAY,qBAAA;EA8aE;;;EApa3B,KAAA;EAqbM;;;EA7aN,kBAAA;EA6amD;;;;;;;;;;;;;EAxZ7C,GAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EAwsBkC;;;;;;;;;AAsFb;AAOlC;;EAlxBe,QAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EA+wBuC;AAAA;;;;;;;;;;;;;;EArvBrC,MAAA,CAAO,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;EAuM9C,SAAA,CAAU,OAAA;IAAW,WAAA;IAAuB,OAAA;EAAA,IAA2B,OAAA;;;;;;;EAqFvE,YAAA,CAAa,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;;EAWpD,eAAA,CACX,OAAA,UACA,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;;;;;;;EA0CE,WAAA,CAAY,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;EAiBnD,KAAA,CAAM,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;EAa7C,MAAA,IAAU,OAAA,CACrB,KAAA;IACE,IAAA;IACA,KAAA;IACA,QAAA;IACA,KAAA;EAAA;;;;;;;;;;;;UAkCU,wBAAA;;;;UAwCA,YAAA;;;;;;;;;UAgJN,uBAAA;;;;;;;;;;;;;;;;;;;UAyBA,kBAAA;;;;;;;;;;;;;EA8CK,oBAAA,IAAwB,OAAA,CAAQ,cAAA;;;;;;;;;;;;;;;UAsB/B,uBAAA;;;;EAmBD,qBAAA,IAAyB,OAAA,CAAQ,eAAA;;;;UAmBhC,eAAA;;;;UAkBA,qBAAA;;;;UAQA,kBAAA;AAAA;AAAA,cAOH,eAAA,EAAe,eAAwB"}
+{"version":3,"file":"migration-runner.d.mts","names":[],"sources":["../../../../../../../cascade/src/migration/migration-runner.ts"],"mappings":";;;;;;;AAW2E;KAKtE,cAAA,cAA4B,SAAS;EACxC,aAAA;EACA,SAAA;AAAA;;;;AAAS;AAAA;;;;;;;;AAqBA;AAAA;;;KAFN,qBAAA,cAAmC,iBAAiB;EACvD,aAAA;EACA,SAAA;AAAA;;AAmCqB;AAqCvB;KA9CK,cAAA;yDAEM,MAAA,YA4CoC;EAAA,SA1CpC,MAAA;EAkFiB;;;;EAAA,SA7EjB,YAAA;AAAA;;;;;;iBAqCK,kBAAA,CAAmB,IAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAwClC,eAAA;EAuBP;EAAA,SArBY,UAAA,EAAY,cAAA;EAsBxB;EAAA,QAnBI,UAAA;EAiBN;EAAA,iBAde,gBAAA;EAgCgB;EAAA,iBA7BhB,eAAA;EAsCT;EAAA,iBAnCS,OAAA;EA4DT;;;;;cApDN,OAAA;IACE,UAAA,GAAa,UAAA;IACb,eAAA;IACA,OAAA;EAAA;EA0PY;;;EA3OT,aAAA,CAAc,UAAA,EAAY,UAAA;EAyR1B;;;EAAA,QAhRC,aAAA;EA8SN;;;EAAA,QApSM,kBAAA;EAsSG;;;;EAAA,QAvRH,iBAAA;EA4SN;EAAA,QArSM,QAAA;EAsSG;EAAA,QAjSH,UAAA;EA2TqB;;;;;;;EAAA,QA5SrB,oBAAA;EA2iBe;EAAA,QAnhBf,WAAA;EAsnBK;EAAA,QAnnBC,YAAA;EAmnBY;;;;EAAA,QAzmBZ,QAAA;EAsnBH;EAAA,QAxlBG,WAAA;EAylBX;;;;;;;;;;;;;;;EA9eI,QAAA,CAAS,cAAA,EAAgB,qBAAA;EAgkB5B;;;;;;EA5hBG,YAAA,CAAa,UAAA,EAAY,qBAAA;EAuyBxB;;;EA7xBD,KAAA;EA60BJ;;;EAr0BI,kBAAA;EAi6BO;;;;;;;;;;AA2DkB;AAUlC;;EAj9Be,GAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EA88BuC;AAAA;;;;;;;;;;;EA37BrC,QAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;;;;;;;;;;;;;;;;EA0BE,MAAA,CAAO,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;EAAA,QAS7C,cAAA;;;;;EAsPD,SAAA,CAAU,OAAA;IAAW,WAAA;IAAuB,OAAA;EAAA,IAA2B,OAAA;;;;;;;EAmGvE,YAAA,CAAa,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;;EAWpD,eAAA,CACX,OAAA,UACA,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EAAA,QAMG,uBAAA;;;;;;;EAkDD,WAAA,CAAY,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;;;EAWnD,KAAA,CAAM,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;EAa7C,MAAA,IAAU,OAAA,CACrB,KAAA;IACE,IAAA;IACA,KAAA;IACA,QAAA;IACA,KAAA;EAAA;;;;;;;;;;;;UAsCU,wBAAA;;;;UA2CA,YAAA;;;;;;;;;UA6JN,uBAAA;;;;;;;;;;;;;;;;;;;UA0BA,kBAAA;;;;;;;;;;;;;EA8CK,oBAAA,CACX,OAAA;IAAW,QAAA;EAAA,IACV,OAAA,CAAQ,cAAA;;;;;;;;;;;;;;;UA6BG,uBAAA;;;;EA8DD,qBAAA,CACX,UAAA,GAAY,UAAA,EACZ,OAAA;IAAW,QAAA;EAAA,IACV,OAAA,CAAQ,eAAA;;;;UAuBG,eAAA;;;;UAuBA,qBAAA;;;;UAWA,kBAAA;AAAA;AAAA,cAUH,eAAA,EAAe,eAAwB"}