cloudflare__vinext/tests/pregenerated-concrete-paths.test.ts

import { describe, it, expect, afterEach } from "vite-plus/test";
import {
  clearPregeneratedConcretePaths,
  addPregeneratedConcretePath,
  getRenderedConcreteUrlPathsForRoute,
  initPregeneratedPathsFromGlobals,
  normalizePregeneratedPathname,
} from "../packages/vinext/src/server/pregenerated-concrete-paths.js";
import { isFallbackShellArtifactPath } from "../packages/vinext/src/server/prerender-manifest.js";

describe("pregenerated concrete paths", () => {
  afterEach(() => {
    clearPregeneratedConcretePaths();
  });

  it("returns undefined for an unknown route pattern", () => {
    expect(getRenderedConcreteUrlPathsForRoute("/en/blog/:slug")).toBeUndefined();
  });

  it("stores and retrieves pathnames for a route pattern", () => {
    addPregeneratedConcretePath("/:locale/blog/:slug", "/en/blog/hello");
    addPregeneratedConcretePath("/:locale/blog/:slug", "/fr/blog/bonjour");

    const paths = getRenderedConcreteUrlPathsForRoute("/:locale/blog/:slug");
    expect(paths).toBeDefined();
    expect([...paths!]).toEqual(["/en/blog/hello", "/fr/blog/bonjour"]);
  });

  it("supports independent route patterns", () => {
    addPregeneratedConcretePath("/:locale/blog/:slug", "/en/blog/hello");
    addPregeneratedConcretePath("/products/:id", "/products/42");

    expect([...getRenderedConcreteUrlPathsForRoute("/:locale/blog/:slug")!]).toEqual([
      "/en/blog/hello",
    ]);
    expect([...getRenderedConcreteUrlPathsForRoute("/products/:id")!]).toEqual(["/products/42"]);
  });

  it("returns an empty state after clear", () => {
    addPregeneratedConcretePath("/en/blog/:slug", "/en/blog/persistent");
    expect(getRenderedConcreteUrlPathsForRoute("/en/blog/:slug")).toBeDefined();

    clearPregeneratedConcretePaths();

    expect(getRenderedConcreteUrlPathsForRoute("/en/blog/:slug")).toBeUndefined();
  });

  it("clears stale paths from a previous build on re-population (issue 3)", () => {
    // Build A
    addPregeneratedConcretePath("/en/blog/:slug", "/en/blog/old");
    addPregeneratedConcretePath("/en/blog/:slug", "/en/blog/also-old");
    expect(getRenderedConcreteUrlPathsForRoute("/en/blog/:slug")!.size).toBe(2);

    // Build B — clear and re-seed without the old paths
    clearPregeneratedConcretePaths();
    addPregeneratedConcretePath("/en/blog/:slug", "/en/blog/new");

    const paths = getRenderedConcreteUrlPathsForRoute("/en/blog/:slug")!;
    expect(paths.has("/en/blog/old")).toBe(false);
    expect(paths.has("/en/blog/also-old")).toBe(false);
    expect(paths.has("/en/blog/new")).toBe(true);
    expect(paths.size).toBe(1);
  });

  it("normalizes percent-encoded pathnames", () => {
    expect(normalizePregeneratedPathname("/en/blog/hello%20world")).toBe("/en/blog/hello world");
  });

  it("normalizes pathnames when adding concrete paths", () => {
    addPregeneratedConcretePath("/:locale/blog/:slug", "/en/blog/hello%20world");

    expect([...getRenderedConcreteUrlPathsForRoute("/:locale/blog/:slug")!]).toEqual([
      "/en/blog/hello world",
    ]);
  });

  it("initializes from the Worker global concrete-path table", () => {
    globalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS = [
      ["/:locale/blog/:slug", ["/en/blog/hello%20world"]],
    ];
    initPregeneratedPathsFromGlobals();
    delete globalThis.__VINEXT_PREGENERATED_CONCRETE_PATHS;

    expect([...getRenderedConcreteUrlPathsForRoute("/:locale/blog/:slug")!]).toEqual([
      "/en/blog/hello world",
    ]);
  });

  describe("isFallbackShellArtifactPath", () => {
    it("identifies fallback shells when fallback === true", () => {
      expect(
        isFallbackShellArtifactPath("/en/blog/[slug]", {
          route: "/en/blog/:slug",
          fallback: true,
          status: "rendered",
          router: "app",
        }),
      ).toBe(true);
    });

    it("identifies concrete paths even with brackets when fallback === false", () => {
      expect(
        isFallbackShellArtifactPath("/en/blog/[draft]-post", {
          route: "/en/blog/:slug",
          fallback: false,
          status: "rendered",
          router: "app",
        }),
      ).toBe(false);
    });

    it("falls back to bracket checks when fallback is undefined (legacy manifests)", () => {
      expect(
        isFallbackShellArtifactPath("/en/blog/[slug]", {
          route: "/en/blog/:slug",
          status: "rendered",
          router: "app",
        }),
      ).toBe(true);

      expect(
        isFallbackShellArtifactPath("/en/blog/hello", {
          route: "/en/blog/:slug",
          status: "rendered",
          router: "app",
        }),
      ).toBe(false);
    });
  });
});