statewire 0.12.2 → 0.13.1

package/src/transports/remote.ts

@@ -1,6 +1,9 @@
 import { useEffect } from "react";
 import type { Statewire } from "../types";
 import {
+  discardFailed,
+  failedCommands,
+  retryFailed,
   setContext,
   setTransport,
   useStatewireSession,
@@ -39,5 +42,10 @@ export const useStatewireRemote = <
       return !s.idle;
     },
     setContext: (value) => setContext(s, value),
+    failures: {
+      list: () => failedCommands(s),
+      retry: (entry) => retryFailed(s, entry),
+      discard: (entry) => discardFailed(s, entry),
+    },
   };
 };

package/src/transports/sse.ts

@@ -51,6 +51,8 @@ export type ConnectionState = StatewireClient.ConnectionState;
 /** The live wire a remote session drives: connection status plus frame submission. */
 export type RemoteLink = {
   connection: StatewireClient.Connection;
+  /** A deferred first attach still waiting; `reconnect()` releases it. */
+  parked: boolean;
   send: (frame: StatewireFrame) => Promise<StatewireSubmitResult>;
 };
 
@@ -269,6 +271,7 @@ const useSseLink = (
   const [auth] = useState((): AuthState => ({ stale: false }));
   const c = useStatewireConn({
     url: options.url,
+    isNew: options.isNew,
     onChange: options.onChange,
     ctx,
     attemptOnce: (c, abort) => attemptStream(c, options, auth, abort),
@@ -278,6 +281,9 @@ const useSseLink = (
       get connection() {
         return c.connection;
       },
+      get parked() {
+        return c.parked;
+      },
       send: (frame) => sendFrame(c, latest.current, auth, frame),
     }),
   );

package/src/transports/ws.ts

@@ -178,6 +178,7 @@ const useWsLink = (
   const [w] = useState((): WsChannel => ({ socket: null, authStale: false }));
   const c = useStatewireConn({
     url: options.url,
+    isNew: options.isNew,
     onChange: options.onChange,
     ctx,
     attemptOnce: (c, abort) => attemptSocket(c, w, options, abort),
@@ -187,6 +188,9 @@ const useWsLink = (
       get connection() {
         return c.connection;
       },
+      get parked() {
+        return c.parked;
+      },
       send: (frame) => sendFrame(w, frame),
     }),
   );

package/src/types.ts

@@ -59,6 +59,12 @@ export interface Statewire<
   isBusy?: boolean;
   /** Replace this client's ambient context on the server; it rides the ctx lane (no verdict). */
   setContext?: (value: Record<string, unknown>) => 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;
+  };
 }
 
 const describe = (failure: StatewireClient.SendFailure): string => {