@fragno-dev/db 0.2.2 → 0.4.1

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

@@ -1,3 +1,4 @@
+import { dbInterval, dbNow } from "../../query/db-now.js";
 import { UnitOfWork } from "../../query/unit-of-work/unit-of-work.js";
 
 //#region src/adapters/shared/from-unit-of-work-compiler.ts
@@ -26,6 +27,12 @@ var UpdateManySpecialBuilder = class {
 		this.#setValues = values;
 		return this;
 	}
+	now() {
+		return dbNow();
+	}
+	interval(input) {
+		return dbInterval(input);
+	}
 	getConfig() {
 		return {
 			indexName: this.#indexName,
@@ -62,36 +69,47 @@ var UpdateManySpecialBuilder = class {
 */
 function fromUnitOfWorkCompiler(schema, factory) {
 	const { compiler, executor, decoder, uowConfig, schemaNamespaceMap } = factory;
-	function createUOW(opts) {
-		const { onQuery,...restUowConfig } = opts.config ?? {};
-		return new UnitOfWork(compiler, executor, decoder, opts.name, {
+	function normalizeUowConfig(config) {
+		if (!config) return;
+		const { onQuery,...restUowConfig } = config;
+		return {
 			...restUowConfig,
 			onQuery: onQuery ? (query) => {
 				onQuery(isCompiledMutation(query) ? query.query : query);
 			} : void 0
-		}, schemaNamespaceMap).forSchema(schema);
+		};
+	}
+	function createBaseUow(opts) {
+		return new UnitOfWork(compiler, executor, decoder, opts.name, normalizeUowConfig(opts.config), schemaNamespaceMap);
+	}
+	function createUOW(opts) {
+		return createBaseUow(opts).forSchema(schema);
+	}
+	async function find(tableName, builderFn) {
+		const uow = createUOW({ config: uowConfig });
+		if (builderFn) uow.find(tableName, builderFn);
+		else uow.find(tableName);
+		const [result] = await uow.executeRetrieve();
+		return result ?? [];
+	}
+	async function findWithCursor(tableName, builderFn) {
+		const [result] = await createUOW({ config: uowConfig }).findWithCursor(tableName, builderFn).executeRetrieve();
+		return result;
+	}
+	async function findFirst(tableName, builderFn) {
+		const uow = createUOW({ config: uowConfig });
+		if (builderFn) uow.find(tableName, (b) => {
+			builderFn(b);
+			return b.pageSize(1);
+		});
+		else uow.find(tableName, (b) => b.whereIndex("primary").pageSize(1));
+		const [result] = await uow.executeRetrieve();
+		return result?.[0] ?? null;
 	}
 	return {
-		async find(tableName, builderFn) {
-			const uow = createUOW({ config: uowConfig });
-			uow.find(tableName, builderFn);
-			const [result] = await uow.executeRetrieve();
-			return result ?? [];
-		},
-		async findWithCursor(tableName, builderFn) {
-			const [result] = await createUOW({ config: uowConfig }).findWithCursor(tableName, builderFn).executeRetrieve();
-			return result;
-		},
-		async findFirst(tableName, builderFn) {
-			const uow = createUOW({ config: uowConfig });
-			if (builderFn) uow.find(tableName, (b) => {
-				builderFn(b);
-				return b.pageSize(1);
-			});
-			else uow.find(tableName, (b) => b.whereIndex("primary").pageSize(1));
-			const [result] = await uow.executeRetrieve();
-			return result?.[0] ?? null;
-		},
+		find,
+		findWithCursor,
+		findFirst,
 		async create(tableName, values) {
 			const uow = createUOW({ config: uowConfig });
 			uow.create(tableName, values);
@@ -163,6 +181,15 @@ function fromUnitOfWorkCompiler(schema, factory) {
 					...nestedUowConfig
 				}
 			});
+		},
+		createBaseUnitOfWork(name, nestedUowConfig) {
+			return createBaseUow({
+				name,
+				config: {
+					...uowConfig,
+					...nestedUowConfig
+				}
+			});
 		}
 	};
 }

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 { 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

@@ -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 { 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/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/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";