@origincloud/billing 0.26.0 → 0.27.0

package/dist/v1beta1/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./billing_account.js";
 export * from "./cost.js";
+export * from "./legal_document.js";
 export * from "./price_list.js";
 export * from "./spend_limit.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1beta1/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/v1beta1/index.ts"],"names":[],"mappings":"AAEA,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/v1beta1/index.js

@@ -1,6 +1,7 @@
 // Code generated by the SDK's generator (generator/). DO NOT EDIT.
 export * from "./billing_account.js";
 export * from "./cost.js";
+export * from "./legal_document.js";
 export * from "./price_list.js";
 export * from "./spend_limit.js";
 //# sourceMappingURL=index.js.map

package/dist/v1beta1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1beta1/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/v1beta1/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AAEnE,cAAc,sBAAsB,CAAC;AACrC,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/v1beta1/legal_document.d.ts

@@ -0,0 +1,220 @@
+import { type CalendarDate, type CallOptions, type Client, type HttpBody, type Service } from "@origincloud/core";
+/**
+ * Calls LegalDocumentService.
+ *
+ * The legal documents Origin Cloud publishes: the Terms of Service, the Data
+ * Processing Agreement, the Service Level Agreement and the Acceptable Use
+ * Policy a customer accepts, and the documents published beside them. Every
+ * version stays readable under its fixed name once it is published, and none
+ * is ever changed: a correction is a new version.
+ *
+ * Every method of this service is answered without an access token.
+ */
+export declare class LegalDocumentClient {
+    /**
+     * The endpoint the client sends its calls to, which also serves the
+     * operations its methods answer with.
+     */
+    readonly service: Service;
+    /** A client of LegalDocumentService that sends its calls through `client`. */
+    constructor(client: Client);
+    /**
+     * Lists the published legal documents, in a fixed order: `terms`, `dpa`,
+     * `sla`, `aup`, `subprocessors`, `toms`, `privacy`, `switching`,
+     * `shared-responsibility`. A document with no published version yet is
+     * left out.
+     */
+    listLegalDocuments(request: ListLegalDocumentsRequest, options?: CallOptions): Promise<ListLegalDocumentsResponse>;
+    /**
+     * Iterates over everything listLegalDocuments 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.
+     */
+    allLegalDocuments(request: ListLegalDocumentsRequest, options?: CallOptions): AsyncGenerator<LegalDocument, void, undefined>;
+    /**
+     * Returns a legal document, with the version in force now and the latest
+     * one published. Fails with `NOT_FOUND` for a document with no published
+     * version.
+     */
+    getLegalDocument(request: GetLegalDocumentRequest, options?: CallOptions): Promise<LegalDocument>;
+    /** Lists a legal document's published versions, the latest first. */
+    listLegalDocumentVersions(request: ListLegalDocumentVersionsRequest, options?: CallOptions): Promise<ListLegalDocumentVersionsResponse>;
+    /**
+     * Iterates over everything listLegalDocumentVersions 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.
+     */
+    allLegalDocumentVersions(request: ListLegalDocumentVersionsRequest, options?: CallOptions): AsyncGenerator<LegalDocumentVersion, void, undefined>;
+    /** Returns one published version of a legal document, its text included. */
+    getLegalDocumentVersion(request: GetLegalDocumentVersionRequest, options?: CallOptions): Promise<LegalDocumentVersion>;
+    /**
+     * Returns a published version as a PDF (`application/pdf`), the file
+     * itself rather than JSON. Every page's footer names the document, the
+     * version, the date it takes effect and its `sha256`.
+     *
+     * It answers with the file itself: its bytes, as they came, and their content type.
+     */
+    downloadLegalDocumentVersion(request: DownloadLegalDocumentVersionRequest, options?: CallOptions): Promise<HttpBody>;
+}
+/**
+ * A legal document: every version of one kind of document, such as the Terms
+ * of Service.
+ */
+export interface LegalDocument {
+    /**
+     * The document's resource name, `legalDocuments/{legal_document}`, where
+     * `{legal_document}` is one of `terms`, `dpa`, `sla`, `aup`,
+     * `subprocessors`, `toms`, `privacy`, `switching` and
+     * `shared-responsibility`.
+     */
+    name?: string;
+    /**
+     * The document's title, as its latest version names it, such as `Terms of
+     * Service`.
+     */
+    displayName?: string;
+    /**
+     * Whether a customer accepts this document. A `MATERIAL` version of one
+     * that is accepted needs a new acceptance; the other documents are
+     * published only.
+     */
+    acceptanceRequired?: boolean;
+    /**
+     * The version in force today, by its resource name. Empty while the first
+     * version has not taken effect yet.
+     */
+    currentVersion?: string;
+    /**
+     * The latest version published, by its resource name: `currentVersion`,
+     * or a version announced to take effect later.
+     */
+    latestVersion?: string;
+}
+/**
+ * One published version of a legal document. It never changes once
+ * published.
+ */
+export interface LegalDocumentVersion {
+    /**
+     * The version's resource name,
+     * `legalDocuments/{legal_document}/versions/{version}`, where `{version}`
+     * is `YYYY-MM`, or `YYYY-MM-2`, `YYYY-MM-3` and so on for another version
+     * in the same month.
+     */
+    name?: string;
+    /** The version's title, such as `Terms of Service`. */
+    displayName?: string;
+    /**
+     * The day the version takes effect. It applies from that day until the
+     * next version of the document takes effect.
+     */
+    effectiveDate?: CalendarDate;
+    /** What the version changes. */
+    changeClass?: LegalDocumentVersion_ChangeClass;
+    /**
+     * A plain-language summary of what changed, as the acceptance dialog and
+     * the announcement show it.
+     */
+    changeSummary?: string;
+    /**
+     * The SHA-256 of `markdown`, in lowercase hexadecimal: what identifies the
+     * version, and what an acceptance of it records.
+     */
+    sha256?: string;
+    /**
+     * The version's source, Markdown with its YAML front matter, exactly as
+     * `sha256` is computed over it.
+     */
+    markdown?: string;
+    /**
+     * The version's text as an HTML fragment, without its title: safe to embed
+     * as it is. A reference to another legal document links the version of it
+     * in force on `effectiveDate`.
+     */
+    html?: string;
+    /**
+     * Where the version is published on the web, under a URL that never
+     * changes, such as `https://origincloud.eu/legal/terms/2026-12`.
+     */
+    uri?: string;
+    /** Where the version's PDF is downloaded from (DownloadLegalDocumentVersion). */
+    pdfUri?: string;
+}
+/** What a version changes, and so what publishing it asks of a customer. */
+export declare const LegalDocumentVersion_ChangeClass: {
+    /** Not used. */
+    readonly CHANGE_CLASS_UNSPECIFIED: "CHANGE_CLASS_UNSPECIFIED";
+    /**
+     * Changes rights or obligations. For a document customers accept, a
+     * customer accepts this version before it applies to them, and it is
+     * announced at least six weeks before it takes effect.
+     */
+    readonly MATERIAL: "MATERIAL";
+    /**
+     * Announced ahead and never accepted, such as a new sub-processor,
+     * announced at least 30 days before it takes effect.
+     */
+    readonly NOTICE: "NOTICE";
+    /** Wording, corrections and formatting. Asks nothing of anyone. */
+    readonly EDITORIAL: "EDITORIAL";
+};
+/** What a version changes, and so what publishing it asks of a customer. */
+export type LegalDocumentVersion_ChangeClass = (typeof LegalDocumentVersion_ChangeClass)[keyof typeof LegalDocumentVersion_ChangeClass];
+/** The request for ListLegalDocuments. */
+export interface ListLegalDocumentsRequest {
+    /**
+     * The most documents 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;
+}
+/** The response for ListLegalDocuments. */
+export interface ListLegalDocumentsResponse {
+    /** The documents on this page. */
+    legalDocuments?: LegalDocument[];
+    /** The token for the next page; empty on the last one. */
+    nextPageToken?: string;
+}
+/** The request for GetLegalDocument. */
+export interface GetLegalDocumentRequest {
+    /** The document to return, `legalDocuments/{legal_document}`. */
+    name?: string;
+}
+/** The request for ListLegalDocumentVersions. */
+export interface ListLegalDocumentVersionsRequest {
+    /** The document whose versions to list, `legalDocuments/{legal_document}`. */
+    parent?: string;
+    /**
+     * The most versions 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;
+}
+/** The response for ListLegalDocumentVersions. */
+export interface ListLegalDocumentVersionsResponse {
+    /** The versions on this page. */
+    legalDocumentVersions?: LegalDocumentVersion[];
+    /** The token for the next page; empty on the last one. */
+    nextPageToken?: string;
+}
+/** The request for GetLegalDocumentVersion. */
+export interface GetLegalDocumentVersionRequest {
+    /**
+     * The version to return,
+     * `legalDocuments/{legal_document}/versions/{version}`.
+     */
+    name?: string;
+}
+/** The request for DownloadLegalDocumentVersion. */
+export interface DownloadLegalDocumentVersionRequest {
+    /**
+     * The version to download,
+     * `legalDocuments/{legal_document}/versions/{version}`.
+     */
+    name?: string;
+}
+//# sourceMappingURL=legal_document.d.ts.map

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

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

package/dist/v1beta1/legal_document.js

@@ -0,0 +1,141 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/billing/v1beta1/legal_document.proto
+import { pathValue, query, } from "@origincloud/core";
+/**
+ * Calls LegalDocumentService.
+ *
+ * The legal documents Origin Cloud publishes: the Terms of Service, the Data
+ * Processing Agreement, the Service Level Agreement and the Acceptable Use
+ * Policy a customer accepts, and the documents published beside them. Every
+ * version stays readable under its fixed name once it is published, and none
+ * is ever changed: a correction is a new version.
+ *
+ * Every method of this service is answered without an access token.
+ */
+export class LegalDocumentClient {
+    /**
+     * The endpoint the client sends its calls to, which also serves the
+     * operations its methods answer with.
+     */
+    service;
+    /** A client of LegalDocumentService that sends its calls through `client`. */
+    constructor(client) {
+        this.service = client.service("billing", false);
+    }
+    /**
+     * Lists the published legal documents, in a fixed order: `terms`, `dpa`,
+     * `sla`, `aup`, `subprocessors`, `toms`, `privacy`, `switching`,
+     * `shared-responsibility`. A document with no published version yet is
+     * left out.
+     */
+    async listLegalDocuments(request, options) {
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/legalDocuments`,
+            query: query(request, []),
+            idempotent: true,
+            unauthenticated: true,
+        }, options);
+    }
+    /**
+     * Iterates over everything listLegalDocuments 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 *allLegalDocuments(request, options) {
+        for (let page = request;;) {
+            const response = await this.listLegalDocuments(page, options);
+            yield* response.legalDocuments ?? [];
+            if (!response.nextPageToken)
+                return;
+            page = { ...page, pageToken: response.nextPageToken };
+        }
+    }
+    /**
+     * Returns a legal document, with the version in force now and the latest
+     * one published. Fails with `NOT_FOUND` for a document with no published
+     * version.
+     */
+    async getLegalDocument(request, options) {
+        const p0 = pathValue("name", request.name, "legalDocuments/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}`,
+            query: query(request, ["name"]),
+            idempotent: true,
+            unauthenticated: true,
+        }, options);
+    }
+    /** Lists a legal document's published versions, the latest first. */
+    async listLegalDocumentVersions(request, options) {
+        const p0 = pathValue("parent", request.parent, "legalDocuments/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}/versions`,
+            query: query(request, ["parent"]),
+            idempotent: true,
+            unauthenticated: true,
+        }, options);
+    }
+    /**
+     * Iterates over everything listLegalDocumentVersions 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 *allLegalDocumentVersions(request, options) {
+        for (let page = request;;) {
+            const response = await this.listLegalDocumentVersions(page, options);
+            yield* response.legalDocumentVersions ?? [];
+            if (!response.nextPageToken)
+                return;
+            page = { ...page, pageToken: response.nextPageToken };
+        }
+    }
+    /** Returns one published version of a legal document, its text included. */
+    async getLegalDocumentVersion(request, options) {
+        const p0 = pathValue("name", request.name, "legalDocuments/*/versions/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}`,
+            query: query(request, ["name"]),
+            idempotent: true,
+            unauthenticated: true,
+        }, options);
+    }
+    /**
+     * Returns a published version as a PDF (`application/pdf`), the file
+     * itself rather than JSON. Every page's footer names the document, the
+     * version, the date it takes effect and its `sha256`.
+     *
+     * It answers with the file itself: its bytes, as they came, and their content type.
+     */
+    async downloadLegalDocumentVersion(request, options) {
+        const p0 = pathValue("name", request.name, "legalDocuments/*/versions/*");
+        return this.service.download({
+            method: "GET",
+            path: `/v1beta1/${p0}:download`,
+            query: query(request, ["name"]),
+            idempotent: true,
+            unauthenticated: true,
+        }, options);
+    }
+}
+/** What a version changes, and so what publishing it asks of a customer. */
+export const LegalDocumentVersion_ChangeClass = {
+    /** Not used. */
+    CHANGE_CLASS_UNSPECIFIED: "CHANGE_CLASS_UNSPECIFIED",
+    /**
+     * Changes rights or obligations. For a document customers accept, a
+     * customer accepts this version before it applies to them, and it is
+     * announced at least six weeks before it takes effect.
+     */
+    MATERIAL: "MATERIAL",
+    /**
+     * Announced ahead and never accepted, such as a new sub-processor,
+     * announced at least 30 days before it takes effect.
+     */
+    NOTICE: "NOTICE",
+    /** Wording, corrections and formatting. Asks nothing of anyone. */
+    EDITORIAL: "EDITORIAL",
+};
+//# sourceMappingURL=legal_document.js.map

package/dist/v1beta1/legal_document.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@origincloud/billing",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Origin Cloud's billing service: billing accounts and the projects they pay for, payment methods, cost and usage, spend limits and the price list.",
   "license": "Apache-2.0",
   "homepage": "https://github.com/origincloudhq/sdk-typescript#readme",
@@ -34,9 +34,9 @@
     "!dist/**/*.tsbuildinfo"
   ],
   "peerDependencies": {
-    "@origincloud/core": "^0.26.0"
+    "@origincloud/core": "^0.27.0"
   },
   "devDependencies": {
-    "@origincloud/core": "^0.26.0"
+    "@origincloud/core": "^0.27.0"
   }
 }

package/src/v1beta1/index.ts

@@ -2,5 +2,6 @@
 
 export * from "./billing_account.js";
 export * from "./cost.js";
+export * from "./legal_document.js";
 export * from "./price_list.js";
 export * from "./spend_limit.js";

package/src/v1beta1/legal_document.ts

@@ -0,0 +1,325 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/billing/v1beta1/legal_document.proto
+
+import {
+  type CalendarDate,
+  type CallOptions,
+  type Client,
+  type HttpBody,
+  type Service,
+  pathValue,
+  query,
+} from "@origincloud/core";
+
+/**
+ * Calls LegalDocumentService.
+ *
+ * The legal documents Origin Cloud publishes: the Terms of Service, the Data
+ * Processing Agreement, the Service Level Agreement and the Acceptable Use
+ * Policy a customer accepts, and the documents published beside them. Every
+ * version stays readable under its fixed name once it is published, and none
+ * is ever changed: a correction is a new version.
+ *
+ * Every method of this service is answered without an access token.
+ */
+export class LegalDocumentClient {
+  /**
+   * The endpoint the client sends its calls to, which also serves the
+   * operations its methods answer with.
+   */
+  readonly service: Service;
+
+  /** A client of LegalDocumentService that sends its calls through `client`. */
+  constructor(client: Client) {
+    this.service = client.service("billing", false);
+  }
+
+  /**
+   * Lists the published legal documents, in a fixed order: `terms`, `dpa`,
+   * `sla`, `aup`, `subprocessors`, `toms`, `privacy`, `switching`,
+   * `shared-responsibility`. A document with no published version yet is
+   * left out.
+   */
+  async listLegalDocuments(request: ListLegalDocumentsRequest, options?: CallOptions): Promise<ListLegalDocumentsResponse> {
+    return this.service.call<ListLegalDocumentsResponse>(
+      {
+        method: "GET",
+        path: `/v1beta1/legalDocuments`,
+        query: query(request, []),
+        idempotent: true,
+        unauthenticated: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Iterates over everything listLegalDocuments 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 *allLegalDocuments(request: ListLegalDocumentsRequest, options?: CallOptions): AsyncGenerator<LegalDocument, void, undefined> {
+    for (let page = request; ; ) {
+      const response = await this.listLegalDocuments(page, options);
+      yield* response.legalDocuments ?? [];
+      if (!response.nextPageToken) return;
+      page = { ...page, pageToken: response.nextPageToken };
+    }
+  }
+
+  /**
+   * Returns a legal document, with the version in force now and the latest
+   * one published. Fails with `NOT_FOUND` for a document with no published
+   * version.
+   */
+  async getLegalDocument(request: GetLegalDocumentRequest, options?: CallOptions): Promise<LegalDocument> {
+    const p0 = pathValue("name", request.name, "legalDocuments/*");
+    return this.service.call<LegalDocument>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}`,
+        query: query(request, ["name"]),
+        idempotent: true,
+        unauthenticated: true,
+      },
+      options,
+    );
+  }
+
+  /** Lists a legal document's published versions, the latest first. */
+  async listLegalDocumentVersions(request: ListLegalDocumentVersionsRequest, options?: CallOptions): Promise<ListLegalDocumentVersionsResponse> {
+    const p0 = pathValue("parent", request.parent, "legalDocuments/*");
+    return this.service.call<ListLegalDocumentVersionsResponse>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}/versions`,
+        query: query(request, ["parent"]),
+        idempotent: true,
+        unauthenticated: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Iterates over everything listLegalDocumentVersions 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 *allLegalDocumentVersions(request: ListLegalDocumentVersionsRequest, options?: CallOptions): AsyncGenerator<LegalDocumentVersion, void, undefined> {
+    for (let page = request; ; ) {
+      const response = await this.listLegalDocumentVersions(page, options);
+      yield* response.legalDocumentVersions ?? [];
+      if (!response.nextPageToken) return;
+      page = { ...page, pageToken: response.nextPageToken };
+    }
+  }
+
+  /** Returns one published version of a legal document, its text included. */
+  async getLegalDocumentVersion(request: GetLegalDocumentVersionRequest, options?: CallOptions): Promise<LegalDocumentVersion> {
+    const p0 = pathValue("name", request.name, "legalDocuments/*/versions/*");
+    return this.service.call<LegalDocumentVersion>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}`,
+        query: query(request, ["name"]),
+        idempotent: true,
+        unauthenticated: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Returns a published version as a PDF (`application/pdf`), the file
+   * itself rather than JSON. Every page's footer names the document, the
+   * version, the date it takes effect and its `sha256`.
+   *
+   * It answers with the file itself: its bytes, as they came, and their content type.
+   */
+  async downloadLegalDocumentVersion(request: DownloadLegalDocumentVersionRequest, options?: CallOptions): Promise<HttpBody> {
+    const p0 = pathValue("name", request.name, "legalDocuments/*/versions/*");
+    return this.service.download(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}:download`,
+        query: query(request, ["name"]),
+        idempotent: true,
+        unauthenticated: true,
+      },
+      options,
+    );
+  }
+}
+
+/**
+ * A legal document: every version of one kind of document, such as the Terms
+ * of Service.
+ */
+export interface LegalDocument {
+  /**
+   * The document's resource name, `legalDocuments/{legal_document}`, where
+   * `{legal_document}` is one of `terms`, `dpa`, `sla`, `aup`,
+   * `subprocessors`, `toms`, `privacy`, `switching` and
+   * `shared-responsibility`.
+   */
+  name?: string;
+  /**
+   * The document's title, as its latest version names it, such as `Terms of
+   * Service`.
+   */
+  displayName?: string;
+  /**
+   * Whether a customer accepts this document. A `MATERIAL` version of one
+   * that is accepted needs a new acceptance; the other documents are
+   * published only.
+   */
+  acceptanceRequired?: boolean;
+  /**
+   * The version in force today, by its resource name. Empty while the first
+   * version has not taken effect yet.
+   */
+  currentVersion?: string;
+  /**
+   * The latest version published, by its resource name: `currentVersion`,
+   * or a version announced to take effect later.
+   */
+  latestVersion?: string;
+}
+
+/**
+ * One published version of a legal document. It never changes once
+ * published.
+ */
+export interface LegalDocumentVersion {
+  /**
+   * The version's resource name,
+   * `legalDocuments/{legal_document}/versions/{version}`, where `{version}`
+   * is `YYYY-MM`, or `YYYY-MM-2`, `YYYY-MM-3` and so on for another version
+   * in the same month.
+   */
+  name?: string;
+  /** The version's title, such as `Terms of Service`. */
+  displayName?: string;
+  /**
+   * The day the version takes effect. It applies from that day until the
+   * next version of the document takes effect.
+   */
+  effectiveDate?: CalendarDate;
+  /** What the version changes. */
+  changeClass?: LegalDocumentVersion_ChangeClass;
+  /**
+   * A plain-language summary of what changed, as the acceptance dialog and
+   * the announcement show it.
+   */
+  changeSummary?: string;
+  /**
+   * The SHA-256 of `markdown`, in lowercase hexadecimal: what identifies the
+   * version, and what an acceptance of it records.
+   */
+  sha256?: string;
+  /**
+   * The version's source, Markdown with its YAML front matter, exactly as
+   * `sha256` is computed over it.
+   */
+  markdown?: string;
+  /**
+   * The version's text as an HTML fragment, without its title: safe to embed
+   * as it is. A reference to another legal document links the version of it
+   * in force on `effectiveDate`.
+   */
+  html?: string;
+  /**
+   * Where the version is published on the web, under a URL that never
+   * changes, such as `https://origincloud.eu/legal/terms/2026-12`.
+   */
+  uri?: string;
+  /** Where the version's PDF is downloaded from (DownloadLegalDocumentVersion). */
+  pdfUri?: string;
+}
+
+/** What a version changes, and so what publishing it asks of a customer. */
+export const LegalDocumentVersion_ChangeClass = {
+  /** Not used. */
+  CHANGE_CLASS_UNSPECIFIED: "CHANGE_CLASS_UNSPECIFIED",
+  /**
+   * Changes rights or obligations. For a document customers accept, a
+   * customer accepts this version before it applies to them, and it is
+   * announced at least six weeks before it takes effect.
+   */
+  MATERIAL: "MATERIAL",
+  /**
+   * Announced ahead and never accepted, such as a new sub-processor,
+   * announced at least 30 days before it takes effect.
+   */
+  NOTICE: "NOTICE",
+  /** Wording, corrections and formatting. Asks nothing of anyone. */
+  EDITORIAL: "EDITORIAL",
+} as const;
+
+/** What a version changes, and so what publishing it asks of a customer. */
+export type LegalDocumentVersion_ChangeClass = (typeof LegalDocumentVersion_ChangeClass)[keyof typeof LegalDocumentVersion_ChangeClass];
+
+/** The request for ListLegalDocuments. */
+export interface ListLegalDocumentsRequest {
+  /**
+   * The most documents 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;
+}
+
+/** The response for ListLegalDocuments. */
+export interface ListLegalDocumentsResponse {
+  /** The documents on this page. */
+  legalDocuments?: LegalDocument[];
+  /** The token for the next page; empty on the last one. */
+  nextPageToken?: string;
+}
+
+/** The request for GetLegalDocument. */
+export interface GetLegalDocumentRequest {
+  /** The document to return, `legalDocuments/{legal_document}`. */
+  name?: string;
+}
+
+/** The request for ListLegalDocumentVersions. */
+export interface ListLegalDocumentVersionsRequest {
+  /** The document whose versions to list, `legalDocuments/{legal_document}`. */
+  parent?: string;
+  /**
+   * The most versions 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;
+}
+
+/** The response for ListLegalDocumentVersions. */
+export interface ListLegalDocumentVersionsResponse {
+  /** The versions on this page. */
+  legalDocumentVersions?: LegalDocumentVersion[];
+  /** The token for the next page; empty on the last one. */
+  nextPageToken?: string;
+}
+
+/** The request for GetLegalDocumentVersion. */
+export interface GetLegalDocumentVersionRequest {
+  /**
+   * The version to return,
+   * `legalDocuments/{legal_document}/versions/{version}`.
+   */
+  name?: string;
+}
+
+/** The request for DownloadLegalDocumentVersion. */
+export interface DownloadLegalDocumentVersionRequest {
+  /**
+   * The version to download,
+   * `legalDocuments/{legal_document}/versions/{version}`.
+   */
+  name?: string;
+}