@fullgrainsoftware/portal 0.9.0 → 0.11.0

package/README.md

@@ -1,6 +1,6 @@
 # @fullgrainsoftware/portal
 
-Site SDK for the [Fullgrain Portal](https://www.abdevpanel.com) CMS: declare your
+Site SDK for the [Fullgrain Portal](https://app.fullgrainsoftware.com) CMS: declare your
 site's structure in a typed manifest, read CMS-managed content in your pages,
 and sync structural changes with one command.
 
@@ -47,6 +47,8 @@ export default defineSite({
 });
 ```
 
+A repeatable section whose items are mostly a picture can take photos in bulk from the panel: set `batchUpload: true` (the section has exactly one image field) or `batchUpload: "<image field key>"`. Each picked image becomes one item with every other field empty, so no other field of that section may be `required`.
+
 ## Read content in your pages
 
 ```tsx

package/dist/bookings.js

@@ -3,7 +3,7 @@
    its manage token. Server-only — the abbk_ key is a secret — and every
    method returns a typed result instead of throwing for an expected
    outcome, so a site can never show a dead picker. */
-const DEFAULT_BASE_URL = "https://www.abdevpanel.com";
+const DEFAULT_BASE_URL = "https://app.fullgrainsoftware.com";
 const TIMEOUT_MS = 10_000;
 const versionOf = (o) => (typeof o?.version === "number" ? { version: o.version } : {});
 export function createBookings(opts) {

package/dist/cli.js

@@ -55,7 +55,7 @@ export async function runSync(argv) {
         console.error("AB_CMS_API_KEY is not set");
         return 1;
     }
-    const baseUrl = (process.env.AB_CMS_URL ?? "https://www.abdevpanel.com").replace(/\/$/, "");
+    const baseUrl = (process.env.AB_CMS_URL ?? "https://app.fullgrainsoftware.com").replace(/\/$/, "");
     const jiti = createJiti(import.meta.url);
     let loaded;
     try {

package/dist/cms-client.js

@@ -1,4 +1,4 @@
-const DEFAULT_BASE_URL = "https://www.abdevpanel.com";
+const DEFAULT_BASE_URL = "https://app.fullgrainsoftware.com";
 export async function fetchPublicSiteData(websiteId, opts) {
     const base = (opts?.baseUrl ?? process.env.AB_CMS_URL ?? DEFAULT_BASE_URL).replace(/\/$/, "");
     const timeoutMs = opts?.timeoutMs ?? 10_000;

package/dist/commerce.js

@@ -6,7 +6,7 @@
    a `store` block; catalog reads keep serving while a store is paused
    (checkoutAvailable tells the site whether to offer buying); checkout
    returns a typed error union instead of throwing for expected outcomes. */
-const DEFAULT_BASE_URL = "https://www.abdevpanel.com";
+const DEFAULT_BASE_URL = "https://app.fullgrainsoftware.com";
 export function createCommerce(opts) {
     if (typeof window !== "undefined") {
         throw new Error("createCommerce is server-only — never expose COMMERCE_API_KEY to the browser");

package/dist/index.d.ts

@@ -9,7 +9,7 @@ export { createCommerce } from "./commerce.js";
 export type { CartPreview, CheckoutInput, CheckoutResult, Commerce, LineIssue, OrderStatus, ProductDetail, ProductSummary, StoreStatus, VariantView, } from "./commerce.js";
 export { createInquiries } from "./inquiries.js";
 export type { Inquiries, InquiryInput, InquirySubmitResult } from "./inquiries.js";
-export { initCmsPreview, parseInbound, readyMessage, sectionClickedMessage, editItemMessage, PREVIEW_PROTOCOL_VERSION, PREVIEW_QUERY_FLAG, } from "./preview.js";
+export { initCmsPreview, normalizeSectionTitle, parseInbound, readyMessage, sectionClickedMessage, editItemMessage, PREVIEW_PROTOCOL_VERSION, PREVIEW_QUERY_FLAG, } from "./preview.js";
 export type { CmsPreviewOptions, PreviewInbound, PreviewOutbound } from "./preview.js";
 export { createBookings } from "./bookings.js";
 export type { AvailabilityDay, AvailabilityResult, BookInput, BookResult, BookingCustomer, BookingService, BookingStatus, BookingView, Bookings, GetBookingResult, ManageResult, RequestTimeInput, RequestTimeResult, ServicesResult, } from "./bookings.js";

package/dist/index.js

@@ -4,5 +4,5 @@ export { fetchPublicSiteData } from "./cms-client.js";
 export { readReviews } from "./reviews.js";
 export { createCommerce } from "./commerce.js";
 export { createInquiries } from "./inquiries.js";
-export { initCmsPreview, parseInbound, readyMessage, sectionClickedMessage, editItemMessage, PREVIEW_PROTOCOL_VERSION, PREVIEW_QUERY_FLAG, } from "./preview.js";
+export { initCmsPreview, normalizeSectionTitle, parseInbound, readyMessage, sectionClickedMessage, editItemMessage, PREVIEW_PROTOCOL_VERSION, PREVIEW_QUERY_FLAG, } from "./preview.js";
 export { createBookings } from "./bookings.js";

package/dist/inquiries.js

@@ -3,7 +3,7 @@
    recipients. Server-only — the abik_ key is a secret — and `submit` never
    throws for an expected outcome: it returns a typed result the site turns
    into its own success, "try again in a few minutes", or fallback state. */
-const DEFAULT_BASE_URL = "https://www.abdevpanel.com";
+const DEFAULT_BASE_URL = "https://app.fullgrainsoftware.com";
 const TIMEOUT_MS = 10_000;
 export function createInquiries(opts) {
     if (typeof window !== "undefined") {

package/dist/manifest.d.ts

@@ -18,6 +18,13 @@ export interface ManifestSection {
     title: string;
     kind: "repeatable" | "singleton";
     allowGroupCreation?: boolean;
+    /**
+     * Batch photo uploads in the panel ("Add photos": one item per picked
+     * image, every other field empty). `true` when the section has exactly one
+     * image field, else that field's key. Repeatable sections only; no other
+     * field may be `required`.
+     */
+    batchUpload?: true | string;
     fields: Record<string, ManifestField>;
     seed?: readonly ManifestSeedItem[];
 }
@@ -41,6 +48,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
             title: z.ZodString;
             kind: z.ZodEnum<["repeatable", "singleton"]>;
             allowGroupCreation: z.ZodOptional<z.ZodBoolean>;
+            batchUpload: z.ZodOptional<z.ZodUnion<[z.ZodLiteral<true>, z.ZodString]>>;
             fields: z.ZodRecord<z.ZodString, z.ZodObject<{
                 label: z.ZodString;
                 type: z.ZodEnum<["text", "image", "color", "audio", "video"]>;
@@ -90,6 +98,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;
@@ -108,6 +117,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;
@@ -126,6 +136,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;
@@ -144,6 +155,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;
@@ -166,6 +178,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;
@@ -188,6 +201,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;
@@ -213,6 +227,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;
@@ -238,6 +253,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;
@@ -263,6 +279,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;
@@ -288,6 +305,7 @@ export declare const siteManifestSchema: z.ZodEffects<z.ZodObject<{
                 generateMp4?: boolean | undefined;
             }>;
             allowGroupCreation?: boolean | undefined;
+            batchUpload?: string | true | undefined;
             seed?: {
                 values: Record<string, string>;
                 name: string;

package/dist/manifest.js

@@ -29,6 +29,7 @@ const sectionSchema = z
     title: z.string().trim().min(1),
     kind: z.enum(["repeatable", "singleton"]),
     allowGroupCreation: z.boolean().optional(),
+    batchUpload: z.union([z.literal(true), z.string().trim().min(1)]).optional(),
     fields: z.record(z.string().regex(/^[a-z][a-z0-9-]*$/, "field keys are lower-kebab"), fieldSchema),
     seed: z.array(seedItemSchema).optional(),
 })
@@ -64,6 +65,48 @@ const sectionSchema = z
             }
         }
     }
+    // Batch uploads: the panel fills ONE image field per picked file and
+    // leaves every other field empty, so the target must be an image field
+    // of a repeatable section and nothing else may be required.
+    if (section.batchUpload !== undefined) {
+        if (section.kind !== "repeatable") {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `batchUpload on section "${section.title}" needs kind: "repeatable"`,
+            });
+        }
+        const imageKeys = Object.entries(section.fields)
+            .filter(([, field]) => field.type === "image")
+            .map(([key]) => key);
+        let target = null;
+        if (section.batchUpload === true) {
+            if (imageKeys.length === 1)
+                target = imageKeys[0];
+            else {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `batchUpload: true on section "${section.title}" needs exactly one image field (found ${imageKeys.length}) — name the field key instead`,
+                });
+            }
+        }
+        else if (imageKeys.includes(section.batchUpload)) {
+            target = section.batchUpload;
+        }
+        else {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: `batchUpload on section "${section.title}" names "${section.batchUpload}", which is not an image field of that section`,
+            });
+        }
+        for (const [key, field] of Object.entries(section.fields)) {
+            if (key !== target && field.required) {
+                ctx.addIssue({
+                    code: z.ZodIssueCode.custom,
+                    message: `batchUpload on section "${section.title}" can't fill required field "${key}" — a batch-made item leaves every other field empty`,
+                });
+            }
+        }
+    }
 });
 const pageSchema = z
     .object({

package/dist/preview.d.ts

@@ -42,6 +42,21 @@ export interface CmsPreviewOptions {
      */
     allowedOrigins?: string[];
 }
+/** Case- and whitespace-insensitive, the way the panel matches section titles. */
+export declare function normalizeSectionTitle(title: string): string;
+/**
+ * Among the nodes tagged with one title, the first the visitor can see, else
+ * the first in the tree. A site tags both its desktop and mobile renderings
+ * of a section (the nav, say); whichever the preview's width hides must not
+ * win, or the scroll lands nowhere.
+ */
+export declare function pickSectionNode<T>(nodes: readonly T[], visible: (node: T) => boolean): T | null;
+/**
+ * Where the page scrolls to so the section's top clears whatever fixed or
+ * sticky bar covers the top of the viewport, honouring the section's own
+ * scroll-margin-top when the site set a larger one.
+ */
+export declare function scrollTargetTop(rectTop: number, scrollY: number, obstruction: number, scrollMargin: number): number;
 /**
  * Activate the preview bridge. Safe to call unconditionally: it no-ops on the
  * server and on the public (non-preview) site. Returns a cleanup function.

package/dist/preview.js

@@ -35,16 +35,11 @@ export function sectionClickedMessage(title) {
 export function editItemMessage(id) {
     return { source: "ab-cms-preview", v: PREVIEW_PROTOCOL_VERSION, type: "edit-item", id };
 }
-// The portal's current host and the one it moves to (rebrand, 2026-10). Keep
-// the abdevpanel origins until no site runs an SDK that predates the move.
+// The portal's host since the 2026-10 rebrand; the abdevpanel origins no
+// longer serve the panel (they redirect here), so they are not trusted.
 // The "ab-cms-*" message sources below are the wire protocol, not branding:
 // renaming them would break preview against every installed SDK version.
-const DEFAULT_ORIGINS = [
-    "https://www.abdevpanel.com",
-    "https://abdevpanel.com",
-    "https://app.abdevpanel.com",
-    "https://app.fullgrainsoftware.com",
-];
+const DEFAULT_ORIGINS = ["https://app.fullgrainsoftware.com"];
 function isPreviewContext(allowed) {
     if (typeof window === "undefined")
         return false;
@@ -79,15 +74,73 @@ function collectSectionTitles() {
     });
     return titles;
 }
+/** Case- and whitespace-insensitive, the way the panel matches section titles. */
+export function normalizeSectionTitle(title) {
+    return title.trim().replace(/\s+/g, " ").toLowerCase();
+}
+/**
+ * Among the nodes tagged with one title, the first the visitor can see, else
+ * the first in the tree. A site tags both its desktop and mobile renderings
+ * of a section (the nav, say); whichever the preview's width hides must not
+ * win, or the scroll lands nowhere.
+ */
+export function pickSectionNode(nodes, visible) {
+    if (nodes.length === 0)
+        return null;
+    return nodes.find(visible) ?? nodes[0];
+}
+/**
+ * Where the page scrolls to so the section's top clears whatever fixed or
+ * sticky bar covers the top of the viewport, honouring the section's own
+ * scroll-margin-top when the site set a larger one.
+ */
+export function scrollTargetTop(rectTop, scrollY, obstruction, scrollMargin) {
+    return Math.max(0, Math.round(rectTop + scrollY - Math.max(obstruction, scrollMargin)));
+}
+function isVisible(el) {
+    if (el.getClientRects().length === 0)
+        return false; // display:none, or inside one
+    const r = el.getBoundingClientRect();
+    return r.width > 0 || r.height > 0;
+}
+function matchingNodes(title) {
+    const target = normalizeSectionTitle(title);
+    const out = [];
+    document.querySelectorAll("[data-cms-section]").forEach((n) => {
+        if (normalizeSectionTitle(n.dataset.cmsSection ?? "") === target)
+            out.push(n);
+    });
+    return out;
+}
 function findSection(title) {
-    const target = title.trim().toLowerCase();
-    const nodes = document.querySelectorAll("[data-cms-section]");
-    for (const n of nodes) {
-        if (n.dataset.cmsSection?.trim().toLowerCase() === target)
-            return n;
+    return pickSectionNode(matchingNodes(title), isVisible);
+}
+/** The bottom edge of any fixed or sticky element sitting at the top of the viewport (a sticky nav), excluding the target itself. */
+function topObstruction(target) {
+    if (typeof document.elementsFromPoint !== "function")
+        return 0;
+    const x = Math.max(1, Math.floor(window.innerWidth / 2));
+    let bottom = 0;
+    for (const el of document.elementsFromPoint(x, 1)) {
+        if (!(el instanceof HTMLElement) || el === target || el.contains(target))
+            continue;
+        const pos = getComputedStyle(el).position;
+        if (pos !== "fixed" && pos !== "sticky")
+            continue;
+        bottom = Math.max(bottom, el.getBoundingClientRect().bottom);
     }
-    return null;
+    return bottom;
+}
+function scrollToSection(el) {
+    const margin = parseFloat(getComputedStyle(el).scrollMarginTop) || 0;
+    const top = scrollTargetTop(el.getBoundingClientRect().top, window.scrollY, topObstruction(el), margin);
+    const reduce = typeof window.matchMedia === "function" && window.matchMedia("(prefers-reduced-motion: reduce)").matches;
+    window.scrollTo({ top, behavior: reduce ? "auto" : "smooth" });
+    el.classList.add("cms-preview-flash");
+    window.setTimeout(() => el.classList.remove("cms-preview-flash"), 1600);
 }
+/** How long a scroll request waits for a section that has not rendered yet (a client-only leaf, a lazy list). */
+const LATE_SECTION_MS = 5000;
 /**
  * Activate the preview bridge. Safe to call unconditionally: it no-ops on the
  * server and on the public (non-preview) site. Returns a cleanup function.
@@ -106,7 +159,45 @@ export function initCmsPreview(options = {}) {
             }
         }
     };
-    const announce = () => post(readyMessage(collectSectionTitles()));
+    let announced = "";
+    const announce = () => {
+        const titles = collectSectionTitles();
+        const key = titles.join("\u0000");
+        if (key === announced)
+            return; // the dashboard already has this list
+        announced = key;
+        post(readyMessage(titles));
+    };
+    // A scroll request for a section that is not in the DOM yet waits for it
+    // (bounded), instead of being dropped; a newer request replaces it.
+    let pendingScroll = null;
+    const scrollWhenPresent = (title) => {
+        pendingScroll?.();
+        pendingScroll = null;
+        const now = findSection(title);
+        if (now) {
+            scrollToSection(now);
+            return;
+        }
+        if (typeof MutationObserver === "undefined")
+            return;
+        const observer = new MutationObserver(() => {
+            const el = findSection(title);
+            if (!el)
+                return;
+            stop();
+            scrollToSection(el);
+        });
+        const timer = window.setTimeout(() => stop(), LATE_SECTION_MS);
+        const stop = () => {
+            observer.disconnect();
+            window.clearTimeout(timer);
+            if (pendingScroll === stop)
+                pendingScroll = null;
+        };
+        pendingScroll = stop;
+        observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ["data-cms-section", "class", "style", "hidden"] });
+    };
     const onMessage = (event) => {
         if (!allowed.includes(event.origin))
             return;
@@ -117,14 +208,8 @@ export function initCmsPreview(options = {}) {
             window.location.reload();
             return;
         }
-        if (msg.type === "scroll-to-section") {
-            const el = findSection(msg.title);
-            if (!el)
-                return;
-            el.scrollIntoView({ behavior: "smooth", block: "start" });
-            el.classList.add("cms-preview-flash");
-            window.setTimeout(() => el.classList.remove("cms-preview-flash"), 1600);
-        }
+        if (msg.type === "scroll-to-section")
+            scrollWhenPresent(msg.title);
     };
     const onClick = (event) => {
         const target = event.target;
@@ -157,9 +242,22 @@ export function initCmsPreview(options = {}) {
         announce();
     else
         window.addEventListener("load", announce, { once: true });
+    // Sections that mount after load (client leaves, lazy lists) reach the
+    // dashboard's list too: re-announce when the set of tagged nodes changes.
+    let announceTimer = 0;
+    const sectionObserver = typeof MutationObserver === "undefined"
+        ? null
+        : new MutationObserver(() => {
+            window.clearTimeout(announceTimer);
+            announceTimer = window.setTimeout(announce, 300);
+        });
+    sectionObserver?.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ["data-cms-section"] });
     return () => {
         window.removeEventListener("message", onMessage);
         document.removeEventListener("click", onClick, true);
+        sectionObserver?.disconnect();
+        window.clearTimeout(announceTimer);
+        pendingScroll?.();
         style.remove();
     };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fullgrainsoftware/portal",
-  "version": "0.9.0",
+  "version": "0.11.0",
   "description": "Fullgrain Portal site SDK: manifest, typed content reader, sync CLI, preview bridge, commerce, inquiries and bookings clients",
   "repository": {
     "type": "git",