knx.ts 1.0.2 → 1.0.4

package/dist/core/enum/EnumControlField.d.ts

@@ -17,8 +17,3 @@ export declare enum FrameType {
     EXTENDED = 0,// FT = 0 → L_Data_Extended Frame
     STANDARD = 1
 }
-export declare enum FrameKind {
-    L_DATA_FRAME = "L_DATA_FRAME",
-    L_POLL_DATA_FRAME = "L_POLL_DATA_FRAME",
-    ACKNOWLEDGEMENT_FRAME = "ACKNOWLEDGEMENT_FRAME"
-}

package/dist/core/enum/EnumControlField.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FrameKind = exports.FrameType = exports.Priority = void 0;
+exports.FrameType = exports.Priority = void 0;
 /**
  * The two priority bits of the Control field shall control the priority of the Frame, if two devices start
 transmission simultaneously.
@@ -28,9 +28,3 @@ var FrameType;
     FrameType[FrameType["EXTENDED"] = 0] = "EXTENDED";
     FrameType[FrameType["STANDARD"] = 1] = "STANDARD"; // FT = 1 → L_Data_Standard Frame
 })(FrameType || (exports.FrameType = FrameType = {}));
-var FrameKind;
-(function (FrameKind) {
-    FrameKind["L_DATA_FRAME"] = "L_DATA_FRAME";
-    FrameKind["L_POLL_DATA_FRAME"] = "L_POLL_DATA_FRAME";
-    FrameKind["ACKNOWLEDGEMENT_FRAME"] = "ACKNOWLEDGEMENT_FRAME";
-})(FrameKind || (exports.FrameKind = FrameKind = {}));

package/dist/core/enum/EnumControlFieldExtended.d.ts

@@ -5,7 +5,7 @@ export declare enum AddressType {
     GROUP = 1
 }
 /** Extended Frame Format (bits 3..0) con 16 posibles valores (0..15) */
-export declare enum ExtendedFrameFormat {
+export declare const enum ExtendedFrameFormat {
     /**
      * If the {@linkcode AddressType} is Individual (0) then it will be **Point_To_Point**, if it is Group (1) then it will be **Standard Group**
      */

package/dist/core/enum/EnumShortACKFrame.d.ts

@@ -1,4 +1,4 @@
-export declare enum ShortAckCode {
+export declare const enum ShortAckCode {
     ACK = 204,
     NAK = 12,
     BUSY = 192,

package/dist/core/enum/ErrorCodeSet.js

@@ -1,2 +1,61 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorCodeSet = void 0;
+var ErrorCodeSet;
+(function (ErrorCodeSet) {
+    /**
+     * unknown error
+     * @service R/W
+     */
+    ErrorCodeSet[ErrorCodeSet["Unspecified_Error"] = 0] = "Unspecified_Error";
+    /**
+     * write value not allowed (general, if not error 2 or 3)
+     * @service W
+     */
+    ErrorCodeSet[ErrorCodeSet["Out_of_Range"] = 1] = "Out_of_Range";
+    /**
+     * write value to high
+     * @service W
+     */
+    ErrorCodeSet[ErrorCodeSet["Out_of_MaxRange"] = 2] = "Out_of_MaxRange";
+    /**
+     * write value to low
+     * @service W
+     */
+    ErrorCodeSet[ErrorCodeSet["Out_of_MinRange"] = 3] = "Out_of_MinRange";
+    /**
+     * memory can not be written or only with fault(s)
+     * @service W
+     */
+    ErrorCodeSet[ErrorCodeSet["Memory_Error"] = 4] = "Memory_Error";
+    /**
+     * write access to a ‘read only’ or a write protected Property
+     * @service W
+     */
+    ErrorCodeSet[ErrorCodeSet["Read_Only"] = 5] = "Read_Only";
+    /**
+     * COMMAND not valid or not supported
+     * @service W
+     */
+    ErrorCodeSet[ErrorCodeSet["Illegal_COMMAND"] = 6] = "Illegal_COMMAND";
+    /**
+     * read or write access to an non existing Property
+     * @service R/W
+     */
+    ErrorCodeSet[ErrorCodeSet["Void_DP"] = 7] = "Void_DP";
+    /**
+     * write access with a wrong data type (Datapoint length)
+     * @service W
+     */
+    ErrorCodeSet[ErrorCodeSet["Type_Conflict"] = 8] = "Type_Conflict";
+    /**
+     * read or write access to a non existing Property array index
+     * @service R/W
+     */
+    ErrorCodeSet[ErrorCodeSet["Prop_Index_Range_Error"] = 9] = "Prop_Index_Range_Error";
+    /**
+     * The Property exists but can at this moment not be written with a new value
+     * @service W
+     */
+    ErrorCodeSet[ErrorCodeSet["Value_temporarily_not_writeable"] = 10] = "Value_temporarily_not_writeable";
+})(ErrorCodeSet || (exports.ErrorCodeSet = ErrorCodeSet = {}));

package/dist/core/enum/KNXnetIPEnum.d.ts

@@ -81,14 +81,14 @@ export declare const enum AllowedSupportedServiceFamilies {
     ObjectServer = 8,
     Security = 9
 }
-export declare enum KNXTimeoutConstants {
+export declare const enum KNXTimeoutConstants {
     CONNECT_REQUEST_TIMEOUT = 10,
     CONNECTIONSTATE_REQUEST_TIMEOUT = 10,
     DEVICE_CONFIGURATION_REQUEST_TIMEOUT = 10,
     TUNNELING_REQUEST_TIMEOUT = 1,
     CONNECTION_ALIVE_TIME = 120
 }
-export declare enum TunnelLink {
+export declare const enum TunnelLink {
     TUNNEL_LINKLAYER = 2,
     TUNNEL_RAW = 4,
     TUNNEL_BUSMONITOR = 128

package/dist/core/enum/KNXnetIPEnum.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TunnelLink = exports.KNXTimeoutConstants = exports.KNXLayer = exports.DescriptionType = exports.ConnectionType = exports.HostProtocolCode = exports.KNXnetIPErrorCodes = exports.KNXnetIPServiceType = void 0;
+exports.TunnelLink = exports.KNXTimeoutConstants = exports.AllowedSupportedServiceFamilies = exports.KNXMedium = exports.KNXLayer = exports.DescriptionType = exports.ConnectionType = exports.HostProtocolCode = exports.KNXnetIPErrorCodes = exports.KNXnetIPServiceType = void 0;
 var KNXnetIPServiceType;
 (function (KNXnetIPServiceType) {
     KNXnetIPServiceType[KNXnetIPServiceType["SEARCH_REQUEST"] = 513] = "SEARCH_REQUEST";
@@ -74,6 +74,24 @@ var KNXLayer;
     KNXLayer[KNXLayer["RAW_LAYER"] = 4] = "RAW_LAYER";
     KNXLayer[KNXLayer["BUSMONITOR_LAYER"] = 128] = "BUSMONITOR_LAYER";
 })(KNXLayer || (exports.KNXLayer = KNXLayer = {}));
+var KNXMedium;
+(function (KNXMedium) {
+    KNXMedium[KNXMedium["TP1"] = 2] = "TP1";
+    KNXMedium[KNXMedium["PL110"] = 4] = "PL110";
+    KNXMedium[KNXMedium["RF"] = 16] = "RF";
+    KNXMedium[KNXMedium["KNXIP"] = 32] = "KNXIP";
+})(KNXMedium || (exports.KNXMedium = KNXMedium = {}));
+var AllowedSupportedServiceFamilies;
+(function (AllowedSupportedServiceFamilies) {
+    AllowedSupportedServiceFamilies[AllowedSupportedServiceFamilies["Core"] = 2] = "Core";
+    AllowedSupportedServiceFamilies[AllowedSupportedServiceFamilies["DeviceManagement"] = 3] = "DeviceManagement";
+    AllowedSupportedServiceFamilies[AllowedSupportedServiceFamilies["Tunnelling"] = 4] = "Tunnelling";
+    AllowedSupportedServiceFamilies[AllowedSupportedServiceFamilies["Routing"] = 5] = "Routing";
+    AllowedSupportedServiceFamilies[AllowedSupportedServiceFamilies["RemoteLogging"] = 6] = "RemoteLogging";
+    AllowedSupportedServiceFamilies[AllowedSupportedServiceFamilies["RemoteConfigurationAndDiagnosis"] = 7] = "RemoteConfigurationAndDiagnosis";
+    AllowedSupportedServiceFamilies[AllowedSupportedServiceFamilies["ObjectServer"] = 8] = "ObjectServer";
+    AllowedSupportedServiceFamilies[AllowedSupportedServiceFamilies["Security"] = 9] = "Security";
+})(AllowedSupportedServiceFamilies || (exports.AllowedSupportedServiceFamilies = AllowedSupportedServiceFamilies = {}));
 var KNXTimeoutConstants;
 (function (KNXTimeoutConstants) {
     KNXTimeoutConstants[KNXTimeoutConstants["CONNECT_REQUEST_TIMEOUT"] = 10] = "CONNECT_REQUEST_TIMEOUT";

package/dist/core/layers/data/NPDU.d.ts

@@ -17,7 +17,8 @@ export declare class NPDU implements ServiceMessage {
     private _hopCount;
     TPDU: TPDU;
     private _addressType;
-    constructor(InstanceOfTPDU?: TPDU, addressType?: AddressType, hopCount?: number);
+    length: number;
+    constructor(InstanceOfTPDU?: TPDU, addressType?: AddressType, hopCount?: number, length?: number);
     /**
      * Obtiene el Hop Count (0-7).
      */

package/dist/core/layers/data/NPDU.js

@@ -19,10 +19,13 @@ class NPDU {
     _hopCount = 6; // Valor por defecto estándar en KNX
     TPDU; // Datos puros (payload del usuario)
     _addressType;
-    constructor(InstanceOfTPDU = new TPDU_1.TPDU(), addressType = EnumControlFieldExtended_1.AddressType.GROUP, hopCount = 6) {
+    length = 0;
+    constructor(InstanceOfTPDU = new TPDU_1.TPDU(), addressType = EnumControlFieldExtended_1.AddressType.GROUP, hopCount = 6, length) {
         this._addressType = addressType;
         this.hopCount = hopCount; // Usa el setter para validar
         this.TPDU = InstanceOfTPDU;
+        if (length)
+            this.length = length;
     }
     /**
      * Obtiene el Hop Count (0-7).
@@ -54,7 +57,7 @@ class NPDU {
         // Bits 7: Reservado (0) -> parece ser el AddressType
         // Bits 6-4: Hop Count
         // Bits 3-0: Length (Longitud del TPDU)
-        const npciByte = (this.addressType << 7) | (this._hopCount << 4) | (length & 0x0f);
+        const npciByte = (this.addressType << 7) | (this._hopCount << 4) | (this.length & 0x0f);
         const buffer = Buffer.alloc(1 + length);
         buffer.writeUInt8(npciByte, 0);
         tpduBuffer.copy(buffer, 1);
@@ -97,7 +100,7 @@ class NPDU {
         const tpdu = TPDU_1.TPDU.fromBuffer(tpduBuffer);
         // 3. Retornar nueva instancia
         // Nota: AddressType no viene en el NPDU, viene del cEMI. Asumimos GROUP por defecto.
-        return new NPDU(tpdu, EnumControlFieldExtended_1.AddressType.GROUP, hopCount);
+        return new NPDU(tpdu, EnumControlFieldExtended_1.AddressType.GROUP, hopCount, length);
     }
 }
 exports.NPDU = NPDU;

package/dist/index.d.ts

@@ -2,6 +2,23 @@ export { KnxDataDecode } from "./core/data/KNXDataDecode";
 export { KnxDataEncoder } from "./core/data/KNXDataEncode";
 export { KNXnetIPServer } from "./connection/KNXnetIPServer";
 export { KNXTunneling } from "./connection/KNXTunneling";
-export { CEMI } from "./core/CEMI";
-export { EMI } from './core/EMI';
+export { KNXWebSocketGateway } from "./server/KNXWebSocketServer";
+export { KNXMQTTGateway } from "./server/KNXMQTTGateway";
+export * from "./connection/Router";
+export * from "./connection/TPUART";
+export * from "./connection/KNXUSBConnection";
+export { CEMI, AdditionalInformationField } from "./core/CEMI";
+export * from "./core/KNXAddInfoTypes";
+export { EMI } from "./core/EMI";
 export { knxLogger, setupLogger } from "./utils/Logger";
+export * from "./@types/interfaces/DPTs";
+export * from "./core/enum/APCIEnum";
+export * from "./core/enum/EnumControlField";
+export { AddressType } from "./core/enum/EnumControlFieldExtended";
+export * from "./core/ControlField";
+export * from "./core/ControlFieldExtended";
+export * from "./core/layers/data/APDU";
+export * from "./core/layers/data/NPDU";
+export * from "./core/layers/data/TPDU";
+export * from "./core/layers/interfaces/APCI";
+export * from "./core/layers/interfaces/TPCI";

package/dist/index.js

@@ -1,6 +1,20 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setupLogger = exports.knxLogger = exports.EMI = exports.CEMI = exports.KNXTunneling = exports.KNXnetIPServer = exports.KnxDataEncoder = exports.KnxDataDecode = void 0;
+exports.AddressType = exports.setupLogger = exports.knxLogger = exports.EMI = exports.AdditionalInformationField = exports.CEMI = exports.KNXMQTTGateway = exports.KNXWebSocketGateway = exports.KNXTunneling = exports.KNXnetIPServer = exports.KnxDataEncoder = exports.KnxDataDecode = void 0;
 var KNXDataDecode_1 = require("./core/data/KNXDataDecode");
 Object.defineProperty(exports, "KnxDataDecode", { enumerable: true, get: function () { return KNXDataDecode_1.KnxDataDecode; } });
 var KNXDataEncode_1 = require("./core/data/KNXDataEncode");
@@ -9,10 +23,31 @@ var KNXnetIPServer_1 = require("./connection/KNXnetIPServer");
 Object.defineProperty(exports, "KNXnetIPServer", { enumerable: true, get: function () { return KNXnetIPServer_1.KNXnetIPServer; } });
 var KNXTunneling_1 = require("./connection/KNXTunneling");
 Object.defineProperty(exports, "KNXTunneling", { enumerable: true, get: function () { return KNXTunneling_1.KNXTunneling; } });
+var KNXWebSocketServer_1 = require("./server/KNXWebSocketServer");
+Object.defineProperty(exports, "KNXWebSocketGateway", { enumerable: true, get: function () { return KNXWebSocketServer_1.KNXWebSocketGateway; } });
+var KNXMQTTGateway_1 = require("./server/KNXMQTTGateway");
+Object.defineProperty(exports, "KNXMQTTGateway", { enumerable: true, get: function () { return KNXMQTTGateway_1.KNXMQTTGateway; } });
+__exportStar(require("./connection/Router"), exports);
+__exportStar(require("./connection/TPUART"), exports);
+__exportStar(require("./connection/KNXUSBConnection"), exports);
 var CEMI_1 = require("./core/CEMI");
 Object.defineProperty(exports, "CEMI", { enumerable: true, get: function () { return CEMI_1.CEMI; } });
+Object.defineProperty(exports, "AdditionalInformationField", { enumerable: true, get: function () { return CEMI_1.AdditionalInformationField; } });
+__exportStar(require("./core/KNXAddInfoTypes"), exports);
 var EMI_1 = require("./core/EMI");
 Object.defineProperty(exports, "EMI", { enumerable: true, get: function () { return EMI_1.EMI; } });
 var Logger_1 = require("./utils/Logger");
 Object.defineProperty(exports, "knxLogger", { enumerable: true, get: function () { return Logger_1.knxLogger; } });
 Object.defineProperty(exports, "setupLogger", { enumerable: true, get: function () { return Logger_1.setupLogger; } });
+__exportStar(require("./@types/interfaces/DPTs"), exports);
+__exportStar(require("./core/enum/APCIEnum"), exports);
+__exportStar(require("./core/enum/EnumControlField"), exports);
+var EnumControlFieldExtended_1 = require("./core/enum/EnumControlFieldExtended");
+Object.defineProperty(exports, "AddressType", { enumerable: true, get: function () { return EnumControlFieldExtended_1.AddressType; } });
+__exportStar(require("./core/ControlField"), exports);
+__exportStar(require("./core/ControlFieldExtended"), exports);
+__exportStar(require("./core/layers/data/APDU"), exports);
+__exportStar(require("./core/layers/data/NPDU"), exports);
+__exportStar(require("./core/layers/data/TPDU"), exports);
+__exportStar(require("./core/layers/interfaces/APCI"), exports);
+__exportStar(require("./core/layers/interfaces/TPCI"), exports);

package/dist/server/KNXMQTTGateway.d.ts

@@ -0,0 +1,13 @@
+import { MQTTGatewayOptions } from "../@types/interfaces/servers";
+export declare class KNXMQTTGateway {
+    private options;
+    private aedesBroker;
+    private server;
+    private client;
+    private topicPrefix;
+    constructor(options: MQTTGatewayOptions);
+    start(): Promise<void>;
+    private handleMQTTMessage;
+    private publishError;
+    stop(): void;
+}

package/dist/server/KNXMQTTGateway.js

@@ -0,0 +1,164 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KNXMQTTGateway = void 0;
+const aedes_1 = require("aedes");
+const aedes_server_factory_1 = require("aedes-server-factory");
+const mqtt = __importStar(require("mqtt"));
+const GroupAddressCache_1 = require("../core/cache/GroupAddressCache");
+class KNXMQTTGateway {
+    options;
+    aedesBroker = null;
+    server = null;
+    client = null;
+    topicPrefix;
+    constructor(options) {
+        this.options = options;
+        this.topicPrefix = options.topicPrefix || "knx";
+    }
+    async start() {
+        // 1. Setup embedded broker if requested
+        if (this.options.embeddedBroker) {
+            this.aedesBroker = new aedes_1.Aedes();
+            this.server = (0, aedes_server_factory_1.createServer)(this.aedesBroker);
+            const port = this.options.embeddedBroker.port;
+            const host = this.options.embeddedBroker.host || "127.0.0.1";
+            await new Promise((serverResolve) => {
+                this.server.listen(port, host, () => {
+                    serverResolve();
+                });
+            });
+        }
+        await new Promise((resolve) => {
+            // 2. Setup Client to bridge KNX to MQTT
+            const url = this.options.brokerUrl ||
+                (this.options.embeddedBroker ? `mqtt://127.0.0.1:${this.options.embeddedBroker.port}` : null);
+            if (!url) {
+                throw new Error("No Broker URL provided nor embedded broker requested.");
+            }
+            this.client = mqtt.connect(url, {
+                username: this.options.mqttUsername,
+                password: this.options.mqttPassword,
+            });
+            this.client.on("connect", () => {
+                // Subscribe to command topics: prefix/command/action/groupAddress
+                // Actions: write, read, config_dpt
+                this.client?.subscribe(`${this.topicPrefix}/command/write/+`);
+                this.client?.subscribe(`${this.topicPrefix}/command/read/+`);
+                this.client?.subscribe(`${this.topicPrefix}/command/config_dpt/+`);
+                resolve();
+            });
+            this.client.on("message", (topic, message) => {
+                this.handleMQTTMessage(topic, message);
+            });
+            // Global Listener from KNXContext
+            this.options.knxContext.on("indication", (cemi) => {
+                if (!("destinationAddress" in cemi))
+                    return;
+                const dest = cemi.destinationAddress;
+                if (!dest)
+                    return;
+                const cache = GroupAddressCache_1.GroupAddressCache.getInstance();
+                const entries = cache.query(dest, undefined, undefined, true);
+                let decodedValue = undefined;
+                if (entries && entries.length > 0) {
+                    decodedValue = entries[0].decodedValue;
+                }
+                // Publish to mqtt
+                const pubTopic = `${this.topicPrefix}/state/${dest}`;
+                const payload = JSON.stringify({
+                    decodedValue: decodedValue,
+                });
+                if (this.client?.connected) {
+                    this.client.publish(pubTopic, payload, { retain: true });
+                }
+            });
+        });
+    }
+    handleMQTTMessage(topic, message) {
+        const parts = topic.split("/");
+        // knx/command/write/1/2/3
+        if (parts.length < 4)
+            return;
+        const action = parts[2];
+        const groupAddress = parts.slice(3).join("/"); // To handle 1/2/3
+        let payload = {};
+        try {
+            const msgStr = message.toString();
+            payload = msgStr ? JSON.parse(msgStr) : {};
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+        }
+        catch (e) {
+            // simple value fallback
+            payload = { value: message.toString() };
+        }
+        const { value, dpt } = payload;
+        if (action === "config_dpt" && dpt) {
+            GroupAddressCache_1.GroupAddressCache.getInstance().setAddressDPT(groupAddress, dpt);
+            return;
+        }
+        if (action === "read") {
+            GroupAddressCache_1.GroupAddressCache.getInstance()
+                .readDirectAsync(groupAddress, this.options.knxContext)
+                .catch((err) => {
+                this.publishError(groupAddress, err.message);
+            });
+            return;
+        }
+        if (action === "write" && value !== undefined) {
+            const targetDpt = dpt || GroupAddressCache_1.GroupAddressCache.getInstance().getAddressDPT(groupAddress);
+            this.options.knxContext.write(groupAddress, targetDpt, value).catch((err) => {
+                this.publishError(groupAddress, err.message);
+            });
+        }
+    }
+    publishError(address, error) {
+        if (!this.client?.connected)
+            return;
+        this.client.publish(`${this.topicPrefix}/error`, JSON.stringify({ groupAddress: address, error }));
+    }
+    stop() {
+        if (this.client) {
+            this.client.end();
+        }
+        if (this.server) {
+            this.server.close();
+        }
+        if (this.aedesBroker) {
+            this.aedesBroker.close();
+        }
+    }
+}
+exports.KNXMQTTGateway = KNXMQTTGateway;

package/dist/server/KNXWebSocketServer.d.ts

@@ -0,0 +1,12 @@
+import { WebSocketGatewayOptions } from "../@types/interfaces/servers";
+export declare class KNXWebSocketGateway {
+    private wss;
+    private options;
+    private activeSubscriptions;
+    constructor(options: WebSocketGatewayOptions);
+    start(): void;
+    private handleClientMessage;
+    private broadcast;
+    private sendError;
+    stop(): void;
+}

package/dist/server/KNXWebSocketServer.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KNXWebSocketGateway = void 0;
+const ws_1 = require("ws");
+const GroupAddressCache_1 = require("../core/cache/GroupAddressCache");
+class KNXWebSocketGateway {
+    wss = null;
+    options;
+    // Track subscribed addresses: "*" means all
+    activeSubscriptions = new Set();
+    constructor(options) {
+        this.options = options;
+    }
+    start() {
+        this.wss = new ws_1.WebSocketServer({ port: this.options.port });
+        this.wss.on("connection", (ws) => {
+            ws.on("message", (message) => {
+                try {
+                    const payload = JSON.parse(message.toString());
+                    this.handleClientMessage(ws, payload);
+                    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+                }
+                catch (e) {
+                    this.sendError(ws, "Invalid JSON format");
+                }
+            });
+            // Acknowledge connection
+            ws.send(JSON.stringify({ action: "connected", message: "KNX WebSocket Gateway connected" }));
+        });
+        // Listen globally for events from knxContext to dispatch to WS clients
+        this.options.knxContext.on("indication", (cemi) => {
+            if (!("destinationAddress" in cemi))
+                return;
+            const dest = cemi.destinationAddress;
+            if (!dest)
+                return;
+            if (this.activeSubscriptions.has(dest) || this.activeSubscriptions.has("*")) {
+                const cache = GroupAddressCache_1.GroupAddressCache.getInstance();
+                const entries = cache.query(dest, undefined, undefined, true);
+                let decodedValue = undefined;
+                if (entries && entries.length > 0) {
+                    decodedValue = entries[0].decodedValue;
+                }
+                this.broadcast(dest, cemi, decodedValue);
+            }
+        });
+    }
+    handleClientMessage(ws, payload) {
+        const { action, groupAddress, value, dpt } = payload;
+        if (action === "config_dpt" && groupAddress && dpt) {
+            GroupAddressCache_1.GroupAddressCache.getInstance().setAddressDPT(groupAddress, dpt);
+            ws.send(JSON.stringify({ action: "config_dpt_ack", groupAddress, dpt }));
+            return;
+        }
+        if (action === "read" && groupAddress) {
+            GroupAddressCache_1.GroupAddressCache.getInstance()
+                .readDirectAsync(groupAddress, this.options.knxContext)
+                .then((res) => {
+                ws.send(JSON.stringify({ action: "read_result", groupAddress, data: res }));
+            })
+                .catch((err) => this.sendError(ws, err.message));
+            return;
+        }
+        if (action === "query" && groupAddress) {
+            const results = GroupAddressCache_1.GroupAddressCache.getInstance().query(groupAddress, payload.startDate ? new Date(payload.startDate) : undefined, payload.endDate ? new Date(payload.endDate) : undefined, payload.onlyLatest ?? false);
+            ws.send(JSON.stringify({ action: "query_result", groupAddress, results }));
+            return;
+        }
+        if (action === "write" && groupAddress && value !== undefined) {
+            // Try getting dpt from payload, or fallback to cache
+            const targetDpt = dpt || GroupAddressCache_1.GroupAddressCache.getInstance().getAddressDPT(groupAddress);
+            // Context .write naturally encodes using KNXDataEncoder internally if dpt is provided
+            this.options.knxContext
+                .write(groupAddress, targetDpt, value)
+                .then(() => {
+                ws.send(JSON.stringify({ action: "write_ack", groupAddress }));
+            })
+                .catch((err) => {
+                this.sendError(ws, err.message);
+            });
+            return;
+        }
+        if (action === "subscribe") {
+            const target = groupAddress || "*";
+            this.activeSubscriptions.add(target);
+            ws.send(JSON.stringify({ action: "subscribe_ack", groupAddress: target }));
+            return;
+        }
+        if (action === "unsubscribe") {
+            const target = groupAddress || "*";
+            this.activeSubscriptions.delete(target);
+            ws.send(JSON.stringify({ action: "unsubscribe_ack", groupAddress: target }));
+            return;
+        }
+    }
+    broadcast(address, cemi, decodedValue) {
+        if (!this.wss)
+            return;
+        const msg = JSON.stringify({
+            action: "event",
+            groupAddress: address,
+            decodedValue,
+        });
+        this.wss.clients.forEach((client) => {
+            if (client.readyState === ws_1.WebSocket.OPEN) {
+                client.send(msg);
+            }
+        });
+    }
+    sendError(ws, message) {
+        ws.send(JSON.stringify({ action: "error", message }));
+    }
+    stop() {
+        if (this.wss)
+            this.wss.close();
+    }
+}
+exports.KNXWebSocketGateway = KNXWebSocketGateway;

package/dist/utils/CEMIAdapter.d.ts

@@ -1,4 +1,5 @@
-import { ServiceMessage } from "../@types/interfaces/ServiceMessage";
+import { CEMIInstance } from "../core/CEMI";
+import { EMIInstance } from "../core/EMI";
 /**
  * Adapter utility to convert between EMI (External Message Interface) and cEMI (Common External Message Interface).
  * EMI is typically used by physical interfaces like TPUART, while cEMI is standard for KNXnet/IP.
@@ -8,9 +9,9 @@ export declare class CEMIAdapter {
      * Adapts a raw EMI2 message (Buffer) to a cEMI instance.
      * Typical EMI structure: [MC] [Ctrl] [Src] [Dst] [Len] [NPDU(NPCI + TPDU)]
      */
-    static emiToCemi(emiBuffer: Buffer): ServiceMessage | null;
+    static emiToCemi(emiBuffer: Buffer): CEMIInstance | null;
     /**
      * Converts a cEMI instance to an EMI2 compatible Buffer or ServiceMessage.
      */
-    static cemiToEmi(cemi: any): ServiceMessage | null;
+    static cemiToEmi(cemi: CEMIInstance): EMIInstance | null;
 }