@prisma-next/sql-runtime 0.1.0-pr.65.7 → 0.1.0-pr.65.8

package/dist/{chunk-CTXL77UQ.js → chunk-C6I3V3DM.js}

@@ -67,32 +67,32 @@ function lowerSqlPlan(context, queryPlan) {
 import { createOperationRegistry } from "@prisma-next/operations";
 import { createCodecRegistry } from "@prisma-next/sql-relational-core/ast";
 function createRuntimeContext(options) {
-  const { contract, adapter, extensionPacks } = options;
+  const { contract, adapter: adapterDescriptor, extensionPacks } = options;
+  const adapterInstance = adapterDescriptor.create();
   const codecRegistry = createCodecRegistry();
   const operationRegistry = createOperationRegistry();
-  const allExtensions = [
-    {
-      codecs: () => adapter.profile.codecs()
-    },
-    ...extensionPacks ?? []
-  ];
-  for (const extension of allExtensions) {
-    const extensionCodecs = extension.codecs?.();
-    if (extensionCodecs) {
-      for (const codec of extensionCodecs.values()) {
+  const adapterCodecs = adapterInstance.profile.codecs();
+  for (const codec of adapterCodecs.values()) {
+    codecRegistry.register(codec);
+  }
+  for (const extDescriptor of extensionPacks ?? []) {
+    const extInstance = extDescriptor.create();
+    const extCodecs = extInstance.codecs?.();
+    if (extCodecs) {
+      for (const codec of extCodecs.values()) {
         codecRegistry.register(codec);
       }
     }
-    const extensionOperations = extension.operations?.();
-    if (extensionOperations) {
-      for (const operation of extensionOperations) {
+    const extOperations = extInstance.operations?.();
+    if (extOperations) {
+      for (const operation of extOperations) {
         operationRegistry.register(operation);
       }
     }
   }
   return {
     contract,
-    adapter,
+    adapter: adapterInstance,
     operations: operationRegistry,
     codecs: codecRegistry
   };
@@ -452,4 +452,4 @@ export {
   budgets,
   lints
 };
-//# sourceMappingURL=chunk-CTXL77UQ.js.map
+//# sourceMappingURL=chunk-C6I3V3DM.js.map

package/dist/chunk-C6I3V3DM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/codecs/validation.ts","../src/lower-sql-plan.ts","../src/sql-context.ts","../src/sql-marker.ts","../src/sql-runtime.ts","../src/codecs/decoding.ts","../src/codecs/encoding.ts","../src/sql-family-adapter.ts","../src/exports/index.ts"],"sourcesContent":["import { runtimeError } from '@prisma-next/runtime-executor';\nimport type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';\nimport type { CodecRegistry } from '@prisma-next/sql-relational-core/ast';\n\nexport function extractCodecIds(contract: SqlContract<SqlStorage>): Set<string> {\n  const codecIds = new Set<string>();\n\n  for (const table of Object.values(contract.storage.tables)) {\n    for (const column of Object.values(table.columns)) {\n      const codecId = column.codecId;\n      codecIds.add(codecId);\n    }\n  }\n\n  return codecIds;\n}\n\nfunction extractCodecIdsFromColumns(contract: SqlContract<SqlStorage>): Map<string, string> {\n  const codecIds = new Map<string, string>();\n\n  for (const [tableName, table] of Object.entries(contract.storage.tables)) {\n    for (const [columnName, column] of Object.entries(table.columns)) {\n      const codecId = column.codecId;\n      const key = `${tableName}.${columnName}`;\n      codecIds.set(key, codecId);\n    }\n  }\n\n  return codecIds;\n}\n\nexport function validateContractCodecMappings(\n  registry: CodecRegistry,\n  contract: SqlContract<SqlStorage>,\n): void {\n  const codecIds = extractCodecIdsFromColumns(contract);\n  const invalidCodecs: Array<{ table: string; column: string; codecId: string }> = [];\n\n  for (const [key, codecId] of codecIds.entries()) {\n    if (!registry.has(codecId)) {\n      const parts = key.split('.');\n      const table = parts[0] ?? '';\n      const column = parts[1] ?? '';\n      invalidCodecs.push({ table, column, codecId });\n    }\n  }\n\n  if (invalidCodecs.length > 0) {\n    const details: Record<string, unknown> = {\n      contractTarget: contract.target,\n      invalidCodecs,\n    };\n\n    throw runtimeError(\n      'RUNTIME.CODEC_MISSING',\n      `Missing codec implementations for column codecIds: ${invalidCodecs.map((c) => `${c.table}.${c.column} (${c.codecId})`).join(', ')}`,\n      details,\n    );\n  }\n}\n\nexport function validateCodecRegistryCompleteness(\n  registry: CodecRegistry,\n  contract: SqlContract<SqlStorage>,\n): void {\n  validateContractCodecMappings(registry, contract);\n}\n","import type { ExecutionPlan } from '@prisma-next/contract/types';\nimport type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';\nimport type { RuntimeContext } from './sql-context';\n\n/**\n * Lowers a SQL query plan to an executable Plan by calling the adapter's lower method.\n *\n * This function is responsible for converting a lane-produced SqlQueryPlan (which contains\n * AST and params but no SQL) into a fully executable Plan (which includes SQL string).\n *\n * @param context - Runtime context containing the adapter\n * @param queryPlan - SQL query plan from a lane (contains AST, params, meta, but no SQL)\n * @returns Fully executable Plan with SQL string\n */\nexport function lowerSqlPlan<Row>(\n  context: RuntimeContext,\n  queryPlan: SqlQueryPlan<Row>,\n): ExecutionPlan<Row> {\n  const lowered = context.adapter.lower(queryPlan.ast, {\n    contract: context.contract,\n    params: queryPlan.params,\n  });\n\n  const body = lowered.body;\n\n  return Object.freeze({\n    sql: body.sql,\n    params: body.params ?? queryPlan.params,\n    ast: queryPlan.ast,\n    meta: queryPlan.meta,\n  });\n}\n","import type {\n  RuntimeAdapterDescriptor,\n  RuntimeAdapterInstance,\n  RuntimeExtensionDescriptor,\n  RuntimeExtensionInstance,\n  RuntimeTargetDescriptor,\n} from '@prisma-next/core-execution-plane/types';\nimport { createOperationRegistry } from '@prisma-next/operations';\nimport type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';\nimport type { SqlOperationSignature } from '@prisma-next/sql-operations';\nimport type {\n  Adapter,\n  CodecRegistry,\n  LoweredStatement,\n  QueryAst,\n} from '@prisma-next/sql-relational-core/ast';\nimport { createCodecRegistry } from '@prisma-next/sql-relational-core/ast';\nimport type { QueryLaneContext } from '@prisma-next/sql-relational-core/query-lane-context';\n\n// ============================================================================\n// SQL Runtime Extension Types\n// ============================================================================\n\n/**\n * SQL runtime extension instance.\n * Extends the framework RuntimeExtensionInstance with SQL-specific hooks\n * for contributing codecs and operations to the runtime context.\n *\n * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')\n */\nexport interface SqlRuntimeExtensionInstance<TTargetId extends string>\n  extends RuntimeExtensionInstance<'sql', TTargetId> {\n  /** Returns codecs to register in the runtime context. */\n  codecs?(): CodecRegistry;\n  /** Returns operations to register in the runtime context. */\n  operations?(): ReadonlyArray<SqlOperationSignature>;\n}\n\n/**\n * SQL runtime extension descriptor.\n * Extends the framework RuntimeExtensionDescriptor with SQL-specific instance type.\n *\n * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')\n */\nexport interface SqlRuntimeExtensionDescriptor<TTargetId extends string>\n  extends RuntimeExtensionDescriptor<'sql', TTargetId, SqlRuntimeExtensionInstance<TTargetId>> {\n  create(): SqlRuntimeExtensionInstance<TTargetId>;\n}\n\n// ============================================================================\n// SQL Runtime Adapter Instance\n// ============================================================================\n\n/**\n * SQL runtime adapter instance interface.\n * Combines RuntimeAdapterInstance identity with SQL Adapter behavior.\n * The instance IS an Adapter (via intersection), not HAS an adapter property.\n *\n * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')\n */\nexport type SqlRuntimeAdapterInstance<TTargetId extends string = string> = RuntimeAdapterInstance<\n  'sql',\n  TTargetId\n> &\n  Adapter<QueryAst, SqlContract<SqlStorage>, LoweredStatement>;\n\n// ============================================================================\n// SQL Runtime Context\n// ============================================================================\n\nexport interface RuntimeContext<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>>\n  extends QueryLaneContext<TContract> {\n  readonly adapter:\n    | Adapter<QueryAst, TContract, LoweredStatement>\n    | Adapter<QueryAst, SqlContract<SqlStorage>, LoweredStatement>;\n}\n\n/**\n * Descriptor-first options for creating a SQL runtime context.\n * Takes the same framework composition as control-plane: target, adapter, extensionPacks.\n *\n * @template TContract - The SQL contract type\n * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')\n */\nexport interface CreateRuntimeContextOptions<\n  TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>,\n  TTargetId extends string = string,\n> {\n  readonly contract: TContract;\n  readonly target: RuntimeTargetDescriptor<'sql', TTargetId>;\n  readonly adapter: RuntimeAdapterDescriptor<\n    'sql',\n    TTargetId,\n    SqlRuntimeAdapterInstance<TTargetId>\n  >;\n  readonly extensionPacks?: ReadonlyArray<SqlRuntimeExtensionDescriptor<TTargetId>>;\n}\n\n/**\n * Creates a SQL runtime context from descriptor-first composition.\n *\n * The context includes:\n * - The validated contract\n * - The adapter instance (created from descriptor)\n * - Codec registry (populated from adapter + extension instances)\n * - Operation registry (populated from extension instances)\n *\n * @param options - Descriptor-first composition options\n * @returns RuntimeContext with registries wired from all components\n */\nexport function createRuntimeContext<\n  TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>,\n  TTargetId extends string = string,\n>(options: CreateRuntimeContextOptions<TContract, TTargetId>): RuntimeContext<TContract> {\n  const { contract, adapter: adapterDescriptor, extensionPacks } = options;\n\n  // Create adapter instance from descriptor\n  // The adapter instance IS an Adapter (via intersection)\n  const adapterInstance = adapterDescriptor.create();\n\n  // Create registries\n  const codecRegistry = createCodecRegistry();\n  const operationRegistry = createOperationRegistry();\n\n  // Register adapter codecs (adapter instance has profile.codecs())\n  const adapterCodecs = adapterInstance.profile.codecs();\n  for (const codec of adapterCodecs.values()) {\n    codecRegistry.register(codec);\n  }\n\n  // Create extension instances and register their codecs/operations\n  for (const extDescriptor of extensionPacks ?? []) {\n    const extInstance = extDescriptor.create();\n\n    const extCodecs = extInstance.codecs?.();\n    if (extCodecs) {\n      for (const codec of extCodecs.values()) {\n        codecRegistry.register(codec);\n      }\n    }\n\n    const extOperations = extInstance.operations?.();\n    if (extOperations) {\n      for (const operation of extOperations) {\n        operationRegistry.register(operation);\n      }\n    }\n  }\n\n  return {\n    contract,\n    adapter: adapterInstance,\n    operations: operationRegistry,\n    codecs: codecRegistry,\n  };\n}\n","import type { MarkerStatement } from '@prisma-next/runtime-executor';\n\nexport interface SqlStatement {\n  readonly sql: string;\n  readonly params: readonly unknown[];\n}\n\nexport interface WriteMarkerInput {\n  readonly coreHash: string;\n  readonly profileHash: string;\n  readonly contractJson?: unknown;\n  readonly canonicalVersion?: number;\n  readonly appTag?: string;\n  readonly meta?: Record<string, unknown>;\n}\n\nexport const ensureSchemaStatement: SqlStatement = {\n  sql: 'create schema if not exists prisma_contract',\n  params: [],\n};\n\nexport const ensureTableStatement: SqlStatement = {\n  sql: `create table if not exists prisma_contract.marker (\n    id smallint primary key default 1,\n    core_hash text not null,\n    profile_hash text not null,\n    contract_json jsonb,\n    canonical_version int,\n    updated_at timestamptz not null default now(),\n    app_tag text,\n    meta jsonb not null default '{}'\n  )`,\n  params: [],\n};\n\nexport function readContractMarker(): MarkerStatement {\n  return {\n    sql: `select\n      core_hash,\n      profile_hash,\n      contract_json,\n      canonical_version,\n      updated_at,\n      app_tag,\n      meta\n    from prisma_contract.marker\n    where id = $1`,\n    params: [1],\n  };\n}\n\nexport interface WriteContractMarkerStatements {\n  readonly insert: SqlStatement;\n  readonly update: SqlStatement;\n}\n\nexport function writeContractMarker(input: WriteMarkerInput): WriteContractMarkerStatements {\n  const baseParams: readonly unknown[] = [\n    1,\n    input.coreHash,\n    input.profileHash,\n    input.contractJson ?? null,\n    input.canonicalVersion ?? null,\n    input.appTag ?? null,\n    JSON.stringify(input.meta ?? {}),\n  ];\n\n  const insert: SqlStatement = {\n    sql: `insert into prisma_contract.marker (\n        id,\n        core_hash,\n        profile_hash,\n        contract_json,\n        canonical_version,\n        updated_at,\n        app_tag,\n        meta\n      ) values (\n        $1,\n        $2,\n        $3,\n        $4::jsonb,\n        $5,\n        now(),\n        $6,\n        $7::jsonb\n      )`,\n    params: baseParams,\n  };\n\n  const update: SqlStatement = {\n    sql: `update prisma_contract.marker set\n        core_hash = $2,\n        profile_hash = $3,\n        contract_json = $4::jsonb,\n        canonical_version = $5,\n        updated_at = now(),\n        app_tag = $6,\n        meta = $7::jsonb\n      where id = $1`,\n    params: baseParams,\n  };\n\n  return { insert, update };\n}\n","import type { ExecutionPlan } from '@prisma-next/contract/types';\nimport type { OperationRegistry } from '@prisma-next/operations';\nimport type {\n  Log,\n  Plugin,\n  RuntimeCore,\n  RuntimeCoreOptions,\n  RuntimeTelemetryEvent,\n  RuntimeVerifyOptions,\n  TelemetryOutcome,\n} from '@prisma-next/runtime-executor';\nimport { AsyncIterableResult, createRuntimeCore } from '@prisma-next/runtime-executor';\nimport type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';\nimport type {\n  Adapter,\n  CodecRegistry,\n  LoweredStatement,\n  SelectAst,\n  SqlDriver,\n} from '@prisma-next/sql-relational-core/ast';\nimport type { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';\nimport { decodeRow } from './codecs/decoding';\nimport { encodeParams } from './codecs/encoding';\nimport { validateCodecRegistryCompleteness } from './codecs/validation';\nimport { lowerSqlPlan } from './lower-sql-plan';\nimport type { RuntimeContext } from './sql-context';\nimport { SqlFamilyAdapter } from './sql-family-adapter';\n\nexport interface RuntimeOptions<\n  TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>,\n> {\n  readonly driver: SqlDriver;\n  readonly verify: RuntimeVerifyOptions;\n  readonly context: RuntimeContext<TContract>;\n  readonly plugins?: readonly Plugin<\n    TContract,\n    Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>,\n    SqlDriver\n  >[];\n  readonly mode?: 'strict' | 'permissive';\n  readonly log?: Log;\n}\n\nexport interface Runtime {\n  execute<Row = Record<string, unknown>>(\n    plan: ExecutionPlan<Row> | SqlQueryPlan<Row>,\n  ): AsyncIterableResult<Row>;\n  telemetry(): RuntimeTelemetryEvent | null;\n  close(): Promise<void>;\n  operations(): OperationRegistry;\n}\n\nexport type { RuntimeTelemetryEvent, RuntimeVerifyOptions, TelemetryOutcome };\n\nclass SqlRuntimeImpl<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>>\n  implements Runtime\n{\n  private readonly core: RuntimeCore<\n    TContract,\n    Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>,\n    SqlDriver\n  >;\n  private readonly contract: TContract;\n  private readonly context: RuntimeContext<TContract>;\n  private readonly codecRegistry: CodecRegistry;\n  private codecRegistryValidated: boolean;\n\n  constructor(options: RuntimeOptions<TContract>) {\n    const { context, driver, verify, plugins, mode, log } = options;\n    this.contract = context.contract;\n    this.context = context;\n    this.codecRegistry = context.codecs;\n    this.codecRegistryValidated = false;\n\n    const familyAdapter = new SqlFamilyAdapter(context.contract);\n\n    const coreOptions: RuntimeCoreOptions<\n      TContract,\n      Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>,\n      SqlDriver\n    > = {\n      familyAdapter,\n      driver,\n      verify,\n      plugins: plugins as readonly Plugin<\n        TContract,\n        Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>,\n        SqlDriver\n      >[],\n      ...(mode !== undefined ? { mode } : {}),\n      ...(log !== undefined ? { log } : {}),\n      operationRegistry: context.operations,\n    };\n\n    this.core = createRuntimeCore(coreOptions);\n\n    if (verify.mode === 'startup') {\n      validateCodecRegistryCompleteness(this.codecRegistry, context.contract);\n      this.codecRegistryValidated = true;\n    }\n  }\n\n  private ensureCodecRegistryValidated(contract: SqlContract<SqlStorage>): void {\n    if (!this.codecRegistryValidated) {\n      validateCodecRegistryCompleteness(this.codecRegistry, contract);\n      this.codecRegistryValidated = true;\n    }\n  }\n\n  execute<Row = Record<string, unknown>>(\n    plan: ExecutionPlan<Row> | SqlQueryPlan<Row>,\n  ): AsyncIterableResult<Row> {\n    this.ensureCodecRegistryValidated(this.contract);\n\n    // Check if plan is SqlQueryPlan (has ast but no sql)\n    const isSqlQueryPlan = (p: ExecutionPlan<Row> | SqlQueryPlan<Row>): p is SqlQueryPlan<Row> => {\n      return 'ast' in p && !('sql' in p);\n    };\n\n    // Lower SqlQueryPlan to Plan if needed\n    const executablePlan: ExecutionPlan<Row> = isSqlQueryPlan(plan)\n      ? lowerSqlPlan(this.context, plan)\n      : plan;\n\n    const iterator = async function* (\n      self: SqlRuntimeImpl<TContract>,\n    ): AsyncGenerator<Row, void, unknown> {\n      const encodedParams = encodeParams(executablePlan, self.codecRegistry);\n      const planWithEncodedParams: ExecutionPlan<Row> = {\n        ...executablePlan,\n        params: encodedParams,\n      };\n\n      const coreIterator = self.core.execute(planWithEncodedParams);\n\n      for await (const rawRow of coreIterator) {\n        const decodedRow = decodeRow(\n          rawRow as Record<string, unknown>,\n          executablePlan,\n          self.codecRegistry,\n        );\n        yield decodedRow as Row;\n      }\n    };\n\n    return new AsyncIterableResult(iterator(this));\n  }\n\n  telemetry(): RuntimeTelemetryEvent | null {\n    return this.core.telemetry();\n  }\n\n  operations(): OperationRegistry {\n    return this.core.operations();\n  }\n\n  close(): Promise<void> {\n    return this.core.close();\n  }\n}\n\nexport function createRuntime<TContract extends SqlContract<SqlStorage>>(\n  options: RuntimeOptions<TContract>,\n): Runtime {\n  return new SqlRuntimeImpl(options);\n}\n","import type { ExecutionPlan } from '@prisma-next/contract/types';\nimport type { Codec, CodecRegistry } from '@prisma-next/sql-relational-core/ast';\n\nfunction resolveRowCodec(\n  alias: string,\n  plan: ExecutionPlan,\n  registry: CodecRegistry,\n): Codec | null {\n  const planCodecId = plan.meta.annotations?.codecs?.[alias] as string | undefined;\n  if (planCodecId) {\n    const codec = registry.get(planCodecId);\n    if (codec) {\n      return codec;\n    }\n  }\n\n  if (plan.meta.projectionTypes) {\n    const typeId = plan.meta.projectionTypes[alias];\n    if (typeId) {\n      const codec = registry.get(typeId);\n      if (codec) {\n        return codec;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function decodeRow(\n  row: Record<string, unknown>,\n  plan: ExecutionPlan,\n  registry: CodecRegistry,\n): Record<string, unknown> {\n  const decoded: Record<string, unknown> = {};\n\n  let aliases: readonly string[];\n  const projection = plan.meta.projection;\n  if (projection && !Array.isArray(projection)) {\n    aliases = Object.keys(projection);\n  } else if (projection && Array.isArray(projection)) {\n    aliases = projection;\n  } else {\n    aliases = Object.keys(row);\n  }\n\n  for (const alias of aliases) {\n    const wireValue = row[alias];\n\n    const projection = plan.meta.projection;\n    const projectionValue =\n      projection && typeof projection === 'object' && !Array.isArray(projection)\n        ? (projection as Record<string, string>)[alias]\n        : undefined;\n\n    if (typeof projectionValue === 'string' && projectionValue.startsWith('include:')) {\n      if (wireValue === null || wireValue === undefined) {\n        decoded[alias] = [];\n        continue;\n      }\n\n      try {\n        let parsed: unknown;\n        if (typeof wireValue === 'string') {\n          parsed = JSON.parse(wireValue);\n        } else if (Array.isArray(wireValue)) {\n          parsed = wireValue;\n        } else {\n          parsed = JSON.parse(String(wireValue));\n        }\n\n        if (!Array.isArray(parsed)) {\n          throw new Error(`Expected array for include alias '${alias}', got ${typeof parsed}`);\n        }\n\n        decoded[alias] = parsed;\n      } catch (error) {\n        const decodeError = new Error(\n          `Failed to parse JSON array for include alias '${alias}': ${error instanceof Error ? error.message : String(error)}`,\n        ) as Error & {\n          code: string;\n          category: string;\n          severity: string;\n          details?: Record<string, unknown>;\n        };\n        decodeError.code = 'RUNTIME.DECODE_FAILED';\n        decodeError.category = 'RUNTIME';\n        decodeError.severity = 'error';\n        decodeError.details = {\n          alias,\n          wirePreview:\n            typeof wireValue === 'string' && wireValue.length > 100\n              ? `${wireValue.substring(0, 100)}...`\n              : String(wireValue).substring(0, 100),\n        };\n        throw decodeError;\n      }\n      continue;\n    }\n\n    if (wireValue === null || wireValue === undefined) {\n      decoded[alias] = wireValue;\n      continue;\n    }\n\n    const codec = resolveRowCodec(alias, plan, registry);\n\n    if (!codec) {\n      decoded[alias] = wireValue;\n      continue;\n    }\n\n    try {\n      decoded[alias] = codec.decode(wireValue);\n    } catch (error) {\n      const decodeError = new Error(\n        `Failed to decode row alias '${alias}' with codec '${codec.id}': ${error instanceof Error ? error.message : String(error)}`,\n      ) as Error & {\n        code: string;\n        category: string;\n        severity: string;\n        details?: Record<string, unknown>;\n      };\n      decodeError.code = 'RUNTIME.DECODE_FAILED';\n      decodeError.category = 'RUNTIME';\n      decodeError.severity = 'error';\n      decodeError.details = {\n        alias,\n        codec: codec.id,\n        wirePreview:\n          typeof wireValue === 'string' && wireValue.length > 100\n            ? `${wireValue.substring(0, 100)}...`\n            : String(wireValue).substring(0, 100),\n      };\n      throw decodeError;\n    }\n  }\n\n  return decoded;\n}\n","import type { ExecutionPlan, ParamDescriptor } from '@prisma-next/contract/types';\nimport type { Codec, CodecRegistry } from '@prisma-next/sql-relational-core/ast';\n\nfunction resolveParamCodec(\n  paramDescriptor: ParamDescriptor,\n  plan: ExecutionPlan,\n  registry: CodecRegistry,\n): Codec | null {\n  const paramName = paramDescriptor.name ?? `param_${paramDescriptor.index ?? 0}`;\n\n  const planCodecId = plan.meta.annotations?.codecs?.[paramName] as string | undefined;\n  if (planCodecId) {\n    const codec = registry.get(planCodecId);\n    if (codec) {\n      return codec;\n    }\n  }\n\n  if (paramDescriptor.codecId) {\n    const codec = registry.get(paramDescriptor.codecId);\n    if (codec) {\n      return codec;\n    }\n  }\n\n  return null;\n}\n\nexport function encodeParam(\n  value: unknown,\n  paramDescriptor: ParamDescriptor,\n  plan: ExecutionPlan,\n  registry: CodecRegistry,\n): unknown {\n  if (value === null || value === undefined) {\n    return null;\n  }\n\n  const codec = resolveParamCodec(paramDescriptor, plan, registry);\n  if (!codec) {\n    return value;\n  }\n\n  if (codec.encode) {\n    try {\n      return codec.encode(value);\n    } catch (error) {\n      throw new Error(\n        `Failed to encode parameter ${paramDescriptor.name ?? paramDescriptor.index}: ${error instanceof Error ? error.message : String(error)}`,\n      );\n    }\n  }\n\n  return value;\n}\n\nexport function encodeParams(plan: ExecutionPlan, registry: CodecRegistry): readonly unknown[] {\n  if (plan.params.length === 0) {\n    return plan.params;\n  }\n\n  const encoded: unknown[] = [];\n\n  for (let i = 0; i < plan.params.length; i++) {\n    const paramValue = plan.params[i];\n    const paramDescriptor = plan.meta.paramDescriptors[i];\n\n    if (paramDescriptor) {\n      encoded.push(encodeParam(paramValue, paramDescriptor, plan, registry));\n    } else {\n      encoded.push(paramValue);\n    }\n  }\n\n  return Object.freeze(encoded);\n}\n","import type { ExecutionPlan } from '@prisma-next/contract/types';\nimport type {\n  MarkerReader,\n  MarkerStatement,\n  RuntimeFamilyAdapter,\n} from '@prisma-next/runtime-executor';\nimport { runtimeError } from '@prisma-next/runtime-executor';\nimport type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';\nimport { readContractMarker } from './sql-marker';\n\nclass SqlMarkerReader implements MarkerReader {\n  readMarkerStatement(): MarkerStatement {\n    return readContractMarker();\n  }\n}\n\nexport class SqlFamilyAdapter<TContract extends SqlContract<SqlStorage>>\n  implements RuntimeFamilyAdapter<TContract>\n{\n  readonly contract: TContract;\n  readonly markerReader: MarkerReader;\n\n  constructor(contract: TContract) {\n    this.contract = contract;\n    this.markerReader = new SqlMarkerReader();\n  }\n\n  validatePlan(plan: ExecutionPlan, contract: TContract): void {\n    if (plan.meta.target !== contract.target) {\n      throw runtimeError('PLAN.TARGET_MISMATCH', 'Plan target does not match runtime target', {\n        planTarget: plan.meta.target,\n        runtimeTarget: contract.target,\n      });\n    }\n\n    if (plan.meta.coreHash !== contract.coreHash) {\n      throw runtimeError('PLAN.HASH_MISMATCH', 'Plan core hash does not match runtime contract', {\n        planCoreHash: plan.meta.coreHash,\n        runtimeCoreHash: contract.coreHash,\n      });\n    }\n  }\n}\n","export type {\n  AfterExecuteResult,\n  BudgetsOptions,\n  LintsOptions,\n  Log,\n  Plugin,\n  PluginContext,\n} from '@prisma-next/runtime-executor';\nexport { budgets, lints } from '@prisma-next/runtime-executor';\nexport {\n  extractCodecIds,\n  validateCodecRegistryCompleteness,\n  validateContractCodecMappings,\n} from '../codecs/validation';\nexport { lowerSqlPlan } from '../lower-sql-plan';\nexport type {\n  CreateRuntimeContextOptions,\n  RuntimeContext,\n  SqlRuntimeAdapterInstance,\n  SqlRuntimeExtensionDescriptor,\n  SqlRuntimeExtensionInstance,\n} from '../sql-context';\nexport { createRuntimeContext } from '../sql-context';\nexport type { SqlStatement } from '../sql-marker';\nexport {\n  ensureSchemaStatement,\n  ensureTableStatement,\n  readContractMarker,\n  writeContractMarker,\n} from '../sql-marker';\nexport type {\n  Runtime,\n  RuntimeOptions,\n  RuntimeTelemetryEvent,\n  RuntimeVerifyOptions,\n  TelemetryOutcome,\n} from '../sql-runtime';\nexport { createRuntime } from '../sql-runtime';\n"],"mappings":"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","names":["projection","runtimeError","runtimeError"]}

package/dist/index.d.ts

@@ -3,9 +3,10 @@ import { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
 import { CodecRegistry } from '@prisma-next/sql-relational-core/ast';
 import { ExecutionPlan } from '@prisma-next/contract/types';
 import { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
-import { R as RuntimeContext } from './sql-runtime-BRjzQkEs.js';
-export { E as Extension, b as Runtime, d as RuntimeOptions, S as SqlStatement, f as createRuntime, c as createRuntimeContext, e as ensureSchemaStatement, a as ensureTableStatement, r as readContractMarker, w as writeContractMarker } from './sql-runtime-BRjzQkEs.js';
+import { R as RuntimeContext } from './sql-runtime-DgEbg2OP.js';
+export { C as CreateRuntimeContextOptions, g as Runtime, h as RuntimeOptions, S as SqlRuntimeAdapterInstance, a as SqlRuntimeExtensionDescriptor, b as SqlRuntimeExtensionInstance, d as SqlStatement, i as createRuntime, c as createRuntimeContext, e as ensureSchemaStatement, f as ensureTableStatement, r as readContractMarker, w as writeContractMarker } from './sql-runtime-DgEbg2OP.js';
 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';
 

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   validateCodecRegistryCompleteness,
   validateContractCodecMappings,
   writeContractMarker
-} from "./chunk-CTXL77UQ.js";
+} from "./chunk-C6I3V3DM.js";
 import "./chunk-7D4SUZUM.js";
 export {
   budgets,

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

@@ -0,0 +1,109 @@
+import { MarkerStatement, AsyncIterableResult, RuntimeTelemetryEvent, RuntimeVerifyOptions, Plugin, Log } from '@prisma-next/runtime-executor';
+import { ExecutionPlan } from '@prisma-next/contract/types';
+import { OperationRegistry } from '@prisma-next/operations';
+import { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import { Adapter, QueryAst, LoweredStatement, CodecRegistry, SqlDriver, SelectAst } from '@prisma-next/sql-relational-core/ast';
+import { SqlQueryPlan } from '@prisma-next/sql-relational-core/plan';
+import { RuntimeTargetDescriptor, RuntimeAdapterDescriptor, RuntimeAdapterInstance, RuntimeExtensionDescriptor, RuntimeExtensionInstance } from '@prisma-next/core-execution-plane/types';
+import { SqlOperationSignature } from '@prisma-next/sql-operations';
+import { 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')
+ */
+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')
+ */
+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')
+ */
+type SqlRuntimeAdapterInstance<TTargetId extends string = string> = RuntimeAdapterInstance<'sql', TTargetId> & Adapter<QueryAst, SqlContract<SqlStorage>, LoweredStatement>;
+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')
+ */
+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
+ */
+declare function createRuntimeContext<TContract extends SqlContract<SqlStorage> = SqlContract<SqlStorage>, TTargetId extends string = string>(options: CreateRuntimeContextOptions<TContract, TTargetId>): RuntimeContext<TContract>;
+
+interface SqlStatement {
+    readonly sql: string;
+    readonly params: readonly unknown[];
+}
+interface WriteMarkerInput {
+    readonly coreHash: string;
+    readonly profileHash: string;
+    readonly contractJson?: unknown;
+    readonly canonicalVersion?: number;
+    readonly appTag?: string;
+    readonly meta?: Record<string, unknown>;
+}
+declare const ensureSchemaStatement: SqlStatement;
+declare const ensureTableStatement: SqlStatement;
+declare function readContractMarker(): MarkerStatement;
+interface WriteContractMarkerStatements {
+    readonly insert: SqlStatement;
+    readonly update: SqlStatement;
+}
+declare function writeContractMarker(input: WriteMarkerInput): WriteContractMarkerStatements;
+
+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;
+}
+interface Runtime {
+    execute<Row = Record<string, unknown>>(plan: ExecutionPlan<Row> | SqlQueryPlan<Row>): AsyncIterableResult<Row>;
+    telemetry(): RuntimeTelemetryEvent | null;
+    close(): Promise<void>;
+    operations(): OperationRegistry;
+}
+
+declare function createRuntime<TContract extends SqlContract<SqlStorage>>(options: RuntimeOptions<TContract>): Runtime;
+
+export { type CreateRuntimeContextOptions as C, type RuntimeContext as R, type SqlRuntimeAdapterInstance as S, type SqlRuntimeExtensionDescriptor as a, type SqlRuntimeExtensionInstance as b, createRuntimeContext as c, type SqlStatement as d, ensureSchemaStatement as e, ensureTableStatement as f, type Runtime as g, type RuntimeOptions as h, createRuntime as i, readContractMarker as r, writeContractMarker as w };

package/dist/test/utils.d.ts

@@ -3,10 +3,11 @@ 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 { f as createRuntime, S as SqlStatement, E as Extension, R as RuntimeContext } from '../sql-runtime-BRjzQkEs.js';
+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';
 
@@ -38,9 +39,12 @@ declare function writeTestContractMarker(client: Client, contract: SqlContract<S
 /**
  * Creates a runtime context with standard test configuration.
  * 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.
  */
 declare function createTestContext<TContract extends SqlContract<SqlStorage>>(contract: TContract, adapter: Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>, options?: {
-    extensionPacks?: ReadonlyArray<Extension>;
+    extensionPacks?: ReadonlyArray<SqlRuntimeExtensionDescriptor<'postgres'>>;
 }): RuntimeContext<TContract>;
 /**
  * Creates a stub adapter for testing.

package/dist/test/utils.js

@@ -26,7 +26,7 @@ import {
   ensureSchemaStatement,
   ensureTableStatement,
   writeContractMarker
-} from "../chunk-CTXL77UQ.js";
+} from "../chunk-C6I3V3DM.js";
 import {
   __commonJS,
   __require,
@@ -24475,10 +24475,41 @@ async function writeTestContractMarker(client, contract) {
   });
   await executeStatement(client, write.insert);
 }
+function createTestAdapterDescriptor(adapter) {
+  return {
+    kind: "adapter",
+    id: "test-adapter",
+    version: "0.0.1",
+    familyId: "sql",
+    targetId: "postgres",
+    create() {
+      return Object.assign(
+        {
+          familyId: "sql",
+          targetId: "postgres"
+        },
+        adapter
+      );
+    }
+  };
+}
+function createTestTargetDescriptor() {
+  return {
+    kind: "target",
+    id: "postgres",
+    version: "0.0.1",
+    familyId: "sql",
+    targetId: "postgres",
+    create() {
+      return { familyId: "sql", targetId: "postgres" };
+    }
+  };
+}
 function createTestContext(contract, adapter, options) {
   return createRuntimeContext({
     contract,
-    adapter,
+    target: createTestTargetDescriptor(),
+    adapter: createTestAdapterDescriptor(adapter),
     extensionPacks: options?.extensionPacks ?? []
   });
 }