@wji.ai/cli 0.7.0 → 0.7.1

package/dist/commands/backreel-fund.js

@@ -1,299 +0,0 @@
-import { Command } from 'commander';
-import { POSTS, backreelClient, idOf, loadPost, oneOf } from '../core/backreel.js';
-import { color, detail, info, render, relativeTime, success, table, truncate } from '../core/output.js';
-import { confirm } from '../core/prompt.js';
-const CURRENCIES = ['hkd', 'usd', 'twd', 'sgd', 'eur', 'gbp'];
-const MAX_TIERS = 10;
-const num = (value, flag, min = 0) => {
-    const n = Number(value);
-    if (!Number.isFinite(n) || n < min)
-        throw new Error(`${flag} must be a number ≥ ${min}`);
-    return n;
-};
-/** The server rejects a tier below the minimum donation (and below 1) with a bare 500. */
-function tierAmount(value, minAmount) {
-    const floor = Math.max(1, minAmount || 0);
-    const n = num(value, '--amount');
-    if (n < floor)
-        throw new Error(`--amount must be at least ${floor} (the minimum donation)`);
-    return Math.round(n);
-}
-function itemIndex(n, count, what) {
-    const i = Number(n);
-    if (!Number.isInteger(i) || i < 1 || i > count)
-        throw new Error(`${what} ${n} does not exist — there are ${count}`);
-    return i - 1;
-}
-/** campaign as the update DTO takes it: the owner view plus avatar ids, minus derived totals. */
-function campaignDto(c) {
-    return {
-        goalAmount: c?.goalAmount ?? 0,
-        offlineRaisedAmount: c?.offlineRaisedAmount ?? 0,
-        deadline: c?.deadline ?? null,
-        offlineSupporters: (c?.offlineSupporters || []).map((s, i) => ({
-            name: s.name,
-            amount: s.amount ?? 0,
-            sort: i,
-            avatar: idOf(s.avatar) ?? null,
-            avatarUrl: s.avatarUrl ?? null,
-        })),
-    };
-}
-/** donation config as the update DTO takes it (the read view adds `remaining` per tier). */
-function donationDto(d) {
-    return {
-        enabled: !!d?.enabled,
-        currency: d?.currency || 'hkd',
-        minAmount: d?.minAmount ?? 0,
-        tiers: (d?.tiers || []).map((t) => ({ id: t.id, title: t.title, amount: t.amount, perks: t.perks || '', limit: t.limit ?? null })),
-    };
-}
-function requireCampaign(post) {
-    if (post.kind !== 'crowdfunding') {
-        throw new Error(`"${post.title}" is a ${post.kind} post — campaign fields need --kind crowdfunding (which drops its episodes)`);
-    }
-}
-const put = (client, id, body) => client.put(`${POSTS}/list/${id}`, body);
-function printFund(post) {
-    const c = post.campaign;
-    const d = post.donation || {};
-    // The campaign view reports the stats currency, which reads HKD until the first donation;
-    // the configured donation currency is the real one (it cannot change after that).
-    const cur = (d.currency || c?.currency || 'hkd').toUpperCase();
-    if (c) {
-        const pct = c.goalAmount ? ` (${Math.round(((c.raisedAmount || 0) / c.goalAmount) * 100)}%)` : '';
-        detail([
-            ['goal', `${c.goalAmount} ${cur}`],
-            ['raised', `${c.raisedAmount} ${cur}${pct} = offline ${c.offlineRaisedAmount ?? 0} + online ${(c.raisedAmount || 0) - (c.offlineRaisedAmount || 0)}`],
-            ['supporters', c.supporterCount],
-            ['deadline', c.deadline || color.dim('none')],
-        ]);
-        process.stdout.write('\n');
-    }
-    else {
-        info(color.dim(`${post.kind} post — no campaign (goal / offline supporters are crowdfunding-only); donations still work`));
-    }
-    detail([
-        ['donations', d.enabled ? color.green('on') : 'off'],
-        ['currency', (d.currency || 'hkd').toUpperCase()],
-        ['minimum', d.minAmount ?? 0],
-    ]);
-    if ((d.tiers || []).length) {
-        process.stdout.write('\n');
-        table(d.tiers.map((t, i) => ({ ...t, n: i + 1 })), [
-            { header: '#', value: (t) => t.n },
-            { header: 'tier', value: (t) => truncate(t.title, 24) },
-            { header: 'amount', value: (t) => t.amount },
-            { header: 'left', value: (t) => (t.limit ? `${t.remaining}/${t.limit}` : '∞') },
-            { header: 'perks', value: (t) => truncate(t.perks, 40) },
-        ]);
-    }
-}
-function printSupporters(post) {
-    table((post.campaign?.offlineSupporters || []).map((s, i) => ({ ...s, n: i + 1 })), [
-        { header: '#', value: (s) => s.n },
-        { header: 'name', value: (s) => s.name },
-        { header: 'amount', value: (s) => s.amount },
-        { header: 'avatar', value: (s) => idOf(s.avatar) || '' },
-    ]);
-}
-export function fundCommand(globals) {
-    const fund = new Command('fund')
-        .aliases(['funding', 'campaign'])
-        .description('Crowdfunding campaign, donation settings and tiers, offline supporters, donation records');
-    fund.command('show <postId>', { isDefault: true })
-        .description('Campaign progress, donation settings and tiers')
-        .action(async (postId) => {
-        const client = backreelClient(globals);
-        const post = await loadPost(client, postId);
-        render({ campaign: post.campaign, donation: post.donation, kind: post.kind }, () => printFund(post));
-    });
-    fund.command('set <postId>')
-        .description('Campaign goal / offline total / deadline and donation switches; only what you pass changes')
-        .option('--goal <amount>', 'campaign goal (≥1 to publish a crowdfunding post)')
-        .option('--offline-raised <amount>', 'money raised outside Backreel, added to the progress bar')
-        .option('--deadline <date>', 'ISO date (e.g. 2026-12-31); "none" clears — donations stop after it')
-        .option('--donations <on|off>', 'accept online donations (Stripe)')
-        .option('--currency <code>', `${CURRENCIES.join(' | ')} — locked once a donation exists`)
-        .option('--min <amount>', 'minimum donation')
-        .action(async (postId, opts) => {
-        const client = backreelClient(globals);
-        const post = await loadPost(client, postId);
-        const body = {};
-        if (opts.goal !== undefined || opts.offlineRaised !== undefined || opts.deadline !== undefined) {
-            requireCampaign(post);
-            const campaign = campaignDto(post.campaign);
-            if (opts.goal !== undefined)
-                campaign.goalAmount = num(opts.goal, '--goal');
-            if (opts.offlineRaised !== undefined)
-                campaign.offlineRaisedAmount = num(opts.offlineRaised, '--offline-raised');
-            if (opts.deadline !== undefined) {
-                if (['none', ''].includes(String(opts.deadline).toLowerCase()))
-                    campaign.deadline = null;
-                else {
-                    const date = new Date(opts.deadline);
-                    if (Number.isNaN(date.getTime()))
-                        throw new Error('--deadline must be a date like 2026-12-31');
-                    campaign.deadline = date.toISOString();
-                }
-            }
-            body.campaign = campaign;
-        }
-        if (opts.donations !== undefined || opts.currency !== undefined || opts.min !== undefined) {
-            const donation = donationDto(post.donation);
-            if (opts.donations !== undefined)
-                donation.enabled = oneOf(String(opts.donations).toLowerCase(), ['on', 'off'], '--donations') === 'on';
-            if (opts.currency !== undefined)
-                donation.currency = oneOf(String(opts.currency).toLowerCase(), CURRENCIES, '--currency');
-            if (opts.min !== undefined)
-                donation.minAmount = Math.round(num(opts.min, '--min'));
-            body.donation = donation;
-        }
-        if (!Object.keys(body).length)
-            throw new Error('Nothing to change — see `wji backreel fund set --help`');
-        const updated = await put(client, postId, body);
-        render(updated, (p) => {
-            success(`Updated ${Object.keys(body).join(' and ')} of "${p.title}"`);
-            printFund(p);
-        });
-    });
-    // ── donation tiers ─────────────────────────────────────────────────────────
-    const tier = fund.command('tier').description(`Donation tiers (≤${MAX_TIERS}): a title, an amount, perks, an optional cap`);
-    tier.command('add <postId>')
-        .requiredOption('--title <text>', 'tier name (≤60)')
-        .requiredOption('--amount <n>', 'price, ≥ the minimum donation')
-        .option('--perks <text>', 'what supporters get (≤1000)')
-        .option('--limit <n>', 'number of slots (default unlimited)')
-        .action(async (postId, opts) => {
-        const client = backreelClient(globals);
-        const post = await loadPost(client, postId);
-        const donation = donationDto(post.donation);
-        if (donation.tiers.length >= MAX_TIERS)
-            throw new Error(`Already ${MAX_TIERS} tiers`);
-        donation.tiers.push({ id: undefined, title: opts.title, amount: tierAmount(opts.amount, donation.minAmount), perks: opts.perks || '', limit: opts.limit ? num(opts.limit, '--limit', 1) : null });
-        const updated = await put(client, postId, { donation });
-        render(updated.donation, () => {
-            success(`Added tier "${opts.title}"${donation.enabled ? '' : color.dim(' — donations are off; `fund set --donations on`')}`);
-            printFund(updated);
-        });
-    });
-    tier.command('set <postId> <n>')
-        .option('--title <text>', 'tier name')
-        .option('--amount <n>', 'price')
-        .option('--perks <text>', 'perks')
-        .option('--limit <n>', 'slots; 0 = unlimited')
-        .action(async (postId, n, opts) => {
-        const client = backreelClient(globals);
-        const post = await loadPost(client, postId);
-        const donation = donationDto(post.donation);
-        const t = donation.tiers[itemIndex(n, donation.tiers.length, 'Tier')];
-        if (opts.title !== undefined)
-            t.title = opts.title;
-        if (opts.amount !== undefined)
-            t.amount = tierAmount(opts.amount, donation.minAmount);
-        if (opts.perks !== undefined)
-            t.perks = opts.perks;
-        if (opts.limit !== undefined)
-            t.limit = Number(opts.limit) > 0 ? num(opts.limit, '--limit', 1) : null;
-        const updated = await put(client, postId, { donation });
-        render(updated.donation, () => {
-            success(`Updated tier ${n}`);
-            printFund(updated);
-        });
-    });
-    tier.command('rm <postId> <n...>')
-        .option('-y, --yes', 'skip confirmation')
-        .action(async (postId, ns, opts) => {
-        const client = backreelClient(globals);
-        const post = await loadPost(client, postId);
-        const donation = donationDto(post.donation);
-        const drop = new Set(ns.map((n) => itemIndex(n, donation.tiers.length, 'Tier')));
-        const names = [...drop].map((i) => donation.tiers[i].title).join(', ');
-        if (!(await confirm(`Remove tier(s) ${names}? Past donations keep their snapshot.`, opts.yes)))
-            return info('Aborted');
-        donation.tiers = donation.tiers.filter((_, i) => !drop.has(i));
-        const updated = await put(client, postId, { donation });
-        render(updated.donation, () => {
-            success(`Removed ${drop.size} tier(s)`);
-            printFund(updated);
-        });
-    });
-    // ── offline supporters ─────────────────────────────────────────────────────
-    const sup = fund.command('supporter').aliases(['supporters']).description('Supporters who paid outside Backreel (crowdfunding posts)');
-    sup.command('list <postId>', { isDefault: true }).action(async (postId) => {
-        const client = backreelClient(globals);
-        const post = await loadPost(client, postId);
-        requireCampaign(post);
-        render(post.campaign?.offlineSupporters || [], () => printSupporters(post));
-    });
-    sup.command('add <postId>')
-        .requiredOption('--name <name>', 'display name')
-        .option('--amount <n>', 'amount (shown next to the name)', '0')
-        .option('--avatar <assetId>', 'square image asset (see `backreel image --slot photo`)')
-        .action(async (postId, opts) => {
-        const client = backreelClient(globals);
-        const post = await loadPost(client, postId);
-        requireCampaign(post);
-        const campaign = campaignDto(post.campaign);
-        campaign.offlineSupporters.push({ name: opts.name, amount: num(opts.amount, '--amount'), sort: campaign.offlineSupporters.length, avatar: opts.avatar ?? null, avatarUrl: null });
-        const updated = await put(client, postId, { campaign });
-        render(updated.campaign, () => {
-            success(`Added supporter ${opts.name}`);
-            info(color.dim('The supporter count rises; offline money only counts once you raise --offline-raised'));
-            printSupporters(updated);
-        });
-    });
-    sup.command('rm <postId> <n...>')
-        .option('-y, --yes', 'skip confirmation')
-        .action(async (postId, ns, opts) => {
-        const client = backreelClient(globals);
-        const post = await loadPost(client, postId);
-        requireCampaign(post);
-        const campaign = campaignDto(post.campaign);
-        const drop = new Set(ns.map((n) => itemIndex(n, campaign.offlineSupporters.length, 'Supporter')));
-        const names = [...drop].map((i) => campaign.offlineSupporters[i].name).join(', ');
-        if (!(await confirm(`Remove ${names}?`, opts.yes)))
-            return info('Aborted');
-        campaign.offlineSupporters = campaign.offlineSupporters.filter((_, i) => !drop.has(i));
-        const updated = await put(client, postId, { campaign });
-        render(updated.campaign, () => {
-            success(`Removed ${drop.size} supporter(s)`);
-            printSupporters(updated);
-        });
-    });
-    // ── donation records ───────────────────────────────────────────────────────
-    fund.command('donations <postId>')
-        .description('Online donations, balance and payouts (anonymous donors stay hidden)')
-        .option('--page <n>', 'page number', '1')
-        .option('--limit <n>', 'page size (≤200)', '50')
-        .action(async (postId, opts) => {
-        const client = backreelClient(globals);
-        const r = await client.get(`/backreel/donation/post/${postId}/manage`, { page: Number(opts.page), limit: Number(opts.limit) });
-        render(r, () => {
-            const s = r.summary || {};
-            const cur = (s.currency || '').toUpperCase();
-            detail([
-                ['raised', `${s.raised} ${cur}`],
-                ['paid out', `${s.paidOut} ${cur}`],
-                ['balance', `${s.balance} ${cur}`],
-                ['supporters', r.stats?.supporterCount ?? 0],
-                ['donations', r.stats?.donationCount ?? 0],
-            ]);
-            process.stdout.write('\n');
-            table(r.data || [], [
-                { header: 'when', value: (d) => relativeTime(d.paidAt || d.createdAt) },
-                { header: 'donor', value: (d) => (d.isAnonymous ? color.dim('anonymous') : truncate(d.donor?.name, 20)) },
-                { header: 'amount', value: (d) => `${d.amount} ${(d.currency || '').toUpperCase()}` },
-                { header: 'tier', value: (d) => truncate(d.tier?.title, 16) },
-                { header: 'status', value: (d) => d.status + (d.refundedAmount ? ` (-${d.refundedAmount})` : '') + (d.disputed ? color.red(' disputed') : '') },
-                { header: 'message', value: (d) => truncate(d.message, 30) },
-            ]);
-            const p = r.pagination;
-            if (p)
-                info(color.dim(`${p.total} donations · page ${p.page}${p.hasNext ? ` · more: --page ${p.page + 1}` : ''}`));
-            if ((r.payouts || []).length)
-                info(color.dim(`${r.payouts.length} payout(s) — payouts and refunds are handled by Backreel staff`));
-        });
-    });
-    return fund;
-}