@calimero-network/mero-js 23.2.0 → 23.3.0

package/dist/ephemeral/index.d.ts

@@ -49,3 +49,9 @@ export declare class EphemeralClient {
      */
     subscribe<T>(contextId: string, handler: (entry: EphemeralEntry<T>) => void, codec?: Codec<T>): () => void;
 }
+/**
+ * Presence for one context off an event stream: a typed filter over the SSE
+ * events that already carry `{ contextId, type, data }`. Shared by a node
+ * client and an account's relay client, which read presence the same way.
+ */
+export declare function subscribePresence<T>(sse: SseClient, contextId: string, handler: (entry: EphemeralEntry<T>) => void, codec?: Codec<T>): () => void;

package/dist/ephemeral/index.js

@@ -48,34 +48,44 @@ export class EphemeralClient {
      * and zero mean different things). Returns an unsubscribe function.
      */
     subscribe(contextId, handler, codec = jsonCodec()) {
-        const listener = (event) => {
-            const e = event;
-            if (e.type !== 'Ephemeral' || e.contextId !== contextId)
-                return;
-            const data = e.data;
-            if (!data?.author)
-                return;
-            // `removed` is omitted on an upsert, so normalize to a boolean here and
-            // spare every caller the truthiness rule.
-            const removed = Boolean(data.removed);
-            const entry = {
-                author: data.author,
-                state: removed || data.state === undefined ? undefined : codec.decode(data.state),
-                removed,
-            };
-            // `ageMs` is present only on a replayed seed entry; pass it through as-is
-            // rather than defaulting a live delta to 0.
-            if (data.ageMs !== undefined)
-                entry.ageMs = data.ageMs;
-            handler(entry);
-        };
-        this.sse.on('event', listener);
-        // Errors surface via the SSE client's own 'error' event; nothing more to
-        // do with them here.
-        void this.sse.connect().catch(() => undefined);
-        void this.sse.subscribe([contextId]).catch(() => undefined);
-        return () => {
-            this.sse.off('event', listener);
-        };
+        return subscribePresence(this.sse, contextId, handler, codec);
     }
 }
+/**
+ * Presence for one context off an event stream: a typed filter over the SSE
+ * events that already carry `{ contextId, type, data }`. Shared by a node
+ * client and an account's relay client, which read presence the same way.
+ */
+export function subscribePresence(sse, contextId, handler, codec = jsonCodec()) {
+    const listener = (event) => {
+        const e = event;
+        if (e.type !== 'Ephemeral' || e.contextId !== contextId)
+            return;
+        const data = e.data;
+        if (!data?.author)
+            return;
+        // `removed` is omitted on an upsert, so normalize to a boolean here and
+        // spare every caller the truthiness rule.
+        const removed = Boolean(data.removed);
+        const entry = {
+            author: data.author,
+            state: removed || data.state === undefined ? undefined : codec.decode(data.state),
+            removed,
+        };
+        // `ageMs` is present only on a replayed seed entry; pass it through as-is
+        // rather than defaulting a live delta to 0.
+        if (data.ageMs !== undefined)
+            entry.ageMs = data.ageMs;
+        if (data.account !== undefined)
+            entry.account = data.account;
+        handler(entry);
+    };
+    sse.on('event', listener);
+    // Errors surface via the SSE client's own 'error' event; nothing more to
+    // do with them here.
+    void sse.connect().catch(() => undefined);
+    void sse.subscribe([contextId]).catch(() => undefined);
+    return () => {
+        sse.off('event', listener);
+    };
+}

package/dist/ephemeral/types.d.ts

@@ -16,6 +16,11 @@ export interface Codec<T> {
  * machines is needed. Bounded above by the node's 7s presence TTL. */
 export interface EphemeralEntry<T> {
     author: string;
+    /**
+     * The account a relay-carried update's device certificate names, hex. Absent
+     * for a node's own presence.
+     */
+    account?: string;
     state?: T;
     removed?: boolean;
     ageMs?: number;