feat(guild): reorderCategories for category position updates

Support sidebar category drag-reorder by reassigning category channel
position indices with P2P CHANNEL_UPDATE gossip.

Co-authored-by: Cursor <[email protected]>

README.md

@@ -31,6 +31,7 @@ Create and load guilds in local storage, join peers on `pearcord:guild:{guildId}
 | `PearcordGuild#listChannels()` / `#listMembers()` | DB queries with thread meta attached |
 | `PearcordGuild#createChannel`, `#createCategory`, `#createThread`, `#createForumThread` | Channel tree |
 | `PearcordGuild#reorderChannelsInParent` | Reassign `position` for siblings under one category/root |
+| `PearcordGuild#reorderCategories` | Reassign `position` for category rows |
 | `PearcordGuild#updateChannel`, `#ingestChannel` | Upsert + thread meta |
 | `PearcordGuild#setMessageHandler(fn)` | Inbound `RPC.MESSAGE_CREATE` persistence hook (platform sets this) |
 | `PearcordGuild#gossip*` / `#sendVoiceMedia` / `#sendScreenMedia` | Outbound RPC (see `index.js` for full list) |

index.js

@@ -1118,6 +1118,27 @@ class PearcordGuild extends EventEmitter {
     return updated
   }
 
+  async reorderCategories ({ categoryIds = [] } = {}) {
+    if (!this.guild) throw new Error('no active guild')
+    const existing = await this.listChannels()
+    const categories = existing.filter((c) => c.type === CHANNEL_TYPES.CATEGORY)
+    if (!categoryIds.length || categoryIds.length !== categories.length) {
+      throw new Error('category order mismatch')
+    }
+    const byId = new Map(categories.map((c) => [c.id, c]))
+    for (const id of categoryIds) {
+      if (!byId.has(id)) throw new Error('invalid category id')
+    }
+    const updated = []
+    for (let i = 0; i < categoryIds.length; i++) {
+      const ch = byId.get(categoryIds[i])
+      if ((ch.position || 0) === i) continue
+      const merged = await this.updateChannel({ ...ch, position: i })
+      updated.push(merged)
+    }
+    return updated
+  }
+
   async listChannels () {
     if (!this.guild) return []
     const rows = await this.db.find(COLLECTIONS.CHANNELS, { guildId: this.guild.id })