Skip to main content

Crate skybase

Crate skybase 

Source
Expand description

§skybase

The Turn-Key Micro-AppView Engine & Developer Platform for the AT Protocol.

skybase brings Firebase-like developer ergonomics to the decentralized AT Protocol ecosystem. Rather than forcing developers to hand-roll custom firehose consumers, backfill pipelines, and database schemas, skybase provides a turn-key, single-binary Micro-AppView engine that ingests Bluesky Jetstream commits, indexes them into embedded SQLite WAL with JSON1 virtual columns and FTS5 full-text search, and serves real-time REST and WebSocket live queries down to clients.

Powered by skyauth, skybase supports three distinct operating topologies:

  • Topology A (Client-Sovereign / Zero Custody): Client applications write directly to user PDSs; skybase acts as a zero-custody read and indexing engine holding zero private credentials.
  • Topology B (Daemon-Managed / Bots): Server-side daemons hold DPoP sessions with AES-256-GCM encryption at rest.
  • Topology C (Token-Mediated Session Proxy): Mediates confidential OAuth sessions for static frontends (GitHub Pages, Wisp, Tangled) to prevent 2-week session dropouts.

Re-exports§

pub use appview::ActorProfile;
pub use appview::ActorSuggestion;
pub use appview::AppViewClient;
pub use appview::PostView;
pub use appview::DEFAULT_APPVIEW_ENDPOINT;
pub use appview::DEFAULT_APPVIEW_TIMEOUT_MS;
pub use appview::DEFAULT_CDN_ENDPOINT;
pub use chat::ChatClient;
pub use chat::ChatMessageView;
pub use chat::ConvoMember;
pub use chat::ConvoView;
pub use chat::DeletedMessageView;
pub use chat::MessageSender;
pub use chat::MessageView;
pub use chat::SendMessagePayload;
pub use chat::DEFAULT_CHAT_ENDPOINT;
pub use error::Result;
pub use error::SkybaseError;
pub use index::parse_at_uri;
pub use index::BatchStats;
pub use index::BroadcastBus;
pub use index::ChangeNotification;
pub use index::QueryBuilder;
pub use index::QueryOp;
pub use index::RecordInput;
pub use index::RecordRow;
pub use index::RecordStore;
pub use index::RecordStoreConfig;
pub use index::SortDirection;
pub use index::StoreOperation;
pub use index::DEFAULT_BROADCAST_CAPACITY;
pub use ingest::build_subscription_url;
pub use ingest::build_subscription_url_full;
pub use ingest::normalize_indexed_at;
pub use ingest::parse_frame_timestamp;
pub use ingest::parse_jetstream_commit;
pub use ingest::parse_jetstream_frame;
pub use ingest::resolve_resume_cursor;
pub use ingest::run_jetstream_streamer;
pub use ingest::BackoffManager;
pub use ingest::CommitOperation;
pub use ingest::CursorTracker;
pub use ingest::JetstreamCommit;
pub use ingest::JetstreamEvent;
pub use ingest::MockJetstreamServer;
pub use ingest::MockServerCommand;
pub use ingest::RawJetstreamCommit;
pub use ingest::RawJetstreamMessage;
pub use ingest::StreamConfig;
pub use ingest::CURSOR_REWIND_OVERLAP_US;
pub use ingest::DEFAULT_JETSTREAM_ENDPOINT;
pub use ingest::DEFAULT_PING_INTERVAL;
pub use ingest::DEFAULT_READ_TIMEOUT;
pub use ingest::INITIAL_BACKOFF;
pub use ingest::MAX_BACKOFF;
pub use ingest::MAX_JETSTREAM_REPLAY_WINDOW_US;
pub use ingest::sync_commit_to_store;
pub use ingest::ConsumerStats;
pub use ingest::IngesterConfig;
pub use ingest::JetstreamConsumer;
pub use ingest::JetstreamConsumerHandle;
pub use lexicon::format_system_time_iso8601;
pub use lexicon::format_unix_secs_iso8601;
pub use lexicon::has_nsfw_self_label;
pub use lexicon::now_iso8601;
pub use lexicon::ByteSlice;
pub use lexicon::Embed;
pub use lexicon::Facet;
pub use lexicon::FacetFeature;
pub use lexicon::FacetIndex;
pub use lexicon::FollowRecord;
pub use lexicon::ListBlockRecord;
pub use lexicon::ListItemRecord;
pub use lexicon::ListRecordsResponse;
pub use lexicon::ModListRecord;
pub use lexicon::PostRecord;
pub use lexicon::RecordEmbed;
pub use lexicon::RecordWithMediaEmbed;
pub use lexicon::ReplyRef;
pub use lexicon::RepoRecordItem;
pub use lexicon::SelfLabel;
pub use lexicon::SelfLabels;
pub use lexicon::StrongRef;
pub use lexicon::NSFW_SELF_LABEL_VALUES;
pub use repo::decode_tid_timestamp_secs;
pub use repo::decode_tid_timestamp_us;
pub use repo::extract_did_for_collection;
pub use repo::extract_did_from_at_uri;
pub use repo::format_at_uri;
pub use repo::generate_tid;
pub use repo::parse_at_post_uri;
pub use repo::split_at_uri;
pub use repo::validate_rkey;
pub use repo::CreateRecordRequest;
pub use repo::CreateRecordResult;
pub use repo::DeleteRecordRequest;
pub use repo::PdsRepoClient;
pub use repo::PutRecordRequest;
pub use repo::PutRecordResult;
pub use repo::RecordView;
pub use repo::TidGenerator;
pub use repo::XrpcErrorResponse;
pub use repo::MAX_PLAUSIBLE_TID_EPOCH_SECS;
pub use repo::MIN_PLAUSIBLE_TID_EPOCH_SECS;
pub use skyauth;

Modules§

appview
Read-only AppView XRPC client for Bluesky/ATProto public queries.
chat
ATProto Chat (chat.bsky.convo.*) client and data models.
error
Strongly-typed error definitions for skybase.
index
Embedded SQLite indexing and query engine for AT Protocol records.
ingest
Jetstream firehose consumer, monotonic cursor tracking, event parsing, and resilience.
lexicon
ATProto Lexicon data models for rich text and facets.
repo
Sovereign Personal Data Server (PDS) write client and repository mutation primitives.

Structs§

CancellationToken
A token which can be used to signal a cancellation request to one or more tasks.
LoginIdentityPreview
Combined OAuth provider discovery and public profile preview for a user handle or DID.
Skybase
The unified Skybase backend engine and client facade.
SkybaseConfig
Configuration options for initializing a Skybase engine instance.