@tokenoftrust/storefront-runner 2.4.77 → 2.4.79

package/apps/storefront/src/lib/seo/documentTitle.ts

@@ -12,6 +12,17 @@
  * posts pass it as `title`: one that names the store ("… - Prime Vapor Club")
  * renders as written, any other is suffixed.
  */
+/**
+ * A product's or collection's own catalog SEO title, as the `seoTitle` to render verbatim, when
+ * the tenant declares `seo.verbatimCatalogTitles`; otherwise undefined, so it is suffixed.
+ */
+export function catalogSeoTitle(
+  seo: { verbatimCatalogTitles?: boolean } | undefined,
+  ownSeoTitle: string | undefined,
+): string | undefined {
+  return seo?.verbatimCatalogTitles && ownSeoTitle?.trim() ? ownSeoTitle : undefined;
+}
+
 export function documentTitle(title: string, seoTitle: string | undefined, storeName: string): string {
   const verbatim = seoTitle?.trim();
   if (verbatim) return verbatim;

package/apps/storefront/src/pages/collections/[handle].astro

@@ -19,6 +19,7 @@ import { parseQuery, buildQueryString } from "@/lib/url";
 import { breadcrumbLd, itemListLd } from "@/lib/jsonld";
 import { truncate } from "@/lib/format";
 import { pageUrlForm } from "@/lib/seo/urlForm";
+import { catalogSeoTitle } from "@/lib/seo/documentTitle";
 import { withBase } from "@/lib/basePath";
 import { isBlankDescriptionHtml, sanitizeDescriptionHtml } from "@/lib/content/sanitizeDescriptionHtml";
 
@@ -91,6 +92,7 @@ if (query.priceMin != null || query.priceMax != null) {
 
 <Layout
   title={collection.seo.title || collection.title}
+  seoTitle={catalogSeoTitle(tenant.seo, collection.seo.title)}
   description={collection.seo.description || (desc ? truncate(desc, 160) : `Shop ${collection.title} at ${tenant.displayName}.`)}
   path={basePath}
   noindex={isEmptyCollection}

package/apps/storefront/src/pages/products/[handle].astro

@@ -47,6 +47,7 @@ import { isUsableImageUrl } from "@/lib/placeholder";
 import { withBase } from "@/lib/basePath";
 import { productPageType, structuredDataProfile } from "@/lib/seo/structuredData";
 import { pageUrlForm } from "@/lib/seo/urlForm";
+import { catalogSeoTitle } from "@/lib/seo/documentTitle";
 import { shippingPolicyPath } from "@/lib/commerce/shippingPolicy";
 import AppWidgetFrame from "@/components/apps/AppWidgetFrame.astro";
 import { getRegistryService } from "@/lib/apps/registryAccess.js";
@@ -313,6 +314,7 @@ const structuredData = {
 
 <Layout
   title={product.seo.title || product.title}
+  seoTitle={catalogSeoTitle(tenant.seo, product.seo.title)}
   description={product.seo.description || truncate(product.description_text, 160)}
   path={`/products/${product.handle}`}
   ogType="product"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenoftrust/storefront-runner",
-  "version": "2.4.77",
+  "version": "2.4.79",
   "license": "SEE LICENSE IN LICENSE",
   "description": "World-shareable storefront runner: multi-tenant renderer on Astro/Cloudflare. No control plane.",
   "packageManager": "pnpm@11.9.0",

package/packages/cli/src/declared-config.mjs

@@ -31,7 +31,7 @@ export const FEATURE_KEYS = [
 export const SITE_TYPES = ["commerce", "marketing"];
 
 /** Every `seo` key (mirrors packages/public-runtime/src/declared-tenant-config.mjs). */
-export const SEO_KEYS = Object.freeze(["trailingSlash", "structuredData"]);
+export const SEO_KEYS = Object.freeze(["trailingSlash", "verbatimCatalogTitles", "structuredData"]);
 
 /** Every `seo.structuredData` key. */
 export const STRUCTURED_DATA_KEYS = Object.freeze(["graphs", "names", "reviews", "onlyOn"]);
@@ -86,6 +86,9 @@ export function seoDeclarationProblems(seo) {
   if (source.trailingSlash !== undefined && typeof source.trailingSlash !== "boolean") {
     problems.push("`seo.trailingSlash` must be true or false");
   }
+  if (source.verbatimCatalogTitles !== undefined && typeof source.verbatimCatalogTitles !== "boolean") {
+    problems.push("`seo.verbatimCatalogTitles` must be true or false");
+  }
   const sd = source.structuredData;
   if (sd === undefined) return problems;
   if (!isPlainObject(sd)) return [...problems, "`seo.structuredData` must be an object"];

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

@@ -75,7 +75,7 @@ export const FEATURE_KEYS = Object.freeze([
 export const SITE_TYPES_LIST = Object.freeze(["commerce", "marketing"]);
 
 /** Every `seo` key (SeoDeclaration, tenant.ts). */
-export const SEO_KEYS = Object.freeze(["trailingSlash", "structuredData"]);
+export const SEO_KEYS = Object.freeze(["trailingSlash", "verbatimCatalogTitles", "structuredData"]);
 
 /** Every `seo.structuredData` key. */
 export const STRUCTURED_DATA_KEYS = Object.freeze(["graphs", "names", "reviews", "onlyOn"]);
@@ -132,6 +132,9 @@ export function seoDeclarationProblems(seo) {
   if (source.trailingSlash !== undefined && typeof source.trailingSlash !== "boolean") {
     problems.push("`seo.trailingSlash` must be true or false");
   }
+  if (source.verbatimCatalogTitles !== undefined && typeof source.verbatimCatalogTitles !== "boolean") {
+    problems.push("`seo.verbatimCatalogTitles` must be true or false");
+  }
   const sd = source.structuredData;
   if (sd === undefined) return problems;
   if (!isPlainObject(sd)) return [...problems, "`seo.structuredData` must be an object"];

package/packages/public-runtime/src/product-details.ts

@@ -47,9 +47,37 @@ const DEFAULT_SPEC_HEADING = "Product Details";
 const DEFAULT_FAQ_HEADING = "Frequently Asked Questions";
 const DEFAULT_BOX_CONTENTS_LABEL = "What's in the box";
 
+/**
+ * True for a metafield that carries an unresolved platform reference rather
+ * than displayable content — a Shopify metaobject/product/variant/file/
+ * collection/page reference (bare or `list.*`), surfaced either through its
+ * declared `type` or, when type is absent/untrusted, through the `gid://`
+ * shape of its value itself (bare or as a JSON array of them, the `list.*`
+ * on-disk form). No declared section may render one: a raw `gid://...`
+ * identifier is never product content, no matter which section asked for it.
+ */
+function isUnresolvedReference(m: Metafield): boolean {
+  if (m.type && /_reference$/.test(m.type)) return true;
+  const v = m.value?.trim();
+  if (!v) return false;
+  if (v.startsWith("gid://")) return true;
+  if (v.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(v);
+      if (Array.isArray(parsed) && parsed.length > 0 && parsed.every((x) => typeof x === "string" && x.startsWith("gid://"))) {
+        return true;
+      }
+    } catch {
+      /* not JSON — fall through, not a reference by this check */
+    }
+  }
+  return false;
+}
+
 function metafieldLookup(metafields: readonly Metafield[]): (namespace: string, key: string) => string | undefined {
   const map = new Map<string, string>();
   for (const m of metafields) {
+    if (isUnresolvedReference(m)) continue;
     const v = m.value?.trim();
     if (v) map.set(`${m.namespace}.${m.key}`, v);
   }

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

@@ -777,6 +777,12 @@ export interface SeoDeclaration {
    * `/` (`/products/foo/`). Absent or false ⇒ no trailing slash (`/products/foo`).
    */
   trailingSlash?: boolean;
+  /**
+   * A product's or collection's own catalog SEO title is the complete `<title>`, rendered as
+   * written (a source that already ends its titles in "| Brand"). Absent or false ⇒ it is
+   * suffixed with the store name like any other page title.
+   */
+  verbatimCatalogTitles?: boolean;
   /**
    * The structured-data profile. When present it is the ONLY JSON-LD a declared page type
    * emits: one `@graph` holding exactly the listed nodes, in order. A node whose data the