@prisma-next/core-execution-plane 0.3.0-dev.5 → 0.3.0-dev.50

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/types-DELFO9yp.d.mts

@@ -0,0 +1,104 @@
+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.
+ * Extends the base FamilyInstance for runtime-plane specific methods.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ */
+interface RuntimeFamilyInstance<TFamilyId extends string> extends FamilyInstance<TFamilyId> {}
+/**
+ * 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')
+ */
+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')
+ */
+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')
+ */
+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')
+ */
+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.
+ *
+ * @template TFamilyId - The family ID (e.g., 'sql', 'document')
+ * @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;
+}
+/**
+ * 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
+ */
+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
+ */
+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
+ */
+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
+ */
+interface RuntimeExtensionDescriptor<TFamilyId extends string, TTargetId extends string, TExtensionInstance extends RuntimeExtensionInstance<TFamilyId, TTargetId> = RuntimeExtensionInstance<TFamilyId, TTargetId>> extends ExtensionDescriptor<TFamilyId, TTargetId> {
+  create(): TExtensionInstance;
+}
+//#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,42 +1,47 @@
 {
   "name": "@prisma-next/core-execution-plane",
-  "version": "0.3.0-dev.5",
+  "version": "0.3.0-dev.50",
   "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.5",
-    "@prisma-next/contract": "0.3.0-dev.5"
+    "@prisma-next/contract": "0.3.0-dev.50",
+    "@prisma-next/core-control-plane": "0.3.0-dev.50"
   },
   "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",
     "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 && tsc --project tsconfig.build.json",
+    "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/stack.ts

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

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

@@ -127,20 +127,23 @@ export interface RuntimeAdapterDescriptor<
 
 /**
  * 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: unknown): TDriverInstance;
+  create(options?: TCreateOptions): TDriverInstance;
 }
 
 /**

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

@@ -1,2 +0,0 @@
-export { assertRuntimeContractRequirementsSatisfied } from '../framework-components';
-//# sourceMappingURL=framework-components.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"framework-components.d.ts","sourceRoot":"","sources":["../../src/exports/framework-components.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0CAA0C,EAAE,MAAM,yBAAyB,CAAC"}

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.d.ts

@@ -1,2 +0,0 @@
-export type { RuntimeAdapterDescriptor, RuntimeAdapterInstance, RuntimeDriverDescriptor, RuntimeDriverInstance, RuntimeExtensionDescriptor, RuntimeExtensionInstance, RuntimeFamilyDescriptor, RuntimeFamilyInstance, RuntimeTargetDescriptor, RuntimeTargetInstance, } from '../types';
-//# sourceMappingURL=types.d.ts.map

package/dist/exports/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/exports/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,wBAAwB,EACxB,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,UAAU,CAAC"}

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":[]}

package/dist/framework-components.d.ts

@@ -1,21 +0,0 @@
-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 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;
-//# sourceMappingURL=framework-components.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"framework-components.d.ts","sourceRoot":"","sources":["../src/framework-components.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;GAQG;AACH,wBAAgB,0CAA0C,CACxD,SAAS,SAAS,MAAM,EACxB,SAAS,SAAS,MAAM,EACxB,EACA,QAAQ,EACR,MAAM,EACN,MAAM,EACN,OAAO,EACP,cAAc,GACf,EAAE;IACD,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAClG,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACpD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC/D,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACjE,QAAQ,CAAC,cAAc,EAAE,SAAS,0BAA0B,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,CAAC;CACtF,GAAG,IAAI,CAyBP"}

package/dist/types.d.ts

@@ -1,102 +0,0 @@
-import type { AdapterDescriptor, AdapterInstance, DriverDescriptor, DriverInstance, ExtensionDescriptor, ExtensionInstance, FamilyDescriptor, FamilyInstance, TargetDescriptor, TargetInstance } from '@prisma-next/contract/framework-components';
-/**
- * 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> {
-}
-/**
- * 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> {
-}
-/**
- * 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).
- *
- * @template TFamilyId - The family ID (e.g., 'sql', 'document')
- * @template TTargetId - The target ID (e.g., 'postgres', 'mysql')
- * @template TDriverInstance - The driver instance type
- */
-export interface RuntimeDriverDescriptor<TFamilyId extends string, TTargetId extends string, TDriverInstance extends RuntimeDriverInstance<TFamilyId, TTargetId> = RuntimeDriverInstance<TFamilyId, TTargetId>> extends DriverDescriptor<TFamilyId, TTargetId> {
-    create(options: unknown): 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;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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