@prisma-next/core-execution-plane 0.3.0-dev.4 → 0.3.0-dev.41

package/README.md

@@ -4,12 +4,14 @@ Execution/runtime plane descriptor and instance types for Prisma Next.
 
 ## Overview
 
-This package provides TypeScript type definitions for execution/runtime-plane descriptors and instances. These types define the structure for runtime components (families, targets, adapters, drivers, extensions) that are used during query execution.
+This package provides TypeScript type definitions for execution/runtime-plane descriptors and instances. These types define the structure for runtime components (families, targets, adapters, drivers, extensions) and the descriptors-only execution stack that is instantiated by applications.
 
 ## Responsibilities
 
 - **Runtime Instance Types**: Base interfaces for runtime plane instances (`RuntimeFamilyInstance`, `RuntimeTargetInstance`, `RuntimeAdapterInstance`, `RuntimeDriverInstance`, `RuntimeExtensionInstance`)
 - **Runtime Descriptor Types**: Type definitions for runtime plane descriptors (`RuntimeFamilyDescriptor`, `RuntimeTargetDescriptor`, `RuntimeAdapterDescriptor`, `RuntimeDriverDescriptor`, `RuntimeExtensionDescriptor`)
+- **Execution Stack Types**: Descriptors-only execution stack (`ExecutionStack`) and instantiated stack (`ExecutionStackInstance`)
+- **Stack Instantiation**: Helper to instantiate a stack (`instantiateExecutionStack`). When stack has a driver descriptor, instance includes unbound `driver`; caller connects at boundary then passes driver to runtime.
 
 ## Dependencies
 
@@ -77,6 +79,26 @@ import type { RuntimeAdapterInstance } from '@prisma-next/core-execution-plane/t
 const adapter: RuntimeAdapterInstance<'sql', 'postgres'> = adapterDescriptor.create();
 ```
 
+### Execution Stack
+
+Execution stacks group runtime descriptors and are instantiated explicitly. When the stack has a driver descriptor, `instantiateExecutionStack` includes an unbound driver; connect at the boundary then create runtime:
+
+```typescript
+import { createExecutionStack, instantiateExecutionStack } from '@prisma-next/core-execution-plane/stack';
+
+const stack = createExecutionStack({
+  target: postgresTarget,
+  adapter: postgresAdapter,
+  driver: postgresDriver,
+  extensionPacks: [],
+});
+
+const stackInstance = instantiateExecutionStack(stack);
+// stackInstance.driver is unbound; caller connects at boundary:
+await stackInstance.driver!.connect(binding);
+// then createRuntime({ stackInstance, context, driver: stackInstance.driver, ... })
+```
+
 ## Package Location
 
 This package is part of the **framework domain**, **core layer**, **runtime plane**:
@@ -87,7 +109,8 @@ This package is part of the **framework domain**, **core layer**, **runtime plan
 
 ## Related Documentation
 
-- `docs/architecture docs/adrs/ADR 152 - Runtime Plane Descriptors and Instances.md`: Complete ADR specification
+- [ADR 152 — Execution Plane Descriptors and Instances](../../../../docs/architecture%20docs/adrs/ADR%20152%20-%20Execution%20Plane%20Descriptors%20and%20Instances.md)
+- [ADR 159 — Driver Terminology and Lifecycle](../../../../docs/architecture%20docs/adrs/ADR%20159%20-%20Driver%20Terminology%20and%20Lifecycle.md): Driver instantiation vs connection binding
 - `.cursor/rules/multi-plane-packages.mdc`: Multi-plane package structure
 - `packages/1-framework/1-core/migration/control-plane/README.md`: Control plane counterpart
 

package/dist/framework-components.d.mts

@@ -0,0 +1,32 @@
+import { a as RuntimeExtensionDescriptor, l as RuntimeTargetDescriptor, s as RuntimeFamilyDescriptor, t as RuntimeAdapterDescriptor } from "./types-DELFO9yp.mjs";
+
+//#region src/framework-components.d.ts
+
+/**
+ * Asserts that runtime component descriptors satisfy contract requirements.
+ *
+ * Routes the same framework composition through validation as control-plane:
+ * family, target, adapter, extensionPacks (all as descriptors with IDs).
+ *
+ * @throws Error if contract target doesn't match the provided target descriptor
+ * @throws Error if contract requires extension packs not provided in descriptors
+ */
+declare function assertRuntimeContractRequirementsSatisfied<TFamilyId extends string, TTargetId extends string>({
+  contract,
+  family,
+  target,
+  adapter,
+  extensionPacks
+}: {
+  readonly contract: {
+    readonly target: string;
+    readonly extensionPacks?: Record<string, unknown>;
+  };
+  readonly family: RuntimeFamilyDescriptor<TFamilyId>;
+  readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;
+  readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId>;
+  readonly extensionPacks: readonly RuntimeExtensionDescriptor<TFamilyId, TTargetId>[];
+}): void;
+//#endregion
+export { assertRuntimeContractRequirementsSatisfied };
+//# sourceMappingURL=framework-components.d.mts.map

package/dist/framework-components.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-components.d.mts","names":[],"sources":["../src/framework-components.ts"],"sourcesContent":[],"mappings":";;;;;;AAkBA;;;;;;;AAW2C,iBAX3B,0CAW2B,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,CAAA;EAAA,QAAA;EAAA,MAAA;EAAA,MAAA;EAAA,OAAA;EAAA;CAAA,EAAA;EAAxB,SAAA,QAAA,EAAA;IACwB,SAAA,MAAA,EAAA,MAAA;IAAW,SAAA,cAAA,CAAA,EAFoB,MAEpB,CAAA,MAAA,EAAA,OAAA,CAAA;EAAnC,CAAA;EAC0B,SAAA,MAAA,EAF1B,uBAE0B,CAFF,SAEE,CAAA;EAAW,SAAA,MAAA,EADrC,uBACqC,CADb,SACa,EADF,SACE,CAAA;EAApC,SAAA,OAAA,EAAA,wBAAA,CAAyB,SAAzB,EAAoC,SAApC,CAAA;EAC2C,SAAA,cAAA,EAAA,SAA3B,0BAA2B,CAAA,SAAA,EAAW,SAAX,CAAA,EAAA;CAAW,CAAA,EAAA,IAAA"}

package/dist/framework-components.mjs

@@ -0,0 +1,31 @@
+import { checkContractComponentRequirements } from "@prisma-next/contract/framework-components";
+
+//#region src/framework-components.ts
+/**
+* Asserts that runtime component descriptors satisfy contract requirements.
+*
+* Routes the same framework composition through validation as control-plane:
+* family, target, adapter, extensionPacks (all as descriptors with IDs).
+*
+* @throws Error if contract target doesn't match the provided target descriptor
+* @throws Error if contract requires extension packs not provided in descriptors
+*/
+function assertRuntimeContractRequirementsSatisfied({ contract, family, target, adapter, extensionPacks }) {
+	const providedComponentIds = new Set([
+		family.id,
+		target.id,
+		adapter.id
+	]);
+	for (const extension of extensionPacks) providedComponentIds.add(extension.id);
+	const result = checkContractComponentRequirements({
+		contract,
+		expectedTargetId: target.targetId,
+		providedComponentIds
+	});
+	if (result.targetMismatch) throw new Error(`Contract target '${result.targetMismatch.actual}' does not match runtime target descriptor '${result.targetMismatch.expected}'.`);
+	for (const packId of result.missingExtensionPackIds) throw new Error(`Contract requires extension pack '${packId}', but runtime descriptors do not provide a matching component.`);
+}
+
+//#endregion
+export { assertRuntimeContractRequirementsSatisfied };
+//# sourceMappingURL=framework-components.mjs.map

package/dist/framework-components.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-components.mjs","names":[],"sources":["../src/framework-components.ts"],"sourcesContent":["import { checkContractComponentRequirements } from '@prisma-next/contract/framework-components';\n\nimport type {\n  RuntimeAdapterDescriptor,\n  RuntimeExtensionDescriptor,\n  RuntimeFamilyDescriptor,\n  RuntimeTargetDescriptor,\n} from './types';\n\n/**\n * Asserts that runtime component descriptors satisfy contract requirements.\n *\n * Routes the same framework composition through validation as control-plane:\n * family, target, adapter, extensionPacks (all as descriptors with IDs).\n *\n * @throws Error if contract target doesn't match the provided target descriptor\n * @throws Error if contract requires extension packs not provided in descriptors\n */\nexport function assertRuntimeContractRequirementsSatisfied<\n  TFamilyId extends string,\n  TTargetId extends string,\n>({\n  contract,\n  family,\n  target,\n  adapter,\n  extensionPacks,\n}: {\n  readonly contract: { readonly target: string; readonly extensionPacks?: Record<string, unknown> };\n  readonly family: RuntimeFamilyDescriptor<TFamilyId>;\n  readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;\n  readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId>;\n  readonly extensionPacks: readonly RuntimeExtensionDescriptor<TFamilyId, TTargetId>[];\n}): void {\n  // Build set of provided component IDs from descriptors\n  const providedComponentIds = new Set<string>([family.id, target.id, adapter.id]);\n  for (const extension of extensionPacks) {\n    providedComponentIds.add(extension.id);\n  }\n\n  const result = checkContractComponentRequirements({\n    contract,\n    expectedTargetId: target.targetId,\n    providedComponentIds,\n  });\n\n  if (result.targetMismatch) {\n    throw new Error(\n      `Contract target '${result.targetMismatch.actual}' does not match runtime target descriptor '${result.targetMismatch.expected}'.`,\n    );\n  }\n\n  // Strict enforcement: all extension packs required by contract must be provided as descriptors\n  for (const packId of result.missingExtensionPackIds) {\n    throw new Error(\n      `Contract requires extension pack '${packId}', but runtime descriptors do not provide a matching component.`,\n    );\n  }\n}\n"],"mappings":";;;;;;;;;;;;AAkBA,SAAgB,2CAGd,EACA,UACA,QACA,QACA,SACA,kBAOO;CAEP,MAAM,uBAAuB,IAAI,IAAY;EAAC,OAAO;EAAI,OAAO;EAAI,QAAQ;EAAG,CAAC;AAChF,MAAK,MAAM,aAAa,eACtB,sBAAqB,IAAI,UAAU,GAAG;CAGxC,MAAM,SAAS,mCAAmC;EAChD;EACA,kBAAkB,OAAO;EACzB;EACD,CAAC;AAEF,KAAI,OAAO,eACT,OAAM,IAAI,MACR,oBAAoB,OAAO,eAAe,OAAO,8CAA8C,OAAO,eAAe,SAAS,IAC/H;AAIH,MAAK,MAAM,UAAU,OAAO,wBAC1B,OAAM,IAAI,MACR,qCAAqC,OAAO,iEAC7C"}

package/dist/stack.d.mts

@@ -0,0 +1,31 @@
+import { a as RuntimeExtensionDescriptor, i as RuntimeDriverInstance, l as RuntimeTargetDescriptor, n as RuntimeAdapterInstance, o as RuntimeExtensionInstance, r as RuntimeDriverDescriptor, t as RuntimeAdapterDescriptor, u as RuntimeTargetInstance } from "./types-DELFO9yp.mjs";
+
+//#region src/stack.d.ts
+interface ExecutionStack<TFamilyId extends string, TTargetId extends string, TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId> = RuntimeAdapterInstance<TFamilyId, TTargetId>, TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<TFamilyId, TTargetId>, TExtensionInstance extends RuntimeExtensionInstance<TFamilyId, TTargetId> = RuntimeExtensionInstance<TFamilyId, TTargetId>> {
+  readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;
+  readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId, TAdapterInstance>;
+  readonly driver: RuntimeDriverDescriptor<TFamilyId, TTargetId, unknown, TDriverInstance> | undefined;
+  readonly extensionPacks: readonly RuntimeExtensionDescriptor<TFamilyId, TTargetId, TExtensionInstance>[];
+}
+interface ExecutionStackInstance<TFamilyId extends string, TTargetId extends string, TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId> = RuntimeAdapterInstance<TFamilyId, TTargetId>, TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<TFamilyId, TTargetId>, TExtensionInstance extends RuntimeExtensionInstance<TFamilyId, TTargetId> = RuntimeExtensionInstance<TFamilyId, TTargetId>> {
+  readonly stack: ExecutionStack<TFamilyId, TTargetId, TAdapterInstance, TDriverInstance, TExtensionInstance>;
+  readonly target: RuntimeTargetInstance<TFamilyId, TTargetId>;
+  readonly adapter: TAdapterInstance;
+  readonly driver: TDriverInstance | undefined;
+  readonly extensionPacks: readonly TExtensionInstance[];
+}
+declare function createExecutionStack<TFamilyId extends string, TTargetId extends string, TTargetInstance extends RuntimeTargetInstance<TFamilyId, TTargetId>, TTargetDescriptor extends RuntimeTargetDescriptor<TFamilyId, TTargetId, TTargetInstance>, TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId>, TAdapterDescriptor extends RuntimeAdapterDescriptor<TFamilyId, TTargetId, TAdapterInstance>, TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<TFamilyId, TTargetId>, TDriverDescriptor extends RuntimeDriverDescriptor<TFamilyId, TTargetId, unknown, TDriverInstance> | undefined = undefined, TExtensionInstance extends RuntimeExtensionInstance<TFamilyId, TTargetId> = RuntimeExtensionInstance<TFamilyId, TTargetId>, TExtensionDescriptor extends RuntimeExtensionDescriptor<TFamilyId, TTargetId, TExtensionInstance> = never>(input: {
+  readonly target: TTargetDescriptor;
+  readonly adapter: TAdapterDescriptor;
+  readonly driver?: TDriverDescriptor | undefined;
+  readonly extensionPacks?: readonly TExtensionDescriptor[] | undefined;
+}): ExecutionStack<TFamilyId, TTargetId, TAdapterInstance, TDriverInstance, TExtensionInstance> & {
+  readonly target: TTargetDescriptor;
+  readonly adapter: TAdapterDescriptor;
+  readonly driver: TDriverDescriptor | undefined;
+  readonly extensionPacks: readonly TExtensionDescriptor[];
+};
+declare function instantiateExecutionStack<TFamilyId extends string, TTargetId extends string, TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId>, TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId>, TExtensionInstance extends RuntimeExtensionInstance<TFamilyId, TTargetId>>(stack: ExecutionStack<TFamilyId, TTargetId, TAdapterInstance, TDriverInstance, TExtensionInstance>): ExecutionStackInstance<TFamilyId, TTargetId, TAdapterInstance, TDriverInstance, TExtensionInstance>;
+//#endregion
+export { type ExecutionStack, type ExecutionStackInstance, createExecutionStack, instantiateExecutionStack };
+//# sourceMappingURL=stack.d.mts.map

package/dist/stack.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.d.mts","names":[],"sources":["../src/stack.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/stack.mjs

@@ -0,0 +1,23 @@
+//#region src/stack.ts
+function createExecutionStack(input) {
+	return {
+		target: input.target,
+		adapter: input.adapter,
+		driver: input.driver,
+		extensionPacks: input.extensionPacks ?? []
+	};
+}
+function instantiateExecutionStack(stack) {
+	const driver = stack.driver ? stack.driver.create() : void 0;
+	return {
+		stack,
+		target: stack.target.create(),
+		adapter: stack.adapter.create(),
+		driver,
+		extensionPacks: stack.extensionPacks.map((descriptor) => descriptor.create())
+	};
+}
+
+//#endregion
+export { createExecutionStack, instantiateExecutionStack };
+//# sourceMappingURL=stack.mjs.map

package/dist/stack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack.mjs","names":[],"sources":["../src/stack.ts"],"sourcesContent":["import type {\n  RuntimeAdapterDescriptor,\n  RuntimeAdapterInstance,\n  RuntimeDriverDescriptor,\n  RuntimeDriverInstance,\n  RuntimeExtensionDescriptor,\n  RuntimeExtensionInstance,\n  RuntimeTargetDescriptor,\n  RuntimeTargetInstance,\n} from './types';\n\nexport interface ExecutionStack<\n  TFamilyId extends string,\n  TTargetId extends string,\n  TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId> = RuntimeAdapterInstance<\n    TFamilyId,\n    TTargetId\n  >,\n  TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<\n    TFamilyId,\n    TTargetId\n  >,\n  TExtensionInstance extends RuntimeExtensionInstance<\n    TFamilyId,\n    TTargetId\n  > = RuntimeExtensionInstance<TFamilyId, TTargetId>,\n> {\n  readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;\n  readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId, TAdapterInstance>;\n  readonly driver:\n    | RuntimeDriverDescriptor<TFamilyId, TTargetId, unknown, TDriverInstance>\n    | undefined;\n  readonly extensionPacks: readonly RuntimeExtensionDescriptor<\n    TFamilyId,\n    TTargetId,\n    TExtensionInstance\n  >[];\n}\n\nexport interface ExecutionStackInstance<\n  TFamilyId extends string,\n  TTargetId extends string,\n  TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId> = RuntimeAdapterInstance<\n    TFamilyId,\n    TTargetId\n  >,\n  TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<\n    TFamilyId,\n    TTargetId\n  >,\n  TExtensionInstance extends RuntimeExtensionInstance<\n    TFamilyId,\n    TTargetId\n  > = RuntimeExtensionInstance<TFamilyId, TTargetId>,\n> {\n  readonly stack: ExecutionStack<\n    TFamilyId,\n    TTargetId,\n    TAdapterInstance,\n    TDriverInstance,\n    TExtensionInstance\n  >;\n  readonly target: RuntimeTargetInstance<TFamilyId, TTargetId>;\n  readonly adapter: TAdapterInstance;\n  readonly driver: TDriverInstance | undefined;\n  readonly extensionPacks: readonly TExtensionInstance[];\n}\n\nexport function createExecutionStack<\n  TFamilyId extends string,\n  TTargetId extends string,\n  TTargetInstance extends RuntimeTargetInstance<TFamilyId, TTargetId>,\n  TTargetDescriptor extends RuntimeTargetDescriptor<TFamilyId, TTargetId, TTargetInstance>,\n  TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId>,\n  TAdapterDescriptor extends RuntimeAdapterDescriptor<TFamilyId, TTargetId, TAdapterInstance>,\n  TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<\n    TFamilyId,\n    TTargetId\n  >,\n  TDriverDescriptor extends\n    | RuntimeDriverDescriptor<TFamilyId, TTargetId, unknown, TDriverInstance>\n    | undefined = undefined,\n  TExtensionInstance extends RuntimeExtensionInstance<\n    TFamilyId,\n    TTargetId\n  > = RuntimeExtensionInstance<TFamilyId, TTargetId>,\n  TExtensionDescriptor extends RuntimeExtensionDescriptor<\n    TFamilyId,\n    TTargetId,\n    TExtensionInstance\n  > = never,\n>(input: {\n  readonly target: TTargetDescriptor;\n  readonly adapter: TAdapterDescriptor;\n  readonly driver?: TDriverDescriptor | undefined;\n  readonly extensionPacks?: readonly TExtensionDescriptor[] | undefined;\n}): ExecutionStack<TFamilyId, TTargetId, TAdapterInstance, TDriverInstance, TExtensionInstance> & {\n  readonly target: TTargetDescriptor;\n  readonly adapter: TAdapterDescriptor;\n  readonly driver: TDriverDescriptor | undefined;\n  readonly extensionPacks: readonly TExtensionDescriptor[];\n} {\n  return {\n    target: input.target,\n    adapter: input.adapter,\n    driver: input.driver,\n    extensionPacks: input.extensionPacks ?? [],\n  };\n}\n\nexport function instantiateExecutionStack<\n  TFamilyId extends string,\n  TTargetId extends string,\n  TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId>,\n  TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId>,\n  TExtensionInstance extends RuntimeExtensionInstance<TFamilyId, TTargetId>,\n>(\n  stack: ExecutionStack<\n    TFamilyId,\n    TTargetId,\n    TAdapterInstance,\n    TDriverInstance,\n    TExtensionInstance\n  >,\n): ExecutionStackInstance<\n  TFamilyId,\n  TTargetId,\n  TAdapterInstance,\n  TDriverInstance,\n  TExtensionInstance\n> {\n  const driver = stack.driver ? stack.driver.create() : undefined;\n\n  return {\n    stack,\n    target: stack.target.create(),\n    adapter: stack.adapter.create(),\n    driver,\n    extensionPacks: stack.extensionPacks.map((descriptor) => descriptor.create()),\n  };\n}\n"],"mappings":";AAoEA,SAAgB,qBAuBd,OAUA;AACA,QAAO;EACL,QAAQ,MAAM;EACd,SAAS,MAAM;EACf,QAAQ,MAAM;EACd,gBAAgB,MAAM,kBAAkB,EAAE;EAC3C;;AAGH,SAAgB,0BAOd,OAaA;CACA,MAAM,SAAS,MAAM,SAAS,MAAM,OAAO,QAAQ,GAAG;AAEtD,QAAO;EACL;EACA,QAAQ,MAAM,OAAO,QAAQ;EAC7B,SAAS,MAAM,QAAQ,QAAQ;EAC/B;EACA,gBAAgB,MAAM,eAAe,KAAK,eAAe,WAAW,QAAQ,CAAC;EAC9E"}

package/dist/{exports/types.d.ts → types-DELFO9yp.d.mts}

@@ -1,4 +1,6 @@
-import { AdapterInstance, AdapterDescriptor, DriverInstance, DriverDescriptor, ExtensionInstance, ExtensionDescriptor, FamilyInstance, FamilyDescriptor, TargetInstance, TargetDescriptor } from '@prisma-next/contract/framework-components';
+import { AdapterDescriptor, AdapterInstance, DriverDescriptor, DriverInstance, ExtensionDescriptor, ExtensionInstance, FamilyDescriptor, FamilyInstance, TargetDescriptor, TargetInstance } from "@prisma-next/contract/framework-components";
+
+//#region src/types.d.ts
 
 /**
  * Runtime-plane family instance interface.
@@ -6,8 +8,7 @@ import { AdapterInstance, AdapterDescriptor, DriverInstance, DriverDescriptor, E
  *
  * @template TFamilyId - The family ID (e.g., 'sql', 'document')
  */
-interface RuntimeFamilyInstance<TFamilyId extends string> extends FamilyInstance<TFamilyId> {
-}
+interface RuntimeFamilyInstance<TFamilyId extends string> extends FamilyInstance<TFamilyId> {}
 /**
  * Runtime-plane target instance interface.
  * Extends the base TargetInstance with runtime-plane specific behavior.
@@ -15,8 +16,7 @@ interface RuntimeFamilyInstance<TFamilyId extends string> extends FamilyInstance
  * @template TFamilyId - The family ID (e.g., 'sql', 'document')
  * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
  */
-interface RuntimeTargetInstance<TFamilyId extends string, TTargetId extends string> extends TargetInstance<TFamilyId, TTargetId> {
-}
+interface RuntimeTargetInstance<TFamilyId extends string, TTargetId extends string> extends TargetInstance<TFamilyId, TTargetId> {}
 /**
  * Runtime-plane adapter instance interface.
  * Extends the base AdapterInstance with runtime-plane specific behavior.
@@ -25,8 +25,7 @@ interface RuntimeTargetInstance<TFamilyId extends string, TTargetId extends stri
  * @template TFamilyId - The family ID (e.g., 'sql', 'document')
  * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
  */
-interface RuntimeAdapterInstance<TFamilyId extends string, TTargetId extends string> extends AdapterInstance<TFamilyId, TTargetId> {
-}
+interface RuntimeAdapterInstance<TFamilyId extends string, TTargetId extends string> extends AdapterInstance<TFamilyId, TTargetId> {}
 /**
  * Runtime-plane driver instance interface.
  * Extends the base DriverInstance with runtime-plane specific behavior.
@@ -34,8 +33,7 @@ interface RuntimeAdapterInstance<TFamilyId extends string, TTargetId extends str
  * @template TFamilyId - The family ID (e.g., 'sql', 'document')
  * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
  */
-interface RuntimeDriverInstance<TFamilyId extends string, TTargetId extends string> extends DriverInstance<TFamilyId, TTargetId> {
-}
+interface RuntimeDriverInstance<TFamilyId extends string, TTargetId extends string> extends DriverInstance<TFamilyId, TTargetId> {}
 /**
  * Runtime-plane extension instance interface.
  * Extends the base ExtensionInstance with runtime-plane specific behavior.
@@ -43,8 +41,7 @@ interface RuntimeDriverInstance<TFamilyId extends string, TTargetId extends stri
  * @template TFamilyId - The family ID (e.g., 'sql', 'document')
  * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
  */
-interface RuntimeExtensionInstance<TFamilyId extends string, TTargetId extends string> extends ExtensionInstance<TFamilyId, TTargetId> {
-}
+interface RuntimeExtensionInstance<TFamilyId extends string, TTargetId extends string> extends ExtensionInstance<TFamilyId, TTargetId> {}
 /**
  * Descriptor for an execution/runtime-plane family (e.g., SQL).
  * Provides factory method to create runtime family instance.
@@ -53,12 +50,12 @@ interface RuntimeExtensionInstance<TFamilyId extends string, TTargetId extends s
  * @template TFamilyInstance - The family instance type
  */
 interface RuntimeFamilyDescriptor<TFamilyId extends string, TFamilyInstance extends RuntimeFamilyInstance<TFamilyId> = RuntimeFamilyInstance<TFamilyId>> extends FamilyDescriptor<TFamilyId> {
-    create<TTargetId extends string>(options: {
-        readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;
-        readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId>;
-        readonly driver: RuntimeDriverDescriptor<TFamilyId, TTargetId>;
-        readonly extensionPacks: readonly RuntimeExtensionDescriptor<TFamilyId, TTargetId>[];
-    }): TFamilyInstance;
+  create<TTargetId extends string>(options: {
+    readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;
+    readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId>;
+    readonly driver: RuntimeDriverDescriptor<TFamilyId, TTargetId>;
+    readonly extensionPacks: readonly RuntimeExtensionDescriptor<TFamilyId, TTargetId>[];
+  }): TFamilyInstance;
 }
 /**
  * Descriptor for an execution/runtime-plane target component (e.g., Postgres target).
@@ -68,7 +65,7 @@ interface RuntimeFamilyDescriptor<TFamilyId extends string, TFamilyInstance exte
  * @template TTargetInstance - The target instance type
  */
 interface RuntimeTargetDescriptor<TFamilyId extends string, TTargetId extends string, TTargetInstance extends RuntimeTargetInstance<TFamilyId, TTargetId> = RuntimeTargetInstance<TFamilyId, TTargetId>> extends TargetDescriptor<TFamilyId, TTargetId> {
-    create(): TTargetInstance;
+  create(): TTargetInstance;
 }
 /**
  * Descriptor for an execution/runtime-plane adapter component (e.g., Postgres adapter).
@@ -78,17 +75,19 @@ interface RuntimeTargetDescriptor<TFamilyId extends string, TTargetId extends st
  * @template TAdapterInstance - The adapter instance type
  */
 interface RuntimeAdapterDescriptor<TFamilyId extends string, TTargetId extends string, TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId> = RuntimeAdapterInstance<TFamilyId, TTargetId>> extends AdapterDescriptor<TFamilyId, TTargetId> {
-    create(): TAdapterInstance;
+  create(): TAdapterInstance;
 }
 /**
  * Descriptor for an execution/runtime-plane driver component (e.g., Postgres driver).
+ * create() accepts optional driver-specific options; connection binding happens at connect time.
  *
  * @template TFamilyId - The family ID (e.g., 'sql', 'document')
  * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ * @template TCreateOptions - Optional options for create (no connection); default void
  * @template TDriverInstance - The driver instance type
  */
-interface RuntimeDriverDescriptor<TFamilyId extends string, TTargetId extends string, TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<TFamilyId, TTargetId>> extends DriverDescriptor<TFamilyId, TTargetId> {
-    create(options: unknown): TDriverInstance;
+interface RuntimeDriverDescriptor<TFamilyId extends string, TTargetId extends string, TCreateOptions = void, TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<TFamilyId, TTargetId>> extends DriverDescriptor<TFamilyId, TTargetId> {
+  create(options?: TCreateOptions): TDriverInstance;
 }
 /**
  * Descriptor for an execution/runtime-plane extension component (e.g., pgvector).
@@ -98,7 +97,8 @@ interface RuntimeDriverDescriptor<TFamilyId extends string, TTargetId extends st
  * @template TExtensionInstance - The extension instance type
  */
 interface RuntimeExtensionDescriptor<TFamilyId extends string, TTargetId extends string, TExtensionInstance extends RuntimeExtensionInstance<TFamilyId, TTargetId> = RuntimeExtensionInstance<TFamilyId, TTargetId>> extends ExtensionDescriptor<TFamilyId, TTargetId> {
-    create(): TExtensionInstance;
+  create(): TExtensionInstance;
 }
-
-export type { RuntimeAdapterDescriptor, RuntimeAdapterInstance, RuntimeDriverDescriptor, RuntimeDriverInstance, RuntimeExtensionDescriptor, RuntimeExtensionInstance, RuntimeFamilyDescriptor, RuntimeFamilyInstance, RuntimeTargetDescriptor, RuntimeTargetInstance };
+//#endregion
+export { RuntimeExtensionDescriptor as a, RuntimeFamilyInstance as c, RuntimeDriverInstance as i, RuntimeTargetDescriptor as l, RuntimeAdapterInstance as n, RuntimeExtensionInstance as o, RuntimeDriverDescriptor as r, RuntimeFamilyDescriptor as s, RuntimeAdapterDescriptor as t, RuntimeTargetInstance as u };
+//# sourceMappingURL=types-DELFO9yp.d.mts.map

package/dist/types-DELFO9yp.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-DELFO9yp.d.mts","names":[],"sources":["../src/types.ts"],"sourcesContent":[],"mappings":";;;;;;AAuBA;AAWA;;;AACU,UAZO,qBAYP,CAAA,kBAAA,MAAA,CAAA,SAZ+D,cAY/D,CAZ8E,SAY9E,CAAA,CAAA;AAUV;;;;;AAUA;;AACoC,UAtBnB,qBAsBmB,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,SArB1B,cAqB0B,CArBX,SAqBW,EArBA,SAqBA,CAAA,CAAA;;AASpC;;;;;AAcA;;AAE0B,UApCT,sBAoCS,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,SAnChB,eAmCgB,CAnCA,SAmCA,EAnCW,SAmCX,CAAA,CAAA;;;;;;;;AAIJ,UA9BL,qBA8BK,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,SA7BZ,cA6BY,CA7BG,SA6BH,EA7Bc,SA6Bd,CAAA,CAAA;;;;;;;;AAHI,UAjBT,wBAiBS,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,CAAA,SAhBhB,iBAgBgB,CAhBE,SAgBF,EAhBa,SAgBb,CAAA,CAAA,CAgB1B;;;;;;;;AAOsC,UA1BrB,uBA0BqB,CAAA,kBAAA,MAAA,EAAA,wBAxBZ,qBAwBY,CAxBU,SAwBV,CAAA,GAxBuB,qBAwBvB,CAxB6C,SAwB7C,CAAA,CAAA,SAvB5B,gBAuB4B,CAvBX,SAuBW,CAAA,CAAA;EAC1B,MAAA,CAAA,kBAAA,MAAA,CAAA,CAAA,OAAA,EAAA;IADF,SAAA,MAAA,EArBW,uBAqBX,CArBmC,SAqBnC,EArB8C,SAqB9C,CAAA;IAAgB,SAAA,OAAA,EApBJ,wBAoBI,CApBqB,SAoBrB,EApBgC,SAoBhC,CAAA;IAWT,SAAA,MAAA,EA9BI,uBA8BoB,CA9BI,SA8BJ,EA9Be,SA8Bf,CAAA;IAGS,SAAA,cAAA,EAAA,SAhCZ,0BAgCY,CAhCe,SAgCf,EAhC0B,SAgC1B,CAAA,EAAA;EAAW,CAAA,CAAA,EA/BvD,eA+BuD;;;;;;;;;AAIlC,UAzBV,uBAyBU,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,EAAA,wBAtBD,qBAsBC,CAtBqB,SAsBrB,EAtBgC,SAsBhC,CAAA,GAtB6C,qBAsB7C,CArBvB,SAqBuB,EApBvB,SAoBuB,CAAA,CAAA,SAlBjB,gBAkBiB,CAlBA,SAkBA,EAlBW,SAkBX,CAAA,CAAA;EAaV,MAAA,EAAA,EA9BL,eA8BK;;;;;;;;;AASE,UA7BF,wBA6BE,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,EAAA,yBA1BQ,sBA0BR,CA1B+B,SA0B/B,EA1B0C,SA0B1C,CAAA,GA1BuD,sBA0BvD,CAzBf,SAyBe,EAxBf,SAwBe,CAAA,CAAA,SAtBT,iBAsBS,CAtBS,SAsBT,EAtBoB,SAsBpB,CAAA,CAAA;EAAiB,MAAA,EAAA,EArBxB,gBAqBwB;;;AAUpC;;;;;;;;AAOyC,UA1BxB,uBA0BwB,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,EAAA,iBAAA,IAAA,EAAA,wBAtBf,qBAsBe,CAtBO,SAsBP,EAtBkB,SAsBlB,CAAA,GAtB+B,qBAsB/B,CArBrC,SAqBqC,EApBrC,SAoBqC,CAAA,CAAA,SAlB/B,gBAkB+B,CAlBd,SAkBc,EAlBH,SAkBG,CAAA,CAAA;EAC7B,MAAA,CAAA,OAAA,CAAA,EAlBO,cAkBP,CAAA,EAlBwB,eAkBxB;;;;;;;;;UARK,0GAGY,yBACzB,WACA,aACE,yBAAyB,WAAW,oBAChC,oBAAoB,WAAW;YAC7B"}

package/dist/types.d.mts

@@ -0,0 +1,2 @@
+import { a as RuntimeExtensionDescriptor, c as RuntimeFamilyInstance, i as RuntimeDriverInstance, l as RuntimeTargetDescriptor, n as RuntimeAdapterInstance, o as RuntimeExtensionInstance, r as RuntimeDriverDescriptor, s as RuntimeFamilyDescriptor, t as RuntimeAdapterDescriptor, u as RuntimeTargetInstance } from "./types-DELFO9yp.mjs";
+export { type RuntimeAdapterDescriptor, type RuntimeAdapterInstance, type RuntimeDriverDescriptor, type RuntimeDriverInstance, type RuntimeExtensionDescriptor, type RuntimeExtensionInstance, type RuntimeFamilyDescriptor, type RuntimeFamilyInstance, type RuntimeTargetDescriptor, type RuntimeTargetInstance };

package/dist/types.mjs

@@ -0,0 +1 @@
+export {  };

package/package.json

@@ -1,41 +1,47 @@
 {
   "name": "@prisma-next/core-execution-plane",
-  "version": "0.3.0-dev.4",
+  "version": "0.3.0-dev.41",
   "type": "module",
   "sideEffects": false,
   "description": "Execution/runtime plane descriptor and instance types for Prisma Next",
   "dependencies": {
-    "@prisma-next/core-control-plane": "0.3.0-dev.4",
-    "@prisma-next/contract": "0.3.0-dev.4"
+    "@prisma-next/core-control-plane": "0.3.0-dev.41",
+    "@prisma-next/contract": "0.3.0-dev.41"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "4.0.16",
-    "tsup": "8.5.1",
+    "tsdown": "0.18.4",
     "typescript": "5.9.3",
-    "vitest": "4.0.16",
-    "@prisma-next/test-utils": "0.0.1"
+    "vitest": "4.0.17",
+    "@prisma-next/test-utils": "0.0.1",
+    "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/tsdown": "0.0.0"
   },
   "files": [
-    "dist"
+    "dist",
+    "src"
   ],
+  "engines": {
+    "node": ">=20"
+  },
   "exports": {
-    "./types": {
-      "types": "./dist/exports/types.d.ts",
-      "import": "./dist/exports/types.js"
-    },
-    "./framework-components": {
-      "types": "./dist/exports/framework-components.d.ts",
-      "import": "./dist/exports/framework-components.js"
-    }
+    "./framework-components": "./dist/framework-components.mjs",
+    "./stack": "./dist/stack.mjs",
+    "./types": "./dist/types.mjs",
+    "./package.json": "./package.json"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prisma/prisma-next.git",
+    "directory": "packages/1-framework/1-core/runtime/execution-plane"
   },
   "scripts": {
-    "build": "tsup --config tsup.config.ts",
+    "build": "tsdown",
     "test": "vitest run --passWithNoTests",
     "test:coverage": "vitest run --coverage --passWithNoTests",
-    "typecheck": "tsc --project tsconfig.json --noEmit",
-    "lint": "biome check . --config-path ../../../../../biome.json --error-on-warnings",
-    "lint:fix": "biome check --write . --config-path ../../../biome.json",
-    "lint:fix:unsafe": "biome check --write --unsafe . --config-path ../../../biome.json",
-    "clean": "node ../../../../../scripts/clean.mjs"
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check . --error-on-warnings",
+    "lint:fix": "biome check --write .",
+    "lint:fix:unsafe": "biome check --write --unsafe .",
+    "clean": "rm -rf dist dist-tsc dist-tsc-prod coverage .tmp-output"
   }
 }

package/src/exports/framework-components.ts

@@ -0,0 +1 @@
+export { assertRuntimeContractRequirementsSatisfied } from '../framework-components';

package/src/exports/stack.ts

@@ -0,0 +1,2 @@
+export type { ExecutionStack, ExecutionStackInstance } from '../stack';
+export { createExecutionStack, instantiateExecutionStack } from '../stack';

package/src/exports/types.ts

@@ -0,0 +1,12 @@
+export type {
+  RuntimeAdapterDescriptor,
+  RuntimeAdapterInstance,
+  RuntimeDriverDescriptor,
+  RuntimeDriverInstance,
+  RuntimeExtensionDescriptor,
+  RuntimeExtensionInstance,
+  RuntimeFamilyDescriptor,
+  RuntimeFamilyInstance,
+  RuntimeTargetDescriptor,
+  RuntimeTargetInstance,
+} from '../types';

package/src/framework-components.ts

@@ -0,0 +1,59 @@
+import { checkContractComponentRequirements } from '@prisma-next/contract/framework-components';
+
+import type {
+  RuntimeAdapterDescriptor,
+  RuntimeExtensionDescriptor,
+  RuntimeFamilyDescriptor,
+  RuntimeTargetDescriptor,
+} from './types';
+
+/**
+ * Asserts that runtime component descriptors satisfy contract requirements.
+ *
+ * Routes the same framework composition through validation as control-plane:
+ * family, target, adapter, extensionPacks (all as descriptors with IDs).
+ *
+ * @throws Error if contract target doesn't match the provided target descriptor
+ * @throws Error if contract requires extension packs not provided in descriptors
+ */
+export function assertRuntimeContractRequirementsSatisfied<
+  TFamilyId extends string,
+  TTargetId extends string,
+>({
+  contract,
+  family,
+  target,
+  adapter,
+  extensionPacks,
+}: {
+  readonly contract: { readonly target: string; readonly extensionPacks?: Record<string, unknown> };
+  readonly family: RuntimeFamilyDescriptor<TFamilyId>;
+  readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;
+  readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId>;
+  readonly extensionPacks: readonly RuntimeExtensionDescriptor<TFamilyId, TTargetId>[];
+}): void {
+  // Build set of provided component IDs from descriptors
+  const providedComponentIds = new Set<string>([family.id, target.id, adapter.id]);
+  for (const extension of extensionPacks) {
+    providedComponentIds.add(extension.id);
+  }
+
+  const result = checkContractComponentRequirements({
+    contract,
+    expectedTargetId: target.targetId,
+    providedComponentIds,
+  });
+
+  if (result.targetMismatch) {
+    throw new Error(
+      `Contract target '${result.targetMismatch.actual}' does not match runtime target descriptor '${result.targetMismatch.expected}'.`,
+    );
+  }
+
+  // Strict enforcement: all extension packs required by contract must be provided as descriptors
+  for (const packId of result.missingExtensionPackIds) {
+    throw new Error(
+      `Contract requires extension pack '${packId}', but runtime descriptors do not provide a matching component.`,
+    );
+  }
+}

package/src/stack.ts

@@ -0,0 +1,141 @@
+import type {
+  RuntimeAdapterDescriptor,
+  RuntimeAdapterInstance,
+  RuntimeDriverDescriptor,
+  RuntimeDriverInstance,
+  RuntimeExtensionDescriptor,
+  RuntimeExtensionInstance,
+  RuntimeTargetDescriptor,
+  RuntimeTargetInstance,
+} from './types';
+
+export interface ExecutionStack<
+  TFamilyId extends string,
+  TTargetId extends string,
+  TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId> = RuntimeAdapterInstance<
+    TFamilyId,
+    TTargetId
+  >,
+  TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<
+    TFamilyId,
+    TTargetId
+  >,
+  TExtensionInstance extends RuntimeExtensionInstance<
+    TFamilyId,
+    TTargetId
+  > = RuntimeExtensionInstance<TFamilyId, TTargetId>,
+> {
+  readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;
+  readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId, TAdapterInstance>;
+  readonly driver:
+    | RuntimeDriverDescriptor<TFamilyId, TTargetId, unknown, TDriverInstance>
+    | undefined;
+  readonly extensionPacks: readonly RuntimeExtensionDescriptor<
+    TFamilyId,
+    TTargetId,
+    TExtensionInstance
+  >[];
+}
+
+export interface ExecutionStackInstance<
+  TFamilyId extends string,
+  TTargetId extends string,
+  TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId> = RuntimeAdapterInstance<
+    TFamilyId,
+    TTargetId
+  >,
+  TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<
+    TFamilyId,
+    TTargetId
+  >,
+  TExtensionInstance extends RuntimeExtensionInstance<
+    TFamilyId,
+    TTargetId
+  > = RuntimeExtensionInstance<TFamilyId, TTargetId>,
+> {
+  readonly stack: ExecutionStack<
+    TFamilyId,
+    TTargetId,
+    TAdapterInstance,
+    TDriverInstance,
+    TExtensionInstance
+  >;
+  readonly target: RuntimeTargetInstance<TFamilyId, TTargetId>;
+  readonly adapter: TAdapterInstance;
+  readonly driver: TDriverInstance | undefined;
+  readonly extensionPacks: readonly TExtensionInstance[];
+}
+
+export function createExecutionStack<
+  TFamilyId extends string,
+  TTargetId extends string,
+  TTargetInstance extends RuntimeTargetInstance<TFamilyId, TTargetId>,
+  TTargetDescriptor extends RuntimeTargetDescriptor<TFamilyId, TTargetId, TTargetInstance>,
+  TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId>,
+  TAdapterDescriptor extends RuntimeAdapterDescriptor<TFamilyId, TTargetId, TAdapterInstance>,
+  TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<
+    TFamilyId,
+    TTargetId
+  >,
+  TDriverDescriptor extends
+    | RuntimeDriverDescriptor<TFamilyId, TTargetId, unknown, TDriverInstance>
+    | undefined = undefined,
+  TExtensionInstance extends RuntimeExtensionInstance<
+    TFamilyId,
+    TTargetId
+  > = RuntimeExtensionInstance<TFamilyId, TTargetId>,
+  TExtensionDescriptor extends RuntimeExtensionDescriptor<
+    TFamilyId,
+    TTargetId,
+    TExtensionInstance
+  > = never,
+>(input: {
+  readonly target: TTargetDescriptor;
+  readonly adapter: TAdapterDescriptor;
+  readonly driver?: TDriverDescriptor | undefined;
+  readonly extensionPacks?: readonly TExtensionDescriptor[] | undefined;
+}): ExecutionStack<TFamilyId, TTargetId, TAdapterInstance, TDriverInstance, TExtensionInstance> & {
+  readonly target: TTargetDescriptor;
+  readonly adapter: TAdapterDescriptor;
+  readonly driver: TDriverDescriptor | undefined;
+  readonly extensionPacks: readonly TExtensionDescriptor[];
+} {
+  return {
+    target: input.target,
+    adapter: input.adapter,
+    driver: input.driver,
+    extensionPacks: input.extensionPacks ?? [],
+  };
+}
+
+export function instantiateExecutionStack<
+  TFamilyId extends string,
+  TTargetId extends string,
+  TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId>,
+  TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId>,
+  TExtensionInstance extends RuntimeExtensionInstance<TFamilyId, TTargetId>,
+>(
+  stack: ExecutionStack<
+    TFamilyId,
+    TTargetId,
+    TAdapterInstance,
+    TDriverInstance,
+    TExtensionInstance
+  >,
+): ExecutionStackInstance<
+  TFamilyId,
+  TTargetId,
+  TAdapterInstance,
+  TDriverInstance,
+  TExtensionInstance
+> {
+  const driver = stack.driver ? stack.driver.create() : undefined;
+
+  return {
+    stack,
+    target: stack.target.create(),
+    adapter: stack.adapter.create(),
+    driver,
+    extensionPacks: stack.extensionPacks.map((descriptor) => descriptor.create()),
+  };
+}

package/src/types.ts

@@ -0,0 +1,165 @@
+import type {
+  AdapterDescriptor,
+  AdapterInstance,
+  DriverDescriptor,
+  DriverInstance,
+  ExtensionDescriptor,
+  ExtensionInstance,
+  FamilyDescriptor,
+  FamilyInstance,
+  TargetDescriptor,
+  TargetInstance,
+} from '@prisma-next/contract/framework-components';
+
+// ============================================================================
+// Runtime*Instance Base Interfaces
+// ============================================================================
+
+/**
+ * Runtime-plane family instance interface.
+ * Extends the base FamilyInstance for runtime-plane specific methods.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ */
+export interface RuntimeFamilyInstance<TFamilyId extends string> extends FamilyInstance<TFamilyId> {
+  // Placeholder for future runtime-plane-specific methods
+}
+
+/**
+ * Runtime-plane target instance interface.
+ * Extends the base TargetInstance with runtime-plane specific behavior.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface RuntimeTargetInstance<TFamilyId extends string, TTargetId extends string>
+  extends TargetInstance<TFamilyId, TTargetId> {}
+
+/**
+ * Runtime-plane adapter instance interface.
+ * Extends the base AdapterInstance with runtime-plane specific behavior.
+ * Families extend this with family-specific adapter interfaces.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface RuntimeAdapterInstance<TFamilyId extends string, TTargetId extends string>
+  extends AdapterInstance<TFamilyId, TTargetId> {}
+
+/**
+ * Runtime-plane driver instance interface.
+ * Extends the base DriverInstance with runtime-plane specific behavior.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface RuntimeDriverInstance<TFamilyId extends string, TTargetId extends string>
+  extends DriverInstance<TFamilyId, TTargetId> {}
+
+/**
+ * Runtime-plane extension instance interface.
+ * Extends the base ExtensionInstance with runtime-plane specific behavior.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface RuntimeExtensionInstance<TFamilyId extends string, TTargetId extends string>
+  extends ExtensionInstance<TFamilyId, TTargetId> {}
+
+// ============================================================================
+// Runtime*Descriptor Interfaces (ADR 152)
+// ============================================================================
+
+/**
+ * Descriptor for an execution/runtime-plane family (e.g., SQL).
+ * Provides factory method to create runtime family instance.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TFamilyInstance - The family instance type
+ */
+export interface RuntimeFamilyDescriptor<
+  TFamilyId extends string,
+  TFamilyInstance extends RuntimeFamilyInstance<TFamilyId> = RuntimeFamilyInstance<TFamilyId>,
+> extends FamilyDescriptor<TFamilyId> {
+  create<TTargetId extends string>(options: {
+    readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;
+    readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId>;
+    readonly driver: RuntimeDriverDescriptor<TFamilyId, TTargetId>;
+    readonly extensionPacks: readonly RuntimeExtensionDescriptor<TFamilyId, TTargetId>[];
+  }): TFamilyInstance;
+}
+
+/**
+ * Descriptor for an execution/runtime-plane target component (e.g., Postgres target).
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ * @template TTargetInstance - The target instance type
+ */
+export interface RuntimeTargetDescriptor<
+  TFamilyId extends string,
+  TTargetId extends string,
+  TTargetInstance extends RuntimeTargetInstance<TFamilyId, TTargetId> = RuntimeTargetInstance<
+    TFamilyId,
+    TTargetId
+  >,
+> extends TargetDescriptor<TFamilyId, TTargetId> {
+  create(): TTargetInstance;
+}
+
+/**
+ * Descriptor for an execution/runtime-plane adapter component (e.g., Postgres adapter).
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ * @template TAdapterInstance - The adapter instance type
+ */
+export interface RuntimeAdapterDescriptor<
+  TFamilyId extends string,
+  TTargetId extends string,
+  TAdapterInstance extends RuntimeAdapterInstance<TFamilyId, TTargetId> = RuntimeAdapterInstance<
+    TFamilyId,
+    TTargetId
+  >,
+> extends AdapterDescriptor<TFamilyId, TTargetId> {
+  create(): TAdapterInstance;
+}
+
+/**
+ * Descriptor for an execution/runtime-plane driver component (e.g., Postgres driver).
+ * create() accepts optional driver-specific options; connection binding happens at connect time.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ * @template TCreateOptions - Optional options for create (no connection); default void
+ * @template TDriverInstance - The driver instance type
+ */
+export interface RuntimeDriverDescriptor<
+  TFamilyId extends string,
+  TTargetId extends string,
+  TCreateOptions = void,
+  TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<
+    TFamilyId,
+    TTargetId
+  >,
+> extends DriverDescriptor<TFamilyId, TTargetId> {
+  create(options?: TCreateOptions): TDriverInstance;
+}
+
+/**
+ * Descriptor for an execution/runtime-plane extension component (e.g., pgvector).
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
+ * @template TExtensionInstance - The extension instance type
+ */
+export interface RuntimeExtensionDescriptor<
+  TFamilyId extends string,
+  TTargetId extends string,
+  TExtensionInstance extends RuntimeExtensionInstance<
+    TFamilyId,
+    TTargetId
+  > = RuntimeExtensionInstance<TFamilyId, TTargetId>,
+> extends ExtensionDescriptor<TFamilyId, TTargetId> {
+  create(): TExtensionInstance;
+}

package/dist/exports/framework-components.d.ts

@@ -1,24 +0,0 @@
-import { RuntimeFamilyDescriptor, RuntimeTargetDescriptor, RuntimeAdapterDescriptor, RuntimeExtensionDescriptor } from './types.js';
-import '@prisma-next/contract/framework-components';
-
-/**
- * Asserts that runtime component descriptors satisfy contract requirements.
- *
- * Routes the same framework composition through validation as control-plane:
- * family, target, adapter, extensionPacks (all as descriptors with IDs).
- *
- * @throws Error if contract target doesn't match the provided target descriptor
- * @throws Error if contract requires extension packs not provided in descriptors
- */
-declare function assertRuntimeContractRequirementsSatisfied<TFamilyId extends string, TTargetId extends string>({ contract, family, target, adapter, extensionPacks, }: {
-    readonly contract: {
-        readonly target: string;
-        readonly extensionPacks?: Record<string, unknown>;
-    };
-    readonly family: RuntimeFamilyDescriptor<TFamilyId>;
-    readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;
-    readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId>;
-    readonly extensionPacks: readonly RuntimeExtensionDescriptor<TFamilyId, TTargetId>[];
-}): void;
-
-export { assertRuntimeContractRequirementsSatisfied };

package/dist/exports/framework-components.js

@@ -1,33 +0,0 @@
-// src/framework-components.ts
-import { checkContractComponentRequirements } from "@prisma-next/contract/framework-components";
-function assertRuntimeContractRequirementsSatisfied({
-  contract,
-  family,
-  target,
-  adapter,
-  extensionPacks
-}) {
-  const providedComponentIds = /* @__PURE__ */ new Set([family.id, target.id, adapter.id]);
-  for (const extension of extensionPacks) {
-    providedComponentIds.add(extension.id);
-  }
-  const result = checkContractComponentRequirements({
-    contract,
-    expectedTargetId: target.targetId,
-    providedComponentIds
-  });
-  if (result.targetMismatch) {
-    throw new Error(
-      `Contract target '${result.targetMismatch.actual}' does not match runtime target descriptor '${result.targetMismatch.expected}'.`
-    );
-  }
-  for (const packId of result.missingExtensionPackIds) {
-    throw new Error(
-      `Contract requires extension pack '${packId}', but runtime descriptors do not provide a matching component.`
-    );
-  }
-}
-export {
-  assertRuntimeContractRequirementsSatisfied
-};
-//# sourceMappingURL=framework-components.js.map

package/dist/exports/framework-components.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/framework-components.ts"],"sourcesContent":["import { checkContractComponentRequirements } from '@prisma-next/contract/framework-components';\n\nimport type {\n  RuntimeAdapterDescriptor,\n  RuntimeExtensionDescriptor,\n  RuntimeFamilyDescriptor,\n  RuntimeTargetDescriptor,\n} from './types';\n\n/**\n * Asserts that runtime component descriptors satisfy contract requirements.\n *\n * Routes the same framework composition through validation as control-plane:\n * family, target, adapter, extensionPacks (all as descriptors with IDs).\n *\n * @throws Error if contract target doesn't match the provided target descriptor\n * @throws Error if contract requires extension packs not provided in descriptors\n */\nexport function assertRuntimeContractRequirementsSatisfied<\n  TFamilyId extends string,\n  TTargetId extends string,\n>({\n  contract,\n  family,\n  target,\n  adapter,\n  extensionPacks,\n}: {\n  readonly contract: { readonly target: string; readonly extensionPacks?: Record<string, unknown> };\n  readonly family: RuntimeFamilyDescriptor<TFamilyId>;\n  readonly target: RuntimeTargetDescriptor<TFamilyId, TTargetId>;\n  readonly adapter: RuntimeAdapterDescriptor<TFamilyId, TTargetId>;\n  readonly extensionPacks: readonly RuntimeExtensionDescriptor<TFamilyId, TTargetId>[];\n}): void {\n  // Build set of provided component IDs from descriptors\n  const providedComponentIds = new Set<string>([family.id, target.id, adapter.id]);\n  for (const extension of extensionPacks) {\n    providedComponentIds.add(extension.id);\n  }\n\n  const result = checkContractComponentRequirements({\n    contract,\n    expectedTargetId: target.targetId,\n    providedComponentIds,\n  });\n\n  if (result.targetMismatch) {\n    throw new Error(\n      `Contract target '${result.targetMismatch.actual}' does not match runtime target descriptor '${result.targetMismatch.expected}'.`,\n    );\n  }\n\n  // Strict enforcement: all extension packs required by contract must be provided as descriptors\n  for (const packId of result.missingExtensionPackIds) {\n    throw new Error(\n      `Contract requires extension pack '${packId}', but runtime descriptors do not provide a matching component.`,\n    );\n  }\n}\n"],"mappings":";AAAA,SAAS,0CAA0C;AAkB5C,SAAS,2CAGd;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAMS;AAEP,QAAM,uBAAuB,oBAAI,IAAY,CAAC,OAAO,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;AAC/E,aAAW,aAAa,gBAAgB;AACtC,yBAAqB,IAAI,UAAU,EAAE;AAAA,EACvC;AAEA,QAAM,SAAS,mCAAmC;AAAA,IAChD;AAAA,IACA,kBAAkB,OAAO;AAAA,IACzB;AAAA,EACF,CAAC;AAED,MAAI,OAAO,gBAAgB;AACzB,UAAM,IAAI;AAAA,MACR,oBAAoB,OAAO,eAAe,MAAM,+CAA+C,OAAO,eAAe,QAAQ;AAAA,IAC/H;AAAA,EACF;AAGA,aAAW,UAAU,OAAO,yBAAyB;AACnD,UAAM,IAAI;AAAA,MACR,qCAAqC,MAAM;AAAA,IAC7C;AAAA,EACF;AACF;","names":[]}

package/dist/exports/types.js

@@ -1 +0,0 @@
-//# sourceMappingURL=types.js.map

package/dist/exports/types.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}