atcute

atcute

lightweight TypeScript packages for AT Protocol, the protocol powering Bluesky.

quick start

npm install @atcute/client @atcute/bluesky

import { Client, simpleFetchHandler } from '@atcute/client';
import type {} from '@atcute/bluesky';

const client = new Client({
	handler: simpleFetchHandler({ service: 'https://public.api.bsky.app' }),
});

const { data } = await client.get('app.bsky.actor.getProfile', {
	params: { actor: 'bsky.app' },
});

console.log(data.displayName);
// -> Bluesky

for authenticated requests, see the client docs or use the OAuth browser client for web apps.

packages

contributing

this monorepo uses mise for runtime versioning and pnpm for package management.

# install runtimes
mise install

# build all packages
pnpm run -r build

# pull latest lexicons and regenerate definitions
pnpm run -r pull
pnpm run -r generate