@origincloud/billing 0.26.0 → 0.28.0

package/dist/v1beta1/index.d.ts

@@ -1,5 +1,7 @@
 export * from "./billing_account.js";
 export * from "./cost.js";
+export * from "./legal_acceptance.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,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/v1beta1/index.js

@@ -1,6 +1,8 @@
 // Code generated by the SDK's generator (generator/). DO NOT EDIT.
 export * from "./billing_account.js";
 export * from "./cost.js";
+export * from "./legal_acceptance.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,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}

package/dist/v1beta1/legal_acceptance.d.ts

@@ -0,0 +1,194 @@
+import { type CalendarDate, type CallOptions, type Client, type Service } from "@origincloud/core";
+import type { BillingAddress } from "./billing_account.js";
+/**
+ * Calls LegalAcceptanceService.
+ *
+ * A billing account's acceptances of the legal documents customers accept:
+ * the Terms of Service, the Data Processing Agreement, the Service Level
+ * Agreement and the Acceptable Use Policy. The billing account is the legal
+ * entity that accepts. An acceptance is a record that never changes, and it
+ * is kept after the billing account and its organization are deleted.
+ */
+export declare class LegalAcceptanceClient {
+    /**
+     * The endpoint the client sends its calls to, which also serves the
+     * operations its methods answer with.
+     */
+    readonly service: Service;
+    /** A client of LegalAcceptanceService that sends its calls through `client`. */
+    constructor(client: Client);
+    /**
+     * Lists a billing account's acceptances, the latest first. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    listLegalAcceptances(request: ListLegalAcceptancesRequest, options?: CallOptions): Promise<ListLegalAcceptancesResponse>;
+    /**
+     * Iterates over everything listLegalAcceptances 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.
+     */
+    allLegalAcceptances(request: ListLegalAcceptancesRequest, options?: CallOptions): AsyncGenerator<LegalAcceptance, void, undefined>;
+    /**
+     * Returns one of a billing account's acceptances. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    getLegalAcceptance(request: GetLegalAcceptanceRequest, options?: CallOptions): Promise<LegalAcceptance>;
+    /**
+     * Accepts versions of legal documents for a billing account, all of them
+     * or none. Each version is named with the `sha256` of the text the caller
+     * showed, and must be the version in force or one published to take effect
+     * later. A version the account accepted before is returned as it was then.
+     * `actsAsBusiness` must be true: the services are offered to businesses
+     * only. Needs `admin.billing_account.update` on the organization.
+     */
+    acceptLegalDocuments(request: AcceptLegalDocumentsRequest, options?: CallOptions): Promise<ListLegalAcceptancesResponse>;
+    /**
+     * Returns the legal document versions a billing account has yet to
+     * accept. A version is `blocking` once it is in force: until the account
+     * accepts it, creating or growing billable resources charged to the
+     * account is refused. Running resources are never affected. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    queryLegalRequirements(request: QueryLegalRequirementsRequest, options?: CallOptions): Promise<QueryLegalRequirementsResponse>;
+}
+/** A billing account's acceptance of one version of a legal document. */
+export interface LegalAcceptance {
+    /** The acceptance's resource name. */
+    name?: string;
+    /**
+     * The version accepted,
+     * `legalDocuments/{legal_document}/versions/{version}`.
+     */
+    legalDocumentVersion?: string;
+    /** The SHA-256 of the text accepted: the version's `sha256`. */
+    sha256?: string;
+    /**
+     * Who accepted: `user:{id}`, or `service_account:{id}` for a service
+     * account.
+     */
+    accepter?: string;
+    /** When the version was accepted. */
+    acceptTime?: string;
+    /** How the acceptance came about. */
+    method?: LegalAcceptance_Method;
+    /** Whether the accepter confirmed acting as a business. Always true. */
+    actsAsBusiness?: boolean;
+    /**
+     * The legal entity that accepted, as it was at `acceptTime`: the
+     * organization's name.
+     */
+    organizationDisplayName?: string;
+    /**
+     * The billing account's address at `acceptTime`; unset for an account
+     * that had none.
+     */
+    billingAddress?: BillingAddress;
+    /**
+     * The billing account's VAT identification number at `acceptTime`;
+     * empty when it had none.
+     */
+    vatId?: string;
+}
+/** How the acceptance came about. */
+export declare const LegalAcceptance_Method: {
+    /** Not used. */
+    readonly METHOD_UNSPECIFIED: "METHOD_UNSPECIFIED";
+    /** When the organization or the billing account was created. */
+    readonly SIGNUP: "SIGNUP";
+    /** A changed version of a document the account had accepted before. */
+    readonly CHANGE: "CHANGE";
+    /**
+     * The first version of a document, by an account that existed before
+     * the document was published.
+     */
+    readonly MIGRATION: "MIGRATION";
+};
+/** How the acceptance came about. */
+export type LegalAcceptance_Method = (typeof LegalAcceptance_Method)[keyof typeof LegalAcceptance_Method];
+/** A legal document version a billing account has yet to accept. */
+export interface LegalRequirement {
+    /** The version, `legalDocuments/{legal_document}/versions/{version}`. */
+    legalDocumentVersion?: string;
+    /** The version's title, such as `Terms of Service`. */
+    displayName?: string;
+    /** The day the version takes effect. */
+    effectiveDate?: CalendarDate;
+    /** A plain-language summary of what changed. */
+    changeSummary?: string;
+    /** The version's `sha256`, to accept it by. */
+    sha256?: string;
+    /**
+     * In force already: until it is accepted, creating or growing billable
+     * resources charged to the account is refused.
+     */
+    blocking?: boolean;
+}
+/** A version to accept, with the text it was shown as. */
+export interface LegalDocumentVersionToAccept {
+    /** The version, `legalDocuments/{legal_document}/versions/{version}`. */
+    legalDocumentVersion?: string;
+    /**
+     * The version's `sha256`, as read with it: an acceptance is refused when
+     * the text shown isn't the version's.
+     */
+    sha256?: string;
+}
+/** The request for ListLegalAcceptances. */
+export interface ListLegalAcceptancesRequest {
+    /**
+     * The billing account,
+     * `organizations/{organization}/billingAccounts/{billing_account}`.
+     */
+    parent?: string;
+    /**
+     * The most acceptances 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 ListLegalAcceptances and AcceptLegalDocuments. */
+export interface ListLegalAcceptancesResponse {
+    /**
+     * The acceptances on this page; for AcceptLegalDocuments, one per version
+     * accepted, in the order requested.
+     */
+    legalAcceptances?: LegalAcceptance[];
+    /** The token for the next page; empty on the last one. */
+    nextPageToken?: string;
+}
+/** The request for GetLegalAcceptance. */
+export interface GetLegalAcceptanceRequest {
+    /** The acceptance to return. */
+    name?: string;
+}
+/** The request for AcceptLegalDocuments. */
+export interface AcceptLegalDocumentsRequest {
+    /**
+     * The billing account that accepts,
+     * `organizations/{organization}/billingAccounts/{billing_account}`.
+     */
+    name?: string;
+    /** The versions to accept. */
+    versions?: LegalDocumentVersionToAccept[];
+    /**
+     * That the caller acts as a business (§ 14 BGB) for the billing account's
+     * legal entity. Must be true.
+     */
+    actsAsBusiness?: boolean;
+}
+/** The request for QueryLegalRequirements. */
+export interface QueryLegalRequirementsRequest {
+    /**
+     * The billing account,
+     * `organizations/{organization}/billingAccounts/{billing_account}`.
+     */
+    name?: string;
+}
+/** The response for QueryLegalRequirements. */
+export interface QueryLegalRequirementsResponse {
+    /** The versions to accept, by document, then by the day they take effect. */
+    requirements?: LegalRequirement[];
+}
+//# sourceMappingURL=legal_acceptance.d.ts.map

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

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

package/dist/v1beta1/legal_acceptance.js

@@ -0,0 +1,111 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/billing/v1beta1/legal_acceptance.proto
+import { pathValue, query, } from "@origincloud/core";
+/**
+ * Calls LegalAcceptanceService.
+ *
+ * A billing account's acceptances of the legal documents customers accept:
+ * the Terms of Service, the Data Processing Agreement, the Service Level
+ * Agreement and the Acceptable Use Policy. The billing account is the legal
+ * entity that accepts. An acceptance is a record that never changes, and it
+ * is kept after the billing account and its organization are deleted.
+ */
+export class LegalAcceptanceClient {
+    /**
+     * The endpoint the client sends its calls to, which also serves the
+     * operations its methods answer with.
+     */
+    service;
+    /** A client of LegalAcceptanceService that sends its calls through `client`. */
+    constructor(client) {
+        this.service = client.service("billing", false);
+    }
+    /**
+     * Lists a billing account's acceptances, the latest first. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    async listLegalAcceptances(request, options) {
+        const p0 = pathValue("parent", request.parent, "organizations/*/billingAccounts/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}/legalAcceptances`,
+            query: query(request, ["parent"]),
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Iterates over everything listLegalAcceptances 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 *allLegalAcceptances(request, options) {
+        for (let page = request;;) {
+            const response = await this.listLegalAcceptances(page, options);
+            yield* response.legalAcceptances ?? [];
+            if (!response.nextPageToken)
+                return;
+            page = { ...page, pageToken: response.nextPageToken };
+        }
+    }
+    /**
+     * Returns one of a billing account's acceptances. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    async getLegalAcceptance(request, options) {
+        const p0 = pathValue("name", request.name, "organizations/*/billingAccounts/*/legalAcceptances/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}`,
+            query: query(request, ["name"]),
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Accepts versions of legal documents for a billing account, all of them
+     * or none. Each version is named with the `sha256` of the text the caller
+     * showed, and must be the version in force or one published to take effect
+     * later. A version the account accepted before is returned as it was then.
+     * `actsAsBusiness` must be true: the services are offered to businesses
+     * only. Needs `admin.billing_account.update` on the organization.
+     */
+    async acceptLegalDocuments(request, options) {
+        const p0 = pathValue("name", request.name, "organizations/*/billingAccounts/*");
+        return this.service.call({
+            method: "POST",
+            path: `/v1beta1/${p0}:acceptLegalDocuments`,
+            body: request,
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Returns the legal document versions a billing account has yet to
+     * accept. A version is `blocking` once it is in force: until the account
+     * accepts it, creating or growing billable resources charged to the
+     * account is refused. Running resources are never affected. Needs
+     * `admin.billing_account.get` on the organization.
+     */
+    async queryLegalRequirements(request, options) {
+        const p0 = pathValue("name", request.name, "organizations/*/billingAccounts/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}:queryLegalRequirements`,
+            query: query(request, ["name"]),
+            idempotent: true,
+        }, options);
+    }
+}
+/** How the acceptance came about. */
+export const LegalAcceptance_Method = {
+    /** Not used. */
+    METHOD_UNSPECIFIED: "METHOD_UNSPECIFIED",
+    /** When the organization or the billing account was created. */
+    SIGNUP: "SIGNUP",
+    /** A changed version of a document the account had accepted before. */
+    CHANGE: "CHANGE",
+    /**
+     * The first version of a document, by an account that existed before
+     * the document was published.
+     */
+    MIGRATION: "MIGRATION",
+};
+//# sourceMappingURL=legal_acceptance.js.map

package/dist/v1beta1/legal_acceptance.js.map

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

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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"}