BellD / DevelopersDocumentation · latest

TypeScript SDK reference

Public exports and declarations are extracted with the TypeScript compiler. Capability methods and options come from generated types. Wrap runtime calls in belld.withRequest(req, fn).

Install

The SDK is not published on npm yet. Download belld-sdk.tgz from the Overview page in the Console and check it against SHA256SUMS on the same page.

Put the file next to your app's package.json (in a monorepo, in the service's subdirectory) and add it as a file dependency:

{ "dependencies": { "@belld/sdk": "file:belld-sdk.tgz" } }

Run your package manager's install once, then commit both the .tgz file and the updated lockfile; BellD installs from them when it builds your app. To update the SDK, replace the file and install again. The SDK requires Node.js 22 or later.

BellD has not published @belld/sdk on npm yet. Until this page says otherwise, a package with that name on npm is not from BellD; do not install it.

export { belld, createBellD } from './client.js';
export type { BellD, BellDRequest, BellDOptions } from './client.js';
export { BellDCapabilityError } from './errors.js';
export type { BellDProblem } from './errors.js';
export { createFakeBellD } from './fake.js';
export type { FakeBellDResponses } from './fake.js';
export type { BellDCapabilities, CapabilityOptions, JsonValue } from './generated/capabilities.js';
export type { BellDMember } from './member.js';