Initial commit

src/lib/swarm/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Swarm Module
+ * 
+ * The Synapsis swarm is a decentralized network of nodes that discover
+ * and communicate with each other using a hybrid approach:
+ * 
+ * 1. Seed nodes (like node.synapsis.social) provide initial bootstrap
+ * 2. Gossip protocol spreads node/handle information epidemically
+ * 3. Any node can discover the full network without central authority
+ * 4. Direct node-to-node interactions (likes, follows, etc.) bypass ActivityPub
+ * 
+ * Usage:
+ * - On node startup: call announceToSeeds() to register with the network
+ * - Periodically: call runGossipRound() to exchange info with peers
+ * - On demand: call discoverNode() to add a specific node
+ * - For interactions: use swarm-first delivery with AP fallback
+ */
+
+export * from './types';
+export * from './registry';
+export * from './discovery';
+export * from './gossip';
+export * from './interactions';