sailfork / t3code-github / .repos/ alchemy-effect/ packages/ cloudflare/ src/ R2/ BucketLocal.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 { Bucket } from "./Bucket.ts";
import type { makeHelpers } from "./BucketBinding.ts";
import type { R2Auth } from "./BucketHttp.ts";
import { makeProxyBucketHelpers } from "./LocalR2Gateway.ts";

/**
 * Shared scaffolding for the R2 `*Local` binding layers.
 *
 * Captures the lazy account resolver and ambient credentials context at
 * layer construction, then returns the deferred binding callable. The
 * callable reads the bucket name/jurisdiction as deferred accessors
 * (resolved at apply time) and builds the client per resolved name:
 *
 * - a REAL name gets the HTTP client (same builders as the `*Http` variant,
 *   authorized with the current CLI credentials — no minted token);
 * - a `dev:` name (local emulation under `alchemy dev`) gets the native
 *   binding client (same builders as the `*Binding` variant) over a scoped
 *   platform-proxy gateway (see `LocalR2Gateway.ts`).
 *
 * NOT exported from `index.ts`.
 */
export const makeLocalBucketBinding = <Client extends object>(options: {
  makeHttpClient: (
    auth: R2Auth,
    bucketName: Effect.Effect<string>,
    jurisdiction: Effect.Effect<string>,
  ) => Client;
  makeNativeClient: (helpers: ReturnType<typeof makeHelpers>) => 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 each op can be run with the
    // current credentials.
    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>();

    const auth: R2Auth = {
      authorize: (eff) => eff.pipe(Effect.provideContext(context)),
      accountId: Effect.map(environment, (env) => env.accountId),
    };

    return Effect.fn(function* (bucket: Bucket) {
      // Deferred accessors — resolved against the tracker at apply time. No
      // `host.bind`: the local variant registers no binding.
      const bucketName = yield* bucket.bucketName;
      const jurisdiction = yield* bucket.jurisdiction;
      const httpClient = options.makeHttpClient(auth, bucketName, jurisdiction);
      return dispatchByMode(bucketName, httpClient, (name) =>
        options.makeNativeClient(makeProxyBucketHelpers(name, ambient)),
      );
    });
  });