teckos-client 0.2.3 → 0.3.0

package/dist/index.js

@@ -1,8 +1,459 @@
+(function (global, factory) {
+typeof exports === 'object' && typeof module !== 'undefined' ? factory(exports) :
+typeof define === 'function' && define.amd ? define(['exports'], factory) :
+(global = typeof globalThis !== 'undefined' ? globalThis : global || self, factory(global["Teckos Client"] = {}));
+})(this, (function (exports) { 'use strict';
 
-'use strict'
+module.exports = require('ws');
 
-if (process.env.NODE_ENV === 'production') {
-  module.exports = require('./teckos-client.cjs.production.min.js')
-} else {
-  module.exports = require('./teckos-client.cjs.development.js')
+const enc = new TextEncoder();
+const dec = new TextDecoder();
+
+const encodePacket = packet => enc.encode(JSON.stringify(packet));
+
+const decodePacket = buffer => JSON.parse(dec.decode(buffer).toString());
+
+class SocketEventEmitter {
+  maxListeners = 50;
+  handlers = {};
+  addListener = (event, listener) => {
+    if (Object.keys(this.handlers).length === this.maxListeners) {
+      throw new Error('Max listeners reached');
+    }
+
+    if (typeof listener !== 'function') {
+      throw new Error('The given listener is not a function');
+    }
+
+    this.handlers[event] = this.handlers[event] || [];
+    this.handlers[event].push(listener);
+    return this;
+  };
+  once = (event, listener) => {
+    if (Object.keys(this.handlers).length === this.maxListeners) {
+      throw new Error('Max listeners reached');
+    }
+
+    if (typeof listener !== 'function') {
+      throw new Error('The given listener is not a function');
+    }
+
+    this.handlers[event] = this.handlers[event] || [];
+
+    const onceWrapper = () => {
+      listener();
+      this.off(event, onceWrapper);
+    };
+
+    this.handlers[event].push(onceWrapper);
+    return this;
+  };
+  removeListener = (event, listener) => {
+    if (this.handlers[event]) {
+      this.handlers[event] = this.handlers[event].filter(handler => handler !== listener);
+    }
+
+    return this;
+  };
+  off = (event, listener) => this.removeListener(event, listener);
+  removeAllListeners = event => {
+    if (event) {
+      delete this.handlers[event];
+    } else {
+      this.handlers = {};
+    }
+
+    return this;
+  };
+  setMaxListeners = n => {
+    this.maxListeners = n;
+    return this;
+  };
+  getMaxListeners = () => this.maxListeners;
+  listeners = event => {
+    if (this.handlers[event]) {
+      return [...this.handlers[event]];
+    }
+
+    return [];
+  };
+  rawListeners = event => [...this.handlers[event]];
+  listenerCount = event => {
+    if (this.handlers[event]) {
+      return Object.keys(this.handlers[event]).length;
+    }
+
+    return 0;
+  };
+  prependListener = (event, listener) => {
+    if (Object.keys(this.handlers).length === this.maxListeners) {
+      throw new Error('Max listeners reached');
+    }
+
+    this.handlers[event] = this.handlers[event] || [];
+    this.handlers[event].unshift(listener);
+    return this;
+  };
+  prependOnceListener = (event, listener) => {
+    if (Object.keys(this.handlers).length === this.maxListeners) {
+      throw new Error('Max listeners reached');
+    }
+
+    this.handlers[event] = this.handlers[event] || [];
+
+    const onceWrapper = () => {
+      listener();
+      this.off(event, onceWrapper);
+    };
+
+    this.handlers[event].unshift(onceWrapper);
+    return this;
+  };
+  eventNames = () => Object.keys(this.handlers);
+  on = (event, listener) => this.addListener(event, listener);
+  emit = (event, ...args) => {
+    const listeners = this.listeners(event);
+
+    if (listeners.length > 0) {
+      listeners.forEach(listener => {
+        if (listener) listener(args);
+      });
+      return true;
+    }
+
+    return false;
+  };
 }
+
+exports.PacketType = void 0;
+
+(function (PacketType) {
+  PacketType[PacketType["EVENT"] = 0] = "EVENT";
+  PacketType[PacketType["ACK"] = 1] = "ACK";
+})(exports.PacketType || (exports.PacketType = {}));
+
+exports.ConnectionState = void 0;
+
+(function (ConnectionState) {
+  ConnectionState["DISCONNECTED"] = "disconnected";
+  ConnectionState["CONNECTING"] = "connecting";
+  ConnectionState["CONNECTED"] = "connected";
+  ConnectionState["DISCONNECTING"] = "disconnecting";
+})(exports.ConnectionState || (exports.ConnectionState = {}));
+
+const DEFAULT_OPTIONS = {
+  reconnection: true,
+  reconnectionDelay: 1000,
+  reconnectionDelayMax: 5000,
+  reconnectionAttempts: Infinity,
+  randomizationFactor: 0.5,
+  timeout: 5000,
+  debug: false
+};
+
+class TeckosClient extends SocketEventEmitter {
+  url;
+  options;
+  ws;
+  currentReconnectDelay;
+  currentReconnectionAttempts = 0;
+  acks = new Map();
+  fnId = 0;
+  connectionTimeout;
+  reconnectionTimeout;
+
+  constructor(url, options) {
+    super();
+    this.options = { ...DEFAULT_OPTIONS,
+      ...options
+    };
+    this.currentReconnectDelay = this.options.reconnectionDelay;
+    this.url = url;
+  }
+
+  attachHandler = () => {
+    if (this.ws) {
+      this.ws.onopen = this.handleOpen;
+      this.ws.onerror = this.handleError;
+      this.ws.onclose = this.handleClose;
+      this.ws.onmessage = this.handleMessage;
+    }
+  };
+
+  get webSocket() {
+    return this.ws;
+  }
+
+  connect = () => {
+    if (this.options.debug) console.log(`(teckos:client) Connecting to ${this.url}...`); // This will try to connect immediately
+    // eslint-disable-next-line new-cap
+
+    this.ws = new undefined(this.url); // Attach handlers
+
+    this.attachHandler(); // Handle timeout
+
+    this.connectionTimeout = setTimeout(() => {
+      if (this.ws && this.ws.readyState === 0
+      /* = CONNECTING */
+      ) {
+        this.ws.close();
+      }
+    }, this.options.timeout);
+  };
+  reconnect = () => {
+    this.listeners('reconnect_attempt').forEach(listener => listener());
+    this.connect();
+  };
+
+  getConnectionState() {
+    if (this.ws) {
+      switch (this.ws.readyState) {
+        case 0
+        /* = CONNECTING */
+        :
+          return exports.ConnectionState.CONNECTING;
+
+        case 1
+        /* = OPEN */
+        :
+          return exports.ConnectionState.CONNECTED;
+
+        case 2
+        /* = CLOSING */
+        :
+          return exports.ConnectionState.DISCONNECTING;
+
+        default:
+          /* 3 = CLOSED */
+          return exports.ConnectionState.DISCONNECTED;
+      }
+    }
+
+    return exports.ConnectionState.DISCONNECTED;
+  }
+
+  get state() {
+    return this.getConnectionState();
+  }
+
+  get connected() {
+    return this.getConnectionState() === exports.ConnectionState.CONNECTED;
+  }
+
+  get disconnected() {
+    return this.getConnectionState() === exports.ConnectionState.DISCONNECTED;
+  }
+
+  emit = (event, ...args) => {
+    args.unshift(event);
+    const packet = {
+      type: exports.PacketType.EVENT,
+      data: args
+    };
+
+    if (typeof args[args.length - 1] === 'function') {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+      this.acks.set(this.fnId, args.pop());
+      packet.id = this.fnId;
+      this.fnId += 1;
+    }
+
+    return this.sendPackage(packet);
+  };
+  send = (...args) => {
+    args.unshift('message');
+    return this.sendPackage({
+      type: exports.PacketType.EVENT,
+      data: args
+    });
+  };
+  sendPackage = packet => {
+    if (this.ws !== undefined && this.ws.readyState === 1
+    /* = OPEN */
+    ) {
+      const buffer = encodePacket(packet);
+      if (this.options.debug) console.log(`(teckos:client) [${this.url}] Send packet: ${JSON.stringify(packet)}`);
+      this.ws.send(buffer);
+      return true;
+    }
+
+    return false;
+  };
+  handleMessage = msg => {
+    const packet = typeof msg.data === 'string' ? JSON.parse(msg.data) : decodePacket(msg.data);
+    if (this.options.debug) console.log(`(teckos:client) [${this.url}] Got packet: ${JSON.stringify(packet)}`);
+
+    if (packet.type === exports.PacketType.EVENT) {
+      const event = packet.data[0];
+      const args = packet.data.slice(1);
+
+      if (event) {
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        this.listeners(event).forEach(listener => listener(...args));
+      } else {
+        throw new Error(`(teckos-client) [${this.url}] Got invalid event message: ${JSON.stringify(msg.data)}`);
+      }
+    } else if (packet.type === exports.PacketType.ACK && packet.id !== undefined) {
+      // Call assigned function
+      const ack = this.acks.get(packet.id);
+
+      if (typeof ack === 'function') {
+        ack.apply(this, packet.data);
+        this.acks.delete(packet.id);
+      }
+    } else {
+      throw new Error(`(teckos-client) [${this.url}] Got invalid message type: ${packet.type}`);
+    }
+  };
+  handleOpen = () => {
+    if (this.currentReconnectionAttempts > 0) {
+      // Reset reconnection settings to default
+      this.currentReconnectDelay = this.options.reconnectionDelay;
+      this.currentReconnectionAttempts = 0; // Inform listeners
+
+      if (this.options.debug) console.log(`(teckos:client) [${this.url}] Reconnected!`); // eslint-disable-next-line @typescript-eslint/no-unsafe-return
+
+      this.listeners('reconnect').forEach(listener => listener());
+    } // Inform listeners
+
+
+    if (this.options.debug) console.log(`(teckos:client) [${this.url}] Connected!`);
+    this.listeners('connect').forEach(listener => listener());
+  };
+  handleError = error => {
+    if (this.handlers && this.handlers.error) {
+      if (this.options.debug) console.log(`(teckos:client) [${this.url}] Got error from server: ${JSON.stringify(error)}`);
+      this.handlers.error.forEach(listener => listener(error));
+    }
+  };
+  handleClose = () => {
+    // Stop connection timeout
+    if (this.connectionTimeout) {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+      clearTimeout(this.connectionTimeout);
+    } // Stop reconnection timeout
+
+
+    if (this.reconnectionTimeout) {
+      // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+      clearTimeout(this.reconnectionTimeout);
+    } // Inform listeners
+
+
+    if (this.currentReconnectionAttempts > 0) {
+      if (this.options.debug) console.log(`(teckos:client) [${this.url}] Reconnect #${this.currentReconnectionAttempts} failed!`);
+      this.listeners('reconnect_error').forEach(listener => {
+        if (listener) listener();
+      });
+    } else {
+      if (this.options.debug) console.log(`(teckos:client) [${this.url}] Disconnected!`);
+      this.listeners('disconnect').forEach(listener => {
+        if (listener) listener();
+      });
+    }
+
+    if (this.options.reconnection) {
+      // Apply reconnection logic
+      this.currentReconnectionAttempts += 1;
+
+      if (this.options.reconnectionAttempts === Infinity || this.currentReconnectionAttempts <= this.options.reconnectionAttempts) {
+        const timeout = Math.min(this.options.reconnectionDelayMax, this.currentReconnectDelay); // Increase reconnection delay
+
+        this.currentReconnectDelay = Math.round(this.currentReconnectDelay + this.currentReconnectDelay * this.options.randomizationFactor);
+        if (this.options.debug) console.log(`(teckos:client) [${this.url}] Try reconnecting (${this.currentReconnectionAttempts}/${this.options.reconnectionAttempts}) in ${timeout}ms to ${this.url}...`);
+        this.reconnectionTimeout = setTimeout(() => {
+          this.reconnect();
+        }, timeout);
+      } else {
+        if (this.options.debug) console.log(`(teckos:client) [${this.url}] Reconnection maximum of ${this.options.reconnectionAttempts} reached`);
+        this.listeners('reconnect_failed').forEach(listener => listener());
+      }
+    }
+  };
+  close = () => {
+    if (this.options.debug) console.log(`(teckos:client) [${this.url}] Closing connection (client-side)`);
+
+    if (this.ws !== undefined) {
+      this.ws.onclose = () => {};
+
+      this.ws.close();
+      this.listeners('disconnect').forEach(listener => listener());
+    }
+  };
+  disconnect = () => {
+    this.close();
+  };
+}
+
+/* eslint-disable no-console */
+
+class TeckosClientWithJWT extends TeckosClient {
+  token;
+  initialData;
+  receivedReady = false; // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+
+  constructor(url, options, token, initialData) {
+    super(url, options);
+    this.token = token; // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+
+    this.initialData = initialData;
+    this.on('disconnect', () => {
+      this.receivedReady = false;
+    });
+  }
+
+  getConnectionState() {
+    if (this.ws) {
+      switch (this.ws.readyState) {
+        case undefined:
+          if (this.receivedReady) {
+            return exports.ConnectionState.CONNECTED;
+          }
+
+          return exports.ConnectionState.CONNECTING;
+
+        case undefined:
+          return exports.ConnectionState.CONNECTING;
+
+        case undefined:
+          return exports.ConnectionState.DISCONNECTING;
+
+        default:
+          return exports.ConnectionState.DISCONNECTED;
+      }
+    }
+
+    return exports.ConnectionState.DISCONNECTED;
+  }
+
+  handleReadyEvent = () => {
+    if (this.options.debug) console.log(`(teckos:client) [${this.url}] Connected!`);
+    this.receivedReady = true;
+
+    if (this.currentReconnectionAttempts > 0) {
+      if (this.options.debug) console.log(`(teckos:client) [${this.url}] Reconnected!`);
+      this.listeners('reconnect').forEach(listener => listener()); // Reset reconnection settings to default
+
+      this.currentReconnectDelay = this.options.reconnectionDelay;
+      this.currentReconnectionAttempts = 0;
+    }
+
+    this.listeners('connect').forEach(listener => listener());
+  };
+  handleOpen = () => {
+    this.receivedReady = false;
+    this.once('ready', this.handleReadyEvent);
+    if (this.options.debug) console.log(`(teckos:client) Connection opened, sending token now`);
+    this.emit('token', {
+      token: this.token,
+      ...this.initialData
+    });
+  };
+}
+
+exports.TeckosClient = TeckosClient;
+exports.TeckosClientWithJWT = TeckosClientWithJWT;
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+}));

package/dist/index.min.js

@@ -0,0 +1 @@
+!function(e,t){"object"==typeof exports&&"undefined"!=typeof module?t(exports):"function"==typeof define&&define.amd?define(["exports"],t):t((e="undefined"!=typeof globalThis?globalThis:e||self)["Teckos Client"]={})}(this,(function(e){"use strict";function t(e){return`Minified Redux error #${e}; visit https://redux.js.org/Errors?code=${e} for the full message or use the non-minified dev environment for full errors. `}module.exports=require("ws");const n=new TextEncoder,s=new TextDecoder;var i,o;e.PacketType=void 0,(i=e.PacketType||(e.PacketType={}))[i.EVENT=0]="EVENT",i[i.ACK=1]="ACK",e.ConnectionState=void 0,(o=e.ConnectionState||(e.ConnectionState={})).DISCONNECTED="disconnected",o.CONNECTING="connecting",o.CONNECTED="connected",o.DISCONNECTING="disconnecting";const c={reconnection:!0,reconnectionDelay:1e3,reconnectionDelayMax:5e3,reconnectionAttempts:1/0,randomizationFactor:.5,timeout:5e3,debug:!1};class r extends class{maxListeners=50;handlers={};addListener=(e,n)=>{if(Object.keys(this.handlers).length===this.maxListeners)throw Error(t(2));if("function"!=typeof n)throw Error(t(3));return this.handlers[e]=this.handlers[e]||[],this.handlers[e].push(n),this};once=(e,n)=>{if(Object.keys(this.handlers).length===this.maxListeners)throw Error(t(2));if("function"!=typeof n)throw Error(t(3));this.handlers[e]=this.handlers[e]||[];const s=()=>{n(),this.off(e,s)};return this.handlers[e].push(s),this};removeListener=(e,t)=>(this.handlers[e]&&(this.handlers[e]=this.handlers[e].filter((e=>e!==t))),this);off=(e,t)=>this.removeListener(e,t);removeAllListeners=e=>(e?delete this.handlers[e]:this.handlers={},this);setMaxListeners=e=>(this.maxListeners=e,this);getMaxListeners=()=>this.maxListeners;listeners=e=>this.handlers[e]?[...this.handlers[e]]:[];rawListeners=e=>[...this.handlers[e]];listenerCount=e=>this.handlers[e]?Object.keys(this.handlers[e]).length:0;prependListener=(e,n)=>{if(Object.keys(this.handlers).length===this.maxListeners)throw Error(t(2));return this.handlers[e]=this.handlers[e]||[],this.handlers[e].unshift(n),this};prependOnceListener=(e,n)=>{if(Object.keys(this.handlers).length===this.maxListeners)throw Error(t(2));this.handlers[e]=this.handlers[e]||[];const s=()=>{n(),this.off(e,s)};return this.handlers[e].unshift(s),this};eventNames=()=>Object.keys(this.handlers);on=(e,t)=>this.addListener(e,t);emit=(e,...t)=>{const n=this.listeners(e);return n.length>0&&(n.forEach((e=>{e&&e(t)})),!0)}}{url;options;ws;currentReconnectDelay;currentReconnectionAttempts=0;acks=new Map;fnId=0;connectionTimeout;reconnectionTimeout;constructor(e,t){super(),this.options={...c,...t},this.currentReconnectDelay=this.options.reconnectionDelay,this.url=e}attachHandler=()=>{this.ws&&(this.ws.onopen=this.handleOpen,this.ws.onerror=this.handleError,this.ws.onclose=this.handleClose,this.ws.onmessage=this.handleMessage)};get webSocket(){return this.ws}connect=()=>{this.options.debug&&console.log(`(teckos:client) Connecting to ${this.url}...`),this.ws=new(void 0)(this.url),this.attachHandler(),this.connectionTimeout=setTimeout((()=>{this.ws&&0===this.ws.readyState&&this.ws.close()}),this.options.timeout)};reconnect=()=>{this.listeners("reconnect_attempt").forEach((e=>e())),this.connect()};getConnectionState(){if(this.ws)switch(this.ws.readyState){case 0:return e.ConnectionState.CONNECTING;case 1:return e.ConnectionState.CONNECTED;case 2:return e.ConnectionState.DISCONNECTING;default:return e.ConnectionState.DISCONNECTED}return e.ConnectionState.DISCONNECTED}get state(){return this.getConnectionState()}get connected(){return this.getConnectionState()===e.ConnectionState.CONNECTED}get disconnected(){return this.getConnectionState()===e.ConnectionState.DISCONNECTED}emit=(t,...n)=>{n.unshift(t);const s={type:e.PacketType.EVENT,data:n};return"function"==typeof n[n.length-1]&&(this.acks.set(this.fnId,n.pop()),s.id=this.fnId,this.fnId+=1),this.sendPackage(s)};send=(...t)=>(t.unshift("message"),this.sendPackage({type:e.PacketType.EVENT,data:t}));sendPackage=e=>{if(void 0!==this.ws&&1===this.ws.readyState){const t=(e=>n.encode(JSON.stringify(e)))(e);return this.options.debug&&console.log(`(teckos:client) [${this.url}] Send packet: ${JSON.stringify(e)}`),this.ws.send(t),!0}return!1};handleMessage=n=>{const i="string"==typeof n.data?JSON.parse(n.data):JSON.parse(""+s.decode(n.data));if(this.options.debug&&console.log(`(teckos:client) [${this.url}] Got packet: ${JSON.stringify(i)}`),i.type===e.PacketType.EVENT){const e=i.data[0],n=i.data.slice(1);if(!e)throw Error(t(0));this.listeners(e).forEach((e=>e(...n)))}else{if(i.type!==e.PacketType.ACK||void 0===i.id)throw Error(t(1));{const e=this.acks.get(i.id);"function"==typeof e&&(e.apply(this,i.data),this.acks.delete(i.id))}}};handleOpen=()=>{this.currentReconnectionAttempts>0&&(this.currentReconnectDelay=this.options.reconnectionDelay,this.currentReconnectionAttempts=0,this.options.debug&&console.log(`(teckos:client) [${this.url}] Reconnected!`),this.listeners("reconnect").forEach((e=>e()))),this.options.debug&&console.log(`(teckos:client) [${this.url}] Connected!`),this.listeners("connect").forEach((e=>e()))};handleError=e=>{this.handlers&&this.handlers.error&&(this.options.debug&&console.log(`(teckos:client) [${this.url}] Got error from server: ${JSON.stringify(e)}`),this.handlers.error.forEach((t=>t(e))))};handleClose=()=>{if(this.connectionTimeout&&clearTimeout(this.connectionTimeout),this.reconnectionTimeout&&clearTimeout(this.reconnectionTimeout),this.currentReconnectionAttempts>0?(this.options.debug&&console.log(`(teckos:client) [${this.url}] Reconnect #${this.currentReconnectionAttempts} failed!`),this.listeners("reconnect_error").forEach((e=>{e&&e()}))):(this.options.debug&&console.log(`(teckos:client) [${this.url}] Disconnected!`),this.listeners("disconnect").forEach((e=>{e&&e()}))),this.options.reconnection)if(this.currentReconnectionAttempts+=1,this.options.reconnectionAttempts!==1/0&&this.currentReconnectionAttempts>this.options.reconnectionAttempts)this.options.debug&&console.log(`(teckos:client) [${this.url}] Reconnection maximum of ${this.options.reconnectionAttempts} reached`),this.listeners("reconnect_failed").forEach((e=>e()));else{const e=Math.min(this.options.reconnectionDelayMax,this.currentReconnectDelay);this.currentReconnectDelay=Math.round(this.currentReconnectDelay+this.currentReconnectDelay*this.options.randomizationFactor),this.options.debug&&console.log(`(teckos:client) [${this.url}] Try reconnecting (${this.currentReconnectionAttempts}/${this.options.reconnectionAttempts}) in ${e}ms to ${this.url}...`),this.reconnectionTimeout=setTimeout((()=>{this.reconnect()}),e)}};close=()=>{this.options.debug&&console.log(`(teckos:client) [${this.url}] Closing connection (client-side)`),void 0!==this.ws&&(this.ws.onclose=()=>{},this.ws.close(),this.listeners("disconnect").forEach((e=>e())))};disconnect=()=>{this.close()}}e.TeckosClient=r,e.TeckosClientWithJWT=class extends r{token;initialData;receivedReady=!1;constructor(e,t,n,s){super(e,t),this.token=n,this.initialData=s,this.on("disconnect",(()=>{this.receivedReady=!1}))}getConnectionState(){if(this.ws)switch(this.ws.readyState){case void 0:return this.receivedReady?e.ConnectionState.CONNECTED:e.ConnectionState.CONNECTING;case void 0:return e.ConnectionState.CONNECTING;case void 0:return e.ConnectionState.DISCONNECTING;default:return e.ConnectionState.DISCONNECTED}return e.ConnectionState.DISCONNECTED}handleReadyEvent=()=>{this.options.debug&&console.log(`(teckos:client) [${this.url}] Connected!`),this.receivedReady=!0,this.currentReconnectionAttempts>0&&(this.options.debug&&console.log(`(teckos:client) [${this.url}] Reconnected!`),this.listeners("reconnect").forEach((e=>e())),this.currentReconnectDelay=this.options.reconnectionDelay,this.currentReconnectionAttempts=0),this.listeners("connect").forEach((e=>e()))};handleOpen=()=>{this.receivedReady=!1,this.once("ready",this.handleReadyEvent),this.options.debug&&console.log("(teckos:client) Connection opened, sending token now"),this.emit("token",{token:this.token,...this.initialData})}},Object.defineProperty(e,"__esModule",{value:!0})}));