sonic-ws 1.3.1 → 1.3.2

package/dist/ws/util/packets/PacketHolder.js

@@ -2,91 +2,5 @@
  * Copyright 2026 Lily (liwybloc)
  * Licensed under the Apache License, Version 2.0.
  */
-"use strict";
 
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PacketHolder = void 0;
-
-class PacketHolder {
-    
-    key;
-    
-    keys;
-    
-    tags;
-    
-    packetMap;
-    
-    packets;
-    
-    constructor(packets) {
-        
-        
-        this.key = 1;
-        this.keys = {};
-        this.tags = {};
-        this.packetMap = {};
-        if (!packets)
-            return;
-        this.holdPackets(packets);
-    }
-    
-    createKey(tag) {
-        this.keys[tag] = this.key;
-        this.tags[this.key] = tag;
-        this.key++;
-    }
-    
-    holdPackets(packets) {
-        this.packets = packets;
-        for (const packet of packets)
-            this.createKey(packet.tag), this.packetMap[packet.tag] = packet;
-    }
-    
-    getKey(tag) {
-        if (!(tag in this.keys))
-            throw new Error(`Not a valid tag: ${tag}`);
-        return this.keys[tag];
-    }
-    
-    getTag(key) {
-        if (!(key in this.tags))
-            return undefined;
-        return this.tags[key];
-    }
-    
-    getPacket(tag) {
-        if (!(tag in this.packetMap))
-            throw new Error("Unknown packet tag: " + tag);
-        return this.packetMap[tag];
-    }
-    
-    hasKey(key) {
-        return key in this.tags;
-    }
-    
-    hasTag(tag) {
-        return tag in this.keys;
-    }
-    
-    getKeys() {
-        return this.keys;
-    }
-    
-    getTagMap() {
-        return this.tags;
-    }
-    
-    getTags() {
-        return Object.values(this.tags);
-    }
-    
-    getPackets() {
-        return this.packets;
-    }
-    
-    serialize() {
-        return this.packets.map(p => p.serialize()).flat();
-    }
-}
-exports.PacketHolder = PacketHolder;
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.PacketHolder=void 0;exports.PacketHolder=class{key;keys;tags;packetMap;packets;constructor(t){this.key=1,this.keys={},this.tags={},this.packetMap={},t&&this.holdPackets(t)}createKey(t){this.keys[t]=this.key,this.tags[this.key]=t,this.key++}holdPackets(t){this.packets=t;for(const e of t)this.createKey(e.tag),this.packetMap[e.tag]=e}getKey(t){if(!(t in this.keys))throw new Error(`Not a valid tag: ${t}`);return this.keys[t]}getTag(t){if(t in this.tags)return this.tags[t]}getPacket(t){if(!(t in this.packetMap))throw new Error("Unknown packet tag: "+t);return this.packetMap[t]}hasKey(t){return t in this.tags}hasTag(t){return t in this.keys}getKeys(){return this.keys}getTagMap(){return this.tags}getTags(){return Object.values(this.tags)}getPackets(){return this.packets}serialize(){return this.packets.map(t=>t.serialize()).flat()}};

package/dist/ws/util/packets/PacketUtils.js

@@ -2,228 +2,5 @@
  * Copyright 2026 Lily (liwybloc)
  * Licensed under the Apache License, Version 2.0.
  */
-"use strict";
 
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.processPacket = processPacket;
-exports.listenPacket = listenPacket;
-exports.CreatePacket = CreatePacket;
-exports.CreateObjPacket = CreateObjPacket;
-exports.CreateEnumPacket = CreateEnumPacket;
-exports.CreateKeyEffective = CreateKeyEffective;
-exports.FlattenData = FlattenData;
-exports.UnFlattenData = UnFlattenData;
-const Packets_1 = require("../../packets/Packets");
-const PacketType_1 = require("../../packets/PacketType");
-const EnumType_1 = require("../enums/EnumType");
-const CompressionUtil_1 = require("./CompressionUtil");
-const HashUtil_1 = require("./HashUtil");
-
-async function processPacket(packets, tag, values, sendQueue, id, force = false) {
-    const code = packets.getKey(tag);
-    const packet = packets.getPacket(tag);
-    return handleQueue(sendQueue, packets, id, tag, values, force, async () => {
-        if (packet.rereference) {
-            if (id === -1)
-                throw new Error("Cannot send a re-referenced packet from the server-wide sender!");
-            const serialized = (0, HashUtil_1.hashValue)(values);
-            if (packet.lastSent[id] === serialized) {
-                return [code, CompressionUtil_1.EMPTY_UINT8, packet];
-            }
-            packet.lastSent[id] = serialized;
-        }
-        if (packet.autoFlatten) {
-            values = FlattenData(values[0]);
-        }
-        else {
-            if (values.length > packet.maxSize)
-                throw new Error(`Packet "${tag}" only allows ${packet.maxSize} values!`);
-            if (values.length < packet.minSize)
-                throw new Error(`Packet "${tag}" requires at least ${packet.minSize} values!`);
-        }
-        if (!packet.object) {
-            if (packet.type !== PacketType_1.PacketType.JSON) {
-                const found = values.find(v => typeof v === 'object' && v != null);
-                if (found)
-                    console.warn(`Passing an array will result in undefined behavior (${JSON.stringify(found)}). Spread the array with ...arr`);
-            }
-        }
-        else {
-            values = values.map(x => !Array.isArray(x) ? [x] : x);
-            if (!packet.autoFlatten) {
-                const dataMins = packet.dataMin;
-                const dataMaxes = packet.dataMax;
-                for (let i = 0; i < dataMins.length; i++) {
-                    if (values[i].length < dataMins[i])
-                        throw new Error(`Section ${i + 1} of packet "${tag}" requires at least ${dataMins[i]} values!`);
-                    if (values[i].length > dataMaxes[i])
-                        throw new Error(`Section ${i + 1} of packet "${tag}" only allows ${dataMaxes[i]} values!`);
-                }
-            }
-        }
-        const sendData = values.length > 0 ? await packet.processSend(values) : CompressionUtil_1.EMPTY_UINT8;
-        return [code, sendData, packet];
-    });
-}
-
-async function handleQueue(sendQueue, packets, id, tag, values, force, fn) {
-    if (sendQueue[0] && !force) {
-        return new Promise((resolve) => sendQueue[1].push([resolve, tag, values]));
-    }
-    sendQueue[0] = true;
-    const result = await fn();
-    if (sendQueue[1].length > 0) {
-        const [resolve, nextTag, nextValues] = sendQueue[1].shift();
-        queueMicrotask(async () => {
-            resolve(await processPacket(packets, nextTag, nextValues, sendQueue, id, true));
-        });
-    }
-    else {
-        sendQueue[0] = false;
-    }
-    return result;
-}
-
-async function listenPacket(listened, listeners, errorCB) {
-    if (typeof listened === 'string')
-        return errorCB(listened);
-    const [processed, flatten] = listened;
-    try {
-        if (flatten && Array.isArray(processed)) {
-            for (const l of listeners) {
-                await l(...processed);
-            }
-        }
-        else {
-            for (const l of listeners) {
-                await l(processed);
-            }
-        }
-    }
-    catch (err) {
-        console.error(err);
-        errorCB(err);
-    }
-}
-
-function isInvalidType(type) {
-    return (!(typeof type == 'number' && type in PacketType_1.PacketType) && !(type instanceof EnumType_1.EnumPackage)) || type == PacketType_1.PacketType.KEY_EFFECTIVE;
-}
-const MAX_DATA_MAX = 2048383;
-
-function clampDataMax(dataMax) {
-    if (dataMax < 0) {
-        console.warn(`Having a data maximum below 0 does not do anything!`);
-        return 0;
-    }
-    
-    if (dataMax > MAX_DATA_MAX) {
-        console.warn(`Only ${MAX_DATA_MAX} values can be sent on a type! Uhh make an issue if you want to send more.`);
-        return MAX_DATA_MAX;
-    }
-    return dataMax;
-}
-
-function clampDataMin(dataMin, dataMax) {
-    if (dataMin < 0) {
-        console.warn(`Having a data minimum below 0 does not do anything!`);
-        return 0;
-    }
-    
-    if (dataMin > dataMax) {
-        console.warn(`Data minimum can not be higher than the data maximum!`);
-        return dataMax;
-    }
-    return dataMin;
-}
-
-function CreatePacket(settings) {
-    let { tag, type = PacketType_1.PacketType.NONE, dataMax = 1, dataMin = 1, noDataRange = false, dontSpread = false, validator = null, dataBatching = 0, maxBatchSize = 10, rateLimit = 0, enabled = true, async = false, gzipCompression = type == PacketType_1.PacketType.JSON, rereference = false } = settings;
-    if (!tag)
-        throw new Error("Tag not selected!");
-    if (noDataRange) {
-        dataMin = rereference ? 1 : 0;
-        dataMax = MAX_DATA_MAX;
-    }
-    else if (dataMin == undefined)
-        dataMin = type == PacketType_1.PacketType.NONE ? 0 : dataMax;
-    if (rereference && dataMin == 0)
-        throw new Error("Rereference cannot be true if the dataMin is 0");
-    if (isInvalidType(type)) {
-        throw new Error(`Invalid packet type: ${type}`);
-    }
-    const schema = Packets_1.PacketSchema.single(type, clampDataMax(dataMax), clampDataMin(dataMin, dataMax), dontSpread, dataBatching, maxBatchSize, rateLimit, async, gzipCompression, rereference);
-    return new Packets_1.Packet(tag, schema, validator, enabled, false);
-}
-
-function CreateObjPacket(settings) {
-    let { tag, types = [], dataMaxes, dataMins, noDataRange = false, dontSpread = false, autoFlatten = false, validator = null, dataBatching = 0, maxBatchSize = 10, rateLimit = 0, enabled = true, async = false, gzipCompression = types && types.includes(PacketType_1.PacketType.JSON) } = settings;
-    if (!tag)
-        throw new Error("Tag not selected!");
-    if (!types || types.length == 0)
-        throw new Error("Types is set to 0 length");
-    for (const type of types) {
-        if (!isInvalidType(type))
-            continue;
-        throw new Error(`Invalid packet type in "${tag}" packet: ${type}`);
-    }
-    if (noDataRange) {
-        dataMaxes = Array.from({ length: types.length }).map(() => MAX_DATA_MAX);
-        dataMins = Array.from({ length: types.length }).map(() => 0);
-    }
-    else {
-        if (dataMaxes == undefined)
-            dataMaxes = Array.from({ length: types.length }).map(() => 1);
-        else if (!Array.isArray(dataMaxes))
-            dataMaxes = Array.from({ length: types.length }).map(() => dataMaxes);
-        if (dataMins == undefined)
-            dataMins = Array.from({ length: types.length }).map((_, i) => dataMaxes[i]);
-        else if (!Array.isArray(dataMins))
-            dataMins = Array.from({ length: types.length }).map(() => dataMins);
-    }
-    const clampedDataMaxes = dataMaxes.map(clampDataMax);
-    const clampedDataMins = dataMins.map((m, i) => types[i] == PacketType_1.PacketType.NONE ? 0 : clampDataMin(m, clampedDataMaxes[i]));
-    const schema = Packets_1.PacketSchema.object(types, clampedDataMaxes, clampedDataMins, dontSpread, autoFlatten, dataBatching, maxBatchSize, rateLimit, async, gzipCompression);
-    return new Packets_1.Packet(tag, schema, validator, enabled, false);
-}
-
-function CreateEnumPacket(settings) {
-    const { tag, enumData, dataMax = 1, dataMin = 0, noDataRange = false, dontSpread = false, validator = null, dataBatching = 0, maxBatchSize = 10, rateLimit = 0, enabled = true, async = false } = settings;
-    return CreatePacket({
-        tag: tag,
-        type: enumData,
-        dataMax,
-        dataMin,
-        noDataRange,
-        dontSpread,
-        validator,
-        dataBatching,
-        maxBatchSize,
-        rateLimit,
-        enabled,
-        async,
-    });
-}
-function CreateKeyEffective(settings) {
-    const { tag, count = 2, validator = null, async = false } = settings;
-    if (!tag)
-        throw new Error("Tag not selected!");
-    if (count < 2)
-        throw new Error("Must have at least 2 key consumptions on key effective packet!");
-    throw new Error("Currently W.I.P.");
-}
-
-function FlattenData(arr) {
-    if (arr == null)
-        return [];
-    const setup = arr[0];
-    if (setup == null)
-        return [];
-    if (!Array.isArray(setup))
-        throw new Error(`Cannot flatten array: ${arr}`);
-    return setup.map((_, i) => arr.map(row => row[i])) ?? [];
-}
-
-function UnFlattenData(arr) {
-    return arr[0]?.map((_, i) => arr.map(col => col[i])) ?? [];
-}
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.processPacket=o,exports.listenPacket=async function(e,t,a){if("string"==typeof e)return a(e);const[n,r]=e;try{if(r&&Array.isArray(n))for(const e of t)await e(...n);else for(const e of t)await e(n)}catch(e){console.error(e),a(e)}},exports.CreatePacket=u,exports.CreateObjPacket=function(a){let{tag:n,types:r=[],dataMaxes:o,dataMins:u,noDataRange:f=!1,dontSpread:p=!1,autoFlatten:h=!1,validator:y=null,dataBatching:m=0,maxBatchSize:d=10,rateLimit:w=0,enabled:g=!0,async:k=!1,gzipCompression:P=r&&r.includes(t.PacketType.JSON)}=a;if(!n)throw new Error("Tag not selected!");if(!r||0==r.length)throw new Error("Types is set to 0 length");for(const e of r)if(i(e))throw new Error(`Invalid packet type in "${n}" packet: ${e}`);f?(o=Array.from({length:r.length}).map(()=>s),u=Array.from({length:r.length}).map(()=>0)):(null==o?o=Array.from({length:r.length}).map(()=>1):Array.isArray(o)||(o=Array.from({length:r.length}).map(()=>o)),null==u?u=Array.from({length:r.length}).map((e,t)=>o[t]):Array.isArray(u)||(u=Array.from({length:r.length}).map(()=>u)));const E=o.map(c),S=u.map((e,a)=>r[a]==t.PacketType.NONE?0:l(e,E[a])),x=new e.PacketSchema(!0,r,k,S,E,w,p,h,!1,m,d,P);return new e.Packet(n,x,y,g,!1)},exports.CreateEnumPacket=function(e){const{tag:t,enumData:a,dataMax:n=1,dataMin:r=0,noDataRange:o=!1,dontSpread:i=!1,validator:s=null,dataBatching:c=0,maxBatchSize:l=10,rateLimit:f=0,enabled:p=!0,async:h=!1}=e;return u({tag:t,type:a,dataMax:n,dataMin:r,noDataRange:o,dontSpread:i,validator:s,dataBatching:c,maxBatchSize:l,rateLimit:f,enabled:p,async:h})},exports.CreateKeyEffective=function(e){const{tag:t,count:a=2,validator:n=null,async:r=!1}=e;if(!t)throw new Error("Tag not selected!");if(a<2)throw new Error("Must have at least 2 key consumptions on key effective packet!");throw new Error("Currently W.I.P.")},exports.FlattenData=f,exports.UnFlattenData=function(e){return e[0]?.map((t,a)=>e.map(e=>e[a]))??[]};const e=require("../../packets/Packets"),t=require("../../packets/PacketType"),a=require("../enums/EnumType"),n=require("./CompressionUtil"),r=require("./HashUtil");async function o(e,a,i,s,c,l=!1){const u=e.getKey(a),p=e.getPacket(a);return async function(e,t,a,n,r,i,s){if(e[0]&&!i)return new Promise(t=>e[1].push([t,n,r]));e[0]=!0;const c=await s();if(e[1].length>0){const[n,r,i]=e[1].shift();queueMicrotask(async()=>{n(await o(t,r,i,e,a,!0))})}else e[0]=!1;return c}(s,e,c,a,i,l,async()=>{if(p.rereference){if(-1===c)throw new Error("Cannot send a re-referenced packet from the server-wide sender!");const e=(0,r.hashValue)(i);if(p.lastSent[c]===e)return[u,n.EMPTY_UINT8,p];p.lastSent[c]=e}if(p.autoFlatten)i=f(i[0]);else{if(i.length>p.maxSize)throw new Error(`Packet "${a}" only allows ${p.maxSize} values!`);if(i.length<p.minSize)throw new Error(`Packet "${a}" requires at least ${p.minSize} values!`)}if(p.object){if(i=i.map(e=>Array.isArray(e)?e:[e]),!p.autoFlatten){const e=p.dataMin,t=p.dataMax;for(let n=0;n<e.length;n++){if(i[n].length<e[n])throw new Error(`Section ${n+1} of packet "${a}" requires at least ${e[n]} values!`);if(i[n].length>t[n])throw new Error(`Section ${n+1} of packet "${a}" only allows ${t[n]} values!`)}}}else if(p.type!==t.PacketType.JSON){const e=i.find(e=>"object"==typeof e&&null!=e);e&&console.warn(`Passing an array will result in undefined behavior (${JSON.stringify(e)}). Spread the array with ...arr`)}const e=i.length>0?await p.processSend(i):n.EMPTY_UINT8;return[u,e,p]})}function i(e){return!(("number"==typeof e&&e in t.PacketType||e instanceof a.EnumPackage)&&e!=t.PacketType.KEY_EFFECTIVE)}const s=2048383;function c(e){return e<0?(console.warn("Having a data maximum below 0 does not do anything!"),0):e>s?(console.warn(`Only ${s} values can be sent on a type! Uhh make an issue if you want to send more.`),s):e}function l(e,t){return e<0?(console.warn("Having a data minimum below 0 does not do anything!"),0):e>t?(console.warn("Data minimum can not be higher than the data maximum!"),t):e}function u(a){let{tag:n,type:r=t.PacketType.NONE,dataMax:o=1,dataMin:u=1,noDataRange:f=!1,dontSpread:p=!1,validator:h=null,dataBatching:y=0,maxBatchSize:m=10,rateLimit:d=0,enabled:w=!0,async:g=!1,gzipCompression:k=r==t.PacketType.JSON,rereference:P=!1}=a;if(!n)throw new Error("Tag not selected!");if(f?(u=P?1:0,o=s):null==u&&(u=r==t.PacketType.NONE?0:o),P&&0==u)throw new Error("Rereference cannot be true if the dataMin is 0");if(i(r))throw new Error(`Invalid packet type: ${r}`);const E=new e.PacketSchema(!1,r,g,l(u,o),c(o),d,p,!1,P,y,m,k);return new e.Packet(n,E,h,w,!1)}function f(e){if(null==e)return[];const t=e[0];if(null==t)return[];if(!Array.isArray(t))throw new Error(`Cannot flatten array: ${e}`);return t.map((t,a)=>e.map(e=>e[a]))??[]}

package/dist/ws/util/packets/RateHandler.js

@@ -2,55 +2,5 @@
  * Copyright 2026 Lily (liwybloc)
  * Licensed under the Apache License, Version 2.0.
  */
-"use strict";
 
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RateHandler = void 0;
-const Connection_1 = require("../../Connection");
-
-class RateHandler {
-    rates = {};
-    limits = {};
-    setInterval;
-    socket;
-    constructor(host) {
-        
-        this.setInterval = host.setInterval;
-        this.socket = host.socket;
-    }
-    start() {
-        
-        if (Object.keys(this.rates).length == 0)
-            return;
-        this.setInterval(() => {
-            for (const tag in this.rates) {
-                this.rates[tag] = 0;
-            }
-        }, 1000);
-    }
-    registerRate(tag, limit) {
-        
-        if (limit == 0)
-            return;
-        this.rates[tag] = 0;
-        this.limits[tag] = limit;
-    }
-    registerAll(packetHolder, prefix) {
-        const packets = packetHolder.getPackets();
-        for (const packet of packets)
-            this.registerRate(prefix + packetHolder.getKey(packet.tag), packet.rateLimit);
-    }
-    trigger(tag) {
-        if (tag in this.rates && ++this.rates[tag] > this.limits[tag]) {
-            this.socket.close(Connection_1.CloseCodes.RATELIMIT);
-            return true;
-        }
-        return false;
-    }
-    subtract(tag) {
-        if (!(tag in this.rates))
-            return;
-        this.rates[tag]--;
-    }
-}
-exports.RateHandler = RateHandler;
+Object.defineProperty(exports,"__esModule",{value:!0}),exports.RateHandler=void 0;const t=require("../../Connection");exports.RateHandler=class{rates={};limits={};setInterval;socket;constructor(t){this.setInterval=t.setInterval,this.socket=t.socket}start(){0!=Object.keys(this.rates).length&&this.setInterval(()=>{for(const t in this.rates)this.rates[t]=0},1e3)}registerRate(t,e){0!=e&&(this.rates[t]=0,this.limits[t]=e)}registerAll(t,e){const s=t.getPackets();for(const r of s)this.registerRate(e+t.getKey(r.tag),r.rateLimit)}trigger(e){return e in this.rates&&++this.rates[e]>this.limits[e]&&(this.socket.close(t.CloseCodes.RATELIMIT),!0)}subtract(t){t in this.rates&&this.rates[t]--}};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sonic-ws",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "Ultra-lightweight, high-performance, and bandwidth efficient websocket library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -8,7 +8,7 @@
     "webpack": "webpack --mode production",
     "build_web": "rimraf ./html && tsc --moduleResolution nodenext --module nodenext --outDir ./html src/ws/client/browser/ClientBrowser.ts && npm run webpack",
     "build_node": "rimraf ./dist && tsc -d",
-    "build": "npm run build_node && npm run build_web && node minify",
+    "build": "npm run build_node && npm run build_web && rimraf ./dist/ws/client/browser && rimraf ./dist/ws/debug/DebugClient.d.ts && rimraf ./dist/ws/debug/DebugClient.js && node minify",
     "test_web": "npm run build && node test-site/server.mjs",
     "test_node": "npm run build_node && node test.mjs",
     "publish": "npm run build && cp ./bundled/SonicWS_bundle.js ./release/SonicWS_bundle.js"
@@ -24,6 +24,7 @@
   "author": "lily",
   "license": "Apache-2.0",
   "dependencies": {
+    "open": "^11.0.0",
     "ws": "^8.18.2"
   },
   "devDependencies": {

package/dist/ws/debug/DebugClient.d.ts

@@ -1,11 +0,0 @@
-/**
- * Copyright 2026 Lily (liwybloc)
- * Licensed under the Apache License, Version 2.0.
- */
-import { SonicWS } from "../client/browser/ClientBrowser";
-export declare class DebugClient {
-    host: SonicWS;
-    constructor(host: SonicWS);
-    private _evalInScope;
-    private _loadDebugScript;
-}