@prisma/orm-framework 8.0.0-rc.1-dev.41 → 8.0.0-rc.1-dev.43

package/dist/{runtime-DYTFHGwh.mjs → runtime-BqzioOmU.mjs}

@@ -1,3 +1,4 @@
+import { t as blindCast } from "./casts-DpaahrlC-Bd5n2coI.mjs";
 import { n as runtimeError } from "./runtime-error-BA9d7XjZ-BlT8t6LB.mjs";
 //#region ../../../1-framework/1-core/framework-components/dist/runtime.mjs
 /**
@@ -10,15 +11,16 @@ import { n as runtimeError } from "./runtime-error-BA9d7XjZ-BlT8t6LB.mjs";
 * - `'decode'` — abort fired during `decodeRow` / `decodeField`.
 * - `'stream'` — abort fired between rows or before any codec call
 *   (already-aborted at entry).
-* - `'beforeExecute'` / `'afterExecute'` / `'onRow'` — abort fired
-*   on entry to or during the corresponding middleware phase
+* - `'beforeQuery'` / `'beforeExecute'` / `'afterQuery'` /
+*   `'afterExecute'` / `'onRow'` — abort fired on entry to or during
+*   the corresponding middleware phase
 *   (cooperative cancellation per the param-transform seam).
 */
 const RUNTIME_ABORTED = "RUNTIME.ABORTED";
 /**
 * Construct a `RUNTIME.ABORTED` envelope. Phase distinguishes where the
 * abort was observed — codec call sites (`encode` / `decode` / `stream`)
-* or middleware seams (`beforeExecute` / `afterExecute` / `onRow`), as
+* or operation-specific middleware seams, as
 * enumerated on {@link RuntimeAbortedPhase}. Cause carries
 * `signal.reason` verbatim from the platform — native abort produces a
 * `DOMException`, explicit `controller.abort(reason)` produces whatever
@@ -246,17 +248,69 @@ async function raceAgainstAbort(work, signal, phase) {
 	}
 }
 /**
+* Runs every middleware's `beforeQuery` hook in registration order,
+* threading through the (optional) family-specific `paramsMutator`.
+*
+* Why this lives outside {@link runQueryWithMiddleware}: middleware that
+* mutates parameter values (e.g. cipherstash's bulk-encrypt SDK
+* round-trip) must run *before* the family runtime encodes those
+* parameters to driver wire format. Family runtimes call
+* `runBeforeQueryChain` between the AST → plan lowering step and
+* the parameter encode step; the encode then observes the mutator's
+* `currentParams()` view. `runQueryWithMiddleware` retains the rest of
+* the query lifecycle (`interceptQuery`, driver/row source loop, `onRow`,
+* `afterQuery`) but no longer fires `beforeQuery` itself.
+*
+* Lifecycle within this helper:
+*
+*  1. For each middleware in registration order, if `beforeQuery`
+*     is implemented:
+*     - `checkAborted(ctx, 'beforeQuery')` short-circuits if the
+*       caller already aborted at entry.
+*     - The hook is invoked with `(plan, ctx, paramsMutator)`. A
+*       middleware body that ignores the mutator stays compatible —
+*       JavaScript allows extra positional arguments.
+*     - If the hook returns a Promise, it is raced against
+*       `ctx.signal` via {@link raceAgainstAbort} so cooperative
+*       cancellation surfaces a `RUNTIME.ABORTED { phase:
+*       'beforeQuery' }` envelope even when the body itself
+*       ignores the signal.
+*
+* Error propagation: any error thrown by a `beforeQuery` body
+* (or surfaced by the abort race) propagates out of this helper
+* unchanged. Family runtime entry points await this helper before invoking
+* `runQueryWithMiddleware`, so a rejection prevents the runner and its
+* `afterQuery` hook from running.
+*
+* Relationship to {@link runQueryWithMiddleware}: the framework's
+* `RuntimeCore.query` template calls this helper between
+* `lower(plan)` and `runQueryWithMiddleware(...)`. Family runtimes that
+* override query preparation (e.g. SQL, which inlines lower + encode for
+* direct mutator threading) call this helper themselves at the
+* equivalent point — between the family's AST → draft-plan
+* lowering and the parameter-encode step.
+*
+* Intercept ordering: this helper fires unconditionally before
+* `runQueryWithMiddleware`. `interceptQuery` (inside
+* `runQueryWithMiddleware`) therefore observes the post-`beforeQuery`
+* plan — mutator mutations are visible in the params interceptors see.
+* The trade-off is documented on `RuntimeMiddleware.interceptQuery`.
+*/
+function runBeforeQueryChain(plan, middleware, ctx, paramsMutator) {
+	return runBeforeChain(plan, middleware, ctx, paramsMutator, "beforeQuery", (mw) => mw.beforeQuery);
+}
+/**
 * Runs every middleware's `beforeExecute` hook in registration order,
 * threading through the (optional) family-specific `paramsMutator`.
 *
-* Why this lives outside {@link runWithMiddleware}: middleware that
+* Why this lives outside {@link runExecuteWithMiddleware}: middleware that
 * mutates parameter values (e.g. cipherstash's bulk-encrypt SDK
 * round-trip) must run *before* the family runtime encodes those
 * parameters to driver wire format. Family runtimes call
 * `runBeforeExecuteChain` between the AST → plan lowering step and
 * the parameter encode step; the encode then observes the mutator's
-* `currentParams()` view. `runWithMiddleware` retains the rest of
-* the lifecycle (`intercept`, driver/row source loop, `onRow`,
+* `currentParams()` view. `runExecuteWithMiddleware` retains the rest of
+* the execute lifecycle (`interceptExecute`, driver statistics execution,
 * `afterExecute`) but no longer fires `beforeExecute` itself.
 *
 * Lifecycle within this helper:
@@ -276,76 +330,79 @@ async function raceAgainstAbort(work, signal, phase) {
 *
 * Error propagation: any error thrown by a `beforeExecute` body
 * (or surfaced by the abort race) propagates out of this helper
-* unchanged. The family runtime is responsible for converting it
-* into the appropriate `afterExecute(completed: false)` notification
-* once `runWithMiddleware` runs.
+* unchanged. Family runtime entry points await this helper before invoking
+* `runExecuteWithMiddleware`, so a rejection prevents the runner and its
+* `afterExecute` hook from running.
 *
-* Relationship to {@link runWithMiddleware}: the framework's
+* Relationship to {@link runExecuteWithMiddleware}: the framework's
 * `RuntimeCore.execute` template calls this helper between
-* `lower(plan)` and `runWithMiddleware(...)`. Family runtimes that
-* override `execute` (e.g. SQL, which inlines lower + encode for
+* `lower(plan)` and `runExecuteWithMiddleware(...)`. Family runtimes that
+* override execute (e.g. SQL, which inlines lower + encode for
 * direct mutator threading) call this helper themselves at the
 * equivalent point — between the family's AST → draft-plan
 * lowering and the parameter-encode step.
 *
 * Intercept ordering: this helper fires unconditionally before
-* `runWithMiddleware`. `intercept` (inside `runWithMiddleware`)
-* therefore observes the post-`beforeExecute` plan — mutator
-* mutations are visible in the params interceptors see. The
-* trade-off is documented on `RuntimeMiddleware.intercept`.
+* `runExecuteWithMiddleware`. `interceptExecute` (inside
+* `runExecuteWithMiddleware`) therefore observes the post-`beforeExecute`
+* plan — mutator mutations are visible in the params interceptors see.
+* The trade-off is documented on `RuntimeMiddleware.interceptExecute`.
 */
-async function runBeforeExecuteChain(plan, middleware, ctx, paramsMutator) {
+function runBeforeExecuteChain(plan, middleware, ctx, paramsMutator) {
+	return runBeforeChain(plan, middleware, ctx, paramsMutator, "beforeExecute", (mw) => mw.beforeExecute);
+}
+async function runBeforeChain(plan, middleware, ctx, paramsMutator, phase, selectHook) {
 	for (const mw of middleware) {
-		if (!mw.beforeExecute) continue;
-		checkAborted(ctx, "beforeExecute");
-		const work = mw.beforeExecute(plan, ctx, paramsMutator);
-		if (work !== void 0) await raceAgainstAbort(Promise.resolve(work), ctx.signal, "beforeExecute");
+		const hook = selectHook(mw);
+		if (hook === void 0) continue;
+		checkAborted(ctx, phase);
+		const work = hook(plan, ctx, paramsMutator);
+		if (work !== void 0) await raceAgainstAbort(Promise.resolve(work), ctx.signal, phase);
 	}
 }
 /**
-* Drives a single execution of `runDriver()` through the middleware
-* lifecycle's intercept + row-source + termination phases.
+* Drives a single query execution of `runDriver()` through the middleware
+* lifecycle's `interceptQuery` + row-source + termination phases.
 *
 * Lifecycle, in order:
-*  1. For each middleware in registration order: `intercept(exec, ctx)`. The
-*     first non-`undefined` result wins; subsequent middleware's `intercept`
-*     does not fire. On a hit, the runtime emits a `middleware.intercept`
-*     debug event naming the winning middleware, switches the row source to
-*     the intercepted rows, and proceeds with `source: 'middleware'`. On
-*     all-passthrough (every `intercept` returns `undefined` or is omitted),
-*     `source: 'driver'` is used and the row source is `runDriver()`.
+*  1. For each middleware in registration order: `interceptQuery(exec, ctx)`.
+*     The first non-`undefined` result wins; subsequent middleware's
+*     `interceptQuery` does not fire. On a hit, the runtime emits a
+*     `middleware.interceptQuery` debug event naming the winning middleware,
+*     switches the row source to the intercepted rows, and proceeds with
+*     `source: 'middleware'`. On all-passthrough (every `interceptQuery`
+*     returns `undefined` or is omitted), `source: 'driver'` is used and the
+*     row source is `runDriver()`.
 *  2. Iterate the row source. On the driver path, for each row, for each
 *     middleware in registration order: `onRow(row, exec, ctx)`; then yield
 *     the row. On the intercepted hit path, `onRow` is skipped — intercepted
 *     rows did not originate from a driver row stream — but rows are still
 *     yielded to the consumer in order.
 *  3. On successful completion: for each middleware in registration order:
-*     `afterExecute(exec, { rowCount, latencyMs, completed: true, source },
+*     `afterQuery(exec, { rowCount, latencyMs, completed: true, source },
 *     ctx)`.
 *  4. On any error thrown during steps 1–2: for each middleware in
-*     registration order: `afterExecute(exec, { rowCount, latencyMs,
-*     completed: false, source }, ctx)`. Errors thrown by `afterExecute`
+*     registration order: `afterQuery(exec, { rowCount, latencyMs,
+*     completed: false, source }, ctx)`. Errors thrown by `afterQuery`
 *     during the error path are swallowed so they do not mask the original
 *     error. The original error is then rethrown.
 *
-* `beforeExecute` is **not** fired here — see
-* {@link runBeforeExecuteChain} in `before-execute-chain.ts`. Family
-* runtimes call that helper between the AST → plan lowering step and
-* the parameter encode step so middleware that mutates ParamRef
-* values (e.g. cipherstash bulk-encrypt) can have its mutations
-* visible to encode. `runWithMiddleware` operates on the fully-
-* encoded plan; interceptors therefore observe a fully-mutated,
+* `beforeQuery` is **not** fired here — see
+* {@link runBeforeQueryChain} in `before-execute-chain.ts`. Family runtimes
+* call that helper between the AST → plan lowering step and the parameter
+* encode step so middleware that mutates ParamRef values can have its
+* mutations visible to encode. `runQueryWithMiddleware` operates on the
+* fully-encoded plan; interceptors therefore observe a fully-mutated,
 * encoded plan.
 *
-* The `source` field on `AfterExecuteResult` lets observers (telemetry,
-* lints, budgets) distinguish driver-served from middleware-served
-* executions without needing their own out-of-band signal.
+* The `source` field on `AfterQueryResult` lets observers (telemetry, lints,
+* budgets) distinguish driver-served from middleware-served executions
+* without needing their own out-of-band signal.
 *
 * This helper is the single canonical implementation of the
-* intercept-and-row-source loop; family runtimes should not
-* reimplement it.
+* intercept-and-row-source loop; family runtimes should not reimplement it.
 */
-function runWithMiddleware(exec, middleware, ctx, runDriver) {
+function runQueryWithMiddleware(exec, middleware, ctx, runDriver) {
 	const iterator = async function* () {
 		const startedAt = Date.now();
 		let rowCount = 0;
@@ -354,18 +411,18 @@ function runWithMiddleware(exec, middleware, ctx, runDriver) {
 		let rowSource;
 		try {
 			for (const mw of middleware) {
-				if (!mw.intercept) continue;
+				if (!mw.interceptQuery) continue;
 				source = "middleware";
-				const result = await mw.intercept(exec, ctx);
+				const result = await mw.interceptQuery(exec, ctx);
 				if (result === void 0) {
 					source = "driver";
 					continue;
 				}
 				ctx.log.debug?.({
-					event: "middleware.intercept",
+					event: "middleware.interceptQuery",
 					middleware: mw.name
 				});
-				rowSource = result.rows;
+				rowSource = blindCast(result.rows);
 				break;
 			}
 			if (source === "driver") rowSource = runDriver();
@@ -378,58 +435,138 @@ function runWithMiddleware(exec, middleware, ctx, runDriver) {
 			}
 			completed = true;
 		} catch (error) {
-			const latencyMs = Date.now() - startedAt;
-			for (const mw of middleware) if (mw.afterExecute) try {
-				await mw.afterExecute(exec, {
-					rowCount,
-					latencyMs,
-					completed,
-					source
-				}, ctx);
-			} catch {}
+			await notifyQueryCompletion(middleware, exec, ctx, {
+				rowCount,
+				latencyMs: Date.now() - startedAt,
+				completed,
+				source
+			}, true);
 			throw error;
 		}
-		const latencyMs = Date.now() - startedAt;
-		for (const mw of middleware) if (mw.afterExecute) await mw.afterExecute(exec, {
+		await notifyQueryCompletion(middleware, exec, ctx, {
 			rowCount,
-			latencyMs,
+			latencyMs: Date.now() - startedAt,
 			completed,
 			source
-		}, ctx);
+		}, false);
 	};
 	return new AsyncIterableResult(iterator());
 }
 /**
+* Drives a single execute operation through the middleware
+* `interceptExecute` + statistics + termination phases.
+*
+* Lifecycle, in order:
+*  1. For each middleware in registration order: `interceptExecute(exec, ctx)`.
+*     The first non-`undefined` result wins; subsequent middleware's
+*     `interceptExecute` does not fire. On a hit, the runtime emits a
+*     `middleware.interceptExecute` debug event naming the winning middleware,
+*     uses the returned `stats`, and proceeds with `source: 'middleware'`.
+*     On all-passthrough (every `interceptExecute` returns `undefined` or is
+*     omitted), `source: 'driver'` is used and `runDriver()` supplies the
+*     statistics.
+*  2. Execute operations return eager statistics. There is no row stream and
+*     `onRow` does not fire.
+*  3. On successful completion: for each middleware in registration order:
+*     `afterExecute(exec, { stats, latencyMs, completed: true, source }, ctx)`.
+*  4. On any error thrown during steps 1–2: for each middleware in
+*     registration order: `afterExecute(exec, { latencyMs, completed: false,
+*     source }, ctx)`. Errors thrown by `afterExecute` during the error path
+*     are swallowed so they do not mask the original error. The original
+*     error is then rethrown.
+*
+* `beforeExecute` is **not** fired here — see
+* {@link runBeforeExecuteChain} in `before-execute-chain.ts`. Family runtimes
+* call that helper between the AST → plan lowering step and the parameter
+* encode step so middleware that mutates ParamRef values can have its
+* mutations visible to encode. `runExecuteWithMiddleware` operates on the
+* fully-encoded plan; interceptors therefore observe a fully-mutated,
+* encoded plan.
+*
+* The `source` field on `AfterExecuteResult` lets observers (telemetry, lints,
+* budgets) distinguish driver-served from middleware-served executions
+* without needing their own out-of-band signal.
+*/
+async function runExecuteWithMiddleware(exec, middleware, ctx, runDriver) {
+	const startedAt = Date.now();
+	let source = "driver";
+	let stats;
+	try {
+		for (const mw of middleware) {
+			if (!mw.interceptExecute) continue;
+			source = "middleware";
+			const result = await mw.interceptExecute(exec, ctx);
+			if (result === void 0) {
+				source = "driver";
+				continue;
+			}
+			ctx.log.debug?.({
+				event: "middleware.interceptExecute",
+				middleware: mw.name
+			});
+			stats = result.stats;
+			break;
+		}
+		if (stats === void 0) stats = await runDriver();
+	} catch (error) {
+		const latencyMs = Date.now() - startedAt;
+		for (const mw of middleware) {
+			if (!mw.afterExecute) continue;
+			try {
+				await mw.afterExecute(exec, {
+					latencyMs,
+					completed: false,
+					source
+				}, ctx);
+			} catch {}
+		}
+		throw error;
+	}
+	const latencyMs = Date.now() - startedAt;
+	for (const mw of middleware) if (mw.afterExecute) await mw.afterExecute(exec, {
+		stats,
+		latencyMs,
+		completed: true,
+		source
+	}, ctx);
+	return stats;
+}
+async function notifyQueryCompletion(middleware, exec, ctx, result, swallowErrors) {
+	for (const mw of middleware) {
+		if (!mw.afterQuery) continue;
+		if (swallowErrors) try {
+			await mw.afterQuery(exec, result, ctx);
+		} catch {}
+		else await mw.afterQuery(exec, result, ctx);
+	}
+}
+/**
 * Family-agnostic abstract runtime base.
 *
-* Defines the entire `execute(plan)` template in one place:
+* Defines the shared operation-specific middleware lifecycles:
 *
 * 1. `runBeforeCompile(plan)` — concrete; defaults to identity. SQL overrides
-*    this to run its `beforeCompile` middleware-hook chain.
+*    this to run its shared `beforeCompile` middleware-hook chain.
 * 2. `lower(plan)` — abstract. Each family produces its `*ExecutionPlan`
 *    (SQL via `lowerSqlPlan`, Mongo via `adapter.lower`).
-* 3. `runBeforeExecuteChain(exec, this.middleware, this.ctx)` — concrete;
-*    runs every middleware's `beforeExecute` hook after lowering but
-*    before the row source is opened. Family runtimes that need a
-*    params mutator visible to a downstream encode step (SQL) override
-*    `execute` and call this helper themselves at the equivalent
-*    pre-encode point.
-* 4. `runWithMiddleware(exec, this.middleware, this.ctx,
-*    () => runDriver(exec))` — concrete; runs the intercept chain,
-*    drives the row source, fires `onRow` / `afterExecute`. Does
-*    **not** fire `beforeExecute` — see step 3.
-*
-* Concrete subclasses must implement `lower`, `runDriver`, and `close`.
+* 3. Queries run `beforeQuery`; statements run `beforeExecute`. Both chains
+*    run after lowering and before their matching driver terminal. Family
+*    runtimes that expose a params mutator to downstream encoding override
+*    the operation and call the matching helper at the pre-encode point.
+* 4. The matching runner processes `interceptQuery` or `interceptExecute`
+*    before invoking the driver. Queries then fire `onRow` and `afterQuery`;
+*    statements fire `afterExecute`.
+*
+* Concrete subclasses must implement `lower`, `runDriver`, `runExecute`, and
+* `close`.
 *
 * The class is generic over:
 * - `TPlan` — the family's pre-lowering plan type.
 * - `TExec` — the family's post-lowering (executable) plan type.
 * - `TMiddleware` — the family's middleware type. Constrained to
-*   `RuntimeMiddleware<TExec>` because `runWithMiddleware` invokes the
-*   `beforeExecute` / `onRow` / `afterExecute` hooks with the lowered
-*   `TExec`. (The spec/plan wording "RuntimeMiddleware<TPlan>" is
-*   tightened to `<TExec>` here so the helper call typechecks; the
-*   intent is unchanged — middleware sees the post-lowering plan.)
+*   `RuntimeMiddleware<TExec>` because the operation-specific runners invoke
+*   hooks with the lowered `TExec`. Middleware therefore sees the
+*   post-lowering plan.
 */
 var RuntimeCore = class {
 	middleware;
@@ -446,23 +583,40 @@ var RuntimeCore = class {
 	runBeforeCompile(plan) {
 		return plan;
 	}
-	execute(plan, options) {
+	query(plan, options) {
 		const self = this;
 		const signal = options?.signal;
 		const codecCtx = signal === void 0 ? {} : { signal };
 		const execCtx = {
 			...self.ctx,
+			...codecCtx,
+			scope: options?.scope ?? self.ctx.scope,
 			planExecutionId: crypto.randomUUID()
 		};
 		async function* generator() {
 			checkAborted(codecCtx, "stream");
 			const compiled = await self.runBeforeCompile(plan);
 			const exec = await self.lower(compiled, codecCtx);
-			await runBeforeExecuteChain(exec, self.middleware, execCtx);
-			yield* runWithMiddleware(exec, self.middleware, execCtx, () => self.runDriver(exec));
+			await runBeforeQueryChain(exec, self.middleware, execCtx);
+			yield* runQueryWithMiddleware(exec, self.middleware, execCtx, () => self.runDriver(exec));
 		}
 		return new AsyncIterableResult(generator());
 	}
+	async execute(plan, options) {
+		const signal = options?.signal;
+		const codecCtx = signal === void 0 ? {} : { signal };
+		const execCtx = {
+			...this.ctx,
+			...codecCtx,
+			scope: options?.scope ?? this.ctx.scope,
+			planExecutionId: crypto.randomUUID()
+		};
+		checkAborted(codecCtx, "stream");
+		const compiled = await this.runBeforeCompile(plan);
+		const exec = await this.lower(compiled, codecCtx);
+		await runBeforeExecuteChain(exec, this.middleware, execCtx);
+		return runExecuteWithMiddleware(exec, this.middleware, execCtx, () => this.runExecute(exec));
+	}
 };
 function checkMiddlewareCompatibility(middleware, runtimeFamilyId, runtimeTargetId) {
 	if (middleware.targetId !== void 0 && middleware.familyId === void 0) throw runtimeError("RUNTIME.MIDDLEWARE_INCOMPATIBLE", `Middleware '${middleware.name}' specifies targetId '${middleware.targetId}' without familyId`, {
@@ -511,6 +665,6 @@ function createMetaBuilder(kind, terminalName) {
 	return new MetaBuilderImpl(kind, terminalName);
 }
 //#endregion
-export { checkAborted as a, defineAnnotation as c, runWithMiddleware as d, runtimeAborted as f, assertAnnotationsApplicable as i, raceAgainstAbort as l, RUNTIME_ABORTED as n, checkMiddlewareCompatibility as o, RuntimeCore as r, createMetaBuilder as s, AsyncIterableResult as t, runBeforeExecuteChain as u };
+export { checkAborted as a, defineAnnotation as c, runBeforeQueryChain as d, runExecuteWithMiddleware as f, assertAnnotationsApplicable as i, raceAgainstAbort as l, runtimeAborted as m, RUNTIME_ABORTED as n, checkMiddlewareCompatibility as o, runQueryWithMiddleware as p, RuntimeCore as r, createMetaBuilder as s, AsyncIterableResult as t, runBeforeExecuteChain as u };
 
-//# sourceMappingURL=runtime-DYTFHGwh.mjs.map
+//# sourceMappingURL=runtime-BqzioOmU.mjs.map

package/dist/runtime-BqzioOmU.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-BqzioOmU.mjs","names":["#kind","#terminalName","#annotations"],"sources":["../../../../1-framework/1-core/framework-components/dist/runtime.mjs"],"sourcesContent":["import { n as runtimeError, t as isRuntimeError } from \"./runtime-error-BA9d7XjZ.mjs\";\nimport { blindCast } from \"@internal/utils/casts\";\n//#region src/execution/runtime-error.ts\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* - `'beforeQuery'` / `'beforeExecute'` / `'afterQuery'` /\n*   `'afterExecute'` / `'onRow'` — abort fired on entry to or during\n*   the corresponding middleware phase\n*   (cooperative cancellation per the param-transform seam).\n*/\nconst RUNTIME_ABORTED = \"RUNTIME.ABORTED\";\n/**\n* Construct a `RUNTIME.ABORTED` envelope. Phase distinguishes where the\n* abort was observed — codec call sites (`encode` / `decode` / `stream`)\n* or operation-specific middleware seams, as\n* enumerated on {@link RuntimeAbortedPhase}. Cause carries\n* `signal.reason` verbatim from the platform — native abort produces a\n* `DOMException`, explicit `controller.abort(reason)` produces whatever\n* the caller passed. No synthesis happens here.\n*/\nfunction runtimeAborted(phase, cause) {\n\tconst envelope = runtimeError(RUNTIME_ABORTED, `Operation aborted during ${phase}`, { phase });\n\treturn Object.assign(envelope, { cause });\n}\n//#endregion\n//#region src/annotations.ts\n/**\n* Defines a typed annotation handle.\n*\n* Two-step call form. The first step takes the `Payload` type argument\n* (TypeScript cannot infer `Payload` from anything in the options, so it\n* must be supplied explicitly); the second step takes the runtime options\n* and infers `Kinds` from the `applicableTo` array via a `const` type\n* parameter, so the operation kinds appear exactly once at the call site.\n*\n* @example\n* ```typescript\n* // Read-only annotation. Lane terminals like `db.User.first(...)` accept\n* // it; `db.User.create(...)` rejects it at the type level.\n* const cacheAnnotation = defineAnnotation<{ ttl?: number; skip?: boolean }>()({\n*   namespace: 'cache',\n*   applicableTo: ['read'],\n* }); // Kinds inferred as 'read'\n*\n* // Write-only annotation. Mirror image.\n* const auditAnnotation = defineAnnotation<{ actor: string }>()({\n*   namespace: 'audit',\n*   applicableTo: ['write'],\n* }); // Kinds inferred as 'write'\n*\n* // Annotation applicable to both kinds (e.g. tracing).\n* const otelAnnotation = defineAnnotation<{ traceId: string }>()({\n*   namespace: 'otel',\n*   applicableTo: ['read', 'write'],\n* }); // Kinds inferred as 'read' | 'write'\n* ```\n*\n* **Reserved namespaces.** See `DefineAnnotationOptions.namespace` for the\n* list of framework-internal namespaces (`codecs`, target-specific keys).\n* `defineAnnotation` does not structurally prevent a user from naming a\n* reserved namespace, but the framework makes no compatibility guarantee\n* about handles that do.\n*/\nfunction defineAnnotation() {\n\treturn (options) => {\n\t\tconst namespace = options.namespace;\n\t\tconst applicableTo = Object.freeze(new Set(options.applicableTo));\n\t\tfunction handle(value) {\n\t\t\treturn Object.freeze({\n\t\t\t\t__annotation: true,\n\t\t\t\tnamespace,\n\t\t\t\tvalue,\n\t\t\t\tapplicableTo\n\t\t\t});\n\t\t}\n\t\tfunction read(plan) {\n\t\t\tconst stored = plan.meta.annotations?.[namespace];\n\t\t\tif (!isAnnotationValue(stored)) return;\n\t\t\tif (stored.namespace !== namespace) return;\n\t\t\treturn stored.value;\n\t\t}\n\t\treturn Object.freeze(Object.assign(handle, {\n\t\t\tnamespace,\n\t\t\tapplicableTo,\n\t\t\tread\n\t\t}));\n\t};\n}\n/**\n* Runtime applicability gate. Throws `RUNTIME.ANNOTATION_INAPPLICABLE` if\n* any annotation in `annotations` declares an `applicableTo` set that does\n* not include `kind`. Used by lane terminals (SQL DSL builders' `.build()`,\n* ORM `Collection` terminals) to fail closed when the type-level\n* `ValidAnnotations` gate is bypassed via cast / `any` / dynamic\n* invocation.\n*\n* Passes silently on:\n*  - empty arrays\n*  - annotations whose `applicableTo` includes `kind`\n*\n* Throws on:\n*  - any annotation whose `applicableTo` does not include `kind`. The\n*    error names the offending annotation's `namespace` and the\n*    `terminalName` so users can locate the misuse.\n*\n* @example\n* ```typescript\n* // Inside an ORM read terminal:\n* assertAnnotationsApplicable(annotations, 'read', 'first');\n* ```\n*/\nfunction assertAnnotationsApplicable(annotations, kind, terminalName) {\n\tfor (const annotation of annotations) if (!annotation.applicableTo.has(kind)) throw runtimeError(\"RUNTIME.ANNOTATION_INAPPLICABLE\", `Annotation '${annotation.namespace}' is not applicable to '${kind}' operations (terminal: '${terminalName}'). The annotation declares applicableTo = [${Array.from(annotation.applicableTo).map((k) => `'${k}'`).join(\", \")}].`, {\n\t\tnamespace: annotation.namespace,\n\t\tterminalName,\n\t\tkind,\n\t\tapplicableTo: Array.from(annotation.applicableTo)\n\t});\n}\n/**\n* Type guard for branded annotation values stored in `plan.meta.annotations`.\n*\n* Internal — used by `AnnotationHandle.read` to distinguish user\n* annotations (created by calling a handle returned from\n* `defineAnnotation(...)`) from framework-internal metadata that may\n* happen to live under the same namespace key.\n*/\nfunction isAnnotationValue(value) {\n\tif (value === null || typeof value !== \"object\") return false;\n\treturn value.__annotation === true;\n}\n//#endregion\n//#region src/execution/async-iterable-result.ts\nvar AsyncIterableResult = class {\n\tgenerator;\n\tconsumed = false;\n\tconsumedBy;\n\tbufferedArrayPromise;\n\tconstructor(generator) {\n\t\tthis.generator = generator;\n\t}\n\t[Symbol.asyncIterator]() {\n\t\tif (this.consumed) throw runtimeError(\"RUNTIME.ITERATOR_CONSUMED\", `AsyncIterableResult iterator has already been consumed via ${this.consumedBy === \"bufferedArray\" ? \"toArray()/then()\" : \"for-await loop\"}. Each AsyncIterableResult can only be iterated once.`, {\n\t\t\tconsumedBy: this.consumedBy,\n\t\t\tsuggestion: this.consumedBy === \"bufferedArray\" ? \"If you need to iterate multiple times, store the results from toArray() in a variable and reuse that.\" : \"If you need to iterate multiple times, use toArray() to collect all results first.\"\n\t\t});\n\t\tthis.consumed = true;\n\t\tthis.consumedBy = \"iterator\";\n\t\treturn this.generator;\n\t}\n\ttoArray() {\n\t\tif (this.consumedBy === \"iterator\") return Promise.reject(runtimeError(\"RUNTIME.ITERATOR_CONSUMED\", \"AsyncIterableResult iterator has already been consumed via for-await loop. Each AsyncIterableResult can only be iterated once.\", {\n\t\t\tconsumedBy: this.consumedBy,\n\t\t\tsuggestion: \"The iterator was already consumed by a for-await loop. Use toArray() or await the result before iterating.\"\n\t\t}));\n\t\tif (this.bufferedArrayPromise) return this.bufferedArrayPromise;\n\t\tthis.consumed = true;\n\t\tthis.consumedBy = \"bufferedArray\";\n\t\tthis.bufferedArrayPromise = (async () => {\n\t\t\tconst out = [];\n\t\t\tfor await (const item of this.generator) out.push(item);\n\t\t\treturn out;\n\t\t})();\n\t\treturn this.bufferedArrayPromise;\n\t}\n\tasync first() {\n\t\treturn (await this.toArray())[0] ?? null;\n\t}\n\tasync firstOrThrow() {\n\t\tconst row = await this.first();\n\t\tif (row === null) throw runtimeError(\"RUNTIME.NO_ROWS\", \"Expected at least one row, but none were returned\", {});\n\t\treturn row;\n\t}\n\tthen(onfulfilled, onrejected) {\n\t\treturn this.toArray().then(onfulfilled, onrejected);\n\t}\n};\n//#endregion\n//#region src/execution/race-against-abort.ts\n/**\n* Throw a phase-tagged `RUNTIME.ABORTED` envelope if the supplied\n* context is already aborted at the precheck site. Centralises the\n* `if (ctx.signal?.aborted) throw runtimeAborted(...)` pattern that\n* every codec dispatch site (and the `beforeExecute` middleware phase)\n* repeats. Accepts both the framework `CodecCallContext` and the\n* `RuntimeMiddlewareContext`; both expose `signal?: AbortSignal`.\n*/\nfunction checkAborted(ctx, phase) {\n\tif (ctx.signal?.aborted) throw runtimeAborted(phase, ctx.signal.reason);\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* `@internal/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*/\nasync function raceAgainstAbort(work, signal, phase) {\n\tif (signal === void 0) return await work;\n\tconst sentinel = { reason: void 0 };\n\tlet onAbort;\n\tconst abortPromise = new Promise((_, reject) => {\n\t\tif (signal.aborted) {\n\t\t\tsentinel.reason = signal.reason;\n\t\t\treject(sentinel);\n\t\t\treturn;\n\t\t}\n\t\tonAbort = () => {\n\t\t\tsentinel.reason = signal.reason;\n\t\t\treject(sentinel);\n\t\t};\n\t\tsignal.addEventListener(\"abort\", onAbort, { once: true });\n\t});\n\ttry {\n\t\treturn await Promise.race([work, abortPromise]);\n\t} catch (error) {\n\t\tif (error === sentinel) throw runtimeAborted(phase, sentinel.reason);\n\t\tthrow error;\n\t} finally {\n\t\tif (onAbort) signal.removeEventListener(\"abort\", onAbort);\n\t}\n}\n//#endregion\n//#region src/execution/before-execute-chain.ts\n/**\n* Runs every middleware's `beforeQuery` hook in registration order,\n* threading through the (optional) family-specific `paramsMutator`.\n*\n* Why this lives outside {@link runQueryWithMiddleware}: middleware that\n* mutates parameter values (e.g. cipherstash's bulk-encrypt SDK\n* round-trip) must run *before* the family runtime encodes those\n* parameters to driver wire format. Family runtimes call\n* `runBeforeQueryChain` between the AST → plan lowering step and\n* the parameter encode step; the encode then observes the mutator's\n* `currentParams()` view. `runQueryWithMiddleware` retains the rest of\n* the query lifecycle (`interceptQuery`, driver/row source loop, `onRow`,\n* `afterQuery`) but no longer fires `beforeQuery` itself.\n*\n* Lifecycle within this helper:\n*\n*  1. For each middleware in registration order, if `beforeQuery`\n*     is implemented:\n*     - `checkAborted(ctx, 'beforeQuery')` short-circuits if the\n*       caller already aborted at entry.\n*     - The hook is invoked with `(plan, ctx, paramsMutator)`. A\n*       middleware body that ignores the mutator stays compatible —\n*       JavaScript allows extra positional arguments.\n*     - If the hook returns a Promise, it is raced against\n*       `ctx.signal` via {@link raceAgainstAbort} so cooperative\n*       cancellation surfaces a `RUNTIME.ABORTED { phase:\n*       'beforeQuery' }` envelope even when the body itself\n*       ignores the signal.\n*\n* Error propagation: any error thrown by a `beforeQuery` body\n* (or surfaced by the abort race) propagates out of this helper\n* unchanged. Family runtime entry points await this helper before invoking\n* `runQueryWithMiddleware`, so a rejection prevents the runner and its\n* `afterQuery` hook from running.\n*\n* Relationship to {@link runQueryWithMiddleware}: the framework's\n* `RuntimeCore.query` template calls this helper between\n* `lower(plan)` and `runQueryWithMiddleware(...)`. Family runtimes that\n* override query preparation (e.g. SQL, which inlines lower + encode for\n* direct mutator threading) call this helper themselves at the\n* equivalent point — between the family's AST → draft-plan\n* lowering and the parameter-encode step.\n*\n* Intercept ordering: this helper fires unconditionally before\n* `runQueryWithMiddleware`. `interceptQuery` (inside\n* `runQueryWithMiddleware`) therefore observes the post-`beforeQuery`\n* plan — mutator mutations are visible in the params interceptors see.\n* The trade-off is documented on `RuntimeMiddleware.interceptQuery`.\n*/\nfunction runBeforeQueryChain(plan, middleware, ctx, paramsMutator) {\n\treturn runBeforeChain(plan, middleware, ctx, paramsMutator, \"beforeQuery\", (mw) => mw.beforeQuery);\n}\n/**\n* Runs every middleware's `beforeExecute` hook in registration order,\n* threading through the (optional) family-specific `paramsMutator`.\n*\n* Why this lives outside {@link runExecuteWithMiddleware}: middleware that\n* mutates parameter values (e.g. cipherstash's bulk-encrypt SDK\n* round-trip) must run *before* the family runtime encodes those\n* parameters to driver wire format. Family runtimes call\n* `runBeforeExecuteChain` between the AST → plan lowering step and\n* the parameter encode step; the encode then observes the mutator's\n* `currentParams()` view. `runExecuteWithMiddleware` retains the rest of\n* the execute lifecycle (`interceptExecute`, driver statistics execution,\n* `afterExecute`) but no longer fires `beforeExecute` itself.\n*\n* Lifecycle within this helper:\n*\n*  1. For each middleware in registration order, if `beforeExecute`\n*     is implemented:\n*     - `checkAborted(ctx, 'beforeExecute')` short-circuits if the\n*       caller already aborted at entry.\n*     - The hook is invoked with `(plan, ctx, paramsMutator)`. A\n*       middleware body that ignores the mutator stays compatible —\n*       JavaScript allows extra positional arguments.\n*     - If the hook returns a Promise, it is raced against\n*       `ctx.signal` via {@link raceAgainstAbort} so cooperative\n*       cancellation surfaces a `RUNTIME.ABORTED { phase:\n*       'beforeExecute' }` envelope even when the body itself\n*       ignores the signal.\n*\n* Error propagation: any error thrown by a `beforeExecute` body\n* (or surfaced by the abort race) propagates out of this helper\n* unchanged. Family runtime entry points await this helper before invoking\n* `runExecuteWithMiddleware`, so a rejection prevents the runner and its\n* `afterExecute` hook from running.\n*\n* Relationship to {@link runExecuteWithMiddleware}: the framework's\n* `RuntimeCore.execute` template calls this helper between\n* `lower(plan)` and `runExecuteWithMiddleware(...)`. Family runtimes that\n* override execute (e.g. SQL, which inlines lower + encode for\n* direct mutator threading) call this helper themselves at the\n* equivalent point — between the family's AST → draft-plan\n* lowering and the parameter-encode step.\n*\n* Intercept ordering: this helper fires unconditionally before\n* `runExecuteWithMiddleware`. `interceptExecute` (inside\n* `runExecuteWithMiddleware`) therefore observes the post-`beforeExecute`\n* plan — mutator mutations are visible in the params interceptors see.\n* The trade-off is documented on `RuntimeMiddleware.interceptExecute`.\n*/\nfunction runBeforeExecuteChain(plan, middleware, ctx, paramsMutator) {\n\treturn runBeforeChain(plan, middleware, ctx, paramsMutator, \"beforeExecute\", (mw) => mw.beforeExecute);\n}\nasync function runBeforeChain(plan, middleware, ctx, paramsMutator, phase, selectHook) {\n\tfor (const mw of middleware) {\n\t\tconst hook = selectHook(mw);\n\t\tif (hook === void 0) continue;\n\t\tcheckAborted(ctx, phase);\n\t\tconst work = hook(plan, ctx, paramsMutator);\n\t\tif (work !== void 0) await raceAgainstAbort(Promise.resolve(work), ctx.signal, phase);\n\t}\n}\n//#endregion\n//#region src/execution/run-with-middleware.ts\n/**\n* Drives a single query execution of `runDriver()` through the middleware\n* lifecycle's `interceptQuery` + row-source + termination phases.\n*\n* Lifecycle, in order:\n*  1. For each middleware in registration order: `interceptQuery(exec, ctx)`.\n*     The first non-`undefined` result wins; subsequent middleware's\n*     `interceptQuery` does not fire. On a hit, the runtime emits a\n*     `middleware.interceptQuery` debug event naming the winning middleware,\n*     switches the row source to the intercepted rows, and proceeds with\n*     `source: 'middleware'`. On all-passthrough (every `interceptQuery`\n*     returns `undefined` or is omitted), `source: 'driver'` is used and the\n*     row source is `runDriver()`.\n*  2. Iterate the row source. On the driver path, for each row, for each\n*     middleware in registration order: `onRow(row, exec, ctx)`; then yield\n*     the row. On the intercepted hit path, `onRow` is skipped — intercepted\n*     rows did not originate from a driver row stream — but rows are still\n*     yielded to the consumer in order.\n*  3. On successful completion: for each middleware in registration order:\n*     `afterQuery(exec, { rowCount, latencyMs, completed: true, source },\n*     ctx)`.\n*  4. On any error thrown during steps 1–2: for each middleware in\n*     registration order: `afterQuery(exec, { rowCount, latencyMs,\n*     completed: false, source }, ctx)`. Errors thrown by `afterQuery`\n*     during the error path are swallowed so they do not mask the original\n*     error. The original error is then rethrown.\n*\n* `beforeQuery` is **not** fired here — see\n* {@link runBeforeQueryChain} in `before-execute-chain.ts`. Family runtimes\n* call that helper between the AST → plan lowering step and the parameter\n* encode step so middleware that mutates ParamRef values can have its\n* mutations visible to encode. `runQueryWithMiddleware` operates on the\n* fully-encoded plan; interceptors therefore observe a fully-mutated,\n* encoded plan.\n*\n* The `source` field on `AfterQueryResult` lets observers (telemetry, lints,\n* budgets) distinguish driver-served from middleware-served executions\n* without needing their own out-of-band signal.\n*\n* This helper is the single canonical implementation of the\n* intercept-and-row-source loop; family runtimes should not reimplement it.\n*/\nfunction runQueryWithMiddleware(exec, middleware, ctx, runDriver) {\n\tconst iterator = async function* () {\n\t\tconst startedAt = Date.now();\n\t\tlet rowCount = 0;\n\t\tlet completed = false;\n\t\tlet source = \"driver\";\n\t\tlet rowSource;\n\t\ttry {\n\t\t\tfor (const mw of middleware) {\n\t\t\t\tif (!mw.interceptQuery) continue;\n\t\t\t\tsource = \"middleware\";\n\t\t\t\tconst result = await mw.interceptQuery(exec, ctx);\n\t\t\t\tif (result === void 0) {\n\t\t\t\t\tsource = \"driver\";\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\t\t\t\tctx.log.debug?.({\n\t\t\t\t\tevent: \"middleware.interceptQuery\",\n\t\t\t\t\tmiddleware: mw.name\n\t\t\t\t});\n\t\t\t\trowSource = blindCast(result.rows);\n\t\t\t\tbreak;\n\t\t\t}\n\t\t\tif (source === \"driver\") rowSource = runDriver();\n\t\t\tfor await (const row of rowSource) {\n\t\t\t\tif (source === \"driver\") {\n\t\t\t\t\tfor (const mw of middleware) if (mw.onRow) await mw.onRow(row, exec, ctx);\n\t\t\t\t}\n\t\t\t\trowCount++;\n\t\t\t\tyield row;\n\t\t\t}\n\t\t\tcompleted = true;\n\t\t} catch (error) {\n\t\t\tawait notifyQueryCompletion(middleware, exec, ctx, {\n\t\t\t\trowCount,\n\t\t\t\tlatencyMs: Date.now() - startedAt,\n\t\t\t\tcompleted,\n\t\t\t\tsource\n\t\t\t}, true);\n\t\t\tthrow error;\n\t\t}\n\t\tawait notifyQueryCompletion(middleware, exec, ctx, {\n\t\t\trowCount,\n\t\t\tlatencyMs: Date.now() - startedAt,\n\t\t\tcompleted,\n\t\t\tsource\n\t\t}, false);\n\t};\n\treturn new AsyncIterableResult(iterator());\n}\n/**\n* Drives a single execute operation through the middleware\n* `interceptExecute` + statistics + termination phases.\n*\n* Lifecycle, in order:\n*  1. For each middleware in registration order: `interceptExecute(exec, ctx)`.\n*     The first non-`undefined` result wins; subsequent middleware's\n*     `interceptExecute` does not fire. On a hit, the runtime emits a\n*     `middleware.interceptExecute` debug event naming the winning middleware,\n*     uses the returned `stats`, and proceeds with `source: 'middleware'`.\n*     On all-passthrough (every `interceptExecute` returns `undefined` or is\n*     omitted), `source: 'driver'` is used and `runDriver()` supplies the\n*     statistics.\n*  2. Execute operations return eager statistics. There is no row stream and\n*     `onRow` does not fire.\n*  3. On successful completion: for each middleware in registration order:\n*     `afterExecute(exec, { stats, latencyMs, completed: true, source }, ctx)`.\n*  4. On any error thrown during steps 1–2: for each middleware in\n*     registration order: `afterExecute(exec, { latencyMs, completed: false,\n*     source }, ctx)`. Errors thrown by `afterExecute` during the error path\n*     are swallowed so they do not mask the original error. The original\n*     error is then rethrown.\n*\n* `beforeExecute` is **not** fired here — see\n* {@link runBeforeExecuteChain} in `before-execute-chain.ts`. Family runtimes\n* call that helper between the AST → plan lowering step and the parameter\n* encode step so middleware that mutates ParamRef values can have its\n* mutations visible to encode. `runExecuteWithMiddleware` operates on the\n* fully-encoded plan; interceptors therefore observe a fully-mutated,\n* encoded plan.\n*\n* The `source` field on `AfterExecuteResult` lets observers (telemetry, lints,\n* budgets) distinguish driver-served from middleware-served executions\n* without needing their own out-of-band signal.\n*/\nasync function runExecuteWithMiddleware(exec, middleware, ctx, runDriver) {\n\tconst startedAt = Date.now();\n\tlet source = \"driver\";\n\tlet stats;\n\ttry {\n\t\tfor (const mw of middleware) {\n\t\t\tif (!mw.interceptExecute) continue;\n\t\t\tsource = \"middleware\";\n\t\t\tconst result = await mw.interceptExecute(exec, ctx);\n\t\t\tif (result === void 0) {\n\t\t\t\tsource = \"driver\";\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tctx.log.debug?.({\n\t\t\t\tevent: \"middleware.interceptExecute\",\n\t\t\t\tmiddleware: mw.name\n\t\t\t});\n\t\t\tstats = result.stats;\n\t\t\tbreak;\n\t\t}\n\t\tif (stats === void 0) stats = await runDriver();\n\t} catch (error) {\n\t\tconst latencyMs = Date.now() - startedAt;\n\t\tfor (const mw of middleware) {\n\t\t\tif (!mw.afterExecute) continue;\n\t\t\ttry {\n\t\t\t\tawait mw.afterExecute(exec, {\n\t\t\t\t\tlatencyMs,\n\t\t\t\t\tcompleted: false,\n\t\t\t\t\tsource\n\t\t\t\t}, ctx);\n\t\t\t} catch {}\n\t\t}\n\t\tthrow error;\n\t}\n\tconst latencyMs = Date.now() - startedAt;\n\tfor (const mw of middleware) if (mw.afterExecute) await mw.afterExecute(exec, {\n\t\tstats,\n\t\tlatencyMs,\n\t\tcompleted: true,\n\t\tsource\n\t}, ctx);\n\treturn stats;\n}\nasync function notifyQueryCompletion(middleware, exec, ctx, result, swallowErrors) {\n\tfor (const mw of middleware) {\n\t\tif (!mw.afterQuery) continue;\n\t\tif (swallowErrors) try {\n\t\t\tawait mw.afterQuery(exec, result, ctx);\n\t\t} catch {}\n\t\telse await mw.afterQuery(exec, result, ctx);\n\t}\n}\n//#endregion\n//#region src/execution/runtime-core.ts\n/**\n* Family-agnostic abstract runtime base.\n*\n* Defines the shared operation-specific middleware lifecycles:\n*\n* 1. `runBeforeCompile(plan)` — concrete; defaults to identity. SQL overrides\n*    this to run its shared `beforeCompile` middleware-hook chain.\n* 2. `lower(plan)` — abstract. Each family produces its `*ExecutionPlan`\n*    (SQL via `lowerSqlPlan`, Mongo via `adapter.lower`).\n* 3. Queries run `beforeQuery`; statements run `beforeExecute`. Both chains\n*    run after lowering and before their matching driver terminal. Family\n*    runtimes that expose a params mutator to downstream encoding override\n*    the operation and call the matching helper at the pre-encode point.\n* 4. The matching runner processes `interceptQuery` or `interceptExecute`\n*    before invoking the driver. Queries then fire `onRow` and `afterQuery`;\n*    statements fire `afterExecute`.\n*\n* Concrete subclasses must implement `lower`, `runDriver`, `runExecute`, and\n* `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 the operation-specific runners invoke\n*   hooks with the lowered `TExec`. Middleware therefore sees the\n*   post-lowering plan.\n*/\nvar RuntimeCore = class {\n\tmiddleware;\n\tctx;\n\tconstructor(options) {\n\t\tthis.middleware = options.middleware;\n\t\tthis.ctx = options.ctx;\n\t}\n\t/**\n\t* Pre-lowering hook for plan rewriting. Defaults to identity. Subclasses\n\t* may override to run a `beforeCompile` middleware chain (SQL does this\n\t* to support typed AST rewrites — see `before-compile-chain.ts`).\n\t*/\n\trunBeforeCompile(plan) {\n\t\treturn plan;\n\t}\n\tquery(plan, options) {\n\t\tconst self = this;\n\t\tconst signal = options?.signal;\n\t\tconst codecCtx = signal === void 0 ? {} : { signal };\n\t\tconst execCtx = {\n\t\t\t...self.ctx,\n\t\t\t...codecCtx,\n\t\t\tscope: options?.scope ?? self.ctx.scope,\n\t\t\tplanExecutionId: crypto.randomUUID()\n\t\t};\n\t\tasync function* generator() {\n\t\t\tcheckAborted(codecCtx, \"stream\");\n\t\t\tconst compiled = await self.runBeforeCompile(plan);\n\t\t\tconst exec = await self.lower(compiled, codecCtx);\n\t\t\tawait runBeforeQueryChain(exec, self.middleware, execCtx);\n\t\t\tyield* runQueryWithMiddleware(exec, self.middleware, execCtx, () => self.runDriver(exec));\n\t\t}\n\t\treturn new AsyncIterableResult(generator());\n\t}\n\tasync execute(plan, options) {\n\t\tconst signal = options?.signal;\n\t\tconst codecCtx = signal === void 0 ? {} : { signal };\n\t\tconst execCtx = {\n\t\t\t...this.ctx,\n\t\t\t...codecCtx,\n\t\t\tscope: options?.scope ?? this.ctx.scope,\n\t\t\tplanExecutionId: crypto.randomUUID()\n\t\t};\n\t\tcheckAborted(codecCtx, \"stream\");\n\t\tconst compiled = await this.runBeforeCompile(plan);\n\t\tconst exec = await this.lower(compiled, codecCtx);\n\t\tawait runBeforeExecuteChain(exec, this.middleware, execCtx);\n\t\treturn runExecuteWithMiddleware(exec, this.middleware, execCtx, () => this.runExecute(exec));\n\t}\n};\n//#endregion\n//#region src/execution/runtime-middleware.ts\nfunction checkMiddlewareCompatibility(middleware, runtimeFamilyId, runtimeTargetId) {\n\tif (middleware.targetId !== void 0 && middleware.familyId === void 0) throw runtimeError(\"RUNTIME.MIDDLEWARE_INCOMPATIBLE\", `Middleware '${middleware.name}' specifies targetId '${middleware.targetId}' without familyId`, {\n\t\tmiddleware: middleware.name,\n\t\ttargetId: middleware.targetId\n\t});\n\tif (middleware.familyId !== void 0 && middleware.familyId !== runtimeFamilyId) throw runtimeError(\"RUNTIME.MIDDLEWARE_FAMILY_MISMATCH\", `Middleware '${middleware.name}' requires family '${middleware.familyId}' but the runtime is configured for family '${runtimeFamilyId}'`, {\n\t\tmiddleware: middleware.name,\n\t\tmiddlewareFamilyId: middleware.familyId,\n\t\truntimeFamilyId\n\t});\n\tif (middleware.targetId !== void 0 && middleware.targetId !== runtimeTargetId) throw runtimeError(\"RUNTIME.MIDDLEWARE_TARGET_MISMATCH\", `Middleware '${middleware.name}' requires target '${middleware.targetId}' but the runtime is configured for target '${runtimeTargetId}'`, {\n\t\tmiddleware: middleware.name,\n\t\tmiddlewareTargetId: middleware.targetId,\n\t\truntimeTargetId\n\t});\n}\n//#endregion\n//#region src/meta-builder.ts\nvar MetaBuilderImpl = class {\n\t#kind;\n\t#terminalName;\n\t#annotations = /* @__PURE__ */ new Map();\n\tconstructor(kind, terminalName) {\n\t\tthis.#kind = kind;\n\t\tthis.#terminalName = terminalName;\n\t}\n\tget annotations() {\n\t\treturn this.#annotations;\n\t}\n\tannotate(annotation) {\n\t\tconst value = annotation;\n\t\tassertAnnotationsApplicable([value], this.#kind, this.#terminalName);\n\t\tthis.#annotations.set(value.namespace, value);\n\t\treturn this;\n\t}\n};\n/**\n* Construct a lane-side meta builder for a terminal of operation kind `K`.\n*\n* Lane terminals call this with their `kind` (`'read'` or `'write'`) and a\n* `terminalName` for error messages, hand the resulting builder to the\n* user-supplied configurator callback (typed as `MetaBuilder<K>`, the\n* narrower public view), and read `meta.annotations` afterwards to thread\n* the recorded values into `plan.meta.annotations`.\n*/\nfunction createMetaBuilder(kind, terminalName) {\n\treturn new MetaBuilderImpl(kind, terminalName);\n}\n//#endregion\nexport { AsyncIterableResult, RUNTIME_ABORTED, RuntimeCore, assertAnnotationsApplicable, checkAborted, checkMiddlewareCompatibility, createMetaBuilder, defineAnnotation, isRuntimeError, raceAgainstAbort, runBeforeExecuteChain, runBeforeQueryChain, runExecuteWithMiddleware, runQueryWithMiddleware, runtimeAborted, runtimeError };\n\n//# sourceMappingURL=runtime.mjs.map"],"mappings":"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"}