@fragno-dev/db 0.2.1 → 0.3.0

package/dist/db-fragment-definition-builder.js

@@ -1,35 +1,37 @@
-import "./query/unit-of-work/unit-of-work.js";
-import { executeRestrictedUnitOfWork, executeServiceTx, executeTxArray, executeTxCallbacks } from "./query/unit-of-work/execute-unit-of-work.js";
-import { prepareHookMutations, processHooks } from "./hooks/hooks.js";
+import { createHandlerTxBuilder, createServiceTxBuilder } from "./query/unit-of-work/execute-unit-of-work.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;
 	}
 	/**
@@ -38,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,
@@ -49,7 +52,7 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 			const implicitDeps = {
 				db: dbContext.db,
 				schema: this.#schema,
-				namespace: this.#namespace,
+				namespace,
 				createUnitOfWork: createUow
 			};
 			return {
@@ -57,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.
@@ -73,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.
@@ -86,7 +89,7 @@ var DatabaseFragmentDefinitionBuilder = class DatabaseFragmentDefinitionBuilder
 	* ```ts
 	* .provideHooks(({ defineHook, config }) => ({
 	*   onSubscribe: defineHook(async function (payload: { email: string }) {
-	*     // 'this' context available (HookServiceContext with nonce)
+	*     // 'this' context available (HookServiceContext with idempotencyKey)
 	*     await config.onSubscribe?.(payload.email);
 	*   }),
 	* }))
@@ -103,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;
 	}
@@ -112,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.
@@ -138,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 {
@@ -151,96 +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 forSchema(schema) {
-					const uow$1 = storage.getStore()?.uow;
-					if (!uow$1) throw new Error("No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.");
-					return uow$1.restrict().forSchema(schema);
-				}
-				const serviceTx = async (schema, callbacks) => {
-					const uow$1 = storage.getStore()?.uow;
-					if (!uow$1) throw new Error("No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.");
-					return executeServiceTx(schema, callbacks, uow$1);
-				};
-				const serviceContext = {
-					uow: forSchema,
-					tx: serviceTx
-				};
-				async function uow(callback, execOptions) {
-					const currentStorage = storage.getStore();
-					if (!currentStorage) throw new Error("No storage in context. Handler must be called within a request context.");
-					const wrappedCallback = async (context) => {
-						return callback(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 userOnSuccess = execOptions?.onSuccess;
-					return executeRestrictedUnitOfWork(wrappedCallback, {
+					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$1) => {
-							if (hooksConfig) prepareHookMutations(uow$1, hooksConfig);
-							if (userOnBeforeMutate) userOnBeforeMutate(uow$1);
+						onBeforeMutate: (uow) => {
+							prepareHookMutations(uow, hooksConfig);
+							if (userOnBeforeMutate) userOnBeforeMutate(uow);
 						},
-						onSuccess: async (uow$1) => {
-							if (hooksConfig) await processHooks(hooksConfig);
-							if (userOnSuccess) await userOnSuccess(uow$1);
+						onAfterMutate: async (uow) => {
+							hooksConfig.scheduler?.schedule().catch((error) => {
+								console.error("Durable hooks processing failed", error);
+							});
+							if (userOnAfterMutate) await userOnAfterMutate(uow);
 						}
 					});
-				}
-				async function handlerTx(factoryOrCallbacks, 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 userOnSuccess = execOptions?.onSuccess;
-					const createUow = () => {
+				},
+				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 (hooksConfig) currentStorage.uow.registerSchema(hooksConfig.internalFragment.$internal.deps.schema, hooksConfig.internalFragment.$internal.deps.namespace);
+						if (internalFragment) currentStorage.uow.registerSchema(internalFragment.$internal.deps.schema, internalFragment.$internal.deps.namespace);
 						return currentStorage.uow;
-					};
-					const options$1 = {
-						...execOptions,
-						createUnitOfWork: createUow,
-						onBeforeMutate: (uow$1) => {
-							if (hooksConfig) prepareHookMutations(uow$1, hooksConfig);
-							if (userOnBeforeMutate) userOnBeforeMutate(uow$1);
-						},
-						onSuccess: async (uow$1) => {
-							if (hooksConfig) await processHooks(hooksConfig);
-							if (userOnSuccess) await userOnSuccess(uow$1);
-						}
-					};
-					if (typeof factoryOrCallbacks === "function") return executeTxArray(factoryOrCallbacks, options$1);
-					else return executeTxCallbacks(factoryOrCallbacks, options$1);
-				}
-				return {
-					serviceContext,
-					handlerContext: {
-						uow,
-						tx: handlerTx
+					},
+					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);
 					}
-				};
-			}).build(),
+				});
+			}
+			return {
+				serviceContext,
+				handlerContext: { handlerTx }
+			};
+		}).build();
+		if (this.#hooksFactory) finalDef.internalDataFactory = ({ config, options, deps }) => ({ durableHooks: createHooksConfig({
+			config,
+			options,
+			deps
+		}) });
+		return {
+			...finalDef,
 			dependencies
 		};
 	}

package/dist/db-fragment-definition-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"db-fragment-definition-builder.js","names":["#baseBuilder","#schema","#namespace","#hooksFactory","implicitDeps: ImplicitDatabaseDependencies<TSchema>","uow","serviceContext: DatabaseServiceContext<THooks>","options: ExecuteRestrictedUnitOfWorkOptions","options"],"sources":["../src/db-fragment-definition-builder.ts"],"sourcesContent":["import type { AnySchema } from \"./schema/create\";\nimport type { SimpleQueryInterface } from \"./query/simple-query-interface\";\nimport type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { IUnitOfWork } from \"./query/unit-of-work/unit-of-work\";\nimport { TypedUnitOfWork, UnitOfWork } from \"./query/unit-of-work/unit-of-work\";\nimport type {\n  RequestThisContext,\n  FragnoPublicConfig,\n  AnyFragnoInstantiatedFragment,\n} from \"@fragno-dev/core\";\nimport {\n  FragmentDefinitionBuilder,\n  type FragmentDefinition,\n  type ServiceConstructorFn,\n} from \"@fragno-dev/core\";\nimport {\n  executeRestrictedUnitOfWork,\n  executeTxArray,\n  executeTxCallbacks,\n  executeServiceTx,\n  type AwaitedPromisesInObject,\n  type ExecuteRestrictedUnitOfWorkOptions,\n  type HandlerTxCallbacks,\n  type ServiceTxCallbacks,\n} from \"./query/unit-of-work/execute-unit-of-work\";\nimport {\n  prepareHookMutations,\n  processHooks,\n  type HooksMap,\n  type HookFn,\n  type HookContext,\n} from \"./hooks/hooks\";\nimport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\n\n/**\n * Extended FragnoPublicConfig that includes a database adapter.\n * Use this type when creating fragments with database support.\n */\nexport type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  databaseAdapter: DatabaseAdapter<any>;\n};\n\n/**\n * Implicit dependencies that database fragments get automatically.\n * These are injected without requiring explicit configuration.\n */\nexport type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {\n  /**\n   * Database query engine for the fragment's schema.\n   */\n  db: SimpleQueryInterface<TSchema>;\n  /**\n   * The schema definition for this fragment.\n   */\n  schema: TSchema;\n  /**\n   * The database namespace for this fragment.\n   */\n  namespace: string;\n  /**\n   * Create a new Unit of Work for database operations.\n   */\n  createUnitOfWork: () => IUnitOfWork;\n};\n\n/**\n * Service context for database fragments - provides restricted UOW access without execute methods.\n */\nexport type DatabaseServiceContext<THooks extends HooksMap> = RequestThisContext & {\n  /**\n   * Get a typed, restricted Unit of Work for the given schema.\n   * @param schema - Schema to get a typed view for\n   * @returns TypedUnitOfWork (restricted version without execute methods)\n   */\n  uow<TSchema extends AnySchema>(schema: TSchema): TypedUnitOfWork<TSchema, [], unknown, THooks>;\n\n  /**\n   * Execute a transaction with two-phase callbacks (retrieve + mutate).\n   *\n   * @param schema - Schema to use for the transaction\n   * @param callbacks - Object containing retrieve and mutate callbacks\n   * @returns Promise resolving to the mutation result with promises awaited 1 level deep\n   *\n   * @example\n   * ```ts\n   * return this.tx(schema, {\n   *   retrieve: (uow) => uow.findFirst(\"users\", ...),\n   *   mutate: async (uow, [user]) => {\n   *     await validateUser(user);\n   *     uow.update(\"users\", user.id, ...).check();\n   *     return { ok: true };\n   *   }\n   * });\n   * ```\n   */\n  tx<TSchema extends AnySchema, TRetrievalResults extends unknown[], TMutationResult = void>(\n    schema: TSchema,\n    callbacks: ServiceTxCallbacks<TSchema, TRetrievalResults, TMutationResult, THooks>,\n  ): Promise<AwaitedPromisesInObject<TMutationResult>>;\n};\n\n/**\n * Handler context for database fragments - provides UOW execution with automatic retry support.\n */\nexport type DatabaseHandlerContext<THooks extends HooksMap = {}> = RequestThisContext & {\n  /**\n   * Execute a Unit of Work with explicit phase control and automatic retry support.\n   * This method provides an API where users call forSchema to create a schema-specific\n   * UOW, then call executeRetrieve() and executeMutate() to execute the phases. The entire\n   * callback is re-executed on optimistic concurrency conflicts, ensuring retries work properly.\n   * Automatically provides the UOW factory from context.\n   * Promises in the returned object are awaited 1 level deep.\n   *\n   * @param callback - Async function that receives a context with forSchema, executeRetrieve, executeMutate, nonce, and currentAttempt\n   * @param options - Optional configuration for retry policy and abort signal\n   * @returns Promise resolving to the callback's return value with promises awaited 1 level deep\n   * @throws Error if retries are exhausted or callback throws an error\n   *\n   * @example\n   * ```ts\n   * const result = await this.uow(async ({ forSchema, executeRetrieve, executeMutate, nonce, currentAttempt }) => {\n   *   const uow = forSchema(schema);\n   *   const userId = uow.create(\"users\", { name: \"John\" });\n   *\n   *   // Execute retrieval phase\n   *   await executeRetrieve();\n   *\n   *   const profileId = uow.create(\"profiles\", { userId });\n   *\n   *   // Execute mutation phase\n   *   await executeMutate();\n   *\n   *   return { userId, profileId };\n   * });\n   * ```\n   */\n  uow<TResult>(\n    callback: (context: {\n      forSchema: <TSchema extends AnySchema, H extends HooksMap = THooks>(\n        schema: TSchema,\n        hooks?: H,\n      ) => TypedUnitOfWork<TSchema, [], unknown, H>;\n      executeRetrieve: () => Promise<void>;\n      executeMutate: () => Promise<void>;\n      nonce: string;\n      currentAttempt: number;\n    }) => Promise<TResult> | TResult,\n    options?: Omit<ExecuteRestrictedUnitOfWorkOptions, \"createUnitOfWork\">,\n  ): Promise<AwaitedPromisesInObject<TResult>>;\n\n  /**\n   * Execute a transaction with automatic retry support.\n   * Provides two overloads: array syntax (common case) and callback syntax (advanced).\n   *\n   * Array syntax - pass a factory function that returns service calls:\n   * ```ts\n   * const [transfer, notify] = await this.tx(\n   *   () => [\n   *     services.transfer({ from, to, amount }),\n   *     services.notify({ userId, message })\n   *   ]\n   * );\n   * ```\n   *\n   * Callback syntax - for handlers that need direct UOW access:\n   * ```ts\n   * const result = await this.tx({\n   *   retrieve: ({ forSchema }) => {\n   *     const uow = forSchema(schema);\n   *     uow.find(\"users\", ...);\n   *     return services.transfer({ ... });\n   *   },\n   *   mutate: ({ forSchema }, transferPromise) => {\n   *     const uow = forSchema(schema);\n   *     uow.create(\"auditLog\", { ... });\n   *     return transferPromise;\n   *   }\n   * });\n   * ```\n   *\n   * Note: Handler callbacks are synchronous only to prevent accidentally awaiting services in wrong place.\n   */\n  // Overload 1: Array syntax (common case) - accepts a factory\n  tx<T extends readonly unknown[]>(\n    servicesFactory: () => readonly [...{ [K in keyof T]: Promise<T[K]> }],\n    options?: Omit<ExecuteRestrictedUnitOfWorkOptions, \"createUnitOfWork\">,\n  ): Promise<{ [K in keyof T]: T[K] }>;\n  // Overload 2: Callback syntax (advanced, sync callbacks only)\n  tx<TRetrieveResult, TMutationResult>(\n    callbacks: HandlerTxCallbacks<TRetrieveResult, TMutationResult, THooks>,\n    options?: Omit<ExecuteRestrictedUnitOfWorkOptions, \"createUnitOfWork\">,\n  ): Promise<AwaitedPromisesInObject<TMutationResult>>;\n};\n\n/**\n * Database fragment context provided to user callbacks.\n */\nexport type DatabaseFragmentContext<TSchema extends AnySchema> = {\n  /**\n   * Database adapter instance.\n   */\n  databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n  /**\n   * ORM query engine for the fragment's schema.\n   */\n  db: SimpleQueryInterface<TSchema>;\n};\n\n/**\n * Create database context from options.\n * This extracts the database adapter and creates the ORM instance.\n */\nfunction createDatabaseContext<TSchema extends AnySchema>(\n  options: FragnoPublicConfigWithDatabase,\n  schema: TSchema,\n  namespace: string,\n): DatabaseFragmentContext<TSchema> {\n  const databaseAdapter = options.databaseAdapter;\n\n  if (!databaseAdapter) {\n    throw new Error(\n      \"Database fragment requires a database adapter to be provided in options.databaseAdapter\",\n    );\n  }\n\n  const db = databaseAdapter.createQueryEngine(schema, namespace);\n\n  return { databaseAdapter, db };\n}\n\n/**\n * Storage type for database fragments - stores the Unit of Work.\n */\nexport type DatabaseRequestStorage = {\n  uow: IUnitOfWork;\n};\n\n/**\n * Builder for database fragments that wraps the core fragment builder\n * and provides database-specific functionality.\n *\n * Database fragments always require FragnoPublicConfigWithDatabase (which includes databaseAdapter).\n */\nexport class DatabaseFragmentDefinitionBuilder<\n  TSchema extends AnySchema,\n  TConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDependencies,\n  TPrivateServices,\n  THooks extends HooksMap = {},\n  TServiceThisContext extends RequestThisContext = DatabaseHandlerContext,\n  THandlerThisContext extends RequestThisContext = DatabaseHandlerContext,\n  TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment> = {},\n> {\n  // Store the base builder - we'll replace its storage and context setup when building\n  #baseBuilder: FragmentDefinitionBuilder<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    DatabaseRequestStorage,\n    TLinkedFragments\n  >;\n  #schema: TSchema;\n  #namespace: string;\n  #hooksFactory?: (context: { config: TConfig; options: FragnoPublicConfigWithDatabase }) => THooks;\n\n  constructor(\n    baseBuilder: FragmentDefinitionBuilder<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      DatabaseRequestStorage,\n      TLinkedFragments\n    >,\n    schema: TSchema,\n    namespace?: string,\n    hooksFactory?: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => THooks,\n  ) {\n    this.#baseBuilder = baseBuilder;\n    this.#schema = schema;\n    this.#namespace = namespace ?? baseBuilder.name;\n    this.#hooksFactory = hooksFactory;\n  }\n\n  /**\n   * Define dependencies for this database fragment.\n   * The context includes database adapter and ORM instance.\n   */\n  withDependencies<TNewDeps>(\n    fn: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      db: SimpleQueryInterface<TSchema>;\n      databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n    }) => TNewDeps,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TNewDeps & ImplicitDatabaseDependencies<TSchema>,\n    {},\n    {},\n    TServiceDependencies,\n    {},\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    // Wrap user function to inject DB context\n    const wrappedFn = (context: { config: TConfig; options: FragnoPublicConfigWithDatabase }) => {\n      const dbContext = createDatabaseContext(context.options, this.#schema, this.#namespace);\n\n      // Call user function with enriched context\n      const userDeps = fn({\n        config: context.config,\n        options: context.options,\n        db: dbContext.db,\n        databaseAdapter: dbContext.databaseAdapter,\n      });\n\n      // Create implicit dependencies\n      const createUow = () => dbContext.db.createUnitOfWork();\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db: dbContext.db,\n        schema: this.#schema,\n        namespace: this.#namespace,\n        createUnitOfWork: createUow,\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      };\n    };\n\n    // Create new base builder with wrapped function\n    const newBaseBuilder = this.#baseBuilder.withDependencies(wrappedFn);\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  providesBaseService<TNewService>(\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TNewService,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesBaseService<TNewService>(fn);\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices & { [K in TServiceName]: TService },\n    TServiceDependencies,\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesService<TServiceName, TService>(\n      serviceName,\n      fn,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  /**\n   * Provide a private service that is only accessible to the fragment author.\n   * Private services are NOT exposed on the fragment instance, but can be used\n   * when defining other services (baseServices, namedServices, and other privateServices).\n   * Private services are instantiated in order, so earlier private services are available\n   * to later ones.\n   */\n  providesPrivateService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices & { [K in TServiceName]: TService },\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesPrivateService<TServiceName, TService>(\n      serviceName,\n      fn,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  /**\n   * Define durable hooks for this fragment.\n   * Hooks are automatically persisted and retried on failure.\n   *\n   * @param fn - Function that receives defineHook helper and returns a hooks map\n   * @returns Builder with hooks type set\n   *\n   * @example\n   * ```ts\n   * .provideHooks(({ defineHook, config }) => ({\n   *   onSubscribe: defineHook(async function (payload: { email: string }) {\n   *     // 'this' context available (HookServiceContext with nonce)\n   *     await config.onSubscribe?.(payload.email);\n   *   }),\n   * }))\n   * ```\n   */\n  provideHooks<TNewHooks extends HooksMap>(\n    fn: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      defineHook: <TPayload>(\n        hook: (this: HookContext, payload: TPayload) => void | Promise<void>,\n      ) => HookFn<TPayload>;\n    }) => TNewHooks,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TNewHooks,\n    DatabaseServiceContext<TNewHooks>,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const defineHook = <TPayload>(\n      hook: (this: HookContext, payload: TPayload) => void | Promise<void>,\n    ): HookFn<TPayload> => {\n      return hook;\n    };\n\n    // Store the hooks factory - it will be called in build() with config/options\n    const hooksFactory = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => {\n      return fn({\n        config: context.config,\n        options: context.options,\n        defineHook,\n      });\n    };\n\n    // Create new builder with hooks factory stored\n    // Cast is safe: we're only changing THooks and TServiceThisContext type parameters\n    const newBuilder = new DatabaseFragmentDefinitionBuilder(\n      this.#baseBuilder,\n      this.#schema,\n      this.#namespace,\n    ) as unknown as DatabaseFragmentDefinitionBuilder<\n      TSchema,\n      TConfig,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewHooks,\n      DatabaseServiceContext<TNewHooks>,\n      THandlerThisContext,\n      TLinkedFragments\n    >;\n\n    newBuilder.#hooksFactory = hooksFactory;\n\n    return newBuilder;\n  }\n\n  /**\n   * Declare that this fragment uses a required service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService },\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesService<TServiceName, TService>(serviceName);\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  /**\n   * Declare that this fragment uses an optional service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesOptionalService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService | undefined },\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesOptionalService<TServiceName, TService>(\n      serviceName,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(\n      newBaseBuilder,\n      this.#schema,\n      this.#namespace,\n      this.#hooksFactory,\n    );\n  }\n\n  /**\n   * Build the final database fragment definition.\n   * This includes the request context setup for UnitOfWork management.\n   * Note: TDeps already includes ImplicitDatabaseDependencies from withDatabase().\n   */\n  build(): FragmentDefinition<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    DatabaseServiceContext<THooks>,\n    DatabaseHandlerContext<THooks>,\n    DatabaseRequestStorage,\n    TLinkedFragments\n  > {\n    const baseDef = this.#baseBuilder.build();\n\n    // Ensure dependencies callback always exists for database fragments\n    // If no user dependencies were defined, create a minimal one that only adds implicit deps\n    const dependencies = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }): TDeps => {\n      // In dry run mode, allow user deps to fail gracefully.\n      // This is critical for database fragments because the CLI needs access to the schema\n      // even when user dependencies (like API clients) can't be initialized.\n      // Without this, if user deps fail, we'd lose the implicit database dependencies\n      // (including schema), and the CLI couldn't extract schema information.\n      let userDeps;\n      try {\n        userDeps = baseDef.dependencies?.(context);\n      } catch (error) {\n        if (process.env[\"FRAGNO_INIT_DRY_RUN\"] === \"true\") {\n          console.warn(\n            \"Warning: Failed to initialize user dependencies in dry run mode:\",\n            error instanceof Error ? error.message : String(error),\n          );\n          userDeps = {};\n        } else {\n          throw error;\n        }\n      }\n\n      const { db } = createDatabaseContext(context.options, this.#schema, this.#namespace);\n\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db,\n        schema: this.#schema,\n        namespace: this.#namespace,\n        createUnitOfWork: () => db.createUnitOfWork(),\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      } as TDeps;\n    };\n\n    // Use the adapter's shared context storage (all fragments using the same adapter share this storage)\n    const builderWithExternalStorage = this.#baseBuilder.withExternalRequestStorage(\n      ({ options }) => {\n        const dbContext = createDatabaseContext(options, this.#schema, this.#namespace);\n        return dbContext.databaseAdapter.contextStorage;\n      },\n    );\n\n    // Set up request storage to initialize the Unit of Work\n    const builderWithStorage = builderWithExternalStorage.withRequestStorage(\n      ({ options }): DatabaseRequestStorage => {\n        // Create database context - needed here to create the UOW\n        const dbContextForStorage = createDatabaseContext(options, this.#schema, this.#namespace);\n\n        // Create a new Unit of Work for this request\n        const uow: IUnitOfWork = dbContextForStorage.db.createUnitOfWork();\n\n        return { uow };\n      },\n    );\n\n    // Get the internal fragment factory from linked fragments (added by withDatabase)\n    // Cast is safe: withDatabase() guarantees this fragment exists and has the correct type\n    const internalFragmentFactory = baseDef.linkedFragments?.[\"_fragno_internal\"] as (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => InternalFragmentInstance;\n\n    const builderWithContext = builderWithStorage.withThisContext<\n      DatabaseServiceContext<THooks>,\n      DatabaseHandlerContext<THooks>\n    >(({ storage, config, options }) => {\n      // Create hooks config if hooks factory is defined\n      const hooksConfig = this.#hooksFactory\n        ? {\n            hooks: this.#hooksFactory({ config, options }),\n            namespace: this.#namespace,\n            internalFragment: internalFragmentFactory({ config, options }),\n          }\n        : undefined;\n\n      function forSchema<TSchema extends AnySchema>(\n        schema: TSchema,\n      ): TypedUnitOfWork<TSchema, [], unknown, THooks> {\n        const uow = storage.getStore()?.uow;\n        if (!uow) {\n          throw new Error(\n            \"No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.\",\n          );\n        }\n\n        return uow.restrict().forSchema<TSchema, THooks>(schema);\n      }\n\n      const serviceTx = async <\n        TSchema extends AnySchema,\n        TRetrievalResults extends unknown[],\n        TMutationResult = void,\n      >(\n        schema: TSchema,\n        callbacks: ServiceTxCallbacks<TSchema, TRetrievalResults, TMutationResult, THooks>,\n      ): Promise<AwaitedPromisesInObject<TMutationResult>> => {\n        const uow = storage.getStore()?.uow;\n        if (!uow) {\n          throw new Error(\n            \"No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.\",\n          );\n        }\n\n        return executeServiceTx(schema, callbacks, uow);\n      };\n\n      const serviceContext: DatabaseServiceContext<THooks> = {\n        uow: forSchema,\n        tx: serviceTx,\n      };\n\n      async function uow<TResult>(\n        callback: (context: {\n          forSchema: <S extends AnySchema, H extends HooksMap = THooks>(\n            schema: S,\n            hooks?: H,\n          ) => TypedUnitOfWork<S, [], unknown, H>;\n          executeRetrieve: () => Promise<void>;\n          executeMutate: () => Promise<void>;\n          nonce: string;\n          currentAttempt: number;\n        }) => Promise<TResult> | TResult,\n        execOptions?: Omit<ExecuteRestrictedUnitOfWorkOptions, \"createUnitOfWork\">,\n      ): Promise<AwaitedPromisesInObject<TResult>> {\n        const currentStorage = storage.getStore();\n        if (!currentStorage) {\n          throw new Error(\n            \"No storage in context. Handler must be called within a request context.\",\n          );\n        }\n\n        const wrappedCallback = async (context: {\n          forSchema: <S extends AnySchema, H extends HooksMap = THooks>(\n            schema: S,\n            hooks?: H,\n          ) => TypedUnitOfWork<S, [], unknown, H>;\n          executeRetrieve: () => Promise<void>;\n          executeMutate: () => Promise<void>;\n          nonce: string;\n          currentAttempt: number;\n        }): Promise<TResult> => {\n          return callback(context);\n        };\n\n        const userOnBeforeMutate = execOptions?.onBeforeMutate;\n        const userOnSuccess = execOptions?.onSuccess;\n\n        return executeRestrictedUnitOfWork(wrappedCallback, {\n          ...execOptions,\n          createUnitOfWork: () => {\n            currentStorage.uow.reset();\n            if (hooksConfig) {\n              currentStorage.uow.registerSchema(\n                hooksConfig.internalFragment.$internal.deps.schema,\n                hooksConfig.internalFragment.$internal.deps.namespace,\n              );\n            }\n            // Safe cast: currentStorage.uow is always a UnitOfWork instance\n            return currentStorage.uow as UnitOfWork;\n          },\n          onBeforeMutate: (uow) => {\n            if (hooksConfig) {\n              prepareHookMutations(uow, hooksConfig);\n            }\n            if (userOnBeforeMutate) {\n              userOnBeforeMutate(uow);\n            }\n          },\n          onSuccess: async (uow) => {\n            if (hooksConfig) {\n              await processHooks(hooksConfig);\n            }\n            if (userOnSuccess) {\n              await userOnSuccess(uow);\n            }\n          },\n        });\n      }\n\n      // Handler tx method with two overloads\n      function handlerTx<T extends readonly unknown[]>(\n        servicesFactory: () => readonly [...{ [K in keyof T]: Promise<T[K]> }],\n        execOptions?: Omit<ExecuteRestrictedUnitOfWorkOptions, \"createUnitOfWork\">,\n      ): Promise<{ [K in keyof T]: T[K] }>;\n      function handlerTx<TRetrieveResult, TMutationResult>(\n        callbacks: HandlerTxCallbacks<TRetrieveResult, TMutationResult, THooks>,\n        execOptions?: Omit<ExecuteRestrictedUnitOfWorkOptions, \"createUnitOfWork\">,\n      ): Promise<AwaitedPromisesInObject<TMutationResult>>;\n      async function handlerTx<T extends readonly unknown[], TRetrieveResult, TMutationResult>(\n        factoryOrCallbacks:\n          | (() => readonly [...{ [K in keyof T]: Promise<T[K]> }])\n          | HandlerTxCallbacks<TRetrieveResult, TMutationResult, THooks>,\n        execOptions?: Omit<ExecuteRestrictedUnitOfWorkOptions, \"createUnitOfWork\">,\n      ): Promise<{ [K in keyof T]: T[K] } | AwaitedPromisesInObject<TMutationResult>> {\n        const currentStorage = storage.getStore();\n        if (!currentStorage) {\n          throw new Error(\n            \"No storage in context. Handler must be called within a request context.\",\n          );\n        }\n\n        const userOnBeforeMutate = execOptions?.onBeforeMutate;\n        const userOnSuccess = execOptions?.onSuccess;\n\n        const createUow = () => {\n          currentStorage.uow.reset();\n\n          if (hooksConfig) {\n            currentStorage.uow.registerSchema(\n              hooksConfig.internalFragment.$internal.deps.schema,\n              hooksConfig.internalFragment.$internal.deps.namespace,\n            );\n          }\n          // Safe cast: currentStorage.uow is always a UnitOfWork instance\n          return currentStorage.uow as UnitOfWork;\n        };\n\n        const options: ExecuteRestrictedUnitOfWorkOptions = {\n          ...execOptions,\n          createUnitOfWork: createUow,\n          onBeforeMutate: (uow) => {\n            if (hooksConfig) {\n              prepareHookMutations(uow, hooksConfig);\n            }\n            if (userOnBeforeMutate) {\n              userOnBeforeMutate(uow);\n            }\n          },\n          onSuccess: async (uow) => {\n            if (hooksConfig) {\n              await processHooks(hooksConfig);\n            }\n            if (userOnSuccess) {\n              await userOnSuccess(uow);\n            }\n          },\n        };\n\n        // Check if it's a function (array syntax factory) or callbacks object (callback syntax)\n        if (typeof factoryOrCallbacks === \"function\") {\n          // Array syntax - factoryOrCallbacks is a factory function\n          return executeTxArray(\n            factoryOrCallbacks as () => readonly [...{ [K in keyof T]: Promise<T[K]> }],\n            options,\n          ) as Promise<{ [K in keyof T]: T[K] }>;\n        } else {\n          return executeTxCallbacks(\n            factoryOrCallbacks as HandlerTxCallbacks<TRetrieveResult, TMutationResult, THooks>,\n            options,\n          );\n        }\n      }\n\n      const handlerContext: DatabaseHandlerContext<THooks> = {\n        uow,\n        tx: handlerTx,\n      };\n\n      return { serviceContext, handlerContext };\n    });\n\n    // Build the final definition\n    const finalDef = builderWithContext.build();\n\n    // Return the complete definition with proper typing and dependencies\n    return {\n      ...finalDef,\n      dependencies,\n    };\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"db-fragment-definition-builder.js","names":["#baseBuilder","#schema","#hooksFactory","implicitDeps: ImplicitDatabaseDependencies<TSchema>","hooksConfig: HookProcessorConfig<THooks>","serviceContext: DatabaseServiceContext<THooks>"],"sources":["../src/db-fragment-definition-builder.ts"],"sourcesContent":["import type { AnySchema } from \"./schema/create\";\nimport type { SimpleQueryInterface } from \"./query/simple-query-interface\";\nimport type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { IUnitOfWork } from \"./query/unit-of-work/unit-of-work\";\nimport type {\n  RequestThisContext,\n  FragnoPublicConfig,\n  AnyFragnoInstantiatedFragment,\n} from \"@fragno-dev/core\";\nimport {\n  FragmentDefinitionBuilder,\n  type FragmentDefinition,\n  type ServiceConstructorFn,\n} from \"@fragno-dev/core\";\nimport {\n  createServiceTxBuilder,\n  createHandlerTxBuilder,\n  ServiceTxBuilder,\n  HandlerTxBuilder,\n  type ExecuteTxOptions,\n} from \"./query/unit-of-work/execute-unit-of-work\";\nimport {\n  prepareHookMutations,\n  type HooksMap,\n  type HookFn,\n  type HookContext,\n  type HookProcessorConfig,\n  type DurableHooksProcessingOptions,\n  createHookScheduler,\n} from \"./hooks/hooks\";\nimport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\nimport { resolveDatabaseAdapter } from \"./util/default-database-adapter\";\nimport { sanitizeNamespace } from \"./naming/sql-naming\";\n\n/**\n * Extended FragnoPublicConfig for database fragments.\n * If databaseAdapter is omitted and better-sqlite3 is available, a default SQLite adapter is used.\n */\nexport type FragnoPublicConfigWithDatabase = FragnoPublicConfig & {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  databaseAdapter?: DatabaseAdapter<any>;\n  /**\n   * Optional durable hooks processing configuration.\n   */\n  durableHooks?: DurableHooksProcessingOptions;\n  /**\n   * Optional override for database namespace. If provided (including null), it is used as-is\n   * without sanitization — the caller is responsible for providing a valid namespace.\n   * When omitted, defaults to a sanitized version of schema.name.\n   */\n  databaseNamespace?: string | null;\n};\n\n/**\n * Implicit dependencies that database fragments get automatically.\n * These are injected without requiring explicit configuration.\n */\nexport type ImplicitDatabaseDependencies<TSchema extends AnySchema> = {\n  /**\n   * Database query engine for the fragment's schema.\n   * @deprecated Prefer handlerTx/serviceTx instead of direct db usage.\n   */\n  db: SimpleQueryInterface<TSchema>;\n  /**\n   * The schema definition for this fragment.\n   */\n  schema: TSchema;\n  /**\n   * The database namespace for this fragment.\n   */\n  namespace: string | null;\n  /**\n   * Create a new Unit of Work for database operations.\n   */\n  createUnitOfWork: () => IUnitOfWork;\n};\n\n/**\n * Service context for database fragments - provides restricted UOW access without execute methods.\n */\nexport type DatabaseServiceContext<THooks extends HooksMap> = RequestThisContext & {\n  /**\n   * Create a service-level transaction builder using the fluent API.\n   * Returns a builder that can be chained with withServiceCalls, retrieve,\n   * transformRetrieve, mutate, transform, and build.\n   *\n   * @example\n   * ```ts\n   * return this.serviceTx(schema)\n   *   .withServiceCalls(() => [otherService.getData()])\n   *   .retrieve((uow) => uow.find(\"users\", ...))\n   *   .transformRetrieve(([users]) => users[0])\n   *   .mutate(({ uow, retrieveResult, serviceIntermediateResult }) =>\n   *     uow.create(\"records\", { ... })\n   *   )\n   *   .transform(({ mutateResult, serviceResult }) => ({ id: mutateResult }))\n   *   .build();\n   * ```\n   */\n  serviceTx<TSchema extends AnySchema>(\n    schema: TSchema,\n  ): ServiceTxBuilder<\n    TSchema,\n    readonly [],\n    [],\n    [],\n    unknown,\n    unknown,\n    false,\n    false,\n    false,\n    false,\n    THooks\n  >;\n};\n\n/**\n * Handler context for database fragments - provides UOW execution with automatic retry support.\n */\nexport type DatabaseHandlerContext<THooks extends HooksMap = {}> = RequestThisContext & {\n  /**\n   * Create a handler-level transaction builder using the fluent API.\n   * Returns a builder that can be chained with withServiceCalls, retrieve,\n   * transformRetrieve, mutate, transform, and execute.\n   *\n   * @example\n   * ```ts\n   * const result = await this.handlerTx()\n   *   .withServiceCalls(() => [userService.getUser(id)])\n   *   .mutate(({ forSchema, idempotencyKey, currentAttempt, serviceIntermediateResult }) => {\n   *     return forSchema(ordersSchema).create(\"orders\", { ... });\n   *   })\n   *   .transform(({ mutateResult, serviceResult }) => ({ ... }))\n   *   .execute();\n   * ```\n   */\n  handlerTx(\n    options?: Omit<ExecuteTxOptions, \"createUnitOfWork\">,\n  ): HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, THooks>;\n};\n\n/**\n * Database fragment context provided to user callbacks.\n */\nexport type DatabaseFragmentContext<TSchema extends AnySchema> = {\n  /**\n   * Database adapter instance.\n   */\n  databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n  /**\n   * ORM query engine for the fragment's schema.\n   */\n  db: SimpleQueryInterface<TSchema>;\n};\n\n/**\n * Create database context from options.\n * This extracts the database adapter and creates the ORM instance.\n */\nfunction createDatabaseContext<TSchema extends AnySchema>(\n  options: FragnoPublicConfigWithDatabase,\n  schema: TSchema,\n): DatabaseFragmentContext<TSchema> {\n  const databaseAdapter = resolveDatabaseAdapter(options, schema);\n\n  const namespace = resolveDatabaseNamespace(options, schema);\n  const db = databaseAdapter.createQueryEngine(schema, namespace);\n\n  return { databaseAdapter, db };\n}\n\nfunction resolveDatabaseNamespace<TSchema extends AnySchema>(\n  options: FragnoPublicConfigWithDatabase,\n  schema: TSchema,\n): string | null {\n  const hasOverride = options.databaseNamespace !== undefined;\n  return hasOverride ? (options.databaseNamespace ?? null) : sanitizeNamespace(schema.name);\n}\n\n/**\n * Storage type for database fragments - stores the Unit of Work.\n */\nexport type DatabaseRequestStorage = {\n  uow: IUnitOfWork;\n};\n\n/**\n * Builder for database fragments that wraps the core fragment builder\n * and provides database-specific functionality.\n *\n * Database fragments use FragnoPublicConfigWithDatabase and default the adapter when possible.\n */\nexport class DatabaseFragmentDefinitionBuilder<\n  TSchema extends AnySchema,\n  TConfig,\n  TDeps,\n  TBaseServices,\n  TServices,\n  TServiceDependencies,\n  TPrivateServices,\n  THooks extends HooksMap = {},\n  TServiceThisContext extends RequestThisContext = DatabaseHandlerContext,\n  THandlerThisContext extends RequestThisContext = DatabaseHandlerContext,\n  TLinkedFragments extends Record<string, AnyFragnoInstantiatedFragment> = {},\n> {\n  // Store the base builder - we'll replace its storage and context setup when building\n  #baseBuilder: FragmentDefinitionBuilder<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TServiceThisContext,\n    THandlerThisContext,\n    DatabaseRequestStorage,\n    TLinkedFragments\n  >;\n  #schema: TSchema;\n  #hooksFactory?: (context: { config: TConfig; options: FragnoPublicConfigWithDatabase }) => THooks;\n\n  constructor(\n    baseBuilder: FragmentDefinitionBuilder<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TServiceThisContext,\n      THandlerThisContext,\n      DatabaseRequestStorage,\n      TLinkedFragments\n    >,\n    schema: TSchema,\n    hooksFactory?: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => THooks,\n  ) {\n    this.#baseBuilder = baseBuilder;\n    this.#schema = schema;\n    this.#hooksFactory = hooksFactory;\n  }\n\n  /**\n   * Define dependencies for this database fragment.\n   * The context includes database adapter and ORM instance.\n   */\n  withDependencies<TNewDeps>(\n    fn: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      db: SimpleQueryInterface<TSchema>;\n      databaseAdapter: DatabaseAdapter<any>; // eslint-disable-line @typescript-eslint/no-explicit-any\n    }) => TNewDeps,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TNewDeps & ImplicitDatabaseDependencies<TSchema>,\n    {},\n    {},\n    TServiceDependencies,\n    {},\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    // Wrap user function to inject DB context\n    const wrappedFn = (context: { config: TConfig; options: FragnoPublicConfigWithDatabase }) => {\n      const dbContext = createDatabaseContext(context.options, this.#schema);\n      const namespace = resolveDatabaseNamespace(context.options, this.#schema);\n\n      // Call user function with enriched context\n      const userDeps = fn({\n        config: context.config,\n        options: context.options,\n        db: dbContext.db,\n        databaseAdapter: dbContext.databaseAdapter,\n      });\n\n      // Create implicit dependencies\n      const createUow = () => dbContext.db.createUnitOfWork();\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db: dbContext.db,\n        schema: this.#schema,\n        namespace,\n        createUnitOfWork: createUow,\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      };\n    };\n\n    // Create new base builder with wrapped function\n    const newBaseBuilder = this.#baseBuilder.withDependencies(wrappedFn);\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  providesBaseService<TNewService>(\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TNewService,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesBaseService<TNewService>(fn);\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  providesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices & { [K in TServiceName]: TService },\n    TServiceDependencies,\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesService<TServiceName, TService>(\n      serviceName,\n      fn,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  /**\n   * Provide a private service that is only accessible to the fragment author.\n   * Private services are NOT exposed on the fragment instance, but can be used\n   * when defining other services (baseServices, namedServices, and other privateServices).\n   * Private services are instantiated in order, so earlier private services are available\n   * to later ones.\n   */\n  providesPrivateService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n    fn: ServiceConstructorFn<\n      TConfig,\n      FragnoPublicConfigWithDatabase,\n      TDeps,\n      TServiceDependencies,\n      TPrivateServices,\n      TService,\n      TServiceThisContext\n    >,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices & { [K in TServiceName]: TService },\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.providesPrivateService<TServiceName, TService>(\n      serviceName,\n      fn,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  /**\n   * Define durable hooks for this fragment.\n   * Hooks are automatically persisted and retried on failure.\n   *\n   * @param fn - Function that receives defineHook helper and returns a hooks map\n   * @returns Builder with hooks type set\n   *\n   * @example\n   * ```ts\n   * .provideHooks(({ defineHook, config }) => ({\n   *   onSubscribe: defineHook(async function (payload: { email: string }) {\n   *     // 'this' context available (HookServiceContext with idempotencyKey)\n   *     await config.onSubscribe?.(payload.email);\n   *   }),\n   * }))\n   * ```\n   */\n  provideHooks<TNewHooks extends HooksMap>(\n    fn: (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      defineHook: <TPayload>(\n        hook: (this: HookContext, payload: TPayload) => void | Promise<void>,\n      ) => HookFn<TPayload>;\n    }) => TNewHooks,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    TNewHooks,\n    DatabaseServiceContext<TNewHooks>,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const defineHook = <TPayload>(\n      hook: (this: HookContext, payload: TPayload) => void | Promise<void>,\n    ): HookFn<TPayload> => {\n      return hook;\n    };\n\n    // Store the hooks factory - it will be called in build() with config/options\n    const hooksFactory = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => {\n      return fn({\n        config: context.config,\n        options: context.options,\n        defineHook,\n      });\n    };\n\n    // Create new builder with hooks factory stored\n    // Cast is safe: we're only changing THooks and TServiceThisContext type parameters\n    const newBuilder = new DatabaseFragmentDefinitionBuilder(\n      this.#baseBuilder,\n      this.#schema,\n    ) as unknown as DatabaseFragmentDefinitionBuilder<\n      TSchema,\n      TConfig,\n      TDeps,\n      TBaseServices,\n      TServices,\n      TServiceDependencies,\n      TPrivateServices,\n      TNewHooks,\n      DatabaseServiceContext<TNewHooks>,\n      THandlerThisContext,\n      TLinkedFragments\n    >;\n\n    newBuilder.#hooksFactory = hooksFactory;\n\n    return newBuilder;\n  }\n\n  /**\n   * Declare that this fragment uses a required service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService },\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesService<TServiceName, TService>(serviceName);\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  /**\n   * Declare that this fragment uses an optional service provided by the runtime.\n   * Delegates to the base builder.\n   */\n  usesOptionalService<TServiceName extends string, TService>(\n    serviceName: TServiceName,\n  ): DatabaseFragmentDefinitionBuilder<\n    TSchema,\n    TConfig,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies & { [K in TServiceName]: TService | undefined },\n    TPrivateServices,\n    THooks,\n    TServiceThisContext,\n    THandlerThisContext,\n    TLinkedFragments\n  > {\n    const newBaseBuilder = this.#baseBuilder.usesOptionalService<TServiceName, TService>(\n      serviceName,\n    );\n\n    return new DatabaseFragmentDefinitionBuilder(newBaseBuilder, this.#schema, this.#hooksFactory);\n  }\n\n  /**\n   * Build the final database fragment definition.\n   * This includes the request context setup for UnitOfWork management.\n   * Note: TDeps already includes ImplicitDatabaseDependencies from withDatabase().\n   */\n  build(): FragmentDefinition<\n    TConfig,\n    FragnoPublicConfigWithDatabase,\n    TDeps,\n    TBaseServices,\n    TServices,\n    TServiceDependencies,\n    TPrivateServices,\n    DatabaseServiceContext<THooks>,\n    DatabaseHandlerContext<THooks>,\n    DatabaseRequestStorage,\n    TLinkedFragments\n  > {\n    const baseDef = this.#baseBuilder.build();\n\n    // Ensure dependencies callback always exists for database fragments\n    // If no user dependencies were defined, create a minimal one that only adds implicit deps\n    const dependencies = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }): TDeps => {\n      // In dry run mode, allow user deps to fail gracefully.\n      // This is critical for database fragments because the CLI needs access to the schema\n      // even when user dependencies (like API clients) can't be initialized.\n      // Without this, if user deps fail, we'd lose the implicit database dependencies\n      // (including schema), and the CLI couldn't extract schema information.\n      let userDeps;\n      try {\n        userDeps = baseDef.dependencies?.(context);\n      } catch (error) {\n        if (process.env[\"FRAGNO_INIT_DRY_RUN\"] === \"true\") {\n          console.warn(\n            \"Warning: Failed to initialize user dependencies in dry run mode:\",\n            error instanceof Error ? error.message : String(error),\n          );\n          userDeps = {};\n        } else {\n          throw error;\n        }\n      }\n\n      const { db } = createDatabaseContext(context.options, this.#schema);\n      const namespace = resolveDatabaseNamespace(context.options, this.#schema);\n\n      const implicitDeps: ImplicitDatabaseDependencies<TSchema> = {\n        db,\n        schema: this.#schema,\n        namespace,\n        createUnitOfWork: () => db.createUnitOfWork(),\n      };\n\n      return {\n        ...userDeps,\n        ...implicitDeps,\n      } as TDeps;\n    };\n\n    // Use the adapter's shared context storage (all fragments using the same adapter share this storage)\n    const builderWithExternalStorage = this.#baseBuilder.withExternalRequestStorage(\n      ({ options }) => {\n        const dbContext = createDatabaseContext(options, this.#schema);\n        return dbContext.databaseAdapter.contextStorage;\n      },\n    );\n\n    // Set up request storage to initialize the Unit of Work\n    const builderWithStorage = builderWithExternalStorage.withRequestStorage(\n      ({ options }): DatabaseRequestStorage => {\n        // Create database context - needed here to create the UOW\n        const dbContextForStorage = createDatabaseContext(options, this.#schema);\n\n        // Create a new Unit of Work for this request\n        const uow: IUnitOfWork = dbContextForStorage.db.createUnitOfWork();\n\n        return { uow };\n      },\n    );\n\n    // Get the internal fragment factory from linked fragments (added by withDatabase)\n    // Cast is safe: withDatabase() guarantees this fragment exists and has the correct type\n    const internalFragmentFactory = baseDef.linkedFragments?.[\"_fragno_internal\"] as (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n    }) => InternalFragmentInstance;\n\n    // Cache per instantiated fragment (deps object is unique per instantiation).\n    const hooksConfigCache = new WeakMap<object, HookProcessorConfig<THooks>>();\n\n    const createHooksConfig = (context: {\n      config: TConfig;\n      options: FragnoPublicConfigWithDatabase;\n      deps: TDeps;\n    }) => {\n      if (!this.#hooksFactory) {\n        return undefined;\n      }\n      const depsKey =\n        typeof context.deps === \"object\" && context.deps !== null\n          ? (context.deps as object)\n          : undefined;\n      const cachedHooksConfig = depsKey ? hooksConfigCache.get(depsKey) : undefined;\n      if (cachedHooksConfig) {\n        return cachedHooksConfig;\n      }\n\n      const namespace = resolveDatabaseNamespace(context.options, this.#schema);\n      const namespaceKey = namespace ?? this.#schema.name;\n      const durableHooksOptions = context.options.durableHooks;\n      const baseAdapter = resolveDatabaseAdapter(context.options, this.#schema);\n      const hookAdapter = baseAdapter.getHookProcessingAdapter?.() ?? baseAdapter;\n      const hookOptions =\n        hookAdapter === baseAdapter\n          ? context.options\n          : { ...context.options, databaseAdapter: hookAdapter };\n      const dbContextForHooks = createDatabaseContext(hookOptions, this.#schema);\n      const hooksConfig: HookProcessorConfig<THooks> = {\n        hooks: this.#hooksFactory(context),\n        namespace: namespaceKey,\n        internalFragment: internalFragmentFactory({\n          config: context.config,\n          options: hookOptions,\n        }),\n        handlerTx: (execOptions?: Omit<ExecuteTxOptions, \"createUnitOfWork\">) => {\n          const userOnBeforeMutate = execOptions?.onBeforeMutate;\n          const userOnAfterMutate = execOptions?.onAfterMutate;\n          return createHandlerTxBuilder<THooks>({\n            ...execOptions,\n            createUnitOfWork: () => {\n              const uow = dbContextForHooks.db.createUnitOfWork();\n              uow.registerSchema(\n                hooksConfig.internalFragment.$internal.deps.schema,\n                hooksConfig.internalFragment.$internal.deps.namespace,\n              );\n              return uow;\n            },\n            onBeforeMutate: (uow) => {\n              prepareHookMutations(uow, hooksConfig);\n              if (userOnBeforeMutate) {\n                userOnBeforeMutate(uow);\n              }\n            },\n            onAfterMutate: async (uow) => {\n              void hooksConfig.scheduler?.schedule().catch((error) => {\n                console.error(\"Durable hooks processing failed\", error);\n              });\n              if (userOnAfterMutate) {\n                await userOnAfterMutate(uow);\n              }\n            },\n          });\n        },\n        stuckProcessingTimeoutMinutes: durableHooksOptions?.stuckProcessingTimeoutMinutes,\n        onStuckProcessingHooks: durableHooksOptions?.onStuckProcessingHooks,\n      };\n      hooksConfig.scheduler = createHookScheduler(hooksConfig);\n      if (depsKey) {\n        hooksConfigCache.set(depsKey, hooksConfig);\n      }\n      return hooksConfig;\n    };\n\n    const builderWithContext = builderWithStorage.withThisContext<\n      DatabaseServiceContext<THooks>,\n      DatabaseHandlerContext<THooks>\n    >(({ storage, config, options, deps }) => {\n      // Create hooks config if hooks factory is defined\n      const hooksConfig = createHooksConfig({ config, options, deps });\n      const internalFragment =\n        hooksConfig?.internalFragment ??\n        (internalFragmentFactory ? internalFragmentFactory({ config, options }) : undefined);\n\n      // Builder API: serviceTx using createServiceTxBuilder\n      function serviceTx<TSchema extends AnySchema>(schema: TSchema) {\n        const uow = storage.getStore()?.uow;\n        if (!uow) {\n          throw new Error(\n            \"No UnitOfWork in context. Service must be called within a route handler OR using `withUnitOfWork`.\",\n          );\n        }\n        return createServiceTxBuilder<TSchema, THooks>(schema, uow, hooksConfig?.hooks);\n      }\n\n      const serviceContext: DatabaseServiceContext<THooks> = {\n        serviceTx,\n      };\n\n      // Builder API: handlerTx using createHandlerTxBuilder\n      function handlerTx(execOptions?: Omit<ExecuteTxOptions, \"createUnitOfWork\">) {\n        const currentStorage = storage.getStore();\n        if (!currentStorage) {\n          throw new Error(\n            \"No storage in context. Handler must be called within a request context.\",\n          );\n        }\n\n        const userOnBeforeMutate = execOptions?.onBeforeMutate;\n        const userOnAfterMutate = execOptions?.onAfterMutate;\n\n        return createHandlerTxBuilder<THooks>({\n          ...execOptions,\n          createUnitOfWork: () => {\n            currentStorage.uow.reset();\n            if (internalFragment) {\n              currentStorage.uow.registerSchema(\n                internalFragment.$internal.deps.schema,\n                internalFragment.$internal.deps.namespace,\n              );\n            }\n            return currentStorage.uow;\n          },\n          onBeforeMutate: (uow) => {\n            if (hooksConfig) {\n              prepareHookMutations(uow, hooksConfig);\n            }\n            if (userOnBeforeMutate) {\n              userOnBeforeMutate(uow);\n            }\n          },\n          onAfterMutate: async (uow) => {\n            if (hooksConfig?.scheduler) {\n              void hooksConfig.scheduler.schedule().catch((error) => {\n                console.error(\"Durable hooks processing failed\", error);\n              });\n            }\n            if (userOnAfterMutate) {\n              await userOnAfterMutate(uow);\n            }\n          },\n        });\n      }\n\n      const handlerContext: DatabaseHandlerContext<THooks> = {\n        handlerTx,\n      };\n\n      return { serviceContext, handlerContext };\n    });\n\n    // Build the final definition\n    const finalDef = builderWithContext.build();\n    if (this.#hooksFactory) {\n      finalDef.internalDataFactory = ({ config, options, deps }) => ({\n        durableHooks: createHooksConfig({\n          config: config as TConfig,\n          options: options as FragnoPublicConfigWithDatabase,\n          deps: deps as TDeps,\n        }),\n      });\n    }\n\n    // Return the complete definition with proper typing and dependencies\n    return {\n      ...finalDef,\n      dependencies,\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/dispatchers/cloudflare-do/index.d.ts

@@ -0,0 +1,26 @@
+import { DurableHooksProcessor } from "../../hooks/durable-hooks-processor.js";
+
+//#region src/dispatchers/cloudflare-do/index.d.ts
+type AlarmStorage = {
+  setAlarm?: (timestamp: number | Date) => Promise<void>;
+  deleteAlarm?: () => Promise<void>;
+};
+type DurableHooksDispatcherDurableObjectState = {
+  readonly storage: AlarmStorage;
+};
+type DurableHooksDispatcherDurableObjectHandler = {
+  fetch?: (request: Request) => Promise<Response>;
+  alarm?: () => Promise<void>;
+};
+type DurableHooksDispatcherDurableObjectFactory<TEnv = unknown> = (state: DurableHooksDispatcherDurableObjectState, env: TEnv) => DurableHooksDispatcherDurableObjectHandler;
+type DurableHooksDispatcherDurableObjectOptions<TEnv = unknown> = {
+  createProcessor: (context: {
+    state: DurableHooksDispatcherDurableObjectState;
+    env: TEnv;
+  }) => DurableHooksProcessor;
+  onProcessError?: (error: unknown) => void;
+};
+declare function createDurableHooksDispatcherDurableObject<TEnv>(options: DurableHooksDispatcherDurableObjectOptions<TEnv>): DurableHooksDispatcherDurableObjectFactory<TEnv>;
+//#endregion
+export { DurableHooksDispatcherDurableObjectFactory, DurableHooksDispatcherDurableObjectHandler, DurableHooksDispatcherDurableObjectOptions, DurableHooksDispatcherDurableObjectState, createDurableHooksDispatcherDurableObject };
+//# sourceMappingURL=index.d.ts.map

package/dist/dispatchers/cloudflare-do/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/dispatchers/cloudflare-do/index.ts"],"sourcesContent":[],"mappings":";;;KAEK,YAAA;kCAC6B,SAAS;EADtC,WAAA,CAAA,EAAA,GAAY,GAEK,OAFL,CAAA,IAAA,CAAA;CACiB;AAAS,KAI/B,wCAAA,GAJ+B;EACrB,SAAA,OAAA,EAIF,YAJE;CAAO;AAGjB,KAIA,0CAAA,GAJwC;EAIxC,KAAA,CAAA,EAAA,CAAA,OAAA,EACQ,OADR,EAAA,GACoB,OADpB,CAC4B,QADc,CAAA;EAClC,KAAA,CAAA,EAAA,GAAA,GACJ,OADI,CAAA,IAAA,CAAA;CAAoB;AAAR,KAIpB,0CAJoB,CAAA,OAAA,OAAA,CAAA,GAAA,CAAA,KAAA,EAKvB,wCALuB,EAAA,GAAA,EAMzB,IANyB,EAAA,GAO3B,0CAP2B;AAChB,KAQJ,0CARI,CAAA,OAAA,OAAA,CAAA,GAAA;EAAO,eAAA,EAAA,CAAA,OAAA,EAAA;IAGX,KAAA,EAOD,wCAP2C;IAC7C,GAAA,EAOA,IAPA;EACF,CAAA,EAAA,GAOC,qBAPD;EACF,cAAA,CAAA,EAAA,CAAA,KAAA,EAAA,OAAA,EAAA,GAAA,IAAA;CAA0C;AAEnC,iBAQI,yCARsC,CAAA,IAAA,CAAA,CAAA,OAAA,EAS3C,0CAT2C,CASA,IATA,CAAA,CAAA,EAUnD,0CAVmD,CAUR,IAVQ,CAAA"}

package/dist/dispatchers/cloudflare-do/index.js

@@ -0,0 +1,63 @@
+//#region src/dispatchers/cloudflare-do/index.ts
+function createDurableHooksDispatcherDurableObject(options) {
+	return (state, env) => {
+		const processor = options.createProcessor({
+			state,
+			env
+		});
+		const onProcessError = options.onProcessError ?? ((error) => {
+			console.error("Durable hooks dispatcher error", error);
+		});
+		const rawSetAlarm = state.storage.setAlarm;
+		const rawDeleteAlarm = state.storage.deleteAlarm;
+		if (!rawSetAlarm) throw new Error("Durable hooks dispatcher requires state.storage.setAlarm to schedule alarms.");
+		const setAlarm = rawSetAlarm.bind(state.storage);
+		const deleteAlarm = rawDeleteAlarm?.bind(state.storage);
+		let processing = false;
+		let queued = false;
+		let currentPromise;
+		const runProcess = () => {
+			if (processing) {
+				queued = true;
+				return currentPromise ?? Promise.resolve();
+			}
+			processing = true;
+			currentPromise = (async () => {
+				do {
+					queued = false;
+					try {
+						await processor.process();
+					} catch (error) {
+						onProcessError(error);
+					}
+				} while (queued);
+				processing = false;
+			})();
+			return currentPromise;
+		};
+		const scheduleNextAlarm = async () => {
+			const nextWakeAt = await processor.getNextWakeAt();
+			if (!nextWakeAt) {
+				await deleteAlarm?.();
+				return;
+			}
+			const now = Date.now();
+			await setAlarm(new Date(Math.max(nextWakeAt.getTime(), now)));
+		};
+		scheduleNextAlarm().catch((error) => {
+			onProcessError(error);
+		});
+		return { alarm: async () => {
+			try {
+				await runProcess();
+				await scheduleNextAlarm();
+			} catch (error) {
+				onProcessError(error);
+			}
+		} };
+	};
+}
+
+//#endregion
+export { createDurableHooksDispatcherDurableObject };
+//# sourceMappingURL=index.js.map

package/dist/dispatchers/cloudflare-do/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["currentPromise: Promise<void> | undefined"],"sources":["../../../src/dispatchers/cloudflare-do/index.ts"],"sourcesContent":["import type { DurableHooksProcessor } from \"../../hooks/durable-hooks-processor\";\n\ntype AlarmStorage = {\n  setAlarm?: (timestamp: number | Date) => Promise<void>;\n  deleteAlarm?: () => Promise<void>;\n};\n\nexport type DurableHooksDispatcherDurableObjectState = {\n  readonly storage: AlarmStorage;\n};\n\nexport type DurableHooksDispatcherDurableObjectHandler = {\n  fetch?: (request: Request) => Promise<Response>;\n  alarm?: () => Promise<void>;\n};\n\nexport type DurableHooksDispatcherDurableObjectFactory<TEnv = unknown> = (\n  state: DurableHooksDispatcherDurableObjectState,\n  env: TEnv,\n) => DurableHooksDispatcherDurableObjectHandler;\n\nexport type DurableHooksDispatcherDurableObjectOptions<TEnv = unknown> = {\n  createProcessor: (context: {\n    state: DurableHooksDispatcherDurableObjectState;\n    env: TEnv;\n  }) => DurableHooksProcessor;\n  onProcessError?: (error: unknown) => void;\n};\n\nexport function createDurableHooksDispatcherDurableObject<TEnv>(\n  options: DurableHooksDispatcherDurableObjectOptions<TEnv>,\n): DurableHooksDispatcherDurableObjectFactory<TEnv> {\n  return (state, env) => {\n    const processor = options.createProcessor({ state, env });\n    const onProcessError =\n      options.onProcessError ??\n      ((error: unknown) => {\n        console.error(\"Durable hooks dispatcher error\", error);\n      });\n    const rawSetAlarm = state.storage.setAlarm;\n    const rawDeleteAlarm = state.storage.deleteAlarm;\n\n    if (!rawSetAlarm) {\n      throw new Error(\n        \"Durable hooks dispatcher requires state.storage.setAlarm to schedule alarms.\",\n      );\n    }\n    const setAlarm = rawSetAlarm.bind(state.storage);\n    const deleteAlarm = rawDeleteAlarm?.bind(state.storage);\n\n    let processing = false;\n    let queued = false;\n    let currentPromise: Promise<void> | undefined;\n\n    const runProcess = () => {\n      if (processing) {\n        queued = true;\n        return currentPromise ?? Promise.resolve();\n      }\n\n      processing = true;\n      currentPromise = (async () => {\n        do {\n          queued = false;\n          try {\n            await processor.process();\n          } catch (error) {\n            onProcessError(error);\n          }\n        } while (queued);\n        processing = false;\n      })();\n\n      return currentPromise;\n    };\n\n    const scheduleNextAlarm = async () => {\n      const nextWakeAt = await processor.getNextWakeAt();\n      if (!nextWakeAt) {\n        await deleteAlarm?.();\n        return;\n      }\n\n      const now = Date.now();\n      const scheduledAt = new Date(Math.max(nextWakeAt.getTime(), now));\n      await setAlarm(scheduledAt);\n    };\n\n    void scheduleNextAlarm().catch((error) => {\n      onProcessError(error);\n    });\n\n    return {\n      alarm: async () => {\n        try {\n          await runProcess();\n          await scheduleNextAlarm();\n        } catch (error) {\n          onProcessError(error);\n        }\n      },\n    };\n  };\n}\n"],"mappings":";AA6BA,SAAgB,0CACd,SACkD;AAClD,SAAQ,OAAO,QAAQ;EACrB,MAAM,YAAY,QAAQ,gBAAgB;GAAE;GAAO;GAAK,CAAC;EACzD,MAAM,iBACJ,QAAQ,oBACN,UAAmB;AACnB,WAAQ,MAAM,kCAAkC,MAAM;;EAE1D,MAAM,cAAc,MAAM,QAAQ;EAClC,MAAM,iBAAiB,MAAM,QAAQ;AAErC,MAAI,CAAC,YACH,OAAM,IAAI,MACR,+EACD;EAEH,MAAM,WAAW,YAAY,KAAK,MAAM,QAAQ;EAChD,MAAM,cAAc,gBAAgB,KAAK,MAAM,QAAQ;EAEvD,IAAI,aAAa;EACjB,IAAI,SAAS;EACb,IAAIA;EAEJ,MAAM,mBAAmB;AACvB,OAAI,YAAY;AACd,aAAS;AACT,WAAO,kBAAkB,QAAQ,SAAS;;AAG5C,gBAAa;AACb,qBAAkB,YAAY;AAC5B,OAAG;AACD,cAAS;AACT,SAAI;AACF,YAAM,UAAU,SAAS;cAClB,OAAO;AACd,qBAAe,MAAM;;aAEhB;AACT,iBAAa;OACX;AAEJ,UAAO;;EAGT,MAAM,oBAAoB,YAAY;GACpC,MAAM,aAAa,MAAM,UAAU,eAAe;AAClD,OAAI,CAAC,YAAY;AACf,UAAM,eAAe;AACrB;;GAGF,MAAM,MAAM,KAAK,KAAK;AAEtB,SAAM,SADc,IAAI,KAAK,KAAK,IAAI,WAAW,SAAS,EAAE,IAAI,CAAC,CACtC;;AAG7B,EAAK,mBAAmB,CAAC,OAAO,UAAU;AACxC,kBAAe,MAAM;IACrB;AAEF,SAAO,EACL,OAAO,YAAY;AACjB,OAAI;AACF,UAAM,YAAY;AAClB,UAAM,mBAAmB;YAClB,OAAO;AACd,mBAAe,MAAM;;KAG1B"}

package/dist/dispatchers/node/index.d.ts

@@ -0,0 +1,17 @@
+import { DurableHooksProcessor } from "../../hooks/durable-hooks-processor.js";
+
+//#region src/dispatchers/node/index.d.ts
+type DurableHooksDispatcher = {
+  wake: () => Promise<void>;
+  startPolling: () => void;
+  stopPolling: () => void;
+};
+type DurableHooksDispatcherOptions = {
+  processor: DurableHooksProcessor;
+  pollIntervalMs?: number;
+  onError?: (error: unknown) => void;
+};
+declare function createDurableHooksDispatcher(options: DurableHooksDispatcherOptions): DurableHooksDispatcher;
+//#endregion
+export { DurableHooksDispatcher, DurableHooksDispatcherOptions, createDurableHooksDispatcher };
+//# sourceMappingURL=index.d.ts.map

package/dist/dispatchers/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/dispatchers/node/index.ts"],"sourcesContent":[],"mappings":";;;KAEY,sBAAA;cACE;EADF,YAAA,EAAA,GAAA,GAAA,IAAA;EAMA,WAAA,EAAA,GAAA,GAAA,IAAA;AAMZ,CAAA;KANY,6BAAA;aACC;;;;iBAKG,4BAAA,UACL,gCACR"}