frontpage-host 0.1.19 → 0.1.20

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`. 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`). Connect stays `frontpage modules shop|payments connect`. Square `ordering` is a different module. Full guide: https://frontpage.host/developers/shop
 
 ## Agent prompt loop
 

package/dist/commands/shop.js

@@ -4,7 +4,7 @@ import { CliHttpError, EXIT_OK, EXIT_USAGE, v1Get, v1Patch, v1Post, v1Put, } fro
 import { assertNoUnknownFlags, hasFlag, takeFlag } from "../argv.js";
 import { emitErr, emitOk, emitUsage, isJson } from "../runtime.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 … [--site <slug>] [--json]";
 const CENTS_HINT = "$49.99 is 4999";
 function takeAll(work, name) {
     const out = [];
@@ -147,6 +147,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 +169,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 +221,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 +247,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 +288,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 +306,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 +487,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);

package/dist/registry.js

@@ -442,11 +442,13 @@ 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 … [--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",
@@ -458,7 +460,8 @@ export const COMMANDS = [
             "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.",
             "orders / payments list|get read the same ledgers as frontpage inbox orders|payments",
@@ -722,7 +725,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
   # 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. 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. Connect stays frontpage modules shop|payments connect. 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.20",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {