Credit codes and invites: Premium days via redeem-credits + affiliates (v0.51.0)

apps/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@profullstack/nichedb",
-  "version": "0.50.0",
+  "version": "0.51.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",

apps/cli/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.51.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');
@@ -321,6 +321,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_…>]',
@@ -1281,6 +1301,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:

apps/web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nichedb/web",
-  "version": "0.50.0",
+  "version": "0.51.0",
   "private": true,
   "type": "module",
   "scripts": {
@@ -21,13 +21,15 @@
     "@nichedb/payments": "workspace:*",
     "@nichedb/premium": "workspace:*",
     "@nichedb/queue": "workspace:*",
+    "@profullstack/affiliates": "^0.2.0",
     "@profullstack/footer": "latest",
     "@profullstack/leaderboard": "^0.3.1",
     "@profullstack/nichedb": "workspace:*",
     "@profullstack/notifications": "^0.1.4",
     "@profullstack/openprofile": "^0.2.0",
     "@profullstack/partners": "0.2.0",
     "@profullstack/profile": "0.1.6",
+    "@profullstack/redeem-credits": "^0.2.0",
     "@profullstack/throttle": "^0.3.4",
     "@profullstack/x402-gateway": "0.13.1",
     "@simplewebauthn/browser": "^14.0.0",

apps/web/src/app.js

@@ -16,6 +16,7 @@ import { registerAutomotive } from './routes/automotive.js';
 import { registerBooks } from './routes/books.js';
 import { registerBusiness } from './routes/business.js';
 import { registerCrawlStatus } from './routes/crawlstatus.js';
+import { registerCredits } from './routes/credits.js';
 import { registerDataDumps } from './routes/data-dumps.js';
 import { registerKnowledge } from './routes/knowledge.js';
 import { registerLyrics } from './routes/lyrics.js';
@@ -141,6 +142,8 @@ app.get('/healthz', (c) => c.text('ok'));
 
 registerStatic(app, gateway);
 registerAuth(app);
+// Before pages: /i/INV-… is an invite, /i/<number> (pages) is an item.
+registerCredits(app);
 registerPages(app);
 registerManage(app);
 registerSubmit(app);