sailfork / t3code-github / .repos/ alchemy-effect/ packages/ cloudflare/ src/ KV/ NamespaceLocal.ts

import * as Effect from "effect/Effect";
import type * as HttpClient from "effect/http/HttpClient";
import { CloudflareEnvironment } from "../CloudflareEnvironment.ts";
import type { Credentials } from "../Credentials.ts";
import { dispatchByMode } from "../LocalGateway.ts";
import type { InstantNamespace } from "./InstantNamespace.ts";
import { makeProxyKVNamespaceHelpers } from "./LocalKVGateway.ts";
import type { Namespace } from "./Namespace.ts";
import type { makeKVNamespaceHelpers } from "./NamespaceBinding.ts";
import type { KVAuth } from "./NamespaceHttp.ts";

/**
 * Shared scaffolding for the `*Local` KV services.
 *
 * Instead of minting a scoped {@link AccountApiToken} (the `*Http` path) or
 * resolving a native Worker binding (the `*Binding` path), it captures the
 * ambient current-credentials context available during stack-eval and
 * builds the client per resolved namespace id:
 *
 * - a REAL id gets the HTTP client (same builders as the `*Http` variant,
 *   authorized with the current credentials — no `host.bind`, no minted
 *   token);
 * - a `dev:` id (local emulation under `alchemy dev`) gets the native
 *   binding client (same builders as the `*Binding` variant) over a scoped
 *   platform-proxy gateway (see `LocalKVGateway.ts`).
 *
 * The id resolves lazily at apply time, so the returned client dispatches
 * per call.
 *
 * NOT exported from `index.ts` — this is internal scaffolding shared by the
 * three access-level Local layers.
 */
export const makeLocalKVNamespaceBinding = <Client extends object>(options: {
  makeHttpClient: (auth: KVAuth, namespaceId: Effect.Effect<string>) => Client;
  makeNativeClient: (helpers: ReturnType<typeof makeKVNamespaceHelpers>) => Client;
}) =>
  Effect.gen(function* () {
    // Capture the account resolver without authenticating. Only the HTTP
    // branch evaluates it; native local clients need no cloud credentials.
    // Credentials are ambient during stack-eval (the stack's
    // providers layer). Capture the full context so KV HTTP ops can run with
    // the current credentials — no `host.bind`, no minted token.
    const environment = yield* CloudflareEnvironment;
    const context = yield* Effect.context<Credentials | HttpClient.HttpClient>();
    // The FULL ambient context, for the dev-mode gateway: booting an
    // ephemeral workerd needs the platform services and the Cloudflare
    // environment, all present during stack-eval but not statically
    // enumerable here.
    const ambient = yield* Effect.context<never>();

    return Effect.fn(function* (namespace: Namespace | InstantNamespace) {
      // Deferred accessor — resolves the namespaceId against the tracker at
      // apply time (in an Action, that's the engine's resolve context).
      const namespaceId = yield* namespace.namespaceId;
      const auth: KVAuth = {
        authorize: (eff) => eff.pipe(Effect.provideContext(context)),
        accountId: Effect.map(environment, (env) => env.accountId),
      };
      const httpClient = options.makeHttpClient(auth, namespaceId);
      return dispatchByMode(namespaceId, httpClient, (id) =>
        options.makeNativeClient(makeProxyKVNamespaceHelpers(id, ambient)),
      );
    });
  });