@prisma-next/family-sql 0.1.0-dev.3 → 0.1.0-dev.30

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

@@ -0,0 +1,75 @@
+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.
+ *
+ * @param options - Verification options
+ * @returns VerifyDatabaseSchemaResult with verification tree and issues
+ */
+declare function verifySqlSchema(options: VerifySqlSchemaOptions): VerifyDatabaseSchemaResult;
+
+export { type VerifySqlSchemaOptions, arraysEqual, verifyDatabaseDependencies, verifySqlSchema };

package/dist/exports/schema-verify.js

@@ -0,0 +1,11 @@
+import {
+  arraysEqual,
+  verifyDatabaseDependencies,
+  verifySqlSchema
+} from "./chunk-F252JMEU.js";
+export {
+  arraysEqual,
+  verifyDatabaseDependencies,
+  verifySqlSchema
+};
+//# sourceMappingURL=schema-verify.js.map

package/dist/exports/schema-verify.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

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

package/dist/exports/test-utils.js

@@ -0,0 +1,17 @@
+import {
+  assembleOperationRegistry,
+  convertOperationManifest,
+  extractCodecTypeImports,
+  extractExtensionIds,
+  extractOperationTypeImports
+} from "./chunk-6P44BVZ4.js";
+import "./chunk-C3GKWCKA.js";
+import "./chunk-F252JMEU.js";
+export {
+  assembleOperationRegistry,
+  convertOperationManifest,
+  extractCodecTypeImports,
+  extractExtensionIds,
+  extractOperationTypeImports
+};
+//# sourceMappingURL=test-utils.js.map

package/dist/exports/test-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/exports/types-Bh7ftf0Q.d.ts

@@ -0,0 +1,275 @@
+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>>;
+/**
+ * A single database dependency declared by a framework component.
+ * Uses SqlMigrationPlanOperation so we inherit the existing precheck/execute/postcheck contract.
+ *
+ * Database dependencies allow components (extensions, adapters) to declare what database-side
+ * persistence structures they require (e.g., Postgres extensions, schemas, functions).
+ * 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> {
+    /** Stable identifier for the dependency (e.g. 'postgres.extension.vector') */
+    readonly id: string;
+    /** Human label for output (e.g. 'Enable vector extension') */
+    readonly label: string;
+    /**
+     * Operations that install/ensure the dependency.
+     * Use SqlMigrationPlanOperation so we inherit the existing precheck/execute/postcheck contract.
+     */
+    readonly install: readonly SqlMigrationPlanOperation<TTargetDetails>[];
+    /**
+     * Pure verification hook: checks whether this dependency is already installed
+     * based on the in-memory schema IR (no DB I/O).
+     *
+     * This must return structured issues suitable for CLI and tree output, not just a boolean.
+     */
+    readonly verifyDatabaseDependencyInstalled: (schema: SqlSchemaIR) => readonly SchemaIssue[];
+}
+/**
+ * Database dependencies declared by a framework component.
+ */
+interface ComponentDatabaseDependencies<TTargetDetails> {
+    /**
+     * Dependencies required for db init.
+     * Future: update dependencies can be added later (e.g. widening/destructive).
+     */
+    readonly init?: readonly ComponentDatabaseDependency<TTargetDetails>[];
+}
+/**
+ * SQL-specific extension descriptor with optional database dependencies.
+ * Extends the core ControlExtensionDescriptor with SQL-specific metadata.
+ *
+ * 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> {
+    /** Optional database dependencies this extension requires. */
+    readonly databaseDependencies?: ComponentDatabaseDependencies<unknown>;
+}
+/**
+ * A single step in a SQL migration operation (precheck, execute, or postcheck).
+ */
+interface SqlMigrationPlanOperationStep {
+    readonly description: string;
+    readonly sql: string;
+    readonly meta?: AnyRecord;
+}
+/**
+ * Target details for a SQL migration operation (table, column, index, etc.).
+ */
+interface SqlMigrationPlanOperationTarget<TTargetDetails> {
+    readonly id: string;
+    readonly details?: TTargetDetails;
+}
+/**
+ * A single SQL migration operation with SQL-specific fields.
+ * Extends the core MigrationPlanOperation with SQL execution details.
+ */
+interface SqlMigrationPlanOperation<TTargetDetails> extends MigrationPlanOperation {
+    /** Optional detailed explanation of what this operation does and why. */
+    readonly summary?: string;
+    readonly target: SqlMigrationPlanOperationTarget<TTargetDetails>;
+    readonly precheck: readonly SqlMigrationPlanOperationStep[];
+    readonly execute: readonly SqlMigrationPlanOperationStep[];
+    readonly postcheck: readonly SqlMigrationPlanOperationStep[];
+    readonly meta?: AnyRecord;
+}
+/**
+ * Contract identity information for SQL migrations.
+ */
+interface SqlMigrationPlanContractInfo {
+    readonly coreHash: string;
+    readonly profileHash?: string;
+}
+/**
+ * A SQL migration plan with SQL-specific fields.
+ * Extends the core MigrationPlan with origin tracking and metadata.
+ */
+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),
+     * and will only proceed if no marker exists (or if the marker already matches destination).
+     */
+    readonly origin?: SqlMigrationPlanContractInfo | null;
+    /**
+     * Destination contract identity that the plan intends to reach.
+     */
+    readonly destination: SqlMigrationPlanContractInfo;
+    readonly operations: readonly SqlMigrationPlanOperation<TTargetDetails>[];
+    readonly meta?: AnyRecord;
+}
+/**
+ * Specific conflict kinds for SQL migrations.
+ */
+type SqlPlannerConflictKind = 'typeMismatch' | 'nullabilityConflict' | 'indexIncompatible' | 'foreignKeyConflict' | 'missingButNonAdditive' | 'unsupportedExtension' | 'extensionMissing' | 'unsupportedOperation';
+/**
+ * Location information for SQL planner conflicts.
+ */
+interface SqlPlannerConflictLocation {
+    readonly table?: string;
+    readonly column?: string;
+    readonly index?: string;
+    readonly constraint?: string;
+    readonly extension?: string;
+}
+/**
+ * A SQL-specific planner conflict with additional location information.
+ * Extends the core MigrationPlannerConflict.
+ */
+interface SqlPlannerConflict extends MigrationPlannerConflict {
+    readonly kind: SqlPlannerConflictKind;
+    readonly location?: SqlPlannerConflictLocation;
+    readonly meta?: AnyRecord;
+}
+/**
+ * Successful SQL planner result with the migration plan.
+ */
+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'> {
+    readonly kind: 'failure';
+    readonly conflicts: readonly SqlPlannerConflict[];
+}
+/**
+ * Union type for SQL planner results.
+ */
+type SqlPlannerResult<TTargetDetails> = SqlPlannerSuccessResult<TTargetDetails> | SqlPlannerFailureResult;
+/**
+ * Options for SQL migration planner.
+ */
+interface SqlMigrationPlannerPlanOptions {
+    readonly contract: SqlContract<SqlStorage>;
+    readonly schema: SqlSchemaIR;
+    readonly policy: MigrationOperationPolicy;
+    readonly schemaName?: string;
+    /**
+     * Active framework components participating in this composition.
+     * SQL targets can interpret this list to derive database dependencies.
+     * All components must have matching familyId ('sql') and targetId.
+     */
+    readonly frameworkComponents: ReadonlyArray<TargetBoundComponentDescriptor<'sql', string>>;
+}
+/**
+ * SQL migration planner interface.
+ * Extends the core MigrationPlanner with SQL-specific types.
+ */
+interface SqlMigrationPlanner<TTargetDetails> {
+    plan(options: SqlMigrationPlannerPlanOptions): SqlPlannerResult<TTargetDetails>;
+}
+/**
+ * Callbacks for SQL migration runner execution.
+ */
+interface SqlMigrationRunnerExecuteCallbacks<TTargetDetails> {
+    onOperationStart?(operation: SqlMigrationPlanOperation<TTargetDetails>): void;
+    onOperationComplete?(operation: SqlMigrationPlanOperation<TTargetDetails>): void;
+}
+/**
+ * Options for SQL migration runner execution.
+ */
+interface SqlMigrationRunnerExecuteOptions<TTargetDetails> {
+    readonly plan: SqlMigrationPlan<TTargetDetails>;
+    readonly driver: ControlDriverInstance<'sql', string>;
+    /**
+     * Destination contract IR.
+     * Must correspond to `plan.destination` and is used for schema verification and marker/ledger writes.
+     */
+    readonly destinationContract: SqlContract<SqlStorage>;
+    /**
+     * Execution-time policy that defines which operation classes are allowed.
+     * The runner validates each operation against this policy before execution.
+     */
+    readonly policy: MigrationOperationPolicy;
+    readonly schemaName?: string;
+    readonly strictVerification?: boolean;
+    readonly callbacks?: SqlMigrationRunnerExecuteCallbacks<TTargetDetails>;
+    readonly context?: OperationContext;
+    /**
+     * Execution-time checks configuration.
+     * All checks default to `true` (enabled) when omitted.
+     */
+    readonly executionChecks?: MigrationRunnerExecutionChecks;
+    /**
+     * Active framework components participating in this composition.
+     * SQL targets can interpret this list to derive database dependencies.
+     * All components must have matching familyId ('sql') and targetId.
+     */
+    readonly frameworkComponents: ReadonlyArray<TargetBoundComponentDescriptor<'sql', string>>;
+}
+/**
+ * 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';
+/**
+ * Detailed information about a SQL migration runner failure.
+ * Extends the core MigrationRunnerFailure with SQL-specific error codes.
+ */
+interface SqlMigrationRunnerFailure extends MigrationRunnerFailure {
+    readonly code: SqlMigrationRunnerErrorCode;
+    readonly meta?: AnyRecord;
+}
+/**
+ * Success value for SQL migration runner execution.
+ * Extends core type for type branding and potential SQL-specific extensions.
+ */
+interface SqlMigrationRunnerSuccessValue extends MigrationRunnerSuccessValue {
+}
+/**
+ * Result type for SQL migration runner execution.
+ */
+type SqlMigrationRunnerResult = Result<SqlMigrationRunnerSuccessValue, SqlMigrationRunnerFailure>;
+/**
+ * SQL migration runner interface.
+ * Extends the core MigrationRunner with SQL-specific types.
+ */
+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> {
+    /**
+     * Creates a SQL migration planner for this target.
+     * Direct method for SQL-specific usage.
+     */
+    createPlanner(family: SqlControlFamilyInstance): SqlMigrationPlanner<TTargetDetails>;
+    /**
+     * Creates a SQL migration runner for this target.
+     * Direct method for SQL-specific usage.
+     */
+    createRunner(family: SqlControlFamilyInstance): SqlMigrationRunner<TTargetDetails>;
+}
+/**
+ * Options for creating a SQL migration plan.
+ */
+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 };

package/dist/exports/verify.d.ts

@@ -23,6 +23,6 @@ declare function readMarkerSql(): {
  * @param driver - ControlDriverInstance instance for executing queries
  * @returns Promise resolving to ContractMarkerRecord or null if marker not found
  */
-declare function readMarker(driver: ControlDriverInstance): Promise<ContractMarkerRecord | null>;
+declare function readMarker(driver: ControlDriverInstance<'sql', string>): Promise<ContractMarkerRecord | null>;
 
 export { parseContractMarkerRow, readMarker, readMarkerSql };

package/dist/exports/verify.js

@@ -2,7 +2,7 @@ import {
   parseContractMarkerRow,
   readMarker,
   readMarkerSql
-} from "./chunk-3HYKCN35.js";
+} from "./chunk-C3GKWCKA.js";
 export {
   parseContractMarkerRow,
   readMarker,

package/package.json

@@ -1,33 +1,34 @@
 {
   "name": "@prisma-next/family-sql",
-  "version": "0.1.0-dev.3",
+  "version": "0.1.0-dev.30",
   "type": "module",
   "sideEffects": false,
   "description": "SQL family descriptor for Prisma Next",
   "dependencies": {
     "arktype": "^2.0.0",
-    "@prisma-next/cli": "0.1.0-dev.3",
-    "@prisma-next/contract": "0.1.0-dev.3",
-    "@prisma-next/core-execution-plane": "0.1.0-dev.3",
-    "@prisma-next/operations": "0.1.0-dev.3",
-    "@prisma-next/runtime-executor": "0.1.0-dev.3",
-    "@prisma-next/sql-contract-emitter": "0.1.0-dev.3",
-    "@prisma-next/sql-contract-ts": "0.1.0-dev.3",
-    "@prisma-next/core-control-plane": "0.1.0-dev.3",
-    "@prisma-next/sql-contract": "0.1.0-dev.3",
-    "@prisma-next/sql-relational-core": "0.1.0-dev.3",
-    "@prisma-next/sql-operations": "0.1.0-dev.3",
-    "@prisma-next/sql-runtime": "0.1.0-dev.3",
-    "@prisma-next/sql-schema-ir": "0.1.0-dev.3"
+    "@prisma-next/cli": "0.1.0-dev.30",
+    "@prisma-next/contract": "0.1.0-dev.30",
+    "@prisma-next/core-control-plane": "0.1.0-dev.30",
+    "@prisma-next/core-execution-plane": "0.1.0-dev.30",
+    "@prisma-next/runtime-executor": "0.1.0-dev.30",
+    "@prisma-next/sql-contract-emitter": "0.1.0-dev.30",
+    "@prisma-next/sql-contract-ts": "0.1.0-dev.30",
+    "@prisma-next/operations": "0.1.0-dev.30",
+    "@prisma-next/sql-contract": "0.1.0-dev.30",
+    "@prisma-next/sql-operations": "0.1.0-dev.30",
+    "@prisma-next/sql-relational-core": "0.1.0-dev.30",
+    "@prisma-next/sql-runtime": "0.1.0-dev.30",
+    "@prisma-next/sql-schema-ir": "0.1.0-dev.30",
+    "@prisma-next/utils": "0.1.0-dev.30"
   },
   "devDependencies": {
+    "@vitest/coverage-v8": "^4.0.0",
     "tsup": "^8.3.0",
     "typescript": "^5.9.3",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^2.1.1",
-    "@prisma-next/targets-postgres": "0.1.0-dev.3",
-    "@prisma-next/test-utils": "0.0.1",
-    "@prisma-next/driver-postgres": "0.1.0-dev.3"
+    "vitest": "^4.0.16",
+    "@prisma-next/driver-postgres": "0.1.0-dev.30",
+    "@prisma-next/test-utils": "0.0.1"
   },
   "files": [
     "dist"
@@ -48,14 +49,22 @@
     "./verify": {
       "types": "./dist/exports/verify.d.ts",
       "import": "./dist/exports/verify.js"
+    },
+    "./test-utils": {
+      "types": "./dist/exports/test-utils.d.ts",
+      "import": "./dist/exports/test-utils.js"
+    },
+    "./schema-verify": {
+      "types": "./dist/exports/schema-verify.d.ts",
+      "import": "./dist/exports/schema-verify.js"
     }
   },
   "scripts": {
     "build": "tsup --config tsup.config.ts",
-    "test": "vitest run --passWithNoTests",
-    "test:coverage": "vitest run --coverage --passWithNoTests",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "typecheck": "tsc --project tsconfig.json --noEmit",
-    "lint": "biome check . --config-path ../../../biome.json --error-on-warnings",
-    "clean": "node ../../../scripts/clean.mjs"
+    "lint": "biome check . --config-path ../../../../biome.json --error-on-warnings",
+    "clean": "node ../../../../scripts/clean.mjs"
   }
 }

package/dist/exports/chunk-3HYKCN35.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/core/verify.ts"],"sourcesContent":["import type { ContractMarkerRecord } from '@prisma-next/contract/types';\nimport type {\n  ControlAdapterDescriptor,\n  ControlDriverInstance,\n  ControlExtensionDescriptor,\n  ControlTargetDescriptor,\n} from '@prisma-next/core-control-plane/types';\nimport { type } from 'arktype';\n\nconst MetaSchema = type({ '[string]': 'unknown' });\n\nfunction parseMeta(meta: unknown): Record<string, unknown> {\n  if (meta === null || meta === undefined) {\n    return {};\n  }\n\n  let parsed: unknown;\n  if (typeof meta === 'string') {\n    try {\n      parsed = JSON.parse(meta);\n    } catch {\n      return {};\n    }\n  } else {\n    parsed = meta;\n  }\n\n  const result = MetaSchema(parsed);\n  if (result instanceof type.errors) {\n    return {};\n  }\n\n  return result as Record<string, unknown>;\n}\n\nconst ContractMarkerRowSchema = type({\n  core_hash: 'string',\n  profile_hash: 'string',\n  'contract_json?': 'unknown | null',\n  'canonical_version?': 'number | null',\n  'updated_at?': 'Date | string',\n  'app_tag?': 'string | null',\n  'meta?': 'unknown | null',\n});\n\n/**\n * Parses a contract marker row from database query result.\n * This is SQL-specific parsing logic (handles SQL row structure with snake_case columns).\n */\nexport function parseContractMarkerRow(row: unknown): ContractMarkerRecord {\n  const result = ContractMarkerRowSchema(row);\n  if (result instanceof type.errors) {\n    const messages = result.map((p: { message: string }) => p.message).join('; ');\n    throw new Error(`Invalid contract marker row: ${messages}`);\n  }\n\n  const validatedRow = result as {\n    core_hash: string;\n    profile_hash: string;\n    contract_json?: unknown | null;\n    canonical_version?: number | null;\n    updated_at?: Date | string;\n    app_tag?: string | null;\n    meta?: unknown | null;\n  };\n\n  const updatedAt = validatedRow.updated_at\n    ? validatedRow.updated_at instanceof Date\n      ? validatedRow.updated_at\n      : new Date(validatedRow.updated_at)\n    : new Date();\n\n  return {\n    coreHash: validatedRow.core_hash,\n    profileHash: validatedRow.profile_hash,\n    contractJson: validatedRow.contract_json ?? null,\n    canonicalVersion: validatedRow.canonical_version ?? null,\n    updatedAt,\n    appTag: validatedRow.app_tag ?? null,\n    meta: parseMeta(validatedRow.meta),\n  };\n}\n\n/**\n * Returns the SQL statement to read the contract marker.\n * This is a migration-plane helper (no runtime imports).\n * @internal - Used internally by readMarker(). Prefer readMarker() for Control Plane usage.\n */\nexport function readMarkerSql(): { readonly sql: string; readonly params: readonly unknown[] } {\n  return {\n    sql: `select\n      core_hash,\n      profile_hash,\n      contract_json,\n      canonical_version,\n      updated_at,\n      app_tag,\n      meta\n    from prisma_contract.marker\n    where id = $1`,\n    params: [1],\n  };\n}\n\n/**\n * Reads the contract marker from the database using the provided driver.\n * Returns the parsed marker record or null if no marker is found.\n * This abstracts SQL-specific details from the Control Plane.\n *\n * @param driver - ControlDriverInstance instance for executing queries\n * @returns Promise resolving to ContractMarkerRecord or null if marker not found\n */\nexport async function readMarker(\n  driver: ControlDriverInstance,\n): Promise<ContractMarkerRecord | null> {\n  const markerStatement = readMarkerSql();\n  const queryResult = await driver.query<{\n    core_hash: string;\n    profile_hash: string;\n    contract_json: unknown | null;\n    canonical_version: number | null;\n    updated_at: Date | string;\n    app_tag: string | null;\n    meta: unknown | null;\n  }>(markerStatement.sql, markerStatement.params);\n\n  if (queryResult.rows.length === 0) {\n    return null;\n  }\n\n  const markerRow = queryResult.rows[0];\n  if (!markerRow) {\n    // If rows array has length > 0 but first element is undefined, this is an unexpected result structure\n    throw new Error('Database query returned unexpected result structure');\n  }\n\n  return parseContractMarkerRow(markerRow);\n}\n\n/**\n * Collects supported codec type IDs from adapter and extension manifests.\n * Returns a sorted, unique array of type IDs that are declared in the manifests.\n * This enables coverage checks by comparing contract column types against supported types.\n *\n * Note: This extracts type IDs from manifest type imports, not from runtime codec registries.\n * The manifests declare which codec types are available, but the actual type IDs\n * are defined in the codec-types TypeScript modules that are imported.\n *\n * For MVP, we return an empty array since extracting type IDs from TypeScript modules\n * would require runtime evaluation or static analysis. This can be enhanced later.\n */\nexport function collectSupportedCodecTypeIds<TFamilyId extends string, TTargetId extends string>(\n  descriptors: ReadonlyArray<\n    | ControlTargetDescriptor<TFamilyId, TTargetId>\n    | ControlAdapterDescriptor<TFamilyId, TTargetId>\n    | ControlExtensionDescriptor<TFamilyId, TTargetId>\n  >,\n): readonly string[] {\n  // For MVP, return empty array\n  // Future enhancement: Extract type IDs from codec-types modules via static analysis\n  // or require manifests to explicitly list supported type IDs\n  void descriptors;\n  return [];\n}\n"],"mappings":";AAOA,SAAS,YAAY;AAErB,IAAM,aAAa,KAAK,EAAE,YAAY,UAAU,CAAC;AAEjD,SAAS,UAAU,MAAwC;AACzD,MAAI,SAAS,QAAQ,SAAS,QAAW;AACvC,WAAO,CAAC;AAAA,EACV;AAEA,MAAI;AACJ,MAAI,OAAO,SAAS,UAAU;AAC5B,QAAI;AACF,eAAS,KAAK,MAAM,IAAI;AAAA,IAC1B,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF,OAAO;AACL,aAAS;AAAA,EACX;AAEA,QAAM,SAAS,WAAW,MAAM;AAChC,MAAI,kBAAkB,KAAK,QAAQ;AACjC,WAAO,CAAC;AAAA,EACV;AAEA,SAAO;AACT;AAEA,IAAM,0BAA0B,KAAK;AAAA,EACnC,WAAW;AAAA,EACX,cAAc;AAAA,EACd,kBAAkB;AAAA,EAClB,sBAAsB;AAAA,EACtB,eAAe;AAAA,EACf,YAAY;AAAA,EACZ,SAAS;AACX,CAAC;AAMM,SAAS,uBAAuB,KAAoC;AACzE,QAAM,SAAS,wBAAwB,GAAG;AAC1C,MAAI,kBAAkB,KAAK,QAAQ;AACjC,UAAM,WAAW,OAAO,IAAI,CAAC,MAA2B,EAAE,OAAO,EAAE,KAAK,IAAI;AAC5E,UAAM,IAAI,MAAM,gCAAgC,QAAQ,EAAE;AAAA,EAC5D;AAEA,QAAM,eAAe;AAUrB,QAAM,YAAY,aAAa,aAC3B,aAAa,sBAAsB,OACjC,aAAa,aACb,IAAI,KAAK,aAAa,UAAU,IAClC,oBAAI,KAAK;AAEb,SAAO;AAAA,IACL,UAAU,aAAa;AAAA,IACvB,aAAa,aAAa;AAAA,IAC1B,cAAc,aAAa,iBAAiB;AAAA,IAC5C,kBAAkB,aAAa,qBAAqB;AAAA,IACpD;AAAA,IACA,QAAQ,aAAa,WAAW;AAAA,IAChC,MAAM,UAAU,aAAa,IAAI;AAAA,EACnC;AACF;AAOO,SAAS,gBAA+E;AAC7F,SAAO;AAAA,IACL,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUL,QAAQ,CAAC,CAAC;AAAA,EACZ;AACF;AAUA,eAAsB,WACpB,QACsC;AACtC,QAAM,kBAAkB,cAAc;AACtC,QAAM,cAAc,MAAM,OAAO,MAQ9B,gBAAgB,KAAK,gBAAgB,MAAM;AAE9C,MAAI,YAAY,KAAK,WAAW,GAAG;AACjC,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,YAAY,KAAK,CAAC;AACpC,MAAI,CAAC,WAAW;AAEd,UAAM,IAAI,MAAM,qDAAqD;AAAA,EACvE;AAEA,SAAO,uBAAuB,SAAS;AACzC;AAcO,SAAS,6BACd,aAKmB;AAInB,OAAK;AACL,SAAO,CAAC;AACV;","names":[]}