frontpage-host 0.1.20 → 0.1.22

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 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 CENTS_HINT = "$49.99 is 4999";
 function takeAll(work, name) {
     const out = [];
@@ -20,10 +22,10 @@ function requireShopId(work, label = "Item id", opts) {
     const positional = work.find((a) => !a.startsWith("-"));
     const raw = fromFlag ?? (positional ? work.splice(work.indexOf(positional), 1)[0] : undefined);
     if (!raw) {
-        throw new CliHttpError(`${label} is required. Run: frontpage help shop`, EXIT_USAGE, 0, "bad_request");
+        throw new CliHttpError(`${label} is required. Run: frontpage help store`, EXIT_USAGE, 0, "bad_request");
     }
     if (!SHOP_ID_RE.test(raw)) {
-        throw new CliHttpError("Item not found.", EXIT_USAGE, 404, "not_found");
+        throw new CliHttpError("Item id must be kebab-case, like camp-hat (2–40 letters, numbers, or hyphens).", EXIT_USAGE, 0, "bad_request");
     }
     return raw;
 }
@@ -34,7 +36,7 @@ function requireVariantId(raw, required = true) {
         throw new CliHttpError("Variant id is required. Use --variant m or --id m.", EXIT_USAGE, 0, "bad_request");
     }
     if (!VARIANT_ID_RE.test(raw)) {
-        throw new CliHttpError("Variant not found.", EXIT_USAGE, 404, "not_found");
+        throw new CliHttpError("Version id must be kebab-case, like s, m, or camp-hat-m.", EXIT_USAGE, 0, "bad_request");
     }
     return raw;
 }
@@ -43,7 +45,7 @@ function requireLedgerId(work, kind) {
     const positional = work.find((a) => !a.startsWith("-"));
     const raw = fromFlag ?? (positional ? work.splice(work.indexOf(positional), 1)[0] : undefined);
     if (!raw || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(raw)) {
-        throw new CliHttpError(`${kind} not found.`, EXIT_USAGE, 404, "not_found");
+        throw new CliHttpError(`${kind} id must be a UUID. Run: frontpage store ${kind.toLowerCase()}s list`, EXIT_USAGE, 0, "bad_request");
     }
     return raw;
 }
@@ -144,7 +146,7 @@ function printItem(row) {
     const bits = [
         row.checkout ?? "",
         row.amount ?? "",
-        prices.length ? prices.join(",") : "",
+        prices.length ? `${prices.join(",")} cents` : "",
         stocks.length ? `stock ${stocks.join(",")}` : "",
         row.active === false ? "inactive" : "active",
         row.categories?.length ? row.categories.join(",") : "",
@@ -170,7 +172,7 @@ export async function runShop(args) {
                 const listWork = sub === "list" ? work : rest.slice(1);
                 const archived = hasFlag(listWork, "--archived");
                 const category = takeFlag(listWork, "--category");
-                assertNoUnknownFlags(listWork, "shop");
+                assertNoUnknownFlags(listWork, "store");
                 const qs = new URLSearchParams();
                 if (archived)
                     qs.set("archived", "1");
@@ -184,7 +186,7 @@ export async function runShop(args) {
                 }
                 const rows = data.items ?? [];
                 if (rows.length === 0) {
-                    console.log(archived ? "No items." : "No items.");
+                    console.log(category ? "No products in that category." : "No products in this store.");
                     return EXIT_OK;
                 }
                 for (const row of rows)
@@ -193,7 +195,7 @@ export async function runShop(args) {
             }
             if (sub === "get") {
                 const itemId = requireShopId(work);
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Get(`${base}/items/${encodeURIComponent(itemId)}`);
                 if (isJson()) {
                     emitOk("shop", data);
@@ -205,7 +207,7 @@ export async function runShop(args) {
                     const stock = v.stock == null ? "unlimited" : String(v.stock);
                     const off = v.active === false ? "  inactive" : "";
                     const archived = v.archivedAt ? "  archived" : "";
-                    console.log(`  ${v.variantId}  ${v.priceCents}${sale}  stock ${stock}${off}${archived}`);
+                    console.log(`  ${v.variantId}  ${v.priceCents} cents${sale}  stock ${stock}${off}${archived}`);
                 }
                 return EXIT_OK;
             }
@@ -224,12 +226,11 @@ export async function runShop(args) {
                 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");
                 const stockRaw = takeFlag(work, "--stock");
                 const variantId = takeFlag(work, "--variant-id") ?? takeFlag(work, "--variant");
                 const options = parseOptions(takeAll(work, "--option"));
                 const images = parseUrls(work);
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const body = file ? await readJsonFile(file) : {};
                 if (itemId)
                     body.itemId = itemId;
@@ -251,8 +252,6 @@ export async function runShop(args) {
                     body.categories = categories;
                 if (images.length)
                     body.images = images;
-                if (body.checkout == null)
-                    body.checkout = "cart";
                 if (body.amount == null)
                     body.amount = "fixed";
                 if (!Array.isArray(body.variants) && priceCents !== undefined) {
@@ -263,13 +262,12 @@ export async function runShop(args) {
                             ...(options ? { options } : {}),
                             priceCents,
                             ...(discountCents !== undefined ? { discountPriceCents: discountCents } : {}),
-                            ...(shippingCents !== undefined ? { shippingCents } : {}),
                             ...(stock !== undefined ? { stock } : {}),
                         },
                     ];
                 }
                 if (typeof body.itemId !== "string" || !SHOP_ID_RE.test(body.itemId)) {
-                    throw new CliHttpError("Usage: frontpage shop items create <itemId> --title … --price-cents 4999", EXIT_USAGE, 0, "bad_request");
+                    throw new CliHttpError("Item id must be kebab-case, like camp-hat (2–40 letters, numbers, or hyphens). Usage: frontpage store items create camp-hat --title \"Camp hat\" --price-cents 4999", EXIT_USAGE, 0, "bad_request");
                 }
                 const data = await v1Post(`${base}/items`, body);
                 if (isJson()) {
@@ -290,7 +288,7 @@ export async function runShop(args) {
                 const active = parseBoolFlag(takeFlag(work, "--active"), "active");
                 const categories = parseCsv(takeFlag(work, "--categories"));
                 const images = parseUrls(work);
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const body = {};
                 if (title !== undefined)
                     body.title = title;
@@ -323,7 +321,7 @@ export async function runShop(args) {
             }
             if (sub === "archive") {
                 const itemId = requireShopId(work);
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/archive`, {});
                 if (isJson()) {
                     emitOk("shop", data);
@@ -336,7 +334,7 @@ export async function runShop(args) {
                 const itemId = requireShopId(work);
                 const off = hasFlag(work, "--off");
                 const active = off ? false : parseBoolFlag(takeFlag(work, "--active"), "active");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/activate`, { active: active ?? true });
                 if (isJson()) {
                     emitOk("shop", data);
@@ -348,7 +346,7 @@ export async function runShop(args) {
             if (sub === "images") {
                 const itemId = requireShopId(work);
                 const urls = parseUrls(work);
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Put(`${base}/items/${encodeURIComponent(itemId)}/images`, { images: urls });
                 if (isJson()) {
                     emitOk("shop", data);
@@ -363,7 +361,7 @@ export async function runShop(args) {
                 const addRaw = takeFlag(work, "--add");
                 const removeRaw = takeFlag(work, "--remove");
                 const setRaw = takeFlag(work, "--set");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const present = [addRaw, removeRaw, setRaw].filter((v) => v !== undefined).length;
                 if (present !== 1) {
                     throw new CliHttpError("Pass either --add 5, --remove 5, or --set 20. --add / --remove become signed delta.", EXIT_USAGE, 0, "bad_request");
@@ -414,13 +412,12 @@ export async function runShop(args) {
                 const variantId = requireVariantId(takeFlag(work, "--id") ?? takeFlag(work, "--variant"));
                 const priceCents = parseCentsFlag(takeFlag(work, "--price-cents"), "priceCents");
                 const discountCents = parseCentsFlag(takeFlag(work, "--discount-cents"), "discountPriceCents");
-                const shippingCents = parseCentsFlag(takeFlag(work, "--shipping-cents"), "shippingCents");
                 const stockRaw = takeFlag(work, "--stock");
                 const options = parseOptions(takeAll(work, "--option"));
                 const active = parseBoolFlag(takeFlag(work, "--active"), "active");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 if (priceCents === undefined) {
-                    throw new CliHttpError("Usage: frontpage shop variants add <itemId> --id m --price-cents 4999", EXIT_USAGE, 0, "bad_request");
+                    throw new CliHttpError("Usage: frontpage store variants add <itemId> --id m --price-cents 4999", EXIT_USAGE, 0, "bad_request");
                 }
                 const stock = stockRaw === undefined ? undefined : stockRaw === "unlimited" ? null : parseCountFlag(stockRaw, "stock");
                 const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/variants`, {
@@ -428,7 +425,6 @@ export async function runShop(args) {
                     options,
                     priceCents,
                     discountPriceCents: discountCents,
-                    shippingCents,
                     stock,
                     active,
                 });
@@ -444,18 +440,15 @@ export async function runShop(args) {
                 const variantId = requireVariantId(takeFlag(work, "--id") ?? takeFlag(work, "--variant"));
                 const priceCents = parseCentsFlag(takeFlag(work, "--price-cents"), "priceCents");
                 const discountCents = parseCentsFlag(takeFlag(work, "--discount-cents"), "discountPriceCents");
-                const shippingCents = parseCentsFlag(takeFlag(work, "--shipping-cents"), "shippingCents");
                 const stockRaw = takeFlag(work, "--stock");
                 const options = parseOptions(takeAll(work, "--option"));
                 const active = parseBoolFlag(takeFlag(work, "--active"), "active");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const body = {};
                 if (priceCents !== undefined)
                     body.priceCents = priceCents;
                 if (discountCents !== undefined)
                     body.discountPriceCents = discountCents;
-                if (shippingCents !== undefined)
-                    body.shippingCents = shippingCents;
                 if (stockRaw !== undefined)
                     body.stock = stockRaw === "unlimited" ? null : parseCountFlag(stockRaw, "stock");
                 if (options)
@@ -476,7 +469,7 @@ export async function runShop(args) {
             if (sub === "archive") {
                 const itemId = requireShopId(work, "Item id", { allowIdFlag: false });
                 const variantId = requireVariantId(takeFlag(work, "--id") ?? takeFlag(work, "--variant"));
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/variants/${encodeURIComponent(variantId)}/archive`, {});
                 if (isJson()) {
                     emitOk("shop", data);
@@ -493,7 +486,7 @@ export async function runShop(args) {
             if (!sub || sub === "list" || sub.startsWith("-")) {
                 const listWork = sub === "list" ? work : rest.slice(1);
                 const archived = hasFlag(listWork, "--archived");
-                assertNoUnknownFlags(listWork, "shop");
+                assertNoUnknownFlags(listWork, "store");
                 const qs = archived ? "?archived=1" : "";
                 const data = await v1Get(`${base}/categories${qs}`);
                 if (isJson()) {
@@ -515,9 +508,9 @@ export async function runShop(args) {
                 if (slug && work.includes(slug))
                     work.splice(work.indexOf(slug), 1);
                 const label = takeFlag(work, "--label") ?? takeFlag(work, "--title");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 if (!slug || !SHOP_ID_RE.test(slug) || !label) {
-                    throw new CliHttpError("Usage: frontpage shop categories create hats --label Hats", EXIT_USAGE, 0, "bad_request");
+                    throw new CliHttpError("Usage: frontpage store categories create hats --label Hats", EXIT_USAGE, 0, "bad_request");
                 }
                 const data = await v1Post(`${base}/categories`, {
                     slug,
@@ -533,9 +526,9 @@ export async function runShop(args) {
             if (sub === "rename") {
                 const slug = requireShopId(work, "Category slug");
                 const label = takeFlag(work, "--label") ?? takeFlag(work, "--title");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 if (!label) {
-                    throw new CliHttpError("Usage: frontpage shop categories rename hats --label Hats", EXIT_USAGE, 0, "bad_request");
+                    throw new CliHttpError("Usage: frontpage store categories rename hats --label Hats", EXIT_USAGE, 0, "bad_request");
                 }
                 const data = await v1Patch(`${base}/categories/${encodeURIComponent(slug)}`, { label });
                 if (isJson()) {
@@ -547,7 +540,7 @@ export async function runShop(args) {
             }
             if (sub === "archive") {
                 const slug = requireShopId(work, "Category slug");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/categories/${encodeURIComponent(slug)}/archive`, {});
                 if (isJson()) {
                     emitOk("shop", data);
@@ -562,7 +555,7 @@ export async function runShop(args) {
             const sub = rest[1] ?? "get";
             const work = rest.slice(2);
             if (sub === "get") {
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Get(`${base}/settings`);
                 if (isJson()) {
                     emitOk("shop", data);
@@ -571,19 +564,31 @@ export async function runShop(args) {
                 const s = data.settings ?? {};
                 const fee = (s.checkoutFee ?? {});
                 const fulfill = (s.fulfillment ?? {});
-                const feeText = fee.enabled ? `checkout-fee ${fee.cents ?? 0}` : "checkout-fee off";
-                console.log(`${s.currency ?? "(no currency)"}  ${fulfill.shipping ?? "(no fulfillment)"}  ${feeText}`);
+                const methods = [
+                    fulfill.pickupEnabled ? "pickup" : null,
+                    fulfill.shippingEnabled ? "delivery" : null,
+                ].filter(Boolean);
+                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}`);
                 return EXIT_OK;
             }
             if (sub === "set-fulfillment") {
                 const mode = takeFlag(work, "--mode") ?? takeFlag(work, "--shipping");
+                const pickupOn = takeBoolish(work, "--pickup", "pickupEnabled");
+                const deliveryOn = takeBoolish(work, "--delivery", "shippingEnabled");
+                const pickupLocationName = takeFlag(work, "--pickup-location");
+                const pickupAddress = takeFlag(work, "--pickup-address");
+                const pickupHours = takeFlag(work, "--pickup-hours");
+                const pickupInstructions = takeFlag(work, "--pickup-instructions");
                 const flatCents = parseCentsFlag(takeFlag(work, "--flat-cents"), "flatRateCents");
                 const ratesRaw = takeFlag(work, "--country-rates");
                 const restOn = takeBoolish(work, "--rest-of-world", "restOfWorldEnabled");
                 const restCents = parseCentsFlag(takeFlag(work, "--rest-cents"), "restOfWorldCents");
                 const freeOn = takeBoolish(work, "--free-over", "freeShippingOverEnabled");
                 const freeCents = parseCentsFlag(takeFlag(work, "--free-over-cents"), "freeShippingOverCents");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 let countryRates;
                 if (ratesRaw) {
                     try {
@@ -595,6 +600,12 @@ export async function runShop(args) {
                 }
                 const data = await v1Post(`${base}/settings/fulfillment`, {
                     shipping: mode,
+                    ...(pickupOn !== undefined ? { pickupEnabled: pickupOn } : {}),
+                    ...(deliveryOn !== undefined ? { shippingEnabled: deliveryOn } : {}),
+                    ...(pickupLocationName !== undefined ? { pickupLocationName } : {}),
+                    ...(pickupAddress !== undefined ? { pickupAddress } : {}),
+                    ...(pickupHours !== undefined ? { pickupHours } : {}),
+                    ...(pickupInstructions !== undefined ? { pickupInstructions } : {}),
                     flatRateCents: flatCents,
                     countryRates,
                     restOfWorldEnabled: restOn,
@@ -610,9 +621,9 @@ export async function runShop(args) {
             }
             if (sub === "set-currency") {
                 const currency = takeFlag(work, "--currency");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 if (!currency) {
-                    throw new CliHttpError("Usage: frontpage shop settings set-currency --currency usd", EXIT_USAGE, 0, "bad_request");
+                    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 (isJson())
@@ -621,10 +632,23 @@ export async function runShop(args) {
                     console.log("Currency saved.");
                 return EXIT_OK;
             }
+            if (sub === "set-checkout") {
+                const checkout = takeFlag(work, "--mode") ?? takeFlag(work, "--checkout");
+                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 (isJson())
+                    emitOk("shop", data);
+                else
+                    console.log(checkout === "instant" ? "Checkout is Pay now." : "Checkout is add to cart.");
+                return EXIT_OK;
+            }
             if (sub === "set-checkout-fee") {
                 const off = hasFlag(work, "--off");
                 const cents = parseCentsFlag(takeFlag(work, "--cents"), "checkoutFeeCents");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Post(`${base}/settings/checkout-fee`, {
                     enabled: off ? false : true,
                     cents,
@@ -632,17 +656,96 @@ export async function runShop(args) {
                 if (isJson())
                     emitOk("shop", data);
                 else
-                    console.log(off ? "Checkout fee off." : "Checkout fee saved.");
+                    console.log(off ? "Service fee off." : "Service fee saved.");
                 return EXIT_OK;
             }
             return emitUsage("shop", 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("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, "store");
+            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, "store");
+            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 === "import") {
+            const work = rest.slice(1);
+            assertNoUnknownFlags(work, "store");
+            const data = await v1Post(`${base}/import`, {});
+            if (isJson()) {
+                emitOk("shop", data);
+                return EXIT_OK;
+            }
+            const imported = data.imported ?? [];
+            const skipped = data.skipped ?? [];
+            const failed = data.failed ?? [];
+            if (imported.length === 0 && skipped.length === 0 && failed.length === 0) {
+                console.log("No src/content/products files to import.");
+                return EXIT_OK;
+            }
+            for (const row of imported)
+                console.log(`imported  ${row.itemId}  ${row.title}`);
+            for (const row of skipped)
+                console.log(`skipped   ${row.itemId}  already in Store`);
+            for (const row of failed)
+                console.log(`failed    ${row.path}  ${row.reason}`);
+            console.log(`${imported.length} imported  ${skipped.length} skipped  ${failed.length} failed`);
+            return EXIT_OK;
+        }
         if (group === "orders" || group === "payments") {
             const noun = group;
             const sub = rest[1] ?? "list";
             const work = rest.slice(2);
             if (sub === "list") {
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Get(`${base}/${noun}`);
                 if (isJson()) {
                     emitOk("shop", data);
@@ -660,7 +763,7 @@ export async function runShop(args) {
             }
             if (sub === "get") {
                 const id = requireLedgerId(work, noun === "orders" ? "Order" : "Payment");
-                assertNoUnknownFlags(work, "shop");
+                assertNoUnknownFlags(work, "store");
                 const data = await v1Get(`${base}/${noun}/${encodeURIComponent(id)}`);
                 if (isJson()) {
                     emitOk("shop", data);

package/dist/completions/generate.js

@@ -26,6 +26,8 @@ _frontpage_completions() {
     articles) COMPREPLY=( $(compgen -W "list content create-section create-article set-draft" -- "\${cur}") ) ;;
     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}") ) ;;
     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}") )
@@ -33,12 +35,10 @@ _frontpage_completions() {
         COMPREPLY=( $(compgen -W "docs request-setup enable disable archive config get set destinations connect-destination remove-destination disconnect-destination attach-destination detach-destination request-destination-setup" -- "\${cur}") )
       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 || \${COMP_WORDS[2]} == shop) ]]; then
+      elif [[ \${COMP_CWORD} -ge 3 && \${COMP_WORDS[2]} == payments ]]; then
         COMPREPLY=( $(compgen -W "docs request-setup enable disable archive config status connect disconnect" -- "\${cur}") )
-      elif [[ \${COMP_CWORD} -ge 3 && \${COMP_WORDS[2]} == ordering ]]; then
-        COMPREPLY=( $(compgen -W "docs request-setup enable disable archive config status connect disconnect sync" -- "\${cur}") )
       else
-        COMPREPLY=( $(compgen -W "list docs request-setup enable disable archive config callbar forms booking signups payments shop ordering articles google_reviews" -- "\${cur}") )
+        COMPREPLY=( $(compgen -W "list docs request-setup enable disable archive config callbar forms booking signups payments articles google_reviews" -- "\${cur}") )
       fi
       ;;
     extensions) COMPREPLY=( $(compgen -W "list docs enable disable config" -- "\${cur}") ) ;;
@@ -71,6 +71,8 @@ _frontpage() {
         seo|settings) _values 'subcommand' get set ;;
         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 ;;
         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
@@ -78,12 +80,10 @@ _frontpage() {
             _values 'subcommand' docs request-setup enable disable archive config get set destinations connect-destination remove-destination disconnect-destination attach-destination detach-destination request-destination-setup
           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 || $words[2] == shop ]]; then
+          elif [[ $words[2] == payments ]]; then
             _values 'subcommand' docs request-setup enable disable archive config status connect disconnect
-          elif [[ $words[2] == ordering ]]; then
-            _values 'subcommand' docs request-setup enable disable archive config status connect disconnect sync
           else
-            _values 'subcommand' list docs request-setup enable disable archive config callbar forms booking signups payments shop ordering articles google_reviews
+            _values 'subcommand' list docs request-setup enable disable archive config callbar forms booking signups payments articles google_reviews
           fi
           ;;
         extensions) _values 'subcommand' list docs enable disable config ;;
@@ -109,12 +109,13 @@ export function generateFishCompletion() {
         `complete -c frontpage -n "__fish_seen_subcommand_from seo settings" -a "get set"`,
         `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 modules" -a "list docs request-setup enable disable archive config callbar forms booking signups payments shop ordering articles google_reviews"`,
+        `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 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 shop" -a "status connect disconnect"`,
-        `complete -c frontpage -n "__fish_seen_subcommand_from modules; and __fish_seen_subcommand_from ordering" -a "status connect disconnect sync"`,
+        `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 extensions" -a "list docs enable disable config"`,
         `complete -c frontpage -l site -d "Site subdomain slug"`,
     ];

package/dist/http/client.js

@@ -51,7 +51,7 @@ export function httpErrorFromV1(status, parsed, fallbackMessage) {
         if (lower === "not found." || lower === "not found") {
             return new CliHttpError("API not available (is PUBLIC_CLI_ENABLED on for this environment?).", EXIT_UNEXPECTED, status, code, requestId);
         }
-        return new CliHttpError(message, EXIT_AUTH, status, code, requestId);
+        return new CliHttpError(message, EXIT_USAGE, status, code, requestId);
     }
     return new CliHttpError(message, EXIT_UNEXPECTED, status, code, requestId);
 }

package/dist/modules/commands.d.ts

@@ -2,7 +2,7 @@
  * §CLI-MOD-FW — per-key CLI registry (usage printer + help --json).
  * Instagram is not documented here. Google reviews extras ship in Phase 1.
  */
-export declare const DOCUMENTED_MODULE_KEYS: readonly ["callbar", "forms", "booking", "signups", "payments", "shop", "ordering", "articles", "google_reviews"];
+export declare const DOCUMENTED_MODULE_KEYS: readonly ["callbar", "forms", "booking", "signups", "articles", "google_reviews"];
 export type DocumentedModuleKey = (typeof DOCUMENTED_MODULE_KEYS)[number];
 export declare const GENERIC_MODULE_VERBS: readonly ["list", "ls", "docs", "doc", "request-setup", "request_setup", "enable", "disable", "archive", "config"];
 export type ModuleCommandDef = {
@@ -19,10 +19,11 @@ export declare const MODULE_COMMANDS: readonly ModuleCommandDef[];
 export declare const GOOGLE_REVIEWS_CLI_ACTIONS: readonly ["connect", "resolve", "status", "list-reviews", "hide", "show", "set-stars", "set-sort", "set-weight", "reset-weights", "write-review-url", "refresh", "disconnect"];
 export declare const TYPED_CONFIG_CLI_ACTIONS: readonly ["get", "set"];
 export declare const STRIPE_OAUTH_CLI_ACTIONS: readonly ["status", "connect", "disconnect"];
-export declare const ORDERING_OAUTH_CLI_ACTIONS: readonly ["status", "connect", "disconnect", "sync"];
 export declare function isCliModuleAction(key: DocumentedModuleKey, action: string): boolean;
 export declare function isDocumentedModuleKey(raw: string): raw is DocumentedModuleKey;
 export declare function isGenericModuleVerb(raw: string): boolean;
 export declare function moduleCommand(key: DocumentedModuleKey): ModuleCommandDef;
+export declare function formatShopIsNotAModule(): string;
+export declare function formatPaymentsIsNotAModule(): string;
 export declare function formatModuleUsage(key: DocumentedModuleKey): string;
 export declare function formatModulesIndex(): string;