@forumulate/cli 0.9.0 → 0.10.0

package/dist/publish-command.d.ts

@@ -0,0 +1,55 @@
+import type { ForumulateClient } from '@forumulate/sdk';
+/**
+ * `forumulate publish` and `forumulate sync` as the CLI runs them: the
+ * argument forms, the purge, and the run report (FMU-DOC07, D04, D16).
+ *
+ * Three argument forms grew up over time — a page id, a folder, and the folder
+ * with org and space as positionals — and the guides used all three, so an
+ * integrator could not tell which was current. One form is documented now
+ * (`publish <folder> --org … --space …`); the others still work and say so on
+ * stderr, with the line to use instead.
+ */
+export interface PublishCliDeps {
+    client: ForumulateClient;
+    authed: boolean;
+    out: (l: string) => void;
+    err: (l: string) => void;
+    env?: NodeJS.ProcessEnv;
+    upload?: (path: string, form: FormData) => Promise<unknown>;
+    sleep?: (ms: number) => Promise<void>;
+}
+export interface FolderFlags {
+    org?: string;
+    space?: string;
+    manifest?: string;
+    dryRun: boolean;
+    prune: boolean;
+    force: boolean;
+    verify: boolean;
+    only?: string[];
+    paceMs: number;
+    json: boolean;
+    diff: boolean;
+    purge?: string;
+    report: boolean;
+    command: 'publish' | 'sync';
+    /** `--preview <name>` (FMU-F01): send the plan's pages to a preview, publish nothing. */
+    preview?: string;
+    /** `--preview-ttl <days>`. */
+    previewTtl?: string;
+    /** `--comment`: post (or update) the preview's comment on the pull request. */
+    comment?: boolean;
+}
+/** `publish …` in any of its forms. */
+export declare function runPublishCli(rest: string[], flags: Omit<FolderFlags, 'command'>, deps: PublishCliDeps): Promise<number>;
+/** The folder publish/sync, its run reported to the API, its summary printed. */
+export declare function runFolder(folder: string, flags: FolderFlags, deps: PublishCliDeps): Promise<number>;
+/** Many `purged` answers (one per import batch) as one. */
+export declare function mergePurged(answers: Record<string, unknown>[]): {
+    scope: string;
+    urlCount: number;
+    urls: string[];
+    edge: string;
+    edges: unknown[];
+} | null;
+//# sourceMappingURL=publish-command.d.ts.map

package/dist/publish-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-command.d.ts","sourceRoot":"","sources":["../src/publish-command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAKxD;;;;;;;;;GASG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,gBAAgB,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,SAAS,GAAG,MAAM,CAAC;IAC5B,yFAAyF;IACzF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+EAA+E;IAC/E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAaD,uCAAuC;AACvC,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EACnC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CAgCjB;AAED,iFAAiF;AACjF,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,MAAM,CAAC,CA4FjB;AAgDD,2DAA2D;AAC3D,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACjC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,EAAE,CAAA;CAAE,GAAG,IAAI,CAuB5F"}

package/dist/publish-command.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runPublishCli = runPublishCli;
+exports.runFolder = runFolder;
+exports.mergePurged = mergePurged;
+const node_fs_1 = require("node:fs");
+const command_1 = require("./publish/command");
+const exit_codes_1 = require("./exit-codes");
+const preview_comment_1 = require("./preview-comment");
+const isDir = (p) => {
+    try {
+        return Boolean(p) && (0, node_fs_1.statSync)(p).isDirectory();
+    }
+    catch {
+        return false;
+    }
+};
+const PURGES = ['page', 'space', 'none'];
+/** `publish …` in any of its forms. */
+async function runPublishCli(rest, flags, deps) {
+    const purge = flags.purge ?? 'page';
+    if (!PURGES.includes(purge)) {
+        deps.err(`--purge takes page, space or none (got "${purge}").`);
+        return exit_codes_1.EXIT.USAGE;
+    }
+    if (rest.length === 1 && isDir(rest[0]))
+        return runFolder(rest[0], { ...flags, command: 'publish' }, deps);
+    if (rest.length === 3 && isDir(rest[2])) {
+        deps.err(`notice: \`publish <orgId> <spaceId> <folder>\` is deprecated; use \`forumulate publish ${rest[2]} --org ${rest[0]} --space ${rest[1]}\`.`);
+        return runFolder(rest[2], { ...flags, org: rest[0], space: rest[1], command: 'publish' }, deps);
+    }
+    const [orgId, spaceId, pageId] = rest;
+    if (rest.length === 3 && orgId && spaceId && pageId) {
+        deps.err(`notice: \`publish <orgId> <spaceId> <pageId>\` is deprecated; use \`forumulate items publish ${pageId} --org ${orgId} --space ${spaceId}\`, or publish the folder the page lives in.`);
+        const res = await deps.client.request('POST', `/orgs/${orgId}/spaces/${spaceId}/pages/${pageId}/publish`, { body: { purge } });
+        if (flags.json)
+            deps.out(JSON.stringify(res, null, 2));
+        else
+            deps.out(`Published ${pageId}${res?.purged ? `; purged (edge ${String(res.purged.edge)})` : ''}.`);
+        return exit_codes_1.EXIT.OK;
+    }
+    if (rest.length === 1)
+        deps.err(`${rest[0]} is not a folder.`);
+    deps.err('Usage: forumulate publish <folder> --org <id|slug> --space <id|slug> [flags]');
+    deps.err('       forumulate publish --help');
+    return exit_codes_1.EXIT.USAGE;
+}
+/** The folder publish/sync, its run reported to the API, its summary printed. */
+async function runFolder(folder, flags, deps) {
+    let report;
+    const code = await (0, command_1.runPublish)({
+        folder,
+        org: flags.org,
+        space: flags.space,
+        manifest: flags.manifest,
+        dryRun: flags.dryRun,
+        prune: flags.prune,
+        force: flags.force,
+        verify: flags.verify,
+        only: flags.only,
+        paceMs: flags.paceMs,
+        json: flags.json,
+        diff: flags.diff,
+        command: flags.command,
+        purge: flags.purge ?? 'page',
+        preview: flags.preview,
+        previewTtlDays: flags.previewTtl && /^\d+$/.test(flags.previewTtl) ? Number(flags.previewTtl) : undefined,
+    }, {
+        client: deps.client,
+        authed: deps.authed,
+        out: deps.out,
+        err: deps.err,
+        upload: deps.upload,
+        env: deps.env,
+        sleep: deps.sleep,
+        report: (r) => (report = r),
+    });
+    if (!report)
+        return code;
+    const r = report;
+    // The pull-request comment, on whatever host the CI runs on (FMU-F01).
+    if (flags.comment && r.previews.length) {
+        for (const p of r.previews) {
+            const posted = await (0, preview_comment_1.postPreviewComment)(p, deps.env ?? process.env).catch((e) => {
+                deps.err(`warning: the pull-request comment was not posted (${e.message}).`);
+                return null;
+            });
+            if (posted)
+                deps.err(`Commented on ${posted}.`);
+        }
+    }
+    const verify = r.dryRun || !flags.verify ? 'skipped' : r.unverified.length ? 'mismatch' : 'ok';
+    const spaces = [...new Set(r.lines.map((l) => l.space).filter((s) => s !== 'site'))];
+    const runs = [];
+    // Recorded only when something was attempted: a plan is the caller's to keep.
+    if (flags.report && !r.dryRun && deps.authed)
+        for (const space of spaces) {
+            const run = await recordRun(deps, flags.org, space, r, verify).catch((e) => {
+                deps.err(`warning: the run was not recorded (${e.message}); publish.completed was not sent.`);
+                return null;
+            });
+            if (run)
+                runs.push(run);
+        }
+    if (flags.json) {
+        const n = (k) => r.counts[k] ?? 0;
+        deps.out(JSON.stringify({
+            space: spaces.length === 1 ? spaces[0] : spaces,
+            created: n('create'),
+            updated: n('update') + n('meta') + n('move') + n('order') + n('patch'),
+            unchanged: r.unchanged,
+            trashed: n('prune'),
+            purged: mergePurged(r.purged),
+            verify,
+            diffUrl: runs[0]?.summary?.diffUrl ?? null,
+            runIds: runs.map((x) => x.id),
+            conflicts: r.conflicts,
+            previews: r.previews,
+            dryRun: r.dryRun,
+            writes: r.writes,
+            counts: r.counts,
+            errors: r.errors,
+            unverified: r.unverified,
+            lines: r.lines,
+        }, null, 2));
+    }
+    else if (runs.length) {
+        const p = mergePurged(r.purged);
+        if (p)
+            deps.out(`Purged ${p.urlCount} address(es); edge ${p.edge}.`);
+        for (const run of runs)
+            deps.out(`Run ${String(run.id)}: ${String(run.summary?.diffUrl ?? '')}`);
+    }
+    return code;
+}
+/** POST the run for one space (by slug or id) so the API records it and fires publish.completed. */
+async function recordRun(deps, orgRef, spaceRef, r, verify) {
+    const org = orgRef ?? deps.env?.FORUMULATE_ORG ?? process.env.FORUMULATE_ORG;
+    if (!org)
+        return null;
+    const spaceId = await spaceIdOf(deps, org, spaceRef);
+    const lines = r.lines.filter((l) => l.space === spaceRef);
+    const counts = {};
+    for (const l of lines)
+        counts[l.line.verb] = (counts[l.line.verb] ?? 0) + 1;
+    const res = await deps.client.request('POST', `/orgs/${org}/spaces/${spaceId}/publish-runs`, {
+        body: {
+            dryRun: false,
+            counts: Object.fromEntries(Object.entries(counts).filter(([k]) => k !== 'same')),
+            unchanged: counts.same ?? 0,
+            writes: r.writes,
+            lines: lines
+                .filter((l) => l.line.verb !== 'same')
+                .slice(0, 5000)
+                .map((l) => ({ space: l.space, ...l.line })),
+            errors: r.errors.filter((e) => e.startsWith(`${spaceRef}:`) || !e.includes(':')).slice(0, 500),
+            verify,
+            purged: mergePurged(r.purged),
+        },
+    });
+    return res.run;
+}
+async function spaceIdOf(deps, org, ref) {
+    if (/^[0-9a-f-]{36}$/i.test(ref))
+        return ref;
+    const res = await deps.client.request('GET', `/orgs/${org}/spaces`, { query: { limit: 200 } });
+    return res.spaces?.find((s) => s.slug === ref)?.id ?? ref;
+}
+/** Many `purged` answers (one per import batch) as one. */
+function mergePurged(answers) {
+    if (answers.length === 0)
+        return null;
+    const urls = new Set();
+    const edges = [];
+    const names = new Set();
+    let scope = 'page';
+    let count = 0;
+    for (const a of answers) {
+        for (const u of a.urls ?? [])
+            urls.add(u);
+        count += Number(a.urlCount ?? 0);
+        for (const e of a.edges ?? []) {
+            edges.push(e);
+            names.add(e.name);
+        }
+        if (a.scope === 'space' || a.purged === 'space')
+            scope = 'space';
+    }
+    return {
+        scope,
+        urlCount: Math.max(count, urls.size),
+        urls: [...urls].slice(0, 200),
+        edge: names.size === 0 ? 'none' : names.size === 1 ? [...names][0] : 'multiple',
+        edges,
+    };
+}
+//# sourceMappingURL=publish-command.js.map

package/dist/publish-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-command.js","sourceRoot":"","sources":["../src/publish-command.ts"],"names":[],"mappings":"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"}

package/dist/run.d.ts

@@ -2,11 +2,8 @@ import type { ForumulateClient } from '@forumulate/sdk';
 import { type ContentDeps } from './content/command';
 import type { SyncFiles } from './translations/sync';
 import type { Http } from './api/http';
-/**
- * Kept in step with package.json by `cli-version.test.ts` — they had drifted to
- * 0.1.0 and 0.2.1, so `--version` reported a release that was never published.
- */
-export declare const VERSION = "0.9.0";
+import { VERSION } from './version';
+export { VERSION };
 export interface RunDeps {
     /** The API client. Injected so the CLI is testable without a live server. */
     client: ForumulateClient;
@@ -47,9 +44,5 @@ export interface RunDeps {
     /** File access for `translations pull|push`, which also walks a folder. */
     translationFiles?: SyncFiles;
 }
-/**
- * Parse and execute a CLI invocation. Pure w.r.t. I/O (uses the injected deps),
- * so it can be unit-tested with a fake client. Returns a process exit code.
- */
-export declare function run(argv: string[], deps: RunDeps): Promise<number>;
+export declare function run(argvIn: string[], deps: RunDeps): Promise<number>;
 //# sourceMappingURL=run.d.ts.map

package/dist/run.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAOxD,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,MAAM,WAAW,OAAO;IACtB,6EAA6E;IAC7E,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,uGAAuG;IACvG,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,sEAAsE;IACtE,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;IAC7C,iEAAiE;IACjE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,SAAS,CAAC;CAC9B;AAiBD;;;GAGG;AACH,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAgaxE"}
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../src/run.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAWxD,OAAO,EAAmC,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAKtF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAIrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,CAAC;AAEnB,MAAM,WAAW,OAAO;IACtB,6EAA6E;IAC7E,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0FAA0F;IAC1F,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,uGAAuG;IACvG,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5C,sEAAsE;IACtE,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,MAAM,CAAC;IAC7C,iEAAiE;IACjE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,IAAI,CAAC;IAC1D,SAAS,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,SAAS,CAAC;CAC9B;AA8BD,wBAAsB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CA6a1E"}