frontpage-host 0.1.18 → 0.1.19

package/dist/commands/shop.js

@@ -0,0 +1,595 @@
+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 { SHOP_ID_RE, VARIANT_ID_RE } from "./shop-ids.js";
+const USAGE = "Usage: frontpage shop items|variants|settings|orders|payments … [--site <slug>] [--json]";
+const CENTS_HINT = "$49.99 is 4999";
+function takeAll(work, name) {
+    const out = [];
+    let v = takeFlag(work, name);
+    while (v !== undefined) {
+        out.push(v);
+        v = takeFlag(work, name);
+    }
+    return out;
+}
+function requireShopId(work, label = "Item id", opts) {
+    const fromFlag = (opts?.allowIdFlag === false ? undefined : takeFlag(work, "--id")) ?? takeFlag(work, "--item");
+    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");
+    }
+    if (!SHOP_ID_RE.test(raw)) {
+        throw new CliHttpError("Item not found.", EXIT_USAGE, 404, "not_found");
+    }
+    return raw;
+}
+function requireVariantId(raw, required = true) {
+    if (!raw) {
+        if (!required)
+            return undefined;
+        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");
+    }
+    return raw;
+}
+function requireLedgerId(work, kind) {
+    const fromFlag = takeFlag(work, "--id");
+    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");
+    }
+    return raw;
+}
+function parseCentsFlag(raw, label) {
+    if (raw === undefined)
+        return undefined;
+    const trimmed = raw.trim();
+    if (!/^\d+$/.test(trimmed)) {
+        throw new CliHttpError(`${label} must be an integer number of cents. ${CENTS_HINT}. Do not send ${trimmed}.`, EXIT_USAGE, 0, "bad_request");
+    }
+    const n = Number(trimmed);
+    if (!Number.isInteger(n)) {
+        throw new CliHttpError(`${label} must be an integer number of cents. ${CENTS_HINT}.`, EXIT_USAGE, 0, "bad_request");
+    }
+    return n;
+}
+function parseCountFlag(raw, label) {
+    if (raw === undefined)
+        return undefined;
+    const trimmed = raw.trim();
+    if (!/^-?\d+$/.test(trimmed)) {
+        throw new CliHttpError(`${label} must be an integer count.`, EXIT_USAGE, 0, "bad_request");
+    }
+    return Number(trimmed);
+}
+function parseBoolFlag(raw, label) {
+    if (raw === undefined)
+        return undefined;
+    if (raw === "true" || raw === "yes" || raw === "1")
+        return true;
+    if (raw === "false" || raw === "no" || raw === "0")
+        return false;
+    throw new CliHttpError(`${label} must be true or false.`, EXIT_USAGE, 0, "bad_request");
+}
+/** Bare `--flag` is true. `--flag false` / `--flag=false` stay false. */
+function takeBoolish(work, name, label) {
+    const eq = `${name}=`;
+    const i = work.findIndex((a) => a === name || a.startsWith(eq));
+    if (i === -1)
+        return undefined;
+    const token = work[i];
+    if (token.startsWith(eq)) {
+        work.splice(i, 1);
+        return parseBoolFlag(token.slice(eq.length), label);
+    }
+    const next = work[i + 1];
+    if (next === "true" || next === "false" || next === "yes" || next === "no" || next === "1" || next === "0") {
+        work.splice(i, 2);
+        return parseBoolFlag(next, label);
+    }
+    work.splice(i, 1);
+    return true;
+}
+function parseCsv(raw) {
+    if (raw === undefined)
+        return undefined;
+    return raw
+        .split(",")
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function parseOptions(pairs) {
+    if (pairs.length === 0)
+        return undefined;
+    const out = {};
+    for (const pair of pairs) {
+        const eq = pair.indexOf("=");
+        if (eq <= 0) {
+            throw new CliHttpError("Each --option needs Name=Value (example: Size=M).", EXIT_USAGE, 0, "bad_request");
+        }
+        out[pair.slice(0, eq)] = pair.slice(eq + 1);
+    }
+    return out;
+}
+function parseUrls(work) {
+    const fromRepeat = takeAll(work, "--urls");
+    const fromAlias = takeAll(work, "--url");
+    const fromImage = takeAll(work, "--image");
+    return [...fromRepeat, ...fromAlias, ...fromImage].flatMap((v) => v.split(",").map((s) => s.trim()).filter(Boolean));
+}
+async function readJsonFile(path) {
+    const raw = await readFile(path, "utf8");
+    try {
+        const parsed = JSON.parse(raw);
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new Error("not an object");
+        }
+        return parsed;
+    }
+    catch {
+        throw new CliHttpError("File must be a JSON object.", EXIT_USAGE, 0, "bad_request");
+    }
+}
+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 bits = [
+        row.checkout ?? "",
+        row.amount ?? "",
+        prices.length ? prices.join(",") : "",
+        stocks.length ? `stock ${stocks.join(",")}` : "",
+        row.active === false ? "inactive" : "active",
+        row.archivedAt ? "archived" : "",
+    ].filter(Boolean);
+    console.log(`${row.itemId}  ${row.title ?? ""}  ${bits.join("  ·  ")}`);
+}
+function printStock(row) {
+    const now = row.stockNow == null ? "unlimited" : String(row.stockNow);
+    console.log(`${row.itemId}  ${row.variantId}  ${row.change}  stockNow ${now}`);
+}
+export async function runShop(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        const group = rest[0];
+        const base = `/api/v1/sites/${encodeURIComponent(slug)}/shop`;
+        if (!group)
+            return emitUsage("shop", USAGE);
+        if (group === "items") {
+            const sub = rest[1];
+            const work = rest.slice(2);
+            if (!sub || sub === "list" || sub.startsWith("-")) {
+                const listWork = sub === "list" ? work : rest.slice(1);
+                const archived = hasFlag(listWork, "--archived");
+                assertNoUnknownFlags(listWork, "shop");
+                const qs = archived ? "?archived=1" : "";
+                const data = await v1Get(`${base}/items${qs}`);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                const rows = data.items ?? [];
+                if (rows.length === 0) {
+                    console.log(archived ? "No items." : "No items.");
+                    return EXIT_OK;
+                }
+                for (const row of rows)
+                    printItem(row);
+                return EXIT_OK;
+            }
+            if (sub === "get") {
+                const itemId = requireShopId(work);
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Get(`${base}/items/${encodeURIComponent(itemId)}`);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printItem(data.item);
+                for (const v of data.item.variants ?? []) {
+                    const sale = v.discountPriceCents != null ? `  sale ${v.discountPriceCents}` : "";
+                    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}`);
+                }
+                return EXIT_OK;
+            }
+            if (sub === "create") {
+                const file = takeFlag(work, "--file");
+                const itemId = takeFlag(work, "--id") ?? takeFlag(work, "--item") ?? work.find((a) => !a.startsWith("-"));
+                if (itemId && !file && work.includes(itemId))
+                    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");
+                const optionNames = parseCsv(takeFlag(work, "--option-names"));
+                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");
+                const body = file ? await readJsonFile(file) : {};
+                if (itemId)
+                    body.itemId = itemId;
+                if (title)
+                    body.title = title;
+                if (description !== undefined)
+                    body.description = description;
+                if (checkout)
+                    body.checkout = checkout;
+                if (amount)
+                    body.amount = amount;
+                if (minCents !== undefined)
+                    body.minCents = minCents;
+                if (requiresShipping !== undefined)
+                    body.requiresShipping = requiresShipping;
+                if (optionNames)
+                    body.optionNames = optionNames;
+                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) {
+                    const stock = stockRaw === undefined ? undefined : stockRaw === "unlimited" ? null : parseCountFlag(stockRaw, "stock");
+                    body.variants = [
+                        {
+                            variantId: variantId ?? "default",
+                            ...(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");
+                }
+                const data = await v1Post(`${base}/items`, body);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printItem(data.item);
+                return EXIT_OK;
+            }
+            if (sub === "update") {
+                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");
+                const active = parseBoolFlag(takeFlag(work, "--active"), "active");
+                const images = parseUrls(work);
+                assertNoUnknownFlags(work, "shop");
+                const body = {};
+                if (title !== undefined)
+                    body.title = title;
+                if (description !== undefined)
+                    body.description = description;
+                if (checkout !== undefined)
+                    body.checkout = checkout;
+                if (amount !== undefined)
+                    body.amount = amount;
+                if (minCents !== undefined)
+                    body.minCents = minCents;
+                if (requiresShipping !== undefined)
+                    body.requiresShipping = requiresShipping;
+                if (active !== undefined)
+                    body.active = active;
+                if (images.length)
+                    body.images = images;
+                if (Object.keys(body).length === 0) {
+                    throw new CliHttpError("Pass at least one field to update.", EXIT_USAGE, 0, "bad_request");
+                }
+                const data = await v1Patch(`${base}/items/${encodeURIComponent(itemId)}`, body);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printItem(data.item);
+                return EXIT_OK;
+            }
+            if (sub === "archive") {
+                const itemId = requireShopId(work);
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/archive`, {});
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printItem(data.item);
+                return EXIT_OK;
+            }
+            if (sub === "activate") {
+                const itemId = requireShopId(work);
+                const off = hasFlag(work, "--off");
+                const active = off ? false : parseBoolFlag(takeFlag(work, "--active"), "active");
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/activate`, { active: active ?? true });
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printItem(data.item);
+                return EXIT_OK;
+            }
+            if (sub === "images") {
+                const itemId = requireShopId(work);
+                const urls = parseUrls(work);
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Put(`${base}/items/${encodeURIComponent(itemId)}/images`, { images: urls });
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printItem(data.item);
+                return EXIT_OK;
+            }
+            if (sub === "stock") {
+                const itemId = requireShopId(work);
+                const variant = takeFlag(work, "--variant") ?? takeFlag(work, "--variant-id");
+                const addRaw = takeFlag(work, "--add");
+                const removeRaw = takeFlag(work, "--remove");
+                const setRaw = takeFlag(work, "--set");
+                assertNoUnknownFlags(work, "shop");
+                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");
+                }
+                const body = {};
+                if (variant)
+                    body.variantId = requireVariantId(variant);
+                if (addRaw !== undefined) {
+                    const n = parseCountFlag(addRaw, "--add");
+                    if (n === undefined || n <= 0) {
+                        throw new CliHttpError("--add must be a positive integer. 5 adds 5.", EXIT_USAGE, 0, "bad_request");
+                    }
+                    body.delta = n;
+                }
+                if (removeRaw !== undefined) {
+                    const n = parseCountFlag(removeRaw, "--remove");
+                    if (n === undefined || n <= 0) {
+                        throw new CliHttpError("--remove must be a positive integer. 5 removes 5.", EXIT_USAGE, 0, "bad_request");
+                    }
+                    body.delta = -n;
+                }
+                if (setRaw !== undefined) {
+                    if (setRaw === "unlimited" || setRaw === "null")
+                        body.set = null;
+                    else {
+                        const n = parseCountFlag(setRaw, "--set");
+                        if (n === undefined || n < 0) {
+                            throw new CliHttpError("--set must be an integer count, or unlimited.", EXIT_USAGE, 0, "bad_request");
+                        }
+                        body.set = n;
+                    }
+                }
+                const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/stock`, body);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printStock(data);
+                return EXIT_OK;
+            }
+            return emitUsage("shop", USAGE);
+        }
+        if (group === "variants") {
+            const sub = rest[1];
+            const work = rest.slice(2);
+            if (sub === "add") {
+                const itemId = requireShopId(work, "Item id", { allowIdFlag: false });
+                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");
+                if (priceCents === undefined) {
+                    throw new CliHttpError("Usage: frontpage shop 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`, {
+                    variantId,
+                    options,
+                    priceCents,
+                    discountPriceCents: discountCents,
+                    shippingCents,
+                    stock,
+                    active,
+                });
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printItem(data.item);
+                return EXIT_OK;
+            }
+            if (sub === "update") {
+                const itemId = requireShopId(work, "Item id", { allowIdFlag: false });
+                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");
+                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)
+                    body.options = options;
+                if (active !== undefined)
+                    body.active = active;
+                if (Object.keys(body).length === 0) {
+                    throw new CliHttpError("Pass at least one variant field to update.", EXIT_USAGE, 0, "bad_request");
+                }
+                const data = await v1Patch(`${base}/items/${encodeURIComponent(itemId)}/variants/${encodeURIComponent(variantId)}`, body);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printItem(data.item);
+                return EXIT_OK;
+            }
+            if (sub === "archive") {
+                const itemId = requireShopId(work, "Item id", { allowIdFlag: false });
+                const variantId = requireVariantId(takeFlag(work, "--id") ?? takeFlag(work, "--variant"));
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Post(`${base}/items/${encodeURIComponent(itemId)}/variants/${encodeURIComponent(variantId)}/archive`, {});
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                printItem(data.item);
+                return EXIT_OK;
+            }
+            return emitUsage("shop", USAGE);
+        }
+        if (group === "settings") {
+            const sub = rest[1] ?? "get";
+            const work = rest.slice(2);
+            if (sub === "get") {
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Get(`${base}/settings`);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                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}`);
+                return EXIT_OK;
+            }
+            if (sub === "set-fulfillment") {
+                const mode = takeFlag(work, "--mode") ?? takeFlag(work, "--shipping");
+                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");
+                let countryRates;
+                if (ratesRaw) {
+                    try {
+                        countryRates = JSON.parse(ratesRaw);
+                    }
+                    catch {
+                        throw new CliHttpError("countryRates must be JSON: [{\"country\":\"US\",\"rateCents\":800}]", EXIT_USAGE, 0, "bad_request");
+                    }
+                }
+                const data = await v1Post(`${base}/settings/fulfillment`, {
+                    shipping: mode,
+                    flatRateCents: flatCents,
+                    countryRates,
+                    restOfWorldEnabled: restOn,
+                    restOfWorldCents: restCents,
+                    freeShippingOverEnabled: freeOn,
+                    freeShippingOverCents: freeCents,
+                });
+                if (isJson())
+                    emitOk("shop", data);
+                else
+                    console.log("Fulfillment saved.");
+                return EXIT_OK;
+            }
+            if (sub === "set-currency") {
+                const currency = takeFlag(work, "--currency");
+                assertNoUnknownFlags(work, "shop");
+                if (!currency) {
+                    throw new CliHttpError("Usage: frontpage shop settings set-currency --currency usd", EXIT_USAGE, 0, "bad_request");
+                }
+                const data = await v1Post(`${base}/settings/currency`, { currency });
+                if (isJson())
+                    emitOk("shop", data);
+                else
+                    console.log("Currency saved.");
+                return EXIT_OK;
+            }
+            if (sub === "set-checkout-fee") {
+                const off = hasFlag(work, "--off");
+                const cents = parseCentsFlag(takeFlag(work, "--cents"), "checkoutFeeCents");
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Post(`${base}/settings/checkout-fee`, {
+                    enabled: off ? false : true,
+                    cents,
+                });
+                if (isJson())
+                    emitOk("shop", data);
+                else
+                    console.log(off ? "Checkout fee off." : "Checkout fee saved.");
+                return EXIT_OK;
+            }
+            return emitUsage("shop", USAGE);
+        }
+        if (group === "orders" || group === "payments") {
+            const noun = group;
+            const sub = rest[1] ?? "list";
+            const work = rest.slice(2);
+            if (sub === "list") {
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Get(`${base}/${noun}`);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                const rows = data[noun] ?? [];
+                if (rows.length === 0) {
+                    console.log(noun === "orders" ? "No orders." : "No payments.");
+                    return EXIT_OK;
+                }
+                for (const row of rows) {
+                    console.log(`${row.id}  ${row.amountCents ?? ""}  ${row.currency ?? ""}  ${row.status ?? ""}`);
+                }
+                return EXIT_OK;
+            }
+            if (sub === "get") {
+                const id = requireLedgerId(work, noun === "orders" ? "Order" : "Payment");
+                assertNoUnknownFlags(work, "shop");
+                const data = await v1Get(`${base}/${noun}/${encodeURIComponent(id)}`);
+                if (isJson()) {
+                    emitOk("shop", data);
+                    return EXIT_OK;
+                }
+                console.log(JSON.stringify(data[noun === "orders" ? "order" : "payment"], null, 2));
+                return EXIT_OK;
+            }
+            return emitUsage("shop", USAGE);
+        }
+        return emitUsage("shop", USAGE);
+    }
+    catch (err) {
+        return emitErr("shop", err);
+    }
+}

package/dist/modules/commands.js

@@ -132,8 +132,8 @@ export const MODULE_COMMANDS = [
     },
     {
         key: "payments",
-        name: "Payments",
-        summary: "Stripe payments. Connect finishes in the browser, not the terminal.",
+        name: "Pay buttons",
+        summary: "One-click Stripe pay buttons. No cart. Connect finishes in the browser, not the terminal.",
         genericActions: GENERIC_ACTIONS,
         extraActions: [
             "status",
@@ -151,14 +151,14 @@ export const MODULE_COMMANDS = [
         ],
         notes: [
             "Connect needs an admin API key. It opens Frontpage (you must be logged in there), then Stripe. Already-connected sites stay live — disconnect first to switch accounts.",
-            "payments and shop share one Stripe account. Disconnecting payments fails if the store still uses that account.",
+            "Pay buttons and the Online store share one Stripe account. Disconnecting Pay buttons fails if the store still uses that account.",
             "request-setup still lights the editor amber bar when you want the owner to finish there.",
         ],
     },
     {
         key: "shop",
         name: "Online store",
-        summary: "Stripe shop. Shares the payments Stripe account.",
+        summary: "Catalog, cart, and Stripe checkout. Shares the Pay buttons Stripe account.",
         genericActions: GENERIC_ACTIONS,
         extraActions: [
             "status",