sailfork / t3code-github / .repos/ alchemy-effect/ packages/ integration-tests/ test/ Cloudflare/ Workers/ CacheCf.local.test.ts

import * as Cloudflare from "@alchemy.run/cloudflare";
import { expect } from "@alchemy.run/test";
import * as Test from "@alchemy.run/test/Alchemy";
import * as Data from "effect/Data";
import * as Effect from "effect/Effect";
import * as HttpClient from "effect/http/HttpClient";
import { MinimumLogLevel } from "effect/References";
import * as Schedule from "effect/Schedule";
import * as pathe from "pathe";

const { test } = Test.make({
  providers: Cloudflare.providers(),
  dev: true,
});

const logLevel = Effect.provideService(MinimumLogLevel, process.env.DEBUG ? "Debug" : "Info");

class WorkerNotReady extends Data.TaggedError("WorkerNotReady")<{
  status: number;
}> {}

const getJsonReady = (url: string) =>
  Effect.gen(function* () {
    const client = yield* HttpClient.HttpClient;
    const res = yield* client.get(url).pipe(
      Effect.flatMap((res) =>
        res.status === 200
          ? Effect.succeed(res)
          : Effect.fail(new WorkerNotReady({ status: res.status })),
      ),
      Effect.retry({
        while: (e): e is WorkerNotReady => e instanceof WorkerNotReady,
        // Cap the backoff: an uncapped exponential over 10 recurs sums to
        // ~8.5 minutes and turns a persistent non-200 into an apparent hang.
        schedule: Schedule.max([
          Schedule.min([Schedule.exponential("500 millis"), Schedule.spaced("2 seconds")]),
          Schedule.recurs(10),
        ]),
      }),
    );
    return yield* res.json;
  }).pipe(Effect.orDie);

/**
 * The local runtime ships an always-on Cache API simulator
 * (`caches.default` persisted under `.alchemy/local/cache`) and builds
 * `request.cf` from a fallback blob in the entry middleware. Neither needs
 * any alchemy-side wiring — this pins that both actually work for a worker
 * deployed by the local provider.
 */
test.provider(
  "Cache API and request.cf work under the local runtime",
  (stack) =>
    Effect.gen(function* () {
      yield* stack.destroy();

      const deployed = yield* stack.deploy(
        Effect.gen(function* () {
          const worker = yield* Cloudflare.Worker("cache-cf-worker", {
            main: pathe.resolve(import.meta.dirname, "fixtures/cache-cf/worker.ts"),
          });
          return { worker };
        }),
      );
      const url = deployed.worker.url!;

      // The local provider serves from the dev proxy — proof no cloud call
      // ran.
      expect(url).toMatch(/^http:\/\/localhost:\d+$/);

      // request.cf: the middleware injects Miniflare's static fallback blob,
      // so `colo`/`country` are present without any configuration.
      const cf = (yield* getJsonReady(`${url}/cf`)) as {
        colo: string | null;
        country: string | null;
        clientAcceptEncoding: string | null;
      };
      expect(cf.colo).toBeTruthy();
      expect(cf.country).toBeTruthy();

      // Cache API: first request misses and populates, second hits. The
      // simulator's storage persists across runs, so use a per-run key.
      const cacheKey = crypto.randomUUID();
      const first = (yield* getJsonReady(`${url}/cache?key=${cacheKey}`)) as {
        hit: boolean;
        body: string;
      };
      expect(first.hit).toBe(false);
      expect(first.body).toBe("cached-body");

      const second = (yield* getJsonReady(`${url}/cache?key=${cacheKey}`)) as {
        hit: boolean;
        body: string;
      };
      expect(second.hit).toBe(true);
      expect(second.body).toBe("cached-body");

      yield* stack.destroy();
    }).pipe(logLevel),
  {
    tags: ["provider:cloudflare", "provider:cloudflare:worker", "local"],
    timeout: 120_000,
  },
);

/**
 * `dev: { cache: false }` turns every Cache API operation into a no-op
 * (matching production workers.dev), and `dev: { cf }` overrides the
 * `request.cf` blob served to this Worker.
 */
test.provider(
  "dev.cache=false disables the Cache API and dev.cf overrides request.cf",
  (stack) =>
    Effect.gen(function* () {
      yield* stack.destroy();

      const deployed = yield* stack.deploy(
        Effect.gen(function* () {
          const worker = yield* Cloudflare.Worker("cache-off-worker", {
            main: pathe.resolve(import.meta.dirname, "fixtures/cache-cf/worker.ts"),
            dev: {
              cache: false,
              cf: { colo: "TST", country: "XX" },
            },
          });
          return { worker };
        }),
      );
      const url = deployed.worker.url!;

      // The overridden blob is served verbatim.
      const cf = (yield* getJsonReady(`${url}/cf`)) as {
        colo: string | null;
        country: string | null;
      };
      expect(cf.colo).toBe("TST");
      expect(cf.country).toBe("XX");

      // With the cache disabled, every request misses — the put is a no-op.
      const first = (yield* getJsonReady(`${url}/cache`)) as { hit: boolean };
      const second = (yield* getJsonReady(`${url}/cache`)) as { hit: boolean };
      expect(first.hit).toBe(false);
      expect(second.hit).toBe(false);

      yield* stack.destroy();
    }).pipe(logLevel),
  {
    tags: ["provider:cloudflare", "provider:cloudflare:worker", "local"],
    timeout: 120_000,
  },
);