@clearlysh/beehaven 0.8.16

package/dist/commands/webhook.js

@@ -0,0 +1,159 @@
+/**
+ * beehaven webhook — outgoing webhook DLQ inspection + replay
+ *
+ * Operates on the `_bh_webhooks` table the SDK's `this.webhooks()` writes
+ * into. Targets one workspace at a time via `<type>/<id>` (same shape as
+ * `beehaven admin sql`).
+ *
+ * Subcommands:
+ *   list <type>/<id> [--status pending|dead|delivered] [--event NAME] [--limit N]
+ *   show <type>/<id> <eventId>
+ *   replay <type>/<id> <eventId>      Re-arms the row; the next alarm tick drains it.
+ *   dlq <type>/<id>                   Shortcut for `list --status dead`
+ *
+ * Auth: --url + --secret (or BEEHAVEN_WORKER_URL / BEEHAVEN_ADMIN_SECRET).
+ */
+import { color, spinner, table } from '../spinner.js';
+import { getAdminClient, doActionPath } from '../lib/admin-client.js';
+function parseTarget(input) {
+    if (!input || !input.includes('/')) {
+        return { error: 'Target must be <type>/<id> — e.g. User/abc123' };
+    }
+    const [type, id] = input.split('/', 2);
+    return { type, id };
+}
+function fmtTime(ms) {
+    if (!ms)
+        return '—';
+    const n = typeof ms === 'string' ? Number(ms) : ms;
+    if (!isFinite(n))
+        return '—';
+    const d = new Date(n);
+    const today = new Date();
+    if (d.toDateString() === today.toDateString())
+        return d.toTimeString().slice(0, 8);
+    return d.toISOString().slice(0, 19).replace('T', ' ');
+}
+function statusColor(s) {
+    if (s === 'dead')
+        return color.red(s);
+    if (s === 'pending')
+        return color.yellow(s);
+    if (s === 'delivered')
+        return color.green(s);
+    return s;
+}
+async function runSql(client, t, query) {
+    const { ok, status, body } = await client.call(doActionPath(t.type, t.id, 'admin:sql'), {
+        method: 'POST',
+        body: { query },
+    });
+    if (!ok) {
+        console.error(color.red(`HTTP ${status}: ${body?.error ?? 'unknown'}`));
+        return null;
+    }
+    return body?.rows ?? [];
+}
+export async function webhook(opts) {
+    const client = getAdminClient({ url: opts.url, secret: opts.secret });
+    if ('error' in client) {
+        console.error(color.red(client.error));
+        process.exit(1);
+    }
+    const sub = opts.subcommand ?? 'list';
+    switch (sub) {
+        case 'list':
+        case 'dlq': {
+            const t = parseTarget(opts.positionals[0]);
+            if ('error' in t) {
+                console.error(t.error);
+                process.exit(1);
+            }
+            const limit = opts.limit ? parseInt(opts.limit) : 50;
+            const status = sub === 'dlq' ? 'dead' : opts.status;
+            const filters = [];
+            if (status)
+                filters.push(`status = '${status.replace(/'/g, '')}'`);
+            const where = filters.length ? `WHERE ${filters.join(' AND ')}` : '';
+            const sp = spinner(`Loading webhooks from ${t.type}/${t.id}…`).start();
+            const rows = await runSql(client, t, `SELECT id, event, status, attempts, created_at, last_error FROM _bh_webhooks ${where} ORDER BY created_at DESC LIMIT ${limit}`);
+            if (!rows) {
+                sp.fail('Query failed');
+                process.exit(1);
+            }
+            sp.succeed(`${rows.length} events`);
+            if (opts.json) {
+                console.log(JSON.stringify(rows, null, 2));
+                return;
+            }
+            if (rows.length === 0) {
+                console.log(color.dim('(no webhooks)'));
+                return;
+            }
+            console.log('');
+            console.log(table(['ID', 'Event', 'Status', 'Tries', 'Created', 'Last Error'], rows.map((r) => [
+                color.cyan(String(r.id).slice(0, 12)),
+                r.event ?? '—',
+                statusColor(r.status ?? '—'),
+                String(r.attempts ?? 0),
+                fmtTime(r.created_at),
+                r.last_error ? color.dim(String(r.last_error).slice(0, 40)) : '—',
+            ])));
+            return;
+        }
+        case 'show': {
+            const t = parseTarget(opts.positionals[0]);
+            if ('error' in t) {
+                console.error(t.error);
+                process.exit(1);
+            }
+            const eventId = opts.positionals[1];
+            if (!eventId) {
+                console.error('Usage: beehaven webhook show <type>/<id> <eventId>');
+                process.exit(1);
+            }
+            const sp = spinner(`Loading ${eventId}…`).start();
+            const rows = await runSql(client, t, `SELECT * FROM _bh_webhooks WHERE id = '${eventId.replace(/'/g, "''")}'`);
+            if (!rows) {
+                sp.fail('Query failed');
+                process.exit(1);
+            }
+            sp.succeed(rows.length ? 'Found' : 'Not found');
+            if (rows.length === 0)
+                process.exit(1);
+            console.log(JSON.stringify(rows[0], null, 2));
+            return;
+        }
+        case 'replay': {
+            const t = parseTarget(opts.positionals[0]);
+            if ('error' in t) {
+                console.error(t.error);
+                process.exit(1);
+            }
+            const eventId = opts.positionals[1];
+            if (!eventId) {
+                console.error('Usage: beehaven webhook replay <type>/<id> <eventId>');
+                process.exit(1);
+            }
+            const escaped = eventId.replace(/'/g, "''");
+            const sp = spinner(`Re-arming ${eventId}…`).start();
+            const rows = await runSql(client, t, `UPDATE _bh_webhooks SET status = 'pending', attempts = 0, next_retry_at = ${Date.now()}, last_error = NULL, delivered_at = NULL WHERE id = '${escaped}' RETURNING id`);
+            if (!rows) {
+                sp.fail('Update failed');
+                process.exit(1);
+            }
+            if (rows.length === 0) {
+                sp.fail(`No webhook with id ${eventId}`);
+                process.exit(1);
+            }
+            sp.succeed(`Re-armed ${eventId}`);
+            console.log(color.dim('  Status flipped to pending — the next alarm tick will drain it.'));
+            console.log(color.dim('  For an immediate drain, expose a `webhook-drain` action on your workspace.'));
+            return;
+        }
+        default:
+            console.error(`Unknown webhook subcommand: ${sub}`);
+            console.error('Use: list | dlq | show | replay');
+            process.exit(1);
+    }
+}