frontpage-host 0.1.0

package/dist/commands/extensions.js

@@ -0,0 +1,60 @@
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, EXIT_USAGE, exitCodeForError, v1Get, v1Post } from "../http/client.js";
+function takeFlag(rest, name) {
+    const i = rest.indexOf(name);
+    if (i === -1)
+        return undefined;
+    const v = rest[i + 1];
+    rest.splice(i, 2);
+    return v;
+}
+export async function runExtensions(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        const sub = rest[0];
+        if (!sub || sub === "list" || sub === "ls") {
+            const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/extensions`);
+            if (!data.enabled) {
+                console.log("Extensions are not enabled for this environment.");
+                return EXIT_OK;
+            }
+            for (const e of data.extensions) {
+                console.log(`${e.key.padEnd(20)}  ${String(e.state).padEnd(12)}  ${e.name}`);
+            }
+            return EXIT_OK;
+        }
+        if (sub === "enable" || sub === "disable" || sub === "config") {
+            const key = rest[1];
+            if (!key) {
+                console.error(`Usage: frontpage extensions ${sub} <key> [--config '{…}']`);
+                return EXIT_USAGE;
+            }
+            const work = rest.slice(2);
+            let config;
+            if (sub === "config") {
+                const raw = takeFlag(work, "--config") ?? work[0];
+                if (!raw) {
+                    console.error("Usage: frontpage extensions config <key> --config '{…json…}'");
+                    return EXIT_USAGE;
+                }
+                try {
+                    config = JSON.parse(raw);
+                }
+                catch {
+                    console.error("--config must be valid JSON");
+                    return EXIT_USAGE;
+                }
+            }
+            const action = sub === "config" ? "set_config" : sub;
+            const data = await v1Post(`/api/v1/sites/${encodeURIComponent(slug)}/extensions/${encodeURIComponent(key)}`, { action, config });
+            console.log(JSON.stringify(data, null, 2));
+            return EXIT_OK;
+        }
+        console.error("Usage: frontpage extensions [list|enable|disable|config] …");
+        return EXIT_USAGE;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/help.d.ts

@@ -0,0 +1 @@
+export declare function runHelp(args: string[]): number;

package/dist/commands/help.js

@@ -0,0 +1,27 @@
+import { COMMANDS, TOPICS, findCommand } from "../registry.js";
+export function runHelp(args) {
+    const topic = args[0]?.trim();
+    if (!topic) {
+        console.log("Frontpage CLI\n");
+        console.log("Usage: frontpage <command> [options]\n");
+        console.log("Commands:");
+        for (const c of COMMANDS) {
+            console.log(`  ${c.name.padEnd(10)} ${c.summary}`);
+        }
+        console.log("\nTopics: frontpage help auth | frontpage help exit-codes");
+        return 0;
+    }
+    if (TOPICS[topic]) {
+        console.log(TOPICS[topic]);
+        return 0;
+    }
+    const cmd = findCommand(topic);
+    if (cmd) {
+        console.log(`${cmd.name} — ${cmd.summary}`);
+        if (cmd.usage)
+            console.log(`Usage: ${cmd.usage}`);
+        return 0;
+    }
+    console.error(`Unknown help topic: ${topic}`);
+    return 2;
+}

package/dist/commands/history.d.ts

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

package/dist/commands/history.js

@@ -0,0 +1,49 @@
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, EXIT_USAGE, exitCodeForError, v1Get } from "../http/client.js";
+export async function runHistory(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        let limit = "20";
+        let page = "1";
+        for (let i = 0; i < rest.length; i++) {
+            const a = rest[i];
+            if (a === "--limit" || a === "-n") {
+                limit = rest[++i] ?? limit;
+                continue;
+            }
+            if (a.startsWith("--limit=")) {
+                limit = a.slice("--limit=".length);
+                continue;
+            }
+            if (a === "--page") {
+                page = rest[++i] ?? page;
+                continue;
+            }
+            if (a.startsWith("--page=")) {
+                page = a.slice("--page=".length);
+                continue;
+            }
+            if (a === "--help" || a === "-h") {
+                console.error("Usage: frontpage history [--limit N] [--page N] [--site <slug>]");
+                return EXIT_USAGE;
+            }
+        }
+        const qs = new URLSearchParams({ limit, page });
+        const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/history?${qs}`);
+        for (const c of data.commits) {
+            const mark = data.stagingCommit === c.sha ? "S" : data.productionCommit === c.sha ? "P" : " ";
+            const who = c.actorEmail ?? c.actorKind ?? "";
+            console.log(`${mark} ${c.shortSha}  ${c.authorDate.slice(0, 10)}  ${c.subject}${who ? `  (${who})` : ""}`);
+        }
+        if (data.hasMore)
+            console.log(`… more on page ${data.page + 1}`);
+        else if (data.moreBeyondWindow) {
+            console.log(`… end of ${data.windowDays}-day history window`);
+        }
+        return EXIT_OK;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/inbox.d.ts

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

package/dist/commands/inbox.js

@@ -0,0 +1,46 @@
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, EXIT_AUTH, EXIT_UNEXPECTED, exitCodeForError, v1Get, apiBase, CliHttpError, } from "../http/client.js";
+import { getApiKey } from "../auth/keychain.js";
+export async function runInbox(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        let kind = "leads";
+        let format = "json";
+        let markRead = false;
+        for (const a of rest) {
+            if (a === "--csv")
+                format = "csv";
+            else if (a === "--mark-read")
+                markRead = true;
+            else if (!a.startsWith("-"))
+                kind = a;
+        }
+        const qs = new URLSearchParams({ kind, format });
+        if (markRead)
+            qs.set("markRead", "1");
+        const path = `/api/v1/sites/${encodeURIComponent(slug)}/inbox?${qs}`;
+        if (format === "csv") {
+            const key = await getApiKey();
+            if (!key)
+                throw new CliHttpError("Not logged in. Run: frontpage login", EXIT_AUTH, 401);
+            const res = await fetch(`${apiBase()}${path}`, {
+                headers: { Authorization: `Bearer ${key}`, Accept: "text/csv" },
+            });
+            const text = await res.text();
+            if (!res.ok) {
+                throw new CliHttpError(`Request failed (${res.status})`, EXIT_UNEXPECTED, res.status);
+            }
+            process.stdout.write(text);
+            if (!text.endsWith("\n"))
+                process.stdout.write("\n");
+            return EXIT_OK;
+        }
+        const data = await v1Get(path);
+        console.log(JSON.stringify(data, null, 2));
+        return EXIT_OK;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/login.d.ts

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

package/dist/commands/login.js

@@ -0,0 +1,38 @@
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { setApiKey, maskKey } from "../auth/keychain.js";
+import { EXIT_OK, EXIT_USAGE, v1Get } from "../http/client.js";
+export async function runLogin(args) {
+    let secret = args[0]?.trim();
+    if (!secret) {
+        const rl = createInterface({ input, output });
+        try {
+            secret = (await rl.question("Paste your Frontpage API key: ")).trim();
+        }
+        finally {
+            rl.close();
+        }
+    }
+    if (!secret) {
+        console.error("No API key provided.");
+        return EXIT_USAGE;
+    }
+    if (!secret.startsWith("fp_live_")) {
+        console.error("Key should start with fp_live_. Create one in Developers (profile menu).");
+        return EXIT_USAGE;
+    }
+    await setApiKey(secret);
+    // Verify against the API (uses FRONTPAGE_API_KEY if set, else keychain — we just wrote keychain).
+    process.env.FRONTPAGE_API_KEY = secret;
+    try {
+        const me = await v1Get("/api/v1/me");
+        console.log(`Logged in as ${me.email ?? me.userId}`);
+        console.log(`Saved key ${maskKey(secret)}`);
+        return EXIT_OK;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        console.error("Key was saved, but /api/v1/me failed. Check PUBLIC_CLI_ENABLED and the key.");
+        return 5;
+    }
+}

package/dist/commands/logout.d.ts

@@ -0,0 +1 @@
+export declare function runLogout(): Promise<number>;

package/dist/commands/logout.js

@@ -0,0 +1,7 @@
+import { clearApiKey } from "../auth/keychain.js";
+import { EXIT_OK } from "../http/client.js";
+export async function runLogout() {
+    await clearApiKey();
+    console.log("Logged out (saved API key removed).");
+    return EXIT_OK;
+}

package/dist/commands/ls.d.ts

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

package/dist/commands/ls.js

@@ -0,0 +1,19 @@
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, exitCodeForError, v1Get } from "../http/client.js";
+export async function runLs(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        const prefix = rest[0];
+        const q = prefix ? `?prefix=${encodeURIComponent(prefix)}` : "";
+        const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/files${q}`);
+        for (const f of data.files) {
+            console.log(`${String(f.bytes).padStart(10)}  ${f.path}`);
+        }
+        console.error(`# ${data.files.length} file(s) · ${data.slug}${data.baseCommitSha ? ` @ ${data.baseCommitSha.slice(0, 7)}` : ""}`);
+        return EXIT_OK;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/media.d.ts

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

package/dist/commands/media.js

@@ -0,0 +1,44 @@
+import { readFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, EXIT_USAGE, exitCodeForError, v1Get, v1PostMultipart } from "../http/client.js";
+export async function runMedia(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        const sub = rest[0] ?? "list";
+        if (sub === "list" || sub === "ls") {
+            const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/media`);
+            for (const a of data.assets) {
+                console.log(`${a.sitePath.padEnd(48)}  ${String(a.sizeBytes).padStart(8)}  ${a.name}`);
+            }
+            console.log(`(${data.count} assets)`);
+            return EXIT_OK;
+        }
+        if (sub === "upload") {
+            const filePath = rest[1];
+            if (!filePath) {
+                console.error("Usage: frontpage media upload <file> [--site <slug>]");
+                return EXIT_USAGE;
+            }
+            const bytes = await readFile(filePath);
+            const form = new FormData();
+            form.append("file", new Blob([Uint8Array.from(bytes)]), basename(filePath));
+            const data = await v1PostMultipart(`/api/v1/sites/${encodeURIComponent(slug)}/media`, form);
+            if (data.kind === "text") {
+                console.log(`Inline text (${data.filename}): ${data.sizeBytes ?? 0} bytes — not stored.`);
+            }
+            else {
+                console.log(data.url ?? data.key ?? JSON.stringify(data));
+                if (data.key)
+                    console.log(`sitePath: /__media/${data.key}`);
+            }
+            return EXIT_OK;
+        }
+        console.error("Usage: frontpage media list|upload <file> [--site <slug>]");
+        return EXIT_USAGE;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/modules.d.ts

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

package/dist/commands/modules.js

@@ -0,0 +1,56 @@
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, EXIT_USAGE, exitCodeForError, v1Get, v1Post } from "../http/client.js";
+function takeFlag(rest, name) {
+    const i = rest.indexOf(name);
+    if (i === -1)
+        return undefined;
+    const v = rest[i + 1];
+    rest.splice(i, 2);
+    return v;
+}
+export async function runModules(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        const sub = rest[0];
+        if (!sub || sub === "list" || sub === "ls") {
+            const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/modules`);
+            for (const m of data.modules) {
+                console.log(`${m.key.padEnd(20)}  ${String(m.status).padEnd(12)}  ${m.name}`);
+            }
+            return EXIT_OK;
+        }
+        if (sub === "enable" || sub === "disable" || sub === "archive" || sub === "config") {
+            const key = rest[1];
+            if (!key) {
+                console.error(`Usage: frontpage modules ${sub} <key> [--instance <id>] [--config '{…}']`);
+                return EXIT_USAGE;
+            }
+            const work = rest.slice(2);
+            const instanceId = takeFlag(work, "--instance");
+            let config;
+            if (sub === "config") {
+                const raw = takeFlag(work, "--config") ?? work[0];
+                if (!raw) {
+                    console.error("Usage: frontpage modules config <key> --config '{…json…}'");
+                    return EXIT_USAGE;
+                }
+                try {
+                    config = JSON.parse(raw);
+                }
+                catch {
+                    console.error("--config must be valid JSON");
+                    return EXIT_USAGE;
+                }
+            }
+            const data = await v1Post(`/api/v1/sites/${encodeURIComponent(slug)}/modules/${encodeURIComponent(key)}`, { action: sub, config, instanceId });
+            console.log(JSON.stringify(data, null, 2));
+            return EXIT_OK;
+        }
+        console.error("Usage: frontpage modules [list|enable|disable|archive|config] …");
+        return EXIT_USAGE;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/open.d.ts

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

package/dist/commands/open.js

@@ -0,0 +1,28 @@
+import { spawn } from "node:child_process";
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, EXIT_USAGE, exitCodeForError } from "../http/client.js";
+export async function runOpen(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        const prod = rest.includes("--prod") || args.includes("--prod");
+        const url = prod
+            ? `https://${slug}.frontpage.host/` // staging subdomain always; custom domain is gateway-resolved
+            : `https://${slug}.frontpage.host/`;
+        // Both staging editing and public subdomain use *.frontpage.host; --prod is reserved
+        // for a future production custom-domain lookup. For Phase 1 open the site subdomain.
+        void prod;
+        const opener = process.platform === "darwin" ? "open" : process.platform === "win32" ? "cmd" : "xdg-open";
+        const openerArgs = process.platform === "win32" ? ["/c", "start", "", url] : [url];
+        spawn(opener, openerArgs, { detached: true, stdio: "ignore" }).unref();
+        console.log(url);
+        return EXIT_OK;
+    }
+    catch (err) {
+        if (err instanceof Error && err.message.includes("Usage")) {
+            console.error("Usage: frontpage open [--site <slug>] [--prod]");
+            return EXIT_USAGE;
+        }
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/pages.d.ts

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

package/dist/commands/pages.js

@@ -0,0 +1,16 @@
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, exitCodeForError, v1Get } from "../http/client.js";
+export async function runPages(args) {
+    try {
+        const { slug } = await resolveSlug(args);
+        const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/pages`);
+        for (const p of data.pages) {
+            console.log(`${p.path.padEnd(40)}  ${p.title}`);
+        }
+        return EXIT_OK;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/prompt.d.ts

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

package/dist/commands/prompt.js

@@ -0,0 +1,39 @@
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, EXIT_USAGE, exitCodeForError, v1Post } from "../http/client.js";
+export async function runPrompt(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        let currentPath = "/";
+        const promptParts = [];
+        for (let i = 0; i < rest.length; i++) {
+            const a = rest[i];
+            if (a === "--path") {
+                currentPath = rest[++i] ?? "/";
+                continue;
+            }
+            if (a.startsWith("--path=")) {
+                currentPath = a.slice("--path=".length) || "/";
+                continue;
+            }
+            promptParts.push(a);
+        }
+        const prompt = promptParts.join(" ").trim();
+        if (!prompt) {
+            console.error('Usage: frontpage prompt "..." [--site <slug>] [--path /page]');
+            return EXIT_USAGE;
+        }
+        if (!currentPath.startsWith("/")) {
+            console.error("currentPath must start with /");
+            return EXIT_USAGE;
+        }
+        const data = await v1Post(`/api/v1/sites/${encodeURIComponent(slug)}/agent-runs`, { prompt, currentPath });
+        console.log(data.runId);
+        if (data.coalesced)
+            console.error("(coalesced with an identical queued run)");
+        return EXIT_OK;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/publish.d.ts

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

package/dist/commands/publish.js

@@ -0,0 +1,28 @@
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, exitCodeForError, v1Delete, v1Post } from "../http/client.js";
+export async function runPublish(args) {
+    try {
+        const { slug } = await resolveSlug(args);
+        const data = await v1Post(`/api/v1/sites/${encodeURIComponent(slug)}/publish`);
+        console.log(`Published ${slug}`);
+        if (data.productionUrl)
+            console.log(data.productionUrl);
+        return EXIT_OK;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}
+export async function runUnpublish(args) {
+    try {
+        const { slug } = await resolveSlug(args);
+        await v1Delete(`/api/v1/sites/${encodeURIComponent(slug)}/publish`);
+        console.log(`Unpublished ${slug}`);
+        return EXIT_OK;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/pull.d.ts

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

package/dist/commands/pull.js

@@ -0,0 +1,60 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname, resolve, sep } from "node:path";
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, EXIT_UNEXPECTED, exitCodeForError, v1Get } from "../http/client.js";
+import { readState, writeState } from "../state/frontpage-state.js";
+/** Reject absolute / traversal paths before writing into cwd (defense in depth). */
+function assertSafePullPath(repoPath, cwd) {
+    if (!repoPath ||
+        repoPath.startsWith("/") ||
+        repoPath.includes("..") ||
+        repoPath.includes("\\") ||
+        repoPath.includes("\0")) {
+        throw new Error(`Refusing unsafe pull path: ${repoPath}`);
+    }
+    const abs = resolve(cwd, repoPath);
+    const root = resolve(cwd) + sep;
+    if (abs !== resolve(cwd) && !abs.startsWith(root)) {
+        throw new Error(`Refusing pull path outside working directory: ${repoPath}`);
+    }
+    return abs;
+}
+export async function runPull(args) {
+    try {
+        const { slug } = await resolveSlug(args);
+        const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/pull`);
+        const cwd = process.cwd();
+        let written = 0;
+        for (const file of data.files) {
+            let abs;
+            try {
+                abs = assertSafePullPath(file.path, cwd);
+            }
+            catch (err) {
+                console.error(err instanceof Error ? err.message : String(err));
+                return EXIT_UNEXPECTED;
+            }
+            await mkdir(dirname(abs), { recursive: true });
+            if (file.encoding === "base64") {
+                await writeFile(abs, Buffer.from(file.content, "base64"));
+            }
+            else {
+                await writeFile(abs, file.content, "utf8");
+            }
+            written++;
+        }
+        const prev = await readState(cwd);
+        await writeState({ ...prev, slug: data.slug, baseCommitSha: data.baseCommitSha ?? undefined }, cwd);
+        console.log(`Pulled ${written} file(s) for ${data.slug}`);
+        if (data.baseCommitSha)
+            console.log(`baseCommitSha: ${data.baseCommitSha}`);
+        if (data.truncated)
+            console.log("Warning: pull truncated (file or size cap). Re-run or narrow the tree.");
+        console.log("Wrote .frontpage/state.json");
+        return EXIT_OK;
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}

package/dist/commands/push.d.ts

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