sailfork / t3code-github / .repos/ alchemy-effect/ packages/ cloudflare/ src/ DNS/ DnsHttp.ts

import * as Output from "alchemy/Output";
import type { RuntimeContext } from "alchemy/RuntimeContext";
import { Self } from "alchemy/Self";
import * as Effect from "effect/Effect";
import type * as HttpClient from "effect/http/HttpClient";
import type * as Redacted from "effect/Redacted";
import { AccountApiToken } from "../ApiToken/AccountApiToken.ts";
import type { PermissionGroupRef } from "../ApiToken/Common.ts";
import type { Credentials } from "../Credentials.ts";
import { requireLiveResource } from "../HttpBindingDev.ts";
import { authorizeWith } from "../HttpClientUtils.ts";
import type { Zone } from "../Zone/Zone.ts";

/**
 * Shared scaffolding for the HTTP-backed DNS bindings.
 *
 * Creates a least-privilege {@link AccountApiToken} scoped to the requested
 * zone, binds its `value` into the host Worker at deploy time (guarded by
 * `__ALCHEMY_RUNTIME__` so it is a no-op once running inside the deployed
 * Worker), then delegates to `makeClient` with the bound token and the zone's
 * `zoneId`.
 *
 * The zone's `zoneId` is bound into the Worker at init time, so the resulting
 * client closes over it and callers never pass it per request — the
 * provisioned token only grants access to that one zone anyway.
 */
export const makeHttpDnsBinding = <Client>(options: {
  permissionGroups: PermissionGroupRef[];
  makeClient: (auth: DnsAuth, zoneId: Effect.Effect<string>) => Client;
}) =>
  Effect.gen(function* () {
    const Token = yield* AccountApiToken;
    const self = yield* Self;

    return Effect.fn(function* (zone: Zone) {
      if (!globalThis.__ALCHEMY_RUNTIME__) yield* requireLiveResource(zone);
      const token = yield* Token(`${self.LogicalId}Token`);
      if (!globalThis.__ALCHEMY_RUNTIME__) {
        yield* token.bind`${self.LogicalId}(${zone})`({
          policies: [
            {
              effect: "allow",
              permissionGroups: options.permissionGroups,
              resources: zone.zoneId.pipe(
                Output.flatMap(
                  (zoneId) => Output.interpolate`com.cloudflare.api.account.zone.${zoneId}`,
                ),
                Output.map((zoneId) => ({
                  [zoneId]: "*",
                })),
              ),
            },
          ],
        });
      }
      const bound = {
        value: yield* token.value,
      } satisfies Token;
      const zoneId = yield* zone.zoneId;
      return options.makeClient(makeDnsAuth(bound), zoneId);
    });
  });

/**
 * Injectable auth for the DNS HTTP client builders. Both the scoped-token
 * (`*Http`) and current-credentials (`*Local`) variants supply an `authorize`
 * that provides `Credentials` + `HttpClient` to a raw SDK op, so the client
 * builders are agnostic to how creds are obtained. DNS record ops are
 * zone-scoped (the `zoneId` is passed alongside), so no `accountId` is needed.
 */
export interface DnsAuth {
  authorize: <A, E>(
    eff: Effect.Effect<A, E, Credentials | HttpClient.HttpClient>,
  ) => Effect.Effect<A, E, RuntimeContext>;
}

/** Build a scoped-token {@link DnsAuth} from a bound {@link Token}. */
export const makeDnsAuth = (token: Token): DnsAuth => ({
  authorize: authorizeWith(token),
});

/**
 * Runtime accessor for a DNS binding's token, obtained by binding the
 * {@link AccountApiToken}'s `value` output in the Worker's Init phase. Reads the
 * value back from the Worker's environment at runtime. DNS record operations
 * are zone-scoped (the `zoneId` is passed per call), so the account id is not
 * needed at runtime.
 */
export interface Token {
  /** The token's plaintext value (injected as a `secret_text` binding). */
  value: Effect.Effect<Redacted.Redacted<string>>;
}