toolaby 1.3.0 → 1.4.0

package/bin.mjs

@@ -7,6 +7,9 @@
 //   toolaby tools                     your tools, with the ids the commands want
 //   toolaby webhooks events           the six events, with an example of each
 //   toolaby webhooks trigger <event>  send an example delivery: to your registered endpoints, or with --to straight to a local server
+//   toolaby webhooks endpoints        the workspace's endpoints
+//   toolaby webhooks add <url>        register an endpoint; the secret is printed once
+//   toolaby webhooks remove <id>      remove one
 //   toolaby whoami · logout · help
 //
 // Test and live, as Stripe's command line has them: every command acts on
@@ -31,7 +34,7 @@ import { createHmac, randomBytes } from 'node:crypto';
 import { wireManifest, WORKER_LINES } from './lib/manifest.js';
 import { detectProject, CODE_FILES, filesToWrite, BUILD_COPY_NOTE } from './lib/project.js';
 
-const VERSION = '1.3.0';
+const VERSION = '1.4.0';
 const CLIENT_ID = 'toolaby-cli';
 const argv = process.argv.slice(2);
 // `--version` and `--help` are commands of their own; every other command is the first bare word.
@@ -279,9 +282,9 @@ async function webhooks() {
     if (!type) fail('usage: toolaby webhooks trigger <event> [--to <url>] [--secret <whsec_…>]   — `toolaby webhooks events` lists them');
     const to = opt('--to');
     if (!to) {
-      const res = await api('/api/cli/webhooks/trigger', { method: 'POST', body: { type }, token: await tokenOrLogin() });
+      const res = await api('/api/cli/webhooks/trigger', { method: 'POST', body: { type, workspace: opt('--workspace') ?? undefined }, token: await tokenOrLogin() });
       if (!res.ok) fail(res.json.message ?? `The Wall answered HTTP ${res.status}.`);
-      out(`\n  Sent ${res.json.sent} to every endpoint of ${res.json.workspace} · ${side}. Its id is ${res.json.id}; the delivery log is under Configure → API.\n`);
+      out(`\n  Sent ${res.json.sent} to every endpoint of ${res.json.workspace} · ${side}. Its id is ${res.json.id}; the delivery log is under Configure → Webhooks.\n`);
       return;
     }
     const events = await catalogue();
@@ -303,7 +306,34 @@ async function webhooks() {
     if (res.status >= 300) out('  A real delivery would be retried until your server answers 2xx.\n');
     return;
   }
-  fail('usage: toolaby webhooks events | trigger <event> [--to <url>] [--secret <whsec_…>]');
+  if (sub === 'endpoints') {
+    const ws = opt('--workspace');
+    const res = await api(`/api/cli/webhooks/endpoints${ws ? `?workspace=${encodeURIComponent(ws)}` : ''}`, { token: await tokenOrLogin() });
+    if (!res.ok) fail(res.json.message ?? `The Wall answered HTTP ${res.status}.`);
+    out(`\n  ${res.json.workspace} · ${side}\n`);
+    if (res.json.endpoints.length === 0) out('    None yet. `toolaby webhooks add <url>` registers one.');
+    for (const e of res.json.endpoints) out(`    ${e.id}  ${e.disabled ? 'paused ' : 'on     '} ${e.url}${e.description ? `  — ${e.description}` : ''}${e.events.length ? `  (${e.events.join(', ')})` : ''}`);
+    out();
+    return;
+  }
+  if (sub === 'add') {
+    const url = positional[1];
+    if (!url) fail('usage: toolaby webhooks add <url> [--description <text>] [--events a.b,c.d] [--workspace <slug>]');
+    const events = (opt('--events') ?? '').split(',').map((e) => e.trim()).filter(Boolean);
+    const res = await api('/api/cli/webhooks/endpoints', { method: 'POST', body: { url, description: opt('--description') ?? '', events, workspace: opt('--workspace') ?? undefined }, token: await tokenOrLogin() });
+    if (!res.ok) fail(res.json.message ?? `The Wall answered HTTP ${res.status}.`);
+    out(`\n  Added ${res.json.id} → ${res.json.url} · ${res.json.workspace} · ${side}\n\n  Signing secret, shown once — keep it where your server keeps secrets:\n\n    ${res.json.secret}\n`);
+    return;
+  }
+  if (sub === 'remove') {
+    const id = positional[1];
+    if (!id) fail('usage: toolaby webhooks remove <ep_…> [--workspace <slug>]   — `toolaby webhooks endpoints` lists them');
+    const res = await api('/api/cli/webhooks/endpoints', { method: 'DELETE', body: { id, workspace: opt('--workspace') ?? undefined }, token: await tokenOrLogin() });
+    if (!res.ok) fail(res.json.message ?? `The Wall answered HTTP ${res.status}.`);
+    out(`\n  Removed ${res.json.removed} · ${res.json.workspace} · ${side}. Deliveries to it stop at once.\n`);
+    return;
+  }
+  fail('usage: toolaby webhooks events | trigger <event> [--to <url>] | endpoints | add <url> | remove <id>');
 }
 
 function help() {
@@ -317,6 +347,7 @@ function help() {
     toolaby tools                      your tools, with their ids
     toolaby webhooks events            the six events, with an example of each
     toolaby webhooks trigger <event>   an example delivery to your endpoints; --to <url> sends it to a local server instead
+    toolaby webhooks endpoints         your endpoints; add <url> registers one (secret shown once), remove <id> removes one
     toolaby login · whoami · logout    the session, per side; a command that needs one signs you in itself
 
     Every command acts on Test (test.toolaby.app) unless told --live (toolaby.app).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolaby",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "The Toolaby command line: sign in once, then wire any Chrome extension to your tool on the Wall — sign-in, the Free plan, licences and subscriptions — or start a new one.",
   "type": "module",
   "bin": {