@prisma-next/family-sql 0.3.0-pr.73.2 → 0.3.0-pr.75.1

package/dist/core/schema-verify/verify-helpers.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Pure verification helper functions for SQL schema verification.
+ * These functions verify schema IR against contract requirements.
+ */
+import type { SchemaIssue, SchemaVerificationNode } from '@prisma-next/core-control-plane/types';
+import type { ForeignKey, Index, PrimaryKey, UniqueConstraint } from '@prisma-next/sql-contract/types';
+import type { SqlForeignKeyIR, SqlIndexIR, SqlSchemaIR, SqlUniqueIR } from '@prisma-next/sql-schema-ir/types';
+import type { ComponentDatabaseDependency } from '../migrations/types';
+/**
+ * Compares two arrays of strings for equality (order-sensitive).
+ */
+export declare function arraysEqual(a: readonly string[], b: readonly string[]): boolean;
+/**
+ * Verifies primary key matches between contract and schema.
+ * Returns 'pass' or 'fail'.
+ */
+export declare function verifyPrimaryKey(contractPK: PrimaryKey, schemaPK: PrimaryKey | undefined, tableName: string, issues: SchemaIssue[]): 'pass' | 'fail';
+/**
+ * Verifies foreign keys match between contract and schema.
+ * Returns verification nodes for the tree.
+ */
+export declare function verifyForeignKeys(contractFKs: readonly ForeignKey[], schemaFKs: readonly SqlForeignKeyIR[], tableName: string, tablePath: string, issues: SchemaIssue[], strict: boolean): SchemaVerificationNode[];
+/**
+ * Verifies unique constraints match between contract and schema.
+ * Returns verification nodes for the tree.
+ */
+export declare function verifyUniqueConstraints(contractUniques: readonly UniqueConstraint[], schemaUniques: readonly SqlUniqueIR[], tableName: string, tablePath: string, issues: SchemaIssue[], strict: boolean): SchemaVerificationNode[];
+/**
+ * Verifies indexes match between contract and schema.
+ * Returns verification nodes for the tree.
+ */
+export declare function verifyIndexes(contractIndexes: readonly Index[], schemaIndexes: readonly SqlIndexIR[], tableName: string, tablePath: string, issues: SchemaIssue[], strict: boolean): SchemaVerificationNode[];
+/**
+ * Verifies database dependencies are installed using component-owned verification hooks.
+ * Each dependency provides a pure verifyDatabaseDependencyInstalled function that checks
+ * whether the dependency is satisfied based on the in-memory schema IR (no DB I/O).
+ *
+ * Returns verification nodes for the tree.
+ */
+export declare function verifyDatabaseDependencies(dependencies: ReadonlyArray<ComponentDatabaseDependency<unknown>>, schema: SqlSchemaIR, issues: SchemaIssue[]): SchemaVerificationNode[];
+/**
+ * Computes counts of pass/warn/fail nodes by traversing the tree.
+ */
+export declare function computeCounts(node: SchemaVerificationNode): {
+    pass: number;
+    warn: number;
+    fail: number;
+    totalNodes: number;
+};
+//# sourceMappingURL=verify-helpers.d.ts.map

package/dist/core/schema-verify/verify-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-helpers.d.ts","sourceRoot":"","sources":["../../../src/core/schema-verify/verify-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AACjG,OAAO,KAAK,EACV,UAAU,EACV,KAAK,EACL,UAAU,EACV,gBAAgB,EACjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,WAAW,EACX,WAAW,EACZ,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAEvE;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,SAAS,MAAM,EAAE,EAAE,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAU/E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,GACpB,MAAM,GAAG,MAAM,CAoCjB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,SAAS,UAAU,EAAE,EAClC,SAAS,EAAE,SAAS,eAAe,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,OAAO,GACd,sBAAsB,EAAE,CAuG1B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,SAAS,gBAAgB,EAAE,EAC5C,aAAa,EAAE,SAAS,WAAW,EAAE,EACrC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,OAAO,GACd,sBAAsB,EAAE,CAmG1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,eAAe,EAAE,SAAS,KAAK,EAAE,EACjC,aAAa,EAAE,SAAS,UAAU,EAAE,EACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,EACrB,MAAM,EAAE,OAAO,GACd,sBAAsB,EAAE,CAoG1B;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,YAAY,EAAE,aAAa,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,EACjE,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,WAAW,EAAE,GACpB,sBAAsB,EAAE,CAwC1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,sBAAsB,GAAG;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB,CA6BA"}

package/dist/core/schema-verify/verify-sql-schema.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Pure SQL schema verification function.
+ *
+ * This module provides a pure function that verifies a SqlSchemaIR against
+ * a SqlContract without requiring a database connection. It can be reused
+ * by migration planners and other tools that need to compare schema states.
+ */
+import type { TargetBoundComponentDescriptor } from '@prisma-next/contract/framework-components';
+import type { OperationContext, VerifyDatabaseSchemaResult } 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';
+/**
+ * Options for the pure schema verification function.
+ */
+export interface VerifySqlSchemaOptions {
+    /** The validated SQL contract to verify against */
+    readonly contract: SqlContract<SqlStorage>;
+    /** The schema IR from introspection (or another source) */
+    readonly schema: SqlSchemaIR;
+    /** Whether to run in strict mode (detects extra tables/columns) */
+    readonly strict: boolean;
+    /** Optional operation context for metadata */
+    readonly context?: OperationContext;
+    /** Type metadata registry for codec consistency warnings */
+    readonly typeMetadataRegistry: ReadonlyMap<string, {
+        nativeType?: string;
+    }>;
+    /**
+     * Active framework components participating in this composition.
+     * All components must have matching familyId ('sql') and targetId.
+     */
+    readonly frameworkComponents: ReadonlyArray<TargetBoundComponentDescriptor<'sql', string>>;
+}
+/**
+ * Verifies that a SqlSchemaIR matches a SqlContract.
+ *
+ * This is a pure function that does NOT perform any database I/O.
+ * It takes an already-introspected schema IR and compares it against
+ * the contract requirements.
+ *
+ * @param options - Verification options
+ * @returns VerifyDatabaseSchemaResult with verification tree and issues
+ */
+export declare function verifySqlSchema(options: VerifySqlSchemaOptions): VerifyDatabaseSchemaResult;
+//# sourceMappingURL=verify-sql-schema.d.ts.map

package/dist/core/schema-verify/verify-sql-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verify-sql-schema.d.ts","sourceRoot":"","sources":["../../../src/core/schema-verify/verify-sql-schema.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4CAA4C,CAAC;AACjG,OAAO,KAAK,EACV,gBAAgB,EAGhB,0BAA0B,EAC3B,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAYpE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,mDAAmD;IACnD,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAC3C,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,mEAAmE;IACnE,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,oBAAoB,EAAE,WAAW,CAAC,MAAM,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5E;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,8BAA8B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;CAC5F;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,0BAA0B,CAqe3F"}

package/dist/core/verify.d.ts

@@ -0,0 +1,39 @@
+import type { ContractMarkerRecord } from '@prisma-next/contract/types';
+import type { ControlAdapterDescriptor, ControlDriverInstance, ControlExtensionDescriptor, ControlTargetDescriptor } from '@prisma-next/core-control-plane/types';
+/**
+ * Parses a contract marker row from database query result.
+ * This is SQL-specific parsing logic (handles SQL row structure with snake_case columns).
+ */
+export declare function parseContractMarkerRow(row: unknown): ContractMarkerRecord;
+/**
+ * Returns the SQL statement to read the contract marker.
+ * This is a migration-plane helper (no runtime imports).
+ * @internal - Used internally by readMarker(). Prefer readMarker() for Control Plane usage.
+ */
+export declare function readMarkerSql(): {
+    readonly sql: string;
+    readonly params: readonly unknown[];
+};
+/**
+ * Reads the contract marker from the database using the provided driver.
+ * Returns the parsed marker record or null if no marker is found.
+ * This abstracts SQL-specific details from the Control Plane.
+ *
+ * @param driver - ControlDriverInstance instance for executing queries
+ * @returns Promise resolving to ContractMarkerRecord or null if marker not found
+ */
+export declare function readMarker(driver: ControlDriverInstance<'sql', string>): Promise<ContractMarkerRecord | null>;
+/**
+ * Collects supported codec type IDs from adapter and extension manifests.
+ * Returns a sorted, unique array of type IDs that are declared in the manifests.
+ * This enables coverage checks by comparing contract column types against supported types.
+ *
+ * Note: This extracts type IDs from manifest type imports, not from runtime codec registries.
+ * The manifests declare which codec types are available, but the actual type IDs
+ * are defined in the codec-types TypeScript modules that are imported.
+ *
+ * For MVP, we return an empty array since extracting type IDs from TypeScript modules
+ * would require runtime evaluation or static analysis. This can be enhanced later.
+ */
+export declare function collectSupportedCodecTypeIds<TFamilyId extends string, TTargetId extends string>(descriptors: ReadonlyArray<ControlTargetDescriptor<TFamilyId, TTargetId> | ControlAdapterDescriptor<TFamilyId, TTargetId> | ControlExtensionDescriptor<TFamilyId, TTargetId>>): readonly string[];
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/core/verify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EACV,wBAAwB,EACxB,qBAAqB,EACrB,0BAA0B,EAC1B,uBAAuB,EACxB,MAAM,uCAAuC,CAAC;AAuC/C;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,GAAG,oBAAoB,CAgCzE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,IAAI;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,CAc7F;AAED;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,qBAAqB,CAAC,KAAK,EAAE,MAAM,CAAC,GAC3C,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAoCtC;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,4BAA4B,CAAC,SAAS,SAAS,MAAM,EAAE,SAAS,SAAS,MAAM,EAC7F,WAAW,EAAE,aAAa,CACtB,uBAAuB,CAAC,SAAS,EAAE,SAAS,CAAC,GAC7C,wBAAwB,CAAC,SAAS,EAAE,SAAS,CAAC,GAC9C,0BAA0B,CAAC,SAAS,EAAE,SAAS,CAAC,CACnD,GACA,SAAS,MAAM,EAAE,CAMnB"}

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

@@ -1,44 +1,2 @@
-import { ControlAdapterInstance, ControlDriverInstance } from '@prisma-next/core-control-plane/types';
-import { 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')
- */
-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')
- */
-interface SqlControlAdapterDescriptor<TTarget extends string = string> {
-    /**
-     * Creates a SQL control adapter instance for control-plane operations.
-     */
-    create(): SqlControlAdapter<TTarget>;
-}
-
-export type { SqlControlAdapter, SqlControlAdapterDescriptor };
+export type { SqlControlAdapter, SqlControlAdapterDescriptor } from '../core/control-adapter';
+//# sourceMappingURL=control-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control-adapter.d.ts","sourceRoot":"","sources":["../../src/exports/control-adapter.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/exports/control.d.ts

@@ -1,165 +1,13 @@
-import { OperationRegistry } from '@prisma-next/operations';
-import { ControlFamilyDescriptor, ControlAdapterDescriptor, ControlDriverDescriptor, ControlExtensionDescriptor, MigrationOperationPolicy } from '@prisma-next/core-control-plane/types';
-export { MigrationOperationClass, MigrationOperationPolicy, MigrationPlan, MigrationPlanOperation, MigrationPlanner, MigrationPlannerConflict, MigrationPlannerResult, TargetMigrationsCapability } from '@prisma-next/core-control-plane/types';
-import { SqlControlAdapter } from './control-adapter.js';
-import { S as SqlControlFamilyInstance } from './instance-DiZi2k_2.js';
-export { a as SchemaVerifyOptions } from './instance-DiZi2k_2.js';
-import { S as SqlControlTargetDescriptor, C as CreateSqlMigrationPlanOptions, a as SqlMigrationPlan, b as SqlPlannerConflict, c as SqlPlannerFailureResult, d as SqlPlannerSuccessResult, e as SqlMigrationRunnerErrorCode, A as AnyRecord, f as SqlMigrationRunnerFailure, g as SqlMigrationRunnerSuccessValue } from './types-Bh7ftf0Q.js';
-export { h as ComponentDatabaseDependencies, i as ComponentDatabaseDependency, j as SqlControlExtensionDescriptor, k as SqlMigrationPlanContractInfo, n as SqlMigrationPlanOperation, o as SqlMigrationPlanOperationStep, p as SqlMigrationPlanOperationTarget, l as SqlMigrationPlanner, m as SqlMigrationPlannerPlanOptions, q as SqlMigrationRunner, r as SqlMigrationRunnerExecuteCallbacks, s as SqlMigrationRunnerExecuteOptions, t as SqlMigrationRunnerResult, u as SqlPlannerConflictKind, v as SqlPlannerConflictLocation, w as SqlPlannerResult } from './types-Bh7ftf0Q.js';
-import { NotOk, Ok } from '@prisma-next/utils/result';
-import '@prisma-next/sql-schema-ir/types';
-import '@prisma-next/contract/framework-components';
-import '@prisma-next/contract/ir';
-import '@prisma-next/contract/pack-manifest-types';
-import '@prisma-next/contract/types';
-import '@prisma-next/core-control-plane/schema-view';
-import '@prisma-next/sql-operations';
-import '@prisma-next/sql-contract/types';
-
-type StorageColumn = {
-    readonly nativeType: string;
-    readonly codecId: string;
-    readonly nullable: boolean;
-};
-type PrimaryKey = {
-    readonly columns: readonly string[];
-    readonly name?: string;
-};
-type UniqueConstraint = {
-    readonly columns: readonly string[];
-    readonly name?: string;
-};
-type Index = {
-    readonly columns: readonly string[];
-    readonly name?: string;
-};
-type ForeignKeyReferences = {
-    readonly table: string;
-    readonly columns: readonly string[];
-};
-type ForeignKey = {
-    readonly columns: readonly string[];
-    readonly references: ForeignKeyReferences;
-    readonly name?: string;
-};
-type StorageTable = {
-    readonly columns: Record<string, StorageColumn>;
-    readonly primaryKey?: PrimaryKey;
-    readonly uniques: ReadonlyArray<UniqueConstraint>;
-    readonly indexes: ReadonlyArray<Index>;
-    readonly foreignKeys: ReadonlyArray<ForeignKey>;
-};
-type SqlStorage = {
-    readonly tables: Record<string, StorageTable>;
-};
-type ModelField = {
-    readonly column: string;
-};
-type ModelStorage = {
-    readonly table: string;
-};
-type ModelDefinition = {
-    readonly storage: ModelStorage;
-    readonly fields: Record<string, ModelField>;
-    readonly relations: Record<string, unknown>;
-};
-
-/**
- * ContractIR types and factories for building contract intermediate representation.
- * ContractIR is family-agnostic and used by authoring, emitter, and no-emit runtime.
- */
-/**
- * ContractIR represents the intermediate representation of a contract.
- * It is family-agnostic and contains generic storage, models, and relations.
- * Note: coreHash and profileHash are computed by the emitter, not part of the IR.
- */
-interface ContractIR<TStorage extends Record<string, unknown> = Record<string, unknown>, TModels extends Record<string, unknown> = Record<string, unknown>, TRelations extends Record<string, unknown> = Record<string, unknown>> {
-    readonly schemaVersion: string;
-    readonly targetFamily: string;
-    readonly target: string;
-    readonly models: TModels;
-    readonly relations: TRelations;
-    readonly storage: TStorage;
-    readonly extensionPacks: Record<string, unknown>;
-    readonly capabilities: Record<string, Record<string, boolean>>;
-    readonly meta: Record<string, unknown>;
-    readonly sources: Record<string, unknown>;
-}
-
-/**
- * Specifies how to import TypeScript types from a package.
- * Used in extension pack manifests to declare codec and operation type imports.
- */
-interface TypesImportSpec {
-    readonly package: string;
-    readonly named: string;
-    readonly alias: string;
-}
-/**
- * Validation context passed to TargetFamilyHook.validateTypes().
- * Contains pre-assembled operation registry, type imports, and extension IDs.
- */
-interface ValidationContext {
-    readonly operationRegistry?: OperationRegistry;
-    readonly codecTypeImports?: ReadonlyArray<TypesImportSpec>;
-    readonly operationTypeImports?: ReadonlyArray<TypesImportSpec>;
-    readonly extensionIds?: ReadonlyArray<string>;
-}
-
-/**
- * SQL family descriptor implementation.
- * Provides the SQL family hook and factory method.
- */
-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: ContractIR, _ctx: ValidationContext) => void;
-        readonly validateStructure: (ir: ContractIR) => void;
-        readonly generateContractTypes: (ir: ContractIR, codecTypeImports: ReadonlyArray<TypesImportSpec>, operationTypeImports: ReadonlyArray<TypesImportSpec>) => string;
-        readonly generateStorageType: (storage: SqlStorage) => string;
-        readonly generateModelsType: (models: Record<string, ModelDefinition> | undefined, storage: SqlStorage) => string;
-        readonly generateRelationsType: (relations: Record<string, unknown> | undefined) => string;
-        readonly generateMappingsType: (models: Record<string, ModelDefinition> | undefined, storage: SqlStorage, codecTypes: string, operationTypes: string) => string;
-    };
-    create<TTargetId extends string, TTargetDetails>(options: {
-        readonly target: SqlControlTargetDescriptor<TTargetId, TTargetDetails>;
-        readonly adapter: ControlAdapterDescriptor<'sql', TTargetId, SqlControlAdapter<TTargetId>>;
-        readonly driver: ControlDriverDescriptor<'sql', TTargetId>;
-        readonly extensionPacks: readonly ControlExtensionDescriptor<'sql', TTargetId>[];
-    }): SqlControlFamilyInstance;
-}
-
-declare function createMigrationPlan<TTargetDetails>(options: CreateSqlMigrationPlanOptions<TTargetDetails>): SqlMigrationPlan<TTargetDetails>;
-declare function plannerSuccess<TTargetDetails>(plan: SqlMigrationPlan<TTargetDetails>): SqlPlannerSuccessResult<TTargetDetails>;
-declare function plannerFailure(conflicts: readonly SqlPlannerConflict[]): SqlPlannerFailureResult;
-/**
- * Creates a successful migration runner result.
- */
-declare function runnerSuccess(value: {
-    operationsPlanned: number;
-    operationsExecuted: number;
-}): Ok<SqlMigrationRunnerSuccessValue>;
-/**
- * Creates a failed migration runner result.
- */
-declare function runnerFailure(code: SqlMigrationRunnerErrorCode, summary: string, options?: {
-    why?: string;
-    meta?: AnyRecord;
-}): NotOk<SqlMigrationRunnerFailure>;
-
-/**
- * Policy used by `db init`: additive-only operations, no widening/destructive steps.
- */
-declare const INIT_ADDITIVE_POLICY: MigrationOperationPolicy;
-
+import { SqlFamilyDescriptor } from '../core/descriptor';
+export type { MigrationOperationClass, MigrationOperationPolicy, MigrationPlan, MigrationPlanner, MigrationPlannerConflict, MigrationPlannerResult, MigrationPlanOperation, TargetMigrationsCapability, } from '@prisma-next/core-control-plane/types';
+export type { SchemaVerifyOptions, SqlControlFamilyInstance } from '../core/instance';
+export { createMigrationPlan, plannerFailure, plannerSuccess, runnerFailure, runnerSuccess, } from '../core/migrations/plan-helpers';
+export { INIT_ADDITIVE_POLICY } from '../core/migrations/policies';
+export type { ComponentDatabaseDependencies, ComponentDatabaseDependency, CreateSqlMigrationPlanOptions, SqlControlExtensionDescriptor, SqlControlTargetDescriptor, SqlMigrationPlan, SqlMigrationPlanContractInfo, SqlMigrationPlanner, SqlMigrationPlannerPlanOptions, SqlMigrationPlanOperation, SqlMigrationPlanOperationStep, SqlMigrationPlanOperationTarget, SqlMigrationRunner, SqlMigrationRunnerErrorCode, SqlMigrationRunnerExecuteCallbacks, SqlMigrationRunnerExecuteOptions, SqlMigrationRunnerFailure, SqlMigrationRunnerResult, SqlMigrationRunnerSuccessValue, SqlPlannerConflict, SqlPlannerConflictKind, SqlPlannerConflictLocation, SqlPlannerFailureResult, SqlPlannerResult, SqlPlannerSuccessResult, } from '../core/migrations/types';
 /**
  * SQL family descriptor for control plane (CLI/config).
  * Provides the SQL family hook and conversion helpers.
  */
 declare const _default: SqlFamilyDescriptor;
-
-export { CreateSqlMigrationPlanOptions, INIT_ADDITIVE_POLICY, SqlControlFamilyInstance, SqlControlTargetDescriptor, SqlMigrationPlan, SqlMigrationRunnerErrorCode, SqlMigrationRunnerFailure, SqlMigrationRunnerSuccessValue, SqlPlannerConflict, SqlPlannerFailureResult, SqlPlannerSuccessResult, createMigrationPlan, _default as default, plannerFailure, plannerSuccess, runnerFailure, runnerSuccess };
+export default _default;
+//# sourceMappingURL=control.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"control.d.ts","sourceRoot":"","sources":["../../src/exports/control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,aAAa,EACb,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,uCAAuC,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EACL,mBAAmB,EACnB,cAAc,EACd,cAAc,EACd,aAAa,EACb,aAAa,GACd,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAEnE,YAAY,EACV,6BAA6B,EAC7B,2BAA2B,EAC3B,6BAA6B,EAC7B,6BAA6B,EAC7B,0BAA0B,EAC1B,gBAAgB,EAChB,4BAA4B,EAC5B,mBAAmB,EACnB,8BAA8B,EAC9B,yBAAyB,EACzB,6BAA6B,EAC7B,+BAA+B,EAC/B,kBAAkB,EAClB,2BAA2B,EAC3B,kCAAkC,EAClC,gCAAgC,EAChC,yBAAyB,EACzB,wBAAwB,EACxB,8BAA8B,EAC9B,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC;;;GAGG;;AACH,wBAAyC"}

package/dist/exports/runtime.d.ts

@@ -1,66 +1,8 @@
-import { RuntimeFamilyInstance, RuntimeDriverInstance, RuntimeFamilyDescriptor, RuntimeTargetDescriptor, RuntimeAdapterDescriptor, RuntimeDriverDescriptor, RuntimeExtensionDescriptor } from '@prisma-next/core-execution-plane/types';
-import { RuntimeVerifyOptions, Plugin, Log } from '@prisma-next/runtime-executor';
-import { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
-import { Adapter, SelectAst, LoweredStatement, SqlDriver } from '@prisma-next/sql-relational-core/ast';
-import { Runtime, SqlRuntimeAdapterInstance } from '@prisma-next/sql-runtime';
-
-/**
- * SQL runtime driver instance type.
- * Combines identity properties with SQL-specific behavior methods.
- */
-type SqlRuntimeDriverInstance<TTargetId extends string = string> = RuntimeDriverInstance<'sql', TTargetId> & SqlDriver;
-
-/**
- * SQL runtime family instance interface.
- * Extends base RuntimeFamilyInstance with SQL-specific runtime creation method.
- */
-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;
-}
-
-/**
- * SQL runtime family descriptor implementation.
- * Provides factory method to create SQL runtime family instance.
- */
-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;
-}
-
+import { SqlRuntimeFamilyDescriptor } from '../core/runtime-descriptor';
 /**
  * SQL runtime family descriptor for execution/runtime plane.
  * Provides factory method to create SQL runtime family instance.
  */
 declare const _default: SqlRuntimeFamilyDescriptor;
-
-export { _default as default };
+export default _default;
+//# sourceMappingURL=runtime.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/exports/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAExE;;;GAGG;;AACH,wBAAgD"}

package/dist/exports/schema-verify.d.ts

@@ -1,75 +1,11 @@
-import { SchemaIssue, SchemaVerificationNode, OperationContext, VerifyDatabaseSchemaResult } from '@prisma-next/core-control-plane/types';
-import { SqlSchemaIR } from '@prisma-next/sql-schema-ir/types';
-import { i as ComponentDatabaseDependency } from './types-Bh7ftf0Q.js';
-import { TargetBoundComponentDescriptor } from '@prisma-next/contract/framework-components';
-import { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';
-import '@prisma-next/utils/result';
-import './instance-DiZi2k_2.js';
-import '@prisma-next/contract/ir';
-import '@prisma-next/contract/pack-manifest-types';
-import '@prisma-next/contract/types';
-import '@prisma-next/core-control-plane/schema-view';
-import '@prisma-next/operations';
-import '@prisma-next/sql-operations';
-
 /**
- * Pure verification helper functions for SQL schema verification.
- * These functions verify schema IR against contract requirements.
- */
-
-/**
- * Compares two arrays of strings for equality (order-sensitive).
- */
-declare function arraysEqual(a: readonly string[], b: readonly string[]): boolean;
-/**
- * Verifies database dependencies are installed using component-owned verification hooks.
- * Each dependency provides a pure verifyDatabaseDependencyInstalled function that checks
- * whether the dependency is satisfied based on the in-memory schema IR (no DB I/O).
- *
- * Returns verification nodes for the tree.
- */
-declare function verifyDatabaseDependencies(dependencies: ReadonlyArray<ComponentDatabaseDependency<unknown>>, schema: SqlSchemaIR, issues: SchemaIssue[]): SchemaVerificationNode[];
-
-/**
- * Pure SQL schema verification function.
- *
- * This module provides a pure function that verifies a SqlSchemaIR against
- * a SqlContract without requiring a database connection. It can be reused
- * by migration planners and other tools that need to compare schema states.
- */
-
-/**
- * Options for the pure schema verification function.
- */
-interface VerifySqlSchemaOptions {
-    /** The validated SQL contract to verify against */
-    readonly contract: SqlContract<SqlStorage>;
-    /** The schema IR from introspection (or another source) */
-    readonly schema: SqlSchemaIR;
-    /** Whether to run in strict mode (detects extra tables/columns) */
-    readonly strict: boolean;
-    /** Optional operation context for metadata */
-    readonly context?: OperationContext;
-    /** Type metadata registry for codec consistency warnings */
-    readonly typeMetadataRegistry: ReadonlyMap<string, {
-        nativeType?: string;
-    }>;
-    /**
-     * Active framework components participating in this composition.
-     * All components must have matching familyId ('sql') and targetId.
-     */
-    readonly frameworkComponents: ReadonlyArray<TargetBoundComponentDescriptor<'sql', string>>;
-}
-/**
- * Verifies that a SqlSchemaIR matches a SqlContract.
- *
- * This is a pure function that does NOT perform any database I/O.
- * It takes an already-introspected schema IR and compares it against
- * the contract requirements.
+ * Pure schema verification exports.
  *
- * @param options - Verification options
- * @returns VerifyDatabaseSchemaResult with verification tree and issues
+ * This module exports the pure schema verification function that can be used
+ * without a database connection. It's suitable for migration planning and
+ * other tools that need to compare schema states.
  */
-declare function verifySqlSchema(options: VerifySqlSchemaOptions): VerifyDatabaseSchemaResult;
-
-export { type VerifySqlSchemaOptions, arraysEqual, verifyDatabaseDependencies, verifySqlSchema };
+export { arraysEqual, verifyDatabaseDependencies } from '../core/schema-verify/verify-helpers';
+export type { VerifySqlSchemaOptions } from '../core/schema-verify/verify-sql-schema';
+export { verifySqlSchema } from '../core/schema-verify/verify-sql-schema';
+//# sourceMappingURL=schema-verify.d.ts.map

package/dist/exports/schema-verify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-verify.d.ts","sourceRoot":"","sources":["../../src/exports/schema-verify.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAC/F,YAAY,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC"}

package/dist/exports/test-utils.d.ts

@@ -1,33 +1,7 @@
-import { OperationManifest } from '@prisma-next/contract/pack-manifest-types';
-import { TypesImportSpec } from '@prisma-next/contract/types';
-import { ControlTargetDescriptor, ControlAdapterDescriptor, ControlExtensionDescriptor } from '@prisma-next/core-control-plane/types';
-import { OperationSignature, OperationRegistry } from '@prisma-next/operations';
-export { c as convertOperationManifest } from './instance-DiZi2k_2.js';
-import '@prisma-next/contract/framework-components';
-import '@prisma-next/contract/ir';
-import '@prisma-next/core-control-plane/schema-view';
-import '@prisma-next/sql-operations';
-import '@prisma-next/sql-schema-ir/types';
-
 /**
- * Assembles an operation registry from descriptors (adapter, target, extensions).
- * Loops over descriptors, extracts operations, converts them using the provided
- * conversion function, and registers them in a new registry.
+ * Test utilities for working with component descriptors.
+ * These functions operate on descriptors directly, used in tests and integration tests.
  */
-declare function assembleOperationRegistry(descriptors: ReadonlyArray<ControlTargetDescriptor<'sql', string> | ControlAdapterDescriptor<'sql', string> | ControlExtensionDescriptor<'sql', string>>, convertOperationManifest: (manifest: OperationManifest) => OperationSignature): OperationRegistry;
-/**
- * Extracts codec type imports from descriptors for contract.d.ts generation.
- */
-declare function extractCodecTypeImports(descriptors: ReadonlyArray<ControlTargetDescriptor<'sql', string> | ControlAdapterDescriptor<'sql', string> | ControlExtensionDescriptor<'sql', string>>): ReadonlyArray<TypesImportSpec>;
-/**
- * Extracts operation type imports from descriptors for contract.d.ts generation.
- */
-declare function extractOperationTypeImports(descriptors: ReadonlyArray<ControlTargetDescriptor<'sql', string> | ControlAdapterDescriptor<'sql', string> | ControlExtensionDescriptor<'sql', string>>): ReadonlyArray<TypesImportSpec>;
-/**
- * Extracts extension IDs from descriptors in deterministic order:
- * [adapter.id, target.id, ...extensions.map(e => e.id)]
- * Deduplicates while preserving stable order.
- */
-declare function extractExtensionIds(adapter: ControlAdapterDescriptor<'sql', string>, target: ControlTargetDescriptor<'sql', string>, extensions: ReadonlyArray<ControlExtensionDescriptor<'sql', string>>): ReadonlyArray<string>;
-
-export { assembleOperationRegistry, extractCodecTypeImports, extractExtensionIds, extractOperationTypeImports };
+export { assembleOperationRegistry, extractCodecTypeImports, extractExtensionIds, extractOperationTypeImports, } from '../core/assembly';
+export { convertOperationManifest } from '../core/instance';
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/exports/test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/exports/test-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/exports/verify.d.ts

@@ -1,28 +1,2 @@
-import { ContractMarkerRecord } from '@prisma-next/contract/types';
-import { ControlDriverInstance } from '@prisma-next/core-control-plane/types';
-
-/**
- * Parses a contract marker row from database query result.
- * This is SQL-specific parsing logic (handles SQL row structure with snake_case columns).
- */
-declare function parseContractMarkerRow(row: unknown): ContractMarkerRecord;
-/**
- * Returns the SQL statement to read the contract marker.
- * This is a migration-plane helper (no runtime imports).
- * @internal - Used internally by readMarker(). Prefer readMarker() for Control Plane usage.
- */
-declare function readMarkerSql(): {
-    readonly sql: string;
-    readonly params: readonly unknown[];
-};
-/**
- * Reads the contract marker from the database using the provided driver.
- * Returns the parsed marker record or null if no marker is found.
- * This abstracts SQL-specific details from the Control Plane.
- *
- * @param driver - ControlDriverInstance instance for executing queries
- * @returns Promise resolving to ContractMarkerRecord or null if marker not found
- */
-declare function readMarker(driver: ControlDriverInstance<'sql', string>): Promise<ContractMarkerRecord | null>;
-
-export { parseContractMarkerRow, readMarker, readMarkerSql };
+export { parseContractMarkerRow, readMarker, readMarkerSql } from '../core/verify';
+//# sourceMappingURL=verify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verify.d.ts","sourceRoot":"","sources":["../../src/exports/verify.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC"}