@warlock.js/cascade 4.8.1 → 4.9.0

package/esm/sync/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/sync/types.ts"],"mappings":";;;;;;;;KAYY,WAAA;EA0BK,2CAxBf,WAAA,UAGA;EAAA,QAAA,mBAMA;EAHA,YAAA,UASA;EANA,SAAA,YASA;EANA,WAAA,UASA;EANA,MAAA,EAAQ,MAAA,mBASG;EANX,MAAA,EAAQ,MAAA,mBAMO;EAHf,aAAA,UAUoB;EAPpB,SAAA,EAAW,IAAA;AAAA;;;;;KAOD,UAAA;EAEV,mDAAA,OAAA,WAMA;EAHA,SAAA,UASA;EANA,SAAA,UAMgB;EAHhB,MAAA,UAG8C;EAA9C,MAAA,EAAQ,KAAA;IAAQ,WAAA,EAAa,eAAA;IAAiB,KAAA,EAAO,KAAA;EAAA,IAMhC;EAHrB,YAAA,UAUU;EAPV,QAAA,EAAU,WAAA;AAAA;;;;;KAOA,eAAA;EAWV,mCATA,WAAA,UAYA;EATA,WAAA,UAeA;EAZA,MAAA,EAAQ,MAAA,mBAkBR;EAfA,MAAA,EAAQ,MAAM,mBAqBd;EAlBA,KAAA,UAqBe;EAlBf,KAAA,YAwBU;EArBV,WAAA;EAGA,QAAA,mBAoBA;EAjBA,aAAA,YAuBA;EApBA,UAAA,WA0BA;EAvBA,eAAA,WA6BA;EA1BA,eAAA;AAAA;;;;KAMU,UAAA;EAgCA,6EA9BV,WAAA;EAGA,MAAA,WA6BA;EA1BA,QAAA,UAgCA;EA7BA,eAAA,UAgCe;EA7Bf,YAAA,UAuDU;EApDV,mBAAA;EAGA,WAAA,YAiDkB;EA9ClB,aAAA,WAmD0B;EAhD1B,gBAAA,EAAkB,UAAU,CAAC,KAAA;AAAA;;;;KAMnB,sBAAA;EAqDF,sCAnDR,YAAA,UAsDQ;EAnDR,SAAA,YAyDA;EAtDA,QAAA,UAyDK;EAtDL,eAAA;AAAA;;;;KA0BU,QAAA;;;;KAKA,gBAAA;EAgEI,wBA9Dd,WAAA,UA8EyC;EA3EzC,QAAA,mBA2EyC;EAxEzC,WAAA,UA+EM;EA5EN,MAAA,EAAQ,MAAA,mBAqFG;EAlFX,MAAA,EAAQ,MAAM,mBA0FL;EAvFT,aAAA,UAgGY;EA7FZ,KAAA,UA2GA;EAxGA,KAAA;AAAA;AA8GW;AAgBb;;;;AAhBa,KAlGD,eAAA;EA6HW,gEA3HZ,WAAA,EAAa,UAAA,CAAW,KAAA,GA6H9B;EAAA,SA1HM,WAAA,EAAa,UAAA,CAAW,KAAA,GAqIvB;EAAA,SAlID,WAAA,UAmIC;EAAA,SAhID,MAAA,WAkIoB;EA/H7B,QAAA,qBA6GA;EA1GA,eAAA,UA2GqB;EAxGrB,YAAA,UAyGU;EAtGV,WAAA,YAsGE;EAnGF,aAAA,WAqGG;EAlGH,cAAA;AAAA;;;;;;;;;;;AAwH6B;;;UAxGd,0BAAA;;;;;;;EAOf,KAAA,CAAM,MAAA;;;;;;;;EASN,UAAA,CAAW,KAAA;;;;;;;EAQX,QAAA,CAAS,KAAA;;;;;;;;EAST,WAAA,CAAY,MAAA;;;;;;EAOZ,aAAA;;;;;;EAOA,cAAA;;;;;EAMA,WAAA;AAAA;;;;;;;;;;;;;;UAgBe,iBAAA;;;;;;;;;EASf,IAAA,CACE,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;;;EAUH,QAAA,CACE,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;EAQH,QAAA,CAAS,QAAA;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../cascade/src/sync/types.ts"],"mappings":";;;;;;;;KAYY,WAAA;EA0BK,2CAxBf,WAAA,UAGA;EAAA,QAAA,mBAMA;EAHA,YAAA,UASA;EANA,SAAA,YASA;EANA,WAAA,UASA;EANA,MAAA,EAAQ,MAAA,mBASG;EANX,MAAA,EAAQ,MAAA,mBAMO;EAHf,aAAA,UAUoB;EAPpB,SAAA,EAAW,IAAA;AAAA;;;;;KAOD,UAAA;EAEV,mDAAA,OAAA,WAMA;EAHA,SAAA,UASA;EANA,SAAA,UAMgB;EAHhB,MAAA,UAG8C;EAA9C,MAAA,EAAQ,KAAA;IAAQ,WAAA,EAAa,eAAA;IAAiB,KAAA,EAAO,KAAA;EAAA,IAMhC;EAHrB,YAAA,UAUU;EAPV,QAAA,EAAU,WAAA;AAAA;;;;;KAOA,eAAA;EAWV,mCATA,WAAA,UAYA;EATA,WAAA,UAeA;EAZA,MAAA,EAAQ,MAAA,mBAkBR;EAfA,MAAA,EAAQ,MAAM,mBAqBd;EAlBA,KAAA,UAqBe;EAlBf,KAAA,YAwBU;EArBV,WAAA;EAGA,QAAA,mBAoBA;EAjBA,aAAA,YAuBA;EApBA,UAAA,WA0BA;EAvBA,eAAA,WA6BA;EA1BA,eAAA;AAAA;;;;KAMU,UAAA;EAgCA,6EA9BV,WAAA;EAGA,MAAA,WA6BA;EA1BA,QAAA,UAgCA;EA7BA,eAAA,UAgCe;EA7Bf,YAAA,UAuDU;EApDV,mBAAA;EAGA,WAAA,YAiDkB;EA9ClB,aAAA,WAmD0B;EAhD1B,gBAAA,EAAkB,UAAU,CAAC,KAAA;AAAA;;;;KAMnB,sBAAA;EAqDF,sCAnDR,YAAA,UAsDQ;EAnDR,SAAA,YAyDA;EAtDA,QAAA,UAyDK;EAtDL,eAAA;AAAA;;;;KA0BU,QAAA;;;;KAKA,gBAAA;EAgEI,wBA9Dd,WAAA,UA8EyC;EA3EzC,QAAA,mBA2EyC;EAxEzC,WAAA,UA+EM;EA5EN,MAAA,EAAQ,MAAA,mBAqFG;EAlFX,MAAA,EAAQ,MAAM,mBA0FL;EAvFT,aAAA,UAgGY;EA7FZ,KAAA,UA2GA;EAxGA,KAAA;AAAA;AA8GW;AAgBb;;;;AAhBa,KAlGD,eAAA;EA6HW,gEA3HZ,WAAA,EAAa,UAAA,CAAW,KAAA,GA6H9B;EAAA,SA1HM,WAAA,EAAa,UAAA,CAAW,KAAA,GAqIvB;EAAA,SAlID,WAAA,UAmIC;EAAA,SAhID,MAAA,WAkIoB;EA/H7B,QAAA,qBA6GA;EA1GA,eAAA,UA2GqB;EAxGrB,YAAA,UAyGU;EAtGV,WAAA,YAsGE;EAnGF,aAAA,WAqGG;EAlGH,cAAA;AAAA;;;;;;;;;;;AAwH6B;;;UAxGd,0BAAA;;;;;;;EAOf,KAAA,CAAM,MAAA;;;;;;;;EASN,UAAA,CAAW,KAAA;;;;;;;EAQX,QAAA,CAAS,KAAA;;;;;;;;EAST,WAAA,CAAY,MAAA;;;;;;EAOZ,aAAA;;;;;;EAOA,cAAA;;;;;EAMA,WAAA;AAAA;;;;;;;;;;;;;;UAgBe,iBAAA;;;;;;;;;EASf,IAAA,CACE,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;;;EAUH,QAAA,CACE,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,MAAA,EAAQ,UAAA,CAAW,KAAA,GACnB,KAAA,WACC,0BAAA;;;;;;;EAQH,QAAA,CAAS,QAAA;AAAA"}

package/esm/types.d.mts

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/cascade/src/types.d.ts
+//#region ../cascade/src/types.d.ts
 /**
  * Strict mode configuration for handling unknown fields during validation.
  *

package/esm/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../@warlock.js/cascade/src/types.ts"],"mappings":";;AAkBA;;;;AAAsB;AA0BtB;;;;AAA0B;AAsB1B;;;;AAA4B;AAyC5B;;KAzFY,UAAA;;;;;;;;;;;;;;;;;;;;;;;;AA+SyB;KArRzB,cAAA;;;;AA2SY;AA0BxB;;;;;;;;;AA0CY;AAuBZ;;;;AA4BuB;;KA5YX,gBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyCA,aAAA;;;;;;;;;;;EAeV,cAAA;;;;;;;;;;;EAYA,SAAA;;;;;;;;;;;;;;;;;EAkBA,eAAA;;;;;;;;;;;EAYA,aAAA;;;;;;;;;;;;;;;;;EAkBA,eAAA;;;;;;;;;EAcA,UAAA;;;;;;;;;;;;;;EAeA,eAAA;;;;;;;;;;;;;;EAeA,eAAA;;;;;;;;;;;;;;;;EAqBA,cAAA,GAAiB,cAAA;;;;;;;;;;;;;;EAejB,eAAA;;;;;;;;;;;;;;;;;;;EAoBA,UAAA,cAAwB,SAAA;;;;;;;;;;;;;;;EAoBxB,UAAA,GAAa,UAAA;;;;;;;;;;;;;;EAmBb,gBAAA,GAAmB,gBAAA;AAAA;;;;;;;;;;;;;;;;KAsBT,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;KA0BA,iBAAA;;;;;;;EAOV,YAAA,GAAe,YAAY;;;;;;;;;;EAW3B,cAAA;;;;;;;;;;;;;;;;;;;;;;;EAwBA,UAAA;AAAA;;;;;;;;;;;;;;;;;;;;;KAuBU,gBAAA;;;;;;;;;;;EAWV,gBAAA;;;;;;;;;;;;;;;;EAiBA,qBAAqB;AAAA"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../cascade/src/types.ts"],"mappings":";;AAkBA;;;;AAAsB;AA0BtB;;;;AAA0B;AAsB1B;;;;AAA4B;AAyC5B;;KAzFY,UAAA;;;;;;;;;;;;;;;;;;;;;;;;AA+SyB;KArRzB,cAAA;;;;AA2SY;AA0BxB;;;;;;;;;AA0CY;AAuBZ;;;;AA4BuB;;KA5YX,gBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAyCA,aAAA;;;;;;;;;;;EAeV,cAAA;;;;;;;;;;;EAYA,SAAA;;;;;;;;;;;;;;;;;EAkBA,eAAA;;;;;;;;;;;EAYA,aAAA;;;;;;;;;;;;;;;;;EAkBA,eAAA;;;;;;;;;EAcA,UAAA;;;;;;;;;;;;;;EAeA,eAAA;;;;;;;;;;;;;;EAeA,eAAA;;;;;;;;;;;;;;;;EAqBA,cAAA,GAAiB,cAAA;;;;;;;;;;;;;;EAejB,eAAA;;;;;;;;;;;;;;;;;;;EAoBA,UAAA,cAAwB,SAAA;;;;;;;;;;;;;;;EAoBxB,UAAA,GAAa,UAAA;;;;;;;;;;;;;;EAmBb,gBAAA,GAAmB,gBAAA;AAAA;;;;;;;;;;;;;;;;KAsBT,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;KA0BA,iBAAA;;;;;;;EAOV,YAAA,GAAe,YAAY;;;;;;;;;;EAW3B,cAAA;;;;;;;;;;;;;;;;;;;;;;;EAwBA,UAAA;AAAA;;;;;;;;;;;;;;;;;;;;;KAuBU,gBAAA;;;;;;;;;;;EAWV,gBAAA;;;;;;;;;;;;;;;;EAiBA,qBAAqB;AAAA"}

package/esm/utils/connect-to-database.d.mts

@@ -2,7 +2,7 @@ import { DeleteStrategy, MigrationDefaults, ModelDefaults, RelationDefaults } fr
 import { DriverContract, TransactionContext } from "../contracts/database-driver.contract.mjs";
 import { DataSource } from "../data-source/data-source.mjs";
 
-//#region ../@warlock.js/cascade/src/utils/connect-to-database.d.ts
+//#region ../cascade/src/utils/connect-to-database.d.ts
 /**
  * Supported database driver types.
  */

package/esm/utils/connect-to-database.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"connect-to-database.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/utils/connect-to-database.ts"],"mappings":";;;;;;;;KAUY,cAAA;;;;AAAc;AAmB1B;;;;AAAsD;AAwCtD;;;;;;;;KAxCY,kBAAA,GAAqB,OAAO,CAAC,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0RhC;AAgDT;;;KAlSY,iBAAA;EAmSiC;;;;EA1R3C,MAAA,GAAS,cAAA;EA2RD;;;;;EApRR,IAAA;EAmRA;;;;EA7QA,SAAA;EA2Wc;;;EAtWd,QAAA;EAsWgC;;;;AAAoC;AAUtE;EAxWE,OAAA;EAwW+B;;;;;;;EA3V/B,GAAA;EA8VQ;;;;EAxVR,IAAA;EAsVyC;;;;EAhVzC,IAAA;EAkVS;;AAAC;EA7UV,QAAA;;;;EAKA,QAAA;;;;;EAMA,UAAA;;;;;;;EAYA,aAAA,GAAgB,cAAA;;;;;;;EAYhB,aAAA,GAAgB,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDhB,YAAA,GAAe,kBAAA;;;;;;;;;;;;;;;;EAiBf,gBAAA,GAAmB,iBAAA;;;;;;;;;;;;;;;;;EAkBnB,eAAA,GAAkB,gBAAA;;;;;;;;;;;EAgBlB,qBAAA,GAAwB,cAAA;;;;;;;;;;;EAYxB,iBAAA;;;;EASA,UAAA;;;;;;;;;;;;IAYE,aAAA;;;;;;IAOA,KAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDkB,iBAAA,6CACpB,OAAA,EAAS,iBAAA,CAAkB,cAAA,EAAgB,cAAA,IAC1C,OAAA,CAAQ,UAAA;;;;;;;;;;;;iBA6FK,iBAAA,WAA4B,cAAA,WAAyB,CAAC;;;;;iBAUhD,WAAA,UACpB,EAAA,GAAK,GAAA,EAAK,kBAAA,KAAuB,OAAA,CAAQ,CAAA,GACzC,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,CAAA"}
+{"version":3,"file":"connect-to-database.d.mts","names":[],"sources":["../../../../../../../cascade/src/utils/connect-to-database.ts"],"mappings":";;;;;;;;KAUY,cAAA;;;;AAAc;AAmB1B;;;;AAAsD;AAwCtD;;;;;;;;KAxCY,kBAAA,GAAqB,OAAO,CAAC,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0RhC;AAgDT;;;KAlSY,iBAAA;EAmSiC;;;;EA1R3C,MAAA,GAAS,cAAA;EA2RD;;;;;EApRR,IAAA;EAmRA;;;;EA7QA,SAAA;EA2Wc;;;EAtWd,QAAA;EAsWgC;;;;AAAoC;AAUtE;EAxWE,OAAA;EAwW+B;;;;;;;EA3V/B,GAAA;EA8VQ;;;;EAxVR,IAAA;EAsVyC;;;;EAhVzC,IAAA;EAkVS;;AAAC;EA7UV,QAAA;;;;EAKA,QAAA;;;;;EAMA,UAAA;;;;;;;EAYA,aAAA,GAAgB,cAAA;;;;;;;EAYhB,aAAA,GAAgB,cAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmDhB,YAAA,GAAe,kBAAA;;;;;;;;;;;;;;;;EAiBf,gBAAA,GAAmB,iBAAA;;;;;;;;;;;;;;;;;EAkBnB,eAAA,GAAkB,gBAAA;;;;;;;;;;;EAgBlB,qBAAA,GAAwB,cAAA;;;;;;;;;;;EAYxB,iBAAA;;;;EASA,UAAA;;;;;;;;;;;;IAYE,aAAA;;;;;;IAOA,KAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAgDkB,iBAAA,6CACpB,OAAA,EAAS,iBAAA,CAAkB,cAAA,EAAgB,cAAA,IAC1C,OAAA,CAAQ,UAAA;;;;;;;;;;;;iBA6FK,iBAAA,WAA4B,cAAA,WAAyB,CAAC;;;;;iBAUhD,WAAA,UACpB,EAAA,GAAK,GAAA,EAAK,kBAAA,KAAuB,OAAA,CAAQ,CAAA,GACzC,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,CAAA"}

package/esm/utils/connect-to-database.mjs

@@ -4,7 +4,7 @@ import { MongoDbDriver } from "../drivers/mongodb/mongodb-driver.mjs";
 import { PostgresDriver } from "../drivers/postgres/postgres-driver.mjs";
 import "../drivers/postgres/index.mjs";
 
-//#region ../@warlock.js/cascade/src/utils/connect-to-database.ts
+//#region ../cascade/src/utils/connect-to-database.ts
 /**
 * Connect to a database and register the data source.
 *

package/esm/utils/connect-to-database.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"connect-to-database.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/utils/connect-to-database.ts"],"sourcesContent":["import { DriverContract, TransactionContext } from \"../contracts\";\nimport { DataSource } from \"../data-source/data-source\";\nimport { dataSourceRegistry } from \"../data-source/data-source-registry\";\nimport { MongoDbDriver } from \"../drivers/mongodb/mongodb-driver\";\nimport { PostgresDriver } from \"../drivers/postgres\";\nimport type { DeleteStrategy, MigrationDefaults, ModelDefaults, RelationDefaults } from \"../types\";\n\n/**\n * Supported database driver types.\n */\nexport type DatabaseDriver = \"mongodb\" | \"postgres\" | \"mysql\";\n\n/**\n * Default model configuration options.\n *\n * These settings will be applied to all models using this data source,\n * unless overridden by individual model static properties.\n *\n * This is a re-export of Partial<ModelDefaults> for backward compatibility\n * and to provide clearer naming in the connection config context.\n *\n * The full hierarchy is:\n * 1. Model static property (highest priority)\n * 2. Database config modelDefaults (this type)\n * 3. Driver defaults (e.g., snake_case for PostgreSQL, camelCase for MongoDB)\n * 4. Framework defaults (fallback values)\n *\n * @see ModelDefaults for complete type definition and documentation\n */\nexport type ModelDefaultConfig = Partial<ModelDefaults>;\n\n/**\n * Connection options for establishing a database connection.\n *\n * Generic type that separates concerns:\n * - Shared config (driver, name, database, connection details)\n * - Driver options (cascade-next driver-specific settings)\n * - Client options (native database client settings)\n * - Model options (default model behaviors)\n *\n * @template TDriverOptions - Driver-specific options (e.g., MongoDriverOptions)\n * @template TClientOptions - Native client options (e.g., MongoClientOptions from mongodb package)\n *\n * @example\n * ```typescript\n * // MongoDB\n * import type { MongoClientOptions } from \"mongodb\";\n * import type { MongoDriverOptions } from \"@warlock.js/cascade\";\n *\n * const config: ConnectionOptions<MongoDriverOptions, MongoClientOptions> = {\n *   driver: \"mongodb\",\n *   database: \"myapp\",\n *   host: \"localhost\",\n *   port: 27017,\n *   driverOptions: {\n *     autoGenerateId: true,\n *     counterCollection: \"counters\",\n *   },\n *   clientOptions: {\n *     minPoolSize: 5,\n *     maxPoolSize: 10,\n *   },\n *   modelOptions: {\n *     randomIncrement: true,\n *     initialId: 1000,\n *   },\n * };\n * ```\n */\nexport type ConnectionOptions<TDriverOptions = any, TClientOptions = any> = {\n  // ============================================================================\n  // SHARED CONFIGURATION (Framework-level)\n  // ============================================================================\n\n  /**\n   * Database driver to use.\n   * @default \"mongodb\"\n   */\n  driver?: DatabaseDriver;\n\n  /**\n   * Unique name for this data source.\n   * Used for registration in DataSourceRegistry.\n   * @default \"default\"\n   */\n  name?: string;\n\n  /**\n   * Whether this should be the default data source.\n   * @default true\n   */\n  isDefault?: boolean;\n\n  /**\n   * Database name (required).\n   */\n  database: string;\n\n  /**\n   * Enable database operation logging (queries, execution time, parameters).\n   * Highly recommended to keep this disabled in production to prevent sensitive data leakage.\n   *\n   * @default false\n   */\n  logging?: boolean;\n\n  // ============================================================================\n  // CONNECTION DETAILS (Shared across drivers)\n  // ============================================================================\n\n  /**\n   * Database connection URI.\n   * Alternative to specifying host/port separately.\n   *\n   * @example \"mongodb://localhost:27017/mydb\"\n   * @example \"postgresql://user:pass@localhost:5432/mydb\"\n   */\n  uri?: string;\n\n  /**\n   * Database host.\n   * @default \"localhost\"\n   */\n  host?: string;\n\n  /**\n   * Database port.\n   * @default 27017 (MongoDB), 5432 (PostgreSQL)\n   */\n  port?: number;\n\n  /**\n   * Database username for authentication.\n   */\n  username?: string;\n\n  /**\n   * Database password for authentication.\n   */\n  password?: string;\n\n  /**\n   * Authentication source database.\n   * Typically \"admin\" for MongoDB.\n   */\n  authSource?: string;\n\n  // ============================================================================\n  // DRIVER OPTIONS (Package-level, driver-specific)\n  // ============================================================================\n\n  /**\n   * Driver-specific options.\n   *\n   * For MongoDB: { autoGenerateId, counterCollection, transactionOptions }\n   * For PostgreSQL: { schema, ... }\n   */\n  driverOptions?: TDriverOptions;\n\n  // ============================================================================\n  // CLIENT OPTIONS (Native database client library)\n  // ============================================================================\n\n  /**\n   * Native database client options.\n   *\n   * For MongoDB: MongoClientOptions from 'mongodb' package\n   * For PostgreSQL: PoolConfig from 'pg' package\n   */\n  clientOptions?: TClientOptions;\n\n  // ============================================================================\n  // MODEL OPTIONS (Model defaults)\n  // ============================================================================\n\n  /**\n   * Default model configuration for all models using this data source.\n   *\n   * These settings override driver defaults but are overridden by\n   * individual model static properties.\n   *\n   * **Configuration Hierarchy (highest to lowest):**\n   * 1. Model static property - `User.createdAtColumn = \"creation_date\"`\n   * 2. **modelOptions (this)** - Database-wide overrides\n   * 3. Driver defaults - PostgreSQL: snake_case, MongoDB: camelCase\n   * 4. Framework defaults - Fallback values\n   *\n   * @example\n   * ```typescript\n   * // PostgreSQL database with custom settings\n   * {\n   *   driver: \"postgres\",\n   *   modelOptions: {\n   *     // Override PostgreSQL default (snake_case) to use camelCase\n   *     namingConvention: \"camelCase\",\n   *     createdAtColumn: \"createdAt\",\n   *     updatedAtColumn: \"updatedAt\",\n   *\n   *     // ID generation settings (for MongoDB)\n   *     randomIncrement: true,\n   *     initialId: 1000,\n   *\n   *     // Deletion settings\n   *     deleteStrategy: \"soft\",\n   *     trashTable: \"archive\", // All models use same trash table\n   *   }\n   * }\n   *\n   * // MongoDB database with defaults\n   * {\n   *   driver: \"mongodb\",\n   *   modelOptions: {\n   *     // MongoDB already uses camelCase by default\n   *     randomIncrement: true,\n   *     initialId: 10000,\n   *     deleteStrategy: \"trash\", // Use RecycleBin\n   *   }\n   * }\n   * ```\n   */\n  modelOptions?: ModelDefaultConfig;\n\n  /**\n   * Migration-level defaults (UUID strategy, etc.).\n   *\n   * These defaults override driver migration defaults but can be\n   * overridden by individual migration calls.\n   *\n   * @default undefined (uses driver defaults)\n   *\n   * @example\n   * ```typescript\n   * migrationDefaults: {\n   *   uuidStrategy: \"v7\", // Use UUID v7 for all migrations\n   * }\n   * ```\n   */\n  migrationOptions?: MigrationDefaults;\n\n  /**\n   * Defaults for relation conventions — foreign-key suffix and pivot-table\n   * naming order. Controls how `@BelongsTo` / `@HasOne` / `@HasMany` /\n   * `@BelongsToMany` infer column / table names when none are explicitly\n   * configured on the decorator.\n   *\n   * @default undefined (uses framework defaults: `\"_id\"` suffix + alphabetical pivot)\n   *\n   * @example\n   * ```typescript\n   * relationOptions: {\n   *   foreignKeySuffix: \"_id\",\n   *   pivotTableNamingOrder: \"alphabetical\",\n   * }\n   * ```\n   */\n  relationOptions?: RelationDefaults;\n\n  // ============================================================================\n  // DATA SOURCE DEFAULTS\n  // ============================================================================\n\n  /**\n   * Default delete strategy for models using this data source.\n   *\n   * - MongoDB: Typically `\"trash\"` (uses RecycleBin collection)\n   * - PostgreSQL: Typically `\"permanent\"` or `\"soft\"`\n   *\n   * Can be overridden by model static property or destroy() options.\n   *\n   * @default undefined (falls back to \"permanent\")\n   */\n  defaultDeleteStrategy?: DeleteStrategy;\n\n  /**\n   * Default trash table/collection name for \"trash\" delete strategy.\n   *\n   * - MongoDB: Typically `\"RecycleBin\"`\n   * - If not set, defaults to `{table}Trash` pattern\n   *\n   * Can be overridden by Model.trashTable static property.\n   *\n   * @default undefined (uses {table}Trash pattern)\n   */\n  defaultTrashTable?: string;\n\n  // ============================================================================\n  // MIGRATION OPTIONS\n  // ============================================================================\n\n  /**\n   * Migration configuration options.\n   */\n  migrations?: {\n    /**\n     * Whether to wrap migrations in database transactions.\n     *\n     * Overrides driver defaults:\n     * - PostgreSQL default: `true` (DDL is transactional)\n     * - MongoDB default: `false` (DDL cannot be transactional)\n     *\n     * Individual migrations can override this with their own `transactional` property.\n     *\n     * @default undefined (uses driver default)\n     */\n    transactional?: boolean;\n\n    /**\n     * Name of the migrations tracking table/collection.\n     *\n     * @default \"_migrations\"\n     */\n    table?: string;\n  };\n};\n\n/**\n * Connect to a database and register the data source.\n *\n * This is a high-level utility function that simplifies database connection\n * for small to medium projects. It handles driver instantiation, connection,\n * data source creation, and automatic registration.\n *\n * **Supported Drivers:**\n * - `mongodb` (default) - MongoDB driver with optional auto ID generation\n * - `postgres` - PostgreSQL driver (not yet implemented)\n * - `mysql` - MySQL driver (not yet implemented)\n *\n * **Features:**\n * - Automatic driver instantiation based on driver name\n * - Connection establishment and error handling\n * - DataSource creation and registration\n * - Support for MongoDB-specific features (ID generation, transactions)\n *\n * @param options - Connection configuration options\n * @returns A connected and registered DataSource instance\n * @throws {Error} If connection fails or driver is not implemented\n *\n * @example\n * ```typescript\n * // MongoDB with new structure\n * const dataSource = await connectToDatabase({\n *   driver: \"mongodb\",\n *   database: \"myapp\",\n *   host: \"localhost\",\n *   port: 27017,\n *   driverOptions: {\n *     autoGenerateId: true,\n *   },\n *   clientOptions: {\n *     minPoolSize: 5,\n *     maxPoolSize: 10,\n *   },\n *   modelOptions: {\n *     randomIncrement: true,\n *     initialId: 1000,\n *   },\n * });\n * ```\n */\nexport async function connectToDatabase<TDriverOptions = any, TClientOptions = any>(\n  options: ConnectionOptions<TDriverOptions, TClientOptions>,\n): Promise<DataSource> {\n  // Default values\n  const driverType = options.driver ?? \"mongodb\";\n  const dataSourceName = options.name ?? \"default\";\n  const isDefault = options.isDefault ?? true;\n\n  // Create driver based on type\n  let driver: DriverContract;\n\n  switch (driverType) {\n    case \"mongodb\": {\n      driver = new MongoDbDriver(\n        {\n          database: options.database,\n          uri: options.uri,\n          host: options.host,\n          port: options.port,\n          username: options.username,\n          password: options.password,\n          authSource: options.authSource,\n          logging: options.logging,\n          clientOptions: options.clientOptions as any,\n        },\n        options.driverOptions as any,\n      );\n      break;\n    }\n\n    case \"postgres\": {\n      driver = new PostgresDriver({\n        database: options.database,\n        connectionString: options.uri,\n        host: options.host,\n        port: options.port ?? 5432,\n        user: options.username,\n        password: options.password,\n        logging: options.logging,\n        // Spread any additional client options (pool settings, SSL, etc.)\n        ...(options.clientOptions as object),\n      });\n      break;\n    }\n\n    case \"mysql\":\n      throw new Error(\"MySQL driver is not yet implemented. Coming soon!\");\n\n    default:\n      throw new Error(\n        `Unknown driver: \"${driverType}\". Supported drivers: mongodb, postgres, mysql`,\n      );\n  }\n\n  // Create data source\n  const dataSource = new DataSource({\n    name: dataSourceName,\n    driver,\n    isDefault,\n    defaultDeleteStrategy: options.defaultDeleteStrategy,\n    defaultTrashTable: options.defaultTrashTable,\n    modelDefaults: options.modelOptions,\n    migrationDefaults: options.migrationOptions,\n    relationDefaults: options.relationOptions,\n    migrations: options.migrations,\n  });\n\n  // Register data source\n  dataSourceRegistry.register(dataSource);\n\n  // Connect to the database\n  try {\n    await driver.connect();\n  } catch (error) {\n    console.log(error);\n\n    throw new Error(\n      `Failed to connect to ${driverType} database: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  return dataSource;\n}\n\n/**\n * Get current driver instance.\n *\n * @example\n * ```typescript\n * const driver = getDatabaseDriver();\n *\n * // Pass type to return Postgres driver type\n * const pgDriver = getDatabaseDriver<PostgresDriver>();\n * ```\n */\nexport function getDatabaseDriver<T extends DriverContract = any>(): T {\n  const driver = dataSourceRegistry.get().driver;\n\n  return driver as unknown as T;\n}\n\n/**\n * Perform database transaction(s)\n * Shorthand to `dataSourceRegister.get().driver.transaction\n */\nexport async function transaction<T = any>(\n  fn: (ctx: TransactionContext) => Promise<T>,\n  options?: Record<string, unknown>,\n): Promise<T> {\n  return getDatabaseDriver().transaction(fn, options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuWA,eAAsB,kBACpB,SACqB;CAErB,MAAM,aAAa,QAAQ,UAAU;CACrC,MAAM,iBAAiB,QAAQ,QAAQ;CACvC,MAAM,YAAY,QAAQ,aAAa;CAGvC,IAAI;CAEJ,QAAQ,YAAR;EACE,KAAK;GACH,SAAS,IAAI,cACX;IACE,UAAU,QAAQ;IAClB,KAAK,QAAQ;IACb,MAAM,QAAQ;IACd,MAAM,QAAQ;IACd,UAAU,QAAQ;IAClB,UAAU,QAAQ;IAClB,YAAY,QAAQ;IACpB,SAAS,QAAQ;IACjB,eAAe,QAAQ;GACzB,GACA,QAAQ,aACV;GACA;EAGF,KAAK;GACH,SAAS,IAAI,eAAe;IAC1B,UAAU,QAAQ;IAClB,kBAAkB,QAAQ;IAC1B,MAAM,QAAQ;IACd,MAAM,QAAQ,QAAQ;IACtB,MAAM,QAAQ;IACd,UAAU,QAAQ;IAClB,SAAS,QAAQ;IAEjB,GAAI,QAAQ;GACd,CAAC;GACD;EAGF,KAAK,SACH,MAAM,IAAI,MAAM,mDAAmD;EAErE,SACE,MAAM,IAAI,MACR,oBAAoB,WAAW,+CACjC;CACJ;CAGA,MAAM,aAAa,IAAI,WAAW;EAChC,MAAM;EACN;EACA;EACA,uBAAuB,QAAQ;EAC/B,mBAAmB,QAAQ;EAC3B,eAAe,QAAQ;EACvB,mBAAmB,QAAQ;EAC3B,kBAAkB,QAAQ;EAC1B,YAAY,QAAQ;CACtB,CAAC;CAGD,mBAAmB,SAAS,UAAU;CAGtC,IAAI;EACF,MAAM,OAAO,QAAQ;CACvB,SAAS,OAAO;EACd,QAAQ,IAAI,KAAK;EAEjB,MAAM,IAAI,MACR,wBAAwB,WAAW,aAAa,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACvG;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,oBAAuD;CAGrE,OAFe,mBAAmB,IAAI,CAAC,CAAC;AAG1C;;;;;AAMA,eAAsB,YACpB,IACA,SACY;CACZ,OAAO,kBAAkB,CAAC,CAAC,YAAY,IAAI,OAAO;AACpD"}
+{"version":3,"file":"connect-to-database.mjs","names":[],"sources":["../../../../../../../cascade/src/utils/connect-to-database.ts"],"sourcesContent":["import { DriverContract, TransactionContext } from \"../contracts\";\nimport { DataSource } from \"../data-source/data-source\";\nimport { dataSourceRegistry } from \"../data-source/data-source-registry\";\nimport { MongoDbDriver } from \"../drivers/mongodb/mongodb-driver\";\nimport { PostgresDriver } from \"../drivers/postgres\";\nimport type { DeleteStrategy, MigrationDefaults, ModelDefaults, RelationDefaults } from \"../types\";\n\n/**\n * Supported database driver types.\n */\nexport type DatabaseDriver = \"mongodb\" | \"postgres\" | \"mysql\";\n\n/**\n * Default model configuration options.\n *\n * These settings will be applied to all models using this data source,\n * unless overridden by individual model static properties.\n *\n * This is a re-export of Partial<ModelDefaults> for backward compatibility\n * and to provide clearer naming in the connection config context.\n *\n * The full hierarchy is:\n * 1. Model static property (highest priority)\n * 2. Database config modelDefaults (this type)\n * 3. Driver defaults (e.g., snake_case for PostgreSQL, camelCase for MongoDB)\n * 4. Framework defaults (fallback values)\n *\n * @see ModelDefaults for complete type definition and documentation\n */\nexport type ModelDefaultConfig = Partial<ModelDefaults>;\n\n/**\n * Connection options for establishing a database connection.\n *\n * Generic type that separates concerns:\n * - Shared config (driver, name, database, connection details)\n * - Driver options (cascade-next driver-specific settings)\n * - Client options (native database client settings)\n * - Model options (default model behaviors)\n *\n * @template TDriverOptions - Driver-specific options (e.g., MongoDriverOptions)\n * @template TClientOptions - Native client options (e.g., MongoClientOptions from mongodb package)\n *\n * @example\n * ```typescript\n * // MongoDB\n * import type { MongoClientOptions } from \"mongodb\";\n * import type { MongoDriverOptions } from \"@warlock.js/cascade\";\n *\n * const config: ConnectionOptions<MongoDriverOptions, MongoClientOptions> = {\n *   driver: \"mongodb\",\n *   database: \"myapp\",\n *   host: \"localhost\",\n *   port: 27017,\n *   driverOptions: {\n *     autoGenerateId: true,\n *     counterCollection: \"counters\",\n *   },\n *   clientOptions: {\n *     minPoolSize: 5,\n *     maxPoolSize: 10,\n *   },\n *   modelOptions: {\n *     randomIncrement: true,\n *     initialId: 1000,\n *   },\n * };\n * ```\n */\nexport type ConnectionOptions<TDriverOptions = any, TClientOptions = any> = {\n  // ============================================================================\n  // SHARED CONFIGURATION (Framework-level)\n  // ============================================================================\n\n  /**\n   * Database driver to use.\n   * @default \"mongodb\"\n   */\n  driver?: DatabaseDriver;\n\n  /**\n   * Unique name for this data source.\n   * Used for registration in DataSourceRegistry.\n   * @default \"default\"\n   */\n  name?: string;\n\n  /**\n   * Whether this should be the default data source.\n   * @default true\n   */\n  isDefault?: boolean;\n\n  /**\n   * Database name (required).\n   */\n  database: string;\n\n  /**\n   * Enable database operation logging (queries, execution time, parameters).\n   * Highly recommended to keep this disabled in production to prevent sensitive data leakage.\n   *\n   * @default false\n   */\n  logging?: boolean;\n\n  // ============================================================================\n  // CONNECTION DETAILS (Shared across drivers)\n  // ============================================================================\n\n  /**\n   * Database connection URI.\n   * Alternative to specifying host/port separately.\n   *\n   * @example \"mongodb://localhost:27017/mydb\"\n   * @example \"postgresql://user:pass@localhost:5432/mydb\"\n   */\n  uri?: string;\n\n  /**\n   * Database host.\n   * @default \"localhost\"\n   */\n  host?: string;\n\n  /**\n   * Database port.\n   * @default 27017 (MongoDB), 5432 (PostgreSQL)\n   */\n  port?: number;\n\n  /**\n   * Database username for authentication.\n   */\n  username?: string;\n\n  /**\n   * Database password for authentication.\n   */\n  password?: string;\n\n  /**\n   * Authentication source database.\n   * Typically \"admin\" for MongoDB.\n   */\n  authSource?: string;\n\n  // ============================================================================\n  // DRIVER OPTIONS (Package-level, driver-specific)\n  // ============================================================================\n\n  /**\n   * Driver-specific options.\n   *\n   * For MongoDB: { autoGenerateId, counterCollection, transactionOptions }\n   * For PostgreSQL: { schema, ... }\n   */\n  driverOptions?: TDriverOptions;\n\n  // ============================================================================\n  // CLIENT OPTIONS (Native database client library)\n  // ============================================================================\n\n  /**\n   * Native database client options.\n   *\n   * For MongoDB: MongoClientOptions from 'mongodb' package\n   * For PostgreSQL: PoolConfig from 'pg' package\n   */\n  clientOptions?: TClientOptions;\n\n  // ============================================================================\n  // MODEL OPTIONS (Model defaults)\n  // ============================================================================\n\n  /**\n   * Default model configuration for all models using this data source.\n   *\n   * These settings override driver defaults but are overridden by\n   * individual model static properties.\n   *\n   * **Configuration Hierarchy (highest to lowest):**\n   * 1. Model static property - `User.createdAtColumn = \"creation_date\"`\n   * 2. **modelOptions (this)** - Database-wide overrides\n   * 3. Driver defaults - PostgreSQL: snake_case, MongoDB: camelCase\n   * 4. Framework defaults - Fallback values\n   *\n   * @example\n   * ```typescript\n   * // PostgreSQL database with custom settings\n   * {\n   *   driver: \"postgres\",\n   *   modelOptions: {\n   *     // Override PostgreSQL default (snake_case) to use camelCase\n   *     namingConvention: \"camelCase\",\n   *     createdAtColumn: \"createdAt\",\n   *     updatedAtColumn: \"updatedAt\",\n   *\n   *     // ID generation settings (for MongoDB)\n   *     randomIncrement: true,\n   *     initialId: 1000,\n   *\n   *     // Deletion settings\n   *     deleteStrategy: \"soft\",\n   *     trashTable: \"archive\", // All models use same trash table\n   *   }\n   * }\n   *\n   * // MongoDB database with defaults\n   * {\n   *   driver: \"mongodb\",\n   *   modelOptions: {\n   *     // MongoDB already uses camelCase by default\n   *     randomIncrement: true,\n   *     initialId: 10000,\n   *     deleteStrategy: \"trash\", // Use RecycleBin\n   *   }\n   * }\n   * ```\n   */\n  modelOptions?: ModelDefaultConfig;\n\n  /**\n   * Migration-level defaults (UUID strategy, etc.).\n   *\n   * These defaults override driver migration defaults but can be\n   * overridden by individual migration calls.\n   *\n   * @default undefined (uses driver defaults)\n   *\n   * @example\n   * ```typescript\n   * migrationDefaults: {\n   *   uuidStrategy: \"v7\", // Use UUID v7 for all migrations\n   * }\n   * ```\n   */\n  migrationOptions?: MigrationDefaults;\n\n  /**\n   * Defaults for relation conventions — foreign-key suffix and pivot-table\n   * naming order. Controls how `@BelongsTo` / `@HasOne` / `@HasMany` /\n   * `@BelongsToMany` infer column / table names when none are explicitly\n   * configured on the decorator.\n   *\n   * @default undefined (uses framework defaults: `\"_id\"` suffix + alphabetical pivot)\n   *\n   * @example\n   * ```typescript\n   * relationOptions: {\n   *   foreignKeySuffix: \"_id\",\n   *   pivotTableNamingOrder: \"alphabetical\",\n   * }\n   * ```\n   */\n  relationOptions?: RelationDefaults;\n\n  // ============================================================================\n  // DATA SOURCE DEFAULTS\n  // ============================================================================\n\n  /**\n   * Default delete strategy for models using this data source.\n   *\n   * - MongoDB: Typically `\"trash\"` (uses RecycleBin collection)\n   * - PostgreSQL: Typically `\"permanent\"` or `\"soft\"`\n   *\n   * Can be overridden by model static property or destroy() options.\n   *\n   * @default undefined (falls back to \"permanent\")\n   */\n  defaultDeleteStrategy?: DeleteStrategy;\n\n  /**\n   * Default trash table/collection name for \"trash\" delete strategy.\n   *\n   * - MongoDB: Typically `\"RecycleBin\"`\n   * - If not set, defaults to `{table}Trash` pattern\n   *\n   * Can be overridden by Model.trashTable static property.\n   *\n   * @default undefined (uses {table}Trash pattern)\n   */\n  defaultTrashTable?: string;\n\n  // ============================================================================\n  // MIGRATION OPTIONS\n  // ============================================================================\n\n  /**\n   * Migration configuration options.\n   */\n  migrations?: {\n    /**\n     * Whether to wrap migrations in database transactions.\n     *\n     * Overrides driver defaults:\n     * - PostgreSQL default: `true` (DDL is transactional)\n     * - MongoDB default: `false` (DDL cannot be transactional)\n     *\n     * Individual migrations can override this with their own `transactional` property.\n     *\n     * @default undefined (uses driver default)\n     */\n    transactional?: boolean;\n\n    /**\n     * Name of the migrations tracking table/collection.\n     *\n     * @default \"_migrations\"\n     */\n    table?: string;\n  };\n};\n\n/**\n * Connect to a database and register the data source.\n *\n * This is a high-level utility function that simplifies database connection\n * for small to medium projects. It handles driver instantiation, connection,\n * data source creation, and automatic registration.\n *\n * **Supported Drivers:**\n * - `mongodb` (default) - MongoDB driver with optional auto ID generation\n * - `postgres` - PostgreSQL driver (not yet implemented)\n * - `mysql` - MySQL driver (not yet implemented)\n *\n * **Features:**\n * - Automatic driver instantiation based on driver name\n * - Connection establishment and error handling\n * - DataSource creation and registration\n * - Support for MongoDB-specific features (ID generation, transactions)\n *\n * @param options - Connection configuration options\n * @returns A connected and registered DataSource instance\n * @throws {Error} If connection fails or driver is not implemented\n *\n * @example\n * ```typescript\n * // MongoDB with new structure\n * const dataSource = await connectToDatabase({\n *   driver: \"mongodb\",\n *   database: \"myapp\",\n *   host: \"localhost\",\n *   port: 27017,\n *   driverOptions: {\n *     autoGenerateId: true,\n *   },\n *   clientOptions: {\n *     minPoolSize: 5,\n *     maxPoolSize: 10,\n *   },\n *   modelOptions: {\n *     randomIncrement: true,\n *     initialId: 1000,\n *   },\n * });\n * ```\n */\nexport async function connectToDatabase<TDriverOptions = any, TClientOptions = any>(\n  options: ConnectionOptions<TDriverOptions, TClientOptions>,\n): Promise<DataSource> {\n  // Default values\n  const driverType = options.driver ?? \"mongodb\";\n  const dataSourceName = options.name ?? \"default\";\n  const isDefault = options.isDefault ?? true;\n\n  // Create driver based on type\n  let driver: DriverContract;\n\n  switch (driverType) {\n    case \"mongodb\": {\n      driver = new MongoDbDriver(\n        {\n          database: options.database,\n          uri: options.uri,\n          host: options.host,\n          port: options.port,\n          username: options.username,\n          password: options.password,\n          authSource: options.authSource,\n          logging: options.logging,\n          clientOptions: options.clientOptions as any,\n        },\n        options.driverOptions as any,\n      );\n      break;\n    }\n\n    case \"postgres\": {\n      driver = new PostgresDriver({\n        database: options.database,\n        connectionString: options.uri,\n        host: options.host,\n        port: options.port ?? 5432,\n        user: options.username,\n        password: options.password,\n        logging: options.logging,\n        // Spread any additional client options (pool settings, SSL, etc.)\n        ...(options.clientOptions as object),\n      });\n      break;\n    }\n\n    case \"mysql\":\n      throw new Error(\"MySQL driver is not yet implemented. Coming soon!\");\n\n    default:\n      throw new Error(\n        `Unknown driver: \"${driverType}\". Supported drivers: mongodb, postgres, mysql`,\n      );\n  }\n\n  // Create data source\n  const dataSource = new DataSource({\n    name: dataSourceName,\n    driver,\n    isDefault,\n    defaultDeleteStrategy: options.defaultDeleteStrategy,\n    defaultTrashTable: options.defaultTrashTable,\n    modelDefaults: options.modelOptions,\n    migrationDefaults: options.migrationOptions,\n    relationDefaults: options.relationOptions,\n    migrations: options.migrations,\n  });\n\n  // Register data source\n  dataSourceRegistry.register(dataSource);\n\n  // Connect to the database\n  try {\n    await driver.connect();\n  } catch (error) {\n    console.log(error);\n\n    throw new Error(\n      `Failed to connect to ${driverType} database: ${error instanceof Error ? error.message : String(error)}`,\n    );\n  }\n\n  return dataSource;\n}\n\n/**\n * Get current driver instance.\n *\n * @example\n * ```typescript\n * const driver = getDatabaseDriver();\n *\n * // Pass type to return Postgres driver type\n * const pgDriver = getDatabaseDriver<PostgresDriver>();\n * ```\n */\nexport function getDatabaseDriver<T extends DriverContract = any>(): T {\n  const driver = dataSourceRegistry.get().driver;\n\n  return driver as unknown as T;\n}\n\n/**\n * Perform database transaction(s)\n * Shorthand to `dataSourceRegister.get().driver.transaction\n */\nexport async function transaction<T = any>(\n  fn: (ctx: TransactionContext) => Promise<T>,\n  options?: Record<string, unknown>,\n): Promise<T> {\n  return getDatabaseDriver().transaction(fn, options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuWA,eAAsB,kBACpB,SACqB;CAErB,MAAM,aAAa,QAAQ,UAAU;CACrC,MAAM,iBAAiB,QAAQ,QAAQ;CACvC,MAAM,YAAY,QAAQ,aAAa;CAGvC,IAAI;CAEJ,QAAQ,YAAR;EACE,KAAK;GACH,SAAS,IAAI,cACX;IACE,UAAU,QAAQ;IAClB,KAAK,QAAQ;IACb,MAAM,QAAQ;IACd,MAAM,QAAQ;IACd,UAAU,QAAQ;IAClB,UAAU,QAAQ;IAClB,YAAY,QAAQ;IACpB,SAAS,QAAQ;IACjB,eAAe,QAAQ;GACzB,GACA,QAAQ,aACV;GACA;EAGF,KAAK;GACH,SAAS,IAAI,eAAe;IAC1B,UAAU,QAAQ;IAClB,kBAAkB,QAAQ;IAC1B,MAAM,QAAQ;IACd,MAAM,QAAQ,QAAQ;IACtB,MAAM,QAAQ;IACd,UAAU,QAAQ;IAClB,SAAS,QAAQ;IAEjB,GAAI,QAAQ;GACd,CAAC;GACD;EAGF,KAAK,SACH,MAAM,IAAI,MAAM,mDAAmD;EAErE,SACE,MAAM,IAAI,MACR,oBAAoB,WAAW,+CACjC;CACJ;CAGA,MAAM,aAAa,IAAI,WAAW;EAChC,MAAM;EACN;EACA;EACA,uBAAuB,QAAQ;EAC/B,mBAAmB,QAAQ;EAC3B,eAAe,QAAQ;EACvB,mBAAmB,QAAQ;EAC3B,kBAAkB,QAAQ;EAC1B,YAAY,QAAQ;CACtB,CAAC;CAGD,mBAAmB,SAAS,UAAU;CAGtC,IAAI;EACF,MAAM,OAAO,QAAQ;CACvB,SAAS,OAAO;EACd,QAAQ,IAAI,KAAK;EAEjB,MAAM,IAAI,MACR,wBAAwB,WAAW,aAAa,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,GACvG;CACF;CAEA,OAAO;AACT;;;;;;;;;;;;AAaA,SAAgB,oBAAuD;CAGrE,OAFe,mBAAmB,IAAI,CAAC,CAAC;AAG1C;;;;;AAMA,eAAsB,YACpB,IACA,SACY;CACZ,OAAO,kBAAkB,CAAC,CAAC,YAAY,IAAI,OAAO;AACpD"}

package/esm/utils/database-writer.utils.d.mts

@@ -1,6 +1,6 @@
 import { Model } from "../model/model.mjs";
 
-//#region ../@warlock.js/cascade/src/utils/database-writer.utils.d.ts
+//#region ../cascade/src/utils/database-writer.utils.d.ts
 type transformCallbackOptions = {
   model: Model;
   column: string;

package/esm/utils/database-writer.utils.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-writer.utils.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/utils/database-writer.utils.ts"],"mappings":";;;KAGK,wBAAA;EACH,KAAA,EAAO,KAAK;EACZ,MAAA;EACA,KAAA;EACA,SAAA;EACA,KAAA;AAAA;AAAA,KAGU,sBAAA,IAA0B,OAAiC,EAAxB,wBAAwB;;;;iBAKvD,mBAAA,CAAoB,QAAA,EAAU,sBAAA,GAAsB,mBAAA"}
+{"version":3,"file":"database-writer.utils.d.mts","names":[],"sources":["../../../../../../../cascade/src/utils/database-writer.utils.ts"],"mappings":";;;KAGK,wBAAA;EACH,KAAA,EAAO,KAAK;EACZ,MAAA;EACA,KAAA;EACA,SAAA;EACA,KAAA;AAAA;AAAA,KAGU,sBAAA,IAA0B,OAAiC,EAAxB,wBAAwB;;;;iBAKvD,mBAAA,CAAoB,QAAA,EAAU,sBAAA,GAAsB,mBAAA"}

package/esm/utils/database-writer.utils.mjs

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/cascade/src/utils/database-writer.utils.ts
+//#region ../cascade/src/utils/database-writer.utils.ts
 /**
 * Transfer value before saving it into the database
 */

package/esm/utils/database-writer.utils.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-writer.utils.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/utils/database-writer.utils.ts"],"sourcesContent":["import { type TransformerCallback } from \"@warlock.js/seal\";\nimport { type Model } from \"../model/model\";\n\ntype transformCallbackOptions = {\n  model: Model;\n  column: string;\n  value: any;\n  isChanged: boolean;\n  isNew: boolean;\n};\n\nexport type ModelTransformCallback = (options: transformCallbackOptions) => string;\n\n/**\n * Transfer value before saving it into the database\n */\nexport function useModelTransformer(callback: ModelTransformCallback) {\n  const transformCallback: TransformerCallback = (data, { context }) => {\n    const model = context.rootContext?.model as Model;\n    const column = context.key;\n    const value = data;\n    const isChanged = model.isDirty(column);\n    const isNew = model.isNew;\n    return callback({ model, column, value, isChanged, isNew });\n  };\n\n  return transformCallback;\n}\n"],"mappings":";;;;AAgBA,SAAgB,oBAAoB,UAAkC;CACpE,MAAM,qBAA0C,MAAM,EAAE,cAAc;EACpE,MAAM,QAAQ,QAAQ,aAAa;EACnC,MAAM,SAAS,QAAQ;EACvB,MAAM,QAAQ;EACd,MAAM,YAAY,MAAM,QAAQ,MAAM;EACtC,MAAM,QAAQ,MAAM;EACpB,OAAO,SAAS;GAAE;GAAO;GAAQ;GAAO;GAAW;EAAM,CAAC;CAC5D;CAEA,OAAO;AACT"}
+{"version":3,"file":"database-writer.utils.mjs","names":[],"sources":["../../../../../../../cascade/src/utils/database-writer.utils.ts"],"sourcesContent":["import { type TransformerCallback } from \"@warlock.js/seal\";\nimport { type Model } from \"../model/model\";\n\ntype transformCallbackOptions = {\n  model: Model;\n  column: string;\n  value: any;\n  isChanged: boolean;\n  isNew: boolean;\n};\n\nexport type ModelTransformCallback = (options: transformCallbackOptions) => string;\n\n/**\n * Transfer value before saving it into the database\n */\nexport function useModelTransformer(callback: ModelTransformCallback) {\n  const transformCallback: TransformerCallback = (data, { context }) => {\n    const model = context.rootContext?.model as Model;\n    const column = context.key;\n    const value = data;\n    const isChanged = model.isDirty(column);\n    const isNew = model.isNew;\n    return callback({ model, column, value, isChanged, isNew });\n  };\n\n  return transformCallback;\n}\n"],"mappings":";;;;AAgBA,SAAgB,oBAAoB,UAAkC;CACpE,MAAM,qBAA0C,MAAM,EAAE,cAAc;EACpE,MAAM,QAAQ,QAAQ,aAAa;EACnC,MAAM,SAAS,QAAQ;EACvB,MAAM,QAAQ;EACd,MAAM,YAAY,MAAM,QAAQ,MAAM;EACtC,MAAM,QAAQ,MAAM;EACpB,OAAO,SAAS;GAAE;GAAO;GAAQ;GAAO;GAAW;EAAM,CAAC;CAC5D;CAEA,OAAO;AACT"}

package/esm/utils/define-model.d.mts

@@ -3,7 +3,7 @@ import { ModelSchema } from "../model/model.types.mjs";
 import { Model } from "../model/model.mjs";
 import { Infer, ObjectValidator } from "@warlock.js/seal";
 
-//#region ../@warlock.js/cascade/src/utils/define-model.d.ts
+//#region ../cascade/src/utils/define-model.d.ts
 /**
  * Configuration options for defining a model.
  */

package/esm/utils/define-model.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"define-model.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/utils/define-model.ts"],"mappings":";;;;;;;;AASA;KAAY,kBAAA,iBAAmC,WAAA;EAAjB;;;EAI5B,KAAA;EAiCa;;;;EA3Bb,IAAA;EA2FU;;;;EArFV,MAAA,EAAQ,eAAA;EAZR;;;;;;;;;;EAwBA,cAAA,GAAiB,cAAA;EAuDjB;;;;;;;EA9CA,UAAA,GAAa,UAAA;EAgEG;AA2DlB;;;;;EAnHE,cAAA;EAsHoB;;;;;EA/GpB,eAAA;EAoH8B;;;;;EA7G9B,SAAA;EA8G4B;;;;;;;;;;;;;;;;;;;;;;EAtF5B,UAAA,GAAa,QAAA,CAAS,KAAA,CAAM,OAAA,KAAY,MAAA;EAiFvB;;;;;;;;;;;;;;;;EA/DjB,OAAA,GAAU,MAAA;AAAA;;;;;;;;;;;;;;;;;AAgJwE;AAwBpF;;;;;;;;;;;;;;;;;;;;AAIO;;;;;;;;;;;;;;;;;;;iBAjHS,WAAA,iBACE,WAAA,2BACS,eAAA,GAAkB,eAAA,sBACvB,MAAA,qCACH,MAAA,oBAEjB,OAAA,EAAS,kBAAA,CAAmB,OAAA;EAC1B,MAAA,EAAQ,gBAAA;EACR,UAAA,GAAa,QAAA,CAAS,KAAA,CAAM,KAAA,CAAM,MAAA,CAAO,gBAAA,MAAsB,WAAA;EAC/D,OAAA,GAAU,QAAA,QAAgB,KAAA,CAAM,KAAA,CAAM,MAAA,CAAO,gBAAA,MAAsB,QAAA;AAAA,UACpE,WAAA,GA2EoB,OAAA,CAAO,KAAA,CAAA,MAAA,CAAA,gBAAA,OAAmB,KAAA,CAAK,KAAA,CAAA,MAAA,CAAA,gBAAA,KAAmB,WAAA,IAAW,IAAA,QAAA,KAAA,WAAA,QAAA;;;;;;;;;;;;;;;;;;KAwBxE,SAAA,WAAoB,UAAA,QAAkB,WAAA,KAAgB,CAAA,kBAC7D,IAAA,uBAED,CAAA,SAAU,KAAA,YACR,CAAA"}
+{"version":3,"file":"define-model.d.mts","names":[],"sources":["../../../../../../../cascade/src/utils/define-model.ts"],"mappings":";;;;;;;;AASA;KAAY,kBAAA,iBAAmC,WAAA;EAAjB;;;EAI5B,KAAA;EAiCa;;;;EA3Bb,IAAA;EA2FU;;;;EArFV,MAAA,EAAQ,eAAA;EAZR;;;;;;;;;;EAwBA,cAAA,GAAiB,cAAA;EAuDjB;;;;;;;EA9CA,UAAA,GAAa,UAAA;EAgEG;AA2DlB;;;;;EAnHE,cAAA;EAsHoB;;;;;EA/GpB,eAAA;EAoH8B;;;;;EA7G9B,SAAA;EA8G4B;;;;;;;;;;;;;;;;;;;;;;EAtF5B,UAAA,GAAa,QAAA,CAAS,KAAA,CAAM,OAAA,KAAY,MAAA;EAiFvB;;;;;;;;;;;;;;;;EA/DjB,OAAA,GAAU,MAAA;AAAA;;;;;;;;;;;;;;;;;AAgJwE;AAwBpF;;;;;;;;;;;;;;;;;;;;AAIO;;;;;;;;;;;;;;;;;;;iBAjHS,WAAA,iBACE,WAAA,2BACS,eAAA,GAAkB,eAAA,sBACvB,MAAA,qCACH,MAAA,oBAEjB,OAAA,EAAS,kBAAA,CAAmB,OAAA;EAC1B,MAAA,EAAQ,gBAAA;EACR,UAAA,GAAa,QAAA,CAAS,KAAA,CAAM,KAAA,CAAM,MAAA,CAAO,gBAAA,MAAsB,WAAA;EAC/D,OAAA,GAAU,QAAA,QAAgB,KAAA,CAAM,KAAA,CAAM,MAAA,CAAO,gBAAA,MAAsB,QAAA;AAAA,UACpE,WAAA,GA2EoB,OAAA,CAAO,KAAA,CAAA,MAAA,CAAA,gBAAA,OAAmB,KAAA,CAAK,KAAA,CAAA,MAAA,CAAA,gBAAA,KAAmB,WAAA,IAAW,IAAA,QAAA,KAAA,WAAA,QAAA;;;;;;;;;;;;;;;;;;KAwBxE,SAAA,WAAoB,UAAA,QAAkB,WAAA,KAAgB,CAAA,kBAC7D,IAAA,uBAED,CAAA,SAAU,KAAA,YACR,CAAA"}

package/esm/utils/define-model.mjs

@@ -1,7 +1,7 @@
 import { registerModelInRegistry } from "../model/register-model.mjs";
 import { Model } from "../model/model.mjs";
 
-//#region ../@warlock.js/cascade/src/utils/define-model.ts
+//#region ../cascade/src/utils/define-model.ts
 /**
 * Define a model with a clean, concise API.
 *

package/esm/utils/define-model.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"define-model.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/utils/define-model.ts"],"sourcesContent":["import type { Infer, ObjectValidator } from \"@warlock.js/seal\";\nimport type { ModelSchema } from \"../model/model\";\nimport { Model } from \"../model/model\";\nimport { registerModelInRegistry } from \"../model/register-model\";\nimport type { DeleteStrategy, StrictMode } from \"../types\";\n\n/**\n * Configuration options for defining a model.\n */\nexport type DefineModelOptions<TSchema extends ModelSchema> = {\n  /**\n   * The database table/collection name.\n   */\n  table: string;\n\n  /**\n   * Model name\n   * If provided, it will be registered in the models registery\n   */\n  name?: string;\n\n  /**\n   * The validation schema for the model.\n   * Use `v.object()` from @warlock.js/seal to define the schema.\n   */\n  schema: ObjectValidator;\n\n  /**\n   * Delete strategy for this model. Controls how `destroy()` handles records.\n   *\n   * - `\"trash\"` — Moves the record to a trash table/collection, then deletes from the source.\n   * - `\"permanent\"` — Hard delete. The record is removed from the database.\n   * - `\"soft\"` — Sets a `deletedAt` timestamp; the row stays in place.\n   *\n   * When omitted, the runtime resolves the strategy in this priority order:\n   * `destroy()` call options → this model's static → data source `defaultDeleteStrategy` → `\"permanent\"`.\n   */\n  deleteStrategy?: DeleteStrategy;\n\n  /**\n   * Behavior when the model is asked to write a field that is not declared in `schema`.\n   *\n   * - `\"strip\"` — Drop unknown fields silently (default).\n   * - `\"fail\"` — Throw a validation error on unknown fields.\n   * - `\"allow\"` — Pass unknown fields through to the database as-is.\n   */\n  strictMode?: StrictMode;\n\n  /**\n   * Auto-generate a sequential `id` field on insert (NoSQL only).\n   *\n   * SQL drivers use native AUTO_INCREMENT and ignore this. When omitted, the\n   * MongoDB driver defaults to `true`; the PostgreSQL driver defaults to `false`.\n   */\n  autoGenerateId?: boolean;\n\n  /**\n   * Use a random increment (1–10) instead of a fixed step when auto-generating IDs.\n   *\n   * When omitted, falls through to the driver/data-source default.\n   */\n  randomIncrement?: boolean;\n\n  /**\n   * Initial ID value for the first record when auto-generating IDs.\n   *\n   * When omitted, falls through to the driver/data-source default (typically `1`).\n   */\n  initialId?: number;\n\n  /**\n   * Optional: Custom instance properties (getters/setters/methods).\n   * Define computed properties, custom getters, or instance methods.\n   *\n   * The `this` context will be the Model instance, giving you access to\n   * all Model methods like `get()`, `set()`, `save()`, etc.\n   *\n   * @example\n   * ```typescript\n   * properties: {\n   *   get fullName(this: Model<UserSchema>) {\n   *     return `${this.get(\"firstName\")} ${this.get(\"lastName\")}`;\n   *   },\n   *   get isActive(this: Model<UserSchema>) {\n   *     return this.get(\"status\") === \"active\";\n   *   },\n   *   async sendEmail(this: Model<UserSchema>, subject: string) {\n   *     // this.get(), this.save(), etc. all work!\n   *   },\n   * }\n   * ```\n   */\n  properties?: ThisType<Model<TSchema>> & Record<string, any>;\n\n  /**\n   * Optional: Custom static methods.\n   * Define class-level methods like custom finders or utilities.\n   *\n   * @example\n   * ```typescript\n   * statics: {\n   *   async findByEmail(email: string) {\n   *     return this.first({ email });\n   *   },\n   *   async findActive() {\n   *     return this.query().where(\"status\", \"active\").get();\n   *   },\n   * }\n   * ```\n   */\n  statics?: Record<string, any>;\n};\n\n/**\n * Define a model with a clean, concise API.\n *\n * This utility function creates a Model class with the specified configuration,\n * reducing boilerplate and providing a more declarative way to define models.\n *\n * @param options - Model configuration options\n * @returns A Model class with the specified configuration\n *\n * @example\n * ```typescript\n * import { defineModel } from \"@warlock.js/cascade\";\n * import { v } from \"@warlock.js/seal\";\n *\n * export const User = defineModel({\n *   table: \"users\",\n *   schema: v.object({\n *     name: v.string().required().trim(),\n *     email: v.string().email().required().lowercase(),\n *     password: v.string().required().min(6),\n *     role: v.string().default(\"user\"),\n *   }),\n *   deleteStrategy: \"soft\",\n * });\n *\n * // Usage\n * const user = await User.create({\n *   name: \"John Doe\",\n *   email: \"john@example.com\",\n *   password: \"secret123\",\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With type inference\n * export const Post = defineModel({\n *   table: \"posts\",\n *   schema: v.object({\n *     title: v.string().required(),\n *     content: v.string().required(),\n *     authorId: v.number().required(),\n *     published: v.boolean().default(false),\n *   }),\n * });\n *\n * // TypeScript knows the exact type!\n * const post = await Post.create({\n *   title: \"Hello World\",\n *   content: \"My first post\",\n *   authorId: 1,\n * });\n *\n * console.log(post.title); // ✅ Type-safe!\n * ```\n */\nexport function defineModel<\n  TSchema extends ModelSchema,\n  TSchemaValidator extends ObjectValidator = ObjectValidator,\n  TProperties extends Record<string, any> = {},\n  TStatics extends Record<string, any> = {},\n>(\n  options: DefineModelOptions<TSchema> & {\n    schema: TSchemaValidator;\n    properties?: ThisType<Model<Infer.Output<TSchemaValidator>>> & TProperties;\n    statics?: ThisType<typeof Model<Infer.Output<TSchemaValidator>>> & TStatics;\n  },\n) {\n  type InferredSchema = Infer.Output<TSchemaValidator>;\n\n  class DefinedModel extends Model<InferredSchema> {\n    /**\n     * Table/collection name\n     */\n    public static table = options.table;\n\n    /**\n     * Validation schema\n     */\n    public static schema = options.schema;\n\n    /**\n     * Delete strategy. When undefined, the runtime resolves via call options →\n     * data source `defaultDeleteStrategy` → `\"permanent\"`.\n     */\n    public static deleteStrategy: DeleteStrategy | undefined = options.deleteStrategy;\n\n    /**\n     * Strict mode for unknown fields. Defaults to `\"strip\"` to match the base\n     * `Model` static default.\n     */\n    public static strictMode: StrictMode = options.strictMode || \"strip\";\n\n    /**\n     * Auto-generate sequential IDs (NoSQL only). Defaults to `true` to match\n     * the base `Model` static default.\n     */\n    public static autoGenerateId: boolean = options.autoGenerateId ?? true;\n\n    /**\n     * Random increment for auto-generated IDs. When undefined, falls through\n     * to the data-source default.\n     */\n    public static randomIncrement: boolean | undefined = options.randomIncrement;\n\n    /**\n     * Initial ID value for the first record when auto-generating IDs. When\n     * undefined, falls through to the data-source default.\n     */\n    public static initialId: number | undefined = options.initialId;\n  }\n\n  // Apply custom instance properties (getters/setters/methods)\n  if (options.properties) {\n    Object.defineProperties(\n      DefinedModel.prototype,\n      Object.getOwnPropertyDescriptors(options.properties),\n    );\n  }\n\n  if (options.name) {\n    registerModelInRegistry(options.name, DefinedModel);\n  }\n\n  // Apply custom static methods\n  if (options.statics) {\n    Object.defineProperties(DefinedModel, Object.getOwnPropertyDescriptors(options.statics));\n  }\n\n  // Return with proper type inference.\n  //\n  // The constructed type references the EXPORTED `Model` (instance + statics)\n  // rather than the local `DefinedModel` class. `DefinedModel` is declared\n  // inside this function, so emitting it into the public `.d.ts` would force the\n  // declaration emitter to inline it as an anonymous class type — which fails\n  // with TS4094 (\"anonymous class type may not be private or protected\", from\n  // Model's `protected isActiveColumn`) and crashes the dts bundler on Model's\n  // getters. `DefinedModel` adds no instance members over `Model<InferredSchema>`\n  // and no statics beyond those already declared on `Model`, so this is a\n  // faithful, emittable equivalent of the previously-inferred return type.\n  type DefinedModelClass = {\n    new (initialData?: Partial<InferredSchema>): Model<InferredSchema> & TProperties;\n  } & Omit<typeof Model, \"new\"> &\n    TStatics;\n\n  return DefinedModel as unknown as DefinedModelClass;\n}\n\n/**\n * Type helper to infer the schema type from a defined model.\n *\n * @example\n * ```typescript\n * const User = defineModel({\n *   table: \"users\",\n *   schema: v.object({\n *     name: v.string(),\n *     email: v.string(),\n *   }),\n * });\n *\n * type UserType = ModelType<typeof User>;\n * // { name: string; email: string; }\n * ```\n */\nexport type ModelType<T extends ReturnType<typeof defineModel>> = T extends new (\n  ...args: any[]\n) => infer R\n  ? R extends Model<infer S>\n    ? S\n    : never\n  : never;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyKA,SAAgB,YAMd,SAKA;CAGA,MAAM,qBAAqB,MAAsB;;;;EAI/C,OAAc,QAAQ,QAAQ;;;;EAK9B,OAAc,SAAS,QAAQ;;;;;EAM/B,OAAc,iBAA6C,QAAQ;;;;;EAMnE,OAAc,aAAyB,QAAQ,cAAc;;;;;EAM7D,OAAc,iBAA0B,QAAQ,kBAAkB;;;;;EAMlE,OAAc,kBAAuC,QAAQ;;;;;EAM7D,OAAc,YAAgC,QAAQ;CACxD;CAGA,IAAI,QAAQ,YACV,OAAO,iBACL,aAAa,WACb,OAAO,0BAA0B,QAAQ,UAAU,CACrD;CAGF,IAAI,QAAQ,MACV,wBAAwB,QAAQ,MAAM,YAAY;CAIpD,IAAI,QAAQ,SACV,OAAO,iBAAiB,cAAc,OAAO,0BAA0B,QAAQ,OAAO,CAAC;CAmBzF,OAAO;AACT"}
+{"version":3,"file":"define-model.mjs","names":[],"sources":["../../../../../../../cascade/src/utils/define-model.ts"],"sourcesContent":["import type { Infer, ObjectValidator } from \"@warlock.js/seal\";\nimport type { ModelSchema } from \"../model/model\";\nimport { Model } from \"../model/model\";\nimport { registerModelInRegistry } from \"../model/register-model\";\nimport type { DeleteStrategy, StrictMode } from \"../types\";\n\n/**\n * Configuration options for defining a model.\n */\nexport type DefineModelOptions<TSchema extends ModelSchema> = {\n  /**\n   * The database table/collection name.\n   */\n  table: string;\n\n  /**\n   * Model name\n   * If provided, it will be registered in the models registery\n   */\n  name?: string;\n\n  /**\n   * The validation schema for the model.\n   * Use `v.object()` from @warlock.js/seal to define the schema.\n   */\n  schema: ObjectValidator;\n\n  /**\n   * Delete strategy for this model. Controls how `destroy()` handles records.\n   *\n   * - `\"trash\"` — Moves the record to a trash table/collection, then deletes from the source.\n   * - `\"permanent\"` — Hard delete. The record is removed from the database.\n   * - `\"soft\"` — Sets a `deletedAt` timestamp; the row stays in place.\n   *\n   * When omitted, the runtime resolves the strategy in this priority order:\n   * `destroy()` call options → this model's static → data source `defaultDeleteStrategy` → `\"permanent\"`.\n   */\n  deleteStrategy?: DeleteStrategy;\n\n  /**\n   * Behavior when the model is asked to write a field that is not declared in `schema`.\n   *\n   * - `\"strip\"` — Drop unknown fields silently (default).\n   * - `\"fail\"` — Throw a validation error on unknown fields.\n   * - `\"allow\"` — Pass unknown fields through to the database as-is.\n   */\n  strictMode?: StrictMode;\n\n  /**\n   * Auto-generate a sequential `id` field on insert (NoSQL only).\n   *\n   * SQL drivers use native AUTO_INCREMENT and ignore this. When omitted, the\n   * MongoDB driver defaults to `true`; the PostgreSQL driver defaults to `false`.\n   */\n  autoGenerateId?: boolean;\n\n  /**\n   * Use a random increment (1–10) instead of a fixed step when auto-generating IDs.\n   *\n   * When omitted, falls through to the driver/data-source default.\n   */\n  randomIncrement?: boolean;\n\n  /**\n   * Initial ID value for the first record when auto-generating IDs.\n   *\n   * When omitted, falls through to the driver/data-source default (typically `1`).\n   */\n  initialId?: number;\n\n  /**\n   * Optional: Custom instance properties (getters/setters/methods).\n   * Define computed properties, custom getters, or instance methods.\n   *\n   * The `this` context will be the Model instance, giving you access to\n   * all Model methods like `get()`, `set()`, `save()`, etc.\n   *\n   * @example\n   * ```typescript\n   * properties: {\n   *   get fullName(this: Model<UserSchema>) {\n   *     return `${this.get(\"firstName\")} ${this.get(\"lastName\")}`;\n   *   },\n   *   get isActive(this: Model<UserSchema>) {\n   *     return this.get(\"status\") === \"active\";\n   *   },\n   *   async sendEmail(this: Model<UserSchema>, subject: string) {\n   *     // this.get(), this.save(), etc. all work!\n   *   },\n   * }\n   * ```\n   */\n  properties?: ThisType<Model<TSchema>> & Record<string, any>;\n\n  /**\n   * Optional: Custom static methods.\n   * Define class-level methods like custom finders or utilities.\n   *\n   * @example\n   * ```typescript\n   * statics: {\n   *   async findByEmail(email: string) {\n   *     return this.first({ email });\n   *   },\n   *   async findActive() {\n   *     return this.query().where(\"status\", \"active\").get();\n   *   },\n   * }\n   * ```\n   */\n  statics?: Record<string, any>;\n};\n\n/**\n * Define a model with a clean, concise API.\n *\n * This utility function creates a Model class with the specified configuration,\n * reducing boilerplate and providing a more declarative way to define models.\n *\n * @param options - Model configuration options\n * @returns A Model class with the specified configuration\n *\n * @example\n * ```typescript\n * import { defineModel } from \"@warlock.js/cascade\";\n * import { v } from \"@warlock.js/seal\";\n *\n * export const User = defineModel({\n *   table: \"users\",\n *   schema: v.object({\n *     name: v.string().required().trim(),\n *     email: v.string().email().required().lowercase(),\n *     password: v.string().required().min(6),\n *     role: v.string().default(\"user\"),\n *   }),\n *   deleteStrategy: \"soft\",\n * });\n *\n * // Usage\n * const user = await User.create({\n *   name: \"John Doe\",\n *   email: \"john@example.com\",\n *   password: \"secret123\",\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With type inference\n * export const Post = defineModel({\n *   table: \"posts\",\n *   schema: v.object({\n *     title: v.string().required(),\n *     content: v.string().required(),\n *     authorId: v.number().required(),\n *     published: v.boolean().default(false),\n *   }),\n * });\n *\n * // TypeScript knows the exact type!\n * const post = await Post.create({\n *   title: \"Hello World\",\n *   content: \"My first post\",\n *   authorId: 1,\n * });\n *\n * console.log(post.title); // ✅ Type-safe!\n * ```\n */\nexport function defineModel<\n  TSchema extends ModelSchema,\n  TSchemaValidator extends ObjectValidator = ObjectValidator,\n  TProperties extends Record<string, any> = {},\n  TStatics extends Record<string, any> = {},\n>(\n  options: DefineModelOptions<TSchema> & {\n    schema: TSchemaValidator;\n    properties?: ThisType<Model<Infer.Output<TSchemaValidator>>> & TProperties;\n    statics?: ThisType<typeof Model<Infer.Output<TSchemaValidator>>> & TStatics;\n  },\n) {\n  type InferredSchema = Infer.Output<TSchemaValidator>;\n\n  class DefinedModel extends Model<InferredSchema> {\n    /**\n     * Table/collection name\n     */\n    public static table = options.table;\n\n    /**\n     * Validation schema\n     */\n    public static schema = options.schema;\n\n    /**\n     * Delete strategy. When undefined, the runtime resolves via call options →\n     * data source `defaultDeleteStrategy` → `\"permanent\"`.\n     */\n    public static deleteStrategy: DeleteStrategy | undefined = options.deleteStrategy;\n\n    /**\n     * Strict mode for unknown fields. Defaults to `\"strip\"` to match the base\n     * `Model` static default.\n     */\n    public static strictMode: StrictMode = options.strictMode || \"strip\";\n\n    /**\n     * Auto-generate sequential IDs (NoSQL only). Defaults to `true` to match\n     * the base `Model` static default.\n     */\n    public static autoGenerateId: boolean = options.autoGenerateId ?? true;\n\n    /**\n     * Random increment for auto-generated IDs. When undefined, falls through\n     * to the data-source default.\n     */\n    public static randomIncrement: boolean | undefined = options.randomIncrement;\n\n    /**\n     * Initial ID value for the first record when auto-generating IDs. When\n     * undefined, falls through to the data-source default.\n     */\n    public static initialId: number | undefined = options.initialId;\n  }\n\n  // Apply custom instance properties (getters/setters/methods)\n  if (options.properties) {\n    Object.defineProperties(\n      DefinedModel.prototype,\n      Object.getOwnPropertyDescriptors(options.properties),\n    );\n  }\n\n  if (options.name) {\n    registerModelInRegistry(options.name, DefinedModel);\n  }\n\n  // Apply custom static methods\n  if (options.statics) {\n    Object.defineProperties(DefinedModel, Object.getOwnPropertyDescriptors(options.statics));\n  }\n\n  // Return with proper type inference.\n  //\n  // The constructed type references the EXPORTED `Model` (instance + statics)\n  // rather than the local `DefinedModel` class. `DefinedModel` is declared\n  // inside this function, so emitting it into the public `.d.ts` would force the\n  // declaration emitter to inline it as an anonymous class type — which fails\n  // with TS4094 (\"anonymous class type may not be private or protected\", from\n  // Model's `protected isActiveColumn`) and crashes the dts bundler on Model's\n  // getters. `DefinedModel` adds no instance members over `Model<InferredSchema>`\n  // and no statics beyond those already declared on `Model`, so this is a\n  // faithful, emittable equivalent of the previously-inferred return type.\n  type DefinedModelClass = {\n    new (initialData?: Partial<InferredSchema>): Model<InferredSchema> & TProperties;\n  } & Omit<typeof Model, \"new\"> &\n    TStatics;\n\n  return DefinedModel as unknown as DefinedModelClass;\n}\n\n/**\n * Type helper to infer the schema type from a defined model.\n *\n * @example\n * ```typescript\n * const User = defineModel({\n *   table: \"users\",\n *   schema: v.object({\n *     name: v.string(),\n *     email: v.string(),\n *   }),\n * });\n *\n * type UserType = ModelType<typeof User>;\n * // { name: string; email: string; }\n * ```\n */\nexport type ModelType<T extends ReturnType<typeof defineModel>> = T extends new (\n  ...args: any[]\n) => infer R\n  ? R extends Model<infer S>\n    ? S\n    : never\n  : never;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyKA,SAAgB,YAMd,SAKA;CAGA,MAAM,qBAAqB,MAAsB;;;;EAI/C,OAAc,QAAQ,QAAQ;;;;EAK9B,OAAc,SAAS,QAAQ;;;;;EAM/B,OAAc,iBAA6C,QAAQ;;;;;EAMnE,OAAc,aAAyB,QAAQ,cAAc;;;;;EAM7D,OAAc,iBAA0B,QAAQ,kBAAkB;;;;;EAMlE,OAAc,kBAAuC,QAAQ;;;;;EAM7D,OAAc,YAAgC,QAAQ;CACxD;CAGA,IAAI,QAAQ,YACV,OAAO,iBACL,aAAa,WACb,OAAO,0BAA0B,QAAQ,UAAU,CACrD;CAGF,IAAI,QAAQ,MACV,wBAAwB,QAAQ,MAAM,YAAY;CAIpD,IAAI,QAAQ,SACV,OAAO,iBAAiB,cAAc,OAAO,0BAA0B,QAAQ,OAAO,CAAC;CAmBzF,OAAO;AACT"}

package/esm/utils/is-valid-date-value.mjs

@@ -1,4 +1,4 @@
-//#region ../@warlock.js/cascade/src/utils/is-valid-date-value.ts
+//#region ../cascade/src/utils/is-valid-date-value.ts
 const isoRegex = /^\d{4}-\d{2}-\d{2}(T\d{2}:\d{2}:\d{2}(\.\d{3})?Z?)?$/;
 /**
 * Check if the given value is a valid date value

package/esm/utils/is-valid-date-value.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"is-valid-date-value.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/utils/is-valid-date-value.ts"],"sourcesContent":["const isoRegex = /^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z?)?$/;\n\n/**\n * Check if the given value is a valid date value\n */\nexport function isValidDateValue(value: unknown): boolean {\n  // ✅ Handle timestamps\n  if (typeof value === \"number\") {\n    if (!Number.isFinite(value)) return false;\n\n    const date = new Date(value);\n    return !Number.isNaN(date.getTime());\n  }\n\n  // ❌ Only allow strict ISO strings\n  if (typeof value !== \"string\") return false;\n\n  if (!isoRegex.test(value)) return false;\n\n  const date = new Date(value);\n  if (Number.isNaN(date.getTime())) return false;\n\n  // 🔥 Critical step: prevent JS auto-correction\n  // Example: \"2023-02-31\" → March 3 (WRONG but \"valid\")\n  const [y, m, d] = value.split(\"T\")[0].split(\"-\").map(Number);\n\n  return date.getUTCFullYear() === y && date.getUTCMonth() + 1 === m && date.getUTCDate() === d;\n}\n"],"mappings":";AAAA,MAAM,WAAW;;;;AAKjB,SAAgB,iBAAiB,OAAyB;CAExD,IAAI,OAAO,UAAU,UAAU;EAC7B,IAAI,CAAC,OAAO,SAAS,KAAK,GAAG,OAAO;EAEpC,MAAM,OAAO,IAAI,KAAK,KAAK;EAC3B,OAAO,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC;CACrC;CAGA,IAAI,OAAO,UAAU,UAAU,OAAO;CAEtC,IAAI,CAAC,SAAS,KAAK,KAAK,GAAG,OAAO;CAElC,MAAM,OAAO,IAAI,KAAK,KAAK;CAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,GAAG,OAAO;CAIzC,MAAM,CAAC,GAAG,GAAG,KAAK,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM;CAE3D,OAAO,KAAK,eAAe,MAAM,KAAK,KAAK,YAAY,IAAI,MAAM,KAAK,KAAK,WAAW,MAAM;AAC9F"}
+{"version":3,"file":"is-valid-date-value.mjs","names":[],"sources":["../../../../../../../cascade/src/utils/is-valid-date-value.ts"],"sourcesContent":["const isoRegex = /^\\d{4}-\\d{2}-\\d{2}(T\\d{2}:\\d{2}:\\d{2}(\\.\\d{3})?Z?)?$/;\n\n/**\n * Check if the given value is a valid date value\n */\nexport function isValidDateValue(value: unknown): boolean {\n  // ✅ Handle timestamps\n  if (typeof value === \"number\") {\n    if (!Number.isFinite(value)) return false;\n\n    const date = new Date(value);\n    return !Number.isNaN(date.getTime());\n  }\n\n  // ❌ Only allow strict ISO strings\n  if (typeof value !== \"string\") return false;\n\n  if (!isoRegex.test(value)) return false;\n\n  const date = new Date(value);\n  if (Number.isNaN(date.getTime())) return false;\n\n  // 🔥 Critical step: prevent JS auto-correction\n  // Example: \"2023-02-31\" → March 3 (WRONG but \"valid\")\n  const [y, m, d] = value.split(\"T\")[0].split(\"-\").map(Number);\n\n  return date.getUTCFullYear() === y && date.getUTCMonth() + 1 === m && date.getUTCDate() === d;\n}\n"],"mappings":";AAAA,MAAM,WAAW;;;;AAKjB,SAAgB,iBAAiB,OAAyB;CAExD,IAAI,OAAO,UAAU,UAAU;EAC7B,IAAI,CAAC,OAAO,SAAS,KAAK,GAAG,OAAO;EAEpC,MAAM,OAAO,IAAI,KAAK,KAAK;EAC3B,OAAO,CAAC,OAAO,MAAM,KAAK,QAAQ,CAAC;CACrC;CAGA,IAAI,OAAO,UAAU,UAAU,OAAO;CAEtC,IAAI,CAAC,SAAS,KAAK,KAAK,GAAG,OAAO;CAElC,MAAM,OAAO,IAAI,KAAK,KAAK;CAC3B,IAAI,OAAO,MAAM,KAAK,QAAQ,CAAC,GAAG,OAAO;CAIzC,MAAM,CAAC,GAAG,GAAG,KAAK,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,MAAM;CAE3D,OAAO,KAAK,eAAe,MAAM,KAAK,KAAK,YAAY,IAAI,MAAM,KAAK,KAAK,WAAW,MAAM;AAC9F"}

package/esm/utils/once-connected.d.mts

@@ -1,6 +1,6 @@
 import { DataSource } from "../data-source/data-source.mjs";
 
-//#region ../@warlock.js/cascade/src/utils/once-connected.d.ts
+//#region ../cascade/src/utils/once-connected.d.ts
 /**
  * Execute a callback once the driver is connected.
  *

package/esm/utils/once-connected.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"once-connected.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/utils/once-connected.ts"],"mappings":";;;;;AA0EA;;;;;;;;;;;;;;;;AAE6C;AAmI7C;;;;;;;;;;;;;;;;AAE6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAvI7B,aAAA,CACd,0BAAA,EAA4B,UAAA,cAAwB,UAAA,EAAY,UAAA,YAChE,QAAA,IAAY,UAAA,EAAY,UAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmIV,gBAAA,CACd,0BAAA,EAA4B,UAAA,cAAwB,UAAA,EAAY,UAAA,YAChE,QAAA,IAAY,UAAA,EAAY,UAAA"}
+{"version":3,"file":"once-connected.d.mts","names":[],"sources":["../../../../../../../cascade/src/utils/once-connected.ts"],"mappings":";;;;;AA0EA;;;;;;;;;;;;;;;;AAE6C;AAmI7C;;;;;;;;;;;;;;;;AAE6C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAvI7B,aAAA,CACd,0BAAA,EAA4B,UAAA,cAAwB,UAAA,EAAY,UAAA,YAChE,QAAA,IAAY,UAAA,EAAY,UAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAmIV,gBAAA,CACd,0BAAA,EAA4B,UAAA,cAAwB,UAAA,EAAY,UAAA,YAChE,QAAA,IAAY,UAAA,EAAY,UAAA"}

package/esm/utils/once-connected.mjs

@@ -1,6 +1,6 @@
 import { dataSourceRegistry } from "../data-source/data-source-registry.mjs";
 
-//#region ../@warlock.js/cascade/src/utils/once-connected.ts
+//#region ../cascade/src/utils/once-connected.ts
 /**
 * Execute a callback once the driver is connected.
 *

package/esm/utils/once-connected.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"once-connected.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/utils/once-connected.ts"],"sourcesContent":["import type { DataSource } from \"../data-source/data-source\";\nimport { dataSourceRegistry } from \"../data-source/data-source-registry\";\n\n/**\n * Execute a callback once the driver is connected.\n *\n * If the driver is already connected, the callback is executed immediately.\n * Otherwise, it waits for the \"connected\" event.\n *\n * **Use Case:**\n * Useful for ensuring database-dependent operations only run after connection\n * is established, especially in small to medium projects with a single data source.\n *\n * @param dataSourceOrNameOrCallback - Data source instance, name, or callback function\n * @param callback - Function to execute once connected (optional if first param is callback)\n *\n * @example\n * ```typescript\n * // With default data source (just callback)\n * await connectToDatabase({ database: \"myapp\" });\n *\n * onceConnected((ds) => {\n *   console.log(\"Database is ready!\");\n *   console.log(\"Connected to:\", ds.name);\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With data source name\n * onceConnected(\"primary\", (ds) => {\n *   console.log(\"Primary database is ready!\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With data source instance\n * const dataSource = await connectToDatabase({ database: \"myapp\" });\n *\n * onceConnected(dataSource, (ds) => {\n *   console.log(\"Database is ready!\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With driver instance\n * const driver = new MongoDbDriver(config);\n * const dataSource = new DataSource({ name: \"primary\", driver });\n *\n * onceConnected(dataSource, () => {\n *   // Start application server\n *   app.listen(3000);\n * });\n *\n * // Connect after setting up the callback\n * await driver.connect();\n * ```\n *\n * @example\n * ```typescript\n * // Chaining operations\n * onceConnected(async (ds) => {\n *   // Seed database\n *   await seedDatabase();\n *\n *   // Run migrations\n *   await runMigrations();\n *\n *   console.log(\"Database ready!\");\n * });\n * ```\n */\nexport function onceConnected(\n  dataSourceOrNameOrCallback: DataSource | string | ((dataSource: DataSource) => void),\n  callback?: (dataSource: DataSource) => void,\n): void {\n  // Determine if first parameter is a callback\n  let targetDataSource: DataSource | string;\n  let actualCallback: (dataSource: DataSource) => void;\n\n  if (typeof dataSourceOrNameOrCallback === \"function\") {\n    // First param is callback, use default data source\n    actualCallback = dataSourceOrNameOrCallback;\n    targetDataSource = \"default\";\n  } else {\n    // First param is data source name or instance\n    if (!callback) {\n      throw new Error(\"Callback is required when providing a data source name or instance.\");\n    }\n    actualCallback = callback;\n    targetDataSource = dataSourceOrNameOrCallback;\n  }\n\n  // Try to get the data source if it's a string\n  let resolvedDataSource: DataSource | undefined;\n  if (typeof targetDataSource === \"string\") {\n    try {\n      resolvedDataSource =\n        targetDataSource === \"default\"\n          ? dataSourceRegistry.get()\n          : dataSourceRegistry.get(targetDataSource);\n    } catch {\n      // Data source not registered yet, will wait for event\n    }\n  } else {\n    resolvedDataSource = targetDataSource;\n  }\n\n  // If data source is resolved and already connected, fire immediately\n  if (resolvedDataSource && resolvedDataSource.driver.isConnected) {\n    actualCallback(resolvedDataSource);\n    return;\n  }\n\n  // Otherwise, wait for the connected event\n  const listener = (ds: DataSource) => {\n    const matches =\n      typeof targetDataSource === \"string\"\n        ? targetDataSource === \"default\"\n          ? ds.isDefault\n          : ds.name === targetDataSource\n        : ds === targetDataSource;\n\n    if (matches) {\n      // Remove the listener once our condition is met\n      dataSourceRegistry.off(\"connected\", listener);\n      actualCallback(ds);\n    }\n    // If it doesn't match, we do nothing and just wait for the next \"connected\" event targeting our DB\n  };\n\n  dataSourceRegistry.on(\"connected\", listener);\n}\n\n/**\n * Execute a callback once the driver is disconnected.\n *\n * If the driver is already disconnected, the callback is executed immediately.\n * Otherwise, it waits for the \"disconnected\" event.\n *\n * **Use Case:**\n * Useful for cleanup operations, graceful shutdown, or reconnection logic.\n *\n * @param dataSourceOrNameOrCallback - Data source instance, name, or callback function\n * @param callback - Function to execute once disconnected (optional if first param is callback)\n *\n * @example\n * ```typescript\n * // With default data source (just callback)\n * await connectToDatabase({ database: \"myapp\" });\n *\n * onceDisconnected((ds) => {\n *   console.log(\"Database disconnected!\");\n *   console.log(\"Attempting reconnection...\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With data source name\n * onceDisconnected(\"primary\", (ds) => {\n *   console.log(\"Primary database disconnected!\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With data source instance\n * const dataSource = await connectToDatabase({ database: \"myapp\" });\n *\n * onceDisconnected(dataSource, (ds) => {\n *   console.log(\"Database disconnected!\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // Graceful shutdown with default data source\n * process.on(\"SIGTERM\", async () => {\n *   console.log(\"Shutting down...\");\n *\n *   onceDisconnected(() => {\n *     console.log(\"Database closed, exiting process\");\n *     process.exit(0);\n *   });\n *\n *   const dataSource = DataSourceRegistry.getDefault();\n *   await dataSource?.driver.disconnect();\n * });\n * ```\n *\n * @example\n * ```typescript\n * // Cleanup resources on disconnect\n * onceDisconnected(async (ds) => {\n *   // Close file handles\n *   await closeFileHandles();\n *\n *   // Clear caches\n *   clearCaches();\n *\n *   console.log(\"Cleanup complete\");\n * });\n * ```\n */\nexport function onceDisconnected(\n  dataSourceOrNameOrCallback: DataSource | string | ((dataSource: DataSource) => void),\n  callback?: (dataSource: DataSource) => void,\n): void {\n  // Determine if first parameter is a callback\n  let targetDataSource: DataSource | string;\n  let actualCallback: (dataSource: DataSource) => void;\n\n  if (typeof dataSourceOrNameOrCallback === \"function\") {\n    // First param is callback, use default data source\n    actualCallback = dataSourceOrNameOrCallback;\n    targetDataSource = \"default\";\n  } else {\n    // First param is data source name or instance\n    if (!callback) {\n      throw new Error(\"Callback is required when providing a data source name or instance.\");\n    }\n    actualCallback = callback;\n    targetDataSource = dataSourceOrNameOrCallback;\n  }\n\n  // Try to get the data source if it's a string\n  let resolvedDataSource: DataSource | undefined;\n  if (typeof targetDataSource === \"string\") {\n    try {\n      resolvedDataSource =\n        targetDataSource === \"default\"\n          ? dataSourceRegistry.get()\n          : dataSourceRegistry.get(targetDataSource);\n    } catch {\n      // Data source not registered yet, will wait for event\n    }\n  } else {\n    resolvedDataSource = targetDataSource;\n  }\n\n  // If data source is resolved and already disconnected, fire immediately\n  if (resolvedDataSource && !resolvedDataSource.driver.isConnected) {\n    actualCallback(resolvedDataSource);\n    return;\n  }\n\n  // Otherwise, wait for the disconnected event\n  const listener = (ds: DataSource) => {\n    const matches =\n      typeof targetDataSource === \"string\"\n        ? targetDataSource === \"default\"\n          ? ds.isDefault\n          : ds.name === targetDataSource\n        : ds === targetDataSource;\n\n    if (matches) {\n      actualCallback(ds);\n    } else {\n      // Not the one we're looking for, keep listening\n      dataSourceRegistry.once(\"disconnected\", listener);\n    }\n  };\n\n  dataSourceRegistry.once(\"disconnected\", listener);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0EA,SAAgB,cACd,4BACA,UACM;CAEN,IAAI;CACJ,IAAI;CAEJ,IAAI,OAAO,+BAA+B,YAAY;EAEpD,iBAAiB;EACjB,mBAAmB;CACrB,OAAO;EAEL,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,qEAAqE;EAEvF,iBAAiB;EACjB,mBAAmB;CACrB;CAGA,IAAI;CACJ,IAAI,OAAO,qBAAqB,UAC9B,IAAI;EACF,qBACE,qBAAqB,YACjB,mBAAmB,IAAI,IACvB,mBAAmB,IAAI,gBAAgB;CAC/C,QAAQ,CAER;MAEA,qBAAqB;CAIvB,IAAI,sBAAsB,mBAAmB,OAAO,aAAa;EAC/D,eAAe,kBAAkB;EACjC;CACF;CAGA,MAAM,YAAY,OAAmB;EAQnC,IANE,OAAO,qBAAqB,WACxB,qBAAqB,YACnB,GAAG,YACH,GAAG,SAAS,mBACd,OAAO,kBAEA;GAEX,mBAAmB,IAAI,aAAa,QAAQ;GAC5C,eAAe,EAAE;EACnB;CAEF;CAEA,mBAAmB,GAAG,aAAa,QAAQ;AAC7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,SAAgB,iBACd,4BACA,UACM;CAEN,IAAI;CACJ,IAAI;CAEJ,IAAI,OAAO,+BAA+B,YAAY;EAEpD,iBAAiB;EACjB,mBAAmB;CACrB,OAAO;EAEL,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,qEAAqE;EAEvF,iBAAiB;EACjB,mBAAmB;CACrB;CAGA,IAAI;CACJ,IAAI,OAAO,qBAAqB,UAC9B,IAAI;EACF,qBACE,qBAAqB,YACjB,mBAAmB,IAAI,IACvB,mBAAmB,IAAI,gBAAgB;CAC/C,QAAQ,CAER;MAEA,qBAAqB;CAIvB,IAAI,sBAAsB,CAAC,mBAAmB,OAAO,aAAa;EAChE,eAAe,kBAAkB;EACjC;CACF;CAGA,MAAM,YAAY,OAAmB;EAQnC,IANE,OAAO,qBAAqB,WACxB,qBAAqB,YACnB,GAAG,YACH,GAAG,SAAS,mBACd,OAAO,kBAGX,eAAe,EAAE;OAGjB,mBAAmB,KAAK,gBAAgB,QAAQ;CAEpD;CAEA,mBAAmB,KAAK,gBAAgB,QAAQ;AAClD"}
+{"version":3,"file":"once-connected.mjs","names":[],"sources":["../../../../../../../cascade/src/utils/once-connected.ts"],"sourcesContent":["import type { DataSource } from \"../data-source/data-source\";\nimport { dataSourceRegistry } from \"../data-source/data-source-registry\";\n\n/**\n * Execute a callback once the driver is connected.\n *\n * If the driver is already connected, the callback is executed immediately.\n * Otherwise, it waits for the \"connected\" event.\n *\n * **Use Case:**\n * Useful for ensuring database-dependent operations only run after connection\n * is established, especially in small to medium projects with a single data source.\n *\n * @param dataSourceOrNameOrCallback - Data source instance, name, or callback function\n * @param callback - Function to execute once connected (optional if first param is callback)\n *\n * @example\n * ```typescript\n * // With default data source (just callback)\n * await connectToDatabase({ database: \"myapp\" });\n *\n * onceConnected((ds) => {\n *   console.log(\"Database is ready!\");\n *   console.log(\"Connected to:\", ds.name);\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With data source name\n * onceConnected(\"primary\", (ds) => {\n *   console.log(\"Primary database is ready!\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With data source instance\n * const dataSource = await connectToDatabase({ database: \"myapp\" });\n *\n * onceConnected(dataSource, (ds) => {\n *   console.log(\"Database is ready!\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With driver instance\n * const driver = new MongoDbDriver(config);\n * const dataSource = new DataSource({ name: \"primary\", driver });\n *\n * onceConnected(dataSource, () => {\n *   // Start application server\n *   app.listen(3000);\n * });\n *\n * // Connect after setting up the callback\n * await driver.connect();\n * ```\n *\n * @example\n * ```typescript\n * // Chaining operations\n * onceConnected(async (ds) => {\n *   // Seed database\n *   await seedDatabase();\n *\n *   // Run migrations\n *   await runMigrations();\n *\n *   console.log(\"Database ready!\");\n * });\n * ```\n */\nexport function onceConnected(\n  dataSourceOrNameOrCallback: DataSource | string | ((dataSource: DataSource) => void),\n  callback?: (dataSource: DataSource) => void,\n): void {\n  // Determine if first parameter is a callback\n  let targetDataSource: DataSource | string;\n  let actualCallback: (dataSource: DataSource) => void;\n\n  if (typeof dataSourceOrNameOrCallback === \"function\") {\n    // First param is callback, use default data source\n    actualCallback = dataSourceOrNameOrCallback;\n    targetDataSource = \"default\";\n  } else {\n    // First param is data source name or instance\n    if (!callback) {\n      throw new Error(\"Callback is required when providing a data source name or instance.\");\n    }\n    actualCallback = callback;\n    targetDataSource = dataSourceOrNameOrCallback;\n  }\n\n  // Try to get the data source if it's a string\n  let resolvedDataSource: DataSource | undefined;\n  if (typeof targetDataSource === \"string\") {\n    try {\n      resolvedDataSource =\n        targetDataSource === \"default\"\n          ? dataSourceRegistry.get()\n          : dataSourceRegistry.get(targetDataSource);\n    } catch {\n      // Data source not registered yet, will wait for event\n    }\n  } else {\n    resolvedDataSource = targetDataSource;\n  }\n\n  // If data source is resolved and already connected, fire immediately\n  if (resolvedDataSource && resolvedDataSource.driver.isConnected) {\n    actualCallback(resolvedDataSource);\n    return;\n  }\n\n  // Otherwise, wait for the connected event\n  const listener = (ds: DataSource) => {\n    const matches =\n      typeof targetDataSource === \"string\"\n        ? targetDataSource === \"default\"\n          ? ds.isDefault\n          : ds.name === targetDataSource\n        : ds === targetDataSource;\n\n    if (matches) {\n      // Remove the listener once our condition is met\n      dataSourceRegistry.off(\"connected\", listener);\n      actualCallback(ds);\n    }\n    // If it doesn't match, we do nothing and just wait for the next \"connected\" event targeting our DB\n  };\n\n  dataSourceRegistry.on(\"connected\", listener);\n}\n\n/**\n * Execute a callback once the driver is disconnected.\n *\n * If the driver is already disconnected, the callback is executed immediately.\n * Otherwise, it waits for the \"disconnected\" event.\n *\n * **Use Case:**\n * Useful for cleanup operations, graceful shutdown, or reconnection logic.\n *\n * @param dataSourceOrNameOrCallback - Data source instance, name, or callback function\n * @param callback - Function to execute once disconnected (optional if first param is callback)\n *\n * @example\n * ```typescript\n * // With default data source (just callback)\n * await connectToDatabase({ database: \"myapp\" });\n *\n * onceDisconnected((ds) => {\n *   console.log(\"Database disconnected!\");\n *   console.log(\"Attempting reconnection...\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With data source name\n * onceDisconnected(\"primary\", (ds) => {\n *   console.log(\"Primary database disconnected!\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // With data source instance\n * const dataSource = await connectToDatabase({ database: \"myapp\" });\n *\n * onceDisconnected(dataSource, (ds) => {\n *   console.log(\"Database disconnected!\");\n * });\n * ```\n *\n * @example\n * ```typescript\n * // Graceful shutdown with default data source\n * process.on(\"SIGTERM\", async () => {\n *   console.log(\"Shutting down...\");\n *\n *   onceDisconnected(() => {\n *     console.log(\"Database closed, exiting process\");\n *     process.exit(0);\n *   });\n *\n *   const dataSource = DataSourceRegistry.getDefault();\n *   await dataSource?.driver.disconnect();\n * });\n * ```\n *\n * @example\n * ```typescript\n * // Cleanup resources on disconnect\n * onceDisconnected(async (ds) => {\n *   // Close file handles\n *   await closeFileHandles();\n *\n *   // Clear caches\n *   clearCaches();\n *\n *   console.log(\"Cleanup complete\");\n * });\n * ```\n */\nexport function onceDisconnected(\n  dataSourceOrNameOrCallback: DataSource | string | ((dataSource: DataSource) => void),\n  callback?: (dataSource: DataSource) => void,\n): void {\n  // Determine if first parameter is a callback\n  let targetDataSource: DataSource | string;\n  let actualCallback: (dataSource: DataSource) => void;\n\n  if (typeof dataSourceOrNameOrCallback === \"function\") {\n    // First param is callback, use default data source\n    actualCallback = dataSourceOrNameOrCallback;\n    targetDataSource = \"default\";\n  } else {\n    // First param is data source name or instance\n    if (!callback) {\n      throw new Error(\"Callback is required when providing a data source name or instance.\");\n    }\n    actualCallback = callback;\n    targetDataSource = dataSourceOrNameOrCallback;\n  }\n\n  // Try to get the data source if it's a string\n  let resolvedDataSource: DataSource | undefined;\n  if (typeof targetDataSource === \"string\") {\n    try {\n      resolvedDataSource =\n        targetDataSource === \"default\"\n          ? dataSourceRegistry.get()\n          : dataSourceRegistry.get(targetDataSource);\n    } catch {\n      // Data source not registered yet, will wait for event\n    }\n  } else {\n    resolvedDataSource = targetDataSource;\n  }\n\n  // If data source is resolved and already disconnected, fire immediately\n  if (resolvedDataSource && !resolvedDataSource.driver.isConnected) {\n    actualCallback(resolvedDataSource);\n    return;\n  }\n\n  // Otherwise, wait for the disconnected event\n  const listener = (ds: DataSource) => {\n    const matches =\n      typeof targetDataSource === \"string\"\n        ? targetDataSource === \"default\"\n          ? ds.isDefault\n          : ds.name === targetDataSource\n        : ds === targetDataSource;\n\n    if (matches) {\n      actualCallback(ds);\n    } else {\n      // Not the one we're looking for, keep listening\n      dataSourceRegistry.once(\"disconnected\", listener);\n    }\n  };\n\n  dataSourceRegistry.once(\"disconnected\", listener);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0EA,SAAgB,cACd,4BACA,UACM;CAEN,IAAI;CACJ,IAAI;CAEJ,IAAI,OAAO,+BAA+B,YAAY;EAEpD,iBAAiB;EACjB,mBAAmB;CACrB,OAAO;EAEL,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,qEAAqE;EAEvF,iBAAiB;EACjB,mBAAmB;CACrB;CAGA,IAAI;CACJ,IAAI,OAAO,qBAAqB,UAC9B,IAAI;EACF,qBACE,qBAAqB,YACjB,mBAAmB,IAAI,IACvB,mBAAmB,IAAI,gBAAgB;CAC/C,QAAQ,CAER;MAEA,qBAAqB;CAIvB,IAAI,sBAAsB,mBAAmB,OAAO,aAAa;EAC/D,eAAe,kBAAkB;EACjC;CACF;CAGA,MAAM,YAAY,OAAmB;EAQnC,IANE,OAAO,qBAAqB,WACxB,qBAAqB,YACnB,GAAG,YACH,GAAG,SAAS,mBACd,OAAO,kBAEA;GAEX,mBAAmB,IAAI,aAAa,QAAQ;GAC5C,eAAe,EAAE;EACnB;CAEF;CAEA,mBAAmB,GAAG,aAAa,QAAQ;AAC7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyEA,SAAgB,iBACd,4BACA,UACM;CAEN,IAAI;CACJ,IAAI;CAEJ,IAAI,OAAO,+BAA+B,YAAY;EAEpD,iBAAiB;EACjB,mBAAmB;CACrB,OAAO;EAEL,IAAI,CAAC,UACH,MAAM,IAAI,MAAM,qEAAqE;EAEvF,iBAAiB;EACjB,mBAAmB;CACrB;CAGA,IAAI;CACJ,IAAI,OAAO,qBAAqB,UAC9B,IAAI;EACF,qBACE,qBAAqB,YACjB,mBAAmB,IAAI,IACvB,mBAAmB,IAAI,gBAAgB;CAC/C,QAAQ,CAER;MAEA,qBAAqB;CAIvB,IAAI,sBAAsB,CAAC,mBAAmB,OAAO,aAAa;EAChE,eAAe,kBAAkB;EACjC;CACF;CAGA,MAAM,YAAY,OAAmB;EAQnC,IANE,OAAO,qBAAqB,WACxB,qBAAqB,YACnB,GAAG,YACH,GAAG,SAAS,mBACd,OAAO,kBAGX,eAAe,EAAE;OAGjB,mBAAmB,KAAK,gBAAgB,QAAQ;CAEpD;CAEA,mBAAmB,KAAK,gBAAgB,QAAQ;AAClD"}

package/esm/validation/database-seal-plugins.mjs

@@ -2,7 +2,7 @@ import { databaseRulesPlugin } from "./plugins/database-rules-plugin.mjs";
 import { embedValidator } from "./plugins/embed-validator-plugin.mjs";
 import { registerPlugin } from "@warlock.js/seal";
 
-//#region ../@warlock.js/cascade/src/validation/database-seal-plugins.ts
+//#region ../cascade/src/validation/database-seal-plugins.ts
 registerPlugin(embedValidator);
 registerPlugin(databaseRulesPlugin);
 

package/esm/validation/database-seal-plugins.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-seal-plugins.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/validation/database-seal-plugins.ts"],"sourcesContent":["import { registerPlugin } from \"@warlock.js/seal\";\nimport { databaseRulesPlugin } from \"./plugins/database-rules-plugin\";\nimport { embedValidator } from \"./plugins/embed-validator-plugin\";\n\nregisterPlugin(embedValidator);\nregisterPlugin(databaseRulesPlugin);\n\n/**\n * This file registers database seal plugins as a side effect.\n * Import this file to ensure the plugins are registered.\n *\n * @example\n * ```ts\n * import \"./validation/database-seal-plugins\";\n * ```\n */\nexport type DatabaseSealPlugins = typeof embedValidator | typeof databaseRulesPlugin;\n"],"mappings":";;;;;AAIA,eAAe,cAAc;AAC7B,eAAe,mBAAmB"}
+{"version":3,"file":"database-seal-plugins.mjs","names":[],"sources":["../../../../../../../cascade/src/validation/database-seal-plugins.ts"],"sourcesContent":["import { registerPlugin } from \"@warlock.js/seal\";\nimport { databaseRulesPlugin } from \"./plugins/database-rules-plugin\";\nimport { embedValidator } from \"./plugins/embed-validator-plugin\";\n\nregisterPlugin(embedValidator);\nregisterPlugin(databaseRulesPlugin);\n\n/**\n * This file registers database seal plugins as a side effect.\n * Import this file to ensure the plugins are registered.\n *\n * @example\n * ```ts\n * import \"./validation/database-seal-plugins\";\n * ```\n */\nexport type DatabaseSealPlugins = typeof embedValidator | typeof databaseRulesPlugin;\n"],"mappings":";;;;;AAIA,eAAe,cAAc;AAC7B,eAAe,mBAAmB"}

package/esm/validation/database-writer-validation-error.d.mts

@@ -1,6 +1,6 @@
 import { ValidationResult } from "@warlock.js/seal";
 
-//#region ../@warlock.js/cascade/src/validation/database-writer-validation-error.d.ts
+//#region ../cascade/src/validation/database-writer-validation-error.d.ts
 /**
  * Error thrown when model validation fails during database write operations.
  *

package/esm/validation/database-writer-validation-error.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-writer-validation-error.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/validation/database-writer-validation-error.ts"],"mappings":";;;;;AA0BA;;;;;;;;;;;;;;;;;;;;;cAAa,6BAAA,SAAsC,KAAA;EAsJX;AAAA;;;;;;;;EAAA,SA5ItB,MAAA,EAAQ,gBAAA;;;;;;;;;;;;;;cAeL,OAAA,UAAiB,MAAA,EAAQ,gBAAA;;;;;;;;;;;;;;;;;;EA0CrC,QAAA;;;;;;;;;;;;;;EAkEA,cAAA,CAAe,SAAA,WAAoB,gBAAA;;;;;;;;;;;;;;EAiBnC,aAAA,CAAc,SAAA;AAAA"}
+{"version":3,"file":"database-writer-validation-error.d.mts","names":[],"sources":["../../../../../../../cascade/src/validation/database-writer-validation-error.ts"],"mappings":";;;;;AA0BA;;;;;;;;;;;;;;;;;;;;;cAAa,6BAAA,SAAsC,KAAA;EAsJX;AAAA;;;;;;;;EAAA,SA5ItB,MAAA,EAAQ,gBAAA;;;;;;;;;;;;;;cAeL,OAAA,UAAiB,MAAA,EAAQ,gBAAA;;;;;;;;;;;;;;;;;;EA0CrC,QAAA;;;;;;;;;;;;;;EAkEA,cAAA,CAAe,SAAA,WAAoB,gBAAA;;;;;;;;;;;;;;EAiBnC,aAAA,CAAc,SAAA;AAAA"}

package/esm/validation/database-writer-validation-error.mjs

@@ -1,6 +1,6 @@
 import { colors } from "@mongez/copper";
 
-//#region ../@warlock.js/cascade/src/validation/database-writer-validation-error.ts
+//#region ../cascade/src/validation/database-writer-validation-error.ts
 /**
 * Error thrown when model validation fails during database write operations.
 *

package/esm/validation/database-writer-validation-error.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-writer-validation-error.mjs","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/validation/database-writer-validation-error.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { ValidationResult } from \"@warlock.js/seal\";\n\n/**\n * Error thrown when model validation fails during database write operations.\n *\n * Contains detailed information about all validation errors,\n * including field paths, error messages, and validation rules that failed.\n *\n * @example\n * ```typescript\n * try {\n *   const user = new User({ name: \"\", age: -5 });\n *   await user.save();\n * } catch (error) {\n *   if (error instanceof DatabaseWriterValidationError) {\n *     console.log(error.message); // \"Validation failed\"\n *     console.log(error.errors);\n *     // [\n *     //   { path: \"name\", error: \"name is required\", rule: \"required\" },\n *     //   { path: \"age\", error: \"age must be at least 0\", rule: \"min\" }\n *     // ]\n *   }\n * }\n * ```\n */\nexport class DatabaseWriterValidationError extends Error {\n  /**\n   * Array of validation errors from @warlock.js/seal.\n   *\n   * Each error contains:\n   * - `path`: Dot-notation path to the field (e.g., \"address.city\")\n   * - `error`: Human-readable error message\n   * - `rule`: The validation rule that failed (e.g., \"required\", \"email\")\n   * - Additional context depending on the rule\n   */\n  public readonly errors: ValidationResult[\"errors\"];\n\n  /**\n   * Create a new DatabaseWriterValidationError.\n   *\n   * @param message - Error message (typically \"Validation failed\")\n   * @param errors - Array of validation errors from seal\n   *\n   * @example\n   * ```typescript\n   * const error = new DatabaseWriterValidationError(\"Validation failed\", [\n   *   { path: \"email\", error: \"email must be valid\", rule: \"email\" }\n   * ]);\n   * ```\n   */\n  public constructor(message: string, errors: ValidationResult[\"errors\"]) {\n    super(message);\n    this.name = \"DatabaseWriterValidationError\";\n    this.errors = errors;\n\n    // Maintain proper stack trace for where error was thrown (V8 only)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, DatabaseWriterValidationError);\n    }\n\n    // Override Node.js inspect to use our formatted output\n    Object.defineProperty(this, \"inspect\", {\n      value: () => this.toString(),\n      enumerable: false,\n    });\n  }\n\n  /**\n   * Custom inspect method for Node.js console output.\n   * This makes console.log and error logging use our beautiful format.\n   */\n  [Symbol.for(\"nodejs.util.inspect.custom\")](): string {\n    return this.toString();\n  }\n\n  /**\n   * Get a formatted string representation of all validation errors.\n   *\n   * Provides beautiful, colored terminal output with clear field-by-field breakdown.\n   *\n   * @returns Multi-line string with all errors, formatted for terminal\n   *\n   * @example\n   * ```typescript\n   * console.log(error.toString());\n   * // ❌ Validation Error: UserModel\n   * //\n   * //   Field: email\n   * //   Error: Email already exists\n   * //   Value: \"john@example.com\"\n   * ```\n   */\n  public toString(): string {\n    // Extract model name from message (e.g., \"[UserModel Model]\")\n    const modelMatch = this.message.match(/\\[(\\w+)\\s+Model\\]/);\n    const modelName = modelMatch ? modelMatch[1] : \"Model\";\n    const operation = this.message.includes(\"Insert\") ? \"Insert\" : \"Update\";\n\n    // Build header\n    const lines: string[] = [];\n    lines.push(\"\");\n    lines.push(colors.red(`❌ Validation Error: ${modelName} (${operation})`));\n    lines.push(\"\");\n\n    // Group errors by field for better readability\n    const errorsByField = new Map<string, Array<{ error: string; type?: string; value?: any }>>();\n\n    for (const err of this.errors) {\n      const fieldName = err.input || \"unknown\";\n      if (!errorsByField.has(fieldName)) {\n        errorsByField.set(fieldName, []);\n      }\n      errorsByField.get(fieldName)!.push({\n        error: err.error,\n        type: err.type,\n        value: (err as any).value,\n      });\n    }\n\n    // Format each field's errors\n    for (const [fieldName, fieldErrors] of errorsByField) {\n      lines.push(colors.yellow(`  Field: ${fieldName}`));\n\n      for (const fieldError of fieldErrors) {\n        lines.push(colors.white(`  Error: ${fieldError.error}`));\n\n        if (fieldError.value !== undefined) {\n          const valueStr =\n            typeof fieldError.value === \"string\"\n              ? `\"${fieldError.value}\"`\n              : JSON.stringify(fieldError.value);\n          lines.push(colors.gray(`  Value: ${valueStr}`));\n        }\n\n        if (fieldError.type) {\n          lines.push(colors.cyan(`  Type:  ${fieldError.type}`));\n        }\n      }\n\n      lines.push(\"\"); // Blank line between fields\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Get validation errors for a specific field.\n   *\n   * @param fieldPath - Dot-notation path to the field\n   * @returns Array of errors for that field\n   *\n   * @example\n   * ```typescript\n   * const emailErrors = error.getFieldErrors(\"email\");\n   * console.log(emailErrors);\n   * // [{ path: \"email\", error: \"email must be valid\", rule: \"email\" }]\n   * ```\n   */\n  public getFieldErrors(fieldPath: string): ValidationResult[\"errors\"] {\n    return this.errors.filter((err) => err.input === fieldPath);\n  }\n\n  /**\n   * Check if a specific field has validation errors.\n   *\n   * @param fieldPath - Dot-notation path to the field\n   * @returns True if the field has errors\n   *\n   * @example\n   * ```typescript\n   * if (error.hasFieldError(\"email\")) {\n   *   console.log(\"Email is invalid\");\n   * }\n   * ```\n   */\n  public hasFieldError(fieldPath: string): boolean {\n    return this.errors.some((err) => err.input === fieldPath);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAa,gCAAb,MAAa,sCAAsC,MAAM;;;;;;;;;;CAUvD,AAAgB;;;;;;;;;;;;;;CAehB,AAAO,YAAY,SAAiB,QAAoC;EACtE,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,SAAS;EAGd,IAAI,MAAM,mBACR,MAAM,kBAAkB,MAAM,6BAA6B;EAI7D,OAAO,eAAe,MAAM,WAAW;GACrC,aAAa,KAAK,SAAS;GAC3B,YAAY;EACd,CAAC;CACH;;;;;CAMA,CAAC,OAAO,IAAI,4BAA4B,KAAa;EACnD,OAAO,KAAK,SAAS;CACvB;;;;;;;;;;;;;;;;;;CAmBA,AAAO,WAAmB;EAExB,MAAM,aAAa,KAAK,QAAQ,MAAM,mBAAmB;EACzD,MAAM,YAAY,aAAa,WAAW,KAAK;EAC/C,MAAM,YAAY,KAAK,QAAQ,SAAS,QAAQ,IAAI,WAAW;EAG/D,MAAM,QAAkB,CAAC;EACzB,MAAM,KAAK,EAAE;EACb,MAAM,KAAK,OAAO,IAAI,uBAAuB,UAAU,IAAI,UAAU,EAAE,CAAC;EACxE,MAAM,KAAK,EAAE;EAGb,MAAM,gCAAgB,IAAI,IAAkE;EAE5F,KAAK,MAAM,OAAO,KAAK,QAAQ;GAC7B,MAAM,YAAY,IAAI,SAAS;GAC/B,IAAI,CAAC,cAAc,IAAI,SAAS,GAC9B,cAAc,IAAI,WAAW,CAAC,CAAC;GAEjC,cAAc,IAAI,SAAS,CAAC,CAAE,KAAK;IACjC,OAAO,IAAI;IACX,MAAM,IAAI;IACV,OAAQ,IAAY;GACtB,CAAC;EACH;EAGA,KAAK,MAAM,CAAC,WAAW,gBAAgB,eAAe;GACpD,MAAM,KAAK,OAAO,OAAO,YAAY,WAAW,CAAC;GAEjD,KAAK,MAAM,cAAc,aAAa;IACpC,MAAM,KAAK,OAAO,MAAM,YAAY,WAAW,OAAO,CAAC;IAEvD,IAAI,WAAW,UAAU,QAAW;KAClC,MAAM,WACJ,OAAO,WAAW,UAAU,WACxB,IAAI,WAAW,MAAM,KACrB,KAAK,UAAU,WAAW,KAAK;KACrC,MAAM,KAAK,OAAO,KAAK,YAAY,UAAU,CAAC;IAChD;IAEA,IAAI,WAAW,MACb,MAAM,KAAK,OAAO,KAAK,YAAY,WAAW,MAAM,CAAC;GAEzD;GAEA,MAAM,KAAK,EAAE;EACf;EAEA,OAAO,MAAM,KAAK,IAAI;CACxB;;;;;;;;;;;;;;CAeA,AAAO,eAAe,WAA+C;EACnE,OAAO,KAAK,OAAO,QAAQ,QAAQ,IAAI,UAAU,SAAS;CAC5D;;;;;;;;;;;;;;CAeA,AAAO,cAAc,WAA4B;EAC/C,OAAO,KAAK,OAAO,MAAM,QAAQ,IAAI,UAAU,SAAS;CAC1D;AACF"}
+{"version":3,"file":"database-writer-validation-error.mjs","names":[],"sources":["../../../../../../../cascade/src/validation/database-writer-validation-error.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport type { ValidationResult } from \"@warlock.js/seal\";\n\n/**\n * Error thrown when model validation fails during database write operations.\n *\n * Contains detailed information about all validation errors,\n * including field paths, error messages, and validation rules that failed.\n *\n * @example\n * ```typescript\n * try {\n *   const user = new User({ name: \"\", age: -5 });\n *   await user.save();\n * } catch (error) {\n *   if (error instanceof DatabaseWriterValidationError) {\n *     console.log(error.message); // \"Validation failed\"\n *     console.log(error.errors);\n *     // [\n *     //   { path: \"name\", error: \"name is required\", rule: \"required\" },\n *     //   { path: \"age\", error: \"age must be at least 0\", rule: \"min\" }\n *     // ]\n *   }\n * }\n * ```\n */\nexport class DatabaseWriterValidationError extends Error {\n  /**\n   * Array of validation errors from @warlock.js/seal.\n   *\n   * Each error contains:\n   * - `path`: Dot-notation path to the field (e.g., \"address.city\")\n   * - `error`: Human-readable error message\n   * - `rule`: The validation rule that failed (e.g., \"required\", \"email\")\n   * - Additional context depending on the rule\n   */\n  public readonly errors: ValidationResult[\"errors\"];\n\n  /**\n   * Create a new DatabaseWriterValidationError.\n   *\n   * @param message - Error message (typically \"Validation failed\")\n   * @param errors - Array of validation errors from seal\n   *\n   * @example\n   * ```typescript\n   * const error = new DatabaseWriterValidationError(\"Validation failed\", [\n   *   { path: \"email\", error: \"email must be valid\", rule: \"email\" }\n   * ]);\n   * ```\n   */\n  public constructor(message: string, errors: ValidationResult[\"errors\"]) {\n    super(message);\n    this.name = \"DatabaseWriterValidationError\";\n    this.errors = errors;\n\n    // Maintain proper stack trace for where error was thrown (V8 only)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, DatabaseWriterValidationError);\n    }\n\n    // Override Node.js inspect to use our formatted output\n    Object.defineProperty(this, \"inspect\", {\n      value: () => this.toString(),\n      enumerable: false,\n    });\n  }\n\n  /**\n   * Custom inspect method for Node.js console output.\n   * This makes console.log and error logging use our beautiful format.\n   */\n  [Symbol.for(\"nodejs.util.inspect.custom\")](): string {\n    return this.toString();\n  }\n\n  /**\n   * Get a formatted string representation of all validation errors.\n   *\n   * Provides beautiful, colored terminal output with clear field-by-field breakdown.\n   *\n   * @returns Multi-line string with all errors, formatted for terminal\n   *\n   * @example\n   * ```typescript\n   * console.log(error.toString());\n   * // ❌ Validation Error: UserModel\n   * //\n   * //   Field: email\n   * //   Error: Email already exists\n   * //   Value: \"john@example.com\"\n   * ```\n   */\n  public toString(): string {\n    // Extract model name from message (e.g., \"[UserModel Model]\")\n    const modelMatch = this.message.match(/\\[(\\w+)\\s+Model\\]/);\n    const modelName = modelMatch ? modelMatch[1] : \"Model\";\n    const operation = this.message.includes(\"Insert\") ? \"Insert\" : \"Update\";\n\n    // Build header\n    const lines: string[] = [];\n    lines.push(\"\");\n    lines.push(colors.red(`❌ Validation Error: ${modelName} (${operation})`));\n    lines.push(\"\");\n\n    // Group errors by field for better readability\n    const errorsByField = new Map<string, Array<{ error: string; type?: string; value?: any }>>();\n\n    for (const err of this.errors) {\n      const fieldName = err.input || \"unknown\";\n      if (!errorsByField.has(fieldName)) {\n        errorsByField.set(fieldName, []);\n      }\n      errorsByField.get(fieldName)!.push({\n        error: err.error,\n        type: err.type,\n        value: (err as any).value,\n      });\n    }\n\n    // Format each field's errors\n    for (const [fieldName, fieldErrors] of errorsByField) {\n      lines.push(colors.yellow(`  Field: ${fieldName}`));\n\n      for (const fieldError of fieldErrors) {\n        lines.push(colors.white(`  Error: ${fieldError.error}`));\n\n        if (fieldError.value !== undefined) {\n          const valueStr =\n            typeof fieldError.value === \"string\"\n              ? `\"${fieldError.value}\"`\n              : JSON.stringify(fieldError.value);\n          lines.push(colors.gray(`  Value: ${valueStr}`));\n        }\n\n        if (fieldError.type) {\n          lines.push(colors.cyan(`  Type:  ${fieldError.type}`));\n        }\n      }\n\n      lines.push(\"\"); // Blank line between fields\n    }\n\n    return lines.join(\"\\n\");\n  }\n\n  /**\n   * Get validation errors for a specific field.\n   *\n   * @param fieldPath - Dot-notation path to the field\n   * @returns Array of errors for that field\n   *\n   * @example\n   * ```typescript\n   * const emailErrors = error.getFieldErrors(\"email\");\n   * console.log(emailErrors);\n   * // [{ path: \"email\", error: \"email must be valid\", rule: \"email\" }]\n   * ```\n   */\n  public getFieldErrors(fieldPath: string): ValidationResult[\"errors\"] {\n    return this.errors.filter((err) => err.input === fieldPath);\n  }\n\n  /**\n   * Check if a specific field has validation errors.\n   *\n   * @param fieldPath - Dot-notation path to the field\n   * @returns True if the field has errors\n   *\n   * @example\n   * ```typescript\n   * if (error.hasFieldError(\"email\")) {\n   *   console.log(\"Email is invalid\");\n   * }\n   * ```\n   */\n  public hasFieldError(fieldPath: string): boolean {\n    return this.errors.some((err) => err.input === fieldPath);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,IAAa,gCAAb,MAAa,sCAAsC,MAAM;;;;;;;;;;CAUvD,AAAgB;;;;;;;;;;;;;;CAehB,AAAO,YAAY,SAAiB,QAAoC;EACtE,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,SAAS;EAGd,IAAI,MAAM,mBACR,MAAM,kBAAkB,MAAM,6BAA6B;EAI7D,OAAO,eAAe,MAAM,WAAW;GACrC,aAAa,KAAK,SAAS;GAC3B,YAAY;EACd,CAAC;CACH;;;;;CAMA,CAAC,OAAO,IAAI,4BAA4B,KAAa;EACnD,OAAO,KAAK,SAAS;CACvB;;;;;;;;;;;;;;;;;;CAmBA,AAAO,WAAmB;EAExB,MAAM,aAAa,KAAK,QAAQ,MAAM,mBAAmB;EACzD,MAAM,YAAY,aAAa,WAAW,KAAK;EAC/C,MAAM,YAAY,KAAK,QAAQ,SAAS,QAAQ,IAAI,WAAW;EAG/D,MAAM,QAAkB,CAAC;EACzB,MAAM,KAAK,EAAE;EACb,MAAM,KAAK,OAAO,IAAI,uBAAuB,UAAU,IAAI,UAAU,EAAE,CAAC;EACxE,MAAM,KAAK,EAAE;EAGb,MAAM,gCAAgB,IAAI,IAAkE;EAE5F,KAAK,MAAM,OAAO,KAAK,QAAQ;GAC7B,MAAM,YAAY,IAAI,SAAS;GAC/B,IAAI,CAAC,cAAc,IAAI,SAAS,GAC9B,cAAc,IAAI,WAAW,CAAC,CAAC;GAEjC,cAAc,IAAI,SAAS,CAAC,CAAE,KAAK;IACjC,OAAO,IAAI;IACX,MAAM,IAAI;IACV,OAAQ,IAAY;GACtB,CAAC;EACH;EAGA,KAAK,MAAM,CAAC,WAAW,gBAAgB,eAAe;GACpD,MAAM,KAAK,OAAO,OAAO,YAAY,WAAW,CAAC;GAEjD,KAAK,MAAM,cAAc,aAAa;IACpC,MAAM,KAAK,OAAO,MAAM,YAAY,WAAW,OAAO,CAAC;IAEvD,IAAI,WAAW,UAAU,QAAW;KAClC,MAAM,WACJ,OAAO,WAAW,UAAU,WACxB,IAAI,WAAW,MAAM,KACrB,KAAK,UAAU,WAAW,KAAK;KACrC,MAAM,KAAK,OAAO,KAAK,YAAY,UAAU,CAAC;IAChD;IAEA,IAAI,WAAW,MACb,MAAM,KAAK,OAAO,KAAK,YAAY,WAAW,MAAM,CAAC;GAEzD;GAEA,MAAM,KAAK,EAAE;EACf;EAEA,OAAO,MAAM,KAAK,IAAI;CACxB;;;;;;;;;;;;;;CAeA,AAAO,eAAe,WAA+C;EACnE,OAAO,KAAK,OAAO,QAAQ,QAAQ,IAAI,UAAU,SAAS;CAC5D;;;;;;;;;;;;;;CAeA,AAAO,cAAc,WAA4B;EAC/C,OAAO,KAAK,OAAO,MAAM,QAAQ,IAAI,UAAU,SAAS;CAC1D;AACF"}

package/esm/validation/mutators/embed-mutator.mjs

@@ -1,7 +1,7 @@
 import { getModelFromRegistry } from "../../model/register-model.mjs";
 import { Model } from "../../model/model.mjs";
 
-//#region ../@warlock.js/cascade/src/validation/mutators/embed-mutator.ts
+//#region ../cascade/src/validation/mutators/embed-mutator.ts
 const databaseModelMutator = async (value, context) => {
 	let { model: ModelClass } = context?.options || {};
 	if (typeof ModelClass === "string") ModelClass = getModelFromRegistry(ModelClass);

package/esm/validation/mutators/embed-mutator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"embed-mutator.mjs","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/validation/mutators/embed-mutator.ts"],"sourcesContent":["import type { Mutator } from \"@warlock.js/seal\";\nimport { ChildModel, Model } from \"../../model/model\";\nimport { getModelFromRegistry } from \"../../model/register-model\";\n\ntype DatabaseModelMutatorOptions = {\n  model: ChildModel<any> | string;\n};\n\nexport const databaseModelMutator: Mutator<DatabaseModelMutatorOptions> = async (\n  value,\n  context,\n) => {\n  let { model: ModelClass } = context?.options || {};\n\n  if (typeof ModelClass === \"string\") {\n    ModelClass = getModelFromRegistry(ModelClass)!;\n  }\n\n  if (!ModelClass) {\n    throw new Error(`Model ${ModelClass} not found in registry`);\n  }\n\n  if (value instanceof Model) return value;\n\n  if (typeof value === \"object\" && value?.id) {\n    value = Number(value.id);\n  }\n\n  if (typeof value !== \"number\") return value;\n\n  return await ModelClass.find(value);\n};\n\nexport const databaseModelsMutator: Mutator<DatabaseModelMutatorOptions> = async (\n  value,\n  context,\n) => {\n  if (!Array.isArray(value)) return value;\n\n  let { model: ModelClass } = context?.options || {};\n\n  if (typeof ModelClass === \"string\") {\n    ModelClass = getModelFromRegistry(ModelClass)!;\n  }\n\n  if (!ModelClass) {\n    throw new Error(`Model ${ModelClass} not found in registry`);\n  }\n\n  // first, if all values are list of models, then return them.\n  if (value.every((item) => item instanceof Model)) return value;\n\n  const ids = value.map((item) => item?.id || item).filter((item) => item !== undefined);\n\n  return await ModelClass.query().whereIn(\"id\", ids).get();\n};\n"],"mappings":";;;;AAQA,MAAa,uBAA6D,OACxE,OACA,YACG;CACH,IAAI,EAAE,OAAO,eAAe,SAAS,WAAW,CAAC;CAEjD,IAAI,OAAO,eAAe,UACxB,aAAa,qBAAqB,UAAU;CAG9C,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,SAAS,WAAW,uBAAuB;CAG7D,IAAI,iBAAiB,OAAO,OAAO;CAEnC,IAAI,OAAO,UAAU,YAAY,OAAO,IACtC,QAAQ,OAAO,MAAM,EAAE;CAGzB,IAAI,OAAO,UAAU,UAAU,OAAO;CAEtC,OAAO,MAAM,WAAW,KAAK,KAAK;AACpC;AAEA,MAAa,wBAA8D,OACzE,OACA,YACG;CACH,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO;CAElC,IAAI,EAAE,OAAO,eAAe,SAAS,WAAW,CAAC;CAEjD,IAAI,OAAO,eAAe,UACxB,aAAa,qBAAqB,UAAU;CAG9C,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,SAAS,WAAW,uBAAuB;CAI7D,IAAI,MAAM,OAAO,SAAS,gBAAgB,KAAK,GAAG,OAAO;CAEzD,MAAM,MAAM,MAAM,KAAK,SAAS,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ,SAAS,SAAS,MAAS;CAErF,OAAO,MAAM,WAAW,MAAM,CAAC,CAAC,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI;AACzD"}
+{"version":3,"file":"embed-mutator.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/mutators/embed-mutator.ts"],"sourcesContent":["import type { Mutator } from \"@warlock.js/seal\";\nimport { ChildModel, Model } from \"../../model/model\";\nimport { getModelFromRegistry } from \"../../model/register-model\";\n\ntype DatabaseModelMutatorOptions = {\n  model: ChildModel<any> | string;\n};\n\nexport const databaseModelMutator: Mutator<DatabaseModelMutatorOptions> = async (\n  value,\n  context,\n) => {\n  let { model: ModelClass } = context?.options || {};\n\n  if (typeof ModelClass === \"string\") {\n    ModelClass = getModelFromRegistry(ModelClass)!;\n  }\n\n  if (!ModelClass) {\n    throw new Error(`Model ${ModelClass} not found in registry`);\n  }\n\n  if (value instanceof Model) return value;\n\n  if (typeof value === \"object\" && value?.id) {\n    value = Number(value.id);\n  }\n\n  if (typeof value !== \"number\") return value;\n\n  return await ModelClass.find(value);\n};\n\nexport const databaseModelsMutator: Mutator<DatabaseModelMutatorOptions> = async (\n  value,\n  context,\n) => {\n  if (!Array.isArray(value)) return value;\n\n  let { model: ModelClass } = context?.options || {};\n\n  if (typeof ModelClass === \"string\") {\n    ModelClass = getModelFromRegistry(ModelClass)!;\n  }\n\n  if (!ModelClass) {\n    throw new Error(`Model ${ModelClass} not found in registry`);\n  }\n\n  // first, if all values are list of models, then return them.\n  if (value.every((item) => item instanceof Model)) return value;\n\n  const ids = value.map((item) => item?.id || item).filter((item) => item !== undefined);\n\n  return await ModelClass.query().whereIn(\"id\", ids).get();\n};\n"],"mappings":";;;;AAQA,MAAa,uBAA6D,OACxE,OACA,YACG;CACH,IAAI,EAAE,OAAO,eAAe,SAAS,WAAW,CAAC;CAEjD,IAAI,OAAO,eAAe,UACxB,aAAa,qBAAqB,UAAU;CAG9C,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,SAAS,WAAW,uBAAuB;CAG7D,IAAI,iBAAiB,OAAO,OAAO;CAEnC,IAAI,OAAO,UAAU,YAAY,OAAO,IACtC,QAAQ,OAAO,MAAM,EAAE;CAGzB,IAAI,OAAO,UAAU,UAAU,OAAO;CAEtC,OAAO,MAAM,WAAW,KAAK,KAAK;AACpC;AAEA,MAAa,wBAA8D,OACzE,OACA,YACG;CACH,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO;CAElC,IAAI,EAAE,OAAO,eAAe,SAAS,WAAW,CAAC;CAEjD,IAAI,OAAO,eAAe,UACxB,aAAa,qBAAqB,UAAU;CAG9C,IAAI,CAAC,YACH,MAAM,IAAI,MAAM,SAAS,WAAW,uBAAuB;CAI7D,IAAI,MAAM,OAAO,SAAS,gBAAgB,KAAK,GAAG,OAAO;CAEzD,MAAM,MAAM,MAAM,KAAK,SAAS,MAAM,MAAM,IAAI,CAAC,CAAC,QAAQ,SAAS,SAAS,MAAS;CAErF,OAAO,MAAM,WAAW,MAAM,CAAC,CAAC,QAAQ,MAAM,GAAG,CAAC,CAAC,IAAI;AACzD"}

package/esm/validation/plugins/database-rules-plugin.d.mts

@@ -1,7 +1,7 @@
 import { ChildModel } from "../../model/model.types.mjs";
 import { Model } from "../../model/model.mjs";
 import { ExistsRuleOptions, UniqueRuleOptions } from "../types.mjs";
-//#region ../@warlock.js/cascade/src/validation/plugins/database-rules-plugin.d.ts
+//#region ../cascade/src/validation/plugins/database-rules-plugin.d.ts
 declare module "@warlock.js/seal" {
   interface ScalarValidator {
     /** Value must be unique in database */

package/esm/validation/plugins/database-rules-plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-rules-plugin.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/validation/plugins/database-rules-plugin.ts"],"mappings":";;;;;YAmBY,eAAA;IAYgB;IAVxB,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;IAmBI;IAdR,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;EAAA;EAAA,UAKI,eAAA;IACR,MAAA,EAAQ,eAAA;IACR,MAAA,EAAQ,eAAA;EAAA;EAAA,UAGA,eAAA;IACR,MAAA,EAAQ,eAAA;IACR,MAAA,EAAQ,eAAA;EAAA;AAAA"}
+{"version":3,"file":"database-rules-plugin.d.mts","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/database-rules-plugin.ts"],"mappings":";;;;;YAmBY,eAAA;IAYgB;IAVxB,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;IAmBI;IAdR,MAAA,CACE,KAAA,EAAO,UAAA,CAAW,KAAA,YAClB,WAAA,GAAc,OAAA,CAAQ,iBAAA;MACpB,YAAA;IAAA;EAAA;EAAA,UAKI,eAAA;IACR,MAAA,EAAQ,eAAA;IACR,MAAA,EAAQ,eAAA;EAAA;EAAA,UAGA,eAAA;IACR,MAAA,EAAQ,eAAA;IACR,MAAA,EAAQ,eAAA;EAAA;AAAA"}

package/esm/validation/plugins/database-rules-plugin.mjs

@@ -2,7 +2,7 @@ import { existsRule } from "../rules/exists-rule.mjs";
 import { uniqueRule } from "../rules/unique-rule.mjs";
 import { NumberValidator, ScalarValidator, StringValidator } from "@warlock.js/seal";
 
-//#region ../@warlock.js/cascade/src/validation/plugins/database-rules-plugin.ts
+//#region ../cascade/src/validation/plugins/database-rules-plugin.ts
 /**
 * Cascade's database-rules plugin for Seal.
 */

package/esm/validation/plugins/database-rules-plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-rules-plugin.mjs","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/validation/plugins/database-rules-plugin.ts"],"sourcesContent":["/**\n * Database Rules Plugin\n *\n * Injects the `.unique()` and `.exists()` method-chain entries onto Seal's\n * scalar validators. These are the Cascade-owned, DB-aware validation rules.\n *\n * Request-aware variants (`uniqueExceptCurrentUser`, etc.) live in\n * `@warlock.js/core` because they depend on the HTTP request store, which\n * Cascade has no business knowing about.\n */\n\nimport type { SealPlugin } from \"@warlock.js/seal\";\nimport { NumberValidator, ScalarValidator, StringValidator } from \"@warlock.js/seal\";\nimport type { ChildModel, Model } from \"../../model/model\";\nimport { existsRule } from \"../rules/exists-rule\";\nimport { uniqueRule } from \"../rules/unique-rule\";\nimport type { ExistsRuleOptions, UniqueRuleOptions } from \"../types\";\n\ndeclare module \"@warlock.js/seal\" {\n  interface ScalarValidator {\n    /** Value must be unique in database */\n    unique(\n      model: ChildModel<Model> | string,\n      optionsList?: Partial<UniqueRuleOptions> & {\n        errorMessage?: string;\n      },\n    ): this;\n\n    /** Value must exist in database */\n    exists(\n      model: ChildModel<Model> | string,\n      optionsList?: Partial<ExistsRuleOptions> & {\n        errorMessage?: string;\n      },\n    ): this;\n  }\n\n  interface StringValidator {\n    unique: ScalarValidator[\"unique\"];\n    exists: ScalarValidator[\"exists\"];\n  }\n\n  interface NumberValidator {\n    unique: ScalarValidator[\"unique\"];\n    exists: ScalarValidator[\"exists\"];\n  }\n}\n\n/**\n * Cascade's database-rules plugin for Seal.\n */\nexport const databaseRulesPlugin: SealPlugin = {\n  name: \"cascade-database-rules\",\n  version: \"1.0.0\",\n  description: \"Adds unique() and exists() database validation methods to Seal scalar validators\",\n\n  install() {\n    Object.assign(ScalarValidator.prototype, {\n      unique(\n        this: ScalarValidator,\n        model: ChildModel<Model> | string,\n        optionsList?: Partial<UniqueRuleOptions> & {\n          errorMessage?: string;\n        },\n      ) {\n        const { errorMessage, ...options } = optionsList || {};\n\n        return this.addRule(uniqueRule, errorMessage, {\n          Model: model,\n          ...options,\n        });\n      },\n\n      exists(\n        this: ScalarValidator,\n        model: ChildModel<Model> | string,\n        optionsList?: Partial<ExistsRuleOptions> & {\n          errorMessage?: string;\n        },\n      ) {\n        const { errorMessage, ...options } = optionsList || {};\n\n        return this.addRule(existsRule, errorMessage, {\n          Model: model,\n          ...options,\n        });\n      },\n    });\n\n    Object.assign(StringValidator.prototype, {\n      unique: ScalarValidator.prototype.unique,\n      exists: ScalarValidator.prototype.exists,\n    });\n\n    Object.assign(NumberValidator.prototype, {\n      unique: ScalarValidator.prototype.unique,\n      exists: ScalarValidator.prototype.exists,\n    });\n  },\n};\n"],"mappings":";;;;;;;;AAmDA,MAAa,sBAAkC;CAC7C,MAAM;CACN,SAAS;CACT,aAAa;CAEb,UAAU;EACR,OAAO,OAAO,gBAAgB,WAAW;GACvC,OAEE,OACA,aAGA;IACA,MAAM,EAAE,cAAc,GAAG,YAAY,eAAe,CAAC;IAErD,OAAO,KAAK,QAAQ,YAAY,cAAc;KAC5C,OAAO;KACP,GAAG;IACL,CAAC;GACH;GAEA,OAEE,OACA,aAGA;IACA,MAAM,EAAE,cAAc,GAAG,YAAY,eAAe,CAAC;IAErD,OAAO,KAAK,QAAQ,YAAY,cAAc;KAC5C,OAAO;KACP,GAAG;IACL,CAAC;GACH;EACF,CAAC;EAED,OAAO,OAAO,gBAAgB,WAAW;GACvC,QAAQ,gBAAgB,UAAU;GAClC,QAAQ,gBAAgB,UAAU;EACpC,CAAC;EAED,OAAO,OAAO,gBAAgB,WAAW;GACvC,QAAQ,gBAAgB,UAAU;GAClC,QAAQ,gBAAgB,UAAU;EACpC,CAAC;CACH;AACF"}
+{"version":3,"file":"database-rules-plugin.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/database-rules-plugin.ts"],"sourcesContent":["/**\n * Database Rules Plugin\n *\n * Injects the `.unique()` and `.exists()` method-chain entries onto Seal's\n * scalar validators. These are the Cascade-owned, DB-aware validation rules.\n *\n * Request-aware variants (`uniqueExceptCurrentUser`, etc.) live in\n * `@warlock.js/core` because they depend on the HTTP request store, which\n * Cascade has no business knowing about.\n */\n\nimport type { SealPlugin } from \"@warlock.js/seal\";\nimport { NumberValidator, ScalarValidator, StringValidator } from \"@warlock.js/seal\";\nimport type { ChildModel, Model } from \"../../model/model\";\nimport { existsRule } from \"../rules/exists-rule\";\nimport { uniqueRule } from \"../rules/unique-rule\";\nimport type { ExistsRuleOptions, UniqueRuleOptions } from \"../types\";\n\ndeclare module \"@warlock.js/seal\" {\n  interface ScalarValidator {\n    /** Value must be unique in database */\n    unique(\n      model: ChildModel<Model> | string,\n      optionsList?: Partial<UniqueRuleOptions> & {\n        errorMessage?: string;\n      },\n    ): this;\n\n    /** Value must exist in database */\n    exists(\n      model: ChildModel<Model> | string,\n      optionsList?: Partial<ExistsRuleOptions> & {\n        errorMessage?: string;\n      },\n    ): this;\n  }\n\n  interface StringValidator {\n    unique: ScalarValidator[\"unique\"];\n    exists: ScalarValidator[\"exists\"];\n  }\n\n  interface NumberValidator {\n    unique: ScalarValidator[\"unique\"];\n    exists: ScalarValidator[\"exists\"];\n  }\n}\n\n/**\n * Cascade's database-rules plugin for Seal.\n */\nexport const databaseRulesPlugin: SealPlugin = {\n  name: \"cascade-database-rules\",\n  version: \"1.0.0\",\n  description: \"Adds unique() and exists() database validation methods to Seal scalar validators\",\n\n  install() {\n    Object.assign(ScalarValidator.prototype, {\n      unique(\n        this: ScalarValidator,\n        model: ChildModel<Model> | string,\n        optionsList?: Partial<UniqueRuleOptions> & {\n          errorMessage?: string;\n        },\n      ) {\n        const { errorMessage, ...options } = optionsList || {};\n\n        return this.addRule(uniqueRule, errorMessage, {\n          Model: model,\n          ...options,\n        });\n      },\n\n      exists(\n        this: ScalarValidator,\n        model: ChildModel<Model> | string,\n        optionsList?: Partial<ExistsRuleOptions> & {\n          errorMessage?: string;\n        },\n      ) {\n        const { errorMessage, ...options } = optionsList || {};\n\n        return this.addRule(existsRule, errorMessage, {\n          Model: model,\n          ...options,\n        });\n      },\n    });\n\n    Object.assign(StringValidator.prototype, {\n      unique: ScalarValidator.prototype.unique,\n      exists: ScalarValidator.prototype.exists,\n    });\n\n    Object.assign(NumberValidator.prototype, {\n      unique: ScalarValidator.prototype.unique,\n      exists: ScalarValidator.prototype.exists,\n    });\n  },\n};\n"],"mappings":";;;;;;;;AAmDA,MAAa,sBAAkC;CAC7C,MAAM;CACN,SAAS;CACT,aAAa;CAEb,UAAU;EACR,OAAO,OAAO,gBAAgB,WAAW;GACvC,OAEE,OACA,aAGA;IACA,MAAM,EAAE,cAAc,GAAG,YAAY,eAAe,CAAC;IAErD,OAAO,KAAK,QAAQ,YAAY,cAAc;KAC5C,OAAO;KACP,GAAG;IACL,CAAC;GACH;GAEA,OAEE,OACA,aAGA;IACA,MAAM,EAAE,cAAc,GAAG,YAAY,eAAe,CAAC;IAErD,OAAO,KAAK,QAAQ,YAAY,cAAc;KAC5C,OAAO;KACP,GAAG;IACL,CAAC;GACH;EACF,CAAC;EAED,OAAO,OAAO,gBAAgB,WAAW;GACvC,QAAQ,gBAAgB,UAAU;GAClC,QAAQ,gBAAgB,UAAU;EACpC,CAAC;EAED,OAAO,OAAO,gBAAgB,WAAW;GACvC,QAAQ,gBAAgB,UAAU;GAClC,QAAQ,gBAAgB,UAAU;EACpC,CAAC;CACH;AACF"}

package/esm/validation/plugins/embed-validator-plugin.d.mts

@@ -1,6 +1,6 @@
 import { ChildModel } from "../../model/model.types.mjs";
 import { EmbedModelValidator } from "../validators/embed-validator.mjs";
-//#region ../@warlock.js/cascade/src/validation/plugins/embed-validator-plugin.d.ts
+//#region ../cascade/src/validation/plugins/embed-validator-plugin.d.ts
 type EmbedOptions = {
   errorMessage?: string;
   embed?: string | string[];

package/esm/validation/plugins/embed-validator-plugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"embed-validator-plugin.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/validation/plugins/embed-validator-plugin.ts"],"mappings":";;;KAWK,YAAA;EACH,YAAA;EACA,KAAK;AAAA;AAAA;EAAA,UAIK,UAAA;IACR,KAAA,CAAM,KAAA,EAAO,UAAA,gBAA0B,OAAA,GAAU,YAAA,GAAe,mBAAA;IAChE,SAAA,CAAU,KAAA,EAAO,UAAA,gBAA0B,OAAA,GAAU,YAAA,GAAe,mBAAA;EAAA;AAAA"}
+{"version":3,"file":"embed-validator-plugin.d.mts","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/embed-validator-plugin.ts"],"mappings":";;;KAWK,YAAA;EACH,YAAA;EACA,KAAK;AAAA;AAAA;EAAA,UAIK,UAAA;IACR,KAAA,CAAM,KAAA,EAAO,UAAA,gBAA0B,OAAA,GAAU,YAAA,GAAe,mBAAA;IAChE,SAAA,CAAU,KAAA,EAAO,UAAA,gBAA0B,OAAA,GAAU,YAAA,GAAe,mBAAA;EAAA;AAAA"}

package/esm/validation/plugins/embed-validator-plugin.mjs

@@ -1,7 +1,7 @@
 import { EmbedModelValidator } from "../validators/embed-validator.mjs";
 import { v } from "@warlock.js/seal";
 
-//#region ../@warlock.js/cascade/src/validation/plugins/embed-validator-plugin.ts
+//#region ../cascade/src/validation/plugins/embed-validator-plugin.ts
 /**
 * File validation plugin for Seal
 */

package/esm/validation/plugins/embed-validator-plugin.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"embed-validator-plugin.mjs","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/validation/plugins/embed-validator-plugin.ts"],"sourcesContent":["/**\n * Embed Validator Plugin\n *\n * Adds embed validation to Seal v factory\n */\n\nimport type { SealPlugin } from \"@warlock.js/seal\";\nimport { v } from \"@warlock.js/seal\";\nimport type { ChildModel } from \"../../model/model\";\nimport { EmbedModelValidator } from \"../validators/embed-validator\";\n\ntype EmbedOptions = {\n  errorMessage?: string;\n  embed?: string | string[];\n};\n\ndeclare module \"@warlock.js/seal\" {\n  interface ValidatorV {\n    embed(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;\n    embedMany(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;\n  }\n}\n\n/**\n * File validation plugin for Seal\n */\nexport const embedValidator: SealPlugin = {\n  name: \"embed\",\n  version: \"1.0.0\",\n  description: \"Adds embed validation (v.embed())\",\n\n  install() {\n    // Inject embed() method into v factory\n    v.embed = (model: ChildModel<any> | string, options?: EmbedOptions) =>\n      new EmbedModelValidator().model(model).embed(options?.embed);\n    v.embedMany = (model: ChildModel<any> | string, options?: EmbedOptions) =>\n      new EmbedModelValidator().models(model).embed(options?.embed);\n  },\n};\n"],"mappings":";;;;;;;AA0BA,MAAa,iBAA6B;CACxC,MAAM;CACN,SAAS;CACT,aAAa;CAEb,UAAU;EAER,EAAE,SAAS,OAAiC,YAC1C,IAAI,oBAAoB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,SAAS,KAAK;EAC7D,EAAE,aAAa,OAAiC,YAC9C,IAAI,oBAAoB,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,SAAS,KAAK;CAChE;AACF"}
+{"version":3,"file":"embed-validator-plugin.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/plugins/embed-validator-plugin.ts"],"sourcesContent":["/**\n * Embed Validator Plugin\n *\n * Adds embed validation to Seal v factory\n */\n\nimport type { SealPlugin } from \"@warlock.js/seal\";\nimport { v } from \"@warlock.js/seal\";\nimport type { ChildModel } from \"../../model/model\";\nimport { EmbedModelValidator } from \"../validators/embed-validator\";\n\ntype EmbedOptions = {\n  errorMessage?: string;\n  embed?: string | string[];\n};\n\ndeclare module \"@warlock.js/seal\" {\n  interface ValidatorV {\n    embed(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;\n    embedMany(model: ChildModel<any> | string, options?: EmbedOptions): EmbedModelValidator;\n  }\n}\n\n/**\n * File validation plugin for Seal\n */\nexport const embedValidator: SealPlugin = {\n  name: \"embed\",\n  version: \"1.0.0\",\n  description: \"Adds embed validation (v.embed())\",\n\n  install() {\n    // Inject embed() method into v factory\n    v.embed = (model: ChildModel<any> | string, options?: EmbedOptions) =>\n      new EmbedModelValidator().model(model).embed(options?.embed);\n    v.embedMany = (model: ChildModel<any> | string, options?: EmbedOptions) =>\n      new EmbedModelValidator().models(model).embed(options?.embed);\n  },\n};\n"],"mappings":";;;;;;;AA0BA,MAAa,iBAA6B;CACxC,MAAM;CACN,SAAS;CACT,aAAa;CAEb,UAAU;EAER,EAAE,SAAS,OAAiC,YAC1C,IAAI,oBAAoB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,SAAS,KAAK;EAC7D,EAAE,aAAa,OAAiC,YAC9C,IAAI,oBAAoB,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,SAAS,KAAK;CAChE;AACF"}

package/esm/validation/rules/database-model-rule.mjs

@@ -2,7 +2,7 @@ import { getModelFromRegistry } from "../../model/register-model.mjs";
 import { Model } from "../../model/model.mjs";
 import { VALID_RULE, invalidRule } from "@warlock.js/seal";
 
-//#region ../@warlock.js/cascade/src/validation/rules/database-model-rule.ts
+//#region ../cascade/src/validation/rules/database-model-rule.ts
 const databaseModelRule = {
 	name: "databaseModel",
 	defaultErrorMessage: "The :input must be a valid :model model",

package/esm/validation/rules/database-model-rule.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-model-rule.mjs","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/validation/rules/database-model-rule.ts"],"sourcesContent":["import { invalidRule, VALID_RULE, type SchemaRule } from \"@warlock.js/seal\";\r\nimport { ChildModel, Model } from \"./../../model/model\";\r\nimport { getModelFromRegistry } from \"./../../model/register-model\";\r\n\r\nexport const databaseModelRule: SchemaRule = {\r\n  name: \"databaseModel\",\r\n  defaultErrorMessage: \"The :input must be a valid :model model\",\r\n  async validate(value, context) {\r\n    if (value instanceof Model === false) {\r\n      this.context.attributesList.model = this.context.options.model?.name;\r\n      return invalidRule(this, context);\r\n    }\r\n\r\n    return VALID_RULE;\r\n  },\r\n};\r\n\r\nexport const databaseModelsRule: SchemaRule<{ model: ChildModel<any> | string }> = {\r\n  name: \"databaseModels\",\r\n  defaultErrorMessage: \"The :input must be a list of valid :model\",\r\n  async validate(value, context) {\r\n    let { model } = this.context.options;\r\n    if (typeof model === \"string\") {\r\n      model = getModelFromRegistry(model)!;\r\n    }\r\n\r\n    this.context.attributesList.model = model.name;\r\n\r\n    if (!Array.isArray(value)) return invalidRule(this, context);\r\n\r\n    if (value.every((item) => item instanceof Model)) return VALID_RULE;\r\n\r\n    return invalidRule(this, context);\r\n  },\r\n};\r\n"],"mappings":";;;;;AAIA,MAAa,oBAAgC;CAC3C,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAO,SAAS;EAC7B,IAAI,iBAAiB,UAAU,OAAO;GACpC,KAAK,QAAQ,eAAe,QAAQ,KAAK,QAAQ,QAAQ,OAAO;GAChE,OAAO,YAAY,MAAM,OAAO;EAClC;EAEA,OAAO;CACT;AACF;AAEA,MAAa,qBAAsE;CACjF,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAO,SAAS;EAC7B,IAAI,EAAE,UAAU,KAAK,QAAQ;EAC7B,IAAI,OAAO,UAAU,UACnB,QAAQ,qBAAqB,KAAK;EAGpC,KAAK,QAAQ,eAAe,QAAQ,MAAM;EAE1C,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,YAAY,MAAM,OAAO;EAE3D,IAAI,MAAM,OAAO,SAAS,gBAAgB,KAAK,GAAG,OAAO;EAEzD,OAAO,YAAY,MAAM,OAAO;CAClC;AACF"}
+{"version":3,"file":"database-model-rule.mjs","names":[],"sources":["../../../../../../../../cascade/src/validation/rules/database-model-rule.ts"],"sourcesContent":["import { invalidRule, VALID_RULE, type SchemaRule } from \"@warlock.js/seal\";\r\nimport { ChildModel, Model } from \"./../../model/model\";\r\nimport { getModelFromRegistry } from \"./../../model/register-model\";\r\n\r\nexport const databaseModelRule: SchemaRule = {\r\n  name: \"databaseModel\",\r\n  defaultErrorMessage: \"The :input must be a valid :model model\",\r\n  async validate(value, context) {\r\n    if (value instanceof Model === false) {\r\n      this.context.attributesList.model = this.context.options.model?.name;\r\n      return invalidRule(this, context);\r\n    }\r\n\r\n    return VALID_RULE;\r\n  },\r\n};\r\n\r\nexport const databaseModelsRule: SchemaRule<{ model: ChildModel<any> | string }> = {\r\n  name: \"databaseModels\",\r\n  defaultErrorMessage: \"The :input must be a list of valid :model\",\r\n  async validate(value, context) {\r\n    let { model } = this.context.options;\r\n    if (typeof model === \"string\") {\r\n      model = getModelFromRegistry(model)!;\r\n    }\r\n\r\n    this.context.attributesList.model = model.name;\r\n\r\n    if (!Array.isArray(value)) return invalidRule(this, context);\r\n\r\n    if (value.every((item) => item instanceof Model)) return VALID_RULE;\r\n\r\n    return invalidRule(this, context);\r\n  },\r\n};\r\n"],"mappings":";;;;;AAIA,MAAa,oBAAgC;CAC3C,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAO,SAAS;EAC7B,IAAI,iBAAiB,UAAU,OAAO;GACpC,KAAK,QAAQ,eAAe,QAAQ,KAAK,QAAQ,QAAQ,OAAO;GAChE,OAAO,YAAY,MAAM,OAAO;EAClC;EAEA,OAAO;CACT;AACF;AAEA,MAAa,qBAAsE;CACjF,MAAM;CACN,qBAAqB;CACrB,MAAM,SAAS,OAAO,SAAS;EAC7B,IAAI,EAAE,UAAU,KAAK,QAAQ;EAC7B,IAAI,OAAO,UAAU,UACnB,QAAQ,qBAAqB,KAAK;EAGpC,KAAK,QAAQ,eAAe,QAAQ,MAAM;EAE1C,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,YAAY,MAAM,OAAO;EAE3D,IAAI,MAAM,OAAO,SAAS,gBAAgB,KAAK,GAAG,OAAO;EAEzD,OAAO,YAAY,MAAM,OAAO;CAClC;AACF"}

package/esm/validation/rules/exists-rule.mjs

@@ -1,7 +1,7 @@
 import { resolveModelClass } from "../../model/register-model.mjs";
 import { VALID_RULE, invalidRule } from "@warlock.js/seal";
 
-//#region ../@warlock.js/cascade/src/validation/rules/exists-rule.ts
+//#region ../cascade/src/validation/rules/exists-rule.ts
 /**
 * Validates that a record exists in the database for the given column/value.
 *