@fragno-dev/db 0.3.0 → 0.4.1

package/dist/adapters/shared/from-unit-of-work-compiler.js.map

@@ -1 +1 @@
-{"version":3,"file":"from-unit-of-work-compiler.js","names":["#indexName","#condition","#setValues"],"sources":["../../../src/adapters/shared/from-unit-of-work-compiler.ts"],"sourcesContent":["import type { SimpleQueryInterface, TableToUpdateValues } from \"../../query/simple-query-interface\";\nimport type { AnySchema, AnyTable, FragnoId } from \"../../schema/create\";\nimport type {\n  CompiledMutation,\n  UOWCompiler,\n  UOWDecoder,\n  UOWExecutor,\n  UOWInstrumentation,\n  ValidIndexName,\n} from \"../../query/unit-of-work/unit-of-work\";\nimport { UnitOfWork } from \"../../query/unit-of-work/unit-of-work\";\nimport type { CursorResult } from \"../../query/cursor\";\nimport type { CompiledQuery } from \"../../sql-driver/sql-driver\";\n\n/**\n * Configuration options for creating a Unit of Work with generic SQL\n */\nexport interface UnitOfWorkConfig {\n  /**\n   * Optional callback to receive compiled SQL queries for logging/debugging\n   * This callback is invoked for each query as it's compiled\n   */\n  onQuery?: (query: CompiledQuery) => void;\n  /**\n   * If true, the query will not be executed and the query will be returned. Not respected for UOWs\n   * since those have to be manually executed.\n   */\n  dryRun?: boolean;\n  instrumentation?: UOWInstrumentation;\n}\n\n/**\n * Factory interface for creating Unit of Work instances\n */\nexport interface UnitOfWorkFactory {\n  /**\n   * UOW compiler for compiling operations to SQL\n   */\n  compiler: UOWCompiler<CompiledQuery>;\n  /**\n   * UOW executor for running compiled queries\n   */\n  executor: UOWExecutor<CompiledQuery, unknown>;\n  /**\n   * UOW decoder for transforming raw results\n   */\n  decoder: UOWDecoder<unknown>;\n  /**\n   * Optional UOW configuration\n   */\n  uowConfig?: UnitOfWorkConfig;\n  /**\n   * Optional WeakMap for schema-to-namespace lookups\n   */\n  schemaNamespaceMap?: WeakMap<AnySchema, string | null>;\n}\n\n/**\n * Type guard to check if a query is a CompiledMutation\n */\nfunction isCompiledMutation(query: unknown): query is CompiledMutation<CompiledQuery> {\n  return (\n    query !== null &&\n    typeof query === \"object\" &&\n    \"expectedAffectedRows\" in query &&\n    \"query\" in query\n  );\n}\n\n/**\n * Type guard to check if a record has an id field\n */\nfunction hasIdField(record: unknown): record is { id: string | FragnoId } {\n  return record !== null && typeof record === \"object\" && \"id\" in record;\n}\n\nclass UpdateManySpecialBuilder<TTable extends AnyTable> {\n  #indexName?: ValidIndexName<TTable>;\n  #condition?: unknown;\n  #setValues?: TableToUpdateValues<TTable>;\n\n  whereIndex<TIndexName extends ValidIndexName<TTable>>(\n    indexName: TIndexName,\n    condition?: unknown,\n  ): this {\n    this.#indexName = indexName;\n    this.#condition = condition;\n    return this;\n  }\n\n  set(values: TableToUpdateValues<TTable>): this {\n    this.#setValues = values;\n    return this;\n  }\n\n  getConfig() {\n    return {\n      indexName: this.#indexName,\n      condition: this.#condition,\n      setValues: this.#setValues,\n    };\n  }\n}\n\n/**\n * Creates a generic SQL-based query engine for the given schema using a UnitOfWorkFactory.\n *\n * This is the main entry point for creating a database query interface using a Unit of Work compiler.\n * It uses a compiler-based architecture where queries are compiled to SQL and then executed,\n * enabling features like SQL snapshot testing.\n *\n * @param schema - The database schema definition\n * @param factory - Factory containing compiler, executor, decoder, and optional configuration\n * @returns An SimpleQueryInterface instance for performing database operations\n *\n * @example\n * ```ts\n * const operationCompiler = new GenericSQLUOWOperationCompiler(driverConfig);\n * const factory: UnitOfWorkFactory = {\n *   compiler: createUOWCompilerFromOperationCompiler(operationCompiler),\n *   executor: createExecutor(sqlDriver),\n *   decoder: createKyselyUOWDecoder(driverConfig.databaseType),\n * };\n * const queryEngine = fromUnitOfWorkCompiler(mySchema, factory);\n *\n * const users = await queryEngine.find('users', (b) =>\n *   b.whereIndex('age').where((eb) => eb('age', '>', 18))\n * );\n * ```\n */\nexport function fromUnitOfWorkCompiler<T extends AnySchema>(\n  schema: T,\n  factory: UnitOfWorkFactory,\n): SimpleQueryInterface<T, UnitOfWorkConfig> {\n  const { compiler, executor, decoder, uowConfig, schemaNamespaceMap } = factory;\n\n  function createUOW(opts: { name?: string; config?: UnitOfWorkConfig }) {\n    const { onQuery, ...restUowConfig } = opts.config ?? {};\n\n    return new UnitOfWork(\n      compiler,\n      executor,\n      decoder,\n      opts.name,\n      {\n        ...restUowConfig,\n        onQuery: onQuery\n          ? (query) => {\n              // Extract the actual query from CompiledMutation if needed\n              const actualQuery = isCompiledMutation(query)\n                ? query.query\n                : (query as CompiledQuery);\n              onQuery(actualQuery);\n            }\n          : undefined,\n      },\n      schemaNamespaceMap,\n    ).forSchema(schema);\n  }\n\n  return {\n    async find(tableName, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      uow.find(tableName, builderFn);\n      const [result]: unknown[][] = await uow.executeRetrieve();\n      return result ?? [];\n    },\n\n    async findWithCursor(tableName, builderFn) {\n      const uow = createUOW({ config: uowConfig }).findWithCursor(tableName, builderFn);\n      const [result] = await uow.executeRetrieve();\n      // Result from findWithCursor is always a CursorResult - the UOW decoder handles the conversion\n      return result as CursorResult<unknown>;\n    },\n\n    async findFirst(tableName, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      if (builderFn) {\n        uow.find(tableName, (b) => {\n          builderFn(b);\n          return b.pageSize(1);\n        });\n      } else {\n        uow.find(tableName, (b) => b.whereIndex(\"primary\").pageSize(1));\n      }\n      // executeRetrieve runs an array of `find` operation results, which each return an array of rows\n      const [result]: unknown[][] = await uow.executeRetrieve();\n      return result?.[0] ?? null;\n    },\n\n    async create(tableName, values) {\n      const uow = createUOW({ config: uowConfig });\n      uow.create(tableName, values);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to create record\");\n      }\n\n      const createdIds = uow.getCreatedIds();\n      const createdId = createdIds[0];\n      if (!createdId) {\n        throw new Error(\"Failed to get created ID\");\n      }\n      return createdId;\n    },\n\n    async createMany(tableName, valuesArray) {\n      const uow = createUOW({ config: uowConfig });\n      for (const values of valuesArray) {\n        uow.create(tableName, values);\n      }\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to create records\");\n      }\n\n      return uow.getCreatedIds();\n    },\n\n    async update(tableName, id, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      uow.update(tableName, id, builderFn);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to update record (version conflict or record not found)\");\n      }\n    },\n\n    async updateMany(tableName, builderFn) {\n      const table = schema.tables[tableName];\n      if (!table) {\n        throw new Error(`Table ${tableName} not found in schema`);\n      }\n\n      const specialBuilder = new UpdateManySpecialBuilder<typeof table>();\n      builderFn(specialBuilder);\n\n      const { indexName, condition, setValues } = specialBuilder.getConfig();\n\n      if (!indexName) {\n        throw new Error(\"whereIndex() must be called in updateMany\");\n      }\n      if (!setValues) {\n        throw new Error(\"set() must be called in updateMany\");\n      }\n\n      const findUow = createUOW({ config: uowConfig });\n      findUow.find(tableName, (b) => {\n        // Condition might be null or undefined, only pass if defined and not null\n        if (condition !== undefined && condition !== null) {\n          // TypeScript can't infer the complex condition type from the builder\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          return b.whereIndex(indexName, condition as any);\n        }\n        return b.whereIndex(indexName);\n      });\n      const [records]: unknown[][] = await findUow.executeRetrieve();\n\n      if (!records || records.length === 0) {\n        return;\n      }\n\n      const updateUow = createUOW({ config: uowConfig });\n      for (const record of records) {\n        if (!hasIdField(record)) {\n          throw new Error(\"Record missing id field\");\n        }\n        updateUow.update(tableName, record.id, (b) => b.set(setValues));\n      }\n      const { success } = await updateUow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to update records (version conflict)\");\n      }\n    },\n\n    async delete(tableName, id, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      uow.delete(tableName, id, builderFn);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to delete record (version conflict or record not found)\");\n      }\n    },\n\n    async deleteMany(tableName, builderFn) {\n      const findUow = createUOW({ config: uowConfig });\n      findUow.find(tableName, builderFn);\n      const [records]: unknown[][] = await findUow.executeRetrieve();\n\n      if (!records || records.length === 0) {\n        return;\n      }\n\n      const deleteUow = createUOW({ config: uowConfig });\n      for (const record of records) {\n        if (!hasIdField(record)) {\n          throw new Error(\"Record missing id field\");\n        }\n        deleteUow.delete(tableName, record.id);\n      }\n      const { success } = await deleteUow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to delete records (version conflict)\");\n      }\n    },\n\n    createUnitOfWork(name, nestedUowConfig) {\n      return createUOW({\n        name,\n        config: {\n          ...uowConfig,\n          ...nestedUowConfig,\n        },\n      });\n    },\n  } as SimpleQueryInterface<T, UnitOfWorkConfig>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"from-unit-of-work-compiler.js","names":["#indexName","#condition","#setValues"],"sources":["../../../src/adapters/shared/from-unit-of-work-compiler.ts"],"sourcesContent":["import type { CursorResult } from \"../../query/cursor\";\nimport { dbInterval, dbNow, type DbInterval, type DbIntervalInput } from \"../../query/db-now\";\nimport type {\n  SimpleQueryInterface,\n  TableToUpdateValues,\n  SelectResult,\n  ExtractJoinOut,\n  ExtractSelect,\n  SelectClause,\n} from \"../../query/simple-query-interface\";\nimport type {\n  CompiledMutation,\n  FindBuilder,\n  UOWCompiler,\n  UOWDecoder,\n  UOWExecutor,\n  UOWInstrumentation,\n  ValidIndexName,\n  UnitOfWorkConfig as BaseUnitOfWorkConfig,\n} from \"../../query/unit-of-work/unit-of-work\";\nimport { UnitOfWork } from \"../../query/unit-of-work/unit-of-work\";\nimport type { AnySchema, AnyTable, FragnoId } from \"../../schema/create\";\nimport type { CompiledQuery } from \"../../sql-driver/sql-driver\";\n\n/**\n * Configuration options for creating a Unit of Work with generic SQL\n */\nexport interface UnitOfWorkConfig {\n  /**\n   * Optional callback to receive compiled SQL queries for logging/debugging\n   * This callback is invoked for each query as it's compiled\n   */\n  onQuery?: (query: CompiledQuery) => void;\n  /**\n   * If true, the query will not be executed and the query will be returned. Not respected for UOWs\n   * since those have to be manually executed.\n   */\n  dryRun?: boolean;\n  instrumentation?: UOWInstrumentation;\n}\n\n/**\n * Factory interface for creating Unit of Work instances\n */\nexport interface UnitOfWorkFactory {\n  /**\n   * UOW compiler for compiling operations to SQL\n   */\n  compiler: UOWCompiler<CompiledQuery>;\n  /**\n   * UOW executor for running compiled queries\n   */\n  executor: UOWExecutor<CompiledQuery, unknown>;\n  /**\n   * UOW decoder for transforming raw results\n   */\n  decoder: UOWDecoder<unknown>;\n  /**\n   * Optional UOW configuration\n   */\n  uowConfig?: UnitOfWorkConfig;\n  /**\n   * Optional WeakMap for schema-to-namespace lookups\n   */\n  schemaNamespaceMap?: WeakMap<AnySchema, string | null>;\n}\n\n/**\n * Type guard to check if a query is a CompiledMutation\n */\nfunction isCompiledMutation(query: unknown): query is CompiledMutation<CompiledQuery> {\n  return (\n    query !== null &&\n    typeof query === \"object\" &&\n    \"expectedAffectedRows\" in query &&\n    \"query\" in query\n  );\n}\n\n/**\n * Type guard to check if a record has an id field\n */\nfunction hasIdField(record: unknown): record is { id: string | FragnoId } {\n  return record !== null && typeof record === \"object\" && \"id\" in record;\n}\n\nclass UpdateManySpecialBuilder<TTable extends AnyTable> {\n  #indexName?: ValidIndexName<TTable>;\n  #condition?: unknown;\n  #setValues?: TableToUpdateValues<TTable>;\n\n  whereIndex<TIndexName extends ValidIndexName<TTable>>(\n    indexName: TIndexName,\n    condition?: unknown,\n  ): this {\n    this.#indexName = indexName;\n    this.#condition = condition;\n    return this;\n  }\n\n  set(values: TableToUpdateValues<TTable>): this {\n    this.#setValues = values;\n    return this;\n  }\n\n  now() {\n    return dbNow();\n  }\n\n  interval(input: DbIntervalInput): DbInterval {\n    return dbInterval(input);\n  }\n\n  getConfig() {\n    return {\n      indexName: this.#indexName,\n      condition: this.#condition,\n      setValues: this.#setValues,\n    };\n  }\n}\n\n/**\n * Creates a generic SQL-based query engine for the given schema using a UnitOfWorkFactory.\n *\n * This is the main entry point for creating a database query interface using a Unit of Work compiler.\n * It uses a compiler-based architecture where queries are compiled to SQL and then executed,\n * enabling features like SQL snapshot testing.\n *\n * @param schema - The database schema definition\n * @param factory - Factory containing compiler, executor, decoder, and optional configuration\n * @returns An SimpleQueryInterface instance for performing database operations\n *\n * @example\n * ```ts\n * const operationCompiler = new GenericSQLUOWOperationCompiler(driverConfig);\n * const factory: UnitOfWorkFactory = {\n *   compiler: createUOWCompilerFromOperationCompiler(operationCompiler),\n *   executor: createExecutor(sqlDriver),\n *   decoder: createKyselyUOWDecoder(driverConfig.databaseType),\n * };\n * const queryEngine = fromUnitOfWorkCompiler(mySchema, factory);\n *\n * const users = await queryEngine.find('users', (b) =>\n *   b.whereIndex('age').where((eb) => eb('age', '>', 18))\n * );\n * ```\n */\nexport function fromUnitOfWorkCompiler<T extends AnySchema>(\n  schema: T,\n  factory: UnitOfWorkFactory,\n): SimpleQueryInterface<T, UnitOfWorkConfig> {\n  const { compiler, executor, decoder, uowConfig, schemaNamespaceMap } = factory;\n\n  function normalizeUowConfig(config?: UnitOfWorkConfig): BaseUnitOfWorkConfig | undefined {\n    if (!config) {\n      return undefined;\n    }\n    const { onQuery, ...restUowConfig } = config;\n    return {\n      ...restUowConfig,\n      onQuery: onQuery\n        ? (query) => {\n            // Extract the actual query from CompiledMutation if needed\n            const actualQuery = isCompiledMutation(query) ? query.query : (query as CompiledQuery);\n            onQuery(actualQuery);\n          }\n        : undefined,\n    };\n  }\n\n  function createBaseUow(opts: { name?: string; config?: UnitOfWorkConfig }) {\n    return new UnitOfWork(\n      compiler,\n      executor,\n      decoder,\n      opts.name,\n      normalizeUowConfig(opts.config),\n      schemaNamespaceMap,\n    );\n  }\n\n  function createUOW(opts: { name?: string; config?: UnitOfWorkConfig }) {\n    return createBaseUow(opts).forSchema(schema);\n  }\n\n  async function find<TableName extends keyof T[\"tables\"] & string, const TBuilderResult>(\n    tableName: TableName,\n    builderFn: (builder: Omit<FindBuilder<T[\"tables\"][TableName]>, \"build\">) => TBuilderResult,\n  ): Promise<\n    SelectResult<\n      T[\"tables\"][TableName],\n      ExtractJoinOut<TBuilderResult>,\n      Extract<ExtractSelect<TBuilderResult>, SelectClause<T[\"tables\"][TableName]>>\n    >[]\n  >;\n  async function find<TableName extends keyof T[\"tables\"] & string>(\n    tableName: TableName,\n  ): Promise<SelectResult<T[\"tables\"][TableName], {}, true>[]>;\n  async function find<TableName extends keyof T[\"tables\"] & string, const TBuilderResult>(\n    tableName: TableName,\n    builderFn?: (builder: Omit<FindBuilder<T[\"tables\"][TableName]>, \"build\">) => TBuilderResult,\n  ): Promise<\n    SelectResult<\n      T[\"tables\"][TableName],\n      ExtractJoinOut<TBuilderResult>,\n      Extract<ExtractSelect<TBuilderResult>, SelectClause<T[\"tables\"][TableName]>>\n    >[]\n  > {\n    const uow = createUOW({ config: uowConfig });\n    if (builderFn) {\n      uow.find(tableName, builderFn);\n    } else {\n      uow.find(tableName);\n    }\n    const [result]: unknown[][] = await uow.executeRetrieve();\n    return (result ?? []) as SelectResult<\n      T[\"tables\"][TableName],\n      ExtractJoinOut<TBuilderResult>,\n      Extract<ExtractSelect<TBuilderResult>, SelectClause<T[\"tables\"][TableName]>>\n    >[];\n  }\n\n  async function findWithCursor<TableName extends keyof T[\"tables\"] & string, const TBuilderResult>(\n    tableName: TableName,\n    builderFn: (builder: Omit<FindBuilder<T[\"tables\"][TableName]>, \"build\">) => TBuilderResult,\n  ): Promise<\n    CursorResult<\n      SelectResult<\n        T[\"tables\"][TableName],\n        ExtractJoinOut<TBuilderResult>,\n        Extract<ExtractSelect<TBuilderResult>, SelectClause<T[\"tables\"][TableName]>>\n      >\n    >\n  > {\n    const uow = createUOW({ config: uowConfig }).findWithCursor(tableName, builderFn);\n    const [result] = await uow.executeRetrieve();\n    // Result from findWithCursor is always a CursorResult - the UOW decoder handles the conversion\n    return result as CursorResult<\n      SelectResult<\n        T[\"tables\"][TableName],\n        ExtractJoinOut<TBuilderResult>,\n        Extract<ExtractSelect<TBuilderResult>, SelectClause<T[\"tables\"][TableName]>>\n      >\n    >;\n  }\n\n  async function findFirst<TableName extends keyof T[\"tables\"] & string, const TBuilderResult>(\n    tableName: TableName,\n    builderFn: (builder: Omit<FindBuilder<T[\"tables\"][TableName]>, \"build\">) => TBuilderResult,\n  ): Promise<SelectResult<\n    T[\"tables\"][TableName],\n    ExtractJoinOut<TBuilderResult>,\n    Extract<ExtractSelect<TBuilderResult>, SelectClause<T[\"tables\"][TableName]>>\n  > | null>;\n  async function findFirst<TableName extends keyof T[\"tables\"] & string>(\n    tableName: TableName,\n  ): Promise<SelectResult<T[\"tables\"][TableName], {}, true> | null>;\n  async function findFirst<TableName extends keyof T[\"tables\"] & string, const TBuilderResult>(\n    tableName: TableName,\n    builderFn?: (builder: Omit<FindBuilder<T[\"tables\"][TableName]>, \"build\">) => TBuilderResult,\n  ): Promise<SelectResult<\n    T[\"tables\"][TableName],\n    ExtractJoinOut<TBuilderResult>,\n    Extract<ExtractSelect<TBuilderResult>, SelectClause<T[\"tables\"][TableName]>>\n  > | null> {\n    const uow = createUOW({ config: uowConfig });\n    if (builderFn) {\n      uow.find(tableName, (b) => {\n        builderFn(b);\n        return b.pageSize(1);\n      });\n    } else {\n      uow.find(tableName, (b) => b.whereIndex(\"primary\").pageSize(1));\n    }\n    // executeRetrieve runs an array of `find` operation results, which each return an array of rows\n    const [result]: unknown[][] = await uow.executeRetrieve();\n    return (result?.[0] ?? null) as SelectResult<\n      T[\"tables\"][TableName],\n      ExtractJoinOut<TBuilderResult>,\n      Extract<ExtractSelect<TBuilderResult>, SelectClause<T[\"tables\"][TableName]>>\n    > | null;\n  }\n\n  const queryEngine: SimpleQueryInterface<T, UnitOfWorkConfig> = {\n    find,\n    findWithCursor,\n    findFirst,\n\n    async create(tableName, values) {\n      const uow = createUOW({ config: uowConfig });\n      uow.create(tableName, values);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to create record\");\n      }\n\n      const createdIds = uow.getCreatedIds();\n      const createdId = createdIds[0];\n      if (!createdId) {\n        throw new Error(\"Failed to get created ID\");\n      }\n      return createdId;\n    },\n\n    async createMany(tableName, valuesArray) {\n      const uow = createUOW({ config: uowConfig });\n      for (const values of valuesArray) {\n        uow.create(tableName, values);\n      }\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to create records\");\n      }\n\n      return uow.getCreatedIds();\n    },\n\n    async update(tableName, id, builderFn) {\n      const uow = createUOW({ config: uowConfig });\n      uow.update(tableName, id, builderFn);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to update record (version conflict or record not found)\");\n      }\n    },\n\n    async updateMany(tableName, builderFn) {\n      const table = schema.tables[tableName];\n      if (!table) {\n        throw new Error(`Table ${tableName} not found in schema`);\n      }\n\n      const specialBuilder = new UpdateManySpecialBuilder<typeof table>();\n      builderFn(specialBuilder);\n\n      const { indexName, condition, setValues } = specialBuilder.getConfig();\n\n      if (!indexName) {\n        throw new Error(\"whereIndex() must be called in updateMany\");\n      }\n      if (!setValues) {\n        throw new Error(\"set() must be called in updateMany\");\n      }\n\n      const findUow = createUOW({ config: uowConfig });\n      findUow.find(tableName, (b) => {\n        // Condition might be null or undefined, only pass if defined and not null\n        if (condition !== undefined && condition !== null) {\n          // TypeScript can't infer the complex condition type from the builder\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          return b.whereIndex(indexName, condition as any);\n        }\n        return b.whereIndex(indexName);\n      });\n      const [records]: unknown[][] = await findUow.executeRetrieve();\n\n      if (!records || records.length === 0) {\n        return;\n      }\n\n      const updateUow = createUOW({ config: uowConfig });\n      for (const record of records) {\n        if (!hasIdField(record)) {\n          throw new Error(\"Record missing id field\");\n        }\n        updateUow.update(tableName, record.id, (b) => b.set(setValues));\n      }\n      const { success } = await updateUow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to update records (version conflict)\");\n      }\n    },\n\n    async delete(tableName, id, builderFn?) {\n      const uow = createUOW({ config: uowConfig });\n      uow.delete(tableName, id, builderFn);\n      const { success } = await uow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to delete record (version conflict or record not found)\");\n      }\n    },\n\n    async deleteMany(tableName, builderFn) {\n      const findUow = createUOW({ config: uowConfig });\n      findUow.find(tableName, builderFn);\n      const [records]: unknown[][] = await findUow.executeRetrieve();\n\n      if (!records || records.length === 0) {\n        return;\n      }\n\n      const deleteUow = createUOW({ config: uowConfig });\n      for (const record of records) {\n        if (!hasIdField(record)) {\n          throw new Error(\"Record missing id field\");\n        }\n        deleteUow.delete(tableName, record.id);\n      }\n      const { success } = await deleteUow.executeMutations();\n      if (!success) {\n        throw new Error(\"Failed to delete records (version conflict)\");\n      }\n    },\n\n    createUnitOfWork(name, nestedUowConfig) {\n      return createUOW({\n        name,\n        config: {\n          ...uowConfig,\n          ...nestedUowConfig,\n        },\n      });\n    },\n\n    createBaseUnitOfWork(name, nestedUowConfig) {\n      return createBaseUow({\n        name,\n        config: {\n          ...uowConfig,\n          ...nestedUowConfig,\n        },\n      });\n    },\n  };\n  return queryEngine;\n}\n"],"mappings":"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"}

package/dist/adapters/shared/uow-operation-compiler.js.map

@@ -1 +1 @@
-{"version":3,"file":"uow-operation-compiler.js","names":["#driverConfig","#resolverFactory","exhaustiveCheck: never"],"sources":["../../../src/adapters/shared/uow-operation-compiler.ts"],"sourcesContent":["import type { AnyColumn, AnySchema, AnyTable, FragnoId } from \"../../schema/create\";\nimport type { Condition } from \"../../query/condition-builder\";\nimport type {\n  CompiledMutation,\n  RetrievalOperation,\n  MutationOperation,\n  UOWCompiler,\n} from \"../../query/unit-of-work/unit-of-work\";\nimport { Cursor } from \"../../query/cursor\";\nimport type { DriverConfig } from \"../generic-sql/driver-config\";\nimport { createNamingResolver, type NamingResolver } from \"../../naming/sql-naming\";\n\n/**\n * Options for compiling a find operation with cursor pagination\n */\nexport interface FindCompilationOptions {\n  /** Index columns used for ordering */\n  indexColumns: AnyColumn[];\n  /** Order direction for the index */\n  orderDirection: \"asc\" | \"desc\";\n  /** User-provided where condition */\n  userWhere: Condition | boolean | undefined;\n  /** Cursor string or Cursor object for pagination (after) */\n  after?: string | Cursor;\n  /** Cursor string or Cursor object for pagination (before) */\n  before?: string | Cursor;\n  /** Page size for pagination */\n  pageSize?: number;\n  /** Whether this is a high-level cursor API call (affects limit calculation) */\n  withCursor?: boolean;\n  /** Driver config for cursor serialization */\n  driverConfig: DriverConfig;\n}\n\n/**\n * Result of cursor condition building\n */\nexport interface CursorConditionResult {\n  /** The combined where condition (user where + cursor condition) */\n  where: Condition | undefined;\n  /** The effective limit to use (may be pageSize + 1 for cursor detection) */\n  limit: number | undefined;\n}\n\n/**\n * Abstract base class for Unit of Work operation compilers\n *\n * This class provides a structure and utilities for implementing UOW compilers\n * for different ORM/query builders (Kysely, Drizzle, etc.).\n *\n * Subclasses must implement the abstract methods for each operation type,\n * and can use the provided utility methods for common tasks.\n *\n * @template TCompiledQuery - The type of compiled query for the target ORM\n */\nexport abstract class UOWOperationCompiler<TCompiledQuery> {\n  #driverConfig: DriverConfig;\n  #resolverFactory?: (schema: AnySchema, namespace: string | null) => NamingResolver;\n\n  constructor(\n    driverConfig: DriverConfig,\n    resolverFactory?: (schema: AnySchema, namespace: string | null) => NamingResolver,\n  ) {\n    this.#driverConfig = driverConfig;\n    this.#resolverFactory = resolverFactory;\n  }\n\n  protected get driverConfig(): DriverConfig {\n    return this.#driverConfig;\n  }\n\n  protected get resolverFactory():\n    | ((schema: AnySchema, namespace: string | null) => NamingResolver)\n    | undefined {\n    return this.#resolverFactory;\n  }\n\n  abstract compileCount(\n    op: RetrievalOperation<AnySchema> & { type: \"count\" },\n  ): TCompiledQuery | null;\n\n  abstract compileFind(op: RetrievalOperation<AnySchema> & { type: \"find\" }): TCompiledQuery | null;\n\n  /**\n   * Compile a create operation\n   */\n  abstract compileCreate(\n    op: MutationOperation<AnySchema> & { type: \"create\" },\n  ): CompiledMutation<TCompiledQuery> | null;\n\n  abstract compileUpdate(\n    op: MutationOperation<AnySchema> & { type: \"update\" },\n  ): CompiledMutation<TCompiledQuery> | null;\n\n  abstract compileDelete(\n    op: MutationOperation<AnySchema> & { type: \"delete\" },\n  ): CompiledMutation<TCompiledQuery> | null;\n\n  abstract compileCheck(\n    op: MutationOperation<AnySchema> & { type: \"check\" },\n  ): CompiledMutation<TCompiledQuery> | null;\n\n  // ==================== Utility Methods ====================\n\n  /**\n   * Get the mapper for a specific operation based on its namespace\n   */\n  protected getNamingResolver(\n    schema: AnySchema,\n    namespace: string | null | undefined,\n  ): NamingResolver {\n    if (this.#resolverFactory) {\n      return this.#resolverFactory(schema, namespace ?? null);\n    }\n    return createNamingResolver(\n      schema,\n      namespace ?? null,\n      this.#driverConfig.defaultNamingStrategy,\n    );\n  }\n\n  /**\n   * Get a table from a schema by name\n   * @throws Error if table is not found\n   */\n  protected getTable(schema: AnySchema, tableName: string): AnyTable {\n    const table = schema.tables[tableName];\n    if (!table) {\n      throw new Error(`Invalid table name ${tableName}.`);\n    }\n    return table;\n  }\n\n  /**\n   * Get the version to check for a given ID and checkVersion flag\n   * @returns The version to check or undefined if no check is required\n   * @throws Error if the ID is a string and checkVersion is true\n   */\n  protected getVersionToCheck(id: FragnoId | string, checkVersion: boolean): number | undefined {\n    if (!checkVersion) {\n      return undefined;\n    }\n\n    if (typeof id === \"string\") {\n      throw new Error(\n        `Cannot use checkVersion with a string ID. Version checking requires a FragnoId with version information.`,\n      );\n    }\n\n    return id.version;\n  }\n\n  /**\n   * Extract external ID from FragnoId or string\n   */\n  protected getExternalId(id: FragnoId | string): string {\n    return typeof id === \"string\" ? id : id.externalId;\n  }\n\n  /**\n   * Get the physical table name for an operation, applying namespace mapping if needed\n   */\n  protected getPhysicalTableName(\n    schema: AnySchema,\n    logicalName: string,\n    namespace: string | undefined,\n  ): string {\n    const resolver = this.getNamingResolver(schema, namespace ?? null);\n    return resolver.getTableName(logicalName);\n  }\n}\n\n/**\n * Creates a UOWCompiler from a UOWOperationCompiler by dispatching operations\n * to the appropriate specific compilation methods based on operation type.\n *\n * @template TCompiledQuery - The type of compiled query for the target ORM\n * @param operationCompiler - The operation compiler to wrap\n * @returns A UOWCompiler instance that delegates to the operation compiler\n */\nexport function createUOWCompilerFromOperationCompiler<TCompiledQuery>(\n  operationCompiler: UOWOperationCompiler<TCompiledQuery>,\n): UOWCompiler<TCompiledQuery> {\n  return {\n    compileRetrievalOperation(op: RetrievalOperation<AnySchema>): TCompiledQuery | null {\n      switch (op.type) {\n        case \"count\":\n          return operationCompiler.compileCount(op);\n        case \"find\":\n          return operationCompiler.compileFind(op);\n        default: {\n          const exhaustiveCheck: never = op;\n          throw new Error(\n            `Unknown retrieval operation type: ${(exhaustiveCheck as RetrievalOperation<AnySchema>).type}`,\n          );\n        }\n      }\n    },\n\n    compileMutationOperation(\n      op: MutationOperation<AnySchema>,\n    ): CompiledMutation<TCompiledQuery> | null {\n      switch (op.type) {\n        case \"create\":\n          return operationCompiler.compileCreate(op);\n        case \"update\":\n          return operationCompiler.compileUpdate(op);\n        case \"delete\":\n          return operationCompiler.compileDelete(op);\n        case \"check\":\n          return operationCompiler.compileCheck(op);\n        default: {\n          const exhaustiveCheck: never = op;\n          throw new Error(\n            `Unknown mutation operation type: ${(exhaustiveCheck as MutationOperation<AnySchema>).type}`,\n          );\n        }\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuDA,IAAsB,uBAAtB,MAA2D;CACzD;CACA;CAEA,YACE,cACA,iBACA;AACA,QAAKA,eAAgB;AACrB,QAAKC,kBAAmB;;CAG1B,IAAc,eAA6B;AACzC,SAAO,MAAKD;;CAGd,IAAc,kBAEA;AACZ,SAAO,MAAKC;;;;;CAiCd,AAAU,kBACR,QACA,WACgB;AAChB,MAAI,MAAKA,gBACP,QAAO,MAAKA,gBAAiB,QAAQ,aAAa,KAAK;AAEzD,SAAO,qBACL,QACA,aAAa,MACb,MAAKD,aAAc,sBACpB;;;;;;CAOH,AAAU,SAAS,QAAmB,WAA6B;EACjE,MAAM,QAAQ,OAAO,OAAO;AAC5B,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,sBAAsB,UAAU,GAAG;AAErD,SAAO;;;;;;;CAQT,AAAU,kBAAkB,IAAuB,cAA2C;AAC5F,MAAI,CAAC,aACH;AAGF,MAAI,OAAO,OAAO,SAChB,OAAM,IAAI,MACR,2GACD;AAGH,SAAO,GAAG;;;;;CAMZ,AAAU,cAAc,IAA+B;AACrD,SAAO,OAAO,OAAO,WAAW,KAAK,GAAG;;;;;CAM1C,AAAU,qBACR,QACA,aACA,WACQ;AAER,SADiB,KAAK,kBAAkB,QAAQ,aAAa,KAAK,CAClD,aAAa,YAAY;;;;;;;;;;;AAY7C,SAAgB,uCACd,mBAC6B;AAC7B,QAAO;EACL,0BAA0B,IAA0D;AAClF,WAAQ,GAAG,MAAX;IACE,KAAK,QACH,QAAO,kBAAkB,aAAa,GAAG;IAC3C,KAAK,OACH,QAAO,kBAAkB,YAAY,GAAG;IAC1C,SAAS;KACP,MAAME,kBAAyB;AAC/B,WAAM,IAAI,MACR,qCAAsC,gBAAkD,OACzF;;;;EAKP,yBACE,IACyC;AACzC,WAAQ,GAAG,MAAX;IACE,KAAK,SACH,QAAO,kBAAkB,cAAc,GAAG;IAC5C,KAAK,SACH,QAAO,kBAAkB,cAAc,GAAG;IAC5C,KAAK,SACH,QAAO,kBAAkB,cAAc,GAAG;IAC5C,KAAK,QACH,QAAO,kBAAkB,aAAa,GAAG;IAC3C,SAAS;KACP,MAAMA,kBAAyB;AAC/B,WAAM,IAAI,MACR,oCAAqC,gBAAiD,OACvF;;;;EAIR"}
+{"version":3,"file":"uow-operation-compiler.js","names":["#driverConfig","#resolverFactory","exhaustiveCheck: never"],"sources":["../../../src/adapters/shared/uow-operation-compiler.ts"],"sourcesContent":["import { createNamingResolver, type NamingResolver } from \"../../naming/sql-naming\";\nimport type { Condition } from \"../../query/condition-builder\";\nimport { Cursor } from \"../../query/cursor\";\nimport type {\n  CompiledMutation,\n  RetrievalOperation,\n  MutationOperation,\n  UOWCompiler,\n} from \"../../query/unit-of-work/unit-of-work\";\nimport type { AnyColumn, AnySchema, AnyTable, FragnoId } from \"../../schema/create\";\nimport type { DriverConfig } from \"../generic-sql/driver-config\";\n\n/**\n * Options for compiling a find operation with cursor pagination\n */\nexport interface FindCompilationOptions {\n  /** Index columns used for ordering */\n  indexColumns: AnyColumn[];\n  /** Order direction for the index */\n  orderDirection: \"asc\" | \"desc\";\n  /** User-provided where condition */\n  userWhere: Condition | boolean | undefined;\n  /** Cursor string or Cursor object for pagination (after) */\n  after?: string | Cursor;\n  /** Cursor string or Cursor object for pagination (before) */\n  before?: string | Cursor;\n  /** Page size for pagination */\n  pageSize?: number;\n  /** Whether this is a high-level cursor API call (affects limit calculation) */\n  withCursor?: boolean;\n  /** Driver config for cursor serialization */\n  driverConfig: DriverConfig;\n}\n\n/**\n * Result of cursor condition building\n */\nexport interface CursorConditionResult {\n  /** The combined where condition (user where + cursor condition) */\n  where: Condition | undefined;\n  /** The effective limit to use (may be pageSize + 1 for cursor detection) */\n  limit: number | undefined;\n}\n\n/**\n * Abstract base class for Unit of Work operation compilers\n *\n * This class provides a structure and utilities for implementing UOW compilers\n * for different ORM/query builders (Kysely, Drizzle, etc.).\n *\n * Subclasses must implement the abstract methods for each operation type,\n * and can use the provided utility methods for common tasks.\n *\n * @template TCompiledQuery - The type of compiled query for the target ORM\n */\nexport abstract class UOWOperationCompiler<TCompiledQuery> {\n  #driverConfig: DriverConfig;\n  #resolverFactory?: (schema: AnySchema, namespace: string | null) => NamingResolver;\n\n  constructor(\n    driverConfig: DriverConfig,\n    resolverFactory?: (schema: AnySchema, namespace: string | null) => NamingResolver,\n  ) {\n    this.#driverConfig = driverConfig;\n    this.#resolverFactory = resolverFactory;\n  }\n\n  protected get driverConfig(): DriverConfig {\n    return this.#driverConfig;\n  }\n\n  protected get resolverFactory():\n    | ((schema: AnySchema, namespace: string | null) => NamingResolver)\n    | undefined {\n    return this.#resolverFactory;\n  }\n\n  abstract compileCount(\n    op: RetrievalOperation<AnySchema> & { type: \"count\" },\n  ): TCompiledQuery | null;\n\n  abstract compileFind(op: RetrievalOperation<AnySchema> & { type: \"find\" }): TCompiledQuery | null;\n\n  /**\n   * Compile a create operation\n   */\n  abstract compileCreate(\n    op: MutationOperation<AnySchema> & { type: \"create\" },\n  ): CompiledMutation<TCompiledQuery> | null;\n\n  abstract compileUpdate(\n    op: MutationOperation<AnySchema> & { type: \"update\" },\n  ): CompiledMutation<TCompiledQuery> | null;\n\n  abstract compileDelete(\n    op: MutationOperation<AnySchema> & { type: \"delete\" },\n  ): CompiledMutation<TCompiledQuery> | null;\n\n  abstract compileCheck(\n    op: MutationOperation<AnySchema> & { type: \"check\" },\n  ): CompiledMutation<TCompiledQuery> | null;\n\n  // ==================== Utility Methods ====================\n\n  /**\n   * Get the mapper for a specific operation based on its namespace\n   */\n  protected getNamingResolver(\n    schema: AnySchema,\n    namespace: string | null | undefined,\n  ): NamingResolver {\n    if (this.#resolverFactory) {\n      return this.#resolverFactory(schema, namespace ?? null);\n    }\n    return createNamingResolver(\n      schema,\n      namespace ?? null,\n      this.#driverConfig.defaultNamingStrategy,\n    );\n  }\n\n  /**\n   * Get a table from a schema by name\n   * @throws Error if table is not found\n   */\n  protected getTable(schema: AnySchema, tableName: string): AnyTable {\n    const table = schema.tables[tableName];\n    if (!table) {\n      throw new Error(`Invalid table name ${tableName}.`);\n    }\n    return table;\n  }\n\n  /**\n   * Get the version to check for a given ID and checkVersion flag\n   * @returns The version to check or undefined if no check is required\n   * @throws Error if the ID is a string and checkVersion is true\n   */\n  protected getVersionToCheck(id: FragnoId | string, checkVersion: boolean): number | undefined {\n    if (!checkVersion) {\n      return undefined;\n    }\n\n    if (typeof id === \"string\") {\n      throw new Error(\n        `Cannot use checkVersion with a string ID. Version checking requires a FragnoId with version information.`,\n      );\n    }\n\n    return id.version;\n  }\n\n  /**\n   * Extract external ID from FragnoId or string\n   */\n  protected getExternalId(id: FragnoId | string): string {\n    return typeof id === \"string\" ? id : id.externalId;\n  }\n\n  /**\n   * Get the physical table name for an operation, applying namespace mapping if needed\n   */\n  protected getPhysicalTableName(\n    schema: AnySchema,\n    logicalName: string,\n    namespace: string | undefined,\n  ): string {\n    const resolver = this.getNamingResolver(schema, namespace ?? null);\n    return resolver.getTableName(logicalName);\n  }\n}\n\n/**\n * Creates a UOWCompiler from a UOWOperationCompiler by dispatching operations\n * to the appropriate specific compilation methods based on operation type.\n *\n * @template TCompiledQuery - The type of compiled query for the target ORM\n * @param operationCompiler - The operation compiler to wrap\n * @returns A UOWCompiler instance that delegates to the operation compiler\n */\nexport function createUOWCompilerFromOperationCompiler<TCompiledQuery>(\n  operationCompiler: UOWOperationCompiler<TCompiledQuery>,\n): UOWCompiler<TCompiledQuery> {\n  return {\n    compileRetrievalOperation(op: RetrievalOperation<AnySchema>): TCompiledQuery | null {\n      switch (op.type) {\n        case \"count\":\n          return operationCompiler.compileCount(op);\n        case \"find\":\n          return operationCompiler.compileFind(op);\n        default: {\n          const exhaustiveCheck: never = op;\n          throw new Error(\n            `Unknown retrieval operation type: ${(exhaustiveCheck as RetrievalOperation<AnySchema>).type}`,\n          );\n        }\n      }\n    },\n\n    compileMutationOperation(\n      op: MutationOperation<AnySchema>,\n    ): CompiledMutation<TCompiledQuery> | null {\n      switch (op.type) {\n        case \"create\":\n          return operationCompiler.compileCreate(op);\n        case \"update\":\n          return operationCompiler.compileUpdate(op);\n        case \"delete\":\n          return operationCompiler.compileDelete(op);\n        case \"check\":\n          return operationCompiler.compileCheck(op);\n        default: {\n          const exhaustiveCheck: never = op;\n          throw new Error(\n            `Unknown mutation operation type: ${(exhaustiveCheck as MutationOperation<AnySchema>).type}`,\n          );\n        }\n      }\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;AAuDA,IAAsB,uBAAtB,MAA2D;CACzD;CACA;CAEA,YACE,cACA,iBACA;AACA,QAAKA,eAAgB;AACrB,QAAKC,kBAAmB;;CAG1B,IAAc,eAA6B;AACzC,SAAO,MAAKD;;CAGd,IAAc,kBAEA;AACZ,SAAO,MAAKC;;;;;CAiCd,AAAU,kBACR,QACA,WACgB;AAChB,MAAI,MAAKA,gBACP,QAAO,MAAKA,gBAAiB,QAAQ,aAAa,KAAK;AAEzD,SAAO,qBACL,QACA,aAAa,MACb,MAAKD,aAAc,sBACpB;;;;;;CAOH,AAAU,SAAS,QAAmB,WAA6B;EACjE,MAAM,QAAQ,OAAO,OAAO;AAC5B,MAAI,CAAC,MACH,OAAM,IAAI,MAAM,sBAAsB,UAAU,GAAG;AAErD,SAAO;;;;;;;CAQT,AAAU,kBAAkB,IAAuB,cAA2C;AAC5F,MAAI,CAAC,aACH;AAGF,MAAI,OAAO,OAAO,SAChB,OAAM,IAAI,MACR,2GACD;AAGH,SAAO,GAAG;;;;;CAMZ,AAAU,cAAc,IAA+B;AACrD,SAAO,OAAO,OAAO,WAAW,KAAK,GAAG;;;;;CAM1C,AAAU,qBACR,QACA,aACA,WACQ;AAER,SADiB,KAAK,kBAAkB,QAAQ,aAAa,KAAK,CAClD,aAAa,YAAY;;;;;;;;;;;AAY7C,SAAgB,uCACd,mBAC6B;AAC7B,QAAO;EACL,0BAA0B,IAA0D;AAClF,WAAQ,GAAG,MAAX;IACE,KAAK,QACH,QAAO,kBAAkB,aAAa,GAAG;IAC3C,KAAK,OACH,QAAO,kBAAkB,YAAY,GAAG;IAC1C,SAAS;KACP,MAAME,kBAAyB;AAC/B,WAAM,IAAI,MACR,qCAAsC,gBAAkD,OACzF;;;;EAKP,yBACE,IACyC;AACzC,WAAQ,GAAG,MAAX;IACE,KAAK,SACH,QAAO,kBAAkB,cAAc,GAAG;IAC5C,KAAK,SACH,QAAO,kBAAkB,cAAc,GAAG;IAC5C,KAAK,SACH,QAAO,kBAAkB,cAAc,GAAG;IAC5C,KAAK,QACH,QAAO,kBAAkB,aAAa,GAAG;IAC3C,SAAS;KACP,MAAMA,kBAAyB;AAC/B,WAAM,IAAI,MACR,oCAAqC,gBAAiD,OACvF;;;;EAIR"}

package/dist/browser/adapters/adapters.d.ts

@@ -0,0 +1,61 @@
+import { AnySchema } from "../schema/create.js";
+import { SqlNamingStrategy } from "../naming/sql-naming.js";
+import { SQLiteStorageMode } from "./generic-sql/sqlite-storage.js";
+import { IUnitOfWork } from "../query/unit-of-work/unit-of-work.js";
+import { SimpleQueryInterface } from "../query/simple-query-interface.js";
+import { SQLProvider } from "../shared/providers.js";
+import { PreparedMigrations } from "./generic-sql/migration/prepared-migrations.js";
+import { RequestContextStorage } from "@fragno-dev/core/internal/request-context-storage";
+
+//#region src/adapters/adapters.d.ts
+declare const fragnoDatabaseAdapterNameFakeSymbol: "$fragno-database-adapter-name";
+declare const fragnoDatabaseAdapterVersionFakeSymbol: "$fragno-database-adapter-version";
+/**
+ * Storage type for database context - stores the Unit of Work.
+ * This is shared across all fragments using the same adapter.
+ */
+type DatabaseContextStorage = {
+  uow: IUnitOfWork;
+};
+type SQLiteProfile = "default" | "prisma";
+interface DatabaseAdapterMetadata {
+  databaseType?: SQLProvider;
+  sqliteProfile?: SQLiteProfile;
+  sqliteStorageMode?: SQLiteStorageMode;
+}
+interface DatabaseAdapter<TUOWConfig = void> {
+  [fragnoDatabaseAdapterNameFakeSymbol]: string;
+  [fragnoDatabaseAdapterVersionFakeSymbol]: number;
+  /**
+   * Request context storage shared across all fragments using this adapter.
+   * This allows multiple fragments to participate in the same Unit of Work.
+   */
+  readonly contextStorage: RequestContextStorage<DatabaseContextStorage>;
+  /**
+   * Optional adapter override used for durable hook processing.
+   * Use this when the public adapter wraps another adapter (e.g. model checker).
+   */
+  getHookProcessingAdapter?: () => DatabaseAdapter<TUOWConfig>;
+  /**
+   * Get current schema version, undefined if not initialized.
+   */
+  getSchemaVersion(namespace: string): Promise<string | undefined>;
+  /**
+   * Optional metadata used by schema output tooling.
+   */
+  readonly adapterMetadata?: DatabaseAdapterMetadata;
+  /**
+   * Naming strategy used for physical SQL identifiers.
+   */
+  readonly namingStrategy: SqlNamingStrategy;
+  /**
+   * @deprecated Avoid using query engines directly in fragment code. Prefer handlerTx/serviceTx.
+   */
+  createQueryEngine: <const T extends AnySchema>(schema: T, namespace: string | null) => SimpleQueryInterface<T, TUOWConfig>;
+  prepareMigrations?: <const T extends AnySchema>(schema: T, namespace: string | null) => PreparedMigrations;
+  isConnectionHealthy: () => Promise<boolean>;
+  close: () => Promise<void>;
+}
+//#endregion
+export { DatabaseAdapter };
+//# sourceMappingURL=adapters.d.ts.map

package/dist/browser/adapters/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","names":[],"sources":["../../../src/adapters/adapters.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAUa;cACA;AADb;AACA;AAMA;AAIA;AAEiB,KANL,sBAAA,GAM4B;EACvB,GAAA,EANV,WAMU;CACC;AACI,KALV,aAAA,GAKU,SAAA,GAAA,QAAA;AAAiB,UAHtB,uBAAA,CAGsB;EAGtB,YAAA,CAAA,EALA,WAKe;EAC7B,aAAA,CAAA,EALe,aAKf;EACA,iBAAA,CAAA,EALmB,iBAKnB;;AAMwB,UARV,eAQU,CAAA,aAAA,IAAA,CAAA,CAAA;EAMwB,CAbhD,mCAAA,CAagD,EAAA,MAAA;EAAhB,CAZhC,sCAAA,CAYgC,EAAA,MAAA;EAKI;;;;EAgB3B,SAAA,cAAA,EA3Be,qBA2Bf,CA3BqC,sBA2BrC,CAAA;EAEgB;;;;EAGhB,wBAAA,CAAA,EAAA,GAAA,GA1BuB,eA0BvB,CA1BuC,UA0BvC,CAAA;EAEL;;;EAIe,gBAAA,CAAA,SAAA,EAAA,MAAA,CAAA,EA3BiB,OA2BjB,CAAA,MAAA,GAAA,SAAA,CAAA;;;;6BAtBO;;;;2BAKF;;;;sCAKW,mBAC1B,gCAEL,qBAAqB,GAAG;uCAEQ,mBAC3B,gCAEL;6BAEsB;eAEd"}

package/dist/browser/adapters/generic-sql/migration/executor.d.ts

@@ -0,0 +1,15 @@
+import { CompiledQuery } from "kysely";
+
+//#region src/adapters/generic-sql/migration/executor.d.ts
+
+/**
+ * Compiled migration containing all SQL statements to execute.
+ */
+interface CompiledMigration {
+  statements: CompiledQuery[];
+  fromVersion: number;
+  toVersion: number;
+}
+//#endregion
+export { CompiledMigration };
+//# sourceMappingURL=executor.d.ts.map

package/dist/browser/adapters/generic-sql/migration/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","names":[],"sources":["../../../../../src/adapters/generic-sql/migration/executor.ts"],"sourcesContent":[],"mappings":";;;;;AAOA;;UAAiB,iBAAA;cACH"}

package/dist/browser/adapters/generic-sql/migration/prepared-migrations.d.ts

@@ -0,0 +1,66 @@
+import { SqlDriverAdapter } from "../../../sql-driver/sql-driver-adapter.js";
+import { CompiledMigration } from "./executor.js";
+
+//#region src/adapters/generic-sql/migration/prepared-migrations.d.ts
+
+/**
+ * Options for executing a migration.
+ */
+interface ExecuteOptions {
+  /**
+   * Whether to automatically update the schema version in the database after migration.
+   * If not specified, uses the value from PreparedMigrationsConfig.
+   */
+  updateVersionInMigration?: boolean;
+}
+/**
+ * Interface for preparing and executing migrations.
+ * Provides a clean separation between compilation (SQL generation) and execution.
+ */
+interface PreparedMigrations {
+  /**
+   * Execute migration from one version to another.
+   * This performs all three phases:
+   * - Phase 1: schema → operations
+   * - Phase 2: operations → SQL
+   * - Phase 3: SQL → database
+   *
+   * @param fromVersion - Current database version (0 for new database)
+   * @param toVersion - Target schema version (defaults to schema.version)
+   * @param options - Optional execution options (overrides config defaults)
+   */
+  execute(fromVersion: number, toVersion?: number, options?: ExecuteOptions): Promise<void>;
+  /**
+   * Execute migration using a specific driver.
+   * Useful for testing or when you need to use a different driver than the one provided in config.
+   *
+   * @param driver - SQL driver to use for execution
+   * @param fromVersion - Current database version (0 for new database)
+   * @param toVersion - Target schema version (defaults to schema.version)
+   * @param options - Optional execution options (overrides config defaults)
+   */
+  executeWithDriver(driver: SqlDriverAdapter, fromVersion: number, toVersion?: number, options?: ExecuteOptions): Promise<void>;
+  /**
+   * Get the SQL for a migration from one version to another without executing it.
+   * Useful for generating migration files or previewing changes.
+   *
+   * @param fromVersion - Current database version (0 for new database)
+   * @param toVersion - Target schema version (defaults to schema.version)
+   * @param options - Optional execution options (affects version update SQL)
+   * @returns SQL string for the migration
+   */
+  getSQL(fromVersion: number, toVersion?: number, options?: ExecuteOptions): string;
+  /**
+   * Get the compiled migration for a version range.
+   * Returns both the SQL statements and the version information.
+   *
+   * @param fromVersion - Current database version (0 for new database)
+   * @param toVersion - Target schema version (defaults to schema.version)
+   * @param options - Optional execution options (affects version update SQL)
+   * @returns Compiled migration with statements and version info
+   */
+  compile(fromVersion: number, toVersion?: number, options?: ExecuteOptions): CompiledMigration;
+}
+//#endregion
+export { PreparedMigrations };
+//# sourceMappingURL=prepared-migrations.d.ts.map

package/dist/browser/adapters/generic-sql/migration/prepared-migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepared-migrations.d.ts","names":[],"sources":["../../../../../src/adapters/generic-sql/migration/prepared-migrations.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAwDc,UAvCG,cAAA,CAuCH;EACT;;;;EAsB0F,wBAAA,CAAA,EAAA,OAAA;;;;;;UAlD9E,kBAAA;;;;;;;;;;;;6DAY4C,iBAAiB;;;;;;;;;;4BAYlE,qEAGE,iBACT;;;;;;;;;;4DAWuD;;;;;;;;;;6DAWC,iBAAiB"}

package/dist/browser/adapters/generic-sql/sqlite-storage.d.ts

@@ -0,0 +1,11 @@
+//#region src/adapters/generic-sql/sqlite-storage.d.ts
+type SQLiteDateStorage = "epoch-ms" | "iso-text";
+type SQLiteBigintStorage = "blob" | "integer";
+interface SQLiteStorageMode {
+  timestampStorage: SQLiteDateStorage;
+  dateStorage: SQLiteDateStorage;
+  bigintStorage: SQLiteBigintStorage;
+}
+//#endregion
+export { SQLiteStorageMode };
+//# sourceMappingURL=sqlite-storage.d.ts.map

package/dist/browser/adapters/generic-sql/sqlite-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-storage.d.ts","names":[],"sources":["../../../../src/adapters/generic-sql/sqlite-storage.ts"],"sourcesContent":[],"mappings":";KAAY,iBAAA;AAAA,KACA,mBAAA,GADiB,MAAA,GAAA,SAAA;AACjB,UAEK,iBAAA,CAFc;EAEd,gBAAA,EACG,iBADc;EACd,WAAA,EACL,iBADK;EACL,aAAA,EACE,mBADF"}

package/dist/browser/adapters/in-memory/in-memory-adapter.d.ts

@@ -0,0 +1,5 @@
+import "../../query/unit-of-work/unit-of-work.js";
+import "../../query/simple-query-interface.js";
+import "../adapters.js";
+import "./options.js";
+import { RequestContextStorage } from "@fragno-dev/core/internal/request-context-storage";

package/dist/browser/adapters/in-memory/index.d.ts

@@ -0,0 +1,2 @@
+import "./options.js";
+import "./in-memory-adapter.js";

package/dist/browser/adapters/in-memory/options.d.ts

@@ -0,0 +1 @@
+import "../../outbox/outbox.js";

package/dist/browser/db-fragment-definition-builder.d.ts

@@ -0,0 +1,237 @@
+import { AnySchema } from "./schema/create.js";
+import { AwaitedPromisesInObject, ExecuteTxOptions, ExtractServiceFinalResults, HandlerTxBuilder, ServiceTxBuilder, TxResult } from "./query/unit-of-work/execute-unit-of-work.js";
+import { SyncCommandRegistry, SyncCommandTargetRegistration } from "./sync/types.js";
+import { InternalFragmentInstance } from "./fragments/internal-fragment.js";
+import { DurableHooksProcessingOptions, HookContext, HookFn, HooksMap } from "./hooks/hooks.js";
+import { IUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
+import { DatabaseAdapter } from "./adapters/adapters.js";
+import { AnyRouteOrFactory, BoundServices, FragmentDefinition, FragmentDefinitionBuilder, FragnoPublicConfig, RequestThisContext, ServiceConstructorFn } from "@fragno-dev/core";
+
+//#region src/db-fragment-definition-builder.d.ts
+type RegistrySchemaInfo = {
+  name: string;
+  namespace: string | null;
+  version: number;
+  tables: string[];
+};
+type RegistryFragmentMeta = {
+  name: string;
+  mountRoute: string;
+};
+type ExtractServiceFinalResultOrSingle<T> = T extends readonly (TxResult<unknown, unknown> | undefined)[] ? AwaitedPromisesInObject<ExtractServiceFinalResults<T>> : T extends undefined ? undefined : AwaitedPromisesInObject<ExtractServiceFinalResults<readonly [T]>>[0];
+type RegistryResolver = {
+  getRegistryForAdapterSync: <TUOWConfig>(adapter: DatabaseAdapter<TUOWConfig>) => {
+    registerSchema: (schema: RegistrySchemaInfo, fragment: RegistryFragmentMeta, options?: {
+      outboxEnabled?: boolean;
+    }) => void;
+    registerSyncCommands: (registration: SyncCommandTargetRegistration) => void;
+  };
+  getInternalFragment: <TUOWConfig>(adapter: DatabaseAdapter<TUOWConfig>) => InternalFragmentInstance;
+};
+type HooksFactoryContext<TConfig> = {
+  config: TConfig;
+  options: FragnoPublicConfigWithDatabase;
+  deps: unknown;
+  services: unknown;
+  serviceDeps: unknown;
+};
+/**
+ * Extended FragnoPublicConfig for database fragments.
+ * If databaseAdapter is omitted and better-sqlite3 is available, a default SQLite adapter is used.
+ */
+type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {
+  databaseAdapter?: DatabaseAdapter<any>;
+  /**
+   * Optional guard to limit database roundtrips per request (primarily for tests).
+   * When enabled, retrieve-only and mutate-only handlerTx().execute() calls are
+   * counted separately (one of each by default).
+   * Applied only for route handlers (not inContext).
+   */
+  dbRoundtripGuard?: boolean | DbRoundtripGuardConfig;
+  /**
+   * Optional outbox configuration for this fragment.
+   */
+  outbox?: {
+    enabled?: boolean;
+  };
+  /**
+   * Optional durable hooks processing configuration.
+   */
+  durableHooks?: DurableHooksProcessingOptions;
+  /**
+   * Optional override for database namespace. If provided (including null), it is used as-is
+   * without sanitization — the caller is responsible for providing a valid namespace.
+   * When omitted, defaults to a sanitized version of schema.name.
+   */
+  databaseNamespace?: string | null;
+};
+/**
+ * Configuration for limiting database roundtrips per request.
+ */
+type DbRoundtripGuardConfig = {
+  /**
+   * Maximum allowed retrieve-only and mutate-only handlerTx().execute() calls per request.
+   * Each type is tracked separately.
+   * Defaults to 1 when the guard is enabled.
+   */
+  maxRoundtrips?: number;
+};
+/**
+ * Implicit dependencies that database fragments get automatically.
+ * These are injected without requiring explicit configuration.
+ */
+type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {
+  /**
+   * Database adapter instance.
+   */
+  databaseAdapter: DatabaseAdapter<any>;
+  /**
+   * The schema definition for this fragment.
+   */
+  schema: TSchema;
+  /**
+   * The database namespace for this fragment.
+   */
+  namespace: string | null;
+  /**
+   * Create a new Unit of Work for database operations.
+   */
+  createUnitOfWork: () => IUnitOfWork;
+};
+/**
+ * Service context for database fragments - provides restricted UOW access without execute methods.
+ */
+type DatabaseServiceContext<THooks extends HooksMap> = RequestThisContext & {
+  /**
+   * Create a service-level transaction builder using the fluent API.
+   * Returns a builder that can be chained with withServiceCalls, retrieve,
+   * transformRetrieve, mutate, transform, and build.
+   *
+   * @example
+   * ```ts
+   * return this.serviceTx(schema)
+   *   .withServiceCalls(() => [otherService.getData()])
+   *   .retrieve((uow) => uow.find("users", ...))
+   *   .transformRetrieve(([users]) => users[0])
+   *   .mutate(({ uow, retrieveResult, serviceIntermediateResult }) =>
+   *     uow.create("records", { ... })
+   *   )
+   *   .transform(({ mutateResult, serviceResult }) => ({ id: mutateResult }))
+   *   .build();
+   * ```
+   */
+  serviceTx<TSchema extends AnySchema>(schema: TSchema): ServiceTxBuilder<TSchema, readonly [], [], [], unknown, unknown, false, false, false, false, THooks>;
+};
+/**
+ * Handler context for database fragments - provides UOW execution with automatic retry support.
+ */
+type DatabaseHandlerContext<THooks extends HooksMap = {}> = RequestThisContext & {
+  /**
+   * Create a handler-level transaction builder using the fluent API.
+   * Returns a builder that can be chained with withServiceCalls, retrieve,
+   * transformRetrieve, mutate, transform, and execute.
+   *
+   * @example
+   * ```ts
+   * const result = await this.handlerTx()
+   *   .withServiceCalls(() => [userService.getUser(id)])
+   *   .mutate(({ forSchema, idempotencyKey, currentAttempt, serviceIntermediateResult }) => {
+   *     return forSchema(ordersSchema).create("orders", { ... });
+   *   })
+   *   .transform(({ mutateResult, serviceResult }) => ({ ... }))
+   *   .execute();
+   * ```
+   */
+  handlerTx(options?: Omit<ExecuteTxOptions, "createUnitOfWork">): HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, THooks>;
+  /**
+   * Execute multiple service calls in a handler context and return their final results.
+   */
+  callServices<TServiceCalls extends TxResult<unknown, unknown> | undefined | readonly (TxResult<unknown, unknown> | undefined)[]>(
+  /**
+   * Factory to create service calls inside the active context.
+   */
+  serviceCalls: () => TServiceCalls): Promise<ExtractServiceFinalResultOrSingle<TServiceCalls>>;
+};
+/**
+ * Storage type for database fragments - stores the Unit of Work.
+ */
+type DatabaseRequestStorage = {
+  uow: IUnitOfWork;
+};
+/**
+ * Builder for database fragments that wraps the core fragment builder
+ * and provides database-specific functionality.
+ *
+ * Database fragments use FragnoPublicConfigWithDatabase and default the adapter when possible.
+ */
+declare class DatabaseFragmentDefinitionBuilder<TSchema extends AnySchema, TConfig, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, THooks extends HooksMap = {}, TServiceThisContext extends RequestThisContext = DatabaseHandlerContext, THandlerThisContext extends RequestThisContext = DatabaseHandlerContext, TInternalRoutes extends readonly AnyRouteOrFactory[] = readonly []> {
+  #private;
+  constructor(baseBuilder: FragmentDefinitionBuilder<TConfig, FragnoPublicConfigWithDatabase, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, TServiceThisContext, THandlerThisContext, DatabaseRequestStorage, TInternalRoutes>, schema: TSchema, hooksFactory?: (context: HooksFactoryContext<TConfig>) => THooks, syncRegistry?: SyncCommandRegistry, registryResolver?: RegistryResolver);
+  /**
+   * Define dependencies for this database fragment.
+   * The context includes the database adapter.
+   */
+  withDependencies<TNewDeps>(fn: (context: {
+    config: TConfig;
+    options: FragnoPublicConfigWithDatabase;
+    databaseAdapter: DatabaseAdapter<any>;
+  }) => TNewDeps): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TNewDeps & ImplicitDatabaseDependencies<TSchema>, {}, {}, TServiceDependencies, {}, THooks, TServiceThisContext, THandlerThisContext, TInternalRoutes>;
+  providesBaseService<TNewService>(fn: ServiceConstructorFn<TConfig, FragnoPublicConfigWithDatabase, TDeps, TServiceDependencies, TPrivateServices, TNewService, TServiceThisContext>): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TNewService, TServices, TServiceDependencies, TPrivateServices, THooks, TServiceThisContext, THandlerThisContext, TInternalRoutes>;
+  providesService<TServiceName extends string, TService>(serviceName: TServiceName, fn: ServiceConstructorFn<TConfig, FragnoPublicConfigWithDatabase, TDeps, TServiceDependencies, TPrivateServices, TService, TServiceThisContext>): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TBaseServices, TServices & { [K in TServiceName]: TService }, TServiceDependencies, TPrivateServices, THooks, TServiceThisContext, THandlerThisContext, TInternalRoutes>;
+  /**
+   * Provide a private service that is only accessible to the fragment author.
+   * Private services are NOT exposed on the fragment instance, but can be used
+   * when defining other services (baseServices, namedServices, and other privateServices).
+   * Private services are instantiated in order, so earlier private services are available
+   * to later ones.
+   */
+  providesPrivateService<TServiceName extends string, TService>(serviceName: TServiceName, fn: ServiceConstructorFn<TConfig, FragnoPublicConfigWithDatabase, TDeps, TServiceDependencies, TPrivateServices, TService, TServiceThisContext>): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices & { [K in TServiceName]: TService }, THooks, TServiceThisContext, THandlerThisContext, TInternalRoutes>;
+  /**
+   * Define durable hooks for this fragment.
+   * Hooks are automatically persisted and retried on failure.
+   *
+   * @param fn - Function that receives defineHook helper and returns a hooks map
+   * @returns Builder with hooks type set
+   *
+   * @example
+   * ```ts
+   * .provideHooks(({ defineHook, config }) => ({
+   *   onSubscribe: defineHook(async function (payload: { email: string }) {
+   *     // 'this' context available (HookServiceContext with idempotencyKey)
+   *     await config.onSubscribe?.(payload.email);
+   *   }),
+   * }))
+   * ```
+   */
+  provideHooks<TNewHooks extends HooksMap>(fn: (context: {
+    config: TConfig;
+    options: FragnoPublicConfigWithDatabase;
+    deps: TDeps;
+    services: BoundServices<TBaseServices & TServices>;
+    serviceDeps: TServiceDependencies;
+    defineHook: <TPayload>(hook: (this: HookContext, payload: TPayload) => void | Promise<void>) => HookFn<TPayload>;
+  }) => TNewHooks): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, TNewHooks, DatabaseServiceContext<TNewHooks>, THandlerThisContext, TInternalRoutes>;
+  /**
+   * Register sync command definitions for this fragment.
+   */
+  withSyncCommands(registry: SyncCommandRegistry): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, THooks, TServiceThisContext, THandlerThisContext, TInternalRoutes>;
+  /**
+   * Declare that this fragment uses a required service provided by the runtime.
+   * Delegates to the base builder.
+   */
+  usesService<TServiceName extends string, TService>(serviceName: TServiceName): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TBaseServices, TServices, TServiceDependencies & { [K in TServiceName]: TService }, TPrivateServices, THooks, TServiceThisContext, THandlerThisContext, TInternalRoutes>;
+  /**
+   * Declare that this fragment uses an optional service provided by the runtime.
+   * Delegates to the base builder.
+   */
+  usesOptionalService<TServiceName extends string, TService>(serviceName: TServiceName): DatabaseFragmentDefinitionBuilder<TSchema, TConfig, TDeps, TBaseServices, TServices, TServiceDependencies & { [K in TServiceName]: TService | undefined }, TPrivateServices, THooks, TServiceThisContext, THandlerThisContext, TInternalRoutes>;
+  /**
+   * Build the final database fragment definition.
+   * This includes the request context setup for UnitOfWork management.
+   * Note: TDeps already includes ImplicitDatabaseDependencies from withDatabase().
+   */
+  build(): FragmentDefinition<TConfig, FragnoPublicConfigWithDatabase, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, DatabaseServiceContext<THooks>, DatabaseHandlerContext<THooks>, DatabaseRequestStorage, TInternalRoutes>;
+}
+//#endregion
+export { DatabaseFragmentDefinitionBuilder, DatabaseHandlerContext, DatabaseRequestStorage, DatabaseServiceContext, DbRoundtripGuardConfig, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies };
+//# sourceMappingURL=db-fragment-definition-builder.d.ts.map

package/dist/browser/db-fragment-definition-builder.d.ts.map

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

package/dist/browser/durable-hooks.d.ts

@@ -0,0 +1,3 @@
+import "./fragments/internal-fragment.js";
+import "./hooks/hooks.js";
+import { AnyFragnoInstantiatedDatabaseFragment } from "./mod2.js";