cli-whatsapp 0.1.1 → 0.1.2

package/src/cli/index.ts

@@ -1,198 +0,0 @@
-import { Command } from 'commander';
-import { readFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { login, logout, status } from './commands/auth.ts';
-import { chats, contacts, open, history, search } from './commands/read.ts';
-import { send, reply } from './commands/send.ts';
-import { sync, watch } from './commands/sync.ts';
-import { exportChat } from './commands/export.ts';
-import { config, doctor, version } from './commands/misc.ts';
-import { shell } from './commands/shell.ts';
-import { media, download } from './commands/media.ts';
-import { recent, pin, unpin, archive, unarchive } from './commands/manage.ts';
-import { group } from './commands/group.ts';
-import { closeDb } from '../db/sqlite.ts';
-import { whenWritesSettled } from '../whatsapp/client.ts';
-import { installConsoleFilter } from '../whatsapp/logger.ts';
-import { printError } from '../utils/ui.ts';
-import { c } from '../utils/format.ts';
-
-// Suppress libsignal's direct console noise (unless WA_DEBUG).
-installConsoleFilter();
-
-function pkgVersion(): string {
-  try {
-    const p = join(new URL('../../', import.meta.url).pathname, 'package.json');
-    return JSON.parse(readFileSync(p, 'utf8')).version ?? '0.0.0';
-  } catch {
-    return '0.0.0';
-  }
-}
-
-/**
- * Wrap an async command so failures print cleanly and the process always exits.
- * We exit explicitly because commands that opened a WhatsApp socket leave
- * background handles (keep-alive timers, the websocket, history-sync work) that
- * would otherwise keep Node alive and hang the terminal after the work is done.
- */
-function run(fn: (...args: any[]) => unknown | Promise<unknown>) {
-  return async (...args: any[]) => {
-    try {
-      await fn(...args);
-      // Let any in-flight credential writes finish before exiting, or we risk
-      // truncating a session file mid-write and corrupting the login.
-      await whenWritesSettled();
-      closeDb();
-      process.exit(0);
-    } catch (err) {
-      printError(err);
-      await whenWritesSettled();
-      closeDb();
-      process.exit(1);
-    }
-  };
-}
-
-const program = new Command();
-
-program
-  .name('wa')
-  .description('A fast, terminal-first WhatsApp client.')
-  .version(pkgVersion(), '-v, --version', 'output the version number')
-  .configureHelp({ sortSubcommands: true })
-  .addHelpText(
-    'after',
-    `\nExamples:\n` +
-      `  ${c.dim('$')} wa login              ${c.dim('# link this device via QR')}\n` +
-      `  ${c.dim('$')} wa sync               ${c.dim('# pull recent chats & messages')}\n` +
-      `  ${c.dim('$')} wa chats              ${c.dim('# list conversations')}\n` +
-      `  ${c.dim('$')} wa open Alice         ${c.dim('# read a conversation')}\n` +
-      `  ${c.dim('$')} wa send Alice "Hi!"   ${c.dim('# send a message')}\n` +
-      `  ${c.dim('$')} wa search invoice     ${c.dim('# search cached messages')}\n`,
-  );
-
-// ---- Authentication --------------------------------------------------------
-program
-  .command('login [mode]')
-  .description('Link this device — pairing code by default; `wa login qr` to use a QR')
-  .option('-p, --phone <number>', 'number for the pairing code (skips the prompt)')
-  .action(run(login));
-program.command('logout').description('Unlink this device and wipe local session').action(run(logout));
-program.command('status').description('Show login and cache status').action(run(status));
-
-// ---- Reading (offline, from local cache) -----------------------------------
-program
-  .command('chats')
-  .description('List conversations (most recent first)')
-  .option('-a, --all', 'include archived chats')
-  .option('-n, --limit <n>', 'max chats to show')
-  .action(run(chats));
-
-program
-  .command('contacts')
-  .description('List known contacts')
-  .option('-n, --limit <n>', 'max contacts to show')
-  .action(run(contacts));
-
-program
-  .command('open <chat>')
-  .description('Show the latest messages in a chat')
-  .option('-n, --limit <n>', 'number of messages')
-  .action(run(open));
-
-program
-  .command('history <chat>')
-  .description('Show extended message history for a chat')
-  .option('-n, --limit <n>', 'number of messages (default 200)')
-  .action(run(history));
-
-program
-  .command('search <text>')
-  .description('Search cached messages')
-  .option('-n, --limit <n>', 'max results')
-  .action(run(search));
-
-// ---- Writing (requires connection) -----------------------------------------
-program
-  .command('send <chat> [message]')
-  .description('Send a message, or media with --file (message becomes the caption)')
-  .option('-f, --file <path>', 'attach an image/video/audio/document to send')
-  .action(run(send));
-
-program
-  .command('reply <id> <message>')
-  .description('Reply to a cached message by its #id')
-  .action(run(reply));
-
-// ---- Sync & live -----------------------------------------------------------
-program
-  .command('sync')
-  .description('Pull recent chats and messages into the local cache')
-  .option('-s, --seconds <n>', 'how long to sync (3-120)')
-  .action(run(sync));
-
-program.command('watch').description('Stream incoming messages live').action(run(watch));
-
-// ---- Media -----------------------------------------------------------------
-program
-  .command('media [type]')
-  .description('List cached media (photos, videos, audio, documents, stickers, all)')
-  .option('-n, --limit <n>', 'max items')
-  .action(run(media));
-
-program
-  .command('download <id>')
-  .description('Download & decrypt a cached media message by #id')
-  .option('-o, --out <file>', 'output file')
-  .action(run(download));
-
-// ---- Organize (local) ------------------------------------------------------
-program
-  .command('recent')
-  .description('Show most recently active chats')
-  .option('-n, --limit <n>', 'max chats')
-  .action(run(recent));
-program
-  .command('group [action] [args...]')
-  .description('Manage groups: info, invite, rename, add, remove, promote, demote, leave, create')
-  .action(run(group));
-
-program.command('pin <chat>').description('Pin a chat to the top (local)').action(run(pin));
-program.command('unpin <chat>').description('Unpin a chat (local)').action(run(unpin));
-program.command('archive <chat>').description('Archive a chat (local)').action(run(archive));
-program.command('unarchive <chat>').description('Unarchive a chat (local)').action(run(unarchive));
-
-// ---- Interactive -----------------------------------------------------------
-program
-  .command('shell', { isDefault: false })
-  .aliases(['chat', 'ui'])
-  .description('Start interactive mode (slash commands, live chat)')
-  .action(run(shell));
-
-// ---- Export ----------------------------------------------------------------
-program
-  .command('export <chat>')
-  .description('Export a conversation to markdown, text, or json')
-  .option('-f, --format <fmt>', 'md | txt | json', 'md')
-  .option('-n, --limit <n>', 'max messages', '1000')
-  .option('-o, --out <file>', 'output file ("-" for stdout)')
-  .action(run(exportChat));
-
-// ---- Utility ---------------------------------------------------------------
-program
-  .command('config [action] [key] [value]')
-  .description('View or edit config (e.g. `wa config set time24h false`)')
-  .action(run(config));
-
-program.command('doctor').description('Run self-diagnostics').action(run(doctor));
-program.command('version').description('Print the version').action(run(version));
-
-// Bare `wa` (no subcommand) drops into interactive mode.
-if (process.argv.slice(2).length === 0) {
-  await run(shell)();
-} else {
-  await program.parseAsync(process.argv).catch((err) => {
-    printError(err);
-    process.exit(1);
-  });
-}

package/src/config/index.ts

@@ -1,92 +0,0 @@
-import { homedir } from 'node:os';
-import { join, resolve } from 'node:path';
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-
-/**
- * All persistent state lives under a single base directory so it's easy to back
- * up or wipe. Defaults to ~/.cli-whatsapp in the user's home — a stable location
- * that survives package updates (never inside node_modules). Override with
- * WA_HOME (e.g. for tests or a portable install).
- */
-export const BASE_DIR = resolve(
-  process.env.WA_HOME ?? join(homedir(), '.cli-whatsapp'),
-);
-
-export const PATHS = {
-  base: BASE_DIR,
-  sessions: join(BASE_DIR, 'sessions'),
-  data: join(BASE_DIR, 'data'),
-  media: join(BASE_DIR, 'media'),
-  db: join(BASE_DIR, 'data', 'whatsapp.db'),
-  config: join(BASE_DIR, 'config.json'),
-} as const;
-
-export interface AppConfig {
-  /** Display name shown for the logged-in account (best effort). */
-  self?: string;
-  /** Preferences. */
-  preferences: {
-    /** Default number of messages shown by `wa open`. */
-    openLimit: number;
-    /** 12h/24h clock. */
-    time24h: boolean;
-    /** Show native desktop notifications for incoming messages (watch/live). */
-    notifications: boolean;
-    /** Go live automatically when the interactive app starts. */
-    autoConnect: boolean;
-  };
-  /** AI plugin settings (optional, never required by core). */
-  ai: {
-    enabled: boolean;
-    provider?: string;
-    model?: string;
-  };
-  /** Session bookkeeping. */
-  session: {
-    lastSyncAt?: number;
-    loggedIn?: boolean;
-  };
-}
-
-const DEFAULT_CONFIG: AppConfig = {
-  preferences: { openLimit: 30, time24h: true, notifications: true, autoConnect: true },
-  ai: { enabled: false },
-  session: {},
-};
-
-/** Ensure every runtime directory exists (idempotent, cheap). */
-export function ensureDirs(): void {
-  for (const dir of [PATHS.sessions, PATHS.data, PATHS.media]) {
-    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-  }
-}
-
-export function loadConfig(): AppConfig {
-  if (!existsSync(PATHS.config)) return structuredClone(DEFAULT_CONFIG);
-  try {
-    const raw = JSON.parse(readFileSync(PATHS.config, 'utf8'));
-    // Shallow-merge so new default keys appear for old config files.
-    return {
-      ...DEFAULT_CONFIG,
-      ...raw,
-      preferences: { ...DEFAULT_CONFIG.preferences, ...raw.preferences },
-      ai: { ...DEFAULT_CONFIG.ai, ...raw.ai },
-      session: { ...DEFAULT_CONFIG.session, ...raw.session },
-    };
-  } catch {
-    // Corrupt config should never crash the CLI; fall back to defaults.
-    return structuredClone(DEFAULT_CONFIG);
-  }
-}
-
-export function saveConfig(config: AppConfig): void {
-  ensureDirs();
-  writeFileSync(PATHS.config, JSON.stringify(config, null, 2) + '\n', 'utf8');
-}
-
-/** Convenience: patch a subset of config and persist. */
-export function updateConfig(patch: Partial<AppConfig>): AppConfig {
-  const next = { ...loadConfig(), ...patch };
-  saveConfig(next);
-  return next;
-}

package/src/db/sqlite.ts

@@ -1,354 +0,0 @@
-import { DatabaseSync } from 'node:sqlite';
-import { ensureDirs, PATHS } from '../config/index.ts';
-import { SCHEMA_SQL, SCHEMA_VERSION } from './schema.ts';
-
-export interface ChatRow {
-  jid: string;
-  name: string | null;
-  lastMessage: string | null;
-  lastTimestamp: number;
-  unreadCount: number;
-  archived: number;
-  pinned: number;
-  isGroup: number;
-}
-
-export interface MessageRow {
-  id: number;
-  chatJid: string;
-  messageId: string;
-  sender: string | null;
-  text: string | null;
-  timestamp: number;
-  status: string | null;
-  type: string | null;
-  fromMe: number;
-  mediaPath: string | null;
-  raw: string | null;
-}
-
-export interface ContactRow {
-  jid: string;
-  name: string | null;
-  phone: string | null;
-  updatedAt: number;
-}
-
-let db: DatabaseSync | null = null;
-
-/** Open (or reuse) the singleton database connection and apply the schema. */
-export function getDb(): DatabaseSync {
-  if (db) return db;
-  ensureDirs();
-  db = new DatabaseSync(PATHS.db);
-  db.exec(SCHEMA_SQL);
-  migrate(db);
-  setSetting('schema_version', String(SCHEMA_VERSION));
-  return db;
-}
-
-/** Additive, idempotent migrations for databases created by older versions. */
-function migrate(dbc: DatabaseSync): void {
-  ensureColumn(dbc, 'messages', 'raw', 'TEXT');
-}
-
-function ensureColumn(
-  dbc: DatabaseSync,
-  table: string,
-  column: string,
-  type: string,
-): void {
-  const cols = dbc.prepare(`PRAGMA table_info(${table})`).all() as {
-    name: string;
-  }[];
-  if (!cols.some((c) => c.name === column)) {
-    dbc.exec(`ALTER TABLE ${table} ADD COLUMN ${column} ${type}`);
-  }
-}
-
-export function closeDb(): void {
-  if (db) {
-    db.close();
-    db = null;
-  }
-}
-
-// ---- settings key/value helpers -------------------------------------------
-
-export function getSetting(key: string): string | null {
-  const row = getDb()
-    .prepare('SELECT value FROM settings WHERE key = ?')
-    .get(key) as { value: string } | undefined;
-  return row?.value ?? null;
-}
-
-export function setSetting(key: string, value: string): void {
-  getDb()
-    .prepare(
-      `INSERT INTO settings (key, value) VALUES (?, ?)
-       ON CONFLICT(key) DO UPDATE SET value = excluded.value`,
-    )
-    .run(key, value);
-}
-
-// ---- upserts ---------------------------------------------------------------
-
-export function upsertContact(c: {
-  jid: string;
-  name?: string | null;
-  phone?: string | null;
-}): void {
-  getDb()
-    .prepare(
-      `INSERT INTO contacts (jid, name, phone, updatedAt)
-       VALUES (@jid, @name, @phone, @updatedAt)
-       ON CONFLICT(jid) DO UPDATE SET
-         name  = COALESCE(excluded.name, contacts.name),
-         phone = COALESCE(excluded.phone, contacts.phone),
-         updatedAt = excluded.updatedAt`,
-    )
-    .run({
-      jid: c.jid,
-      name: c.name ?? null,
-      phone: c.phone ?? null,
-      updatedAt: Date.now(),
-    });
-}
-
-export function upsertChat(c: {
-  jid: string;
-  name?: string | null;
-  lastMessage?: string | null;
-  lastTimestamp?: number;
-  unreadCount?: number;
-  archived?: number;
-  pinned?: number;
-  isGroup?: number;
-}): void {
-  getDb()
-    .prepare(
-      `INSERT INTO chats (jid, name, lastMessage, lastTimestamp, unreadCount, archived, pinned, isGroup)
-       VALUES (@jid, @name, @lastMessage, @lastTimestamp, @unreadCount, @archived, @pinned, @isGroup)
-       ON CONFLICT(jid) DO UPDATE SET
-         name          = COALESCE(excluded.name, chats.name),
-         lastMessage   = COALESCE(excluded.lastMessage, chats.lastMessage),
-         lastTimestamp = MAX(excluded.lastTimestamp, chats.lastTimestamp),
-         unreadCount   = excluded.unreadCount,
-         archived      = excluded.archived,
-         pinned        = excluded.pinned,
-         isGroup       = excluded.isGroup`,
-    )
-    .run({
-      jid: c.jid,
-      name: c.name ?? null,
-      lastMessage: c.lastMessage ?? null,
-      lastTimestamp: c.lastTimestamp ?? 0,
-      unreadCount: c.unreadCount ?? 0,
-      archived: c.archived ?? 0,
-      pinned: c.pinned ?? 0,
-      isGroup: c.isGroup ?? 0,
-    });
-}
-
-export function insertMessage(m: {
-  chatJid: string;
-  messageId: string;
-  sender?: string | null;
-  text?: string | null;
-  timestamp: number;
-  status?: string | null;
-  type?: string | null;
-  fromMe: boolean;
-  mediaPath?: string | null;
-  raw?: string | null;
-}): void {
-  getDb()
-    .prepare(
-      `INSERT INTO messages (chatJid, messageId, sender, text, timestamp, status, type, fromMe, mediaPath, raw)
-       VALUES (@chatJid, @messageId, @sender, @text, @timestamp, @status, @type, @fromMe, @mediaPath, @raw)
-       ON CONFLICT(chatJid, messageId) DO UPDATE SET
-         text      = COALESCE(excluded.text, messages.text),
-         status    = COALESCE(excluded.status, messages.status),
-         mediaPath = COALESCE(excluded.mediaPath, messages.mediaPath),
-         raw       = COALESCE(excluded.raw, messages.raw)`,
-    )
-    .run({
-      chatJid: m.chatJid,
-      messageId: m.messageId,
-      sender: m.sender ?? null,
-      text: m.text ?? null,
-      timestamp: m.timestamp,
-      status: m.status ?? null,
-      type: m.type ?? null,
-      fromMe: m.fromMe ? 1 : 0,
-      mediaPath: m.mediaPath ?? null,
-      raw: m.raw ?? null,
-    });
-}
-
-/** Update the local media file path once a media message is downloaded. */
-export function setMediaPath(id: number, path: string): void {
-  getDb().prepare('UPDATE messages SET mediaPath = ? WHERE id = ?').run(path, id);
-}
-
-// ---- queries ---------------------------------------------------------------
-
-// Chat rows with the display name resolved: prefer the chat's own name, then
-// fall back to a known contact name for the same jid (direct chats often have
-// no name of their own). Column order/shape matches ChatRow.
-const CHAT_SELECT = `
-  SELECT c.jid,
-         COALESCE(c.name, ct.name) AS name,
-         c.lastMessage, c.lastTimestamp, c.unreadCount,
-         c.archived, c.pinned, c.isGroup
-  FROM chats c
-  LEFT JOIN contacts ct ON ct.jid = c.jid`;
-
-export function listChats(limit = 50, includeArchived = false): ChatRow[] {
-  return getDb()
-    .prepare(
-      `${CHAT_SELECT}
-       ${includeArchived ? '' : 'WHERE c.archived = 0'}
-       ORDER BY c.pinned DESC, c.lastTimestamp DESC
-       LIMIT ?`,
-    )
-    .all(limit) as unknown as ChatRow[];
-}
-
-export function listContacts(limit = 500): ContactRow[] {
-  return getDb()
-    .prepare(
-      `SELECT * FROM contacts WHERE name IS NOT NULL ORDER BY name COLLATE NOCASE LIMIT ?`,
-    )
-    .all(limit) as unknown as ContactRow[];
-}
-
-export function getMessages(chatJid: string, limit = 30): MessageRow[] {
-  // Newest N, returned oldest-first for natural chat reading order.
-  const rows = getDb()
-    .prepare(
-      `SELECT * FROM messages WHERE chatJid = ?
-       ORDER BY timestamp DESC, id DESC LIMIT ?`,
-    )
-    .all(chatJid, limit) as unknown as MessageRow[];
-  return rows.reverse();
-}
-
-export function searchMessages(term: string, limit = 50): MessageRow[] {
-  return getDb()
-    .prepare(
-      `SELECT * FROM messages WHERE text LIKE ? ESCAPE '\\'
-       ORDER BY timestamp DESC LIMIT ?`,
-    )
-    .all(`%${escapeLike(term)}%`, limit) as unknown as MessageRow[];
-}
-
-function escapeLike(s: string): string {
-  return s.replace(/[\\%_]/g, (m) => '\\' + m);
-}
-
-/**
- * Build a forgiving LIKE pattern: escape wildcards, then let any run of
- * whitespace in the query match any characters. So "Vishwas @Mobius" matches a
- * stored "Vishwas  @Mobius" (double space) or "Vishwas · @Mobius".
- */
-function likePattern(query: string): string {
-  return `%${escapeLike(query).replace(/\s+/g, '%')}%`;
-}
-
-/** Resolve a user-typed chat identifier (name fragment or jid) to a chat. */
-export function findChat(query: string): ChatRow | null {
-  const dbc = getDb();
-  // Exact jid first.
-  const exact = dbc
-    .prepare(`${CHAT_SELECT} WHERE c.jid = ?`)
-    .get(query) as ChatRow | undefined;
-  if (exact) return exact;
-  // Bare phone number → match the number portion of a direct-chat jid.
-  const digits = query.replace(/[^\d]/g, '');
-  if (digits.length >= 5 && digits === query.replace(/[+\s()\-]/g, '')) {
-    const byNum = dbc
-      .prepare(
-        `${CHAT_SELECT} WHERE c.jid LIKE ? ORDER BY c.lastTimestamp DESC LIMIT 1`,
-      )
-      .get(`${digits}@%`) as ChatRow | undefined;
-    if (byNum) return byNum;
-  }
-  // Case-insensitive name match (chat's own name OR the linked contact name),
-  // preferring the most recently active.
-  const byName = dbc
-    .prepare(
-      `${CHAT_SELECT}
-       WHERE COALESCE(c.name, ct.name) LIKE ? ESCAPE '\\'
-       ORDER BY (COALESCE(c.name, ct.name) = ? COLLATE NOCASE) DESC,
-                c.lastTimestamp DESC
-       LIMIT 1`,
-    )
-    .get(likePattern(query), query) as ChatRow | undefined;
-  return byName ?? null;
-}
-
-/** Media messages, optionally filtered by type (image/video/audio/document/sticker). */
-export function listMedia(types: string[] | null, limit = 50): MessageRow[] {
-  const dbc = getDb();
-  if (types && types.length) {
-    const placeholders = types.map(() => '?').join(',');
-    return dbc
-      .prepare(
-        `SELECT * FROM messages WHERE type IN (${placeholders})
-         ORDER BY timestamp DESC LIMIT ?`,
-      )
-      .all(...types, limit) as unknown as MessageRow[];
-  }
-  return dbc
-    .prepare(
-      `SELECT * FROM messages
-       WHERE type IN ('image','video','audio','document','sticker')
-       ORDER BY timestamp DESC LIMIT ?`,
-    )
-    .all(limit) as unknown as MessageRow[];
-}
-
-/** Recent chats by activity, ignoring pin priority. */
-export function recentChats(limit = 15): ChatRow[] {
-  return getDb()
-    .prepare(
-      `${CHAT_SELECT} WHERE c.archived = 0 ORDER BY c.lastTimestamp DESC LIMIT ?`,
-    )
-    .all(limit) as unknown as ChatRow[];
-}
-
-export function setPinned(jid: string, pinned: boolean): void {
-  getDb().prepare('UPDATE chats SET pinned = ? WHERE jid = ?').run(pinned ? 1 : 0, jid);
-}
-
-export function setArchived(jid: string, archived: boolean): void {
-  getDb().prepare('UPDATE chats SET archived = ? WHERE jid = ?').run(archived ? 1 : 0, jid);
-}
-
-/** Resolve a contact by name fragment (used to start a chat with no history). */
-export function findContact(query: string): ContactRow | null {
-  const row = getDb()
-    .prepare(
-      `SELECT * FROM contacts
-       WHERE name IS NOT NULL AND name LIKE ? ESCAPE '\\'
-       ORDER BY (name = ? COLLATE NOCASE) DESC, LENGTH(name) ASC
-       LIMIT 1`,
-    )
-    .get(likePattern(query), query) as ContactRow | undefined;
-  return row ?? null;
-}
-
-export function getMessageById(id: number): MessageRow | null {
-  const row = getDb()
-    .prepare('SELECT * FROM messages WHERE id = ?')
-    .get(id) as MessageRow | undefined;
-  return row ?? null;
-}
-
-export function countMessages(): number {
-  const row = getDb()
-    .prepare('SELECT COUNT(*) AS n FROM messages')
-    .get() as { n: number };
-  return row.n;
-}