firehose
A JavaScript SDK for Bluesky and AT Protocol by skyware-js
A dead simple client for subscribing to an ATProto Relay ("firehose").
GitHub Stats
41stars
3forks
2contributors
1open issues
Dates
Created:February 23, 2024
Last updated:February 2, 2026
README
The following content is from firehose's GitHub repository. All rights reserved by the original author.
@skyware/firehose
A simple client for consuming data from an AT Protocol Relay.
Installation
npm install @skyware/firehose
Example Usage
import { Firehose } from "@skyware/firehose";
const firehose = new Firehose();
firehose.on("commit", (commit) => {
for (const op of commit.ops) {
console.log(op);
}
});
firehose.start();
Events
| Event | Description |
|---|---|
commit | Represents a commit to a user's repository. |
identity | Represents a change to an account's identity. Could be an updated handle, signing key, or PDS hosting endpoint. |
handle | Represents an update of an account's handle, or transition to/from invalid state (may be deprecated in favor of identity). |
tombstone | Indicates that an account has been deleted (may be deprecated in favor of identity or a future account event). |
info | An informational message from the relay. |
open | Emitted when the websocket connection is opened. |
close | Emitted when the websocket connection is closed. |
error | Emitted when an error occurs while handling a message. |
websocketError | Emitted when an error occurs with the websocket connection. |
Related SDKs
pdslsatproto explorer - mirror to https://tangled.org/pds.ls/pdsls
18•JavaScript
FxEmbedFix X/Twitter and Bluesky embeds! Use multiple images, videos, polls, translations and more on Discord, Telegram and others
3953•JavaScript
atprotoAT Protocol Reference Implementation (TypeScript)
9105•JavaScript
atproto-scrapingGit scraping of AT Protocol/Bluesky instances
168•JavaScript
bluesky-labeler-scrapingGit scraping of Bluesky labelers/label providers
68•JavaScript
ozoneweb interface for labeling content in atproto / Bluesky
503•JavaScript
Resources
Our Sponsors
Your Brand Here!
50K+ engaged viewers every month
Limited spots available!
📧 Contact us via email🦋 Contact us on Bluesky