@prisma-next/core-execution-plane 0.3.0-dev.3 → 0.3.0-dev.31

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-CRenF7tV.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/{exports/types.d.ts → types-CRenF7tV.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,7 +75,7 @@ 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).
@@ -88,7 +85,7 @@ interface RuntimeAdapterDescriptor<TFamilyId extends string, TTargetId extends s
  * @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;
+  create(options: unknown): TDriverInstance;
 }
 /**
  * Descriptor for an execution/runtime-plane extension component (e.g., pgvector).
@@ -98,7 +95,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-CRenF7tV.d.mts.map

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

@@ -0,0 +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"}

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-CRenF7tV.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,41 @@
 {
   "name": "@prisma-next/core-execution-plane",
-  "version": "0.3.0-dev.3",
+  "version": "0.3.0-dev.31",
   "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.3",
-    "@prisma-next/contract": "0.3.0-dev.3"
+    "@prisma-next/contract": "0.3.0-dev.31",
+    "@prisma-next/core-control-plane": "0.3.0-dev.31"
   },
   "devDependencies": {
-    "@vitest/coverage-v8": "^4.0.0",
-    "tsup": "^8.3.0",
-    "typescript": "^5.9.3",
-    "vitest": "^4.0.16",
-    "@prisma-next/test-utils": "0.0.1"
+    "tsdown": "0.18.4",
+    "typescript": "5.9.3",
+    "vitest": "4.0.16",
+    "@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",
+    "./types": "./dist/types.mjs",
+    "./package.json": "./package.json"
   },
   "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/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/types.ts

@@ -0,0 +1,162 @@
+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).
+ *
+ * @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;
+}

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