@prisma-next/family-sql 0.3.0-dev.2 → 0.3.0-dev.21

package/dist/core/control-adapter.d.ts

@@ -0,0 +1,42 @@
+import type { ControlAdapterInstance, ControlDriverInstance } from '@prisma-next/core-control-plane/types';
+import type { SqlSchemaIR } from '@prisma-next/sql-schema-ir/types';
+/**
+ * SQL control adapter interface for control-plane operations.
+ * Implemented by target-specific adapters (e.g., Postgres, MySQL).
+ *
+ * @template TTarget - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface SqlControlAdapter<TTarget extends string = string> extends ControlAdapterInstance<'sql', TTarget> {
+    /**
+     * The target ID this adapter implements.
+     * Used for type tracking and runtime validation.
+     * @deprecated Use targetId from ControlAdapterInstance instead
+     */
+    readonly target: TTarget;
+    /**
+     * Introspects a database schema and returns a raw SqlSchemaIR.
+     *
+     * This is a pure schema discovery operation that queries the database catalog
+     * and returns the schema structure without type mapping or contract enrichment.
+     * Type mapping and enrichment are handled separately by enrichment helpers.
+     *
+     * @param driver - ControlDriverInstance instance for executing queries (target-specific)
+     * @param contractIR - Optional contract IR for contract-guided introspection (filtering, optimization)
+     * @param schema - Schema name to introspect (defaults to 'public')
+     * @returns Promise resolving to SqlSchemaIR representing the live database schema
+     */
+    introspect(driver: ControlDriverInstance<'sql', TTarget>, contractIR?: unknown, schema?: string): Promise<SqlSchemaIR>;
+}
+/**
+ * SQL control adapter descriptor interface.
+ * Provides a factory method to create control adapter instances.
+ *
+ * @template TTarget - The target ID (e.g., 'postgres', 'mysql')
+ */
+export interface SqlControlAdapterDescriptor<TTarget extends string = string> {
+    /**
+     * Creates a SQL control adapter instance for control-plane operations.
+     */
+    create(): SqlControlAdapter<TTarget>;
+}
+//# sourceMappingURL=control-adapter.d.ts.map

package/dist/core/control-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-adapter.d.ts","sourceRoot":"","sources":["../../src/core/control-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM,CAChE,SAAQ,sBAAsB,CAAC,KAAK,EAAE,OAAO,CAAC;IAC9C;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB;;;;;;;;;;;OAWG;IACH,UAAU,CACR,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,OAAO,CAAC,EAC7C,UAAU,CAAC,EAAE,OAAO,EACpB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB;AAED;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IAC1E;;OAEG;IACH,MAAM,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;CACtC"}

package/dist/core/descriptor.d.ts

@@ -0,0 +1,24 @@
+import type { ControlFamilyDescriptor, ControlPlaneStack } from '@prisma-next/core-control-plane/types';
+import { type SqlControlFamilyInstance } from './instance';
+/**
+ * SQL family descriptor implementation.
+ * Provides the SQL family hook and factory method.
+ */
+export declare class SqlFamilyDescriptor implements ControlFamilyDescriptor<'sql', SqlControlFamilyInstance> {
+    readonly kind: "family";
+    readonly id = "sql";
+    readonly familyId: "sql";
+    readonly version = "0.0.1";
+    readonly hook: {
+        readonly id: "sql";
+        readonly validateTypes: (ir: import("@prisma-next/contract/ir").ContractIR, _ctx: import("@prisma-next/contract/types").ValidationContext) => void;
+        readonly validateStructure: (ir: import("@prisma-next/contract/ir").ContractIR) => void;
+        readonly generateContractTypes: (ir: import("@prisma-next/contract/ir").ContractIR, codecTypeImports: ReadonlyArray<import("@prisma-next/contract/types").TypesImportSpec>, operationTypeImports: ReadonlyArray<import("@prisma-next/contract/types").TypesImportSpec>) => string;
+        readonly generateStorageType: (storage: import("@prisma-next/sql-contract/types").SqlStorage) => string;
+        readonly generateModelsType: (models: Record<string, import("@prisma-next/sql-contract/types").ModelDefinition> | undefined, storage: import("@prisma-next/sql-contract/types").SqlStorage) => string;
+        readonly generateRelationsType: (relations: Record<string, unknown> | undefined) => string;
+        readonly generateMappingsType: (models: Record<string, import("@prisma-next/sql-contract/types").ModelDefinition> | undefined, storage: import("@prisma-next/sql-contract/types").SqlStorage, codecTypes: string, operationTypes: string) => string;
+    };
+    create<TTargetId extends string>(stack: ControlPlaneStack<'sql', TTargetId>): SqlControlFamilyInstance;
+}
+//# sourceMappingURL=descriptor.d.ts.map

package/dist/core/descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"descriptor.d.ts","sourceRoot":"","sources":["../../src/core/descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,uCAAuC,CAAC;AAE/C,OAAO,EAA2B,KAAK,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAEpF;;;GAGG;AACH,qBAAa,mBACX,YAAW,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,CAAC;IAEnE,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,EAAE,SAAS;IACpB,QAAQ,CAAC,QAAQ,EAAG,KAAK,CAAU;IACnC,QAAQ,CAAC,OAAO,WAAW;IAC3B,QAAQ,CAAC,IAAI;;;;;;;;;MAAuB;IAEpC,MAAM,CAAC,SAAS,SAAS,MAAM,EAC7B,KAAK,EAAE,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,GACzC,wBAAwB;CAU5B"}

package/dist/{exports/instance-DiZi2k_2.d.ts → core/instance.d.ts}

@@ -1,18 +1,17 @@
-import { TargetBoundComponentDescriptor } from '@prisma-next/contract/framework-components';
-import { ContractIR } from '@prisma-next/contract/ir';
-import { OperationManifest } from '@prisma-next/contract/pack-manifest-types';
-import { TypesImportSpec } from '@prisma-next/contract/types';
-import { CoreSchemaView } from '@prisma-next/core-control-plane/schema-view';
-import { ControlFamilyInstance, ControlDriverInstance, VerifyDatabaseResult, OperationContext, VerifyDatabaseSchemaResult, SignDatabaseResult, EmitContractResult } from '@prisma-next/core-control-plane/types';
-import { OperationRegistry } from '@prisma-next/operations';
-import { SqlOperationSignature } from '@prisma-next/sql-operations';
-import { SqlSchemaIR } from '@prisma-next/sql-schema-ir/types';
-
+import type { TargetBoundComponentDescriptor } from '@prisma-next/contract/framework-components';
+import type { ContractIR } from '@prisma-next/contract/ir';
+import type { OperationManifest } from '@prisma-next/contract/pack-manifest-types';
+import type { TypesImportSpec } from '@prisma-next/contract/types';
+import type { CoreSchemaView } from '@prisma-next/core-control-plane/schema-view';
+import type { ControlAdapterDescriptor, ControlDriverInstance, ControlExtensionDescriptor, ControlFamilyInstance, ControlTargetDescriptor, EmitContractResult, OperationContext, SignDatabaseResult, VerifyDatabaseResult, VerifyDatabaseSchemaResult } from '@prisma-next/core-control-plane/types';
+import type { OperationRegistry } from '@prisma-next/operations';
+import type { SqlOperationSignature } from '@prisma-next/sql-operations';
+import type { SqlSchemaIR } from '@prisma-next/sql-schema-ir/types';
 /**
  * Converts an OperationManifest (descriptor declarative data) to a SqlOperationSignature.
  * This is SQL-family-specific conversion logic used by instance creation and test utilities.
  */
-declare function convertOperationManifest(manifest: OperationManifest): SqlOperationSignature;
+export declare function convertOperationManifest(manifest: OperationManifest): SqlOperationSignature;
 /**
  * Type metadata for SQL storage types.
  * Maps contract storage type IDs to native database types.
@@ -41,7 +40,7 @@ interface SqlFamilyInstanceState {
 /**
  * Options for schema verification.
  */
-interface SchemaVerifyOptions {
+export interface SchemaVerifyOptions {
     readonly driver: ControlDriverInstance<'sql', string>;
     readonly contractIR: unknown;
     readonly strict: boolean;
@@ -56,7 +55,7 @@ interface SchemaVerifyOptions {
  * SQL control family instance interface.
  * Extends ControlFamilyInstance with SQL-specific domain actions.
  */
-interface SqlControlFamilyInstance extends ControlFamilyInstance<'sql'>, SqlFamilyInstanceState {
+export interface SqlControlFamilyInstance extends ControlFamilyInstance<'sql'>, SqlFamilyInstanceState {
     /**
      * Validates a contract JSON and returns a validated ContractIR (without mappings).
      * Mappings are runtime-only and should not be part of ContractIR.
@@ -123,5 +122,19 @@ interface SqlControlFamilyInstance extends ControlFamilyInstance<'sql'>, SqlFami
         readonly contractIR: ContractIR | unknown;
     }): Promise<EmitContractResult>;
 }
-
-export { type SqlControlFamilyInstance as S, type SchemaVerifyOptions as a, convertOperationManifest as c };
+/**
+ * SQL family instance type.
+ * Maintains backward compatibility with FamilyInstance while implementing SqlControlFamilyInstance.
+ */
+export type SqlFamilyInstance = SqlControlFamilyInstance;
+interface CreateSqlFamilyInstanceOptions<TTargetId extends string> {
+    readonly target: ControlTargetDescriptor<'sql', TTargetId>;
+    readonly adapter: ControlAdapterDescriptor<'sql', TTargetId>;
+    readonly extensionPacks: readonly ControlExtensionDescriptor<'sql', TTargetId>[];
+}
+/**
+ * Creates a SQL family instance for control-plane operations.
+ */
+export declare function createSqlFamilyInstance<TTargetId extends string>(options: CreateSqlFamilyInstanceOptions<TTargetId>): SqlFamilyInstance;
+export {};
+//# sourceMappingURL=instance.d.ts.map

package/dist/core/instance.d.ts.map

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

package/dist/core/migrations/plan-helpers.d.ts

@@ -0,0 +1,20 @@
+import type { NotOk, Ok } from '@prisma-next/utils/result';
+import type { AnyRecord, CreateSqlMigrationPlanOptions, SqlMigrationPlan, SqlMigrationRunnerErrorCode, SqlMigrationRunnerFailure, SqlMigrationRunnerSuccessValue, SqlPlannerConflict, SqlPlannerFailureResult, SqlPlannerSuccessResult } from './types';
+export declare function createMigrationPlan<TTargetDetails>(options: CreateSqlMigrationPlanOptions<TTargetDetails>): SqlMigrationPlan<TTargetDetails>;
+export declare function plannerSuccess<TTargetDetails>(plan: SqlMigrationPlan<TTargetDetails>): SqlPlannerSuccessResult<TTargetDetails>;
+export declare function plannerFailure(conflicts: readonly SqlPlannerConflict[]): SqlPlannerFailureResult;
+/**
+ * Creates a successful migration runner result.
+ */
+export declare function runnerSuccess(value: {
+    operationsPlanned: number;
+    operationsExecuted: number;
+}): Ok<SqlMigrationRunnerSuccessValue>;
+/**
+ * Creates a failed migration runner result.
+ */
+export declare function runnerFailure(code: SqlMigrationRunnerErrorCode, summary: string, options?: {
+    why?: string;
+    meta?: AnyRecord;
+}): NotOk<SqlMigrationRunnerFailure>;
+//# sourceMappingURL=plan-helpers.d.ts.map

package/dist/core/migrations/plan-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/plan-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,KAAK,EACV,SAAS,EACT,6BAA6B,EAC7B,gBAAgB,EAIhB,2BAA2B,EAC3B,yBAAyB,EACzB,8BAA8B,EAC9B,kBAAkB,EAClB,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,SAAS,CAAC;AA8EjB,wBAAgB,mBAAmB,CAAC,cAAc,EAChD,OAAO,EAAE,6BAA6B,CAAC,cAAc,CAAC,GACrD,gBAAgB,CAAC,cAAc,CAAC,CAUlC;AAED,wBAAgB,cAAc,CAAC,cAAc,EAC3C,IAAI,EAAE,gBAAgB,CAAC,cAAc,CAAC,GACrC,uBAAuB,CAAC,cAAc,CAAC,CAKzC;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,GAAG,uBAAuB,CAehG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;CAC5B,GAAG,EAAE,CAAC,8BAA8B,CAAC,CAOrC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,2BAA2B,EACjC,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,CAAA;CAAE,GAC3C,KAAK,CAAC,yBAAyB,CAAC,CAQlC"}

package/dist/core/migrations/policies.d.ts

@@ -0,0 +1,6 @@
+import type { MigrationOperationPolicy } from '@prisma-next/core-control-plane/types';
+/**
+ * Policy used by `db init`: additive-only operations, no widening/destructive steps.
+ */
+export declare const INIT_ADDITIVE_POLICY: MigrationOperationPolicy;
+//# sourceMappingURL=policies.d.ts.map

package/dist/core/migrations/policies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policies.d.ts","sourceRoot":"","sources":["../../../src/core/migrations/policies.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEtF;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,wBAEjC,CAAC"}

package/dist/{exports/types-Bh7ftf0Q.d.ts → core/migrations/types.d.ts}

@@ -1,18 +1,16 @@
-import { TargetBoundComponentDescriptor } from '@prisma-next/contract/framework-components';
-import { ControlTargetDescriptor, ControlTargetInstance, MigrationOperationPolicy, MigrationPlannerSuccessResult, MigrationPlan, MigrationPlanOperation, MigrationPlannerFailureResult, MigrationPlannerConflict, ControlDriverInstance, OperationContext, MigrationRunnerExecutionChecks, MigrationRunnerSuccessValue, MigrationRunnerFailure, SchemaIssue, ControlExtensionDescriptor } from '@prisma-next/core-control-plane/types';
-import { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
-import { SqlSchemaIR } from '@prisma-next/sql-schema-ir/types';
-import { Result } from '@prisma-next/utils/result';
-import { S as SqlControlFamilyInstance } from './instance-DiZi2k_2.js';
-
 /**
  * SQL-specific migration types.
  *
  * These types extend the canonical migration types from the framework control plane
  * with SQL-specific fields for execution (precheck SQL, execute SQL, etc.).
  */
-
-type AnyRecord = Readonly<Record<string, unknown>>;
+import type { TargetBoundComponentDescriptor } from '@prisma-next/contract/framework-components';
+import type { ControlDriverInstance, ControlExtensionDescriptor, ControlTargetDescriptor, ControlTargetInstance, MigrationOperationPolicy, MigrationPlan, MigrationPlannerConflict, MigrationPlannerFailureResult, MigrationPlannerSuccessResult, MigrationPlanOperation, MigrationRunnerExecutionChecks, MigrationRunnerFailure, MigrationRunnerSuccessValue, OperationContext, SchemaIssue } from '@prisma-next/core-control-plane/types';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { SqlSchemaIR } from '@prisma-next/sql-schema-ir/types';
+import type { Result } from '@prisma-next/utils/result';
+import type { SqlControlFamilyInstance } from '../instance';
+export type AnyRecord = Readonly<Record<string, unknown>>;
 /**
  * A single database dependency declared by a framework component.
  * Uses SqlMigrationPlanOperation so we inherit the existing precheck/execute/postcheck contract.
@@ -22,7 +20,7 @@ type AnyRecord = Readonly<Record<string, unknown>>;
  * The planner emits these as migration operations, and the verifier uses the pure verification
  * hook to check satisfaction against the schema IR.
  */
-interface ComponentDatabaseDependency<TTargetDetails> {
+export interface ComponentDatabaseDependency<TTargetDetails> {
     /** Stable identifier for the dependency (e.g. 'postgres.extension.vector') */
     readonly id: string;
     /** Human label for output (e.g. 'Enable vector extension') */
@@ -43,13 +41,21 @@ interface ComponentDatabaseDependency<TTargetDetails> {
 /**
  * Database dependencies declared by a framework component.
  */
-interface ComponentDatabaseDependencies<TTargetDetails> {
+export interface ComponentDatabaseDependencies<TTargetDetails> {
     /**
      * Dependencies required for db init.
      * Future: update dependencies can be added later (e.g. widening/destructive).
      */
     readonly init?: readonly ComponentDatabaseDependency<TTargetDetails>[];
 }
+/**
+ * Minimal structural type implemented by any descriptor that can expose
+ * component-owned database dependencies. Targets/adapters typically omit
+ * the property, while extensions provide dependency metadata.
+ */
+export interface DatabaseDependencyProvider {
+    readonly databaseDependencies?: ComponentDatabaseDependencies<unknown>;
+}
 /**
  * SQL-specific extension descriptor with optional database dependencies.
  * Extends the core ControlExtensionDescriptor with SQL-specific metadata.
@@ -57,14 +63,14 @@ interface ComponentDatabaseDependencies<TTargetDetails> {
  * Database dependencies are attached to the descriptor (not the instance) because
  * they are declarative metadata that planner/verifier need without constructing instances.
  */
-interface SqlControlExtensionDescriptor<TTargetId extends string> extends ControlExtensionDescriptor<'sql', TTargetId> {
+export interface SqlControlExtensionDescriptor<TTargetId extends string> extends ControlExtensionDescriptor<'sql', TTargetId> {
     /** Optional database dependencies this extension requires. */
     readonly databaseDependencies?: ComponentDatabaseDependencies<unknown>;
 }
 /**
  * A single step in a SQL migration operation (precheck, execute, or postcheck).
  */
-interface SqlMigrationPlanOperationStep {
+export interface SqlMigrationPlanOperationStep {
     readonly description: string;
     readonly sql: string;
     readonly meta?: AnyRecord;
@@ -72,7 +78,7 @@ interface SqlMigrationPlanOperationStep {
 /**
  * Target details for a SQL migration operation (table, column, index, etc.).
  */
-interface SqlMigrationPlanOperationTarget<TTargetDetails> {
+export interface SqlMigrationPlanOperationTarget<TTargetDetails> {
     readonly id: string;
     readonly details?: TTargetDetails;
 }
@@ -80,7 +86,7 @@ interface SqlMigrationPlanOperationTarget<TTargetDetails> {
  * A single SQL migration operation with SQL-specific fields.
  * Extends the core MigrationPlanOperation with SQL execution details.
  */
-interface SqlMigrationPlanOperation<TTargetDetails> extends MigrationPlanOperation {
+export interface SqlMigrationPlanOperation<TTargetDetails> extends MigrationPlanOperation {
     /** Optional detailed explanation of what this operation does and why. */
     readonly summary?: string;
     readonly target: SqlMigrationPlanOperationTarget<TTargetDetails>;
@@ -92,7 +98,7 @@ interface SqlMigrationPlanOperation<TTargetDetails> extends MigrationPlanOperati
 /**
  * Contract identity information for SQL migrations.
  */
-interface SqlMigrationPlanContractInfo {
+export interface SqlMigrationPlanContractInfo {
     readonly coreHash: string;
     readonly profileHash?: string;
 }
@@ -100,7 +106,7 @@ interface SqlMigrationPlanContractInfo {
  * A SQL migration plan with SQL-specific fields.
  * Extends the core MigrationPlan with origin tracking and metadata.
  */
-interface SqlMigrationPlan<TTargetDetails> extends MigrationPlan {
+export interface SqlMigrationPlan<TTargetDetails> extends MigrationPlan {
     /**
      * Origin contract identity that the plan expects the database to currently be at.
      * If omitted, the runner treats the origin as "no marker present" (empty database),
@@ -117,11 +123,11 @@ interface SqlMigrationPlan<TTargetDetails> extends MigrationPlan {
 /**
  * Specific conflict kinds for SQL migrations.
  */
-type SqlPlannerConflictKind = 'typeMismatch' | 'nullabilityConflict' | 'indexIncompatible' | 'foreignKeyConflict' | 'missingButNonAdditive' | 'unsupportedExtension' | 'extensionMissing' | 'unsupportedOperation';
+export type SqlPlannerConflictKind = 'typeMismatch' | 'nullabilityConflict' | 'indexIncompatible' | 'foreignKeyConflict' | 'missingButNonAdditive' | 'unsupportedExtension' | 'extensionMissing' | 'unsupportedOperation';
 /**
  * Location information for SQL planner conflicts.
  */
-interface SqlPlannerConflictLocation {
+export interface SqlPlannerConflictLocation {
     readonly table?: string;
     readonly column?: string;
     readonly index?: string;
@@ -132,7 +138,7 @@ interface SqlPlannerConflictLocation {
  * A SQL-specific planner conflict with additional location information.
  * Extends the core MigrationPlannerConflict.
  */
-interface SqlPlannerConflict extends MigrationPlannerConflict {
+export interface SqlPlannerConflict extends MigrationPlannerConflict {
     readonly kind: SqlPlannerConflictKind;
     readonly location?: SqlPlannerConflictLocation;
     readonly meta?: AnyRecord;
@@ -140,25 +146,25 @@ interface SqlPlannerConflict extends MigrationPlannerConflict {
 /**
  * Successful SQL planner result with the migration plan.
  */
-interface SqlPlannerSuccessResult<TTargetDetails> extends Omit<MigrationPlannerSuccessResult, 'plan'> {
+export interface SqlPlannerSuccessResult<TTargetDetails> extends Omit<MigrationPlannerSuccessResult, 'plan'> {
     readonly kind: 'success';
     readonly plan: SqlMigrationPlan<TTargetDetails>;
 }
 /**
  * Failed SQL planner result with the list of conflicts.
  */
-interface SqlPlannerFailureResult extends Omit<MigrationPlannerFailureResult, 'conflicts'> {
+export interface SqlPlannerFailureResult extends Omit<MigrationPlannerFailureResult, 'conflicts'> {
     readonly kind: 'failure';
     readonly conflicts: readonly SqlPlannerConflict[];
 }
 /**
  * Union type for SQL planner results.
  */
-type SqlPlannerResult<TTargetDetails> = SqlPlannerSuccessResult<TTargetDetails> | SqlPlannerFailureResult;
+export type SqlPlannerResult<TTargetDetails> = SqlPlannerSuccessResult<TTargetDetails> | SqlPlannerFailureResult;
 /**
  * Options for SQL migration planner.
  */
-interface SqlMigrationPlannerPlanOptions {
+export interface SqlMigrationPlannerPlanOptions {
     readonly contract: SqlContract<SqlStorage>;
     readonly schema: SqlSchemaIR;
     readonly policy: MigrationOperationPolicy;
@@ -174,20 +180,20 @@ interface SqlMigrationPlannerPlanOptions {
  * SQL migration planner interface.
  * Extends the core MigrationPlanner with SQL-specific types.
  */
-interface SqlMigrationPlanner<TTargetDetails> {
+export interface SqlMigrationPlanner<TTargetDetails> {
     plan(options: SqlMigrationPlannerPlanOptions): SqlPlannerResult<TTargetDetails>;
 }
 /**
  * Callbacks for SQL migration runner execution.
  */
-interface SqlMigrationRunnerExecuteCallbacks<TTargetDetails> {
+export interface SqlMigrationRunnerExecuteCallbacks<TTargetDetails> {
     onOperationStart?(operation: SqlMigrationPlanOperation<TTargetDetails>): void;
     onOperationComplete?(operation: SqlMigrationPlanOperation<TTargetDetails>): void;
 }
 /**
  * Options for SQL migration runner execution.
  */
-interface SqlMigrationRunnerExecuteOptions<TTargetDetails> {
+export interface SqlMigrationRunnerExecuteOptions<TTargetDetails> {
     readonly plan: SqlMigrationPlan<TTargetDetails>;
     readonly driver: ControlDriverInstance<'sql', string>;
     /**
@@ -219,12 +225,12 @@ interface SqlMigrationRunnerExecuteOptions<TTargetDetails> {
 /**
  * Error codes for SQL migration runner failures.
  */
-type SqlMigrationRunnerErrorCode = 'DESTINATION_CONTRACT_MISMATCH' | 'MARKER_ORIGIN_MISMATCH' | 'POLICY_VIOLATION' | 'PRECHECK_FAILED' | 'POSTCHECK_FAILED' | 'SCHEMA_VERIFY_FAILED' | 'EXECUTION_FAILED';
+export type SqlMigrationRunnerErrorCode = 'DESTINATION_CONTRACT_MISMATCH' | 'MARKER_ORIGIN_MISMATCH' | 'POLICY_VIOLATION' | 'PRECHECK_FAILED' | 'POSTCHECK_FAILED' | 'SCHEMA_VERIFY_FAILED' | 'EXECUTION_FAILED';
 /**
  * Detailed information about a SQL migration runner failure.
  * Extends the core MigrationRunnerFailure with SQL-specific error codes.
  */
-interface SqlMigrationRunnerFailure extends MigrationRunnerFailure {
+export interface SqlMigrationRunnerFailure extends MigrationRunnerFailure {
     readonly code: SqlMigrationRunnerErrorCode;
     readonly meta?: AnyRecord;
 }
@@ -232,24 +238,24 @@ interface SqlMigrationRunnerFailure extends MigrationRunnerFailure {
  * Success value for SQL migration runner execution.
  * Extends core type for type branding and potential SQL-specific extensions.
  */
-interface SqlMigrationRunnerSuccessValue extends MigrationRunnerSuccessValue {
+export interface SqlMigrationRunnerSuccessValue extends MigrationRunnerSuccessValue {
 }
 /**
  * Result type for SQL migration runner execution.
  */
-type SqlMigrationRunnerResult = Result<SqlMigrationRunnerSuccessValue, SqlMigrationRunnerFailure>;
+export type SqlMigrationRunnerResult = Result<SqlMigrationRunnerSuccessValue, SqlMigrationRunnerFailure>;
 /**
  * SQL migration runner interface.
  * Extends the core MigrationRunner with SQL-specific types.
  */
-interface SqlMigrationRunner<TTargetDetails> {
+export interface SqlMigrationRunner<TTargetDetails> {
     execute(options: SqlMigrationRunnerExecuteOptions<TTargetDetails>): Promise<SqlMigrationRunnerResult>;
 }
 /**
  * SQL control target descriptor with migration support.
  * Extends the core ControlTargetDescriptor with SQL-specific migration methods.
  */
-interface SqlControlTargetDescriptor<TTargetId extends string, TTargetDetails> extends ControlTargetDescriptor<'sql', TTargetId, ControlTargetInstance<'sql', TTargetId>, SqlControlFamilyInstance> {
+export interface SqlControlTargetDescriptor<TTargetId extends string, TTargetDetails> extends ControlTargetDescriptor<'sql', TTargetId, ControlTargetInstance<'sql', TTargetId>, SqlControlFamilyInstance> {
     /**
      * Creates a SQL migration planner for this target.
      * Direct method for SQL-specific usage.
@@ -264,12 +270,11 @@ interface SqlControlTargetDescriptor<TTargetId extends string, TTargetDetails> e
 /**
  * Options for creating a SQL migration plan.
  */
-interface CreateSqlMigrationPlanOptions<TTargetDetails> {
+export interface CreateSqlMigrationPlanOptions<TTargetDetails> {
     readonly targetId: string;
     readonly origin?: SqlMigrationPlanContractInfo | null;
     readonly destination: SqlMigrationPlanContractInfo;
     readonly operations: readonly SqlMigrationPlanOperation<TTargetDetails>[];
     readonly meta?: AnyRecord;
 }
-
-export type { AnyRecord as A, CreateSqlMigrationPlanOptions as C, SqlControlTargetDescriptor as S, SqlMigrationPlan as a, SqlPlannerConflict as b, SqlPlannerFailureResult as c, SqlPlannerSuccessResult as d, SqlMigrationRunnerErrorCode as e, SqlMigrationRunnerFailure as f, SqlMigrationRunnerSuccessValue as g, ComponentDatabaseDependencies as h, ComponentDatabaseDependency as i, SqlControlExtensionDescriptor as j, SqlMigrationPlanContractInfo as k, SqlMigrationPlanner as l, SqlMigrationPlannerPlanOptions as m, SqlMigrationPlanOperation as n, SqlMigrationPlanOperationStep as o, SqlMigrationPlanOperationTarget as p, SqlMigrationRunner as q, SqlMigrationRunnerExecuteCallbacks as r, SqlMigrationRunnerExecuteOptions as s, SqlMigrationRunnerResult as t, SqlPlannerConflictKind as u, SqlPlannerConflictLocation as v, SqlPlannerResult as w };
+//# sourceMappingURL=types.d.ts.map

package/dist/core/migrations/types.d.ts.map

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

package/dist/core/runtime-descriptor.d.ts

@@ -0,0 +1,19 @@
+import type { RuntimeAdapterDescriptor, RuntimeDriverDescriptor, RuntimeExtensionDescriptor, RuntimeFamilyDescriptor, RuntimeTargetDescriptor } from '@prisma-next/core-execution-plane/types';
+import { type SqlRuntimeAdapterInstance, type SqlRuntimeDriverInstance, type SqlRuntimeFamilyInstance } from './runtime-instance';
+/**
+ * SQL runtime family descriptor implementation.
+ * Provides factory method to create SQL runtime family instance.
+ */
+export declare class SqlRuntimeFamilyDescriptor implements RuntimeFamilyDescriptor<'sql', SqlRuntimeFamilyInstance> {
+    readonly kind: "family";
+    readonly id = "sql";
+    readonly familyId: "sql";
+    readonly version = "0.0.1";
+    create<TTargetId extends string>(options: {
+        readonly target: RuntimeTargetDescriptor<'sql', TTargetId>;
+        readonly adapter: RuntimeAdapterDescriptor<'sql', TTargetId, SqlRuntimeAdapterInstance<TTargetId>>;
+        readonly driver: RuntimeDriverDescriptor<'sql', TTargetId, SqlRuntimeDriverInstance<TTargetId>>;
+        readonly extensionPacks: readonly RuntimeExtensionDescriptor<'sql', TTargetId>[];
+    }): SqlRuntimeFamilyInstance;
+}
+//# sourceMappingURL=runtime-descriptor.d.ts.map

package/dist/core/runtime-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-descriptor.d.ts","sourceRoot":"","sources":["../../src/core/runtime-descriptor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAEL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC9B,MAAM,oBAAoB,CAAC;AAE5B;;;GAGG;AACH,qBAAa,0BACX,YAAW,uBAAuB,CAAC,KAAK,EAAE,wBAAwB,CAAC;IAEnE,QAAQ,CAAC,IAAI,EAAG,QAAQ,CAAU;IAClC,QAAQ,CAAC,EAAE,SAAS;IACpB,QAAQ,CAAC,QAAQ,EAAG,KAAK,CAAU;IACnC,QAAQ,CAAC,OAAO,WAAW;IAE3B,MAAM,CAAC,SAAS,SAAS,MAAM,EAAE,OAAO,EAAE;QACxC,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC3D,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CACxC,KAAK,EACL,SAAS,EACT,yBAAyB,CAAC,SAAS,CAAC,CACrC,CAAC;QACF,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAAC;QAChG,QAAQ,CAAC,cAAc,EAAE,SAAS,0BAA0B,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;KAClF,GAAG,wBAAwB;CAS7B"}

package/dist/core/runtime-instance.d.ts

@@ -0,0 +1,54 @@
+import type { RuntimeAdapterDescriptor, RuntimeDriverDescriptor, RuntimeDriverInstance, RuntimeFamilyDescriptor, RuntimeFamilyInstance, RuntimeTargetDescriptor } from '@prisma-next/core-execution-plane/types';
+import type { Log, Plugin, RuntimeVerifyOptions } from '@prisma-next/runtime-executor';
+import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
+import type { Adapter, LoweredStatement, SelectAst, SqlDriver } from '@prisma-next/sql-relational-core/ast';
+import type { Runtime, SqlRuntimeAdapterInstance, SqlRuntimeExtensionDescriptor } from '@prisma-next/sql-runtime';
+/**
+ * SQL runtime driver instance type.
+ * Combines identity properties with SQL-specific behavior methods.
+ */
+export type SqlRuntimeDriverInstance<TTargetId extends string = string> = RuntimeDriverInstance<'sql', TTargetId> & SqlDriver;
+export type { SqlRuntimeAdapterInstance } from '@prisma-next/sql-runtime';
+/**
+ * SQL runtime family instance interface.
+ * Extends base RuntimeFamilyInstance with SQL-specific runtime creation method.
+ */
+export interface SqlRuntimeFamilyInstance extends RuntimeFamilyInstance<'sql'> {
+    /**
+     * Creates a SQL runtime from contract, driver options, and verification settings.
+     *
+     * Extension packs are routed through composition (at instance creation time),
+     * not through this method. This aligns with control-plane composition patterns.
+     *
+     * @param options - Runtime creation options
+     * @param options.contract - SQL contract
+     * @param options.driverOptions - Driver options (e.g., PostgresDriverOptions)
+     * @param options.verify - Runtime verification options
+     * @param options.plugins - Optional plugins
+     * @param options.mode - Optional runtime mode
+     * @param options.log - Optional log instance
+     * @returns Runtime instance
+     */
+    createRuntime<TContract extends SqlContract<SqlStorage>>(options: {
+        readonly contract: TContract;
+        readonly driverOptions: unknown;
+        readonly verify: RuntimeVerifyOptions;
+        readonly plugins?: readonly Plugin<TContract, Adapter<SelectAst, SqlContract<SqlStorage>, LoweredStatement>, SqlDriver>[];
+        readonly mode?: 'strict' | 'permissive';
+        readonly log?: Log;
+    }): Runtime;
+}
+/**
+ * Creates a SQL runtime family instance from runtime descriptors.
+ *
+ * Routes the same framework composition as control-plane:
+ * family, target, adapter, driver, extensionPacks (all as descriptors with IDs).
+ */
+export declare function createSqlRuntimeFamilyInstance<TTargetId extends string>(options: {
+    readonly family: RuntimeFamilyDescriptor<'sql'>;
+    readonly target: RuntimeTargetDescriptor<'sql', TTargetId>;
+    readonly adapter: RuntimeAdapterDescriptor<'sql', TTargetId, SqlRuntimeAdapterInstance<TTargetId>>;
+    readonly driver: RuntimeDriverDescriptor<'sql', TTargetId, SqlRuntimeDriverInstance<TTargetId>>;
+    readonly extensionPacks?: readonly SqlRuntimeExtensionDescriptor<TTargetId>[];
+}): SqlRuntimeFamilyInstance;
+//# sourceMappingURL=runtime-instance.d.ts.map

package/dist/core/runtime-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-instance.d.ts","sourceRoot":"","sources":["../../src/core/runtime-instance.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,uBAAuB,EACxB,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EACV,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,SAAS,EACV,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EACV,OAAO,EAEP,yBAAyB,EACzB,6BAA6B,EAC9B,MAAM,0BAA0B,CAAC;AAGlC;;;GAGG;AACH,MAAM,MAAM,wBAAwB,CAAC,SAAS,SAAS,MAAM,GAAG,MAAM,IAAI,qBAAqB,CAC7F,KAAK,EACL,SAAS,CACV,GACC,SAAS,CAAC;AAGZ,YAAY,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAE1E;;;GAGG;AACH,MAAM,WAAW,wBAAyB,SAAQ,qBAAqB,CAAC,KAAK,CAAC;IAC5E;;;;;;;;;;;;;;OAcG;IACH,aAAa,CAAC,SAAS,SAAS,WAAW,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE;QAChE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;QAC7B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;QAChC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;QACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,CAChC,SAAS,EACT,OAAO,CAAC,SAAS,EAAE,WAAW,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,EAC7D,SAAS,CACV,EAAE,CAAC;QACJ,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,GAAG,YAAY,CAAC;QACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC;KACpB,GAAG,OAAO,CAAC;CACb;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,SAAS,SAAS,MAAM,EAAE,OAAO,EAAE;IAChF,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,KAAK,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC3D,QAAQ,CAAC,OAAO,EAAE,wBAAwB,CACxC,KAAK,EACL,SAAS,EACT,yBAAyB,CAAC,SAAS,CAAC,CACrC,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,wBAAwB,CAAC,SAAS,CAAC,CAAC,CAAC;IAChG,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,6BAA6B,CAAC,SAAS,CAAC,EAAE,CAAC;CAC/E,GAAG,wBAAwB,CAuD3B"}