@nirvana-labs/nirvana 1.91.3 → 1.91.5

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

@@ -0,0 +1,124 @@
+// 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 PoolsAPI from './pools';
+import { APIPromise } from '../../../../core/api-promise';
+import { RequestOptions } from '../../../../internal/request-options';
+import { path } from '../../../../internal/utils/path';
+
+export class Cost extends APIResource {
+  /**
+   * Return a priced cost quote for the proposed NKS node pool.
+   *
+   * @example
+   * ```ts
+   * const costQuote =
+   *   await client.nks.clusters.pools.cost.create(
+   *     'cluster_id',
+   *     {
+   *       name: 'my-node-pool',
+   *       node_config: {
+   *         boot_volume: { size: 100, type: 'abs' },
+   *         instance_type: 'n1-standard-8',
+   *       },
+   *       node_count: 3,
+   *     },
+   *   );
+   * ```
+   */
+  create(clusterID: string, body: CostCreateParams, options?: RequestOptions): APIPromise<Shared.CostQuote> {
+    return this._client.post(path`/v1/nks/clusters/${clusterID}/pools/cost`, { body, ...options });
+  }
+
+  /**
+   * Return a priced cost quote for the proposed NKS node pool update plus a diff
+   * against the current state.
+   *
+   * @example
+   * ```ts
+   * const costQuoteUpdate =
+   *   await client.nks.clusters.pools.cost.update('pool_id', {
+   *     cluster_id: 'cluster_id',
+   *   });
+   * ```
+   */
+  update(
+    poolID: string,
+    params: CostUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<Shared.CostQuoteUpdate> {
+    const { cluster_id, ...body } = params;
+    return this._client.patch(path`/v1/nks/clusters/${cluster_id}/pools/${poolID}/cost`, {
+      body,
+      ...options,
+    });
+  }
+}
+
+export interface CostCreateParams {
+  /**
+   * Name of the node pool.
+   */
+  name: string;
+
+  /**
+   * Node configuration.
+   */
+  node_config: PoolsAPI.NKSNodePoolNodeConfig;
+
+  /**
+   * Number of nodes. Must be between 1 and 100.
+   */
+  node_count: number;
+
+  /**
+   * Tags to attach to the node pool.
+   */
+  tags?: Array<string>;
+}
+
+export interface CostUpdateParams {
+  /**
+   * Path param: Cluster ID
+   */
+  cluster_id: string;
+
+  /**
+   * Body param: Name of the node pool.
+   */
+  name?: string;
+
+  /**
+   * Body param: Partial node configuration update.
+   */
+  node_config?: CostUpdateParams.NodeConfig;
+
+  /**
+   * Body param: Number of nodes.
+   */
+  node_count?: number;
+
+  /**
+   * Body param: Tags to attach to the node pool.
+   */
+  tags?: Array<string>;
+}
+
+export namespace CostUpdateParams {
+  /**
+   * Partial node configuration update.
+   */
+  export interface NodeConfig {
+    /**
+     * Kubernetes labels to apply to each node in the pool. Each entry is "key=value".
+     * When provided, the list fully replaces the current labels on the pool and on
+     * live nodes.
+     */
+    labels?: Array<string>;
+  }
+}
+
+export declare namespace Cost {
+  export { type CostCreateParams as CostCreateParams, type CostUpdateParams as CostUpdateParams };
+}

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

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 export { Availability, type AvailabilityCreateParams, type AvailabilityUpdateParams } from './availability';
+export { Cost, type CostCreateParams, type CostUpdateParams } from './cost';
 export {
   Nodes,
   type NKSNode,

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

@@ -6,6 +6,8 @@ import * as OperationsAPI from '../../../operations/operations';
 import * as VolumesAPI from '../../../compute/volumes/volumes';
 import * as AvailabilityAPI from './availability';
 import { Availability, AvailabilityCreateParams, AvailabilityUpdateParams } from './availability';
+import * as CostAPI from './cost';
+import { Cost, CostCreateParams, CostUpdateParams } from './cost';
 import * as NodesAPI from './nodes/nodes';
 import {
   NKSNode,
@@ -23,6 +25,7 @@ import { path } from '../../../../internal/utils/path';
 
 export class Pools extends APIResource {
   availability: AvailabilityAPI.Availability = new AvailabilityAPI.Availability(this._client);
+  cost: CostAPI.Cost = new CostAPI.Cost(this._client);
   nodes: NodesAPI.Nodes = new NodesAPI.Nodes(this._client);
 
   /**
@@ -357,6 +360,7 @@ export interface PoolDeleteParams {
 export interface PoolListParams extends CursorParams {}
 
 Pools.Availability = Availability;
+Pools.Cost = Cost;
 Pools.Nodes = Nodes;
 
 export declare namespace Pools {
@@ -381,6 +385,12 @@ export declare namespace Pools {
     type AvailabilityUpdateParams as AvailabilityUpdateParams,
   };
 
+  export {
+    Cost as Cost,
+    type CostCreateParams as CostCreateParams,
+    type CostUpdateParams as CostUpdateParams,
+  };
+
   export {
     Nodes as Nodes,
     type NKSNode as NKSNode,

package/src/resources/shared.ts

@@ -1,5 +1,272 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+/**
+ * Cost quote returned by POST /cost.
+ */
+export interface CostQuote {
+  /**
+   * Currency the quote is denominated in. Always "USD" in v1.
+   */
+  currency: string;
+
+  /**
+   * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+   */
+  monthly_total: string;
+
+  /**
+   * Timestamp the quote was priced at.
+   */
+  priced_at: string;
+
+  /**
+   * Priced rows, one per usage dimension emitted by the resource.
+   */
+  usage_dimensions: Array<CostQuote.UsageDimension>;
+}
+
+export namespace CostQuote {
+  /**
+   * Priced row for a single usage dimension emitted by a resource.
+   */
+  export interface UsageDimension {
+    /**
+     * Usage dimension being priced (e.g. compute_vcpu, storage_abs_gb).
+     */
+    dimension: string;
+
+    /**
+     * User-facing label for the dimension (e.g. "vCPU (hours)").
+     */
+    dimension_display_name: string;
+
+    /**
+     * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+     */
+    monthly_amount: string;
+
+    /**
+     * Quantity of the dimension being priced.
+     */
+    quantity: number;
+
+    /**
+     * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+     */
+    unit_price: string;
+  }
+}
+
+/**
+ * Cost quote returned by PATCH /:id/cost: the current-state quote, the post-update
+ * quote, and the signed diff.
+ */
+export interface CostQuoteUpdate {
+  /**
+   * Quote for the proposed (post-update) resource state.
+   */
+  after: CostQuoteUpdate.After;
+
+  /**
+   * Quote for the proposed (post-update) resource state.
+   */
+  before: CostQuoteUpdate.Before;
+
+  /**
+   * Currency the quote is denominated in. Always "USD" in v1.
+   */
+  currency: string;
+
+  /**
+   * Per-dimension and total deltas: after minus before.
+   */
+  diff: CostQuoteUpdate.Diff;
+
+  /**
+   * Timestamp the quote was priced at.
+   */
+  priced_at: string;
+}
+
+export namespace CostQuoteUpdate {
+  /**
+   * Quote for the proposed (post-update) resource state.
+   */
+  export interface After {
+    /**
+     * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+     */
+    monthly_total: string;
+
+    /**
+     * Priced rows, one per usage dimension emitted by the resource.
+     */
+    usage_dimensions: Array<After.UsageDimension>;
+  }
+
+  export namespace After {
+    /**
+     * Priced row for a single usage dimension emitted by a resource.
+     */
+    export interface UsageDimension {
+      /**
+       * Usage dimension being priced (e.g. compute_vcpu, storage_abs_gb).
+       */
+      dimension: string;
+
+      /**
+       * User-facing label for the dimension (e.g. "vCPU (hours)").
+       */
+      dimension_display_name: string;
+
+      /**
+       * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+       */
+      monthly_amount: string;
+
+      /**
+       * Quantity of the dimension being priced.
+       */
+      quantity: number;
+
+      /**
+       * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+       */
+      unit_price: string;
+    }
+  }
+
+  /**
+   * Quote for the proposed (post-update) resource state.
+   */
+  export interface Before {
+    /**
+     * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+     */
+    monthly_total: string;
+
+    /**
+     * Priced rows, one per usage dimension emitted by the resource.
+     */
+    usage_dimensions: Array<Before.UsageDimension>;
+  }
+
+  export namespace Before {
+    /**
+     * Priced row for a single usage dimension emitted by a resource.
+     */
+    export interface UsageDimension {
+      /**
+       * Usage dimension being priced (e.g. compute_vcpu, storage_abs_gb).
+       */
+      dimension: string;
+
+      /**
+       * User-facing label for the dimension (e.g. "vCPU (hours)").
+       */
+      dimension_display_name: string;
+
+      /**
+       * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+       */
+      monthly_amount: string;
+
+      /**
+       * Quantity of the dimension being priced.
+       */
+      quantity: number;
+
+      /**
+       * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+       */
+      unit_price: string;
+    }
+  }
+
+  /**
+   * Per-dimension and total deltas: after minus before.
+   */
+  export interface Diff {
+    /**
+     * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+     */
+    monthly_total_delta: string;
+
+    /**
+     * Per-dimension diff entries. Includes every dimension touched by the update.
+     */
+    usage_dimensions: Array<Diff.UsageDimension>;
+  }
+
+  export namespace Diff {
+    /**
+     * Per-dimension diff entry. Both before and after are always present.
+     */
+    export interface UsageDimension {
+      /**
+       * Priced row after the update. Always present.
+       */
+      after: UsageDimension.After;
+
+      /**
+       * Priced row after the update. Always present.
+       */
+      before: UsageDimension.Before;
+
+      /**
+       * Usage dimension being priced (e.g. compute_vcpu, storage_abs_gb).
+       */
+      dimension: string;
+
+      /**
+       * User-facing label for the dimension (e.g. "vCPU (hours)").
+       */
+      dimension_display_name: string;
+
+      /**
+       * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+       */
+      monthly_amount_delta: string;
+    }
+
+    export namespace UsageDimension {
+      /**
+       * Priced row after the update. Always present.
+       */
+      export interface After {
+        /**
+         * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+         */
+        monthly_amount: string;
+
+        quantity: number;
+
+        /**
+         * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+         */
+        unit_price: string;
+      }
+
+      /**
+       * Priced row after the update. Always present.
+       */
+      export interface Before {
+        /**
+         * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+         */
+        monthly_amount: string;
+
+        quantity: number;
+
+        /**
+         * Arbitrary-precision decimal serialized as a string (e.g. "58.40").
+         */
+        unit_price: string;
+      }
+    }
+  }
+}
+
 /**
  * Pagination response details.
  */

package/src/version.ts

@@ -1 +1 @@
-export const VERSION = '1.91.3'; // x-release-please-version
+export const VERSION = '1.91.5'; // x-release-please-version

package/version.d.mts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.91.3";
+export declare const VERSION = "1.91.5";
 //# sourceMappingURL=version.d.mts.map

package/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "1.91.3";
+export declare const VERSION = "1.91.5";
 //# sourceMappingURL=version.d.ts.map

package/version.js

@@ -1,5 +1,5 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = void 0;
-exports.VERSION = '1.91.3'; // x-release-please-version
+exports.VERSION = '1.91.5'; // x-release-please-version
 //# sourceMappingURL=version.js.map

package/version.mjs

@@ -1,2 +1,2 @@
-export const VERSION = '1.91.3'; // x-release-please-version
+export const VERSION = '1.91.5'; // x-release-please-version
 //# sourceMappingURL=version.mjs.map