@fragno-dev/db 0.2.2 → 0.3.0

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  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}\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>;\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 { 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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"}

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

@@ -1,5 +1,5 @@
+import { createNamingResolver } from "../../naming/sql-naming.js";
 import "../../query/cursor.js";
-import { createTableNameMapper } from "./table-name-mapper.js";
 
 //#region src/adapters/shared/uow-operation-compiler.ts
 /**
@@ -15,22 +15,23 @@ import { createTableNameMapper } from "./table-name-mapper.js";
 */
 var UOWOperationCompiler = class {
 	#driverConfig;
-	#mapperFactory;
-	constructor(driverConfig, mapperFactory) {
+	#resolverFactory;
+	constructor(driverConfig, resolverFactory) {
 		this.#driverConfig = driverConfig;
-		this.#mapperFactory = mapperFactory;
+		this.#resolverFactory = resolverFactory;
 	}
 	get driverConfig() {
 		return this.#driverConfig;
 	}
-	get mapperFactory() {
-		return this.#mapperFactory;
+	get resolverFactory() {
+		return this.#resolverFactory;
 	}
 	/**
 	* Get the mapper for a specific operation based on its namespace
 	*/
-	getMapperForOperation(namespace) {
-		return this.#mapperFactory ? this.#mapperFactory(namespace) : namespace ? createTableNameMapper(namespace) : void 0;
+	getNamingResolver(schema, namespace) {
+		if (this.#resolverFactory) return this.#resolverFactory(schema, namespace ?? null);
+		return createNamingResolver(schema, namespace ?? null, this.#driverConfig.defaultNamingStrategy);
 	}
 	/**
 	* Get a table from a schema by name
@@ -60,9 +61,8 @@ var UOWOperationCompiler = class {
 	/**
 	* Get the physical table name for an operation, applying namespace mapping if needed
 	*/
-	getPhysicalTableName(logicalName, namespace) {
-		const mapper = this.getMapperForOperation(namespace);
-		return mapper ? mapper.toPhysical(logicalName) : logicalName;
+	getPhysicalTableName(schema, logicalName, namespace) {
+		return this.getNamingResolver(schema, namespace ?? null).getTableName(logicalName);
 	}
 };
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"uow-operation-compiler.js","names":["#driverConfig","#mapperFactory","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 { createTableNameMapper, type TableNameMapper } from \"./table-name-mapper\";\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  #mapperFactory?: (namespace: string | undefined) => TableNameMapper | undefined;\n\n  constructor(\n    driverConfig: DriverConfig,\n    mapperFactory?: (namespace: string | undefined) => TableNameMapper | undefined,\n  ) {\n    this.#driverConfig = driverConfig;\n    this.#mapperFactory = mapperFactory;\n  }\n\n  protected get driverConfig(): DriverConfig {\n    return this.#driverConfig;\n  }\n\n  protected get mapperFactory():\n    | ((namespace: string | undefined) => TableNameMapper | undefined)\n    | undefined {\n    return this.#mapperFactory;\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 getMapperForOperation(namespace: string | undefined): TableNameMapper | undefined {\n    return this.#mapperFactory\n      ? this.#mapperFactory(namespace)\n      : namespace\n        ? createTableNameMapper(namespace)\n        : undefined;\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(logicalName: string, namespace: string | undefined): string {\n    const mapper = this.getMapperForOperation(namespace);\n    return mapper ? mapper.toPhysical(logicalName) : 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,eACA;AACA,QAAKA,eAAgB;AACrB,QAAKC,gBAAiB;;CAGxB,IAAc,eAA6B;AACzC,SAAO,MAAKD;;CAGd,IAAc,gBAEA;AACZ,SAAO,MAAKC;;;;;CAiCd,AAAU,sBAAsB,WAA4D;AAC1F,SAAO,MAAKA,gBACR,MAAKA,cAAe,UAAU,GAC9B,YACE,sBAAsB,UAAU,GAChC;;;;;;CAOR,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,qBAAqB,aAAqB,WAAuC;EACzF,MAAM,SAAS,KAAK,sBAAsB,UAAU;AACpD,SAAO,SAAS,OAAO,WAAW,YAAY,GAAG;;;;;;;;;;;AAYrD,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,MAAMC,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 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"}

package/dist/adapters/sql/index.d.ts

@@ -0,0 +1,5 @@
+import { SQLiteStorageMode, sqliteStorageDefault, sqliteStoragePrisma } from "../generic-sql/sqlite-storage.js";
+import { OutboxConfig } from "../../outbox/outbox.js";
+import { SQLiteProfile } from "../adapters.js";
+import { SqlAdapter, SqlAdapterOptions, UnitOfWorkConfig, sqliteProfiles } from "../generic-sql/generic-sql-adapter.js";
+export { type OutboxConfig, type SQLiteProfile, type SQLiteStorageMode, SqlAdapter, type SqlAdapterOptions, type UnitOfWorkConfig, sqliteProfiles, sqliteStorageDefault, sqliteStoragePrisma };

package/dist/adapters/sql/index.js

@@ -0,0 +1,4 @@
+import { sqliteStorageDefault, sqliteStoragePrisma } from "../generic-sql/sqlite-storage.js";
+import { SqlAdapter, sqliteProfiles } from "../generic-sql/generic-sql-adapter.js";
+
+export { SqlAdapter, sqliteProfiles, sqliteStorageDefault, sqliteStoragePrisma };

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

@@ -1,6 +1,6 @@
 import { AnySchema } from "./schema/create.js";
 import { ExecuteTxOptions, HandlerTxBuilder, ServiceTxBuilder } from "./query/unit-of-work/execute-unit-of-work.js";
-import { HookContext, HookFn, HooksMap } from "./hooks/hooks.js";
+import { DurableHooksProcessingOptions, HookContext, HookFn, HooksMap } from "./hooks/hooks.js";
 import { IUnitOfWork } from "./query/unit-of-work/unit-of-work.js";
 import { SimpleQueryInterface } from "./query/simple-query-interface.js";
 import { DatabaseAdapter } from "./adapters/adapters.js";
@@ -9,11 +9,21 @@ import { AnyFragnoInstantiatedFragment, FragmentDefinition, FragmentDefinitionBu
 //#region src/db-fragment-definition-builder.d.ts
 
 /**
- * Extended FragnoPublicConfig that includes a database adapter.
- * Use this type when creating fragments with database support.
+ * 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>;
+  databaseAdapter?: DatabaseAdapter<any>;
+  /**
+   * 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;
 };
 /**
  * Implicit dependencies that database fragments get automatically.
@@ -22,6 +32,7 @@ type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {
 type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {
   /**
    * Database query engine for the fragment's schema.
+   * @deprecated Prefer handlerTx/serviceTx instead of direct db usage.
    */
   db: SimpleQueryInterface<TSchema>;
   /**
@@ -31,7 +42,7 @@ type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {
   /**
    * The database namespace for this fragment.
    */
-  namespace: string;
+  namespace: string | null;
   /**
    * Create a new Unit of Work for database operations.
    */
@@ -106,11 +117,11 @@ type DatabaseRequestStorage = {
  * Builder for database fragments that wraps the core fragment builder
  * and provides database-specific functionality.
  *
- * Database fragments always require FragnoPublicConfigWithDatabase (which includes databaseAdapter).
+ * 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, TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment> = {}> {
   #private;
-  constructor(baseBuilder: FragmentDefinitionBuilder<TConfig, FragnoPublicConfigWithDatabase, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, TServiceThisContext, THandlerThisContext, DatabaseRequestStorage, TLinkedFragments>, schema: TSchema, namespace?: string, hooksFactory?: (context: {
+  constructor(baseBuilder: FragmentDefinitionBuilder<TConfig, FragnoPublicConfigWithDatabase, TDeps, TBaseServices, TServices, TServiceDependencies, TPrivateServices, TServiceThisContext, THandlerThisContext, DatabaseRequestStorage, TLinkedFragments>, schema: TSchema, hooksFactory?: (context: {
     config: TConfig;
     options: FragnoPublicConfigWithDatabase;
   }) => THooks);

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

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

@@ -1,34 +1,37 @@
 import { createHandlerTxBuilder, createServiceTxBuilder } from "./query/unit-of-work/execute-unit-of-work.js";
-import { prepareHookMutations, processHooks } from "./hooks/hooks.js";
+import { createHookScheduler, prepareHookMutations } from "./hooks/hooks.js";
+import { sanitizeNamespace } from "./naming/sql-naming.js";
+import { resolveDatabaseAdapter } from "./util/default-database-adapter.js";
 
 //#region src/db-fragment-definition-builder.ts
 /**
 * Create database context from options.
 * This extracts the database adapter and creates the ORM instance.
 */
-function createDatabaseContext(options, schema, namespace) {
-	const databaseAdapter = options.databaseAdapter;
-	if (!databaseAdapter) throw new Error("Database fragment requires a database adapter to be provided in options.databaseAdapter");
+function createDatabaseContext(options, schema) {
+	const databaseAdapter = resolveDatabaseAdapter(options, schema);
+	const namespace = resolveDatabaseNamespace(options, schema);
 	return {
 		databaseAdapter,
 		db: databaseAdapter.createQueryEngine(schema, namespace)
 	};
 }
+function resolveDatabaseNamespace(options, schema) {
+	return options.databaseNamespace !== void 0 ? options.databaseNamespace ?? null : sanitizeNamespace(schema.name);
+}
 /**
 * Builder for database fragments that wraps the core fragment builder
 * and provides database-specific functionality.
 *
-* Database fragments always require FragnoPublicConfigWithDatabase (which includes databaseAdapter).
+* Database fragments use FragnoPublicConfigWithDatabase and default the adapter when possible.
 */
 var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder {
 	#baseBuilder;
 	#schema;
-	#namespace;
 	#hooksFactory;
-	constructor(baseBuilder, schema, namespace, hooksFactory) {
+	constructor(baseBuilder, schema, hooksFactory) {
 		this.#baseBuilder = baseBuilder;
 		this.#schema = schema;
-		this.#namespace = namespace ?? baseBuilder.name;
 		this.#hooksFactory = hooksFactory;
 	}
 	/**
@@ -37,7 +40,8 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 	*/
 	withDependencies(fn) {
 		const wrappedFn = (context) => {
-			const dbContext = createDatabaseContext(context.options, this.#schema, this.#namespace);
+			const dbContext = createDatabaseContext(context.options, this.#schema);
+			const namespace = resolveDatabaseNamespace(context.options, this.#schema);
 			const userDeps = fn({
 				config: context.config,
 				options: context.options,
@@ -48,7 +52,7 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 			const implicitDeps = {
 				db: dbContext.db,
 				schema: this.#schema,
-				namespace: this.#namespace,
+				namespace,
 				createUnitOfWork: createUow
 			};
 			return {
@@ -56,13 +60,13 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 				...implicitDeps
 			};
 		};
-		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.withDependencies(wrappedFn), this.#schema, this.#namespace, this.#hooksFactory);
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.withDependencies(wrappedFn), this.#schema, this.#hooksFactory);
 	}
 	providesBaseService(fn) {
-		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.providesBaseService(fn), this.#schema, this.#namespace, this.#hooksFactory);
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.providesBaseService(fn), this.#schema, this.#hooksFactory);
 	}
 	providesService(serviceName, fn) {
-		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.providesService(serviceName, fn), this.#schema, this.#namespace, this.#hooksFactory);
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.providesService(serviceName, fn), this.#schema, this.#hooksFactory);
 	}
 	/**
 	* Provide a private service that is only accessible to the fragment author.
@@ -72,7 +76,7 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 	* to later ones.
 	*/
 	providesPrivateService(serviceName, fn) {
-		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.providesPrivateService(serviceName, fn), this.#schema, this.#namespace, this.#hooksFactory);
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.providesPrivateService(serviceName, fn), this.#schema, this.#hooksFactory);
 	}
 	/**
 	* Define durable hooks for this fragment.
@@ -102,7 +106,7 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 				defineHook
 			});
 		};
-		const newBuilder = new DatabaseFragmentDefinitionBuilder(this.#baseBuilder, this.#schema, this.#namespace);
+		const newBuilder = new DatabaseFragmentDefinitionBuilder(this.#baseBuilder, this.#schema);
 		newBuilder.#hooksFactory = hooksFactory;
 		return newBuilder;
 	}
@@ -111,14 +115,14 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 	* Delegates to the base builder.
 	*/
 	usesService(serviceName) {
-		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.usesService(serviceName), this.#schema, this.#namespace, this.#hooksFactory);
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.usesService(serviceName), this.#schema, this.#hooksFactory);
 	}
 	/**
 	* Declare that this fragment uses an optional service provided by the runtime.
 	* Delegates to the base builder.
 	*/
 	usesOptionalService(serviceName) {
-		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.usesOptionalService(serviceName), this.#schema, this.#namespace, this.#hooksFactory);
+		return new DatabaseFragmentDefinitionBuilder(this.#baseBuilder.usesOptionalService(serviceName), this.#schema, this.#hooksFactory);
 	}
 	/**
 	* Build the final database fragment definition.
@@ -137,11 +141,12 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 					userDeps = {};
 				} else throw error;
 			}
-			const { db } = createDatabaseContext(context.options, this.#schema, this.#namespace);
+			const { db } = createDatabaseContext(context.options, this.#schema);
+			const namespace = resolveDatabaseNamespace(context.options, this.#schema);
 			const implicitDeps = {
 				db,
 				schema: this.#schema,
-				namespace: this.#namespace,
+				namespace,
 				createUnitOfWork: () => db.createUnitOfWork()
 			};
 			return {
@@ -150,57 +155,114 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 			};
 		};
 		const builderWithStorage = this.#baseBuilder.withExternalRequestStorage(({ options }) => {
-			return createDatabaseContext(options, this.#schema, this.#namespace).databaseAdapter.contextStorage;
+			return createDatabaseContext(options, this.#schema).databaseAdapter.contextStorage;
 		}).withRequestStorage(({ options }) => {
-			return { uow: createDatabaseContext(options, this.#schema, this.#namespace).db.createUnitOfWork() };
+			return { uow: createDatabaseContext(options, this.#schema).db.createUnitOfWork() };
 		});
 		const internalFragmentFactory = baseDef.linkedFragments?.["_fragno_internal"];
-		return {
-			...builderWithStorage.withThisContext(({ storage, config, options }) => {
-				const hooksConfig = this.#hooksFactory ? {
-					hooks: this.#hooksFactory({
-						config,
-						options
-					}),
-					namespace: this.#namespace,
-					internalFragment: internalFragmentFactory({
-						config,
-						options
-					})
-				} : void 0;
-				function serviceTx(schema) {
-					const uow = storage.getStore()?.uow;
-					if (!uow) throw new Error("No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.");
-					return createServiceTxBuilder(schema, uow, hooksConfig?.hooks);
-				}
-				const serviceContext = { serviceTx };
-				function handlerTx(execOptions) {
-					const currentStorage = storage.getStore();
-					if (!currentStorage) throw new Error("No storage in context. Handler must be called within a request context.");
+		const hooksConfigCache = /* @__PURE__ */ new WeakMap();
+		const createHooksConfig = (context) => {
+			if (!this.#hooksFactory) return;
+			const depsKey = typeof context.deps === "object" && context.deps !== null ? context.deps : void 0;
+			const cachedHooksConfig = depsKey ? hooksConfigCache.get(depsKey) : void 0;
+			if (cachedHooksConfig) return cachedHooksConfig;
+			const namespaceKey = resolveDatabaseNamespace(context.options, this.#schema) ?? this.#schema.name;
+			const durableHooksOptions = context.options.durableHooks;
+			const baseAdapter = resolveDatabaseAdapter(context.options, this.#schema);
+			const hookAdapter = baseAdapter.getHookProcessingAdapter?.() ?? baseAdapter;
+			const hookOptions = hookAdapter === baseAdapter ? context.options : {
+				...context.options,
+				databaseAdapter: hookAdapter
+			};
+			const dbContextForHooks = createDatabaseContext(hookOptions, this.#schema);
+			const hooksConfig = {
+				hooks: this.#hooksFactory(context),
+				namespace: namespaceKey,
+				internalFragment: internalFragmentFactory({
+					config: context.config,
+					options: hookOptions
+				}),
+				handlerTx: (execOptions) => {
 					const userOnBeforeMutate = execOptions?.onBeforeMutate;
 					const userOnAfterMutate = execOptions?.onAfterMutate;
 					return createHandlerTxBuilder({
 						...execOptions,
 						createUnitOfWork: () => {
-							currentStorage.uow.reset();
-							if (hooksConfig) currentStorage.uow.registerSchema(hooksConfig.internalFragment.$internal.deps.schema, hooksConfig.internalFragment.$internal.deps.namespace);
-							return currentStorage.uow;
+							const uow = dbContextForHooks.db.createUnitOfWork();
+							uow.registerSchema(hooksConfig.internalFragment.$internal.deps.schema, hooksConfig.internalFragment.$internal.deps.namespace);
+							return uow;
 						},
 						onBeforeMutate: (uow) => {
-							if (hooksConfig) prepareHookMutations(uow, hooksConfig);
+							prepareHookMutations(uow, hooksConfig);
 							if (userOnBeforeMutate) userOnBeforeMutate(uow);
 						},
 						onAfterMutate: async (uow) => {
-							if (hooksConfig) await processHooks(hooksConfig);
+							hooksConfig.scheduler?.schedule().catch((error) => {
+								console.error("Durable hooks processing failed", error);
+							});
 							if (userOnAfterMutate) await userOnAfterMutate(uow);
 						}
 					});
-				}
-				return {
-					serviceContext,
-					handlerContext: { handlerTx }
-				};
-			}).build(),
+				},
+				stuckProcessingTimeoutMinutes: durableHooksOptions?.stuckProcessingTimeoutMinutes,
+				onStuckProcessingHooks: durableHooksOptions?.onStuckProcessingHooks
+			};
+			hooksConfig.scheduler = createHookScheduler(hooksConfig);
+			if (depsKey) hooksConfigCache.set(depsKey, hooksConfig);
+			return hooksConfig;
+		};
+		const finalDef = builderWithStorage.withThisContext(({ storage, config, options, deps }) => {
+			const hooksConfig = createHooksConfig({
+				config,
+				options,
+				deps
+			});
+			const internalFragment = hooksConfig?.internalFragment ?? (internalFragmentFactory ? internalFragmentFactory({
+				config,
+				options
+			}) : void 0);
+			function serviceTx(schema) {
+				const uow = storage.getStore()?.uow;
+				if (!uow) throw new Error("No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.");
+				return createServiceTxBuilder(schema, uow, hooksConfig?.hooks);
+			}
+			const serviceContext = { serviceTx };
+			function handlerTx(execOptions) {
+				const currentStorage = storage.getStore();
+				if (!currentStorage) throw new Error("No storage in context. Handler must be called within a request context.");
+				const userOnBeforeMutate = execOptions?.onBeforeMutate;
+				const userOnAfterMutate = execOptions?.onAfterMutate;
+				return createHandlerTxBuilder({
+					...execOptions,
+					createUnitOfWork: () => {
+						currentStorage.uow.reset();
+						if (internalFragment) currentStorage.uow.registerSchema(internalFragment.$internal.deps.schema, internalFragment.$internal.deps.namespace);
+						return currentStorage.uow;
+					},
+					onBeforeMutate: (uow) => {
+						if (hooksConfig) prepareHookMutations(uow, hooksConfig);
+						if (userOnBeforeMutate) userOnBeforeMutate(uow);
+					},
+					onAfterMutate: async (uow) => {
+						if (hooksConfig?.scheduler) hooksConfig.scheduler.schedule().catch((error) => {
+							console.error("Durable hooks processing failed", error);
+						});
+						if (userOnAfterMutate) await userOnAfterMutate(uow);
+					}
+				});
+			}
+			return {
+				serviceContext,
+				handlerContext: { handlerTx }
+			};
+		}).build();
+		if (this.#hooksFactory) finalDef.internalDataFactory = ({ config, options, deps }) => ({ durableHooks: createHooksConfig({
+			config,
+			options,
+			deps
+		}) });
+		return {
+			...finalDef,
 			dependencies
 		};
 	}