@zwave-js/cc 14.3.10 → 15.0.0-beta.1

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/CommandClass.ts"],
-  "sourcesContent": ["import {\n\ttype BroadcastCC,\n\ttype CCAddress,\n\ttype CCId,\n\tCommandClasses,\n\ttype ControlsCC,\n\tEncapsulationFlags,\n\ttype EndpointId,\n\ttype FrameType,\n\ttype GetAllEndpoints,\n\ttype GetCCs,\n\ttype GetEndpoint,\n\ttype ListenBehavior,\n\ttype MessageOrCCLogEntry,\n\ttype MessageRecord,\n\ttype ModifyCCs,\n\ttype MulticastCC,\n\ttype MulticastDestination,\n\tNODE_ID_BROADCAST,\n\tNODE_ID_BROADCAST_LR,\n\ttype NodeId,\n\ttype QueryNodeStatus,\n\ttype QuerySecurityClasses,\n\ttype SetSecurityClass,\n\ttype SinglecastCC,\n\ttype SupportsCC,\n\ttype ValueDB,\n\ttype ValueID,\n\ttype ValueMetadata,\n\tZWaveError,\n\tZWaveErrorCodes,\n\tgetCCName,\n\tisZWaveError,\n\tparseCCId,\n\tvalueIdToString,\n} from \"@zwave-js/core\";\nimport type {\n\tCCEncodingContext,\n\tCCParsingContext,\n\tGetDeviceConfig,\n\tGetInterviewOptions,\n\tGetNode,\n\tGetSupportedCCVersion,\n\tGetValueDB,\n\tHostIDs,\n\tLogNode,\n\tLookupManufacturer,\n} from \"@zwave-js/host\";\nimport {\n\tBytes,\n\ttype JSONObject,\n\tbuffer2hex,\n\tgetEnumMemberName,\n\tnum2hex,\n\tstaticExtends,\n} from \"@zwave-js/shared\";\nimport { isArray } from \"alcalzone-shared/typeguards\";\nimport type { CCAPIHost, CCAPINode, ValueIDProperties } from \"./API.js\";\nimport {\n\tgetCCCommand,\n\tgetCCCommandConstructor,\n\tgetCCConstructor,\n\tgetCCResponsePredicate,\n\tgetCCValueProperties,\n\tgetCCValues,\n\tgetCommandClass,\n\tgetExpectedCCResponse,\n\tgetImplementedVersion,\n} from \"./CommandClassDecorators.js\";\nimport {\n\ttype EncapsulatingCommandClass,\n\tisEncapsulatingCommandClass,\n\tisMultiEncapsulatingCommandClass,\n} from \"./EncapsulatingCommandClass.js\";\nimport {\n\ttype CCValue,\n\ttype DynamicCCValue,\n\ttype StaticCCValue,\n\tdefaultCCValueOptions,\n} from \"./Values.js\";\n\nexport interface CommandClassOptions extends CCAddress {\n\tccId?: number; // Used to overwrite the declared CC ID\n\tccCommand?: number; // undefined = NoOp\n\tpayload?: Uint8Array;\n}\n\n// Defines the necessary traits an endpoint passed to a CC instance must have\nexport type CCEndpoint =\n\t& EndpointId\n\t& SupportsCC\n\t& ControlsCC\n\t& GetCCs\n\t& ModifyCCs;\n\n// Defines the necessary traits a node passed to a CC instance must have\nexport type CCNode =\n\t& NodeId\n\t& SupportsCC\n\t& ControlsCC\n\t& GetCCs\n\t& GetEndpoint<CCEndpoint>\n\t& GetAllEndpoints<CCEndpoint>\n\t& QuerySecurityClasses\n\t& SetSecurityClass\n\t& ListenBehavior\n\t& QueryNodeStatus;\n\nexport type InterviewContext =\n\t& CCAPIHost<\n\t\t& CCAPINode\n\t\t& GetCCs\n\t\t& SupportsCC\n\t\t& ControlsCC\n\t\t& QuerySecurityClasses\n\t\t& SetSecurityClass\n\t\t& GetEndpoint<EndpointId & GetCCs & SupportsCC & ControlsCC & ModifyCCs>\n\t\t& GetAllEndpoints<EndpointId & SupportsCC & ControlsCC>\n\t>\n\t& GetInterviewOptions\n\t& LookupManufacturer;\n\nexport type RefreshValuesContext = CCAPIHost<\n\tCCAPINode & GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n>;\n\nexport type PersistValuesContext =\n\t& HostIDs\n\t& GetValueDB\n\t& GetSupportedCCVersion\n\t& GetDeviceConfig\n\t& GetNode<\n\t\tNodeId & GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n\t>\n\t& LogNode;\n\nexport function getEffectiveCCVersion(\n\tctx: GetSupportedCCVersion,\n\tcc: CCId,\n\tdefaultVersion?: number,\n): number {\n\t// For multicast and broadcast CCs, just use the highest implemented version to serialize\n\t// Older nodes will ignore the additional fields\n\tif (\n\t\ttypeof cc.nodeId !== \"number\"\n\t\t|| cc.nodeId === NODE_ID_BROADCAST\n\t\t|| cc.nodeId === NODE_ID_BROADCAST_LR\n\t) {\n\t\treturn getImplementedVersion(cc.ccId);\n\t}\n\t// For singlecast CCs, set the CC version as high as possible\n\treturn ctx.getSupportedCCVersion(cc.ccId, cc.nodeId, cc.endpointIndex)\n\t\t|| (defaultVersion ?? getImplementedVersion(cc.ccId));\n}\n\nexport class CCRaw {\n\tpublic constructor(\n\t\tpublic ccId: CommandClasses,\n\t\tpublic ccCommand: number | undefined,\n\t\tpublic payload: Bytes,\n\t) {}\n\n\tpublic static parse(data: Uint8Array): CCRaw {\n\t\tconst { ccId, bytesRead: ccIdLength } = parseCCId(data);\n\t\t// There are so few exceptions that we can handle them here manually\n\t\tif (ccId === CommandClasses[\"No Operation\"]) {\n\t\t\treturn new CCRaw(ccId, undefined, new Bytes());\n\t\t}\n\t\tlet ccCommand: number | undefined = data[ccIdLength];\n\t\tlet payload = Bytes.view(data.subarray(ccIdLength + 1));\n\t\tif (ccId === CommandClasses[\"Transport Service\"]) {\n\t\t\t// Transport Service only uses the higher 5 bits for the command\n\t\t\t// and re-uses the lower 3 bits of the ccCommand as payload\n\t\t\tpayload = Bytes.concat([\n\t\t\t\tBytes.from([ccCommand & 0b111]),\n\t\t\t\tpayload,\n\t\t\t]);\n\t\t\tccCommand = ccCommand & 0b11111_000;\n\t\t} else if (ccId === CommandClasses[\"Manufacturer Proprietary\"]) {\n\t\t\t// ManufacturerProprietaryCC has no CC command, so the first\n\t\t\t// payload byte is stored in ccCommand.\n\t\t\tpayload = Bytes.concat([\n\t\t\t\tBytes.from([ccCommand]),\n\t\t\t\tpayload,\n\t\t\t]);\n\t\t\tccCommand = undefined;\n\t\t}\n\n\t\treturn new CCRaw(ccId, ccCommand, payload);\n\t}\n\n\tpublic withPayload(payload: Bytes): CCRaw {\n\t\treturn new CCRaw(this.ccId, this.ccCommand, payload);\n\t}\n}\n\n// @publicAPI\nexport class CommandClass implements CCId {\n\t// empty constructor to parse messages\n\tpublic constructor(options: CommandClassOptions) {\n\t\tconst {\n\t\t\tnodeId,\n\t\t\tendpointIndex = 0,\n\t\t\tccId = getCommandClass(this),\n\t\t\tccCommand = getCCCommand(this),\n\t\t\tpayload = new Uint8Array(),\n\t\t} = options;\n\n\t\tthis.nodeId = nodeId;\n\t\tthis.endpointIndex = endpointIndex;\n\t\tthis.ccId = ccId;\n\t\tthis.ccCommand = ccCommand;\n\t\tthis.payload = Bytes.view(payload);\n\t}\n\n\t/** @deprecated Use {@link parseAsync} instead */\n\tpublic static parse(\n\t\tdata: Uint8Array,\n\t\tctx: CCParsingContext,\n\t): CommandClass {\n\t\tconst raw = CCRaw.parse(data);\n\n\t\t// Find the correct subclass constructor to invoke\n\t\tconst CCConstructor = getCCConstructor(raw.ccId);\n\t\tif (!CCConstructor) {\n\t\t\t// None -> fall back to the default constructor\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-deprecated\n\t\t\treturn CommandClass.from(raw, ctx);\n\t\t}\n\n\t\tlet CommandConstructor: CCConstructor<CommandClass> | undefined;\n\t\tif (raw.ccCommand != undefined) {\n\t\t\tCommandConstructor = getCCCommandConstructor(\n\t\t\t\traw.ccId,\n\t\t\t\traw.ccCommand,\n\t\t\t);\n\t\t}\n\t\t// Not every CC has a constructor for its commands. In that case,\n\t\t// call the CC constructor directly\n\t\ttry {\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-deprecated\n\t\t\treturn (CommandConstructor ?? CCConstructor).from(raw, ctx);\n\t\t} catch (e) {\n\t\t\t// Indicate invalid payloads with a special CC type\n\t\t\tif (\n\t\t\t\tisZWaveError(e)\n\t\t\t\t&& e.code === ZWaveErrorCodes.PacketFormat_InvalidPayload\n\t\t\t) {\n\t\t\t\tconst ccName = CommandConstructor?.name\n\t\t\t\t\t?? `${getCCName(raw.ccId)} CC`;\n\n\t\t\t\t// Preserve why the command was invalid\n\t\t\t\tlet reason: string | ZWaveErrorCodes | undefined;\n\t\t\t\tif (\n\t\t\t\t\ttypeof e.context === \"string\"\n\t\t\t\t\t|| (typeof e.context === \"number\"\n\t\t\t\t\t\t&& ZWaveErrorCodes[e.context] != undefined)\n\t\t\t\t) {\n\t\t\t\t\treason = e.context;\n\t\t\t\t}\n\n\t\t\t\tconst ret = new InvalidCC({\n\t\t\t\t\tnodeId: ctx.sourceNodeId,\n\t\t\t\t\tccId: raw.ccId,\n\t\t\t\t\tccCommand: raw.ccCommand,\n\t\t\t\t\tccName,\n\t\t\t\t\treason,\n\t\t\t\t});\n\n\t\t\t\treturn ret;\n\t\t\t}\n\t\t\tthrow e;\n\t\t}\n\t}\n\n\tpublic static async parseAsync(\n\t\tdata: Uint8Array,\n\t\tctx: CCParsingContext,\n\t): Promise<CommandClass> {\n\t\tconst raw = CCRaw.parse(data);\n\n\t\t// Find the correct subclass constructor to invoke\n\t\tconst CCConstructor = getCCConstructor(raw.ccId);\n\t\tif (!CCConstructor) {\n\t\t\t// None -> fall back to the default constructor\n\t\t\treturn CommandClass.fromAsync(raw, ctx);\n\t\t}\n\n\t\tlet CommandConstructor: CCConstructor<CommandClass> | undefined;\n\t\tif (raw.ccCommand != undefined) {\n\t\t\tCommandConstructor = getCCCommandConstructor(\n\t\t\t\traw.ccId,\n\t\t\t\traw.ccCommand,\n\t\t\t);\n\t\t}\n\t\t// Not every CC has a constructor for its commands. In that case,\n\t\t// call the CC constructor directly\n\t\ttry {\n\t\t\treturn await (CommandConstructor ?? CCConstructor).fromAsync(\n\t\t\t\traw,\n\t\t\t\tctx,\n\t\t\t);\n\t\t} catch (e) {\n\t\t\t// Indicate invalid payloads with a special CC type\n\t\t\tif (\n\t\t\t\tisZWaveError(e)\n\t\t\t\t&& e.code === ZWaveErrorCodes.PacketFormat_InvalidPayload\n\t\t\t) {\n\t\t\t\tconst ccName = CommandConstructor?.name\n\t\t\t\t\t?? `${getCCName(raw.ccId)} CC`;\n\n\t\t\t\t// Preserve why the command was invalid\n\t\t\t\tlet reason: string | ZWaveErrorCodes | undefined;\n\t\t\t\tif (\n\t\t\t\t\ttypeof e.context === \"string\"\n\t\t\t\t\t|| (typeof e.context === \"number\"\n\t\t\t\t\t\t&& ZWaveErrorCodes[e.context] != undefined)\n\t\t\t\t) {\n\t\t\t\t\treason = e.context;\n\t\t\t\t}\n\n\t\t\t\tconst ret = new InvalidCC({\n\t\t\t\t\tnodeId: ctx.sourceNodeId,\n\t\t\t\t\tccId: raw.ccId,\n\t\t\t\t\tccCommand: raw.ccCommand,\n\t\t\t\t\tccName,\n\t\t\t\t\treason,\n\t\t\t\t});\n\n\t\t\t\treturn ret;\n\t\t\t}\n\t\t\tthrow e;\n\t\t}\n\t}\n\n\t/** @deprecated Use {@link fromAsync} instead */\n\tpublic static from(raw: CCRaw, ctx: CCParsingContext): CommandClass {\n\t\treturn new this({\n\t\t\tnodeId: ctx.sourceNodeId,\n\t\t\tccId: raw.ccId,\n\t\t\tccCommand: raw.ccCommand,\n\t\t\tpayload: raw.payload,\n\t\t});\n\t}\n\n\t// eslint-disable-next-line @typescript-eslint/require-await\n\tpublic static async fromAsync(\n\t\traw: CCRaw,\n\t\tctx: CCParsingContext,\n\t): Promise<CommandClass> {\n\t\t// eslint-disable-next-line @typescript-eslint/no-deprecated\n\t\treturn this.from(raw, ctx);\n\n\t\t// TODO: Plan for next major release:\n\t\t// - CommandClass ONLY exposes `public static async from` (renamed!)\n\t\t// - CommandClass internally implements `protected static fromSync` and `protected static async fromAsync`\n\t\t// - The default implementation of `fromAsync` just calls `fromSync`\n\t\t// - Sub-classes override either `fromSync` OR `fromAsync` as needed\n\t}\n\n\t/** This CC's identifier */\n\tpublic ccId!: CommandClasses;\n\tpublic ccCommand?: number;\n\tpublic get ccName(): string {\n\t\treturn getCCName(this.ccId);\n\t}\n\n\t/** The ID of the target node(s) */\n\tpublic nodeId!: number | MulticastDestination;\n\n\tpublic payload: Bytes;\n\n\t/** Which endpoint of the node this CC belongs to. 0 for the root device. */\n\tpublic endpointIndex: number;\n\n\t/**\n\t * Which encapsulation CCs this CC is/was/should be encapsulated with.\n\t *\n\t * Don't use this directly, this is used internally.\n\t */\n\tpublic encapsulationFlags: EncapsulationFlags = EncapsulationFlags.None;\n\n\t/** Activates or deactivates the given encapsulation flag(s) */\n\tpublic toggleEncapsulationFlag(\n\t\tflag: EncapsulationFlags,\n\t\tactive: boolean,\n\t): void {\n\t\tif (active) {\n\t\t\tthis.encapsulationFlags |= flag;\n\t\t} else {\n\t\t\tthis.encapsulationFlags &= ~flag;\n\t\t}\n\t}\n\n\t/** Contains a reference to the encapsulating CC if this CC is encapsulated */\n\tpublic encapsulatingCC?: EncapsulatingCommandClass;\n\n\t/** The type of Z-Wave frame this CC was sent with */\n\tpublic readonly frameType?: FrameType;\n\n\t/** Returns true if this CC is an extended CC (0xF100..0xFFFF) */\n\tpublic isExtended(): boolean {\n\t\treturn this.ccId >= 0xf100;\n\t}\n\n\t/** Whether the interview for this CC was previously completed */\n\tpublic isInterviewComplete(host: GetValueDB): boolean {\n\t\treturn !!this.getValueDB(host).getValue<boolean>({\n\t\t\tcommandClass: this.ccId,\n\t\t\tendpoint: this.endpointIndex,\n\t\t\tproperty: \"interviewComplete\",\n\t\t});\n\t}\n\n\t/** Marks the interview for this CC as complete or not */\n\tpublic setInterviewComplete(\n\t\thost: GetValueDB,\n\t\tcomplete: boolean,\n\t): void {\n\t\tthis.getValueDB(host).setValue(\n\t\t\t{\n\t\t\t\tcommandClass: this.ccId,\n\t\t\t\tendpoint: this.endpointIndex,\n\t\t\t\tproperty: \"interviewComplete\",\n\t\t\t},\n\t\t\tcomplete,\n\t\t);\n\t}\n\n\t/**\n\t * Serializes this CommandClass to be embedded in a message payload or another CC\n\t * @deprecated Use {@link serializeAsync} instead\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars\n\tpublic serialize(ctx: CCEncodingContext): Bytes {\n\t\t// NoOp CCs have no command and no payload\n\t\tif (this.ccId === CommandClasses[\"No Operation\"]) {\n\t\t\treturn Bytes.from([this.ccId]);\n\t\t} else if (this.ccCommand == undefined) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t\"Cannot serialize a Command Class without a command\",\n\t\t\t\tZWaveErrorCodes.CC_Invalid,\n\t\t\t);\n\t\t}\n\n\t\tconst payloadLength = this.payload.length;\n\t\tconst ccIdLength = this.isExtended() ? 2 : 1;\n\t\tconst data = new Bytes(ccIdLength + 1 + payloadLength);\n\t\tdata.writeUIntBE(this.ccId, 0, ccIdLength);\n\t\tdata[ccIdLength] = this.ccCommand;\n\t\tif (payloadLength > 0 /* implies payload != undefined */) {\n\t\t\tdata.set(this.payload, 1 + ccIdLength);\n\t\t}\n\t\treturn data;\n\t}\n\n\t/**\n\t * Serializes this CommandClass to be embedded in a message payload or another CC\n\t */\n\t// eslint-disable-next-line @typescript-eslint/require-await\n\tpublic async serializeAsync(ctx: CCEncodingContext): Promise<Bytes> {\n\t\t// This call is for backwards compatibility purposes. Not all\n\t\t// CC subclasses implement serializeAsync, so those need to internally\n\t\t// call serialize()\n\t\t// For those that do, we MUST not call the subclass' serialize method\n\t\t// directly, or the side effects may run twice.\n\t\tif (this.serializeAsync !== CommandClass.prototype.serializeAsync) {\n\t\t\t// Subclass implements serializeAsync, and we've reached the top\n\t\t\t// of the inheritance chain. Call CommandClass.serialize to finish.\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-deprecated\n\t\t\treturn CommandClass.prototype.serialize.call(this, ctx);\n\t\t} else {\n\t\t\t// Subclass does not implement serializeAsync, call its\n\t\t\t// serialize method instead\n\t\t\t// eslint-disable-next-line @typescript-eslint/no-deprecated\n\t\t\treturn this.serialize(ctx);\n\t\t}\n\n\t\t// TODO: Plan for next major release:\n\t\t// - CommandClass ONLY exposes `public async serialize` (renamed!)\n\t\t// - CommandClass internally implements `protected serializeSync` and `protected async serializeAsync`\n\t\t// - The default implementation of `serializeAsync` just calls `serializeSync`\n\t\t// - Sub-classes override either `serializeSync` OR `serializeAsync` as needed\n\t}\n\n\tpublic prepareRetransmission(): void {\n\t\t// Do nothing by default\n\t}\n\n\t/**\n\t * Create an instance of the given CC without checking whether it is supported.\n\t * If the CC is implemented, this returns an instance of the given CC which is linked to the given endpoint.\n\t *\n\t * **INTERNAL:** Applications should not use this directly.\n\t */\n\tpublic static createInstanceUnchecked<T extends CommandClass>(\n\t\tendpoint: EndpointId,\n\t\tcc: CommandClasses | CCConstructor<T>,\n\t): T | undefined {\n\t\tconst Constructor = typeof cc === \"number\" ? getCCConstructor(cc) : cc;\n\t\tif (Constructor) {\n\t\t\treturn new Constructor({\n\t\t\t\tnodeId: endpoint.nodeId,\n\t\t\t\tendpointIndex: endpoint.index,\n\t\t\t}) as T;\n\t\t}\n\t}\n\n\t/** Generates a representation of this CC for the log */\n\tpublic toLogEntry(_ctx?: GetValueDB): MessageOrCCLogEntry {\n\t\tlet tag = this.constructor.name;\n\t\tconst message: MessageRecord = {};\n\t\tif (this.constructor === CommandClass) {\n\t\t\ttag = `${\n\t\t\t\tgetEnumMemberName(\n\t\t\t\t\tCommandClasses,\n\t\t\t\t\tthis.ccId,\n\t\t\t\t)\n\t\t\t} CC (not implemented)`;\n\t\t\tif (this.ccCommand != undefined) {\n\t\t\t\tmessage.command = num2hex(this.ccCommand);\n\t\t\t}\n\t\t}\n\t\tif (this.payload.length > 0) {\n\t\t\tmessage.payload = buffer2hex(this.payload);\n\t\t}\n\t\treturn {\n\t\t\ttags: [tag],\n\t\t\tmessage,\n\t\t};\n\t}\n\n\t/** Generates the JSON representation of this CC */\n\tpublic toJSON(): JSONObject {\n\t\treturn this.toJSONInternal();\n\t}\n\n\tprivate toJSONInternal(): JSONObject {\n\t\tconst ret: JSONObject = {\n\t\t\tnodeId: this.nodeId,\n\t\t\tccId: CommandClasses[this.ccId] || num2hex(this.ccId),\n\t\t};\n\t\tif (this.ccCommand != undefined) {\n\t\t\tret.ccCommand = num2hex(this.ccCommand);\n\t\t}\n\t\tif (this.payload.length > 0) {\n\t\t\tret.payload = buffer2hex(this.payload);\n\t\t}\n\t\treturn ret;\n\t}\n\n\tprotected throwMissingCriticalInterviewResponse(): never {\n\t\tthrow new ZWaveError(\n\t\t\t`The node did not respond to a critical interview query in time.`,\n\t\t\tZWaveErrorCodes.Controller_NodeTimeout,\n\t\t);\n\t}\n\n\t/**\n\t * Performs the interview procedure for this CC according to SDS14223\n\t */\n\tpublic async interview(_ctx: InterviewContext): Promise<void> {\n\t\t// This needs to be overwritten per command class. In the default implementation, don't do anything\n\t}\n\n\t/**\n\t * Refreshes all dynamic values of this CC\n\t */\n\tpublic async refreshValues(_ctx: RefreshValuesContext): Promise<void> {\n\t\t// This needs to be overwritten per command class. In the default implementation, don't do anything\n\t}\n\n\t/**\n\t * Checks if the CC values need to be manually refreshed.\n\t * This should be called regularly and when sleeping nodes wake up\n\t */\n\tpublic shouldRefreshValues(\n\t\tthis: SinglecastCC<this>,\n\t\t_ctx:\n\t\t\t& GetValueDB\n\t\t\t& GetSupportedCCVersion\n\t\t\t& GetDeviceConfig\n\t\t\t& GetNode<\n\t\t\t\tNodeId & GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n\t\t\t>,\n\t): boolean {\n\t\t// This needs to be overwritten per command class.\n\t\t// In the default implementation, don't require a refresh\n\t\treturn false;\n\t}\n\n\t/** Determines which CC interviews must be performed before this CC can be interviewed */\n\tpublic determineRequiredCCInterviews(): readonly CommandClasses[] {\n\t\t// By default, all CCs require the VersionCC interview\n\n\t\t// There are two exceptions to this rule:\n\t\t// * ManufacturerSpecific must be interviewed first\n\t\t// * VersionCC itself must be done after that\n\t\t// These exceptions are defined in the overrides of this method of each corresponding CC\n\n\t\treturn [CommandClasses.Version];\n\t}\n\n\t/**\n\t * Whether the endpoint interview may be skipped by a CC. Can be overwritten by a subclass.\n\t */\n\tpublic skipEndpointInterview(): boolean {\n\t\t// By default no interview may be skipped\n\t\treturn false;\n\t}\n\n\t/**\n\t * Maps a BasicCC value to a more specific CC implementation. Returns true if the value was mapped, false otherwise.\n\t * @param _value The value of the received BasicCC\n\t */\n\tpublic setMappedBasicValue(\n\t\t_ctx: GetValueDB,\n\t\t_value: number,\n\t): boolean {\n\t\t// By default, don't map\n\t\treturn false;\n\t}\n\n\tpublic isSinglecast(): this is SinglecastCC<this> {\n\t\treturn (\n\t\t\t// received\n\t\t\tthis.frameType === \"singlecast\"\n\t\t\t// transmitted\n\t\t\t|| (this.frameType == undefined\n\t\t\t\t&& typeof this.nodeId === \"number\"\n\t\t\t\t&& this.nodeId !== NODE_ID_BROADCAST\n\t\t\t\t&& this.nodeId !== NODE_ID_BROADCAST_LR)\n\t\t);\n\t}\n\n\tpublic isMulticast(): this is MulticastCC<this> {\n\t\treturn (\n\t\t\t// received\n\t\t\tthis.frameType === \"multicast\"\n\t\t\t// transmitted\n\t\t\t|| (this.frameType == undefined && isArray(this.nodeId))\n\t\t);\n\t}\n\n\tpublic isBroadcast(): this is BroadcastCC<this> {\n\t\treturn (\n\t\t\t// received\n\t\t\tthis.frameType === \"broadcast\"\n\t\t\t// transmitted\n\t\t\t|| (this.frameType == undefined\n\t\t\t\t&& (this.nodeId === NODE_ID_BROADCAST\n\t\t\t\t\t|| this.nodeId === NODE_ID_BROADCAST_LR))\n\t\t);\n\t}\n\n\t/**\n\t * Returns the node this CC is linked to. Throws if the controller is not yet ready.\n\t */\n\tpublic getNode<T extends NodeId>(\n\t\tctx: GetNode<T>,\n\t): T | undefined {\n\t\tif (this.isSinglecast()) {\n\t\t\treturn ctx.getNode(this.nodeId);\n\t\t}\n\t}\n\n\t/**\n\t * @internal\n\t * Returns the node this CC is linked to (or undefined if the node doesn't exist)\n\t */\n\tpublic tryGetNode<T extends NodeId>(\n\t\tctx: GetNode<T>,\n\t): T | undefined {\n\t\ttry {\n\t\t\treturn this.getNode(ctx);\n\t\t} catch (e) {\n\t\t\t// This was expected\n\t\t\tif (isZWaveError(e) && e.code === ZWaveErrorCodes.Driver_NotReady) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\t// Something else happened\n\t\t\tthrow e;\n\t\t}\n\t}\n\n\tpublic getEndpoint<T extends EndpointId>(\n\t\tctx: GetNode<NodeId & GetEndpoint<T>>,\n\t): T | undefined {\n\t\treturn this.getNode(ctx)?.getEndpoint(this.endpointIndex);\n\t}\n\n\t/** Returns the value DB for this CC's node */\n\tprotected getValueDB(ctx: GetValueDB): ValueDB {\n\t\tif (this.isSinglecast()) {\n\t\t\ttry {\n\t\t\t\treturn ctx.getValueDB(this.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\t/**\n\t * Ensures that the metadata for the given CC value exists in the Value DB or creates it if it does not.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t * @param meta Will be used in place of the predefined metadata when given\n\t */\n\tprotected ensureMetadata(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t\tmeta?: ValueMetadata,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tif (!valueDB.hasMetadata(valueId)) {\n\t\t\tvalueDB.setMetadata(valueId, meta ?? ccValue.meta);\n\t\t}\n\t}\n\n\t/**\n\t * Removes the metadata for the given CC value from the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected removeMetadata(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tvalueDB.setMetadata(valueId, undefined);\n\t}\n\n\t/**\n\t * Writes the metadata for the given CC value into the Value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t * @param meta Will be used in place of the predefined metadata when given\n\t */\n\tprotected setMetadata(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t\tmeta?: ValueMetadata,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tvalueDB.setMetadata(valueId, meta ?? ccValue.meta);\n\t}\n\n\t/**\n\t * Reads the metadata for the given CC value from the Value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected getMetadata<T extends ValueMetadata>(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): T | undefined {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\treturn valueDB.getMetadata(valueId) as any;\n\t}\n\n\t/**\n\t * Stores the given value under the value ID for the given CC value in the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected setValue(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t\tvalue: unknown,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tvalueDB.setValue(valueId, value);\n\t}\n\n\t/**\n\t * Removes the value for the given CC value from the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected removeValue(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tvalueDB.removeValue(valueId);\n\t}\n\n\t/**\n\t * Reads the value stored for the value ID of the given CC value from the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected getValue<T>(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): T | undefined {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\treturn valueDB.getValue(valueId);\n\t}\n\n\t/**\n\t * Reads when the value stored for the value ID of the given CC value was last updated in the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected getValueTimestamp(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): number | undefined {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\treturn valueDB.getTimestamp(valueId);\n\t}\n\n\t/** Returns the CC value definition for the current CC which matches the given value ID */\n\tprotected getCCValue(\n\t\tvalueId: ValueID,\n\t): StaticCCValue | DynamicCCValue | undefined {\n\t\tconst ccValues = getCCValues(this);\n\t\tif (!ccValues) return;\n\n\t\tfor (const value of Object.values(ccValues)) {\n\t\t\tif (value?.is(valueId)) {\n\t\t\t\treturn value;\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate getAllCCValues(): (StaticCCValue | DynamicCCValue)[] {\n\t\treturn Object.values(getCCValues(this) ?? {}) as (\n\t\t\t| StaticCCValue\n\t\t\t| DynamicCCValue\n\t\t)[];\n\t}\n\n\tprivate getCCValueForValueId(\n\t\tproperties: ValueIDProperties,\n\t): StaticCCValue | DynamicCCValue | undefined {\n\t\treturn this.getAllCCValues().find((value) =>\n\t\t\tvalue.is({\n\t\t\t\tcommandClass: this.ccId,\n\t\t\t\t...properties,\n\t\t\t})\n\t\t);\n\t}\n\n\tprivate shouldAutoCreateValue(\n\t\tctx: GetValueDB & GetDeviceConfig,\n\t\tvalue: StaticCCValue,\n\t): boolean {\n\t\treturn (\n\t\t\tvalue.options.autoCreate === true\n\t\t\t|| (typeof value.options.autoCreate === \"function\"\n\t\t\t\t&& value.options.autoCreate(\n\t\t\t\t\tctx,\n\t\t\t\t\t{\n\t\t\t\t\t\tvirtual: false,\n\t\t\t\t\t\tnodeId: this.nodeId as number,\n\t\t\t\t\t\tindex: this.endpointIndex,\n\t\t\t\t\t},\n\t\t\t\t))\n\t\t);\n\t}\n\n\t/** Returns a list of all value names that are defined for this CommandClass */\n\tpublic getDefinedValueIDs(\n\t\tctx:\n\t\t\t& GetValueDB\n\t\t\t& GetSupportedCCVersion\n\t\t\t& GetDeviceConfig\n\t\t\t& GetNode<\n\t\t\t\tNodeId & GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n\t\t\t>,\n\t\tincludeInternal: boolean = false,\n\t): ValueID[] {\n\t\t// In order to compare value ids, we need them to be strings\n\t\tconst ret = new Map<string, ValueID>();\n\n\t\tconst addValueId = (\n\t\t\tproperty: string | number,\n\t\t\tpropertyKey?: string | number,\n\t\t): void => {\n\t\t\tconst valueId: ValueID = {\n\t\t\t\tcommandClass: this.ccId,\n\t\t\t\tendpoint: this.endpointIndex,\n\t\t\t\tproperty,\n\t\t\t\tpropertyKey,\n\t\t\t};\n\t\t\tconst dbKey = valueIdToString(valueId);\n\t\t\tif (!ret.has(dbKey)) ret.set(dbKey, valueId);\n\t\t};\n\n\t\t// Return all value IDs for this CC...\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\t// ...which either have metadata or a value\n\t\tconst existingValueIds: ValueID[] = [\n\t\t\t...valueDB.getValues(this.ccId),\n\t\t\t...valueDB.getAllMetadata(this.ccId),\n\t\t];\n\n\t\t// To determine which value IDs to expose, we need to know the CC version\n\t\t// that we're doing this for\n\t\tconst supportedVersion = typeof this.nodeId === \"number\"\n\t\t\t\t&& this.nodeId !== NODE_ID_BROADCAST\n\t\t\t\t&& this.nodeId !== NODE_ID_BROADCAST_LR\n\t\t\t// On singlecast CCs, use the version the node reported support for,\n\t\t\t? ctx.getSupportedCCVersion(\n\t\t\t\tthis.ccId,\n\t\t\t\tthis.nodeId,\n\t\t\t\tthis.endpointIndex,\n\t\t\t)\n\t\t\t// on multicast/broadcast, use the highest version we implement\n\t\t\t: getImplementedVersion(this.ccId);\n\n\t\t// ...or which are statically defined using @ccValues(...)\n\t\tfor (const value of Object.values(getCCValues(this) ?? {})) {\n\t\t\t// Skip dynamic CC values - they need a specific subclass instance to be evaluated\n\t\t\tif (!value || typeof value === \"function\") continue;\n\n\t\t\t// Skip those values that are only supported in higher versions of the CC\n\t\t\tif (\n\t\t\t\tvalue.options.minVersion != undefined\n\t\t\t\t&& value.options.minVersion > supportedVersion\n\t\t\t) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Skip internal values\n\t\t\tif (value.options.internal && !includeInternal) continue;\n\n\t\t\t// And determine if this value should be automatically \"created\"\n\t\t\tif (!this.shouldAutoCreateValue(ctx, value)) continue;\n\n\t\t\texistingValueIds.push(value.endpoint(this.endpointIndex));\n\t\t}\n\n\t\t// TODO: this is a bit awkward for the statically defined ones\n\t\tconst ccValues = this.getAllCCValues();\n\t\tfor (const valueId of existingValueIds) {\n\t\t\t// ...belonging to the current endpoint\n\t\t\tif ((valueId.endpoint ?? 0) !== this.endpointIndex) continue;\n\n\t\t\t// Hard-coded: interviewComplete is always internal\n\t\t\tif (valueId.property === \"interviewComplete\") continue;\n\n\t\t\t// ... which don't have a CC value definition\n\t\t\t// ... or one that does not mark the value ID as internal\n\t\t\tconst ccValue = ccValues.find((value) => value.is(valueId));\n\t\t\tif (!ccValue || !ccValue.options.internal || includeInternal) {\n\t\t\t\taddValueId(valueId.property, valueId.propertyKey);\n\t\t\t}\n\t\t}\n\n\t\treturn [...ret.values()];\n\t}\n\n\t/** Determines if the given value is an internal value */\n\tpublic isInternalValue(properties: ValueIDProperties): boolean {\n\t\t// Hard-coded: interviewComplete is always internal\n\t\tif (properties.property === \"interviewComplete\") return true;\n\n\t\tconst ccValue = this.getCCValueForValueId(properties);\n\t\treturn ccValue?.options.internal ?? defaultCCValueOptions.internal;\n\t}\n\n\t/** Determines if the given value is an secret value */\n\tpublic isSecretValue(properties: ValueIDProperties): boolean {\n\t\tconst ccValue = this.getCCValueForValueId(properties);\n\t\treturn ccValue?.options.secret ?? defaultCCValueOptions.secret;\n\t}\n\n\t/** Determines if the given value should be persisted or represents an event */\n\tpublic isStatefulValue(properties: ValueIDProperties): boolean {\n\t\tconst ccValue = this.getCCValueForValueId(properties);\n\t\treturn ccValue?.options.stateful ?? defaultCCValueOptions.stateful;\n\t}\n\n\t/**\n\t * Persists all values for this CC instance into the value DB which are annotated with @ccValue.\n\t * Returns `true` if the process succeeded, `false` if the value DB cannot be accessed.\n\t */\n\tpublic persistValues(ctx: PersistValuesContext): boolean {\n\t\tlet valueDB: ValueDB;\n\t\ttry {\n\t\t\tvalueDB = this.getValueDB(ctx);\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\n\t\t// To determine which value IDs to expose, we need to know the CC version\n\t\t// that we're doing this for\n\t\tconst supportedVersion = ctx.getSupportedCCVersion(\n\t\t\tthis.ccId,\n\t\t\t// Values are only persisted for singlecast, so we know nodeId is a number\n\t\t\tthis.nodeId as number,\n\t\t\tthis.endpointIndex,\n\t\t\t// If the version isn't known yet, limit the created values to V1\n\t\t) || 1;\n\n\t\t// Get all properties of this CC which are annotated with a @ccValue decorator and store them.\n\t\tfor (const [prop, _value] of getCCValueProperties(this)) {\n\t\t\t// Evaluate dynamic CC values first\n\t\t\tconst value = typeof _value === \"function\" ? _value(this) : _value;\n\n\t\t\t// Skip those values that are only supported in higher versions of the CC\n\t\t\tif (\n\t\t\t\tvalue.options.minVersion != undefined\n\t\t\t\t&& value.options.minVersion > supportedVersion\n\t\t\t) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst valueId: ValueID = value.endpoint(this.endpointIndex);\n\t\t\tconst sourceValue = this[prop as keyof this];\n\n\t\t\t// Metadata gets created for non-internal values...\n\t\t\tconst createMetadata = !value.options.internal\n\t\t\t\t// ... but only if the value is included in the report we are persisting\n\t\t\t\t&& (sourceValue != undefined\n\t\t\t\t\t// ... or if we know which CC version the node supports\n\t\t\t\t\t// and the value may be automatically created\n\t\t\t\t\t|| (supportedVersion >= value.options.minVersion\n\t\t\t\t\t\t&& this.shouldAutoCreateValue(ctx, value)));\n\n\t\t\tif (createMetadata && !valueDB.hasMetadata(valueId)) {\n\t\t\t\tvalueDB.setMetadata(valueId, value.meta);\n\t\t\t}\n\n\t\t\t// The value only gets written if it is not undefined. null is a valid value!\n\t\t\tif (sourceValue === undefined) continue;\n\n\t\t\tvalueDB.setValue(valueId, sourceValue, {\n\t\t\t\tstateful: value.options.stateful,\n\t\t\t});\n\t\t}\n\n\t\treturn true;\n\t}\n\n\t/**\n\t * When a CC supports to be split into multiple partial CCs, this can be used to identify the\n\t * session the partial CCs belong to.\n\t * If a CC expects `mergePartialCCs` to be always called, you should return an empty object here.\n\t */\n\tpublic getPartialCCSessionId(): Record<string, any> | undefined {\n\t\treturn undefined; // Only select CCs support to be split\n\t}\n\n\t/**\n\t * When a CC supports to be split into multiple partial CCs, this indicates that the last report hasn't been received yet.\n\t * @param _session The previously received set of messages received in this partial CC session\n\t */\n\tpublic expectMoreMessages(_session: CommandClass[]): boolean {\n\t\treturn false; // By default, all CCs are monolithic\n\t}\n\n\t/**\n\t * Include previously received partial responses into a final CC\n\t * @deprecated Use {@link mergePartialCCsAsync} instead\n\t */\n\tpublic mergePartialCCs(\n\t\t_partials: CommandClass[],\n\t\t_ctx: CCParsingContext,\n\t): void {\n\t\t// This is highly CC dependent\n\t\t// Overwrite this in derived classes, by default do nothing\n\t}\n\n\t/** Include previously received partial responses into a final CC */\n\tpublic async mergePartialCCsAsync(\n\t\t_partials: CommandClass[],\n\t\t_ctx: CCParsingContext,\n\t): Promise<void> {\n\t\t// This is highly CC dependent\n\t\t// Overwrite this in derived classes, by default do nothing\n\t}\n\n\t/** Tests whether this CC expects at least one command in return */\n\tpublic expectsCCResponse(): boolean {\n\t\tlet expected:\n\t\t\t| DynamicCCResponse<this>\n\t\t\t| ReturnType<DynamicCCResponse<this>> = getExpectedCCResponse(this);\n\n\t\t// Evaluate dynamic CC responses\n\t\tif (\n\t\t\ttypeof expected === \"function\"\n\t\t\t&& !staticExtends(expected, CommandClass)\n\t\t) {\n\t\t\texpected = expected(this);\n\t\t}\n\t\tif (expected === undefined) return false;\n\t\tif (isArray(expected)) {\n\t\t\treturn expected.every((cc) => staticExtends(cc, CommandClass));\n\t\t} else {\n\t\t\treturn staticExtends(expected, CommandClass);\n\t\t}\n\t}\n\n\tpublic isExpectedCCResponse(received: CommandClass): boolean {\n\t\tif (received.nodeId !== this.nodeId) return false;\n\n\t\tlet expected:\n\t\t\t| DynamicCCResponse<this>\n\t\t\t| ReturnType<DynamicCCResponse<this>> = getExpectedCCResponse(this);\n\n\t\t// Evaluate dynamic CC responses\n\t\tif (\n\t\t\ttypeof expected === \"function\"\n\t\t\t&& !staticExtends(expected, CommandClass)\n\t\t) {\n\t\t\texpected = expected(this);\n\t\t}\n\n\t\tif (expected == undefined) {\n\t\t\t// Fallback, should not happen if the expected response is defined correctly\n\t\t\treturn false;\n\t\t} else if (\n\t\t\tisArray(expected)\n\t\t\t&& expected.every((cc) => staticExtends(cc, CommandClass))\n\t\t) {\n\t\t\t// The CC always expects a response from the given list, check if the received\n\t\t\t// message is in that list\n\t\t\tif (expected.every((base) => !(received instanceof base))) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t} else if (staticExtends(expected, CommandClass)) {\n\t\t\t// The CC always expects the same single response, check if this is the one\n\t\t\tif (!(received instanceof expected)) return false;\n\t\t}\n\n\t\t// If the CC wants to test the response, let it\n\t\tconst predicate = getCCResponsePredicate(this);\n\t\tconst ret = predicate?.(this, received) ?? true;\n\n\t\tif (ret === \"checkEncapsulated\") {\n\t\t\tif (\n\t\t\t\tisEncapsulatingCommandClass(this)\n\t\t\t\t&& isEncapsulatingCommandClass(received)\n\t\t\t) {\n\t\t\t\treturn this.encapsulated.isExpectedCCResponse(\n\t\t\t\t\treceived.encapsulated,\n\t\t\t\t);\n\t\t\t} else {\n\t\t\t\t// Fallback, should not happen if the expected response is defined correctly\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\n\t\treturn ret;\n\t}\n\n\t/**\n\t * Translates a property identifier into a speaking name for use in an external API\n\t * @param property The property identifier that should be translated\n\t * @param _propertyKey The (optional) property key the translated name may depend on\n\t */\n\tpublic translateProperty(\n\t\t_ctx: GetValueDB,\n\t\tproperty: string | number,\n\t\t_propertyKey?: string | number,\n\t): string {\n\t\t// Overwrite this in derived classes, by default just return the property key\n\t\treturn property.toString();\n\t}\n\n\t/**\n\t * Translates a property key into a speaking name for use in an external API\n\t * @param _property The property the key in question belongs to\n\t * @param propertyKey The property key for which the speaking name should be retrieved\n\t */\n\tpublic translatePropertyKey(\n\t\t_ctx: GetValueDB,\n\t\t_property: string | number,\n\t\tpropertyKey: string | number,\n\t): string | undefined {\n\t\t// Overwrite this in derived classes, by default just return the property key\n\t\treturn propertyKey.toString();\n\t}\n\n\t/** Returns the number of bytes that are added to the payload by this CC */\n\tprotected computeEncapsulationOverhead(): number {\n\t\t// Default is ccId (+ ccCommand):\n\t\treturn (this.isExtended() ? 2 : 1) + 1;\n\t}\n\n\t/** Computes the maximum net payload size that can be transmitted inside this CC */\n\tpublic getMaxPayloadLength(baseLength: number): number {\n\t\tlet ret = baseLength;\n\t\tlet cur: CommandClass | undefined = this;\n\t\twhile (cur) {\n\t\t\tret -= cur.computeEncapsulationOverhead();\n\t\t\tcur = isEncapsulatingCommandClass(cur)\n\t\t\t\t? cur.encapsulated\n\t\t\t\t: undefined;\n\t\t}\n\t\treturn ret;\n\t}\n\n\t/** Checks whether this CC is encapsulated with one that has the given CC id and (optionally) CC Command */\n\tpublic isEncapsulatedWith(\n\t\tccId: CommandClasses,\n\t\tccCommand?: number,\n\t): boolean {\n\t\tlet cc: CommandClass = this;\n\t\t// Check whether there was a S0 encapsulation\n\t\twhile (cc.encapsulatingCC) {\n\t\t\tcc = cc.encapsulatingCC;\n\t\t\tif (\n\t\t\t\tcc.ccId === ccId\n\t\t\t\t&& (ccCommand === undefined || cc.ccCommand === ccCommand)\n\t\t\t) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t\treturn false;\n\t}\n\n\t/** Traverses the encapsulation stack of this CC outwards and returns the one that has the given CC id and (optionally) CC Command if that exists. */\n\tpublic getEncapsulatingCC(\n\t\tccId: CommandClasses,\n\t\tccCommand?: number,\n\t): CommandClass | undefined {\n\t\tlet cc: CommandClass = this;\n\t\twhile (cc.encapsulatingCC) {\n\t\t\tcc = cc.encapsulatingCC;\n\t\t\tif (\n\t\t\t\tcc.ccId === ccId\n\t\t\t\t&& (ccCommand === undefined || cc.ccCommand === ccCommand)\n\t\t\t) {\n\t\t\t\treturn cc;\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Traverses the encapsulation stack of this CC inwards and returns the one that has the given CC id and (optionally) CC Command if that exists. */\n\tpublic getEncapsulatedCC(\n\t\tccId: CommandClasses,\n\t\tccCommand?: number,\n\t): CommandClass | undefined {\n\t\tconst predicate = (cc: CommandClass): boolean =>\n\t\t\tcc.ccId === ccId\n\t\t\t&& (ccCommand === undefined || cc.ccCommand === ccCommand);\n\n\t\tif (isEncapsulatingCommandClass(this)) {\n\t\t\tif (predicate(this.encapsulated)) return this.encapsulated;\n\t\t\treturn this.encapsulated.getEncapsulatedCC(ccId, ccCommand);\n\t\t} else if (isMultiEncapsulatingCommandClass(this)) {\n\t\t\tfor (const encapsulated of this.encapsulated) {\n\t\t\t\tif (predicate(encapsulated)) return encapsulated;\n\t\t\t\tconst ret = encapsulated.getEncapsulatedCC(ccId, ccCommand);\n\t\t\t\tif (ret) return ret;\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport interface InvalidCCOptions extends CommandClassOptions {\n\tccName: string;\n\treason?: string | ZWaveErrorCodes;\n}\n\nexport class InvalidCC extends CommandClass {\n\tpublic constructor(options: InvalidCCOptions) {\n\t\tsuper(options);\n\t\tthis._ccName = options.ccName;\n\t\t// Numeric reasons are used internally to communicate problems with a CC\n\t\t// without ignoring them entirely\n\t\tthis.reason = options.reason;\n\t}\n\n\tprivate _ccName: string;\n\tpublic get ccName(): string {\n\t\treturn this._ccName;\n\t}\n\tpublic readonly reason?: string | ZWaveErrorCodes;\n\n\tpublic toLogEntry(_ctx?: GetValueDB): MessageOrCCLogEntry {\n\t\treturn {\n\t\t\ttags: [this.ccName, \"INVALID\"],\n\t\t\tmessage: this.reason != undefined\n\t\t\t\t? {\n\t\t\t\t\terror: typeof this.reason === \"string\"\n\t\t\t\t\t\t? this.reason\n\t\t\t\t\t\t: getEnumMemberName(\n\t\t\t\t\t\t\tZWaveErrorCodes,\n\t\t\t\t\t\t\tthis.reason,\n\t\t\t\t\t\t),\n\t\t\t\t}\n\t\t\t\t: undefined,\n\t\t};\n\t}\n}\n\nexport type CCConstructor<T extends CommandClass> = typeof CommandClass & {\n\t// I don't like the any, but we need it to support half-implemented CCs (e.g. report classes)\n\tnew (options: any): T;\n};\n\n/**\n * @publicAPI\n * May be used to define different expected CC responses depending on the sent CC\n */\nexport type DynamicCCResponse<\n\tTSent extends CommandClass,\n\tTReceived extends CommandClass = CommandClass,\n> = (\n\tsentCC: TSent,\n) => CCConstructor<TReceived> | CCConstructor<TReceived>[] | undefined;\n\n/** @publicAPI */\nexport type CCResponseRole =\n\t| boolean // The response was either expected or unexpected\n\t| \"checkEncapsulated\"; // The response role depends on the encapsulated CC\n\n/**\n * @publicAPI\n * A predicate function to test if a received CC matches the sent CC\n */\nexport type CCResponsePredicate<\n\tTSent extends CommandClass,\n\tTReceived extends CommandClass = CommandClass,\n> = (sentCommand: TSent, receivedCommand: TReceived) => CCResponseRole;\n"],
-  "mappings": "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",
-  "names": []
+  "sourcesContent": ["import { type CCEncodingContext, type CCParsingContext } from \"@zwave-js/cc\";\nimport {\n\ttype GetDeviceConfig,\n\ttype LookupManufacturer,\n} from \"@zwave-js/config\";\nimport { type LogNode } from \"@zwave-js/core\";\nimport {\n\ttype BroadcastCC,\n\ttype CCAddress,\n\ttype CCId,\n\tCommandClasses,\n\ttype ControlsCC,\n\tEncapsulationFlags,\n\ttype EndpointId,\n\ttype FrameType,\n\ttype GetAllEndpoints,\n\ttype GetCCs,\n\ttype GetEndpoint,\n\ttype GetNode,\n\ttype GetSupportedCCVersion,\n\ttype GetValueDB,\n\ttype HostIDs,\n\ttype ListenBehavior,\n\ttype MessageOrCCLogEntry,\n\ttype MessageRecord,\n\ttype ModifyCCs,\n\ttype MulticastCC,\n\ttype MulticastDestination,\n\tNODE_ID_BROADCAST,\n\tNODE_ID_BROADCAST_LR,\n\ttype NodeId,\n\ttype QueryNodeStatus,\n\ttype QuerySecurityClasses,\n\ttype SetSecurityClass,\n\ttype SinglecastCC,\n\ttype SupportsCC,\n\ttype ValueDB,\n\ttype ValueID,\n\ttype ValueMetadata,\n\tZWaveError,\n\tZWaveErrorCodes,\n\tgetCCName,\n\tisZWaveError,\n\tparseCCId,\n\tvalueIdToString,\n} from \"@zwave-js/core/safe\";\nimport {\n\tBytes,\n\ttype JSONObject,\n\tbuffer2hex,\n\tgetEnumMemberName,\n\tnum2hex,\n\tstaticExtends,\n} from \"@zwave-js/shared/safe\";\nimport { isArray } from \"alcalzone-shared/typeguards\";\nimport type { CCAPIHost, CCAPINode, ValueIDProperties } from \"./API.js\";\nimport {\n\tgetCCCommand,\n\tgetCCCommandConstructor,\n\tgetCCConstructor,\n\tgetCCResponsePredicate,\n\tgetCCValueProperties,\n\tgetCCValues,\n\tgetCommandClass,\n\tgetExpectedCCResponse,\n\tgetImplementedVersion,\n} from \"./CommandClassDecorators.js\";\nimport {\n\ttype EncapsulatingCommandClass,\n\tisEncapsulatingCommandClass,\n\tisMultiEncapsulatingCommandClass,\n} from \"./EncapsulatingCommandClass.js\";\nimport {\n\ttype CCValue,\n\ttype DynamicCCValue,\n\ttype StaticCCValue,\n\tdefaultCCValueOptions,\n} from \"./Values.js\";\nimport { type GetInterviewOptions } from \"./traits.js\";\n\nexport interface CommandClassOptions extends CCAddress {\n\tccId?: number; // Used to overwrite the declared CC ID\n\tccCommand?: number; // undefined = NoOp\n\tpayload?: Uint8Array;\n}\n\n// Defines the necessary traits an endpoint passed to a CC instance must have\nexport type CCEndpoint =\n\t& EndpointId\n\t& SupportsCC\n\t& ControlsCC\n\t& GetCCs\n\t& ModifyCCs;\n\n// Defines the necessary traits a node passed to a CC instance must have\nexport type CCNode =\n\t& NodeId\n\t& SupportsCC\n\t& ControlsCC\n\t& GetCCs\n\t& GetEndpoint<CCEndpoint>\n\t& GetAllEndpoints<CCEndpoint>\n\t& QuerySecurityClasses\n\t& SetSecurityClass\n\t& ListenBehavior\n\t& QueryNodeStatus;\n\nexport type InterviewContext =\n\t& CCAPIHost<\n\t\t& CCAPINode\n\t\t& GetCCs\n\t\t& SupportsCC\n\t\t& ControlsCC\n\t\t& QuerySecurityClasses\n\t\t& SetSecurityClass\n\t\t& GetEndpoint<EndpointId & GetCCs & SupportsCC & ControlsCC & ModifyCCs>\n\t\t& GetAllEndpoints<EndpointId & SupportsCC & ControlsCC>\n\t>\n\t& GetInterviewOptions\n\t& LookupManufacturer;\n\nexport type RefreshValuesContext = CCAPIHost<\n\tCCAPINode & GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n>;\n\nexport type PersistValuesContext =\n\t& HostIDs\n\t& GetValueDB\n\t& GetSupportedCCVersion\n\t& GetDeviceConfig\n\t& GetNode<\n\t\tNodeId & GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n\t>\n\t& LogNode;\n\nexport function getEffectiveCCVersion(\n\tctx: GetSupportedCCVersion,\n\tcc: CCId,\n\tdefaultVersion?: number,\n): number {\n\t// For multicast and broadcast CCs, just use the highest implemented version to serialize\n\t// Older nodes will ignore the additional fields\n\tif (\n\t\ttypeof cc.nodeId !== \"number\"\n\t\t|| cc.nodeId === NODE_ID_BROADCAST\n\t\t|| cc.nodeId === NODE_ID_BROADCAST_LR\n\t) {\n\t\treturn getImplementedVersion(cc.ccId);\n\t}\n\t// For singlecast CCs, set the CC version as high as possible\n\treturn ctx.getSupportedCCVersion(cc.ccId, cc.nodeId, cc.endpointIndex)\n\t\t|| (defaultVersion ?? getImplementedVersion(cc.ccId));\n}\n\nexport class CCRaw {\n\tpublic constructor(\n\t\tpublic ccId: CommandClasses,\n\t\tpublic ccCommand: number | undefined,\n\t\tpublic payload: Bytes,\n\t) {}\n\n\tpublic static parse(data: Uint8Array): CCRaw {\n\t\tconst { ccId, bytesRead: ccIdLength } = parseCCId(data);\n\t\t// There are so few exceptions that we can handle them here manually\n\t\tif (ccId === CommandClasses[\"No Operation\"]) {\n\t\t\treturn new CCRaw(ccId, undefined, new Bytes());\n\t\t}\n\t\tlet ccCommand: number | undefined = data[ccIdLength];\n\t\tlet payload = Bytes.view(data.subarray(ccIdLength + 1));\n\t\tif (ccId === CommandClasses[\"Transport Service\"]) {\n\t\t\t// Transport Service only uses the higher 5 bits for the command\n\t\t\t// and re-uses the lower 3 bits of the ccCommand as payload\n\t\t\tpayload = Bytes.concat([\n\t\t\t\tBytes.from([ccCommand & 0b111]),\n\t\t\t\tpayload,\n\t\t\t]);\n\t\t\tccCommand = ccCommand & 0b11111_000;\n\t\t} else if (ccId === CommandClasses[\"Manufacturer Proprietary\"]) {\n\t\t\t// ManufacturerProprietaryCC has no CC command, so the first\n\t\t\t// payload byte is stored in ccCommand.\n\t\t\tpayload = Bytes.concat([\n\t\t\t\tBytes.from([ccCommand]),\n\t\t\t\tpayload,\n\t\t\t]);\n\t\t\tccCommand = undefined;\n\t\t}\n\n\t\treturn new CCRaw(ccId, ccCommand, payload);\n\t}\n\n\tpublic withPayload(payload: Bytes): CCRaw {\n\t\treturn new CCRaw(this.ccId, this.ccCommand, payload);\n\t}\n}\n\n// @publicAPI\nexport class CommandClass implements CCId {\n\t// empty constructor to parse messages\n\tpublic constructor(options: CommandClassOptions) {\n\t\tconst {\n\t\t\tnodeId,\n\t\t\tendpointIndex = 0,\n\t\t\tccId = getCommandClass(this),\n\t\t\tccCommand = getCCCommand(this),\n\t\t\tpayload = new Uint8Array(),\n\t\t} = options;\n\n\t\tthis.nodeId = nodeId;\n\t\tthis.endpointIndex = endpointIndex;\n\t\tthis.ccId = ccId;\n\t\tthis.ccCommand = ccCommand;\n\t\tthis.payload = Bytes.view(payload);\n\t}\n\n\tpublic static async parse(\n\t\tdata: Uint8Array,\n\t\tctx: CCParsingContext,\n\t): Promise<CommandClass> {\n\t\tconst raw = CCRaw.parse(data);\n\n\t\t// Find the correct subclass constructor to invoke\n\t\tconst CCConstructor = getCCConstructor(raw.ccId);\n\t\tif (!CCConstructor) {\n\t\t\t// None -> fall back to the default constructor\n\t\t\treturn await CommandClass.from(raw, ctx);\n\t\t}\n\n\t\tlet CommandConstructor: CCConstructor<CommandClass> | undefined;\n\t\tif (raw.ccCommand != undefined) {\n\t\t\tCommandConstructor = getCCCommandConstructor(\n\t\t\t\traw.ccId,\n\t\t\t\traw.ccCommand,\n\t\t\t);\n\t\t}\n\t\t// Not every CC has a constructor for its commands. In that case,\n\t\t// call the CC constructor directly\n\t\ttry {\n\t\t\treturn await (CommandConstructor ?? CCConstructor).from(raw, ctx);\n\t\t} catch (e) {\n\t\t\t// Indicate invalid payloads with a special CC type\n\t\t\tif (\n\t\t\t\tisZWaveError(e)\n\t\t\t\t&& e.code === ZWaveErrorCodes.PacketFormat_InvalidPayload\n\t\t\t) {\n\t\t\t\tconst ccName = CommandConstructor?.name\n\t\t\t\t\t?? `${getCCName(raw.ccId)} CC`;\n\n\t\t\t\t// Preserve why the command was invalid\n\t\t\t\tlet reason: string | ZWaveErrorCodes | undefined;\n\t\t\t\tif (\n\t\t\t\t\ttypeof e.context === \"string\"\n\t\t\t\t\t|| (typeof e.context === \"number\"\n\t\t\t\t\t\t&& ZWaveErrorCodes[e.context] != undefined)\n\t\t\t\t) {\n\t\t\t\t\treason = e.context;\n\t\t\t\t}\n\n\t\t\t\tconst ret = new InvalidCC({\n\t\t\t\t\tnodeId: ctx.sourceNodeId,\n\t\t\t\t\tccId: raw.ccId,\n\t\t\t\t\tccCommand: raw.ccCommand,\n\t\t\t\t\tccName,\n\t\t\t\t\treason,\n\t\t\t\t});\n\n\t\t\t\treturn ret;\n\t\t\t}\n\t\t\tthrow e;\n\t\t}\n\t}\n\n\tpublic static from(\n\t\traw: CCRaw,\n\t\tctx: CCParsingContext,\n\t): CommandClass | Promise<CommandClass> {\n\t\treturn new this({\n\t\t\tnodeId: ctx.sourceNodeId,\n\t\t\tccId: raw.ccId,\n\t\t\tccCommand: raw.ccCommand,\n\t\t\tpayload: raw.payload,\n\t\t});\n\t}\n\n\t/** This CC's identifier */\n\tpublic ccId!: CommandClasses;\n\tpublic ccCommand?: number;\n\tpublic get ccName(): string {\n\t\treturn getCCName(this.ccId);\n\t}\n\n\t/** The ID of the target node(s) */\n\tpublic nodeId!: number | MulticastDestination;\n\n\tpublic payload: Bytes;\n\n\t/** Which endpoint of the node this CC belongs to. 0 for the root device. */\n\tpublic endpointIndex: number;\n\n\t/**\n\t * Which encapsulation CCs this CC is/was/should be encapsulated with.\n\t *\n\t * Don't use this directly, this is used internally.\n\t */\n\tpublic encapsulationFlags: EncapsulationFlags = EncapsulationFlags.None;\n\n\t/** Activates or deactivates the given encapsulation flag(s) */\n\tpublic toggleEncapsulationFlag(\n\t\tflag: EncapsulationFlags,\n\t\tactive: boolean,\n\t): void {\n\t\tif (active) {\n\t\t\tthis.encapsulationFlags |= flag;\n\t\t} else {\n\t\t\tthis.encapsulationFlags &= ~flag;\n\t\t}\n\t}\n\n\t/** Contains a reference to the encapsulating CC if this CC is encapsulated */\n\tpublic encapsulatingCC?: EncapsulatingCommandClass;\n\n\t/** The type of Z-Wave frame this CC was sent with */\n\tpublic readonly frameType?: FrameType;\n\n\t/** Returns true if this CC is an extended CC (0xF100..0xFFFF) */\n\tpublic isExtended(): boolean {\n\t\treturn this.ccId >= 0xf100;\n\t}\n\n\t/** Whether the interview for this CC was previously completed */\n\tpublic isInterviewComplete(host: GetValueDB): boolean {\n\t\treturn !!this.getValueDB(host).getValue<boolean>({\n\t\t\tcommandClass: this.ccId,\n\t\t\tendpoint: this.endpointIndex,\n\t\t\tproperty: \"interviewComplete\",\n\t\t});\n\t}\n\n\t/** Marks the interview for this CC as complete or not */\n\tpublic setInterviewComplete(\n\t\thost: GetValueDB,\n\t\tcomplete: boolean,\n\t): void {\n\t\tthis.getValueDB(host).setValue(\n\t\t\t{\n\t\t\t\tcommandClass: this.ccId,\n\t\t\t\tendpoint: this.endpointIndex,\n\t\t\t\tproperty: \"interviewComplete\",\n\t\t\t},\n\t\t\tcomplete,\n\t\t);\n\t}\n\n\t/**\n\t * Serializes this CommandClass to be embedded in a message payload or another CC\n\t */\n\t// eslint-disable-next-line @typescript-eslint/no-unused-vars, @typescript-eslint/require-await\n\tpublic async serialize(ctx: CCEncodingContext): Promise<Bytes> {\n\t\t// NoOp CCs have no command and no payload\n\t\tif (this.ccId === CommandClasses[\"No Operation\"]) {\n\t\t\treturn Bytes.from([this.ccId]);\n\t\t} else if (this.ccCommand == undefined) {\n\t\t\tthrow new ZWaveError(\n\t\t\t\t\"Cannot serialize a Command Class without a command\",\n\t\t\t\tZWaveErrorCodes.CC_Invalid,\n\t\t\t);\n\t\t}\n\n\t\tconst payloadLength = this.payload.length;\n\t\tconst ccIdLength = this.isExtended() ? 2 : 1;\n\t\tconst data = new Bytes(ccIdLength + 1 + payloadLength);\n\t\tdata.writeUIntBE(this.ccId, 0, ccIdLength);\n\t\tdata[ccIdLength] = this.ccCommand;\n\t\tif (payloadLength > 0 /* implies payload != undefined */) {\n\t\t\tdata.set(this.payload, 1 + ccIdLength);\n\t\t}\n\t\treturn data;\n\t}\n\n\tpublic prepareRetransmission(): void {\n\t\t// Do nothing by default\n\t}\n\n\t/**\n\t * Create an instance of the given CC without checking whether it is supported.\n\t * If the CC is implemented, this returns an instance of the given CC which is linked to the given endpoint.\n\t *\n\t * **INTERNAL:** Applications should not use this directly.\n\t */\n\tpublic static createInstanceUnchecked<T extends CommandClass>(\n\t\tendpoint: EndpointId,\n\t\tcc: CommandClasses | CCConstructor<T>,\n\t): T | undefined {\n\t\tconst Constructor = typeof cc === \"number\" ? getCCConstructor(cc) : cc;\n\t\tif (Constructor) {\n\t\t\treturn new Constructor({\n\t\t\t\tnodeId: endpoint.nodeId,\n\t\t\t\tendpointIndex: endpoint.index,\n\t\t\t}) as T;\n\t\t}\n\t}\n\n\t/** Generates a representation of this CC for the log */\n\tpublic toLogEntry(_ctx?: GetValueDB): MessageOrCCLogEntry {\n\t\tlet tag = this.constructor.name;\n\t\tconst message: MessageRecord = {};\n\t\tif (this.constructor === CommandClass) {\n\t\t\ttag = `${\n\t\t\t\tgetEnumMemberName(\n\t\t\t\t\tCommandClasses,\n\t\t\t\t\tthis.ccId,\n\t\t\t\t)\n\t\t\t} CC (not implemented)`;\n\t\t\tif (this.ccCommand != undefined) {\n\t\t\t\tmessage.command = num2hex(this.ccCommand);\n\t\t\t}\n\t\t}\n\t\tif (this.payload.length > 0) {\n\t\t\tmessage.payload = buffer2hex(this.payload);\n\t\t}\n\t\treturn {\n\t\t\ttags: [tag],\n\t\t\tmessage,\n\t\t};\n\t}\n\n\t/** Generates the JSON representation of this CC */\n\tpublic toJSON(): JSONObject {\n\t\treturn this.toJSONInternal();\n\t}\n\n\tprivate toJSONInternal(): JSONObject {\n\t\tconst ret: JSONObject = {\n\t\t\tnodeId: this.nodeId,\n\t\t\tccId: CommandClasses[this.ccId] || num2hex(this.ccId),\n\t\t};\n\t\tif (this.ccCommand != undefined) {\n\t\t\tret.ccCommand = num2hex(this.ccCommand);\n\t\t}\n\t\tif (this.payload.length > 0) {\n\t\t\tret.payload = buffer2hex(this.payload);\n\t\t}\n\t\treturn ret;\n\t}\n\n\tprotected throwMissingCriticalInterviewResponse(): never {\n\t\tthrow new ZWaveError(\n\t\t\t`The node did not respond to a critical interview query in time.`,\n\t\t\tZWaveErrorCodes.Controller_NodeTimeout,\n\t\t);\n\t}\n\n\t/**\n\t * Performs the interview procedure for this CC according to SDS14223\n\t */\n\tpublic async interview(_ctx: InterviewContext): Promise<void> {\n\t\t// This needs to be overwritten per command class. In the default implementation, don't do anything\n\t}\n\n\t/**\n\t * Refreshes all dynamic values of this CC\n\t */\n\tpublic async refreshValues(_ctx: RefreshValuesContext): Promise<void> {\n\t\t// This needs to be overwritten per command class. In the default implementation, don't do anything\n\t}\n\n\t/**\n\t * Checks if the CC values need to be manually refreshed.\n\t * This should be called regularly and when sleeping nodes wake up\n\t */\n\tpublic shouldRefreshValues(\n\t\tthis: SinglecastCC<this>,\n\t\t_ctx:\n\t\t\t& GetValueDB\n\t\t\t& GetSupportedCCVersion\n\t\t\t& GetDeviceConfig\n\t\t\t& GetNode<\n\t\t\t\tNodeId & GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n\t\t\t>,\n\t): boolean {\n\t\t// This needs to be overwritten per command class.\n\t\t// In the default implementation, don't require a refresh\n\t\treturn false;\n\t}\n\n\t/** Determines which CC interviews must be performed before this CC can be interviewed */\n\tpublic determineRequiredCCInterviews(): readonly CommandClasses[] {\n\t\t// By default, all CCs require the VersionCC interview\n\n\t\t// There are two exceptions to this rule:\n\t\t// * ManufacturerSpecific must be interviewed first\n\t\t// * VersionCC itself must be done after that\n\t\t// These exceptions are defined in the overrides of this method of each corresponding CC\n\n\t\treturn [CommandClasses.Version];\n\t}\n\n\t/**\n\t * Whether the endpoint interview may be skipped by a CC. Can be overwritten by a subclass.\n\t */\n\tpublic skipEndpointInterview(): boolean {\n\t\t// By default no interview may be skipped\n\t\treturn false;\n\t}\n\n\t/**\n\t * Maps a BasicCC value to a more specific CC implementation. Returns true if the value was mapped, false otherwise.\n\t * @param _value The value of the received BasicCC\n\t */\n\tpublic setMappedBasicValue(\n\t\t_ctx: GetValueDB,\n\t\t_value: number,\n\t): boolean {\n\t\t// By default, don't map\n\t\treturn false;\n\t}\n\n\tpublic isSinglecast(): this is SinglecastCC<this> {\n\t\treturn (\n\t\t\t// received\n\t\t\tthis.frameType === \"singlecast\"\n\t\t\t// transmitted\n\t\t\t|| (this.frameType == undefined\n\t\t\t\t&& typeof this.nodeId === \"number\"\n\t\t\t\t&& this.nodeId !== NODE_ID_BROADCAST\n\t\t\t\t&& this.nodeId !== NODE_ID_BROADCAST_LR)\n\t\t);\n\t}\n\n\tpublic isMulticast(): this is MulticastCC<this> {\n\t\treturn (\n\t\t\t// received\n\t\t\tthis.frameType === \"multicast\"\n\t\t\t// transmitted\n\t\t\t|| (this.frameType == undefined && isArray(this.nodeId))\n\t\t);\n\t}\n\n\tpublic isBroadcast(): this is BroadcastCC<this> {\n\t\treturn (\n\t\t\t// received\n\t\t\tthis.frameType === \"broadcast\"\n\t\t\t// transmitted\n\t\t\t|| (this.frameType == undefined\n\t\t\t\t&& (this.nodeId === NODE_ID_BROADCAST\n\t\t\t\t\t|| this.nodeId === NODE_ID_BROADCAST_LR))\n\t\t);\n\t}\n\n\t/**\n\t * Returns the node this CC is linked to. Throws if the controller is not yet ready.\n\t */\n\tpublic getNode<T extends NodeId>(\n\t\tctx: GetNode<T>,\n\t): T | undefined {\n\t\tif (this.isSinglecast()) {\n\t\t\treturn ctx.getNode(this.nodeId);\n\t\t}\n\t}\n\n\t/**\n\t * @internal\n\t * Returns the node this CC is linked to (or undefined if the node doesn't exist)\n\t */\n\tpublic tryGetNode<T extends NodeId>(\n\t\tctx: GetNode<T>,\n\t): T | undefined {\n\t\ttry {\n\t\t\treturn this.getNode(ctx);\n\t\t} catch (e) {\n\t\t\t// This was expected\n\t\t\tif (isZWaveError(e) && e.code === ZWaveErrorCodes.Driver_NotReady) {\n\t\t\t\treturn undefined;\n\t\t\t}\n\t\t\t// Something else happened\n\t\t\tthrow e;\n\t\t}\n\t}\n\n\tpublic getEndpoint<T extends EndpointId>(\n\t\tctx: GetNode<NodeId & GetEndpoint<T>>,\n\t): T | undefined {\n\t\treturn this.getNode(ctx)?.getEndpoint(this.endpointIndex);\n\t}\n\n\t/** Returns the value DB for this CC's node */\n\tprotected getValueDB(ctx: GetValueDB): ValueDB {\n\t\tif (this.isSinglecast()) {\n\t\t\ttry {\n\t\t\t\treturn ctx.getValueDB(this.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\t/**\n\t * Ensures that the metadata for the given CC value exists in the Value DB or creates it if it does not.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t * @param meta Will be used in place of the predefined metadata when given\n\t */\n\tprotected ensureMetadata(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t\tmeta?: ValueMetadata,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tif (!valueDB.hasMetadata(valueId)) {\n\t\t\tvalueDB.setMetadata(valueId, meta ?? ccValue.meta);\n\t\t}\n\t}\n\n\t/**\n\t * Removes the metadata for the given CC value from the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected removeMetadata(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tvalueDB.setMetadata(valueId, undefined);\n\t}\n\n\t/**\n\t * Writes the metadata for the given CC value into the Value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t * @param meta Will be used in place of the predefined metadata when given\n\t */\n\tprotected setMetadata(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t\tmeta?: ValueMetadata,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tvalueDB.setMetadata(valueId, meta ?? ccValue.meta);\n\t}\n\n\t/**\n\t * Reads the metadata for the given CC value from the Value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected getMetadata<T extends ValueMetadata>(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): T | undefined {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\treturn valueDB.getMetadata(valueId) as any;\n\t}\n\n\t/**\n\t * Stores the given value under the value ID for the given CC value in the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected setValue(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t\tvalue: unknown,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tvalueDB.setValue(valueId, value);\n\t}\n\n\t/**\n\t * Removes the value for the given CC value from the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected removeValue(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): void {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\tvalueDB.removeValue(valueId);\n\t}\n\n\t/**\n\t * Reads the value stored for the value ID of the given CC value from the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected getValue<T>(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): T | undefined {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\treturn valueDB.getValue(valueId);\n\t}\n\n\t/**\n\t * Reads when the value stored for the value ID of the given CC value was last updated in the value DB.\n\t * The endpoint index of the current CC instance is automatically taken into account.\n\t */\n\tprotected getValueTimestamp(\n\t\tctx: GetValueDB,\n\t\tccValue: CCValue,\n\t): number | undefined {\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\tconst valueId = ccValue.endpoint(this.endpointIndex);\n\t\treturn valueDB.getTimestamp(valueId);\n\t}\n\n\t/** Returns the CC value definition for the current CC which matches the given value ID */\n\tprotected getCCValue(\n\t\tvalueId: ValueID,\n\t): StaticCCValue | DynamicCCValue | undefined {\n\t\tconst ccValues = getCCValues(this);\n\t\tif (!ccValues) return;\n\n\t\tfor (const value of Object.values(ccValues)) {\n\t\t\tif (value?.is(valueId)) {\n\t\t\t\treturn value;\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate getAllCCValues(): (StaticCCValue | DynamicCCValue)[] {\n\t\treturn Object.values(getCCValues(this) ?? {}) as (\n\t\t\t| StaticCCValue\n\t\t\t| DynamicCCValue\n\t\t)[];\n\t}\n\n\tprivate getCCValueForValueId(\n\t\tproperties: ValueIDProperties,\n\t): StaticCCValue | DynamicCCValue | undefined {\n\t\treturn this.getAllCCValues().find((value) =>\n\t\t\tvalue.is({\n\t\t\t\tcommandClass: this.ccId,\n\t\t\t\t...properties,\n\t\t\t})\n\t\t);\n\t}\n\n\tprivate shouldAutoCreateValue(\n\t\tctx: GetValueDB & GetDeviceConfig,\n\t\tvalue: StaticCCValue,\n\t): boolean {\n\t\treturn (\n\t\t\tvalue.options.autoCreate === true\n\t\t\t|| (typeof value.options.autoCreate === \"function\"\n\t\t\t\t&& value.options.autoCreate(\n\t\t\t\t\tctx,\n\t\t\t\t\t{\n\t\t\t\t\t\tvirtual: false,\n\t\t\t\t\t\tnodeId: this.nodeId as number,\n\t\t\t\t\t\tindex: this.endpointIndex,\n\t\t\t\t\t},\n\t\t\t\t))\n\t\t);\n\t}\n\n\t/** Returns a list of all value names that are defined for this CommandClass */\n\tpublic getDefinedValueIDs(\n\t\tctx:\n\t\t\t& GetValueDB\n\t\t\t& GetSupportedCCVersion\n\t\t\t& GetDeviceConfig\n\t\t\t& GetNode<\n\t\t\t\tNodeId & GetEndpoint<EndpointId & SupportsCC & ControlsCC>\n\t\t\t>,\n\t\tincludeInternal: boolean = false,\n\t): ValueID[] {\n\t\t// In order to compare value ids, we need them to be strings\n\t\tconst ret = new Map<string, ValueID>();\n\n\t\tconst addValueId = (\n\t\t\tproperty: string | number,\n\t\t\tpropertyKey?: string | number,\n\t\t): void => {\n\t\t\tconst valueId: ValueID = {\n\t\t\t\tcommandClass: this.ccId,\n\t\t\t\tendpoint: this.endpointIndex,\n\t\t\t\tproperty,\n\t\t\t\tpropertyKey,\n\t\t\t};\n\t\t\tconst dbKey = valueIdToString(valueId);\n\t\t\tif (!ret.has(dbKey)) ret.set(dbKey, valueId);\n\t\t};\n\n\t\t// Return all value IDs for this CC...\n\t\tconst valueDB = this.getValueDB(ctx);\n\t\t// ...which either have metadata or a value\n\t\tconst existingValueIds: ValueID[] = [\n\t\t\t...valueDB.getValues(this.ccId),\n\t\t\t...valueDB.getAllMetadata(this.ccId),\n\t\t];\n\n\t\t// To determine which value IDs to expose, we need to know the CC version\n\t\t// that we're doing this for\n\t\tconst supportedVersion = typeof this.nodeId === \"number\"\n\t\t\t\t&& this.nodeId !== NODE_ID_BROADCAST\n\t\t\t\t&& this.nodeId !== NODE_ID_BROADCAST_LR\n\t\t\t// On singlecast CCs, use the version the node reported support for,\n\t\t\t? ctx.getSupportedCCVersion(\n\t\t\t\tthis.ccId,\n\t\t\t\tthis.nodeId,\n\t\t\t\tthis.endpointIndex,\n\t\t\t)\n\t\t\t// on multicast/broadcast, use the highest version we implement\n\t\t\t: getImplementedVersion(this.ccId);\n\n\t\t// ...or which are statically defined using @ccValues(...)\n\t\tfor (const value of Object.values(getCCValues(this) ?? {})) {\n\t\t\t// Skip dynamic CC values - they need a specific subclass instance to be evaluated\n\t\t\tif (!value || typeof value === \"function\") continue;\n\n\t\t\t// Skip those values that are only supported in higher versions of the CC\n\t\t\tif (\n\t\t\t\tvalue.options.minVersion != undefined\n\t\t\t\t&& value.options.minVersion > supportedVersion\n\t\t\t) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Skip internal values\n\t\t\tif (value.options.internal && !includeInternal) continue;\n\n\t\t\t// And determine if this value should be automatically \"created\"\n\t\t\tif (!this.shouldAutoCreateValue(ctx, value)) continue;\n\n\t\t\texistingValueIds.push(value.endpoint(this.endpointIndex));\n\t\t}\n\n\t\t// TODO: this is a bit awkward for the statically defined ones\n\t\tconst ccValues = this.getAllCCValues();\n\t\tfor (const valueId of existingValueIds) {\n\t\t\t// ...belonging to the current endpoint\n\t\t\tif ((valueId.endpoint ?? 0) !== this.endpointIndex) continue;\n\n\t\t\t// Hard-coded: interviewComplete is always internal\n\t\t\tif (valueId.property === \"interviewComplete\") continue;\n\n\t\t\t// ... which don't have a CC value definition\n\t\t\t// ... or one that does not mark the value ID as internal\n\t\t\tconst ccValue = ccValues.find((value) => value.is(valueId));\n\t\t\tif (!ccValue || !ccValue.options.internal || includeInternal) {\n\t\t\t\taddValueId(valueId.property, valueId.propertyKey);\n\t\t\t}\n\t\t}\n\n\t\treturn [...ret.values()];\n\t}\n\n\t/** Determines if the given value is an internal value */\n\tpublic isInternalValue(properties: ValueIDProperties): boolean {\n\t\t// Hard-coded: interviewComplete is always internal\n\t\tif (properties.property === \"interviewComplete\") return true;\n\n\t\tconst ccValue = this.getCCValueForValueId(properties);\n\t\treturn ccValue?.options.internal ?? defaultCCValueOptions.internal;\n\t}\n\n\t/** Determines if the given value is an secret value */\n\tpublic isSecretValue(properties: ValueIDProperties): boolean {\n\t\tconst ccValue = this.getCCValueForValueId(properties);\n\t\treturn ccValue?.options.secret ?? defaultCCValueOptions.secret;\n\t}\n\n\t/** Determines if the given value should be persisted or represents an event */\n\tpublic isStatefulValue(properties: ValueIDProperties): boolean {\n\t\tconst ccValue = this.getCCValueForValueId(properties);\n\t\treturn ccValue?.options.stateful ?? defaultCCValueOptions.stateful;\n\t}\n\n\t/**\n\t * Persists all values for this CC instance into the value DB which are annotated with @ccValue.\n\t * Returns `true` if the process succeeded, `false` if the value DB cannot be accessed.\n\t */\n\tpublic persistValues(ctx: PersistValuesContext): boolean {\n\t\tlet valueDB: ValueDB;\n\t\ttry {\n\t\t\tvalueDB = this.getValueDB(ctx);\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\n\t\t// To determine which value IDs to expose, we need to know the CC version\n\t\t// that we're doing this for\n\t\tconst supportedVersion = ctx.getSupportedCCVersion(\n\t\t\tthis.ccId,\n\t\t\t// Values are only persisted for singlecast, so we know nodeId is a number\n\t\t\tthis.nodeId as number,\n\t\t\tthis.endpointIndex,\n\t\t\t// If the version isn't known yet, limit the created values to V1\n\t\t) || 1;\n\n\t\t// Get all properties of this CC which are annotated with a @ccValue decorator and store them.\n\t\tfor (const [prop, _value] of getCCValueProperties(this)) {\n\t\t\t// Evaluate dynamic CC values first\n\t\t\tconst value = typeof _value === \"function\" ? _value(this) : _value;\n\n\t\t\t// Skip those values that are only supported in higher versions of the CC\n\t\t\tif (\n\t\t\t\tvalue.options.minVersion != undefined\n\t\t\t\t&& value.options.minVersion > supportedVersion\n\t\t\t) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\tconst valueId: ValueID = value.endpoint(this.endpointIndex);\n\t\t\tconst sourceValue = this[prop as keyof this];\n\n\t\t\t// Metadata gets created for non-internal values...\n\t\t\tconst createMetadata = !value.options.internal\n\t\t\t\t// ... but only if the value is included in the report we are persisting\n\t\t\t\t&& (sourceValue != undefined\n\t\t\t\t\t// ... or if we know which CC version the node supports\n\t\t\t\t\t// and the value may be automatically created\n\t\t\t\t\t|| (supportedVersion >= value.options.minVersion\n\t\t\t\t\t\t&& this.shouldAutoCreateValue(ctx, value)));\n\n\t\t\tif (createMetadata && !valueDB.hasMetadata(valueId)) {\n\t\t\t\tvalueDB.setMetadata(valueId, value.meta);\n\t\t\t}\n\n\t\t\t// The value only gets written if it is not undefined. null is a valid value!\n\t\t\tif (sourceValue === undefined) continue;\n\n\t\t\tvalueDB.setValue(valueId, sourceValue, {\n\t\t\t\tstateful: value.options.stateful,\n\t\t\t});\n\t\t}\n\n\t\treturn true;\n\t}\n\n\t/**\n\t * When a CC supports to be split into multiple partial CCs, this can be used to identify the\n\t * session the partial CCs belong to.\n\t * If a CC expects `mergePartialCCs` to be always called, you should return an empty object here.\n\t */\n\tpublic getPartialCCSessionId(): Record<string, any> | undefined {\n\t\treturn undefined; // Only select CCs support to be split\n\t}\n\n\t/**\n\t * When a CC supports to be split into multiple partial CCs, this indicates that the last report hasn't been received yet.\n\t * @param _session The previously received set of messages received in this partial CC session\n\t */\n\tpublic expectMoreMessages(_session: CommandClass[]): boolean {\n\t\treturn false; // By default, all CCs are monolithic\n\t}\n\n\t/** Include previously received partial responses into a final CC */\n\tpublic async mergePartialCCs(\n\t\t_partials: CommandClass[],\n\t\t_ctx: CCParsingContext,\n\t): Promise<void> {\n\t\t// This is highly CC dependent\n\t\t// Overwrite this in derived classes, by default do nothing\n\t}\n\n\t/** Tests whether this CC expects at least one command in return */\n\tpublic expectsCCResponse(): boolean {\n\t\tlet expected:\n\t\t\t| DynamicCCResponse<this>\n\t\t\t| ReturnType<DynamicCCResponse<this>> = getExpectedCCResponse(this);\n\n\t\t// Evaluate dynamic CC responses\n\t\tif (\n\t\t\ttypeof expected === \"function\"\n\t\t\t&& !staticExtends(expected, CommandClass)\n\t\t) {\n\t\t\texpected = expected(this);\n\t\t}\n\t\tif (expected === undefined) return false;\n\t\tif (isArray(expected)) {\n\t\t\treturn expected.every((cc) => staticExtends(cc, CommandClass));\n\t\t} else {\n\t\t\treturn staticExtends(expected, CommandClass);\n\t\t}\n\t}\n\n\tpublic isExpectedCCResponse(received: CommandClass): boolean {\n\t\tif (received.nodeId !== this.nodeId) return false;\n\n\t\tlet expected:\n\t\t\t| DynamicCCResponse<this>\n\t\t\t| ReturnType<DynamicCCResponse<this>> = getExpectedCCResponse(this);\n\n\t\t// Evaluate dynamic CC responses\n\t\tif (\n\t\t\ttypeof expected === \"function\"\n\t\t\t&& !staticExtends(expected, CommandClass)\n\t\t) {\n\t\t\texpected = expected(this);\n\t\t}\n\n\t\tif (expected == undefined) {\n\t\t\t// Fallback, should not happen if the expected response is defined correctly\n\t\t\treturn false;\n\t\t} else if (\n\t\t\tisArray(expected)\n\t\t\t&& expected.every((cc) => staticExtends(cc, CommandClass))\n\t\t) {\n\t\t\t// The CC always expects a response from the given list, check if the received\n\t\t\t// message is in that list\n\t\t\tif (expected.every((base) => !(received instanceof base))) {\n\t\t\t\treturn false;\n\t\t\t}\n\t\t} else if (staticExtends(expected, CommandClass)) {\n\t\t\t// The CC always expects the same single response, check if this is the one\n\t\t\tif (!(received instanceof expected)) return false;\n\t\t}\n\n\t\t// If the CC wants to test the response, let it\n\t\tconst predicate = getCCResponsePredicate(this);\n\t\tconst ret = predicate?.(this, received) ?? true;\n\n\t\tif (ret === \"checkEncapsulated\") {\n\t\t\tif (\n\t\t\t\tisEncapsulatingCommandClass(this)\n\t\t\t\t&& isEncapsulatingCommandClass(received)\n\t\t\t) {\n\t\t\t\treturn this.encapsulated.isExpectedCCResponse(\n\t\t\t\t\treceived.encapsulated,\n\t\t\t\t);\n\t\t\t} else {\n\t\t\t\t// Fallback, should not happen if the expected response is defined correctly\n\t\t\t\treturn false;\n\t\t\t}\n\t\t}\n\n\t\treturn ret;\n\t}\n\n\t/**\n\t * Translates a property identifier into a speaking name for use in an external API\n\t * @param property The property identifier that should be translated\n\t * @param _propertyKey The (optional) property key the translated name may depend on\n\t */\n\tpublic translateProperty(\n\t\t_ctx: GetValueDB,\n\t\tproperty: string | number,\n\t\t_propertyKey?: string | number,\n\t): string {\n\t\t// Overwrite this in derived classes, by default just return the property key\n\t\treturn property.toString();\n\t}\n\n\t/**\n\t * Translates a property key into a speaking name for use in an external API\n\t * @param _property The property the key in question belongs to\n\t * @param propertyKey The property key for which the speaking name should be retrieved\n\t */\n\tpublic translatePropertyKey(\n\t\t_ctx: GetValueDB,\n\t\t_property: string | number,\n\t\tpropertyKey: string | number,\n\t): string | undefined {\n\t\t// Overwrite this in derived classes, by default just return the property key\n\t\treturn propertyKey.toString();\n\t}\n\n\t/** Returns the number of bytes that are added to the payload by this CC */\n\tprotected computeEncapsulationOverhead(): number {\n\t\t// Default is ccId (+ ccCommand):\n\t\treturn (this.isExtended() ? 2 : 1) + 1;\n\t}\n\n\t/** Computes the maximum net payload size that can be transmitted inside this CC */\n\tpublic getMaxPayloadLength(baseLength: number): number {\n\t\tlet ret = baseLength;\n\t\tlet cur: CommandClass | undefined = this;\n\t\twhile (cur) {\n\t\t\tret -= cur.computeEncapsulationOverhead();\n\t\t\tcur = isEncapsulatingCommandClass(cur)\n\t\t\t\t? cur.encapsulated\n\t\t\t\t: undefined;\n\t\t}\n\t\treturn ret;\n\t}\n\n\t/** Checks whether this CC is encapsulated with one that has the given CC id and (optionally) CC Command */\n\tpublic isEncapsulatedWith(\n\t\tccId: CommandClasses,\n\t\tccCommand?: number,\n\t): boolean {\n\t\tlet cc: CommandClass = this;\n\t\t// Check whether there was a S0 encapsulation\n\t\twhile (cc.encapsulatingCC) {\n\t\t\tcc = cc.encapsulatingCC;\n\t\t\tif (\n\t\t\t\tcc.ccId === ccId\n\t\t\t\t&& (ccCommand === undefined || cc.ccCommand === ccCommand)\n\t\t\t) {\n\t\t\t\treturn true;\n\t\t\t}\n\t\t}\n\t\treturn false;\n\t}\n\n\t/** Traverses the encapsulation stack of this CC outwards and returns the one that has the given CC id and (optionally) CC Command if that exists. */\n\tpublic getEncapsulatingCC(\n\t\tccId: CommandClasses,\n\t\tccCommand?: number,\n\t): CommandClass | undefined {\n\t\tlet cc: CommandClass = this;\n\t\twhile (cc.encapsulatingCC) {\n\t\t\tcc = cc.encapsulatingCC;\n\t\t\tif (\n\t\t\t\tcc.ccId === ccId\n\t\t\t\t&& (ccCommand === undefined || cc.ccCommand === ccCommand)\n\t\t\t) {\n\t\t\t\treturn cc;\n\t\t\t}\n\t\t}\n\t}\n\n\t/** Traverses the encapsulation stack of this CC inwards and returns the one that has the given CC id and (optionally) CC Command if that exists. */\n\tpublic getEncapsulatedCC(\n\t\tccId: CommandClasses,\n\t\tccCommand?: number,\n\t): CommandClass | undefined {\n\t\tconst predicate = (cc: CommandClass): boolean =>\n\t\t\tcc.ccId === ccId\n\t\t\t&& (ccCommand === undefined || cc.ccCommand === ccCommand);\n\n\t\tif (isEncapsulatingCommandClass(this)) {\n\t\t\tif (predicate(this.encapsulated)) return this.encapsulated;\n\t\t\treturn this.encapsulated.getEncapsulatedCC(ccId, ccCommand);\n\t\t} else if (isMultiEncapsulatingCommandClass(this)) {\n\t\t\tfor (const encapsulated of this.encapsulated) {\n\t\t\t\tif (predicate(encapsulated)) return encapsulated;\n\t\t\t\tconst ret = encapsulated.getEncapsulatedCC(ccId, ccCommand);\n\t\t\t\tif (ret) return ret;\n\t\t\t}\n\t\t}\n\t}\n}\n\nexport interface InvalidCCOptions extends CommandClassOptions {\n\tccName: string;\n\treason?: string | ZWaveErrorCodes;\n}\n\nexport class InvalidCC extends CommandClass {\n\tpublic constructor(options: InvalidCCOptions) {\n\t\tsuper(options);\n\t\tthis._ccName = options.ccName;\n\t\t// Numeric reasons are used internally to communicate problems with a CC\n\t\t// without ignoring them entirely\n\t\tthis.reason = options.reason;\n\t}\n\n\tprivate _ccName: string;\n\tpublic get ccName(): string {\n\t\treturn this._ccName;\n\t}\n\tpublic readonly reason?: string | ZWaveErrorCodes;\n\n\tpublic toLogEntry(_ctx?: GetValueDB): MessageOrCCLogEntry {\n\t\treturn {\n\t\t\ttags: [this.ccName, \"INVALID\"],\n\t\t\tmessage: this.reason != undefined\n\t\t\t\t? {\n\t\t\t\t\terror: typeof this.reason === \"string\"\n\t\t\t\t\t\t? this.reason\n\t\t\t\t\t\t: getEnumMemberName(\n\t\t\t\t\t\t\tZWaveErrorCodes,\n\t\t\t\t\t\t\tthis.reason,\n\t\t\t\t\t\t),\n\t\t\t\t}\n\t\t\t\t: undefined,\n\t\t};\n\t}\n}\n\nexport type CCConstructor<T extends CommandClass> = typeof CommandClass & {\n\t// I don't like the any, but we need it to support half-implemented CCs (e.g. report classes)\n\tnew (options: any): T;\n};\n\n/**\n * @publicAPI\n * May be used to define different expected CC responses depending on the sent CC\n */\nexport type DynamicCCResponse<\n\tTSent extends CommandClass,\n\tTReceived extends CommandClass = CommandClass,\n> = (\n\tsentCC: TSent,\n) => CCConstructor<TReceived> | CCConstructor<TReceived>[] | undefined;\n\n/** @publicAPI */\nexport type CCResponseRole =\n\t| boolean // The response was either expected or unexpected\n\t| \"checkEncapsulated\"; // The response role depends on the encapsulated CC\n\n/**\n * @publicAPI\n * A predicate function to test if a received CC matches the sent CC\n */\nexport type CCResponsePredicate<\n\tTSent extends CommandClass,\n\tTReceived extends CommandClass = CommandClass,\n> = (sentCommand: TSent, receivedCommand: TReceived) => CCResponseRole;\n"],
+  "mappings": "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",
+  "names": ["import_safe"]
 }

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

@@ -1,4 +1,4 @@
-import { type CommandClasses } from "@zwave-js/core";
+import { type CommandClasses } from "@zwave-js/core/safe";
 import type { TypedClassDecorator } from "@zwave-js/shared";
 import type { APIConstructor, CCAPI } from "./API.js";
 import { type CCConstructor, type CCResponsePredicate, type CommandClass, type DynamicCCResponse } from "./CommandClass.js";

package/build/cjs/lib/CommandClassDecorators.js

@@ -42,8 +42,8 @@ __export(CommandClassDecorators_exports, {
   useSupervision: () => useSupervision
 });
 module.exports = __toCommonJS(CommandClassDecorators_exports);
-var import_core = require("@zwave-js/core");
 var import_reflection = require("@zwave-js/core/reflection");
+var import_safe = require("@zwave-js/core/safe");
 const CCAndCommandDecorator = (0, import_reflection.createReflectionDecoratorPair)({ superName: "ccId", subName: "ccCommand" });
 const commandClass = CCAndCommandDecorator.superDecorator;
 const getCCConstructor = CCAndCommandDecorator.lookupSuperConstructor;
@@ -53,7 +53,7 @@ const getCCCommandConstructor = CCAndCommandDecorator.lookupSubConstructor;
 function getCommandClassStatic(classConstructor) {
   const ret = CCAndCommandDecorator.lookupSuperValueStatic(classConstructor);
   if (ret == void 0) {
-    throw new import_core.ZWaveError(`No command class defined for ${classConstructor.name}!`, import_core.ZWaveErrorCodes.CC_Invalid);
+    throw new import_safe.ZWaveError(`No command class defined for ${classConstructor.name}!`, import_safe.ZWaveErrorCodes.CC_Invalid);
   }
   return ret;
 }
@@ -71,7 +71,7 @@ function getCommandClass(cc) {
   const constr = cc.constructor;
   const ret = CCAndCommandDecorator.lookupSuperValueStatic(constr) ?? apiDecorator.lookupValueStatic(constr);
   if (ret == void 0) {
-    throw new import_core.ZWaveError(`No command class defined for ${constr.name}!`, import_core.ZWaveErrorCodes.CC_Invalid);
+    throw new import_safe.ZWaveError(`No command class defined for ${constr.name}!`, import_safe.ZWaveErrorCodes.CC_Invalid);
   }
   return ret;
 }

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/CommandClassDecorators.ts"],
-  "sourcesContent": ["import {\n\ttype CommandClasses,\n\tZWaveError,\n\tZWaveErrorCodes,\n} from \"@zwave-js/core\";\nimport {\n\tcreateReflectionDecorator,\n\tcreateReflectionDecoratorPair,\n\tcreateValuelessReflectionDecorator,\n} from \"@zwave-js/core/reflection\";\nimport type { TypedClassDecorator } from \"@zwave-js/shared\";\nimport type { APIConstructor, CCAPI } from \"./API.js\";\nimport {\n\ttype CCConstructor,\n\ttype CCResponsePredicate,\n\ttype CommandClass,\n\ttype DynamicCCResponse,\n} from \"./CommandClass.js\";\nimport type {\n\tDynamicCCValue,\n\tStaticCCValue,\n\tStaticCCValueFactory,\n} from \"./Values.js\";\n\nconst CCAndCommandDecorator = createReflectionDecoratorPair<\n\ttypeof CommandClass,\n\t[ccId: CommandClasses],\n\t[ccCommand: number],\n\tCCConstructor<CommandClass>\n>({ superName: \"ccId\", subName: \"ccCommand\" });\n\n/**\n * @publicAPI\n * Defines the CC ID associated with a Z-Wave Command Class\n */\nexport const commandClass = CCAndCommandDecorator.superDecorator;\n\n/**\n * @publicAPI\n * Looks up the command class constructor for a given CC ID\n */\nexport const getCCConstructor = CCAndCommandDecorator.lookupSuperConstructor;\n\n/**\n * @publicAPI\n * Defines the CC command a subclass of a CC implements\n */\nexport const CCCommand = CCAndCommandDecorator.subDecorator;\n\n/**\n * @publicAPI\n * Retrieves the CC command a subclass of a CC implements\n */\nexport const getCCCommand = CCAndCommandDecorator.lookupSubValue;\n\n/**\n * @publicAPI\n * Looks up the command class constructor for a given CC ID and command\n */\nexport const getCCCommandConstructor =\n\tCCAndCommandDecorator.lookupSubConstructor;\n\n/**\n * @publicAPI\n * Retrieves the CC ID defined for a Z-Wave Command Class\n */\nexport function getCommandClassStatic<T extends CCConstructor<CommandClass>>(\n\tclassConstructor: T,\n): CommandClasses {\n\t// retrieve the current metadata\n\tconst ret = CCAndCommandDecorator.lookupSuperValueStatic(classConstructor);\n\tif (ret == undefined) {\n\t\tthrow new ZWaveError(\n\t\t\t`No command class defined for ${classConstructor.name}!`,\n\t\t\tZWaveErrorCodes.CC_Invalid,\n\t\t);\n\t}\n\treturn ret;\n}\n\nconst apiDecorator = createReflectionDecorator<\n\ttypeof CCAPI,\n\t[cc: CommandClasses],\n\tCommandClasses,\n\tAPIConstructor\n>({\n\tname: \"API\",\n\tvalueFromArgs: (cc) => cc,\n});\n\n/**\n * @publicAPI\n * Defines the CC ID a CC API implementation belongs to\n */\nexport const API = apiDecorator.decorator;\n\n/**\n * @publicAPI\n * Retrieves the CC API constructor that is defined for a Z-Wave CC ID\n */\nexport function getAPI(cc: CommandClasses): APIConstructor | undefined {\n\treturn apiDecorator.lookupConstructorByValue(cc);\n}\n\n/**\n * @publicAPI\n * Retrieves the CC ID associated with a Z-Wave Command Class or CC API\n */\nexport function getCommandClass(cc: CommandClass | CCAPI): CommandClasses {\n\t// get the class constructor\n\tconst constr = cc.constructor;\n\t// retrieve the current metadata\n\tconst ret = CCAndCommandDecorator.lookupSuperValueStatic(\n\t\tconstr as typeof CommandClass,\n\t)\n\t\t?? apiDecorator.lookupValueStatic(constr as typeof CCAPI);\n\n\tif (ret == undefined) {\n\t\tthrow new ZWaveError(\n\t\t\t`No command class defined for ${constr.name}!`,\n\t\t\tZWaveErrorCodes.CC_Invalid,\n\t\t);\n\t}\n\treturn ret;\n}\n\nconst implementedVersionDecorator = createReflectionDecorator<\n\ttypeof CommandClass,\n\t[version: number],\n\tnumber\n>({\n\tname: \"implementedVersion\",\n\tvalueFromArgs: (version) => version,\n\tconstructorLookupKey: false,\n});\n\n/**\n * @publicAPI\n * Defines the implemented version of a Z-Wave command class\n */\nexport const implementedVersion = implementedVersionDecorator.decorator;\n\n/**\n * @publicAPI\n * Retrieves the implemented version defined for a Z-Wave command class\n */\nexport function getImplementedVersion<T extends CommandClass>(\n\tcc: T | CommandClasses,\n): number {\n\t// get the class constructor\n\tlet constr: CCConstructor<CommandClass> | undefined;\n\tif (typeof cc === \"number\") {\n\t\tconstr = getCCConstructor(cc);\n\t} else {\n\t\tconstr = cc.constructor as CCConstructor<CommandClass>;\n\t}\n\n\tif (!constr) return 0;\n\treturn implementedVersionDecorator.lookupValueStatic(constr) ?? 0;\n}\n\n/**\n * @publicAPI\n * Retrieves the implemented version defined for a Z-Wave command class\n */\nexport function getImplementedVersionStatic<\n\tT extends CCConstructor<CommandClass>,\n>(classConstructor: T): number {\n\treturn implementedVersionDecorator.lookupValueStatic(classConstructor) ?? 0;\n}\n\nconst expectedCCResponseDecorator = createReflectionDecorator<\n\ttypeof CommandClass,\n\t[\n\t\tcc:\n\t\t\t| CCConstructor<CommandClass>\n\t\t\t| DynamicCCResponse<CommandClass, CommandClass>,\n\t\tpredicate?: CCResponsePredicate<CommandClass, CommandClass>,\n\t],\n\t{\n\t\tcc:\n\t\t\t| CCConstructor<CommandClass>\n\t\t\t| DynamicCCResponse<CommandClass, CommandClass>;\n\t\tpredicate?: CCResponsePredicate<CommandClass, CommandClass>;\n\t}\n>({\n\tname: \"expectedCCResponse\",\n\tvalueFromArgs: (cc, predicate) => ({ cc, predicate }),\n\t// We don't need reverse lookup\n\tconstructorLookupKey: false,\n});\n\n/**\n * @publicAPI\n * Defines the expected response associated with a Z-Wave message\n */\nexport function expectedCCResponse<\n\tTTarget extends typeof CommandClass,\n\tTSent extends CommandClass,\n\tTReceived extends CommandClass,\n>(\n\tcc: CCConstructor<TReceived> | DynamicCCResponse<TSent, TReceived>,\n\tpredicate?: CCResponsePredicate<TSent, TReceived>,\n): TypedClassDecorator<TTarget> {\n\treturn expectedCCResponseDecorator.decorator(cc as any, predicate as any);\n}\n\n/**\n * @publicAPI\n * Retrieves the expected response (static or dynamic) defined for a Z-Wave message class\n */\nexport function getExpectedCCResponse<T extends CommandClass>(\n\tccClass: T,\n): typeof CommandClass | DynamicCCResponse<T> | undefined {\n\treturn expectedCCResponseDecorator.lookupValue(ccClass)?.cc;\n}\n\n/**\n * @publicAPI\n * Retrieves the CC response predicate defined for a Z-Wave message class\n */\nexport function getCCResponsePredicate<T extends CommandClass>(\n\tccClass: T,\n): CCResponsePredicate<T> | undefined {\n\treturn expectedCCResponseDecorator.lookupValue(ccClass)?.predicate;\n}\n\nconst ccValuesDecorator = createReflectionDecorator<\n\ttypeof CommandClass,\n\t[valueDefinition: Record<string, StaticCCValue | DynamicCCValue>],\n\tRecord<string, StaticCCValue | DynamicCCValue | undefined>\n>({\n\tname: \"ccValues\",\n\tvalueFromArgs: (valueDefinition) => valueDefinition,\n\t// We don't need reverse lookup\n\tconstructorLookupKey: false,\n});\n\n/**\n * @publicAPI\n * Defines which CC value definitions belong to a Z-Wave command class\n */\nexport const ccValues = ccValuesDecorator.decorator;\n\n/**\n * @publicAPI\n * Retrieves the CC value definitions which belong to a Z-Wave command class\n */\nexport function getCCValues<T extends CommandClass>(\n\tcc: T | CommandClasses,\n): Record<string, StaticCCValue | DynamicCCValue | undefined> | undefined {\n\t// get the class constructor\n\tlet constr: CCConstructor<CommandClass> | undefined;\n\tif (typeof cc === \"number\") {\n\t\tconstr = getCCConstructor(cc);\n\t} else {\n\t\tconstr = cc.constructor as CCConstructor<CommandClass>;\n\t}\n\n\tif (constr) return ccValuesDecorator.lookupValueStatic(constr);\n}\n\nconst ccValue_METADATA = Symbol.for(`METADATA_ccValue`);\n\n// /**\n//  * @publicAPI\n//  * Defines which CC value a Z-Wave command class property belongs to\n//  */\n// export function ccValue<TTarget extends CommandClass>(\n// \tvalue: StaticCCValue,\n// ): TypedPropertyDecorator<TTarget>;\n\n// export function ccValue<TTarget extends CommandClass, TArgs extends any[]>(\n// \tvalue: DynamicCCValue<TArgs>,\n// \tgetArgs: (self: TTarget) => Readonly<TArgs>,\n// ): TypedPropertyDecorator<TTarget>;\n\n// // Ideally this should use the PropertyReflectionDecorator, but we cannot reuse the\n// // target type in the getArgs function then.\n// export function ccValue<TTarget extends CommandClass, TArgs extends any[]>(\n// \t...args:\n// \t\t| [value: StaticCCValue]\n// \t\t| [value: DynamicCCValue<TArgs>, getArgs: (self: TTarget) => TArgs]\n// ): TypedPropertyDecorator<TTarget> {\n// \t// Normalize the arguments to the expected format\n// \tdebugger;\n// \tlet valueOrFactory: StaticCCValue | StaticCCValueFactory<TTarget>;\n// \tif (args.length === 1) {\n// \t\tvalueOrFactory = args[0];\n// \t} else {\n// \t\tconst [value, getArgs] = args;\n// \t\tvalueOrFactory = (self: TTarget) => {\n// \t\t\tconst args = getArgs(self);\n// \t\t\tconst base = value(...args);\n// \t\t\treturn {\n// \t\t\t\t...base,\n// \t\t\t\tis: value.is,\n// \t\t\t\toptions: value.options,\n// \t\t\t};\n// \t\t};\n// \t}\n\n// \treturn function decoratorBody_ccValue(\n// \t\ttarget: TTarget,\n// \t\tproperty: string | number | symbol,\n// \t): void {\n// \t\t// get the class constructor\n// \t\tconst constr = target.constructor;\n\n// \t\t// retrieve the current metadata\n// \t\tconst metadata: Map<\n// \t\t\tstring | number,\n// \t\t\tStaticCCValue | StaticCCValueFactory<TTarget>\n// \t\t> = Reflect.getMetadata(ccValue_METADATA, constr) ?? new Map();\n\n// \t\t// Add the variable\n// \t\tmetadata.set(property as string | number, valueOrFactory);\n\n// \t\t// And store it back\n// \t\tReflect.defineMetadata(ccValue_METADATA, metadata, constr);\n// \t};\n// }\n\nexport function ccValueProperty<\n\tClass extends abstract new (...args: any) => any,\n>(\n\tproperty: keyof InstanceType<Class>,\n\tvalue: StaticCCValue,\n): TypedClassDecorator<Class>;\n\nexport function ccValueProperty<\n\tClass extends abstract new (...args: any) => any,\n\tconst TArgs extends any[],\n>(\n\tproperty: keyof InstanceType<Class>,\n\tvalue: DynamicCCValue<TArgs>,\n\tgetArgs: (self: InstanceType<Class>) => TArgs,\n): TypedClassDecorator<Class>;\n\n/**\n * @publicAPI\n * Defines which CC values the properties of a Z-Wave Command Class correspond to\n */\nexport function ccValueProperty<\n\tClass extends abstract new (...args: any) => any,\n\tconst TArgs extends any[],\n>(\n\tproperty: keyof InstanceType<Class>,\n\t...args:\n\t\t| [value: StaticCCValue]\n\t\t| [\n\t\t\tvalue: DynamicCCValue<TArgs>,\n\t\t\tgetArgs: (self: InstanceType<Class>) => TArgs,\n\t\t]\n): TypedClassDecorator<Class> {\n\treturn function decorator_ccValueProperty(constr: Class): void {\n\t\t// retrieve the current metadata\n\t\tconst metadata: Map<\n\t\t\tstring | number,\n\t\t\tStaticCCValue | StaticCCValueFactory<InstanceType<Class>>\n\t\t> = Reflect.getMetadata(ccValue_METADATA, constr) ?? new Map();\n\n\t\t// Determine the correct metadata\n\t\tlet valueOrFactory:\n\t\t\t| StaticCCValue\n\t\t\t| StaticCCValueFactory<InstanceType<Class>>;\n\t\tif (args.length === 1) {\n\t\t\tvalueOrFactory = args[0];\n\t\t} else {\n\t\t\tconst [value, getArgs] = args;\n\t\t\tvalueOrFactory = (self: InstanceType<Class>) => {\n\t\t\t\tconst args = getArgs(self);\n\t\t\t\tconst base = value(...args);\n\t\t\t\treturn {\n\t\t\t\t\t...base,\n\t\t\t\t\tis: value.is,\n\t\t\t\t\toptions: value.options,\n\t\t\t\t};\n\t\t\t};\n\t\t}\n\n\t\t// Add the metadata\n\t\tmetadata.set(property as string | number, valueOrFactory);\n\n\t\t// And store it back\n\t\tReflect.defineMetadata(ccValue_METADATA, metadata, constr);\n\t};\n}\n\n/**\n * @publicAPI\n * Retrieves the defined mapping between properties and CC values of a Z-Wave command class instance\n */\nexport function getCCValueProperties<TTarget extends CommandClass>(\n\ttarget: TTarget,\n): ReadonlyMap<string | number, StaticCCValue | StaticCCValueFactory<TTarget>> {\n\treturn (\n\t\tReflect.getMetadata(ccValue_METADATA, target.constructor) ?? new Map()\n\t);\n}\n\n// const ccValueDecorator = createPropertyReflectionDecorator<\n// \tCommandClass,\n// \t[value: StaticCCValue | StaticCCValueFactory<CommandClass>],\n// \tStaticCCValue | StaticCCValueFactory<CommandClass>\n// >({\n// \tname: \"ccValue\",\n// \tvalueFromArgs: (valueDefinition) => valueDefinition,\n// });\n\n// /**\n//  * @publicAPI\n//  * Defines which CC value a Z-Wave command class property belongs to\n//  */\n// export const ccValue = ccValueDecorator.decorator;\n\n// /**\n//  * @publicAPI\n//  * Retrieves the defined mapping between properties and CC values of a Z-Wave command class instance\n//  */\n// export const getCCValueDefinitions = ccValueDecorator.lookupValues;\n\nconst supervisionDecorator = createValuelessReflectionDecorator<\n\ttypeof CommandClass\n>({\n\tname: \"useSupervision\",\n});\n\n/**\n * @publicAPI\n * Defines that this CC may be sent supervised\n */\nexport const useSupervision = supervisionDecorator.decorator;\n\n/**\n * @publicAPI\n * Checks if the given CC may be sent supervised\n */\nexport const shouldUseSupervision = supervisionDecorator.isDecorated;\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n\tcreateReflectionDecorator,\n\tcreateReflectionDecoratorPair,\n\tcreateValuelessReflectionDecorator,\n} from \"@zwave-js/core/reflection\";\nimport {\n\ttype CommandClasses,\n\tZWaveError,\n\tZWaveErrorCodes,\n} from \"@zwave-js/core/safe\";\nimport type { TypedClassDecorator } from \"@zwave-js/shared\";\nimport type { APIConstructor, CCAPI } from \"./API.js\";\nimport {\n\ttype CCConstructor,\n\ttype CCResponsePredicate,\n\ttype CommandClass,\n\ttype DynamicCCResponse,\n} from \"./CommandClass.js\";\nimport type {\n\tDynamicCCValue,\n\tStaticCCValue,\n\tStaticCCValueFactory,\n} from \"./Values.js\";\n\nconst CCAndCommandDecorator = createReflectionDecoratorPair<\n\ttypeof CommandClass,\n\t[ccId: CommandClasses],\n\t[ccCommand: number],\n\tCCConstructor<CommandClass>\n>({ superName: \"ccId\", subName: \"ccCommand\" });\n\n/**\n * @publicAPI\n * Defines the CC ID associated with a Z-Wave Command Class\n */\nexport const commandClass = CCAndCommandDecorator.superDecorator;\n\n/**\n * @publicAPI\n * Looks up the command class constructor for a given CC ID\n */\nexport const getCCConstructor = CCAndCommandDecorator.lookupSuperConstructor;\n\n/**\n * @publicAPI\n * Defines the CC command a subclass of a CC implements\n */\nexport const CCCommand = CCAndCommandDecorator.subDecorator;\n\n/**\n * @publicAPI\n * Retrieves the CC command a subclass of a CC implements\n */\nexport const getCCCommand = CCAndCommandDecorator.lookupSubValue;\n\n/**\n * @publicAPI\n * Looks up the command class constructor for a given CC ID and command\n */\nexport const getCCCommandConstructor =\n\tCCAndCommandDecorator.lookupSubConstructor;\n\n/**\n * @publicAPI\n * Retrieves the CC ID defined for a Z-Wave Command Class\n */\nexport function getCommandClassStatic<T extends CCConstructor<CommandClass>>(\n\tclassConstructor: T,\n): CommandClasses {\n\t// retrieve the current metadata\n\tconst ret = CCAndCommandDecorator.lookupSuperValueStatic(classConstructor);\n\tif (ret == undefined) {\n\t\tthrow new ZWaveError(\n\t\t\t`No command class defined for ${classConstructor.name}!`,\n\t\t\tZWaveErrorCodes.CC_Invalid,\n\t\t);\n\t}\n\treturn ret;\n}\n\nconst apiDecorator = createReflectionDecorator<\n\ttypeof CCAPI,\n\t[cc: CommandClasses],\n\tCommandClasses,\n\tAPIConstructor\n>({\n\tname: \"API\",\n\tvalueFromArgs: (cc) => cc,\n});\n\n/**\n * @publicAPI\n * Defines the CC ID a CC API implementation belongs to\n */\nexport const API = apiDecorator.decorator;\n\n/**\n * @publicAPI\n * Retrieves the CC API constructor that is defined for a Z-Wave CC ID\n */\nexport function getAPI(cc: CommandClasses): APIConstructor | undefined {\n\treturn apiDecorator.lookupConstructorByValue(cc);\n}\n\n/**\n * @publicAPI\n * Retrieves the CC ID associated with a Z-Wave Command Class or CC API\n */\nexport function getCommandClass(cc: CommandClass | CCAPI): CommandClasses {\n\t// get the class constructor\n\tconst constr = cc.constructor;\n\t// retrieve the current metadata\n\tconst ret = CCAndCommandDecorator.lookupSuperValueStatic(\n\t\tconstr as typeof CommandClass,\n\t)\n\t\t?? apiDecorator.lookupValueStatic(constr as typeof CCAPI);\n\n\tif (ret == undefined) {\n\t\tthrow new ZWaveError(\n\t\t\t`No command class defined for ${constr.name}!`,\n\t\t\tZWaveErrorCodes.CC_Invalid,\n\t\t);\n\t}\n\treturn ret;\n}\n\nconst implementedVersionDecorator = createReflectionDecorator<\n\ttypeof CommandClass,\n\t[version: number],\n\tnumber\n>({\n\tname: \"implementedVersion\",\n\tvalueFromArgs: (version) => version,\n\tconstructorLookupKey: false,\n});\n\n/**\n * @publicAPI\n * Defines the implemented version of a Z-Wave command class\n */\nexport const implementedVersion = implementedVersionDecorator.decorator;\n\n/**\n * @publicAPI\n * Retrieves the implemented version defined for a Z-Wave command class\n */\nexport function getImplementedVersion<T extends CommandClass>(\n\tcc: T | CommandClasses,\n): number {\n\t// get the class constructor\n\tlet constr: CCConstructor<CommandClass> | undefined;\n\tif (typeof cc === \"number\") {\n\t\tconstr = getCCConstructor(cc);\n\t} else {\n\t\tconstr = cc.constructor as CCConstructor<CommandClass>;\n\t}\n\n\tif (!constr) return 0;\n\treturn implementedVersionDecorator.lookupValueStatic(constr) ?? 0;\n}\n\n/**\n * @publicAPI\n * Retrieves the implemented version defined for a Z-Wave command class\n */\nexport function getImplementedVersionStatic<\n\tT extends CCConstructor<CommandClass>,\n>(classConstructor: T): number {\n\treturn implementedVersionDecorator.lookupValueStatic(classConstructor) ?? 0;\n}\n\nconst expectedCCResponseDecorator = createReflectionDecorator<\n\ttypeof CommandClass,\n\t[\n\t\tcc:\n\t\t\t| CCConstructor<CommandClass>\n\t\t\t| DynamicCCResponse<CommandClass, CommandClass>,\n\t\tpredicate?: CCResponsePredicate<CommandClass, CommandClass>,\n\t],\n\t{\n\t\tcc:\n\t\t\t| CCConstructor<CommandClass>\n\t\t\t| DynamicCCResponse<CommandClass, CommandClass>;\n\t\tpredicate?: CCResponsePredicate<CommandClass, CommandClass>;\n\t}\n>({\n\tname: \"expectedCCResponse\",\n\tvalueFromArgs: (cc, predicate) => ({ cc, predicate }),\n\t// We don't need reverse lookup\n\tconstructorLookupKey: false,\n});\n\n/**\n * @publicAPI\n * Defines the expected response associated with a Z-Wave message\n */\nexport function expectedCCResponse<\n\tTTarget extends typeof CommandClass,\n\tTSent extends CommandClass,\n\tTReceived extends CommandClass,\n>(\n\tcc: CCConstructor<TReceived> | DynamicCCResponse<TSent, TReceived>,\n\tpredicate?: CCResponsePredicate<TSent, TReceived>,\n): TypedClassDecorator<TTarget> {\n\treturn expectedCCResponseDecorator.decorator(cc as any, predicate as any);\n}\n\n/**\n * @publicAPI\n * Retrieves the expected response (static or dynamic) defined for a Z-Wave message class\n */\nexport function getExpectedCCResponse<T extends CommandClass>(\n\tccClass: T,\n): typeof CommandClass | DynamicCCResponse<T> | undefined {\n\treturn expectedCCResponseDecorator.lookupValue(ccClass)?.cc;\n}\n\n/**\n * @publicAPI\n * Retrieves the CC response predicate defined for a Z-Wave message class\n */\nexport function getCCResponsePredicate<T extends CommandClass>(\n\tccClass: T,\n): CCResponsePredicate<T> | undefined {\n\treturn expectedCCResponseDecorator.lookupValue(ccClass)?.predicate;\n}\n\nconst ccValuesDecorator = createReflectionDecorator<\n\ttypeof CommandClass,\n\t[valueDefinition: Record<string, StaticCCValue | DynamicCCValue>],\n\tRecord<string, StaticCCValue | DynamicCCValue | undefined>\n>({\n\tname: \"ccValues\",\n\tvalueFromArgs: (valueDefinition) => valueDefinition,\n\t// We don't need reverse lookup\n\tconstructorLookupKey: false,\n});\n\n/**\n * @publicAPI\n * Defines which CC value definitions belong to a Z-Wave command class\n */\nexport const ccValues = ccValuesDecorator.decorator;\n\n/**\n * @publicAPI\n * Retrieves the CC value definitions which belong to a Z-Wave command class\n */\nexport function getCCValues<T extends CommandClass>(\n\tcc: T | CommandClasses,\n): Record<string, StaticCCValue | DynamicCCValue | undefined> | undefined {\n\t// get the class constructor\n\tlet constr: CCConstructor<CommandClass> | undefined;\n\tif (typeof cc === \"number\") {\n\t\tconstr = getCCConstructor(cc);\n\t} else {\n\t\tconstr = cc.constructor as CCConstructor<CommandClass>;\n\t}\n\n\tif (constr) return ccValuesDecorator.lookupValueStatic(constr);\n}\n\nconst ccValue_METADATA = Symbol.for(`METADATA_ccValue`);\n\n// /**\n//  * @publicAPI\n//  * Defines which CC value a Z-Wave command class property belongs to\n//  */\n// export function ccValue<TTarget extends CommandClass>(\n// \tvalue: StaticCCValue,\n// ): TypedPropertyDecorator<TTarget>;\n\n// export function ccValue<TTarget extends CommandClass, TArgs extends any[]>(\n// \tvalue: DynamicCCValue<TArgs>,\n// \tgetArgs: (self: TTarget) => Readonly<TArgs>,\n// ): TypedPropertyDecorator<TTarget>;\n\n// // Ideally this should use the PropertyReflectionDecorator, but we cannot reuse the\n// // target type in the getArgs function then.\n// export function ccValue<TTarget extends CommandClass, TArgs extends any[]>(\n// \t...args:\n// \t\t| [value: StaticCCValue]\n// \t\t| [value: DynamicCCValue<TArgs>, getArgs: (self: TTarget) => TArgs]\n// ): TypedPropertyDecorator<TTarget> {\n// \t// Normalize the arguments to the expected format\n// \tdebugger;\n// \tlet valueOrFactory: StaticCCValue | StaticCCValueFactory<TTarget>;\n// \tif (args.length === 1) {\n// \t\tvalueOrFactory = args[0];\n// \t} else {\n// \t\tconst [value, getArgs] = args;\n// \t\tvalueOrFactory = (self: TTarget) => {\n// \t\t\tconst args = getArgs(self);\n// \t\t\tconst base = value(...args);\n// \t\t\treturn {\n// \t\t\t\t...base,\n// \t\t\t\tis: value.is,\n// \t\t\t\toptions: value.options,\n// \t\t\t};\n// \t\t};\n// \t}\n\n// \treturn function decoratorBody_ccValue(\n// \t\ttarget: TTarget,\n// \t\tproperty: string | number | symbol,\n// \t): void {\n// \t\t// get the class constructor\n// \t\tconst constr = target.constructor;\n\n// \t\t// retrieve the current metadata\n// \t\tconst metadata: Map<\n// \t\t\tstring | number,\n// \t\t\tStaticCCValue | StaticCCValueFactory<TTarget>\n// \t\t> = Reflect.getMetadata(ccValue_METADATA, constr) ?? new Map();\n\n// \t\t// Add the variable\n// \t\tmetadata.set(property as string | number, valueOrFactory);\n\n// \t\t// And store it back\n// \t\tReflect.defineMetadata(ccValue_METADATA, metadata, constr);\n// \t};\n// }\n\nexport function ccValueProperty<\n\tClass extends abstract new (...args: any) => any,\n>(\n\tproperty: keyof InstanceType<Class>,\n\tvalue: StaticCCValue,\n): TypedClassDecorator<Class>;\n\nexport function ccValueProperty<\n\tClass extends abstract new (...args: any) => any,\n\tconst TArgs extends any[],\n>(\n\tproperty: keyof InstanceType<Class>,\n\tvalue: DynamicCCValue<TArgs>,\n\tgetArgs: (self: InstanceType<Class>) => TArgs,\n): TypedClassDecorator<Class>;\n\n/**\n * @publicAPI\n * Defines which CC values the properties of a Z-Wave Command Class correspond to\n */\nexport function ccValueProperty<\n\tClass extends abstract new (...args: any) => any,\n\tconst TArgs extends any[],\n>(\n\tproperty: keyof InstanceType<Class>,\n\t...args:\n\t\t| [value: StaticCCValue]\n\t\t| [\n\t\t\tvalue: DynamicCCValue<TArgs>,\n\t\t\tgetArgs: (self: InstanceType<Class>) => TArgs,\n\t\t]\n): TypedClassDecorator<Class> {\n\treturn function decorator_ccValueProperty(constr: Class): void {\n\t\t// retrieve the current metadata\n\t\tconst metadata: Map<\n\t\t\tstring | number,\n\t\t\tStaticCCValue | StaticCCValueFactory<InstanceType<Class>>\n\t\t> = Reflect.getMetadata(ccValue_METADATA, constr) ?? new Map();\n\n\t\t// Determine the correct metadata\n\t\tlet valueOrFactory:\n\t\t\t| StaticCCValue\n\t\t\t| StaticCCValueFactory<InstanceType<Class>>;\n\t\tif (args.length === 1) {\n\t\t\tvalueOrFactory = args[0];\n\t\t} else {\n\t\t\tconst [value, getArgs] = args;\n\t\t\tvalueOrFactory = (self: InstanceType<Class>) => {\n\t\t\t\tconst args = getArgs(self);\n\t\t\t\tconst base = value(...args);\n\t\t\t\treturn {\n\t\t\t\t\t...base,\n\t\t\t\t\tis: value.is,\n\t\t\t\t\toptions: value.options,\n\t\t\t\t};\n\t\t\t};\n\t\t}\n\n\t\t// Add the metadata\n\t\tmetadata.set(property as string | number, valueOrFactory);\n\n\t\t// And store it back\n\t\tReflect.defineMetadata(ccValue_METADATA, metadata, constr);\n\t};\n}\n\n/**\n * @publicAPI\n * Retrieves the defined mapping between properties and CC values of a Z-Wave command class instance\n */\nexport function getCCValueProperties<TTarget extends CommandClass>(\n\ttarget: TTarget,\n): ReadonlyMap<string | number, StaticCCValue | StaticCCValueFactory<TTarget>> {\n\treturn (\n\t\tReflect.getMetadata(ccValue_METADATA, target.constructor) ?? new Map()\n\t);\n}\n\n// const ccValueDecorator = createPropertyReflectionDecorator<\n// \tCommandClass,\n// \t[value: StaticCCValue | StaticCCValueFactory<CommandClass>],\n// \tStaticCCValue | StaticCCValueFactory<CommandClass>\n// >({\n// \tname: \"ccValue\",\n// \tvalueFromArgs: (valueDefinition) => valueDefinition,\n// });\n\n// /**\n//  * @publicAPI\n//  * Defines which CC value a Z-Wave command class property belongs to\n//  */\n// export const ccValue = ccValueDecorator.decorator;\n\n// /**\n//  * @publicAPI\n//  * Retrieves the defined mapping between properties and CC values of a Z-Wave command class instance\n//  */\n// export const getCCValueDefinitions = ccValueDecorator.lookupValues;\n\nconst supervisionDecorator = createValuelessReflectionDecorator<\n\ttypeof CommandClass\n>({\n\tname: \"useSupervision\",\n});\n\n/**\n * @publicAPI\n * Defines that this CC may be sent supervised\n */\nexport const useSupervision = supervisionDecorator.decorator;\n\n/**\n * @publicAPI\n * Checks if the given CC may be sent supervised\n */\nexport const shouldUseSupervision = supervisionDecorator.isDecorated;\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,wBAIO;AACP,kBAIO;AAeP,MAAM,4BAAwB,iDAK5B,EAAE,WAAW,QAAQ,SAAS,YAAW,CAAE;AAMtC,MAAM,eAAe,sBAAsB;AAM3C,MAAM,mBAAmB,sBAAsB;AAM/C,MAAM,YAAY,sBAAsB;AAMxC,MAAM,eAAe,sBAAsB;AAM3C,MAAM,0BACZ,sBAAsB;AAMjB,SAAU,sBACf,kBAAmB;AAGnB,QAAM,MAAM,sBAAsB,uBAAuB,gBAAgB;AACzE,MAAI,OAAO,QAAW;AACrB,UAAM,IAAI,uBACT,gCAAgC,iBAAiB,IAAI,KACrD,4BAAgB,UAAU;EAE5B;AACA,SAAO;AACR;AAZgB;AAchB,MAAM,mBAAe,6CAKnB;EACD,MAAM;EACN,eAAe,wBAAC,OAAO,IAAR;CACf;AAMM,MAAM,MAAM,aAAa;AAM1B,SAAU,OAAO,IAAkB;AACxC,SAAO,aAAa,yBAAyB,EAAE;AAChD;AAFgB;AAQV,SAAU,gBAAgB,IAAwB;AAEvD,QAAM,SAAS,GAAG;AAElB,QAAM,MAAM,sBAAsB,uBACjC,MAA6B,KAE1B,aAAa,kBAAkB,MAAsB;AAEzD,MAAI,OAAO,QAAW;AACrB,UAAM,IAAI,uBACT,gCAAgC,OAAO,IAAI,KAC3C,4BAAgB,UAAU;EAE5B;AACA,SAAO;AACR;AAhBgB;AAkBhB,MAAM,kCAA8B,6CAIlC;EACD,MAAM;EACN,eAAe,wBAAC,YAAY,SAAb;EACf,sBAAsB;CACtB;AAMM,MAAM,qBAAqB,4BAA4B;AAMxD,SAAU,sBACf,IAAsB;AAGtB,MAAI;AACJ,MAAI,OAAO,OAAO,UAAU;AAC3B,aAAS,iBAAiB,EAAE;EAC7B,OAAO;AACN,aAAS,GAAG;EACb;AAEA,MAAI,CAAC;AAAQ,WAAO;AACpB,SAAO,4BAA4B,kBAAkB,MAAM,KAAK;AACjE;AAbgB;AAmBV,SAAU,4BAEd,kBAAmB;AACpB,SAAO,4BAA4B,kBAAkB,gBAAgB,KAAK;AAC3E;AAJgB;AAMhB,MAAM,kCAA8B,6CAclC;EACD,MAAM;EACN,eAAe,wBAAC,IAAI,eAAe,EAAE,IAAI,UAAS,IAAnC;;EAEf,sBAAsB;CACtB;AAMK,SAAU,mBAKf,IACA,WAAiD;AAEjD,SAAO,4BAA4B,UAAU,IAAW,SAAgB;AACzE;AATgB;AAeV,SAAU,sBACf,SAAU;AAEV,SAAO,4BAA4B,YAAY,OAAO,GAAG;AAC1D;AAJgB;AAUV,SAAU,uBACf,SAAU;AAEV,SAAO,4BAA4B,YAAY,OAAO,GAAG;AAC1D;AAJgB;AAMhB,MAAM,wBAAoB,6CAIxB;EACD,MAAM;EACN,eAAe,wBAAC,oBAAoB,iBAArB;;EAEf,sBAAsB;CACtB;AAMM,MAAM,WAAW,kBAAkB;AAMpC,SAAU,YACf,IAAsB;AAGtB,MAAI;AACJ,MAAI,OAAO,OAAO,UAAU;AAC3B,aAAS,iBAAiB,EAAE;EAC7B,OAAO;AACN,aAAS,GAAG;EACb;AAEA,MAAI;AAAQ,WAAO,kBAAkB,kBAAkB,MAAM;AAC9D;AAZgB;AAchB,MAAM,mBAAmB,OAAO,IAAI,kBAAkB;AAiFhD,SAAU,gBAIf,aACG,MAKD;AAEF,SAAO,gCAAS,0BAA0B,QAAa;AAEtD,UAAM,WAGF,QAAQ,YAAY,kBAAkB,MAAM,KAAK,oBAAI,IAAG;AAG5D,QAAI;AAGJ,QAAI,KAAK,WAAW,GAAG;AACtB,uBAAiB,KAAK,CAAC;IACxB,OAAO;AACN,YAAM,CAAC,OAAO,OAAO,IAAI;AACzB,uBAAiB,wBAAC,SAA6B;AAC9C,cAAMA,QAAO,QAAQ,IAAI;AACzB,cAAM,OAAO,MAAM,GAAGA,KAAI;AAC1B,eAAO;UACN,GAAG;UACH,IAAI,MAAM;UACV,SAAS,MAAM;;MAEjB,GARiB;IASlB;AAGA,aAAS,IAAI,UAA6B,cAAc;AAGxD,YAAQ,eAAe,kBAAkB,UAAU,MAAM;EAC1D,GA/BO;AAgCR;AA5CgB;AAkDV,SAAU,qBACf,QAAe;AAEf,SACC,QAAQ,YAAY,kBAAkB,OAAO,WAAW,KAAK,oBAAI,IAAG;AAEtE;AANgB;AA6BhB,MAAM,2BAAuB,sDAE3B;EACD,MAAM;CACN;AAMM,MAAM,iBAAiB,qBAAqB;AAM5C,MAAM,uBAAuB,qBAAqB;",
   "names": ["args"]
 }

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

@@ -1,8 +1,8 @@
-import { type CommandClasses, type EndpointId, type ValueID, ValueMetadata } from "@zwave-js/core/safe";
-import type { GetDeviceConfig, GetValueDB } from "@zwave-js/host";
+import { type GetDeviceConfig } from "@zwave-js/config";
+import { type CommandClasses, type EndpointId, type GetValueDB, type ValueID, type ValueMetadata } from "@zwave-js/core/safe";
 import { type FnOrStatic, type ReturnTypeOrStatic } from "@zwave-js/shared/safe";
-import type { Overwrite } from "alcalzone-shared/types";
 import type { ValueIDProperties } from "./API.js";
+declare function defineCCValues<T extends CommandClasses>(commandClass: T, _: Record<string, CCValueBlueprint | DynamicCCValueBlueprint<any[]>>): typeof import("../cc/_CCValues.generated.js").CCValues[T];
 export interface CCValueOptions {
     /**
      * Whether the CC value is internal. Internal values are not exposed to the user.
@@ -36,7 +36,6 @@ export declare const defaultCCValueOptions: {
     readonly supportsEndpoints: true;
     readonly autoCreate: true;
 };
-type DefaultOptions = typeof defaultCCValueOptions;
 export type ExpandRecursively<T> = T extends (...args: infer A) => infer R ? [keyof T] extends [never] ? (...args: A) => ExpandRecursively<R> : ((...args: A) => ExpandRecursively<R>) & {
     [P in keyof T]: ExpandRecursively<T[P]>;
 } : T extends object ? T extends infer O ? {
@@ -47,34 +46,19 @@ export type ExpandRecursivelySkipMeta<T> = T extends (...args: infer A) => infer
 } : T extends ValueMetadata ? T : T extends object ? T extends infer O ? {
     [K in keyof O]: ExpandRecursivelySkipMeta<O[K]>;
 } : never : T;
-type InferValueIDBase<TCommandClass extends CommandClasses, TBlueprint extends CCValueBlueprint, TWorker = {
-    commandClass: TCommandClass;
-} & Pick<TBlueprint, "property" | "propertyKey">> = {
-    [K in keyof TWorker as unknown extends TWorker[K] ? never : K]: TWorker[K];
-};
-type ToStaticCCValues<TCommandClass extends CommandClasses, TValues extends Record<keyof TValues, CCValueBlueprint>> = Readonly<{
-    [K in keyof TValues]: ExpandRecursively<InferStaticCCValue<TCommandClass, TValues[K]>>;
-}>;
-type ToDynamicCCValues<TCommandClass extends CommandClasses, TValues extends Record<keyof TValues, DynamicCCValueBlueprint<any>>> = Readonly<{
-    [K in keyof TValues]: ExpandRecursively<InferDynamicCCValue<TCommandClass, TValues[K]>>;
-}>;
 type InferArgs<T extends FnOrStatic<any, any>[]> = T extends [
     (...args: infer A) => any,
     ...any
 ] ? A : T extends [any, ...infer R] ? InferArgs<R> : [];
 export declare const V: {
-    /** Defines multiple static CC values that belong to the same CC */
-    defineStaticCCValues<TCommandClass extends CommandClasses, TValues extends Record<keyof TValues, CCValueBlueprint>>(commandClass: TCommandClass, values: TValues): TValues extends Record<keyof TValues, CCValueBlueprint> ? ExpandRecursively<ToStaticCCValues<TCommandClass, TValues>> : never;
-    /** Defines multiple static CC values that belong to the same CC */
-    defineDynamicCCValues<TCommandClass extends CommandClasses, TValues extends Record<keyof TValues, DynamicCCValueBlueprint<any>>>(commandClass: TCommandClass, values: TValues): TValues extends Record<keyof TValues, DynamicCCValueBlueprint<any>> ? ExpandRecursively<ToDynamicCCValues<TCommandClass, TValues>> : never;
     /** Returns a CC value definition that is named like the value `property` */
-    staticProperty<TProp extends string | number, TMeta extends ValueMetadata, TOptions extends CCValueOptions>(property: TProp, meta?: TMeta, options?: TOptions): { [K in TProp]: {
+    staticProperty<TProp extends string | number, const TMeta extends ValueMetadata, const TOptions extends CCValueOptions>(property: TProp, meta?: TMeta, options?: TOptions): { [K in TProp]: {
         property: TProp;
         meta: TMeta;
         options: TOptions;
     }; };
     /** Returns a CC value definition with the given name and `property` */
-    staticPropertyWithName<TName extends string, TProp extends string | number, TMeta extends ValueMetadata, TOptions extends CCValueOptions>(name: TName, property: TProp, meta?: TMeta, options?: TOptions): { [K in TName]: {
+    staticPropertyWithName<TName extends string, TProp extends string | number, const TMeta extends ValueMetadata, const TOptions extends CCValueOptions>(name: TName, property: TProp, meta?: TMeta, options?: TOptions): { [K in TName]: {
         property: TProp;
         meta: TMeta;
         options: TOptions;
@@ -96,7 +80,7 @@ export declare const V: {
         options: TOptions;
     }; };
     /** Returns a CC value definition with the given name and a dynamic `property` */
-    dynamicPropertyAndKeyWithName<TName extends string, TProp extends FnOrStatic<any[], ValueIDProperties["property"]>, TKey extends FnOrStatic<any[], ValueIDProperties["propertyKey"]>, TMeta extends FnOrStatic<any[], ValueMetadata> = ValueMetadata, TOptions extends FnOrStatic<any[], CCValueOptions> = CCValueOptions>(name: TName, property: TProp, propertyKey: TKey, is: PartialCCValuePredicate, meta?: TMeta, options?: TOptions): { [K in TName]: {
+    dynamicPropertyAndKeyWithName<TName extends string, TProp extends FnOrStatic<any[], ValueIDProperties["property"]>, TKey extends FnOrStatic<any[], ValueIDProperties["propertyKey"]>, TOptions extends CCValueOptions, TMeta extends FnOrStatic<any[], ValueMetadata> = ValueMetadata>(name: TName, property: TProp, propertyKey: TKey, is: PartialCCValuePredicate, meta?: TMeta, options?: TOptions): { [K in TName]: {
         (...args: InferArgs<[TProp, TKey, TMeta]>): {
             property: ReturnTypeOrStatic<TProp>;
             propertyKey: ReturnTypeOrStatic<TKey>;
@@ -105,6 +89,7 @@ export declare const V: {
         is: PartialCCValuePredicate;
         options: TOptions;
     }; };
+    defineCCValues: typeof defineCCValues;
 };
 export interface CCValueBlueprint extends Readonly<ValueIDProperties> {
     readonly meta?: Readonly<ValueMetadata>;
@@ -118,106 +103,22 @@ export interface DynamicCCValueBlueprint<TArgs extends any[]> {
     is: PartialCCValuePredicate;
     readonly options?: Readonly<CCValueOptions>;
 }
-type DropOptional<T> = {
-    [K in keyof T as [undefined] extends [T[K]] ? never : K]: T[K];
-};
-type MergeOptions<TOptions extends CCValueOptions> = DropOptional<CCValueOptions extends TOptions ? DefaultOptions : Overwrite<DefaultOptions, TOptions>>;
-type MergeMeta<TMeta extends ValueMetadata> = DropOptional<ValueMetadata extends TMeta ? (typeof ValueMetadata)["Any"] : Overwrite<(typeof ValueMetadata)["Any"], TMeta>>;
 /** The common base type of all CC value definitions */
 export interface CCValue {
     readonly id: Omit<ValueID, "endpoint">;
     endpoint(endpoint?: number): ValueID;
     readonly meta: ValueMetadata;
 }
-type AddCCValueProperties<TCommandClass extends CommandClasses, TBlueprint extends CCValueBlueprint, ValueIDBase extends Record<string, any> = InferValueIDBase<TCommandClass, TBlueprint>> = {
-    /** Returns the value ID of this CC value, without endpoint information */
-    get id(): ValueIDBase;
-    /** Returns the value ID, specialized to the given endpoint */
-    endpoint(endpoint?: number): Readonly<Pick<ValueIDBase, "commandClass"> & {
-        endpoint: number;
-    } & Omit<ValueIDBase, "commandClass">>;
-    /** Whether the given value ID matches this value definition */
-    is: CCValuePredicate;
-    /** Returns the metadata for this value ID */
-    get meta(): Readonly<MergeMeta<NonNullable<TBlueprint["meta"]>>>;
-    /** Returns the value options for this value ID */
-    get options(): Readonly<MergeOptions<NonNullable<TBlueprint["options"]>>>;
-};
-/** A CC value definition which depends on one or more parameters, transparently inferred from its arguments */
-export type InferDynamicCCValue<TCommandClass extends CommandClasses, TBlueprint extends DynamicCCValueBlueprint<any[]>> = TBlueprint extends DynamicCCValueBlueprint<infer TArgs> ? {
-    (...args: TArgs): Omit<InferStaticCCValue<TCommandClass, ReturnType<TBlueprint>>, "options" | "is">;
-    /** Whether the given value ID matches this value definition */
-    is: CCValuePredicate;
-    readonly options: InferStaticCCValue<TCommandClass, ReturnType<TBlueprint> & {
-        options: TBlueprint["options"];
-    }>["options"];
-} : never;
-/** A static or evaluated CC value definition, transparently inferred from its arguments */
-export type InferStaticCCValue<TCommandClass extends CommandClasses, TBlueprint extends CCValueBlueprint> = Readonly<AddCCValueProperties<TCommandClass, TBlueprint>>;
-/** The generic variant of {@link InferStaticCCValue}, without inferring arguments */
 export interface StaticCCValue extends CCValue {
     /** Whether the given value ID matches this value definition */
     is: CCValuePredicate;
     readonly options: Required<CCValueOptions>;
 }
-/** The generic variant of {@link InferDynamicCCValue}, without inferring arguments */
 export type DynamicCCValue<TArgs extends any[] = any[]> = ExpandRecursivelySkipMeta<(...args: TArgs) => CCValue> & {
     /** Whether the given value ID matches this value definition */
     is: CCValuePredicate;
     readonly options: Required<CCValueOptions>;
 };
 export type StaticCCValueFactory<T> = (self: T) => StaticCCValue;
-export interface CCValues {
-    "Alarm Sensor": typeof import("../cc/AlarmSensorCC.js").AlarmSensorCCValues;
-    Association: typeof import("../cc/AssociationCC.js").AssociationCCValues;
-    "Association Group Information": typeof import("../cc/AssociationGroupInfoCC.js").AssociationGroupInfoCCValues;
-    "Barrier Operator": typeof import("../cc/BarrierOperatorCC.js").BarrierOperatorCCValues;
-    Basic: typeof import("../cc/BasicCC.js").BasicCCValues;
-    Battery: typeof import("../cc/BatteryCC.js").BatteryCCValues;
-    "Binary Sensor": typeof import("../cc/BinarySensorCC.js").BinarySensorCCValues;
-    "Binary Switch": typeof import("../cc/BinarySwitchCC.js").BinarySwitchCCValues;
-    "Central Scene": typeof import("../cc/CentralSceneCC.js").CentralSceneCCValues;
-    "Climate Control Schedule": typeof import("../cc/ClimateControlScheduleCC.js").ClimateControlScheduleCCValues;
-    "Color Switch": typeof import("../cc/ColorSwitchCC.js").ColorSwitchCCValues;
-    Configuration: typeof import("../cc/ConfigurationCC.js").ConfigurationCCValues;
-    "Door Lock": typeof import("../cc/DoorLockCC.js").DoorLockCCValues;
-    "Door Lock Logging": typeof import("../cc/DoorLockLoggingCC.js").DoorLockLoggingCCValues;
-    "Energy Production": typeof import("../cc/EnergyProductionCC.js").EnergyProductionCCValues;
-    "Entry Control": typeof import("../cc/EntryControlCC.js").EntryControlCCValues;
-    "Firmware Update Meta Data": typeof import("../cc/FirmwareUpdateMetaDataCC.js").FirmwareUpdateMetaDataCCValues;
-    "Humidity Control Mode": typeof import("../cc/HumidityControlModeCC.js").HumidityControlModeCCValues;
-    "Humidity Control Operating State": typeof import("../cc/HumidityControlOperatingStateCC.js").HumidityControlOperatingStateCCValues;
-    "Humidity Control Setpoint": typeof import("../cc/HumidityControlSetpointCC.js").HumidityControlSetpointCCValues;
-    Indicator: typeof import("../cc/IndicatorCC.js").IndicatorCCValues;
-    Irrigation: typeof import("../cc/IrrigationCC.js").IrrigationCCValues;
-    Language: typeof import("../cc/LanguageCC.js").LanguageCCValues;
-    Lock: typeof import("../cc/LockCC.js").LockCCValues;
-    "Manufacturer Specific": typeof import("../cc/ManufacturerSpecificCC.js").ManufacturerSpecificCCValues;
-    Meter: typeof import("../cc/MeterCC.js").MeterCCValues;
-    "Multi Channel Association": typeof import("../cc/MultiChannelAssociationCC.js").MultiChannelAssociationCCValues;
-    "Multi Channel": typeof import("../cc/MultiChannelCC.js").MultiChannelCCValues;
-    "Multilevel Sensor": typeof import("../cc/MultilevelSensorCC.js").MultilevelSensorCCValues;
-    "Multilevel Switch": typeof import("../cc/MultilevelSwitchCC.js").MultilevelSwitchCCValues;
-    "Node Naming and Location": typeof import("../cc/NodeNamingCC.js").NodeNamingAndLocationCCValues;
-    Notification: typeof import("../cc/NotificationCC.js").NotificationCCValues;
-    Protection: typeof import("../cc/ProtectionCC.js").ProtectionCCValues;
-    "Scene Activation": typeof import("../cc/SceneActivationCC.js").SceneActivationCCValues;
-    "Scene Actuator Configuration": typeof import("../cc/SceneActuatorConfigurationCC.js").SceneActuatorConfigurationCCValues;
-    "Scene Controller Configuration": typeof import("../cc/SceneControllerConfigurationCC.js").SceneControllerConfigurationCCValues;
-    "Schedule Entry Lock": typeof import("../cc/ScheduleEntryLockCC.js").ScheduleEntryLockCCValues;
-    "Sound Switch": typeof import("../cc/SoundSwitchCC.js").SoundSwitchCCValues;
-    Supervision: typeof import("../cc/SupervisionCC.js").SupervisionCCValues;
-    "Thermostat Fan Mode": typeof import("../cc/ThermostatFanModeCC.js").ThermostatFanModeCCValues;
-    "Thermostat Fan State": typeof import("../cc/ThermostatFanStateCC.js").ThermostatFanStateCCValues;
-    "Thermostat Mode": typeof import("../cc/ThermostatModeCC.js").ThermostatModeCCValues;
-    "Thermostat Operating State": typeof import("../cc/ThermostatOperatingStateCC.js").ThermostatOperatingStateCCValues;
-    "Thermostat Setpoint": typeof import("../cc/ThermostatSetpointCC.js").ThermostatSetpointCCValues;
-    "Time Parameters": typeof import("../cc/TimeParametersCC.js").TimeParametersCCValues;
-    "User Code": typeof import("../cc/UserCodeCC.js").UserCodeCCValues;
-    Version: typeof import("../cc/VersionCC.js").VersionCCValues;
-    "Wake Up": typeof import("../cc/WakeUpCC.js").WakeUpCCValues;
-    "Window Covering": typeof import("../cc/WindowCoveringCC.js").WindowCoveringCCValues;
-    "Z-Wave Plus Info": typeof import("../cc/ZWavePlusCC.js").ZWavePlusCCValues;
-}
 export {};
 //# sourceMappingURL=Values.d.ts.map