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

package/dist/core/index.d.cts

@@ -1418,6 +1418,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,
@@ -1729,6 +1737,7 @@ declare class MultiAddressTransportMux {
      * Set fallback 'since' for an address (consumed once on next subscription setup).
      */
     setFallbackSince(index: number, sinceSeconds: number): void;
+    setFallbackDmSince(index: number, sinceSeconds: number): void;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     isConnected(): boolean;
@@ -1806,6 +1815,8 @@ declare class MultiAddressTransportMux {
      */
     getIdentity(addressIndex: number): FullIdentity | null;
     private updateLastEventTimestamp;
+    private updateLastDmEventTimestamp;
+    private getAddressDmSince;
     onTransportEvent(callback: TransportEventCallback): () => void;
     onChatReady(handler: () => void): () => void;
     private emitEvent;
@@ -1887,6 +1898,7 @@ declare class AddressTransportAdapter implements TransportProvider {
     hasRelay(relayUrl: string): boolean;
     isRelayConnected(relayUrl: string): boolean;
     setFallbackSince(sinceSeconds: number): void;
+    setFallbackDmSince(sinceSeconds: number): void;
     fetchPendingEvents(): Promise<void>;
     onChatReady(handler: () => void): () => void;
     dispatchMessage(message: IncomingMessage): void;
@@ -3891,6 +3903,12 @@ interface SphereInitOptions {
      * - false/undefined: no auto-discovery (default)
      */
     discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /**
+     * Fallback 'since' timestamp (unix seconds) for the DM (gift-wrap) subscription.
+     * Used when no persisted DM timestamp exists in storage (e.g. first connect).
+     * Without this, a fresh wallet starts from "now" and misses older DMs.
+     */
+    dmSince?: number;
     /** Enable debug logging (default: false) */
     debug?: boolean;
     /** Optional callback to report initialization progress steps */

package/dist/core/index.d.ts

@@ -1418,6 +1418,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,
@@ -1729,6 +1737,7 @@ declare class MultiAddressTransportMux {
      * Set fallback 'since' for an address (consumed once on next subscription setup).
      */
     setFallbackSince(index: number, sinceSeconds: number): void;
+    setFallbackDmSince(index: number, sinceSeconds: number): void;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     isConnected(): boolean;
@@ -1806,6 +1815,8 @@ declare class MultiAddressTransportMux {
      */
     getIdentity(addressIndex: number): FullIdentity | null;
     private updateLastEventTimestamp;
+    private updateLastDmEventTimestamp;
+    private getAddressDmSince;
     onTransportEvent(callback: TransportEventCallback): () => void;
     onChatReady(handler: () => void): () => void;
     private emitEvent;
@@ -1887,6 +1898,7 @@ declare class AddressTransportAdapter implements TransportProvider {
     hasRelay(relayUrl: string): boolean;
     isRelayConnected(relayUrl: string): boolean;
     setFallbackSince(sinceSeconds: number): void;
+    setFallbackDmSince(sinceSeconds: number): void;
     fetchPendingEvents(): Promise<void>;
     onChatReady(handler: () => void): () => void;
     dispatchMessage(message: IncomingMessage): void;
@@ -3891,6 +3903,12 @@ interface SphereInitOptions {
      * - false/undefined: no auto-discovery (default)
      */
     discoverAddresses?: boolean | DiscoverAddressesOptions;
+    /**
+     * Fallback 'since' timestamp (unix seconds) for the DM (gift-wrap) subscription.
+     * Used when no persisted DM timestamp exists in storage (e.g. first connect).
+     * Without this, a fresh wallet starts from "now" and misses older DMs.
+     */
+    dmSince?: number;
     /** Enable debug logging (default: false) */
     debug?: boolean;
     /** Optional callback to report initialization progress steps */

package/dist/core/index.js

@@ -175,6 +175,8 @@ var init_constants = __esm({
       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) */
@@ -1234,8 +1236,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";
@@ -1490,6 +1496,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();
@@ -1535,6 +1543,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.
@@ -2069,6 +2080,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));
   }
@@ -2079,6 +2101,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 {
@@ -2525,9 +2550,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));
@@ -2772,7 +2838,9 @@ var MultiAddressTransportMux = class {
       nostrPubkey,
       adapter,
       lastEventTs: 0,
-      fallbackSince: null
+      lastDmEventTs: 0,
+      fallbackSince: null,
+      fallbackDmSince: null
     };
     this.addresses.set(index, entry);
     this.pubkeyToIndex.set(nostrPubkey, index);
@@ -2814,6 +2882,12 @@ var MultiAddressTransportMux = class {
       entry.fallbackSince = sinceSeconds;
     }
   }
+  setFallbackDmSince(index, sinceSeconds) {
+    const entry = this.addresses.get(index);
+    if (entry) {
+      entry.fallbackDmSince = sinceSeconds;
+    }
+  }
   // ===========================================================================
   // Connection Management (delegated from adapters)
   // ===========================================================================
@@ -2949,11 +3023,20 @@ var MultiAddressTransportMux = class {
     }
     logger.debug("Mux", `Subscribing for ${allPubkeys.length} address(es):`, allPubkeys.map((p) => p.slice(0, 12)).join(", "));
     let globalSince = Math.floor(Date.now() / 1e3);
-    for (const entry of this.addresses.values()) {
-      const since = await this.getAddressSince(entry);
-      if (since < globalSince) {
-        globalSince = since;
-      }
+    let globalDmSince = Math.floor(Date.now() / 1e3);
+    const entries = [...this.addresses.values()];
+    const sinceResults = await Promise.all(
+      entries.map(async (entry) => {
+        const [walletSince, dmSince] = await Promise.all([
+          this.getAddressSince(entry),
+          this.getAddressDmSince(entry)
+        ]);
+        return { walletSince, dmSince };
+      })
+    );
+    for (const { walletSince, dmSince } of sinceResults) {
+      if (walletSince < globalSince) globalSince = walletSince;
+      if (dmSince < globalDmSince) globalDmSince = dmSince;
     }
     const walletFilter = new Filter2();
     walletFilter.kinds = [
@@ -2986,6 +3069,7 @@ var MultiAddressTransportMux = class {
     const chatFilter = new Filter2();
     chatFilter.kinds = [EventKinds2.GIFT_WRAP];
     chatFilter["#p"] = allPubkeys;
+    chatFilter.since = globalDmSince;
     this.chatSubscriptionId = this.nostrClient.subscribe(chatFilter, {
       onEvent: (event) => {
         this.handleEvent({
@@ -3092,6 +3176,9 @@ var MultiAddressTransportMux = class {
     for (const entry of this.addresses.values()) {
       try {
         const pm = NIP172.unwrap(event, entry.keyManager);
+        if (event.created_at) {
+          this.updateLastDmEventTimestamp(entry, event.created_at);
+        }
         logger.debug("Mux", `Gift wrap decrypted by address ${entry.index}, sender: ${pm.senderPubkey?.slice(0, 16)}`);
         if (pm.senderPubkey === entry.nostrPubkey) {
           try {
@@ -3448,6 +3535,47 @@ var MultiAddressTransportMux = class {
       logger.debug("Mux", "Failed to save last event timestamp:", err);
     });
   }
+  updateLastDmEventTimestamp(entry, createdAt) {
+    if (!this.storage) return;
+    if (createdAt <= entry.lastDmEventTs) return;
+    entry.lastDmEventTs = createdAt;
+    const storageKey = `${STORAGE_KEYS_GLOBAL.LAST_DM_EVENT_TS}_${entry.nostrPubkey.slice(0, 16)}`;
+    this.storage.set(storageKey, createdAt.toString()).catch((err) => {
+      logger.debug("Mux", "Failed to save last DM event timestamp:", err);
+    });
+  }
+  async getAddressDmSince(entry) {
+    if (this.storage) {
+      const storageKey = `${STORAGE_KEYS_GLOBAL.LAST_DM_EVENT_TS}_${entry.nostrPubkey.slice(0, 16)}`;
+      try {
+        const stored = await this.storage.get(storageKey);
+        const parsed = stored ? parseInt(stored, 10) : NaN;
+        if (Number.isFinite(parsed)) {
+          entry.lastDmEventTs = parsed;
+          entry.fallbackDmSince = null;
+          return parsed;
+        } else if (entry.fallbackDmSince !== null) {
+          const ts = entry.fallbackDmSince;
+          entry.lastDmEventTs = ts;
+          entry.fallbackDmSince = null;
+          return ts;
+        }
+      } catch {
+        if (entry.fallbackDmSince !== null) {
+          const ts = entry.fallbackDmSince;
+          entry.lastDmEventTs = ts;
+          entry.fallbackDmSince = null;
+          return ts;
+        }
+      }
+    } else if (entry.fallbackDmSince !== null) {
+      const ts = entry.fallbackDmSince;
+      entry.lastDmEventTs = ts;
+      entry.fallbackDmSince = null;
+      return ts;
+    }
+    return Math.floor(Date.now() / 1e3);
+  }
   // ===========================================================================
   // Mux-level event system
   // ===========================================================================
@@ -3744,6 +3872,9 @@ var AddressTransportAdapter = class {
   setFallbackSince(sinceSeconds) {
     this.mux.setFallbackSince(this.addressIndex, sinceSeconds);
   }
+  setFallbackDmSince(sinceSeconds) {
+    this.mux.setFallbackDmSince(this.addressIndex, sinceSeconds);
+  }
   async fetchPendingEvents() {
   }
   onChatReady(handler) {
@@ -16493,6 +16624,9 @@ var Sphere = class _Sphere {
     const groupChat = _Sphere.resolveGroupChatConfig(options.groupChat, options.network);
     const market = _Sphere.resolveMarketConfig(options.market);
     const walletExists = await _Sphere.exists(options.storage);
+    if (options.dmSince != null && options.transport.setFallbackDmSince) {
+      options.transport.setFallbackDmSince(options.dmSince);
+    }
     if (walletExists) {
       const sphere2 = await _Sphere.load({
         storage: options.storage,