@nirvana-labs/nirvana 1.18.3 → 1.20.0

package/src/resources/networking/connect/connect.ts

@@ -0,0 +1,174 @@
+// 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 ConnectionsAPI from './connections';
+import { ConnectionCreateParams, ConnectionUpdateParams, Connections } from './connections';
+import * as RoutesAPI from './routes';
+import { Routes } from './routes';
+
+export class Connect extends APIResource {
+  connections: ConnectionsAPI.Connections = new ConnectionsAPI.Connections(this._client);
+  routes: RoutesAPI.Routes = new RoutesAPI.Routes(this._client);
+}
+
+/**
+ * Connect Connection speed in Mbps
+ */
+export type ConnectBandwidthMbps = 50 | 200 | 500 | 1000 | 2000;
+
+/**
+ * Connect Connection details.
+ */
+export interface ConnectConnection {
+  /**
+   * Unique identifier for the Connect Connection
+   */
+  id: string;
+
+  /**
+   * ASN
+   */
+  asn: number | null;
+
+  /**
+   * AWS provider configuration
+   */
+  aws: ConnectConnectionAWSConfig | null;
+
+  /**
+   * Connect Connection speed in Mbps
+   */
+  bandwidth_mbps: ConnectBandwidthMbps;
+
+  /**
+   * CIDRs for the Connect Connection
+   */
+  cidrs: Array<string>;
+
+  /**
+   * When the Connect Connection was created
+   */
+  created_at: string;
+
+  /**
+   * Name of the Connect Connection
+   */
+  name: string;
+
+  /**
+   * Provider ASN
+   */
+  provider_asn: number | null;
+
+  /**
+   * Provider CIDRs for the Connect Connection
+   */
+  provider_cidrs: Array<string>;
+
+  /**
+   * Provider Router IP for the Connect Connection
+   */
+  provider_router_ip: string | null;
+
+  /**
+   * Region the resource is in.
+   */
+  region: Shared.RegionName;
+
+  /**
+   * Router IP
+   */
+  router_ip: string | null;
+
+  /**
+   * Status of the resource.
+   */
+  status: Shared.ResourceStatus;
+
+  /**
+   * Tags to attach to the Connect Connection
+   */
+  tags: Array<string>;
+
+  /**
+   * When the Connect Connection was updated
+   */
+  updated_at: string;
+}
+
+/**
+ * AWS provider configuration
+ */
+export interface ConnectConnectionAWSConfig {
+  /**
+   * AWS region where the connection is established
+   */
+  region: string;
+}
+
+/**
+ * AWS provider configuration
+ */
+export interface ConnectConnectionAWSConfigRequest {
+  /**
+   * AWS account id
+   */
+  account_id: string;
+
+  /**
+   * AWS region where the connection will be established
+   */
+  region: string;
+}
+
+export interface ConnectConnectionList {
+  items: Array<ConnectConnection>;
+}
+
+/**
+ * Routes supported for Connect.
+ */
+export interface ConnectRoute {
+  /**
+   * Region the resource is in.
+   */
+  nirvana_region: Shared.RegionName;
+
+  /**
+   * Provider name.
+   */
+  provider: string;
+
+  /**
+   * Provider region name.
+   */
+  provider_region: string;
+}
+
+export interface ConnectRouteList {
+  items: Array<ConnectRoute>;
+}
+
+Connect.Connections = Connections;
+Connect.Routes = Routes;
+
+export declare namespace Connect {
+  export {
+    type ConnectBandwidthMbps as ConnectBandwidthMbps,
+    type ConnectConnection as ConnectConnection,
+    type ConnectConnectionAWSConfig as ConnectConnectionAWSConfig,
+    type ConnectConnectionAWSConfigRequest as ConnectConnectionAWSConfigRequest,
+    type ConnectConnectionList as ConnectConnectionList,
+    type ConnectRoute as ConnectRoute,
+    type ConnectRouteList as ConnectRouteList,
+  };
+
+  export {
+    Connections as Connections,
+    type ConnectionCreateParams as ConnectionCreateParams,
+    type ConnectionUpdateParams as ConnectionUpdateParams,
+  };
+
+  export { Routes as Routes };
+}

package/src/resources/networking/connect/connections.ts

@@ -0,0 +1,148 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as OperationsAPI from '../../operations';
+import * as Shared from '../../shared';
+import * as ConnectAPI from './connect';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+import { path } from '../../../internal/utils/path';
+
+export class Connections extends APIResource {
+  /**
+   * Create a Connect Connection
+   *
+   * @example
+   * ```ts
+   * const operation =
+   *   await client.networking.connect.connections.create({
+   *     bandwidth_mbps: 50,
+   *     cidrs: ['10.0.0.0/16'],
+   *     name: 'my-connect-connection',
+   *     provider_cidrs: ['172.16.0.0/16'],
+   *     region: 'us-wdc-1',
+   *   });
+   * ```
+   */
+  create(body: ConnectionCreateParams, options?: RequestOptions): APIPromise<OperationsAPI.Operation> {
+    return this._client.post('/v1/networking/connect/connections', { body, ...options });
+  }
+
+  /**
+   * Update Connect Connection details
+   *
+   * @example
+   * ```ts
+   * const operation =
+   *   await client.networking.connect.connections.update(
+   *     'connection_id',
+   *   );
+   * ```
+   */
+  update(
+    connectionID: string,
+    body: ConnectionUpdateParams,
+    options?: RequestOptions,
+  ): APIPromise<OperationsAPI.Operation> {
+    return this._client.patch(path`/v1/networking/connect/connections/${connectionID}`, { body, ...options });
+  }
+
+  /**
+   * List all Connect Connections
+   *
+   * @example
+   * ```ts
+   * const connectConnectionList =
+   *   await client.networking.connect.connections.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<ConnectAPI.ConnectConnectionList> {
+    return this._client.get('/v1/networking/connect/connections', options);
+  }
+
+  /**
+   * Delete Connect Connection
+   *
+   * @example
+   * ```ts
+   * const operation =
+   *   await client.networking.connect.connections.delete(
+   *     'connection_id',
+   *   );
+   * ```
+   */
+  delete(connectionID: string, options?: RequestOptions): APIPromise<OperationsAPI.Operation> {
+    return this._client.delete(path`/v1/networking/connect/connections/${connectionID}`, options);
+  }
+
+  /**
+   * Get Connect Connection details
+   *
+   * @example
+   * ```ts
+   * const connectConnection =
+   *   await client.networking.connect.connections.get(
+   *     'connection_id',
+   *   );
+   * ```
+   */
+  get(connectionID: string, options?: RequestOptions): APIPromise<ConnectAPI.ConnectConnection> {
+    return this._client.get(path`/v1/networking/connect/connections/${connectionID}`, options);
+  }
+}
+
+export interface ConnectionCreateParams {
+  /**
+   * Connect Connection speed in Mbps
+   */
+  bandwidth_mbps: ConnectAPI.ConnectBandwidthMbps;
+
+  /**
+   * CIDRs for the Connect Connection
+   */
+  cidrs: Array<string>;
+
+  /**
+   * Name of the Connect Connection
+   */
+  name: string;
+
+  /**
+   * Provider CIDRs
+   */
+  provider_cidrs: Array<string>;
+
+  /**
+   * Region the resource is in.
+   */
+  region: Shared.RegionName;
+
+  /**
+   * AWS provider configuration
+   */
+  aws?: ConnectAPI.ConnectConnectionAWSConfigRequest;
+
+  /**
+   * Tags to attach to the Connect Connection
+   */
+  tags?: Array<string>;
+}
+
+export interface ConnectionUpdateParams {
+  /**
+   * Name of the Connect Connection.
+   */
+  name?: string;
+
+  /**
+   * Tags to attach to the Connect Connection
+   */
+  tags?: Array<string>;
+}
+
+export declare namespace Connections {
+  export {
+    type ConnectionCreateParams as ConnectionCreateParams,
+    type ConnectionUpdateParams as ConnectionUpdateParams,
+  };
+}

package/src/resources/networking/connect/index.ts

@@ -0,0 +1,14 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+export {
+  Connect,
+  type ConnectBandwidthMbps,
+  type ConnectConnection,
+  type ConnectConnectionAWSConfig,
+  type ConnectConnectionAWSConfigRequest,
+  type ConnectConnectionList,
+  type ConnectRoute,
+  type ConnectRouteList,
+} from './connect';
+export { Connections, type ConnectionCreateParams, type ConnectionUpdateParams } from './connections';
+export { Routes } from './routes';

package/src/resources/networking/connect/routes.ts

@@ -0,0 +1,21 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../../core/resource';
+import * as ConnectAPI from './connect';
+import { APIPromise } from '../../../core/api-promise';
+import { RequestOptions } from '../../../internal/request-options';
+
+export class Routes extends APIResource {
+  /**
+   * List all supported routes with regions for Connect.
+   *
+   * @example
+   * ```ts
+   * const connectRouteList =
+   *   await client.networking.connect.routes.list();
+   * ```
+   */
+  list(options?: RequestOptions): APIPromise<ConnectAPI.ConnectRouteList> {
+    return this._client.get('/v1/networking/connect/routes', options);
+  }
+}

package/src/resources/networking/connect.ts

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

package/src/resources/networking/firewall-rules.ts

@@ -156,6 +156,11 @@ export interface FirewallRule {
    */
   status: Shared.ResourceStatus;
 
+  /**
+   * Tags to attach to the Firewall Rule.
+   */
+  tags: Array<string>;
+
   /**
    * When the Firewall Rule was updated.
    */
@@ -197,6 +202,11 @@ export interface FirewallRuleCreateParams {
    * of 0.
    */
   source_address: string;
+
+  /**
+   * Tags to attach to the Firewall Rule.
+   */
+  tags?: Array<string>;
 }
 
 export interface FirewallRuleUpdateParams {
@@ -231,6 +241,11 @@ export interface FirewallRuleUpdateParams {
    * CIDR mask of 0.
    */
   source_address?: string;
+
+  /**
+   * Body param: Tags to attach to the Firewall Rule.
+   */
+  tags?: Array<string>;
 }
 
 export interface FirewallRuleDeleteParams {

package/src/resources/networking/index.ts

@@ -1,5 +1,15 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
+export {
+  Connect,
+  type ConnectBandwidthMbps,
+  type ConnectConnection,
+  type ConnectConnectionAWSConfig,
+  type ConnectConnectionAWSConfigRequest,
+  type ConnectConnectionList,
+  type ConnectRoute,
+  type ConnectRouteList,
+} from './connect/index';
 export {
   FirewallRules,
   type FirewallRule,

package/src/resources/networking/networking.ts

@@ -11,16 +11,29 @@ import {
   FirewallRuleUpdateParams,
   FirewallRules,
 } from './firewall-rules';
+import * as ConnectAPI from './connect/connect';
+import {
+  Connect,
+  ConnectBandwidthMbps,
+  ConnectConnection,
+  ConnectConnectionAWSConfig,
+  ConnectConnectionAWSConfigRequest,
+  ConnectConnectionList,
+  ConnectRoute,
+  ConnectRouteList,
+} from './connect/connect';
 import * as VPCsAPI from './vpcs/vpcs';
 import { Subnet, VPC, VPCCreateParams, VPCList, VPCUpdateParams, VPCs } from './vpcs/vpcs';
 
 export class Networking extends APIResource {
   vpcs: VPCsAPI.VPCs = new VPCsAPI.VPCs(this._client);
   firewallRules: FirewallRulesAPI.FirewallRules = new FirewallRulesAPI.FirewallRules(this._client);
+  connect: ConnectAPI.Connect = new ConnectAPI.Connect(this._client);
 }
 
 Networking.VPCs = VPCs;
 Networking.FirewallRules = FirewallRules;
+Networking.Connect = Connect;
 
 export declare namespace Networking {
   export {
@@ -41,4 +54,15 @@ export declare namespace Networking {
     type FirewallRuleDeleteParams as FirewallRuleDeleteParams,
     type FirewallRuleGetParams as FirewallRuleGetParams,
   };
+
+  export {
+    Connect as Connect,
+    type ConnectBandwidthMbps as ConnectBandwidthMbps,
+    type ConnectConnection as ConnectConnection,
+    type ConnectConnectionAWSConfig as ConnectConnectionAWSConfig,
+    type ConnectConnectionAWSConfigRequest as ConnectConnectionAWSConfigRequest,
+    type ConnectConnectionList as ConnectConnectionList,
+    type ConnectRoute as ConnectRoute,
+    type ConnectRouteList as ConnectRouteList,
+  };
 }

package/src/resources/networking/vpcs/availability.ts

@@ -68,6 +68,11 @@ export interface AvailabilityCreateParams {
    * Name of the subnet to create.
    */
   subnet_name: string;
+
+  /**
+   * Tags to attach to the VPC.
+   */
+  tags?: Array<string>;
 }
 
 export interface AvailabilityUpdateParams {
@@ -80,6 +85,11 @@ export interface AvailabilityUpdateParams {
    * Name of the subnet to create.
    */
   subnet_name?: string;
+
+  /**
+   * Tags to attach to the VPC.
+   */
+  tags?: Array<string>;
 }
 
 export declare namespace Availability {

package/src/resources/networking/vpcs/vpcs.ts

@@ -160,6 +160,11 @@ export interface VPC {
    */
   subnet: Subnet;
 
+  /**
+   * Tags to attach to the VPC.
+   */
+  tags: Array<string>;
+
   /**
    * When the VPC was updated.
    */
@@ -185,6 +190,11 @@ export interface VPCCreateParams {
    * Name of the subnet to create.
    */
   subnet_name: string;
+
+  /**
+   * Tags to attach to the VPC.
+   */
+  tags?: Array<string>;
 }
 
 export interface VPCUpdateParams {
@@ -197,6 +207,11 @@ export interface VPCUpdateParams {
    * Name of the subnet to create.
    */
   subnet_name?: string;
+
+  /**
+   * Tags to attach to the VPC.
+   */
+  tags?: Array<string>;
 }
 
 VPCs.Availability = Availability;

package/src/resources/rpc-nodes/dedicated/blockchains.ts

@@ -8,6 +8,12 @@ import { RequestOptions } from '../../../internal/request-options';
 export class Blockchains extends APIResource {
   /**
    * List all Dedicated Blockchains
+   *
+   * @example
+   * ```ts
+   * const dedicatedBlockchainList =
+   *   await client.rpcNodes.dedicated.blockchains.list();
+   * ```
    */
   list(options?: RequestOptions): APIPromise<DedicatedAPI.DedicatedBlockchainList> {
     return this._client.get('/v1/rpc_nodes/dedicated/blockchains', options);

package/src/resources/rpc-nodes/dedicated/dedicated.ts

@@ -12,6 +12,12 @@ export class DedicatedResource extends APIResource {
 
   /**
    * List all RPC Node Dedicated you created
+   *
+   * @example
+   * ```ts
+   * const dedicatedList =
+   *   await client.rpcNodes.dedicated.list();
+   * ```
    */
   list(options?: RequestOptions): APIPromise<DedicatedList> {
     return this._client.get('/v1/rpc_nodes/dedicated', options);
@@ -19,6 +25,13 @@ export class DedicatedResource extends APIResource {
 
   /**
    * Get details about an RPC Node Dedicated
+   *
+   * @example
+   * ```ts
+   * const dedicated = await client.rpcNodes.dedicated.get(
+   *   'node_id',
+   * );
+   * ```
    */
   get(nodeID: string, options?: RequestOptions): APIPromise<Dedicated> {
     return this._client.get(path`/v1/rpc_nodes/dedicated/${nodeID}`, options);
@@ -59,6 +72,11 @@ export interface Dedicated {
    */
   network: string;
 
+  /**
+   * Tags to attach to the RPC Node Dedicated.
+   */
+  tags: Array<string>;
+
   /**
    * When the RPC Node Dedicated was updated.
    */

package/src/resources/rpc-nodes/flex/blockchains.ts

@@ -8,6 +8,12 @@ import { RequestOptions } from '../../../internal/request-options';
 export class Blockchains extends APIResource {
   /**
    * List all Flex Blockchains
+   *
+   * @example
+   * ```ts
+   * const flexBlockchainList =
+   *   await client.rpcNodes.flex.blockchains.list();
+   * ```
    */
   list(options?: RequestOptions): APIPromise<FlexAPI.FlexBlockchainList> {
     return this._client.get('/v1/rpc_nodes/flex/blockchains', options);