@decocms/apps-nuvemshop 7.75.0 → 7.77.0

package/src/utils/__tests__/sitemap.test.ts

@@ -0,0 +1,57 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import categoriesFixture from "../../__fixtures__/categories.json";
+import { clearNuvemshopCache, configureNuvemshop, setNuvemshopFetch } from "../../client";
+import { nuvemshopSitemap } from "../sitemap";
+
+const json = (body: unknown) =>
+  new Response(JSON.stringify(body), { headers: { "content-type": "application/json" } });
+const page = (n: number, total: number, handles: string[]) => ({
+  data: handles.map((handle, i) => ({
+    id: n * 100 + i,
+    handle,
+    updated_at: `2026-10-0${n}T10:00:00+0000`,
+  })),
+  pagination: { page: n, per_page: 200, total: 3, total_pages: total },
+});
+
+const fetchMock = vi.fn(async (input: string | URL | Request) => {
+  const url = new URL(String(input));
+  if (url.pathname.endsWith("/categories")) return json(categoriesFixture);
+  const p = Number(url.searchParams.get("page") ?? 1);
+  return json(p === 1 ? page(1, 2, ["camisa-a", "camisa-b&c"]) : page(2, 2, ["tenis-x"]));
+});
+
+beforeEach(() => {
+  fetchMock.mockClear();
+  clearNuvemshopCache();
+  configureNuvemshop({ storeId: "8336778" });
+  setNuvemshopFetch(fetchMock as unknown as typeof fetch);
+});
+
+describe("nuvemshopSitemap", () => {
+  it("pages through every product and lists categories with nested URLs", async () => {
+    const xml = await nuvemshopSitemap({ origin: "https://www.loja.example" });
+
+    const productCalls = fetchMock.mock.calls
+      .map(([u]) => new URL(String(u)))
+      .filter((u) => u.pathname.endsWith("/products"));
+    expect(productCalls.map((u) => u.searchParams.get("page"))).toEqual(["1", "2"]);
+    expect(productCalls[0].searchParams.get("per_page")).toBe("200");
+    expect(productCalls[0].searchParams.get("fields")).toBe("handle,updated_at");
+
+    expect(
+      xml.startsWith(
+        '<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
+      ),
+    ).toBe(true);
+    expect(xml).toContain(
+      "<url><loc>https://www.loja.example/produtos/camisa-a</loc><lastmod>2026-10-01</lastmod></url>",
+    );
+    expect(xml).toContain("<loc>https://www.loja.example/produtos/tenis-x</loc>");
+    expect(xml).toContain("<loc>https://www.loja.example/produtos/camisa-b&amp;c</loc>"); // XML-escaped
+    expect(xml).toContain("<url><loc>https://www.loja.example/calcados/masculino</loc></url>");
+    expect(xml).toContain("<url><loc>https://www.loja.example/</loc></url>");
+    expect(xml.match(/<url>/g)).toHaveLength(1 + categoriesFixture.data.length + 3);
+    expect(xml.trimEnd().endsWith("</urlset>")).toBe(true);
+  });
+});

package/src/utils/operationRouter.ts

@@ -1,5 +1,6 @@
 /**
- * URL → operation name for Nuvemshop Storefront API calls, plugged into
+ * URL → operation name for Nuvemshop egress (Storefront API, the store's own
+ * session endpoints, the Admin API and Turnstile), plugged into
  * `createInstrumentedFetch`'s `resolveOperation`. Returns `undefined` when
  * nothing matches so the framework falls back to `nuvemshop.fetch`.
  */
@@ -13,6 +14,11 @@ const MATCHERS: ReadonlyArray<[RegExp, string]> = [
   [/\/stores\/\d+\/categories\/[^/]+\/?$/, "categories.get"],
   [/\/stores\/\d+\/shipping-options\/?$/, "shipping.options"],
   [/\/stores\/\d+\/checkouts\/?$/, "checkout.create"],
+  [/^\/account\/login\/?$/, "store.account.login"],
+  [/^\/account\/logout\/?$/, "store.account.logout"],
+  [/^\/account\/?$/, "store.account.page"],
+  [/^\/v1\/\d+\/customers(\/\d+)?\/?$/, "admin.customers"],
+  [/^\/turnstile\/v0\/siteverify$/, "turnstile.verify"],
 ];
 
 export function nuvemshopOperationRouter(url: string, _method: string): string | undefined {

package/src/utils/sitemap.ts

@@ -0,0 +1,54 @@
+/**
+ * Product + category sitemap built from the Storefront API (which has no
+ * sitemap endpoint). URLs use the same paths as the loaders (`/produtos/<handle>`,
+ * `/<cat>/<sub>`), so they resolve without redirects. Serve it from a site route:
+ *
+ * ```ts
+ * // src/routes/sitemap[.]xml.ts
+ * GET: async ({ request }) => new Response(await nuvemshopSitemap({ origin: new URL(request.url).origin }),
+ *   { headers: { "content-type": "application/xml; charset=utf-8" } })
+ * ```
+ */
+import { nuvemshopGet } from "../client";
+import { categoryChain, categoryPath, productPath } from "./transform";
+import type { NuvemshopCategory, NuvemshopList } from "./types";
+
+// ponytail: one request per 200 products, sequential; split into a sitemap index if a catalog
+// ever outgrows the 50k-URL sitemap limit.
+const PER_PAGE = 200;
+
+const escapeXml = (s: string) =>
+  s
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;")
+    .replace(/"/g, "&quot;")
+    .replace(/'/g, "&apos;");
+const entry = (loc: string, lastmod?: string) =>
+  `<url><loc>${escapeXml(loc)}</loc>${lastmod ? `<lastmod>${lastmod.slice(0, 10)}</lastmod>` : ""}</url>`;
+
+export async function nuvemshopSitemap({ origin }: { origin: string }): Promise<string> {
+  const urls = [entry(`${origin}/`)];
+
+  const categories =
+    (await nuvemshopGet<NuvemshopList<NuvemshopCategory>>("/categories", { per_page: PER_PAGE }))
+      ?.data ?? [];
+  for (const c of categories)
+    urls.push(entry(`${origin}${categoryPath(categoryChain(c, categories))}`));
+
+  for (let page = 1, pages = 1; page <= pages; page++) {
+    const list = await nuvemshopGet<NuvemshopList<{ handle: string; updated_at?: string }>>(
+      "/products",
+      {
+        fields: "handle,updated_at",
+        per_page: PER_PAGE,
+        page,
+      },
+    );
+    if (!list) break;
+    pages = list.pagination.total_pages;
+    for (const p of list.data) urls.push(entry(`${origin}${productPath(p.handle)}`, p.updated_at));
+  }
+
+  return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${urls.join("\n")}\n</urlset>\n`;
+}