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

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

@@ -0,0 +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/index.js\";\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\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\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\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 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/** 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\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\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 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/** 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": []
+}

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

@@ -0,0 +1,112 @@
+import { type CommandClasses } from "@zwave-js/core";
+import type { TypedClassDecorator, TypedPropertyDecorator } from "@zwave-js/shared";
+import type { APIConstructor, CCAPI } from "./API.js";
+import type { CCConstructor, CCResponsePredicate, CommandClass, DynamicCCResponse } from "./CommandClass.js";
+import type { DynamicCCValue, StaticCCValue, StaticCCValueFactory } from "./Values.js";
+/**
+ * @publicAPI
+ * Defines the CC ID associated with a Z-Wave Command Class
+ */
+export declare const commandClass: <TTarget extends CommandClass>(ccId: CommandClasses) => TypedClassDecorator<TTarget>;
+/**
+ * @publicAPI
+ * Looks up the command class constructor for a given CC ID
+ */
+export declare const getCCConstructor: (ccId: CommandClasses) => CCConstructor<CommandClass> | undefined;
+/**
+ * @publicAPI
+ * Defines the CC command a subclass of a CC implements
+ */
+export declare const CCCommand: <TTarget extends CommandClass>(ccCommand: number) => TypedClassDecorator<TTarget>;
+/**
+ * @publicAPI
+ * Retrieves the CC command a subclass of a CC implements
+ */
+export declare const getCCCommand: (target: CommandClass) => number | undefined;
+/**
+ * @publicAPI
+ * Looks up the command class constructor for a given CC ID and command
+ */
+export declare const getCCCommandConstructor: (ccId: CommandClasses, ccCommand: number) => CCConstructor<CommandClass> | undefined;
+/**
+ * @publicAPI
+ * Retrieves the CC ID defined for a Z-Wave Command Class
+ */
+export declare function getCommandClassStatic<T extends CCConstructor<CommandClass>>(classConstructor: T): CommandClasses;
+/**
+ * @publicAPI
+ * Defines the CC ID a CC API implementation belongs to
+ */
+export declare const API: <TTarget extends CCAPI>(cc: CommandClasses) => TypedClassDecorator<TTarget>;
+/**
+ * @publicAPI
+ * Retrieves the CC API constructor that is defined for a Z-Wave CC ID
+ */
+export declare function getAPI(cc: CommandClasses): APIConstructor | undefined;
+/**
+ * @publicAPI
+ * Retrieves the CC ID associated with a Z-Wave Command Class or CC API
+ */
+export declare function getCommandClass(cc: CommandClass | CCAPI): CommandClasses;
+/**
+ * @publicAPI
+ * Defines the implemented version of a Z-Wave command class
+ */
+export declare const implementedVersion: <TTarget extends CommandClass>(version: number) => TypedClassDecorator<TTarget>;
+/**
+ * @publicAPI
+ * Retrieves the implemented version defined for a Z-Wave command class
+ */
+export declare function getImplementedVersion<T extends CommandClass>(cc: T | CommandClasses): number;
+/**
+ * @publicAPI
+ * Retrieves the implemented version defined for a Z-Wave command class
+ */
+export declare function getImplementedVersionStatic<T extends CCConstructor<CommandClass>>(classConstructor: T): number;
+/**
+ * @publicAPI
+ * Defines the expected response associated with a Z-Wave message
+ */
+export declare function expectedCCResponse<TSent extends CommandClass, TReceived extends CommandClass>(cc: CCConstructor<TReceived> | DynamicCCResponse<TSent, TReceived>, predicate?: CCResponsePredicate<TSent, TReceived>): TypedClassDecorator<CommandClass>;
+/**
+ * @publicAPI
+ * Retrieves the expected response (static or dynamic) defined for a Z-Wave message class
+ */
+export declare function getExpectedCCResponse<T extends CommandClass>(ccClass: T): typeof CommandClass | DynamicCCResponse<T> | undefined;
+/**
+ * @publicAPI
+ * Retrieves the CC response predicate defined for a Z-Wave message class
+ */
+export declare function getCCResponsePredicate<T extends CommandClass>(ccClass: T): CCResponsePredicate<T> | undefined;
+/**
+ * @publicAPI
+ * Defines which CC value definitions belong to a Z-Wave command class
+ */
+export declare const ccValues: <TTarget extends CommandClass>(valueDefinition: Record<string, StaticCCValue | DynamicCCValue>) => TypedClassDecorator<TTarget>;
+/**
+ * @publicAPI
+ * Retrieves the CC value definitions which belong to a Z-Wave command class
+ */
+export declare function getCCValues<T extends CommandClass>(cc: T | CommandClasses): Record<string, StaticCCValue | DynamicCCValue | undefined> | undefined;
+/**
+ * @publicAPI
+ * Defines which CC value a Z-Wave command class property belongs to
+ */
+export declare function ccValue<TTarget extends CommandClass>(value: StaticCCValue): TypedPropertyDecorator<TTarget>;
+export declare function ccValue<TTarget extends CommandClass, TArgs extends any[]>(value: DynamicCCValue<TArgs>, getArgs: (self: TTarget) => Readonly<TArgs>): TypedPropertyDecorator<TTarget>;
+/**
+ * @publicAPI
+ * Retrieves the defined mapping between properties and CC values of a Z-Wave command class instance
+ */
+export declare function getCCValueProperties<TTarget extends CommandClass>(target: TTarget): ReadonlyMap<string | number, StaticCCValue | StaticCCValueFactory<TTarget>>;
+/**
+ * @publicAPI
+ * Defines that this CC may be sent supervised
+ */
+export declare const useSupervision: <TTarget extends CommandClass>() => TypedClassDecorator<TTarget>;
+/**
+ * @publicAPI
+ * Checks if the given CC may be sent supervised
+ */
+export declare const shouldUseSupervision: (target: CommandClass) => boolean;
+//# sourceMappingURL=CommandClassDecorators.d.ts.map

package/build/cjs/lib/CommandClassDecorators.js

@@ -0,0 +1,182 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var CommandClassDecorators_exports = {};
+__export(CommandClassDecorators_exports, {
+  API: () => API,
+  CCCommand: () => CCCommand,
+  ccValue: () => ccValue,
+  ccValues: () => ccValues,
+  commandClass: () => commandClass,
+  expectedCCResponse: () => expectedCCResponse,
+  getAPI: () => getAPI,
+  getCCCommand: () => getCCCommand,
+  getCCCommandConstructor: () => getCCCommandConstructor,
+  getCCConstructor: () => getCCConstructor,
+  getCCResponsePredicate: () => getCCResponsePredicate,
+  getCCValueProperties: () => getCCValueProperties,
+  getCCValues: () => getCCValues,
+  getCommandClass: () => getCommandClass,
+  getCommandClassStatic: () => getCommandClassStatic,
+  getExpectedCCResponse: () => getExpectedCCResponse,
+  getImplementedVersion: () => getImplementedVersion,
+  getImplementedVersionStatic: () => getImplementedVersionStatic,
+  implementedVersion: () => implementedVersion,
+  shouldUseSupervision: () => shouldUseSupervision,
+  useSupervision: () => useSupervision
+});
+module.exports = __toCommonJS(CommandClassDecorators_exports);
+var import_core = require("@zwave-js/core");
+const CCAndCommandDecorator = (0, import_core.createReflectionDecoratorPair)({ superName: "ccId", subName: "ccCommand" });
+const commandClass = CCAndCommandDecorator.superDecorator;
+const getCCConstructor = CCAndCommandDecorator.lookupSuperConstructor;
+const CCCommand = CCAndCommandDecorator.subDecorator;
+const getCCCommand = CCAndCommandDecorator.lookupSubValue;
+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);
+  }
+  return ret;
+}
+const apiDecorator = (0, import_core.createReflectionDecorator)({
+  name: "API",
+  valueFromArgs: (cc) => cc
+});
+const API = apiDecorator.decorator;
+function getAPI(cc) {
+  return apiDecorator.lookupConstructorByValue(cc);
+}
+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);
+  }
+  return ret;
+}
+const implementedVersionDecorator = (0, import_core.createReflectionDecorator)({
+  name: "implementedVersion",
+  valueFromArgs: (version) => version,
+  constructorLookupKey: false
+});
+const implementedVersion = implementedVersionDecorator.decorator;
+function getImplementedVersion(cc) {
+  let constr;
+  if (typeof cc === "number") {
+    constr = getCCConstructor(cc);
+  } else {
+    constr = cc.constructor;
+  }
+  if (!constr)
+    return 0;
+  return implementedVersionDecorator.lookupValueStatic(constr) ?? 0;
+}
+function getImplementedVersionStatic(classConstructor) {
+  return implementedVersionDecorator.lookupValueStatic(classConstructor) ?? 0;
+}
+const expectedCCResponseDecorator = (0, import_core.createReflectionDecorator)({
+  name: "expectedCCResponse",
+  valueFromArgs: (cc, predicate) => ({ cc, predicate }),
+  // We don't need reverse lookup
+  constructorLookupKey: false
+});
+function expectedCCResponse(cc, predicate) {
+  return expectedCCResponseDecorator.decorator(cc, predicate);
+}
+function getExpectedCCResponse(ccClass) {
+  return expectedCCResponseDecorator.lookupValue(ccClass)?.cc;
+}
+function getCCResponsePredicate(ccClass) {
+  return expectedCCResponseDecorator.lookupValue(ccClass)?.predicate;
+}
+const ccValuesDecorator = (0, import_core.createReflectionDecorator)({
+  name: "ccValues",
+  valueFromArgs: (valueDefinition) => valueDefinition,
+  // We don't need reverse lookup
+  constructorLookupKey: false
+});
+const ccValues = ccValuesDecorator.decorator;
+function getCCValues(cc) {
+  let constr;
+  if (typeof cc === "number") {
+    constr = getCCConstructor(cc);
+  } else {
+    constr = cc.constructor;
+  }
+  if (constr)
+    return ccValuesDecorator.lookupValueStatic(constr);
+}
+const ccValue_METADATA = Symbol.for(`METADATA_ccValue`);
+function ccValue(...args) {
+  let valueOrFactory;
+  if (args.length === 1) {
+    valueOrFactory = args[0];
+  } else {
+    const [value, getArgs] = args;
+    valueOrFactory = (self) => {
+      const args2 = getArgs(self);
+      const base = value(...args2);
+      return {
+        ...base,
+        is: value.is,
+        options: value.options
+      };
+    };
+  }
+  return function decoratorBody_ccValue(target, property) {
+    const constr = target.constructor;
+    const metadata = Reflect.getMetadata(ccValue_METADATA, constr) ?? /* @__PURE__ */ new Map();
+    metadata.set(property, valueOrFactory);
+    Reflect.defineMetadata(ccValue_METADATA, metadata, constr);
+  };
+}
+function getCCValueProperties(target) {
+  return Reflect.getMetadata(ccValue_METADATA, target.constructor) ?? /* @__PURE__ */ new Map();
+}
+const supervisionDecorator = (0, import_core.createValuelessReflectionDecorator)({
+  name: "useSupervision"
+});
+const useSupervision = supervisionDecorator.decorator;
+const shouldUseSupervision = supervisionDecorator.isDecorated;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  API,
+  CCCommand,
+  ccValue,
+  ccValues,
+  commandClass,
+  expectedCCResponse,
+  getAPI,
+  getCCCommand,
+  getCCCommandConstructor,
+  getCCConstructor,
+  getCCResponsePredicate,
+  getCCValueProperties,
+  getCCValues,
+  getCommandClass,
+  getCommandClassStatic,
+  getExpectedCCResponse,
+  getImplementedVersion,
+  getImplementedVersionStatic,
+  implementedVersion,
+  shouldUseSupervision,
+  useSupervision
+});
+//# sourceMappingURL=CommandClassDecorators.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/CommandClassDecorators.ts"],
+  "sourcesContent": ["import {\n\ttype CommandClasses,\n\tZWaveError,\n\tZWaveErrorCodes,\n\tcreateReflectionDecorator,\n\tcreateReflectionDecoratorPair,\n\tcreateValuelessReflectionDecorator,\n} from \"@zwave-js/core\";\nimport type {\n\tTypedClassDecorator,\n\tTypedPropertyDecorator,\n} from \"@zwave-js/shared\";\nimport type { APIConstructor, CCAPI } from \"./API.js\";\nimport type {\n\tCCConstructor,\n\tCCResponsePredicate,\n\tCommandClass,\n\tDynamicCCResponse,\n} from \"./CommandClass.js\";\nimport type {\n\tDynamicCCValue,\n\tStaticCCValue,\n\tStaticCCValueFactory,\n} from \"./Values.js\";\n\nconst CCAndCommandDecorator = createReflectionDecoratorPair<\n\tCommandClass,\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\tCCAPI,\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(constr)\n\t\t?? apiDecorator.lookupValueStatic(constr);\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\tCommandClass,\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\tCommandClass,\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\tTSent extends CommandClass,\n\tTReceived extends CommandClass,\n>(\n\tcc: CCConstructor<TReceived> | DynamicCCResponse<TSent, TReceived>,\n\tpredicate?: CCResponsePredicate<TSent, TReceived>,\n): TypedClassDecorator<CommandClass> {\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\tCommandClass,\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 */\nexport function ccValue<TTarget extends CommandClass>(\n\tvalue: StaticCCValue,\n): TypedPropertyDecorator<TTarget>;\n\nexport 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.\nexport 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\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\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<CommandClass>({\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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",
+  "names": ["args"]
+}

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

@@ -0,0 +1,22 @@
+import { CommandClass } from "./CommandClass.js";
+export type EncapsulatedCommandClass = CommandClass & {
+    encapsulatingCC: EncapsulatingCommandClass;
+};
+export type EncapsulatingCommandClass = CommandClass & {
+    encapsulated: EncapsulatedCommandClass;
+};
+/**
+ * Tests if a given CC statically implements the EncapsulatingCommandClassStatic interface
+ * @param cc The command class instance to test
+ */
+export declare function isEncapsulatingCommandClass(cc: any): cc is CommandClass & EncapsulatingCommandClass;
+export declare function getInnermostCommandClass(cc: CommandClass): CommandClass;
+export interface MultiEncapsulatingCommandClass {
+    encapsulated: EncapsulatedCommandClass[];
+}
+/**
+ * Tests if a given CC statically implements the EncapsulatingCommandClassStatic interface
+ * @param cc The command class instance to test
+ */
+export declare function isMultiEncapsulatingCommandClass(cc: any): cc is CommandClass & MultiEncapsulatingCommandClass;
+//# sourceMappingURL=EncapsulatingCommandClass.d.ts.map

package/build/cjs/lib/EncapsulatingCommandClass.js

@@ -0,0 +1,71 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var EncapsulatingCommandClass_exports = {};
+__export(EncapsulatingCommandClass_exports, {
+  getInnermostCommandClass: () => getInnermostCommandClass,
+  isEncapsulatingCommandClass: () => isEncapsulatingCommandClass,
+  isMultiEncapsulatingCommandClass: () => isMultiEncapsulatingCommandClass
+});
+module.exports = __toCommonJS(EncapsulatingCommandClass_exports);
+var import_typeguards = require("alcalzone-shared/typeguards/index.js");
+var import_CommandClass = require("./CommandClass.js");
+function isEncapsulatingCommandClass(cc) {
+  if (!(cc instanceof import_CommandClass.CommandClass))
+    return false;
+  if (!(cc.encapsulated instanceof import_CommandClass.CommandClass)) {
+    return false;
+  }
+  let proto = Object.getPrototypeOf(cc.constructor);
+  while (proto) {
+    if (typeof proto.encapsulate === "function") {
+      return true;
+    }
+    proto = Object.getPrototypeOf(proto);
+  }
+  return false;
+}
+function getInnermostCommandClass(cc) {
+  if (isEncapsulatingCommandClass(cc)) {
+    return getInnermostCommandClass(cc.encapsulated);
+  } else {
+    return cc;
+  }
+}
+function isMultiEncapsulatingCommandClass(cc) {
+  if (!(cc instanceof import_CommandClass.CommandClass))
+    return false;
+  if (!((0, import_typeguards.isArray)(cc.encapsulated) && cc.encapsulated.every((item) => item instanceof import_CommandClass.CommandClass))) {
+    return false;
+  }
+  let proto = Object.getPrototypeOf(cc.constructor);
+  while (proto) {
+    if (typeof proto.encapsulate === "function") {
+      return true;
+    }
+    proto = Object.getPrototypeOf(proto);
+  }
+  return false;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getInnermostCommandClass,
+  isEncapsulatingCommandClass,
+  isMultiEncapsulatingCommandClass
+});
+//# sourceMappingURL=EncapsulatingCommandClass.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/EncapsulatingCommandClass.ts"],
+  "sourcesContent": ["import { isArray } from \"alcalzone-shared/typeguards/index.js\";\nimport { CommandClass } from \"./CommandClass.js\";\n\nexport type EncapsulatedCommandClass = CommandClass & {\n\tencapsulatingCC: EncapsulatingCommandClass;\n};\n\nexport type EncapsulatingCommandClass = CommandClass & {\n\tencapsulated: EncapsulatedCommandClass;\n};\n\n/**\n * Tests if a given CC statically implements the EncapsulatingCommandClassStatic interface\n * @param cc The command class instance to test\n */\nexport function isEncapsulatingCommandClass(\n\tcc: any,\n): cc is CommandClass & EncapsulatingCommandClass {\n\t// To satisfy the criterion, cc must be a CommandClass\n\tif (!(cc instanceof CommandClass)) return false;\n\t// The encapsulated property must be a CommandClass\n\tif (!((cc as any).encapsulated instanceof CommandClass)) {\n\t\treturn false;\n\t}\n\n\t// Walk up the static side of the prototype chain to see if it has the required methods\n\tlet proto: any = Object.getPrototypeOf(cc.constructor);\n\twhile (proto) {\n\t\tif (typeof proto.encapsulate === \"function\") {\n\t\t\treturn true;\n\t\t}\n\t\tproto = Object.getPrototypeOf(proto);\n\t}\n\treturn false;\n}\n\nexport function getInnermostCommandClass(cc: CommandClass): CommandClass {\n\tif (isEncapsulatingCommandClass(cc)) {\n\t\treturn getInnermostCommandClass(cc.encapsulated);\n\t} else {\n\t\treturn cc;\n\t}\n}\n\nexport interface MultiEncapsulatingCommandClass {\n\tencapsulated: EncapsulatedCommandClass[];\n}\n\n/**\n * Tests if a given CC statically implements the EncapsulatingCommandClassStatic interface\n * @param cc The command class instance to test\n */\nexport function isMultiEncapsulatingCommandClass(\n\tcc: any,\n): cc is CommandClass & MultiEncapsulatingCommandClass {\n\t// To satisfy the criterion, cc must be a CommandClass\n\tif (!(cc instanceof CommandClass)) return false;\n\t// The encapsulated property must  array of CCs\n\tif (\n\t\t!(\n\t\t\tisArray((cc as any).encapsulated)\n\t\t\t&& (cc as any).encapsulated.every(\n\t\t\t\t(item: any) => item instanceof CommandClass,\n\t\t\t)\n\t\t)\n\t) {\n\t\treturn false;\n\t}\n\n\t// Walk up the static side of the prototype chain to see if it has the required methods\n\tlet proto: any = Object.getPrototypeOf(cc.constructor);\n\twhile (proto) {\n\t\tif (typeof proto.encapsulate === \"function\") {\n\t\t\treturn true;\n\t\t}\n\t\tproto = Object.getPrototypeOf(proto);\n\t}\n\treturn false;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;;;;;;;AAAA,wBAAwB;AACxB,0BAA6B;AAcvB,SAAU,4BACf,IAAO;AAGP,MAAI,EAAE,cAAc;AAAe,WAAO;AAE1C,MAAI,EAAG,GAAW,wBAAwB,mCAAe;AACxD,WAAO;EACR;AAGA,MAAI,QAAa,OAAO,eAAe,GAAG,WAAW;AACrD,SAAO,OAAO;AACb,QAAI,OAAO,MAAM,gBAAgB,YAAY;AAC5C,aAAO;IACR;AACA,YAAQ,OAAO,eAAe,KAAK;EACpC;AACA,SAAO;AACR;AAEM,SAAU,yBAAyB,IAAgB;AACxD,MAAI,4BAA4B,EAAE,GAAG;AACpC,WAAO,yBAAyB,GAAG,YAAY;EAChD,OAAO;AACN,WAAO;EACR;AACD;AAUM,SAAU,iCACf,IAAO;AAGP,MAAI,EAAE,cAAc;AAAe,WAAO;AAE1C,MACC,MACC,2BAAS,GAAW,YAAY,KAC5B,GAAW,aAAa,MAC3B,CAAC,SAAc,gBAAgB,gCAAY,IAG5C;AACD,WAAO;EACR;AAGA,MAAI,QAAa,OAAO,eAAe,GAAG,WAAW;AACrD,SAAO,OAAO;AACb,QAAI,OAAO,MAAM,gBAAgB,YAAY;AAC5C,aAAO;IACR;AACA,YAAQ,OAAO,eAAe,KAAK;EACpC;AACA,SAAO;AACR;",
+  "names": []
+}

package/build/cjs/lib/ICommandClassContainer.js

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ICommandClassContainer_exports = {};
+module.exports = __toCommonJS(ICommandClassContainer_exports);
+//# sourceMappingURL=ICommandClassContainer.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../esm/lib/ICommandClassContainer.js"],
+  "sourcesContent": ["export {};\n//# sourceMappingURL=ICommandClassContainer.js.map"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

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

@@ -0,0 +1,10 @@
+import type { Duration } from "@zwave-js/core";
+import type { CommandClass } from "./CommandClass.js";
+export interface NotificationEventPayload {
+    toNotificationEventParameters(): Uint8Array | Duration | Record<string, number>;
+}
+/**
+ * Tests if the given message contains a CC
+ */
+export declare function isNotificationEventPayload<T extends CommandClass>(msg: T): msg is T & NotificationEventPayload;
+//# sourceMappingURL=NotificationEventPayload.d.ts.map

package/build/cjs/lib/NotificationEventPayload.js

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var NotificationEventPayload_exports = {};
+__export(NotificationEventPayload_exports, {
+  isNotificationEventPayload: () => isNotificationEventPayload
+});
+module.exports = __toCommonJS(NotificationEventPayload_exports);
+function isNotificationEventPayload(msg) {
+  return typeof msg.toNotificationEventParameters === "function";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  isNotificationEventPayload
+});
+//# sourceMappingURL=NotificationEventPayload.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/lib/NotificationEventPayload.ts"],
+  "sourcesContent": ["import type { Duration } from \"@zwave-js/core\";\nimport type { CommandClass } from \"./CommandClass.js\";\n\nexport interface NotificationEventPayload {\n\ttoNotificationEventParameters():\n\t\t| Uint8Array\n\t\t| Duration\n\t\t| Record<string, number>;\n}\n\n/**\n * Tests if the given message contains a CC\n */\nexport function isNotificationEventPayload<T extends CommandClass>(\n\tmsg: T,\n): msg is T & NotificationEventPayload {\n\treturn typeof (msg as any).toNotificationEventParameters === \"function\";\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAUA;;;;;AAGM,SAAU,2BACf,KAAM;AAEN,SAAO,OAAQ,IAAY,kCAAkC;AAC9D;",
+  "names": []
+}