@prisma/orm-family-sql 8.0.0-rc.14 → 8.0.0-rc.14-dev.2

package/dist/runtime.mjs

@@ -9,11 +9,11 @@ import { isStructuredError } from "@prisma/orm-framework/utils/structured-error"
 import { createHash } from "node:crypto";
 import { assertNever } from "@prisma/orm-framework/utils/internal-error";
 import { ifDefined } from "@prisma/orm-framework/utils/defined";
-import { AsyncIterableResult, RuntimeCore, applyMutationDefaults, assertMutationDefaultGeneratorsAvailable, checkAborted, checkMiddlewareCompatibility, collectMutationDefaultGenerators, raceAgainstAbort, runBeforeExecuteChain, runBeforeQueryChain, runExecuteWithMiddleware, runQueryWithMiddleware, runtimeError } from "@prisma/orm-framework/components/runtime";
-import { blindCast } from "@prisma/orm-framework/utils/casts";
-import { canonicalStringify } from "@prisma/orm-framework/utils/canonical-stringify";
 import { materializeCodec, resolveCodecDescriptorOrThrow } from "@prisma/orm-framework/components/codec";
 import { checkContractComponentRequirements, mergeCapabilityMatrices } from "@prisma/orm-framework/components/components";
+import { AsyncIterableResult, RuntimeCore, applyMutationDefaults, assertMutationDefaultGeneratorsAvailable, checkAborted, checkMiddlewareCompatibility, collectMutationDefaultGenerators, raceAgainstAbort, runBeforeExecuteChain, runBeforeQueryChain, runExecuteWithMiddleware, runQueryWithMiddleware, runtimeError as runtimeError$1 } from "@prisma/orm-framework/components/runtime";
+import { blindCast } from "@prisma/orm-framework/utils/casts";
+import { canonicalStringify } from "@prisma/orm-framework/utils/canonical-stringify";
 import { canonicalizeJson } from "@prisma/orm-framework/components/utils";
 import { createExecutionStack } from "@prisma/orm-framework/components/execution";
 import { hashContent } from "@prisma/orm-framework/utils/hash-content";
@@ -73,7 +73,7 @@ function paramLabel(metadata, paramIndex) {
 }
 function wrapEncodeFailure(error, metadata, paramIndex, codecId) {
 	const label = paramLabel(metadata, paramIndex);
-	const wrapped = runtimeError("RUNTIME.ENCODE_FAILED", `Failed to encode parameter ${label} with codec '${codecId}': ${error instanceof Error ? error.message : String(error)}`, {
+	const wrapped = runtimeError$1("RUNTIME.ENCODE_FAILED", `Failed to encode parameter ${label} with codec '${codecId}': ${error instanceof Error ? error.message : String(error)}`, {
 		label,
 		codec: codecId,
 		paramIndex
@@ -155,7 +155,7 @@ function validateContractCodecMappings(registry, contract) {
 			contractTarget: contract.target,
 			invalidCodecs
 		};
-		throw runtimeError("RUNTIME.CODEC_MISSING", `Missing codec implementations for column codecIds: ${invalidCodecs.map((c) => `${c.namespaceId}.${c.table}.${c.column} (${c.codecId})`).join(", ")}`, details);
+		throw runtimeError$1("RUNTIME.CODEC_MISSING", `Missing codec implementations for column codecIds: ${invalidCodecs.map((c) => `${c.namespaceId}.${c.table}.${c.column} (${c.codecId})`).join(", ")}`, details);
 	}
 }
 function validateCodecRegistryCompleteness(registry, contract) {
@@ -177,7 +177,7 @@ function lowerSqlPlan(adapter, contract, queryPlan) {
 	});
 	const params = lowered.params.map((slot) => {
 		if (slot.kind === "literal") return slot.value;
-		throw runtimeError("RUNTIME.PREPARE_BIND_ON_ADHOC", `Ad-hoc execute received a bind-site slot for '${slot.name}' — bind-site references are only valid inside runtime.prepare(...).`, { name: slot.name });
+		throw runtimeError$1("RUNTIME.PREPARE_BIND_ON_ADHOC", `Ad-hoc execute received a bind-site slot for '${slot.name}' — bind-site references are only valid inside runtime.prepare(...).`, { name: slot.name });
 	});
 	return Object.freeze({
 		sql: lowered.sql,
@@ -231,7 +231,7 @@ function budgets(options) {
 		const latencyMs = result.latencyMs;
 		if (latencyMs > maxLatencyMs) {
 			const shouldBlock = latencySeverity === "error" || ctx.mode === "strict";
-			emitBudgetViolation(runtimeError("BUDGET.TIME_EXCEEDED", "Query latency exceeds budget", {
+			emitBudgetViolation(runtimeError$1("BUDGET.TIME_EXCEEDED", "Query latency exceeds budget", {
 				latencyMs,
 				maxLatencyMs
 			}), shouldBlock, ctx);
@@ -246,7 +246,7 @@ function budgets(options) {
 			const state = observedRowsByPlan.get(plan);
 			if (!state) return;
 			state.count += 1;
-			if (state.count > maxRows) throw runtimeError("BUDGET.ROWS_EXCEEDED", "Observed row count exceeds budget", {
+			if (state.count > maxRows) throw runtimeError$1("BUDGET.ROWS_EXCEEDED", "Observed row count exceeds budget", {
 				source: "observed",
 				observedRows: state.count,
 				maxRows
@@ -261,7 +261,7 @@ function budgets(options) {
 		const isUnbounded = ast.limit === void 0 && !hasAggNoGroup;
 		const shouldBlock = rowSeverity === "error" || ctx.mode === "strict";
 		if (isUnbounded) {
-			emitBudgetViolation(runtimeError("BUDGET.ROWS_EXCEEDED", "Unbounded SELECT query exceeds budget", estimated >= maxRows ? {
+			emitBudgetViolation(runtimeError$1("BUDGET.ROWS_EXCEEDED", "Unbounded SELECT query exceeds budget", estimated >= maxRows ? {
 				source: "ast",
 				estimatedRows: estimated,
 				maxRows
@@ -271,7 +271,7 @@ function budgets(options) {
 			}), shouldBlock, ctx);
 			return;
 		}
-		if (estimated > maxRows) emitBudgetViolation(runtimeError("BUDGET.ROWS_EXCEEDED", "Estimated row count exceeds budget", {
+		if (estimated > maxRows) emitBudgetViolation(runtimeError$1("BUDGET.ROWS_EXCEEDED", "Estimated row count exceeds budget", {
 			source: "ast",
 			estimatedRows: estimated,
 			maxRows
@@ -443,7 +443,7 @@ function lints(options) {
 		} else if (fallback !== "skip") findings.push(...evaluateRawGuardrails(plan).lints);
 		for (const lint of findings) {
 			const effectiveSeverity = getConfiguredSeverity(lint.code, options) ?? lint.severity;
-			if (effectiveSeverity === "error") throw runtimeError(lint.code, lint.message, lint.details);
+			if (effectiveSeverity === "error") throw runtimeError$1(lint.code, lint.message, lint.details);
 			if (effectiveSeverity === "warn") ctx.log.warn({
 				code: lint.code,
 				message: lint.message,
@@ -529,29 +529,29 @@ function assertExecutionStackContractRequirements(contract, stack) {
 		expectedTargetId: stack.target.targetId,
 		providedComponentIds
 	});
-	if (result.familyMismatch) throw runtimeError("RUNTIME.CONTRACT_FAMILY_MISMATCH", `Contract target family '${result.familyMismatch.actual}' does not match runtime family '${result.familyMismatch.expected}'.`, {
+	if (result.familyMismatch) throw runtimeError$1("RUNTIME.CONTRACT_FAMILY_MISMATCH", `Contract target family '${result.familyMismatch.actual}' does not match runtime family '${result.familyMismatch.expected}'.`, {
 		actual: result.familyMismatch.actual,
 		expected: result.familyMismatch.expected
 	});
-	if (result.targetMismatch) throw runtimeError("RUNTIME.CONTRACT_TARGET_MISMATCH", `Contract target '${result.targetMismatch.actual}' does not match runtime target descriptor '${result.targetMismatch.expected}'.`, {
+	if (result.targetMismatch) throw runtimeError$1("RUNTIME.CONTRACT_TARGET_MISMATCH", `Contract target '${result.targetMismatch.actual}' does not match runtime target descriptor '${result.targetMismatch.expected}'.`, {
 		actual: result.targetMismatch.actual,
 		expected: result.targetMismatch.expected
 	});
 	if (result.missingExtensionPackIds.length > 0) {
 		const packIds = result.missingExtensionPackIds;
-		throw runtimeError("RUNTIME.MISSING_EXTENSION_PACK", `Contract requires extension pack(s) ${packIds.map((id) => `'${id}'`).join(", ")}, but runtime descriptors do not provide matching component(s).`, { packIds });
+		throw runtimeError$1("RUNTIME.MISSING_EXTENSION_PACK", `Contract requires extension pack(s) ${packIds.map((id) => `'${id}'`).join(", ")}, but runtime descriptors do not provide matching component(s).`, { packIds });
 	}
 }
 function validateTypeParams(typeParams, descriptor, context) {
 	const result = descriptor.paramsSchema["~standard"].validate(typeParams);
-	if (result instanceof Promise) throw runtimeError("RUNTIME.TYPE_PARAMS_INVALID", `paramsSchema for codec '${descriptor.codecId}' returned a Promise; runtime validation requires a synchronous Standard Schema validator.`, {
+	if (result instanceof Promise) throw runtimeError$1("RUNTIME.TYPE_PARAMS_INVALID", `paramsSchema for codec '${descriptor.codecId}' returned a Promise; runtime validation requires a synchronous Standard Schema validator.`, {
 		...context,
 		codecId: descriptor.codecId,
 		typeParams
 	});
 	if (result.issues) {
 		const messages = result.issues.map((issue) => issue.message).join("; ");
-		throw runtimeError("RUNTIME.TYPE_PARAMS_INVALID", `Invalid typeParams for ${context.typeName ? `type '${context.typeName}'` : `column '${context.tableName}.${context.columnName}'`} (codecId: ${descriptor.codecId}): ${messages}`, {
+		throw runtimeError$1("RUNTIME.TYPE_PARAMS_INVALID", `Invalid typeParams for ${context.typeName ? `type '${context.typeName}'` : `column '${context.tableName}.${context.columnName}'`} (codecId: ${descriptor.codecId}): ${messages}`, {
 			...context,
 			codecId: descriptor.codecId,
 			typeParams
@@ -569,7 +569,7 @@ function collectCodecDescriptors(contributors) {
 	const parameterized = /* @__PURE__ */ new Map();
 	const seen = /* @__PURE__ */ new Set();
 	for (const contributor of contributors) for (const descriptor of contributor.codecs()) {
-		if (seen.has(descriptor.codecId)) throw runtimeError("RUNTIME.DUPLICATE_CODEC", `Duplicate codec descriptor for codecId '${descriptor.codecId}'.`, { codecId: descriptor.codecId });
+		if (seen.has(descriptor.codecId)) throw runtimeError$1("RUNTIME.DUPLICATE_CODEC", `Duplicate codec descriptor for codecId '${descriptor.codecId}'.`, { codecId: descriptor.codecId });
 		seen.add(descriptor.codecId);
 		all.push(descriptor);
 		if (descriptor.isParameterized) parameterized.set(descriptor.codecId, blindCast(descriptor));
@@ -645,7 +645,7 @@ function assertColumnCodecIntegrity(storage, codecDescriptors) {
 		const ref = codecDescriptors.codecRefForColumn(namespaceId, tableName, columnName);
 		if (!ref) continue;
 		const descriptor = codecDescriptors.descriptorFor(ref.codecId);
-		if (!descriptor) throw runtimeError("RUNTIME.CODEC_DESCRIPTOR_MISSING", `Column '${tableName}.${columnName}' references codec '${ref.codecId}' but no contributor registered a codec descriptor for that codecId. Add the extension pack that owns the codec to the runtime stack.`, {
+		if (!descriptor) throw runtimeError$1("RUNTIME.CODEC_DESCRIPTOR_MISSING", `Column '${tableName}.${columnName}' references codec '${ref.codecId}' but no contributor registered a codec descriptor for that codecId. Add the extension pack that owns the codec to the runtime stack.`, {
 			table: tableName,
 			column: columnName,
 			codecId: ref.codecId
@@ -655,13 +655,13 @@ function assertColumnCodecIntegrity(storage, codecDescriptors) {
 			const probe = paramsSchema["~standard"].validate({});
 			if (probe instanceof Promise) {
 				probe.catch(() => {});
-				throw runtimeError("RUNTIME.TYPE_PARAMS_INVALID", `Column '${tableName}.${columnName}' uses parameterized codec '${ref.codecId}' whose paramsSchema returned a Promise; paramsSchema must be a synchronous Standard Schema validator. Return a value/issues result directly instead of a Promise.`, {
+				throw runtimeError$1("RUNTIME.TYPE_PARAMS_INVALID", `Column '${tableName}.${columnName}' uses parameterized codec '${ref.codecId}' whose paramsSchema returned a Promise; paramsSchema must be a synchronous Standard Schema validator. Return a value/issues result directly instead of a Promise.`, {
 					table: tableName,
 					column: columnName,
 					codecId: ref.codecId
 				});
 			}
-			if ("issues" in probe && !!probe.issues) throw runtimeError("RUNTIME.CODEC_PARAMETERIZATION_MISMATCH", `Column '${tableName}.${columnName}' uses parameterized codec '${ref.codecId}' but no typeParams are supplied. Provide typeParams on the column, or use a typeRef pointing at a storage.types entry that carries them.`, {
+			if ("issues" in probe && !!probe.issues) throw runtimeError$1("RUNTIME.CODEC_PARAMETERIZATION_MISMATCH", `Column '${tableName}.${columnName}' uses parameterized codec '${ref.codecId}' but no typeParams are supplied. Provide typeParams on the column, or use a typeRef pointing at a storage.types entry that carries them.`, {
 				table: tableName,
 				column: columnName,
 				codecId: ref.codecId,
@@ -671,7 +671,7 @@ function assertColumnCodecIntegrity(storage, codecDescriptors) {
 		}
 		const refTypeParams = ref.typeParams;
 		const refHasTypeParamKeys = refTypeParams !== void 0 && refTypeParams !== null && typeof refTypeParams === "object" && !Array.isArray(refTypeParams) && Object.keys(refTypeParams).length > 0;
-		if (!descriptor.isParameterized && refHasTypeParamKeys) throw runtimeError("RUNTIME.CODEC_PARAMETERIZATION_MISMATCH", `Column '${tableName}.${columnName}' supplies typeParams to non-parameterized codec '${ref.codecId}'. Remove the typeParams or switch to a parameterized codec id.`, {
+		if (!descriptor.isParameterized && refHasTypeParamKeys) throw runtimeError$1("RUNTIME.CODEC_PARAMETERIZATION_MISMATCH", `Column '${tableName}.${columnName}' supplies typeParams to non-parameterized codec '${ref.codecId}'. Remove the typeParams or switch to a parameterized codec id.`, {
 			table: tableName,
 			column: columnName,
 			codecId: ref.codecId,
@@ -883,7 +883,7 @@ function previewWireValue(wireValue) {
 }
 function wrapDecodeFailure(error, alias, ref, codec, wireValue) {
 	const message = error instanceof Error ? error.message : String(error);
-	const wrapped = runtimeError("RUNTIME.DECODE_FAILED", `Failed to decode column ${ref ? `${ref.table}.${ref.column}` : alias} with codec '${codec.id}': ${message}`, {
+	const wrapped = runtimeError$1("RUNTIME.DECODE_FAILED", `Failed to decode column ${ref ? `${ref.table}.${ref.column}` : alias} with codec '${codec.id}': ${message}`, {
 		...ref ? {
 			table: ref.table,
 			column: ref.column
@@ -895,7 +895,7 @@ function wrapDecodeFailure(error, alias, ref, codec, wireValue) {
 	throw wrapped;
 }
 function wrapIncludeAggregateFailure(error, alias, wireValue) {
-	const wrapped = runtimeError("RUNTIME.DECODE_FAILED", `Failed to parse JSON array for include alias '${alias}': ${error instanceof Error ? error.message : String(error)}`, {
+	const wrapped = runtimeError$1("RUNTIME.DECODE_FAILED", `Failed to parse JSON array for include alias '${alias}': ${error instanceof Error ? error.message : String(error)}`, {
 		alias,
 		wirePreview: previewWireValue(wireValue)
 	});
@@ -974,11 +974,11 @@ async function decodeRow(row, decodeCtx, rowCtx, listDecoder) {
 	const signal = rowCtx.signal;
 	const aliases = decodeCtx.aliases ?? Object.keys(row);
 	if (decodeCtx.aliases !== void 0) {
-		for (const alias of decodeCtx.aliases) if (!Object.hasOwn(row, alias)) throw decodeCtx.aliasSource === "row-spec" ? runtimeError("RUNTIME.RAW_ROW_COLUMN_MISSING", `Raw statement result has no column "${alias}", which its row spec declares`, {
+		for (const alias of decodeCtx.aliases) if (!Object.hasOwn(row, alias)) throw decodeCtx.aliasSource === "row-spec" ? runtimeError$1("RUNTIME.RAW_ROW_COLUMN_MISSING", `Raw statement result has no column "${alias}", which its row spec declares`, {
 			column: alias,
 			declaredColumns: decodeCtx.aliases,
 			resultColumns: Object.keys(row)
-		}) : runtimeError("RUNTIME.DECODE_FAILED", `Row missing projection alias "${alias}"`, {
+		}) : runtimeError$1("RUNTIME.DECODE_FAILED", `Row missing projection alias "${alias}"`, {
 			alias,
 			expectedAliases: decodeCtx.aliases,
 			presentKeys: Object.keys(row)
@@ -1124,10 +1124,10 @@ function isRecord(value) {
 	return typeof value === "object" && value !== null;
 }
 function resolvePreparedSlotValues(ps, userParams) {
-	if (!isRecord(userParams)) throw runtimeError("RUNTIME.PREPARE_MISSING_PARAM", "Prepared statement parameters must be an object");
+	if (!isRecord(userParams)) throw runtimeError$1("RUNTIME.PREPARE_MISSING_PARAM", "Prepared statement parameters must be an object");
 	return ps.slots.map((slot) => {
 		if (slot.kind === "literal") return slot.value;
-		if (!Object.hasOwn(userParams, slot.name)) throw runtimeError("RUNTIME.PREPARE_MISSING_PARAM", `Prepared statement query is missing parameter '${slot.name}'`, { name: slot.name });
+		if (!Object.hasOwn(userParams, slot.name)) throw runtimeError$1("RUNTIME.PREPARE_MISSING_PARAM", `Prepared statement query is missing parameter '${slot.name}'`, { name: slot.name });
 		return userParams[slot.name];
 	});
 }
@@ -1139,11 +1139,11 @@ var SqlFamilyAdapter = class {
 		this.markerReader = adapterProfile;
 	}
 	validatePlan(plan, contract) {
-		if (plan.meta.target !== contract.target) throw runtimeError("PLAN.TARGET_MISMATCH", "Plan target does not match runtime target", {
+		if (plan.meta.target !== contract.target) throw runtimeError$1("PLAN.TARGET_MISMATCH", "Plan target does not match runtime target", {
 			planTarget: plan.meta.target,
 			runtimeTarget: contract.target
 		});
-		if (plan.meta.storageHash !== contract.storage.storageHash) throw runtimeError("PLAN.HASH_MISMATCH", "Plan storage hash does not match runtime contract", {
+		if (plan.meta.storageHash !== contract.storage.storageHash) throw runtimeError$1("PLAN.HASH_MISMATCH", "Plan storage hash does not match runtime contract", {
 			planStorageHash: plan.meta.storageHash,
 			runtimeStorageHash: contract.storage.storageHash
 		});
@@ -1422,7 +1422,7 @@ var SqlRuntimeBase = class extends RuntimeCore {
 		const referencedNames = /* @__PURE__ */ new Set();
 		for (const ref of orderedRefs) if (ref.kind === "prepared-param-ref") referencedNames.add(ref.name);
 		const missing = Object.keys(declaration).filter((name) => !referencedNames.has(name));
-		if (missing.length > 0) throw runtimeError("RUNTIME.PREPARE_UNUSED_PARAM", `Prepared statement declaration includes parameter${missing.length === 1 ? "" : "s"} not referenced by the callback's plan: ${missing.join(", ")}`, { unused: missing });
+		if (missing.length > 0) throw runtimeError$1("RUNTIME.PREPARE_UNUSED_PARAM", `Prepared statement declaration includes parameter${missing.length === 1 ? "" : "s"} not referenced by the callback's plan: ${missing.join(", ")}`, { unused: missing });
 		const lowered = this.adapter.lower(finalPlan.ast, {
 			contract: this.contract,
 			params: orderedRefs.map((r) => r.kind === "param-ref" ? r.value : void 0)
@@ -1652,7 +1652,7 @@ var SqlRuntimeBase = class extends RuntimeCore {
 	}
 };
 function transactionClosedError() {
-	return runtimeError("RUNTIME.TRANSACTION_CLOSED", "Cannot use a transaction operation after the transaction has ended. Consume query results and await execute calls inside the transaction callback.", {});
+	return runtimeError$1("RUNTIME.TRANSACTION_CLOSED", "Cannot use a transaction operation after the transaction has ended. Consume query results and await execute calls inside the transaction callback.", {});
 }
 async function withTransaction(runtime, fn) {
 	const connection = await runtime.connection();
@@ -1701,7 +1701,7 @@ async function withTransaction(runtime, fn) {
 				await transaction.rollback();
 			} catch (rollbackError) {
 				await destroyConnection(rollbackError);
-				const wrapped = runtimeError("RUNTIME.TRANSACTION_ROLLBACK_FAILED", "Transaction rollback failed after callback error", { rollbackError });
+				const wrapped = runtimeError$1("RUNTIME.TRANSACTION_ROLLBACK_FAILED", "Transaction rollback failed after callback error", { rollbackError });
 				wrapped.cause = error;
 				throw wrapped;
 			}
@@ -1717,7 +1717,7 @@ async function withTransaction(runtime, fn) {
 			} catch {
 				await destroyConnection(commitError);
 			}
-			const wrapped = runtimeError("RUNTIME.TRANSACTION_COMMIT_FAILED", "Transaction commit failed", { commitError });
+			const wrapped = runtimeError$1("RUNTIME.TRANSACTION_COMMIT_FAILED", "Transaction commit failed", { commitError });
 			wrapped.cause = commitError;
 			throw wrapped;
 		}