universe-code 0.0.83 → 0.0.85

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,8 @@
-// IndexedDB exports
+/* parent file */
 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,186 @@
+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",
+      "auth",
+    ];
+
+    required.forEach((key) => {
+      if (config[key] === undefined) {
+        throw new Error(`Missing required WebSocket config: ${key}`);
+      }
+    });
+
+    if (!config.auth || config.auth.token === undefined) {
+      throw new Error("Missing required WebSocket auth.token");
+    }
+
+    this.config = config;
+
+    this.createSocket();
+  }
+
+  /** 🔑 Token update */
+  setToken(token) {
+    if (!this.config) throw new Error("WebSocket not initialized");
+
+    if (!this.config.auth) this.config.auth = {};
+
+    this.config.auth.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,
+
+      // ⬇️ token now from auth object
+      auth:
+        this.config.auth?.token
+          ? { token: this.config.auth.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.auth?.token) {
+      throw new Error("Token missing in auth.token: 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.83",
+  "version": "0.0.85",
   "description": "Universal utility functions for all JS frameworks",
   "license": "ISC",
   "type": "module",