import type { AddZoneRrsetRecordsError, AddZoneRrsetRecordsRequest, AddZoneRrsetRecordsResponse, ChangeZoneRrsetProtectionError, ChangeZoneRrsetProtectionResponse, ChangeZoneRrsetTtlError, ChangeZoneRrsetTtlResponse, RemoveZoneRrsetRecordsError, RemoveZoneRrsetRecordsRequest, RemoveZoneRrsetRecordsResponse, SetZoneRrsetRecordsError, SetZoneRrsetRecordsRequest, SetZoneRrsetRecordsResponse, UpdateZoneRrsetRecordsError, UpdateZoneRrsetRecordsRequest, UpdateZoneRrsetRecordsResponse } from "@distilled.cloud/hetzner/zone_rrset_actions";
import type { CreateZoneRrsetError, CreateZoneRrsetRequest, CreateZoneRrsetResponse, DeleteZoneRrsetError, DeleteZoneRrsetResponse, UpdateZoneRrsetError, UpdateZoneRrsetRequest, UpdateZoneRrsetResponse } from "@distilled.cloud/hetzner/zone_rrsets";
import * as Effect from "effect/Effect";
import * as Binding from "../Binding.ts";
import type { RuntimeContext } from "../RuntimeContext.ts";
import type { Zone } from "./Zone.ts";
/**
 * Binding that lets runtime code create, update, and delete Hetzner Cloud
 * DNS RRSets.
 *
 * Authenticates with the ambient `HCLOUD_TOKEN`. A read-only token is
 * rejected on these methods as `Forbidden`. The zone is fixed by
 * `WriteDns(zone)` so calls take no zone id. Provide {@link WriteDnsHttp}
 * on the Action / Function Effect.
 *
 * Mutating RRSet endpoints are asynchronous — they return an `action`
 * that must reach `success` before a subsequent read is guaranteed to
 * see the change. Poll with {@link waitForZoneAction}.
 *
 *
 * ### Mutating RRSets at runtime
 * **Example:** Create, replace records, and delete from an Action
 * Bind the client in the Action's Init phase and provide {@link WriteDnsHttp}.
 * ```typescript
 * import * as Alchemy from "alchemy";
 * import * as Hetzner from "alchemy/Hetzner";
 * import * as Effect from "effect/Effect";
 *
 * const Seed = Alchemy.Action(
 *   "Seed",
 *   Effect.gen(function* () {
 *     const dns = yield* Hetzner.WriteDns(zone);
 *     return Effect.fn(function* () {
 *       const created = yield* dns.createRecordSet({
 *         name: "app",
 *         type: "A",
 *         records: [{ value: "192.0.2.1" }],
 *         ttl: 300,
 *       });
 *       yield* Hetzner.waitForZoneAction(created.action);
 *       yield* dns.setRecordSetRecords("app", "A", {
 *         records: [{ value: "192.0.2.2" }],
 *       });
 *       yield* dns.deleteRecordSet("app", "A");
 *       return created.rrset.id;
 *     });
 *   }).pipe(Effect.provide(Hetzner.WriteDnsHttp)),
 * );
 * ```
 *
 * @binding
 */
export interface WriteDns extends Binding.Service<WriteDns, "Hetzner.DNS.WriteDns", (zone: Zone) => Effect.Effect<WriteDnsClient>> {
}
export declare const WriteDns: WriteDns;
/** Create-RRSet request, minus the zone id (bound at `WriteDns(zone)` time). */
export type CreateRecordSetRequestInput = Omit<CreateZoneRrsetRequest, "id_or_name">;
/** Update-RRSet (labels) request, minus the zone id and RRSet identity. */
export type UpdateRecordSetRequestInput = Omit<UpdateZoneRrsetRequest, "id_or_name" | "rr_name" | "rr_type">;
/** Add-records request, minus the zone id and RRSet identity. */
export type AddRecordSetRecordsRequestInput = Omit<AddZoneRrsetRecordsRequest, "id_or_name" | "rr_name" | "rr_type">;
/** Remove-records request, minus the zone id and RRSet identity. */
export type RemoveRecordSetRecordsRequestInput = Omit<RemoveZoneRrsetRecordsRequest, "id_or_name" | "rr_name" | "rr_type">;
/** Set-records request, minus the zone id and RRSet identity. */
export type SetRecordSetRecordsRequestInput = Omit<SetZoneRrsetRecordsRequest, "id_or_name" | "rr_name" | "rr_type">;
/** Update-record-comments request, minus the zone id and RRSet identity. */
export type UpdateRecordSetRecordsRequestInput = Omit<UpdateZoneRrsetRecordsRequest, "id_or_name" | "rr_name" | "rr_type">;
/**
 * Mutating DNS RRSet operations. The zone is fixed when the client is
 * bound, so no `id_or_name` is passed per call.
 */
export interface WriteDnsClient {
    /** Create an RRSet. */
    createRecordSet(request: CreateRecordSetRequestInput): Effect.Effect<CreateZoneRrsetResponse, CreateZoneRrsetError, RuntimeContext>;
    /** Overwrite the RRSet's labels (PUT). */
    updateRecordSet(name: string, type: string, request?: UpdateRecordSetRequestInput): Effect.Effect<UpdateZoneRrsetResponse, UpdateZoneRrsetError, RuntimeContext>;
    /** Delete an RRSet by name and type. */
    deleteRecordSet(name: string, type: string): Effect.Effect<DeleteZoneRrsetResponse, DeleteZoneRrsetError, RuntimeContext>;
    /** Append records to an RRSet (creates the RRSet if it is missing). */
    addRecordSetRecords(name: string, type: string, request: AddRecordSetRecordsRequestInput): Effect.Effect<AddZoneRrsetRecordsResponse, AddZoneRrsetRecordsError, RuntimeContext>;
    /** Remove records from an RRSet (deletes it if it becomes empty). */
    removeRecordSetRecords(name: string, type: string, request: RemoveRecordSetRecordsRequestInput): Effect.Effect<RemoveZoneRrsetRecordsResponse, RemoveZoneRrsetRecordsError, RuntimeContext>;
    /** Replace every record in an existing RRSet. */
    setRecordSetRecords(name: string, type: string, request: SetRecordSetRecordsRequestInput): Effect.Effect<SetZoneRrsetRecordsResponse, SetZoneRrsetRecordsError, RuntimeContext>;
    /** Update comments on existing records. */
    updateRecordSetRecords(name: string, type: string, request: UpdateRecordSetRecordsRequestInput): Effect.Effect<UpdateZoneRrsetRecordsResponse, UpdateZoneRrsetRecordsError, RuntimeContext>;
    /** Change the RRSet TTL. Pass `null` to inherit the zone default. */
    changeRecordSetTtl(name: string, type: string, ttl: number | null): Effect.Effect<ChangeZoneRrsetTtlResponse, ChangeZoneRrsetTtlError, RuntimeContext>;
    /** Enable or disable change protection on the RRSet. */
    changeRecordSetProtection(name: string, type: string, change: boolean): Effect.Effect<ChangeZoneRrsetProtectionResponse, ChangeZoneRrsetProtectionError, RuntimeContext>;
}
//# sourceMappingURL=WriteDns.d.ts.map