Setting up the environment

This repository uses yarn@v1. Other package managers may work but are not officially supported for development.

To set up the repository, run:

$ yarn
$ yarn build

This will install all the required dependencies and build output files to dist/.

Modifying/Adding code

Most of the SDK is generated code. Modifications to code will be persisted between generations, but may result in merge conflicts between manual patches and changes from the generator. The generator will never modify the contents of the src/lib/ and examples/ directories.

Adding and running examples

All files in the examples/ directory are not modified by the generator and can be freely edited or added to.

// add an example to examples/<your-example>.ts

#!/usr/bin/env -S npm run tsn -T
…

$ chmod +x examples/<your-example>.ts
# run the example against your api
$ yarn tsn -T examples/<your-example>.ts

Using the repository from source

If you’d like to use the repository from source, you can either install from git or link to a cloned repository:

To install via git:

$ npm install git+ssh://git@github.com:browserbase/sdk-node.git

Alternatively, to link a local copy of the repo:

# Clone
$ git clone https://www.github.com/browserbase/sdk-node
$ cd sdk-node

# With yarn
$ yarn link
$ cd ../my-package
$ yarn link @browserbasehq/sdk

# With pnpm
$ pnpm link --global
$ cd ../my-package
$ pnpm link --global @browserbasehq/sdk

Running tests

Most tests require you to set up a mock server against the OpenAPI spec to run the tests.

$ ./scripts/mock

$ yarn run test

Linting and formatting

This repository uses prettier and eslint to format the code in the repository.

To lint:

$ yarn lint

To format and fix all lint issues automatically:

$ yarn fix

Publishing and releases

Changes made to this repository via the automated release PR pipeline should publish to npm automatically. If the changes aren't made through the automated pipeline, you may want to make releases manually.

Publish with a GitHub workflow

You can release to npm by using the Publish NPM GitHub action. The workflow authenticates to npm through trusted publishing with GitHub Actions OIDC; it doesn't require an npm token secret.

The @browserbasehq/sdk package's trusted publisher must authorize the browserbase/sdk-node repository and the publish-npm.yml workflow.

Publish manually

If you need to release a package outside GitHub Actions, authenticate the npm CLI locally and run the bin/publish-npm script.