knx.ts 1.0.0

package/dist/@types/interfaces/EMI.d.ts

@@ -0,0 +1,396 @@
+import { ControlField } from "../../core/ControlField";
+import { Priority } from "../../core/enum/EnumControlField";
+import { AddressType } from "../../core/enum/EnumControlFieldExtended";
+import { SAP } from "../../core/enum/SAP";
+import { APCI } from "../../core/layers/interfaces/APCI";
+import { SystemStatus, Status } from "../../core/SystemStatus";
+export type bits4 = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
+export interface PEI_Switch_req {
+    systemStatus: SystemStatus;
+    LL: bits4;
+    NL: bits4;
+    TLG: bits4;
+    TLC: bits4;
+    TLL: bits4;
+    AL: bits4;
+    MAN: bits4;
+    PEI: bits4;
+    USR: bits4;
+    res: bits4;
+}
+export interface L_Busmon_ind {
+    status: Status;
+    timeStamp: number;
+    controlField1: ControlField;
+    /**
+     * Data Link Protocol Data Unit (LPDU) - This is the actual data payload of the message.
+     * It contains the information that is being monitored on the bus.
+     *
+     * For example, a telegram might contain a control field, a source address, a destination address, and the actual data being transmitted.
+     */
+    LPDU: Buffer;
+}
+/**
+ * It shall be possible to send up to 28 octets of plain data by this service.
+ *
+ * In “time” optionally a time delay before sending the message on the bus can be specified. If
+ * “time”=00000000h the frame shall be sent immediately. Otherwise the frame shall be sent if the free
+ * running system counter of the sending device equals the value given in “time”.
+ */
+export interface L_Plain_Data_req {
+    time: number;
+    data: Buffer;
+}
+/**
+ * The NPDU shall correspond to the LPDU of an L_Data-Frame without the Control Field, Source
+ * Address, Destination Address, Address Type Flag and the octet count.
+ *
+ * As far as is understood, for example in octet 5 of the L_Data_Standard Frame of the TP1 medium the NPCI corresponds to the hop count which is 3 bits
+ */
+export type NPCI = 0 | 1 | 2 | 3 | 4 | 6 | 7;
+export interface L_Data_req {
+    control: {
+        priority: Priority;
+        ackRequest: boolean;
+    };
+    destinationAddress: string;
+    addressType: AddressType;
+    NPCI: NPCI;
+    NPDU: Buffer;
+}
+export interface L_Data_con {
+    control: {
+        priority: Priority;
+        /**
+         * This Confirm flag shall indicate whether this L_Data.con is a positive
+         * confirmation or a negative confirmation
+         *
+         * - false - This shall be a positive confirmation.
+         *
+         * - true - This shall be a negative confirmation.
+         */
+        confirm: boolean;
+    };
+    destinationAddress: string;
+    addressType: AddressType;
+    NPCI: NPCI;
+    NPDU: Buffer;
+}
+export interface L_Data_ind extends Omit<L_Data_req, "control"> {
+    sourceAddress: string;
+    control: {
+        priority: Priority;
+    };
+}
+export interface L_Poll_Data_Req {
+    pollingGroup: number;
+    nrOfSlots: bits4;
+}
+export interface L_Poll_Data_Con {
+    pollingGroup: number;
+    nrOfSlots: bits4;
+    control: {
+        confirm: boolean;
+    };
+}
+export interface L_SystemBroadcast_req {
+    destinationAddress: string;
+    addressType: 1 | 0;
+    NPCI: NPCI;
+    control: L_Data_con["control"] & {
+        /**
+         * This flag shall indicate whether a Data Link Layer acknowledge shall be requested when the frame is transmitted on KNX or whether this is don’t care.
+         * - false = Don't care
+         * - true = no L2-acknowledge requested
+         */
+        ackRequest: boolean;
+    };
+    NPDU: Buffer;
+}
+export interface L_SystemBroadcast_con extends Omit<L_Data_con, "control"> {
+    control: {
+        notRepeat: boolean;
+        priority: Priority;
+        /**
+         * This Confirm flag shall indicate whether this L_Data.con is a positive
+         * confirmation or a negative confirmation
+         *
+         * - false - This shall be a positive confirmation.
+         *
+         * - true - This shall be a negative confirmation.
+         */
+        confirm: boolean;
+    };
+}
+export interface L_SystemBroadcast_ind extends L_SystemBroadcast_con {
+    sourceAddress: string;
+}
+export interface N_Data_Individual_req_Ctor {
+    control: {
+        frameType: boolean;
+        repeat: boolean;
+        systemBroadcast: boolean;
+        priority: Priority;
+        ackRequest: boolean;
+        confirm: boolean;
+    };
+    destinationAddress: string;
+    TPDU: Buffer;
+}
+export interface N_Data_Individual_con_Ctor {
+    control: {
+        confirm: boolean;
+    };
+    destinationAddress: string;
+    TPDU: Buffer;
+}
+export interface N_Data_Individual_ind_Ctor {
+    control: {
+        priority: number;
+    };
+    sourceAddress: string;
+    destinationAddress: string;
+    hopCount: number;
+    TPDU: Buffer;
+}
+export interface N_Data_Group_req_Ctor {
+    control: {
+        priority: number;
+    };
+    destinationAddress: string;
+    APDU: Buffer;
+}
+export interface N_Data_Group_con_Ctor {
+    control: {
+        confirm: boolean;
+    };
+    destinationAddress: string;
+    APDU: Buffer;
+}
+export interface N_Data_Group_ind_Ctor {
+    control: {
+        priority: number;
+    };
+    sourceAddress: string;
+    destinationAddress: string;
+    hopCount: number;
+    APDU: Buffer;
+}
+export interface N_Data_Broadcast_req_Ctor {
+    control: {
+        priority: number;
+    };
+    hopCountType: NPCI;
+    TPDU: Buffer;
+}
+export interface N_Data_Broadcast_con_Ctor {
+    control: {
+        confirm: boolean;
+    };
+    TPDU: Buffer;
+}
+export interface N_Data_Broadcast_ind_Ctor {
+    control: {
+        priority: number;
+    };
+    sourceAddress: string;
+    hopCount: number;
+    TPDU: Buffer;
+}
+export interface N_Poll_Data_Req {
+    pollingGroup: string;
+    nrOfSlots: bits4;
+}
+export interface N_Poll_Data_Con {
+    pollingGroup: string;
+    nrOfSlots: bits4;
+    pollData: Buffer;
+}
+export interface T_Connect_req {
+    destinationAddress: string;
+}
+export interface T_Connect_ind {
+    sourceAddress: string;
+    control: Omit<InstanceType<typeof ControlField>, "describe" | "buffer">;
+}
+export interface T_Disconnect_con {
+    control: Omit<InstanceType<typeof ControlField>, "describe" | "buffer">;
+}
+export interface T_Data_Connected_req {
+    control: {
+        priority: InstanceType<typeof ControlField>["priority"];
+    };
+    hopCount: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
+    APDU: Buffer;
+}
+export interface T_Data_Connected_con {
+    control: {
+        confirm: boolean;
+    };
+    APDU: Buffer;
+}
+export interface T_Data_Connected_ind {
+    control: {
+        priority: number;
+    };
+    sourceAddress: string;
+    APDU: Buffer;
+    hopCount: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
+}
+export interface T_Data_Group_req {
+    control: {
+        priority: number;
+    };
+    APDU: Buffer;
+    hopCount: number;
+}
+export interface T_Data_Group_con {
+    control: {
+        confirm: boolean;
+    };
+    data: Buffer;
+}
+export interface T_Data_Group_ind {
+    control: {
+        priority: number;
+    };
+    APDU: Buffer;
+}
+export interface T_Data_Individual_req {
+    control: {
+        priority: number;
+    };
+    destinationAddress: string;
+    APDU: Buffer;
+    hopCount: number;
+}
+export interface T_Data_Individual_con {
+    control: {
+        confirm: boolean;
+    };
+    destinationAddress: string;
+    APDU: Buffer;
+}
+export interface T_Data_Individual_ind {
+    control: {
+        priority: number;
+    };
+    sourceAddress: string;
+    destinationAddress: string;
+    APDU: Buffer;
+    hopCount: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
+}
+export interface T_Data_Broadcast_req {
+    control: {
+        priority: number;
+    };
+    APDU: Buffer;
+    hopCount: number;
+}
+export interface T_Data_Broadcast_con {
+    control: {
+        confirm: boolean;
+    };
+    APDU: Buffer;
+}
+export interface T_Data_Broadcast_ind {
+    control: {
+        priority: number;
+    };
+    sourceAddress: string;
+    APDU: Buffer;
+    hopCount: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
+}
+export interface T_Poll_Data_req {
+    control: any;
+    pollingGroup: string;
+    numberOfSlots: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
+}
+export interface T_Poll_Data_con {
+    control: any;
+    sourceAddress: string;
+    pollingGroup: string;
+    pollData: Buffer;
+    nrOfSlots: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15;
+}
+export interface M_Connect_ind {
+    sourceAddress: string;
+}
+export interface M_User_Data_Connected_req {
+    control: {
+        priority: number;
+    };
+    APDU: Buffer;
+    hopCount: number;
+}
+export interface M_User_Data_Connected_con {
+    control: {
+        confirm: boolean;
+    };
+    APDU: Buffer;
+}
+export interface M_User_Data_Connected_ind {
+    control: {
+        priority: number;
+    };
+    sourceAddress: string;
+    APDU: Buffer;
+}
+export interface A_Data_Group_req {
+    control: {
+        priority: number;
+    };
+    sap: SAP;
+    apci: APCI;
+    data: Buffer;
+    hopCount: number;
+}
+export interface A_Data_Group_con {
+    control: {
+        confirm: boolean;
+    };
+    sap: SAP;
+    apci: APCI;
+    data: Buffer;
+}
+export interface A_Data_Group_ind {
+    control: {
+        priority: number;
+    };
+    sap: SAP;
+    apci: APCI;
+    data: Buffer;
+}
+export interface M_User_Data_Individual_req {
+    control: {
+        priority: number;
+    };
+    destinationAddress: string;
+    data: Buffer;
+    hopCount: number;
+}
+export interface M_User_Data_Individual_con {
+    control: {
+        confirm: boolean;
+    };
+    destinationAddress: string;
+    data: Buffer;
+}
+export interface M_User_Data_Individual_ind {
+    control: {
+        priority: number;
+    };
+    sourceAddress: string;
+    destinationAddress: string;
+    data: Buffer;
+}
+export interface A_Poll_Data_req {
+    pollingGroup: string;
+    numberOfSlots: number;
+}
+export interface A_Poll_Data_con {
+    sourceAddress: string;
+    pollingGroup: string;
+    numberOfSlots: number;
+    pollData: Buffer;
+}

package/dist/@types/interfaces/EMI.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/@types/interfaces/ServiceMessage.d.ts

@@ -0,0 +1,11 @@
+export interface DescribeEstructure {
+    /**
+     * Proporciona una descripción legible del estado actual de las propiedades del sistema.
+     * @returns Un objeto que describe el estado de cada propiedad.
+     */
+    describe(): Record<string, string | number | Buffer | Record<string, any>>;
+}
+export interface ServiceMessage extends DescribeEstructure {
+    /** Write the service to the buffer */
+    toBuffer(): Buffer;
+}

package/dist/@types/interfaces/ServiceMessage.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/@types/interfaces/SystemStatus.d.ts

@@ -0,0 +1,18 @@
+export interface StatusValues {
+    frameError: boolean;
+    bitError: boolean;
+    parityError: boolean;
+    overflow: boolean;
+    lost: boolean;
+    sequenceNumber: 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7;
+}
+export interface SystemStatusValues {
+    PROG?: false;
+    LLM?: boolean;
+    TLE?: boolean;
+    ALE?: boolean;
+    SE?: boolean;
+    UE?: boolean;
+    DM?: false;
+    PARITY?: boolean;
+}

package/dist/@types/interfaces/SystemStatus.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/@types/interfaces/connection.d.ts

@@ -0,0 +1,139 @@
+import { LoggerOptions } from "pino";
+import { ConnectionType } from "../../core/enum/KNXnetIPEnum";
+/**
+ * Options for configuring a KNX Tunneling connection.
+ */
+export interface KNXTunnelingOptions extends KNXnetIPOptions {
+    /**
+     * The transport protocol to use for the connection.
+     * 'UDP' is the default and standard for KNXnet/IP.
+     * 'TCP' is optional and used for connection-oriented communication.
+     */
+    transport?: "UDP" | "TCP";
+    /**
+     * The type of connection to establish.
+     * Defaults to TUNNEL_CONNECTION (0x04) for standard telegram exchange.
+     * Use DEVICE_MGMT_CONNECTION (0x03) for device configuration and management.
+     */
+    connectionType?: ConnectionType;
+    /**
+     * If true, sends a "Route Back" HPAI (IP 0.0.0.0 and port 0).
+     * This instructs the KNXnet/IP server to respond directly to the source IP and port
+     * from which the request originated. Essential for environments with NAT,
+     * firewalls, or VPNs like ZeroTier.
+     */
+    useRouteBack?: boolean;
+    /**
+     * Maximum number of messages allowed in the outgoing queue.
+     * Defaults to 100.
+     */
+    maxQueueSize?: number;
+}
+export interface KNXnetIPServerOptions extends KNXnetIPOptions {
+    individualAddress?: string;
+    serialNumber?: Buffer;
+    friendlyName?: string;
+    macAddress?: string;
+    /**
+     * Defines the client address pool for KNXnet/IP Tunneling connections (e.g. "15.15.10:10" or "1.1.1:5").
+     * Format: "START_ADDRESS:COUNT". This dictates how many tunneling clients can connect concurrently
+     * and which individual addresses they will receive. Defaults to 15 connections starting from Area.Line.1.
+     */
+    clientAddrs?: string;
+    /**
+     * The minimum delay between two consecutive ROUTING_INDICATION frames sent to the bus.
+     * Default is 20ms (standard for TP1 compatibility).
+     * Setting this to a lower value can increase performance but may flood slow KNX segments.
+     */
+    routingDelay?: number;
+    /**
+     * Optional configuration for bridging to external connections (TPUART, Tunneling).
+     */
+    externals?: ExternalManagerOptions;
+    /**
+     * It abruptly stops a Tunneling client connection if it exceeds this limit of request messages per second; this is done to prevent performance degradation (the default is 100); to disable it, set it to less than 1
+     */
+    MAX_PENDING_REQUESTS_PER_CLIENT?: number;
+    /**
+     * If true, the server will join the multicast group on all valid host network interfaces (Multi-homing).
+     * This improves discovery in multi-interface systems but can be disabled for specific network isolation.
+     * Defaults to true.
+     */
+    useAllInterfaces?: boolean;
+}
+export interface ExternalManagerOptions {
+    /**
+     * Optional configuration for a physical TPUART connection.
+     */
+    tpuart?: TPUARTOptions;
+    /**
+     * Optional list of outbound KNX IP Tunneling client connections.
+     */
+    tunneling?: KNXTunnelingOptions[];
+    /**
+     * Pino logger configuration for the Router bridge.
+     */
+    logOptions?: LoggerOptions;
+}
+export interface KNXLoggerOptions extends LoggerOptions {
+    /**
+     * Use pino-pretty but it's slow
+     */
+    pretty?: boolean;
+    /**
+     * Enable or disable logging. Defaults to true.
+     */
+    enabled?: boolean;
+    /**
+     * If true, logs will be written to a file using pino-roll.
+     */
+    logToFile?: boolean;
+    /**
+     * Directory where log files will be stored. Defaults to './logs'.
+     */
+    logDir?: string;
+    /**
+     * Filename for the log file. If not provided, it defaults to YYYY-MM-DD.log.
+     */
+    logFilename?: string;
+    /**
+     * Max size of a single log file before rotation (e.g., '10M', '1G').
+     */
+    logSize?: string;
+    /**
+     * Rotation interval (e.g., '1d', '1h').
+     */
+    logInterval?: string;
+    /**
+     * Number of rotated log files to keep.
+     */
+    logKeepCount?: number;
+}
+export interface KNXnetIPOptions {
+    ip?: string;
+    port?: number;
+    localIp?: string;
+    localPort?: number;
+    /**
+     * Pino logger configuration.
+     */
+    logOptions?: KNXLoggerOptions;
+}
+export interface TPUARTOptions extends KNXnetIPOptions {
+    /**
+     * The serial port path (e.g., "/dev/ttyS0" or "COM3").
+     */
+    path: string;
+    /**
+     * Optional physical address to assign to the TPUART chip (e.g., "1.1.255").
+     */
+    individualAddress?: string;
+    /**
+     * If true, the TPUART will send an ACK for all group telegrams.
+     */
+    ackGroup?: boolean;
+    /**
+     * If true, the TPUART will send an ACK for all individual telegrams.
+     */
+    ackIndividual?: boolean;
+}

package/dist/@types/interfaces/connection.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/@types/interfaces/localEndPoint.d.ts

@@ -0,0 +1,5 @@
+export interface LocalEndPoint {
+    host: string;
+    port: number;
+    toBytes: () => Buffer<ArrayBuffer>;
+}

package/dist/@types/interfaces/localEndPoint.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/@types/types/AllDpts.d.ts

@@ -0,0 +1,3 @@
+import { KnxDataEncoder } from "../../core/data/KNXDataEncode";
+import { DPT1, DPT2, DPT3, DPT4, DPT5, DPT5001, DPT5002, DPT6, DPT6020, DPT7, DPT8, DPT9, DPT10001, DPT11001, DPT12001, DPT13001, DPT14, DPT15, DPT16, DPT16002, DPT20, DPT27001, DPT28001, DPT238600, DPT245600, DPT250600, DPT251600, DPT29 } from "../interfaces/DPTs";
+export type AllDpts<Dpt extends (typeof KnxDataEncoder.dptEnum)[number] | string | null> = Dpt extends 1 | "1" | `1.${number}` ? DPT1 : Dpt extends 2 | "2" | `2.${number}` ? DPT2 : Dpt extends 3007 | "3.007" | 3008 | "3.008" ? DPT3 : Dpt extends 4001 | "4.001" | 4 | "4" | `4.${number}` ? DPT4 : Dpt extends 5001 | "5.001" ? DPT5001 : Dpt extends 5002 | "5.002" ? DPT5002 : Dpt extends 5 | "5" | `5.${number}` ? DPT5 : Dpt extends 6020 | "6.020" ? DPT6020 : Dpt extends 6 | "6" | 6010 | "6.010" | `6.${number}` ? DPT6 : Dpt extends 7 | "7" | `7.${number}` ? DPT7 : Dpt extends 8 | "8" | `8.${number}` ? DPT8 : Dpt extends 9 | "9" | `9.${number}` ? DPT9 : Dpt extends 10001 | "10.001" | 10 | "10" | `10.${number}` ? DPT10001 : Dpt extends 11001 | "11.001" | 11 | "11" | `11.${number}` ? DPT11001 : Dpt extends 12 | "12" | `12.${number}` ? DPT12001 : Dpt extends 13 | "13" | `13.${number}` ? DPT13001 : Dpt extends 14 | "14" | `14.${number}` ? DPT14 : Dpt extends 15 | "15" | `15.${number}` ? DPT15 : Dpt extends 16002 | "16.002" ? DPT16002 : Dpt extends 16 | "16" | `16.${number}` ? DPT16 : Dpt extends 20 | "20" | `20.${number}` ? DPT20 : Dpt extends 27001 | "27.001" | 27 | "27" | `27.${number}` ? DPT27001 : Dpt extends 28001 | "28.001" | 28 | "28" | `28.${number}` ? DPT28001 : Dpt extends 29 | "29" | `29.${number}` ? DPT29 : Dpt extends 238600 | "238.600" ? DPT238600 : Dpt extends 245600 | "245.600" ? DPT245600 : Dpt extends 250600 | "250.600" ? DPT250600 : Dpt extends 251600 | "251.600" ? DPT251600 : Buffer;

package/dist/@types/types/AllDpts.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// #endregion

package/dist/@types/types/DecodedDPTType.d.ts

@@ -0,0 +1,21 @@
+import { KnxDataDecode } from "../../core/data/KNXDataDecode";
+type decode = typeof KnxDataDecode;
+export type DecodedDPT1 = ReturnType<decode["asDpt1"]>;
+export type DecodedDPT2 = ReturnType<decode["asDpt2"]>;
+export type DecodedDPT3007 = ReturnType<decode["asDpt3007"]>;
+export type DecodedDPT3008 = ReturnType<decode["asDpt3008"]>;
+export type DecodedDPT6020 = ReturnType<decode["asDpt6020"]>;
+export type DecodedDPT7012 = ReturnType<decode["asDpt7012"]>;
+export type DecodedDPT10001 = ReturnType<decode["asDpt10001"]>;
+export type DecodedDPT11001 = ReturnType<decode["asDpt11001"]>;
+export type DecodedDPTValueUnit = ReturnType<decode["asDpt12001"]> | ReturnType<decode["asDpt12002"]>;
+export type DecodedDPT15000 = ReturnType<decode["asDpt15000"]>;
+export type DecodedDPT16002 = ReturnType<decode["asDpt16002"]>;
+export type DecodedDPT27001 = ReturnType<decode["asDpt27001"]>;
+export type DecodedDPT232600 = ReturnType<decode["asDpt232600"]>;
+export type DecodedDPT238600 = ReturnType<decode["asDpt238600"]>;
+export type DecodedDPT245600 = ReturnType<decode["asDpt245600"]>;
+export type DecodedDPT250600 = ReturnType<decode["asDpt250600"]>;
+export type DecodedDPT251600 = ReturnType<decode["asDpt251600"]>;
+export type DecodedDPTType<T extends number | string> = T extends 1 | "1" | `1.${number}` ? DecodedDPT1 : T extends 2 | "2" | `2.${number}` ? DecodedDPT2 : T extends 3007 | "3.007" ? DecodedDPT3007 : T extends 3008 | "3.008" ? DecodedDPT3008 : T extends 4001 | "4.001" | 4002 | "4.002" | 4 | "4" | `4.${number}` ? string : T extends 5001 | "5.001" | 5002 | "5.002" ? string : T extends 5 | "5" | `5.${number}` ? number : T extends 6001 | "6.001" | 6010 | "6.010" ? string : T extends 6020 | "6.020" ? DecodedDPT6020 : T extends 6 | "6" | `6.${number}` ? number : T extends 7001 | "7.001" | 7002 | "7.002" | 7003 | "7.003" | 7004 | "7.004" | 7005 | "7.005" | 7006 | "7.006" | 7007 | "7.007" | 7011 | "7.011" | 7013 | "7.013" ? string : T extends 7012 | "7.012" ? DecodedDPT7012 : T extends 7 | "7" | `7.${number}` ? number : T extends 8 | "8" | `8.${number}` ? number : T extends 9 | "9" | `9.${number}` ? number : T extends 10001 | "10.001" | 10 | "10" | `10.${number}` ? DecodedDPT10001 : T extends 11001 | "11.001" | 11 | "11" | `11.${number}` ? DecodedDPT11001 : T extends 12001 | "12.001" | 12002 | "12.002" | 12 | "12" | `12.${number}` ? DecodedDPTValueUnit : T extends 13001 | "13.001" | 13002 | "13.002" | 13010 | "13.010" | 13011 | "13.011" | 13012 | "13.012" | 13013 | "13.013" | 13014 | "13.014" | 13015 | "13.015" | 13016 | "13.016" | 13100 | "13.100" ? DecodedDPTValueUnit : T extends 13 | "13" | `13.${number}` ? number : T extends 14 | "14" | `14.${number}` ? number : T extends 15000 | "15.000" | 15 | "15" | `15.${number}` ? DecodedDPT15000 : T extends 16002 | "16.002" ? DecodedDPT16002 : T extends 16 | "16" | `16.${number}` ? string : T extends 20001 | "20.001" | 20002 | "20.002" | 20003 | "20.003" | 20004 | "20.004" | 20005 | "20.005" | 20006 | "20.006" | 20007 | "20.007" | 20008 | "20.008" | 20011 | "20.011" | 20012 | "20.012" | 20013 | "20.013" | 20014 | "20.014" | 20017 | "20.017" | 20020 | "20.020" | 20021 | "20.021" | 20022 | "20.022" ? string : T extends 20 | "20" | `20.${number}` ? number : T extends 27001 | "27.001" | 27 | "27" | `27.${number}` ? DecodedDPT27001 : T extends 28001 | "28.001" | 28 | "28" | `28.${number}` ? string : T extends 29010 | "29.010" | 29011 | "29.011" | 29012 | "29.012" | 29 | "29" | `29.${number}` ? number : T extends 232600 | "232.600" ? DecodedDPT232600 : T extends 238600 | "238.600" ? DecodedDPT238600 : T extends 245600 | "245.600" ? DecodedDPT245600 : T extends 250600 | "250.600" ? DecodedDPT250600 : T extends 251600 | "251.600" ? DecodedDPT251600 : any;
+export {};

package/dist/@types/types/DecodedDPTType.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/connection/KNXService.d.ts

@@ -0,0 +1,58 @@
+import { EventEmitter } from "events";
+import dgram from "dgram";
+import net from "net";
+import { SRP } from "../core/KNXnetIPStructures";
+import { ServiceMessage } from "../@types/interfaces/ServiceMessage";
+import { KnxDataEncoder } from "../core/data/KNXDataEncode";
+import { AllDpts } from "../@types/types/AllDpts";
+import { KNXnetIPOptions, KNXnetIPServerOptions, KNXTunnelingOptions, TPUARTOptions } from "../@types/interfaces/connection";
+import { Logger } from "pino";
+export declare abstract class KNXService extends EventEmitter {
+    protected socket: dgram.Socket | net.Socket | null;
+    readonly options: KNXnetIPOptions | KNXnetIPServerOptions | KNXTunnelingOptions | TPUARTOptions;
+    protected _transport: "UDP" | "TCP";
+    protected logger: Logger;
+    constructor(options?: KNXnetIPOptions | KNXnetIPServerOptions | KNXTunnelingOptions | TPUARTOptions);
+    abstract connect(): Promise<void>;
+    abstract disconnect(): void;
+    abstract send(data: Buffer | ServiceMessage): Promise<void>;
+    /**
+     * Optional: Enable or disable busmonitor mode.
+     */
+    setBusmonitor?(enabled: boolean): Promise<void>;
+    /**
+     * Optional: Overriden by links that support selective routing (knxd pattern).
+     * Return false to block a specific group address.
+     */
+    shouldFilterGroup?(groupAddress: string): boolean;
+    /**
+     * Optional: Overriden by links that support selective routing (knxd pattern).
+     * Return false to block a specific individual address.
+     */
+    shouldFilterIA?(individualAddress: string): boolean;
+    /**
+     * Send a GroupValue_Write telegram to a group address.
+     * @param destination The group address (e.g., "1/1/1")
+     * @param value The value to write.
+     * @param dpt Optional Datapoint Type to help with encoding.
+     */
+    write<T extends (typeof KnxDataEncoder.dptEnum)[number] | string | null>(destination: string, dpt: T, value: AllDpts<T>): Promise<void>;
+    /**
+     * Send a GroupValue_Read telegram to a group address.
+     * @param destination The group address (e.g., "1/1/1")
+     */
+    read(destination: string): Promise<void>;
+    /**
+     * Discovery Process (Search Request)
+     */
+    static discover(timeout?: number, localIp?: string): Promise<any[]>;
+    /**
+     * Extended Discovery Process (Search Request Extended)
+     * Allows searching with filters (SRPs).
+     */
+    static discoverExtended(srps: SRP[], timeout?: number, localIp?: string): Promise<any[]>;
+    /**
+     * Description Request (Self Description)   * Queries a specific device for its capabilities.
+     */
+    describe(): Promise<any>;
+}