@nirvana-labs/nirvana 1.91.0 → 1.91.2

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

@@ -9,6 +9,30 @@ import { RequestOptions } from '../../../../../internal/request-options';
 import { path } from '../../../../../internal/utils/path';
 
 export class Volumes extends APIResource {
+  /**
+   * 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,
+    );
+  }
+
   /**
    * List all volumes attached to an NKS node
    *
@@ -35,30 +59,6 @@ export class Volumes extends APIResource {
       { 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>;
@@ -117,33 +117,33 @@ export interface NKSNodeVolumeList {
   pagination: Shared.Pagination;
 }
 
-export interface VolumeListParams extends CursorParams {
+export interface VolumeGetParams {
   /**
-   * Path param: Cluster ID
+   * Cluster ID
    */
   cluster_id: string;
 
   /**
-   * Path param: Node Pool ID
+   * Node Pool ID
    */
   pool_id: string;
-}
 
-export interface VolumeGetParams {
   /**
-   * Cluster ID
+   * Node ID
    */
-  cluster_id: string;
+  node_id: string;
+}
 
+export interface VolumeListParams extends CursorParams {
   /**
-   * Node Pool ID
+   * Path param: Cluster ID
    */
-  pool_id: string;
+  cluster_id: string;
 
   /**
-   * Node ID
+   * Path param: Node Pool ID
    */
-  node_id: string;
+  pool_id: string;
 }
 
 export declare namespace Volumes {
@@ -151,7 +151,7 @@ export declare namespace Volumes {
     type NKSNodeVolume as NKSNodeVolume,
     type NKSNodeVolumeList as NKSNodeVolumeList,
     type NKSNodeVolumesCursor as NKSNodeVolumesCursor,
-    type VolumeListParams as VolumeListParams,
     type VolumeGetParams as VolumeGetParams,
+    type VolumeListParams as VolumeListParams,
   };
 }

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

@@ -52,47 +52,39 @@ export class Pools extends APIResource {
   }
 
   /**
-   * Update an NKS node pool
+   * Get details about an NKS node pool
    *
    * @example
    * ```ts
-   * const operation = await client.nks.clusters.pools.update(
+   * const nksNodePool = await client.nks.clusters.pools.get(
    *   'pool_id',
    *   { cluster_id: 'cluster_id' },
    * );
    * ```
    */
-  update(
-    poolID: string,
-    params: PoolUpdateParams,
-    options?: RequestOptions,
-  ): APIPromise<OperationsAPI.Operation> {
-    const { cluster_id, ...body } = params;
-    return this._client.patch(path`/v1/nks/clusters/${cluster_id}/pools/${poolID}`, { body, ...options });
+  get(poolID: string, params: PoolGetParams, options?: RequestOptions): APIPromise<NKSNodePool> {
+    const { cluster_id } = params;
+    return this._client.get(path`/v1/nks/clusters/${cluster_id}/pools/${poolID}`, options);
   }
 
   /**
-   * List all node pools in an NKS cluster
+   * Update an NKS node pool
    *
    * @example
    * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const nksNodePool of client.nks.clusters.pools.list(
-   *   'cluster_id',
-   * )) {
-   *   // ...
-   * }
+   * const operation = await client.nks.clusters.pools.update(
+   *   'pool_id',
+   *   { cluster_id: 'cluster_id' },
+   * );
    * ```
    */
-  list(
-    clusterID: string,
-    query: PoolListParams | null | undefined = {},
+  update(
+    poolID: string,
+    params: PoolUpdateParams,
     options?: RequestOptions,
-  ): PagePromise<NKSNodePoolsCursor, NKSNodePool> {
-    return this._client.getAPIList(path`/v1/nks/clusters/${clusterID}/pools`, Cursor<NKSNodePool>, {
-      query,
-      ...options,
-    });
+  ): APIPromise<OperationsAPI.Operation> {
+    const { cluster_id, ...body } = params;
+    return this._client.patch(path`/v1/nks/clusters/${cluster_id}/pools/${poolID}`, { body, ...options });
   }
 
   /**
@@ -116,19 +108,27 @@ export class Pools extends APIResource {
   }
 
   /**
-   * Get details about an NKS node pool
+   * List all node pools in an NKS cluster
    *
    * @example
    * ```ts
-   * const nksNodePool = await client.nks.clusters.pools.get(
-   *   'pool_id',
-   *   { cluster_id: 'cluster_id' },
-   * );
+   * // Automatically fetches more pages as needed.
+   * for await (const nksNodePool of client.nks.clusters.pools.list(
+   *   'cluster_id',
+   * )) {
+   *   // ...
+   * }
    * ```
    */
-  get(poolID: string, params: PoolGetParams, options?: RequestOptions): APIPromise<NKSNodePool> {
-    const { cluster_id } = params;
-    return this._client.get(path`/v1/nks/clusters/${cluster_id}/pools/${poolID}`, options);
+  list(
+    clusterID: string,
+    query: PoolListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<NKSNodePoolsCursor, NKSNodePool> {
+    return this._client.getAPIList(path`/v1/nks/clusters/${clusterID}/pools`, Cursor<NKSNodePool>, {
+      query,
+      ...options,
+    });
   }
 }
 
@@ -286,6 +286,13 @@ export interface PoolCreateParams {
   tags?: Array<string>;
 }
 
+export interface PoolGetParams {
+  /**
+   * Cluster ID
+   */
+  cluster_id: string;
+}
+
 export interface PoolUpdateParams {
   /**
    * Path param: Cluster ID
@@ -327,8 +334,6 @@ export namespace PoolUpdateParams {
   }
 }
 
-export interface PoolListParams extends CursorParams {}
-
 export interface PoolDeleteParams {
   /**
    * Cluster ID
@@ -336,12 +341,7 @@ export interface PoolDeleteParams {
   cluster_id: string;
 }
 
-export interface PoolGetParams {
-  /**
-   * Cluster ID
-   */
-  cluster_id: string;
-}
+export interface PoolListParams extends CursorParams {}
 
 Pools.Availability = Availability;
 Pools.Nodes = Nodes;
@@ -356,10 +356,10 @@ export declare namespace Pools {
     type NKSNodePoolNodeConfigResponse as NKSNodePoolNodeConfigResponse,
     type NKSNodePoolsCursor as NKSNodePoolsCursor,
     type PoolCreateParams as PoolCreateParams,
+    type PoolGetParams as PoolGetParams,
     type PoolUpdateParams as PoolUpdateParams,
-    type PoolListParams as PoolListParams,
     type PoolDeleteParams as PoolDeleteParams,
-    type PoolGetParams as PoolGetParams,
+    type PoolListParams as PoolListParams,
   };
 
   export {
@@ -373,8 +373,8 @@ export declare namespace Pools {
     type NKSNode as NKSNode,
     type NKSNodeList as NKSNodeList,
     type NKSNodesCursor as NKSNodesCursor,
-    type NodeListParams as NodeListParams,
-    type NodeDeleteParams as NodeDeleteParams,
     type NodeGetParams as NodeGetParams,
+    type NodeDeleteParams as NodeDeleteParams,
+    type NodeListParams as NodeListParams,
   };
 }

package/src/resources/operations/api.md

@@ -13,5 +13,5 @@ Types:
 
 Methods:
 
-- <code title="get /v1/operations">client.operations.<a href="./src/resources/operations.ts">list</a>({ ...params }) -> OperationsCursor</code>
 - <code title="get /v1/operations/{operation_id}">client.operations.<a href="./src/resources/operations.ts">get</a>(operationID) -> Operation</code>
+- <code title="get /v1/operations">client.operations.<a href="./src/resources/operations.ts">list</a>({ ...params }) -> OperationsCursor</code>

package/src/resources/operations/operations.ts

@@ -9,17 +9,17 @@ import { path } from '../../internal/utils/path';
 
 export class Operations extends APIResource {
   /**
-   * List all operations
+   * Get details about a specific operation
    */
-  list(query: OperationListParams, options?: RequestOptions): PagePromise<OperationsCursor, Operation> {
-    return this._client.getAPIList('/v1/operations', Cursor<Operation>, { query, ...options });
+  get(operationID: string, options?: RequestOptions): APIPromise<Operation> {
+    return this._client.get(path`/v1/operations/${operationID}`, options);
   }
 
   /**
-   * Get details about a specific operation
+   * List all operations
    */
-  get(operationID: string, options?: RequestOptions): APIPromise<Operation> {
-    return this._client.get(path`/v1/operations/${operationID}`, options);
+  list(query: OperationListParams, options?: RequestOptions): PagePromise<OperationsCursor, Operation> {
+    return this._client.getAPIList('/v1/operations', Cursor<Operation>, { query, ...options });
   }
 }
 

package/src/resources/organizations/address.ts

@@ -0,0 +1,227 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../core/resource';
+import { APIPromise } from '../../core/api-promise';
+import { RequestOptions } from '../../internal/request-options';
+import { path } from '../../internal/utils/path';
+
+export class Address extends APIResource {
+  /**
+   * Create the address for an organization
+   *
+   * @example
+   * ```ts
+   * const organizationAddress =
+   *   await client.organizations.address.create(
+   *     'organization_id',
+   *     {
+   *       city: 'San Francisco',
+   *       country: 'US',
+   *       line1: '123 Main St',
+   *       postal_code: '94105',
+   *     },
+   *   );
+   * ```
+   */
+  create(
+    organizationID: string,
+    body: AddressCreateParams,
+    options?: RequestOptions,
+  ): APIPromise<OrganizationAddress> {
+    return this._client.post(path`/v1/organizations/${organizationID}/address`, { body, ...options });
+  }
+
+  /**
+   * Get the address for an organization
+   *
+   * @example
+   * ```ts
+   * const organizationAddress =
+   *   await client.organizations.address.get('organization_id');
+   * ```
+   */
+  get(organizationID: string, options?: RequestOptions): APIPromise<OrganizationAddress> {
+    return this._client.get(path`/v1/organizations/${organizationID}/address`, options);
+  }
+
+  /**
+   * Update the address for an organization
+   *
+   * @example
+   * ```ts
+   * const organizationAddress =
+   *   await client.organizations.address.update(
+   *     'organization_id',
+   *   );
+   * ```
+   */
+  update(
+    organizationID: string,
+    body: AddressUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<OrganizationAddress> {
+    return this._client.patch(path`/v1/organizations/${organizationID}/address`, { body, ...options });
+  }
+}
+
+/**
+ * Organization address details.
+ */
+export interface OrganizationAddress {
+  /**
+   * Address ID.
+   */
+  id: string;
+
+  /**
+   * City or locality.
+   */
+  city: string;
+
+  /**
+   * Two-letter ISO 3166-1 alpha-2 country code.
+   */
+  country: string;
+
+  /**
+   * When the address was created.
+   */
+  created_at: string;
+
+  /**
+   * First line of the street address.
+   */
+  line1: string;
+
+  /**
+   * Second line of the street address. Null when not provided.
+   */
+  line2: string | null;
+
+  /**
+   * Organization ID the address belongs to.
+   */
+  organization_id: string;
+
+  /**
+   * Postal or ZIP code.
+   */
+  postal_code: string;
+
+  /**
+   * State, province, or region. Null when not provided.
+   */
+  state: string | null;
+
+  /**
+   * Tax identification number. Null when not provided.
+   */
+  tax_id: string | null;
+
+  /**
+   * Type of the tax identification number. Null when not provided.
+   */
+  tax_id_type: string | null;
+
+  /**
+   * When the address was updated.
+   */
+  updated_at: string;
+}
+
+export interface AddressCreateParams {
+  /**
+   * City or locality.
+   */
+  city: string;
+
+  /**
+   * Two-letter ISO 3166-1 alpha-2 country code.
+   */
+  country: string;
+
+  /**
+   * First line of the street address.
+   */
+  line1: string;
+
+  /**
+   * Postal or ZIP code.
+   */
+  postal_code: string;
+
+  /**
+   * Second line of the street address (suite, unit, building).
+   */
+  line2?: string;
+
+  /**
+   * State, province, or region. Required by some tax jurisdictions (e.g. US, CA).
+   */
+  state?: string;
+
+  /**
+   * Tax identification number (e.g. VAT, EIN, ABN). Optional.
+   */
+  tax_id?: string;
+
+  /**
+   * Type of the tax identification number (e.g. eu_vat, us_ein, gb_vat, au_abn).
+   * Optional.
+   */
+  tax_id_type?: string;
+}
+
+export interface AddressUpdateParams {
+  /**
+   * City or locality.
+   */
+  city?: string;
+
+  /**
+   * Two-letter ISO 3166-1 alpha-2 country code.
+   */
+  country?: string;
+
+  /**
+   * First line of the street address.
+   */
+  line1?: string;
+
+  /**
+   * Second line of the street address (suite, unit, building). Omit to leave
+   * unchanged, send null to clear, or send a value to set it.
+   */
+  line2?: string | null;
+
+  /**
+   * Postal or ZIP code.
+   */
+  postal_code?: string;
+
+  /**
+   * State, province, or region. Omit to leave unchanged, send null to clear, or send
+   * a value to set it.
+   */
+  state?: string | null;
+
+  /**
+   * Tax identification number (e.g. VAT, EIN, ABN). Omit to leave unchanged, send
+   * null to clear, or send a value to set it.
+   */
+  tax_id?: string | null;
+
+  /**
+   * Type of the tax identification number (e.g. eu_vat, us_ein, gb_vat, au_abn).
+   * Omit to leave unchanged, send null to clear, or send a value to set it.
+   */
+  tax_id_type?: string | null;
+}
+
+export declare namespace Address {
+  export {
+    type OrganizationAddress as OrganizationAddress,
+    type AddressCreateParams as AddressCreateParams,
+    type AddressUpdateParams as AddressUpdateParams,
+  };
+}

package/src/resources/organizations/api.md

@@ -11,9 +11,9 @@ Types:
 Methods:
 
 - <code title="post /v1/organizations">client.organizations.<a href="./src/resources/organizations/organizations.ts">create</a>({ ...params }) -> Organization</code>
+- <code title="get /v1/organizations/{organization_id}">client.organizations.<a href="./src/resources/organizations/organizations.ts">get</a>(organizationID) -> Organization</code>
 - <code title="patch /v1/organizations/{organization_id}">client.organizations.<a href="./src/resources/organizations/organizations.ts">update</a>(organizationID, { ...params }) -> Organization</code>
 - <code title="get /v1/organizations">client.organizations.<a href="./src/resources/organizations/organizations.ts">list</a>({ ...params }) -> OrganizationsCursor</code>
-- <code title="get /v1/organizations/{organization_id}">client.organizations.<a href="./src/resources/organizations/organizations.ts">get</a>(organizationID) -> Organization</code>
 - <code title="post /v1/organizations/{organization_id}/leave">client.organizations.<a href="./src/resources/organizations/organizations.ts">leave</a>(organizationID) -> void</code>
 
 ## Memberships
@@ -25,5 +25,17 @@ Types:
 
 Methods:
 
-- <code title="get /v1/organizations/{organization_id}/memberships">client.organizations.memberships.<a href="./src/resources/organizations/memberships.ts">list</a>(organizationID, { ...params }) -> OrganizationMembershipsCursor</code>
 - <code title="get /v1/organizations/{organization_id}/memberships/{membership_id}">client.organizations.memberships.<a href="./src/resources/organizations/memberships.ts">get</a>(membershipID, { ...params }) -> OrganizationMembership</code>
+- <code title="get /v1/organizations/{organization_id}/memberships">client.organizations.memberships.<a href="./src/resources/organizations/memberships.ts">list</a>(organizationID, { ...params }) -> OrganizationMembershipsCursor</code>
+
+## Address
+
+Types:
+
+- <code><a href="./src/resources/organizations/address.ts">OrganizationAddress</a></code>
+
+Methods:
+
+- <code title="post /v1/organizations/{organization_id}/address">client.organizations.address.<a href="./src/resources/organizations/address.ts">create</a>(organizationID, { ...params }) -> OrganizationAddress</code>
+- <code title="get /v1/organizations/{organization_id}/address">client.organizations.address.<a href="./src/resources/organizations/address.ts">get</a>(organizationID) -> OrganizationAddress</code>
+- <code title="patch /v1/organizations/{organization_id}/address">client.organizations.address.<a href="./src/resources/organizations/address.ts">update</a>(organizationID, { ...params }) -> OrganizationAddress</code>

package/src/resources/organizations/index.ts

@@ -1,11 +1,17 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Address,
+  type OrganizationAddress,
+  type AddressCreateParams,
+  type AddressUpdateParams,
+} from './address';
 export {
   Memberships,
   type OrganizationMembership,
   type OrganizationMembershipList,
-  type MembershipListParams,
   type MembershipGetParams,
+  type MembershipListParams,
   type OrganizationMembershipsCursor,
 } from './memberships';
 export { Organizations } from './organizations';

package/src/resources/organizations/memberships.ts

@@ -8,6 +8,27 @@ import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
 
 export class Memberships extends APIResource {
+  /**
+   * Get details about an organization membership
+   *
+   * @example
+   * ```ts
+   * const organizationMembership =
+   *   await client.organizations.memberships.get(
+   *     'membership_id',
+   *     { organization_id: 'organization_id' },
+   *   );
+   * ```
+   */
+  get(
+    membershipID: string,
+    params: MembershipGetParams,
+    options?: RequestOptions,
+  ): APIPromise<OrganizationMembership> {
+    const { organization_id } = params;
+    return this._client.get(path`/v1/organizations/${organization_id}/memberships/${membershipID}`, options);
+  }
+
   /**
    * List all memberships for an organization
    *
@@ -32,27 +53,6 @@ export class Memberships extends APIResource {
       { query, ...options },
     );
   }
-
-  /**
-   * Get details about an organization membership
-   *
-   * @example
-   * ```ts
-   * const organizationMembership =
-   *   await client.organizations.memberships.get(
-   *     'membership_id',
-   *     { organization_id: 'organization_id' },
-   *   );
-   * ```
-   */
-  get(
-    membershipID: string,
-    params: MembershipGetParams,
-    options?: RequestOptions,
-  ): APIPromise<OrganizationMembership> {
-    const { organization_id } = params;
-    return this._client.get(path`/v1/organizations/${organization_id}/memberships/${membershipID}`, options);
-  }
 }
 
 export type OrganizationMembershipsCursor = Cursor<OrganizationMembership>;
@@ -101,8 +101,6 @@ export interface OrganizationMembershipList {
   pagination: Shared.Pagination;
 }
 
-export interface MembershipListParams extends CursorParams {}
-
 export interface MembershipGetParams {
   /**
    * Organization ID
@@ -110,12 +108,14 @@ export interface MembershipGetParams {
   organization_id: string;
 }
 
+export interface MembershipListParams extends CursorParams {}
+
 export declare namespace Memberships {
   export {
     type OrganizationMembership as OrganizationMembership,
     type OrganizationMembershipList as OrganizationMembershipList,
     type OrganizationMembershipsCursor as OrganizationMembershipsCursor,
-    type MembershipListParams as MembershipListParams,
     type MembershipGetParams as MembershipGetParams,
+    type MembershipListParams as MembershipListParams,
   };
 }