@nirvana-labs/nirvana 1.0.4 → 1.1.0

package/resources/networking/firewall-rules.mjs

@@ -4,12 +4,33 @@ import { path } from "../../internal/utils/path.mjs";
 export class FirewallRules extends APIResource {
     /**
      * Create a firewall rule
+     *
+     * @example
+     * ```ts
+     * const operation =
+     *   await client.networking.firewallRules.create('vpc_id', {
+     *     destination_address: '0.0.0.0/0',
+     *     destination_ports: ['22', '80', '443'],
+     *     name: 'my-firewall-rule',
+     *     protocol: 'tcp',
+     *     source_address: '0.0.0.0/0',
+     *   });
+     * ```
      */
     create(vpcID, body, options) {
         return this._client.post(path `/v1/networking/vpcs/${vpcID}/firewall_rules`, { body, ...options });
     }
     /**
      * Update a firewall rule
+     *
+     * @example
+     * ```ts
+     * const operation =
+     *   await client.networking.firewallRules.update(
+     *     'firewall_rule_id',
+     *     { vpc_id: 'vpc_id' },
+     *   );
+     * ```
      */
     update(firewallRuleID, params, options) {
         const { vpc_id, ...body } = params;
@@ -20,12 +41,27 @@ export class FirewallRules extends APIResource {
     }
     /**
      * List all firewall rules
+     *
+     * @example
+     * ```ts
+     * const firewallRuleList =
+     *   await client.networking.firewallRules.list('vpc_id');
+     * ```
      */
     list(vpcID, options) {
         return this._client.get(path `/v1/networking/vpcs/${vpcID}/firewall_rules`, options);
     }
     /**
      * Delete a firewall rule
+     *
+     * @example
+     * ```ts
+     * const operation =
+     *   await client.networking.firewallRules.delete(
+     *     'firewall_rule_id',
+     *     { vpc_id: 'vpc_id' },
+     *   );
+     * ```
      */
     delete(firewallRuleID, params, options) {
         const { vpc_id } = params;
@@ -33,6 +69,15 @@ export class FirewallRules extends APIResource {
     }
     /**
      * Get details about a firewall rule
+     *
+     * @example
+     * ```ts
+     * const firewallRule =
+     *   await client.networking.firewallRules.get(
+     *     'firewall_rule_id',
+     *     { vpc_id: 'vpc_id' },
+     *   );
+     * ```
      */
     get(firewallRuleID, params, options) {
         const { vpc_id } = params;

package/resources/networking/firewall-rules.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"firewall-rules.mjs","sourceRoot":"","sources":["../../src/resources/networking/firewall-rules.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAKf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;OAEG;IACH,MAAM,CACJ,KAAa,EACb,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,uBAAuB,KAAK,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,cAAsB,EACtB,MAAgC,EAChC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,uBAAuB,MAAM,mBAAmB,cAAc,EAAE,EAAE;YAC9F,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAa,EAAE,OAAwB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,uBAAuB,KAAK,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,cAAsB,EACtB,MAAgC,EAChC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,uBAAuB,MAAM,mBAAmB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5G,CAAC;IAED;;OAEG;IACH,GAAG,CACD,cAAsB,EACtB,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,uBAAuB,MAAM,mBAAmB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACzG,CAAC;CACF"}
+{"version":3,"file":"firewall-rules.mjs","sourceRoot":"","sources":["../../src/resources/networking/firewall-rules.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAKf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,aAAc,SAAQ,WAAW;IAC5C;;;;;;;;;;;;;;OAcG;IACH,MAAM,CACJ,KAAa,EACb,IAA8B,EAC9B,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,uBAAuB,KAAK,iBAAiB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACpG,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,cAAsB,EACtB,MAAgC,EAChC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACnC,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,uBAAuB,MAAM,mBAAmB,cAAc,EAAE,EAAE;YAC9F,IAAI;YACJ,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,KAAa,EAAE,OAAwB;QAC1C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,uBAAuB,KAAK,iBAAiB,EAAE,OAAO,CAAC,CAAC;IACtF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,MAAM,CACJ,cAAsB,EACtB,MAAgC,EAChC,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,uBAAuB,MAAM,mBAAmB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IAC5G,CAAC;IAED;;;;;;;;;;;OAWG;IACH,GAAG,CACD,cAAsB,EACtB,MAA6B,EAC7B,OAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,uBAAuB,MAAM,mBAAmB,cAAc,EAAE,EAAE,OAAO,CAAC,CAAC;IACzG,CAAC;CACF"}

package/resources/networking/networking.js

@@ -1,34 +1,12 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Networking = void 0;
+const tslib_1 = require("../../internal/tslib.js");
 const resource_1 = require("../../core/resource.js");
-const FirewallRulesAPI = __importStar(require("./firewall-rules.js"));
+const FirewallRulesAPI = tslib_1.__importStar(require("./firewall-rules.js"));
 const firewall_rules_1 = require("./firewall-rules.js");
-const VPCsAPI = __importStar(require("./vpcs.js"));
+const VPCsAPI = tslib_1.__importStar(require("./vpcs.js"));
 const vpcs_1 = require("./vpcs.js");
 class Networking extends resource_1.APIResource {
     constructor() {

package/resources/networking/networking.js.map

@@ -1 +1 @@
-{"version":3,"file":"networking.js","sourceRoot":"","sources":["../../src/resources/networking/networking.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtF,qDAAkD;AAClD,sEAAqD;AACrD,wDAQ0B;AAC1B,mDAAkC;AAClC,oCAAsF;AAEtF,MAAa,UAAW,SAAQ,sBAAW;IAA3C;;QACE,SAAI,GAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAHD,gCAGC;AAED,UAAU,CAAC,IAAI,GAAG,WAAI,CAAC;AACvB,UAAU,CAAC,aAAa,GAAG,8BAAa,CAAC"}
+{"version":3,"file":"networking.js","sourceRoot":"","sources":["../../src/resources/networking/networking.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,8EAAqD;AACrD,wDAQ0B;AAC1B,2DAAkC;AAClC,oCAAsF;AAEtF,MAAa,UAAW,SAAQ,sBAAW;IAA3C;;QACE,SAAI,GAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpD,kBAAa,GAAmC,IAAI,gBAAgB,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnG,CAAC;CAAA;AAHD,gCAGC;AAED,UAAU,CAAC,IAAI,GAAG,WAAI,CAAC;AACvB,UAAU,CAAC,aAAa,GAAG,8BAAa,CAAC"}

package/resources/networking/vpcs.d.mts

@@ -6,22 +6,55 @@ import { RequestOptions } from "../../internal/request-options.mjs";
 export declare class VPCs extends APIResource {
     /**
      * Create a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.create({
+     *   name: 'my-vpc',
+     *   region: 'us-wdc-1',
+     *   subnet_name: 'my-subnet',
+     * });
+     * ```
      */
     create(body: VPCCreateParams, options?: RequestOptions): APIPromise<OperationsAPI.Operation>;
     /**
      * Update a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.update(
+     *   'vpc_id',
+     * );
+     * ```
      */
     update(vpcID: string, body: VPCUpdateParams, options?: RequestOptions): APIPromise<OperationsAPI.Operation>;
     /**
      * List all VPCs
+     *
+     * @example
+     * ```ts
+     * const vpcList = await client.networking.vpcs.list();
+     * ```
      */
     list(options?: RequestOptions): APIPromise<VPCList>;
     /**
      * Delete a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.delete(
+     *   'vpc_id',
+     * );
+     * ```
      */
     delete(vpcID: string, options?: RequestOptions): APIPromise<OperationsAPI.Operation>;
     /**
      * Get details about a VPC
+     *
+     * @example
+     * ```ts
+     * const vpc = await client.networking.vpcs.get('vpc_id');
+     * ```
      */
     get(vpcID: string, options?: RequestOptions): APIPromise<VPC>;
 }

package/resources/networking/vpcs.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"vpcs.d.mts","sourceRoot":"","sources":["../../src/resources/networking/vpcs.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,aAAa;OAClB,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,IAAK,SAAQ,WAAW;IACnC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAI5F;;OAEG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAItC;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAInD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAIpF;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC;CAG9D;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAE9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,MAAM,IAAI,MAAM,EACrB,KAAK,GAAG,IAAI,GAAG,EACf,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}
+{"version":3,"file":"vpcs.d.mts","sourceRoot":"","sources":["../../src/resources/networking/vpcs.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,aAAa;OAClB,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAI5F;;;;;;;;;OASG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAItC;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAInD;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAIpF;;;;;;;OAOG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC;CAG9D;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAE9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,MAAM,IAAI,MAAM,EACrB,KAAK,GAAG,IAAI,GAAG,EACf,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/networking/vpcs.d.ts

@@ -6,22 +6,55 @@ import { RequestOptions } from "../../internal/request-options.js";
 export declare class VPCs extends APIResource {
     /**
      * Create a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.create({
+     *   name: 'my-vpc',
+     *   region: 'us-wdc-1',
+     *   subnet_name: 'my-subnet',
+     * });
+     * ```
      */
     create(body: VPCCreateParams, options?: RequestOptions): APIPromise<OperationsAPI.Operation>;
     /**
      * Update a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.update(
+     *   'vpc_id',
+     * );
+     * ```
      */
     update(vpcID: string, body: VPCUpdateParams, options?: RequestOptions): APIPromise<OperationsAPI.Operation>;
     /**
      * List all VPCs
+     *
+     * @example
+     * ```ts
+     * const vpcList = await client.networking.vpcs.list();
+     * ```
      */
     list(options?: RequestOptions): APIPromise<VPCList>;
     /**
      * Delete a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.delete(
+     *   'vpc_id',
+     * );
+     * ```
      */
     delete(vpcID: string, options?: RequestOptions): APIPromise<OperationsAPI.Operation>;
     /**
      * Get details about a VPC
+     *
+     * @example
+     * ```ts
+     * const vpc = await client.networking.vpcs.get('vpc_id');
+     * ```
      */
     get(vpcID: string, options?: RequestOptions): APIPromise<VPC>;
 }

package/resources/networking/vpcs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vpcs.d.ts","sourceRoot":"","sources":["../../src/resources/networking/vpcs.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,aAAa;OAClB,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,IAAK,SAAQ,WAAW;IACnC;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAI5F;;OAEG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAItC;;OAEG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAInD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAIpF;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC;CAG9D;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAE9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,MAAM,IAAI,MAAM,EACrB,KAAK,GAAG,IAAI,GAAG,EACf,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}
+{"version":3,"file":"vpcs.d.ts","sourceRoot":"","sources":["../../src/resources/networking/vpcs.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,aAAa;OAClB,KAAK,MAAM;OACX,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAGzB,qBAAa,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAI5F;;;;;;;;;OASG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,eAAe,EACrB,OAAO,CAAC,EAAE,cAAc,GACvB,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAItC;;;;;;;OAOG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,OAAO,CAAC;IAInD;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,SAAS,CAAC;IAIpF;;;;;;;OAOG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC;CAG9D;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IAE9B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAE1B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,CAAC,OAAO,WAAW,IAAI,CAAC;IAC5B,OAAO,EACL,KAAK,MAAM,IAAI,MAAM,EACrB,KAAK,GAAG,IAAI,GAAG,EACf,KAAK,OAAO,IAAI,OAAO,EACvB,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,eAAe,IAAI,eAAe,GACxC,CAAC;CACH"}

package/resources/networking/vpcs.js

@@ -7,30 +7,63 @@ const path_1 = require("../../internal/utils/path.js");
 class VPCs extends resource_1.APIResource {
     /**
      * Create a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.create({
+     *   name: 'my-vpc',
+     *   region: 'us-wdc-1',
+     *   subnet_name: 'my-subnet',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/v1/networking/vpcs', { body, ...options });
     }
     /**
      * Update a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.update(
+     *   'vpc_id',
+     * );
+     * ```
      */
     update(vpcID, body, options) {
         return this._client.patch((0, path_1.path) `/v1/networking/vpcs/${vpcID}`, { body, ...options });
     }
     /**
      * List all VPCs
+     *
+     * @example
+     * ```ts
+     * const vpcList = await client.networking.vpcs.list();
+     * ```
      */
     list(options) {
         return this._client.get('/v1/networking/vpcs', options);
     }
     /**
      * Delete a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.delete(
+     *   'vpc_id',
+     * );
+     * ```
      */
     delete(vpcID, options) {
         return this._client.delete((0, path_1.path) `/v1/networking/vpcs/${vpcID}`, options);
     }
     /**
      * Get details about a VPC
+     *
+     * @example
+     * ```ts
+     * const vpc = await client.networking.vpcs.get('vpc_id');
+     * ```
      */
     get(vpcID, options) {
         return this._client.get((0, path_1.path) `/v1/networking/vpcs/${vpcID}`, options);

package/resources/networking/vpcs.js.map

@@ -1 +1 @@
-{"version":3,"file":"vpcs.js","sourceRoot":"","sources":["../../src/resources/networking/vpcs.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAKlD,uDAAiD;AAEjD,MAAa,IAAK,SAAQ,sBAAW;IACnC;;OAEG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,KAAa,EACb,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,uBAAuB,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa,EAAE,OAAwB;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,uBAAuB,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAa,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,uBAAuB,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACF;AAvCD,oBAuCC"}
+{"version":3,"file":"vpcs.js","sourceRoot":"","sources":["../../src/resources/networking/vpcs.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAKlD,uDAAiD;AAEjD,MAAa,IAAK,SAAQ,sBAAW;IACnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,KAAa,EACb,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAA,WAAI,EAAA,uBAAuB,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAa,EAAE,OAAwB;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,uBAAuB,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,KAAa,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,uBAAuB,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACF;AAxED,oBAwEC"}

package/resources/networking/vpcs.mjs

@@ -4,30 +4,63 @@ import { path } from "../../internal/utils/path.mjs";
 export class VPCs extends APIResource {
     /**
      * Create a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.create({
+     *   name: 'my-vpc',
+     *   region: 'us-wdc-1',
+     *   subnet_name: 'my-subnet',
+     * });
+     * ```
      */
     create(body, options) {
         return this._client.post('/v1/networking/vpcs', { body, ...options });
     }
     /**
      * Update a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.update(
+     *   'vpc_id',
+     * );
+     * ```
      */
     update(vpcID, body, options) {
         return this._client.patch(path `/v1/networking/vpcs/${vpcID}`, { body, ...options });
     }
     /**
      * List all VPCs
+     *
+     * @example
+     * ```ts
+     * const vpcList = await client.networking.vpcs.list();
+     * ```
      */
     list(options) {
         return this._client.get('/v1/networking/vpcs', options);
     }
     /**
      * Delete a VPC
+     *
+     * @example
+     * ```ts
+     * const operation = await client.networking.vpcs.delete(
+     *   'vpc_id',
+     * );
+     * ```
      */
     delete(vpcID, options) {
         return this._client.delete(path `/v1/networking/vpcs/${vpcID}`, options);
     }
     /**
      * Get details about a VPC
+     *
+     * @example
+     * ```ts
+     * const vpc = await client.networking.vpcs.get('vpc_id');
+     * ```
      */
     get(vpcID, options) {
         return this._client.get(path `/v1/networking/vpcs/${vpcID}`, options);

package/resources/networking/vpcs.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vpcs.mjs","sourceRoot":"","sources":["../../src/resources/networking/vpcs.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAKf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC;;OAEG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACH,MAAM,CACJ,KAAa,EACb,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,uBAAuB,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa,EAAE,OAAwB;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,uBAAuB,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAa,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,uBAAuB,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACF"}
+{"version":3,"file":"vpcs.mjs","sourceRoot":"","sources":["../../src/resources/networking/vpcs.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAKf,EAAE,IAAI,EAAE;AAEf,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAqB,EAAE,OAAwB;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CACJ,KAAa,EACb,IAAqB,EACrB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAA,uBAAuB,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;;;;;;OAOG;IACH,IAAI,CAAC,OAAwB;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAa,EAAE,OAAwB;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,uBAAuB,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED;;;;;;;OAOG;IACH,GAAG,CAAC,KAAa,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,uBAAuB,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;CACF"}

package/resources/networking.js

@@ -1,19 +1,6 @@
 "use strict";
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./networking/index.js"), exports);
+const tslib_1 = require("../internal/tslib.js");
+tslib_1.__exportStar(require("./networking/index.js"), exports);
 //# sourceMappingURL=networking.js.map

package/resources/networking.js.map

@@ -1 +1 @@
-{"version":3,"file":"networking.js","sourceRoot":"","sources":["../src/resources/networking.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;;;;;;;;;;;;;AAEtF,wDAAmC"}
+{"version":3,"file":"networking.js","sourceRoot":"","sources":["../src/resources/networking.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,gEAAmC"}

package/resources.js

@@ -1,18 +1,5 @@
 "use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./resources/index.js"), exports);
+const tslib_1 = require("./internal/tslib.js");
+tslib_1.__exportStar(require("./resources/index.js"), exports);
 //# sourceMappingURL=resources.js.map

package/resources.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources.js","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAkC"}
+{"version":3,"file":"resources.js","sourceRoot":"","sources":["src/resources.ts"],"names":[],"mappings":";;;AAAA,+DAAkC"}

package/src/client.ts

@@ -169,6 +169,23 @@ export class NirvanaLabs {
     this.apiKey = apiKey;
   }
 
+  /**
+   * Create a new client instance re-using the same options given to the current client with optional overriding.
+   */
+  withOptions(options: Partial<ClientOptions>): this {
+    return new (this.constructor as any as new (props: ClientOptions) => typeof this)({
+      ...this._options,
+      baseURL: this.baseURL,
+      maxRetries: this.maxRetries,
+      timeout: this.timeout,
+      logger: this.logger,
+      logLevel: this.logLevel,
+      fetchOptions: this.fetchOptions,
+      apiKey: this.apiKey,
+      ...options,
+    });
+  }
+
   protected defaultQuery(): Record<string, string | undefined> | undefined {
     return this._options.defaultQuery;
   }

package/src/internal/to-file.ts

@@ -1,6 +1,6 @@
-import { type File, getFile } from './shims/file';
 import { BlobPart, getName, makeFile, isAsyncIterable } from './uploads';
 import type { FilePropertyBag } from './builtin-types';
+import { checkFileSupport } from './uploads';
 
 type BlobLikePart = string | ArrayBuffer | ArrayBufferView | BlobLike | DataView;
 
@@ -85,12 +85,14 @@ export async function toFile(
   name?: string | null | undefined,
   options?: FilePropertyBag | undefined,
 ): Promise<File> {
+  checkFileSupport();
+
   // If it's a promise, resolve it.
   value = await value;
 
   // If we've been given a `File` we don't need to do anything
   if (isFileLike(value)) {
-    if (value instanceof getFile()) {
+    if (value instanceof File) {
       return value;
     }
     return makeFile([await value.arrayBuffer()], value.name);

package/src/internal/uploads.ts

@@ -1,7 +1,6 @@
 import { type RequestOptions } from './request-options';
 import type { FilePropertyBag, Fetch } from './builtin-types';
 import type { NirvanaLabs } from '../client';
-import { type File, getFile } from './shims/file';
 import { ReadableStreamFrom } from './shims';
 
 export type BlobPart = string | ArrayBuffer | ArrayBufferView | Blob | DataView;
@@ -12,6 +11,20 @@ interface BunFile extends Blob {
   readonly name?: string | undefined;
 }
 
+export const checkFileSupport = () => {
+  if (typeof File === 'undefined') {
+    const { process } = globalThis as any;
+    const isOldNode =
+      typeof process?.versions?.node === 'string' && parseInt(process.versions.node.split('.')) < 20;
+    throw new Error(
+      '`File` is not defined as a global, which is required for file uploads.' +
+        (isOldNode ?
+          " Update to Node 20 LTS or newer, or set `globalThis.File` to `import('node:buffer').File`."
+        : ''),
+    );
+  }
+};
+
 /**
  * Typically, this is a native "File" class.
  *
@@ -32,7 +45,7 @@ export function makeFile(
   fileName: string | undefined,
   options?: FilePropertyBag,
 ): File {
-  const File = getFile();
+  checkFileSupport();
   return new File(fileBits as any, fileName ?? 'unknown_file', options);
 }
 
@@ -125,8 +138,7 @@ export const createForm = async <T = Record<string, unknown>>(
 
 // We check for Blob not File because Bun.File doesn't inherit from File,
 // but they both inherit from Blob and have a `name` property at runtime.
-const isNamedBlob = (value: object) =>
-  value instanceof getFile() || (value instanceof Blob && 'name' in value);
+const isNamedBlob = (value: object) => value instanceof Blob && 'name' in value;
 
 const isUploadable = (value: unknown) =>
   typeof value === 'object' &&

package/src/internal/utils/uuid.ts

@@ -1,12 +1,10 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
-import { getCrypto } from '../shims/crypto';
-
 /**
  * https://stackoverflow.com/a/2117523
  */
 export let uuid4 = function () {
-  const crypto = getCrypto();
+  const { crypto } = globalThis as any;
   if (crypto?.randomUUID) {
     uuid4 = crypto.randomUUID.bind(crypto);
     return crypto.randomUUID();

package/src/resources/api-keys.ts

@@ -9,6 +9,14 @@ import { path } from '../internal/utils/path';
 export class APIKeys extends APIResource {
   /**
    * Create a new API key
+   *
+   * @example
+   * ```ts
+   * const apiKey = await client.apiKeys.create({
+   *   expires_at: '2025-12-31T23:59:59Z',
+   *   name: 'my-api-key',
+   * });
+   * ```
    */
   create(body: APIKeyCreateParams, options?: RequestOptions): APIPromise<APIKey> {
     return this._client.post('/v1/api_keys', { body, ...options });
@@ -16,6 +24,11 @@ export class APIKeys extends APIResource {
 
   /**
    * Update an API key's name
+   *
+   * @example
+   * ```ts
+   * const apiKey = await client.apiKeys.update('api_key_id');
+   * ```
    */
   update(apiKeyID: string, body: APIKeyUpdateParams, options?: RequestOptions): APIPromise<APIKey> {
     return this._client.patch(path`/v1/api_keys/${apiKeyID}`, { body, ...options });
@@ -23,6 +36,11 @@ export class APIKeys extends APIResource {
 
   /**
    * List all API keys you created
+   *
+   * @example
+   * ```ts
+   * const apiKeyList = await client.apiKeys.list();
+   * ```
    */
   list(options?: RequestOptions): APIPromise<APIKeyList> {
     return this._client.get('/v1/api_keys', options);
@@ -30,6 +48,11 @@ export class APIKeys extends APIResource {
 
   /**
    * Delete an API key
+   *
+   * @example
+   * ```ts
+   * await client.apiKeys.delete('api_key_id');
+   * ```
    */
   delete(apiKeyID: string, options?: RequestOptions): APIPromise<void> {
     return this._client.delete(path`/v1/api_keys/${apiKeyID}`, {
@@ -40,6 +63,11 @@ export class APIKeys extends APIResource {
 
   /**
    * Get details about an API key
+   *
+   * @example
+   * ```ts
+   * const apiKey = await client.apiKeys.get('api_key_id');
+   * ```
    */
   get(apiKeyID: string, options?: RequestOptions): APIPromise<APIKey> {
     return this._client.get(path`/v1/api_keys/${apiKeyID}`, options);

package/src/resources/compute/vms/os-images.ts

@@ -8,6 +8,11 @@ import { RequestOptions } from '../../../internal/request-options';
 export class OSImages extends APIResource {
   /**
    * List all OS Images
+   *
+   * @example
+   * ```ts
+   * const osImages = await client.compute.vms.osImages.list();
+   * ```
    */
   list(options?: RequestOptions): APIPromise<OSImageListResponse> {
     return this._client.get('/v1/compute/vms/os_images', options);