frontpage-host 0.1.19 → 0.1.21

package/AGENTS.md

@@ -128,7 +128,7 @@ Sites are Astro 6 + Tailwind v4. More detail: `frontpage help site-building` or
 - Generated images: `frontpage images generate --prompt "…"` `[--count N]` — one prompt, 1–4 variations of that same picture. Prints `sitePath:` first. Counts against AI $ and storage. Flag-off environments return 404 (`Image generation is not enabled.`). Do not call xAI / Imagine yourself.
 - Analytics: bare `frontpage analytics` = dashboard; also `summary|query|funnel|timeseries|compare|sql` for structured reads (SQL is guard + RLS site-scoped).
 - People CRM: `frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export`. Site-scoped person graph (email or phone). Inbox stays the raw ledger. Hide is not forget. List export is CSV (not a one-person legal dump). Full guide: https://frontpage.host/developers/people
-- Store catalog: `frontpage shop items|variants|settings|orders|payments`. Integer cents only (`$49.99` is `4999`). Stock `--add` / `--remove` become signed delta (`added 5` / `removed 5` / `set to 20` / `stockNow`). Connect stays `frontpage modules shop|payments connect`. Square `ordering` is a different module. Full guide: https://frontpage.host/developers/shop
+- Store catalog: `frontpage shop items|variants|categories|settings|orders|payments|connect|status|disconnect`. Integer cents only (`$49.99` is `4999`). Stock `--add` / `--remove` become signed delta (`added 5` / `removed 5` / `set to 20` / `stockNow`). Create a category before assigning it (`categories create hats --label Hats`, then `items create … --categories hats`). `frontpage shop connect [--no-open]` opens Frontpage then Stripe (admin key; finish logged-in in the browser), then `status`. Disconnect keeps the shared Stripe account on payments. `frontpage modules shop|payments connect` still works. Square `ordering` is a different module. Full guide: https://frontpage.host/developers/shop
 
 ## Agent prompt loop
 

package/dist/commands/shop.js

@@ -2,9 +2,11 @@ import { readFile } from "node:fs/promises";
 import { resolveSlug } from "../site.js";
 import { CliHttpError, EXIT_OK, EXIT_USAGE, v1Get, v1Patch, v1Post, v1Put, } from "../http/client.js";
 import { assertNoUnknownFlags, hasFlag, takeFlag } from "../argv.js";
-import { emitErr, emitOk, emitUsage, isJson } from "../runtime.js";
+import { emitErr, emitOk, emitUsage, isJson, requireYesOrTty } from "../runtime.js";
+import { openBrowser, resolveOpenUrl } from "../modules/oauth.js";
 import { SHOP_ID_RE, VARIANT_ID_RE } from "./shop-ids.js";
-const USAGE = "Usage: frontpage shop items|variants|settings|orders|payments … [--site <slug>] [--json]";
+const USAGE = "Usage: frontpage shop items|variants|categories|settings|orders|payments|connect|status|disconnect … [--site <slug>] [--json]";
+const CONNECT_FINISH = "Open the Frontpage URL while logged in, finish Stripe in the browser, then re-run status. This CLI cannot complete OAuth.";
 const CENTS_HINT = "$49.99 is 4999";
 function takeAll(work, name) {
     const out = [];
@@ -147,6 +149,7 @@ function printItem(row) {
         prices.length ? prices.join(",") : "",
         stocks.length ? `stock ${stocks.join(",")}` : "",
         row.active === false ? "inactive" : "active",
+        row.categories?.length ? row.categories.join(",") : "",
         row.archivedAt ? "archived" : "",
     ].filter(Boolean);
     console.log(`${row.itemId}  ${row.title ?? ""}  ${bits.join("  ·  ")}`);
@@ -168,9 +171,15 @@ export async function runShop(args) {
             if (!sub || sub === "list" || sub.startsWith("-")) {
                 const listWork = sub === "list" ? work : rest.slice(1);
                 const archived = hasFlag(listWork, "--archived");
+                const category = takeFlag(listWork, "--category");
                 assertNoUnknownFlags(listWork, "shop");
-                const qs = archived ? "?archived=1" : "";
-                const data = await v1Get(`${base}/items${qs}`);
+                const qs = new URLSearchParams();
+                if (archived)
+                    qs.set("archived", "1");
+                if (category)
+                    qs.set("category", category);
+                const suffix = qs.toString() ? `?${qs.toString()}` : "";
+                const data = await v1Get(`${base}/items${suffix}`);
                 if (isJson()) {
                     emitOk("shop", data);
                     return EXIT_OK;
@@ -214,6 +223,7 @@ export async function runShop(args) {
                 const minCents = parseCentsFlag(takeFlag(work, "--min-cents"), "minCents");
                 const requiresShipping = parseBoolFlag(takeFlag(work, "--requires-shipping"), "requiresShipping");
                 const optionNames = parseCsv(takeFlag(work, "--option-names"));
+                const categories = parseCsv(takeFlag(work, "--categories"));
                 const priceCents = parseCentsFlag(takeFlag(work, "--price-cents"), "priceCents");
                 const discountCents = parseCentsFlag(takeFlag(work, "--discount-cents"), "discountPriceCents");
                 const shippingCents = parseCentsFlag(takeFlag(work, "--shipping-cents"), "shippingCents");
@@ -239,6 +249,8 @@ export async function runShop(args) {
                     body.requiresShipping = requiresShipping;
                 if (optionNames)
                     body.optionNames = optionNames;
+                if (categories)
+                    body.categories = categories;
                 if (images.length)
                     body.images = images;
                 if (body.checkout == null)
@@ -278,6 +290,7 @@ export async function runShop(args) {
                 const minCents = parseCentsFlag(takeFlag(work, "--min-cents"), "minCents");
                 const requiresShipping = parseBoolFlag(takeFlag(work, "--requires-shipping"), "requiresShipping");
                 const active = parseBoolFlag(takeFlag(work, "--active"), "active");
+                const categories = parseCsv(takeFlag(work, "--categories"));
                 const images = parseUrls(work);
                 assertNoUnknownFlags(work, "shop");
                 const body = {};
@@ -295,6 +308,8 @@ export async function runShop(args) {
                     body.requiresShipping = requiresShipping;
                 if (active !== undefined)
                     body.active = active;
+                if (categories)
+                    body.categories = categories;
                 if (images.length)
                     body.images = images;
                 if (Object.keys(body).length === 0) {
@@ -474,6 +489,77 @@ export async function runShop(args) {
             }
             return emitUsage("shop", USAGE);
         }
+        if (group === "categories") {
+            const sub = rest[1];
+            const work = rest.slice(2);
+            if (!sub || sub === "list" || sub.startsWith("-")) {
+                const listWork = sub === "list" ? work : rest.slice(1);
+                const archived = hasFlag(listWork, "--archived");
+                assertNoUnknownFlags(listWork, "shop");
+                const qs = archived ? "?archived=1" : "";
+                const data = await v1Get(`${base}/categories${qs}`);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                const rows = data.categories ?? [];
+                if (rows.length === 0) {
+                    console.log("No categories.");
+                    return EXIT_OK;
+                }
+                for (const row of rows) {
+                    console.log(`${row.slug}  ${row.label}${row.archivedAt ? "  archived" : ""}`);
+                }
+                return EXIT_OK;
+            }
+            if (sub === "create") {
+                const slug = takeFlag(work, "--slug") ?? takeFlag(work, "--id") ?? work.find((a) => !a.startsWith("-"));
+                if (slug && work.includes(slug))
+                    work.splice(work.indexOf(slug), 1);
+                const label = takeFlag(work, "--label") ?? takeFlag(work, "--title");
+                assertNoUnknownFlags(work, "shop");
+                if (!slug || !SHOP_ID_RE.test(slug) || !label) {
+                    throw new CliHttpError("Usage: frontpage shop categories create hats --label Hats", EXIT_USAGE, 0, "bad_request");
+                }
+                const data = await v1Post(`${base}/categories`, {
+                    slug,
+                    label,
+                });
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                console.log(`${data.category.slug}  ${data.category.label}`);
+                return EXIT_OK;
+            }
+            if (sub === "rename") {
+                const slug = requireShopId(work, "Category slug");
+                const label = takeFlag(work, "--label") ?? takeFlag(work, "--title");
+                assertNoUnknownFlags(work, "shop");
+                if (!label) {
+                    throw new CliHttpError("Usage: frontpage shop categories rename hats --label Hats", EXIT_USAGE, 0, "bad_request");
+                }
+                const data = await v1Patch(`${base}/categories/${encodeURIComponent(slug)}`, { label });
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                console.log(`${data.category.slug}  ${data.category.label}`);
+                return EXIT_OK;
+            }
+            if (sub === "archive") {
+                const slug = requireShopId(work, "Category slug");
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Post(`${base}/categories/${encodeURIComponent(slug)}/archive`, {});
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                console.log(`${data.category.slug}  archived`);
+                return EXIT_OK;
+            }
+            return emitUsage("shop", USAGE);
+        }
         if (group === "settings") {
             const sub = rest[1] ?? "get";
             const work = rest.slice(2);
@@ -553,6 +639,61 @@ export async function runShop(args) {
             }
             return emitUsage("shop", USAGE);
         }
+        if (group === "connect") {
+            const work = rest.slice(1);
+            const noOpen = hasFlag(work, "--no-open");
+            assertNoUnknownFlags(work, "shop");
+            const data = await v1Post(`${base}/connect`, { action: "connect" });
+            const already = data.alreadyConnected === true;
+            if (isJson()) {
+                emitOk("shop", data);
+            }
+            else {
+                const url = resolveOpenUrl(data.connectUrl);
+                if (url)
+                    console.log(url);
+                console.log(typeof data.message === "string" ? data.message : already ? "Already connected." : CONNECT_FINISH);
+                if (typeof data.warning === "string")
+                    console.log(data.warning);
+            }
+            const url = resolveOpenUrl(data.connectUrl);
+            if (url && !noOpen && !already)
+                openBrowser(url);
+            return EXIT_OK;
+        }
+        if (group === "status") {
+            const work = rest.slice(1);
+            assertNoUnknownFlags(work, "shop");
+            const data = await v1Get(`${base}/connect`);
+            if (isJson()) {
+                emitOk("shop", data);
+                return EXIT_OK;
+            }
+            const connection = (data.connection ?? {});
+            const display = connection.display ?? {};
+            console.log(`connected  ${connection.ready ? "yes" : "no"}`);
+            console.log(`charges    ${display.chargesEnabled == null ? "—" : display.chargesEnabled ? "yes" : "no"}`);
+            console.log(`account    ${display.accountPresent ? "present" : "none"}`);
+            if (typeof data.sharedStripe === "string")
+                console.log(`note       ${data.sharedStripe}`);
+            if (typeof data.connectUrl === "string")
+                console.log(`connect    ${data.connectUrl}`);
+            return EXIT_OK;
+        }
+        if (group === "disconnect") {
+            const work = rest.slice(1);
+            assertNoUnknownFlags(work, "shop");
+            const refuse = requireYesOrTty("disconnect the store (shared Stripe account with payments)");
+            if (refuse)
+                return emitUsage("shop", refuse);
+            const data = await v1Post(`${base}/connect`, { action: "disconnect" });
+            if (isJson()) {
+                emitOk("shop", data);
+                return EXIT_OK;
+            }
+            console.log(typeof data.message === "string" ? data.message : "Disconnected.");
+            return EXIT_OK;
+        }
         if (group === "orders" || group === "payments") {
             const noun = group;
             const sub = rest[1] ?? "list";

package/dist/registry.js

@@ -442,25 +442,30 @@ export const COMMANDS = [
     {
         name: "shop",
         summary: "Store catalog: items, variants, stock, and store settings (not Square, not inbox)",
-        usage: "frontpage shop items|variants|settings|orders|payments … [--site <slug>] [--json]",
+        usage: "frontpage shop items|variants|categories|settings|orders|payments|connect|status|disconnect … [--site <slug>] [--json]",
         topics: ["content"],
         examples: [
             "frontpage shop items list",
-            "frontpage shop items create camp-hat --title \"Camp hat\" --price-cents 4999 --checkout cart --requires-shipping true --stock 20",
+            "frontpage shop categories create hats --label Hats",
+            "frontpage shop items create camp-hat --title \"Camp hat\" --price-cents 4999 --checkout cart --categories hats --stock 20",
+            "frontpage shop items list --category hats",
             "frontpage shop variants add camp-hat --id m --option Size=M --price-cents 4999 --stock 8",
             "frontpage shop items stock camp-hat --variant m --add 5",
             "frontpage shop items stock camp-hat --variant m --remove 5",
             "frontpage shop items stock camp-hat --variant m --set 20",
             "frontpage shop settings set-fulfillment --mode pickup",
             "frontpage shop settings set-currency --currency usd",
+            "frontpage shop connect --no-open",
+            "frontpage shop status",
         ],
         flags: [
             "Integer cents only. $49.99 is 4999. Do not send 49.99 or a dollar string.",
             "--add / --remove become signed delta. 5 adds 5. --remove 5 removes 5. Result copy is added 5 / removed 5 / set to 20 / stockNow.",
             "Pass either --add, --remove, or --set. Never two together. --set unlimited returns counted stock to unlimited.",
-            "items: list|get|create|update|archive|activate [--off] | images --urls … | stock [--variant m] --add|--remove|--set",
+            "items: list|get|create|update|archive|activate [--off] | images --urls … | stock [--variant m] --add|--remove|--set. list --category hats. create/update --categories hats,summer",
+            "categories: list|create|rename|archive. Create the category first. Assigning an unknown slug fails.",
             "variants: add|update|archive <itemId> --id m --price-cents … [--option Size=M] [--stock]",
-            "settings: get|set-fulfillment|set-currency|set-checkout-fee. Connect stays frontpage modules shop|payments connect.",
+            "settings: get|set-fulfillment|set-currency|set-checkout-fee. Connect: frontpage shop connect|status|disconnect. connect opens Frontpage then Stripe; --no-open for CI. disconnect keeps the shared Stripe account on payments.",
             "orders / payments list|get read the same ledgers as frontpage inbox orders|payments",
             "Unknown leftover flags fail closed (exit 2)",
         ],
@@ -722,7 +727,7 @@ export const TOPICS = {
   frontpage inbox [leads|subscribers|orders|google_reviews|…] [--mark-read] [--csv]
   frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export
   # People CRM guide: https://frontpage.host/developers/people
-  frontpage shop items|variants|settings|orders|payments
+  frontpage shop items|variants|categories|settings|orders|payments|connect|status|disconnect
   # Store catalog: https://frontpage.host/developers/shop
   # Integer cents only. $49.99 is 4999. stock --add/--remove are signed delta.
   frontpage mail settings|email|template|series|send|sends|enrolments|suppress

package/llms.txt

@@ -17,7 +17,7 @@
 - SEO get: frontpage seo get [/path|--path /path]; search path filter: [path|--path <path>]; open [/path|--path /path]
 - Redirects: frontpage redirects list|set|rm — HTTP 301/308, instant, not a file; revert does not undo; do not fake with Astro.redirect / meta refresh
 - People CRM: frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export. Site-scoped person graph (email or phone). Inbox stays the raw ledger. Hide is not forget. List export is CSV. Unknown leftover flags fail closed. Guide: https://frontpage.host/developers/people
-- Store catalog: frontpage shop items|variants|settings|orders|payments. Integer cents only ($49.99 is 4999). stock --add/--remove are signed delta (added 5 / removed 5 / set to 20 / stockNow). Connect stays frontpage modules shop|payments connect. Not Square ordering. Guide: https://frontpage.host/developers/shop
+- Store catalog: frontpage shop items|variants|categories|settings|orders|payments|connect|status|disconnect. Integer cents only ($49.99 is 4999). stock --add/--remove are signed delta (added 5 / removed 5 / set to 20 / stockNow). Create a category before assigning it. frontpage shop connect [--no-open] opens Frontpage then Stripe; disconnect keeps the shared account on payments. frontpage modules shop|payments connect still works. Not Square ordering. Guide: https://frontpage.host/developers/shop
 - Analytics funnel: --steps JSON array or comma paths (/, /pricing); bad JSON → Invalid JSON for --steps
 - Modules: unknown key errors list Known: …; mailing list module key is signups (not subscribe)
 - Errors: --json API envelopes include requestId when the server returned one; local validation omits requestId/httpStatus; runs wait failed/canceled → ok:false + run.error (exit 2); deploy wait = agent idle + tip compile ready (fail-closed / compile timeout → exit 2); push --wait and publish --wait wait for GET /deploy ready

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontpage-host",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {