JSPM

  • Created
  • Published
  • Downloads 74
  • Score
    100M100P100Q121111F
  • License MIT

Lightweight Bluesky labeler server for Cloudflare Workers.

Package Exports

  • @rito-blue/labeler
  • @rito-blue/labeler/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@rito-blue/labeler) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Rito Labeler

npm version license

Lightweight Bluesky labeler server designed for Cloudflare Workers. Fast, serverless, and easy to deploy.

Features

  • 🚀 Serverless: Built for Cloudflare Workers (Hono + Durable Objects).
  • 🛠️ CLI Setup: Interactive CLI to handle PDS registration and deployment in minutes.
  • 🛡️ JWT Auth: Robust authentication for moderator actions.

Supported Endpoints

This library implements a subset of ATProto XRPC endpoints relevant to labeling and moderation:

Labeling

  • com.atproto.label.queryLabels: Retrieve labels.
  • com.atproto.label.subscribeLabels: Real-time label stream (Websocket).

Moderation (Ozone Compatible)

  • tools.ozone.moderation.emitEvent: Labeling and Acknowledgment actions.
  • tools.ozone.moderation.queryStatuses: Query moderation statuses of subjects.
  • tools.ozone.moderation.queryEvents: Query moderation history.
  • com.atproto.moderation.createReport: Receive reports from users.

Team Management

  • tools.ozone.team.listMembers: List moderators.
  • tools.ozone.team.updateMember: Add/Update moderator roles.

Quick Start

1. Setup

Create a new directory and run the following command to initialize your project:

mkdir my-labeler
cd my-labeler
npx @rito-blue/labeler@latest setup

Follow the prompts to enter your Handle, Master Password, and endpoint URL.

2. Deploy

Once the setup is complete, install dependencies and deploy to your Cloudflare account:

pnpm install
pnpm run deploy

CLI Commands

If you have @rito-blue/labeler installed as a dependency, you can use these commands:

  • npx @rito-blue/labeler setup: Interactive setup and PDS registration.
  • npx @rito-blue/labeler deploy: Set secrets and deploy to Cloudflare Workers.

Architecture

Rito Labeler uses:

  • Hono: High-performance web framework.
  • Durable Objects: For websocket, state management and label indexing.

License

MIT License - Copyright (c) 2026 usounds.work

Contributing

Vulnerabilities should be reported via Bluesky @usounds.work.