@zwave-js/cc 14.0.0-beta.1 → 14.0.0-beta.5

package/build/lib/utils.js

@@ -1,860 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAssociations = getAssociations;
-exports.getAllAssociations = getAllAssociations;
-exports.checkAssociation = checkAssociation;
-exports.getAssociationGroups = getAssociationGroups;
-exports.getAllAssociationGroups = getAllAssociationGroups;
-exports.addAssociations = addAssociations;
-exports.removeAssociations = removeAssociations;
-exports.getLifelineGroupIds = getLifelineGroupIds;
-exports.configureLifelineAssociations = configureLifelineAssociations;
-exports.assignLifelineIssueingCommand = assignLifelineIssueingCommand;
-exports.doesAnyLifelineSendActuatorOrSensorReports = doesAnyLifelineSendActuatorOrSensorReports;
-const safe_1 = require("@zwave-js/core/safe");
-const safe_2 = require("@zwave-js/shared/safe");
-const arrays_1 = require("alcalzone-shared/arrays");
-const AssociationCC_1 = require("../cc/AssociationCC");
-const AssociationGroupInfoCC_1 = require("../cc/AssociationGroupInfoCC");
-const MultiChannelAssociationCC_1 = require("../cc/MultiChannelAssociationCC");
-const API_1 = require("./API");
-const _Types_1 = require("./_Types");
-function getAssociations(ctx, endpoint) {
-    const ret = new Map();
-    if (endpoint.supportsCC(safe_1.CommandClasses.Association)) {
-        const destinations = AssociationCC_1.AssociationCC.getAllDestinationsCached(ctx, endpoint);
-        for (const [groupId, assocs] of destinations) {
-            ret.set(groupId, assocs);
-        }
-    }
-    else {
-        throw new safe_1.ZWaveError(`Node ${endpoint.nodeId}${endpoint.index > 0 ? `, endpoint ${endpoint.index}` : ""} does not support associations!`, safe_1.ZWaveErrorCodes.CC_NotSupported);
-    }
-    // Merge the "normal" destinations with multi channel destinations
-    if (endpoint.supportsCC(safe_1.CommandClasses["Multi Channel Association"])) {
-        const destinations = MultiChannelAssociationCC_1.MultiChannelAssociationCC.getAllDestinationsCached(ctx, endpoint);
-        for (const [groupId, assocs] of destinations) {
-            if (ret.has(groupId)) {
-                const normalAssociations = ret.get(groupId);
-                ret.set(groupId, [
-                    ...normalAssociations,
-                    // Eliminate potential duplicates
-                    ...assocs.filter((a1) => !normalAssociations.some((a2) => a1.nodeId === a2.nodeId
-                        && a1.endpoint === a2.endpoint)),
-                ]);
-            }
-            else {
-                ret.set(groupId, assocs);
-            }
-        }
-    }
-    return ret;
-}
-function getAllAssociations(ctx, node) {
-    const ret = new safe_2.ObjectKeyMap();
-    for (const endpoint of node.getAllEndpoints()) {
-        const address = {
-            nodeId: node.id,
-            endpoint: endpoint.index,
-        };
-        if (endpoint.supportsCC(safe_1.CommandClasses.Association)) {
-            ret.set(address, getAssociations(ctx, endpoint));
-        }
-    }
-    return ret;
-}
-function checkAssociation(ctx, endpoint, group, destination) {
-    // Check that the target endpoint exists except when adding an association to the controller
-    const targetNode = ctx.getNodeOrThrow(destination.nodeId);
-    const targetEndpoint = destination.nodeId === ctx.ownNodeId
-        ? targetNode
-        : targetNode.getEndpointOrThrow(destination.endpoint ?? 0);
-    if (!endpoint.supportsCC(safe_1.CommandClasses.Association)
-        && !endpoint.supportsCC(safe_1.CommandClasses["Multi Channel Association"])) {
-        throw new safe_1.ZWaveError(`Node ${endpoint.nodeId}${endpoint.index > 0 ? `, endpoint ${endpoint.index}` : ""} does not support associations!`, safe_1.ZWaveErrorCodes.CC_NotSupported);
-    }
-    // Associations to and from ZWLR devices are not allowed
-    if ((0, safe_1.isLongRangeNodeId)(destination.nodeId)) {
-        return _Types_1.AssociationCheckResult.Forbidden_DestinationIsLongRange;
-    }
-    else if ((0, safe_1.isLongRangeNodeId)(endpoint.nodeId)) {
-        // Except the lifeline back to the host
-        if (group !== 1 || destination.nodeId !== ctx.ownNodeId) {
-            return _Types_1.AssociationCheckResult.Forbidden_SourceIsLongRange;
-        }
-    }
-    // The following checks don't apply to Lifeline associations
-    if (destination.nodeId === ctx.ownNodeId) {
-        return _Types_1.AssociationCheckResult.OK;
-    }
-    // Disallow self-associations
-    if (destination.nodeId === endpoint.nodeId) {
-        return _Types_1.AssociationCheckResult.Forbidden_SelfAssociation;
-    }
-    // For Association version 1 and version 2 / MCA version 1-3:
-    // A controlling node MUST NOT associate Node A to a Node B destination
-    // if Node A and Node B’s highest Security Class are not identical.
-    // For Association version 3 / MCA version 4:
-    // A controlling node MUST NOT associate Node A to a Node B destination
-    // if Node A was not granted Node B’s highest Security Class.
-    const sourceNode = ctx.getNode(endpoint.nodeId);
-    let securityClassMustMatch;
-    if (destination.endpoint == undefined) {
-        // "normal" association
-        const sourceNodeCCVersion = endpoint.getCCVersion(safe_1.CommandClasses.Association);
-        securityClassMustMatch = sourceNodeCCVersion < 3;
-    }
-    else {
-        // multi channel association
-        const sourceNodeCCVersion = endpoint.getCCVersion(safe_1.CommandClasses["Multi Channel Association"]);
-        securityClassMustMatch = sourceNodeCCVersion < 4;
-    }
-    const sourceSecurityClass = sourceNode.getHighestSecurityClass();
-    const targetSecurityClass = targetNode.getHighestSecurityClass();
-    // If the security classes are unknown, all bets are off
-    if (sourceSecurityClass != undefined && targetSecurityClass != undefined) {
-        if (securityClassMustMatch
-            && sourceSecurityClass !== targetSecurityClass) {
-            return _Types_1.AssociationCheckResult.Forbidden_SecurityClassMismatch;
-        }
-        else if (
-        // Commands to insecure nodes are allowed
-        targetSecurityClass !== safe_1.SecurityClass.None
-            // Otherwise, the sender must know the target's highest key
-            && !securityClassMustMatch
-            && !sourceNode.hasSecurityClass(targetSecurityClass)) {
-            return _Types_1.AssociationCheckResult
-                .Forbidden_DestinationSecurityClassNotGranted;
-        }
-    }
-    // SDS14223:
-    // A controlling node MUST NOT associate Node A to a Node B destination that does not support
-    // the Command Class that the Node A will be controlling
-    //
-    // To determine this, the node must support the AGI CC or we have no way of knowing which
-    // CCs the node will control
-    if (!endpoint.supportsCC(safe_1.CommandClasses["Association Group Information"])) {
-        return _Types_1.AssociationCheckResult.OK;
-    }
-    const groupCommandList = AssociationGroupInfoCC_1.AssociationGroupInfoCC.getIssuedCommandsCached(ctx, endpoint, group);
-    if (!groupCommandList || !groupCommandList.size) {
-        // We don't know which CCs this group controls, just allow it
-        return _Types_1.AssociationCheckResult.OK;
-    }
-    const groupCCs = [...groupCommandList.keys()];
-    // A controlling node MAY create an association to a destination supporting an
-    // actuator Command Class if the actual association group sends Basic Control Command Class.
-    if (groupCCs.includes(safe_1.CommandClasses.Basic)
-        && safe_1.actuatorCCs.some((cc) => targetEndpoint?.supportsCC(cc))) {
-        return _Types_1.AssociationCheckResult.OK;
-    }
-    // Enforce that at least one issued CC is supported
-    if (groupCCs.some((cc) => targetEndpoint?.supportsCC(cc))) {
-        return _Types_1.AssociationCheckResult.OK;
-    }
-    else {
-        return _Types_1.AssociationCheckResult.Forbidden_NoSupportedCCs;
-    }
-}
-function getAssociationGroups(ctx, endpoint) {
-    // Check whether we have multi channel support or not
-    let assocInstance;
-    let mcInstance;
-    if (endpoint.supportsCC(safe_1.CommandClasses.Association)) {
-        assocInstance = AssociationCC_1.AssociationCC;
-    }
-    else {
-        throw new safe_1.ZWaveError(`Node ${endpoint.nodeId}${endpoint.index > 0 ? `, endpoint ${endpoint.index}` : ""} does not support associations!`, safe_1.ZWaveErrorCodes.CC_NotSupported);
-    }
-    if (endpoint.supportsCC(safe_1.CommandClasses["Multi Channel Association"])) {
-        mcInstance = MultiChannelAssociationCC_1.MultiChannelAssociationCC;
-    }
-    const assocGroupCount = assocInstance.getGroupCountCached(ctx, endpoint)
-        ?? 0;
-    const mcGroupCount = mcInstance?.getGroupCountCached(ctx, endpoint)
-        ?? 0;
-    const groupCount = Math.max(assocGroupCount, mcGroupCount);
-    const deviceConfig = ctx.getDeviceConfig?.(endpoint.nodeId);
-    const ret = new Map();
-    if (endpoint.supportsCC(safe_1.CommandClasses["Association Group Information"])) {
-        // We can read all information we need from the AGI CC
-        const agiInstance = AssociationGroupInfoCC_1.AssociationGroupInfoCC;
-        for (let group = 1; group <= groupCount; group++) {
-            const assocConfig = deviceConfig?.getAssociationConfigForEndpoint(endpoint.index, group);
-            const multiChannel = !!mcInstance && group <= mcGroupCount;
-            ret.set(group, {
-                maxNodes: (multiChannel
-                    ? mcInstance
-                    : assocInstance).getMaxNodesCached(ctx, endpoint, group) || 1,
-                // AGI implies Z-Wave+ where group 1 is the lifeline
-                isLifeline: group === 1,
-                label: 
-                // prefer the configured label if we have one
-                assocConfig?.label
-                    // the ones reported by AGI are sometimes pretty bad
-                    ?? agiInstance.getGroupNameCached(ctx, endpoint, group)
-                    // but still better than "unnamed"
-                    ?? `Unnamed group ${group}`,
-                multiChannel,
-                profile: agiInstance.getGroupProfileCached(ctx, endpoint, group),
-                issuedCommands: agiInstance.getIssuedCommandsCached(ctx, endpoint, group),
-            });
-        }
-    }
-    else {
-        // we need to consult the device config
-        for (let group = 1; group <= groupCount; group++) {
-            const assocConfig = deviceConfig?.getAssociationConfigForEndpoint(endpoint.index, group);
-            const multiChannel = !!mcInstance && group <= mcGroupCount;
-            ret.set(group, {
-                maxNodes: (multiChannel
-                    ? mcInstance
-                    : assocInstance).getMaxNodesCached(ctx, endpoint, group)
-                    || assocConfig?.maxNodes
-                    || 1,
-                isLifeline: assocConfig?.isLifeline ?? group === 1,
-                label: assocConfig?.label ?? `Unnamed group ${group}`,
-                multiChannel,
-            });
-        }
-    }
-    return ret;
-}
-function getAllAssociationGroups(ctx, node) {
-    const ret = new Map();
-    for (const endpoint of node.getAllEndpoints()) {
-        if (endpoint.supportsCC(safe_1.CommandClasses.Association)) {
-            ret.set(endpoint.index, getAssociationGroups(ctx, endpoint));
-        }
-    }
-    return ret;
-}
-async function addAssociations(ctx, endpoint, group, destinations) {
-    const nodeAndEndpointString = `${endpoint.nodeId}${endpoint.index > 0 ? `, endpoint ${endpoint.index}` : ""}`;
-    // Check whether we should add any associations the device does not have support for
-    let assocInstance;
-    let mcInstance;
-    // Split associations into conventional and endpoint associations
-    const nodeAssociations = (0, arrays_1.distinct)(destinations
-        .filter((a) => a.endpoint == undefined)
-        .map((a) => a.nodeId));
-    const endpointAssociations = destinations.filter((a) => a.endpoint != undefined);
-    if (endpoint.supportsCC(safe_1.CommandClasses.Association)) {
-        assocInstance = AssociationCC_1.AssociationCC;
-    }
-    else if (nodeAssociations.length > 0) {
-        throw new safe_1.ZWaveError(`Node ${nodeAndEndpointString} does not support associations!`, safe_1.ZWaveErrorCodes.CC_NotSupported);
-    }
-    if (endpoint.supportsCC(safe_1.CommandClasses["Multi Channel Association"])) {
-        mcInstance = MultiChannelAssociationCC_1.MultiChannelAssociationCC;
-    }
-    else if (endpointAssociations.length > 0) {
-        throw new safe_1.ZWaveError(`Node ${nodeAndEndpointString} does not support multi channel associations!`, safe_1.ZWaveErrorCodes.CC_NotSupported);
-    }
-    // Disallow associating a node with itself. This is technically checked as part of
-    // checkAssociations, but here we provide a better error message.
-    const selfAssociations = destinations.filter((d) => d.nodeId === endpoint.nodeId);
-    if (selfAssociations.length > 0) {
-        throw new safe_1.ZWaveError(`Associating a node with itself is not allowed!`, safe_1.ZWaveErrorCodes.AssociationCC_NotAllowed, selfAssociations.map((a) => ({
-            ...a,
-            checkResult: _Types_1.AssociationCheckResult.Forbidden_SelfAssociation,
-        })));
-    }
-    const assocGroupCount = assocInstance?.getGroupCountCached(ctx, endpoint)
-        ?? 0;
-    const mcGroupCount = mcInstance?.getGroupCountCached(ctx, endpoint)
-        ?? 0;
-    const groupCount = Math.max(assocGroupCount, mcGroupCount);
-    if (group > groupCount) {
-        throw new safe_1.ZWaveError(`Group ${group} does not exist on node ${nodeAndEndpointString}`, safe_1.ZWaveErrorCodes.AssociationCC_InvalidGroup);
-    }
-    const deviceConfig = ctx.getDeviceConfig?.(endpoint.nodeId);
-    const groupIsMultiChannel = !!mcInstance
-        && group <= mcGroupCount
-        && deviceConfig?.associations?.get(group)?.multiChannel !== false;
-    if (groupIsMultiChannel) {
-        // Check that all associations are allowed
-        const disallowedAssociations = destinations.map((a) => ({
-            ...a,
-            checkResult: checkAssociation(ctx, endpoint, group, a),
-        })).filter(({ checkResult }) => checkResult !== _Types_1.AssociationCheckResult.OK);
-        if (disallowedAssociations.length) {
-            let message = `The following associations are not allowed:`;
-            message += disallowedAssociations
-                .map((a) => `\n· Node ${a.nodeId}${a.endpoint ? `, endpoint ${a.endpoint}` : ""}: ${(0, safe_2.getEnumMemberName)(_Types_1.AssociationCheckResult, a.checkResult).replace("Forbidden_", "")}`)
-                .join("");
-            throw new safe_1.ZWaveError(message, safe_1.ZWaveErrorCodes.AssociationCC_NotAllowed, disallowedAssociations);
-        }
-        // And add them
-        const api = API_1.CCAPI.create(safe_1.CommandClasses["Multi Channel Association"], ctx, endpoint);
-        await api.addDestinations({
-            groupId: group,
-            nodeIds: nodeAssociations,
-            endpoints: endpointAssociations,
-        });
-        // Refresh the association list
-        await api.getGroup(group);
-    }
-    else {
-        // Although the node supports multi channel associations, this group only supports "normal" associations
-        if (destinations.some((a) => a.endpoint != undefined)) {
-            throw new safe_1.ZWaveError(`Node ${nodeAndEndpointString}, group ${group} does not support multi channel associations!`, safe_1.ZWaveErrorCodes.CC_NotSupported);
-        }
-        // Check that all associations are allowed
-        const disallowedAssociations = destinations.map((a) => ({
-            ...a,
-            checkResult: checkAssociation(ctx, endpoint, group, a),
-        })).filter(({ checkResult }) => checkResult !== _Types_1.AssociationCheckResult.OK);
-        if (disallowedAssociations.length) {
-            let message = `The associations to the following nodes are not allowed`;
-            message += disallowedAssociations
-                .map((a) => `\n· Node ${a.nodeId}: ${(0, safe_2.getEnumMemberName)(_Types_1.AssociationCheckResult, a.checkResult).replace("Forbidden_", "")}`)
-                .join("");
-            throw new safe_1.ZWaveError(message, safe_1.ZWaveErrorCodes.AssociationCC_NotAllowed, disallowedAssociations);
-        }
-        const api = API_1.CCAPI.create(safe_1.CommandClasses.Association, ctx, endpoint);
-        await api.addNodeIds(group, ...destinations.map((a) => a.nodeId));
-        // Refresh the association list
-        await api.getGroup(group);
-    }
-}
-async function removeAssociations(ctx, endpoint, group, destinations) {
-    const nodeAndEndpointString = `${endpoint.nodeId}${endpoint.index > 0 ? `, endpoint ${endpoint.index}` : ""}`;
-    // Split associations into conventional and endpoint associations
-    const nodeAssociations = (0, arrays_1.distinct)(destinations
-        .filter((a) => a.endpoint == undefined)
-        .map((a) => a.nodeId));
-    const endpointAssociations = destinations.filter((a) => a.endpoint != undefined);
-    // Removing associations is not either/or - we could have a device with duplicated associations between
-    // Association CC and Multi Channel Association CC
-    // Figure out what we need to use to remove the associations
-    let groupExistsAsMultiChannel = false;
-    let groupExistsAsNodeAssociation = false;
-    let mcInstance;
-    let assocInstance;
-    // To remove a multi channel association, we need to make sure that the group exists
-    // and the node supports multi channel associations
-    if (endpoint.supportsCC(safe_1.CommandClasses["Multi Channel Association"])) {
-        mcInstance = MultiChannelAssociationCC_1.MultiChannelAssociationCC;
-        if (group <= mcInstance.getGroupCountCached(ctx, endpoint)) {
-            groupExistsAsMultiChannel = true;
-        }
-    }
-    else if (endpointAssociations.length > 0) {
-        throw new safe_1.ZWaveError(`Node ${nodeAndEndpointString} does not support multi channel associations!`, safe_1.ZWaveErrorCodes.CC_NotSupported);
-    }
-    // To remove a normal association, we need to make sure that the group exists either as a normal association
-    // or as a multi channel association
-    if (endpoint.supportsCC(safe_1.CommandClasses.Association)) {
-        assocInstance = AssociationCC_1.AssociationCC;
-        if (group <= assocInstance.getGroupCountCached(ctx, endpoint)) {
-            groupExistsAsNodeAssociation = true;
-        }
-    }
-    if (!mcInstance && !assocInstance) {
-        throw new safe_1.ZWaveError(`Node ${nodeAndEndpointString} does not support associations!`, safe_1.ZWaveErrorCodes.CC_NotSupported);
-    }
-    // Ensure the group exists and can be used
-    if (!groupExistsAsMultiChannel && !groupExistsAsNodeAssociation) {
-        throw new safe_1.ZWaveError(` Association group ${group} does not exist for node ${nodeAndEndpointString}`, safe_1.ZWaveErrorCodes.AssociationCC_InvalidGroup);
-    }
-    if (endpointAssociations.length > 0 && !groupExistsAsMultiChannel) {
-        throw new safe_1.ZWaveError(`Node ${nodeAndEndpointString}, association group ${group} does not support multi channel associations!`, safe_1.ZWaveErrorCodes.AssociationCC_InvalidGroup);
-    }
-    // Even if we only remove node associations, we use both CCs since it has been found that some
-    // devices do not correctly share the node list between the two commands
-    if (assocInstance
-        && nodeAssociations.length > 0
-        && groupExistsAsNodeAssociation) {
-        const api = API_1.CCAPI.create(safe_1.CommandClasses.Association, ctx, endpoint);
-        await api.removeNodeIds({
-            groupId: group,
-            nodeIds: nodeAssociations,
-        });
-        // Refresh the association list
-        await api.getGroup(group);
-    }
-    if (mcInstance && groupExistsAsMultiChannel) {
-        const api = API_1.CCAPI.create(safe_1.CommandClasses["Multi Channel Association"], ctx, endpoint);
-        await api.removeDestinations({
-            groupId: group,
-            nodeIds: nodeAssociations,
-            endpoints: endpointAssociations,
-        });
-        // Refresh the multi channel association list
-        await api.getGroup(group);
-    }
-}
-function getLifelineGroupIds(ctx, endpoint) {
-    // For now only support this for the root endpoint - i.e. node
-    if (endpoint.index > 0)
-        return [];
-    // Some nodes define multiple lifeline groups, so we need to assign us to
-    // all of them
-    const lifelineGroups = [];
-    // If the target node supports Z-Wave+ info that means the lifeline MUST be group #1
-    if (endpoint.supportsCC(safe_1.CommandClasses["Z-Wave Plus Info"])) {
-        lifelineGroups.push(1);
-    }
-    // We have a device config file that tells us which (additional) association to assign
-    let associations;
-    const deviceConfig = ctx.getDeviceConfig?.(endpoint.nodeId);
-    if (endpoint.index === 0) {
-        // The root endpoint's associations may be configured separately or as part of "endpoints"
-        associations = deviceConfig?.associations
-            ?? deviceConfig?.endpoints?.get(0)?.associations;
-    }
-    else {
-        // The other endpoints can only have a configuration as part of "endpoints"
-        associations = deviceConfig?.endpoints?.get(endpoint.index)?.associations;
-    }
-    if (associations?.size) {
-        lifelineGroups.push(...[...associations.values()]
-            .filter((a) => a.isLifeline)
-            .map((a) => a.groupId));
-    }
-    return (0, arrays_1.distinct)(lifelineGroups).sort();
-}
-async function configureLifelineAssociations(ctx, endpoint) {
-    // Assign the controller to all lifeline groups
-    const ownNodeId = ctx.ownNodeId;
-    const node = ctx.getNodeOrThrow(endpoint.nodeId);
-    const valueDB = ctx.getValueDB(node.id);
-    const deviceConfig = ctx.getDeviceConfig?.(node.id);
-    // We check if a node supports Multi Channel CC before creating Multi Channel Lifeline Associations (#1109)
-    const nodeSupportsMultiChannel = node.supportsCC(safe_1.CommandClasses["Multi Channel"]);
-    let assocInstance;
-    const assocAPI = API_1.CCAPI.create(safe_1.CommandClasses.Association, ctx, endpoint);
-    if (endpoint.supportsCC(safe_1.CommandClasses.Association)) {
-        assocInstance = AssociationCC_1.AssociationCC;
-    }
-    let mcInstance;
-    let mcGroupCount = 0;
-    const mcAPI = API_1.CCAPI.create(safe_1.CommandClasses["Multi Channel Association"], ctx, endpoint);
-    if (endpoint.supportsCC(safe_1.CommandClasses["Multi Channel Association"])) {
-        mcInstance = MultiChannelAssociationCC_1.MultiChannelAssociationCC;
-        mcGroupCount = mcInstance.getGroupCountCached(ctx, endpoint) ?? 0;
-    }
-    const lifelineGroups = getLifelineGroupIds(ctx, node);
-    if (lifelineGroups.length === 0) {
-        // We can look for the General Lifeline AGI profile as a last resort
-        if (endpoint.supportsCC(safe_1.CommandClasses["Association Group Information"])) {
-            const agiAPI = API_1.CCAPI.create(safe_1.CommandClasses["Association Group Information"], ctx, endpoint);
-            // The lifeline MUST be group 1
-            const lifeline = await agiAPI
-                .getGroupInfo(1, true)
-                .catch(() => undefined);
-            if (lifeline?.profile
-                === _Types_1.AssociationGroupInfoProfile["General: Lifeline"]) {
-                lifelineGroups.push(1);
-            }
-        }
-    }
-    if (lifelineGroups.length === 0) {
-        ctx.logNode(node.id, {
-            endpoint: endpoint.index,
-            message: "No information about Lifeline associations, cannot assign ourselves!",
-            level: "warn",
-        });
-        // Remember that we have NO lifeline association
-        valueDB.setValue(AssociationCC_1.AssociationCCValues.hasLifeline.endpoint(endpoint.index), false);
-        return;
-    }
-    ctx.logNode(node.id, {
-        endpoint: endpoint.index,
-        message: `Checking/assigning lifeline groups: ${lifelineGroups.join(", ")}
-supports classic associations:       ${!!assocInstance}
-supports multi channel associations: ${!!mcInstance}`,
-    });
-    for (const group of lifelineGroups) {
-        const groupSupportsMultiChannelAssociation = group <= mcGroupCount;
-        const assocConfig = deviceConfig?.getAssociationConfigForEndpoint(endpoint.index, group);
-        const mustUseNodeAssociation = !groupSupportsMultiChannelAssociation
-            || !nodeSupportsMultiChannel
-            || assocConfig?.multiChannel === false;
-        let mustUseMultiChannelAssociation = false;
-        if (groupSupportsMultiChannelAssociation && nodeSupportsMultiChannel) {
-            if (assocConfig?.multiChannel === true) {
-                mustUseMultiChannelAssociation = true;
-            }
-            else if (endpoint.index === 0) {
-                // If the node has multiple endpoints but none of the extra ones support associations,
-                // the root endpoints needs a Multi Channel Association
-                const allEndpoints = node.getAllEndpoints();
-                if (allEndpoints.length > 1
-                    && allEndpoints
-                        .filter((e) => e.index !== endpoint.index)
-                        .every((e) => !e.supportsCC(safe_1.CommandClasses.Association)
-                        && !e.supportsCC(safe_1.CommandClasses["Multi Channel Association"]))) {
-                    mustUseMultiChannelAssociation = true;
-                }
-            }
-        }
-        ctx.logNode(node.id, {
-            endpoint: endpoint.index,
-            message: `Configuring lifeline group #${group}:
-group supports multi channel:  ${groupSupportsMultiChannelAssociation}
-configured strategy:           ${assocConfig?.multiChannel ?? "auto"}
-must use node association:     ${mustUseNodeAssociation}
-must use endpoint association: ${mustUseMultiChannelAssociation}`,
-        });
-        // Figure out which associations exist and may need to be removed
-        const isAssignedAsNodeAssociation = (endpoint) => {
-            if (groupSupportsMultiChannelAssociation && mcInstance) {
-                if (
-                // Only consider a group if it doesn't share its associations with the root endpoint
-                mcInstance.getMaxNodesCached(ctx, endpoint, group)
-                    > 0
-                    && !!mcInstance
-                        .getAllDestinationsCached(ctx, endpoint)
-                        .get(group)
-                        ?.some((addr) => addr.nodeId === ownNodeId
-                        && addr.endpoint == undefined)) {
-                    return true;
-                }
-            }
-            if (assocInstance) {
-                if (
-                // Only consider a group if it doesn't share its associations with the root endpoint
-                assocInstance.getMaxNodesCached(ctx, endpoint, group)
-                    > 0
-                    && !!assocInstance
-                        .getAllDestinationsCached(ctx, endpoint)
-                        .get(group)
-                        ?.some((addr) => addr.nodeId === ownNodeId)) {
-                    return true;
-                }
-            }
-            return false;
-        };
-        const isAssignedAsEndpointAssociation = (endpoint) => {
-            if (mcInstance) {
-                if (
-                // Only consider a group if it doesn't share its associations with the root endpoint
-                mcInstance.getMaxNodesCached(ctx, endpoint, group)
-                    > 0
-                    && mcInstance
-                        .getAllDestinationsCached(ctx, endpoint)
-                        .get(group)
-                        ?.some((addr) => addr.nodeId === ownNodeId
-                        && addr.endpoint === 0)) {
-                    return true;
-                }
-            }
-            return false;
-        };
-        // If the node was used with other controller software, there might be
-        // invalid lifeline associations which cause reporting problems
-        const invalidEndpointAssociations = mcInstance
-            ?.getAllDestinationsCached(ctx, endpoint)
-            .get(group)
-            ?.filter((addr) => addr.nodeId === ownNodeId
-            && addr.endpoint != undefined
-            && addr.endpoint !== 0) ?? [];
-        // Clean them up first
-        if (invalidEndpointAssociations.length > 0
-            && mcAPI.isSupported()
-            && groupSupportsMultiChannelAssociation) {
-            ctx.logNode(node.id, {
-                endpoint: endpoint.index,
-                message: `Found invalid lifeline associations in group #${group}, removing them...`,
-                direction: "outbound",
-            });
-            await mcAPI.removeDestinations({
-                groupId: group,
-                endpoints: invalidEndpointAssociations,
-            });
-            // refresh the associations - don't trust that it worked
-            await mcAPI.getGroup(group);
-        }
-        // Assigning the correct lifelines depends on the association kind, source endpoint and the desired strategy:
-        //
-        // When `mustUseMultiChannelAssociation` is `true` - Use a multi channel association (if possible), no fallback
-        // When `mustUseNodeAssociation` is `true` - Use a node association (if possible), no fallback
-        // Otherwise:
-        //   1. Try a node association on the current endpoint/root
-        //   2. If Association CC is not supported, try assigning a node association with the Multi Channel Association CC
-        //   3. If that did not work, fall back to a multi channel association (target endpoint 0)
-        //   4. If that did not work either, the endpoint index is >0 and the node is Z-Wave+:
-        //      Fall back to a multi channel association (target endpoint 0) on the root, if it doesn't have one yet.
-        let hasLifeline = false;
-        // First try: node association
-        if (!mustUseMultiChannelAssociation) {
-            if (isAssignedAsNodeAssociation(endpoint)) {
-                // We already have the correct association
-                hasLifeline = true;
-                ctx.logNode(node.id, {
-                    endpoint: endpoint.index,
-                    message: `Lifeline group #${group} is already assigned with a node association`,
-                    direction: "none",
-                });
-            }
-            else if (assocAPI.isSupported()
-                // Some endpoint groups don't support having any destinations because they are shared with the root
-                && assocInstance.getMaxNodesCached(ctx, endpoint, group)
-                    > 0) {
-                // We can use a node association, but first remove any possible endpoint associations
-                ctx.logNode(node.id, {
-                    endpoint: endpoint.index,
-                    message: `Assigning lifeline group #${group} with a node association via Association CC...`,
-                    direction: "outbound",
-                });
-                if (isAssignedAsEndpointAssociation(endpoint)
-                    && mcAPI.isSupported()) {
-                    await mcAPI.removeDestinations({
-                        groupId: group,
-                        endpoints: [{ nodeId: ownNodeId, endpoint: 0 }],
-                    });
-                    // refresh the associations - don't trust that it worked
-                    await mcAPI.getGroup(group);
-                }
-                await assocAPI.addNodeIds(group, ownNodeId);
-                // refresh the associations - don't trust that it worked
-                const groupReport = await assocAPI.getGroup(group);
-                hasLifeline = !!groupReport?.nodeIds.includes(ownNodeId);
-                if (hasLifeline) {
-                    ctx.logNode(node.id, {
-                        endpoint: endpoint.index,
-                        message: `Lifeline group #${group} was assigned with a node association via Association CC`,
-                        direction: "none",
-                    });
-                }
-                else {
-                    ctx.logNode(node.id, {
-                        endpoint: endpoint.index,
-                        message: `Assigning lifeline group #${group} with a node association via Association CC did not work`,
-                        direction: "none",
-                    });
-                }
-            }
-            // Second try: Node association using the Multi Channel Association CC
-            if (!hasLifeline
-                && mcAPI.isSupported()
-                && mcInstance.getMaxNodesCached(ctx, endpoint, group) > 0) {
-                // We can use a node association, but first remove any possible endpoint associations
-                ctx.logNode(node.id, {
-                    endpoint: endpoint.index,
-                    message: `Assigning lifeline group #${group} with a node association via Multi Channel Association CC...`,
-                    direction: "outbound",
-                });
-                if (isAssignedAsEndpointAssociation(endpoint)) {
-                    await mcAPI.removeDestinations({
-                        groupId: group,
-                        endpoints: [{ nodeId: ownNodeId, endpoint: 0 }],
-                    });
-                }
-                await mcAPI.addDestinations({
-                    groupId: group,
-                    nodeIds: [ownNodeId],
-                });
-                // refresh the associations - don't trust that it worked
-                const groupReport = await mcAPI.getGroup(group);
-                hasLifeline = !!groupReport?.nodeIds.includes(ownNodeId);
-                if (hasLifeline) {
-                    ctx.logNode(node.id, {
-                        endpoint: endpoint.index,
-                        message: `Lifeline group #${group} was assigned with a node association via Multi Channel Association CC`,
-                        direction: "none",
-                    });
-                }
-                else {
-                    ctx.logNode(node.id, {
-                        endpoint: endpoint.index,
-                        message: `Assigning lifeline group #${group} with a node association via Multi Channel Association CC did not work`,
-                        direction: "none",
-                    });
-                }
-            }
-        }
-        // Third try: Use an endpoint association (target endpoint 0)
-        // This is only supported starting in Multi Channel Association CC V3
-        if (!hasLifeline && !mustUseNodeAssociation) {
-            if (isAssignedAsEndpointAssociation(endpoint)) {
-                // We already have the correct association
-                hasLifeline = true;
-                ctx.logNode(node.id, {
-                    endpoint: endpoint.index,
-                    message: `Lifeline group #${group} is already assigned with an endpoint association`,
-                    direction: "none",
-                });
-            }
-            else if (mcAPI.isSupported()
-                && mcAPI.version >= 3
-                && mcInstance.getMaxNodesCached(ctx, endpoint, group) > 0) {
-                // We can use a multi channel association, but first remove any possible node associations
-                ctx.logNode(node.id, {
-                    endpoint: endpoint.index,
-                    message: `Assigning lifeline group #${group} with a multi channel association...`,
-                    direction: "outbound",
-                });
-                if (isAssignedAsNodeAssociation(endpoint)) {
-                    // It has been found that some devices don't correctly share the node associations between
-                    // Association CC and Multi Channel Association CC, so we remove the nodes from both lists
-                    await mcAPI.removeDestinations({
-                        groupId: group,
-                        nodeIds: [ownNodeId],
-                    });
-                    if (assocAPI.isSupported()) {
-                        await assocAPI.removeNodeIds({
-                            groupId: group,
-                            nodeIds: [ownNodeId],
-                        });
-                        // refresh the associations - don't trust that it worked
-                        await assocAPI.getGroup(group);
-                    }
-                }
-                await mcAPI.addDestinations({
-                    groupId: group,
-                    endpoints: [{ nodeId: ownNodeId, endpoint: 0 }],
-                });
-                // refresh the associations - don't trust that it worked
-                const groupReport = await mcAPI.getGroup(group);
-                hasLifeline = !!groupReport?.endpoints.some((a) => a.nodeId === ownNodeId && a.endpoint === 0);
-                if (hasLifeline) {
-                    ctx.logNode(node.id, {
-                        endpoint: endpoint.index,
-                        message: `Lifeline group #${group} was assigned with a multi channel association`,
-                        direction: "none",
-                    });
-                }
-                else {
-                    ctx.logNode(node.id, {
-                        endpoint: endpoint.index,
-                        message: `Assigning lifeline group #${group} with a multi channel association did not work`,
-                        direction: "none",
-                    });
-                }
-            }
-        }
-        // Last attempt (actual Z-Wave+ Lifelines only): Try a multi channel association on the root.
-        // Endpoint interviews happen AFTER the root interview, so this enables us to overwrite what
-        // we previously configured on the root.
-        if (!hasLifeline
-            && group === 1
-            && node.supportsCC(safe_1.CommandClasses["Z-Wave Plus Info"])
-            && endpoint.index > 0) {
-            // But first check if the root may have a multi channel association
-            const rootAssocConfig = deviceConfig
-                ?.getAssociationConfigForEndpoint(0, group);
-            const rootMustUseNodeAssociation = !nodeSupportsMultiChannel
-                || rootAssocConfig?.multiChannel === false;
-            ctx.logNode(node.id, {
-                endpoint: endpoint.index,
-                message: `Checking root device for fallback assignment of lifeline group #${group}:
-root supports multi channel:  ${nodeSupportsMultiChannel}
-configured strategy:           ${rootAssocConfig?.multiChannel ?? "auto"}
-must use node association:     ${rootMustUseNodeAssociation}`,
-            });
-            if (!rootMustUseNodeAssociation) {
-                if (isAssignedAsEndpointAssociation(node)) {
-                    // We already have the correct association
-                    hasLifeline = true;
-                    ctx.logNode(node.id, {
-                        endpoint: endpoint.index,
-                        message: `Lifeline group #${group} is already assigned with a multi channel association on the root device`,
-                        direction: "none",
-                    });
-                }
-                else {
-                    const rootMCAPI = API_1.CCAPI.create(safe_1.CommandClasses["Multi Channel Association"], ctx, node);
-                    const rootAssocAPI = API_1.CCAPI.create(safe_1.CommandClasses.Association, ctx, node);
-                    if (rootMCAPI.isSupported()) {
-                        ctx.logNode(node.id, {
-                            endpoint: endpoint.index,
-                            message: `Assigning lifeline group #${group} with a multi channel association on the root device...`,
-                            direction: "outbound",
-                        });
-                        // Clean up node associations because they might prevent us from adding the endpoint association
-                        if (isAssignedAsNodeAssociation(node)) {
-                            // It has been found that some devices don't correctly share the node associations between
-                            // Association CC and Multi Channel Association CC, so we remove the nodes from both lists
-                            await rootMCAPI.removeDestinations({
-                                groupId: group,
-                                nodeIds: [ownNodeId],
-                            });
-                            if (rootAssocAPI.isSupported()) {
-                                await rootAssocAPI.removeNodeIds({
-                                    groupId: group,
-                                    nodeIds: [ownNodeId],
-                                });
-                                // refresh the associations - don't trust that it worked
-                                await rootAssocAPI.getGroup(group);
-                            }
-                        }
-                        await rootMCAPI.addDestinations({
-                            groupId: group,
-                            endpoints: [{ nodeId: ownNodeId, endpoint: 0 }],
-                        });
-                        // refresh the associations - don't trust that it worked
-                        const groupReport = await rootMCAPI.getGroup(group);
-                        hasLifeline = !!groupReport?.endpoints.some((a) => a.nodeId === ownNodeId && a.endpoint === 0);
-                    }
-                }
-            }
-        }
-        if (!hasLifeline) {
-            ctx.logNode(node.id, {
-                endpoint: endpoint.index,
-                message: `All attempts to assign lifeline group #${group} failed, skipping...`,
-                direction: "none",
-                level: "warn",
-            });
-        }
-    }
-    // Remember that we did the association assignment
-    valueDB.setValue(AssociationCC_1.AssociationCCValues.hasLifeline.endpoint(endpoint.index), true);
-}
-async function assignLifelineIssueingCommand(ctx, endpoint, ccId, ccCommand) {
-    const node = ctx.getNodeOrThrow(endpoint.nodeId);
-    if (node.supportsCC(safe_1.CommandClasses["Association Group Information"])
-        && (node.supportsCC(safe_1.CommandClasses.Association)
-            || node.supportsCC(safe_1.CommandClasses["Multi Channel Association"]))) {
-        const groupsIssueingNotifications = AssociationGroupInfoCC_1.AssociationGroupInfoCC
-            .findGroupsForIssuedCommand(ctx, node, ccId, ccCommand);
-        if (groupsIssueingNotifications.length > 0) {
-            // We always grab the first group - usually it should be the lifeline
-            const groupId = groupsIssueingNotifications[0];
-            const existingAssociations = getAssociations(ctx, node).get(groupId)
-                ?? [];
-            if (!existingAssociations.some((a) => a.nodeId === ctx.ownNodeId)) {
-                ctx.logNode(node.id, {
-                    endpoint: endpoint.index,
-                    message: `Configuring associations to receive ${(0, safe_1.getCCName)(ccId)} commands...`,
-                    direction: "outbound",
-                });
-                await addAssociations(ctx, node, groupId, [
-                    { nodeId: ctx.ownNodeId },
-                ]);
-            }
-        }
-    }
-}
-function doesAnyLifelineSendActuatorOrSensorReports(ctx, node) {
-    // No association support means no unsolicited reports
-    if (!node.supportsCC(safe_1.CommandClasses.Association)
-        && !node.supportsCC(safe_1.CommandClasses["Multi Channel Association"])) {
-        return false;
-    }
-    // No AGI support means we cannot know
-    if (!node.supportsCC(safe_1.CommandClasses["Association Group Information"])) {
-        return safe_1.NOT_KNOWN;
-    }
-    // Lifeline group IDs include the ones we added via a config file, so they may not be considered true lifelines
-    const lifelineGroupIds = getLifelineGroupIds(ctx, node);
-    // If any potential lifeline group has the "General: Lifeline" profile, the node MUST send unsolicited reports that way
-    if (lifelineGroupIds.some((id) => AssociationGroupInfoCC_1.AssociationGroupInfoCC.getGroupProfileCached(ctx, node, id) === _Types_1.AssociationGroupInfoProfile["General: Lifeline"])) {
-        return true;
-    }
-    // Otherwise check if any of the groups sends any actuator or sensor commands. We'll assume that those are reports
-    for (const groupId of lifelineGroupIds) {
-        const issuedCommands = AssociationGroupInfoCC_1.AssociationGroupInfoCC.getIssuedCommandsCached(ctx, node, groupId);
-        if (!issuedCommands)
-            continue;
-        const commands = [...issuedCommands.keys()];
-        if (commands.some((c) => (0, safe_1.isActuatorCC)(c) || (0, safe_1.isSensorCC)(c))) {
-            return true;
-        }
-    }
-    return false;
-}
-//# sourceMappingURL=utils.js.map