@sockethub/client 5.0.0-beta.0 → 5.0.0-beta.2

package/README.md

@@ -150,7 +150,8 @@ See the [Client Guide](../../docs/client-guide.md) for detailed usage and exampl
 - **`sc.validateActivity(activity)`** - Validate against registered schemas
 - **`sc.socket.emit(event, data, callback)`** - Send messages (queued until ready)
 - **`sc.socket.on(event, handler)`** - Listen for messages
-- **`sc.clearCredentials()`** - Clear stored credentials
+- **`sc.clearCredentials()`** - Clear stored and queued credentials. Pass
+  `{ platform, actorId }` to clear one account and its connection/join replay.
 
 Send a full `actor` object on each `credentials` and `message` event.
 
@@ -175,6 +176,10 @@ sc.socket.emit("message", {
 });
 ```
 
+Before a job is queued, a failure result contains `error` and omits the
+activity you submitted. The shape is described in the
+[client guide](../../docs/client-guide.md#message-limits).
+
 Also listen for ongoing platform events:
 
 ```javascript
@@ -223,6 +228,14 @@ change, whether you requested it and the server acknowledged it or the server re
 stored entries move to the new actor so a reconnect replays the identity the connection currently
 holds.
 
+Only `actor.id` and `actor.name` move. The credential object stays as the
+application submitted it, including `nick`, `password`, and `token`. The
+server selects the live connection by a fingerprint of that object, so
+rewriting `nick` on reconnect opens a different session. An acknowledgement
+or incoming update that contains `error` does not move the stored entries;
+keep sending as the previous actor. A timeout or a dropped socket, delivered
+as an `Error`, does not move them either.
+
 #### Storage Location
 
 **All state is stored ONLY in JavaScript memory.** Nothing is persisted to:

package/dist/replay-store.d.ts

@@ -18,6 +18,11 @@ export declare function hasActorId(obj: ActivityStream): obj is ActivityStream;
  * and `target` the new one.
  */
 export declare function isActorRename(activity: ActivityStream): boolean;
+/** Match normalized or queued account credentials without requiring initialization. */
+export declare function matchesAccount(content: unknown, scope: {
+    platform: string;
+    actorId: string;
+}): boolean;
 /**
  * In-memory storage for client state that should be replayed on reconnection.
  *
@@ -26,6 +31,10 @@ export declare function isActorRename(activity: ActivityStream): boolean;
  */
 export declare class ReplayStore {
     readonly events: EventMapping;
+    clearCredentials(scope?: {
+        platform: string;
+        actorId: string;
+    }): void;
     recordCredentials(content: ActivityStream): void;
     /**
      * Stores connect/join commands and drops them again on