frontpage-host 0.1.28 → 0.2.0

package/dist/commands/shop.js

@@ -3,10 +3,8 @@ 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, 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 store items|variants|categories|settings|orders|payments|connect|status|disconnect|import … [--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 USAGE = "Usage: frontpage store items|variants|categories|settings|orders|import … [--site <slug>] [--json]";
 const CENTS_HINT = "$49.99 is 4999";
 function takeAll(work, name) {
     const out = [];
@@ -142,7 +140,7 @@ async function readJsonFile(path) {
 function printItem(row) {
     const live = (row.variants ?? []).filter((v) => !v.archivedAt);
     const prices = live.map((v) => v.discountPriceCents != null ? `${v.discountPriceCents}/${v.priceCents}` : String(v.priceCents));
-    const stocks = live.map((v) => (v.stock == null ? "unlimited" : String(v.stock)));
+    const stocks = live.map((v) => v.stock == null ? "unlimited" : String(v.stock));
     const bits = [
         row.checkout ?? "",
         row.amount ?? "",
@@ -218,7 +216,6 @@ export async function runShop(args) {
                     work.splice(work.indexOf(itemId), 1);
                 const title = takeFlag(work, "--title");
                 const description = takeFlag(work, "--description");
-                const checkout = takeFlag(work, "--checkout");
                 const amount = takeFlag(work, "--amount");
                 const minCents = parseCentsFlag(takeFlag(work, "--min-cents"), "minCents");
                 const requiresShipping = parseBoolFlag(takeFlag(work, "--requires-shipping"), "requiresShipping");
@@ -238,8 +235,6 @@ export async function runShop(args) {
                     body.title = title;
                 if (description !== undefined)
                     body.description = description;
-                if (checkout)
-                    body.checkout = checkout;
                 if (amount)
                     body.amount = amount;
                 if (minCents !== undefined)
@@ -254,13 +249,14 @@ export async function runShop(args) {
                     body.images = images;
                 if (body.amount == null)
                     body.amount = "fixed";
-                if (!Array.isArray(body.variants) && priceCents !== undefined) {
+                const initialPrice = priceCents ?? (body.amount === "open" && typeof body.minCents === "number" ? body.minCents : undefined);
+                if (!Array.isArray(body.variants) && initialPrice !== undefined) {
                     const stock = stockRaw === undefined ? undefined : stockRaw === "unlimited" ? null : parseCountFlag(stockRaw, "stock");
                     body.variants = [
                         {
                             variantId: variantId ?? "default",
                             ...(options ? { options } : {}),
-                            priceCents,
+                            priceCents: initialPrice,
                             ...(discountCents !== undefined ? { discountPriceCents: discountCents } : {}),
                             ...(stock !== undefined ? { stock } : {}),
                         },
@@ -281,7 +277,6 @@ export async function runShop(args) {
                 const itemId = requireShopId(work);
                 const title = takeFlag(work, "--title");
                 const description = takeFlag(work, "--description");
-                const checkout = takeFlag(work, "--checkout");
                 const amount = takeFlag(work, "--amount");
                 const minCents = parseCentsFlag(takeFlag(work, "--min-cents"), "minCents");
                 const requiresShipping = parseBoolFlag(takeFlag(work, "--requires-shipping"), "requiresShipping");
@@ -294,8 +289,6 @@ export async function runShop(args) {
                     body.title = title;
                 if (description !== undefined)
                     body.description = description;
-                if (checkout !== undefined)
-                    body.checkout = checkout;
                 if (amount !== undefined)
                     body.amount = amount;
                 if (minCents !== undefined)
@@ -319,10 +312,10 @@ export async function runShop(args) {
                 printItem(data.item);
                 return EXIT_OK;
             }
-            if (sub === "archive") {
+            if (sub === "archive" || sub === "restore") {
                 const itemId = requireShopId(work);
                 assertNoUnknownFlags(work, "store");
-                const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/archive`, {});
+                const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/${sub}`, {});
                 if (isJson()) {
                     emitOk("store", data);
                     return EXIT_OK;
@@ -466,11 +459,11 @@ export async function runShop(args) {
                 printItem(data.item);
                 return EXIT_OK;
             }
-            if (sub === "archive") {
+            if (sub === "archive" || sub === "restore") {
                 const itemId = requireShopId(work, "Item id", { allowIdFlag: false });
                 const variantId = requireVariantId(takeFlag(work, "--id") ?? takeFlag(work, "--variant"));
                 assertNoUnknownFlags(work, "store");
-                const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/variants/${encodeURIComponent(variantId)}/archive`, {});
+                const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/variants/${encodeURIComponent(variantId)}/${sub}`, {});
                 if (isJson()) {
                     emitOk("store", data);
                     return EXIT_OK;
@@ -568,7 +561,9 @@ export async function runShop(args) {
                     fulfill.pickupEnabled ? "pickup" : null,
                     fulfill.shippingEnabled ? "delivery" : null,
                 ].filter(Boolean);
-                const fulfillText = methods.length > 0 ? methods.join("+") : fulfill.shipping ?? "(no fulfillment)";
+                const fulfillText = methods.length > 0
+                    ? methods.join("+")
+                    : (fulfill.shipping ?? "(no fulfillment)");
                 const checkoutText = s.storeCheckout === "instant" ? "pay-now" : "cart";
                 const feeText = fee.enabled ? `service-fee ${fee.cents ?? 0}` : "service-fee off";
                 console.log(`${s.currency ?? "(no currency)"}  ${fulfillText}  ${checkoutText}  ${feeText}`);
@@ -619,39 +614,54 @@ export async function runShop(args) {
                     console.log("Fulfillment saved.");
                 return EXIT_OK;
             }
-            if (sub === "set-currency") {
-                const currency = takeFlag(work, "--currency");
+            if (sub === "set-receipt") {
+                const templateId = takeFlag(work, "--template");
+                const stock = hasFlag(work, "--stock");
                 assertNoUnknownFlags(work, "store");
-                if (!currency) {
-                    throw new CliHttpError("Usage: frontpage store settings set-currency --currency usd (any Stripe presentment code such as usd or jpy)", EXIT_USAGE, 0, "bad_request");
-                }
-                const data = await v1Post(`${base}/settings/currency`, { currency });
+                if ((templateId === undefined) === !stock)
+                    throw new CliHttpError("Use --template <id> or --stock, never both.", EXIT_USAGE, 0, "bad_request");
+                const data = await v1Post(`${base}/settings/receipt`, {
+                    templateId: stock ? "" : templateId,
+                });
                 if (isJson())
                     emitOk("store", data);
                 else
-                    console.log("Currency saved.");
+                    console.log("Order receipt saved. No email was sent.");
                 return EXIT_OK;
             }
-            if (sub === "set-checkout") {
-                const checkout = takeFlag(work, "--mode") ?? takeFlag(work, "--checkout");
+            if (sub === "availability") {
+                const mode = work.shift() ?? "get";
+                if (!["get", "on", "off"].includes(mode))
+                    throw new CliHttpError("Use store settings availability get|on|off.", EXIT_USAGE, 0, "bad_request");
                 assertNoUnknownFlags(work, "store");
-                if (checkout !== "cart" && checkout !== "instant") {
-                    throw new CliHttpError("Usage: frontpage store settings set-checkout --mode cart|instant", EXIT_USAGE, 0, "bad_request");
-                }
-                const data = await v1Post(`${base}/settings/checkout`, { checkout });
+                if (mode !== "get") {
+                    const problem = requireYesOrTty("Change Store availability");
+                    if (problem)
+                        throw new CliHttpError(problem, EXIT_USAGE, 0, "bad_request");
+                }
+                const data = mode === "get"
+                    ? await v1Get(`${base}/settings/availability`)
+                    : await v1Post(`${base}/settings/availability`, {
+                        enabled: mode === "on",
+                        confirm: true,
+                    });
                 if (isJson())
                     emitOk("store", data);
                 else
-                    console.log(checkout === "instant" ? "Checkout is Pay now." : "Checkout is add to cart.");
+                    console.log(JSON.stringify(data, null, 2));
                 return EXIT_OK;
             }
             if (sub === "set-checkout-fee") {
                 const off = hasFlag(work, "--off");
                 const cents = parseCentsFlag(takeFlag(work, "--cents"), "checkoutFeeCents");
+                const mode = takeFlag(work, "--mode");
+                const bps = parseCountFlag(takeFlag(work, "--bps"), "checkoutFeeBps");
                 assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/settings/checkout-fee`, {
                     enabled: off ? false : true,
                     cents,
+                    mode,
+                    bps,
                 });
                 if (isJson())
                     emitOk("store", data);
@@ -661,61 +671,6 @@ export async function runShop(args) {
             }
             return emitUsage("store", USAGE);
         }
-        if (group === "connect") {
-            const work = rest.slice(1);
-            const noOpen = hasFlag(work, "--no-open");
-            assertNoUnknownFlags(work, "store");
-            const data = await v1Post(`${base}/connect`, { action: "connect" });
-            const already = data.alreadyConnected === true;
-            if (isJson()) {
-                emitOk("store", 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, "store");
-            const data = await v1Get(`${base}/connect`);
-            if (isJson()) {
-                emitOk("store", 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, "store");
-            const refuse = requireYesOrTty("disconnect the store (shared Stripe account with payments)");
-            if (refuse)
-                return emitUsage("store", refuse);
-            const data = await v1Post(`${base}/connect`, { action: "disconnect" });
-            if (isJson()) {
-                emitOk("store", data);
-                return EXIT_OK;
-            }
-            console.log(typeof data.message === "string" ? data.message : "Disconnected.");
-            return EXIT_OK;
-        }
         if (group === "import") {
             const work = rest.slice(1);
             assertNoUnknownFlags(work, "store");
@@ -740,7 +695,7 @@ export async function runShop(args) {
             console.log(`${imported.length} imported  ${skipped.length} skipped  ${failed.length} failed`);
             return EXIT_OK;
         }
-        if (group === "orders" || group === "payments") {
+        if (group === "orders") {
             const noun = group;
             const sub = rest[1] ?? "list";
             const work = rest.slice(2);

package/dist/completions/generate.js

@@ -27,7 +27,8 @@ _frontpage_completions() {
     analytics) COMPREPLY=( $(compgen -W "dashboard summary query funnel timeseries compare sql" -- "\${cur}") ) ;;
     people) COMPREPLY=( $(compgen -W "list get add set note rm-note follow-up hide unhide" -- "\${cur}") ) ;;
     routines) COMPREPLY=( $(compgen -W "list get add set pause resume rm run runs" -- "\${cur}") ) ;;
-    store) COMPREPLY=( $(compgen -W "items variants categories settings orders payments connect status disconnect import" -- "\${cur}") ) ;;
+    payments) COMPREPLY=( $(compgen -W "status settings connect availability activity buttons tax invoices recurring customers --file --operation-key --preview-hash --person --email --description --amount-cents --cadence --first-date --time-zone --due-days --no-open --site --json --yes" -- "\${cur}") ) ;;
+    store) COMPREPLY=( $(compgen -W "items variants categories settings orders import" -- "\${cur}") ) ;;
     modules)
       if [[ \${COMP_CWORD} -ge 3 && \${COMP_WORDS[2]} == google_reviews ]]; then
         COMPREPLY=( $(compgen -W "docs request-setup enable disable archive config connect resolve status list-reviews hide show set-stars set-sort set-weight reset-weights write-review-url refresh disconnect" -- "\${cur}") )
@@ -36,7 +37,7 @@ _frontpage_completions() {
       elif [[ \${COMP_CWORD} -ge 3 && (\${COMP_WORDS[2]} == callbar || \${COMP_WORDS[2]} == booking || \${COMP_WORDS[2]} == signups) ]]; then
         COMPREPLY=( $(compgen -W "docs request-setup enable disable archive config get set" -- "\${cur}") )
       elif [[ \${COMP_CWORD} -ge 3 && \${COMP_WORDS[2]} == payments ]]; then
-        COMPREPLY=( $(compgen -W "docs request-setup enable disable archive config status connect disconnect" -- "\${cur}") )
+        COMPREPLY=( $(compgen -W "docs" -- "\${cur}") )
       else
         COMPREPLY=( $(compgen -W "list docs request-setup enable disable archive config callbar forms booking signups payments articles google_reviews" -- "\${cur}") )
       fi
@@ -72,7 +73,8 @@ _frontpage() {
         analytics) _values 'subcommand' dashboard summary query funnel timeseries compare sql ;;
         people) _values 'subcommand' list get add set note rm-note follow-up hide unhide ;;
         routines) _values 'subcommand' list get add set pause resume rm run runs ;;
-        store) _values 'subcommand' items variants categories settings orders payments connect status disconnect import ;;
+        payments) _values 'subcommand' status settings connect availability activity buttons tax invoices recurring customers ;;
+        store) _values 'subcommand' items variants categories settings orders import ;;
         modules)
           if [[ $words[2] == google_reviews ]]; then
             _values 'subcommand' docs request-setup enable disable archive config connect resolve status list-reviews hide show set-stars set-sort set-weight reset-weights write-review-url refresh disconnect
@@ -81,7 +83,7 @@ _frontpage() {
           elif [[ $words[2] == callbar || $words[2] == booking || $words[2] == signups ]]; then
             _values 'subcommand' docs request-setup enable disable archive config get set
           elif [[ $words[2] == payments ]]; then
-            _values 'subcommand' docs request-setup enable disable archive config status connect disconnect
+            _values 'subcommand' docs
           else
             _values 'subcommand' list docs request-setup enable disable archive config callbar forms booking signups payments articles google_reviews
           fi
@@ -110,12 +112,13 @@ export function generateFishCompletion() {
         `complete -c frontpage -n "__fish_seen_subcommand_from analytics" -a "dashboard summary query funnel timeseries compare sql"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from people" -a "list get add set note rm-note follow-up hide unhide"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from routines" -a "list get add set pause resume rm run runs"`,
-        `complete -c frontpage -n "__fish_seen_subcommand_from store" -a "items variants categories settings orders payments connect status disconnect import"`,
+        `complete -c frontpage -n "__fish_seen_subcommand_from payments" -a "status settings connect availability activity buttons tax invoices recurring customers"
+complete -c frontpage -n "__fish_seen_subcommand_from store" -a "items variants categories settings orders import"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from modules" -a "list docs request-setup enable disable archive config callbar forms booking signups payments articles google_reviews"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from modules; and __fish_seen_subcommand_from google_reviews" -a "connect resolve status list-reviews hide show set-stars set-sort set-weight reset-weights write-review-url refresh disconnect"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from modules; and __fish_seen_subcommand_from forms" -a "get set destinations connect-destination remove-destination disconnect-destination attach-destination detach-destination request-destination-setup"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from modules; and __fish_seen_subcommand_from callbar booking signups" -a "get set"`,
-        `complete -c frontpage -n "__fish_seen_subcommand_from modules; and __fish_seen_subcommand_from payments" -a "status connect disconnect"`,
+        `complete -c frontpage -n "__fish_seen_subcommand_from modules; and __fish_seen_subcommand_from payments" -a "docs"`,
         `complete -c frontpage -n "__fish_seen_subcommand_from extensions" -a "list docs enable disable config"`,
         `complete -c frontpage -l site -d "Site subdomain slug"`,
     ];

package/dist/registry.js

@@ -39,7 +39,9 @@ export const COMMANDS = [
         usage: "frontpage login [api-key]",
         topics: ["auth"],
         examples: ['frontpage login', 'frontpage login "$FRONTPAGE_API_KEY"'],
-        flags: ["FRONTPAGE_API_KEY env overrides keychain after login for that process"],
+        flags: [
+            "FRONTPAGE_API_KEY env overrides keychain after login for that process"
+        ],
         seeAlso: ["whoami", "doctor", "logout"],
     },
     {
@@ -68,7 +70,9 @@ export const COMMANDS = [
         usage: "frontpage use <subdomain>",
         topics: ["auth", "sync"],
         examples: ["frontpage use arbiter"],
-        dangers: ["Clears baseCommitSha when switching sites — run pull again before push"],
+        dangers: [
+            "Clears baseCommitSha when switching sites — run pull again before push"
+        ],
         seeAlso: ["link", "pull", "status"],
     },
     {
@@ -200,7 +204,11 @@ export const COMMANDS = [
         summary: "Open the site subdomain in a browser",
         usage: "frontpage open [/path|--path /path] [--site <slug>] [--prod]",
         topics: ["sync"],
-        examples: ["frontpage open", "frontpage open /updates", "frontpage open --path /pricing"],
+        examples: [
+            "frontpage open",
+            "frontpage open /updates",
+            "frontpage open --path /pricing"
+        ],
         flags: [
             "Optional site-relative path appended to https://<slug>.frontpage.host",
             "--prod is a no-op stub today — still opens the *.frontpage.host subdomain",
@@ -337,12 +345,12 @@ export const COMMANDS = [
             "frontpage modules forms get",
             "frontpage modules forms set --instance lead-gen --notify-email hi@example.com",
             "frontpage modules forms set --instance lead-gen --confirm-template <template-id>",
-            "frontpage store connect --no-open",
+            "frontpage payments connect --no-open",
             "frontpage modules docs forms",
             "frontpage modules docs google_reviews",
             "frontpage modules docs signups",
             "frontpage modules list",
-            'frontpage store connect --no-open',
+            "frontpage payments connect --no-open",
             'frontpage modules request-setup google_reviews --reason "You asked for Google reviews — pick your listing so we show the right ones"',
         ],
         flags: [
@@ -350,7 +358,7 @@ export const COMMANDS = [
             "Key-first and verb-first both work: `modules google_reviews enable` = `modules enable google_reviews`",
             "google_reviews extras: connect / resolve / status / list-reviews / hide / show / set-stars / set-sort / set-weight / reset-weights / refresh / disconnect / write-review-url",
             "callbar/forms/booking/signups: typed get / set (same whitelist as `modules config`)",
-            "Store Stripe connect is frontpage store connect. request-setup still lights the editor amber bar.",
+            "Stripe setup is frontpage payments connect. request-setup still lights the editor amber bar.",
             "See https://frontpage.host/developers/modules and /developers/modules/google-reviews",
         ],
         dangers: [
@@ -407,6 +415,26 @@ export const COMMANDS = [
         ],
         seeAlso: ["prompt", "help content", "help site-building"],
     },
+    {
+        name: "customer-inbox",
+        summary: "Manage internal Customer Inbox settings, knowledge and human conversation handling",
+        usage: "frontpage customer-inbox get|put|post <resource> [--file <json>] [--request-key <key>] [--site <slug>] [--json]; export|download <id> --out <new-file>",
+        topics: ["content"],
+        examples: [
+            "frontpage customer-inbox get settings",
+            "frontpage customer-inbox put settings --file ./inbox-settings.json --request-key settings_revision_1",
+            "frontpage customer-inbox get conversations",
+            "frontpage customer-inbox get knowledge"
+        ],
+        flags: [
+            "Internal plans and the site pilot apply",
+            "Writes require a stable --request-key and a JSON file; reuse both on retries",
+            "Human CLI access can guide, take over and reply; website-agent tools have management scope only",
+            "Luna and 10× AI billing are fixed",
+            "Full request examples: CUSTOMER-INBOX.md"
+        ],
+        seeAlso: ["people", "usage"],
+    },
     {
         name: "inbox",
         summary: "List leads / subscribers / orders",
@@ -461,7 +489,7 @@ export const COMMANDS = [
             "frontpage people export",
         ],
         flags: [
-            "Workspace: groups list|get|create|update|archive|restore|preview; stages create|update|reorder|archive|restore; membership get|add|remove|move|stage|advance|override|hold; rules list|get|create|update|enable|pause|archive|validate|preview|runs|retry; attachments create; import preview|start|get|retry; person permission; company get|set; audience preview; overview; sources",
+            "Workspace: groups list|get|create|update|archive|restore|preview; stages create|update|reorder|archive|restore; membership get|add|remove|move|stage|advance|override|hold; rules list|get|create|update|enable|pause|archive|validate|preview|runs|retry; attachments create; import preview|start|get|retry; person permission; audience preview; overview; sources",
             "All workspace operations accept --file JSON or --data JSON. Named flags: --id --label --name --group --stage --person --from-group --mode --color --position --terminal --enabled --hold --allowed --archived --reset --override include|exclude|auto --email-kind template|series --email-id --rule --run --cursor --limit --request-key. Boolean flags take true|false. Complex conditions/actions/mappings use JSON.",
             "CSV: --csv PATH plus --file mapping.json. import start requires a stable --request-key. Retry the same import with the same key and contents.",
             "list/export: --group GROUP_ID --stage STAGE_ID. See package PEOPLE.md for full examples and every JSON shape.",
@@ -476,41 +504,68 @@ export const COMMANDS = [
     },
     {
         name: "store",
-        summary: "Store catalog: items, variants, stock, and store settings (not inbox)",
-        usage: "frontpage store items|variants|categories|settings|orders|payments|connect|status|disconnect|import … [--site <slug>] [--json]",
+        summary: "Cart-only Store: products, variants, stock, categories, fulfillment, fees, receipts and orders",
+        usage: "frontpage store items|variants|categories|settings|orders|import … [--site <slug>] [--json]",
         topics: ["content"],
         examples: [
-            "frontpage store items list",
-            "frontpage store categories create hats --label Hats",
-            "frontpage store items create camp-hat --title \"Camp hat\" --price-cents 4999 --categories hats --stock 20",
-            "frontpage store settings set-checkout --mode cart",
-            "frontpage store items list --category hats",
-            "frontpage store variants add camp-hat --id m --option Size=M --price-cents 4999 --stock 8",
-            "frontpage store items stock camp-hat --variant m --add 5",
-            "frontpage store items stock camp-hat --variant m --remove 5",
-            "frontpage store items stock camp-hat --variant m --set 20",
-            "frontpage store settings set-fulfillment --mode pickup",
-            "frontpage store settings set-fulfillment --pickup --delivery --mode flat-rate --flat-cents 500 --pickup-location \"The shop\"",
-            "frontpage store settings set-currency --currency usd",
-            "frontpage store settings set-currency --currency jpy",
-            "frontpage store connect --no-open",
-            "frontpage store status",
-            "frontpage store import",
+            'frontpage store items create camp-hat --title "Camp hat" --price-cents 4999 --stock 20',
+            "frontpage store items restore camp-hat",
+            "frontpage store settings set-fulfillment --pickup --delivery --mode flat-rate --flat-cents 500",
+            "frontpage store settings set-checkout-fee --mode percent --bps 250",
+            "frontpage store settings set-receipt --stock",
+            "frontpage store settings availability off --yes",
         ],
         flags: [
-            "Integer cents only. $49.99 is 4999. Do not send 49.99 or a dollar string. --price-cents is the usual cost. Optional --discount-cents is the sale the buyer pays (strictly less than price). Omit --discount-cents when there is no sale. Checkout charges the sale; the site strikes through the usual price.",
-            "--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. list --category hats. items list --json returns every product and every variant — do not paste that into a model. The editor manage_store list_items call is one page of 25 slim rows plus total; get_item is one product. 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|set-checkout-fee. Currency is any Stripe presentment code such as usd or jpy. Checkout is store-wide (cart or instant). Do not use leftover items --checkout to pick cart vs Pay now. Gift cards still use --amount open --min-cents. Service fee applies to Add to cart and Pay now. Connect: frontpage store connect|status|disconnect. connect opens Frontpage then Stripe; --no-open for CI. disconnect keeps the shared Stripe account on payments.",
-            "Page markup is yours: data-fp-store-grid + data-fp-cart (cart starts hidden), every store control data-fp-requires=store. The public catalog pages with offset, limit, total, and truncated (default 24). list_items is the same shape with a max of 25. Product pages are the default: unless they said they do not want product pages, write one src/pages/products/item.astro (or shop) with data-fp-store-product. If they said no, skip that file and do not bind href or url. Description is a small markdown subset. PDP bind is <div data-fp-store-bind=description>. Do not bake titles or prices. Guide: https://frontpage.host/developers/store",
-            "import reads src/content/products/*.json from the site store into Store. One default variant each. Skip if that itemId already exists. Does not invent categories or change fulfillment.",
-            "orders / payments list|get read the same ledgers as frontpage inbox orders|payments",
-            "Unknown leftover flags fail closed (exit 2)",
+            "items list|get|create|update|archive|restore|activate|images|stock; use --file for nested variants, options, customizations and images. Existing fixed/open pricing is retained. Store always uses Add to cart.",
+            "Descriptions use a small markdown subset. Bind data-fp-store-bind=description for the full product story; do not bake titles, prices or images into the page. Store is cart-only; use Payments for explicit Pay now.",
+            "items stock uses --add/--remove as a signed delta, or --set/--unlimited. Never combine these verbs. Product pages use data-fp-store-product and the platform cart templates. Store prices use the account currency.",
+            "variants add|update|archive|restore; categories list|create|rename|archive. Create categories before assigning their slugs.",
+            "settings get|set-fulfillment|set-checkout-fee|set-receipt|availability get|on|off. Fee mode flat uses --cents; percent uses --bps (250 is 2.5%). Receipt takes --template <id> or --stock. Availability requires admin and --yes in scripts.",
+            "orders list|get; import explicitly reads the existing site product files. No fleet import or data conversion occurs.",
+            "Money fields use integer minor units: $49.99 is 4999 minor units in USD; JPY 4999 is ¥4999. Currency is read-only from Stripe. No --checkout, set-checkout or set-currency command.",
+            "Store off preserves catalog/orders and leaves Pay now/invoices/recurring billing running. Payments, Stripe setup, tax, activity and Pay now management use frontpage payments.",
+            "Full Store reference: packaged README.md and https://frontpage.host/developers/store. List bounds are source-specific; manage_store list_items is at most 25 compact rows.",
+        ],
+        seeAlso: ["payments", "people", "https://frontpage.host/developers/store"],
+    },
+    {
+        name: "payments",
+        summary: "Stripe, tax, payment activity, Pay now buttons, invoices and native recurring billing",
+        usage: "frontpage payments status|settings|connect|availability|activity|tax|buttons|invoices|recurring|customers … [--site <slug>] [--json]",
+        topics: ["content"],
+        examples: [
+            "frontpage payments status",
+            "frontpage payments connect --no-open",
+            "frontpage payments invoices preview --file invoice.json --json",
+            "frontpage payments invoices send --file invoice.json --preview-hash <hash> --operation-key <stable-uuid> --yes --json",
+            "frontpage payments recurring preview --file recurring.json --json",
+            "frontpage payments recurring create --file recurring.json --preview-hash <hash> --operation-key <stable-uuid> --yes",
+            "frontpage payments customers send-billing-link <customerMapId> --operation-key <stable-uuid> --yes",
+            "frontpage payments availability off --yes",
+        ],
+        flags: [
+            "status; settings; connect [--no-open]. Connect returns an existing signed-in admin browser handoff; it never accepts Stripe terms or completes onboarding.",
+            "availability preview|on|off. off reads affected counts before confirmed pause/void; a partial response stays off and requires another off request. on never resumes stopped billing or restores void invoices.",
+            "activity list|get <id> --source order|payment. invoices and recurring have separate get commands. Source IDs never collide.",
+            "buttons list [--limit 1..100 --offset N --archived true]; get|create|update|archive. create uses --id, --title, --price-cents, optional --amount open --min-cents; update takes an id and --file. Change price separately from details. Archive requires --yes. Only explicit Pay now references/registrations qualify; an old instant Store setting does not.",
+            "tax get; tax settings --file <file> --yes; tax registrations list|add --country US --state CA --yes|end <id> --yes. Supply the business's actual tax registrations. No automatic tax advice or raw Account Session secrets.",
+            "invoices preview|send --file <file>; list [--limit 1..100 --offset N --arrangement <id>]; get|refresh|resend|void <id>. send/resend need --operation-key; send needs --preview-hash; financial writes require --yes in scripts.",
+            "recurring preview|create --file <file>; list|get|refresh|cancel|resume|resend-invitation. Supported cadence: weekly, fortnightly, monthly, quarterly, yearly; firstDate YYYY-MM-DD, explicit IANA timeZone, 09:00 start. create/resume/invitation need stable operation keys. Resume requires first-date, preview-hash and --yes; no missed-period backfill.",
+            "customers billing-link|send-billing-link <customerMapId> --operation-key <key>. Send requires --yes. A returned link is private and expires after 30 minutes; do not put it in logs.",
+            "Common invoice flags: --person <CRM-id> OR --email <email> [--name <name>], --description, --amount-cents, --kind once|recurring, --collection manual|autopay, --cadence, --first-date, --time-zone, --due-days 7|14|30, --preview-hash, --operation-key. Use --file for nested address (line1,line2,city,region,postal,country).",
+            "Full REST methods, JSON examples, permissions, retries and financial semantics are in packaged PAYMENTS.md. All normal global auth/site/JSON/quiet/error/exit rules still apply.",
+        ],
+        dangers: [
+            "Reuse the same operation key and reviewed input after a timeout. Do not create a new key to force a send. Accepted email is not paid or proof of arrival; Stripe test mode may suppress invoice emails.",
+            "Autopay create sends an invitation. The customer must agree and finish Stripe setup. Saved cards, owner flags and browser returns are not consent or payment.",
+            "CLI requires Scale/Enterprise/Internal. New invoices require Growth+ separately. Financial writes require admin; existing tax writes and private reads permit editors; viewers receive no private ledger.",
+        ],
+        seeAlso: [
+            "store",
+            "people",
+            "modules",
+            "https://frontpage.host/developers/payments",
         ],
-        seeAlso: ["inbox", "https://frontpage.host/developers/store"],
     },
     {
         name: "mail",
@@ -561,7 +616,9 @@ export const COMMANDS = [
             "frontpage seo get --path /updates",
             "frontpage seo set --path / --title \"Home\"",
         ],
-        flags: ["get accepts positional path or --path (flag wins); unknown leftover flags fail closed"],
+        flags: [
+            "get accepts positional path or --path (flag wins); unknown leftover flags fail closed"
+        ],
     },
     {
         name: "articles",
@@ -733,7 +790,7 @@ export const TOPICS = {
   - Forms: <form data-fp-form="slug"> with named inputs; no action/onsubmit/honeypot.
   - Articles: frontpage articles …; migrate folders via frontpage prompt (don't invent mass delete+write).
   - Media: frontpage media upload (images/PDF ≤25 MB, video ≤50 MB). frontpage images generate --prompt "…" [--count N] for 1–4 AI variations of one invented picture (AI $ + storage). Use sitePath /__media/uploads/<slug>/… in markup (not raw blob URLs). Optional ?w= on rasters only.
-  - Store: frontpage store for catalog, settings set-checkout / set-fulfillment / set-checkout-fee, and connect. Write data-fp-store-grid + data-fp-cart (data-fp-requires=store; cart starts hidden). Unless they said they do not want product pages, write one src/pages/products/item.astro with data-fp-store-product. If they said no, skip that file and do not bind href or url. Guide: https://frontpage.host/developers/store
+  - Store: frontpage store for catalog, settings set-fulfillment / set-checkout-fee / set-receipt; frontpage payments owns Stripe and invoices. Write data-fp-store-grid + data-fp-cart (data-fp-requires=store; cart starts hidden). Unless they said they do not want product pages, write one src/pages/products/item.astro with data-fp-store-product. If they said no, skip that file and do not bind href or url. Guide: https://frontpage.host/developers/store
 
   Full guide: https://frontpage.host/developers/site-building
   See also: frontpage help sync | content | AGENTS.md`,
@@ -773,7 +830,8 @@ export const TOPICS = {
   frontpage routines list|get|add|set|pause|resume|rm|run|runs
   # Routines guide: https://frontpage.host/developers/routines
   # 8am,12pm,4pm and tue,thu,fri store hours [8, 12, 16] and weekdays [2, 4, 5] on one routine. Timezone is IANA.
-  frontpage store items|variants|categories|settings|orders|payments|connect|status|disconnect
+  frontpage store items|variants|categories|settings|orders|import
+  frontpage payments status|connect|availability|activity|buttons|tax|invoices|recurring|customers
   # Store catalog + live storefront: https://frontpage.host/developers/store
   # Integer cents only. $49.99 is 4999. stock --add/--remove are signed delta.
   # Markup: data-fp-store-grid / data-fp-store-product / data-fp-cart. One item.astro, not one file per product.
@@ -785,7 +843,7 @@ export const TOPICS = {
   frontpage tokens set --group … --key … --value …
   frontpage modules list|docs|request-setup|enable|disable|archive|config <key>
   frontpage modules <key>            # that key's CLI usage
-  frontpage store connect [--no-open]                        # Store Stripe connect
+  frontpage payments connect [--no-open]                        # Payments Stripe connect
   # mailing list key: signups. Index: https://frontpage.host/developers/modules
   frontpage extensions list|docs|enable|disable|config <key>
   frontpage settings get|set
@@ -795,7 +853,7 @@ export const TOPICS = {
   Do not fake payments/checkout. LOCKED extensions → do not fake; say plan required.
   Migrate pages → articles: prefer frontpage prompt "migrate …" over mass delete+write.
   edit uses click-edit (exact single occurrence), not push / gated-write.
-  Connect opens Frontpage (logged-in), then Stripe; never accepts or returns OAuth secrets. Store connect is frontpage store connect.
+  Connect opens Frontpage (logged-in), then Stripe; never accepts or returns OAuth secrets. Stripe setup is frontpage payments connect.
   Site contract: frontpage help site-building · https://frontpage.host/developers/site-building
   Domains, billing, members, and site delete are out of v1.`,
     history: `History

package/llms.txt

@@ -9,7 +9,7 @@
 - Fonts: frontpage fonts [--slot] [--query] → exact value → tokens set fonts.<role> → APPLY font-sans|serif|mono|display. Build bundles catalog faces from tokens.ts and/or CSS font-family contexts (not prose). Inline-only without tokens works for catalog faces after rebuild; prefer tokens+utilities for brand roles.
 - Module/extension docs: frontpage modules docs <key> | frontpage extensions docs <key>
 - Search flags: --regex --case-sensitive --whole-word --files-only --context-lines --max-results
-- Modules setup: Store Stripe connect is frontpage store connect. payments disconnect 409s if the store still uses the shared Stripe account. request-setup remains valid for the editor amber bar. frontpage modules <key> prints that key's CLI usage. Index: https://frontpage.host/developers/modules. Typed config: frontpage modules callbar|forms|booking|signups get|set (forms set needs --instance; confirm emails paid-plan only). Form destinations: frontpage modules forms destinations|connect-destination|attach-destination|detach-destination|remove-destination --yes|request-destination-setup (token = admin; request-destination-setup lights the editor bar; request-setup forms is a no-op; connect does not attach every form). Privyr: paste Incoming Webhook URL (https://www.privyr.com/api/v1/incoming-leads/…), not a token. HubSpot: Development → Keys → Service keys or Legacy apps → Auth → Show token. Pipedrive: profile → Company settings → Personal preferences → API. Docs: https://frontpage.host/developers/modules#forms-destinations. google_reviews: frontpage modules google_reviews connect --place-id | --maps-url (server resolve + seed; no Autocomplete; do not write placeId via config). Also status, list-reviews, hide/show, set-stars, set-sort, set-weight, reset-weights, refresh, disconnect. Docs: https://frontpage.host/developers/modules/google-reviews. Markup: data-fp-google-reviews / data-fp-google-ask + required data-fp-requires="google_reviews". Ask scores: frontpage inbox google_reviews.
+- Modules setup: Store Stripe connect is frontpage payments connect. Payments availability owns pause/restore and retains the shared Stripe account. request-setup remains valid for the editor amber bar. frontpage modules <key> prints that key's CLI usage. Index: https://frontpage.host/developers/modules. Typed config: frontpage modules callbar|forms|booking|signups get|set (forms set needs --instance; confirm emails paid-plan only). Form destinations: frontpage modules forms destinations|connect-destination|attach-destination|detach-destination|remove-destination --yes|request-destination-setup (token = admin; request-destination-setup lights the editor bar; request-setup forms is a no-op; connect does not attach every form). Privyr: paste Incoming Webhook URL (https://www.privyr.com/api/v1/incoming-leads/…), not a token. HubSpot: Development → Keys → Service keys or Legacy apps → Auth → Show token. Pipedrive: profile → Company settings → Personal preferences → API. Docs: https://frontpage.host/developers/modules#forms-destinations. google_reviews: frontpage modules google_reviews connect --place-id | --maps-url (server resolve + seed; no Autocomplete; do not write placeId via config). Also status, list-reviews, hide/show, set-stars, set-sort, set-weight, reset-weights, refresh, disconnect. Docs: https://frontpage.host/developers/modules/google-reviews. Markup: data-fp-google-reviews / data-fp-google-ask + required data-fp-requires="google_reviews". Ask scores: frontpage inbox google_reviews.
 - Analytics ops: frontpage analytics summary|query|funnel|timeseries|compare|sql (bare analytics = dashboard)
 - Media: frontpage media upload <file> (images/PDF ≤25 MB, video ≤50 MB, SVG/text ≤4 MB); human prints sitePath first — use /__media/uploads/<slug>/… in markup. Text/CSV is inline only (not media library; --json omits full content).
 - Prompt attachments: frontpage prompt "…" --attach <file|/__media/…|https://…> [--asset-url https://…] (same media caps as media upload)
@@ -18,7 +18,7 @@
 - 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
 - Routines: frontpage routines list|get|add|set|pause|resume|rm|run|runs. Several hours and several days are one routine. 8am,12pm,4pm and tue,thu,fri store hours [8, 12, 16] and weekdays [2, 4, 5]. Timezone is IANA. Do not guess UTC. Guide: https://frontpage.host/developers/routines
-- Store catalog: frontpage store items|variants|categories|settings|orders|payments|connect|status|disconnect. Integer cents only ($49.99 is 4999). --price-cents is the usual cost. Optional --discount-cents is the sale the buyer pays (must be lower). Create a category before assigning it. Photos are /__media/uploads/<this-slug>/… or an HTTPS URL already saved on this site. frontpage store connect [--no-open] opens Frontpage then Stripe. Checkout is store-wide (settings set-checkout); do not use leftover items --checkout to pick cart vs Pay now. Service fee is settings set-checkout-fee. The cart starts hidden. Product pages are the default: unless they said they do not want product pages, write one src/pages/products/item.astro (or shop) with data-fp-store-product. If they said no, skip that file and do not bind href or url. Description is a small markdown subset; product-page bind is <div data-fp-store-bind="description">. Every store control carries data-fp-requires="store". Leave data-fp-store-variants empty. Do not bake titles or prices. Guide: https://frontpage.host/developers/store
+- Store catalog: frontpage store items|variants|categories|settings|orders|import. Integer cents only ($49.99 is 4999). --price-cents is the usual cost. Optional --discount-cents is the sale the buyer pays (must be lower). Create a category before assigning it. Photos are /__media/uploads/<this-slug>/… or an HTTPS URL already saved on this site. frontpage payments connect [--no-open] opens Frontpage then Stripe. Store is cart-only; currency comes from Stripe and cannot be set. Use frontpage payments for standalone Pay now and invoices. Service fee is settings set-checkout-fee. The cart starts hidden. Product pages are the default: unless they said they do not want product pages, write one src/pages/products/item.astro (or shop) with data-fp-store-product. If they said no, skip that file and do not bind href or url. Description is a small markdown subset; product-page bind is <div data-fp-store-bind="description">. Every store control carries data-fp-requires="store". Leave data-fp-store-variants empty. Do not bake titles or prices. Guide: https://frontpage.host/developers/store
 - 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
@@ -35,3 +35,8 @@
 ## People groups, stages, rules, and imports
 
 Use `frontpage people overview`, `groups`, `stages`, `membership`, `rules`, `attachments`, `import`, and `company`. Use `frontpage mail campaign` for one-off group/stage/list audiences in Emails. Every editor action is available through these commands or `frontpage people workspace OPERATION --file payload.json`. Full operations and examples: [PEOPLE.md](./PEOPLE.md); public guide: https://frontpage.host/developers/people. Automated emails select a saved template or series. Campaigns use their own drafts.
+
+Customer Inbox (internal sites): CUSTOMER-INBOX.md. Settings, widget, knowledge, human guidance/relay, lifecycle, export/download and recovery. Website agents configure through manage_customer_inbox and must not use human credentials for conversations.
+
+
+Payments, invoices and recurring billing: see packaged [PAYMENTS.md](./PAYMENTS.md), `frontpage help payments`, and https://frontpage.host/developers/payments. Version 0.2.0 removes writable currency, Store checkout mode and Store-owned money commands; Store stays cart-only. Preview/review before sends; keep stable operation keys on retries. Autopay requires the customer’s own verified authorization.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "frontpage-host",
-  "version": "0.1.28",
-  "description": "Frontpage CLI — manage your site from the terminal",
+  "version": "0.2.0",
+  "description": "Frontpage CLI \u2014 manage your site from the terminal",
   "type": "module",
   "bin": {
     "frontpage": "dist/bin.js"
@@ -11,7 +11,9 @@
     "README.md",
     "AGENTS.md",
     "llms.txt",
-    "PEOPLE.md"
+    "PEOPLE.md",
+    "CUSTOMER-INBOX.md",
+    "PAYMENTS.md"
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",