@tokenoftrust/cli 2.0.21 → 2.0.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenoftrust/cli",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "description": "Token of Trust developer CLI — clone a tenant store, run it locally with save→reload, and submit it for preview. Installs the `tot` command.",
   "license": "Apache-2.0",
   "author": "Token of Trust",

package/src/validate.mjs

@@ -313,15 +313,22 @@ function validateScriptsDoc(doc, file, config) {
   return out;
 }
 
-const SUPPORTED_BLOCK_CONTRACTS = new Set([
+// Standalone published-CLI mirror. packages/cli/test/validate.test.mjs pins it
+// to extension-contract-values.mjs, the repository/runtime authority.
+export const BLOCK_PALETTE_SUPPORTED_CONTRACTS = Object.freeze([
   "block-palette@1",
   "block-palette@2",
   "block-palette@3",
   "block-palette@4",
+  "block-palette@5",
+  "block-palette@6",
 ]);
+export const FEATURED_PRODUCT_PRESENTATIONS = Object.freeze(["grid", "carousel"]);
+const SUPPORTED_BLOCK_CONTRACTS = new Set(BLOCK_PALETTE_SUPPORTED_CONTRACTS);
 const KNOWN_BLOCKS = new Set([
   "hero",
   "promo_tiles",
+  "trust_strip",
   "featured_collections",
   "featured_products",
   "editorial",
@@ -341,6 +348,7 @@ const KNOWN_BLOCKS = new Set([
 const REQUIRED_BLOCK_PROPS = {
   hero: ["headline"],
   promo_tiles: ["tiles"],
+  trust_strip: ["items"],
   featured_collections: ["handles"],
   editorial: ["title"],
   newsletter: ["title"],
@@ -368,6 +376,37 @@ const PRODUCT_SOURCE_KEYS = new Set([
   "recentlyViewed",
 ]);
 const PRODUCT_SOURCE_SHORTCUTS = new Set(["featured", "newest", "bestSelling", "onSale"]);
+export const PROMO_TILE_PRESENTATIONS = Object.freeze(["overlay", "portrait-cards", "editorial-cards", "logo-strip"]);
+const PROMO_TILE_PRESENTATION_SET = new Set(PROMO_TILE_PRESENTATIONS);
+
+export function isSafeRehostedAssetPath(value) {
+  if (typeof value !== "string" || !value.startsWith("/")) return false;
+  if (value.includes("\\") || value.includes("?") || value.includes("#")) return false;
+  let decoded;
+  try { decoded = decodeURIComponent(value); } catch { return false; }
+  if (decoded !== value || decoded.includes("..") || decoded.includes("//")) return false;
+  return /^\/(?:tenants\/[^/]+|shared)\/[A-Za-z0-9][A-Za-z0-9._/-]*$/.test(value);
+}
+
+export function isSafeRehostedAssetPathForTenant(value, tenantId) {
+  if (!isSafeRehostedAssetPath(value) || typeof tenantId !== "string" || !tenantId) return false;
+  return value.startsWith("/shared/") || value.startsWith(`/tenants/${tenantId}/`);
+}
+
+export function isSafeStorefrontHref(value) {
+  if (typeof value !== "string" || !value.startsWith("/") || value.startsWith("//")) return false;
+  if (value.includes("\\") || value.includes("?") || value.includes("#") || /[\u0000-\u001f\u007f]/.test(value)) return false;
+  try {
+    const decoded = decodeURIComponent(value);
+    if (decoded !== value || decoded.includes("\\") || /[\u0000-\u001f\u007f]/.test(decoded)) return false;
+    const segments = value.split("/");
+    return !segments.some((segment, index) =>
+      index > 0 && (segment === "." || segment === ".." || (segment === "" && index < segments.length - 1))
+    );
+  } catch {
+    return false;
+  }
+}
 
 function validateProductSource(value, file, at) {
   const out = [];
@@ -403,7 +442,121 @@ function validateProductSource(value, file, at) {
   return out;
 }
 
-function validateHomeDoc(doc, file) {
+function validateVisualAsset(value, file, at, out, tenantId) {
+  const safe = tenantId
+    ? isSafeRehostedAssetPathForTenant(value, tenantId)
+    : isSafeRehostedAssetPath(value);
+  if (!safe) {
+    out.push(mk(ERROR, "asset-path", file, `${at} must be a /shared/... asset or belong to the active tenant`));
+  }
+}
+
+function validatePromoTiles(block, file, at, out, tenantId) {
+  if (block.presentation !== undefined && !PROMO_TILE_PRESENTATION_SET.has(block.presentation)) {
+    out.push(mk(ERROR, "block-prop", file, `${at}.presentation must be overlay, portrait-cards, editorial-cards, or logo-strip`));
+  }
+  if (!Array.isArray(block.tiles)) {
+    out.push(mk(ERROR, "block-prop", file, `${at}.tiles must be an array`));
+    return;
+  }
+  block.tiles.forEach((tile, index) => {
+    const tileAt = `${at}.tiles[${index}]`;
+    if (tile == null || typeof tile !== "object" || Array.isArray(tile)) {
+      out.push(mk(ERROR, "block-prop", file, `${tileAt} must be an object`));
+      return;
+    }
+    for (const prop of ["label", "href"]) {
+      if (typeof tile[prop] !== "string" || !tile[prop].trim()) {
+        out.push(mk(ERROR, "block-prop", file, `${tileAt}.${prop} must be a non-empty string`));
+      }
+    }
+    for (const prop of ["imageAlt", "meta"]) {
+      if (tile[prop] !== undefined && typeof tile[prop] !== "string") {
+        out.push(mk(ERROR, "block-prop", file, `${tileAt}.${prop} must be a string`));
+      }
+    }
+    if (tile.image !== undefined) validateVisualAsset(tile.image, file, `${tileAt}.image`, out, tenantId);
+    if (typeof tile.href === "string" && !isSafeStorefrontHref(tile.href)) {
+      out.push(mk(ERROR, "navigation-href", file, `${tileAt}.href must be a same-storefront root-relative path`));
+    }
+    if ((block.presentation ?? "overlay") !== "overlay" && tile.image === undefined) {
+      out.push(mk(ERROR, "block-required", file, `${tileAt}.image is required for ${block.presentation}`));
+    }
+  });
+  if ((block.ctaLabel === undefined) !== (block.ctaHref === undefined)) {
+    out.push(mk(ERROR, "block-required", file, `${at}.ctaLabel and ${at}.ctaHref must be supplied together`));
+  }
+  for (const prop of ["ctaLabel", "ctaHref"]) {
+    if (block[prop] !== undefined && (typeof block[prop] !== "string" || !block[prop].trim())) {
+      out.push(mk(ERROR, "block-prop", file, `${at}.${prop} must be a non-empty string`));
+    }
+  }
+  if (typeof block.ctaHref === "string" && !isSafeStorefrontHref(block.ctaHref)) {
+    out.push(mk(ERROR, "navigation-href", file, `${at}.ctaHref must be a same-storefront root-relative path`));
+  }
+}
+
+function validateHeroSlides(slides, file, at, out, tenantId) {
+  if (!Array.isArray(slides) || slides.length === 0) { out.push(mk(ERROR, "block-prop", file, `${at}.slides must be a non-empty array`)); return; }
+  slides.forEach((slide, index) => {
+    const slideAt = `${at}.slides[${index}]`;
+    if (slide == null || typeof slide !== "object" || Array.isArray(slide)) { out.push(mk(ERROR, "block-prop", file, `${slideAt} must be an object`)); return; }
+    for (const prop of ["image", "imageAlt"]) if (typeof slide[prop] !== "string" || !slide[prop].trim()) out.push(mk(ERROR, "block-required", file, `${slideAt}.${prop} must be a non-empty string`));
+    validateVisualAsset(slide.image, file, `${slideAt}.image`, out, tenantId);
+    for (const prop of ["headline", "ctaLabel", "ctaHref"]) if (slide[prop] !== undefined && (typeof slide[prop] !== "string" || !slide[prop].trim())) out.push(mk(ERROR, "block-prop", file, `${slideAt}.${prop} must be a non-empty string`));
+    if ((slide.ctaLabel === undefined) !== (slide.ctaHref === undefined)) out.push(mk(ERROR, "block-required", file, `${slideAt}.ctaLabel and ${slideAt}.ctaHref must be supplied together`));
+    if (typeof slide.ctaHref === "string" && !isSafeStorefrontHref(slide.ctaHref)) out.push(mk(ERROR, "navigation-href", file, `${slideAt}.ctaHref must be a same-storefront root-relative path`));
+  });
+}
+
+function validateTrustStrip(block, file, at, out, tenantId) {
+  if (!Array.isArray(block.items)) {
+    out.push(mk(ERROR, "block-prop", file, `${at}.items must be an array`));
+    return;
+  }
+  block.items.forEach((item, index) => {
+    const itemAt = `${at}.items[${index}]`;
+    if (item == null || typeof item !== "object" || Array.isArray(item) || !["claim", "rating"].includes(item.kind)) {
+      out.push(mk(ERROR, "block-prop", file, `${itemAt}.kind must be claim or rating`));
+      return;
+    }
+    if (item.kind === "claim") {
+      if (typeof item.label !== "string" || !item.label.trim()) {
+        out.push(mk(ERROR, "block-prop", file, `${itemAt}.label must be a non-empty string`));
+      }
+      if (item.icon !== undefined) validateVisualAsset(item.icon, file, `${itemAt}.icon`, out, tenantId);
+      if (item.iconAlt !== undefined && typeof item.iconAlt !== "string") {
+        out.push(mk(ERROR, "block-prop", file, `${itemAt}.iconAlt must be a string`));
+      }
+    } else if (
+      typeof item.average !== "number" || item.average <= 0 || item.average > 5 ||
+      typeof item.count !== "number" || item.count <= 0
+    ) {
+      out.push(mk(ERROR, "block-prop", file, `${itemAt} requires average 1–5 and a positive count`));
+    }
+  });
+}
+
+function validateFaq(block, file, at, out) {
+  if (!Array.isArray(block.items)) {
+    out.push(mk(ERROR, "block-prop", file, `${at}.items must be an array`));
+    return;
+  }
+  block.items.forEach((item, index) => {
+    const itemAt = `${at}.items[${index}]`;
+    if (item == null || typeof item !== "object" || Array.isArray(item)) {
+      out.push(mk(ERROR, "block-prop", file, `${itemAt} must be an object`));
+      return;
+    }
+    for (const prop of ["q", "a"]) {
+      if (typeof item[prop] !== "string" || !item[prop].trim()) {
+        out.push(mk(ERROR, "block-prop", file, `${itemAt}.${prop} must be a non-empty string`));
+      }
+    }
+  });
+}
+
+function validateHomeDoc(doc, file, tenantId) {
   const out = [];
   if (doc == null || typeof doc !== "object" || Array.isArray(doc)) {
     return [mk(ERROR, "home-root", file, "home.json must be a JSON object")];
@@ -433,6 +586,9 @@ function validateHomeDoc(doc, file) {
     for (const prop of REQUIRED_BLOCK_PROPS[component] || []) {
       if (block[prop] === undefined) out.push(mk(ERROR, "block-required", file, `${at} (${component}) is missing "${prop}"`));
     }
+    if (component === "featured_collections" && (!Array.isArray(block.handles) || !block.handles.every((v) => typeof v === "string"))) {
+      out.push(mk(ERROR, "block-prop", file, `${at}.handles must be a string array`));
+    }
     if (component === "featured_products") {
       if (block.source !== undefined) out.push(...validateProductSource(block.source, file, at));
       if (block.handles !== undefined && (!Array.isArray(block.handles) || !block.handles.every((v) => typeof v === "string"))) {
@@ -441,7 +597,21 @@ function validateHomeDoc(doc, file) {
       if (block.limit !== undefined && typeof block.limit !== "number") {
         out.push(mk(ERROR, "block-prop", file, `${at}.limit must be a number`));
       }
+      if (block.presentation !== undefined && !FEATURED_PRODUCT_PRESENTATIONS.includes(block.presentation)) out.push(mk(ERROR, "block-prop", file, `${at}.presentation must be grid or carousel`));
+    }
+    if (component === "hero" && block.image !== undefined) {
+      validateVisualAsset(block.image, file, `${at}.image`, out, tenantId);
+    }
+    if (component === "hero" && block.slides !== undefined) validateHeroSlides(block.slides, file, at, out, tenantId);
+    if (component === "editorial" && block.image !== undefined) {
+      validateVisualAsset(block.image, file, `${at}.image`, out, tenantId);
+      if (typeof block.imageAlt !== "string") {
+        out.push(mk(ERROR, "block-required", file, `${at}.imageAlt is required when ${at}.image is supplied`));
+      }
     }
+    if (component === "promo_tiles") validatePromoTiles(block, file, at, out, tenantId);
+    if (component === "trust_strip") validateTrustStrip(block, file, at, out, tenantId);
+    if (component === "faq") validateFaq(block, file, at, out);
   });
   return out;
 }
@@ -852,6 +1022,7 @@ export function validateTenant(tenantDir, opts = {}) {
     );
   }
   const scope = opts.scope || config?.scope;
+  const activeTenantId = opts.tenantId || scope || config?.tenant;
   // platform-route awareness: which framework routes the host platform owns for this tenant
   const mode = opts.mode === "workspace" ? "workspace" : "monorepo";
   const hostIsPlatform = mode === "monorepo" || config?.hostPlatform === "tot-storefront";
@@ -910,7 +1081,7 @@ export function validateTenant(tenantDir, opts = {}) {
       if (error) {
         findings.push(mk(ERROR, "content-json-parse", `content/${name}`, `invalid JSON: ${error} (fails the build)`));
       } else if (name === "home.json") {
-        findings.push(...validateHomeDoc(value, "content/home.json"));
+        findings.push(...validateHomeDoc(value, "content/home.json", activeTenantId));
       } else if (name === "chrome.json") {
         findings.push(...findDuplicateCtaIds(value, "content/chrome.json"));
         if (opts.previousChromeJson != null) {