@seriousme/opifex 1.11.3 → 2.1.0

package/dist/server/server.d.ts

@@ -1,27 +1,50 @@
 import type { Handlers } from "./context.ts";
-import type { IPersistence, SockConn } from "./deps.ts";
+import type { Persistence, SockConn } from "./deps.ts";
+import type { Configuration, ConfigurationInput } from "./config.ts";
 /**
- * The options to configure the MqttServer
+ * Configuration options for creating an MqttServer instance.
  */
 export type MqttServerOptions = {
-    persistence?: IPersistence;
+    /** Optional persistence layer implementation. Defaults to MemoryPersistence. */
+    persistence?: Persistence;
+    /** Optional custom handlers for authentication and authorization. */
     handlers?: Handlers;
+    /** Optional configuration data */
+    configuration?: ConfigurationInput;
 };
-/** The MqttServer class provides a MQTT server with configurable persistence and
+/** * The MqttServer class provides an MQTT server with configurable persistence and
  * authentication/authorization handlers.
  *
  * The default handlers are:
- *  - isAuthenticated: always returns ok
- *  - isAuthorizedToPublish: always returns true
- *  - isAuthorizedToSubscribe: always returns true
+ * - isAuthenticated: always returns ok
+ * - isAuthorizedToPublish: always returns true
+ * - isAuthorizedToSubscribe: always returns true
  *
  * To customize the handlers, pass in a Handlers object.
  * To customize the persistence, pass in a Persistence object.
  */
 export declare class MqttServer {
+    /** The registered authentication and authorization handlers. */
     handlers: Handlers;
-    persistence: IPersistence;
-    constructor({ persistence, handlers, }: MqttServerOptions);
+    /** The persistence layer used for storing sessions and messages. */
+    persistence: Persistence;
+    /** The persistence layer used for storing sessions and messages. */
+    configuration: Configuration;
+    /**
+     * Initializes a new instance of the MqttServer.
+     * * @param {MqttServerOptions} options - The configuration options for the server.
+     */
+    constructor({ persistence, handlers, configuration, }: MqttServerOptions);
+    /**
+     * Serve a new client connection.
+     * @param {SockConn} conn - The socket connection to serve.
+     * @returns {Promise<void>} A promise that resolves when the connection is closed.
+     */
     serve(conn: SockConn): Promise<void>;
+    /**
+     * Close the server and all active client connections.
+     * @param {boolean} cleanUp - If true, clean up client sessions on close.
+     */
+    close(cleanUp?: boolean): Promise<void>;
 }
 //# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../server/server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAS,MAAM,WAAW,CAAC;AAY/D;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,QAAQ,CAAC,EAAE,QAAQ,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;GAUG;AAEH,qBAAa,UAAU;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,YAAY,CAAC;gBACd,EACV,WAAW,EACX,QAAQ,GACT,EAAE,iBAAiB;IAWd,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAiB3C"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../server/server.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAa,QAAQ,EAAS,MAAM,WAAW,CAAC;AAGzE,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AA4DrE;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,gFAAgF;IAChF,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kCAAkC;IAClC,aAAa,CAAC,EAAE,kBAAkB,CAAC;CACpC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,UAAU;IACrB,gEAAgE;IAChE,QAAQ,EAAE,QAAQ,CAAC;IACnB,oEAAoE;IACpE,WAAW,EAAE,WAAW,CAAC;IACzB,oEAAoE;IACpE,aAAa,EAAE,aAAa,CAAC;IAE7B;;;OAGG;IACH,YAAY,EACV,WAAW,EACX,QAAQ,EACR,aAAa,GACd,EAAE,iBAAiB,EAYnB;IAED;;;;OAIG;IACG,KAAK,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BzC;IAED;;;OAGG;IACG,KAAK,CAAC,OAAO,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CASnD;CACF"}

package/dist/server/server.js

@@ -1,48 +1,117 @@
-import { AuthenticationResult, logger, MemoryPersistence } from "./deps.js";
+import { logger, MemoryPersistence, ReasonCode } from "./deps.js";
 import { Context } from "./context.js";
 import { handlePacket } from "./handlers/handlePacket.js";
-const defaultIsAuthenticated = (_ctx, _clientId, _username, _password) => AuthenticationResult.ok;
-const defaultIsAuthorized = (_ctx, _topic) => true;
-/** The MqttServer class provides a MQTT server with configurable persistence and
+import { createConfiguration } from "./config.js";
+/**
+ * Default preconnect handler that unconditionally permits all connections.
+ * @param {SockConn} _conn - The connection.
+ * @returns {boolean} Always returns true
+ */
+const defaultPreconnect = (_conn) => (true);
+/**
+ * Default authentication handler that unconditionally permits all connections.
+ * @param {Context} _ctx - The connection context.
+ * @param {string} _clientId - The client identifier.
+ * @param {string} _username - The username provided by the client.
+ * @param {Uint8Array} _password - The password provided by the client.
+ * @returns {IsAuthenticatedResult} Always returns ReasonCode.success.
+ */
+const defaultIsAuthenticated = (_ctx, _clientId, _username, _password) => ({ reasonCode: ReasonCode.success });
+const defaultProcessAuth = (_ctx, _clientId, _authMethod, _authData) => ({
+    reasonCode: ReasonCode.badAuthenticationMethod,
+    reasonString: "Authentication method not supported",
+});
+/**
+ * Default authorization handler that unconditionally permits all publish operations.
+ * @param {Context} _ctx - The connection context.
+ * @param {Topic} _topic - The topic being accessed.
+ * @returns {boolean} Always returns true.
+ */
+const defaultIsAuthorizedToPublish = (_ctx, _topic) => (true);
+/**
+ * Default authorization handler that unconditionally permits all subscribe operations.
+ * @param {Context} _ctx - The connection context.
+ * @param {Topic} _topic - The topic being accessed.
+ * @param {ShareName} _shareName - The share name being accessed when using shared subscriptions
+ * @returns {boolean} Always returns true.
+ */
+const defaultIsAuthorizedToSubscribe = (_ctx, _topic, _shareName) => (true);
+/** * The MqttServer class provides an MQTT server with configurable persistence and
  * authentication/authorization handlers.
  *
  * The default handlers are:
- *  - isAuthenticated: always returns ok
- *  - isAuthorizedToPublish: always returns true
- *  - isAuthorizedToSubscribe: always returns true
+ * - isAuthenticated: always returns ok
+ * - isAuthorizedToPublish: always returns true
+ * - isAuthorizedToSubscribe: always returns true
  *
  * To customize the handlers, pass in a Handlers object.
  * To customize the persistence, pass in a Persistence object.
  */
 export class MqttServer {
+    /** The registered authentication and authorization handlers. */
     handlers;
+    /** The persistence layer used for storing sessions and messages. */
     persistence;
-    constructor({ persistence, handlers, }) {
+    /** The persistence layer used for storing sessions and messages. */
+    configuration;
+    /**
+     * Initializes a new instance of the MqttServer.
+     * * @param {MqttServerOptions} options - The configuration options for the server.
+     */
+    constructor({ persistence, handlers, configuration, }) {
         this.persistence = persistence || new MemoryPersistence();
         this.handlers = {
+            preconnect: handlers?.preconnect || defaultPreconnect,
             isAuthenticated: handlers?.isAuthenticated || defaultIsAuthenticated,
+            processAuth: handlers?.processAuth || defaultProcessAuth,
             isAuthorizedToPublish: handlers?.isAuthorizedToPublish ||
-                defaultIsAuthorized,
+                defaultIsAuthorizedToPublish,
             isAuthorizedToSubscribe: handlers?.isAuthorizedToSubscribe ||
-                defaultIsAuthorized,
+                defaultIsAuthorizedToSubscribe,
         };
+        this.configuration = createConfiguration(configuration);
     }
+    /**
+     * Serve a new client connection.
+     * @param {SockConn} conn - The socket connection to serve.
+     * @returns {Promise<void>} A promise that resolves when the connection is closed.
+     */
     async serve(conn) {
-        const ctx = new Context(this.persistence, conn, this.handlers);
+        if (this.handlers.preconnect) {
+            if (!await this.handlers.preconnect(conn)) {
+                conn.close();
+                return;
+            }
+        }
+        const ctx = new Context(this.configuration, this.persistence, conn, this.handlers);
         if (conn.remoteAddr?.transport === "tcp") {
-            logger.debug(`socket connected from ${conn.remoteAddr.hostname}`);
+            logger.debug("socket connected from", conn.remoteAddr.hostname);
         }
         try {
             for await (const packet of ctx.mqttConn) {
+                logger.debug("next packet");
                 await handlePacket(ctx, packet);
             }
         }
         catch (err) {
-            logger.debug(`Error while serving:${err}`);
+            logger.debug("Error while serving:", err);
         }
         finally {
-            if (!ctx.mqttConn.isClosed) {
-                ctx.close();
+            logger.debug("done serving for", ctx.clientId);
+            await ctx.close();
+        }
+    }
+    /**
+     * Close the server and all active client connections.
+     * @param {boolean} cleanUp - If true, clean up client sessions on close.
+     */
+    async close(cleanUp = false) {
+        logger.debug("stopping mqttServer");
+        for (const [clientid, ctx] of Context.clientList) {
+            logger.debug("closing session for clientid:", clientid);
+            await ctx.close();
+            if (cleanUp) {
+                await ctx.clean();
             }
         }
     }

package/dist/server/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../../server/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC5E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAGvC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,MAAM,sBAAsB,GAAG,CAC7B,IAAa,EACb,SAAiB,EACjB,SAAiB,EACjB,SAAqB,EACrB,EAAE,CAAC,oBAAoB,CAAC,EAAE,CAAC;AAE7B,MAAM,mBAAmB,GAAG,CAAC,IAAa,EAAE,MAAa,EAAE,EAAE,CAAC,IAAI,CAAC;AAUnE;;;;;;;;;;GAUG;AAEH,MAAM,OAAO,UAAU;IACrB,QAAQ,CAAW;IACnB,WAAW,CAAe;IAC1B,YAAY,EACV,WAAW,EACX,QAAQ,GACU;QAClB,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,IAAI,iBAAiB,EAAE,CAAC;QAC1D,IAAI,CAAC,QAAQ,GAAG;YACd,eAAe,EAAE,QAAQ,EAAE,eAAe,IAAI,sBAAsB;YACpE,qBAAqB,EAAE,QAAQ,EAAE,qBAAqB;gBACpD,mBAAmB;YACrB,uBAAuB,EAAE,QAAQ,EAAE,uBAAuB;gBACxD,mBAAmB;SACtB,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAc;QACxB,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/D,IAAI,IAAI,CAAC,UAAU,EAAE,SAAS,KAAK,KAAK,EAAE,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,yBAAyB,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC;gBACxC,MAAM,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;gBAC3B,GAAG,CAAC,KAAK,EAAE,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../server/server.ts"],"names":[],"mappings":"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"}

package/dist/socket/socket.d.ts

@@ -1,18 +1,23 @@
-export type SockAddr = NetAddr | UnixAddr | VsockAddr;
-export interface NetAddr {
+/** Net adresses */
+export type NetAddr = {
     transport: "tcp" | "udp";
     hostname: string;
     port: number;
-}
-export interface UnixAddr {
+};
+/** Unix adresses */
+export type UnixAddr = {
     transport: "unix" | "unixpacket";
     path: string;
-}
-export interface VsockAddr {
+};
+/** vSock adresses */
+export type VsockAddr = {
     transport: "vsock";
     cid: number;
     port: number;
-}
+};
+/** Socket adresses */
+export type SockAddr = NetAddr | UnixAddr | VsockAddr;
+/** Socket connection descriptor. */
 export type SockConn = {
     readable: ReadableStream<Uint8Array>;
     writable: WritableStream<Uint8Array>;
@@ -21,13 +26,14 @@ export type SockConn = {
     remoteAddr?: SockAddr;
 };
 export declare class Conn {
-    reader: ReadableStreamBYOBReader;
+    reader: ReadableStreamDefaultReader<Uint8Array>;
     writer: WritableStreamDefaultWriter<Uint8Array>;
     closed: boolean;
     remoteAddr: SockAddr | undefined;
     closer: () => void;
+    private leftover;
     constructor(sockConn: SockConn);
-    read(buff: Uint8Array): Promise<number | null>;
+    read(length: number): Promise<Uint8Array | null>;
     write(data: Uint8Array): Promise<number>;
     close(): void;
 }

package/dist/socket/socket.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../socket/socket.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AACtD,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,GAAG,YAAY,CAAC;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB,CAAC;AAEF,qBAAa,IAAI;IACf,MAAM,EAAE,wBAAwB,CAAC;IACjC,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;gBAEP,QAAQ,EAAE,QAAQ;IASxB,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASpD,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAQxC,KAAK;CAaN"}
+{"version":3,"file":"socket.d.ts","sourceRoot":"","sources":["../../socket/socket.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AACF,oBAAoB;AACpB,MAAM,MAAM,QAAQ,GAAG;IAAE,SAAS,EAAE,MAAM,GAAG,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1E,qBAAqB;AACrB,MAAM,MAAM,SAAS,GAAG;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAC1E,sBAAsB;AACtB,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;AACtD,oCAAoC;AACpC,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACrC,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,UAAU,CAAC,EAAE,QAAQ,CAAC;CACvB,CAAC;AAEF,qBAAa,IAAI;IACf,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;IACjC,MAAM,EAAE,MAAM,IAAI,CAAC;IAEnB,OAAO,CAAC,QAAQ,CAAiC;IAEjD,YAAY,QAAQ,EAAE,QAAQ,EAQ7B;IAEK,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6CrD;IAEK,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAW7C;IAED,KAAK,SAsBJ;CACF"}

package/dist/socket/socket.js

@@ -4,42 +4,90 @@ export class Conn {
     closed;
     remoteAddr;
     closer;
+    leftover = new Uint8Array(0);
     constructor(sockConn) {
         this.closed = false;
-        this.reader = sockConn.readable.getReader({ mode: "byob" });
+        this.reader = sockConn.readable.getReader();
         this.writer = sockConn.writable.getWriter();
-        // this.writer.closed.then(() => this.closed = true);
         this.closer = sockConn.close.bind(sockConn);
+        this.reader.closed.catch(() => { });
+        this.writer.closed.catch(() => { });
         this.remoteAddr = sockConn.remoteAddr;
     }
-    async read(buff) {
-        const buff2 = new Uint8Array(buff.length);
-        const result = await this.reader.read(buff2);
-        if (!result.done) {
-            buff.set(result.value);
+    async read(length) {
+        if (this.closed || length < 0) {
+            return null;
         }
-        return result.value?.byteLength || null;
+        if (length === 0) {
+            return new Uint8Array(0);
+        }
+        const result = new Uint8Array(length);
+        let bytesAccumulated = 0;
+        // Do we have data from the previous read()
+        if (this.leftover.length > 0) {
+            const take = Math.min(this.leftover.length, length);
+            result.set(this.leftover.subarray(0, take), bytesAccumulated);
+            bytesAccumulated += take;
+            this.leftover = this.leftover.subarray(take);
+        }
+        // Keep readin until we have enough data
+        while (bytesAccumulated < length) {
+            const { value, done } = await this.reader.read();
+            if (value) {
+                const needed = length - bytesAccumulated;
+                if (value.length <= needed) {
+                    // We need the whole chunk
+                    result.set(value, bytesAccumulated);
+                    bytesAccumulated += value.length;
+                }
+                else {
+                    // Chunk is bigger than what we need
+                    result.set(value.subarray(0, needed), bytesAccumulated);
+                    bytesAccumulated += needed;
+                    // Save the rest for the next read() call
+                    this.leftover = value.subarray(needed);
+                }
+            }
+            if (done) {
+                // if the stream closed and not enough data was returned, return null
+                return null;
+            }
+        }
+        return result;
     }
-    write(data) {
+    async write(data) {
         if (this.closed) {
-            return Promise.reject();
+            return Promise.reject(new Error("Connection closed"));
+        }
+        try {
+            await this.writer.write(data);
+            return data.length;
+        }
+        catch (err) {
+            this.closed = true;
+            throw err;
         }
-        this.writer.write(data);
-        return new Promise((resolve) => resolve(data.length));
     }
     close() {
         if (!this.closed) {
+            this.closed = true;
+            // deno-coverage-ignore-start
+            void this.writer.close().catch(() => {
+                // ignore duplicate/late close attempts; the stream may already be closed
+            });
+            // deno-coverage-ignore-stop
             try {
-                this.writer.close();
+                void this.reader.cancel().catch(() => {
+                    // ignore duplicate/late cancel attempts; the stream may already be closed
+                });
+                this.reader?.releaseLock();
+                // deno-coverage-ignore
             }
-            catch (_err) { /* swallow any errors on close */ }
-            this.closed = true;
+            catch (_err) { /* swallow */ }
             try {
                 this.closer();
             }
-            catch (_err) {
-                // swallow any errors on close
-            }
+            catch (_err) { /* swallow */ }
         }
     }
 }

package/dist/socket/socket.js.map

@@ -1 +1 @@
-{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../socket/socket.ts"],"names":[],"mappings":"AA0BA,MAAM,OAAO,IAAI;IACf,MAAM,CAA2B;IACjC,MAAM,CAA0C;IAChD,MAAM,CAAU;IAChB,UAAU,CAAuB;IACjC,MAAM,CAAa;IAEnB,YAAY,QAAkB;QAC5B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC5C,qDAAqD;QACrD,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAgB;QACzB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,EAAE,UAAU,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,IAAgB;QACpB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,IAAI,EAAE,CAAC,CAAC,iCAAiC,CAAC,CAAC;YACpD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,CAAC;YAAC,OAAO,IAAI,EAAE,CAAC;gBACd,8BAA8B;YAChC,CAAC;QACH,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../../socket/socket.ts"],"names":[],"mappings":"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"}

package/dist/timer/timer.d.ts

@@ -1,13 +1,45 @@
+/**
+ * A reusable timer class that executes a callback function after a specified delay.
+ * It handles potential drifts or early triggers by checking the actual remaining time
+ * before executing the action.
+ */
 export declare class Timer {
+    /** The delay duration in milliseconds before the timer expires. */
     readonly delay: number;
+    /** The callback function to perform when the timer expires. */
     private action;
+    /** The internal timeout identifier reference, if a timer is active. */
     private timer?;
+    /** The timestamp (in milliseconds) indicating when the timer is scheduled to end. */
     private end;
+    /** Indicates whether the timer is currently active and running. */
     private running;
+    /**
+     * Initializes a new instance of the Timer.
+     * @param {Function} action - The callback function to execute upon expiration.
+     * @param {number} delay - The delay duration in milliseconds.
+     * @param {boolean} [wait=false] - If true, the timer will not start automatically until reset() is called.
+     */
     constructor(action: Function, delay: number, wait?: boolean);
+    /**
+     * Starts the internal setTimeout with the specified delay.
+     * @param {number} delay - The duration in milliseconds for the timeout.
+     */
     private startTimer;
+    /**
+     * Internal handler triggered when the timeout fires.
+     * Verifies if the target end time has genuinely passed, rescheduling if necessary,
+     * or executes the action.
+     */
     private ring;
+    /**
+     * Resets the timer, recalculating the end time and restarting the countdown.
+     * If the timer is already running, it updates the target end time.
+     */
     reset(): void;
+    /**
+     * Cancels the active timeout and stops the timer from running.
+     */
     clear(): void;
 }
 //# sourceMappingURL=timer.d.ts.map

package/dist/timer/timer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../timer/timer.ts"],"names":[],"mappings":"AAAA,qBAAa,KAAK;IAChB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,OAAO,CAAC,MAAM,CAAW;IACzB,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,OAAO,CAAS;gBAGZ,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,UAAQ;IAQzD,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,IAAI;IAWZ,KAAK,IAAI,IAAI;IAOb,KAAK,IAAI,IAAI;CAId"}
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../timer/timer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,KAAK;IAChB,mEAAmE;IACnE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,+DAA+D;IAE/D,OAAO,CAAC,MAAM,CAAW;IAEzB,uEAAuE;IACvE,OAAO,CAAC,KAAK,CAAC,CAAgC;IAE9C,qFAAqF;IACrF,OAAO,CAAC,GAAG,CAAK;IAEhB,mEAAmE;IACnE,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;OAKG;IAEH,YAAY,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,UAAQ,EAMxD;IAED;;;OAGG;IACH,OAAO,CAAC,UAAU;IAKlB;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAWZ;;;OAGG;IACH,KAAK,IAAI,IAAI,CAKZ;IAED;;OAEG;IACH,KAAK,IAAI,IAAI,CAGZ;CACF"}

package/dist/timer/timer.js

@@ -1,10 +1,26 @@
+/**
+ * A reusable timer class that executes a callback function after a specified delay.
+ * It handles potential drifts or early triggers by checking the actual remaining time
+ * before executing the action.
+ */
 export class Timer {
+    /** The delay duration in milliseconds before the timer expires. */
     delay; // delay in microseconds
+    /** The callback function to perform when the timer expires. */
     // deno-lint-ignore ban-types
     action; // function to perform when timer expires
+    /** The internal timeout identifier reference, if a timer is active. */
     timer;
+    /** The timestamp (in milliseconds) indicating when the timer is scheduled to end. */
     end = 0;
+    /** Indicates whether the timer is currently active and running. */
     running = false;
+    /**
+     * Initializes a new instance of the Timer.
+     * @param {Function} action - The callback function to execute upon expiration.
+     * @param {number} delay - The delay duration in milliseconds.
+     * @param {boolean} [wait=false] - If true, the timer will not start automatically until reset() is called.
+     */
     // deno-lint-ignore ban-types
     constructor(action, delay, wait = false) {
         this.delay = delay;
@@ -13,10 +29,19 @@ export class Timer {
             this.reset();
         }
     }
+    /**
+     * Starts the internal setTimeout with the specified delay.
+     * @param {number} delay - The duration in milliseconds for the timeout.
+     */
     startTimer(delay) {
         this.running = true;
         this.timer = setTimeout(() => this.ring(), delay);
     }
+    /**
+     * Internal handler triggered when the timeout fires.
+     * Verifies if the target end time has genuinely passed, rescheduling if necessary,
+     * or executes the action.
+     */
     ring() {
         const timeLeft = this.end - Date.now();
         // check if delay has passed, else execute action
@@ -27,12 +52,19 @@ export class Timer {
         this.running = false;
         this.action();
     }
+    /**
+     * Resets the timer, recalculating the end time and restarting the countdown.
+     * If the timer is already running, it updates the target end time.
+     */
     reset() {
         this.end = Date.now() + this.delay;
         if (!this.running) {
             this.startTimer(this.delay);
         }
     }
+    /**
+     * Cancels the active timeout and stops the timer from running.
+     */
     clear() {
         clearTimeout(this.timer);
         this.running = false;

package/dist/timer/timer.js.map

@@ -1 +1 @@
-{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../timer/timer.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,KAAK;IACP,KAAK,CAAS,CAAC,wBAAwB;IAChD,6BAA6B;IACrB,MAAM,CAAW,CAAC,yCAAyC;IAC3D,KAAK,CAAiC;IACtC,GAAG,GAAG,CAAC,CAAC;IACR,OAAO,GAAG,KAAK,CAAC;IAExB,6BAA6B;IAC7B,YAAY,MAAgB,EAAE,KAAa,EAAE,IAAI,GAAG,KAAK;QACvD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAEO,UAAU,CAAC,KAAa;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAEO,IAAI;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,iDAAiD;QACjD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,KAAK;QACH,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;CACF"}
+{"version":3,"file":"timer.js","sourceRoot":"","sources":["../../timer/timer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,KAAK;IAChB,mEAAmE;IAC1D,KAAK,CAAS,CAAC,wBAAwB;IAEhD,+DAA+D;IAC/D,6BAA6B;IACrB,MAAM,CAAW,CAAC,yCAAyC;IAEnE,uEAAuE;IAC/D,KAAK,CAAiC;IAE9C,qFAAqF;IAC7E,GAAG,GAAG,CAAC,CAAC;IAEhB,mEAAmE;IAC3D,OAAO,GAAG,KAAK,CAAC;IAExB;;;;;OAKG;IACH,6BAA6B;IAC7B,YAAY,MAAgB,EAAE,KAAa,EAAE,IAAI,GAAG,KAAK;QACvD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,UAAU,CAAC,KAAa;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACK,IAAI;QACV,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvC,iDAAiD;QACjD,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,KAAK;QACH,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;IACvB,CAAC;CACF"}

package/dist/trie/trie.d.ts

@@ -3,7 +3,7 @@
  * @description A Trie data structure implementation that supports wildcard matching
  * @template T The type of values stored in the trie
  */
-type Parts = string[];
+export type Parts = string[];
 /**
  * Trie class for storing and matching hierarchical key-value pairs with wildcard support
  * @template T The type of values stored in the trie
@@ -62,7 +62,12 @@ export declare class Trie<T> {
      * @param key The key to remove the value from
      * @param value The value to remove
      */
-    remove(key: string, value: T): void;
+    /**
+     * Removes a value from the trie at the specified key
+     * @param key The key to remove the value from
+     * @param value The value (or partial object) to remove
+     */
+    remove(key: string, value: Partial<T> | T): void;
     /**
      * Internal method to recursively remove a value
      * @param parts Parts of the key to remove from
@@ -71,10 +76,10 @@ export declare class Trie<T> {
     private _remove;
     /**
      * Creates a filter function for removing values
-     * @param value The value to filter against
-     * @returns Filter function
+     * Supports partial object matching when looseCompare is enabled or when matching objects.
+     * @param value The value (or partial value) to filter against
+     * @returns Filter function (returns true to KEEP the item, false to REMOVE it)
      */
     private filter;
 }
-export {};
 //# sourceMappingURL=trie.d.ts.map

package/dist/trie/trie.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trie.d.ts","sourceRoot":"","sources":["../../trie/trie.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,KAAK,KAAK,GAAG,MAAM,EAAE,CAAC;AAEtB;;;GAGG;AACH,qBAAa,IAAI,CAAC,CAAC;;IAGjB,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,WAAW,CAAO;IAC1B,OAAO,CAAC,eAAe,CAAO;IAC9B,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,YAAY,CAAU;IAE9B;;;OAGG;gBACS,YAAY,UAAQ;IAMhC;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;IAKjD;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE;IAQvB;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAWpB;;;;OAIG;IACH,OAAO,CAAC,MAAM;IAed;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIhC;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAmBZ;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAInC;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAkBf;;;;OAIG;IACH,OAAO,CAAC,MAAM;CAaf"}
+{"version":3,"file":"trie.d.ts","sourceRoot":"","sources":["../../trie/trie.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC;AAE7B;;;GAGG;AACH,qBAAa,IAAI,CAAC,CAAC;;IAGjB,OAAO,CAAC,SAAS,CAAO;IACxB,OAAO,CAAC,WAAW,CAAO;IAC1B,OAAO,CAAC,eAAe,CAAO;IAC9B,OAAO,CAAC,cAAc,CAAO;IAC7B,OAAO,CAAC,YAAY,CAAU;IAE9B;;;OAGG;IACH,YAAY,YAAY,UAAQ,EAI/B;IAED;;;;;OAKG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAGhD;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,EAAE,CAMtB;IAED;;;;OAIG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;OAIG;IACH,OAAO,CAAC,MAAM;IA4Bd;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAE/B;IAED;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAkBZ;;;;OAIG;IACH;;;;OAIG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,IAAI,CAE/C;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAO;IAkBf;;;;;OAKG;IACH,OAAO,CAAC,MAAM;CAuBf"}