@nirvana-labs/nirvana 1.55.3 → 1.56.0

package/src/resources/nks/clusters/kubeconfig.ts

@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as ClustersAPI from './clusters';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Kubeconfig extends APIResource {
+  /**
+   * Get the kubeconfig for an NKS cluster
+   *
+   * @example
+   * ```ts
+   * const kubeconfig = await client.nks.clusters.kubeconfig.get(
+   *   'cluster_id',
+   * );
+   * ```
+   */
+  get(clusterID: string, options?: RequestOptions): APIPromise<ClustersAPI.Kubeconfig> {
+    return this._client.get(path`/v1/nks/clusters/${clusterID}/kubeconfig`, options);
+  }
+}

package/src/resources/nks/clusters/pools/availability.ts

@@ -0,0 +1,103 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../core/resource';
+import * as PoolsAPI from './pools';
+import { APIPromise } from '../../../../core/api-promise';
+import { buildHeaders } from '../../../../internal/headers';
+import { RequestOptions } from '../../../../internal/request-options';
+import { path } from '../../../../internal/utils/path';
+
+export class Availability extends APIResource {
+  /**
+   * Check if a node pool can be created in an NKS cluster
+   *
+   * @example
+   * ```ts
+   * await client.nks.clusters.pools.availability.create(
+   *   'cluster_id',
+   *   {
+   *     name: 'my-node-pool',
+   *     node_config: {
+   *       ram_gi: 8,
+   *       storage_gi: 100,
+   *       vcpu: 4,
+   *     },
+   *     node_count: 3,
+   *   },
+   * );
+   * ```
+   */
+  create(clusterID: string, body: AvailabilityCreateParams, options?: RequestOptions): APIPromise<void> {
+    return this._client.post(path`/v1/nks/clusters/${clusterID}/pools/availability`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+
+  /**
+   * Check if an NKS node pool can be updated
+   *
+   * @example
+   * ```ts
+   * await client.nks.clusters.pools.availability.update(
+   *   'pool_id',
+   *   { cluster_id: 'cluster_id' },
+   * );
+   * ```
+   */
+  update(poolID: string, params: AvailabilityUpdateParams, options?: RequestOptions): APIPromise<void> {
+    const { cluster_id, ...body } = params;
+    return this._client.patch(path`/v1/nks/clusters/${cluster_id}/pools/${poolID}/availability`, {
+      body,
+      ...options,
+      headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+    });
+  }
+}
+
+export interface AvailabilityCreateParams {
+  /**
+   * Name of the node pool.
+   */
+  name: string;
+
+  /**
+   * Node configuration.
+   */
+  node_config: PoolsAPI.NKSNodeConfig;
+
+  /**
+   * Number of nodes. Must be between 1 and 100.
+   */
+  node_count: number;
+
+  /**
+   * Tags to attach to the node pool.
+   */
+  tags?: Array<string>;
+}
+
+export interface AvailabilityUpdateParams {
+  /**
+   * Path param: Cluster ID
+   */
+  cluster_id: string;
+
+  /**
+   * Body param: Name of the node pool.
+   */
+  name?: string;
+
+  /**
+   * Body param: Tags to attach to the node pool.
+   */
+  tags?: Array<string>;
+}
+
+export declare namespace Availability {
+  export {
+    type AvailabilityCreateParams as AvailabilityCreateParams,
+    type AvailabilityUpdateParams as AvailabilityUpdateParams,
+  };
+}

package/src/resources/nks/clusters/pools/index.ts

@@ -0,0 +1,23 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export { Availability, type AvailabilityCreateParams, type AvailabilityUpdateParams } from './availability';
+export {
+  Nodes,
+  type NKSNode,
+  type NKSNodeList,
+  type NodeListParams,
+  type NodeGetParams,
+  type NKSNodesCursor,
+} from './nodes/index';
+export {
+  Pools,
+  type NKSNodeConfig,
+  type NKSNodePool,
+  type NKSNodePoolList,
+  type PoolCreateParams,
+  type PoolUpdateParams,
+  type PoolListParams,
+  type PoolDeleteParams,
+  type PoolGetParams,
+  type NKSNodePoolsCursor,
+} from './pools';

package/src/resources/nks/clusters/pools/nodes/index.ts

@@ -0,0 +1,18 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Nodes,
+  type NKSNode,
+  type NKSNodeList,
+  type NodeListParams,
+  type NodeGetParams,
+  type NKSNodesCursor,
+} from './nodes';
+export {
+  Volumes,
+  type NKSNodeVolume,
+  type NKSNodeVolumeList,
+  type VolumeListParams,
+  type VolumeGetParams,
+  type NKSNodeVolumesCursor,
+} from './volumes';

package/src/resources/nks/clusters/pools/nodes/nodes.ts

@@ -0,0 +1,150 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../../core/resource';
+import * as Shared from '../../../../shared';
+import * as VolumesAPI from './volumes';
+import {
+  NKSNodeVolume,
+  NKSNodeVolumeList,
+  NKSNodeVolumesCursor,
+  VolumeGetParams,
+  VolumeListParams,
+  Volumes,
+} from './volumes';
+import { APIPromise } from '../../../../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../../../../core/pagination';
+import { RequestOptions } from '../../../../../internal/request-options';
+import { path } from '../../../../../internal/utils/path';
+
+export class Nodes extends APIResource {
+  volumes: VolumesAPI.Volumes = new VolumesAPI.Volumes(this._client);
+
+  /**
+   * List all nodes in an NKS node pool
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const nksNode of client.nks.clusters.pools.nodes.list(
+   *   'pool_id',
+   *   { cluster_id: 'cluster_id' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    poolID: string,
+    params: NodeListParams,
+    options?: RequestOptions,
+  ): PagePromise<NKSNodesCursor, NKSNode> {
+    const { cluster_id, ...query } = params;
+    return this._client.getAPIList(
+      path`/v1/nks/clusters/${cluster_id}/pools/${poolID}/nodes`,
+      Cursor<NKSNode>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Get details about an NKS node
+   *
+   * @example
+   * ```ts
+   * const nksNode = await client.nks.clusters.pools.nodes.get(
+   *   'node_id',
+   *   { cluster_id: 'cluster_id', pool_id: 'pool_id' },
+   * );
+   * ```
+   */
+  get(nodeID: string, params: NodeGetParams, options?: RequestOptions): APIPromise<NKSNode> {
+    const { cluster_id, pool_id } = params;
+    return this._client.get(path`/v1/nks/clusters/${cluster_id}/pools/${pool_id}/nodes/${nodeID}`, options);
+  }
+}
+
+export type NKSNodesCursor = Cursor<NKSNode>;
+
+/**
+ * NKS node details.
+ */
+export interface NKSNode {
+  /**
+   * Unique identifier for the node.
+   */
+  id: string;
+
+  /**
+   * When the node was created.
+   */
+  created_at: string;
+
+  /**
+   * Name of the node.
+   */
+  name: string;
+
+  /**
+   * Private IP address of the node.
+   */
+  private_ip: string | null;
+
+  /**
+   * Status of the resource.
+   */
+  status: Shared.ResourceStatus;
+
+  /**
+   * When the node was last updated.
+   */
+  updated_at: string;
+}
+
+export interface NKSNodeList {
+  items: Array<NKSNode>;
+
+  /**
+   * Pagination response details.
+   */
+  pagination: Shared.Pagination;
+}
+
+export interface NodeListParams extends CursorParams {
+  /**
+   * Path param: Cluster ID
+   */
+  cluster_id: string;
+}
+
+export interface NodeGetParams {
+  /**
+   * Cluster ID
+   */
+  cluster_id: string;
+
+  /**
+   * Node Pool ID
+   */
+  pool_id: string;
+}
+
+Nodes.Volumes = Volumes;
+
+export declare namespace Nodes {
+  export {
+    type NKSNode as NKSNode,
+    type NKSNodeList as NKSNodeList,
+    type NKSNodesCursor as NKSNodesCursor,
+    type NodeListParams as NodeListParams,
+    type NodeGetParams as NodeGetParams,
+  };
+
+  export {
+    Volumes as Volumes,
+    type NKSNodeVolume as NKSNodeVolume,
+    type NKSNodeVolumeList as NKSNodeVolumeList,
+    type NKSNodeVolumesCursor as NKSNodeVolumesCursor,
+    type VolumeListParams as VolumeListParams,
+    type VolumeGetParams as VolumeGetParams,
+  };
+}

package/src/resources/nks/clusters/pools/nodes/volumes.ts

@@ -0,0 +1,152 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../../../core/resource';
+import * as Shared from '../../../../shared';
+import * as VolumesAPI from '../../../../compute/volumes/volumes';
+import { APIPromise } from '../../../../../core/api-promise';
+import { Cursor, type CursorParams, PagePromise } from '../../../../../core/pagination';
+import { RequestOptions } from '../../../../../internal/request-options';
+import { path } from '../../../../../internal/utils/path';
+
+export class Volumes extends APIResource {
+  /**
+   * List all volumes attached to an NKS node
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const nksNodeVolume of client.nks.clusters.pools.nodes.volumes.list(
+   *   'node_id',
+   *   { cluster_id: 'cluster_id', pool_id: 'pool_id' },
+   * )) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    nodeID: string,
+    params: VolumeListParams,
+    options?: RequestOptions,
+  ): PagePromise<NKSNodeVolumesCursor, NKSNodeVolume> {
+    const { cluster_id, pool_id, ...query } = params;
+    return this._client.getAPIList(
+      path`/v1/nks/clusters/${cluster_id}/pools/${pool_id}/nodes/${nodeID}/volumes`,
+      Cursor<NKSNodeVolume>,
+      { query, ...options },
+    );
+  }
+
+  /**
+   * Get details about a volume attached to an NKS node
+   *
+   * @example
+   * ```ts
+   * const nksNodeVolume =
+   *   await client.nks.clusters.pools.nodes.volumes.get(
+   *     'volume_id',
+   *     {
+   *       cluster_id: 'cluster_id',
+   *       pool_id: 'pool_id',
+   *       node_id: 'node_id',
+   *     },
+   *   );
+   * ```
+   */
+  get(volumeID: string, params: VolumeGetParams, options?: RequestOptions): APIPromise<NKSNodeVolume> {
+    const { cluster_id, pool_id, node_id } = params;
+    return this._client.get(
+      path`/v1/nks/clusters/${cluster_id}/pools/${pool_id}/nodes/${node_id}/volumes/${volumeID}`,
+      options,
+    );
+  }
+}
+
+export type NKSNodeVolumesCursor = Cursor<NKSNodeVolume>;
+
+/**
+ * NKS node volume details.
+ */
+export interface NKSNodeVolume {
+  /**
+   * Unique identifier for the volume.
+   */
+  id: string;
+
+  /**
+   * When the volume was created.
+   */
+  created_at: string;
+
+  /**
+   * Volume kind.
+   */
+  kind: VolumesAPI.VolumeKind;
+
+  /**
+   * Name of the volume.
+   */
+  name: string;
+
+  /**
+   * Status of the resource.
+   */
+  status: Shared.ResourceStatus;
+
+  /**
+   * Type of the Volume.
+   */
+  type: VolumesAPI.VolumeType;
+
+  /**
+   * When the volume was last updated.
+   */
+  updated_at: string;
+}
+
+export interface NKSNodeVolumeList {
+  items: Array<NKSNodeVolume>;
+
+  /**
+   * Pagination response details.
+   */
+  pagination: Shared.Pagination;
+}
+
+export interface VolumeListParams extends CursorParams {
+  /**
+   * Path param: Cluster ID
+   */
+  cluster_id: string;
+
+  /**
+   * Path param: Node Pool ID
+   */
+  pool_id: string;
+}
+
+export interface VolumeGetParams {
+  /**
+   * Cluster ID
+   */
+  cluster_id: string;
+
+  /**
+   * Node Pool ID
+   */
+  pool_id: string;
+
+  /**
+   * Node ID
+   */
+  node_id: string;
+}
+
+export declare namespace Volumes {
+  export {
+    type NKSNodeVolume as NKSNodeVolume,
+    type NKSNodeVolumeList as NKSNodeVolumeList,
+    type NKSNodeVolumesCursor as NKSNodeVolumesCursor,
+    type VolumeListParams as VolumeListParams,
+    type VolumeGetParams as VolumeGetParams,
+  };
+}

package/src/resources/nks/clusters/pools/nodes.ts

@@ -0,0 +1,3 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export * from './nodes/index';