@prisma-next/sql-runtime 0.3.0-pr.71.6 → 0.3.0-pr.71.8

package/README.md

@@ -28,8 +28,7 @@ Execute SQL query Plans with deterministic verification, guardrails, and feedbac
 ## Dependencies
 
 - `@prisma-next/runtime-executor` - Target-neutral execution engine
-- `@prisma-next/sql-contract` - SQL contract types
-- `@prisma-next/sql-target` - SQL family interfaces (legacy transitional package)
+- `@prisma-next/sql-contract` - SQL contract types (via `@prisma-next/sql-contract/types`)
 - `@prisma-next/operations` - Operation registry
 
 ## Usage

package/dist/src/codecs/decoding.d.ts

@@ -0,0 +1,4 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+import type { CodecRegistry } from '@prisma-next/sql-relational-core/ast';
+export declare function decodeRow(row: Record<string, unknown>, plan: ExecutionPlan, registry: CodecRegistry): Record<string, unknown>;
+//# sourceMappingURL=decoding.d.ts.map

package/dist/src/codecs/decoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decoding.d.ts","sourceRoot":"","sources":["../../../src/codecs/decoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAS,aAAa,EAAE,MAAM,sCAAsC,CAAC;AA4BjF,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,aAAa,GACtB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0GzB"}

package/dist/src/codecs/encoding.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutionPlan, ParamDescriptor } from '@prisma-next/contract/types';
+import type { CodecRegistry } from '@prisma-next/sql-relational-core/ast';
+export declare function encodeParam(value: unknown, paramDescriptor: ParamDescriptor, plan: ExecutionPlan, registry: CodecRegistry): unknown;
+export declare function encodeParams(plan: ExecutionPlan, registry: CodecRegistry): readonly unknown[];
+//# sourceMappingURL=encoding.d.ts.map

package/dist/src/codecs/encoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoding.d.ts","sourceRoot":"","sources":["../../../src/codecs/encoding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAClF,OAAO,KAAK,EAAS,aAAa,EAAE,MAAM,sCAAsC,CAAC;AA2BjF,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,eAAe,EAAE,eAAe,EAChC,IAAI,EAAE,aAAa,EACnB,QAAQ,EAAE,aAAa,GACtB,OAAO,CAqBT;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,GAAG,SAAS,OAAO,EAAE,CAmB7F"}

package/dist/src/codecs/validation.d.ts

@@ -0,0 +1,6 @@
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { CodecRegistry } from '@prisma-next/sql-relational-core/ast';
+export declare function extractCodecIds(contract: SqlContract<SqlStorage>): Set<string>;
+export declare function validateContractCodecMappings(registry: CodecRegistry, contract: SqlContract<SqlStorage>): void;
+export declare function validateCodecRegistryCompleteness(registry: CodecRegistry, contract: SqlContract<SqlStorage>): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/codecs/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/codecs/validation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAE1E,wBAAgB,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,CAW9E;AAgBD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,GAChC,IAAI,CAyBN;AAED,wBAAgB,iCAAiC,CAC/C,QAAQ,EAAE,aAAa,EACvB,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,GAChC,IAAI,CAEN"}

package/dist/src/exports/index.d.ts

@@ -0,0 +1,11 @@
+export type { AfterExecuteResult, BudgetsOptions, LintsOptions, Log, Plugin, PluginContext, } from '@prisma-next/runtime-executor';
+export { budgets, lints } from '@prisma-next/runtime-executor';
+export { extractCodecIds, validateCodecRegistryCompleteness, validateContractCodecMappings, } from '../codecs/validation';
+export { lowerSqlPlan } from '../lower-sql-plan';
+export type { CreateRuntimeContextOptions, RuntimeContext, SqlRuntimeAdapterInstance, SqlRuntimeExtensionDescriptor, SqlRuntimeExtensionInstance, } from '../sql-context';
+export { createRuntimeContext } from '../sql-context';
+export type { SqlStatement } from '../sql-marker';
+export { ensureSchemaStatement, ensureTableStatement, readContractMarker, writeContractMarker, } from '../sql-marker';
+export type { Runtime, RuntimeOptions, RuntimeTelemetryEvent, RuntimeVerifyOptions, TelemetryOutcome, } from '../sql-runtime';
+export { createRuntime } from '../sql-runtime';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/exports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/exports/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,YAAY,EACZ,GAAG,EACH,MAAM,EACN,aAAa,GACd,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EACL,eAAe,EACf,iCAAiC,EACjC,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,YAAY,EACV,2BAA2B,EAC3B,cAAc,EACd,yBAAyB,EACzB,6BAA6B,EAC7B,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,OAAO,EACP,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export * from './exports';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}

package/dist/src/lower-sql-plan.d.ts

@@ -0,0 +1,15 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+import type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
+import type { RuntimeContext } from './sql-context';
+/**
+ * Lowers a SQL query plan to an executable Plan by calling the adapter's lower method.
+ *
+ * This function is responsible for converting a lane-produced SqlQueryPlan (which contains
+ * AST and params but no SQL) into a fully executable Plan (which includes SQL string).
+ *
+ * @param context - Runtime context containing the adapter
+ * @param queryPlan - SQL query plan from a lane (contains AST, params, meta, but no SQL)
+ * @returns Fully executable Plan with SQL string
+ */
+export declare function lowerSqlPlan<Row>(context: RuntimeContext, queryPlan: SqlQueryPlan<Row>): ExecutionPlan<Row>;
+//# sourceMappingURL=lower-sql-plan.d.ts.map

package/dist/src/lower-sql-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lower-sql-plan.d.ts","sourceRoot":"","sources":["../../src/lower-sql-plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAC9B,OAAO,EAAE,cAAc,EACvB,SAAS,EAAE,YAAY,CAAC,GAAG,CAAC,GAC3B,aAAa,CAAC,GAAG,CAAC,CAcpB"}

package/dist/src/sql-context.d.ts

@@ -0,0 +1,65 @@
+import type { RuntimeAdapterDescriptor, RuntimeAdapterInstance, RuntimeExtensionDescriptor, RuntimeExtensionInstance, RuntimeTargetDescriptor } from '@prisma-next/core-execution-plane/types';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { SqlOperationSignature } from '@prisma-next/sql-operations';
+import type { Adapter, CodecRegistry, LoweredStatement, QueryAst } from '@prisma-next/sql-relational-core/ast';
+import type { QueryLaneContext } from '@prisma-next/sql-relational-core/query-lane-context';
+/**
+ * SQL runtime extension instance.
+ * Extends the framework RuntimeExtensionInstance with SQL-specific hooks
+ * for contributing codecs and operations to the runtime context.
+ *
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface SqlRuntimeExtensionInstance<TTargetId extends string> extends RuntimeExtensionInstance<'sql', TTargetId> {
+    /** Returns codecs to register in the runtime context. */
+    codecs?(): CodecRegistry;
+    /** Returns operations to register in the runtime context. */
+    operations?(): ReadonlyArray<SqlOperationSignature>;
+}
+/**
+ * SQL runtime extension descriptor.
+ * Extends the framework RuntimeExtensionDescriptor with SQL-specific instance type.
+ *
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface SqlRuntimeExtensionDescriptor<TTargetId extends string> extends RuntimeExtensionDescriptor<'sql', TTargetId, SqlRuntimeExtensionInstance<TTargetId>> {
+    create(): SqlRuntimeExtensionInstance<TTargetId>;
+}
+/**
+ * SQL runtime adapter instance interface.
+ * Combines RuntimeAdapterInstance identity with SQL Adapter behavior.
+ * The instance IS an Adapter (via intersection), not HAS an adapter property.
+ *
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export type SqlRuntimeAdapterInstance<TTargetId extends string = string> = RuntimeAdapterInstance<'sql', TTargetId> & Adapter<QueryAst, SqlContract<SqlStorage>, LoweredStatement>;
+export interface RuntimeContext<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>> extends QueryLaneContext<TContract> {
+    readonly adapter: Adapter<QueryAst, TContract, LoweredStatement> | Adapter<QueryAst, SqlContract<SqlStorage>, LoweredStatement>;
+}
+/**
+ * Descriptor-first options for creating a SQL runtime context.
+ * Takes the same framework composition as control-plane: target, adapter, extensionPacks.
+ *
+ * @template TContract - The SQL contract type
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface CreateRuntimeContextOptions<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>, TTargetId extends string = string> {
+    readonly contract: TContract;
+    readonly target: RuntimeTargetDescriptor<'sql', TTargetId>;
+    readonly adapter: RuntimeAdapterDescriptor<'sql', TTargetId, SqlRuntimeAdapterInstance<TTargetId>>;
+    readonly extensionPacks?: ReadonlyArray<SqlRuntimeExtensionDescriptor<TTargetId>>;
+}
+/**
+ * Creates a SQL runtime context from descriptor-first composition.
+ *
+ * The context includes:
+ * - The validated contract
+ * - The adapter instance (created from descriptor)
+ * - Codec registry (populated from adapter + extension instances)
+ * - Operation registry (populated from extension instances)
+ *
+ * @param options - Descriptor-first composition options
+ * @returns RuntimeContext with registries wired from all components
+ */
+export declare function createRuntimeContext<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>, TTargetId extends string = string>(options: CreateRuntimeContextOptions<TContract, TTargetId>): RuntimeContext<TContract>;
+//# sourceMappingURL=sql-context.d.ts.map

package/dist/src/sql-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-context.d.ts","sourceRoot":"","sources":["../../src/sql-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EACV,OAAO,EACP,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACT,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qDAAqD,CAAC;AAM5F;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B,CAAC,SAAS,SAAS,MAAM,CACnE,SAAQ,wBAAwB,CAAC,KAAK,EAAE,SAAS,CAAC;IAClD,yDAAyD;IACzD,MAAM,CAAC,IAAI,aAAa,CAAC;IACzB,6DAA6D;IAC7D,UAAU,CAAC,IAAI,aAAa,CAAC,qBAAqB,CAAC,CAAC;CACrD;AAED;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B,CAAC,SAAS,SAAS,MAAM,CACrE,SAAQ,0BAA0B,CAAC,KAAK,EAAE,SAAS,EAAE,2BAA2B,CAAC,SAAS,CAAC,CAAC;IAC5F,MAAM,IAAI,2BAA2B,CAAC,SAAS,CAAC,CAAC;CAClD;AAMD;;;;;;GAMG;AACH,MAAM,MAAM,yBAAyB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI,sBAAsB,CAC/F,KAAK,EACL,SAAS,CACV,GACC,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAAC;AAM/D,MAAM,WAAW,cAAc,CAAC,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,CACjG,SAAQ,gBAAgB,CAAC,SAAS,CAAC;IACnC,QAAQ,CAAC,OAAO,EACZ,OAAO,CAAC,QAAQ,EAAE,SAAS,EAAE,gBAAgB,CAAC,GAC9C,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAAC;CAClE;AAED;;;;;;GAMG;AACH,MAAM,WAAW,2BAA2B,CAC1C,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,EACnE,SAAS,SAAS,MAAM,GAAG,MAAM;IAEjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CACxC,KAAK,EACL,SAAS,EACT,yBAAyB,CAAC,SAAS,CAAC,CACrC,CAAC;IACF,QAAQ,CAAC,cAAc,CAAC,EAAE,aAAa,CAAC,6BAA6B,CAAC,SAAS,CAAC,CAAC,CAAC;CACnF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,EACnE,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,OAAO,EAAE,2BAA2B,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,cAAc,CAAC,SAAS,CAAC,CA0CvF"}

package/dist/src/sql-family-adapter.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+import type { MarkerReader, RuntimeFamilyAdapter } from '@prisma-next/runtime-executor';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+export declare class SqlFamilyAdapter<TContract extends SqlContract<SqlStorage>> implements RuntimeFamilyAdapter<TContract> {
+    readonly contract: TContract;
+    readonly markerReader: MarkerReader;
+    constructor(contract: TContract);
+    validatePlan(plan: ExecutionPlan, contract: TContract): void;
+}
+//# sourceMappingURL=sql-family-adapter.d.ts.map

package/dist/src/sql-family-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-family-adapter.d.ts","sourceRoot":"","sources":["../../src/sql-family-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EACV,YAAY,EAEZ,oBAAoB,EACrB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAS/E,qBAAa,gBAAgB,CAAC,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,CACrE,YAAW,oBAAoB,CAAC,SAAS,CAAC;IAE1C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC;gBAExB,QAAQ,EAAE,SAAS;IAK/B,YAAY,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,GAAG,IAAI;CAe7D"}

package/dist/src/sql-marker.d.ts

@@ -0,0 +1,22 @@
+import type { MarkerStatement } from '@prisma-next/runtime-executor';
+export interface SqlStatement {
+    readonly sql: string;
+    readonly params: readonly unknown[];
+}
+export interface WriteMarkerInput {
+    readonly coreHash: string;
+    readonly profileHash: string;
+    readonly contractJson?: unknown;
+    readonly canonicalVersion?: number;
+    readonly appTag?: string;
+    readonly meta?: Record<string, unknown>;
+}
+export declare const ensureSchemaStatement: SqlStatement;
+export declare const ensureTableStatement: SqlStatement;
+export declare function readContractMarker(): MarkerStatement;
+export interface WriteContractMarkerStatements {
+    readonly insert: SqlStatement;
+    readonly update: SqlStatement;
+}
+export declare function writeContractMarker(input: WriteMarkerInput): WriteContractMarkerStatements;
+//# sourceMappingURL=sql-marker.d.ts.map

package/dist/src/sql-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-marker.d.ts","sourceRoot":"","sources":["../../src/sql-marker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;CACrC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,eAAO,MAAM,qBAAqB,EAAE,YAGnC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,YAYlC,CAAC;AAEF,wBAAgB,kBAAkB,IAAI,eAAe,CAcpD;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,6BAA6B,CAgD1F"}

package/dist/src/sql-runtime.d.ts

@@ -0,0 +1,25 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+import type { OperationRegistry } from '@prisma-next/operations';
+import type { Log, Plugin, RuntimeTelemetryEvent, RuntimeVerifyOptions, TelemetryOutcome } from '@prisma-next/runtime-executor';
+import { AsyncIterableResult } from '@prisma-next/runtime-executor';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { Adapter, LoweredStatement, SelectAst, SqlDriver } from '@prisma-next/sql-relational-core/ast';
+import type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
+import type { RuntimeContext } from './sql-context';
+export interface RuntimeOptions<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>> {
+    readonly driver: SqlDriver;
+    readonly verify: RuntimeVerifyOptions;
+    readonly context: RuntimeContext<TContract>;
+    readonly plugins?: readonly Plugin<TContract, Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>, SqlDriver>[];
+    readonly mode?: 'strict' | 'permissive';
+    readonly log?: Log;
+}
+export interface Runtime {
+    execute<Row = Record<string, unknown>>(plan: ExecutionPlan<Row> | SqlQueryPlan<Row>): AsyncIterableResult<Row>;
+    telemetry(): RuntimeTelemetryEvent | null;
+    close(): Promise<void>;
+    operations(): OperationRegistry;
+}
+export type { RuntimeTelemetryEvent, RuntimeVerifyOptions, TelemetryOutcome };
+export declare function createRuntime<TContract extends SqlContract<SqlStorage>>(options: RuntimeOptions<TContract>): Runtime;
+//# sourceMappingURL=sql-runtime.d.ts.map

package/dist/src/sql-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-runtime.d.ts","sourceRoot":"","sources":["../../src/sql-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EACV,GAAG,EACH,MAAM,EAGN,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAqB,MAAM,+BAA+B,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EACV,OAAO,EAEP,gBAAgB,EAChB,SAAS,EACT,SAAS,EACV,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAK1E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,WAAW,cAAc,CAC7B,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC;IAEnE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,CAChC,SAAS,EACT,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,EAC7D,SAAS,CACV,EAAE,CAAC;IACJ,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,IAAI,EAAE,aAAa,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,GAC3C,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAC5B,SAAS,IAAI,qBAAqB,GAAG,IAAI,CAAC;IAC1C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,UAAU,IAAI,iBAAiB,CAAC;CACjC;AAED,YAAY,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,CAAC;AA6G9E,wBAAgB,aAAa,CAAC,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,EACrE,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC,GACjC,OAAO,CAET"}

package/dist/test/utils.d.ts

@@ -1,41 +1,36 @@
-import { ExecutionPlan, ResultType } from '@prisma-next/contract/types';
-import { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
-import { Adapter, SelectAst, LoweredStatement } from '@prisma-next/sql-relational-core/ast';
-import { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
-import { Client } from 'pg';
-import { i as createRuntime, d as SqlStatement, a as SqlRuntimeExtensionDescriptor, R as RuntimeContext } from '../sql-runtime-DgEbg2OP.js';
-export { DevDatabase, collectAsync, createDevDatabase, teardownTestDatabase, withClient } from '@prisma-next/test-utils';
-import '@prisma-next/runtime-executor';
-import '@prisma-next/operations';
-import '@prisma-next/core-execution-plane/types';
-import '@prisma-next/sql-operations';
-import '@prisma-next/sql-relational-core/query-lane-context';
-
+import type { ExecutionPlan, ResultType } from '@prisma-next/contract/types';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { Adapter, LoweredStatement, SelectAst } from '@prisma-next/sql-relational-core/ast';
+import type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
+import type { Client } from 'pg';
+import type { SqlStatement } from '../src/exports';
+import { type createRuntime } from '../src/exports';
+import type { RuntimeContext, SqlRuntimeExtensionDescriptor } from '../src/sql-context';
 /**
  * Executes a plan and collects all results into an array.
  * This helper DRYs up the common pattern of executing plans in tests.
  * The return type is inferred from the plan's type parameter.
  */
-declare function executePlanAndCollect<P extends ExecutionPlan<ResultType<P>> | SqlQueryPlan<ResultType<P>>>(runtime: ReturnType<typeof createRuntime>, plan: P): Promise<ResultType<P>[]>;
+export declare function executePlanAndCollect<P extends ExecutionPlan<ResultType<P>> | SqlQueryPlan<ResultType<P>>>(runtime: ReturnType<typeof createRuntime>, plan: P): Promise<ResultType<P>[]>;
 /**
  * Drains a plan execution, consuming all results without collecting them.
  * Useful for testing side effects without memory overhead.
  */
-declare function drainPlanExecution(runtime: ReturnType<typeof createRuntime>, plan: ExecutionPlan | SqlQueryPlan<unknown>): Promise<void>;
+export declare function drainPlanExecution(runtime: ReturnType<typeof createRuntime>, plan: ExecutionPlan | SqlQueryPlan<unknown>): Promise<void>;
 /**
  * Executes a SQL statement on a database client.
  */
-declare function executeStatement(client: Client, statement: SqlStatement): Promise<void>;
+export declare function executeStatement(client: Client, statement: SqlStatement): Promise<void>;
 /**
  * Sets up database schema and data, then writes the contract marker.
  * This helper DRYs up the common pattern of database setup in tests.
  */
-declare function setupTestDatabase(client: Client, contract: SqlContract<SqlStorage>, setupFn: (client: Client) => Promise<void>): Promise<void>;
+export declare function setupTestDatabase(client: Client, contract: SqlContract<SqlStorage>, setupFn: (client: Client) => Promise<void>): Promise<void>;
 /**
  * Writes a contract marker to the database.
  * This helper DRYs up the common pattern of writing contract markers in tests.
  */
-declare function writeTestContractMarker(client: Client, contract: SqlContract<SqlStorage>): Promise<void>;
+export declare function writeTestContractMarker(client: Client, contract: SqlContract<SqlStorage>): Promise<void>;
 /**
  * Creates a runtime context with standard test configuration.
  * This helper DRYs up the common pattern of context creation in tests.
@@ -43,7 +38,7 @@ declare function writeTestContractMarker(client: Client, contract: SqlContract<S
  * Accepts a raw adapter and optional extension descriptors, wrapping the
  * adapter in a descriptor internally for descriptor-first context creation.
  */
-declare function createTestContext<TContract extends SqlContract<SqlStorage>>(contract: TContract, adapter: Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>, options?: {
+export declare function createTestContext<TContract extends SqlContract<SqlStorage>>(contract: TContract, adapter: Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>, options?: {
     extensionPacks?: ReadonlyArray<SqlRuntimeExtensionDescriptor<'postgres'>>;
 }): RuntimeContext<TContract>;
 /**
@@ -53,12 +48,12 @@ declare function createTestContext<TContract extends SqlContract<SqlStorage>>(co
  * The stub adapter includes simple codecs for common test types (pg/int4@1, pg/text@1, pg/timestamptz@1)
  * to enable type inference in tests without requiring the postgres adapter package.
  */
-declare function createStubAdapter(): Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>;
+export declare function createStubAdapter(): Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>;
 /**
  * Creates a valid test contract without using validateContract.
  * Ensures mappings are present and returns the contract with proper typing.
  * This helper allows tests to create contracts without depending on sql-query.
  */
-declare function createTestContract<T extends SqlContract<SqlStorage>>(contract: T): T;
-
-export { createStubAdapter, createTestContext, createTestContract, drainPlanExecution, executePlanAndCollect, executeStatement, setupTestDatabase, writeTestContractMarker };
+export declare function createTestContract<T extends SqlContract<SqlStorage>>(contract: T): T;
+export { collectAsync, createDevDatabase, type DevDatabase, teardownTestDatabase, withClient, } from '@prisma-next/test-utils';
+//# sourceMappingURL=utils.d.ts.map

package/dist/test/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../test/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEjG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAE1E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;AACjC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EACL,KAAK,aAAa,EAKnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,cAAc,EAEd,6BAA6B,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,CAAC,SAAS,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EACpE,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAG9E;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,EACzC,IAAI,EAAE,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,GAC1C,OAAO,CAAC,IAAI,CAAC,CAEf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAO7F;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,EACjC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAQf;AA4DD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,EACzE,QAAQ,EAAE,SAAS,EACnB,OAAO,EAAE,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,EACtE,OAAO,CAAC,EAAE;IACR,cAAc,CAAC,EAAE,aAAa,CAAC,6BAA6B,CAAC,UAAU,CAAC,CAAC,CAAC;CAC3E,GACA,cAAc,CAAC,SAAS,CAAC,CAO3B;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,CAmDjG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CASpF;AAGD,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,KAAK,WAAW,EAChB,oBAAoB,EACpB,UAAU,GACX,MAAM,yBAAyB,CAAC"}

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@prisma-next/sql-runtime",
-  "version": "0.3.0-pr.71.6",
+  "version": "0.3.0-pr.71.8",
   "type": "module",
   "sideEffects": false,
   "description": "SQL runtime implementation for Prisma Next",
   "dependencies": {
-    "@prisma-next/contract": "0.3.0-pr.71.6",
-    "@prisma-next/core-execution-plane": "0.3.0-pr.71.6",
-    "@prisma-next/operations": "0.3.0-pr.71.6",
-    "@prisma-next/runtime-executor": "0.3.0-pr.71.6",
-    "@prisma-next/sql-contract": "0.3.0-pr.71.6",
-    "@prisma-next/sql-operations": "0.3.0-pr.71.6",
-    "@prisma-next/sql-relational-core": "0.3.0-pr.71.6"
+    "@prisma-next/contract": "0.3.0-pr.71.8",
+    "@prisma-next/core-execution-plane": "0.3.0-pr.71.8",
+    "@prisma-next/operations": "0.3.0-pr.71.8",
+    "@prisma-next/runtime-executor": "0.3.0-pr.71.8",
+    "@prisma-next/sql-contract": "0.3.0-pr.71.8",
+    "@prisma-next/sql-operations": "0.3.0-pr.71.8",
+    "@prisma-next/sql-relational-core": "0.3.0-pr.71.8"
   },
   "devDependencies": {
     "@types/pg": "8.16.0",
@@ -23,11 +23,13 @@
     "@prisma-next/test-utils": "0.0.1"
   },
   "files": [
-    "dist"
+    "dist",
+    "src",
+    "test"
   ],
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/index.js"
     },
     "./test/utils": {
@@ -36,7 +38,7 @@
     }
   },
   "scripts": {
-    "build": "tsup --config tsup.config.ts",
+    "build": "tsup --config tsup.config.ts && tsc --project tsconfig.build.json",
     "test": "vitest run --passWithNoTests",
     "test:coverage": "vitest run --coverage --passWithNoTests",
     "typecheck": "tsc --project tsconfig.json --noEmit",

package/src/codecs/decoding.ts

@@ -0,0 +1,140 @@
+import type { ExecutionPlan } from '@prisma-next/contract/types';
+import type { Codec, CodecRegistry } from '@prisma-next/sql-relational-core/ast';
+
+function resolveRowCodec(
+  alias: string,
+  plan: ExecutionPlan,
+  registry: CodecRegistry,
+): Codec | null {
+  const planCodecId = plan.meta.annotations?.codecs?.[alias] as string | undefined;
+  if (planCodecId) {
+    const codec = registry.get(planCodecId);
+    if (codec) {
+      return codec;
+    }
+  }
+
+  if (plan.meta.projectionTypes) {
+    const typeId = plan.meta.projectionTypes[alias];
+    if (typeId) {
+      const codec = registry.get(typeId);
+      if (codec) {
+        return codec;
+      }
+    }
+  }
+
+  return null;
+}
+
+export function decodeRow(
+  row: Record<string, unknown>,
+  plan: ExecutionPlan,
+  registry: CodecRegistry,
+): Record<string, unknown> {
+  const decoded: Record<string, unknown> = {};
+
+  let aliases: readonly string[];
+  const projection = plan.meta.projection;
+  if (projection && !Array.isArray(projection)) {
+    aliases = Object.keys(projection);
+  } else if (projection && Array.isArray(projection)) {
+    aliases = projection;
+  } else {
+    aliases = Object.keys(row);
+  }
+
+  for (const alias of aliases) {
+    const wireValue = row[alias];
+
+    const projection = plan.meta.projection;
+    const projectionValue =
+      projection && typeof projection === 'object' && !Array.isArray(projection)
+        ? (projection as Record<string, string>)[alias]
+        : undefined;
+
+    if (typeof projectionValue === 'string' && projectionValue.startsWith('include:')) {
+      if (wireValue === null || wireValue === undefined) {
+        decoded[alias] = [];
+        continue;
+      }
+
+      try {
+        let parsed: unknown;
+        if (typeof wireValue === 'string') {
+          parsed = JSON.parse(wireValue);
+        } else if (Array.isArray(wireValue)) {
+          parsed = wireValue;
+        } else {
+          parsed = JSON.parse(String(wireValue));
+        }
+
+        if (!Array.isArray(parsed)) {
+          throw new Error(`Expected array for include alias '${alias}', got ${typeof parsed}`);
+        }
+
+        decoded[alias] = parsed;
+      } catch (error) {
+        const decodeError = new Error(
+          `Failed to parse JSON array for include alias '${alias}': ${error instanceof Error ? error.message : String(error)}`,
+        ) as Error & {
+          code: string;
+          category: string;
+          severity: string;
+          details?: Record<string, unknown>;
+        };
+        decodeError.code = 'RUNTIME.DECODE_FAILED';
+        decodeError.category = 'RUNTIME';
+        decodeError.severity = 'error';
+        decodeError.details = {
+          alias,
+          wirePreview:
+            typeof wireValue === 'string' && wireValue.length > 100
+              ? `${wireValue.substring(0, 100)}...`
+              : String(wireValue).substring(0, 100),
+        };
+        throw decodeError;
+      }
+      continue;
+    }
+
+    if (wireValue === null || wireValue === undefined) {
+      decoded[alias] = wireValue;
+      continue;
+    }
+
+    const codec = resolveRowCodec(alias, plan, registry);
+
+    if (!codec) {
+      decoded[alias] = wireValue;
+      continue;
+    }
+
+    try {
+      decoded[alias] = codec.decode(wireValue);
+    } catch (error) {
+      const decodeError = new Error(
+        `Failed to decode row alias '${alias}' with codec '${codec.id}': ${error instanceof Error ? error.message : String(error)}`,
+      ) as Error & {
+        code: string;
+        category: string;
+        severity: string;
+        details?: Record<string, unknown>;
+      };
+      decodeError.code = 'RUNTIME.DECODE_FAILED';
+      decodeError.category = 'RUNTIME';
+      decodeError.severity = 'error';
+      decodeError.details = {
+        alias,
+        codec: codec.id,
+        wirePreview:
+          typeof wireValue === 'string' && wireValue.length > 100
+            ? `${wireValue.substring(0, 100)}...`
+            : String(wireValue).substring(0, 100),
+      };
+      throw decodeError;
+    }
+  }
+
+  return decoded;
+}

package/src/codecs/encoding.ts

@@ -0,0 +1,76 @@
+import type { ExecutionPlan, ParamDescriptor } from '@prisma-next/contract/types';
+import type { Codec, CodecRegistry } from '@prisma-next/sql-relational-core/ast';
+
+function resolveParamCodec(
+  paramDescriptor: ParamDescriptor,
+  plan: ExecutionPlan,
+  registry: CodecRegistry,
+): Codec | null {
+  const paramName = paramDescriptor.name ?? `param_${paramDescriptor.index ?? 0}`;
+
+  const planCodecId = plan.meta.annotations?.codecs?.[paramName] as string | undefined;
+  if (planCodecId) {
+    const codec = registry.get(planCodecId);
+    if (codec) {
+      return codec;
+    }
+  }
+
+  if (paramDescriptor.codecId) {
+    const codec = registry.get(paramDescriptor.codecId);
+    if (codec) {
+      return codec;
+    }
+  }
+
+  return null;
+}
+
+export function encodeParam(
+  value: unknown,
+  paramDescriptor: ParamDescriptor,
+  plan: ExecutionPlan,
+  registry: CodecRegistry,
+): unknown {
+  if (value === null || value === undefined) {
+    return null;
+  }
+
+  const codec = resolveParamCodec(paramDescriptor, plan, registry);
+  if (!codec) {
+    return value;
+  }
+
+  if (codec.encode) {
+    try {
+      return codec.encode(value);
+    } catch (error) {
+      throw new Error(
+        `Failed to encode parameter ${paramDescriptor.name ?? paramDescriptor.index}: ${error instanceof Error ? error.message : String(error)}`,
+      );
+    }
+  }
+
+  return value;
+}
+
+export function encodeParams(plan: ExecutionPlan, registry: CodecRegistry): readonly unknown[] {
+  if (plan.params.length === 0) {
+    return plan.params;
+  }
+
+  const encoded: unknown[] = [];
+
+  for (let i = 0; i < plan.params.length; i++) {
+    const paramValue = plan.params[i];
+    const paramDescriptor = plan.meta.paramDescriptors[i];
+
+    if (paramDescriptor) {
+      encoded.push(encodeParam(paramValue, paramDescriptor, plan, registry));
+    } else {
+      encoded.push(paramValue);
+    }
+  }
+
+  return Object.freeze(encoded);
+}