@unicitylabs/sphere-sdk 0.2.5 → 0.3.0

package/dist/impl/browser/index.js

@@ -26,7 +26,17 @@ var STORAGE_KEYS_GLOBAL = {
   /** Active addresses registry (JSON: TrackedAddressesStorage) */
   TRACKED_ADDRESSES: "tracked_addresses",
   /** Last processed Nostr wallet event timestamp (unix seconds), keyed per pubkey */
-  LAST_WALLET_EVENT_TS: "last_wallet_event_ts"
+  LAST_WALLET_EVENT_TS: "last_wallet_event_ts",
+  /** Group chat: joined groups */
+  GROUP_CHAT_GROUPS: "group_chat_groups",
+  /** Group chat: messages */
+  GROUP_CHAT_MESSAGES: "group_chat_messages",
+  /** Group chat: members */
+  GROUP_CHAT_MEMBERS: "group_chat_members",
+  /** Group chat: processed event IDs for deduplication */
+  GROUP_CHAT_PROCESSED_EVENTS: "group_chat_processed_events",
+  /** Group chat: last used relay URL (stale data detection) */
+  GROUP_CHAT_RELAY_URL: "group_chat_relay_url"
 };
 var STORAGE_KEYS_ADDRESS = {
   /** Pending transfers for this address */
@@ -107,27 +117,33 @@ var TEST_ELECTRUM_URL = "wss://fulcrum.alpha.testnet.unicity.network:50004";
 var TEST_NOSTR_RELAYS = [
   "wss://nostr-relay.testnet.unicity.network"
 ];
+var DEFAULT_GROUP_RELAYS = [
+  "wss://sphere-relay.unicity.network"
+];
 var NETWORKS = {
   mainnet: {
     name: "Mainnet",
     aggregatorUrl: DEFAULT_AGGREGATOR_URL,
     nostrRelays: DEFAULT_NOSTR_RELAYS,
     ipfsGateways: DEFAULT_IPFS_GATEWAYS,
-    electrumUrl: DEFAULT_ELECTRUM_URL
+    electrumUrl: DEFAULT_ELECTRUM_URL,
+    groupRelays: DEFAULT_GROUP_RELAYS
   },
   testnet: {
     name: "Testnet",
     aggregatorUrl: TEST_AGGREGATOR_URL,
     nostrRelays: TEST_NOSTR_RELAYS,
     ipfsGateways: DEFAULT_IPFS_GATEWAYS,
-    electrumUrl: TEST_ELECTRUM_URL
+    electrumUrl: TEST_ELECTRUM_URL,
+    groupRelays: DEFAULT_GROUP_RELAYS
   },
   dev: {
     name: "Development",
     aggregatorUrl: DEV_AGGREGATOR_URL,
     nostrRelays: TEST_NOSTR_RELAYS,
     ipfsGateways: DEFAULT_IPFS_GATEWAYS,
-    electrumUrl: TEST_ELECTRUM_URL
+    electrumUrl: TEST_ELECTRUM_URL,
+    groupRelays: DEFAULT_GROUP_RELAYS
   }
 };
 var TIMEOUTS = {
@@ -547,29 +563,6 @@ var IndexedDBTokenStorageProvider = class {
     }
   }
   // =========================================================================
-  // Helper methods for individual token operations
-  // =========================================================================
-  async deleteToken(tokenId) {
-    if (this.db) {
-      await this.deleteFromStore(STORE_TOKENS, tokenId);
-    }
-  }
-  async saveToken(tokenId, tokenData) {
-    if (this.db) {
-      await this.putToStore(STORE_TOKENS, tokenId, { id: tokenId, data: tokenData });
-    }
-  }
-  async getToken(tokenId) {
-    if (!this.db) return null;
-    const result = await this.getFromStore(STORE_TOKENS, tokenId);
-    return result?.data ?? null;
-  }
-  async listTokenIds() {
-    if (!this.db) return [];
-    const tokens = await this.getAllFromStore(STORE_TOKENS);
-    return tokens.map((t) => t.id);
-  }
-  // =========================================================================
   // Private IndexedDB helpers
   // =========================================================================
   openDatabase() {
@@ -3851,9 +3844,13 @@ function mergeTxfData(local, remote) {
     remote._invalid ?? [],
     "tokenId"
   );
+  const localNametags = local._nametags ?? [];
+  const remoteNametags = remote._nametags ?? [];
+  const mergedNametags = mergeNametagsByName(localNametags, remoteNametags);
   const merged = {
     _meta: mergedMeta,
     _tombstones: mergedTombstones.length > 0 ? mergedTombstones : void 0,
+    _nametags: mergedNametags.length > 0 ? mergedNametags : void 0,
     _outbox: mergedOutbox.length > 0 ? mergedOutbox : void 0,
     _sent: mergedSent.length > 0 ? mergedSent : void 0,
     _invalid: mergedInvalid.length > 0 ? mergedInvalid : void 0,
@@ -3880,6 +3877,7 @@ function getTokenKeys(data) {
     "_sent",
     "_invalid",
     "_nametag",
+    "_nametags",
     "_mintOutbox",
     "_invalidatedNametags",
     "_integrity"
@@ -3887,7 +3885,7 @@ function getTokenKeys(data) {
   const keys = /* @__PURE__ */ new Set();
   for (const key of Object.keys(data)) {
     if (reservedKeys.has(key)) continue;
-    if (key.startsWith("archived-") || key.startsWith("_forked_") || key.startsWith("nametag-")) continue;
+    if (key.startsWith("archived-") || key.startsWith("_forked_")) continue;
     keys.add(key);
   }
   return keys;
@@ -3902,6 +3900,18 @@ function isTokenTombstoned(tokenId, localToken, remoteToken, tombstoneKeys) {
   void remoteToken;
   return false;
 }
+function mergeNametagsByName(local, remote) {
+  const seen = /* @__PURE__ */ new Map();
+  for (const item of local) {
+    if (item.name) seen.set(item.name, item);
+  }
+  for (const item of remote) {
+    if (item.name && !seen.has(item.name)) {
+      seen.set(item.name, item);
+    }
+  }
+  return Array.from(seen.values());
+}
 function mergeArrayById(local, remote, idField) {
   const seen = /* @__PURE__ */ new Map();
   for (const item of local) {
@@ -4256,14 +4266,11 @@ var AsyncSerialQueue = class {
 var WriteBuffer = class {
   /** Full TXF data from save() calls — latest wins */
   txfData = null;
-  /** Individual token mutations: key -> { op: 'save'|'delete', data? } */
-  tokenMutations = /* @__PURE__ */ new Map();
   get isEmpty() {
-    return this.txfData === null && this.tokenMutations.size === 0;
+    return this.txfData === null;
   }
   clear() {
     this.txfData = null;
-    this.tokenMutations.clear();
   }
   /**
    * Merge another buffer's contents into this one (for rollback).
@@ -4273,11 +4280,6 @@ var WriteBuffer = class {
     if (other.txfData && !this.txfData) {
       this.txfData = other.txfData;
     }
-    for (const [id, mutation] of other.tokenMutations) {
-      if (!this.tokenMutations.has(id)) {
-        this.tokenMutations.set(id, mutation);
-      }
-    }
   }
 };
 
@@ -4317,9 +4319,6 @@ var IpfsStorageProvider = class {
   subscriptionClient = null;
   /** Unsubscribe function from subscription client */
   subscriptionUnsubscribe = null;
-  /** In-memory buffer for individual token save/delete calls */
-  tokenBuffer = /* @__PURE__ */ new Map();
-  deletedTokenIds = /* @__PURE__ */ new Set();
   /** Write-behind buffer: serializes flush / sync / shutdown */
   flushQueue = new AsyncSerialQueue();
   /** Pending mutations not yet flushed to IPFS */
@@ -4508,14 +4507,6 @@ var IpfsStorageProvider = class {
         metaUpdate.lastCid = this.remoteCid;
       }
       const updatedData = { ...data, _meta: metaUpdate };
-      for (const [tokenId, tokenData] of this.tokenBuffer) {
-        if (!this.deletedTokenIds.has(tokenId)) {
-          updatedData[tokenId] = tokenData;
-        }
-      }
-      for (const tokenId of this.deletedTokenIds) {
-        delete updatedData[tokenId];
-      }
       const { cid } = await this.httpClient.upload(updatedData);
       this.log(`Content uploaded: CID=${cid}`);
       const baseSeq = this.ipnsSequenceNumber > this.lastKnownRemoteSequence ? this.ipnsSequenceNumber : this.lastKnownRemoteSequence;
@@ -4554,7 +4545,6 @@ var IpfsStorageProvider = class {
         lastCid: cid,
         version: this.dataVersion
       });
-      this.deletedTokenIds.clear();
       this.emitEvent({
         type: "storage:saved",
         timestamp: Date.now(),
@@ -4666,7 +4656,6 @@ var IpfsStorageProvider = class {
       if (typeof remoteVersion === "number" && remoteVersion > this.dataVersion) {
         this.dataVersion = remoteVersion;
       }
-      this.populateTokenBuffer(data);
       this.emitEvent({
         type: "storage:loaded",
         timestamp: Date.now(),
@@ -4712,7 +4701,7 @@ var IpfsStorageProvider = class {
           this.emitEvent({ type: "sync:completed", timestamp: Date.now() });
           return {
             success: saveResult2.success,
-            merged: this.enrichWithTokenBuffer(localData),
+            merged: localData,
             added: 0,
             removed: 0,
             conflicts: 0,
@@ -4727,7 +4716,7 @@ var IpfsStorageProvider = class {
           this.emitEvent({ type: "sync:completed", timestamp: Date.now() });
           return {
             success: true,
-            merged: this.enrichWithTokenBuffer(localData),
+            merged: localData,
             added: 0,
             removed: 0,
             conflicts: 0
@@ -4750,7 +4739,7 @@ var IpfsStorageProvider = class {
         });
         return {
           success: saveResult.success,
-          merged: this.enrichWithTokenBuffer(merged),
+          merged,
           added,
           removed,
           conflicts,
@@ -4776,21 +4765,6 @@ var IpfsStorageProvider = class {
   // ---------------------------------------------------------------------------
   // Private Helpers
   // ---------------------------------------------------------------------------
-  /**
-   * Enrich TXF data with individually-buffered tokens before returning to caller.
-   * PaymentsModule.createStorageData() passes empty tokens (they're stored via
-   * saveToken()), but loadFromStorageData() needs them in the merged result.
-   */
-  enrichWithTokenBuffer(data) {
-    if (this.tokenBuffer.size === 0) return data;
-    const enriched = { ...data };
-    for (const [tokenId, tokenData] of this.tokenBuffer) {
-      if (!this.deletedTokenIds.has(tokenId)) {
-        enriched[tokenId] = tokenData;
-      }
-    }
-    return enriched;
-  }
   // ---------------------------------------------------------------------------
   // Optional Methods
   // ---------------------------------------------------------------------------
@@ -4820,8 +4794,6 @@ var IpfsStorageProvider = class {
     const result = await this._doSave(emptyData);
     if (result.success) {
       this.cache.clear();
-      this.tokenBuffer.clear();
-      this.deletedTokenIds.clear();
       await this.statePersistence.clear(this.ipnsName);
     }
     return result.success;
@@ -4832,27 +4804,6 @@ var IpfsStorageProvider = class {
       this.eventCallbacks.delete(callback);
     };
   }
-  async saveToken(tokenId, tokenData) {
-    this.pendingBuffer.tokenMutations.set(tokenId, { op: "save", data: tokenData });
-    this.tokenBuffer.set(tokenId, tokenData);
-    this.deletedTokenIds.delete(tokenId);
-    this.scheduleFlush();
-  }
-  async getToken(tokenId) {
-    if (this.deletedTokenIds.has(tokenId)) return null;
-    return this.tokenBuffer.get(tokenId) ?? null;
-  }
-  async listTokenIds() {
-    return Array.from(this.tokenBuffer.keys()).filter(
-      (id) => !this.deletedTokenIds.has(id)
-    );
-  }
-  async deleteToken(tokenId) {
-    this.pendingBuffer.tokenMutations.set(tokenId, { op: "delete" });
-    this.tokenBuffer.delete(tokenId);
-    this.deletedTokenIds.add(tokenId);
-    this.scheduleFlush();
-  }
   // ---------------------------------------------------------------------------
   // Public Accessors
   // ---------------------------------------------------------------------------
@@ -4944,26 +4895,6 @@ var IpfsStorageProvider = class {
       console.log(`[IPFS-Storage] ${message}`);
     }
   }
-  META_KEYS = /* @__PURE__ */ new Set([
-    "_meta",
-    "_tombstones",
-    "_outbox",
-    "_sent",
-    "_invalid",
-    "_nametag",
-    "_mintOutbox",
-    "_invalidatedNametags",
-    "_integrity"
-  ]);
-  populateTokenBuffer(data) {
-    this.tokenBuffer.clear();
-    this.deletedTokenIds.clear();
-    for (const key of Object.keys(data)) {
-      if (!this.META_KEYS.has(key)) {
-        this.tokenBuffer.set(key, data[key]);
-      }
-    }
-  }
 };
 
 // impl/browser/ipfs/browser-ipfs-state-persistence.ts
@@ -5202,6 +5133,20 @@ function resolveArrayConfig(defaults, replace, additional) {
   }
   return result;
 }
+function resolveGroupChatConfig(network, config) {
+  if (!config) return void 0;
+  if (config === true) {
+    const netConfig2 = getNetworkConfig(network);
+    return { relays: [...netConfig2.groupRelays] };
+  }
+  if (typeof config === "object" && config.enabled === false) {
+    return void 0;
+  }
+  const netConfig = getNetworkConfig(network);
+  return {
+    relays: config.relays ?? [...netConfig.groupRelays]
+  };
+}
 
 // impl/browser/index.ts
 if (typeof globalThis.Buffer === "undefined") {
@@ -5267,8 +5212,10 @@ function createBrowserProviders(config) {
     debug: config?.tokenSync?.ipfs?.useDht
     // reuse debug-like flag
   }) : void 0;
+  const groupChat = resolveGroupChatConfig(network, config?.groupChat);
   return {
     storage,
+    groupChat,
     transport: createNostrTransportProvider({
       relays: transportConfig.relays,
       timeout: transportConfig.timeout,