@prisma-next/mongo-runtime 0.5.0-dev.28 → 0.5.0-dev.29

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { AfterExecuteResult, AsyncIterableResult, ExecutionPlan, RuntimeMiddleware, RuntimeMiddlewareContext } from "@prisma-next/framework-components/runtime";
+import { AfterExecuteResult, AsyncIterableResult, ExecutionPlan, RuntimeExecuteOptions, RuntimeMiddleware, RuntimeMiddlewareContext } from "@prisma-next/framework-components/runtime";
 import { AnyMongoWireCommand } from "@prisma-next/mongo-wire";
 import { MongoAdapter, MongoDriver } from "@prisma-next/mongo-lowering";
 import { MongoQueryPlan } from "@prisma-next/mongo-query-ast/execution";
@@ -60,7 +60,26 @@ interface MongoRuntimeOptions {
   readonly mode?: 'strict' | 'permissive';
 }
 interface MongoRuntime {
-  execute<Row>(plan: MongoQueryPlan<Row>): AsyncIterableResult<Row>;
+  /**
+   * Execute a `MongoQueryPlan` and return an async iterable of rows.
+   *
+   * The optional `options.signal` is threaded through
+   * `lower → adapter.lower → resolveValue → codec.encode` so codec authors
+   * who forward the signal to their underlying SDK get true cancellation
+   * of in-flight network calls. The runtime additionally observes the
+   * signal at two boundaries:
+   *
+   * - **Already-aborted at entry** — first `next()` throws
+   *   `RUNTIME.ABORTED { phase: 'stream' }` before any work is done.
+   *   (Inherited from `RuntimeCore.execute`.)
+   * - **Mid-encode abort** — surfaces as
+   *   `RUNTIME.ABORTED { phase: 'encode' }` from inside `resolveValue`'s
+   *   per-level `Promise.all` race.
+   *
+   * Mongo's read path does not go through codecs (per ADR 204), so there
+   * is no `phase: 'decode'` boundary on the Mongo side.
+   */
+  execute<Row>(plan: MongoQueryPlan<Row>, options?: RuntimeExecuteOptions): AsyncIterableResult<Row>;
   close(): Promise<void>;
 }
 declare function createMongoRuntime(options: MongoRuntimeOptions): MongoRuntime;

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/mongo-execution-plan.ts","../src/mongo-middleware.ts","../src/mongo-runtime.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAwBA;;;;;;;;ACjBA;AAaA;;;;;;;;AAOK,UDHY,kBCGZ,CAAA,MAAA,OAAA,CAAA,SDHsD,aCGtD,CDHoE,GCGpE,CAAA,CAAA;EAEK,SAAA,OAAA,EDJU,mBCIV;;;;UAtBO,sBAAA,SAA+B;;;ADiBhD;;;;;;;;ACjBA;AAaiB,UAAA,eAAA,SAAwB,iBAAR,CAA0B,kBAA1B,CAAA,CAAA;EAA0B,SAAA,QAAA,CAAA,EAAA,OAAA;EAEpC,aAAA,EAAA,IAAA,EAAA,kBAAA,EAAA,GAAA,EAAyB,sBAAzB,CAAA,EAAkD,OAAlD,CAAA,IAAA,CAAA;EAAyB,KAAA,EAAA,GAAA,EAEvC,MAFuC,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,IAAA,EAGtC,kBAHsC,EAAA,GAAA,EAIvC,sBAJuC,CAAA,EAK3C,OAL2C,CAAA,IAAA,CAAA;EAAyB,YAAA,EAAA,IAAA,EAO/D,kBAP+D,EAAA,MAAA,EAQ7D,kBAR6D,EAAA,GAAA,EAShE,sBATgE,CAAA,EAUpE,OAVoE,CAAA,IAAA,CAAA;;;;UCVxD,mBAAA;oBACG;EFWH,SAAA,MAAA,EEVE,WFUgB;EAAsC,SAAA,QAAA,EAAA,OAAA;EACrD,SAAA,QAAA,EAAA,MAAA;EADuC,SAAA,UAAA,CAAA,EAAA,SEP1B,eFO0B,EAAA;EAAa,SAAA,IAAA,CAAA,EAAA,QAAA,GAAA,YAAA;;UEHvD,YAAA;qBACI,eAAe,OAAO,oBAAoB;EDf9C,KAAA,EAAA,ECgBN,ODhBM,CAAA,IAAA,CAAA;AAajB;AAA2D,iBCgD3C,kBAAA,CDhD2C,OAAA,ECgDf,mBDhDe,CAAA,ECgDO,YDhDP"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/mongo-execution-plan.ts","../src/mongo-middleware.ts","../src/mongo-runtime.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;AAwBA;;;;;;;;ACjBA;AAaA;;;;;;;;AAOK,UDHY,kBCGZ,CAAA,MAAA,OAAA,CAAA,SDHsD,aCGtD,CDHoE,GCGpE,CAAA,CAAA;EAEK,SAAA,OAAA,EDJU,mBCIV;;;;UAtBO,sBAAA,SAA+B;;;ADiBhD;;;;;;;;ACjBA;AAaiB,UAAA,eAAA,SAAwB,iBAAR,CAA0B,kBAA1B,CAAA,CAAA;EAA0B,SAAA,QAAA,CAAA,EAAA,OAAA;EAEpC,aAAA,EAAA,IAAA,EAAA,kBAAA,EAAA,GAAA,EAAyB,sBAAzB,CAAA,EAAkD,OAAlD,CAAA,IAAA,CAAA;EAAyB,KAAA,EAAA,GAAA,EAEvC,MAFuC,CAAA,MAAA,EAAA,OAAA,CAAA,EAAA,IAAA,EAGtC,kBAHsC,EAAA,GAAA,EAIvC,sBAJuC,CAAA,EAK3C,OAL2C,CAAA,IAAA,CAAA;EAAyB,YAAA,EAAA,IAAA,EAO/D,kBAP+D,EAAA,MAAA,EAQ7D,kBAR6D,EAAA,GAAA,EAShE,sBATgE,CAAA,EAUpE,OAVoE,CAAA,IAAA,CAAA;;;;UCNxD,mBAAA;oBACG;EFOH,SAAA,MAAA,EENE,WFMgB;EAAsC,SAAA,QAAA,EAAA,OAAA;EACrD,SAAA,QAAA,EAAA,MAAA;EADuC,SAAA,UAAA,CAAA,EAAA,SEH1B,eFG0B,EAAA;EAAa,SAAA,IAAA,CAAA,EAAA,QAAA,GAAA,YAAA;;UECvD,YAAA;;ADlBjB;AAaA;;;;;;;;;;;;;;;;;qBC0BU,eAAe,gBACX,wBACT,oBAAoB;EAhCR,KAAA,EAAA,EAiCN,OAjCM,CAAA,IAAA,CAAmB;;AAEjB,iBA+EH,kBAAA,CA/EG,OAAA,EA+EyB,mBA/EzB,CAAA,EA+E+C,YA/E/C"}

package/dist/index.mjs

@@ -25,9 +25,9 @@ var MongoRuntimeImpl = class extends RuntimeCore {
 		this.#adapter = options.adapter;
 		this.#driver = options.driver;
 	}
-	async lower(plan) {
+	async lower(plan, ctx) {
 		return {
-			command: await this.#adapter.lower(plan),
+			command: await this.#adapter.lower(plan, ctx),
 			meta: plan.meta
 		};
 	}

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["#adapter","#driver","ctx: MongoMiddlewareContext"],"sources":["../src/mongo-runtime.ts"],"sourcesContent":["import type { AsyncIterableResult } from '@prisma-next/framework-components/runtime';\nimport {\n  checkMiddlewareCompatibility,\n  RuntimeCore,\n} from '@prisma-next/framework-components/runtime';\nimport type { MongoAdapter, MongoDriver } from '@prisma-next/mongo-lowering';\nimport type { MongoQueryPlan } from '@prisma-next/mongo-query-ast/execution';\nimport type { MongoExecutionPlan } from './mongo-execution-plan';\nimport type { MongoMiddleware, MongoMiddlewareContext } from './mongo-middleware';\n\nfunction noop() {}\n\nexport interface MongoRuntimeOptions {\n  readonly adapter: MongoAdapter;\n  readonly driver: MongoDriver;\n  readonly contract: unknown;\n  readonly targetId: string;\n  readonly middleware?: readonly MongoMiddleware[];\n  readonly mode?: 'strict' | 'permissive';\n}\n\nexport interface MongoRuntime {\n  execute<Row>(plan: MongoQueryPlan<Row>): AsyncIterableResult<Row>;\n  close(): Promise<void>;\n}\n\nclass MongoRuntimeImpl\n  extends RuntimeCore<MongoQueryPlan, MongoExecutionPlan, MongoMiddleware>\n  implements MongoRuntime\n{\n  readonly #adapter: MongoAdapter;\n  readonly #driver: MongoDriver;\n\n  constructor(options: MongoRuntimeOptions) {\n    const middleware = options.middleware ? [...options.middleware] : [];\n    for (const mw of middleware) {\n      checkMiddlewareCompatibility(mw, 'mongo', options.targetId);\n    }\n\n    const ctx: MongoMiddlewareContext = {\n      contract: options.contract,\n      mode: options.mode ?? 'strict',\n      now: () => Date.now(),\n      log: { info: noop, warn: noop, error: noop },\n    };\n\n    super({ middleware, ctx });\n\n    this.#adapter = options.adapter;\n    this.#driver = options.driver;\n  }\n\n  protected override async lower(plan: MongoQueryPlan): Promise<MongoExecutionPlan> {\n    return {\n      command: await this.#adapter.lower(plan),\n      meta: plan.meta,\n    };\n  }\n\n  protected override runDriver(exec: MongoExecutionPlan): AsyncIterable<Record<string, unknown>> {\n    return this.#driver.execute<Record<string, unknown>>(exec.command);\n  }\n\n  override async close(): Promise<void> {\n    await this.#driver.close();\n  }\n}\n\nexport function createMongoRuntime(options: MongoRuntimeOptions): MongoRuntime {\n  return new MongoRuntimeImpl(options);\n}\n"],"mappings":";;;AAUA,SAAS,OAAO;AAgBhB,IAAM,mBAAN,cACU,YAEV;CACE,CAASA;CACT,CAASC;CAET,YAAY,SAA8B;EACxC,MAAM,aAAa,QAAQ,aAAa,CAAC,GAAG,QAAQ,WAAW,GAAG,EAAE;AACpE,OAAK,MAAM,MAAM,WACf,8BAA6B,IAAI,SAAS,QAAQ,SAAS;EAG7D,MAAMC,MAA8B;GAClC,UAAU,QAAQ;GAClB,MAAM,QAAQ,QAAQ;GACtB,WAAW,KAAK,KAAK;GACrB,KAAK;IAAE,MAAM;IAAM,MAAM;IAAM,OAAO;IAAM;GAC7C;AAED,QAAM;GAAE;GAAY;GAAK,CAAC;AAE1B,QAAKF,UAAW,QAAQ;AACxB,QAAKC,SAAU,QAAQ;;CAGzB,MAAyB,MAAM,MAAmD;AAChF,SAAO;GACL,SAAS,MAAM,MAAKD,QAAS,MAAM,KAAK;GACxC,MAAM,KAAK;GACZ;;CAGH,AAAmB,UAAU,MAAkE;AAC7F,SAAO,MAAKC,OAAQ,QAAiC,KAAK,QAAQ;;CAGpE,MAAe,QAAuB;AACpC,QAAM,MAAKA,OAAQ,OAAO;;;AAI9B,SAAgB,mBAAmB,SAA4C;AAC7E,QAAO,IAAI,iBAAiB,QAAQ"}
+{"version":3,"file":"index.mjs","names":["#adapter","#driver","ctx: MongoMiddlewareContext"],"sources":["../src/mongo-runtime.ts"],"sourcesContent":["import type { CodecCallContext } from '@prisma-next/framework-components/codec';\nimport type {\n  AsyncIterableResult,\n  RuntimeExecuteOptions,\n} from '@prisma-next/framework-components/runtime';\nimport {\n  checkMiddlewareCompatibility,\n  RuntimeCore,\n} from '@prisma-next/framework-components/runtime';\nimport type { MongoAdapter, MongoDriver } from '@prisma-next/mongo-lowering';\nimport type { MongoQueryPlan } from '@prisma-next/mongo-query-ast/execution';\nimport type { MongoExecutionPlan } from './mongo-execution-plan';\nimport type { MongoMiddleware, MongoMiddlewareContext } from './mongo-middleware';\n\nfunction noop() {}\n\nexport interface MongoRuntimeOptions {\n  readonly adapter: MongoAdapter;\n  readonly driver: MongoDriver;\n  readonly contract: unknown;\n  readonly targetId: string;\n  readonly middleware?: readonly MongoMiddleware[];\n  readonly mode?: 'strict' | 'permissive';\n}\n\nexport interface MongoRuntime {\n  /**\n   * Execute a `MongoQueryPlan` and return an async iterable of rows.\n   *\n   * The optional `options.signal` is threaded through\n   * `lower → adapter.lower → resolveValue → codec.encode` so codec authors\n   * who forward the signal to their underlying SDK get true cancellation\n   * of in-flight network calls. The runtime additionally observes the\n   * signal at two boundaries:\n   *\n   * - **Already-aborted at entry** — first `next()` throws\n   *   `RUNTIME.ABORTED { phase: 'stream' }` before any work is done.\n   *   (Inherited from `RuntimeCore.execute`.)\n   * - **Mid-encode abort** — surfaces as\n   *   `RUNTIME.ABORTED { phase: 'encode' }` from inside `resolveValue`'s\n   *   per-level `Promise.all` race.\n   *\n   * Mongo's read path does not go through codecs (per ADR 204), so there\n   * is no `phase: 'decode'` boundary on the Mongo side.\n   */\n  execute<Row>(\n    plan: MongoQueryPlan<Row>,\n    options?: RuntimeExecuteOptions,\n  ): AsyncIterableResult<Row>;\n  close(): Promise<void>;\n}\n\nclass MongoRuntimeImpl\n  extends RuntimeCore<MongoQueryPlan, MongoExecutionPlan, MongoMiddleware>\n  implements MongoRuntime\n{\n  readonly #adapter: MongoAdapter;\n  readonly #driver: MongoDriver;\n\n  constructor(options: MongoRuntimeOptions) {\n    const middleware = options.middleware ? [...options.middleware] : [];\n    for (const mw of middleware) {\n      checkMiddlewareCompatibility(mw, 'mongo', options.targetId);\n    }\n\n    const ctx: MongoMiddlewareContext = {\n      contract: options.contract,\n      mode: options.mode ?? 'strict',\n      now: () => Date.now(),\n      log: { info: noop, warn: noop, error: noop },\n    };\n\n    super({ middleware, ctx });\n\n    this.#adapter = options.adapter;\n    this.#driver = options.driver;\n  }\n\n  protected override async lower(\n    plan: MongoQueryPlan,\n    ctx: CodecCallContext,\n  ): Promise<MongoExecutionPlan> {\n    return {\n      command: await this.#adapter.lower(plan, ctx),\n      meta: plan.meta,\n    };\n  }\n\n  protected override runDriver(exec: MongoExecutionPlan): AsyncIterable<Record<string, unknown>> {\n    return this.#driver.execute<Record<string, unknown>>(exec.command);\n  }\n\n  override async close(): Promise<void> {\n    await this.#driver.close();\n  }\n}\n\nexport function createMongoRuntime(options: MongoRuntimeOptions): MongoRuntime {\n  return new MongoRuntimeImpl(options);\n}\n"],"mappings":";;;AAcA,SAAS,OAAO;AAsChB,IAAM,mBAAN,cACU,YAEV;CACE,CAASA;CACT,CAASC;CAET,YAAY,SAA8B;EACxC,MAAM,aAAa,QAAQ,aAAa,CAAC,GAAG,QAAQ,WAAW,GAAG,EAAE;AACpE,OAAK,MAAM,MAAM,WACf,8BAA6B,IAAI,SAAS,QAAQ,SAAS;EAG7D,MAAMC,MAA8B;GAClC,UAAU,QAAQ;GAClB,MAAM,QAAQ,QAAQ;GACtB,WAAW,KAAK,KAAK;GACrB,KAAK;IAAE,MAAM;IAAM,MAAM;IAAM,OAAO;IAAM;GAC7C;AAED,QAAM;GAAE;GAAY;GAAK,CAAC;AAE1B,QAAKF,UAAW,QAAQ;AACxB,QAAKC,SAAU,QAAQ;;CAGzB,MAAyB,MACvB,MACA,KAC6B;AAC7B,SAAO;GACL,SAAS,MAAM,MAAKD,QAAS,MAAM,MAAM,IAAI;GAC7C,MAAM,KAAK;GACZ;;CAGH,AAAmB,UAAU,MAAkE;AAC7F,SAAO,MAAKC,OAAQ,QAAiC,KAAK,QAAQ;;CAGpE,MAAe,QAAuB;AACpC,QAAM,MAAKA,OAAQ,OAAO;;;AAI9B,SAAgB,mBAAmB,SAA4C;AAC7E,QAAO,IAAI,iBAAiB,QAAQ"}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@prisma-next/mongo-runtime",
-  "version": "0.5.0-dev.28",
+  "version": "0.5.0-dev.29",
   "type": "module",
   "sideEffects": false,
   "description": "MongoDB runtime implementation for Prisma Next",
   "dependencies": {
-    "@prisma-next/contract": "0.5.0-dev.28",
-    "@prisma-next/mongo-lowering": "0.5.0-dev.28",
-    "@prisma-next/mongo-query-ast": "0.5.0-dev.28",
-    "@prisma-next/framework-components": "0.5.0-dev.28",
-    "@prisma-next/mongo-wire": "0.5.0-dev.28"
+    "@prisma-next/contract": "0.5.0-dev.29",
+    "@prisma-next/mongo-query-ast": "0.5.0-dev.29",
+    "@prisma-next/mongo-lowering": "0.5.0-dev.29",
+    "@prisma-next/framework-components": "0.5.0-dev.29",
+    "@prisma-next/mongo-wire": "0.5.0-dev.29"
   },
   "devDependencies": {
     "mongodb": "^6.16.0",
@@ -17,18 +17,18 @@
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.17",
-    "@prisma-next/adapter-mongo": "0.5.0-dev.28",
-    "@prisma-next/middleware-telemetry": "0.5.0-dev.28",
-    "@prisma-next/family-mongo": "0.5.0-dev.28",
-    "@prisma-next/mongo-query-builder": "0.5.0-dev.28",
-    "@prisma-next/mongo-contract-ts": "0.5.0-dev.28",
-    "@prisma-next/mongo-value": "0.5.0-dev.28",
-    "@prisma-next/tsconfig": "0.0.0",
-    "@prisma-next/tsdown": "0.0.0",
-    "@prisma-next/driver-mongo": "0.5.0-dev.28",
+    "@prisma-next/adapter-mongo": "0.5.0-dev.29",
+    "@prisma-next/middleware-telemetry": "0.5.0-dev.29",
+    "@prisma-next/mongo-contract-ts": "0.5.0-dev.29",
+    "@prisma-next/family-mongo": "0.5.0-dev.29",
+    "@prisma-next/mongo-query-builder": "0.5.0-dev.29",
+    "@prisma-next/mongo-value": "0.5.0-dev.29",
+    "@prisma-next/driver-mongo": "0.5.0-dev.29",
+    "@prisma-next/mongo-contract": "0.5.0-dev.29",
     "@prisma-next/test-utils": "0.0.1",
-    "@prisma-next/mongo-contract": "0.5.0-dev.28",
-    "@prisma-next/target-mongo": "0.5.0-dev.28"
+    "@prisma-next/target-mongo": "0.5.0-dev.29",
+    "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/tsdown": "0.0.0"
   },
   "files": [
     "dist",

package/src/mongo-runtime.ts

@@ -1,4 +1,8 @@
-import type { AsyncIterableResult } from '@prisma-next/framework-components/runtime';
+import type { CodecCallContext } from '@prisma-next/framework-components/codec';
+import type {
+  AsyncIterableResult,
+  RuntimeExecuteOptions,
+} from '@prisma-next/framework-components/runtime';
 import {
   checkMiddlewareCompatibility,
   RuntimeCore,
@@ -20,7 +24,29 @@ export interface MongoRuntimeOptions {
 }
 
 export interface MongoRuntime {
-  execute<Row>(plan: MongoQueryPlan<Row>): AsyncIterableResult<Row>;
+  /**
+   * Execute a `MongoQueryPlan` and return an async iterable of rows.
+   *
+   * The optional `options.signal` is threaded through
+   * `lower → adapter.lower → resolveValue → codec.encode` so codec authors
+   * who forward the signal to their underlying SDK get true cancellation
+   * of in-flight network calls. The runtime additionally observes the
+   * signal at two boundaries:
+   *
+   * - **Already-aborted at entry** — first `next()` throws
+   *   `RUNTIME.ABORTED { phase: 'stream' }` before any work is done.
+   *   (Inherited from `RuntimeCore.execute`.)
+   * - **Mid-encode abort** — surfaces as
+   *   `RUNTIME.ABORTED { phase: 'encode' }` from inside `resolveValue`'s
+   *   per-level `Promise.all` race.
+   *
+   * Mongo's read path does not go through codecs (per ADR 204), so there
+   * is no `phase: 'decode'` boundary on the Mongo side.
+   */
+  execute<Row>(
+    plan: MongoQueryPlan<Row>,
+    options?: RuntimeExecuteOptions,
+  ): AsyncIterableResult<Row>;
   close(): Promise<void>;
 }
 
@@ -50,9 +76,12 @@ class MongoRuntimeImpl
     this.#driver = options.driver;
   }
 
-  protected override async lower(plan: MongoQueryPlan): Promise<MongoExecutionPlan> {
+  protected override async lower(
+    plan: MongoQueryPlan,
+    ctx: CodecCallContext,
+  ): Promise<MongoExecutionPlan> {
     return {
-      command: await this.#adapter.lower(plan),
+      command: await this.#adapter.lower(plan, ctx),
       meta: plan.meta,
     };
   }