@prisma-next/sql-runtime 0.5.0-dev.8 → 0.5.0-dev.81

package/dist/{index-yb51L_1h.d.mts → index-CFbuVnYJ.d.mts}

@@ -1,17 +1,20 @@
-import { AfterExecuteResult, RuntimeMiddleware, RuntimeMiddlewareContext } from "@prisma-next/framework-components/runtime";
-import { Adapter, AnyQueryAst, CodecParamsDescriptor, CodecRegistry, LoweredStatement, SqlDriver } from "@prisma-next/sql-relational-core/ast";
-import { AfterExecuteResult as AfterExecuteResult$1, AsyncIterableResult, Log, Log as Log$1, MarkerStatement, Middleware, MiddlewareContext, RuntimeTelemetryEvent, RuntimeVerifyOptions, TelemetryOutcome } from "@prisma-next/runtime-executor";
+import { AfterExecuteResult, AfterExecuteResult as AfterExecuteResult$1, ExecutionPlan, RuntimeLog, RuntimeLog as Log, RuntimeMiddleware, RuntimeMiddlewareContext } from "@prisma-next/framework-components/runtime";
+import { Adapter, AnyQueryAst, LoweredStatement, MarkerStatement, MarkerStatement as MarkerStatement$1, SqlDriver } from "@prisma-next/sql-relational-core/ast";
 import { ExecutionStack, ExecutionStackInstance, RuntimeAdapterDescriptor, RuntimeAdapterInstance, RuntimeDriverDescriptor, RuntimeDriverInstance, RuntimeExtensionDescriptor, RuntimeExtensionInstance, RuntimeTargetDescriptor, RuntimeTargetInstance } from "@prisma-next/framework-components/execution";
 import { SqlOperationDescriptor } from "@prisma-next/sql-operations";
-import { Contract, ExecutionPlan, PlanMeta } from "@prisma-next/contract/types";
+import { APP_SPACE_ID } from "@prisma-next/framework-components/control";
+import { SqlParamRefMutator } from "@prisma-next/sql-relational-core/middleware";
+import { Contract, ContractMarkerRecord, PlanMeta } from "@prisma-next/contract/types";
+import { AnyCodecDescriptor, CodecDescriptor } from "@prisma-next/framework-components/codec";
 import { SqlStorage } from "@prisma-next/sql-contract/types";
-import { SqlQueryPlan } from "@prisma-next/sql-relational-core/plan";
-import { ExecutionContext, TypeHelperRegistry } from "@prisma-next/sql-relational-core/query-lane-context";
+import { CodecDescriptorRegistry, ExecutionContext, TypeHelperRegistry } from "@prisma-next/sql-relational-core/query-lane-context";
+import { SqlExecutionPlan, SqlQueryPlan } from "@prisma-next/sql-relational-core/plan";
+import { RuntimeScope } from "@prisma-next/sql-relational-core/types";
 
 //#region src/codecs/validation.d.ts
 declare function extractCodecIds(contract: Contract<SqlStorage>): Set<string>;
-declare function validateContractCodecMappings(registry: CodecRegistry, contract: Contract<SqlStorage>): void;
-declare function validateCodecRegistryCompleteness(registry: CodecRegistry, contract: Contract<SqlStorage>): void;
+declare function validateContractCodecMappings(registry: CodecDescriptorRegistry, contract: Contract<SqlStorage>): void;
+declare function validateCodecRegistryCompleteness(registry: CodecDescriptorRegistry, contract: Contract<SqlStorage>): void;
 //#endregion
 //#region src/lower-sql-plan.d.ts
 /**
@@ -22,7 +25,10 @@ declare function validateCodecRegistryCompleteness(registry: CodecRegistry, cont
  * @param queryPlan - SQL query plan from a lane (contains AST, params, meta, but no SQL)
  * @returns Fully executable Plan with SQL string
  */
-declare function lowerSqlPlan<Row>(adapter: Adapter<AnyQueryAst, Contract<SqlStorage>, LoweredStatement>, contract: Contract<SqlStorage>, queryPlan: SqlQueryPlan<Row>): ExecutionPlan<Row>;
+declare function lowerSqlPlan<Row>(adapter: Adapter<AnyQueryAst, Contract<SqlStorage>, LoweredStatement>, contract: Contract<SqlStorage>, queryPlan: SqlQueryPlan<Row>): SqlExecutionPlan<Row>;
+//#endregion
+//#region src/marker.d.ts
+declare function parseContractMarkerRow(row: unknown): ContractMarkerRecord;
 //#endregion
 //#region src/middleware/sql-middleware.d.ts
 interface SqlMiddlewareContext extends RuntimeMiddlewareContext {
@@ -36,7 +42,7 @@ interface DraftPlan {
   readonly ast: AnyQueryAst;
   readonly meta: PlanMeta;
 }
-interface SqlMiddleware extends RuntimeMiddleware {
+interface SqlMiddleware<TCodecMap extends Record<string, unknown> = Record<string, unknown>> extends RuntimeMiddleware<SqlExecutionPlan, SqlParamRefMutator<TCodecMap>> {
   readonly familyId?: 'sql';
   /**
    * Rewrite the query AST before it is lowered to SQL. Middlewares run in
@@ -57,9 +63,22 @@ interface SqlMiddleware extends RuntimeMiddleware {
    * See `docs/architecture docs/subsystems/4. Runtime & Middleware Framework.md`.
    */
   beforeCompile?(draft: DraftPlan, ctx: SqlMiddlewareContext): Promise<DraftPlan | undefined>;
-  beforeExecute?(plan: ExecutionPlan, ctx: SqlMiddlewareContext): Promise<void>;
-  onRow?(row: Record<string, unknown>, plan: ExecutionPlan, ctx: SqlMiddlewareContext): Promise<void>;
-  afterExecute?(plan: ExecutionPlan, result: AfterExecuteResult, ctx: SqlMiddlewareContext): Promise<void>;
+  /**
+   * Mutate `ParamRef.value` slots before encode runs. The third `params`
+   * argument is a {@link SqlParamRefMutator} scoped to value slots only —
+   * SQL strings, projections, and `ParamRef` membership are not mutable.
+   * Existing `(plan)` and `(plan, ctx)` middleware bodies that ignore the
+   * additional argument continue to compile and run unchanged.
+   *
+   * `ctx.signal` carries the per-query `AbortSignal` (ADR 207); middleware
+   * that wraps a network SDK forwards `ctx.signal` to that SDK.
+   * Cooperative cancellation: a body that ignores the signal still
+   * surfaces `RUNTIME.ABORTED { phase: 'beforeExecute' }` promptly via
+   * the runtime's race against the signal.
+   */
+  beforeExecute?(plan: SqlExecutionPlan, ctx: SqlMiddlewareContext, params?: SqlParamRefMutator<TCodecMap>): void | Promise<void>;
+  onRow?(row: Record<string, unknown>, plan: SqlExecutionPlan, ctx: SqlMiddlewareContext): Promise<void>;
+  afterExecute?(plan: SqlExecutionPlan, result: AfterExecuteResult, ctx: SqlMiddlewareContext): Promise<void>;
 }
 //#endregion
 //#region src/middleware/budgets.d.ts
@@ -103,25 +122,76 @@ interface LintsOptions {
  */
 declare function lints(options?: LintsOptions): SqlMiddleware;
 //#endregion
+//#region src/runtime-spi.d.ts
+/**
+ * Reader of the SQL contract marker. SQL runtimes verify the database's
+ * `prisma_contract.marker` row against the runtime's contract by issuing
+ * this statement before executing user queries (when `verify` is enabled).
+ * Each adapter is responsible for any target-specific row decoding before
+ * delegating to the shared row schema.
+ */
+interface MarkerReader {
+  readMarkerStatement(): MarkerStatement;
+  parseMarkerRow(row: unknown): ContractMarkerRecord;
+}
+/**
+ * SQL family adapter SPI consumed by `SqlRuntime`. Encapsulates the
+ * runtime contract, marker reader, and plan validation logic so the
+ * runtime can be unit-tested without a concrete SQL adapter profile.
+ *
+ * Implemented by `SqlFamilyAdapter` for production and by mock classes
+ * in tests.
+ */
+interface RuntimeFamilyAdapter<TContract = unknown> {
+  readonly contract: TContract;
+  readonly markerReader: MarkerReader;
+  validatePlan(plan: ExecutionPlan, contract: TContract): void;
+}
+interface RuntimeVerifyOptions {
+  readonly mode: 'onFirstUse' | 'startup' | 'always';
+  readonly requireMarker: boolean;
+}
+type TelemetryOutcome = 'success' | 'runtime-error';
+interface RuntimeTelemetryEvent {
+  readonly lane: string;
+  readonly target: string;
+  readonly fingerprint: string;
+  readonly outcome: TelemetryOutcome;
+  readonly durationMs?: number;
+}
+//#endregion
 //#region src/sql-context.d.ts
 /**
  * Runtime parameterized codec descriptor.
- * Provides validation schema and optional init hook for codecs that support type parameters.
- * Used at runtime to validate typeParams and create type helpers.
  *
- * This is a type alias for `CodecParamsDescriptor` from the AST layer,
- * which is the shared definition used by both adapter and runtime.
+ * The unified `CodecDescriptor<P>` shape applied to parameterized codecs — `paramsSchema: StandardSchemaV1<P>` for JSON-boundary validation, `factory: (P) => (CodecInstanceContext) => Codec` for the curried higher-order codec. The factory is called once per `storage.types` instance (or once per inline-`typeParams` column); per-instance state lives in the closure.
+ *
+ * Codec-registry-unification spec § Decision.
+ */
+type RuntimeParameterizedCodecDescriptor<P = Record<string, unknown>> = CodecDescriptor<P>;
+/**
+ * Contributor protocol for SQL components (target, adapter, extension pack). The unified `codecs:` slot returns the full {@link CodecDescriptor} list — non-parameterized and parameterized descriptors live side-by-side in the same array. The framework dispatches every codec id through the unified descriptor map without branching on parameterization.
  */
-type RuntimeParameterizedCodecDescriptor<TParams = Record<string, unknown>, THelper = unknown> = CodecParamsDescriptor<TParams, THelper>;
 interface SqlStaticContributions {
-  readonly codecs: () => CodecRegistry;
-  readonly parameterizedCodecs: () => ReadonlyArray<RuntimeParameterizedCodecDescriptor<any, any>>;
+  readonly codecs: () => ReadonlyArray<AnyCodecDescriptor>;
   readonly queryOperations?: () => ReadonlyArray<SqlOperationDescriptor>;
   readonly mutationDefaultGenerators?: () => ReadonlyArray<RuntimeMutationDefaultGenerator>;
 }
+/**
+ * Scope across which a generator's value is constant.
+ *
+ * - `'field'` — one value per defaulting site (one column, one row). Cache strategy: no cache; call per defaulting site. Right for per-row identifiers (UUIDs, CUIDs, ULIDs, nanoid, ksuid).
+ * - `'row'` — one value across all defaulting sites of one row of one operation. Cache strategy: per-call cache keyed by `generatorId`. Right for correlation ids stamped into multiple columns of one row.
+ * - `'query'` — one value across all rows and columns of one ORM operation. Cache strategy: caller-provided cache keyed by `generatorId`. Right for `timestampNow` (a single timestamp per bulk insert/update).
+ */
+type GeneratorStability = 'field' | 'row' | 'query';
 interface RuntimeMutationDefaultGenerator {
   readonly id: string;
   readonly generate: (params?: Record<string, unknown>) => unknown;
+  /**
+   * Scope across which the generator's value is constant. The framework derives the cache strategy from this declaration; generator authors never need to know about cache keys. See `GeneratorStability` for the per-value semantics.
+   */
+  readonly stability: GeneratorStability;
 }
 interface SqlRuntimeTargetDescriptor<TTargetId extends string = string, TTargetInstance extends RuntimeTargetInstance<'sql', TTargetId> = RuntimeTargetInstance<'sql', TTargetId>> extends RuntimeTargetDescriptor<'sql', TTargetId, TTargetInstance>, SqlStaticContributions {}
 interface SqlRuntimeAdapterDescriptor<TTargetId extends string = string, TAdapterInstance extends RuntimeAdapterInstance<'sql', TTargetId> = SqlRuntimeAdapterInstance<TTargetId>> extends RuntimeAdapterDescriptor<'sql', TTargetId, TAdapterInstance>, SqlStaticContributions {}
@@ -142,10 +212,7 @@ type SqlExecutionStackWithDriver<TTargetId extends string = string> = Omit<Execu
 interface SqlRuntimeExtensionInstance<TTargetId extends string> extends RuntimeExtensionInstance<'sql', TTargetId> {}
 type SqlRuntimeAdapterInstance<TTargetId extends string = string> = RuntimeAdapterInstance<'sql', TTargetId> & Adapter<AnyQueryAst, Contract<SqlStorage>, LoweredStatement>;
 /**
- * NOTE: Binding type is intentionally erased to unknown at this shared runtime layer.
- * Target clients (for example `postgres()`) validate and construct the concrete binding
- * before calling `driver.connect(binding)`, which keeps runtime behavior safe today.
- * A future follow-up can preserve TBinding through stack/context generics end-to-end.
+ * NOTE: Binding type is intentionally erased to unknown at this shared runtime layer. Target clients (for example `postgres()`) validate and construct the concrete binding before calling `driver.connect(binding)`, which keeps runtime behavior safe today. A future follow-up can preserve TBinding through stack/context generics end-to-end.
  */
 type SqlRuntimeDriverInstance<TTargetId extends string = string> = RuntimeDriverInstance<'sql', TTargetId> & SqlDriver<unknown>;
 declare function createSqlExecutionStack<TTargetId extends string>(options: {
@@ -165,16 +232,45 @@ interface SqlStatement {
   readonly params: readonly unknown[];
 }
 interface WriteMarkerInput {
+  /**
+   * Logical space identifier for this marker row. Required at every
+   * call site so the type system surfaces every place that needs to
+   * thread the value (rather than letting an `?? APP_SPACE_ID`
+   * fall-through silently collapse multi-space markers onto the
+   * `'app'` row). App-plan callers pass {@link APP_SPACE_ID}
+   * (`'app'`); per-extension callers pass the extension's space id.
+   */
+  readonly space: string;
   readonly storageHash: string;
   readonly profileHash: string;
   readonly contractJson?: unknown;
   readonly canonicalVersion?: number;
   readonly appTag?: string;
   readonly meta?: Record<string, unknown>;
+  /**
+   * Applied-invariants set on the marker.
+   *
+   * - `undefined` → existing column left untouched. Sign and
+   *   verify-database paths use this; they don't accumulate invariants.
+   * - explicit value (including `[]`) → column overwritten with
+   *   exactly that value.
+   */
+  readonly invariants?: readonly string[];
 }
 declare const ensureSchemaStatement: SqlStatement;
+/**
+ * Schema for `prisma_contract.marker`. The `space text` primary key
+ * supports one row per loaded contract space (`'app'`,
+ * `'<extension-id>'`, …); brand-new databases create this shape
+ * directly. Pre-1.0 single-row markers (no `space` column) are not
+ * auto-migrated — the target-specific migration runner detects the
+ * legacy shape at boot and surfaces a structured `LEGACY_MARKER_SHAPE`
+ * failure pointing the operator at re-running `dbInit`.
+ *
+ * @see specs/framework-mechanism.spec.md § 2.
+ */
 declare const ensureTableStatement: SqlStatement;
-declare function readContractMarker(): MarkerStatement;
+declare function readContractMarker(space: string): MarkerStatement;
 interface WriteContractMarkerStatements {
   readonly insert: SqlStatement;
   readonly update: SqlStatement;
@@ -182,6 +278,7 @@ interface WriteContractMarkerStatements {
 declare function writeContractMarker(input: WriteMarkerInput): WriteContractMarkerStatements;
 //#endregion
 //#region src/sql-runtime.d.ts
+type Log$1 = RuntimeLog;
 interface CreateRuntimeOptions<TContract extends Contract<SqlStorage> = Contract<SqlStorage>, TTargetId extends string = string> {
   readonly stackInstance: ExecutionStackInstance<'sql', TTargetId, SqlRuntimeAdapterInstance<TTargetId>, RuntimeDriverInstance<'sql', TTargetId>, SqlRuntimeExtensionInstance<TTargetId>>;
   readonly context: ExecutionContext<TContract>;
@@ -189,7 +286,7 @@ interface CreateRuntimeOptions<TContract extends Contract<SqlStorage> = Contract
   readonly verify: RuntimeVerifyOptions;
   readonly middleware?: readonly SqlMiddleware[];
   readonly mode?: 'strict' | 'permissive';
-  readonly log?: Log;
+  readonly log?: Log$1;
 }
 interface Runtime extends RuntimeQueryable {
   connection(): Promise<RuntimeConnection>;
@@ -199,25 +296,15 @@ interface Runtime extends RuntimeQueryable {
 interface RuntimeConnection extends RuntimeQueryable {
   transaction(): Promise<RuntimeTransaction>;
   /**
-   * Returns the connection to the pool for reuse. Only call this when the
-   * connection is known to be in a clean state. If a transaction
-   * commit/rollback failed or the connection is otherwise suspect, call
-   * `destroy(reason)` instead.
+   * Returns the connection to the pool for reuse. Only call this when the connection is known to be in a clean state. If a transaction commit/rollback failed or the connection is otherwise suspect, call `destroy(reason)` instead.
    */
   release(): Promise<void>;
   /**
-   * Evicts the connection so it is never reused. Call this when the
-   * connection may be in an indeterminate state (e.g. a failed rollback
-   * leaving an open transaction, or a broken socket).
+   * Evicts the connection so it is never reused. Call this when the connection may be in an indeterminate state (e.g. a failed rollback leaving an open transaction, or a broken socket).
    *
-   * If teardown fails the error is propagated and the connection remains
-   * retryable, so the caller can decide whether to swallow the failure or
-   * retry cleanup. Calling destroy() or release() more than once after a
-   * successful teardown is caller error.
+   * If teardown fails the error is propagated and the connection remains retryable, so the caller can decide whether to swallow the failure or retry cleanup. Calling destroy() or release() more than once after a successful teardown is caller error.
    *
-   * `reason` is advisory context only. It may be surfaced to driver-level
-   * observability hooks (e.g. pg-pool's `'release'` event) but does not
-   * influence eviction behavior and is not rethrown.
+   * `reason` is advisory context only. It may be surfaced to driver-level observability hooks (e.g. pg-pool's `'release'` event) but does not influence eviction behavior and is not rethrown.
    */
   destroy(reason?: unknown): Promise<void>;
 }
@@ -225,14 +312,12 @@ interface RuntimeTransaction extends RuntimeQueryable {
   commit(): Promise<void>;
   rollback(): Promise<void>;
 }
-interface RuntimeQueryable {
-  execute<Row = Record<string, unknown>>(plan: ExecutionPlan<Row> | SqlQueryPlan<Row>): AsyncIterableResult<Row>;
-}
+interface RuntimeQueryable extends RuntimeScope {}
 interface TransactionContext extends RuntimeQueryable {
   readonly invalidated: boolean;
 }
 declare function withTransaction<R>(runtime: Runtime, fn: (tx: TransactionContext) => PromiseLike<R>): Promise<R>;
 declare function createRuntime<TContract extends Contract<SqlStorage>, TTargetId extends string>(options: CreateRuntimeOptions<TContract, TTargetId>): Runtime;
 //#endregion
-export { SqlRuntimeExtensionInstance as A, SqlMiddleware as B, RuntimeParameterizedCodecDescriptor as C, SqlRuntimeAdapterInstance as D, SqlRuntimeAdapterDescriptor as E, createSqlExecutionStack as F, validateContractCodecMappings as G, lowerSqlPlan as H, LintsOptions as I, lints as L, SqlStaticContributions as M, TypeHelperRegistry as N, SqlRuntimeDriverInstance as O, createExecutionContext as P, BudgetsOptions as R, RuntimeMutationDefaultGenerator as S, SqlExecutionStackWithDriver as T, extractCodecIds as U, SqlMiddlewareContext as V, validateCodecRegistryCompleteness as W, ensureSchemaStatement as _, CreateRuntimeOptions as a, writeContractMarker as b, RuntimeQueryable as c, RuntimeVerifyOptions as d, TelemetryOutcome as f, SqlStatement as g, withTransaction as h, MiddlewareContext as i, SqlRuntimeTargetDescriptor as j, SqlRuntimeExtensionDescriptor as k, RuntimeTelemetryEvent as l, createRuntime as m, Log$1 as n, Runtime as o, TransactionContext as p, Middleware as r, RuntimeConnection as s, AfterExecuteResult$1 as t, RuntimeTransaction as u, ensureTableStatement as v, SqlExecutionStack as w, ExecutionContext as x, readContractMarker as y, budgets as z };
-//# sourceMappingURL=index-yb51L_1h.d.mts.map
+export { SqlStaticContributions as A, lints as B, SqlExecutionStackWithDriver as C, SqlRuntimeExtensionDescriptor as D, SqlRuntimeDriverInstance as E, RuntimeFamilyAdapter as F, parseContractMarkerRow as G, budgets as H, RuntimeTelemetryEvent as I, validateCodecRegistryCompleteness as J, lowerSqlPlan as K, RuntimeVerifyOptions as L, createExecutionContext as M, createSqlExecutionStack as N, SqlRuntimeExtensionInstance as O, MarkerReader as P, TelemetryOutcome as R, SqlExecutionStack as S, SqlRuntimeAdapterInstance as T, SqlMiddleware as U, BudgetsOptions as V, SqlMiddlewareContext as W, validateContractCodecMappings as Y, writeContractMarker as _, Runtime as a, RuntimeMutationDefaultGenerator as b, RuntimeTransaction as c, withTransaction as d, APP_SPACE_ID as f, readContractMarker as g, ensureTableStatement as h, CreateRuntimeOptions as i, TypeHelperRegistry as j, SqlRuntimeTargetDescriptor as k, TransactionContext as l, ensureSchemaStatement as m, Log as n, RuntimeConnection as o, SqlStatement as p, extractCodecIds as q, MarkerStatement$1 as r, RuntimeQueryable as s, AfterExecuteResult$1 as t, createRuntime as u, ExecutionContext as v, SqlRuntimeAdapterDescriptor as w, RuntimeParameterizedCodecDescriptor as x, GeneratorStability as y, LintsOptions as z };
+//# sourceMappingURL=index-CFbuVnYJ.d.mts.map

package/dist/index-CFbuVnYJ.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-CFbuVnYJ.d.mts","names":[],"sources":["../src/codecs/validation.ts","../src/lower-sql-plan.ts","../src/marker.ts","../src/middleware/sql-middleware.ts","../src/middleware/budgets.ts","../src/middleware/lints.ts","../src/runtime-spi.ts","../src/sql-context.ts","../src/sql-marker.ts","../src/sql-runtime.ts"],"mappings":"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"}

package/dist/index.d.mts

@@ -1,2 +1,2 @@
-import { A as SqlRuntimeExtensionInstance, B as SqlMiddleware, C as RuntimeParameterizedCodecDescriptor, D as SqlRuntimeAdapterInstance, E as SqlRuntimeAdapterDescriptor, F as createSqlExecutionStack, G as validateContractCodecMappings, H as lowerSqlPlan, I as LintsOptions, L as lints, M as SqlStaticContributions, N as TypeHelperRegistry, O as SqlRuntimeDriverInstance, P as createExecutionContext, R as BudgetsOptions, S as RuntimeMutationDefaultGenerator, T as SqlExecutionStackWithDriver, U as extractCodecIds, V as SqlMiddlewareContext, W as validateCodecRegistryCompleteness, _ as ensureSchemaStatement, a as CreateRuntimeOptions, b as writeContractMarker, c as RuntimeQueryable, d as RuntimeVerifyOptions, f as TelemetryOutcome, g as SqlStatement, h as withTransaction, i as MiddlewareContext, j as SqlRuntimeTargetDescriptor, k as SqlRuntimeExtensionDescriptor, l as RuntimeTelemetryEvent, m as createRuntime, n as Log, o as Runtime, p as TransactionContext, r as Middleware, s as RuntimeConnection, t as AfterExecuteResult, u as RuntimeTransaction, v as ensureTableStatement, w as SqlExecutionStack, x as ExecutionContext, y as readContractMarker, z as budgets } from "./index-yb51L_1h.mjs";
-export { AfterExecuteResult, BudgetsOptions, CreateRuntimeOptions, ExecutionContext, LintsOptions, Log, Middleware, MiddlewareContext, Runtime, RuntimeConnection, RuntimeMutationDefaultGenerator, RuntimeParameterizedCodecDescriptor, RuntimeQueryable, RuntimeTelemetryEvent, RuntimeTransaction, RuntimeVerifyOptions, SqlExecutionStack, SqlExecutionStackWithDriver, SqlMiddleware, SqlMiddlewareContext, SqlRuntimeAdapterDescriptor, SqlRuntimeAdapterInstance, SqlRuntimeDriverInstance, SqlRuntimeExtensionDescriptor, SqlRuntimeExtensionInstance, SqlRuntimeTargetDescriptor, SqlStatement, SqlStaticContributions, TelemetryOutcome, TransactionContext, TypeHelperRegistry, budgets, createExecutionContext, createRuntime, createSqlExecutionStack, ensureSchemaStatement, ensureTableStatement, extractCodecIds, lints, lowerSqlPlan, readContractMarker, validateCodecRegistryCompleteness, validateContractCodecMappings, withTransaction, writeContractMarker };
+import { A as SqlStaticContributions, B as lints, C as SqlExecutionStackWithDriver, D as SqlRuntimeExtensionDescriptor, E as SqlRuntimeDriverInstance, F as RuntimeFamilyAdapter, G as parseContractMarkerRow, H as budgets, I as RuntimeTelemetryEvent, J as validateCodecRegistryCompleteness, K as lowerSqlPlan, L as RuntimeVerifyOptions, M as createExecutionContext, N as createSqlExecutionStack, O as SqlRuntimeExtensionInstance, P as MarkerReader, R as TelemetryOutcome, S as SqlExecutionStack, T as SqlRuntimeAdapterInstance, U as SqlMiddleware, V as BudgetsOptions, W as SqlMiddlewareContext, Y as validateContractCodecMappings, _ as writeContractMarker, a as Runtime, b as RuntimeMutationDefaultGenerator, c as RuntimeTransaction, d as withTransaction, f as APP_SPACE_ID, g as readContractMarker, h as ensureTableStatement, i as CreateRuntimeOptions, j as TypeHelperRegistry, k as SqlRuntimeTargetDescriptor, l as TransactionContext, m as ensureSchemaStatement, n as Log, o as RuntimeConnection, p as SqlStatement, q as extractCodecIds, r as MarkerStatement, s as RuntimeQueryable, t as AfterExecuteResult, u as createRuntime, v as ExecutionContext, w as SqlRuntimeAdapterDescriptor, x as RuntimeParameterizedCodecDescriptor, y as GeneratorStability, z as LintsOptions } from "./index-CFbuVnYJ.mjs";
+export { APP_SPACE_ID, AfterExecuteResult, BudgetsOptions, CreateRuntimeOptions, ExecutionContext, GeneratorStability, LintsOptions, Log, MarkerReader, MarkerStatement, Runtime, RuntimeConnection, RuntimeFamilyAdapter, RuntimeMutationDefaultGenerator, RuntimeParameterizedCodecDescriptor, RuntimeQueryable, RuntimeTelemetryEvent, RuntimeTransaction, RuntimeVerifyOptions, SqlExecutionStack, SqlExecutionStackWithDriver, SqlMiddleware, SqlMiddlewareContext, SqlRuntimeAdapterDescriptor, SqlRuntimeAdapterInstance, SqlRuntimeDriverInstance, SqlRuntimeExtensionDescriptor, SqlRuntimeExtensionInstance, SqlRuntimeTargetDescriptor, SqlStatement, SqlStaticContributions, TelemetryOutcome, TransactionContext, TypeHelperRegistry, budgets, createExecutionContext, createRuntime, createSqlExecutionStack, ensureSchemaStatement, ensureTableStatement, extractCodecIds, lints, lowerSqlPlan, parseContractMarkerRow, readContractMarker, validateCodecRegistryCompleteness, validateContractCodecMappings, withTransaction, writeContractMarker };

package/dist/index.mjs

@@ -1,3 +1,2 @@
-import { a as readContractMarker, c as createSqlExecutionStack, d as lowerSqlPlan, f as extractCodecIds, i as ensureTableStatement, l as lints, m as validateContractCodecMappings, n as withTransaction, o as writeContractMarker, p as validateCodecRegistryCompleteness, r as ensureSchemaStatement, s as createExecutionContext, t as createRuntime, u as budgets } from "./exports-Cssiepsb.mjs";
-
-export { budgets, createExecutionContext, createRuntime, createSqlExecutionStack, ensureSchemaStatement, ensureTableStatement, extractCodecIds, lints, lowerSqlPlan, readContractMarker, validateCodecRegistryCompleteness, validateContractCodecMappings, withTransaction, writeContractMarker };
+import { a as ensureTableStatement, c as createExecutionContext, d as budgets, f as parseContractMarkerRow, g as validateContractCodecMappings, h as validateCodecRegistryCompleteness, i as ensureSchemaStatement, l as createSqlExecutionStack, m as extractCodecIds, n as withTransaction, o as readContractMarker, p as lowerSqlPlan, r as APP_SPACE_ID, s as writeContractMarker, t as createRuntime, u as lints } from "./exports-C0exnDCV.mjs";
+export { APP_SPACE_ID, budgets, createExecutionContext, createRuntime, createSqlExecutionStack, ensureSchemaStatement, ensureTableStatement, extractCodecIds, lints, lowerSqlPlan, parseContractMarkerRow, readContractMarker, validateCodecRegistryCompleteness, validateContractCodecMappings, withTransaction, writeContractMarker };

package/dist/test/utils.d.mts

@@ -1,77 +1,82 @@
-import { A as SqlRuntimeExtensionInstance, D as SqlRuntimeAdapterInstance, E as SqlRuntimeAdapterDescriptor, O as SqlRuntimeDriverInstance, g as SqlStatement, j as SqlRuntimeTargetDescriptor, k as SqlRuntimeExtensionDescriptor, m as createRuntime, x as ExecutionContext } from "../index-yb51L_1h.mjs";
-import { Adapter, LoweredStatement, SelectAst } from "@prisma-next/sql-relational-core/ast";
-import * as _prisma_next_framework_components_execution0 from "@prisma-next/framework-components/execution";
+import { D as SqlRuntimeExtensionDescriptor, E as SqlRuntimeDriverInstance, O as SqlRuntimeExtensionInstance, T as SqlRuntimeAdapterInstance, k as SqlRuntimeTargetDescriptor, p as SqlStatement, u as createRuntime, v as ExecutionContext, w as SqlRuntimeAdapterDescriptor } from "../index-CFbuVnYJ.mjs";
+import { ResultType } from "@prisma-next/framework-components/runtime";
+import { Adapter, Codec, ContractCodecRegistry, LoweredStatement, SelectAst } from "@prisma-next/sql-relational-core/ast";
+import * as _$_prisma_next_framework_components_execution0 from "@prisma-next/framework-components/execution";
 import { RuntimeDriverDescriptor } from "@prisma-next/framework-components/execution";
-import { Contract, ExecutionPlan, ResultType } from "@prisma-next/contract/types";
+import { Contract } from "@prisma-next/contract/types";
+import { CodecDescriptor } from "@prisma-next/framework-components/codec";
 import { DevDatabase, collectAsync, createDevDatabase, teardownTestDatabase, withClient } from "@prisma-next/test-utils";
 import { SqlStorage } from "@prisma-next/sql-contract/types";
-import { SqlQueryPlan } from "@prisma-next/sql-relational-core/plan";
+import { SqlExecutionPlan, SqlQueryPlan } from "@prisma-next/sql-relational-core/plan";
 import { Client } from "pg";
 
 //#region test/utils.d.ts
-
 /**
- * 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.
+ * 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>[]>;
+declare function executePlanAndCollect<P extends SqlExecutionPlan<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.
+ * 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>;
+declare function drainPlanExecution(runtime: ReturnType<typeof createRuntime>, plan: SqlExecutionPlan | SqlQueryPlan<unknown>): Promise<void>;
 /**
  * Executes a SQL statement on a database client.
  */
 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.
+ * 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: Contract<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.
+ * 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: Contract<SqlStorage>): Promise<void>;
 /**
- * Creates a test adapter descriptor from a raw adapter.
- * Wraps the adapter in an SqlRuntimeAdapterDescriptor with static contributions
- * derived from the adapter's codec registry.
+ * Creates a test adapter descriptor from a raw adapter. Wraps the adapter in an SqlRuntimeAdapterDescriptor with static contributions derived from the adapter's codec registry.
+ */
+/**
+ * Build a {@link ContractCodecRegistry} from a codec array for tests that exercise `encodeParam(s)` / `decodeRow` in isolation. The production runtime builds `ContractCodecRegistry` from contract walk + descriptor list and never goes through this helper; tests use it to wire a hand-built codec set into the surface those functions consume in production.
  */
-declare function createTestAdapterDescriptor(adapter: Adapter<SelectAst, Contract<SqlStorage>, LoweredStatement>): SqlRuntimeAdapterDescriptor<'postgres'>;
+declare function buildTestContractCodecs(codecs: ReadonlyArray<Codec<string>>): ContractCodecRegistry;
+/**
+ * Synthesize `CodecDescriptor`s from a codec array of non-parameterized codec instances. Test-only: the production synthesis bridge was retired under TML-2357. Lets the existing `createTestAdapterDescriptor` pattern keep wrapping a stub `Adapter` (whose `__codecs` slot still exposes the codec set) into the descriptor-list shape that `SqlStaticContributions.codecs:` now expects. The `Codec` instances carry
+ * `traits`/`targetTypes`/`meta` via the SQL family extension; the structural narrow reads those fields directly.
+ */
+declare function descriptorsFromCodecs(codecs: ReadonlyArray<Codec<string>>): ReadonlyArray<CodecDescriptor>;
+declare function createTestAdapterDescriptor(adapter: StubAdapter): SqlRuntimeAdapterDescriptor<'postgres'>;
 /**
  * Creates a test target descriptor with empty static contributions.
  */
 declare function createTestTargetDescriptor(): SqlRuntimeTargetDescriptor<'postgres'>;
 /**
- * Creates an ExecutionContext for testing.
- * This helper DRYs up the common pattern of context creation in tests.
+ * Creates an ExecutionContext for testing. This helper DRYs up the common pattern of context creation in tests.
  *
- * Accepts a raw adapter and optional extension descriptors, wrapping the
- * adapter in a descriptor internally for descriptor-first context creation.
+ * 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 Contract<SqlStorage>>(contract: TContract, adapter: Adapter<SelectAst, Contract<SqlStorage>, LoweredStatement>, options?: {
+declare function createTestContext<TContract extends Contract<SqlStorage>>(contract: TContract, adapter: StubAdapter, options?: {
   extensionPacks?: ReadonlyArray<SqlRuntimeExtensionDescriptor<'postgres'>>;
 }): ExecutionContext<TContract>;
 declare function createTestStackInstance(options?: {
   extensionPacks?: ReadonlyArray<SqlRuntimeExtensionDescriptor<'postgres'>>;
   driver?: RuntimeDriverDescriptor<'sql', 'postgres', unknown, SqlRuntimeDriverInstance<'postgres'>>;
-}): _prisma_next_framework_components_execution0.ExecutionStackInstance<"sql", "postgres", SqlRuntimeAdapterInstance<"postgres">, SqlRuntimeDriverInstance<"postgres">, SqlRuntimeExtensionInstance<"postgres">>;
+}): _$_prisma_next_framework_components_execution0.ExecutionStackInstance<"sql", "postgres", SqlRuntimeAdapterInstance<"postgres">, SqlRuntimeDriverInstance<"postgres">, SqlRuntimeExtensionInstance<"postgres">>;
+/**
+ * Stub-adapter type augments the public {@link Adapter} surface with a `__codecs` slot that exposes the test stub's runtime codec set to descriptor-shaping helpers (`createTestAdapterDescriptor`). Production adapters do not declare this slot — runtime codecs flow through the descriptor list from `SqlRuntimeAdapterDescriptor.codecs()` — so the augmentation is intentionally test-only.
+ */
+type StubAdapter = Adapter<SelectAst, Contract<SqlStorage>, LoweredStatement> & {
+  readonly __codecs: ReadonlyArray<Codec<string>>;
+};
 /**
- * Creates a stub adapter for testing.
- * This helper DRYs up the common pattern of adapter creation in tests.
+ * Creates a stub adapter for testing. This helper DRYs up the common pattern of adapter creation in tests.
  *
- * 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.
+ * 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, Contract<SqlStorage>, LoweredStatement>;
+declare function createStubAdapter(): StubAdapter;
 declare function createTestContract(contract: Partial<Omit<Contract<SqlStorage>, 'profileHash' | 'storage'>> & {
   storageHash?: string;
   profileHash?: string;
   storage?: Omit<SqlStorage, 'storageHash'>;
 }): Contract<SqlStorage>;
 //#endregion
-export { type DevDatabase, collectAsync, createDevDatabase, createStubAdapter, createTestAdapterDescriptor, createTestContext, createTestContract, createTestStackInstance, createTestTargetDescriptor, drainPlanExecution, executePlanAndCollect, executeStatement, setupTestDatabase, teardownTestDatabase, withClient, writeTestContractMarker };
+export { type DevDatabase, StubAdapter, buildTestContractCodecs, collectAsync, createDevDatabase, createStubAdapter, createTestAdapterDescriptor, createTestContext, createTestContract, createTestStackInstance, createTestTargetDescriptor, descriptorsFromCodecs, drainPlanExecution, executePlanAndCollect, executeStatement, setupTestDatabase, teardownTestDatabase, withClient, writeTestContractMarker };
 //# sourceMappingURL=utils.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.mts","names":[],"sources":["../../test/utils.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"utils.d.mts","names":[],"sources":["../../test/utils.ts"],"mappings":";;;;;;;;;;;;;;;AA0DA;iBAAsB,qBAAA,WACV,gBAAA,CAAiB,UAAA,CAAW,CAAA,KAAM,YAAA,CAAa,UAAA,CAAW,CAAA,GAAA,CACpE,OAAA,EAAS,UAAA,QAAkB,aAAA,GAAgB,IAAA,EAAM,CAAA,GAAI,OAAA,CAAQ,UAAA,CAAW,CAAA;;;;iBAQpD,kBAAA,CACpB,OAAA,EAAS,UAAA,QAAkB,aAAA,GAC3B,IAAA,EAAM,gBAAA,GAAmB,YAAA,YACxB,OAAA;;;;iBAOmB,gBAAA,CAAiB,MAAA,EAAQ,MAAA,EAAQ,SAAA,EAAW,YAAA,GAAe,OAAA;;;;iBAY3D,iBAAA,CACpB,MAAA,EAAQ,MAAA,EACR,QAAA,EAAU,QAAA,CAAS,UAAA,GACnB,OAAA,GAAU,MAAA,EAAQ,MAAA,KAAW,OAAA,SAC5B,OAAA;;;;iBAqBmB,uBAAA,CACpB,MAAA,EAAQ,MAAA,EACR,QAAA,EAAU,QAAA,CAAS,UAAA,IAClB,OAAA;;;;;;;iBAiBa,uBAAA,CACd,MAAA,EAAQ,aAAA,CAAc,KAAA,YACrB,qBAAA;;;;;iBAea,qBAAA,CACd,MAAA,EAAQ,aAAA,CAAc,KAAA,YACrB,aAAA,CAAc,eAAA;AAAA,iBAqBD,2BAAA,CACd,OAAA,EAAS,WAAA,GACR,2BAAA;;;;iBAmBa,0BAAA,CAAA,GAA8B,0BAAA;;;;;;iBAmB9B,iBAAA,mBAAoC,QAAA,CAAS,UAAA,EAAA,CAC3D,QAAA,EAAU,SAAA,EACV,OAAA,EAAS,WAAA,EACT,OAAA;EACE,cAAA,GAAiB,aAAA,CAAc,6BAAA;AAAA,IAEhC,gBAAA,CAAiB,SAAA;AAAA,iBAWJ,uBAAA,CAAwB,OAAA;EACtC,cAAA,GAAiB,aAAA,CAAc,6BAAA;EAC/B,MAAA,GAAS,uBAAA,6BAIP,wBAAA;AAAA,IAEH,8CAAA,CAAA,sBAAA,oBAAA,yBAAA,cAAA,wBAAA,cAAA,2BAAA;;;;KAcW,WAAA,GAAc,OAAA,CAAQ,SAAA,EAAW,QAAA,CAAS,UAAA,GAAa,gBAAA;EAAA,SACxD,QAAA,EAAU,aAAA,CAAc,KAAA;AAAA;AAjLnC;;;;;AAAA,iBAyLgB,iBAAA,CAAA,GAAqB,WAAA;AAAA,iBAkDrB,kBAAA,CACd,QAAA,EAAU,OAAA,CAAQ,IAAA,CAAK,QAAA,CAAS,UAAA;EAC9B,WAAA;EACA,WAAA;EACA,OAAA,GAAU,IAAA,CAAK,UAAA;AAAA,IAEhB,QAAA,CAAS,UAAA"}