frontpage-host 0.1.21 → 0.1.22

package/AGENTS.md

@@ -119,7 +119,7 @@ Sites are Astro 6 + Tailwind v4. More detail: `frontpage help site-building` or
 ## Modules & articles
 
 - Forms: `data-fp-form` markup in pages + `frontpage modules` for enable/config. No submit JS / honeypot / `action`. Do not put a CRM webhook or token in HTML.
-- Wizard / connect-once modules (payments/shop/ordering): `frontpage modules <key> connect` opens Frontpage (you must be logged in there), then Stripe or Square. Already-connected sites stay live — do not retry connect. payments/shop connect needs an **admin** key; ordering connect needs **editor**. `--no-open` for CI. `request-setup` remains valid when you want the **editor amber bar** instead. payments and shop share one Stripe account — payments disconnect fails if the store still uses it. Auto-active modules (forms/callbar/…) need markup, not request-setup. Typed settings: `frontpage modules callbar|forms|booking|signups get|set` (forms set needs `--instance`; do not target `default`). Form destinations (HubSpot / Pipedrive / Privyr): connect once, then attach each form. `frontpage modules forms destinations|connect-destination|attach-destination|detach-destination|remove-destination --yes|request-destination-setup`. Token write is **admin**; `request-destination-setup` lights the editor amber bar (**editor** key). Do not use `request-setup forms` for a CRM (no-op). Connecting does not attach every form. Privyr: paste the Incoming Webhook URL from Automations → Lead Sources → Webhooks (`https://www.privyr.com/api/v1/incoming-leads/…`), not a token and not Outgoing Webhooks. HubSpot: Development → Keys → Service keys or Development → Legacy apps → Auth → Show token. Pipedrive: profile → Company settings → Personal preferences → API. Full docs: https://frontpage.host/developers/modules#forms-destinations. `frontpage modules <key>` prints that key's CLI usage (exit 2). Index: https://frontpage.host/developers/modules · payments/shop/ordering pages under /developers/modules/<key>
+- Connect-once modules: Store Stripe connect is `frontpage store connect`. `--no-open` for CI. `request-setup` remains valid when you want the **editor amber bar** instead. Payments and the store share one Stripe account — payments disconnect fails if the store still uses it. Auto-active modules (forms/callbar/…) need markup, not request-setup. Typed settings: `frontpage modules callbar|forms|booking|signups get|set` (forms set needs `--instance`; do not target `default`). Form destinations (HubSpot / Pipedrive / Privyr): connect once, then attach each form. `frontpage modules forms destinations|connect-destination|attach-destination|detach-destination|remove-destination --yes|request-destination-setup`. Token write is **admin**; `request-destination-setup` lights the editor amber bar (**editor** key). Do not use `request-setup forms` for a CRM (no-op). Connecting does not attach every form. Privyr: paste the Incoming Webhook URL from Automations → Lead Sources → Webhooks (`https://www.privyr.com/api/v1/incoming-leads/…`), not a token and not Outgoing Webhooks. HubSpot: Development → Keys → Service keys or Development → Legacy apps → Auth → Show token. Pipedrive: profile → Company settings → Personal preferences → API. Full docs: https://frontpage.host/developers/modules#forms-destinations. `frontpage modules <key>` prints that key's CLI usage (exit 2). Index: https://frontpage.host/developers/modules. Store: https://frontpage.host/developers/store
 - Google reviews: platform nodes only (`data-fp-google-reviews` / `data-fp-google-ask` + required `data-fp-requires="google_reviews"`). `data-layout` is `feed` (default), `badge`, or `link`. Never invent stars, quotes, a 1–10, or a Maps URL. Do not pick a Place ID via Autocomplete and do not write `placeId` through `modules config`. Owner-supplied Place ID / Maps URL: `frontpage modules google_reviews connect --place-id …` or `--maps-url …` (server resolves + seeds). Curation: `list-reviews`, `hide --id`, `show --id`, `set-stars`, `set-sort`, `set-weight`, `reset-weights`, `refresh`, `disconnect`. Usage: `frontpage modules google_reviews`. Docs: https://frontpage.host/developers/modules/google-reviews. Ask-widget scores: `frontpage inbox google_reviews`.
 - Articles: `frontpage articles …` for lifecycle; bodies via sync under `content/` or `articles content get|set`. Section landing is an owned `src/pages/<section>/index.astro`.
 - Migrate a folder into Articles: prefer `frontpage prompt "migrate … into articles"` — do not invent a mass delete+write migration.
@@ -128,7 +128,8 @@ Sites are Astro 6 + Tailwind v4. More detail: `frontpage help site-building` or
 - Generated images: `frontpage images generate --prompt "…"` `[--count N]` — one prompt, 1–4 variations of that same picture. Prints `sitePath:` first. Counts against AI $ and storage. Flag-off environments return 404 (`Image generation is not enabled.`). Do not call xAI / Imagine yourself.
 - Analytics: bare `frontpage analytics` = dashboard; also `summary|query|funnel|timeseries|compare|sql` for structured reads (SQL is guard + RLS site-scoped).
 - People CRM: `frontpage people list|get|add|set|note|rm-note|follow-up|hide|unhide|tag|export`. Site-scoped person graph (email or phone). Inbox stays the raw ledger. Hide is not forget. List export is CSV (not a one-person legal dump). Full guide: https://frontpage.host/developers/people
-- Store catalog: `frontpage shop items|variants|categories|settings|orders|payments|connect|status|disconnect`. Integer cents only (`$49.99` is `4999`). Stock `--add` / `--remove` become signed delta (`added 5` / `removed 5` / `set to 20` / `stockNow`). Create a category before assigning it (`categories create hats --label Hats`, then `items create … --categories hats`). `frontpage shop connect [--no-open]` opens Frontpage then Stripe (admin key; finish logged-in in the browser), then `status`. Disconnect keeps the shared Stripe account on payments. `frontpage modules shop|payments connect` still works. Square `ordering` is a different module. Full guide: https://frontpage.host/developers/shop
+- Routines: `frontpage routines list|get|add|set|pause|resume|rm|run|runs`. One routine can hold several hours and several days. `8am,12pm,4pm` on `tue,thu,fri` stores hours `[8, 12, 16]` and weekdays `[2, 4, 5]`. Ask for an IANA timezone. Do not guess UTC. Full 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 a site path `/__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"`. Do not bake titles or prices. Full guide: https://frontpage.host/developers/store
 
 ## Agent prompt loop
 

package/dist/bin.js

@@ -29,6 +29,7 @@ import { runInbox } from "./commands/inbox.js";
 import { runSeo } from "./commands/seo.js";
 import { runRedirects } from "./commands/redirects.js";
 import { runPeople } from "./commands/people.js";
+import { runRoutines } from "./commands/routines.js";
 import { runShop } from "./commands/shop.js";
 import { runMail } from "./commands/mail.js";
 import { runArticles } from "./commands/articles.js";
@@ -118,7 +119,9 @@ async function main() {
             return runInbox(args);
         case "people":
             return runPeople(args);
-        case "shop":
+        case "routines":
+            return runRoutines(args);
+        case "store":
             return runShop(args);
         case "mail":
             return runMail(args);

package/dist/commands/modules.js

@@ -2,7 +2,7 @@ import { resolveSlug } from "../site.js";
 import { EXIT_OK, exitCodeForError, v1Get, v1Post } from "../http/client.js";
 import { takeFlag } from "../argv.js";
 import { emitUsage } from "../runtime.js";
-import { formatModuleUsage, formatModulesIndex, isCliModuleAction, isDocumentedModuleKey, isGenericModuleVerb, } from "../modules/commands.js";
+import { formatModuleUsage, formatModulesIndex, formatPaymentsIsNotAModule, formatShopIsNotAModule, isCliModuleAction, isDocumentedModuleKey, isGenericModuleVerb, } from "../modules/commands.js";
 import { runGoogleReviews } from "../modules/google_reviews.js";
 import { isTypedConfigCliKey, runTypedConfig } from "../modules/typed_config.js";
 import { isFormsDestinationCliAction, runFormsDestinations } from "../modules/forms_destinations.js";
@@ -35,6 +35,12 @@ export async function runModules(args) {
         const peeked = positionalArgs(args);
         const peekedKey = peeked[0];
         const peekedAction = peeked[1];
+        if (peekedKey === "shop") {
+            return emitUsage("modules", formatShopIsNotAModule());
+        }
+        if (peekedKey === "payments") {
+            return emitUsage("modules", formatPaymentsIsNotAModule());
+        }
         if (peekedKey && isDocumentedModuleKey(peekedKey)) {
             if (!peekedAction) {
                 return emitUsage("modules", formatModuleUsage(peekedKey));
@@ -63,6 +69,12 @@ export async function runModules(args) {
         const slug = resolved.slug;
         const rest = rewriteKeyFirst(resolved.rest);
         const sub = rest[0];
+        if (rest[1] === "shop" || rest.includes("shop")) {
+            return emitUsage("modules", formatShopIsNotAModule());
+        }
+        if (rest[1] === "payments") {
+            return emitUsage("modules", formatPaymentsIsNotAModule());
+        }
         if (!sub || sub === "list" || sub === "ls") {
             const data = await v1Get(`/api/v1/sites/${encodeURIComponent(slug)}/modules`);
             for (const m of data.modules) {

package/dist/commands/people.js

@@ -37,6 +37,11 @@ function printPerson(row) {
         bits.push(row.email);
     if (row.phone && row.phone !== row.name)
         bits.push(row.phone);
+    if (row.address?.line1) {
+        bits.push([row.address.line1, row.address.city, row.address.region, row.address.postal, row.address.country]
+            .filter(Boolean)
+            .join(", "));
+    }
     if (row.followUpAt)
         bits.push(`follow-up ${row.followUpAt}`);
     if (row.hiddenAt)
@@ -174,9 +179,32 @@ export async function runPeople(args) {
                 if (v !== undefined)
                     body[field] = v === "" ? null : v;
             }
+            const clearAddress = hasFlag(work, "--clear-address");
+            const addressFields = {
+                name: takeFlag(work, "--address-name"),
+                line1: takeFlag(work, "--line1"),
+                line2: takeFlag(work, "--line2"),
+                city: takeFlag(work, "--city"),
+                region: takeFlag(work, "--region"),
+                postal: takeFlag(work, "--postal"),
+                country: takeFlag(work, "--country"),
+            };
+            if (clearAddress)
+                body.address = null;
+            else if (Object.values(addressFields).some((value) => value !== undefined)) {
+                body.address = {
+                    name: addressFields.name ?? null,
+                    line1: addressFields.line1 ?? null,
+                    line2: addressFields.line2 ?? null,
+                    city: addressFields.city ?? null,
+                    region: addressFields.region ?? null,
+                    postal: addressFields.postal ?? null,
+                    country: addressFields.country ?? null,
+                };
+            }
             assertNoUnknownFlags(work, "people");
             if (Object.keys(body).length === 0) {
-                console.error("Usage: frontpage people set <id> [--name …] [--email …] [--phone …] [--notes …] [--status …]");
+                console.error("Usage: frontpage people set <id> [--name …] [--email …] [--phone …] [--notes …] [--status …] [--line1 … --city … --region … --postal … --country …] [--clear-address]");
                 return EXIT_USAGE;
             }
             const data = await v1Patch(`${base}/${encodeURIComponent(id)}`, body);

package/dist/commands/routines.d.ts

@@ -0,0 +1 @@
+export declare function runRoutines(args: string[]): Promise<number>;

package/dist/commands/routines.js

@@ -0,0 +1,156 @@
+import { resolveSlug } from "../site.js";
+import { EXIT_OK, EXIT_USAGE, exitCodeForError, v1Delete, v1Get, v1Patch, v1Post, } from "../http/client.js";
+import { CliHttpError } from "../http/client.js";
+import { assertNoUnknownFlags, takeFlag } from "../argv.js";
+import { emitErr, emitOk, isJson } from "../runtime.js";
+import { parseHourList, parseMonthDayList, parseWeekdayList } from "../routines-parse.js";
+const USAGE = "Usage: frontpage routines list|get|add|set|pause|resume|rm|run|runs [--site <slug>] [--json]";
+const ID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function requireId(work) {
+    const fromFlag = takeFlag(work, "--id");
+    const positional = work.find((arg) => !arg.startsWith("-"));
+    const raw = fromFlag ?? (positional ? work.splice(work.indexOf(positional), 1)[0] : undefined);
+    if (!raw) {
+        throw new CliHttpError("Routine id is required. Run: frontpage help routines", EXIT_USAGE, 0, "bad_request");
+    }
+    if (!ID_RE.test(raw))
+        throw new CliHttpError("Routine not found.", EXIT_USAGE, 404, "not_found");
+    return raw;
+}
+function scheduleBody(work, requireCore) {
+    const name = takeFlag(work, "--name");
+    const prompt = takeFlag(work, "--prompt");
+    const cadence = takeFlag(work, "--cadence");
+    const timezone = takeFlag(work, "--timezone");
+    const hoursRaw = takeFlag(work, "--hours");
+    const weekdaysRaw = takeFlag(work, "--weekdays");
+    const monthDaysRaw = takeFlag(work, "--month-days");
+    if (requireCore && (!name || !prompt || !cadence || !timezone)) {
+        throw new CliHttpError("add needs --name, --prompt, --cadence, and --timezone. Run: frontpage help routines", EXIT_USAGE, 0, "bad_request");
+    }
+    let hours;
+    let weekdays;
+    let monthDays;
+    try {
+        if (hoursRaw !== undefined)
+            hours = parseHourList(hoursRaw);
+        if (weekdaysRaw !== undefined)
+            weekdays = parseWeekdayList(weekdaysRaw);
+        if (monthDaysRaw !== undefined)
+            monthDays = parseMonthDayList(monthDaysRaw);
+    }
+    catch (err) {
+        throw new CliHttpError(err instanceof Error ? err.message : "Invalid schedule.", EXIT_USAGE, 0, "bad_request");
+    }
+    const body = {};
+    if (name)
+        body.name = name;
+    if (prompt)
+        body.prompt = prompt;
+    if (cadence)
+        body.cadence = cadence;
+    if (timezone)
+        body.timezone = timezone;
+    if (hours)
+        body.hours = hours;
+    if (weekdays)
+        body.weekdays = weekdays;
+    if (monthDays)
+        body.monthDays = monthDays;
+    return body;
+}
+function printRoutine(row) {
+    const bits = [row.name, row.status, row.sentence, row.nextRunAt ? `next ${row.nextRunAt}` : ""].filter(Boolean);
+    console.log(`${row.id}  ${bits.join("  ·  ")}`);
+}
+export async function runRoutines(args) {
+    try {
+        const { slug, rest } = await resolveSlug(args);
+        const sub = rest[0];
+        const base = `/api/v1/sites/${encodeURIComponent(slug)}/routines`;
+        if (!sub || sub === "list") {
+            const work = sub === "list" ? rest.slice(1) : [...rest];
+            assertNoUnknownFlags(work, "routines");
+            const data = await v1Get(base);
+            if (isJson()) {
+                emitOk("routines", data);
+                return EXIT_OK;
+            }
+            const rows = data.routines ?? [];
+            if (rows.length === 0) {
+                console.log("No routines.");
+                return EXIT_OK;
+            }
+            for (const row of rows)
+                printRoutine(row);
+            return EXIT_OK;
+        }
+        if (sub === "get" || sub === "runs") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            assertNoUnknownFlags(work, "routines");
+            const path = sub === "get" ? `${base}/${id}` : `${base}/${id}/runs`;
+            const data = await v1Get(path);
+            if (isJson())
+                emitOk("routines", data);
+            else
+                console.log(JSON.stringify(data, null, 2));
+            return EXIT_OK;
+        }
+        if (sub === "add") {
+            const work = rest.slice(1);
+            const body = scheduleBody(work, true);
+            assertNoUnknownFlags(work, "routines");
+            const data = await v1Post(base, body);
+            if (isJson())
+                emitOk("routines", data);
+            else
+                printRoutine(data.routine);
+            return EXIT_OK;
+        }
+        if (sub === "set") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            const body = scheduleBody(work, false);
+            assertNoUnknownFlags(work, "routines");
+            const data = await v1Patch(`${base}/${id}`, body);
+            if (isJson())
+                emitOk("routines", data);
+            else
+                printRoutine(data.routine);
+            return EXIT_OK;
+        }
+        if (sub === "pause" || sub === "resume" || sub === "run") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            assertNoUnknownFlags(work, "routines");
+            const data = await v1Post(`${base}/${id}/${sub}`, {});
+            if (isJson())
+                emitOk("routines", data);
+            else if (data.routine)
+                printRoutine(data.routine);
+            else
+                console.log(JSON.stringify(data, null, 2));
+            return EXIT_OK;
+        }
+        if (sub === "rm") {
+            const work = rest.slice(1);
+            const id = requireId(work);
+            assertNoUnknownFlags(work, "routines");
+            const data = await v1Delete(`${base}/${id}`);
+            if (isJson())
+                emitOk("routines", data);
+            else
+                console.log(`Deleted ${data.deleted ?? id}`);
+            return EXIT_OK;
+        }
+        console.error(USAGE);
+        return EXIT_USAGE;
+    }
+    catch (err) {
+        if (isJson())
+            return emitErr("routines", err);
+        console.error(err instanceof Error ? err.message : String(err));
+        return exitCodeForError(err);
+    }
+}