@fragno-dev/db 0.2.2 → 0.3.0

package/dist/fragments/internal-fragment.js

@@ -1,22 +1,14 @@
 import { FragmentDefinitionBuilder } from "../packages/fragno/dist/api/fragment-definition-builder.js";
+import { FragnoId } from "../schema/create.js";
+import { SETTINGS_NAMESPACE, SETTINGS_TABLE_NAME, internalSchema } from "./internal-fragment.schema.js";
+import { dbNow } from "../query/db-now.js";
 import { DatabaseFragmentDefinitionBuilder } from "../db-fragment-definition-builder.js";
-import { column, idColumn, schema } from "../schema/create.js";
 
 //#region src/fragments/internal-fragment.ts
-const SETTINGS_TABLE_NAME = "fragno_db_settings";
-const SETTINGS_NAMESPACE = "fragno-db-settings";
-const internalSchema = schema((s) => {
-	return s.addTable(SETTINGS_TABLE_NAME, (t) => {
-		return t.addColumn("id", idColumn()).addColumn("key", column("string")).addColumn("value", column("string")).createIndex("unique_key", ["key"], { unique: true });
-	}).addTable("fragno_hooks", (t) => {
-		return t.addColumn("id", idColumn()).addColumn("namespace", column("string")).addColumn("hookName", column("string")).addColumn("payload", column("json")).addColumn("status", column("string")).addColumn("attempts", column("integer").defaultTo(0)).addColumn("maxAttempts", column("integer").defaultTo(5)).addColumn("lastAttemptAt", column("timestamp").nullable()).addColumn("nextRetryAt", column("timestamp").nullable()).addColumn("error", column("string").nullable()).addColumn("createdAt", column("timestamp").defaultTo((b) => b.now())).addColumn("nonce", column("string")).createIndex("idx_namespace_status_retry", [
-			"namespace",
-			"status",
-			"nextRetryAt"
-		]).createIndex("idx_nonce", ["nonce"]);
-	});
-});
-const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDefinitionBuilder("$fragno-internal-fragment"), internalSchema, "").providesService("settingsService", ({ defineService }) => {
+const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDefinitionBuilder("$fragno-internal-fragment"), internalSchema).providesBaseService(({ deps }) => ({ getDbNow: async () => {
+	if (deps.db.now) return deps.db.now();
+	return /* @__PURE__ */ new Date();
+} })).providesService("settingsService", ({ defineService }) => {
 	return defineService({
 		get(namespace, key) {
 			const fullKey = `${namespace}.${key}`;
@@ -39,12 +31,9 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 }).providesService("hookService", ({ defineService }) => {
 	return defineService({
 		getPendingHookEvents(namespace) {
-			return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", "pending"))))).transformRetrieve(([events]) => {
-				const now = /* @__PURE__ */ new Date();
-				return events.filter((event) => {
-					if (!event.nextRetryAt) return true;
-					return event.nextRetryAt <= now;
-				}).map((event) => ({
+			const now = dbNow();
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", "pending"), eb.or(eb.isNull("nextRetryAt"), eb("nextRetryAt", "<=", now)))))).transformRetrieve(([events]) => {
+				return events.map((event) => ({
 					id: event.id,
 					hookName: event.hookName,
 					payload: event.payload,
@@ -54,30 +43,130 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 				}));
 			}).build();
 		},
+		claimPendingHookEvents(namespace) {
+			const now = dbNow();
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", "pending"), eb.or(eb.isNull("nextRetryAt"), eb("nextRetryAt", "<=", now)))))).transformRetrieve(([events]) => {
+				return events.map((event) => ({
+					id: event.id,
+					hookName: event.hookName,
+					payload: event.payload,
+					attempts: event.attempts,
+					maxAttempts: event.maxAttempts,
+					idempotencyKey: event.nonce
+				}));
+			}).mutate(({ uow, retrieveResult }) => {
+				if (retrieveResult.length === 0) return;
+				for (const event of retrieveResult) uow.update("fragno_hooks", event.id, (b) => b.set({
+					status: "processing",
+					lastAttemptAt: now
+				}).check());
+			}).transform(({ retrieveResult }) => retrieveResult.map((event) => ({
+				...event,
+				id: new FragnoId({
+					externalId: event.id.externalId,
+					internalId: event.id.internalId,
+					version: event.id.version + 1
+				})
+			}))).build();
+		},
+		requeueStuckProcessingHooks(namespace, staleBefore) {
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", "processing"))))).transformRetrieve(([events]) => {
+				return events.filter((event) => {
+					if (!event.lastAttemptAt) return true;
+					return event.lastAttemptAt <= staleBefore;
+				}).map((event) => ({
+					id: event.id,
+					hookName: event.hookName,
+					attempts: event.attempts,
+					maxAttempts: event.maxAttempts,
+					lastAttemptAt: event.lastAttemptAt,
+					nextRetryAt: event.nextRetryAt
+				}));
+			}).mutate(({ uow, retrieveResult }) => {
+				for (const event of retrieveResult) uow.update("fragno_hooks", event.id, (b) => b.set({
+					status: "pending",
+					nextRetryAt: null
+				}).check());
+			}).transform(({ retrieveResult }) => retrieveResult).build();
+		},
+		getNextProcessingStaleAt(namespace, timeoutMinutes, now) {
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", "processing"))))).transformRetrieve(([events]) => {
+				if (events.length === 0) return null;
+				const baseNow = now ?? /* @__PURE__ */ new Date();
+				const nowMs = baseNow.getTime();
+				const timeoutMs = timeoutMinutes * 6e4;
+				let earliestStaleAt = null;
+				for (const event of events) {
+					if (!event.lastAttemptAt) return baseNow;
+					const staleAtMs = event.lastAttemptAt.getTime() + timeoutMs;
+					if (staleAtMs <= nowMs) return baseNow;
+					const staleAt = new Date(staleAtMs);
+					if (!earliestStaleAt || staleAt < earliestStaleAt) earliestStaleAt = staleAt;
+				}
+				return earliestStaleAt;
+			}).build();
+		},
+		getNextHookWakeAt(namespace, timeoutMinutes, now) {
+			const baseNow = now ?? /* @__PURE__ */ new Date();
+			const includeProcessing = typeof timeoutMinutes === "number" && timeoutMinutes > 0;
+			const timeoutMs = includeProcessing ? timeoutMinutes * 6e4 : 0;
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => {
+				if (includeProcessing) return eb.and(eb("namespace", "=", namespace), eb.or(eb("status", "=", "pending"), eb("status", "=", "processing")));
+				return eb.and(eb("namespace", "=", namespace), eb("status", "=", "pending"));
+			}).select([
+				"status",
+				"nextRetryAt",
+				"lastAttemptAt"
+			]))).transformRetrieve(([events]) => {
+				if (events.length === 0) return null;
+				const nowMs = baseNow.getTime();
+				let earliestPendingAt = null;
+				let earliestStaleAt = null;
+				for (const event of events) {
+					if (event.status === "pending") {
+						const nextRetryAt = event.nextRetryAt;
+						if (!nextRetryAt || nextRetryAt.getTime() <= nowMs) return baseNow;
+						if (!earliestPendingAt || nextRetryAt < earliestPendingAt) earliestPendingAt = nextRetryAt;
+						continue;
+					}
+					if (!includeProcessing || event.status !== "processing") continue;
+					const lastAttemptAt = event.lastAttemptAt;
+					if (!lastAttemptAt) return baseNow;
+					const staleAtMs = lastAttemptAt.getTime() + timeoutMs;
+					if (staleAtMs <= nowMs) return baseNow;
+					const staleAt = new Date(staleAtMs);
+					if (!earliestStaleAt || staleAt < earliestStaleAt) earliestStaleAt = staleAt;
+				}
+				if (!earliestPendingAt) return earliestStaleAt ?? null;
+				if (!earliestStaleAt) return earliestPendingAt;
+				return earliestPendingAt <= earliestStaleAt ? earliestPendingAt : earliestStaleAt;
+			}).build();
+		},
 		markHookCompleted(eventId) {
 			return this.serviceTx(internalSchema).mutate(({ uow }) => uow.update("fragno_hooks", eventId, (b) => b.set({
 				status: "completed",
-				lastAttemptAt: /* @__PURE__ */ new Date()
+				lastAttemptAt: dbNow()
 			}).check())).build();
 		},
-		markHookFailed(eventId, error, attempts, retryPolicy) {
+		markHookFailed(eventId, error, attempts, retryPolicy, now) {
 			const newAttempts = attempts + 1;
 			const shouldRetry = retryPolicy.shouldRetry(newAttempts - 1);
 			return this.serviceTx(internalSchema).mutate(({ uow }) => {
 				if (shouldRetry) {
 					const delayMs = retryPolicy.getDelayMs(newAttempts - 1);
-					const nextRetryAt = new Date(Date.now() + delayMs);
+					const baseNow = now ?? /* @__PURE__ */ new Date();
+					const nextRetryAt = new Date(baseNow.getTime() + delayMs);
 					uow.update("fragno_hooks", eventId, (b) => b.set({
 						status: "pending",
 						attempts: newAttempts,
-						lastAttemptAt: /* @__PURE__ */ new Date(),
+						lastAttemptAt: dbNow(),
 						nextRetryAt,
 						error
 					}).check());
 				} else uow.update("fragno_hooks", eventId, (b) => b.set({
 					status: "failed",
 					attempts: newAttempts,
-					lastAttemptAt: /* @__PURE__ */ new Date(),
+					lastAttemptAt: dbNow(),
 					error
 				}).check());
 			}).build();
@@ -85,7 +174,7 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 		markHookProcessing(eventId) {
 			return this.serviceTx(internalSchema).mutate(({ uow }) => uow.update("fragno_hooks", eventId, (b) => b.set({
 				status: "processing",
-				lastAttemptAt: /* @__PURE__ */ new Date()
+				lastAttemptAt: dbNow()
 			}).check())).build();
 		},
 		getHookById(eventId) {
@@ -95,18 +184,47 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 			return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => eb("namespace", "=", namespace)))).transformRetrieve(([events]) => events).build();
 		}
 	});
+}).providesService("outboxService", ({ defineService }) => {
+	return defineService({ list({ afterVersionstamp, limit } = {}) {
+		const afterValue = afterVersionstamp?.toLowerCase();
+		return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_db_outbox", (b) => {
+			let builder = afterValue ? b.whereIndex("idx_outbox_versionstamp", (eb) => eb("versionstamp", ">", afterValue)) : b.whereIndex("idx_outbox_versionstamp");
+			builder = builder.orderByIndex("idx_outbox_versionstamp", "asc");
+			if (limit !== void 0) builder = builder.pageSize(limit);
+			return builder;
+		})).transformRetrieve(([entries]) => entries.map((entry) => ({
+			id: entry.id,
+			versionstamp: entry.versionstamp,
+			uowId: entry.uowId,
+			payload: entry.payload,
+			refMap: entry.refMap ?? void 0,
+			createdAt: entry.createdAt
+		}))).build();
+	} });
 }).build();
 async function getSchemaVersionFromDatabase(fragment, namespace) {
 	try {
-		const setting = await fragment.inContext(async function() {
-			return await this.handlerTx().withServiceCalls(() => [fragment.services.settingsService.get(namespace, "schema_version")]).transform(({ serviceResult: [result] }) => result).execute();
-		});
-		return setting ? parseInt(setting.value, 10) : 0;
+		const readSchemaVersion = async (targetNamespace) => {
+			const setting = await fragment.inContext(async function() {
+				return await this.handlerTx().withServiceCalls(() => [fragment.services.settingsService.get(targetNamespace, "schema_version")]).transform(({ serviceResult: [result] }) => result).execute();
+			});
+			if (!setting) return;
+			const parsed = parseInt(setting.value, 10);
+			return Number.isNaN(parsed) ? void 0 : parsed;
+		};
+		const primary = await readSchemaVersion(namespace);
+		if (primary !== void 0) return primary;
+		const legacyNamespace = namespace === "" ? internalSchema.name : namespace === internalSchema.name ? "" : null;
+		if (legacyNamespace !== null) {
+			const legacy = await readSchemaVersion(legacyNamespace);
+			if (legacy !== void 0) return legacy;
+		}
+		return 0;
 	} catch {
 		return 0;
 	}
 }
 
 //#endregion
-export { SETTINGS_NAMESPACE, SETTINGS_TABLE_NAME, getSchemaVersionFromDatabase, internalFragmentDef, internalSchema };
+export { getSchemaVersionFromDatabase, internalFragmentDef };
 //# sourceMappingURL=internal-fragment.js.map

package/dist/fragments/internal-fragment.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal-fragment.js","names":[],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":["import { FragmentDefinitionBuilder } from \"@fragno-dev/core\";\nimport type { InstantiatedFragmentFromDefinition } from \"@fragno-dev/core\";\nimport {\n  DatabaseFragmentDefinitionBuilder,\n  type DatabaseHandlerContext,\n  type DatabaseRequestStorage,\n  type DatabaseServiceContext,\n  type FragnoPublicConfigWithDatabase,\n  type ImplicitDatabaseDependencies,\n} from \"../db-fragment-definition-builder\";\nimport type { FragnoId } from \"../schema/create\";\nimport { schema, idColumn, column } from \"../schema/create\";\nimport type { RetryPolicy } from \"../query/unit-of-work/retry-policy\";\n\n// Constants for Fragno's internal settings table\nexport const SETTINGS_TABLE_NAME = \"fragno_db_settings\" as const;\n// FIXME: In some places we simply use empty string \"\" as namespace, which is not correct.\nexport const SETTINGS_NAMESPACE = \"fragno-db-settings\" as const;\n\nexport const internalSchema = schema((s) => {\n  return s\n    .addTable(SETTINGS_TABLE_NAME, (t) => {\n      return t\n        .addColumn(\"id\", idColumn())\n        .addColumn(\"key\", column(\"string\"))\n        .addColumn(\"value\", column(\"string\"))\n        .createIndex(\"unique_key\", [\"key\"], { unique: true });\n    })\n    .addTable(\"fragno_hooks\", (t) => {\n      return t\n        .addColumn(\"id\", idColumn())\n        .addColumn(\"namespace\", column(\"string\"))\n        .addColumn(\"hookName\", column(\"string\"))\n        .addColumn(\"payload\", column(\"json\"))\n        .addColumn(\"status\", column(\"string\")) // \"pending\" | \"processing\" | \"completed\" | \"failed\"\n        .addColumn(\"attempts\", column(\"integer\").defaultTo(0))\n        .addColumn(\"maxAttempts\", column(\"integer\").defaultTo(5))\n        .addColumn(\"lastAttemptAt\", column(\"timestamp\").nullable())\n        .addColumn(\"nextRetryAt\", column(\"timestamp\").nullable())\n        .addColumn(\"error\", column(\"string\").nullable())\n        .addColumn(\n          \"createdAt\",\n          column(\"timestamp\").defaultTo((b) => b.now()),\n        )\n        .addColumn(\"nonce\", column(\"string\"))\n        .createIndex(\"idx_namespace_status_retry\", [\"namespace\", \"status\", \"nextRetryAt\"])\n        .createIndex(\"idx_nonce\", [\"nonce\"]);\n    });\n});\n\n// This uses DatabaseFragmentDefinitionBuilder directly\n// to avoid circular dependency (it doesn't need to link to itself)\nexport const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(\n  new FragmentDefinitionBuilder<\n    {},\n    FragnoPublicConfigWithDatabase,\n    ImplicitDatabaseDependencies<typeof internalSchema>,\n    {},\n    {},\n    {},\n    {},\n    DatabaseServiceContext<{}>,\n    DatabaseHandlerContext,\n    DatabaseRequestStorage\n  >(\"$fragno-internal-fragment\"),\n  internalSchema,\n  \"\", // intentionally blank namespace so there is no prefix\n)\n  .providesService(\"settingsService\", ({ defineService }) => {\n    return defineService({\n      /**\n       * Get a setting by namespace and key.\n       */\n      get(namespace: string, key: string) {\n        const fullKey = `${namespace}.${key}`;\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.findFirst(SETTINGS_TABLE_NAME, (b) =>\n              b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", fullKey)),\n            ),\n          )\n          .transformRetrieve(\n            ([result]): { id: FragnoId; key: string; value: string } | undefined =>\n              result ?? undefined,\n          )\n          .build();\n      },\n\n      /**\n       * Set a setting value by namespace and key.\n       */\n      set(namespace: string, key: string, value: string) {\n        const fullKey = `${namespace}.${key}`;\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.findFirst(SETTINGS_TABLE_NAME, (b) =>\n              b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", fullKey)),\n            ),\n          )\n          .transformRetrieve(([result]) => result)\n          .mutate(({ uow, retrieveResult }) => {\n            if (retrieveResult) {\n              uow.update(SETTINGS_TABLE_NAME, retrieveResult.id, (b) => b.set({ value }).check());\n            } else {\n              uow.create(SETTINGS_TABLE_NAME, {\n                key: fullKey,\n                value,\n              });\n            }\n          })\n          .build();\n      },\n\n      /**\n       * Delete a setting by ID.\n       */\n      delete(id: FragnoId) {\n        return this.serviceTx(internalSchema)\n          .mutate(({ uow }) => uow.delete(SETTINGS_TABLE_NAME, id))\n          .build();\n      },\n    });\n  })\n  .providesService(\"hookService\", ({ defineService }) => {\n    return defineService({\n      /**\n       * Get pending hook events for processing.\n       * Returns all pending events for the given namespace that are ready to be processed.\n       */\n      getPendingHookEvents(namespace: string) {\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"idx_namespace_status_retry\", (eb) =>\n                eb.and(eb(\"namespace\", \"=\", namespace), eb(\"status\", \"=\", \"pending\")),\n              ),\n            ),\n          )\n          .transformRetrieve(([events]) => {\n            const now = new Date();\n            // FIXME(Wilco): this should be handled by the database query, but there seems to be an issue.\n            const ready = events.filter((event) => {\n              if (!event.nextRetryAt) {\n                return true; // Newly created events (nextRetryAt = null) are ready\n              }\n              return event.nextRetryAt <= now; // Only include if retry time has passed\n            });\n\n            return ready.map((event) => ({\n              id: event.id,\n              hookName: event.hookName,\n              payload: event.payload as unknown,\n              attempts: event.attempts,\n              maxAttempts: event.maxAttempts,\n              idempotencyKey: event.nonce,\n            }));\n          })\n          .build();\n      },\n\n      /**\n       * Mark a hook event as completed.\n       */\n      markHookCompleted(eventId: FragnoId) {\n        return this.serviceTx(internalSchema)\n          .mutate(({ uow }) =>\n            uow.update(\"fragno_hooks\", eventId, (b) =>\n              b.set({ status: \"completed\", lastAttemptAt: new Date() }).check(),\n            ),\n          )\n          .build();\n      },\n\n      /**\n       * Mark a hook event as failed and schedule next retry.\n       */\n      markHookFailed(eventId: FragnoId, error: string, attempts: number, retryPolicy: RetryPolicy) {\n        const newAttempts = attempts + 1;\n        const shouldRetry = retryPolicy.shouldRetry(newAttempts - 1);\n\n        return this.serviceTx(internalSchema)\n          .mutate(({ uow }) => {\n            if (shouldRetry) {\n              const delayMs = retryPolicy.getDelayMs(newAttempts - 1);\n              const nextRetryAt = new Date(Date.now() + delayMs);\n              uow.update(\"fragno_hooks\", eventId, (b) =>\n                b\n                  .set({\n                    status: \"pending\",\n                    attempts: newAttempts,\n                    lastAttemptAt: new Date(),\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: new Date(),\n                    error,\n                  })\n                  .check(),\n              );\n            }\n          })\n          .build();\n      },\n\n      /**\n       * Mark a hook event as processing (to prevent concurrent execution).\n       */\n      markHookProcessing(eventId: FragnoId) {\n        return this.serviceTx(internalSchema)\n          .mutate(({ uow }) =>\n            uow.update(\"fragno_hooks\", eventId, (b) =>\n              b.set({ status: \"processing\", lastAttemptAt: new Date() }).check(),\n            ),\n          )\n          .build();\n      },\n\n      /**\n       * Get a hook event by ID (for testing/verification purposes).\n       */\n      getHookById(eventId: FragnoId) {\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.findFirst(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"primary\", (eb) => eb(\"id\", \"=\", eventId)),\n            ),\n          )\n          .transformRetrieve(([result]) => result ?? undefined)\n          .build();\n      },\n\n      /**\n       * Get all hook events for a namespace (for testing/verification purposes).\n       */\n      getHooksByNamespace(namespace: string) {\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"idx_namespace_status_retry\", (eb) => eb(\"namespace\", \"=\", namespace)),\n            ),\n          )\n          .transformRetrieve(([events]) => events)\n          .build();\n      },\n    });\n  })\n  .build();\n\n/**\n * Type representing an instantiated internal fragment.\n * This is the fragment that manages Fragno's internal settings table.\n */\nexport type InternalFragmentInstance = InstantiatedFragmentFromDefinition<\n  typeof internalFragmentDef\n>;\n\nexport async function getSchemaVersionFromDatabase(\n  fragment: InternalFragmentInstance,\n  namespace: string,\n): Promise<number> {\n  try {\n    const setting = await fragment.inContext(async function () {\n      return await this.handlerTx()\n        .withServiceCalls(\n          () => [fragment.services.settingsService.get(namespace, \"schema_version\")] as const,\n        )\n        .transform(({ serviceResult: [result] }) => result)\n        .execute();\n    });\n    return setting ? parseInt(setting.value, 10) : 0;\n  } catch {\n    return 0;\n  }\n}\n"],"mappings":";;;;;AAeA,MAAa,sBAAsB;AAEnC,MAAa,qBAAqB;AAElC,MAAa,iBAAiB,QAAQ,MAAM;AAC1C,QAAO,EACJ,SAAS,sBAAsB,MAAM;AACpC,SAAO,EACJ,UAAU,MAAM,UAAU,CAAC,CAC3B,UAAU,OAAO,OAAO,SAAS,CAAC,CAClC,UAAU,SAAS,OAAO,SAAS,CAAC,CACpC,YAAY,cAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,MAAM,CAAC;GACvD,CACD,SAAS,iBAAiB,MAAM;AAC/B,SAAO,EACJ,UAAU,MAAM,UAAU,CAAC,CAC3B,UAAU,aAAa,OAAO,SAAS,CAAC,CACxC,UAAU,YAAY,OAAO,SAAS,CAAC,CACvC,UAAU,WAAW,OAAO,OAAO,CAAC,CACpC,UAAU,UAAU,OAAO,SAAS,CAAC,CACrC,UAAU,YAAY,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC,CACrD,UAAU,eAAe,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC,CACxD,UAAU,iBAAiB,OAAO,YAAY,CAAC,UAAU,CAAC,CAC1D,UAAU,eAAe,OAAO,YAAY,CAAC,UAAU,CAAC,CACxD,UAAU,SAAS,OAAO,SAAS,CAAC,UAAU,CAAC,CAC/C,UACC,aACA,OAAO,YAAY,CAAC,WAAW,MAAM,EAAE,KAAK,CAAC,CAC9C,CACA,UAAU,SAAS,OAAO,SAAS,CAAC,CACpC,YAAY,8BAA8B;GAAC;GAAa;GAAU;GAAc,CAAC,CACjF,YAAY,aAAa,CAAC,QAAQ,CAAC;GACtC;EACJ;AAIF,MAAa,sBAAsB,IAAI,kCACrC,IAAI,0BAWF,4BAA4B,EAC9B,gBACA,GACD,CACE,gBAAgB,oBAAoB,EAAE,oBAAoB;AACzD,QAAO,cAAc;EAInB,IAAI,WAAmB,KAAa;GAClC,MAAM,UAAU,GAAG,UAAU,GAAG;AAChC,UAAO,KAAK,UAAU,eAAe,CAClC,UAAU,QACT,IAAI,UAAU,sBAAsB,MAClC,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,QAAQ,CAAC,CAC5D,CACF,CACA,mBACE,CAAC,YACA,UAAU,OACb,CACA,OAAO;;EAMZ,IAAI,WAAmB,KAAa,OAAe;GACjD,MAAM,UAAU,GAAG,UAAU,GAAG;AAChC,UAAO,KAAK,UAAU,eAAe,CAClC,UAAU,QACT,IAAI,UAAU,sBAAsB,MAClC,EAAE,WAAW,eAAe,OAAO,GAAG,OAAO,KAAK,QAAQ,CAAC,CAC5D,CACF,CACA,mBAAmB,CAAC,YAAY,OAAO,CACvC,QAAQ,EAAE,KAAK,qBAAqB;AACnC,QAAI,eACF,KAAI,OAAO,qBAAqB,eAAe,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC;QAEnF,KAAI,OAAO,qBAAqB;KAC9B,KAAK;KACL;KACD,CAAC;KAEJ,CACD,OAAO;;EAMZ,OAAO,IAAc;AACnB,UAAO,KAAK,UAAU,eAAe,CAClC,QAAQ,EAAE,UAAU,IAAI,OAAO,qBAAqB,GAAG,CAAC,CACxD,OAAO;;EAEb,CAAC;EACF,CACD,gBAAgB,gBAAgB,EAAE,oBAAoB;AACrD,QAAO,cAAc;EAKnB,qBAAqB,WAAmB;AACtC,UAAO,KAAK,UAAU,eAAe,CAClC,UAAU,QACT,IAAI,KAAK,iBAAiB,MACxB,EAAE,WAAW,+BAA+B,OAC1C,GAAG,IAAI,GAAG,aAAa,KAAK,UAAU,EAAE,GAAG,UAAU,KAAK,UAAU,CAAC,CACtE,CACF,CACF,CACA,mBAAmB,CAAC,YAAY;IAC/B,MAAM,sBAAM,IAAI,MAAM;AAStB,WAPc,OAAO,QAAQ,UAAU;AACrC,SAAI,CAAC,MAAM,YACT,QAAO;AAET,YAAO,MAAM,eAAe;MAC5B,CAEW,KAAK,WAAW;KAC3B,IAAI,MAAM;KACV,UAAU,MAAM;KAChB,SAAS,MAAM;KACf,UAAU,MAAM;KAChB,aAAa,MAAM;KACnB,gBAAgB,MAAM;KACvB,EAAE;KACH,CACD,OAAO;;EAMZ,kBAAkB,SAAmB;AACnC,UAAO,KAAK,UAAU,eAAe,CAClC,QAAQ,EAAE,UACT,IAAI,OAAO,gBAAgB,UAAU,MACnC,EAAE,IAAI;IAAE,QAAQ;IAAa,+BAAe,IAAI,MAAM;IAAE,CAAC,CAAC,OAAO,CAClE,CACF,CACA,OAAO;;EAMZ,eAAe,SAAmB,OAAe,UAAkB,aAA0B;GAC3F,MAAM,cAAc,WAAW;GAC/B,MAAM,cAAc,YAAY,YAAY,cAAc,EAAE;AAE5D,UAAO,KAAK,UAAU,eAAe,CAClC,QAAQ,EAAE,UAAU;AACnB,QAAI,aAAa;KACf,MAAM,UAAU,YAAY,WAAW,cAAc,EAAE;KACvD,MAAM,cAAc,IAAI,KAAK,KAAK,KAAK,GAAG,QAAQ;AAClD,SAAI,OAAO,gBAAgB,UAAU,MACnC,EACG,IAAI;MACH,QAAQ;MACR,UAAU;MACV,+BAAe,IAAI,MAAM;MACzB;MACA;MACD,CAAC,CACD,OAAO,CACX;UAED,KAAI,OAAO,gBAAgB,UAAU,MACnC,EACG,IAAI;KACH,QAAQ;KACR,UAAU;KACV,+BAAe,IAAI,MAAM;KACzB;KACD,CAAC,CACD,OAAO,CACX;KAEH,CACD,OAAO;;EAMZ,mBAAmB,SAAmB;AACpC,UAAO,KAAK,UAAU,eAAe,CAClC,QAAQ,EAAE,UACT,IAAI,OAAO,gBAAgB,UAAU,MACnC,EAAE,IAAI;IAAE,QAAQ;IAAc,+BAAe,IAAI,MAAM;IAAE,CAAC,CAAC,OAAO,CACnE,CACF,CACA,OAAO;;EAMZ,YAAY,SAAmB;AAC7B,UAAO,KAAK,UAAU,eAAe,CAClC,UAAU,QACT,IAAI,UAAU,iBAAiB,MAC7B,EAAE,WAAW,YAAY,OAAO,GAAG,MAAM,KAAK,QAAQ,CAAC,CACxD,CACF,CACA,mBAAmB,CAAC,YAAY,UAAU,OAAU,CACpD,OAAO;;EAMZ,oBAAoB,WAAmB;AACrC,UAAO,KAAK,UAAU,eAAe,CAClC,UAAU,QACT,IAAI,KAAK,iBAAiB,MACxB,EAAE,WAAW,+BAA+B,OAAO,GAAG,aAAa,KAAK,UAAU,CAAC,CACpF,CACF,CACA,mBAAmB,CAAC,YAAY,OAAO,CACvC,OAAO;;EAEb,CAAC;EACF,CACD,OAAO;AAUV,eAAsB,6BACpB,UACA,WACiB;AACjB,KAAI;EACF,MAAM,UAAU,MAAM,SAAS,UAAU,iBAAkB;AACzD,UAAO,MAAM,KAAK,WAAW,CAC1B,uBACO,CAAC,SAAS,SAAS,gBAAgB,IAAI,WAAW,iBAAiB,CAAC,CAC3E,CACA,WAAW,EAAE,eAAe,CAAC,cAAc,OAAO,CAClD,SAAS;IACZ;AACF,SAAO,UAAU,SAAS,QAAQ,OAAO,GAAG,GAAG;SACzC;AACN,SAAO"}
+{"version":3,"file":"internal-fragment.js","names":["earliestStaleAt: Date | null","earliestPendingAt: Date | null"],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":["import { FragmentDefinitionBuilder } from \"@fragno-dev/core\";\nimport type { InstantiatedFragmentFromDefinition } from \"@fragno-dev/core\";\nimport {\n  DatabaseFragmentDefinitionBuilder,\n  type DatabaseHandlerContext,\n  type DatabaseRequestStorage,\n  type DatabaseServiceContext,\n  type FragnoPublicConfigWithDatabase,\n  type ImplicitDatabaseDependencies,\n} from \"../db-fragment-definition-builder\";\nimport { FragnoId } from \"../schema/create\";\nimport type { RetryPolicy } from \"../query/unit-of-work/retry-policy\";\nimport { dbNow } from \"../query/db-now\";\nimport {\n  internalSchema,\n  SETTINGS_NAMESPACE,\n  SETTINGS_TABLE_NAME,\n} from \"./internal-fragment.schema\";\n\nexport {\n  internalSchema,\n  SETTINGS_NAMESPACE,\n  SETTINGS_TABLE_NAME,\n} from \"./internal-fragment.schema\";\n\n// This uses DatabaseFragmentDefinitionBuilder directly\n// to avoid circular dependency (it doesn't need to link to itself)\nexport const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(\n  new FragmentDefinitionBuilder<\n    {},\n    FragnoPublicConfigWithDatabase,\n    ImplicitDatabaseDependencies<typeof internalSchema>,\n    {},\n    {},\n    {},\n    {},\n    DatabaseServiceContext<{}>,\n    DatabaseHandlerContext,\n    DatabaseRequestStorage\n  >(\"$fragno-internal-fragment\"),\n  internalSchema,\n)\n  .providesBaseService(({ deps }) => ({\n    getDbNow: async () => {\n      if (deps.db.now) {\n        return deps.db.now();\n      }\n      return new Date();\n    },\n  }))\n  .providesService(\"settingsService\", ({ defineService }) => {\n    return defineService({\n      /**\n       * Get a setting by namespace and key.\n       */\n      get(namespace: string, key: string) {\n        const fullKey = `${namespace}.${key}`;\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.findFirst(SETTINGS_TABLE_NAME, (b) =>\n              b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", fullKey)),\n            ),\n          )\n          .transformRetrieve(\n            ([result]): { id: FragnoId; key: string; value: string } | undefined =>\n              result ?? undefined,\n          )\n          .build();\n      },\n\n      /**\n       * Set a setting value by namespace and key.\n       */\n      set(namespace: string, key: string, value: string) {\n        const fullKey = `${namespace}.${key}`;\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.findFirst(SETTINGS_TABLE_NAME, (b) =>\n              b.whereIndex(\"unique_key\", (eb) => eb(\"key\", \"=\", fullKey)),\n            ),\n          )\n          .transformRetrieve(([result]) => result)\n          .mutate(({ uow, retrieveResult }) => {\n            if (retrieveResult) {\n              uow.update(SETTINGS_TABLE_NAME, retrieveResult.id, (b) => b.set({ value }).check());\n            } else {\n              uow.create(SETTINGS_TABLE_NAME, {\n                key: fullKey,\n                value,\n              });\n            }\n          })\n          .build();\n      },\n\n      /**\n       * Delete a setting by ID.\n       */\n      delete(id: FragnoId) {\n        return this.serviceTx(internalSchema)\n          .mutate(({ uow }) => uow.delete(SETTINGS_TABLE_NAME, id))\n          .build();\n      },\n    });\n  })\n  .providesService(\"hookService\", ({ defineService }) => {\n    return defineService({\n      /**\n       * Get pending hook events for processing.\n       * Returns all pending events for the given namespace that are ready to be processed.\n       */\n      getPendingHookEvents(namespace: string) {\n        const now = dbNow();\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"idx_namespace_status_retry\", (eb) =>\n                eb.and(\n                  eb(\"namespace\", \"=\", namespace),\n                  eb(\"status\", \"=\", \"pending\"),\n                  eb.or(eb.isNull(\"nextRetryAt\"), eb(\"nextRetryAt\", \"<=\", now)),\n                ),\n              ),\n            ),\n          )\n          .transformRetrieve(([events]) => {\n            return events.map((event) => ({\n              id: event.id,\n              hookName: event.hookName,\n              payload: event.payload as unknown,\n              attempts: event.attempts,\n              maxAttempts: event.maxAttempts,\n              idempotencyKey: event.nonce,\n            }));\n          })\n          .build();\n      },\n\n      /**\n       * Claim pending hook events for processing.\n       * Returns ready events and marks them as processing in the same transaction.\n       */\n      claimPendingHookEvents(namespace: string) {\n        const now = dbNow();\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"idx_namespace_status_retry\", (eb) =>\n                eb.and(\n                  eb(\"namespace\", \"=\", namespace),\n                  eb(\"status\", \"=\", \"pending\"),\n                  eb.or(eb.isNull(\"nextRetryAt\"), eb(\"nextRetryAt\", \"<=\", now)),\n                ),\n              ),\n            ),\n          )\n          .transformRetrieve(([events]) => {\n            return events.map((event) => ({\n              id: event.id,\n              hookName: event.hookName,\n              payload: event.payload,\n              attempts: event.attempts,\n              maxAttempts: event.maxAttempts,\n              idempotencyKey: event.nonce,\n            }));\n          })\n          .mutate(({ uow, retrieveResult }) => {\n            if (retrieveResult.length === 0) {\n              return;\n            }\n            for (const event of retrieveResult) {\n              uow.update(\"fragno_hooks\", event.id, (b) =>\n                b.set({ status: \"processing\", lastAttemptAt: now }).check(),\n              );\n            }\n          })\n          .transform(({ retrieveResult }) =>\n            retrieveResult.map((event) => ({\n              ...event,\n              id: new FragnoId({\n                externalId: event.id.externalId,\n                internalId: event.id.internalId,\n                version: event.id.version + 1,\n              }),\n            })),\n          )\n          .build();\n      },\n\n      /**\n       * Re-queue hook events that have been stuck in processing for too long.\n       */\n      requeueStuckProcessingHooks(namespace: string, staleBefore: Date) {\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"idx_namespace_status_retry\", (eb) =>\n                eb.and(eb(\"namespace\", \"=\", namespace), eb(\"status\", \"=\", \"processing\")),\n              ),\n            ),\n          )\n          .transformRetrieve(([events]) => {\n            const stuck = events.filter((event) => {\n              if (!event.lastAttemptAt) {\n                return true;\n              }\n              return event.lastAttemptAt <= staleBefore;\n            });\n\n            return stuck.map((event) => ({\n              id: event.id,\n              hookName: event.hookName,\n              attempts: event.attempts,\n              maxAttempts: event.maxAttempts,\n              lastAttemptAt: event.lastAttemptAt,\n              nextRetryAt: event.nextRetryAt,\n            }));\n          })\n          .mutate(({ uow, retrieveResult }) => {\n            for (const event of retrieveResult) {\n              uow.update(\"fragno_hooks\", event.id, (b) =>\n                b.set({ status: \"pending\", nextRetryAt: null }).check(),\n              );\n            }\n          })\n          .transform(({ retrieveResult }) => retrieveResult)\n          .build();\n      },\n\n      /**\n       * Get the next time a processing hook becomes stale.\n       */\n      getNextProcessingStaleAt(namespace: string, timeoutMinutes: number, now?: Date) {\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"idx_namespace_status_retry\", (eb) =>\n                eb.and(eb(\"namespace\", \"=\", namespace), eb(\"status\", \"=\", \"processing\")),\n              ),\n            ),\n          )\n          .transformRetrieve(([events]) => {\n            if (events.length === 0) {\n              return null;\n            }\n\n            const baseNow = now ?? new Date();\n            const nowMs = baseNow.getTime();\n            const timeoutMs = timeoutMinutes * 60_000;\n            let earliestStaleAt: Date | null = null;\n\n            for (const event of events) {\n              if (!event.lastAttemptAt) {\n                return baseNow;\n              }\n\n              const staleAtMs = event.lastAttemptAt.getTime() + timeoutMs;\n              if (staleAtMs <= nowMs) {\n                return baseNow;\n              }\n\n              const staleAt = new Date(staleAtMs);\n              if (!earliestStaleAt || staleAt < earliestStaleAt) {\n                earliestStaleAt = staleAt;\n              }\n            }\n\n            return earliestStaleAt;\n          })\n          .build();\n      },\n\n      /**\n       * Get the earliest pending hook wake time for a namespace.\n       * Optionally considers processing hooks becoming stale when timeoutMinutes is provided.\n       */\n      getNextHookWakeAt(namespace: string, timeoutMinutes?: number | false, now?: Date) {\n        const baseNow = now ?? new Date();\n        const includeProcessing = typeof timeoutMinutes === \"number\" && timeoutMinutes > 0;\n        const timeoutMs = includeProcessing ? timeoutMinutes * 60_000 : 0;\n\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_hooks\", (b) =>\n              b\n                .whereIndex(\"idx_namespace_status_retry\", (eb) => {\n                  if (includeProcessing) {\n                    return eb.and(\n                      eb(\"namespace\", \"=\", namespace),\n                      eb.or(eb(\"status\", \"=\", \"pending\"), eb(\"status\", \"=\", \"processing\")),\n                    );\n                  }\n                  return eb.and(eb(\"namespace\", \"=\", namespace), eb(\"status\", \"=\", \"pending\"));\n                })\n                .select([\"status\", \"nextRetryAt\", \"lastAttemptAt\"]),\n            ),\n          )\n          .transformRetrieve(([events]) => {\n            if (events.length === 0) {\n              return null;\n            }\n\n            const nowMs = baseNow.getTime();\n            let earliestPendingAt: Date | null = null;\n            let earliestStaleAt: Date | null = null;\n\n            for (const event of events) {\n              if (event.status === \"pending\") {\n                const nextRetryAt = event.nextRetryAt;\n                if (!nextRetryAt || nextRetryAt.getTime() <= nowMs) {\n                  return baseNow;\n                }\n                if (!earliestPendingAt || nextRetryAt < earliestPendingAt) {\n                  earliestPendingAt = nextRetryAt;\n                }\n                continue;\n              }\n\n              if (!includeProcessing || event.status !== \"processing\") {\n                continue;\n              }\n\n              const lastAttemptAt = event.lastAttemptAt;\n              if (!lastAttemptAt) {\n                return baseNow;\n              }\n\n              const staleAtMs = lastAttemptAt.getTime() + timeoutMs;\n              if (staleAtMs <= nowMs) {\n                return baseNow;\n              }\n\n              const staleAt = new Date(staleAtMs);\n              if (!earliestStaleAt || staleAt < earliestStaleAt) {\n                earliestStaleAt = staleAt;\n              }\n            }\n\n            if (!earliestPendingAt) {\n              return earliestStaleAt ?? null;\n            }\n            if (!earliestStaleAt) {\n              return earliestPendingAt;\n            }\n            return earliestPendingAt <= earliestStaleAt ? earliestPendingAt : earliestStaleAt;\n          })\n          .build();\n      },\n\n      /**\n       * Mark a hook event as completed.\n       */\n      markHookCompleted(eventId: FragnoId) {\n        return this.serviceTx(internalSchema)\n          .mutate(({ uow }) =>\n            uow.update(\"fragno_hooks\", eventId, (b) =>\n              b.set({ status: \"completed\", lastAttemptAt: dbNow() }).check(),\n            ),\n          )\n          .build();\n      },\n\n      /**\n       * Mark a hook event as failed and schedule next retry.\n       */\n      markHookFailed(\n        eventId: FragnoId,\n        error: string,\n        attempts: number,\n        retryPolicy: RetryPolicy,\n        now?: Date,\n      ) {\n        const newAttempts = attempts + 1;\n        const shouldRetry = retryPolicy.shouldRetry(newAttempts - 1);\n\n        return this.serviceTx(internalSchema)\n          .mutate(({ uow }) => {\n            if (shouldRetry) {\n              const delayMs = retryPolicy.getDelayMs(newAttempts - 1);\n              const baseNow = now ?? new Date();\n              const nextRetryAt = new Date(baseNow.getTime() + delayMs);\n              uow.update(\"fragno_hooks\", eventId, (b) =>\n                b\n                  .set({\n                    status: \"pending\",\n                    attempts: newAttempts,\n                    lastAttemptAt: dbNow(),\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: dbNow(),\n                    error,\n                  })\n                  .check(),\n              );\n            }\n          })\n          .build();\n      },\n\n      /**\n       * Mark a hook event as processing (to prevent concurrent execution).\n       */\n      markHookProcessing(eventId: FragnoId) {\n        return this.serviceTx(internalSchema)\n          .mutate(({ uow }) =>\n            uow.update(\"fragno_hooks\", eventId, (b) =>\n              b.set({ status: \"processing\", lastAttemptAt: dbNow() }).check(),\n            ),\n          )\n          .build();\n      },\n\n      /**\n       * Get a hook event by ID (for testing/verification purposes).\n       */\n      getHookById(eventId: FragnoId) {\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.findFirst(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"primary\", (eb) => eb(\"id\", \"=\", eventId)),\n            ),\n          )\n          .transformRetrieve(([result]) => result ?? undefined)\n          .build();\n      },\n\n      /**\n       * Get all hook events for a namespace (for testing/verification purposes).\n       */\n      getHooksByNamespace(namespace: string) {\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"idx_namespace_status_retry\", (eb) => eb(\"namespace\", \"=\", namespace)),\n            ),\n          )\n          .transformRetrieve(([events]) => events)\n          .build();\n      },\n    });\n  })\n  .providesService(\"outboxService\", ({ defineService }) => {\n    return defineService({\n      /**\n       * List outbox entries ordered by versionstamp (ascending).\n       */\n      list({ afterVersionstamp, limit }: { afterVersionstamp?: string; limit?: number } = {}) {\n        const afterValue = afterVersionstamp?.toLowerCase();\n\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_db_outbox\", (b) => {\n              let builder = afterValue\n                ? b.whereIndex(\"idx_outbox_versionstamp\", (eb) =>\n                    eb(\"versionstamp\", \">\", afterValue),\n                  )\n                : b.whereIndex(\"idx_outbox_versionstamp\");\n\n              builder = builder.orderByIndex(\"idx_outbox_versionstamp\", \"asc\");\n              if (limit !== undefined) {\n                builder = builder.pageSize(limit);\n              }\n              return builder;\n            }),\n          )\n          .transformRetrieve(([entries]) =>\n            entries.map((entry) => ({\n              id: entry.id,\n              versionstamp: entry.versionstamp,\n              uowId: entry.uowId,\n              payload: entry.payload,\n              refMap: entry.refMap ?? undefined,\n              createdAt: entry.createdAt,\n            })),\n          )\n          .build();\n      },\n    });\n  })\n  .build();\n\n/**\n * Type representing an instantiated internal fragment.\n * This is the fragment that manages Fragno's internal settings table.\n */\nexport type InternalFragmentInstance = InstantiatedFragmentFromDefinition<\n  typeof internalFragmentDef\n>;\n\nexport async function getSchemaVersionFromDatabase(\n  fragment: InternalFragmentInstance,\n  namespace: string,\n): Promise<number> {\n  try {\n    const readSchemaVersion = async (targetNamespace: string): Promise<number | undefined> => {\n      const setting = await fragment.inContext(async function () {\n        return await this.handlerTx()\n          .withServiceCalls(\n            () =>\n              [fragment.services.settingsService.get(targetNamespace, \"schema_version\")] as const,\n          )\n          .transform(({ serviceResult: [result] }) => result)\n          .execute();\n      });\n      if (!setting) {\n        return undefined;\n      }\n      const parsed = parseInt(setting.value, 10);\n      return Number.isNaN(parsed) ? undefined : parsed;\n    };\n\n    const primary = await readSchemaVersion(namespace);\n    if (primary !== undefined) {\n      return primary;\n    }\n\n    // Back-compat: some installs stored internal schema version under a different namespace.\n    // Check the alternate key (empty string ↔ schema name) so we find the version either way.\n    const legacyNamespace =\n      namespace === \"\" ? internalSchema.name : namespace === internalSchema.name ? \"\" : null;\n    if (legacyNamespace !== null) {\n      const legacy = await readSchemaVersion(legacyNamespace);\n      if (legacy !== undefined) {\n        return legacy;\n      }\n    }\n\n    return 0;\n  } catch {\n    return 0;\n  }\n}\n"],"mappings":"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"}

package/dist/fragments/internal-fragment.routes.js

@@ -0,0 +1,29 @@
+import { defineRoutes } from "../packages/fragno/dist/api/route.js";
+import { internalFragmentDef } from "./internal-fragment.js";
+
+//#region src/fragments/internal-fragment.routes.ts
+const internalFragmentRoutes = defineRoutes(internalFragmentDef).create(({ defineRoute, services }) => [defineRoute({
+	method: "GET",
+	path: "/outbox",
+	handler: async function(input, { json }) {
+		const afterVersionstamp = input.query.get("afterVersionstamp") ?? void 0;
+		const limitValue = input.query.get("limit");
+		let limit;
+		if (limitValue !== null) {
+			const parsed = Number.parseInt(limitValue, 10);
+			if (!Number.isFinite(parsed) || parsed < 1) return json({
+				error: "Invalid limit query parameter.",
+				code: "INVALID_LIMIT"
+			}, { status: 400 });
+			limit = parsed;
+		}
+		return json(await this.handlerTx().withServiceCalls(() => [services.outboxService.list({
+			afterVersionstamp,
+			limit
+		})]).transform(({ serviceResult: [result] }) => result).execute());
+	}
+})]);
+
+//#endregion
+export { internalFragmentRoutes };
+//# sourceMappingURL=internal-fragment.routes.js.map

package/dist/fragments/internal-fragment.routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-fragment.routes.js","names":["limit: number | undefined"],"sources":["../../src/fragments/internal-fragment.routes.ts"],"sourcesContent":["import { defineRoutes } from \"@fragno-dev/core\";\nimport { internalFragmentDef } from \"./internal-fragment\";\n\nexport const internalFragmentRoutes = defineRoutes(internalFragmentDef).create(\n  ({ defineRoute, services }) => [\n    defineRoute({\n      method: \"GET\",\n      path: \"/outbox\",\n      handler: async function (input, { json }) {\n        // We intentionally skip input/output schemas here to keep the internal route lightweight.\n        // Query params are validated manually and the response shape is stable (OutboxEntry[]),\n        // while the public API surface is still gated behind adapter config.\n        const afterVersionstamp = input.query.get(\"afterVersionstamp\") ?? undefined;\n        const limitValue = input.query.get(\"limit\");\n        let limit: number | undefined;\n\n        if (limitValue !== null) {\n          const parsed = Number.parseInt(limitValue, 10);\n          if (!Number.isFinite(parsed) || parsed < 1) {\n            return json(\n              {\n                error: \"Invalid limit query parameter.\",\n                code: \"INVALID_LIMIT\",\n              },\n              { status: 400 },\n            );\n          }\n          limit = parsed;\n        }\n\n        const entries = await this.handlerTx()\n          .withServiceCalls(\n            () => [services.outboxService.list({ afterVersionstamp, limit })] as const,\n          )\n          .transform(({ serviceResult: [result] }) => result)\n          .execute();\n\n        return json(entries);\n      },\n    }),\n  ],\n);\n"],"mappings":";;;;AAGA,MAAa,yBAAyB,aAAa,oBAAoB,CAAC,QACrE,EAAE,aAAa,eAAe,CAC7B,YAAY;CACV,QAAQ;CACR,MAAM;CACN,SAAS,eAAgB,OAAO,EAAE,QAAQ;EAIxC,MAAM,oBAAoB,MAAM,MAAM,IAAI,oBAAoB,IAAI;EAClE,MAAM,aAAa,MAAM,MAAM,IAAI,QAAQ;EAC3C,IAAIA;AAEJ,MAAI,eAAe,MAAM;GACvB,MAAM,SAAS,OAAO,SAAS,YAAY,GAAG;AAC9C,OAAI,CAAC,OAAO,SAAS,OAAO,IAAI,SAAS,EACvC,QAAO,KACL;IACE,OAAO;IACP,MAAM;IACP,EACD,EAAE,QAAQ,KAAK,CAChB;AAEH,WAAQ;;AAUV,SAAO,KAPS,MAAM,KAAK,WAAW,CACnC,uBACO,CAAC,SAAS,cAAc,KAAK;GAAE;GAAmB;GAAO,CAAC,CAAC,CAClE,CACA,WAAW,EAAE,eAAe,CAAC,cAAc,OAAO,CAClD,SAAS,CAEQ;;CAEvB,CAAC,CACH,CACF"}

package/dist/fragments/internal-fragment.schema.d.ts

@@ -0,0 +1,9 @@
+import { DbNow } from "../query/db-now.js";
+import { AnyColumn, AnyRelation, Column, FragnoId, IdColumn, Index, Schema, Table } from "../schema/create.js";
+import "../mod.js";
+
+//#region src/fragments/internal-fragment.schema.d.ts
+declare const internalSchema: Schema<Record<"fragno_db_settings", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"key", Column<"string", string, string>> & Record<"value", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"unique_key", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["key"]>>>> & Record<"fragno_hooks", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"namespace", Column<"string", string, string>> & Record<"hookName", Column<"string", string, string>> & Record<"payload", Column<"json", unknown, unknown>> & Record<"status", Column<"string", string, string>> & Record<"attempts", Column<"integer", number | null, number>> & Record<"maxAttempts", Column<"integer", number | null, number>> & Record<"lastAttemptAt", Column<"timestamp", (DbNow | Date) | null, Date | null>> & Record<"nextRetryAt", Column<"timestamp", (DbNow | Date) | null, Date | null>> & Record<"error", Column<"string", string | null, string | null>> & Record<"createdAt", Column<"timestamp", (DbNow | Date) | null, Date>> & Record<"nonce", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_namespace_status_retry", Index<readonly [Column<"string", string, string>, Column<"string", string, string>, Column<"timestamp", (DbNow | Date) | null, Date | null>] & AnyColumn[], readonly ["namespace", "status", "nextRetryAt"]>> & Record<"idx_nonce", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["nonce"]>>>> & Record<"fragno_db_outbox", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"versionstamp", Column<"string", string, string>> & Record<"uowId", Column<"string", string, string>> & Record<"payload", Column<"json", unknown, unknown>> & Record<"refMap", Column<"json", unknown, unknown>> & Record<"createdAt", Column<"timestamp", (DbNow | Date) | null, Date>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_outbox_versionstamp", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["versionstamp"]>> & Record<"idx_outbox_uow", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["uowId"]>>>>>;
+//#endregion
+export { internalSchema };
+//# sourceMappingURL=internal-fragment.schema.d.ts.map

package/dist/fragments/internal-fragment.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-fragment.schema.d.ts","names":[],"sources":["../../src/fragments/internal-fragment.schema.ts"],"sourcesContent":[],"mappings":";;;;;cAOa,gBAAc,OAAA,6BAAA,MAAA,eA2CzB,SAAA,IA3CyB,aAAA,iCAAA,QAAA,SAAA,QAAA,KAAA,cAAA,oCAAA,gBAAA,mCAAA,eAAA,WAAA,GAAA,eAAA,MAAA,SAAA,0BAAA,qBAAA,gBAAA,oCAAA,SAAA,2BAAA,uBAAA,MAAA,eAAA,SAAA,IAAA,aAAA,iCAAA,QAAA,SAAA,QAAA,KAAA,oBAAA,oCAAA,mBAAA,oCAAA,kBAAA,oCAAA,iBAAA,oCAAA,mBAAA,4CAAA,sBAAA,4CAAA,wBAAA,qBAAA,KAAA,GAAA,cAAA,gBAAA,sBAAA,qBAAA,KAAA,GAAA,cAAA,gBAAA,gBAAA,kDAAA,oBAAA,qBAAA,KAAA,GAAA,cAAA,SAAA,gBAAA,mCAAA,eAAA,WAAA,GAAA,eAAA,MAAA,SAAA,0BAAA,qCAAA,gBAAA,kCAAA,kCAAA,qBAAA,KAAA,GAAA,cAAA,gBAAA,SAAA,wDAAA,oBAAA,gBAAA,oCAAA,SAAA,6BAAA,2BAAA,MAAA,eAAA,SAAA,IAAA,aAAA,iCAAA,QAAA,SAAA,QAAA,KAAA,uBAAA,oCAAA,gBAAA,oCAAA,kBAAA,oCAAA,iBAAA,oCAAA,oBAAA,qBAAA,KAAA,GAAA,cAAA,QAAA,eAAA,WAAA,GAAA,eAAA,MAAA,SAAA,0BAAA,kCAAA,gBAAA,oCAAA,SAAA,kCAAA,yBAAA,gBAAA,oCAAA,SAAA"}

package/dist/fragments/internal-fragment.schema.js

@@ -0,0 +1,22 @@
+import { column, idColumn, schema } from "../schema/create.js";
+
+//#region src/fragments/internal-fragment.schema.ts
+const SETTINGS_TABLE_NAME = "fragno_db_settings";
+const SETTINGS_NAMESPACE = "fragno-db-settings";
+const internalSchema = schema("fragno_internal", (s) => {
+	return s.addTable(SETTINGS_TABLE_NAME, (t) => {
+		return t.addColumn("id", idColumn()).addColumn("key", column("string")).addColumn("value", column("string")).createIndex("unique_key", ["key"], { unique: true });
+	}).addTable("fragno_hooks", (t) => {
+		return t.addColumn("id", idColumn()).addColumn("namespace", column("string")).addColumn("hookName", column("string")).addColumn("payload", column("json")).addColumn("status", column("string")).addColumn("attempts", column("integer").defaultTo(0)).addColumn("maxAttempts", column("integer").defaultTo(5)).addColumn("lastAttemptAt", column("timestamp").nullable()).addColumn("nextRetryAt", column("timestamp").nullable()).addColumn("error", column("string").nullable()).addColumn("createdAt", column("timestamp").defaultTo((b) => b.now())).addColumn("nonce", column("string")).createIndex("idx_namespace_status_retry", [
+			"namespace",
+			"status",
+			"nextRetryAt"
+		]).createIndex("idx_nonce", ["nonce"]);
+	}).addTable("fragno_db_outbox", (t) => {
+		return t.addColumn("id", idColumn()).addColumn("versionstamp", column("string")).addColumn("uowId", column("string")).addColumn("payload", column("json")).addColumn("refMap", column("json").nullable()).addColumn("createdAt", column("timestamp").defaultTo((b) => b.now())).createIndex("idx_outbox_versionstamp", ["versionstamp"], { unique: true }).createIndex("idx_outbox_uow", ["uowId"]);
+	});
+});
+
+//#endregion
+export { SETTINGS_NAMESPACE, SETTINGS_TABLE_NAME, internalSchema };
+//# sourceMappingURL=internal-fragment.schema.js.map

package/dist/fragments/internal-fragment.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-fragment.schema.js","names":[],"sources":["../../src/fragments/internal-fragment.schema.ts"],"sourcesContent":["import { schema, idColumn, column } from \"../schema/create\";\n\n// Constants for Fragno's internal settings table\nexport const SETTINGS_TABLE_NAME = \"fragno_db_settings\" as const;\n// FIXME: In some places we simply use empty string \"\" as namespace, which is not correct.\nexport const SETTINGS_NAMESPACE = \"fragno-db-settings\" as const;\n\nexport const internalSchema = schema(\"fragno_internal\", (s) => {\n  return s\n    .addTable(SETTINGS_TABLE_NAME, (t) => {\n      return t\n        .addColumn(\"id\", idColumn())\n        .addColumn(\"key\", column(\"string\"))\n        .addColumn(\"value\", column(\"string\"))\n        .createIndex(\"unique_key\", [\"key\"], { unique: true });\n    })\n    .addTable(\"fragno_hooks\", (t) => {\n      return t\n        .addColumn(\"id\", idColumn())\n        .addColumn(\"namespace\", column(\"string\"))\n        .addColumn(\"hookName\", column(\"string\"))\n        .addColumn(\"payload\", column(\"json\"))\n        .addColumn(\"status\", column(\"string\")) // \"pending\" | \"processing\" | \"completed\" | \"failed\"\n        .addColumn(\"attempts\", column(\"integer\").defaultTo(0))\n        .addColumn(\"maxAttempts\", column(\"integer\").defaultTo(5))\n        .addColumn(\"lastAttemptAt\", column(\"timestamp\").nullable())\n        .addColumn(\"nextRetryAt\", column(\"timestamp\").nullable())\n        .addColumn(\"error\", column(\"string\").nullable())\n        .addColumn(\n          \"createdAt\",\n          column(\"timestamp\").defaultTo((b) => b.now()),\n        )\n        .addColumn(\"nonce\", column(\"string\"))\n        .createIndex(\"idx_namespace_status_retry\", [\"namespace\", \"status\", \"nextRetryAt\"])\n        .createIndex(\"idx_nonce\", [\"nonce\"]);\n    })\n    .addTable(\"fragno_db_outbox\", (t) => {\n      return t\n        .addColumn(\"id\", idColumn())\n        .addColumn(\"versionstamp\", column(\"string\"))\n        .addColumn(\"uowId\", column(\"string\"))\n        .addColumn(\"payload\", column(\"json\"))\n        .addColumn(\"refMap\", column(\"json\").nullable())\n        .addColumn(\n          \"createdAt\",\n          column(\"timestamp\").defaultTo((b) => b.now()),\n        )\n        .createIndex(\"idx_outbox_versionstamp\", [\"versionstamp\"], { unique: true })\n        .createIndex(\"idx_outbox_uow\", [\"uowId\"]);\n    });\n});\n"],"mappings":";;;AAGA,MAAa,sBAAsB;AAEnC,MAAa,qBAAqB;AAElC,MAAa,iBAAiB,OAAO,oBAAoB,MAAM;AAC7D,QAAO,EACJ,SAAS,sBAAsB,MAAM;AACpC,SAAO,EACJ,UAAU,MAAM,UAAU,CAAC,CAC3B,UAAU,OAAO,OAAO,SAAS,CAAC,CAClC,UAAU,SAAS,OAAO,SAAS,CAAC,CACpC,YAAY,cAAc,CAAC,MAAM,EAAE,EAAE,QAAQ,MAAM,CAAC;GACvD,CACD,SAAS,iBAAiB,MAAM;AAC/B,SAAO,EACJ,UAAU,MAAM,UAAU,CAAC,CAC3B,UAAU,aAAa,OAAO,SAAS,CAAC,CACxC,UAAU,YAAY,OAAO,SAAS,CAAC,CACvC,UAAU,WAAW,OAAO,OAAO,CAAC,CACpC,UAAU,UAAU,OAAO,SAAS,CAAC,CACrC,UAAU,YAAY,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC,CACrD,UAAU,eAAe,OAAO,UAAU,CAAC,UAAU,EAAE,CAAC,CACxD,UAAU,iBAAiB,OAAO,YAAY,CAAC,UAAU,CAAC,CAC1D,UAAU,eAAe,OAAO,YAAY,CAAC,UAAU,CAAC,CACxD,UAAU,SAAS,OAAO,SAAS,CAAC,UAAU,CAAC,CAC/C,UACC,aACA,OAAO,YAAY,CAAC,WAAW,MAAM,EAAE,KAAK,CAAC,CAC9C,CACA,UAAU,SAAS,OAAO,SAAS,CAAC,CACpC,YAAY,8BAA8B;GAAC;GAAa;GAAU;GAAc,CAAC,CACjF,YAAY,aAAa,CAAC,QAAQ,CAAC;GACtC,CACD,SAAS,qBAAqB,MAAM;AACnC,SAAO,EACJ,UAAU,MAAM,UAAU,CAAC,CAC3B,UAAU,gBAAgB,OAAO,SAAS,CAAC,CAC3C,UAAU,SAAS,OAAO,SAAS,CAAC,CACpC,UAAU,WAAW,OAAO,OAAO,CAAC,CACpC,UAAU,UAAU,OAAO,OAAO,CAAC,UAAU,CAAC,CAC9C,UACC,aACA,OAAO,YAAY,CAAC,WAAW,MAAM,EAAE,KAAK,CAAC,CAC9C,CACA,YAAY,2BAA2B,CAAC,eAAe,EAAE,EAAE,QAAQ,MAAM,CAAC,CAC1E,YAAY,kBAAkB,CAAC,QAAQ,CAAC;GAC3C;EACJ"}

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

@@ -0,0 +1,14 @@
+import { AnySchema } from "../schema/create.js";
+import { AnyFragnoInstantiatedDatabaseFragment } from "../mod.js";
+
+//#region src/hooks/durable-hooks-processor.d.ts
+type DurableHooksProcessor = {
+  process: () => Promise<number>;
+  getNextWakeAt: () => Promise<Date | null>;
+  drain: () => Promise<void>;
+  namespace: string;
+};
+declare function createDurableHooksProcessor<TSchema extends AnySchema>(fragment: AnyFragnoInstantiatedDatabaseFragment<TSchema>): DurableHooksProcessor | null;
+//#endregion
+export { DurableHooksProcessor, createDurableHooksProcessor };
+//# sourceMappingURL=durable-hooks-processor.d.ts.map

package/dist/hooks/durable-hooks-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-hooks-processor.d.ts","names":[],"sources":["../../src/hooks/durable-hooks-processor.ts"],"sourcesContent":[],"mappings":";;;;KAIY,qBAAA;iBACK;EADL,aAAA,EAAA,GAAA,GAEW,OAFU,CAEF,IAFE,GAAA,IAAA,CAAA;EAChB,KAAA,EAAA,GAAA,GAEF,OAFE,CAAA,IAAA,CAAA;EACc,SAAA,EAAA,MAAA;CAAR;AACR,iBAoBC,2BApBD,CAAA,gBAoB6C,SApB7C,CAAA,CAAA,QAAA,EAqBH,qCArBG,CAqBmC,OArBnC,CAAA,CAAA,EAsBZ,qBAtBY,GAAA,IAAA"}

package/dist/hooks/durable-hooks-processor.js

@@ -0,0 +1,32 @@
+import { createHookScheduler } from "./hooks.js";
+
+//#region src/hooks/durable-hooks-processor.ts
+const DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES = 10;
+function resolveStuckProcessingTimeoutMinutes(value) {
+	if (value === false) return false;
+	if (typeof value === "number") return value > 0 ? value : false;
+	return DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES;
+}
+function createDurableHooksProcessor(fragment) {
+	const durableHooks = fragment.$internal.durableHooks;
+	if (!durableHooks) return null;
+	const { namespace, internalFragment } = durableHooks;
+	const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(durableHooks.stuckProcessingTimeoutMinutes);
+	const scheduler = durableHooks.scheduler ?? (durableHooks.scheduler = createHookScheduler(durableHooks));
+	return {
+		namespace,
+		process: async () => scheduler.schedule(),
+		drain: async () => scheduler.drain(),
+		getNextWakeAt: async () => {
+			const services = internalFragment.services;
+			const now = services.getDbNow ? await services.getDbNow() : /* @__PURE__ */ new Date();
+			return await internalFragment.inContext(async function() {
+				return await this.handlerTx().withServiceCalls(() => [internalFragment.services.hookService.getNextHookWakeAt(namespace, stuckProcessingTimeoutMinutes, now)]).transform(({ serviceResult: [result] }) => result).execute();
+			});
+		}
+	};
+}
+
+//#endregion
+export { createDurableHooksProcessor };
+//# sourceMappingURL=durable-hooks-processor.js.map

package/dist/hooks/durable-hooks-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-hooks-processor.js","names":[],"sources":["../../src/hooks/durable-hooks-processor.ts"],"sourcesContent":["import type { AnySchema } from \"../schema/create\";\nimport type { AnyFragnoInstantiatedDatabaseFragment } from \"../mod\";\nimport { createHookScheduler, type HookProcessorConfig } from \"./hooks\";\n\nexport type DurableHooksProcessor = {\n  process: () => Promise<number>;\n  getNextWakeAt: () => Promise<Date | null>;\n  drain: () => Promise<void>;\n  namespace: string;\n};\n\ntype DurableHooksInternal = {\n  durableHooks?: HookProcessorConfig;\n};\n\nconst DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES = 10;\n\nfunction resolveStuckProcessingTimeoutMinutes(value: number | false | undefined): 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\nexport function createDurableHooksProcessor<TSchema extends AnySchema>(\n  fragment: AnyFragnoInstantiatedDatabaseFragment<TSchema>,\n): DurableHooksProcessor | null {\n  const durableHooks = (fragment.$internal as DurableHooksInternal).durableHooks;\n  if (!durableHooks) {\n    return null;\n  }\n\n  const { namespace, internalFragment } = durableHooks;\n  const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(\n    durableHooks.stuckProcessingTimeoutMinutes,\n  );\n  const scheduler =\n    durableHooks.scheduler ?? (durableHooks.scheduler = createHookScheduler(durableHooks));\n\n  return {\n    namespace,\n    process: async () => scheduler.schedule(),\n    drain: async () => scheduler.drain(),\n    getNextWakeAt: async () => {\n      const services = internalFragment.services as { getDbNow?: () => Promise<Date> };\n      const now = services.getDbNow ? await services.getDbNow() : new Date();\n      return await internalFragment.inContext(async function () {\n        return await this.handlerTx()\n          .withServiceCalls(\n            () =>\n              [\n                internalFragment.services.hookService.getNextHookWakeAt(\n                  namespace,\n                  stuckProcessingTimeoutMinutes,\n                  now,\n                ),\n              ] as const,\n          )\n          .transform(({ serviceResult: [result] }) => result)\n          .execute();\n      });\n    },\n  };\n}\n"],"mappings":";;;AAeA,MAAM,2CAA2C;AAEjD,SAAS,qCAAqC,OAAmD;AAC/F,KAAI,UAAU,MACZ,QAAO;AAET,KAAI,OAAO,UAAU,SACnB,QAAO,QAAQ,IAAI,QAAQ;AAE7B,QAAO;;AAGT,SAAgB,4BACd,UAC8B;CAC9B,MAAM,eAAgB,SAAS,UAAmC;AAClE,KAAI,CAAC,aACH,QAAO;CAGT,MAAM,EAAE,WAAW,qBAAqB;CACxC,MAAM,gCAAgC,qCACpC,aAAa,8BACd;CACD,MAAM,YACJ,aAAa,cAAc,aAAa,YAAY,oBAAoB,aAAa;AAEvF,QAAO;EACL;EACA,SAAS,YAAY,UAAU,UAAU;EACzC,OAAO,YAAY,UAAU,OAAO;EACpC,eAAe,YAAY;GACzB,MAAM,WAAW,iBAAiB;GAClC,MAAM,MAAM,SAAS,WAAW,MAAM,SAAS,UAAU,mBAAG,IAAI,MAAM;AACtE,UAAO,MAAM,iBAAiB,UAAU,iBAAkB;AACxD,WAAO,MAAM,KAAK,WAAW,CAC1B,uBAEG,CACE,iBAAiB,SAAS,YAAY,kBACpC,WACA,+BACA,IACD,CACF,CACJ,CACA,WAAW,EAAE,eAAe,CAAC,cAAc,OAAO,CAClD,SAAS;KACZ;;EAEL"}

package/dist/hooks/hooks.d.ts

@@ -1,4 +1,6 @@
+import { FragnoId } from "../schema/create.js";
 import { RetryPolicy } from "../query/unit-of-work/retry-policy.js";
+import { ExecuteTxOptions, HandlerTxBuilder } from "../query/unit-of-work/execute-unit-of-work.js";
 import "../fragments/internal-fragment.js";
 import "../query/unit-of-work/unit-of-work.js";
 
@@ -14,6 +16,10 @@ interface HookContext {
    * Use this for idempotency checks in your hook implementation.
    */
   idempotencyKey: string;
+  /**
+   * Create a handler transaction builder to run atomic operations.
+   */
+  handlerTx: HookHandlerTx;
 }
 /**
  * A hook function signature.
@@ -38,6 +44,11 @@ interface TriggerHookOptions {
    * If not provided, uses the default retry policy.
    */
   retryPolicy?: RetryPolicy;
+  /**
+   * Absolute time for the first attempt. If in the future, the hook is
+   * scheduled for that time; if in the past, it runs immediately.
+   */
+  processAt?: Date;
 }
 /**
  * Internal representation of a triggered hook.
@@ -48,6 +59,36 @@ interface TriggeredHook {
   payload: unknown;
   options?: TriggerHookOptions;
 }
+type StuckHookProcessingTimeoutMinutes = number | false;
+type StuckHookProcessingEvent = {
+  id: FragnoId;
+  hookName: string;
+  attempts: number;
+  maxAttempts: number;
+  lastAttemptAt: Date | null;
+  nextRetryAt: Date | null;
+};
+type StuckHookProcessingInfo = {
+  namespace: string;
+  timeoutMinutes: number;
+  events: StuckHookProcessingEvent[];
+};
+type DurableHooksProcessingOptions = {
+  /**
+   * Re-queue hooks that have been in `processing` for at least this many minutes.
+   * Use `false` to disable stuck-processing recovery entirely.
+   * Values <= 0 are treated as `false`.
+   *
+   * Default: 10 minutes.
+   */
+  stuckProcessingTimeoutMinutes?: StuckHookProcessingTimeoutMinutes;
+  /**
+   * Called when stuck processing hooks are detected and re-queued.
+   * Invoked after the hooks are moved back to `pending`.
+   */
+  onStuckProcessingHooks?: (info: StuckHookProcessingInfo) => void;
+};
+type HookHandlerTx = (execOptions?: Omit<ExecuteTxOptions, "createUnitOfWork">) => HandlerTxBuilder<readonly [], [], [], unknown, unknown, false, false, false, false, HooksMap>;
 //#endregion
-export { HookContext, HookFn, HookPayload, HooksMap, TriggerHookOptions, TriggeredHook };
+export { DurableHooksProcessingOptions, HookContext, HookFn, HookPayload, HooksMap, StuckHookProcessingEvent, StuckHookProcessingInfo, StuckHookProcessingTimeoutMinutes, TriggerHookOptions, TriggeredHook };
 //# sourceMappingURL=hooks.d.ts.map

package/dist/hooks/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","names":[],"sources":["../../src/hooks/hooks.ts"],"sourcesContent":[],"mappings":";;;;;;;;AAUA;AAYA;AAOY,UAnBK,WAAA,CAmBqB;EAK1B;;;;EAA8C,cAAA,EAAA,MAAA;AAK1D;AAYA;;;;KA7BY,uCAAuC,oBAAoB;;;;;KAO3D,QAAA,GAAW,eAAe;;;;KAK1B,iBAAiB,UAAU,kBAAkB;;;;UAKxC,kBAAA;;;;;gBAKD;;;;;;UAOC,aAAA;;;YAGL"}
+{"version":3,"file":"hooks.d.ts","names":[],"sources":["../../src/hooks/hooks.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;AAeA;AAgBA;AAOY,UAvBK,WAAA,CAuBqB;EAK1B;;;;EAA8C,cAAA,EAAA,MAAA;EAKzC;AAiBjB;AAuCA;EAEY,SAAA,EAlFC,aAkFD;;;;;AASZ;AAMY,KA1FA,MA0FA,CAAA,WAAA,OAA6B,CAAA,GAAA,CAAA,OAQP,EAlGiB,QAkGjB,EAAA,GAAA,IAAA,GAlGqC,OAkGrC,CAAA,IAAA,CAKA;AAGlC;;;;AAEK,KArGO,QAAA,GAAW,MAqGlB,CAAA,MAAA,EArGiC,MAqGjC,CAAA,GAAA,CAAA,CAAA;;;;KAhGO,iBAAiB,UAAU,kBAAkB;;;;UAKxC,kBAAA;;;;;gBAKD;;;;;cAKF;;;;;;UAOG,aAAA;;;YAGL;;KAoCA,iCAAA;KAEA,wBAAA;MACN;;;;iBAIW;eACF;;KAGH,uBAAA;;;UAGF;;KAGE,6BAAA;;;;;;;;kCAQsB;;;;;kCAKA;;KAGtB,aAAA,kBACI,KAAK,0CAChB,oFAAoF"}