@profullstack/nichedb 0.50.0 → 0.52.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/nichedb",
-  "version": "0.50.0",
+  "version": "0.52.0",
   "description": "CLI and MCP bridge for NicheDB: browse collections, manage sources and feeds, search items, from any deployment",
   "type": "module",
   "main": "src/index.js",

package/src/index.js

@@ -15,7 +15,7 @@ import { homedir, tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { createInterface } from 'node:readline';
 
-export const VERSION = '0.50.0';
+export const VERSION = '0.52.0';
 const GEO_FLAGS = ['lat', 'long', 'radius', 'unit', 'bbox', 'sort', 'offset'];
 const DEFAULT_API = process.env.NICHEDB_API ?? 'https://nichedb.dev';
 const CONFIG_DIR = join(process.env.XDG_CONFIG_HOME ?? join(homedir(), '.config'), 'nichedb');
@@ -176,6 +176,14 @@ export const COMMANDS = [
     summary: 'The feeds your key follows.',
     options: ['--json'],
   },
+  {
+    name: 'webhooks',
+    usage:
+      'webhooks [list] | add <url> [--events a,b] [--description …] | rm|test|secret|rotate|enable|disable <id> | deliveries [<id>]',
+    summary:
+      'Account webhooks (key required): signed Standard Webhooks POSTs for feed.item.published, feed.followed and more.',
+    options: ['--events', '--description', '--limit', '--json'],
+  },
   {
     name: 'rss',
     usage: 'rss <feed>',
@@ -321,6 +329,26 @@ export const COMMANDS = [
     summary: 'Take a handle: your URL becomes /c/profiles/<handle> (key required).',
     options: [],
   },
+  {
+    name: 'redeem',
+    usage: 'redeem <code>',
+    summary: 'Redeem a credit code for days of Premium (key required).',
+    options: ['--json'],
+  },
+  {
+    name: 'invites',
+    usage: 'invites [create [--note …] | revoke <id>]',
+    summary:
+      'Your invites: how many are left, and each one. create makes one (its link is shown once); revoke withdraws an unused one (key required).',
+    options: ['--note <who it is for>', '--json'],
+  },
+  {
+    name: 'credits mint',
+    usage: 'credits mint --days <n> [--label …] [--max <n>] [--expires <days>]',
+    summary:
+      'Admin: mint a code worth n days of Premium. The code is shown once. Also credits list|revoke <id>.',
+    options: ['--days <n>', '--label <text>', '--max <redemptions>', '--expires <days>', '--json'],
+  },
   {
     name: 'login',
     usage: 'login [--api <url>] [--key <ndb_…>]',
@@ -847,6 +875,85 @@ export async function run(
       for (const f of feeds) out(`${pad(f.slug, 30)} ${f.name}`);
       return 0;
     }
+    case 'webhooks':
+    case 'webhook': {
+      const [sub = 'list', arg] = rest;
+      const base = '/api/v1/webhooks';
+      const id = () => {
+        if (!arg) throw new Error(`webhooks ${sub} <id>`);
+        return `${base}/${encodeURIComponent(arg)}`;
+      };
+      const show = (r, text) => out(json ? JSON.stringify(r, null, 2) : text);
+      if (sub === 'list' || sub === 'ls') {
+        const r = await client.get(base);
+        if (json) {
+          show(r);
+          return 0;
+        }
+        for (const e of r.endpoints)
+          out(
+            `${pad(e.id, 28)} ${pad(e.enabled ? 'on' : 'off', 4)} ${pad(e.events.join(','), 24)} ${e.url}`,
+          );
+        if (r.endpoints.length === 0) out('(no webhooks)');
+        out(`\nevents: ${r.event_types.join(', ')}`);
+        return 0;
+      }
+      if (sub === 'add' || sub === 'create') {
+        if (!arg) throw new Error('webhooks add <url> [--events a,b]');
+        const r = await client.post(base, {
+          url: arg,
+          events: csv(flags.events),
+          description: typeof flags.description === 'string' ? flags.description : '',
+        });
+        show(
+          r,
+          `${r.endpoint.id}  ${r.endpoint.url}\nsecret: ${r.secret}\n(also: nichedb webhooks secret ${r.endpoint.id})`,
+        );
+        return 0;
+      }
+      if (sub === 'rm' || sub === 'delete') {
+        show(await client.del(id()), `Removed ${arg}.`);
+        return 0;
+      }
+      if (sub === 'test') {
+        const r = await client.post(`${id()}/test`, {});
+        show(
+          r,
+          r.ok ? `Delivered (HTTP ${r.status}).` : `Failed: ${r.error ?? `HTTP ${r.status}`}`,
+        );
+        return r.ok ? 0 : 1;
+      }
+      if (sub === 'secret') {
+        const r = await client.get(`${id()}/secret`);
+        show(r, r.secret);
+        return 0;
+      }
+      if (sub === 'rotate') {
+        const r = await client.post(`${id()}/rotate`, {});
+        show(r, `${r.secret}\n(the old secret has stopped working)`);
+        return 0;
+      }
+      if (sub === 'enable' || sub === 'disable') {
+        const r = await client.patch(id(), { enabled: sub === 'enable' });
+        show(r, `${r.id} ${r.enabled ? 'on' : 'off'}`);
+        return 0;
+      }
+      if (sub === 'deliveries') {
+        const limit = flags.limit ? `?limit=${Number(flags.limit)}` : '';
+        const r = await client.get(`${arg ? `${id()}/deliveries` : `${base}/deliveries`}${limit}`);
+        if (json) {
+          show(r);
+          return 0;
+        }
+        for (const d of r.deliveries)
+          out(
+            `${pad(d.id, 28)} ${pad(d.status, 9)} ${pad(d.last_status ?? '-', 4)} ${pad(d.event_type, 22)} ${when(d.created_at)} ${d.last_error ?? ''}`,
+          );
+        if (r.deliveries.length === 0) out('(no deliveries)');
+        return 0;
+      }
+      throw new Error('webhooks list|add|rm|test|secret|rotate|enable|disable|deliveries');
+    }
     case 'rss': {
       const url = `${client.base}/f/${rest[0]}.rss`;
       if (!flags.fetch) {
@@ -1281,6 +1388,71 @@ export async function run(
       out(await client.text(`/api/v1/profiles/${encodeURIComponent(sub)}/openprofile.md`));
       return 0;
     }
+    case 'redeem': {
+      const code = rest.join(' ').trim();
+      if (!code) throw new Error('redeem <code>');
+      const r = await client.post('/api/v1/credits/redeem', { code });
+      out(json ? JSON.stringify(r, null, 2) : `Redeemed: ${r.days} days of Premium added.`);
+      return 0;
+    }
+    case 'invites': {
+      const [sub, arg] = rest;
+      if (sub === 'create') {
+        const r = await client.post('/api/v1/invites', { note: flags.note ?? '' });
+        out(json ? JSON.stringify(r.invite, null, 2) : `${r.invite.url}\n(shown once)`);
+        return 0;
+      }
+      if (sub === 'revoke') {
+        if (!arg) throw new Error('invites revoke <id>');
+        await client.post(`/api/v1/invites/${encodeURIComponent(arg)}/revoke`, {});
+        out(`Withdrew ${arg}.`);
+        return 0;
+      }
+      const r = await client.get('/api/v1/invites');
+      if (json) {
+        out(JSON.stringify(r, null, 2));
+        return 0;
+      }
+      out(
+        `${r.quota.left} of ${r.quota.total} invites left · ${r.bonus_days} days of Premium each when one is used`,
+      );
+      for (const i of r.invites) out(`${pad(i.id, 18)} ${pad(i.status, 8)} ${i.note}`);
+      return 0;
+    }
+    case 'credits': {
+      const [sub, arg] = rest;
+      if (sub === 'mint') {
+        const r = await client.post('/api/v1/admin/credits', {
+          days: Number(flags.days),
+          label: flags.label ?? '',
+          max: flags.max ? Number(flags.max) : 1,
+          expires_days: flags.expires ? Number(flags.expires) : null,
+        });
+        out(
+          json
+            ? JSON.stringify(r, null, 2)
+            : `${r.code}\n${r.days} days of Premium · ${r.max_redemptions} use(s) · id ${r.id}`,
+        );
+        return 0;
+      }
+      if (sub === 'revoke') {
+        if (!arg) throw new Error('credits revoke <id>');
+        await client.post(`/api/v1/admin/credits/${encodeURIComponent(arg)}/revoke`, {});
+        out(`Revoked ${arg}.`);
+        return 0;
+      }
+      if (sub && sub !== 'list') throw new Error('credits mint|list|revoke <id>');
+      const { codes } = await client.get('/api/v1/admin/credits');
+      if (json) {
+        out(JSON.stringify(codes, null, 2));
+        return 0;
+      }
+      for (const c of codes)
+        out(
+          `${pad(c.id, 18)} ${pad(`${c.days}d`, 6)} ${pad(`${c.redemptions}/${c.max_redemptions}`, 8)} ${c.revoked_at ? 'revoked ' : ''}${c.label}`,
+        );
+      return 0;
+    }
     case 'mcp':
       return serveMcp({ client, stdin, stdout });
     default: