@unicitylabs/sphere-sdk 0.6.0 → 0.6.2

package/README.md

@@ -409,6 +409,12 @@ const privateGroup = await gc.createGroup({
   visibility: GroupVisibility.PRIVATE,
 });
 
+// Create a write-restricted group (only admins/writers can post)
+const announcements = await gc.createGroup({
+  name: 'Announcements',
+  writeRestricted: true,
+});
+
 // Discover and join
 const available = await gc.fetchAvailableGroups(); // public groups on relay
 await gc.joinGroup(group.id);
@@ -455,6 +461,7 @@ const members = gc.getMembers(group.id);
 gc.isCurrentUserAdmin(group.id);     // boolean
 gc.isCurrentUserModerator(group.id); // boolean
 await gc.canModerateGroup(group.id); // includes relay admin check
+gc.canWriteToGroup(group.id);       // false if write-restricted and not admin/moderator
 
 // Moderate (requires admin/moderator role)
 await gc.kickUser(group.id, userPubkey, 'reason');
@@ -487,6 +494,7 @@ interface GroupData {
   name: string;
   description?: string;
   visibility: GroupVisibility;  // 'PUBLIC' | 'PRIVATE'
+  writeRestricted?: boolean;   // Only admins and moderators can post
   memberCount?: number;
   unreadCount?: number;
   lastMessageTime?: number;

package/dist/core/index.cjs

@@ -8401,6 +8401,12 @@ var CommunicationsModule = class {
     this.unsubscribeComposing = deps.transport.onComposing?.((indicator) => {
       this.handleComposingIndicator(indicator);
     }) ?? null;
+    if (deps.transport.onChatReady) {
+      deps.transport.onChatReady(() => {
+        const conversations = this.getConversations();
+        deps.emitEvent("communications:ready", { conversationCount: conversations.size });
+      });
+    }
   }
   /**
    * Load messages from storage.
@@ -9043,6 +9049,7 @@ var GroupChatModule = class {
         await this.subscribeToJoinedGroups();
       }
       this.deps.emitEvent("groupchat:connection", { connected: true });
+      this.deps.emitEvent("groupchat:ready", { groupCount: this.groups.size });
     } catch (error) {
       logger.error("GroupChat", "Failed to connect to relays", error);
       this.deps.emitEvent("groupchat:connection", { connected: false });
@@ -9161,17 +9168,23 @@ var GroupChatModule = class {
     const group = this.groups.get(groupId);
     if (!group) return;
     if (event.kind === NIP29_KINDS.GROUP_METADATA) {
-      if (!event.content || event.content.trim() === "") return;
-      try {
-        const metadata = JSON.parse(event.content);
-        group.name = metadata.name || group.name;
-        group.description = metadata.about || group.description;
-        group.picture = metadata.picture || group.picture;
-        group.updatedAt = event.created_at * 1e3;
-        this.groups.set(groupId, group);
-        this.persistGroups();
-      } catch {
+      if (event.content && event.content.trim()) {
+        try {
+          const metadata = JSON.parse(event.content);
+          group.name = metadata.name || group.name;
+          group.description = metadata.about || group.description;
+          group.picture = metadata.picture || group.picture;
+          if (metadata["write-restricted"] === true) group.writeRestricted = true;
+          else group.writeRestricted = void 0;
+        } catch {
+        }
       }
+      for (const tag of event.tags) {
+        if (tag[0] === "write-restricted") group.writeRestricted = true;
+      }
+      group.updatedAt = event.created_at * 1e3;
+      this.groups.set(groupId, group);
+      this.persistGroups();
     } else if (event.kind === NIP29_KINDS.GROUP_MEMBERS) {
       this.updateMembersFromEvent(groupId, event);
     } else if (event.kind === NIP29_KINDS.GROUP_ADMINS) {
@@ -9475,7 +9488,8 @@ var GroupChatModule = class {
           picture: options.picture,
           closed: true,
           private: isPrivate,
-          hidden: isPrivate
+          hidden: isPrivate,
+          ...options.writeRestricted ? { "write-restricted": true } : {}
         })
       });
       if (!eventId) return null;
@@ -9670,6 +9684,19 @@ var GroupChatModule = class {
   getMessages(groupId) {
     return (this.messages.get(groupId) || []).sort((a, b) => a.timestamp - b.timestamp);
   }
+  getMessagesPage(groupId, options) {
+    const limit = options?.limit ?? 20;
+    const before = options?.before ?? Infinity;
+    const groupMessages = this.messages.get(groupId) ?? [];
+    const filtered = groupMessages.filter((m) => m.timestamp < before).sort((a, b) => b.timestamp - a.timestamp);
+    const page = filtered.slice(0, limit);
+    return {
+      messages: page.reverse(),
+      // chronological order
+      hasMore: filtered.length > limit,
+      oldestTimestamp: page.length > 0 ? page[0].timestamp : null
+    };
+  }
   getMembers(groupId) {
     return (this.members.get(groupId) || []).sort((a, b) => a.joinedAt - b.joinedAt);
   }
@@ -9776,6 +9803,17 @@ var GroupChatModule = class {
     const admins = await this.fetchRelayAdmins();
     return admins.has(myPubkey);
   }
+  /**
+   * Check if current user can write messages to a group.
+   * For write-restricted groups, only admins/moderators can post.
+   * For normal groups, any member can post.
+   */
+  canWriteToGroup(groupId) {
+    const group = this.groups.get(groupId);
+    if (!group) return false;
+    if (!group.writeRestricted) return true;
+    return this.isCurrentUserModerator(groupId);
+  }
   getCurrentUserRole(groupId) {
     const myPubkey = this.getMyPublicKey();
     if (!myPubkey) return null;
@@ -10150,6 +10188,7 @@ var GroupChatModule = class {
       let description;
       let picture;
       let isPrivate = false;
+      let writeRestricted = false;
       if (event.content && event.content.trim()) {
         try {
           const metadata = JSON.parse(event.content);
@@ -10157,6 +10196,7 @@ var GroupChatModule = class {
           description = metadata.about || metadata.description;
           picture = metadata.picture;
           isPrivate = metadata.private === true;
+          if (metadata["write-restricted"] === true) writeRestricted = true;
         } catch {
         }
       }
@@ -10166,6 +10206,7 @@ var GroupChatModule = class {
         if (tag[0] === "picture" && tag[1]) picture = tag[1];
         if (tag[0] === "private") isPrivate = true;
         if (tag[0] === "public" && tag[1] === "false") isPrivate = true;
+        if (tag[0] === "write-restricted") writeRestricted = true;
       }
       return {
         id: groupId,
@@ -10174,6 +10215,7 @@ var GroupChatModule = class {
         description,
         picture,
         visibility: isPrivate ? GroupVisibility.PRIVATE : GroupVisibility.PUBLIC,
+        writeRestricted: writeRestricted || void 0,
         createdAt: event.created_at * 1e3
       };
     } catch {