@fragno-dev/db 0.2.2 → 0.4.1

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

@@ -0,0 +1,15 @@
+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<{
+  fragno_db_settings: Table<Record<"id", IdColumn<"varchar(128)", 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"]>>>;
+  fragno_hooks: Table<Record<"id", IdColumn<"varchar(128)", 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", (Date | DbNow) | null, Date | null>> & Record<"nextRetryAt", Column<"timestamp", (Date | DbNow) | null, Date | null>> & Record<"error", Column<"string", string | null, string | null>> & Record<"createdAt", Column<"timestamp", (Date | DbNow) | null, Date>> & Record<"nonce", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_namespace_created_at", Index<readonly [Column<"string", string, string>, Column<"timestamp", (Date | DbNow) | null, Date>, IdColumn<"varchar(128)", string | FragnoId | null, FragnoId>] & AnyColumn[], readonly ["namespace", "createdAt", "id"]>>>;
+  fragno_db_outbox: Table<Record<"id", IdColumn<"varchar(128)", 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", (Date | DbNow) | 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"]>>>;
+  fragno_db_outbox_mutations: Table<Record<"id", IdColumn<"varchar(128)", string | FragnoId | null, FragnoId>> & Record<"entryVersionstamp", Column<"string", string, string>> & Record<"mutationVersionstamp", Column<"string", string, string>> & Record<"uowId", Column<"string", string, string>> & Record<"schema", Column<"string", string, string>> & Record<"table", Column<"string", string, string>> & Record<"externalId", Column<"string", string, string>> & Record<"op", Column<"string", string, string>> & Record<"createdAt", Column<"timestamp", (Date | DbNow) | null, Date>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_outbox_mutations_entry", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["entryVersionstamp"]>> & Record<"idx_outbox_mutations_key", Index<readonly [Column<"string", string, string>, Column<"string", string, string>, Column<"string", string, string>, Column<"string", string, string>] & AnyColumn[], readonly ["schema", "table", "externalId", "entryVersionstamp"]>> & Record<"idx_outbox_mutations_uow", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["uowId"]>>>;
+  fragno_db_sync_requests: Table<Record<"id", IdColumn<"varchar(128)", string | FragnoId | null, FragnoId>> & Record<"requestId", Column<"string", string, string>> & Record<"status", Column<"string", string, string>> & Record<"confirmedCommandIds", Column<"json", unknown, unknown>> & Record<"conflictCommandId", Column<"string", string | null, string | null>> & Record<"baseVersionstamp", Column<"string", string | null, string | null>> & Record<"lastVersionstamp", Column<"string", string | null, string | null>> & Record<"createdAt", Column<"timestamp", (Date | DbNow) | null, Date>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_sync_request_id", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["requestId"]>>>;
+}>;
+//#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;2EAuFX,QAAA;;EAvFW,gBAAA,OAuFX,OAAA,CAAA,IAAA,UAAA,CAAA,cAAA,EAAA,MAAA,cAAA,IAAA,WAAA,CAAA,SAAA,CAAA,cAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,SAAA,CAAA,OAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,SAAA,CAAA,SAAA,QAAA,CAAA,MAAA,EAAA,OAAA,EAAA,OAAA,CAAA,CAAA,SAAA,CAAA,QAAA,QAAA,CAAA,MAAA,EAAA,OAAA,EAAA,OAAA,CAAA,CAAA,SAAA,CAAA,WAAA,QAAA,CAAA,WAAA,EAAA,KAAA,QAAA,CAAA,GAAA,IAAA,MAAA,CAAA,CAAA,QAAA,CAAA,MAAA,cAAA,QAAA,CAAA,MAAA,OAAA,YAAA,EAAA,SAAA,MAAA,EAAA,CAAA,CAAA,SAAA,CAAA,yBAAA,OAAA,CAAA,SAAA,OAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,cAAA,EAAA,SAAA,CAAA,cAAA,CAAA,CAAA,CAAA,SAAA,CAAA,gBAAA,OAAA,CAAA,SAAA,OAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,cAAA,EAAA,SAAA,CAAA,OAAA,CAAA,CAAA,CAAA,CAAA;EAAA,0BAAA,OAAA,OAAA,CAAA,IAAA,UAAA,CAAA,cAAA,EAAA,MAAA,cAAA,IAAA,WAAA,CAAA,SAAA,CAAA,mBAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,SAAA,CAAA,sBAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,SAAA,CAAA,OAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,SAAA,CAAA,QAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,SAAA,CAAA,OAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,SAAA,CAAA,YAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,SAAA,CAAA,IAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,SAAA,CAAA,WAAA,QAAA,CAAA,WAAA,EAAA,KAAA,QAAA,CAAA,GAAA,IAAA,MAAA,CAAA,CAAA,QAAA,CAAA,MAAA,cAAA,QAAA,CAAA,MAAA,OAAA,YAAA,EAAA,SAAA,MAAA,EAAA,CAAA,CAAA,SAAA,CAAA,4BAAA,OAAA,CAAA,SAAA,OAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,cAAA,EAAA,SAAA,CAAA,mBAAA,CAAA,CAAA,CAAA,SAAA,CAAA,0BAAA,OAAA,CAAA,SAAA,OAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,QAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,cAAA,EAAA,SAAA,CAAA,QAAA,EAAA,OAAA,EAAA,YAAA,EAAA,mBAAA,CAAA,CAAA,CAAA,SAAA,CAAA,0BAAA,OAAA,CAAA,SAAA,OAAA,CAAA,QAAA,EAAA,MAAA,EAAA,MAAA,CAAA,CAAA,cAAA,EAAA,SAAA,CAAA,OAAA,CAAA,CAAA,CAAA,CAAA"}

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

@@ -0,0 +1,39 @@
+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"]);
+	}).addTable("fragno_db_outbox_mutations", (t) => {
+		return t.addColumn("id", idColumn()).addColumn("entryVersionstamp", column("string")).addColumn("mutationVersionstamp", column("string")).addColumn("uowId", column("string")).addColumn("schema", column("string")).addColumn("table", column("string")).addColumn("externalId", column("string")).addColumn("op", column("string")).addColumn("createdAt", column("timestamp").defaultTo((b) => b.now())).createIndex("idx_outbox_mutations_entry", ["entryVersionstamp"]).createIndex("idx_outbox_mutations_key", [
+			"schema",
+			"table",
+			"externalId",
+			"entryVersionstamp"
+		]).createIndex("idx_outbox_mutations_uow", ["uowId"]);
+	}).addTable("fragno_db_sync_requests", (t) => {
+		return t.addColumn("id", idColumn()).addColumn("requestId", column("string")).addColumn("status", column("string")).addColumn("confirmedCommandIds", column("json")).addColumn("conflictCommandId", column("string").nullable()).addColumn("baseVersionstamp", column("string").nullable()).addColumn("lastVersionstamp", column("string").nullable()).addColumn("createdAt", column("timestamp").defaultTo((b) => b.now())).createIndex("idx_sync_request_id", ["requestId"], { unique: true });
+	}).alterTable("fragno_hooks", (t) => t.createIndex("idx_namespace_status_last_attempt", [
+		"namespace",
+		"status",
+		"lastAttemptAt"
+	])).alterTable("fragno_hooks", (t) => t.createIndex("idx_namespace_created_at", [
+		"namespace",
+		"createdAt",
+		"id"
+	]));
+});
+
+//#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    .addTable(\"fragno_db_outbox_mutations\", (t) => {\n      return t\n        .addColumn(\"id\", idColumn())\n        .addColumn(\"entryVersionstamp\", column(\"string\"))\n        .addColumn(\"mutationVersionstamp\", column(\"string\"))\n        .addColumn(\"uowId\", column(\"string\"))\n        .addColumn(\"schema\", column(\"string\"))\n        .addColumn(\"table\", column(\"string\"))\n        .addColumn(\"externalId\", column(\"string\"))\n        .addColumn(\"op\", column(\"string\"))\n        .addColumn(\n          \"createdAt\",\n          column(\"timestamp\").defaultTo((b) => b.now()),\n        )\n        .createIndex(\"idx_outbox_mutations_entry\", [\"entryVersionstamp\"])\n        .createIndex(\"idx_outbox_mutations_key\", [\n          \"schema\",\n          \"table\",\n          \"externalId\",\n          \"entryVersionstamp\",\n        ])\n        .createIndex(\"idx_outbox_mutations_uow\", [\"uowId\"]);\n    })\n    .addTable(\"fragno_db_sync_requests\", (t) => {\n      return t\n        .addColumn(\"id\", idColumn())\n        .addColumn(\"requestId\", column(\"string\"))\n        .addColumn(\"status\", column(\"string\"))\n        .addColumn(\"confirmedCommandIds\", column(\"json\"))\n        .addColumn(\"conflictCommandId\", column(\"string\").nullable())\n        .addColumn(\"baseVersionstamp\", column(\"string\").nullable())\n        .addColumn(\"lastVersionstamp\", column(\"string\").nullable())\n        .addColumn(\n          \"createdAt\",\n          column(\"timestamp\").defaultTo((b) => b.now()),\n        )\n        .createIndex(\"idx_sync_request_id\", [\"requestId\"], { unique: true });\n    })\n    .alterTable(\"fragno_hooks\", (t) =>\n      t.createIndex(\"idx_namespace_status_last_attempt\", [\"namespace\", \"status\", \"lastAttemptAt\"]),\n    )\n    .alterTable(\"fragno_hooks\", (t) =>\n      t.createIndex(\"idx_namespace_created_at\", [\"namespace\", \"createdAt\", \"id\"]),\n    );\n});\n"],"mappings":"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"}

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

@@ -0,0 +1,10 @@
+//#region src/hooks/durable-hooks-logger.d.ts
+
+type DurableHooksLogLevel = "off" | "error" | "warn" | "info" | "debug";
+type DurableHooksLoggerConfig = {
+  enabled?: boolean;
+  level?: DurableHooksLogLevel;
+};
+//#endregion
+export { DurableHooksLoggerConfig };
+//# sourceMappingURL=durable-hooks-logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"durable-hooks-logger.d.ts","names":[],"sources":["../../src/hooks/durable-hooks-logger.ts"],"sourcesContent":[],"mappings":";;AAmBY,KAFA,oBAAA,GAEwB,KAAA,GAAA,OAE1B,GAAA,MAAA,GAAA,MAAoB,GAAA,OAAA;KAFlB,wBAAA;;UAEF"}

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

@@ -0,0 +1,75 @@
+//#region src/hooks/durable-hooks-logger.ts
+const LOG_LEVEL_PRIORITY = {
+	off: 0,
+	error: 1,
+	warn: 2,
+	info: 3,
+	debug: 4
+};
+const DEFAULT_SCOPE = {
+	enabled: true,
+	level: "warn"
+};
+var DurableHooksLogger = class DurableHooksLogger {
+	static #defaultScope = { ...DEFAULT_SCOPE };
+	static #namespaceScopes = /* @__PURE__ */ new Map();
+	static configure(config, namespace) {
+		if (!config) return;
+		const target = namespace ? DurableHooksLogger.#namespaceScopes.get(namespace) ?? { ...DurableHooksLogger.#defaultScope } : { ...DurableHooksLogger.#defaultScope };
+		if (config.enabled !== void 0) target.enabled = config.enabled;
+		if (config.level !== void 0) target.level = config.level;
+		if (namespace) {
+			DurableHooksLogger.#namespaceScopes.set(namespace, target);
+			return;
+		}
+		DurableHooksLogger.#defaultScope = target;
+	}
+	static enable(namespace) {
+		DurableHooksLogger.configure({ enabled: true }, namespace);
+	}
+	static disable(namespace) {
+		DurableHooksLogger.configure({ enabled: false }, namespace);
+	}
+	static setLogLevel(level, namespace) {
+		DurableHooksLogger.configure({ level }, namespace);
+	}
+	static debug(message, options) {
+		DurableHooksLogger.#log("debug", message, options);
+	}
+	static info(message, options) {
+		DurableHooksLogger.#log("info", message, options);
+	}
+	static warn(message, options) {
+		DurableHooksLogger.#log("warn", message, options);
+	}
+	static error(message, options) {
+		DurableHooksLogger.#log("error", message, options);
+	}
+	static toErrorMessage(error) {
+		return error instanceof Error ? error.message : String(error);
+	}
+	static #log(level, message, options) {
+		const scope = DurableHooksLogger.#resolveScope(options?.namespace);
+		if (!scope.enabled) return;
+		if (LOG_LEVEL_PRIORITY[level] > LOG_LEVEL_PRIORITY[scope.level]) return;
+		const fields = DurableHooksLogger.#resolveFields(options?.fields);
+		const payload = {
+			at: (/* @__PURE__ */ new Date()).toISOString(),
+			...options?.namespace ? { namespace: options.namespace } : {},
+			...fields
+		};
+		console[level](`[fragno-db] ${message}`, payload);
+	}
+	static #resolveScope(namespace) {
+		if (!namespace) return DurableHooksLogger.#defaultScope;
+		return DurableHooksLogger.#namespaceScopes.get(namespace) ?? DurableHooksLogger.#defaultScope;
+	}
+	static #resolveFields(fields) {
+		if (!fields) return {};
+		return typeof fields === "function" ? fields() : fields;
+	}
+};
+
+//#endregion
+export { DurableHooksLogger };
+//# sourceMappingURL=durable-hooks-logger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"durable-hooks-logger.js","names":["LOG_LEVEL_PRIORITY: Record<DurableHooksLogLevel, number>","DEFAULT_SCOPE: Required<DurableHooksLoggerConfig>","#defaultScope","#namespaceScopes","#log","#resolveScope","#resolveFields"],"sources":["../../src/hooks/durable-hooks-logger.ts"],"sourcesContent":["type LogFields = Record<string, unknown>;\ntype LogFieldsInput = LogFields | (() => LogFields);\n\ntype LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\";\nconst LOG_LEVEL_PRIORITY: Record<DurableHooksLogLevel, number> = {\n  off: 0,\n  error: 1,\n  warn: 2,\n  info: 3,\n  debug: 4,\n};\n\nconst DEFAULT_SCOPE: Required<DurableHooksLoggerConfig> = {\n  enabled: true,\n  level: \"warn\",\n};\n\nexport type DurableHooksLogLevel = \"off\" | \"error\" | \"warn\" | \"info\" | \"debug\";\n\nexport type DurableHooksLoggerConfig = {\n  enabled?: boolean;\n  level?: DurableHooksLogLevel;\n};\n\ntype LoggerScope = Required<DurableHooksLoggerConfig>;\n\ntype LogOptions = {\n  namespace?: string;\n  fields?: LogFieldsInput;\n};\n\nexport class DurableHooksLogger {\n  static #defaultScope: LoggerScope = { ...DEFAULT_SCOPE };\n  static #namespaceScopes = new Map<string, LoggerScope>();\n\n  static configure(config?: DurableHooksLoggerConfig, namespace?: string): void {\n    if (!config) {\n      return;\n    }\n\n    const target = namespace\n      ? (DurableHooksLogger.#namespaceScopes.get(namespace) ?? {\n          ...DurableHooksLogger.#defaultScope,\n        })\n      : { ...DurableHooksLogger.#defaultScope };\n\n    if (config.enabled !== undefined) {\n      target.enabled = config.enabled;\n    }\n    if (config.level !== undefined) {\n      target.level = config.level;\n    }\n\n    if (namespace) {\n      DurableHooksLogger.#namespaceScopes.set(namespace, target);\n      return;\n    }\n\n    DurableHooksLogger.#defaultScope = target;\n  }\n\n  static enable(namespace?: string): void {\n    DurableHooksLogger.configure({ enabled: true }, namespace);\n  }\n\n  static disable(namespace?: string): void {\n    DurableHooksLogger.configure({ enabled: false }, namespace);\n  }\n\n  static setLogLevel(level: DurableHooksLogLevel, namespace?: string): void {\n    DurableHooksLogger.configure({ level }, namespace);\n  }\n\n  static debug(message: string, options?: LogOptions): void {\n    DurableHooksLogger.#log(\"debug\", message, options);\n  }\n\n  static info(message: string, options?: LogOptions): void {\n    DurableHooksLogger.#log(\"info\", message, options);\n  }\n\n  static warn(message: string, options?: LogOptions): void {\n    DurableHooksLogger.#log(\"warn\", message, options);\n  }\n\n  static error(message: string, options?: LogOptions): void {\n    DurableHooksLogger.#log(\"error\", message, options);\n  }\n\n  static toErrorMessage(error: unknown): string {\n    return error instanceof Error ? error.message : String(error);\n  }\n\n  static #log(level: LogLevel, message: string, options?: LogOptions): void {\n    const scope = DurableHooksLogger.#resolveScope(options?.namespace);\n    if (!scope.enabled) {\n      return;\n    }\n    if (LOG_LEVEL_PRIORITY[level] > LOG_LEVEL_PRIORITY[scope.level]) {\n      return;\n    }\n\n    const fields = DurableHooksLogger.#resolveFields(options?.fields);\n    const payload = {\n      at: new Date().toISOString(),\n      ...(options?.namespace ? { namespace: options.namespace } : {}),\n      ...fields,\n    };\n\n    console[level](`[fragno-db] ${message}`, payload);\n  }\n\n  static #resolveScope(namespace?: string): LoggerScope {\n    if (!namespace) {\n      return DurableHooksLogger.#defaultScope;\n    }\n    return DurableHooksLogger.#namespaceScopes.get(namespace) ?? DurableHooksLogger.#defaultScope;\n  }\n\n  static #resolveFields(fields?: LogFieldsInput): LogFields {\n    if (!fields) {\n      return {};\n    }\n    return typeof fields === \"function\" ? fields() : fields;\n  }\n}\n"],"mappings":";AAIA,MAAMA,qBAA2D;CAC/D,KAAK;CACL,OAAO;CACP,MAAM;CACN,MAAM;CACN,OAAO;CACR;AAED,MAAMC,gBAAoD;CACxD,SAAS;CACT,OAAO;CACR;AAgBD,IAAa,qBAAb,MAAa,mBAAmB;CAC9B,QAAOC,eAA6B,EAAE,GAAG,eAAe;CACxD,QAAOC,kCAAmB,IAAI,KAA0B;CAExD,OAAO,UAAU,QAAmC,WAA0B;AAC5E,MAAI,CAAC,OACH;EAGF,MAAM,SAAS,YACV,oBAAmBA,gBAAiB,IAAI,UAAU,IAAI,EACrD,GAAG,oBAAmBD,cACvB,GACD,EAAE,GAAG,oBAAmBA,cAAe;AAE3C,MAAI,OAAO,YAAY,OACrB,QAAO,UAAU,OAAO;AAE1B,MAAI,OAAO,UAAU,OACnB,QAAO,QAAQ,OAAO;AAGxB,MAAI,WAAW;AACb,uBAAmBC,gBAAiB,IAAI,WAAW,OAAO;AAC1D;;AAGF,sBAAmBD,eAAgB;;CAGrC,OAAO,OAAO,WAA0B;AACtC,qBAAmB,UAAU,EAAE,SAAS,MAAM,EAAE,UAAU;;CAG5D,OAAO,QAAQ,WAA0B;AACvC,qBAAmB,UAAU,EAAE,SAAS,OAAO,EAAE,UAAU;;CAG7D,OAAO,YAAY,OAA6B,WAA0B;AACxE,qBAAmB,UAAU,EAAE,OAAO,EAAE,UAAU;;CAGpD,OAAO,MAAM,SAAiB,SAA4B;AACxD,sBAAmBE,IAAK,SAAS,SAAS,QAAQ;;CAGpD,OAAO,KAAK,SAAiB,SAA4B;AACvD,sBAAmBA,IAAK,QAAQ,SAAS,QAAQ;;CAGnD,OAAO,KAAK,SAAiB,SAA4B;AACvD,sBAAmBA,IAAK,QAAQ,SAAS,QAAQ;;CAGnD,OAAO,MAAM,SAAiB,SAA4B;AACxD,sBAAmBA,IAAK,SAAS,SAAS,QAAQ;;CAGpD,OAAO,eAAe,OAAwB;AAC5C,SAAO,iBAAiB,QAAQ,MAAM,UAAU,OAAO,MAAM;;CAG/D,QAAOA,IAAK,OAAiB,SAAiB,SAA4B;EACxE,MAAM,QAAQ,oBAAmBC,aAAc,SAAS,UAAU;AAClE,MAAI,CAAC,MAAM,QACT;AAEF,MAAI,mBAAmB,SAAS,mBAAmB,MAAM,OACvD;EAGF,MAAM,SAAS,oBAAmBC,cAAe,SAAS,OAAO;EACjE,MAAM,UAAU;GACd,qBAAI,IAAI,MAAM,EAAC,aAAa;GAC5B,GAAI,SAAS,YAAY,EAAE,WAAW,QAAQ,WAAW,GAAG,EAAE;GAC9D,GAAG;GACJ;AAED,UAAQ,OAAO,eAAe,WAAW,QAAQ;;CAGnD,QAAOD,aAAc,WAAiC;AACpD,MAAI,CAAC,UACH,QAAO,oBAAmBH;AAE5B,SAAO,oBAAmBC,gBAAiB,IAAI,UAAU,IAAI,oBAAmBD;;CAGlF,QAAOI,cAAe,QAAoC;AACxD,MAAI,CAAC,OACH,QAAO,EAAE;AAEX,SAAO,OAAO,WAAW,aAAa,QAAQ,GAAG"}

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

@@ -0,0 +1 @@
+import "../mod.js";

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

@@ -0,0 +1,80 @@
+import { getDurableHooksRuntimeByToken } from "./durable-hooks-runtime.js";
+import { createDurableHooksRunner } 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 hasDurableHooksConfigured(fragment) {
+	const internal = fragment.$internal;
+	return Boolean(internal?.durableHooksToken);
+}
+function createDurableHooksProcessor(fragment) {
+	const durableHooksToken = fragment.$internal.durableHooksToken;
+	if (!durableHooksToken) throw new Error(`[fragno-db] Durable hooks not configured for fragment "${fragment.name}".`);
+	const runtime = getDurableHooksRuntimeByToken(durableHooksToken);
+	if (!runtime) throw new Error(`[fragno-db] Durable hooks runtime missing for fragment "${fragment.name}".`);
+	runtime.dispatcherRegistered = true;
+	const durableHooks = runtime.config;
+	const { namespace, internalFragment } = durableHooks;
+	const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(durableHooks.stuckProcessingTimeoutMinutes);
+	const runner = durableHooks.runner ?? (durableHooks.runner = durableHooks.scheduler ? {
+		processDue: () => durableHooks.scheduler.schedule(),
+		drain: () => durableHooks.scheduler.drain()
+	} : createDurableHooksRunner(durableHooks));
+	return {
+		namespace,
+		processDue: async () => runner.processDue(),
+		process: async () => runner.processDue(),
+		drain: async () => runner.drain(),
+		getNextWakeAt: async () => {
+			return await internalFragment.inContext(async function() {
+				return await this.handlerTx().withServiceCalls(() => [internalFragment.services.hookService.getNextHookWakeAt(namespace, stuckProcessingTimeoutMinutes)]).transform(({ serviceResult: [result] }) => result).execute();
+			});
+		}
+	};
+}
+function createDurableHooksProcessorGroup(fragments, options = {}) {
+	const configuredFragments = fragments.filter(hasDurableHooksConfigured);
+	if (configuredFragments.length === 0) throw new Error("[fragno-db] No fragments provided for durable hooks processing.");
+	return createDurableHooksProcessorGroupFromProcessors(configuredFragments.map((fragment) => createDurableHooksProcessor(fragment)), options);
+}
+function createDurableHooksProcessorGroupFromProcessors(processors, options = {}) {
+	if (processors.length === 0) throw new Error("[fragno-db] No processors provided for durable hooks processing.");
+	if (processors.length === 1) return processors[0];
+	const onError = options.onError ?? (() => {});
+	const namespace = processors.map((processor) => processor.namespace).join(",");
+	const processDue = async () => {
+		const results = await Promise.allSettled(processors.map(async (processor) => await processor.processDue()));
+		let processed = 0;
+		for (const result of results) if (result.status === "fulfilled") processed += result.value;
+		else onError(result.reason);
+		return processed;
+	};
+	return {
+		namespace,
+		processDue,
+		process: processDue,
+		drain: async () => {
+			const results = await Promise.allSettled(processors.map(async (processor) => await processor.drain()));
+			for (const result of results) if (result.status === "rejected") onError(result.reason);
+		},
+		getNextWakeAt: async () => {
+			const results = await Promise.allSettled(processors.map(async (processor) => await processor.getNextWakeAt()));
+			let nextWakeAt = null;
+			for (const result of results) if (result.status === "fulfilled") {
+				const wakeAt = result.value;
+				if (!wakeAt) continue;
+				if (!nextWakeAt || wakeAt.getTime() < nextWakeAt.getTime()) nextWakeAt = wakeAt;
+			} else onError(result.reason);
+			return nextWakeAt;
+		}
+	};
+}
+
+//#endregion
+export { createDurableHooksProcessorGroup };
+//# 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":["nextWakeAt: Date | null"],"sources":["../../src/hooks/durable-hooks-processor.ts"],"sourcesContent":["import type { AnyFragnoInstantiatedDatabaseFragment } from \"../mod\";\nimport type { AnySchema } from \"../schema/create\";\nimport { getDurableHooksRuntimeByToken } from \"./durable-hooks-runtime\";\nimport { createDurableHooksRunner } from \"./hooks\";\n\nexport type DurableHooksProcessor = {\n  processDue: () => Promise<number>;\n  /**\n   * @deprecated Use processDue().\n   */\n  process: () => Promise<number>;\n  getNextWakeAt: () => Promise<Date | null>;\n  drain: () => Promise<void>;\n  namespace: string;\n};\n\nexport type DurableHooksProcessorGroupOptions = {\n  onError?: (error: unknown) => void;\n};\n\ntype DurableHooksInternal = {\n  durableHooksToken?: object;\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\nfunction hasDurableHooksConfigured(\n  fragment: AnyFragnoInstantiatedDatabaseFragment,\n): fragment is AnyFragnoInstantiatedDatabaseFragment {\n  const internal = fragment.$internal as DurableHooksInternal | undefined;\n  return Boolean(internal?.durableHooksToken);\n}\n\nexport function createDurableHooksProcessor<TSchema extends AnySchema>(\n  fragment: AnyFragnoInstantiatedDatabaseFragment<TSchema>,\n): DurableHooksProcessor {\n  const durableHooksToken = (fragment.$internal as DurableHooksInternal).durableHooksToken;\n  if (!durableHooksToken) {\n    throw new Error(`[fragno-db] Durable hooks not configured for fragment \"${fragment.name}\".`);\n  }\n  const runtime = getDurableHooksRuntimeByToken(durableHooksToken);\n  if (!runtime) {\n    throw new Error(`[fragno-db] Durable hooks runtime missing for fragment \"${fragment.name}\".`);\n  }\n  runtime.dispatcherRegistered = true;\n\n  const durableHooks = runtime.config;\n\n  const { namespace, internalFragment } = durableHooks;\n  const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(\n    durableHooks.stuckProcessingTimeoutMinutes,\n  );\n  const runner =\n    durableHooks.runner ??\n    (durableHooks.runner = durableHooks.scheduler\n      ? {\n          processDue: () => durableHooks.scheduler!.schedule(),\n          drain: () => durableHooks.scheduler!.drain(),\n        }\n      : createDurableHooksRunner(durableHooks));\n\n  return {\n    namespace,\n    processDue: async () => runner.processDue(),\n    process: async () => runner.processDue(),\n    drain: async () => runner.drain(),\n    getNextWakeAt: async () => {\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                ),\n              ] as const,\n          )\n          .transform(({ serviceResult: [result] }) => result)\n          .execute();\n      });\n    },\n  };\n}\n\nexport function createDurableHooksProcessorGroup(\n  fragments: readonly AnyFragnoInstantiatedDatabaseFragment[],\n  options: DurableHooksProcessorGroupOptions = {},\n): DurableHooksProcessor {\n  const configuredFragments = fragments.filter(hasDurableHooksConfigured);\n  if (configuredFragments.length === 0) {\n    throw new Error(\"[fragno-db] No fragments provided for durable hooks processing.\");\n  }\n  const processors = configuredFragments.map((fragment) => createDurableHooksProcessor(fragment));\n\n  return createDurableHooksProcessorGroupFromProcessors(processors, options);\n}\n\nexport function createDurableHooksProcessorGroupFromProcessors(\n  processors: readonly DurableHooksProcessor[],\n  options: DurableHooksProcessorGroupOptions = {},\n): DurableHooksProcessor {\n  if (processors.length === 0) {\n    throw new Error(\"[fragno-db] No processors provided for durable hooks processing.\");\n  }\n  if (processors.length === 1) {\n    return processors[0];\n  }\n\n  const onError = options.onError ?? (() => {});\n  const namespace = processors.map((processor) => processor.namespace).join(\",\");\n\n  const processDue = async () => {\n    const results = await Promise.allSettled(\n      processors.map(async (processor) => await processor.processDue()),\n    );\n    let processed = 0;\n    for (const result of results) {\n      if (result.status === \"fulfilled\") {\n        processed += result.value;\n      } else {\n        onError(result.reason);\n      }\n    }\n    return processed;\n  };\n\n  return {\n    namespace,\n    processDue,\n    process: processDue,\n    drain: async () => {\n      const results = await Promise.allSettled(\n        processors.map(async (processor) => await processor.drain()),\n      );\n      for (const result of results) {\n        if (result.status === \"rejected\") {\n          onError(result.reason);\n        }\n      }\n    },\n    getNextWakeAt: async () => {\n      const results = await Promise.allSettled(\n        processors.map(async (processor) => await processor.getNextWakeAt()),\n      );\n      let nextWakeAt: Date | null = null;\n      for (const result of results) {\n        if (result.status === \"fulfilled\") {\n          const wakeAt = result.value;\n          if (!wakeAt) {\n            continue;\n          }\n          if (!nextWakeAt || wakeAt.getTime() < nextWakeAt.getTime()) {\n            nextWakeAt = wakeAt;\n          }\n        } else {\n          onError(result.reason);\n        }\n      }\n      return nextWakeAt;\n    },\n  };\n}\n"],"mappings":";;;;AAwBA,MAAM,2CAA2C;AAEjD,SAAS,qCAAqC,OAAmD;AAC/F,KAAI,UAAU,MACZ,QAAO;AAET,KAAI,OAAO,UAAU,SACnB,QAAO,QAAQ,IAAI,QAAQ;AAE7B,QAAO;;AAGT,SAAS,0BACP,UACmD;CACnD,MAAM,WAAW,SAAS;AAC1B,QAAO,QAAQ,UAAU,kBAAkB;;AAG7C,SAAgB,4BACd,UACuB;CACvB,MAAM,oBAAqB,SAAS,UAAmC;AACvE,KAAI,CAAC,kBACH,OAAM,IAAI,MAAM,0DAA0D,SAAS,KAAK,IAAI;CAE9F,MAAM,UAAU,8BAA8B,kBAAkB;AAChE,KAAI,CAAC,QACH,OAAM,IAAI,MAAM,2DAA2D,SAAS,KAAK,IAAI;AAE/F,SAAQ,uBAAuB;CAE/B,MAAM,eAAe,QAAQ;CAE7B,MAAM,EAAE,WAAW,qBAAqB;CACxC,MAAM,gCAAgC,qCACpC,aAAa,8BACd;CACD,MAAM,SACJ,aAAa,WACZ,aAAa,SAAS,aAAa,YAChC;EACE,kBAAkB,aAAa,UAAW,UAAU;EACpD,aAAa,aAAa,UAAW,OAAO;EAC7C,GACD,yBAAyB,aAAa;AAE5C,QAAO;EACL;EACA,YAAY,YAAY,OAAO,YAAY;EAC3C,SAAS,YAAY,OAAO,YAAY;EACxC,OAAO,YAAY,OAAO,OAAO;EACjC,eAAe,YAAY;AACzB,UAAO,MAAM,iBAAiB,UAAU,iBAAkB;AACxD,WAAO,MAAM,KAAK,WAAW,CAC1B,uBAEG,CACE,iBAAiB,SAAS,YAAY,kBACpC,WACA,8BACD,CACF,CACJ,CACA,WAAW,EAAE,eAAe,CAAC,cAAc,OAAO,CAClD,SAAS;KACZ;;EAEL;;AAGH,SAAgB,iCACd,WACA,UAA6C,EAAE,EACxB;CACvB,MAAM,sBAAsB,UAAU,OAAO,0BAA0B;AACvE,KAAI,oBAAoB,WAAW,EACjC,OAAM,IAAI,MAAM,kEAAkE;AAIpF,QAAO,+CAFY,oBAAoB,KAAK,aAAa,4BAA4B,SAAS,CAAC,EAE7B,QAAQ;;AAG5E,SAAgB,+CACd,YACA,UAA6C,EAAE,EACxB;AACvB,KAAI,WAAW,WAAW,EACxB,OAAM,IAAI,MAAM,mEAAmE;AAErF,KAAI,WAAW,WAAW,EACxB,QAAO,WAAW;CAGpB,MAAM,UAAU,QAAQ,kBAAkB;CAC1C,MAAM,YAAY,WAAW,KAAK,cAAc,UAAU,UAAU,CAAC,KAAK,IAAI;CAE9E,MAAM,aAAa,YAAY;EAC7B,MAAM,UAAU,MAAM,QAAQ,WAC5B,WAAW,IAAI,OAAO,cAAc,MAAM,UAAU,YAAY,CAAC,CAClE;EACD,IAAI,YAAY;AAChB,OAAK,MAAM,UAAU,QACnB,KAAI,OAAO,WAAW,YACpB,cAAa,OAAO;MAEpB,SAAQ,OAAO,OAAO;AAG1B,SAAO;;AAGT,QAAO;EACL;EACA;EACA,SAAS;EACT,OAAO,YAAY;GACjB,MAAM,UAAU,MAAM,QAAQ,WAC5B,WAAW,IAAI,OAAO,cAAc,MAAM,UAAU,OAAO,CAAC,CAC7D;AACD,QAAK,MAAM,UAAU,QACnB,KAAI,OAAO,WAAW,WACpB,SAAQ,OAAO,OAAO;;EAI5B,eAAe,YAAY;GACzB,MAAM,UAAU,MAAM,QAAQ,WAC5B,WAAW,IAAI,OAAO,cAAc,MAAM,UAAU,eAAe,CAAC,CACrE;GACD,IAAIA,aAA0B;AAC9B,QAAK,MAAM,UAAU,QACnB,KAAI,OAAO,WAAW,aAAa;IACjC,MAAM,SAAS,OAAO;AACtB,QAAI,CAAC,OACH;AAEF,QAAI,CAAC,cAAc,OAAO,SAAS,GAAG,WAAW,SAAS,CACxD,cAAa;SAGf,SAAQ,OAAO,OAAO;AAG1B,UAAO;;EAEV"}

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

@@ -0,0 +1,44 @@
+import { DurableHooksLogger } from "./durable-hooks-logger.js";
+
+//#region src/hooks/durable-hooks-runtime.ts
+const runtimeByToken = /* @__PURE__ */ new WeakMap();
+const runtimeByConfig = /* @__PURE__ */ new WeakMap();
+const runtimesByInternalFragment = /* @__PURE__ */ new WeakMap();
+function getNamespaceRuntimeMap(internalFragment, createIfMissing = false) {
+	const existing = runtimesByInternalFragment.get(internalFragment);
+	if (existing || !createIfMissing) return existing;
+	const created = /* @__PURE__ */ new Map();
+	runtimesByInternalFragment.set(internalFragment, created);
+	return created;
+}
+function registerDurableHooksRuntime(config) {
+	const existing = runtimeByConfig.get(config);
+	if (existing) return existing.token;
+	const token = {};
+	const runtime = {
+		token,
+		config,
+		dispatcherRegistered: false,
+		dispatcherWarningEmitted: false
+	};
+	runtimeByToken.set(token, runtime);
+	runtimeByConfig.set(config, runtime);
+	const runtimeByNamespace = getNamespaceRuntimeMap(config.internalFragment, true);
+	const existingForNamespace = runtimeByNamespace?.get(config.namespace);
+	if (existingForNamespace && existingForNamespace.config !== config) DurableHooksLogger.warn("Durable hooks runtime already registered for namespace", { namespace: config.namespace });
+	runtimeByNamespace?.set(config.namespace, runtime);
+	return token;
+}
+function getDurableHooksRuntimeByToken(token) {
+	return runtimeByToken.get(token);
+}
+function getDurableHooksRuntimeByConfig(config) {
+	return runtimeByConfig.get(config);
+}
+function getDurableHooksRuntimeByNamespace(namespace, internalFragment) {
+	return getNamespaceRuntimeMap(internalFragment)?.get(namespace);
+}
+
+//#endregion
+export { getDurableHooksRuntimeByConfig, getDurableHooksRuntimeByNamespace, getDurableHooksRuntimeByToken, registerDurableHooksRuntime };
+//# sourceMappingURL=durable-hooks-runtime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"durable-hooks-runtime.js","names":["runtime: DurableHooksRuntimeState"],"sources":["../../src/hooks/durable-hooks-runtime.ts"],"sourcesContent":["import { DurableHooksLogger } from \"./durable-hooks-logger\";\nimport type { HookProcessorConfig } from \"./hooks\";\n\ntype DurableHooksRuntimeState = {\n  token: object;\n  config: HookProcessorConfig;\n  dispatcherRegistered: boolean;\n  dispatcherWarningEmitted: boolean;\n};\n\nconst runtimeByToken = new WeakMap<object, DurableHooksRuntimeState>();\nconst runtimeByConfig = new WeakMap<HookProcessorConfig, DurableHooksRuntimeState>();\nconst runtimesByInternalFragment = new WeakMap<\n  HookProcessorConfig[\"internalFragment\"],\n  Map<string, DurableHooksRuntimeState>\n>();\n\nfunction getNamespaceRuntimeMap(\n  internalFragment: HookProcessorConfig[\"internalFragment\"],\n  createIfMissing = false,\n) {\n  const existing = runtimesByInternalFragment.get(internalFragment);\n  if (existing || !createIfMissing) {\n    return existing;\n  }\n  const created = new Map<string, DurableHooksRuntimeState>();\n  runtimesByInternalFragment.set(internalFragment, created);\n  return created;\n}\n\nexport function registerDurableHooksRuntime(config: HookProcessorConfig): object {\n  const existing = runtimeByConfig.get(config);\n  if (existing) {\n    return existing.token;\n  }\n\n  const token = {};\n  const runtime: DurableHooksRuntimeState = {\n    token,\n    config,\n    dispatcherRegistered: false,\n    dispatcherWarningEmitted: false,\n  };\n\n  runtimeByToken.set(token, runtime);\n  runtimeByConfig.set(config, runtime);\n  const runtimeByNamespace = getNamespaceRuntimeMap(config.internalFragment, true);\n  const existingForNamespace = runtimeByNamespace?.get(config.namespace);\n  if (existingForNamespace && existingForNamespace.config !== config) {\n    DurableHooksLogger.warn(\"Durable hooks runtime already registered for namespace\", {\n      namespace: config.namespace,\n    });\n  }\n  runtimeByNamespace?.set(config.namespace, runtime);\n\n  return token;\n}\n\nexport function getDurableHooksRuntimeByToken(token: object): DurableHooksRuntimeState | undefined {\n  return runtimeByToken.get(token);\n}\n\nexport function getDurableHooksRuntimeByConfig(\n  config: HookProcessorConfig,\n): DurableHooksRuntimeState | undefined {\n  return runtimeByConfig.get(config);\n}\n\nexport function getDurableHooksRuntimeByNamespace(\n  namespace: string,\n  internalFragment: HookProcessorConfig[\"internalFragment\"],\n): DurableHooksRuntimeState | undefined {\n  return getNamespaceRuntimeMap(internalFragment)?.get(namespace);\n}\n\nexport function getDurableHooksNotifierByNamespace(\n  namespace: string,\n  internalFragment: HookProcessorConfig[\"internalFragment\"],\n) {\n  return getNamespaceRuntimeMap(internalFragment)?.get(namespace)?.config.notifier;\n}\n"],"mappings":";;;AAUA,MAAM,iCAAiB,IAAI,SAA2C;AACtE,MAAM,kCAAkB,IAAI,SAAwD;AACpF,MAAM,6CAA6B,IAAI,SAGpC;AAEH,SAAS,uBACP,kBACA,kBAAkB,OAClB;CACA,MAAM,WAAW,2BAA2B,IAAI,iBAAiB;AACjE,KAAI,YAAY,CAAC,gBACf,QAAO;CAET,MAAM,0BAAU,IAAI,KAAuC;AAC3D,4BAA2B,IAAI,kBAAkB,QAAQ;AACzD,QAAO;;AAGT,SAAgB,4BAA4B,QAAqC;CAC/E,MAAM,WAAW,gBAAgB,IAAI,OAAO;AAC5C,KAAI,SACF,QAAO,SAAS;CAGlB,MAAM,QAAQ,EAAE;CAChB,MAAMA,UAAoC;EACxC;EACA;EACA,sBAAsB;EACtB,0BAA0B;EAC3B;AAED,gBAAe,IAAI,OAAO,QAAQ;AAClC,iBAAgB,IAAI,QAAQ,QAAQ;CACpC,MAAM,qBAAqB,uBAAuB,OAAO,kBAAkB,KAAK;CAChF,MAAM,uBAAuB,oBAAoB,IAAI,OAAO,UAAU;AACtE,KAAI,wBAAwB,qBAAqB,WAAW,OAC1D,oBAAmB,KAAK,0DAA0D,EAChF,WAAW,OAAO,WACnB,CAAC;AAEJ,qBAAoB,IAAI,OAAO,WAAW,QAAQ;AAElD,QAAO;;AAGT,SAAgB,8BAA8B,OAAqD;AACjG,QAAO,eAAe,IAAI,MAAM;;AAGlC,SAAgB,+BACd,QACsC;AACtC,QAAO,gBAAgB,IAAI,OAAO;;AAGpC,SAAgB,kCACd,WACA,kBACsC;AACtC,QAAO,uBAAuB,iBAAiB,EAAE,IAAI,UAAU"}

package/dist/hooks/hooks.d.ts

@@ -1,5 +1,9 @@
+import { DbNow } from "../query/db-now.js";
+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 { DurableHooksLoggerConfig } from "./durable-hooks-logger.js";
 import "../query/unit-of-work/unit-of-work.js";
 
 //#region src/hooks/hooks.d.ts
@@ -14,7 +18,45 @@ interface HookContext {
    * Use this for idempotency checks in your hook implementation.
    */
   idempotencyKey: string;
+  /**
+   * Hook event identifier (versioned FragnoId).
+   */
+  hookId: FragnoId;
+  /**
+   * Hook name for this event.
+   */
+  hookName: string;
+  /**
+   * Current status of the hook event.
+   */
+  status: HookStatus;
+  /**
+   * Attempt count for this hook event.
+   */
+  attempts: number;
+  /**
+   * Maximum attempts configured for this hook event.
+   */
+  maxAttempts: number;
+  /**
+   * Timestamp of the last attempt (if any).
+   */
+  lastAttemptAt: Date | null;
+  /**
+   * Next scheduled retry timestamp (if any).
+   */
+  nextRetryAt: Date | null;
+  /**
+   * When the hook event was created.
+   */
+  createdAt: Date;
+  /**
+   * Create a handler transaction builder to run atomic operations.
+   */
+  handlerTx: HookHandlerTx;
 }
+declare const hookStatusValues: readonly ["pending", "processing", "completed", "failed"];
+type HookStatus = (typeof hookStatusValues)[number];
 /**
  * A hook function signature.
  * Hooks receive a typed payload and access context via `this`.
@@ -38,16 +80,73 @@ interface TriggerHookOptions {
    * If not provided, uses the default retry policy.
    */
   retryPolicy?: RetryPolicy;
+  /**
+   * Optional hook event ID. When provided, the hook insert will fail if a hook
+   * with the same ID already exists.
+   */
+  id?: string | FragnoId;
+  /**
+   * 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 | DbNow;
 }
 /**
  * Internal representation of a triggered hook.
  * Stored in the Unit of Work before execution.
  */
 interface TriggeredHook {
+  namespace: string;
   hookName: string;
   payload: unknown;
   options?: TriggerHookOptions;
 }
+type HookNotifySource = "request" | "hook" | "alarm";
+type HookNotifyContext = {
+  source: HookNotifySource;
+  route?: string | null;
+  waitUntil?: (promise: Promise<unknown>) => void;
+};
+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;
+  /**
+   * Automatically schedule hook processing after successful mutations.
+   * Defaults to true. Set false to disable auto scheduling (manual drain only).
+   */
+  autoSchedule?: boolean;
+  /**
+   * Called when stuck processing hooks are detected and re-queued.
+   * Invoked after the hooks are moved back to `pending`.
+   */
+  onStuckProcessingHooks?: (info: StuckHookProcessingInfo) => void;
+  /**
+   * Durable hooks logging controls.
+   * Defaults: enabled=true, level="warn".
+   */
+  logging?: DurableHooksLoggerConfig;
+};
+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, HookHandlerTx, HookNotifyContext, HookPayload, HookStatus, 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":";;;;;;;;;;;;AAgBA;;AAiBU,UAjBO,WAAA,CAiBP;EAYO;;;;EAYS,cAAA,EAAA,MAAA;EAGb;AAEb;AAgBA;EAOY,MAAA,EA5DF,QA4DU;EAKR;;;EAA6C,QAAA,EAAA,MAAA;EAAC;AAK1D;;EAUgB,MAAA,EAxEN,UAwEM;EAKF;;;EAOG,QAAA,EAAA,MAAa;EAOlB;AAEZ;AAgEA;EAEY,WAAA,EAAA,MAAA;EACN;;;EAKa,aAAA,EAzJF,IAyJE,GAAA,IAAA;EAGP;AAMZ;;EAkBkC,WAAA,EAhLnB,IAgLmB,GAAA,IAAA;EAKtB;;AAGZ;EACqB,SAAA,EArLR,IAqLQ;EAAL;;;EACK,SAAA,EAlLR,aAkLQ;;cA/KR;KAED,UAAA,WAAqB;;;;;KAgBrB,uCAAuC,oBAAoB;;;;;KAO3D,QAAA,GAAW,eAAe;;;;KAK1B,iBAAiB,UAAU,kBAAkB;;;;UAKxC,kBAAA;;;;;gBAKD;;;;;gBAKA;;;;;cAKF,OAAO;;;;;;UAOJ,aAAA;;;;YAIL;;KAGA,gBAAA;KAEA,iBAAA;UACF;;wBAEc;;KA6DZ,iCAAA;KAEA,wBAAA;MACN;;;;iBAIW;eACF;;KAGH,uBAAA;;;UAGF;;KAGE,6BAAA;;;;;;;;kCAQsB;;;;;;;;;;kCAUA;;;;;YAKtB;;KAGA,aAAA,kBACI,KAAK,0CAChB,oFAAoF"}