reachlo 1.0.0

package/README.md

@@ -0,0 +1,52 @@
+# Reachlo SDK
+
+**Real-time infrastructure for AI streaming.**
+
+Reachlo is a lightweight, WebSocket-based real-time messaging layer designed for AI agents and modern web applications. It simplifies the complexity of real-time communication into a few lines of code.
+
+## Installation
+
+```bash
+npm install reachlo
+```
+
+## Quick Start
+
+### 1. Connect
+
+Initialize the client with your API key.
+
+```javascript
+import Reachlo from 'reachlo';
+
+const client = new Reachlo('YOUR_API_KEY');
+
+await client.connect();
+```
+
+### 2. Subscribe & Publish
+
+Subscribe to channels to receive updates, and publish messages to them instantly.
+
+```javascript
+const chat = client.channel('chat-room-1');
+
+// Listen for incoming messages
+chat.subscribe((msg) => {
+  console.log('New message:', msg);
+});
+
+// Send a message
+chat.publish({ text: 'Hello world!', sender: 'User' });
+```
+
+## Why Reachlo?
+
+- **Zero Config**: No complex server setup required.
+- **WebSocket Native**: Built on top of `uWebSockets.js` for extreme performance.
+- **Channel Routing**: Automatically routes messages to the correct channel listeners.
+- **Authentication**: Simple API key-based auth handled transparently.
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,75 @@
+// index.js
+class Reachlo {
+    constructor(apiKey, options = {}) {
+        this.apiKey = apiKey;
+        // Default to production URL if none provided
+        this.url = options.url || 'wss://your-app.fly.dev';
+        this.socket = null;
+        this.channels = new Map();
+    }
+
+    connect() {
+        return new Promise((resolve, reject) => {
+            const urlWithAuth = `${this.url}?api_key=${this.apiKey}`;
+            this.socket = new WebSocket(urlWithAuth);
+
+            this.socket.onopen = () => {
+                console.log("Reachlo: Connected");
+                resolve();
+            };
+
+            this.socket.onerror = (err) => reject(err);
+
+            this.socket.onmessage = (event) => {
+                try {
+                    const payload = JSON.parse(event.data);
+                    // Routes data to the specific channel instance
+                    if (payload.channel && this.channels.has(payload.channel)) {
+                        this.channels.get(payload.channel)._emit(payload.data);
+                    }
+                } catch (e) {
+                    console.error("Reachlo: Message parse error", e);
+                }
+            };
+        });
+    }
+
+    channel(channelName) {
+        if (!this.channels.has(channelName)) {
+            const channel = new ReachloChannel(channelName, this);
+            this.channels.set(channelName, channel);
+            this._send({ type: 'subscribe', channel: channelName });
+            return channel;
+        }
+        return this.channels.get(channelName);
+    }
+
+    _send(payload) {
+        if (this.socket && this.socket.readyState === WebSocket.OPEN) {
+            this.socket.send(JSON.stringify(payload));
+        }
+    }
+}
+
+class ReachloChannel {
+    constructor(name, client) {
+        this.name = name;
+        this.client = client;
+        this.callbacks = new Set();
+    }
+
+    subscribe(cb) {
+        this.callbacks.add(cb);
+    }
+
+    publish(data) {
+        this.client._send({ type: 'publish', channel: this.name, data });
+    }
+
+    _emit(data) {
+        // Sends the raw data to all registered listeners for this channel
+        this.callbacks.forEach(cb => cb(data));
+    }
+}
+
+export default Reachlo;

package/package.json

@@ -0,0 +1,13 @@
+{
+    "name": "reachlo",
+    "version": "1.0.0",
+    "description": "Real-time infrastructure for AI streaming.",
+    "main": "index.js",
+    "type": "module",
+    "author": "Your Name",
+    "license": "MIT",
+    "scripts": {
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "keywords": []
+}