@wuapidev/cli 0.1.0

package/dist/send.js

@@ -0,0 +1,73 @@
+// `wuapi send <to> <text>`: queue a text message. One idempotency key per
+// command, reused on every retry (the SDK's and ours), so a request cut off
+// midway is replayed by the API instead of sent twice.
+import { randomUUID } from "node:crypto";
+import { allowOnly, boolFlag, numberFlag, stringFlag } from "./args.js";
+import { emit, log, makeClient } from "./context.js";
+import { CliError, usage } from "./errors.js";
+import { isTransient } from "./link.js";
+const POLL_MS = 2_000;
+const SEND_ATTEMPTS = 3;
+const DONE = new Set(["sent", "delivered", "read", "played"]);
+async function pickAccount(ctx, client) {
+    const { items } = await client.accounts.list({ limit: 100 }).page();
+    const ready = items.filter((a) => a.status === "ready");
+    if (ready.length === 1) {
+        log(ctx, `wuapi: sending from ${ready[0].id}${ready[0].phone ? ` (${ready[0].phone})` : ""}`);
+        return ready[0].id;
+    }
+    if (ready.length === 0) {
+        throw new CliError("no_ready_account", items.length ? "No account is ready to send. Check `wuapi accounts list`." : "No linked number yet. Run `wuapi link` first.");
+    }
+    throw new CliError("account_required", `Several accounts are ready: pass --account <id> (${ready.map((a) => a.id).join(", ")}).`, {
+        exitCode: 2,
+        details: { accounts: ready.map((a) => ({ id: a.id, phone: a.phone, name: a.name })) },
+    });
+}
+export async function send(ctx) {
+    allowOnly(ctx.args, ["account", "accountId", "wait", "timeout", "idempotency-key"]);
+    const [, to, text, ...rest] = ctx.args.positionals;
+    if (!to || text === undefined || rest.length)
+        throw usage('Usage: wuapi send <to> <text> [--account <id>] [--wait]  (quote the text: "Hello there")');
+    const client = makeClient(ctx);
+    const accountId = stringFlag(ctx.args, "account") ?? stringFlag(ctx.args, "accountId") ?? (await pickAccount(ctx, client));
+    const idempotencyKey = stringFlag(ctx.args, "idempotency-key") ?? randomUUID();
+    let message;
+    for (let attempt = 1; !message; attempt++) {
+        try {
+            message = await client.messages.send({ accountId, to, text }, { idempotencyKey });
+        }
+        catch (e) {
+            if (!isTransient(e) || attempt >= SEND_ATTEMPTS)
+                throw e;
+            log(ctx, `wuapi: ${e.message} Retrying with the same idempotency key...`);
+            await ctx.io.sleep(1000 * attempt);
+        }
+    }
+    if (boolFlag(ctx.args, "wait")) {
+        const deadline = ctx.io.now() + numberFlag(ctx.args, "timeout", 120) * 1000;
+        while (!DONE.has(message.status) && message.status !== "failed") {
+            if (ctx.io.now() + POLL_MS > deadline) {
+                throw new CliError("wait_timeout", `Message ${message.id} is still ${message.status}. Check it later: wuapi messages get ${message.id}`, {
+                    details: { messageId: message.id, status: message.status },
+                });
+            }
+            await ctx.io.sleep(POLL_MS);
+            try {
+                message = await client.messages.get(message.id);
+            }
+            catch (e) {
+                if (!isTransient(e))
+                    throw e;
+            }
+        }
+        if (message.status === "failed") {
+            const err = message.error;
+            throw new CliError(err?.code ?? "message_failed", `Message ${message.id} failed${err?.message ? `: ${err.message}` : "."}`, {
+                details: { messageId: message.id, status: message.status, ...(err ? { error: err } : {}) },
+            });
+        }
+    }
+    emit(ctx, { id: message.id, status: message.status, accountId: message.accountId, chatId: message.chatId, idempotencyKey, message }, () => `${message.id} ${message.status}`);
+}
+//# sourceMappingURL=send.js.map

package/dist/send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"send.js","sourceRoot":"","sources":["../src/send.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,3 @@
+/** The package version. Bump it together with package.json (test/version.test.ts checks). */
+export declare const VERSION = "0.1.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -0,0 +1,3 @@
+/** The package version. Bump it together with package.json (test/version.test.ts checks). */
+export const VERSION = "0.1.0";
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@wuapidev/cli",
+  "version": "0.1.0",
+  "description": "The wuapi command line: log in from the browser, link a WhatsApp number by QR or pairing code, send messages, set up the MCP server and call every endpoint of the wuapi API from your terminal or your agent.",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "wuapi": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "wuapi",
+    "whatsapp",
+    "whatsapp-api",
+    "cli",
+    "ai-agents",
+    "mcp"
+  ],
+  "homepage": "https://wuapi.dev/docs#cli",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wuapidev/wuapi-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/wuapidev/wuapi-cli/issues"
+  },
+  "scripts": {
+    "gen": "node scripts/gen-operations.mjs",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && chmod +x dist/cli.js",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "dependencies": {
+    "@wuapidev/sdk": "^0.5.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.0.14"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}