feat(api): manual updates

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 21
-openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-3032c74460ad9c1c4b0a1b2d9107c556f292974a8ce12d525660a9cf31f10bc1.yml
+configured_endpoints: 23
+openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase/browserbase-17193ab4cc450d38ce1bfdb1a571001c04b754ba2ff2d2bb2dcf4a898d6c6c41.yml
 openapi_spec_hash: 8ac1c673ce4e72b88bbbf30100b95e8f
-config_hash: cf04ecfb8dad5fbd8b85be25d6e9ec55
+config_hash: 40fbac80e24faaa0dc19e93368bcd821

api.md

@@ -114,3 +114,14 @@ Types:
 Methods:
 
 - <code title="post /v1/sessions/{id}/uploads">client.sessions.uploads.<a href="./src/resources/sessions/uploads.ts">create</a>(id, { ...params }) -> UploadCreateResponse</code>
+
+## Replays
+
+Types:
+
+- <code><a href="./src/resources/sessions/replays.ts">ReplayRetrieveResponse</a></code>
+
+Methods:
+
+- <code title="get /v1/sessions/{id}/replays">client.sessions.replays.<a href="./src/resources/sessions/replays.ts">retrieve</a>(id) -> ReplayRetrieveResponse</code>
+- <code title="get /v1/sessions/{id}/replays/{pageId}">client.sessions.replays.<a href="./src/resources/sessions/replays.ts">retrievePage</a>(id, pageId) -> Response</code>

src/resources/sessions/index.ts

@@ -3,6 +3,7 @@
 export { Downloads } from './downloads';
 export { Logs, type SessionLog, type LogListResponse } from './logs';
 export { Recording, type SessionRecording, type RecordingRetrieveResponse } from './recording';
+export { Replays, type ReplayRetrieveResponse } from './replays';
 export {
   Sessions,
   type Session,

src/resources/sessions/replays.ts

@@ -0,0 +1,49 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { APIResource } from '../../resource';
+import * as Core from '../../core';
+import { type Response } from '../../_shims/index';
+
+export class Replays extends APIResource {
+  /**
+   * Returns page metadata for a session replay, including timing information and the
+   * URL of each page's HLS playlist.
+   */
+  retrieve(id: string, options?: Core.RequestOptions): Core.APIPromise<ReplayRetrieveResponse> {
+    return this._client.get(`/v1/sessions/${id}/replays`, options);
+  }
+
+  /**
+   * Returns an HLS VOD media playlist (.m3u8) for a specific page of a session
+   * replay.
+   */
+  retrievePage(id: string, pageId: string, options?: Core.RequestOptions): Core.APIPromise<Response> {
+    return this._client.get(`/v1/sessions/${id}/replays/${pageId}`, {
+      ...options,
+      headers: { Accept: 'application/vnd.apple.mpegurl', ...options?.headers },
+      __binaryResponse: true,
+    });
+  }
+}
+
+export interface ReplayRetrieveResponse {
+  pageCount: number;
+
+  pages: Array<ReplayRetrieveResponse.Page>;
+}
+
+export namespace ReplayRetrieveResponse {
+  export interface Page {
+    endTimeMs: number;
+
+    pageId: string;
+
+    startTimeMs: number;
+
+    url: string;
+  }
+}
+
+export declare namespace Replays {
+  export { type ReplayRetrieveResponse as ReplayRetrieveResponse };
+}

src/resources/sessions/sessions.ts

@@ -9,6 +9,8 @@ import * as LogsAPI from './logs';
 import { LogListResponse, Logs, SessionLog } from './logs';
 import * as RecordingAPI from './recording';
 import { Recording, RecordingRetrieveResponse, SessionRecording } from './recording';
+import * as ReplaysAPI from './replays';
+import { ReplayRetrieveResponse, Replays } from './replays';
 import * as UploadsAPI from './uploads';
 import { UploadCreateParams, UploadCreateResponse, Uploads } from './uploads';
 
@@ -17,6 +19,7 @@ export class Sessions extends APIResource {
   logs: LogsAPI.Logs = new LogsAPI.Logs(this._client);
   recording: RecordingAPI.Recording = new RecordingAPI.Recording(this._client);
   uploads: UploadsAPI.Uploads = new UploadsAPI.Uploads(this._client);
+  replays: ReplaysAPI.Replays = new ReplaysAPI.Replays(this._client);
 
   /**
    * Create a Session
@@ -437,6 +440,7 @@ Sessions.Downloads = Downloads;
 Sessions.Logs = Logs;
 Sessions.Recording = Recording;
 Sessions.Uploads = Uploads;
+Sessions.Replays = Replays;
 
 export declare namespace Sessions {
   export {
@@ -465,4 +469,6 @@ export declare namespace Sessions {
     type UploadCreateResponse as UploadCreateResponse,
     type UploadCreateParams as UploadCreateParams,
   };
+
+  export { Replays as Replays, type ReplayRetrieveResponse as ReplayRetrieveResponse };
 }

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

@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import Browserbase from '@browserbasehq/sdk';
+import { Response } from 'node-fetch';
+
+const client = new Browserbase({
+  apiKey: 'My API Key',
+  baseURL: process.env['TEST_API_BASE_URL'] ?? 'http://127.0.0.1:4010',
+});
+
+describe('resource replays', () => {
+  test('retrieve', async () => {
+    const responsePromise = client.sessions.replays.retrieve('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e');
+    const rawResponse = await responsePromise.asResponse();
+    expect(rawResponse).toBeInstanceOf(Response);
+    const response = await responsePromise;
+    expect(response).not.toBeInstanceOf(Response);
+    const dataAndResponse = await responsePromise.withResponse();
+    expect(dataAndResponse.data).toBe(response);
+    expect(dataAndResponse.response).toBe(rawResponse);
+  });
+
+  test('retrieve: request options instead of params are passed correctly', async () => {
+    // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
+    await expect(
+      client.sessions.replays.retrieve('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e', {
+        path: '/_stainless_unknown_path',
+      }),
+    ).rejects.toThrow(Browserbase.NotFoundError);
+  });
+
+  test('retrievePage: request options instead of params are passed correctly', async () => {
+    // ensure the request options are being passed correctly by passing an invalid HTTP method in order to cause an error
+    await expect(
+      client.sessions.replays.retrievePage('182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e', '090', {
+        path: '/_stainless_unknown_path',
+      }),
+    ).rejects.toThrow(Browserbase.NotFoundError);
+  });
+});