@zwave-js/cc 15.27.1 → 15.29.0

package/build/cjs/lib/API.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src_gen/lib/API.ts"],
-  "sourcesContent": ["import type { CompatOverrideQueries, GetDeviceConfig } from \"@zwave-js/config\";\nimport {\n\tCommandClasses,\n\ttype ControlsCC,\n\ttype Duration,\n\ttype EndpointId,\n\ttype GetEndpoint,\n\ttype GetNode,\n\ttype GetSafeCCVersion,\n\ttype GetSupportedCCVersion,\n\ttype GetValueDB,\n\ttype HostIDs,\n\ttype ListenBehavior,\n\ttype LogNode,\n\ttype MaybeNotKnown,\n\tNODE_ID_BROADCAST,\n\tNODE_ID_BROADCAST_LR,\n\tNOT_KNOWN,\n\ttype NodeId,\n\ttype PhysicalNodes,\n\ttype QueryNodeInterviewStage,\n\ttype QueryNodeStatus,\n\ttype SecurityManagers,\n\ttype SendCommandOptions,\n\ttype SupervisionResult,\n\ttype SupportsCC,\n\ttype TXReport,\n\ttype ValueChangeOptions,\n\ttype ValueDB,\n\ttype ValueID,\n\ttype VirtualEndpointId,\n\tZWaveError,\n\tZWaveErrorCodes,\n\tgetCCName,\n\tstripUndefined,\n} from \"@zwave-js/core\";\nimport {\n\ttype AllOrNone,\n\ttype OnlyMethods,\n\tgetEnumMemberName,\n\tgetErrorMessage,\n\tnum2hex,\n} from \"@zwave-js/shared\";\nimport { isArray } from \"alcalzone-shared/typeguards\";\nimport {\n\tgetAPI,\n\tgetCCValues,\n\tgetCommandClass,\n\tgetImplementedVersion,\n} from \"./CommandClassDecorators.js\";\nimport type { CCValue, StaticCCValue } from \"./Values.js\";\nimport type { SendCommand } from \"./traits.js\";\nimport type {\n\tGetRefreshValueTimeouts,\n\tGetUserPreferences,\n\tSchedulePoll,\n} from \"./traits.js\";\n\n// Import and re-export generated types\nimport type { CCAPIs, CCNameMap } from \"./_CCAPI.generated.js\";\nexport type { CCAPIs, CCNameMap };\n\nexport type ValueIDProperties = Pick<ValueID, \"property\" | \"propertyKey\">;\n\n/** Used to identify the method on the CC API class that handles setting values on nodes directly */\nexport const SET_VALUE: unique symbol = Symbol.for(\"CCAPI_SET_VALUE\");\n\nexport type SetValueImplementation = (\n\tproperty: ValueIDProperties,\n\tvalue: unknown,\n\toptions?: SetValueAPIOptions,\n) => Promise<SupervisionResult | undefined>;\n\nexport const SET_VALUE_HOOKS: unique symbol = Symbol.for(\n\t\"CCAPI_SET_VALUE_HOOKS\",\n);\n\nexport type SetValueImplementationHooks =\n\t& AllOrNone<{\n\t\t// Opt-in to and handle delayed supervision updates\n\t\tsupervisionDelayedUpdates: boolean;\n\t\tsupervisionOnSuccess: () => void | Promise<void>;\n\t\tsupervisionOnFailure: () => void | Promise<void>;\n\t}>\n\t& {\n\t\t// Whether the value is a target value for a CC using split\n\t\t// target/current values. If so, the value will be updated optimistically,\n\t\t// even if the device class does not support optimistic updates.\n\t\tisSplitStateTargetValue?: boolean;\n\t\t// Optimistically update related cached values (if allowed)\n\t\toptimisticallyUpdateRelatedValues?: (\n\t\t\tsupervisedAndSuccessful: boolean,\n\t\t) => void;\n\t\t// Check if a verification of the set value is required, even if the API response suggests otherwise\n\t\tforceVerifyChanges?: () => boolean;\n\t\t// Verify the changes\n\t\tverifyChanges?: (result?: SupervisionResult) => void | Promise<void>;\n\t};\n\nexport type SetValueImplementationHooksFactory = (\n\tproperty: ValueIDProperties,\n\tvalue: unknown,\n\toptions?: SetValueAPIOptions,\n) => SetValueImplementationHooks | undefined;\n\n/**\n * A generic options bag for the `setValue` API.\n * Each implementation will choose the options that are relevant for it, so you can use the same options everywhere.\n * @publicAPI\n */\nexport type SetValueAPIOptions =\n\t& Partial<ValueChangeOptions>\n\t& Pick<SendCommandOptions, \"onProgress\">;\n\n/** Used to identify the method on the CC API class that handles polling values from nodes */\nexport const POLL_VALUE: unique symbol = Symbol.for(\"CCAPI_POLL_VALUE\");\nexport type PollValueImplementation<T = unknown> = (\n\tproperty: ValueIDProperties,\n) => Promise<T | undefined>;\n\n// Since the setValue API is called from a point with very generic parameters,\n// we must do narrowing inside the API calls. These three methods are for convenience\nexport function throwUnsupportedProperty(\n\tcc: CommandClasses,\n\tproperty: string | number,\n): never {\n\tthrow new ZWaveError(\n\t\t`${CommandClasses[cc]}: \"${property}\" is not a supported property`,\n\t\tZWaveErrorCodes.Argument_Invalid,\n\t);\n}\n\nexport function throwUnsupportedPropertyKey(\n\tcc: CommandClasses,\n\tproperty: string | number,\n\tpropertyKey: string | number,\n): never {\n\tthrow new ZWaveError(\n\t\t`${\n\t\t\tCommandClasses[cc]\n\t\t}: \"${propertyKey}\" is not a supported property key for property \"${property}\"`,\n\t\tZWaveErrorCodes.Argument_Invalid,\n\t);\n}\n\nexport function throwMissingPropertyKey(\n\tcc: CommandClasses,\n\tproperty: string | number,\n): never {\n\tthrow new ZWaveError(\n\t\t`${\n\t\t\tCommandClasses[cc]\n\t\t}: property \"${property}\" requires a property key, but none was given`,\n\t\tZWaveErrorCodes.Argument_Invalid,\n\t);\n}\n\nexport function throwWrongValueType(\n\tcc: CommandClasses,\n\tproperty: string | number,\n\texpectedType: string,\n\treceivedType: string,\n): never {\n\tthrow new ZWaveError(\n\t\t`${\n\t\t\tCommandClasses[cc]\n\t\t}: \"${property}\" must be of type \"${expectedType}\", received \"${receivedType}\"`,\n\t\tZWaveErrorCodes.Argument_Invalid,\n\t);\n}\n\nexport interface CCAPISchedulePollOptions {\n\tduration?: Duration;\n\ttransition?: \"fast\" | \"slow\";\n}\n\n// Defines the necessary traits the host passed to a CC API must have\nexport type CCAPIHost<TNode extends CCAPINode = CCAPINode> =\n\t& HostIDs\n\t& GetNode<TNode>\n\t& GetValueDB\n\t& GetSupportedCCVersion\n\t& GetSafeCCVersion\n\t& SecurityManagers\n\t& GetDeviceConfig\n\t& SendCommand\n\t& GetRefreshValueTimeouts\n\t& GetUserPreferences\n\t& SchedulePoll\n\t& LogNode;\n\n// Defines the necessary traits a node passed to a CC API must have\nexport type CCAPINode =\n\t& NodeId\n\t& ListenBehavior\n\t& QueryNodeStatus\n\t& QueryNodeInterviewStage;\n\n// Defines the necessary traits an endpoint passed to a CC API must have\nexport type CCAPIEndpoint =\n\t& (\n\t\t| (\n\t\t\t// Physical endpoints must let us query their controlled CCs\n\t\t\tEndpointId & ControlsCC\n\t\t)\n\t\t| (\n\t\t\t// Virtual endpoints must let us query their physical nodes,\n\t\t\t// the CCs those nodes implement, and access the endpoints of those\n\t\t\t// physical nodes\n\t\t\tVirtualEndpointId & {\n\t\t\t\tnode: PhysicalNodes<\n\t\t\t\t\t& NodeId\n\t\t\t\t\t& SupportsCC\n\t\t\t\t\t& ControlsCC\n\t\t\t\t\t& GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n\t\t\t\t>;\n\t\t\t}\n\t\t)\n\t)\n\t& SupportsCC;\n\nexport type PhysicalCCAPIEndpoint = CCAPIEndpoint & EndpointId;\nexport type VirtualCCAPIEndpoint = CCAPIEndpoint & VirtualEndpointId;\n\n/**\n * The base class for all CC APIs exposed via `Node.commandClasses.<CCName>`\n * @publicAPI\n */\nexport class CCAPI {\n\tpublic constructor(\n\t\tprotected readonly host: CCAPIHost,\n\t\tprotected readonly endpoint: CCAPIEndpoint,\n\t) {\n\t\tthis.ccId = getCommandClass(this);\n\t}\n\n\tpublic static create<T extends CommandClasses>(\n\t\tccId: T,\n\t\thost: CCAPIHost,\n\t\tendpoint: CCAPIEndpoint,\n\t\trequireSupport?: boolean,\n\t): CommandClasses extends T ? CCAPI : CCToAPI<T> {\n\t\tconst APIConstructor = getAPI(ccId);\n\t\tconst ccName = CommandClasses[ccId];\n\t\tif (APIConstructor == undefined) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t`Command Class ${ccName} (${\n\t\t\t\t\tnum2hex(\n\t\t\t\t\t\tccId,\n\t\t\t\t\t)\n\t\t\t\t}) has no associated API!`,\n\t\t\t\tZWaveErrorCodes.CC_NoAPI,\n\t\t\t);\n\t\t}\n\t\tconst apiInstance = new APIConstructor(host, endpoint);\n\n\t\t// Only require support for physical endpoints by default\n\t\trequireSupport ??= !endpoint.virtual;\n\n\t\tif (requireSupport) {\n\t\t\t// @ts-expect-error TS doesn't like assigning to conditional types\n\t\t\treturn new Proxy(apiInstance, {\n\t\t\t\tget: (target, property) => {\n\t\t\t\t\t// Forbid access to the API if it is not supported by the node\n\t\t\t\t\tif (\n\t\t\t\t\t\tproperty !== \"ccId\"\n\t\t\t\t\t\t&& property !== \"endpoint\"\n\t\t\t\t\t\t&& property !== \"isSupported\"\n\t\t\t\t\t\t&& property !== \"withOptions\"\n\t\t\t\t\t\t&& property !== \"commandOptions\"\n\t\t\t\t\t\t&& !target.isSupported()\n\t\t\t\t\t) {\n\t\t\t\t\t\tlet messageStart: string;\n\t\t\t\t\t\tif (endpoint.virtual) {\n\t\t\t\t\t\t\tconst hasNodeId =\n\t\t\t\t\t\t\t\ttypeof endpoint.nodeId === \"number\"\n\t\t\t\t\t\t\t\t&& endpoint.nodeId !== NODE_ID_BROADCAST\n\t\t\t\t\t\t\t\t&& endpoint.nodeId !== NODE_ID_BROADCAST_LR;\n\t\t\t\t\t\t\tmessageStart = `${\n\t\t\t\t\t\t\t\thasNodeId ? \"The\" : \"This\"\n\t\t\t\t\t\t\t} virtual node${\n\t\t\t\t\t\t\t\thasNodeId ? ` ${endpoint.nodeId}` : \"\"\n\t\t\t\t\t\t\t}`;\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tmessageStart = `Node ${endpoint.nodeId}`;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tthrow new ZWaveError(\n\t\t\t\t\t\t\t`${messageStart}${\n\t\t\t\t\t\t\t\tendpoint.index === 0\n\t\t\t\t\t\t\t\t\t? \"\"\n\t\t\t\t\t\t\t\t\t: ` (endpoint ${endpoint.index})`\n\t\t\t\t\t\t\t} does not support the Command Class ${ccName}!`,\n\t\t\t\t\t\t\tZWaveErrorCodes.CC_NotSupported,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\n\t\t\t\t\t// If a device config defines overrides for an API call, return a wrapper method that applies them first before calling the actual method\n\t\t\t\t\tconst fallback = target[property as keyof CCAPI];\n\t\t\t\t\tif (\n\t\t\t\t\t\ttypeof property === \"string\"\n\t\t\t\t\t\t&& !endpoint.virtual\n\t\t\t\t\t\t&& typeof fallback === \"function\"\n\t\t\t\t\t) {\n\t\t\t\t\t\tconst overrides = host.getDeviceConfig?.(\n\t\t\t\t\t\t\tendpoint.nodeId,\n\t\t\t\t\t\t)?.compat?.overrideQueries;\n\t\t\t\t\t\tif (overrides?.hasOverride(ccId)) {\n\t\t\t\t\t\t\treturn overrideQueriesWrapper(\n\t\t\t\t\t\t\t\thost,\n\t\t\t\t\t\t\t\tendpoint,\n\t\t\t\t\t\t\t\tccId,\n\t\t\t\t\t\t\t\tproperty,\n\t\t\t\t\t\t\t\toverrides,\n\t\t\t\t\t\t\t\tfallback,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Else just access the property\n\t\t\t\t\treturn fallback;\n\t\t\t\t},\n\t\t\t});\n\t\t} else {\n\t\t\t// @ts-expect-error TS doesn't like assigning to conditional types\n\t\t\treturn apiInstance;\n\t\t}\n\t}\n\n\t/**\n\t * The identifier of the Command Class this API is for\n\t */\n\tpublic readonly ccId: CommandClasses;\n\n\tprotected get [SET_VALUE](): SetValueImplementation | undefined {\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Can be used on supported CC APIs to set a CC value by property name (and optionally the property key).\n\t * **WARNING:** This function is NOT bound to an API instance. It must be called with the correct `this` context!\n\t */\n\tpublic get setValue(): SetValueImplementation | undefined {\n\t\treturn this[SET_VALUE];\n\t}\n\n\tprotected [SET_VALUE_HOOKS]: SetValueImplementationHooksFactory | undefined;\n\t/**\n\t * Can be implemented by CC APIs to influence the behavior of the setValue API in regards to Supervision and verifying values.\n\t */\n\tpublic get setValueHooks(): SetValueImplementationHooksFactory | undefined {\n\t\treturn this[SET_VALUE_HOOKS];\n\t}\n\n\t/** Whether a successful setValue call should imply that the value was successfully updated */\n\t// oxlint-disable-next-line no-unused-vars\n\tpublic isSetValueOptimistic(valueId: ValueID): boolean {\n\t\treturn true;\n\t}\n\n\tprotected get [POLL_VALUE](): PollValueImplementation | undefined {\n\t\treturn undefined;\n\t}\n\t/**\n\t * Can be used on supported CC APIs to poll a CC value by property name (and optionally the property key)\n\t * **WARNING:** This function is NOT bound to an API instance. It must be called with the correct `this` context!\n\t */\n\tpublic get pollValue(): PollValueImplementation | undefined {\n\t\treturn this[POLL_VALUE];\n\t}\n\n\t/**\n\t * Schedules a value to be polled after a given time. Schedules are deduplicated on a per-property basis.\n\t * @returns `true` if the poll was scheduled, `false` otherwise\n\t */\n\tprotected schedulePoll(\n\t\t{ property, propertyKey }: ValueIDProperties,\n\t\texpectedValue: unknown,\n\t\t{ duration, transition = \"slow\" }: CCAPISchedulePollOptions = {},\n\t): boolean {\n\t\t// Figure out the delay. If a non-zero duration was given or this is a \"fast\" transition,\n\t\t// use/add the short delay. Otherwise, default to the long delay.\n\t\tconst durationMs = duration?.toMilliseconds() ?? 0;\n\t\tconst timeouts = this.host.getRefreshValueTimeouts();\n\t\tconst additionalDelay = !!durationMs || transition === \"fast\"\n\t\t\t? timeouts.refreshValueAfterTransition\n\t\t\t: timeouts.refreshValue;\n\t\tconst timeoutMs = durationMs + additionalDelay;\n\n\t\tif (this.isSinglecast()) {\n\t\t\tconst node = this.host.getNode(this.endpoint.nodeId);\n\t\t\tif (!node) return false;\n\n\t\t\treturn this.host.schedulePoll(\n\t\t\t\tnode.id,\n\t\t\t\t{\n\t\t\t\t\tcommandClass: this.ccId,\n\t\t\t\t\tendpoint: this.endpoint.index,\n\t\t\t\t\tproperty,\n\t\t\t\t\tpropertyKey,\n\t\t\t\t},\n\t\t\t\t{ timeoutMs, expectedValue },\n\t\t\t);\n\t\t} else if (this.isMulticast()) {\n\t\t\t// Only poll supporting nodes in multicast\n\t\t\tconst supportingNodes = this.endpoint.node.physicalNodes.filter(\n\t\t\t\t(node) =>\n\t\t\t\t\tnode\n\t\t\t\t\t\t.getEndpoint(this.endpoint.index)\n\t\t\t\t\t\t?.supportsCC(this.ccId),\n\t\t\t);\n\t\t\tlet ret = false;\n\t\t\tfor (const node of supportingNodes) {\n\t\t\t\tret ||= this.host.schedulePoll(\n\t\t\t\t\tnode.id,\n\t\t\t\t\t{\n\t\t\t\t\t\tcommandClass: this.ccId,\n\t\t\t\t\t\tendpoint: this.endpoint.index,\n\t\t\t\t\t\tproperty,\n\t\t\t\t\t\tpropertyKey,\n\t\t\t\t\t},\n\t\t\t\t\t{ timeoutMs, expectedValue },\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn ret;\n\t\t} else {\n\t\t\t// Don't poll the broadcast node\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t/**\n\t * Retrieves the version of the given CommandClass this endpoint implements\n\t */\n\tpublic get version(): number {\n\t\tif (this.isSinglecast()) {\n\t\t\treturn this.host.getSafeCCVersion(\n\t\t\t\tthis.ccId,\n\t\t\t\tthis.endpoint.nodeId,\n\t\t\t\tthis.endpoint.index,\n\t\t\t) ?? 0;\n\t\t} else {\n\t\t\treturn getImplementedVersion(this.ccId);\n\t\t}\n\t}\n\n\t/** Determines if this simplified API instance may be used. */\n\tpublic isSupported(): boolean {\n\t\treturn (\n\t\t\t// NoOperation is always supported\n\t\t\tthis.ccId === CommandClasses[\"No Operation\"]\n\t\t\t// Basic should always be supported. Since we are trying to hide it from library consumers\n\t\t\t// we cannot trust supportsCC to test it\n\t\t\t|| this.ccId === CommandClasses.Basic\n\t\t\t|| this.endpoint.supportsCC(this.ccId)\n\t\t);\n\t}\n\n\t/**\n\t * Determine whether the linked node supports a specific command of this command class.\n\t * {@link NOT_KNOWN} (`undefined`) means that the information has not been received yet\n\t */\n\t// oxlint-disable-next-line no-unused-vars\n\tpublic supportsCommand(command: number): MaybeNotKnown<boolean> {\n\t\t// This needs to be overwritten per command class. In the default implementation, we don't know anything!\n\t\treturn NOT_KNOWN;\n\t}\n\n\tprotected assertSupportsCommand(\n\t\tcommandEnum: unknown,\n\t\tcommand: number,\n\t): void {\n\t\tif (this.supportsCommand(command) !== true) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t`${\n\t\t\t\t\tthis.isSinglecast()\n\t\t\t\t\t\t? `Node #${this.endpoint.nodeId}`\n\t\t\t\t\t\t: \"This virtual node\"\n\t\t\t\t}${\n\t\t\t\t\tthis.endpoint.index > 0\n\t\t\t\t\t\t? ` (Endpoint ${this.endpoint.index})`\n\t\t\t\t\t\t: \"\"\n\t\t\t\t} does not support the command ${\n\t\t\t\t\tgetEnumMemberName(\n\t\t\t\t\t\tcommandEnum,\n\t\t\t\t\t\tcommand,\n\t\t\t\t\t)\n\t\t\t\t}!`,\n\t\t\t\tZWaveErrorCodes.CC_NotSupported,\n\t\t\t);\n\t\t}\n\t}\n\n\tprotected assertPhysicalEndpoint(\n\t\tendpoint: EndpointId | VirtualEndpointId,\n\t): asserts endpoint is EndpointId {\n\t\tif (endpoint.virtual) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t`This method is not supported for virtual nodes!`,\n\t\t\t\tZWaveErrorCodes.CC_NotSupported,\n\t\t\t);\n\t\t}\n\t}\n\n\t/** Returns the command options to use for sendCommand calls */\n\tprotected get commandOptions(): SendCommandOptions {\n\t\t// No default options\n\t\treturn {};\n\t}\n\n\t/** Creates an instance of this API, scoped to use the given options */\n\tpublic withOptions(options: SendCommandOptions): this {\n\t\tconst mergedOptions = {\n\t\t\t...this.commandOptions,\n\t\t\t...options,\n\t\t};\n\t\treturn new Proxy(this, {\n\t\t\tget: (target, property) => {\n\t\t\t\tif (property === \"commandOptions\") {\n\t\t\t\t\treturn mergedOptions;\n\t\t\t\t} else {\n\t\t\t\t\treturn (target as any)[property];\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t}\n\n\t/** Creates an instance of this API which (if supported) will return TX reports along with the result. */\n\tpublic withTXReport<T extends this>(): WithTXReport<T> {\n\t\tif (this.constructor === CCAPI) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t\"The withTXReport method may only be called on specific CC API implementations.\",\n\t\t\t\tZWaveErrorCodes.Driver_NotSupported,\n\t\t\t);\n\t\t}\n\n\t\t// Remember which properties need to be proxied\n\t\tconst proxiedProps = new Set([\n\t\t\t// These are the CC-specific methods\n\t\t\t...Object.getOwnPropertyNames(this.constructor.prototype),\n\t\t\t// as well as setValue and pollValue\n\t\t\t\"setValue\",\n\t\t\t\"pollValue\",\n\t\t]);\n\t\tproxiedProps.delete(\"constructor\");\n\n\t\tfunction wrapResult(result: unknown, txReport: TXReport): any {\n\t\t\t// Both the result and the TX report may be undefined (no response, no support)\n\t\t\treturn stripUndefined({\n\t\t\t\tresult,\n\t\t\t\ttxReport,\n\t\t\t});\n\t\t}\n\n\t\treturn new Proxy(this, {\n\t\t\tget: (target, prop) => {\n\t\t\t\tif (prop === \"withTXReport\") return undefined;\n\n\t\t\t\tlet original: any = (target as any)[prop];\n\t\t\t\tif (\n\t\t\t\t\tproxiedProps.has(prop as string)\n\t\t\t\t\t&& typeof original === \"function\"\n\t\t\t\t) {\n\t\t\t\t\t// This is a method that only exists in the specific implementation\n\n\t\t\t\t\t// Wrap each call with its own API proxy, so we don't mix up TX reports\n\t\t\t\t\tlet txReport: TXReport;\n\t\t\t\t\tconst api = target.withOptions({\n\t\t\t\t\t\tonTXReport: (report) => {\n\t\t\t\t\t\t\t// Remember the last status report\n\t\t\t\t\t\t\ttxReport = report;\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t\toriginal = (api as any)[prop].bind(api);\n\n\t\t\t\t\t// Return a wrapper function that will add the status report after the call is complete\n\t\t\t\t\treturn (...args: any) => {\n\t\t\t\t\t\tlet result = original(...args);\n\t\t\t\t\t\tif (result instanceof Promise) {\n\t\t\t\t\t\t\tresult = result.then((res) =>\n\t\t\t\t\t\t\t\twrapResult(res, txReport)\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tresult = wrapResult(result, txReport);\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn result;\n\t\t\t\t\t};\n\t\t\t\t} else {\n\t\t\t\t\treturn original;\n\t\t\t\t}\n\t\t\t},\n\t\t}) as any;\n\t}\n\n\tprotected isSinglecast(): this is this & {\n\t\tendpoint: PhysicalCCAPIEndpoint;\n\t} {\n\t\treturn (\n\t\t\t!this.endpoint.virtual\n\t\t\t&& typeof this.endpoint.nodeId === \"number\"\n\t\t\t&& this.endpoint.nodeId !== NODE_ID_BROADCAST\n\t\t\t&& this.endpoint.nodeId !== NODE_ID_BROADCAST_LR\n\t\t);\n\t}\n\n\tprotected isMulticast(): this is this & {\n\t\tendpoint: VirtualCCAPIEndpoint & {\n\t\t\tnodeId: number[];\n\t\t};\n\t} {\n\t\treturn this.endpoint.virtual && isArray(this.endpoint.nodeId);\n\t}\n\n\tprotected isBroadcast(): this is this & {\n\t\tendpoint: VirtualCCAPIEndpoint & {\n\t\t\tnodeId: typeof NODE_ID_BROADCAST | typeof NODE_ID_BROADCAST_LR;\n\t\t};\n\t} {\n\t\treturn (\n\t\t\tthis.endpoint.virtual\n\t\t\t&& (this.endpoint.nodeId === NODE_ID_BROADCAST\n\t\t\t\t|| this.endpoint.nodeId === NODE_ID_BROADCAST_LR)\n\t\t);\n\t}\n\n\t/** Returns the value DB for this CC API's node (if it can be safely accessed) */\n\tprotected tryGetValueDB(): ValueDB | undefined {\n\t\tif (!this.isSinglecast()) return;\n\t\ttry {\n\t\t\treturn this.host.getValueDB(this.endpoint.nodeId);\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t}\n\n\t/** Returns the value DB for this CC's node (or throws if it cannot be accessed) */\n\tprotected getValueDB(): ValueDB {\n\t\tif (this.isSinglecast()) {\n\t\t\ttry {\n\t\t\t\treturn this.host.getValueDB(this.endpoint.nodeId);\n\t\t\t} catch {\n\t\t\t\tthrow new ZWaveError(\n\t\t\t\t\t\"The node for this CC does not exist or the driver is not ready yet\",\n\t\t\t\t\tZWaveErrorCodes.Driver_NotReady,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tthrow new ZWaveError(\n\t\t\t\"Cannot retrieve the value DB for non-singlecast CCs\",\n\t\t\tZWaveErrorCodes.CC_NoNodeID,\n\t\t);\n\t}\n}\n\nfunction overrideQueriesWrapper(\n\tctx: GetValueDB & LogNode,\n\tendpoint: PhysicalCCAPIEndpoint,\n\tccId: CommandClasses,\n\tmethod: string,\n\toverrides: CompatOverrideQueries,\n\tfallback: (...args: any[]) => any,\n): (...args: any[]) => any {\n\t// We must not capture the `this` context here, because the API methods are bound on use\n\treturn function(this: any, ...args: any[]) {\n\t\tconst match = overrides.matchOverride(\n\t\t\tccId,\n\t\t\tendpoint.index,\n\t\t\tmethod,\n\t\t\targs,\n\t\t);\n\t\tif (!match) return fallback.call(this, ...args);\n\n\t\tctx.logNode(endpoint.nodeId, {\n\t\t\tmessage: `API call ${method} for ${\n\t\t\t\tgetCCName(\n\t\t\t\t\tccId,\n\t\t\t\t)\n\t\t\t} CC overridden by a compat flag.`,\n\t\t\tlevel: \"debug\",\n\t\t\tdirection: \"none\",\n\t\t});\n\n\t\tconst ccValues = getCCValues(ccId);\n\t\tif (ccValues) {\n\t\t\tconst valueDB = ctx.getValueDB(endpoint.nodeId);\n\n\t\t\tconst prop2value = (prop: string): CCValue | undefined => {\n\t\t\t\t// We use a simplistic parser to support dynamic value IDs:\n\t\t\t\t// If end with round brackets with something inside, they are considered dynamic\n\t\t\t\t// Otherwise static\n\t\t\t\tconst argsMatch = prop.match(/^(.*)\\((.*)\\)$/);\n\t\t\t\tif (argsMatch) {\n\t\t\t\t\tconst methodName = argsMatch[1];\n\t\t\t\t\tconst methodArgs = JSON.parse(`[${argsMatch[2]}]`);\n\n\t\t\t\t\tconst dynValue = ccValues[methodName];\n\t\t\t\t\tif (typeof dynValue === \"function\") {\n\t\t\t\t\t\treturn dynValue(...methodArgs);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tconst staticValue = ccValues[prop] as\n\t\t\t\t\t\t| StaticCCValue\n\t\t\t\t\t\t| undefined;\n\t\t\t\t\tif (typeof staticValue?.endpoint === \"function\") {\n\t\t\t\t\t\treturn staticValue;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t};\n\n\t\t\t// Persist values if necessary\n\t\t\tif (match.persistValues) {\n\t\t\t\tfor (\n\t\t\t\t\tconst [prop, value] of Object.entries(\n\t\t\t\t\t\tmatch.persistValues,\n\t\t\t\t\t)\n\t\t\t\t) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst ccValue = prop2value(prop);\n\t\t\t\t\t\tif (ccValue) {\n\t\t\t\t\t\t\tvalueDB.setValue(\n\t\t\t\t\t\t\t\tccValue.endpoint(endpoint.index),\n\t\t\t\t\t\t\t\tvalue,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tctx.logNode(endpoint.nodeId, {\n\t\t\t\t\t\t\t\tmessage:\n\t\t\t\t\t\t\t\t\t`Failed to persist value ${prop} during overridden API call: value does not exist`,\n\t\t\t\t\t\t\t\tlevel: \"error\",\n\t\t\t\t\t\t\t\tdirection: \"none\",\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch (e) {\n\t\t\t\t\t\tctx.logNode(endpoint.nodeId, {\n\t\t\t\t\t\t\tmessage:\n\t\t\t\t\t\t\t\t`Failed to persist value ${prop} during overridden API call: ${\n\t\t\t\t\t\t\t\t\tgetErrorMessage(\n\t\t\t\t\t\t\t\t\t\te,\n\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t}`,\n\t\t\t\t\t\t\tlevel: \"error\",\n\t\t\t\t\t\t\tdirection: \"none\",\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// As well as metadata\n\t\t\tif (match.extendMetadata) {\n\t\t\t\tfor (\n\t\t\t\t\tconst [prop, meta] of Object.entries(\n\t\t\t\t\t\tmatch.extendMetadata,\n\t\t\t\t\t)\n\t\t\t\t) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst ccValue = prop2value(prop);\n\t\t\t\t\t\tif (ccValue) {\n\t\t\t\t\t\t\tvalueDB.setMetadata(\n\t\t\t\t\t\t\t\tccValue.endpoint(endpoint.index),\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t...ccValue.meta,\n\t\t\t\t\t\t\t\t\t...meta,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tctx.logNode(endpoint.nodeId, {\n\t\t\t\t\t\t\t\tmessage:\n\t\t\t\t\t\t\t\t\t`Failed to extend value metadata ${prop} during overridden API call: value does not exist`,\n\t\t\t\t\t\t\t\tlevel: \"error\",\n\t\t\t\t\t\t\t\tdirection: \"none\",\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch (e) {\n\t\t\t\t\t\tctx.logNode(endpoint.nodeId, {\n\t\t\t\t\t\t\tmessage:\n\t\t\t\t\t\t\t\t`Failed to extend value metadata ${prop} during overridden API call: ${\n\t\t\t\t\t\t\t\t\tgetErrorMessage(\n\t\t\t\t\t\t\t\t\t\te,\n\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t}`,\n\t\t\t\t\t\t\tlevel: \"error\",\n\t\t\t\t\t\t\tdirection: \"none\",\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// API methods are always async\n\t\treturn Promise.resolve(match.result);\n\t};\n}\n\n/** A CC API that is only available for physical endpoints */\nexport class PhysicalCCAPI extends CCAPI {\n\tpublic constructor(\n\t\thost: CCAPIHost,\n\t\tendpoint: CCAPIEndpoint,\n\t) {\n\t\tsuper(host, endpoint);\n\t\tthis.assertPhysicalEndpoint(endpoint);\n\t}\n\n\tdeclare protected readonly endpoint: PhysicalCCAPIEndpoint;\n}\n\nexport type APIConstructor<T extends CCAPI = CCAPI> = new (\n\thost: CCAPIHost,\n\tendpoint: CCAPIEndpoint,\n) => T;\n\nexport type CCToName<CC extends CommandClasses> = {\n\t[K in keyof CCNameMap]: CCNameMap[K] extends CC ? K : never;\n}[keyof CCNameMap];\n\nexport type CCNameOrId = CommandClasses | Extract<keyof CCAPIs, string>;\n\nexport type CCToAPI<CC extends CCNameOrId> = CC extends CommandClasses\n\t? CCToName<CC> extends keyof CCAPIs ? CCAPIs[CCToName<CC>]\n\t: never\n\t: CC extends keyof CCAPIs ? CCAPIs[CC]\n\t: never;\n\nexport type APIMethodsOf<CC extends CCNameOrId> = Omit<\n\tOnlyMethods<CCToAPI<CC>>,\n\t| \"ccId\"\n\t| \"getNode\"\n\t| \"tryGetNode\"\n\t| \"isSetValueOptimistic\"\n\t| \"isSupported\"\n\t| \"pollValue\"\n\t| \"setValue\"\n\t| \"version\"\n\t| \"supportsCommand\"\n\t| \"withOptions\"\n\t| \"withTXReport\"\n>;\n\nexport type OwnMethodsOf<API extends CCAPI> = Omit<\n\tOnlyMethods<API>,\n\tkeyof OnlyMethods<CCAPI>\n>;\n\n// Wraps the given type in an object that contains a TX report\nexport type WrapWithTXReport<T> = [T] extends [Promise<infer U>]\n\t? Promise<WrapWithTXReport<U>>\n\t: [T] extends [void] ? { txReport: TXReport | undefined }\n\t: { result: T; txReport: TXReport | undefined };\n\nexport type ReturnWithTXReport<T> = T extends (...args: any[]) => any\n\t? (...args: Parameters<T>) => WrapWithTXReport<ReturnType<T>>\n\t: undefined;\n\n// Converts the type of the given API implementation so the API methods return an object including the TX report\nexport type WithTXReport<API extends CCAPI> =\n\t& Omit<\n\t\tAPI,\n\t\tkeyof OwnMethodsOf<API> | \"withOptions\" | \"withTXReport\" | \"setValue\"\n\t>\n\t& {\n\t\t[\n\t\t\tK in\n\t\t\t\t| keyof OwnMethodsOf<API>\n\t\t\t\t| \"setValue\"\n\t\t\t\t| \"pollValue\"\n\t\t]: ReturnWithTXReport<API[K]>;\n\t};\n\nexport function normalizeCCNameOrId(\n\tccNameOrId: number | string,\n): CommandClasses | undefined {\n\tif (!(ccNameOrId in CommandClasses)) return undefined;\n\n\tlet ret: CommandClasses | undefined;\n\tif (typeof ccNameOrId === \"string\") {\n\t\tif (/^\\d+$/.test(ccNameOrId)) {\n\t\t\t// This can happen on property access\n\t\t\tret = +ccNameOrId;\n\t\t} else if (typeof (CommandClasses as any)[ccNameOrId] === \"number\") {\n\t\t\tret = (CommandClasses as any)[ccNameOrId];\n\t\t}\n\t} else {\n\t\tret = ccNameOrId;\n\t}\n\n\treturn ret;\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { CompatOverrideQueries, GetDeviceConfig } from \"@zwave-js/config\";\nimport {\n\tCommandClasses,\n\ttype ControlsCC,\n\ttype Duration,\n\ttype EndpointId,\n\ttype GetEndpoint,\n\ttype GetNode,\n\ttype GetSafeCCVersion,\n\ttype GetSupportedCCVersion,\n\ttype GetValueDB,\n\ttype HostIDs,\n\ttype ListenBehavior,\n\ttype LogNode,\n\ttype MaybeNotKnown,\n\tNODE_ID_BROADCAST,\n\tNODE_ID_BROADCAST_LR,\n\tNOT_KNOWN,\n\ttype NodeId,\n\ttype PhysicalNodes,\n\ttype QueryNodeInterviewStage,\n\ttype QueryNodeStatus,\n\ttype SecurityManagers,\n\ttype SendCommandOptions,\n\ttype SupervisionResult,\n\ttype SupportsCC,\n\ttype TXReport,\n\ttype ValueChangeOptions,\n\ttype ValueDB,\n\ttype ValueID,\n\ttype VirtualEndpointId,\n\tZWaveError,\n\tZWaveErrorCodes,\n\tgetCCName,\n\tstripUndefined,\n} from \"@zwave-js/core\";\nimport {\n\ttype AllOrNone,\n\ttype OnlyMethods,\n\tgetEnumMemberName,\n\tgetErrorMessage,\n\tnum2hex,\n} from \"@zwave-js/shared\";\nimport { isArray } from \"alcalzone-shared/typeguards\";\n\nimport {\n\tgetAPI,\n\tgetCCValues,\n\tgetCommandClass,\n\tgetImplementedVersion,\n} from \"./CommandClassDecorators.js\";\nimport type { CCValue, StaticCCValue } from \"./Values.js\";\n// Import and re-export generated types\nimport type { CCAPIs, CCNameMap } from \"./_CCAPI.generated.js\";\nimport type { SendCommand } from \"./traits.js\";\nimport type {\n\tGetRefreshValueTimeouts,\n\tGetUserPreferences,\n\tSchedulePoll,\n} from \"./traits.js\";\nexport type { CCAPIs, CCNameMap };\n\nexport type ValueIDProperties = Pick<ValueID, \"property\" | \"propertyKey\">;\n\n/** Used to identify the method on the CC API class that handles setting values on nodes directly */\nexport const SET_VALUE: unique symbol = Symbol.for(\"CCAPI_SET_VALUE\");\n\nexport type SetValueImplementation = (\n\tproperty: ValueIDProperties,\n\tvalue: unknown,\n\toptions?: SetValueAPIOptions,\n) => Promise<SupervisionResult | undefined>;\n\nexport const SET_VALUE_HOOKS: unique symbol = Symbol.for(\n\t\"CCAPI_SET_VALUE_HOOKS\",\n);\n\nexport type SetValueImplementationHooks = AllOrNone<{\n\t// Opt-in to and handle delayed supervision updates\n\tsupervisionDelayedUpdates: boolean;\n\tsupervisionOnSuccess: () => void | Promise<void>;\n\tsupervisionOnFailure: () => void | Promise<void>;\n}> & {\n\t// Whether the value is a target value for a CC using split\n\t// target/current values. If so, the value will be updated optimistically,\n\t// even if the device class does not support optimistic updates.\n\tisSplitStateTargetValue?: boolean;\n\t// Optimistically update related cached values (if allowed)\n\toptimisticallyUpdateRelatedValues?: (\n\t\tsupervisedAndSuccessful: boolean,\n\t) => void;\n\t// Check if a verification of the set value is required, even if the API response suggests otherwise\n\tforceVerifyChanges?: () => boolean;\n\t// Verify the changes\n\tverifyChanges?: (result?: SupervisionResult) => void | Promise<void>;\n};\n\nexport type SetValueImplementationHooksFactory = (\n\tproperty: ValueIDProperties,\n\tvalue: unknown,\n\toptions?: SetValueAPIOptions,\n) => SetValueImplementationHooks | undefined;\n\n/**\n * A generic options bag for the `setValue` API.\n * Each implementation will choose the options that are relevant for it, so you can use the same options everywhere.\n * @publicAPI\n */\nexport type SetValueAPIOptions = Partial<ValueChangeOptions>\n\t& Pick<SendCommandOptions, \"onProgress\">;\n\n/** Used to identify the method on the CC API class that handles polling values from nodes */\nexport const POLL_VALUE: unique symbol = Symbol.for(\"CCAPI_POLL_VALUE\");\nexport type PollValueImplementation<T = unknown> = (\n\tproperty: ValueIDProperties,\n) => Promise<T | undefined>;\n\n// Since the setValue API is called from a point with very generic parameters,\n// we must do narrowing inside the API calls. These three methods are for convenience\nexport function throwUnsupportedProperty(\n\tcc: CommandClasses,\n\tproperty: string | number,\n): never {\n\tthrow new ZWaveError(\n\t\t`${CommandClasses[cc]}: \"${property}\" is not a supported property`,\n\t\tZWaveErrorCodes.Argument_Invalid,\n\t);\n}\n\nexport function throwUnsupportedPropertyKey(\n\tcc: CommandClasses,\n\tproperty: string | number,\n\tpropertyKey: string | number,\n): never {\n\tthrow new ZWaveError(\n\t\t`${\n\t\t\tCommandClasses[cc]\n\t\t}: \"${propertyKey}\" is not a supported property key for property \"${property}\"`,\n\t\tZWaveErrorCodes.Argument_Invalid,\n\t);\n}\n\nexport function throwMissingPropertyKey(\n\tcc: CommandClasses,\n\tproperty: string | number,\n): never {\n\tthrow new ZWaveError(\n\t\t`${\n\t\t\tCommandClasses[cc]\n\t\t}: property \"${property}\" requires a property key, but none was given`,\n\t\tZWaveErrorCodes.Argument_Invalid,\n\t);\n}\n\nexport function throwWrongValueType(\n\tcc: CommandClasses,\n\tproperty: string | number,\n\texpectedType: string,\n\treceivedType: string,\n): never {\n\tthrow new ZWaveError(\n\t\t`${\n\t\t\tCommandClasses[cc]\n\t\t}: \"${property}\" must be of type \"${expectedType}\", received \"${receivedType}\"`,\n\t\tZWaveErrorCodes.Argument_Invalid,\n\t);\n}\n\nexport interface CCAPISchedulePollOptions {\n\tduration?: Duration;\n\ttransition?: \"fast\" | \"slow\";\n}\n\n// Defines the necessary traits the host passed to a CC API must have\nexport type CCAPIHost<TNode extends CCAPINode = CCAPINode> = HostIDs\n\t& GetNode<TNode>\n\t& GetValueDB\n\t& GetSupportedCCVersion\n\t& GetSafeCCVersion\n\t& SecurityManagers\n\t& GetDeviceConfig\n\t& SendCommand\n\t& GetRefreshValueTimeouts\n\t& GetUserPreferences\n\t& SchedulePoll\n\t& LogNode;\n\n// Defines the necessary traits a node passed to a CC API must have\nexport type CCAPINode = NodeId\n\t& ListenBehavior\n\t& QueryNodeStatus\n\t& QueryNodeInterviewStage;\n\n// Defines the necessary traits an endpoint passed to a CC API must have\nexport type CCAPIEndpoint = (\n\t| // Physical endpoints must let us query their controlled CCs\n\t  (EndpointId & ControlsCC)\n\t// Virtual endpoints must let us query their physical nodes,\n\t// the CCs those nodes implement, and access the endpoints of those\n\t// physical nodes\n\t| (VirtualEndpointId & {\n\t\t\tnode: PhysicalNodes<\n\t\t\t\tNodeId\n\t\t\t\t\t& SupportsCC\n\t\t\t\t\t& ControlsCC\n\t\t\t\t\t& GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n\t\t\t>;\n\t  })\n)\n\t& SupportsCC;\n\nexport type PhysicalCCAPIEndpoint = CCAPIEndpoint & EndpointId;\nexport type VirtualCCAPIEndpoint = CCAPIEndpoint & VirtualEndpointId;\n\n/**\n * The base class for all CC APIs exposed via `Node.commandClasses.<CCName>`\n * @publicAPI\n */\nexport class CCAPI {\n\tpublic constructor(\n\t\tprotected readonly host: CCAPIHost,\n\t\tprotected readonly endpoint: CCAPIEndpoint,\n\t) {\n\t\tthis.ccId = getCommandClass(this);\n\t}\n\n\tpublic static create<T extends CommandClasses>(\n\t\tccId: T,\n\t\thost: CCAPIHost,\n\t\tendpoint: CCAPIEndpoint,\n\t\trequireSupport?: boolean,\n\t): CommandClasses extends T ? CCAPI : CCToAPI<T> {\n\t\tconst APIConstructor = getAPI(ccId);\n\t\tconst ccName = CommandClasses[ccId];\n\t\tif (APIConstructor == undefined) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t`Command Class ${ccName} (${num2hex(\n\t\t\t\t\tccId,\n\t\t\t\t)}) has no associated API!`,\n\t\t\t\tZWaveErrorCodes.CC_NoAPI,\n\t\t\t);\n\t\t}\n\t\tconst apiInstance = new APIConstructor(host, endpoint);\n\n\t\t// Only require support for physical endpoints by default\n\t\trequireSupport ??= !endpoint.virtual;\n\n\t\tif (requireSupport) {\n\t\t\t// @ts-expect-error TS doesn't like assigning to conditional types\n\t\t\treturn new Proxy(apiInstance, {\n\t\t\t\tget: (target, property) => {\n\t\t\t\t\t// Forbid access to the API if it is not supported by the node\n\t\t\t\t\tif (\n\t\t\t\t\t\tproperty !== \"ccId\"\n\t\t\t\t\t\t&& property !== \"endpoint\"\n\t\t\t\t\t\t&& property !== \"isSupported\"\n\t\t\t\t\t\t&& property !== \"withOptions\"\n\t\t\t\t\t\t&& property !== \"commandOptions\"\n\t\t\t\t\t\t&& !target.isSupported()\n\t\t\t\t\t) {\n\t\t\t\t\t\tlet messageStart: string;\n\t\t\t\t\t\tif (endpoint.virtual) {\n\t\t\t\t\t\t\tconst hasNodeId =\n\t\t\t\t\t\t\t\ttypeof endpoint.nodeId === \"number\"\n\t\t\t\t\t\t\t\t&& endpoint.nodeId !== NODE_ID_BROADCAST\n\t\t\t\t\t\t\t\t&& endpoint.nodeId !== NODE_ID_BROADCAST_LR;\n\t\t\t\t\t\t\tmessageStart = `${\n\t\t\t\t\t\t\t\thasNodeId ? \"The\" : \"This\"\n\t\t\t\t\t\t\t} virtual node${\n\t\t\t\t\t\t\t\thasNodeId ? ` ${endpoint.nodeId}` : \"\"\n\t\t\t\t\t\t\t}`;\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tmessageStart = `Node ${endpoint.nodeId}`;\n\t\t\t\t\t\t}\n\t\t\t\t\t\tthrow new ZWaveError(\n\t\t\t\t\t\t\t`${messageStart}${\n\t\t\t\t\t\t\t\tendpoint.index === 0\n\t\t\t\t\t\t\t\t\t? \"\"\n\t\t\t\t\t\t\t\t\t: ` (endpoint ${endpoint.index})`\n\t\t\t\t\t\t\t} does not support the Command Class ${ccName}!`,\n\t\t\t\t\t\t\tZWaveErrorCodes.CC_NotSupported,\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\n\t\t\t\t\t// If a device config defines overrides for an API call, return a wrapper method that applies them first before calling the actual method\n\t\t\t\t\tconst fallback = target[property as keyof CCAPI];\n\t\t\t\t\tif (\n\t\t\t\t\t\ttypeof property === \"string\"\n\t\t\t\t\t\t&& !endpoint.virtual\n\t\t\t\t\t\t&& typeof fallback === \"function\"\n\t\t\t\t\t) {\n\t\t\t\t\t\tconst overrides = host.getDeviceConfig?.(\n\t\t\t\t\t\t\tendpoint.nodeId,\n\t\t\t\t\t\t)?.compat?.overrideQueries;\n\t\t\t\t\t\tif (overrides?.hasOverride(ccId)) {\n\t\t\t\t\t\t\treturn overrideQueriesWrapper(\n\t\t\t\t\t\t\t\thost,\n\t\t\t\t\t\t\t\tendpoint,\n\t\t\t\t\t\t\t\tccId,\n\t\t\t\t\t\t\t\tproperty,\n\t\t\t\t\t\t\t\toverrides,\n\t\t\t\t\t\t\t\tfallback,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\n\t\t\t\t\t// Else just access the property\n\t\t\t\t\treturn fallback;\n\t\t\t\t},\n\t\t\t});\n\t\t} else {\n\t\t\t// @ts-expect-error TS doesn't like assigning to conditional types\n\t\t\treturn apiInstance;\n\t\t}\n\t}\n\n\t/**\n\t * The identifier of the Command Class this API is for\n\t */\n\tpublic readonly ccId: CommandClasses;\n\n\tprotected get [SET_VALUE](): SetValueImplementation | undefined {\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * Can be used on supported CC APIs to set a CC value by property name (and optionally the property key).\n\t * **WARNING:** This function is NOT bound to an API instance. It must be called with the correct `this` context!\n\t */\n\tpublic get setValue(): SetValueImplementation | undefined {\n\t\treturn this[SET_VALUE];\n\t}\n\n\tprotected [SET_VALUE_HOOKS]: SetValueImplementationHooksFactory | undefined;\n\t/**\n\t * Can be implemented by CC APIs to influence the behavior of the setValue API in regards to Supervision and verifying values.\n\t */\n\tpublic get setValueHooks(): SetValueImplementationHooksFactory | undefined {\n\t\treturn this[SET_VALUE_HOOKS];\n\t}\n\n\t/** Whether a successful setValue call should imply that the value was successfully updated */\n\t// oxlint-disable-next-line no-unused-vars\n\tpublic isSetValueOptimistic(valueId: ValueID): boolean {\n\t\treturn true;\n\t}\n\n\tprotected get [POLL_VALUE](): PollValueImplementation | undefined {\n\t\treturn undefined;\n\t}\n\t/**\n\t * Can be used on supported CC APIs to poll a CC value by property name (and optionally the property key)\n\t * **WARNING:** This function is NOT bound to an API instance. It must be called with the correct `this` context!\n\t */\n\tpublic get pollValue(): PollValueImplementation | undefined {\n\t\treturn this[POLL_VALUE];\n\t}\n\n\t/**\n\t * Schedules a value to be polled after a given time. Schedules are deduplicated on a per-property basis.\n\t * @returns `true` if the poll was scheduled, `false` otherwise\n\t */\n\tprotected schedulePoll(\n\t\t{ property, propertyKey }: ValueIDProperties,\n\t\texpectedValue: unknown,\n\t\t{ duration, transition = \"slow\" }: CCAPISchedulePollOptions = {},\n\t): boolean {\n\t\t// Figure out the delay. If a non-zero duration was given or this is a \"fast\" transition,\n\t\t// use/add the short delay. Otherwise, default to the long delay.\n\t\tconst durationMs = duration?.toMilliseconds() ?? 0;\n\t\tconst timeouts = this.host.getRefreshValueTimeouts();\n\t\tconst additionalDelay =\n\t\t\t!!durationMs || transition === \"fast\"\n\t\t\t\t? timeouts.refreshValueAfterTransition\n\t\t\t\t: timeouts.refreshValue;\n\t\tconst timeoutMs = durationMs + additionalDelay;\n\n\t\tif (this.isSinglecast()) {\n\t\t\tconst node = this.host.getNode(this.endpoint.nodeId);\n\t\t\tif (!node) return false;\n\n\t\t\treturn this.host.schedulePoll(\n\t\t\t\tnode.id,\n\t\t\t\t{\n\t\t\t\t\tcommandClass: this.ccId,\n\t\t\t\t\tendpoint: this.endpoint.index,\n\t\t\t\t\tproperty,\n\t\t\t\t\tpropertyKey,\n\t\t\t\t},\n\t\t\t\t{ timeoutMs, expectedValue },\n\t\t\t);\n\t\t} else if (this.isMulticast()) {\n\t\t\t// Only poll supporting nodes in multicast\n\t\t\tconst supportingNodes = this.endpoint.node.physicalNodes.filter(\n\t\t\t\t(node) =>\n\t\t\t\t\tnode\n\t\t\t\t\t\t.getEndpoint(this.endpoint.index)\n\t\t\t\t\t\t?.supportsCC(this.ccId),\n\t\t\t);\n\t\t\tlet ret = false;\n\t\t\tfor (const node of supportingNodes) {\n\t\t\t\tret ||= this.host.schedulePoll(\n\t\t\t\t\tnode.id,\n\t\t\t\t\t{\n\t\t\t\t\t\tcommandClass: this.ccId,\n\t\t\t\t\t\tendpoint: this.endpoint.index,\n\t\t\t\t\t\tproperty,\n\t\t\t\t\t\tpropertyKey,\n\t\t\t\t\t},\n\t\t\t\t\t{ timeoutMs, expectedValue },\n\t\t\t\t);\n\t\t\t}\n\t\t\treturn ret;\n\t\t} else {\n\t\t\t// Don't poll the broadcast node\n\t\t\treturn false;\n\t\t}\n\t}\n\n\t/**\n\t * Retrieves the version of the given CommandClass this endpoint implements\n\t */\n\tpublic get version(): number {\n\t\tif (this.isSinglecast()) {\n\t\t\treturn (\n\t\t\t\tthis.host.getSafeCCVersion(\n\t\t\t\t\tthis.ccId,\n\t\t\t\t\tthis.endpoint.nodeId,\n\t\t\t\t\tthis.endpoint.index,\n\t\t\t\t) ?? 0\n\t\t\t);\n\t\t} else {\n\t\t\treturn getImplementedVersion(this.ccId);\n\t\t}\n\t}\n\n\t/** Determines if this simplified API instance may be used. */\n\tpublic isSupported(): boolean {\n\t\treturn (\n\t\t\t// NoOperation is always supported\n\t\t\tthis.ccId === CommandClasses[\"No Operation\"]\n\t\t\t// Basic should always be supported. Since we are trying to hide it from library consumers\n\t\t\t// we cannot trust supportsCC to test it\n\t\t\t|| this.ccId === CommandClasses.Basic\n\t\t\t|| this.endpoint.supportsCC(this.ccId)\n\t\t);\n\t}\n\n\t/**\n\t * Determine whether the linked node supports a specific command of this command class.\n\t * {@link NOT_KNOWN} (`undefined`) means that the information has not been received yet\n\t */\n\t// oxlint-disable-next-line no-unused-vars\n\tpublic supportsCommand(command: number): MaybeNotKnown<boolean> {\n\t\t// This needs to be overwritten per command class. In the default implementation, we don't know anything!\n\t\treturn NOT_KNOWN;\n\t}\n\n\tprotected assertSupportsCommand(\n\t\tcommandEnum: unknown,\n\t\tcommand: number,\n\t): void {\n\t\tif (this.supportsCommand(command) !== true) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t`${\n\t\t\t\t\tthis.isSinglecast()\n\t\t\t\t\t\t? `Node #${this.endpoint.nodeId}`\n\t\t\t\t\t\t: \"This virtual node\"\n\t\t\t\t}${\n\t\t\t\t\tthis.endpoint.index > 0\n\t\t\t\t\t\t? ` (Endpoint ${this.endpoint.index})`\n\t\t\t\t\t\t: \"\"\n\t\t\t\t} does not support the command ${getEnumMemberName(\n\t\t\t\t\tcommandEnum,\n\t\t\t\t\tcommand,\n\t\t\t\t)}!`,\n\t\t\t\tZWaveErrorCodes.CC_NotSupported,\n\t\t\t);\n\t\t}\n\t}\n\n\tprotected assertPhysicalEndpoint(\n\t\tendpoint: EndpointId | VirtualEndpointId,\n\t): asserts endpoint is EndpointId {\n\t\tif (endpoint.virtual) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t`This method is not supported for virtual nodes!`,\n\t\t\t\tZWaveErrorCodes.CC_NotSupported,\n\t\t\t);\n\t\t}\n\t}\n\n\t/** Returns the command options to use for sendCommand calls */\n\tprotected get commandOptions(): SendCommandOptions {\n\t\t// No default options\n\t\treturn {};\n\t}\n\n\t/** Creates an instance of this API, scoped to use the given options */\n\tpublic withOptions(options: SendCommandOptions): this {\n\t\tconst mergedOptions = {\n\t\t\t...this.commandOptions,\n\t\t\t...options,\n\t\t};\n\t\treturn new Proxy(this, {\n\t\t\tget: (target, property) => {\n\t\t\t\tif (property === \"commandOptions\") {\n\t\t\t\t\treturn mergedOptions;\n\t\t\t\t} else {\n\t\t\t\t\treturn (target as any)[property];\n\t\t\t\t}\n\t\t\t},\n\t\t});\n\t}\n\n\t/** Creates an instance of this API which (if supported) will return TX reports along with the result. */\n\tpublic withTXReport<T extends this>(): WithTXReport<T> {\n\t\tif (this.constructor === CCAPI) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t\"The withTXReport method may only be called on specific CC API implementations.\",\n\t\t\t\tZWaveErrorCodes.Driver_NotSupported,\n\t\t\t);\n\t\t}\n\n\t\t// Remember which properties need to be proxied\n\t\tconst proxiedProps = new Set([\n\t\t\t// These are the CC-specific methods\n\t\t\t...Object.getOwnPropertyNames(this.constructor.prototype),\n\t\t\t// as well as setValue and pollValue\n\t\t\t\"setValue\",\n\t\t\t\"pollValue\",\n\t\t]);\n\t\tproxiedProps.delete(\"constructor\");\n\n\t\tfunction wrapResult(result: unknown, txReport: TXReport): any {\n\t\t\t// Both the result and the TX report may be undefined (no response, no support)\n\t\t\treturn stripUndefined({\n\t\t\t\tresult,\n\t\t\t\ttxReport,\n\t\t\t});\n\t\t}\n\n\t\treturn new Proxy(this, {\n\t\t\tget: (target, prop) => {\n\t\t\t\tif (prop === \"withTXReport\") return undefined;\n\n\t\t\t\tlet original: any = (target as any)[prop];\n\t\t\t\tif (\n\t\t\t\t\tproxiedProps.has(prop as string)\n\t\t\t\t\t&& typeof original === \"function\"\n\t\t\t\t) {\n\t\t\t\t\t// This is a method that only exists in the specific implementation\n\n\t\t\t\t\t// Wrap each call with its own API proxy, so we don't mix up TX reports\n\t\t\t\t\tlet txReport: TXReport;\n\t\t\t\t\tconst api = target.withOptions({\n\t\t\t\t\t\tonTXReport: (report) => {\n\t\t\t\t\t\t\t// Remember the last status report\n\t\t\t\t\t\t\ttxReport = report;\n\t\t\t\t\t\t},\n\t\t\t\t\t});\n\t\t\t\t\toriginal = (api as any)[prop].bind(api);\n\n\t\t\t\t\t// Return a wrapper function that will add the status report after the call is complete\n\t\t\t\t\treturn (...args: any) => {\n\t\t\t\t\t\tlet result = original(...args);\n\t\t\t\t\t\tif (result instanceof Promise) {\n\t\t\t\t\t\t\tresult = result.then((res) =>\n\t\t\t\t\t\t\t\twrapResult(res, txReport),\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tresult = wrapResult(result, txReport);\n\t\t\t\t\t\t}\n\t\t\t\t\t\treturn result;\n\t\t\t\t\t};\n\t\t\t\t} else {\n\t\t\t\t\treturn original;\n\t\t\t\t}\n\t\t\t},\n\t\t}) as any;\n\t}\n\n\tprotected isSinglecast(): this is this & {\n\t\tendpoint: PhysicalCCAPIEndpoint;\n\t} {\n\t\treturn (\n\t\t\t!this.endpoint.virtual\n\t\t\t&& typeof this.endpoint.nodeId === \"number\"\n\t\t\t&& this.endpoint.nodeId !== NODE_ID_BROADCAST\n\t\t\t&& this.endpoint.nodeId !== NODE_ID_BROADCAST_LR\n\t\t);\n\t}\n\n\tprotected isMulticast(): this is this & {\n\t\tendpoint: VirtualCCAPIEndpoint & {\n\t\t\tnodeId: number[];\n\t\t};\n\t} {\n\t\treturn this.endpoint.virtual && isArray(this.endpoint.nodeId);\n\t}\n\n\tprotected isBroadcast(): this is this & {\n\t\tendpoint: VirtualCCAPIEndpoint & {\n\t\t\tnodeId: typeof NODE_ID_BROADCAST | typeof NODE_ID_BROADCAST_LR;\n\t\t};\n\t} {\n\t\treturn (\n\t\t\tthis.endpoint.virtual\n\t\t\t&& (this.endpoint.nodeId === NODE_ID_BROADCAST\n\t\t\t\t|| this.endpoint.nodeId === NODE_ID_BROADCAST_LR)\n\t\t);\n\t}\n\n\t/** Returns the value DB for this CC API's node (if it can be safely accessed) */\n\tprotected tryGetValueDB(): ValueDB | undefined {\n\t\tif (!this.isSinglecast()) return;\n\t\ttry {\n\t\t\treturn this.host.getValueDB(this.endpoint.nodeId);\n\t\t} catch {\n\t\t\treturn;\n\t\t}\n\t}\n\n\t/** Returns the value DB for this CC's node (or throws if it cannot be accessed) */\n\tprotected getValueDB(): ValueDB {\n\t\tif (this.isSinglecast()) {\n\t\t\ttry {\n\t\t\t\treturn this.host.getValueDB(this.endpoint.nodeId);\n\t\t\t} catch {\n\t\t\t\tthrow new ZWaveError(\n\t\t\t\t\t\"The node for this CC does not exist or the driver is not ready yet\",\n\t\t\t\t\tZWaveErrorCodes.Driver_NotReady,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t\tthrow new ZWaveError(\n\t\t\t\"Cannot retrieve the value DB for non-singlecast CCs\",\n\t\t\tZWaveErrorCodes.CC_NoNodeID,\n\t\t);\n\t}\n}\n\nfunction overrideQueriesWrapper(\n\tctx: GetValueDB & LogNode,\n\tendpoint: PhysicalCCAPIEndpoint,\n\tccId: CommandClasses,\n\tmethod: string,\n\toverrides: CompatOverrideQueries,\n\tfallback: (...args: any[]) => any,\n): (...args: any[]) => any {\n\t// We must not capture the `this` context here, because the API methods are bound on use\n\treturn function (this: any, ...args: any[]) {\n\t\tconst match = overrides.matchOverride(\n\t\t\tccId,\n\t\t\tendpoint.index,\n\t\t\tmethod,\n\t\t\targs,\n\t\t);\n\t\tif (!match) return fallback.call(this, ...args);\n\n\t\tctx.logNode(endpoint.nodeId, {\n\t\t\tmessage: `API call ${method} for ${getCCName(\n\t\t\t\tccId,\n\t\t\t)} CC overridden by a compat flag.`,\n\t\t\tlevel: \"debug\",\n\t\t\tdirection: \"none\",\n\t\t});\n\n\t\tconst ccValues = getCCValues(ccId);\n\t\tif (ccValues) {\n\t\t\tconst valueDB = ctx.getValueDB(endpoint.nodeId);\n\n\t\t\tconst prop2value = (prop: string): CCValue | undefined => {\n\t\t\t\t// We use a simplistic parser to support dynamic value IDs:\n\t\t\t\t// If end with round brackets with something inside, they are considered dynamic\n\t\t\t\t// Otherwise static\n\t\t\t\tconst argsMatch = prop.match(/^(.*)\\((.*)\\)$/);\n\t\t\t\tif (argsMatch) {\n\t\t\t\t\tconst methodName = argsMatch[1];\n\t\t\t\t\tconst methodArgs = JSON.parse(`[${argsMatch[2]}]`);\n\n\t\t\t\t\tconst dynValue = ccValues[methodName];\n\t\t\t\t\tif (typeof dynValue === \"function\") {\n\t\t\t\t\t\treturn dynValue(...methodArgs);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tconst staticValue = ccValues[prop] as\n\t\t\t\t\t\t| StaticCCValue\n\t\t\t\t\t\t| undefined;\n\t\t\t\t\tif (typeof staticValue?.endpoint === \"function\") {\n\t\t\t\t\t\treturn staticValue;\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t};\n\n\t\t\t// Persist values if necessary\n\t\t\tif (match.persistValues) {\n\t\t\t\tfor (const [prop, value] of Object.entries(\n\t\t\t\t\tmatch.persistValues,\n\t\t\t\t)) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst ccValue = prop2value(prop);\n\t\t\t\t\t\tif (ccValue) {\n\t\t\t\t\t\t\tvalueDB.setValue(\n\t\t\t\t\t\t\t\tccValue.endpoint(endpoint.index),\n\t\t\t\t\t\t\t\tvalue,\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tctx.logNode(endpoint.nodeId, {\n\t\t\t\t\t\t\t\tmessage: `Failed to persist value ${prop} during overridden API call: value does not exist`,\n\t\t\t\t\t\t\t\tlevel: \"error\",\n\t\t\t\t\t\t\t\tdirection: \"none\",\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch (e) {\n\t\t\t\t\t\tctx.logNode(endpoint.nodeId, {\n\t\t\t\t\t\t\tmessage: `Failed to persist value ${prop} during overridden API call: ${getErrorMessage(\n\t\t\t\t\t\t\t\te,\n\t\t\t\t\t\t\t)}`,\n\t\t\t\t\t\t\tlevel: \"error\",\n\t\t\t\t\t\t\tdirection: \"none\",\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// As well as metadata\n\t\t\tif (match.extendMetadata) {\n\t\t\t\tfor (const [prop, meta] of Object.entries(\n\t\t\t\t\tmatch.extendMetadata,\n\t\t\t\t)) {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst ccValue = prop2value(prop);\n\t\t\t\t\t\tif (ccValue) {\n\t\t\t\t\t\t\tvalueDB.setMetadata(\n\t\t\t\t\t\t\t\tccValue.endpoint(endpoint.index),\n\t\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\t\t...ccValue.meta,\n\t\t\t\t\t\t\t\t\t...meta,\n\t\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t);\n\t\t\t\t\t\t} else {\n\t\t\t\t\t\t\tctx.logNode(endpoint.nodeId, {\n\t\t\t\t\t\t\t\tmessage: `Failed to extend value metadata ${prop} during overridden API call: value does not exist`,\n\t\t\t\t\t\t\t\tlevel: \"error\",\n\t\t\t\t\t\t\t\tdirection: \"none\",\n\t\t\t\t\t\t\t});\n\t\t\t\t\t\t}\n\t\t\t\t\t} catch (e) {\n\t\t\t\t\t\tctx.logNode(endpoint.nodeId, {\n\t\t\t\t\t\t\tmessage: `Failed to extend value metadata ${prop} during overridden API call: ${getErrorMessage(\n\t\t\t\t\t\t\t\te,\n\t\t\t\t\t\t\t)}`,\n\t\t\t\t\t\t\tlevel: \"error\",\n\t\t\t\t\t\t\tdirection: \"none\",\n\t\t\t\t\t\t});\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\t// API methods are always async\n\t\treturn Promise.resolve(match.result);\n\t};\n}\n\n/** A CC API that is only available for physical endpoints */\nexport class PhysicalCCAPI extends CCAPI {\n\tpublic constructor(host: CCAPIHost, endpoint: CCAPIEndpoint) {\n\t\tsuper(host, endpoint);\n\t\tthis.assertPhysicalEndpoint(endpoint);\n\t}\n\n\tdeclare protected readonly endpoint: PhysicalCCAPIEndpoint;\n}\n\nexport type APIConstructor<T extends CCAPI = CCAPI> = new (\n\thost: CCAPIHost,\n\tendpoint: CCAPIEndpoint,\n) => T;\n\nexport type CCToName<CC extends CommandClasses> = {\n\t[K in keyof CCNameMap]: CCNameMap[K] extends CC ? K : never;\n}[keyof CCNameMap];\n\nexport type CCNameOrId = CommandClasses | Extract<keyof CCAPIs, string>;\n\nexport type CCToAPI<CC extends CCNameOrId> = CC extends CommandClasses\n\t? CCToName<CC> extends keyof CCAPIs\n\t\t? CCAPIs[CCToName<CC>]\n\t\t: never\n\t: CC extends keyof CCAPIs\n\t\t? CCAPIs[CC]\n\t\t: never;\n\nexport type APIMethodsOf<CC extends CCNameOrId> = Omit<\n\tOnlyMethods<CCToAPI<CC>>,\n\t| \"ccId\"\n\t| \"getNode\"\n\t| \"tryGetNode\"\n\t| \"isSetValueOptimistic\"\n\t| \"isSupported\"\n\t| \"pollValue\"\n\t| \"setValue\"\n\t| \"version\"\n\t| \"supportsCommand\"\n\t| \"withOptions\"\n\t| \"withTXReport\"\n>;\n\nexport type OwnMethodsOf<API extends CCAPI> = Omit<\n\tOnlyMethods<API>,\n\tkeyof OnlyMethods<CCAPI>\n>;\n\n// Wraps the given type in an object that contains a TX report\nexport type WrapWithTXReport<T> = [T] extends [Promise<infer U>]\n\t? Promise<WrapWithTXReport<U>>\n\t: [T] extends [void]\n\t\t? { txReport: TXReport | undefined }\n\t\t: { result: T; txReport: TXReport | undefined };\n\nexport type ReturnWithTXReport<T> = T extends (...args: any[]) => any\n\t? (...args: Parameters<T>) => WrapWithTXReport<ReturnType<T>>\n\t: undefined;\n\n// Converts the type of the given API implementation so the API methods return an object including the TX report\nexport type WithTXReport<API extends CCAPI> = Omit<\n\tAPI,\n\tkeyof OwnMethodsOf<API> | \"withOptions\" | \"withTXReport\" | \"setValue\"\n> & {\n\t[\n\t\tK in keyof OwnMethodsOf<API> | \"setValue\" | \"pollValue\"\n\t]: ReturnWithTXReport<API[K]>;\n};\n\nexport function normalizeCCNameOrId(\n\tccNameOrId: number | string,\n): CommandClasses | undefined {\n\tif (!(ccNameOrId in CommandClasses)) return undefined;\n\n\tlet ret: CommandClasses | undefined;\n\tif (typeof ccNameOrId === \"string\") {\n\t\tif (/^\\d+$/.test(ccNameOrId)) {\n\t\t\t// This can happen on property access\n\t\t\tret = +ccNameOrId;\n\t\t} else if (typeof (CommandClasses as any)[ccNameOrId] === \"number\") {\n\t\t\tret = (CommandClasses as any)[ccNameOrId];\n\t\t}\n\t} else {\n\t\tret = ccNameOrId;\n\t}\n\n\treturn ret;\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/build/cjs/lib/CommandClass.d.ts

@@ -11,6 +11,17 @@ export interface CommandClassOptions extends CCAddress {
     ccCommand?: number;
     payload?: BytesView;
 }
+export declare enum CommandRelation {
+    Unrelated = 0,
+    Redundant = 1,
+    Supersedes = 2
+}
+/**
+ * Compares command destinations. Single targets must match exactly.
+ * Multi-targets must contain the same IDs regardless of order.
+ */
+export declare function haveSameDestination(first: number | readonly number[], second: number | readonly number[]): boolean;
+export declare function getCommandRelation(newer: CommandClass, older: CommandClass): CommandRelation;
 export type CCEndpoint = EndpointId & SupportsCC & ControlsCC & GetCCs & ModifyCCs;
 export type CCNode = NodeId & SupportsCC & ControlsCC & GetCCs & GetEndpoint<CCEndpoint> & GetAllEndpoints<CCEndpoint> & QuerySecurityClasses & SetSecurityClass & ListenBehavior & QueryNodeStatus;
 export type InterviewContext = CCAPIHost<CCAPINode & GetCCs & SupportsCC & ControlsCC & QuerySecurityClasses & SetSecurityClass & ReportInterviewProgress & GetEndpoint<EndpointId & GetCCs & SupportsCC & ControlsCC & ModifyCCs> & GetAllEndpoints<EndpointId & SupportsCC & ControlsCC>> & GetInterviewOptions & LookupManufacturer;
@@ -38,6 +49,7 @@ export declare class CCRaw {
 export declare class CommandClass implements CCId {
     constructor(options: CommandClassOptions);
     static parse(data: BytesView, ctx: CCParsingContext): Promise<CommandClass>;
+    private static withFrameType;
     static from(raw: CCRaw, ctx: CCParsingContext): CommandClass | Promise<CommandClass>;
     /** This CC's identifier */
     ccId: CommandClasses;
@@ -58,8 +70,9 @@ export declare class CommandClass implements CCId {
     toggleEncapsulationFlag(flag: EncapsulationFlags, active: boolean): void;
     /** Contains a reference to the encapsulating CC if this CC is encapsulated */
     encapsulatingCC?: EncapsulatingCommandClass;
+    private _frameType?;
     /** The type of Z-Wave frame this CC was sent with */
-    readonly frameType?: FrameType;
+    get frameType(): FrameType | undefined;
     /** Returns true if this CC is an extended CC (0xF100..0xFFFF) */
     isExtended(): boolean;
     /** Whether the interview for this CC was previously completed */
@@ -71,6 +84,15 @@ export declare class CommandClass implements CCId {
      */
     serialize(ctx: CCEncodingContext): Promise<Bytes>;
     prepareRetransmission(): void;
+    /**
+     * Determines this command's relation to an older command. Shared command
+     * context must match before command-specific relation logic runs.
+     */
+    getRelationTo(other: CommandClass): CommandRelation;
+    /**
+     * Subclasses override this to determine additional command-specific relations.
+     */
+    protected determineRelation(_other: CommandClass): CommandRelation;
     /**
      * Create an instance of the given CC without checking whether it is supported.
      * If the CC is implemented, this returns an instance of the given CC which is linked to the given endpoint.

package/build/cjs/lib/CommandClass.js

@@ -21,9 +21,12 @@ var CommandClass_exports = {};
 __export(CommandClass_exports, {
   CCRaw: () => CCRaw,
   CommandClass: () => CommandClass,
+  CommandRelation: () => CommandRelation,
   InvalidCC: () => InvalidCC,
   ccToLogPayload: () => ccToLogPayload,
-  getEffectiveCCVersion: () => getEffectiveCCVersion
+  getCommandRelation: () => getCommandRelation,
+  getEffectiveCCVersion: () => getEffectiveCCVersion,
+  haveSameDestination: () => haveSameDestination
 });
 module.exports = __toCommonJS(CommandClass_exports);
 var import_core = require("@zwave-js/core");
@@ -32,6 +35,25 @@ var import_typeguards = require("alcalzone-shared/typeguards");
 var import_CommandClassDecorators = require("./CommandClassDecorators.js");
 var import_EncapsulatingCommandClass = require("./EncapsulatingCommandClass.js");
 var import_Values = require("./Values.js");
+var CommandRelation;
+(function(CommandRelation2) {
+  CommandRelation2[CommandRelation2["Unrelated"] = 0] = "Unrelated";
+  CommandRelation2[CommandRelation2["Redundant"] = 1] = "Redundant";
+  CommandRelation2[CommandRelation2["Supersedes"] = 2] = "Supersedes";
+})(CommandRelation || (CommandRelation = {}));
+function haveSameDestination(first, second) {
+  if (typeof first === "number" || typeof second === "number") {
+    return first === second;
+  }
+  const firstTargets = new Set(first);
+  const secondTargets = new Set(second);
+  return firstTargets.size === secondTargets.size && [...firstTargets].every((target) => secondTargets.has(target));
+}
+__name(haveSameDestination, "haveSameDestination");
+function getCommandRelation(newer, older) {
+  return newer.getRelationTo(older);
+}
+__name(getCommandRelation, "getCommandRelation");
 function getEffectiveCCVersion(ctx, cc, defaultVersion) {
   if (typeof cc.nodeId !== "number" || cc.nodeId === import_core.NODE_ID_BROADCAST || cc.nodeId === import_core.NODE_ID_BROADCAST_LR) {
     return (0, import_CommandClassDecorators.getImplementedVersion)(cc.ccId);
@@ -59,16 +81,10 @@ class CCRaw {
     let ccCommand = data[ccIdLength];
     let payload = import_shared.Bytes.view(data.subarray(ccIdLength + 1));
     if (ccId === import_core.CommandClasses["Transport Service"]) {
-      payload = import_shared.Bytes.concat([
-        [ccCommand & 7],
-        payload
-      ]);
+      payload = import_shared.Bytes.concat([[ccCommand & 7], payload]);
       ccCommand = ccCommand & 248;
     } else if (ccId === import_core.CommandClasses["Manufacturer Proprietary"]) {
-      payload = import_shared.Bytes.concat([
-        [ccCommand],
-        payload
-      ]);
+      payload = import_shared.Bytes.concat([[ccCommand], payload]);
       ccCommand = void 0;
     }
     return new CCRaw(ccId, ccCommand, payload);
@@ -94,14 +110,14 @@ class CommandClass {
     const raw = CCRaw.parse(data);
     const CCConstructor = (0, import_CommandClassDecorators.getCCConstructor)(raw.ccId);
     if (!CCConstructor) {
-      return await CommandClass.from(raw, ctx);
+      return CommandClass.withFrameType(await CommandClass.from(raw, ctx), ctx.frameType);
     }
     let CommandConstructor;
     if (raw.ccCommand != void 0) {
       CommandConstructor = (0, import_CommandClassDecorators.getCCCommandConstructor)(raw.ccId, raw.ccCommand);
     }
     try {
-      return await (CommandConstructor ?? CCConstructor).from(raw, ctx);
+      return CommandClass.withFrameType(await (CommandConstructor ?? CCConstructor).from(raw, ctx), ctx.frameType);
     } catch (e) {
       if ((0, import_core.isZWaveError)(e) && e.code === import_core.ZWaveErrorCodes.PacketFormat_InvalidPayload) {
         const ccName = CommandConstructor?.name ?? `${(0, import_core.getCCName)(raw.ccId)} CC`;
@@ -116,11 +132,15 @@ class CommandClass {
           ccName,
           reason
         });
-        return ret;
+        return CommandClass.withFrameType(ret, ctx.frameType);
       }
       throw e;
     }
   }
+  static withFrameType(cc, frameType) {
+    cc._frameType = frameType;
+    return cc;
+  }
   static from(raw, ctx) {
     return new this({
       nodeId: ctx.sourceNodeId,
@@ -156,8 +176,11 @@ class CommandClass {
   }
   /** Contains a reference to the encapsulating CC if this CC is encapsulated */
   encapsulatingCC;
+  _frameType;
   /** The type of Z-Wave frame this CC was sent with */
-  frameType;
+  get frameType() {
+    return this._frameType;
+  }
   /** Returns true if this CC is an extended CC (0xF100..0xFFFF) */
   isExtended() {
     return this.ccId >= 61696;
@@ -200,6 +223,22 @@ class CommandClass {
   }
   prepareRetransmission() {
   }
+  /**
+   * Determines this command's relation to an older command. Shared command
+   * context must match before command-specific relation logic runs.
+   */
+  getRelationTo(other) {
+    if (this.ccId !== other.ccId || !haveSameDestination(this.nodeId, other.nodeId) || this.endpointIndex !== other.endpointIndex || this.encapsulationFlags !== other.encapsulationFlags) {
+      return CommandRelation.Unrelated;
+    }
+    return this.determineRelation(other);
+  }
+  /**
+   * Subclasses override this to determine additional command-specific relations.
+   */
+  determineRelation(_other) {
+    return CommandRelation.Unrelated;
+  }
   /**
    * Create an instance of the given CC without checking whether it is supported.
    * If the CC is implemented, this returns an instance of the given CC which is linked to the given endpoint.
@@ -461,7 +500,13 @@ class CommandClass {
       ...valueDB.getValues(this.ccId),
       ...valueDB.getAllMetadata(this.ccId)
     ];
-    const supportedVersion = typeof this.nodeId === "number" && this.nodeId !== import_core.NODE_ID_BROADCAST && this.nodeId !== import_core.NODE_ID_BROADCAST_LR ? ctx.getSupportedCCVersion(this.ccId, this.nodeId, this.endpointIndex) : (0, import_CommandClassDecorators.getImplementedVersion)(this.ccId);
+    const supportedVersion = typeof this.nodeId === "number" && this.nodeId !== import_core.NODE_ID_BROADCAST && this.nodeId !== import_core.NODE_ID_BROADCAST_LR ? (
+      // On singlecast CCs, use the version the node reported support for,
+      ctx.getSupportedCCVersion(this.ccId, this.nodeId, this.endpointIndex)
+    ) : (
+      // on multicast/broadcast, use the highest version we implement
+      (0, import_CommandClassDecorators.getImplementedVersion)(this.ccId)
+    );
     for (const value of Object.values((0, import_CommandClassDecorators.getCCValues)(this) ?? {})) {
       if (!value || typeof value === "function")
         continue;
@@ -723,8 +768,11 @@ __name(ccToLogPayload, "ccToLogPayload");
 0 && (module.exports = {
   CCRaw,
   CommandClass,
+  CommandRelation,
   InvalidCC,
   ccToLogPayload,
-  getEffectiveCCVersion
+  getCommandRelation,
+  getEffectiveCCVersion,
+  haveSameDestination
 });
 //# sourceMappingURL=CommandClass.js.map