frontpage-host 0.1.20 → 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|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
+- 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|categories|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 = [];
@@ -637,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,7 +442,7 @@ export const COMMANDS = [
     {
         name: "shop",
         summary: "Store catalog: items, variants, stock, and store settings (not Square, not inbox)",
-        usage: "frontpage shop items|variants|categories|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",
@@ -455,6 +455,8 @@ export const COMMANDS = [
             "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.",
@@ -463,7 +465,7 @@ export const COMMANDS = [
             "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)",
         ],
@@ -725,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|categories|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|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
+- 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.20",
+  "version": "0.1.21",
   "description": "Frontpage CLI — manage your site from the terminal",
   "type": "module",
   "bin": {