stelar-time-real 1.1.0 → 1.2.1

package/README.md

@@ -15,6 +15,7 @@ Tu propio sistema de tiempo real personalizado. Una librería ligera y sin depen
 - 💓 **Heartbeat incluido** - Detecta desconexiones automáticamente
 - 🌐 **Namespaces** - Múltiples canales independientes (`/chat`, `/game`, etc.)
 - ⚡ **ACK ultra rápido** - Request-response con Promesas, sin overhead
+- 📦 **Binarios** - Envía imágenes, archivos, audio, video sin overhead de base64
 
 ## Instalación
 
@@ -500,6 +501,49 @@ client.on('reconnecting', (attempt) => console.log(`Reintentando ${attempt}/5`))
 client.connect();
 ```
 
+### Enviar Archivos Binarios
+
+```javascript
+// Servidor - recibir imagen
+stelar.on('image', (ctx) => {
+  // ctx.buffer es un Uint8Array
+  console.log('Recibido:', ctx.buffer.byteLength, 'bytes');
+  // Guardar o procesar la imagen
+  saveImage(ctx.buffer);
+
+  // Responder al cliente
+  ctx.emit('imageSaved', { success: true });
+});
+
+// Cliente - enviar imagen
+const input = document.querySelector('input[type="file"]');
+input.addEventListener('change', async (e) => {
+  const file = e.target.files[0];
+  const buffer = await file.arrayBuffer();
+  client.emitBinary('image', buffer);
+});
+
+// Cliente - recibir imagen
+client.on('image', (buffer) => {
+  const blob = new Blob([buffer], { type: 'image/png' });
+  const url = URL.createObjectURL(blob);
+  document.getElementById('img').src = url;
+});
+```
+
+### Broadcast de Binarios
+
+```javascript
+// Servidor - compartir archivo con todos
+stelar.on('upload', (ctx) => {
+  ctx.broadcastBinary('file', ctx.buffer);
+});
+
+// Cliente - enviar archivo
+const fileData = await file.arrayBuffer();
+client.emitBinary('upload', fileData);
+```
+
 ---
 
 ## Diferencia con Socket.io
@@ -514,6 +558,12 @@ client.connect();
 
 ## Changelog
 
+### v1.2.0
+- Soporte binarios: envía imágenes, archivos, audio, video sin base64
+- `ctx.emitBinary('event', buffer)` y `client.emitBinary('event', buffer)`
+- `client.sendFile(file)` y `client.sendImage(blob)`
+- Eficiente: usa WebSocket binary diretamente, sin overhead
+
 ### v1.1.0
 - Namespaces: `StelarServer.of('/chat')` para múltiples canales
 - ACK personalizado: `ctx.ack('nombre', data)` y `client.request(event, data, 'ackName')`

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "stelar-time-real",
-  "version": "1.1.0",
-  "description": "Tu propio sistema de tiempo real personalizado - WebSocket ligero sin dependencias",
+  "version": "1.2.1",
+  "description": "WebSocket liviano y rápido sin dependecias. Alternativa a socket.io, namespaces, ACKs y archivos binarios.",
   "main": "src/index.js",
   "type": "module",
   "keywords": [

package/src/client.js

@@ -58,6 +58,27 @@ class StelarClient {
     return this;
   }
 
+  emitBinary(event, data) {
+    if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+      const header = JSON.stringify({ event });
+      const headerBytes = new TextEncoder().encode(header);
+      const combined = new Uint8Array(headerBytes.length + 1 + data.byteLength);
+      combined.set(headerBytes, 0);
+      combined[headerBytes.length] = 0;
+      combined.set(new Uint8Array(data), headerBytes.length + 1);
+      this.ws.send(combined);
+    }
+    return this;
+  }
+
+  sendFile(file) {
+    return this.emitBinary('file', file);
+  }
+
+  sendImage(blob) {
+    return this.emitBinary('image', blob);
+  }
+
   request(event, data, ackName) {
     return new Promise((resolve, reject) => {
       const timeout = setTimeout(() => {
@@ -143,8 +164,34 @@ class StelarClient {
       this._startHeartbeat();
     };
 
+    this.ws.binaryType = 'arraybuffer';
+
     this.ws.onmessage = (e) => {
       try {
+        if (e.data instanceof ArrayBuffer) {
+          const view = new Uint8Array(e.data);
+          let headerEnd = -1;
+          for (let i = 0; i < view.length; i++) {
+            if (view[i] === 0) {
+              headerEnd = i;
+              break;
+            }
+          }
+          if (headerEnd === -1) return;
+
+          const headerStr = new TextDecoder().decode(view.slice(0, headerEnd));
+          const header = JSON.parse(headerStr);
+          const buffer = view.slice(headerEnd + 1);
+
+          if (this.events[header.event]) {
+            this.events[header.event](buffer);
+          }
+          if (this._wildcardHandler) {
+            this._wildcardHandler({ event: header.event, data: buffer, buffer, isBinary: true });
+          }
+          return;
+        }
+
         const msg = JSON.parse(e.data);
         const { event, data, _isAck } = msg;
 

package/src/index.js

@@ -57,6 +57,20 @@ class StelarServer {
     return this;
   }
 
+  broadcastBinary(event, buffer) {
+    const header = JSON.stringify({ event, _binary: true });
+    const headerBytes = new TextEncoder().encode(header);
+    const combined = new Uint8Array(headerBytes.length + 1 + buffer.byteLength);
+    combined.set(headerBytes, 0);
+    combined[headerBytes.length] = 0;
+    combined.set(new Uint8Array(buffer), headerBytes.length + 1);
+
+    this.clients.forEach((info, client) => {
+      client.send(combined);
+    });
+    return this;
+  }
+
   to(room, event, data) {
     this.clients.forEach((info, client) => {
       if (info.room === room) {
@@ -131,7 +145,9 @@ class StelarServer {
       req,
       emit: (evt, d) => client.send(JSON.stringify({ event: evt, data: d })),
       send: (respId, d) => client.send(JSON.stringify({ event: respId, data: d, _isAck: true })),
+      emitBinary: (evt, buffer) => client.send(buffer),
       broadcast: (evt, d) => this.broadcast(evt, d),
+      broadcastBinary: (evt, buffer) => this.broadcastBinary(evt, buffer),
       to: (room, evt, d) => this.to(room, evt, d),
       toId: (id, evt, d) => this.toId(id, evt, d),
       getClients: (room) => this.getClients(room),
@@ -159,7 +175,35 @@ class StelarServer {
       }
     });
 
-    client.on('message', (raw) => {
+    client.on('message', (raw, isBinary) => {
+      if (isBinary) {
+        try {
+          const view = new Uint8Array(raw);
+          let headerEnd = -1;
+          for (let i = 0; i < view.length; i++) {
+            if (view[i] === 0) {
+              headerEnd = i;
+              break;
+            }
+          }
+          if (headerEnd === -1) return;
+
+          const headerStr = new TextDecoder().decode(view.slice(0, headerEnd));
+          const header = JSON.parse(headerStr);
+          const data = view.slice(headerEnd + 1);
+
+          const eventCtx = { ...ctx, data, buffer: data, isBinary: true };
+
+          if (this.events[header.event]) {
+            this.events[header.event](eventCtx);
+          }
+          if (this._wildcardHandler) {
+            this._wildcardHandler({ event: header.event, data: eventCtx });
+          }
+        } catch (e) {}
+        return;
+      }
+
       try {
         const msg = JSON.parse(raw);
         const { event, data } = msg;