@seriousme/opifex 2.2.0 → 2.3.0

package/dist/server/deps.d.ts

@@ -1,4 +1,4 @@
-export type { SockAddr, SockConn } from "../socket/socket.ts";
+export type { ConnAddr, ConnNext } from "../connNext/connNext.ts";
 export { MqttConn } from "../mqttConn/mqttConn.ts";
 export type { ClientSubscription, ExtPublishPacket, Persistence, ShareName, } from "../persistence/persistence.ts";
 export { MemoryPersistence } from "../persistence/memory/memoryPersistence.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../server/deps.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,SAAS,GACV,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,GAAG,EACH,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,KAAK,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,MAAM,EACN,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"deps.d.ts","sourceRoot":"","sources":["../../server/deps.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACnD,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,WAAW,EACX,SAAS,GACV,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,YAAY,EACV,SAAS,EACT,UAAU,EACV,QAAQ,EACR,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,GAAG,EACH,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,cAAc,EACd,KAAK,EACL,WAAW,EACX,cAAc,EACd,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,oBAAoB,EACpB,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,UAAU,GACX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EACL,MAAM,EACN,YAAY,EACZ,qBAAqB,EACrB,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,MAAM,EACN,QAAQ,EACR,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,iBAAiB,CAAC"}

package/dist/server/mod.d.ts

@@ -3,7 +3,7 @@
  *  @module
  */
 export { ReasonCode } from "./deps.ts";
-export type { ConnectPacket, Persistence, ShareName, SockConn, Topic, } from "./deps.ts";
+export type { ConnectPacket, ConnNext, Persistence, ShareName, Topic, } from "./deps.ts";
 export { MqttServer } from "./server.ts";
 export type { MqttServerOptions } from "./server.ts";
 export { Context } from "./context.ts";

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../server/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAQ,EACR,KAAK,GACN,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../server/mod.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EACV,aAAa,EACb,QAAQ,EACR,WAAW,EACX,SAAS,EACT,KAAK,GACN,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC"}

package/dist/server/server.d.ts

@@ -1,5 +1,5 @@
 import type { Handlers } from "./context.ts";
-import type { Persistence, SockConn } from "./deps.ts";
+import type { ConnNext, Persistence } from "./deps.ts";
 import type { Configuration, ConfigurationInput } from "./config.ts";
 /**
  * Configuration options for creating an MqttServer instance.
@@ -37,10 +37,10 @@ export declare class MqttServer {
     constructor({ persistence, handlers, configuration, }: MqttServerOptions);
     /**
      * Serve a new client connection.
-     * @param {SockConn} conn - The socket connection to serve.
+     * @param conn - The socket connection to serve.
      * @returns {Promise<void>} A promise that resolves when the connection is closed.
      */
-    serve(conn: SockConn): Promise<void>;
+    serve(conn: ConnNext): Promise<void>;
     /**
      * Close the server and all active client connections.
      * @param {boolean} cleanUp - If true, clean up client sessions on close.

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,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"}
+{"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,QAAQ,EAAE,WAAW,EAAoB,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

@@ -4,8 +4,8 @@ import { handlePacket } from "./handlers/handlePacket.js";
 import { createConfiguration } from "./config.js";
 /**
  * Default preconnect handler that unconditionally permits all connections.
- * @param {SockConn} _conn - The connection.
- * @returns {boolean} Always returns true
+ * @param  _conn - The connection.
+ * @returns  Always returns true
  */
 const defaultPreconnect = (_conn) => (true);
 /**
@@ -73,7 +73,7 @@ export class MqttServer {
     }
     /**
      * Serve a new client connection.
-     * @param {SockConn} conn - The socket connection to serve.
+     * @param conn - The socket connection to serve.
      * @returns {Promise<void>} A promise that resolves when the connection is closed.
      */
     async serve(conn) {

package/dist/utils/utils.d.ts

@@ -1,4 +1,3 @@
-import { setTimeout as delay } from "node:timers/promises";
-export { delay };
+export declare function delay(ms: number): Promise<void>;
 export declare const noop: () => void;
 //# sourceMappingURL=utils.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../utils/utils.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,eAAO,MAAM,IAAI,YAAW,CAAC"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../utils/utils.ts"],"names":[],"mappings":"AAKA,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED,eAAO,MAAM,IAAI,YAAW,CAAC"}

package/dist/utils/utils.js

@@ -2,7 +2,8 @@
  * This file contains utilities used throughout the project too small to
  * deserve their own dedicated files.
  */
-import { setTimeout as delay } from "node:timers/promises";
-export { delay };
+export function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 export const noop = () => { };
 //# sourceMappingURL=utils.js.map

package/dist/utils/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../utils/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../utils/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC"}

package/dist/web/webSocketToNext.d.ts

@@ -0,0 +1,3 @@
+import type { ConnAddr, ConnNext } from "../connNext/connNext.ts";
+export declare function webSocketToNext(ws: WebSocket, remoteAddr?: ConnAddr): Promise<ConnNext>;
+//# sourceMappingURL=webSocketToNext.d.ts.map

package/dist/web/webSocketToNext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSocketToNext.d.ts","sourceRoot":"","sources":["../../web/webSocketToNext.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAElE,wBAAsB,eAAe,CACnC,EAAE,EAAE,SAAS,EACb,UAAU,CAAC,EAAE,QAAQ,GACpB,OAAO,CAAC,QAAQ,CAAC,CAiLnB"}

package/dist/web/webSocketToNext.js

@@ -0,0 +1,160 @@
+export async function webSocketToNext(ws, remoteAddr) {
+    ws.binaryType = "arraybuffer";
+    const messageQueue = [];
+    let queueOffset = 0;
+    const readResolvers = [];
+    const notifyWaiters = () => {
+        while (readResolvers.length > 0) {
+            const resolve = readResolvers.shift();
+            resolve?.();
+        }
+    };
+    // helper to check if websocket is Open
+    const ensureOpen = () => {
+        if (ws.readyState === WebSocket.OPEN) {
+            return Promise.resolve();
+        }
+        if (ws.readyState >= WebSocket.CLOSING) {
+            return Promise.reject(new Error("WebSocket is closing or closed"));
+        }
+        return new Promise((resolve, reject) => {
+            const onOpen = () => {
+                cleanup();
+                resolve();
+            };
+            const onError = (err) => {
+                cleanup();
+                reject(err);
+            };
+            const onClose = () => {
+                cleanup();
+                reject(new Error("WebSocket closed before opening"));
+            };
+            const cleanup = () => {
+                ws.removeEventListener("open", onOpen);
+                ws.removeEventListener("error", onError);
+                ws.removeEventListener("close", onClose);
+            };
+            ws.addEventListener("open", onOpen);
+            ws.addEventListener("error", onError);
+            ws.addEventListener("close", onClose);
+        });
+    };
+    ws.addEventListener("message", (event) => {
+        let chunk;
+        if (typeof event.data === "string") {
+            chunk = new TextEncoder().encode(event.data);
+        }
+        else if (event.data instanceof ArrayBuffer) {
+            chunk = new Uint8Array(event.data);
+        }
+        else {
+            return;
+        }
+        messageQueue.push(chunk);
+        notifyWaiters();
+    });
+    ws.addEventListener("close", notifyWaiters);
+    ws.addEventListener("error", notifyWaiters);
+    const getBufferedBytes = () => {
+        let total = 0;
+        for (let i = 0; i < messageQueue.length; i++) {
+            total += i === 0
+                ? messageQueue[i].byteLength - queueOffset
+                : messageQueue[i].byteLength;
+        }
+        return total;
+    };
+    const waitForData = () => {
+        return new Promise((resolve) => {
+            readResolvers.push(resolve);
+        });
+    };
+    const connNext = {
+        remoteAddr,
+        localAddr: undefined,
+        async read(length) {
+            try {
+                await ensureOpen();
+            }
+            catch {
+                return null;
+            }
+            if (getBufferedBytes() === 0 && ws.readyState >= WebSocket.CLOSING) {
+                return null;
+            }
+            while (getBufferedBytes() === 0) {
+                if (ws.readyState >= WebSocket.CLOSING)
+                    return null;
+                await waitForData();
+            }
+            if (length === undefined) {
+                const firstChunk = messageQueue.shift();
+                const result = firstChunk.subarray(queueOffset);
+                queueOffset = 0;
+                return result;
+            }
+            while (getBufferedBytes() < length) {
+                if (ws.readyState >= WebSocket.CLOSING) {
+                    return null;
+                }
+                await waitForData();
+            }
+            const result = new Uint8Array(length);
+            let bytesCopied = 0;
+            while (bytesCopied < length && messageQueue.length > 0) {
+                const currentChunk = messageQueue[0];
+                const bytesNeeded = length - bytesCopied;
+                const bytesAvailable = currentChunk.byteLength - queueOffset;
+                if (bytesAvailable <= bytesNeeded) {
+                    result.set(currentChunk.subarray(queueOffset), bytesCopied);
+                    bytesCopied += bytesAvailable;
+                    messageQueue.shift();
+                    queueOffset = 0;
+                }
+                else {
+                    result.set(currentChunk.subarray(queueOffset, queueOffset + bytesNeeded), bytesCopied);
+                    bytesCopied += bytesNeeded;
+                    queueOffset += bytesNeeded;
+                }
+            }
+            return result;
+        },
+        async write(data) {
+            await ensureOpen();
+            if (data instanceof Uint8Array) {
+                ws.send(data.buffer);
+            }
+            else {
+                ws.send(data);
+            }
+            const HIGH_WATER_MARK = 64 * 1024;
+            while (ws.bufferedAmount > HIGH_WATER_MARK) {
+                if (ws.readyState >= WebSocket.CLOSING) {
+                    throw new Error("WebSocket closed while writing");
+                }
+                await new Promise((resolve) => setTimeout(resolve, 10));
+            }
+        },
+        close() {
+            try {
+                ws.close();
+            }
+            catch {
+                /* swallow */
+            }
+            notifyWaiters();
+        },
+        async *[Symbol.asyncIterator]() {
+            while (true) {
+                const chunk = await this.read();
+                if (chunk === null)
+                    break;
+                yield chunk;
+            }
+        },
+    };
+    await ensureOpen();
+    return connNext;
+}
+//# sourceMappingURL=webSocketToNext.js.map

package/dist/web/webSocketToNext.js.map

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

package/dist/web/wsClient.d.ts

@@ -4,16 +4,16 @@
  *  @module
  */
 import { Client } from "../client/client.ts";
-import type { SockConn } from "../client/deps.ts";
+import type { ConnNext } from "../client/deps.ts";
 /**
  * WsClient extends the Client class to provide WebSocket based clients
  * it is used by the MQTTclient to connect to the broker
  * see the /examples folder for an example
  */
 export declare class WsClient extends Client {
-    /** create a websocket and wrap it in a SockConn */
+    /** create a websocket and wrap it in a ConnNext */
     private establishSocket;
     /** createConn provides support for both "ws:" and "wss:" URLs */
-    protected createConn(): Promise<SockConn>;
+    protected createConn(): Promise<ConnNext>;
 }
 //# sourceMappingURL=wsClient.d.ts.map

package/dist/web/wsClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wsClient.d.ts","sourceRoot":"","sources":["../../web/wsClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGlD;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,MAAM;IAClC,mDAAmD;YACrC,eAAe;IAM7B,iEAAiE;IACjE,UAAmB,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,CAUjD;CACF"}
+{"version":3,"file":"wsClient.d.ts","sourceRoot":"","sources":["../../web/wsClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,OAAO,KAAK,EAAE,QAAQ,EAAW,MAAM,mBAAmB,CAAC;AAG3D;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,MAAM;IAClC,mDAAmD;YACrC,eAAe;IAmB7B,iEAAiE;IACjE,UAAmB,UAAU,IAAI,OAAO,CAAC,QAAQ,CAAC,CAUjD;CACF"}

package/dist/web/wsClient.js

@@ -5,18 +5,32 @@
  */
 import { Client } from "../client/client.js";
 import { logger } from "../client/deps.js";
-import { wrapWebSocket } from "./wrapWebSocket.js";
+import { webSocketToNext } from "./webSocketToNext.js";
 /**
  * WsClient extends the Client class to provide WebSocket based clients
  * it is used by the MQTTclient to connect to the broker
  * see the /examples folder for an example
  */
 export class WsClient extends Client {
-    /** create a websocket and wrap it in a SockConn */
+    /** create a websocket and wrap it in a ConnNext */
     async establishSocket(url) {
-        const ws = new WebSocket(url);
-        const conn = await wrapWebSocket(ws);
-        return conn;
+        try {
+            const urlObj = new URL(url);
+            const remoteAddr = {
+                transport: "tcp",
+                hostname: urlObj.hostname,
+                port: Number(urlObj.port || 0),
+            };
+            const ws = new WebSocket(url);
+            const connNext = await webSocketToNext(ws, remoteAddr);
+            return connNext;
+        }
+        catch (error) {
+            const message = error instanceof ErrorEvent
+                ? ` because of ${error.message}`
+                : "";
+            throw new Error(`Failed to connect to WebSocket at ${url}${message}`);
+        }
     }
     /** createConn provides support for both "ws:" and "wss:" URLs */
     createConn() {

package/dist/web/wsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"wsClient.js","sourceRoot":"","sources":["../../web/wsClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,MAAM;IAClC,mDAAmD;IAC3C,KAAK,CAAC,eAAe,CAAC,GAAW;QACvC,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,EAAE,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iEAAiE;IAC9C,UAAU;QAC3B,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QACxE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,CAAC;QAEjC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,QAAQ,KAAK,QAAQ,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;CACF"}
+{"version":3,"file":"wsClient.js","sourceRoot":"","sources":["../../web/wsClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,MAAM;IAClC,mDAAmD;IAC3C,KAAK,CAAC,eAAe,CAAC,GAAW;QACvC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,MAAM,UAAU,GAAY;gBAC1B,SAAS,EAAE,KAAK;gBAChB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC;aAC/B,CAAC;YACF,MAAM,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;YACvD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,UAAU;gBACzC,CAAC,CAAC,eAAe,KAAK,CAAC,OAAO,EAAE;gBAChC,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,GAAG,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IAED,iEAAiE;IAC9C,UAAU;QAC3B,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC;QACxE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC1E,MAAM,IAAI,GAAG,QAAQ,IAAI,OAAO,CAAC;QAEjC,MAAM,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACvC,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC,eAAe,CAAC,GAAG,QAAQ,KAAK,QAAQ,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/web/wsClient.test.js

@@ -17,4 +17,19 @@ test("Web: Test createConn - unsupported protocol", async () => {
         message: "Unsupported protocol: ftp:",
     }, "Should throw an error when an unsupported protocol is provided");
 });
+test("Web: Test createConn - unsupported host", async () => {
+    const client = new WsClient();
+    // Use an host protocol to trigger the ws error
+    const invalidParams = {
+        url: new URL("ws://test.invalid"),
+        numberOfRetries: 0,
+    };
+    // Assert that connect rejects with the specific error
+    await assert.rejects(async () => {
+        await client.connect(invalidParams);
+    }, {
+        name: "Error",
+        message: /^Failed to connect to WebSocket/,
+    }, "Should throw an error when an unreachable host is provided");
+});
 //# sourceMappingURL=wsClient.test.js.map

package/dist/web/wsClient.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"wsClient.test.js","sourceRoot":"","sources":["../../web/wsClient.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,0DAA0D;AAC1D,IAAI,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;IAC7D,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAE9B,+EAA+E;IAC/E,MAAM,aAAa,GAAG;QACpB,GAAG,EAAE,IAAI,GAAG,CAAC,sBAAsB,CAAC;QACpC,eAAe,EAAE,CAAC;KACnB,CAAC;IAEF,6EAA6E;IAC7E,MAAM,MAAM,CAAC,OAAO,CAClB,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC,EACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,4BAA4B;KACtC,EACD,gEAAgE,CACjE,CAAC;AACJ,CAAC,CAAC,CAAC"}
+{"version":3,"file":"wsClient.test.js","sourceRoot":"","sources":["../../web/wsClient.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC,0DAA0D;AAC1D,IAAI,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;IAC7D,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAE9B,+EAA+E;IAC/E,MAAM,aAAa,GAAG;QACpB,GAAG,EAAE,IAAI,GAAG,CAAC,sBAAsB,CAAC;QACpC,eAAe,EAAE,CAAC;KACnB,CAAC;IAEF,6EAA6E;IAC7E,MAAM,MAAM,CAAC,OAAO,CAClB,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC,EACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,4BAA4B;KACtC,EACD,gEAAgE,CACjE,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;IACzD,MAAM,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;IAE9B,+CAA+C;IAC/C,MAAM,aAAa,GAAG;QACpB,GAAG,EAAE,IAAI,GAAG,CAAC,mBAAmB,CAAC;QACjC,eAAe,EAAE,CAAC;KACnB,CAAC;IAEF,sDAAsD;IACtD,MAAM,MAAM,CAAC,OAAO,CAClB,KAAK,IAAI,EAAE;QACT,MAAM,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACtC,CAAC,EACD;QACE,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,iCAAiC;KAC3C,EACD,4DAA4D,CAC7D,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/examples/README.md

@@ -0,0 +1,21 @@
+# Opifex Examples
+
+This folder contains examples for [Opifex](../README.md). It serves as a
+practical reference for setting up client/server communication, transport
+handling, authentication, and persistence.
+
+## Index
+
+- [`mqtt.test.ts`](mqtt.test.ts) — basic MQTT publish/subscribe flow over TCP
+  with in-memory persistence.
+- [`mqtts.test.ts`](mqtts.test.ts) — TLS-based MQTT example using SQLite
+  persistence.
+- [`mqtt+mqtts.test.ts`](mqtt+mqtts.test.ts) — Publish over TLS, subscribe over
+  TCP.
+- [`authHandler.test.ts`](authHandler.test.ts) — MQTT v5 authentication example
+  with a custom `processAuth` handler.
+- [`webSocket.test.ts`](webSocket.test.ts) — WebSocket-based client/server flow
+  for Deno.
+- [`webSocketServer.ts`](webSocketServer.ts) — simple WebSocket serving example
+  for browser-based MQTT usage.
+- [`public/`](public) — static assets used by the browser-facing WebSocket demo.

package/examples/authHandler.test.ts

@@ -112,7 +112,7 @@ test("Test MQTTv5 Auth using TCP client and server", async function () {
   const client = new TcpClient();
   client.onAuth = clientProcessAuth;
   await client.connect(params);
-  logger.info("Client connected to server at", client.url);
+  logger.info("Client connected to server at", client.url.toString());
 
   const publishSet: { topic: string; qos: QoS }[] = [
     { topic: "t0@q0", qos: 0 },
@@ -160,5 +160,5 @@ test("Test MQTTv5 Auth using TCP client and server", async function () {
   }
 
   logger.info("Stop server");
-  server.stop();
+  await server.stop();
 });

package/examples/mqtt+mqtts.test.ts

@@ -0,0 +1,122 @@
+import { test } from "node:test";
+import assert from "node:assert/strict";
+import { TcpClient } from "@seriousme/opifex/tcpClient";
+import { TlsServer } from "@seriousme/opifex/tlsServer";
+import { MqttServer } from "@seriousme/opifex/server";
+import { delay, logger, LogLevel } from "@seriousme/opifex/utils";
+import type { PublishPacket, QoS } from "@seriousme/opifex/mqttPacket";
+import { generateLocalhostCerts } from "../dev_utils/generateCert.ts";
+import { TcpServer } from "@seriousme/opifex/tcpServer";
+
+logger.level(LogLevel.info);
+
+test("Test pubSub using TLS client and a TCP client", async function () {
+  // the localhost certs generate here are great for testing but lack securiity
+  // use something like LetsEncrypt for any serious server
+  // generateLocalhostCerts is a dev tool and relies on node-forge as a (dev)dependency
+  const { key, cert, caCert } = generateLocalhostCerts();
+  // first create the mqttServer, so we can pass it to multiple protocol servers
+  const mqttServer = new MqttServer({});
+
+  const tlsServer = new TlsServer({ port: 0, key, cert }, mqttServer);
+  const tcpServer = new TcpServer({ port: 0 }, mqttServer);
+  // .start() combines instance creation and async initialization
+  tlsServer.start();
+  tcpServer.start();
+
+  logger.info(
+    `TLS server running on port: ${tlsServer.port}, address: ${tlsServer.address}`,
+  );
+  logger.info(
+    `TCP server running on port: ${tcpServer.port}, address: ${tcpServer.address}`,
+  );
+  // pick the correct hostname
+  const tlsHostname = tlsServer.address === "0.0.0.0"
+    ? "127.0.0.1"
+    : tlsServer.address;
+  const tcpHostname = tcpServer.address === "0.0.0.0"
+    ? "127.0.0.1"
+    : tcpServer.address;
+
+  const tlsParams = {
+    url: new URL(`mqtts://${tlsHostname}:${tlsServer.port}`),
+    clientId: "I am a TLS client",
+    numberOfRetries: 0,
+    // since we signed our server cert ourselves we need to add the caCert
+    // this is not required if you use a public Certificate Authority
+    caCerts: [caCert],
+  };
+
+  const tcpParams = {
+    url: new URL(`mqtt://${tcpHostname}:${tcpServer.port}`),
+    clientId: "I am a TCP client",
+    numberOfRetries: 0,
+  };
+
+  const tlsClient = new TcpClient(); // TcpClient can also handle TLS
+  const tcpClient = new TcpClient();
+  await tlsClient.connect(tlsParams);
+  await tcpClient.connect(tcpParams);
+  logger.info("tlsClient connected to server at", tlsClient.url.toString());
+  logger.info("tcpClient connected to server at", tcpClient.url.toString());
+
+  const publishSet: { topic: string; qos: QoS }[] = [
+    { topic: "t0@q0", qos: 0 },
+    { topic: "t1@q0", qos: 0 },
+    { topic: "t2@q0", qos: 0 },
+    { topic: "t0@q1", qos: 1 },
+    { topic: "t1@q1", qos: 1 },
+    { topic: "t2@q1", qos: 1 },
+    { topic: "t0@q2", qos: 2 },
+    { topic: "t1@q2", qos: 2 },
+    { topic: "t2@q2", qos: 2 },
+  ];
+
+  const subscriptions = publishSet.map((item) => ({
+    topicFilter: item.topic,
+    qos: item.qos,
+  }));
+  await tcpClient.subscribe({
+    subscriptions,
+  });
+
+  // the IIFE ensures message reception runs in parallel
+  logger.info("TCP client Start receiving");
+  const received: PublishPacket[] = [];
+  (async function () {
+    for await (const item of tcpClient.messages()) {
+      logger.verbose("Receiving:", item.topic, "--", item.qos);
+      received.push(item);
+    }
+  })();
+  // end of IIFE
+  logger.info("TLS client Start publishing");
+  for (const item of publishSet) {
+    logger.verbose("Publishing:", item.topic, "--", item.qos);
+    await tlsClient.publish({
+      topic: item.topic,
+      qos: item.qos,
+      payload: new Uint8Array([0x01]),
+    });
+  }
+
+  await delay(100);
+  logger.info("Disconnect TLS client");
+  await tlsClient.disconnect();
+  logger.info("Disconnect TCP client");
+  await tcpClient.disconnect();
+  logger.info("Check completeness");
+  for (const item of publishSet) {
+    const found = received.find((f) =>
+      f.topic == item.topic && f.qos === item.qos
+    );
+    logger.verbose("Found:", item.topic, "--", item.qos);
+    assert(found, `${item.topic} -- ${item.qos}`);
+  }
+
+  // just for demo, you can keep the MQTT server alive on the TCP server wile the TLSserver closes
+  logger.info("Stop TLS server");
+  await tlsServer.stop();
+  logger.info("Stop TCP server");
+  await tcpServer.stop();
+});

package/examples/mqtt.test.ts

@@ -30,7 +30,7 @@ test("Test pubSub using TCP client and server using memoryPersistence", async fu
 
   const client = new TcpClient();
   await client.connect(params);
-  logger.info("Client connected to server at", client.url);
+  logger.info("Client connected to server at", client.url.toString());
 
   const publishSet: { topic: string; qos: QoS }[] = [
     { topic: "t0@q0", qos: 0 },
@@ -85,5 +85,5 @@ test("Test pubSub using TCP client and server using memoryPersistence", async fu
   }
 
   logger.info("Stop server");
-  server.stop();
+  await server.stop();
 });

package/examples/mqtts.test.ts

@@ -41,7 +41,7 @@ test("Test pubSub using TLS client and server and sqlitePersistence", async func
 
   const client = new TcpClient();
   await client.connect(params);
-  logger.info("Client connected to server at", client.url);
+  logger.info("Client connected to server at", client.url.toString());
 
   const publishSet: { topic: string; qos: QoS }[] = [
     { topic: "t0@q0", qos: 0 },
@@ -96,5 +96,5 @@ test("Test pubSub using TLS client and server and sqlitePersistence", async func
   }
 
   logger.info("Stop server");
-  server.stop();
+  await server.stop();
 });