@matter/protocol 0.12.4-alpha.0-20250211-56b2c53a0 → 0.12.4-alpha.0-20250212-b2729c9eb

package/dist/cjs/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/cjs/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"}

package/dist/cjs/action/request/Subscribe.js

@@ -0,0 +1,50 @@
+"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 Subscribe_exports = {};
+__export(Subscribe_exports, {
+  Subscribe: () => Subscribe
+});
+module.exports = __toCommonJS(Subscribe_exports);
+var import_general = require("#general");
+var import_MalformedRequestError = require("./MalformedRequestError.js");
+var import_Read = require("./Read.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function Subscribe(options) {
+  const subscribe = (0, import_Read.Read)(options);
+  const { keepSubscriptions, minIntervalFloorSeconds, maxIntervalCeilingSeconds } = options;
+  subscribe.keepSubscriptions = keepSubscriptions ?? true;
+  if (minIntervalFloorSeconds !== void 0) {
+    if (minIntervalFloorSeconds < 0 || minIntervalFloorSeconds > import_general.UINT16_MAX) {
+      throw new import_MalformedRequestError.MalformedRequestError(`Minimum interval floor ${minIntervalFloorSeconds} is out of range`);
+    }
+    subscribe.minIntervalFloorSeconds = minIntervalFloorSeconds;
+  }
+  if (maxIntervalCeilingSeconds !== void 0) {
+    if (maxIntervalCeilingSeconds < 0 || maxIntervalCeilingSeconds > import_general.UINT16_MAX) {
+      throw new import_MalformedRequestError.MalformedRequestError(`Maximum interval ceiling ${maxIntervalCeilingSeconds} is out of range`);
+    }
+    subscribe.maxIntervalCeilingSeconds = maxIntervalCeilingSeconds;
+  }
+  return subscribe;
+}
+//# sourceMappingURL=Subscribe.js.map

package/dist/cjs/action/request/Subscribe.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/request/Subscribe.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAA2B;AAC3B,mCAAsC;AACtC,kBAAqB;AARrB;AAAA;AAAA;AAAA;AAAA;AAsBO,SAAS,UAAU,SAAuC;AAC7D,QAAM,gBAAY,kBAAK,OAAO;AAE9B,QAAM,EAAE,mBAAmB,yBAAyB,0BAA0B,IAAI;AAClF,YAAU,oBAAoB,qBAAqB;AAEnD,MAAI,4BAA4B,QAAW;AACvC,QAAI,0BAA0B,KAAK,0BAA0B,2BAAY;AACrE,YAAM,IAAI,mDAAsB,0BAA0B,uBAAuB,kBAAkB;AAAA,IACvG;AACA,cAAU,0BAA0B;AAAA,EACxC;AAEA,MAAI,8BAA8B,QAAW;AACzC,QAAI,4BAA4B,KAAK,4BAA4B,2BAAY;AACzE,YAAM,IAAI,mDAAsB,4BAA4B,yBAAyB,kBAAkB;AAAA,IAC3G;AACA,cAAU,4BAA4B;AAAA,EAC1C;AAEA,SAAO;AACX;",
+  "names": []
+}

package/dist/cjs/action/request/Write.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { WriteRequest } from "#types";
+export interface Write extends WriteRequest {
+    timeout?: number;
+}
+//# sourceMappingURL=Write.d.ts.map

package/dist/cjs/action/request/Write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Write.d.ts","sourceRoot":"","sources":["../../../../src/action/request/Write.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,MAAM,WAAW,KAAM,SAAQ,YAAY;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/cjs/action/request/Write.js

@@ -0,0 +1,22 @@
+"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 Write_exports = {};
+module.exports = __toCommonJS(Write_exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=Write.js.map

package/dist/cjs/action/request/Write.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/request/Write.ts"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/action/request/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Invoke.js";
+export * from "./Read.js";
+export * from "./Specifier.js";
+export * from "./Subscribe.js";
+export * from "./Write.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/action/request/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/action/request/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC"}

package/dist/cjs/action/request/index.js

@@ -0,0 +1,28 @@
+"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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var request_exports = {};
+module.exports = __toCommonJS(request_exports);
+__reExport(request_exports, require("./Invoke.js"), module.exports);
+__reExport(request_exports, require("./Read.js"), module.exports);
+__reExport(request_exports, require("./Specifier.js"), module.exports);
+__reExport(request_exports, require("./Subscribe.js"), module.exports);
+__reExport(request_exports, require("./Write.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

package/dist/cjs/action/request/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/request/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,4BAAc,wBANd;AAOA,4BAAc,sBAPd;AAQA,4BAAc,2BARd;AASA,4BAAc,2BATd;AAUA,4BAAc,uBAVd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/action/response/InvokeResult.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Invoke } from "#action/request/Invoke.js";
+import type { CommandData } from "#types";
+import { CancelablePromise } from "@matter/general";
+export type InvokeResult<T extends Invoke> = T extends {
+    suppressResponse: true;
+} ? CancelablePromise<void> : AsyncIterable<InvokeResult.Chunk>;
+export declare namespace InvokeResult {
+    type Chunk = CommandData[];
+}
+//# sourceMappingURL=InvokeResult.d.ts.map

package/dist/cjs/action/response/InvokeResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InvokeResult.d.ts","sourceRoot":"","sources":["../../../../src/action/response/InvokeResult.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS;IAAE,gBAAgB,EAAE,IAAI,CAAA;CAAE,GAC3E,iBAAiB,CAAC,IAAI,CAAC,GACvB,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;AAExC,yBAAiB,YAAY,CAAC;IAC1B,KAAY,KAAK,GAAG,WAAW,EAAE,CAAC;CACrC"}

package/dist/cjs/action/response/InvokeResult.js

@@ -0,0 +1,22 @@
+"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 InvokeResult_exports = {};
+module.exports = __toCommonJS(InvokeResult_exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=InvokeResult.js.map

package/dist/cjs/action/response/InvokeResult.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/response/InvokeResult.ts"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/action/response/ReadResult.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { AttributeId, AttributePath, ClusterId, EndpointNumber, EventId, EventPath, NodeId, Status, StatusCode } from "#types";
+/**
+ * Streaming result for a Matter protocol-level read.
+ *
+ * These structures contain data for AttributeReportIB and EventReportIB.  We don't use the deeply-nested native TLV
+ * structure directly for reasons of performance and developer convenience.
+ *
+ * Iteration occurs in chunks for performance reasons.  A chunk is an iterable of reports, one per output attribute or
+ * event.
+ */
+export interface ReadResult<Chunk = ReadResult.Chunk> extends AsyncIterable<ReadResult.Chunk> {
+}
+export declare namespace ReadResult {
+    type Chunk = Iterable<Report>;
+    type Report = AttributeValue | GlobalAttributeStatus | ClusterAttributeStatus | EventValue | GlobalEventStatus | ClusterEventStatus;
+    interface ConcreteAttributePath extends AttributePath {
+        nodeId?: NodeId;
+        endpointId: EndpointNumber;
+        clusterId: ClusterId;
+        attributeId: AttributeId;
+    }
+    interface AttributeValue {
+        kind: "attr-value";
+        path: ConcreteAttributePath;
+        value: unknown;
+    }
+    interface GlobalAttributeStatus {
+        kind: "attr-status";
+        path: ConcreteAttributePath;
+        status: StatusCode;
+    }
+    interface ClusterAttributeStatus {
+        kind: "attr-cluster-status";
+        path: ConcreteAttributePath;
+        clusterStatus: number;
+    }
+    interface ConcreteEventPath extends EventPath {
+        nodeId?: NodeId;
+        endpointId: EndpointNumber;
+        clusterId: ClusterId;
+        eventId: EventId;
+    }
+    interface EventValue {
+        kind: "event-value";
+        path: ConcreteEventPath;
+    }
+    interface GlobalEventStatus {
+        kind: "event-status";
+        path: ConcreteEventPath;
+        status: Status;
+    }
+    interface ClusterEventStatus {
+        kind: "event-cluster-status";
+        path: ConcreteEventPath;
+        clusterStatus: number;
+    }
+}
+//# sourceMappingURL=ReadResult.d.ts.map

package/dist/cjs/action/response/ReadResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReadResult.d.ts","sourceRoot":"","sources":["../../../../src/action/response/ReadResult.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACR,WAAW,EACX,aAAa,EACb,SAAS,EACT,cAAc,EACd,OAAO,EACP,SAAS,EACT,MAAM,EACN,MAAM,EACN,UAAU,EACb,MAAM,QAAQ,CAAC;AAEhB;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAE,SAAQ,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;CAAG;AAEhG,yBAAiB,UAAU,CAAC;IACxB,KAAY,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAErC,KAAY,MAAM,GACZ,cAAc,GACd,qBAAqB,GACrB,sBAAsB,GACtB,UAAU,GACV,iBAAiB,GACjB,kBAAkB,CAAC;IAEzB,UAAiB,qBAAsB,SAAQ,aAAa;QACxD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,cAAc,CAAC;QAC3B,SAAS,EAAE,SAAS,CAAC;QACrB,WAAW,EAAE,WAAW,CAAC;KAC5B;IAED,UAAiB,cAAc;QAC3B,IAAI,EAAE,YAAY,CAAC;QACnB,IAAI,EAAE,qBAAqB,CAAC;QAC5B,KAAK,EAAE,OAAO,CAAC;KAClB;IAED,UAAiB,qBAAqB;QAClC,IAAI,EAAE,aAAa,CAAC;QACpB,IAAI,EAAE,qBAAqB,CAAC;QAC5B,MAAM,EAAE,UAAU,CAAC;KACtB;IAED,UAAiB,sBAAsB;QACnC,IAAI,EAAE,qBAAqB,CAAC;QAC5B,IAAI,EAAE,qBAAqB,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;KACzB;IAED,UAAiB,iBAAkB,SAAQ,SAAS;QAChD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,cAAc,CAAC;QAC3B,SAAS,EAAE,SAAS,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC;KACpB;IAED,UAAiB,UAAU;QACvB,IAAI,EAAE,aAAa,CAAC;QACpB,IAAI,EAAE,iBAAiB,CAAC;KAC3B;IAED,UAAiB,iBAAiB;QAC9B,IAAI,EAAE,cAAc,CAAC;QACrB,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;KAClB;IAED,UAAiB,kBAAkB;QAC/B,IAAI,EAAE,sBAAsB,CAAC;QAC7B,IAAI,EAAE,iBAAiB,CAAC;QACxB,aAAa,EAAE,MAAM,CAAC;KACzB;CACJ"}

package/dist/cjs/action/response/ReadResult.js

@@ -0,0 +1,22 @@
+"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 ReadResult_exports = {};
+module.exports = __toCommonJS(ReadResult_exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=ReadResult.js.map

package/dist/cjs/action/response/ReadResult.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/response/ReadResult.ts"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/action/response/SubscribeResult.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SubscribeResponse } from "#types";
+import { ReadResult } from "./ReadResult.js";
+export interface SubscribeResult extends AsyncIterator<SubscribeResult.Chunk> {
+}
+export declare namespace SubscribeResult {
+    type Chunk = ReadResult.Chunk | SubscribeResponse;
+}
+//# sourceMappingURL=SubscribeResult.d.ts.map

package/dist/cjs/action/response/SubscribeResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SubscribeResult.d.ts","sourceRoot":"","sources":["../../../../src/action/response/SubscribeResult.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,eAAgB,SAAQ,aAAa,CAAC,eAAe,CAAC,KAAK,CAAC;CAAG;AAEhF,yBAAiB,eAAe,CAAC;IAC7B,KAAY,KAAK,GAAG,UAAU,CAAC,KAAK,GAAG,iBAAiB,CAAC;CAC5D"}

package/dist/cjs/action/response/SubscribeResult.js

@@ -0,0 +1,22 @@
+"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 SubscribeResult_exports = {};
+module.exports = __toCommonJS(SubscribeResult_exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=SubscribeResult.js.map

package/dist/cjs/action/response/SubscribeResult.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/response/SubscribeResult.ts"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/action/response/WriteResult.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Write } from "#action/request/Write.js";
+import type { CancelablePromise } from "#general";
+import type { WriteResponse } from "#types";
+export type WriteResult<T extends Write> = CancelablePromise<T extends {
+    suppressResponse: true;
+} ? void : WriteResponse>;
+//# sourceMappingURL=WriteResult.d.ts.map

package/dist/cjs/action/response/WriteResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteResult.d.ts","sourceRoot":"","sources":["../../../../src/action/response/WriteResult.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,KAAK,IAAI,iBAAiB,CACxD,CAAC,SAAS;IAAE,gBAAgB,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,aAAa,CAC9D,CAAC"}

package/dist/cjs/action/response/WriteResult.js

@@ -0,0 +1,22 @@
+"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 WriteResult_exports = {};
+module.exports = __toCommonJS(WriteResult_exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=WriteResult.js.map

package/dist/cjs/action/response/WriteResult.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/response/WriteResult.ts"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/action/response/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./InvokeResult.js";
+export * from "./ReadResult.js";
+export * from "./SubscribeResult.js";
+export * from "./WriteResult.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/action/response/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/action/response/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/cjs/action/response/index.js

@@ -0,0 +1,27 @@
+"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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var response_exports = {};
+module.exports = __toCommonJS(response_exports);
+__reExport(response_exports, require("./InvokeResult.js"), module.exports);
+__reExport(response_exports, require("./ReadResult.js"), module.exports);
+__reExport(response_exports, require("./SubscribeResult.js"), module.exports);
+__reExport(response_exports, require("./WriteResult.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

package/dist/cjs/action/response/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/action/response/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,6BAAc,8BANd;AAOA,6BAAc,4BAPd;AAQA,6BAAc,iCARd;AASA,6BAAc,6BATd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/action/server/AccessControl.d.ts

@@ -0,0 +1,152 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AccessLevel, DataModelPath, Schema } from "#model";
+import { ClusterId, EndpointNumber, FabricIndex, SubjectId } from "#types";
+/**
+ * Enforces access control for a specific schema.
+ */
+export interface AccessControl {
+    /**
+     * Operational access control metadata.
+     */
+    limits: AccessControl.Limits;
+    /**
+     * Assert read is authorized.
+     */
+    authorizeRead: AccessControl.Assertion;
+    /**
+     * Determine if read is authorized.
+     */
+    mayRead: AccessControl.Verification;
+    /**
+     * Assert write is authorized.
+     */
+    authorizeWrite: AccessControl.Assertion;
+    /**
+     * Determine if write is authorized.
+     */
+    mayWrite: AccessControl.Verification;
+    /**
+     * Assert invoke is authorized.
+     */
+    authorizeInvoke: AccessControl.Assertion;
+    /**
+     * Determine if invoke is authorized.
+     */
+    mayInvoke: AccessControl.Verification;
+}
+/**
+ * Obtain an enforcer for specific schema.
+ *
+ * This is central to security.  Implementation is explicit, all objects are involved are frozen and cache is stored as
+ * module-private.
+ *
+ * Pure function; returned value is cached.
+ */
+export declare function AccessControl(schema: Schema): AccessControl;
+export declare namespace AccessControl {
+    /**
+     * Operational access control metadata for a schema.
+     */
+    interface Limits {
+        readonly readable: boolean;
+        readonly readLevel: AccessLevel;
+        readonly writable: boolean;
+        readonly writeLevel: AccessLevel;
+        readonly fabricScoped: boolean;
+        readonly fabricSensitive: boolean;
+        readonly timed: boolean;
+    }
+    /**
+     * A function that asserts access control requirements are met.
+     */
+    type Assertion = (session: Session, location: Location) => void;
+    /**
+     * A function that returns true if access control requirements are met.
+     */
+    type Verification = (session: Session, location: Location) => boolean;
+    /**
+     * Metadata that varies with position in the data model.
+     */
+    interface Location {
+        /**
+         * The diagnostic path to the location.
+         */
+        path: DataModelPath;
+        /**
+         * The owning endpoint.
+         */
+        endpoint?: EndpointNumber;
+        /**
+         * The owning behavior.
+         */
+        cluster?: ClusterId;
+        /**
+         * The fabric that owns the data subtree.  Undefined or {@link FabricIndex.NO_FABRIC} disables fabric
+         * enforcement.
+         */
+        owningFabric?: FabricIndex;
+    }
+    /**
+     * Authorization metadata that varies with session.
+     */
+    interface Session {
+        /**
+         * Determine whether authorized client has authority at a specific location.
+         */
+        authorityAt(desiredAccessLevel: AccessLevel, location?: Location): Authority;
+        /**
+         * The fabric of the authorized client.
+         */
+        readonly fabric?: FabricIndex;
+        /**
+         * The authenticated {@link SubjectId} for online sessions.
+         */
+        readonly subject?: SubjectId;
+        /**
+         * Flag subject as a group rather than a peer.
+         */
+        readonly isGroupSubject?: boolean;
+        /**
+         * If this is true, fabric-scoped lists are filtered to the accessing fabric.
+         */
+        readonly fabricFiltered?: boolean;
+        /**
+         * If this is true a timed transaction is in effect.
+         */
+        readonly timed?: boolean;
+        /**
+         * If this is true then data access levels are not enforced.  Datatypes and command-related access controls are
+         * active.
+         */
+        readonly command?: boolean;
+        /**
+         * If this is true then access levels are not enforced and all values are read/write.  Datatypes are still
+         * enforced.
+         *
+         * Tracks "offline" rather than "online" because this makes the safer mode (full enforcement) the default.
+         */
+        offline?: boolean;
+    }
+    /**
+     * Authority status.
+     */
+    enum Authority {
+        /**
+         * Authority is granted.
+         */
+        Granted = 1,
+        /**
+         * Insufficient privileges.
+         */
+        Unauthorized = 2,
+        /**
+         * Feature is restricted.
+         */
+        Restricted = 3
+    }
+}
+//# sourceMappingURL=AccessControl.d.ts.map

package/dist/cjs/action/server/AccessControl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessControl.d.ts","sourceRoot":"","sources":["../../../../src/action/server/AccessControl.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAU,WAAW,EAAE,aAAa,EAAc,MAAM,EAAc,MAAM,QAAQ,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAc,SAAS,EAAE,MAAM,QAAQ,CAAC;AAKvF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC;IAE7B;;OAEG;IACH,aAAa,EAAE,aAAa,CAAC,SAAS,CAAC;IAEvC;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC;IAEpC;;OAEG;IACH,cAAc,EAAE,aAAa,CAAC,SAAS,CAAC;IAExC;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC,YAAY,CAAC;IAErC;;OAEG;IACH,eAAe,EAAE,aAAa,CAAC,SAAS,CAAC;IAEzC;;OAEG;IACH,SAAS,EAAE,aAAa,CAAC,YAAY,CAAC;CACzC;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,iBAM3C;AAED,yBAAiB,aAAa,CAAC;IAC3B;;OAEG;IACH,UAAiB,MAAM;QACnB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;QAEhC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;QAEjC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;QAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;QAElC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;KAC3B;IAED;;OAEG;IACH,KAAY,SAAS,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;IAEvE;;OAEG;IACH,KAAY,YAAY,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC;IAE7E;;OAEG;IACH,UAAiB,QAAQ;QACrB;;WAEG;QACH,IAAI,EAAE,aAAa,CAAC;QAEpB;;WAEG;QACH,QAAQ,CAAC,EAAE,cAAc,CAAC;QAE1B;;WAEG;QACH,OAAO,CAAC,EAAE,SAAS,CAAC;QAEpB;;;WAGG;QACH,YAAY,CAAC,EAAE,WAAW,CAAC;KAC9B;IAED;;OAEG;IACH,UAAiB,OAAO;QACpB;;WAEG;QACH,WAAW,CAAC,kBAAkB,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;QAE7E;;WAEG;QACH,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;QAE9B;;WAEG;QACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,CAAC;QAE7B;;WAEG;QACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAElC;;WAEG;QACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;QAElC;;WAEG;QACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAEzB;;;WAGG;QACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAE3B;;;;;WAKG;QACH,OAAO,CAAC,EAAE,OAAO,CAAC;KACrB;IAED;;OAEG;IACH,KAAY,SAAS;QACjB;;WAEG;QACH,OAAO,IAAI;QAEX;;WAEG;QACH,YAAY,IAAI;QAEhB;;WAEG;QACH,UAAU,IAAI;KACjB;CACJ"}