@unicitylabs/sphere-sdk 0.4.0 → 0.4.3

package/dist/index.d.cts

@@ -3063,6 +3063,13 @@ declare class PaymentsModule {
      * Remove all nametag data from memory and storage.
      */
     clearNametag(): Promise<void>;
+    /**
+     * Reload nametag data from storage providers into memory.
+     *
+     * Used as a recovery mechanism when `this.nametags` is unexpectedly empty
+     * (e.g., wiped by sync or race condition) but nametag data exists in storage.
+     */
+    private reloadNametagsFromStorage;
     /**
      * Mint a nametag token on-chain (like Sphere wallet and lottery)
      * This creates the nametag token required for receiving tokens via PROXY addresses

package/dist/index.d.ts

@@ -3063,6 +3063,13 @@ declare class PaymentsModule {
      * Remove all nametag data from memory and storage.
      */
     clearNametag(): Promise<void>;
+    /**
+     * Reload nametag data from storage providers into memory.
+     *
+     * Used as a recovery mechanism when `this.nametags` is unexpectedly empty
+     * (e.g., wiped by sync or race condition) but nametag data exists in storage.
+     */
+    private reloadNametagsFromStorage;
     /**
      * Mint a nametag token on-chain (like Sphere wallet and lottery)
      * This creates the nametag token required for receiving tokens via PROXY addresses

package/dist/index.js

@@ -6575,6 +6575,29 @@ var PaymentsModule = class _PaymentsModule {
     this.nametags = [];
     await this.save();
   }
+  /**
+   * Reload nametag data from storage providers into memory.
+   *
+   * Used as a recovery mechanism when `this.nametags` is unexpectedly empty
+   * (e.g., wiped by sync or race condition) but nametag data exists in storage.
+   */
+  async reloadNametagsFromStorage() {
+    const providers = this.getTokenStorageProviders();
+    for (const [, provider] of providers) {
+      try {
+        const result = await provider.load();
+        if (result.success && result.data) {
+          const parsed = parseTxfStorageData(result.data);
+          if (parsed.nametags.length > 0) {
+            this.nametags = parsed.nametags;
+            this.log(`Reloaded ${parsed.nametags.length} nametag(s) from storage`);
+            return;
+          }
+        }
+      } catch {
+      }
+    }
+  }
   /**
    * Mint a nametag token on-chain (like Sphere wallet and lottery)
    * This creates the nametag token required for receiving tokens via PROXY addresses
@@ -6699,11 +6722,15 @@ var PaymentsModule = class _PaymentsModule {
       const localData = await this.createStorageData();
       let totalAdded = 0;
       let totalRemoved = 0;
+      const savedNametags = [...this.nametags];
       for (const [providerId, provider] of providers) {
         try {
           const result = await provider.sync(localData);
           if (result.success && result.merged) {
             this.loadFromStorageData(result.merged);
+            if (this.nametags.length === 0 && savedNametags.length > 0) {
+              this.nametags = savedNametags;
+            }
             totalAdded += result.added;
             totalRemoved += result.removed;
           }
@@ -7091,7 +7118,12 @@ var PaymentsModule = class _PaymentsModule {
     let nametagTokens = [];
     if (addressScheme === AddressScheme.PROXY) {
       const { ProxyAddress } = await import("@unicitylabs/state-transition-sdk/lib/address/ProxyAddress");
-      const proxyNametag = this.getNametag();
+      let proxyNametag = this.getNametag();
+      if (!proxyNametag?.token) {
+        this.log("Nametag missing in memory, attempting reload from storage...");
+        await this.reloadNametagsFromStorage();
+        proxyNametag = this.getNametag();
+      }
       if (!proxyNametag?.token) {
         throw new Error("Cannot finalize PROXY transfer - no nametag token");
       }
@@ -7696,13 +7728,14 @@ var CommunicationsModule = class {
    */
   async sendDM(recipient, content) {
     this.ensureInitialized();
-    const recipientPubkey = await this.resolveRecipient(recipient);
-    const eventId = await this.deps.transport.sendMessage(recipientPubkey, content);
+    const resolved = await this.resolveRecipient(recipient);
+    const eventId = await this.deps.transport.sendMessage(resolved.pubkey, content);
     const message = {
       id: eventId,
       senderPubkey: this.deps.identity.chainPubkey,
       senderNametag: this.deps.identity.nametag,
-      recipientPubkey,
+      recipientPubkey: resolved.pubkey,
+      ...resolved.nametag ? { recipientNametag: resolved.nametag } : {},
       content,
       timestamp: Date.now(),
       isRead: false
@@ -7820,12 +7853,12 @@ var CommunicationsModule = class {
    */
   async sendComposingIndicator(recipientPubkeyOrNametag) {
     this.ensureInitialized();
-    const recipientPubkey = await this.resolveRecipient(recipientPubkeyOrNametag);
+    const resolved = await this.resolveRecipient(recipientPubkeyOrNametag);
     const content = JSON.stringify({
       senderNametag: this.deps.identity.nametag,
       expiresIn: 3e4
     });
-    await this.deps.transport.sendComposingIndicator?.(recipientPubkey, content);
+    await this.deps.transport.sendComposingIndicator?.(resolved.pubkey, content);
   }
   /**
    * Subscribe to incoming composing indicators
@@ -8013,13 +8046,14 @@ var CommunicationsModule = class {
   // ===========================================================================
   async resolveRecipient(recipient) {
     if (recipient.startsWith("@")) {
-      const pubkey = await this.deps.transport.resolveNametag?.(recipient.slice(1));
+      const nametag = recipient.slice(1);
+      const pubkey = await this.deps.transport.resolveNametag?.(nametag);
       if (!pubkey) {
         throw new Error(`Nametag not found: ${recipient}`);
       }
-      return pubkey;
+      return { pubkey, nametag };
     }
-    return recipient;
+    return { pubkey: recipient };
   }
   ensureInitialized() {
     if (!this.deps) {
@@ -12704,14 +12738,17 @@ var Sphere = class _Sphere {
       if (!wasConnected) {
         await storage.connect();
       }
-      const mnemonic = await storage.get(STORAGE_KEYS_GLOBAL.MNEMONIC);
-      if (mnemonic) return true;
-      const masterKey = await storage.get(STORAGE_KEYS_GLOBAL.MASTER_KEY);
-      if (masterKey) return true;
-      if (!wasConnected) {
-        await storage.disconnect();
+      try {
+        const mnemonic = await storage.get(STORAGE_KEYS_GLOBAL.MNEMONIC);
+        if (mnemonic) return true;
+        const masterKey = await storage.get(STORAGE_KEYS_GLOBAL.MASTER_KEY);
+        if (masterKey) return true;
+        return false;
+      } finally {
+        if (!wasConnected) {
+          await storage.disconnect();
+        }
       }
-      return false;
     } catch {
       return false;
     }
@@ -12845,6 +12882,9 @@ var Sphere = class _Sphere {
     if (await _Sphere.exists(options.storage)) {
       throw new Error("Wallet already exists. Use Sphere.load() or Sphere.clear() first.");
     }
+    if (!options.storage.isConnected()) {
+      await options.storage.connect();
+    }
     _Sphere.configureTokenRegistry(options.storage, options.network);
     const groupChatConfig = _Sphere.resolveGroupChatConfig(options.groupChat, options.network);
     const marketConfig = _Sphere.resolveMarketConfig(options.market);
@@ -12896,6 +12936,9 @@ var Sphere = class _Sphere {
       marketConfig
     );
     sphere._password = options.password ?? null;
+    if (!options.storage.isConnected()) {
+      await options.storage.connect();
+    }
     await sphere.loadIdentityFromStorage();
     await sphere.initializeProviders();
     await sphere.initializeModules();
@@ -13034,45 +13077,22 @@ var Sphere = class _Sphere {
       await _Sphere.instance.destroy();
       console.log("[Sphere.clear] Sphere instance destroyed");
     }
+    console.log("[Sphere.clear] Clearing L1 vesting cache...");
     await vestingClassifier.destroy();
-    if (typeof indexedDB !== "undefined" && typeof indexedDB.databases === "function") {
-      console.log("[Sphere.clear] Deleting all sphere IndexedDB databases...");
-      try {
-        const dbs = await Promise.race([
-          indexedDB.databases(),
-          new Promise(
-            (_, reject) => setTimeout(() => reject(new Error("timeout")), 2e3)
-          )
-        ]);
-        const sphereDbs = dbs.filter((db) => db.name?.startsWith("sphere"));
-        if (sphereDbs.length > 0) {
-          await Promise.all(sphereDbs.map(
-            (db) => new Promise((resolve) => {
-              const req = indexedDB.deleteDatabase(db.name);
-              req.onsuccess = () => {
-                console.log(`[Sphere.clear] Deleted ${db.name}`);
-                resolve();
-              };
-              req.onerror = () => resolve();
-              req.onblocked = () => {
-                console.warn(`[Sphere.clear] deleteDatabase blocked: ${db.name}`);
-                resolve();
-              };
-            })
-          ));
-        }
-        console.log("[Sphere.clear] IndexedDB cleanup done");
-      } catch {
-        console.warn("[Sphere.clear] IndexedDB enumeration failed");
-      }
-    }
+    console.log("[Sphere.clear] Yielding 50ms for IDB transaction settlement...");
+    await new Promise((r) => setTimeout(r, 50));
     if (tokenStorage?.clear) {
+      console.log("[Sphere.clear] Clearing token storage...");
       try {
         await tokenStorage.clear();
+        console.log("[Sphere.clear] Token storage cleared");
       } catch (err) {
         console.warn("[Sphere.clear] Token storage clear failed:", err);
       }
+    } else {
+      console.log("[Sphere.clear] No token storage provider to clear");
     }
+    console.log("[Sphere.clear] Clearing KV storage...");
     if (!storage.isConnected()) {
       try {
         await storage.connect();
@@ -13081,7 +13101,11 @@ var Sphere = class _Sphere {
     }
     if (storage.isConnected()) {
       await storage.clear();
+      console.log("[Sphere.clear] KV storage cleared");
+    } else {
+      console.log("[Sphere.clear] KV storage not connected, skipping");
     }
+    console.log("[Sphere.clear] Done");
   }
   /**
    * Get current instance
@@ -13929,8 +13953,12 @@ var Sphere = class _Sphere {
     await this._storage.set(STORAGE_KEYS_GLOBAL.CURRENT_ADDRESS_INDEX, index.toString());
     this._storage.setIdentity(this._identity);
     await this._transport.setIdentity(this._identity);
-    for (const provider of this._tokenStorageProviders.values()) {
+    console.log(`[Sphere] switchToAddress(${index}): re-initializing ${this._tokenStorageProviders.size} token storage provider(s)`);
+    for (const [providerId, provider] of this._tokenStorageProviders.entries()) {
+      console.log(`[Sphere] switchToAddress(${index}): shutdown provider=${providerId}`);
+      await provider.shutdown();
       provider.setIdentity(this._identity);
+      console.log(`[Sphere] switchToAddress(${index}): initialize provider=${providerId}`);
       await provider.initialize();
     }
     await this.reinitializeModulesForNewAddress();
@@ -14012,6 +14040,9 @@ var Sphere = class _Sphere {
     await this._communications.load();
     await this._groupChat?.load();
     await this._market?.load();
+    this._payments.sync().catch((err) => {
+      console.warn("[Sphere] Post-switch sync failed:", err);
+    });
   }
   /**
    * Derive address at a specific index