@warlock.js/cascade 5.20.0 → 5.22.0

package/esm/contracts/query-builder.contract.d.mts

@@ -581,6 +581,21 @@ interface QueryBuilderContract<T = unknown> {
    * query.whereNotBetween('age', [18, 65])
    */
   whereNotBetween(field: string, range: [unknown, unknown]): this;
+  /**
+   * OR variant of `whereIn`.
+   *
+   * @example
+   * query.where('a', 1).orWhereIn('status', ['active', 'pending'])
+   */
+  orWhereIn(field: string, values: unknown[]): this;
+  /** OR variant of `whereNotIn`. */
+  orWhereNotIn(field: string, values: unknown[]): this;
+  /** OR variant of `whereNull`. */
+  orWhereNull(field: string): this;
+  /** OR variant of `whereNotNull`. */
+  orWhereNotNull(field: string): this;
+  /** OR variant of `whereBetween` (inclusive range). */
+  orWhereBetween(field: string, range: [unknown, unknown]): this;
   /**
    * Apply pattern matching (case-insensitive) for the given field.
    *
@@ -1588,6 +1603,18 @@ interface QueryBuilderContract<T = unknown> {
    * @returns Number of rows affected
    */
   update(fields: Record<string, unknown>): Promise<number>;
+  /**
+   * Delete every row matching the current query (scopes and filters applied).
+   *
+   * @returns Number of rows deleted
+   */
+  delete(): Promise<number>;
+  /**
+   * Delete a single row matching the current query.
+   *
+   * @returns Number of rows deleted (0 or 1)
+   */
+  deleteOne(): Promise<number>;
   count(): Promise<number>;
   /**
    * Aggregate sum for the given field.
@@ -1602,21 +1629,21 @@ interface QueryBuilderContract<T = unknown> {
    * @example
    * const avgAge = await User.query().avg('age');
    */
-  avg(field: string): Promise<number>;
+  avg(field: string): Promise<number | null>;
   /**
    * Aggregate minimum for the given field.
    *
    * @example
    * const minPrice = await Product.query().min('price');
    */
-  min(field: string): Promise<number>;
+  min<V = number>(field: string): Promise<V | null>;
   /**
    * Aggregate maximum for the given field.
    *
    * @example
    * const maxPrice = await Product.query().max('price');
    */
-  max(field: string): Promise<number>;
+  max<V = number>(field: string): Promise<V | null>;
   /**
    * Retrieve distinct values for a field.
    * @param field - The field to get distinct values from

package/esm/contracts/query-builder.contract.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"query-builder.contract.d.mts","names":[],"sources":["../../../../../../../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;;KAwBY,oBAAA;EArBR;;;;;EA2BF,UAAA;EA1BE;;;AAAY;EA+Bd,MAAM;AAAA;;;;;;;;;;;AAvB0C;AAKlD;;;;AAA2C;AAO3C;KA+BY,WAAA;wDAEV,KAAA,WAtBM;EAwBN,QAAA,cAJqB;EAMrB,QAAA,cANqB;EAQrB,MAAA;AAAA;;;;KAMU,aAAA;EAAA,4EAEV,0BAAA;EAEA,iBAAiB;AAAA;AAanB;;;;;;;;;;AAAA,KAAY,YAAA,MAAkB,CAAA;EAAY,IAAA;AAAA,IAAwB,OAAA,GAAU,CAAC;;;;;;;;UAS5D,oBAAA;EA6DmB;;;EAzDlC,KAAA;EAoEuB;;;;EA/DvB,OAAA,CAAQ,QAAA,GAAW,IAAA,OAAW,KAAA;EA+HR;;;;;EAxHtB,UAAA,CAAW,QAAA,GAAW,KAAA,kBAAuB,OAAA;EAsPtB;;;;;EA/OvB,WAAA,CAAY,QAAA,GAAW,OAAA,SAAgB,OAAA,iBAAwB,OAAA;EA+RzB;;;;;EAxRtC,SAAA,CAAU,QAAA,GAAW,OAAA,SAAgB,OAAA,iBAAwB,OAAA;EA0Y5B;;;;;;;;;;;;;;EA1XjC,IAAA,IAAQ,oBAAA,CAAqB,YAAA,CAAa,CAAA;EA4gBC;;;EAvgB3C,MAAA;EA+lBkB;;;;EArlBlB,mBAAA,GAAsB,GAAA,SAAY,qBAAA;EA+nBZ;;;;EAznBtB,oBAAA,GAAuB,GAAA,SAAY,kBAAA;EA2qBtB;;;EAtqBb,oBAAA,GAAuB,GAAA;EA+rBuB;;;EA1rB9C,aAAA;EA+tBsC;;;;;;EAntBtC,kBAAA,GAAqB,GAAA,qBAAwB,KAAA,EAAO,oBAAA;EAq4BlC;;;;;;;;;;;EAx3BlB,cAAA,GAAiB,GAAA;IAmsCD,wFA/rCZ,QAAA,UAiuC6B;IA/tC7B,aAAA;EAAA;EAmzCY;;;;EA3yChB,aAAA,GAAgB,GAAA;IAGZ,KAAA;IACA,IAAA;IACA,KAAA;IACA,QAAA;IACA,UAAA;IACA,QAAA;IACA,UAAA;IACA,YAAA;IACA,WAAA;IACA,MAAA;EAAA;EAg9Ce;;;;EAx8CnB,mBAAA,GAAsB,MAAA;EAy9Ca;;;EAp9CnC,UAAA;EA49CkC;;;;;;;;;;;;;;;;;;;;;;;;;EAj8ClC,QAAA,IAAY,SAAA;EAomD0B;;;;;;;;;;;;;;;EAnlDtC,kBAAA,IAAsB,UAAA;EAhLd;;;;;;;;;;;EA6LR,mBAAA;EAxKqC;;;;;;;;;;;;;;;;EA0LrC,KAAA,CAAM,SAAA,aAAsB,IAAA;EA/H5B;;;;;;;;;;;;;;;;EAqJA,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;EAzG9B;;;;;;;;;;;EAsHA,QAAA,CAAS,UAAA,EAAY,aAAA,EAAe,QAAA;EAhB9B;;;;;;EAwBN,UAAA,CAAW,UAAA,EAAY,aAAA,EAAe,QAAA;EAtBtC;;;;;;EA8BA,WAAA,CAAY,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,MAAA;EAhBpD;;;;;;EAwBA,aAAA,CAAc,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,MAAA;EAhBhB;;;;;;;;;EA2BtC,YAAA,CAAa,WAAA,EAAa,KAAA,EAAO,IAAA,UAAc,QAAA,EAAU,aAAA,EAAe,KAAA;EAXlB;;;;;;EAmBtD,mBAAA,CAAoB,KAAA,UAAe,WAAA,UAAqB,WAAA;EAR3C;;;;;;EAgBb,SAAA,CAAU,KAAA,UAAe,KAAA,EAAO,IAAA;EAAA;;;EAKhC,eAAA,CAAgB,KAAA,UAAe,KAAA,EAAO,IAAA;EAAA;;;EAKtC,eAAA,CAAgB,KAAA,UAAe,KAAA,EAAO,IAAA;EAAA;;;EAKtC,cAAA,CAAe,KAAA,UAAe,KAAA,EAAO,IAAA;EAAA;;;;;;EAQrC,SAAA,CAAU,KAAA,UAAe,KAAA;EAKD;;;EAAxB,QAAA,CAAS,KAAA,UAAe,KAAA;EAUxB;;;EALA,UAAA,CAAW,KAAA,UAAe,KAAA;EAUR;;;EALlB,SAAA,CAAU,KAAA,UAAe,KAAA;EAUY;;;EALrC,iBAAA,CAAkB,IAAA,UAAc,KAAA;EAkBhB;;;EAbhB,sBAAA,CAAuB,IAAA,UAAc,KAAA;EAkBrC;;;EAbA,oBAAA,CAAqB,IAAA;EA0BrB;;;;;;EAlBA,eAAA,CAAgB,IAAA,UAAc,QAAA,EAAU,aAAA,EAAe,KAAA;EA4BvD;;;EAvBA,gBAAA,CAAiB,IAAA;EA4BP;;;EAvBV,iBAAA,CAAkB,IAAA;EAiCJ;;;;;;EAzBd,gBAAA,CAAiB,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAmC9B;;;EA9B3B,OAAA,CAAQ,KAAA;EAmCC;;;EA9BT,QAAA,CAAS,MAAA,EAAQ,KAAA;EAmCN;;;EA9BX,SAAA,CAAU,KAAA;EAuCE;;;EAlCZ,SAAA,CAAU,KAAA;EA2CK;;;EAtCf,aAAA,CAAc,MAAA,qBAA2B,KAAA;EA+CzC;;;EA1CA,eAAA,CAAgB,MAAA,qBAA2B,KAAA;EA0CK;;;EArChD,WAAA,CAAY,KAAA,UAAe,KAAA;EAuC3B;;;EAlCA,QAAA,CAAS,QAAA,EAAU,aAAA,CAAc,CAAA;EA0CjC;;;EArCA,UAAA,CAAW,QAAA,EAAU,aAAA,CAAc,CAAA;EA6CxB;;;;;;;EApCX,WAAA,CAAY,QAAA,EAAU,aAAA,CAAc,CAAA;EA4DR;;;;;;;EAnD5B,cAAA,CAAe,QAAA,EAAU,aAAA,CAAc,CAAA;EA2EvC;;;;;;EAnEA,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;EAwFlB;;;;;;EAhFd,OAAA,CAAQ,KAAA,UAAe,MAAA;EAgGiB;;;;;;EAxFxC,UAAA,CAAW,KAAA,UAAe,MAAA;EAgGS;;;;;;EAxFnC,SAAA,CAAU,KAAA;EAoHe;;;;;;EA5GzB,YAAA,CAAa,KAAA;EAqHuB;;;;;;EA7GpC,YAAA,CAAa,KAAA,UAAe,KAAA;EAkIN;;;;;;EA1HtB,eAAA,CAAgB,KAAA,UAAe,KAAA;EA0I/B;;;;;;EAlIA,SAAA,CAAU,KAAA,UAAe,OAAA,EAAS,MAAA;EA+InB;;;;;;EAvIf,YAAA,CAAa,KAAA,UAAe,OAAA;EAyIZ;;;;;;EAjIhB,eAAA,CAAgB,KAAA,UAAe,KAAA;EAiJM;;;;;;EAzIrC,kBAAA,CAAmB,KAAA,UAAe,KAAA;EAqJhC;;;;;;EA7IF,aAAA,CAAc,KAAA,UAAe,KAAA;EA+JhB;;;;;;EAvJb,gBAAA,CAAiB,KAAA,UAAe,KAAA;EA2KnB;;;;;;EAnKb,gBAAA,CAAiB,KAAA,UAAe,KAAA,GAAQ,IAAA,EAAM,IAAA;EA2L7B;;;;;;EAnLjB,mBAAA,CAAoB,KAAA,UAAe,KAAA,GAAQ,IAAA,EAAM,IAAA;EAqL/C;;;;;;EA7KF,WAAA,CAAY,KAAA;EAyLV;;;;;;EAjLF,cAAA,CAAe,KAAA;EAqMJ;;;;;;;;;;EAzLX,SAAA,CAAU,KAAA,UAAe,IAAA;EACzB,SAAA,CAAU,KAAA,UAAe,QAAA,iCAAyC,IAAA;EA6MrD;;;;;;EArMb,UAAA,CAAW,KAAA,UAAe,OAAA,GAAU,WAAA;EAyNpC;;;;;;;;;;;EA5MA,kBAAA,CAAmB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAsRlD;;;;;;EA9QA,qBAAA,CAAsB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAqSrD;;;;;;EA7RA,oBAAA,CAAqB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAoTpD;;;;;;EA5SA,wBAAA,CAAyB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAmUxD;;;;;;EAvTA,MAAA,CAAO,MAAA;EACP,MAAA,CAAO,MAAA,EAAQ,MAAA;EACf,MAAA,IAAU,MAAA,EAAQ,KAAA;EAClB,MAAA,IAAU,IAAA,EAAM,KAAA;EA0U4B;;;;;;EAlU5C,QAAA,CAAS,KAAA,UAAe,KAAA;EAqXJ;;;;;;EA7WpB,SAAA,CAAU,UAAA,EAAY,aAAA,EAAe,QAAA;EAwarC;;;;;;;;;EA7ZA,aAAA,CACE,WAAA,EAAa,KAAA;IACX,KAAA;IACA,UAAA,EAAY,aAAA;IACZ,QAAA;EAAA;EA+dJ;;;;;;EArdA,SAAA,CAAU,UAAA,EAAY,aAAA,EAAe,KAAA;EAigBrC;;;EA5fA,YAAA,CAAa,UAAA,EAAY,aAAA,EAAe,KAAA;EA+gBlB;;;;;;EAvgBtB,eAAA,CACE,KAAA,UACA,SAAA,8DACA,KAAA;EA8iBF;;;;;;EAriBA,YAAA,CAAa,KAAA,UAAe,KAAA;EAskB5B;;;;;;EA9jBA,WAAA,CAAY,KAAA,UAAe,KAAA;EA2kBQ;;;;;;;;;;;;;EA5jBnC,UAAA,CACE,KAAA,EAAO,KAAA;IAAQ,IAAA,EAAM,aAAA;IAAe,IAAA,EAAM,aAAA;EAAA,IAC1C,SAAA,EAAW,aAAA,YACX,KAAA;EA4lB+B;;;;;;EAnlBjC,UAAA,CACE,SAAA,EAAW,aAAA,EACX,SAAA,EAAW,aAAA,YACX,SAAA,EAAW,aAAA,YACX,KAAA;EAonBF;;;;;;;;EAzmBA,sBAAA,CAAuB,QAAA,GAAW,UAAA,EAAY,MAAA;EA2oBtB;;;;;;EAnoBxB,UAAA,CAAW,IAAA,UAAc,KAAA;EAqrBiB;;;;;;EA7qB1C,aAAA,CAAc,IAAA,UAAc,UAAA,EAAY,aAAA,EAAe,KAAA;EA4sBzB;;;EAvsB9B,YAAA,CAAa,IAAA;EAgtBF;;;;;;EAxsBX,YAAA,CAAa,MAAA,EAAQ,KAAA,UAAe,aAAA,GAAgB,KAAA;EAitBpB;;;;;;EAzsBhC,cAAA,CAAe,MAAA,EAAQ,KAAA,UAAe,aAAA,GAAgB,KAAA;EAktBhC;;;;;;;;;;EAtsBtB,YAAA,CAAa,IAAA,EAAM,aAAA;EA8uBT;;;;;;EAtuBV,QAAA,CAAS,MAAA;EAgwBT;;;EA3vBA,WAAA;EA6vBa;;;EAxvBb,SAAA;EAyvBe;;;EApvBf,aAAA;EAiwBa;;;;;;;EAxvBb,cAAA,CAAe,MAAA;EAywBf;;;;;;EAjwBA,SAAA,CAAU,MAAA;EAywBI;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAvuBd,IAAA,CAAK,KAAA,UAAe,UAAA,UAAoB,YAAA;EACxC,IAAA,CAAK,OAAA,EAAS,WAAA;EAszBd;;;;;;;;;;;;;;;;;;;;EAhyBA,QAAA,CAAS,KAAA,UAAe,UAAA,UAAoB,YAAA;EAC5C,QAAA,CAAS,OAAA,EAAS,WAAA;EAi1BW;;;;;;;;;;;;;;;;;;;;EA3zB7B,SAAA,CAAU,KAAA,UAAe,UAAA,UAAoB,YAAA;EAC7C,SAAA,CAAU,OAAA,EAAS,WAAA;EAo2BuC;;;;;;;;;;;;;;;;;;;AA4FjB;EA16BzC,SAAA,CAAU,KAAA,UAAe,UAAA,UAAoB,YAAA;EAC7C,SAAA,CAAU,OAAA,EAAS,WAAA;;;;;;;;;;;;;;;;;;;;EAqBnB,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;;;;;;;;;;;;;;;;;EAkBL,aAAA,CAAc,OAAA,GAAU,oBAAA;;;;;;;EAQxB,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;;;;;;;;;;;;;;;;;;;EAoB1C,MAAA,CAAO,MAAA,EAAQ,MAAA,oBAA0B,OAAA;EAEzC,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;;;;;;;;;;;EAgB/C,MAAA,CAAO,KAAA,UAAe,OAAA,GAAU,aAAA;;;;;;;;;;EAWhC,SAAA,CAAU,MAAA,EAAQ,MAAA;AAAA"}
+{"version":3,"file":"query-builder.contract.d.mts","names":[],"sources":["../../../../../../../cascade/src/contracts/query-builder.contract.ts"],"mappings":"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"}

package/esm/data-source/data-source-registry.d.mts

@@ -18,7 +18,12 @@ type DataSourceRegistryListener = (dataSource: DataSource) => void;
 declare class DataSourceRegistry {
   private readonly sources;
   private defaultSource?;
+  private defaultIsExplicit;
   private readonly events;
+  /** Replaced sources; their forwarded driver events are ignored (drivers have no `off`). */
+  private readonly detached;
+  /** In-flight `getOrRegister` factories, so concurrent callers share one creation. */
+  private readonly pending;
   /**
    * Register a new data source definition.
    *
@@ -31,10 +36,37 @@ declare class DataSourceRegistry {
    * - `connected` - When the driver connects (forwarded from driver)
    * - `disconnected` - When the driver disconnects (forwarded from driver)
    *
+   * The first registered source becomes the default. Later sources become the default
+   * only when they explicitly claim it, and two explicit claims throw.
+   *
    * @param options - Data source configuration
+   * @param meta - `explicitDefault` tells whether the caller explicitly requested `isDefault: true`
+   *  (defaults to `options.isDefault`), as opposed to it being implied by being the first source.
+   *  `replace: true` also disconnects the previously registered source of the same name (in the
+   *  background). Either way the old source's events stop being forwarded and, if it was the
+   *  default, the new source takes its place.
    * @returns The registered data source instance
    */
-  register(options: DataSourceOptions): DataSource;
+  register(options: DataSourceOptions, meta?: {
+    explicitDefault?: boolean;
+    replace?: boolean;
+  }): DataSource;
+  /**
+   * Remove a registered source (only if it is still the one registered under its name).
+   * If it was the default, the registry has no default until another source claims it.
+   */
+  unregister(source: DataSource): void;
+  /**
+   * Return the registered source for `name`, or create and register it via `factory`.
+   *
+   * Concurrent callers for the same name share one in-flight factory call, so only one
+   * driver/pool is created. A failed factory is not cached.
+   */
+  getOrRegister(name: string, factory: () => DataSourceOptions | Promise<DataSourceOptions>): Promise<DataSource>;
+  /**
+   * Determine whether a default data source is already registered.
+   */
+  hasDefault(): boolean;
   /**
    * Clean up all data sources and default one
    */

package/esm/data-source/data-source-registry.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"data-source-registry.d.mts","names":[],"sources":["../../../../../../../cascade/src/data-source/data-source-registry.ts"],"mappings":";;;;;AAaA;;;;AAAmC;AASnC;KATY,uBAAA;;;AASoD;KAApD,0BAAA,IAA8B,UAAsB,EAAV,UAAU;;cAG1D,kBAAA;EAAA,iBACa,OAAA;EAAA,QACT,aAAA;EAAA,iBACS,MAAA;EAkFmC;;;;;;;;;;;;;;;EAjE7C,QAAA,CAAS,OAAA,EAAS,iBAAA,GAAoB,UAAA;EA+BtC;;;EAAA,KAAA;EAkC6C;;;;;;;;;;;;;;;;;;AA8Ed;AAKxC;;;;AAA0D;;;;;;EAnFjD,EAAA,CAAG,KAAA,EAAO,uBAAA,EAAyB,QAAA,EAAU,0BAAA;;;;;;;;;EAY7C,IAAA,CAAK,KAAA,EAAO,uBAAA,EAAyB,QAAA,EAAU,0BAAA;;;;;;;EAU/C,GAAA,CAAI,KAAA,EAAO,uBAAA,EAAyB,QAAA,EAAU,0BAAA;;EAK9C,GAAA,CAAI,IAAA,YAAgB,UAAA;;;;;;;;;;;;;;;;;EAmDpB,iBAAA,IAAqB,UAAA;AAAA;AAAA,cAKjB,kBAAA,EAAkB,kBAA2B"}
+{"version":3,"file":"data-source-registry.d.mts","names":[],"sources":["../../../../../../../cascade/src/data-source/data-source-registry.ts"],"mappings":";;;;;AAaA;;;;AAAmC;AASnC;KATY,uBAAA;;;AASoD;KAApD,0BAAA,IAA8B,UAAsB,EAAV,UAAU;;cAG1D,kBAAA;EAAA,iBACa,OAAA;EAAA,QACT,aAAA;EAAA,QACA,iBAAA;EAAA,iBACS,MAAA;EAiH4B;EAAA,iBA/G5B,QAAA;EAgHN;EAAA,iBA9GM,OAAA;EAoLA;;;;;;;;;;;;;;;;;;;;;;;EA3JV,QAAA,CACL,OAAA,EAAS,iBAAA,EACT,IAAA;IAAS,eAAA;IAA2B,OAAA;EAAA,IACnC,UAAA;EAgFD;;;;EAnBK,UAAA,CAAW,MAAA,EAAQ,UAAA;EAqBvB;;;;;;EAHI,aAAA,CACL,IAAA,UACA,OAAA,QAAe,iBAAA,GAAoB,OAAA,CAAQ,iBAAA,IAC1C,OAAA,CAAQ,UAAA;EAsEyC;;;EA3C7C,UAAA;EAuDK;;;EAhDL,KAAA;EA0DW;;;;;;;;;;AAwDoB;AAKxC;;;;AAA0D;;;;;;;;;;;;;;EAnFjD,EAAA,CAAG,KAAA,EAAO,uBAAA,EAAyB,QAAA,EAAU,0BAAA;;;;;;;;;EAY7C,IAAA,CAAK,KAAA,EAAO,uBAAA,EAAyB,QAAA,EAAU,0BAAA;;;;;;;EAU/C,GAAA,CAAI,KAAA,EAAO,uBAAA,EAAyB,QAAA,EAAU,0BAAA;;EAK9C,GAAA,CAAI,IAAA,YAAgB,UAAA;;;;;;;;;;;;;;;;;EAmDpB,iBAAA,IAAqB,UAAA;AAAA;AAAA,cAKjB,kBAAA,EAAkB,kBAA2B"}

package/esm/data-source/data-source-registry.mjs

@@ -8,7 +8,12 @@ import { EventEmitter } from "node:events";
 var DataSourceRegistry = class {
 	sources = /* @__PURE__ */ new Map();
 	defaultSource;
+	defaultIsExplicit = false;
 	events = new EventEmitter();
+	/** Replaced sources; their forwarded driver events are ignored (drivers have no `off`). */
+	detached = /* @__PURE__ */ new WeakSet();
+	/** In-flight `getOrRegister` factories, so concurrent callers share one creation. */
+	pending = /* @__PURE__ */ new Map();
 	/**
 	* Register a new data source definition.
 	*
@@ -21,30 +26,95 @@ var DataSourceRegistry = class {
 	* - `connected` - When the driver connects (forwarded from driver)
 	* - `disconnected` - When the driver disconnects (forwarded from driver)
 	*
+	* The first registered source becomes the default. Later sources become the default
+	* only when they explicitly claim it, and two explicit claims throw.
+	*
 	* @param options - Data source configuration
+	* @param meta - `explicitDefault` tells whether the caller explicitly requested `isDefault: true`
+	*  (defaults to `options.isDefault`), as opposed to it being implied by being the first source.
+	*  `replace: true` also disconnects the previously registered source of the same name (in the
+	*  background). Either way the old source's events stop being forwarded and, if it was the
+	*  default, the new source takes its place.
 	* @returns The registered data source instance
 	*/
-	register(options) {
+	register(options, meta) {
 		const source = new DataSource(options);
+		const explicitDefault = meta?.explicitDefault ?? source.isDefault;
+		if (explicitDefault && this.defaultIsExplicit && this.defaultSource && this.defaultSource.name !== source.name) throw new Error(`Data source "${source.name}" cannot be the default: "${this.defaultSource.name}" is already the default data source.`);
+		const previous = this.sources.get(source.name);
 		this.sources.set(source.name, source);
-		const isNewDefault = source.isDefault || !this.defaultSource;
-		if (isNewDefault) this.defaultSource = source;
+		if (previous) {
+			this.detached.add(previous);
+			if (meta?.replace) previous.driver.disconnect().catch(() => void 0);
+		}
+		const replacesDefault = previous !== void 0 && previous === this.defaultSource;
+		const isNewDefault = explicitDefault || !this.defaultSource || replacesDefault;
+		if (isNewDefault) {
+			this.defaultSource = source;
+			this.defaultIsExplicit = replacesDefault ? this.defaultIsExplicit || explicitDefault : explicitDefault;
+		}
 		this.events.emit("registered", source);
 		if (isNewDefault) this.events.emit("default-registered", source);
 		source.driver.on("connected", () => {
-			this.events.emit("connected", source);
+			if (!this.detached.has(source)) this.events.emit("connected", source);
 		});
 		source.driver.on("disconnected", () => {
-			this.events.emit("disconnected", source);
+			if (!this.detached.has(source)) this.events.emit("disconnected", source);
 		});
 		return source;
 	}
 	/**
+	* Remove a registered source (only if it is still the one registered under its name).
+	* If it was the default, the registry has no default until another source claims it.
+	*/
+	unregister(source) {
+		if (this.sources.get(source.name) !== source) return;
+		this.sources.delete(source.name);
+		this.detached.add(source);
+		if (this.defaultSource === source) {
+			this.defaultSource = void 0;
+			this.defaultIsExplicit = false;
+		}
+	}
+	/**
+	* Return the registered source for `name`, or create and register it via `factory`.
+	*
+	* Concurrent callers for the same name share one in-flight factory call, so only one
+	* driver/pool is created. A failed factory is not cached.
+	*/
+	getOrRegister(name, factory) {
+		const existing = this.sources.get(name);
+		if (existing) return Promise.resolve(existing);
+		const inFlight = this.pending.get(name);
+		if (inFlight) return inFlight;
+		const promise = (async () => {
+			try {
+				const options = await factory();
+				return this.sources.get(name) ?? this.register({
+					...options,
+					name
+				});
+			} finally {
+				this.pending.delete(name);
+			}
+		})();
+		this.pending.set(name, promise);
+		return promise;
+	}
+	/**
+	* Determine whether a default data source is already registered.
+	*/
+	hasDefault() {
+		return this.defaultSource !== void 0;
+	}
+	/**
 	* Clean up all data sources and default one
 	*/
 	clear() {
 		this.defaultSource = void 0;
+		this.defaultIsExplicit = false;
 		this.sources.clear();
+		this.pending.clear();
 	}
 	/**
 	* Listen for data source registry events.

package/esm/data-source/data-source-registry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"data-source-registry.mjs","names":[],"sources":["../../../../../../../cascade/src/data-source/data-source-registry.ts"],"sourcesContent":["import { EventEmitter } from \"node:events\";\nimport { databaseDataSourceContext } from \"../context/database-data-source-context\";\nimport { MissingDataSourceError } from \"../errors/missing-data-source.error\";\nimport { DataSource, type DataSourceOptions } from \"./data-source\";\n\n/**\n * Event types emitted by the DataSourceRegistry.\n *\n * - `registered`: Emitted when any data source is registered\n * - `default-registered`: Emitted when a default data source is registered\n * - `connected`: Emitted when a data source's driver connects\n * - `disconnected`: Emitted when a data source's driver disconnects\n */\nexport type DataSourceRegistryEvent =\n  | \"registered\"\n  | \"default-registered\"\n  | \"connected\"\n  | \"disconnected\";\n\n/**\n * Callback signature for registry events.\n */\nexport type DataSourceRegistryListener = (dataSource: DataSource) => void;\n\n/** Maintains registry of named data sources. */\nclass DataSourceRegistry {\n  private readonly sources = new Map<string, DataSource>();\n  private defaultSource?: DataSource;\n  private readonly events = new EventEmitter();\n\n  /**\n   * Register a new data source definition.\n   *\n   * Sets up event forwarding from the driver to the registry, allowing\n   * centralized listening for connection state changes.\n   *\n   * **Emits:**\n   * - `registered` - When the data source is registered\n   * - `default-registered` - If this becomes the default data source\n   * - `connected` - When the driver connects (forwarded from driver)\n   * - `disconnected` - When the driver disconnects (forwarded from driver)\n   *\n   * @param options - Data source configuration\n   * @returns The registered data source instance\n   */\n  public register(options: DataSourceOptions): DataSource {\n    const source = new DataSource(options);\n    this.sources.set(source.name, source);\n\n    const isNewDefault = source.isDefault || !this.defaultSource;\n\n    if (isNewDefault) {\n      this.defaultSource = source;\n    }\n\n    // Emit registration events\n    this.events.emit(\"registered\", source);\n\n    if (isNewDefault) {\n      this.events.emit(\"default-registered\", source);\n    }\n\n    source.driver.on(\"connected\", () => {\n      this.events.emit(\"connected\", source);\n    });\n\n    source.driver.on(\"disconnected\", () => {\n      this.events.emit(\"disconnected\", source);\n    });\n\n    return source;\n  }\n\n  /**\n   * Clean up all data sources and default one\n   */\n  public clear() {\n    this.defaultSource = undefined;\n    this.sources.clear();\n  }\n\n  /**\n   * Listen for data source registry events.\n   *\n   * @param event - The event to listen for\n   * @param listener - Callback to execute when event fires\n   *\n   * @example\n   * ```typescript\n   * // Listen for registration\n   * dataSourceRegistry.on(\"registered\", (ds) => {\n   *   console.log(`Data source \"${ds.name}\" registered`);\n   *   console.log(`Driver: ${ds.driver.name}`); // e.g., \"mongodb\"\n   * });\n   *\n   * // Listen for default data source\n   * dataSourceRegistry.on(\"default-registered\", (ds) => {\n   *   console.log(`Default data source set to \"${ds.name}\"`);\n   * });\n   *\n   * // Listen for connection events (forwarded from drivers)\n   * dataSourceRegistry.on(\"connected\", (ds) => {\n   *   console.log(`${ds.driver.name} data source \"${ds.name}\" connected`);\n   * });\n   *\n   * dataSourceRegistry.on(\"disconnected\", (ds) => {\n   *   console.log(`${ds.driver.name} data source \"${ds.name}\" disconnected`);\n   * });\n   * ```\n   */\n  public on(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void {\n    this.events.on(event, listener);\n  }\n\n  /**\n   * Listen for a data source registration event once.\n   *\n   * The listener is automatically removed after being called once.\n   *\n   * @param event - The event to listen for\n   * @param listener - Callback to execute when event fires\n   */\n  public once(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void {\n    this.events.once(event, listener);\n  }\n\n  /**\n   * Remove a listener for a data source registration event.\n   *\n   * @param event - The event to stop listening for\n   * @param listener - The listener to remove\n   */\n  public off(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void {\n    this.events.off(event, listener);\n  }\n\n  /** Retrieve a data source either by name or the default one. */\n  public get(name?: string): DataSource {\n    const contextSource = name == null ? databaseDataSourceContext.getDataSource() : null;\n\n    if (contextSource) {\n      if (contextSource instanceof DataSource) {\n        return contextSource;\n      }\n\n      const override = this.sources.get(contextSource);\n\n      if (!override) {\n        throw new MissingDataSourceError(\n          `Data source \"${contextSource}\" is not registered (context override).`,\n          contextSource,\n        );\n      }\n\n      return override;\n    }\n\n    if (name != null) {\n      const source = this.sources.get(name);\n      if (!source) {\n        throw new MissingDataSourceError(`Data source \"${name}\" is not registered.`, name);\n      }\n      return source;\n    }\n\n    if (!this.defaultSource) {\n      throw new MissingDataSourceError(\"No default data source registered.\");\n    }\n\n    return this.defaultSource;\n  }\n\n  /**\n   * Get all registered data sources.\n   *\n   * Useful for operations that need to iterate over all sources,\n   * such as shutting down all connections.\n   *\n   * @returns Array of all registered data sources\n   *\n   * @example\n   * ```typescript\n   * // Shutdown all data sources\n   * for (const dataSource of dataSourceRegistry.getAllDataSources()) {\n   *   await dataSource.driver.disconnect();\n   * }\n   * ```\n   */\n  public getAllDataSources(): DataSource[] {\n    return Array.from(this.sources.values());\n  }\n}\n\nexport const dataSourceRegistry = new DataSourceRegistry();\n"],"mappings":";;;;;;;AAyBA,IAAM,qBAAN,MAAyB;CACvB,AAAiB,0BAAU,IAAI,IAAwB;CACvD,AAAQ;CACR,AAAiB,SAAS,IAAI,aAAa;;;;;;;;;;;;;;;;CAiB3C,AAAO,SAAS,SAAwC;EACtD,MAAM,SAAS,IAAI,WAAW,OAAO;EACrC,KAAK,QAAQ,IAAI,OAAO,MAAM,MAAM;EAEpC,MAAM,eAAe,OAAO,aAAa,CAAC,KAAK;EAE/C,IAAI,cACF,KAAK,gBAAgB;EAIvB,KAAK,OAAO,KAAK,cAAc,MAAM;EAErC,IAAI,cACF,KAAK,OAAO,KAAK,sBAAsB,MAAM;EAG/C,OAAO,OAAO,GAAG,mBAAmB;GAClC,KAAK,OAAO,KAAK,aAAa,MAAM;EACtC,CAAC;EAED,OAAO,OAAO,GAAG,sBAAsB;GACrC,KAAK,OAAO,KAAK,gBAAgB,MAAM;EACzC,CAAC;EAED,OAAO;CACT;;;;CAKA,AAAO,QAAQ;EACb,KAAK,gBAAgB;EACrB,KAAK,QAAQ,MAAM;CACrB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BA,AAAO,GAAG,OAAgC,UAA4C;EACpF,KAAK,OAAO,GAAG,OAAO,QAAQ;CAChC;;;;;;;;;CAUA,AAAO,KAAK,OAAgC,UAA4C;EACtF,KAAK,OAAO,KAAK,OAAO,QAAQ;CAClC;;;;;;;CAQA,AAAO,IAAI,OAAgC,UAA4C;EACrF,KAAK,OAAO,IAAI,OAAO,QAAQ;CACjC;;CAGA,AAAO,IAAI,MAA2B;EACpC,MAAM,gBAAgB,QAAQ,OAAO,0BAA0B,cAAc,IAAI;EAEjF,IAAI,eAAe;GACjB,IAAI,yBAAyB,YAC3B,OAAO;GAGT,MAAM,WAAW,KAAK,QAAQ,IAAI,aAAa;GAE/C,IAAI,CAAC,UACH,MAAM,IAAI,uBACR,gBAAgB,cAAc,0CAC9B,aACF;GAGF,OAAO;EACT;EAEA,IAAI,QAAQ,MAAM;GAChB,MAAM,SAAS,KAAK,QAAQ,IAAI,IAAI;GACpC,IAAI,CAAC,QACH,MAAM,IAAI,uBAAuB,gBAAgB,KAAK,uBAAuB,IAAI;GAEnF,OAAO;EACT;EAEA,IAAI,CAAC,KAAK,eACR,MAAM,IAAI,uBAAuB,oCAAoC;EAGvE,OAAO,KAAK;CACd;;;;;;;;;;;;;;;;;CAkBA,AAAO,oBAAkC;EACvC,OAAO,MAAM,KAAK,KAAK,QAAQ,OAAO,CAAC;CACzC;AACF;AAEA,MAAa,qBAAqB,IAAI,mBAAmB"}
+{"version":3,"file":"data-source-registry.mjs","names":[],"sources":["../../../../../../../cascade/src/data-source/data-source-registry.ts"],"sourcesContent":["import { EventEmitter } from \"node:events\";\nimport { databaseDataSourceContext } from \"../context/database-data-source-context\";\nimport { MissingDataSourceError } from \"../errors/missing-data-source.error\";\nimport { DataSource, type DataSourceOptions } from \"./data-source\";\n\n/**\n * Event types emitted by the DataSourceRegistry.\n *\n * - `registered`: Emitted when any data source is registered\n * - `default-registered`: Emitted when a default data source is registered\n * - `connected`: Emitted when a data source's driver connects\n * - `disconnected`: Emitted when a data source's driver disconnects\n */\nexport type DataSourceRegistryEvent =\n  | \"registered\"\n  | \"default-registered\"\n  | \"connected\"\n  | \"disconnected\";\n\n/**\n * Callback signature for registry events.\n */\nexport type DataSourceRegistryListener = (dataSource: DataSource) => void;\n\n/** Maintains registry of named data sources. */\nclass DataSourceRegistry {\n  private readonly sources = new Map<string, DataSource>();\n  private defaultSource?: DataSource;\n  private defaultIsExplicit = false;\n  private readonly events = new EventEmitter();\n  /** Replaced sources; their forwarded driver events are ignored (drivers have no `off`). */\n  private readonly detached = new WeakSet<DataSource>();\n  /** In-flight `getOrRegister` factories, so concurrent callers share one creation. */\n  private readonly pending = new Map<string, Promise<DataSource>>();\n\n  /**\n   * Register a new data source definition.\n   *\n   * Sets up event forwarding from the driver to the registry, allowing\n   * centralized listening for connection state changes.\n   *\n   * **Emits:**\n   * - `registered` - When the data source is registered\n   * - `default-registered` - If this becomes the default data source\n   * - `connected` - When the driver connects (forwarded from driver)\n   * - `disconnected` - When the driver disconnects (forwarded from driver)\n   *\n   * The first registered source becomes the default. Later sources become the default\n   * only when they explicitly claim it, and two explicit claims throw.\n   *\n   * @param options - Data source configuration\n   * @param meta - `explicitDefault` tells whether the caller explicitly requested `isDefault: true`\n   *  (defaults to `options.isDefault`), as opposed to it being implied by being the first source.\n   *  `replace: true` also disconnects the previously registered source of the same name (in the\n   *  background). Either way the old source's events stop being forwarded and, if it was the\n   *  default, the new source takes its place.\n   * @returns The registered data source instance\n   */\n  public register(\n    options: DataSourceOptions,\n    meta?: { explicitDefault?: boolean; replace?: boolean },\n  ): DataSource {\n    const source = new DataSource(options);\n    const explicitDefault = meta?.explicitDefault ?? source.isDefault;\n\n    if (\n      explicitDefault &&\n      this.defaultIsExplicit &&\n      this.defaultSource &&\n      this.defaultSource.name !== source.name\n    ) {\n      throw new Error(\n        `Data source \"${source.name}\" cannot be the default: \"${this.defaultSource.name}\" is already the default data source.`,\n      );\n    }\n\n    const previous = this.sources.get(source.name);\n\n    this.sources.set(source.name, source);\n\n    if (previous) {\n      this.detached.add(previous);\n\n      if (meta?.replace) {\n        previous.driver.disconnect().catch(() => undefined);\n      }\n    }\n\n    // A replaced default hands the default over to its replacement, otherwise get()\n    // would keep returning the stale source.\n    const replacesDefault = previous !== undefined && previous === this.defaultSource;\n    const isNewDefault = explicitDefault || !this.defaultSource || replacesDefault;\n\n    if (isNewDefault) {\n      this.defaultSource = source;\n      this.defaultIsExplicit = replacesDefault\n        ? this.defaultIsExplicit || explicitDefault\n        : explicitDefault;\n    }\n\n    // Emit registration events\n    this.events.emit(\"registered\", source);\n\n    if (isNewDefault) {\n      this.events.emit(\"default-registered\", source);\n    }\n\n    source.driver.on(\"connected\", () => {\n      if (!this.detached.has(source)) this.events.emit(\"connected\", source);\n    });\n\n    source.driver.on(\"disconnected\", () => {\n      if (!this.detached.has(source)) this.events.emit(\"disconnected\", source);\n    });\n\n    return source;\n  }\n\n  /**\n   * Remove a registered source (only if it is still the one registered under its name).\n   * If it was the default, the registry has no default until another source claims it.\n   */\n  public unregister(source: DataSource): void {\n    if (this.sources.get(source.name) !== source) return;\n\n    this.sources.delete(source.name);\n    this.detached.add(source);\n\n    if (this.defaultSource === source) {\n      this.defaultSource = undefined;\n      this.defaultIsExplicit = false;\n    }\n  }\n\n  /**\n   * Return the registered source for `name`, or create and register it via `factory`.\n   *\n   * Concurrent callers for the same name share one in-flight factory call, so only one\n   * driver/pool is created. A failed factory is not cached.\n   */\n  public getOrRegister(\n    name: string,\n    factory: () => DataSourceOptions | Promise<DataSourceOptions>,\n  ): Promise<DataSource> {\n    const existing = this.sources.get(name);\n\n    if (existing) return Promise.resolve(existing);\n\n    const inFlight = this.pending.get(name);\n\n    if (inFlight) return inFlight;\n\n    const promise = (async () => {\n      try {\n        const options = await factory();\n\n        return this.sources.get(name) ?? this.register({ ...options, name });\n      } finally {\n        this.pending.delete(name);\n      }\n    })();\n\n    this.pending.set(name, promise);\n\n    return promise;\n  }\n\n  /**\n   * Determine whether a default data source is already registered.\n   */\n  public hasDefault(): boolean {\n    return this.defaultSource !== undefined;\n  }\n\n  /**\n   * Clean up all data sources and default one\n   */\n  public clear() {\n    this.defaultSource = undefined;\n    this.defaultIsExplicit = false;\n    this.sources.clear();\n    this.pending.clear();\n  }\n\n  /**\n   * Listen for data source registry events.\n   *\n   * @param event - The event to listen for\n   * @param listener - Callback to execute when event fires\n   *\n   * @example\n   * ```typescript\n   * // Listen for registration\n   * dataSourceRegistry.on(\"registered\", (ds) => {\n   *   console.log(`Data source \"${ds.name}\" registered`);\n   *   console.log(`Driver: ${ds.driver.name}`); // e.g., \"mongodb\"\n   * });\n   *\n   * // Listen for default data source\n   * dataSourceRegistry.on(\"default-registered\", (ds) => {\n   *   console.log(`Default data source set to \"${ds.name}\"`);\n   * });\n   *\n   * // Listen for connection events (forwarded from drivers)\n   * dataSourceRegistry.on(\"connected\", (ds) => {\n   *   console.log(`${ds.driver.name} data source \"${ds.name}\" connected`);\n   * });\n   *\n   * dataSourceRegistry.on(\"disconnected\", (ds) => {\n   *   console.log(`${ds.driver.name} data source \"${ds.name}\" disconnected`);\n   * });\n   * ```\n   */\n  public on(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void {\n    this.events.on(event, listener);\n  }\n\n  /**\n   * Listen for a data source registration event once.\n   *\n   * The listener is automatically removed after being called once.\n   *\n   * @param event - The event to listen for\n   * @param listener - Callback to execute when event fires\n   */\n  public once(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void {\n    this.events.once(event, listener);\n  }\n\n  /**\n   * Remove a listener for a data source registration event.\n   *\n   * @param event - The event to stop listening for\n   * @param listener - The listener to remove\n   */\n  public off(event: DataSourceRegistryEvent, listener: DataSourceRegistryListener): void {\n    this.events.off(event, listener);\n  }\n\n  /** Retrieve a data source either by name or the default one. */\n  public get(name?: string): DataSource {\n    const contextSource = name == null ? databaseDataSourceContext.getDataSource() : null;\n\n    if (contextSource) {\n      if (contextSource instanceof DataSource) {\n        return contextSource;\n      }\n\n      const override = this.sources.get(contextSource);\n\n      if (!override) {\n        throw new MissingDataSourceError(\n          `Data source \"${contextSource}\" is not registered (context override).`,\n          contextSource,\n        );\n      }\n\n      return override;\n    }\n\n    if (name != null) {\n      const source = this.sources.get(name);\n      if (!source) {\n        throw new MissingDataSourceError(`Data source \"${name}\" is not registered.`, name);\n      }\n      return source;\n    }\n\n    if (!this.defaultSource) {\n      throw new MissingDataSourceError(\"No default data source registered.\");\n    }\n\n    return this.defaultSource;\n  }\n\n  /**\n   * Get all registered data sources.\n   *\n   * Useful for operations that need to iterate over all sources,\n   * such as shutting down all connections.\n   *\n   * @returns Array of all registered data sources\n   *\n   * @example\n   * ```typescript\n   * // Shutdown all data sources\n   * for (const dataSource of dataSourceRegistry.getAllDataSources()) {\n   *   await dataSource.driver.disconnect();\n   * }\n   * ```\n   */\n  public getAllDataSources(): DataSource[] {\n    return Array.from(this.sources.values());\n  }\n}\n\nexport const dataSourceRegistry = new DataSourceRegistry();\n"],"mappings":"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"}

package/esm/database-dirty-tracker.d.mts

@@ -156,6 +156,11 @@ declare class DatabaseDirtyTracker {
    * ```
    */
   mergeChanges(partial: Record<string, unknown>): void;
+  /**
+   * Replaces the value at a dot-notation path (no deep merge), mirroring
+   * `model.set()` so stale nested keys are detected as removed.
+   */
+  setAtPath(path: string, value: unknown): void;
   /**
    * Explicitly removes one or more columns from the current data.
    *

package/esm/database-dirty-tracker.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"database-dirty-tracker.d.mts","names":[],"sources":["../../../../../../cascade/src/database-dirty-tracker.ts"],"mappings":";;;;KA+CK,UAAA,GAAa,MAAM;;AAAA;AAAA;KAKnB,iBAAA;EAAsB,QAAA;EAAmB,QAAQ;AAAA;AAkBtD;;;;;;;;;;;;;;;;AAAA,cAAa,oBAAA;EA8SoB;;;;EAAA,UAzSrB,UAAA,EAAY,MAAA;EAqYY;;;EAAA,UAhYxB,UAAA,EAAY,MAAA;EAAA;;;;EAAA,UAMZ,gBAAA,EAAkB,UAAA;EAUT;;;EAAA,UALT,gBAAA,EAAkB,UAAA;;;;qBAKT,YAAA,EAAY,GAAA;EAmDxB;;;EAAA,mBA9CY,cAAA,EAAc,GAAA;cAEd,IAAA,EAAM,MAAA;EA0FW;;;;;;;;;;;;;EAnE7B,eAAA;EA4LqB;;;;;;;;;;;;;;;;;EAvKrB,UAAA;EA6T0B;;AAAC;EAtT3B,OAAA,CAAQ,MAAA;;;;;;;;;;;;;;;;EAmBR,iBAAA;;;;;;;;;;;;;;;;;EAoBA,yBAAA,IAA6B,MAAA,SAAe,iBAAA;;;;;;;;;;;;;;;;EA+B5C,kBAAA,CAAmB,IAAA,EAAM,MAAA;;;;;;;;;;;;;;;;;EAsBzB,YAAA,CAAa,OAAA,EAAS,MAAA;;;;;;;;;;;;;;;;EAqBtB,KAAA,CAAM,OAAA;;;;;;;;;;;;;;;;;;;;;EA+BN,KAAA,CAAM,IAAA,GAAO,MAAA;;;;;YAgBV,WAAA,CAAY,IAAA,EAAM,MAAA,oBAA0B,UAAA;;;;;;;;;;YAa5C,gBAAA;;;;;;;;;;;;;;;;;;;;YA6CA,YAAA,CAAa,MAAA,EAAQ,MAAA,mBAAyB,MAAA,EAAQ,MAAA;;;;;;;;;;YAoBtD,aAAA,CAAc,IAAA;;;;;;;;;;;YAgDd,cAAA,CAAe,SAAA,WAAoB,OAAA;;;;;;;;YAwBnC,SAAA,IAAa,IAAA,EAAM,CAAA,GAAI,CAAA;AAAA"}
+{"version":3,"file":"database-dirty-tracker.d.mts","names":[],"sources":["../../../../../../cascade/src/database-dirty-tracker.ts"],"mappings":";;;;KA+CK,UAAA,GAAa,MAAM;;AAAA;AAAA;KAKnB,iBAAA;EAAsB,QAAA;EAAmB,QAAQ;AAAA;AAkBtD;;;;;;;;;;;;;;;;AAAA,cAAa,oBAAA;EAqUoB;;;;EAAA,UAhUrB,UAAA,EAAY,MAAA;EA4ZY;;;EAAA,UAvZxB,UAAA,EAAY,MAAA;EAAA;;;;EAAA,UAMZ,gBAAA,EAAkB,UAAA;EAUT;;;EAAA,UALT,gBAAA,EAAkB,UAAA;;;;qBAKT,YAAA,EAAY,GAAA;EAmDxB;;;EAAA,mBA9CY,cAAA,EAAc,GAAA;cAEd,IAAA,EAAM,MAAA;EA0FW;;;;;;;;;;;;;EAnE7B,eAAA;EAmMa;;;;;;;;;;;;;;;;;EA9Kb,UAAA;EAoVa;;;EA7Ub,OAAA,CAAQ,MAAA;EA6UmB;AAAA;;;;;;;;;;;;;;EA1T3B,iBAAA;;;;;;;;;;;;;;;;;EAoBA,yBAAA,IAA6B,MAAA,SAAe,iBAAA;;;;;;;;;;;;;;;;EA+B5C,kBAAA,CAAmB,IAAA,EAAM,MAAA;;;;;;;;;;;;;;;;;EAsBzB,YAAA,CAAa,OAAA,EAAS,MAAA;;;;;EAUtB,SAAA,CAAU,IAAA,UAAc,KAAA;;;;;;;;;;;;;;;;EAkCxB,KAAA,CAAM,OAAA;;;;;;;;;;;;;;;;;;;;;EA+BN,KAAA,CAAM,IAAA,GAAO,MAAA;;;;;YAgBV,WAAA,CAAY,IAAA,EAAM,MAAA,oBAA0B,UAAA;;;;;;;;;;YAa5C,gBAAA;;;;;;;;;;;;;;;;;;;;YA6CA,YAAA,CAAa,MAAA,EAAQ,MAAA,mBAAyB,MAAA,EAAQ,MAAA;;;;;;;;;;YAoBtD,aAAA,CAAc,IAAA;;;;;;;;;;;YAgDd,cAAA,CAAe,SAAA,WAAoB,OAAA;;;;;;;;YAwBnC,SAAA,IAAa,IAAA,EAAM,CAAA,GAAI,CAAA;AAAA"}

package/esm/database-dirty-tracker.mjs

@@ -200,6 +200,22 @@ var DatabaseDirtyTracker = class {
 		this.updateDirtyState();
 	}
 	/**
+	* Replaces the value at a dot-notation path (no deep merge), mirroring
+	* `model.set()` so stale nested keys are detected as removed.
+	*/
+	setAtPath(path, value) {
+		const segments = path.split(".");
+		let container = this.currentRaw;
+		for (let index = 0; index < segments.length - 1; index += 1) {
+			const segment = segments[index];
+			if (!isPlainObject(container[segment]) && !Array.isArray(container[segment])) container[segment] = {};
+			container = container[segment];
+		}
+		container[segments[segments.length - 1]] = this.cloneData(value);
+		this.currentFlattened = this.flattenData(this.currentRaw);
+		this.updateDirtyState();
+	}
+	/**
 	* Explicitly removes one or more columns from the current data.
 	*
 	* Supports both single column names and arrays of column names.

package/esm/database-dirty-tracker.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"database-dirty-tracker.mjs","names":[],"sources":["../../../../../../cascade/src/database-dirty-tracker.ts"],"sourcesContent":["import { areEqual, clone } from \"@mongez/reinforcements\";\r\nimport { isPlainObject } from \"@mongez/supportive-is\";\r\n\r\nfunction canBeFlatten(object: unknown): boolean {\r\n  return isPlainObject(object);\r\n}\r\n\r\n/**\r\n * A fix for flatten as non-plain object is being flatten as well which it should not be\r\n */\r\nfunction flatten(\r\n  object: Record<string, unknown>,\r\n  separator = \".\",\r\n  keepNestedOriginalObject = false,\r\n  parent?: string,\r\n  root: Record<string, unknown> = {},\r\n) {\r\n  if (canBeFlatten(object) === false) {\r\n    return object;\r\n  }\r\n  // object = toPlainObject(object);\r\n  for (const key of Object.keys(object)) {\r\n    const value = object[key];\r\n    const keyChain = parent ? parent + separator + key : key;\r\n    if ((Array.isArray(value) && value.length === 0) || typeof value === \"function\") {\r\n      root[keyChain] = value;\r\n    } else if (canBeFlatten(value)) {\r\n      if (keepNestedOriginalObject) {\r\n        root[keyChain] = value;\r\n      }\r\n      flatten(\r\n        value as Record<string, unknown>,\r\n        separator,\r\n        keepNestedOriginalObject,\r\n        keyChain,\r\n        root,\r\n      );\r\n    } else {\r\n      root[keyChain] = value;\r\n    }\r\n  }\r\n  return root;\r\n}\r\n\r\n/**\r\n * Flattened record type representing dot-notation paths mapped to their values.\r\n */\r\ntype FlatRecord = Record<string, unknown>;\r\n\r\n/**\r\n * Represents the old and new values of a dirty column.\r\n */\r\ntype DirtyColumnValues = { oldValue: unknown; newValue: unknown };\r\n\r\n/**\r\n * Tracks changes to model data by maintaining snapshots of initial and current state.\r\n *\r\n * The tracker stores both raw (nested) and flattened (dot-notation) versions of the data\r\n * to accurately detect modifications, additions, and removals at any nesting level.\r\n *\r\n * @example\r\n * ```typescript\r\n * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", age: 30 });\r\n * tracker.mergeChanges({ age: 31 });\r\n * console.log(tracker.hasChanges()); // true\r\n * console.log(tracker.getDirtyColumns()); // [\"age\"]\r\n * console.log(tracker.getDirtyColumnsWithValues());\r\n * // { age: { oldValue: 30, newValue: 31 } }\r\n * ```\r\n */\r\nexport class DatabaseDirtyTracker {\r\n  /**\r\n   * The initial raw data snapshot taken at construction or last reset.\r\n   * Used as the baseline for comparison.\r\n   */\r\n  protected initialRaw: Record<string, unknown>;\r\n\r\n  /**\r\n   * The current raw data snapshot reflecting all changes made via merge/unset.\r\n   */\r\n  protected currentRaw: Record<string, unknown>;\r\n\r\n  /**\r\n   * Flattened version of the initial data using dot-notation keys.\r\n   * Example: { \"address.city\": \"NYC\" }\r\n   */\r\n  protected initialFlattened: FlatRecord;\r\n\r\n  /**\r\n   * Flattened version of the current data using dot-notation keys.\r\n   */\r\n  protected currentFlattened: FlatRecord;\r\n\r\n  /**\r\n   * Set of column names (dot-notation paths) that have been modified.\r\n   */\r\n  protected readonly dirtyColumns = new Set<string>();\r\n\r\n  /**\r\n   * Set of column names (dot-notation paths) that existed initially but have been removed.\r\n   */\r\n  protected readonly removedColumns = new Set<string>();\r\n\r\n  public constructor(data: Record<string, unknown>) {\r\n    this.initialRaw = this.cloneData(data);\r\n    this.currentRaw = this.cloneData(data);\r\n\r\n    this.initialFlattened = this.flattenData(this.initialRaw);\r\n    this.currentFlattened = { ...this.initialFlattened };\r\n\r\n    this.updateDirtyState();\r\n  }\r\n\r\n  /**\r\n   * Returns the list of dirty columns using dot-notation.\r\n   *\r\n   * A column is considered dirty if its value has changed compared to the initial snapshot.\r\n   *\r\n   * @returns An array of column names (dot-notation paths) that have been modified\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * tracker.mergeChanges({ name: \"Bob\", \"address.city\": \"LA\" });\r\n   * tracker.getDirtyColumns(); // [\"name\", \"address.city\"]\r\n   * ```\r\n   */\r\n  public getDirtyColumns(): string[] {\r\n    return Array.from(this.dirtyColumns);\r\n  }\r\n\r\n  /**\r\n   * Determines whether there are any tracked changes.\r\n   *\r\n   * Returns `true` if any columns have been modified or removed since the initial snapshot.\r\n   *\r\n   * @returns `true` if there are changes, `false` otherwise\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\r\n   * tracker.hasChanges(); // false\r\n   * tracker.mergeChanges({ name: \"Bob\" });\r\n   * tracker.hasChanges(); // true\r\n   * tracker.unset(\"name\");\r\n   * tracker.hasChanges(); // true (removed column counts as a change)\r\n   * ```\r\n   */\r\n  public hasChanges(): boolean {\r\n    return this.dirtyColumns.size > 0 || this.removedColumns.size > 0;\r\n  }\r\n\r\n  /**\r\n   * Check if the given column is dirty (changed)\r\n   */\r\n  public isDirty(column: string): boolean {\r\n    return this.dirtyColumns.has(column);\r\n  }\r\n\r\n  /**\r\n   * Returns the set of columns that have been removed compared to the baseline.\r\n   *\r\n   * A column is considered removed if it existed in the initial snapshot but has been\r\n   * explicitly unset or deleted from the current data.\r\n   *\r\n   * @returns An array of column names (dot-notation paths) that have been removed\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", temp: \"value\" });\r\n   * tracker.unset(\"temp\");\r\n   * tracker.getRemovedColumns(); // [\"temp\"]\r\n   * ```\r\n   */\r\n  public getRemovedColumns(): string[] {\r\n    return Array.from(this.removedColumns);\r\n  }\r\n\r\n  /**\r\n   * Provides a mapping of dirty columns to their previous and current values.\r\n   *\r\n   * This is useful for generating audit logs, building partial update payloads,\r\n   * or displaying change summaries to users.\r\n   *\r\n   * @returns A record mapping each dirty column to an object containing oldValue and newValue\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", age: 30 });\r\n   * tracker.mergeChanges({ age: 31 });\r\n   * tracker.getDirtyColumnsWithValues();\r\n   * // { age: { oldValue: 30, newValue: 31 } }\r\n   * ```\r\n   */\r\n  public getDirtyColumnsWithValues(): Record<string, DirtyColumnValues> {\r\n    const result: Record<string, DirtyColumnValues> = {};\r\n\r\n    for (const column of this.dirtyColumns) {\r\n      const hasCurrent =\r\n        this.currentFlattened[column] !== undefined || column in this.currentFlattened;\r\n\r\n      result[column] = {\r\n        oldValue: this.initialFlattened[column],\r\n        newValue: hasCurrent ? this.currentFlattened[column] : undefined,\r\n      };\r\n    }\r\n\r\n    return result;\r\n  }\r\n\r\n  /**\r\n   * Replaces the current data snapshot entirely and recomputes the diff.\r\n   *\r\n   * This is useful when you want to replace all current data with a new set,\r\n   * while keeping the initial baseline for comparison.\r\n   *\r\n   * @param data - The new data to set as the current snapshot\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\r\n   * tracker.replaceCurrentData({ name: \"Bob\", email: \"bob@example.com\" });\r\n   * tracker.getDirtyColumns(); // [\"name\", \"email\"]\r\n   * ```\r\n   */\r\n  public replaceCurrentData(data: Record<string, unknown>): void {\r\n    this.currentRaw = this.cloneData(data);\r\n    this.currentFlattened = this.flattenData(this.currentRaw);\r\n    this.updateDirtyState();\r\n  }\r\n\r\n  /**\r\n   * Merges a partial payload into the current snapshot and recomputes the diff.\r\n   *\r\n   * This performs a deep merge, preserving existing nested structures while\r\n   * updating only the specified fields.\r\n   *\r\n   * @param partial - Partial data to merge into the current snapshot\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", address: { city: \"NYC\" } });\r\n   * tracker.mergeChanges({ address: { zip: \"10001\" } });\r\n   * // Current data: { name: \"Alice\", address: { city: \"NYC\", zip: \"10001\" } }\r\n   * tracker.getDirtyColumns(); // [\"address.zip\"]\r\n   * ```\r\n   */\r\n  public mergeChanges(partial: Record<string, unknown>): void {\r\n    this.mergeIntoRaw(this.currentRaw, partial);\r\n    this.currentFlattened = this.flattenData(this.currentRaw);\r\n    this.updateDirtyState();\r\n  }\r\n\r\n  /**\r\n   * Explicitly removes one or more columns from the current data.\r\n   *\r\n   * Supports both single column names and arrays of column names.\r\n   * Columns can be specified using dot-notation for nested paths.\r\n   *\r\n   * @param columns - A single column name or an array of column names to remove\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * tracker.unset(\"tempField\");\r\n   * tracker.unset([\"field1\", \"field2\", \"nested.field\"]);\r\n   * tracker.getRemovedColumns(); // [\"tempField\", \"field1\", \"field2\", \"nested.field\"]\r\n   * ```\r\n   */\r\n  public unset(columns: string | string[]): void {\r\n    const targets = Array.isArray(columns) ? columns : [columns];\r\n\r\n    for (const path of targets) {\r\n      this.deleteFromRaw(path);\r\n    }\r\n\r\n    this.currentFlattened = this.flattenData(this.currentRaw);\r\n    this.updateDirtyState();\r\n  }\r\n\r\n  /**\r\n   * Resets both the initial and current snapshots to the provided data.\r\n   *\r\n   * If no data is provided, the current snapshot becomes the new baseline.\r\n   * This clears all tracked changes and removed columns.\r\n   *\r\n   * @param data - Optional new data to use as the baseline. If omitted, uses current data.\r\n   *\r\n   * @example\r\n   * ```typescript\r\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\r\n   * tracker.mergeChanges({ name: \"Bob\" });\r\n   * tracker.hasChanges(); // true\r\n   * tracker.reset(); // Make current state the new baseline\r\n   * tracker.hasChanges(); // false\r\n   *\r\n   * // Or reset to entirely new data:\r\n   * tracker.reset({ name: \"Charlie\", age: 25 });\r\n   * ```\r\n   */\r\n  public reset(data?: Record<string, unknown>): void {\r\n    const source = data ?? this.currentRaw;\r\n    this.initialRaw = this.cloneData(source);\r\n    this.currentRaw = this.cloneData(source);\r\n\r\n    this.initialFlattened = this.flattenData(this.initialRaw);\r\n    this.currentFlattened = this.flattenData(this.currentRaw);\r\n\r\n    this.dirtyColumns.clear();\r\n    this.removedColumns.clear();\r\n  }\r\n\r\n  /**\r\n   * Flattens the given data object.\r\n   * Can be overridden by subclasses to change flattening behavior.\r\n   */\r\n  protected flattenData(data: Record<string, unknown>): FlatRecord {\r\n    return flatten(data);\r\n  }\r\n\r\n  /**\r\n   * Recomputes the dirty and removed column sets by comparing initial and current snapshots.\r\n   *\r\n   * This method is called internally after any operation that modifies the current data.\r\n   * It iterates through all keys in both flattened snapshots and determines which columns\r\n   * have been modified or removed.\r\n   *\r\n   * @protected\r\n   */\r\n  protected updateDirtyState(): void {\r\n    this.dirtyColumns.clear();\r\n    this.removedColumns.clear();\r\n\r\n    const keys = new Set([\r\n      ...Object.keys(this.initialFlattened),\r\n      ...Object.keys(this.currentFlattened),\r\n    ]);\r\n\r\n    for (const key of keys) {\r\n      const hasCurrent = this.currentFlattened[key] !== undefined || key in this.currentFlattened;\r\n      const hasInitial = this.initialFlattened[key] !== undefined || key in this.initialFlattened;\r\n\r\n      if (!hasCurrent && hasInitial) {\r\n        this.removedColumns.add(key);\r\n      }\r\n\r\n      const initialValue = this.initialFlattened[key];\r\n      const currentValue = hasCurrent ? this.currentFlattened[key] : undefined;\r\n\r\n      if (!areEqual(initialValue, currentValue)) {\r\n        this.dirtyColumns.add(key);\r\n      }\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Recursively merges source object into target object, performing a deep merge.\r\n   *\r\n   * Only **plain** objects are merged recursively. Everything else — arrays,\r\n   * primitives, and class instances such as `Date` / `Map` / `Set` / `RegExp` —\r\n   * replaces the target value. All values are cloned to prevent reference sharing.\r\n   *\r\n   * The plain-object guard is load-bearing, not tidiness. A bare\r\n   * `typeof value === \"object\"` also matches a `Date`, and `Object.entries(date)`\r\n   * is `[]` — so merging a `Date` over a column that already held a `Date`\r\n   * recursed into it, copied nothing, and left the old value in the snapshot.\r\n   * The column then never went dirty and `save()` returned\r\n   * `{ success: true, modifiedCount: 0 }` without issuing an `UPDATE`. This is\r\n   * the same lesson `canBeFlatten` above already encodes.\r\n   *\r\n   * @param target - The object to merge into\r\n   * @param source - The object to merge from\r\n   * @private\r\n   */\r\n  protected mergeIntoRaw(target: Record<string, unknown>, source: Record<string, unknown>): void {\r\n    for (const [key, value] of Object.entries(source)) {\r\n      if (isPlainObject(value) && isPlainObject(target[key])) {\r\n        this.mergeIntoRaw(target[key] as Record<string, unknown>, value as Record<string, unknown>);\r\n        continue;\r\n      }\r\n\r\n      target[key] = this.cloneData(value);\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Deletes a field from the current raw data using a dot-notation path.\r\n   *\r\n   * Supports nested paths (e.g., \"address.city\") and array indices (e.g., \"items.0\").\r\n   * If any segment in the path doesn't exist, the operation is a no-op.\r\n   *\r\n   * @param path - The dot-notation path to the field to delete\r\n   * @private\r\n   */\r\n  protected deleteFromRaw(path: string): void {\r\n    const segments = path.split(\".\");\r\n    let container: unknown = this.currentRaw;\r\n\r\n    for (let index = 0; index < segments.length - 1; index += 1) {\r\n      if (container === undefined || container === null) {\r\n        return;\r\n      }\r\n\r\n      const segment = segments[index];\n      if (segment === undefined) {\n        return;\n      }\n\n      container = this.resolveSegment(container, segment);\n    }\r\n\r\n    if (container === undefined || container === null) {\r\n      return;\r\n    }\r\n\r\n    const lastSegment = segments[segments.length - 1];\n    if (lastSegment === undefined) {\n      return;\n    }\n    if (Array.isArray(container)) {\r\n      const numericIndex = Number(lastSegment);\r\n      if (!Number.isNaN(numericIndex)) {\r\n        container.splice(numericIndex, 1);\r\n      }\r\n      return;\r\n    }\r\n\r\n    if (typeof container === \"object\") {\r\n      delete (container as Record<string, unknown>)[lastSegment];\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Resolves a single segment of a dot-notation path within a container.\r\n   *\r\n   * Handles both object property access and array index access.\r\n   *\r\n   * @param container - The object or array to access\r\n   * @param segment - The property name or array index as a string\r\n   * @returns The value at the specified segment, or undefined if not found\r\n   * @private\r\n   */\r\n  protected resolveSegment(container: unknown, segment: string): unknown {\r\n    if (Array.isArray(container)) {\r\n      const numericIndex = Number(segment);\r\n      if (Number.isNaN(numericIndex)) {\r\n        return undefined;\r\n      }\r\n\r\n      return container[numericIndex];\r\n    }\r\n\r\n    if (container && typeof container === \"object\") {\r\n      return (container as Record<string, unknown>)[segment];\r\n    }\r\n\r\n    return undefined;\r\n  }\r\n\r\n  /**\r\n   * Creates a deep clone of the provided data.\r\n   *\r\n   * @param data - The data to clone\r\n   * @returns A deep clone of the data\r\n   * @private\r\n   */\r\n  protected cloneData<T>(data: T): T {\r\n    return clone(data);\r\n  }\r\n}\r\n"],"mappings":"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"}
+{"version":3,"file":"database-dirty-tracker.mjs","names":[],"sources":["../../../../../../cascade/src/database-dirty-tracker.ts"],"sourcesContent":["import { areEqual, clone } from \"@mongez/reinforcements\";\nimport { isPlainObject } from \"@mongez/supportive-is\";\n\nfunction canBeFlatten(object: unknown): boolean {\n  return isPlainObject(object);\n}\n\n/**\n * A fix for flatten as non-plain object is being flatten as well which it should not be\n */\nfunction flatten(\n  object: Record<string, unknown>,\n  separator = \".\",\n  keepNestedOriginalObject = false,\n  parent?: string,\n  root: Record<string, unknown> = {},\n) {\n  if (canBeFlatten(object) === false) {\n    return object;\n  }\n  // object = toPlainObject(object);\n  for (const key of Object.keys(object)) {\n    const value = object[key];\n    const keyChain = parent ? parent + separator + key : key;\n    if ((Array.isArray(value) && value.length === 0) || typeof value === \"function\") {\n      root[keyChain] = value;\n    } else if (canBeFlatten(value)) {\n      if (keepNestedOriginalObject) {\n        root[keyChain] = value;\n      }\n      flatten(\n        value as Record<string, unknown>,\n        separator,\n        keepNestedOriginalObject,\n        keyChain,\n        root,\n      );\n    } else {\n      root[keyChain] = value;\n    }\n  }\n  return root;\n}\n\n/**\n * Flattened record type representing dot-notation paths mapped to their values.\n */\ntype FlatRecord = Record<string, unknown>;\n\n/**\n * Represents the old and new values of a dirty column.\n */\ntype DirtyColumnValues = { oldValue: unknown; newValue: unknown };\n\n/**\n * Tracks changes to model data by maintaining snapshots of initial and current state.\n *\n * The tracker stores both raw (nested) and flattened (dot-notation) versions of the data\n * to accurately detect modifications, additions, and removals at any nesting level.\n *\n * @example\n * ```typescript\n * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", age: 30 });\n * tracker.mergeChanges({ age: 31 });\n * console.log(tracker.hasChanges()); // true\n * console.log(tracker.getDirtyColumns()); // [\"age\"]\n * console.log(tracker.getDirtyColumnsWithValues());\n * // { age: { oldValue: 30, newValue: 31 } }\n * ```\n */\nexport class DatabaseDirtyTracker {\n  /**\n   * The initial raw data snapshot taken at construction or last reset.\n   * Used as the baseline for comparison.\n   */\n  protected initialRaw: Record<string, unknown>;\n\n  /**\n   * The current raw data snapshot reflecting all changes made via merge/unset.\n   */\n  protected currentRaw: Record<string, unknown>;\n\n  /**\n   * Flattened version of the initial data using dot-notation keys.\n   * Example: { \"address.city\": \"NYC\" }\n   */\n  protected initialFlattened: FlatRecord;\n\n  /**\n   * Flattened version of the current data using dot-notation keys.\n   */\n  protected currentFlattened: FlatRecord;\n\n  /**\n   * Set of column names (dot-notation paths) that have been modified.\n   */\n  protected readonly dirtyColumns = new Set<string>();\n\n  /**\n   * Set of column names (dot-notation paths) that existed initially but have been removed.\n   */\n  protected readonly removedColumns = new Set<string>();\n\n  public constructor(data: Record<string, unknown>) {\n    this.initialRaw = this.cloneData(data);\n    this.currentRaw = this.cloneData(data);\n\n    this.initialFlattened = this.flattenData(this.initialRaw);\n    this.currentFlattened = { ...this.initialFlattened };\n\n    this.updateDirtyState();\n  }\n\n  /**\n   * Returns the list of dirty columns using dot-notation.\n   *\n   * A column is considered dirty if its value has changed compared to the initial snapshot.\n   *\n   * @returns An array of column names (dot-notation paths) that have been modified\n   *\n   * @example\n   * ```typescript\n   * tracker.mergeChanges({ name: \"Bob\", \"address.city\": \"LA\" });\n   * tracker.getDirtyColumns(); // [\"name\", \"address.city\"]\n   * ```\n   */\n  public getDirtyColumns(): string[] {\n    return Array.from(this.dirtyColumns);\n  }\n\n  /**\n   * Determines whether there are any tracked changes.\n   *\n   * Returns `true` if any columns have been modified or removed since the initial snapshot.\n   *\n   * @returns `true` if there are changes, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\n   * tracker.hasChanges(); // false\n   * tracker.mergeChanges({ name: \"Bob\" });\n   * tracker.hasChanges(); // true\n   * tracker.unset(\"name\");\n   * tracker.hasChanges(); // true (removed column counts as a change)\n   * ```\n   */\n  public hasChanges(): boolean {\n    return this.dirtyColumns.size > 0 || this.removedColumns.size > 0;\n  }\n\n  /**\n   * Check if the given column is dirty (changed)\n   */\n  public isDirty(column: string): boolean {\n    return this.dirtyColumns.has(column);\n  }\n\n  /**\n   * Returns the set of columns that have been removed compared to the baseline.\n   *\n   * A column is considered removed if it existed in the initial snapshot but has been\n   * explicitly unset or deleted from the current data.\n   *\n   * @returns An array of column names (dot-notation paths) that have been removed\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", temp: \"value\" });\n   * tracker.unset(\"temp\");\n   * tracker.getRemovedColumns(); // [\"temp\"]\n   * ```\n   */\n  public getRemovedColumns(): string[] {\n    return Array.from(this.removedColumns);\n  }\n\n  /**\n   * Provides a mapping of dirty columns to their previous and current values.\n   *\n   * This is useful for generating audit logs, building partial update payloads,\n   * or displaying change summaries to users.\n   *\n   * @returns A record mapping each dirty column to an object containing oldValue and newValue\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", age: 30 });\n   * tracker.mergeChanges({ age: 31 });\n   * tracker.getDirtyColumnsWithValues();\n   * // { age: { oldValue: 30, newValue: 31 } }\n   * ```\n   */\n  public getDirtyColumnsWithValues(): Record<string, DirtyColumnValues> {\n    const result: Record<string, DirtyColumnValues> = {};\n\n    for (const column of this.dirtyColumns) {\n      const hasCurrent =\n        this.currentFlattened[column] !== undefined || column in this.currentFlattened;\n\n      result[column] = {\n        oldValue: this.initialFlattened[column],\n        newValue: hasCurrent ? this.currentFlattened[column] : undefined,\n      };\n    }\n\n    return result;\n  }\n\n  /**\n   * Replaces the current data snapshot entirely and recomputes the diff.\n   *\n   * This is useful when you want to replace all current data with a new set,\n   * while keeping the initial baseline for comparison.\n   *\n   * @param data - The new data to set as the current snapshot\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\n   * tracker.replaceCurrentData({ name: \"Bob\", email: \"bob@example.com\" });\n   * tracker.getDirtyColumns(); // [\"name\", \"email\"]\n   * ```\n   */\n  public replaceCurrentData(data: Record<string, unknown>): void {\n    this.currentRaw = this.cloneData(data);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Merges a partial payload into the current snapshot and recomputes the diff.\n   *\n   * This performs a deep merge, preserving existing nested structures while\n   * updating only the specified fields.\n   *\n   * @param partial - Partial data to merge into the current snapshot\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\", address: { city: \"NYC\" } });\n   * tracker.mergeChanges({ address: { zip: \"10001\" } });\n   * // Current data: { name: \"Alice\", address: { city: \"NYC\", zip: \"10001\" } }\n   * tracker.getDirtyColumns(); // [\"address.zip\"]\n   * ```\n   */\n  public mergeChanges(partial: Record<string, unknown>): void {\n    this.mergeIntoRaw(this.currentRaw, partial);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Replaces the value at a dot-notation path (no deep merge), mirroring\n   * `model.set()` so stale nested keys are detected as removed.\n   */\n  public setAtPath(path: string, value: unknown): void {\n    const segments = path.split(\".\");\n    let container = this.currentRaw as Record<string, unknown>;\n\n    for (let index = 0; index < segments.length - 1; index += 1) {\n      const segment = segments[index] as string;\n\n      if (!isPlainObject(container[segment]) && !Array.isArray(container[segment])) {\n        container[segment] = {};\n      }\n\n      container = container[segment] as Record<string, unknown>;\n    }\n\n    container[segments[segments.length - 1] as string] = this.cloneData(value);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Explicitly removes one or more columns from the current data.\n   *\n   * Supports both single column names and arrays of column names.\n   * Columns can be specified using dot-notation for nested paths.\n   *\n   * @param columns - A single column name or an array of column names to remove\n   *\n   * @example\n   * ```typescript\n   * tracker.unset(\"tempField\");\n   * tracker.unset([\"field1\", \"field2\", \"nested.field\"]);\n   * tracker.getRemovedColumns(); // [\"tempField\", \"field1\", \"field2\", \"nested.field\"]\n   * ```\n   */\n  public unset(columns: string | string[]): void {\n    const targets = Array.isArray(columns) ? columns : [columns];\n\n    for (const path of targets) {\n      this.deleteFromRaw(path);\n    }\n\n    this.currentFlattened = this.flattenData(this.currentRaw);\n    this.updateDirtyState();\n  }\n\n  /**\n   * Resets both the initial and current snapshots to the provided data.\n   *\n   * If no data is provided, the current snapshot becomes the new baseline.\n   * This clears all tracked changes and removed columns.\n   *\n   * @param data - Optional new data to use as the baseline. If omitted, uses current data.\n   *\n   * @example\n   * ```typescript\n   * const tracker = new DatabaseDirtyTracker({ name: \"Alice\" });\n   * tracker.mergeChanges({ name: \"Bob\" });\n   * tracker.hasChanges(); // true\n   * tracker.reset(); // Make current state the new baseline\n   * tracker.hasChanges(); // false\n   *\n   * // Or reset to entirely new data:\n   * tracker.reset({ name: \"Charlie\", age: 25 });\n   * ```\n   */\n  public reset(data?: Record<string, unknown>): void {\n    const source = data ?? this.currentRaw;\n    this.initialRaw = this.cloneData(source);\n    this.currentRaw = this.cloneData(source);\n\n    this.initialFlattened = this.flattenData(this.initialRaw);\n    this.currentFlattened = this.flattenData(this.currentRaw);\n\n    this.dirtyColumns.clear();\n    this.removedColumns.clear();\n  }\n\n  /**\n   * Flattens the given data object.\n   * Can be overridden by subclasses to change flattening behavior.\n   */\n  protected flattenData(data: Record<string, unknown>): FlatRecord {\n    return flatten(data);\n  }\n\n  /**\n   * Recomputes the dirty and removed column sets by comparing initial and current snapshots.\n   *\n   * This method is called internally after any operation that modifies the current data.\n   * It iterates through all keys in both flattened snapshots and determines which columns\n   * have been modified or removed.\n   *\n   * @protected\n   */\n  protected updateDirtyState(): void {\n    this.dirtyColumns.clear();\n    this.removedColumns.clear();\n\n    const keys = new Set([\n      ...Object.keys(this.initialFlattened),\n      ...Object.keys(this.currentFlattened),\n    ]);\n\n    for (const key of keys) {\n      const hasCurrent = this.currentFlattened[key] !== undefined || key in this.currentFlattened;\n      const hasInitial = this.initialFlattened[key] !== undefined || key in this.initialFlattened;\n\n      if (!hasCurrent && hasInitial) {\n        this.removedColumns.add(key);\n      }\n\n      const initialValue = this.initialFlattened[key];\n      const currentValue = hasCurrent ? this.currentFlattened[key] : undefined;\n\n      if (!areEqual(initialValue, currentValue)) {\n        this.dirtyColumns.add(key);\n      }\n    }\n  }\n\n  /**\n   * Recursively merges source object into target object, performing a deep merge.\n   *\n   * Only **plain** objects are merged recursively. Everything else — arrays,\n   * primitives, and class instances such as `Date` / `Map` / `Set` / `RegExp` —\n   * replaces the target value. All values are cloned to prevent reference sharing.\n   *\n   * The plain-object guard is load-bearing, not tidiness. A bare\n   * `typeof value === \"object\"` also matches a `Date`, and `Object.entries(date)`\n   * is `[]` — so merging a `Date` over a column that already held a `Date`\n   * recursed into it, copied nothing, and left the old value in the snapshot.\n   * The column then never went dirty and `save()` returned\n   * `{ success: true, modifiedCount: 0 }` without issuing an `UPDATE`. This is\n   * the same lesson `canBeFlatten` above already encodes.\n   *\n   * @param target - The object to merge into\n   * @param source - The object to merge from\n   * @private\n   */\n  protected mergeIntoRaw(target: Record<string, unknown>, source: Record<string, unknown>): void {\n    for (const [key, value] of Object.entries(source)) {\n      if (isPlainObject(value) && isPlainObject(target[key])) {\n        this.mergeIntoRaw(target[key] as Record<string, unknown>, value as Record<string, unknown>);\n        continue;\n      }\n\n      target[key] = this.cloneData(value);\n    }\n  }\n\n  /**\n   * Deletes a field from the current raw data using a dot-notation path.\n   *\n   * Supports nested paths (e.g., \"address.city\") and array indices (e.g., \"items.0\").\n   * If any segment in the path doesn't exist, the operation is a no-op.\n   *\n   * @param path - The dot-notation path to the field to delete\n   * @private\n   */\n  protected deleteFromRaw(path: string): void {\n    const segments = path.split(\".\");\n    let container: unknown = this.currentRaw;\n\n    for (let index = 0; index < segments.length - 1; index += 1) {\n      if (container === undefined || container === null) {\n        return;\n      }\n\n      const segment = segments[index] as string;\n      if (segment === undefined) {\n        return;\n      }\n\n      container = this.resolveSegment(container, segment);\n    }\n\n    if (container === undefined || container === null) {\n      return;\n    }\n\n    const lastSegment = segments[segments.length - 1];\n    if (lastSegment === undefined) {\n      return;\n    }\n    if (Array.isArray(container)) {\n      const numericIndex = Number(lastSegment);\n      if (!Number.isNaN(numericIndex)) {\n        container.splice(numericIndex, 1);\n      }\n      return;\n    }\n\n    if (typeof container === \"object\") {\n      delete (container as Record<string, unknown>)[lastSegment];\n    }\n  }\n\n  /**\n   * Resolves a single segment of a dot-notation path within a container.\n   *\n   * Handles both object property access and array index access.\n   *\n   * @param container - The object or array to access\n   * @param segment - The property name or array index as a string\n   * @returns The value at the specified segment, or undefined if not found\n   * @private\n   */\n  protected resolveSegment(container: unknown, segment: string): unknown {\n    if (Array.isArray(container)) {\n      const numericIndex = Number(segment);\n      if (Number.isNaN(numericIndex)) {\n        return undefined;\n      }\n\n      return container[numericIndex];\n    }\n\n    if (container && typeof container === \"object\") {\n      return (container as Record<string, unknown>)[segment];\n    }\n\n    return undefined;\n  }\n\n  /**\n   * Creates a deep clone of the provided data.\n   *\n   * @param data - The data to clone\n   * @returns A deep clone of the data\n   * @private\n   */\n  protected cloneData<T>(data: T): T {\n    return clone(data);\n  }\n}\n"],"mappings":"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"}

package/esm/drivers/mongodb/mongodb-driver.d.mts

@@ -268,7 +268,19 @@ declare class MongoDbDriver implements DriverContract {
    *
    * @throws {Error} If MongoDB is running as a standalone instance
    */
+  private replicaSetChecked;
   private ensureReplicaSetAvailable;
+  /**
+   * Whether an active transaction can be joined: one exists and it is not
+   * owned by a different data source (sessions opened outside `transaction()`
+   * carry no owner tag and are joinable).
+   */
+  private canJoinActiveTransaction;
+  /**
+   * The ambient transaction session, only when it belongs to this driver's
+   * data source.
+   */
+  private getOwnSession;
   /**
    * Attach the active transaction session (when available) to Mongo options.
    */

package/esm/drivers/mongodb/mongodb-driver.d.mts.map

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