cli-whatsapp 0.1.14 → 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

@@ -528,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])))

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/sqlite.js

@@ -145,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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cli-whatsapp",
-  "version": "0.1.14",
+  "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": {