feat(api): update via SDK Studio (#9)

Author: stainless-app[bot]

.stats.yml

@@ -1,2 +1,2 @@
 configured_endpoints: 18
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-0069ed71133ac7b0add07abd8562396c4b8e3c9a212e14a7586782eeed2ff373.yml
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fbrowserbase-0d0ad7d4de2fa0b930b8d72fe6539ab248c7ed684b2e12b327b3bc0a466f9cde.yml

api.md

@@ -44,11 +44,12 @@ Types:
 
 - <code><a href="./src/resources/sessions/sessions.ts">Session</a></code>
 - <code><a href="./src/resources/sessions/sessions.ts">SessionLiveURLs</a></code>
+- <code><a href="./src/resources/sessions/sessions.ts">SessionCreateResponse</a></code>
 - <code><a href="./src/resources/sessions/sessions.ts">SessionListResponse</a></code>
 
 Methods:
 
-- <code title="post /v1/sessions">client.sessions.<a href="./src/resources/sessions/sessions.ts">create</a>({ ...params }) -> Session</code>
+- <code title="post /v1/sessions">client.sessions.<a href="./src/resources/sessions/sessions.ts">create</a>({ ...params }) -> SessionCreateResponse</code>
 - <code title="get /v1/sessions/{id}">client.sessions.<a href="./src/resources/sessions/sessions.ts">retrieve</a>(id) -> Session</code>
 - <code title="post /v1/sessions/{id}">client.sessions.<a href="./src/resources/sessions/sessions.ts">update</a>(id, { ...params }) -> Session</code>
 - <code title="get /v1/sessions">client.sessions.<a href="./src/resources/sessions/sessions.ts">list</a>({ ...params }) -> SessionListResponse</code>

src/index.ts

@@ -200,6 +200,7 @@ export namespace Browserbase {
   export import Sessions = API.Sessions;
   export import Session = API.Session;
   export import SessionLiveURLs = API.SessionLiveURLs;
+  export import SessionCreateResponse = API.SessionCreateResponse;
   export import SessionListResponse = API.SessionListResponse;
   export import SessionCreateParams = API.SessionCreateParams;
   export import SessionUpdateParams = API.SessionUpdateParams;

src/resources/index.ts

@@ -12,6 +12,7 @@ export { Project, ProjectUsage, ProjectListResponse, Projects } from './projects
 export {
   Session,
   SessionLiveURLs,
+  SessionCreateResponse,
   SessionListResponse,
   SessionCreateParams,
   SessionUpdateParams,

src/resources/sessions/index.ts

@@ -4,6 +4,7 @@ export { Downloads } from './downloads';
 export {
   Session,
   SessionLiveURLs,
+  SessionCreateResponse,
   SessionListResponse,
   SessionCreateParams,
   SessionUpdateParams,

src/resources/sessions/sessions.ts

@@ -18,7 +18,7 @@ export class Sessions extends APIResource {
   /**
    * Create a Session
    */
-  create(body: SessionCreateParams, options?: Core.RequestOptions): Core.APIPromise<Session> {
+  create(body: SessionCreateParams, options?: Core.RequestOptions): Core.APIPromise<SessionCreateResponse> {
     return this._client.post('/v1/sessions', { body, ...options });
   }
 
@@ -93,6 +93,72 @@ export namespace SessionLiveURLs {
   }
 }
 
+export interface SessionCreateResponse {
+  id: string;
+
+  /**
+   * WebSocket URL to connect to the Session.
+   */
+  connectUrl: string;
+
+  createdAt: string;
+
+  expiresAt: string;
+
+  /**
+   * Indicates if the Session was created to be kept alive upon disconnections
+   */
+  keepAlive: boolean;
+
+  /**
+   * The Project ID linked to the Session.
+   */
+  projectId: string;
+
+  /**
+   * Bytes used via the [Proxy](/features/stealth-mode#proxies-and-residential-ips)
+   */
+  proxyBytes: number;
+
+  /**
+   * The region where the Session is running.
+   */
+  region: 'us-west-2' | 'us-east-1' | 'eu-central-1' | 'ap-southeast-1';
+
+  /**
+   * HTTP URL to connect to the Session.
+   */
+  seleniumRemoteUrl: string;
+
+  /**
+   * Signing key to use when connecting to the Session via HTTP.
+   */
+  signingKey: string;
+
+  startedAt: string;
+
+  status: 'RUNNING' | 'ERROR' | 'TIMED_OUT' | 'COMPLETED';
+
+  updatedAt: string;
+
+  /**
+   * CPU used by the Session
+   */
+  avgCpuUsage?: number;
+
+  /**
+   * Optional. The Context linked to the Session.
+   */
+  contextId?: string;
+
+  endedAt?: string;
+
+  /**
+   * Memory used by the Session
+   */
+  memoryUsage?: number;
+}
+
 export type SessionListResponse = Array<Session>;
 
 export interface SessionCreateParams {
@@ -120,9 +186,12 @@ export interface SessionCreateParams {
    * Proxy configuration. Can be true for default proxy, or an array of proxy
    * configurations.
    */
-  proxies?:
-    | boolean
-    | Array<SessionCreateParams.BrowserbaseProxyConfig | SessionCreateParams.ExternalProxyConfig>;
+  proxies?: unknown;
+
+  /**
+   * The region where the Session should run.
+   */
+  region?: 'us-west-2' | 'us-east-1' | 'eu-central-1' | 'ap-southeast-1';
 
   /**
    * Duration in seconds after which the session will automatically end. Defaults to
@@ -180,7 +249,7 @@ export namespace SessionCreateParams {
       /**
        * Whether or not to persist the context after browsing. Defaults to `false`.
        */
-      persist: boolean;
+      persist?: boolean;
     }
 
     /**
@@ -227,75 +296,6 @@ export namespace SessionCreateParams {
       width?: number;
     }
   }
-
-  export interface BrowserbaseProxyConfig {
-    /**
-     * Type of proxy. Always use 'browserbase' for the Browserbase managed proxy
-     * network.
-     */
-    type: 'browserbase';
-
-    /**
-     * Domain pattern for which this proxy should be used. If omitted, defaults to all
-     * domains. Optional.
-     */
-    domainPattern?: string;
-
-    /**
-     * Configuration for geolocation
-     */
-    geolocation?: BrowserbaseProxyConfig.Geolocation;
-  }
-
-  export namespace BrowserbaseProxyConfig {
-    /**
-     * Configuration for geolocation
-     */
-    export interface Geolocation {
-      /**
-       * Country code in ISO 3166-1 alpha-2 format
-       */
-      country: string;
-
-      /**
-       * Name of the city. Use spaces for multi-word city names. Optional.
-       */
-      city?: string;
-
-      /**
-       * US state code (2 characters). Must also specify US as the country. Optional.
-       */
-      state?: string;
-    }
-  }
-
-  export interface ExternalProxyConfig {
-    /**
-     * Server URL for external proxy. Required.
-     */
-    server: string;
-
-    /**
-     * Type of proxy. Always 'external' for this config.
-     */
-    type: 'external';
-
-    /**
-     * Domain pattern for which this proxy should be used. If omitted, defaults to all
-     * domains. Optional.
-     */
-    domainPattern?: string;
-
-    /**
-     * Password for external proxy authentication. Optional.
-     */
-    password?: string;
-
-    /**
-     * Username for external proxy authentication. Optional.
-     */
-    username?: string;
-  }
 }
 
 export interface SessionUpdateParams {
@@ -319,6 +319,7 @@ export interface SessionListParams {
 export namespace Sessions {
   export import Session = SessionsAPI.Session;
   export import SessionLiveURLs = SessionsAPI.SessionLiveURLs;
+  export import SessionCreateResponse = SessionsAPI.SessionCreateResponse;
   export import SessionListResponse = SessionsAPI.SessionListResponse;
   export import SessionCreateParams = SessionsAPI.SessionCreateParams;
   export import SessionUpdateParams = SessionsAPI.SessionUpdateParams;

tests/api-resources/sessions/sessions.test.ts

@@ -42,7 +42,8 @@ describe('resource sessions', () => {
       },
       extensionId: 'extensionId',
       keepAlive: true,
-      proxies: true,
+      proxies: {},
+      region: 'us-west-2',
       timeout: 60,
     });
   });