@unicitylabs/sphere-sdk 0.6.0 → 0.6.2

package/dist/impl/nodejs/index.d.cts

@@ -201,6 +201,14 @@ interface TransportProvider extends BaseProvider {
      * and resolves after EOSE (End Of Stored Events).
      */
     fetchPendingEvents?(): Promise<void>;
+    /**
+     * Register a handler to be called when the chat subscription receives EOSE
+     * (End Of Stored Events), indicating that historical DMs have been delivered.
+     * The handler fires at most once per subscription lifecycle.
+     *
+     * @returns Unsubscribe function
+     */
+    onChatReady?(handler: () => void): () => void;
 }
 /**
  * Payload for sending instant split bundles
@@ -535,6 +543,7 @@ declare class NostrTransportProvider implements TransportProvider {
     onReadReceipt(handler: ReadReceiptHandler): () => void;
     sendTypingIndicator(recipientTransportPubkey: string): Promise<void>;
     onTypingIndicator(handler: TypingIndicatorHandler): () => void;
+    onChatReady(handler: () => void): () => void;
     onComposing(handler: ComposingHandler): () => void;
     sendComposingIndicator(recipientPubkey: string, content: string): Promise<void>;
     /**
@@ -604,6 +613,8 @@ declare class NostrTransportProvider implements TransportProvider {
     private queryEvents;
     private walletSubscriptionId;
     private chatSubscriptionId;
+    private chatEoseHandlers;
+    private chatEoseFired;
     private subscribeToEvents;
     private subscribeToTags;
     private decryptContent;

package/dist/impl/nodejs/index.d.ts

@@ -201,6 +201,14 @@ interface TransportProvider extends BaseProvider {
      * and resolves after EOSE (End Of Stored Events).
      */
     fetchPendingEvents?(): Promise<void>;
+    /**
+     * Register a handler to be called when the chat subscription receives EOSE
+     * (End Of Stored Events), indicating that historical DMs have been delivered.
+     * The handler fires at most once per subscription lifecycle.
+     *
+     * @returns Unsubscribe function
+     */
+    onChatReady?(handler: () => void): () => void;
 }
 /**
  * Payload for sending instant split bundles
@@ -535,6 +543,7 @@ declare class NostrTransportProvider implements TransportProvider {
     onReadReceipt(handler: ReadReceiptHandler): () => void;
     sendTypingIndicator(recipientTransportPubkey: string): Promise<void>;
     onTypingIndicator(handler: TypingIndicatorHandler): () => void;
+    onChatReady(handler: () => void): () => void;
     onComposing(handler: ComposingHandler): () => void;
     sendComposingIndicator(recipientPubkey: string, content: string): Promise<void>;
     /**
@@ -604,6 +613,8 @@ declare class NostrTransportProvider implements TransportProvider {
     private queryEvents;
     private walletSubscriptionId;
     private chatSubscriptionId;
+    private chatEoseHandlers;
+    private chatEoseFired;
     private subscribeToEvents;
     private subscribeToTags;
     private decryptContent;

package/dist/impl/nodejs/index.js

@@ -1180,6 +1180,7 @@ var NostrTransportProvider = class {
     this.mainSubscriptionId = null;
     this.walletSubscriptionId = null;
     this.chatSubscriptionId = null;
+    this.chatEoseFired = false;
     this.status = "disconnected";
     this.emitEvent({ type: "transport:disconnected", timestamp: Date.now() });
     logger.debug("Nostr", "Disconnected from all relays");
@@ -1503,6 +1504,20 @@ var NostrTransportProvider = class {
     this.typingIndicatorHandlers.add(handler);
     return () => this.typingIndicatorHandlers.delete(handler);
   }
+  onChatReady(handler) {
+    if (this.chatEoseFired) {
+      try {
+        handler();
+      } catch {
+      }
+      return () => {
+      };
+    }
+    this.chatEoseHandlers.push(handler);
+    return () => {
+      this.chatEoseHandlers = this.chatEoseHandlers.filter((h) => h !== handler);
+    };
+  }
   // ===========================================================================
   // Composing Indicators (NIP-59 kind 25050)
   // ===========================================================================
@@ -2220,6 +2235,9 @@ var NostrTransportProvider = class {
   // Track subscription IDs for cleanup
   walletSubscriptionId = null;
   chatSubscriptionId = null;
+  // Chat EOSE handlers — fired once when relay finishes delivering stored DMs
+  chatEoseHandlers = [];
+  chatEoseFired = false;
   async subscribeToEvents() {
     logger.debug("Nostr", "subscribeToEvents called, identity:", !!this.identity, "keyManager:", !!this.keyManager, "nostrClient:", !!this.nostrClient);
     if (!this.identity || !this.keyManager || !this.nostrClient) {
@@ -2309,6 +2327,16 @@ var NostrTransportProvider = class {
       },
       onEndOfStoredEvents: () => {
         logger.debug("Nostr", "Chat subscription ready (EOSE)");
+        if (!this.chatEoseFired) {
+          this.chatEoseFired = true;
+          for (const handler of this.chatEoseHandlers) {
+            try {
+              handler();
+            } catch {
+            }
+          }
+          this.chatEoseHandlers = [];
+        }
       },
       onError: (_subId, error) => {
         logger.debug("Nostr", "Chat subscription error:", error);