@bangstack/sdk-js

JavaScript SDK for connecting to Mesh server with bidirectional event bridging.

Installation

npm install @bangstack/sdk-js

Quick Start

import { createMesh } from '@bangstack/core';
import { bridgeToServer } from '@bangstack/sdk-js';

const mesh = createMesh({ name: 'my-app' });

// Connect to mesh server with bidirectional event flow
const bridge = bridgeToServer(mesh, 'ws://localhost:4000/ws', {
  bidirectional: true,    // Receive server events
  subscriptions: ['*'],   // Subscribe to all events
});

await bridge.start();

// Local events are forwarded to server
mesh.emit('user:action:completed', { userId: '123' });

// Server events flow back to local mesh
mesh.subscribe('other-app:*', (event) => {
  console.log('Event from another app:', event);
});

// Control the bridge
bridge.pause();   // Stop forwarding
bridge.resume();  // Resume forwarding
bridge.stop();    // Disconnect

Features

• Bidirectional bridging: Send and receive events to/from server
• Pattern subscriptions: Subscribe to specific event patterns
• Auto-reconnect: Handles connection failures gracefully
• Event buffering: Buffers events when disconnected

Browser Usage

// Works in browsers with native WebSocket
import { bridgeToServer } from '@bangstack/sdk-js';

const bridge = bridgeToServer(mesh, 'ws://localhost:4000/ws');
await bridge.start();

License

MIT