@origincloud/pvs 0.0.0-stage → 0.1.0

package/dist/v1beta1/volume.js

@@ -0,0 +1,169 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/pvs/v1beta1/volume.proto
+import { Operation, newRequestId, pathValue, query, } from "@origincloud/core";
+/**
+ * Calls VolumeService.
+ *
+ * Block storage volumes: durable disks in one zone that an instance attaches
+ * to read and write.
+ */
+export class VolumeClient {
+    /**
+     * The endpoint the client sends its calls to, which also serves the
+     * operations its methods answer with.
+     */
+    service;
+    /** A client of VolumeService that sends its calls through `client`. */
+    constructor(client) {
+        this.service = client.service("pvs", true);
+    }
+    /** Returns a volume. */
+    async getVolume(request, options) {
+        const p0 = pathValue("name", request.name, "projects/*/zones/*/volumes/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}`,
+            query: query(request, ["name"]),
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Lists the volumes in a zone, oldest first. Deleted volumes aren't
+     * listed. For every zone's volumes, list the zones whose `services` name
+     * `pvs` with the location service (`location.origincloudapis.eu`), then
+     * each zone's volumes.
+     */
+    async listVolumes(request, options) {
+        const p0 = pathValue("parent", request.parent, "projects/*/zones/*");
+        return this.service.call({
+            method: "GET",
+            path: `/v1beta1/${p0}/volumes`,
+            query: query(request, ["parent"]),
+            idempotent: true,
+        }, options);
+    }
+    /**
+     * Iterates over everything listVolumes 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 *allVolumes(request, options) {
+        for (let page = request;;) {
+            const response = await this.listVolumes(page, options);
+            yield* response.volumes ?? [];
+            if (!response.nextPageToken)
+                return;
+            page = { ...page, pageToken: response.nextPageToken };
+        }
+    }
+    /**
+     * Creates a volume, empty or as a copy of a snapshot. The operation is
+     * done once the volume is `AVAILABLE`, or failed once it is `ERROR`.
+     *
+     * It answers with an operation to wait on, whose result is the Volume.
+     */
+    async createVolume(request, options) {
+        if (!request.requestId)
+            request = { ...request, requestId: newRequestId() };
+        const p0 = pathValue("parent", request.parent, "projects/*/zones/*");
+        const op = await this.service.call({
+            method: "POST",
+            path: `/v1beta1/${p0}/volumes`,
+            body: request.volume,
+            query: query(request, ["parent", "volume"]),
+            idempotent: true,
+        }, options);
+        return new Operation(this.service, op, "origincloud.pvs.v1beta1.Volume");
+    }
+    /**
+     * Creates a volume whose initial content is a disk image the platform
+     * downloads. The operation is done once the volume is `AVAILABLE`.
+     *
+     * It answers with an operation to wait on, whose result is the Volume.
+     */
+    async importVolume(request, options) {
+        if (!request.requestId)
+            request = { ...request, requestId: newRequestId() };
+        const p0 = pathValue("parent", request.parent, "projects/*/zones/*");
+        const op = await this.service.call({
+            method: "POST",
+            path: `/v1beta1/${p0}/volumes:import`,
+            body: request,
+            idempotent: true,
+        }, options);
+        return new Operation(this.service, op, "origincloud.pvs.v1beta1.Volume");
+    }
+    /**
+     * Changes a volume's size or tags. A larger `sizeGib` grows the volume,
+     * attached or not; it never shrinks, and the size it already has changes
+     * nothing. The operation is done once the volume reports the new size.
+     *
+     * It answers with an operation to wait on, whose result is the Volume.
+     */
+    async updateVolume(request, options) {
+        if (!request.requestId)
+            request = { ...request, requestId: newRequestId() };
+        const p0 = pathValue("volume.name", request.volume?.name, "projects/*/zones/*/volumes/*");
+        const op = await this.service.call({
+            method: "PATCH",
+            path: `/v1beta1/${p0}`,
+            body: request.volume,
+            query: query(request, ["volume.name", "volume"]),
+            idempotent: true,
+        }, options);
+        return new Operation(this.service, op, "origincloud.pvs.v1beta1.Volume");
+    }
+    /**
+     * Deletes a volume. It must not be attached, and none of its snapshots
+     * may be left. The operation is done once the volume is `DELETED`.
+     *
+     * It answers with an operation to wait on, which has no result.
+     */
+    async deleteVolume(request, options) {
+        if (!request.requestId)
+            request = { ...request, requestId: newRequestId() };
+        const p0 = pathValue("name", request.name, "projects/*/zones/*/volumes/*");
+        const op = await this.service.call({
+            method: "DELETE",
+            path: `/v1beta1/${p0}`,
+            query: query(request, ["name"]),
+            idempotent: true,
+        }, options);
+        return new Operation(this.service, op, "google.protobuf.Empty");
+    }
+}
+/** Where the volume is in its lifecycle. */
+export const Volume_State = {
+    /** Not set. */
+    STATE_UNSPECIFIED: "STATE_UNSPECIFIED",
+    /** Being created. */
+    CREATING: "CREATING",
+    /** Ready to attach. */
+    AVAILABLE: "AVAILABLE",
+    /** Attached to an instance. */
+    IN_USE: "IN_USE",
+    /** Being deleted. */
+    DELETING: "DELETING",
+    /** Deleted. Readable by name for a day, never listed. */
+    DELETED: "DELETED",
+    /**
+     * Its storage couldn't be created or removed; `stateReason` says
+     * which. It can be deleted again.
+     */
+    ERROR: "ERROR",
+};
+/** Where a resize is. */
+export const Volume_ResizeState = {
+    /** Not set. */
+    RESIZE_STATE_UNSPECIFIED: "RESIZE_STATE_UNSPECIFIED",
+    /** No resize is under way; the last one, if any, finished. */
+    RESIZE_COMPLETED: "RESIZE_COMPLETED",
+    /** Growing to `pendingSizeGib`. */
+    RESIZING: "RESIZING",
+    /**
+     * The last resize failed; `resizeReason` says why. The volume and its
+     * data are unaffected.
+     */
+    RESIZE_FAILED: "RESIZE_FAILED",
+};
+//# sourceMappingURL=volume.js.map

package/dist/v1beta1/volume.js.map

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

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@origincloud/pvs",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "Origin Cloud's persistent volume service (PVS): volumes, snapshots and storage classes.",
+  "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/pvs"
+  },
+  "bugs": "https://github.com/origincloudhq/sdk-typescript/issues",
+  "keywords": [
+    "origincloud",
+    "origin-cloud",
+    "sdk",
+    "pvs",
+    "volumes"
+  ],
+  "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.1.0"
+  },
+  "devDependencies": {
+    "@origincloud/core": "^0.1.0"
+  }
+}

package/src/longrunning/v1beta1/index.ts

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

package/src/longrunning/v1beta1/operations.ts

@@ -0,0 +1,101 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/longrunning/v1beta1/operations.proto
+
+import {
+  type CallOptions,
+  type Client,
+  type LongrunningOperation,
+  type Service,
+  pathValue,
+  query,
+} from "@origincloud/core";
+
+/**
+ * Calls OperationService.
+ *
+ * The long-running operations of a service: what its creates, updates and
+ * deletes answer with, until their resource settles. Every service serves
+ * this at its own host, for the operations its own methods return.
+ *
+ * An operation is done when its resource reaches the state its method
+ * promises, or failed when it can't get there; that outcome never changes
+ * afterwards, whatever later happens to the resource. It can be read for a
+ * day after it is done.
+ */
+export class OperationClient {
+  /**
+   * The endpoint the client sends its calls to, which also serves the
+   * operations its methods answer with.
+   */
+  readonly service: Service;
+
+  /**
+   * A client of OperationService at the pvs host, which serves the
+   * operations the pvs methods answer with.
+   */
+  constructor(client: Client) {
+    this.service = client.service("pvs", true);
+  }
+
+  /** Returns an operation as it is now. */
+  async getOperation(request: GetOperationRequest, options?: CallOptions): Promise<LongrunningOperation> {
+    const p0 = pathValue("name", request.name, "projects/*/zones/*/operations/*");
+    return this.service.call<LongrunningOperation>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}`,
+        query: query(request, ["name"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Waits until an operation is done or `timeout` has passed, whichever
+   * comes first, and returns it as it is then.
+   */
+  async waitOperation(request: WaitOperationRequest, options?: CallOptions): Promise<LongrunningOperation> {
+    const p0 = pathValue("name", request.name, "projects/*/zones/*/operations/*");
+    return this.service.call<LongrunningOperation>(
+      {
+        method: "POST",
+        path: `/v1beta1/${p0}:wait`,
+        body: request,
+      },
+      options,
+    );
+  }
+}
+
+/** The request for GetOperation. */
+export interface GetOperationRequest {
+  /**
+   * The operation to return, `projects/{project}/zones/{zone}/operations/{operation}`,
+   * exactly as a method returned it.
+   */
+  name?: string;
+}
+
+/** The request for WaitOperation. */
+export interface WaitOperationRequest {
+  /** The operation to wait for, exactly as a method returned it. */
+  name?: string;
+  /** The longest to wait, at most a minute; a minute when not set. */
+  timeout?: string;
+}
+
+/** What an operation is about. */
+export interface OperationMetadata {
+  /** The resource the operation acts on. */
+  target?: string;
+  /**
+   * What it does, as the method that started it names it: for example
+   * `create`, `update` or `delete`.
+   */
+  verb?: string;
+  /** When it was accepted. */
+  createTime?: string;
+  /** When it finished; empty while it hasn't. */
+  endTime?: string;
+}

package/src/v1beta1/index.ts

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

package/src/v1beta1/snapshot.ts

@@ -0,0 +1,352 @@
+// Code generated by the SDK's generator (generator/). DO NOT EDIT.
+// source: origincloud/pvs/v1beta1/snapshot.proto
+
+import {
+  type CallOptions,
+  type Client,
+  type Empty,
+  type LongrunningOperation,
+  Operation,
+  type Service,
+  newRequestId,
+  pathValue,
+  query,
+} from "@origincloud/core";
+import type { OperationMetadata } from "../longrunning/v1beta1/operations.js";
+
+/**
+ * Calls SnapshotService.
+ *
+ * Snapshots: point-in-time copies of a volume, in the volume's zone. A
+ * protected, completed snapshot is the source of new volumes and images.
+ */
+export class SnapshotClient {
+  /**
+   * The endpoint the client sends its calls to, which also serves the
+   * operations its methods answer with.
+   */
+  readonly service: Service;
+
+  /** A client of SnapshotService that sends its calls through `client`. */
+  constructor(client: Client) {
+    this.service = client.service("pvs", true);
+  }
+
+  /** Returns a snapshot. */
+  async getSnapshot(request: GetSnapshotRequest, options?: CallOptions): Promise<Snapshot> {
+    const p0 = pathValue("name", request.name, "projects/*/zones/*/snapshots/*");
+    return this.service.call<Snapshot>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}`,
+        query: query(request, ["name"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Lists the snapshots in a zone, oldest first. Deleted snapshots aren't
+   * listed. For every zone's snapshots, list the zones whose `services` name
+   * `pvs` with the location service (`location.origincloudapis.eu`), then
+   * each zone's snapshots.
+   */
+  async listSnapshots(request: ListSnapshotsRequest, options?: CallOptions): Promise<ListSnapshotsResponse> {
+    const p0 = pathValue("parent", request.parent, "projects/*/zones/*");
+    return this.service.call<ListSnapshotsResponse>(
+      {
+        method: "GET",
+        path: `/v1beta1/${p0}/snapshots`,
+        query: query(request, ["parent"]),
+        idempotent: true,
+      },
+      options,
+    );
+  }
+
+  /**
+   * Iterates over everything listSnapshots 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 *allSnapshots(request: ListSnapshotsRequest, options?: CallOptions): AsyncGenerator<Snapshot, void, undefined> {
+    for (let page = request; ; ) {
+      const response = await this.listSnapshots(page, options);
+      yield* response.snapshots ?? [];
+      if (!response.nextPageToken) return;
+      page = { ...page, pageToken: response.nextPageToken };
+    }
+  }
+
+  /**
+   * Takes a snapshot of a volume. The operation is done once the copy is
+   * `COMPLETED`, or failed once it is `ERROR`.
+   *
+   * It answers with an operation to wait on, whose result is the Snapshot.
+   */
+  async createSnapshot(request: CreateSnapshotRequest, options?: CallOptions): Promise<Operation<Snapshot, OperationMetadata>> {
+    if (!request.requestId) request = { ...request, requestId: newRequestId() };
+    const p0 = pathValue("parent", request.parent, "projects/*/zones/*");
+    const op = await this.service.call<LongrunningOperation>(
+      {
+        method: "POST",
+        path: `/v1beta1/${p0}/snapshots`,
+        body: request.snapshot,
+        query: query(request, ["parent", "snapshot"]),
+        idempotent: true,
+      },
+      options,
+    );
+    return new Operation<Snapshot, OperationMetadata>(this.service, op, "origincloud.pvs.v1beta1.Snapshot");
+  }
+
+  /** Changes a snapshot's tags. */
+  async updateSnapshot(request: UpdateSnapshotRequest, options?: CallOptions): Promise<Snapshot> {
+    const p0 = pathValue("snapshot.name", request.snapshot?.name, "projects/*/zones/*/snapshots/*");
+    return this.service.call<Snapshot>(
+      {
+        method: "PATCH",
+        path: `/v1beta1/${p0}`,
+        body: request.snapshot,
+        query: query(request, ["snapshot.name", "snapshot"]),
+      },
+      options,
+    );
+  }
+
+  /**
+   * Deletes a snapshot. It must be `COMPLETED` or `ERROR`, and unprotected.
+   * The operation is done once the snapshot is `DELETED`.
+   *
+   * It answers with an operation to wait on, which has no result.
+   */
+  async deleteSnapshot(request: DeleteSnapshotRequest, options?: CallOptions): Promise<Operation<Empty, OperationMetadata>> {
+    if (!request.requestId) request = { ...request, requestId: newRequestId() };
+    const p0 = pathValue("name", request.name, "projects/*/zones/*/snapshots/*");
+    const op = await this.service.call<LongrunningOperation>(
+      {
+        method: "DELETE",
+        path: `/v1beta1/${p0}`,
+        query: query(request, ["name"]),
+        idempotent: true,
+      },
+      options,
+    );
+    return new Operation<Empty, OperationMetadata>(this.service, op, "google.protobuf.Empty");
+  }
+
+  /**
+   * Protects a snapshot, so it can be the source of volumes and images and
+   * can't be deleted. The operation is done once it is `PROTECTED`.
+   *
+   * It answers with an operation to wait on, whose result is the Snapshot.
+   */
+  async protectSnapshot(request: ProtectSnapshotRequest, options?: CallOptions): Promise<Operation<Snapshot, OperationMetadata>> {
+    if (!request.requestId) request = { ...request, requestId: newRequestId() };
+    const p0 = pathValue("name", request.name, "projects/*/zones/*/snapshots/*");
+    const op = await this.service.call<LongrunningOperation>(
+      {
+        method: "POST",
+        path: `/v1beta1/${p0}:protect`,
+        body: request,
+        idempotent: true,
+      },
+      options,
+    );
+    return new Operation<Snapshot, OperationMetadata>(this.service, op, "origincloud.pvs.v1beta1.Snapshot");
+  }
+
+  /**
+   * Unprotects a snapshot, so it can be deleted. Refused with
+   * `FAILED_PRECONDITION` while an image is built from it or a volume not
+   * `DELETED` was created from it; delete those first. The operation is
+   * done once it is `UNPROTECTED`.
+   *
+   * It answers with an operation to wait on, whose result is the Snapshot.
+   */
+  async unprotectSnapshot(request: UnprotectSnapshotRequest, options?: CallOptions): Promise<Operation<Snapshot, OperationMetadata>> {
+    if (!request.requestId) request = { ...request, requestId: newRequestId() };
+    const p0 = pathValue("name", request.name, "projects/*/zones/*/snapshots/*");
+    const op = await this.service.call<LongrunningOperation>(
+      {
+        method: "POST",
+        path: `/v1beta1/${p0}:unprotect`,
+        body: request,
+        idempotent: true,
+      },
+      options,
+    );
+    return new Operation<Snapshot, OperationMetadata>(this.service, op, "origincloud.pvs.v1beta1.Snapshot");
+  }
+}
+
+/** A point-in-time copy of a volume. */
+export interface Snapshot {
+  /** The snapshot's resource name. */
+  name?: string;
+  /**
+   * The snapshot's URN, the identifier access policies and the audit log
+   * use.
+   */
+  urn?: string;
+  /** The volume copied, in the same project and zone. */
+  sourceVolume?: string;
+  /**
+   * The source volume's size in GiB when it was copied: the least a volume
+   * created from the snapshot holds.
+   */
+  sourceSizeGib?: number;
+  /** Where the copy is. */
+  state?: Snapshot_State;
+  /** Why the snapshot is in `ERROR`; empty otherwise. */
+  stateReason?: string;
+  /** Whether it is protected. */
+  protectionState?: Snapshot_ProtectionState;
+  /**
+   * Why the last protection change failed, when `protectionState` is
+   * `PROTECTION_FAILED`.
+   */
+  protectionReason?: string;
+  /**
+   * The principal that took the snapshot, 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 the copy is. */
+export const Snapshot_State = {
+  /** Not set. */
+  STATE_UNSPECIFIED: "STATE_UNSPECIFIED",
+  /** Being copied. */
+  PENDING: "PENDING",
+  /** Copied. */
+  COMPLETED: "COMPLETED",
+  /** Being deleted. */
+  DELETING: "DELETING",
+  /** Deleted. Readable by name for a day, never listed. */
+  DELETED: "DELETED",
+  /**
+   * The copy or its removal failed; `stateReason` says which. There is
+   * no usable copy behind it: delete it.
+   */
+  ERROR: "ERROR",
+} as const;
+
+/** Where the copy is. */
+export type Snapshot_State = (typeof Snapshot_State)[keyof typeof Snapshot_State];
+
+/** Whether the snapshot is protected, independently of `state`. */
+export const Snapshot_ProtectionState = {
+  /** Not set. */
+  PROTECTION_STATE_UNSPECIFIED: "PROTECTION_STATE_UNSPECIFIED",
+  /** Not protected: it can be deleted, and is no source. */
+  UNPROTECTED: "UNPROTECTED",
+  /** Becoming protected. */
+  PROTECTING: "PROTECTING",
+  /** Protected: a source of volumes and images, and can't be deleted. */
+  PROTECTED: "PROTECTED",
+  /** Becoming unprotected. */
+  UNPROTECTING: "UNPROTECTING",
+  /**
+   * The last change couldn't be applied; `protectionReason` says why.
+   * Protect or unprotect it again.
+   */
+  PROTECTION_FAILED: "PROTECTION_FAILED",
+} as const;
+
+/** Whether the snapshot is protected, independently of `state`. */
+export type Snapshot_ProtectionState = (typeof Snapshot_ProtectionState)[keyof typeof Snapshot_ProtectionState];
+
+/** The request for GetSnapshot. */
+export interface GetSnapshotRequest {
+  /** The snapshot to return. */
+  name?: string;
+}
+
+/** The request for ListSnapshots. */
+export interface ListSnapshotsRequest {
+  /** The zone whose snapshots to list, `projects/{project}/zones/{zone}`. */
+  parent?: string;
+  /**
+   * The most snapshots 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 ListSnapshots. */
+export interface ListSnapshotsResponse {
+  /** The snapshots on this page. */
+  snapshots?: Snapshot[];
+  /** The token for the next page; empty on the last one. */
+  nextPageToken?: string;
+}
+
+/** The request for CreateSnapshot. */
+export interface CreateSnapshotRequest {
+  /** The zone of the volume to copy, `projects/{project}/zones/{zone}`. */
+  parent?: string;
+  /** The snapshot to take: its source volume, and optionally its tags. */
+  snapshot?: Snapshot;
+  /**
+   * A UUID; a repeat with the same id returns the first request's
+   * operation instead of taking a second snapshot.
+   */
+  requestId?: string;
+}
+
+/** The request for UpdateSnapshot. */
+export interface UpdateSnapshotRequest {
+  /** The snapshot, by its name, with the tags to set. */
+  snapshot?: Snapshot;
+  /**
+   * The fields to change: `tags`, the only field that changes. `*` is the
+   * same.
+   */
+  updateMask?: string;
+}
+
+/** The request for DeleteSnapshot. */
+export interface DeleteSnapshotRequest {
+  /** The snapshot to delete. */
+  name?: string;
+  /**
+   * A UUID; a repeat with the same id returns the first request's
+   * operation.
+   */
+  requestId?: string;
+}
+
+/** The request for ProtectSnapshot. */
+export interface ProtectSnapshotRequest {
+  /** The snapshot to protect; it must be `COMPLETED`. */
+  name?: string;
+  /**
+   * A UUID; a repeat with the same id returns the first request's
+   * operation.
+   */
+  requestId?: string;
+}
+
+/** The request for UnprotectSnapshot. */
+export interface UnprotectSnapshotRequest {
+  /**
+   * The snapshot to unprotect; it must be `COMPLETED`, or `ERROR` so that
+   * it can then be deleted.
+   */
+  name?: string;
+  /**
+   * A UUID; a repeat with the same id returns the first request's
+   * operation.
+   */
+  requestId?: string;
+}