statewire 0.23.0 → 0.24.1

package/src/transports/remote.ts

@@ -4,13 +4,12 @@ import type { Statewire } from "../types";
 import {
   documentSource,
   invokeProtocol,
-  discardFailed,
-  failedCommands,
   holdOutbox,
+  insertOutbox,
   outboxEntries,
   releaseOutbox,
   removeOutbox,
-  retryFailed,
+  updateOutbox,
   setTransport,
   useStatewireSession,
   setContext,
@@ -48,19 +47,19 @@ export const useStatewireRemote = <
         params: readonly unknown[],
         options?: StatewireClient.InvokeOptions,
       ) => invokeProtocol(s, protocol, method, params, options),
-      failures: {
-        list: () => failedCommands(s),
-        retry: (entry: StatewireClient.FailedCommand) => retryFailed(s, entry),
-        discard: (entry: StatewireClient.FailedCommand) =>
-          discardFailed(s, entry),
-      },
       outbox: {
         list: () => outboxEntries(s),
-        hold: (entry: StatewireClient.OutboxEntry, meta?: unknown) =>
-          holdOutbox(s, entry, meta),
-        release: (entry: StatewireClient.OutboxEntry) =>
-          releaseOutbox(s, entry),
-        remove: (entry: StatewireClient.OutboxEntry) => removeOutbox(s, entry),
+        clientId: () => s.record.clientId,
+        hold: (id: string) => holdOutbox(s, id),
+        release: (id: string) => releaseOutbox(s, id),
+        remove: (id: string) => removeOutbox(s, id),
+        update: (
+          id: string,
+          fn: (
+            entry: StatewireClient.OutboxEntry,
+          ) => StatewireClient.OutboxPatch,
+        ) => updateOutbox(s, id, fn),
+        insert: (entry: StatewireClient.OutboxInsert) => insertOutbox(s, entry),
       },
     }),
     [s],

package/src/types.ts

@@ -30,6 +30,8 @@ export namespace Statewire {
       status: "queued" | "posted" | "applied" | "settled";
       result?: unknown;
       failure?: StatewireClient.SendFailure;
+      /** The command's client-only `localMeta`. */
+      localMeta?: unknown;
     };
   }[keyof TCommands];
 
@@ -87,18 +89,15 @@ export interface Statewire<
   attaching?: (attach: StatewireHost.Attach) => void;
   /** Called by the serving host when an attach ends; its ephemeral documents and includes are gone. */
   detached?: (attach: StatewireHost.Attach) => void;
-  /** The retained failed-send lane; present on transports with a durable session. */
-  failures?: {
-    list: () => readonly StatewireClient.FailedCommand[];
-    retry: (entry: StatewireClient.FailedCommand) => Promise<unknown>;
-    discard: (entry: StatewireClient.FailedCommand) => void;
-  };
-  /** The outbox of commands without a seq; present on transports with a durable session. */
+  /** The outbox; present on transports with a durable session. */
   outbox?: {
     list: () => readonly StatewireClient.OutboxEntry[];
+    clientId: () => string;
     hold: StatewireClient.Outbox["hold"];
     release: StatewireClient.Outbox["release"];
     remove: StatewireClient.Outbox["remove"];
+    update: StatewireClient.Outbox["update"];
+    insert: StatewireClient.Outbox["insert"];
   };
 }