@prisma-next/core-execution-plane 0.3.0-dev.34 → 0.3.0-dev.35

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

@@ -1,4 +1,4 @@
-import { a as RuntimeExtensionDescriptor, l as RuntimeTargetDescriptor, s as RuntimeFamilyDescriptor, t as RuntimeAdapterDescriptor } from "./types-CRenF7tV.mjs";
+import { a as RuntimeExtensionDescriptor, l as RuntimeTargetDescriptor, s as RuntimeFamilyDescriptor, t as RuntimeAdapterDescriptor } from "./types-DELFO9yp.mjs";
 
 //#region src/framework-components.d.ts
 

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-CRenF7tV.d.mts → types-DELFO9yp.d.mts}

@@ -79,13 +79,15 @@ interface RuntimeAdapterDescriptor<TFamilyId extends string, TTargetId extends s
 }
 /**
  * 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).
@@ -99,4 +101,4 @@ interface RuntimeExtensionDescriptor<TFamilyId extends string, TTargetId extends
 }
 //#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-CRenF7tV.d.mts.map
+//# sourceMappingURL=types-DELFO9yp.d.mts.map

package/dist/{types-CRenF7tV.d.mts.map → types-DELFO9yp.d.mts.map}

@@ -1 +1 @@
-{"version":3,"file":"types-CRenF7tV.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;EAWV,MAAA,EAAA,EA5BL,eA4BK;;;;;;;;;AAQW,UA1BX,wBA0BW,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,EAAA,yBAvBD,sBAuBC,CAvBsB,SAuBtB,EAvBiC,SAuBjC,CAAA,GAvB8C,sBAuB9C,CAtBxB,SAsBwB,EArBxB,SAqBwB,CAAA,CAAA,SAnBlB,iBAmBkB,CAnBA,SAmBA,EAnBW,SAmBX,CAAA,CAAA;EADlB,MAAA,EAAA,EAjBE,gBAiBF;;AAWV;;;;;;;AAO8B,UAzBb,uBAyBa,CAAA,kBAAA,MAAA,EAAA,kBAAA,MAAA,EAAA,wBAtBJ,qBAsBI,CAtBkB,SAsBlB,EAtB6B,SAsB7B,CAAA,GAtB0C,qBAsB1C,CArB1B,SAqB0B,EApB1B,SAoB0B,CAAA,CAAA,SAlBpB,gBAkBoB,CAlBH,SAkBG,EAlBQ,SAkBR,CAAA,CAAA;EAAW,MAAA,CAAA,OAAA,EAAA,OAAA,CAAA,EAjBb,eAiBa;;;;;;;;;UAPxB,0GAGY,yBACzB,WACA,aACE,yBAAyB,WAAW,oBAChC,oBAAoB,WAAW;YAC7B"}
+{"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

@@ -1,2 +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-CRenF7tV.mjs";
+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/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@prisma-next/core-execution-plane",
-  "version": "0.3.0-dev.34",
+  "version": "0.3.0-dev.35",
   "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.34",
-    "@prisma-next/contract": "0.3.0-dev.34"
+    "@prisma-next/core-control-plane": "0.3.0-dev.35",
+    "@prisma-next/contract": "0.3.0-dev.35"
   },
   "devDependencies": {
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
-    "vitest": "4.0.16",
+    "vitest": "4.0.17",
     "@prisma-next/test-utils": "0.0.1",
     "@prisma-next/tsconfig": "0.0.0",
     "@prisma-next/tsdown": "0.0.0"
@@ -25,9 +25,15 @@
   },
   "exports": {
     "./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": "tsdown",
     "test": "vitest run --passWithNoTests",

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;
 }
 
 /**