@wuapidev/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 wuapi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,84 @@
+# wuapi CLI
+
+[![npm version](https://img.shields.io/npm/v/@wuapidev/cli.svg)](https://www.npmjs.com/package/@wuapidev/cli)
+[![CI](https://github.com/wuapidev/wuapi-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/wuapidev/wuapi-cli/actions/workflows/ci.yml)
+[![license](https://img.shields.io/npm/l/@wuapidev/cli.svg)](LICENSE)
+
+The command line for [wuapi](https://wuapi.dev), the WhatsApp API for developers. Log in from the browser, link a number by QR code or pairing code, send a message, set up the MCP server, and call every endpoint of the API, from your terminal or from an AI agent.
+
+```sh
+npx @wuapidev/cli login                      # opens the browser, stores a key
+npx @wuapidev/cli link --country VE          # shows a QR code, waits until the number is linked
+npx @wuapidev/cli send +584121234567 "Hola"  # sends from your linked number
+```
+
+Node 20 or later. Using it often? Install it once and the command is just `wuapi`:
+
+```sh
+npm install -g @wuapidev/cli
+wuapi login
+```
+
+Docs: [wuapi.dev/docs#cli](https://wuapi.dev/docs#cli).
+
+> wuapi links your own numbers as devices, the same way WhatsApp Web works. It does not use the WhatsApp Business Platform. WhatsApp can restrict numbers that behave like spam: send only to people who expect your messages.
+
+## Commands
+
+| Command | |
+|---|---|
+| `wuapi login [--env] [--no-browser] [--profile <name>]` | Log in in the browser. The CLI shows a code, you approve it at wuapi.dev, and it stores a new API key. `--env` also writes `WUAPI_API_KEY` to `./.env` and adds `.env` to `./.gitignore`. |
+| `wuapi login --start` / `--finish` | The same in two steps (see [Agents](#agents)). |
+| `wuapi profiles` | Your stored logins, `*` on the current one. |
+| `wuapi switch [<profile>]` | Change the current profile (a picker when you leave out the name). |
+| `wuapi logout [<profile>] [--all]` | Forget a login. The key stays valid until you revoke it at [wuapi.dev/app/api-keys](https://wuapi.dev/app/api-keys). |
+| `wuapi whoami` | The organization, project and key in use. |
+| `wuapi link [--phone +E164] [--country XX] [--city name] [--name label] [--open] [--no-wait] [--timeout 300]` | Create an account and link it. Without `--phone`: a QR code in the terminal (`--open` also opens it in the browser; it refreshes as the code rotates). With `--phone`: an 8-character pairing code to type in WhatsApp > Settings > Linked devices > Link a device > Link with phone number instead. The proxy location is the number's country (from `--phone`, or `--country`) and its biggest city, or the best match for `--city`. |
+| `wuapi wait <accountId> [--timeout 300]` | Wait until an account is linked and ready. |
+| `wuapi send <to> <text> [--account <id>] [--wait]` | Send a text. `--account` can be left out when one account is ready. `--wait` waits until it is sent or failed. |
+| `wuapi mcp add [--client claude\|cursor\|vscode] [--scope project\|user]` | Register the local MCP server (`npx -y @wuapidev/mcp`) with your client. No key goes into the client's config: the server uses your `wuapi login`. |
+
+### Every API endpoint
+
+```sh
+wuapi <resource> <method> [ids...] [--field value ...] [--data '<json>'|@file.json] [--all]
+```
+
+```sh
+wuapi accounts list
+wuapi messages list --accountId acc_1 --limit 5
+wuapi groups get acc_1 120363012345678901@g.us
+wuapi messages send --accountId acc_1 --to +584121234567 --type image --media.url https://example.com/a.jpg
+wuapi webhook-endpoints create --url https://example.com/hook --events '["message.received"]'
+wuapi projects api-keys list prj_1 --all
+wuapi me
+```
+
+Ids are positional, in the order the path takes them (or `--accountId acc_1`). Other flags are the query parameters or body fields of the operation: values are JSON when they parse (`5`, `true`, `["a"]`), text otherwise, and always text where the API expects a string. `--a.b value` sets a nested field. `--data` takes a JSON body, `@file.json` or `@-` (stdin); flags override it. List methods print one page (with `nextCursor`); `--all` fetches every page.
+
+`wuapi help` lists the resources, `wuapi help <resource>` its methods, and `wuapi <resource> <method> --help` the fields, from the OpenAPI spec.
+
+## Keys and profiles
+
+The key comes from, in order: `--api-key`, `WUAPI_API_KEY`, `WUAPI_API_KEY` in `./.env`, the profile `--profile` or `WUAPI_PROFILE` names, the current profile. `--project <id or ext:externalId>` (or `WUAPI_PROJECT`) acts inside one project; a profile made from a project key uses its project. `--base-url` / `WUAPI_BASE_URL` point at another API host (https only, or http on localhost).
+
+Each `wuapi login` adds a profile, named after the organization (`acme`) or organization and project (`acme/store-1`), and makes it current. Profiles live in `~/.config/wuapi/credentials.json` (`$XDG_CONFIG_HOME/wuapi`, or `%APPDATA%\wuapi` on Windows), readable only by you. The CLI never prints a key.
+
+## Agents
+
+Every command takes `--json`: the result is JSON on stdout, logs and progress go to stderr, and a failure exits non-zero with `{"error": {"code", "message"}}` on stdout. With `--json`, or when stdin is not a terminal, the CLI never asks anything.
+
+An agent whose shell only shows output after a command ends logs in in two steps:
+
+```sh
+npx @wuapidev/cli login --start --json   # {"url": "...", "code": "ABCD-EFGH", "expiresIn": 600}; show both to the person
+npx @wuapidev/cli login --finish --json  # waits until they approve, then {"profile", "organization", "project", ...}
+```
+
+Linking works the same way: `wuapi link --phone +584121234567 --no-wait --json` returns the account id and the pairing code at once (without `--phone`, `qrCodeUrl` and `qrCodeFile`, a PNG to show), and `wuapi wait <accountId> --json` returns when the number is ready.
+
+`wuapi send` uses one idempotency key per command and reuses it on every retry, so a request cut off midway is never sent twice. Every wait is bounded (`--timeout`), and a dropped connection during a login, link or wait is retried until then.
+
+## License
+
+MIT

package/dist/args.d.ts

@@ -0,0 +1,17 @@
+/** Flags that never take a value: `--json`, `--all`, ... */
+export declare const BOOLEAN_FLAGS: Set<string>;
+export interface Parsed {
+    positionals: string[];
+    /** Flag name -> raw value (`true` for a flag given without one). Repeats: the last wins. */
+    flags: Map<string, string | true>;
+}
+export declare function parseArgs(argv: string[]): Parsed;
+/** A string flag: undefined when absent; a usage error when given without a value. */
+export declare function stringFlag(p: Parsed, name: string): string | undefined;
+export declare function boolFlag(p: Parsed, name: string): boolean;
+export declare function numberFlag(p: Parsed, name: string, fallback: number, min?: number): number;
+/** Fails on flags a command does not take. */
+export declare function allowOnly(p: Parsed, allowed: string[]): void;
+/** Flags every command accepts. */
+export declare const GLOBAL_FLAGS: string[];
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAOA,4DAA4D;AAC5D,eAAO,MAAM,aAAa,aAYxB,CAAC;AAIH,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,4FAA4F;IAC5F,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;CACnC;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAqChD;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKtE;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKzD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAI,GAAG,MAAM,CAMrF;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAG5D;AAED,mCAAmC;AACnC,eAAO,MAAM,YAAY,UAAgE,CAAC"}

package/dist/args.js

@@ -0,0 +1,96 @@
+// Argument parsing. Commands take positionals and `--flag value` /
+// `--flag=value` pairs; the generic `<resource> <method>` commands accept any
+// flag (they become API fields), so this parser knows only which flags never
+// take a value.
+import { usage } from "./errors.js";
+/** Flags that never take a value: `--json`, `--all`, ... */
+export const BOOLEAN_FLAGS = new Set([
+    "json",
+    "help",
+    "version",
+    "all",
+    "wait",
+    "no-wait",
+    "open",
+    "no-browser",
+    "env",
+    "start",
+    "finish",
+]);
+const SHORT = { h: "help", v: "version" };
+export function parseArgs(argv) {
+    const positionals = [];
+    const flags = new Map();
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--") {
+            positionals.push(...argv.slice(i + 1));
+            break;
+        }
+        if (a.startsWith("--") && a.length > 2) {
+            const eq = a.indexOf("=");
+            const name = eq === -1 ? a.slice(2) : a.slice(2, eq);
+            if (!name)
+                throw usage(`Bad flag: ${a}`);
+            if (eq !== -1) {
+                flags.set(name, a.slice(eq + 1));
+                continue;
+            }
+            if (BOOLEAN_FLAGS.has(name)) {
+                flags.set(name, true);
+                continue;
+            }
+            const next = argv[i + 1];
+            if (next !== undefined && (!next.startsWith("-") || /^-\d/.test(next) || next === "-")) {
+                flags.set(name, next);
+                i++;
+            }
+            else {
+                flags.set(name, true);
+            }
+            continue;
+        }
+        if (/^-[a-z]$/i.test(a) && SHORT[a.slice(1)]) {
+            flags.set(SHORT[a.slice(1)], true);
+            continue;
+        }
+        positionals.push(a);
+    }
+    return { positionals, flags };
+}
+/** A string flag: undefined when absent; a usage error when given without a value. */
+export function stringFlag(p, name) {
+    const v = p.flags.get(name);
+    if (v === undefined)
+        return undefined;
+    if (v === true)
+        throw usage(`--${name} needs a value.`);
+    return v;
+}
+export function boolFlag(p, name) {
+    const v = p.flags.get(name);
+    if (v === undefined)
+        return false;
+    if (v === true)
+        return true;
+    return !/^(false|0|no|off)$/i.test(v);
+}
+export function numberFlag(p, name, fallback, min = 1) {
+    const v = stringFlag(p, name);
+    if (v === undefined)
+        return fallback;
+    const n = Number(v);
+    if (!Number.isFinite(n) || n < min)
+        throw usage(`--${name} must be a number of at least ${min}.`);
+    return n;
+}
+/** Fails on flags a command does not take. */
+export function allowOnly(p, allowed) {
+    const ok = new Set([...allowed, ...GLOBAL_FLAGS]);
+    for (const name of p.flags.keys())
+        if (!ok.has(name))
+            throw usage(`Unknown flag --${name}.`);
+}
+/** Flags every command accepts. */
+export const GLOBAL_FLAGS = ["json", "help", "api-key", "base-url", "project", "profile"];
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+// The `wuapi` command. See `wuapi help` and https://wuapi.dev/docs#cli.
+import { nodeIo } from "./io.js";
+import { main } from "./main.js";
+const code = await main(process.argv.slice(2), nodeIo());
+process.exitCode = code;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,wEAAwE;AACxE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;AACzD,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC"}

package/dist/context.d.ts

@@ -0,0 +1,45 @@
+import { Wuapi } from "@wuapidev/sdk";
+import type { Parsed } from "./args.js";
+import { type Credentials, type Profile } from "./credentials.js";
+import type { Io } from "./io.js";
+export interface Ctx {
+    io: Io;
+    args: Parsed;
+    /** --json: results as JSON on stdout, everything else on stderr. */
+    json: boolean;
+    /** A person at a terminal: no --json and stdin is a TTY. Only then may a command ask. */
+    interactive: boolean;
+}
+export declare function makeCtx(io: Io, args: Parsed): Ctx;
+export declare const log: (ctx: Ctx, text: string) => void;
+/** Prints a result: JSON with --json, else the human text. */
+export declare function emit(ctx: Ctx, value: unknown, human: () => string): void;
+export declare const credsPath: (ctx: Ctx) => string;
+export declare const pendingPath: (ctx: Ctx) => string;
+export declare function readCreds(ctx: Ctx): Credentials;
+/** Plain https, or http on this machine only: the key must never travel in clear text. */
+export declare function isSafeBaseUrl(value: string): boolean;
+/** --base-url > WUAPI_BASE_URL > the profile's > https://api.wuapi.dev. */
+export declare function resolveBaseUrl(ctx: Ctx, profile?: Profile): string;
+export type KeySource = "flag" | "env" | "dotenv" | "profile";
+export interface Auth {
+    apiKey: string;
+    baseUrl: string;
+    project?: string;
+    source: KeySource;
+    /** The stored profile the key came from. */
+    profileName?: string;
+    profile?: Profile;
+}
+/** The profile named by --profile or WUAPI_PROFILE, else the current one. */
+export declare function selectedProfile(ctx: Ctx, creds: Credentials): {
+    name: string;
+    profile: Profile;
+} | undefined;
+/**
+ * The key: --api-key > WUAPI_API_KEY > WUAPI_API_KEY in ./.env >
+ * --profile / WUAPI_PROFILE > the current profile.
+ */
+export declare function resolveAuth(ctx: Ctx): Auth;
+export declare function makeClient(ctx: Ctx, auth?: Auth): Wuapi;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAIA,OAAO,EAAoB,KAAK,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAExC,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAGnF,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAGlC,MAAM,WAAW,GAAG;IAClB,EAAE,EAAE,EAAE,CAAC;IACP,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,IAAI,EAAE,OAAO,CAAC;IACd,yFAAyF;IACzF,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,CAGjD;AAED,eAAO,MAAM,GAAG,GAAI,KAAK,GAAG,EAAE,MAAM,MAAM,SAA4B,CAAC;AAEvE,8DAA8D;AAC9D,wBAAgB,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,MAAM,GAAG,IAAI,CAMxE;AAED,eAAO,MAAM,SAAS,GAAI,KAAK,GAAG,WAA8D,CAAC;AACjG,eAAO,MAAM,WAAW,GAAI,KAAK,GAAG,WAA+D,CAAC;AAEpG,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW,CAM/C;AAED,0FAA0F;AAC1F,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAUpD;AAED,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAIlE;AAED,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9D,MAAM,WAAW,IAAI;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,SAAS,CAAC;IAClB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAID,6EAA6E;AAC7E,wBAAgB,eAAe,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,WAAW,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAc5G;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA+B1C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,GAAE,IAAuB,GAAG,KAAK,CAOzE"}

package/dist/context.js

@@ -0,0 +1,120 @@
+// What every command gets: the IO, the parsed arguments, the output mode, and
+// the API key / base URL / project resolved from flags, environment, ./.env
+// and the stored profiles.
+import { DEFAULT_BASE_URL, Wuapi } from "@wuapidev/sdk";
+import { stringFlag } from "./args.js";
+import { loadCredentials } from "./credentials.js";
+import { readDotenvKey } from "./dotenv.js";
+import { CliError, usage } from "./errors.js";
+import { credentialsPath, pendingLoginPath } from "./paths.js";
+export function makeCtx(io, args) {
+    const json = args.flags.get("json") !== undefined;
+    return { io, args, json, interactive: !json && io.stdinIsTTY };
+}
+export const log = (ctx, text) => ctx.io.err(`${text}\n`);
+/** Prints a result: JSON with --json, else the human text. */
+export function emit(ctx, value, human) {
+    if (ctx.json)
+        ctx.io.out(`${JSON.stringify(value ?? { ok: true }, null, 2)}\n`);
+    else {
+        const text = human();
+        if (text)
+            ctx.io.out(text.endsWith("\n") ? text : `${text}\n`);
+    }
+}
+export const credsPath = (ctx) => credentialsPath(ctx.io.env, ctx.io.platform, ctx.io.home);
+export const pendingPath = (ctx) => pendingLoginPath(ctx.io.env, ctx.io.platform, ctx.io.home);
+export function readCreds(ctx) {
+    try {
+        return loadCredentials(credsPath(ctx));
+    }
+    catch (e) {
+        throw new CliError("invalid_credentials", e.message);
+    }
+}
+/** Plain https, or http on this machine only: the key must never travel in clear text. */
+export function isSafeBaseUrl(value) {
+    let url;
+    try {
+        url = new URL(value);
+    }
+    catch {
+        return false;
+    }
+    if (url.username || url.password)
+        return false;
+    if (url.protocol === "https:")
+        return true;
+    return url.protocol === "http:" && (url.hostname === "localhost" || url.hostname === "127.0.0.1" || url.hostname === "[::1]");
+}
+/** --base-url > WUAPI_BASE_URL > the profile's > https://api.wuapi.dev. */
+export function resolveBaseUrl(ctx, profile) {
+    const value = stringFlag(ctx.args, "base-url") ?? (ctx.io.env.WUAPI_BASE_URL?.trim() || undefined) ?? profile?.baseUrl ?? DEFAULT_BASE_URL;
+    if (!isSafeBaseUrl(value))
+        throw usage("The base URL must be https (or http://localhost for development).");
+    return value.replace(/\/+$/, "");
+}
+const KEY_RE = /^wu_(live|test)_[A-Za-z0-9]{16,128}$/;
+/** The profile named by --profile or WUAPI_PROFILE, else the current one. */
+export function selectedProfile(ctx, creds) {
+    const wanted = stringFlag(ctx.args, "profile") ?? (ctx.io.env.WUAPI_PROFILE?.trim() || undefined);
+    if (wanted !== undefined) {
+        const profile = creds.profiles[wanted];
+        if (!profile) {
+            const names = Object.keys(creds.profiles);
+            throw new CliError("profile_not_found", `No profile named "${wanted}".${names.length ? ` Profiles: ${names.join(", ")}.` : " Run `npx @wuapidev/cli login`."}`, {
+                details: { profiles: names },
+            });
+        }
+        return { name: wanted, profile };
+    }
+    if (creds.current && creds.profiles[creds.current])
+        return { name: creds.current, profile: creds.profiles[creds.current] };
+    return undefined;
+}
+/**
+ * The key: --api-key > WUAPI_API_KEY > WUAPI_API_KEY in ./.env >
+ * --profile / WUAPI_PROFILE > the current profile.
+ */
+export function resolveAuth(ctx) {
+    const flag = stringFlag(ctx.args, "api-key");
+    const env = ctx.io.env.WUAPI_API_KEY?.trim() || undefined;
+    const dotenv = flag || env ? undefined : readDotenvKey(ctx.io.cwd);
+    let apiKey = flag ?? env ?? dotenv;
+    let source = flag ? "flag" : env ? "env" : "dotenv";
+    let chosen;
+    if (!apiKey) {
+        chosen = selectedProfile(ctx, readCreds(ctx));
+        if (chosen) {
+            apiKey = chosen.profile.apiKey;
+            source = "profile";
+        }
+    }
+    else if (stringFlag(ctx.args, "profile") !== undefined) {
+        log(ctx, `wuapi: --profile ignored: the key comes from ${source === "flag" ? "--api-key" : source === "env" ? "WUAPI_API_KEY" : "./.env"}.`);
+    }
+    if (!apiKey) {
+        throw new CliError("not_logged_in", "No API key. Run `npx @wuapidev/cli login`, or set WUAPI_API_KEY (create a key at https://wuapi.dev/app/api-keys).");
+    }
+    if (!KEY_RE.test(apiKey)) {
+        const where = source === "flag" ? "--api-key" : source === "env" ? "WUAPI_API_KEY" : source === "dotenv" ? "WUAPI_API_KEY in ./.env" : `profile ${chosen?.name}`;
+        throw new CliError("invalid_api_key", `${where} does not look like a wuapi API key (wu_live_...).`);
+    }
+    const project = stringFlag(ctx.args, "project") ?? (ctx.io.env.WUAPI_PROJECT?.trim() || undefined) ?? (source === "profile" ? chosen?.profile.project?.id : undefined);
+    return {
+        apiKey,
+        baseUrl: resolveBaseUrl(ctx, chosen?.profile),
+        ...(project ? { project } : {}),
+        source,
+        ...(chosen ? { profileName: chosen.name, profile: chosen.profile } : {}),
+    };
+}
+export function makeClient(ctx, auth = resolveAuth(ctx)) {
+    return new Wuapi({
+        apiKey: auth.apiKey,
+        baseUrl: auth.baseUrl,
+        ...(auth.project ? { project: auth.project } : {}),
+        fetch: ctx.io.fetch,
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/credentials.d.ts

@@ -0,0 +1,31 @@
+export interface Named {
+    id: string;
+    name: string;
+}
+export interface Profile {
+    apiKey: string;
+    baseUrl?: string;
+    organization: Named;
+    project: Named | null;
+    keyPrefix?: string;
+    createdAt: string;
+}
+export interface Credentials {
+    version: 2;
+    current: string | null;
+    profiles: Record<string, Profile>;
+}
+export declare const EMPTY: Credentials;
+/** `Acme Corp` -> `acme-corp`. Accents dropped; never empty. */
+export declare function slug(text: string): string;
+/** `acme`, or `acme/store-1` for a login scoped to a project. */
+export declare function defaultProfileName(organization: Named, project: Named | null): string;
+/**
+ * The name a new login gets: `wanted` when free or when it holds the same
+ * organization and project (a re-login replaces it), else `wanted-2`, `-3`...
+ */
+export declare function uniqueProfileName(creds: Credentials, wanted: string, profile: Profile): string;
+/** Reads the file, migrating a version-1 file in place. Missing file: no profiles. */
+export declare function loadCredentials(path?: string): Credentials;
+export declare function saveCredentials(creds: Credentials, path?: string): void;
+//# sourceMappingURL=credentials.d.ts.map

package/dist/credentials.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,KAAK,CAAC;IACpB,OAAO,EAAE,KAAK,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,eAAO,MAAM,KAAK,EAAE,WAAyD,CAAC;AAE9E,gEAAgE;AAChE,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUzC;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAErF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAQ9F;AAOD,sFAAsF;AACtF,wBAAgB,eAAe,CAAC,IAAI,GAAE,MAA0B,GAAG,WAAW,CAmC7E;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,GAAE,MAA0B,GAAG,IAAI,CAE1F"}

package/dist/credentials.js

@@ -0,0 +1,90 @@
+// The stored logins: several profiles (an organization, or one project of it),
+// one of them current. `wuapi login` adds one; `--profile` / WUAPI_PROFILE pick
+// one for a command; `wuapi switch` changes the current one.
+//
+// File (0600): { version: 2, current, profiles: { <name>: Profile } }. A
+// version-1 file (one login, written by 0.0.x previews) is read and migrated
+// in place.
+import { credentialsPath } from "./paths.js";
+import { readJson, writePrivateJson } from "./files.js";
+export const EMPTY = { version: 2, current: null, profiles: {} };
+/** `Acme Corp` -> `acme-corp`. Accents dropped; never empty. */
+export function slug(text) {
+    const s = text
+        .normalize("NFKD")
+        .replace(/[̀-ͯ]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 40)
+        .replace(/-+$/g, "");
+    return s || "default";
+}
+/** `acme`, or `acme/store-1` for a login scoped to a project. */
+export function defaultProfileName(organization, project) {
+    return project ? `${slug(organization.name)}/${slug(project.name)}` : slug(organization.name);
+}
+/**
+ * The name a new login gets: `wanted` when free or when it holds the same
+ * organization and project (a re-login replaces it), else `wanted-2`, `-3`...
+ */
+export function uniqueProfileName(creds, wanted, profile) {
+    const same = (p) => p !== undefined && p.organization.id === profile.organization.id && (p.project?.id ?? null) === (profile.project?.id ?? null);
+    if (!creds.profiles[wanted] || same(creds.profiles[wanted]))
+        return wanted;
+    for (let i = 2;; i++) {
+        const name = `${wanted}-${i}`;
+        if (!creds.profiles[name] || same(creds.profiles[name]))
+            return name;
+    }
+}
+function isProfile(v) {
+    const p = v;
+    return typeof p === "object" && p !== null && typeof p.apiKey === "string" && typeof p.organization?.id === "string";
+}
+/** Reads the file, migrating a version-1 file in place. Missing file: no profiles. */
+export function loadCredentials(path = credentialsPath()) {
+    let raw;
+    try {
+        raw = readJson(path);
+    }
+    catch {
+        throw Object.assign(new Error(`${path} is not valid JSON. Delete it and run \`npx @wuapidev/cli login\` again.`), { code: "invalid_credentials" });
+    }
+    if (raw === undefined)
+        return { ...EMPTY, profiles: {} };
+    const r = raw;
+    if (r.version === 2 && typeof r.profiles === "object" && r.profiles !== null) {
+        const profiles = {};
+        for (const [name, p] of Object.entries(r.profiles))
+            if (isProfile(p))
+                profiles[name] = p;
+        const current = typeof r.current === "string" && profiles[r.current] ? r.current : (Object.keys(profiles)[0] ?? null);
+        return { version: 2, current, profiles };
+    }
+    if (r.version === 1 && isProfile(raw)) {
+        const v1 = raw;
+        const profile = {
+            apiKey: v1.apiKey,
+            ...(v1.baseUrl ? { baseUrl: v1.baseUrl } : {}),
+            organization: v1.organization,
+            project: v1.project ?? null,
+            ...(v1.keyPrefix ? { keyPrefix: v1.keyPrefix } : {}),
+            createdAt: v1.createdAt ?? new Date().toISOString(),
+        };
+        const name = defaultProfileName(profile.organization, profile.project);
+        const migrated = { version: 2, current: name, profiles: { [name]: profile } };
+        try {
+            writePrivateJson(path, migrated);
+        }
+        catch {
+            // Read-only config: use the migrated form in memory.
+        }
+        return migrated;
+    }
+    throw Object.assign(new Error(`${path} has an unknown format. Delete it and run \`npx @wuapidev/cli login\` again.`), { code: "invalid_credentials" });
+}
+export function saveCredentials(creds, path = credentialsPath()) {
+    writePrivateJson(path, creds);
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

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

package/dist/dialcodes.d.ts

@@ -0,0 +1,5 @@
+/** `+584121234567` -> `VE`. Undefined when the number does not start with a known code. */
+export declare function countryFromPhone(phone: string): string | undefined;
+/** `+58 412-123 4567` -> `+584121234567`; undefined when it is not a phone number. */
+export declare function normalizePhone(input: string): string | undefined;
+//# sourceMappingURL=dialcodes.d.ts.map

package/dist/dialcodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialcodes.d.ts","sourceRoot":"","sources":["../src/dialcodes.ts"],"names":[],"mappings":"AAmCA,2FAA2F;AAC3F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOlE;AAED,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKhE"}