@tokenoftrust/storefront-runner 4.7.10 → 4.8.1

package/packages/public-runtime/src/declared-tenant-config.mjs

@@ -27,6 +27,7 @@ export const DECLARED_TENANT_CONFIG_FIELDS = Object.freeze([
   "embeds",
   "seo",
   "currency",
+  "timezone",
   "shipping",
 ]);
 
@@ -149,6 +150,42 @@ export function currencyDeclarationProblems(currency) {
     : [`\`currency\` is ${JSON.stringify(currency)} — must be an uppercase ISO 4217 code such as "USD" or "CAD"`];
 }
 
+/** The IANA time zone a store's days are counted in when `.tot/config.json` declares none. */
+export const DEFAULT_TIMEZONE = "UTC";
+
+/**
+ * What is wrong with a declared `timezone`, one sentence; `[]` when it is valid. A valid one is
+ * an IANA zone name the runtime's Intl knows, such as "America/Los_Angeles" or "UTC"; a numeric
+ * offset is not a zone, so "today" would drift across daylight-saving changes.
+ *
+ * @param {unknown} timezone
+ * @returns {string[]}
+ */
+export function timezoneDeclarationProblems(timezone) {
+  const named = typeof timezone === "string" && /^[A-Za-z][A-Za-z0-9_+-]*(\/[A-Za-z0-9_+-]+)*$/.test(timezone);
+  if (named) {
+    try {
+      new Intl.DateTimeFormat("en-US", { timeZone: /** @type {string} */ (timezone) });
+      return [];
+    } catch {
+      /* not a zone the runtime knows */
+    }
+  }
+  return [`\`timezone\` is ${JSON.stringify(timezone)} — must be an IANA time zone name such as "America/Los_Angeles" or "UTC"`];
+}
+
+/**
+ * The ONE place the time zone a store's days are counted in is resolved. A declared IANA zone
+ * wins; anything else (absent, wrong shape, unknown zone) is UTC. "Today", a daily total and an
+ * order's displayed time take the zone from here, never from the server's clock.
+ *
+ * @param {unknown} declared
+ * @returns {string}
+ */
+export function resolveStoreTimeZone(declared) {
+  return timezoneDeclarationProblems(declared).length === 0 ? /** @type {string} */ (declared) : DEFAULT_TIMEZONE;
+}
+
 const SITE_TYPES = new Set(SITE_TYPES_LIST);
 
 const isPlainObject = (value) =>
@@ -343,7 +380,7 @@ export function declaredTenantConfig(config) {
   /** @type {Record<string, unknown>} */
   const out = {};
   if (!isPlainObject(config)) return out;
-  const { displayName, siteType, compliance, capabilities, features, embeds, seo, currency, shipping } = /** @type {Record<string, unknown>} */ (config);
+  const { displayName, siteType, compliance, capabilities, features, embeds, seo, currency, timezone, shipping } = /** @type {Record<string, unknown>} */ (config);
   // The store's name as visitors read it: the `<title>` suffix, og:site_name,
   // Organization JSON-LD, breadcrumbs, the default blog heading, the copyright line.
   if (typeof displayName === "string" && displayName.trim()) out.displayName = displayName.trim();
@@ -356,6 +393,8 @@ export function declaredTenantConfig(config) {
   if (seo !== undefined && seoDeclarationProblems(seo).length === 0) out.seo = seo;
   // Wrong-shaped or unknown codes are omitted: the store sells in USD (`tot validate` reports it).
   if (currency !== undefined && currencyDeclarationProblems(currency).length === 0) out.currency = currency;
+  // Wrong-shaped or unknown zones are omitted: the store counts its days in UTC (`tot validate` reports it).
+  if (timezone !== undefined && timezoneDeclarationProblems(timezone).length === 0) out.timezone = timezone;
   // The shipping charge: refused whole when any part is malformed (`tot validate` and the
   // reconcile report it), so checkout keeps charging no shipping rather than a guess.
   if (shipping !== undefined && shippingDeclarationProblems(shipping).length === 0) {

package/packages/public-runtime/src/extension-contract-values.d.mts

@@ -1,4 +1,4 @@
-export declare const BLOCK_PALETTE_CURRENT_CONTRACT: "block-palette@7";
+export declare const BLOCK_PALETTE_CURRENT_CONTRACT: "block-palette@8";
 export declare const BLOCK_PALETTE_SUPPORTED_CONTRACTS: readonly [
   "block-palette@1",
   "block-palette@2",
@@ -7,8 +7,11 @@ export declare const BLOCK_PALETTE_SUPPORTED_CONTRACTS: readonly [
   "block-palette@5",
   "block-palette@6",
   "block-palette@7",
+  "block-palette@8",
 ];
 export declare const FEATURED_PRODUCT_PRESENTATIONS: readonly ["grid", "carousel"];
+export declare const LATEST_POSTS_DEFAULT_LIMIT: 3;
+export declare const LATEST_POSTS_MAX_LIMIT: 12;
 export declare const PROMO_TILE_PRESENTATIONS: readonly [
   "overlay",
   "portrait-cards",

package/packages/public-runtime/src/extension-contract-values.mjs

@@ -5,7 +5,7 @@
  * runtime and repository Node tooling. The separately published CLI mirrors
  * these values and pins that mirror with a parity test.
  */
-export const BLOCK_PALETTE_CURRENT_CONTRACT = "block-palette@7";
+export const BLOCK_PALETTE_CURRENT_CONTRACT = "block-palette@8";
 
 export const BLOCK_PALETTE_SUPPORTED_CONTRACTS = Object.freeze([
   "block-palette@1",
@@ -14,11 +14,16 @@ export const BLOCK_PALETTE_SUPPORTED_CONTRACTS = Object.freeze([
   "block-palette@4",
   "block-palette@5",
   "block-palette@6",
+  "block-palette@7",
   BLOCK_PALETTE_CURRENT_CONTRACT,
 ]);
 
 export const FEATURED_PRODUCT_PRESENTATIONS = Object.freeze(["grid", "carousel"]);
 
+/** `latest_posts` card count: the default when `limit` is absent, and the most a block may show. */
+export const LATEST_POSTS_DEFAULT_LIMIT = 3;
+export const LATEST_POSTS_MAX_LIMIT = 12;
+
 export const PROMO_TILE_PRESENTATIONS = Object.freeze([
   "overlay",
   "portrait-cards",

package/packages/public-runtime/src/extension-contract.ts

@@ -15,6 +15,8 @@ export {
   BLOCK_PALETTE_CURRENT_CONTRACT,
   BLOCK_PALETTE_SUPPORTED_CONTRACTS,
   FEATURED_PRODUCT_PRESENTATIONS,
+  LATEST_POSTS_DEFAULT_LIMIT,
+  LATEST_POSTS_MAX_LIMIT,
   PROMO_TILE_PRESENTATIONS,
   THEME_HEADING_LEVELS,
   imageSourceUrlRefusal,

package/packages/public-runtime/src/tenant.ts

@@ -524,6 +524,12 @@ export interface TenantConfig {
    * (declared-tenant-config.mjs), never as a literal.
    */
   currency: string;
+  /**
+   * The IANA time zone the store's days are counted in: the Orders "Today" total and the order
+   * times the admin shows. UTC unless `.tot/config.json` declares another; read it through
+   * `resolveStoreTimeZone` (declared-tenant-config.mjs), never as a literal.
+   */
+  timezone?: string;
   locale: string;
   /** Explicit publication spaces for this tenant, including one canonical root. */
   publicationSpaces?: readonly PublicationSpaceManifestV1[];

package/scripts/tenant/validate.mjs

@@ -34,6 +34,7 @@ import { listTenantDirIds, tenantDirSegments } from "../lib/tenant-dirs.mjs";
 import {
   BLOCK_PALETTE_SUPPORTED_CONTRACTS,
   FEATURED_PRODUCT_PRESENTATIONS,
+  LATEST_POSTS_MAX_LIMIT,
   PROMO_TILE_PRESENTATIONS,
   THEME_HEADING_LEVELS,
   isPageBlockImageReference,
@@ -364,6 +365,7 @@ const KNOWN_BLOCKS = new Set([
   "membership_band",
   "editorial",
   "newsletter",
+  "latest_posts",
   "marketing_hero",
   "trust_bar",
   "split_compare",
@@ -584,6 +586,20 @@ function validateEditorial(block, file, at, out) {
   }
 }
 
+function validateLatestPosts(block, file, at, out) {
+  if (block.limit !== undefined && (!Number.isInteger(block.limit) || block.limit < 1 || block.limit > LATEST_POSTS_MAX_LIMIT)) {
+    out.push(mk(ERROR, "block-prop", file, `${at}.limit must be a whole number from 1 to ${LATEST_POSTS_MAX_LIMIT}`));
+  }
+  for (const prop of ["eyebrow", "title", "tag", "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" && block.ctaHref.trim() && !isSafeStorefrontHref(block.ctaHref)) {
+    out.push(mk(ERROR, "navigation-href", file, `${at}.ctaHref must be a same-storefront root-relative path`));
+  }
+}
+
 function validateHomeDoc(doc, file, tenantId) {
   const out = [];
   if (doc == null || typeof doc !== "object" || Array.isArray(doc)) {
@@ -648,6 +664,7 @@ function validateHomeDoc(doc, file, tenantId) {
     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);
+    if (component === "latest_posts") validateLatestPosts(block, file, at, out);
   });
   return out;
 }