@paperboyseo/cli 0.0.0-stage → 0.1.0

package/dist/main.js

@@ -0,0 +1,77 @@
+import { createInterface } from 'node:readline/promises';
+import { parse } from './args.js';
+import { makeClient } from './context.js';
+import { CliError } from './errors.js';
+import { readConfig, resolveSettings } from './config.js';
+import { openBrowser } from './open.js';
+import { Output, colorEnabled } from './output.js';
+import { VERSION } from './version.js';
+import { check } from './commands/check.js';
+import { connect } from './commands/connect.js';
+import { mcp } from './commands/mcp.js';
+import { publish } from './commands/publish.js';
+import { report } from './commands/report.js';
+import { status } from './commands/status.js';
+import { topics } from './commands/topics.js';
+import { write } from './commands/write.js';
+import { HELP } from './help.js';
+const COMMANDS = { connect, topics, write, check, publish, status, report, mcp };
+async function defaultConfirm(question) {
+    const rl = createInterface({ input: process.stdin, output: process.stderr });
+    try {
+        const answer = await rl.question(`${question} [y/N] `);
+        return /^y(es)?$/i.test(answer.trim());
+    }
+    finally {
+        rl.close();
+    }
+}
+/** Run the CLI and return the process exit code: 0 ok, 1 check failed, 2 error. */
+export async function run(argv, opts = {}) {
+    const env = opts.env ?? process.env;
+    const stdout = opts.stdout ?? process.stdout;
+    const stderr = opts.stderr ?? process.stderr;
+    const out = new Output({
+        stdout,
+        stderr,
+        json: argv.includes('--json'),
+        color: colorEnabled({ env, stdout, noColorFlag: argv.includes('--no-color') }),
+    });
+    try {
+        const { flags, positionals } = parse(argv);
+        const [command, ...args] = positionals;
+        if (flags.version) {
+            out.result('version', { version: VERSION }, () => out.line(`paperboy ${VERSION}`));
+            return 0;
+        }
+        if (flags.help || !command || command === 'help') {
+            out.result('help', { usage: HELP }, () => out.line(HELP));
+            return 0;
+        }
+        const handler = COMMANDS[command];
+        if (!handler)
+            throw new CliError('usage', `Unknown command "${command}". Run \`paperboy --help\` for the list.`);
+        const settings = resolveSettings(flags, env, readConfig(env));
+        const interactive = opts.interactive ?? Boolean(stdout.isTTY && process.stdin.isTTY);
+        const ctx = {
+            flags,
+            args,
+            env,
+            out,
+            settings,
+            deps: {
+                fetch: opts.fetch,
+                sleep: opts.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, ms))),
+                open: opts.open ?? openBrowser,
+                confirm: opts.confirm ?? defaultConfirm,
+                interactive,
+            },
+            client: (overrides) => makeClient(ctx, overrides),
+        };
+        return await handler(ctx);
+    }
+    catch (err) {
+        out.fail(err);
+        return 2;
+    }
+}

package/dist/open.js

@@ -0,0 +1,29 @@
+import { spawn } from 'node:child_process';
+/** Best effort: open a URL in the default browser. Never throws. */
+export const openBrowser = (url) => {
+    if (!/^https?:\/\//i.test(url))
+        return;
+    let cmd;
+    let args;
+    switch (process.platform) {
+        case 'darwin':
+            cmd = 'open';
+            args = [url];
+            break;
+        case 'win32':
+            cmd = 'cmd';
+            args = ['/c', 'start', '""', url.replace(/&/g, '^&')];
+            break;
+        default:
+            cmd = 'xdg-open';
+            args = [url];
+    }
+    try {
+        const child = spawn(cmd, args, { stdio: 'ignore', detached: true, windowsVerbatimArguments: process.platform === 'win32' });
+        child.on('error', () => { });
+        child.unref();
+    }
+    catch {
+        // The URL is always printed as well, so failing to open is fine.
+    }
+};

package/dist/output.js

@@ -0,0 +1,99 @@
+import { CliError } from './errors.js';
+function wrap(on, open, close) {
+    return (s) => (on ? `\u001b[${open}m${s}\u001b[${close}m` : s);
+}
+export function makeStyle(on) {
+    return {
+        bold: wrap(on, 1, 22),
+        dim: wrap(on, 2, 22),
+        red: wrap(on, 31, 39),
+        green: wrap(on, 32, 39),
+        yellow: wrap(on, 33, 39),
+        cyan: wrap(on, 36, 39),
+    };
+}
+export function colorEnabled(opts) {
+    if (opts.noColorFlag)
+        return false;
+    if (opts.env['NO_COLOR'] !== undefined && opts.env['NO_COLOR'] !== '')
+        return false;
+    if (opts.env['FORCE_COLOR'] && opts.env['FORCE_COLOR'] !== '0')
+        return true;
+    return Boolean(opts.stdout.isTTY) && opts.env['TERM'] !== 'dumb';
+}
+export class Output {
+    json;
+    style;
+    stdout;
+    stderr;
+    constructor(opts) {
+        this.stdout = opts.stdout;
+        this.stderr = opts.stderr;
+        this.json = opts.json;
+        this.style = makeStyle(opts.color);
+    }
+    /** Human mode only: print a line to stdout. */
+    line(text = '') {
+        if (!this.json)
+            this.stdout.write(text + '\n');
+    }
+    /** Alias of line, used for progress notes. */
+    info(text) {
+        this.line(text);
+    }
+    /** Things the user must see even in JSON mode (device codes, links): stdout when human, stderr when JSON. */
+    prompt(text) {
+        if (this.json)
+            this.stderr.write(text + '\n');
+        else
+            this.stdout.write(text + '\n');
+    }
+    /** Emit the result of a command: one JSON object in JSON mode, otherwise run the human renderer. */
+    result(command, data, human) {
+        if (this.json)
+            this.stdout.write(JSON.stringify({ ok: true, command, data }) + '\n');
+        else
+            human();
+    }
+    fail(err) {
+        const e = toCliError(err);
+        if (this.json) {
+            const error = { code: e.code, message: e.message };
+            if (e.status !== undefined)
+                error.status = e.status;
+            this.stdout.write(JSON.stringify({ ok: false, error }) + '\n');
+        }
+        else {
+            this.stderr.write(`${this.style.red('error:')} ${e.message}\n`);
+        }
+    }
+}
+export function toCliError(err) {
+    if (err instanceof CliError)
+        return err;
+    const message = err instanceof Error ? err.message : String(err);
+    return new CliError('unexpected_error', message);
+}
+export function num(n) {
+    return typeof n === 'number' && Number.isFinite(n) ? n.toLocaleString('en-US') : '0';
+}
+export function fixed(n, digits = 1) {
+    return typeof n === 'number' && Number.isFinite(n) ? n.toFixed(digits) : '-';
+}
+const BARS = '▁▂▃▄▅▆▇█';
+export function sparkline(values) {
+    if (values.length === 0)
+        return '';
+    const max = Math.max(...values);
+    const min = Math.min(...values);
+    const span = max - min;
+    return values
+        .map((v) => BARS[span === 0 ? (max === 0 ? 0 : 3) : Math.round(((v - min) / span) * (BARS.length - 1))])
+        .join('');
+}
+export function padRight(s, width) {
+    return s.length >= width ? s : s + ' '.repeat(width - s.length);
+}
+export function padLeft(s, width) {
+    return s.length >= width ? s : ' '.repeat(width - s.length) + s;
+}

package/dist/site.js

@@ -0,0 +1,43 @@
+import { CliError } from './errors.js';
+function normalizeDomain(value) {
+    return value
+        .trim()
+        .toLowerCase()
+        .replace(/^https?:\/\//, '')
+        .replace(/^www\./, '')
+        .replace(/\/.*$/, '');
+}
+async function listSites(api) {
+    const res = await api.get('/api/v1/sites');
+    return Array.isArray(res.data.sites) ? res.data.sites : [];
+}
+function describe(sites) {
+    return sites.map((s) => `  ${s.domain} (${s.id})`).join('\n');
+}
+/**
+ * Resolve the site id to operate on: --site (id or domain), then the saved default,
+ * then the only site on the account.
+ */
+export async function resolveSiteId(ctx) {
+    const api = ctx.client();
+    const wanted = ctx.settings.site;
+    if (wanted) {
+        // Domains always contain a dot and ids never do, so ids skip the lookup.
+        if (!wanted.includes('.'))
+            return wanted;
+        const sites = await listSites(api);
+        const target = normalizeDomain(wanted);
+        const match = sites.find((s) => s.id === wanted || normalizeDomain(s.domain) === target);
+        if (match)
+            return match.id;
+        throw new CliError('site_not_found', `No site matches "${wanted}".` + (sites.length ? `\nYour sites:\n${describe(sites)}` : ' Run `paperboy connect https://yoursite.com` to add one.'));
+    }
+    const sites = await listSites(api);
+    const [only] = sites;
+    if (sites.length === 1 && only)
+        return only.id;
+    if (sites.length === 0) {
+        throw new CliError('no_site', 'No sites on this account yet. Run `paperboy connect https://yoursite.com` to add one.');
+    }
+    throw new CliError('site_required', `More than one site on this account. Pick one with --site <id|domain>:\n${describe(sites)}`);
+}

package/dist/version.js

@@ -0,0 +1,2 @@
+export const VERSION = '0.1.0';
+export const DEFAULT_BASE_URL = 'https://paperboyseo.com';

package/package.json

@@ -1,6 +1,52 @@
 {
   "name": "@paperboyseo/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Command line interface for Paperboy, the open-source growth engine that reads Search Console, picks topics, writes and fact-checks articles, publishes and measures.",
+  "license": "AGPL-3.0-only",
+  "type": "module",
+  "bin": {
+    "paperboy": "dist/cli.js",
+    "paperboy-seo": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/paperboyseo/paperboy.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://paperboyseo.com/docs/cli",
+  "bugs": {
+    "url": "https://github.com/paperboyseo/paperboy/issues"
+  },
+  "keywords": [
+    "paperboy",
+    "seo",
+    "search-console",
+    "content",
+    "fact-check",
+    "cli",
+    "growth"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node -e \"require('node:fs').chmodSync('dist/cli.js', 0o755)\"",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.test.json --noEmit",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.9.0",
+    "vitest": "^3.2.0"
+  }
+}