@decocms/apps 0.20.1

package/vtex/utils/sitemap.ts

@@ -0,0 +1,133 @@
+/**
+ * VTEX Sitemap utility.
+ *
+ * Fetches product and category URLs from VTEX's sitemap API
+ * and converts them to SitemapEntry format for composition
+ * with the CMS sitemap generator.
+ */
+
+import { getVtexConfig, vtexFetchResponse, vtexHost } from "../client";
+
+export interface SitemapEntry {
+  loc: string;
+  lastmod?: string;
+  changefreq?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+  priority?: number;
+}
+
+/**
+ * Fetch sitemap entries from VTEX's sitemap API.
+ *
+ * VTEX exposes /sitemap.xml which contains links to sub-sitemaps
+ * (products, categories, brands, etc.). This function fetches the
+ * main sitemap index and extracts all <loc> entries from the
+ * referenced sub-sitemaps.
+ *
+ * @param origin - The storefront origin (e.g., "https://www.mystore.com")
+ * @param options.maxDepth - How many levels of sub-sitemaps to follow (default: 1)
+ * @param options.rewriteHost - Whether to rewrite VTEX hostnames to the storefront origin (default: true)
+ */
+export async function getVtexSitemapEntries(
+  origin: string,
+  options?: {
+    maxDepth?: number;
+    rewriteHost?: boolean;
+    includeBrands?: boolean;
+    includeCategories?: boolean;
+    includeProducts?: boolean;
+  },
+): Promise<SitemapEntry[]> {
+  const config = getVtexConfig();
+  const vtexSitemapHost = vtexHost("vtexcommercestable", config);
+  const rewrite = options?.rewriteHost !== false;
+  const includeProducts = options?.includeProducts !== false;
+  const includeCategories = options?.includeCategories !== false;
+  const includeBrands = options?.includeBrands !== false;
+
+  try {
+    const mainSitemapUrl = `https://${vtexSitemapHost}/sitemap.xml`;
+    const mainResponse = await vtexFetchResponse(mainSitemapUrl);
+    const mainXml = await mainResponse.text();
+
+    const subSitemapUrls = extractLocs(mainXml);
+    const entries: SitemapEntry[] = [];
+
+    const filteredUrls = subSitemapUrls.filter((url) => {
+      const lower = url.toLowerCase();
+      if (!includeProducts && lower.includes("product")) return false;
+      if (!includeCategories && lower.includes("categor")) return false;
+      if (!includeBrands && lower.includes("brand")) return false;
+      return true;
+    });
+
+    const maxDepth = options?.maxDepth ?? 1;
+    if (maxDepth < 1) {
+      return filteredUrls.map((url) => ({
+        loc: rewrite ? rewriteUrl(url, vtexSitemapHost, origin) : url,
+        changefreq: "daily" as const,
+        priority: 0.5,
+      }));
+    }
+
+    const settled = await Promise.allSettled(
+      filteredUrls.map(async (subUrl) => {
+        try {
+          const resp = await vtexFetchResponse(subUrl);
+          const xml = await resp.text();
+          return extractLocs(xml);
+        } catch {
+          return [];
+        }
+      }),
+    );
+
+    const today = new Date().toISOString().split("T")[0];
+
+    for (const result of settled) {
+      if (result.status !== "fulfilled") continue;
+      for (const loc of result.value) {
+        entries.push({
+          loc: rewrite ? rewriteUrl(loc, vtexSitemapHost, origin) : loc,
+          lastmod: today,
+          changefreq: "daily",
+          priority: 0.5,
+        });
+      }
+    }
+
+    return entries;
+  } catch (error) {
+    console.error("[VTEX Sitemap] Failed to fetch VTEX sitemap:", error);
+    return [];
+  }
+}
+
+function extractLocs(xml: string): string[] {
+  const locs: string[] = [];
+  const regex = /<loc>\s*(.*?)\s*<\/loc>/g;
+  let match: RegExpExecArray | null;
+  while ((match = regex.exec(xml)) !== null) {
+    if (match[1]) locs.push(match[1].trim());
+  }
+  return locs;
+}
+
+function rewriteUrl(url: string, vtexSitemapHost: string, origin: string): string {
+  try {
+    const parsed = new URL(url);
+    const originParsed = new URL(origin);
+    const config = getVtexConfig();
+    const domain = config.domain ?? "com.br";
+    if (
+      parsed.hostname === vtexSitemapHost ||
+      parsed.hostname.endsWith(`.vtexcommercestable.${domain}`)
+    ) {
+      parsed.protocol = originParsed.protocol;
+      parsed.hostname = originParsed.hostname;
+      parsed.port = originParsed.port;
+    }
+    return parsed.toString();
+  } catch {
+    return url.replace(`https://${vtexSitemapHost}`, origin);
+  }
+}

package/vtex/utils/slugCache.ts

@@ -0,0 +1,32 @@
+/**
+ * In-flight dedup + SWR cache for VTEX Legacy Catalog slug→product lookups.
+ *
+ * Multiple loaders on the same page (PDP, relatedProducts x3, BuyTogether)
+ * all call `/api/catalog_system/pub/products/search/{slug}/p` for the same slug.
+ * This module routes through vtexCachedFetch which provides in-flight dedup
+ * and stale-while-revalidate caching (3 min TTL for 200 responses).
+ */
+import { getVtexConfig, vtexCachedFetch } from "../client";
+import type { LegacyProduct } from "./types";
+
+export function searchBySlug(
+	linkText: string,
+): Promise<LegacyProduct[] | null> {
+	const config = getVtexConfig();
+	const sc = config.salesChannel;
+	const scParam = sc ? `?sc=${sc}` : "";
+
+	return vtexCachedFetch<LegacyProduct[]>(
+		`/api/catalog_system/pub/products/search/${encodeURIComponent(linkText)}/p${scParam}`,
+	).catch((err) => {
+		console.error(`[VTEX] searchBySlug error for "${linkText}":`, err);
+		return null;
+	});
+}
+
+export async function resolveProductIdBySlug(
+	linkText: string,
+): Promise<string | null> {
+	const products = await searchBySlug(linkText);
+	return products?.length ? products[0].productId : null;
+}

package/vtex/utils/slugify.ts

@@ -0,0 +1,13 @@
+const mapped = JSON.parse(
+  `{"Á":"A","Ä":"A","Â":"A","À":"A","Ã":"A","Å":"A","Č":"C","Ç":"C","Ć":"C","Ď":"D","É":"E","Ě":"E","Ë":"E","È":"E","Ê":"E","Ẽ":"E","Ĕ":"E","Ȇ":"E","Í":"I","Ì":"I","Î":"I","Ï":"I","Ň":"N","Ñ":"N","Ó":"O","Ö":"O","Ò":"O","Ô":"O","Õ":"O","Ø":"O","Ř":"R","Ŕ":"R","Š":"S","Ť":"T","Ú":"U","Ů":"U","Ü":"U","Ù":"U","Û":"U","Ý":"Y","Ÿ":"Y","Ž":"Z","á":"a","ä":"a","â":"a","à":"a","ã":"a","å":"a","č":"c","ç":"c","ć":"c","ď":"d","é":"e","ě":"e","ë":"e","è":"e","ê":"e","ẽ":"e","ĕ":"e","ȇ":"e","í":"i","ì":"i","î":"i","ï":"i","ň":"n","ñ":"n","ó":"o","ö":"o","ò":"o","ô":"o","õ":"o","ø":"o","ð":"o","ř":"r","ŕ":"r","š":"s","ť":"t","ú":"u","ů":"u","ü":"u","ù":"u","û":"u","ý":"y","ÿ":"y","ž":"z","þ":"b","Þ":"B","Đ":"D","đ":"d","ß":"B","Æ":"A","a":"a"}`,
+);
+
+export const slugify = (str: string) =>
+  str
+    .replace(/,/g, "")
+    .replace(/[·/_,:]/g, "-")
+    .replace(/[*+~.()'"!:@&\[\]`/ %$#?{}|><=_^]/g, "-")
+    .split("")
+    .map((char) => mapped[char] ?? char)
+    .join("")
+    .toLowerCase();