@fragno-dev/db 0.3.0 → 0.4.1

package/dist/hooks/hooks.js

@@ -1,6 +1,19 @@
+import { dbNow, isDbNow } from "../query/db-now.js";
+import { DurableHooksLogger } from "./durable-hooks-logger.js";
 import { ExponentialBackoffRetryPolicy } from "../query/unit-of-work/retry-policy.js";
 
 //#region src/hooks/hooks.ts
+const hookStatusValues = [
+	"pending",
+	"processing",
+	"completed",
+	"failed"
+];
+const isHookStatus = (value) => typeof value === "string" && hookStatusValues.includes(value);
+const assertHookStatus = (value) => {
+	if (isHookStatus(value)) return value;
+	throw new Error(`Invalid hook status: ${String(value)}`);
+};
 const DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES = 10;
 function resolveStuckProcessingTimeoutMinutes(value) {
 	if (value === false) return false;
@@ -11,19 +24,48 @@ function resolveStuckProcessingTimeoutMinutes(value) {
 * Add hook events as mutation operations to the UOW.
 * This should be called before executeMutations() so hook records are created
 * in the same transaction as the user's mutations.
+*
+* Each triggered hook carries its own namespace (set at trigger-time), so this
+* function works regardless of which fragment's handler is executing. When a
+* `config` is provided its `defaultRetryPolicy` is used as fallback.
 */
-function prepareHookMutations(uow, config) {
-	const { namespace, internalFragment, defaultRetryPolicy } = config;
+function prepareHookMutations(uow, internalFragment, defaultRetryPolicy) {
 	const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });
 	const triggeredHooks = uow.getTriggeredHooks();
 	if (triggeredHooks.length === 0) return;
+	const primaryNamespace = triggeredHooks[0]?.namespace;
+	DurableHooksLogger.debug("Durable hooks queued", {
+		namespace: primaryNamespace,
+		fields: () => {
+			const hookSummary = /* @__PURE__ */ new Map();
+			for (const hook of triggeredHooks) {
+				const key = `${hook.namespace}:${hook.hookName}`;
+				const summary = hookSummary.get(key);
+				if (summary) {
+					summary.count += 1;
+					continue;
+				}
+				hookSummary.set(key, {
+					namespace: hook.namespace,
+					hookName: hook.hookName,
+					count: 1
+				});
+			}
+			return {
+				hooks: Array.from(hookSummary.values()),
+				total: triggeredHooks.length
+			};
+		}
+	});
 	const internalSchema = internalFragment.$internal.deps.schema;
 	const internalUow = uow.forSchema(internalSchema);
 	for (const hook of triggeredHooks) {
 		const maxAttempts = (hook.options?.retryPolicy ?? retryPolicy).shouldRetry(4) ? 5 : 1;
-		const nextRetryAt = (hook.options?.processAt ? new Date(hook.options.processAt) : null) ?? null;
-		internalUow.create("fragno_hooks", {
-			namespace,
+		const rawProcessAt = hook.options?.processAt ?? null;
+		const nextRetryAt = (rawProcessAt === null ? null : isDbNow(rawProcessAt) ? rawProcessAt : new Date(rawProcessAt)) ?? null;
+		const hookValues = {
+			...hook.options?.id !== void 0 ? { id: hook.options.id } : {},
+			namespace: hook.namespace,
 			hookName: hook.hookName,
 			payload: hook.payload,
 			status: "pending",
@@ -33,7 +75,8 @@ function prepareHookMutations(uow, config) {
 			nextRetryAt,
 			error: null,
 			nonce: uow.idempotencyKey
-		});
+		};
+		internalUow.create("fragno_hooks", hookValues);
 	}
 }
 /**
@@ -42,54 +85,129 @@ function prepareHookMutations(uow, config) {
 */
 async function processHooks(config) {
 	const { hooks, namespace, internalFragment, defaultRetryPolicy } = config;
+	if (!hooks) throw new Error("Hook processor hooks not initialized.");
 	const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });
 	const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(config.stuckProcessingTimeoutMinutes);
-	const getDbNow = async () => {
-		const services = internalFragment.services;
-		if (services.getDbNow) return services.getDbNow();
-		return /* @__PURE__ */ new Date();
-	};
-	const dbNow = await getDbNow();
-	if (stuckProcessingTimeoutMinutes !== false) {
-		const staleBefore = /* @__PURE__ */ new Date(dbNow.getTime() - stuckProcessingTimeoutMinutes * 6e4);
-		const stuckEvents = await internalFragment.inContext(async function() {
-			return await this.handlerTx().withServiceCalls(() => [internalFragment.services.hookService.requeueStuckProcessingHooks(namespace, staleBefore)]).transform(({ serviceResult: [events] }) => events).execute();
+	const internalSchema = internalFragment.$internal.deps.schema;
+	const includeStuckProcessing = stuckProcessingTimeoutMinutes !== false;
+	const staleBefore = includeStuckProcessing ? dbNow().plus({ minutes: -stuckProcessingTimeoutMinutes }) : null;
+	let claimedEvents = [];
+	let stuckEvents = [];
+	const result = await internalFragment.inContext(async function() {
+		return await this.handlerTx().withServiceCalls(() => {
+			return [internalFragment.services.hookService.claimPendingHookEvents(namespace), includeStuckProcessing ? internalFragment.services.hookService.claimStuckProcessingHookEvents(namespace, staleBefore) : void 0];
+		}).transform(({ serviceResult: [pendingEvents, stuckResult] }) => ({
+			pendingEvents,
+			stuckResult
+		})).execute();
+	});
+	const pendingCount = result.pendingEvents.length;
+	const stuckClaimedCount = result.stuckResult?.events.length ?? 0;
+	const stuckRequeuedCount = result.stuckResult?.stuckEvents.length ?? 0;
+	const staleBeforeApprox = includeStuckProcessing ? (/* @__PURE__ */ new Date(Date.now() - stuckProcessingTimeoutMinutes * 6e4)).toISOString() : null;
+	DurableHooksLogger.debug("Durable hooks claimed", {
+		namespace,
+		fields: {
+			pending: pendingCount,
+			stuck: stuckClaimedCount,
+			requeued: stuckRequeuedCount,
+			includeStuckProcessing,
+			staleBeforeApprox
+		}
+	});
+	claimedEvents = [...result.pendingEvents, ...result.stuckResult?.events ?? []].map((event) => ({
+		...event,
+		status: assertHookStatus(event.status)
+	}));
+	stuckEvents = result.stuckResult?.stuckEvents ?? [];
+	if (includeStuckProcessing && stuckEvents.length > 0) try {
+		config.onStuckProcessingHooks?.({
+			namespace,
+			timeoutMinutes: stuckProcessingTimeoutMinutes,
+			events: stuckEvents
+		});
+	} catch (error) {
+		DurableHooksLogger.error("Error calling onStuckProcessingHooks", {
+			namespace,
+			fields: { error: DurableHooksLogger.toErrorMessage(error) }
 		});
-		if (stuckEvents.length > 0) try {
-			config.onStuckProcessingHooks?.({
+	}
+	if (claimedEvents.length === 0) {
+		DurableHooksLogger.debug("Durable hooks idle", { namespace });
+		return 0;
+	}
+	const processedEvents = await Promise.allSettled(claimedEvents.map(async (event) => {
+		const hookFn = hooks[event.hookName];
+		if (!hookFn) {
+			DurableHooksLogger.error("Hook missing", {
 				namespace,
-				timeoutMinutes: stuckProcessingTimeoutMinutes,
-				events: stuckEvents
+				fields: {
+					eventId: event.id,
+					hookName: event.hookName,
+					attempts: event.attempts,
+					maxAttempts: event.maxAttempts,
+					createdAt: event.createdAt.toISOString()
+				}
 			});
-		} catch (error) {
-			console.error("Error calling onStuckProcessingHooks", error);
+			return {
+				eventId: event.id,
+				status: "failed",
+				error: `Hook '${event.hookName}' not found in hooks map`,
+				attempts: event.attempts,
+				maxAttempts: event.maxAttempts
+			};
 		}
-	}
-	const pendingEvents = await internalFragment.inContext(async function() {
-		return await this.handlerTx().withServiceCalls(() => [internalFragment.services.hookService.claimPendingHookEvents(namespace)]).transform(({ serviceResult: [events] }) => events).execute();
-	});
-	if (pendingEvents.length === 0) return 0;
-	const processedEvents = await Promise.allSettled(pendingEvents.map(async (event) => {
-		const hookFn = hooks[event.hookName];
-		if (!hookFn) return {
-			eventId: event.id,
-			status: "failed",
-			error: `Hook '${event.hookName}' not found in hooks map`,
-			attempts: event.attempts,
-			maxAttempts: event.maxAttempts
-		};
 		try {
+			const startedAt = Date.now();
+			DurableHooksLogger.debug("Hook start", {
+				namespace,
+				fields: {
+					eventId: event.id,
+					hookName: event.hookName,
+					status: event.status,
+					attempts: event.attempts,
+					maxAttempts: event.maxAttempts,
+					createdAt: event.createdAt.toISOString(),
+					nextRetryAt: event.nextRetryAt ? event.nextRetryAt.toISOString() : null,
+					lastAttemptAt: event.lastAttemptAt ? event.lastAttemptAt.toISOString() : null
+				}
+			});
 			const hookContext = {
 				idempotencyKey: event.idempotencyKey,
+				hookId: event.id,
+				hookName: event.hookName,
+				status: event.status,
+				attempts: event.attempts,
+				maxAttempts: event.maxAttempts,
+				lastAttemptAt: event.lastAttemptAt,
+				nextRetryAt: event.nextRetryAt,
+				createdAt: event.createdAt,
 				handlerTx: config.handlerTx
 			};
 			await hookFn.call(hookContext, event.payload);
+			DurableHooksLogger.debug("Hook completed", {
+				namespace,
+				fields: {
+					eventId: event.id,
+					hookName: event.hookName,
+					ms: Date.now() - startedAt
+				}
+			});
 			return {
 				eventId: event.id,
 				status: "completed"
 			};
 		} catch (error) {
 			const errorMessage = error instanceof Error ? error.message : String(error);
+			DurableHooksLogger.error("Hook failed", {
+				namespace,
+				fields: {
+					eventId: event.id.toJSON(),
+					hookName: event.hookName,
+					error: errorMessage,
+					idempotencyKey: event.idempotencyKey
+				}
+			});
 			return {
 				eventId: event.id,
 				status: "failed",
@@ -100,56 +218,99 @@ async function processHooks(config) {
 		}
 	}));
 	await internalFragment.inContext(async function() {
-		await this.handlerTx().withServiceCalls(() => {
-			const txResults = [];
+		await this.handlerTx().mutate(({ forSchema }) => {
+			const uow = forSchema(internalSchema);
+			const now = dbNow();
 			for (const processedEvent of processedEvents) {
-				if (processedEvent.status === "rejected") continue;
+				if (processedEvent.status === "rejected") {
+					DurableHooksLogger.error("Hook processing promise rejected", {
+						namespace,
+						fields: { error: DurableHooksLogger.toErrorMessage(processedEvent.reason) }
+					});
+					continue;
+				}
 				const { eventId, status } = processedEvent.value;
-				if (status === "completed") txResults.push(internalFragment.services.hookService.markHookCompleted(eventId));
-				else if (status === "failed") {
-					const { error, attempts } = processedEvent.value;
-					txResults.push(internalFragment.services.hookService.markHookFailed(eventId, error, attempts, retryPolicy, dbNow));
+				if (status === "completed") {
+					uow.update("fragno_hooks", eventId, (b) => b.set({
+						status: "completed",
+						lastAttemptAt: now
+					}).check());
+					continue;
 				}
+				const { error, attempts } = processedEvent.value;
+				const newAttempts = attempts + 1;
+				if (retryPolicy.shouldRetry(newAttempts - 1)) {
+					const delayMs = retryPolicy.getDelayMs(newAttempts - 1);
+					const nextRetryAt = now.plus({ ms: delayMs });
+					uow.update("fragno_hooks", eventId, (b) => b.set({
+						status: "pending",
+						attempts: newAttempts,
+						lastAttemptAt: now,
+						nextRetryAt,
+						error
+					}).check());
+				} else uow.update("fragno_hooks", eventId, (b) => b.set({
+					status: "failed",
+					attempts: newAttempts,
+					lastAttemptAt: now,
+					error
+				}).check());
 			}
-			return txResults;
 		}).execute();
 	});
-	return processedEvents.reduce((count, result) => count + (result.status === "fulfilled" ? 1 : 0), 0);
+	const processedCount = processedEvents.reduce((count, result$1) => count + (result$1.status === "fulfilled" ? 1 : 0), 0);
+	const failed = processedEvents.filter((result$1) => result$1.status === "fulfilled" && result$1.value.status === "failed").map((result$1) => {
+		if (result$1.status !== "fulfilled") return null;
+		return {
+			eventId: result$1.value.eventId,
+			error: result$1.value.error ?? null
+		};
+	}).filter(Boolean);
+	DurableHooksLogger.debug("Durable hooks processed", {
+		namespace,
+		fields: {
+			processed: processedCount,
+			failed: failed.length,
+			failures: failed.length > 0 ? failed : null
+		}
+	});
+	return processedCount;
 }
-function createHookScheduler(config) {
+function createDurableHooksRunner(config) {
 	let processing = false;
 	let queued = false;
 	let currentPromise = null;
-	const schedule = async () => {
+	const processDue = async () => {
 		if (processing) {
 			queued = true;
 			return currentPromise ?? Promise.resolve(0);
 		}
 		processing = true;
 		currentPromise = (async () => {
-			let lastCount = 0;
+			let totalProcessed = 0;
 			try {
 				do {
 					queued = false;
-					lastCount = await processHooks(config);
+					totalProcessed += await processHooks(config);
 				} while (queued);
-				return lastCount;
+				return totalProcessed;
 			} finally {
 				processing = false;
 				queued = false;
+				currentPromise = null;
 			}
 		})();
 		return currentPromise;
 	};
 	const drain = async () => {
-		while (true) if (await schedule() === 0) return;
+		while (true) if (await processDue() === 0) return;
 	};
 	return {
-		schedule,
+		processDue,
 		drain
 	};
 }
 
 //#endregion
-export { createHookScheduler, prepareHookMutations };
+export { createDurableHooksRunner, isHookStatus, prepareHookMutations };
 //# sourceMappingURL=hooks.js.map

package/dist/hooks/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","names":["hookContext: HookContext","txResults: TxResult<void>[]","currentPromise: Promise<number> | null"],"sources":["../../src/hooks/hooks.ts"],"sourcesContent":["import type {\n  ExecuteTxOptions,\n  HandlerTxBuilder,\n} from \"../query/unit-of-work/execute-unit-of-work\";\nimport type { RetryPolicy } from \"../query/unit-of-work/retry-policy\";\nimport { ExponentialBackoffRetryPolicy } from \"../query/unit-of-work/retry-policy\";\nimport type { IUnitOfWork } from \"../query/unit-of-work/unit-of-work\";\nimport type { InternalFragmentInstance } from \"../fragments/internal-fragment\";\nimport type { TxResult } from \"../query/unit-of-work/execute-unit-of-work\";\nimport type { FragnoId } from \"../schema/create\";\n\n/**\n * Context available in hook functions via `this`.\n * Contains the idempotency key for idempotency and database access.\n */\nexport interface HookContext {\n  /**\n   * Unique idempotency key for this transaction.\n   * Use this for idempotency checks in your hook implementation.\n   */\n  idempotencyKey: string;\n  /**\n   * Create a handler transaction builder to run atomic operations.\n   */\n  handlerTx: HookHandlerTx;\n}\n\n/**\n * A hook function signature.\n * Hooks receive a typed payload and access context via `this`.\n */\nexport type HookFn<TPayload = unknown> = (payload: TPayload) => void | Promise<void>;\n\n/**\n * Map of hook names to hook functions.\n * Used for type-safe hook definitions and triggering.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type HooksMap = Record<string, HookFn<any>>;\n\n/**\n * Extract the payload type from a hook function.\n */\nexport type HookPayload<T> = T extends HookFn<infer P> ? P : never;\n\n/**\n * Options for triggering a hook.\n */\nexport interface TriggerHookOptions {\n  /**\n   * Optional retry policy override for this specific hook trigger.\n   * If not provided, uses the default retry policy.\n   */\n  retryPolicy?: RetryPolicy;\n  /**\n   * Absolute time for the first attempt. If in the future, the hook is\n   * scheduled for that time; if in the past, it runs immediately.\n   */\n  processAt?: Date;\n}\n\n/**\n * Internal representation of a triggered hook.\n * Stored in the Unit of Work before execution.\n */\nexport interface TriggeredHook {\n  hookName: string;\n  payload: unknown;\n  options?: TriggerHookOptions;\n}\n\nexport type HookScheduler = {\n  schedule: () => Promise<number>;\n  drain: () => Promise<void>;\n};\n\n/**\n * Configuration for hook processing.\n */\nexport interface HookProcessorConfig<THooks extends HooksMap = HooksMap> {\n  hooks: THooks;\n  namespace: string;\n  internalFragment: InternalFragmentInstance;\n  handlerTx: HookHandlerTx;\n  /**\n   * Internal hook scheduler used to coordinate processing/drain.\n   */\n  scheduler?: HookScheduler;\n  defaultRetryPolicy?: RetryPolicy;\n  /**\n   * Re-queue hooks that have been in `processing` for at least this many minutes.\n   * Use `false` to disable stuck-processing recovery entirely.\n   * Values <= 0 are treated as `false`.\n   *\n   * Default: 10 minutes.\n   */\n  stuckProcessingTimeoutMinutes?: StuckHookProcessingTimeoutMinutes;\n  /**\n   * Called when stuck processing hooks are detected and re-queued.\n   * Invoked after the hooks are moved back to `pending`.\n   */\n  onStuckProcessingHooks?: (info: StuckHookProcessingInfo) => void;\n}\n\nexport type StuckHookProcessingTimeoutMinutes = number | false;\n\nexport type StuckHookProcessingEvent = {\n  id: FragnoId;\n  hookName: string;\n  attempts: number;\n  maxAttempts: number;\n  lastAttemptAt: Date | null;\n  nextRetryAt: Date | null;\n};\n\nexport type StuckHookProcessingInfo = {\n  namespace: string;\n  timeoutMinutes: number;\n  events: StuckHookProcessingEvent[];\n};\n\nexport type DurableHooksProcessingOptions = {\n  /**\n   * Re-queue hooks that have been in `processing` for at least this many minutes.\n   * Use `false` to disable stuck-processing recovery entirely.\n   * Values <= 0 are treated as `false`.\n   *\n   * Default: 10 minutes.\n   */\n  stuckProcessingTimeoutMinutes?: StuckHookProcessingTimeoutMinutes;\n  /**\n   * Called when stuck processing hooks are detected and re-queued.\n   * Invoked after the hooks are moved back to `pending`.\n   */\n  onStuckProcessingHooks?: (info: StuckHookProcessingInfo) => void;\n};\n\nexport type HookHandlerTx = (\n  execOptions?: Omit<ExecuteTxOptions, \"createUnitOfWork\">,\n) => HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, HooksMap>;\n\nconst DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES = 10;\n\nfunction resolveStuckProcessingTimeoutMinutes(\n  value: StuckHookProcessingTimeoutMinutes | undefined,\n): number | false {\n  if (value === false) {\n    return false;\n  }\n  if (typeof value === \"number\") {\n    return value > 0 ? value : false;\n  }\n  return DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES;\n}\n\n/**\n * Add hook events as mutation operations to the UOW.\n * This should be called before executeMutations() so hook records are created\n * in the same transaction as the user's mutations.\n */\nexport function prepareHookMutations<THooks extends HooksMap>(\n  uow: IUnitOfWork,\n  config: HookProcessorConfig<THooks>,\n): void {\n  const { namespace, internalFragment, defaultRetryPolicy } = config;\n  const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });\n\n  const triggeredHooks = uow.getTriggeredHooks();\n\n  if (triggeredHooks.length === 0) {\n    return;\n  }\n\n  const internalSchema = internalFragment.$internal.deps.schema;\n  const internalUow = uow.forSchema(internalSchema);\n\n  for (const hook of triggeredHooks) {\n    const hookRetryPolicy = hook.options?.retryPolicy ?? retryPolicy;\n    const maxAttempts = hookRetryPolicy.shouldRetry(4) ? 5 : 1;\n    const processAt = hook.options?.processAt ? new Date(hook.options.processAt) : null;\n    const nextRetryAt = processAt ?? null;\n    internalUow.create(\"fragno_hooks\", {\n      namespace,\n      hookName: hook.hookName,\n      payload: hook.payload,\n      status: \"pending\",\n      attempts: 0,\n      maxAttempts,\n      lastAttemptAt: null,\n      nextRetryAt,\n      error: null,\n      nonce: uow.idempotencyKey,\n    });\n  }\n}\n\n/**\n * Process pending hook events after the transaction has committed.\n * This should be called in the onSuccess callback after executeMutations().\n */\nexport async function processHooks<THooks extends HooksMap>(\n  config: HookProcessorConfig<THooks>,\n): Promise<number> {\n  const { hooks, namespace, internalFragment, defaultRetryPolicy } = config;\n  const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });\n  const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(\n    config.stuckProcessingTimeoutMinutes,\n  );\n  const getDbNow = async () => {\n    const services = internalFragment.services as { getDbNow?: () => Promise<Date> };\n    if (services.getDbNow) {\n      return services.getDbNow();\n    }\n    return new Date();\n  };\n  const dbNow = await getDbNow();\n\n  if (stuckProcessingTimeoutMinutes !== false) {\n    const staleBefore = new Date(dbNow.getTime() - stuckProcessingTimeoutMinutes * 60_000);\n    const stuckEvents = await internalFragment.inContext(async function () {\n      return await this.handlerTx()\n        .withServiceCalls(\n          () =>\n            [\n              internalFragment.services.hookService.requeueStuckProcessingHooks(\n                namespace,\n                staleBefore,\n              ),\n            ] as const,\n        )\n        .transform(({ serviceResult: [events] }) => events)\n        .execute();\n    });\n\n    if (stuckEvents.length > 0) {\n      try {\n        config.onStuckProcessingHooks?.({\n          namespace,\n          timeoutMinutes: stuckProcessingTimeoutMinutes,\n          events: stuckEvents,\n        });\n      } catch (error) {\n        console.error(\"Error calling onStuckProcessingHooks\", error);\n      }\n    }\n  }\n\n  // Claim pending events in the same transaction to avoid double-processing.\n  const pendingEvents = await internalFragment.inContext(async function () {\n    return await this.handlerTx()\n      .withServiceCalls(\n        () => [internalFragment.services.hookService.claimPendingHookEvents(namespace)] as const,\n      )\n      .transform(({ serviceResult: [events] }) => events)\n      .execute();\n  });\n\n  if (pendingEvents.length === 0) {\n    return 0;\n  }\n\n  // Process events (async work outside transaction)\n  const processedEvents = await Promise.allSettled(\n    pendingEvents.map(async (event) => {\n      const hookFn = hooks[event.hookName];\n      if (!hookFn) {\n        return {\n          eventId: event.id,\n          status: \"failed\" as const,\n          error: `Hook '${event.hookName}' not found in hooks map`,\n          attempts: event.attempts,\n          maxAttempts: event.maxAttempts,\n        };\n      }\n\n      try {\n        const hookContext: HookContext = {\n          idempotencyKey: event.idempotencyKey,\n          handlerTx: config.handlerTx,\n        };\n        await hookFn.call(hookContext, event.payload);\n        return {\n          eventId: event.id,\n          status: \"completed\" as const,\n        };\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        return {\n          eventId: event.id,\n          status: \"failed\" as const,\n          error: errorMessage,\n          attempts: event.attempts,\n          maxAttempts: event.maxAttempts,\n        };\n      }\n    }),\n  );\n\n  // Mark events as completed/failed\n  await internalFragment.inContext(async function () {\n    await this.handlerTx()\n      .withServiceCalls(() => {\n        const txResults: TxResult<void>[] = [];\n        for (const processedEvent of processedEvents) {\n          if (processedEvent.status === \"rejected\") {\n            continue;\n          }\n\n          const { eventId, status } = processedEvent.value;\n\n          if (status === \"completed\") {\n            txResults.push(internalFragment.services.hookService.markHookCompleted(eventId));\n          } else if (status === \"failed\") {\n            const { error, attempts } = processedEvent.value;\n            txResults.push(\n              internalFragment.services.hookService.markHookFailed(\n                eventId,\n                error,\n                attempts,\n                retryPolicy,\n                dbNow,\n              ),\n            );\n          }\n        }\n        return txResults;\n      })\n      .execute();\n  });\n\n  const processedCount = processedEvents.reduce(\n    (count, result) => count + (result.status === \"fulfilled\" ? 1 : 0),\n    0,\n  );\n\n  return processedCount;\n}\n\nexport function createHookScheduler(config: HookProcessorConfig): HookScheduler {\n  let processing = false;\n  let queued = false;\n  let currentPromise: Promise<number> | null = null;\n\n  const schedule = async () => {\n    if (processing) {\n      queued = true;\n      return currentPromise ?? Promise.resolve(0);\n    }\n\n    processing = true;\n    currentPromise = (async () => {\n      let lastCount = 0;\n      try {\n        do {\n          queued = false;\n          lastCount = await processHooks(config);\n        } while (queued);\n        return lastCount;\n      } finally {\n        processing = false;\n        queued = false;\n      }\n    })();\n\n    return currentPromise;\n  };\n\n  const drain = async () => {\n    while (true) {\n      const processed = await schedule();\n      if (processed === 0) {\n        return;\n      }\n    }\n  };\n\n  return { schedule, drain };\n}\n"],"mappings":"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"}
+{"version":3,"file":"hooks.js","names":["claimedEvents: Array<{\n    id: FragnoId;\n    hookName: string;\n    payload: unknown;\n    status: HookStatus;\n    attempts: number;\n    maxAttempts: number;\n    idempotencyKey: string;\n    lastAttemptAt: Date | null;\n    nextRetryAt: Date | null;\n    createdAt: Date;\n  }>","stuckEvents: StuckHookProcessingEvent[]","hookContext: HookContext","result","currentPromise: Promise<number> | null"],"sources":["../../src/hooks/hooks.ts"],"sourcesContent":["import type { InternalFragmentInstance } from \"../fragments/internal-fragment\";\nimport { dbNow, isDbNow, type DbNow } from \"../query/db-now\";\nimport type {\n  ExecuteTxOptions,\n  HandlerTxBuilder,\n} from \"../query/unit-of-work/execute-unit-of-work\";\nimport type { RetryPolicy } from \"../query/unit-of-work/retry-policy\";\nimport { ExponentialBackoffRetryPolicy } from \"../query/unit-of-work/retry-policy\";\nimport type { IUnitOfWork } from \"../query/unit-of-work/unit-of-work\";\nimport type { FragnoId } from \"../schema/create\";\nimport { DurableHooksLogger, type DurableHooksLoggerConfig } from \"./durable-hooks-logger\";\n\n/**\n * Context available in hook functions via `this`.\n * Contains the idempotency key for idempotency and database access.\n */\nexport interface HookContext {\n  /**\n   * Unique idempotency key for this transaction.\n   * Use this for idempotency checks in your hook implementation.\n   */\n  idempotencyKey: string;\n  /**\n   * Hook event identifier (versioned FragnoId).\n   */\n  hookId: FragnoId;\n  /**\n   * Hook name for this event.\n   */\n  hookName: string;\n  /**\n   * Current status of the hook event.\n   */\n  status: HookStatus;\n  /**\n   * Attempt count for this hook event.\n   */\n  attempts: number;\n  /**\n   * Maximum attempts configured for this hook event.\n   */\n  maxAttempts: number;\n  /**\n   * Timestamp of the last attempt (if any).\n   */\n  lastAttemptAt: Date | null;\n  /**\n   * Next scheduled retry timestamp (if any).\n   */\n  nextRetryAt: Date | null;\n  /**\n   * When the hook event was created.\n   */\n  createdAt: Date;\n  /**\n   * Create a handler transaction builder to run atomic operations.\n   */\n  handlerTx: HookHandlerTx;\n}\n\nexport const hookStatusValues = [\"pending\", \"processing\", \"completed\", \"failed\"] as const;\n\nexport type HookStatus = (typeof hookStatusValues)[number];\n\nexport const isHookStatus = (value: unknown): value is HookStatus =>\n  typeof value === \"string\" && hookStatusValues.includes(value as HookStatus);\n\nconst assertHookStatus = (value: unknown): HookStatus => {\n  if (isHookStatus(value)) {\n    return value;\n  }\n  throw new Error(`Invalid hook status: ${String(value)}`);\n};\n\n/**\n * A hook function signature.\n * Hooks receive a typed payload and access context via `this`.\n */\nexport type HookFn<TPayload = unknown> = (payload: TPayload) => void | Promise<void>;\n\n/**\n * Map of hook names to hook functions.\n * Used for type-safe hook definitions and triggering.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type HooksMap = Record<string, HookFn<any>>;\n\n/**\n * Extract the payload type from a hook function.\n */\nexport type HookPayload<T> = T extends HookFn<infer P> ? P : never;\n\n/**\n * Options for triggering a hook.\n */\nexport interface TriggerHookOptions {\n  /**\n   * Optional retry policy override for this specific hook trigger.\n   * If not provided, uses the default retry policy.\n   */\n  retryPolicy?: RetryPolicy;\n  /**\n   * Optional hook event ID. When provided, the hook insert will fail if a hook\n   * with the same ID already exists.\n   */\n  id?: string | FragnoId;\n  /**\n   * Absolute time for the first attempt. If in the future, the hook is\n   * scheduled for that time; if in the past, it runs immediately.\n   */\n  processAt?: Date | DbNow;\n}\n\n/**\n * Internal representation of a triggered hook.\n * Stored in the Unit of Work before execution.\n */\nexport interface TriggeredHook {\n  namespace: string;\n  hookName: string;\n  payload: unknown;\n  options?: TriggerHookOptions;\n}\n\nexport type HookNotifySource = \"request\" | \"hook\" | \"alarm\";\n\nexport type HookNotifyContext = {\n  source: HookNotifySource;\n  route?: string | null;\n  waitUntil?: (promise: Promise<unknown>) => void;\n};\n\nexport type HookNotifier = {\n  notify: (context: HookNotifyContext) => void | Promise<void>;\n};\n\nexport type DurableHooksRunner = {\n  processDue: () => Promise<number>;\n  drain: () => Promise<void>;\n};\n\n/**\n * @deprecated Use DurableHooksRunner.\n */\nexport type HookScheduler = {\n  schedule: () => Promise<number>;\n  drain: () => Promise<void>;\n};\n\n/**\n * Configuration for hook processing.\n */\nexport interface HookProcessorConfig<THooks extends HooksMap = HooksMap> {\n  hooks?: THooks;\n  namespace: string;\n  internalFragment: InternalFragmentInstance;\n  handlerTx: HookHandlerTx;\n  /**\n   * Whether post-mutate notifications should auto-schedule processing.\n   * Defaults to true.\n   */\n  autoSchedule?: boolean;\n  /**\n   * Internal hook runner used to coordinate processing/drain.\n   */\n  runner?: DurableHooksRunner;\n  /**\n   * Post-commit durable hooks notifier.\n   */\n  notifier?: HookNotifier;\n  /**\n   * @deprecated Use `runner`.\n   */\n  scheduler?: HookScheduler;\n  defaultRetryPolicy?: RetryPolicy;\n  /**\n   * Re-queue hooks that have been in `processing` for at least this many minutes.\n   * Use `false` to disable stuck-processing recovery entirely.\n   * Values <= 0 are treated as `false`.\n   *\n   * Default: 10 minutes.\n   */\n  stuckProcessingTimeoutMinutes?: StuckHookProcessingTimeoutMinutes;\n  /**\n   * Called when stuck processing hooks are detected and re-queued.\n   * Invoked after the hooks are moved back to `pending`.\n   */\n  onStuckProcessingHooks?: (info: StuckHookProcessingInfo) => void;\n}\n\nexport type StuckHookProcessingTimeoutMinutes = number | false;\n\nexport type StuckHookProcessingEvent = {\n  id: FragnoId;\n  hookName: string;\n  attempts: number;\n  maxAttempts: number;\n  lastAttemptAt: Date | null;\n  nextRetryAt: Date | null;\n};\n\nexport type StuckHookProcessingInfo = {\n  namespace: string;\n  timeoutMinutes: number;\n  events: StuckHookProcessingEvent[];\n};\n\nexport type DurableHooksProcessingOptions = {\n  /**\n   * Re-queue hooks that have been in `processing` for at least this many minutes.\n   * Use `false` to disable stuck-processing recovery entirely.\n   * Values <= 0 are treated as `false`.\n   *\n   * Default: 10 minutes.\n   */\n  stuckProcessingTimeoutMinutes?: StuckHookProcessingTimeoutMinutes;\n  /**\n   * Automatically schedule hook processing after successful mutations.\n   * Defaults to true. Set false to disable auto scheduling (manual drain only).\n   */\n  autoSchedule?: boolean;\n  /**\n   * Called when stuck processing hooks are detected and re-queued.\n   * Invoked after the hooks are moved back to `pending`.\n   */\n  onStuckProcessingHooks?: (info: StuckHookProcessingInfo) => void;\n  /**\n   * Durable hooks logging controls.\n   * Defaults: enabled=true, level=\"warn\".\n   */\n  logging?: DurableHooksLoggerConfig;\n};\n\nexport type HookHandlerTx = (\n  execOptions?: Omit<ExecuteTxOptions, \"createUnitOfWork\">,\n) => HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, HooksMap>;\n\nconst DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES = 10;\n\nfunction resolveStuckProcessingTimeoutMinutes(\n  value: StuckHookProcessingTimeoutMinutes | undefined,\n): number | false {\n  if (value === false) {\n    return false;\n  }\n  if (typeof value === \"number\") {\n    return value > 0 ? value : false;\n  }\n  return DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES;\n}\n\n/**\n * Add hook events as mutation operations to the UOW.\n * This should be called before executeMutations() so hook records are created\n * in the same transaction as the user's mutations.\n *\n * Each triggered hook carries its own namespace (set at trigger-time), so this\n * function works regardless of which fragment's handler is executing. When a\n * `config` is provided its `defaultRetryPolicy` is used as fallback.\n */\nexport function prepareHookMutations(\n  uow: Pick<IUnitOfWork, \"getTriggeredHooks\" | \"forSchema\" | \"idempotencyKey\">,\n  internalFragment: InternalFragmentInstance,\n  defaultRetryPolicy?: RetryPolicy,\n): void {\n  const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });\n\n  const triggeredHooks = uow.getTriggeredHooks();\n\n  if (triggeredHooks.length === 0) {\n    return;\n  }\n\n  const primaryNamespace = triggeredHooks[0]?.namespace;\n  DurableHooksLogger.debug(\"Durable hooks queued\", {\n    namespace: primaryNamespace,\n    fields: () => {\n      const hookSummary = new Map<string, { namespace: string; hookName: string; count: number }>();\n      for (const hook of triggeredHooks) {\n        const key = `${hook.namespace}:${hook.hookName}`;\n        const summary = hookSummary.get(key);\n        if (summary) {\n          summary.count += 1;\n          continue;\n        }\n        hookSummary.set(key, {\n          namespace: hook.namespace,\n          hookName: hook.hookName,\n          count: 1,\n        });\n      }\n      const hooks = Array.from(hookSummary.values());\n      return {\n        hooks,\n        total: triggeredHooks.length,\n      };\n    },\n  });\n\n  const internalSchema = internalFragment.$internal.deps.schema;\n  const internalUow = uow.forSchema(internalSchema);\n\n  for (const hook of triggeredHooks) {\n    const hookRetryPolicy = hook.options?.retryPolicy ?? retryPolicy;\n    const maxAttempts = hookRetryPolicy.shouldRetry(4) ? 5 : 1;\n    const rawProcessAt = hook.options?.processAt ?? null;\n    const processAt: Date | DbNow | null =\n      rawProcessAt === null ? null : isDbNow(rawProcessAt) ? rawProcessAt : new Date(rawProcessAt);\n    const nextRetryAt = processAt ?? null;\n    const hookValues = {\n      ...(hook.options?.id !== undefined ? { id: hook.options.id } : {}),\n      namespace: hook.namespace,\n      hookName: hook.hookName,\n      payload: hook.payload,\n      status: \"pending\",\n      attempts: 0,\n      maxAttempts,\n      lastAttemptAt: null,\n      nextRetryAt,\n      error: null,\n      nonce: uow.idempotencyKey,\n    };\n\n    internalUow.create(\"fragno_hooks\", hookValues);\n  }\n}\n\n/**\n * Process pending hook events after the transaction has committed.\n * This should be called in the onSuccess callback after executeMutations().\n */\nexport async function processHooks<THooks extends HooksMap>(\n  config: HookProcessorConfig<THooks>,\n): Promise<number> {\n  const { hooks, namespace, internalFragment, defaultRetryPolicy } = config;\n  if (!hooks) {\n    throw new Error(\"Hook processor hooks not initialized.\");\n  }\n  const retryPolicy = defaultRetryPolicy ?? new ExponentialBackoffRetryPolicy({ maxRetries: 5 });\n  const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(\n    config.stuckProcessingTimeoutMinutes,\n  );\n  const internalSchema = internalFragment.$internal.deps.schema;\n  const includeStuckProcessing = stuckProcessingTimeoutMinutes !== false;\n  const staleBefore = includeStuckProcessing\n    ? dbNow().plus({ minutes: -stuckProcessingTimeoutMinutes })\n    : null;\n  let claimedEvents: Array<{\n    id: FragnoId;\n    hookName: string;\n    payload: unknown;\n    status: HookStatus;\n    attempts: number;\n    maxAttempts: number;\n    idempotencyKey: string;\n    lastAttemptAt: Date | null;\n    nextRetryAt: Date | null;\n    createdAt: Date;\n  }> = [];\n  let stuckEvents: StuckHookProcessingEvent[] = [];\n\n  const result = await internalFragment.inContext(async function () {\n    return await this.handlerTx()\n      .withServiceCalls(() => {\n        const pending = internalFragment.services.hookService.claimPendingHookEvents(namespace);\n        const stuck = includeStuckProcessing\n          ? internalFragment.services.hookService.claimStuckProcessingHookEvents(\n              namespace,\n              staleBefore!,\n            )\n          : undefined;\n        return [pending, stuck] as const;\n      })\n      .transform(({ serviceResult: [pendingEvents, stuckResult] }) => ({\n        pendingEvents,\n        stuckResult,\n      }))\n      .execute();\n  });\n\n  const pendingCount = result.pendingEvents.length;\n  const stuckClaimedCount = result.stuckResult?.events.length ?? 0;\n  const stuckRequeuedCount = result.stuckResult?.stuckEvents.length ?? 0;\n  const staleBeforeApprox = includeStuckProcessing\n    ? new Date(Date.now() - stuckProcessingTimeoutMinutes * 60_000).toISOString()\n    : null;\n  DurableHooksLogger.debug(\"Durable hooks claimed\", {\n    namespace,\n    fields: {\n      pending: pendingCount,\n      stuck: stuckClaimedCount,\n      requeued: stuckRequeuedCount,\n      includeStuckProcessing,\n      staleBeforeApprox,\n    },\n  });\n\n  claimedEvents = [...result.pendingEvents, ...(result.stuckResult?.events ?? [])].map((event) => ({\n    ...event,\n    status: assertHookStatus(event.status),\n  }));\n  stuckEvents = result.stuckResult?.stuckEvents ?? [];\n\n  if (includeStuckProcessing && stuckEvents.length > 0) {\n    try {\n      config.onStuckProcessingHooks?.({\n        namespace,\n        timeoutMinutes: stuckProcessingTimeoutMinutes,\n        events: stuckEvents,\n      });\n    } catch (error) {\n      DurableHooksLogger.error(\"Error calling onStuckProcessingHooks\", {\n        namespace,\n        fields: {\n          error: DurableHooksLogger.toErrorMessage(error),\n        },\n      });\n    }\n  }\n\n  if (claimedEvents.length === 0) {\n    DurableHooksLogger.debug(\"Durable hooks idle\", {\n      namespace,\n    });\n    return 0;\n  }\n\n  // Process events (async work outside transaction)\n  const processedEvents = await Promise.allSettled(\n    claimedEvents.map(async (event) => {\n      const hookFn = hooks[event.hookName];\n      if (!hookFn) {\n        DurableHooksLogger.error(\"Hook missing\", {\n          namespace,\n          fields: {\n            eventId: event.id,\n            hookName: event.hookName,\n            attempts: event.attempts,\n            maxAttempts: event.maxAttempts,\n            createdAt: event.createdAt.toISOString(),\n          },\n        });\n        return {\n          eventId: event.id,\n          status: \"failed\" as const,\n          error: `Hook '${event.hookName}' not found in hooks map`,\n          attempts: event.attempts,\n          maxAttempts: event.maxAttempts,\n        };\n      }\n\n      try {\n        const startedAt = Date.now();\n        DurableHooksLogger.debug(\"Hook start\", {\n          namespace,\n          fields: {\n            eventId: event.id,\n            hookName: event.hookName,\n            status: event.status,\n            attempts: event.attempts,\n            maxAttempts: event.maxAttempts,\n            createdAt: event.createdAt.toISOString(),\n            nextRetryAt: event.nextRetryAt ? event.nextRetryAt.toISOString() : null,\n            lastAttemptAt: event.lastAttemptAt ? event.lastAttemptAt.toISOString() : null,\n          },\n        });\n        const hookContext: HookContext = {\n          idempotencyKey: event.idempotencyKey,\n          hookId: event.id,\n          hookName: event.hookName,\n          status: event.status,\n          attempts: event.attempts,\n          maxAttempts: event.maxAttempts,\n          lastAttemptAt: event.lastAttemptAt,\n          nextRetryAt: event.nextRetryAt,\n          createdAt: event.createdAt,\n          handlerTx: config.handlerTx,\n        };\n        await hookFn.call(hookContext, event.payload);\n        DurableHooksLogger.debug(\"Hook completed\", {\n          namespace,\n          fields: {\n            eventId: event.id,\n            hookName: event.hookName,\n            ms: Date.now() - startedAt,\n          },\n        });\n        return {\n          eventId: event.id,\n          status: \"completed\" as const,\n        };\n      } catch (error) {\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        DurableHooksLogger.error(\"Hook failed\", {\n          namespace,\n          fields: {\n            eventId: event.id.toJSON(),\n            hookName: event.hookName,\n            error: errorMessage,\n            idempotencyKey: event.idempotencyKey,\n          },\n        });\n        return {\n          eventId: event.id,\n          status: \"failed\" as const,\n          error: errorMessage,\n          attempts: event.attempts,\n          maxAttempts: event.maxAttempts,\n        };\n      }\n    }),\n  );\n\n  // Mark events as completed/failed\n  await internalFragment.inContext(async function () {\n    await this.handlerTx()\n      .mutate(({ forSchema }) => {\n        const uow = forSchema(internalSchema);\n        const now = dbNow();\n\n        for (const processedEvent of processedEvents) {\n          if (processedEvent.status === \"rejected\") {\n            DurableHooksLogger.error(\"Hook processing promise rejected\", {\n              namespace,\n              fields: {\n                error: DurableHooksLogger.toErrorMessage(processedEvent.reason),\n              },\n            });\n            continue;\n          }\n\n          const { eventId, status } = processedEvent.value;\n\n          if (status === \"completed\") {\n            uow.update(\"fragno_hooks\", eventId, (b) =>\n              b.set({ status: \"completed\", lastAttemptAt: now }).check(),\n            );\n            continue;\n          }\n\n          const { error, attempts } = processedEvent.value;\n          const newAttempts = attempts + 1;\n          const shouldRetry = retryPolicy.shouldRetry(newAttempts - 1);\n\n          if (shouldRetry) {\n            const delayMs = retryPolicy.getDelayMs(newAttempts - 1);\n            const nextRetryAt = now.plus({ ms: delayMs });\n            uow.update(\"fragno_hooks\", eventId, (b) =>\n              b\n                .set({\n                  status: \"pending\",\n                  attempts: newAttempts,\n                  lastAttemptAt: now,\n                  nextRetryAt,\n                  error,\n                })\n                .check(),\n            );\n          } else {\n            uow.update(\"fragno_hooks\", eventId, (b) =>\n              b\n                .set({\n                  status: \"failed\",\n                  attempts: newAttempts,\n                  lastAttemptAt: now,\n                  error,\n                })\n                .check(),\n            );\n          }\n        }\n      })\n      .execute();\n  });\n\n  const processedCount = processedEvents.reduce(\n    (count, result) => count + (result.status === \"fulfilled\" ? 1 : 0),\n    0,\n  );\n\n  const failed = processedEvents\n    .filter((result) => result.status === \"fulfilled\" && result.value.status === \"failed\")\n    .map((result) => {\n      if (result.status !== \"fulfilled\") {\n        return null;\n      }\n      return {\n        eventId: result.value.eventId,\n        error: result.value.error ?? null,\n      };\n    })\n    .filter(Boolean);\n\n  DurableHooksLogger.debug(\"Durable hooks processed\", {\n    namespace,\n    fields: {\n      processed: processedCount,\n      failed: failed.length,\n      failures: failed.length > 0 ? failed : null,\n    },\n  });\n\n  return processedCount;\n}\n\nexport function createDurableHooksRunner(config: HookProcessorConfig): DurableHooksRunner {\n  let processing = false;\n  let queued = false;\n  let currentPromise: Promise<number> | null = null;\n\n  const processDue = async () => {\n    if (processing) {\n      queued = true;\n      return currentPromise ?? Promise.resolve(0);\n    }\n\n    processing = true;\n    currentPromise = (async () => {\n      let totalProcessed = 0;\n      try {\n        do {\n          queued = false;\n          totalProcessed += await processHooks(config);\n        } while (queued);\n        return totalProcessed;\n      } finally {\n        processing = false;\n        queued = false;\n        currentPromise = null;\n      }\n    })();\n\n    return currentPromise;\n  };\n\n  const drain = async () => {\n    while (true) {\n      const processed = await processDue();\n      if (processed === 0) {\n        return;\n      }\n    }\n  };\n\n  return { processDue, drain };\n}\n\n/**\n * @deprecated Use createDurableHooksRunner.\n */\nexport function createHookScheduler(config: HookProcessorConfig): HookScheduler {\n  const runner = createDurableHooksRunner(config);\n  return {\n    schedule: () => runner.processDue(),\n    drain: () => runner.drain(),\n  };\n}\n"],"mappings":"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"}

package/dist/id.d.ts

@@ -1,2 +1,2 @@
-import { createId } from "@paralleldrive/cuid2";
-export { createId };
+import { createId, init } from "@fragno-dev/core";
+export { createId, init };

package/dist/id.js

@@ -1,3 +1,3 @@
-import { createId } from "@paralleldrive/cuid2";
+import { createId, init } from "@fragno-dev/core";
 
-export { createId };
+export { createId, init };

package/dist/internal/adapter-registry.d.ts

@@ -0,0 +1,11 @@
+import "../sync/types.js";
+import "./outbox-state.js";
+import { InternalFragmentInstance } from "../fragments/internal-fragment.js";
+import { DatabaseAdapter } from "../adapters/adapters.js";
+
+//#region src/internal/adapter-registry.d.ts
+
+declare const getInternalFragment: <TUOWConfig>(adapter: DatabaseAdapter<TUOWConfig>) => InternalFragmentInstance;
+//#endregion
+export { getInternalFragment };
+//# sourceMappingURL=adapter-registry.d.ts.map

package/dist/internal/adapter-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.d.ts","names":[],"sources":["../../src/internal/adapter-registry.ts"],"sourcesContent":[],"mappings":";;;;;;;cAoOa,2CACF,gBAAgB,gBACxB"}

package/dist/internal/adapter-registry.js

@@ -0,0 +1,135 @@
+import { getOutboxStateForAdapter } from "./outbox-state.js";
+import { SchemaRegistryCollisionError, internalFragmentDef } from "../fragments/internal-fragment.js";
+import { createInternalFragmentDescribeRoutes, createInternalFragmentOutboxRoutes, createInternalFragmentSyncRoutes } from "../fragments/internal-fragment.routes.js";
+import { instantiate } from "@fragno-dev/core";
+
+//#region src/internal/adapter-registry.ts
+const registryByAdapter = /* @__PURE__ */ new WeakMap();
+const toAdapterKey = (adapter) => adapter;
+const isDryRun = () => process.env["FRAGNO_INIT_DRY_RUN"] === "true";
+const getNamespaceKey = (schema) => schema.namespace ?? schema.name;
+const getSyncTargetKey = (fragmentName, schemaName) => `${fragmentName}::${schemaName}`;
+const sortSchemas = (schemas) => schemas.sort((a, b) => {
+	const namespaceA = a.namespace ?? "";
+	const namespaceB = b.namespace ?? "";
+	if (namespaceA !== namespaceB) return namespaceA.localeCompare(namespaceB);
+	if (a.name !== b.name) return a.name.localeCompare(b.name);
+	return a.version - b.version;
+});
+const sortFragments = (fragments) => fragments.sort((a, b) => a.name.localeCompare(b.name));
+const buildInternalFragment = (adapter, registry) => {
+	const routes = [
+		createInternalFragmentDescribeRoutes(),
+		createInternalFragmentOutboxRoutes(),
+		createInternalFragmentSyncRoutes()
+	];
+	return instantiate(internalFragmentDef).withConfig({ registry }).withOptions({
+		databaseAdapter: adapter,
+		databaseNamespace: null
+	}).withRoutes(routes).build();
+};
+const createRegistry = (adapter) => {
+	const schemas = /* @__PURE__ */ new Map();
+	const fragments = /* @__PURE__ */ new Map();
+	const outboxState = getOutboxStateForAdapter(adapter);
+	const syncCommandTargets = /* @__PURE__ */ new Map();
+	let registry;
+	registry = {
+		internalFragment: void 0,
+		schemas,
+		fragments,
+		outboxState,
+		syncCommandTargets,
+		registerSchema: (schema, fragment, options) => {
+			const namespaceKey = getNamespaceKey(schema);
+			const existing = schemas.get(namespaceKey);
+			if (existing && (existing.name !== schema.name || existing.namespace !== schema.namespace)) throw new SchemaRegistryCollisionError({
+				namespaceKey,
+				existing: {
+					name: existing.name,
+					namespace: existing.namespace
+				},
+				attempted: {
+					name: schema.name,
+					namespace: schema.namespace
+				}
+			});
+			const schemaCopy = {
+				...schema,
+				tables: [...schema.tables]
+			};
+			if (existing && existing.name === schemaCopy.name && existing.namespace === schemaCopy.namespace && existing.version === schemaCopy.version && existing.tables.length === schemaCopy.tables.length && existing.tables.every((table, index) => table === schemaCopy.tables[index])) {
+				fragments.set(fragment.name, { ...fragment });
+				if (options?.outboxEnabled) {
+					outboxState.enabledSchemaKeys.add(namespaceKey);
+					outboxState.enabledFragments.add(fragment.name);
+					outboxState.config.enabled = true;
+				}
+				return;
+			}
+			schemas.set(namespaceKey, schemaCopy);
+			fragments.set(fragment.name, { ...fragment });
+			if (options?.outboxEnabled) {
+				outboxState.enabledSchemaKeys.add(namespaceKey);
+				outboxState.enabledFragments.add(fragment.name);
+				outboxState.config.enabled = true;
+			}
+		},
+		registerSyncCommands: (registration) => {
+			const key = getSyncTargetKey(registration.fragmentName, registration.schemaName);
+			const existing = syncCommandTargets.get(key);
+			if (existing) {
+				const commandsMatch = existing.commands.size === registration.commands.size && [...existing.commands.entries()].every(([name, command]) => registration.commands.get(name) === command);
+				if (existing.namespace !== registration.namespace || existing.fragmentName !== registration.fragmentName || existing.schemaName !== registration.schemaName || !commandsMatch) throw new Error(`Sync commands for ${registration.fragmentName}/${registration.schemaName} are already registered.`);
+				return;
+			}
+			syncCommandTargets.set(key, {
+				fragmentName: registration.fragmentName,
+				schemaName: registration.schemaName,
+				namespace: registration.namespace,
+				commands: new Map(registration.commands)
+			});
+		},
+		resolveSyncTarget: (fragmentName, schemaName) => {
+			const key = getSyncTargetKey(fragmentName, schemaName);
+			return syncCommandTargets.get(key);
+		},
+		resolveSyncCommand: (fragmentName, schemaName, commandName) => {
+			const target = registry.resolveSyncTarget(fragmentName, schemaName);
+			if (!target) return;
+			const command = target.commands.get(commandName);
+			if (!command) return;
+			return {
+				command,
+				namespace: target.namespace
+			};
+		},
+		listSchemas: () => sortSchemas([...schemas.values()]),
+		listFragments: () => sortFragments([...fragments.values()]),
+		listOutboxFragments: () => sortFragments([...fragments.values()].filter((fragment) => outboxState.enabledFragments.has(fragment.name))),
+		isOutboxEnabled: () => outboxState.config.enabled
+	};
+	registry.internalFragment = buildInternalFragment(adapter, registry);
+	return registry;
+};
+const getRegistryForAdapterSync = (adapter) => {
+	const adapterKey = toAdapterKey(adapter);
+	const existing = registryByAdapter.get(adapterKey);
+	if (existing) return existing;
+	if (isDryRun()) throw new Error("Adapter registry is unavailable during dry-run initialization.");
+	const registry = createRegistry(adapterKey);
+	registryByAdapter.set(adapterKey, registry);
+	return registry;
+};
+const getInternalFragment = (adapter) => {
+	const adapterKey = toAdapterKey(adapter);
+	if (isDryRun()) return instantiate(internalFragmentDef).withOptions({
+		databaseAdapter: adapterKey,
+		databaseNamespace: null
+	}).build();
+	return getRegistryForAdapterSync(adapterKey).internalFragment;
+};
+
+//#endregion
+export { getInternalFragment, getRegistryForAdapterSync };
+//# sourceMappingURL=adapter-registry.js.map

package/dist/internal/adapter-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter-registry.js","names":["registry: AdapterRegistry"],"sources":["../../src/internal/adapter-registry.ts"],"sourcesContent":["import { instantiate } from \"@fragno-dev/core\";\n\nimport type { DatabaseAdapter } from \"../adapters/adapters\";\nimport {\n  SchemaRegistryCollisionError,\n  internalFragmentDef,\n  type InternalFragmentInstance,\n} from \"../fragments/internal-fragment\";\nimport {\n  createInternalFragmentDescribeRoutes,\n  createInternalFragmentOutboxRoutes,\n  createInternalFragmentSyncRoutes,\n} from \"../fragments/internal-fragment.routes\";\nimport type { SyncCommandDefinition, SyncCommandTargetRegistration } from \"../sync/types\";\nimport { getOutboxStateForAdapter, type OutboxState } from \"./outbox-state\";\n\nexport type SchemaInfo = {\n  name: string;\n  namespace: string | null;\n  version: number;\n  tables: string[];\n};\n\nexport type FragmentMeta = {\n  name: string;\n  mountRoute: string;\n};\n\nexport type SyncCommandTarget = {\n  fragmentName: string;\n  schemaName: string;\n  namespace: string | null;\n  commands: Map<string, SyncCommandDefinition>;\n};\n\nexport type AdapterRegistry = {\n  internalFragment: InternalFragmentInstance;\n  schemas: Map<string, SchemaInfo>;\n  fragments: Map<string, FragmentMeta>;\n  outboxState: OutboxState;\n  syncCommandTargets: Map<string, SyncCommandTarget>;\n  registerSchema: (\n    schema: SchemaInfo,\n    fragment: FragmentMeta,\n    options?: { outboxEnabled?: boolean },\n  ) => void;\n  registerSyncCommands: (registration: SyncCommandTargetRegistration) => void;\n  resolveSyncTarget: (fragmentName: string, schemaName: string) => SyncCommandTarget | undefined;\n  resolveSyncCommand: (\n    fragmentName: string,\n    schemaName: string,\n    commandName: string,\n  ) => { command: SyncCommandDefinition; namespace: string | null } | undefined;\n  listSchemas: () => SchemaInfo[];\n  listFragments: () => FragmentMeta[];\n  listOutboxFragments: () => FragmentMeta[];\n  isOutboxEnabled: () => boolean;\n};\n\ntype AdapterKey = DatabaseAdapter<unknown>;\n\nconst registryByAdapter = new WeakMap<AdapterKey, AdapterRegistry>();\n\nconst toAdapterKey = <TUOWConfig>(adapter: DatabaseAdapter<TUOWConfig>): AdapterKey =>\n  adapter as AdapterKey;\n\nconst isDryRun = (): boolean => process.env[\"FRAGNO_INIT_DRY_RUN\"] === \"true\";\n\nconst getNamespaceKey = (schema: SchemaInfo): string => schema.namespace ?? schema.name;\nconst getSyncTargetKey = (fragmentName: string, schemaName: string): string =>\n  `${fragmentName}::${schemaName}`;\n\nconst sortSchemas = (schemas: SchemaInfo[]): SchemaInfo[] =>\n  schemas.sort((a, b) => {\n    const namespaceA = a.namespace ?? \"\";\n    const namespaceB = b.namespace ?? \"\";\n    if (namespaceA !== namespaceB) {\n      return namespaceA.localeCompare(namespaceB);\n    }\n    if (a.name !== b.name) {\n      return a.name.localeCompare(b.name);\n    }\n    return a.version - b.version;\n  });\n\nconst sortFragments = (fragments: FragmentMeta[]): FragmentMeta[] =>\n  fragments.sort((a, b) => a.name.localeCompare(b.name));\n\nconst buildInternalFragment = (\n  adapter: DatabaseAdapter<unknown>,\n  registry: AdapterRegistry,\n): InternalFragmentInstance => {\n  const routes = [\n    createInternalFragmentDescribeRoutes(),\n    createInternalFragmentOutboxRoutes(),\n    createInternalFragmentSyncRoutes(),\n  ];\n\n  return instantiate(internalFragmentDef)\n    .withConfig({ registry })\n    .withOptions({ databaseAdapter: adapter, databaseNamespace: null })\n    .withRoutes(routes)\n    .build();\n};\n\nconst createRegistry = (adapter: DatabaseAdapter<unknown>): AdapterRegistry => {\n  const schemas = new Map<string, SchemaInfo>();\n  const fragments = new Map<string, FragmentMeta>();\n  const outboxState = getOutboxStateForAdapter(adapter);\n  const syncCommandTargets = new Map<string, SyncCommandTarget>();\n  let registry: AdapterRegistry;\n\n  registry = {\n    internalFragment: undefined as unknown as InternalFragmentInstance,\n    schemas,\n    fragments,\n    outboxState,\n    syncCommandTargets,\n    registerSchema: (schema, fragment, options) => {\n      const namespaceKey = getNamespaceKey(schema);\n      const existing = schemas.get(namespaceKey);\n      if (existing && (existing.name !== schema.name || existing.namespace !== schema.namespace)) {\n        throw new SchemaRegistryCollisionError({\n          namespaceKey,\n          existing: { name: existing.name, namespace: existing.namespace },\n          attempted: { name: schema.name, namespace: schema.namespace },\n        });\n      }\n      const schemaCopy = { ...schema, tables: [...schema.tables] };\n      if (\n        existing &&\n        existing.name === schemaCopy.name &&\n        existing.namespace === schemaCopy.namespace &&\n        existing.version === schemaCopy.version &&\n        existing.tables.length === schemaCopy.tables.length &&\n        existing.tables.every((table, index) => table === schemaCopy.tables[index])\n      ) {\n        fragments.set(fragment.name, { ...fragment });\n        if (options?.outboxEnabled) {\n          outboxState.enabledSchemaKeys.add(namespaceKey);\n          outboxState.enabledFragments.add(fragment.name);\n          outboxState.config.enabled = true;\n        }\n        return;\n      }\n      schemas.set(namespaceKey, schemaCopy);\n      fragments.set(fragment.name, { ...fragment });\n      if (options?.outboxEnabled) {\n        outboxState.enabledSchemaKeys.add(namespaceKey);\n        outboxState.enabledFragments.add(fragment.name);\n        outboxState.config.enabled = true;\n      }\n    },\n    registerSyncCommands: (registration) => {\n      const key = getSyncTargetKey(registration.fragmentName, registration.schemaName);\n      const existing = syncCommandTargets.get(key);\n      if (existing) {\n        const commandsMatch =\n          existing.commands.size === registration.commands.size &&\n          [...existing.commands.entries()].every(\n            ([name, command]) => registration.commands.get(name) === command,\n          );\n        if (\n          existing.namespace !== registration.namespace ||\n          existing.fragmentName !== registration.fragmentName ||\n          existing.schemaName !== registration.schemaName ||\n          !commandsMatch\n        ) {\n          throw new Error(\n            `Sync commands for ${registration.fragmentName}/${registration.schemaName} are already registered.`,\n          );\n        }\n        return;\n      }\n      syncCommandTargets.set(key, {\n        fragmentName: registration.fragmentName,\n        schemaName: registration.schemaName,\n        namespace: registration.namespace,\n        commands: new Map(registration.commands),\n      });\n    },\n    resolveSyncTarget: (fragmentName, schemaName) => {\n      const key = getSyncTargetKey(fragmentName, schemaName);\n      return syncCommandTargets.get(key);\n    },\n    resolveSyncCommand: (fragmentName, schemaName, commandName) => {\n      const target = registry.resolveSyncTarget(fragmentName, schemaName);\n      if (!target) {\n        return undefined;\n      }\n      const command = target.commands.get(commandName);\n      if (!command) {\n        return undefined;\n      }\n      return { command, namespace: target.namespace };\n    },\n    listSchemas: () => sortSchemas([...schemas.values()]),\n    listFragments: () => sortFragments([...fragments.values()]),\n    listOutboxFragments: () =>\n      sortFragments(\n        [...fragments.values()].filter((fragment) =>\n          outboxState.enabledFragments.has(fragment.name),\n        ),\n      ),\n    isOutboxEnabled: () => outboxState.config.enabled,\n  };\n\n  registry.internalFragment = buildInternalFragment(adapter, registry);\n  return registry;\n};\n\nexport const getRegistryForAdapterSync = <TUOWConfig>(\n  adapter: DatabaseAdapter<TUOWConfig>,\n): AdapterRegistry => {\n  const adapterKey = toAdapterKey(adapter);\n  const existing = registryByAdapter.get(adapterKey);\n  if (existing) {\n    return existing;\n  }\n  if (isDryRun()) {\n    throw new Error(\"Adapter registry is unavailable during dry-run initialization.\");\n  }\n\n  const registry = createRegistry(adapterKey);\n  registryByAdapter.set(adapterKey, registry);\n  return registry;\n};\n\nexport const getInternalFragment = <TUOWConfig>(\n  adapter: DatabaseAdapter<TUOWConfig>,\n): InternalFragmentInstance => {\n  const adapterKey = toAdapterKey(adapter);\n  if (isDryRun()) {\n    return instantiate(internalFragmentDef)\n      .withOptions({ databaseAdapter: adapterKey, databaseNamespace: null })\n      .build();\n  }\n  return getRegistryForAdapterSync(adapterKey).internalFragment;\n};\n"],"mappings":"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"}

package/dist/internal/outbox-state.d.ts

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