minutework 0.1.32 → 0.1.34

package/assets/templates/next-tenant-app/src/lib/content/adapter.server.test.ts

@@ -1,444 +0,0 @@
-import { mkdtemp, rm, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-
-import { afterEach, describe, expect, it, vi } from "vitest";
-
-import type {
-  BlogEntrySummary,
-  DocsEntrySummary,
-  MarketingPageKey,
-  PublicContentAdapter,
-  PublicContentKind,
-} from "@/lib/content/contracts";
-import { publicSiteFixtureSnapshot } from "@/lib/content/__fixtures__/public-site-snapshot";
-import {
-  MinuteWorkPublicSiteContentAdapter,
-  PUBLIC_CONTENT_REVALIDATE_SECONDS,
-  fetchPublicSiteSnapshotEnvelope,
-} from "@/lib/content/adapter.server";
-
-const originalEnv = { ...process.env };
-
-function jsonResponse(body: unknown, status = 200) {
-  return new Response(JSON.stringify(body), {
-    status,
-    headers: {
-      "content-type": "application/json",
-    },
-  });
-}
-
-function normalizeSlugParts(slugParts: readonly string[]) {
-  return slugParts.map((part) => part.trim().toLowerCase()).filter(Boolean).join("/");
-}
-
-function getFixtureMarketingPage(pageKey: MarketingPageKey) {
-  return (
-    publicSiteFixtureSnapshot.marketingPages.find((page) => page.pageKey === pageKey) ??
-    null
-  );
-}
-
-function getFixtureEntry(kind: PublicContentKind, slugParts: readonly string[]) {
-  return (
-    publicSiteFixtureSnapshot[kind].find(
-      (entry) => normalizeSlugParts(entry.slug) === normalizeSlugParts(slugParts),
-    ) ?? null
-  );
-}
-
-function toDocsEntrySummary(
-  entry: typeof publicSiteFixtureSnapshot.docs[number],
-): DocsEntrySummary {
-  return {
-    description: entry.description,
-    eyebrow: entry.eyebrow,
-    kind: entry.kind,
-    publishedAt: entry.publishedAt,
-    readingTime: entry.readingTime,
-    slug: entry.slug,
-    title: entry.title,
-  };
-}
-
-function toBlogEntrySummary(
-  entry: typeof publicSiteFixtureSnapshot.blog[number],
-): BlogEntrySummary {
-  return {
-    description: entry.description,
-    eyebrow: entry.eyebrow,
-    kind: entry.kind,
-    publishedAt: entry.publishedAt,
-    readingTime: entry.readingTime,
-    slug: entry.slug,
-    title: entry.title,
-  };
-}
-
-function getFixtureEntrySummaries(kind: "docs"): DocsEntrySummary[];
-function getFixtureEntrySummaries(kind: "blog"): BlogEntrySummary[];
-function getFixtureEntrySummaries(kind: PublicContentKind) {
-  if (kind === "docs") {
-    return publicSiteFixtureSnapshot.docs.map(toDocsEntrySummary);
-  }
-
-  return publicSiteFixtureSnapshot.blog.map(toBlogEntrySummary);
-}
-
-function createCustomAdapter(
-  overrides: Partial<PublicContentAdapter> = {},
-): PublicContentAdapter {
-  return {
-    async getSiteConfig() {
-      return publicSiteFixtureSnapshot.site;
-    },
-    async getMarketingPage(pageKey) {
-      return getFixtureMarketingPage(pageKey);
-    },
-    async listEntries(kind) {
-      return kind === "docs"
-        ? getFixtureEntrySummaries("docs")
-        : getFixtureEntrySummaries("blog");
-    },
-    async getEntry(kind, slugParts) {
-      return getFixtureEntry(kind, slugParts);
-    },
-    ...overrides,
-  };
-}
-
-function createEnvelope(
-  overrides: Partial<Awaited<ReturnType<typeof fetchPublicSiteSnapshotEnvelope>>> = {},
-) {
-  return {
-    environment: "preview" as const,
-    source_boundary: "runtime_preview" as const,
-    snapshot: publicSiteFixtureSnapshot,
-    ...overrides,
-  };
-}
-
-function restoreProcessEnv() {
-  for (const key of Object.keys(process.env)) {
-    if (!(key in originalEnv)) {
-      delete process.env[key];
-    }
-  }
-
-  Object.assign(process.env, originalEnv);
-}
-
-function applyServerEnv(overrides: Record<string, string | undefined>) {
-  restoreProcessEnv();
-  process.env.MW_PLATFORM_BASE_URL = "http://127.0.0.1:8000";
-  process.env.MW_PUBLIC_CONTENT_SOURCE = "minutework_cms";
-  process.env.MW_CONTENT_API_TOKEN = "test-content-token";
-  process.env.MW_PUBLIC_BASE_URL = "http://127.0.0.1:3000";
-  process.env.MW_PUBLIC_SITE_PROPERTY_KEY = "main-site";
-  process.env.MW_PUBLIC_SITE_ENV = "preview";
-  process.env.MW_ENABLE_RUNTIME_COMMAND_EXAMPLE = "false";
-
-  for (const [key, value] of Object.entries(overrides)) {
-    if (value === undefined) {
-      delete process.env[key];
-    } else {
-      process.env[key] = value;
-    }
-  }
-}
-
-describe("public content adapter", () => {
-  afterEach(() => {
-    restoreProcessEnv();
-    vi.unstubAllGlobals();
-    vi.resetModules();
-    vi.doUnmock("@/lib/content/custom-adapter");
-  });
-
-  it("loads a public-site snapshot envelope through a cacheable bearer-authenticated fetch", async () => {
-    const fetchMock = vi.fn().mockResolvedValue(jsonResponse(createEnvelope()));
-    vi.stubGlobal("fetch", fetchMock);
-
-    const envelope = await fetchPublicSiteSnapshotEnvelope({
-      contentApiToken: "content-token",
-      environment: "preview",
-      platformBaseUrl: "https://platform.example.com",
-      propertyKey: "main-site",
-    });
-
-    expect(envelope.snapshot.site.siteName).toBe("MinuteWork Combined Starter");
-    expect(fetchMock).toHaveBeenCalledWith(
-      "https://platform.example.com/api/v1/developer/public-site/snapshots/main-site/?environment=preview",
-      expect.objectContaining({
-        headers: {
-          accept: "application/json",
-          authorization: "Bearer content-token",
-        },
-        next: {
-          revalidate: PUBLIC_CONTENT_REVALIDATE_SECONDS,
-          tags: [
-            "public-site-content",
-            "public-site-content:main-site",
-            "public-site-content:preview",
-          ],
-        },
-      }),
-    );
-  });
-
-  it("rejects invalid environment and source-boundary combinations", async () => {
-    const fetchMock = vi.fn().mockResolvedValue(
-      jsonResponse(
-        createEnvelope({
-          environment: "live",
-          source_boundary: "runtime_preview",
-        }),
-      ),
-    );
-    vi.stubGlobal("fetch", fetchMock);
-
-    await expect(
-      fetchPublicSiteSnapshotEnvelope({
-        contentApiToken: "content-token",
-        environment: "live",
-        platformBaseUrl: "https://platform.example.com",
-        propertyKey: "main-site",
-      }),
-    ).rejects.toThrow("published_live");
-  });
-
-  it("accepts runtime_live for live runtime-served publications", async () => {
-    const fetchMock = vi.fn().mockResolvedValue(
-      jsonResponse(
-        createEnvelope({
-          environment: "live",
-          source_boundary: "runtime_live",
-        }),
-      ),
-    );
-    vi.stubGlobal("fetch", fetchMock);
-
-    await expect(
-      fetchPublicSiteSnapshotEnvelope({
-        contentApiToken: "content-token",
-        environment: "live",
-        platformBaseUrl: "https://platform.example.com",
-        propertyKey: "main-site",
-      }),
-    ).resolves.toMatchObject({
-      environment: "live",
-      source_boundary: "runtime_live",
-    });
-  });
-
-  it("maps MinuteWork public-site snapshots through the adapter interface", async () => {
-    const adapter = new MinuteWorkPublicSiteContentAdapter(async () =>
-      createEnvelope({
-        environment: "live",
-        source_boundary: "published_live",
-      }),
-    );
-
-    await expect(adapter.getMarketingPage("home")).resolves.toEqual(
-      publicSiteFixtureSnapshot.marketingPages[0],
-    );
-    await expect(adapter.listEntries("blog")).resolves.toEqual(
-      publicSiteFixtureSnapshot.blog,
-    );
-    await expect(
-      adapter.getEntry("blog", ["public-site-api-default"]),
-    ).resolves.toEqual(publicSiteFixtureSnapshot.blog[0]);
-  });
-
-  it("allows empty marketing-page snapshots from the default gateway adapter", async () => {
-    const adapter = new MinuteWorkPublicSiteContentAdapter(async () =>
-      createEnvelope({
-        snapshot: {
-          ...publicSiteFixtureSnapshot,
-          marketingPages: [],
-        },
-      }),
-    );
-
-    await expect(adapter.getMarketingPage("pricing")).resolves.toBeNull();
-  });
-
-  it("loads the default MinuteWork public-site path when no custom adapter is provided", async () => {
-    const fetchMock = vi.fn().mockResolvedValue(jsonResponse(createEnvelope()));
-    vi.stubGlobal("fetch", fetchMock);
-    applyServerEnv({});
-    vi.doMock("@/lib/content/custom-adapter", () => ({
-      resolveCustomPublicContentAdapter: () => null,
-    }));
-
-    const adapterModule = await import("./adapter.server");
-
-    await expect(adapterModule.getSiteConfig()).resolves.toEqual(
-      publicSiteFixtureSnapshot.site,
-    );
-    expect(fetchMock).toHaveBeenCalledTimes(1);
-  });
-
-  it("accepts valid custom adapter output through the shared contract wrapper", async () => {
-    applyServerEnv({
-      MW_PUBLIC_CONTENT_SOURCE: "custom",
-      MW_CONTENT_API_TOKEN: undefined,
-      MW_PUBLIC_SITE_PROPERTY_KEY: undefined,
-    });
-    vi.doMock("@/lib/content/custom-adapter", () => ({
-      resolveCustomPublicContentAdapter: () => createCustomAdapter(),
-    }));
-
-    const adapterModule = await import("./adapter.server");
-
-    await expect(adapterModule.getMarketingPage("pricing")).resolves.toEqual(
-      getFixtureMarketingPage("pricing"),
-    );
-    await expect(adapterModule.listEntries("blog")).resolves.toEqual(
-      getFixtureEntrySummaries("blog"),
-    );
-  });
-
-  it("requires an explicit adapter when MW_PUBLIC_CONTENT_SOURCE=custom", async () => {
-    applyServerEnv({
-      MW_PUBLIC_CONTENT_SOURCE: "custom",
-      MW_CONTENT_API_TOKEN: undefined,
-      MW_PUBLIC_SITE_PROPERTY_KEY: undefined,
-    });
-    vi.doMock("@/lib/content/custom-adapter", () => ({
-      resolveCustomPublicContentAdapter: () => null,
-    }));
-
-    const adapterModule = await import("./adapter.server");
-
-    expect(() => adapterModule.getPublicContentAdapter()).toThrow(
-      "MW_PUBLIC_CONTENT_SOURCE=custom requires resolveCustomPublicContentAdapter()",
-    );
-  });
-
-  it("loads valid static JSON public content", async () => {
-    const tempRoot = await mkdtemp(join(tmpdir(), "mw-public-content-"));
-    const contentPath = join(tempRoot, "public-site.json");
-
-    try {
-      await writeFile(
-        contentPath,
-        JSON.stringify(publicSiteFixtureSnapshot),
-        "utf8",
-      );
-      applyServerEnv({
-        MW_PUBLIC_CONTENT_SOURCE: "static_json",
-        MW_CONTENT_API_TOKEN: undefined,
-        MW_PUBLIC_SITE_PROPERTY_KEY: undefined,
-        MW_STATIC_PUBLIC_CONTENT_PATH: contentPath,
-      });
-
-      const adapterModule = await import("./adapter.server");
-
-      await expect(adapterModule.getMarketingPage("home")).resolves.toEqual(
-        getFixtureMarketingPage("home"),
-      );
-    } finally {
-      await rm(tempRoot, { force: true, recursive: true });
-    }
-  });
-
-  it("rejects invalid static JSON public content", async () => {
-    const tempRoot = await mkdtemp(join(tmpdir(), "mw-public-content-"));
-    const contentPath = join(tempRoot, "public-site.json");
-
-    try {
-      await writeFile(contentPath, JSON.stringify({ site: {} }), "utf8");
-      applyServerEnv({
-        MW_PUBLIC_CONTENT_SOURCE: "static_json",
-        MW_CONTENT_API_TOKEN: undefined,
-        MW_PUBLIC_SITE_PROPERTY_KEY: undefined,
-        MW_STATIC_PUBLIC_CONTENT_PATH: contentPath,
-      });
-
-      const adapterModule = await import("./adapter.server");
-
-      await expect(adapterModule.getSiteConfig()).rejects.toThrow(
-        "Static public content is invalid",
-      );
-    } finally {
-      await rm(tempRoot, { force: true, recursive: true });
-    }
-  });
-
-  it("keeps public content disabled for private-only mode", async () => {
-    applyServerEnv({
-      MW_PUBLIC_CONTENT_SOURCE: "none",
-      MW_CONTENT_API_TOKEN: undefined,
-      MW_PUBLIC_BASE_URL: undefined,
-      MW_PUBLIC_SITE_PROPERTY_KEY: undefined,
-    });
-
-    const adapterModule = await import("./adapter.server");
-
-    await expect(adapterModule.getSiteConfig()).rejects.toThrow(
-      "Public content is disabled",
-    );
-  });
-
-  it("rejects a custom adapter when a marketing page violates the canonical route contract", async () => {
-    applyServerEnv({
-      MW_PUBLIC_CONTENT_SOURCE: "custom",
-      MW_CONTENT_API_TOKEN: undefined,
-      MW_PUBLIC_SITE_PROPERTY_KEY: undefined,
-    });
-    vi.doMock("@/lib/content/custom-adapter", () => ({
-      resolveCustomPublicContentAdapter: () =>
-        createCustomAdapter({
-          async getMarketingPage(pageKey) {
-            const page = getFixtureMarketingPage(pageKey);
-
-            if (!page || pageKey !== "pricing") {
-              return page;
-            }
-
-            return {
-              ...page,
-              path: "/plans",
-            };
-          },
-        }),
-    }));
-
-    const adapterModule = await import("./adapter.server");
-
-    await expect(adapterModule.getMarketingPage("pricing")).rejects.toThrow(
-      '"pricing" marketing page must use the "/pricing" route.',
-    );
-  });
-
-  it("rejects a custom adapter when blog summaries use multi-segment slugs", async () => {
-    applyServerEnv({
-      MW_PUBLIC_CONTENT_SOURCE: "custom",
-      MW_CONTENT_API_TOKEN: undefined,
-      MW_PUBLIC_SITE_PROPERTY_KEY: undefined,
-    });
-    vi.doMock("@/lib/content/custom-adapter", () => ({
-      resolveCustomPublicContentAdapter: () =>
-        createCustomAdapter({
-          async listEntries(kind) {
-            if (kind !== "blog") {
-              return getFixtureEntrySummaries("docs");
-            }
-
-            return publicSiteFixtureSnapshot.blog.map((entry) => ({
-              ...toBlogEntrySummary(entry),
-              slug: ["release", "v1"],
-            })) as unknown as Awaited<ReturnType<PublicContentAdapter["listEntries"]>>;
-          },
-        }),
-    }));
-
-    const adapterModule = await import("./adapter.server");
-
-    await expect(adapterModule.listEntries("blog")).rejects.toThrow(
-      "Array must contain at most 1 element(s)",
-    );
-  });
-});