@atcute/client

lightweight and cute API client for AT Protocol.

• small, the bare minimum is ~1 kB gzipped with the full package at ~2.4 kB gzipped.
• no runtime validation, type definitions match actual HTTP responses, the server is assumed to be trusted in returning valid responses.

1import { XRPC, CredentialManager } from '@atcute/client';
2
3const manager = new CredentialManager({ service: 'https://bsky.social' });
4const rpc = new XRPC({ handler: manager });
5
6await manager.login({ identifier: 'example.com', password: 'ofki-yrwl-hmcc-cvau' });
7
8console.log(manager.session);
9// -> { refreshJwt: 'eyJhb...', ... }
10
11const { data } = await rpc.get('com.atproto.identity.resolveHandle', {
12	params: {
13		handle: 'pfrazee.com',
14	},
15});
16
17console.log(data.did);
18// -> did:plc:ragtjsm2j2vknwkz3zp4oxrd

by default, the API client only ships with the base AT Protocol (com.atproto.*) lexicons and endpoints , along with a middleware for doing a (legacy) authentication with a PDS. you can extend these with optional definition packages:

• @atcute/bluemoji: adds blue.moji.* definitions
• @atcute/bluesky: adds app.bsky.* and chat.bsky.* definitions
• @atcute/ozone: adds tools.ozone.* definitions
• @atcute/whitewind: adds com.whtwnd.* definitions