@kangwifi-pro/waliwa 1.0.0

package/src/types/index.ts

@@ -0,0 +1,457 @@
+/**
+ * Waliwa - Core Type Definitions
+ * Type definitions untuk semua entity WhatsApp (Message, Chat, Group, Call, dll)
+ */
+
+import type { Readable } from 'stream';
+
+// ============== JID Types ==============
+
+export type JIDServer = 'c.us' | 'g.us' | 's.whatsapp.net' | 'broadcast' | 'call';
+
+export interface JID {
+  user: string;
+  server: JIDServer;
+  device?: number;
+  /** Fully-qualified JID string, e.g. "6281234567890@s.whatsapp.net" */
+  toString(): string;
+}
+
+export type JIDLike = string | JID;
+
+// ============== Message Types ==============
+
+export type MessageType =
+  | 'text'
+  | 'image'
+  | 'video'
+  | 'audio'
+  | 'document'
+  | 'sticker'
+  | 'location'
+  | 'contact'
+  | 'contacts'
+  | 'buttons'
+  | 'list'
+  | 'template'
+  | 'order'
+  | 'product'
+  | 'poll'
+  | 'reaction'
+  | 'revoked'
+  | 'system'
+  | 'unknown';
+
+export interface MessageContent {
+  text?: string;
+  caption?: string;
+  image?: { stream: Readable; mimetype: string; fileLength?: number };
+  video?: { stream: Readable; mimetype: string; seconds?: number; gifPlayback?: boolean };
+  audio?: { stream: Readable; mimetype: string; seconds?: number; ptt?: boolean };
+  document?: { stream: Readable; mimetype: string; fileName?: string; pageCount?: number };
+  sticker?: { stream: Readable; mimetype: string; isAnimated?: boolean };
+  location?: { degreesLatitude: number; degreesLongitude: number; name?: string; address?: string };
+  contact?: { displayName: string; vcard: string };
+  contacts?: { displayName: string; contacts: Array<{ displayName: string; vcard: string }> };
+  poll?: { name: string; values: string[]; selectableCounts?: number[]; toMessage?: MessageContent };
+  buttonReply?: { selectedDisplayText: string; selectedButtonId: string };
+  listReply?: { title: string; description: string; singleSelectReply: { selectedRowId: string } };
+  // Context
+  quoted?: WAMessage;
+  mentions?: JIDLike[];
+  // Misc
+  edit?: string;
+  ephemeralExpiration?: number;
+  viewOnce?: boolean;
+  contextInfo?: ContextInfo;
+}
+
+export interface ContextInfo {
+  stanzaId?: string;
+  participant?: JIDLike;
+  quotedMessage?: Partial<MessageContent>;
+  mentionedJid?: string[];
+  externalAdReply?: ExternalAdReply;
+  forwardingScore?: number;
+  isForwarded?: boolean;
+}
+
+export interface ExternalAdReply {
+  title: string;
+  body?: string;
+  mediaType?: number;
+  renderLargerThumbnail?: boolean;
+  thumbnail?: Buffer;
+  thumbnailUrl?: string;
+  sourceUrl?: string;
+  sourceId?: string;
+}
+
+export interface WAMessage {
+  key: WAMessageKey;
+  message?: MessageContent & { [k: string]: any };
+  messageTimestamp: number;
+  pushName?: string;
+  participant?: JIDLike;
+  status: MessageStatus;
+  ephemeralOutOfSync?: boolean;
+  /** Reply info */
+  quoted?: WAMessage;
+}
+
+export interface WAMessageKey {
+  remoteJid: JIDLike;
+  fromMe: boolean;
+  id: string;
+  participant?: JIDLike;
+}
+
+export type MessageStatus = 'pending' | 'sent' | 'delivered' | 'read' | 'played' | 'error';
+
+// ============== Chat Types ==============
+
+export interface WAChat {
+  id: JIDLike;
+  name?: string;
+  unreadCount: number;
+  lastMessage?: WAMessage;
+  pinned: boolean;
+  archived: boolean;
+  isGroup: boolean;
+  isMuted: boolean;
+  muteEndTime?: number;
+  conversationTimestamp: number;
+  ephemeralSetting?: number;
+}
+
+// ============== Group Types ==============
+
+export interface WAGroupMetadata {
+  id: JIDLike;
+  subject: string;
+  subjectOwner?: JIDLike;
+  subjectTime?: number;
+  desc?: string;
+  descOwner?: JIDLike;
+  descTime?: number;
+  creation?: number;
+  owner?: JIDLike;
+  participants: WAGroupParticipant[];
+  restrict?: boolean;
+  announce?: boolean;
+  isCommunity?: boolean;
+  isParentGroup?: boolean;
+  linkedParent?: JIDLike;
+  ephemeralSetting?: number;
+}
+
+export interface WAGroupParticipant {
+  id: JIDLike;
+  isAdmin: boolean;
+  isSuperAdmin: boolean;
+  /** "admin" | "member" | "superadmin" */
+  role?: string;
+}
+
+export interface GroupCreateOptions {
+  subject: string;
+  participants: JIDLike[];
+  desc?: string;
+  /** Idle time (seconds) before group is auto-disbanded */
+  ephemeralSetting?: number;
+}
+
+export interface GroupUpdateSubjectOptions {
+  subject: string;
+}
+
+export interface GroupUpdateDescriptionOptions {
+  desc: string;
+}
+
+// ============== Call Types ==============
+
+export interface WACallEvent {
+  id: string;
+  from: JIDLike;
+  to: JIDLike;
+  isVideo: boolean;
+  isGroup: boolean;
+  status: CallStatus;
+  timestamp: number;
+  /** Optional WebRTC SDP offer if available */
+  offer?: string;
+}
+
+export type CallStatus = 'ringing' | 'accepted' | 'rejected' | 'missed' | 'timeout';
+
+// ============== Presence ==============
+
+export type PresenceType = 'available' | 'unavailable' | 'composing' | 'recording' | 'paused';
+
+export interface PresenceUpdate {
+  jid: JIDLike;
+  presence: PresenceType;
+  lastKnownPresence?: PresenceType;
+  t?: number;
+}
+
+// ============== Auth Types ==============
+
+export interface AuthState {
+  creds: AuthenticationCreds;
+  keys: SignalKeyStore;
+}
+
+export interface AuthenticationCreds {
+  /** Our registered phone number with country code, e.g. "6281234567890" */
+  me?: JIDLike;
+  /** Whether pairing was completed */
+  registered: boolean;
+  /** Noise protocol static key pair */
+  noiseKey?: KeyPair;
+  /** Pairing static key (server side identity) */
+  pairingKey?: KeyPair;
+  /** Identity key pair */
+  identityId?: KeyPair;
+  /** Signed pre-key */
+  signedIdentityKey?: KeyPair;
+  signedPreKey?: SignedKeyPair;
+  /** Registration ID */
+  registrationId?: number;
+  /** Advance details for multi-device */
+  advSecretKey?: string;
+  /** Next pre-key ID counter */
+  nextPreKeyId: number;
+  firstUnuploadedPreKeyId: number;
+  /** Has the account been "uploaded" */
+  accountSettings?: {
+    unarchiveChats: boolean;
+  };
+  /** Server tokens */
+  serverToken?: string;
+  clientToken?: string;
+  /** Last seen phone */
+  lastAccountSyncTimestamp?: number;
+  /** Mark-as-read setting */
+  markOnlineLastSeen?: boolean;
+}
+
+export interface KeyPair {
+  private: Uint8Array;
+  public: Uint8Array;
+}
+
+export interface SignedKeyPair {
+  keyId: number;
+  keyPair: KeyPair;
+  signature: Uint8Array;
+}
+
+export interface SignalKeyStore {
+  preKeys: Record<number, KeyPair>;
+  sessions: Record<string, any>;
+  identityKeys: Record<string, KeyPair>;
+  senderKeys: Record<string, any>;
+  appStateKeys: Record<string, Uint8Array>;
+  appStateSyncKeys: Record<string, Uint8Array>;
+}
+
+export interface QRGenerationData {
+  /** QR data ref */
+  ref: string;
+  /** Public key for pairing */
+  publicKey: Uint8Array;
+  /** Pairing static key */
+  pairingStaticKey: Uint8Array;
+  /** Encoded QR string */
+  qrString: string;
+  /** QR timeout in seconds */
+  timeout: number;
+}
+
+export interface PairingCodeResult {
+  /** 8-character pairing code e.g. "AB12-CD34" */
+  code: string;
+  /** Phone number with country code */
+  phoneNumber: string;
+  /** Expiry timestamp */
+  expiresAt: number;
+}
+
+// ============== Media Types ==============
+
+export interface MediaUploadResult {
+  url: string;
+  directPath: string;
+  mediaKey: Uint8Array;
+  encFileHash: Uint8Array;
+  fileEncSHA256: Uint8Array;
+  fileSHA256: Uint8Array;
+  fileLength: number;
+  mimetype: string;
+}
+
+export interface MediaDownloadResult {
+  buffer: Buffer;
+  mimetype: string;
+  fileLength: number;
+  /** Original filename if document */
+  fileName?: string;
+}
+
+// ============== Events ==============
+
+export interface WAEventMap {
+  'connection.update': ConnectionUpdate;
+  'creds.update': AuthenticationCreds;
+  'qr.update': QRGenerationData;
+  'pairing-code.update': PairingCodeResult;
+  'message.upsert': { messages: WAMessage[]; type: MessageUpsertType };
+  'message.update': { messages: WAMessage[]; keys: WAMessageKey[] };
+  'message.delete': { keys: WAMessageKey[]; messageRevokes?: WAMessage[] };
+  'message.reaction': { key: WAMessageKey; reaction: string; sender?: JIDLike };
+  'presence.update': PresenceUpdate;
+  'chats.upsert': WAChat[];
+  'chats.update': Partial<WAChat>[];
+  'chats.delete': string[];
+  'groups.upsert': WAGroupMetadata[];
+  'groups.update': Partial<WAGroupMetadata>[];
+  'group-participants.update': GroupParticipantUpdate;
+  'calls': WACallEvent;
+  'contacts.upsert': ContactRecord[];
+  'contacts.update': Partial<ContactRecord>[];
+  'blocklist.update': string[];
+  'messaging-history.set': { chats: WAChat[]; contacts: ContactRecord[]; messages: WAMessage[]; isLatest: boolean };
+}
+
+export type MessageUpsertType = 'append' | 'notify';
+
+export interface ContactRecord {
+  id: JIDLike;
+  name?: string;
+  notify?: string;
+  verifiedName?: string;
+  imgUrl?: string;
+  status?: string;
+  lid?: string;
+}
+
+export interface GroupParticipantUpdate {
+  id: JIDLike;
+  participants: JIDLike[];
+  action: 'add' | 'remove' | 'promote' | 'demote';
+  author?: JIDLike;
+  timestamp: number;
+}
+
+// ============== Connection ==============
+
+export interface ConnectionUpdate {
+  connection: 'close' | 'open' | 'connecting';
+  lastDisconnect?: { error: Error | undefined; output: any };
+  qr?: string;
+  isNewLogin?: boolean;
+  receivedPendingNotifications?: boolean;
+  isOnline?: boolean;
+}
+
+// ============== Config ==============
+
+export interface WaliwaConfig {
+  /** Authentication state provider (file-based by default) */
+  authState?: AuthState;
+  /** Custom logger */
+  logger?: WALogger;
+  /** Print QR to terminal */
+  printQRInTerminal?: boolean;
+  /** Mobile API mode: use pairing code instead of QR */
+  mobile?: boolean;
+  /** Phone number for pairing code mode */
+  phoneNumber?: string;
+  /** Browser identification [name, short name, version] */
+  browser?: [string, string, string];
+  /** WebSocket reconnect config */
+  reconnectInterval?: number;
+  maxReconnectAttempts?: number;
+  /** Request full sync on connect */
+  syncFullHistory?: boolean;
+  /** Maximum message retry count */
+  maxMsgRetryCount?: number;
+  /** Custom WebSocket URL */
+  wsURL?: string;
+  /** Timeout untuk connect (ms) */
+  connectTimeoutMs?: number;
+  /** Keep alive interval (ms) */
+  keepAliveIntervalMs?: number;
+  /** RAM optimization level: 1 = balanced, 2 = aggressive, 3 = ultra */
+  ramOptimizationLevel?: 1 | 2 | 3;
+  /** Auto mark read received messages */
+  markOnlineOnConnect?: boolean;
+  /** Custom HTTP agent for media upload/download */
+  fetchAgent?: any;
+  /** Multi-Branch SKDM Recovery configuration */
+  recovery?: RecoveryConfig;
+}
+
+/**
+ * Multi-Branch SKDM Recovery configuration
+ *
+ * Saat disconnect terjadi, sistem mencoba multiple recovery strategies in order
+ * berdasarkan disconnect reason. Each branch punya retry limit sendiri.
+ */
+export interface RecoveryConfig {
+  /** Enable recovery system (default: true) */
+  enabled?: boolean;
+  /** Max attempts per branch (default: 3) */
+  maxAttemptsPerBranch?: number;
+  /** Total max attempts across all branches (default: 20) */
+  maxTotalAttempts?: number;
+  /** Initial delay untuk backoff (default: 1000ms) */
+  initialDelayMs?: number;
+  /** Max delay untuk backoff (default: 60000ms) */
+  maxDelayMs?: number;
+  /** Delay khusus untuk rate limited (default: 300000ms = 5min) */
+  rateLimitedDelayMs?: number;
+}
+
+export interface WALogger {
+  level: 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
+  child(meta?: Record<string, any>): WALogger;
+  fatal(msg: string, ...args: any[]): void;
+  error(msg: string, ...args: any[]): void;
+  warn(msg: string, ...args: any[]): void;
+  info(msg: string, ...args: any[]): void;
+  debug(msg: string, ...args: any[]): void;
+  trace(msg: string, ...args: any[]): void;
+}
+
+// ============== Send Message Result ==============
+
+export interface SendMessageResult {
+  /** Message ID generated */
+  key: WAMessageKey;
+  /** Message status */
+  status: MessageStatus;
+  /** Optional message timestamp */
+  messageTimestamp?: number;
+  /** Optional participants (for groups) */
+  participants?: JIDLike[];
+}
+
+// ============== Poll Types ==============
+
+export interface PollMessageContent {
+  name: string;
+  values: string[];
+  selectableCounts?: number[];
+  toMessage?: MessageContent;
+}
+
+export interface PollUpdate {
+  pollCreationMessageKey: WAMessageKey;
+  voteCasterJid: JIDLike;
+  selectedOptions: string[];
+  /** Timestamp of vote */
+  timestamp: number;
+}

package/src/utils/jid.ts

@@ -0,0 +1,156 @@
+/**
+ * Waliwa - JID (Jabber ID) utilities
+ * WhatsApp pakai JID mirip XMPP: "user@s.whatsapp.net", "group-id@g.us", etc.
+ */
+
+import type { JID, JIDLike, JIDServer } from '../types/index.js';
+
+const DEFAULT_SERVER: JIDServer = 's.whatsapp.net';
+const GROUP_SERVER: JIDServer = 'g.us';
+const USER_SERVER: JIDServer = 'c.us';
+const BROADCAST_SERVER: JIDServer = 'broadcast';
+const CALL_SERVER: JIDServer = 'call';
+
+// ============== Parsing ==============
+
+/**
+ * Parse string jadi JID object
+ * Format: "user@server" atau "user:device@server"
+ */
+export function parseJid(input: JIDLike): JID {
+  if (typeof input === 'object' && input !== null && 'user' in input) {
+    return input;
+  }
+  const str = String(input);
+  const [userPart, serverPart] = str.split('@');
+  if (!serverPart) {
+    // Default ke s.whatsapp.net jika tidak ada server
+    return {
+      user: str,
+      server: DEFAULT_SERVER,
+      toString: () => `${str}@${DEFAULT_SERVER}`
+    };
+  }
+  // Check for device suffix: "user:device@server"
+  const [user, deviceStr] = userPart.split(':');
+  const device = deviceStr ? parseInt(deviceStr, 10) : undefined;
+  const server = serverPart as JIDServer;
+
+  const fullJid = device
+    ? `${user}:${device}@${server}`
+    : `${user}@${server}`;
+
+  return {
+    user,
+    server,
+    device,
+    toString: () => fullJid
+  };
+}
+
+/**
+ * Normalize JID ke string
+ */
+export function jidToString(jid: JIDLike): string {
+  if (typeof jid === 'string') return jid;
+  if (typeof jid === 'object' && jid !== null && 'toString' in jid) {
+    return jid.toString();
+  }
+  return String(jid);
+}
+
+/**
+ * Get user ID saja (tanpa @server)
+ */
+export function jidUser(jid: JIDLike): string {
+  return parseJid(jid).user;
+}
+
+/**
+ * Get server dari JID
+ */
+export function jidServer(jid: JIDLike): JIDServer {
+  return parseJid(jid).server;
+}
+
+// ============== Type Checks ==============
+
+export function isGroupJid(jid: JIDLike): boolean {
+  return jidServer(jid) === GROUP_SERVER;
+}
+
+export function isUserJid(jid: JIDLike): boolean {
+  const server = jidServer(jid);
+  return server === USER_SERVER || server === DEFAULT_SERVER;
+}
+
+export function isBroadcastJid(jid: JIDLike): boolean {
+  return jidServer(jid) === BROADCAST_SERVER;
+}
+
+export function isCallJid(jid: JIDLike): boolean {
+  return jidServer(jid) === CALL_SERVER;
+}
+
+export function isStatusJid(jid: JIDLike): boolean {
+  return jidUser(jid) === 'status';
+}
+
+export function isNewsletter(jid: JIDLike): boolean {
+  const server = jidServer(jid);
+  return server === 's.whatsapp.net' && jidUser(jid).startsWith('120363');
+}
+
+export function isLidJid(jid: JIDLike): boolean {
+  return jidUser(jid).startsWith('xyz:') || jidUser(jid).match(/^\d+$/) === null;
+}
+
+// ============== Builders ==============
+
+export function userJid(phoneNumber: string | number): string {
+  const str = String(phoneNumber).replace(/[^0-9]/g, '');
+  return `${str}@${DEFAULT_SERVER}`;
+}
+
+export function groupJid(groupId: string): string {
+  const str = String(groupId).replace(/[^0-9-]/g, '');
+  return `${str}@${GROUP_SERVER}`;
+}
+
+export function broadcastJid(broadcastId: string): string {
+  return `${broadcastId}@${BROADCAST_SERVER}`;
+}
+
+// ============== Validation ==============
+
+export function isValidJid(jid: JIDLike): boolean {
+  try {
+    const parsed = parseJid(jid);
+    return parsed.user.length > 0 && parsed.server.length > 0;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Compare 2 JID (case-insensitive, ignore device suffix)
+ */
+export function jidEqual(a: JIDLike, b: JIDLike): boolean {
+  const ja = parseJid(a);
+  const jb = parseJid(b);
+  return ja.user === jb.user && ja.server === jb.server;
+}
+
+/**
+ * Get phone number dari user JID
+ */
+export function jidToPhoneNumber(jid: JIDLike): string {
+  return jidUser(jid);
+}
+
+/**
+ * Convert phone number ke JID
+ */
+export function phoneNumberToJid(phone: string): string {
+  return userJid(phone);
+}

package/src/utils/logger.ts

@@ -0,0 +1,84 @@
+/**
+ * Waliwa - Logger utility (pino-based, RAM-efficient)
+ * Default level 'warn' untuk production hemat RAM.
+ */
+
+import type { WALogger } from '../types/index.js';
+
+type LogLevel = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
+const LEVEL_PRIORITY: Record<LogLevel, number> = {
+  fatal: 60, error: 50, warn: 40, info: 30, debug: 20, trace: 10
+};
+
+/**
+ * Lightweight logger - lebih ringan dari pino untuk RAM efficiency
+ * Tetap API-compatible dengan pino agar mudah di-swap
+ */
+export class DefaultLogger implements WALogger {
+  level: LogLevel = 'warn';
+  private meta: Record<string, any> = {};
+
+  constructor(level: LogLevel = 'warn') {
+    this.level = level;
+  }
+
+  child(meta?: Record<string, any>): WALogger {
+    const child = new DefaultLogger(this.level);
+    child.meta = { ...this.meta, ...(meta || {}) };
+    return child;
+  }
+
+  private shouldLog(level: LogLevel): boolean {
+    return LEVEL_PRIORITY[level] >= LEVEL_PRIORITY[this.level];
+  }
+
+  private format(level: LogLevel, msg: string, args: any[]): string {
+    const ts = new Date().toISOString();
+    const metaStr = Object.keys(this.meta).length
+      ? ' ' + JSON.stringify(this.meta)
+      : '';
+    const argsStr = args.length ? ' ' + args.map(a => typeof a === 'object' ? JSON.stringify(a) : String(a)).join(' ')
+      : '';
+    return `[${ts}] ${level.toUpperCase()}${metaStr} ${msg}${argsStr}`;
+  }
+
+  private log(level: LogLevel, msg: string, args: any[]): void {
+    if (!this.shouldLog(level)) return;
+    const formatted = this.format(level, msg, args);
+    if (level === 'fatal' || level === 'error') {
+      console.error(formatted);
+    } else if (level === 'warn') {
+      console.warn(formatted);
+    } else {
+      console.log(formatted);
+    }
+  }
+
+  fatal(msg: string, ...args: any[]): void { this.log('fatal', msg, args); }
+  error(msg: string, ...args: any[]): void { this.log('error', msg, args); }
+  warn(msg: string, ...args: any[]): void { this.log('warn', msg, args); }
+  info(msg: string, ...args: any[]): void { this.log('info', msg, args); }
+  debug(msg: string, ...args: any[]): void { this.log('debug', msg, args); }
+  trace(msg: string, ...args: any[]): void { this.log('trace', msg, args); }
+}
+
+/**
+ * Default logger instance (singleton, RAM-friendly)
+ */
+export const defaultLogger = new DefaultLogger(process.env.WALIWA_LOG_LEVEL as LogLevel || 'warn');
+
+/**
+ * Silent logger - untuk testing atau production mode tanpa logs
+ */
+export class SilentLogger implements WALogger {
+  level: LogLevel = 'silent' as any;
+  child(): WALogger { return this; }
+  fatal(): void {}
+  error(): void {}
+  warn(): void {}
+  info(): void {}
+  debug(): void {}
+  trace(): void {}
+}
+
+export const silentLogger = new SilentLogger();