@kangwifi-pro/waliwa 1.0.0

package/src/auth/qr-code.ts

@@ -0,0 +1,191 @@
+/**
+ * Waliwa - QR code generation untuk WhatsApp Web Multi-Device pairing
+ *
+ * QR code berisi: ref + publicKey + pairingStaticKey (encoded sebagai comma-separated)
+ * User scan dengan WhatsApp mobile app untuk establish pairing
+ */
+
+import qrcode from 'qrcode-terminal';
+import type {
+  QRGenerationData,
+  AuthenticationCreds,
+  WALogger
+} from '../types/index.js';
+import { concatBytes, getRandomBytes } from '../core/crypto.js';
+import { SilentLogger } from '../utils/logger.js';
+
+// ============== QR Reference Generator ==============
+
+let qrRefCounter = 0;
+
+/**
+ * Generate new QR reference (server-side correlation ID)
+ * Format: 8-character alphanumeric
+ */
+export function generateQRRef(): string {
+  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+  let ref = '';
+  const rand = getRandomBytes(8);
+  for (let i = 0; i < 8; i++) {
+    ref += chars[rand[i] % chars.length];
+  }
+  qrRefCounter++;
+  return ref + qrRefCounter.toString(36);
+}
+
+// ============== QR Encoder ==============
+
+/**
+ * Build QR code string untuk WA pairing
+ *
+ * Format:
+ *   ref,publicKey(base64),pairingStaticKey(base64),clientDid,serverDid
+ *
+ * WhatsApp mobile app akan scan QR, kirim ke server, server pakai publicKey
+ * untuk encrypt pairing payload yang berisi identity keys.
+ */
+export function buildQRString(
+  ref: string,
+  publicKey: Uint8Array,
+  pairingStaticKey: Uint8Array,
+  /** Client device ID (noise static key fingerprint) */
+  clientDid?: Uint8Array
+): string {
+  const pubKeyB64 = Buffer.from(publicKey).toString('base64');
+  const pairingB64 = Buffer.from(pairingStaticKey).toString('base64');
+  const didB64 = clientDid ? Buffer.from(clientDid).toString('base64') : '';
+
+  // Format: ref,publicKey,pairingStaticKey,clientDid
+  if (didB64) {
+    return `${ref},${pubKeyB64},${pairingB64},${didB64}`;
+  }
+  return `${ref},${pubKeyB64},${pairingB64}`;
+}
+
+// ============== QR Generation ==============
+
+export interface QRGenerationOptions {
+  creds: AuthenticationCreds;
+  logger?: WALogger;
+  /** Print QR ke terminal? */
+  printInTerminal?: boolean;
+  /** Small QR mode (lebih kompak di terminal) */
+  small?: boolean;
+}
+
+/**
+ * Generate QR code data dari auth creds
+ */
+export function generateQRCodeData(opts: QRGenerationOptions): QRGenerationData {
+  const logger = opts.logger ?? new SilentLogger();
+
+  if (!opts.creds.noiseKey) {
+    throw new Error('noiseKey tidak tersedia di creds - generate creds baru');
+  }
+
+  const ref = generateQRRef();
+  const publicKey = opts.creds.noiseKey.public;
+  const pairingStaticKey = opts.creds.pairingKey?.public ?? new Uint8Array(32);
+
+  const qrString = buildQRString(ref, publicKey, pairingStaticKey);
+
+  if (opts.printInTerminal) {
+    logger.info('Scan QR code ini dengan WhatsApp mobile app:\n');
+    qrcode.generate(qrString, { small: opts.small ?? true }, (qr: string) => {
+      console.log(qr);
+    });
+  }
+
+  return {
+    ref,
+    publicKey,
+    pairingStaticKey,
+    qrString,
+    timeout: 60 // 60 seconds default
+  };
+}
+
+// ============== QR Refresh Manager ==============
+
+/**
+ * QR refresh manager - auto-refresh QR setiap ~20 detik (sesuai WA server timeout)
+ * Untuk menghindari stale QR yang sudah expire
+ */
+export class QRRefreshManager {
+  private timer: NodeJS.Timeout | null = null;
+  private onRefresh: (qr: QRGenerationData) => void;
+  private onTimeout: () => void;
+  private refreshIntervalMs: number;
+  private maxRefreshCount: number;
+  private refreshCount: number = 0;
+  private isRunning: boolean = false;
+
+  constructor(
+    onRefresh: (qr: QRGenerationData) => void,
+    onTimeout: () => void,
+    refreshIntervalMs: number = 20000,
+    maxRefreshCount: number = 5
+  ) {
+    this.onRefresh = onRefresh;
+    this.onTimeout = onTimeout;
+    this.refreshIntervalMs = refreshIntervalMs;
+    this.maxRefreshCount = maxRefreshCount;
+  }
+
+  start(initialQR: QRGenerationData): void {
+    if (this.isRunning) return;
+    this.isRunning = true;
+    this.refreshCount = 0;
+    this.onRefresh(initialQR);
+
+    this.timer = setInterval(() => {
+      this.refreshCount++;
+      if (this.refreshCount >= this.maxRefreshCount) {
+        this.stop();
+        this.onTimeout();
+        return;
+      }
+      // Trigger refresh - caller akan generate new QR dan pass via update
+      this.onRefresh(this.generateNewQRPlaceholder());
+    }, this.refreshIntervalMs);
+  }
+
+  private generateNewQRPlaceholder(): QRGenerationData {
+    // Placeholder - actual generation handled by caller
+    return {
+      ref: generateQRRef(),
+      publicKey: new Uint8Array(32),
+      pairingStaticKey: new Uint8Array(32),
+      qrString: '',
+      timeout: 20
+    };
+  }
+
+  stop(): void {
+    if (this.timer) {
+      clearInterval(this.timer);
+      this.timer = null;
+    }
+    this.isRunning = false;
+  }
+}
+
+// ============== QR Decoder (untuk reverse direction / debug) ==============
+
+export function parseQRString(qrString: string): {
+  ref: string;
+  publicKey: Uint8Array;
+  pairingStaticKey: Uint8Array;
+  clientDid?: Uint8Array;
+} {
+  const parts = qrString.split(',');
+  if (parts.length < 3) {
+    throw new Error('Invalid QR string format');
+  }
+  const [ref, pubKeyB64, pairingB64, didB64] = parts;
+  const publicKey = new Uint8Array(Buffer.from(pubKeyB64, 'base64'));
+  const pairingStaticKey = new Uint8Array(Buffer.from(pairingB64, 'base64'));
+  const clientDid = didB64 ? new Uint8Array(Buffer.from(didB64, 'base64')) : undefined;
+
+  return { ref, publicKey, pairingStaticKey, clientDid };
+}

package/src/calls/handler.ts

@@ -0,0 +1,153 @@
+/**
+ * Waliwa - Call handling
+ * Process incoming WhatsApp call events (offer, reject, terminate)
+ */
+
+import type {
+  WACallEvent,
+  CallStatus,
+  JIDLike,
+  WALogger
+} from '../types/index.js';
+import { encodeBinaryNode, BinaryNode } from '../core/binary.js';
+import { jidToString } from '../utils/jid.js';
+import { SilentLogger } from '../utils/logger.js';
+
+export interface CallHandlerOptions {
+  send: (data: Uint8Array) => void;
+  logger?: WALogger;
+  onCall?: (event: WACallEvent) => void;
+  /** Auto reject incoming calls */
+  autoReject?: boolean;
+}
+
+/**
+ * Handle incoming WhatsApp call events
+ * Calls masuk sebagai binary node dengan tag "call"
+ */
+export class CallHandler {
+  private send: (data: Uint8Array) => void;
+  private logger: WALogger;
+  private onCall?: (event: WACallEvent) => void;
+  private autoReject: boolean;
+
+  constructor(opts: CallHandlerOptions) {
+    this.send = opts.send;
+    this.logger = opts.logger ?? new SilentLogger();
+    this.onCall = opts.onCall;
+    this.autoReject = opts.autoReject ?? false;
+  }
+
+  /**
+   * Handle call node
+   */
+  async handleCallNode(node: BinaryNode): Promise<void> {
+    const attrs = node.attrs || {};
+    const from = attrs.from;
+    const callId = attrs.id;
+    const isVideo = attrs.video === 'true';
+    const isGroup = attrs.group === 'true' || attrs.is_group === 'true';
+    const status = attrs.status as CallStatus || 'ringing';
+
+    const event: WACallEvent = {
+      id: callId,
+      from,
+      to: attrs.to,
+      isVideo,
+      isGroup,
+      status,
+      timestamp: Date.now(),
+      offer: attrs.offer
+    };
+
+    this.logger.info(`Incoming ${isVideo ? 'video' : 'voice'} call from ${from} (id: ${callId})`);
+    if (this.onCall) this.onCall(event);
+
+    // Auto reject jika enabled
+    if (this.autoReject && status === 'ringing') {
+      await this.rejectCall(callId, from);
+    }
+  }
+
+  /**
+   * Reject incoming call
+   */
+  async rejectCall(callId: string, from: JIDLike): Promise<void> {
+    const node: BinaryNode = {
+      tag: 'call',
+      attrs: {
+        id: callId,
+        from: attrs_to_placeholder(),
+        to: jidToString(from),
+        action: 'reject',
+        type: 'reject'
+      },
+      content: undefined
+    };
+    try {
+      this.send(encodeBinaryNode(node));
+      this.logger.info(`Rejected call ${callId}`);
+    } catch (err: any) {
+      this.logger.error(`Failed to reject call: ${err.message}`);
+    }
+  }
+
+  /**
+   * Accept incoming call (voice only, no WebRTC support)
+   */
+  async acceptCall(callId: string, from: JIDLike): Promise<void> {
+    const node: BinaryNode = {
+      tag: 'call',
+      attrs: {
+        id: callId,
+        to: jidToString(from),
+        action: 'accept',
+        type: 'accept'
+      }
+    };
+    try {
+      this.send(encodeBinaryNode(node));
+      this.logger.info(`Accepted call ${callId}`);
+    } catch (err: any) {
+      this.logger.error(`Failed to accept call: ${err.message}`);
+    }
+  }
+
+  /**
+   * Set call handler
+   */
+  setHandler(handler: (event: WACallEvent) => void): void {
+    this.onCall = handler;
+  }
+
+  /**
+   * Enable/disable auto reject
+   */
+  setAutoReject(enabled: boolean): void {
+    this.autoReject = enabled;
+  }
+}
+
+// Helper placeholder for "to" field (own JID)
+function attrs_to_placeholder(): string {
+  // Should be set to own JID
+  return '';
+}
+
+/**
+ * Voice message transcription hook
+ * Note: WhatsApp punya transcription API tapi memerlukan server-side processing
+ */
+export interface VoiceTranscriptionResult {
+  callId?: string;
+  messageId?: string;
+  text: string;
+  language?: string;
+  confidence?: number;
+}
+
+/**
+ * Transcribe voice message via external service (hook)
+ * User harus implement sendiri atau pakai service seperti Whisper
+ */
+export type VoiceTranscriptionFn = (audioBuffer: Buffer) => Promise<VoiceTranscriptionResult | null>;