@origincloud/dns 0.0.0-stage → 0.15.0

package/dist/v1beta1/vpc_attachment.d.ts

@@ -0,0 +1,122 @@
+import { type CallOptions, type Client, type Empty, type Service } from "@origincloud/core";
+/**
+ * Calls VpcAttachmentService.
+ *
+ * VPC attachments: the VPCs a private zone answers in. Each attachment
+ * makes the zone's names resolve from every instance in one VPC, in every
+ * zone the VPC spans, and from no other VPC. A private zone attaches only
+ * to VPCs of its own project, and a VPC holds at most one attached zone of
+ * a name. An attachment's id is the VPC's id, so a client that knows the
+ * zone and the VPC names the attachment without listing. Deleting a VPC
+ * deletes its attachments. Attaching a public zone is refused: it answers on
+ * the internet, in every VPC alike.
+ */
+export declare class VpcAttachmentClient {
+    /**
+     * The endpoint the client sends its calls to, which also serves the
+     * operations its methods answer with.
+     */
+    readonly service: Service;
+    /** A client of VpcAttachmentService that sends its calls through `client`. */
+    constructor(client: Client);
+    /** Returns a VPC attachment. */
+    getVpcAttachment(request: GetVpcAttachmentRequest, options?: CallOptions): Promise<VpcAttachment>;
+    /**
+     * Lists a private zone's VPC attachments, oldest first. With `-` for the
+     * zone, lists every zone's in the project, which with `vpc` finds the
+     * zones attached to a VPC.
+     */
+    listVpcAttachments(request: ListVpcAttachmentsRequest, options?: CallOptions): Promise<ListVpcAttachmentsResponse>;
+    /**
+     * Iterates over everything listVpcAttachments lists from the request's page on,
+     * fetching the next page as the loop reaches it. A page that fails ends
+     * the iteration with its error.
+     */
+    allVpcAttachments(request: ListVpcAttachmentsRequest, options?: CallOptions): AsyncGenerator<VpcAttachment, void, undefined>;
+    /**
+     * Attaches a private zone to a VPC of the zone's project. Refused with
+     * `BAD_REQUEST` for a public zone, or for a VPC that isn't in the zone's
+     * project, with the same words whichever project it is in. Refused with
+     * `CONFLICT` when the VPC holds an attached zone of the same name. A VPC
+     * created moments ago may be refused with `SERVICE_UNAVAILABLE`,
+     * retryable. The VPC's instances resolve the zone's names once the VPC's
+     * hosts serve the zone.
+     */
+    createVpcAttachment(request: CreateVpcAttachmentRequest, options?: CallOptions): Promise<VpcAttachment>;
+    /**
+     * Detaches a private zone from a VPC. The VPC's instances stop resolving
+     * the zone's names once the VPC's hosts drop the zone.
+     */
+    deleteVpcAttachment(request: DeleteVpcAttachmentRequest, options?: CallOptions): Promise<Empty>;
+}
+/** A VPC a private zone answers in. */
+export interface VpcAttachment {
+    /** The attachment's resource name. Its last segment is the VPC's id. */
+    name?: string;
+    /**
+     * The attachment's URN, the identifier access policies and the audit log
+     * use.
+     */
+    urn?: string;
+    /** The VPC the zone answers in, in the zone's project. */
+    vpc?: string;
+    /** When the zone was attached. */
+    createTime?: string;
+}
+/** The request for GetVpcAttachment. */
+export interface GetVpcAttachmentRequest {
+    /** The attachment to return. */
+    name?: string;
+}
+/** The request for ListVpcAttachments. */
+export interface ListVpcAttachmentsRequest {
+    /**
+     * The private zone whose attachments to list,
+     * `projects/{project}/hostedZones/{hosted_zone}`, or `-` for the zone to
+     * list every zone's in the project.
+     */
+    parent?: string;
+    /**
+     * The most attachments to return; the server clamps it, and 0 means its
+     * default.
+     */
+    pageSize?: number;
+    /** A previous response's `nextPageToken`, for the page after it. */
+    pageToken?: string;
+    /** Only the attachments to this VPC; every VPC's when left empty. */
+    vpc?: string;
+}
+/** The response for ListVpcAttachments. */
+export interface ListVpcAttachmentsResponse {
+    /** The attachments on this page. */
+    vpcAttachments?: VpcAttachment[];
+    /** The token for the next page; empty on the last one. */
+    nextPageToken?: string;
+}
+/** The request for CreateVpcAttachment. */
+export interface CreateVpcAttachmentRequest {
+    /**
+     * The private zone to attach,
+     * `projects/{project}/hostedZones/{hosted_zone}`.
+     */
+    parent?: string;
+    /** The attachment to create: its `vpc`. */
+    vpcAttachment?: VpcAttachment;
+    /**
+     * A UUID; a repeat with the same id within a day returns the attachment
+     * the first request created, as it is now, instead of being refused as a
+     * conflict.
+     */
+    requestId?: string;
+}
+/** The request for DeleteVpcAttachment. */
+export interface DeleteVpcAttachmentRequest {
+    /** The attachment to delete. */
+    name?: string;
+    /**
+     * A UUID; a repeat with the same id within a day succeeds as the first
+     * did, instead of answering `NOT_FOUND`.
+     */
+    requestId?: string;
+}
+//# sourceMappingURL=vpc_attachment.d.ts.map

package/dist/v1beta1/vpc_attachment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vpc_attachment.d.ts","sourceRoot":"","sources":["../../src/v1beta1/vpc_attachment.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,OAAO,EAIb,MAAM,mBAAmB,CAAC;AAE3B;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC9B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B,8EAA8E;gBAClE,MAAM,EAAE,MAAM;IAI1B,gCAAgC;IAC1B,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAavG;;;;OAIG;IACG,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,0BAA0B,CAAC;IAaxH;;;;OAIG;IACI,iBAAiB,CAAC,OAAO,EAAE,yBAAyB,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,cAAc,CAAC,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC;IASnI;;;;;;;;OAQG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAe7G;;;OAGG;IACG,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC;CAatG;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0DAA0D;IAC1D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wCAAwC;AACxC,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0CAA0C;AAC1C,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,2CAA2C;AAC3C,MAAM,WAAW,0BAA0B;IACzC,oCAAoC;IACpC,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IACjC,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,2CAA2C;AAC3C,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2CAA2C;IAC3C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,WAAW,0BAA0B;IACzC,gCAAgC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/v1beta1/vpc_attachment.js

@@ -0,0 +1,101 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/dns/v1beta1/vpc_attachment.proto
+import { newRequestId, pathValue, query, } from "@origincloud/core";
+/**
+ * Calls VpcAttachmentService.
+ *
+ * VPC attachments: the VPCs a private zone answers in. Each attachment
+ * makes the zone's names resolve from every instance in one VPC, in every
+ * zone the VPC spans, and from no other VPC. A private zone attaches only
+ * to VPCs of its own project, and a VPC holds at most one attached zone of
+ * a name. An attachment's id is the VPC's id, so a client that knows the
+ * zone and the VPC names the attachment without listing. Deleting a VPC
+ * deletes its attachments. Attaching a public zone is refused: it answers on
+ * the internet, in every VPC alike.
+ */
+export class VpcAttachmentClient {
+    /**
+     * The endpoint the client sends its calls to, which also serves the
+     * operations its methods answer with.
+     */
+    service;
+    /** A client of VpcAttachmentService that sends its calls through `client`. */
+    constructor(client) {
+        this.service = client.service("dns", false);
+    }
+    /** Returns a VPC attachment. */
+    async getVpcAttachment(request, options) {
+        const p0 = pathValue("name", request.name, "projects/*/hostedZones/*/vpcAttachments/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}`,
+            query: query(request, ["name"]),
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Lists a private zone's VPC attachments, oldest first. With `-` for the
+     * zone, lists every zone's in the project, which with `vpc` finds the
+     * zones attached to a VPC.
+     */
+    async listVpcAttachments(request, options) {
+        const p0 = pathValue("parent", request.parent, "projects/*/hostedZones/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}/vpcAttachments`,
+            query: query(request, ["parent"]),
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Iterates over everything listVpcAttachments lists from the request's page on,
+     * fetching the next page as the loop reaches it. A page that fails ends
+     * the iteration with its error.
+     */
+    async *allVpcAttachments(request, options) {
+        for (let page = request;;) {
+            const response = await this.listVpcAttachments(page, options);
+            yield* response.vpcAttachments ?? [];
+            if (!response.nextPageToken)
+                return;
+            page = { ...page, pageToken: response.nextPageToken };
+        }
+    }
+    /**
+     * Attaches a private zone to a VPC of the zone's project. Refused with
+     * `BAD_REQUEST` for a public zone, or for a VPC that isn't in the zone's
+     * project, with the same words whichever project it is in. Refused with
+     * `CONFLICT` when the VPC holds an attached zone of the same name. A VPC
+     * created moments ago may be refused with `SERVICE_UNAVAILABLE`,
+     * retryable. The VPC's instances resolve the zone's names once the VPC's
+     * hosts serve the zone.
+     */
+    async createVpcAttachment(request, options) {
+        if (!request.requestId)
+            request = { ...request, requestId: newRequestId() };
+        const p0 = pathValue("parent", request.parent, "projects/*/hostedZones/*");
+        return this.service.call({
+            method: "POST",
+            path: `/v1beta1/${p0}/vpcAttachments`,
+            body: request.vpcAttachment,
+            query: query(request, ["parent", "vpcAttachment"]),
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Detaches a private zone from a VPC. The VPC's instances stop resolving
+     * the zone's names once the VPC's hosts drop the zone.
+     */
+    async deleteVpcAttachment(request, options) {
+        if (!request.requestId)
+            request = { ...request, requestId: newRequestId() };
+        const p0 = pathValue("name", request.name, "projects/*/hostedZones/*/vpcAttachments/*");
+        return this.service.call({
+            method: "DELETE",
+            path: `/v1beta1/${p0}`,
+            query: query(request, ["name"]),
+            idempotent: true,
+        }, options);
+    }
+}
+//# sourceMappingURL=vpc_attachment.js.map

package/dist/v1beta1/vpc_attachment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vpc_attachment.js","sourceRoot":"","sources":["../../src/v1beta1/vpc_attachment.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@origincloud/dns",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.15.0",
+  "description": "Origin Cloud's DNS service: hosted zones, their record sets, and private zones' VPC attachments.",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/origincloudhq/sdk-typescript#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/origincloudhq/sdk-typescript.git",
+    "directory": "packages/dns"
+  },
+  "bugs": "https://github.com/origincloudhq/sdk-typescript/issues",
+  "keywords": [
+    "origincloud",
+    "origin-cloud",
+    "sdk",
+    "dns"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "exports": {
+    "./*": {
+      "types": "./dist/*/index.d.ts",
+      "default": "./dist/*/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!dist/**/*.tsbuildinfo"
+  ],
+  "peerDependencies": {
+    "@origincloud/core": "^0.15.0"
+  },
+  "devDependencies": {
+    "@origincloud/core": "^0.15.0"
+  }
+}

package/src/v1beta1/hosted_zone.ts

@@ -0,0 +1,395 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/dns/v1beta1/hosted_zone.proto
+
+import {
+  type CallOptions,
+  type Client,
+  type Empty,
+  type Service,
+  newRequestId,
+  pathValue,
+  query,
+} from "@origincloud/core";
+
+/**
+ * Calls HostedZoneService.
+ *
+ * Hosted zones: the domains a project's records are answered for.
+ *
+ * A public zone holds its name only once it proves control of it: until
+ * then it is `PENDING_VERIFICATION`, and any number of zones of any
+ * project may be pending for the same name. It proves control with a TXT
+ * record at `_origin-challenge.{dns_name}` holding the zone's token,
+ * answered by the name's current DNS. The first zone of a name to verify
+ * becomes `ACTIVE`, holds the name, and is answered from the platform's
+ * name servers once the name is delegated to them; the others stay
+ * pending. A zone that doesn't verify within its window is deleted with
+ * its record sets. The platform checks pending zones on its own, more
+ * rarely the longer they stay pending; `VerifyHostedZone` checks one now.
+ *
+ * An active public zone is checked again every day. It keeps its name
+ * while the name is delegated to the platform's name servers, or while the
+ * token still answers at the name's other name servers. After several
+ * checks in a row find the name delegated elsewhere without the token, it
+ * is `SUSPENDED`: no longer answered, its record sets kept, and its name
+ * free for another zone to verify. Verifying it again while its name is
+ * free makes it active again.
+ *
+ * A private zone is active from the start, and answers in the VPCs it is
+ * attached to.
+ */
+export class HostedZoneClient {
+  /**
+   * The endpoint the client sends its calls to, which also serves the
+   * operations its methods answer with.
+   */
+  readonly service: Service;
+
+  /** A client of HostedZoneService that sends its calls through `client`. */
+  constructor(client: Client) {
+    this.service = client.service("dns", false);
+  }
+
+  /** Returns a hosted zone. */
+  async getHostedZone(request: GetHostedZoneRequest, options?: CallOptions): Promise<HostedZone> {
+    const p0 = pathValue("name", request.name, "projects/*/hostedZones/*");
+    return this.service.call<HostedZone>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}`,
+        query: query(request, ["name"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /** Lists a project's hosted zones, oldest first. */
+  async listHostedZones(request: ListHostedZonesRequest, options?: CallOptions): Promise<ListHostedZonesResponse> {
+    const p0 = pathValue("parent", request.parent, "projects/*");
+    return this.service.call<ListHostedZonesResponse>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}/hostedZones`,
+        query: query(request, ["parent"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Iterates over everything listHostedZones lists from the request's page on,
+   * fetching the next page as the loop reaches it. A page that fails ends
+   * the iteration with its error.
+   */
+  async *allHostedZones(request: ListHostedZonesRequest, options?: CallOptions): AsyncGenerator<HostedZone, void, undefined> {
+    for (let page = request; ; ) {
+      const response = await this.listHostedZones(page, options);
+      yield* response.hostedZones ?? [];
+      if (!response.nextPageToken) return;
+      page = { ...page, pageToken: response.nextPageToken };
+    }
+  }
+
+  /**
+   * Creates a hosted zone, empty. A public zone starts
+   * `PENDING_VERIFICATION`, with the token to publish in `challenge`; a
+   * private zone starts `ACTIVE`. Refused with `BAD_REQUEST` for a name the
+   * platform keeps for itself, or once the project's or organization's
+   * quota of zones is used up, and with `PAYMENT_METHOD_REQUIRED` while the
+   * project has no valid billing.
+   */
+  async createHostedZone(request: CreateHostedZoneRequest, options?: CallOptions): Promise<HostedZone> {
+    if (!request.requestId) request = { ...request, requestId: newRequestId() };
+    const p0 = pathValue("parent", request.parent, "projects/*");
+    return this.service.call<HostedZone>(
+      {
+        method: "POST",
+        path: `/v1beta1/${p0}/hostedZones`,
+        body: request.hostedZone,
+        query: query(request, ["parent", "hostedZone"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /** Changes a hosted zone's tags. */
+  async updateHostedZone(request: UpdateHostedZoneRequest, options?: CallOptions): Promise<HostedZone> {
+    if (!request.requestId) request = { ...request, requestId: newRequestId() };
+    const p0 = pathValue("hostedZone.name", request.hostedZone?.name, "projects/*/hostedZones/*");
+    return this.service.call<HostedZone>(
+      {
+        method: "PATCH",
+        path: `/v1beta1/${p0}`,
+        body: request.hostedZone,
+        query: query(request, ["hostedZone.name", "hostedZone"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Deletes a hosted zone. Refused with `CONFLICT` while it holds record
+   * sets or, for a private zone, VPC attachments: delete them first.
+   */
+  async deleteHostedZone(request: DeleteHostedZoneRequest, options?: CallOptions): Promise<Empty> {
+    if (!request.requestId) request = { ...request, requestId: newRequestId() };
+    const p0 = pathValue("name", request.name, "projects/*/hostedZones/*");
+    return this.service.call<Empty>(
+      {
+        method: "DELETE",
+        path: `/v1beta1/${p0}`,
+        query: query(request, ["name"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Checks a public zone's challenge now, instead of waiting for the
+   * platform's next check, and returns the zone as it is then, with the
+   * check's outcome in `challenge.lastCheck`. A pending zone whose token
+   * answers becomes `ACTIVE`, and so does a suspended one while its name is
+   * free; otherwise the zone stays as it was. A call within 30 seconds of
+   * the zone's last check answers with that check's outcome and asks the
+   * name's DNS nothing. Refused with `NOT_FOUND` once a pending zone's
+   * window has ended, which deleted it, and with `SERVICE_UNAVAILABLE`,
+   * retryable, when the name's DNS didn't answer in time or too many checks
+   * are under way. A private zone has no challenge, and is refused with
+   * `BAD_REQUEST`. Checking an active zone changes nothing, so a client may
+   * repeat the call.
+   */
+  async verifyHostedZone(request: VerifyHostedZoneRequest, options?: CallOptions): Promise<HostedZone> {
+    const p0 = pathValue("name", request.name, "projects/*/hostedZones/*");
+    return this.service.call<HostedZone>(
+      {
+        method: "POST",
+        path: `/v1beta1/${p0}:verify`,
+        body: request,
+      },
+      options,
+    );
+  }
+}
+
+/** A domain a project's records are answered for. */
+export interface HostedZone {
+  /** The zone's resource name. */
+  name?: string;
+  /** The zone's URN, the identifier access policies and the audit log use. */
+  urn?: string;
+  /**
+   * The domain, such as `example.com`, without the final dot; answered in
+   * lowercase. A public zone's has at least two labels and at most 235
+   * characters, so its challenge name fits. A private zone's may have one
+   * label, but isn't `internal` or a name below it, which answer each
+   * instance's own name. Neither is one of the platform's own domains or a
+   * name below one.
+   */
+  dnsName?: string;
+  /** Where the zone is answered. */
+  visibility?: HostedZone_Visibility;
+  /** Whether the zone is answered. */
+  state?: HostedZone_State;
+  /**
+   * The name servers to delegate a public zone to at its registrar, as NS
+   * records of its name. Fixed when the zone is created. Empty for a
+   * private zone.
+   */
+  nameServers?: string[];
+  /**
+   * How a public zone proves control of its name, and how it went. Unset
+   * for a private zone.
+   */
+  challenge?: OwnershipChallenge;
+  /** When the zone was created. */
+  createTime?: string;
+  /**
+   * The principal that created the zone, such as `user:<id>` or
+   * `service_account:<id>`.
+   */
+  creator?: string;
+  /**
+   * Labels of your own, at most 50. The `origin:name` tag is the name the
+   * console shows.
+   */
+  tags?: Record<string, string>;
+}
+
+/** Where a zone is answered. */
+export const HostedZone_Visibility = {
+  /** Not set. */
+  VISIBILITY_UNSPECIFIED: "VISIBILITY_UNSPECIFIED",
+  /** On the internet, from the platform's name servers. */
+  PUBLIC: "PUBLIC",
+  /** Only inside the VPCs it is attached to. */
+  PRIVATE: "PRIVATE",
+} as const;
+
+/** Where a zone is answered. */
+export type HostedZone_Visibility = (typeof HostedZone_Visibility)[keyof typeof HostedZone_Visibility];
+
+/** Whether a zone is answered. */
+export const HostedZone_State = {
+  /** Not set. */
+  STATE_UNSPECIFIED: "STATE_UNSPECIFIED",
+  /**
+   * A public zone that hasn't proved control of its name yet: not
+   * answered, and holding no name.
+   */
+  PENDING_VERIFICATION: "PENDING_VERIFICATION",
+  /** Answered. A public zone in this state holds its name. */
+  ACTIVE: "ACTIVE",
+  /**
+   * A public zone that lost control of its name: not answered, its
+   * record sets kept, its name free for another zone.
+   */
+  SUSPENDED: "SUSPENDED",
+} as const;
+
+/** Whether a zone is answered. */
+export type HostedZone_State = (typeof HostedZone_State)[keyof typeof HostedZone_State];
+
+/**
+ * A public zone's proof of control of its name: a TXT record named
+ * `dnsName` whose value is `token`, answered by the name's current DNS.
+ */
+export interface OwnershipChallenge {
+  /**
+   * The name of the TXT record to create where the zone's name is hosted
+   * now: `_origin-challenge.` followed by the zone's `dnsName`.
+   */
+  dnsName?: string;
+  /** The value the TXT record holds. */
+  token?: string;
+  /**
+   * When a pending zone that hasn't verified is deleted; unset once it
+   * verified.
+   */
+  expireTime?: string;
+  /** When the zone verified; unset while it is pending. */
+  verifyTime?: string;
+  /** When the zone was suspended; unset unless it is `SUSPENDED`. */
+  suspendTime?: string;
+  /** Why the zone was suspended; unset unless it is `SUSPENDED`. */
+  suspensionReason?: OwnershipChallenge_SuspensionReason;
+  /**
+   * What the check `VerifyHostedZone` made found. Set only in that
+   * method's response.
+   */
+  lastCheck?: OwnershipChallenge_CheckOutcome;
+}
+
+/** Why a zone was suspended. */
+export const OwnershipChallenge_SuspensionReason = {
+  /** Not set. */
+  SUSPENSION_REASON_UNSPECIFIED: "SUSPENSION_REASON_UNSPECIFIED",
+  /**
+   * Several daily checks in a row found the name delegated to other name
+   * servers, without the zone's token.
+   */
+  CHALLENGE_LOST: "CHALLENGE_LOST",
+} as const;
+
+/** Why a zone was suspended. */
+export type OwnershipChallenge_SuspensionReason = (typeof OwnershipChallenge_SuspensionReason)[keyof typeof OwnershipChallenge_SuspensionReason];
+
+/** What a check of the challenge found. */
+export const OwnershipChallenge_CheckOutcome = {
+  /** Not set. */
+  CHECK_OUTCOME_UNSPECIFIED: "CHECK_OUTCOME_UNSPECIFIED",
+  /** The token answers, and the zone holds its name: it is `ACTIVE`. */
+  OK: "OK",
+  /**
+   * The token doesn't answer at the TXT record's name, or the name's DNS
+   * can't be asked.
+   */
+  NOT_FOUND: "NOT_FOUND",
+  /** The token answers, but another zone holds the name. */
+  NAME_HELD: "NAME_HELD",
+} as const;
+
+/** What a check of the challenge found. */
+export type OwnershipChallenge_CheckOutcome = (typeof OwnershipChallenge_CheckOutcome)[keyof typeof OwnershipChallenge_CheckOutcome];
+
+/** The request for GetHostedZone. */
+export interface GetHostedZoneRequest {
+  /** The zone to return. */
+  name?: string;
+}
+
+/** The request for ListHostedZones. */
+export interface ListHostedZonesRequest {
+  /** The project whose zones to list, `projects/{project}`. */
+  parent?: string;
+  /**
+   * The most zones to return; the server clamps it, and 0 means its
+   * default.
+   */
+  pageSize?: number;
+  /** A previous response's `nextPageToken`, for the page after it. */
+  pageToken?: string;
+  /**
+   * Only the zones of this domain, written as `dnsName` is; every zone
+   * when left empty.
+   */
+  dnsName?: string;
+}
+
+/** The response for ListHostedZones. */
+export interface ListHostedZonesResponse {
+  /** The zones on this page. */
+  hostedZones?: HostedZone[];
+  /** The token for the next page; empty on the last one. */
+  nextPageToken?: string;
+}
+
+/** The request for CreateHostedZone. */
+export interface CreateHostedZoneRequest {
+  /** The project to create the zone in, `projects/{project}`. */
+  parent?: string;
+  /**
+   * The zone to create: its `dnsName`, `visibility` and optionally its
+   * `tags`.
+   */
+  hostedZone?: HostedZone;
+  /**
+   * A UUID; a repeat with the same id within a day returns the zone the
+   * first request created, as it is now, instead of creating a second one.
+   */
+  requestId?: string;
+}
+
+/** The request for UpdateHostedZone. */
+export interface UpdateHostedZoneRequest {
+  /** The zone, by its name, with the fields to change. */
+  hostedZone?: HostedZone;
+  /** The fields to change: `tags`, or `*`. */
+  updateMask?: string;
+  /**
+   * A UUID; a repeat with the same id within a day returns the zone as it
+   * is now, instead of changing it again.
+   */
+  requestId?: string;
+}
+
+/** The request for DeleteHostedZone. */
+export interface DeleteHostedZoneRequest {
+  /** The zone to delete. */
+  name?: string;
+  /**
+   * A UUID; a repeat with the same id within a day succeeds as the first
+   * did, instead of answering `NOT_FOUND`.
+   */
+  requestId?: string;
+}
+
+/** The request for VerifyHostedZone. */
+export interface VerifyHostedZoneRequest {
+  /** The public zone to verify. */
+  name?: string;
+}

package/src/v1beta1/index.ts

@@ -0,0 +1,5 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+
+export * from "./hosted_zone.js";
+export * from "./record_set.js";
+export * from "./vpc_attachment.js";