@kangwifi-pro/waliwa 1.0.0

package/src/advanced/features.ts

@@ -0,0 +1,817 @@
+/**
+ * Waliwa - Advanced features
+ * Polls, Newsletter, Status/Stories, Business Profile, Labels, Catalog
+ */
+
+import type {
+  JIDLike,
+  WALogger,
+  WAMessage,
+  WAMessageKey,
+  PollUpdate
+} from '../types/index.js';
+import { encodeBinaryNode, BinaryNode } from '../core/binary.js';
+import { jidToString } from '../utils/jid.js';
+import { generateStanzaId, generateMessageId } from '../messages/message-encoder.js';
+import { SilentLogger } from '../utils/logger.js';
+
+// ============== Poll Manager ==============
+
+export interface PollOptions {
+  name: string;
+  values: string[];
+  /** Max selectable options per user (default: 1 = single choice) */
+  selectableCounts?: number[];
+  /** Allow multiple answers */
+  multipleAnswers?: boolean;
+}
+
+export interface PollVote {
+  /** JID of voter */
+  voter: JIDLike;
+  /** Selected option indices */
+  selectedOptions: number[];
+  /** Timestamp */
+  timestamp: number;
+}
+
+export class PollManager {
+  private send: (data: Uint8Array) => void;
+  private registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+  private logger: WALogger;
+  private voteListeners: Map<string, (vote: PollVote) => void> = new Map();
+
+  constructor(opts: {
+    send: (data: Uint8Array) => void;
+    registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+    logger?: WALogger;
+  }) {
+    this.send = opts.send;
+    this.registerIqHandler = opts.registerIqHandler;
+    this.logger = opts.logger ?? new SilentLogger();
+  }
+
+  /**
+   * Create poll message
+   */
+  async createPoll(jid: JIDLike, opts: PollOptions): Promise<WAMessageKey> {
+    const messageId = generateMessageId();
+    const selectableCounts = opts.selectableCounts ?? [opts.multipleAnswers ? opts.values.length : 1];
+
+    const pollNode: BinaryNode = {
+      tag: 'message',
+      attrs: {
+        to: jidToString(jid),
+        type: 'poll',
+        id: messageId
+      },
+      content: [
+        {
+          tag: 'pollCreationMessage',
+          attrs: {
+            name: opts.name,
+            selectableOptionsCount: JSON.stringify(selectableCounts)
+          },
+          content: opts.values.map((value, idx) => ({
+            tag: 'option',
+            attrs: {
+              index: idx.toString(),
+              name: value
+            }
+          }))
+        }
+      ]
+    };
+
+    const data = encodeBinaryNode(pollNode);
+    this.send(data);
+    return {
+      remoteJid: jid,
+      fromMe: true,
+      id: messageId
+    };
+  }
+
+  /**
+   * Vote on existing poll
+   */
+  async voteOnPoll(
+    pollKey: WAMessageKey,
+    selectedOptions: number[]
+  ): Promise<void> {
+    const messageId = generateMessageId();
+    const voteNode: BinaryNode = {
+      tag: 'message',
+      attrs: {
+        to: jidToString(pollKey.remoteJid),
+        type: 'poll_vote',
+        id: messageId
+      },
+      content: [
+        {
+          tag: 'pollVoteMessage',
+          attrs: {
+            pollCreationMessageKey: JSON.stringify({
+              remoteJid: jidToString(pollKey.remoteJid),
+              fromMe: pollKey.fromMe,
+              id: pollKey.id
+            })
+          },
+          content: selectedOptions.map(idx => ({
+            tag: 'selectedOption',
+            attrs: { index: idx.toString() }
+          }))
+        }
+      ]
+    };
+    this.send(encodeBinaryNode(voteNode));
+  }
+
+  /**
+   * Listen for poll votes
+   */
+  onVote(pollMessageId: string, handler: (vote: PollVote) => void): void {
+    this.voteListeners.set(pollMessageId, handler);
+  }
+
+  /**
+   * Handle incoming poll vote
+   */
+  handlePollVote(node: BinaryNode): void {
+    if (node.tag !== 'message') return;
+    const attrs = node.attrs || {};
+    const from = attrs.from;
+
+    if (Array.isArray(node.content)) {
+      for (const child of node.content) {
+        if (child?.tag === 'pollVoteMessage') {
+          const pollKeyJson = child.attrs?.pollCreationMessageKey;
+          if (!pollKeyJson) continue;
+          try {
+            const pollKey = JSON.parse(pollKeyJson);
+            const listener = this.voteListeners.get(pollKey.id);
+            if (!listener) continue;
+
+            const selectedOptions = Array.isArray(child.content)
+              ? child.content.filter(c => c?.tag === 'selectedOption').map(c => parseInt(c.attrs?.index ?? '0', 10))
+              : [];
+            listener({
+              voter: from,
+              selectedOptions,
+              timestamp: Date.now()
+            });
+          } catch (err: any) {
+            this.logger.warn(`Failed to parse poll vote: ${err.message}`);
+          }
+        }
+      }
+    }
+  }
+}
+
+// ============== Newsletter Manager ==============
+
+export interface NewsletterMetadata {
+  id: JIDLike;
+  name: string;
+  description?: string;
+  subscribersCount: number;
+  state: 'active' | 'inactive';
+  createdAt?: number;
+  verification: 'verified' | 'unverified';
+}
+
+export class NewsletterManager {
+  private send: (data: Uint8Array) => void;
+  private registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+  private logger: WALogger;
+
+  constructor(opts: {
+    send: (data: Uint8Array) => void;
+    registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+    logger?: WALogger;
+  }) {
+    this.send = opts.send;
+    this.registerIqHandler = opts.registerIqHandler;
+    this.logger = opts.logger ?? new SilentLogger();
+  }
+
+  /**
+   * Create new newsletter
+   */
+  async create(name: string, description?: string): Promise<NewsletterMetadata> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: 's.whatsapp.net',
+        id
+      },
+      content: [
+        {
+          tag: 'newsletter',
+          attrs: {
+            name,
+            description: description ?? ''
+          }
+        }
+      ]
+    };
+    const response = await this.sendIqAndWait(node, id);
+    const nlNode = (response.content as any[])?.find(c => c.tag === 'newsletter');
+    return {
+      id: nlNode?.attrs?.id,
+      name,
+      description,
+      subscribersCount: 0,
+      state: 'active',
+      verification: 'unverified'
+    };
+  }
+
+  /**
+   * Subscribe ke newsletter
+   */
+  async subscribe(newsletterId: JIDLike): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(newsletterId),
+        id
+      },
+      content: [{
+        tag: 'subscribe',
+        attrs: { action: 'subscribe' }
+      }]
+    };
+    await this.sendIqAndWait(node, id);
+  }
+
+  /**
+   * Unsubscribe dari newsletter
+   */
+  async unsubscribe(newsletterId: JIDLike): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(newsletterId),
+        id
+      },
+      content: [{
+        tag: 'subscribe',
+        attrs: { action: 'unsubscribe' }
+      }]
+    };
+    await this.sendIqAndWait(node, id);
+  }
+
+  /**
+   * Mute newsletter
+   */
+  async mute(newsletterId: JIDLike): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: jidToString(newsletterId),
+        id
+      },
+      content: [{
+        tag: 'mute',
+        attrs: { action: 'mute' }
+      }]
+    };
+    await this.sendIqAndWait(node, id);
+  }
+
+  private sendIqAndWait(node: BinaryNode, id: string, timeoutMs: number = 15000): Promise<BinaryNode> {
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => reject(new Error(`IQ ${id} timeout`)), timeoutMs);
+      this.registerIqHandler(id, (response) => {
+        clearTimeout(timeout);
+        resolve(response);
+      });
+      this.send(encodeBinaryNode(node));
+    });
+  }
+}
+
+// ============== Status / Stories Manager ==============
+
+export interface StatusOptions {
+  /** Background color for text-only status */
+  backgroundColor?: string;
+  /** Font for text status */
+  font?: number;
+  /** Caption */
+  caption?: string;
+  /** Status expiration in seconds (default 86400 = 24h) */
+  expiration?: number;
+}
+
+export class StatusManager {
+  private send: (data: Uint8Array) => void;
+  private logger: WALogger;
+
+  constructor(opts: { send: (data: Uint8Array) => void; logger?: WALogger }) {
+    this.send = opts.send;
+    this.logger = opts.logger ?? new SilentLogger();
+  }
+
+  /**
+   * Upload text status
+   */
+  async sendTextStatus(text: string, opts: StatusOptions = {}): Promise<WAMessageKey> {
+    const messageId = generateMessageId();
+    const node: BinaryNode = {
+      tag: 'message',
+      attrs: {
+        to: 'status@broadcast',
+        type: 'text',
+        id: messageId
+      },
+      content: [
+        {
+          tag: 'textStatusMessage',
+          attrs: {
+            text,
+            backgroundColor: opts.backgroundColor ?? '#000000',
+            font: (opts.font ?? 0).toString(),
+            expiration: ((opts.expiration ?? 86400) * 1000).toString()
+          }
+        }
+      ]
+    };
+    this.send(encodeBinaryNode(node));
+    return {
+      remoteJid: 'status@broadcast',
+      fromMe: true,
+      id: messageId
+    };
+  }
+
+  /**
+   * Upload media status
+   */
+  async sendMediaStatus(
+    mediaType: 'image' | 'video',
+    mediaUrl: string,
+    opts: StatusOptions = {}
+  ): Promise<WAMessageKey> {
+    const messageId = generateMessageId();
+    const tag = mediaType === 'image' ? 'imageStatusMessage' : 'videoStatusMessage';
+    const node: BinaryNode = {
+      tag: 'message',
+      attrs: {
+        to: 'status@broadcast',
+        type: mediaType,
+        id: messageId
+      },
+      content: [
+        {
+          tag,
+          attrs: {
+            url: mediaUrl,
+            caption: opts.caption ?? '',
+            expiration: ((opts.expiration ?? 86400) * 1000).toString()
+          }
+        }
+      ]
+    };
+    this.send(encodeBinaryNode(node));
+    return {
+      remoteJid: 'status@broadcast',
+      fromMe: true,
+      id: messageId
+    };
+  }
+
+  /**
+   * Delete own status
+   */
+  async deleteStatus(statusId: string): Promise<void> {
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: 'status@broadcast',
+        id: `delstatus-${Date.now()}`
+      },
+      content: [{
+        tag: 'delete',
+        attrs: { id: statusId }
+      }]
+    };
+    this.send(encodeBinaryNode(node));
+  }
+
+  /**
+   * Get status views
+   */
+  async getStatusViews(statusId: string): Promise<JIDLike[]> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'get',
+        to: 'status@broadcast',
+        id
+      },
+      content: [{
+        tag: 'views',
+        attrs: { id: statusId }
+      }]
+    };
+    // Send and wait for response (simplified - real impl uses IQ handler registry)
+    this.send(encodeBinaryNode(node));
+    return [];
+  }
+}
+
+// ============== Business Profile Manager ==============
+
+export interface BusinessProfileOptions {
+  description?: string;
+  email?: string;
+  websites?: string[];
+  category?: string;
+  address?: string;
+  businessHours?: BusinessHours[];
+}
+
+export interface BusinessHours {
+  day: 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+  openTime: string; // "09:00"
+  closeTime: string; // "17:00"
+  mode: 'open' | 'closed' | 'by_appointment';
+}
+
+export class BusinessProfileManager {
+  private send: (data: Uint8Array) => void;
+  private registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+  private logger: WALogger;
+
+  constructor(opts: {
+    send: (data: Uint8Array) => void;
+    registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+    logger?: WALogger;
+  }) {
+    this.send = opts.send;
+    this.registerIqHandler = opts.registerIqHandler;
+    this.logger = opts.logger ?? new SilentLogger();
+  }
+
+  /**
+   * Update business profile
+   */
+  async update(opts: BusinessProfileOptions): Promise<void> {
+    const id = generateStanzaId();
+    const content: any[] = [];
+    if (opts.description) {
+      content.push({ tag: 'description', attrs: {}, content: opts.description });
+    }
+    if (opts.email) {
+      content.push({ tag: 'email', attrs: {}, content: opts.email });
+    }
+    if (opts.websites?.length) {
+      content.push({
+        tag: 'websites',
+        attrs: {},
+        content: opts.websites.map(w => ({ tag: 'website', attrs: { url: w } }))
+      });
+    }
+    if (opts.category) {
+      content.push({ tag: 'category', attrs: { name: opts.category } });
+    }
+    if (opts.address) {
+      content.push({ tag: 'address', attrs: {}, content: opts.address });
+    }
+    if (opts.businessHours?.length) {
+      content.push({
+        tag: 'business_hours',
+        attrs: {},
+        content: opts.businessHours.map(h => ({
+          tag: 'business_hours_config',
+          attrs: {
+            day_of_week: h.day,
+            mode: h.mode,
+            open_time: h.openTime,
+            close_time: h.closeTime
+          }
+        }))
+      });
+    }
+
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: 's.whatsapp.net',
+        id
+      },
+      content: [
+        {
+          tag: 'business_profile',
+          attrs: {},
+          content
+        }
+      ]
+    };
+    await this.sendIqAndWait(node, id);
+  }
+
+  /**
+   * Get business profile
+   */
+  async get(jid: JIDLike): Promise<BusinessProfileOptions | null> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'get',
+        to: jidToString(jid),
+        id
+      },
+      content: [{
+        tag: 'business_profile',
+        attrs: {}
+      }]
+    };
+    const response = await this.sendIqAndWait(node, id);
+    const profileNode = (response.content as any[])?.find(c => c.tag === 'business_profile');
+    if (!profileNode) return null;
+
+    const result: BusinessProfileOptions = {};
+    if (Array.isArray(profileNode.content)) {
+      for (const child of profileNode.content) {
+        switch (child.tag) {
+          case 'description':
+            result.description = typeof child.content === 'string' ? child.content : '';
+            break;
+          case 'email':
+            result.email = typeof child.content === 'string' ? child.content : '';
+            break;
+          case 'category':
+            result.category = child.attrs?.name;
+            break;
+          case 'address':
+            result.address = typeof child.content === 'string' ? child.content : '';
+            break;
+        }
+      }
+    }
+    return result;
+  }
+
+  private sendIqAndWait(node: BinaryNode, id: string, timeoutMs: number = 15000): Promise<BinaryNode> {
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => reject(new Error(`IQ ${id} timeout`)), timeoutMs);
+      this.registerIqHandler(id, (response) => {
+        clearTimeout(timeout);
+        resolve(response);
+      });
+      this.send(encodeBinaryNode(node));
+    });
+  }
+}
+
+// ============== Catalog Manager ==============
+
+export interface CatalogItem {
+  id: string;
+  name: string;
+  description?: string;
+  price: number;
+  currency: string;
+  url?: string;
+  imageUrl?: string;
+}
+
+export class CatalogManager {
+  private send: (data: Uint8Array) => void;
+  private registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+  private logger: WALogger;
+
+  constructor(opts: {
+    send: (data: Uint8Array) => void;
+    registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+    logger?: WALogger;
+  }) {
+    this.send = opts.send;
+    this.registerIqHandler = opts.registerIqHandler;
+    this.logger = opts.logger ?? new SilentLogger();
+  }
+
+  /**
+   * Add product to catalog
+   */
+  async addProduct(item: Omit<CatalogItem, 'id'>): Promise<string> {
+    const id = generateStanzaId();
+    const productId = `prod-${Date.now()}`;
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: 's.whatsapp.net',
+        id
+      },
+      content: [{
+        tag: 'product',
+        attrs: {
+          id: productId,
+          name: item.name,
+          price: item.price.toString(),
+          currency: item.currency
+        },
+        content: [
+          item.description ? { tag: 'description', attrs: {}, content: item.description } : null,
+          item.url ? { tag: 'url', attrs: {}, content: item.url } : null
+        ].filter(Boolean) as any[]
+      }]
+    };
+    await this.sendIqAndWait(node, id);
+    return productId;
+  }
+
+  /**
+   * Get catalog for business account
+   */
+  async getCatalog(jid: JIDLike): Promise<CatalogItem[]> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'get',
+        to: jidToString(jid),
+        id
+      },
+      content: [{
+        tag: 'catalog',
+        attrs: {}
+      }]
+    };
+    const response = await this.sendIqAndWait(node, id);
+    const catalogNode = (response.content as any[])?.find(c => c.tag === 'catalog');
+    if (!catalogNode) return [];
+
+    const items: CatalogItem[] = [];
+    if (Array.isArray(catalogNode.content)) {
+      for (const child of catalogNode.content) {
+        if (child.tag === 'product') {
+          items.push({
+            id: child.attrs?.id,
+            name: child.attrs?.name,
+            description: typeof child.content === 'string' ? child.content : '',
+            price: parseFloat(child.attrs?.price ?? '0'),
+            currency: child.attrs?.currency ?? 'USD',
+            url: child.attrs?.url,
+            imageUrl: child.attrs?.imageUrl
+          });
+        }
+      }
+    }
+    return items;
+  }
+
+  private sendIqAndWait(node: BinaryNode, id: string, timeoutMs: number = 15000): Promise<BinaryNode> {
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => reject(new Error(`IQ ${id} timeout`)), timeoutMs);
+      this.registerIqHandler(id, (response) => {
+        clearTimeout(timeout);
+        resolve(response);
+      });
+      this.send(encodeBinaryNode(node));
+    });
+  }
+}
+
+// ============== Labels Manager ==============
+
+export interface Label {
+  id: string;
+  name: string;
+  color: number;
+  priority?: number;
+  deleted?: boolean;
+}
+
+export class LabelsManager {
+  private send: (data: Uint8Array) => void;
+  private registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+  private logger: WALogger;
+
+  constructor(opts: {
+    send: (data: Uint8Array) => void;
+    registerIqHandler: (id: string, handler: (node: BinaryNode) => void) => void;
+    logger?: WALogger;
+  }) {
+    this.send = opts.send;
+    this.registerIqHandler = opts.registerIqHandler;
+    this.logger = opts.logger ?? new SilentLogger();
+  }
+
+  /**
+   * Create label
+   */
+  async create(name: string, color: number): Promise<Label> {
+    const id = generateStanzaId();
+    const labelId = `label-${Date.now()}`;
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: 's.whatsapp.net',
+        id
+      },
+      content: [{
+        tag: 'label',
+        attrs: {
+          id: labelId,
+          name,
+          color: color.toString()
+        }
+      }]
+    };
+    await this.sendIqAndWait(node, id);
+    return { id: labelId, name, color };
+  }
+
+  /**
+   * Assign label ke chat
+   */
+  async assignToChat(labelId: string, chatJid: JIDLike): Promise<void> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'set',
+        to: 's.whatsapp.net',
+        id
+      },
+      content: [{
+        tag: 'label',
+        attrs: {
+          id: labelId,
+          action: 'assign',
+          chat: jidToString(chatJid)
+        }
+      }]
+    };
+    await this.sendIqAndWait(node, id);
+  }
+
+  /**
+   * Get all labels
+   */
+  async list(): Promise<Label[]> {
+    const id = generateStanzaId();
+    const node: BinaryNode = {
+      tag: 'iq',
+      attrs: {
+        type: 'get',
+        to: 's.whatsapp.net',
+        id
+      },
+      content: [{
+        tag: 'labels',
+        attrs: {}
+      }]
+    };
+    const response = await this.sendIqAndWait(node, id);
+    const labelsNode = (response.content as any[])?.find(c => c.tag === 'labels');
+    if (!labelsNode) return [];
+
+    const labels: Label[] = [];
+    if (Array.isArray(labelsNode.content)) {
+      for (const child of labelsNode.content) {
+        if (child.tag === 'label') {
+          labels.push({
+            id: child.attrs?.id,
+            name: child.attrs?.name,
+            color: parseInt(child.attrs?.color ?? '0', 10),
+            priority: child.attrs?.priority ? parseInt(child.attrs.priority, 10) : undefined,
+            deleted: child.attrs?.deleted === 'true'
+          });
+        }
+      }
+    }
+    return labels;
+  }
+
+  private sendIqAndWait(node: BinaryNode, id: string, timeoutMs: number = 15000): Promise<BinaryNode> {
+    return new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => reject(new Error(`IQ ${id} timeout`)), timeoutMs);
+      this.registerIqHandler(id, (response) => {
+        clearTimeout(timeout);
+        resolve(response);
+      });
+      this.send(encodeBinaryNode(node));
+    });
+  }
+}