@fullgrainsoftware/portal 0.9.0

package/dist/reader.js

@@ -0,0 +1,82 @@
+const toKey = (value) => value.trim().toLowerCase();
+function findSection(page, title) {
+    return page?.sections?.find((s) => toKey(s.title) === toKey(title));
+}
+function groupValues(section, group) {
+    const out = {};
+    for (const [fieldKey, field] of Object.entries(section.fields)) {
+        const component = group.components?.find((c) => toKey(c.key) === toKey(field.label));
+        // A component that exists is authoritative — including when an editor has
+        // deliberately cleared it to "". Only fall back to the manifest default
+        // when there is no component at all (never synced), so a cleared field
+        // stays cleared instead of resurrecting its default on every render.
+        out[fieldKey] = component ? component.value?.trim() ?? "" : field.default ?? "";
+    }
+    return out;
+}
+function seedValues(section) {
+    return (section.seed ?? []).map((item) => {
+        const out = {};
+        for (const [fieldKey, field] of Object.entries(section.fields)) {
+            out[fieldKey] = item.values[fieldKey] ?? field.default ?? "";
+        }
+        return out;
+    });
+}
+function defaultValues(section) {
+    const out = {};
+    for (const [fieldKey, field] of Object.entries(section.fields)) {
+        out[fieldKey] = field.default ?? "";
+    }
+    return out;
+}
+const withMeta = (values, id) => Object.assign({}, values, { _cms: { id } });
+function readSection(section, cmsPage) {
+    const cmsSection = findSection(cmsPage, section.title);
+    // The section exists in the CMS => it has been synced. An emptied synced
+    // section is genuinely empty; the seed must NOT reappear (that resurrects
+    // deleted content on the live site). Seed only a section that was never
+    // synced (no matching CMS section at all).
+    const synced = cmsSection !== undefined;
+    const groups = [...(cmsSection?.groups ?? [])].sort((a, b) => a.sort_order - b.sort_order ||
+        (a.created_at ?? "").localeCompare(b.created_at ?? ""));
+    if (section.kind === "repeatable") {
+        if (groups.length)
+            return groups.map((g) => withMeta(groupValues(section, g), g.id));
+        return synced ? [] : seedValues(section).map((v) => withMeta(v, ""));
+    }
+    if (groups.length)
+        return withMeta(groupValues(section, groups[0]), groups[0].id);
+    if (synced)
+        return withMeta(defaultValues(section), "");
+    const seeded = seedValues(section);
+    return withMeta(seeded[0] ?? defaultValues(section), "");
+}
+export function readSiteContent(manifest, website) {
+    const result = {};
+    const seenKeys = new Set();
+    for (const page of manifest.pages) {
+        const cmsPage = website?.pages?.find((p) => p.slug === page.slug);
+        for (const section of page.sections) {
+            // Section keys are the content object's property names; a duplicate would
+            // silently clobber one section. defineSite does no runtime validation and
+            // the Zod schema only runs in the sync CLI, so guard it here too.
+            if (seenKeys.has(section.key)) {
+                throw new Error(`Duplicate section key "${section.key}" in manifest — section keys must be unique across all pages.`);
+            }
+            seenKeys.add(section.key);
+            result[section.key] = readSection(section, cmsPage);
+        }
+    }
+    return result;
+}
+/**
+ * Spread onto an item's wrapper element to make it click-to-edit in the
+ * dashboard preview: `<div {...cmsItemProps(item)}>`. Returns {} for seed items
+ * (no CMS id yet), leaving them non-editable.
+ */
+export function cmsItemProps(item) {
+    return item._cms.id
+        ? { "data-cms-editable": "", "data-cms-item": item._cms.id }
+        : {};
+}

package/dist/reviews.d.ts

@@ -0,0 +1,2 @@
+import type { CMSReview, CMSWebsite } from "./cms-types.js";
+export declare function readReviews(website: CMSWebsite | null | undefined): CMSReview[];

package/dist/reviews.js

@@ -0,0 +1,13 @@
+function isReview(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const r = value;
+    const ratingOk = r.rating === null || (typeof r.rating === "number" && Number.isInteger(r.rating) && r.rating >= 1 && r.rating <= 5);
+    return typeof r.id === "string" && typeof r.name === "string" && typeof r.text === "string" && typeof r.createdAt === "string" && ratingOk;
+}
+export function readReviews(website) {
+    const list = website?.reviews;
+    if (!Array.isArray(list))
+        return [];
+    return list.filter(isReview).map((r) => ({ id: r.id, name: r.name, rating: r.rating, text: r.text, createdAt: r.createdAt }));
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@fullgrainsoftware/portal",
+  "version": "0.9.0",
+  "description": "Fullgrain Portal site SDK: manifest, typed content reader, sync CLI, preview bridge, commerce, inquiries and bookings clients",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fullgrainsoftware/fullgrain-portal-sdk.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "fullgrain": "bin/fullgrain.mjs"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "LICENSE",
+    "README.md"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit",
+    "test": "vitest run",
+    "prepare": "npm run build"
+  },
+  "dependencies": {
+    "jiti": "^2.4.2",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5.8.0",
+    "vitest": "^4.0.0"
+  }
+}