toolaby 1.3.0 → 1.4.1

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.1';
 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.
@@ -39,7 +42,8 @@ const command = argv.find((a) => ['--version', '-v', '--help', '-h'].includes(a)
 const rest = argv.filter((a) => a !== command);
 const positional = rest.filter((a) => !a.startsWith('--'));
 const opt = (k, d = null) => { const i = rest.indexOf(k); return i >= 0 && rest[i + 1] && !rest[i + 1].startsWith('--') ? rest[i + 1] : d; };
-const flag = (k) => rest.includes(k);
+// `upgrade` is `wire --force`: the platform's files replaced with the current ones, the extension's own untouched.
+const flag = (k) => rest.includes(k) || (k === '--force' && command === 'upgrade');
 const WALLS = { test: 'https://test.toolaby.app', live: 'https://toolaby.app' };
 const live = flag('--live');
 const wall = (opt('--wall') ?? process.env.TOOLABY_WALL ?? (live ? WALLS.live : WALLS.test)).replace(/\/$/, '');
@@ -183,7 +187,7 @@ async function filesFor(slug, scaffold, manifestKey = null) {
 
 async function wire() {
   const slug = positional[0];
-  if (!isId(slug)) fail('usage: toolaby wire <tool-id> [--into <folder>] [--force]   — `toolaby tools` lists your ids');
+  if (!isId(slug)) fail(command === 'upgrade' ? 'usage: toolaby upgrade <tool-id> [--into <folder>]   — `toolaby tools` lists your ids' : 'usage: toolaby wire <tool-id> [--into <folder>] [--force]   — `toolaby tools` lists your ids');
   const dir = resolve(opt('--into') ?? '.');
   if (!existsSync(dir)) fail(`${dir} does not exist`);
   const tree = listTree(dir, 3);
@@ -279,9 +283,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 +307,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() {
@@ -313,10 +344,12 @@ function help() {
     toolaby wire <tool-id>             wire the extension in this folder to your tool, on Test
     toolaby wire <tool-id> --live      the same, on Live: the store build
                                        --into <folder>   another folder     --force   replace the platform's files
+    toolaby upgrade <tool-id>          the platform's files replaced with the current ones — the popup, the client — yours untouched
     toolaby create <tool-id>           a new, minimal extension for your tool, in <tool-id>/   --dir <folder>
     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).
@@ -324,7 +357,7 @@ function help() {
 `);
 }
 
-const commands = { login: async () => { await login(); }, logout, whoami, tools, wire, create, webhooks, help, '--help': help, '-h': help, '--version': () => out(VERSION), '-v': () => out(VERSION) };
+const commands = { login: async () => { await login(); }, logout, whoami, tools, wire, upgrade: wire, create, webhooks, help, '--help': help, '-h': help, '--version': () => out(VERSION), '-v': () => out(VERSION) };
 const run = commands[command];
 if (!run) { console.error(`\n  Unknown command "${command}".`); help(); process.exit(1); }
 Promise.resolve().then(run).catch((e) => fail(e.message));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "toolaby",
-  "version": "1.3.0",
+  "version": "1.4.1",
   "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": {