@nodium.io/cli 0.2.0 → 0.2.1

package/README.md

@@ -134,7 +134,8 @@ Listening from now → http://localhost:3000/webhook
 
 ## Output and exit codes
 
-- `--output human` (the default in a terminal): short lines and tables.
+- `--output human` (the default in a terminal): short lines and tables, then a
+  `Next:` block with the commands that usually come next.
 - `--output json` (the default when the output is piped): the object the SDK
   returns, unchanged, on stdout. A refusal goes to stderr as
   `{ "error": { "status", "code", "message", "requestId" } }`.

package/dist/commands/account.js

@@ -1,6 +1,7 @@
-import { Nodium } from '@nodium.io/whatsapp';
+import { Nodium, NodiumError } from '@nodium.io/whatsapp';
 import { UsageError, flag, readInteger } from '../args.js';
-import { deleteConfig, maskKey, writeConfig } from '../config.js';
+import { deleteConfig, maskKey, resolveKey, writeConfig } from '../config.js';
+import { take } from '../context.js';
 import { paint, table, when } from '../output.js';
 /**
  * La clé et le compte : `login`, `logout`, `status`, `health`, `events`.
@@ -13,16 +14,17 @@ export function numberState(channel) {
         return 'payment missing';
     return channel.qualityRating ? `on (${channel.qualityRating.toLowerCase()})` : 'on';
 }
-/** Ce qu'il reste à faire, d'après les numéros et les abonnements. */
-export function nextSteps(numbers, activeWebhooks) {
-    const steps = [];
+/**
+ * Les commandes à lancer ensuite, d'après les numéros et les abonnements.
+ * `activeWebhooks` à `null` : la clé ne lit pas les abonnements, rien n'est
+ * conseillé à leur sujet.
+ */
+export function nextSteps(numbers, activeWebhooks, seesAllClients) {
     if (!numbers)
-        steps.push('Connect a WhatsApp number: `nodium tenants list`, then `nodium connect-link new --tenant <id>` and open the link.');
-    if (!activeWebhooks)
-        steps.push('Receive messages: `nodium webhooks new --url <https://…> --event message.received`, or `nodium listen --forward <local url>` while you build.');
-    if (numbers && activeWebhooks)
-        steps.push('All set: try `nodium send --channel <id> --to <+33…> --text "Hello"`.');
-    return steps;
+        return seesAllClients ? ['nodium tenants list', 'nodium connect-link new --tenant <id>'] : ['nodium connect-link new'];
+    if (activeWebhooks === 0)
+        return ['nodium listen --forward <local url>', 'nodium webhooks new --url <https://…> --event message.received'];
+    return ['nodium numbers list', 'nodium send --channel <id> --to <+33…> --text "Hello"'];
 }
 async function login(ctx) {
     let key = flag(ctx.args, 'key');
@@ -40,7 +42,7 @@ async function login(ctx) {
     ctx.print({ key: current, saved: ctx.configPath }, () => {
         ctx.output.out(`${paint(ctx.output, 'green', 'Logged in')} with ${maskKey(key)} (account ${current.accountId}${current.pinned ? ', pinned to one client' : ''}).`);
         ctx.output.out(paint(ctx.output, 'dim', `Saved to ${ctx.configPath} (readable by you only). NODIUM_KEY and --key still win over it.`));
-    });
+    }, ['nodium status']);
     return 0;
 }
 async function logout(ctx) {
@@ -52,32 +54,45 @@ async function logout(ctx) {
     });
     return 0;
 }
+/** Au-delà, `status` écrit « 1000+ » : compter tous les clients d'un gros compte serait long. */
+const CLIENTS_COUNTED = 1000;
 async function status(ctx) {
     const nodium = ctx.nodium();
     const key = await nodium.keys.current();
     const tenant = flag(ctx.args, 'tenant');
+    const seesAll = !tenant && !key.pinned;
     // Une clé du compte, sans client nommé, voit les numéros de tous ses clients.
-    const numbers = !tenant && !key.pinned
-        ? await nodium.channels.list({ scope: 'account' })
-        : await ctx.scope().channels.list();
-    const { subscriptions } = await ctx.scope().webhooks.list();
-    const active = subscriptions.filter(s => s.isActive).length;
-    const next = nextSteps(numbers.filter(n => !n.isTest).length, active);
-    ctx.print({ key, numbers, webhooks: { total: subscriptions.length, active }, next }, () => {
+    const [numbers, clients, subscriptions] = await Promise.all([
+        seesAll ? nodium.channels.list({ scope: 'account' }) : ctx.scope().channels.list(),
+        // « Mon entreprise » n'est pas dans la liste des clients.
+        seesAll ? take(nodium.tenants.each({ limit: 100 }), CLIENTS_COUNTED).then(items => items.length) : Promise.resolve(null),
+        // Une clé épinglée à « Mon entreprise » ne lit pas ses abonnements (404) :
+        // ils portent les événements de tous les clients.
+        ctx.scope().webhooks.list().then(r => r.subscriptions, (error) => {
+            if (error instanceof NodiumError && error.status === 404)
+                return null;
+            throw error;
+        })
+    ]);
+    const connected = numbers.filter(n => !n.isTest);
+    const active = subscriptions ? subscriptions.filter(s => s.isActive).length : null;
+    const next = nextSteps(connected.length, active, seesAll);
+    const webhooks = subscriptions ? { total: subscriptions.length, active } : null;
+    ctx.print({ key, clients, numbers, webhooks, next }, () => {
         const { out } = ctx.output;
-        out(paint(ctx.output, 'bold', 'Key'));
-        out(`  account ${key.accountId} · ${key.pinned ? 'pinned to one client' : 'acts for every client'} · ${key.expiresAt ? `expires ${when(key.expiresAt)}` : 'never expires'}`);
-        out(paint(ctx.output, 'bold', `Numbers (${numbers.length})`));
-        if (!numbers.length)
-            out('  none connected');
-        for (const line of table(numbers.map(n => [n.id, n.identity, n.name, numberState(n) + (n.isTest ? ' · sandbox' : '')])))
-            out(`  ${line}`);
-        out(paint(ctx.output, 'bold', 'Webhooks'));
-        out(`  ${subscriptions.length} subscription${subscriptions.length === 1 ? '' : 's'}, ${active} active`);
-        out(paint(ctx.output, 'bold', 'Next'));
-        for (const step of next)
-            out(`  ${step}`);
-    });
+        const label = key.label ? ` "${key.label}"` : '';
+        const scope = key.client
+            ? `pinned to ${key.client.isHome ? 'My company' : `"${key.client.name}"`} (${key.client.id})`
+            : 'every client of the account';
+        out(`Authentication: ${paint(ctx.output, 'green', 'authenticated')}`);
+        out(`Key: ${maskKey(resolveKey(flag(ctx.args, 'key'), ctx.env, ctx.config).key)}${label}, ${key.expiresAt ? `expires ${when(key.expiresAt)}` : 'never expires'}`);
+        out(`Account: ${key.accountName} (${key.accountId})`);
+        out(`Access: ${scope}`);
+        if (clients !== null)
+            out(`Clients: ${clients >= CLIENTS_COUNTED ? `${CLIENTS_COUNTED}+` : clients}`);
+        out(`WhatsApp Numbers: ${connected.length}${connected.length ? ` (${connected.filter(n => n.isActive).length} on)` : ''}`);
+        out(`Webhooks: ${subscriptions ? `${active} active of ${subscriptions.length}` : 'not visible with this key (pinned to My company)'}`);
+    }, next);
     return 0;
 }
 async function health(ctx) {
@@ -86,7 +101,7 @@ async function health(ctx) {
         ctx.output.out(result.healthy ? paint(ctx.output, 'green', 'Healthy.') : paint(ctx.output, 'red', 'Something needs your attention:'));
         for (const alert of result.alerts)
             ctx.output.out(`  ${alert.level.padEnd(8)} ${alert.code}  ${alert.message} (number ${alert.channelId})`);
-    });
+    }, result.healthy ? [] : [...new Set(result.alerts.map(a => `nodium numbers check ${a.channelId}`))]);
     return result.healthy ? 0 : 1;
 }
 async function events(ctx) {
@@ -100,9 +115,7 @@ async function events(ctx) {
             ctx.output.out(`The log is at event #${page.next_after}. Read what comes next with --after ${page.next_after}.`);
         for (const line of table(page.data.map(e => [String(e.seq), when(e.occurred_at), e.event, e.id, e.external_id ?? ''])))
             ctx.output.out(line);
-        if (after !== null)
-            ctx.output.out(paint(ctx.output, 'dim', `Next: --after ${page.next_after}`));
-    });
+    }, [`nodium events --after ${page.next_after}`]);
     return 0;
 }
 export const ACCOUNT_COMMANDS = [

package/dist/commands/conversations.js

@@ -25,12 +25,12 @@ async function listConversations(ctx) {
             c.window.open ? 'window open' : 'window closed', when(c.lastInboundAt)
         ])))
             ctx.output.out(line);
-    });
+    }, items.length ? [`nodium messages list ${items[0].id}`] : ['nodium listen --forward <local url>']);
     return 0;
 }
 async function getConversation(ctx) {
     const conversation = await ctx.scope().conversations.get(ctx.args.positionals[0]);
-    ctx.print(conversation, () => details(conversation).forEach(line => ctx.output.out(line)));
+    ctx.print(conversation, () => details(conversation).forEach(line => ctx.output.out(line)), [`nodium messages list ${conversation.id}`]);
     return 0;
 }
 async function listMessages(ctx) {
@@ -41,7 +41,7 @@ async function listMessages(ctx) {
             when(m.createdAt), m.direction === 'inbound' ? '←' : '→', m.status, m.id, preview(m.textContent, m.type)
         ])))
             ctx.output.out(line);
-    });
+    }, items.length ? [`nodium messages get ${items[0].id}`] : []);
     return 0;
 }
 async function getMessage(ctx) {
@@ -58,12 +58,12 @@ async function listContacts(ctx) {
             c.id, c.displayName ?? '—', c.phone ?? c.email ?? c.externalId ?? '—', c.optInAt ? 'opted in' : c.optOutAt ? 'opted out' : '', c.blocked ? 'blocked' : ''
         ])))
             ctx.output.out(line);
-    });
+    }, items.length ? [`nodium contacts get ${items[0].id}`] : []);
     return 0;
 }
 async function getContact(ctx) {
     const contact = await ctx.scope().contacts.get(ctx.args.positionals[0]);
-    ctx.print(contact, () => details(contact).forEach(line => ctx.output.out(line)));
+    ctx.print(contact, () => details(contact).forEach(line => ctx.output.out(line)), [`nodium conversations list --contact ${contact.id}`]);
     return 0;
 }
 const LIMIT_HELP = '  --limit <n>       At most n items, newest first (default 20); pages are followed for you.';

package/dist/commands/flows.js

@@ -52,9 +52,11 @@ async function deploy(ctx) {
             out(`${paint(ctx.output, 'green', 'Published')}: ${published.name} can now be sent.`);
         }
         else {
-            out(paint(ctx.output, 'dim', `Valid. Publish it with --publish --id ${flowId} once tested.`));
+            out('Valid.');
         }
-    });
+    }, errors.length
+        ? [`nodium flows deploy ${file} --id ${flowId}`]
+        : published ? [] : [`nodium flows deploy ${file} --id ${flowId} --publish`]);
     return errors.length ? 1 : 0;
 }
 export const FLOW_COMMANDS = [

package/dist/commands/numbers.js

@@ -9,15 +9,17 @@ async function list(ctx) {
     const numbers = await ctx.scope().channels.list(hasFlag(ctx.args, 'all') ? { scope: 'account' } : {});
     ctx.print(numbers, () => {
         if (!numbers.length)
-            ctx.output.out('No number connected. Send your client a link: `nodium connect-link new --tenant <id>`.');
+            ctx.output.out('No number connected.');
         for (const line of table(numbers.map(n => [n.id, n.identity, n.name, numberState(n) + (n.isTest ? ' · sandbox' : '')])))
             ctx.output.out(line);
-    });
+    }, numbers.length
+        ? [`nodium numbers check ${numbers[0].id}`, `nodium send --channel ${numbers[0].id} --to <+33…> --text "Hello"`]
+        : ['nodium connect-link new --tenant <id>']);
     return 0;
 }
 async function get(ctx) {
     const number = await ctx.scope().channels.get(ctx.args.positionals[0]);
-    ctx.print(number, () => details(number).forEach(line => ctx.output.out(line)));
+    ctx.print(number, () => details(number).forEach(line => ctx.output.out(line)), [`nodium numbers check ${number.id}`, `nodium send --channel ${number.id} --to <+33…> --text "Hello"`]);
     return 0;
 }
 async function check(ctx) {
@@ -28,7 +30,7 @@ async function check(ctx) {
             ctx.output.out(result.message);
         if (result.number)
             details(result.number).forEach(line => ctx.output.out(`  ${line}`));
-    });
+    }, result.ok ? [`nodium send --channel ${ctx.args.positionals[0]} --to <+33…> --text "Hello"`] : ['nodium health']);
     return result.ok ? 0 : 1;
 }
 export const NUMBER_COMMANDS = [

package/dist/commands/templates.js

@@ -24,13 +24,23 @@ export function parseDuration(text) {
 }
 /** L'attente entre deux questions à Meta. */
 export const WAIT_INTERVAL_MS = 15_000;
+/** Ce qui suit un modèle, d'après son verdict chez Meta. */
+function templateNext(id, name, outcome) {
+    if (outcome === 'approved')
+        return [`nodium send --channel <id> --to <+33…> --template ${name} --language <code>`];
+    if (outcome === 'not_deployed')
+        return [`nodium templates deploy ${id}`];
+    if (outcome === 'pending')
+        return [`nodium templates wait ${id}`];
+    return [`nodium templates update ${id} --input <file.json>`, `nodium templates deploy ${id}`];
+}
 async function list(ctx) {
     const result = await ctx.scope().templates.list(hasFlag(ctx.args, 'all') ? { scope: 'account' } : {});
     ctx.print(result, () => {
         for (const line of table(result.templates.map(t => [t.id, t.name, t.language, t.category.toLowerCase(), t.status])))
             ctx.output.out(line);
         ctx.output.out(paint(ctx.output, 'dim', `${result.summary.total} templates: ${result.summary.deployed} deployed, ${result.summary.draft} drafts.`));
-    });
+    }, result.templates.length ? [`nodium templates get ${result.templates[0].id}`] : ['nodium templates new --input <file.json>']);
     return 0;
 }
 async function get(ctx) {
@@ -41,7 +51,7 @@ async function get(ctx) {
             ctx.output.out(paint(ctx.output, 'bold', 'At Meta'));
         for (const line of table(result.deployments.map(d => [d.wabaId ?? '—', d.status, d.rejectionReason ?? '', when(d.reviewedAt)])))
             ctx.output.out(`  ${line}`);
-    });
+    }, templateNext(result.template.id, result.template.name, templateOutcome(result.deployments)));
     return 0;
 }
 async function requireInput(ctx) {
@@ -54,13 +64,12 @@ async function create(ctx) {
     const result = await ctx.scope().templates.create(await requireInput(ctx));
     ctx.print(result, () => {
         ctx.output.out(`${paint(ctx.output, 'green', 'Draft saved')}: ${result.template.name} (${result.template.id}). Nothing went to Meta yet.`);
-        ctx.output.out(paint(ctx.output, 'dim', `Next: nodium templates deploy ${result.template.id}`));
-    });
+    }, [`nodium templates deploy ${result.template.id}`]);
     return 0;
 }
 async function update(ctx) {
     const result = await ctx.scope().templates.update(ctx.args.positionals[0], await requireInput(ctx));
-    ctx.print(result, () => ctx.output.out(`Saved: ${result.template.name} (${result.template.status}).`));
+    ctx.print(result, () => ctx.output.out(`Saved: ${result.template.name} (${result.template.status}).`), [`nodium templates deploy ${result.template.id}`]);
     return 0;
 }
 async function deploy(ctx) {
@@ -71,21 +80,19 @@ async function deploy(ctx) {
     ctx.print(result, () => {
         for (const line of table(result.results.map(r => [r.clientName, r.wabaId ?? '—', r.status, r.reason ?? ''])))
             ctx.output.out(line);
-        if (!refused)
-            ctx.output.out(paint(ctx.output, 'dim', `Wait for Meta's review: nodium templates wait ${id}`));
-    });
+    }, refused ? [`nodium templates update ${id} --input <file.json>`] : [`nodium templates wait ${id}`]);
     return refused ? 1 : 0;
 }
 async function refresh(ctx) {
     const result = await ctx.scope().templates.refresh(ctx.args.positionals[0]);
-    ctx.print(result, () => ctx.output.out(`${result.template.name}: ${result.template.status} (${result.changed} changed).`));
+    ctx.print(result, () => ctx.output.out(`${result.template.name}: ${result.template.status} (${result.changed} changed).`), [`nodium templates get ${result.template.id}`]);
     return 0;
 }
 async function remove(ctx) {
     const id = ctx.args.positionals[0];
     await ctx.confirm(`Delete template ${id}`);
     const result = await ctx.scope().templates.delete(id);
-    ctx.print(result, () => ctx.output.out(result.deleted ? `Template ${id} deleted.` : `Template ${id} was not deleted.`));
+    ctx.print(result, () => ctx.output.out(result.deleted ? `Template ${id} deleted.` : `Template ${id} was not deleted.`), ['nodium templates list']);
     return result.deleted ? 0 : 1;
 }
 async function wait(ctx) {
@@ -110,9 +117,8 @@ async function wait(ctx) {
                     err(paint(ctx.output, 'red', `${detail.template.name} was not approved.`));
                     for (const d of detail.deployments.filter(d => REFUSED.has(d.status)))
                         err(`  ${d.wabaId ?? '—'}  ${d.status}  ${d.rejectionReason ?? ''}`);
-                    err('Fix it with `nodium templates update`, then deploy again.');
                 }
-            });
+            }, templateNext(id, detail.template.name, outcome));
             return outcome === 'approved' ? 0 : 1;
         }
         if (!ctx.json)

package/dist/commands/tenants.js

@@ -28,12 +28,14 @@ async function list(ctx) {
     ctx.print(items, () => {
         for (const line of table(items.map(t => [t.id, t.externalId ?? '—', t.name, `WhatsApp ${t.whatsapp.status.replace('_', ' ')}`, t.status])))
             ctx.output.out(line);
-    });
+    }, items.length ? [`nodium tenants get ${items[0].externalId ?? items[0].id}`] : ['nodium tenants new --name "<client name>" --connect-link']);
     return 0;
 }
 async function get(ctx) {
     const tenant = await ctx.nodium().tenants.get(ctx.args.positionals[0]);
-    ctx.print(tenant, () => details(tenant).forEach(line => ctx.output.out(line)));
+    ctx.print(tenant, () => details(tenant).forEach(line => ctx.output.out(line)), tenant.whatsapp.status === 'connected'
+        ? [`nodium numbers list --tenant ${tenant.externalId ?? tenant.id}`]
+        : [`nodium connect-link new --tenant ${tenant.externalId ?? tenant.id}`]);
     return 0;
 }
 async function create(ctx) {
@@ -50,14 +52,13 @@ async function create(ctx) {
         ctx.print(tenant, () => {
             ctx.output.out(`${paint(ctx.output, 'green', 'Client added')}: ${tenant.name} (${tenant.id}).`);
             printLink(ctx, tenant.connectLink.url, tenant.connectLink.expiresAt);
-        });
+        }, [`nodium tenants get ${tenant.externalId ?? tenant.id}`]);
         return 0;
     }
     const tenant = await tenants.create(input);
     ctx.print(tenant, () => {
         ctx.output.out(`${paint(ctx.output, 'green', 'Client added')}: ${tenant.name} (${tenant.id}).`);
-        ctx.output.out(paint(ctx.output, 'dim', `Next: nodium connect-link new --tenant ${tenant.externalId ?? tenant.id}`));
-    });
+    }, [`nodium connect-link new --tenant ${tenant.externalId ?? tenant.id}`]);
     return 0;
 }
 async function newLink(ctx) {
@@ -67,7 +68,7 @@ async function newLink(ctx) {
     const input = linkInput(ctx);
     await ctx.confirm(`Create a connect link for client ${tenant}`);
     const link = await ctx.nodium().tenants.connectLink(tenant, input);
-    ctx.print(link, () => printLink(ctx, link.url, link.expiresAt));
+    ctx.print(link, () => printLink(ctx, link.url, link.expiresAt), [`nodium tenants get ${tenant}`]);
     return 0;
 }
 const LINK_HELP = `  --redirect-url <https://…>   Where your client lands once connected.

package/dist/commands/webhooks.js

@@ -25,12 +25,14 @@ async function list(ctx) {
     const result = await ctx.scope().webhooks.list();
     ctx.print(result, () => {
         if (!result.subscriptions.length)
-            ctx.output.out('No subscription. Add one: nodium webhooks new --url <https://…> --event message.received');
+            ctx.output.out('No subscription.');
         for (const line of table(result.subscriptions.map(s => [
             s.id, s.isActive ? 'active' : `paused${s.disabledReason ? ` (${s.disabledReason})` : ''}`, s.url, s.events.join(','), s.lastError ? `last error: ${s.lastError}` : ''
         ])))
             ctx.output.out(line);
-    });
+    }, result.subscriptions.length
+        ? [`nodium webhooks test ${result.subscriptions[0].id}`, 'nodium webhooks deliveries --failed']
+        : ['nodium webhooks new --url <https://…> --event message.received', 'nodium listen --forward <local url>']);
     return 0;
 }
 async function deliveries(ctx) {
@@ -47,9 +49,7 @@ async function deliveries(ctx) {
             when(d.createdAt), d.id, d.event, d.status, d.responseStatus === null ? '—' : String(d.responseStatus), `${d.attempts} attempt${d.attempts === 1 ? '' : 's'}`, d.lastError ?? ''
         ])))
             ctx.output.out(line);
-        if (items.some(d => d.status === 'failed'))
-            ctx.output.out(paint(ctx.output, 'dim', 'Send one again: nodium webhooks redeliver <deliveryId>'));
-    });
+    }, items.find(d => d.status === 'failed') ? [`nodium webhooks redeliver ${items.find(d => d.status === 'failed').id}`] : []);
     return 0;
 }
 async function create(ctx) {
@@ -66,8 +66,7 @@ async function create(ctx) {
     ctx.print(result, () => {
         ctx.output.out(`${paint(ctx.output, 'green', 'Subscribed')}: ${result.id}`);
         printSecret(ctx, result.secret);
-        ctx.output.out(paint(ctx.output, 'dim', `Try it: nodium webhooks test ${result.id}`));
-    });
+    }, [`nodium webhooks test ${result.id}`]);
     return 0;
 }
 async function update(ctx) {
@@ -93,14 +92,14 @@ async function update(ctx) {
         throw new UsageError('Nothing to change: give --url, --event, --channel, --label or --active.');
     await ctx.confirm(`Change webhook ${id} (${Object.keys(input).join(', ')})`);
     const subscription = await ctx.scope().webhooks.update(id, input);
-    ctx.print(subscription, () => ctx.output.out(`Saved: ${subscription.id} → ${subscription.url} (${subscription.isActive ? 'active' : 'paused'}).`));
+    ctx.print(subscription, () => ctx.output.out(`Saved: ${subscription.id} → ${subscription.url} (${subscription.isActive ? 'active' : 'paused'}).`), [`nodium webhooks test ${subscription.id}`]);
     return 0;
 }
 async function remove(ctx) {
     const id = ctx.args.positionals[0];
     await ctx.confirm(`Delete webhook ${id}: Nodium stops calling it`);
     const result = await ctx.scope().webhooks.delete(id);
-    ctx.print(result ?? { deleted: true }, () => ctx.output.out(`Webhook ${id} deleted.`));
+    ctx.print(result ?? { deleted: true }, () => ctx.output.out(`Webhook ${id} deleted.`), ['nodium webhooks list']);
     return 0;
 }
 async function test(ctx) {
@@ -109,14 +108,14 @@ async function test(ctx) {
         ctx.output.out(result.ok
             ? `${paint(ctx.output, 'green', String(result.status))}  answered in ${result.ms} ms.`
             : `${paint(ctx.output, 'red', result.status === null ? 'ERR' : String(result.status))}  ${result.error ?? 'not a 2xx answer'} (${result.ms} ms).`);
-    });
+    }, result.ok ? ['nodium webhooks deliveries'] : [`nodium webhooks update ${ctx.args.positionals[0]} --url <https://…>`]);
     return result.ok ? 0 : 1;
 }
 async function redeliver(ctx) {
     const id = ctx.args.positionals[0];
     await ctx.confirm(`Send delivery ${id} again`);
     const delivery = await ctx.scope().webhooks.redeliver(id);
-    ctx.print(delivery, () => ctx.output.out(`Delivery ${delivery.id}: ${delivery.status}${delivery.responseStatus ? ` (${delivery.responseStatus})` : ''}.`));
+    ctx.print(delivery, () => ctx.output.out(`Delivery ${delivery.id}: ${delivery.status}${delivery.responseStatus ? ` (${delivery.responseStatus})` : ''}.`), ['nodium webhooks deliveries']);
     return delivery.status === 'failed' ? 1 : 0;
 }
 async function rotateSecret(ctx) {

package/dist/output.js

@@ -4,6 +4,15 @@ const CODES = { dim: 2, red: 31, green: 32, yellow: 33, cyan: 36, bold: 1 };
 export function paint(output, style, text) {
     return output.color ? `\u001b[${CODES[style]}m${text}\u001b[0m` : text;
 }
+/** Le bloc « Next: » : les commandes à lancer ensuite, une par ligne. */
+export function printNext(output, steps) {
+    if (!steps?.length)
+        return;
+    output.out('');
+    output.out('Next:');
+    for (const step of steps)
+        output.out(`  ${step}`);
+}
 /** L'heure locale, `HH:MM:SS`. */
 export function clock(date = new Date()) {
     return date.toTimeString().slice(0, 8);

package/dist/run.js

@@ -6,7 +6,7 @@ import { COMMANDS, findCommands } from './commands/index.js';
 import { configPath as defaultConfigPath, readConfig, resolveKey } from './config.js';
 import { confirmWrite, outputMode } from './context.js';
 import { pause } from './listen.js';
-import { describeError, errorJson, paint, table } from './output.js';
+import { describeError, errorJson, paint, table, printNext } from './output.js';
 /**
  * La commande `nodium` : lit la ligne de commande, cherche la commande dans la
  * table (`commands/index.ts`), branche le client, rend le code de sortie
@@ -147,7 +147,12 @@ export async function run(argv, context) {
                 const tenant = flag(args, 'tenant');
                 return tenant ? nodium().as(tenant) : nodium();
             },
-            print: (data, human) => (json ? output.out(JSON.stringify(data, null, 2)) : human()),
+            print: (data, human, next) => {
+                if (json)
+                    return output.out(JSON.stringify(data, null, 2));
+                human();
+                printNext(output, next);
+            },
             confirm: what => confirmWrite(what, { yes: hasFlag(args, 'yes'), interactive, ask: io.ask })
         };
         if (command.needsKey !== false)

package/dist/send.js

@@ -85,8 +85,7 @@ async function send(ctx) {
             return;
         }
         output.out(`${paint(output, 'green', message.status)}  message ${message.id} to ${target}${result.duplicate ? ' (already sent with this idempotency key: nothing left again)' : ''}`);
-        output.out(paint(output, 'dim', `Follow it: nodium messages get ${message.id}`));
-    });
+    }, message ? [`nodium messages get ${message.id}`] : []);
     return failed ? 1 : 0;
 }
 export const SEND_COMMAND = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nodium.io/cli",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "The nodium command: the Nodium WhatsApp API from your terminal — numbers, conversations, templates, webhooks, clients, Flows — and your webhooks replayed to your local server, signed like production.",
   "keywords": ["nodium", "cli", "whatsapp", "whatsapp-api", "whatsapp-cloud-api", "webhooks", "local-development"],
   "homepage": "https://nodium.io/en/docs/api",
@@ -17,7 +17,7 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@nodium.io/whatsapp": "^0.3.0"
+    "@nodium.io/whatsapp": "^0.3.1"
   },
   "devDependencies": {
     "@types/node": "^26.4.0",