universe-code 0.0.82 → 0.0.84

package/dist/index.d.ts

@@ -3,4 +3,5 @@ declare module 'universe-code/core';
 declare module 'universe-code/indexdb';
 declare module 'universe-code/react';
 declare module 'universe-code/angular';
-declare module 'universe-code/uiux';
+declare module 'universe-code/uiux';
+declare module 'universe-code/socket';

package/dist/index.js

@@ -1,10 +1,7 @@
-// IndexedDB exports
 const indexdb = require("./indexdb");
-
-// (Socket will be added later)
-// const socket = require("./socket");
+const socket = require("./socket");
 
 module.exports = {
-  ...indexdb
-  // ...socket
-};
+  ...indexdb,
+  ...socket
+};

package/dist/socket/index.js

@@ -0,0 +1,174 @@
+import { io } from "socket.io-client";
+
+export class WebSocketService {
+    static _instance;
+
+    socket = null;
+    config = null;
+    coreListenersBound = false;
+    lastPayloads = null;
+    lastSubscribeKey = "";
+    pendingListeners = [];
+
+    constructor() { }
+
+    static get instance() {
+        if (!WebSocketService._instance) {
+            WebSocketService._instance = new WebSocketService();
+        }
+        return WebSocketService._instance;
+    }
+
+    /** 🚨 REQUIRED strict config */
+    init(config) {
+        const required = [
+            "baseUrl",
+            "path",
+            "transports",
+            "autoConnect",
+            "reconnection",
+            "reconnectionAttempts",
+            "reconnectionDelay",
+            "token",
+        ];
+
+        required.forEach((key) => {
+            if (config[key] === undefined) {
+                throw new Error(`Missing required WebSocket config: ${key}`);
+            }
+        });
+
+        this.config = config;
+
+        this.createSocket();
+    }
+
+    /** 🔑 Token update */
+    setToken(token) {
+        if (!this.config) throw new Error("WebSocket not initialized");
+
+        this.config.token = token;
+
+        if (!token) this.disconnect();
+        else this.connect();
+    }
+
+    /** 🚀 Create */
+    createSocket() {
+        if (this.socket) return;
+
+        if (!this.config) throw new Error("WebSocket config not initialized");
+
+        this.socket = io(this.config.baseUrl, {
+            path: this.config.path,
+            transports: this.config.transports,
+            autoConnect: this.config.autoConnect,
+            reconnection: this.config.reconnection,
+            reconnectionAttempts: this.config.reconnectionAttempts,
+            reconnectionDelay: this.config.reconnectionDelay,
+            extraHeaders: this.config.token
+                ? { Authorization: `Bearer ${this.config.token}` }
+                : undefined,
+        });
+
+        this.bindCoreListeners();
+
+        if (this.config.autoConnect) {
+            this.connect();
+        }
+    }
+
+    /** 🔌 Connect */
+    connect() {
+        if (!this.config) throw new Error("WebSocket config not initialized");
+        if (!this.config.token) throw new Error("Token missing: cannot connect WebSocket");
+
+        if (!this.socket) this.createSocket();
+
+        if (this.socket && !this.socket.connected) {
+            this.socket.connect();
+        }
+    }
+
+    /** ❌ Disconnect */
+    disconnect() {
+        if (!this.socket) return;
+
+        this.socket.removeAllListeners();
+        this.socket.disconnect();
+
+        this.socket = null;
+        this.coreListenersBound = false;
+        this.lastPayloads = null;
+        this.lastSubscribeKey = "";
+    }
+
+    /** 🧠 internal */
+    bindCoreListeners() {
+        if (!this.socket || this.coreListenersBound) return;
+
+        this.coreListenersBound = true;
+
+        this.socket.on("connect", () => {
+            this.resubscribeIfNeeded();
+
+            if (this.pendingListeners.length) {
+                this.pendingListeners.forEach(({ event, handler }) => {
+                    this.socket.on(event, handler);
+                });
+                this.pendingListeners = [];
+            }
+        });
+    }
+
+    resubscribeIfNeeded() {
+        if (this.lastPayloads && this.socket) {
+            this.socket.emit("subscribeMarket", this.lastPayloads);
+        }
+    }
+
+    /** 📩 Subscribe */
+    subscribeMarket(payload) {
+        if (!this.socket) throw new Error("Socket not initialized");
+
+        const key = JSON.stringify(payload);
+        if (key === this.lastSubscribeKey) return;
+
+        this.lastSubscribeKey = key;
+        this.lastPayloads = payload;
+
+        if (!this.socket.connected) {
+            this.connect();
+            return;
+        }
+
+        this.socket.emit("subscribeMarket", payload);
+    }
+
+    /** 🗑️ Unsubscribe */
+    unsubscribeMarket(payload) {
+        if (!this.socket) throw new Error("Socket not initialized");
+
+        const key = JSON.stringify(payload);
+        if (key !== this.lastSubscribeKey) return;
+
+        this.lastSubscribeKey = "";
+        this.socket.emit("unsubscribeMarket", payload);
+    }
+
+    /** 👂 Listen */
+    onEvent(eventName, handler) {
+        if (!this.socket) throw new Error("Socket not initialized");
+
+        const wrapped = (data) => handler(data);
+        this.socket.on(eventName, wrapped);
+
+        return () => this.socket.off(eventName, wrapped);
+    }
+
+    /** 📤 Emit */
+    sendMessage(event, data) {
+        if (!this.socket) throw new Error("Socket not initialized");
+        this.socket.emit(event, data);
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universe-code",
-  "version": "0.0.82",
+  "version": "0.0.84",
   "description": "Universal utility functions for all JS frameworks",
   "license": "ISC",
   "type": "module",
@@ -54,7 +54,8 @@
   "dependencies": {
     "@angular/common": "^21.0.6",
     "@angular/core": "^21.0.6",
-    "react": "^19.2.3"
+    "react": "^19.2.3",
+    "socket.io-client": "^4.8.3"
   },
   "keywords": [
     "universe-code",