@wji.ai/cli 0.7.0 → 0.8.0

package/dist/commands/backreel.js

@@ -1,443 +0,0 @@
-import { Command } from 'commander';
-import { POSTS, backreelClient, idOf, oneOf } from '../core/backreel.js';
-import { IMAGE_SLOTS, checkImage } from '../core/image.js';
-import { episodeCommand } from './backreel-episode.js';
-import { enquiryCommand } from './backreel-enquiry.js';
-import { fundCommand } from './backreel-fund.js';
-import { confirm, readJson, readValue } from '../core/prompt.js';
-import { color, detail, info, render, relativeTime, success, table, truncate } from '../core/output.js';
-import { NPC_JOB_TYPES, npcLabel, parseJob, parsePositions, resolveNpc, today, updateJobs } from '../core/npc.js';
-const KINDS = ['showcase', 'crowdfunding'];
-const PROJECT_STATUSES = ['planning', 'pre_production', 'in_production', 'post_production', 'completed'];
-const CREDIT_KINDS = ['creative', 'crew', 'cast'];
-/** The web's LookBook slot limit (compose/store.ts MEDIA_SLOT_LIMIT); the API itself has no cap. */
-const MEDIA_MAX = 9;
-/** Backend LOGLINE_MAX (src/backreel/post/descriptionHtml.ts). */
-const LOGLINE_MAX = 200;
-/** BackreelVerificationKind — what `creators --role` filters on. */
-const VERIFICATION_KINDS = ['investor', 'production_company', 'brand', 'distributor', 'sales_agent'];
-/** Credit fields the create / update DTO accepts; the rest of a read-back credit is dropped. */
-const CREDIT_FIELDS = ['kind', 'name', 'role', 'user', 'photo', 'avatarUrl', 'link', 'source', 'npcId', 'order'];
-export function backreelCommand(globals) {
-    const br = new Command('backreel')
-        .aliases(['br'])
-        .description('Manage your Backreel posts (works) and their credits, including NPC cast');
-    br.command('list', { isDefault: true })
-        .description('Your posts, drafts included; --all for everyone\'s published posts')
-        .option('--all', 'search all published posts instead of yours')
-        .option('-k, --keyword <text>', 'search text')
-        .option('--page <n>', 'page number', '1')
-        .option('--limit <n>', 'page size', '20')
-        .action(async (opts) => {
-        const client = backreelClient(globals);
-        const result = await client.get(`${POSTS}/${opts.all ? 'search' : 'search/my'}`, {
-            keyword: opts.keyword,
-            page: Number(opts.page),
-            limit: Number(opts.limit),
-        });
-        render(result, (r) => {
-            table(r?.data || [], [
-                { header: 'id', value: (p) => p.id },
-                { header: 'title', value: (p) => truncate(p.title, 28) },
-                { header: 'kind', value: (p) => p.kind },
-                { header: 'publish', value: (p) => p.publishStatus },
-                { header: 'project', value: (p) => p.projectStatus },
-                { header: 'credits', value: (p) => (p.credits || []).length },
-                { header: 'updated', value: (p) => relativeTime(p.updatedAt) },
-            ]);
-            const p = r?.pagination;
-            if (p)
-                info(color.dim(`${p.total} total · page ${p.page}${p.hasNext ? ` · more: --page ${p.page + 1}` : ''}`));
-        });
-    });
-    br.command('get <postId>')
-        .description('Show a post and its credits')
-        .action(async (id) => {
-        const client = backreelClient(globals);
-        const post = await client.getFresh(`${POSTS}/list/${id}`);
-        render(post, () => printPost(post));
-    });
-    postOptions(br.command('create <title>').description('Create a post (always a draft until `backreel publish`)')).action(async (title, opts) => {
-        const client = backreelClient(globals);
-        // The create DTO validates kind and description although the entity has defaults.
-        const body = { kind: 'showcase', description: '', ...(await postBody(opts)), title };
-        const created = await client.post(`${POSTS}/create`, body);
-        render(created, (p) => success(`Created draft "${p.title}" — ${p.id}`));
-    });
-    postOptions(br.command('set <postId>')
-        .description('Update a post; only the fields you pass change')
-        .option('--title <text>', 'title')).action(async (id, opts) => {
-        const client = backreelClient(globals);
-        const body = await postBody(opts);
-        if (opts.title)
-            body.title = opts.title;
-        if (!Object.keys(body).length)
-            throw new Error('Nothing to change — pass at least one field flag');
-        const updated = await client.put(`${POSTS}/list/${id}`, body);
-        render(updated, () => success(`Updated "${updated.title}": ${Object.keys(body).join(', ')}`));
-    });
-    for (const action of ['publish', 'unpublish']) {
-        br.command(`${action} <postId>`)
-            .description(action === 'publish' ? 'Publish a post' : 'Take a post offline')
-            .action(async (id) => {
-            const client = backreelClient(globals);
-            const post = await client.post(`${POSTS}/list/${id}/${action}`);
-            render(post, (p) => success(`"${p.title}" is now ${p.publishStatus}`));
-        });
-    }
-    br.command('rm <postId>')
-        .description('Delete a post')
-        .option('-y, --yes', 'skip confirmation')
-        .action(async (id, opts) => {
-        const client = backreelClient(globals);
-        const post = await client.getFresh(`${POSTS}/list/${id}`);
-        if (!(await confirm(`Delete post "${post.title}" (${id})?`, opts.yes)))
-            return info('Aborted');
-        const result = await client.delete(`${POSTS}/list/${id}`);
-        render(result, () => success(`Deleted "${post.title}"`));
-    });
-    br.command('creators')
-        .description('Browse Backreel creators: editor picks, then ranked by recent likes / favorites')
-        .option('-k, --keyword <text>', 'match name or @handle')
-        .option('--role <kind>', `only creators verified as: ${VERIFICATION_KINDS.join(' | ')}`)
-        .option('--verified', 'only verified creators')
-        .option('--no-featured', 'skip the editor-picked creators')
-        .option('--page <n>', 'page number', '1')
-        .option('--limit <n>', 'page size (max 48)', '20')
-        .action(async (opts) => {
-        const client = backreelClient(globals);
-        if (opts.role)
-            oneOf(opts.role, VERIFICATION_KINDS, '--role');
-        const result = await client.get('/backreel/creator/list', {
-            keyword: opts.keyword,
-            role: opts.role,
-            verifiedOnly: opts.verified ? 'true' : undefined,
-            withFeatured: opts.featured ? undefined : 'false',
-            page: Number(opts.page),
-            limit: Number(opts.limit),
-        });
-        render(result, (r) => {
-            const columns = [
-                { header: 'id', value: (c) => c.id },
-                { header: 'name', value: (c) => truncate(c.name, 24) },
-                { header: 'handle', value: (c) => (c.handle ? `@${c.handle}` : '') },
-                { header: 'reels', value: (c) => c.reelCount },
-                { header: 'followers', value: (c) => c.followerCount },
-                { header: 'likes', value: (c) => c.likeCount },
-                { header: 'verified', value: (c) => (c.verifiedKinds || []).join(', ') },
-            ];
-            if (r?.featured?.length) {
-                info(color.bold('Featured'));
-                table(r.featured, [...columns, { header: 'note', value: (c) => truncate(c.featuredNote, 30) }]);
-                process.stdout.write('\n');
-                info(color.bold('Hot'));
-            }
-            table(r?.data || [], columns);
-            const p = r?.pagination;
-            if (p) {
-                const more = p.page * p.limit < p.total ? ` · more: --page ${p.page + 1}` : '';
-                info(color.dim(`${p.total} ranked · page ${p.page}${more}`));
-            }
-        });
-    });
-    br.command('image <file...>')
-        .description('Check image size / ratio for a slot, upload it, and optionally put it on a post')
-        .requiredOption('--slot <slot>', `${Object.keys(IMAGE_SLOTS).join(' | ')} (see \`backreel image-specs\`)`)
-        .option('--post <postId>', 'cover / portrait: set it on the post; media: append to the LookBook')
-        .option('--check', 'only check, do not upload')
-        .action(async (files, opts) => {
-        const slot = oneOf(opts.slot, Object.keys(IMAGE_SLOTS), '--slot');
-        if (files.length > 1 && slot !== 'media')
-            throw new Error(`--slot ${slot} takes one image`);
-        const checks = await Promise.all(files.map((f) => checkImage(f, slot)));
-        for (const c of checks) {
-            const dims = c.dims ? `${c.dims.width}×${c.dims.height} ${c.dims.format}` : '?';
-            info(`${c.file}: ${dims}, ${(c.bytes / 1048576).toFixed(1)} MB → ${slot} (${c.spec.label}, ideal ${c.spec.ideal})`);
-            for (const e of c.errors)
-                info(color.red(`  ✗ ${e}`));
-            for (const w of c.warnings)
-                info(color.yellow(`  ! ${w}`));
-            if (!c.errors.length && !c.warnings.length)
-                info(color.green('  ✓ fits'));
-        }
-        if (checks.some((c) => c.errors.length))
-            throw new Error('Fix the errors above first');
-        if (opts.check)
-            return render(checks, () => { });
-        const client = backreelClient(globals);
-        const ids = [];
-        for (const c of checks) {
-            const asset = await client.upload('/assets/v2/upload', c.file, {
-                width: c.dims ? String(c.dims.width) : undefined,
-                height: c.dims ? String(c.dims.height) : undefined,
-            });
-            ids.push(asset.id);
-            success(`${c.file} → ${asset.id}`);
-        }
-        if (!opts.post)
-            return render({ assets: ids }, () => { });
-        const field = { cover: 'cover', portrait: 'coverPortrait', media: 'assets' }[slot];
-        if (!field)
-            throw new Error('--post works with cover, portrait and media; use the photo id with `credit add --photo` or `fund supporter add --avatar`');
-        let value = ids[0];
-        if (field === 'assets') {
-            const post = await client.getFresh(`${POSTS}/list/${opts.post}`);
-            value = [...(post.assets || []).map(idOf), ...ids];
-            if (value.length > MEDIA_MAX)
-                throw new Error(`The LookBook would have ${value.length} items; the limit is ${MEDIA_MAX}`);
-        }
-        const updated = await client.put(`${POSTS}/list/${opts.post}`, { [field]: value });
-        render(updated, (p) => success(`Set ${field} on "${p.title}"${field === 'assets' ? ` (${value.length} items)` : ''}`));
-    });
-    br.command('image-specs')
-        .description('Recommended image sizes for every Backreel slot')
-        .action(() => {
-        render(IMAGE_SLOTS, () => {
-            table(Object.entries(IMAGE_SLOTS).map(([slot, s]) => ({ slot, ...s })), [
-                { header: 'slot', value: (r) => r.slot },
-                { header: 'ratio', value: (r) => r.label },
-                { header: 'ideal', value: (r) => r.ideal },
-                { header: 'min', value: (r) => r.min.join('×') },
-                { header: 'note', value: (r) => r.note },
-            ]);
-            info(color.dim('JPEG / PNG / WebP, ≤25 MB. Long edge over 3840 px is downsized, files over 10 MB are re-encoded as JPEG.'));
-        });
-    });
-    br.command('check <postId>')
-        .description('Publish readiness and health: required fields, images, episodes, campaign')
-        .action(async (id) => {
-        const client = backreelClient(globals);
-        const p = await client.getFresh(`${POSTS}/list/${id}`);
-        const blockers = [];
-        const advice = [];
-        const hasText = !!(p.descriptionText || '').trim() || /<img\b/i.test(p.description || '');
-        const episodes = p.episodes || [];
-        if (!(p.title || '').trim())
-            blockers.push('title is empty');
-        if (!hasText)
-            blockers.push('description is empty (needs text or an image) — `backreel set -d @synopsis.md`');
-        if (!p.cover && !(p.assets || []).length && !episodes.length)
-            blockers.push('needs a cover, LookBook media or an episode');
-        if (p.kind === 'crowdfunding' && !(p.campaign?.goalAmount >= 1))
-            blockers.push('crowdfunding goal is 0 — `backreel fund set --goal`');
-        if (!p.cover)
-            advice.push('no 16:9 cover — cards and shares fall back to a blank frame');
-        if (!p.coverPortrait)
-            advice.push('no 9:16 portrait cover — mobile crops the 16:9 cover');
-        if (!(p.logline || '').trim())
-            advice.push('no logline — the page falls back to the first sentence of the description');
-        if (!(p.credits || []).length)
-            advice.push('no credits');
-        const pending = episodes.filter((e) => e.vodVid && e.vodStatus !== 'ready');
-        if (pending.length)
-            advice.push(`${pending.length} episode(s) not ready on VOD (${pending.map((e) => `#${(e.order ?? 0) + 1} ${e.vodStatus || '?'}`).join(', ')}) — \`backreel episode status\``);
-        if (p.trailerDurationSec && p.trailerDurationSec > 31)
-            advice.push(`trailer is ${p.trailerDurationSec}s; the limit is 30s`);
-        if (p.donation?.enabled && p.kind === 'crowdfunding' && p.campaign?.deadline && new Date(p.campaign.deadline) < new Date()) {
-            advice.push('the campaign deadline has passed — donations are closed');
-        }
-        render({ id: p.id, publishStatus: p.publishStatus, blockers, advice }, () => {
-            info(`"${p.title}" — ${p.kind}, ${p.publishStatus}`);
-            for (const b of blockers)
-                info(color.red(`  ✗ ${b}`));
-            for (const a of advice)
-                info(color.yellow(`  ! ${a}`));
-            if (!blockers.length)
-                info(color.green(p.publishStatus === 'published' ? '  ✓ published' : '  ✓ ready to publish — `wji backreel publish`'));
-        });
-    });
-    br.addCommand(episodeCommand(globals));
-    br.addCommand(enquiryCommand(globals));
-    br.addCommand(fundCommand(globals));
-    // ── credits ────────────────────────────────────────────────────────────
-    const credit = br.command('credit').aliases(['credits']).description('Cast and crew of a post (max 30)');
-    credit
-        .command('list <postId>', { isDefault: true })
-        .description('Numbered credits')
-        .action(async (id) => {
-        const client = backreelClient(globals);
-        const post = await client.getFresh(`${POSTS}/list/${id}`);
-        render(post.credits || [], (credits) => printCredits(credits));
-    });
-    credit
-        .command('add <postId>')
-        .description('Add a credit; --npc casts one of your NPCs')
-        .option('--name <name>', 'display name (defaults to the NPC or user name)')
-        .requiredOption('--role <role>', 'job or character, e.g. 導演 or 飾 阿明')
-        .option('--kind <kind>', CREDIT_KINDS.join(' | '), 'cast')
-        .option('--npc <npc>', 'link an NPC City NPC (id, @handle or name)')
-        .option('--user <userId>', 'link a WJI user (their name and avatar win)')
-        .option('--link <url>', 'profile link')
-        .option('--photo <assetId>', 'square photo asset (see `backreel image --slot photo`)')
-        .option('--job <type>', `also add a work-history job to the NPC: ${NPC_JOB_TYPES.join(' | ')}`)
-        .action(async (id, opts) => {
-        if (!CREDIT_KINDS.includes(opts.kind))
-            throw new Error(`--kind must be one of ${CREDIT_KINDS.join(', ')}`);
-        if (opts.job && !opts.npc)
-            throw new Error('--job needs --npc');
-        if (opts.job && !NPC_JOB_TYPES.includes(opts.job)) {
-            throw new Error(`--job must be one of ${NPC_JOB_TYPES.join(', ')}`);
-        }
-        const client = backreelClient(globals);
-        const npc = opts.npc ? await resolveNpc(client, opts.npc) : undefined;
-        // Any public NPC can be credited, but only your own gets a job. The soul
-        // route is owner-only, so it checks that before anything is written.
-        if (npc && opts.job) {
-            await client.get(`/npc-city/residents/${npc.id}/soul`).catch(() => {
-                throw new Error(`${npcLabel(npc)} is not yours, so --job can't add to its work history (the credit alone works without --job)`);
-            });
-        }
-        const name = opts.name || npc?.name;
-        if (!name && !opts.user)
-            throw new Error('Pass --name, --npc or --user');
-        const entry = { kind: opts.kind, name: name || '-', role: opts.role };
-        if (opts.user)
-            entry.user = opts.user;
-        if (opts.link)
-            entry.link = opts.link;
-        if (opts.photo)
-            entry.photo = opts.photo;
-        if (npc) {
-            entry.npcId = npc.id;
-            if (npc.image)
-                entry.avatarUrl = npc.image;
-        }
-        const post = await updateCredits(client, id, (credits) => [...credits, entry]);
-        // The job is written after the credit, dated today and titled after the post.
-        let job;
-        if (npc && opts.job) {
-            job = parseJob({ type: opts.job, title: post.title, detail: opts.role, date: today() });
-            await updateJobs(client, npc.id, (jobs) => [...jobs, job]);
-        }
-        render({ post: post.id, credits: post.credits, job: job ?? null }, () => {
-            success(`Credited ${name || opts.user} as ${opts.role} on "${post.title}" (#${post.credits.length})`);
-            if (job)
-                success(`Added ${job.type} "${job.title}" to ${npcLabel(npc)}'s work history`);
-        });
-    });
-    credit
-        .command('rm <postId> <n...>')
-        .description('Remove credits by number')
-        .option('-y, --yes', 'skip confirmation')
-        .action(async (id, ns, opts) => {
-        const client = backreelClient(globals);
-        const post = await client.getFresh(`${POSTS}/list/${id}`);
-        const credits = post.credits || [];
-        const positions = parsePositions(ns, credits.length);
-        const names = positions.map((i) => `#${i + 1} ${credits[i].name}`).join(', ');
-        if (!(await confirm(`Remove ${names} from "${post.title}"?`, opts.yes)))
-            return info('Aborted');
-        const updated = await updateCredits(client, id, (current) => {
-            if (JSON.stringify(current) !== JSON.stringify(credits.map(toCreditDto))) {
-                throw new Error('The credits changed since they were read — list them again and retry');
-            }
-            return current.filter((_, i) => !positions.includes(i));
-        });
-        render(updated.credits, () => success(`Removed ${positions.length} credit(s); ${updated.credits.length} left`));
-    });
-    return br;
-}
-// ── helpers ──────────────────────────────────────────────────────────────
-function postOptions(cmd) {
-    return cmd
-        .option('--kind <kind>', KINDS.join(' | '))
-        .option('--logline <text>', `one-line hook, max ${LOGLINE_MAX} chars; public even when the description is locked ("" clears it)`)
-        .option('--category <category>', 'category')
-        .option('--project-status <status>', PROJECT_STATUSES.join(' | '))
-        .option('--tags <tags>', 'comma-separated tags (replaces the list)')
-        .option('-d, --description <text>', 'description, plain text or HTML (@file / - supported)')
-        .option('--cover <assetId>', 'landscape cover asset')
-        .option('--cover-portrait <assetId>', 'portrait cover asset')
-        .option('--trailer <assetId>', 'trailer video asset (≤30 s)')
-        .option('--media <assetId...>', `LookBook gallery, images or videos in order (replaces it; ≤${MEDIA_MAX}; "none" clears)`)
-        .option('--body <json>', 'any other post fields as JSON (@file / - supported); flags win');
-}
-async function postBody(opts) {
-    const body = { ...((await readJson(opts.body)) || {}) };
-    if (opts.kind)
-        body.kind = oneOf(opts.kind, KINDS, '--kind');
-    if (opts.logline !== undefined) {
-        // Same normalisation the server applies: plain text, one line.
-        const logline = String(await readValue(opts.logline)).replace(/<[^>]*>/g, '').replace(/\s+/g, ' ').trim();
-        if (logline.length > LOGLINE_MAX)
-            throw new Error(`--logline is ${logline.length} chars; the limit is ${LOGLINE_MAX}`);
-        body.logline = logline;
-    }
-    if (opts.category)
-        body.category = opts.category;
-    if (opts.projectStatus)
-        body.projectStatus = oneOf(opts.projectStatus, PROJECT_STATUSES, '--project-status');
-    if (opts.tags !== undefined)
-        body.tags = String(opts.tags).split(',').map((t) => t.trim()).filter(Boolean);
-    if (opts.description !== undefined)
-        body.description = toHtml(await readValue(opts.description));
-    if (opts.cover)
-        body.cover = opts.cover;
-    if (opts.coverPortrait)
-        body.coverPortrait = opts.coverPortrait;
-    if (opts.trailer)
-        body.trailer = opts.trailer;
-    if (opts.media) {
-        const media = opts.media.filter((m) => m !== 'none');
-        if (media.length > MEDIA_MAX)
-            throw new Error(`--media takes at most ${MEDIA_MAX} items (the web's LookBook limit)`);
-        body.assets = media;
-    }
-    return body;
-}
-/** Descriptions are stored as sanitized HTML; plain text becomes paragraphs. */
-function toHtml(text) {
-    if (/<\/?(p|br|h[1-6]|ul|ol|li|strong|em|b|i|u|s|a|blockquote|div|span|img|hr)\b[^>]*>/i.test(text))
-        return text;
-    const escape = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
-    return text
-        .trim()
-        .split(/\n{2,}/)
-        .map((para) => `<p>${escape(para).replace(/\n/g, '<br>')}</p>`)
-        .join('');
-}
-const toCreditDto = (c) => Object.fromEntries(CREDIT_FIELDS.filter((k) => c[k] !== undefined && c[k] !== null).map((k) => [k, c[k]]));
-/** Credits have no ids: read fresh, change, write the whole array back in order. */
-async function updateCredits(client, id, fn) {
-    const post = await client.getFresh(`${POSTS}/list/${id}`);
-    const next = fn((post.credits || []).map(toCreditDto)).map((c, i) => ({ ...c, order: i }));
-    if (next.length > 30)
-        throw new Error('A post can have at most 30 credits');
-    return client.put(`${POSTS}/list/${id}`, { credits: next });
-}
-const assetLabel = (a) => (a ? a.url || a.id || a : undefined);
-function printPost(p) {
-    detail([
-        ['id', p.id],
-        ['title', p.title],
-        ['kind', p.kind],
-        ['publish', p.publishStatus],
-        ['project', p.projectStatus],
-        ['category', p.category],
-        ['tags', (p.tags || []).join(', ')],
-        ['logline', p.logline],
-        ['description', truncate(p.descriptionText || p.description, 120)],
-        ['cover', assetLabel(p.cover)],
-        ['coverPortrait', assetLabel(p.coverPortrait)],
-        ['media', (p.assets || []).length ? `${p.assets.length} item(s)` : undefined],
-        ['episodes', (p.episodes || []).length ? `${p.episodes.length} (\`backreel episode list\`)` : undefined],
-        ['campaign', p.campaign ? `${p.campaign.raisedAmount}/${p.campaign.goalAmount} ${(p.campaign.currency || '').toUpperCase()}` : undefined],
-        ['donations', p.donation?.enabled ? 'on' : undefined],
-        ['trailer', p.trailer ? `${assetLabel(p.trailer)}${p.trailerDurationSec ? ` (${p.trailerDurationSec}s)` : ''}` : undefined],
-        ['creator', p.creator?.name],
-        ['likes', p.likeCount],
-        ['updated', relativeTime(p.updatedAt)],
-    ]);
-    process.stdout.write('\n');
-    printCredits(p.credits || []);
-}
-function printCredits(credits) {
-    table(credits.map((c, i) => ({ ...c, n: i + 1 })), [
-        { header: '#', value: (c) => c.n },
-        { header: 'kind', value: (c) => c.kind },
-        { header: 'name', value: (c) => truncate(c.name, 20) },
-        { header: 'role', value: (c) => truncate(c.role, 24) },
-        { header: 'source', value: (c) => c.source },
-        { header: 'npc / user', value: (c) => c.npcId || c.user },
-    ]);
-}