@toshicloud/sdk 0.5.1 → 0.6.0

package/dist/gen/toshi/workspace/v1/workspace_service_pb.d.ts

@@ -432,6 +432,274 @@ export type GetWorkspaceStatementResponseJson = {
 export declare const GetWorkspaceStatementResponseSchema: GenMessage<GetWorkspaceStatementResponse, {
     jsonType: GetWorkspaceStatementResponseJson;
 }>;
+/**
+ * @generated from message toshi.workspace.v1.GetWorkspaceUpcomingInvoiceRequest
+ */
+export type GetWorkspaceUpcomingInvoiceRequest = Message<"toshi.workspace.v1.GetWorkspaceUpcomingInvoiceRequest"> & {};
+/**
+ * @generated from message toshi.workspace.v1.GetWorkspaceUpcomingInvoiceRequest
+ */
+export type GetWorkspaceUpcomingInvoiceRequestJson = {};
+/**
+ * Describes the message toshi.workspace.v1.GetWorkspaceUpcomingInvoiceRequest.
+ * Use `create(GetWorkspaceUpcomingInvoiceRequestSchema)` to create a new message.
+ */
+export declare const GetWorkspaceUpcomingInvoiceRequestSchema: GenMessage<GetWorkspaceUpcomingInvoiceRequest, {
+    jsonType: GetWorkspaceUpcomingInvoiceRequestJson;
+}>;
+/**
+ * @generated from message toshi.workspace.v1.GetWorkspaceUpcomingInvoiceResponse
+ */
+export type GetWorkspaceUpcomingInvoiceResponse = Message<"toshi.workspace.v1.GetWorkspaceUpcomingInvoiceResponse"> & {
+    /**
+     * The billing provider's preview of the next invoice.
+     *
+     * @generated from field: toshi.workspace.v1.UpcomingInvoice invoice = 1;
+     */
+    invoice?: UpcomingInvoice | undefined;
+    /**
+     * The current UTC month's cost per project, highest cost so far first.
+     * The row with an empty project_id holds what no project accounts for.
+     *
+     * @generated from field: repeated toshi.workspace.v1.ProjectCost projects = 2;
+     */
+    projects: ProjectCost[];
+    /**
+     * The sums of the projects' month_so_far_cents and estimated_month_cents.
+     * month_so_far_cents equals the current month's statement estimated_cents.
+     *
+     * @generated from field: int64 month_so_far_cents = 3;
+     */
+    monthSoFarCents: bigint;
+    /**
+     * @generated from field: int64 estimated_month_cents = 4;
+     */
+    estimatedMonthCents: bigint;
+    /**
+     * The currency of the project costs, as the statement gives it; empty
+     * while no price is known.
+     *
+     * @generated from field: string currency = 5;
+     */
+    currency: string;
+};
+/**
+ * @generated from message toshi.workspace.v1.GetWorkspaceUpcomingInvoiceResponse
+ */
+export type GetWorkspaceUpcomingInvoiceResponseJson = {
+    /**
+     * The billing provider's preview of the next invoice.
+     *
+     * @generated from field: toshi.workspace.v1.UpcomingInvoice invoice = 1;
+     */
+    invoice?: UpcomingInvoiceJson;
+    /**
+     * The current UTC month's cost per project, highest cost so far first.
+     * The row with an empty project_id holds what no project accounts for.
+     *
+     * @generated from field: repeated toshi.workspace.v1.ProjectCost projects = 2;
+     */
+    projects?: ProjectCostJson[];
+    /**
+     * The sums of the projects' month_so_far_cents and estimated_month_cents.
+     * month_so_far_cents equals the current month's statement estimated_cents.
+     *
+     * @generated from field: int64 month_so_far_cents = 3;
+     */
+    monthSoFarCents?: string;
+    /**
+     * @generated from field: int64 estimated_month_cents = 4;
+     */
+    estimatedMonthCents?: string;
+    /**
+     * The currency of the project costs, as the statement gives it; empty
+     * while no price is known.
+     *
+     * @generated from field: string currency = 5;
+     */
+    currency?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.GetWorkspaceUpcomingInvoiceResponse.
+ * Use `create(GetWorkspaceUpcomingInvoiceResponseSchema)` to create a new message.
+ */
+export declare const GetWorkspaceUpcomingInvoiceResponseSchema: GenMessage<GetWorkspaceUpcomingInvoiceResponse, {
+    jsonType: GetWorkspaceUpcomingInvoiceResponseJson;
+}>;
+/**
+ * UpcomingInvoice is the billing provider's preview of a workspace's next
+ * invoice.
+ *
+ * @generated from message toshi.workspace.v1.UpcomingInvoice
+ */
+export type UpcomingInvoice = Message<"toshi.workspace.v1.UpcomingInvoice"> & {
+    /**
+     * The amount due, in the currency's minor unit, after the customer
+     * balance (such as a starter credit) is applied.
+     *
+     * @generated from field: int64 amount_cents = 1;
+     */
+    amountCents: bigint;
+    /**
+     * The ISO currency code in lower case, such as "usd".
+     *
+     * @generated from field: string currency = 2;
+     */
+    currency: string;
+    /**
+     * The period the invoice covers.
+     *
+     * @generated from field: google.protobuf.Timestamp period_start = 3;
+     */
+    periodStart?: Timestamp | undefined;
+    /**
+     * @generated from field: google.protobuf.Timestamp period_end = 4;
+     */
+    periodEnd?: Timestamp | undefined;
+    /**
+     * When the usage behind this answer was read. Meter events reach the
+     * provider asynchronously, so the preview may not yet include usage
+     * read at this time.
+     *
+     * @generated from field: google.protobuf.Timestamp meters_read_at = 5;
+     */
+    metersReadAt?: Timestamp | undefined;
+    /**
+     * False when the workspace has no billing customer, or the provider has
+     * no upcoming invoice for it: the other fields are then empty.
+     *
+     * @generated from field: bool available = 6;
+     */
+    available: boolean;
+};
+/**
+ * UpcomingInvoice is the billing provider's preview of a workspace's next
+ * invoice.
+ *
+ * @generated from message toshi.workspace.v1.UpcomingInvoice
+ */
+export type UpcomingInvoiceJson = {
+    /**
+     * The amount due, in the currency's minor unit, after the customer
+     * balance (such as a starter credit) is applied.
+     *
+     * @generated from field: int64 amount_cents = 1;
+     */
+    amountCents?: string;
+    /**
+     * The ISO currency code in lower case, such as "usd".
+     *
+     * @generated from field: string currency = 2;
+     */
+    currency?: string;
+    /**
+     * The period the invoice covers.
+     *
+     * @generated from field: google.protobuf.Timestamp period_start = 3;
+     */
+    periodStart?: TimestampJson;
+    /**
+     * @generated from field: google.protobuf.Timestamp period_end = 4;
+     */
+    periodEnd?: TimestampJson;
+    /**
+     * When the usage behind this answer was read. Meter events reach the
+     * provider asynchronously, so the preview may not yet include usage
+     * read at this time.
+     *
+     * @generated from field: google.protobuf.Timestamp meters_read_at = 5;
+     */
+    metersReadAt?: TimestampJson;
+    /**
+     * False when the workspace has no billing customer, or the provider has
+     * no upcoming invoice for it: the other fields are then empty.
+     *
+     * @generated from field: bool available = 6;
+     */
+    available?: boolean;
+};
+/**
+ * Describes the message toshi.workspace.v1.UpcomingInvoice.
+ * Use `create(UpcomingInvoiceSchema)` to create a new message.
+ */
+export declare const UpcomingInvoiceSchema: GenMessage<UpcomingInvoice, {
+    jsonType: UpcomingInvoiceJson;
+}>;
+/**
+ * ProjectCost is one project's cost in the current UTC month.
+ *
+ * @generated from message toshi.workspace.v1.ProjectCost
+ */
+export type ProjectCost = Message<"toshi.workspace.v1.ProjectCost"> & {
+    /**
+     * The project's id and name. An empty project_id is the cost no project
+     * accounts for: the own-host fee, storage, desktop seats, and minutes of
+     * jobs with no project, a deleted project, or that history retention
+     * already removed.
+     *
+     * @generated from field: string project_id = 1;
+     */
+    projectId: string;
+    /**
+     * @generated from field: string project_name = 2;
+     */
+    projectName: string;
+    /**
+     * The cost of the month so far, in the currency's minor unit.
+     *
+     * @generated from field: int64 month_so_far_cents = 3;
+     */
+    monthSoFarCents: bigint;
+    /**
+     * month_so_far_cents carried in a straight line to the month's end: so
+     * far times the month's length over the time elapsed. Desktop seats are
+     * a whole-month charge and are not carried forward.
+     *
+     * @generated from field: int64 estimated_month_cents = 4;
+     */
+    estimatedMonthCents: bigint;
+};
+/**
+ * ProjectCost is one project's cost in the current UTC month.
+ *
+ * @generated from message toshi.workspace.v1.ProjectCost
+ */
+export type ProjectCostJson = {
+    /**
+     * The project's id and name. An empty project_id is the cost no project
+     * accounts for: the own-host fee, storage, desktop seats, and minutes of
+     * jobs with no project, a deleted project, or that history retention
+     * already removed.
+     *
+     * @generated from field: string project_id = 1;
+     */
+    projectId?: string;
+    /**
+     * @generated from field: string project_name = 2;
+     */
+    projectName?: string;
+    /**
+     * The cost of the month so far, in the currency's minor unit.
+     *
+     * @generated from field: int64 month_so_far_cents = 3;
+     */
+    monthSoFarCents?: string;
+    /**
+     * month_so_far_cents carried in a straight line to the month's end: so
+     * far times the month's length over the time elapsed. Desktop seats are
+     * a whole-month charge and are not carried forward.
+     *
+     * @generated from field: int64 estimated_month_cents = 4;
+     */
+    estimatedMonthCents?: string;
+};
+/**
+ * Describes the message toshi.workspace.v1.ProjectCost.
+ * Use `create(ProjectCostSchema)` to create a new message.
+ */
+export declare const ProjectCostSchema: GenMessage<ProjectCost, {
+    jsonType: ProjectCostJson;
+}>;
 /**
  * Seat is one assignment of a desktop seat to a person.
  *
@@ -3782,8 +4050,8 @@ export declare const StorageSchema: GenMessage<Storage, {
     jsonType: StorageJson;
 }>;
 /**
- * StoredKind is one kind of stored data in a month: image, volume_version,
- * artifact or recording.
+ * StoredKind is one kind of stored data in a month: images, volume_versions,
+ * artifacts, recordings or held_disks.
  *
  * @generated from message toshi.workspace.v1.StoredKind
  */
@@ -3806,8 +4074,8 @@ export type StoredKind = Message<"toshi.workspace.v1.StoredKind"> & {
     gbHours: number;
 };
 /**
- * StoredKind is one kind of stored data in a month: image, volume_version,
- * artifact or recording.
+ * StoredKind is one kind of stored data in a month: images, volume_versions,
+ * artifacts, recordings or held_disks.
  *
  * @generated from message toshi.workspace.v1.StoredKind
  */
@@ -5075,6 +5343,23 @@ export declare const WorkspaceService: GenService<{
         input: typeof GetWorkspaceStatementRequestSchema;
         output: typeof GetWorkspaceStatementResponseSchema;
     };
+    /**
+     * GetWorkspaceUpcomingInvoice returns the billing provider's preview of
+     * the workspace's next invoice, and the current UTC month's cost so far
+     * per project with a straight-line estimate to the month's end. The cost
+     * comes from the same usage and prices as GetWorkspaceStatement, and the
+     * projects' cost so far sums to its estimated_cents. Meter events reach
+     * the provider asynchronously, so the preview can lag the usage; the
+     * invoice is what is billed, and no estimate here changes it. A workspace
+     * with no billing customer gets a preview with available false.
+     *
+     * @generated from rpc toshi.workspace.v1.WorkspaceService.GetWorkspaceUpcomingInvoice
+     */
+    getWorkspaceUpcomingInvoice: {
+        methodKind: "unary";
+        input: typeof GetWorkspaceUpcomingInvoiceRequestSchema;
+        output: typeof GetWorkspaceUpcomingInvoiceResponseSchema;
+    };
     /**
      * ListSeats returns the desktop seats the workspace held in one UTC
      * month, oldest assigned first: the seats live at some time in it,