@warlock.js/cascade 4.6.0 → 4.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (61) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/cjs/index.cjs +372 -56
  3. package/cjs/index.cjs.map +1 -1
  4. package/esm/contracts/database-driver.contract.d.mts +8 -0
  5. package/esm/contracts/database-driver.contract.d.mts.map +1 -1
  6. package/esm/contracts/index.d.mts +1 -1
  7. package/esm/contracts/query-builder.contract.d.mts +36 -1
  8. package/esm/contracts/query-builder.contract.d.mts.map +1 -1
  9. package/esm/drivers/mongodb/mongodb-driver.d.mts +5 -0
  10. package/esm/drivers/mongodb/mongodb-driver.d.mts.map +1 -1
  11. package/esm/drivers/mongodb/mongodb-driver.mjs +10 -4
  12. package/esm/drivers/mongodb/mongodb-driver.mjs.map +1 -1
  13. package/esm/drivers/mongodb/mongodb-migration-driver.d.mts +4 -0
  14. package/esm/drivers/mongodb/mongodb-migration-driver.d.mts.map +1 -1
  15. package/esm/drivers/mongodb/mongodb-migration-driver.mjs +5 -2
  16. package/esm/drivers/mongodb/mongodb-migration-driver.mjs.map +1 -1
  17. package/esm/drivers/mongodb/mongodb-query-builder.d.mts +15 -0
  18. package/esm/drivers/mongodb/mongodb-query-builder.d.mts.map +1 -1
  19. package/esm/drivers/mongodb/mongodb-query-builder.mjs +24 -0
  20. package/esm/drivers/mongodb/mongodb-query-builder.mjs.map +1 -1
  21. package/esm/drivers/mongodb/mongodb-query-parser.d.mts +16 -0
  22. package/esm/drivers/mongodb/mongodb-query-parser.d.mts.map +1 -1
  23. package/esm/drivers/mongodb/mongodb-query-parser.mjs +33 -1
  24. package/esm/drivers/mongodb/mongodb-query-parser.mjs.map +1 -1
  25. package/esm/drivers/postgres/postgres-driver.d.mts +69 -13
  26. package/esm/drivers/postgres/postgres-driver.d.mts.map +1 -1
  27. package/esm/drivers/postgres/postgres-driver.mjs +155 -27
  28. package/esm/drivers/postgres/postgres-driver.mjs.map +1 -1
  29. package/esm/drivers/postgres/postgres-query-builder.d.mts +14 -3
  30. package/esm/drivers/postgres/postgres-query-builder.d.mts.map +1 -1
  31. package/esm/drivers/postgres/postgres-query-builder.mjs +44 -8
  32. package/esm/drivers/postgres/postgres-query-builder.mjs.map +1 -1
  33. package/esm/drivers/postgres/postgres-query-parser.d.mts +6 -1
  34. package/esm/drivers/postgres/postgres-query-parser.d.mts.map +1 -1
  35. package/esm/drivers/postgres/postgres-query-parser.mjs +13 -0
  36. package/esm/drivers/postgres/postgres-query-parser.mjs.map +1 -1
  37. package/esm/drivers/postgres/postgres-sql-serializer.mjs +15 -4
  38. package/esm/drivers/postgres/postgres-sql-serializer.mjs.map +1 -1
  39. package/esm/index.d.mts +2 -2
  40. package/esm/migration/migration-runner.d.mts.map +1 -1
  41. package/esm/migration/migration-runner.mjs +25 -3
  42. package/esm/migration/migration-runner.mjs.map +1 -1
  43. package/esm/migration/migration.d.mts +6 -3
  44. package/esm/migration/migration.d.mts.map +1 -1
  45. package/esm/migration/migration.mjs +6 -3
  46. package/esm/migration/migration.mjs.map +1 -1
  47. package/esm/model/methods/scope-methods.mjs +18 -4
  48. package/esm/model/methods/scope-methods.mjs.map +1 -1
  49. package/esm/model/model.d.mts +6 -0
  50. package/esm/model/model.d.mts.map +1 -1
  51. package/esm/model/model.mjs +6 -0
  52. package/esm/model/model.mjs.map +1 -1
  53. package/esm/query-builder/query-builder.d.mts +12 -1
  54. package/esm/query-builder/query-builder.d.mts.map +1 -1
  55. package/esm/query-builder/query-builder.mjs +19 -0
  56. package/esm/query-builder/query-builder.mjs.map +1 -1
  57. package/llms-full.txt +41 -7
  58. package/llms.txt +1 -1
  59. package/package.json +4 -4
  60. package/skills/README.md +1 -1
  61. package/skills/manage-transactions/SKILL.md +41 -7
@@ -330,6 +330,14 @@ interface DriverContract {
330
330
  syncAdapter(): SyncAdapterContract;
331
331
  /** Access the migration driver for schema operations. */
332
332
  migrationDriver(): MigrationDriverContract;
333
+ /**
334
+ * Whether this driver can serialize migrations to SQL strings.
335
+ *
336
+ * Defaults to `true` (absent = SQL-capable). Drivers without a SQL dialect
337
+ * (MongoDB) set `false`, which routes the MigrationRunner through direct
338
+ * migration-driver execution instead of `Migration.toSQL()`.
339
+ */
340
+ supportsSqlSerialization?: boolean;
333
341
  /**
334
342
  * Return a SQL serializer for this driver's dialect.
335
343
  * Used by Migration.toSQL() to convert pending operations to SQL strings.
@@ -1 +1 @@
1
- {"version":3,"file":"database-driver.contract.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/contracts/database-driver.contract.ts"],"mappings":";;;;;;;;;;;KASY,WAAA;;KAGA,mBAAA,OAA0B,IAAI;;UAGzB,yBAAA;EANM;EAQrB,OAAA,EAAS,QAAA;EALC;EAOV,MAAA,IAAU,OAAA;;EAEV,QAAA,IAAY,OAAA;AAAA;AANd;;;;;;AAAA,UAeiB,kBAAA;EATI;;;;;;;;;AAAA;AASrB;;;;AAmB0B;AAI1B;;;EAJE,QAAA,CAAS,MAAe;AAAA;;KAId,YAAA;EACV,QAAA,EAAU,SAAS;AAAA;AAIrB;AAAA,KAAY,YAAA;EACV,aAAa;AAAA;AAAA;AAaf;;;;;;;;;AAbe,KAaH,cAAA,KAAmB,MAAA;EAEpB,yDAAA,IAAA,EAAM,CAAA,IAEN;EAAA,SAAA,QAAA,iBAIA;EAAA,SAFA,OAAA,WAEkC;EAAA,SAAlC,MAAA,GAAS,aAAA;IAAA,SAAyB,IAAA;IAAA,SAAuB,UAAA;EAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;AAyCpD;AAMhB;;;KAlBY,gBAAA;EA+BU,uBA7BpB,IAAA,GAAO,MAAA,mBAoDkB;EAlDzB,MAAA,GAAS,MAAA,oBA0DK;EAxDd,IAAA,GAAO,MAAA,kBA+DS;EA7DhB,IAAA,GAAO,MAAA,kBAkEW;EAhElB,KAAA,GAAQ,MAAA,mBAuEc;EArEtB,KAAA,GAAQ,MAAA;AAAA;;;;UAMO,cAAA;EAyEZ;;;;;;;EAAA,SAjEM,IAAA,EAAM,cAAA;EAgFJ;;;EAAA,SA3EF,SAAA,EAAW,uBAAA;EAkFR;;;;;;;;;;;;;;;;;;;;;EAAA,SA3DH,aAAA,GAAgB,OAAA,CAAQ,aAAA;EA0ItB;EAAA,SAvIF,WAAA;EAyIN;EAtIH,OAAA,IAAW,OAAA;EA4IC;EA1IZ,UAAA,IAAc,OAAA;EAgKyB;EA9JvC,SAAA,sBAA+B,MAAA;EAiKgC;;;EA5J/D,SAAA,CAAU,IAAA,EAAM,MAAA,oBAA0B,MAAA;EAsLW;;;EAjLrD,WAAA,CAAY,IAAA,EAAM,MAAA,oBAA0B,MAAA;EAgOhC;;;;;EAzNZ,eAAA,CAAgB,IAAA,EAAM,MAAA,oBAA0B,oBAAA;EAkOrC;EA/NX,EAAA,CAAG,KAAA,EAAO,WAAA,EAAa,QAAA,EAAU,mBAAA;EAkOlB;EA/Nf,MAAA,CACE,KAAA,UACA,QAAA,EAAU,MAAA,mBACV,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,YAAA;EA8N+B;EA3N1C,UAAA,CACE,KAAA,UACA,SAAA,EAAW,MAAA,qBACX,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,YAAA;EA2OiF;EAxO5F,MAAA,CACE,KAAA,UACA,MAAA,EAAQ,MAAA,mBACR,MAAA,EAAQ,gBAAA,EACR,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,YAAA;EAmO0D;EAhOrE,UAAA,CACE,KAAA,UACA,MAAA,EAAQ,MAAA,mBACR,MAAA,EAAQ,gBAAA,EACR,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,YAAA;EAmPoD;EAhP/D,OAAA,cACE,KAAA,UACA,MAAA,EAAQ,MAAA,mBACR,QAAA,EAAU,MAAA,mBACV,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,CAAA;EA4PgD;EAzP3D,gBAAA,cACE,KAAA,UACA,MAAA,EAAQ,MAAA,mBACR,MAAA,EAAQ,MAAA,mBACR,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,CAAA;EA2QM;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA7OjB,MAAA,cACE,KAAA,UACA,MAAA,EAAQ,MAAA,mBACR,QAAA,EAAU,MAAA,mBACV,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,CAAA;EApFX;;;;;;;;;;;;;;;;EAsGA,gBAAA,cACE,KAAA,UACA,MAAA,EAAQ,MAAA,mBACR,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,CAAA;EA7FX;EAgGA,MAAA,CACE,KAAA,UACA,MAAA,GAAS,MAAA,mBACT,OAAA,GAAU,MAAA,oBACT,OAAA;EAlGU;EAqGb,UAAA,CACE,KAAA,UACA,MAAA,GAAS,MAAA,mBACT,OAAA,GAAU,MAAA,oBACT,OAAA;EAxGS;;;;;;;;;;;;;;;;;;;EA6HZ,aAAA,CAAc,KAAA,UAAe,OAAA,GAAU,MAAA,oBAA0B,OAAA;EA7GrD;EAgHZ,YAAA,cAA0B,KAAA,WAAgB,oBAAA,CAAqB,CAAA;EA/G5D;;;;;;;;;;;;;;;;;;;;;;;;EAyIH,gBAAA,CAAiB,OAAA,GAAU,MAAA,oBAA0B,OAAA,CAAQ,yBAAA;EA3FtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwIP,WAAA,IACE,EAAA,GAAK,GAAA,EAAK,kBAAA,KAAuB,OAAA,CAAQ,CAAA,GACzC,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,CAAA;EAhDgB;EAmD3B,MAAA,CACE,KAAA,UACA,MAAA,EAAQ,MAAA,mBACR,UAAA,EAAY,gBAAA,EACZ,OAAA,GAAU,MAAA,oBACT,OAAA,CAAQ,YAAA;EAxD0C;EA2DrD,WAAA,IAAe,mBAAA;EAdf;EAiBA,eAAA,IAAmB,uBAAA;EAhBP;;;;EAsBZ,gBAAA,IAN0C,aAAA;EAf9B;;;;;;;;;;;;EAmCZ,KAAA,KAAU,MAAA,mBAAyB,GAAA,UAAa,MAAA,eAAqB,OAAA,CAAQ,cAAA,CAAe,CAAA;EA1BjF;;;;;;;;;;;;;;;;;;EAkDX,cAAA,CAAe,IAAA,UAAc,OAAA,GAAU,qBAAA,GAAwB,OAAA;EAAA;;;;;;;;;;;;;;;EAiB/D,YAAA,CAAa,IAAA,UAAc,OAAA,GAAU,mBAAA,GAAsB,OAAA;EAuD1B;;;;AAeT;AAM1B;;;;;;;;;EA5DE,cAAA,CAAe,IAAA,WAAe,OAAA;EA0EpB;;;;AAIF;EAvER,aAAA,IAAiB,OAAA;;;;;;;;;;;;;EAkBjB,SAAA,CAAU,IAAA,WAAe,OAAA;;;;;;;;;;;;;EAczB,iBAAA,CAAkB,IAAA,WAAe,OAAA;;;;;;;;;;;;;;EAejC,aAAA,IAAiB,OAAA;AAAA;;;;KAMP,qBAAA;2DAEV,QAAA;EAEA,QAAA;EAEA,MAAA;EAEA,KAAA;AAAA;;;;KAMU,mBAAA;wDAEV,KAAA;EAEA,QAAQ;AAAA"}
1
+ {"version":3,"file":"database-driver.contract.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/contracts/database-driver.contract.ts"],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  import { DriverBlueprintContract, TableIndexInformation } from "./driver-blueprint.contract.mjs";
2
2
  import { ColumnDefinition, ColumnType, ForeignKeyDefinition, FullTextIndexOptions, GeoIndexOptions, IndexDefinition, MigrationDriverContract, MigrationDriverFactory, VectorIndexOptions } from "./migration-driver.contract.mjs";
3
- import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, DriverQuery, GroupByInput, HavingInput, JoinOptions, OrderDirection, PaginationOptions, PaginationResult, QueryBuilderContract, RawExpression, WhereCallback, WhereObject, WhereOperator } from "./query-builder.contract.mjs";
3
+ import { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, DriverQuery, GroupByInput, HavingInput, JoinOptions, LockForUpdateOptions, OrderDirection, PaginationOptions, PaginationResult, QueryBuilderContract, RawExpression, WhereCallback, WhereObject, WhereOperator } from "./query-builder.contract.mjs";
4
4
  import { SyncAdapterContract, SyncInstruction } from "./sync-adapter.contract.mjs";
5
5
  import { CreateDatabaseOptions, DriverContract, DriverEvent, DriverEventListener, DriverTransactionContract, DropDatabaseOptions, InsertResult, RawQueryResult, TransactionContext, UpdateOperations, UpdateResult } from "./database-driver.contract.mjs";
6
6
  import { GenerateIdOptions, IdGeneratorContract } from "./database-id-generator.contract.mjs";
@@ -84,6 +84,24 @@ type HavingInput = Record<string, unknown> | [field: string, value: unknown] | [
84
84
  * Raw expression payload for projection/order/group extensions.
85
85
  */
86
86
  type RawExpression = string | Record<string, unknown> | unknown;
87
+ /**
88
+ * Options for `lockForUpdate()` — row-level locking on SELECT.
89
+ *
90
+ * `skipLocked` and `noWait` are mutually exclusive (PostgreSQL grammar).
91
+ */
92
+ type LockForUpdateOptions = {
93
+ /**
94
+ * Skip rows another transaction already holds a lock on instead of waiting
95
+ * (`FOR UPDATE SKIP LOCKED`) — the standard shape for concurrent job-queue
96
+ * claims where each worker should grab different rows.
97
+ */
98
+ skipLocked?: boolean;
99
+ /**
100
+ * Error immediately when a matching row is locked instead of waiting
101
+ * (`FOR UPDATE NOWAIT`).
102
+ */
103
+ noWait?: boolean;
104
+ };
87
105
  /**
88
106
  * Driver-agnostic representation of a parsed query.
89
107
  *
@@ -1309,6 +1327,23 @@ interface QueryBuilderContract<T = unknown> {
1309
1327
  * query.take(5)
1310
1328
  */
1311
1329
  take(value: number): this;
1330
+ /**
1331
+ * Lock the selected rows for update (`SELECT ... FOR UPDATE`), so other
1332
+ * transactions can neither modify nor lock them until this transaction ends.
1333
+ * Only meaningful inside a transaction.
1334
+ *
1335
+ * Postgres-only: the MongoDB driver throws an unsupported error.
1336
+ *
1337
+ * @example
1338
+ * // Concurrent job-queue claim — each worker grabs different rows:
1339
+ * await Job.query()
1340
+ * .where("status", "pending")
1341
+ * .orderBy("id", "asc")
1342
+ * .limit(10)
1343
+ * .lockForUpdate({ skipLocked: true })
1344
+ * .get();
1345
+ */
1346
+ lockForUpdate(options?: LockForUpdateOptions): this;
1312
1347
  /**
1313
1348
  * Apply cursor pagination hints.
1314
1349
  *
@@ -1686,5 +1721,5 @@ interface QueryBuilderContract<T = unknown> {
1686
1721
  similarTo(column: string, embedding: number[], alias?: string): this;
1687
1722
  }
1688
1723
  //#endregion
1689
- export { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, DriverQuery, GroupByInput, HavingInput, JoinOptions, OrderDirection, PaginationOptions, PaginationResult, QueryBuilderContract, RawExpression, WhereCallback, WhereObject, WhereOperator };
1724
+ export { ChunkCallback, CursorPaginationOptions, CursorPaginationResult, DriverQuery, GroupByInput, HavingInput, JoinOptions, LockForUpdateOptions, OrderDirection, PaginationOptions, PaginationResult, QueryBuilderContract, RawExpression, WhereCallback, WhereObject, WhereOperator };
1690
1725
  //# sourceMappingURL=query-builder.contract.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"query-builder.contract.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/contracts/query-builder.contract.ts"],"mappings":";;;;;KAGY,cAAA;AAAZ;;;AAAA,KAKY,WAAA;EALc,kCAOxB,KAAA,UAFqB;EAIrB,UAAA,WAcmB;EAZnB,QAAA,WAFA;EAIA,YAAA;EAEA,IAAA,kDAEA;EAAA,KAAA,WAEU;EAAV,OAAA,GAAU,MAAA,mBAIV;EAFA,MAAA,aAIA;EAFA,UAAA,GAAa,MAAM,mBAEX;EAAR,QAAA;AAAA;;;;KAMU,gBAAA;EACV,IAAA,EAAM,CAAC;EACP,UAAA;IACE,KAAA;IACA,IAAA;IACA,KAAA;IACA,KAAA;EAAA;AAAA;AAOJ;;;AAAA,KAAY,sBAAA;EACV,IAAA,EAAM,CAAC;EACP,UAAA;IACE,OAAA;IACA,OAAA;IACA,UAAA;IACA,UAAA;EAAA;AAAA;;AAAU;AAOd;KAAY,aAAA,OACV,IAAA,EAAM,CAAA,IACN,UAAA,aACG,OAAO;;;;KAKA,uBAAA;EACV,MAAA;EACA,SAAA;EACA,KAAA;EACA,MAAA;AAAA;AAJF;;;AAAA,KAUY,iBAAA;EACV,IAAA;EACA,KAAK;AAAA;;;AARC;KAcI,aAAA;AAAA,KAwBA,WAAA,GAAc,MAAM;;;;KAKpB,aAAA,OAAoB,OAAA,EAAS,oBAAoB,CAAC,CAAA;AAL9D;;;AAAA,KAUY,YAAA,uBAGR,MAAA,oBACA,KAAA,CAAM,MAAA;AAdsB;AAKhC;;AALgC,KAmBpB,WAAA,GACR,MAAA,qBACC,KAAA,UAAe,KAAA,cACf,KAAA,UAAe,QAAA,EAAU,aAAa,EAAE,KAAA;;;;KAKjC,aAAA,YAAyB,MAAM;;;AAtBqB;AAKhE;;;;;;;;;;;;AAIgB;AAKhB;KA2BY,WAAA;wDAEV,KAAA,WA5BE;EA8BF,QAAA,cA7BkB;EA+BlB,QAAA,cA9BkB;EAgClB,MAAA;AAAA;;AAhCgD;AAKlD;;;;AAA2C;UAqC1B,oBAAA;EAlBM;;;EAsBrB,KAAA;EAlBA;;;;EAuBA,OAAA,CAAQ,QAAA,GAAW,IAAA,OAAW,KAAA;EATf;;;;;EAgBf,UAAA,CAAW,QAAA,GAAW,KAAA,kBAAuB,OAAA;EAwBX;;;;;EAjBlC,WAAA,CAAY,QAAA,GAAW,OAAA,SAAgB,OAAA,iBAAwB,OAAA;EA6C1C;;;;;EAtCrB,SAAA,CAAU,QAAA,GAAW,OAAA,SAAgB,OAAA,iBAAwB,OAAA;EA8L/B;;;;EApL9B,mBAAA,GAAsB,GAAA,SAAY,qBAAA;EAqNK;;;;EA/MvC,oBAAA,GAAuB,GAAA,SAAY,kBAAA;EAoPG;;;EA/OtC,oBAAA,GAAuB,GAAA;EA8TN;;;EAzTjB,aAAA;EA4VqB;;;;;;EAhVrB,kBAAA,GAAqB,GAAA,qBAAwB,KAAA,EAAO,oBAAA;EA6WpB;;;;;;;;;;;EAhWhC,cAAA,GAAiB,GAAA;IAukBD,wFAnkBZ,QAAA,UA8kBkB;IA5kBlB,aAAA;EAAA;EA6nBwC;;;;EArnB5C,aAAA,GAAgB,GAAA;IAGZ,KAAA;IACA,IAAA;IACA,KAAA;IACA,QAAA;IACA,UAAA;IACA,QAAA;IACA,UAAA;IACA,YAAA;IACA,WAAA;IACA,MAAA;EAAA;EAo0Be;;;;EA5zBnB,mBAAA,GAAsB,MAAA;EAs9BN;;;EAj9BhB,UAAA;EAymC+C;;;;;;;;;;;;;;;;;;;;;;;;;EA9kC/C,QAAA,IAAY,SAAA;EA05CiB;;;;;;;;;;;;;;;EAz4C7B,kBAAA,IAAsB,UAAA;EA49CqB;;;;;;;;;;;EA/8C3C,mBAAA;EAkiDkB;;;;;;;;;;;;;;;;EAhhDlB,KAAA,CAAM,SAAA,aAAsB,IAAA;EA1LpB;;;;;;;;;;;;;;;;EAgNR,KAAA,CAAM,KAAA,UAAe,KAAA;EACrB,KAAA,CAAM,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAC9C,KAAA,CAAM,UAAA,EAAY,WAAA;EAClB,KAAA,CAAM,QAAA,EAAU,aAAA,CAAc,CAAA;EA9KK;;;;;;;EAuLnC,QAAA,CAAS,UAAA,EAAY,aAAA,EAAe,QAAA;EApJpC;;;;;;EA4JA,UAAA,CAAW,UAAA,EAAY,aAAA,EAAe,QAAA;EA1IlC;;;;;;EAkJJ,WAAA,CAAY,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,MAAA;EA3IhD;;;;;;EAmJJ,aAAA,CAAc,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,MAAA;EAzFtD;;;;;;;;;EAoGA,YAAA,CAAa,WAAA,EAAa,KAAA,EAAO,IAAA,UAAc,QAAA,EAAU,aAAA,EAAe,KAAA;EA9ClE;;;;;;EAsDN,mBAAA,CAAoB,KAAA,UAAe,WAAA,UAAqB,WAAA;EApDxD;;;;;;EA4DA,SAAA,CAAU,KAAA,UAAe,KAAA,EAAO,IAAA;EAnDI;;;EAwDpC,eAAA,CAAgB,KAAA,UAAe,KAAA,EAAO,IAAA;EAhDA;;;EAqDtC,eAAA,CAAgB,KAAA,UAAe,KAAA,EAAO,IAAA;EA7CX;;;EAkD3B,cAAA,CAAe,KAAA,UAAe,KAAA,EAAO,IAAA;EA1CE;;;;;;EAkDvC,SAAA,CAAU,KAAA,UAAe,KAAA;EAvCgC;;;EA4CzD,QAAA,CAAS,KAAA,UAAe,KAAA;EApCJ;;;EAyCpB,UAAA,CAAW,KAAA,UAAe,KAAA;EAjChB;;;EAsCV,SAAA,CAAU,KAAA,UAAe,KAAA;EAjCT;;;EAsChB,iBAAA,CAAkB,IAAA,UAAc,KAAA;EAjChB;;;EAsChB,sBAAA,CAAuB,IAAA,UAAc,KAAA;EAjCtB;;;EAsCf,oBAAA,CAAqB,IAAA;EA9BX;;;;;;EAsCV,eAAA,CAAgB,IAAA,UAAc,QAAA,EAAU,aAAA,EAAe,KAAA;EA5B7B;;;EAiC1B,gBAAA,CAAiB,IAAA;EAvBjB;;;EA4BA,iBAAA,CAAkB,IAAA;EAvBK;;;;;;EA+BvB,gBAAA,CAAiB,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAlB3B;;;EAuB9B,OAAA,CAAQ,KAAA;EAbR;;;EAkBA,QAAA,CAAS,MAAA,EAAQ,KAAA;EAVyB;;;EAe1C,SAAA,CAAU,KAAA;EAVF;;;EAeR,SAAA,CAAU,KAAA;EALV;;;EAUA,aAAA,CAAc,MAAA,qBAA2B,KAAA;EAAzC;;;EAKA,eAAA,CAAgB,MAAA,qBAA2B,KAAA;EAA3B;;;EAKhB,WAAA,CAAY,KAAA,UAAe,KAAA;EAAA;;;EAK3B,QAAA,CAAS,QAAA,EAAU,aAAA,CAAc,CAAA;EAAxB;;;EAKT,UAAA,CAAW,QAAA,EAAU,aAAA,CAAc,CAAA;EAAxB;;;;;;;EASX,WAAA,CAAY,QAAA,EAAU,aAAA,CAAc,CAAA;EASrB;;;;;;;EAAf,cAAA,CAAe,QAAA,EAAU,aAAA,CAAc,CAAA;EASS;;;;;;EADhD,OAAA,CAAQ,KAAA,UAAe,KAAA;EACvB,OAAA,CAAQ,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAChD,OAAA,CAAQ,UAAA,EAAY,WAAA;EACpB,OAAA,CAAQ,QAAA,EAAU,aAAA,CAAc,CAAA;EAQT;;;;;;EAAvB,OAAA,CAAQ,KAAA,UAAe,MAAA;EAwBV;;;;;;EAhBb,UAAA,CAAW,KAAA,UAAe,MAAA;EAwC1B;;;;;;EAhCA,SAAA,CAAU,KAAA;EAgDV;;;;;;EAxCA,YAAA,CAAa,KAAA;EAwDC;;;;;;EAhDd,YAAA,CAAa,KAAA,UAAe,KAAA;EAgEY;;;;;;EAxDxC,eAAA,CAAgB,KAAA,UAAe,KAAA;EAgEI;;;;;;EAxDnC,SAAA,CAAU,KAAA,UAAe,OAAA,EAAS,MAAA;EAoFT;;;;;;EA5EzB,YAAA,CAAa,KAAA,UAAe,OAAA;EAqFQ;;;;;;EA7EpC,eAAA,CAAgB,KAAA,UAAe,KAAA;EAkGT;;;;;;EA1FtB,kBAAA,CAAmB,KAAA,UAAe,KAAA;EA0GlC;;;;;;EAlGA,aAAA,CAAc,KAAA,UAAe,KAAA;EA+Gd;;;;;;EAvGf,gBAAA,CAAiB,KAAA,UAAe,KAAA;EAyGhB;;;;;;EAjGhB,gBAAA,CAAiB,KAAA,UAAe,KAAA,GAAQ,IAAA,EAAM,IAAA;EAiHT;;;;;;EAzGrC,mBAAA,CAAoB,KAAA,UAAe,KAAA,GAAQ,IAAA,EAAM,IAAA;EAqH/C;;;;;;EA7GF,WAAA,CAAY,KAAA;EA+HC;;;;;;EAvHb,cAAA,CAAe,KAAA;EA2IF;;;;;;;;;;EA/Hb,SAAA,CAAU,KAAA,UAAe,IAAA;EACzB,SAAA,CAAU,KAAA,UAAe,QAAA,iCAAyC,IAAA;EAuJrD;;;;;;EA/Ib,UAAA,CAAW,KAAA,UAAe,OAAA,GAAU,WAAA;EA2JlC;;;;;;;;;;;EA9IF,kBAAA,CAAmB,KAAA,UAAe,KAAA,WAAgB,GAAA;EA2KpC;;;;;;EAnKd,qBAAA,CAAsB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAgLhC;;;;;;EAxKrB,oBAAA,CAAqB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAgLrC;;;;;;EAxKf,wBAAA,CAAyB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAiMxD;;;;;;EArLA,MAAA,CAAO,MAAA;EACP,MAAA,CAAO,MAAA,EAAQ,MAAA;EACf,MAAA,IAAU,MAAA,EAAQ,KAAA;EAClB,MAAA,IAAU,IAAA,EAAM,KAAA;EA+OwB;;;;;;EAvOxC,QAAA,CAAS,KAAA,UAAe,KAAA;EA8PoB;;;;;;EAtP5C,SAAA,CAAU,UAAA,EAAY,aAAA,EAAe,QAAA;EA6QQ;;;;;;;;;EAlQ7C,aAAA,CACE,WAAA,EAAa,KAAA;IACX,KAAA;IACA,UAAA,EAAY,aAAA;IACZ,QAAA;EAAA;EA2SwC;;;;;;EAjS5C,SAAA,CAAU,UAAA,EAAY,aAAA,EAAe,KAAA;EAoVjB;;;EA/UpB,YAAA,CAAa,UAAA,EAAY,aAAA,EAAe,KAAA;EA2WnC;;;;;;EAnWL,eAAA,CACE,KAAA,UACA,SAAA,8DACA,KAAA;EA+XqB;;;;;;EAtXvB,YAAA,CAAa,KAAA,UAAe,KAAA;EAialB;;;;;;EAzZV,WAAA,CAAY,KAAA,UAAe,KAAA;EAid0B;;;;;;;;;;;;;EAlcrD,UAAA,CACE,KAAA,EAAO,KAAA;IAAQ,IAAA,EAAM,aAAA;IAAe,IAAA,EAAM,aAAA;EAAA,IAC1C,SAAA,EAAW,aAAA,YACX,KAAA;EA2gBsC;;;;;;EAlgBxC,UAAA,CACE,SAAA,EAAW,aAAA,EACX,SAAA,EAAW,aAAA,YACX,SAAA,EAAW,aAAA,YACX,KAAA;EA+hB2C;;;;;;;;EAphB7C,sBAAA,CAAuB,QAAA,GAAW,UAAA,EAAY,MAAA;EAkiBtC;;;;;;EA1hBR,UAAA,CAAW,IAAA,UAAc,KAAA;EAkjBzB;;;;;;EA1iBA,aAAA,CAAc,IAAA,UAAc,UAAA,EAAY,aAAA,EAAe,KAAA;EA6jBhD;;;EAxjBP,YAAA,CAAa,IAAA;EA4kBR;;;;;;EApkBL,YAAA,CAAa,MAAA,EAAQ,KAAA,UAAe,aAAA,GAAgB,KAAA;EA4lB5B;;;;;;EAplBxB,cAAA,CAAe,MAAA,EAAQ,KAAA,UAAe,aAAA,GAAgB,KAAA;EAsoBZ;;;;;;;;;;EA1nB1C,YAAA,CAAa,IAAA,EAAM,aAAA;EAkqBR;;;;;;EA1pBX,QAAA,CAAS,MAAA;EAmqBuB;;;EA9pBhC,WAAA;EA+pBkB;;;EA1pBlB,SAAA;EAkqBU;;;EA7pBV,aAAA;EA8qBK;;;;;;;EArqBL,cAAA,CAAe,MAAA;EA4rBmC;;;;;;EAprBlD,SAAA,CAAU,MAAA;EA+sBG;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA7qBb,IAAA,CAAK,KAAA,UAAe,UAAA,UAAoB,YAAA;EACxC,IAAA,CAAK,OAAA,EAAS,WAAA;EA4tBL;;;;;;;;;;;;;;;;;;;;EAtsBT,QAAA,CAAS,KAAA,UAAe,UAAA,UAAoB,YAAA;EAC5C,QAAA,CAAS,OAAA,EAAS,WAAA;EA+vBZ;;;;;;;;;;;;;;;;;;;;EAzuBN,SAAA,CAAU,KAAA,UAAe,UAAA,UAAoB,YAAA;EAC7C,SAAA,CAAU,OAAA,EAAS,WAAA;EA0xB4B;;;;;;;;;;;;;;;;;;;;EApwB/C,SAAA,CAAU,KAAA,UAAe,UAAA,UAAoB,YAAA;EAC7C,SAAA,CAAU,OAAA,EAAS,WAAA;EA6yB8D;;;;;;;;;;;AAiEpB;;;;;;;;EAz1B7D,QAAA,CAAS,KAAA,UAAe,UAAA,UAAoB,YAAA;EAC5C,QAAA,CAAS,OAAA,EAAS,WAAA;;;;;;;;;;;;;;;;;;;EAoBlB,SAAA,CAAU,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8BV,OAAA,CAAQ,UAAA,EAAY,aAAA,EAAe,QAAA;;;;;;;;;;;;;;;;;;;;;;;EA4BnC,IAAA,CAAK,QAAA;;;;;;;EAQL,IAAA,IAAQ,SAAA;;;;;;;;;;;;;;;;;;;;;;EAuBR,IAAA,CAAK,QAAA,UAAkB,UAAA,GAAa,KAAA,EAAO,oBAAA;;;;;;;;;;;;;;;;;;;;;;EAuB3C,IAAA,CAAK,SAAA,EAAW,MAAA,qBAA2B,KAAA,EAAO,oBAAA;;;;;;;;;;;;;;;;;;;EAoBlD,SAAA,CAAU,QAAA;;;;;;;;;;;;;;EAeV,SAAA,IAAa,SAAA;;;;;;;;;;;EAYb,SAAA,CAAU,SAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BV,SAAA,CACE,SAAA,EAAW,MAAA,2BAAiC,KAAA,EAAO,oBAAA;;;;;;;;;;;;;EAerD,GAAA,CAAI,QAAA;;;;;;;;;;;;;;;;;;EAmBJ,GAAA,CAAI,QAAA,UAAkB,QAAA,UAAkB,KAAA;;;;;;;;;;;;;;;;;;;;;;;;;EA0BxC,QAAA,CAAS,QAAA,UAAkB,QAAA,GAAW,KAAA,EAAO,oBAAA;;;;;;;;;;;;;;;EAgB7C,UAAA,CAAW,QAAA,UAAkB,QAAA,GAAW,KAAA,EAAO,oBAAA;;;;;;;;;;;;;EAc/C,UAAA,CAAW,QAAA;;;;;;;;;;;;;;;;;;EAmBX,eAAA,CAAgB,QAAA,UAAkB,QAAA,GAAW,KAAA,EAAO,oBAAA;;;;;;;;EAapD,OAAA,CAAQ,KAAA,UAAe,SAAA,GAAY,cAAA;EACnC,OAAA,CAAQ,MAAA,EAAQ,MAAA,SAAe,cAAA;;;;;;;EAQ/B,WAAA,CAAY,KAAA;;;;;;;EAQZ,UAAA,CAAW,UAAA,EAAY,aAAA,EAAe,QAAA;;;;;;;EAQtC,aAAA,CAAc,KAAA;;;;;;;;;EAUd,MAAA,CAAO,MAAA,YAAkB,OAAA,CAAQ,CAAA;;;;;;;;EASjC,MAAA,CAAO,MAAA;;;;;;;EAYP,KAAA,CAAM,KAAA;;;;;;;EAQN,IAAA,CAAK,KAAA;;;;;;;EAQL,MAAA,CAAO,KAAA;;;;;;;EAQP,IAAA,CAAK,KAAA;;;;;;;EAQL,MAAA,CAAO,KAAA,YAAiB,MAAA;;;;;;;;EAaxB,OAAA,CAAQ,MAAA,EAAQ,YAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqChB,OAAA,CAAQ,MAAA,EAAQ,YAAA,EAAc,UAAA,EAAY,MAAA,SAAe,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4BzD,WAAA,CACE,MAAA,UACA,IAAA,qCACA,UAAA,GAAa,MAAA,SAAe,aAAA;;;;;;;EAS9B,UAAA,CAAW,UAAA,EAAY,aAAA,EAAe,QAAA;;;;;;;EAQtC,MAAA,CAAO,KAAA,UAAe,KAAA;EACtB,MAAA,CAAO,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAC/C,MAAA,CAAO,SAAA,EAAW,WAAA;;;;;;;EAQlB,SAAA,CAAU,UAAA,EAAY,aAAA,EAAe,QAAA;;;;;;;;;;;;EAiBrC,IAAA,CAAK,OAAA,EAAS,WAAA;;;;;;;;;;EAed,GAAA,CAAI,OAAA,GAAU,MAAA;;;;;;;EAQd,MAAA,IAAU,SAAA,aAAsB,IAAA,cAAkB,CAAA;;;;;;;;EASlD,KAAA;;;;;;;;EASA,GAAA,CAAI,QAAA,GAAW,OAAA;;;;;;;EAQf,IAAA,IACE,SAAA,EAAW,CAAA,8BACX,QAAA,GAAW,OAAA,QAAe,KAAA,EAAO,CAAA,WACjC,SAAA,IAAa,OAAA;;;;;;;EAaf,GAAA,UAAa,CAAA,KAAM,OAAA,CAAQ,MAAA;;;;;;;EAQ3B,KAAA,UAAe,CAAA,KAAM,OAAA,CAAQ,MAAA;;;;;;;;EAS7B,WAAA,UAAqB,CAAA,KAAM,OAAA,CAAQ,MAAA;;;;;;;EAQnC,IAAA,UAAc,CAAA,EAAG,KAAA,YAAiB,OAAA,CAAQ,MAAA;;;;;;;EAQ1C,KAAA,IAAS,OAAA;;;;;;;EAQT,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;EAQpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;EAQpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;EAQpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;;;;EAUpB,QAAA,cAAsB,KAAA,WAAgB,OAAA,CAAQ,CAAA;;;;;;;EAQ9C,KAAA,CAAM,KAAA,WAAgB,OAAA;;;;;;;EAQtB,KAAA,cAAmB,KAAA,WAAgB,OAAA,CAAQ,CAAA;;;;;;;EAQ3C,MAAA,IAAU,OAAA;;;;;;;EAQV,SAAA,IAAa,OAAA;;;;;;;EAQb,aAAA,CAAc,KAAA,WAAgB,OAAA;;;;;;;;EAS9B,SAAA,CAAU,KAAA,UAAe,MAAA,YAAkB,OAAA;;;;;;;;EAS3C,SAAA,CAAU,KAAA,UAAe,MAAA,YAAkB,OAAA;;;;;;;EAQ3C,aAAA,CAAc,KAAA,UAAe,MAAA,YAAkB,OAAA;;;;;;;EAQ/C,aAAA,CAAc,KAAA,UAAe,MAAA,YAAkB,OAAA;;;;;;;;;;;EAgB/C,KAAA,CAAM,IAAA,UAAc,QAAA,EAAU,aAAA,CAAc,CAAA,IAAK,OAAA;;;;;;;;EASjD,QAAA,CAAS,OAAA,EAAS,iBAAA,GAAoB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;;;;;;;;EAS/D,cAAA,CAAe,OAAA,EAAS,uBAAA,GAA0B,OAAA,CAAQ,sBAAA,CAAuB,CAAA;;;;;;;;;;;;;;;EAoBjF,KAAA,IAAS,WAAA;;;;;EAMT,MAAA;;;;;;;EAQA,OAAA,IAAW,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+BX,SAAA,CAAU,MAAA,UAAgB,SAAA,YAAqB,KAAA;AAAA"}
1
+ {"version":3,"file":"query-builder.contract.d.mts","names":[],"sources":["../../../../../../../@warlock.js/cascade/src/contracts/query-builder.contract.ts"],"mappings":"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"}
@@ -269,6 +269,11 @@ declare class MongoDbDriver implements DriverContract {
269
269
  * Attach the active transaction session (when available) to Mongo options.
270
270
  */
271
271
  private withSession;
272
+ /**
273
+ * MongoDB has no SQL dialect — the MigrationRunner executes migrations
274
+ * through the migration driver directly instead of Migration.toSQL().
275
+ */
276
+ readonly supportsSqlSerialization = false;
272
277
  /**
273
278
  * Return a SQL serializer for this driver's dialect.
274
279
  * Not supported for MongoDB.
@@ -1 +1 @@
1
- {"version":3,"file":"mongodb-driver.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-driver.ts"],"mappings":"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"}
1
+ {"version":3,"file":"mongodb-driver.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-driver.ts"],"mappings":"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"}
@@ -481,7 +481,10 @@ var MongoDbDriver = class {
481
481
  * @throws {Error} If transaction fails, is explicitly rolled back, or replica set not configured
482
482
  */
483
483
  async transaction(fn, options) {
484
- if (databaseTransactionContext.hasActiveTransaction()) throw new Error("Nested transaction() calls are not supported. Use beginTransaction() with savepoints for advanced transaction patterns.");
484
+ const ctx = { rollback(reason) {
485
+ throw new TransactionRollbackError(reason);
486
+ } };
487
+ if (databaseTransactionContext.hasActiveTransaction()) return fn(ctx);
485
488
  await this.ensureReplicaSetAvailable();
486
489
  const session = this.getClientInstance().startSession();
487
490
  try {
@@ -491,9 +494,7 @@ var MongoDbDriver = class {
491
494
  });
492
495
  databaseTransactionContext.enter({ session });
493
496
  try {
494
- const result = await fn({ rollback(reason) {
495
- throw new TransactionRollbackError(reason);
496
- } });
497
+ const result = await fn(ctx);
497
498
  await session.commitTransaction();
498
499
  return result;
499
500
  } catch (error) {
@@ -604,6 +605,11 @@ var MongoDbDriver = class {
604
605
  return baseOptions;
605
606
  }
606
607
  /**
608
+ * MongoDB has no SQL dialect — the MigrationRunner executes migrations
609
+ * through the migration driver directly instead of Migration.toSQL().
610
+ */
611
+ supportsSqlSerialization = false;
612
+ /**
607
613
  * Return a SQL serializer for this driver's dialect.
608
614
  * Not supported for MongoDB.
609
615
  */
@@ -1 +1 @@
1
- {"version":3,"file":"mongodb-driver.mjs","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-driver.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { log } from \"@warlock.js/logger\";\nimport type {\n BulkWriteOptions,\n ClientSession,\n Db,\n DeleteOptions,\n FindOneAndDeleteOptions,\n FindOneAndUpdateOptions,\n InsertManyResult,\n InsertOneOptions,\n MongoClient,\n MongoClientOptions,\n TransactionOptions,\n UpdateFilter,\n UpdateOptions,\n} from \"mongodb\";\nimport { EventEmitter } from \"node:events\";\nimport { databaseTransactionContext } from \"../../context/database-transaction-context\";\nimport type {\n DriverBlueprintContract,\n DriverContract,\n DriverEvent,\n DriverEventListener,\n DriverTransactionContract,\n IdGeneratorContract,\n InsertResult,\n MigrationDriverContract,\n QueryBuilderContract,\n RawQueryResult,\n SyncAdapterContract,\n TransactionContext,\n UpdateOperations,\n UpdateResult,\n} from \"../../contracts\";\nimport { dataSourceRegistry } from \"../../data-source/data-source-registry\";\nimport { DatabaseDirtyTracker } from \"../../database-dirty-tracker\";\nimport { TransactionRollbackError } from \"../../errors/transaction-rollback.error\";\nimport { type SQLSerializer } from \"../../migration/sql-serializer\";\nimport type { ModelDefaults } from \"../../types\";\nimport { isValidDateValue } from \"../../utils/is-valid-date-value\";\nimport { MongoDBBlueprint } from \"./mongodb-blueprint\";\nimport { MongoIdGenerator } from \"./mongodb-id-generator\";\nimport { MongoMigrationDriver } from \"./mongodb-migration-driver\";\nimport { MongoQueryBuilder } from \"./mongodb-query-builder\";\nimport { MongoSyncAdapter } from \"./mongodb-sync-adapter\";\nimport type { MongoDriverOptions } from \"./types\";\n\nconst DEFAULT_TRANSACTION_OPTIONS: TransactionOptions = {\n readPreference: \"primary\",\n readConcern: { level: \"local\" },\n writeConcern: { w: \"majority\" },\n};\n\n// ============================================================\n// Lazy-loaded MongoDB SDK Types\n// ============================================================\n\n/**\n * Cached MongoDB module (loaded once, reused)\n */\nlet MongoDBClient: typeof import(\"mongodb\");\n\nlet ObjectId: typeof import(\"mongodb\").ObjectId;\n\nlet isModuleExists: boolean | null = null;\n\nlet loadingPromise: Promise<any>;\n\n/**\n * Installation instructions for MongoDB package\n */\nconst MONGODB_INSTALL_INSTRUCTIONS = `\nMongoDB driver requires the mongodb package.\nInstall it with:\n\n npm install mongodb\n\nOr with your preferred package manager:\n\n pnpm add mongodb\n yarn add mongodb\n`.trim();\n\n/**\n * Load MongoDB module\n */\nasync function loadMongoDB() {\n try {\n loadingPromise = import(\"mongodb\");\n MongoDBClient = await loadingPromise;\n ObjectId = MongoDBClient.ObjectId;\n isModuleExists = true;\n } catch {\n isModuleExists = false;\n }\n}\n\nloadMongoDB();\n\nexport function isMongoDBDriverLoaded() {\n return isModuleExists;\n}\n\nasync function assertModuleIsLoaded() {\n if (isModuleExists === false) {\n throw new Error(MONGODB_INSTALL_INSTRUCTIONS);\n }\n\n if (isModuleExists === null) {\n await loadingPromise;\n\n return await assertModuleIsLoaded();\n }\n}\n\n/**\n * MongoDB driver implementation that fulfils the Cascade driver contract.\n *\n * It encapsulates the native Mongo client, exposes lifecycle events, and\n * provides helpers for CRUD, transactions, atomic updates, and sync adapters.\n */\nexport class MongoDbDriver implements DriverContract {\n private readonly events = new EventEmitter();\n public client?: MongoClient;\n public database?: Db;\n private connected = false;\n private syncAdapterInstance?: MongoSyncAdapter;\n private migrationDriverInstance?: MigrationDriverContract;\n private readonly transactionOptions: TransactionOptions;\n private idGeneratorInstance?: IdGeneratorContract;\n private _blueprint?: DriverBlueprintContract;\n\n public get blueprint(): DriverBlueprintContract {\n if (!this._blueprint) {\n this._blueprint = new MongoDBBlueprint(this.database!);\n }\n\n return this._blueprint!;\n }\n\n /**\n * The name of this driver.\n */\n public readonly name = \"mongodb\";\n\n /**\n * Current database name\n */\n protected _databaseName?: string;\n\n /**\n * MongoDB driver model defaults.\n *\n * MongoDB follows NoSQL conventions:\n * - camelCase naming for fields (createdAt, updatedAt, deletedAt)\n * - Manual ID generation (auto-increment id field separate from _id)\n * - Timestamps enabled by default\n * - Trash delete strategy with per-collection trash tables\n */\n public readonly modelDefaults: Partial<ModelDefaults> = {\n namingConvention: \"camelCase\",\n createdAtColumn: \"createdAt\",\n updatedAtColumn: \"updatedAt\",\n deletedAtColumn: \"deletedAt\",\n timestamps: true,\n autoGenerateId: true, // MongoDB needs manual ID generation\n strictMode: \"strip\",\n deleteStrategy: \"trash\",\n trashTable: (table) => `${table}Trash`, // Per-collection trash (usersTrash, productsTrash)\n };\n\n /**\n * Create a new MongoDB driver using the supplied connection options.\n *\n * @param config - Connection configuration\n * @param driverOptions - Driver-specific options\n */\n public constructor(\n private readonly config: {\n database: string;\n uri?: string;\n host?: string;\n port?: number;\n username?: string;\n password?: string;\n authSource?: string;\n logging?: boolean;\n clientOptions?: MongoClientOptions;\n },\n private readonly driverOptions?: MongoDriverOptions,\n ) {\n this.transactionOptions = {\n ...DEFAULT_TRANSACTION_OPTIONS,\n ...driverOptions?.transactionOptions,\n };\n }\n\n /**\n * Get data base name\n */\n public get databaseName(): string | undefined {\n if (!this._databaseName) {\n this.resolveDatabaseName();\n }\n\n return this._databaseName;\n }\n\n /**\n * Resolve database name either from config or uri\n */\n private resolveDatabaseName() {\n if (this.config.database) {\n this._databaseName = this.config.database;\n } else if (this.config.uri) {\n this._databaseName = this.config.uri.split(\"/\").pop()?.split(\"?\")?.[0];\n }\n }\n\n /**\n * Indicates whether the driver currently maintains an active connection.\n */\n public get isConnected(): boolean {\n return this.connected;\n }\n\n /**\n * Get the MongoDB database instance.\n *\n * @returns The MongoDB Db instance\n * @throws {Error} If not connected\n *\n * @example\n * ```typescript\n * const db = driver.getDatabase();\n * const collection = db.collection(\"users\");\n * ```\n */\n public getDatabase(): Db {\n if (!this.database) {\n throw new Error(\n \"Database not available. Ensure the driver is connected before accessing the database.\",\n );\n }\n return this.database;\n }\n\n /**\n * Get the ID generator instance for this driver.\n *\n * Creates a MongoIdGenerator on first access if autoGenerateId is enabled.\n *\n * @returns The ID generator instance, or undefined if disabled\n *\n * @example\n * ```typescript\n * const idGenerator = driver.getIdGenerator();\n * if (idGenerator) {\n * const id = await idGenerator.generateNextId({ table: \"users\" });\n * }\n * ```\n */\n public getIdGenerator(): IdGeneratorContract | undefined {\n // Return undefined if ID generation is disabled\n if (this.driverOptions?.autoGenerateId === false) {\n return undefined;\n }\n\n // Create ID generator lazily on first access\n if (!this.idGeneratorInstance) {\n this.idGeneratorInstance = new MongoIdGenerator(this, this.driverOptions?.counterCollection);\n }\n\n return this.idGeneratorInstance;\n }\n\n /**\n * Establish a MongoDB connection using the configured options.\n * Throws if the connection attempt fails.\n */\n public async connect(): Promise<void> {\n if (this.connected) {\n return;\n }\n\n await assertModuleIsLoaded();\n\n const uri = this.resolveUri();\n\n const { MongoClient, ObjectId: ObjectIdMongoDB } = MongoDBClient;\n\n ObjectId = ObjectIdMongoDB;\n\n const client = new MongoClient(uri, this.buildClientOptions());\n\n try {\n log.info(\n \"database.mongodb\",\n \"connection\",\n `Connecting to database ${colors.bold(colors.yellowBright(this.databaseName))}`,\n );\n await client.connect();\n this.client = client;\n this.database = client.db(this.databaseName);\n\n this.connected = true;\n log.success(\"database.mongodb\", \"connection\", \"Connected to database\");\n\n client.on(\"close\", () => {\n if (this.connected) {\n this.connected = false;\n this.emit(\"disconnected\");\n log.warn(\"database.mongodb\", \"connection\", \"Disconnected from database\");\n }\n });\n\n if (this.config.logging) {\n const ignoredCommands = [\"isMaster\", \"hello\", \"ping\", \"saslStart\", \"saslContinue\"];\n\n client.on(\"commandStarted\", (event: any) => {\n if (ignoredCommands.includes(event.commandName)) return;\n\n let cmdStr = JSON.stringify(event.command);\n if (cmdStr.length > 300) {\n cmdStr = cmdStr.substring(0, 300) + \"...\";\n }\n\n log.info({\n module: \"database.mongodb\",\n action: \"query.executing\",\n message: `[${event.commandName}] ${cmdStr}`,\n context: { command: event.command },\n });\n });\n\n client.on(\"commandSucceeded\", (event: any) => {\n if (ignoredCommands.includes(event.commandName)) return;\n\n log.success({\n module: \"database.mongodb\",\n action: \"query.executed\",\n message: `[${event.duration.toFixed(2)}ms] [${event.commandName}]`,\n });\n });\n\n client.on(\"commandFailed\", (event: any) => {\n if (ignoredCommands.includes(event.commandName)) return;\n\n log.error({\n module: \"database.mongodb\",\n action: \"query.error\",\n message: `[${event.duration.toFixed(2)}ms] [${event.commandName}]`,\n context: { failure: event.failure },\n });\n });\n }\n\n this.emit(\"connected\");\n } catch (error: any) {\n await client.close().catch(() => undefined);\n this.emit(\"disconnected\");\n // Boot-time database connection failure is unrecoverable in every\n // realistic caller (app boot, CLI migrations, workers) — `fatal` makes\n // \"page on fatal only\" alerting clean. Per-query failures stay at error.\n log.fatal(\n \"database.mongodb\",\n \"connection\",\n `Failed to connect to database: ${error.message}`,\n );\n throw error;\n }\n }\n\n /**\n * Close the underlying MongoDB connection.\n */\n public async disconnect(): Promise<void> {\n if (!this.client) {\n return;\n }\n\n try {\n await this.client.close();\n } finally {\n this.connected = false;\n this.emit(\"disconnected\");\n }\n }\n\n /**\n * Subscribe to driver lifecycle events.\n */\n public on(event: DriverEvent, listener: DriverEventListener): void {\n this.events.on(event, listener);\n }\n\n /**\n * Insert a single document into the given collection.\n */\n public async insert(\n table: string,\n document: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<InsertResult> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<InsertOneOptions>(options);\n const result = await collection.insertOne(document, mongoOptions);\n\n return {\n document: {\n ...document,\n _id: result.insertedId,\n },\n };\n }\n\n /**\n * Insert multiple documents into the given collection.\n */\n public async insertMany(\n table: string,\n documents: Record<string, unknown>[],\n options?: Record<string, unknown>,\n ): Promise<InsertResult[]> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<BulkWriteOptions>(options);\n const result: InsertManyResult<Record<string, unknown>> = await collection.insertMany(\n documents,\n mongoOptions,\n );\n\n return documents.map((document, index) => {\n const insertedId = result.insertedIds[index as unknown as keyof typeof result.insertedIds];\n\n return {\n document: {\n ...document,\n _id: insertedId,\n },\n };\n });\n }\n\n /**\n * Update a single document that matches the provided filter.\n */\n public async update(\n table: string,\n filter: Record<string, unknown>,\n update: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<UpdateResult> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<UpdateOptions>(options);\n const result = await collection.updateOne(\n filter,\n update as UpdateFilter<Record<string, unknown>>,\n mongoOptions,\n );\n\n return { modifiedCount: result.modifiedCount };\n }\n\n /**\n * Replace a single document that matches the provided filter.\n */\n public async replace<T = unknown>(\n table: string,\n filter: Record<string, unknown>,\n document: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<T | null> {\n const collection = this.getDatabaseInstance().collection(table);\n const result = await collection.findOneAndReplace(filter, document as Record<string, unknown>);\n\n return result?.value as T | null;\n }\n\n /**\n * Find one and update a single document that matches the provided filter and return the updated document\n */\n public async findOneAndUpdate<T = unknown>(\n table: string,\n filter: Record<string, unknown>,\n update: UpdateOperations,\n options?: Record<string, unknown>,\n ): Promise<T | null> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<FindOneAndUpdateOptions>(options);\n const result = await collection.findOneAndUpdate(filter, update as Record<string, unknown>, {\n returnDocument: \"after\",\n ...mongoOptions,\n });\n\n return result as T | null;\n }\n\n /**\n * Upsert (insert or update) a single document.\n *\n * Uses MongoDB's findOneAndUpdate with upsert option.\n *\n * @param table - Target collection name\n * @param filter - Filter conditions to find existing document\n * @param document - Document data to insert or update\n * @param options - Optional upsert options\n * @returns The upserted document\n */\n public async upsert<T = unknown>(\n table: string,\n filter: Record<string, unknown>,\n document: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<T> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<FindOneAndUpdateOptions>(options);\n\n // Use $set to update all fields from document\n const update = { $set: document };\n\n const result = await collection.findOneAndUpdate(filter, update, {\n upsert: true,\n returnDocument: \"after\",\n ...mongoOptions,\n });\n\n return result as T;\n }\n\n /**\n * Find one and delete a single document that matches the provided filter and return the deleted document.\n *\n * @param table - Target collection name\n * @param filter - Filter conditions\n * @param options - Optional delete options\n * @returns The deleted document or null if not found\n */\n public async findOneAndDelete<T = unknown>(\n table: string,\n filter: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<T | null> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<FindOneAndDeleteOptions>(options);\n\n const result = await collection.findOneAndDelete(filter, mongoOptions || {});\n\n return result as T | null;\n }\n\n /**\n * Update multiple documents that match the provided filter.\n */\n public async updateMany(\n table: string,\n filter: Record<string, unknown>,\n update: UpdateOperations,\n options?: Record<string, unknown>,\n ): Promise<UpdateResult> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<UpdateOptions>(options);\n const result = await collection.updateMany(\n filter,\n update as UpdateFilter<Record<string, unknown>>,\n mongoOptions,\n );\n\n return { modifiedCount: result.modifiedCount };\n }\n\n /**\n * Delete a single document that matches the provided filter.\n */\n public async delete(\n table: string,\n filter: Record<string, unknown> = {},\n options?: Record<string, unknown>,\n ): Promise<number> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<DeleteOptions>(options);\n const result = await collection.deleteOne(filter, mongoOptions);\n\n return result.deletedCount > 0 ? 1 : 0;\n }\n\n /**\n * Delete documents that match the provided filter.\n */\n public async deleteMany(\n table: string,\n filter: Record<string, unknown> = {},\n options?: Record<string, unknown>,\n ): Promise<number> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<DeleteOptions>(options);\n\n const result = await collection.deleteMany(filter, mongoOptions);\n\n return result.deletedCount ?? 0;\n }\n\n /**\n * Remove all records from a collection.\n *\n * This uses deleteMany with an empty filter to remove all documents.\n * For very large collections, consider using the migration driver's\n * dropTable + createTable approach for better performance.\n */\n public async truncateTable(table: string, options?: Record<string, unknown>): Promise<number> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<DeleteOptions>(options);\n const result = await collection.deleteMany({}, mongoOptions);\n\n return result.deletedCount ?? 0;\n }\n\n /**\n * Serialize the given data\n */\n public serialize(data: Record<string, unknown>): Record<string, unknown> {\n const serialized: Record<string, unknown> = {};\n\n for (const [key, value] of Object.entries(data)) {\n if (value === undefined) {\n continue; // Skip undefined values\n }\n\n if (value instanceof ObjectId) {\n serialized[key] = value.toString();\n } else if (value instanceof Date) {\n serialized[key] = value.toISOString();\n } else if (typeof value === \"bigint\") {\n serialized[key] = value.toString();\n } else if (typeof value === \"object\" && value !== null && !Array.isArray(value)) {\n // Nested objects will be stored as JSONB\n serialized[key] = value;\n } else {\n serialized[key] = value;\n }\n }\n\n return serialized;\n }\n\n /**\n * Get the dirty tracker for this driver.\n */\n public getDirtyTracker(data: Record<string, unknown>): DatabaseDirtyTracker {\n return new DatabaseDirtyTracker(data);\n }\n\n /**\n * Deserialize the given data\n */\n public deserialize(data: Record<string, unknown>): Record<string, unknown> {\n if (data._id && typeof data._id === \"string\") {\n data._id = new ObjectId(data._id);\n }\n\n for (const [key, value] of Object.entries(data)) {\n // Only re-inflate strings — Mongo driver already returns Date objects from DB reads\n if (typeof value === \"string\" && isValidDateValue(value)) {\n data[key] = new Date(value);\n }\n }\n\n return data;\n }\n\n /**\n * Provide a Mongo-backed query builder instance for the given collection.\n */\n public queryBuilder<T = unknown>(table: string): QueryBuilderContract<T> {\n return new MongoQueryBuilder(table, dataSourceRegistry.get());\n }\n\n /**\n * Begin a MongoDB transaction, returning commit/rollback helpers.\n */\n public async beginTransaction(): Promise<DriverTransactionContract<ClientSession>> {\n const client = this.getClientInstance();\n const session = client.startSession();\n\n await session.startTransaction(this.transactionOptions);\n databaseTransactionContext.enter({ session });\n let finished = false;\n\n const finalize = async (operation: () => Promise<void>): Promise<void> => {\n if (finished) return;\n\n try {\n await operation();\n } finally {\n finished = true;\n databaseTransactionContext.exit();\n await session.endSession().catch(() => undefined);\n }\n };\n\n return {\n context: session,\n commit: async () => {\n await finalize(async () => {\n try {\n await session.commitTransaction();\n } catch (error) {\n await session.abortTransaction().catch(() => undefined);\n throw error;\n }\n });\n },\n rollback: async () => {\n await finalize(async () => {\n await session.abortTransaction();\n });\n },\n };\n }\n\n /**\n * Execute a function within a transaction scope (recommended pattern).\n *\n * Automatically commits on success, rolls back on any error, and guarantees\n * resource cleanup. This is the recommended way to use transactions.\n *\n * **MongoDB Requirements:**\n * - Requires MongoDB 4.0+ with replica set or sharded cluster\n * - Standalone MongoDB instances do not support transactions\n *\n * @param fn - Async function to execute within transaction\n * @param options - Transaction options (read preference, write concern, etc.)\n * @returns The return value of the callback function\n * @throws {Error} If transaction fails, is explicitly rolled back, or replica set not configured\n */\n public async transaction<T>(\n fn: (ctx: TransactionContext) => Promise<T>,\n options?: Record<string, unknown>,\n ): Promise<T> {\n // Prevent nested transaction() calls\n if (databaseTransactionContext.hasActiveTransaction()) {\n throw new Error(\n \"Nested transaction() calls are not supported. \" +\n \"Use beginTransaction() with savepoints for advanced transaction patterns.\",\n );\n }\n\n // Check if MongoDB is running as a replica set (required for transactions)\n await this.ensureReplicaSetAvailable();\n\n const client = this.getClientInstance();\n const session = client.startSession();\n\n try {\n await session.startTransaction({\n ...this.transactionOptions,\n ...(options as TransactionOptions),\n });\n\n // Set transaction context for queries within callback\n databaseTransactionContext.enter({ session });\n\n try {\n // Create transaction context with rollback method\n const ctx: TransactionContext = {\n rollback(reason?: string): never {\n throw new TransactionRollbackError(reason);\n },\n };\n\n // Execute callback\n const result = await fn(ctx);\n\n // Auto-commit on success\n await session.commitTransaction();\n\n return result;\n } catch (error) {\n // Auto-rollback on any error (including explicit rollback)\n await session.abortTransaction().catch(() => undefined);\n throw error;\n } finally {\n // Guaranteed context cleanup\n databaseTransactionContext.exit();\n }\n } finally {\n // Guaranteed session cleanup\n await session.endSession().catch(() => undefined);\n }\n }\n\n /**\n * Execute atomic operations (typically $inc/$set style updates) against documents.\n *\n * Uses `updateMany` so callers can atomically modify any set of documents.\n */\n public async atomic(\n table: string,\n filter: Record<string, unknown>,\n operations: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<UpdateResult> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<UpdateOptions>(options);\n const result = await collection.updateMany(\n filter,\n operations as UpdateFilter<Record<string, unknown>>,\n mongoOptions,\n );\n\n return { modifiedCount: result.modifiedCount };\n }\n\n /**\n * Lazily create (and cache) the Mongo sync adapter.\n * The adapter uses this driver instance to ensure all operations\n * participate in active transactions via the session context.\n */\n public syncAdapter(): SyncAdapterContract {\n if (!this.syncAdapterInstance) {\n this.syncAdapterInstance = new MongoSyncAdapter(this);\n }\n\n return this.syncAdapterInstance;\n }\n\n /**\n * Lazily create (and cache) the Mongo migration driver.\n * The migration driver handles schema operations like indexes, collections, etc.\n */\n public migrationDriver(): MigrationDriverContract {\n if (!this.migrationDriverInstance) {\n this.migrationDriverInstance = new MongoMigrationDriver(this);\n }\n\n return this.migrationDriverInstance!;\n }\n\n /**\n * Expose the underlying Mongo client for advanced consumers.\n */\n public getClient<Client = MongoClient>(): Client {\n return this.getClientInstance() as Client;\n }\n\n /**\n * Retrieve the active Mongo client, throwing if the driver is disconnected.\n */\n private getClientInstance(): MongoClient {\n if (!this.client) {\n throw new Error(\"Mongo driver is not connected.\");\n }\n\n return this.client;\n }\n\n /**\n * Retrieve the active Mongo database, throwing if the driver is disconnected.\n * @private\n */\n private getDatabaseInstance(): Db {\n if (!this.database) {\n throw new Error(\"Mongo driver is not connected to a database.\");\n }\n\n return this.database;\n }\n\n /**\n * Resolve the Mongo connection string based on provided options.\n */\n private resolveUri(): string {\n if (this.config.uri) {\n return this.config.uri;\n }\n\n const host = this.config.host ?? \"localhost\";\n const port = this.config.port ?? 27017;\n\n return `mongodb://${host}:${port}`;\n }\n\n /**\n * Build the Mongo client options derived from the driver configuration.\n */\n private buildClientOptions(): MongoClientOptions {\n const baseOptions: MongoClientOptions = {\n ...(this.config.clientOptions ?? {}),\n };\n\n if (this.config.logging) {\n baseOptions.monitorCommands = true;\n }\n\n if (this.config.username && !baseOptions.auth) {\n baseOptions.auth = {\n username: this.config.username,\n password: this.config.password,\n };\n }\n\n if (this.config.authSource && !baseOptions.authSource) {\n baseOptions.authSource = this.config.authSource;\n }\n\n return baseOptions;\n }\n\n /**\n * Emit a driver lifecycle event.\n */\n private emit(event: DriverEvent, ...args: unknown[]): void {\n this.events.emit(event, ...args);\n }\n\n /**\n * Ensure MongoDB is running as a replica set (required for transactions).\n *\n * @throws {Error} If MongoDB is running as a standalone instance\n */\n private async ensureReplicaSetAvailable(): Promise<void> {\n try {\n const admin = this.database!.admin();\n const status = await admin.serverStatus();\n\n if (!status.repl) {\n throw new Error(\n \"MongoDB transactions require a replica set or sharded cluster. \" +\n \"Standalone MongoDB instances do not support transactions.\\n\\n\" +\n \"For local development:\\n\" +\n \" - Run MongoDB with --replSet flag: mongod --replSet rs0\\n\" +\n \" - Or use Docker with replica set configuration\\n\" +\n \" - Or use MongoDB Atlas (cloud) which provides replica sets by default\",\n );\n }\n } catch (error: any) {\n if (error.message?.includes(\"replica set\")) {\n throw error;\n }\n throw new Error(`Failed to check MongoDB replica set status: ${error.message}`);\n }\n }\n\n /**\n * Attach the active transaction session (when available) to Mongo options.\n */\n private withSession<TOptions extends { session?: ClientSession }>(\n options?: Record<string, unknown>,\n ): TOptions | undefined {\n const session = databaseTransactionContext.getSession<ClientSession>();\n\n if (!session) {\n return options as TOptions | undefined;\n }\n\n const baseOptions = options ? ({ ...options } as TOptions) : ({} as TOptions);\n\n baseOptions.session = session;\n\n return baseOptions;\n }\n\n // ============================================================\n // SQL Compatibility Operations (Not supported in MongoDB)\n // ============================================================\n\n /**\n * Return a SQL serializer for this driver's dialect.\n * Not supported for MongoDB.\n */\n public getSQLSerializer(): SQLSerializer {\n throw new Error(\"MongoDB driver does not support SQL serialization.\");\n }\n\n /**\n * Execute a raw SQL query.\n * Not supported for MongoDB.\n */\n public async query<T = Record<string, unknown>>(\n _sql: string,\n _params?: unknown[],\n ): Promise<RawQueryResult<T>> {\n throw new Error(\"MongoDB driver does not support raw SQL queries.\");\n }\n\n // ============================================================\n // Database Lifecycle Operations\n // ============================================================\n\n /**\n * Create a new database.\n *\n * In MongoDB, databases are created automatically when data is first written.\n * This method creates an empty collection to ensure the database exists.\n *\n * @param name - Database name to create\n * @returns true if created, false if already exists\n */\n public async createDatabase(name: string): Promise<boolean> {\n const client = this.getClientInstance();\n\n // Check if database already exists\n if (await this.databaseExists(name)) {\n return false;\n }\n\n try {\n // MongoDB creates databases on first write, so create a system collection\n const db = client.db(name);\n await db.createCollection(\"__init__\");\n // Drop the temp collection\n await db.collection(\"__init__\").drop();\n\n log.success(\"database\", \"lifecycle\", `Created database ${name}`);\n return true;\n } catch (error) {\n log.error(\"database\", \"lifecycle\", `Failed to create database ${name}: ${error}`);\n throw error;\n }\n }\n\n /**\n * Drop a database.\n *\n * @param name - Database name to drop\n * @returns true if dropped, false if didn't exist\n */\n public async dropDatabase(name: string): Promise<boolean> {\n const client = this.getClientInstance();\n\n // Check if database exists\n if (!(await this.databaseExists(name))) {\n return false;\n }\n\n try {\n await client.db(name).dropDatabase();\n log.success(\"database\", \"lifecycle\", `Dropped database ${name}`);\n return true;\n } catch (error) {\n log.error(\"database\", \"lifecycle\", `Failed to drop database ${name}: ${error}`);\n throw error;\n }\n }\n\n /**\n * Check if a database exists.\n *\n * @param name - Database name to check\n * @returns true if database exists\n */\n public async databaseExists(name: string): Promise<boolean> {\n const client = this.getClientInstance();\n\n const result = await client.db(\"admin\").admin().listDatabases();\n return result.databases.some((db) => db.name === name);\n }\n\n /**\n * List all databases.\n *\n * @returns Array of database names\n */\n public async listDatabases(): Promise<string[]> {\n const client = this.getClientInstance();\n\n const result = await client.db(\"admin\").admin().listDatabases();\n return result.databases\n .map((db) => db.name)\n .filter((name) => ![\"admin\", \"local\", \"config\"].includes(name));\n }\n\n // ============================================================\n // Table/Collection Management Operations\n // ============================================================\n\n /**\n * Drop a collection.\n *\n * @param name - Collection name to drop\n * @throws Error if collection doesn't exist\n */\n public async dropTable(name: string): Promise<void> {\n const db = this.getDatabaseInstance();\n await db.collection(name).drop();\n log.success(\"database\", \"collection\", `Dropped collection ${name}`);\n }\n\n /**\n * Drop a collection if it exists.\n *\n * @param name - Collection name to drop\n */\n public async dropTableIfExists(name: string): Promise<void> {\n if (await this.blueprint.tableExists(name)) {\n await this.dropTable(name);\n }\n }\n\n /**\n * Drop all collections in the current database.\n *\n * Useful for `migrate:fresh` command.\n */\n public async dropAllTables(): Promise<void> {\n const collections = await this.blueprint.listTables();\n\n if (collections.length === 0) {\n return;\n }\n\n const db = this.getDatabaseInstance();\n\n for (const collection of collections) {\n await db.collection(collection).drop();\n }\n\n log.success(\"database\", \"collection\", `Dropped ${collections.length} collections`);\n }\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"mongodb-driver.mjs","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-driver.ts"],"sourcesContent":["import { colors } from \"@mongez/copper\";\nimport { log } from \"@warlock.js/logger\";\nimport type {\n BulkWriteOptions,\n ClientSession,\n Db,\n DeleteOptions,\n FindOneAndDeleteOptions,\n FindOneAndUpdateOptions,\n InsertManyResult,\n InsertOneOptions,\n MongoClient,\n MongoClientOptions,\n TransactionOptions,\n UpdateFilter,\n UpdateOptions,\n} from \"mongodb\";\nimport { EventEmitter } from \"node:events\";\nimport { databaseTransactionContext } from \"../../context/database-transaction-context\";\nimport type {\n DriverBlueprintContract,\n DriverContract,\n DriverEvent,\n DriverEventListener,\n DriverTransactionContract,\n IdGeneratorContract,\n InsertResult,\n MigrationDriverContract,\n QueryBuilderContract,\n RawQueryResult,\n SyncAdapterContract,\n TransactionContext,\n UpdateOperations,\n UpdateResult,\n} from \"../../contracts\";\nimport { dataSourceRegistry } from \"../../data-source/data-source-registry\";\nimport { DatabaseDirtyTracker } from \"../../database-dirty-tracker\";\nimport { TransactionRollbackError } from \"../../errors/transaction-rollback.error\";\nimport { type SQLSerializer } from \"../../migration/sql-serializer\";\nimport type { ModelDefaults } from \"../../types\";\nimport { isValidDateValue } from \"../../utils/is-valid-date-value\";\nimport { MongoDBBlueprint } from \"./mongodb-blueprint\";\nimport { MongoIdGenerator } from \"./mongodb-id-generator\";\nimport { MongoMigrationDriver } from \"./mongodb-migration-driver\";\nimport { MongoQueryBuilder } from \"./mongodb-query-builder\";\nimport { MongoSyncAdapter } from \"./mongodb-sync-adapter\";\nimport type { MongoDriverOptions } from \"./types\";\n\nconst DEFAULT_TRANSACTION_OPTIONS: TransactionOptions = {\n readPreference: \"primary\",\n readConcern: { level: \"local\" },\n writeConcern: { w: \"majority\" },\n};\n\n// ============================================================\n// Lazy-loaded MongoDB SDK Types\n// ============================================================\n\n/**\n * Cached MongoDB module (loaded once, reused)\n */\nlet MongoDBClient: typeof import(\"mongodb\");\n\nlet ObjectId: typeof import(\"mongodb\").ObjectId;\n\nlet isModuleExists: boolean | null = null;\n\nlet loadingPromise: Promise<any>;\n\n/**\n * Installation instructions for MongoDB package\n */\nconst MONGODB_INSTALL_INSTRUCTIONS = `\nMongoDB driver requires the mongodb package.\nInstall it with:\n\n npm install mongodb\n\nOr with your preferred package manager:\n\n pnpm add mongodb\n yarn add mongodb\n`.trim();\n\n/**\n * Load MongoDB module\n */\nasync function loadMongoDB() {\n try {\n loadingPromise = import(\"mongodb\");\n MongoDBClient = await loadingPromise;\n ObjectId = MongoDBClient.ObjectId;\n isModuleExists = true;\n } catch {\n isModuleExists = false;\n }\n}\n\nloadMongoDB();\n\nexport function isMongoDBDriverLoaded() {\n return isModuleExists;\n}\n\nasync function assertModuleIsLoaded() {\n if (isModuleExists === false) {\n throw new Error(MONGODB_INSTALL_INSTRUCTIONS);\n }\n\n if (isModuleExists === null) {\n await loadingPromise;\n\n return await assertModuleIsLoaded();\n }\n}\n\n/**\n * MongoDB driver implementation that fulfils the Cascade driver contract.\n *\n * It encapsulates the native Mongo client, exposes lifecycle events, and\n * provides helpers for CRUD, transactions, atomic updates, and sync adapters.\n */\nexport class MongoDbDriver implements DriverContract {\n private readonly events = new EventEmitter();\n public client?: MongoClient;\n public database?: Db;\n private connected = false;\n private syncAdapterInstance?: MongoSyncAdapter;\n private migrationDriverInstance?: MigrationDriverContract;\n private readonly transactionOptions: TransactionOptions;\n private idGeneratorInstance?: IdGeneratorContract;\n private _blueprint?: DriverBlueprintContract;\n\n public get blueprint(): DriverBlueprintContract {\n if (!this._blueprint) {\n this._blueprint = new MongoDBBlueprint(this.database!);\n }\n\n return this._blueprint!;\n }\n\n /**\n * The name of this driver.\n */\n public readonly name = \"mongodb\";\n\n /**\n * Current database name\n */\n protected _databaseName?: string;\n\n /**\n * MongoDB driver model defaults.\n *\n * MongoDB follows NoSQL conventions:\n * - camelCase naming for fields (createdAt, updatedAt, deletedAt)\n * - Manual ID generation (auto-increment id field separate from _id)\n * - Timestamps enabled by default\n * - Trash delete strategy with per-collection trash tables\n */\n public readonly modelDefaults: Partial<ModelDefaults> = {\n namingConvention: \"camelCase\",\n createdAtColumn: \"createdAt\",\n updatedAtColumn: \"updatedAt\",\n deletedAtColumn: \"deletedAt\",\n timestamps: true,\n autoGenerateId: true, // MongoDB needs manual ID generation\n strictMode: \"strip\",\n deleteStrategy: \"trash\",\n trashTable: (table) => `${table}Trash`, // Per-collection trash (usersTrash, productsTrash)\n };\n\n /**\n * Create a new MongoDB driver using the supplied connection options.\n *\n * @param config - Connection configuration\n * @param driverOptions - Driver-specific options\n */\n public constructor(\n private readonly config: {\n database: string;\n uri?: string;\n host?: string;\n port?: number;\n username?: string;\n password?: string;\n authSource?: string;\n logging?: boolean;\n clientOptions?: MongoClientOptions;\n },\n private readonly driverOptions?: MongoDriverOptions,\n ) {\n this.transactionOptions = {\n ...DEFAULT_TRANSACTION_OPTIONS,\n ...driverOptions?.transactionOptions,\n };\n }\n\n /**\n * Get data base name\n */\n public get databaseName(): string | undefined {\n if (!this._databaseName) {\n this.resolveDatabaseName();\n }\n\n return this._databaseName;\n }\n\n /**\n * Resolve database name either from config or uri\n */\n private resolveDatabaseName() {\n if (this.config.database) {\n this._databaseName = this.config.database;\n } else if (this.config.uri) {\n this._databaseName = this.config.uri.split(\"/\").pop()?.split(\"?\")?.[0];\n }\n }\n\n /**\n * Indicates whether the driver currently maintains an active connection.\n */\n public get isConnected(): boolean {\n return this.connected;\n }\n\n /**\n * Get the MongoDB database instance.\n *\n * @returns The MongoDB Db instance\n * @throws {Error} If not connected\n *\n * @example\n * ```typescript\n * const db = driver.getDatabase();\n * const collection = db.collection(\"users\");\n * ```\n */\n public getDatabase(): Db {\n if (!this.database) {\n throw new Error(\n \"Database not available. Ensure the driver is connected before accessing the database.\",\n );\n }\n return this.database;\n }\n\n /**\n * Get the ID generator instance for this driver.\n *\n * Creates a MongoIdGenerator on first access if autoGenerateId is enabled.\n *\n * @returns The ID generator instance, or undefined if disabled\n *\n * @example\n * ```typescript\n * const idGenerator = driver.getIdGenerator();\n * if (idGenerator) {\n * const id = await idGenerator.generateNextId({ table: \"users\" });\n * }\n * ```\n */\n public getIdGenerator(): IdGeneratorContract | undefined {\n // Return undefined if ID generation is disabled\n if (this.driverOptions?.autoGenerateId === false) {\n return undefined;\n }\n\n // Create ID generator lazily on first access\n if (!this.idGeneratorInstance) {\n this.idGeneratorInstance = new MongoIdGenerator(this, this.driverOptions?.counterCollection);\n }\n\n return this.idGeneratorInstance;\n }\n\n /**\n * Establish a MongoDB connection using the configured options.\n * Throws if the connection attempt fails.\n */\n public async connect(): Promise<void> {\n if (this.connected) {\n return;\n }\n\n await assertModuleIsLoaded();\n\n const uri = this.resolveUri();\n\n const { MongoClient, ObjectId: ObjectIdMongoDB } = MongoDBClient;\n\n ObjectId = ObjectIdMongoDB;\n\n const client = new MongoClient(uri, this.buildClientOptions());\n\n try {\n log.info(\n \"database.mongodb\",\n \"connection\",\n `Connecting to database ${colors.bold(colors.yellowBright(this.databaseName))}`,\n );\n await client.connect();\n this.client = client;\n this.database = client.db(this.databaseName);\n\n this.connected = true;\n log.success(\"database.mongodb\", \"connection\", \"Connected to database\");\n\n client.on(\"close\", () => {\n if (this.connected) {\n this.connected = false;\n this.emit(\"disconnected\");\n log.warn(\"database.mongodb\", \"connection\", \"Disconnected from database\");\n }\n });\n\n if (this.config.logging) {\n const ignoredCommands = [\"isMaster\", \"hello\", \"ping\", \"saslStart\", \"saslContinue\"];\n\n client.on(\"commandStarted\", (event: any) => {\n if (ignoredCommands.includes(event.commandName)) return;\n\n let cmdStr = JSON.stringify(event.command);\n if (cmdStr.length > 300) {\n cmdStr = cmdStr.substring(0, 300) + \"...\";\n }\n\n log.info({\n module: \"database.mongodb\",\n action: \"query.executing\",\n message: `[${event.commandName}] ${cmdStr}`,\n context: { command: event.command },\n });\n });\n\n client.on(\"commandSucceeded\", (event: any) => {\n if (ignoredCommands.includes(event.commandName)) return;\n\n log.success({\n module: \"database.mongodb\",\n action: \"query.executed\",\n message: `[${event.duration.toFixed(2)}ms] [${event.commandName}]`,\n });\n });\n\n client.on(\"commandFailed\", (event: any) => {\n if (ignoredCommands.includes(event.commandName)) return;\n\n log.error({\n module: \"database.mongodb\",\n action: \"query.error\",\n message: `[${event.duration.toFixed(2)}ms] [${event.commandName}]`,\n context: { failure: event.failure },\n });\n });\n }\n\n this.emit(\"connected\");\n } catch (error: any) {\n await client.close().catch(() => undefined);\n this.emit(\"disconnected\");\n // Boot-time database connection failure is unrecoverable in every\n // realistic caller (app boot, CLI migrations, workers) — `fatal` makes\n // \"page on fatal only\" alerting clean. Per-query failures stay at error.\n log.fatal(\n \"database.mongodb\",\n \"connection\",\n `Failed to connect to database: ${error.message}`,\n );\n throw error;\n }\n }\n\n /**\n * Close the underlying MongoDB connection.\n */\n public async disconnect(): Promise<void> {\n if (!this.client) {\n return;\n }\n\n try {\n await this.client.close();\n } finally {\n this.connected = false;\n this.emit(\"disconnected\");\n }\n }\n\n /**\n * Subscribe to driver lifecycle events.\n */\n public on(event: DriverEvent, listener: DriverEventListener): void {\n this.events.on(event, listener);\n }\n\n /**\n * Insert a single document into the given collection.\n */\n public async insert(\n table: string,\n document: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<InsertResult> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<InsertOneOptions>(options);\n const result = await collection.insertOne(document, mongoOptions);\n\n return {\n document: {\n ...document,\n _id: result.insertedId,\n },\n };\n }\n\n /**\n * Insert multiple documents into the given collection.\n */\n public async insertMany(\n table: string,\n documents: Record<string, unknown>[],\n options?: Record<string, unknown>,\n ): Promise<InsertResult[]> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<BulkWriteOptions>(options);\n const result: InsertManyResult<Record<string, unknown>> = await collection.insertMany(\n documents,\n mongoOptions,\n );\n\n return documents.map((document, index) => {\n const insertedId = result.insertedIds[index as unknown as keyof typeof result.insertedIds];\n\n return {\n document: {\n ...document,\n _id: insertedId,\n },\n };\n });\n }\n\n /**\n * Update a single document that matches the provided filter.\n */\n public async update(\n table: string,\n filter: Record<string, unknown>,\n update: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<UpdateResult> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<UpdateOptions>(options);\n const result = await collection.updateOne(\n filter,\n update as UpdateFilter<Record<string, unknown>>,\n mongoOptions,\n );\n\n return { modifiedCount: result.modifiedCount };\n }\n\n /**\n * Replace a single document that matches the provided filter.\n */\n public async replace<T = unknown>(\n table: string,\n filter: Record<string, unknown>,\n document: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<T | null> {\n const collection = this.getDatabaseInstance().collection(table);\n const result = await collection.findOneAndReplace(filter, document as Record<string, unknown>);\n\n return result?.value as T | null;\n }\n\n /**\n * Find one and update a single document that matches the provided filter and return the updated document\n */\n public async findOneAndUpdate<T = unknown>(\n table: string,\n filter: Record<string, unknown>,\n update: UpdateOperations,\n options?: Record<string, unknown>,\n ): Promise<T | null> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<FindOneAndUpdateOptions>(options);\n const result = await collection.findOneAndUpdate(filter, update as Record<string, unknown>, {\n returnDocument: \"after\",\n ...mongoOptions,\n });\n\n return result as T | null;\n }\n\n /**\n * Upsert (insert or update) a single document.\n *\n * Uses MongoDB's findOneAndUpdate with upsert option.\n *\n * @param table - Target collection name\n * @param filter - Filter conditions to find existing document\n * @param document - Document data to insert or update\n * @param options - Optional upsert options\n * @returns The upserted document\n */\n public async upsert<T = unknown>(\n table: string,\n filter: Record<string, unknown>,\n document: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<T> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<FindOneAndUpdateOptions>(options);\n\n // Use $set to update all fields from document\n const update = { $set: document };\n\n const result = await collection.findOneAndUpdate(filter, update, {\n upsert: true,\n returnDocument: \"after\",\n ...mongoOptions,\n });\n\n return result as T;\n }\n\n /**\n * Find one and delete a single document that matches the provided filter and return the deleted document.\n *\n * @param table - Target collection name\n * @param filter - Filter conditions\n * @param options - Optional delete options\n * @returns The deleted document or null if not found\n */\n public async findOneAndDelete<T = unknown>(\n table: string,\n filter: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<T | null> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<FindOneAndDeleteOptions>(options);\n\n const result = await collection.findOneAndDelete(filter, mongoOptions || {});\n\n return result as T | null;\n }\n\n /**\n * Update multiple documents that match the provided filter.\n */\n public async updateMany(\n table: string,\n filter: Record<string, unknown>,\n update: UpdateOperations,\n options?: Record<string, unknown>,\n ): Promise<UpdateResult> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<UpdateOptions>(options);\n const result = await collection.updateMany(\n filter,\n update as UpdateFilter<Record<string, unknown>>,\n mongoOptions,\n );\n\n return { modifiedCount: result.modifiedCount };\n }\n\n /**\n * Delete a single document that matches the provided filter.\n */\n public async delete(\n table: string,\n filter: Record<string, unknown> = {},\n options?: Record<string, unknown>,\n ): Promise<number> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<DeleteOptions>(options);\n const result = await collection.deleteOne(filter, mongoOptions);\n\n return result.deletedCount > 0 ? 1 : 0;\n }\n\n /**\n * Delete documents that match the provided filter.\n */\n public async deleteMany(\n table: string,\n filter: Record<string, unknown> = {},\n options?: Record<string, unknown>,\n ): Promise<number> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<DeleteOptions>(options);\n\n const result = await collection.deleteMany(filter, mongoOptions);\n\n return result.deletedCount ?? 0;\n }\n\n /**\n * Remove all records from a collection.\n *\n * This uses deleteMany with an empty filter to remove all documents.\n * For very large collections, consider using the migration driver's\n * dropTable + createTable approach for better performance.\n */\n public async truncateTable(table: string, options?: Record<string, unknown>): Promise<number> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<DeleteOptions>(options);\n const result = await collection.deleteMany({}, mongoOptions);\n\n return result.deletedCount ?? 0;\n }\n\n /**\n * Serialize the given data\n */\n public serialize(data: Record<string, unknown>): Record<string, unknown> {\n const serialized: Record<string, unknown> = {};\n\n for (const [key, value] of Object.entries(data)) {\n if (value === undefined) {\n continue; // Skip undefined values\n }\n\n if (value instanceof ObjectId) {\n serialized[key] = value.toString();\n } else if (value instanceof Date) {\n serialized[key] = value.toISOString();\n } else if (typeof value === \"bigint\") {\n serialized[key] = value.toString();\n } else if (typeof value === \"object\" && value !== null && !Array.isArray(value)) {\n // Nested objects will be stored as JSONB\n serialized[key] = value;\n } else {\n serialized[key] = value;\n }\n }\n\n return serialized;\n }\n\n /**\n * Get the dirty tracker for this driver.\n */\n public getDirtyTracker(data: Record<string, unknown>): DatabaseDirtyTracker {\n return new DatabaseDirtyTracker(data);\n }\n\n /**\n * Deserialize the given data\n */\n public deserialize(data: Record<string, unknown>): Record<string, unknown> {\n if (data._id && typeof data._id === \"string\") {\n data._id = new ObjectId(data._id);\n }\n\n for (const [key, value] of Object.entries(data)) {\n // Only re-inflate strings — Mongo driver already returns Date objects from DB reads\n if (typeof value === \"string\" && isValidDateValue(value)) {\n data[key] = new Date(value);\n }\n }\n\n return data;\n }\n\n /**\n * Provide a Mongo-backed query builder instance for the given collection.\n */\n public queryBuilder<T = unknown>(table: string): QueryBuilderContract<T> {\n return new MongoQueryBuilder(table, dataSourceRegistry.get());\n }\n\n /**\n * Begin a MongoDB transaction, returning commit/rollback helpers.\n */\n public async beginTransaction(): Promise<DriverTransactionContract<ClientSession>> {\n const client = this.getClientInstance();\n const session = client.startSession();\n\n await session.startTransaction(this.transactionOptions);\n databaseTransactionContext.enter({ session });\n let finished = false;\n\n const finalize = async (operation: () => Promise<void>): Promise<void> => {\n if (finished) return;\n\n try {\n await operation();\n } finally {\n finished = true;\n databaseTransactionContext.exit();\n await session.endSession().catch(() => undefined);\n }\n };\n\n return {\n context: session,\n commit: async () => {\n await finalize(async () => {\n try {\n await session.commitTransaction();\n } catch (error) {\n await session.abortTransaction().catch(() => undefined);\n throw error;\n }\n });\n },\n rollback: async () => {\n await finalize(async () => {\n await session.abortTransaction();\n });\n },\n };\n }\n\n /**\n * Execute a function within a transaction scope (recommended pattern).\n *\n * Automatically commits on success, rolls back on any error, and guarantees\n * resource cleanup. This is the recommended way to use transactions.\n *\n * **MongoDB Requirements:**\n * - Requires MongoDB 4.0+ with replica set or sharded cluster\n * - Standalone MongoDB instances do not support transactions\n *\n * @param fn - Async function to execute within transaction\n * @param options - Transaction options (read preference, write concern, etc.)\n * @returns The return value of the callback function\n * @throws {Error} If transaction fails, is explicitly rolled back, or replica set not configured\n */\n public async transaction<T>(\n fn: (ctx: TransactionContext) => Promise<T>,\n options?: Record<string, unknown>,\n ): Promise<T> {\n const ctx: TransactionContext = {\n rollback(reason?: string): never {\n throw new TransactionRollbackError(reason);\n },\n };\n\n // Flat nesting: a transaction() called while one is already active JOINS it\n // instead of throwing (or opening a second, independent one). The outermost\n // transaction owns commit / abort; the inner block runs on the same session\n // so it sees the outer's writes — a service that opens its own transaction\n // then works both standalone and when called inside an outer transaction\n // (e.g. a seeder). Mirrors `PostgresDriver.transaction`.\n if (databaseTransactionContext.hasActiveTransaction()) {\n return fn(ctx);\n }\n\n // Check if MongoDB is running as a replica set (required for transactions)\n await this.ensureReplicaSetAvailable();\n\n const client = this.getClientInstance();\n const session = client.startSession();\n\n try {\n await session.startTransaction({\n ...this.transactionOptions,\n ...(options as TransactionOptions),\n });\n\n // Set transaction context for queries within callback\n databaseTransactionContext.enter({ session });\n\n try {\n // Execute callback\n const result = await fn(ctx);\n\n // Auto-commit on success\n await session.commitTransaction();\n\n return result;\n } catch (error) {\n // Auto-rollback on any error (including explicit rollback)\n await session.abortTransaction().catch(() => undefined);\n throw error;\n } finally {\n // Guaranteed context cleanup\n databaseTransactionContext.exit();\n }\n } finally {\n // Guaranteed session cleanup\n await session.endSession().catch(() => undefined);\n }\n }\n\n /**\n * Execute atomic operations (typically $inc/$set style updates) against documents.\n *\n * Uses `updateMany` so callers can atomically modify any set of documents.\n */\n public async atomic(\n table: string,\n filter: Record<string, unknown>,\n operations: Record<string, unknown>,\n options?: Record<string, unknown>,\n ): Promise<UpdateResult> {\n const collection = this.getDatabaseInstance().collection(table);\n const mongoOptions = this.withSession<UpdateOptions>(options);\n const result = await collection.updateMany(\n filter,\n operations as UpdateFilter<Record<string, unknown>>,\n mongoOptions,\n );\n\n return { modifiedCount: result.modifiedCount };\n }\n\n /**\n * Lazily create (and cache) the Mongo sync adapter.\n * The adapter uses this driver instance to ensure all operations\n * participate in active transactions via the session context.\n */\n public syncAdapter(): SyncAdapterContract {\n if (!this.syncAdapterInstance) {\n this.syncAdapterInstance = new MongoSyncAdapter(this);\n }\n\n return this.syncAdapterInstance;\n }\n\n /**\n * Lazily create (and cache) the Mongo migration driver.\n * The migration driver handles schema operations like indexes, collections, etc.\n */\n public migrationDriver(): MigrationDriverContract {\n if (!this.migrationDriverInstance) {\n this.migrationDriverInstance = new MongoMigrationDriver(this);\n }\n\n return this.migrationDriverInstance!;\n }\n\n /**\n * Expose the underlying Mongo client for advanced consumers.\n */\n public getClient<Client = MongoClient>(): Client {\n return this.getClientInstance() as Client;\n }\n\n /**\n * Retrieve the active Mongo client, throwing if the driver is disconnected.\n */\n private getClientInstance(): MongoClient {\n if (!this.client) {\n throw new Error(\"Mongo driver is not connected.\");\n }\n\n return this.client;\n }\n\n /**\n * Retrieve the active Mongo database, throwing if the driver is disconnected.\n * @private\n */\n private getDatabaseInstance(): Db {\n if (!this.database) {\n throw new Error(\"Mongo driver is not connected to a database.\");\n }\n\n return this.database;\n }\n\n /**\n * Resolve the Mongo connection string based on provided options.\n */\n private resolveUri(): string {\n if (this.config.uri) {\n return this.config.uri;\n }\n\n const host = this.config.host ?? \"localhost\";\n const port = this.config.port ?? 27017;\n\n return `mongodb://${host}:${port}`;\n }\n\n /**\n * Build the Mongo client options derived from the driver configuration.\n */\n private buildClientOptions(): MongoClientOptions {\n const baseOptions: MongoClientOptions = {\n ...(this.config.clientOptions ?? {}),\n };\n\n if (this.config.logging) {\n baseOptions.monitorCommands = true;\n }\n\n if (this.config.username && !baseOptions.auth) {\n baseOptions.auth = {\n username: this.config.username,\n password: this.config.password,\n };\n }\n\n if (this.config.authSource && !baseOptions.authSource) {\n baseOptions.authSource = this.config.authSource;\n }\n\n return baseOptions;\n }\n\n /**\n * Emit a driver lifecycle event.\n */\n private emit(event: DriverEvent, ...args: unknown[]): void {\n this.events.emit(event, ...args);\n }\n\n /**\n * Ensure MongoDB is running as a replica set (required for transactions).\n *\n * @throws {Error} If MongoDB is running as a standalone instance\n */\n private async ensureReplicaSetAvailable(): Promise<void> {\n try {\n const admin = this.database!.admin();\n const status = await admin.serverStatus();\n\n if (!status.repl) {\n throw new Error(\n \"MongoDB transactions require a replica set or sharded cluster. \" +\n \"Standalone MongoDB instances do not support transactions.\\n\\n\" +\n \"For local development:\\n\" +\n \" - Run MongoDB with --replSet flag: mongod --replSet rs0\\n\" +\n \" - Or use Docker with replica set configuration\\n\" +\n \" - Or use MongoDB Atlas (cloud) which provides replica sets by default\",\n );\n }\n } catch (error: any) {\n if (error.message?.includes(\"replica set\")) {\n throw error;\n }\n throw new Error(`Failed to check MongoDB replica set status: ${error.message}`);\n }\n }\n\n /**\n * Attach the active transaction session (when available) to Mongo options.\n */\n private withSession<TOptions extends { session?: ClientSession }>(\n options?: Record<string, unknown>,\n ): TOptions | undefined {\n const session = databaseTransactionContext.getSession<ClientSession>();\n\n if (!session) {\n return options as TOptions | undefined;\n }\n\n const baseOptions = options ? ({ ...options } as TOptions) : ({} as TOptions);\n\n baseOptions.session = session;\n\n return baseOptions;\n }\n\n // ============================================================\n // SQL Compatibility Operations (Not supported in MongoDB)\n // ============================================================\n\n /**\n * MongoDB has no SQL dialect — the MigrationRunner executes migrations\n * through the migration driver directly instead of Migration.toSQL().\n */\n public readonly supportsSqlSerialization = false;\n\n /**\n * Return a SQL serializer for this driver's dialect.\n * Not supported for MongoDB.\n */\n public getSQLSerializer(): SQLSerializer {\n throw new Error(\"MongoDB driver does not support SQL serialization.\");\n }\n\n /**\n * Execute a raw SQL query.\n * Not supported for MongoDB.\n */\n public async query<T = Record<string, unknown>>(\n _sql: string,\n _params?: unknown[],\n ): Promise<RawQueryResult<T>> {\n throw new Error(\"MongoDB driver does not support raw SQL queries.\");\n }\n\n // ============================================================\n // Database Lifecycle Operations\n // ============================================================\n\n /**\n * Create a new database.\n *\n * In MongoDB, databases are created automatically when data is first written.\n * This method creates an empty collection to ensure the database exists.\n *\n * @param name - Database name to create\n * @returns true if created, false if already exists\n */\n public async createDatabase(name: string): Promise<boolean> {\n const client = this.getClientInstance();\n\n // Check if database already exists\n if (await this.databaseExists(name)) {\n return false;\n }\n\n try {\n // MongoDB creates databases on first write, so create a system collection\n const db = client.db(name);\n await db.createCollection(\"__init__\");\n // Drop the temp collection\n await db.collection(\"__init__\").drop();\n\n log.success(\"database\", \"lifecycle\", `Created database ${name}`);\n return true;\n } catch (error) {\n log.error(\"database\", \"lifecycle\", `Failed to create database ${name}: ${error}`);\n throw error;\n }\n }\n\n /**\n * Drop a database.\n *\n * @param name - Database name to drop\n * @returns true if dropped, false if didn't exist\n */\n public async dropDatabase(name: string): Promise<boolean> {\n const client = this.getClientInstance();\n\n // Check if database exists\n if (!(await this.databaseExists(name))) {\n return false;\n }\n\n try {\n await client.db(name).dropDatabase();\n log.success(\"database\", \"lifecycle\", `Dropped database ${name}`);\n return true;\n } catch (error) {\n log.error(\"database\", \"lifecycle\", `Failed to drop database ${name}: ${error}`);\n throw error;\n }\n }\n\n /**\n * Check if a database exists.\n *\n * @param name - Database name to check\n * @returns true if database exists\n */\n public async databaseExists(name: string): Promise<boolean> {\n const client = this.getClientInstance();\n\n const result = await client.db(\"admin\").admin().listDatabases();\n return result.databases.some((db) => db.name === name);\n }\n\n /**\n * List all databases.\n *\n * @returns Array of database names\n */\n public async listDatabases(): Promise<string[]> {\n const client = this.getClientInstance();\n\n const result = await client.db(\"admin\").admin().listDatabases();\n return result.databases\n .map((db) => db.name)\n .filter((name) => ![\"admin\", \"local\", \"config\"].includes(name));\n }\n\n // ============================================================\n // Table/Collection Management Operations\n // ============================================================\n\n /**\n * Drop a collection.\n *\n * @param name - Collection name to drop\n * @throws Error if collection doesn't exist\n */\n public async dropTable(name: string): Promise<void> {\n const db = this.getDatabaseInstance();\n await db.collection(name).drop();\n log.success(\"database\", \"collection\", `Dropped collection ${name}`);\n }\n\n /**\n * Drop a collection if it exists.\n *\n * @param name - Collection name to drop\n */\n public async dropTableIfExists(name: string): Promise<void> {\n if (await this.blueprint.tableExists(name)) {\n await this.dropTable(name);\n }\n }\n\n /**\n * Drop all collections in the current database.\n *\n * Useful for `migrate:fresh` command.\n */\n public async dropAllTables(): Promise<void> {\n const collections = await this.blueprint.listTables();\n\n if (collections.length === 0) {\n return;\n }\n\n const db = this.getDatabaseInstance();\n\n for (const collection of collections) {\n await db.collection(collection).drop();\n }\n\n log.success(\"database\", \"collection\", `Dropped ${collections.length} collections`);\n }\n}\n"],"mappings":"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"}
@@ -143,6 +143,10 @@ declare class MongoMigrationDriver implements MigrationDriverContract {
143
143
  /**
144
144
  * Drop an index by name or columns.
145
145
  *
146
+ * A string is the literal index name and is passed through untouched; a
147
+ * columns array resolves to the MongoDB convention name
148
+ * (`"column1_1_column2_1"`) those columns auto-name to.
149
+ *
146
150
  * @param indexNameOrColumns - Index name (string) or columns array
147
151
  */
148
152
  dropIndex(table: string, indexNameOrColumns: string | string[]): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"mongodb-migration-driver.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-migration-driver.ts"],"mappings":";;;;;;;;;AAmCA;;;;;;;;;;;;;;;;;cAAa,oBAAA,YAAgC,uBAAA;EAAA,SASR,MAAA,EAAQ,aAAA;EAmKiB;EAAA,QA1KpD,OAAA;EAgM2C;;;;;cAzLhB,MAAA,EAAQ,aAAA;EA+QsC;;;EAAA,YA1QrE,EAAA;EA6UiD;;;EAAA,YAtUjD,cAAA;EAkYD;;;;;;;EAlXE,WAAA,CAAY,KAAA,WAAgB,OAAA;EAifsC;;;EAlelE,sBAAA,CAAuB,KAAA,WAAgB,OAAA;EAmgBuB;;;;;EAlf9D,SAAA,CAAU,KAAA,WAAgB,OAAA;EAkkBd;;;EA3jBZ,iBAAA,CAAkB,KAAA,WAAgB,OAAA;EA+oBQ;;;EApoB1C,WAAA,CAAY,IAAA,UAAc,EAAA,WAAa,OAAA;EAvFc;;;;;EAgGrD,aAAA,CAAc,KAAA,WAAgB,OAAA;;;;EAO9B,WAAA,CAAY,KAAA,WAAgB,OAAA;EAlF7B;;;;;;EA6FC,WAAA,CAAY,MAAA,WAAiB,OAAA,CAAQ,gBAAA;EA7CrC;;;EAqDA,UAAA,IAAc,OAAA;EA9CI;;;;;;;;EA2DlB,qBAAA,CAAsB,SAAA,WAAoB,OAAA;EAhC1C;;;;;EAoDA,SAAA,CAAU,MAAA,UAAgB,OAAA,EAAS,gBAAA,GAAmB,OAAA;EAzCjB;;;;;EAkDrC,UAAA,CAAW,KAAA,UAAe,MAAA,WAAiB,OAAA;EAT3C;;;EAiBA,WAAA,CAAY,KAAA,UAAe,OAAA,aAAoB,OAAA;EAjBO;;;EA6BtD,YAAA,CAAa,KAAA,UAAe,IAAA,UAAc,EAAA,WAAa,OAAA;EApBZ;;;;;EA8B3C,YAAA,CAAa,MAAA,UAAgB,OAAA,EAAS,gBAAA,GAAmB,OAAA;EAV5C;;;;;;;;EAsBb,sBAAA,CAAuB,MAAA,WAAiB,OAAA;EAAxC;;;;;;EAcA,WAAA,CAAY,KAAA,UAAe,KAAA,EAAO,eAAA,GAAkB,OAAA;EAAA;;;;;EA2CpD,SAAA,CAAU,KAAA,UAAe,kBAAA,sBAAwC,OAAA;EAiB/C;;;EAAlB,iBAAA,CAAkB,KAAA,UAAe,OAAA,YAAmB,IAAA,YAAgB,OAAA;EAWpE;;;EAAA,eAAA,CAAgB,KAAA,UAAe,OAAA,aAAoB,OAAA;EAyBnD;;;;;EAAA,mBAAA,CACX,KAAA,UACA,OAAA,YACA,OAAA,GAAU,oBAAA,GACT,OAAA;EA2BU;;;EAAA,iBAAA,CAAkB,KAAA,UAAe,IAAA,WAAe,OAAA;EAOhD;;;EAAA,cAAA,CACX,KAAA,UACA,MAAA,UACA,OAAA,GAAU,eAAA,GACT,OAAA;EADD;;;EAyBW,YAAA,CAAa,KAAA,UAAe,MAAA,WAAiB,OAAA;EAAjB;;;;;;EAsB5B,iBAAA,CACX,KAAA,UACA,MAAA,UACA,OAAA,EAAS,kBAAA,GACR,OAAA;EAAA;;;EAsCU,eAAA,CAAgB,KAAA,UAAe,MAAA,WAAiB,OAAA;EAAA;;;EA8BhD,cAAA,CACX,KAAA,UACA,MAAA,UACA,kBAAA,WACC,OAAA;EADD;;;EASW,YAAA,CAAa,KAAA,UAAe,MAAA,WAAiB,OAAA;EAAjB;;;;;;EAsB5B,WAAA,CAAY,KAAA,WAAgB,OAAA,CAAQ,qBAAA;EAwBtB;;;;;;EAAd,aAAA,CAAc,MAAA,UAAgB,WAAA,EAAa,oBAAA,GAAuB,OAAA;EAOnB;;;EAA/C,cAAA,CAAe,MAAA,UAAgB,KAAA,WAAgB,OAAA;EASI;;;;;EAAnD,aAAA,CAAc,MAAA,UAAgB,QAAA,aAAqB,OAAA;EAiB1B;;;EAVzB,cAAA,CAAe,MAAA,WAAiB,OAAA;EAiBtB;;;;;;EAPV,QAAA,CAAS,MAAA,UAAgB,KAAA,UAAe,WAAA,WAAsB,OAAA;EA4C9D;;;EArCA,SAAA,CAAU,MAAA,UAAgB,KAAA,WAAgB,OAAA;EAsDtB;;;;;;;;;;;;;;;;;EA7BpB,mBAAA,CAAoB,KAAA,UAAe,MAAA,WAAiB,OAAA;EAoIV;;;EAxH1C,sBAAA,CAAuB,KAAA,WAAgB,OAAA;EAwHwB;;AAAC;;;EAvGhE,gBAAA,IAAoB,OAAA;;;;EAQpB,MAAA,IAAU,OAAA;;;;EAWV,QAAA,IAAY,OAAA;;;;EAWlB,oBAAA;;;;;;;;;;EAaA,uBAAA;;;;;;;;;;EAiBA,cAAA,CAAe,kBAAA,GAAqB,iBAAA;;;;;;EAa9B,oBAAA,CAAqB,UAAA,WAAqB,OAAA;;;;;;EAShD,mBAAA,CAAoB,UAAA;;;;;;;;;;;;;;EAqBd,GAAA,IAAO,QAAA,GAAW,UAAA,cAAwB,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;AAAA"}
1
+ {"version":3,"file":"mongodb-migration-driver.d.mts","names":[],"sources":["../../../../../../../../@warlock.js/cascade/src/drivers/mongodb/mongodb-migration-driver.ts"],"mappings":"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"}
@@ -203,12 +203,15 @@ var MongoMigrationDriver = class {
203
203
  /**
204
204
  * Drop an index by name or columns.
205
205
  *
206
+ * A string is the literal index name and is passed through untouched; a
207
+ * columns array resolves to the MongoDB convention name
208
+ * (`"column1_1_column2_1"`) those columns auto-name to.
209
+ *
206
210
  * @param indexNameOrColumns - Index name (string) or columns array
207
211
  */
208
212
  async dropIndex(table, indexNameOrColumns) {
209
213
  const collection = this.db.collection(table);
210
- if (!Array.isArray(indexNameOrColumns)) indexNameOrColumns = [indexNameOrColumns];
211
- const indexName = indexNameOrColumns.map((col) => `${col}_1`).join("_");
214
+ const indexName = Array.isArray(indexNameOrColumns) ? indexNameOrColumns.map((col) => `${col}_1`).join("_") : indexNameOrColumns;
212
215
  await collection.dropIndex(indexName);
213
216
  }
214
217
  /**