networking
Distributed networking, event buses, drive mesh, and network discovery.
Subcategories
3 subcategories, 65 packages.
drive
Virtual filesystem, mesh networking, and chunk-addressed storage plugins.
| Package | Description |
|---|---|
@suaveplan/drive |
Modular virtual filesystem core for Suaveplan. File-level operations over AbstractStorage with a plugin slot for middleware, chunking, encryption, and P2P me… |
@suaveplan/drive-mesh |
P2P mesh orchestrator over the drive chunks plugin. Consumes ChunkSource (from @suaveplan/drive-plugin-chunks) and one or more DriveTransport implementat… |
@suaveplan/drive-mesh-protocol |
Wire protocol for chunk discovery, request, and delivery across the mesh. Three envelope shapes (cd:request, cd:advertise, cd:response) with three reques… |
@suaveplan/drive-plugin-cache |
Read-through cache middleware for @suaveplan/drive. Accepts a caller-supplied AbstractCache<Uint8Array> (from @suaveplan/cache) and intercepts every `dri… |
@suaveplan/drive-plugin-chunks |
Chunk-addressing plugin for @suaveplan/drive. Splits files into signed, encrypted chunks using the locked version 0x0001 binary format, with server-signed… |
@suaveplan/drive-react-sharing |
React-tier UI surface for @suaveplan/drive-sharing. Three controlled components plus a real-engine-backed hook. |
@suaveplan/drive-sharing |
Partitioned drive sharing engine for the Suaveplan ecosystem. Ships envelope encryption with mandatory AAD, per-user key wrapping, partition policies with dete… |
@suaveplan/drive-storage-archive-core |
Shared archive-mounting primitives for the Suaveplan drive: magic-byte format sniffing, split-volume sibling resolution, password hook contract, mutation-mode… |
@suaveplan/drive-storage-zip |
ZIP archive adapter for @suaveplan/drive. Reads and writes standards-compliant zip archives through the structural DriveStorage view; supports ZIP64, split… |
@suaveplan/drive-template |
Server-signed drive templates for the dehydrated-drive workflow. A DriveTemplate describes a drive's full folder structure and per-file metadata; the actual… |
@suaveplan/drive-transport-https |
HTTPS-relay-backed TransportLike<MessageEnvelope> for the Suaveplan drive mesh. Implements long-poll receive, stateless POST send, exponential backoff with e… |
@suaveplan/drive-transport-webrtc |
WebRTC datachannel transport for the drive mesh. Implements the canonical DriveTransport interface from @suaveplan/drive-mesh over a `@suaveplan/drive-webr… |
@suaveplan/drive-uri |
URI plugins (drive://, drive+mesh://, drive+template://) for @suaveplan/storage-uri's StorageUriResolver. Wraps a caller-supplied Drive instance in… |
@suaveplan/drive-webrtc |
Browser-tier WebRTC P2P chunk-distribution plugin for @suaveplan/drive. Provides a complete mesh networking stack — signalling client, ICE-aware WebRTC clien… |
events
Typed event bus, event sourcing, metrics, and transport bridges.
| Package | Description |
|---|---|
@suaveplan/broadcast-channel |
Typed cross-tab messaging built on the Web BroadcastChannel API. Browser-tier package — leader election, tab presence and heartbeats, message-type handler re… |
@suaveplan/event-sourcing |
Event sourcing patterns for Suaveplan: typed aggregate root, in-memory event store with optimistic concurrency, snapshot support, projections, upcasting, and O… |
@suaveplan/events |
Typed event-bus substrate for Suaveplan. Pub/sub with deterministic FIFO delivery, interceptor API, bounded-queue backpressure, idempotent listeners, Zod-valid… |
@suaveplan/events-metrics |
OTel metrics companion for @suaveplan/events. Attaches via the public interceptor API to record dispatch totals, listener error counts, and latency histogram… |
@suaveplan/events-otel |
OpenTelemetry tracing companion for @suaveplan/events. Wraps each dispatch in a span, propagates W3C Trace Context, and records listener exceptions as span e… |
@suaveplan/events-schema |
Runtime schema-validation companion for @suaveplan/events. Validates event payloads at dispatch boundaries via Zod schemas with strict/warn/sample modes and… |
@suaveplan/events-transport |
Cross-context event bridges for @suaveplan/events: MessageChannel (at-least-once with ack/retry) and BroadcastChannel (at-most-once, fan-out) transports… |
network
Mesh networking, WebSocket transports, bootstrap, and discovery protocols.
| Package | Description |
|---|---|
@suaveplan/network |
Core network interfaces and runtime for the mesh system. |
@suaveplan/network-bootstrap |
Pluggable peer-discovery chain, persistent peer cache, and NetworkPlugin wrapper for the @suaveplan/network mesh. Provides the canonical way for a freshly… |
@suaveplan/network-discovery-crdt |
Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap. Wraps an awareness-document CRDT (Yjs or Automerge — chosen at construction) and produce… |
@suaveplan/network-discovery-gundb |
Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap chains. Wraps a GunDB instance — gossip-over- WebSocket decentralised graph database — and… |
@suaveplan/network-discovery-hybrid |
Browser-tier multi-strategy DiscoveryStrategy orchestrator: composes any subset of the five Wave-2 sibling strategies (peerjs / crdt / trystero / webtorrent / gundb) into a single HybridDiscoveryManager with priority-based peer selection, per-strategy health tracking, automatic fallback, de-duplicated peer set with PeerSource provenance, and unified lifecycle. Implements the network-bootstrap DiscoveryStrategy contract so it can itself be chained. |
@suaveplan/network-discovery-peerjs |
Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap that wraps a PeerJS signalling-server client + WebRTC DataConnections into a deduped peer… |
@suaveplan/network-discovery-trystero |
Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap. Serverless WebRTC peer discovery via Trystero, with four interchangeable transports — BitT… |
@suaveplan/network-discovery-webtorrent |
Browser-tier DiscoveryStrategy for @suaveplan/network-bootstrap chains. Wraps a p2pt instance — WebTorrent-tracker-driven WebRTC peer discovery — and exp… |
@suaveplan/network-gundb-server |
Server-tier GunDB relay daemon. Hosts a Gun relay peer plus standard /health / /ready / /live probes on a single Node http.Server. Browser-tier clients… |
@suaveplan/network-libp2p-server |
Server-tier libp2p relay daemon paired with @suaveplan/network-transport-libp2p. Hosts a libp2p node configured as a bootstrap + circuit-relay-v2 server alon… |
@suaveplan/network-plugin-assignment |
Mesh auto-assignment and load balancing: live MeshCapacityTracker, weighted-multi-criteria AssignmentEngine, imbalance-detecting MeshBalancer planner, an… |
@suaveplan/network-plugin-audit-mesh |
Tamper-evident, cryptographically signed, append-only audit log chain for the Suaveplan mesh. SignedLog produces hash-chained LogEntry records keyed by mon… |
@suaveplan/network-plugin-auth |
Mesh membership authentication and cross-mesh relay authorization. Bridges @suaveplan/auth into the mesh: peer join verification, capability-tier-bound token… |
@suaveplan/network-plugin-circuit-breaker |
Mesh-level circuit breakers: per-path state machine (CLOSED → OPEN → HALF_OPEN), registry, half-open probe loop, and relay middleware integration. Fast-fails… |
@suaveplan/network-plugin-content-delivery |
Mesh-as-CDN core for the Suaveplan network. ChunkIndex maintains a distributed holder map keyed by chunk hash with gossip-style merge over `ChunkAdvertisemen… |
@suaveplan/network-plugin-crypto-messages |
Cryptographic integrity layer for the Suaveplan mesh. Ed25519-backed MessageSigner (sign on send, verify against the registry on receive); `SessionTokenAutho… |
@suaveplan/network-plugin-devtools |
Developer-tools plugin for the Suaveplan mesh. Bundles four subsystems behind a single NetworkPlugin lifecycle so engineers can inspect, visualise, and profi… |
@suaveplan/network-plugin-failover |
Mesh failover plugin: per-peer heartbeat manager, alive→suspect→dead→recovering health monitor, debounced promoter that triggers emergency elections, and a coo… |
@suaveplan/network-plugin-governance |
Election engine for the Suaveplan mesh: candidate scoring, reputation tracking, voting, and host transitions. |
@suaveplan/network-plugin-intra-relay |
Intra-mesh peer-to-peer relay for the Suaveplan network. When direct WebRTC fails (symmetric NAT, restrictive firewall), IntraRelayPlugin routes the message… |
@suaveplan/network-plugin-middleware |
Priority-ordered middleware chain for the Suaveplan mesh. Inbound and outbound message flow each pass through the same five-band pipeline (CRITICAL → HIGH → NO… |
@suaveplan/network-plugin-migration |
Peer state migration between meshes: 8-step MigrationCoordinator, snapshot serialize/deserialize via StateTransferProtocol, graceful-handoff `ForwardingTun… |
@suaveplan/network-plugin-monitor |
Production monitoring + distributed tracing for the Suaveplan mesh. Collects metrics across four categories (node / connection / message / hierarchy), supports… |
@suaveplan/network-plugin-partition |
Split-brain detection and resolution for the mesh: epoch-based PartitionDetector (deterministic partition-id from sorted reachable set), QuorumResolver wit… |
@suaveplan/network-plugin-protocol |
Network protocol plugin for the mesh system. |
@suaveplan/network-plugin-qos |
Bandwidth management and quality-of-service for the mesh: bandwidth-quota enforcer, message-priority classifier, QoS router (bypass / drop / queue / defer), co… |
@suaveplan/network-plugin-registry |
Fixed-capacity peer registry with bitpacker-based binary encoding. |
@suaveplan/network-plugin-relay |
Cross-mesh relay — the federation layer that lets Tier 0 hosts of different meshes route messages to each other. Composes RelayRouter, `HostBackboneTransport… |
@suaveplan/network-plugin-server-bridge |
Tier-0 host ↔ central-server bridge for the Suaveplan mesh. |
@suaveplan/network-plugin-session |
Hierarchical session management for the Suaveplan mesh. SessionTree maintains a parent-child session graph rooted at a single auto-created root; `SessionMana… |
@suaveplan/network-plugin-simulation |
Deterministic virtual-network simulation framework for the Suaveplan mesh. NetworkSimulator runs scenarios against a seeded RNG with simulated time (accelera… |
@suaveplan/network-plugin-state |
Mesh-wide synchronized state for the Suaveplan network. Path-based StateManager (versioned history with sequence numbers + per-path subscriptions); `DeltaCom… |
@suaveplan/network-plugin-topology |
Tiered mesh topology plugin: 3-tier HierarchicalTopology (Host / SubHost / Leaf) with promote/demote, latency-bucket-based LatencyAssigner, GroupManager,… |
@suaveplan/network-plugin-transport-manager |
Multi-transport orchestration for the Suaveplan mesh. Maintains a pool of registered transports per peer, negotiates capability bitmaps during handshake, route… |
@suaveplan/network-testing |
|
@suaveplan/network-transport-hyperswarm |
Server-tier Hyperswarm DHT transport for @suaveplan/network. Provides hole-punched peer-to-peer streams discovered via Kademlia DHT topics. |
@suaveplan/network-transport-libp2p |
Universal libp2p Transport for @suaveplan/network. Composes WebSockets or WebRTC sub-transports with Noise + Yamux, identify + ping + bootstrap + circ… |
@suaveplan/network-transport-standby |
Pre-emptive WebRTC standby transport for @suaveplan/network. Maintains a pool of warm RTCPeerConnection-like slots so peer attach completes in ~10 ms inste… |
@suaveplan/network-transport-webrtc |
WebRTC transport plugin for mesh networking. |
@suaveplan/network-transport-websockets |
WebSocket client utilities with typed message framing, connection lifecycle management, heartbeat, backpressure queue, and injectable transport adapters. |
@suaveplan/network-trystero-server |
Server-tier Trystero signaling daemon. Hosts an MQTT-style or Nostr-style WebSocket broker shim plus standard /health / /ready / /live probes on a single… |
@suaveplan/react-network-libp2p-demo |
React-tier demo UI for @suaveplan/network-transport-libp2p. Splits the upstream 749-LOC monolithic demo into per-concern subcomponents (<NodeStatusPanel>,… |
@suaveplan/service-discovery |
Universal service-registry primitives. Provides the shared ServiceDescriptor, ServiceQuery, RegistryEvent, and ServiceRegistry contract consumed b… |
@suaveplan/websocket-gateway |
Server-tier WebSocket gateway daemon with rooms, presence tracking, and channel-multiplexed pub/sub. Pairs with @suaveplan/network-transport-websockets on th… |