@fragno-dev/db 0.3.0 → 0.4.1

package/dist/fragments/internal-fragment.js

@@ -1,14 +1,37 @@
-import { FragmentDefinitionBuilder } from "../packages/fragno/dist/api/fragment-definition-builder.js";
+import { dbNow } from "../query/db-now.js";
 import { FragnoId } from "../schema/create.js";
+import { isHookStatus } from "../hooks/hooks.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 { FragmentDefinitionBuilder } from "@fragno-dev/core";
 
 //#region src/fragments/internal-fragment.ts
-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 }) => {
+var SchemaRegistryCollisionError = class extends Error {
+	code = "SCHEMA_REGISTRY_COLLISION";
+	namespaceKey;
+	existing;
+	attempted;
+	constructor({ namespaceKey, existing, attempted }) {
+		super(`Schema namespace "${namespaceKey}" is already owned by "${existing.name}" (${existing.namespace ?? "null"}).`);
+		this.name = "SchemaRegistryCollisionError";
+		this.namespaceKey = namespaceKey;
+		this.existing = existing;
+		this.attempted = attempted;
+	}
+};
+const INTERNAL_SCHEMA_MIN_VERSION = 4;
+if (internalSchema.version < INTERNAL_SCHEMA_MIN_VERSION) internalSchema.version = INTERNAL_SCHEMA_MIN_VERSION;
+const describeHookStatusSource = (event) => `fragno_hooks id=${event.id} hook=${event.hookName}`;
+const coerceHookStatus = (status, context) => {
+	if (isHookStatus(status)) return status;
+	throw new Error(`Invalid hook status from database (${context}): ${status}`);
+};
+const DEFAULT_HOOKS_PAGE_SIZE = 50;
+const resolveHookPageSize = (pageSize) => {
+	if (typeof pageSize !== "number" || !Number.isInteger(pageSize) || pageSize <= 0) return DEFAULT_HOOKS_PAGE_SIZE;
+	return pageSize;
+};
+const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDefinitionBuilder("$fragno-internal-fragment"), internalSchema).providesService("settingsService", ({ defineService }) => {
 	return defineService({
 		get(namespace, key) {
 			const fullKey = `${namespace}.${key}`;
@@ -24,6 +47,16 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 				});
 			}).build();
 		},
+		setIfMissing(namespace, key, value) {
+			const fullKey = `${namespace}.${key}`;
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.findFirst(SETTINGS_TABLE_NAME, (b) => b.whereIndex("unique_key", (eb) => eb("key", "=", fullKey)))).transformRetrieve(([result]) => result).mutate(({ uow, retrieveResult }) => {
+				if (retrieveResult) return;
+				uow.create(SETTINGS_TABLE_NAME, {
+					key: fullKey,
+					value
+				});
+			}).build();
+		},
 		delete(id) {
 			return this.serviceTx(internalSchema).mutate(({ uow }) => uow.delete(SETTINGS_TABLE_NAME, id)).build();
 		}
@@ -37,8 +70,12 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 					id: event.id,
 					hookName: event.hookName,
 					payload: event.payload,
+					status: coerceHookStatus(event.status, describeHookStatusSource(event)),
 					attempts: event.attempts,
 					maxAttempts: event.maxAttempts,
+					lastAttemptAt: event.lastAttemptAt,
+					nextRetryAt: event.nextRetryAt,
+					createdAt: event.createdAt,
 					idempotencyKey: event.nonce
 				}));
 			}).build();
@@ -50,8 +87,12 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 					id: event.id,
 					hookName: event.hookName,
 					payload: event.payload,
+					status: coerceHookStatus(event.status, describeHookStatusSource(event)),
 					attempts: event.attempts,
 					maxAttempts: event.maxAttempts,
+					lastAttemptAt: event.lastAttemptAt,
+					nextRetryAt: event.nextRetryAt,
+					createdAt: event.createdAt,
 					idempotencyKey: event.nonce
 				}));
 			}).mutate(({ uow, retrieveResult }) => {
@@ -62,6 +103,7 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 				}).check());
 			}).transform(({ retrieveResult }) => retrieveResult.map((event) => ({
 				...event,
+				status: "processing",
 				id: new FragnoId({
 					externalId: event.id.externalId,
 					internalId: event.id.internalId,
@@ -69,104 +111,89 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 				})
 			}))).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) => ({
+		claimStuckProcessingHookEvents(namespace, staleBefore) {
+			const now = dbNow();
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_last_attempt", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", "processing"), eb.or(eb.isNull("lastAttemptAt"), eb("lastAttemptAt", "<=", staleBefore)))))).transformRetrieve(([events]) => {
+				return events.map((event) => ({
 					id: event.id,
 					hookName: event.hookName,
+					payload: event.payload,
+					status: coerceHookStatus(event.status, describeHookStatusSource(event)),
 					attempts: event.attempts,
 					maxAttempts: event.maxAttempts,
+					idempotencyKey: event.nonce,
 					lastAttemptAt: event.lastAttemptAt,
-					nextRetryAt: event.nextRetryAt
+					nextRetryAt: event.nextRetryAt,
+					createdAt: event.createdAt
 				}));
 			}).mutate(({ uow, retrieveResult }) => {
+				if (retrieveResult.length === 0) return;
 				for (const event of retrieveResult) uow.update("fragno_hooks", event.id, (b) => b.set({
-					status: "pending",
+					status: "processing",
+					lastAttemptAt: now,
 					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;
+			}).transform(({ retrieveResult }) => {
+				return {
+					events: retrieveResult.map((event) => ({
+						...event,
+						id: new FragnoId({
+							externalId: event.id.externalId,
+							internalId: event.id.internalId,
+							version: event.id.version + 1
+						})
+					})),
+					stuckEvents: retrieveResult.map((event) => ({
+						id: event.id,
+						hookName: event.hookName,
+						attempts: event.attempts,
+						maxAttempts: event.maxAttempts,
+						lastAttemptAt: event.lastAttemptAt,
+						nextRetryAt: event.nextRetryAt
+					}))
+				};
 			}).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;
+		getNextHookWakeAt(namespace, timeoutMinutes) {
+			const timeoutMinutesValue = typeof timeoutMinutes === "number" && timeoutMinutes > 0 ? timeoutMinutes : 0;
+			const includeProcessing = timeoutMinutesValue > 0;
+			const now = dbNow();
+			const timeoutMs = timeoutMinutesValue * 6e4;
+			const processingStatus = includeProcessing ? "processing" : "__disabled__";
+			const staleBefore = now.plus({ minutes: -timeoutMinutesValue });
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.forSchema(internalSchema).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)))).pageSize(1)).find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", "pending"), eb.isNotNull("nextRetryAt"), eb("nextRetryAt", ">", now))).orderByIndex("idx_namespace_status_retry", "asc").pageSize(1).select(["nextRetryAt"])).find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_last_attempt", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", processingStatus), eb.or(eb.isNull("lastAttemptAt"), eb("lastAttemptAt", "<=", staleBefore)))).pageSize(1)).find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_last_attempt", (eb) => eb.and(eb("namespace", "=", namespace), eb("status", "=", processingStatus), eb.isNotNull("lastAttemptAt"), eb("lastAttemptAt", ">", staleBefore))).orderByIndex("idx_namespace_status_last_attempt", "asc").pageSize(1).select(["lastAttemptAt"]))).transformRetrieve(([pendingImmediate, pendingNext, processingImmediate, processingNext]) => {
+				const hasProcessingImmediate = includeProcessing && processingImmediate.length > 0;
+				if (pendingImmediate.length > 0 || hasProcessingImmediate) return /* @__PURE__ */ new Date();
+				const pendingNextAt = pendingNext[0]?.nextRetryAt ?? null;
+				let processingNextAt = null;
+				if (includeProcessing) {
+					const lastAttemptAt = processingNext[0]?.lastAttemptAt;
+					if (lastAttemptAt) processingNextAt = new Date(lastAttemptAt.getTime() + timeoutMs);
 				}
-				if (!earliestPendingAt) return earliestStaleAt ?? null;
-				if (!earliestStaleAt) return earliestPendingAt;
-				return earliestPendingAt <= earliestStaleAt ? earliestPendingAt : earliestStaleAt;
+				if (!pendingNextAt) return processingNextAt ?? null;
+				if (!processingNextAt) return pendingNextAt;
+				return pendingNextAt <= processingNextAt ? pendingNextAt : processingNextAt;
 			}).build();
 		},
-		markHookCompleted(eventId) {
-			return this.serviceTx(internalSchema).mutate(({ uow }) => uow.update("fragno_hooks", eventId, (b) => b.set({
-				status: "completed",
-				lastAttemptAt: dbNow()
-			}).check())).build();
-		},
-		markHookFailed(eventId, error, attempts, retryPolicy, now) {
+		markHookFailed(eventId, error, attempts, retryPolicy) {
 			const newAttempts = attempts + 1;
 			const shouldRetry = retryPolicy.shouldRetry(newAttempts - 1);
+			const now = dbNow();
 			return this.serviceTx(internalSchema).mutate(({ uow }) => {
 				if (shouldRetry) {
 					const delayMs = retryPolicy.getDelayMs(newAttempts - 1);
-					const baseNow = now ?? /* @__PURE__ */ new Date();
-					const nextRetryAt = new Date(baseNow.getTime() + delayMs);
+					const nextRetryAt = now.plus({ ms: delayMs });
 					uow.update("fragno_hooks", eventId, (b) => b.set({
 						status: "pending",
 						attempts: newAttempts,
-						lastAttemptAt: dbNow(),
+						lastAttemptAt: now,
 						nextRetryAt,
 						error
 					}).check());
 				} else uow.update("fragno_hooks", eventId, (b) => b.set({
 					status: "failed",
 					attempts: newAttempts,
-					lastAttemptAt: dbNow(),
+					lastAttemptAt: now,
 					error
 				}).check());
 			}).build();
@@ -178,10 +205,30 @@ const internalFragmentDef = new DatabaseFragmentDefinitionBuilder(new FragmentDe
 			}).check())).build();
 		},
 		getHookById(eventId) {
-			return this.serviceTx(internalSchema).retrieve((uow) => uow.findFirst("fragno_hooks", (b) => b.whereIndex("primary", (eb) => eb("id", "=", eventId)))).transformRetrieve(([result]) => result ?? void 0).build();
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.findFirst("fragno_hooks", (b) => b.whereIndex("primary", (eb) => eb("id", "=", eventId)))).transformRetrieve(([result]) => result ? {
+				...result,
+				status: coerceHookStatus(result.status, describeHookStatusSource(result))
+			} : void 0).build();
+		},
+		getHooksByNamespacePage(namespace, options = {}) {
+			const pageSize = resolveHookPageSize(options.pageSize);
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.findWithCursor("fragno_hooks", (b) => {
+				const query = b.whereIndex("idx_namespace_created_at", (eb) => eb("namespace", "=", namespace)).orderByIndex("idx_namespace_created_at", "desc").pageSize(pageSize);
+				return options.cursor ? query.after(options.cursor) : query;
+			})).transformRetrieve(([page]) => ({
+				items: page.items.map((event) => ({
+					...event,
+					status: coerceHookStatus(event.status, describeHookStatusSource(event))
+				})),
+				cursor: page.cursor,
+				hasNextPage: page.hasNextPage
+			})).build();
 		},
 		getHooksByNamespace(namespace) {
-			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();
+			return this.serviceTx(internalSchema).retrieve((uow) => uow.find("fragno_hooks", (b) => b.whereIndex("idx_namespace_status_retry", (eb) => eb("namespace", "=", namespace)))).transformRetrieve(([events]) => events.map((event) => ({
+				...event,
+				status: coerceHookStatus(event.status, describeHookStatusSource(event))
+			}))).build();
 		}
 	});
 }).providesService("outboxService", ({ defineService }) => {
@@ -226,5 +273,5 @@ async function getSchemaVersionFromDatabase(fragment, namespace) {
 }
 
 //#endregion
-export { getSchemaVersionFromDatabase, internalFragmentDef };
+export { SchemaRegistryCollisionError, getSchemaVersionFromDatabase, internalFragmentDef };
 //# sourceMappingURL=internal-fragment.js.map

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

@@ -1 +1 @@
-{"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":";;;;;;;AA2BA,MAAa,sBAAsB,IAAI,kCACrC,IAAI,0BAWF,4BAA4B,EAC9B,eACD,CACE,qBAAqB,EAAE,YAAY,EAClC,UAAU,YAAY;AACpB,KAAI,KAAK,GAAG,IACV,QAAO,KAAK,GAAG,KAAK;AAEtB,wBAAO,IAAI,MAAM;GAEpB,EAAE,CACF,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;GACtC,MAAM,MAAM,OAAO;AACnB,UAAO,KAAK,UAAU,eAAe,CAClC,UAAU,QACT,IAAI,KAAK,iBAAiB,MACxB,EAAE,WAAW,+BAA+B,OAC1C,GAAG,IACD,GAAG,aAAa,KAAK,UAAU,EAC/B,GAAG,UAAU,KAAK,UAAU,EAC5B,GAAG,GAAG,GAAG,OAAO,cAAc,EAAE,GAAG,eAAe,MAAM,IAAI,CAAC,CAC9D,CACF,CACF,CACF,CACA,mBAAmB,CAAC,YAAY;AAC/B,WAAO,OAAO,KAAK,WAAW;KAC5B,IAAI,MAAM;KACV,UAAU,MAAM;KAChB,SAAS,MAAM;KACf,UAAU,MAAM;KAChB,aAAa,MAAM;KACnB,gBAAgB,MAAM;KACvB,EAAE;KACH,CACD,OAAO;;EAOZ,uBAAuB,WAAmB;GACxC,MAAM,MAAM,OAAO;AACnB,UAAO,KAAK,UAAU,eAAe,CAClC,UAAU,QACT,IAAI,KAAK,iBAAiB,MACxB,EAAE,WAAW,+BAA+B,OAC1C,GAAG,IACD,GAAG,aAAa,KAAK,UAAU,EAC/B,GAAG,UAAU,KAAK,UAAU,EAC5B,GAAG,GAAG,GAAG,OAAO,cAAc,EAAE,GAAG,eAAe,MAAM,IAAI,CAAC,CAC9D,CACF,CACF,CACF,CACA,mBAAmB,CAAC,YAAY;AAC/B,WAAO,OAAO,KAAK,WAAW;KAC5B,IAAI,MAAM;KACV,UAAU,MAAM;KAChB,SAAS,MAAM;KACf,UAAU,MAAM;KAChB,aAAa,MAAM;KACnB,gBAAgB,MAAM;KACvB,EAAE;KACH,CACD,QAAQ,EAAE,KAAK,qBAAqB;AACnC,QAAI,eAAe,WAAW,EAC5B;AAEF,SAAK,MAAM,SAAS,eAClB,KAAI,OAAO,gBAAgB,MAAM,KAAK,MACpC,EAAE,IAAI;KAAE,QAAQ;KAAc,eAAe;KAAK,CAAC,CAAC,OAAO,CAC5D;KAEH,CACD,WAAW,EAAE,qBACZ,eAAe,KAAK,WAAW;IAC7B,GAAG;IACH,IAAI,IAAI,SAAS;KACf,YAAY,MAAM,GAAG;KACrB,YAAY,MAAM,GAAG;KACrB,SAAS,MAAM,GAAG,UAAU;KAC7B,CAAC;IACH,EAAE,CACJ,CACA,OAAO;;EAMZ,4BAA4B,WAAmB,aAAmB;AAChE,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,aAAa,CAAC,CACzE,CACF,CACF,CACA,mBAAmB,CAAC,YAAY;AAQ/B,WAPc,OAAO,QAAQ,UAAU;AACrC,SAAI,CAAC,MAAM,cACT,QAAO;AAET,YAAO,MAAM,iBAAiB;MAC9B,CAEW,KAAK,WAAW;KAC3B,IAAI,MAAM;KACV,UAAU,MAAM;KAChB,UAAU,MAAM;KAChB,aAAa,MAAM;KACnB,eAAe,MAAM;KACrB,aAAa,MAAM;KACpB,EAAE;KACH,CACD,QAAQ,EAAE,KAAK,qBAAqB;AACnC,SAAK,MAAM,SAAS,eAClB,KAAI,OAAO,gBAAgB,MAAM,KAAK,MACpC,EAAE,IAAI;KAAE,QAAQ;KAAW,aAAa;KAAM,CAAC,CAAC,OAAO,CACxD;KAEH,CACD,WAAW,EAAE,qBAAqB,eAAe,CACjD,OAAO;;EAMZ,yBAAyB,WAAmB,gBAAwB,KAAY;AAC9E,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,aAAa,CAAC,CACzE,CACF,CACF,CACA,mBAAmB,CAAC,YAAY;AAC/B,QAAI,OAAO,WAAW,EACpB,QAAO;IAGT,MAAM,UAAU,uBAAO,IAAI,MAAM;IACjC,MAAM,QAAQ,QAAQ,SAAS;IAC/B,MAAM,YAAY,iBAAiB;IACnC,IAAIA,kBAA+B;AAEnC,SAAK,MAAM,SAAS,QAAQ;AAC1B,SAAI,CAAC,MAAM,cACT,QAAO;KAGT,MAAM,YAAY,MAAM,cAAc,SAAS,GAAG;AAClD,SAAI,aAAa,MACf,QAAO;KAGT,MAAM,UAAU,IAAI,KAAK,UAAU;AACnC,SAAI,CAAC,mBAAmB,UAAU,gBAChC,mBAAkB;;AAItB,WAAO;KACP,CACD,OAAO;;EAOZ,kBAAkB,WAAmB,gBAAiC,KAAY;GAChF,MAAM,UAAU,uBAAO,IAAI,MAAM;GACjC,MAAM,oBAAoB,OAAO,mBAAmB,YAAY,iBAAiB;GACjF,MAAM,YAAY,oBAAoB,iBAAiB,MAAS;AAEhE,UAAO,KAAK,UAAU,eAAe,CAClC,UAAU,QACT,IAAI,KAAK,iBAAiB,MACxB,EACG,WAAW,+BAA+B,OAAO;AAChD,QAAI,kBACF,QAAO,GAAG,IACR,GAAG,aAAa,KAAK,UAAU,EAC/B,GAAG,GAAG,GAAG,UAAU,KAAK,UAAU,EAAE,GAAG,UAAU,KAAK,aAAa,CAAC,CACrE;AAEH,WAAO,GAAG,IAAI,GAAG,aAAa,KAAK,UAAU,EAAE,GAAG,UAAU,KAAK,UAAU,CAAC;KAC5E,CACD,OAAO;IAAC;IAAU;IAAe;IAAgB,CAAC,CACtD,CACF,CACA,mBAAmB,CAAC,YAAY;AAC/B,QAAI,OAAO,WAAW,EACpB,QAAO;IAGT,MAAM,QAAQ,QAAQ,SAAS;IAC/B,IAAIC,oBAAiC;IACrC,IAAID,kBAA+B;AAEnC,SAAK,MAAM,SAAS,QAAQ;AAC1B,SAAI,MAAM,WAAW,WAAW;MAC9B,MAAM,cAAc,MAAM;AAC1B,UAAI,CAAC,eAAe,YAAY,SAAS,IAAI,MAC3C,QAAO;AAET,UAAI,CAAC,qBAAqB,cAAc,kBACtC,qBAAoB;AAEtB;;AAGF,SAAI,CAAC,qBAAqB,MAAM,WAAW,aACzC;KAGF,MAAM,gBAAgB,MAAM;AAC5B,SAAI,CAAC,cACH,QAAO;KAGT,MAAM,YAAY,cAAc,SAAS,GAAG;AAC5C,SAAI,aAAa,MACf,QAAO;KAGT,MAAM,UAAU,IAAI,KAAK,UAAU;AACnC,SAAI,CAAC,mBAAmB,UAAU,gBAChC,mBAAkB;;AAItB,QAAI,CAAC,kBACH,QAAO,mBAAmB;AAE5B,QAAI,CAAC,gBACH,QAAO;AAET,WAAO,qBAAqB,kBAAkB,oBAAoB;KAClE,CACD,OAAO;;EAMZ,kBAAkB,SAAmB;AACnC,UAAO,KAAK,UAAU,eAAe,CAClC,QAAQ,EAAE,UACT,IAAI,OAAO,gBAAgB,UAAU,MACnC,EAAE,IAAI;IAAE,QAAQ;IAAa,eAAe,OAAO;IAAE,CAAC,CAAC,OAAO,CAC/D,CACF,CACA,OAAO;;EAMZ,eACE,SACA,OACA,UACA,aACA,KACA;GACA,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,UAAU,uBAAO,IAAI,MAAM;KACjC,MAAM,cAAc,IAAI,KAAK,QAAQ,SAAS,GAAG,QAAQ;AACzD,SAAI,OAAO,gBAAgB,UAAU,MACnC,EACG,IAAI;MACH,QAAQ;MACR,UAAU;MACV,eAAe,OAAO;MACtB;MACA;MACD,CAAC,CACD,OAAO,CACX;UAED,KAAI,OAAO,gBAAgB,UAAU,MACnC,EACG,IAAI;KACH,QAAQ;KACR,UAAU;KACV,eAAe,OAAO;KACtB;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,eAAe,OAAO;IAAE,CAAC,CAAC,OAAO,CAChE,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,gBAAgB,kBAAkB,EAAE,oBAAoB;AACvD,QAAO,cAAc,EAInB,KAAK,EAAE,mBAAmB,UAA0D,EAAE,EAAE;EACtF,MAAM,aAAa,mBAAmB,aAAa;AAEnD,SAAO,KAAK,UAAU,eAAe,CAClC,UAAU,QACT,IAAI,KAAK,qBAAqB,MAAM;GAClC,IAAI,UAAU,aACV,EAAE,WAAW,4BAA4B,OACvC,GAAG,gBAAgB,KAAK,WAAW,CACpC,GACD,EAAE,WAAW,0BAA0B;AAE3C,aAAU,QAAQ,aAAa,2BAA2B,MAAM;AAChE,OAAI,UAAU,OACZ,WAAU,QAAQ,SAAS,MAAM;AAEnC,UAAO;IACP,CACH,CACA,mBAAmB,CAAC,aACnB,QAAQ,KAAK,WAAW;GACtB,IAAI,MAAM;GACV,cAAc,MAAM;GACpB,OAAO,MAAM;GACb,SAAS,MAAM;GACf,QAAQ,MAAM,UAAU;GACxB,WAAW,MAAM;GAClB,EAAE,CACJ,CACA,OAAO;IAEb,CAAC;EACF,CACD,OAAO;AAUV,eAAsB,6BACpB,UACA,WACiB;AACjB,KAAI;EACF,MAAM,oBAAoB,OAAO,oBAAyD;GACxF,MAAM,UAAU,MAAM,SAAS,UAAU,iBAAkB;AACzD,WAAO,MAAM,KAAK,WAAW,CAC1B,uBAEG,CAAC,SAAS,SAAS,gBAAgB,IAAI,iBAAiB,iBAAiB,CAAC,CAC7E,CACA,WAAW,EAAE,eAAe,CAAC,cAAc,OAAO,CAClD,SAAS;KACZ;AACF,OAAI,CAAC,QACH;GAEF,MAAM,SAAS,SAAS,QAAQ,OAAO,GAAG;AAC1C,UAAO,OAAO,MAAM,OAAO,GAAG,SAAY;;EAG5C,MAAM,UAAU,MAAM,kBAAkB,UAAU;AAClD,MAAI,YAAY,OACd,QAAO;EAKT,MAAM,kBACJ,cAAc,KAAK,eAAe,OAAO,cAAc,eAAe,OAAO,KAAK;AACpF,MAAI,oBAAoB,MAAM;GAC5B,MAAM,SAAS,MAAM,kBAAkB,gBAAgB;AACvD,OAAI,WAAW,OACb,QAAO;;AAIX,SAAO;SACD;AACN,SAAO"}
+{"version":3,"file":"internal-fragment.js","names":["processingNextAt: Date | null"],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":["import { FragmentDefinitionBuilder } from \"@fragno-dev/core\";\nimport type { InstantiatedFragmentFromDefinition } from \"@fragno-dev/core\";\n\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 { isHookStatus, type HookStatus } from \"../hooks/hooks\";\nimport type { Cursor } from \"../query/cursor\";\nimport { dbNow, type DbNow } from \"../query/db-now\";\nimport type { RetryPolicy } from \"../query/unit-of-work/retry-policy\";\nimport { FragnoId } from \"../schema/create\";\nimport {\n  internalSchema,\n  SETTINGS_NAMESPACE,\n  SETTINGS_TABLE_NAME,\n} from \"./internal-fragment.schema\";\n\ntype AdapterRegistry = {\n  listSchemas: () => Array<{\n    name: string;\n    namespace: string | null;\n    version: number;\n    tables: string[];\n  }>;\n  listOutboxFragments: () => Array<{ name: string; mountRoute: string }>;\n  isOutboxEnabled: () => boolean;\n  resolveSyncCommand: (\n    fragmentName: string,\n    schemaName: string,\n    commandName: string,\n  ) => { command: unknown; namespace: string | null } | undefined;\n};\n\nexport class SchemaRegistryCollisionError extends Error {\n  readonly code = \"SCHEMA_REGISTRY_COLLISION\" as const;\n  readonly namespaceKey: string;\n  readonly existing: { name: string; namespace: string | null };\n  readonly attempted: { name: string; namespace: string | null };\n\n  constructor({\n    namespaceKey,\n    existing,\n    attempted,\n  }: {\n    namespaceKey: string;\n    existing: { name: string; namespace: string | null };\n    attempted: { name: string; namespace: string | null };\n  }) {\n    super(\n      `Schema namespace \"${namespaceKey}\" is already owned by \"${existing.name}\" (${existing.namespace ?? \"null\"}).`,\n    );\n    this.name = \"SchemaRegistryCollisionError\";\n    this.namespaceKey = namespaceKey;\n    this.existing = existing;\n    this.attempted = attempted;\n  }\n}\n\nexport type InternalFragmentConfig = {\n  registry?: AdapterRegistry;\n};\n\nexport { internalSchema, SETTINGS_NAMESPACE, SETTINGS_TABLE_NAME };\n\nconst INTERNAL_SCHEMA_MIN_VERSION = 4;\nif (internalSchema.version < INTERNAL_SCHEMA_MIN_VERSION) {\n  // Keep the internal schema version monotonic after removing fragno_db_schemas.\n  internalSchema.version = INTERNAL_SCHEMA_MIN_VERSION;\n}\n\nconst describeHookStatusSource = (event: { id: FragnoId; hookName: string }) =>\n  `fragno_hooks id=${event.id} hook=${event.hookName}`;\n\nconst coerceHookStatus = (status: string, context: string): HookStatus => {\n  if (isHookStatus(status)) {\n    return status;\n  }\n  throw new Error(`Invalid hook status from database (${context}): ${status}`);\n};\n\nconst DEFAULT_HOOKS_PAGE_SIZE = 50;\n\nconst resolveHookPageSize = (pageSize?: number): number => {\n  if (typeof pageSize !== \"number\" || !Number.isInteger(pageSize) || pageSize <= 0) {\n    return DEFAULT_HOOKS_PAGE_SIZE;\n  }\n  return pageSize;\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    InternalFragmentConfig,\n    FragnoPublicConfigWithDatabase,\n    ImplicitDatabaseDependencies<typeof internalSchema>,\n    {},\n    {},\n    {},\n    {},\n    DatabaseServiceContext<{}>,\n    DatabaseHandlerContext,\n    DatabaseRequestStorage\n  >(\"$fragno-internal-fragment\"),\n  internalSchema,\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       * Set a setting value only if it does not already exist.\n       */\n      setIfMissing(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              return;\n            }\n            uow.create(SETTINGS_TABLE_NAME, {\n              key: fullKey,\n              value,\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              status: coerceHookStatus(event.status, describeHookStatusSource(event)),\n              attempts: event.attempts,\n              maxAttempts: event.maxAttempts,\n              lastAttemptAt: event.lastAttemptAt,\n              nextRetryAt: event.nextRetryAt,\n              createdAt: event.createdAt,\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              status: coerceHookStatus(event.status, describeHookStatusSource(event)),\n              attempts: event.attempts,\n              maxAttempts: event.maxAttempts,\n              lastAttemptAt: event.lastAttemptAt,\n              nextRetryAt: event.nextRetryAt,\n              createdAt: event.createdAt,\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              status: \"processing\" as const,\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       * Claim stale processing hook events for processing.\n       * Returns ready events and marks them as processing in the same transaction.\n       */\n      claimStuckProcessingHookEvents(namespace: string, staleBefore: DbNow) {\n        const now = dbNow();\n\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.find(\"fragno_hooks\", (b) =>\n              b.whereIndex(\"idx_namespace_status_last_attempt\", (eb) =>\n                eb.and(\n                  eb(\"namespace\", \"=\", namespace),\n                  eb(\"status\", \"=\", \"processing\"),\n                  eb.or(eb.isNull(\"lastAttemptAt\"), eb(\"lastAttemptAt\", \"<=\", staleBefore)),\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              status: coerceHookStatus(event.status, describeHookStatusSource(event)),\n              attempts: event.attempts,\n              maxAttempts: event.maxAttempts,\n              idempotencyKey: event.nonce,\n              lastAttemptAt: event.lastAttemptAt,\n              nextRetryAt: event.nextRetryAt,\n              createdAt: event.createdAt,\n            }));\n          })\n          .mutate(({ uow, retrieveResult }) => {\n            if (retrieveResult.length === 0) {\n              return;\n            }\n\n            for (const event of retrieveResult) {\n              uow.update(\"fragno_hooks\", event.id, (b) =>\n                b.set({ status: \"processing\", lastAttemptAt: now, nextRetryAt: null }).check(),\n              );\n            }\n          })\n          .transform(({ retrieveResult }) => {\n            return {\n              events: 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              stuckEvents: retrieveResult.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          })\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) {\n        const timeoutMinutesValue =\n          typeof timeoutMinutes === \"number\" && timeoutMinutes > 0 ? timeoutMinutes : 0;\n        const includeProcessing = timeoutMinutesValue > 0;\n        const now = dbNow();\n        const timeoutMs = timeoutMinutesValue * 60_000;\n        // Sentinel to keep query shape stable when processing checks are disabled.\n        const processingStatus = includeProcessing ? \"processing\" : \"__disabled__\";\n        const staleBefore = now.plus({ minutes: -timeoutMinutesValue });\n\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow\n              .forSchema(internalSchema)\n              .find(\"fragno_hooks\", (b) =>\n                b\n                  .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                  .pageSize(1),\n              )\n              .find(\"fragno_hooks\", (b) =>\n                b\n                  .whereIndex(\"idx_namespace_status_retry\", (eb) =>\n                    eb.and(\n                      eb(\"namespace\", \"=\", namespace),\n                      eb(\"status\", \"=\", \"pending\"),\n                      eb.isNotNull(\"nextRetryAt\"),\n                      eb(\"nextRetryAt\", \">\", now),\n                    ),\n                  )\n                  .orderByIndex(\"idx_namespace_status_retry\", \"asc\")\n                  .pageSize(1)\n                  .select([\"nextRetryAt\"]),\n              )\n              .find(\"fragno_hooks\", (b) =>\n                b\n                  .whereIndex(\"idx_namespace_status_last_attempt\", (eb) =>\n                    eb.and(\n                      eb(\"namespace\", \"=\", namespace),\n                      eb(\"status\", \"=\", processingStatus),\n                      eb.or(eb.isNull(\"lastAttemptAt\"), eb(\"lastAttemptAt\", \"<=\", staleBefore)),\n                    ),\n                  )\n                  .pageSize(1),\n              )\n              .find(\"fragno_hooks\", (b) =>\n                b\n                  .whereIndex(\"idx_namespace_status_last_attempt\", (eb) =>\n                    eb.and(\n                      eb(\"namespace\", \"=\", namespace),\n                      eb(\"status\", \"=\", processingStatus),\n                      eb.isNotNull(\"lastAttemptAt\"),\n                      eb(\"lastAttemptAt\", \">\", staleBefore),\n                    ),\n                  )\n                  .orderByIndex(\"idx_namespace_status_last_attempt\", \"asc\")\n                  .pageSize(1)\n                  .select([\"lastAttemptAt\"]),\n              ),\n          )\n          .transformRetrieve(\n            ([pendingImmediate, pendingNext, processingImmediate, processingNext]) => {\n              const hasProcessingImmediate = includeProcessing && processingImmediate.length > 0;\n\n              if (pendingImmediate.length > 0 || hasProcessingImmediate) {\n                return new Date();\n              }\n\n              const pendingNextAt = pendingNext[0]?.nextRetryAt ?? null;\n              let processingNextAt: Date | null = null;\n\n              if (includeProcessing) {\n                const lastAttemptAt = processingNext[0]?.lastAttemptAt;\n                if (lastAttemptAt) {\n                  processingNextAt = new Date(lastAttemptAt.getTime() + timeoutMs);\n                }\n              }\n\n              if (!pendingNextAt) {\n                return processingNextAt ?? null;\n              }\n              if (!processingNextAt) {\n                return pendingNextAt;\n              }\n              return pendingNextAt <= processingNextAt ? pendingNextAt : processingNextAt;\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        const now = dbNow();\n\n        return this.serviceTx(internalSchema)\n          .mutate(({ uow }) => {\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          .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]) =>\n            result\n              ? {\n                  ...result,\n                  status: coerceHookStatus(result.status, describeHookStatusSource(result)),\n                }\n              : undefined,\n          )\n          .build();\n      },\n\n      /**\n       * Get hook events for a namespace in newest-first order with pagination.\n       */\n      getHooksByNamespacePage(\n        namespace: string,\n        options: { cursor?: Cursor | string; pageSize?: number } = {},\n      ) {\n        const pageSize = resolveHookPageSize(options.pageSize);\n\n        return this.serviceTx(internalSchema)\n          .retrieve((uow) =>\n            uow.findWithCursor(\"fragno_hooks\", (b) => {\n              const query = b\n                .whereIndex(\"idx_namespace_created_at\", (eb) => eb(\"namespace\", \"=\", namespace))\n                .orderByIndex(\"idx_namespace_created_at\", \"desc\")\n                .pageSize(pageSize);\n\n              return options.cursor ? query.after(options.cursor) : query;\n            }),\n          )\n          .transformRetrieve(([page]) => ({\n            items: page.items.map((event) => ({\n              ...event,\n              status: coerceHookStatus(event.status, describeHookStatusSource(event)),\n            })),\n            cursor: page.cursor,\n            hasNextPage: page.hasNextPage,\n          }))\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]) =>\n            events.map((event) => ({\n              ...event,\n              status: coerceHookStatus(event.status, describeHookStatusSource(event)),\n            })),\n          )\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

@@ -1,11 +1,81 @@
-import { defineRoutes } from "../packages/fragno/dist/api/route.js";
+import { SETTINGS_NAMESPACE, internalSchema } from "./internal-fragment.schema.js";
 import { internalFragmentDef } from "./internal-fragment.js";
+import { submitSyncRequest } from "../sync/submit.js";
+import { defineRoutes } from "@fragno-dev/core";
 
 //#region src/fragments/internal-fragment.routes.ts
-const internalFragmentRoutes = defineRoutes(internalFragmentDef).create(({ defineRoute, services }) => [defineRoute({
+const ADAPTER_IDENTITY_KEY = "adapter_identity";
+const passthroughInputSchema = { "~standard": {
+	version: 1,
+	vendor: "fragno",
+	validate: async (value) => ({ value })
+} };
+const getOrCreateAdapterIdentity = async (handlerTx, services) => {
+	const readIdentity = async () => handlerTx().withServiceCalls(() => [services.settingsService.get(SETTINGS_NAMESPACE, ADAPTER_IDENTITY_KEY)]).transform(({ serviceResult: [result] }) => result?.value).execute();
+	try {
+		const existingIdentity = await readIdentity();
+		if (existingIdentity) return {
+			ok: true,
+			value: existingIdentity
+		};
+		const adapterIdentity = crypto.randomUUID();
+		try {
+			await handlerTx().withServiceCalls(() => [services.settingsService.setIfMissing(SETTINGS_NAMESPACE, ADAPTER_IDENTITY_KEY, adapterIdentity)]).execute();
+		} catch (error) {
+			const recoveredIdentity = await readIdentity();
+			if (recoveredIdentity) return {
+				ok: true,
+				value: recoveredIdentity
+			};
+			throw error;
+		}
+		return {
+			ok: true,
+			value: await readIdentity() ?? adapterIdentity
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			error: { error: {
+				code: "SETTINGS_UNAVAILABLE",
+				message: "Internal settings table is not available.",
+				detail: error instanceof Error ? error.message : void 0
+			} }
+		};
+	}
+};
+const createInternalFragmentDescribeRoutes = () => defineRoutes(internalFragmentDef).create(({ defineRoute, config, services }) => [defineRoute({
+	method: "GET",
+	path: "/",
+	handler: async function(_input, { json }) {
+		const registry = config.registry;
+		if (!registry) return json({ error: {
+			code: "REGISTRY_UNAVAILABLE",
+			message: "Adapter registry is not configured."
+		} }, { status: 500 });
+		const adapterIdentityResult = await getOrCreateAdapterIdentity(() => this.handlerTx(), services);
+		if (!adapterIdentityResult.ok) return json(adapterIdentityResult.error, { status: 500 });
+		const outboxEnabled = registry.isOutboxEnabled();
+		return json({
+			adapterIdentity: adapterIdentityResult.value,
+			fragments: outboxEnabled ? registry.listOutboxFragments() : [],
+			schemas: registry.listSchemas(),
+			routes: {
+				internal: "/_internal",
+				outbox: outboxEnabled ? "/_internal/outbox" : void 0
+			}
+		});
+	}
+})]);
+const createInternalFragmentOutboxRoutes = () => defineRoutes(internalFragmentDef).create(({ defineRoute, services, config }) => [defineRoute({
 	method: "GET",
 	path: "/outbox",
 	handler: async function(input, { json }) {
+		const registry = config.registry;
+		if (!registry || !registry.isOutboxEnabled()) return json({ error: {
+			code: "OUTBOX_UNAVAILABLE",
+			message: "Outbox is not enabled for this adapter."
+		} }, { status: 404 });
 		const afterVersionstamp = input.query.get("afterVersionstamp") ?? void 0;
 		const limitValue = input.query.get("limit");
 		let limit;
@@ -23,7 +93,72 @@ const internalFragmentRoutes = defineRoutes(internalFragmentDef).create(({ defin
 		})]).transform(({ serviceResult: [result] }) => result).execute());
 	}
 })]);
+const createInternalFragmentSyncRoutes = () => defineRoutes(internalFragmentDef).create(({ defineRoute, services, config }) => [defineRoute({
+	method: "POST",
+	path: "/sync",
+	inputSchema: passthroughInputSchema,
+	handler: async function(input, { json }) {
+		const registry = config.registry;
+		if (!registry || !registry.isOutboxEnabled()) return json({ error: {
+			code: "SYNC_UNAVAILABLE",
+			message: "Sync is not enabled for this adapter."
+		} }, { status: 404 });
+		const adapterIdentityResult = await getOrCreateAdapterIdentity(() => this.handlerTx(), services);
+		if (!adapterIdentityResult.ok) return json(adapterIdentityResult.error, { status: 500 });
+		const result = await submitSyncRequest(await input.input?.valid(), {
+			getAdapterIdentity: async () => adapterIdentityResult.value,
+			listOutboxEntries: async (afterVersionstamp) => await this.handlerTx().withServiceCalls(() => [services.outboxService.list({
+				afterVersionstamp,
+				limit: void 0
+			})]).transform(({ serviceResult: [entries] }) => entries).execute(),
+			countOutboxMutations: async (afterVersionstamp) => {
+				return await this.handlerTx().retrieve(({ forSchema }) => {
+					return afterVersionstamp ? forSchema(internalSchema).find("fragno_db_outbox_mutations", (b) => b.whereIndex("idx_outbox_mutations_entry", (eb) => eb("entryVersionstamp", ">", afterVersionstamp)).selectCount()) : forSchema(internalSchema).find("fragno_db_outbox_mutations", (b) => b.whereIndex("idx_outbox_mutations_entry").selectCount());
+				}).transformRetrieve(([result$1]) => typeof result$1 === "number" ? result$1 : 0).execute();
+			},
+			getSyncRequest: async (requestId) => await this.handlerTx().retrieve(({ forSchema }) => forSchema(internalSchema).findFirst("fragno_db_sync_requests", (b) => b.whereIndex("idx_sync_request_id", (eb) => eb("requestId", "=", requestId)))).transformRetrieve(([result$1]) => {
+				if (!result$1) return;
+				const confirmed = Array.isArray(result$1.confirmedCommandIds) ? result$1.confirmedCommandIds : [];
+				const status = result$1.status === "applied" ? "applied" : "conflict";
+				return {
+					requestId: result$1.requestId,
+					status,
+					confirmedCommandIds: confirmed,
+					conflictCommandId: result$1.conflictCommandId ?? void 0,
+					baseVersionstamp: result$1.baseVersionstamp ?? void 0,
+					lastVersionstamp: result$1.lastVersionstamp ?? void 0
+				};
+			}).execute(),
+			storeSyncRequest: async (record) => {
+				await this.handlerTx().mutate(({ forSchema }) => {
+					forSchema(internalSchema).create("fragno_db_sync_requests", {
+						requestId: record.requestId,
+						status: record.status,
+						confirmedCommandIds: record.confirmedCommandIds,
+						conflictCommandId: record.conflictCommandId ?? null,
+						baseVersionstamp: record.baseVersionstamp ?? null,
+						lastVersionstamp: record.lastVersionstamp ?? null
+					});
+				}).execute();
+			},
+			resolveCommand: (fragment, schema, name) => registry.resolveSyncCommand(fragment, schema, name),
+			createCommandContext: (command) => command.createServerContext?.(this) ?? { mode: "server" },
+			executeCommand: async (command, inputPayload, ctx) => {
+				await command.handler({
+					input: inputPayload,
+					ctx,
+					tx: (options) => this.handlerTx(options)
+				});
+			}
+		});
+		if (result.status === "error") {
+			const statusCode = result.statusCode;
+			return json(result.body, { status: statusCode });
+		}
+		return json(result.response);
+	}
+})]);
 
 //#endregion
-export { internalFragmentRoutes };
+export { createInternalFragmentDescribeRoutes, createInternalFragmentOutboxRoutes, createInternalFragmentSyncRoutes };
 //# sourceMappingURL=internal-fragment.routes.js.map