@drawbridge/mongodb 0.0.5 → 0.0.6

package/dist/index.d.mts

@@ -42,8 +42,8 @@ const formats = {
 			const date = new Date();
 
 			// Split `rest` into MongoDB operators ($-prefixed) and plain fields.
-			// Plain fields are merged into $set so callers can pass `{ telemetry, $set: {...} }`
-			// without MongoDB rejecting `telemetry` as an unknown modifier.
+			// Plain fields are merged into $set so callers can pass `{ field, $set: {...} }`
+			// without MongoDB rejecting `field` as an unknown modifier.
 			const operators = {};
 			const fields = {};
 
@@ -396,6 +396,72 @@ module.exports = ({
 
 			}
 
+			// Per-document totals. Each spec counts (or $sums) related docs for a
+			// single page row and writes the result under `totals.<key>`. These
+			// stages run AFTER $skip/$limit, so the lookups touch ONLY the
+			// paginated page — never the full result set. Display-only by design:
+			// because they run post-pagination they are invisible to search/sort/
+			// refine (those operate on the full set, pre-pagination). Spec shapes:
+			//   { key, from, foreignField, localField = 'id', match }        -> count
+			//   { key, from, foreignField, localField = 'id', match, sum }   -> $sum field
+			//   { key, from, localField = 'id', pipeline }                   -> custom
+			//     sub-pipeline (e.g. 2-hop); receives the owner id as `$$local`
+			//     and must yield a single doc shaped `{ value: <number> }`.
+			if( ( rest?.totals || [] ).length > 0 ){
+
+				const temps = [];
+				const additions = {};
+
+				for( const spec of rest.totals ){
+
+					const temp = '__total_' + spec.key;
+					const localField = spec.localField || 'id';
+
+					temps.push( temp );
+
+					const pipeline = spec.pipeline || [
+						{
+							$match : {
+								$expr : spec.array
+									? { $in : [ '$$local', { $ifNull : [ '$' + spec.foreignField, [] ] } ] }
+									: { $eq : [ '$' + spec.foreignField, '$$local' ] },
+								...( spec.match || {} )
+							}
+						},
+						spec.sum
+							? { $group : { _id : null, value : { $sum : '$' + spec.sum } } }
+							: { $count : 'value' }
+					];
+
+					dataStages.push({
+						$lookup : {
+							from : spec.from,
+							let : { local : '$' + localField },
+							pipeline,
+							as : temp
+						}
+					});
+
+					additions[ 'totals.' + spec.key ] = {
+						$ifNull : [ { $arrayElemAt : [ '$' + temp + '.value', 0 ] }, 0 ]
+					};
+
+				}
+
+				dataStages.push({ $addFields : additions });
+
+				dataStages.push({
+					$project : temps.reduce( ( accumulator, temp ) => {
+
+						accumulator[ temp ] = 0;
+
+						return accumulator;
+
+					}, {} )
+				});
+
+			}
+
 			if( rest?.project ){
 
 				dataStages.push({

package/dist/index.d.ts

@@ -42,8 +42,8 @@ const formats = {
 			const date = new Date();
 
 			// Split `rest` into MongoDB operators ($-prefixed) and plain fields.
-			// Plain fields are merged into $set so callers can pass `{ telemetry, $set: {...} }`
-			// without MongoDB rejecting `telemetry` as an unknown modifier.
+			// Plain fields are merged into $set so callers can pass `{ field, $set: {...} }`
+			// without MongoDB rejecting `field` as an unknown modifier.
 			const operators = {};
 			const fields = {};
 
@@ -396,6 +396,72 @@ module.exports = ({
 
 			}
 
+			// Per-document totals. Each spec counts (or $sums) related docs for a
+			// single page row and writes the result under `totals.<key>`. These
+			// stages run AFTER $skip/$limit, so the lookups touch ONLY the
+			// paginated page — never the full result set. Display-only by design:
+			// because they run post-pagination they are invisible to search/sort/
+			// refine (those operate on the full set, pre-pagination). Spec shapes:
+			//   { key, from, foreignField, localField = 'id', match }        -> count
+			//   { key, from, foreignField, localField = 'id', match, sum }   -> $sum field
+			//   { key, from, localField = 'id', pipeline }                   -> custom
+			//     sub-pipeline (e.g. 2-hop); receives the owner id as `$$local`
+			//     and must yield a single doc shaped `{ value: <number> }`.
+			if( ( rest?.totals || [] ).length > 0 ){
+
+				const temps = [];
+				const additions = {};
+
+				for( const spec of rest.totals ){
+
+					const temp = '__total_' + spec.key;
+					const localField = spec.localField || 'id';
+
+					temps.push( temp );
+
+					const pipeline = spec.pipeline || [
+						{
+							$match : {
+								$expr : spec.array
+									? { $in : [ '$$local', { $ifNull : [ '$' + spec.foreignField, [] ] } ] }
+									: { $eq : [ '$' + spec.foreignField, '$$local' ] },
+								...( spec.match || {} )
+							}
+						},
+						spec.sum
+							? { $group : { _id : null, value : { $sum : '$' + spec.sum } } }
+							: { $count : 'value' }
+					];
+
+					dataStages.push({
+						$lookup : {
+							from : spec.from,
+							let : { local : '$' + localField },
+							pipeline,
+							as : temp
+						}
+					});
+
+					additions[ 'totals.' + spec.key ] = {
+						$ifNull : [ { $arrayElemAt : [ '$' + temp + '.value', 0 ] }, 0 ]
+					};
+
+				}
+
+				dataStages.push({ $addFields : additions });
+
+				dataStages.push({
+					$project : temps.reduce( ( accumulator, temp ) => {
+
+						accumulator[ temp ] = 0;
+
+						return accumulator;
+
+					}, {} )
+				});
+
+			}
+
 			if( rest?.project ){
 
 				dataStages.push({

package/dist/index.js

@@ -274,6 +274,42 @@ module.exports = ({
           $limit: Number(limit)
         });
       }
+      if (((rest == null ? void 0 : rest.totals) || []).length > 0) {
+        const temps = [];
+        const additions = {};
+        for (const spec of rest.totals) {
+          const temp = "__total_" + spec.key;
+          const localField = spec.localField || "id";
+          temps.push(temp);
+          const pipeline = spec.pipeline || [
+            {
+              $match: {
+                $expr: spec.array ? { $in: ["$$local", { $ifNull: ["$" + spec.foreignField, []] }] } : { $eq: ["$" + spec.foreignField, "$$local"] },
+                ...spec.match || {}
+              }
+            },
+            spec.sum ? { $group: { _id: null, value: { $sum: "$" + spec.sum } } } : { $count: "value" }
+          ];
+          dataStages.push({
+            $lookup: {
+              from: spec.from,
+              let: { local: "$" + localField },
+              pipeline,
+              as: temp
+            }
+          });
+          additions["totals." + spec.key] = {
+            $ifNull: [{ $arrayElemAt: ["$" + temp + ".value", 0] }, 0]
+          };
+        }
+        dataStages.push({ $addFields: additions });
+        dataStages.push({
+          $project: temps.reduce((accumulator, temp) => {
+            accumulator[temp] = 0;
+            return accumulator;
+          }, {})
+        });
+      }
       if (rest == null ? void 0 : rest.project) {
         dataStages.push({
           $project: rest == null ? void 0 : rest.project

package/dist/index.mjs

@@ -287,6 +287,42 @@ var require_index = __commonJS({
               $limit: Number(limit)
             });
           }
+          if (((rest == null ? void 0 : rest.totals) || []).length > 0) {
+            const temps = [];
+            const additions = {};
+            for (const spec of rest.totals) {
+              const temp = "__total_" + spec.key;
+              const localField = spec.localField || "id";
+              temps.push(temp);
+              const pipeline = spec.pipeline || [
+                {
+                  $match: {
+                    $expr: spec.array ? { $in: ["$$local", { $ifNull: ["$" + spec.foreignField, []] }] } : { $eq: ["$" + spec.foreignField, "$$local"] },
+                    ...spec.match || {}
+                  }
+                },
+                spec.sum ? { $group: { _id: null, value: { $sum: "$" + spec.sum } } } : { $count: "value" }
+              ];
+              dataStages.push({
+                $lookup: {
+                  from: spec.from,
+                  let: { local: "$" + localField },
+                  pipeline,
+                  as: temp
+                }
+              });
+              additions["totals." + spec.key] = {
+                $ifNull: [{ $arrayElemAt: ["$" + temp + ".value", 0] }, 0]
+              };
+            }
+            dataStages.push({ $addFields: additions });
+            dataStages.push({
+              $project: temps.reduce((accumulator, temp) => {
+                accumulator[temp] = 0;
+                return accumulator;
+              }, {})
+            });
+          }
           if (rest == null ? void 0 : rest.project) {
             dataStages.push({
               $project: rest == null ? void 0 : rest.project

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drawbridge/mongodb",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -23,14 +23,11 @@
     "build": "tsup ./index.js && npm publish"
   },
   "dependencies": {
-    "@drawbridge/drawbridge-agents": "0.0.6",
+    "@drawbridge/drawbridge-agents": "0.0.10",
     "mongodb": "5.9.2"
   },
   "devDependencies": {
     "tsup": "8.5.1",
     "typescript": "5.9.3"
-  },
-  "overrides": {
-    "ip-address": "10.2.0"
   }
 }