TypeScript SDK for reading and writing Hypercerts records on the AT Protocol.
Work in progress. The package is not published yet.
| Package | Description |
|---|---|
@hypercerts-org/sdk |
Read and write Hypercerts records. Operations are grouped by domain through subpath exports. |
The SDK takes an already-authenticated AT Protocol client. Authentication is the application's responsibility; an optional @hypercerts-org/auth package is planned. See the package README for setup.
Once published:
pnpm add @hypercerts-org/sdk @atproto/lexThe package is ESM-only and requires Node.js 24 or later.
Prerequisites:
- Node.js 24 (see
.nvmrc; also the lowest supported version) - pnpm 12 (the exact version is pinned in
package.jsonunderpackageManager)
pnpm install
pnpm build| Command | What it does |
|---|---|
pnpm build |
Build all packages |
pnpm typecheck |
Type-check all packages |
pnpm test |
Run the tests with Vitest |
pnpm lint |
Lint with Biome |
pnpm format |
Format files with Biome |
pnpm format:check |
Check formatting without changing files |
pnpm check:package |
Build, pack and install each package in an isolated project, then check it in Node, TypeScript and a Vite browser build |
pnpm check:duplicates |
Check for copied code with jscpd |
pnpm check:duplicates:semantic |
Check for functions that do the same thing written differently (jscpd; downloads a 548 MB model once) |
pnpm changeset |
Record a change for the next release |
Changes that affect a published package need a changeset (pnpm changeset). Packages are versioned independently. Publishing is not automated yet.