@warlock.js/cascade 5.11.0 → 5.13.0

package/esm/drivers/mongodb/mongodb-query-builder.d.mts

@@ -1,4 +1,4 @@
-import { CursorPaginationOptions, CursorPaginationResult, DriverQuery, GroupByInput, HavingInput, JoinOptions, OrderDirection, PaginationOptions, PaginationResult, QueryBuilderContract, RawExpression, WhereCallback, WhereObject, WhereOperator } from "../../contracts/query-builder.contract.mjs";
+import { CursorPaginationOptions, CursorPaginationResult, DriverQuery, GroupByInput, HavingInput, JoinOptions, LeanDocument, OrderDirection, PaginationOptions, PaginationResult, QueryBuilderContract, RawExpression, UnwindOptions, WhereCallback, WhereObject, WhereOperator } from "../../contracts/query-builder.contract.mjs";
 import { DataSource } from "../../data-source/data-source.mjs";
 import { Operation } from "./types.mjs";
 import { QueryBuilder } from "../../query-builder/query-builder.mjs";
@@ -813,17 +813,27 @@ declare class MongoQueryBuilder<T = unknown> extends QueryBuilder<T> implements
    */
   crossJoin(table: string): this;
   /**
-   * Performs a raw join using a custom aggregation pipeline.
+   * Performs a raw join using caller-built aggregation stages.
    *
-   * This allows full control over the $lookup stage for complex join scenarios.
+   * The expression is one pipeline stage (typically `{ $lookup: { ... } }`) or
+   * an array of stages. They are emitted verbatim in call order, so a later
+   * `where()` / `orderBy()` can use the joined fields.
    *
-   * @param expression - Raw expression (typically a $lookup stage or pipeline)
-   * @param _bindings - Optional bindings (not used in MongoDB but kept for API consistency)
+   * @param expression - A pipeline stage object, or an array of stage objects
+   * @param _bindings - Not used on MongoDB; kept for API consistency
+   * @throws UnsupportedQueryOperationError when the expression is not a stage
+   *   object or an array of them (e.g. a SQL `JOIN` string)
    */
   joinRaw(expression: RawExpression, _bindings?: unknown[]): this;
   /**
-   * Allows direct manipulation of the native MongoDB query.
-   * @param builder - Function that receives and modifies the native query
+   * Allows direct manipulation of the native MongoDB aggregation pipeline.
+   *
+   * The callback receives the pipeline array built from the operations
+   * recorded before this call. Return a new array of stages to replace it, or
+   * mutate the array in place and return nothing. Operations recorded after
+   * `raw()` are appended to that result.
+   *
+   * @param builder - Receives the pipeline array; returns a replacement or nothing
    */
   raw(builder: (native: unknown) => unknown): this;
   /**
@@ -838,6 +848,10 @@ declare class MongoQueryBuilder<T = unknown> extends QueryBuilder<T> implements
    * @returns A new query builder instance with copied operations
    */
   clone(): this;
+  /**
+   * Switch to lean read mode — see `QueryBuilderContract.lean()`.
+   */
+  lean(): MongoQueryBuilder<LeanDocument<T>>;
   /**
    * Row-level locking is a SQL capability — MongoDB has no
    * `SELECT ... FOR UPDATE`. Throwing (instead of silently ignoring the call)
@@ -1122,6 +1136,17 @@ declare class MongoQueryBuilder<T = unknown> extends QueryBuilder<T> implements
    * @param callback - Callback to define conditions
    */
   whereDoesntHave(relation: string, callback: (query: QueryBuilderContract) => void): this;
+  /**
+   * Deconstruct an array field into one document per element (`$unwind`).
+   * The short form is emitted when no option is given. See
+   * `QueryBuilderContract.unwind()`.
+   */
+  unwind(field: string, options?: UnwindOptions): this;
+  /**
+   * Add computed fields while keeping every existing field (`$addFields`).
+   * See `QueryBuilderContract.addFields()`.
+   */
+  addFields(fields: Record<string, unknown>): this;
   /**
    * Nearest-neighbour vector similarity search via MongoDB Atlas $vectorSearch.
    *

package/esm/drivers/mongodb/mongodb-query-builder.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"mongodb-query-builder.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/mongodb/mongodb-query-builder.ts"],"mappings":";;;;;;;;;;;;;cAiCa,iBAAA,sBACH,YAAA,CAAa,CAAA,aACV,oBAAA,CAAqB,CAAA;EAAA,SAmCd,KAAA;EArCU;;;;;;;EAWZ,UAAA,EAAY,SAAA;EAgDH;;;EAAA,SA3CT,UAAA,EAAY,UAAA;EA6KU;;;EAAA,UAxK5B,iBAAA,GAAoB,oBAAA;EAEvB,eAAA,IAAmB,IAAA,OAAW,KAAA;EAAA,QAE7B,gBAAA;EAAA,QACA,iBAAA;EAAA,QACA,eAAA;EA8LoB;;;;cApLV,KAAA,UAChB,UAAA,GAAa,UAAA;EAuOA;;;;EAAA,cA5ND,gBAAA,IAAoB,oBAAA;EA0Xa;;;EAAA,IAhXpC,UAAA,IAAc,UAAA;EAueC;;;EA9dnB,OAAA,CAAQ,QAAA,GAAW,IAAA,OAAW,KAAA;EAgkBO;;;;EAvjBrC,UAAA,CAAW,QAAA,GAAW,KAAA,kBAAuB,OAAA;EAipBT;;;;EAtoBpC,WAAA,CAAY,QAAA,GAAW,OAAA,SAAgB,OAAA,iBAAwB,OAAA;EAwzBxD;;;;EA7yBP,SAAA,CAAU,QAAA,GAAW,OAAA,SAAgB,OAAA,iBAAwB,OAAA;EAm4BrD;;;EAz3BR,kBAAA,IAAsB,UAAA;EAg9Be;;;EAx8BrC,mBAAA;EA69BM;;;EAj9BN,KAAA,CAAM,SAAA,aAAsB,IAAA;EAghCQ;;;EAAA,QA9/BnC,kBAAA;EAuhCkB;;;;;;EA9+BnB,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;EAwsCd;;;;;;EA5rChB,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;EAi1Cd;;;;;EAt0ClB,QAAA,CAAS,UAAA,EAAY,aAAA,EAAe,QAAA;EAsjD9B;;;;;EA7iDN,UAAA,CAAW,UAAA,EAAY,aAAA,EAAe,QAAA;EAuoDA;;;;;;EAznDtC,WAAA,CAAY,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,MAAA;EA+oDnB;;;;;;EAhoDjC,aAAA,CAAc,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,MAAA;EA2pDvC;;;;EA9oDf,YAAA,CACL,WAAA,EAAa,KAAA,EAAO,IAAA,UAAc,QAAA,EAAU,aAAA,EAAe,KAAA;EAmuDiB;;;;;;EArtDvE,mBAAA,CAAoB,KAAA,UAAe,WAAA,UAAqB,WAAA;EAmxDlC;;;;;EAjwDtB,SAAA,CAAU,KAAA,UAAe,KAAA,EAAO,IAAA;EAyzDwB;;;;;EA/yDxD,eAAA,CAAgB,KAAA,UAAe,KAAA,EAAO,IAAA;EAi2DJ;;;;;EAp1DlC,eAAA,CAAgB,KAAA,UAAe,KAAA,EAAO,IAAA;EA64De;;;;;EAh4DrD,cAAA,CAAe,KAAA,UAAe,KAAA,EAAO,IAAA;EAy+D5B;;;;;EA/9DT,SAAA,CAAU,KAAA,UAAe,KAAA;EAwkE0B;;;;;EA9jEnD,QAAA,CAAS,KAAA,UAAe,KAAA;EAsnEhB;;;;;EA5mER,UAAA,CAAW,KAAA,UAAe,KAAA;EA7WF;;;;;EAuXxB,SAAA,CAAU,KAAA,UAAe,KAAA;EApVd;;;;;EAkWX,iBAAA,CAAkB,IAAA,UAAc,KAAA;EAlXT;;;;;EA+XvB,sBAAA,CAAuB,IAAA,UAAc,KAAA;EAzXpC;;;;EAqYD,oBAAA,CAAqB,IAAA;EA/Wd;;;;;;EA0XP,eAAA,CAAgB,IAAA,UAAc,QAAA,EAAU,aAAA,EAAe,KAAA;EAvW/C;;;;EAoXR,gBAAA,CAAiB,IAAA;EAhWjB;;;;EAyWA,iBAAA,CAAkB,IAAA;EA9VlB;;;;;;EAyWA,gBAAA,CAAiB,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAvVzD;;;;EAwWA,OAAA,CAAQ,KAAA;EAjSR;;;;EAySA,QAAA,CAAS,MAAA,EAAQ,KAAA;EAxSc;;;;EAgT/B,SAAA,CAAU,KAAA;EA/SJ;;;;EAuTN,SAAA,CAAU,KAAA;EA1SV;;;;;EAmTA,aAAA,CAAc,MAAA,qBAA2B,KAAA;EAlTlB;;;;;EAgUvB,eAAA,CAAgB,MAAA,qBAA2B,KAAA;EA9TzB;;;;;EA4UlB,WAAA,CAAY,KAAA,UAAe,KAAA;EAjUS;;;;EAyUpC,QAAA,CAAS,QAAA,EAAU,aAAA,CAAc,CAAA;EAlTjC;;;;EA2TA,UAAA,CAAW,QAAA,EAAU,aAAA,CAAc,CAAA;EA5SnC;;;;;EA0TA,OAAA,CAAQ,KAAA,UAAe,MAAA;EA5Sf;;;;;EAsTR,UAAA,CAAW,KAAA,UAAe,MAAA;EAxS1B;;;;EAiTA,SAAA,CAAU,KAAA;EA/RA;;;;EAwSV,YAAA,CAAa,KAAA;EA9RyB;;;;;EAwStC,YAAA,CAAa,KAAA,UAAe,KAAA;EA9Q5B;;;;;EAwRA,eAAA,CAAgB,KAAA,UAAe,KAAA;EA9QN;;;;;EA+RzB,SAAA,CAAU,KAAA,UAAe,OAAA,EAAS,MAAA;EA3QR;;;;;EAqR1B,YAAA,CAAa,KAAA,UAAe,OAAA,EAAS,MAAA;EA7PL;;;;;EAuQhC,eAAA,CAAgB,KAAA,UAAe,KAAA;EAnO/B;;;;;EAgPA,kBAAA,CAAmB,KAAA,UAAe,KAAA;EAnOjB;;;;;EAgPjB,aAAA,CAAc,KAAA,UAAe,KAAA;EA5NG;;;;;EAsOhC,gBAAA,CAAiB,KAAA,UAAe,KAAA;EA7MvB;;;;;EA0NT,gBAAA,CAAiB,KAAA,UAAe,KAAA,GAAQ,IAAA,EAAM,IAAA;EAjMhC;;;;;EA8Md,mBAAA,CAAoB,KAAA,UAAe,KAAA,GAAQ,IAAA,EAAM,IAAA;EAlLrC;;;;;EAmMZ,WAAA,CAAY,KAAA;EACZ,WAAA,CAAY,QAAA,EAAU,aAAA,CAAc,CAAA;EAnLf;;;;;EAqMrB,cAAA,CAAe,KAAA;EACf,cAAA,CAAe,QAAA,EAAU,aAAA,CAAc,CAAA;EA9K5B;;;;;;EAmMX,SAAA,CAAU,KAAA,UAAe,IAAA;EACzB,SAAA,CAAU,KAAA,UAAe,QAAA,iCAAyC,IAAA;EAxKtC;;;;;EAmM5B,UAAA,CAAW,KAAA,UAAe,OAAA,GAAU,WAAA;EAxKF;;;;;;EAuLlC,kBAAA,CAAmB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAnKlC;;;;;;EAkLhB,qBAAA,CAAsB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAxJxB;;;;;;EAuK7B,oBAAA,CAAqB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAhJN;;;;;;EA+J9C,wBAAA,CAAyB,KAAA,UAAe,KAAA,WAAgB,GAAA;EAjIxD;;;;;EAAA,UA+IG,cAAA,CAAe,MAAA,uBAA6B,IAAA;EA5H/C;;;;;;EAAA,UA8JG,WAAA,CACR,IAAA,6BACA,UAAA,EAAY,aAAA,EACZ,QAAA;EA3Ie;;;;;EAAA,UAsJP,qBAAA,CAAsB,IAAA;IAC9B,MAAA;IACA,UAAA,GAAa,MAAA;EAAA;EA5HkB;;;;;EA+J1B,MAAA,CAAO,MAAA;EACP,MAAA,CAAO,MAAA,EAAQ,MAAA;EACf,MAAA,IAAU,MAAA;EAnI2C;;;;;;EAgJrD,QAAA,CAAS,KAAA,UAAe,KAAA;EAlHgB;;;;;EA2HxC,SAAA,CAAU,UAAA,EAAY,aAAA,EAAe,QAAA;EA1E1C;;;;EAsFK,aAAA,CACL,WAAA,EAAa,KAAA;IACX,KAAA;IACA,UAAA,EAAY,aAAA;IACZ,QAAA;EAAA;EAxCG;;;;;EAsDA,SAAA,CAAU,UAAA,EAAY,aAAA,EAAe,KAAA;EApD3B;;;;;EAiEV,YAAA,CAAa,UAAA,EAAY,aAAA,EAAe,KAAA;EA3C9B;;;;;;EAyDV,eAAA,CACL,KAAA,UACA,SAAA,8DACA,KAAA;EA5CE;;;;;EA2DG,YAAA,CAAa,KAAA,UAAe,KAAA;EAhC5B;;;;;EA6CA,WAAA,CAAY,KAAA,UAAe,KAAA;EA7BhC;;;;;;EAwCK,UAAA,CACL,KAAA,EAAO,KAAA;IAAQ,IAAA,EAAM,aAAA;IAAe,IAAA,EAAM,aAAA;EAAA,IAC1C,SAAA,EAAW,aAAA,YACX,KAAA;EAFe;;;;;;;EAmBV,UAAA,CACL,SAAA,EAAW,aAAA,EACX,SAAA,EAAW,aAAA,YACX,SAAA,EAAW,aAAA,YACX,KAAA;EAJK;;;;EAmBA,sBAAA,CAAuB,QAAA,GAAW,UAAA,EAAY,MAAA;EAhBxC;;;;;EA4BN,UAAA,CAAW,IAAA,UAAc,KAAA;EAZF;;;;;;EAuBvB,aAAA,CAAc,IAAA,UAAc,UAAA,EAAY,aAAA,EAAe,KAAA;EAA3B;;;;EAa5B,YAAA,CAAa,IAAA;EAUQ;;;;;EAArB,YAAA,CAAa,MAAA,EAAQ,KAAA,UAAe,aAAA,GAAgB,KAAA;EAad;;;;;EAAtC,cAAA,CAAe,MAAA,EAAQ,KAAA,UAAe,aAAA,GAAgB,KAAA;EAqBtD;;;;EATA,YAAA,CAAa,IAAA,EAAM,aAAA;EAqBnB;;;;EAZA,QAAA,CAAS,MAAA;EACT,QAAA,IAAY,MAAA,EAAQ,KAAA;EAqBC;;;;EAVrB,cAAA,CAAe,MAAA;EA0DP;;;;EAjDR,SAAA,CAAU,MAAA;EACV,SAAA,IAAa,MAAA,EAAQ,KAAA;EAiDb;;;EAvCR,WAAA;EA2EuB;;;EAnEvB,SAAA;EA8Ec;;;EAvEd,aAAA;EAgF8C;;;;;;;;;;;;;;;EAzD9C,OAAA,CAAQ,KAAA,UAAe,SAAA,GAAY,cAAA;EACnC,OAAA,CAAQ,MAAA,EAAQ,MAAA,SAAe,cAAA;EA6I/B;;;;EAlHA,WAAA,CAAY,KAAA;EAkHkB;;;;;EAzG9B,UAAA,CAAW,UAAA,EAAY,aAAA,EAAe,QAAA;EAmJ3C;;;EAxIK,aAAA,CAAc,KAAA;EAuJwB;;;;EA9ItC,MAAA,CAAO,MAAA,YAA+B,OAAA,CAAQ,CAAA;EA2JvC;;;;EAnJP,MAAA,CAAO,MAAA;EAoJW;;;;EAxIlB,KAAA,CAAM,KAAA;EAiK+B;;;;EAxJrC,IAAA,CAAK,KAAA;EA8KL;;;;EArKA,MAAA,CAAO,KAAA;EAiMiB;;;;EAzLxB,IAAA,CAAK,KAAA;EA8NL;;;;;EArNA,MAAA,CAAO,KAAA,YAAiB,MAAA;EA2Nd;;;;;;;;;;;;;;;;;;;;EA9LV,OAAA,CAAQ,MAAA,EAAQ,YAAA;EAChB,OAAA,CAAQ,MAAA,EAAQ,YAAA,EAAc,UAAA,EAAY,MAAA,SAAe,aAAA;EAkU3C;;;;;;;;;;;;;;;;;;;;;;;;EA3Rd,WAAA,CACL,MAAA,UACA,IAAA,qCACA,UAAA,GAAa,MAAA,SAAe,aAAA;EAkXE;;;;;EAnWzB,UAAA,CAAW,UAAA,EAAY,aAAA,EAAe,QAAA;EAyaR;;;;;;;EA7Z9B,MAAA,CAAO,KAAA,UAAe,KAAA;EACtB,MAAA,CAAO,KAAA,UAAe,QAAA,EAAU,aAAA,EAAe,KAAA;EAC/C,MAAA,CAAO,SAAA,EAAW,WAAA;EAibe;;;;;EAxZjC,SAAA,CAAU,UAAA,EAAY,aAAA,EAAe,QAAA;EAmaQ;;;;;;;EAnZ7C,IAAA,CAAK,KAAA,UAAe,UAAA,UAAoB,YAAA;EAmalC;;;;;EA7ZN,IAAA,CAAK,OAAA,EAAS,WAAA;EAgcJ;;;;;;;;EApaV,QAAA,CAAS,KAAA,UAAe,UAAA,UAAoB,YAAA;EAud7B;;;;;EAjdf,QAAA,CAAS,OAAA,EAAS,WAAA;EAoeE;;;;;;;;;;;EArcpB,SAAA,CAAU,KAAA,UAAe,UAAA,UAAoB,YAAA;EAmeI;;;;;EA7djD,SAAA,CAAU,OAAA,EAAS,WAAA;EAwfM;;;;;;;;;;EAxdzB,SAAA,CAAU,KAAA,UAAe,UAAA,UAAoB,YAAA;EAkgBvC;;;;;EA5fN,SAAA,CAAU,OAAA,EAAS,WAAA;EA4gBgB;;;;;;;;;;;EA7enC,QAAA,CAAS,KAAA,UAAe,UAAA,UAAoB,YAAA;EA+gBV;;;;;EAzgBlC,QAAA,CAAS,OAAA,EAAS,WAAA;EAmiBsB;;;;;;;EAxgBxC,SAAA,CAAU,KAAA;EAuiB4D;;;;;;;;EAnhBtE,OAAA,CAAQ,UAAA,EAAY,aAAA,EAAe,SAAA;EAooBnC;;;;EAznBA,GAAA,CAAI,OAAA,GAAU,MAAA;EA+pBX;;;;;;EAppBH,MAAA,IAAU,SAAA,aAAsB,KAAA,cAAmB,CAAA;EAqrBc;;;;EA5qBjE,KAAA;EA4sBA;;;;;EArrBS,aAAA;EAgsBD;;;;EAprBR,GAAA,CAAI,QAAA,GAAW,OAAA;EA0tBhB;;;;;;;;;EA5sBC,IAAA,IACL,SAAA,EAAW,CAAA,YACX,QAAA,GAAW,OAAA,QAAe,KAAA,EAAO,CAAA,WACjC,SAAA,IAAa,OAAA;EAovBC;;;;EAluBH,GAAA,UAAa,CAAA,KAAM,OAAA,CAAQ,MAAA;EA4uBtB;;;;;;;;EAAA,QA3rBJ,iBAAA;EAwuBwC;;AAAe;;EAntBxD,QAAA,UAAkB,CAAA,KAAM,OAAA,CAAQ,MAAA;;;;;EAQhC,KAAA,UAAe,CAAA,KAAM,OAAA,CAAQ,MAAA;;;;;EAc7B,WAAA,UAAqB,CAAA,KAAM,OAAA,CAAQ,MAAA;;;;EAWnC,IAAA,UAAc,CAAA,EAAG,EAAA,oBAAsB,OAAA,CAAQ,MAAA;;;;EAOrD,IAAA,UAAc,CAAA,EAAG,KAAA,YAA8B,OAAA,CAAQ,MAAA;;;;;EASjD,KAAA,IAAS,OAAA;;;;;;EAgBT,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;EAmBpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;EAiBpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;EAiBpB,GAAA,CAAI,KAAA,WAAgB,OAAA;;;;;;EAiBpB,QAAA,cAAsB,KAAA,UAAe,UAAA,aAAoB,OAAA,CAAQ,CAAA;;;;;;EAmBjE,aAAA,CAAc,KAAA,UAAe,UAAA,aAAoB,OAAA;;;;;;EAajD,KAAA,cAAmB,KAAA,WAAgB,OAAA,CAAQ,CAAA;;;;;;EAiB3C,KAAA,cAAmB,KAAA,WAAgB,OAAA,CAAQ,CAAA;;;;;;EAa3C,MAAA,CAAO,MAAA,GAAS,aAAA,GAAgB,OAAA;;;;;;EAchC,SAAA,CAAU,MAAA,GAAS,aAAA,GAAgB,OAAA;;;;;;;EAUnC,SAAA,CAAU,KAAA,UAAe,MAAA,YAAqB,OAAA;;;;;;;EAsB9C,SAAA,CAAU,KAAA,UAAe,MAAA,YAAqB,OAAA;;;;;;;EAU9C,aAAA,CAAc,KAAA,UAAe,MAAA,YAAqB,OAAA;;;;;;;EAgBlD,aAAA,CAAc,KAAA,UAAe,MAAA,YAAqB,OAAA;;;;EAOlD,MAAA,IAAU,OAAA;;;;EAQV,SAAA,IAAa,OAAA;;;;EAQb,MAAA,CAAO,MAAA,EAAQ,MAAA,oBAA0B,OAAA;;;;EAWzC,KAAA,IAAS,MAAA,aAAmB,OAAA;;;;;;;EAwB5B,KAAA,CACX,IAAA,UACA,QAAA,GAAW,IAAA,EAAM,CAAA,IAAK,UAAA,aAAuB,OAAA,oCAC5C,OAAA;;;;;;EA8BU,QAAA,CAAS,OAAA,GAAU,iBAAA,GAAoB,OAAA,CAAQ,gBAAA,CAAiB,CAAA;;;;;;EA0BhE,cAAA,CACX,OAAA,GAAU,uBAAA,GACT,OAAA,CAAQ,sBAAA,CAAuB,CAAA;;;;EA6E3B,KAAA,IAAS,WAAA;;;;;EAQT,MAAA;;;;;EAQM,OAAA,IAAW,OAAA;;;;YAgBd,SAAA,IAAa,gBAAA;;;;;YAcb,aAAA;;;;;;YAWA,WAAA,IAAe,MAAA;;;;YAsBT,OAAA,sBAA6B,QAAA,WAAmB,OAAA,CAAQ,CAAA;;;;EA0BjE,kBAAA,EAAoB,GAAA,qBAAwB,KAAA,EAAO,oBAAA;;;;EAMnD,aAAA,EAAe,GAAA;IAAc,KAAA;IAAe,IAAA;EAAA;;;;EAMpC,mBAAA,GAAsB,MAAA;;;;EAKtB,UAAA;;;;;;;;;;EAWR,QAAA,IAAY,SAAA;;;;;;;;;;;;EAwBZ,IAAA,IACF,IAAA,YAEC,MAAA,qBAA2B,KAAA,EAAO,oBAAA,gBAChC,KAAA,EAAO,oBAAA;;;;;;;EA+BR,GAAA,CAAI,QAAA,UAAkB,QAAA,WAAmB,KAAA;;;;;;EAWzC,QAAA,CAAS,QAAA,UAAkB,QAAA,GAAW,KAAA,EAAO,oBAAA;;;;;EAU7C,UAAA,CAAW,QAAA;;;;;;EAWX,eAAA,CAAgB,QAAA,UAAkB,QAAA,GAAW,KAAA,EAAO,oBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCpD,SAAA,CAAU,MAAA,UAAgB,SAAA,YAAqB,KAAA;AAAA"}
+{"version":3,"file":"mongodb-query-builder.d.mts","names":[],"sources":["../../../../../../../../cascade/src/drivers/mongodb/mongodb-query-builder.ts"],"mappings":"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"}

package/esm/drivers/mongodb/mongodb-query-builder.mjs

@@ -1,9 +1,12 @@
 import { databaseTransactionContext } from "../../context/database-transaction-context.mjs";
 import { dataSourceRegistry } from "../../data-source/data-source-registry.mjs";
+import { UnsupportedQueryOperationError } from "../../errors/unsupported-query-operation.error.mjs";
 import { RelationLoader } from "../../relations/relation-loader.mjs";
 import { sanitizeFilter, sanitizeFilterValue } from "../../utils/sanitize-filter.mjs";
+import { assertLeanCompatible, stripHiddenFromLeanRecords } from "../../query-builder/lean-records.mjs";
 import { QueryBuilder } from "../../query-builder/query-builder.mjs";
 import { MongoQueryOperations } from "./mongodb-query-operations.mjs";
+import { isPipelineStageObject } from "./pipeline-stage-object.mjs";
 import { MongoQueryParser } from "./mongodb-query-parser.mjs";
 import { get } from "@mongez/reinforcements";
 
@@ -1255,23 +1258,35 @@ var MongoQueryBuilder = class MongoQueryBuilder extends QueryBuilder {
 		return this;
 	}
 	/**
-	* Performs a raw join using a custom aggregation pipeline.
+	* Performs a raw join using caller-built aggregation stages.
 	*
-	* This allows full control over the $lookup stage for complex join scenarios.
+	* The expression is one pipeline stage (typically `{ $lookup: { ... } }`) or
+	* an array of stages. They are emitted verbatim in call order, so a later
+	* `where()` / `orderBy()` can use the joined fields.
 	*
-	* @param expression - Raw expression (typically a $lookup stage or pipeline)
-	* @param _bindings - Optional bindings (not used in MongoDB but kept for API consistency)
+	* @param expression - A pipeline stage object, or an array of stage objects
+	* @param _bindings - Not used on MongoDB; kept for API consistency
+	* @throws UnsupportedQueryOperationError when the expression is not a stage
+	*   object or an array of them (e.g. a SQL `JOIN` string)
 	*/
 	joinRaw(expression, _bindings) {
-		this.operationsHelper.addMatchOperation("raw", { builder: () => expression }, false);
+		const stages = Array.isArray(expression) ? expression : [expression];
+		if (stages.length === 0 || !stages.every(isPipelineStageObject)) throw new UnsupportedQueryOperationError("joinRaw", "mongodb", "Pass a pipeline stage object such as { $lookup: { ... } }, or an array of stage objects.");
+		this.operationsHelper.addOperation("$raw", "joinRaw", { stages });
 		return this;
 	}
 	/**
-	* Allows direct manipulation of the native MongoDB query.
-	* @param builder - Function that receives and modifies the native query
+	* Allows direct manipulation of the native MongoDB aggregation pipeline.
+	*
+	* The callback receives the pipeline array built from the operations
+	* recorded before this call. Return a new array of stages to replace it, or
+	* mutate the array in place and return nothing. Operations recorded after
+	* `raw()` are appended to that result.
+	*
+	* @param builder - Receives the pipeline array; returns a replacement or nothing
 	*/
 	raw(builder) {
-		this.operationsHelper.addMatchOperation("raw", { builder }, false);
+		this.operationsHelper.addOperation("$raw", "raw", { builder });
 		return this;
 	}
 	/**
@@ -1294,6 +1309,8 @@ var MongoQueryBuilder = class MongoQueryBuilder extends QueryBuilder {
 		cloned.fetchingCallback = this.fetchingCallback?.bind(cloned);
 		cloned.hydratingCallback = this.hydratingCallback?.bind(cloned);
 		cloned.fetchedCallback = this.fetchedCallback?.bind(cloned);
+		cloned.isLean = this.isLean;
+		cloned.modelClass = this.modelClass;
 		cloned.pendingGlobalScopes = this.pendingGlobalScopes;
 		cloned.availableLocalScopes = this.availableLocalScopes;
 		cloned.disabledGlobalScopes = new Set(this.disabledGlobalScopes);
@@ -1302,6 +1319,13 @@ var MongoQueryBuilder = class MongoQueryBuilder extends QueryBuilder {
 		return cloned;
 	}
 	/**
+	* Switch to lean read mode — see `QueryBuilderContract.lean()`.
+	*/
+	lean() {
+		super.lean();
+		return this;
+	}
+	/**
 	* Row-level locking is a SQL capability — MongoDB has no
 	* `SELECT ... FOR UPDATE`. Throwing (instead of silently ignoring the call)
 	* keeps a queue-claim pattern from silently running unlocked.
@@ -1338,6 +1362,10 @@ var MongoQueryBuilder = class MongoQueryBuilder extends QueryBuilder {
 	async get() {
 		const startTime = Date.now();
 		if (this.fetchingCallback) await this.fetchingCallback(this);
+		if (this.isLean) {
+			assertLeanCompatible(this);
+			return stripHiddenFromLeanRecords(await this.execute(), this.modelClass);
+		}
 		const rawRecords = await this.execute();
 		if (this.hydratingCallback) await this.hydratingCallback(rawRecords, {
 			query: this,
@@ -1837,6 +1865,26 @@ var MongoQueryBuilder = class MongoQueryBuilder extends QueryBuilder {
 		return this;
 	}
 	/**
+	* Deconstruct an array field into one document per element (`$unwind`).
+	* The short form is emitted when no option is given. See
+	* `QueryBuilderContract.unwind()`.
+	*/
+	unwind(field, options) {
+		const data = { path: field.startsWith("$") ? field : `$${field}` };
+		if (options?.preserveNullAndEmptyArrays !== void 0) data.preserveNullAndEmptyArrays = options.preserveNullAndEmptyArrays;
+		if (options?.includeArrayIndex !== void 0) data.includeArrayIndex = options.includeArrayIndex;
+		this.operationsHelper.addOperation("$unwind", "unwind", data, false);
+		return this;
+	}
+	/**
+	* Add computed fields while keeping every existing field (`$addFields`).
+	* See `QueryBuilderContract.addFields()`.
+	*/
+	addFields(fields) {
+		this.operationsHelper.addOperation("$addFields", "addFields", { ...fields }, false);
+		return this;
+	}
+	/**
 	* Nearest-neighbour vector similarity search via MongoDB Atlas $vectorSearch.
 	*
 	* Adds two pipeline stages: