cli-whatsapp 0.1.12 → 0.1.16

package/dist/cli/commands/read.js

@@ -10,13 +10,21 @@ export function chats(opts) {
     print(renderChatList(rows, cfg.preferences.time24h));
 }
 /** wa contacts [--limit N] */
-export function contacts(opts) {
-    const limit = clampLimit(opts.limit, 500);
-    const rows = listContacts(limit);
+/** wa contacts [starts] — list contacts; `starts` filters by name prefix
+ *  (e.g. `wa contacts a` → names starting with "a"). */
+export function contacts(starts, opts) {
+    // Show everyone by default; honor an explicit --limit if given.
+    const limit = opts.limit ? Math.max(1, parseInt(opts.limit, 10) || 100000) : 100000;
+    const filter = starts?.replace(/^-+/, '').trim() || undefined; // tolerate "-a"
+    const rows = listContacts(limit, filter);
     if (rows.length === 0) {
-        print(c.dim('No contacts cached yet. Run `wa sync`.'));
+        print(c.dim(filter
+            ? `No contacts starting with "${filter}".`
+            : 'No contacts cached yet. Run `wa sync`.'));
         return;
     }
+    if (filter)
+        print(c.dim(`Contacts starting with "${filter}":`));
     const width = String(rows.length).length;
     print(rows
         .map((r, i) => {

package/dist/cli/commands/shell.js

@@ -30,7 +30,8 @@ const SLASH_ITEMS = [
     { value: '/sendfile', desc: 'send a file (media)', args: true },
     { value: '/reply', desc: 'reply to a message by #id', args: true },
     { value: '/media', desc: 'list cached media (this chat, or all)' },
-    { value: '/dl', desc: 'pick recent media to download & open' },
+    { value: '/dl', desc: 'pick un-downloaded media to download & open' },
+    { value: '/saved', desc: 'pick already-downloaded media to open' },
     { value: '/pin', desc: 'pin a chat to the top', args: true },
     { value: '/unpin', desc: 'unpin a chat', args: true },
     { value: '/archive', desc: 'archive (hide) a chat', args: true },
@@ -315,16 +316,10 @@ async function downloadAndOpen(state, idRaw) {
         warn(`Download failed: ${err.message}`);
     }
 }
-/** `/dl` with no id: pick from recent, not-yet-downloaded media (this chat if
- *  open, else all), newest first — arrow-select, no id to type. */
-async function pickMediaToDownload(state) {
-    const rows = listMedia(null, 100, state.active?.jid, true); // undownloaded only
-    if (!rows.length) {
-        warn(state.active ? 'No new media in this chat to download.' : 'No new media to download.');
-        return;
-    }
+/** Build picker items from media rows (label + who/time, returns the id). */
+function mediaItems(rows) {
     const time24h = loadConfig().preferences.time24h;
-    const items = rows.map((m) => {
+    return rows.map((m) => {
         const label = m.text
             ? truncate(m.text.replace(/\s+/g, ' '), 32)
             : m.mediaPath
@@ -336,13 +331,46 @@ async function pickMediaToDownload(state) {
             id: String(m.id),
         };
     });
+}
+/** `/dl` with no id: pick from recent, not-yet-downloaded media (this chat if
+ *  open, else all), newest first — arrow-select, no id to type. */
+async function pickMediaToDownload(state) {
+    const rows = listMedia(null, 100, state.active?.jid, 'undownloaded');
+    if (!rows.length) {
+        warn(state.active ? 'No new media in this chat to download.' : 'No new media to download.');
+        return;
+    }
     const title = state.active
-        ? `Media with ${displayName(state.active)} — ⏎ download & open`
-        : 'All media — ⏎ download & open';
-    const picked = await pickFromList(title, items, '');
+        ? `Download media with ${displayName(state.active)} — ⏎ to save & open`
+        : 'Download media — ⏎ to save & open';
+    const picked = await pickFromList(title, mediaItems(rows), '');
     if (picked)
         await downloadAndOpen(state, picked);
 }
+/** `/saved`: pick from already-downloaded media (this chat if open, else all)
+ *  and open it — no re-download. */
+async function pickMediaToOpen(state) {
+    const rows = listMedia(null, 100, state.active?.jid, 'downloaded');
+    if (!rows.length) {
+        warn((state.active ? 'No downloaded media in this chat yet. ' : 'No downloaded media yet. ') +
+            'Use /dl to download some first.');
+        return;
+    }
+    const title = state.active
+        ? `Open saved media with ${displayName(state.active)} — ⏎ to open`
+        : 'Open saved media — ⏎ to open';
+    const picked = await pickFromList(title, mediaItems(rows), '');
+    if (!picked)
+        return;
+    const m = getMessageById(parseInt(picked, 10));
+    if (m?.mediaPath && existsSync(m.mediaPath)) {
+        openFile(m.mediaPath);
+        printAbove(state, `${c.green('✓')} Opened ${c.dim(m.mediaPath)}`);
+    }
+    else {
+        warn('That file is missing — re-download it with /dl.');
+    }
+}
 // ---- chat context ----------------------------------------------------------
 function openChat(state, target) {
     // Resolve against chats, contacts, or a raw number/jid.
@@ -500,7 +528,7 @@ async function handle(state, raw) {
             recent({ limit: args[0] });
             return;
         case 'contacts':
-            contacts({ limit: args[0] });
+            contacts(args[0], {});
             return;
         case 'history':
             if (state.active && (!args[0] || /^\d+$/.test(args[0])))
@@ -518,11 +546,15 @@ async function handle(state, raw) {
             return;
         case 'download':
         case 'dl':
-        case 'open-media':
             if (args[0])
                 await downloadAndOpen(state, args[0]);
             else
-                await pickMediaToDownload(state); // no id → pick from recent media
+                await pickMediaToDownload(state); // no id → pick un-downloaded media
+            return;
+        case 'saved':
+        case 'downloads':
+        case 'opened':
+            await pickMediaToOpen(state); // pick already-downloaded media to open
             return;
         case 'status':
             status();

package/dist/cli/index.js

@@ -80,8 +80,8 @@ program
     .option('-n, --limit <n>', 'max chats to show')
     .action(run(chats));
 program
-    .command('contacts')
-    .description('List known contacts')
+    .command('contacts [starts]')
+    .description('List contacts; pass a letter to filter (e.g. `wa contacts a`)')
     .option('-n, --limit <n>', 'max contacts to show')
     .action(run(contacts));
 program

package/dist/db/schema.js

@@ -4,7 +4,7 @@
  *
  * `schema_version` in the `settings` table lets us evolve this safely later.
  */
-export const SCHEMA_VERSION = 3;
+export const SCHEMA_VERSION = 4;
 export const SCHEMA_SQL = /* sql */ `
 PRAGMA journal_mode = WAL;      -- concurrent read while writing (watch + reads)
 PRAGMA synchronous = NORMAL;    -- fast, safe enough for a local cache
@@ -39,6 +39,7 @@ CREATE TABLE IF NOT EXISTS messages (
   type       TEXT,
   fromMe     INTEGER NOT NULL DEFAULT 0,
   mediaPath  TEXT,
+  downloadedAt INTEGER,   -- when the media file was saved locally (for "recently saved" sort)
   raw        TEXT,   -- JSON of the message content, kept for media so it can be downloaded later
   UNIQUE (chatJid, messageId)
 );

package/dist/db/sqlite.js

@@ -18,6 +18,7 @@ export function getDb() {
 /** Additive, idempotent migrations for databases created by older versions. */
 function migrate(dbc) {
     ensureColumn(dbc, 'messages', 'raw', 'TEXT');
+    ensureColumn(dbc, 'messages', 'downloadedAt', 'INTEGER');
 }
 function ensureColumn(dbc, table, column, type) {
     const cols = dbc.prepare(`PRAGMA table_info(${table})`).all();
@@ -105,9 +106,11 @@ export function insertMessage(m) {
         raw: m.raw ?? null,
     });
 }
-/** Update the local media file path once a media message is downloaded. */
+/** Update the local media file path (and save time) once a media message is downloaded. */
 export function setMediaPath(id, path) {
-    getDb().prepare('UPDATE messages SET mediaPath = ? WHERE id = ?').run(path, id);
+    getDb()
+        .prepare('UPDATE messages SET mediaPath = ?, downloadedAt = ? WHERE id = ?')
+        .run(path, Date.now(), id);
 }
 // ---- queries ---------------------------------------------------------------
 // Chat rows with the display name resolved. Preference order:
@@ -142,13 +145,18 @@ export function listChats(limit = 50, includeArchived = false) {
        LIMIT ?`)
         .all(limit);
 }
-export function listContacts(limit = 500) {
+export function listContacts(limit = 500, startsWith) {
     // Exclude WhatsApp privacy-masked placeholder names (e.g. "+91∙∙∙∙∙∙∙∙37").
+    const params = [];
+    let where = "name IS NOT NULL AND name NOT LIKE '%∙%'";
+    if (startsWith) {
+        where += " AND name LIKE ? ESCAPE '\\'";
+        params.push(escapeLike(startsWith) + '%');
+    }
+    params.push(limit);
     return getDb()
-        .prepare(`SELECT * FROM contacts
-       WHERE name IS NOT NULL AND name NOT LIKE '%∙%'
-       ORDER BY name COLLATE NOCASE LIMIT ?`)
-        .all(limit);
+        .prepare(`SELECT * FROM contacts WHERE ${where} ORDER BY name COLLATE NOCASE LIMIT ?`)
+        .all(...params);
 }
 export function getMessages(chatJid, limit = 30) {
     // Newest N, returned oldest-first for natural chat reading order.
@@ -249,7 +257,7 @@ export function importLidMappings() {
     return n;
 }
 /** Media messages, optionally filtered by type (image/video/audio/document/sticker). */
-export function listMedia(types, limit = 50, chatJid, undownloadedOnly = false) {
+export function listMedia(types, limit = 50, chatJid, saved) {
     const kinds = types && types.length ? types : ['image', 'video', 'audio', 'document', 'sticker'];
     const placeholders = kinds.map(() => '?').join(',');
     const params = [...kinds];
@@ -258,11 +266,15 @@ export function listMedia(types, limit = 50, chatJid, undownloadedOnly = false)
         where += ' AND chatJid = ?';
         params.push(chatJid);
     }
-    if (undownloadedOnly)
+    if (saved === 'undownloaded')
         where += " AND (mediaPath IS NULL OR mediaPath = '')";
+    else if (saved === 'downloaded')
+        where += " AND mediaPath IS NOT NULL AND mediaPath <> ''";
+    // Downloaded → newest *saved* first; otherwise newest *shared* first.
+    const orderBy = saved === 'downloaded' ? 'COALESCE(downloadedAt, timestamp) DESC' : 'timestamp DESC';
     params.push(limit);
     return getDb()
-        .prepare(`SELECT * FROM messages WHERE ${where} ORDER BY timestamp DESC LIMIT ?`)
+        .prepare(`SELECT * FROM messages WHERE ${where} ORDER BY ${orderBy} LIMIT ?`)
         .all(...params);
 }
 /** Recent chats by activity, ignoring pin priority. */

package/dist/utils/format.js

@@ -85,9 +85,16 @@ export function renderMessages(messages, time24h = true) {
         const time = c.gray(formatTime(m.timestamp, time24h));
         const who = m.fromMe ? c.green('me') : c.cyan(cleanSender(m.sender));
         const isMedia = m.type ? MEDIA.includes(m.type) : false;
+        const downloaded = isMedia && !!m.mediaPath;
         const body = m.text ?? (m.type ? c.dim(`[${m.type}]`) : c.dim('[no text]'));
-        // Media → an actionable "/dl <id>"; text → a dim #id (for /reply).
-        const tail = isMedia && !m.fromMe ? c.green(`/dl ${m.id}`) : c.dim(`#${m.id}`);
+        // Media: "✓ saved" (downloaded) or "/dl <id>" (not yet); text: dim #id.
+        let tail;
+        if (downloaded)
+            tail = c.green('✓ saved') + ' ' + c.dim(`#${m.id}`);
+        else if (isMedia && !m.fromMe)
+            tail = c.green(`/dl ${m.id}`);
+        else
+            tail = c.dim(`#${m.id}`);
         return `${time} ${who}: ${body} ${tail}`;
     })
         .join('\n');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cli-whatsapp",
-  "version": "0.1.12",
+  "version": "0.1.16",
   "description": "A lightweight, fast, terminal-first WhatsApp client. Read, search, send, media, groups, and live notifications — from your terminal.",
   "type": "module",
   "bin": {