@fragno-dev/db 0.2.2 → 0.4.1

package/dist/dispatchers/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/dispatchers/node/index.ts"],"sourcesContent":["import { createDurableHooksProcessorGroup } from \"../../hooks/durable-hooks-processor\";\nimport { getDurableHooksRuntimeByToken } from \"../../hooks/durable-hooks-runtime\";\nimport type { AnyFragnoInstantiatedDatabaseFragment } from \"../../mod\";\nimport { createDurableHooksDispatcher, type DurableHooksDispatcher } from \"./dispatcher\";\n\nexport type DurableHooksProcessorOptions = {\n  pollIntervalMs?: number;\n  onError?: (error: unknown) => void;\n};\n\nexport type { DurableHooksDispatcher };\n\ntype DurableHooksInternal = {\n  durableHooksToken?: object;\n};\n\nexport function createDurableHooksProcessor(\n  fragments: readonly AnyFragnoInstantiatedDatabaseFragment[],\n  options: DurableHooksProcessorOptions = {},\n): DurableHooksDispatcher {\n  const processor = createDurableHooksProcessorGroup(fragments, {\n    onError: options.onError,\n  });\n  const dispatcher = createDurableHooksDispatcher({\n    processor,\n    pollIntervalMs: options.pollIntervalMs,\n    onError: options.onError,\n  });\n\n  const notifier = {\n    notify: (context: Parameters<typeof dispatcher.notify>[0]) => {\n      dispatcher.notify(context);\n    },\n  };\n\n  for (const fragment of fragments) {\n    const internal = fragment.$internal as DurableHooksInternal | undefined;\n    const durableHooksToken = internal?.durableHooksToken;\n    if (!durableHooksToken) {\n      continue;\n    }\n    const runtime = getDurableHooksRuntimeByToken(durableHooksToken);\n    if (!runtime) {\n      continue;\n    }\n    runtime.config.notifier = notifier;\n  }\n\n  return dispatcher;\n}\n"],"mappings":";;;;;AAgBA,SAAgB,4BACd,WACA,UAAwC,EAAE,EAClB;CAIxB,MAAM,aAAa,6BAA6B;EAC9C,WAJgB,iCAAiC,WAAW,EAC5D,SAAS,QAAQ,SAClB,CAAC;EAGA,gBAAgB,QAAQ;EACxB,SAAS,QAAQ;EAClB,CAAC;CAEF,MAAM,WAAW,EACf,SAAS,YAAqD;AAC5D,aAAW,OAAO,QAAQ;IAE7B;AAED,MAAK,MAAM,YAAY,WAAW;EAEhC,MAAM,oBADW,SAAS,WACU;AACpC,MAAI,CAAC,kBACH;EAEF,MAAM,UAAU,8BAA8B,kBAAkB;AAChE,MAAI,CAAC,QACH;AAEF,UAAQ,OAAO,WAAW;;AAG5B,QAAO"}

package/dist/durable-hooks.d.ts

@@ -0,0 +1,31 @@
+import { FragnoId } from "./schema/create.js";
+import { AnyFragnoInstantiatedDatabaseFragment } from "./mod.js";
+import { InternalFragmentInstance } from "./fragments/internal-fragment.js";
+import { HookStatus } from "./hooks/hooks.js";
+
+//#region src/durable-hooks.d.ts
+type DurableHookStatus = HookStatus;
+type DurableHookRecord = {
+  id: FragnoId;
+  namespace: string;
+  hookName: string;
+  payload: unknown;
+  status: DurableHookStatus;
+  attempts: number;
+  maxAttempts: number;
+  lastAttemptAt: Date | null;
+  nextRetryAt: Date | null;
+  createdAt: Date;
+  error: string | null;
+  nonce: string;
+};
+type DurableHooksService = InternalFragmentInstance["services"]["hookService"];
+type DurableHooksAccessor = {
+  namespace: string;
+  hooksEnabled: boolean;
+  hookService: DurableHooksService;
+};
+declare function getDurableHooksService(fragment: AnyFragnoInstantiatedDatabaseFragment): DurableHooksAccessor;
+//#endregion
+export { type AnyFragnoInstantiatedDatabaseFragment, DurableHookRecord, DurableHookStatus, DurableHooksAccessor, DurableHooksService, getDurableHooksService };
+//# sourceMappingURL=durable-hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"durable-hooks.d.ts","names":[],"sources":["../src/durable-hooks.ts"],"sourcesContent":[],"mappings":";;;;;;KAUY,iBAAA,GAAoB;AAApB,KAEA,iBAAA,GAFiB;EAEjB,EAAA,EACN,QADM;EACN,SAAA,EAAA,MAAA;EAII,QAAA,EAAA,MAAA;EAGO,OAAA,EAAA,OAAA;EACF,MAAA,EAJL,iBAIK;EACF,QAAA,EAAA,MAAA;EAAI,WAAA,EAAA,MAAA;EAKL,aAAA,EAPK,IAOL,GAAmB,IAAA;EAEnB,WAAA,EARG,IAQH,GAAA,IAAoB;EAMhB,SAAA,EAbH,IAaG;;;;KARJ,mBAAA,GAAsB;KAEtB,oBAAA;;;eAGG;;iBAGC,sBAAA,WACJ,wCACT"}

package/dist/durable-hooks.js

@@ -0,0 +1,23 @@
+import { getDurableHooksRuntimeByToken } from "./hooks/durable-hooks-runtime.js";
+import { getInternalFragment } from "./internal/adapter-registry.js";
+
+//#region src/durable-hooks.ts
+function getDurableHooksService(fragment) {
+	const durableHooksToken = fragment.$internal?.durableHooksToken;
+	const runtime = durableHooksToken ? getDurableHooksRuntimeByToken(durableHooksToken) : void 0;
+	const deps = fragment.$internal?.deps;
+	if (!deps?.databaseAdapter) throw new Error("Database adapter is missing for durable hooks.");
+	const namespace = runtime?.config.namespace ?? deps.namespace ?? deps.schema?.name ?? "";
+	if (!namespace) throw new Error("Durable hooks namespace is missing.");
+	const hookAdapter = deps.databaseAdapter.getHookProcessingAdapter?.() ?? deps.databaseAdapter;
+	const internalFragment = runtime?.config.internalFragment ?? getInternalFragment(hookAdapter);
+	return {
+		namespace,
+		hooksEnabled: Boolean(durableHooksToken),
+		hookService: internalFragment.services.hookService
+	};
+}
+
+//#endregion
+export { getDurableHooksService };
+//# sourceMappingURL=durable-hooks.js.map

package/dist/durable-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-hooks.js","names":[],"sources":["../src/durable-hooks.ts"],"sourcesContent":["import type { DatabaseAdapter } from \"./adapters/adapters\";\nimport type { InternalFragmentInstance } from \"./fragments/internal-fragment\";\nimport { getDurableHooksRuntimeByToken } from \"./hooks/durable-hooks-runtime\";\nimport type { HookStatus } from \"./hooks/hooks\";\nimport { getInternalFragment } from \"./internal/adapter-registry\";\nimport type { AnyFragnoInstantiatedDatabaseFragment } from \"./mod\";\nimport type { FragnoId } from \"./schema/create\";\n\nexport type { AnyFragnoInstantiatedDatabaseFragment };\n\nexport type DurableHookStatus = HookStatus;\n\nexport type DurableHookRecord = {\n  id: FragnoId;\n  namespace: string;\n  hookName: string;\n  payload: unknown;\n  status: DurableHookStatus;\n  attempts: number;\n  maxAttempts: number;\n  lastAttemptAt: Date | null;\n  nextRetryAt: Date | null;\n  createdAt: Date;\n  error: string | null;\n  nonce: string;\n};\n\nexport type DurableHooksService = InternalFragmentInstance[\"services\"][\"hookService\"];\n\nexport type DurableHooksAccessor = {\n  namespace: string;\n  hooksEnabled: boolean;\n  hookService: DurableHooksService;\n};\n\nexport function getDurableHooksService(\n  fragment: AnyFragnoInstantiatedDatabaseFragment,\n): DurableHooksAccessor {\n  const internal = fragment.$internal as { durableHooksToken?: object } | undefined;\n  const durableHooksToken = internal?.durableHooksToken;\n  const runtime = durableHooksToken ? getDurableHooksRuntimeByToken(durableHooksToken) : undefined;\n  const deps = fragment.$internal?.deps as\n    | {\n        databaseAdapter?: DatabaseAdapter<unknown>;\n        namespace?: string | null;\n        schema?: { name?: string };\n      }\n    | undefined;\n\n  if (!deps?.databaseAdapter) {\n    throw new Error(\"Database adapter is missing for durable hooks.\");\n  }\n\n  const namespace = runtime?.config.namespace ?? deps.namespace ?? deps.schema?.name ?? \"\";\n  if (!namespace) {\n    throw new Error(\"Durable hooks namespace is missing.\");\n  }\n\n  const hookAdapter = deps.databaseAdapter.getHookProcessingAdapter?.() ?? deps.databaseAdapter;\n  const internalFragment = runtime?.config.internalFragment ?? getInternalFragment(hookAdapter);\n\n  return {\n    namespace,\n    hooksEnabled: Boolean(durableHooksToken),\n    hookService: internalFragment.services.hookService,\n  };\n}\n"],"mappings":";;;;AAmCA,SAAgB,uBACd,UACsB;CAEtB,MAAM,oBADW,SAAS,WACU;CACpC,MAAM,UAAU,oBAAoB,8BAA8B,kBAAkB,GAAG;CACvF,MAAM,OAAO,SAAS,WAAW;AAQjC,KAAI,CAAC,MAAM,gBACT,OAAM,IAAI,MAAM,iDAAiD;CAGnE,MAAM,YAAY,SAAS,OAAO,aAAa,KAAK,aAAa,KAAK,QAAQ,QAAQ;AACtF,KAAI,CAAC,UACH,OAAM,IAAI,MAAM,sCAAsC;CAGxD,MAAM,cAAc,KAAK,gBAAgB,4BAA4B,IAAI,KAAK;CAC9E,MAAM,mBAAmB,SAAS,OAAO,oBAAoB,oBAAoB,YAAY;AAE7F,QAAO;EACL;EACA,cAAc,QAAQ,kBAAkB;EACxC,aAAa,iBAAiB,SAAS;EACxC"}

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

@@ -1,13 +1,42 @@
+import { DbNow } from "../query/db-now.js";
 import { AnyColumn, AnyRelation, Column, FragnoId, IdColumn, Index, Schema, Table } from "../schema/create.js";
+import { Cursor } from "../query/cursor.js";
 import { RetryPolicy } from "../query/unit-of-work/retry-policy.js";
 import { TxResult } from "../query/unit-of-work/execute-unit-of-work.js";
 import { DatabaseHandlerContext, DatabaseRequestStorage, DatabaseServiceContext, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies } from "../db-fragment-definition-builder.js";
 import "../mod.js";
+import { internalSchema } from "./internal-fragment.schema.js";
 import * as _fragno_dev_core0 from "@fragno-dev/core";
 import { InstantiatedFragmentFromDefinition } from "@fragno-dev/core";
 
 //#region src/fragments/internal-fragment.d.ts
-declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies<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", Date | null, Date | null>> & Record<"nextRetryAt", Column<"timestamp", Date | null, Date | null>> & Record<"error", Column<"string", string | null, string | null>> & Record<"createdAt", Column<"timestamp", 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", Date | null, Date | null>] & AnyColumn[], readonly ["namespace", "status", "nextRetryAt"]>> & Record<"idx_nonce", Index<readonly [Column<"string", string, string>] & AnyColumn[], readonly ["nonce"]>>>>>>, {}, {
+type AdapterRegistry = {
+  listSchemas: () => Array<{
+    name: string;
+    namespace: string | null;
+    version: number;
+    tables: string[];
+  }>;
+  listOutboxFragments: () => Array<{
+    name: string;
+    mountRoute: string;
+  }>;
+  isOutboxEnabled: () => boolean;
+  resolveSyncCommand: (fragmentName: string, schemaName: string, commandName: string) => {
+    command: unknown;
+    namespace: string | null;
+  } | undefined;
+};
+type InternalFragmentConfig = {
+  registry?: AdapterRegistry;
+};
+declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<InternalFragmentConfig, FragnoPublicConfigWithDatabase, ImplicitDatabaseDependencies<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"]>>>;
+}>>, {}, {
   settingsService: {
     /**
      * Get a setting by namespace and key.
@@ -29,6 +58,14 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
       key: string;
       value: string;
     } | null>;
+    /**
+     * Set a setting value only if it does not already exist.
+     */
+    setIfMissing(namespace: string, key: string, value: string): TxResult<void, {
+      id: FragnoId;
+      key: string;
+      value: string;
+    } | null>;
     /**
      * Delete a setting by ID.
      */
@@ -44,21 +81,94 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
       id: FragnoId;
       hookName: string;
       payload: unknown;
+      status: "pending" | "processing" | "completed" | "failed";
+      attempts: number;
+      maxAttempts: number;
+      lastAttemptAt: Date | null;
+      nextRetryAt: Date | null;
+      createdAt: Date;
+      idempotencyKey: string;
+    }[], {
+      id: FragnoId;
+      hookName: string;
+      payload: unknown;
+      status: "pending" | "processing" | "completed" | "failed";
       attempts: number;
       maxAttempts: number;
+      lastAttemptAt: Date | null;
+      nextRetryAt: Date | null;
+      createdAt: Date;
+      idempotencyKey: string;
+    }[]>;
+    /**
+     * Claim pending hook events for processing.
+     * Returns ready events and marks them as processing in the same transaction.
+     */
+    claimPendingHookEvents(namespace: string): TxResult<{
+      status: "processing";
+      id: FragnoId;
+      hookName: string;
+      payload: unknown;
+      attempts: number;
+      maxAttempts: number;
+      lastAttemptAt: Date | null;
+      nextRetryAt: Date | null;
+      createdAt: Date;
       idempotencyKey: string;
     }[], {
       id: FragnoId;
       hookName: string;
       payload: unknown;
+      status: "pending" | "processing" | "completed" | "failed";
       attempts: number;
       maxAttempts: number;
+      lastAttemptAt: Date | null;
+      nextRetryAt: Date | null;
+      createdAt: Date;
       idempotencyKey: string;
     }[]>;
     /**
-     * Mark a hook event as completed.
+     * Claim stale processing hook events for processing.
+     * Returns ready events and marks them as processing in the same transaction.
+     */
+    claimStuckProcessingHookEvents(namespace: string, staleBefore: DbNow): TxResult<{
+      events: {
+        id: FragnoId;
+        hookName: string;
+        payload: unknown;
+        status: "pending" | "processing" | "completed" | "failed";
+        attempts: number;
+        maxAttempts: number;
+        idempotencyKey: string;
+        lastAttemptAt: Date | null;
+        nextRetryAt: Date | null;
+        createdAt: Date;
+      }[];
+      stuckEvents: {
+        id: FragnoId;
+        hookName: string;
+        attempts: number;
+        maxAttempts: number;
+        lastAttemptAt: Date | null;
+        nextRetryAt: Date | null;
+      }[];
+    }, {
+      id: FragnoId;
+      hookName: string;
+      payload: unknown;
+      status: "pending" | "processing" | "completed" | "failed";
+      attempts: number;
+      maxAttempts: number;
+      idempotencyKey: string;
+      lastAttemptAt: Date | null;
+      nextRetryAt: Date | null;
+      createdAt: Date;
+    }[]>;
+    /**
+     * Get the earliest pending hook wake time for a namespace.
+     * Optionally considers processing hooks becoming stale when timeoutMinutes is provided.
      */
-    markHookCompleted(eventId: FragnoId): TxResult<void, void>;
+    getNextHookWakeAt(namespace: string, timeoutMinutes?: number | false): TxResult<Date | null, Date | null>;
     /**
      * Mark a hook event as failed and schedule next retry.
      */
@@ -71,11 +181,11 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
      * Get a hook event by ID (for testing/verification purposes).
      */
     getHookById(eventId: FragnoId): TxResult<{
+      status: "pending" | "processing" | "completed" | "failed";
       id: FragnoId;
       namespace: string;
       hookName: string;
       payload: unknown;
-      status: string;
       attempts: number;
       maxAttempts: number;
       lastAttemptAt: Date | null;
@@ -84,11 +194,11 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
       createdAt: Date;
       nonce: string;
     } | undefined, {
+      status: "pending" | "processing" | "completed" | "failed";
       id: FragnoId;
       namespace: string;
       hookName: string;
       payload: unknown;
-      status: string;
       attempts: number;
       maxAttempts: number;
       lastAttemptAt: Date | null;
@@ -97,15 +207,56 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
       createdAt: Date;
       nonce: string;
     } | undefined>;
+    /**
+     * Get hook events for a namespace in newest-first order with pagination.
+     */
+    getHooksByNamespacePage(namespace: string, options?: {
+      cursor?: Cursor | string;
+      pageSize?: number;
+    }): TxResult<{
+      items: {
+        status: "pending" | "processing" | "completed" | "failed";
+        id: FragnoId;
+        namespace: string;
+        hookName: string;
+        payload: unknown;
+        attempts: number;
+        maxAttempts: number;
+        lastAttemptAt: Date | null;
+        nextRetryAt: Date | null;
+        error: string | null;
+        createdAt: Date;
+        nonce: string;
+      }[];
+      cursor: Cursor | undefined;
+      hasNextPage: boolean;
+    }, {
+      items: {
+        status: "pending" | "processing" | "completed" | "failed";
+        id: FragnoId;
+        namespace: string;
+        hookName: string;
+        payload: unknown;
+        attempts: number;
+        maxAttempts: number;
+        lastAttemptAt: Date | null;
+        nextRetryAt: Date | null;
+        error: string | null;
+        createdAt: Date;
+        nonce: string;
+      }[];
+      cursor: Cursor | undefined;
+      hasNextPage: boolean;
+    }>;
     /**
      * Get all hook events for a namespace (for testing/verification purposes).
      */
     getHooksByNamespace(namespace: string): TxResult<{
+      status: "pending" | "processing" | "completed" | "failed";
       id: FragnoId;
       namespace: string;
       hookName: string;
       payload: unknown;
-      status: string;
       attempts: number;
       maxAttempts: number;
       lastAttemptAt: Date | null;
@@ -114,11 +265,11 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
       createdAt: Date;
       nonce: string;
     }[], {
+      status: "pending" | "processing" | "completed" | "failed";
       id: FragnoId;
       namespace: string;
       hookName: string;
       payload: unknown;
-      status: string;
       attempts: number;
       maxAttempts: number;
       lastAttemptAt: Date | null;
@@ -128,7 +279,34 @@ declare const internalFragmentDef: _fragno_dev_core0.FragmentDefinition<{}, Frag
       nonce: string;
     }[]>;
   };
-}, {}, {}, DatabaseServiceContext<{}>, DatabaseHandlerContext<{}>, DatabaseRequestStorage, {}>;
+} & {
+  outboxService: {
+    /**
+     * List outbox entries ordered by versionstamp (ascending).
+     */
+    list({
+      afterVersionstamp,
+      limit
+    }?: {
+      afterVersionstamp?: string;
+      limit?: number;
+    }): TxResult<{
+      id: FragnoId;
+      versionstamp: string;
+      uowId: string;
+      payload: unknown;
+      refMap: {} | undefined;
+      createdAt: Date;
+    }[], {
+      id: FragnoId;
+      versionstamp: string;
+      uowId: string;
+      payload: unknown;
+      refMap: {} | undefined;
+      createdAt: Date;
+    }[]>;
+  };
+}, {}, {}, DatabaseServiceContext<{}>, DatabaseHandlerContext<{}>, DatabaseRequestStorage, readonly []>;
 /**
  * Type representing an instantiated internal fragment.
  * This is the fragment that manages Fragno's internal settings table.

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

@@ -1 +1 @@
-{"version":3,"file":"internal-fragment.d.ts","names":[],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"internal-fragment.d.ts","names":[],"sources":["../../src/fragments/internal-fragment.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;;;KAsBK,eAAA;qBACgB;;;;IADhB,MAAA,EAAA,MAAe,EAAA;EAyCR,CAAA,CAAA;EAiCC,mBAAA,EAAA,GAogBH,GAvkBmB,KAukBnB,CAAA;IApgBsB,IAAA,EAAA,MAAA;IAAA,UAAA,EAAA,MAAA;;;;;;;;KAjCpB,sBAAA;aACC;;cAgCA,uCAAmB,mBAAA,wBAAA,gCAAA;;;;;;;;;;;yCA6BM;UAAR;;;;UAAA;;;;;;;;;;;;;;;;;;;;;;;eA0Db,WAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mEAwG4C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2EAmEK,SAAA,aAAA;;;;4BAkG5C,wDAAwD,cAAW;IApWjE;;;IA6BM,kBAAA,CAAA,OAAA,EA+WJ,QA/WI,CAAA,EA+WI,QA/WJ,CAAA,IAAA,EAAA,IAAA,CAAA;;;;yBA4XX;MAlUV,MAAA,EAAA,SAAA,GAAA,YAAA,GAAA,WAAA,GAAA,QAAA;MAAQ,EAAA,UAAA;;;;;;;;;;;;;;;;;;;MAwG4C,aAAA,MAAA,GAAA,IAAA;;;;;;;;;;eAiPzC;;;MA9K8C,KAAA,EAAA;QAAA,MAAA,EAAA,SAAA,GAAA,YAAA,GAAA,WAAA,GAAA,QAAA;QAAA,EAAA,UAAA;QAkG5C,SAAA,EAAA,MAAA;QAAwD,QAAA,EAAA,MAAA;QAAW,OAAA,EAAA,OAAA;QAwC/D,QAAA,EAAA,MAAA;QAAQ,WAAA,EAAA,MAAA;QAaf,aAAA,MAAA,GAAA,IAAA;;;;;;;;;;QAuBC,MAAA,EAAA,SAAA,GAAA,YAAA,GAAA,WAAA,GAAA,QAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAhbI,MAAA;IAAA,CAAA,EAAA,EAAA;MA0gBpB,MAAA,EAAA,SAAA,GAAwB,YAC3B,GAAA,WAAA,GAAA,QAD8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAA3B,wBAAA,GAA2B,0CAC9B"}