@unicitylabs/sphere-sdk 0.6.8-dev.1 → 0.6.8-dev.2

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

@@ -206,6 +206,14 @@ interface TransportProvider extends BaseProvider {
      * @param sinceSeconds - Unix timestamp in seconds
      */
     setFallbackSince?(sinceSeconds: number): void;
+    /**
+     * Set fallback 'since' timestamp for DM (gift-wrap) subscriptions.
+     * Used when no persisted DM timestamp exists in storage (e.g. first connect).
+     * Consumed once by the next subscription setup, then cleared.
+     *
+     * @param sinceSeconds - Unix timestamp in seconds
+     */
+    setFallbackDmSince?(sinceSeconds: number): void;
     /**
      * Fetch pending events from transport (one-shot query).
      * Creates a temporary subscription, processes events through normal handlers,
@@ -487,8 +495,12 @@ declare class NostrTransportProvider implements TransportProvider {
     private storage;
     /** In-memory max event timestamp to avoid read-before-write races in updateLastEventTimestamp. */
     private lastEventTs;
+    /** In-memory max DM (gift-wrap) event timestamp. */
+    private lastDmEventTs;
     /** Fallback 'since' timestamp for first-time address subscriptions (consumed once). */
     private fallbackSince;
+    /** Fallback 'since' timestamp for DM (gift-wrap) subscriptions (consumed once). */
+    private fallbackDmSince;
     private identity;
     private keyManager;
     private status;
@@ -559,6 +571,7 @@ declare class NostrTransportProvider implements TransportProvider {
     isRelayConnected(relayUrl: string): boolean;
     setIdentity(identity: FullIdentity): Promise<void>;
     setFallbackSince(sinceSeconds: number): void;
+    setFallbackDmSince(sinceSeconds: number): void;
     /**
      * Get the Nostr-format public key (32 bytes / 64 hex chars)
      * This is the x-coordinate only, without the 02/03 prefix.
@@ -633,6 +646,8 @@ declare class NostrTransportProvider implements TransportProvider {
      * when multiple events arrive in quick succession.
      */
     private updateLastEventTimestamp;
+    /** Persist the max DM (gift-wrap) event timestamp for the since filter on next connect. */
+    private updateLastDmEventTimestamp;
     private handleDirectMessage;
     private handleGiftWrap;
     private handleTokenTransfer;

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

@@ -206,6 +206,14 @@ interface TransportProvider extends BaseProvider {
      * @param sinceSeconds - Unix timestamp in seconds
      */
     setFallbackSince?(sinceSeconds: number): void;
+    /**
+     * Set fallback 'since' timestamp for DM (gift-wrap) subscriptions.
+     * Used when no persisted DM timestamp exists in storage (e.g. first connect).
+     * Consumed once by the next subscription setup, then cleared.
+     *
+     * @param sinceSeconds - Unix timestamp in seconds
+     */
+    setFallbackDmSince?(sinceSeconds: number): void;
     /**
      * Fetch pending events from transport (one-shot query).
      * Creates a temporary subscription, processes events through normal handlers,
@@ -487,8 +495,12 @@ declare class NostrTransportProvider implements TransportProvider {
     private storage;
     /** In-memory max event timestamp to avoid read-before-write races in updateLastEventTimestamp. */
     private lastEventTs;
+    /** In-memory max DM (gift-wrap) event timestamp. */
+    private lastDmEventTs;
     /** Fallback 'since' timestamp for first-time address subscriptions (consumed once). */
     private fallbackSince;
+    /** Fallback 'since' timestamp for DM (gift-wrap) subscriptions (consumed once). */
+    private fallbackDmSince;
     private identity;
     private keyManager;
     private status;
@@ -559,6 +571,7 @@ declare class NostrTransportProvider implements TransportProvider {
     isRelayConnected(relayUrl: string): boolean;
     setIdentity(identity: FullIdentity): Promise<void>;
     setFallbackSince(sinceSeconds: number): void;
+    setFallbackDmSince(sinceSeconds: number): void;
     /**
      * Get the Nostr-format public key (32 bytes / 64 hex chars)
      * This is the x-coordinate only, without the 02/03 prefix.
@@ -633,6 +646,8 @@ declare class NostrTransportProvider implements TransportProvider {
      * when multiple events arrive in quick succession.
      */
     private updateLastEventTimestamp;
+    /** Persist the max DM (gift-wrap) event timestamp for the since filter on next connect. */
+    private updateLastDmEventTimestamp;
     private handleDirectMessage;
     private handleGiftWrap;
     private handleTokenTransfer;

package/dist/impl/nodejs/index.js

@@ -28,6 +28,8 @@ var STORAGE_KEYS_GLOBAL = {
   TRACKED_ADDRESSES: "tracked_addresses",
   /** Last processed Nostr wallet event timestamp (unix seconds), keyed per pubkey */
   LAST_WALLET_EVENT_TS: "last_wallet_event_ts",
+  /** Last processed Nostr DM (gift-wrap) event timestamp (unix seconds), keyed per pubkey */
+  LAST_DM_EVENT_TS: "last_dm_event_ts",
   /** Group chat: last used relay URL (stale data detection) — global, same relay for all addresses */
   GROUP_CHAT_RELAY_URL: "group_chat_relay_url",
   /** Cached token registry JSON (fetched from remote) */
@@ -1087,8 +1089,12 @@ var NostrTransportProvider = class _NostrTransportProvider {
   storage = null;
   /** In-memory max event timestamp to avoid read-before-write races in updateLastEventTimestamp. */
   lastEventTs = 0;
+  /** In-memory max DM (gift-wrap) event timestamp. */
+  lastDmEventTs = 0;
   /** Fallback 'since' timestamp for first-time address subscriptions (consumed once). */
   fallbackSince = null;
+  /** Fallback 'since' timestamp for DM (gift-wrap) subscriptions (consumed once). */
+  fallbackDmSince = null;
   identity = null;
   keyManager = null;
   status = "disconnected";
@@ -1343,6 +1349,8 @@ var NostrTransportProvider = class _NostrTransportProvider {
     this.identity = identity;
     this.processedEventIds.clear();
     this.lastEventTs = 0;
+    this.lastDmEventTs = 0;
+    this.fallbackDmSince = null;
     const secretKey = Buffer2.from(identity.privateKey, "hex");
     this.keyManager = NostrKeyManager.fromPrivateKey(secretKey);
     const nostrPubkey = this.keyManager.getPublicKeyHex();
@@ -1388,6 +1396,9 @@ var NostrTransportProvider = class _NostrTransportProvider {
   setFallbackSince(sinceSeconds) {
     this.fallbackSince = sinceSeconds;
   }
+  setFallbackDmSince(sinceSeconds) {
+    this.fallbackDmSince = sinceSeconds;
+  }
   /**
    * Get the Nostr-format public key (32 bytes / 64 hex chars)
    * This is the x-coordinate only, without the 02/03 prefix.
@@ -1922,6 +1933,17 @@ var NostrTransportProvider = class _NostrTransportProvider {
       logger.debug("Nostr", "Failed to save last event timestamp:", err);
     });
   }
+  /** Persist the max DM (gift-wrap) event timestamp for the since filter on next connect. */
+  updateLastDmEventTimestamp(createdAt) {
+    if (!this.storage || !this.keyManager) return;
+    if (createdAt <= this.lastDmEventTs) return;
+    this.lastDmEventTs = createdAt;
+    const pubkey = this.keyManager.getPublicKeyHex();
+    const storageKey = `${STORAGE_KEYS_GLOBAL.LAST_DM_EVENT_TS}_${pubkey.slice(0, 16)}`;
+    this.storage.set(storageKey, createdAt.toString()).catch((err) => {
+      logger.debug("Nostr", "Failed to save last DM event timestamp:", err);
+    });
+  }
   async handleDirectMessage(event) {
     logger.debug("Nostr", "Ignoring NIP-04 kind 4 event (DMs use NIP-17):", event.id?.slice(0, 12));
   }
@@ -1932,6 +1954,9 @@ var NostrTransportProvider = class _NostrTransportProvider {
     }
     try {
       const pm = NIP17.unwrap(event, this.keyManager);
+      if (event.created_at) {
+        this.updateLastDmEventTimestamp(event.created_at);
+      }
       logger.debug("Nostr", "Gift wrap unwrapped, sender:", pm.senderPubkey?.slice(0, 16), "kind:", pm.kind);
       if (pm.senderPubkey === this.keyManager.getPublicKeyHex()) {
         try {
@@ -2378,9 +2403,50 @@ var NostrTransportProvider = class _NostrTransportProvider {
       }
     });
     logger.debug("Nostr", "Wallet subscription created, subId:", this.walletSubscriptionId);
+    let dmSince;
+    if (this.storage) {
+      const dmStorageKey = `${STORAGE_KEYS_GLOBAL.LAST_DM_EVENT_TS}_${nostrPubkey.slice(0, 16)}`;
+      try {
+        const stored = await this.storage.get(dmStorageKey);
+        const parsed = stored ? parseInt(stored, 10) : NaN;
+        if (Number.isFinite(parsed)) {
+          dmSince = parsed;
+          this.lastDmEventTs = dmSince;
+          this.fallbackDmSince = null;
+          logger.debug("Nostr", "DM resuming from stored timestamp:", dmSince);
+        } else if (this.fallbackDmSince !== null) {
+          dmSince = this.fallbackDmSince;
+          this.lastDmEventTs = dmSince;
+          this.fallbackDmSince = null;
+          logger.debug("Nostr", "DM using fallback since timestamp:", dmSince);
+        } else {
+          dmSince = Math.floor(Date.now() / 1e3);
+          logger.debug("Nostr", "No stored DM timestamp, starting from now:", dmSince);
+        }
+      } catch (err) {
+        if (this.fallbackDmSince !== null) {
+          dmSince = this.fallbackDmSince;
+          this.lastDmEventTs = dmSince;
+          this.fallbackDmSince = null;
+          logger.debug("Nostr", "Storage read failed, using DM fallback since:", dmSince, err);
+        } else {
+          dmSince = Math.floor(Date.now() / 1e3);
+          logger.debug("Nostr", "Failed to read last DM event timestamp, falling back to now:", err);
+        }
+      }
+    } else if (this.fallbackDmSince !== null) {
+      dmSince = this.fallbackDmSince;
+      this.lastDmEventTs = dmSince;
+      this.fallbackDmSince = null;
+      logger.debug("Nostr", "No storage adapter for DM, using fallback since:", dmSince);
+    } else {
+      dmSince = Math.floor(Date.now() / 1e3);
+      logger.debug("Nostr", "No storage adapter for DM, starting from now:", dmSince);
+    }
     const chatFilter = new Filter();
     chatFilter.kinds = [EventKinds.GIFT_WRAP];
     chatFilter["#p"] = [nostrPubkey];
+    chatFilter.since = dmSince;
     this.chatSubscriptionId = this.nostrClient.subscribe(chatFilter, {
       onEvent: (event) => {
         logger.debug("Nostr", "Received chat event kind:", event.kind, "id:", event.id?.slice(0, 12));