@prisma-next/sql-contract-ts 0.3.0-dev.87 → 0.3.0-dev.88

package/dist/contract-builder.mjs

@@ -51,7 +51,9 @@ const ModelSchema = type.declare().type({
 });
 const ExecutionMutationDefaultValueSchema = type({
 	kind: "'generator'",
-	id: "'ulid' | 'nanoid' | 'uuidv7' | 'uuidv4' | 'cuid2' | 'ksuid'",
+	id: type("string").narrow((value, ctx) => {
+		return /^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(value) ? true : ctx.mustBe("a flat generator id");
+	}),
 	"params?": "Record<string, unknown>"
 });
 const ExecutionSchema = type({ mutations: { defaults: type({

package/dist/contract-builder.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"contract-builder.mjs","names":["modelToTable: Record<string, string>","tableToModel: Record<string, string>","fieldToColumn: Record<string, Record<string, string>>","columnToField: Record<string, Record<string, string>>","modelFieldToColumn: Record<string, string>","executionDefaults: ExecutionMutationDefault[]","storage: BuildStorage<Tables, Types>","modelsPartial: Partial<BuildModels<Models>>","fields: Partial<Record<string, ModelField>>","relationsPartial: Partial<Record<string, Record<string, RelationDefinition>>>","extensionPacks: Record<string, unknown>"],"sources":["../src/contract.ts","../src/contract-builder.ts"],"sourcesContent":["import type {\n  ModelDefinition,\n  ModelField,\n  ModelStorage,\n  PrimaryKey,\n  SqlContract,\n  SqlMappings,\n  SqlStorage,\n  StorageTypeInstance,\n  UniqueConstraint,\n} from '@prisma-next/sql-contract/types';\nimport { decodeContractDefaults } from '@prisma-next/sql-contract/validate';\nimport {\n  ColumnDefaultSchema,\n  ForeignKeySchema,\n  IndexSchema,\n} from '@prisma-next/sql-contract/validators';\nimport { type } from 'arktype';\nimport type { O } from 'ts-toolbelt';\n\n/**\n * Structural validation schema for SqlContract using Arktype.\n * This validates the shape and types of the contract structure.\n */\n\nconst StorageColumnSchema = type({\n  nativeType: 'string',\n  codecId: 'string',\n  nullable: 'boolean',\n  'typeParams?': 'Record<string, unknown>',\n  'typeRef?': 'string',\n  'default?': ColumnDefaultSchema,\n});\n\nconst StorageTypeInstanceSchema = type.declare<StorageTypeInstance>().type({\n  codecId: 'string',\n  nativeType: 'string',\n  typeParams: 'Record<string, unknown>',\n});\n\nconst PrimaryKeySchema = type.declare<PrimaryKey>().type({\n  columns: type.string.array().readonly(),\n  'name?': 'string',\n});\n\nconst UniqueConstraintSchema = type.declare<UniqueConstraint>().type({\n  columns: type.string.array().readonly(),\n  'name?': 'string',\n});\n\nconst StorageTableSchema = type({\n  columns: type({ '[string]': StorageColumnSchema }),\n  'primaryKey?': PrimaryKeySchema,\n  uniques: UniqueConstraintSchema.array().readonly(),\n  indexes: IndexSchema.array().readonly(),\n  foreignKeys: ForeignKeySchema.array().readonly(),\n});\n\nconst StorageSchema = type({\n  tables: type({ '[string]': StorageTableSchema }),\n  'types?': type({ '[string]': StorageTypeInstanceSchema }),\n});\n\nconst ModelFieldSchema = type.declare<ModelField>().type({\n  column: 'string',\n});\n\nconst ModelStorageSchema = type.declare<ModelStorage>().type({\n  table: 'string',\n});\n\nconst ModelSchema = type.declare<ModelDefinition>().type({\n  storage: ModelStorageSchema,\n  fields: type({ '[string]': ModelFieldSchema }),\n  relations: type({ '[string]': 'unknown' }),\n});\n\nconst ExecutionMutationDefaultValueSchema = type({\n  kind: \"'generator'\",\n  id: \"'ulid' | 'nanoid' | 'uuidv7' | 'uuidv4' | 'cuid2' | 'ksuid'\",\n  'params?': 'Record<string, unknown>',\n});\n\nconst ExecutionMutationDefaultSchema = type({\n  ref: {\n    table: 'string',\n    column: 'string',\n  },\n  'onCreate?': ExecutionMutationDefaultValueSchema,\n  'onUpdate?': ExecutionMutationDefaultValueSchema,\n});\n\nconst ExecutionSchema = type({\n  mutations: {\n    defaults: ExecutionMutationDefaultSchema.array().readonly(),\n  },\n});\n\n/**\n * Complete SqlContract schema for structural validation.\n * This validates the entire contract structure at once.\n */\nconst SqlContractSchema = type({\n  'schemaVersion?': \"'1'\",\n  target: 'string',\n  targetFamily: \"'sql'\",\n  storageHash: 'string',\n  'executionHash?': 'string',\n  'profileHash?': 'string',\n  'capabilities?': 'Record<string, Record<string, boolean>>',\n  'extensionPacks?': 'Record<string, unknown>',\n  'meta?': 'Record<string, unknown>',\n  'sources?': 'Record<string, unknown>',\n  models: type({ '[string]': ModelSchema }),\n  storage: StorageSchema,\n  'execution?': ExecutionSchema,\n});\n\n/**\n * Validates the structural shape of a SqlContract using Arktype.\n *\n * **Responsibility: Validation Only**\n * This function validates that the contract has the correct structure and types.\n * It does NOT normalize the contract - normalization must happen in the contract builder.\n *\n * The contract passed to this function must already be normalized (all required fields present).\n * If normalization is needed, it should be done by the contract builder before calling this function.\n *\n * This ensures all required fields are present and have the correct types.\n *\n * @param value - The contract value to validate (typically from a JSON import)\n * @returns The validated contract if structure is valid\n * @throws Error if the contract structure is invalid\n */\nfunction validateContractStructure<T extends SqlContract<SqlStorage>>(\n  value: unknown,\n): O.Overwrite<T, { targetFamily: 'sql' }> {\n  // Check targetFamily first to provide a clear error message for unsupported target families\n  const rawValue = value as { targetFamily?: string };\n  if (rawValue.targetFamily !== undefined && rawValue.targetFamily !== 'sql') {\n    /* c8 ignore next */\n    throw new Error(`Unsupported target family: ${rawValue.targetFamily}`);\n  }\n\n  const contractResult = SqlContractSchema(value);\n\n  if (contractResult instanceof type.errors) {\n    const messages = contractResult.map((p: { message: string }) => p.message).join('; ');\n    throw new Error(`Contract structural validation failed: ${messages}`);\n  }\n\n  // After validation, contractResult matches the schema and preserves the input structure\n  // TypeScript needs an assertion here due to exactOptionalPropertyTypes differences\n  // between Arktype's inferred type and the generic T, but runtime-wise they're compatible\n  return contractResult as O.Overwrite<T, { targetFamily: 'sql' }>;\n}\n\n/**\n * Computes mapping dictionaries from models and storage structures.\n * Assumes valid input - validation happens separately in validateContractLogic().\n *\n * @param models - Models object from contract\n * @param storage - Storage object from contract\n * @param existingMappings - Existing mappings from contract input (optional)\n * @returns Computed mappings dictionary\n */\nexport function computeMappings(\n  models: Record<string, ModelDefinition>,\n  _storage: SqlStorage,\n  existingMappings?: Partial<SqlMappings>,\n): SqlMappings {\n  const modelToTable: Record<string, string> = {};\n  const tableToModel: Record<string, string> = {};\n  const fieldToColumn: Record<string, Record<string, string>> = {};\n  const columnToField: Record<string, Record<string, string>> = {};\n\n  for (const [modelName, model] of Object.entries(models)) {\n    const tableName = model.storage.table;\n    modelToTable[modelName] = tableName;\n    tableToModel[tableName] = modelName;\n\n    const modelFieldToColumn: Record<string, string> = {};\n    for (const [fieldName, field] of Object.entries(model.fields)) {\n      const columnName = field.column;\n      modelFieldToColumn[fieldName] = columnName;\n\n      if (!columnToField[tableName]) {\n        columnToField[tableName] = {};\n      }\n      columnToField[tableName][columnName] = fieldName;\n    }\n    fieldToColumn[modelName] = modelFieldToColumn;\n  }\n\n  return {\n    modelToTable: existingMappings?.modelToTable ?? modelToTable,\n    tableToModel: existingMappings?.tableToModel ?? tableToModel,\n    fieldToColumn: existingMappings?.fieldToColumn ?? fieldToColumn,\n    columnToField: existingMappings?.columnToField ?? columnToField,\n  };\n}\n\n/**\n * Validates logical consistency of a **structurally validated** SqlContract.\n * This checks that references (e.g., foreign keys, primary keys, uniques) point to storage objects that already exist.\n * Structural validation is expected to have already completed before this helper runs.\n *\n * Rule: keep this focused on structural consistency only; capability/feature\n * gating (e.g., defaults.*) belongs in migration/runtime verification, not here.\n *\n * @param structurallyValidatedContract - The contract whose structure has already been validated\n * @throws Error if logical validation fails\n */\nfunction validateContractLogic(structurallyValidatedContract: SqlContract<SqlStorage>): void {\n  const { storage, models } = structurallyValidatedContract;\n  const tableNames = new Set(Object.keys(storage.tables));\n\n  // Validate storage.types if present\n  if (storage.types) {\n    for (const [typeName, typeInstance] of Object.entries(storage.types)) {\n      // Validate typeParams is not an array (arrays are objects in JS but not valid here)\n      if (Array.isArray(typeInstance.typeParams)) {\n        throw new Error(\n          `Type instance \"${typeName}\" has invalid typeParams: must be a plain object, not an array`,\n        );\n      }\n    }\n  }\n\n  // Validate columns in all tables\n  for (const [tableName, table] of Object.entries(storage.tables)) {\n    for (const [columnName, column] of Object.entries(table.columns)) {\n      // Validate typeParams and typeRef are mutually exclusive\n      if (column.typeParams !== undefined && column.typeRef !== undefined) {\n        throw new Error(\n          `Column \"${columnName}\" in table \"${tableName}\" has both typeParams and typeRef; these are mutually exclusive`,\n        );\n      }\n\n      // Validate typeParams is not an array (arrays are objects in JS but not valid here)\n      if (column.typeParams !== undefined && Array.isArray(column.typeParams)) {\n        throw new Error(\n          `Column \"${columnName}\" in table \"${tableName}\" has invalid typeParams: must be a plain object, not an array`,\n        );\n      }\n\n      // Validate NOT NULL columns do not have literal null defaults\n      if (!column.nullable && column.default?.kind === 'literal' && column.default.value === null) {\n        throw new Error(\n          `Table \"${tableName}\" column \"${columnName}\" is NOT NULL but has a literal null default`,\n        );\n      }\n\n      // Validate typeRef points to an existing storage.types key and matches codecId/nativeType\n      if (column.typeRef !== undefined) {\n        const referencedType = storage.types?.[column.typeRef];\n        if (!referencedType) {\n          throw new Error(\n            `Column \"${columnName}\" in table \"${tableName}\" references non-existent type instance \"${column.typeRef}\" (not found in storage.types)`,\n          );\n        }\n\n        if (column.codecId !== referencedType.codecId) {\n          throw new Error(\n            `Column \"${columnName}\" in table \"${tableName}\" has codecId \"${column.codecId}\" but references type instance \"${column.typeRef}\" with codecId \"${referencedType.codecId}\"`,\n          );\n        }\n\n        if (column.nativeType !== referencedType.nativeType) {\n          throw new Error(\n            `Column \"${columnName}\" in table \"${tableName}\" has nativeType \"${column.nativeType}\" but references type instance \"${column.typeRef}\" with nativeType \"${referencedType.nativeType}\"`,\n          );\n        }\n      }\n    }\n  }\n\n  // Validate models\n  for (const [modelName, modelUnknown] of Object.entries(models)) {\n    const model = modelUnknown as ModelDefinition;\n    // Validate model has storage.table\n    if (!model.storage?.table) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" is missing storage.table`);\n    }\n\n    const tableName = model.storage.table;\n\n    // Validate model's table exists in storage\n    if (!tableNames.has(tableName)) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" references non-existent table \"${tableName}\"`);\n    }\n\n    const table = storage.tables[tableName];\n    if (!table) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" references non-existent table \"${tableName}\"`);\n    }\n\n    // Validate model's table has a primary key\n    if (!table.primaryKey) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" table \"${tableName}\" is missing a primary key`);\n    }\n\n    const columnNames = new Set(Object.keys(table.columns));\n\n    // Validate model fields\n    if (!model.fields) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" is missing fields`);\n    }\n\n    for (const [fieldName, fieldUnknown] of Object.entries(model.fields)) {\n      const field = fieldUnknown as { column: string };\n      // Validate field has column property\n      if (!field.column) {\n        /* c8 ignore next */\n        throw new Error(`Model \"${modelName}\" field \"${fieldName}\" is missing column property`);\n      }\n\n      // Validate field's column exists in the model's backing table\n      if (!columnNames.has(field.column)) {\n        /* c8 ignore next */\n        throw new Error(\n          `Model \"${modelName}\" field \"${fieldName}\" references non-existent column \"${field.column}\" in table \"${tableName}\"`,\n        );\n      }\n    }\n\n    // Validate model relations have corresponding foreign keys\n    if (model.relations) {\n      for (const [relationName, relation] of Object.entries(model.relations)) {\n        // For now, we'll do basic validation. Full FK validation can be added later\n        // This would require checking that the relation's on.parentCols/childCols match FKs\n        if (\n          typeof relation === 'object' &&\n          relation !== null &&\n          'on' in relation &&\n          'to' in relation\n        ) {\n          const on = relation.on as { parentCols?: string[]; childCols?: string[] };\n          const cardinality = (relation as { cardinality?: string }).cardinality;\n          if (on.parentCols && on.childCols) {\n            // For 1:N relations, the foreign key is on the child table\n            // For N:1 relations, the foreign key is on the parent table (this table)\n            // For now, we'll skip validation for 1:N relations as the FK is on the child table\n            // and we'll validate it when we process the child model\n            if (cardinality === '1:N') {\n              // Foreign key is on the child table, skip validation here\n              // It will be validated when we process the child model\n              continue;\n            }\n\n            // For N:1 relations, check that there's a foreign key matching this relation\n            const hasMatchingFk = table.foreignKeys?.some((fk) => {\n              return (\n                fk.columns.length === on.childCols?.length &&\n                fk.columns.every((col, i) => col === on.childCols?.[i]) &&\n                fk.references.table &&\n                fk.references.columns.length === on.parentCols?.length &&\n                fk.references.columns.every((col, i) => col === on.parentCols?.[i])\n              );\n            });\n\n            if (!hasMatchingFk) {\n              /* c8 ignore next */\n              throw new Error(\n                `Model \"${modelName}\" relation \"${relationName}\" does not have a corresponding foreign key in table \"${tableName}\"`,\n              );\n            }\n          }\n        }\n      }\n    }\n  }\n\n  for (const [tableName, table] of Object.entries(storage.tables)) {\n    const columnNames = new Set(Object.keys(table.columns));\n\n    // Validate primaryKey references existing columns\n    if (table.primaryKey) {\n      for (const colName of table.primaryKey.columns) {\n        if (!columnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(\n            `Table \"${tableName}\" primaryKey references non-existent column \"${colName}\"`,\n          );\n        }\n      }\n    }\n\n    // Validate unique constraints reference existing columns\n    for (const unique of table.uniques) {\n      for (const colName of unique.columns) {\n        if (!columnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(\n            `Table \"${tableName}\" unique constraint references non-existent column \"${colName}\"`,\n          );\n        }\n      }\n    }\n\n    // Validate indexes reference existing columns\n    for (const index of table.indexes) {\n      for (const colName of index.columns) {\n        if (!columnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(`Table \"${tableName}\" index references non-existent column \"${colName}\"`);\n        }\n      }\n    }\n\n    // Validate foreignKeys reference existing tables and columns\n    for (const fk of table.foreignKeys) {\n      // Validate FK columns exist in the referencing table\n      for (const colName of fk.columns) {\n        if (!columnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(\n            `Table \"${tableName}\" foreignKey references non-existent column \"${colName}\"`,\n          );\n        }\n      }\n\n      // Validate referenced table exists\n      if (!tableNames.has(fk.references.table)) {\n        /* c8 ignore next */\n        throw new Error(\n          `Table \"${tableName}\" foreignKey references non-existent table \"${fk.references.table}\"`,\n        );\n      }\n\n      // Validate referenced columns exist in the referenced table\n      const referencedTable = storage.tables[fk.references.table];\n      if (!referencedTable) {\n        /* c8 ignore next */\n        throw new Error(\n          `Table \"${tableName}\" foreignKey references non-existent table \"${fk.references.table}\"`,\n        );\n      }\n      const referencedColumnNames = new Set(Object.keys(referencedTable.columns));\n\n      for (const colName of fk.references.columns) {\n        if (!referencedColumnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(\n            `Table \"${tableName}\" foreignKey references non-existent column \"${colName}\" in table \"${fk.references.table}\"`,\n          );\n        }\n      }\n\n      if (fk.columns.length !== fk.references.columns.length) {\n        /* c8 ignore next */\n        throw new Error(\n          `Table \"${tableName}\" foreignKey column count (${fk.columns.length}) does not match referenced column count (${fk.references.columns.length})`,\n        );\n      }\n    }\n  }\n}\n\nimport { normalizeContract } from '@prisma-next/sql-contract/validate';\nexport { normalizeContract };\n\n/**\n * Validates that a JSON import conforms to the SqlContract structure\n * and returns a fully typed SqlContract.\n *\n * This function is specifically for validating JSON imports (e.g., from contract.json).\n * Contracts created via the builder API (defineContract) are already valid and should\n * not be passed to this function - use them directly without validation.\n *\n * Performs both structural validation (using Arktype) and logical validation\n * (ensuring all references are valid).\n *\n *\n * The type parameter `TContract` must be a fully-typed contract type (e.g., from `contract.d.ts`),\n * NOT a generic `SqlContract<SqlStorage>`.\n *\n * **Correct:**\n * ```typescript\n * import type { Contract } from './contract.d';\n * const contract = validateContract<Contract>(contractJson);\n * ```\n *\n * **Incorrect:**\n * ```typescript\n * import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';\n * const contract = validateContract<SqlContract<SqlStorage>>(contractJson);\n * // ❌ Types will be inferred as 'unknown' - this won't work!\n * ```\n *\n * The type parameter provides the specific table structure, column types, and model definitions.\n * This function validates the runtime structure matches the type, but does not infer types\n * from JSON (as JSON imports lose literal type information).\n *\n * @param value - The contract value to validate (must be from a JSON import, not a builder)\n * @returns A validated contract matching the TContract type\n * @throws Error if the contract structure or logic is invalid\n */\nexport function validateContract<TContract extends SqlContract<SqlStorage>>(\n  value: unknown,\n): TContract {\n  // Normalize contract first (add defaults for missing fields)\n  const normalized = normalizeContract(value);\n\n  const structurallyValid = validateContractStructure<SqlContract<SqlStorage>>(normalized);\n\n  const contractForValidation = structurallyValid as SqlContract<SqlStorage>;\n\n  // Validate contract logic (contracts must already have fully qualified type IDs)\n  validateContractLogic(contractForValidation);\n\n  // Extract existing mappings (optional - will be computed if missing)\n  const existingMappings = (contractForValidation as { mappings?: Partial<SqlMappings> }).mappings;\n\n  // Compute mappings from models and storage\n  const mappings = computeMappings(\n    contractForValidation.models as Record<string, ModelDefinition>,\n    contractForValidation.storage,\n    existingMappings,\n  );\n\n  // Add default values for optional metadata fields if missing\n  const contractWithMappings = {\n    ...structurallyValid,\n    models: contractForValidation.models,\n    relations: contractForValidation.relations,\n    storage: contractForValidation.storage,\n    mappings,\n  };\n\n  // Type assertion: The caller provides the strict type via TContract.\n  // We validate the structure matches, but the precise types come from contract.d.ts\n  return decodeContractDefaults(contractWithMappings) as TContract;\n}\n","import type { ExtensionPackRef, TargetPackRef } from '@prisma-next/contract/framework-components';\nimport type {\n  ColumnDefault,\n  ColumnDefaultLiteralInputValue,\n  ColumnDefaultLiteralValue,\n  ExecutionMutationDefault,\n  ExecutionMutationDefaultValue,\n  TaggedRaw,\n} from '@prisma-next/contract/types';\nimport type {\n  ColumnBuilderState,\n  ColumnTypeDescriptor,\n  ContractBuilderState,\n  ForeignKeyDefaultsState,\n  ModelBuilderState,\n  RelationDefinition,\n  TableBuilderState,\n} from '@prisma-next/contract-authoring';\nimport {\n  type BuildModels,\n  type BuildRelations,\n  type BuildStorageColumn,\n  ContractBuilder,\n  createTable,\n  type ExtractColumns,\n  type ExtractPrimaryKey,\n  ModelBuilder,\n  type Mutable,\n  TableBuilder,\n} from '@prisma-next/contract-authoring';\nimport {\n  applyFkDefaults,\n  type ContractWithTypeMaps,\n  type Index,\n  type ModelDefinition,\n  type ModelField,\n  type ReferentialAction,\n  type SqlContract,\n  type SqlMappings,\n  type SqlStorage,\n  type StorageTypeInstance,\n  type TypeMaps,\n} from '@prisma-next/sql-contract/types';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { computeMappings } from './contract';\n\ntype ColumnDefaultForCodec<\n  CodecTypes extends Record<string, { output: unknown }>,\n  CodecId extends string,\n> =\n  | {\n      readonly kind: 'literal';\n      readonly value: CodecId extends keyof CodecTypes ? CodecTypes[CodecId]['output'] : unknown;\n    }\n  | { readonly kind: 'function'; readonly expression: string };\n\ntype SqlNullableColumnOptions<\n  Descriptor extends ColumnTypeDescriptor,\n  CodecTypes extends Record<string, { output: unknown }>,\n> = {\n  readonly type: Descriptor;\n  readonly nullable: true;\n  readonly typeParams?: Record<string, unknown>;\n  readonly default?: ColumnDefaultForCodec<CodecTypes, Descriptor['codecId']>;\n};\n\ntype SqlNonNullableColumnOptions<\n  Descriptor extends ColumnTypeDescriptor,\n  CodecTypes extends Record<string, { output: unknown }>,\n> = {\n  readonly type: Descriptor;\n  readonly nullable?: false;\n  readonly typeParams?: Record<string, unknown>;\n  readonly default?: ColumnDefaultForCodec<CodecTypes, Descriptor['codecId']>;\n};\n\ntype SqlGeneratedColumnOptions<\n  Descriptor extends ColumnTypeDescriptor,\n  CodecTypes extends Record<string, { output: unknown }>,\n> = Omit<SqlNonNullableColumnOptions<Descriptor, CodecTypes>, 'default' | 'nullable'> & {\n  readonly nullable?: false;\n  readonly generated: ExecutionMutationDefaultValue;\n};\n\ntype SqlColumnOptions<\n  Descriptor extends ColumnTypeDescriptor,\n  CodecTypes extends Record<string, { output: unknown }>,\n> =\n  | SqlNullableColumnOptions<Descriptor, CodecTypes>\n  | SqlNonNullableColumnOptions<Descriptor, CodecTypes>;\n\nexport interface SqlTableBuilder<\n  Name extends string,\n  CodecTypes extends Record<string, { output: unknown }>,\n  Columns extends Record<string, ColumnBuilderState<string, boolean, string>> = Record<\n    never,\n    ColumnBuilderState<string, boolean, string>\n  >,\n  PrimaryKey extends readonly string[] | undefined = undefined,\n> extends Omit<TableBuilder<Name, Columns, PrimaryKey>, 'column' | 'generated'> {\n  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: SqlNullableColumnOptions<Descriptor, CodecTypes>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, true, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: SqlNonNullableColumnOptions<Descriptor, CodecTypes>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, false, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: SqlColumnOptions<Descriptor, CodecTypes>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, boolean, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n  generated<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: SqlGeneratedColumnOptions<Descriptor, CodecTypes>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, false, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n}\n\ntype ContractBuilderMappings = SqlMappings;\n\ntype ExtractCodecTypesFromPack<P> = P extends { __codecTypes?: infer C }\n  ? C extends Record<string, { output: unknown }>\n    ? C\n    : Record<string, never>\n  : Record<string, never>;\n\ntype UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (\n  k: infer I,\n) => void\n  ? I\n  : never;\n\ntype MergeExtensionCodecTypes<Packs extends Record<string, unknown>> = UnionToIntersection<\n  {\n    [K in keyof Packs]: ExtractCodecTypesFromPack<Packs[K]>;\n  }[keyof Packs]\n>;\n\ntype BuildStorageTable<\n  _TableName extends string,\n  Columns extends Record<string, ColumnBuilderState<string, boolean, string>>,\n  PK extends readonly string[] | undefined,\n> = {\n  readonly columns: {\n    readonly [K in keyof Columns]: Columns[K] extends ColumnBuilderState<\n      string,\n      infer Null,\n      infer TType\n    >\n      ? BuildStorageColumn<Null & boolean, TType>\n      : never;\n  };\n  readonly uniques: ReadonlyArray<{ readonly columns: readonly string[]; readonly name?: string }>;\n  readonly indexes: ReadonlyArray<Index>;\n  readonly foreignKeys: ReadonlyArray<{\n    readonly columns: readonly string[];\n    readonly references: { readonly table: string; readonly columns: readonly string[] };\n    readonly name?: string;\n    readonly onDelete?: ReferentialAction;\n    readonly onUpdate?: ReferentialAction;\n    readonly constraint: boolean;\n    readonly index: boolean;\n  }>;\n} & (PK extends readonly string[]\n  ? { readonly primaryKey: { readonly columns: PK; readonly name?: string } }\n  : Record<string, never>);\n\ntype BuildStorage<\n  Tables extends Record<\n    string,\n    TableBuilderState<\n      string,\n      Record<string, ColumnBuilderState<string, boolean, string>>,\n      readonly string[] | undefined\n    >\n  >,\n  Types extends Record<string, StorageTypeInstance>,\n> = {\n  readonly tables: {\n    readonly [K in keyof Tables]: BuildStorageTable<\n      K & string,\n      ExtractColumns<Tables[K]>,\n      ExtractPrimaryKey<Tables[K]>\n    >;\n  };\n  readonly types: Types;\n};\n\ntype BuildStorageTables<\n  Tables extends Record<\n    string,\n    TableBuilderState<\n      string,\n      Record<string, ColumnBuilderState<string, boolean, string>>,\n      readonly string[] | undefined\n    >\n  >,\n> = {\n  readonly [K in keyof Tables]: BuildStorageTable<\n    K & string,\n    ExtractColumns<Tables[K]>,\n    ExtractPrimaryKey<Tables[K]>\n  >;\n};\n\nexport interface ColumnBuilder<Name extends string, Nullable extends boolean, Type extends string> {\n  nullable<Value extends boolean>(value?: Value): ColumnBuilder<Name, Value, Type>;\n  type<Id extends string>(id: Id): ColumnBuilder<Name, Nullable, Id>;\n  build(): ColumnBuilderState<Name, Nullable, Type>;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== 'object' || value === null) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction isJsonValue(value: unknown): value is ColumnDefaultLiteralValue {\n  if (value === null) return true;\n  const valueType = typeof value;\n  if (valueType === 'string' || valueType === 'number' || valueType === 'boolean') return true;\n  if (Array.isArray(value)) {\n    return value.every((item) => isJsonValue(item));\n  }\n  if (isPlainObject(value)) {\n    return Object.values(value).every((item) => isJsonValue(item));\n  }\n  return false;\n}\n\nfunction encodeDefaultLiteralValue(\n  value: ColumnDefaultLiteralInputValue,\n): ColumnDefaultLiteralValue {\n  if (typeof value === 'bigint') {\n    return { $type: 'bigint', value: value.toString() };\n  }\n  if (value instanceof Date) {\n    return value.toISOString();\n  }\n  if (isJsonValue(value)) {\n    if (isPlainObject(value) && '$type' in value) {\n      return { $type: 'raw', value } satisfies TaggedRaw;\n    }\n    return value;\n  }\n  throw new Error(\n    'Unsupported column default literal value: expected JSON-safe value, bigint, or Date.',\n  );\n}\n\nfunction encodeColumnDefault(defaultInput: ColumnDefault): ColumnDefault {\n  if (defaultInput.kind === 'function') {\n    return { kind: 'function', expression: defaultInput.expression };\n  }\n  return { kind: 'literal', value: encodeDefaultLiteralValue(defaultInput.value) };\n}\n\nclass SqlContractBuilder<\n  CodecTypes extends Record<string, { output: unknown }> = Record<string, never>,\n  Target extends string | undefined = undefined,\n  Tables extends Record<\n    string,\n    TableBuilderState<\n      string,\n      Record<string, ColumnBuilderState<string, boolean, string>>,\n      readonly string[] | undefined\n    >\n  > = Record<never, never>,\n  Models extends Record<\n    string,\n    ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>\n  > = Record<never, never>,\n  Types extends Record<string, StorageTypeInstance> = Record<never, never>,\n  StorageHash extends string | undefined = undefined,\n  ExtensionPacks extends Record<string, unknown> | undefined = undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,\n> extends ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities> {\n  protected declare readonly state: ContractBuilderState<\n    Target,\n    Tables,\n    Models,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > & {\n    readonly storageTypes?: Types;\n  };\n  /**\n   * This method is responsible for normalizing the contract IR by setting default values\n   * for all required fields:\n   * - `nullable`: defaults to `false` if not provided\n   * - `uniques`: defaults to `[]` (empty array)\n   * - `indexes`: defaults to `[]` (empty array)\n   * - `foreignKeys`: defaults to `[]` (empty array)\n   * - `relations`: defaults to `{}` (empty object) for both model-level and contract-level\n   * - `nativeType`: required field set from column type descriptor when columns are defined\n   *\n   * The contract builder is the **only** place where normalization should occur.\n   * Validators, parsers, and emitters should assume the contract is already normalized.\n   *\n   * **Required**: Use column type descriptors (e.g., `int4Column`, `textColumn`) when defining columns.\n   * This ensures `nativeType` is set correctly at build time.\n   *\n   * @returns A normalized SqlContract with all required fields present\n   */\n  build(): Target extends string\n    ? ContractWithTypeMaps<\n        SqlContract<\n          BuildStorage<Tables, Types>,\n          BuildModels<Models>,\n          BuildRelations<Models>,\n          ContractBuilderMappings\n        > & {\n          readonly schemaVersion: '1';\n          readonly target: Target;\n          readonly targetFamily: 'sql';\n          readonly storageHash: StorageHash extends string ? StorageHash : string;\n        } & (ExtensionPacks extends Record<string, unknown>\n            ? { readonly extensionPacks: ExtensionPacks }\n            : Record<string, never>) &\n          (Capabilities extends Record<string, Record<string, boolean>>\n            ? { readonly capabilities: Capabilities }\n            : Record<string, never>),\n        TypeMaps<CodecTypes, Record<string, never>>\n      >\n    : never {\n    type BuiltContract = Target extends string\n      ? ContractWithTypeMaps<\n          SqlContract<\n            BuildStorage<Tables, Types>,\n            BuildModels<Models>,\n            BuildRelations<Models>,\n            ContractBuilderMappings\n          > & {\n            readonly schemaVersion: '1';\n            readonly target: Target;\n            readonly targetFamily: 'sql';\n            readonly storageHash: StorageHash extends string ? StorageHash : string;\n          } & (ExtensionPacks extends Record<string, unknown>\n              ? { readonly extensionPacks: ExtensionPacks }\n              : Record<string, never>) &\n            (Capabilities extends Record<string, Record<string, boolean>>\n              ? { readonly capabilities: Capabilities }\n              : Record<string, never>),\n          TypeMaps<CodecTypes, Record<string, never>>\n        >\n      : never;\n    if (!this.state.target) {\n      throw new Error('target is required. Call .target() before .build()');\n    }\n\n    const target = this.state.target as Target & string;\n\n    const storageTables = {} as Partial<Mutable<BuildStorageTables<Tables>>>;\n    const executionDefaults: ExecutionMutationDefault[] = [];\n\n    for (const tableName of Object.keys(this.state.tables) as Array<keyof Tables & string>) {\n      const tableState = this.state.tables[tableName];\n      if (!tableState) continue;\n\n      type TableKey = typeof tableName;\n      type ColumnDefs = ExtractColumns<Tables[TableKey]>;\n      type PrimaryKey = ExtractPrimaryKey<Tables[TableKey]>;\n\n      const columns = {} as Partial<{\n        [K in keyof ColumnDefs]: BuildStorageColumn<\n          ColumnDefs[K]['nullable'] & boolean,\n          ColumnDefs[K]['type']\n        >;\n      }>;\n\n      for (const columnName in tableState.columns) {\n        const columnState = tableState.columns[columnName];\n        if (!columnState) continue;\n        const codecId = columnState.type;\n        const nativeType = columnState.nativeType;\n        const typeRef = columnState.typeRef;\n\n        const encodedDefault =\n          columnState.default !== undefined\n            ? encodeColumnDefault(columnState.default as ColumnDefault)\n            : undefined;\n\n        columns[columnName as keyof ColumnDefs] = {\n          nativeType,\n          codecId,\n          nullable: (columnState.nullable ?? false) as ColumnDefs[keyof ColumnDefs]['nullable'] &\n            boolean,\n          ...ifDefined('typeParams', columnState.typeParams),\n          ...ifDefined('default', encodedDefault),\n          ...ifDefined('typeRef', typeRef),\n        } as BuildStorageColumn<\n          ColumnDefs[keyof ColumnDefs]['nullable'] & boolean,\n          ColumnDefs[keyof ColumnDefs]['type']\n        >;\n\n        if ('executionDefault' in columnState && columnState.executionDefault) {\n          executionDefaults.push({\n            ref: { table: tableName, column: columnName },\n            onCreate: columnState.executionDefault,\n          });\n        }\n      }\n\n      // Build uniques from table state\n      const uniques = (tableState.uniques ?? []).map((u) => ({\n        columns: u.columns,\n        ...(u.name ? { name: u.name } : {}),\n      }));\n\n      // Build indexes from table state\n      const indexes = (tableState.indexes ?? []).map((i) => ({\n        columns: i.columns,\n        ...(i.name ? { name: i.name } : {}),\n        ...(i.using ? { using: i.using } : {}),\n        ...(i.config ? { config: i.config } : {}),\n      }));\n\n      // Build foreign keys from table state, materializing defaults\n      const foreignKeys = (tableState.foreignKeys ?? []).map((fk) => ({\n        columns: fk.columns,\n        references: fk.references,\n        ...applyFkDefaults(fk, this.state.foreignKeyDefaults),\n        ...(fk.name ? { name: fk.name } : {}),\n        ...(fk.onDelete !== undefined ? { onDelete: fk.onDelete } : {}),\n        ...(fk.onUpdate !== undefined ? { onUpdate: fk.onUpdate } : {}),\n      }));\n\n      const table = {\n        columns: columns as {\n          [K in keyof ColumnDefs]: BuildStorageColumn<\n            ColumnDefs[K]['nullable'] & boolean,\n            ColumnDefs[K]['type']\n          >;\n        },\n        uniques,\n        indexes,\n        foreignKeys,\n        ...(tableState.primaryKey\n          ? {\n              primaryKey: {\n                columns: tableState.primaryKey,\n                ...(tableState.primaryKeyName ? { name: tableState.primaryKeyName } : {}),\n              },\n            }\n          : {}),\n      } as unknown as BuildStorageTable<TableKey & string, ColumnDefs, PrimaryKey>;\n\n      (storageTables as Mutable<BuildStorageTables<Tables>>)[tableName] = table;\n    }\n\n    const storageTypes = (this.state.storageTypes ?? {}) as Types;\n    const storage: BuildStorage<Tables, Types> = {\n      tables: storageTables as BuildStorageTables<Tables>,\n      types: storageTypes,\n    };\n\n    const execution =\n      executionDefaults.length > 0\n        ? {\n            mutations: {\n              defaults: executionDefaults.sort((a, b) => {\n                const tableCompare = a.ref.table.localeCompare(b.ref.table);\n                if (tableCompare !== 0) {\n                  return tableCompare;\n                }\n                return a.ref.column.localeCompare(b.ref.column);\n              }),\n            },\n          }\n        : undefined;\n\n    // Build models - construct as partial first, then assert full type\n    const modelsPartial: Partial<BuildModels<Models>> = {};\n\n    // Iterate over models - TypeScript will see keys as string, but type assertion preserves literals\n    for (const modelName in this.state.models) {\n      const modelState = this.state.models[modelName];\n      if (!modelState) continue;\n\n      const modelStateTyped = modelState as unknown as {\n        name: string;\n        table: string;\n        fields: Record<string, string>;\n      };\n\n      // Build fields object\n      const fields: Partial<Record<string, ModelField>> = {};\n\n      // Iterate over fields\n      for (const fieldName in modelStateTyped.fields) {\n        const columnName = modelStateTyped.fields[fieldName];\n        if (columnName) {\n          fields[fieldName] = {\n            column: columnName,\n          };\n        }\n      }\n\n      // Assign to models - type assertion preserves literal keys\n      (modelsPartial as unknown as Record<string, ModelDefinition>)[modelName] = {\n        storage: {\n          table: modelStateTyped.table,\n        },\n        fields: fields as Record<string, ModelField>,\n        relations: {},\n      };\n    }\n\n    // Build relations object - organized by table name\n    const relationsPartial: Partial<Record<string, Record<string, RelationDefinition>>> = {};\n\n    // Iterate over models to collect relations\n    for (const modelName in this.state.models) {\n      const modelState = this.state.models[modelName];\n      if (!modelState) continue;\n\n      const modelStateTyped = modelState as unknown as {\n        name: string;\n        table: string;\n        fields: Record<string, string>;\n        relations: Record<string, RelationDefinition>;\n      };\n\n      const tableName = modelStateTyped.table;\n      if (!tableName) continue;\n\n      // Only initialize relations object for this table if it has relations\n      if (modelStateTyped.relations && Object.keys(modelStateTyped.relations).length > 0) {\n        if (!relationsPartial[tableName]) {\n          relationsPartial[tableName] = {};\n        }\n\n        // Add relations from this model to the table's relations\n        const tableRelations = relationsPartial[tableName];\n        if (tableRelations) {\n          for (const relationName in modelStateTyped.relations) {\n            const relation = modelStateTyped.relations[relationName];\n            if (relation) {\n              tableRelations[relationName] = relation;\n            }\n          }\n        }\n      }\n    }\n\n    const models = modelsPartial as unknown as BuildModels<Models>;\n\n    const baseMappings = computeMappings(\n      models as unknown as Record<string, ModelDefinition>,\n      storage as SqlStorage,\n    );\n\n    const mappings = baseMappings as ContractBuilderMappings;\n\n    const extensionNamespaces = this.state.extensionNamespaces ?? [];\n    const extensionPacks: Record<string, unknown> = { ...(this.state.extensionPacks || {}) };\n    for (const namespace of extensionNamespaces) {\n      if (!Object.hasOwn(extensionPacks, namespace)) {\n        extensionPacks[namespace] = {};\n      }\n    }\n\n    // Construct contract with explicit type that matches the generic parameters\n    // This ensures TypeScript infers literal types from the generics, not runtime values\n    // Always include relations, even if empty (normalized to empty object)\n    const contract = {\n      schemaVersion: '1' as const,\n      target,\n      targetFamily: 'sql' as const,\n      storageHash: this.state.storageHash || 'sha256:ts-builder-placeholder',\n      models,\n      relations: relationsPartial,\n      storage,\n      mappings,\n      ...(execution ? { execution } : {}),\n      extensionPacks,\n      capabilities: this.state.capabilities || {},\n      meta: {},\n      sources: {},\n    } as unknown as BuiltContract;\n\n    return contract as unknown as ReturnType<\n      SqlContractBuilder<\n        CodecTypes,\n        Target,\n        Tables,\n        Models,\n        Types,\n        StorageHash,\n        ExtensionPacks,\n        Capabilities\n      >['build']\n    >;\n  }\n\n  override target<\n    T extends string,\n    TPack extends TargetPackRef<string, T> = TargetPackRef<string, T>,\n  >(\n    packRef: TPack & TargetPackRef<string, T>,\n  ): SqlContractBuilder<\n    ExtractCodecTypesFromPack<TPack> extends Record<string, never>\n      ? CodecTypes\n      : ExtractCodecTypesFromPack<TPack>,\n    T,\n    Tables,\n    Models,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    return new SqlContractBuilder<\n      ExtractCodecTypesFromPack<TPack> extends Record<string, never>\n        ? CodecTypes\n        : ExtractCodecTypesFromPack<TPack>,\n      T,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      target: packRef.targetId,\n    }) as SqlContractBuilder<\n      ExtractCodecTypesFromPack<TPack> extends Record<string, never>\n        ? CodecTypes\n        : ExtractCodecTypesFromPack<TPack>,\n      T,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >;\n  }\n\n  extensionPacks<const Packs extends Record<string, ExtensionPackRef<'sql', string>>>(\n    packs: Packs,\n  ): SqlContractBuilder<\n    CodecTypes & MergeExtensionCodecTypes<Packs>,\n    Target,\n    Tables,\n    Models,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    if (!this.state.target) {\n      throw new Error('extensionPacks() requires target() to be called first');\n    }\n\n    const namespaces = new Set(this.state.extensionNamespaces ?? []);\n\n    for (const packRef of Object.values(packs) as ExtensionPackRef<'sql', string>[]) {\n      if (!packRef) continue;\n\n      if (packRef.kind !== 'extension') {\n        throw new Error(\n          `extensionPacks() only accepts extension pack refs. Received kind \"${packRef.kind}\".`,\n        );\n      }\n\n      if (packRef.familyId !== 'sql') {\n        throw new Error(\n          `extension pack \"${packRef.id}\" targets family \"${packRef.familyId}\" but this builder targets \"sql\".`,\n        );\n      }\n\n      if (packRef.targetId && packRef.targetId !== this.state.target) {\n        throw new Error(\n          `extension pack \"${packRef.id}\" targets \"${packRef.targetId}\" but builder target is \"${this.state.target}\".`,\n        );\n      }\n\n      namespaces.add(packRef.id);\n    }\n\n    return new SqlContractBuilder<\n      CodecTypes & MergeExtensionCodecTypes<Packs>,\n      Target,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      extensionNamespaces: [...namespaces],\n    });\n  }\n\n  override capabilities<C extends Record<string, Record<string, boolean>>>(\n    capabilities: C,\n  ): SqlContractBuilder<CodecTypes, Target, Tables, Models, Types, StorageHash, ExtensionPacks, C> {\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      C\n    >({\n      ...this.state,\n      capabilities,\n    });\n  }\n\n  override storageHash<H extends string>(\n    hash: H,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables,\n    Models,\n    Types,\n    H,\n    ExtensionPacks,\n    Capabilities\n  > {\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models,\n      Types,\n      H,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      storageHash: hash,\n    });\n  }\n\n  override table<\n    TableName extends string,\n    T extends TableBuilder<\n      TableName,\n      Record<string, ColumnBuilderState<string, boolean, string>>,\n      readonly string[] | undefined\n    >,\n  >(\n    name: TableName,\n    callback: (t: TableBuilder<TableName>) => T | undefined,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables & Record<TableName, ReturnType<T['build']>>,\n    Models,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    const tableBuilder = createTable(name);\n    const result = callback(\n      tableBuilder as unknown as SqlTableBuilder<\n        TableName,\n        CodecTypes\n      > as unknown as TableBuilder<TableName>,\n    );\n    const finalBuilder = result instanceof TableBuilder ? result : tableBuilder;\n    const tableState = finalBuilder.build();\n\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables & Record<TableName, ReturnType<T['build']>>,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      tables: { ...this.state.tables, [name]: tableState } as Tables &\n        Record<TableName, ReturnType<T['build']>>,\n    });\n  }\n\n  override model<\n    ModelName extends string,\n    TableName extends string,\n    M extends ModelBuilder<\n      ModelName,\n      TableName,\n      Record<string, string>,\n      Record<string, RelationDefinition>\n    >,\n  >(\n    name: ModelName,\n    table: TableName,\n    callback: (\n      m: ModelBuilder<ModelName, TableName, Record<never, never>, Record<never, never>>,\n    ) => M | undefined,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables,\n    Models & Record<ModelName, ReturnType<M['build']>>,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    const modelBuilder = new ModelBuilder<ModelName, TableName>(name, table);\n    const result = callback(modelBuilder);\n    const finalBuilder = result instanceof ModelBuilder ? result : modelBuilder;\n    const modelState = finalBuilder.build();\n\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models & Record<ModelName, ReturnType<M['build']>>,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      models: { ...this.state.models, [name]: modelState } as Models &\n        Record<ModelName, ReturnType<M['build']>>,\n    });\n  }\n\n  override foreignKeyDefaults(\n    config: ForeignKeyDefaultsState,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables,\n    Models,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      foreignKeyDefaults: config,\n    });\n  }\n\n  storageType<Name extends string, Type extends StorageTypeInstance>(\n    name: Name,\n    typeInstance: Type,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables,\n    Models,\n    Types & Record<Name, Type>,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models,\n      Types & Record<Name, Type>,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      storageTypes: {\n        ...(this.state.storageTypes ?? {}),\n        [name]: typeInstance,\n      },\n    });\n  }\n}\n\nexport function defineContract<\n  CodecTypes extends Record<string, { output: unknown }> = Record<string, never>,\n>(): SqlContractBuilder<CodecTypes> {\n  return new SqlContractBuilder<CodecTypes>();\n}\n"],"mappings":"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"}
+{"version":3,"file":"contract-builder.mjs","names":["modelToTable: Record<string, string>","tableToModel: Record<string, string>","fieldToColumn: Record<string, Record<string, string>>","columnToField: Record<string, Record<string, string>>","modelFieldToColumn: Record<string, string>","executionDefaults: ExecutionMutationDefault[]","storage: BuildStorage<Tables, Types>","modelsPartial: Partial<BuildModels<Models>>","fields: Partial<Record<string, ModelField>>","relationsPartial: Partial<Record<string, Record<string, RelationDefinition>>>","extensionPacks: Record<string, unknown>"],"sources":["../src/contract.ts","../src/contract-builder.ts"],"sourcesContent":["import type {\n  ModelDefinition,\n  ModelField,\n  ModelStorage,\n  PrimaryKey,\n  SqlContract,\n  SqlMappings,\n  SqlStorage,\n  StorageTypeInstance,\n  UniqueConstraint,\n} from '@prisma-next/sql-contract/types';\nimport { decodeContractDefaults } from '@prisma-next/sql-contract/validate';\nimport {\n  ColumnDefaultSchema,\n  ForeignKeySchema,\n  IndexSchema,\n} from '@prisma-next/sql-contract/validators';\nimport { type } from 'arktype';\nimport type { O } from 'ts-toolbelt';\n\n/**\n * Structural validation schema for SqlContract using Arktype.\n * This validates the shape and types of the contract structure.\n */\n\nconst StorageColumnSchema = type({\n  nativeType: 'string',\n  codecId: 'string',\n  nullable: 'boolean',\n  'typeParams?': 'Record<string, unknown>',\n  'typeRef?': 'string',\n  'default?': ColumnDefaultSchema,\n});\n\nconst StorageTypeInstanceSchema = type.declare<StorageTypeInstance>().type({\n  codecId: 'string',\n  nativeType: 'string',\n  typeParams: 'Record<string, unknown>',\n});\n\nconst PrimaryKeySchema = type.declare<PrimaryKey>().type({\n  columns: type.string.array().readonly(),\n  'name?': 'string',\n});\n\nconst UniqueConstraintSchema = type.declare<UniqueConstraint>().type({\n  columns: type.string.array().readonly(),\n  'name?': 'string',\n});\n\nconst StorageTableSchema = type({\n  columns: type({ '[string]': StorageColumnSchema }),\n  'primaryKey?': PrimaryKeySchema,\n  uniques: UniqueConstraintSchema.array().readonly(),\n  indexes: IndexSchema.array().readonly(),\n  foreignKeys: ForeignKeySchema.array().readonly(),\n});\n\nconst StorageSchema = type({\n  tables: type({ '[string]': StorageTableSchema }),\n  'types?': type({ '[string]': StorageTypeInstanceSchema }),\n});\n\nconst ModelFieldSchema = type.declare<ModelField>().type({\n  column: 'string',\n});\n\nconst ModelStorageSchema = type.declare<ModelStorage>().type({\n  table: 'string',\n});\n\nconst ModelSchema = type.declare<ModelDefinition>().type({\n  storage: ModelStorageSchema,\n  fields: type({ '[string]': ModelFieldSchema }),\n  relations: type({ '[string]': 'unknown' }),\n});\n\nconst GeneratorIdSchema = type('string').narrow((value, ctx) => {\n  return /^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(value) ? true : ctx.mustBe('a flat generator id');\n});\n\nconst ExecutionMutationDefaultValueSchema = type({\n  kind: \"'generator'\",\n  id: GeneratorIdSchema,\n  'params?': 'Record<string, unknown>',\n});\n\nconst ExecutionMutationDefaultSchema = type({\n  ref: {\n    table: 'string',\n    column: 'string',\n  },\n  'onCreate?': ExecutionMutationDefaultValueSchema,\n  'onUpdate?': ExecutionMutationDefaultValueSchema,\n});\n\nconst ExecutionSchema = type({\n  mutations: {\n    defaults: ExecutionMutationDefaultSchema.array().readonly(),\n  },\n});\n\n/**\n * Complete SqlContract schema for structural validation.\n * This validates the entire contract structure at once.\n */\nconst SqlContractSchema = type({\n  'schemaVersion?': \"'1'\",\n  target: 'string',\n  targetFamily: \"'sql'\",\n  storageHash: 'string',\n  'executionHash?': 'string',\n  'profileHash?': 'string',\n  'capabilities?': 'Record<string, Record<string, boolean>>',\n  'extensionPacks?': 'Record<string, unknown>',\n  'meta?': 'Record<string, unknown>',\n  'sources?': 'Record<string, unknown>',\n  models: type({ '[string]': ModelSchema }),\n  storage: StorageSchema,\n  'execution?': ExecutionSchema,\n});\n\n/**\n * Validates the structural shape of a SqlContract using Arktype.\n *\n * **Responsibility: Validation Only**\n * This function validates that the contract has the correct structure and types.\n * It does NOT normalize the contract - normalization must happen in the contract builder.\n *\n * The contract passed to this function must already be normalized (all required fields present).\n * If normalization is needed, it should be done by the contract builder before calling this function.\n *\n * This ensures all required fields are present and have the correct types.\n *\n * @param value - The contract value to validate (typically from a JSON import)\n * @returns The validated contract if structure is valid\n * @throws Error if the contract structure is invalid\n */\nfunction validateContractStructure<T extends SqlContract<SqlStorage>>(\n  value: unknown,\n): O.Overwrite<T, { targetFamily: 'sql' }> {\n  // Check targetFamily first to provide a clear error message for unsupported target families\n  const rawValue = value as { targetFamily?: string };\n  if (rawValue.targetFamily !== undefined && rawValue.targetFamily !== 'sql') {\n    /* c8 ignore next */\n    throw new Error(`Unsupported target family: ${rawValue.targetFamily}`);\n  }\n\n  const contractResult = SqlContractSchema(value);\n\n  if (contractResult instanceof type.errors) {\n    const messages = contractResult.map((p: { message: string }) => p.message).join('; ');\n    throw new Error(`Contract structural validation failed: ${messages}`);\n  }\n\n  // After validation, contractResult matches the schema and preserves the input structure\n  // TypeScript needs an assertion here due to exactOptionalPropertyTypes differences\n  // between Arktype's inferred type and the generic T, but runtime-wise they're compatible\n  return contractResult as O.Overwrite<T, { targetFamily: 'sql' }>;\n}\n\n/**\n * Computes mapping dictionaries from models and storage structures.\n * Assumes valid input - validation happens separately in validateContractLogic().\n *\n * @param models - Models object from contract\n * @param storage - Storage object from contract\n * @param existingMappings - Existing mappings from contract input (optional)\n * @returns Computed mappings dictionary\n */\nexport function computeMappings(\n  models: Record<string, ModelDefinition>,\n  _storage: SqlStorage,\n  existingMappings?: Partial<SqlMappings>,\n): SqlMappings {\n  const modelToTable: Record<string, string> = {};\n  const tableToModel: Record<string, string> = {};\n  const fieldToColumn: Record<string, Record<string, string>> = {};\n  const columnToField: Record<string, Record<string, string>> = {};\n\n  for (const [modelName, model] of Object.entries(models)) {\n    const tableName = model.storage.table;\n    modelToTable[modelName] = tableName;\n    tableToModel[tableName] = modelName;\n\n    const modelFieldToColumn: Record<string, string> = {};\n    for (const [fieldName, field] of Object.entries(model.fields)) {\n      const columnName = field.column;\n      modelFieldToColumn[fieldName] = columnName;\n\n      if (!columnToField[tableName]) {\n        columnToField[tableName] = {};\n      }\n      columnToField[tableName][columnName] = fieldName;\n    }\n    fieldToColumn[modelName] = modelFieldToColumn;\n  }\n\n  return {\n    modelToTable: existingMappings?.modelToTable ?? modelToTable,\n    tableToModel: existingMappings?.tableToModel ?? tableToModel,\n    fieldToColumn: existingMappings?.fieldToColumn ?? fieldToColumn,\n    columnToField: existingMappings?.columnToField ?? columnToField,\n  };\n}\n\n/**\n * Validates logical consistency of a **structurally validated** SqlContract.\n * This checks that references (e.g., foreign keys, primary keys, uniques) point to storage objects that already exist.\n * Structural validation is expected to have already completed before this helper runs.\n *\n * Rule: keep this focused on structural consistency only; capability/feature\n * gating (e.g., defaults.*) belongs in migration/runtime verification, not here.\n *\n * @param structurallyValidatedContract - The contract whose structure has already been validated\n * @throws Error if logical validation fails\n */\nfunction validateContractLogic(structurallyValidatedContract: SqlContract<SqlStorage>): void {\n  const { storage, models } = structurallyValidatedContract;\n  const tableNames = new Set(Object.keys(storage.tables));\n\n  // Validate storage.types if present\n  if (storage.types) {\n    for (const [typeName, typeInstance] of Object.entries(storage.types)) {\n      // Validate typeParams is not an array (arrays are objects in JS but not valid here)\n      if (Array.isArray(typeInstance.typeParams)) {\n        throw new Error(\n          `Type instance \"${typeName}\" has invalid typeParams: must be a plain object, not an array`,\n        );\n      }\n    }\n  }\n\n  // Validate columns in all tables\n  for (const [tableName, table] of Object.entries(storage.tables)) {\n    for (const [columnName, column] of Object.entries(table.columns)) {\n      // Validate typeParams and typeRef are mutually exclusive\n      if (column.typeParams !== undefined && column.typeRef !== undefined) {\n        throw new Error(\n          `Column \"${columnName}\" in table \"${tableName}\" has both typeParams and typeRef; these are mutually exclusive`,\n        );\n      }\n\n      // Validate typeParams is not an array (arrays are objects in JS but not valid here)\n      if (column.typeParams !== undefined && Array.isArray(column.typeParams)) {\n        throw new Error(\n          `Column \"${columnName}\" in table \"${tableName}\" has invalid typeParams: must be a plain object, not an array`,\n        );\n      }\n\n      // Validate NOT NULL columns do not have literal null defaults\n      if (!column.nullable && column.default?.kind === 'literal' && column.default.value === null) {\n        throw new Error(\n          `Table \"${tableName}\" column \"${columnName}\" is NOT NULL but has a literal null default`,\n        );\n      }\n\n      // Validate typeRef points to an existing storage.types key and matches codecId/nativeType\n      if (column.typeRef !== undefined) {\n        const referencedType = storage.types?.[column.typeRef];\n        if (!referencedType) {\n          throw new Error(\n            `Column \"${columnName}\" in table \"${tableName}\" references non-existent type instance \"${column.typeRef}\" (not found in storage.types)`,\n          );\n        }\n\n        if (column.codecId !== referencedType.codecId) {\n          throw new Error(\n            `Column \"${columnName}\" in table \"${tableName}\" has codecId \"${column.codecId}\" but references type instance \"${column.typeRef}\" with codecId \"${referencedType.codecId}\"`,\n          );\n        }\n\n        if (column.nativeType !== referencedType.nativeType) {\n          throw new Error(\n            `Column \"${columnName}\" in table \"${tableName}\" has nativeType \"${column.nativeType}\" but references type instance \"${column.typeRef}\" with nativeType \"${referencedType.nativeType}\"`,\n          );\n        }\n      }\n    }\n  }\n\n  // Validate models\n  for (const [modelName, modelUnknown] of Object.entries(models)) {\n    const model = modelUnknown as ModelDefinition;\n    // Validate model has storage.table\n    if (!model.storage?.table) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" is missing storage.table`);\n    }\n\n    const tableName = model.storage.table;\n\n    // Validate model's table exists in storage\n    if (!tableNames.has(tableName)) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" references non-existent table \"${tableName}\"`);\n    }\n\n    const table = storage.tables[tableName];\n    if (!table) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" references non-existent table \"${tableName}\"`);\n    }\n\n    // Validate model's table has a primary key\n    if (!table.primaryKey) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" table \"${tableName}\" is missing a primary key`);\n    }\n\n    const columnNames = new Set(Object.keys(table.columns));\n\n    // Validate model fields\n    if (!model.fields) {\n      /* c8 ignore next */\n      throw new Error(`Model \"${modelName}\" is missing fields`);\n    }\n\n    for (const [fieldName, fieldUnknown] of Object.entries(model.fields)) {\n      const field = fieldUnknown as { column: string };\n      // Validate field has column property\n      if (!field.column) {\n        /* c8 ignore next */\n        throw new Error(`Model \"${modelName}\" field \"${fieldName}\" is missing column property`);\n      }\n\n      // Validate field's column exists in the model's backing table\n      if (!columnNames.has(field.column)) {\n        /* c8 ignore next */\n        throw new Error(\n          `Model \"${modelName}\" field \"${fieldName}\" references non-existent column \"${field.column}\" in table \"${tableName}\"`,\n        );\n      }\n    }\n\n    // Validate model relations have corresponding foreign keys\n    if (model.relations) {\n      for (const [relationName, relation] of Object.entries(model.relations)) {\n        // For now, we'll do basic validation. Full FK validation can be added later\n        // This would require checking that the relation's on.parentCols/childCols match FKs\n        if (\n          typeof relation === 'object' &&\n          relation !== null &&\n          'on' in relation &&\n          'to' in relation\n        ) {\n          const on = relation.on as { parentCols?: string[]; childCols?: string[] };\n          const cardinality = (relation as { cardinality?: string }).cardinality;\n          if (on.parentCols && on.childCols) {\n            // For 1:N relations, the foreign key is on the child table\n            // For N:1 relations, the foreign key is on the parent table (this table)\n            // For now, we'll skip validation for 1:N relations as the FK is on the child table\n            // and we'll validate it when we process the child model\n            if (cardinality === '1:N') {\n              // Foreign key is on the child table, skip validation here\n              // It will be validated when we process the child model\n              continue;\n            }\n\n            // For N:1 relations, check that there's a foreign key matching this relation\n            const hasMatchingFk = table.foreignKeys?.some((fk) => {\n              return (\n                fk.columns.length === on.childCols?.length &&\n                fk.columns.every((col, i) => col === on.childCols?.[i]) &&\n                fk.references.table &&\n                fk.references.columns.length === on.parentCols?.length &&\n                fk.references.columns.every((col, i) => col === on.parentCols?.[i])\n              );\n            });\n\n            if (!hasMatchingFk) {\n              /* c8 ignore next */\n              throw new Error(\n                `Model \"${modelName}\" relation \"${relationName}\" does not have a corresponding foreign key in table \"${tableName}\"`,\n              );\n            }\n          }\n        }\n      }\n    }\n  }\n\n  for (const [tableName, table] of Object.entries(storage.tables)) {\n    const columnNames = new Set(Object.keys(table.columns));\n\n    // Validate primaryKey references existing columns\n    if (table.primaryKey) {\n      for (const colName of table.primaryKey.columns) {\n        if (!columnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(\n            `Table \"${tableName}\" primaryKey references non-existent column \"${colName}\"`,\n          );\n        }\n      }\n    }\n\n    // Validate unique constraints reference existing columns\n    for (const unique of table.uniques) {\n      for (const colName of unique.columns) {\n        if (!columnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(\n            `Table \"${tableName}\" unique constraint references non-existent column \"${colName}\"`,\n          );\n        }\n      }\n    }\n\n    // Validate indexes reference existing columns\n    for (const index of table.indexes) {\n      for (const colName of index.columns) {\n        if (!columnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(`Table \"${tableName}\" index references non-existent column \"${colName}\"`);\n        }\n      }\n    }\n\n    // Validate foreignKeys reference existing tables and columns\n    for (const fk of table.foreignKeys) {\n      // Validate FK columns exist in the referencing table\n      for (const colName of fk.columns) {\n        if (!columnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(\n            `Table \"${tableName}\" foreignKey references non-existent column \"${colName}\"`,\n          );\n        }\n      }\n\n      // Validate referenced table exists\n      if (!tableNames.has(fk.references.table)) {\n        /* c8 ignore next */\n        throw new Error(\n          `Table \"${tableName}\" foreignKey references non-existent table \"${fk.references.table}\"`,\n        );\n      }\n\n      // Validate referenced columns exist in the referenced table\n      const referencedTable = storage.tables[fk.references.table];\n      if (!referencedTable) {\n        /* c8 ignore next */\n        throw new Error(\n          `Table \"${tableName}\" foreignKey references non-existent table \"${fk.references.table}\"`,\n        );\n      }\n      const referencedColumnNames = new Set(Object.keys(referencedTable.columns));\n\n      for (const colName of fk.references.columns) {\n        if (!referencedColumnNames.has(colName)) {\n          /* c8 ignore next */\n          throw new Error(\n            `Table \"${tableName}\" foreignKey references non-existent column \"${colName}\" in table \"${fk.references.table}\"`,\n          );\n        }\n      }\n\n      if (fk.columns.length !== fk.references.columns.length) {\n        /* c8 ignore next */\n        throw new Error(\n          `Table \"${tableName}\" foreignKey column count (${fk.columns.length}) does not match referenced column count (${fk.references.columns.length})`,\n        );\n      }\n    }\n  }\n}\n\nimport { normalizeContract } from '@prisma-next/sql-contract/validate';\nexport { normalizeContract };\n\n/**\n * Validates that a JSON import conforms to the SqlContract structure\n * and returns a fully typed SqlContract.\n *\n * This function is specifically for validating JSON imports (e.g., from contract.json).\n * Contracts created via the builder API (defineContract) are already valid and should\n * not be passed to this function - use them directly without validation.\n *\n * Performs both structural validation (using Arktype) and logical validation\n * (ensuring all references are valid).\n *\n *\n * The type parameter `TContract` must be a fully-typed contract type (e.g., from `contract.d.ts`),\n * NOT a generic `SqlContract<SqlStorage>`.\n *\n * **Correct:**\n * ```typescript\n * import type { Contract } from './contract.d';\n * const contract = validateContract<Contract>(contractJson);\n * ```\n *\n * **Incorrect:**\n * ```typescript\n * import type { SqlContract, SqlStorage } from '@prisma-next/sql-contract/types';\n * const contract = validateContract<SqlContract<SqlStorage>>(contractJson);\n * // ❌ Types will be inferred as 'unknown' - this won't work!\n * ```\n *\n * The type parameter provides the specific table structure, column types, and model definitions.\n * This function validates the runtime structure matches the type, but does not infer types\n * from JSON (as JSON imports lose literal type information).\n *\n * @param value - The contract value to validate (must be from a JSON import, not a builder)\n * @returns A validated contract matching the TContract type\n * @throws Error if the contract structure or logic is invalid\n */\nexport function validateContract<TContract extends SqlContract<SqlStorage>>(\n  value: unknown,\n): TContract {\n  // Normalize contract first (add defaults for missing fields)\n  const normalized = normalizeContract(value);\n\n  const structurallyValid = validateContractStructure<SqlContract<SqlStorage>>(normalized);\n\n  const contractForValidation = structurallyValid as SqlContract<SqlStorage>;\n\n  // Validate contract logic (contracts must already have fully qualified type IDs)\n  validateContractLogic(contractForValidation);\n\n  // Extract existing mappings (optional - will be computed if missing)\n  const existingMappings = (contractForValidation as { mappings?: Partial<SqlMappings> }).mappings;\n\n  // Compute mappings from models and storage\n  const mappings = computeMappings(\n    contractForValidation.models as Record<string, ModelDefinition>,\n    contractForValidation.storage,\n    existingMappings,\n  );\n\n  // Add default values for optional metadata fields if missing\n  const contractWithMappings = {\n    ...structurallyValid,\n    models: contractForValidation.models,\n    relations: contractForValidation.relations,\n    storage: contractForValidation.storage,\n    mappings,\n  };\n\n  // Type assertion: The caller provides the strict type via TContract.\n  // We validate the structure matches, but the precise types come from contract.d.ts\n  return decodeContractDefaults(contractWithMappings) as TContract;\n}\n","import type { ExtensionPackRef, TargetPackRef } from '@prisma-next/contract/framework-components';\nimport type {\n  ColumnDefault,\n  ColumnDefaultLiteralInputValue,\n  ColumnDefaultLiteralValue,\n  ExecutionMutationDefault,\n  ExecutionMutationDefaultValue,\n  TaggedRaw,\n} from '@prisma-next/contract/types';\nimport type {\n  ColumnBuilderState,\n  ColumnTypeDescriptor,\n  ContractBuilderState,\n  ForeignKeyDefaultsState,\n  ModelBuilderState,\n  RelationDefinition,\n  TableBuilderState,\n} from '@prisma-next/contract-authoring';\nimport {\n  type BuildModels,\n  type BuildRelations,\n  type BuildStorageColumn,\n  ContractBuilder,\n  createTable,\n  type ExtractColumns,\n  type ExtractPrimaryKey,\n  ModelBuilder,\n  type Mutable,\n  TableBuilder,\n} from '@prisma-next/contract-authoring';\nimport {\n  applyFkDefaults,\n  type ContractWithTypeMaps,\n  type Index,\n  type ModelDefinition,\n  type ModelField,\n  type ReferentialAction,\n  type SqlContract,\n  type SqlMappings,\n  type SqlStorage,\n  type StorageTypeInstance,\n  type TypeMaps,\n} from '@prisma-next/sql-contract/types';\nimport { ifDefined } from '@prisma-next/utils/defined';\nimport { computeMappings } from './contract';\n\ntype ColumnDefaultForCodec<\n  CodecTypes extends Record<string, { output: unknown }>,\n  CodecId extends string,\n> =\n  | {\n      readonly kind: 'literal';\n      readonly value: CodecId extends keyof CodecTypes ? CodecTypes[CodecId]['output'] : unknown;\n    }\n  | { readonly kind: 'function'; readonly expression: string };\n\ntype SqlNullableColumnOptions<\n  Descriptor extends ColumnTypeDescriptor,\n  CodecTypes extends Record<string, { output: unknown }>,\n> = {\n  readonly type: Descriptor;\n  readonly nullable: true;\n  readonly typeParams?: Record<string, unknown>;\n  readonly default?: ColumnDefaultForCodec<CodecTypes, Descriptor['codecId']>;\n};\n\ntype SqlNonNullableColumnOptions<\n  Descriptor extends ColumnTypeDescriptor,\n  CodecTypes extends Record<string, { output: unknown }>,\n> = {\n  readonly type: Descriptor;\n  readonly nullable?: false;\n  readonly typeParams?: Record<string, unknown>;\n  readonly default?: ColumnDefaultForCodec<CodecTypes, Descriptor['codecId']>;\n};\n\ntype SqlGeneratedColumnOptions<\n  Descriptor extends ColumnTypeDescriptor,\n  CodecTypes extends Record<string, { output: unknown }>,\n> = Omit<SqlNonNullableColumnOptions<Descriptor, CodecTypes>, 'default' | 'nullable'> & {\n  readonly nullable?: false;\n  readonly generated: ExecutionMutationDefaultValue;\n};\n\ntype SqlColumnOptions<\n  Descriptor extends ColumnTypeDescriptor,\n  CodecTypes extends Record<string, { output: unknown }>,\n> =\n  | SqlNullableColumnOptions<Descriptor, CodecTypes>\n  | SqlNonNullableColumnOptions<Descriptor, CodecTypes>;\n\nexport interface SqlTableBuilder<\n  Name extends string,\n  CodecTypes extends Record<string, { output: unknown }>,\n  Columns extends Record<string, ColumnBuilderState<string, boolean, string>> = Record<\n    never,\n    ColumnBuilderState<string, boolean, string>\n  >,\n  PrimaryKey extends readonly string[] | undefined = undefined,\n> extends Omit<TableBuilder<Name, Columns, PrimaryKey>, 'column' | 'generated'> {\n  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: SqlNullableColumnOptions<Descriptor, CodecTypes>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, true, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: SqlNonNullableColumnOptions<Descriptor, CodecTypes>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, false, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n  column<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: SqlColumnOptions<Descriptor, CodecTypes>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, boolean, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n  generated<ColName extends string, Descriptor extends ColumnTypeDescriptor>(\n    name: ColName,\n    options: SqlGeneratedColumnOptions<Descriptor, CodecTypes>,\n  ): TableBuilder<\n    Name,\n    Columns & Record<ColName, ColumnBuilderState<ColName, false, Descriptor['codecId']>>,\n    PrimaryKey\n  >;\n}\n\ntype ContractBuilderMappings = SqlMappings;\n\ntype ExtractCodecTypesFromPack<P> = P extends { __codecTypes?: infer C }\n  ? C extends Record<string, { output: unknown }>\n    ? C\n    : Record<string, never>\n  : Record<string, never>;\n\ntype UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) extends (\n  k: infer I,\n) => void\n  ? I\n  : never;\n\ntype MergeExtensionCodecTypes<Packs extends Record<string, unknown>> = UnionToIntersection<\n  {\n    [K in keyof Packs]: ExtractCodecTypesFromPack<Packs[K]>;\n  }[keyof Packs]\n>;\n\ntype BuildStorageTable<\n  _TableName extends string,\n  Columns extends Record<string, ColumnBuilderState<string, boolean, string>>,\n  PK extends readonly string[] | undefined,\n> = {\n  readonly columns: {\n    readonly [K in keyof Columns]: Columns[K] extends ColumnBuilderState<\n      string,\n      infer Null,\n      infer TType\n    >\n      ? BuildStorageColumn<Null & boolean, TType>\n      : never;\n  };\n  readonly uniques: ReadonlyArray<{ readonly columns: readonly string[]; readonly name?: string }>;\n  readonly indexes: ReadonlyArray<Index>;\n  readonly foreignKeys: ReadonlyArray<{\n    readonly columns: readonly string[];\n    readonly references: { readonly table: string; readonly columns: readonly string[] };\n    readonly name?: string;\n    readonly onDelete?: ReferentialAction;\n    readonly onUpdate?: ReferentialAction;\n    readonly constraint: boolean;\n    readonly index: boolean;\n  }>;\n} & (PK extends readonly string[]\n  ? { readonly primaryKey: { readonly columns: PK; readonly name?: string } }\n  : Record<string, never>);\n\ntype BuildStorage<\n  Tables extends Record<\n    string,\n    TableBuilderState<\n      string,\n      Record<string, ColumnBuilderState<string, boolean, string>>,\n      readonly string[] | undefined\n    >\n  >,\n  Types extends Record<string, StorageTypeInstance>,\n> = {\n  readonly tables: {\n    readonly [K in keyof Tables]: BuildStorageTable<\n      K & string,\n      ExtractColumns<Tables[K]>,\n      ExtractPrimaryKey<Tables[K]>\n    >;\n  };\n  readonly types: Types;\n};\n\ntype BuildStorageTables<\n  Tables extends Record<\n    string,\n    TableBuilderState<\n      string,\n      Record<string, ColumnBuilderState<string, boolean, string>>,\n      readonly string[] | undefined\n    >\n  >,\n> = {\n  readonly [K in keyof Tables]: BuildStorageTable<\n    K & string,\n    ExtractColumns<Tables[K]>,\n    ExtractPrimaryKey<Tables[K]>\n  >;\n};\n\nexport interface ColumnBuilder<Name extends string, Nullable extends boolean, Type extends string> {\n  nullable<Value extends boolean>(value?: Value): ColumnBuilder<Name, Value, Type>;\n  type<Id extends string>(id: Id): ColumnBuilder<Name, Nullable, Id>;\n  build(): ColumnBuilderState<Name, Nullable, Type>;\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== 'object' || value === null) return false;\n  const proto = Object.getPrototypeOf(value);\n  return proto === Object.prototype || proto === null;\n}\n\nfunction isJsonValue(value: unknown): value is ColumnDefaultLiteralValue {\n  if (value === null) return true;\n  const valueType = typeof value;\n  if (valueType === 'string' || valueType === 'number' || valueType === 'boolean') return true;\n  if (Array.isArray(value)) {\n    return value.every((item) => isJsonValue(item));\n  }\n  if (isPlainObject(value)) {\n    return Object.values(value).every((item) => isJsonValue(item));\n  }\n  return false;\n}\n\nfunction encodeDefaultLiteralValue(\n  value: ColumnDefaultLiteralInputValue,\n): ColumnDefaultLiteralValue {\n  if (typeof value === 'bigint') {\n    return { $type: 'bigint', value: value.toString() };\n  }\n  if (value instanceof Date) {\n    return value.toISOString();\n  }\n  if (isJsonValue(value)) {\n    if (isPlainObject(value) && '$type' in value) {\n      return { $type: 'raw', value } satisfies TaggedRaw;\n    }\n    return value;\n  }\n  throw new Error(\n    'Unsupported column default literal value: expected JSON-safe value, bigint, or Date.',\n  );\n}\n\nfunction encodeColumnDefault(defaultInput: ColumnDefault): ColumnDefault {\n  if (defaultInput.kind === 'function') {\n    return { kind: 'function', expression: defaultInput.expression };\n  }\n  return { kind: 'literal', value: encodeDefaultLiteralValue(defaultInput.value) };\n}\n\nclass SqlContractBuilder<\n  CodecTypes extends Record<string, { output: unknown }> = Record<string, never>,\n  Target extends string | undefined = undefined,\n  Tables extends Record<\n    string,\n    TableBuilderState<\n      string,\n      Record<string, ColumnBuilderState<string, boolean, string>>,\n      readonly string[] | undefined\n    >\n  > = Record<never, never>,\n  Models extends Record<\n    string,\n    ModelBuilderState<string, string, Record<string, string>, Record<string, RelationDefinition>>\n  > = Record<never, never>,\n  Types extends Record<string, StorageTypeInstance> = Record<never, never>,\n  StorageHash extends string | undefined = undefined,\n  ExtensionPacks extends Record<string, unknown> | undefined = undefined,\n  Capabilities extends Record<string, Record<string, boolean>> | undefined = undefined,\n> extends ContractBuilder<Target, Tables, Models, StorageHash, ExtensionPacks, Capabilities> {\n  protected declare readonly state: ContractBuilderState<\n    Target,\n    Tables,\n    Models,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > & {\n    readonly storageTypes?: Types;\n  };\n  /**\n   * This method is responsible for normalizing the contract IR by setting default values\n   * for all required fields:\n   * - `nullable`: defaults to `false` if not provided\n   * - `uniques`: defaults to `[]` (empty array)\n   * - `indexes`: defaults to `[]` (empty array)\n   * - `foreignKeys`: defaults to `[]` (empty array)\n   * - `relations`: defaults to `{}` (empty object) for both model-level and contract-level\n   * - `nativeType`: required field set from column type descriptor when columns are defined\n   *\n   * The contract builder is the **only** place where normalization should occur.\n   * Validators, parsers, and emitters should assume the contract is already normalized.\n   *\n   * **Required**: Use column type descriptors (e.g., `int4Column`, `textColumn`) when defining columns.\n   * This ensures `nativeType` is set correctly at build time.\n   *\n   * @returns A normalized SqlContract with all required fields present\n   */\n  build(): Target extends string\n    ? ContractWithTypeMaps<\n        SqlContract<\n          BuildStorage<Tables, Types>,\n          BuildModels<Models>,\n          BuildRelations<Models>,\n          ContractBuilderMappings\n        > & {\n          readonly schemaVersion: '1';\n          readonly target: Target;\n          readonly targetFamily: 'sql';\n          readonly storageHash: StorageHash extends string ? StorageHash : string;\n        } & (ExtensionPacks extends Record<string, unknown>\n            ? { readonly extensionPacks: ExtensionPacks }\n            : Record<string, never>) &\n          (Capabilities extends Record<string, Record<string, boolean>>\n            ? { readonly capabilities: Capabilities }\n            : Record<string, never>),\n        TypeMaps<CodecTypes, Record<string, never>>\n      >\n    : never {\n    type BuiltContract = Target extends string\n      ? ContractWithTypeMaps<\n          SqlContract<\n            BuildStorage<Tables, Types>,\n            BuildModels<Models>,\n            BuildRelations<Models>,\n            ContractBuilderMappings\n          > & {\n            readonly schemaVersion: '1';\n            readonly target: Target;\n            readonly targetFamily: 'sql';\n            readonly storageHash: StorageHash extends string ? StorageHash : string;\n          } & (ExtensionPacks extends Record<string, unknown>\n              ? { readonly extensionPacks: ExtensionPacks }\n              : Record<string, never>) &\n            (Capabilities extends Record<string, Record<string, boolean>>\n              ? { readonly capabilities: Capabilities }\n              : Record<string, never>),\n          TypeMaps<CodecTypes, Record<string, never>>\n        >\n      : never;\n    if (!this.state.target) {\n      throw new Error('target is required. Call .target() before .build()');\n    }\n\n    const target = this.state.target as Target & string;\n\n    const storageTables = {} as Partial<Mutable<BuildStorageTables<Tables>>>;\n    const executionDefaults: ExecutionMutationDefault[] = [];\n\n    for (const tableName of Object.keys(this.state.tables) as Array<keyof Tables & string>) {\n      const tableState = this.state.tables[tableName];\n      if (!tableState) continue;\n\n      type TableKey = typeof tableName;\n      type ColumnDefs = ExtractColumns<Tables[TableKey]>;\n      type PrimaryKey = ExtractPrimaryKey<Tables[TableKey]>;\n\n      const columns = {} as Partial<{\n        [K in keyof ColumnDefs]: BuildStorageColumn<\n          ColumnDefs[K]['nullable'] & boolean,\n          ColumnDefs[K]['type']\n        >;\n      }>;\n\n      for (const columnName in tableState.columns) {\n        const columnState = tableState.columns[columnName];\n        if (!columnState) continue;\n        const codecId = columnState.type;\n        const nativeType = columnState.nativeType;\n        const typeRef = columnState.typeRef;\n\n        const encodedDefault =\n          columnState.default !== undefined\n            ? encodeColumnDefault(columnState.default as ColumnDefault)\n            : undefined;\n\n        columns[columnName as keyof ColumnDefs] = {\n          nativeType,\n          codecId,\n          nullable: (columnState.nullable ?? false) as ColumnDefs[keyof ColumnDefs]['nullable'] &\n            boolean,\n          ...ifDefined('typeParams', columnState.typeParams),\n          ...ifDefined('default', encodedDefault),\n          ...ifDefined('typeRef', typeRef),\n        } as BuildStorageColumn<\n          ColumnDefs[keyof ColumnDefs]['nullable'] & boolean,\n          ColumnDefs[keyof ColumnDefs]['type']\n        >;\n\n        if ('executionDefault' in columnState && columnState.executionDefault) {\n          executionDefaults.push({\n            ref: { table: tableName, column: columnName },\n            onCreate: columnState.executionDefault,\n          });\n        }\n      }\n\n      // Build uniques from table state\n      const uniques = (tableState.uniques ?? []).map((u) => ({\n        columns: u.columns,\n        ...(u.name ? { name: u.name } : {}),\n      }));\n\n      // Build indexes from table state\n      const indexes = (tableState.indexes ?? []).map((i) => ({\n        columns: i.columns,\n        ...(i.name ? { name: i.name } : {}),\n        ...(i.using ? { using: i.using } : {}),\n        ...(i.config ? { config: i.config } : {}),\n      }));\n\n      // Build foreign keys from table state, materializing defaults\n      const foreignKeys = (tableState.foreignKeys ?? []).map((fk) => ({\n        columns: fk.columns,\n        references: fk.references,\n        ...applyFkDefaults(fk, this.state.foreignKeyDefaults),\n        ...(fk.name ? { name: fk.name } : {}),\n        ...(fk.onDelete !== undefined ? { onDelete: fk.onDelete } : {}),\n        ...(fk.onUpdate !== undefined ? { onUpdate: fk.onUpdate } : {}),\n      }));\n\n      const table = {\n        columns: columns as {\n          [K in keyof ColumnDefs]: BuildStorageColumn<\n            ColumnDefs[K]['nullable'] & boolean,\n            ColumnDefs[K]['type']\n          >;\n        },\n        uniques,\n        indexes,\n        foreignKeys,\n        ...(tableState.primaryKey\n          ? {\n              primaryKey: {\n                columns: tableState.primaryKey,\n                ...(tableState.primaryKeyName ? { name: tableState.primaryKeyName } : {}),\n              },\n            }\n          : {}),\n      } as unknown as BuildStorageTable<TableKey & string, ColumnDefs, PrimaryKey>;\n\n      (storageTables as Mutable<BuildStorageTables<Tables>>)[tableName] = table;\n    }\n\n    const storageTypes = (this.state.storageTypes ?? {}) as Types;\n    const storage: BuildStorage<Tables, Types> = {\n      tables: storageTables as BuildStorageTables<Tables>,\n      types: storageTypes,\n    };\n\n    const execution =\n      executionDefaults.length > 0\n        ? {\n            mutations: {\n              defaults: executionDefaults.sort((a, b) => {\n                const tableCompare = a.ref.table.localeCompare(b.ref.table);\n                if (tableCompare !== 0) {\n                  return tableCompare;\n                }\n                return a.ref.column.localeCompare(b.ref.column);\n              }),\n            },\n          }\n        : undefined;\n\n    // Build models - construct as partial first, then assert full type\n    const modelsPartial: Partial<BuildModels<Models>> = {};\n\n    // Iterate over models - TypeScript will see keys as string, but type assertion preserves literals\n    for (const modelName in this.state.models) {\n      const modelState = this.state.models[modelName];\n      if (!modelState) continue;\n\n      const modelStateTyped = modelState as unknown as {\n        name: string;\n        table: string;\n        fields: Record<string, string>;\n      };\n\n      // Build fields object\n      const fields: Partial<Record<string, ModelField>> = {};\n\n      // Iterate over fields\n      for (const fieldName in modelStateTyped.fields) {\n        const columnName = modelStateTyped.fields[fieldName];\n        if (columnName) {\n          fields[fieldName] = {\n            column: columnName,\n          };\n        }\n      }\n\n      // Assign to models - type assertion preserves literal keys\n      (modelsPartial as unknown as Record<string, ModelDefinition>)[modelName] = {\n        storage: {\n          table: modelStateTyped.table,\n        },\n        fields: fields as Record<string, ModelField>,\n        relations: {},\n      };\n    }\n\n    // Build relations object - organized by table name\n    const relationsPartial: Partial<Record<string, Record<string, RelationDefinition>>> = {};\n\n    // Iterate over models to collect relations\n    for (const modelName in this.state.models) {\n      const modelState = this.state.models[modelName];\n      if (!modelState) continue;\n\n      const modelStateTyped = modelState as unknown as {\n        name: string;\n        table: string;\n        fields: Record<string, string>;\n        relations: Record<string, RelationDefinition>;\n      };\n\n      const tableName = modelStateTyped.table;\n      if (!tableName) continue;\n\n      // Only initialize relations object for this table if it has relations\n      if (modelStateTyped.relations && Object.keys(modelStateTyped.relations).length > 0) {\n        if (!relationsPartial[tableName]) {\n          relationsPartial[tableName] = {};\n        }\n\n        // Add relations from this model to the table's relations\n        const tableRelations = relationsPartial[tableName];\n        if (tableRelations) {\n          for (const relationName in modelStateTyped.relations) {\n            const relation = modelStateTyped.relations[relationName];\n            if (relation) {\n              tableRelations[relationName] = relation;\n            }\n          }\n        }\n      }\n    }\n\n    const models = modelsPartial as unknown as BuildModels<Models>;\n\n    const baseMappings = computeMappings(\n      models as unknown as Record<string, ModelDefinition>,\n      storage as SqlStorage,\n    );\n\n    const mappings = baseMappings as ContractBuilderMappings;\n\n    const extensionNamespaces = this.state.extensionNamespaces ?? [];\n    const extensionPacks: Record<string, unknown> = { ...(this.state.extensionPacks || {}) };\n    for (const namespace of extensionNamespaces) {\n      if (!Object.hasOwn(extensionPacks, namespace)) {\n        extensionPacks[namespace] = {};\n      }\n    }\n\n    // Construct contract with explicit type that matches the generic parameters\n    // This ensures TypeScript infers literal types from the generics, not runtime values\n    // Always include relations, even if empty (normalized to empty object)\n    const contract = {\n      schemaVersion: '1' as const,\n      target,\n      targetFamily: 'sql' as const,\n      storageHash: this.state.storageHash || 'sha256:ts-builder-placeholder',\n      models,\n      relations: relationsPartial,\n      storage,\n      mappings,\n      ...(execution ? { execution } : {}),\n      extensionPacks,\n      capabilities: this.state.capabilities || {},\n      meta: {},\n      sources: {},\n    } as unknown as BuiltContract;\n\n    return contract as unknown as ReturnType<\n      SqlContractBuilder<\n        CodecTypes,\n        Target,\n        Tables,\n        Models,\n        Types,\n        StorageHash,\n        ExtensionPacks,\n        Capabilities\n      >['build']\n    >;\n  }\n\n  override target<\n    T extends string,\n    TPack extends TargetPackRef<string, T> = TargetPackRef<string, T>,\n  >(\n    packRef: TPack & TargetPackRef<string, T>,\n  ): SqlContractBuilder<\n    ExtractCodecTypesFromPack<TPack> extends Record<string, never>\n      ? CodecTypes\n      : ExtractCodecTypesFromPack<TPack>,\n    T,\n    Tables,\n    Models,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    return new SqlContractBuilder<\n      ExtractCodecTypesFromPack<TPack> extends Record<string, never>\n        ? CodecTypes\n        : ExtractCodecTypesFromPack<TPack>,\n      T,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      target: packRef.targetId,\n    }) as SqlContractBuilder<\n      ExtractCodecTypesFromPack<TPack> extends Record<string, never>\n        ? CodecTypes\n        : ExtractCodecTypesFromPack<TPack>,\n      T,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >;\n  }\n\n  extensionPacks<const Packs extends Record<string, ExtensionPackRef<'sql', string>>>(\n    packs: Packs,\n  ): SqlContractBuilder<\n    CodecTypes & MergeExtensionCodecTypes<Packs>,\n    Target,\n    Tables,\n    Models,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    if (!this.state.target) {\n      throw new Error('extensionPacks() requires target() to be called first');\n    }\n\n    const namespaces = new Set(this.state.extensionNamespaces ?? []);\n\n    for (const packRef of Object.values(packs) as ExtensionPackRef<'sql', string>[]) {\n      if (!packRef) continue;\n\n      if (packRef.kind !== 'extension') {\n        throw new Error(\n          `extensionPacks() only accepts extension pack refs. Received kind \"${packRef.kind}\".`,\n        );\n      }\n\n      if (packRef.familyId !== 'sql') {\n        throw new Error(\n          `extension pack \"${packRef.id}\" targets family \"${packRef.familyId}\" but this builder targets \"sql\".`,\n        );\n      }\n\n      if (packRef.targetId && packRef.targetId !== this.state.target) {\n        throw new Error(\n          `extension pack \"${packRef.id}\" targets \"${packRef.targetId}\" but builder target is \"${this.state.target}\".`,\n        );\n      }\n\n      namespaces.add(packRef.id);\n    }\n\n    return new SqlContractBuilder<\n      CodecTypes & MergeExtensionCodecTypes<Packs>,\n      Target,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      extensionNamespaces: [...namespaces],\n    });\n  }\n\n  override capabilities<C extends Record<string, Record<string, boolean>>>(\n    capabilities: C,\n  ): SqlContractBuilder<CodecTypes, Target, Tables, Models, Types, StorageHash, ExtensionPacks, C> {\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      C\n    >({\n      ...this.state,\n      capabilities,\n    });\n  }\n\n  override storageHash<H extends string>(\n    hash: H,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables,\n    Models,\n    Types,\n    H,\n    ExtensionPacks,\n    Capabilities\n  > {\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models,\n      Types,\n      H,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      storageHash: hash,\n    });\n  }\n\n  override table<\n    TableName extends string,\n    T extends TableBuilder<\n      TableName,\n      Record<string, ColumnBuilderState<string, boolean, string>>,\n      readonly string[] | undefined\n    >,\n  >(\n    name: TableName,\n    callback: (t: TableBuilder<TableName>) => T | undefined,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables & Record<TableName, ReturnType<T['build']>>,\n    Models,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    const tableBuilder = createTable(name);\n    const result = callback(\n      tableBuilder as unknown as SqlTableBuilder<\n        TableName,\n        CodecTypes\n      > as unknown as TableBuilder<TableName>,\n    );\n    const finalBuilder = result instanceof TableBuilder ? result : tableBuilder;\n    const tableState = finalBuilder.build();\n\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables & Record<TableName, ReturnType<T['build']>>,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      tables: { ...this.state.tables, [name]: tableState } as Tables &\n        Record<TableName, ReturnType<T['build']>>,\n    });\n  }\n\n  override model<\n    ModelName extends string,\n    TableName extends string,\n    M extends ModelBuilder<\n      ModelName,\n      TableName,\n      Record<string, string>,\n      Record<string, RelationDefinition>\n    >,\n  >(\n    name: ModelName,\n    table: TableName,\n    callback: (\n      m: ModelBuilder<ModelName, TableName, Record<never, never>, Record<never, never>>,\n    ) => M | undefined,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables,\n    Models & Record<ModelName, ReturnType<M['build']>>,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    const modelBuilder = new ModelBuilder<ModelName, TableName>(name, table);\n    const result = callback(modelBuilder);\n    const finalBuilder = result instanceof ModelBuilder ? result : modelBuilder;\n    const modelState = finalBuilder.build();\n\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models & Record<ModelName, ReturnType<M['build']>>,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      models: { ...this.state.models, [name]: modelState } as Models &\n        Record<ModelName, ReturnType<M['build']>>,\n    });\n  }\n\n  override foreignKeyDefaults(\n    config: ForeignKeyDefaultsState,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables,\n    Models,\n    Types,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models,\n      Types,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      foreignKeyDefaults: config,\n    });\n  }\n\n  storageType<Name extends string, Type extends StorageTypeInstance>(\n    name: Name,\n    typeInstance: Type,\n  ): SqlContractBuilder<\n    CodecTypes,\n    Target,\n    Tables,\n    Models,\n    Types & Record<Name, Type>,\n    StorageHash,\n    ExtensionPacks,\n    Capabilities\n  > {\n    return new SqlContractBuilder<\n      CodecTypes,\n      Target,\n      Tables,\n      Models,\n      Types & Record<Name, Type>,\n      StorageHash,\n      ExtensionPacks,\n      Capabilities\n    >({\n      ...this.state,\n      storageTypes: {\n        ...(this.state.storageTypes ?? {}),\n        [name]: typeInstance,\n      },\n    });\n  }\n}\n\nexport function defineContract<\n  CodecTypes extends Record<string, { output: unknown }> = Record<string, never>,\n>(): SqlContractBuilder<CodecTypes> {\n  return new SqlContractBuilder<CodecTypes>();\n}\n"],"mappings":"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"}

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@prisma-next/sql-contract-ts",
-  "version": "0.3.0-dev.87",
+  "version": "0.3.0-dev.88",
   "type": "module",
   "sideEffects": false,
   "description": "SQL-specific TypeScript contract authoring surface for Prisma Next",
   "dependencies": {
     "arktype": "^2.1.25",
     "ts-toolbelt": "^9.6.0",
-    "@prisma-next/config": "0.3.0-dev.87",
-    "@prisma-next/contract": "0.3.0-dev.87",
-    "@prisma-next/contract-authoring": "0.3.0-dev.87",
-    "@prisma-next/utils": "0.3.0-dev.87",
-    "@prisma-next/sql-contract": "0.3.0-dev.87"
+    "@prisma-next/config": "0.3.0-dev.88",
+    "@prisma-next/contract": "0.3.0-dev.88",
+    "@prisma-next/sql-contract": "0.3.0-dev.88",
+    "@prisma-next/contract-authoring": "0.3.0-dev.88",
+    "@prisma-next/utils": "0.3.0-dev.88"
   },
   "devDependencies": {
     "@types/pg": "8.16.0",
@@ -19,9 +19,9 @@
     "tsdown": "0.18.4",
     "typescript": "5.9.3",
     "vitest": "4.0.17",
-    "@prisma-next/tsdown": "0.0.0",
     "@prisma-next/test-utils": "0.0.1",
-    "@prisma-next/tsconfig": "0.0.0"
+    "@prisma-next/tsconfig": "0.0.0",
+    "@prisma-next/tsdown": "0.0.0"
   },
   "files": [
     "dist",

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

@@ -212,7 +212,7 @@
         },
         "id": {
           "type": "string",
-          "enum": ["ulid", "nanoid", "uuidv7", "uuidv4", "cuid2", "ksuid"]
+          "pattern": "^[A-Za-z0-9][A-Za-z0-9_-]*$"
         },
         "params": {
           "type": "object",

package/src/contract.ts

@@ -75,9 +75,13 @@ const ModelSchema = type.declare<ModelDefinition>().type({
   relations: type({ '[string]': 'unknown' }),
 });
 
+const GeneratorIdSchema = type('string').narrow((value, ctx) => {
+  return /^[A-Za-z0-9][A-Za-z0-9_-]*$/.test(value) ? true : ctx.mustBe('a flat generator id');
+});
+
 const ExecutionMutationDefaultValueSchema = type({
   kind: "'generator'",
-  id: "'ulid' | 'nanoid' | 'uuidv7' | 'uuidv4' | 'cuid2' | 'ksuid'",
+  id: GeneratorIdSchema,
   'params?': 'Record<string, unknown>',
 });