@seriousme/opifex 1.11.3 → 2.1.0

package/dist/trie/trie.js

@@ -47,14 +47,11 @@ export class Trie {
      * @returns Array of matched values
      */
     _matchPrefix(parts) {
-        if (parts.length === 0) {
-            return this.#value ? this.#value : [];
-        }
         const [first, ...rest] = parts;
-        if (first !== undefined) {
-            return this.matchChild(first, rest);
-        }
-        return [];
+        if (first === undefined)
+            return [];
+        // Direct lookup on the reserved topic node without evaluating top-level + or #
+        return this.matchChild(first, rest);
     }
     /**
      * Internal method to match keys with wildcard support
@@ -62,18 +59,26 @@ export class Trie {
      * @returns Array of matched values
      */
     _match(parts) {
+        let results = [];
+        // 1. Check if there is a multi-level wildcard ('#') at this level.
+        // In MQTT, 'a/#' matches 'a', 'a/b', 'a/b/c', etc.
+        const subtreeNode = this.#children.get(this.wildcardSubtree);
+        if (subtreeNode) {
+            results = results.concat(subtreeNode.#value);
+        }
+        // 2. Base case: we reached the end of the topic parts.
         if (parts.length === 0) {
-            return this.#value ? this.#value : [];
+            return results.concat(this.#value);
         }
         const [first, ...rest] = parts;
-        if (first !== undefined) {
-            const exact = this.matchChild(first, rest);
-            const single = this.matchChild(this.wildcardOne, rest);
-            const subtree = this.matchChild(this.wildcardSubtree, []);
-            const results = exact.concat(single, subtree);
-            return results;
-        }
-        return [];
+        // deno-coverage-ignore
+        if (first === undefined)
+            return [];
+        // 3. Exact matching child node
+        const exact = this.matchChild(first, rest);
+        // 4. Single-level wildcard ('+') matching child node
+        const single = this.matchChild(this.wildcardOne, rest);
+        return results.concat(exact, single);
     }
     /**
      * Adds a value to the trie at the specified key
@@ -94,24 +99,29 @@ export class Trie {
             return;
         }
         const [first, ...rest] = parts;
-        if (first !== undefined) {
-            const child = this.#children.get(first);
-            if (child instanceof Trie) {
-                child._add(rest, value);
-            }
-            else {
-                const node = new Trie(this.looseCompare);
-                this.#children.set(first, node);
-                node._add(rest, value);
-            }
+        // deno-coverage-ignore
+        if (first === undefined)
+            return;
+        const child = this.#children.get(first);
+        if (child instanceof Trie) {
+            child._add(rest, value);
+        }
+        else {
+            const node = new Trie(this.looseCompare);
+            this.#children.set(first, node);
+            node._add(rest, value);
         }
-        return;
     }
     /**
      * Removes a value from the trie at the specified key
      * @param key The key to remove the value from
      * @param value The value to remove
      */
+    /**
+     * 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, value) {
         return this._remove(key.split(this.separator), value);
     }
@@ -122,37 +132,47 @@ export class Trie {
      */
     _remove(parts, value) {
         if (parts.length === 0) {
-            const arr = this.#value || [];
+            const arr = this.#value;
             this.#value = arr.filter(this.filter(value));
             return;
         }
         const [first, ...rest] = parts;
-        if (first !== undefined) {
-            const node = this.#children.get(first);
-            if (node) {
-                node._remove(rest, value);
-                if (node.#value.length === 0 && this.#children.size === 0) {
-                    this.#children.delete(first);
-                }
+        // deno-coverage-ignore
+        if (first === undefined)
+            return;
+        const node = this.#children.get(first);
+        if (node) {
+            node._remove(rest, value);
+            if (node.#value.length === 0 && node.#children.size === 0) {
+                this.#children.delete(first);
             }
         }
     }
     /**
      * 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)
      */
     filter(value) {
-        if (this.looseCompare && typeof value === "object") {
+        if (typeof value === "object" && value !== null) {
             return (item) => {
+                if (typeof item !== "object" || item === null) {
+                    return true; // Keep if the stored item isn't an object but we are filtering by one
+                }
+                // Check if every key-value pair in our filter object matches the stored item
                 for (const key in value) {
-                    if (value[key] !== item[key]) {
-                        return true;
+                    if (Object.prototype.hasOwnProperty.call(value, key)) {
+                        // If the stored item has a different value (or doesn't have the key), it's not a match
+                        if (item[key] !== value[key]) {
+                            return true; // Keep the item (no match)
+                        }
                     }
                 }
-                return false;
+                return false; // Remove the item (it matches all criteria in the partial object)
             };
         }
+        // Fallback for primitives
         return (item) => item !== value;
     }
 }

package/dist/trie/trie.js.map

@@ -1 +1 @@
-{"version":3,"file":"trie.js","sourceRoot":"","sources":["../../trie/trie.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trie.js","sourceRoot":"","sources":["../../trie/trie.ts"],"names":[],"mappings":"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"}

package/dist/utils/assert.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../utils/assert.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IACvC,iCAAiC;gBACrB,OAAO,EAAE,MAAM;CAI5B;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAI5D"}
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../utils/assert.ts"],"names":[],"mappings":"AAAA,qBAAa,cAAe,SAAQ,KAAK;IACvC,iCAAiC;IACjC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,SAAK,GAAG,OAAO,CAAC,IAAI,CAI5D"}

package/dist/utils/{BufferedAsyncIterable.d.ts → bufferedAsyncIterable.d.ts}

@@ -23,4 +23,4 @@ export declare class BufferedAsyncIterable<T> implements AsyncIterable<T> {
     readonly push: (item: T) => void | Promise<void>;
     get isDone(): boolean;
 }
-//# sourceMappingURL=BufferedAsyncIterable.d.ts.map
+//# sourceMappingURL=bufferedAsyncIterable.d.ts.map

package/dist/utils/bufferedAsyncIterable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bufferedAsyncIterable.d.ts","sourceRoot":"","sources":["../../utils/bufferedAsyncIterable.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAqB,CAAC,CAAC,CAAE,YAAW,aAAa,CAAC,CAAC,CAAC;;IAC/D,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,UAAU,CAAS;IAE3B,OAAO,CAAC,IAAI,CAAS;IAIrB,YAAY,UAAU,GAAE,MAAa,EAGpC;IAEM,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAIzE;IAED,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUrB;IAED,KAAK,CAAC,MAAM,SAAW,GAAG,IAAI,CAK7B;IAED,QAAQ,CAAC,IAAI,SAAU,CAAC,KAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB7C;IAEF,IAAI,MAAM,IAAI,OAAO,CAEpB;CACF"}

package/dist/utils/{BufferedAsyncIterable.js → bufferedAsyncIterable.js}

@@ -67,4 +67,4 @@ export class BufferedAsyncIterable {
         return this.done;
     }
 }
-//# sourceMappingURL=BufferedAsyncIterable.js.map
+//# sourceMappingURL=bufferedAsyncIterable.js.map

package/dist/utils/bufferedAsyncIterable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bufferedAsyncIterable.js","sourceRoot":"","sources":["../../utils/bufferedAsyncIterable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAAgB;IACtB,UAAU,CAAS;IAEnB,IAAI,GAAG,KAAK,CAAC;IAErB,KAAK,CAA2B;IAEhC,YAAY,UAAU,GAAW,IAAI;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QACpB,CAAC;IACH,CAAC;IAED,IAAI;QACF,oBAAoB;QACpB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,EAAG,CAAC;QAChC,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC5B,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,EAAK,CAAC;QACjC,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,MAAM,GAAG,QAAQ;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAEQ,IAAI,GAAG,CAAC,IAAO,EAAwB,EAAE;QAChD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YACzC,8EAA8E;YAC9E,6EAA6E;YAC7E,6EAA6E;YAC7E,2EAA2E;YAC3E,+EAA+E;YAC/E,oCAAoC;YACpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC,CAAC;IAEF,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/utils/deferred.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deferred.d.ts","sourceRoot":"","sources":["../../utils/deferred.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAG,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3B,MAAM,EAAG,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;;CAQ/B"}
+{"version":3,"file":"deferred.d.ts","sourceRoot":"","sources":["../../utils/deferred.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,QAAQ,CAAC,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAG,CAAC,GAAG,EAAE,CAAC,KAAK,IAAI,CAAC;IAC3B,MAAM,EAAG,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAE9B,cAKC;CACF"}

package/dist/utils/deferred.js.map

@@ -1 +1 @@
-{"version":3,"file":"deferred.js","sourceRoot":"","sources":["../../utils/deferred.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,OAAO,QAAQ;IACnB,OAAO,CAAa;IACpB,OAAO,CAAoB;IAC3B,MAAM,CAAwB;IAE9B;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"deferred.js","sourceRoot":"","sources":["../../utils/deferred.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,QAAQ;IACnB,OAAO,CAAa;IACpB,OAAO,CAAoB;IAC3B,MAAM,CAAwB;IAE9B;QACE,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC7C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/utils/getOrInsertPolyFill.d.ts

@@ -0,0 +1,2 @@
+export declare function getOrInsert<K, V>(map: Map<K, V>, key: K, defaultValue: V): V;
+//# sourceMappingURL=getOrInsertPolyFill.d.ts.map

package/dist/utils/getOrInsertPolyFill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrInsertPolyFill.d.ts","sourceRoot":"","sources":["../../utils/getOrInsertPolyFill.ts"],"names":[],"mappings":"AAKA,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAM5E"}

package/dist/utils/getOrInsertPolyFill.js

@@ -0,0 +1,12 @@
+/*
+ Node 26 has getOrInsert by default.
+ This is a polyfill for older versions
+ */
+export function getOrInsert(map, key, defaultValue) {
+    if (map.has(key)) {
+        return map.get(key);
+    }
+    map.set(key, defaultValue);
+    return defaultValue;
+}
+//# sourceMappingURL=getOrInsertPolyFill.js.map

package/dist/utils/getOrInsertPolyFill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getOrInsertPolyFill.js","sourceRoot":"","sources":["../../utils/getOrInsertPolyFill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,WAAW,CAAO,GAAc,EAAE,GAAM,EAAE,YAAe;IACvE,IAAI,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACjB,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACvB,CAAC;IACD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAC3B,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/utils/logger.d.ts

@@ -1,16 +1,26 @@
 /**
- * The available log levels
+ * The available log levels used to filter messages.
  */
 export declare const LogLevel: {
+    /** Crucial application errors or failures. */
     readonly error: 0;
+    /** Non-fatal warnings that indicate unexpected behavior. */
     readonly warn: 1;
+    /** Informational statements highlighting general operational flow. */
     readonly info: 2;
+    /** Detailed tracing and comprehensive runtime statements. */
     readonly verbose: 3;
+    /** High-density internal troubleshooting logs. */
     readonly debug: 4;
 };
-export type TLogLevel = typeof LogLevel[keyof typeof LogLevel];
 /**
- * Simple logger class
+ * Union type representing the permitted numeric log level indices.
+ */
+export type LogLevel = typeof LogLevel[keyof typeof LogLevel];
+/**
+ * Simple logger class providing level-configurable output routing.
+ * @class Logger
+ *
  * @example
  * ```ts
  * const logger = new Logger();
@@ -23,21 +33,48 @@ export type TLogLevel = typeof LogLevel[keyof typeof LogLevel];
  * ```
  */
 export declare class Logger {
+    /** Native console reference used to output critical errors. */
     private defaultError;
+    /** Native console reference used to output warning flags. */
     private defaultWarn;
+    /** Native console reference used to output standard runtime indicators. */
     private defaultInfo;
+    /** Native console reference used to track granular metrics and details. */
     private defaultVerbose;
+    /** Native console reference used to step through highly specific operations. */
     private defaultDebug;
+    /** Flag indicating if error messages should be logged. */
+    isError: boolean;
+    /** Flag indicating if warning messages should be logged. */
+    isWarn: boolean;
+    /** Flag indicating if informational messages should be logged. */
+    isInfo: boolean;
+    /** Flag indicating if verbose messages should be logged. */
+    isVerbose: boolean;
+    /** Flag indicating if debug messages should be logged. */
+    isDebug: boolean;
+    /** Log an error message to the standard error stream. */
     error: typeof console.log;
+    /** Log a warning message if the active log level permits. */
     warn: typeof console.log;
+    /** Log an informational status update if the active log level permits. */
     info: typeof console.log;
+    /** Log extended telemetry notes if the active log level permits. */
     verbose: typeof console.log;
+    /** Log debug parameters and objects if the active log level permits. */
     debug: typeof console.log;
+    /** Creates a wrapper function that evaluates lazy log arguments before invoking the target logging function. */
+    private createLogFn;
+    /** Create a new Logger instance. */
     constructor();
-    level(logLevel: TLogLevel): void;
+    /**
+     * Adjusts the current verbosity threshold, enabling or masking specific log outputs.
+     * @param {LogLevel} logLevel - The minimum numeric severity level threshold to output.
+     */
+    level(logLevel: LogLevel): void;
 }
 /**
- * logger provides a singleton logger instance
+ * Provides a single pre-configured global logger instance.
  * @example
  * ```ts
  * import { logger } from "./utils/logger.ts";

package/dist/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../utils/logger.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;CAMX,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAE/D;;;;;;;;;;;;GAYG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,YAAY,CAAiB;IACrC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,cAAc,CAAe;IACrC,OAAO,CAAC,YAAY,CAAe;IAEnC,KAAK,EAAE,OAAO,OAAO,CAAC,GAAG,CAAqB;IAC9C,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAoB;IAC5C,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAoB;IAC5C,OAAO,EAAE,OAAO,OAAO,CAAC,GAAG,CAAQ;IACnC,KAAK,EAAE,OAAO,OAAO,CAAC,GAAG,CAAQ;;IAIjC,KAAK,CAAC,QAAQ,EAAE,SAAS;CAM1B;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,EAAE,MAAqB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../utils/logger.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,eAAO,MAAM,QAAQ;IACnB,8CAA8C;aAC9C,KAAK,EAAE,CAAC;IACR,4DAA4D;aAC5D,IAAI,EAAE,CAAC;IACP,sEAAsE;aACtE,IAAI,EAAE,CAAC;IACP,6DAA6D;aAC7D,OAAO,EAAE,CAAC;IACV,kDAAkD;aAClD,KAAK,EAAE,CAAC;CACA,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAI9D;;;;;;;;;;;;;;GAcG;AACH,qBAAa,MAAM;IACjB,+DAA+D;IAC/D,OAAO,CAAC,YAAY,CAAiB;IACrC,6DAA6D;IAC7D,OAAO,CAAC,WAAW,CAAgB;IACnC,2EAA2E;IAC3E,OAAO,CAAC,WAAW,CAAgB;IACnC,2EAA2E;IAC3E,OAAO,CAAC,cAAc,CAAe;IACrC,gFAAgF;IAChF,OAAO,CAAC,YAAY,CAAe;IAEnC,0DAA0D;IAC1D,OAAO,UAAQ;IACf,4DAA4D;IAC5D,MAAM,UAAQ;IACd,kEAAkE;IAClE,MAAM,UAAQ;IACd,4DAA4D;IAC5D,SAAS,UAAS;IAClB,0DAA0D;IAC1D,OAAO,UAAS;IAEhB,yDAAyD;IACzD,KAAK,EAAE,OAAO,OAAO,CAAC,GAAG,CAAqB;IAC9C,6DAA6D;IAC7D,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAoB;IAC5C,0EAA0E;IAC1E,IAAI,EAAE,OAAO,OAAO,CAAC,GAAG,CAAoB;IAC5C,oEAAoE;IACpE,OAAO,EAAE,OAAO,OAAO,CAAC,GAAG,CAAQ;IACnC,wEAAwE;IACxE,KAAK,EAAE,OAAO,OAAO,CAAC,GAAG,CAAQ;IAEjC,gHAAgH;IAEhH,OAAO,CAAC,WAAW;IASnB,oCAAoC;IACpC,cAAgB;IAEhB;;;OAGG;IACH,KAAK,CAAC,QAAQ,EAAE,QAAQ,QAWvB;CACF;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,EAAE,MAAqB,CAAC"}

package/dist/utils/logger.js

@@ -1,16 +1,23 @@
 import { noop } from "./utils.js";
 /**
- * The available log levels
+ * The available log levels used to filter messages.
  */
 export const LogLevel = {
+    /** Crucial application errors or failures. */
     error: 0,
+    /** Non-fatal warnings that indicate unexpected behavior. */
     warn: 1,
+    /** Informational statements highlighting general operational flow. */
     info: 2,
+    /** Detailed tracing and comprehensive runtime statements. */
     verbose: 3,
+    /** High-density internal troubleshooting logs. */
     debug: 4,
 };
 /**
- * Simple logger class
+ * Simple logger class providing level-configurable output routing.
+ * @class Logger
+ *
  * @example
  * ```ts
  * const logger = new Logger();
@@ -23,26 +30,65 @@ export const LogLevel = {
  * ```
  */
 export class Logger {
+    /** Native console reference used to output critical errors. */
     defaultError = console.error;
+    /** Native console reference used to output warning flags. */
     defaultWarn = console.warn;
+    /** Native console reference used to output standard runtime indicators. */
     defaultInfo = console.info;
+    /** Native console reference used to track granular metrics and details. */
     defaultVerbose = console.log;
+    /** Native console reference used to step through highly specific operations. */
     defaultDebug = console.log;
+    /** Flag indicating if error messages should be logged. */
+    isError = true;
+    /** Flag indicating if warning messages should be logged. */
+    isWarn = true;
+    /** Flag indicating if informational messages should be logged. */
+    isInfo = true;
+    /** Flag indicating if verbose messages should be logged. */
+    isVerbose = false;
+    /** Flag indicating if debug messages should be logged. */
+    isDebug = false;
+    /** Log an error message to the standard error stream. */
     error = this.defaultError;
+    /** Log a warning message if the active log level permits. */
     warn = this.defaultWarn;
+    /** Log an informational status update if the active log level permits. */
     info = this.defaultInfo;
+    /** Log extended telemetry notes if the active log level permits. */
     verbose = noop;
+    /** Log debug parameters and objects if the active log level permits. */
     debug = noop;
+    /** Creates a wrapper function that evaluates lazy log arguments before invoking the target logging function. */
+    // deno-lint-ignore no-explicit-any
+    createLogFn(targetFn) {
+        return (...args) => {
+            const evaluated = args.map((arg) => (typeof arg === "function" ? arg() : arg));
+            targetFn(...evaluated);
+        };
+    }
+    /** Create a new Logger instance. */
     constructor() { }
+    /**
+     * Adjusts the current verbosity threshold, enabling or masking specific log outputs.
+     * @param {LogLevel} logLevel - The minimum numeric severity level threshold to output.
+     */
     level(logLevel) {
-        this.warn = logLevel > 0 ? this.defaultWarn : noop;
-        this.info = logLevel > 1 ? this.defaultInfo : noop;
-        this.verbose = logLevel > 2 ? this.defaultVerbose : noop;
-        this.debug = logLevel > 3 ? this.defaultDebug : noop;
+        this.isWarn = logLevel >= LogLevel.warn;
+        this.isInfo = logLevel >= LogLevel.info;
+        this.isVerbose = logLevel >= LogLevel.verbose;
+        this.isDebug = logLevel >= LogLevel.debug;
+        this.warn = this.isWarn ? this.createLogFn(this.defaultWarn) : noop;
+        this.info = this.isInfo ? this.createLogFn(this.defaultInfo) : noop;
+        this.verbose = this.isVerbose
+            ? this.createLogFn(this.defaultVerbose)
+            : noop;
+        this.debug = this.isDebug ? this.createLogFn(this.defaultDebug) : noop;
     }
 }
 /**
- * logger provides a singleton logger instance
+ * Provides a single pre-configured global logger instance.
  * @example
  * ```ts
  * import { logger } from "./utils/logger.ts";

package/dist/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;CACA,CAAC;AAIX;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,MAAM;IACT,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;IAC7B,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;IAC7B,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC;IAEnC,KAAK,GAAuB,IAAI,CAAC,YAAY,CAAC;IAC9C,IAAI,GAAuB,IAAI,CAAC,WAAW,CAAC;IAC5C,IAAI,GAAuB,IAAI,CAAC,WAAW,CAAC;IAC5C,OAAO,GAAuB,IAAI,CAAC;IACnC,KAAK,GAAuB,IAAI,CAAC;IAEjC,gBAAe,CAAC;IAEhB,KAAK,CAAC,QAAmB;QACvB,IAAI,CAAC,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QACnD,IAAI,CAAC,OAAO,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC;QACzD,IAAI,CAAC,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,MAAM,GAAW,IAAI,MAAM,EAAE,CAAC"}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../utils/logger.ts"],"names":[],"mappings":"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"}

package/dist/utils/mod.d.ts

@@ -5,5 +5,10 @@
 export { assert } from "./assert.ts";
 export { Deferred } from "./deferred.ts";
 export { Logger, logger, LogLevel } from "./logger.ts";
-export { BufferedAsyncIterable } from "./BufferedAsyncIterable.ts";
+export { BufferedAsyncIterable } from "./bufferedAsyncIterable.ts";
+export { joinTopicFilter, parseTopicFilter, topicFilterToRegExp, } from "./topicFilter.ts";
+export { OutboundTopicAliasManager } from "./outboundTopicAliasManager.ts";
+export type { OutboundTopicAlias } from "./outboundTopicAliasManager.ts";
+export { hasWildcards, invalidmaxTopicLevels, invalidTopic, invalidTopicFilter, } from "./validators.ts";
+export { delay, noop } from "./utils.ts";
 //# sourceMappingURL=mod.d.ts.map

package/dist/utils/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../utils/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../utils/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACzE,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/mod.js

@@ -5,5 +5,9 @@
 export { assert } from "./assert.js";
 export { Deferred } from "./deferred.js";
 export { Logger, logger, LogLevel } from "./logger.js";
-export { BufferedAsyncIterable } from "./BufferedAsyncIterable.js";
+export { BufferedAsyncIterable } from "./bufferedAsyncIterable.js";
+export { joinTopicFilter, parseTopicFilter, topicFilterToRegExp, } from "./topicFilter.js";
+export { OutboundTopicAliasManager } from "./outboundTopicAliasManager.js";
+export { hasWildcards, invalidmaxTopicLevels, invalidTopic, invalidTopicFilter, } from "./validators.js";
+export { delay, noop } from "./utils.js";
 //# sourceMappingURL=mod.js.map

package/dist/utils/mod.js.map

@@ -1 +1 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../utils/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../utils/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAE3E,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC"}

package/dist/utils/outboundTopicAliasManager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Represents the result of processing an outbound topic name,
+ * containing either the original topic name, a topic alias integer, or both.
+ */
+export interface OutboundTopicAlias {
+    /**
+     * The topic name.
+     * Will be empty (`""`) when a valid alias mapping has already been established.
+     */
+    topicName: string;
+    /**
+     * The numeric alias assigned to the topic, if aliases are enabled.
+     */
+    topicAlias?: number;
+}
+/**
+ * Manages outbound MQTT topic aliases using a Least Recently Used (LRU) caching strategy.
+ */
+export declare class OutboundTopicAliasManager {
+    /**
+     * The maximum number of topic aliases supported by the broker/client.
+     */
+    private readonly maxAliases;
+    /**
+     * Internal mapping from topic names to assigned aliases.
+     * Leverages JavaScript's Map insertion-order behavior to act as an LRU cache.
+     */
+    private readonly topicToAlias;
+    /**
+     * Creates an instance of `OutboundTopicAliasManager`.
+     *
+     * @param clientTopicAliasMaximum - The maximum number of topic aliases allowed (defaults to `0`, meaning disabled).
+     */
+    constructor(clientTopicAliasMaximum?: number);
+    /**
+     * Processes an outbound topic name and returns the appropriate payload metadata
+     * (`OutboundTopcAlias`) based on alias availability and caching state.
+     *
+     * - If aliases are disabled (`maxAliases === 0`), returns only the original `topicName`.
+     * - If the topic is already cached (cache hit), refreshes its LRU position and returns the `topicAlias` with an empty `topicName`.
+     * - If the topic is not cached (cache miss), assigns a new alias or evicts the least recently used topic alias mapping.
+     *
+     * @param topic - The outbound MQTT topic name to process.
+     * @returns An object containing the formatted `topicName` and optional `topicAlias`.
+     */
+    processTopic(topic: string): OutboundTopicAlias;
+    /**
+     * Clears all internal topic alias mappings and releases cached resources.
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=outboundTopicAliasManager.d.ts.map

package/dist/utils/outboundTopicAliasManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outboundTopicAliasManager.d.ts","sourceRoot":"","sources":["../../utils/outboundTopicAliasManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAsB;IAEnD;;;;OAIG;IACH,YAAY,uBAAuB,GAAE,MAAU,EAG9C;IAED;;;;;;;;;;OAUG;IACI,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAsCrD;IAED;;OAEG;IACI,OAAO,IAAI,IAAI,CAErB;CACF"}

package/dist/utils/outboundTopicAliasManager.js

@@ -0,0 +1,74 @@
+/**
+ * Manages outbound MQTT topic aliases using a Least Recently Used (LRU) caching strategy.
+ */
+export class OutboundTopicAliasManager {
+    /**
+     * The maximum number of topic aliases supported by the broker/client.
+     */
+    maxAliases;
+    /**
+     * Internal mapping from topic names to assigned aliases.
+     * Leverages JavaScript's Map insertion-order behavior to act as an LRU cache.
+     */
+    topicToAlias;
+    /**
+     * Creates an instance of `OutboundTopicAliasManager`.
+     *
+     * @param clientTopicAliasMaximum - The maximum number of topic aliases allowed (defaults to `0`, meaning disabled).
+     */
+    constructor(clientTopicAliasMaximum = 0) {
+        this.maxAliases = clientTopicAliasMaximum;
+        this.topicToAlias = new Map();
+    }
+    /**
+     * Processes an outbound topic name and returns the appropriate payload metadata
+     * (`OutboundTopcAlias`) based on alias availability and caching state.
+     *
+     * - If aliases are disabled (`maxAliases === 0`), returns only the original `topicName`.
+     * - If the topic is already cached (cache hit), refreshes its LRU position and returns the `topicAlias` with an empty `topicName`.
+     * - If the topic is not cached (cache miss), assigns a new alias or evicts the least recently used topic alias mapping.
+     *
+     * @param topic - The outbound MQTT topic name to process.
+     * @returns An object containing the formatted `topicName` and optional `topicAlias`.
+     */
+    processTopic(topic) {
+        if (this.maxAliases === 0) {
+            return { topicName: topic };
+        }
+        // Cache Hit -> Refresh LRU-position in Map
+        if (this.topicToAlias.has(topic)) {
+            const alias = this.topicToAlias.get(topic);
+            this.topicToAlias.delete(topic);
+            this.topicToAlias.set(topic, alias);
+            return {
+                topicName: "",
+                topicAlias: alias,
+            };
+        }
+        // Cache Miss
+        let assignedAlias;
+        if (this.topicToAlias.size < this.maxAliases) {
+            // While there is space, simply assign the next alias (1, 2, 3...)
+            assignedAlias = this.topicToAlias.size + 1;
+        }
+        else {
+            // Cache full: reuse the alias of the least used topic (first key in the Map)
+            const lruTopic = this.topicToAlias.keys().next().value;
+            assignedAlias = this.topicToAlias.get(lruTopic);
+            this.topicToAlias.delete(lruTopic);
+        }
+        // Store the new topic
+        this.topicToAlias.set(topic, assignedAlias);
+        return {
+            topicName: topic,
+            topicAlias: assignedAlias,
+        };
+    }
+    /**
+     * Clears all internal topic alias mappings and releases cached resources.
+     */
+    destroy() {
+        this.topicToAlias.clear();
+    }
+}
+//# sourceMappingURL=outboundTopicAliasManager.js.map

package/dist/utils/outboundTopicAliasManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outboundTopicAliasManager.js","sourceRoot":"","sources":["../../utils/outboundTopicAliasManager.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,OAAO,yBAAyB;IACpC;;OAEG;IACc,UAAU,CAAS;IAEpC;;;OAGG;IACc,YAAY,CAAsB;IAEnD;;;;OAIG;IACH,YAAY,uBAAuB,GAAW,CAAC;QAC7C,IAAI,CAAC,UAAU,GAAG,uBAAuB,CAAC;QAC1C,IAAI,CAAC,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC;IAChC,CAAC;IAED;;;;;;;;;;OAUG;IACI,YAAY,CAAC,KAAa;QAC/B,IAAI,IAAI,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;QAC9B,CAAC;QAED,2CAA2C;QAC3C,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;YAC5C,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;YAEpC,OAAO;gBACL,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,KAAK;aAClB,CAAC;QACJ,CAAC;QAED,aAAa;QACb,IAAI,aAAqB,CAAC;QAE1B,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;YAC7C,kEAAkE;YAClE,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,6EAA6E;YAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC;YACvD,aAAa,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,QAAS,CAAE,CAAC;YAElD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,QAAS,CAAC,CAAC;QACtC,CAAC;QAED,sBAAsB;QACtB,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAE5C,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,UAAU,EAAE,aAAa;SAC1B,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,OAAO;QACZ,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/utils/queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../utils/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,SAAS,CAAa;IAE9B;;;OAGG;IACI,IAAI,IAAI,MAAM;IAGrB;;;OAGG;IACI,OAAO,IAAI,OAAO;IAGzB;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;IAG7B;;;;OAIG;IACI,OAAO,IAAI,CAAC,GAAG,SAAS;CAiBhC"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../utils/queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,qBAAa,UAAU,CAAC,CAAC;IACvB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,SAAS,CAAa;IAE9B;;;OAGG;IACI,IAAI,IAAI,MAAM,CAEpB;IACD;;;OAGG;IACI,OAAO,IAAI,OAAO,CAExB;IACD;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAE5B;IACD;;;;OAIG;IACI,OAAO,IAAI,CAAC,GAAG,SAAS,CAgB9B;CACF"}