@prisma-next/framework-components 0.5.0-dev.28 → 0.5.0-dev.29

package/README.md

@@ -36,6 +36,37 @@ The base `Codec` interface lands on the seam between **query-time** methods (per
 
 There is no `runtime` / `kind` / equivalent async marker on the interface and no `TRuntime` generic. The runtime always awaits the query-time methods. See [ADR 204 — Single-Path Async Codec Runtime](../../../../../docs/architecture%20docs/adrs/ADR%20204%20-%20Single-Path%20Async%20Codec%20Runtime.md) for the full design.
 
+### Codec call context (`ctx`)
+
+Codecs receive a second `ctx` options argument; you may ignore it. The runtime allocates one `CodecCallContext` per `execute()` call and threads the same reference to every codec dispatch site as a non-optional argument — when no `signal` is supplied the runtime still threads an empty `{}`, never `undefined`. The framework `CodecCallContext` is signal-only:
+
+```ts
+export interface CodecCallContext {
+  readonly signal?: AbortSignal;
+}
+```
+
+The internal `Codec` interface declares the parameter as required:
+
+```ts
+encode(value: TInput, ctx: CodecCallContext): Promise<TWire>;
+decode(wire: TWire, ctx: CodecCallContext): Promise<TInput>;
+```
+
+Codec authors who write `(value) => …` continue to compile via TypeScript's bivariance for trailing parameters; nothing at the author surface changes.
+
+Family layers extend the context where they have a per-call concept that doesn't generalise. SQL declares `SqlCodecCallContext extends CodecCallContext { column?: SqlColumnRef }` (see `@prisma-next/sql-relational-core`); Mongo continues to use the framework type directly. Codec authors that take a `(value, ctx)` author signature can forward `ctx.signal` to network SDKs:
+
+```ts
+// Sketch — actual factory lives in a family package (codec() / mongoCodec()).
+encode: async (v: string, ctx) =>
+  kms.encrypt({ plaintext: v }, { signal: ctx?.signal });
+```
+
+Aborts surface to the caller as `RUNTIME.ABORTED` with `details.phase ∈ { 'encode', 'decode', 'stream' }`. Codec bodies that ignore the signal complete in the background (cooperative cancellation). The `runtimeAborted(phase, cause?)` envelope helper and the `raceAgainstAbort(work, signal, phase)` race helper are exported from `@prisma-next/framework-components/runtime`.
+
+See [ADR 207 — Codec call context: per-query `AbortSignal` and column metadata](../../../../docs/architecture%20docs/adrs/ADR%20207%20-%20Codec%20call%20context%20per-query%20AbortSignal%20and%20column%20metadata.md) for the full design.
+
 ## Why SPI types live here (dependency inversion)
 
 This package sits in the **core** layer — below the tooling layer where family-specific emitters and control implementations live. SPI interfaces like `EmissionSpi` define the contract between framework orchestration code (control-plane emission, CLI) and family-specific implementations (SQL emitter, Mongo emitter).

package/dist/{codec-types-Csp_4QDg.d.mts → codec-types-DXv-ROhF.d.mts}

@@ -2,6 +2,32 @@ import { JsonValue } from "@prisma-next/contract/types";
 
 //#region src/shared/codec-types.d.ts
 type CodecTrait = 'equality' | 'order' | 'boolean' | 'numeric' | 'textual';
+/**
+ * Per-call context the runtime threads to every `codec.encode` /
+ * `codec.decode` invocation for a single `runtime.execute()` call.
+ *
+ * The framework-level shape is family-agnostic and carries one field:
+ *
+ * - `signal?: AbortSignal` — per-query cancellation. The runtime returns
+ *   a `RUNTIME.ABORTED` envelope when the signal aborts; codec authors
+ *   who forward `signal` to their underlying SDK get true cancellation
+ *   of in-flight network calls.
+ *
+ * Family layers extend this base with their own shape-of-call metadata:
+ * the SQL family adds `column?: SqlColumnRef` via `SqlCodecCallContext`
+ * (see `@prisma-next/sql-relational-core`). Mongo currently uses this
+ * framework type unchanged. Column metadata is intentionally **not** on
+ * the framework type — it is a SQL-family concept rooted in SQL's
+ * `(table, column)` addressing model and would not generalise to other
+ * families.
+ *
+ * The interface is named explicitly (not inlined) so future framework
+ * fields and family extensions can land additively without breaking
+ * codec author signatures.
+ */
+interface CodecCallContext {
+  readonly signal?: AbortSignal;
+}
 /**
  * A codec is the contract between an application value and its on-wire and
  * on-contract-disk representations.
@@ -38,10 +64,10 @@ interface Codec<Id extends string = string, TTraits extends readonly CodecTrait[
   readonly targetTypes: readonly string[];
   /** Semantic traits for operator gating (e.g. equality, order, numeric). */
   readonly traits?: TTraits;
-  /** Converts a JS value to the wire format expected by the database driver. Always Promise-returning at the boundary. */
-  encode(value: TInput): Promise<TWire>;
-  /** Converts a wire value from the database driver into the JS application type. Always Promise-returning at the boundary. */
-  decode(wire: TWire): Promise<TInput>;
+  /** Converts a JS value to the wire format expected by the database driver. Always Promise-returning at the boundary. The {@link CodecCallContext} is supplied by the runtime on every call (allocated once per `runtime.execute()`); family layers may narrow the ctx to extend it (e.g. SQL adds `column`). Author-side single-arg `(value) => …` functions remain legal via TypeScript's bivariance for trailing parameters. */
+  encode(value: TInput, ctx: CodecCallContext): Promise<TWire>;
+  /** Converts a wire value from the database driver into the JS application type. Always Promise-returning at the boundary. The {@link CodecCallContext} is supplied by the runtime on every call (allocated once per `runtime.execute()`); family layers may narrow the ctx to extend it (e.g. SQL adds `column`). Author-side single-arg `(wire) => …` functions remain legal via TypeScript's bivariance for trailing parameters. */
+  decode(wire: TWire, ctx: CodecCallContext): Promise<TInput>;
   /** Converts a JS value to a JSON-safe representation for contract serialization. Synchronous; called during contract emission. */
   encodeJson(value: TInput): JsonValue;
   /** Converts a JSON representation back to the JS input type. Synchronous; called during contract loading via `validateContract`. */
@@ -54,5 +80,5 @@ interface CodecLookup {
 }
 declare const emptyCodecLookup: CodecLookup;
 //#endregion
-export { emptyCodecLookup as i, CodecLookup as n, CodecTrait as r, Codec as t };
-//# sourceMappingURL=codec-types-Csp_4QDg.d.mts.map
+export { emptyCodecLookup as a, CodecTrait as i, CodecCallContext as n, CodecLookup as r, Codec as t };
+//# sourceMappingURL=codec-types-DXv-ROhF.d.mts.map

package/dist/codec-types-DXv-ROhF.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codec-types-DXv-ROhF.d.mts","names":[],"sources":["../src/shared/codec-types.ts"],"sourcesContent":[],"mappings":";;;KAEY,UAAA;;AAAZ;AAyBA;AAiCA;;;;;;;;;;;;;;;;;;;AAwBA;AAIa,UA7DI,gBAAA,CA+DhB;oBA9DmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UAgCH,2DAEU,wBAAwB;;eAKpC;;;;oBAIK;;gBAEJ,aAAa,mBAAmB,QAAQ;;eAEzC,YAAY,mBAAmB,QAAQ;;oBAElC,SAAS;;mBAEV,YAAY;;gCAEC;;UAGf,WAAA;mBACE;;cAGN,kBAAkB"}

package/dist/codec.d.mts

@@ -1,2 +1,2 @@
-import { i as emptyCodecLookup, n as CodecLookup, r as CodecTrait, t as Codec } from "./codec-types-Csp_4QDg.mjs";
-export { type Codec, type CodecLookup, type CodecTrait, emptyCodecLookup };
+import { a as emptyCodecLookup, i as CodecTrait, n as CodecCallContext, r as CodecLookup, t as Codec } from "./codec-types-DXv-ROhF.mjs";
+export { type Codec, type CodecCallContext, type CodecLookup, type CodecTrait, emptyCodecLookup };

package/dist/codec.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"codec.mjs","names":["emptyCodecLookup: CodecLookup"],"sources":["../src/shared/codec-types.ts"],"sourcesContent":["import type { JsonValue } from '@prisma-next/contract/types';\n\nexport type CodecTrait = 'equality' | 'order' | 'boolean' | 'numeric' | 'textual';\n\n/**\n * A codec is the contract between an application value and its on-wire and\n * on-contract-disk representations.\n *\n * The author's mental model is two JS-side types — `TInput` (the\n * application JS type) and `TWire` (the database driver wire format) —\n * plus `JsonValue` for build-time contract artifacts. The codec translates\n * `TInput` to `TWire` on writes and back on reads, and to/from `JsonValue`\n * during contract emission and loading.\n *\n * Three representations participate:\n * - **Input** (`TInput`): the JS type at the application boundary.\n * - **Wire** (`TWire`): the format exchanged with the database driver.\n * - **JSON** (`JsonValue`): a JSON-safe form used in contract artifacts.\n *\n * Codec methods split into two groups:\n *\n * - **Query-time** methods (`encode`, `decode`) run per row/parameter at the\n *   IO boundary; they are required and Promise-returning. The per-family\n *   codec factory accepts sync or async author functions and lifts sync\n *   ones to Promise-shaped methods automatically.\n * - **Build-time** methods (`encodeJson`, `decodeJson`, `renderOutputType`)\n *   run when the contract is serialized, loaded, or when client types are\n *   emitted. They stay synchronous so contract validation and client\n *   construction are synchronous.\n *\n * Target-family codec interfaces extend this base with target-shaped\n * metadata.\n */\nexport interface Codec<\n  Id extends string = string,\n  TTraits extends readonly CodecTrait[] = readonly CodecTrait[],\n  TWire = unknown,\n  TInput = unknown,\n> {\n  /** Unique codec identifier in `namespace/name@version` format (e.g. `pg/timestamptz@1`). */\n  readonly id: Id;\n  /** Database-native type names this codec handles (e.g. `['timestamptz']`). */\n  readonly targetTypes: readonly string[];\n  /** Semantic traits for operator gating (e.g. equality, order, numeric). */\n  readonly traits?: TTraits;\n  /** Converts a JS value to the wire format expected by the database driver. Always Promise-returning at the boundary. */\n  encode(value: TInput): Promise<TWire>;\n  /** Converts a wire value from the database driver into the JS application type. Always Promise-returning at the boundary. */\n  decode(wire: TWire): Promise<TInput>;\n  /** Converts a JS value to a JSON-safe representation for contract serialization. Synchronous; called during contract emission. */\n  encodeJson(value: TInput): JsonValue;\n  /** Converts a JSON representation back to the JS input type. Synchronous; called during contract loading via `validateContract`. */\n  decodeJson(json: JsonValue): TInput;\n  /** Produces the TypeScript output type expression for a field given its `typeParams`. Synchronous; used during contract.d.ts emission. */\n  renderOutputType?(typeParams: Record<string, unknown>): string | undefined;\n}\n\nexport interface CodecLookup {\n  get(id: string): Codec | undefined;\n}\n\nexport const emptyCodecLookup: CodecLookup = {\n  get: () => undefined,\n};\n"],"mappings":";AA6DA,MAAaA,mBAAgC,EAC3C,WAAW,QACZ"}
+{"version":3,"file":"codec.mjs","names":["emptyCodecLookup: CodecLookup"],"sources":["../src/shared/codec-types.ts"],"sourcesContent":["import type { JsonValue } from '@prisma-next/contract/types';\n\nexport type CodecTrait = 'equality' | 'order' | 'boolean' | 'numeric' | 'textual';\n\n/**\n * Per-call context the runtime threads to every `codec.encode` /\n * `codec.decode` invocation for a single `runtime.execute()` call.\n *\n * The framework-level shape is family-agnostic and carries one field:\n *\n * - `signal?: AbortSignal` — per-query cancellation. The runtime returns\n *   a `RUNTIME.ABORTED` envelope when the signal aborts; codec authors\n *   who forward `signal` to their underlying SDK get true cancellation\n *   of in-flight network calls.\n *\n * Family layers extend this base with their own shape-of-call metadata:\n * the SQL family adds `column?: SqlColumnRef` via `SqlCodecCallContext`\n * (see `@prisma-next/sql-relational-core`). Mongo currently uses this\n * framework type unchanged. Column metadata is intentionally **not** on\n * the framework type — it is a SQL-family concept rooted in SQL's\n * `(table, column)` addressing model and would not generalise to other\n * families.\n *\n * The interface is named explicitly (not inlined) so future framework\n * fields and family extensions can land additively without breaking\n * codec author signatures.\n */\nexport interface CodecCallContext {\n  readonly signal?: AbortSignal;\n}\n\n/**\n * A codec is the contract between an application value and its on-wire and\n * on-contract-disk representations.\n *\n * The author's mental model is two JS-side types — `TInput` (the\n * application JS type) and `TWire` (the database driver wire format) —\n * plus `JsonValue` for build-time contract artifacts. The codec translates\n * `TInput` to `TWire` on writes and back on reads, and to/from `JsonValue`\n * during contract emission and loading.\n *\n * Three representations participate:\n * - **Input** (`TInput`): the JS type at the application boundary.\n * - **Wire** (`TWire`): the format exchanged with the database driver.\n * - **JSON** (`JsonValue`): a JSON-safe form used in contract artifacts.\n *\n * Codec methods split into two groups:\n *\n * - **Query-time** methods (`encode`, `decode`) run per row/parameter at the\n *   IO boundary; they are required and Promise-returning. The per-family\n *   codec factory accepts sync or async author functions and lifts sync\n *   ones to Promise-shaped methods automatically.\n * - **Build-time** methods (`encodeJson`, `decodeJson`, `renderOutputType`)\n *   run when the contract is serialized, loaded, or when client types are\n *   emitted. They stay synchronous so contract validation and client\n *   construction are synchronous.\n *\n * Target-family codec interfaces extend this base with target-shaped\n * metadata.\n */\nexport interface Codec<\n  Id extends string = string,\n  TTraits extends readonly CodecTrait[] = readonly CodecTrait[],\n  TWire = unknown,\n  TInput = unknown,\n> {\n  /** Unique codec identifier in `namespace/name@version` format (e.g. `pg/timestamptz@1`). */\n  readonly id: Id;\n  /** Database-native type names this codec handles (e.g. `['timestamptz']`). */\n  readonly targetTypes: readonly string[];\n  /** Semantic traits for operator gating (e.g. equality, order, numeric). */\n  readonly traits?: TTraits;\n  /** Converts a JS value to the wire format expected by the database driver. Always Promise-returning at the boundary. The {@link CodecCallContext} is supplied by the runtime on every call (allocated once per `runtime.execute()`); family layers may narrow the ctx to extend it (e.g. SQL adds `column`). Author-side single-arg `(value) => …` functions remain legal via TypeScript's bivariance for trailing parameters. */\n  encode(value: TInput, ctx: CodecCallContext): Promise<TWire>;\n  /** Converts a wire value from the database driver into the JS application type. Always Promise-returning at the boundary. The {@link CodecCallContext} is supplied by the runtime on every call (allocated once per `runtime.execute()`); family layers may narrow the ctx to extend it (e.g. SQL adds `column`). Author-side single-arg `(wire) => …` functions remain legal via TypeScript's bivariance for trailing parameters. */\n  decode(wire: TWire, ctx: CodecCallContext): Promise<TInput>;\n  /** Converts a JS value to a JSON-safe representation for contract serialization. Synchronous; called during contract emission. */\n  encodeJson(value: TInput): JsonValue;\n  /** Converts a JSON representation back to the JS input type. Synchronous; called during contract loading via `validateContract`. */\n  decodeJson(json: JsonValue): TInput;\n  /** Produces the TypeScript output type expression for a field given its `typeParams`. Synchronous; used during contract.d.ts emission. */\n  renderOutputType?(typeParams: Record<string, unknown>): string | undefined;\n}\n\nexport interface CodecLookup {\n  get(id: string): Codec | undefined;\n}\n\nexport const emptyCodecLookup: CodecLookup = {\n  get: () => undefined,\n};\n"],"mappings":";AAwFA,MAAaA,mBAAgC,EAC3C,WAAW,QACZ"}

package/dist/components.d.mts

@@ -1,2 +1,2 @@
-import { S as checkContractComponentRequirements, _ as PackRefBase, a as ComponentMetadata, b as TargetInstance, c as DriverDescriptor, d as ExtensionDescriptor, f as ExtensionInstance, g as FamilyPackRef, h as FamilyInstance, i as ComponentDescriptor, l as DriverInstance, m as FamilyDescriptor, n as AdapterInstance, o as ContractComponentRequirementsCheckInput, p as ExtensionPackRef, r as AdapterPackRef, s as ContractComponentRequirementsCheckResult, t as AdapterDescriptor, u as DriverPackRef, v as TargetBoundComponentDescriptor, x as TargetPackRef, y as TargetDescriptor } from "./framework-components-XYjBYPoB.mjs";
+import { S as checkContractComponentRequirements, _ as PackRefBase, a as ComponentMetadata, b as TargetInstance, c as DriverDescriptor, d as ExtensionDescriptor, f as ExtensionInstance, g as FamilyPackRef, h as FamilyInstance, i as ComponentDescriptor, l as DriverInstance, m as FamilyDescriptor, n as AdapterInstance, o as ContractComponentRequirementsCheckInput, p as ExtensionPackRef, r as AdapterPackRef, s as ContractComponentRequirementsCheckResult, t as AdapterDescriptor, u as DriverPackRef, v as TargetBoundComponentDescriptor, x as TargetPackRef, y as TargetDescriptor } from "./framework-components-Buvf7mnC.mjs";
 export { type AdapterDescriptor, type AdapterInstance, type AdapterPackRef, type ComponentDescriptor, type ComponentMetadata, type ContractComponentRequirementsCheckInput, type ContractComponentRequirementsCheckResult, type DriverDescriptor, type DriverInstance, type DriverPackRef, type ExtensionDescriptor, type ExtensionInstance, type ExtensionPackRef, type FamilyDescriptor, type FamilyInstance, type FamilyPackRef, type PackRefBase, type TargetBoundComponentDescriptor, type TargetDescriptor, type TargetInstance, type TargetPackRef, checkContractComponentRequirements };

package/dist/control.d.mts

@@ -1,6 +1,6 @@
 import { a as AuthoringFieldNamespace, d as AuthoringTypeNamespace, i as AuthoringContributions } from "./framework-authoring-BdrFDx4x.mjs";
-import { n as CodecLookup } from "./codec-types-Csp_4QDg.mjs";
-import { A as LoweredDefaultResult, C as ControlMutationDefaultEntry, D as DefaultFunctionLoweringHandler, E as DefaultFunctionLoweringContext, F as SourceSpan, M as MutationDefaultGeneratorDescriptor, N as ParsedDefaultFunctionCall, O as DefaultFunctionRegistry, P as SourceDiagnostic, T as ControlMutationDefaults, a as ComponentMetadata, b as TargetInstance, c as DriverDescriptor, d as ExtensionDescriptor, f as ExtensionInstance, h as FamilyInstance, j as LoweredDefaultValue, k as DefaultFunctionRegistryEntry, l as DriverInstance, m as FamilyDescriptor, n as AdapterInstance, t as AdapterDescriptor, v as TargetBoundComponentDescriptor, w as ControlMutationDefaultRegistry, y as TargetDescriptor } from "./framework-components-XYjBYPoB.mjs";
+import { r as CodecLookup } from "./codec-types-DXv-ROhF.mjs";
+import { A as LoweredDefaultResult, C as ControlMutationDefaultEntry, D as DefaultFunctionLoweringHandler, E as DefaultFunctionLoweringContext, F as SourceSpan, M as MutationDefaultGeneratorDescriptor, N as ParsedDefaultFunctionCall, O as DefaultFunctionRegistry, P as SourceDiagnostic, T as ControlMutationDefaults, a as ComponentMetadata, b as TargetInstance, c as DriverDescriptor, d as ExtensionDescriptor, f as ExtensionInstance, h as FamilyInstance, j as LoweredDefaultValue, k as DefaultFunctionRegistryEntry, l as DriverInstance, m as FamilyDescriptor, n as AdapterInstance, t as AdapterDescriptor, v as TargetBoundComponentDescriptor, w as ControlMutationDefaultRegistry, y as TargetDescriptor } from "./framework-components-Buvf7mnC.mjs";
 import { t as TypesImportSpec } from "./types-import-spec-D-O6GotH.mjs";
 import { t as EmissionSpi } from "./emission-types-D234HxUz.mjs";
 import { m as PslDocumentAst } from "./psl-ast-9X5rwo98.mjs";

package/dist/control.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"control.d.mts","names":[],"sources":["../src/control/control-result-types.ts","../src/control/control-instances.ts","../src/control/control-stack.ts","../src/control/control-descriptors.ts","../src/control/control-migration-types.ts","../src/control/control-operation-preview.ts","../src/control/control-schema-view.ts","../src/control/control-capabilities.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"control.d.mts","names":[],"sources":["../src/control/control-result-types.ts","../src/control/control-instances.ts","../src/control/control-stack.ts","../src/control/control-descriptors.ts","../src/control/control-migration-types.ts","../src/control/control-operation-preview.ts","../src/control/control-schema-view.ts","../src/control/control-capabilities.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/execution.d.mts

@@ -1,4 +1,4 @@
-import { b as TargetInstance, c as DriverDescriptor, d as ExtensionDescriptor, f as ExtensionInstance, h as FamilyInstance, l as DriverInstance, m as FamilyDescriptor, n as AdapterInstance, t as AdapterDescriptor, y as TargetDescriptor } from "./framework-components-XYjBYPoB.mjs";
+import { b as TargetInstance, c as DriverDescriptor, d as ExtensionDescriptor, f as ExtensionInstance, h as FamilyInstance, l as DriverInstance, m as FamilyDescriptor, n as AdapterInstance, t as AdapterDescriptor, y as TargetDescriptor } from "./framework-components-Buvf7mnC.mjs";
 
 //#region src/execution/execution-instances.d.ts
 interface RuntimeFamilyInstance<TFamilyId extends string> extends FamilyInstance<TFamilyId> {}

package/dist/framework-authoring-BdrFDx4x.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"framework-authoring-BdrFDx4x.d.mts","names":[],"sources":["../src/shared/framework-authoring.ts"],"sourcesContent":[],"mappings":";KAEY,eAAA;EAAA,SAAA,IAAA,EAAA,KAAe;EAOf,SAAA,KAAA,EAAA,MAAA;EAKR,SAAA,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EACS,SAAA,OAAA,CAAA,EATQ,sBASR;CACiB;AAAsB,KAPxC,sBAAA,GAOwC,MAAA,GAAA,MAAA,GAAA,OAAA,GAAA,IAAA,GAFhD,eAEgD,GAAA,SADvC,sBACuC,EAAA,GAAA;EAE1C,UAAA,GAAA,EAAA,MAAA,CAAA,EAFoB,sBAEa;AAK3C,CAAA;UALU,iCAAA,CAKgC;EAYE,SAAA,IAAA,CAAA,EAAA,MAAA;EAAf,SAAA,QAAA,CAAA,EAAA,OAAA;;AAIZ,KAhBL,2BAAA,GAA8B,iCAgBG,GAAA,CAAA;EAEtB,SAAA,IAAA,EAAA,QAAA;CACgB,GAAA;EAAf,SAAA,IAAA,EAAA,QAAA;EAAM,SAAA,OAAA,CAAA,EAAA,OAAA;EAGb,SAAA,OAAA,CAAA,EAAA,MAAA;EAMA,SAAA,OAAA,CAAA,EAAA,MAAA;AAKjB,CAAA,GAAiB;EAKL,SAAA,IAAA,EAAA,aAAA;AAIZ,CAAA,GAAiB;EAEI,SAAA,IAAA,EAAA,QAAA;EACS,SAAA,UAAA,EAjCD,MAiCC,CAAA,MAAA,EAjCc,2BAiCd,CAAA;CAHsB,CAAA;AAA4B,UA1B/D,4BAAA,CA0B+D;EAQ/D,SAAA,OAAA,EAAA,MAAA;EAML,SAAA,UAAA,EAtCW,sBAuCI;EAGf,SAAA,UAAA,CAAA,EAzCY,MAyCW,CAAA,MAAA,EAzCI,sBA0CZ,CAAA;AAG3B;AAKgB,UA/CC,kCAAA,CA+C2C;EAkB5C,SAAA,IAAA,EAAA,iBAAA;EAYA,SAAA,IAAA,CAAA,EAAA,SA3EW,2BA6Ef,EAAA;EAUI,SAAA,MAAA,EAtFG,4BAuFP;AA2GZ;AAuFgB,UAtRC,qCAAA,CAuRH;EAUE,SAAA,IAAA,EAAA,SAAA;kBA/RE;;UAGD,sCAAA;;uBAEM;;KAGX,8BAAA,GACR,wCACA;UAEa,0BAAA,SAAmC;;qBAE/B;8BACS;;;;UAKb,8BAAA;;2BAEU;mBACR;;KAGP,sBAAA;2BACe,qCAAqC;;KAGpD,uBAAA;2BACe,iCAAiC;;UAG3C,sBAAA;kBACC;mBACC;;iBAGH,iBAAA,2BAA4C;iBAkB5C,oCAAA,2BAEJ;iBAUI,gCAAA,2BAEJ;iBAUI,6BAAA,WACJ;iBA2GI,gCAAA,2CAEQ;iBAqFR,mCAAA,aACF;;;wBAKU;;iBAKR,+BAAA,aACF;;;;0BAMY"}
+{"version":3,"file":"framework-authoring-BdrFDx4x.d.mts","names":[],"sources":["../src/shared/framework-authoring.ts"],"sourcesContent":[],"mappings":";KAEY,eAAA;EAAA,SAAA,IAAA,EAAA,KAAe;EAOf,SAAA,KAAA,EAAA,MAAA;EAKR,SAAA,IAAA,CAAA,EAAA,SAAA,MAAA,EAAA;EACS,SAAA,OAAA,CAAA,EATQ,sBASR;CACiB;AAAsB,KAPxC,sBAAA,GAOwC,MAAA,GAAA,MAAA,GAAA,OAAA,GAAA,IAAA,GAFhD,eAEgD,GAAA,SADvC,sBACuC,EAAA,GAAA;EAE1C,UAAA,GAAA,EAAA,MAAA,CAAA,EAFoB,sBAEa;AAK3C,CAAA;UALU,iCAAA,CAKgC;EAYE,SAAA,IAAA,CAAA,EAAA,MAAA;EAAf,SAAA,QAAA,CAAA,EAAA,OAAA;;AAIZ,KAhBL,2BAAA,GAA8B,iCAgBG,GAAA,CAAA;EAEtB,SAAA,IAAA,EAAA,QAAA;CACgB,GAAA;EAAf,SAAA,IAAA,EAAA,QAAA;EAAM,SAAA,OAAA,CAAA,EAAA,OAAA;EAGb,SAAA,OAAA,CAAA,EAAA,MAAA;EAMA,SAAA,OAAA,CAAA,EAAA,MAAA;AAKjB,CAAA,GAAiB;EAKL,SAAA,IAAA,EAAA,aAAA;AAIZ,CAAA,GAAiB;EAEI,SAAA,IAAA,EAAA,QAAA;EACS,SAAA,UAAA,EAjCD,MAiCC,CAAA,MAAA,EAjCc,2BAiCd,CAAA;CAHsB,CAAA;AAA4B,UA1B/D,4BAAA,CA0B+D;EAQ/D,SAAA,OAAA,EAAA,MAAA;EAML,SAAA,UAAA,EAtCW,sBAuCI;EAGf,SAAA,UAAA,CAAA,EAzCY,MAyCW,CAAA,MAAA,EAzCI,sBA0CZ,CAAA;AAG3B;AAKgB,UA/CC,kCAAA,CA+C0D;EAkB3D,SAAA,IAAA,EAAA,iBAAA;EAYA,SAAA,IAAA,CAAA,EAAA,SA3EW,2BA6Ef,EAAA;EAUI,SAAA,MAAA,EAtFG,4BAuFP;AA2GZ;AAuFgB,UAtRC,qCAAA,CAuRH;EAUE,SAAA,IAAA,EAAA,SAAA;kBA/RE;;UAGD,sCAAA;;uBAEM;;KAGX,8BAAA,GACR,wCACA;UAEa,0BAAA,SAAmC;;qBAE/B;8BACS;;;;UAKb,8BAAA;;2BAEU;mBACR;;KAGP,sBAAA;2BACe,qCAAqC;;KAGpD,uBAAA;2BACe,iCAAiC;;UAG3C,sBAAA;kBACC;mBACC;;iBAGH,iBAAA,2BAA4C;iBAkB5C,oCAAA,2BAEJ;iBAUI,gCAAA,2BAEJ;iBAUI,6BAAA,WACJ;iBA2GI,gCAAA,2CAEQ;iBAqFR,mCAAA,aACF;;;wBAKU;;iBAKR,+BAAA,aACF;;;;0BAMY"}

package/dist/{framework-components-XYjBYPoB.d.mts → framework-components-Buvf7mnC.d.mts}

@@ -1,5 +1,5 @@
 import { i as AuthoringContributions } from "./framework-authoring-BdrFDx4x.mjs";
-import { t as Codec } from "./codec-types-Csp_4QDg.mjs";
+import { t as Codec } from "./codec-types-DXv-ROhF.mjs";
 import { t as TypesImportSpec } from "./types-import-spec-D-O6GotH.mjs";
 import { ColumnDefault, ExecutionMutationDefaultValue } from "@prisma-next/contract/types";
 
@@ -421,4 +421,4 @@ interface ExtensionInstance<TFamilyId extends string, TTargetId extends string>
 }
 //#endregion
 export { LoweredDefaultResult as A, ControlMutationDefaultEntry as C, DefaultFunctionLoweringHandler as D, DefaultFunctionLoweringContext as E, SourceSpan as F, MutationDefaultGeneratorDescriptor as M, ParsedDefaultFunctionCall as N, DefaultFunctionRegistry as O, SourceDiagnostic as P, checkContractComponentRequirements as S, ControlMutationDefaults as T, PackRefBase as _, ComponentMetadata as a, TargetInstance as b, DriverDescriptor as c, ExtensionDescriptor as d, ExtensionInstance as f, FamilyPackRef as g, FamilyInstance as h, ComponentDescriptor as i, LoweredDefaultValue as j, DefaultFunctionRegistryEntry as k, DriverInstance as l, FamilyDescriptor as m, AdapterInstance as n, ContractComponentRequirementsCheckInput as o, ExtensionPackRef as p, AdapterPackRef as r, ContractComponentRequirementsCheckResult as s, AdapterDescriptor as t, DriverPackRef as u, TargetBoundComponentDescriptor as v, ControlMutationDefaultRegistry as w, TargetPackRef as x, TargetDescriptor as y };
-//# sourceMappingURL=framework-components-XYjBYPoB.d.mts.map
+//# sourceMappingURL=framework-components-Buvf7mnC.d.mts.map

package/dist/{framework-components-XYjBYPoB.d.mts.map → framework-components-Buvf7mnC.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"framework-components-XYjBYPoB.d.mts","names":[],"sources":["../src/shared/mutation-default-types.ts","../src/shared/framework-components.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"framework-components-Buvf7mnC.d.mts","names":[],"sources":["../src/shared/mutation-default-types.ts","../src/shared/framework-components.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/runtime.d.mts

@@ -1,3 +1,4 @@
+import { n as CodecCallContext } from "./codec-types-DXv-ROhF.mjs";
 import { PlanMeta } from "@prisma-next/contract/types";
 
 //#region src/execution/async-iterable-result.d.ts
@@ -63,6 +64,86 @@ type ResultType<P> = '_row' extends keyof P ? P extends {
   readonly _row?: infer R;
 } ? R : never : never;
 //#endregion
+//#region src/execution/runtime-error.d.ts
+interface RuntimeErrorEnvelope extends Error {
+  readonly code: string;
+  readonly category: 'PLAN' | 'CONTRACT' | 'LINT' | 'BUDGET' | 'RUNTIME';
+  readonly severity: 'error';
+  readonly details?: Record<string, unknown>;
+}
+/**
+ * Stable code emitted by the runtime when an in-flight `execute()`
+ * is cancelled via the per-query `AbortSignal`. The envelope's
+ * `details.phase` distinguishes where the abort was observed:
+ *
+ * - `'encode'` — abort fired during `encodeParams` (SQL) or
+ *   `resolveValue` (Mongo).
+ * - `'decode'` — abort fired during `decodeRow` / `decodeField`.
+ * - `'stream'` — abort fired between rows or before any codec call
+ *   (already-aborted at entry).
+ */
+declare const RUNTIME_ABORTED: "RUNTIME.ABORTED";
+/** Discriminator placed in `details.phase` of a `RUNTIME.ABORTED` envelope. */
+type RuntimeAbortedPhase = 'encode' | 'decode' | 'stream';
+/**
+ * Type guard for the runtime-error envelope produced by `runtimeError`.
+ *
+ * Prefer this over duck-typing on `error.code` directly so consumers stay
+ * insulated from the envelope's internal shape.
+ */
+declare function isRuntimeError(error: unknown): error is RuntimeErrorEnvelope;
+declare function runtimeError(code: string, message: string, details?: Record<string, unknown>): RuntimeErrorEnvelope;
+/**
+ * Construct a `RUNTIME.ABORTED` envelope. Phase distinguishes where the
+ * abort was observed (encode / decode / stream); cause carries `signal.reason`
+ * verbatim from the platform — native abort produces a `DOMException`,
+ * explicit `controller.abort(reason)` produces whatever the caller passed.
+ * No synthesis happens here.
+ */
+declare function runtimeAborted(phase: RuntimeAbortedPhase, cause?: unknown): RuntimeErrorEnvelope;
+//#endregion
+//#region src/execution/race-against-abort.d.ts
+/**
+ * Throw a phase-tagged `RUNTIME.ABORTED` envelope if the supplied
+ * codec-call context is already aborted at the precheck site. Centralises
+ * the `if (ctx.signal?.aborted) throw runtimeAborted(...)` pattern that
+ * every codec dispatch site repeats.
+ */
+declare function checkAborted(ctx: CodecCallContext, phase: RuntimeAbortedPhase): void;
+/**
+ * Race a per-cell `Promise.all` (or any other in-flight work promise) against
+ * the supplied abort signal so the runtime returns `RUNTIME.ABORTED` promptly
+ * even when codec bodies ignore the signal. In-flight bodies that ignore the
+ * signal are abandoned and run to completion in the background — the
+ * cooperative-cancellation contract documented in ADR 204.
+ *
+ * Call sites still SHOULD pre-check `signal.aborted` and short-circuit with
+ * a phase-tagged `RUNTIME.ABORTED` envelope before invoking this helper —
+ * that path is the canonical "aborted at entry" surface and avoids
+ * scheduling the work promise. As a defensive belt-and-braces, this helper
+ * also handles the already-aborted case internally: `AbortSignal` does not
+ * replay past abort events to listeners registered after the abort, so we
+ * inspect `signal.aborted` synchronously and reject with the sentinel
+ * before installing the listener. The rejection is still attributed to the
+ * abort path via the sentinel-identity check.
+ *
+ * Distinguishing the rejection source is load-bearing for AC-ERR4
+ * (`RUNTIME.ENCODE_FAILED` / `RUNTIME.DECODE_FAILED` pass through unchanged).
+ * The semantically equivalent `abortable(signal)` helper in
+ * `@prisma-next/utils` rejects with `signal.reason ?? new DOMException(...)`,
+ * which is not stably distinguishable from a codec-thrown error by identity
+ * alone (a fresh fallback DOMException is allocated per call). We instead
+ * track abort attribution with a unique sentinel: only the `onAbort` listener
+ * installed here ever rejects with the sentinel, so an `error === sentinel`
+ * identity check after the race is unambiguous.
+ *
+ * Lives in `framework-components` (rather than the SQL family, where it
+ * originated in m2) so every family runtime that needs cooperative
+ * cancellation around a codec-dispatch `Promise.all` (SQL encode + decode
+ * today, Mongo encode in m3) shares the same attribution logic.
+ */
+declare function raceAgainstAbort<T>(work: Promise<T>, signal: AbortSignal | undefined, phase: RuntimeAbortedPhase): Promise<T>;
+//#endregion
 //#region src/execution/runtime-middleware.d.ts
 interface RuntimeLog {
   info(event: unknown): void;
@@ -97,6 +178,18 @@ interface RuntimeMiddleware<TPlan extends QueryPlan = QueryPlan> {
   onRow?(row: Record<string, unknown>, plan: TPlan, ctx: RuntimeMiddlewareContext): Promise<void>;
   afterExecute?(plan: TPlan, result: AfterExecuteResult, ctx: RuntimeMiddlewareContext): Promise<void>;
 }
+/**
+ * Optional per-`execute` options accepted by every family runtime.
+ *
+ * `signal` is the per-query cancellation signal. The runtime threads the
+ * signal through to every codec call for the query and uses it to short-
+ * circuit the row stream with `RUNTIME.ABORTED` when the caller aborts.
+ * Omitting the option (or passing `undefined`) preserves today's behavior
+ * bit-for-bit.
+ */
+interface RuntimeExecuteOptions {
+  readonly signal?: AbortSignal;
+}
 /**
  * Cross-family SPI for any runtime that can execute plans and be shut down.
  * Each family runtime (SQL, Mongo) satisfies this interface — SQL nominally,
@@ -108,7 +201,7 @@ interface RuntimeMiddleware<TPlan extends QueryPlan = QueryPlan> {
 interface RuntimeExecutor<TPlan extends QueryPlan> {
   execute<Row>(plan: TPlan & {
     readonly _row?: Row;
-  }): AsyncIterableResult<Row>;
+  }, options?: RuntimeExecuteOptions): AsyncIterableResult<Row>;
   close(): Promise<void>;
 }
 declare function checkMiddlewareCompatibility(middleware: RuntimeMiddleware, runtimeFamilyId: string, runtimeTargetId: string): void;
@@ -185,8 +278,16 @@ declare abstract class RuntimeCore<TPlan extends QueryPlan, TExec extends Execut
    * Lower a pre-lowering `TPlan` into the family's executable `TExec`.
    * Family-specific: SQL produces `{ sql, params, ast?, ... }`; Mongo
    * produces `{ command, ... }`.
+   *
+   * `ctx` carries per-query cancellation (and any future fields on
+   * `CodecCallContext`); concrete subclasses forward it to the
+   * encode-side codec dispatch site (e.g. SQL's `encodeParams` in m2,
+   * Mongo's `resolveValue` in m3). The runtime allocates one ctx per
+   * `execute()` call and threads the same reference everywhere; the
+   * `signal` field inside may be `undefined`, but the ctx object itself
+   * is always present.
    */
-  protected abstract lower(plan: TPlan): TExec | Promise<TExec>;
+  protected abstract lower(plan: TPlan, ctx: CodecCallContext): TExec | Promise<TExec>;
   /**
    * Drive the underlying transport for a lowered `TExec`. Yields raw rows
    * directly from the driver as `Record<string, unknown>`; codec decoding
@@ -201,24 +302,8 @@ declare abstract class RuntimeCore<TPlan extends QueryPlan, TExec extends Execut
   abstract close(): Promise<void>;
   execute<Row>(plan: TPlan & {
     readonly _row?: Row;
-  }): AsyncIterableResult<Row>;
+  }, options?: RuntimeExecuteOptions): AsyncIterableResult<Row>;
 }
 //#endregion
-//#region src/execution/runtime-error.d.ts
-interface RuntimeErrorEnvelope extends Error {
-  readonly code: string;
-  readonly category: 'PLAN' | 'CONTRACT' | 'LINT' | 'BUDGET' | 'RUNTIME';
-  readonly severity: 'error';
-  readonly details?: Record<string, unknown>;
-}
-/**
- * Type guard for the runtime-error envelope produced by `runtimeError`.
- *
- * Prefer this over duck-typing on `error.code` directly so consumers stay
- * insulated from the envelope's internal shape.
- */
-declare function isRuntimeError(error: unknown): error is RuntimeErrorEnvelope;
-declare function runtimeError(code: string, message: string, details?: Record<string, unknown>): RuntimeErrorEnvelope;
-//#endregion
-export { type AfterExecuteResult, AsyncIterableResult, type ExecutionPlan, type QueryPlan, type ResultType, RuntimeCore, type RuntimeCoreOptions, type RuntimeErrorEnvelope, type RuntimeExecutor, type RuntimeLog, type RuntimeMiddleware, type RuntimeMiddlewareContext, checkMiddlewareCompatibility, isRuntimeError, runWithMiddleware, runtimeError };
+export { type AfterExecuteResult, AsyncIterableResult, type ExecutionPlan, type QueryPlan, RUNTIME_ABORTED, type ResultType, type RuntimeAbortedPhase, RuntimeCore, type RuntimeCoreOptions, type RuntimeErrorEnvelope, type RuntimeExecuteOptions, type RuntimeExecutor, type RuntimeLog, type RuntimeMiddleware, type RuntimeMiddlewareContext, checkAborted, checkMiddlewareCompatibility, isRuntimeError, raceAgainstAbort, runWithMiddleware, runtimeAborted, runtimeError };
 //# sourceMappingURL=runtime.d.mts.map

package/dist/runtime.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/execution/async-iterable-result.ts","../src/execution/query-plan.ts","../src/execution/runtime-middleware.ts","../src/execution/run-with-middleware.ts","../src/execution/runtime-core.ts","../src/execution/runtime-error.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/execution/async-iterable-result.ts","../src/execution/query-plan.ts","../src/execution/runtime-error.ts","../src/execution/race-against-abort.ts","../src/execution/runtime-middleware.ts","../src/execution/run-with-middleware.ts","../src/execution/runtime-core.ts"],"sourcesContent":[],"mappings":";;;;cAEa,oCAAoC,cAAc,MAAM,YAAY;;;;EAApE,QAAA,oBAAmB;EAA+B,WAAA,CAAA,SAAA,EAMtC,cANsC,CAMvB,GANuB,EAAA,IAAA,EAAA,OAAA,CAAA;EAAkB,CAU9E,MAAA,CAAO,aAAA,GAVuE,EAUrD,aAVqD,CAUvC,GAVuC,CAAA;EAMzC,OAAA,CAAA,CAAA,EAuB3B,OAvB2B,CAuBnB,GAvBmB,EAAA,CAAA;EAAf,KAAA,CAAA,CAAA,EAsDR,OAtDQ,CAsDA,GAtDA,GAAA,IAAA,CAAA;EAIiB,YAAA,CAAA,CAAA,EAuDlB,OAvDkB,CAuDV,GAvDU,CAAA;EAAd,IAAA,CAAA,WAmEV,GAnEU,EAAA,EAAA,WAAA,KAAA,CAAA,CAAA,WAAA,CAAA,EAAA,CAAA,CAAA,KAAA,EAoED,GApEC,EAAA,EAAA,GAoES,QApET,GAoEoB,WApEpB,CAoEgC,QApEhC,CAAA,CAAA,GAAA,SAAA,GAAA,IAAA,EAAA,UAAA,CAAA,EAAA,CAAA,CAAA,MAAA,EAAA,OAAA,EAAA,GAqEW,QArEX,GAqEsB,WArEtB,CAqEkC,QArElC,CAAA,CAAA,GAAA,SAAA,GAAA,IAAA,CAAA,EAsEvB,WAtEuB,CAsEX,QAtEW,GAsEA,QAtEA,CAAA;;;;;;;AAV5B;;;;;;;;;AA6Ba,UCjBI,SDiBJ,CAAA,MAAA,OAAA,CAAA,CAAA;EA+BY,SAAA,IAAA,EC/CR,QD+CQ;EAAR;;;;EAkBU,SAAA,IAAA,CAAA,EC5DT,GD4DS;;;;;;;;;;;AA9E0C,UC8BpD,aD9BoD,CAAA,MAAA,OAAA,CAAA,SC8Bf,SD9Be,CC8BL,GD9BK,CAAA,CAAA;;;;ACYrE;AAkBA;AAgBA;;;;AChDA;AAkBA;AAGA;AAQA;AAUA;AAwCgB,KD/BJ,UC+BkB,CAAA,CAAA,CAAA,GAAA,MAAQ,SAAA,MD/BW,CC+BX,GD9BlC,CC8ByE,SAAA;;;;;UA/E5D,oBAAA,SAA6B;;;;EFEjC,SAAA,OAAA,CAAA,EEEQ,MFFW,CAAA,MAAA,EAAA,OAAA,CAAA;;;;;;;;;;;;;AAiER,cEjDX,eFiDW,EAAA,iBAAA;;AAaG,KE3Df,mBAAA,GF2De,QAAA,GAAA,QAAA,GAAA,QAAA;;;;;;;AAEV,iBErDD,cAAA,CFqDC,KAAA,EAAA,OAAA,CAAA,EAAA,KAAA,IErDwC,oBFqDxC;AAAW,iBE3CZ,YAAA,CF2CY,IAAA,EAAA,MAAA,EAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EExChB,MFwCgB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA,EEvCzB,oBFuCyB;;;;;;;;ACpEX,iBCiED,cAAA,CDhEC,KAKC,EC2DoB,mBD3DjB,EAAA,KAAA,CAAA,EAAA,OAAA,CAAA,EC2DwD,oBD3DxD;;;;;ADlBrB;;;;AAMyB,iBGET,YAAA,CHFS,GAAA,EGES,gBHFT,EAAA,KAAA,EGEkC,mBHFlC,CAAA,EAAA,IAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;ACMzB;AAkBA;AAgBA;;;;AChDiB,iBCgDK,gBD5CD,CAAA,CAAA,CAAA,CAAA,IAJyB,ECiDtC,ODjD2C,CCiDnC,CDjDmC,CAAA,EAAA,MAAA,ECkDzC,WDlDyC,GAAA,SAAA,EAAA,KAAA,ECmD1C,mBDnD0C,CAAA,ECoDhD,ODpDgD,CCoDxC,CDpDwC,CAAA;;;UEIlC,UAAA;;EJFJ,IAAA,CAAA,KAAA,EAAA,OAAA,CAAA,EAAmB,IAAA;EAA+B,KAAA,CAAA,KAAA,EAAA,OAAA,CAAA,EAAA,IAAA;EAAkB,KAAA,EAAA,KAAA,EAAA,OAAA,CAAA,EAAA,IAAA;;AAMxD,UIGR,wBAAA,CJHQ;EAIiB,SAAA,QAAA,EAAA,OAAA;EAAd,SAAA,IAAA,EAAA,QAAA,GAAA,YAAA;EAAzB,SAAO,GAAA,EAAA,GAAA,GAAA,MAAA;EAmBW,SAAA,GAAA,EIhBL,UJgBK;;AA+BI,UI5CR,kBAAA,CJ4CQ;EAAR,SAAA,QAAA,EAAA,MAAA;EAKe,SAAA,SAAA,EAAA,MAAA;EAAR,SAAA,SAAA,EAAA,OAAA;;;;;;;;;;AAeI,UIlDX,iBJkDW,CAAA,cIlDqB,SJkDrB,GIlDiC,SJkDjC,CAAA,CAAA;EAAvB,SAAA,IAAA,EAAA,MAAA;EAhF4C,SAAA,QAAA,CAAA,EAAA,MAAA;EAAoB,SAAA,QAAA,CAAA,EAAA,MAAA;EAAW,aAAA,EAAA,IAAA,EIkCzD,KJlCyD,EAAA,GAAA,EIkC7C,wBJlC6C,CAAA,EIkClB,OJlCkB,CAAA,IAAA,CAAA;cImClE,+BAA+B,YAAY,2BAA2B;sBAE1E,eACE,yBACH,2BACJ;;AH5BL;AAkBA;AAgBA;;;;AChDA;AAkBA;AAGA;AAQgB,UEyBC,qBAAA,CFzBwC;EAUzC,SAAA,MAAY,CAAA,EEgBR,WFbR;AAqCZ;;;;ACrEA;AAsCA;;;;AAGS,UCeQ,eDfR,CAAA,cCesC,SDftC,CAAA,CAAA;EACE,OAAA,CAAA,GAAA,CAAA,CAAA,IAAA,ECgBD,KDhBC,GAAA;IAAR,SAAA,IAAA,CAAA,ECgBiC,GDhBjC;EAAO,CAAA,EAAA,OAAA,CAAA,ECiBI,qBDjBJ,CAAA,ECkBL,mBDlBK,CCkBe,GDlBf,CAAA;WCmBC;;iBAGK,4BAAA,aACF;;;;AJzEd;;;;;;;;;;;;;;;;;AA8E4D,iBK1D5C,iBL0D4C,CAAA,cK1DZ,aL0DY,EAAA,GAAA,CAAA,CAAA,IAAA,EKzDpD,KLyDoD,EAAA,UAAA,EKxD9C,aLwD8C,CKxDhC,iBLwDgC,CKxDd,KLwDc,CAAA,CAAA,EAAA,GAAA,EKvDrD,wBLuDqD,EAAA,SAAA,EAAA,GAAA,GKtDzC,aLsDyC,CKtD3B,GLsD2B,CAAA,CAAA,EKrDzD,mBLqDyD,CKrDrC,GLqDqC,CAAA;;;AA9E5D;;;;;;;AAUG,UMOc,kBNPP,CAAA,oBMO8C,iBNP9C,CMOgE,aNPhE,CAAA,CAAA,CAAA;EAmBW,SAAA,UAAA,EMXE,aNWF,CMXgB,WNWhB,CAAA;EAAR,SAAA,GAAA,EMVG,wBNUH;;;;;;;;;;;;;;;;;;;;;;ACjBb;AAkBA;AAgBA;;;uBKCsB,0BACN,yBACA,mCACM,kBAAkB,mBAC3B,gBAAgB;EJrDZ,mBAAA,UAAqB,EIuDL,aJvDa,CIuDC,WJvDI,CAAA;EAkBtC,mBAA4C,GAAA,EIsC/B,wBJtC+B;EAG7C,WAAA,CAAA,OAAA,EIqCW,kBJrCQ,CIqCW,WJrCX,CAAA;EAQf;AAUhB;AAwCA;;;mCIXmC,QAAQ,QAAQ,QAAQ;EH1D3C;AAsChB;;;;;;;;;;;AC5CA;EAOiB,mBAAA,KAAA,CAAA,IAAwB,EE0ER,KF1EQ,EAAA,GAIzB,EEsE6B,gBFtEnB,CAAA,EEsEsC,KFtEtC,GEsE8C,OFtE9C,CEsEsD,KFtEtD,CAAA;EAGT;AAcjB;;;;;;;;;EAKoF,mBAAA,SAAA,CAAA,IAAA,EE4D/C,KF5D+C,CAAA,EE4DvC,aF5DuC,CE4DzB,MF5DyB,CAAA,MAAA,EAAA,OAAA,CAAA,CAAA;EAE1E,SAAA,KAAA,CAAA,CAAA,EE4DU,OF5DV,CAAA,IAAA,CAAA;EACE,OAAA,CAAA,GAAA,CAAA,CAAA,IAAA,EE8DF,KF9DE,GAAA;IACH,SAAA,IAAA,CAAA,EE6D2B,GF7D3B;EACJ,CAAA,EAAA,OAAA,CAAA,EE6DS,qBF7DT,CAAA,EE8DA,mBF9DA,CE8DoB,GF9DpB,CAAA"}

package/dist/runtime.mjs

@@ -1,5 +1,17 @@
 //#region src/execution/runtime-error.ts
 /**
+* Stable code emitted by the runtime when an in-flight `execute()`
+* is cancelled via the per-query `AbortSignal`. The envelope's
+* `details.phase` distinguishes where the abort was observed:
+*
+* - `'encode'` — abort fired during `encodeParams` (SQL) or
+*   `resolveValue` (Mongo).
+* - `'decode'` — abort fired during `decodeRow` / `decodeField`.
+* - `'stream'` — abort fired between rows or before any codec call
+*   (already-aborted at entry).
+*/
+const RUNTIME_ABORTED = "RUNTIME.ABORTED";
+/**
 * Type guard for the runtime-error envelope produced by `runtimeError`.
 *
 * Prefer this over duck-typing on `error.code` directly so consumers stay
@@ -32,6 +44,17 @@ function resolveCategory(code) {
 		default: return "RUNTIME";
 	}
 }
+/**
+* Construct a `RUNTIME.ABORTED` envelope. Phase distinguishes where the
+* abort was observed (encode / decode / stream); cause carries `signal.reason`
+* verbatim from the platform — native abort produces a `DOMException`,
+* explicit `controller.abort(reason)` produces whatever the caller passed.
+* No synthesis happens here.
+*/
+function runtimeAborted(phase, cause) {
+	const envelope = runtimeError(RUNTIME_ABORTED, `Operation aborted during ${phase}`, { phase });
+	return Object.assign(envelope, { cause });
+}
 
 //#endregion
 //#region src/execution/async-iterable-result.ts
@@ -80,6 +103,75 @@ var AsyncIterableResult = class {
 	}
 };
 
+//#endregion
+//#region src/execution/race-against-abort.ts
+/**
+* Throw a phase-tagged `RUNTIME.ABORTED` envelope if the supplied
+* codec-call context is already aborted at the precheck site. Centralises
+* the `if (ctx.signal?.aborted) throw runtimeAborted(...)` pattern that
+* every codec dispatch site repeats.
+*/
+function checkAborted(ctx, phase) {
+	if (ctx.signal?.aborted) throw runtimeAborted(phase, ctx.signal.reason);
+}
+/**
+* Race a per-cell `Promise.all` (or any other in-flight work promise) against
+* the supplied abort signal so the runtime returns `RUNTIME.ABORTED` promptly
+* even when codec bodies ignore the signal. In-flight bodies that ignore the
+* signal are abandoned and run to completion in the background — the
+* cooperative-cancellation contract documented in ADR 204.
+*
+* Call sites still SHOULD pre-check `signal.aborted` and short-circuit with
+* a phase-tagged `RUNTIME.ABORTED` envelope before invoking this helper —
+* that path is the canonical "aborted at entry" surface and avoids
+* scheduling the work promise. As a defensive belt-and-braces, this helper
+* also handles the already-aborted case internally: `AbortSignal` does not
+* replay past abort events to listeners registered after the abort, so we
+* inspect `signal.aborted` synchronously and reject with the sentinel
+* before installing the listener. The rejection is still attributed to the
+* abort path via the sentinel-identity check.
+*
+* Distinguishing the rejection source is load-bearing for AC-ERR4
+* (`RUNTIME.ENCODE_FAILED` / `RUNTIME.DECODE_FAILED` pass through unchanged).
+* The semantically equivalent `abortable(signal)` helper in
+* `@prisma-next/utils` rejects with `signal.reason ?? new DOMException(...)`,
+* which is not stably distinguishable from a codec-thrown error by identity
+* alone (a fresh fallback DOMException is allocated per call). We instead
+* track abort attribution with a unique sentinel: only the `onAbort` listener
+* installed here ever rejects with the sentinel, so an `error === sentinel`
+* identity check after the race is unambiguous.
+*
+* Lives in `framework-components` (rather than the SQL family, where it
+* originated in m2) so every family runtime that needs cooperative
+* cancellation around a codec-dispatch `Promise.all` (SQL encode + decode
+* today, Mongo encode in m3) shares the same attribution logic.
+*/
+async function raceAgainstAbort(work, signal, phase) {
+	if (signal === void 0) return await work;
+	const sentinel = { reason: void 0 };
+	let onAbort;
+	const abortPromise = new Promise((_, reject) => {
+		if (signal.aborted) {
+			sentinel.reason = signal.reason;
+			reject(sentinel);
+			return;
+		}
+		onAbort = () => {
+			sentinel.reason = signal.reason;
+			reject(sentinel);
+		};
+		signal.addEventListener("abort", onAbort, { once: true });
+	});
+	try {
+		return await Promise.race([work, abortPromise]);
+	} catch (error) {
+		if (error === sentinel) throw runtimeAborted(phase, sentinel.reason);
+		throw error;
+	} finally {
+		if (onAbort) signal.removeEventListener("abort", onAbort);
+	}
+}
+
 //#endregion
 //#region src/execution/run-with-middleware.ts
 /**
@@ -176,11 +268,14 @@ var RuntimeCore = class {
 	runBeforeCompile(plan) {
 		return plan;
 	}
-	execute(plan) {
+	execute(plan, options) {
 		const self = this;
+		const signal = options?.signal;
+		const codecCtx = signal === void 0 ? {} : { signal };
 		async function* generator() {
+			checkAborted(codecCtx, "stream");
 			const compiled = await self.runBeforeCompile(plan);
-			const exec = await self.lower(compiled);
+			const exec = await self.lower(compiled, codecCtx);
 			yield* runWithMiddleware(exec, self.middleware, self.ctx, () => self.runDriver(exec));
 		}
 		return new AsyncIterableResult(generator());
@@ -207,5 +302,5 @@ function checkMiddlewareCompatibility(middleware, runtimeFamilyId, runtimeTarget
 }
 
 //#endregion
-export { AsyncIterableResult, RuntimeCore, checkMiddlewareCompatibility, isRuntimeError, runWithMiddleware, runtimeError };
+export { AsyncIterableResult, RUNTIME_ABORTED, RuntimeCore, checkAborted, checkMiddlewareCompatibility, isRuntimeError, raceAgainstAbort, runWithMiddleware, runtimeAborted, runtimeError };
 //# sourceMappingURL=runtime.mjs.map

package/dist/runtime.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.mjs","names":["out: Row[]","latencyMs"],"sources":["../src/execution/runtime-error.ts","../src/execution/async-iterable-result.ts","../src/execution/run-with-middleware.ts","../src/execution/runtime-core.ts","../src/execution/runtime-middleware.ts"],"sourcesContent":["export interface RuntimeErrorEnvelope extends Error {\n  readonly code: string;\n  readonly category: 'PLAN' | 'CONTRACT' | 'LINT' | 'BUDGET' | 'RUNTIME';\n  readonly severity: 'error';\n  readonly details?: Record<string, unknown>;\n}\n\n/**\n * Type guard for the runtime-error envelope produced by `runtimeError`.\n *\n * Prefer this over duck-typing on `error.code` directly so consumers stay\n * insulated from the envelope's internal shape.\n */\nexport function isRuntimeError(error: unknown): error is RuntimeErrorEnvelope {\n  return (\n    error instanceof Error &&\n    'code' in error &&\n    typeof (error as { code?: unknown }).code === 'string' &&\n    'category' in error &&\n    'severity' in error\n  );\n}\n\nexport function runtimeError(\n  code: string,\n  message: string,\n  details?: Record<string, unknown>,\n): RuntimeErrorEnvelope {\n  const error = new Error(message) as RuntimeErrorEnvelope;\n  Object.defineProperty(error, 'name', {\n    value: 'RuntimeError',\n    configurable: true,\n  });\n\n  return Object.assign(error, {\n    code,\n    category: resolveCategory(code),\n    severity: 'error' as const,\n    message,\n    details,\n  });\n}\n\nfunction resolveCategory(code: string): RuntimeErrorEnvelope['category'] {\n  const prefix = code.split('.')[0] ?? 'RUNTIME';\n  switch (prefix) {\n    case 'PLAN':\n    case 'CONTRACT':\n    case 'LINT':\n    case 'BUDGET':\n      return prefix;\n    default:\n      return 'RUNTIME';\n  }\n}\n","import { runtimeError } from './runtime-error';\n\nexport class AsyncIterableResult<Row> implements AsyncIterable<Row>, PromiseLike<Row[]> {\n  private readonly generator: AsyncGenerator<Row, void, unknown>;\n  private consumed = false;\n  private consumedBy: 'bufferedArray' | 'iterator' | undefined;\n  private bufferedArrayPromise: Promise<Row[]> | undefined;\n\n  constructor(generator: AsyncGenerator<Row, void, unknown>) {\n    this.generator = generator;\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<Row> {\n    if (this.consumed) {\n      throw runtimeError(\n        'RUNTIME.ITERATOR_CONSUMED',\n        `AsyncIterableResult iterator has already been consumed via ${this.consumedBy === 'bufferedArray' ? 'toArray()/then()' : 'for-await loop'}. Each AsyncIterableResult can only be iterated once.`,\n        {\n          consumedBy: this.consumedBy,\n          suggestion:\n            this.consumedBy === 'bufferedArray'\n              ? 'If you need to iterate multiple times, store the results from toArray() in a variable and reuse that.'\n              : 'If you need to iterate multiple times, use toArray() to collect all results first.',\n        },\n      );\n    }\n    this.consumed = true;\n    this.consumedBy = 'iterator';\n    return this.generator;\n  }\n\n  toArray(): Promise<Row[]> {\n    if (this.consumedBy === 'iterator') {\n      return Promise.reject(\n        runtimeError(\n          'RUNTIME.ITERATOR_CONSUMED',\n          'AsyncIterableResult iterator has already been consumed via for-await loop. Each AsyncIterableResult can only be iterated once.',\n          {\n            consumedBy: this.consumedBy,\n            suggestion:\n              'The iterator was already consumed by a for-await loop. Use toArray() or await the result before iterating.',\n          },\n        ),\n      );\n    }\n\n    if (this.bufferedArrayPromise) {\n      return this.bufferedArrayPromise;\n    }\n\n    this.consumed = true;\n    this.consumedBy = 'bufferedArray';\n    this.bufferedArrayPromise = (async () => {\n      const out: Row[] = [];\n      for await (const item of this.generator) {\n        out.push(item);\n      }\n      return out;\n    })();\n    return this.bufferedArrayPromise;\n  }\n\n  async first(): Promise<Row | null> {\n    const rows = await this.toArray();\n    return rows[0] ?? null;\n  }\n\n  async firstOrThrow(): Promise<Row> {\n    const row = await this.first();\n    if (row === null)\n      throw runtimeError(\n        'RUNTIME.NO_ROWS',\n        'Expected at least one row, but none were returned',\n        {},\n      );\n    return row;\n  }\n\n  // biome-ignore lint/suspicious/noThenProperty: PromiseLike implementation is intentional for await support.\n  then<TResult1 = Row[], TResult2 = never>(\n    onfulfilled?: ((value: Row[]) => TResult1 | PromiseLike<TResult1>) | undefined | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | undefined | null,\n  ): PromiseLike<TResult1 | TResult2> {\n    return this.toArray().then(onfulfilled, onrejected);\n  }\n}\n","import { AsyncIterableResult } from './async-iterable-result';\nimport type { ExecutionPlan } from './query-plan';\nimport type { RuntimeMiddleware, RuntimeMiddlewareContext } from './runtime-middleware';\n\n/**\n * Drives a single execution of `runDriver()` through the middleware lifecycle.\n *\n * Lifecycle, in order:\n *  1. For each middleware in registration order: `beforeExecute(exec, ctx)`.\n *  2. For each row yielded by `runDriver()`: for each middleware in registration\n *     order: `onRow(row, exec, ctx)`; then yield the row to the consumer.\n *  3. On successful completion: for each middleware in registration order:\n *     `afterExecute(exec, { rowCount, latencyMs, completed: true }, ctx)`.\n *  4. On any error thrown by the driver loop: for each middleware in\n *     registration order: `afterExecute(exec, { rowCount, latencyMs,\n *     completed: false }, ctx)`. Errors thrown by `afterExecute` during the\n *     error path are swallowed so they do not mask the original driver error.\n *     The original error is then rethrown.\n *\n * This helper is the single canonical implementation of the middleware\n * orchestration loop; family runtimes should not reimplement it.\n */\nexport function runWithMiddleware<TExec extends ExecutionPlan, Row>(\n  exec: TExec,\n  middleware: ReadonlyArray<RuntimeMiddleware<TExec>>,\n  ctx: RuntimeMiddlewareContext,\n  runDriver: () => AsyncIterable<Row>,\n): AsyncIterableResult<Row> {\n  const iterator = async function* (): AsyncGenerator<Row, void, unknown> {\n    const startedAt = Date.now();\n    let rowCount = 0;\n    let completed = false;\n\n    try {\n      for (const mw of middleware) {\n        if (mw.beforeExecute) {\n          await mw.beforeExecute(exec, ctx);\n        }\n      }\n\n      for await (const row of runDriver()) {\n        for (const mw of middleware) {\n          if (mw.onRow) {\n            await mw.onRow(row as Record<string, unknown>, exec, ctx);\n          }\n        }\n        rowCount++;\n        yield row;\n      }\n\n      completed = true;\n    } catch (error) {\n      const latencyMs = Date.now() - startedAt;\n      for (const mw of middleware) {\n        if (mw.afterExecute) {\n          try {\n            await mw.afterExecute(exec, { rowCount, latencyMs, completed }, ctx);\n          } catch {\n            // Swallow afterExecute errors during the error path so they do not\n            // mask the original driver error.\n          }\n        }\n      }\n\n      throw error;\n    }\n\n    const latencyMs = Date.now() - startedAt;\n    for (const mw of middleware) {\n      if (mw.afterExecute) {\n        await mw.afterExecute(exec, { rowCount, latencyMs, completed }, ctx);\n      }\n    }\n  };\n\n  return new AsyncIterableResult(iterator());\n}\n","import { AsyncIterableResult } from './async-iterable-result';\nimport type { ExecutionPlan, QueryPlan } from './query-plan';\nimport { runWithMiddleware } from './run-with-middleware';\nimport type {\n  RuntimeExecutor,\n  RuntimeMiddleware,\n  RuntimeMiddlewareContext,\n} from './runtime-middleware';\n\n/**\n * Constructor options shared by every concrete `RuntimeCore` subclass.\n *\n * Family runtimes typically build the middleware list and the\n * `RuntimeMiddlewareContext` themselves (running compatibility checks,\n * narrowing the context's `contract` field, etc.) before calling `super`.\n */\nexport interface RuntimeCoreOptions<TMiddleware extends RuntimeMiddleware<ExecutionPlan>> {\n  readonly middleware: ReadonlyArray<TMiddleware>;\n  readonly ctx: RuntimeMiddlewareContext;\n}\n\n/**\n * Family-agnostic abstract runtime base.\n *\n * Defines the entire `execute(plan)` template in one place:\n *\n * 1. `runBeforeCompile(plan)` — concrete; defaults to identity. SQL overrides\n *    this to run its `beforeCompile` middleware-hook chain.\n * 2. `lower(plan)` — abstract. Each family produces its `*ExecutionPlan`\n *    (SQL via `lowerSqlPlan`, Mongo via `adapter.lower`).\n * 3. `runWithMiddleware(exec, this.middleware, this.ctx,\n *    () => runDriver(exec))` — concrete; lifts the middleware lifecycle\n *    out of the family runtimes into the canonical helper.\n *\n * Concrete subclasses must implement `lower`, `runDriver`, and `close`.\n *\n * The class is generic over:\n * - `TPlan` — the family's pre-lowering plan type.\n * - `TExec` — the family's post-lowering (executable) plan type.\n * - `TMiddleware` — the family's middleware type. Constrained to\n *   `RuntimeMiddleware<TExec>` because `runWithMiddleware` invokes the\n *   `beforeExecute` / `onRow` / `afterExecute` hooks with the lowered\n *   `TExec`. (The spec/plan wording \"RuntimeMiddleware<TPlan>\" is\n *   tightened to `<TExec>` here so the helper call typechecks; the\n *   intent is unchanged — middleware sees the post-lowering plan.)\n */\nexport abstract class RuntimeCore<\n  TPlan extends QueryPlan,\n  TExec extends ExecutionPlan,\n  TMiddleware extends RuntimeMiddleware<TExec>,\n> implements RuntimeExecutor<TPlan>\n{\n  protected readonly middleware: ReadonlyArray<TMiddleware>;\n  protected readonly ctx: RuntimeMiddlewareContext;\n\n  constructor(options: RuntimeCoreOptions<TMiddleware>) {\n    this.middleware = options.middleware;\n    this.ctx = options.ctx;\n  }\n\n  /**\n   * Pre-lowering hook for plan rewriting. Defaults to identity. Subclasses\n   * may override to run a `beforeCompile` middleware chain (SQL does this\n   * to support typed AST rewrites — see `before-compile-chain.ts`).\n   */\n  protected runBeforeCompile(plan: TPlan): TPlan | Promise<TPlan> {\n    return plan;\n  }\n\n  /**\n   * Lower a pre-lowering `TPlan` into the family's executable `TExec`.\n   * Family-specific: SQL produces `{ sql, params, ast?, ... }`; Mongo\n   * produces `{ command, ... }`.\n   */\n  protected abstract lower(plan: TPlan): TExec | Promise<TExec>;\n\n  /**\n   * Drive the underlying transport for a lowered `TExec`. Yields raw rows\n   * directly from the driver as `Record<string, unknown>`; codec decoding\n   * (if any) is the subclass's responsibility, applied by wrapping\n   * `execute()` rather than living inside this hook.\n   *\n   * The `Row` type parameter on `execute()` is satisfied by the caller via\n   * the plan's phantom `_row`; the runtime treats rows as opaque records\n   * here and trusts the caller's row typing.\n   */\n  protected abstract runDriver(exec: TExec): AsyncIterable<Record<string, unknown>>;\n\n  abstract close(): Promise<void>;\n\n  execute<Row>(plan: TPlan & { readonly _row?: Row }): AsyncIterableResult<Row> {\n    const self = this;\n\n    async function* generator(): AsyncGenerator<Row, void, unknown> {\n      const compiled = await self.runBeforeCompile(plan);\n      const exec = await self.lower(compiled);\n      // The driver yields raw `Record<string, unknown>`; we cast to `Row` here.\n      // The Row contract is enforced by the caller via `plan._row`.\n      yield* runWithMiddleware<TExec, Row>(\n        exec,\n        self.middleware,\n        self.ctx,\n        () => self.runDriver(exec) as AsyncIterable<Row>,\n      );\n    }\n\n    return new AsyncIterableResult(generator());\n  }\n}\n","import type { AsyncIterableResult } from './async-iterable-result';\nimport type { QueryPlan } from './query-plan';\nimport { runtimeError } from './runtime-error';\n\nexport interface RuntimeLog {\n  info(event: unknown): void;\n  warn(event: unknown): void;\n  error(event: unknown): void;\n  debug?(event: unknown): void;\n}\n\nexport interface RuntimeMiddlewareContext {\n  readonly contract: unknown;\n  readonly mode: 'strict' | 'permissive';\n  readonly now: () => number;\n  readonly log: RuntimeLog;\n}\n\nexport interface AfterExecuteResult {\n  readonly rowCount: number;\n  readonly latencyMs: number;\n  readonly completed: boolean;\n}\n\n/**\n * Family-agnostic middleware SPI parameterized over the plan marker.\n *\n * `TPlan` defaults to the framework `QueryPlan` marker so a generic\n * middleware (e.g. cross-family telemetry) can be authored without\n * naming a family. Family-specific middleware (`SqlMiddleware`,\n * `MongoMiddleware`) narrow `TPlan` to their concrete plan type.\n */\nexport interface RuntimeMiddleware<TPlan extends QueryPlan = QueryPlan> {\n  readonly name: string;\n  readonly familyId?: string;\n  readonly targetId?: string;\n  beforeExecute?(plan: TPlan, ctx: RuntimeMiddlewareContext): Promise<void>;\n  onRow?(row: Record<string, unknown>, plan: TPlan, ctx: RuntimeMiddlewareContext): Promise<void>;\n  afterExecute?(\n    plan: TPlan,\n    result: AfterExecuteResult,\n    ctx: RuntimeMiddlewareContext,\n  ): Promise<void>;\n}\n\n/**\n * Cross-family SPI for any runtime that can execute plans and be shut down.\n * Each family runtime (SQL, Mongo) satisfies this interface — SQL nominally,\n * Mongo structurally (due to its phantom Row parameter using a unique symbol).\n *\n * The `_row` intersection on `execute` connects the `Row` type parameter to the\n * plan, mirroring how `QueryPlan<Row>` carries a phantom `_row?: Row`.\n */\nexport interface RuntimeExecutor<TPlan extends QueryPlan> {\n  execute<Row>(plan: TPlan & { readonly _row?: Row }): AsyncIterableResult<Row>;\n  close(): Promise<void>;\n}\n\nexport function checkMiddlewareCompatibility(\n  middleware: RuntimeMiddleware,\n  runtimeFamilyId: string,\n  runtimeTargetId: string,\n): void {\n  if (middleware.targetId !== undefined && middleware.familyId === undefined) {\n    throw runtimeError(\n      'RUNTIME.MIDDLEWARE_INCOMPATIBLE',\n      `Middleware '${middleware.name}' specifies targetId '${middleware.targetId}' without familyId`,\n      { middleware: middleware.name, targetId: middleware.targetId },\n    );\n  }\n\n  if (middleware.familyId !== undefined && middleware.familyId !== runtimeFamilyId) {\n    throw runtimeError(\n      'RUNTIME.MIDDLEWARE_FAMILY_MISMATCH',\n      `Middleware '${middleware.name}' requires family '${middleware.familyId}' but the runtime is configured for family '${runtimeFamilyId}'`,\n      { middleware: middleware.name, middlewareFamilyId: middleware.familyId, runtimeFamilyId },\n    );\n  }\n\n  if (middleware.targetId !== undefined && middleware.targetId !== runtimeTargetId) {\n    throw runtimeError(\n      'RUNTIME.MIDDLEWARE_TARGET_MISMATCH',\n      `Middleware '${middleware.name}' requires target '${middleware.targetId}' but the runtime is configured for target '${runtimeTargetId}'`,\n      { middleware: middleware.name, middlewareTargetId: middleware.targetId, runtimeTargetId },\n    );\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"runtime.mjs","names":["out: Row[]","sentinel: { reason: unknown }","onAbort: (() => void) | undefined","latencyMs","codecCtx: CodecCallContext"],"sources":["../src/execution/runtime-error.ts","../src/execution/async-iterable-result.ts","../src/execution/race-against-abort.ts","../src/execution/run-with-middleware.ts","../src/execution/runtime-core.ts","../src/execution/runtime-middleware.ts"],"sourcesContent":["export interface RuntimeErrorEnvelope extends Error {\n  readonly code: string;\n  readonly category: 'PLAN' | 'CONTRACT' | 'LINT' | 'BUDGET' | 'RUNTIME';\n  readonly severity: 'error';\n  readonly details?: Record<string, unknown>;\n}\n\n/**\n * Stable code emitted by the runtime when an in-flight `execute()`\n * is cancelled via the per-query `AbortSignal`. The envelope's\n * `details.phase` distinguishes where the abort was observed:\n *\n * - `'encode'` — abort fired during `encodeParams` (SQL) or\n *   `resolveValue` (Mongo).\n * - `'decode'` — abort fired during `decodeRow` / `decodeField`.\n * - `'stream'` — abort fired between rows or before any codec call\n *   (already-aborted at entry).\n */\nexport const RUNTIME_ABORTED = 'RUNTIME.ABORTED' as const;\n\n/** Discriminator placed in `details.phase` of a `RUNTIME.ABORTED` envelope. */\nexport type RuntimeAbortedPhase = 'encode' | 'decode' | 'stream';\n\n/**\n * Type guard for the runtime-error envelope produced by `runtimeError`.\n *\n * Prefer this over duck-typing on `error.code` directly so consumers stay\n * insulated from the envelope's internal shape.\n */\nexport function isRuntimeError(error: unknown): error is RuntimeErrorEnvelope {\n  return (\n    error instanceof Error &&\n    'code' in error &&\n    typeof (error as { code?: unknown }).code === 'string' &&\n    'category' in error &&\n    'severity' in error\n  );\n}\n\nexport function runtimeError(\n  code: string,\n  message: string,\n  details?: Record<string, unknown>,\n): RuntimeErrorEnvelope {\n  const error = new Error(message) as RuntimeErrorEnvelope;\n  Object.defineProperty(error, 'name', {\n    value: 'RuntimeError',\n    configurable: true,\n  });\n\n  return Object.assign(error, {\n    code,\n    category: resolveCategory(code),\n    severity: 'error' as const,\n    message,\n    details,\n  });\n}\n\nfunction resolveCategory(code: string): RuntimeErrorEnvelope['category'] {\n  const prefix = code.split('.')[0] ?? 'RUNTIME';\n  switch (prefix) {\n    case 'PLAN':\n    case 'CONTRACT':\n    case 'LINT':\n    case 'BUDGET':\n      return prefix;\n    default:\n      return 'RUNTIME';\n  }\n}\n\n/**\n * Construct a `RUNTIME.ABORTED` envelope. Phase distinguishes where the\n * abort was observed (encode / decode / stream); cause carries `signal.reason`\n * verbatim from the platform — native abort produces a `DOMException`,\n * explicit `controller.abort(reason)` produces whatever the caller passed.\n * No synthesis happens here.\n */\nexport function runtimeAborted(phase: RuntimeAbortedPhase, cause?: unknown): RuntimeErrorEnvelope {\n  const envelope = runtimeError(RUNTIME_ABORTED, `Operation aborted during ${phase}`, { phase });\n  return Object.assign(envelope, { cause });\n}\n","import { runtimeError } from './runtime-error';\n\nexport class AsyncIterableResult<Row> implements AsyncIterable<Row>, PromiseLike<Row[]> {\n  private readonly generator: AsyncGenerator<Row, void, unknown>;\n  private consumed = false;\n  private consumedBy: 'bufferedArray' | 'iterator' | undefined;\n  private bufferedArrayPromise: Promise<Row[]> | undefined;\n\n  constructor(generator: AsyncGenerator<Row, void, unknown>) {\n    this.generator = generator;\n  }\n\n  [Symbol.asyncIterator](): AsyncIterator<Row> {\n    if (this.consumed) {\n      throw runtimeError(\n        'RUNTIME.ITERATOR_CONSUMED',\n        `AsyncIterableResult iterator has already been consumed via ${this.consumedBy === 'bufferedArray' ? 'toArray()/then()' : 'for-await loop'}. Each AsyncIterableResult can only be iterated once.`,\n        {\n          consumedBy: this.consumedBy,\n          suggestion:\n            this.consumedBy === 'bufferedArray'\n              ? 'If you need to iterate multiple times, store the results from toArray() in a variable and reuse that.'\n              : 'If you need to iterate multiple times, use toArray() to collect all results first.',\n        },\n      );\n    }\n    this.consumed = true;\n    this.consumedBy = 'iterator';\n    return this.generator;\n  }\n\n  toArray(): Promise<Row[]> {\n    if (this.consumedBy === 'iterator') {\n      return Promise.reject(\n        runtimeError(\n          'RUNTIME.ITERATOR_CONSUMED',\n          'AsyncIterableResult iterator has already been consumed via for-await loop. Each AsyncIterableResult can only be iterated once.',\n          {\n            consumedBy: this.consumedBy,\n            suggestion:\n              'The iterator was already consumed by a for-await loop. Use toArray() or await the result before iterating.',\n          },\n        ),\n      );\n    }\n\n    if (this.bufferedArrayPromise) {\n      return this.bufferedArrayPromise;\n    }\n\n    this.consumed = true;\n    this.consumedBy = 'bufferedArray';\n    this.bufferedArrayPromise = (async () => {\n      const out: Row[] = [];\n      for await (const item of this.generator) {\n        out.push(item);\n      }\n      return out;\n    })();\n    return this.bufferedArrayPromise;\n  }\n\n  async first(): Promise<Row | null> {\n    const rows = await this.toArray();\n    return rows[0] ?? null;\n  }\n\n  async firstOrThrow(): Promise<Row> {\n    const row = await this.first();\n    if (row === null)\n      throw runtimeError(\n        'RUNTIME.NO_ROWS',\n        'Expected at least one row, but none were returned',\n        {},\n      );\n    return row;\n  }\n\n  // biome-ignore lint/suspicious/noThenProperty: PromiseLike implementation is intentional for await support.\n  then<TResult1 = Row[], TResult2 = never>(\n    onfulfilled?: ((value: Row[]) => TResult1 | PromiseLike<TResult1>) | undefined | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | undefined | null,\n  ): PromiseLike<TResult1 | TResult2> {\n    return this.toArray().then(onfulfilled, onrejected);\n  }\n}\n","import type { CodecCallContext } from '../shared/codec-types';\nimport type { RuntimeAbortedPhase } from './runtime-error';\nimport { runtimeAborted } from './runtime-error';\n\n/**\n * Throw a phase-tagged `RUNTIME.ABORTED` envelope if the supplied\n * codec-call context is already aborted at the precheck site. Centralises\n * the `if (ctx.signal?.aborted) throw runtimeAborted(...)` pattern that\n * every codec dispatch site repeats.\n */\nexport function checkAborted(ctx: CodecCallContext, phase: RuntimeAbortedPhase): void {\n  if (ctx.signal?.aborted) {\n    throw runtimeAborted(phase, ctx.signal.reason);\n  }\n}\n\n/**\n * Race a per-cell `Promise.all` (or any other in-flight work promise) against\n * the supplied abort signal so the runtime returns `RUNTIME.ABORTED` promptly\n * even when codec bodies ignore the signal. In-flight bodies that ignore the\n * signal are abandoned and run to completion in the background — the\n * cooperative-cancellation contract documented in ADR 204.\n *\n * Call sites still SHOULD pre-check `signal.aborted` and short-circuit with\n * a phase-tagged `RUNTIME.ABORTED` envelope before invoking this helper —\n * that path is the canonical \"aborted at entry\" surface and avoids\n * scheduling the work promise. As a defensive belt-and-braces, this helper\n * also handles the already-aborted case internally: `AbortSignal` does not\n * replay past abort events to listeners registered after the abort, so we\n * inspect `signal.aborted` synchronously and reject with the sentinel\n * before installing the listener. The rejection is still attributed to the\n * abort path via the sentinel-identity check.\n *\n * Distinguishing the rejection source is load-bearing for AC-ERR4\n * (`RUNTIME.ENCODE_FAILED` / `RUNTIME.DECODE_FAILED` pass through unchanged).\n * The semantically equivalent `abortable(signal)` helper in\n * `@prisma-next/utils` rejects with `signal.reason ?? new DOMException(...)`,\n * which is not stably distinguishable from a codec-thrown error by identity\n * alone (a fresh fallback DOMException is allocated per call). We instead\n * track abort attribution with a unique sentinel: only the `onAbort` listener\n * installed here ever rejects with the sentinel, so an `error === sentinel`\n * identity check after the race is unambiguous.\n *\n * Lives in `framework-components` (rather than the SQL family, where it\n * originated in m2) so every family runtime that needs cooperative\n * cancellation around a codec-dispatch `Promise.all` (SQL encode + decode\n * today, Mongo encode in m3) shares the same attribution logic.\n */\nexport async function raceAgainstAbort<T>(\n  work: Promise<T>,\n  signal: AbortSignal | undefined,\n  phase: RuntimeAbortedPhase,\n): Promise<T> {\n  if (signal === undefined) {\n    return await work;\n  }\n  const sentinel: { reason: unknown } = { reason: undefined };\n  let onAbort: (() => void) | undefined;\n\n  const abortPromise = new Promise<never>((_, reject) => {\n    if (signal.aborted) {\n      sentinel.reason = signal.reason;\n      reject(sentinel);\n      return;\n    }\n    onAbort = () => {\n      sentinel.reason = signal.reason;\n      reject(sentinel);\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n  });\n\n  try {\n    return await Promise.race([work, abortPromise]);\n  } catch (error) {\n    if (error === sentinel) {\n      throw runtimeAborted(phase, sentinel.reason);\n    }\n    throw error;\n  } finally {\n    if (onAbort) {\n      signal.removeEventListener('abort', onAbort);\n    }\n  }\n}\n","import { AsyncIterableResult } from './async-iterable-result';\nimport type { ExecutionPlan } from './query-plan';\nimport type { RuntimeMiddleware, RuntimeMiddlewareContext } from './runtime-middleware';\n\n/**\n * Drives a single execution of `runDriver()` through the middleware lifecycle.\n *\n * Lifecycle, in order:\n *  1. For each middleware in registration order: `beforeExecute(exec, ctx)`.\n *  2. For each row yielded by `runDriver()`: for each middleware in registration\n *     order: `onRow(row, exec, ctx)`; then yield the row to the consumer.\n *  3. On successful completion: for each middleware in registration order:\n *     `afterExecute(exec, { rowCount, latencyMs, completed: true }, ctx)`.\n *  4. On any error thrown by the driver loop: for each middleware in\n *     registration order: `afterExecute(exec, { rowCount, latencyMs,\n *     completed: false }, ctx)`. Errors thrown by `afterExecute` during the\n *     error path are swallowed so they do not mask the original driver error.\n *     The original error is then rethrown.\n *\n * This helper is the single canonical implementation of the middleware\n * orchestration loop; family runtimes should not reimplement it.\n */\nexport function runWithMiddleware<TExec extends ExecutionPlan, Row>(\n  exec: TExec,\n  middleware: ReadonlyArray<RuntimeMiddleware<TExec>>,\n  ctx: RuntimeMiddlewareContext,\n  runDriver: () => AsyncIterable<Row>,\n): AsyncIterableResult<Row> {\n  const iterator = async function* (): AsyncGenerator<Row, void, unknown> {\n    const startedAt = Date.now();\n    let rowCount = 0;\n    let completed = false;\n\n    try {\n      for (const mw of middleware) {\n        if (mw.beforeExecute) {\n          await mw.beforeExecute(exec, ctx);\n        }\n      }\n\n      for await (const row of runDriver()) {\n        for (const mw of middleware) {\n          if (mw.onRow) {\n            await mw.onRow(row as Record<string, unknown>, exec, ctx);\n          }\n        }\n        rowCount++;\n        yield row;\n      }\n\n      completed = true;\n    } catch (error) {\n      const latencyMs = Date.now() - startedAt;\n      for (const mw of middleware) {\n        if (mw.afterExecute) {\n          try {\n            await mw.afterExecute(exec, { rowCount, latencyMs, completed }, ctx);\n          } catch {\n            // Swallow afterExecute errors during the error path so they do not\n            // mask the original driver error.\n          }\n        }\n      }\n\n      throw error;\n    }\n\n    const latencyMs = Date.now() - startedAt;\n    for (const mw of middleware) {\n      if (mw.afterExecute) {\n        await mw.afterExecute(exec, { rowCount, latencyMs, completed }, ctx);\n      }\n    }\n  };\n\n  return new AsyncIterableResult(iterator());\n}\n","import type { CodecCallContext } from '../shared/codec-types';\nimport { AsyncIterableResult } from './async-iterable-result';\nimport type { ExecutionPlan, QueryPlan } from './query-plan';\nimport { checkAborted } from './race-against-abort';\nimport { runWithMiddleware } from './run-with-middleware';\nimport type {\n  RuntimeExecuteOptions,\n  RuntimeExecutor,\n  RuntimeMiddleware,\n  RuntimeMiddlewareContext,\n} from './runtime-middleware';\n\n/**\n * Constructor options shared by every concrete `RuntimeCore` subclass.\n *\n * Family runtimes typically build the middleware list and the\n * `RuntimeMiddlewareContext` themselves (running compatibility checks,\n * narrowing the context's `contract` field, etc.) before calling `super`.\n */\nexport interface RuntimeCoreOptions<TMiddleware extends RuntimeMiddleware<ExecutionPlan>> {\n  readonly middleware: ReadonlyArray<TMiddleware>;\n  readonly ctx: RuntimeMiddlewareContext;\n}\n\n/**\n * Family-agnostic abstract runtime base.\n *\n * Defines the entire `execute(plan)` template in one place:\n *\n * 1. `runBeforeCompile(plan)` — concrete; defaults to identity. SQL overrides\n *    this to run its `beforeCompile` middleware-hook chain.\n * 2. `lower(plan)` — abstract. Each family produces its `*ExecutionPlan`\n *    (SQL via `lowerSqlPlan`, Mongo via `adapter.lower`).\n * 3. `runWithMiddleware(exec, this.middleware, this.ctx,\n *    () => runDriver(exec))` — concrete; lifts the middleware lifecycle\n *    out of the family runtimes into the canonical helper.\n *\n * Concrete subclasses must implement `lower`, `runDriver`, and `close`.\n *\n * The class is generic over:\n * - `TPlan` — the family's pre-lowering plan type.\n * - `TExec` — the family's post-lowering (executable) plan type.\n * - `TMiddleware` — the family's middleware type. Constrained to\n *   `RuntimeMiddleware<TExec>` because `runWithMiddleware` invokes the\n *   `beforeExecute` / `onRow` / `afterExecute` hooks with the lowered\n *   `TExec`. (The spec/plan wording \"RuntimeMiddleware<TPlan>\" is\n *   tightened to `<TExec>` here so the helper call typechecks; the\n *   intent is unchanged — middleware sees the post-lowering plan.)\n */\nexport abstract class RuntimeCore<\n  TPlan extends QueryPlan,\n  TExec extends ExecutionPlan,\n  TMiddleware extends RuntimeMiddleware<TExec>,\n> implements RuntimeExecutor<TPlan>\n{\n  protected readonly middleware: ReadonlyArray<TMiddleware>;\n  protected readonly ctx: RuntimeMiddlewareContext;\n\n  constructor(options: RuntimeCoreOptions<TMiddleware>) {\n    this.middleware = options.middleware;\n    this.ctx = options.ctx;\n  }\n\n  /**\n   * Pre-lowering hook for plan rewriting. Defaults to identity. Subclasses\n   * may override to run a `beforeCompile` middleware chain (SQL does this\n   * to support typed AST rewrites — see `before-compile-chain.ts`).\n   */\n  protected runBeforeCompile(plan: TPlan): TPlan | Promise<TPlan> {\n    return plan;\n  }\n\n  /**\n   * Lower a pre-lowering `TPlan` into the family's executable `TExec`.\n   * Family-specific: SQL produces `{ sql, params, ast?, ... }`; Mongo\n   * produces `{ command, ... }`.\n   *\n   * `ctx` carries per-query cancellation (and any future fields on\n   * `CodecCallContext`); concrete subclasses forward it to the\n   * encode-side codec dispatch site (e.g. SQL's `encodeParams` in m2,\n   * Mongo's `resolveValue` in m3). The runtime allocates one ctx per\n   * `execute()` call and threads the same reference everywhere; the\n   * `signal` field inside may be `undefined`, but the ctx object itself\n   * is always present.\n   */\n  protected abstract lower(plan: TPlan, ctx: CodecCallContext): TExec | Promise<TExec>;\n\n  /**\n   * Drive the underlying transport for a lowered `TExec`. Yields raw rows\n   * directly from the driver as `Record<string, unknown>`; codec decoding\n   * (if any) is the subclass's responsibility, applied by wrapping\n   * `execute()` rather than living inside this hook.\n   *\n   * The `Row` type parameter on `execute()` is satisfied by the caller via\n   * the plan's phantom `_row`; the runtime treats rows as opaque records\n   * here and trusts the caller's row typing.\n   */\n  protected abstract runDriver(exec: TExec): AsyncIterable<Record<string, unknown>>;\n\n  abstract close(): Promise<void>;\n\n  execute<Row>(\n    plan: TPlan & { readonly _row?: Row },\n    options?: RuntimeExecuteOptions,\n  ): AsyncIterableResult<Row> {\n    const self = this;\n    const signal = options?.signal;\n    // One ctx per execute() call. The ctx object is always allocated; the\n    // `signal` field is only included when a signal was supplied (required\n    // under exactOptionalPropertyTypes — `{ signal: undefined }` would not\n    // satisfy `signal?: AbortSignal`).\n    const codecCtx: CodecCallContext = signal === undefined ? {} : { signal };\n\n    async function* generator(): AsyncGenerator<Row, void, unknown> {\n      // Pre-check the signal at entry so an already-aborted caller observes\n      // RUNTIME.ABORTED on the first `next()` without any work being done.\n      checkAborted(codecCtx, 'stream');\n\n      const compiled = await self.runBeforeCompile(plan);\n      const exec = await self.lower(compiled, codecCtx);\n      // The driver yields raw `Record<string, unknown>`; we cast to `Row` here.\n      // The Row contract is enforced by the caller via `plan._row`.\n      yield* runWithMiddleware<TExec, Row>(\n        exec,\n        self.middleware,\n        self.ctx,\n        () => self.runDriver(exec) as AsyncIterable<Row>,\n      );\n    }\n\n    return new AsyncIterableResult(generator());\n  }\n}\n","import type { AsyncIterableResult } from './async-iterable-result';\nimport type { QueryPlan } from './query-plan';\nimport { runtimeError } from './runtime-error';\n\nexport interface RuntimeLog {\n  info(event: unknown): void;\n  warn(event: unknown): void;\n  error(event: unknown): void;\n  debug?(event: unknown): void;\n}\n\nexport interface RuntimeMiddlewareContext {\n  readonly contract: unknown;\n  readonly mode: 'strict' | 'permissive';\n  readonly now: () => number;\n  readonly log: RuntimeLog;\n}\n\nexport interface AfterExecuteResult {\n  readonly rowCount: number;\n  readonly latencyMs: number;\n  readonly completed: boolean;\n}\n\n/**\n * Family-agnostic middleware SPI parameterized over the plan marker.\n *\n * `TPlan` defaults to the framework `QueryPlan` marker so a generic\n * middleware (e.g. cross-family telemetry) can be authored without\n * naming a family. Family-specific middleware (`SqlMiddleware`,\n * `MongoMiddleware`) narrow `TPlan` to their concrete plan type.\n */\nexport interface RuntimeMiddleware<TPlan extends QueryPlan = QueryPlan> {\n  readonly name: string;\n  readonly familyId?: string;\n  readonly targetId?: string;\n  beforeExecute?(plan: TPlan, ctx: RuntimeMiddlewareContext): Promise<void>;\n  onRow?(row: Record<string, unknown>, plan: TPlan, ctx: RuntimeMiddlewareContext): Promise<void>;\n  afterExecute?(\n    plan: TPlan,\n    result: AfterExecuteResult,\n    ctx: RuntimeMiddlewareContext,\n  ): Promise<void>;\n}\n\n/**\n * Optional per-`execute` options accepted by every family runtime.\n *\n * `signal` is the per-query cancellation signal. The runtime threads the\n * signal through to every codec call for the query and uses it to short-\n * circuit the row stream with `RUNTIME.ABORTED` when the caller aborts.\n * Omitting the option (or passing `undefined`) preserves today's behavior\n * bit-for-bit.\n */\nexport interface RuntimeExecuteOptions {\n  readonly signal?: AbortSignal;\n}\n\n/**\n * Cross-family SPI for any runtime that can execute plans and be shut down.\n * Each family runtime (SQL, Mongo) satisfies this interface — SQL nominally,\n * Mongo structurally (due to its phantom Row parameter using a unique symbol).\n *\n * The `_row` intersection on `execute` connects the `Row` type parameter to the\n * plan, mirroring how `QueryPlan<Row>` carries a phantom `_row?: Row`.\n */\nexport interface RuntimeExecutor<TPlan extends QueryPlan> {\n  execute<Row>(\n    plan: TPlan & { readonly _row?: Row },\n    options?: RuntimeExecuteOptions,\n  ): AsyncIterableResult<Row>;\n  close(): Promise<void>;\n}\n\nexport function checkMiddlewareCompatibility(\n  middleware: RuntimeMiddleware,\n  runtimeFamilyId: string,\n  runtimeTargetId: string,\n): void {\n  if (middleware.targetId !== undefined && middleware.familyId === undefined) {\n    throw runtimeError(\n      'RUNTIME.MIDDLEWARE_INCOMPATIBLE',\n      `Middleware '${middleware.name}' specifies targetId '${middleware.targetId}' without familyId`,\n      { middleware: middleware.name, targetId: middleware.targetId },\n    );\n  }\n\n  if (middleware.familyId !== undefined && middleware.familyId !== runtimeFamilyId) {\n    throw runtimeError(\n      'RUNTIME.MIDDLEWARE_FAMILY_MISMATCH',\n      `Middleware '${middleware.name}' requires family '${middleware.familyId}' but the runtime is configured for family '${runtimeFamilyId}'`,\n      { middleware: middleware.name, middlewareFamilyId: middleware.familyId, runtimeFamilyId },\n    );\n  }\n\n  if (middleware.targetId !== undefined && middleware.targetId !== runtimeTargetId) {\n    throw runtimeError(\n      'RUNTIME.MIDDLEWARE_TARGET_MISMATCH',\n      `Middleware '${middleware.name}' requires target '${middleware.targetId}' but the runtime is configured for target '${runtimeTargetId}'`,\n      { middleware: middleware.name, middlewareTargetId: middleware.targetId, runtimeTargetId },\n    );\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@prisma-next/framework-components",
-  "version": "0.5.0-dev.28",
+  "version": "0.5.0-dev.29",
   "type": "module",
   "sideEffects": false,
   "description": "Framework component types, assembly logic, and stack creation for Prisma Next",
   "dependencies": {
-    "@prisma-next/operations": "0.5.0-dev.28",
-    "@prisma-next/utils": "0.5.0-dev.28",
-    "@prisma-next/contract": "0.5.0-dev.28"
+    "@prisma-next/contract": "0.5.0-dev.29",
+    "@prisma-next/operations": "0.5.0-dev.29",
+    "@prisma-next/utils": "0.5.0-dev.29"
   },
   "devDependencies": {
     "tsdown": "0.18.4",

package/src/execution/race-against-abort.ts

@@ -0,0 +1,85 @@
+import type { CodecCallContext } from '../shared/codec-types';
+import type { RuntimeAbortedPhase } from './runtime-error';
+import { runtimeAborted } from './runtime-error';
+
+/**
+ * Throw a phase-tagged `RUNTIME.ABORTED` envelope if the supplied
+ * codec-call context is already aborted at the precheck site. Centralises
+ * the `if (ctx.signal?.aborted) throw runtimeAborted(...)` pattern that
+ * every codec dispatch site repeats.
+ */
+export function checkAborted(ctx: CodecCallContext, phase: RuntimeAbortedPhase): void {
+  if (ctx.signal?.aborted) {
+    throw runtimeAborted(phase, ctx.signal.reason);
+  }
+}
+
+/**
+ * Race a per-cell `Promise.all` (or any other in-flight work promise) against
+ * the supplied abort signal so the runtime returns `RUNTIME.ABORTED` promptly
+ * even when codec bodies ignore the signal. In-flight bodies that ignore the
+ * signal are abandoned and run to completion in the background — the
+ * cooperative-cancellation contract documented in ADR 204.
+ *
+ * Call sites still SHOULD pre-check `signal.aborted` and short-circuit with
+ * a phase-tagged `RUNTIME.ABORTED` envelope before invoking this helper —
+ * that path is the canonical "aborted at entry" surface and avoids
+ * scheduling the work promise. As a defensive belt-and-braces, this helper
+ * also handles the already-aborted case internally: `AbortSignal` does not
+ * replay past abort events to listeners registered after the abort, so we
+ * inspect `signal.aborted` synchronously and reject with the sentinel
+ * before installing the listener. The rejection is still attributed to the
+ * abort path via the sentinel-identity check.
+ *
+ * Distinguishing the rejection source is load-bearing for AC-ERR4
+ * (`RUNTIME.ENCODE_FAILED` / `RUNTIME.DECODE_FAILED` pass through unchanged).
+ * The semantically equivalent `abortable(signal)` helper in
+ * `@prisma-next/utils` rejects with `signal.reason ?? new DOMException(...)`,
+ * which is not stably distinguishable from a codec-thrown error by identity
+ * alone (a fresh fallback DOMException is allocated per call). We instead
+ * track abort attribution with a unique sentinel: only the `onAbort` listener
+ * installed here ever rejects with the sentinel, so an `error === sentinel`
+ * identity check after the race is unambiguous.
+ *
+ * Lives in `framework-components` (rather than the SQL family, where it
+ * originated in m2) so every family runtime that needs cooperative
+ * cancellation around a codec-dispatch `Promise.all` (SQL encode + decode
+ * today, Mongo encode in m3) shares the same attribution logic.
+ */
+export async function raceAgainstAbort<T>(
+  work: Promise<T>,
+  signal: AbortSignal | undefined,
+  phase: RuntimeAbortedPhase,
+): Promise<T> {
+  if (signal === undefined) {
+    return await work;
+  }
+  const sentinel: { reason: unknown } = { reason: undefined };
+  let onAbort: (() => void) | undefined;
+
+  const abortPromise = new Promise<never>((_, reject) => {
+    if (signal.aborted) {
+      sentinel.reason = signal.reason;
+      reject(sentinel);
+      return;
+    }
+    onAbort = () => {
+      sentinel.reason = signal.reason;
+      reject(sentinel);
+    };
+    signal.addEventListener('abort', onAbort, { once: true });
+  });
+
+  try {
+    return await Promise.race([work, abortPromise]);
+  } catch (error) {
+    if (error === sentinel) {
+      throw runtimeAborted(phase, sentinel.reason);
+    }
+    throw error;
+  } finally {
+    if (onAbort) {
+      signal.removeEventListener('abort', onAbort);
+    }
+  }
+}

package/src/execution/runtime-core.ts

@@ -1,7 +1,10 @@
+import type { CodecCallContext } from '../shared/codec-types';
 import { AsyncIterableResult } from './async-iterable-result';
 import type { ExecutionPlan, QueryPlan } from './query-plan';
+import { checkAborted } from './race-against-abort';
 import { runWithMiddleware } from './run-with-middleware';
 import type {
+  RuntimeExecuteOptions,
   RuntimeExecutor,
   RuntimeMiddleware,
   RuntimeMiddlewareContext,
@@ -71,8 +74,16 @@ export abstract class RuntimeCore<
    * Lower a pre-lowering `TPlan` into the family's executable `TExec`.
    * Family-specific: SQL produces `{ sql, params, ast?, ... }`; Mongo
    * produces `{ command, ... }`.
+   *
+   * `ctx` carries per-query cancellation (and any future fields on
+   * `CodecCallContext`); concrete subclasses forward it to the
+   * encode-side codec dispatch site (e.g. SQL's `encodeParams` in m2,
+   * Mongo's `resolveValue` in m3). The runtime allocates one ctx per
+   * `execute()` call and threads the same reference everywhere; the
+   * `signal` field inside may be `undefined`, but the ctx object itself
+   * is always present.
    */
-  protected abstract lower(plan: TPlan): TExec | Promise<TExec>;
+  protected abstract lower(plan: TPlan, ctx: CodecCallContext): TExec | Promise<TExec>;
 
   /**
    * Drive the underlying transport for a lowered `TExec`. Yields raw rows
@@ -88,12 +99,25 @@ export abstract class RuntimeCore<
 
   abstract close(): Promise<void>;
 
-  execute<Row>(plan: TPlan & { readonly _row?: Row }): AsyncIterableResult<Row> {
+  execute<Row>(
+    plan: TPlan & { readonly _row?: Row },
+    options?: RuntimeExecuteOptions,
+  ): AsyncIterableResult<Row> {
     const self = this;
+    const signal = options?.signal;
+    // One ctx per execute() call. The ctx object is always allocated; the
+    // `signal` field is only included when a signal was supplied (required
+    // under exactOptionalPropertyTypes — `{ signal: undefined }` would not
+    // satisfy `signal?: AbortSignal`).
+    const codecCtx: CodecCallContext = signal === undefined ? {} : { signal };
 
     async function* generator(): AsyncGenerator<Row, void, unknown> {
+      // Pre-check the signal at entry so an already-aborted caller observes
+      // RUNTIME.ABORTED on the first `next()` without any work being done.
+      checkAborted(codecCtx, 'stream');
+
       const compiled = await self.runBeforeCompile(plan);
-      const exec = await self.lower(compiled);
+      const exec = await self.lower(compiled, codecCtx);
       // The driver yields raw `Record<string, unknown>`; we cast to `Row` here.
       // The Row contract is enforced by the caller via `plan._row`.
       yield* runWithMiddleware<TExec, Row>(

package/src/execution/runtime-error.ts

@@ -5,6 +5,22 @@ export interface RuntimeErrorEnvelope extends Error {
   readonly details?: Record<string, unknown>;
 }
 
+/**
+ * Stable code emitted by the runtime when an in-flight `execute()`
+ * is cancelled via the per-query `AbortSignal`. The envelope's
+ * `details.phase` distinguishes where the abort was observed:
+ *
+ * - `'encode'` — abort fired during `encodeParams` (SQL) or
+ *   `resolveValue` (Mongo).
+ * - `'decode'` — abort fired during `decodeRow` / `decodeField`.
+ * - `'stream'` — abort fired between rows or before any codec call
+ *   (already-aborted at entry).
+ */
+export const RUNTIME_ABORTED = 'RUNTIME.ABORTED' as const;
+
+/** Discriminator placed in `details.phase` of a `RUNTIME.ABORTED` envelope. */
+export type RuntimeAbortedPhase = 'encode' | 'decode' | 'stream';
+
 /**
  * Type guard for the runtime-error envelope produced by `runtimeError`.
  *
@@ -53,3 +69,15 @@ function resolveCategory(code: string): RuntimeErrorEnvelope['category'] {
       return 'RUNTIME';
   }
 }
+
+/**
+ * Construct a `RUNTIME.ABORTED` envelope. Phase distinguishes where the
+ * abort was observed (encode / decode / stream); cause carries `signal.reason`
+ * verbatim from the platform — native abort produces a `DOMException`,
+ * explicit `controller.abort(reason)` produces whatever the caller passed.
+ * No synthesis happens here.
+ */
+export function runtimeAborted(phase: RuntimeAbortedPhase, cause?: unknown): RuntimeErrorEnvelope {
+  const envelope = runtimeError(RUNTIME_ABORTED, `Operation aborted during ${phase}`, { phase });
+  return Object.assign(envelope, { cause });
+}

package/src/execution/runtime-middleware.ts

@@ -43,6 +43,19 @@ export interface RuntimeMiddleware<TPlan extends QueryPlan = QueryPlan> {
   ): Promise<void>;
 }
 
+/**
+ * Optional per-`execute` options accepted by every family runtime.
+ *
+ * `signal` is the per-query cancellation signal. The runtime threads the
+ * signal through to every codec call for the query and uses it to short-
+ * circuit the row stream with `RUNTIME.ABORTED` when the caller aborts.
+ * Omitting the option (or passing `undefined`) preserves today's behavior
+ * bit-for-bit.
+ */
+export interface RuntimeExecuteOptions {
+  readonly signal?: AbortSignal;
+}
+
 /**
  * Cross-family SPI for any runtime that can execute plans and be shut down.
  * Each family runtime (SQL, Mongo) satisfies this interface — SQL nominally,
@@ -52,7 +65,10 @@ export interface RuntimeMiddleware<TPlan extends QueryPlan = QueryPlan> {
  * plan, mirroring how `QueryPlan<Row>` carries a phantom `_row?: Row`.
  */
 export interface RuntimeExecutor<TPlan extends QueryPlan> {
-  execute<Row>(plan: TPlan & { readonly _row?: Row }): AsyncIterableResult<Row>;
+  execute<Row>(
+    plan: TPlan & { readonly _row?: Row },
+    options?: RuntimeExecuteOptions,
+  ): AsyncIterableResult<Row>;
   close(): Promise<void>;
 }
 

package/src/exports/codec.ts

@@ -1,2 +1,2 @@
-export type { Codec, CodecLookup, CodecTrait } from '../shared/codec-types';
+export type { Codec, CodecCallContext, CodecLookup, CodecTrait } from '../shared/codec-types';
 export { emptyCodecLookup } from '../shared/codec-types';

package/src/exports/runtime.ts

@@ -1,12 +1,19 @@
 export { AsyncIterableResult } from '../execution/async-iterable-result';
 export type { ExecutionPlan, QueryPlan, ResultType } from '../execution/query-plan';
+export { checkAborted, raceAgainstAbort } from '../execution/race-against-abort';
 export { runWithMiddleware } from '../execution/run-with-middleware';
 export type { RuntimeCoreOptions } from '../execution/runtime-core';
 export { RuntimeCore } from '../execution/runtime-core';
-export type { RuntimeErrorEnvelope } from '../execution/runtime-error';
-export { isRuntimeError, runtimeError } from '../execution/runtime-error';
+export type { RuntimeAbortedPhase, RuntimeErrorEnvelope } from '../execution/runtime-error';
+export {
+  isRuntimeError,
+  RUNTIME_ABORTED,
+  runtimeAborted,
+  runtimeError,
+} from '../execution/runtime-error';
 export type {
   AfterExecuteResult,
+  RuntimeExecuteOptions,
   RuntimeExecutor,
   RuntimeLog,
   RuntimeMiddleware,

package/src/shared/codec-types.ts

@@ -2,6 +2,33 @@ import type { JsonValue } from '@prisma-next/contract/types';
 
 export type CodecTrait = 'equality' | 'order' | 'boolean' | 'numeric' | 'textual';
 
+/**
+ * Per-call context the runtime threads to every `codec.encode` /
+ * `codec.decode` invocation for a single `runtime.execute()` call.
+ *
+ * The framework-level shape is family-agnostic and carries one field:
+ *
+ * - `signal?: AbortSignal` — per-query cancellation. The runtime returns
+ *   a `RUNTIME.ABORTED` envelope when the signal aborts; codec authors
+ *   who forward `signal` to their underlying SDK get true cancellation
+ *   of in-flight network calls.
+ *
+ * Family layers extend this base with their own shape-of-call metadata:
+ * the SQL family adds `column?: SqlColumnRef` via `SqlCodecCallContext`
+ * (see `@prisma-next/sql-relational-core`). Mongo currently uses this
+ * framework type unchanged. Column metadata is intentionally **not** on
+ * the framework type — it is a SQL-family concept rooted in SQL's
+ * `(table, column)` addressing model and would not generalise to other
+ * families.
+ *
+ * The interface is named explicitly (not inlined) so future framework
+ * fields and family extensions can land additively without breaking
+ * codec author signatures.
+ */
+export interface CodecCallContext {
+  readonly signal?: AbortSignal;
+}
+
 /**
  * A codec is the contract between an application value and its on-wire and
  * on-contract-disk representations.
@@ -43,10 +70,10 @@ export interface Codec<
   readonly targetTypes: readonly string[];
   /** Semantic traits for operator gating (e.g. equality, order, numeric). */
   readonly traits?: TTraits;
-  /** Converts a JS value to the wire format expected by the database driver. Always Promise-returning at the boundary. */
-  encode(value: TInput): Promise<TWire>;
-  /** Converts a wire value from the database driver into the JS application type. Always Promise-returning at the boundary. */
-  decode(wire: TWire): Promise<TInput>;
+  /** Converts a JS value to the wire format expected by the database driver. Always Promise-returning at the boundary. The {@link CodecCallContext} is supplied by the runtime on every call (allocated once per `runtime.execute()`); family layers may narrow the ctx to extend it (e.g. SQL adds `column`). Author-side single-arg `(value) => …` functions remain legal via TypeScript's bivariance for trailing parameters. */
+  encode(value: TInput, ctx: CodecCallContext): Promise<TWire>;
+  /** Converts a wire value from the database driver into the JS application type. Always Promise-returning at the boundary. The {@link CodecCallContext} is supplied by the runtime on every call (allocated once per `runtime.execute()`); family layers may narrow the ctx to extend it (e.g. SQL adds `column`). Author-side single-arg `(wire) => …` functions remain legal via TypeScript's bivariance for trailing parameters. */
+  decode(wire: TWire, ctx: CodecCallContext): Promise<TInput>;
   /** Converts a JS value to a JSON-safe representation for contract serialization. Synchronous; called during contract emission. */
   encodeJson(value: TInput): JsonValue;
   /** Converts a JSON representation back to the JS input type. Synchronous; called during contract loading via `validateContract`. */

package/dist/codec-types-Csp_4QDg.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codec-types-Csp_4QDg.d.mts","names":[],"sources":["../src/shared/codec-types.ts"],"sourcesContent":[],"mappings":";;;KAEY,UAAA;;AAAZ;AA+BA;;;;;;;;;;;;;;;;;AAwBA;AAIA;;;;;;;;;UA5BiB,2DAEU,wBAAwB;;eAKpC;;;;oBAIK;;gBAEJ,SAAS,QAAQ;;eAElB,QAAQ,QAAQ;;oBAEX,SAAS;;mBAEV,YAAY;;gCAEC;;UAGf,WAAA;mBACE;;cAGN,kBAAkB"}