@willieee802/zigbee-herdsman 0.49.1 → 0.49.2

package/dist/controller/helpers/requestQueue.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestQueue = void 0;
+const es6_1 = __importDefault(require("fast-deep-equal/es6"));
+const logger_1 = require("../../utils/logger");
+const NS = "zh:controller:requestqueue";
+class RequestQueue extends Set {
+    sendInProgress;
+    id;
+    deviceIeeeAddress;
+    constructor(endpoint) {
+        super();
+        this.sendInProgress = false;
+        this.id = endpoint.ID;
+        this.deviceIeeeAddress = endpoint.deviceIeeeAddress;
+    }
+    async send(fastPolling) {
+        if (this.size === 0)
+            return;
+        if (!fastPolling && this.sendInProgress) {
+            logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): sendPendingRequests already in progress`, NS);
+            return;
+        }
+        this.sendInProgress = true;
+        // Remove expired requests first
+        const now = Date.now();
+        for (const request of this) {
+            if (now > request.expires) {
+                logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): discard after timeout. Size before: ${this.size}`, NS);
+                request.reject();
+                this.delete(request);
+            }
+        }
+        logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): send pending requests (${this.size}, ${fastPolling})`, NS);
+        for (const request of this) {
+            if (fastPolling || request.sendPolicy !== "bulk") {
+                try {
+                    const result = await request.send();
+                    logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): send success`, NS);
+                    request.resolve(result);
+                    this.delete(request);
+                }
+                catch (error) {
+                    logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): send failed, expires in ` +
+                        `${(request.expires - now) / 1000} seconds (${error.message})`, NS);
+                }
+            }
+        }
+        this.sendInProgress = false;
+    }
+    async queue(request) {
+        logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): Sending when active. Expires: ${request.expires}`, NS);
+        return await new Promise((resolve, reject) => {
+            request.addCallbacks(resolve, reject);
+            this.add(request);
+        });
+    }
+    filter(newRequest) {
+        if (this.size === 0 || !newRequest.frame.command) {
+            return;
+        }
+        const clusterID = newRequest.frame.cluster.ID;
+        const payload = newRequest.frame.payload;
+        const commandID = newRequest.frame.command.ID;
+        logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): ZCL ${newRequest.frame.command.name} ` +
+            `command, filter requests. Before: ${this.size}`, NS);
+        for (const request of this) {
+            if (request?.frame?.cluster?.ID === undefined || !request.frame.command) {
+                continue;
+            }
+            if (request.sendPolicy === "bulk" || request.sendPolicy === "queue" || request.sendPolicy === "immediate") {
+                continue;
+            }
+            if (request.frame.cluster.ID === clusterID && request.frame.command.ID === commandID) {
+                if (newRequest.sendPolicy === "keep-payload" && (0, es6_1.default)(request.frame.payload, payload)) {
+                    logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): Merge duplicate request`, NS);
+                    this.delete(request);
+                    newRequest.moveCallbacks(request);
+                }
+                else if ((newRequest.sendPolicy === "keep-command" || newRequest.sendPolicy === "keep-cmd-undiv") &&
+                    Array.isArray(request.frame.payload)) {
+                    const filteredPayload = request.frame.payload.filter((oldEl) => !payload.find((newEl) => oldEl.attrId === newEl.attrId));
+                    if (filteredPayload.length === 0) {
+                        logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): Remove & reject request`, NS);
+                        if ((0, es6_1.default)(request.frame.payload, payload)) {
+                            newRequest.moveCallbacks(request);
+                        }
+                        else {
+                            request.reject(new Error("Request superseded"));
+                        }
+                        this.delete(request);
+                    }
+                    else if (newRequest.sendPolicy !== "keep-cmd-undiv") {
+                        // remove all duplicate attributes if we shall not write undivided
+                        request.frame.payload = filteredPayload;
+                        logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): Remove commands from request`, NS);
+                    }
+                }
+            }
+        }
+        logger_1.logger.debug(`Request Queue (${this.deviceIeeeAddress}/${this.id}): After: ${this.size}`, NS);
+    }
+}
+exports.RequestQueue = RequestQueue;
+exports.default = RequestQueue;
+//# sourceMappingURL=requestQueue.js.map

package/dist/controller/helpers/requestQueue.js.map

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

package/dist/controller/helpers/zclFrameConverter.d.ts

@@ -0,0 +1,7 @@
+import * as Zcl from "../../zspec/zcl";
+import type { CustomClusters } from "../../zspec/zcl/definition/tstype";
+import type { ClusterOrRawWriteAttributes, TCustomCluster } from "../tstype";
+declare function attributeKeyValue<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(frame: Zcl.Frame, deviceManufacturerID: number | undefined, customClusters: CustomClusters): ClusterOrRawWriteAttributes<Cl, Custom>;
+declare function attributeList(frame: Zcl.Frame, deviceManufacturerID: number | undefined, customClusters: CustomClusters): Array<string | number>;
+export { attributeKeyValue, attributeList };
+//# sourceMappingURL=zclFrameConverter.d.ts.map

package/dist/controller/helpers/zclTransactionSequenceNumber.d.ts

@@ -0,0 +1,8 @@
+declare class ZclTransactionSequenceNumber {
+    private sequence;
+    get current(): number;
+    next(): number;
+}
+declare const _default: ZclTransactionSequenceNumber;
+export default _default;
+//# sourceMappingURL=zclTransactionSequenceNumber.d.ts.map

package/dist/controller/helpers/zclTransactionSequenceNumber.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zclTransactionSequenceNumber.d.ts","sourceRoot":"","sources":["../../../src/controller/helpers/zclTransactionSequenceNumber.ts"],"names":[],"mappings":"AAAA,cAAM,4BAA4B;IAC9B,OAAO,CAAC,QAAQ,CAAM;IAEtB,IAAI,OAAO,WAEV;IAEM,IAAI,IAAI,MAAM;CAKxB;;AAED,wBAAkD"}

package/dist/controller/helpers/zclTransactionSequenceNumber.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class ZclTransactionSequenceNumber {
+    sequence = -1;
+    get current() {
+        return this.sequence;
+    }
+    next() {
+        this.sequence = (this.sequence + 1) % 256;
+        return this.sequence;
+    }
+}
+exports.default = new ZclTransactionSequenceNumber();
+//# sourceMappingURL=zclTransactionSequenceNumber.js.map

package/dist/controller/helpers/zclTransactionSequenceNumber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zclTransactionSequenceNumber.js","sourceRoot":"","sources":["../../../src/controller/helpers/zclTransactionSequenceNumber.ts"],"names":[],"mappings":";;AAAA,MAAM,4BAA4B;IACtB,QAAQ,GAAG,CAAC,CAAC,CAAC;IAEtB,IAAI,OAAO;QACP,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAEM,IAAI;QACP,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;QAE1C,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;CACJ;AAED,kBAAe,IAAI,4BAA4B,EAAE,CAAC"}

package/dist/controller/index.d.ts

@@ -0,0 +1,6 @@
+import Controller from "./controller";
+/**
+ * @internal
+ */
+export { Controller };
+//# sourceMappingURL=index.d.ts.map

package/dist/controller/index.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Controller = void 0;
+const controller_1 = __importDefault(require("./controller"));
+exports.Controller = controller_1.default;
+//# sourceMappingURL=index.js.map

package/dist/controller/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/controller/index.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAsC;AAK9B,qBALD,oBAAU,CAKC"}

package/dist/controller/model/device.d.ts

@@ -0,0 +1,150 @@
+import { Events as AdapterEvents } from '../../adapter';
+import type { Eui64 } from "../../zspec/tstypes";
+import * as Zcl from "../../zspec/zcl";
+import type { TClusterCommandPayload, TPartialClusterAttributes } from "../../zspec/zcl/definition/clusters-types";
+import type { ClusterDefinition, CustomClusters } from "../../zspec/zcl/definition/tstype";
+import type { BindingTableEntry, LQITableEntry, RoutingTableEntry } from "../../zspec/zdo/definition/tstypes";
+import type { ControllerEventMap } from "../controller";
+import type { DeviceType, KeyValue, OtaDataSettings, OtaExtraMetas, OtaSource, OtaUpdateAvailableResult, ZigbeeOtaImageMeta } from "../tstype";
+import Endpoint from "./endpoint";
+import Entity from "./entity";
+type CustomReadResponse = (frame: Zcl.Frame, endpoint: Endpoint) => boolean;
+export declare enum InterviewState {
+    Pending = "PENDING",
+    InProgress = "IN_PROGRESS",
+    Successful = "SUCCESSFUL",
+    Failed = "FAILED"
+}
+export declare class Device extends Entity<ControllerEventMap> {
+    #private;
+    private databaseID;
+    private readonly ID;
+    private _endpoints;
+    private _ieeeAddr;
+    private _interviewState;
+    private _lastSeen?;
+    private _manufacturerID?;
+    private _networkAddress;
+    private _type;
+    private _linkquality?;
+    private _skipDefaultResponse;
+    private _customReadResponse?;
+    private _lastDefaultResponseSequenceNumber?;
+    private _checkinInterval?;
+    private _pendingRequestTimeout;
+    private _customClusters;
+    private _gpSecurityKey?;
+    get ieeeAddr(): string;
+    set ieeeAddr(ieeeAddr: string);
+    get applicationVersion(): number | undefined;
+    set applicationVersion(version: number);
+    get endpoints(): Endpoint[];
+    get interviewState(): InterviewState;
+    get lastSeen(): number | undefined;
+    get manufacturerID(): number | undefined;
+    get isDeleted(): boolean;
+    set type(type: DeviceType);
+    get type(): DeviceType;
+    get dateCode(): string | undefined;
+    set dateCode(code: string);
+    set hardwareVersion(version: number);
+    get hardwareVersion(): number | undefined;
+    get manufacturerName(): string | undefined;
+    set manufacturerName(name: string | undefined);
+    set modelID(id: string);
+    get modelID(): string | undefined;
+    get networkAddress(): number;
+    set networkAddress(networkAddress: number);
+    get powerSource(): string | undefined;
+    set powerSource(source: string | number);
+    get softwareBuildID(): string | undefined;
+    set softwareBuildID(id: string);
+    get stackVersion(): number | undefined;
+    set stackVersion(version: number);
+    get zclVersion(): number | undefined;
+    set zclVersion(version: number);
+    get linkquality(): number | undefined;
+    set linkquality(linkquality: number);
+    get skipDefaultResponse(): boolean;
+    set skipDefaultResponse(skipDefaultResponse: boolean);
+    get customReadResponse(): CustomReadResponse | undefined;
+    set customReadResponse(customReadResponse: CustomReadResponse | undefined);
+    get checkinInterval(): number | undefined;
+    set checkinInterval(checkinInterval: number | undefined);
+    get pendingRequestTimeout(): number;
+    set pendingRequestTimeout(pendingRequestTimeout: number);
+    get customClusters(): CustomClusters;
+    get gpSecurityKey(): number[] | undefined;
+    get genBasic(): TPartialClusterAttributes<"genBasic">;
+    get scheduledOta(): OtaSource | undefined;
+    get otaInProgress(): boolean;
+    meta: KeyValue;
+    private static readonly devices;
+    private static loadedFromDatabase;
+    private static readonly deletedDevices;
+    private static readonly nwkToIeeeCache;
+    private constructor();
+    createEndpoint(id: number): Endpoint;
+    changeIeeeAddress(ieeeAddr: string): void;
+    getEndpoint(id: number): Endpoint | undefined;
+    getEndpointByDeviceType(deviceType: string): Endpoint | undefined;
+    updateGenBasic(data: TPartialClusterAttributes<"genBasic">): void;
+    implicitCheckin(): void;
+    updateLastSeen(): void;
+    private resetPendingRequestTimeout;
+    private hasPendingRequests;
+    onZclData(dataPayload: AdapterEvents.ZclPayload, frame: Zcl.Frame, endpoint: Endpoint): Promise<void>;
+    /**
+     * Reset runtime lookups.
+     */
+    static resetCache(): void;
+    private static fromDatabaseEntry;
+    private toDatabaseEntry;
+    save(writeDatabase?: boolean): void;
+    private static loadFromDatabaseIfNecessary;
+    static find(databaseID: number, ieeeOrNwkAddress: string | number, includeDeleted?: boolean): Device | undefined;
+    static byIeeeAddr(databaseID: number, ieeeAddr: string, includeDeleted?: boolean): Device | undefined;
+    static byNetworkAddress(databaseID: number, networkAddress: number, includeDeleted?: boolean): Device | undefined;
+    static byType(databaseID: number, type: DeviceType): Device[];
+    static allByDatabaseID(databaseID: number): Device[];
+    /** Check if a device is explicitly deleted */
+    static isDeletedByIeeeAddr(databaseID: number, ieeeAddr: string): boolean;
+    /** Check if a device is explicitly deleted */
+    static isDeletedByNetworkAddress(databaseID: number, networkAddress: number): boolean;
+    static allIterator(databaseID: number, predicate?: (value: Device) => boolean): Generator<Device>;
+    undelete(): void;
+    static create(type: DeviceType, ieeeAddr: string, networkAddress: number, manufacturerID: number | undefined, manufacturerName: string | undefined, powerSource: string | undefined, modelID: string | undefined, interviewState: InterviewState, gpSecurityKey: number[] | undefined, databaseID: number): Device;
+    interview(ignoreCache?: boolean): Promise<void>;
+    private interviewQuirks;
+    private interviewInternal;
+    updateNodeDescriptor(): Promise<void>;
+    updateActiveEndpoints(): Promise<void>;
+    /**
+     * Request device to advertise its network address.
+     * Note: This does not actually update the device property (if needed), as this is already done with `zdoResponse` event in Controller.
+     */
+    requestNetworkAddress(): Promise<void>;
+    removeFromNetwork(): Promise<void>;
+    removeFromDatabase(): void;
+    lqi(): Promise<LQITableEntry[]>;
+    routingTable(): Promise<RoutingTableEntry[]>;
+    bindingTable(): Promise<BindingTableEntry[]>;
+    /**
+     * Clear all the bindings of a device.
+     * Support of this command is optional (only mandatory if device has a binding table).
+     * @param eui64List list of bind entries to match and clear. Send `["0xffffffffffffffff"]` to clear all.
+     */
+    clearAllBindings(eui64List: Eui64[]): Promise<void>;
+    ping(disableRecovery?: boolean): Promise<void>;
+    addCustomCluster(name: string, cluster: ClusterDefinition): void;
+    findMatchingOtaImage(source: OtaSource, current: TClusterCommandPayload<"genOta", "queryNextImageRequest">, extraMetas: OtaExtraMetas): Promise<ZigbeeOtaImageMeta | undefined>;
+    /**
+     * If `current` is undefined, will automatically notify and reply to query with `NO_IMAGE_AVAILABLE` (stops device from doing further requests).
+     */
+    checkOta(source: OtaSource, current: TClusterCommandPayload<"genOta", "queryNextImageRequest"> | undefined, extraMetas: OtaExtraMetas, endpoint?: Endpoint | undefined): Promise<OtaUpdateAvailableResult>;
+    updateOta(source: Readonly<OtaSource> | undefined, requestPayload: TClusterCommandPayload<"genOta", "queryNextImageRequest"> | undefined, requestTsn: number | undefined, extraMetas: Readonly<OtaExtraMetas>, onProgress: (progress: number, remaining: number) => void, dataSettings: OtaDataSettings, endpoint?: Endpoint | undefined): Promise<[from: OtaUpdateAvailableResult["current"], to: OtaUpdateAvailableResult["current"] | undefined]>;
+    scheduleOta(source: OtaSource): void;
+    unscheduleOta(): void;
+}
+export default Device;
+//# sourceMappingURL=device.d.ts.map

package/dist/controller/model/endpoint.d.ts

@@ -0,0 +1,150 @@
+import { BroadcastAddress } from "../../zspec/enums";
+import * as Zcl from "../../zspec/zcl";
+import type { TFoundation } from "../../zspec/zcl/definition/clusters-types";
+import type * as ZclTypes from "../../zspec/zcl/definition/tstype";
+import type { ClusterOrRawAttributeKeys, ClusterOrRawAttributes, ClusterOrRawPayload, FoundationOrRawPayload, KeyValue, PartialClusterOrRawWriteAttributes, SendPolicy, TCustomCluster } from "../tstype";
+import Device from "./device";
+import Group from "./group";
+import { ZigbeeEntity } from "./zigbeeEntity";
+export interface ConfigureReportingItem<Cl extends string | number, Custom extends TCustomCluster | undefined = undefined> {
+    attribute: ClusterOrRawAttributeKeys<Cl, Custom>[number] | {
+        ID: number;
+        type: number;
+    };
+    minimumReportInterval: number;
+    maximumReportInterval: number;
+    reportableChange?: number;
+}
+export interface ReadReportConfigItem<Cl extends string | number, Custom extends TCustomCluster | undefined = undefined> {
+    direction?: Zcl.Direction;
+    attribute: ClusterOrRawAttributeKeys<Cl, Custom>[number] | {
+        ID: number;
+    };
+}
+interface Options {
+    manufacturerCode?: number;
+    disableDefaultResponse?: boolean;
+    disableResponse?: boolean;
+    timeout?: number;
+    direction?: Zcl.Direction;
+    srcEndpoint?: number;
+    profileId?: number;
+    reservedBits?: number;
+    transactionSequenceNumber?: number;
+    disableRecovery?: boolean;
+    writeUndiv?: boolean;
+    sendPolicy?: SendPolicy;
+}
+interface Clusters {
+    [cluster: string]: {
+        attributes: {
+            [attribute: string]: number | string;
+        };
+    };
+}
+export interface BindInternal {
+    cluster: number;
+    type: "endpoint" | "group";
+    deviceIeeeAddress?: string;
+    endpointID?: number;
+    groupID?: number;
+}
+interface Bind {
+    cluster: ZclTypes.Cluster;
+    target: Endpoint | Group;
+}
+interface ConfiguredReporting {
+    cluster: ZclTypes.Cluster;
+    attribute: ZclTypes.Attribute;
+    minimumReportInterval: number;
+    maximumReportInterval: number;
+    reportableChange: number;
+}
+export declare class Endpoint extends ZigbeeEntity {
+    private databaseID;
+    deviceID?: number;
+    inputClusters: number[];
+    outputClusters: number[];
+    profileID?: number;
+    readonly ID: number;
+    readonly clusters: Clusters;
+    deviceIeeeAddress: string;
+    deviceNetworkAddress: number;
+    private _binds;
+    private _configuredReportings;
+    meta: KeyValue;
+    private pendingRequests;
+    get binds(): Bind[];
+    get configuredReportings(): ConfiguredReporting[];
+    private constructor();
+    /**
+     * Get device of this endpoint
+     */
+    getDevice(): Device;
+    /**
+     * @param {number|string} clusterKey
+     * @returns {boolean}
+     */
+    supportsInputCluster(clusterKey: number | string): boolean;
+    /**
+     * @param {number|string} clusterKey
+     * @returns {boolean}
+     */
+    supportsOutputCluster(clusterKey: number | string): boolean;
+    /**
+     * @returns {ZclTypes.Cluster[]}
+     */
+    getInputClusters(): ZclTypes.Cluster[];
+    /**
+     * @returns {ZclTypes.Cluster[]}
+     */
+    getOutputClusters(): ZclTypes.Cluster[];
+    private clusterNumbersToClusters;
+    static fromDatabaseRecord(record: KeyValue, deviceNetworkAddress: number, deviceIeeeAddress: string, databaseID: number): Endpoint;
+    toDatabaseRecord(): KeyValue;
+    static create(databaseID: number, id: number, profileID: number | undefined, deviceID: number | undefined, inputClusters: number[], outputClusters: number[], deviceNetworkAddress: number, deviceIeeeAddress: string): Endpoint;
+    saveClusterAttributeKeyValue(clusterKey: number | string, list: KeyValue): void;
+    getClusterAttributeValue(clusterKey: number | string, attributeKey: number | string): number | string | undefined;
+    saveClusterAttributeReportConfig(clusterId: number, manufacturerCode: Zcl.ManufacturerCode | undefined, reportConfigs: TFoundation["readReportConfigRsp"]): void;
+    saveBindings(binds: BindInternal[]): void;
+    clearBindings(): void;
+    hasPendingRequests(): boolean;
+    sendPendingRequests(fastPolling: boolean): Promise<void>;
+    private sendRequest;
+    private checkStatus;
+    report<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, attributes: PartialClusterOrRawWriteAttributes<Cl, Custom>, options?: Options): Promise<void>;
+    write<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, attributes: PartialClusterOrRawWriteAttributes<Cl, Custom>, options?: Options): Promise<void>;
+    writeResponse<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, transactionSequenceNumber: number, attributes: Partial<Record<ClusterOrRawAttributeKeys<Cl, Custom>[number], TFoundation["writeRsp"][number]>> & Record<number, TFoundation["writeRsp"][number]>, options?: Options): Promise<void>;
+    read<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, attributes: ClusterOrRawAttributeKeys<Cl, Custom>, options?: Options): Promise<ClusterOrRawAttributes<Cl, Custom>>;
+    readResponse<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, transactionSequenceNumber: number, attributes: PartialClusterOrRawWriteAttributes<Cl, Custom>, options?: Options): Promise<void>;
+    updateSimpleDescriptor(): Promise<void>;
+    hasBind(clusterId: number, target: Endpoint | Group): boolean;
+    getBindIndex(clusterId: number, target: Endpoint | Group): number;
+    addBinding(clusterKey: number | string, target: Endpoint | Group | number): void;
+    private addBindingInternal;
+    bind(clusterKey: number | string, target: Endpoint | Group | number): Promise<void>;
+    save(): void;
+    unbind(clusterKey: number | string, target: Endpoint | Group | number, force?: boolean): Promise<void>;
+    defaultResponse(commandID: number, status: number, clusterID: number, transactionSequenceNumber: number, options?: Options): Promise<void>;
+    configureReporting<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, items: ConfigureReportingItem<Cl, Custom>[], options?: Options): Promise<void>;
+    readReportingConfig<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, items: ReadReportConfigItem<Cl, Custom>[], options?: Options): Promise<TFoundation["readReportConfigRsp"]>;
+    writeStructured<Cl extends number | string>(clusterKey: Cl, payload: TFoundation["writeStructured"], options?: Options): Promise<void>;
+    command<Cl extends number | string, Co extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, commandKey: Co, payload: ClusterOrRawPayload<Cl, Co, Custom>, options?: Options): Promise<undefined | KeyValue>;
+    commandResponse<Cl extends number | string, Co extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, commandKey: Co, payload: ClusterOrRawPayload<Cl, Co, Custom>, options?: Options, transactionSequenceNumber?: number): Promise<void>;
+    private getOptionsWithDefaults;
+    private ensureManufacturerCodeIsUniqueAndGet;
+    addToGroup(group: Group): Promise<void>;
+    private getCluster;
+    /**
+     * Remove endpoint from a group, accepts both a Group and number as parameter.
+     * The number parameter type should only be used when removing from a group which is not known
+     * to zigbee-herdsman.
+     */
+    removeFromGroup(group: Group | number): Promise<void>;
+    removeFromAllGroups(): Promise<void>;
+    removeFromAllGroupsDatabase(): void;
+    zclCommand<Cl extends number | string, Co extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl | ZclTypes.Cluster, commandKey: Co | ZclTypes.Command, payload: ClusterOrRawPayload<Cl, Co, Custom> | FoundationOrRawPayload<Co>, options?: Options, logPayload?: KeyValue, checkStatus?: boolean, frameType?: Zcl.FrameType): Promise<undefined | Zcl.Frame>;
+    zclCommandBroadcast<Cl extends number | string, Co extends number | string, Custom extends TCustomCluster | undefined = undefined>(endpoint: number, destination: BroadcastAddress, clusterKey: Cl, commandKey: Co, payload: ClusterOrRawPayload<Cl, Co, Custom> | FoundationOrRawPayload<Co>, options?: Options): Promise<void>;
+}
+export default Endpoint;
+//# sourceMappingURL=endpoint.d.ts.map

package/dist/controller/model/entity.d.ts

@@ -0,0 +1,18 @@
+import events from "node:events";
+import type { Adapter } from "../../adapter";
+import type Database from "../database";
+type EventMap<T> = Record<keyof T, any[]> | DefaultEventMap;
+type DefaultEventMap = [never];
+export declare abstract class Entity<T extends EventMap<T> = DefaultEventMap> extends events.EventEmitter<T> {
+    protected static databases: Map<number, Database>;
+    protected static adapters: Map<number, Adapter>;
+    static injectDatabase(database: Database): void;
+    static injectAdapter(databaseID: number, adapter: Adapter): void;
+    static removeDatabase(databaseID: number): void;
+    static removeAdapter(databaseID: number): void;
+    static getAdapterByID(id: number): Adapter | undefined;
+    static databaseIDExists(id: number): boolean;
+    static getDatabaseByID(id: number): Database | undefined;
+}
+export default Entity;
+//# sourceMappingURL=entity.d.ts.map

package/dist/controller/model/entity.js

@@ -0,0 +1,35 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Entity = void 0;
+const node_events_1 = __importDefault(require("node:events"));
+class Entity extends node_events_1.default.EventEmitter {
+    static databases = new Map();
+    static adapters = new Map();
+    static injectDatabase(database) {
+        Entity.databases.set(database.id, database);
+    }
+    static injectAdapter(databaseID, adapter) {
+        Entity.adapters.set(databaseID, adapter);
+    }
+    static removeDatabase(databaseID) {
+        Entity.databases.delete(databaseID);
+    }
+    static removeAdapter(databaseID) {
+        Entity.adapters.delete(databaseID);
+    }
+    static getAdapterByID(id) {
+        return Entity.adapters.get(id);
+    }
+    static databaseIDExists(id) {
+        return Entity.databases.get(id) !== undefined;
+    }
+    static getDatabaseByID(id) {
+        return Entity.databases.get(id);
+    }
+}
+exports.Entity = Entity;
+exports.default = Entity;
+//# sourceMappingURL=entity.js.map

package/dist/controller/model/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../../src/controller/model/entity.ts"],"names":[],"mappings":";;;;;;AAAA,8DAAiC;AASjC,MAAsB,MAAgD,SAAQ,qBAAM,CAAC,YAAe;IACtF,MAAM,CAAC,SAAS,GAA0B,IAAI,GAAG,EAAoB,CAAC;IACtE,MAAM,CAAC,QAAQ,GAAyB,IAAI,GAAG,EAAmB,CAAC;IAEtE,MAAM,CAAC,cAAc,CAAC,QAAkB;QAC3C,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEM,MAAM,CAAC,aAAa,CAAC,UAAkB,EAAE,OAAgB;QAC5D,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAEM,MAAM,CAAC,cAAc,CAAC,UAAkB;QAC3C,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAEM,MAAM,CAAC,aAAa,CAAC,UAAkB;QAC1C,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvC,CAAC;IAEM,MAAM,CAAC,cAAc,CAAC,EAAU;QACnC,OAAO,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;IAEM,MAAM,CAAC,gBAAgB,CAAC,EAAU;QACrC,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;IAClD,CAAC;IAEM,MAAM,CAAC,eAAe,CAAC,EAAU;QACpC,OAAO,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpC,CAAC;;AA9BL,wBA+BC;AAED,kBAAe,MAAM,CAAC"}

package/dist/controller/model/group.d.ts

@@ -0,0 +1,50 @@
+import * as Zcl from "../../zspec/zcl";
+import type { CustomClusters } from "../../zspec/zcl/definition/tstype";
+import type { ClusterOrRawAttributeKeys, ClusterOrRawPayload, KeyValue, PartialClusterOrRawWriteAttributes, TCustomCluster } from "../tstype";
+import type Endpoint from "./endpoint";
+import { ZigbeeEntity } from "./zigbeeEntity";
+interface Options {
+    manufacturerCode?: number;
+    direction?: Zcl.Direction;
+    srcEndpoint?: number;
+    reservedBits?: number;
+    transactionSequenceNumber?: number;
+}
+export declare class Group extends ZigbeeEntity {
+    #private;
+    private databaseID;
+    private ID;
+    readonly groupID: number;
+    private readonly _members;
+    readonly meta: KeyValue;
+    private static readonly groups;
+    private static loadedFromDatabase;
+    /** Member endpoints with valid devices (not unknown/deleted) */
+    get members(): Endpoint[];
+    /** List of server / client custom clusters common to all devices in the group */
+    get customClusters(): [input: CustomClusters, output: CustomClusters];
+    private constructor();
+    /**
+     * Reset runtime lookups.
+     */
+    static resetCache(): void;
+    private static fromDatabaseEntry;
+    private toDatabaseRecord;
+    private static loadFromDatabaseIfNecessary;
+    static byGroupID(groupID: number, databaseID: number): Group | undefined;
+    static allByDatabaseID(databaseID: number): Group[];
+    static allIterator(databaseID: number, predicate?: (value: Group) => boolean): Generator<Group>;
+    static create(groupID: number, databaseID: number): Group;
+    removeFromNetwork(): Promise<void>;
+    removeFromDatabase(): void;
+    save(writeDatabase?: boolean): void;
+    addMember(endpoint: Endpoint): void;
+    removeMember(endpoint: Endpoint): void;
+    hasMember(endpoint: Endpoint): boolean;
+    write<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, attributes: PartialClusterOrRawWriteAttributes<Cl, Custom>, options?: Options): Promise<void>;
+    read<Cl extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, attributes: ClusterOrRawAttributeKeys<Cl, Custom>, options?: Options): Promise<undefined>;
+    command<Cl extends number | string, Co extends number | string, Custom extends TCustomCluster | undefined = undefined>(clusterKey: Cl, commandKey: Co, payload: ClusterOrRawPayload<Cl, Co, Custom>, options?: Options): Promise<undefined>;
+    private getOptionsWithDefaults;
+}
+export default Group;
+//# sourceMappingURL=group.d.ts.map

package/dist/controller/model/index.d.ts

@@ -0,0 +1,6 @@
+export { Device } from "./device";
+export { Endpoint } from "./endpoint";
+export { Entity } from "./entity";
+export { Group } from "./group";
+export { ZigbeeEntity } from "./zigbeeEntity";
+//# sourceMappingURL=index.d.ts.map

package/dist/controller/model/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZigbeeEntity = exports.Group = exports.Entity = exports.Endpoint = exports.Device = void 0;
+var device_1 = require("./device");
+Object.defineProperty(exports, "Device", { enumerable: true, get: function () { return device_1.Device; } });
+var endpoint_1 = require("./endpoint");
+Object.defineProperty(exports, "Endpoint", { enumerable: true, get: function () { return endpoint_1.Endpoint; } });
+var entity_1 = require("./entity");
+Object.defineProperty(exports, "Entity", { enumerable: true, get: function () { return entity_1.Entity; } });
+var group_1 = require("./group");
+Object.defineProperty(exports, "Group", { enumerable: true, get: function () { return group_1.Group; } });
+var zigbeeEntity_1 = require("./zigbeeEntity");
+Object.defineProperty(exports, "ZigbeeEntity", { enumerable: true, get: function () { return zigbeeEntity_1.ZigbeeEntity; } });
+//# sourceMappingURL=index.js.map

package/dist/controller/model/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/controller/model/index.ts"],"names":[],"mappings":";;;AAAA,mCAAgC;AAAxB,gGAAA,MAAM,OAAA;AACd,uCAAoC;AAA5B,oGAAA,QAAQ,OAAA;AAChB,mCAAgC;AAAxB,gGAAA,MAAM,OAAA;AACd,iCAA8B;AAAtB,8FAAA,KAAK,OAAA;AACb,+CAA4C;AAApC,4GAAA,YAAY,OAAA"}

package/dist/controller/model/konnextConfig.d.ts

@@ -0,0 +1,7 @@
+export type KonnextConfig = {
+    isEncrypted: number;
+    encryptMode?: string | null;
+    macAddress?: string | null;
+    secretKey?: string | null;
+};
+//# sourceMappingURL=konnextConfig.d.ts.map

package/dist/controller/model/konnextConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"konnextConfig.d.ts","sourceRoot":"","sources":["../../../src/controller/model/konnextConfig.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC"}

package/dist/controller/model/konnextConfig.js

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

package/dist/controller/model/konnextConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"konnextConfig.js","sourceRoot":"","sources":["../../../src/controller/model/konnextConfig.ts"],"names":[],"mappings":""}