import * as Binding from "alchemy/Binding";
import * as Effect from "effect/Effect";
import type { Zone } from "../Zone/Zone.ts";
import { type ReadDnsClient } from "./ReadDns.ts";
import { type WriteDnsClient } from "./WriteDns.ts";
/**
* Binding that lets a Worker perform the full Cloudflare DNS record CRUD
* surface at runtime.
*
* Creates a least-privilege {@link AccountApiToken} with both the `DNS Read`
* and `DNS Write` permissions, scoped to the single zone passed to `bind`, and
* binds its value into the Worker so runtime code can authenticate.
*
*
* ### Managing DNS records at runtime
* **Example:** Full CRUD from inside a Worker
* Bind the client in the Worker's Init phase and provide
* {@link ReadWriteDnsBinding}. The zone is fixed by `ReadWriteDnsBinding(zone)` — the
* provisioned token only grants access to that zone, so calls take no
* `zoneId`. Pass the {@link Zone} resource directly (it's an `Effect`), or
* `yield* Zone` for a resolved value.
* ```typescript
* import * as Cloudflare from "@alchemy.run/cloudflare";
* import * as Effect from "effect/Effect";
* import * as HttpServerResponse from "effect/http/HttpServerResponse";
*
* const Zone = Cloudflare.Zone.Zone("MyZone", { name: "example.com" });
*
* export class Worker extends Cloudflare.Worker<Worker>()(
* "Worker",
* { main: import.meta.url },
* Effect.gen(function* () {
* // Init phase — bind the full CRUD client scoped to the zone.
* const dns = yield* Cloudflare.DNS.ReadWriteDns(Zone);
*
* return {
* fetch: Effect.gen(function* () {
* const { result } = yield* dns.createDnsRecord({
* type: "A",
* name: "app.example.com",
* content: "192.0.2.1",
* ttl: 1,
* });
* const record = yield* dns.getDnsRecord(result.id);
* yield* dns.deleteDnsRecord(result.id);
* return yield* HttpServerResponse.json({ id: record.id });
* }),
* };
* }).pipe(Effect.provide(Cloudflare.DNS.ReadWriteDnsBinding)),
* ) {}
* ```
*
* @binding
* @product DNS
* @category Domains & DNS
*/
export interface ReadWriteDns extends Binding.Service<
ReadWriteDns,
"Cloudflare.DNS.ReadWriteDns",
(zone: Zone) => Effect.Effect<ReadWriteDnsClient>
> {}
export const ReadWriteDns = Binding.Service<ReadWriteDns>("Cloudflare.DNS.ReadWriteDns");
/** Combined read + write DNS record operations. */
export interface ReadWriteDnsClient extends ReadDnsClient, WriteDnsClient {}