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;
skybaseacts 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::extract_link_facets;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§
- Cancellation
Token - A token which can be used to signal a cancellation request to one or more tasks.
- Login
Identity Preview - Combined OAuth provider discovery and public profile preview for a user handle or DID.
- Skybase
- The unified Skybase backend engine and client facade.
- Skybase
Config - Configuration options for initializing a
Skybaseengine instance.