@matter/protocol 0.12.4-alpha.0-20250210-ad8edf096 → 0.12.4-alpha.0-20250212-b2729c9eb

package/dist/esm/action/request/Invoke.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ClusterType, CommandData, InvokeRequest, TlvSchema, TypeFromSchema } from "#types";
+import { Specifier } from "./Specifier.js";
+export interface Invoke extends InvokeRequest {
+    timeout?: number;
+}
+/**
+ * Request invocation of one or more commands.
+ */
+export declare function Invoke(definition: Invoke.Definition): Invoke;
+export declare namespace Invoke {
+    interface Definition {
+        commands: CommandData[];
+        suppressResponse?: boolean;
+        timed?: boolean;
+        interactionModelRevision?: number;
+    }
+    function Command<const C extends ClusterType>(request: Invoke.CommandRequest<C>): CommandData;
+    type CommandRequest<C extends Specifier.Cluster = Specifier.Cluster, CMD extends Specifier.Command<Specifier.ClusterFor<C>> = Specifier.Command<Specifier.ClusterFor<C>>> = {
+        endpoint?: Specifier.Endpoint;
+        cluster: C;
+        command: CMD;
+    } & Fields<Specifier.CommandFor<Specifier.ClusterFor<C>, CMD>["requestSchema"]>;
+    function commandOf<const R extends CommandRequest>(request: R): ClusterType.Command;
+    type Fields<S extends TlvSchema<any>> = S extends TlvSchema<void> ? {} : S extends TlvSchema<null> ? {
+        fields?: TypeFromSchema<S>;
+    } : {
+        fields: TypeFromSchema<S>;
+    };
+}
+//# sourceMappingURL=Invoke.d.ts.map

package/dist/esm/action/request/Invoke.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Invoke.d.ts","sourceRoot":"","sources":["../../../../src/action/request/Invoke.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAE5F,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,MAAO,SAAQ,aAAa;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAkB5D;AAED,yBAAiB,MAAM,CAAC;IACpB,UAAiB,UAAU;QACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACrC;IAED,SAAgB,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW,CAcnG;IAED,KAAY,cAAc,CACtB,CAAC,SAAS,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,EAC/C,GAAG,SAAS,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IACnG;QACA,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC;QAC9B,OAAO,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,GAAG,CAAC;KAChB,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;IAEhF,SAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,WAAW,CAAC,OAAO,CAazF;IAED,KAAY,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,IACvC,CAAC,SAAS,SAAS,CAAC,IAAI,CAAC,GACnB,EAAE,GACF,CAAC,SAAS,SAAS,CAAC,IAAI,CAAC,GACvB;QAAE,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;KAAE,GAC9B;QAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;CAC7C"}

package/dist/esm/action/request/Invoke.js

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FALLBACK_INTERACTIONMODEL_REVISION } from "#session/Session.js";
+import { MalformedRequestError } from "./MalformedRequestError.js";
+import { Specifier } from "./Specifier.js";
+function Invoke(definition) {
+  const {
+    commands,
+    interactionModelRevision = FALLBACK_INTERACTIONMODEL_REVISION,
+    suppressResponse = false,
+    timed: timedRequest = false
+  } = definition;
+  if (!commands?.length) {
+    throw new MalformedRequestError(`Invocation requires at least one command`);
+  }
+  return {
+    invokeRequests: commands,
+    interactionModelRevision,
+    suppressResponse,
+    timedRequest
+  };
+}
+((Invoke2) => {
+  function Command(request) {
+    const result = {
+      commandPath: {
+        clusterId: Specifier.clusterFor(request.cluster).id,
+        commandId: Invoke2.commandOf(request).requestId
+      }
+    };
+    const endpointId = Specifier.endpointIdOf(request);
+    if (endpointId !== void 0) {
+      result.commandPath.endpointId = endpointId;
+    }
+    return result;
+  }
+  Invoke2.Command = Command;
+  function commandOf(request) {
+    if (typeof request.command === "string") {
+      const cluster = Specifier.clusterFor(request.cluster);
+      if (cluster === void 0) {
+        throw new MalformedRequestError(`Cannot designate command "${request.command}" without cluster`);
+      }
+      const command = cluster.commands[request.command];
+      if (command === void 0) {
+        throw new MalformedRequestError(`Cluster ${cluster.name} does not define command ${request.command}`);
+      }
+      return command;
+    }
+    return request.command;
+  }
+  Invoke2.commandOf = commandOf;
+})(Invoke || (Invoke = {}));
+export {
+  Invoke
+};
+//# sourceMappingURL=Invoke.js.map

package/dist/esm/action/request/Invoke.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/request/Invoke.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,0CAA0C;AAEnD,SAAS,6BAA6B;AACtC,SAAS,iBAAiB;AASnB,SAAS,OAAO,YAAuC;AAC1D,QAAM;AAAA,IACF;AAAA,IACA,2BAA2B;AAAA,IAC3B,mBAAmB;AAAA,IACnB,OAAO,eAAe;AAAA,EAC1B,IAAI;AAEJ,MAAI,CAAC,UAAU,QAAQ;AACnB,UAAM,IAAI,sBAAsB,0CAA0C;AAAA,EAC9E;AAEA,SAAO;AAAA,IACH,gBAAgB;AAAA,IAChB;AAAA,IACA;AAAA,IACA;AAAA,EACJ;AACJ;AAAA,CAEO,CAAUA,YAAV;AAQI,WAAS,QAAqC,SAAgD;AACjG,UAAM,SAAsB;AAAA,MACxB,aAAa;AAAA,QACT,WAAW,UAAU,WAAW,QAAQ,OAAO,EAAE;AAAA,QACjD,WAAWA,QAAO,UAAU,OAAO,EAAE;AAAA,MACzC;AAAA,IACJ;AAEA,UAAM,aAAa,UAAU,aAAa,OAAO;AACjD,QAAI,eAAe,QAAW;AAC1B,aAAO,YAAY,aAAa;AAAA,IACpC;AAEA,WAAO;AAAA,EACX;AAdO,EAAAA,QAAS;AAyBT,WAAS,UAA0C,SAAiC;AACvF,QAAI,OAAO,QAAQ,YAAY,UAAU;AACrC,YAAM,UAAU,UAAU,WAAW,QAAQ,OAAO;AACpD,UAAI,YAAY,QAAW;AACvB,cAAM,IAAI,sBAAsB,6BAA6B,QAAQ,OAAO,mBAAmB;AAAA,MACnG;AACA,YAAM,UAAU,QAAQ,SAAS,QAAQ,OAAO;AAChD,UAAI,YAAY,QAAW;AACvB,cAAM,IAAI,sBAAsB,WAAW,QAAQ,IAAI,4BAA4B,QAAQ,OAAO,EAAE;AAAA,MACxG;AACA,aAAO;AAAA,IACX;AACA,WAAO,QAAQ;AAAA,EACnB;AAbO,EAAAA,QAAS;AAAA,GAjCH;",
+  "names": ["Invoke"]
+}

package/dist/esm/action/request/MalformedRequestError.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError } from "#general";
+/**
+ * Thrown when an action request does not adhere to the Matter specification.
+ *
+ * This is a client-side error that throws while formulating a request.
+ */
+export declare class MalformedRequestError extends ImplementationError {
+}
+//# sourceMappingURL=MalformedRequestError.d.ts.map

package/dist/esm/action/request/MalformedRequestError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MalformedRequestError.d.ts","sourceRoot":"","sources":["../../../../src/action/request/MalformedRequestError.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;GAIG;AACH,qBAAa,qBAAsB,SAAQ,mBAAmB;CAAG"}

package/dist/esm/action/request/MalformedRequestError.js

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ImplementationError } from "#general";
+class MalformedRequestError extends ImplementationError {
+}
+export {
+  MalformedRequestError
+};
+//# sourceMappingURL=MalformedRequestError.js.map

package/dist/esm/action/request/MalformedRequestError.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/request/MalformedRequestError.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,2BAA2B;AAO7B,MAAM,8BAA8B,oBAAoB;AAAC;",
+  "names": []
+}

package/dist/esm/action/request/Read.d.ts

@@ -0,0 +1,141 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AttributePath, ClusterType, DataVersionFilter, EventFilter, EventPath, GlobalAttributes, ReadRequest } from "#types";
+import { Specifier } from "./Specifier.js";
+/**
+ * A read request formulated using Matter protocol semantics.
+ */
+export interface Read extends ReadRequest {
+}
+/**
+ * Formulate a read request using Matter numeric IDs.
+ */
+export declare function Read(options: Read.Options): Read;
+/**
+ * Formulate a read request with extended options and name-based IDs.
+ */
+export declare function Read(options: Read.Options, ...selectors: Read.Selector[]): Read;
+/**
+ * Formulate a read request with name-based IDs.
+ */
+export declare function Read(...selectors: Read.Selector[]): Read;
+export declare namespace Read {
+    interface Options {
+        attributes?: AttributePath[];
+        versionFilters?: DataVersionFilter[];
+        events?: EventPath[];
+        eventFilters?: EventFilter[];
+        fabricFilter?: boolean;
+        interactionModelRevision?: number;
+    }
+    interface Attributes extends Read {
+        attributeRequests: Exclude<Read["attributeRequests"], undefined>;
+    }
+    function isAttribute(request: Read): request is Attributes;
+    interface Events extends Read {
+        eventRequests: Exclude<Read["eventRequests"], undefined>;
+    }
+    function isEvent(request: Read): request is Events;
+    /**
+     * Selects attributes or events to read.
+     */
+    type Selector<C extends Specifier.Cluster = Specifier.Cluster> = ({
+        kind: "attribute";
+    } & AttributeSelector<C>) | ({
+        kind: "event";
+    } & EventSelector<C>);
+    /**
+     * Selects attributes to read.  Limits fields to legal permutations per the Matter specification.
+     */
+    type AttributeSelector<C extends Specifier.Cluster = Specifier.Cluster> = AttributeSelector.Concrete<C> | AttributeSelector.FullWildcard | AttributeSelector.Global | AttributeSelector.WildcardEndpoint<C> | AttributeSelector.WildcardAttribute | AttributeSelector.Endpoint;
+    /**
+     * Selects events to read.  Limits fields to legal permutations per the Matter specification.
+     */
+    type EventSelector<C extends Specifier.Cluster = Specifier.Cluster> = EventSelector.Concrete<C> | EventSelector.FullWildcard | EventSelector.WildcardEndpoint<C> | EventSelector.WildcardEvent | EventSelector.Endpoint;
+    function Attribute<const C extends ClusterType>(selector?: AttributeSelector<C>): {
+        kind: "attribute";
+    } & AttributeSelector<C>;
+    function Event<const T extends EventSelector>(selector: T): {
+        kind: "event";
+    } & T;
+    interface WildcardFlags {
+        skipRoot?: boolean;
+        skipCustom?: boolean;
+        skipDiagnostics?: boolean;
+        skipGlobals?: boolean;
+        skipAttributeList?: boolean;
+        skipCommandList?: boolean;
+        skipFixed?: boolean;
+        skipChangesOmitted?: boolean;
+    }
+    type GlobalAttributeSpecifier = ClusterType.Attribute | keyof GlobalAttributes<any>;
+    namespace AttributeSelector {
+        interface Concrete<C extends Specifier.Cluster> {
+            endpoint: Specifier.Endpoint;
+            cluster: C;
+            attributes: Specifier.Attribute<Specifier.ClusterFor<C>> | Specifier.Attribute<Specifier.ClusterFor<C>>[];
+        }
+        interface Wildcard {
+            flags?: WildcardFlags;
+        }
+        interface FullWildcard extends Wildcard {
+            endpoint?: undefined;
+            cluster?: undefined;
+            attributes?: undefined;
+        }
+        interface Global extends Wildcard {
+            endpoint?: Specifier.Endpoint;
+            cluster?: undefined;
+            attributes: GlobalAttributeSpecifier | GlobalAttributeSpecifier[];
+        }
+        interface WildcardEndpoint<C extends Specifier.Cluster> extends Wildcard {
+            endpoint?: undefined;
+            cluster: C;
+            attributes: Specifier.Attribute<Specifier.ClusterFor<C>> | Specifier.Attribute<Specifier.ClusterFor<C>>[];
+        }
+        interface WildcardAttribute extends Wildcard {
+            endpoint?: Specifier.Endpoint;
+            cluster: Specifier.Cluster;
+            attributes?: undefined;
+        }
+        interface Endpoint extends Wildcard {
+            endpoint: Specifier.Endpoint;
+            cluster?: undefined;
+            attributes?: undefined;
+        }
+    }
+    namespace EventSelector {
+        interface Concrete<C extends Specifier.Cluster> {
+            endpoint: Specifier.Endpoint;
+            cluster: Specifier.Cluster;
+            events: Specifier.Event<Specifier.ClusterFor<C>> | Specifier.Event<Specifier.ClusterFor<C>>[];
+        }
+        interface Wildcard {
+            flags?: WildcardFlags;
+        }
+        interface FullWildcard extends Wildcard {
+            endpoint?: undefined;
+            cluster?: undefined;
+            events?: undefined;
+        }
+        interface WildcardEndpoint<C extends Specifier.Cluster> extends Wildcard {
+            endpoint?: undefined;
+            cluster: Specifier.Cluster;
+            events: Specifier.Event<Specifier.ClusterFor<C>> | Specifier.Event<Specifier.ClusterFor<C>>[];
+        }
+        interface WildcardEvent extends Wildcard {
+            endpoint: Specifier.Endpoint;
+            cluster: Specifier.Cluster;
+            events?: undefined;
+        }
+        interface Endpoint extends Wildcard {
+            endpoint: Specifier.Endpoint;
+            cluster?: undefined;
+            events?: undefined;
+        }
+    }
+}
+//# sourceMappingURL=Read.d.ts.map

package/dist/esm/action/request/Read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Read.d.ts","sourceRoot":"","sources":["../../../../src/action/request/Read.ts"],"names":[],"mappings":"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"}

package/dist/esm/action/request/Read.js

@@ -0,0 +1,153 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FALLBACK_INTERACTIONMODEL_REVISION } from "#session/Session.js";
+import { camelize } from "@matter/general";
+import { MalformedRequestError } from "./MalformedRequestError.js";
+import { Specifier } from "./Specifier.js";
+function Read(optionsOrSelector, ...selectors) {
+  let options;
+  if ("kind" in optionsOrSelector) {
+    selectors = [optionsOrSelector, ...selectors];
+    options = {};
+  } else {
+    options = optionsOrSelector;
+  }
+  let { attributes: attributeRequests, versionFilters, events: eventRequests, eventFilters } = options;
+  const result = {
+    isFabricFiltered: options.fabricFilter ?? true,
+    interactionModelRevision: options.interactionModelRevision ?? FALLBACK_INTERACTIONMODEL_REVISION
+  };
+  for (const selector of selectors) {
+    reifySelector(selector);
+  }
+  if (!attributeRequests?.length && !eventRequests?.length) {
+    throw new MalformedRequestError(`Read action designates no attributes or events`);
+  }
+  if (attributeRequests) {
+    result.attributeRequests = attributeRequests;
+  }
+  if (versionFilters) {
+    result.dataVersionFilters = versionFilters;
+  }
+  if (eventRequests) {
+    result.eventRequests = eventRequests;
+  }
+  if (eventFilters !== void 0) {
+    result.eventFilters = eventFilters;
+  }
+  return result;
+  function reifySelector(selector) {
+    switch (selector.kind) {
+      case "attribute":
+        reifyAttributeSelector(selector);
+        break;
+      case "event":
+        reifyEventSelector(selector);
+        break;
+      default:
+        throw new MalformedRequestError(`Invalid selector kind "${selector.kind}"`);
+    }
+  }
+  function reifyAttributeSelector(selector) {
+    const cluster = Specifier.clusterOf(selector);
+    const { endpoint } = selector;
+    if (typeof endpoint === "object" && endpoint?.versions && typeof cluster === "object" && cluster !== null) {
+      const version = endpoint.versions?.[camelize(cluster.name)];
+      if (version !== void 0) {
+        const filter = {
+          path: { endpointId: endpoint.number, clusterId: cluster.id },
+          dataVersion: version
+        };
+        if (versionFilters === void 0) {
+          versionFilters = [filter];
+        } else if (versionFilters.find(
+          ({ path: { endpointId, clusterId } }) => endpointId === endpoint.number && clusterId === cluster.id
+        ) === void 0) {
+          versionFilters.push(filter);
+        }
+      }
+    }
+    if (attributeRequests === void 0) {
+      attributeRequests = [];
+    }
+    const prototype = {};
+    if (endpoint !== void 0) {
+      prototype.endpointId = Specifier.endpointIdOf(selector);
+    }
+    if (cluster !== void 0) {
+      prototype.clusterId = cluster.id;
+    }
+    let { attributes } = selector;
+    if (attributes === void 0) {
+      attributeRequests.push(prototype);
+      return;
+    }
+    if (!Array.isArray(attributes)) {
+      attributes = [attributes];
+    }
+    for (const specifier of attributes) {
+      attributeRequests.push({ ...prototype, attributeId: Specifier.attributeFor(cluster, specifier).id });
+    }
+  }
+  function reifyEventSelector(selector) {
+    const cluster = Specifier.clusterOf(selector);
+    const { endpoint } = selector;
+    if (typeof endpoint === "object" && endpoint.minEvent !== void 0) {
+      if (eventFilters === void 0) {
+        eventFilters = [{ eventMin: endpoint.minEvent }];
+      }
+    }
+    if (eventRequests === void 0) {
+      eventRequests = [];
+    }
+    const prototype = {};
+    if (endpoint !== void 0) {
+      prototype.endpointId = Specifier.endpointIdOf(selector);
+    }
+    if (cluster !== void 0) {
+      prototype.clusterId = cluster.id;
+    }
+    let { events } = selector;
+    if (events === void 0) {
+      eventRequests.push(prototype);
+      return;
+    }
+    if (!Array.isArray(events)) {
+      events = [events];
+    }
+    for (const specifier of events) {
+      eventRequests.push({ ...prototype, eventId: Specifier.eventFor(cluster, specifier).id });
+    }
+  }
+}
+((Read2) => {
+  function isAttribute(request) {
+    return !!request.attributeRequests?.length;
+  }
+  Read2.isAttribute = isAttribute;
+  function isEvent(request) {
+    return !!request.eventRequests?.length;
+  }
+  Read2.isEvent = isEvent;
+  function Attribute(selector) {
+    return {
+      kind: "attribute",
+      ...selector
+    };
+  }
+  Read2.Attribute = Attribute;
+  function Event(selector) {
+    return {
+      kind: "event",
+      ...selector
+    };
+  }
+  Read2.Event = Event;
+})(Read || (Read = {}));
+export {
+  Read
+};
+//# sourceMappingURL=Read.js.map

package/dist/esm/action/request/Read.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/request/Read.ts"],
+  "mappings": "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",
+  "names": ["Read"]
+}

package/dist/esm/action/request/Specifier.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ClusterType, EndpointNumber, GlobalAttributeNames } from "#types";
+/**
+ * A "specifier" addresses a specific element of the Matter data model in the context of a request.
+ */
+export declare namespace Specifier {
+    /**
+     * Clusters we designate with an object to convey structural and type information.  The second form of this union
+     * allows for specification with a host object (such as a ClusterBehavior instance or class).
+     */
+    type Cluster = ClusterType | {
+        cluster: ClusterType;
+    };
+    /**
+     * You may address endpoints with a bare ID but the object form allows an "endpoint object" as input and optionally
+     * conveys additional metadata.
+     */
+    type Endpoint = EndpointNumber | {
+        number: EndpointNumber;
+        versions?: Record<string, number>;
+        minEvent?: number;
+    };
+    /**
+     * An attribute specifier may be the name of a cluster attribute or the name of a cluster or global attribute.
+     */
+    type Attribute<C extends ClusterType = ClusterType> = ClusterType.Attribute | (string & keyof C["attributes"]) | GlobalAttributeNames<any>;
+    /**
+     * A command specifier may be the name of a cluster attribute or the name of a cluster command.
+     */
+    type Command<C extends ClusterType = ClusterType> = ClusterType.Command | (string & keyof C["commands"]);
+    /**
+     * An event specifier may be the name of a cluser event or an event object.
+     */
+    type Event<C extends ClusterType = ClusterType> = ClusterType.Event | (string & keyof C["events"]);
+    /**
+     * Extract a cluster type from a cluster specifier type.
+     */
+    type ClusterFor<T extends Cluster> = T extends ClusterType ? T : T extends {
+        cluster: ClusterType;
+    } ? T["cluster"] : never;
+    /**
+     * Extract a cluster type from a cluster specifier.
+     */
+    function clusterFor<const T extends Cluster>(specifier: T): ClusterFor<T>;
+    /**
+     * Extract an attribute object from a cluster and attribute specifier.
+     */
+    function attributeFor(cluster: ClusterType | undefined, specifier: Specifier.Attribute): ClusterType.Attribute;
+    /**
+     * Extract a command type from a cluster type and command specifier.
+     */
+    type CommandFor<C extends ClusterType, CMD extends Specifier.Command<C>> = CMD extends string ? C["commands"][CMD] : CMD extends ClusterType.Command ? CMD : never;
+    /**
+     * Extract an event object from a cluster and event specifier.
+     */
+    function eventFor(cluster: ClusterType | undefined, specifier: Specifier.Event): ClusterType.Event;
+    /**
+     * Extract the cluster type from a cluster request type.
+     */
+    type ClusterOf<T extends {
+        cluster?: Cluster;
+    }> = T extends {
+        cluster: Specifier.Cluster;
+    } ? Specifier.ClusterFor<T["cluster"]> : undefined;
+    /**
+     * Extract the cluster type from an element request.
+     */
+    function clusterOf<const T extends {
+        cluster?: Cluster;
+    }>(request: T): ClusterOf<T>;
+    /**
+     * Determine endpoint number for an object with an endpoint specifier.
+     */
+    function endpointIdOf<const T extends {
+        endpoint?: Endpoint;
+    }>(request: T): EndpointNumber | undefined;
+}
+//# sourceMappingURL=Specifier.d.ts.map

package/dist/esm/action/request/Specifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Specifier.d.ts","sourceRoot":"","sources":["../../../../src/action/request/Specifier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,oBAAoB,EAAoB,MAAM,QAAQ,CAAC;AAK7F;;GAEG;AACH,yBAAiB,SAAS,CAAC;IACvB;;;OAGG;IACH,KAAY,OAAO,GAAG,WAAW,GAAG;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,CAAC;IAE7D;;;OAGG;IACH,KAAY,QAAQ,GACd,cAAc,GACd;QAAE,MAAM,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEvF;;OAEG;IACH,KAAY,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IACnD,WAAW,CAAC,SAAS,GACrB,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,GAChC,oBAAoB,CAAC,GAAG,CAAC,CAAC;IAEhC;;OAEG;IACH,KAAY,OAAO,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,WAAW,CAAC,OAAO,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAEhH;;OAEG;IACH,KAAY,KAAK,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,IAAI,WAAW,CAAC,KAAK,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE1G;;OAEG;IACH,KAAY,UAAU,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,SAAS,WAAW,GAC3D,CAAC,GACD,CAAC,SAAS;QAAE,OAAO,EAAE,WAAW,CAAA;KAAE,GAChC,CAAC,CAAC,SAAS,CAAC,GACZ,KAAK,CAAC;IAEd;;OAEG;IACH,SAAgB,UAAU,CAAC,KAAK,CAAC,CAAC,SAAS,OAAO,EAAE,SAAS,EAAE,CAAC,iBAK/D;IAED;;OAEG;IACH,SAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,SAAS,yBAmB5F;IAED;;OAEG;IACH,KAAY,UAAU,CAAC,CAAC,SAAS,WAAW,EAAE,GAAG,SAAS,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,MAAM,GAC9F,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,GAClB,GAAG,SAAS,WAAW,CAAC,OAAO,GAC7B,GAAG,GACH,KAAK,CAAC;IAEd;;OAEG;IACH,SAAgB,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,KAAK,qBAepF;IAED;;OAEG;IACH,KAAY,SAAS,CAAC,CAAC,SAAS;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,SAAS,CAAC,OAAO,CAAA;KAAE,GAC3F,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,GAClC,SAAS,CAAC;IAEhB;;OAEG;IACH,SAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,OAAO,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAKzF;IAED;;OAEG;IACH,SAAgB,YAAY,CAAC,KAAK,CAAC,CAAC,SAAS;QAAE,QAAQ,CAAC,EAAE,QAAQ,CAAA;KAAE,EAAE,OAAO,EAAE,CAAC,GAAG,cAAc,GAAG,SAAS,CAK5G;CACJ"}

package/dist/esm/action/request/Specifier.js

@@ -0,0 +1,68 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GlobalAttributes } from "#types";
+import { MalformedRequestError } from "./MalformedRequestError.js";
+const GlobalAttrMap = GlobalAttributes({});
+var Specifier;
+((Specifier2) => {
+  function clusterFor(specifier) {
+    if ("cluster" in specifier) {
+      return specifier["cluster"];
+    }
+    return specifier;
+  }
+  Specifier2.clusterFor = clusterFor;
+  function attributeFor(cluster, specifier) {
+    if (typeof specifier === "object") {
+      return specifier;
+    }
+    if (cluster === void 0) {
+      const attr2 = GlobalAttrMap[specifier];
+      if (attr2 === void 0) {
+        throw new MalformedRequestError(`Cannot designate event "${specifier}" without a cluster`);
+      }
+      return attr2;
+    }
+    const attr = cluster.attributes?.[specifier];
+    if (attr === void 0) {
+      throw new MalformedRequestError(`Cluster ${cluster.name} does not define attribute ${specifier}`);
+    }
+    return attr;
+  }
+  Specifier2.attributeFor = attributeFor;
+  function eventFor(cluster, specifier) {
+    if (typeof specifier === "object") {
+      return specifier;
+    }
+    if (cluster === void 0) {
+      throw new MalformedRequestError(`Cannot designate event "${specifier}" without a cluster`);
+    }
+    const event = cluster.events?.[specifier];
+    if (event === void 0) {
+      throw new MalformedRequestError(`Cluster ${cluster.name} does not define event ${specifier}`);
+    }
+    return event;
+  }
+  Specifier2.eventFor = eventFor;
+  function clusterOf(request) {
+    if (request.cluster) {
+      return Specifier2.clusterFor(request.cluster);
+    }
+    return void 0;
+  }
+  Specifier2.clusterOf = clusterOf;
+  function endpointIdOf(request) {
+    if (typeof request.endpoint === "number") {
+      return request.endpoint;
+    }
+    return request.endpoint?.number;
+  }
+  Specifier2.endpointIdOf = endpointIdOf;
+})(Specifier || (Specifier = {}));
+export {
+  Specifier
+};
+//# sourceMappingURL=Specifier.js.map

package/dist/esm/action/request/Specifier.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/request/Specifier.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAA4D,wBAAwB;AACpF,SAAS,6BAA6B;AAEtC,MAAM,gBAAgB,iBAAiB,CAAC,CAAC;AAKlC,IAAU;AAAA,CAAV,CAAUA,eAAV;AA6CI,WAAS,WAAoC,WAAc;AAC9D,QAAI,aAAa,WAAW;AACxB,aAAO,UAAU,SAAS;AAAA,IAC9B;AACA,WAAO;AAAA,EACX;AALO,EAAAA,WAAS;AAUT,WAAS,aAAa,SAAkC,WAAgC;AAC3F,QAAI,OAAO,cAAc,UAAU;AAC/B,aAAO;AAAA,IACX;AAEA,QAAI,YAAY,QAAW;AACvB,YAAMC,QAAO,cAAc,SAAS;AACpC,UAAIA,UAAS,QAAW;AACpB,cAAM,IAAI,sBAAsB,2BAA2B,SAAS,qBAAqB;AAAA,MAC7F;AACA,aAAOA;AAAA,IACX;AAEA,UAAM,OAAO,QAAQ,aAAa,SAAS;AAC3C,QAAI,SAAS,QAAW;AACpB,YAAM,IAAI,sBAAsB,WAAW,QAAQ,IAAI,8BAA8B,SAAS,EAAE;AAAA,IACpG;AAEA,WAAO;AAAA,EACX;AAnBO,EAAAD,WAAS;AAiCT,WAAS,SAAS,SAAkC,WAA4B;AACnF,QAAI,OAAO,cAAc,UAAU;AAC/B,aAAO;AAAA,IACX;AAEA,QAAI,YAAY,QAAW;AACvB,YAAM,IAAI,sBAAsB,2BAA2B,SAAS,qBAAqB;AAAA,IAC7F;AAEA,UAAM,QAAQ,QAAQ,SAAS,SAAS;AACxC,QAAI,UAAU,QAAW;AACrB,YAAM,IAAI,sBAAsB,WAAW,QAAQ,IAAI,0BAA0B,SAAS,EAAE;AAAA,IAChG;AAEA,WAAO;AAAA,EACX;AAfO,EAAAA,WAAS;AA2BT,WAAS,UAAiD,SAA0B;AACvF,QAAI,QAAQ,SAAS;AACjB,aAAOA,WAAU,WAAW,QAAQ,OAAO;AAAA,IAC/C;AACA,WAAO;AAAA,EACX;AALO,EAAAA,WAAS;AAUT,WAAS,aAAsD,SAAwC;AAC1G,QAAI,OAAO,QAAQ,aAAa,UAAU;AACtC,aAAO,QAAQ;AAAA,IACnB;AACA,WAAO,QAAQ,UAAU;AAAA,EAC7B;AALO,EAAAA,WAAS;AAAA,GA7HH;",
+  "names": ["Specifier", "attr"]
+}

package/dist/esm/action/request/Subscribe.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Read } from "./Read.js";
+/**
+ * Defines a subscription.
+ *
+ * The subscription interval fields are optional as matter.js will set them to appropriate defaults based on physical
+ * attributes of the target device.  If you are unsure of appropriate values do not set them.
+ */
+export interface Subscribe extends Read {
+    keepSubscriptions: boolean;
+    minIntervalFloorSeconds?: number;
+    maxIntervalCeilingSeconds?: number;
+}
+export declare function Subscribe(options: Subscribe.Options): Subscribe;
+export declare namespace Subscribe {
+    interface Options extends Read.Options {
+        keepSubscriptions?: boolean;
+        minIntervalFloorSeconds?: number;
+        maxIntervalCeilingSeconds?: number;
+    }
+}
+//# sourceMappingURL=Subscribe.d.ts.map

package/dist/esm/action/request/Subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Subscribe.d.ts","sourceRoot":"","sources":["../../../../src/action/request/Subscribe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAqB/D;AAED,yBAAiB,SAAS,CAAC;IACvB,UAAiB,OAAQ,SAAQ,IAAI,CAAC,OAAO;QACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;QACjC,yBAAyB,CAAC,EAAE,MAAM,CAAC;KACtC;CACJ"}