@prisma-next/contract 0.3.0-dev.34 → 0.3.0-dev.35

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

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

package/dist/types.d.mts

@@ -1,2 +1,2 @@
-import { $ as TypesImportSpec, A as ContractBase, F as DocumentStorage, G as PlanRefs, H as ParamDescriptor, I as ExecutionPlan, J as Source, K as ResultType, L as Expr, M as DocCollection, N as DocIndex, P as DocumentContract, Q as TypeRenderer, R as FieldType, U as ParameterizedCodecDescriptor, V as OperationManifest, W as PlanMeta, X as TypeRenderContext, Y as TargetFamilyHook, Z as TypeRenderEntry, et as ValidationContext, j as ContractMarkerRecord, tt as isDocumentContract, z as GenerateContractTypesOptions } from "./framework-components-CLCmcNJY.mjs";
-export { type ContractBase, type ContractMarkerRecord, type DocCollection, type DocIndex, type DocumentContract, type DocumentStorage, type ExecutionPlan, type Expr, type FieldType, type GenerateContractTypesOptions, type OperationManifest, type ParamDescriptor, type ParameterizedCodecDescriptor, type PlanMeta, type PlanRefs, type ResultType, type Source, type TargetFamilyHook, type TypeRenderContext, type TypeRenderEntry, type TypeRenderer, type TypesImportSpec, type ValidationContext, isDocumentContract };
+import { A as TypeRenderEntry, C as ProfileHashBase, D as StorageHashBase, E as Source, F as isDocumentContract, I as profileHash, M as TypesImportSpec, N as ValidationContext, O as TargetFamilyHook, P as coreHash, S as PlanRefs, T as ResultType, _ as GenerateContractTypesOptions, a as ContractMarkerRecord, b as ParameterizedCodecDescriptor, c as DocumentContract, d as ExecutionMutationDefault, f as ExecutionMutationDefaultValue, g as FieldType, h as Expr, i as ContractBase, j as TypeRenderer, k as TypeRenderContext, l as DocumentStorage, m as ExecutionSection, n as Brand, o as DocCollection, p as ExecutionPlan, r as ColumnDefault, s as DocIndex, t as $, u as ExecutionHashBase, v as GeneratedValueSpec, w as RenderTypeContext, x as PlanMeta, y as ParamDescriptor } from "./types-BJr2H3qm.mjs";
+export { type $, type Brand, type ColumnDefault, type ContractBase, type ContractMarkerRecord, type DocCollection, type DocIndex, type DocumentContract, type DocumentStorage, type ExecutionHashBase, type ExecutionMutationDefault, type ExecutionMutationDefaultValue, type ExecutionPlan, type ExecutionSection, type Expr, type FieldType, type GenerateContractTypesOptions, type GeneratedValueSpec, type ParamDescriptor, type ParameterizedCodecDescriptor, type PlanMeta, type PlanRefs, type ProfileHashBase, type RenderTypeContext, type ResultType, type Source, type StorageHashBase, type TargetFamilyHook, type TypeRenderContext, type TypeRenderEntry, type TypeRenderer, type TypesImportSpec, type ValidationContext, coreHash, isDocumentContract, profileHash };

package/dist/types.mjs

@@ -1,4 +1,10 @@
 //#region src/types.ts
+function coreHash(value) {
+	return value;
+}
+function profileHash(value) {
+	return value;
+}
 /**
 * Type guard to check if a contract is a Document contract
 */
@@ -7,5 +13,5 @@ function isDocumentContract(contract) {
 }
 
 //#endregion
-export { isDocumentContract };
+export { coreHash, isDocumentContract, profileHash };
 //# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"types.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { OperationRegistry } from '@prisma-next/operations';\nimport type { RenderTypeContext } from './framework-components';\nimport type { ContractIR } from './ir';\n\nexport interface ContractBase {\n  readonly schemaVersion: string;\n  readonly target: string;\n  readonly targetFamily: string;\n  readonly coreHash: string;\n  readonly profileHash?: string;\n  readonly capabilities: Record<string, Record<string, boolean>>;\n  readonly extensionPacks: Record<string, unknown>;\n  readonly meta: Record<string, unknown>;\n  readonly sources: Record<string, Source>;\n}\n\nexport interface FieldType {\n  readonly type: string;\n  readonly nullable: boolean;\n  readonly items?: FieldType;\n  readonly properties?: Record<string, FieldType>;\n}\n\nexport interface Source {\n  readonly readOnly: boolean;\n  readonly projection: Record<string, FieldType>;\n  readonly origin?: Record<string, unknown>;\n  readonly capabilities?: Record<string, boolean>;\n}\n\n// Document family types\nexport interface DocIndex {\n  readonly name: string;\n  readonly keys: Record<string, 'asc' | 'desc'>;\n  readonly unique?: boolean;\n  readonly where?: Expr;\n}\n\nexport type Expr =\n  | { readonly kind: 'eq'; readonly path: ReadonlyArray<string>; readonly value: unknown }\n  | { readonly kind: 'exists'; readonly path: ReadonlyArray<string> };\n\nexport interface DocCollection {\n  readonly name: string;\n  readonly id?: {\n    readonly strategy: 'auto' | 'client' | 'uuid' | 'cuid' | 'objectId';\n  };\n  readonly fields: Record<string, FieldType>;\n  readonly indexes?: ReadonlyArray<DocIndex>;\n  readonly readOnly?: boolean;\n}\n\nexport interface DocumentStorage {\n  readonly document: {\n    readonly collections: Record<string, DocCollection>;\n  };\n}\n\nexport interface DocumentContract extends ContractBase {\n  // Accept string to work with JSON imports; runtime validation ensures 'document'\n  readonly targetFamily: string;\n  readonly storage: DocumentStorage;\n}\n\n// Plan types - target-family agnostic execution types\nexport interface ParamDescriptor {\n  readonly index?: number;\n  readonly name?: string;\n  readonly codecId?: string;\n  readonly nativeType?: string;\n  readonly nullable?: boolean;\n  readonly source: 'dsl' | 'raw';\n  readonly refs?: { table: string; column: string };\n}\n\nexport interface PlanRefs {\n  readonly tables?: readonly string[];\n  readonly columns?: ReadonlyArray<{ table: string; column: string }>;\n  readonly indexes?: ReadonlyArray<{\n    readonly table: string;\n    readonly columns: ReadonlyArray<string>;\n    readonly name?: string;\n  }>;\n}\n\nexport interface PlanMeta {\n  readonly target: string;\n  readonly targetFamily?: string;\n  readonly coreHash: string;\n  readonly profileHash?: string;\n  readonly lane: string;\n  readonly annotations?: {\n    codecs?: Record<string, string>; // alias/param → codec id ('ns/name@v')\n    [key: string]: unknown;\n  };\n  readonly paramDescriptors: ReadonlyArray<ParamDescriptor>;\n  readonly refs?: PlanRefs;\n  readonly projection?: Record<string, string> | ReadonlyArray<string>;\n  /**\n   * Optional mapping of projection alias → column type ID (fully qualified ns/name@version).\n   * Used for codec resolution when AST+refs don't provide enough type info.\n   */\n  readonly projectionTypes?: Record<string, string>;\n}\n\n/**\n * Canonical execution plan shape used by runtimes.\n *\n * - Row is the inferred result row type (TypeScript-only).\n * - Ast is the optional, family-specific AST type (e.g. SQL QueryAst).\n *\n * The payload executed by the runtime is represented by the sql + params pair\n * for now; future families can specialize this via Ast or additional metadata.\n */\nexport interface ExecutionPlan<Row = unknown, Ast = unknown> {\n  readonly sql: string;\n  readonly params: readonly unknown[];\n  readonly ast?: Ast;\n  readonly meta: PlanMeta;\n  /**\n   * Phantom property to carry the Row generic for type-level utilities.\n   * Not set at runtime; used only for ResultType extraction.\n   */\n  readonly _row?: Row;\n}\n\n/**\n * Utility type to extract the Row type from an ExecutionPlan.\n * Example: `type Row = ResultType<typeof plan>`\n *\n * Works with both ExecutionPlan and SqlQueryPlan (SQL query plans before lowering).\n * SqlQueryPlan includes a phantom `_Row` property to preserve the generic parameter\n * for type extraction.\n */\nexport type ResultType<P> =\n  P extends ExecutionPlan<infer R, unknown> ? R : P extends { readonly _Row?: infer R } ? R : never;\n\n/**\n * Type guard to check if a contract is a Document contract\n */\nexport function isDocumentContract(contract: unknown): contract is DocumentContract {\n  return (\n    typeof contract === 'object' &&\n    contract !== null &&\n    'targetFamily' in contract &&\n    contract.targetFamily === 'document'\n  );\n}\n\n/**\n * Contract marker record stored in the database.\n * Represents the current contract identity for a database.\n */\nexport interface ContractMarkerRecord {\n  readonly coreHash: string;\n  readonly profileHash: string;\n  readonly contractJson: unknown | null;\n  readonly canonicalVersion: number | null;\n  readonly updatedAt: Date;\n  readonly appTag: string | null;\n  readonly meta: Record<string, unknown>;\n}\n\n// Emitter types - moved from @prisma-next/emitter to shared location\n/**\n * Specifies how to import TypeScript types from a package.\n * Used in extension pack manifests to declare codec and operation type imports.\n */\nexport interface TypesImportSpec {\n  readonly package: string;\n  readonly named: string;\n  readonly alias: string;\n}\n\n/**\n * Validation context passed to TargetFamilyHook.validateTypes().\n * Contains pre-assembled operation registry, type imports, and extension IDs.\n */\nexport interface ValidationContext {\n  readonly operationRegistry?: OperationRegistry;\n  readonly codecTypeImports?: ReadonlyArray<TypesImportSpec>;\n  readonly operationTypeImports?: ReadonlyArray<TypesImportSpec>;\n  readonly extensionIds?: ReadonlyArray<string>;\n  /**\n   * Parameterized codec descriptors collected from adapters and extensions.\n   * Map of codecId → descriptor for quick lookup during type generation.\n   */\n  readonly parameterizedCodecs?: Map<string, ParameterizedCodecDescriptor>;\n}\n\n/**\n * Context for rendering parameterized types during contract.d.ts generation.\n * Passed to type renderers so they can reference CodecTypes by name.\n */\nexport interface TypeRenderContext {\n  readonly codecTypesName: string;\n}\n\n/**\n * A normalized type renderer for parameterized codecs.\n * This is the interface expected by TargetFamilyHook.generateContractTypes.\n */\nexport interface TypeRenderEntry {\n  readonly codecId: string;\n  readonly render: (params: Record<string, unknown>, ctx: TypeRenderContext) => string;\n}\n\n/**\n * Additional options for generateContractTypes.\n */\nexport interface GenerateContractTypesOptions {\n  /**\n   * Normalized parameterized type renderers, keyed by codecId.\n   * When a column has typeParams and a renderer exists for its codecId,\n   * the renderer is called to produce the TypeScript type expression.\n   */\n  readonly parameterizedRenderers?: Map<string, TypeRenderEntry>;\n  /**\n   * Type imports for parameterized codecs.\n   * These are merged with codec and operation type imports in contract.d.ts.\n   */\n  readonly parameterizedTypeImports?: ReadonlyArray<TypesImportSpec>;\n}\n\n/**\n * SPI interface for target family hooks that extend emission behavior.\n * Implemented by family-specific emitter hooks (e.g., SQL family).\n */\nexport interface TargetFamilyHook {\n  readonly id: string;\n\n  /**\n   * Validates that all type IDs in the contract come from referenced extension packs.\n   * @param ir - Contract IR to validate\n   * @param ctx - Validation context with operation registry and extension IDs\n   */\n  validateTypes(ir: ContractIR, ctx: ValidationContext): void;\n\n  /**\n   * Validates family-specific contract structure.\n   * @param ir - Contract IR to validate\n   */\n  validateStructure(ir: ContractIR): void;\n\n  /**\n   * Generates contract.d.ts file content.\n   * @param ir - Contract IR\n   * @param codecTypeImports - Array of codec type import specs\n   * @param operationTypeImports - Array of operation type import specs\n   * @param options - Additional options including parameterized type renderers\n   * @returns Generated TypeScript type definitions as string\n   */\n  generateContractTypes(\n    ir: ContractIR,\n    codecTypeImports: ReadonlyArray<TypesImportSpec>,\n    operationTypeImports: ReadonlyArray<TypesImportSpec>,\n    options?: GenerateContractTypesOptions,\n  ): string;\n}\n\n// Extension pack manifest types - moved from @prisma-next/core-control-plane to shared location\nexport type ArgSpecManifest =\n  | { readonly kind: 'typeId'; readonly type: string }\n  | { readonly kind: 'param' }\n  | { readonly kind: 'literal' };\n\nexport type ReturnSpecManifest =\n  | { readonly kind: 'typeId'; readonly type: string }\n  | { readonly kind: 'builtin'; readonly type: 'number' | 'boolean' | 'string' };\n\nexport interface LoweringSpecManifest {\n  readonly targetFamily: 'sql';\n  readonly strategy: 'infix' | 'function';\n  readonly template: string;\n}\n\nexport interface OperationManifest {\n  readonly for: string;\n  readonly method: string;\n  readonly args: ReadonlyArray<ArgSpecManifest>;\n  readonly returns: ReturnSpecManifest;\n  readonly lowering: LoweringSpecManifest;\n  readonly capabilities?: ReadonlyArray<string>;\n}\n\n// ============================================================================\n// Parameterized Codec Descriptor Types\n// ============================================================================\n//\n// Types for codecs that support type parameters (e.g., Vector<1536>, Decimal<2>).\n// These enable precise TypeScript types for parameterized columns without\n// coupling the SQL family emitter to specific adapter codec IDs.\n//\n// ============================================================================\n\n// Re-export RenderTypeContext so it's available alongside TypeRenderer\nexport type { RenderTypeContext };\n\n/**\n * Declarative type renderer that produces a TypeScript type expression.\n *\n * Renderers can be:\n * - A template string with `{{paramName}}` placeholders (e.g., `Vector<{{length}}>`)\n * - A function that receives typeParams and context and returns a type expression\n *\n * **Prefer template strings** for most cases:\n * - Templates are JSON-serializable (safe for pack-ref metadata)\n * - Templates can be statically analyzed by tooling\n *\n * Function renderers are allowed but have tradeoffs:\n * - Require runtime execution during emission (the emitter runs code)\n * - Not JSON-serializable (can't be stored in contract.json)\n * - The emitted artifacts (contract.json, contract.d.ts) still contain no\n *   executable code - this constraint applies to outputs, not the emission process\n */\nexport type TypeRenderer =\n  | string\n  | ((params: Record<string, unknown>, ctx: RenderTypeContext) => string);\n\n/**\n * Descriptor for a codec that supports type parameters.\n *\n * Parameterized codecs allow columns to carry additional metadata (typeParams)\n * that affects the generated TypeScript types. For example:\n * - A vector codec can use `{ length: 1536 }` to generate `Vector<1536>`\n * - A decimal codec can use `{ precision: 10, scale: 2 }` to generate `Decimal<10, 2>`\n *\n * The SQL family emitter uses these descriptors to generate precise types\n * without hard-coding knowledge of specific codec IDs.\n *\n * @example\n * ```typescript\n * const vectorCodecDescriptor: ParameterizedCodecDescriptor = {\n *   codecId: 'pg/vector@1',\n *   outputTypeRenderer: 'Vector<{{length}}>',\n *   // Optional: paramsSchema for runtime validation\n * };\n * ```\n */\nexport interface ParameterizedCodecDescriptor {\n  /** The codec ID this descriptor applies to (e.g., 'pg/vector@1') */\n  readonly codecId: string;\n\n  /**\n   * Renderer for the output (read) type.\n   * Can be a template string or function.\n   *\n   * This is the primary renderer used by SQL emission to generate\n   * model field types in contract.d.ts.\n   */\n  readonly outputTypeRenderer: TypeRenderer;\n\n  /**\n   * Optional renderer for the input (write) type.\n   * If not provided, outputTypeRenderer is used for both.\n   *\n   * **Reserved for future use**: Currently, SQL emission only uses\n   * outputTypeRenderer. This field is defined for future support of\n   * asymmetric codecs where input and output types differ (e.g., a\n   * codec that accepts `string | number` but always returns `number`).\n   */\n  readonly inputTypeRenderer?: TypeRenderer;\n\n  /**\n   * Optional import spec for types used by this codec's renderers.\n   * The emitter will add this import to contract.d.ts.\n   */\n  readonly typesImport?: TypesImportSpec;\n}\n"],"mappings":";;;;AA4IA,SAAgB,mBAAmB,UAAiD;AAClF,QACE,OAAO,aAAa,YACpB,aAAa,QACb,kBAAkB,YAClB,SAAS,iBAAiB"}
+{"version":3,"file":"types.mjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { OperationRegistry } from '@prisma-next/operations';\nimport type { ContractIR } from './ir';\n\n/**\n * Unique symbol used as the key for branding types.\n */\nexport const $: unique symbol = Symbol('__prisma_next_brand__');\n\n/**\n * A helper type to brand a given type with a unique identifier.\n *\n * @template TKey Text used as the brand key.\n * @template TValue Optional value associated with the brand key. Defaults to `true`.\n */\nexport type Brand<TKey extends string | number | symbol, TValue = true> = {\n  [$]: {\n    [K in TKey]: TValue;\n  };\n};\n\n/**\n * Context passed to type renderers during contract.d.ts generation.\n */\nexport interface RenderTypeContext {\n  /** The name of the CodecTypes type alias (typically 'CodecTypes') */\n  readonly codecTypesName: string;\n}\n\n/**\n * Base type for storage contract hashes.\n * Emitted contract.d.ts files use this with the hash value as a type parameter:\n * `type StorageHash = StorageHashBase<'sha256:abc123...'>`\n */\nexport type StorageHashBase<THash extends string> = THash & Brand<'StorageHash'>;\n\n/**\n * Base type for execution contract hashes.\n * Emitted contract.d.ts files use this with the hash value as a type parameter:\n * `type ExecutionHash = ExecutionHashBase<'sha256:def456...'>`\n */\nexport type ExecutionHashBase<THash extends string> = THash & Brand<'ExecutionHash'>;\n\nexport function coreHash<const T extends string>(value: T): StorageHashBase<T> {\n  return value as StorageHashBase<T>;\n}\n\n/**\n * Base type for profile contract hashes.\n * Emitted contract.d.ts files use this with the hash value as a type parameter:\n * `type ProfileHash = ProfileHashBase<'sha256:def456...'>`\n */\nexport type ProfileHashBase<THash extends string> = THash & Brand<'ProfileHash'>;\n\nexport function profileHash<const T extends string>(value: T): ProfileHashBase<T> {\n  return value as ProfileHashBase<T>;\n}\n\nexport interface ContractBase<\n  TStorageHash extends StorageHashBase<string> = StorageHashBase<string>,\n  TExecutionHash extends ExecutionHashBase<string> = ExecutionHashBase<string>,\n  TProfileHash extends ProfileHashBase<string> = ProfileHashBase<string>,\n> {\n  readonly schemaVersion: string;\n  readonly target: string;\n  readonly targetFamily: string;\n  readonly storageHash: TStorageHash;\n  readonly executionHash?: TExecutionHash | undefined;\n  readonly profileHash?: TProfileHash | undefined;\n  readonly capabilities: Record<string, Record<string, boolean>>;\n  readonly extensionPacks: Record<string, unknown>;\n  readonly meta: Record<string, unknown>;\n  readonly sources: Record<string, Source>;\n  readonly execution?: ExecutionSection;\n}\n\nexport interface FieldType {\n  readonly type: string;\n  readonly nullable: boolean;\n  readonly items?: FieldType;\n  readonly properties?: Record<string, FieldType>;\n}\n\nexport type GeneratedValueSpec = {\n  readonly id: 'ulid' | 'nanoid' | 'uuidv7' | 'uuidv4' | 'cuid2' | 'ksuid';\n  readonly params?: Record<string, unknown>;\n};\n\nexport type ColumnDefault =\n  | {\n      readonly kind: 'literal';\n      readonly expression: string;\n    }\n  | { readonly kind: 'function'; readonly expression: string };\n\nexport type ExecutionMutationDefaultValue = {\n  readonly kind: 'generator';\n  readonly id: GeneratedValueSpec['id'];\n  readonly params?: Record<string, unknown>;\n};\n\nexport type ExecutionMutationDefault = {\n  readonly ref: { readonly table: string; readonly column: string };\n  readonly onCreate?: ExecutionMutationDefaultValue;\n  readonly onUpdate?: ExecutionMutationDefaultValue;\n};\n\nexport type ExecutionSection = {\n  readonly mutations: {\n    readonly defaults: ReadonlyArray<ExecutionMutationDefault>;\n  };\n};\n\nexport interface Source {\n  readonly readOnly: boolean;\n  readonly projection: Record<string, FieldType>;\n  readonly origin?: Record<string, unknown>;\n  readonly capabilities?: Record<string, boolean>;\n}\n\n// Document family types\nexport interface DocIndex {\n  readonly name: string;\n  readonly keys: Record<string, 'asc' | 'desc'>;\n  readonly unique?: boolean;\n  readonly where?: Expr;\n}\n\nexport type Expr =\n  | { readonly kind: 'eq'; readonly path: ReadonlyArray<string>; readonly value: unknown }\n  | { readonly kind: 'exists'; readonly path: ReadonlyArray<string> };\n\nexport interface DocCollection {\n  readonly name: string;\n  readonly id?: {\n    readonly strategy: 'auto' | 'client' | 'uuid' | 'objectId';\n  };\n  readonly fields: Record<string, FieldType>;\n  readonly indexes?: ReadonlyArray<DocIndex>;\n  readonly readOnly?: boolean;\n}\n\nexport interface DocumentStorage {\n  readonly document: {\n    readonly collections: Record<string, DocCollection>;\n  };\n}\n\nexport interface DocumentContract<\n  TStorageHash extends StorageHashBase<string> = StorageHashBase<string>,\n  TExecutionHash extends ExecutionHashBase<string> = ExecutionHashBase<string>,\n  TProfileHash extends ProfileHashBase<string> = ProfileHashBase<string>,\n> extends ContractBase<TStorageHash, TExecutionHash, TProfileHash> {\n  // Accept string to work with JSON imports; runtime validation ensures 'document'\n  readonly targetFamily: string;\n  readonly storage: DocumentStorage;\n}\n\n// Plan types - target-family agnostic execution types\nexport interface ParamDescriptor {\n  readonly index?: number;\n  readonly name?: string;\n  readonly codecId?: string;\n  readonly nativeType?: string;\n  readonly nullable?: boolean;\n  readonly source: 'dsl' | 'raw';\n  readonly refs?: { table: string; column: string };\n}\n\nexport interface PlanRefs {\n  readonly tables?: readonly string[];\n  readonly columns?: ReadonlyArray<{ table: string; column: string }>;\n  readonly indexes?: ReadonlyArray<{\n    readonly table: string;\n    readonly columns: ReadonlyArray<string>;\n    readonly name?: string;\n  }>;\n}\n\nexport interface PlanMeta {\n  readonly target: string;\n  readonly targetFamily?: string;\n  readonly storageHash: string;\n  readonly profileHash?: string;\n  readonly lane: string;\n  readonly annotations?: {\n    codecs?: Record<string, string>; // alias/param → codec id ('ns/name@v')\n    [key: string]: unknown;\n  };\n  readonly paramDescriptors: ReadonlyArray<ParamDescriptor>;\n  readonly refs?: PlanRefs;\n  readonly projection?: Record<string, string> | ReadonlyArray<string>;\n  /**\n   * Optional mapping of projection alias → column type ID (fully qualified ns/name@version).\n   * Used for codec resolution when AST+refs don't provide enough type info.\n   */\n  readonly projectionTypes?: Record<string, string>;\n}\n\n/**\n * Canonical execution plan shape used by runtimes.\n *\n * - Row is the inferred result row type (TypeScript-only).\n * - Ast is the optional, family-specific AST type (e.g. SQL QueryAst).\n *\n * The payload executed by the runtime is represented by the sql + params pair\n * for now; future families can specialize this via Ast or additional metadata.\n */\nexport interface ExecutionPlan<Row = unknown, Ast = unknown> {\n  readonly sql: string;\n  readonly params: readonly unknown[];\n  readonly ast?: Ast;\n  readonly meta: PlanMeta;\n  /**\n   * Phantom property to carry the Row generic for type-level utilities.\n   * Not set at runtime; used only for ResultType extraction.\n   */\n  readonly _row?: Row;\n}\n\n/**\n * Utility type to extract the Row type from an ExecutionPlan.\n * Example: `type Row = ResultType<typeof plan>`\n *\n * Works with both ExecutionPlan and SqlQueryPlan (SQL query plans before lowering).\n * SqlQueryPlan includes a phantom `_Row` property to preserve the generic parameter\n * for type extraction.\n */\nexport type ResultType<P> =\n  P extends ExecutionPlan<infer R, unknown> ? R : P extends { readonly _Row?: infer R } ? R : never;\n\n/**\n * Type guard to check if a contract is a Document contract\n */\nexport function isDocumentContract(contract: unknown): contract is DocumentContract {\n  return (\n    typeof contract === 'object' &&\n    contract !== null &&\n    'targetFamily' in contract &&\n    contract.targetFamily === 'document'\n  );\n}\n\n/**\n * Contract marker record stored in the database.\n * Represents the current contract identity for a database.\n */\nexport interface ContractMarkerRecord {\n  readonly storageHash: string;\n  readonly profileHash: string;\n  readonly contractJson: unknown | null;\n  readonly canonicalVersion: number | null;\n  readonly updatedAt: Date;\n  readonly appTag: string | null;\n  readonly meta: Record<string, unknown>;\n}\n\n// Emitter types - moved from @prisma-next/emitter to shared location\n/**\n * Specifies how to import TypeScript types from a package.\n * Used in extension pack manifests to declare codec and operation type imports.\n */\nexport interface TypesImportSpec {\n  readonly package: string;\n  readonly named: string;\n  readonly alias: string;\n}\n\n/**\n * Validation context passed to TargetFamilyHook.validateTypes().\n * Contains pre-assembled operation registry, type imports, and extension IDs.\n */\nexport interface ValidationContext {\n  readonly operationRegistry?: OperationRegistry;\n  readonly codecTypeImports?: ReadonlyArray<TypesImportSpec>;\n  readonly operationTypeImports?: ReadonlyArray<TypesImportSpec>;\n  readonly extensionIds?: ReadonlyArray<string>;\n  /**\n   * Parameterized codec descriptors collected from adapters and extensions.\n   * Map of codecId → descriptor for quick lookup during type generation.\n   */\n  readonly parameterizedCodecs?: Map<string, ParameterizedCodecDescriptor>;\n}\n\n/**\n * Context for rendering parameterized types during contract.d.ts generation.\n * Passed to type renderers so they can reference CodecTypes by name.\n */\nexport interface TypeRenderContext {\n  readonly codecTypesName: string;\n}\n\n/**\n * A normalized type renderer for parameterized codecs.\n * This is the interface expected by TargetFamilyHook.generateContractTypes.\n */\nexport interface TypeRenderEntry {\n  readonly codecId: string;\n  readonly render: (params: Record<string, unknown>, ctx: TypeRenderContext) => string;\n}\n\n/**\n * Additional options for generateContractTypes.\n */\nexport interface GenerateContractTypesOptions {\n  /**\n   * Normalized parameterized type renderers, keyed by codecId.\n   * When a column has typeParams and a renderer exists for its codecId,\n   * the renderer is called to produce the TypeScript type expression.\n   */\n  readonly parameterizedRenderers?: Map<string, TypeRenderEntry>;\n  /**\n   * Type imports for parameterized codecs.\n   * These are merged with codec and operation type imports in contract.d.ts.\n   */\n  readonly parameterizedTypeImports?: ReadonlyArray<TypesImportSpec>;\n}\n\n/**\n * SPI interface for target family hooks that extend emission behavior.\n * Implemented by family-specific emitter hooks (e.g., SQL family).\n */\nexport interface TargetFamilyHook {\n  readonly id: string;\n\n  /**\n   * Validates that all type IDs in the contract come from referenced extension packs.\n   * @param ir - Contract IR to validate\n   * @param ctx - Validation context with operation registry and extension IDs\n   */\n  validateTypes(ir: ContractIR, ctx: ValidationContext): void;\n\n  /**\n   * Validates family-specific contract structure.\n   * @param ir - Contract IR to validate\n   */\n  validateStructure(ir: ContractIR): void;\n\n  /**\n   * Generates contract.d.ts file content.\n   * @param ir - Contract IR\n   * @param codecTypeImports - Array of codec type import specs\n   * @param operationTypeImports - Array of operation type import specs\n   * @param hashes - Contract hash values (storageHash, executionHash, profileHash)\n   * @param options - Additional options including parameterized type renderers\n   * @returns Generated TypeScript type definitions as string\n   */\n  generateContractTypes(\n    ir: ContractIR,\n    codecTypeImports: ReadonlyArray<TypesImportSpec>,\n    operationTypeImports: ReadonlyArray<TypesImportSpec>,\n    hashes: {\n      readonly storageHash: string;\n      readonly executionHash?: string;\n      readonly profileHash: string;\n    },\n    options?: GenerateContractTypesOptions,\n  ): string;\n}\n\n// ============================================================================\n// Parameterized Codec Descriptor Types\n// ============================================================================\n//\n// Types for codecs that support type parameters (e.g., Vector<1536>, Decimal<2>).\n// These enable precise TypeScript types for parameterized columns without\n// coupling the SQL family emitter to specific adapter codec IDs.\n//\n// ============================================================================\n\n/**\n * Declarative type renderer that produces a TypeScript type expression.\n *\n * Renderers can be:\n * - A template string with `{{paramName}}` placeholders (e.g., `Vector<{{length}}>`)\n * - A function that receives typeParams and context and returns a type expression\n *\n * **Prefer template strings** for most cases:\n * - Templates are JSON-serializable (safe for pack-ref metadata)\n * - Templates can be statically analyzed by tooling\n *\n * Function renderers are allowed but have tradeoffs:\n * - Require runtime execution during emission (the emitter runs code)\n * - Not JSON-serializable (can't be stored in contract.json)\n * - The emitted artifacts (contract.json, contract.d.ts) still contain no\n *   executable code - this constraint applies to outputs, not the emission process\n */\nexport type TypeRenderer =\n  | string\n  | ((params: Record<string, unknown>, ctx: RenderTypeContext) => string);\n\n/**\n * Descriptor for a codec that supports type parameters.\n *\n * Parameterized codecs allow columns to carry additional metadata (typeParams)\n * that affects the generated TypeScript types. For example:\n * - A vector codec can use `{ length: 1536 }` to generate `Vector<1536>`\n * - A decimal codec can use `{ precision: 10, scale: 2 }` to generate `Decimal<10, 2>`\n *\n * The SQL family emitter uses these descriptors to generate precise types\n * without hard-coding knowledge of specific codec IDs.\n *\n * @example\n * ```typescript\n * const vectorCodecDescriptor: ParameterizedCodecDescriptor = {\n *   codecId: 'pg/vector@1',\n *   outputTypeRenderer: 'Vector<{{length}}>',\n *   // Optional: paramsSchema for runtime validation\n * };\n * ```\n */\nexport interface ParameterizedCodecDescriptor {\n  /** The codec ID this descriptor applies to (e.g., 'pg/vector@1') */\n  readonly codecId: string;\n\n  /**\n   * Renderer for the output (read) type.\n   * Can be a template string or function.\n   *\n   * This is the primary renderer used by SQL emission to generate\n   * model field types in contract.d.ts.\n   */\n  readonly outputTypeRenderer: TypeRenderer;\n\n  /**\n   * Optional renderer for the input (write) type.\n   * If not provided, outputTypeRenderer is used for both.\n   *\n   * **Reserved for future use**: Currently, SQL emission only uses\n   * outputTypeRenderer. This field is defined for future support of\n   * asymmetric codecs where input and output types differ (e.g., a\n   * codec that accepts `string | number` but always returns `number`).\n   */\n  readonly inputTypeRenderer?: TypeRenderer;\n\n  /**\n   * Optional import spec for types used by this codec's renderers.\n   * The emitter will add this import to contract.d.ts.\n   */\n  readonly typesImport?: TypesImportSpec;\n}\n"],"mappings":";AA0CA,SAAgB,SAAiC,OAA8B;AAC7E,QAAO;;AAUT,SAAgB,YAAoC,OAA8B;AAChF,QAAO;;;;;AAmLT,SAAgB,mBAAmB,UAAiD;AAClF,QACE,OAAO,aAAa,YACpB,aAAa,QACb,kBAAkB,YAClB,SAAS,iBAAiB"}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@prisma-next/contract",
-  "version": "0.3.0-dev.34",
+  "version": "0.3.0-dev.35",
   "type": "module",
   "sideEffects": false,
   "description": "Data contract type definitions and JSON schema for Prisma Next",
   "dependencies": {
-    "@prisma-next/operations": "0.3.0-dev.34"
+    "@prisma-next/operations": "0.3.0-dev.35"
   },
   "devDependencies": {
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
-    "vitest": "4.0.16",
+    "vitest": "4.0.17",
     "@prisma-next/test-utils": "0.0.1",
     "@prisma-next/tsconfig": "0.0.0",
     "@prisma-next/tsdown": "0.0.0"
@@ -26,10 +26,14 @@
   "exports": {
     "./framework-components": "./dist/framework-components.mjs",
     "./ir": "./dist/ir.mjs",
-    "./pack-manifest-types": "./dist/pack-manifest-types.mjs",
     "./types": "./dist/types.mjs",
     "./package.json": "./package.json"
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/prisma/prisma-next.git",
+    "directory": "packages/1-framework/1-core/shared/contract"
+  },
   "scripts": {
     "build": "tsdown",
     "test": "vitest run --passWithNoTests",

package/schemas/data-contract-document-v1.json

@@ -24,10 +24,15 @@
       "enum": ["document"],
       "description": "Target family classification"
     },
-    "coreHash": {
+    "storageHash": {
       "type": "string",
       "pattern": "^sha256:[a-f0-9]{64}$",
-      "description": "SHA-256 hash of the core schema structure (models, fields, relations, storage layout)"
+      "description": "SHA-256 hash of the storage section (DB-satisfied expectations)"
+    },
+    "executionHash": {
+      "type": "string",
+      "pattern": "^sha256:[a-f0-9]{64}$",
+      "description": "SHA-256 hash of the execution section (client-side behavior)"
     },
     "profileHash": {
       "type": "string",
@@ -85,7 +90,7 @@
       "required": ["document"]
     }
   },
-  "required": ["schemaVersion", "target", "targetFamily", "coreHash", "storage"],
+  "required": ["schemaVersion", "target", "targetFamily", "storageHash", "storage"],
   "$defs": {
     "DocCollection": {
       "type": "object",
@@ -103,7 +108,7 @@
           "properties": {
             "strategy": {
               "type": "string",
-              "enum": ["auto", "client", "uuid", "cuid", "objectId"],
+              "enum": ["auto", "client", "uuid", "objectId"],
               "description": "ID generation strategy"
             }
           }

package/src/exports/framework-components.ts

@@ -19,7 +19,6 @@ export type {
   // Type renderers for parameterized codec emission
   NormalizedTypeRenderer,
   PackRefBase,
-  RenderTypeContext,
   TargetBoundComponentDescriptor,
   TargetDescriptor,
   TargetInstance,

package/src/exports/types.ts

@@ -1,27 +1,31 @@
-// Shared types
-// Document family types
-// Plan types - target-family agnostic execution types
-// Emitter types (moved from @prisma-next/emitter)
-// Parameterized codec descriptor types
 export type {
+  $,
+  Brand,
+  ColumnDefault,
   ContractBase,
   ContractMarkerRecord,
   DocCollection,
   DocIndex,
   DocumentContract,
   DocumentStorage,
+  ExecutionHashBase,
+  ExecutionMutationDefault,
+  ExecutionMutationDefaultValue,
   ExecutionPlan,
+  ExecutionSection,
   Expr,
   FieldType,
-  // Type generation options for parameterized codecs
   GenerateContractTypesOptions,
-  OperationManifest,
+  GeneratedValueSpec,
   ParamDescriptor,
   ParameterizedCodecDescriptor,
   PlanMeta,
   PlanRefs,
+  ProfileHashBase,
+  RenderTypeContext,
   ResultType,
   Source,
+  StorageHashBase,
   TargetFamilyHook,
   TypeRenderContext,
   TypeRenderEntry,
@@ -29,5 +33,4 @@ export type {
   TypesImportSpec,
   ValidationContext,
 } from '../types';
-// Type guards
-export { isDocumentContract } from '../types';
+export { coreHash, isDocumentContract, profileHash } from '../types';

package/src/framework-components.ts

@@ -1,27 +1,4 @@
-import type { OperationManifest, TypesImportSpec } from './types';
-
-// ============================================================================
-// Type Renderer Types (for parameterized codec emission)
-// ============================================================================
-//
-// TypeRenderer supports author-friendly authoring (template strings) that are
-// normalized to functions during pack assembly. The emitter only receives
-// normalized (function-form) renderers.
-//
-// Lifecycle:
-//   1. Authoring: Descriptor author uses template string or function
-//   2. Assembly: Templates are compiled to functions via normalizeRenderer()
-//   3. Emission: Emitter calls normalized render functions
-//
-// ============================================================================
-
-/**
- * Context passed to type renderers during contract.d.ts generation.
- */
-export interface RenderTypeContext {
-  /** The name of the CodecTypes type alias (typically 'CodecTypes') */
-  readonly codecTypesName: string;
-}
+import type { RenderTypeContext, TypesImportSpec } from './types';
 
 /**
  * A template-based type renderer (structured form).
@@ -172,38 +149,8 @@ export function normalizeRenderer(codecId: string, renderer: TypeRenderer): Norm
   };
 }
 
-// ============================================================================
-// Framework Component Descriptor Base Types
-// ============================================================================
-//
-// Prisma Next uses a modular architecture where functionality is composed from
-// discrete "components". Each component has a descriptor that identifies it and
-// provides metadata. These base types define the shared structure for all
-// component descriptors across both control-plane (CLI/tooling) and runtime-plane.
-//
-// Component Hierarchy:
-//
-//   Family (e.g., 'sql', 'document')
-//     └── Target (e.g., 'postgres', 'mysql', 'mongodb')
-//           ├── Adapter (protocol/dialect implementation)
-//           ├── Driver (connection/execution layer)
-//           └── Extension (optional capabilities like pgvector)
-//
-// Key design decisions:
-// - "Component" terminology separates framework building blocks from delivery
-//   mechanism ("pack" refers to how components are packaged/distributed)
-// - `kind` is extensible (Kind extends string) - no closed union, allowing
-//   ecosystem authors to define new component kinds
-// - Target-bound descriptors are generic in TFamilyId and TTargetId for type-safe
-//   composition (e.g., TypeScript rejects Postgres adapter with MySQL target)
-// - Descriptors own declarative fields directly (version, types, operations, etc.)
-//   rather than nesting them under a `manifest` property
-//
-// ============================================================================
-
 /**
  * Declarative fields that describe component metadata.
- * These fields are owned directly by descriptors (not nested under a manifest).
  */
 export interface ComponentMetadata {
   /** Component version (semver) */
@@ -244,6 +191,11 @@ export interface ComponentMetadata {
        * Example: `Vector<N>` for pgvector renderers that emit `Vector<{{length}}>`
        */
       readonly typeImports?: ReadonlyArray<TypesImportSpec>;
+      /**
+       * Optional control-plane hooks keyed by codecId.
+       * Used by family-specific planners/verifiers to handle storage types.
+       */
+      readonly controlPlaneHooks?: Record<string, unknown>;
     };
     readonly operationTypes?: { readonly import: TypesImportSpec };
     readonly storage?: ReadonlyArray<{
@@ -253,9 +205,6 @@ export interface ComponentMetadata {
       readonly nativeType?: string;
     }>;
   };
-
-  /** Operation manifests for building operation registries */
-  readonly operations?: ReadonlyArray<OperationManifest>;
 }
 
 /**
@@ -588,17 +537,6 @@ export type TargetBoundComponentDescriptor<TFamilyId extends string, TTargetId e
   | DriverDescriptor<TFamilyId, TTargetId>
   | ExtensionDescriptor<TFamilyId, TTargetId>;
 
-// ============================================================================
-// Framework Component Instance Base Types
-// ============================================================================
-//
-// These are minimal, identity-only interfaces for component instances.
-// They carry the component's identity (familyId, targetId) without any
-// behavior methods. Plane-specific interfaces (ControlFamilyInstance,
-// RuntimeFamilyInstance, etc.) extend these bases and add domain actions.
-//
-// ============================================================================
-
 /**
  * Base interface for family instances.
  *

package/src/ir.ts

@@ -1,3 +1,10 @@
+function ifDefined<K extends string, V>(
+  key: K,
+  value: V | undefined,
+): Record<never, never> | { [P in K]: V } {
+  return value !== undefined ? ({ [key]: value } as { [P in K]: V }) : {};
+}
+
 /**
  * ContractIR types and factories for building contract intermediate representation.
  * ContractIR is family-agnostic and used by authoring, emitter, and no-emit runtime.
@@ -6,12 +13,13 @@
 /**
  * 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.
+ * Note: storageHash/executionHash and profileHash are computed by the emitter, not part of the IR.
  */
 export 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>,
+  TExecution extends Record<string, unknown> = Record<string, unknown>,
 > {
   readonly schemaVersion: string;
   readonly targetFamily: string;
@@ -19,6 +27,7 @@ export interface ContractIR<
   readonly models: TModels;
   readonly relations: TRelations;
   readonly storage: TStorage;
+  readonly execution?: TExecution;
   readonly extensionPacks: Record<string, unknown>;
   readonly capabilities: Record<string, Record<string, boolean>>;
   readonly meta: Record<string, unknown>;
@@ -27,26 +36,29 @@ export interface ContractIR<
 
 /**
  * Creates the header portion of a ContractIR.
- * Contains schema version, target, target family, core hash, and optional profile hash.
+ * Contains schema version, target, target family, storage hash, and optional profile hash.
  */
 export function irHeader(opts: {
   target: string;
   targetFamily: string;
-  coreHash: string;
+  storageHash: string;
+  executionHash?: string | undefined;
   profileHash?: string | undefined;
 }): {
   readonly schemaVersion: string;
   readonly target: string;
   readonly targetFamily: string;
-  readonly coreHash: string;
+  readonly storageHash: string;
+  readonly executionHash?: string | undefined;
   readonly profileHash?: string | undefined;
 } {
   return {
     schemaVersion: '1',
     target: opts.target,
     targetFamily: opts.targetFamily,
-    coreHash: opts.coreHash,
-    ...(opts.profileHash !== undefined && { profileHash: opts.profileHash }),
+    storageHash: opts.storageHash,
+    ...ifDefined('executionHash', opts.executionHash),
+    ...ifDefined('profileHash', opts.profileHash),
   };
 }
 
@@ -82,12 +94,14 @@ export function contractIR<
   TStorage extends Record<string, unknown>,
   TModels extends Record<string, unknown>,
   TRelations extends Record<string, unknown>,
+  TExecution extends Record<string, unknown>,
 >(opts: {
   header: {
     readonly schemaVersion: string;
     readonly target: string;
     readonly targetFamily: string;
-    readonly coreHash: string;
+    readonly storageHash: string;
+    readonly executionHash?: string | undefined;
     readonly profileHash?: string | undefined;
   };
   meta: {
@@ -99,8 +113,9 @@ export function contractIR<
   storage: TStorage;
   models: TModels;
   relations: TRelations;
-}): ContractIR<TStorage, TModels, TRelations> {
-  // ContractIR doesn't include coreHash or profileHash (those are computed by emitter)
+  execution?: TExecution;
+}): ContractIR<TStorage, TModels, TRelations, TExecution> {
+  // ContractIR doesn't include storageHash/executionHash or profileHash (those are computed by emitter)
   return {
     schemaVersion: opts.header.schemaVersion,
     target: opts.header.target,
@@ -109,5 +124,6 @@ export function contractIR<
     storage: opts.storage,
     models: opts.models,
     relations: opts.relations,
+    ...ifDefined('execution', opts.execution),
   };
 }