@fragno-dev/db 0.3.0 → 0.4.1

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

@@ -1 +1 @@
-{"version":3,"file":"internal-fragment.routes.js","names":["limit: number | undefined"],"sources":["../../src/fragments/internal-fragment.routes.ts"],"sourcesContent":["import { defineRoutes } from \"@fragno-dev/core\";\nimport { internalFragmentDef } from \"./internal-fragment\";\n\nexport const internalFragmentRoutes = defineRoutes(internalFragmentDef).create(\n  ({ defineRoute, services }) => [\n    defineRoute({\n      method: \"GET\",\n      path: \"/outbox\",\n      handler: async function (input, { json }) {\n        // We intentionally skip input/output schemas here to keep the internal route lightweight.\n        // Query params are validated manually and the response shape is stable (OutboxEntry[]),\n        // while the public API surface is still gated behind adapter config.\n        const afterVersionstamp = input.query.get(\"afterVersionstamp\") ?? undefined;\n        const limitValue = input.query.get(\"limit\");\n        let limit: number | undefined;\n\n        if (limitValue !== null) {\n          const parsed = Number.parseInt(limitValue, 10);\n          if (!Number.isFinite(parsed) || parsed < 1) {\n            return json(\n              {\n                error: \"Invalid limit query parameter.\",\n                code: \"INVALID_LIMIT\",\n              },\n              { status: 400 },\n            );\n          }\n          limit = parsed;\n        }\n\n        const entries = await this.handlerTx()\n          .withServiceCalls(\n            () => [services.outboxService.list({ afterVersionstamp, limit })] as const,\n          )\n          .transform(({ serviceResult: [result] }) => result)\n          .execute();\n\n        return json(entries);\n      },\n    }),\n  ],\n);\n"],"mappings":";;;;AAGA,MAAa,yBAAyB,aAAa,oBAAoB,CAAC,QACrE,EAAE,aAAa,eAAe,CAC7B,YAAY;CACV,QAAQ;CACR,MAAM;CACN,SAAS,eAAgB,OAAO,EAAE,QAAQ;EAIxC,MAAM,oBAAoB,MAAM,MAAM,IAAI,oBAAoB,IAAI;EAClE,MAAM,aAAa,MAAM,MAAM,IAAI,QAAQ;EAC3C,IAAIA;AAEJ,MAAI,eAAe,MAAM;GACvB,MAAM,SAAS,OAAO,SAAS,YAAY,GAAG;AAC9C,OAAI,CAAC,OAAO,SAAS,OAAO,IAAI,SAAS,EACvC,QAAO,KACL;IACE,OAAO;IACP,MAAM;IACP,EACD,EAAE,QAAQ,KAAK,CAChB;AAEH,WAAQ;;AAUV,SAAO,KAPS,MAAM,KAAK,WAAW,CACnC,uBACO,CAAC,SAAS,cAAc,KAAK;GAAE;GAAmB;GAAO,CAAC,CAAC,CAClE,CACA,WAAW,EAAE,eAAe,CAAC,cAAc,OAAO,CAClD,SAAS,CAEQ;;CAEvB,CAAC,CACH,CACF"}
+{"version":3,"file":"internal-fragment.routes.js","names":["passthroughInputSchema: StandardSchemaV1","limit: number | undefined","result"],"sources":["../../src/fragments/internal-fragment.routes.ts"],"sourcesContent":["import { defineRoutes } from \"@fragno-dev/core\";\n\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nimport type { DatabaseHandlerContext } from \"../db-fragment-definition-builder\";\nimport type { OutboxEntry } from \"../outbox/outbox\";\nimport { submitSyncRequest, type SyncRequestRecord } from \"../sync/submit\";\nimport type { SubmitRequest, SyncCommandDefinition } from \"../sync/types\";\nimport {\n  SETTINGS_NAMESPACE,\n  internalFragmentDef,\n  internalSchema,\n  type InternalFragmentInstance,\n} from \"./internal-fragment\";\n\ntype InternalDescribeResponse = {\n  adapterIdentity: string;\n  fragments: Array<{ name: string; mountRoute: string }>;\n  schemas: Array<{\n    name: string;\n    namespace: string | null;\n    version: number;\n    tables: string[];\n  }>;\n  routes: {\n    internal: \"/_internal\";\n    outbox?: \"/_internal/outbox\";\n  };\n};\n\ntype InternalDescribeError = {\n  error: {\n    code: string;\n    message: string;\n    detail?: string;\n  };\n};\n\nconst ADAPTER_IDENTITY_KEY = \"adapter_identity\" as const;\n\nconst passthroughInputSchema: StandardSchemaV1 = {\n  \"~standard\": {\n    version: 1,\n    vendor: \"fragno\",\n    validate: async (value: unknown) => ({ value }),\n  },\n};\n\ntype AdapterIdentityResult =\n  | { ok: true; value: string }\n  | { ok: false; error: InternalDescribeError };\n\nconst getOrCreateAdapterIdentity = async (\n  handlerTx: () => ReturnType<DatabaseHandlerContext[\"handlerTx\"]>,\n  services: Pick<InternalFragmentInstance[\"services\"], \"settingsService\">,\n): Promise<AdapterIdentityResult> => {\n  const readIdentity = async () =>\n    handlerTx()\n      .withServiceCalls(\n        () => [services.settingsService.get(SETTINGS_NAMESPACE, ADAPTER_IDENTITY_KEY)] as const,\n      )\n      .transform(({ serviceResult: [result] }) => result?.value as string | undefined)\n      .execute();\n\n  try {\n    const existingIdentity = await readIdentity();\n    if (existingIdentity) {\n      return { ok: true, value: existingIdentity };\n    }\n\n    const adapterIdentity = crypto.randomUUID();\n    try {\n      await handlerTx()\n        .withServiceCalls(\n          () =>\n            [\n              services.settingsService.setIfMissing(\n                SETTINGS_NAMESPACE,\n                ADAPTER_IDENTITY_KEY,\n                adapterIdentity,\n              ),\n            ] as const,\n        )\n        .execute();\n    } catch (error) {\n      const recoveredIdentity = await readIdentity();\n      if (recoveredIdentity) {\n        return { ok: true, value: recoveredIdentity };\n      }\n      throw error;\n    }\n\n    const persistedIdentity = await readIdentity();\n    return { ok: true, value: persistedIdentity ?? adapterIdentity };\n  } catch (error) {\n    return {\n      ok: false,\n      error: {\n        error: {\n          code: \"SETTINGS_UNAVAILABLE\",\n          message: \"Internal settings table is not available.\",\n          detail: error instanceof Error ? error.message : undefined,\n        },\n      },\n    };\n  }\n};\n\nexport const createInternalFragmentDescribeRoutes = () =>\n  defineRoutes(internalFragmentDef).create(({ defineRoute, config, services }) => [\n    defineRoute({\n      method: \"GET\",\n      path: \"/\",\n      handler: async function (_input, { json }) {\n        const registry = config.registry;\n        if (!registry) {\n          return json(\n            {\n              error: {\n                code: \"REGISTRY_UNAVAILABLE\",\n                message: \"Adapter registry is not configured.\",\n              },\n            } satisfies InternalDescribeError,\n            { status: 500 },\n          );\n        }\n\n        const adapterIdentityResult = await getOrCreateAdapterIdentity(\n          () => this.handlerTx(),\n          services,\n        );\n        if (!adapterIdentityResult.ok) {\n          return json(adapterIdentityResult.error, { status: 500 });\n        }\n\n        const outboxEnabled = registry.isOutboxEnabled();\n        const response: InternalDescribeResponse = {\n          adapterIdentity: adapterIdentityResult.value,\n          fragments: outboxEnabled ? registry.listOutboxFragments() : [],\n          schemas: registry.listSchemas(),\n          routes: {\n            internal: \"/_internal\",\n            outbox: outboxEnabled ? \"/_internal/outbox\" : undefined,\n          },\n        };\n\n        return json(response);\n      },\n    }),\n  ]);\n\nexport const createInternalFragmentOutboxRoutes = () =>\n  defineRoutes(internalFragmentDef).create(({ defineRoute, services, config }) => [\n    defineRoute({\n      method: \"GET\",\n      path: \"/outbox\",\n      handler: async function (input, { json }) {\n        const registry = config.registry;\n        if (!registry || !registry.isOutboxEnabled()) {\n          return json(\n            {\n              error: {\n                code: \"OUTBOX_UNAVAILABLE\",\n                message: \"Outbox is not enabled for this adapter.\",\n              },\n            },\n            { status: 404 },\n          );\n        }\n\n        // We intentionally skip input/output schemas here to keep the internal route lightweight.\n        // Query params are validated manually and the response shape is stable (OutboxEntry[]),\n        // while the public API surface is still gated behind adapter config.\n        const afterVersionstamp = input.query.get(\"afterVersionstamp\") ?? undefined;\n        const limitValue = input.query.get(\"limit\");\n        let limit: number | undefined;\n\n        if (limitValue !== null) {\n          const parsed = Number.parseInt(limitValue, 10);\n          if (!Number.isFinite(parsed) || parsed < 1) {\n            return json(\n              {\n                error: \"Invalid limit query parameter.\",\n                code: \"INVALID_LIMIT\",\n              },\n              { status: 400 },\n            );\n          }\n          limit = parsed;\n        }\n\n        const entries = await this.handlerTx()\n          .withServiceCalls(\n            () => [services.outboxService.list({ afterVersionstamp, limit })] as const,\n          )\n          .transform(({ serviceResult: [result] }) => result)\n          .execute();\n\n        return json(entries);\n      },\n    }),\n  ]);\n\ntype InternalSyncError = {\n  error: {\n    code: string;\n    message: string;\n    detail?: string;\n  };\n};\n\nexport const createInternalFragmentSyncRoutes = () =>\n  defineRoutes(internalFragmentDef).create(({ defineRoute, services, config }) => [\n    defineRoute({\n      method: \"POST\",\n      path: \"/sync\",\n      inputSchema: passthroughInputSchema,\n      handler: async function (input, { json }) {\n        const registry = config.registry;\n        if (!registry || !registry.isOutboxEnabled()) {\n          return json(\n            {\n              error: {\n                code: \"SYNC_UNAVAILABLE\",\n                message: \"Sync is not enabled for this adapter.\",\n              },\n            } satisfies InternalSyncError,\n            { status: 404 },\n          );\n        }\n\n        const adapterIdentityResult = await getOrCreateAdapterIdentity(\n          () => this.handlerTx(),\n          services,\n        );\n        if (!adapterIdentityResult.ok) {\n          return json(adapterIdentityResult.error, { status: 500 });\n        }\n\n        const body = (await input.input?.valid()) as SubmitRequest | undefined;\n\n        const result = await submitSyncRequest(body, {\n          getAdapterIdentity: async () => adapterIdentityResult.value,\n          listOutboxEntries: async (afterVersionstamp) =>\n            await this.handlerTx()\n              .withServiceCalls(\n                () =>\n                  [services.outboxService.list({ afterVersionstamp, limit: undefined })] as const,\n              )\n              .transform(({ serviceResult: [entries] }) => entries as OutboxEntry[])\n              .execute(),\n          countOutboxMutations: async (afterVersionstamp) => {\n            const count = await this.handlerTx()\n              .retrieve(({ forSchema }) => {\n                const builder = afterVersionstamp\n                  ? forSchema(internalSchema).find(\"fragno_db_outbox_mutations\", (b) =>\n                      b\n                        .whereIndex(\"idx_outbox_mutations_entry\", (eb) =>\n                          eb(\"entryVersionstamp\", \">\", afterVersionstamp),\n                        )\n                        .selectCount(),\n                    )\n                  : forSchema(internalSchema).find(\"fragno_db_outbox_mutations\", (b) =>\n                      b.whereIndex(\"idx_outbox_mutations_entry\").selectCount(),\n                    );\n                return builder;\n              })\n              .transformRetrieve(([result]) => (typeof result === \"number\" ? result : 0))\n              .execute();\n            return count;\n          },\n          getSyncRequest: async (requestId) =>\n            await this.handlerTx()\n              .retrieve(({ forSchema }) =>\n                forSchema(internalSchema).findFirst(\"fragno_db_sync_requests\", (b) =>\n                  b.whereIndex(\"idx_sync_request_id\", (eb) => eb(\"requestId\", \"=\", requestId)),\n                ),\n              )\n              .transformRetrieve(([result]) => {\n                if (!result) {\n                  return undefined;\n                }\n                const confirmed = Array.isArray(result.confirmedCommandIds)\n                  ? (result.confirmedCommandIds as string[])\n                  : [];\n                const status = result.status === \"applied\" ? \"applied\" : \"conflict\";\n                return {\n                  requestId: result.requestId,\n                  status,\n                  confirmedCommandIds: confirmed,\n                  conflictCommandId: result.conflictCommandId ?? undefined,\n                  baseVersionstamp: result.baseVersionstamp ?? undefined,\n                  lastVersionstamp: result.lastVersionstamp ?? undefined,\n                } satisfies SyncRequestRecord;\n              })\n              .execute(),\n          storeSyncRequest: async (record) => {\n            await this.handlerTx()\n              .mutate(({ forSchema }) => {\n                forSchema(internalSchema).create(\"fragno_db_sync_requests\", {\n                  requestId: record.requestId,\n                  status: record.status,\n                  confirmedCommandIds: record.confirmedCommandIds,\n                  conflictCommandId: record.conflictCommandId ?? null,\n                  baseVersionstamp: record.baseVersionstamp ?? null,\n                  lastVersionstamp: record.lastVersionstamp ?? null,\n                });\n              })\n              .execute();\n          },\n          resolveCommand: (fragment, schema, name) =>\n            registry.resolveSyncCommand(fragment, schema, name) as\n              | { command: SyncCommandDefinition; namespace: string | null }\n              | undefined,\n          createCommandContext: (command) =>\n            command.createServerContext?.(this) ?? { mode: \"server\" },\n          executeCommand: async (command, inputPayload, ctx) => {\n            await command.handler({\n              input: inputPayload,\n              ctx,\n              tx: (options) => this.handlerTx(options),\n            });\n          },\n        });\n\n        if (result.status === \"error\") {\n          const statusCode = result.statusCode as 400 | 409 | 500;\n          return json(result.body, { status: statusCode });\n        }\n\n        return json(result.response);\n      },\n    }),\n  ]);\n"],"mappings":"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"}

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

@@ -3,7 +3,13 @@ import { AnyColumn, AnyRelation, Column, FragnoId, IdColumn, Index, Schema, Tabl
 import "../mod.js";
 
 //#region src/fragments/internal-fragment.schema.d.ts
-declare const internalSchema: Schema<Record<"fragno_db_settings", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"key", Column<"string", string, string>> & Record<"value", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"unique_key", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["key"]>>>> & Record<"fragno_hooks", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"namespace", Column<"string", string, string>> & Record<"hookName", Column<"string", string, string>> & Record<"payload", Column<"json", unknown, unknown>> & Record<"status", Column<"string", string, string>> & Record<"attempts", Column<"integer", number | null, number>> & Record<"maxAttempts", Column<"integer", number | null, number>> & Record<"lastAttemptAt", Column<"timestamp", (DbNow | Date) | null, Date | null>> & Record<"nextRetryAt", Column<"timestamp", (DbNow | Date) | null, Date | null>> & Record<"error", Column<"string", string | null, string | null>> & Record<"createdAt", Column<"timestamp", (DbNow | Date) | null, Date>> & Record<"nonce", Column<"string", string, string>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_namespace_status_retry", Index<readonly [Column<"string", string, string>, Column<"string", string, string>, Column<"timestamp", (DbNow | Date) | null, Date | null>] & AnyColumn[], readonly ["namespace", "status", "nextRetryAt"]>> & Record<"idx_nonce", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["nonce"]>>>> & Record<"fragno_db_outbox", Table<Record<string, AnyColumn> & Record<"id", IdColumn<"varchar(30)", string | FragnoId | null, FragnoId>> & Record<"versionstamp", Column<"string", string, string>> & Record<"uowId", Column<"string", string, string>> & Record<"payload", Column<"json", unknown, unknown>> & Record<"refMap", Column<"json", unknown, unknown>> & Record<"createdAt", Column<"timestamp", (DbNow | Date) | null, Date>>, Record<string, AnyRelation>, Record<string, Index<AnyColumn[], readonly string[]>> & Record<"idx_outbox_versionstamp", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["versionstamp"]>> & Record<"idx_outbox_uow", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["uowId"]>>>>>;
+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

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

@@ -14,7 +14,24 @@ const internalSchema = schema("fragno_internal", (s) => {
 		]).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

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

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

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

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

@@ -1,4 +1,5 @@
-import { createHookScheduler } from "./hooks.js";
+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;
@@ -7,26 +8,73 @@ function resolveStuckProcessingTimeoutMinutes(value) {
 	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 durableHooks = fragment.$internal.durableHooks;
-	if (!durableHooks) return null;
+	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 scheduler = durableHooks.scheduler ?? (durableHooks.scheduler = createHookScheduler(durableHooks));
+	const runner = durableHooks.runner ?? (durableHooks.runner = durableHooks.scheduler ? {
+		processDue: () => durableHooks.scheduler.schedule(),
+		drain: () => durableHooks.scheduler.drain()
+	} : createDurableHooksRunner(durableHooks));
 	return {
 		namespace,
-		process: async () => scheduler.schedule(),
-		drain: async () => scheduler.drain(),
+		processDue: async () => runner.processDue(),
+		process: async () => runner.processDue(),
+		drain: async () => runner.drain(),
 		getNextWakeAt: async () => {
-			const services = internalFragment.services;
-			const now = services.getDbNow ? await services.getDbNow() : /* @__PURE__ */ new Date();
 			return await internalFragment.inContext(async function() {
-				return await this.handlerTx().withServiceCalls(() => [internalFragment.services.hookService.getNextHookWakeAt(namespace, stuckProcessingTimeoutMinutes, now)]).transform(({ serviceResult: [result] }) => result).execute();
+				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 { createDurableHooksProcessor };
+export { createDurableHooksProcessorGroup };
 //# sourceMappingURL=durable-hooks-processor.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"durable-hooks-processor.js","names":[],"sources":["../../src/hooks/durable-hooks-processor.ts"],"sourcesContent":["import type { AnySchema } from \"../schema/create\";\nimport type { AnyFragnoInstantiatedDatabaseFragment } from \"../mod\";\nimport { createHookScheduler, type HookProcessorConfig } from \"./hooks\";\n\nexport type DurableHooksProcessor = {\n  process: () => Promise<number>;\n  getNextWakeAt: () => Promise<Date | null>;\n  drain: () => Promise<void>;\n  namespace: string;\n};\n\ntype DurableHooksInternal = {\n  durableHooks?: HookProcessorConfig;\n};\n\nconst DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES = 10;\n\nfunction resolveStuckProcessingTimeoutMinutes(value: number | false | undefined): number | false {\n  if (value === false) {\n    return false;\n  }\n  if (typeof value === \"number\") {\n    return value > 0 ? value : false;\n  }\n  return DEFAULT_STUCK_PROCESSING_TIMEOUT_MINUTES;\n}\n\nexport function createDurableHooksProcessor<TSchema extends AnySchema>(\n  fragment: AnyFragnoInstantiatedDatabaseFragment<TSchema>,\n): DurableHooksProcessor | null {\n  const durableHooks = (fragment.$internal as DurableHooksInternal).durableHooks;\n  if (!durableHooks) {\n    return null;\n  }\n\n  const { namespace, internalFragment } = durableHooks;\n  const stuckProcessingTimeoutMinutes = resolveStuckProcessingTimeoutMinutes(\n    durableHooks.stuckProcessingTimeoutMinutes,\n  );\n  const scheduler =\n    durableHooks.scheduler ?? (durableHooks.scheduler = createHookScheduler(durableHooks));\n\n  return {\n    namespace,\n    process: async () => scheduler.schedule(),\n    drain: async () => scheduler.drain(),\n    getNextWakeAt: async () => {\n      const services = internalFragment.services as { getDbNow?: () => Promise<Date> };\n      const now = services.getDbNow ? await services.getDbNow() : new Date();\n      return await internalFragment.inContext(async function () {\n        return await this.handlerTx()\n          .withServiceCalls(\n            () =>\n              [\n                internalFragment.services.hookService.getNextHookWakeAt(\n                  namespace,\n                  stuckProcessingTimeoutMinutes,\n                  now,\n                ),\n              ] as const,\n          )\n          .transform(({ serviceResult: [result] }) => result)\n          .execute();\n      });\n    },\n  };\n}\n"],"mappings":";;;AAeA,MAAM,2CAA2C;AAEjD,SAAS,qCAAqC,OAAmD;AAC/F,KAAI,UAAU,MACZ,QAAO;AAET,KAAI,OAAO,UAAU,SACnB,QAAO,QAAQ,IAAI,QAAQ;AAE7B,QAAO;;AAGT,SAAgB,4BACd,UAC8B;CAC9B,MAAM,eAAgB,SAAS,UAAmC;AAClE,KAAI,CAAC,aACH,QAAO;CAGT,MAAM,EAAE,WAAW,qBAAqB;CACxC,MAAM,gCAAgC,qCACpC,aAAa,8BACd;CACD,MAAM,YACJ,aAAa,cAAc,aAAa,YAAY,oBAAoB,aAAa;AAEvF,QAAO;EACL;EACA,SAAS,YAAY,UAAU,UAAU;EACzC,OAAO,YAAY,UAAU,OAAO;EACpC,eAAe,YAAY;GACzB,MAAM,WAAW,iBAAiB;GAClC,MAAM,MAAM,SAAS,WAAW,MAAM,SAAS,UAAU,mBAAG,IAAI,MAAM;AACtE,UAAO,MAAM,iBAAiB,UAAU,iBAAkB;AACxD,WAAO,MAAM,KAAK,WAAW,CAC1B,uBAEG,CACE,iBAAiB,SAAS,YAAY,kBACpC,WACA,+BACA,IACD,CACF,CACJ,CACA,WAAW,EAAE,eAAe,CAAC,cAAc,OAAO,CAClD,SAAS;KACZ;;EAEL"}
+{"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,7 +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
@@ -16,11 +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`.
@@ -44,21 +80,33 @@ 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;
+  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;
@@ -82,13 +130,23 @@ type DurableHooksProcessingOptions = {
    * 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 { DurableHooksProcessingOptions, HookContext, HookFn, HookPayload, HooksMap, StuckHookProcessingEvent, StuckHookProcessingInfo, StuckHookProcessingTimeoutMinutes, 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":";;;;;;;;;;AAeA;AAgBA;AAOY,UAvBK,WAAA,CAuBqB;EAK1B;;;;EAA8C,cAAA,EAAA,MAAA;EAKzC;AAiBjB;AAuCA;EAEY,SAAA,EAlFC,aAkFD;;;;;AASZ;AAMY,KA1FA,MA0FA,CAAA,WAAA,OAA6B,CAAA,GAAA,CAAA,OAQP,EAlGiB,QAkGjB,EAAA,GAAA,IAAA,GAlGqC,OAkGrC,CAAA,IAAA,CAKA;AAGlC;;;;AAEK,KArGO,QAAA,GAAW,MAqGlB,CAAA,MAAA,EArGiC,MAqGjC,CAAA,GAAA,CAAA,CAAA;;;;KAhGO,iBAAiB,UAAU,kBAAkB;;;;UAKxC,kBAAA;;;;;gBAKD;;;;;cAKF;;;;;;UAOG,aAAA;;;YAGL;;KAoCA,iCAAA;KAEA,wBAAA;MACN;;;;iBAIW;eACF;;KAGH,uBAAA;;;UAGF;;KAGE,6BAAA;;;;;;;;kCAQsB;;;;;kCAKA;;KAGtB,aAAA,kBACI,KAAK,0CAChB,oFAAoF"}
+{"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"}