@prisma-next/mongo-lowering 0.5.0-dev.7 → 0.5.0-dev.71

package/README.md

@@ -4,7 +4,7 @@ Adapter and driver interface contracts for the MongoDB transport layer.
 
 ## Responsibilities
 
-- **Adapter interface**: `MongoAdapter` — defines `lower(plan: MongoQueryPlan): AnyMongoWireCommand`, the contract for converting a typed query plan into a wire command
+- **Adapter interface**: `MongoAdapter` — defines `lower(plan: MongoQueryPlan): Promise<AnyMongoWireCommand>`, the contract for converting a typed query plan into a wire command. Async at the boundary: callers must `await lower(...)` so adapters may run async codec encodes (e.g. `resolveValue`) before producing the wire shape.
 - **Driver interface**: `MongoDriver` — defines `execute<Row>(wireCommand): AsyncIterable<Row>` and `close()`, the contract for sending wire commands to a MongoDB instance
 
 ## Dependencies

package/dist/index.d.mts

@@ -1,9 +1,28 @@
+import { CodecCallContext } from "@prisma-next/framework-components/codec";
 import { MongoQueryPlan } from "@prisma-next/mongo-query-ast/execution";
 import { AnyMongoWireCommand } from "@prisma-next/mongo-wire";
 
 //#region src/adapter-types.d.ts
 interface MongoAdapter {
-  lower(plan: MongoQueryPlan): AnyMongoWireCommand;
+  /**
+   * Lower a `MongoQueryPlan` to a driver-ready wire command.
+   *
+   * `ctx` carries the per-`runtime.execute()` context — today just an
+   * `AbortSignal` for cooperative cancellation. The runtime allocates one
+   * ctx per execute and threads the same reference through
+   * `lower → resolveValue → codec.encode`, so codec authors observe
+   * **signal identity** across the whole encode dispatch. The `signal`
+   * field inside the ctx may be `undefined`, but the ctx object itself
+   * is always present.
+   *
+   * Implementations are expected to:
+   * - Pass `ctx` through to every `resolveValue` call so the per-level
+   *   `Promise.all` race can observe the signal.
+   * - Surface `RUNTIME.ABORTED { phase: 'encode' }` (via `runtimeAborted`)
+   *   from inside `resolveValue` when the signal aborts mid-flight; no
+   *   adapter-level abort handling is required beyond ctx forwarding.
+   */
+  lower(plan: MongoQueryPlan, ctx: CodecCallContext): Promise<AnyMongoWireCommand>;
 }
 //#endregion
 //#region src/driver-types.d.ts

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/adapter-types.ts","../src/driver-types.ts"],"sourcesContent":[],"mappings":";;;;UAGiB,YAAA;cACH,iBAAiB;AAD/B;;;UCDiB,WAAA;4BACW,sBAAsB,cAAc;WACrD;ADDX"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/adapter-types.ts","../src/driver-types.ts"],"mappings":";;;;;UAIiB,YAAA;;AAAjB;;;;;;;;;;;;;;;;;EAmBE,KAAA,CAAM,IAAA,EAAM,cAAA,EAAgB,GAAA,EAAK,gBAAA,GAAmB,OAAA,CAAQ,mBAAA;AAAA;;;UCrB7C,WAAA;EACf,OAAA,MAAa,WAAA,EAAa,mBAAA,GAAsB,aAAA,CAAc,GAAA;EAC9D,KAAA,IAAS,OAAA;AAAA"}

package/dist/index.mjs

@@ -1 +1 @@
-export {  };
+export {};

package/package.json

@@ -1,19 +1,21 @@
 {
   "name": "@prisma-next/mongo-lowering",
-  "version": "0.5.0-dev.7",
+  "version": "0.5.0-dev.71",
+  "license": "Apache-2.0",
   "type": "module",
   "sideEffects": false,
   "description": "Adapter and driver interfaces for Prisma Next MongoDB lowering",
   "dependencies": {
-    "@prisma-next/mongo-wire": "0.5.0-dev.7",
-    "@prisma-next/mongo-query-ast": "0.5.0-dev.7"
+    "@prisma-next/framework-components": "0.5.0-dev.71",
+    "@prisma-next/mongo-wire": "0.5.0-dev.71",
+    "@prisma-next/mongo-query-ast": "0.5.0-dev.71"
   },
   "devDependencies": {
-    "tsdown": "0.18.4",
+    "tsdown": "0.22.0",
     "typescript": "5.9.3",
-    "vitest": "4.0.17",
-    "@prisma-next/tsdown": "0.0.0",
-    "@prisma-next/tsconfig": "0.0.0"
+    "vitest": "4.1.5",
+    "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/tsdown": "0.0.0"
   },
   "files": [
     "dist",

package/src/adapter-types.ts

@@ -1,6 +1,25 @@
+import type { CodecCallContext } from '@prisma-next/framework-components/codec';
 import type { MongoQueryPlan } from '@prisma-next/mongo-query-ast/execution';
 import type { AnyMongoWireCommand } from '@prisma-next/mongo-wire';
 
 export interface MongoAdapter {
-  lower(plan: MongoQueryPlan): AnyMongoWireCommand;
+  /**
+   * Lower a `MongoQueryPlan` to a driver-ready wire command.
+   *
+   * `ctx` carries the per-`runtime.execute()` context — today just an
+   * `AbortSignal` for cooperative cancellation. The runtime allocates one
+   * ctx per execute and threads the same reference through
+   * `lower → resolveValue → codec.encode`, so codec authors observe
+   * **signal identity** across the whole encode dispatch. The `signal`
+   * field inside the ctx may be `undefined`, but the ctx object itself
+   * is always present.
+   *
+   * Implementations are expected to:
+   * - Pass `ctx` through to every `resolveValue` call so the per-level
+   *   `Promise.all` race can observe the signal.
+   * - Surface `RUNTIME.ABORTED { phase: 'encode' }` (via `runtimeAborted`)
+   *   from inside `resolveValue` when the signal aborts mid-flight; no
+   *   adapter-level abort handling is required beyond ctx forwarding.
+   */
+  lower(plan: MongoQueryPlan, ctx: CodecCallContext): Promise<AnyMongoWireCommand>;
 }