@warlock.js/cascade 4.1.15 → 4.2.0

package/esm/errors/transaction-rollback.error.d.mts

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/cascade/src/errors/transaction-rollback.error.d.ts
+//#region ../@warlock.js/cascade/src/errors/transaction-rollback.error.d.ts
 /**
  * Error thrown when a transaction is explicitly rolled back via ctx.rollback().
  *

package/esm/errors/transaction-rollback.error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-rollback.error.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/errors/transaction-rollback.error.ts"],"mappings":";;AAOA;;;;;;cAAa,wBAAA,SAAiC,KAAK;EAW9B;;AAAe;EAAf,SAPH,MAAA;;;;;;cAOG,MAAA;AAAA"}
+{"version":3,"file":"transaction-rollback.error.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/errors/transaction-rollback.error.ts"],"mappings":";;AAOA;;;;;;cAAa,wBAAA,SAAiC,KAAK;EAW9B;;AAAe;EAAf,SAPH,MAAA;;;;;;cAOG,MAAA;AAAA"}

package/esm/errors/transaction-rollback.error.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/cascade/src/errors/transaction-rollback.error.ts
+//#region ../@warlock.js/cascade/src/errors/transaction-rollback.error.ts
 /**
 * Error thrown when a transaction is explicitly rolled back via ctx.rollback().
 *

package/esm/errors/transaction-rollback.error.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-rollback.error.mjs","names":[],"sources":["../../../../../../@warlock.js/cascade/src/errors/transaction-rollback.error.ts"],"sourcesContent":["/**\n * Error thrown when a transaction is explicitly rolled back via ctx.rollback().\n *\n * This error is used to signal transaction rollback without representing\n * an application error. It's caught by the transaction wrapper to perform\n * cleanup and then re-thrown.\n */\nexport class TransactionRollbackError extends Error {\n  /**\n   * The reason for the rollback (if provided).\n   */\n  public readonly reason?: string;\n\n  /**\n   * Creates a new TransactionRollbackError.\n   *\n   * @param reason - Optional reason for rollback (for logging/debugging)\n   */\n  public constructor(reason?: string) {\n    super(reason || \"Transaction rolled back\");\n    this.name = \"TransactionRollbackError\";\n    this.reason = reason;\n\n    // Maintains proper stack trace for where error was thrown (V8 only)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TransactionRollbackError);\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,2BAAb,MAAa,iCAAiC,MAAM;;;;CAIlD,AAAgB;;;;;;CAOhB,AAAO,YAAY,QAAiB;EAClC,MAAM,UAAU,yBAAyB;EACzC,KAAK,OAAO;EACZ,KAAK,SAAS;EAGd,IAAI,MAAM,mBACR,MAAM,kBAAkB,MAAM,wBAAwB;CAE1D;AACF"}
+{"version":3,"file":"transaction-rollback.error.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/errors/transaction-rollback.error.ts"],"sourcesContent":["/**\n * Error thrown when a transaction is explicitly rolled back via ctx.rollback().\n *\n * This error is used to signal transaction rollback without representing\n * an application error. It's caught by the transaction wrapper to perform\n * cleanup and then re-thrown.\n */\nexport class TransactionRollbackError extends Error {\n  /**\n   * The reason for the rollback (if provided).\n   */\n  public readonly reason?: string;\n\n  /**\n   * Creates a new TransactionRollbackError.\n   *\n   * @param reason - Optional reason for rollback (for logging/debugging)\n   */\n  public constructor(reason?: string) {\n    super(reason || \"Transaction rolled back\");\n    this.name = \"TransactionRollbackError\";\n    this.reason = reason;\n\n    // Maintains proper stack trace for where error was thrown (V8 only)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TransactionRollbackError);\n    }\n  }\n}\n"],"mappings":";;;;;;;;AAOA,IAAa,2BAAb,MAAa,iCAAiC,MAAM;;;;CAIlD,AAAgB;;;;;;CAOhB,AAAO,YAAY,QAAiB;EAClC,MAAM,UAAU,yBAAyB;EACzC,KAAK,OAAO;EACZ,KAAK,SAAS;EAGd,IAAI,MAAM,mBACR,MAAM,kBAAkB,MAAM,wBAAwB;CAE1D;AACF"}

package/esm/events/model-events.d.mts

@@ -2,7 +2,7 @@ import { DeleteStrategy } from "../types.mjs";
 import { ModelSchema } from "../model/model.types.mjs";
 import { Model } from "../model/model.mjs";
 import { QueryBuilderContract } from "../contracts/query-builder.contract.mjs";
-//#region ../../@warlock.js/cascade/src/events/model-events.d.ts
+//#region ../@warlock.js/cascade/src/events/model-events.d.ts
 type OnValidatingEventContext = {
   isInsert: boolean;
   mode: "insert" | "update";

package/esm/events/model-events.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"model-events.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/events/model-events.ts"],"mappings":"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"}
+{"version":3,"file":"model-events.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/events/model-events.ts"],"mappings":"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"}

package/esm/events/model-events.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/cascade/src/events/model-events.ts
+//#region ../@warlock.js/cascade/src/events/model-events.ts
 /**
 * Light-weight async event emitter used to power model lifecycle hooks.
 *

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

@@ -1 +1 @@
-{"version":3,"file":"model-events.mjs","names":[],"sources":["../../../../../../@warlock.js/cascade/src/events/model-events.ts"],"sourcesContent":["import { QueryBuilderContract } from \"../contracts\";\r\nimport type { Model } from \"../model/model\";\r\nimport { 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,EAAE,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":["../../../../../../../@warlock.js/cascade/src/events/model-events.ts"],"sourcesContent":["import { QueryBuilderContract } from \"../contracts\";\r\nimport type { Model } from \"../model/model\";\r\nimport { 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"}

package/esm/expressions/aggregate-expressions.d.mts

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/cascade/src/expressions/aggregate-expressions.d.ts
+//#region ../@warlock.js/cascade/src/expressions/aggregate-expressions.d.ts
 /**
  * Database-agnostic aggregation expressions.
  *

package/esm/expressions/aggregate-expressions.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate-expressions.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/expressions/aggregate-expressions.ts"],"mappings":";;AAiCA;;;;;;;;AAIS;AAMT;;;;AAA6B;AAc7B;;;;;;;;AAAmF;AAenF;;;;;;;;KAvCY,mBAAA;EAyLY,kCAvLtB,KAAA,EAAO,iBAAiB,EAqOH;EAnOrB,OAAA;AAAA;;;;KAMU,iBAAA;;;;iBAcI,qBAAA,CAAsB,KAAA,YAAiB,KAAA,IAAS,mBAAmB;;;;;;;cAetE,IAAA;;;;;;;;;;;;;AAgM6B;;;;WA/K/B,mBAAA;;;;;;;;;;;;;;;;;;sBAqBW,mBAAA;;;;;;;;;;;;;;;;;;sBAqBA,mBAAA;;;;;;;;;;;;;;;;;;sBAqBA,mBAAA;;;;;;;;;;;;;;;;;;sBAqBA,mBAAA;;;;;;;;;;;;;;;;;;;;2BAuBK,mBAAA;;;;;;;;;;;;;;;;;;;wBAsBH,mBAAA;;;;;;;;;;;;;;;;;;;;wBAuBA,mBAAA;;;;;;;;;;;;;;;;;;;;uBAuBD,mBAAA;AAAA"}
+{"version":3,"file":"aggregate-expressions.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/expressions/aggregate-expressions.ts"],"mappings":";;AAiCA;;;;;;;;AAIS;AAMT;;;;AAA6B;AAc7B;;;;;;;;AAAmF;AAenF;;;;;;;;KAvCY,mBAAA;EAyLY,kCAvLtB,KAAA,EAAO,iBAAiB,EAqOH;EAnOrB,OAAA;AAAA;;;;KAMU,iBAAA;;;;iBAcI,qBAAA,CAAsB,KAAA,YAAiB,KAAA,IAAS,mBAAmB;;;;;;;cAetE,IAAA;;;;;;;;;;;;;AAgM6B;;;;WA/K/B,mBAAA;;;;;;;;;;;;;;;;;;sBAqBW,mBAAA;;;;;;;;;;;;;;;;;;sBAqBA,mBAAA;;;;;;;;;;;;;;;;;;sBAqBA,mBAAA;;;;;;;;;;;;;;;;;;sBAqBA,mBAAA;;;;;;;;;;;;;;;;;;;;2BAuBK,mBAAA;;;;;;;;;;;;;;;;;;;wBAsBH,mBAAA;;;;;;;;;;;;;;;;;;;;wBAuBA,mBAAA;;;;;;;;;;;;;;;;;;;;uBAuBD,mBAAA;AAAA"}

package/esm/expressions/aggregate-expressions.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/cascade/src/expressions/aggregate-expressions.ts
+//#region ../@warlock.js/cascade/src/expressions/aggregate-expressions.ts
 /**
 * Checks if a value is an abstract aggregate expression.
 */

package/esm/expressions/aggregate-expressions.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"aggregate-expressions.mjs","names":[],"sources":["../../../../../../@warlock.js/cascade/src/expressions/aggregate-expressions.ts"],"sourcesContent":["/**\n * Database-agnostic aggregation expressions.\n *\n * `count` / `sum` / `avg` / `min` / `max` are **cross-driver** — the same\n * call compiles to the native shape on every supported database (MongoDB\n * `{ $sum: \"$field\" }`, SQL `SUM(field)`, ...).\n *\n * `distinct` / `floor` / `first` / `last` are **MongoDB-only**. They have no\n * single-scalar `GROUP BY` equivalent in SQL, so on Postgres they throw a\n * fail-fast error at the `.groupBy()` call (naming the `selectRaw` /\n * `havingRaw` escape hatch) rather than emit a silently-different query.\n *\n * @example\n * ```typescript\n * import { $agg } from '@warlock.js/cascade';\n *\n * // Works for both MongoDB and SQL\n * Lesson.query()\n *   .groupBy(\"type\", {\n *     count: $agg.count(),\n *     total: $agg.sum(\"duration\"),\n *     avg: $agg.avg(\"rating\")\n *   })\n *   .get();\n * ```\n */\n\n/**\n * Abstract aggregate expression format.\n *\n * This format is database-agnostic and will be translated by each driver\n * to their native syntax.\n */\nexport type AggregateExpression = {\n  /** The aggregate function type */\n  __agg: AggregateFunction;\n  /** The field to aggregate (null for count) */\n  __field: string | null;\n};\n\n/**\n * Supported aggregate functions.\n */\nexport type AggregateFunction =\n  | \"count\"\n  | \"sum\"\n  | \"avg\"\n  | \"min\"\n  | \"max\"\n  | \"first\"\n  | \"last\"\n  | \"distinct\"\n  | \"floor\";\n\n/**\n * Checks if a value is an abstract aggregate expression.\n */\nexport function isAggregateExpression(value: unknown): value is AggregateExpression {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"__field\" in value &&\n    typeof (value as AggregateExpression).__agg === \"string\"\n  );\n}\n\n/**\n * Database-agnostic aggregation expression helpers.\n *\n * These helpers create abstract expressions that each driver translates\n * to their native format.\n */\nexport const $agg = {\n  /**\n   * Count documents in each group.\n   *\n   * @returns Abstract count expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   count: $agg.count()\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $sum: 1 }`\n   * - SQL: `COUNT(*)`\n   */\n  count(): AggregateExpression {\n    return { __agg: \"count\", __field: null };\n  },\n\n  /**\n   * Sum a numeric field across documents in each group.\n   *\n   * @param field - The field name to sum\n   * @returns Abstract sum expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   totalDuration: $agg.sum(\"duration\")\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $sum: \"$duration\" }`\n   * - SQL: `SUM(duration)`\n   */\n  sum(field: string): AggregateExpression {\n    return { __agg: \"sum\", __field: field };\n  },\n\n  /**\n   * Calculate the average value of a field across documents in each group.\n   *\n   * @param field - The field name to average\n   * @returns Abstract average expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   avgRating: $agg.avg(\"rating\")\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $avg: \"$rating\" }`\n   * - SQL: `AVG(rating)`\n   */\n  avg(field: string): AggregateExpression {\n    return { __agg: \"avg\", __field: field };\n  },\n\n  /**\n   * Get the minimum value of a field across documents in each group.\n   *\n   * @param field - The field name\n   * @returns Abstract min expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   minPrice: $agg.min(\"price\")\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $min: \"$price\" }`\n   * - SQL: `MIN(price)`\n   */\n  min(field: string): AggregateExpression {\n    return { __agg: \"min\", __field: field };\n  },\n\n  /**\n   * Get the maximum value of a field across documents in each group.\n   *\n   * @param field - The field name\n   * @returns Abstract max expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   maxPrice: $agg.max(\"price\")\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $max: \"$price\" }`\n   * - SQL: `MAX(price)`\n   */\n  max(field: string): AggregateExpression {\n    return { __agg: \"max\", __field: field };\n  },\n\n  /**\n   * Get the distinct values of a field across documents in each group.\n   *\n   * @param field - The field name\n   * @returns Abstract distinct expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   distinctColors: $agg.distinct(\"color\")\n   * });\n   * ```\n   *\n   * **MongoDB-only.** MongoDB: `{ $distinct: \"$color\" }` (returns the array\n   * of distinct values). On Postgres this throws — SQL `DISTINCT` is a set\n   * quantifier, not a scalar aggregate, so there is no equivalent single\n   * value to put in a `GROUP BY` projection. Use `selectRaw` if you need a\n   * Postgres-specific shape (e.g. `array_agg(DISTINCT color)`).\n   */\n  distinct(field: string): AggregateExpression {\n    return { __agg: \"distinct\", __field: field };\n  },\n\n  /**\n   * Get the floor value of a field across documents in each group.\n   *\n   * @param field - The field name\n   * @returns Abstract floor expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   floorPrice: $agg.floor(\"price\")\n   * });\n   * ```\n   *\n   * **MongoDB-only.** MongoDB: `{ $floor: \"$price\" }`. On Postgres this\n   * throws — `FLOOR` is a scalar function, not an aggregate, so it is\n   * meaningless inside a bare `$group` / `GROUP BY`. Use `selectRaw` with\n   * `FLOOR(...)` over the aggregated value if you need it on Postgres.\n   */\n  floor(field: string): AggregateExpression {\n    return { __agg: \"floor\", __field: field };\n  },\n\n  /**\n   * Get the first value of a field in each group (order-dependent).\n   *\n   * @param field - The field name\n   * @returns Abstract first expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   firstName: $agg.first(\"name\")\n   * });\n   * ```\n   *\n   * **MongoDB-only.** MongoDB: `{ $first: \"$name\" }` (group-order\n   * dependent). On Postgres this throws — the SQL equivalent is\n   * `FIRST_VALUE(name) OVER (ORDER BY ...)`, a window function needing an\n   * ordering context the `$agg` API doesn't carry. Use `selectRaw` with an\n   * explicit window function if you need it on Postgres.\n   */\n  first(field: string): AggregateExpression {\n    return { __agg: \"first\", __field: field };\n  },\n\n  /**\n   * Get the last value of a field in each group (order-dependent).\n   *\n   * @param field - The field name\n   * @returns Abstract last expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   lastName: $agg.last(\"name\")\n   * });\n   * ```\n   *\n   * **MongoDB-only.** MongoDB: `{ $last: \"$name\" }` (group-order\n   * dependent). On Postgres this throws — the SQL equivalent is\n   * `LAST_VALUE(name) OVER (ORDER BY ...)`, a window function needing an\n   * ordering context the `$agg` API doesn't carry. Use `selectRaw` with an\n   * explicit window function if you need it on Postgres.\n   */\n  last(field: string): AggregateExpression {\n    return { __agg: \"last\", __field: field };\n  },\n};\n"],"mappings":";;;;AAyDA,SAAgB,sBAAsB,OAA8C;CAClF,OACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACb,OAAQ,MAA8B,UAAU;AAEpD;;;;;;;AAQA,MAAa,OAAO;;;;;;;;;;;;;;;;;CAiBlB,QAA6B;EAC3B,OAAO;GAAE,OAAO;GAAS,SAAS;EAAK;CACzC;;;;;;;;;;;;;;;;;;CAmBA,IAAI,OAAoC;EACtC,OAAO;GAAE,OAAO;GAAO,SAAS;EAAM;CACxC;;;;;;;;;;;;;;;;;;CAmBA,IAAI,OAAoC;EACtC,OAAO;GAAE,OAAO;GAAO,SAAS;EAAM;CACxC;;;;;;;;;;;;;;;;;;CAmBA,IAAI,OAAoC;EACtC,OAAO;GAAE,OAAO;GAAO,SAAS;EAAM;CACxC;;;;;;;;;;;;;;;;;;CAmBA,IAAI,OAAoC;EACtC,OAAO;GAAE,OAAO;GAAO,SAAS;EAAM;CACxC;;;;;;;;;;;;;;;;;;;;CAqBA,SAAS,OAAoC;EAC3C,OAAO;GAAE,OAAO;GAAY,SAAS;EAAM;CAC7C;;;;;;;;;;;;;;;;;;;CAoBA,MAAM,OAAoC;EACxC,OAAO;GAAE,OAAO;GAAS,SAAS;EAAM;CAC1C;;;;;;;;;;;;;;;;;;;;CAqBA,MAAM,OAAoC;EACxC,OAAO;GAAE,OAAO;GAAS,SAAS;EAAM;CAC1C;;;;;;;;;;;;;;;;;;;;CAqBA,KAAK,OAAoC;EACvC,OAAO;GAAE,OAAO;GAAQ,SAAS;EAAM;CACzC;AACF"}
+{"version":3,"file":"aggregate-expressions.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/expressions/aggregate-expressions.ts"],"sourcesContent":["/**\n * Database-agnostic aggregation expressions.\n *\n * `count` / `sum` / `avg` / `min` / `max` are **cross-driver** — the same\n * call compiles to the native shape on every supported database (MongoDB\n * `{ $sum: \"$field\" }`, SQL `SUM(field)`, ...).\n *\n * `distinct` / `floor` / `first` / `last` are **MongoDB-only**. They have no\n * single-scalar `GROUP BY` equivalent in SQL, so on Postgres they throw a\n * fail-fast error at the `.groupBy()` call (naming the `selectRaw` /\n * `havingRaw` escape hatch) rather than emit a silently-different query.\n *\n * @example\n * ```typescript\n * import { $agg } from '@warlock.js/cascade';\n *\n * // Works for both MongoDB and SQL\n * Lesson.query()\n *   .groupBy(\"type\", {\n *     count: $agg.count(),\n *     total: $agg.sum(\"duration\"),\n *     avg: $agg.avg(\"rating\")\n *   })\n *   .get();\n * ```\n */\n\n/**\n * Abstract aggregate expression format.\n *\n * This format is database-agnostic and will be translated by each driver\n * to their native syntax.\n */\nexport type AggregateExpression = {\n  /** The aggregate function type */\n  __agg: AggregateFunction;\n  /** The field to aggregate (null for count) */\n  __field: string | null;\n};\n\n/**\n * Supported aggregate functions.\n */\nexport type AggregateFunction =\n  | \"count\"\n  | \"sum\"\n  | \"avg\"\n  | \"min\"\n  | \"max\"\n  | \"first\"\n  | \"last\"\n  | \"distinct\"\n  | \"floor\";\n\n/**\n * Checks if a value is an abstract aggregate expression.\n */\nexport function isAggregateExpression(value: unknown): value is AggregateExpression {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"__field\" in value &&\n    typeof (value as AggregateExpression).__agg === \"string\"\n  );\n}\n\n/**\n * Database-agnostic aggregation expression helpers.\n *\n * These helpers create abstract expressions that each driver translates\n * to their native format.\n */\nexport const $agg = {\n  /**\n   * Count documents in each group.\n   *\n   * @returns Abstract count expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   count: $agg.count()\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $sum: 1 }`\n   * - SQL: `COUNT(*)`\n   */\n  count(): AggregateExpression {\n    return { __agg: \"count\", __field: null };\n  },\n\n  /**\n   * Sum a numeric field across documents in each group.\n   *\n   * @param field - The field name to sum\n   * @returns Abstract sum expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   totalDuration: $agg.sum(\"duration\")\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $sum: \"$duration\" }`\n   * - SQL: `SUM(duration)`\n   */\n  sum(field: string): AggregateExpression {\n    return { __agg: \"sum\", __field: field };\n  },\n\n  /**\n   * Calculate the average value of a field across documents in each group.\n   *\n   * @param field - The field name to average\n   * @returns Abstract average expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   avgRating: $agg.avg(\"rating\")\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $avg: \"$rating\" }`\n   * - SQL: `AVG(rating)`\n   */\n  avg(field: string): AggregateExpression {\n    return { __agg: \"avg\", __field: field };\n  },\n\n  /**\n   * Get the minimum value of a field across documents in each group.\n   *\n   * @param field - The field name\n   * @returns Abstract min expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   minPrice: $agg.min(\"price\")\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $min: \"$price\" }`\n   * - SQL: `MIN(price)`\n   */\n  min(field: string): AggregateExpression {\n    return { __agg: \"min\", __field: field };\n  },\n\n  /**\n   * Get the maximum value of a field across documents in each group.\n   *\n   * @param field - The field name\n   * @returns Abstract max expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   maxPrice: $agg.max(\"price\")\n   * });\n   * ```\n   *\n   * Translates to:\n   * - MongoDB: `{ $max: \"$price\" }`\n   * - SQL: `MAX(price)`\n   */\n  max(field: string): AggregateExpression {\n    return { __agg: \"max\", __field: field };\n  },\n\n  /**\n   * Get the distinct values of a field across documents in each group.\n   *\n   * @param field - The field name\n   * @returns Abstract distinct expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   distinctColors: $agg.distinct(\"color\")\n   * });\n   * ```\n   *\n   * **MongoDB-only.** MongoDB: `{ $distinct: \"$color\" }` (returns the array\n   * of distinct values). On Postgres this throws — SQL `DISTINCT` is a set\n   * quantifier, not a scalar aggregate, so there is no equivalent single\n   * value to put in a `GROUP BY` projection. Use `selectRaw` if you need a\n   * Postgres-specific shape (e.g. `array_agg(DISTINCT color)`).\n   */\n  distinct(field: string): AggregateExpression {\n    return { __agg: \"distinct\", __field: field };\n  },\n\n  /**\n   * Get the floor value of a field across documents in each group.\n   *\n   * @param field - The field name\n   * @returns Abstract floor expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   floorPrice: $agg.floor(\"price\")\n   * });\n   * ```\n   *\n   * **MongoDB-only.** MongoDB: `{ $floor: \"$price\" }`. On Postgres this\n   * throws — `FLOOR` is a scalar function, not an aggregate, so it is\n   * meaningless inside a bare `$group` / `GROUP BY`. Use `selectRaw` with\n   * `FLOOR(...)` over the aggregated value if you need it on Postgres.\n   */\n  floor(field: string): AggregateExpression {\n    return { __agg: \"floor\", __field: field };\n  },\n\n  /**\n   * Get the first value of a field in each group (order-dependent).\n   *\n   * @param field - The field name\n   * @returns Abstract first expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   firstName: $agg.first(\"name\")\n   * });\n   * ```\n   *\n   * **MongoDB-only.** MongoDB: `{ $first: \"$name\" }` (group-order\n   * dependent). On Postgres this throws — the SQL equivalent is\n   * `FIRST_VALUE(name) OVER (ORDER BY ...)`, a window function needing an\n   * ordering context the `$agg` API doesn't carry. Use `selectRaw` with an\n   * explicit window function if you need it on Postgres.\n   */\n  first(field: string): AggregateExpression {\n    return { __agg: \"first\", __field: field };\n  },\n\n  /**\n   * Get the last value of a field in each group (order-dependent).\n   *\n   * @param field - The field name\n   * @returns Abstract last expression\n   *\n   * @example\n   * ```typescript\n   * query.groupBy(\"type\", {\n   *   lastName: $agg.last(\"name\")\n   * });\n   * ```\n   *\n   * **MongoDB-only.** MongoDB: `{ $last: \"$name\" }` (group-order\n   * dependent). On Postgres this throws — the SQL equivalent is\n   * `LAST_VALUE(name) OVER (ORDER BY ...)`, a window function needing an\n   * ordering context the `$agg` API doesn't carry. Use `selectRaw` with an\n   * explicit window function if you need it on Postgres.\n   */\n  last(field: string): AggregateExpression {\n    return { __agg: \"last\", __field: field };\n  },\n};\n"],"mappings":";;;;AAyDA,SAAgB,sBAAsB,OAA8C;CAClF,OACE,OAAO,UAAU,YACjB,UAAU,QACV,aAAa,SACb,OAAQ,MAA8B,UAAU;AAEpD;;;;;;;AAQA,MAAa,OAAO;;;;;;;;;;;;;;;;;CAiBlB,QAA6B;EAC3B,OAAO;GAAE,OAAO;GAAS,SAAS;EAAK;CACzC;;;;;;;;;;;;;;;;;;CAmBA,IAAI,OAAoC;EACtC,OAAO;GAAE,OAAO;GAAO,SAAS;EAAM;CACxC;;;;;;;;;;;;;;;;;;CAmBA,IAAI,OAAoC;EACtC,OAAO;GAAE,OAAO;GAAO,SAAS;EAAM;CACxC;;;;;;;;;;;;;;;;;;CAmBA,IAAI,OAAoC;EACtC,OAAO;GAAE,OAAO;GAAO,SAAS;EAAM;CACxC;;;;;;;;;;;;;;;;;;CAmBA,IAAI,OAAoC;EACtC,OAAO;GAAE,OAAO;GAAO,SAAS;EAAM;CACxC;;;;;;;;;;;;;;;;;;;;CAqBA,SAAS,OAAoC;EAC3C,OAAO;GAAE,OAAO;GAAY,SAAS;EAAM;CAC7C;;;;;;;;;;;;;;;;;;;CAoBA,MAAM,OAAoC;EACxC,OAAO;GAAE,OAAO;GAAS,SAAS;EAAM;CAC1C;;;;;;;;;;;;;;;;;;;;CAqBA,MAAM,OAAoC;EACxC,OAAO;GAAE,OAAO;GAAS,SAAS;EAAM;CAC1C;;;;;;;;;;;;;;;;;;;;CAqBA,KAAK,OAAoC;EACvC,OAAO;GAAE,OAAO;GAAQ,SAAS;EAAM;CACzC;AACF"}

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

@@ -1,6 +1,6 @@
 import { ColumnDefinition, ColumnType, ForeignKeyDefinition, VectorIndexOptions } from "../contracts/migration-driver.contract.mjs";
 
-//#region ../../@warlock.js/cascade/src/migration/column-builder.d.ts
+//#region ../@warlock.js/cascade/src/migration/column-builder.d.ts
 /**
  * Reference to the Migration type to avoid circular imports.
  * The actual type is injected at runtime.

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

@@ -1 +1 @@
-{"version":3,"file":"column-builder.d.mts","names":[],"sources":["../../../../../../@warlock.js/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,CAAA;EAuIA;;;;;;;EA3HA,WAAA,CAAA;EAoOA;;;;;;;;;;;;;;;;;EA1MA,OAAA,CAAQ,KAAA;EA0WC;;;;;;;;;;;AAqKwB;;;;EA1fjC,aAAA,CAAc,KAAA;;;;;;;;;;;;;EAkBd,UAAA,CAAA;;;;;;;;;;;;;EAiBA,kBAAA,CAAA;;;;;;;;;;;;;EAqBA,MAAA,CAAA;;;;;;;;;;;;;EAoBA,KAAA,CAAA;;;;;;;;;;;;;;EAoBA,WAAA,CAAY,OAAA,GAAS,IAAA,CAAK,kBAAA;;;;;;;;;;;EAwB1B,OAAA,CAAA;;;;;;;;;;;;;;EAkBA,aAAA,CAAA;;;;;;;;;;;;;EAqBA,QAAA,CAAA;;;;;;;;;;;;;;EAsBA,OAAA,CAAQ,IAAA;;;;;;;;EAgBR,KAAA,CAAM,UAAA,UAAoB,IAAA;;;;;;;;;;;;;;EAyB1B,KAAA,CAAM,UAAA;;;;;;;;;;;;;EAiBN,KAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;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,CAAA;;;;;;;;;;;;;;;;;;;;;EAgCA,MAAA,CAAA;;;;EAkCA,MAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;EA8BA,WAAA,CAAY,UAAA;;;;;;;;EAYZ,MAAA,CAAA;;;;;;;;EAiBA,OAAA,CAAA;;;;;;;;EAqBA,aAAA,CAAA,GAAiB,gBAAA;AAAA"}
+{"version":3,"file":"column-builder.d.mts","names":[],"sources":["../../../../../../../@warlock.js/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"}

package/esm/migration/column-builder.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/cascade/src/migration/column-builder.ts
+//#region ../@warlock.js/cascade/src/migration/column-builder.ts
 /**
 * Fluent builder for defining column properties.
 *

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

@@ -1 +1 @@
-{"version":3,"file":"column-builder.mjs","names":[],"sources":["../../../../../../@warlock.js/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":["../../../../../../../@warlock.js/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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"}

package/esm/migration/column-helpers.d.mts

@@ -1,7 +1,7 @@
 import { VectorIndexOptions } from "../contracts/migration-driver.contract.mjs";
 import { ColumnBuilder } from "./column-builder.mjs";
 
-//#region ../../@warlock.js/cascade/src/migration/column-helpers.d.ts
+//#region ../@warlock.js/cascade/src/migration/column-helpers.d.ts
 /**
  * A no-op migration sink used by standalone column helpers.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"column-helpers.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/migration/column-helpers.ts"],"mappings":";;;;;;;AAAiD;;;;;;;;cAa3C,qBAAA;EAE8B;EAAA,SAAlB,cAAA;IAAkB,OAAA;IAAmB,MAAA;EAAA;EAQnD;EAAA,SALc,kBAAA;EAQT;EAAA,SALS,oBAAA;IACd,MAAA;IACA,OAAA,EAVuB,kBAAA;EAAA;EAalB,eAAA,CAAgB,KAAA;IAAS,OAAA;IAAmB,MAAA;EAAA;EAI5C,sBAAA,CAAuB,EAAA;EAIvB,qBAAA,CACL,MAAA,UACA,OAAA,EAAS,IAAA,CAbmE,kBAAA;AAAA;AAagB;AAUhG;;;AAVgG,cAUnF,qBAAA,SAA8B,aAAA;EAAA,SACzB,IAAA,EAAM,qBAAA;cAGpB,IAAA,EAAM,qBAAA,QAA6B,aAAA,MACnC,IAAA,UACA,OAAA,GAAS,qBAAA,QAA6B,aAAA;AAAA;;;;;;;;;;;;;iBAwB1B,MAAA,CAAO,MAAA,YAAe,qBAAqB;;;;AAxBK;AAwBhE;;;;iBAYgB,IAAA,CAAK,MAAA,WAAiB,qBAAqB;AAA3D;;;;AAA2D;AAgB3D;;;;AAA6C;AAO7C;;AAvBA,iBAgBgB,IAAA,CAAA,GAAQ,qBAAqB;;AAOM;AAOnD;iBAPgB,UAAA,CAAA,GAAc,qBAAqB;;;AAOF;iBAAjC,QAAA,CAAA,GAAY,qBAAqB;;;;AAgBD;AAKhD;;;;iBALgB,OAAA,CAAA,GAAW,qBAAqB;AAUhD;AAAA,cALa,GAAA,SAAG,OAAU;;;AAK2B;iBAArC,YAAA,CAAA,GAAgB,qBAAqB;;cAKxC,QAAA,SAAQ,YAAe;;AAAA;AAKpC;iBAAgB,WAAA,CAAA,GAAe,qBAAqB;;cAKvC,OAAA,SAAO,WAAc;AALkB;AAKpD;;AALoD,iBAUpC,UAAA,CAAA,GAAc,qBAAqB;;cAKtC,MAAA,SAAM,UAAa;AALhC;;;AAAA,iBAUgB,KAAA,CAAA,GAAS,qBAAqB;AAVK;AAKnD;;AALmD,iBAiBnC,MAAA,CAAA,GAAU,qBAAqB;;AAZf;AAKhC;;;;AAA8C;AAO9C;iBAYgB,OAAA,CAAQ,SAAA,WAAe,KAAA,YAAY,qBAAqB;;;AAZzB;AAY/C;;;;;;;iBAkBgB,OAAA,CAAA,GAAW,qBAAqB;;;;iBAchC,IAAA,CAAA,GAAQ,qBAAqB;AAA7C;;;AAAA,iBAOgB,QAAA,CAAA,GAAY,qBAAqB;AAPJ;AAO7C;;;;AAAiD;AAYjD;;AAnB6C,iBAmB7B,SAAA,CAAA,GAAa,qBAAqB;;AAAA;AAOlD;iBAAgB,IAAA,CAAA,GAAQ,qBAAqB;;;AAAA;iBAO7B,IAAA,CAAA,GAAQ,qBAAqB;;;;AAAA;AAmB7C;;;;AAA6C;AAO7C;;iBAPgB,IAAA,CAAA,GAAQ,qBAAqB;;AAOK;AAOlD;iBAPgB,SAAA,CAAA,GAAa,qBAAqB;;;AAOH;iBAA/B,MAAA,CAAA,GAAU,qBAAqB;;;;iBAO/B,OAAA,CAAA,GAAW,qBAAqB;AAoBhD;;;;AAA6C;AAO7C;;;;AAA6C;AAW7C;;AAlBA,iBAAgB,IAAA,CAAA,GAAQ,qBAAqB;;AAkBK;AAOlD;iBAlBgB,IAAA,CAAA,GAAQ,qBAAqB;;;AAkBM;iBAPnC,SAAA,CAAA,GAAa,qBAAqB;;;;iBAOlC,UAAA,CAAA,GAAc,qBAAqB;AAkBnD;;;AAAA,iBAPgB,KAAA,CAAA,GAAS,qBAAqB;AAOE;AAOhD;;AAPgD,iBAAhC,OAAA,CAAA,GAAW,qBAAqB;;AAOG;AAOnD;iBAPgB,UAAA,CAAA,GAAc,qBAAqB;;;AAOF;iBAAjC,QAAA,CAAA,GAAY,qBAAqB;;;;AAkBgB;AAgBjE;;;;AAAgE;AAOhE;iBAvBgB,MAAA,CAAO,UAAA,WAAqB,qBAAqB;;;AAuBF;AAS/D;;;;AAAiD;iBAhBjC,OAAA,CAAQ,MAAA,aAAmB,qBAAqB;;;;iBAOhD,MAAA,CAAO,MAAA,aAAmB,qBAAqB;AAmB/D;AAAA,iBAVgB,QAAA,CAAA,GAAY,qBAAqB;;iBAKjC,WAAA,CAAA,GAAe,qBAAqB;AAKD;AAAA,iBAAnC,UAAA,CAAA,GAAc,qBAAqB;;iBAKnC,YAAA,CAAa,SAAA,WAAoB,KAAA,YAAiB,qBAAqB;;iBAKvE,YAAA,CAAA,GAAgB,qBAAqB;;iBAKrC,SAAA,CAAA,GAAa,qBAAqB;;iBAKlC,SAAA,CAAA,GAAa,qBAAqB;AAVlD;AAAA,iBAegB,cAAA,CAAA,GAAkB,qBAAqB;;iBAKvC,SAAA,CAAA,GAAa,qBAAqB;AApBG;AAAA,iBAyBrC,SAAA,CAAA,GAAa,qBAAqB"}
+{"version":3,"file":"column-helpers.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/migration/column-helpers.ts"],"mappings":"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"}

package/esm/migration/column-helpers.mjs

@@ -1,6 +1,6 @@
 import { ColumnBuilder } from "./column-builder.mjs";
 
-//#region ../../@warlock.js/cascade/src/migration/column-helpers.ts
+//#region ../@warlock.js/cascade/src/migration/column-helpers.ts
 /**
 * A no-op migration sink used by standalone column helpers.
 *

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

@@ -1 +1 @@
-{"version":3,"file":"column-helpers.mjs","names":[],"sources":["../../../../../../@warlock.js/cascade/src/migration/column-helpers.ts"],"sourcesContent":["import { ColumnBuilder } from \"./column-builder\";\n\n/**\n * A no-op migration sink used by standalone column helpers.\n *\n * When column helpers are used in `Migration.create()` / `Migration.alter()`,\n * the builder is constructed without a real migration context. The actual\n * operations are dequeued from the ColumnBuilder's definition and replayed\n * onto the real migration instance at execution time.\n *\n * Index and FK operations queued on this sink are collected and transferred\n * to the real migration by the factory methods.\n */\nclass DetachedMigrationSink {\n  /** Pending indexes registered via .unique() / .index() on a helper column. */\n  public readonly pendingIndexes: { columns: string[]; unique?: boolean }[] = [];\n\n  /** Pending FK definitions registered via .references() on a helper column. */\n  public readonly pendingForeignKeys: object[] = [];\n\n  /** Pending Vector index definitions registered via .vectorIndex() on a helper column. */\n  public readonly pendingVectorIndexes: {\n    column: string;\n    options: import(\"../contracts/migration-driver.contract\").VectorIndexOptions;\n  }[] = [];\n\n  public addPendingIndex(index: { columns: string[]; unique?: boolean }): void {\n    this.pendingIndexes.push(index);\n  }\n\n  public addForeignKeyOperation(fk: object): void {\n    this.pendingForeignKeys.push(fk);\n  }\n\n  public addPendingVectorIndex(\n    column: string,\n    options: Omit<import(\"../contracts/migration-driver.contract\").VectorIndexOptions, \"column\">,\n  ): void {\n    this.pendingVectorIndexes.push({ column, options: options as any });\n  }\n}\n\n/**\n * A `ColumnBuilder` that carries its own detached sink so it can be\n * constructed outside of a migration class and later merged in.\n */\nexport class DetachedColumnBuilder extends ColumnBuilder {\n  public readonly sink: DetachedMigrationSink;\n\n  public constructor(\n    type: ConstructorParameters<typeof ColumnBuilder>[2],\n    name: string,\n    options: ConstructorParameters<typeof ColumnBuilder>[3] = {},\n  ) {\n    const sink = new DetachedMigrationSink();\n    super(sink as any, name, type, options);\n    this.sink = sink;\n  }\n}\n\n// ============================================================================\n// STRING HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: string / varchar.\n *\n * @example\n * ```typescript\n * import { Migration, string } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   username: string(50).unique(),\n * });\n * ```\n */\nexport function string(length = 255): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"string\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: fixed-length CHAR.\n *\n * @example\n * ```typescript\n * code: char(3) // CHAR(3)\n * ```\n */\nexport function char(length: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"char\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: TEXT (unlimited length).\n *\n * @example\n * ```typescript\n * import { Migration, text } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   bio: text().nullable(),\n * });\n * ```\n */\nexport function text(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"text\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MEDIUMTEXT.\n */\nexport function mediumText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"mediumText\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: LONGTEXT.\n */\nexport function longText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"longText\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NUMERIC HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: INTEGER.\n *\n * @example\n * ```typescript\n * age: integer().unsigned()\n * ```\n */\nexport function integer(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"integer\", \"__placeholder__\");\n}\n\n/** Alias for `integer()`. */\nexport const int = integer;\n\n/**\n * Standalone column helper: SMALLINT.\n */\nexport function smallInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"smallInteger\", \"__placeholder__\");\n}\n\n/** Alias for `smallInteger()`. */\nexport const smallInt = smallInteger;\n\n/**\n * Standalone column helper: TINYINT.\n */\nexport function tinyInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"tinyInteger\", \"__placeholder__\");\n}\n\n/** Alias for `tinyInteger()`. */\nexport const tinyInt = tinyInteger;\n\n/**\n * Standalone column helper: BIGINT.\n */\nexport function bigInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"bigInteger\", \"__placeholder__\");\n}\n\n/** Alias for `bigInteger()`. */\nexport const bigInt = bigInteger;\n\n/**\n * Standalone column helper: FLOAT.\n */\nexport function float(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"float\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DOUBLE.\n */\nexport function double(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"double\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DECIMAL.\n *\n * @example\n * ```typescript\n * price: decimal(10, 2) // DECIMAL(10,2)\n * ```\n */\nexport function decimal(precision = 8, scale = 2): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"decimal\", \"__placeholder__\", { precision, scale });\n}\n\n// ============================================================================\n// BOOLEAN HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: BOOLEAN.\n *\n * Named `boolCol` to avoid collision with the TypeScript / JS `boolean` primitive.\n *\n * @example\n * ```typescript\n * is_active: boolCol().default(true)\n * ```\n */\nexport function boolCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"boolean\", \"__placeholder__\");\n}\n\n/** Alias for `boolCol()`. */\nexport { boolCol as bool };\n\n// ============================================================================\n// DATE / TIME HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: DATE.\n */\nexport function date(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"date\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DATETIME.\n */\nexport function dateTime(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"dateTime\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIMESTAMP.\n *\n * @example\n * ```typescript\n * started_at: timestamp().default(\"NOW()\")\n * ```\n */\nexport function timestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"timestamp\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIME.\n */\nexport function time(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"time\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: YEAR.\n */\nexport function year(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"year\", \"__placeholder__\");\n}\n\n// ============================================================================\n// JSON & BINARY HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: JSON.\n *\n * Named `jsonCol` to avoid collision with the TS/JSON built-in names.\n * Use `json()` is fine for most cases though — this alias exists for clarity.\n *\n * @example\n * ```typescript\n * metadata: json().nullable()\n * ```\n */\nexport function json(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Alias for `json()`. Named `objectCol` to avoid collision with TS `object` type.\n */\nexport function objectCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: BINARY / BLOB.\n */\nexport function binary(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n/**\n * Alias for `binary()`. Named `blobCol` to avoid collision with the Web `Blob` API.\n */\nexport function blobCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n// ============================================================================\n// IDENTIFIER HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: UUID.\n *\n * @example\n * ```typescript\n * import { Migration, uuid } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(Chat, {\n *   organization_id: uuid().references(Organization).onDelete(\"cascade\"),\n * });\n * ```\n */\nexport function uuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"uuid\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: ULID.\n */\nexport function ulid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ulid\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NETWORK HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: IP address.\n */\nexport function ipAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ipAddress\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MAC address.\n */\nexport function macAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"macAddress\", \"__placeholder__\");\n}\n\n// ============================================================================\n// SPATIAL HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: geo point.\n */\nexport function point(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"point\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: polygon.\n */\nexport function polygon(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"polygon\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: line string.\n */\nexport function lineString(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"lineString\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: generic geometry.\n */\nexport function geometry(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"geometry\", \"__placeholder__\");\n}\n\n// ============================================================================\n// AI / ML HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: vector (for AI embeddings).\n *\n * @param dimensions - Embedding size (e.g. 1536 for text-embedding-3-small)\n *\n * @example\n * ```typescript\n * embedding: vector(1536)\n * ```\n */\nexport function vector(dimensions: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"vector\", \"__placeholder__\", { dimensions });\n}\n\n// ============================================================================\n// ENUM & SET HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: ENUM.\n *\n * @example\n * ```typescript\n * status: enumCol([\"active\", \"inactive\", \"pending\"])\n * ```\n */\nexport function enumCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"enum\", \"__placeholder__\", { values });\n}\n\n/**\n * Standalone column helper: SET (multiple values).\n */\nexport function setCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"set\", \"__placeholder__\", { values });\n}\n\n// ============================================================================\n// POSTGRESQL ARRAY HELPERS\n// ============================================================================\n\n/** Standalone helper: INTEGER[] */\nexport function arrayInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: BIGINT[] */\nexport function arrayBigInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBigInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: REAL[] */\nexport function arrayFloat(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayFloat\", \"__placeholder__\");\n}\n\n/** Standalone helper: DECIMAL[] */\nexport function arrayDecimal(precision?: number, scale?: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDecimal\", \"__placeholder__\", { precision, scale });\n}\n\n/** Standalone helper: BOOLEAN[] */\nexport function arrayBoolean(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBoolean\", \"__placeholder__\");\n}\n\n/** Standalone helper: TEXT[] */\nexport function arrayText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayText\", \"__placeholder__\");\n}\n\n/** Standalone helper: DATE[] */\nexport function arrayDate(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDate\", \"__placeholder__\");\n}\n\n/** Standalone helper: TIMESTAMPTZ[] */\nexport function arrayTimestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayTimestamp\", \"__placeholder__\");\n}\n\n/** Standalone helper: UUID[] */\nexport function arrayUuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayUuid\", \"__placeholder__\");\n}\n\n/** Standalone helper: JSONB[] */\nexport function arrayJson(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayJson\", \"__placeholder__\");\n}\n"],"mappings":"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"}
+{"version":3,"file":"column-helpers.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/migration/column-helpers.ts"],"sourcesContent":["import { ColumnBuilder } from \"./column-builder\";\n\n/**\n * A no-op migration sink used by standalone column helpers.\n *\n * When column helpers are used in `Migration.create()` / `Migration.alter()`,\n * the builder is constructed without a real migration context. The actual\n * operations are dequeued from the ColumnBuilder's definition and replayed\n * onto the real migration instance at execution time.\n *\n * Index and FK operations queued on this sink are collected and transferred\n * to the real migration by the factory methods.\n */\nclass DetachedMigrationSink {\n  /** Pending indexes registered via .unique() / .index() on a helper column. */\n  public readonly pendingIndexes: { columns: string[]; unique?: boolean }[] = [];\n\n  /** Pending FK definitions registered via .references() on a helper column. */\n  public readonly pendingForeignKeys: object[] = [];\n\n  /** Pending Vector index definitions registered via .vectorIndex() on a helper column. */\n  public readonly pendingVectorIndexes: {\n    column: string;\n    options: import(\"../contracts/migration-driver.contract\").VectorIndexOptions;\n  }[] = [];\n\n  public addPendingIndex(index: { columns: string[]; unique?: boolean }): void {\n    this.pendingIndexes.push(index);\n  }\n\n  public addForeignKeyOperation(fk: object): void {\n    this.pendingForeignKeys.push(fk);\n  }\n\n  public addPendingVectorIndex(\n    column: string,\n    options: Omit<import(\"../contracts/migration-driver.contract\").VectorIndexOptions, \"column\">,\n  ): void {\n    this.pendingVectorIndexes.push({ column, options: options as any });\n  }\n}\n\n/**\n * A `ColumnBuilder` that carries its own detached sink so it can be\n * constructed outside of a migration class and later merged in.\n */\nexport class DetachedColumnBuilder extends ColumnBuilder {\n  public readonly sink: DetachedMigrationSink;\n\n  public constructor(\n    type: ConstructorParameters<typeof ColumnBuilder>[2],\n    name: string,\n    options: ConstructorParameters<typeof ColumnBuilder>[3] = {},\n  ) {\n    const sink = new DetachedMigrationSink();\n    super(sink as any, name, type, options);\n    this.sink = sink;\n  }\n}\n\n// ============================================================================\n// STRING HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: string / varchar.\n *\n * @example\n * ```typescript\n * import { Migration, string } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   username: string(50).unique(),\n * });\n * ```\n */\nexport function string(length = 255): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"string\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: fixed-length CHAR.\n *\n * @example\n * ```typescript\n * code: char(3) // CHAR(3)\n * ```\n */\nexport function char(length: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"char\", \"__placeholder__\", { length });\n}\n\n/**\n * Standalone column helper: TEXT (unlimited length).\n *\n * @example\n * ```typescript\n * import { Migration, text } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(User, {\n *   bio: text().nullable(),\n * });\n * ```\n */\nexport function text(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"text\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MEDIUMTEXT.\n */\nexport function mediumText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"mediumText\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: LONGTEXT.\n */\nexport function longText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"longText\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NUMERIC HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: INTEGER.\n *\n * @example\n * ```typescript\n * age: integer().unsigned()\n * ```\n */\nexport function integer(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"integer\", \"__placeholder__\");\n}\n\n/** Alias for `integer()`. */\nexport const int = integer;\n\n/**\n * Standalone column helper: SMALLINT.\n */\nexport function smallInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"smallInteger\", \"__placeholder__\");\n}\n\n/** Alias for `smallInteger()`. */\nexport const smallInt = smallInteger;\n\n/**\n * Standalone column helper: TINYINT.\n */\nexport function tinyInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"tinyInteger\", \"__placeholder__\");\n}\n\n/** Alias for `tinyInteger()`. */\nexport const tinyInt = tinyInteger;\n\n/**\n * Standalone column helper: BIGINT.\n */\nexport function bigInteger(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"bigInteger\", \"__placeholder__\");\n}\n\n/** Alias for `bigInteger()`. */\nexport const bigInt = bigInteger;\n\n/**\n * Standalone column helper: FLOAT.\n */\nexport function float(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"float\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DOUBLE.\n */\nexport function double(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"double\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DECIMAL.\n *\n * @example\n * ```typescript\n * price: decimal(10, 2) // DECIMAL(10,2)\n * ```\n */\nexport function decimal(precision = 8, scale = 2): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"decimal\", \"__placeholder__\", { precision, scale });\n}\n\n// ============================================================================\n// BOOLEAN HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: BOOLEAN.\n *\n * Named `boolCol` to avoid collision with the TypeScript / JS `boolean` primitive.\n *\n * @example\n * ```typescript\n * is_active: boolCol().default(true)\n * ```\n */\nexport function boolCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"boolean\", \"__placeholder__\");\n}\n\n/** Alias for `boolCol()`. */\nexport { boolCol as bool };\n\n// ============================================================================\n// DATE / TIME HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: DATE.\n */\nexport function date(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"date\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: DATETIME.\n */\nexport function dateTime(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"dateTime\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIMESTAMP.\n *\n * @example\n * ```typescript\n * started_at: timestamp().default(\"NOW()\")\n * ```\n */\nexport function timestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"timestamp\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: TIME.\n */\nexport function time(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"time\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: YEAR.\n */\nexport function year(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"year\", \"__placeholder__\");\n}\n\n// ============================================================================\n// JSON & BINARY HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: JSON.\n *\n * Named `jsonCol` to avoid collision with the TS/JSON built-in names.\n * Use `json()` is fine for most cases though — this alias exists for clarity.\n *\n * @example\n * ```typescript\n * metadata: json().nullable()\n * ```\n */\nexport function json(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Alias for `json()`. Named `objectCol` to avoid collision with TS `object` type.\n */\nexport function objectCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"json\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: BINARY / BLOB.\n */\nexport function binary(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n/**\n * Alias for `binary()`. Named `blobCol` to avoid collision with the Web `Blob` API.\n */\nexport function blobCol(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"binary\", \"__placeholder__\");\n}\n\n// ============================================================================\n// IDENTIFIER HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: UUID.\n *\n * @example\n * ```typescript\n * import { Migration, uuid } from \"@warlock.js/cascade\";\n *\n * export default Migration.create(Chat, {\n *   organization_id: uuid().references(Organization).onDelete(\"cascade\"),\n * });\n * ```\n */\nexport function uuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"uuid\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: ULID.\n */\nexport function ulid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ulid\", \"__placeholder__\");\n}\n\n// ============================================================================\n// NETWORK HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: IP address.\n */\nexport function ipAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"ipAddress\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: MAC address.\n */\nexport function macAddress(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"macAddress\", \"__placeholder__\");\n}\n\n// ============================================================================\n// SPATIAL HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: geo point.\n */\nexport function point(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"point\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: polygon.\n */\nexport function polygon(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"polygon\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: line string.\n */\nexport function lineString(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"lineString\", \"__placeholder__\");\n}\n\n/**\n * Standalone column helper: generic geometry.\n */\nexport function geometry(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"geometry\", \"__placeholder__\");\n}\n\n// ============================================================================\n// AI / ML HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: vector (for AI embeddings).\n *\n * @param dimensions - Embedding size (e.g. 1536 for text-embedding-3-small)\n *\n * @example\n * ```typescript\n * embedding: vector(1536)\n * ```\n */\nexport function vector(dimensions: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"vector\", \"__placeholder__\", { dimensions });\n}\n\n// ============================================================================\n// ENUM & SET HELPERS\n// ============================================================================\n\n/**\n * Standalone column helper: ENUM.\n *\n * @example\n * ```typescript\n * status: enumCol([\"active\", \"inactive\", \"pending\"])\n * ```\n */\nexport function enumCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"enum\", \"__placeholder__\", { values });\n}\n\n/**\n * Standalone column helper: SET (multiple values).\n */\nexport function setCol(values: string[]): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"set\", \"__placeholder__\", { values });\n}\n\n// ============================================================================\n// POSTGRESQL ARRAY HELPERS\n// ============================================================================\n\n/** Standalone helper: INTEGER[] */\nexport function arrayInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: BIGINT[] */\nexport function arrayBigInt(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBigInt\", \"__placeholder__\");\n}\n\n/** Standalone helper: REAL[] */\nexport function arrayFloat(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayFloat\", \"__placeholder__\");\n}\n\n/** Standalone helper: DECIMAL[] */\nexport function arrayDecimal(precision?: number, scale?: number): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDecimal\", \"__placeholder__\", { precision, scale });\n}\n\n/** Standalone helper: BOOLEAN[] */\nexport function arrayBoolean(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayBoolean\", \"__placeholder__\");\n}\n\n/** Standalone helper: TEXT[] */\nexport function arrayText(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayText\", \"__placeholder__\");\n}\n\n/** Standalone helper: DATE[] */\nexport function arrayDate(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayDate\", \"__placeholder__\");\n}\n\n/** Standalone helper: TIMESTAMPTZ[] */\nexport function arrayTimestamp(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayTimestamp\", \"__placeholder__\");\n}\n\n/** Standalone helper: UUID[] */\nexport function arrayUuid(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayUuid\", \"__placeholder__\");\n}\n\n/** Standalone helper: JSONB[] */\nexport function arrayJson(): DetachedColumnBuilder {\n  return new DetachedColumnBuilder(\"arrayJson\", \"__placeholder__\");\n}\n"],"mappings":"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"}

package/esm/migration/foreign-key-builder.d.mts

@@ -1,6 +1,6 @@
 import { ForeignKeyDefinition } from "../contracts/migration-driver.contract.mjs";
 
-//#region ../../@warlock.js/cascade/src/migration/foreign-key-builder.d.ts
+//#region ../@warlock.js/cascade/src/migration/foreign-key-builder.d.ts
 /**
  * Reference to the Migration type to avoid circular imports.
  */

package/esm/migration/foreign-key-builder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"foreign-key-builder.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/migration/foreign-key-builder.ts"],"mappings":";;;;;AAAmF;KAK9E,aAAA;EACH,sBAAA,CAAuB,EAAA,EAAI,oBAAoB;AAAA;;;;;AAAA;AAiCjD;;;;;;;;;;;;;cAAa,iBAAA;EAAA,iBAWQ,SAAA;EAkBP;EAAA,iBA3BK,UAAA;EAiDC;;;;;;cAxCC,SAAA,EAAW,aAAA,EAC5B,MAAA;EA6Ec;;;AAeC;;;EA3EV,IAAA,CAAK,IAAA;;;;;;;;;;;;;;;;;;EAsBL,UAAA,CAAW,KAAA,UAAe,MAAA;;;;;;;;;;;;;;EAoB1B,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;;EAkBjB,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;EAejB,UAAA,CAAA;AAAA"}
+{"version":3,"file":"foreign-key-builder.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/migration/foreign-key-builder.ts"],"mappings":";;;;;AAAmF;KAK9E,aAAA;EACH,sBAAA,CAAuB,EAAA,EAAI,oBAAoB;AAAA;;;;;AAAA;AAiCjD;;;;;;;;;;;;;cAAa,iBAAA;EAAA,iBAWQ,SAAA;EAkBP;EAAA,iBA3BK,UAAA;EAiDC;;;;;;cAxCC,SAAA,EAAW,aAAA,EAC5B,MAAA;EA6Ec;;;AAeC;;;EA3EV,IAAA,CAAK,IAAA;;;;;;;;;;;;;;;;;;EAsBL,UAAA,CAAW,KAAA,UAAe,MAAA;;;;;;;;;;;;;;EAoB1B,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;;;;EAkBjB,QAAA,CAAS,MAAA,EAAQ,oBAAA;;;;;;;;;;;EAejB,UAAA;AAAA"}

package/esm/migration/foreign-key-builder.mjs

@@ -1,4 +1,4 @@
-//#region ../../@warlock.js/cascade/src/migration/foreign-key-builder.ts
+//#region ../@warlock.js/cascade/src/migration/foreign-key-builder.ts
 /**
 * Fluent builder for foreign key constraints.
 *

package/esm/migration/foreign-key-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"foreign-key-builder.mjs","names":[],"sources":["../../../../../../@warlock.js/cascade/src/migration/foreign-key-builder.ts"],"sourcesContent":["import type { ForeignKeyDefinition } from \"../contracts/migration-driver.contract\";\n\n/**\n * Reference to the Migration type to avoid circular imports.\n */\ntype MigrationLike = {\n  addForeignKeyOperation(fk: ForeignKeyDefinition): void;\n};\n\n/**\n * Mutable foreign key definition being built.\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 foreign key constraints.\n *\n * Allows building foreign key definitions with a chainable API.\n * SQL-only feature; NoSQL drivers ignore foreign keys.\n *\n * The operation is pushed when `.references()` is called using a mutable\n * reference — subsequent `.onDelete()` / `.onUpdate()` calls mutate the\n * same definition already queued in pendingOperations.\n *\n * @example\n * ```typescript\n * this.foreign(\"user_id\")\n *   .references(\"users\", \"id\")\n *   .onDelete(\"cascade\")\n *   .onUpdate(\"cascade\");\n * ```\n */\nexport class ForeignKeyBuilder {\n  /** Mutable foreign key definition being accumulated */\n  private readonly definition: MutableForeignKeyDefinition;\n\n  /**\n   * Create a new foreign key builder.\n   *\n   * @param migration - Parent migration instance\n   * @param column - Local column name that will reference another table\n   */\n  public constructor(\n    private readonly migration: MigrationLike,\n    column: string,\n  ) {\n    this.definition = {\n      column,\n      referencesTable: \"\",\n      referencesColumn: \"id\",\n      onDelete: \"restrict\",\n      onUpdate: \"restrict\",\n    };\n  }\n\n  /**\n   * Set the constraint name.\n   *\n   * @param name - Constraint name (auto-generated if not provided)\n   * @returns This builder for chaining\n   */\n  public name(name: string): this {\n    this.definition.name = name;\n    return this;\n  }\n\n  /**\n   * Set the referenced table and column, and register the foreign key operation.\n   *\n   * Pushes the operation immediately using a mutable reference — any\n   * `.onDelete()` / `.onUpdate()` calls after this will mutate the same\n   * definition already queued in pendingOperations.\n   *\n   * @param table - Referenced table name\n   * @param column - Referenced column name (default: \"id\")\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\", \"id\");\n   * this.foreign(\"category_id\").references(\"categories\"); // defaults to \"id\"\n   * ```\n   */\n  public references(table: string, column = \"id\"): this {\n    this.definition.referencesTable = table;\n    this.definition.referencesColumn = column;\n    this.migration.addForeignKeyOperation(this.definition as ForeignKeyDefinition);\n    return this;\n  }\n\n  /**\n   * Set the ON DELETE action.\n   *\n   * @param action - Action to take when referenced row is deleted\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onDelete(\"cascade\"); // Delete child when parent is deleted\n   * ```\n   */\n  public onDelete(action: ForeignKeyDefinition[\"onDelete\"]): this {\n    this.definition.onDelete = action;\n    return this;\n  }\n\n  /**\n   * Set the ON UPDATE action.\n   *\n   * @param action - Action to take when referenced row's key is updated\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onUpdate(\"cascade\"); // Update child when parent key changes\n   * ```\n   */\n  public onUpdate(action: ForeignKeyDefinition[\"onUpdate\"]): this {\n    this.definition.onUpdate = action;\n    return this;\n  }\n\n  /**\n   * Shorthand for `.onDelete(\"cascade\").onUpdate(\"cascade\")`.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\").cascadeAll();\n   * ```\n   */\n  public cascadeAll(): this {\n    this.definition.onDelete = \"cascade\";\n    this.definition.onUpdate = \"cascade\";\n    return this;\n  }\n\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAuCA,IAAa,oBAAb,MAA+B;CAWV;;CATnB,AAAiB;;;;;;;CAQjB,AAAO,YACL,AAAiB,WACjB,QACA;EAFiB;EAGjB,KAAK,aAAa;GAChB;GACA,iBAAiB;GACjB,kBAAkB;GAClB,UAAU;GACV,UAAU;EACZ;CACF;;;;;;;CAQA,AAAO,KAAK,MAAoB;EAC9B,KAAK,WAAW,OAAO;EACvB,OAAO;CACT;;;;;;;;;;;;;;;;;;CAmBA,AAAO,WAAW,OAAe,SAAS,MAAY;EACpD,KAAK,WAAW,kBAAkB;EAClC,KAAK,WAAW,mBAAmB;EACnC,KAAK,UAAU,uBAAuB,KAAK,UAAkC;EAC7E,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;CAYA,AAAO,aAAmB;EACxB,KAAK,WAAW,WAAW;EAC3B,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;AAEF"}
+{"version":3,"file":"foreign-key-builder.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/migration/foreign-key-builder.ts"],"sourcesContent":["import type { ForeignKeyDefinition } from \"../contracts/migration-driver.contract\";\n\n/**\n * Reference to the Migration type to avoid circular imports.\n */\ntype MigrationLike = {\n  addForeignKeyOperation(fk: ForeignKeyDefinition): void;\n};\n\n/**\n * Mutable foreign key definition being built.\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 foreign key constraints.\n *\n * Allows building foreign key definitions with a chainable API.\n * SQL-only feature; NoSQL drivers ignore foreign keys.\n *\n * The operation is pushed when `.references()` is called using a mutable\n * reference — subsequent `.onDelete()` / `.onUpdate()` calls mutate the\n * same definition already queued in pendingOperations.\n *\n * @example\n * ```typescript\n * this.foreign(\"user_id\")\n *   .references(\"users\", \"id\")\n *   .onDelete(\"cascade\")\n *   .onUpdate(\"cascade\");\n * ```\n */\nexport class ForeignKeyBuilder {\n  /** Mutable foreign key definition being accumulated */\n  private readonly definition: MutableForeignKeyDefinition;\n\n  /**\n   * Create a new foreign key builder.\n   *\n   * @param migration - Parent migration instance\n   * @param column - Local column name that will reference another table\n   */\n  public constructor(\n    private readonly migration: MigrationLike,\n    column: string,\n  ) {\n    this.definition = {\n      column,\n      referencesTable: \"\",\n      referencesColumn: \"id\",\n      onDelete: \"restrict\",\n      onUpdate: \"restrict\",\n    };\n  }\n\n  /**\n   * Set the constraint name.\n   *\n   * @param name - Constraint name (auto-generated if not provided)\n   * @returns This builder for chaining\n   */\n  public name(name: string): this {\n    this.definition.name = name;\n    return this;\n  }\n\n  /**\n   * Set the referenced table and column, and register the foreign key operation.\n   *\n   * Pushes the operation immediately using a mutable reference — any\n   * `.onDelete()` / `.onUpdate()` calls after this will mutate the same\n   * definition already queued in pendingOperations.\n   *\n   * @param table - Referenced table name\n   * @param column - Referenced column name (default: \"id\")\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\", \"id\");\n   * this.foreign(\"category_id\").references(\"categories\"); // defaults to \"id\"\n   * ```\n   */\n  public references(table: string, column = \"id\"): this {\n    this.definition.referencesTable = table;\n    this.definition.referencesColumn = column;\n    this.migration.addForeignKeyOperation(this.definition as ForeignKeyDefinition);\n    return this;\n  }\n\n  /**\n   * Set the ON DELETE action.\n   *\n   * @param action - Action to take when referenced row is deleted\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onDelete(\"cascade\"); // Delete child when parent is deleted\n   * ```\n   */\n  public onDelete(action: ForeignKeyDefinition[\"onDelete\"]): this {\n    this.definition.onDelete = action;\n    return this;\n  }\n\n  /**\n   * Set the ON UPDATE action.\n   *\n   * @param action - Action to take when referenced row's key is updated\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\")\n   *   .references(\"users\")\n   *   .onUpdate(\"cascade\"); // Update child when parent key changes\n   * ```\n   */\n  public onUpdate(action: ForeignKeyDefinition[\"onUpdate\"]): this {\n    this.definition.onUpdate = action;\n    return this;\n  }\n\n  /**\n   * Shorthand for `.onDelete(\"cascade\").onUpdate(\"cascade\")`.\n   *\n   * @returns This builder for chaining\n   *\n   * @example\n   * ```typescript\n   * this.foreign(\"user_id\").references(\"users\").cascadeAll();\n   * ```\n   */\n  public cascadeAll(): this {\n    this.definition.onDelete = \"cascade\";\n    this.definition.onUpdate = \"cascade\";\n    return this;\n  }\n\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAuCA,IAAa,oBAAb,MAA+B;CAWV;;CATnB,AAAiB;;;;;;;CAQjB,AAAO,YACL,AAAiB,WACjB,QACA;EAFiB;EAGjB,KAAK,aAAa;GAChB;GACA,iBAAiB;GACjB,kBAAkB;GAClB,UAAU;GACV,UAAU;EACZ;CACF;;;;;;;CAQA,AAAO,KAAK,MAAoB;EAC9B,KAAK,WAAW,OAAO;EACvB,OAAO;CACT;;;;;;;;;;;;;;;;;;CAmBA,AAAO,WAAW,OAAe,SAAS,MAAY;EACpD,KAAK,WAAW,kBAAkB;EAClC,KAAK,WAAW,mBAAmB;EACnC,KAAK,UAAU,uBAAuB,KAAK,UAAkC;EAC7E,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;;;;CAeA,AAAO,SAAS,QAAgD;EAC9D,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;;;;;;;;;;;CAYA,AAAO,aAAmB;EACxB,KAAK,WAAW,WAAW;EAC3B,KAAK,WAAW,WAAW;EAC3B,OAAO;CACT;AAEF"}

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

@@ -2,7 +2,7 @@ import { Migration } from "./migration.mjs";
 import { DataSource } from "../data-source/data-source.mjs";
 import { MigrationRecord, MigrationResult } from "./types.mjs";
 
-//#region ../../@warlock.js/cascade/src/migration/migration-runner.d.ts
+//#region ../@warlock.js/cascade/src/migration/migration-runner.d.ts
 /**
  * Migration class type with static name property.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"migration-runner.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/migration/migration-runner.ts"],"mappings":";;;;;;;AAS2E;KAKtE,cAAA,cAA4B,SAAS;EACxC,aAAA;EACA,SAAA;AAAA;;;;KAgBG,cAAA;EAAA,uDAEM,MAAA;WAEA,MAAM;AAAA;AAsHjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,cAAa,eAAA;EAg1B2B;EAAA,SA90BtB,UAAA,EAAY,cAAA;EA80BiB;EAAA,QA30BrC,UAAA;EAHoB;EAAA,QAMpB,qBAAA;EAAA;EAAA,iBAGS,eAAA;EAGA;EAAA,iBAAA,OAAA;EASb;;;;;cADF,OAAA;IACE,UAAA,GAAa,UAAA;IACb,eAAA;IACA,OAAA;EAAA;EA4DG;;;EA7CA,aAAA,CAAc,UAAA,EAAY,UAAA;EAmED;;;EAAA,QA1DxB,aAAA;EAiGK;;;EAAA,QAvFL,kBAAA;EAyFN;;;;;;;;;;;;;;;EA/DK,QAAA,CAAS,cAAA,EAAgB,cAAA;EAuSE;;;;;;EAjR3B,YAAA,CAAa,UAAA,EAAY,cAAA;EA+VyB;;;EArVlD,KAAA,CAAA;EAkWI;;;EA1VJ,kBAAA,CAAA;EAqYM;;;;;;;;;;;;;EAhXA,GAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EA8YP;;;;;;;;;;;;EA3XS,QAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EA0sBG;;;AAQkB;AAOlC;;;;AAAoD;;;;;;;EA/rBrC,MAAA,CAAO,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;EAuL9C,SAAA,CAAU,OAAA;IAAW,WAAA;IAAuB,OAAA;EAAA,IAA2B,OAAA;;;;;;;EA8EvE,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,CAAA,GAAU,OAAA,CACrB,KAAA;IACE,IAAA;IACA,KAAA;IACA,QAAA;IACA,KAAA;EAAA;;;;;;;;;;;;UAkCU,wBAAA;;;;UAwCA,YAAA;;;;;;;;;UAoIN,uBAAA;;;;;;;;;;;;;;;;;;;UAyBA,kBAAA;;;;UAqCM,oBAAA;;;;UAWA,uBAAA;;;;EAoBD,qBAAA,CAAA,GAAyB,OAAA,CAAQ,eAAA;;;;UAmBhC,eAAA;;;;UAkBA,qBAAA;;;;UAQA,kBAAA;AAAA;AAAA,cAOH,eAAA,EAAe,eAAwB"}
+{"version":3,"file":"migration-runner.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/migration/migration-runner.ts"],"mappings":";;;;;;;AAS2E;KAKtE,cAAA,cAA4B,SAAS;EACxC,aAAA;EACA,SAAA;AAAA;;;;KAgBG,cAAA;EAAA,uDAEM,MAAA;WAEA,MAAM;AAAA;AAsHjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,cAAa,eAAA;EAg1B2B;EAAA,SA90BtB,UAAA,EAAY,cAAA;EA80BiB;EAAA,QA30BrC,UAAA;EAHoB;EAAA,QAMpB,qBAAA;EAAA;EAAA,iBAGS,eAAA;EAGA;EAAA,iBAAA,OAAA;EASb;;;;;cADF,OAAA;IACE,UAAA,GAAa,UAAA;IACb,eAAA;IACA,OAAA;EAAA;EA4DG;;;EA7CA,aAAA,CAAc,UAAA,EAAY,UAAA;EAmED;;;EAAA,QA1DxB,aAAA;EAiGK;;;EAAA,QAvFL,kBAAA;EAyFN;;;;;;;;;;;;;;;EA/DK,QAAA,CAAS,cAAA,EAAgB,cAAA;EAuSE;;;;;;EAjR3B,YAAA,CAAa,UAAA,EAAY,cAAA;EA+VyB;;;EArVlD,KAAA;EAkWI;;;EA1VJ,kBAAA;EAqYM;;;;;;;;;;;;;EAhXA,GAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EA8YP;;;;;;;;;;;;EA3XS,QAAA,CACX,cAAA,EAAgB,cAAA,EAChB,OAAA,GAAS,cAAA,GACR,OAAA,CAAQ,eAAA;EA0sBG;;;AAQkB;AAOlC;;;;AAAoD;;;;;;;EA/rBrC,MAAA,CAAO,OAAA,GAAS,cAAA,GAAsB,OAAA,CAAQ,eAAA;;;;;EAuL9C,SAAA,CAAU,OAAA;IAAW,WAAA;IAAuB,OAAA;EAAA,IAA2B,OAAA;;;;;;;EA8EvE,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;;;;;;;;;UAoIN,uBAAA;;;;;;;;;;;;;;;;;;;UAyBA,kBAAA;;;;UAqCM,oBAAA;;;;UAWA,uBAAA;;;;EAoBD,qBAAA,IAAyB,OAAA,CAAQ,eAAA;;;;UAmBhC,eAAA;;;;UAkBA,qBAAA;;;;UAQA,kBAAA;AAAA;AAAA,cAOH,eAAA,EAAe,eAAwB"}

package/esm/migration/migration-runner.mjs

@@ -5,7 +5,7 @@ import { log } from "@warlock.js/logger";
 import fs from "fs";
 import path from "path";
 
-//#region ../../@warlock.js/cascade/src/migration/migration-runner.ts
+//#region ../@warlock.js/cascade/src/migration/migration-runner.ts
 /**
 * Parse createdAt timestamp from custom format to Date.
 * Supports both: MM-DD-YYYY_HH-MM-SS and DD-MM-YYYY_HH-MM-SS