@fragno-dev/db 0.2.0 → 0.2.2

package/dist/schema/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","names":["defaultBuilder: DefaultBuilder","runtimeDefaultBuilder: RuntimeDefaultBuilder","#externalId","#internalId","#version","#name","#columns","#relations","#indexes","#columnOrder","column","idCol: AnyColumn | undefined","internalIdCol: AnyColumn | undefined","versionCol: AnyColumn | undefined","#ormName","table: Table<TColumns, TRelations, TIndexes>","#tables","#operations","schema","subOperations: TableSubOperation[]","cloneTables: Record<string, AnyTable>","clonedColumns: Record<string, AnyColumn>","clonedCol: AnyColumn"],"sources":["../../src/schema/create.ts"],"sourcesContent":["import { createId } from \"../id\";\nimport { inspect } from \"node:util\";\n\nexport type AnySchema = Schema<Record<string, AnyTable>>;\n\nexport type AnyRelation = Relation;\n\nexport type AnyTable = Table;\n\nexport type AnyColumn =\n  | Column<keyof TypeMap, unknown, unknown>\n  | IdColumn<IdColumnType, unknown, unknown>\n  | InternalIdColumn<unknown, unknown>\n  | VersionColumn<unknown, unknown>;\n/**\n * Sub-operations that can be performed within table operations.\n * These are stored in order within add-table and alter-table operations.\n */\nexport type TableSubOperation =\n  | { type: \"add-column\"; columnName: string; column: AnyColumn }\n  | { type: \"add-index\"; name: string; columns: string[]; unique: boolean }\n  | {\n      type: \"add-foreign-key\";\n      name: string;\n      columns: string[];\n      referencedTable: string;\n      referencedColumns: string[];\n    };\n\n/**\n * Operations that can be performed on a schema during its definition.\n * These are tracked so we can generate migrations for specific version ranges.\n */\nexport type SchemaOperation =\n  | {\n      type: \"add-table\";\n      tableName: string;\n      operations: TableSubOperation[]; // Ordered list of sub-operations\n    }\n  | {\n      type: \"alter-table\";\n      tableName: string;\n      operations: TableSubOperation[]; // Ordered list of sub-operations\n    }\n  | {\n      type: \"add-reference\";\n      tableName: string; // The table that has the foreign key\n      referenceName: string;\n      config: {\n        type: \"one\" | \"many\";\n        from: { table: string; column: string };\n        to: { table: string; column: string };\n      };\n    };\n\nexport interface ForeignKey {\n  name: string;\n  table: AnyTable;\n  columns: AnyColumn[];\n\n  referencedTable: AnyTable;\n  referencedColumns: AnyColumn[];\n}\n\nclass RelationInit<\n  TRelationType extends RelationType,\n  TTables extends Record<string, AnyTable>,\n  TTableName extends keyof TTables,\n> {\n  type: TRelationType;\n  referencedTable: TTables[TTableName];\n  referencer: AnyTable;\n  on: [string, string][] = [];\n\n  constructor(type: TRelationType, referencedTable: TTables[TTableName], referencer: AnyTable) {\n    this.type = type;\n    this.referencedTable = referencedTable;\n    this.referencer = referencer;\n  }\n}\n\nexport interface Index<\n  TColumns extends AnyColumn[] = AnyColumn[],\n  TColumnNames extends readonly string[] = readonly string[],\n> {\n  name: string;\n  columns: TColumns;\n  columnNames: TColumnNames;\n  unique: boolean;\n}\n\nexport class ExplicitRelationInit<\n  TRelationType extends RelationType,\n  TTables extends Record<string, AnyTable>,\n  TTableName extends keyof TTables,\n> extends RelationInit<TRelationType, TTables, TTableName> {\n  init(ormName: string): Relation<TRelationType, TTables[TTableName]> {\n    const id = `${this.referencer.ormName}_${this.referencedTable.ormName}`;\n\n    return {\n      id,\n      on: this.on,\n      name: ormName,\n      referencer: this.referencer,\n      table: this.referencedTable,\n      type: this.type,\n    };\n  }\n}\n\nexport interface Relation<\n  TRelationType extends RelationType = RelationType,\n  TTable extends AnyTable = AnyTable,\n> {\n  id: string;\n  name: string;\n  type: TRelationType;\n\n  table: TTable;\n  referencer: AnyTable;\n\n  on: [string, string][];\n}\n\nexport interface Table<\n  TColumns extends Record<string, AnyColumn> = Record<string, AnyColumn>,\n  TRelations extends Record<string, AnyRelation> = Record<string, AnyRelation>,\n  TIndexes extends Record<string, Index> = Record<string, Index>,\n> {\n  name: string;\n  ormName: string;\n\n  columns: TColumns;\n  relations: TRelations;\n  indexes: TIndexes;\n\n  /**\n   * Get column by name\n   */\n  getColumnByName: (name: string) => AnyColumn | undefined;\n  /**\n   * Get the external ID column (user-facing)\n   */\n  getIdColumn: () => AnyColumn;\n  /**\n   * Get the internal ID column (database-native, used for joins)\n   */\n  getInternalIdColumn: () => AnyColumn;\n  /**\n   * Get the version column (for optimistic concurrency control)\n   */\n  getVersionColumn: () => AnyColumn;\n}\n\ntype DBSpecial = { tag: \"special\"; value: \"now\" };\ntype RuntimeSpecial = { tag: \"special\"; value: \"cuid\" | \"now\" };\n\n/**\n * Builder for database-level default values.\n */\nexport interface DefaultBuilder {\n  /** Database-generated timestamp (DEFAULT NOW()) */\n  now(): DBSpecial;\n}\n\n/**\n * Builder for runtime-generated default values.\n */\nexport interface RuntimeDefaultBuilder {\n  /** Generate CUID identifier */\n  cuid(): RuntimeSpecial;\n  /** Generate current timestamp */\n  now(): RuntimeSpecial;\n}\n\nconst defaultBuilder: DefaultBuilder = {\n  now: () => ({ tag: \"special\", value: \"now\" }),\n};\n\nconst runtimeDefaultBuilder: RuntimeDefaultBuilder = {\n  cuid: () => ({ tag: \"special\", value: \"cuid\" }),\n  now: () => ({ tag: \"special\", value: \"now\" }),\n};\n\ntype IdColumnType = `varchar(${number})`;\n\nexport type TypeMap = {\n  string: string;\n  bigint: bigint;\n  integer: number;\n  decimal: number;\n  bool: boolean;\n  json: unknown;\n  /**\n   * this follows the same specs as Prisma `Bytes` for consistency.\n   */\n  binary: Uint8Array;\n  date: Date;\n  timestamp: Date;\n} & Record<`varchar(${number})`, string>;\n\nexport class Column<TType extends keyof TypeMap, TIn = unknown, TOut = unknown> {\n  type: TType;\n  name: string = \"\";\n  ormName: string = \"\";\n  isNullable: boolean = false;\n  role: \"external-id\" | \"internal-id\" | \"version\" | \"reference\" | \"regular\" = \"regular\";\n  isHidden: boolean = false;\n\n  default?:\n    | { value: TypeMap[TType] }\n    | { dbSpecial: \"now\" }\n    | { runtime: \"cuid\" | \"now\" | (() => TypeMap[TType]) };\n\n  tableName: string = \"\";\n\n  constructor(type: TType) {\n    this.type = type;\n  }\n\n  nullable<TNullable extends boolean = true>(nullable?: TNullable) {\n    this.isNullable = nullable ?? true;\n\n    return this as Column<\n      TType,\n      TNullable extends true ? TIn | null : Exclude<TIn, null>,\n      TNullable extends true ? TOut | null : Exclude<TOut, null>\n    >;\n  }\n\n  hidden<THidden extends boolean = true>(hidden?: THidden) {\n    this.isHidden = hidden ?? true;\n    return this as Column<TType, null, null>;\n  }\n\n  /**\n   * Generate default value at runtime in application code (not in the database).\n   *\n   * Use this when you need values generated in your application code, either because:\n   * - Your database doesn't support the operation (e.g., generating CUIDs)\n   * - You want consistent behavior across all databases\n   * - You need custom generation logic\n   *\n   * @param value - Either a literal value or builder callback:\n   *   - Literal: Any static value of the column type\n   *   - `(b) => b.cuid()` - Generate a CUID identifier\n   *   - `(b) => b.now()` - Generate current timestamp\n   *   - `(b) => ...` - Custom function that returns the default value\n   *\n   * @example\n   * ```ts\n   * column(\"string\").defaultTo$((b) => b.cuid())           // Generate CUID at runtime\n   * column(\"timestamp\").defaultTo$((b) => b.now())         // Generate timestamp at runtime\n   * column(\"integer\").defaultTo$(42)                       // Static literal\n   * column(\"integer\").defaultTo$((b) => Math.floor(Math.random() * 100))  // Custom function\n   * ```\n   */\n  defaultTo$(\n    value: TypeMap[TType] | ((builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType]),\n  ): Column<TType, TIn | null, TOut> {\n    if (typeof value === \"function\") {\n      const fn = value as (builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType];\n      const result = fn(runtimeDefaultBuilder);\n      if (\n        typeof result === \"object\" &&\n        result !== null &&\n        \"tag\" in result &&\n        result.tag === \"special\"\n      ) {\n        this.default = { runtime: result.value };\n      } else {\n        // Custom function - we need to wrap the callback to call it again later\n        this.default = { runtime: () => fn(runtimeDefaultBuilder) as TypeMap[TType] };\n      }\n    } else {\n      // Direct literal value - wrap it in a function for runtime generation\n      this.default = { runtime: () => value };\n    }\n    return this;\n  }\n\n  /**\n   * Set a database-level default value (generated by the database, not application code).\n   *\n   * The database will generate the default value when inserting rows. If the database\n   * doesn't support the operation, Fragno will fall back to generating the value in\n   * application code.\n   *\n   * @param value - Either a literal value or builder callback:\n   *   - Literal: Any static value of the column type\n   *   - `(b) => b.now()` - Database-generated timestamp\n   *\n   * @example\n   * ```ts\n   * // Static defaults\n   * column(\"string\").defaultTo(\"active\")\n   * column(\"integer\").defaultTo(0)\n   * column(\"boolean\").defaultTo(true)\n   *\n   * // Database-generated timestamp (with fallback)\n   * column(\"timestamp\").defaultTo((b) => b.now())\n   * ```\n   */\n  defaultTo(\n    value: TypeMap[TType] | ((builder: DefaultBuilder) => DBSpecial | TypeMap[TType]),\n  ): Column<TType, TIn | null, TOut> {\n    if (typeof value === \"function\") {\n      const fn = value as (builder: DefaultBuilder) => DBSpecial | TypeMap[TType];\n      const result = fn(defaultBuilder);\n      if (\n        typeof result === \"object\" &&\n        result !== null &&\n        \"tag\" in result &&\n        result.tag === \"special\"\n      ) {\n        this.default = { dbSpecial: result.value };\n      } else {\n        this.default = { value: result as TypeMap[TType] };\n      }\n    } else {\n      this.default = { value };\n    }\n    return this;\n  }\n\n  /**\n   * Generate default value for the column at runtime.\n   * Used for both runtime defaults (defaultTo$) and fallback generation for\n   * database defaults (defaultTo) when the database doesn't support them.\n   */\n  generateDefaultValue(): TypeMap[TType] | undefined {\n    if (!this.default) {\n      return;\n    }\n\n    if (\"value\" in this.default) {\n      return this.default.value;\n    }\n\n    if (\"dbSpecial\" in this.default) {\n      // Fallback generation for database-level special functions\n      if (this.default.dbSpecial === \"now\") {\n        return new Date(Date.now()) as TypeMap[TType];\n      }\n      return;\n    }\n\n    // Runtime defaults (defaultTo$)\n    if (this.default.runtime === \"cuid\") {\n      return createId() as TypeMap[TType];\n    }\n    if (this.default.runtime === \"now\") {\n      return new Date(Date.now()) as TypeMap[TType];\n    }\n\n    // Custom function\n    return this.default.runtime();\n  }\n\n  /**\n   * @description This is used for type inference only. Runtime value will be undefined.\n   * @internal\n   */\n  get $in(): TIn {\n    return undefined as unknown as TIn;\n  }\n\n  /**\n   * @description This is used for type inference only. Runtime value will be undefined.\n   * @internal\n   */\n  get $out(): TOut {\n    return undefined as unknown as TOut;\n  }\n}\n\nexport class IdColumn<\n  TType extends IdColumnType = IdColumnType,\n  TIn = unknown,\n  TOut = unknown,\n> extends Column<TType, TIn, TOut> {\n  id = true;\n\n  override defaultTo$(\n    value: TypeMap[TType] | ((builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType]),\n  ) {\n    return super.defaultTo$(value) as IdColumn<TType, TIn | null, TOut>;\n  }\n\n  override defaultTo(\n    value: TypeMap[TType] | ((builder: DefaultBuilder) => DBSpecial | TypeMap[TType]),\n  ) {\n    return super.defaultTo(value) as IdColumn<TType, TIn | null, TOut>;\n  }\n}\n\n/**\n * Internal ID column - used for database-native joins and foreign keys.\n * Hidden from user API by default.\n */\nexport class InternalIdColumn<TIn = unknown, TOut = unknown> extends Column<\"bigint\", TIn, TOut> {\n  override role = \"internal-id\" as const;\n\n  constructor() {\n    super(\"bigint\");\n    this.hidden();\n  }\n}\n\n/**\n * Version column - used for optimistic concurrency control.\n * Automatically incremented on each update.\n */\nexport class VersionColumn<TIn = unknown, TOut = unknown> extends Column<\"integer\", TIn, TOut> {\n  override role = \"version\" as const;\n\n  constructor() {\n    super(\"integer\");\n    this.defaultTo(0).hidden();\n  }\n}\n\nexport function column<TType extends keyof TypeMap>(\n  type: TType,\n): Column<TType, TypeMap[TType], TypeMap[TType]> {\n  return new Column(type);\n}\n\n/**\n * Create a reference column that points to another table's internal ID.\n * This is used for foreign key relationships.\n * Always uses bigint to match the internal ID type.\n */\nexport function referenceColumn(): Column<\n  \"bigint\",\n  string | bigint | FragnoId | FragnoReference,\n  FragnoReference\n> {\n  const col = new Column<\"bigint\", string | bigint | FragnoId | FragnoReference, FragnoReference>(\n    \"bigint\",\n  );\n  col.role = \"reference\";\n  return col;\n}\n\n/**\n * Create an external ID column (user-facing).\n * This is a CUID string that can be auto-generated or user-provided.\n * Input accepts string | FragnoId | null, output returns FragnoId.\n */\nexport function idColumn(): IdColumn<\"varchar(30)\", string | FragnoId | null, FragnoId> {\n  const col = new IdColumn<\"varchar(30)\", string | FragnoId | null, FragnoId>(\"varchar(30)\");\n  col.role = \"external-id\";\n  col.defaultTo$((b) => b.cuid());\n  return col;\n}\n\n/**\n * Create an internal ID column (database-native, hidden from user API).\n * Used for joins and foreign keys.\n * @internal\n */\nexport function internalIdColumn(): InternalIdColumn<null, bigint> {\n  const col = new InternalIdColumn<null, bigint>();\n  col.role = \"internal-id\";\n  col.hidden();\n  return col;\n}\n\n/**\n * Create a version column for optimistic concurrency control.\n * @internal\n */\nexport function versionColumn(): VersionColumn<null, number> {\n  const col = new VersionColumn<null, number>();\n  col.role = \"version\";\n  col.hidden();\n  return col;\n}\n\n/**\n * FragnoId represents a unified ID object that can contain external ID, internal ID, or both.\n * @internal\n *\n * For query inputs: externalId is sufficient (internalId is optional)\n * For query results: both externalId and internalId are provided\n */\nexport class FragnoId {\n  readonly #externalId: string;\n  readonly #internalId?: bigint;\n  readonly #version: number;\n\n  constructor({\n    externalId,\n    internalId,\n    version,\n  }: {\n    externalId: string;\n    internalId?: bigint;\n    version: number;\n  }) {\n    this.#externalId = externalId;\n    this.#internalId = internalId;\n    this.#version = version;\n  }\n\n  /**\n   * Create a FragnoId from just an external ID (for inputs)\n   */\n  static fromExternal(externalId: string, version: number): FragnoId {\n    return new FragnoId({ externalId, version });\n  }\n\n  get version(): number {\n    return this.#version;\n  }\n\n  get externalId(): string {\n    return this.#externalId;\n  }\n\n  get internalId(): bigint | undefined {\n    return this.#internalId;\n  }\n\n  /**\n   * Get the appropriate ID for database operations\n   * Prefers internal ID if available, falls back to external ID\n   */\n  get databaseId(): string | bigint {\n    return this.#internalId ?? this.#externalId;\n  }\n\n  /**\n   * Convert to a plain object for serialization\n   */\n  toJSON(): { externalId: string; internalId?: string } {\n    return {\n      externalId: this.#externalId,\n      internalId: this.#internalId?.toString(),\n    };\n  }\n\n  toString(): string {\n    return this.#externalId;\n  }\n\n  valueOf(): string {\n    return this.#externalId;\n  }\n\n  [inspect.custom](): string {\n    return `FragnoId { externalId: ${this.#externalId}, internalId: ${this.#internalId?.toString()} }`;\n  }\n}\n\n/**\n * FragnoReference represents a foreign key reference to another table's internal ID.\n * Unlike FragnoId, it only contains the internal ID (bigint) of the referenced record.\n * This is used for reference columns in query results.\n * @internal\n */\nexport class FragnoReference {\n  readonly #internalId: bigint;\n\n  constructor(internalId: bigint) {\n    this.#internalId = internalId;\n  }\n\n  /**\n   * Create a FragnoReference from an internal ID\n   */\n  static fromInternal(internalId: bigint): FragnoReference {\n    return new FragnoReference(internalId);\n  }\n\n  /**\n   * Get the internal ID for database operations\n   */\n  get internalId(): bigint {\n    return this.#internalId;\n  }\n}\n\ntype RelationType = \"one\" | \"many\";\n\nexport class TableBuilder<\n  TColumns extends Record<string, AnyColumn> = Record<string, AnyColumn>,\n  TRelations extends Record<string, AnyRelation> = Record<string, AnyRelation>,\n  TIndexes extends Record<string, Index> = Record<string, Index>,\n> {\n  #name: string;\n  #columns: TColumns;\n  #relations: TRelations;\n  #indexes: TIndexes;\n  #ormName: string = \"\";\n  #columnOrder: string[] = [];\n\n  constructor(name: string) {\n    this.#name = name;\n    this.#columns = {} as TColumns;\n    this.#relations = {} as TRelations;\n    this.#indexes = {} as TIndexes;\n  }\n\n  // For alterTable to set existing state\n  setColumns(columns: TColumns): void {\n    this.#columns = { ...columns };\n  }\n\n  setRelations(relations: TRelations): void {\n    this.#relations = { ...relations };\n  }\n\n  setIndexes(indexes: TIndexes): void {\n    this.#indexes = { ...indexes };\n  }\n\n  // For SchemaBuilder to read collected indexes\n  getIndexes(): Index[] {\n    return Object.values(this.#indexes) as Index[];\n  }\n\n  getColumnOrder(): string[] {\n    return this.#columnOrder;\n  }\n\n  /**\n   * Add a column to the table.\n   */\n  addColumn<TColumnName extends string, TColumn extends AnyColumn>(\n    ormName: TColumnName,\n    col: TColumn,\n  ): TableBuilder<TColumns & Record<TColumnName, TColumn>, TRelations, TIndexes>;\n\n  /**\n   * Add a column to the table with simplified syntax.\n   */\n  addColumn<TColumnName extends string, TType extends keyof TypeMap>(\n    ormName: TColumnName,\n    type: TType,\n  ): TableBuilder<\n    TColumns & Record<TColumnName, Column<TType, TypeMap[TType], TypeMap[TType]>>,\n    TRelations,\n    TIndexes\n  >;\n\n  addColumn<TColumnName extends string, TColumn extends AnyColumn, TType extends keyof TypeMap>(\n    ormName: TColumnName,\n    colOrType: TColumn | TType,\n  ): TableBuilder<TColumns & Record<TColumnName, TColumn>, TRelations, TIndexes> {\n    // Create the column if a type string was provided\n    const col = typeof colOrType === \"string\" ? column(colOrType) : colOrType;\n\n    // Set column metadata\n    col.ormName = ormName;\n    col.name = ormName;\n\n    // Add column directly to this builder\n    this.#columns[ormName] = col as unknown as TColumns[TColumnName];\n    this.#columnOrder.push(ormName);\n\n    return this as unknown as TableBuilder<\n      TColumns & Record<TColumnName, TColumn>,\n      TRelations,\n      TIndexes\n    >;\n  }\n\n  /**\n   * Create an index on the specified columns.\n   */\n  createIndex<\n    TIndexName extends string,\n    const TColumnNames extends readonly (string & keyof TColumns)[],\n  >(\n    name: TIndexName,\n    columns: TColumnNames,\n    options?: { unique?: boolean },\n  ): TableBuilder<\n    TColumns,\n    TRelations,\n    TIndexes & Record<TIndexName, Index<ColumnsToTuple<TColumns, TColumnNames>, TColumnNames>>\n  > {\n    const cols = columns.map((colName) => {\n      const column = this.#columns[colName];\n      if (!column) {\n        throw new Error(`Unknown column name ${colName}`);\n      }\n      return column;\n    });\n\n    const unique = options?.unique ?? false;\n    // Safe: we're adding the index to the internal indexes object\n    this.#indexes[name] = {\n      name,\n      columns: cols,\n      columnNames: columns,\n      unique,\n    } as unknown as TIndexes[TIndexName];\n\n    return this as unknown as TableBuilder<\n      TColumns,\n      TRelations,\n      TIndexes & Record<TIndexName, Index<ColumnsToTuple<TColumns, TColumnNames>, TColumnNames>>\n    >;\n  }\n\n  /**\n   * Build the final table. This should be called after all columns are added.\n   */\n  build(): Table<TColumns, TRelations, TIndexes> {\n    let idCol: AnyColumn | undefined;\n    let internalIdCol: AnyColumn | undefined;\n    let versionCol: AnyColumn | undefined;\n\n    // TODO: Throw if user manually added version/internalId columns\n\n    // Auto-add _internalId and _version columns if not already present\n    if (!this.#columns[\"_internalId\"]) {\n      const col = internalIdColumn();\n      col.ormName = \"_internalId\";\n      col.name = \"_internalId\";\n      // Safe: we're adding system columns to the internal columns object\n      (this.#columns as Record<string, AnyColumn>)[\"_internalId\"] = col;\n    }\n\n    if (!this.#columns[\"_version\"]) {\n      const col = versionColumn();\n      col.ormName = \"_version\";\n      col.name = \"_version\";\n      // Safe: we're adding system columns to the internal columns object\n      (this.#columns as Record<string, AnyColumn>)[\"_version\"] = col;\n    }\n\n    // Use name as ormName if ormName is not set\n    const ormName = this.#ormName || this.#name;\n\n    const table: Table<TColumns, TRelations, TIndexes> = {\n      name: this.#name,\n      ormName,\n      columns: this.#columns,\n      relations: this.#relations,\n      indexes: this.#indexes,\n      getColumnByName: (name) => {\n        return Object.values(this.#columns).find((c) => c.name === name);\n      },\n      getIdColumn: () => {\n        return idCol!;\n      },\n      getInternalIdColumn: () => {\n        return internalIdCol!;\n      },\n      getVersionColumn: () => {\n        return versionCol!;\n      },\n    };\n\n    // Set table reference and find special columns\n    for (const k in this.#columns) {\n      const column = this.#columns[k];\n      if (!column) {\n        continue;\n      }\n\n      column.tableName = table.name;\n      if (column instanceof IdColumn || column.role === \"external-id\") {\n        idCol = column;\n      }\n      if (column instanceof InternalIdColumn || column.role === \"internal-id\") {\n        internalIdCol = column;\n      }\n      if (column instanceof VersionColumn || column.role === \"version\") {\n        versionCol = column;\n      }\n    }\n\n    if (idCol === undefined) {\n      throw new Error(`there's no id column in your table ${this.#name}`);\n    }\n    if (internalIdCol === undefined) {\n      throw new Error(`there's no internal id column in your table ${this.#name}`);\n    }\n    if (versionCol === undefined) {\n      throw new Error(`there's no version column in your table ${this.#name}`);\n    }\n\n    return table;\n  }\n}\n\nexport interface Schema<TTables extends Record<string, AnyTable> = Record<string, AnyTable>> {\n  /**\n   * @description The version of the schema, automatically incremented on each change.\n   */\n  version: number;\n  tables: TTables;\n  /**\n   * @description Operations performed on this schema, in order.\n   * Used to generate migrations for specific version ranges.\n   */\n  operations: SchemaOperation[];\n\n  clone: () => Schema<TTables>;\n}\n\n/**\n * Utility type for updating a single table's relations in a schema.\n * Used to properly type the return value of addReference.\n */\ntype UpdateTableRelations<\n  TTables extends Record<string, AnyTable>,\n  TTableName extends keyof TTables,\n  TReferenceName extends string,\n  TReferencedTableName extends keyof TTables,\n  TRelationType extends RelationType = RelationType,\n> = {\n  [K in keyof TTables]: K extends TTableName\n    ? Table<\n        TTables[TTableName][\"columns\"],\n        TTables[TTableName][\"relations\"] &\n          Record<TReferenceName, Relation<TRelationType, TTables[TReferencedTableName]>>,\n        TTables[TTableName][\"indexes\"]\n      >\n    : TTables[K];\n};\n\n/**\n * Utility type for updating a single table in a schema.\n * Used to properly type the return value of alterTable.\n */\ntype UpdateTable<\n  TTables extends Record<string, AnyTable>,\n  TTableName extends keyof TTables,\n  TNewColumns extends Record<string, AnyColumn>,\n  TNewRelations extends Record<string, AnyRelation>,\n  TNewIndexes extends Record<string, Index>,\n> = {\n  [K in keyof TTables]: K extends TTableName\n    ? Table<TNewColumns, TNewRelations, TNewIndexes>\n    : TTables[K];\n};\n\n/**\n * Map an array of column names to a tuple of their actual column types\n */\ntype ColumnsToTuple<\n  TColumns extends Record<string, AnyColumn>,\n  TColumnNames extends readonly (keyof TColumns)[],\n> = {\n  [K in keyof TColumnNames]: TColumnNames[K] extends keyof TColumns\n    ? TColumns[TColumnNames[K]]\n    : never;\n} & AnyColumn[];\n\nexport class SchemaBuilder<TTables extends Record<string, AnyTable> = {}> {\n  #tables: TTables;\n  #version: number = 0;\n  #operations: SchemaOperation[] = [];\n\n  constructor(existingSchema?: Schema<TTables>) {\n    if (existingSchema) {\n      this.#tables = existingSchema.tables;\n      this.#version = existingSchema.version;\n      this.#operations = [...existingSchema.operations];\n    } else {\n      this.#tables = {} as TTables;\n    }\n  }\n\n  /**\n   * Add an existing schema to this builder.\n   * Merges tables and operations from the provided schema.\n   *\n   * @example\n   * ```ts\n   * const builder = new SchemaBuilder()\n   *   .add(userSchema)\n   *   .add(postSchema)\n   *   .addTable(\"comments\", ...);\n   * ```\n   */\n  mergeWithExistingSchema<TNewTables extends Record<string, AnyTable>>(\n    schema: Schema<TNewTables>,\n  ): SchemaBuilder<TTables & TNewTables> {\n    this.#tables = { ...this.#tables, ...schema.tables } as TTables & TNewTables;\n    this.#operations = [...this.#operations, ...schema.operations];\n    this.#version += schema.version;\n\n    return this as unknown as SchemaBuilder<TTables & TNewTables>;\n  }\n\n  /**\n   * Add a table to the schema. Increments the version counter.\n   */\n  addTable<\n    TTableName extends string,\n    TColumns extends Record<string, AnyColumn>,\n    TRelations extends Record<string, AnyRelation>,\n    TIndexes extends Record<string, Index> = Record<string, Index>,\n  >(\n    ormName: TTableName,\n    callback: (\n      builder: TableBuilder<\n        Record<string, AnyColumn>,\n        Record<string, AnyRelation>,\n        Record<string, Index>\n      >,\n    ) => TableBuilder<TColumns, TRelations, TIndexes>,\n  ): SchemaBuilder<TTables & Record<TTableName, Table<TColumns, TRelations, TIndexes>>> {\n    this.#version++;\n\n    const tableBuilder = new TableBuilder(ormName);\n    const result = callback(tableBuilder);\n    const builtTable = result.build();\n    builtTable.ormName = ormName;\n\n    // Collect sub-operations in order\n    const subOperations: TableSubOperation[] = [];\n\n    // Add user-defined columns first\n    const columnOrder = result.getColumnOrder();\n    for (const colName of columnOrder) {\n      const col = builtTable.columns[colName];\n      subOperations.push({\n        type: \"add-column\",\n        columnName: colName,\n        column: col,\n      });\n    }\n\n    // Add system columns (_internalId and _version) that were auto-added\n    if (builtTable.columns[\"_internalId\"]) {\n      subOperations.push({\n        type: \"add-column\",\n        columnName: \"_internalId\",\n        column: builtTable.columns[\"_internalId\"],\n      });\n    }\n    if (builtTable.columns[\"_version\"]) {\n      subOperations.push({\n        type: \"add-column\",\n        columnName: \"_version\",\n        column: builtTable.columns[\"_version\"],\n      });\n    }\n\n    // Add indexes from builder\n    for (const idx of result.getIndexes()) {\n      subOperations.push({\n        type: \"add-index\",\n        name: idx.name,\n        columns: idx.columns.map((c) => c.ormName),\n        unique: idx.unique,\n      });\n    }\n\n    // Add the add-table operation\n    this.#operations.push({\n      type: \"add-table\",\n      tableName: ormName,\n      operations: subOperations,\n    });\n\n    // Update tables map\n    this.#tables = { ...this.#tables, [ormName]: builtTable } as TTables &\n      Record<TTableName, Table<TColumns, TRelations, TIndexes>>;\n\n    return this as unknown as SchemaBuilder<\n      TTables & Record<TTableName, Table<TColumns, TRelations, TIndexes>>\n    >;\n  }\n\n  /**\n   * Add a relation between two tables.\n   *\n   * @param referenceName - A name for this relation (e.g., \"author\", \"posts\")\n   * @param config - Configuration specifying the relation type and foreign key mapping\n   *\n   * @example\n   * ```ts\n   * // One-to-one or many-to-one: post -> user\n   * schema(s => s\n   *   .addTable(\"users\", t => t.addColumn(\"id\", idColumn()))\n   *   .addTable(\"posts\", t => t\n   *     .addColumn(\"id\", idColumn())\n   *     .addColumn(\"userId\", referenceColumn()))\n   *   .addReference(\"author\", {\n   *     type: \"one\",\n   *     from: { table: \"posts\", column: \"userId\" },\n   *     to: { table: \"users\", column: \"id\" },\n   *   })\n   * )\n   *\n   * // One-to-many (inverse relation): user -> posts\n   * .addReference(\"posts\", {\n   *   type: \"many\",\n   *   from: { table: \"users\", column: \"id\" },\n   *   to: { table: \"posts\", column: \"userId\" },\n   * })\n   *\n   * // Self-referencing foreign key\n   * .addReference(\"inviter\", {\n   *   type: \"one\",\n   *   from: { table: \"users\", column: \"invitedBy\" },\n   *   to: { table: \"users\", column: \"id\" },\n   * })\n   * ```\n   */\n  addReference<\n    TFromTableName extends string & keyof TTables,\n    TToTableName extends string & keyof TTables,\n    TReferenceName extends string,\n    TRelationType extends RelationType,\n  >(\n    referenceName: TReferenceName,\n    config: {\n      type: TRelationType;\n      from: {\n        table: TFromTableName;\n        column: keyof TTables[TFromTableName][\"columns\"];\n      };\n      to: {\n        table: TToTableName;\n        column: keyof TTables[TToTableName][\"columns\"];\n      };\n    },\n  ): SchemaBuilder<\n    UpdateTableRelations<TTables, TFromTableName, TReferenceName, TToTableName, TRelationType>\n  > {\n    this.#version++;\n\n    const table = this.#tables[config.from.table];\n    const referencedTable = this.#tables[config.to.table];\n\n    if (!table) {\n      throw new Error(`Table ${config.from.table} not found in schema`);\n    }\n    if (!referencedTable) {\n      throw new Error(`Referenced table ${config.to.table} not found in schema`);\n    }\n\n    const columnName = config.from.column as string;\n    const targetColumnName = config.to.column as string;\n\n    // Foreign keys always reference internal IDs, not external IDs\n    // If user specifies \"id\", translate to \"_internalId\" for the actual FK\n    const actualTargetColumnName = targetColumnName === \"id\" ? \"_internalId\" : targetColumnName;\n\n    const column = table.columns[columnName];\n    const referencedColumn = referencedTable.columns[actualTargetColumnName];\n\n    if (!column) {\n      throw new Error(`Column ${columnName} not found in table ${config.from.table}`);\n    }\n    if (!referencedColumn) {\n      throw new Error(`Column ${actualTargetColumnName} not found in table ${config.to.table}`);\n    }\n\n    // Verify that reference columns are bigint (matching internal ID type)\n    if (column.role === \"reference\" && column.type !== \"bigint\") {\n      throw new Error(\n        `Reference column ${columnName} must be of type bigint to match internal ID type`,\n      );\n    }\n\n    // Create the relation (use the user-facing column name for the relation)\n    const init = new ExplicitRelationInit(config.type, referencedTable, table);\n    init.on.push([columnName, targetColumnName]);\n    const relation = init.init(referenceName);\n\n    // Add relation to the table\n    table.relations[referenceName] = relation;\n\n    // Record the operation\n    this.#operations.push({\n      type: \"add-reference\",\n      tableName: config.from.table,\n      referenceName,\n      config: {\n        type: config.type,\n        from: { table: config.from.table, column: columnName },\n        to: { table: config.to.table, column: actualTargetColumnName },\n      },\n    });\n\n    // Return this with updated type\n    // Safe: The relation was added to the table in place and now has the updated relations\n    return this as unknown as SchemaBuilder<\n      UpdateTableRelations<TTables, TFromTableName, TReferenceName, TToTableName, TRelationType>\n    >;\n  }\n\n  /**\n   * Alter an existing table by adding columns or indexes.\n   * This is used for append-only schema modifications.\n   *\n   * @param tableName - The name of the table to modify\n   * @param callback - A callback that receives a table builder for adding columns/indexes\n   *\n   * @example\n   * ```ts\n   * // Add a new column to an existing table\n   * schema(s => s\n   *   .addTable(\"users\", t => t\n   *     .addColumn(\"id\", idColumn())\n   *     .addColumn(\"name\", column(\"string\")))\n   *   .alterTable(\"users\", t => t\n   *     .addColumn(\"email\", column(\"string\"))\n   *     .addColumn(\"age\", column(\"integer\").nullable())\n   *     .createIndex(\"idx_email\", [\"email\"]))\n   * )\n   * ```\n   */\n  alterTable<\n    TTableName extends string & keyof TTables,\n    TNewColumns extends Record<string, AnyColumn>,\n    TNewRelations extends Record<string, AnyRelation>,\n    TNewIndexes extends Record<string, Index> = Record<string, Index>,\n  >(\n    tableName: TTableName,\n    callback: (\n      builder: TableBuilder<\n        TTables[TTableName][\"columns\"],\n        TTables[TTableName][\"relations\"],\n        Record<string, Index>\n      >,\n    ) => TableBuilder<TNewColumns, TNewRelations, TNewIndexes>,\n  ): SchemaBuilder<UpdateTable<TTables, TTableName, TNewColumns, TNewRelations, TNewIndexes>> {\n    const table = this.#tables[tableName];\n\n    if (!table) {\n      throw new Error(`Table ${tableName} not found in schema`);\n    }\n\n    // Create builder with existing table state\n    const tableBuilder = new TableBuilder(tableName);\n    tableBuilder.setColumns(table.columns);\n    tableBuilder.setRelations(table.relations);\n    tableBuilder.setIndexes(table.indexes);\n\n    // Track existing columns and indexes\n    const existingColumns = new Set(Object.keys(table.columns));\n    const existingIndexes = new Set(Object.keys(table.indexes));\n\n    // Apply modifications\n    const resultBuilder = callback(\n      tableBuilder as TableBuilder<\n        TTables[TTableName][\"columns\"],\n        TTables[TTableName][\"relations\"],\n        Record<string, Index>\n      >,\n    );\n    const newTable = resultBuilder.build();\n\n    // Collect sub-operations\n    const subOperations: TableSubOperation[] = [];\n\n    // Find new columns (preserve order from builder)\n    const columnOrder = resultBuilder.getColumnOrder();\n    for (const colName of columnOrder) {\n      if (!existingColumns.has(colName)) {\n        subOperations.push({\n          type: \"add-column\",\n          columnName: colName,\n          column: newTable.columns[colName],\n        });\n      }\n    }\n\n    // Add only new indexes\n    for (const idx of resultBuilder.getIndexes()) {\n      if (!existingIndexes.has(idx.name)) {\n        subOperations.push({\n          type: \"add-index\",\n          name: idx.name,\n          columns: idx.columns.map((c) => c.ormName),\n          unique: idx.unique,\n        });\n      }\n    }\n\n    if (subOperations.length > 0) {\n      this.#version++;\n      this.#operations.push({\n        type: \"alter-table\",\n        tableName,\n        operations: subOperations,\n      });\n    }\n\n    // Update table reference in schema\n    this.#tables[tableName] = newTable as unknown as TTables[TTableName];\n\n    // Set table name for all columns\n    for (const col of Object.values(newTable.columns)) {\n      col.tableName = newTable.name;\n    }\n\n    return this as unknown as SchemaBuilder<\n      UpdateTable<TTables, TTableName, TNewColumns, TNewRelations, TNewIndexes>\n    >;\n  }\n\n  /**\n   * Build the final schema. This should be called after all tables are added.\n   */\n  build(): Schema<TTables> {\n    const operations = this.#operations;\n    const version = this.#version;\n    const tables = this.#tables;\n\n    const schema: Schema<TTables> = {\n      version,\n      tables,\n      operations,\n      clone: () => {\n        const cloneTables: Record<string, AnyTable> = {};\n\n        for (const [k, v] of Object.entries(tables)) {\n          // Create a new table with cloned columns\n          const clonedColumns: Record<string, AnyColumn> = {};\n          for (const [colName, col] of Object.entries(v.columns)) {\n            // Create a new column with the same properties, preserving the column type\n            let clonedCol: AnyColumn;\n            if (col instanceof InternalIdColumn) {\n              clonedCol = new InternalIdColumn();\n            } else if (col instanceof VersionColumn) {\n              clonedCol = new VersionColumn();\n            } else if (col instanceof IdColumn) {\n              clonedCol = new IdColumn(col.type);\n            } else {\n              clonedCol = new Column(col.type);\n            }\n\n            clonedCol.name = col.name;\n            clonedCol.ormName = col.ormName;\n            clonedCol.isNullable = col.isNullable;\n            clonedCol.role = col.role;\n            clonedCol.isHidden = col.isHidden;\n            clonedCol.default = col.default;\n            clonedCol.tableName = col.tableName;\n            clonedColumns[colName] = clonedCol;\n          }\n\n          cloneTables[k] = {\n            ...v,\n            columns: clonedColumns,\n          };\n        }\n\n        return new SchemaBuilder<TTables>({\n          version,\n          tables: cloneTables as TTables,\n          operations: [...operations],\n          clone: () => {\n            throw new Error(\"Cannot clone during clone\");\n          },\n        }).build();\n      },\n    };\n\n    return schema;\n  }\n\n  /**\n   * Get the current version of the schema builder.\n   */\n  getVersion(): number {\n    return this.#version;\n  }\n}\n\n/**\n * Create a new schema with callback pattern.\n */\nexport function schema<const TTables extends Record<string, AnyTable> = {}>(\n  callback: (builder: SchemaBuilder<{}>) => SchemaBuilder<TTables>,\n): Schema<TTables> {\n  return callback(new SchemaBuilder()).build();\n}\n\nexport function compileForeignKey(key: ForeignKey, nameType: \"sql\" | \"orm\" = \"orm\") {\n  return {\n    name: key.name,\n    table: nameType === \"sql\" ? key.table.name : key.table.ormName,\n    referencedTable: nameType === \"sql\" ? key.referencedTable.name : key.referencedTable.ormName,\n    referencedColumns: key.referencedColumns.map((col) =>\n      nameType === \"sql\" ? col.name : col.ormName,\n    ),\n    columns: key.columns.map((col) => (nameType === \"sql\" ? col.name : col.ormName)),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"create.js","names":["defaultBuilder: DefaultBuilder","runtimeDefaultBuilder: RuntimeDefaultBuilder","#externalId","#internalId","#version","#name","#columns","#relations","#indexes","#columnOrder","column","idCol: AnyColumn | undefined","internalIdCol: AnyColumn | undefined","versionCol: AnyColumn | undefined","#ormName","table: Table<TColumns, TRelations, TIndexes>","#tables","#operations","schema","subOperations: TableSubOperation[]","cloneTables: Record<string, AnyTable>","clonedColumns: Record<string, AnyColumn>","clonedCol: AnyColumn"],"sources":["../../src/schema/create.ts"],"sourcesContent":["import { createId } from \"../id\";\n\nexport { generateId } from \"./generate-id\";\n\nexport type AnySchema = Schema<Record<string, AnyTable>>;\n\nexport type AnyRelation = Relation;\n\nexport type AnyTable = Table;\n\nexport type AnyColumn =\n  | Column<keyof TypeMap, unknown, unknown>\n  | IdColumn<IdColumnType, unknown, unknown>\n  | InternalIdColumn<unknown, unknown>\n  | VersionColumn<unknown, unknown>;\n/**\n * Sub-operations that can be performed within table operations.\n * These are stored in order within add-table and alter-table operations.\n */\nexport type TableSubOperation =\n  | { type: \"add-column\"; columnName: string; column: AnyColumn }\n  | { type: \"add-index\"; name: string; columns: string[]; unique: boolean }\n  | {\n      type: \"add-foreign-key\";\n      name: string;\n      columns: string[];\n      referencedTable: string;\n      referencedColumns: string[];\n    };\n\n/**\n * Operations that can be performed on a schema during its definition.\n * These are tracked so we can generate migrations for specific version ranges.\n */\nexport type SchemaOperation =\n  | {\n      type: \"add-table\";\n      tableName: string;\n      operations: TableSubOperation[]; // Ordered list of sub-operations\n    }\n  | {\n      type: \"alter-table\";\n      tableName: string;\n      operations: TableSubOperation[]; // Ordered list of sub-operations\n    }\n  | {\n      type: \"add-reference\";\n      tableName: string; // The table that has the foreign key\n      referenceName: string;\n      config: {\n        type: \"one\" | \"many\";\n        from: { table: string; column: string };\n        to: { table: string; column: string };\n      };\n    };\n\nexport interface ForeignKey {\n  name: string;\n  table: AnyTable;\n  columns: AnyColumn[];\n\n  referencedTable: AnyTable;\n  referencedColumns: AnyColumn[];\n}\n\nclass RelationInit<\n  TRelationType extends RelationType,\n  TTables extends Record<string, AnyTable>,\n  TTableName extends keyof TTables,\n> {\n  type: TRelationType;\n  referencedTable: TTables[TTableName];\n  referencer: AnyTable;\n  on: [string, string][] = [];\n\n  constructor(type: TRelationType, referencedTable: TTables[TTableName], referencer: AnyTable) {\n    this.type = type;\n    this.referencedTable = referencedTable;\n    this.referencer = referencer;\n  }\n}\n\nexport interface Index<\n  TColumns extends AnyColumn[] = AnyColumn[],\n  TColumnNames extends readonly string[] = readonly string[],\n> {\n  name: string;\n  columns: TColumns;\n  columnNames: TColumnNames;\n  unique: boolean;\n}\n\nexport class ExplicitRelationInit<\n  TRelationType extends RelationType,\n  TTables extends Record<string, AnyTable>,\n  TTableName extends keyof TTables,\n> extends RelationInit<TRelationType, TTables, TTableName> {\n  init(ormName: string): Relation<TRelationType, TTables[TTableName]> {\n    const id = `${this.referencer.ormName}_${this.referencedTable.ormName}`;\n\n    return {\n      id,\n      on: this.on,\n      name: ormName,\n      referencer: this.referencer,\n      table: this.referencedTable,\n      type: this.type,\n    };\n  }\n}\n\nexport interface Relation<\n  TRelationType extends RelationType = RelationType,\n  TTable extends AnyTable = AnyTable,\n> {\n  id: string;\n  name: string;\n  type: TRelationType;\n\n  table: TTable;\n  referencer: AnyTable;\n\n  on: [string, string][];\n}\n\nexport interface Table<\n  TColumns extends Record<string, AnyColumn> = Record<string, AnyColumn>,\n  TRelations extends Record<string, AnyRelation> = Record<string, AnyRelation>,\n  TIndexes extends Record<string, Index> = Record<string, Index>,\n> {\n  name: string;\n  ormName: string;\n\n  columns: TColumns;\n  relations: TRelations;\n  indexes: TIndexes;\n\n  /**\n   * Get column by name\n   */\n  getColumnByName: (name: string) => AnyColumn | undefined;\n  /**\n   * Get the external ID column (user-facing)\n   */\n  getIdColumn: () => AnyColumn;\n  /**\n   * Get the internal ID column (database-native, used for joins)\n   */\n  getInternalIdColumn: () => AnyColumn;\n  /**\n   * Get the version column (for optimistic concurrency control)\n   */\n  getVersionColumn: () => AnyColumn;\n}\n\ntype DBSpecial = { tag: \"special\"; value: \"now\" };\ntype RuntimeSpecial = { tag: \"special\"; value: \"cuid\" | \"now\" };\n\n/**\n * Builder for database-level default values.\n */\nexport interface DefaultBuilder {\n  /** Database-generated timestamp (DEFAULT NOW()) */\n  now(): DBSpecial;\n}\n\n/**\n * Builder for runtime-generated default values.\n */\nexport interface RuntimeDefaultBuilder {\n  /** Generate CUID identifier */\n  cuid(): RuntimeSpecial;\n  /** Generate current timestamp */\n  now(): RuntimeSpecial;\n}\n\nconst defaultBuilder: DefaultBuilder = {\n  now: () => ({ tag: \"special\", value: \"now\" }),\n};\n\nconst runtimeDefaultBuilder: RuntimeDefaultBuilder = {\n  cuid: () => ({ tag: \"special\", value: \"cuid\" }),\n  now: () => ({ tag: \"special\", value: \"now\" }),\n};\n\ntype IdColumnType = `varchar(${number})`;\n\nexport type TypeMap = {\n  string: string;\n  bigint: bigint;\n  integer: number;\n  decimal: number;\n  bool: boolean;\n  json: unknown;\n  /**\n   * this follows the same specs as Prisma `Bytes` for consistency.\n   */\n  binary: Uint8Array;\n  date: Date;\n  timestamp: Date;\n} & Record<`varchar(${number})`, string>;\n\nexport class Column<TType extends keyof TypeMap, TIn = unknown, TOut = unknown> {\n  type: TType;\n  name: string = \"\";\n  ormName: string = \"\";\n  isNullable: boolean = false;\n  role: \"external-id\" | \"internal-id\" | \"version\" | \"reference\" | \"regular\" = \"regular\";\n  isHidden: boolean = false;\n\n  default?:\n    | { value: TypeMap[TType] }\n    | { dbSpecial: \"now\" }\n    | { runtime: \"cuid\" | \"now\" | (() => TypeMap[TType]) };\n\n  tableName: string = \"\";\n\n  constructor(type: TType) {\n    this.type = type;\n  }\n\n  nullable<TNullable extends boolean = true>(nullable?: TNullable) {\n    this.isNullable = nullable ?? true;\n\n    return this as Column<\n      TType,\n      TNullable extends true ? TIn | null : Exclude<TIn, null>,\n      TNullable extends true ? TOut | null : Exclude<TOut, null>\n    >;\n  }\n\n  hidden<THidden extends boolean = true>(hidden?: THidden) {\n    this.isHidden = hidden ?? true;\n    return this as Column<TType, null, null>;\n  }\n\n  /**\n   * Generate default value at runtime in application code (not in the database).\n   *\n   * Use this when you need values generated in your application code, either because:\n   * - Your database doesn't support the operation (e.g., generating CUIDs)\n   * - You want consistent behavior across all databases\n   * - You need custom generation logic\n   *\n   * @param value - Either a literal value or builder callback:\n   *   - Literal: Any static value of the column type\n   *   - `(b) => b.cuid()` - Generate a CUID identifier\n   *   - `(b) => b.now()` - Generate current timestamp\n   *   - `(b) => ...` - Custom function that returns the default value\n   *\n   * @example\n   * ```ts\n   * column(\"string\").defaultTo$((b) => b.cuid())           // Generate CUID at runtime\n   * column(\"timestamp\").defaultTo$((b) => b.now())         // Generate timestamp at runtime\n   * column(\"integer\").defaultTo$(42)                       // Static literal\n   * column(\"integer\").defaultTo$((b) => Math.floor(Math.random() * 100))  // Custom function\n   * ```\n   */\n  defaultTo$(\n    value: TypeMap[TType] | ((builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType]),\n  ): Column<TType, TIn | null, TOut> {\n    if (typeof value === \"function\") {\n      const fn = value as (builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType];\n      const result = fn(runtimeDefaultBuilder);\n      if (\n        typeof result === \"object\" &&\n        result !== null &&\n        \"tag\" in result &&\n        result.tag === \"special\"\n      ) {\n        this.default = { runtime: result.value };\n      } else {\n        // Custom function - we need to wrap the callback to call it again later\n        this.default = { runtime: () => fn(runtimeDefaultBuilder) as TypeMap[TType] };\n      }\n    } else {\n      // Direct literal value - wrap it in a function for runtime generation\n      this.default = { runtime: () => value };\n    }\n    return this;\n  }\n\n  /**\n   * Set a database-level default value (generated by the database, not application code).\n   *\n   * The database will generate the default value when inserting rows. If the database\n   * doesn't support the operation, Fragno will fall back to generating the value in\n   * application code.\n   *\n   * @param value - Either a literal value or builder callback:\n   *   - Literal: Any static value of the column type\n   *   - `(b) => b.now()` - Database-generated timestamp\n   *\n   * @example\n   * ```ts\n   * // Static defaults\n   * column(\"string\").defaultTo(\"active\")\n   * column(\"integer\").defaultTo(0)\n   * column(\"boolean\").defaultTo(true)\n   *\n   * // Database-generated timestamp (with fallback)\n   * column(\"timestamp\").defaultTo((b) => b.now())\n   * ```\n   */\n  defaultTo(\n    value: TypeMap[TType] | ((builder: DefaultBuilder) => DBSpecial | TypeMap[TType]),\n  ): Column<TType, TIn | null, TOut> {\n    if (typeof value === \"function\") {\n      const fn = value as (builder: DefaultBuilder) => DBSpecial | TypeMap[TType];\n      const result = fn(defaultBuilder);\n      if (\n        typeof result === \"object\" &&\n        result !== null &&\n        \"tag\" in result &&\n        result.tag === \"special\"\n      ) {\n        this.default = { dbSpecial: result.value };\n      } else {\n        this.default = { value: result as TypeMap[TType] };\n      }\n    } else {\n      this.default = { value };\n    }\n    return this;\n  }\n\n  /**\n   * Generate default value for the column at runtime.\n   * Used for both runtime defaults (defaultTo$) and fallback generation for\n   * database defaults (defaultTo) when the database doesn't support them.\n   */\n  generateDefaultValue(): TypeMap[TType] | undefined {\n    if (!this.default) {\n      return;\n    }\n\n    if (\"value\" in this.default) {\n      return this.default.value;\n    }\n\n    if (\"dbSpecial\" in this.default) {\n      // Fallback generation for database-level special functions\n      if (this.default.dbSpecial === \"now\") {\n        return new Date(Date.now()) as TypeMap[TType];\n      }\n      return;\n    }\n\n    // Runtime defaults (defaultTo$)\n    if (this.default.runtime === \"cuid\") {\n      return createId() as TypeMap[TType];\n    }\n    if (this.default.runtime === \"now\") {\n      return new Date(Date.now()) as TypeMap[TType];\n    }\n\n    // Custom function\n    return this.default.runtime();\n  }\n\n  /**\n   * @description This is used for type inference only. Runtime value will be undefined.\n   * @internal\n   */\n  get $in(): TIn {\n    return undefined as unknown as TIn;\n  }\n\n  /**\n   * @description This is used for type inference only. Runtime value will be undefined.\n   * @internal\n   */\n  get $out(): TOut {\n    return undefined as unknown as TOut;\n  }\n}\n\nexport class IdColumn<\n  TType extends IdColumnType = IdColumnType,\n  TIn = unknown,\n  TOut = unknown,\n> extends Column<TType, TIn, TOut> {\n  id = true;\n\n  override defaultTo$(\n    value: TypeMap[TType] | ((builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType]),\n  ) {\n    return super.defaultTo$(value) as IdColumn<TType, TIn | null, TOut>;\n  }\n\n  override defaultTo(\n    value: TypeMap[TType] | ((builder: DefaultBuilder) => DBSpecial | TypeMap[TType]),\n  ) {\n    return super.defaultTo(value) as IdColumn<TType, TIn | null, TOut>;\n  }\n}\n\n/**\n * Internal ID column - used for database-native joins and foreign keys.\n * Hidden from user API by default.\n */\nexport class InternalIdColumn<TIn = unknown, TOut = unknown> extends Column<\"bigint\", TIn, TOut> {\n  override role = \"internal-id\" as const;\n\n  constructor() {\n    super(\"bigint\");\n    this.hidden();\n  }\n}\n\n/**\n * Version column - used for optimistic concurrency control.\n * Automatically incremented on each update.\n */\nexport class VersionColumn<TIn = unknown, TOut = unknown> extends Column<\"integer\", TIn, TOut> {\n  override role = \"version\" as const;\n\n  constructor() {\n    super(\"integer\");\n    this.defaultTo(0).hidden();\n  }\n}\n\nexport function column<TType extends keyof TypeMap>(\n  type: TType,\n): Column<TType, TypeMap[TType], TypeMap[TType]> {\n  return new Column(type);\n}\n\n/**\n * Create a reference column that points to another table's internal ID.\n * This is used for foreign key relationships.\n * Always uses bigint to match the internal ID type.\n */\nexport function referenceColumn(): Column<\n  \"bigint\",\n  string | bigint | FragnoId | FragnoReference,\n  FragnoReference\n> {\n  const col = new Column<\"bigint\", string | bigint | FragnoId | FragnoReference, FragnoReference>(\n    \"bigint\",\n  );\n  col.role = \"reference\";\n  return col;\n}\n\n/**\n * Create an external ID column (user-facing).\n * This is a CUID string that can be auto-generated or user-provided.\n * Input accepts string | FragnoId | null, output returns FragnoId.\n */\nexport function idColumn(): IdColumn<\"varchar(30)\", string | FragnoId | null, FragnoId> {\n  const col = new IdColumn<\"varchar(30)\", string | FragnoId | null, FragnoId>(\"varchar(30)\");\n  col.role = \"external-id\";\n  col.defaultTo$((b) => b.cuid());\n  return col;\n}\n\n/**\n * Create an internal ID column (database-native, hidden from user API).\n * Used for joins and foreign keys.\n * @internal\n */\nexport function internalIdColumn(): InternalIdColumn<null, bigint> {\n  const col = new InternalIdColumn<null, bigint>();\n  col.role = \"internal-id\";\n  col.hidden();\n  return col;\n}\n\n/**\n * Create a version column for optimistic concurrency control.\n * @internal\n */\nexport function versionColumn(): VersionColumn<null, number> {\n  const col = new VersionColumn<null, number>();\n  col.role = \"version\";\n  col.hidden();\n  return col;\n}\n\n/**\n * FragnoId represents a unified ID object that can contain external ID, internal ID, or both.\n * @internal\n *\n * For query inputs: externalId is sufficient (internalId is optional)\n * For query results: both externalId and internalId are provided\n */\nexport class FragnoId {\n  readonly #externalId: string;\n  readonly #internalId?: bigint;\n  readonly #version: number;\n\n  constructor({\n    externalId,\n    internalId,\n    version,\n  }: {\n    externalId: string;\n    internalId?: bigint;\n    version: number;\n  }) {\n    this.#externalId = externalId;\n    this.#internalId = internalId;\n    this.#version = version;\n  }\n\n  /**\n   * Create a FragnoId from just an external ID (for inputs)\n   */\n  static fromExternal(externalId: string, version: number): FragnoId {\n    return new FragnoId({ externalId, version });\n  }\n\n  get version(): number {\n    return this.#version;\n  }\n\n  get externalId(): string {\n    return this.#externalId;\n  }\n\n  get internalId(): bigint | undefined {\n    return this.#internalId;\n  }\n\n  /**\n   * Get the appropriate ID for database operations\n   * Prefers internal ID if available, falls back to external ID\n   */\n  get databaseId(): string | bigint {\n    return this.#internalId ?? this.#externalId;\n  }\n\n  /**\n   * Convert to a plain object for serialization\n   */\n  toJSON(): { externalId: string; internalId?: string } {\n    return {\n      externalId: this.#externalId,\n      internalId: this.#internalId?.toString(),\n    };\n  }\n\n  toString(): string {\n    return this.#externalId;\n  }\n\n  valueOf(): string {\n    return this.#externalId;\n  }\n}\n\n/**\n * FragnoReference represents a foreign key reference to another table's internal ID.\n * Unlike FragnoId, it only contains the internal ID (bigint) of the referenced record.\n * This is used for reference columns in query results.\n * @internal\n */\nexport class FragnoReference {\n  readonly #internalId: bigint;\n\n  constructor(internalId: bigint) {\n    this.#internalId = internalId;\n  }\n\n  /**\n   * Create a FragnoReference from an internal ID\n   */\n  static fromInternal(internalId: bigint): FragnoReference {\n    return new FragnoReference(internalId);\n  }\n\n  /**\n   * Get the internal ID for database operations\n   */\n  get internalId(): bigint {\n    return this.#internalId;\n  }\n}\n\ntype RelationType = \"one\" | \"many\";\n\nexport class TableBuilder<\n  TColumns extends Record<string, AnyColumn> = Record<string, AnyColumn>,\n  TRelations extends Record<string, AnyRelation> = Record<string, AnyRelation>,\n  TIndexes extends Record<string, Index> = Record<string, Index>,\n> {\n  #name: string;\n  #columns: TColumns;\n  #relations: TRelations;\n  #indexes: TIndexes;\n  #ormName: string = \"\";\n  #columnOrder: string[] = [];\n\n  constructor(name: string) {\n    this.#name = name;\n    this.#columns = {} as TColumns;\n    this.#relations = {} as TRelations;\n    this.#indexes = {} as TIndexes;\n  }\n\n  // For alterTable to set existing state\n  setColumns(columns: TColumns): void {\n    this.#columns = { ...columns };\n  }\n\n  setRelations(relations: TRelations): void {\n    this.#relations = { ...relations };\n  }\n\n  setIndexes(indexes: TIndexes): void {\n    this.#indexes = { ...indexes };\n  }\n\n  // For SchemaBuilder to read collected indexes\n  getIndexes(): Index[] {\n    return Object.values(this.#indexes) as Index[];\n  }\n\n  getColumnOrder(): string[] {\n    return this.#columnOrder;\n  }\n\n  /**\n   * Add a column to the table.\n   */\n  addColumn<TColumnName extends string, TColumn extends AnyColumn>(\n    ormName: TColumnName,\n    col: TColumn,\n  ): TableBuilder<TColumns & Record<TColumnName, TColumn>, TRelations, TIndexes>;\n\n  /**\n   * Add a column to the table with simplified syntax.\n   */\n  addColumn<TColumnName extends string, TType extends keyof TypeMap>(\n    ormName: TColumnName,\n    type: TType,\n  ): TableBuilder<\n    TColumns & Record<TColumnName, Column<TType, TypeMap[TType], TypeMap[TType]>>,\n    TRelations,\n    TIndexes\n  >;\n\n  addColumn<TColumnName extends string, TColumn extends AnyColumn, TType extends keyof TypeMap>(\n    ormName: TColumnName,\n    colOrType: TColumn | TType,\n  ): TableBuilder<TColumns & Record<TColumnName, TColumn>, TRelations, TIndexes> {\n    // Create the column if a type string was provided\n    const col = typeof colOrType === \"string\" ? column(colOrType) : colOrType;\n\n    // Set column metadata\n    col.ormName = ormName;\n    col.name = ormName;\n\n    // Add column directly to this builder\n    this.#columns[ormName] = col as unknown as TColumns[TColumnName];\n    this.#columnOrder.push(ormName);\n\n    return this as unknown as TableBuilder<\n      TColumns & Record<TColumnName, TColumn>,\n      TRelations,\n      TIndexes\n    >;\n  }\n\n  /**\n   * Create an index on the specified columns.\n   */\n  createIndex<\n    TIndexName extends string,\n    const TColumnNames extends readonly (string & keyof TColumns)[],\n  >(\n    name: TIndexName,\n    columns: TColumnNames,\n    options?: { unique?: boolean },\n  ): TableBuilder<\n    TColumns,\n    TRelations,\n    TIndexes & Record<TIndexName, Index<ColumnsToTuple<TColumns, TColumnNames>, TColumnNames>>\n  > {\n    const cols = columns.map((colName) => {\n      const column = this.#columns[colName];\n      if (!column) {\n        throw new Error(`Unknown column name ${colName}`);\n      }\n      return column;\n    });\n\n    const unique = options?.unique ?? false;\n    // Safe: we're adding the index to the internal indexes object\n    this.#indexes[name] = {\n      name,\n      columns: cols,\n      columnNames: columns,\n      unique,\n    } as unknown as TIndexes[TIndexName];\n\n    return this as unknown as TableBuilder<\n      TColumns,\n      TRelations,\n      TIndexes & Record<TIndexName, Index<ColumnsToTuple<TColumns, TColumnNames>, TColumnNames>>\n    >;\n  }\n\n  /**\n   * Build the final table. This should be called after all columns are added.\n   */\n  build(): Table<TColumns, TRelations, TIndexes> {\n    let idCol: AnyColumn | undefined;\n    let internalIdCol: AnyColumn | undefined;\n    let versionCol: AnyColumn | undefined;\n\n    // TODO: Throw if user manually added version/internalId columns\n\n    // Auto-add _internalId and _version columns if not already present\n    if (!this.#columns[\"_internalId\"]) {\n      const col = internalIdColumn();\n      col.ormName = \"_internalId\";\n      col.name = \"_internalId\";\n      // Safe: we're adding system columns to the internal columns object\n      (this.#columns as Record<string, AnyColumn>)[\"_internalId\"] = col;\n    }\n\n    if (!this.#columns[\"_version\"]) {\n      const col = versionColumn();\n      col.ormName = \"_version\";\n      col.name = \"_version\";\n      // Safe: we're adding system columns to the internal columns object\n      (this.#columns as Record<string, AnyColumn>)[\"_version\"] = col;\n    }\n\n    // Use name as ormName if ormName is not set\n    const ormName = this.#ormName || this.#name;\n\n    const table: Table<TColumns, TRelations, TIndexes> = {\n      name: this.#name,\n      ormName,\n      columns: this.#columns,\n      relations: this.#relations,\n      indexes: this.#indexes,\n      getColumnByName: (name) => {\n        return Object.values(this.#columns).find((c) => c.name === name);\n      },\n      getIdColumn: () => {\n        return idCol!;\n      },\n      getInternalIdColumn: () => {\n        return internalIdCol!;\n      },\n      getVersionColumn: () => {\n        return versionCol!;\n      },\n    };\n\n    // Set table reference and find special columns\n    for (const k in this.#columns) {\n      const column = this.#columns[k];\n      if (!column) {\n        continue;\n      }\n\n      column.tableName = table.name;\n      if (column instanceof IdColumn || column.role === \"external-id\") {\n        idCol = column;\n      }\n      if (column instanceof InternalIdColumn || column.role === \"internal-id\") {\n        internalIdCol = column;\n      }\n      if (column instanceof VersionColumn || column.role === \"version\") {\n        versionCol = column;\n      }\n    }\n\n    if (idCol === undefined) {\n      throw new Error(`there's no id column in your table ${this.#name}`);\n    }\n    if (internalIdCol === undefined) {\n      throw new Error(`there's no internal id column in your table ${this.#name}`);\n    }\n    if (versionCol === undefined) {\n      throw new Error(`there's no version column in your table ${this.#name}`);\n    }\n\n    return table;\n  }\n}\n\nexport interface Schema<TTables extends Record<string, AnyTable> = Record<string, AnyTable>> {\n  /**\n   * @description The version of the schema, automatically incremented on each change.\n   */\n  version: number;\n  tables: TTables;\n  /**\n   * @description Operations performed on this schema, in order.\n   * Used to generate migrations for specific version ranges.\n   */\n  operations: SchemaOperation[];\n\n  clone: () => Schema<TTables>;\n}\n\n/**\n * Utility type for updating a single table's relations in a schema.\n * Used to properly type the return value of addReference.\n */\ntype UpdateTableRelations<\n  TTables extends Record<string, AnyTable>,\n  TTableName extends keyof TTables,\n  TReferenceName extends string,\n  TReferencedTableName extends keyof TTables,\n  TRelationType extends RelationType = RelationType,\n> = {\n  [K in keyof TTables]: K extends TTableName\n    ? Table<\n        TTables[TTableName][\"columns\"],\n        TTables[TTableName][\"relations\"] &\n          Record<TReferenceName, Relation<TRelationType, TTables[TReferencedTableName]>>,\n        TTables[TTableName][\"indexes\"]\n      >\n    : TTables[K];\n};\n\n/**\n * Utility type for updating a single table in a schema.\n * Used to properly type the return value of alterTable.\n */\ntype UpdateTable<\n  TTables extends Record<string, AnyTable>,\n  TTableName extends keyof TTables,\n  TNewColumns extends Record<string, AnyColumn>,\n  TNewRelations extends Record<string, AnyRelation>,\n  TNewIndexes extends Record<string, Index>,\n> = {\n  [K in keyof TTables]: K extends TTableName\n    ? Table<TNewColumns, TNewRelations, TNewIndexes>\n    : TTables[K];\n};\n\n/**\n * Map an array of column names to a tuple of their actual column types\n */\ntype ColumnsToTuple<\n  TColumns extends Record<string, AnyColumn>,\n  TColumnNames extends readonly (keyof TColumns)[],\n> = {\n  [K in keyof TColumnNames]: TColumnNames[K] extends keyof TColumns\n    ? TColumns[TColumnNames[K]]\n    : never;\n} & AnyColumn[];\n\nexport class SchemaBuilder<TTables extends Record<string, AnyTable> = {}> {\n  #tables: TTables;\n  #version: number = 0;\n  #operations: SchemaOperation[] = [];\n\n  constructor(existingSchema?: Schema<TTables>) {\n    if (existingSchema) {\n      this.#tables = existingSchema.tables;\n      this.#version = existingSchema.version;\n      this.#operations = [...existingSchema.operations];\n    } else {\n      this.#tables = {} as TTables;\n    }\n  }\n\n  /**\n   * Add an existing schema to this builder.\n   * Merges tables and operations from the provided schema.\n   *\n   * @example\n   * ```ts\n   * const builder = new SchemaBuilder()\n   *   .add(userSchema)\n   *   .add(postSchema)\n   *   .addTable(\"comments\", ...);\n   * ```\n   */\n  mergeWithExistingSchema<TNewTables extends Record<string, AnyTable>>(\n    schema: Schema<TNewTables>,\n  ): SchemaBuilder<TTables & TNewTables> {\n    this.#tables = { ...this.#tables, ...schema.tables } as TTables & TNewTables;\n    this.#operations = [...this.#operations, ...schema.operations];\n    this.#version += schema.version;\n\n    return this as unknown as SchemaBuilder<TTables & TNewTables>;\n  }\n\n  /**\n   * Add a table to the schema. Increments the version counter.\n   */\n  addTable<\n    TTableName extends string,\n    TColumns extends Record<string, AnyColumn>,\n    TRelations extends Record<string, AnyRelation>,\n    TIndexes extends Record<string, Index> = Record<string, Index>,\n  >(\n    ormName: TTableName,\n    callback: (\n      builder: TableBuilder<\n        Record<string, AnyColumn>,\n        Record<string, AnyRelation>,\n        Record<string, Index>\n      >,\n    ) => TableBuilder<TColumns, TRelations, TIndexes>,\n  ): SchemaBuilder<TTables & Record<TTableName, Table<TColumns, TRelations, TIndexes>>> {\n    this.#version++;\n\n    const tableBuilder = new TableBuilder(ormName);\n    const result = callback(tableBuilder);\n    const builtTable = result.build();\n    builtTable.ormName = ormName;\n\n    // Collect sub-operations in order\n    const subOperations: TableSubOperation[] = [];\n\n    // Add user-defined columns first\n    const columnOrder = result.getColumnOrder();\n    for (const colName of columnOrder) {\n      const col = builtTable.columns[colName];\n      subOperations.push({\n        type: \"add-column\",\n        columnName: colName,\n        column: col,\n      });\n    }\n\n    // Add system columns (_internalId and _version) that were auto-added\n    if (builtTable.columns[\"_internalId\"]) {\n      subOperations.push({\n        type: \"add-column\",\n        columnName: \"_internalId\",\n        column: builtTable.columns[\"_internalId\"],\n      });\n    }\n    if (builtTable.columns[\"_version\"]) {\n      subOperations.push({\n        type: \"add-column\",\n        columnName: \"_version\",\n        column: builtTable.columns[\"_version\"],\n      });\n    }\n\n    // Add indexes from builder\n    for (const idx of result.getIndexes()) {\n      subOperations.push({\n        type: \"add-index\",\n        name: idx.name,\n        columns: idx.columns.map((c) => c.ormName),\n        unique: idx.unique,\n      });\n    }\n\n    // Add the add-table operation\n    this.#operations.push({\n      type: \"add-table\",\n      tableName: ormName,\n      operations: subOperations,\n    });\n\n    // Update tables map\n    this.#tables = { ...this.#tables, [ormName]: builtTable } as TTables &\n      Record<TTableName, Table<TColumns, TRelations, TIndexes>>;\n\n    return this as unknown as SchemaBuilder<\n      TTables & Record<TTableName, Table<TColumns, TRelations, TIndexes>>\n    >;\n  }\n\n  /**\n   * Add a relation between two tables.\n   *\n   * @param referenceName - A name for this relation (e.g., \"author\", \"posts\")\n   * @param config - Configuration specifying the relation type and foreign key mapping\n   *\n   * @example\n   * ```ts\n   * // One-to-one or many-to-one: post -> user\n   * schema(s => s\n   *   .addTable(\"users\", t => t.addColumn(\"id\", idColumn()))\n   *   .addTable(\"posts\", t => t\n   *     .addColumn(\"id\", idColumn())\n   *     .addColumn(\"userId\", referenceColumn()))\n   *   .addReference(\"author\", {\n   *     type: \"one\",\n   *     from: { table: \"posts\", column: \"userId\" },\n   *     to: { table: \"users\", column: \"id\" },\n   *   })\n   * )\n   *\n   * // One-to-many (inverse relation): user -> posts\n   * .addReference(\"posts\", {\n   *   type: \"many\",\n   *   from: { table: \"users\", column: \"id\" },\n   *   to: { table: \"posts\", column: \"userId\" },\n   * })\n   *\n   * // Self-referencing foreign key\n   * .addReference(\"inviter\", {\n   *   type: \"one\",\n   *   from: { table: \"users\", column: \"invitedBy\" },\n   *   to: { table: \"users\", column: \"id\" },\n   * })\n   * ```\n   */\n  addReference<\n    TFromTableName extends string & keyof TTables,\n    TToTableName extends string & keyof TTables,\n    TReferenceName extends string,\n    TRelationType extends RelationType,\n  >(\n    referenceName: TReferenceName,\n    config: {\n      type: TRelationType;\n      from: {\n        table: TFromTableName;\n        column: keyof TTables[TFromTableName][\"columns\"];\n      };\n      to: {\n        table: TToTableName;\n        column: keyof TTables[TToTableName][\"columns\"];\n      };\n    },\n  ): SchemaBuilder<\n    UpdateTableRelations<TTables, TFromTableName, TReferenceName, TToTableName, TRelationType>\n  > {\n    this.#version++;\n\n    const table = this.#tables[config.from.table];\n    const referencedTable = this.#tables[config.to.table];\n\n    if (!table) {\n      throw new Error(`Table ${config.from.table} not found in schema`);\n    }\n    if (!referencedTable) {\n      throw new Error(`Referenced table ${config.to.table} not found in schema`);\n    }\n\n    const columnName = config.from.column as string;\n    const targetColumnName = config.to.column as string;\n\n    // Foreign keys always reference internal IDs, not external IDs\n    // If user specifies \"id\", translate to \"_internalId\" for the actual FK\n    const actualTargetColumnName = targetColumnName === \"id\" ? \"_internalId\" : targetColumnName;\n\n    const column = table.columns[columnName];\n    const referencedColumn = referencedTable.columns[actualTargetColumnName];\n\n    if (!column) {\n      throw new Error(`Column ${columnName} not found in table ${config.from.table}`);\n    }\n    if (!referencedColumn) {\n      throw new Error(`Column ${actualTargetColumnName} not found in table ${config.to.table}`);\n    }\n\n    // Verify that reference columns are bigint (matching internal ID type)\n    if (column.role === \"reference\" && column.type !== \"bigint\") {\n      throw new Error(\n        `Reference column ${columnName} must be of type bigint to match internal ID type`,\n      );\n    }\n\n    // Create the relation (use the user-facing column name for the relation)\n    const init = new ExplicitRelationInit(config.type, referencedTable, table);\n    init.on.push([columnName, targetColumnName]);\n    const relation = init.init(referenceName);\n\n    // Add relation to the table\n    table.relations[referenceName] = relation;\n\n    // Record the operation\n    this.#operations.push({\n      type: \"add-reference\",\n      tableName: config.from.table,\n      referenceName,\n      config: {\n        type: config.type,\n        from: { table: config.from.table, column: columnName },\n        to: { table: config.to.table, column: actualTargetColumnName },\n      },\n    });\n\n    // Return this with updated type\n    // Safe: The relation was added to the table in place and now has the updated relations\n    return this as unknown as SchemaBuilder<\n      UpdateTableRelations<TTables, TFromTableName, TReferenceName, TToTableName, TRelationType>\n    >;\n  }\n\n  /**\n   * Alter an existing table by adding columns or indexes.\n   * This is used for append-only schema modifications.\n   *\n   * @param tableName - The name of the table to modify\n   * @param callback - A callback that receives a table builder for adding columns/indexes\n   *\n   * @example\n   * ```ts\n   * // Add a new column to an existing table\n   * schema(s => s\n   *   .addTable(\"users\", t => t\n   *     .addColumn(\"id\", idColumn())\n   *     .addColumn(\"name\", column(\"string\")))\n   *   .alterTable(\"users\", t => t\n   *     .addColumn(\"email\", column(\"string\"))\n   *     .addColumn(\"age\", column(\"integer\").nullable())\n   *     .createIndex(\"idx_email\", [\"email\"]))\n   * )\n   * ```\n   */\n  alterTable<\n    TTableName extends string & keyof TTables,\n    TNewColumns extends Record<string, AnyColumn>,\n    TNewRelations extends Record<string, AnyRelation>,\n    TNewIndexes extends Record<string, Index> = Record<string, Index>,\n  >(\n    tableName: TTableName,\n    callback: (\n      builder: TableBuilder<\n        TTables[TTableName][\"columns\"],\n        TTables[TTableName][\"relations\"],\n        Record<string, Index>\n      >,\n    ) => TableBuilder<TNewColumns, TNewRelations, TNewIndexes>,\n  ): SchemaBuilder<UpdateTable<TTables, TTableName, TNewColumns, TNewRelations, TNewIndexes>> {\n    const table = this.#tables[tableName];\n\n    if (!table) {\n      throw new Error(`Table ${tableName} not found in schema`);\n    }\n\n    // Create builder with existing table state\n    const tableBuilder = new TableBuilder(tableName);\n    tableBuilder.setColumns(table.columns);\n    tableBuilder.setRelations(table.relations);\n    tableBuilder.setIndexes(table.indexes);\n\n    // Track existing columns and indexes\n    const existingColumns = new Set(Object.keys(table.columns));\n    const existingIndexes = new Set(Object.keys(table.indexes));\n\n    // Apply modifications\n    const resultBuilder = callback(\n      tableBuilder as TableBuilder<\n        TTables[TTableName][\"columns\"],\n        TTables[TTableName][\"relations\"],\n        Record<string, Index>\n      >,\n    );\n    const newTable = resultBuilder.build();\n\n    // Collect sub-operations\n    const subOperations: TableSubOperation[] = [];\n\n    // Find new columns (preserve order from builder)\n    const columnOrder = resultBuilder.getColumnOrder();\n    for (const colName of columnOrder) {\n      if (!existingColumns.has(colName)) {\n        subOperations.push({\n          type: \"add-column\",\n          columnName: colName,\n          column: newTable.columns[colName],\n        });\n      }\n    }\n\n    // Add only new indexes\n    for (const idx of resultBuilder.getIndexes()) {\n      if (!existingIndexes.has(idx.name)) {\n        subOperations.push({\n          type: \"add-index\",\n          name: idx.name,\n          columns: idx.columns.map((c) => c.ormName),\n          unique: idx.unique,\n        });\n      }\n    }\n\n    if (subOperations.length > 0) {\n      this.#version++;\n      this.#operations.push({\n        type: \"alter-table\",\n        tableName,\n        operations: subOperations,\n      });\n    }\n\n    // Update table reference in schema\n    this.#tables[tableName] = newTable as unknown as TTables[TTableName];\n\n    // Set table name for all columns\n    for (const col of Object.values(newTable.columns)) {\n      col.tableName = newTable.name;\n    }\n\n    return this as unknown as SchemaBuilder<\n      UpdateTable<TTables, TTableName, TNewColumns, TNewRelations, TNewIndexes>\n    >;\n  }\n\n  /**\n   * Build the final schema. This should be called after all tables are added.\n   */\n  build(): Schema<TTables> {\n    const operations = this.#operations;\n    const version = this.#version;\n    const tables = this.#tables;\n\n    const schema: Schema<TTables> = {\n      version,\n      tables,\n      operations,\n      clone: () => {\n        const cloneTables: Record<string, AnyTable> = {};\n\n        for (const [k, v] of Object.entries(tables)) {\n          // Create a new table with cloned columns\n          const clonedColumns: Record<string, AnyColumn> = {};\n          for (const [colName, col] of Object.entries(v.columns)) {\n            // Create a new column with the same properties, preserving the column type\n            let clonedCol: AnyColumn;\n            if (col instanceof InternalIdColumn) {\n              clonedCol = new InternalIdColumn();\n            } else if (col instanceof VersionColumn) {\n              clonedCol = new VersionColumn();\n            } else if (col instanceof IdColumn) {\n              clonedCol = new IdColumn(col.type);\n            } else {\n              clonedCol = new Column(col.type);\n            }\n\n            clonedCol.name = col.name;\n            clonedCol.ormName = col.ormName;\n            clonedCol.isNullable = col.isNullable;\n            clonedCol.role = col.role;\n            clonedCol.isHidden = col.isHidden;\n            clonedCol.default = col.default;\n            clonedCol.tableName = col.tableName;\n            clonedColumns[colName] = clonedCol;\n          }\n\n          cloneTables[k] = {\n            ...v,\n            columns: clonedColumns,\n          };\n        }\n\n        return new SchemaBuilder<TTables>({\n          version,\n          tables: cloneTables as TTables,\n          operations: [...operations],\n          clone: () => {\n            throw new Error(\"Cannot clone during clone\");\n          },\n        }).build();\n      },\n    };\n\n    return schema;\n  }\n\n  /**\n   * Get the current version of the schema builder.\n   */\n  getVersion(): number {\n    return this.#version;\n  }\n}\n\n/**\n * Create a new schema with callback pattern.\n */\nexport function schema<const TTables extends Record<string, AnyTable> = {}>(\n  callback: (builder: SchemaBuilder<{}>) => SchemaBuilder<TTables>,\n): Schema<TTables> {\n  return callback(new SchemaBuilder()).build();\n}\n\nexport function compileForeignKey(key: ForeignKey, nameType: \"sql\" | \"orm\" = \"orm\") {\n  return {\n    name: key.name,\n    table: nameType === \"sql\" ? key.table.name : key.table.ormName,\n    referencedTable: nameType === \"sql\" ? key.referencedTable.name : key.referencedTable.ormName,\n    referencedColumns: key.referencedColumns.map((col) =>\n      nameType === \"sql\" ? col.name : col.ormName,\n    ),\n    columns: key.columns.map((col) => (nameType === \"sql\" ? col.name : col.ormName)),\n  };\n}\n"],"mappings":"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"}

package/dist/schema/generate-id.d.ts

@@ -0,0 +1,20 @@
+import { AnySchema, FragnoId } from "./create.js";
+
+//#region src/schema/generate-id.d.ts
+
+/**
+ * Generate a new ID for a table without creating a record.
+ * This is useful when you need to reference an ID before actually creating the record,
+ * or when you need to pass the ID to external services.
+ *
+ * @example
+ * ```ts
+ * const userId = generateId(mySchema, "users");
+ * // Use userId in related records or pass to external services
+ * uow.create("users", { id: userId, name: "John" });
+ * ```
+ */
+declare function generateId<TSchema extends AnySchema, TableName extends keyof TSchema["tables"] & string>(schema: TSchema, tableName: TableName): FragnoId;
+//#endregion
+export { generateId };
+//# sourceMappingURL=generate-id.d.ts.map

package/dist/schema/generate-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-id.d.ts","names":[],"sources":["../../src/schema/generate-id.ts"],"sourcesContent":[],"mappings":";;;;;AAeA;;;;;;;;;;;iBAAgB,2BACE,mCACQ,oCAChB,oBAAoB,YAAY"}

package/dist/schema/generate-id.js

@@ -0,0 +1,28 @@
+import { FragnoId } from "./create.js";
+
+//#region src/schema/generate-id.ts
+/**
+* Generate a new ID for a table without creating a record.
+* This is useful when you need to reference an ID before actually creating the record,
+* or when you need to pass the ID to external services.
+*
+* @example
+* ```ts
+* const userId = generateId(mySchema, "users");
+* // Use userId in related records or pass to external services
+* uow.create("users", { id: userId, name: "John" });
+* ```
+*/
+function generateId(schema, tableName) {
+	const tableSchema = schema.tables[tableName];
+	if (!tableSchema) throw new Error(`Table ${tableName} not found in schema`);
+	const idColumn = tableSchema.getIdColumn();
+	const generated = idColumn.generateDefaultValue();
+	if (generated === void 0) throw new Error(`ID column ${idColumn.ormName} on table ${tableName} has no default generator`);
+	if (typeof generated !== "string") throw new Error(`ID column ${idColumn.ormName} on table ${tableName} has no default generator that generates a string.`);
+	return FragnoId.fromExternal(generated, 0);
+}
+
+//#endregion
+export { generateId };
+//# sourceMappingURL=generate-id.js.map

package/dist/schema/generate-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-id.js","names":[],"sources":["../../src/schema/generate-id.ts"],"sourcesContent":["import type { AnySchema } from \"./create\";\nimport { FragnoId } from \"./create\";\n\n/**\n * Generate a new ID for a table without creating a record.\n * This is useful when you need to reference an ID before actually creating the record,\n * or when you need to pass the ID to external services.\n *\n * @example\n * ```ts\n * const userId = generateId(mySchema, \"users\");\n * // Use userId in related records or pass to external services\n * uow.create(\"users\", { id: userId, name: \"John\" });\n * ```\n */\nexport function generateId<\n  TSchema extends AnySchema,\n  TableName extends keyof TSchema[\"tables\"] & string,\n>(schema: TSchema, tableName: TableName): FragnoId {\n  const tableSchema = schema.tables[tableName];\n  if (!tableSchema) {\n    throw new Error(`Table ${tableName} not found in schema`);\n  }\n\n  const idColumn = tableSchema.getIdColumn();\n  const generated = idColumn.generateDefaultValue();\n  if (generated === undefined) {\n    throw new Error(`ID column ${idColumn.ormName} on table ${tableName} has no default generator`);\n  }\n\n  if (typeof generated !== \"string\") {\n    throw new Error(\n      `ID column ${idColumn.ormName} on table ${tableName} has no default generator that generates a string.`,\n    );\n  }\n\n  return FragnoId.fromExternal(generated, 0);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAgB,WAGd,QAAiB,WAAgC;CACjD,MAAM,cAAc,OAAO,OAAO;AAClC,KAAI,CAAC,YACH,OAAM,IAAI,MAAM,SAAS,UAAU,sBAAsB;CAG3D,MAAM,WAAW,YAAY,aAAa;CAC1C,MAAM,YAAY,SAAS,sBAAsB;AACjD,KAAI,cAAc,OAChB,OAAM,IAAI,MAAM,aAAa,SAAS,QAAQ,YAAY,UAAU,2BAA2B;AAGjG,KAAI,OAAO,cAAc,SACvB,OAAM,IAAI,MACR,aAAa,SAAS,QAAQ,YAAY,UAAU,oDACrD;AAGH,QAAO,SAAS,aAAa,WAAW,EAAE"}

package/dist/sql-driver/dialects/durable-object-dialect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"durable-object-dialect.d.ts","names":[],"sources":["../../../src/sql-driver/dialects/durable-object-dialect.ts"],"sourcesContent":[],"mappings":";;;UAcU,eAAA;;EAAA,MAAA,CAAA,KAAA,EAEM,eAFS,CAET,EAAA,OAAA;EAIN,SAAA,IAAA,CAAA,EAAA,MAAA;AAAwB;AAIA,UAJxB,wBAAA,CAMU;EACY,QAAA,EAAA,EAAA,IAAA;;KAH3B,eAAA,GAAkB,WAOD,GAAA,MAAA,GAAA,MAAA,GAAA,IAAA;UALZ,UAAA,CAKL;EACY,IAAA,CAAA,UALA,MAKA,CAAA,MAAA,EALe,eAKf,CAAA,CAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,QAAA,EAAA,GAAA,EAAA,CAAA,EADZ,gBACY,CADK,CACL,CAAA;EACG,MAAA,EAAA,OADH,gBACG;EAAmB,SAAA,EAAA,OAAnB,mBAAmB;AAAA;AAGG,uBAAnB,mBAAA,CACgB;uBAAhB,gBAA2B,CAAA,UAAA,MAAA,CAAA,MAAA,EAAe,eAAf,CAAA,CAAA,CAAA;EAInC,IAAA,CAAA,CAAA,EAAA;IAMF,IAAA,CAAA,EAAA,KAAA;IACJ,KAAA,EAPM,CAON;EACO,CAAA,GAAA;IAAuC,IAAA,EAAA,IAAA;IAAjB,KAAA,CAAA,EAAA,KAAA;EAIE,CAAA;EAAjB,OAAA,CAAA,CAAA,EANV,CAMU,EAAA;EAApB,GAAA,CAAA,CAAO,EALD,CAKC;EAAQ,GAAA,CAAA,UAJF,eAIE,EAAA,CAAA,CAAA,CAAA,EAJoB,gBAIpB,CAJqC,CAIrC,CAAA;EAGR,WAAA,EAAA,MAAA,EAAA;EACsB,IAAA,QAAA,CAAA,CAAA,EAAA,MAAA;EAAqC,IAAA,WAAA,CAAA,CAAA,EAAA,MAAA;EAAR,CAJ1D,MAAA,CAAO,QAAA,GAImD,EAJtC,gBAIsC,CAJrB,CAIqB,CAAA;;UADnD,oBAAA,CACgE;EAE1D,WAAA,CAAA,CAAA,CAAA,CAAA,OAAA,EAAA,CAAA,GAAA,EAFgB,wBAEhB,EAAA,GAF6C,OAE7C,CAFqD,CAErD,CAAA,CAAA,EAF0D,OAE1D,CAFkE,CAElE,CAAA;EAAU,SAAA,GAAA,EAAV,UAAU;AAAA;AAW1B,UARU,kBAAA,CAQsB;EAiBnB,SAAA,EAAA,EAxBE,eAwBmB;EAGZ,SAAA,OAAA,EA1BF,oBA0BE;;;;;AAgBqB,UApC1B,eAAA,CAoC0B;EAnBE,GAAA,EAhBtC,kBAgBsC;;;;;;;;;;;;;;;cAAhC,oBAAA,YAAgC;;sBAGvB;mBAIP;kBAIG;yBAIO;yBAIA,kBAAkB"}
+{"version":3,"file":"durable-object-dialect.d.ts","names":[],"sources":["../../../src/sql-driver/dialects/durable-object-dialect.ts"],"sourcesContent":[],"mappings":";;;UAcU,eAAA;;EAAA,MAAA,CAAA,KAAA,EAEM,eAFS,CAAA,EAET,OAAA;EAIN,SAAA,IAAA,CAAA,EAAA,MAAA;AAAwB;AAIA,UAJxB,wBAAA,CAMU;EACY,QAAA,EAAA,EAAA,IAAA;;KAH3B,eAAA,GAAkB,WAOD,GAAA,MAAA,GAAA,MAAA,GAAA,IAAA;UALZ,UAAA,CAKL;EACY,IAAA,CAAA,UALA,MAKA,CAAA,MAAA,EALe,eAKf,CAAA,CAAA,CAAA,KAAA,EAAA,MAAA,EAAA,GAAA,QAAA,EAAA,GAAA,EAAA,CAAA,EADZ,gBACY,CADK,CACL,CAAA;EACG,MAAA,EAAA,OADH,gBACG;EAAmB,SAAA,EAAA,OAAnB,mBAAmB;AAAA;AAGG,uBAAnB,mBAAA,CACgB;uBAAhB,gBAA2B,CAAA,UAAA,MAAA,CAAA,MAAA,EAAe,eAAf,CAAA,CAAA,CAAA;EAInC,IAAA,CAAA,CAAA,EAAA;IAMF,IAAA,CAAA,EAAA,KAAA;IACJ,KAAA,EAPM,CAON;EACO,CAAA,GAAA;IAAuC,IAAA,EAAA,IAAA;IAAjB,KAAA,CAAA,EAAA,KAAA;EAIE,CAAA;EAAjB,OAAA,CAAA,CAAA,EANV,CAMU,EAAA;EAApB,GAAA,CAAA,CAAO,EALD,CAKC;EAAQ,GAAA,CAAA,UAJF,eAIE,EAAA,CAAA,CAAA,CAAA,EAJoB,gBAIpB,CAJqC,CAIrC,CAAA;EAGR,WAAA,EAAA,MAAA,EAAA;EACsB,IAAA,QAAA,CAAA,CAAA,EAAA,MAAA;EAAqC,IAAA,WAAA,CAAA,CAAA,EAAA,MAAA;EAAR,CAJ1D,MAAA,CAAO,QAAA,GAImD,EAJtC,gBAIsC,CAJrB,CAIqB,CAAA;;UADnD,oBAAA,CACgE;EAE1D,WAAA,CAAA,CAAA,CAAA,CAAA,OAAA,EAAA,CAAA,GAAA,EAFgB,wBAEhB,EAAA,GAF6C,OAE7C,CAFqD,CAErD,CAAA,CAAA,EAF0D,OAE1D,CAFkE,CAElE,CAAA;EAAU,SAAA,GAAA,EAAV,UAAU;AAAA;AAW1B,UARU,kBAAA,CAQsB;EAiBnB,SAAA,EAAA,EAxBE,eAwBmB;EAGZ,SAAA,OAAA,EA1BF,oBA0BE;;;;;AAgBqB,UApC1B,eAAA,CAoC0B;EAnBE,GAAA,EAhBtC,kBAgBsC;;;;;;;;;;;;;;;cAAhC,oBAAA,YAAgC;;sBAGvB;mBAIP;kBAIG;yBAIO;yBAIA,kBAAkB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fragno-dev/db",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "type": "module",
   "exports": {
     ".": {
@@ -109,8 +109,8 @@
     "vitest": "^3.2.4",
     "zod": "^4.1.12",
     "@fragno-dev/core": "0.1.11",
-    "@fragno-private/typescript-config": "0.0.1",
-    "@fragno-private/vitest-config": "0.0.0"
+    "@fragno-private/vitest-config": "0.0.0",
+    "@fragno-private/typescript-config": "0.0.1"
   },
   "repository": {
     "type": "git",

package/src/adapters/drizzle/drizzle-adapter-pglite.test.ts

@@ -530,6 +530,7 @@ describe("DrizzleAdapter PGLite", () => {
 
     const createdPostIds = createPostUow.getCreatedIds();
     expect(createdPostIds).toHaveLength(1);
+    expect(createdPostIds[0].internalId).toBeDefined();
     const postId = createdPostIds[0];
 
     // Retrieve the specific post we just created by its ID

package/src/adapters/drizzle/drizzle-adapter-sqlite3.test.ts

@@ -1,10 +1,13 @@
 import SQLite from "better-sqlite3";
 import { SqliteDialect } from "kysely";
 import { DrizzleAdapter } from "./drizzle-adapter";
-import { beforeAll, describe, expect, expectTypeOf, it, assert } from "vitest";
+import { beforeAll, describe, expect, expectTypeOf, it } from "vitest";
 import { column, idColumn, referenceColumn, schema, type FragnoId } from "../../schema/create";
 import { Cursor } from "../../query/cursor";
-import { executeUnitOfWork } from "../../query/unit-of-work/execute-unit-of-work";
+import {
+  createServiceTxBuilder,
+  createHandlerTxBuilder,
+} from "../../query/unit-of-work/execute-unit-of-work";
 import { ExponentialBackoffRetryPolicy } from "../../query/unit-of-work/retry-policy";
 import { BetterSQLite3DriverConfig } from "../generic-sql/driver-config";
 import { internalSchema } from "../../fragments/internal-fragment";
@@ -793,7 +796,7 @@ describe("DrizzleAdapter SQLite", () => {
     expect(emptyPage.cursor).toBeUndefined();
   });
 
-  it("should support executeUnitOfWork with retry logic", async () => {
+  it("should support handlerTx with retry logic", async () => {
     const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
 
     // Create a test user
@@ -807,31 +810,44 @@ describe("DrizzleAdapter SQLite", () => {
       .find("users", (b) => b.whereIndex("name_idx", (eb) => eb("name", "=", "Execute UOW User")))
       .executeRetrieve();
 
-    // Use executeUnitOfWork to increment age with optimistic locking
-    const result = await executeUnitOfWork(
-      {
-        retrieve: (uow) =>
-          uow.find("users", (b) => b.whereIndex("primary", (eb) => eb("id", "=", user.id))),
-        mutate: (uow, [users]) => {
-          const foundUser = users[0];
-          const newAge = foundUser.age! + 1;
-          uow.update("users", foundUser.id, (b) => b.set({ age: newAge }).check());
-          return { previousAge: foundUser.age, newAge };
-        },
-        onSuccess: ({ mutationResult }) => {
-          // Verify the age was incremented correctly
-          expect(mutationResult.newAge).toBe(mutationResult.previousAge! + 1);
-        },
-      },
-      {
-        createUnitOfWork: () => queryEngine.createUnitOfWork("execute-uow-update"),
-        retryPolicy: new ExponentialBackoffRetryPolicy({ maxRetries: 3, initialDelayMs: 1 }),
+    // Use handlerTx to increment age with optimistic locking
+    let currentUow: ReturnType<typeof queryEngine.createUnitOfWork> | null = null;
+
+    // Service that retrieves user by ID
+    const getUserById = (userId: typeof user.id) => {
+      return createServiceTxBuilder(testSchema, currentUow!)
+        .retrieve((uow) =>
+          uow.find("users", (b) => b.whereIndex("primary", (eb) => eb("id", "=", userId))),
+        )
+        .transformRetrieve(([users]) => users[0] ?? null)
+        .build();
+    };
+
+    const result = await createHandlerTxBuilder({
+      createUnitOfWork: () => {
+        currentUow = queryEngine.createUnitOfWork("execute-uow-update");
+        return currentUow;
       },
-    );
+      retryPolicy: new ExponentialBackoffRetryPolicy({ maxRetries: 3, initialDelayMs: 1 }),
+    })
+      .withServiceCalls(() => [getUserById(user.id)])
+      .mutate(({ forSchema, serviceIntermediateResult: [foundUser] }) => {
+        if (!foundUser) {
+          throw new Error("User not found");
+        }
+        const newAge = foundUser.age! + 1;
+        forSchema(testSchema).update("users", foundUser.id, (b) => b.set({ age: newAge }).check());
+        return { previousAge: foundUser.age, newAge };
+      })
+      .transform(({ mutateResult }) => {
+        // Verify the age was incremented correctly
+        expect(mutateResult.newAge).toBe(mutateResult.previousAge! + 1);
+        return mutateResult;
+      })
+      .execute();
 
     // Verify the operation succeeded
-    assert(result.success);
-    expect(result.mutationResult).toEqual({
+    expect(result).toEqual({
       previousAge: 42,
       newAge: 43,
     });

package/src/adapters/generic-sql/test/generic-drizzle-adapter-sqlite3.test.ts

@@ -1,9 +1,10 @@
 import SQLite from "better-sqlite3";
-import { beforeAll, describe, expect, expectTypeOf, it, assert } from "vitest";
+import { beforeAll, describe, expect, expectTypeOf, it } from "vitest";
 import { column, idColumn, referenceColumn, schema, type FragnoId } from "../../../schema/create";
 import {
   Cursor,
-  executeUnitOfWork,
+  createServiceTxBuilder,
+  createHandlerTxBuilder,
   ExponentialBackoffRetryPolicy,
   type DatabaseAdapter,
 } from "../../../mod";
@@ -793,7 +794,7 @@ describe("GenericSQLAdapter with DrizzleAdapter better-sqlite3", () => {
     expect(emptyPage.cursor).toBeUndefined();
   });
 
-  it("should support executeUnitOfWork with retry logic", async () => {
+  it("should support handlerTx with retry logic", async () => {
     const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
 
     // Create a test user
@@ -807,31 +808,44 @@ describe("GenericSQLAdapter with DrizzleAdapter better-sqlite3", () => {
       .find("users", (b) => b.whereIndex("name_idx", (eb) => eb("name", "=", "Execute UOW User")))
       .executeRetrieve();
 
-    // Use executeUnitOfWork to increment age with optimistic locking
-    const result = await executeUnitOfWork(
-      {
-        retrieve: (uow) =>
-          uow.find("users", (b) => b.whereIndex("primary", (eb) => eb("id", "=", user.id))),
-        mutate: (uow, [users]) => {
-          const foundUser = users[0];
-          const newAge = foundUser.age! + 1;
-          uow.update("users", foundUser.id, (b) => b.set({ age: newAge }).check());
-          return { previousAge: foundUser.age, newAge };
-        },
-        onSuccess: ({ mutationResult }) => {
-          // Verify the age was incremented correctly
-          expect(mutationResult.newAge).toBe(mutationResult.previousAge! + 1);
-        },
-      },
-      {
-        createUnitOfWork: () => queryEngine.createUnitOfWork("execute-uow-update"),
-        retryPolicy: new ExponentialBackoffRetryPolicy({ maxRetries: 3, initialDelayMs: 1 }),
+    // Use handlerTx to increment age with optimistic locking
+    let currentUow: ReturnType<typeof queryEngine.createUnitOfWork> | null = null;
+
+    // Service that retrieves user by ID
+    const getUserById = (userId: typeof user.id) => {
+      return createServiceTxBuilder(testSchema, currentUow!)
+        .retrieve((uow) =>
+          uow.find("users", (b) => b.whereIndex("primary", (eb) => eb("id", "=", userId))),
+        )
+        .transformRetrieve(([users]) => users[0] ?? null)
+        .build();
+    };
+
+    const result = await createHandlerTxBuilder({
+      createUnitOfWork: () => {
+        currentUow = queryEngine.createUnitOfWork("execute-uow-update");
+        return currentUow;
       },
-    );
+      retryPolicy: new ExponentialBackoffRetryPolicy({ maxRetries: 3, initialDelayMs: 1 }),
+    })
+      .withServiceCalls(() => [getUserById(user.id)])
+      .mutate(({ forSchema, serviceIntermediateResult: [foundUser] }) => {
+        if (!foundUser) {
+          throw new Error("User not found");
+        }
+        const newAge = foundUser.age! + 1;
+        forSchema(testSchema).update("users", foundUser.id, (b) => b.set({ age: newAge }).check());
+        return { previousAge: foundUser.age, newAge };
+      })
+      .transform(({ mutateResult }) => {
+        // Verify the age was incremented correctly
+        expect(mutateResult.newAge).toBe(mutateResult.previousAge! + 1);
+        return mutateResult;
+      })
+      .execute();
 
     // Verify the operation succeeded
-    assert(result.success);
-    expect(result.mutationResult).toEqual({
+    expect(result).toEqual({
       previousAge: 42,
       newAge: 43,
     });