peerpigeon 0.1.0 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/README.md +141 -1365
  2. package/cli.js +1382 -0
  3. package/dist/peerpigeon-browser.js +12290 -0
  4. package/dist/peerpigeon-browser.js.map +7 -0
  5. package/docs/API_DOCUMENTATION.md +1945 -0
  6. package/docs/BOOTSTRAP_HUBS.md +319 -0
  7. package/docs/CLI_README.md +371 -0
  8. package/docs/DOCUMENTATION_REORGANIZATION.md +172 -0
  9. package/docs/HUB_QUICK_REF.md +107 -0
  10. package/docs/HUB_SCRIPTS.md +331 -0
  11. package/docs/HUB_SYSTEM.md +552 -0
  12. package/docs/MIGRATION_COMPLETE.md +93 -0
  13. package/docs/NETWORK_NAMESPACES.md +212 -0
  14. package/docs/README.md +107 -0
  15. package/docs/SELECTIVE_STREAMING_GUIDE.md +427 -0
  16. package/docs/TEST_CLEANUP_COMPLETE.md +80 -0
  17. package/examples/bootstrap-hub-example.js +292 -0
  18. package/examples/browser/README.md +278 -0
  19. package/examples/browser/app.js +2426 -49
  20. package/examples/browser/index.html +482 -543
  21. package/examples/browser/minimal/README.md +55 -0
  22. package/examples/browser/minimal/index.html +75 -0
  23. package/examples/browser/minimal/minimal.js +234 -0
  24. package/examples/browser/styles.css +687 -1425
  25. package/examples/browser/test-bundle.html +35 -0
  26. package/examples/browser-2/index.html +30 -0
  27. package/examples/browser-2/package.json +21 -0
  28. package/examples/browser-2/src/App-simple.vue +21 -0
  29. package/examples/browser-2/src/App.vue +420 -0
  30. package/examples/browser-2/src/components/CryptoView.vue +1661 -0
  31. package/examples/browser-2/src/components/DHTView.vue +1281 -0
  32. package/examples/browser-2/src/components/DebugView.vue +1773 -0
  33. package/examples/browser-2/src/components/MediaView.vue +1048 -0
  34. package/examples/browser-2/src/components/MessagingView.vue +775 -0
  35. package/examples/browser-2/src/components/NetworkView.vue +930 -0
  36. package/examples/browser-2/src/components/StorageView.vue +1376 -0
  37. package/examples/browser-2/src/main.js +5 -0
  38. package/examples/browser-2/src/stores/peerpigeon.js +895 -0
  39. package/examples/browser-2/vite.config.js +6 -0
  40. package/examples/hub-example.js +186 -0
  41. package/examples/multi-hub-test.js +186 -0
  42. package/examples/node/README.md +2 -2
  43. package/examples/node/storage-test.js +141 -6
  44. package/examples/selective-streaming-demo.html +698 -0
  45. package/examples/standard-events-demo.js +126 -0
  46. package/package.json +33 -16
  47. package/server/index.js +1032 -98
  48. package/server/start.js +49 -0
  49. package/src/ConnectionManager.js +239 -225
  50. package/src/CryptoManager.js +147 -18
  51. package/src/DebugLogger.js +0 -7
  52. package/src/DistributedStorageManager.js +245 -205
  53. package/src/EnvironmentDetector.js +109 -2
  54. package/src/EventEmitter.js +79 -1
  55. package/src/EvictionManager.js +10 -9
  56. package/src/GossipManager.js +163 -11
  57. package/src/LexicalStorageInterface.js +332 -0
  58. package/src/PeerConnection.js +333 -310
  59. package/src/PeerPigeonMesh.js +577 -135
  60. package/src/SignalingClient.js +14 -243
  61. package/src/SignalingHandler.js +31 -10
  62. package/src/StorageManager.js +0 -39
  63. package/src/WebDHT-Simple.js +389 -0
  64. package/src/WebDHT.js +363 -1165
  65. package/src/browser-entry.js +40 -0
  66. package/examples/browser/assets/images/favicon.png +0 -0
  67. package/examples/browser/assets/images/pigeon.png +0 -0
  68. package/examples/browser/crypto-test.html +0 -427
  69. package/examples/browser/ui-old.js +0 -1926
  70. package/examples/browser/ui.js +0 -3010
  71. package/websocket-server/README.md +0 -247
  72. package/websocket-server/server.js +0 -391
@@ -0,0 +1,35 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <title>PeerPigeon Bundle Test</title>
5
+ </head>
6
+ <body>
7
+ <h1>PeerPigeon Bundle Test</h1>
8
+ <div id="test-results"></div>
9
+
10
+ <script src="../../dist/peerpigeon-browser.js"></script>
11
+ <script>
12
+ function runTests() {
13
+ const results = document.getElementById('test-results');
14
+ let html = '';
15
+
16
+ // Test 1: PeerPigeon global object
17
+ html += `<p>PeerPigeon object available: ${typeof PeerPigeon !== 'undefined' ? '✅ YES' : '❌ NO'}</p>`;
18
+
19
+ // Test 2: PeerPigeonMesh class
20
+ if (typeof PeerPigeon !== 'undefined') {
21
+ html += `<p>PeerPigeonMesh class: ${typeof PeerPigeon.PeerPigeonMesh === 'function' ? '✅ YES' : '❌ NO'}</p>`;
22
+ html += `<p>Available exports: ${Object.keys(PeerPigeon).join(', ')}</p>`;
23
+ }
24
+
25
+ // Test 3: UnSEA crypto
26
+ html += `<p>UnSEA crypto available: ${typeof window.__PEERPIGEON_UNSEA__ !== 'undefined' ? '✅ YES' : '❌ NO'}</p>`;
27
+
28
+ results.innerHTML = html;
29
+ }
30
+
31
+ // Run tests when page loads
32
+ window.addEventListener('load', runTests);
33
+ </script>
34
+ </body>
35
+ </html>
@@ -0,0 +1,30 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>PeerPigeon Vue 3 - Complete Feature Demo</title>
7
+ <link rel="icon" type="image/png" href="../browser/assets/images/favicon.png">
8
+ <style>
9
+ * {
10
+ margin: 0;
11
+ padding: 0;
12
+ box-sizing: border-box;
13
+ }
14
+
15
+ body {
16
+ font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
17
+ background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
18
+ min-height: 100vh;
19
+ }
20
+
21
+ #app {
22
+ min-height: 100vh;
23
+ }
24
+ </style>
25
+ </head>
26
+ <body>
27
+ <div id="app"></div>
28
+ <script type="module" src="/src/main.js"></script>
29
+ </body>
30
+ </html>
@@ -0,0 +1,21 @@
1
+ {
2
+ "name": "peerpigeon-vue-example",
3
+ "version": "1.0.0",
4
+ "description": "Comprehensive Vue 3 example showcasing all PeerPigeon features",
5
+ "type": "module",
6
+ "scripts": {
7
+ "dev": "vite",
8
+ "build": "vite build",
9
+ "preview": "vite preview"
10
+ },
11
+ "dependencies": {
12
+ "vue": "^3.4.0",
13
+ "@vueuse/core": "^10.9.0",
14
+ "vue-router": "^4.3.0",
15
+ "pinia": "^2.1.7"
16
+ },
17
+ "devDependencies": {
18
+ "@vitejs/plugin-vue": "^5.0.0",
19
+ "vite": "^5.2.0"
20
+ }
21
+ }
@@ -0,0 +1,21 @@
1
+ <template>
2
+ <div id="app">
3
+ <h1>PeerPigeon Vue 3 Test</h1>
4
+ <p>If you can see this, Vue is working!</p>
5
+ <button @click="counter++">Count: {{ counter }}</button>
6
+ </div>
7
+ </template>
8
+
9
+ <script setup>
10
+ import { ref } from 'vue'
11
+
12
+ const counter = ref(0)
13
+ </script>
14
+
15
+ <style>
16
+ #app {
17
+ font-family: Avenir, Helvetica, Arial, sans-serif;
18
+ text-align: center;
19
+ margin-top: 60px;
20
+ }
21
+ </style>
@@ -0,0 +1,420 @@
1
+ <template>
2
+ <div id="app">
3
+ <!-- Navigation Header -->
4
+ <header class="header">
5
+ <div class="container">
6
+ <div class="header-content">
7
+ <div class="logo">
8
+ <img src="../browser/assets/images/favicon.png" alt="PeerPigeon" class="logo-img">
9
+ <h1>PeerPigeon Vue 3 Demo</h1>
10
+ </div>
11
+
12
+ <div class="status-bar">
13
+ <div class="status-item" :class="{ connected: isConnected, disconnected: !isConnected }">
14
+ <span class="status-dot"></span>
15
+ {{ isConnected ? 'Connected' : 'Disconnected' }}
16
+ </div>
17
+ <div class="status-item" v-if="networkName">
18
+ <strong>Network:</strong>
19
+ <span class="network-display">{{ networkName }}</span>
20
+ <span v-if="store.isInFallbackMode" class="fallback-indicator">Fallback</span>
21
+ </div>
22
+ <div class="status-item" v-if="peerId">
23
+ <strong>ID:</strong> {{ peerId.substring(0, 8) }}...
24
+ </div>
25
+ <div class="status-item">
26
+ <strong>Peers:</strong> {{ networkStatus.connectedCount }}/{{ networkStatus.maxPeers }}
27
+ </div>
28
+ </div>
29
+
30
+ <div class="connection-controls">
31
+ <div class="input-group">
32
+ <label for="network-input">Network:</label>
33
+ <input
34
+ id="network-input"
35
+ v-model="networkName"
36
+ placeholder="global"
37
+ class="network-input"
38
+ :disabled="isConnected"
39
+ title="Network name (e.g., 'gaming', 'work', 'family')"
40
+ >
41
+ </div>
42
+ <div class="input-group">
43
+ <label for="url-input">Signaling Server:</label>
44
+ <input
45
+ id="url-input"
46
+ v-model="signalingUrl"
47
+ placeholder="ws://localhost:3000"
48
+ class="url-input"
49
+ :disabled="isConnected"
50
+ >
51
+ </div>
52
+ <button
53
+ v-if="!isConnected"
54
+ @click="handleConnect"
55
+ :disabled="!isInitialized"
56
+ class="btn btn-primary"
57
+ >
58
+ {{ isInitialized ? 'Connect' : 'Initializing...' }}
59
+ </button>
60
+ <button
61
+ v-else
62
+ @click="handleDisconnect"
63
+ class="btn btn-secondary"
64
+ >
65
+ Disconnect
66
+ </button>
67
+ </div>
68
+ </div>
69
+ </div>
70
+ </header>
71
+
72
+ <!-- Navigation Tabs -->
73
+ <nav class="nav-tabs">
74
+ <div class="container">
75
+ <div class="tabs">
76
+ <router-link to="/network" class="tab">
77
+ <span class="tab-icon">🌐</span>
78
+ Network
79
+ </router-link>
80
+ <router-link to="/messaging" class="tab">
81
+ <span class="tab-icon">💬</span>
82
+ Messaging
83
+ </router-link>
84
+ <router-link to="/media" class="tab">
85
+ <span class="tab-icon">🎥</span>
86
+ Media
87
+ </router-link>
88
+ <router-link to="/dht" class="tab">
89
+ <span class="tab-icon">🗄️</span>
90
+ DHT
91
+ </router-link>
92
+ <router-link to="/storage" class="tab">
93
+ <span class="tab-icon">📦</span>
94
+ Storage
95
+ </router-link>
96
+ <router-link to="/crypto" class="tab">
97
+ <span class="tab-icon">🔐</span>
98
+ Crypto
99
+ </router-link>
100
+ <router-link to="/debug" class="tab">
101
+ <span class="tab-icon">🐛</span>
102
+ Debug
103
+ </router-link>
104
+ </div>
105
+ </div>
106
+ </nav>
107
+
108
+ <!-- Main Content -->
109
+ <main class="main-content">
110
+ <div class="container">
111
+ <router-view />
112
+ </div>
113
+ </main>
114
+
115
+ <!-- Global Notifications/Toasts would go here -->
116
+ </div>
117
+ </template>
118
+
119
+ <script setup>
120
+ import { onMounted, computed } from 'vue';
121
+ import { usePeerPigeonStore } from './stores/peerpigeon.js';
122
+
123
+ const store = usePeerPigeonStore();
124
+
125
+ // Computed properties
126
+ const isInitialized = computed(() => store.isInitialized);
127
+ const isConnected = computed(() => store.isConnected);
128
+ const signalingUrl = computed({
129
+ get: () => store.signalingUrl,
130
+ set: (value) => store.signalingUrl = value
131
+ });
132
+ const networkName = computed({
133
+ get: () => store.networkName,
134
+ set: (value) => store.setNetworkName(value)
135
+ });
136
+ const peerId = computed(() => store.peerId);
137
+ const networkStatus = computed(() => store.networkStatus);
138
+
139
+ // Methods
140
+ const handleConnect = async () => {
141
+ try {
142
+ // Set network name before connecting
143
+ if (networkName.value && networkName.value.trim()) {
144
+ store.setNetworkName(networkName.value.trim());
145
+ }
146
+ await store.connectToSignaling(signalingUrl.value);
147
+ } catch (error) {
148
+ console.error('Connection failed:', error);
149
+ alert(`Connection failed: ${error.message}`);
150
+ }
151
+ };
152
+
153
+ const handleDisconnect = () => {
154
+ store.disconnect();
155
+ };
156
+
157
+ // Initialize on mount
158
+ onMounted(async () => {
159
+ try {
160
+ // Initialize with initial network name if provided
161
+ const initialOptions = {};
162
+ if (networkName.value && networkName.value.trim()) {
163
+ initialOptions.networkName = networkName.value.trim();
164
+ }
165
+ await store.initMesh(initialOptions);
166
+ } catch (error) {
167
+ console.error('Failed to initialize mesh:', error);
168
+ alert(`Failed to initialize mesh: ${error.message}`);
169
+ }
170
+ });
171
+ </script>
172
+
173
+ <style scoped>
174
+ .header {
175
+ background: rgba(255, 255, 255, 0.95);
176
+ backdrop-filter: blur(10px);
177
+ border-bottom: 1px solid rgba(255, 255, 255, 0.2);
178
+ position: sticky;
179
+ top: 0;
180
+ z-index: 100;
181
+ }
182
+
183
+ .container {
184
+ max-width: 1200px;
185
+ margin: 0 auto;
186
+ padding: 0 20px;
187
+ }
188
+
189
+ .header-content {
190
+ display: flex;
191
+ align-items: center;
192
+ justify-content: space-between;
193
+ padding: 15px 0;
194
+ flex-wrap: wrap;
195
+ gap: 20px;
196
+ }
197
+
198
+ .logo {
199
+ display: flex;
200
+ align-items: center;
201
+ gap: 12px;
202
+ }
203
+
204
+ .logo-img {
205
+ width: 32px;
206
+ height: 32px;
207
+ }
208
+
209
+ .logo h1 {
210
+ font-size: 24px;
211
+ font-weight: 600;
212
+ color: #333;
213
+ margin: 0;
214
+ }
215
+
216
+ .status-bar {
217
+ display: flex;
218
+ gap: 20px;
219
+ align-items: center;
220
+ flex-wrap: wrap;
221
+ }
222
+
223
+ .status-item {
224
+ display: flex;
225
+ align-items: center;
226
+ gap: 8px;
227
+ font-size: 14px;
228
+ color: #666;
229
+ }
230
+
231
+ .status-item.connected {
232
+ color: #22c55e;
233
+ }
234
+
235
+ .status-item.disconnected {
236
+ color: #ef4444;
237
+ }
238
+
239
+ .status-dot {
240
+ width: 8px;
241
+ height: 8px;
242
+ border-radius: 50%;
243
+ background: currentColor;
244
+ }
245
+
246
+ .connection-controls {
247
+ display: flex;
248
+ gap: 15px;
249
+ align-items: end;
250
+ flex-wrap: wrap;
251
+ }
252
+
253
+ .input-group {
254
+ display: flex;
255
+ flex-direction: column;
256
+ gap: 4px;
257
+ }
258
+
259
+ .input-group label {
260
+ font-size: 12px;
261
+ font-weight: 500;
262
+ color: #666;
263
+ margin: 0;
264
+ }
265
+
266
+ .network-input,
267
+ .url-input {
268
+ padding: 8px 12px;
269
+ border: 1px solid #ddd;
270
+ border-radius: 6px;
271
+ font-size: 14px;
272
+ min-width: 150px;
273
+ }
274
+
275
+ .network-input {
276
+ min-width: 120px;
277
+ }
278
+
279
+ .url-input {
280
+ min-width: 200px;
281
+ }
282
+
283
+ .network-input:disabled,
284
+ .url-input:disabled {
285
+ background: #f5f5f5;
286
+ color: #999;
287
+ }
288
+
289
+ .network-display {
290
+ color: #3b82f6;
291
+ font-weight: 600;
292
+ }
293
+
294
+ .fallback-indicator {
295
+ background: #f59e0b;
296
+ color: white;
297
+ padding: 2px 6px;
298
+ border-radius: 3px;
299
+ font-size: 11px;
300
+ font-weight: 600;
301
+ margin-left: 6px;
302
+ }
303
+
304
+ .btn {
305
+ padding: 8px 16px;
306
+ border: none;
307
+ border-radius: 6px;
308
+ font-size: 14px;
309
+ font-weight: 500;
310
+ cursor: pointer;
311
+ transition: all 0.2s;
312
+ }
313
+
314
+ .btn:disabled {
315
+ opacity: 0.6;
316
+ cursor: not-allowed;
317
+ }
318
+
319
+ .btn-primary {
320
+ background: #3b82f6;
321
+ color: white;
322
+ }
323
+
324
+ .btn-primary:hover:not(:disabled) {
325
+ background: #2563eb;
326
+ }
327
+
328
+ .btn-secondary {
329
+ background: #6b7280;
330
+ color: white;
331
+ }
332
+
333
+ .btn-secondary:hover:not(:disabled) {
334
+ background: #4b5563;
335
+ }
336
+
337
+ .nav-tabs {
338
+ background: rgba(255, 255, 255, 0.9);
339
+ backdrop-filter: blur(10px);
340
+ border-bottom: 1px solid rgba(255, 255, 255, 0.2);
341
+ }
342
+
343
+ .tabs {
344
+ display: flex;
345
+ gap: 2px;
346
+ overflow-x: auto;
347
+ padding: 10px 0;
348
+ }
349
+
350
+ .tab {
351
+ display: flex;
352
+ align-items: center;
353
+ gap: 8px;
354
+ padding: 12px 20px;
355
+ text-decoration: none;
356
+ color: #666;
357
+ border-radius: 8px;
358
+ transition: all 0.2s;
359
+ white-space: nowrap;
360
+ font-weight: 500;
361
+ }
362
+
363
+ .tab:hover {
364
+ background: rgba(59, 130, 246, 0.1);
365
+ color: #3b82f6;
366
+ }
367
+
368
+ .tab.router-link-active {
369
+ background: #3b82f6;
370
+ color: white;
371
+ }
372
+
373
+ .tab-icon {
374
+ font-size: 16px;
375
+ }
376
+
377
+ .main-content {
378
+ padding: 30px 0;
379
+ min-height: calc(100vh - 200px);
380
+ }
381
+
382
+ /* Responsive design */
383
+ @media (max-width: 768px) {
384
+ .header-content {
385
+ flex-direction: column;
386
+ align-items: stretch;
387
+ gap: 15px;
388
+ }
389
+
390
+ .logo {
391
+ justify-content: center;
392
+ }
393
+
394
+ .status-bar {
395
+ justify-content: center;
396
+ }
397
+
398
+ .connection-controls {
399
+ justify-content: center;
400
+ flex-direction: column;
401
+ align-items: center;
402
+ gap: 12px;
403
+ }
404
+
405
+ .input-group {
406
+ width: 100%;
407
+ max-width: 250px;
408
+ }
409
+
410
+ .network-input,
411
+ .url-input {
412
+ width: 100%;
413
+ min-width: auto;
414
+ }
415
+
416
+ .tabs {
417
+ justify-content: center;
418
+ }
419
+ }
420
+ </style>