sailfork / t3code-github / .repos/ alchemy-effect/ packages/ cloudflare-runtime/ src/ rolldown/ test/ nodejs-compat.test.ts

import { fileURLToPath } from "node:url";
import { assert, describe, expect, it } from "vitest";
import { createMiniflareFromRolldown } from "../../../../cloudflare-test-tools/src/miniflare/miniflare.ts";
import cloudflare from "../plugin.ts";
import { toPosixPath } from "../utils.ts";
import { buildFixture } from "./utils/build-fixture.ts";

describe("nodejs_compat", () => {
  it("rewrites external CommonJS requires when compatibility enables Node by date", () => {
    const plugins = cloudflare({ compatibilityDate: "2026-08-31" });

    expect(plugins[0]?.name).toBe("builtin:esm-external-require");
  });

  it("can omit the external require rewrite for single-module internal workers", () => {
    const plugins = cloudflare({
      compatibilityDate: "2026-08-31",
      externalRequire: false,
    });

    expect(plugins[0]?.name).not.toBe("builtin:esm-external-require");
  });

  it("runs node builtin imports with nodejs_compat enabled", async () => {
    const built = await buildFixture({
      fixture: "node-compat/index.ts",
      pluginOptions: {
        compatibilityDate: "2025-07-01",
        compatibilityFlags: ["nodejs_compat"],
      },
    });

    await using miniflare = await createMiniflareFromRolldown(built.output, {
      compatibilityDate: "2025-07-01",
      compatibilityFlags: ["nodejs_compat"],
    });

    expect(await miniflare.fetchText("/")).toBe("OK!");
  });

  it("creates and injects virtual globals for nodejs_compat entries", async () => {
    const plugins = cloudflare({
      compatibilityDate: "2025-07-01",
      compatibilityFlags: ["nodejs_compat"],
    }) as Array<{
      name: string;
      resolveId?: { handler?: (...args: Array<unknown>) => unknown };
      load?: { handler?: (...args: Array<unknown>) => unknown };
      transform?: (code: string, id: string) => string | undefined;
      buildStart?: (options: { plugins: Array<unknown> }) => void;
    }>;

    const virtualModulesPlugin = plugins.find(
      (plugin) => plugin?.name === "distilled-cloudflare:virtual-modules",
    );

    assert(virtualModulesPlugin, "virtualModulesPlugin is not defined");

    virtualModulesPlugin.buildStart?.({ plugins: plugins.filter(Boolean) });

    const resolved = virtualModulesPlugin.resolveId?.handler?.("\0distilled:inject:process");
    expect(resolved).toEqual({ id: "\0distilled:inject:process" });

    const loaded = virtualModulesPlugin.load?.handler?.("\0distilled:inject:process");
    expect(loaded).toContain("globalThis.process = process;");

    const transformed = virtualModulesPlugin?.load?.handler?.(
      "\0distilled:worker-entry:test/fixtures/node-compat/index.ts",
    );

    expect(transformed).toContain(
      `import "${toPosixPath(fileURLToPath(import.meta.resolve("@cloudflare/unenv-preset/polyfill/performance")))}";`,
    );
    expect(transformed).toContain('import "\0distilled:inject:process";');
  });

  it("warns when unresolved Node builtins are imported without nodejs_compat", async () => {
    const plugins = cloudflare({
      compatibilityDate: "2025-07-01",
    });

    const nodejsImportWarningPlugin = plugins.find(
      (plugin) => plugin?.name === "distilled-cloudflare:nodejs-import-warning",
    ) as unknown as {
      buildStart: () => void;
      resolveId: { handler: (...args: Array<any>) => unknown };
      buildEnd: () => void;
    };

    const warnings: Array<string> = [];
    nodejsImportWarningPlugin?.buildStart?.call({});

    await nodejsImportWarningPlugin?.resolveId?.handler?.call(
      {},
      "node:fs",
      "test/fixtures/example-a.ts",
      {},
    );
    await nodejsImportWarningPlugin?.resolveId?.handler?.call(
      {},
      "node:fs",
      "test/fixtures/example-b.ts",
      {},
    );

    nodejsImportWarningPlugin?.buildEnd?.call({
      warn(message: string) {
        warnings.push(message);
      },
      getModuleInfo() {
        return {};
      },
    });

    expect(warnings).toHaveLength(1);
    expect(warnings[0]).toContain("Unexpected Node.js imports.");
    expect(warnings[0]).toContain('Do you need to enable the "nodejs_compat" compatibility flag?');
    expect(warnings[0]).toContain("https://developers.cloudflare.com/workers/runtime-apis/nodejs/");
    expect(warnings[0]).toContain('- "node:fs" imported from "test/fixtures/example-a.ts"');
    expect(warnings[0]).toContain('- "node:fs" imported from "test/fixtures/example-b.ts"');
  });
});