> Fetch the index of every Tonbo docs page as Markdown at https://tonbo.dev/llms.txt

# Node.js SDK reference

Last updated 29 October 2026

Every export of [@tonbo/sqlite-ursula](https://www.npmjs.com/package/@tonbo/sqlite-ursula) 0.11.2, with its options, return values, status fields and errors.

To get started, follow the [SQLite quickstart](https://tonbo.dev/docs/getting-started/quickstarts/sqlite.md) and [Connect from Node.js](https://tonbo.dev/docs/databases/connect.md). This reference marks what 0.11.0 lacks with the release that added it, such as “since 0.11.1”, and what a later release changed with that release.

## Entry points

| Import | Opens | Use it for |
| --- | --- | --- |
| `@tonbo/sqlite-ursula/tonbo` | A Tonbo database by name or URL, with a Tonbo API key (since 0.11.1) | An application on Tonbo. [open()](https://tonbo.dev/docs/reference/nodejs/open.md) and [resolveDatabase()](https://tonbo.dev/docs/reference/nodejs/resolve-database.md). |
| `@tonbo/sqlite-ursula` | A stream by URL, with a bearer token you supply | A token you mint yourself, a self-hosted [Ursula](https://github.com/tonbo-io/ursula), [importSqlite()](https://tonbo.dev/docs/reference/nodejs/gate-and-import.md#import-sqlite) and [loadUrsulaVfs()](https://tonbo.dev/docs/reference/nodejs/sql-functions.md#load-ursula-vfs). |
| `@tonbo/sqlite-ursula/tonbo/pi` | [Pi Durable](https://github.com/earendil-works/pi/blob/main/packages/durable/README.md)’s SqliteStorage on a Tonbo database, by name (since 0.11.1) | A Pi Durable Harness on Tonbo. See [Pi Durable storage](https://tonbo.dev/docs/reference/nodejs/pi.md#tonbo-open-ursula-pi-storage). |
| `@tonbo/sqlite-ursula/pi` | [Pi Durable](https://github.com/earendil-works/pi/blob/main/packages/durable/README.md)’s SqliteStorage on a database, by URL | A Pi Durable Harness. See [Pi Durable storage](https://tonbo.dev/docs/reference/nodejs/pi.md). |

`/tonbo` also exports the database class, `gate`, the errors and the token types, so an application on Tonbo imports from it alone. It does not export `OpenOptions`, `importSqlite` or `loadUrsulaVfs`; import those from the root entry.

## Install

```shell
npm install --save-exact @tonbo/sqlite-ursula@0.11.2
```

Pin this exact version, as `--save-exact` records it: a later release can change the package’s entry points, its cache format and the server releases it works with. It needs Node.js 22.19 or later on one of the prebuilt platforms (see [Requirements](https://tonbo.dev/docs/databases/connect.md#requirements)). For Pi Durable, install its optional peer dependency too, from 1.0.0 up to but not including 1.4.0 (see [Quickstart: Pi Durable](https://tonbo.dev/docs/getting-started/quickstarts/pi.md)):

```shell
npm install --save-exact @tonbo/sqlite-ursula@0.11.2 @earendil-works/pi-durable
```

## Exports

| Name | Kind | Entry points |
| --- | --- | --- |
| [`open`](https://tonbo.dev/docs/reference/nodejs/open.md#tonbo-open) | function | /tonbo, since 0.11.1 |
| [`TonboOpenOptions`](https://tonbo.dev/docs/reference/nodejs/open.md#tonbo-open-options) | type | /tonbo, since 0.11.1 |
| [`open`](https://tonbo.dev/docs/reference/nodejs/open.md#root-open) | function | root |
| [`OpenOptions`](https://tonbo.dev/docs/reference/nodejs/open.md#open-options) | type | root |
| [`resolveDatabase`](https://tonbo.dev/docs/reference/nodejs/resolve-database.md#resolve-database) | function | /tonbo, since 0.11.1 |
| [`TonboResolveOptions`](https://tonbo.dev/docs/reference/nodejs/resolve-database.md#tonbo-resolve-options) | type | /tonbo, since 0.11.1 |
| [`ResolvedDatabase`](https://tonbo.dev/docs/reference/nodejs/resolve-database.md#resolved-database) | type | /tonbo, since 0.11.1 |
| [`UrsulaDatabase`](https://tonbo.dev/docs/reference/nodejs/database.md#ursula-database) | class | root, /tonbo |
| [`ResetListener`](https://tonbo.dev/docs/reference/nodejs/database.md#reset-listener) | type | root, /tonbo |
| [`UrsulaStatus`](https://tonbo.dev/docs/reference/nodejs/status.md#ursula-status) | type | root, /tonbo |
| [`UrsulaSalvage`](https://tonbo.dev/docs/reference/nodejs/status.md#ursula-salvage) | type | root, /tonbo |
| [`UrsulaError`](https://tonbo.dev/docs/reference/nodejs/errors.md#ursula-error) | class | root, /tonbo, /tonbo/pi |
| [`UrsulaErrorAction`](https://tonbo.dev/docs/reference/nodejs/errors.md#actions) | type | root, /tonbo |
| [`UrsulaErrorKind`](https://tonbo.dev/docs/reference/nodejs/errors.md#ursula-error-kind) | type | root, /tonbo |
| [`UrsulaWriteRefusedError`](https://tonbo.dev/docs/reference/nodejs/errors.md#ursula-write-refused-error) | class | root, /tonbo, /tonbo/pi |
| [`WriteRefusedKind`](https://tonbo.dev/docs/reference/nodejs/errors.md#write-refused-kind) | type | root, /tonbo |
| [`UrsulaResetError`](https://tonbo.dev/docs/reference/nodejs/errors.md#ursula-reset-error) | class | root, /tonbo, /tonbo/pi |
| [`ResetKind`](https://tonbo.dev/docs/reference/nodejs/errors.md#reset-kind) | type | root, /tonbo |
| [`UrsulaUnavailableError`](https://tonbo.dev/docs/reference/nodejs/errors.md#ursula-unavailable-error) | class | root, /tonbo, /tonbo/pi |
| [`UnavailableKind`](https://tonbo.dev/docs/reference/nodejs/errors.md#unavailable-kind) | type | root, /tonbo |
| [`UrsulaSetupError`](https://tonbo.dev/docs/reference/nodejs/errors.md#ursula-setup-error) | class | root, /tonbo, /tonbo/pi |
| [`SetupKind`](https://tonbo.dev/docs/reference/nodejs/errors.md#setup-kind) | type | root, /tonbo |
| [`TonboError`](https://tonbo.dev/docs/reference/nodejs/errors.md#tonbo-error) | class | /tonbo, /tonbo/pi, since 0.11.1 |
| [`TonboKind`](https://tonbo.dev/docs/reference/nodejs/errors.md#tonbo-kind) | type | /tonbo, /tonbo/pi, since 0.11.1 |
| [`TokenProvider`](https://tonbo.dev/docs/reference/nodejs/tokens.md#token-provider) | type | root, /tonbo, since 0.11.1 |
| [`BearerToken`](https://tonbo.dev/docs/reference/nodejs/tokens.md#bearer-token) | type | root, /tonbo, since 0.11.1 |
| [`gate`](https://tonbo.dev/docs/reference/nodejs/gate-and-import.md#gate) | function | root, /tonbo |
| [`GateOptions`](https://tonbo.dev/docs/reference/nodejs/gate-and-import.md#gate-options) | type | root, /tonbo |
| [`importSqlite`](https://tonbo.dev/docs/reference/nodejs/gate-and-import.md#import-sqlite) | function | root |
| [`ImportOptions`](https://tonbo.dev/docs/reference/nodejs/gate-and-import.md#import-options) | type | root |
| [`Imported`](https://tonbo.dev/docs/reference/nodejs/gate-and-import.md#imported) | type | root |
| [`openUrsulaPiStorage`](https://tonbo.dev/docs/reference/nodejs/pi.md#open-ursula-pi-storage) | function | /pi |
| [`UrsulaPiStorageOptions`](https://tonbo.dev/docs/reference/nodejs/pi.md#ursula-pi-storage-options) | type | /pi |
| [`openUrsulaPiStorage`](https://tonbo.dev/docs/reference/nodejs/pi.md#tonbo-open-ursula-pi-storage) | function | /tonbo/pi, since 0.11.1 |
| [`TonboPiStorageOptions`](https://tonbo.dev/docs/reference/nodejs/pi.md#tonbo-pi-storage-options) | type | /tonbo/pi, since 0.11.1 |
| [`loadUrsulaVfs`](https://tonbo.dev/docs/reference/nodejs/sql-functions.md#load-ursula-vfs) | function | root |