@kangwifi-pro/waliwa 1.0.0

package/src/groups/management.ts

@@ -0,0 +1,497 @@
+/**
+ * Waliwa - Group management
+ * API untuk create, modify, invite, kick, promote, demote group members
+ */
+
+import type {
+  WAGroupMetadata,
+  WAGroupParticipant,
+  GroupCreateOptions,
+  JIDLike,
+  WALogger
+} from '../types/index.js';
+import { encodeBinaryNode, BinaryNode } from '../core/binary.js';
+import { jidToString, parseJid } from '../utils/jid.js';
+import { generateStanzaId } from '../messages/message-encoder.js';
+import { SilentLogger } from '../utils/logger.js';
+
+// ============== Group Sender ==============
+
+export interface GroupManagerOptions {
+  /** Send raw bytes via WebSocket */
+  send: (data: Uint8Array) => void;
+  logger?: WALogger;
+  /** IQ response handler registry */
+  registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+}
+
+export class GroupManager {
+  private send: (data: Uint8Array) => void;
+  private logger: WALogger;
+  private registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+
+  constructor(opts: GroupManagerOptions) {
+    this.send = opts.send;
+    this.logger = opts.logger ?? new SilentLogger();
+    this.registerIqHandler = opts.registerIqHandler;
+  }
+
+  /**
+   * Create new group
+   */
+  async createGroup(opts: GroupCreateOptions): Promise<WAGroupMetadata> {
+    const id = generateStanzaId();
+    this.logger.debug(`Creating group "${opts.subject}" with ${opts.participants.length} participants`);
+
+    const participantNodes = opts.participants.map(p => ({
+      tag: 'participant',
+      attrs: { jid: jidToString(p) }
+    }));
+
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: 'g.us',
+        id
+      },
+      content: [
+        {
+          tag: 'create',
+          attrs: {
+            subject: opts.subject
+          },
+          content: participantNodes
+        }
+      ]
+    };
+
+    return this.sendIqAndWait(node, id, 30000).then(response => this.parseGroupMetadata(response));
+  }
+
+  /**
+   * Get group metadata
+   */
+  async getGroupMetadata(groupJid: JIDLike): Promise<WAGroupMetadata> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'get',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'query',
+          attrs: { request: 'interactive' }
+        }
+      ]
+    };
+
+    return this.sendIqAndWait(node, id, 15000).then(response => this.parseGroupMetadata(response));
+  }
+
+  /**
+   * Update group subject (name)
+   */
+  async updateGroupSubject(groupJid: JIDLike, subject: string): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'subject',
+          attrs: { subject }
+        }
+      ]
+    };
+
+    await this.sendIqAndWait(node, id, 10000);
+  }
+
+  /**
+   * Update group description
+   */
+  async updateGroupDescription(groupJid: JIDLike, desc: string): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'description',
+          attrs: {},
+          content: desc
+        }
+      ]
+    };
+
+    await this.sendIqAndWait(node, id, 10000);
+  }
+
+  /**
+   * Add participants to group
+   */
+  async addParticipants(groupJid: JIDLike, participants: JIDLike[]): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'add',
+          attrs: {},
+          content: participants.map(p => ({
+            tag: 'participant',
+            attrs: { jid: jidToString(p) }
+          }))
+        }
+      ]
+    };
+
+    await this.sendIqAndWait(node, id, 15000);
+  }
+
+  /**
+   * Remove participants from group
+   */
+  async removeParticipants(groupJid: JIDLike, participants: JIDLike[]): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'remove',
+          attrs: {},
+          content: participants.map(p => ({
+            tag: 'participant',
+            attrs: { jid: jidToString(p) }
+          }))
+        }
+      ]
+    };
+
+    await this.sendIqAndWait(node, id, 15000);
+  }
+
+  /**
+   * Promote participants jadi admin
+   */
+  async promoteParticipants(groupJid: JIDLike, participants: JIDLike[]): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'promote',
+          attrs: {},
+          content: participants.map(p => ({
+            tag: 'participant',
+            attrs: { jid: jidToString(p) }
+          }))
+        }
+      ]
+    };
+
+    await this.sendIqAndWait(node, id, 15000);
+  }
+
+  /**
+   * Demote admin kembali jadi member
+   */
+  async demoteParticipants(groupJid: JIDLike, participants: JIDLike[]): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'demote',
+          attrs: {},
+          content: participants.map(p => ({
+            tag: 'participant',
+            attrs: { jid: jidToString(p) }
+          }))
+        }
+      ]
+    };
+
+    await this.sendIqAndWait(node, id, 15000);
+  }
+
+  /**
+   * Leave group
+   */
+  async leaveGroup(groupJid: JIDLike): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: 'g.us',
+        id
+      },
+      content: [
+        {
+          tag: 'leave',
+          attrs: {},
+          content: [{
+            tag: 'group',
+            attrs: { id: jidToString(groupJid) }
+          }]
+        }
+      ]
+    };
+
+    await this.sendIqAndWait(node, id, 10000);
+  }
+
+  /**
+   * Get invite code untuk group
+   */
+  async getInviteCode(groupJid: JIDLike): Promise<string> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'get',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'invite',
+          attrs: {}
+        }
+      ]
+    };
+
+    const response = await this.sendIqAndWait(node, id, 10000);
+    const inviteNode = response.content as any[];
+    const invite = inviteNode?.find(c => c.tag === 'invite');
+    return invite?.attrs?.code ?? '';
+  }
+
+  /**
+   * Revoke invite code (generate new)
+   */
+  async revokeInviteCode(groupJid: JIDLike): Promise<string> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'invite',
+          attrs: { action: 'revoke' }
+        }
+      ]
+    };
+
+    const response = await this.sendIqAndWait(node, id, 10000);
+    const inviteNode = (response.content as any[])?.find(c => c.tag === 'invite');
+    return inviteNode?.attrs?.code ?? '';
+  }
+
+  /**
+   * Join group via invite code
+   */
+  async joinGroupViaCode(code: string): Promise<JIDLike> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: 'g.us',
+        id
+      },
+      content: [
+        {
+          tag: 'join',
+          attrs: {
+            code,
+            reason: 'invite'
+          }
+        }
+      ]
+    };
+
+    const response = await this.sendIqAndWait(node, id, 15000);
+    const groupNode = (response.content as any[])?.find(c => c.tag === 'group');
+    return groupNode?.attrs?.jid ?? '';
+  }
+
+  /**
+   * Set group settings: restrict (only admins can send messages)
+   */
+  async setGroupRestrict(groupJid: JIDLike, restrict: boolean): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'announce',
+          attrs: {
+            type: restrict ? 'restrict' : 'unrestrict'
+          }
+        }
+      ]
+    };
+
+    await this.sendIqAndWait(node, id, 10000);
+  }
+
+  /**
+   * Set group settings: announce mode (only admins can edit info)
+   */
+  async setGroupAnnounce(groupJid: JIDLike, announce: boolean): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(groupJid),
+        id
+      },
+      content: [
+        {
+          tag: 'info',
+          attrs: {
+            type: announce ? 'announce' : 'unannounce'
+          }
+        }
+      ]
+    };
+
+    await this.sendIqAndWait(node, id, 10000);
+  }
+
+  // ============== Internal: Send IQ + Wait ==============
+
+  private sendIqAndWait(node: BinaryNode, id: string, timeoutMs: number): Promise<BinaryNode> {
+    return new Promise<BinaryNode>((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error(`IQ ${id} timeout after ${timeoutMs}ms`));
+      }, timeoutMs);
+
+      this.registerIqHandler(id, (response: BinaryNode) => {
+        clearTimeout(timeout);
+        const type = response.attrs?.type;
+        if (type === 'error') {
+          const errorNode = (response.content as any[])?.find(c => c.tag === 'error');
+          reject(new Error(errorNode?.attrs?.text ?? 'Unknown group operation error'));
+        } else {
+          resolve(response);
+        }
+      });
+
+      try {
+        this.send(encodeBinaryNode(node));
+      } catch (err: any) {
+        clearTimeout(timeout);
+        reject(err);
+      }
+    });
+  }
+
+  // ============== Parser ==============
+
+  private parseGroupMetadata(node: BinaryNode): WAGroupMetadata {
+    const groupNode = node.tag === 'group' ? node :
+      (Array.isArray(node.content) ? node.content.find(c => c?.tag === 'group') : null);
+
+    if (!groupNode) {
+      throw new Error('Group node not found in response');
+    }
+
+    const attrs = groupNode.attrs || {};
+    const participants: WAGroupParticipant[] = [];
+
+    if (Array.isArray(groupNode.content)) {
+      for (const child of groupNode.content) {
+        if (child?.tag === 'participant') {
+          const pAttrs = child.attrs || {};
+          participants.push({
+            id: pAttrs.jid,
+            isAdmin: pAttrs.type === 'admin',
+            isSuperAdmin: pAttrs.type === 'superadmin',
+            role: pAttrs.type
+          });
+        }
+      }
+    }
+
+    return {
+      id: attrs.id,
+      subject: attrs.subject,
+      subjectOwner: attrs.subject_owner,
+      subjectTime: attrs.subject_time ? parseInt(attrs.subject_time, 10) : undefined,
+      desc: attrs.desc,
+      descOwner: attrs.desc_owner,
+      descTime: attrs.desc_time ? parseInt(attrs.desc_time, 10) : undefined,
+      creation: attrs.creation ? parseInt(attrs.creation, 10) : undefined,
+      owner: attrs.owner,
+      participants,
+      restrict: attrs.restrict === 'true',
+      announce: attrs.announce === 'true',
+      isCommunity: attrs.is_community === 'true',
+      isParentGroup: attrs.is_parent_group === 'true',
+      linkedParent: attrs.linked_parent,
+      ephemeralSetting: attrs.ephemeral ? parseInt(attrs.ephemeral, 10) : undefined
+    };
+  }
+}
+
+// ============== Helper: Build invite link ==============
+
+/**
+ * Build WhatsApp invite URL dari code
+ */
+export function buildInviteLink(code: string): string {
+  return `https://chat.whatsapp.com/${code}`;
+}
+
+/**
+ * Parse invite code dari URL
+ */
+export function parseInviteLink(url: string): string | null {
+  const match = url.match(/chat\.whatsapp\.com\/([A-Za-z0-9]+)/);
+  return match ? match[1] : null;
+}