frontpage-host 0.1.17 → 0.1.19

package/dist/commands/people.js

@@ -0,0 +1,341 @@
+import { writeFile } from "node:fs/promises";
+import { resolveSlug } from "../site.js";
+import { CliHttpError, EXIT_OK, EXIT_USAGE, apiBase, exitCodeForError, getBearerAuthHeader, httpErrorFromV1, v1Delete, v1Get, v1Patch, v1Post, } from "../http/client.js";
+import { assertNoUnknownFlags, hasFlag, takeFlag } from "../argv.js";
+import { emitErr, emitOk, isJson } from "../runtime.js";
+const USAGE = "Usage: frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export [--site <slug>] [--json]";
+const PERSON_ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function requireId(work) {
+    const fromFlag = takeFlag(work, "--id");
+    const positional = work.find((a) => !a.startsWith("-"));
+    const raw = fromFlag ?? (positional
+        ? work.splice(work.indexOf(positional), 1)[0]
+        : undefined);
+    if (!raw) {
+        throw new CliHttpError(`Person id is required. Run: frontpage help people`, EXIT_USAGE, 0, "bad_request");
+    }
+    if (!PERSON_ID_RE.test(raw)) {
+        throw new CliHttpError("Person not found.", EXIT_USAGE, 404, "not_found");
+    }
+    return raw;
+}
+function requireEventId(raw) {
+    if (!raw) {
+        throw new CliHttpError(`Usage: frontpage people rm-note <id> --event <eventId>`, EXIT_USAGE, 0, "bad_request");
+    }
+    if (!PERSON_ID_RE.test(raw)) {
+        throw new CliHttpError("Event not found.", EXIT_USAGE, 404, "not_found");
+    }
+    return raw;
+}
+function displayName(row) {
+    return row.name || row.email || row.phone || row.id;
+}
+function printPerson(row) {
+    const bits = [row.status ?? "—", displayName(row)];
+    if (row.email && row.email !== row.name)
+        bits.push(row.email);
+    if (row.phone && row.phone !== row.name)
+        bits.push(row.phone);
+    if (row.followUpAt)
+        bits.push(`follow-up ${row.followUpAt}`);
+    if (row.hiddenAt)
+        bits.push("hidden");
+    if (row.tags?.length)
+        bits.push(row.tags.join(","));
+    if (row.lastEvent?.summary)
+        bits.push(row.lastEvent.summary);
+    console.log(`${row.id}  ${bits.join("  ·  ")}`);
+}
+async function fetchPeopleCsv(path) {
+    const headers = await getBearerAuthHeader();
+    const res = await fetch(`${apiBase()}${path}`, {
+        headers: { ...headers, Accept: "text/csv" },
+    });
+    const text = await res.text();
+    if (res.ok)
+        return text;
+    let parsed = {};
+    try {
+        parsed = text ? JSON.parse(text) : {};
+    }
+    catch {
+        parsed = {};
+    }
+    throw httpErrorFromV1(res.status, parsed, text || `Request failed (${res.status})`);
+}
+export async function runPeople(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        const sub = rest[0];
+        const base = `/api/v1/sites/${encodeURIComponent(slug)}/people`;
+        if (!sub || sub === "list") {
+            const work = sub === "list" ? rest.slice(1) : [...rest];
+            const q = takeFlag(work, "--q") ?? takeFlag(work, "--query");
+            const status = takeFlag(work, "--status");
+            const source = takeFlag(work, "--source");
+            const formSlug = takeFlag(work, "--form-slug");
+            const followUp = takeFlag(work, "--follow-up");
+            const sort = takeFlag(work, "--sort");
+            const lastSeenDays = takeFlag(work, "--last-seen-days");
+            const limit = takeFlag(work, "--limit");
+            const cursor = takeFlag(work, "--cursor");
+            const hidden = hasFlag(work, "--hidden");
+            const tag = takeFlag(work, "--tag");
+            assertNoUnknownFlags(work, "people");
+            const params = new URLSearchParams();
+            if (q)
+                params.set("q", q);
+            if (status)
+                params.set("status", status);
+            if (source)
+                params.set("source", source);
+            if (formSlug)
+                params.set("formSlug", formSlug);
+            if (followUp)
+                params.set("followUp", followUp);
+            if (sort)
+                params.set("sort", sort);
+            if (lastSeenDays)
+                params.set("lastSeenDays", lastSeenDays);
+            if (limit)
+                params.set("limit", limit);
+            if (cursor)
+                params.set("cursor", cursor);
+            if (hidden)
+                params.set("hidden", "1");
+            if (tag)
+                params.set("tag", tag);
+            const qs = params.toString();
+            const data = await v1Get(qs ? `${base}?${qs}` : base);
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            const rows = data.people ?? [];
+            if (rows.length === 0) {
+                console.log(hidden ? "No hidden people." : "No people.");
+                return EXIT_OK;
+            }
+            for (const row of rows)
+                printPerson(row);
+            if (data.nextCursor)
+                console.log(`next: ${data.nextCursor}`);
+            return EXIT_OK;
+        }
+        if (sub === "get") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            assertNoUnknownFlags(work, "people");
+            const data = await v1Get(`${base}/${encodeURIComponent(id)}`);
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            printPerson(data.person);
+            const events = data.events ?? [];
+            for (const ev of events) {
+                const row = ev;
+                const extra = typeof row.payload?.body === "string" ? `  ${row.payload.body}` : "";
+                console.log(`  ${row.occurredAt ?? ""}  ${row.type ?? ""}${extra}`);
+            }
+            return EXIT_OK;
+        }
+        if (sub === "add") {
+            const work = rest.slice(1);
+            const email = takeFlag(work, "--email");
+            const phone = takeFlag(work, "--phone");
+            const name = takeFlag(work, "--name");
+            const note = takeFlag(work, "--note");
+            assertNoUnknownFlags(work, "people");
+            if (!email && !phone) {
+                console.error("Usage: frontpage people add --email you@example.com | --phone +15551234567 [--name …] [--note …]");
+                return EXIT_USAGE;
+            }
+            const data = await v1Post(base, {
+                email,
+                phone,
+                name,
+                note,
+            });
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            printPerson(data.person);
+            return EXIT_OK;
+        }
+        if (sub === "set") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            const body = {};
+            for (const field of ["name", "email", "phone", "notes", "status"]) {
+                const v = takeFlag(work, `--${field}`);
+                if (v !== undefined)
+                    body[field] = v === "" ? null : v;
+            }
+            assertNoUnknownFlags(work, "people");
+            if (Object.keys(body).length === 0) {
+                console.error("Usage: frontpage people set <id> [--name …] [--email …] [--phone …] [--notes …] [--status …]");
+                return EXIT_USAGE;
+            }
+            const data = await v1Patch(`${base}/${encodeURIComponent(id)}`, body);
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            printPerson(data.person);
+            return EXIT_OK;
+        }
+        if (sub === "note") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            const body = takeFlag(work, "--body") ?? takeFlag(work, "--note");
+            assertNoUnknownFlags(work, "people");
+            if (!body) {
+                console.error("Usage: frontpage people note <id> --body \"…\"");
+                return EXIT_USAGE;
+            }
+            const data = await v1Post(`${base}/${encodeURIComponent(id)}/events`, { body });
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            console.log(`Noted ${id} (${data.event.id})`);
+            return EXIT_OK;
+        }
+        if (sub === "rm-note") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            const eventId = requireEventId(takeFlag(work, "--event") ?? takeFlag(work, "--event-id"));
+            assertNoUnknownFlags(work, "people");
+            const data = await v1Delete(`${base}/${encodeURIComponent(id)}/events/${encodeURIComponent(eventId)}`);
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            console.log(`Removed note ${data.removed.id}`);
+            return EXIT_OK;
+        }
+        if (sub === "follow-up") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            const clear = hasFlag(work, "--clear");
+            const at = takeFlag(work, "--at");
+            assertNoUnknownFlags(work, "people");
+            if (!clear && !at) {
+                console.error("Usage: frontpage people follow-up <id> --at <iso> | --clear");
+                return EXIT_USAGE;
+            }
+            const data = await v1Patch(`${base}/${encodeURIComponent(id)}/follow-up`, { at: clear ? null : at });
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            printPerson(data.person);
+            return EXIT_OK;
+        }
+        if (sub === "hide") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            assertNoUnknownFlags(work, "people");
+            const data = await v1Post(`${base}/${encodeURIComponent(id)}/hide`, {});
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            console.log(`Hidden ${displayName(data.person)}`);
+            return EXIT_OK;
+        }
+        if (sub === "unhide") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            assertNoUnknownFlags(work, "people");
+            const data = await v1Post(`${base}/${encodeURIComponent(id)}/unhide`, {});
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            console.log(`Restored ${displayName(data.person)}`);
+            return EXIT_OK;
+        }
+        if (sub === "tag") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            const add = takeFlag(work, "--add");
+            const remove = takeFlag(work, "--remove") ?? takeFlag(work, "--rm");
+            assertNoUnknownFlags(work, "people");
+            if ((!add && !remove) || (add && remove)) {
+                console.error("Usage: frontpage people tag <id> --add <tag> | --remove <tag>");
+                return EXIT_USAGE;
+            }
+            const data = add
+                ? await v1Post(`${base}/${encodeURIComponent(id)}/tags`, {
+                    tag: add,
+                })
+                : await v1Delete(`${base}/${encodeURIComponent(id)}/tags/${encodeURIComponent(remove)}`);
+            if (isJson()) {
+                emitOk("people", data);
+                return EXIT_OK;
+            }
+            printPerson(data.person);
+            return EXIT_OK;
+        }
+        if (sub === "export") {
+            const work = rest.slice(1);
+            const q = takeFlag(work, "--q") ?? takeFlag(work, "--query");
+            const status = takeFlag(work, "--status");
+            const source = takeFlag(work, "--source");
+            const formSlug = takeFlag(work, "--form-slug");
+            const followUp = takeFlag(work, "--follow-up");
+            const sort = takeFlag(work, "--sort");
+            const lastSeenDays = takeFlag(work, "--last-seen-days");
+            const tag = takeFlag(work, "--tag");
+            const out = takeFlag(work, "--out");
+            const hidden = hasFlag(work, "--hidden");
+            assertNoUnknownFlags(work, "people");
+            const params = new URLSearchParams();
+            if (q)
+                params.set("q", q);
+            if (status)
+                params.set("status", status);
+            if (source)
+                params.set("source", source);
+            if (formSlug)
+                params.set("formSlug", formSlug);
+            if (followUp)
+                params.set("followUp", followUp);
+            if (sort)
+                params.set("sort", sort);
+            if (lastSeenDays)
+                params.set("lastSeenDays", lastSeenDays);
+            if (hidden)
+                params.set("hidden", "1");
+            if (tag)
+                params.set("tag", tag);
+            const qs = params.toString();
+            const csv = await fetchPeopleCsv(qs ? `${base}/export?${qs}` : `${base}/export`);
+            if (out) {
+                await writeFile(out, csv, "utf8");
+                if (isJson()) {
+                    emitOk("people", { path: out, bytes: Buffer.byteLength(csv, "utf8") });
+                    return EXIT_OK;
+                }
+                console.log(out);
+                return EXIT_OK;
+            }
+            process.stdout.write(csv);
+            if (!csv.endsWith("\n"))
+                process.stdout.write("\n");
+            return EXIT_OK;
+        }
+        console.error(USAGE);
+        return EXIT_USAGE;
+    }
+    catch (err) {
+        if (isJson())
+            return emitErr("people", err);
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/publish.js

@@ -48,11 +48,13 @@ export async function runPublish(args) {
                 progress("Waiting for the site compile…\n");
             const compile = await waitForCompileReady({ slug });
             if (compile.exitCode !== EXIT_OK) {
-                const message = compile.failed
-                    ? "Site compile failed. Refusing to publish a previous build."
-                    : compile.timedOut
-                        ? "Timed out waiting for the site compile. Refusing to publish a previous build."
-                        : "Site compile is not ready. Refusing to publish a previous build.";
+                const message = compile.apiMissing
+                    ? "Compile status API is missing. Refusing to publish."
+                    : compile.failed
+                        ? "Site compile failed. Refusing to publish a previous build."
+                        : compile.timedOut
+                            ? "Timed out waiting for the site compile. Refusing to publish a previous build."
+                            : "Site compile is not ready. Refusing to publish a previous build.";
                 return emitFail("publish", {
                     message,
                     exitCode: compile.exitCode,
@@ -61,11 +63,13 @@ export async function runPublish(args) {
                         compile: compile.status,
                         tip: compile.status?.stagingCommit ?? null,
                         live: compile.status?.liveCommit ?? null,
-                        status: compile.failed
-                            ? "compile_failed"
-                            : compile.timedOut
-                                ? "compile_timeout"
-                                : "compile_not_ready",
+                        status: compile.apiMissing
+                            ? "compile_api_missing"
+                            : compile.failed
+                                ? "compile_failed"
+                                : compile.timedOut
+                                    ? "compile_timeout"
+                                    : "compile_not_ready",
                     },
                 });
             }

package/dist/commands/push.d.ts

@@ -1 +1,6 @@
+/** Remote allowlisted paths that are gone locally become explicit deletes. */
+export declare function pushDeletesForMissingLocal(localPaths: Iterable<string>, remotePaths: Iterable<string>): Array<{
+    path: string;
+    delete: true;
+}>;
 export declare function runPush(args: string[]): Promise<number>;

package/dist/commands/push.js

@@ -1,7 +1,7 @@
 import { readdir, readFile, stat } from "node:fs/promises";
 import { join, relative, sep } from "node:path";
 import { resolveSlug } from "../site.js";
-import { EXIT_OK, EXIT_USAGE, v1Put } from "../http/client.js";
+import { EXIT_OK, EXIT_USAGE, v1Get, v1Put } from "../http/client.js";
 import { readState, writeState } from "../state/frontpage-state.js";
 import { emitErr, emitOk, emitUsage, isJson } from "../runtime.js";
 import { waitForAgentThenCompile } from "./wait-site-compile.js";
@@ -26,6 +26,14 @@ const TEXT_EXTS = new Set([
     ".toml",
 ]);
 const ROOTS = ["src", "public", "content"];
+/** Remote allowlisted paths that are gone locally become explicit deletes. */
+export function pushDeletesForMissingLocal(localPaths, remotePaths) {
+    const local = new Set(localPaths);
+    return [...remotePaths]
+        .filter((path) => path && !local.has(path))
+        .sort()
+        .map((path) => ({ path, delete: true }));
+}
 async function walkAllowlisted(cwd) {
     const out = [];
     async function walk(abs) {
@@ -85,7 +93,10 @@ export async function runPush(args) {
         if (paths.length === 0) {
             return emitUsage("push", "No allowlisted files (src/, public/, content/) found in this folder.", EXIT_USAGE);
         }
-        const files = [];
+        const listing = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/files`);
+        const files = [
+            ...pushDeletesForMissingLocal(paths, listing.files.map((f) => f.path)),
+        ];
         for (const path of paths) {
             const abs = join(cwd, path);
             const st = await stat(abs);

package/dist/commands/redirects.d.ts

@@ -0,0 +1 @@
+export declare function runRedirects(args: string[]): Promise<number>;

package/dist/commands/redirects.js

@@ -0,0 +1,83 @@
+import { resolveSlug } from "../site.js";
+import { CliHttpError, EXIT_OK, EXIT_USAGE, exitCodeForError, v1Delete, v1Get, v1Put } from "../http/client.js";
+import { assertNoUnknownFlags, takeFlag } from "../argv.js";
+import { emitErr, emitOk, isJson } from "../runtime.js";
+const USAGE = "Usage: frontpage redirects list | set --from /old --to /new [--status 301|308] | rm --from /old [--site <slug>] [--json]";
+function requirePathFlag(work, flag) {
+    const value = takeFlag(work, flag);
+    if (!value) {
+        throw new CliHttpError(`${flag} is required (e.g. ${flag} /old).`, EXIT_USAGE, 0, "bad_request");
+    }
+    if (!value.startsWith("/") || value.startsWith("//")) {
+        throw new CliHttpError(`${flag} must be a pathname starting with /.`, EXIT_USAGE, 0, "bad_request");
+    }
+    return value;
+}
+export async function runRedirects(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        const sub = rest[0];
+        if (!sub || sub === "list") {
+            const work = sub === "list" ? rest.slice(1) : [...rest];
+            assertNoUnknownFlags(work, "redirects");
+            const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/redirects`);
+            if (isJson()) {
+                emitOk("redirects", data);
+                return EXIT_OK;
+            }
+            const rows = data.redirects ?? [];
+            if (rows.length === 0) {
+                console.log("No redirects.");
+                return EXIT_OK;
+            }
+            for (const row of rows) {
+                console.log(`${row.from} → ${row.to} (${row.status})`);
+            }
+            return EXIT_OK;
+        }
+        if (sub === "set") {
+            const work = rest.slice(1);
+            const from = requirePathFlag(work, "--from");
+            const to = requirePathFlag(work, "--to");
+            const statusRaw = takeFlag(work, "--status");
+            assertNoUnknownFlags(work, "redirects");
+            const body = { from, to };
+            if (statusRaw !== undefined) {
+                const status = Number(statusRaw);
+                if (status !== 301 && status !== 308) {
+                    console.error("Status must be 301 or 308.");
+                    return EXIT_USAGE;
+                }
+                body.status = status;
+            }
+            const data = await v1Put(`/api/v1/sites/${encodeURIComponent(slug)}/redirects`, body);
+            if (isJson()) {
+                emitOk("redirects", data);
+                return EXIT_OK;
+            }
+            const row = data.redirect;
+            console.log(`${row.from} → ${row.to} (${row.status})`);
+            return EXIT_OK;
+        }
+        if (sub === "rm" || sub === "remove") {
+            const work = rest.slice(1);
+            const from = requirePathFlag(work, "--from");
+            assertNoUnknownFlags(work, "redirects");
+            const data = await v1Delete(`/api/v1/sites/${encodeURIComponent(slug)}/redirects?from=${encodeURIComponent(from)}`);
+            if (isJson()) {
+                emitOk("redirects", data);
+                return EXIT_OK;
+            }
+            console.log(`Removed ${data.removed.from}`);
+            return EXIT_OK;
+        }
+        console.error(USAGE);
+        return EXIT_USAGE;
+    }
+    catch (err) {
+        if (isJson())
+            return emitErr("redirects", err);
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/shop-ids.d.ts

@@ -0,0 +1,3 @@
+/** Same kebab rules as the Store silo. Kept here so the CLI does not import app lib. */
+export declare const SHOP_ID_RE: RegExp;
+export declare const VARIANT_ID_RE: RegExp;

package/dist/commands/shop-ids.js

@@ -0,0 +1,3 @@
+/** Same kebab rules as the Store silo. Kept here so the CLI does not import app lib. */
+export const SHOP_ID_RE = /^[a-z0-9][a-z0-9-]{1,39}$/;
+export const VARIANT_ID_RE = /^[a-z0-9][a-z0-9-]{0,39}$/;

package/dist/commands/shop.d.ts

@@ -0,0 +1 @@
+export declare function runShop(args: string[]): Promise<number>;