@matter/node 0.16.0-alpha.0-20251006-3fe1e7c57 → 0.16.0-alpha.0-20251013-89bb7099d

package/dist/esm/behavior/system/remote/api/LocalResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalResponse.d.ts","sourceRoot":"","sources":["../../../../../../src/behavior/system/remote/api/LocalResponse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,aAAa,GACnB,cAAc,CAAC,EAAE,GACjB,cAAc,CAAC,MAAM,GACrB,aAAa,CAAC,KAAK,GACnB,aAAa,CAAC,YAAY,GAC1B,aAAa,CAAC,KAAK,CAAC;AAE1B,yBAAiB,aAAa,CAAC;IAC3B,UAAiB,KAAM,SAAQ,cAAc,CAAC,IAAI;QAC9C,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,QAAQ,CAAC;KACnB;IAED,UAAiB,YAAa,SAAQ,cAAc,CAAC,IAAI;QACrD,IAAI,EAAE,cAAc,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;KAClB;IAED,UAAiB,KAAM,SAAQ,cAAc,CAAC,IAAI;QAC9C,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC;KAC3B;IAED,UAAiB,MAAO,SAAQ,qBAAqB,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;KAAG;CAChG"}

package/dist/esm/behavior/system/remote/api/LocalResponse.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=LocalResponse.js.map

package/dist/esm/behavior/system/remote/api/LocalResponse.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/system/remote/api/LocalResponse.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/esm/behavior/system/remote/api/RemoteRequest.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { StateStream } from "#node/integration/StateStream.js";
+/**
+ * An RPC request.
+ */
+export type RemoteRequest = RemoteRequest.Read | RemoteRequest.Write | RemoteRequest.Add | RemoteRequest.Delete | RemoteRequest.Invoke | RemoteRequest.Subscribe;
+/**
+ * Validate and return request object.
+ */
+export declare function RemoteRequest(request: unknown): RemoteRequest;
+export declare namespace RemoteRequest {
+    interface Base {
+        target: string;
+        id?: string;
+    }
+    interface Read extends Base {
+        method: "read";
+    }
+    interface Write extends Base {
+        method: "write";
+        value: unknown;
+    }
+    interface Add extends Base {
+        method: "add";
+        value: unknown;
+    }
+    interface Delete extends Base {
+        method: "delete";
+    }
+    interface Invoke extends Base {
+        method: "invoke";
+        target: string;
+        parameters?: unknown;
+    }
+    interface Subscribe extends Base, StateStream.Options {
+        method: "subscribe";
+    }
+}
+//# sourceMappingURL=RemoteRequest.d.ts.map

package/dist/esm/behavior/system/remote/api/RemoteRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteRequest.d.ts","sourceRoot":"","sources":["../../../../../../src/behavior/system/remote/api/RemoteRequest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAG/D;;GAEG;AACH,MAAM,MAAM,aAAa,GACnB,aAAa,CAAC,IAAI,GAClB,aAAa,CAAC,KAAK,GACnB,aAAa,CAAC,GAAG,GACjB,aAAa,CAAC,MAAM,GACpB,aAAa,CAAC,MAAM,GACpB,aAAa,CAAC,SAAS,CAAC;AAE9B;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GA2Bb,aAAa,CAC7C;AAED,yBAAiB,aAAa,CAAC;IAC3B,UAAiB,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;KACf;IAED,UAAiB,IAAK,SAAQ,IAAI;QAC9B,MAAM,EAAE,MAAM,CAAC;KAClB;IAED,UAAiB,KAAM,SAAQ,IAAI;QAC/B,MAAM,EAAE,OAAO,CAAC;QAChB,KAAK,EAAE,OAAO,CAAC;KAClB;IAED,UAAiB,GAAI,SAAQ,IAAI;QAC7B,MAAM,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;KAClB;IAED,UAAiB,MAAO,SAAQ,IAAI;QAChC,MAAM,EAAE,QAAQ,CAAC;KACpB;IAED,UAAiB,MAAO,SAAQ,IAAI;QAChC,MAAM,EAAE,QAAQ,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;KACxB;IAED,UAAiB,SAAU,SAAQ,IAAI,EAAE,WAAW,CAAC,OAAO;QACxD,MAAM,EAAE,WAAW,CAAC;KACvB;CACJ"}

package/dist/esm/behavior/system/remote/api/RemoteRequest.js

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isObject } from "#general";
+import { StatusResponse } from "#types";
+function RemoteRequest(request) {
+  if (!isObject(request)) {
+    throw new StatusResponse.InvalidActionError("Request is not an object");
+  }
+  const { target, method } = request;
+  if (typeof method !== "string") {
+    throw new StatusResponse.InvalidActionError('Request does not specify opcode in "method" property');
+  }
+  switch (method) {
+    case "read":
+    case "write":
+    case "add":
+    case "delete":
+    case "invoke":
+    case "subscribe":
+      break;
+    default:
+      throw new StatusResponse.InvalidActionError(`Unsupported request method "${method}"`);
+  }
+  if (typeof target !== "string") {
+    throw new StatusResponse.InvalidActionError('Request does not specify resource in "target" property');
+  }
+  return request;
+}
+export {
+  RemoteRequest
+};
+//# sourceMappingURL=RemoteRequest.js.map

package/dist/esm/behavior/system/remote/api/RemoteRequest.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/system/remote/api/RemoteRequest.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,gBAAgB;AAEzB,SAAS,sBAAsB;AAgBxB,SAAS,cAAc,SAAkB;AAC5C,MAAI,CAAC,SAAS,OAAO,GAAG;AACpB,UAAM,IAAI,eAAe,mBAAmB,0BAA0B;AAAA,EAC1E;AAEA,QAAM,EAAE,QAAQ,OAAO,IAAI;AAC3B,MAAI,OAAO,WAAW,UAAU;AAC5B,UAAM,IAAI,eAAe,mBAAmB,sDAAsD;AAAA,EACtG;AAEA,UAAQ,QAAQ;AAAA,IACZ,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACD;AAAA,IAEJ;AACI,YAAM,IAAI,eAAe,mBAAmB,+BAA+B,MAAM,GAAG;AAAA,EAC5F;AAEA,MAAI,OAAO,WAAW,UAAU;AAC5B,UAAM,IAAI,eAAe,mBAAmB,wDAAwD;AAAA,EACxG;AAEA,SAAO;AACX;",
+  "names": []
+}

package/dist/esm/behavior/system/remote/api/RemoteResponse.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { StateStream } from "#node/integration/StateStream.js";
+import type { LocalResponse } from "./LocalResponse.js";
+/**
+ * An RPC response.
+ *
+ * This is the serializable object delivered over the wire.
+ */
+export type RemoteResponse = RemoteResponse.OK | RemoteResponse.Value | RemoteResponse.Error | RemoteResponse.Change;
+/**
+ * Create a {@link RemoteResponse} from a {@link LocalResponse}.
+ */
+export declare function RemoteResponse(local: LocalResponse): RemoteResponse;
+export declare namespace RemoteResponse {
+    interface Base {
+        id?: string;
+    }
+    interface OK extends Base {
+        kind: "ok";
+        requestId?: string;
+    }
+    interface Value extends Base {
+        kind: "value";
+        value: unknown;
+    }
+    interface Error extends Base {
+        kind: "error";
+        message: string;
+        code: string;
+    }
+    type Change = Base & StateStream.WireChange;
+    function describe(response: RemoteResponse): string;
+}
+//# sourceMappingURL=RemoteResponse.d.ts.map

package/dist/esm/behavior/system/remote/api/RemoteResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteResponse.d.ts","sourceRoot":"","sources":["../../../../../../src/behavior/system/remote/api/RemoteResponse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AAEpE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,EAAE,GAAG,cAAc,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC;AAErH;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,CAwBnE;AAED,yBAAiB,cAAc,CAAC;IAC5B,UAAiB,IAAI;QACjB,EAAE,CAAC,EAAE,MAAM,CAAC;KACf;IAED,UAAiB,EAAG,SAAQ,IAAI;QAC5B,IAAI,EAAE,IAAI,CAAC;QACX,SAAS,CAAC,EAAE,MAAM,CAAC;KACtB;IAED,UAAiB,KAAM,SAAQ,IAAI;QAC/B,IAAI,EAAE,OAAO,CAAC;QACd,KAAK,EAAE,OAAO,CAAC;KAClB;IAED,UAAiB,KAAM,SAAQ,IAAI;QAC/B,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KAChB;IAED,KAAY,MAAM,GAAG,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC;IAEnD,SAAgB,QAAQ,CAAC,QAAQ,EAAE,cAAc,UAWhD;CACJ"}

package/dist/esm/behavior/system/remote/api/RemoteResponse.js

@@ -0,0 +1,45 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InternalError, MatterError } from "#general";
+function RemoteResponse(local) {
+  switch (local.kind) {
+    case "ok":
+    case "update":
+    case "delete":
+      return local;
+    case "value":
+      return {
+        ...local,
+        value: local.value.js
+      };
+    case "error":
+      return {
+        kind: "error",
+        id: local.id,
+        code: MatterError.idFor(local.error.constructor),
+        message: local.error.bareMessage ?? local.error.message
+      };
+    default:
+      throw new InternalError(`Cannot convert local response kind "${local.kind}" to remote response`);
+  }
+}
+((RemoteResponse2) => {
+  function describe(response) {
+    switch (response.kind) {
+      case "update":
+        return `update ${response.endpoint} ${response.behavior}`;
+      case "delete":
+        return `delete ${response.endpoint}`;
+      default:
+        return response.kind;
+    }
+  }
+  RemoteResponse2.describe = describe;
+})(RemoteResponse || (RemoteResponse = {}));
+export {
+  RemoteResponse
+};
+//# sourceMappingURL=RemoteResponse.js.map

package/dist/esm/behavior/system/remote/api/RemoteResponse.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/system/remote/api/RemoteResponse.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,eAAe,mBAAmB;AAepC,SAAS,eAAe,OAAsC;AACjE,UAAQ,MAAM,MAAM;AAAA,IAChB,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AACD,aAAO;AAAA,IAEX,KAAK;AACD,aAAO;AAAA,QACH,GAAG;AAAA,QACH,OAAO,MAAM,MAAM;AAAA,MACvB;AAAA,IAEJ,KAAK;AACD,aAAO;AAAA,QACH,MAAM;AAAA,QACN,IAAI,MAAM;AAAA,QACV,MAAM,YAAY,MAAM,MAAM,MAAM,WAAW;AAAA,QAC/C,SAAU,MAAM,MAA8B,eAAe,MAAM,MAAM;AAAA,MAC7E;AAAA,IAEJ;AACI,YAAM,IAAI,cAAc,uCAAuC,MAAM,IAAI,sBAAsB;AAAA,EACvG;AACJ;AAAA,CAEO,CAAUA,oBAAV;AAuBI,WAAS,SAAS,UAA0B;AAC/C,YAAQ,SAAS,MAAM;AAAA,MACnB,KAAK;AACD,eAAO,UAAU,SAAS,QAAQ,IAAI,SAAS,QAAQ;AAAA,MAE3D,KAAK;AACD,eAAO,UAAU,SAAS,QAAQ;AAAA,MAEtC;AACI,eAAO,SAAS;AAAA,IACxB;AAAA,EACJ;AAXO,EAAAA,gBAAS;AAAA,GAvBH;",
+  "names": ["RemoteResponse"]
+}

package/dist/esm/behavior/system/remote/api/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Api.js";
+export * from "./ApiResource.js";
+export * from "./Envelope.js";
+export * from "./LocalResponse.js";
+export * from "./RemoteRequest.js";
+export * from "./RemoteResponse.js";
+export * from "./resources/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/behavior/system/remote/api/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/behavior/system/remote/api/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/esm/behavior/system/remote/api/index.js

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Api.js";
+export * from "./ApiResource.js";
+export * from "./Envelope.js";
+export * from "./LocalResponse.js";
+export * from "./RemoteRequest.js";
+export * from "./RemoteResponse.js";
+export * from "./resources/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/behavior/system/remote/api/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/system/remote/api/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/behavior/system/remote/api/resources/BehaviorResource.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Behavior } from "#behavior/Behavior.js";
+import { RootSupervisor } from "#behavior/supervision/RootSupervisor.js";
+import { ApiResource } from "../ApiResource.js";
+import { PropertyResource } from "./PropertyResource.js";
+/**
+ * API item for behaviors.
+ */
+export declare class BehaviorResource extends PropertyResource {
+    #private;
+    get valueKind(): ApiResource.Kind;
+    constructor(behavior: Behavior, parent: ApiResource);
+    get value(): {};
+    write(): void;
+    childFor(id: string): Promise<void | ApiResource | PropertyResource>;
+    get rootSupervisor(): RootSupervisor;
+}
+//# sourceMappingURL=BehaviorResource.d.ts.map

package/dist/esm/behavior/system/remote/api/resources/BehaviorResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BehaviorResource.d.ts","sourceRoot":"","sources":["../../../../../../../src/behavior/system/remote/api/resources/BehaviorResource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,gBAAgB;;IAGlD,IAAa,SAAS,IAAI,WAAW,CAAC,IAAI,CAEzC;gBAEW,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW;IAUnD,IAAa,KAAK,OAEjB;IAEQ,KAAK;IAIC,QAAQ,CAAC,EAAE,EAAE,MAAM;IAmBlC,IAAa,cAAc,IACG,cAAc,CAC3C;CACJ"}

package/dist/esm/behavior/system/remote/api/resources/BehaviorResource.js

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { InternalError } from "#general";
+import { ClusterModel, CommandModel } from "#model";
+import { StatusResponse } from "#types";
+import { CommandResource } from "./CommandResource.js";
+import { PropertyResource } from "./PropertyResource.js";
+class BehaviorResource extends PropertyResource {
+  #behavior;
+  get valueKind() {
+    return "cluster";
+  }
+  constructor(behavior, parent) {
+    const { id, supervisor } = behavior.type;
+    if (supervisor === void 0) {
+      throw new InternalError(`API behavior reference has no value supervisor`);
+    }
+    super(parent, id, supervisor, behavior.endpoint.path.at(id));
+    this.#behavior = behavior;
+  }
+  get value() {
+    return this.#behavior.state;
+  }
+  write() {
+    throw new StatusResponse.UnsupportedWriteError(`Only patch supported for this path`);
+  }
+  async childFor(id) {
+    if (id === "state") {
+      return new PropertyResource(this, "state", this.supervisor, this.dataModelPath.at("state"));
+    }
+    if (this.schema instanceof ClusterModel) {
+      const command = this.schema.conformant.commands.for(id, CommandModel);
+      if (command) {
+        return new CommandResource(this, this.#behavior, command);
+      }
+    }
+    return super.childFor(id);
+  }
+  get rootSupervisor() {
+    return this.supervisor;
+  }
+}
+export {
+  BehaviorResource
+};
+//# sourceMappingURL=BehaviorResource.js.map

package/dist/esm/behavior/system/remote/api/resources/BehaviorResource.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/behavior/system/remote/api/resources/BehaviorResource.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,qBAAqB;AAC9B,SAAS,cAAc,oBAAoB;AAC3C,SAAS,sBAAsB;AAE/B,SAAS,uBAAuB;AAChC,SAAS,wBAAwB;AAK1B,MAAM,yBAAyB,iBAAiB;AAAA,EACnD;AAAA,EAEA,IAAa,YAA8B;AACvC,WAAO;AAAA,EACX;AAAA,EAEA,YAAY,UAAoB,QAAqB;AACjD,UAAM,EAAE,IAAI,WAAW,IAAI,SAAS;AACpC,QAAI,eAAe,QAAW;AAC1B,YAAM,IAAI,cAAc,gDAAgD;AAAA,IAC5E;AAEA,UAAM,QAAQ,IAAI,YAAY,SAAS,SAAS,KAAK,GAAG,EAAE,CAAC;AAC3D,SAAK,YAAY;AAAA,EACrB;AAAA,EAEA,IAAa,QAAQ;AACjB,WAAO,KAAK,UAAU;AAAA,EAC1B;AAAA,EAES,QAAQ;AACb,UAAM,IAAI,eAAe,sBAAsB,oCAAoC;AAAA,EACvF;AAAA,EAEA,MAAe,SAAS,IAAY;AAGhC,QAAI,OAAO,SAAS;AAChB,aAAO,IAAI,iBAAiB,MAAM,SAAS,KAAK,YAAY,KAAK,cAAc,GAAG,OAAO,CAAC;AAAA,IAC9F;AAGA,QAAI,KAAK,kBAAkB,cAAc;AACrC,YAAM,UAAU,KAAK,OAAO,WAAW,SAAS,IAAI,IAAI,YAAY;AACpE,UAAI,SAAS;AACT,eAAO,IAAI,gBAAgB,MAAM,KAAK,WAAW,OAAO;AAAA,MAC5D;AAAA,IACJ;AAGA,WAAO,MAAM,SAAS,EAAE;AAAA,EAC5B;AAAA,EAEA,IAAa,iBAAiB;AAC1B,WAAO,KAAK;AAAA,EAChB;AACJ;",
+  "names": []
+}

package/dist/esm/behavior/system/remote/api/resources/ChangesResource.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Abort } from "#general";
+import { ApiResource } from "../ApiResource.js";
+import { Envelope } from "../Envelope.js";
+import { LocalResponse } from "../LocalResponse.js";
+import { NodeResource as ServerNodeItem } from "./NodeResource.js";
+/**
+ * An item that delivers state changes via subscription.
+ */
+export declare class ChangesResource extends ApiResource {
+    readonly id = "changes";
+    readonly valueKind = "changes";
+    readonly supervisor: undefined;
+    readonly value: undefined;
+    readonly isSubscribable = true;
+    readonly parent: ServerNodeItem;
+    constructor(parent: ServerNodeItem);
+    get dataModelPath(): import("@matter/model").DataModelPath;
+    subscribe(abort: Abort.Signal, request: Envelope.Data): AsyncGenerator<Envelope<LocalResponse>, void, void>;
+}
+//# sourceMappingURL=ChangesResource.d.ts.map

package/dist/esm/behavior/system/remote/api/resources/ChangesResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChangesResource.d.ts","sourceRoot":"","sources":["../../../../../../../src/behavior/system/remote/api/resources/ChangesResource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAiB,MAAM,UAAU,CAAC;AAGhD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,IAAI,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnE;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;IAC5C,QAAQ,CAAC,EAAE,aAAa;IACxB,QAAQ,CAAC,SAAS,aAAa;IAC/B,QAAQ,CAAC,UAAU,YAAa;IAChC,QAAQ,CAAC,KAAK,YAAa;IAC3B,SAAkB,cAAc,QAAQ;IAExC,SAAiB,MAAM,EAAE,cAAc,CAAC;gBAE5B,MAAM,EAAE,cAAc;IAIlC,IAAI,aAAa,0CAEhB;IAEe,SAAS,CACrB,KAAK,EAAE,KAAK,CAAC,MAAM,EACnB,OAAO,EAAE,QAAQ,CAAC,IAAI,GACvB,cAAc,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC;CAoCzD"}

package/dist/esm/behavior/system/remote/api/resources/ChangesResource.js

@@ -0,0 +1,56 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { RootSupervisor } from "#behavior/supervision/RootSupervisor.js";
+import { InternalError } from "#general";
+import { StateStream } from "#node/integration/StateStream.js";
+import { ApiResource } from "../ApiResource.js";
+import { Envelope } from "../Envelope.js";
+class ChangesResource extends ApiResource {
+  id = "changes";
+  valueKind = "changes";
+  supervisor = void 0;
+  value = void 0;
+  isSubscribable = true;
+  constructor(parent) {
+    super(parent);
+  }
+  get dataModelPath() {
+    return this.parent.dataModelPath.at("changes");
+  }
+  async *subscribe(abort, request) {
+    const requestEnv = new Envelope({ supervisor: RootSupervisor.for(StateStream.OptionsSchema), ...request });
+    let options;
+    if (requestEnv.js) {
+      requestEnv.validate();
+      options = requestEnv.js;
+    }
+    const stream = StateStream(this.parent.node, { ...options, abort });
+    const { id } = request;
+    for await (const change of stream) {
+      const wire = StateStream.WireChange(change);
+      switch (change.kind) {
+        case "update":
+          yield new Envelope({
+            supervisor: RootSupervisor.for(StateStream.WireUpdateSchema),
+            js: { id, ...wire }
+          });
+          break;
+        case "delete":
+          yield new Envelope({
+            supervisor: RootSupervisor.for(StateStream.WireDeleteSchema),
+            js: { id, ...wire }
+          });
+          break;
+        default:
+          throw new InternalError(`Unsupported change kind ${change.kind}`);
+      }
+    }
+  }
+}
+export {
+  ChangesResource
+};
+//# sourceMappingURL=ChangesResource.js.map

package/dist/esm/behavior/system/remote/api/resources/ChangesResource.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/behavior/system/remote/api/resources/ChangesResource.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,sBAAsB;AAC/B,SAAgB,qBAAqB;AACrC,SAAS,mBAAmB;AAE5B,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB;AAOlB,MAAM,wBAAwB,YAAY;AAAA,EACpC,KAAK;AAAA,EACL,YAAY;AAAA,EACZ,aAAa;AAAA,EACb,QAAQ;AAAA,EACC,iBAAiB;AAAA,EAInC,YAAY,QAAwB;AAChC,UAAM,MAAM;AAAA,EAChB;AAAA,EAEA,IAAI,gBAAgB;AAChB,WAAO,KAAK,OAAO,cAAc,GAAG,SAAS;AAAA,EACjD;AAAA,EAEA,OAAgB,UACZ,OACA,SACmD;AACnD,UAAM,aAAa,IAAI,SAAS,EAAE,YAAY,eAAe,IAAI,YAAY,aAAa,GAAG,GAAG,QAAQ,CAAC;AAEzG,QAAI;AACJ,QAAI,WAAW,IAAI;AACf,iBAAW,SAAS;AACpB,gBAAU,WAAW;AAAA,IACzB;AAEA,UAAM,SAAS,YAAY,KAAK,OAAO,MAAoB,EAAE,GAAG,SAAS,MAAM,CAAC;AAEhF,UAAM,EAAE,GAAG,IAAI;AAEf,qBAAiB,UAAU,QAAQ;AAC/B,YAAM,OAAO,YAAY,WAAW,MAAM;AAE1C,cAAQ,OAAO,MAAM;AAAA,QACjB,KAAK;AACD,gBAAM,IAAI,SAAS;AAAA,YACf,YAAY,eAAe,IAAI,YAAY,gBAAgB;AAAA,YAC3D,IAAI,EAAE,IAAI,GAAG,KAAK;AAAA,UACtB,CAAC;AACD;AAAA,QAEJ,KAAK;AACD,gBAAM,IAAI,SAAS;AAAA,YACf,YAAY,eAAe,IAAI,YAAY,gBAAgB;AAAA,YAC3D,IAAI,EAAE,IAAI,GAAG,KAAK;AAAA,UACtB,CAAC;AACD;AAAA,QAEJ;AACI,gBAAM,IAAI,cAAc,2BAA4B,OAA8B,IAAI,EAAE;AAAA,MAChG;AAAA,IACJ;AAAA,EACJ;AACJ;",
+  "names": []
+}

package/dist/esm/behavior/system/remote/api/resources/CommandResource.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Behavior } from "#behavior/Behavior.js";
+import { ValueSupervisor } from "#behavior/supervision/ValueSupervisor.js";
+import { CommandModel } from "#model";
+import { ApiResource } from "../ApiResource.js";
+import { Envelope } from "../Envelope.js";
+/**
+ * API item for commands.
+ */
+export declare class CommandResource extends ApiResource {
+    #private;
+    supervisor: ValueSupervisor;
+    readonly isInvocable = true;
+    constructor(parent: ApiResource, behavior: Behavior, schema: CommandModel);
+    get schema(): CommandModel;
+    get id(): string;
+    get dataModelPath(): import("#model").DataModelPath;
+    get valueKind(): ApiResource.Kind;
+    get value(): undefined;
+    invoke(request?: Envelope.Data): Promise<Envelope<unknown> | undefined>;
+}
+//# sourceMappingURL=CommandResource.d.ts.map

package/dist/esm/behavior/system/remote/api/resources/CommandResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandResource.d.ts","sourceRoot":"","sources":["../../../../../../../src/behavior/system/remote/api/resources/CommandResource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;;IAE5C,UAAU,EAAE,eAAe,CAAC;IAE5B,SAAkB,WAAW,QAAQ;gBAEzB,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,YAAY;IAMzE,IAAa,MAAM,IACkB,YAAY,CAChD;IAED,IAAI,EAAE,WAEL;IAED,IAAI,aAAa,mCAEhB;IAED,IAAa,SAAS,IAAI,WAAW,CAAC,IAAI,CAEzC;IAED,IAAI,KAAK,cAER;IAEc,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,IAAI;CA0ChD"}

package/dist/esm/behavior/system/remote/api/resources/CommandResource.js

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { camelize, decamelize, ImplementationError, NotImplementedError } from "#general";
+import { ApiResource } from "../ApiResource.js";
+import { Envelope } from "../Envelope.js";
+class CommandResource extends ApiResource {
+  #behavior;
+  supervisor;
+  isInvocable = true;
+  constructor(parent, behavior, schema) {
+    super(parent);
+    this.#behavior = behavior;
+    this.supervisor = this.supervisorFor(schema);
+  }
+  get schema() {
+    return this.supervisor.schema;
+  }
+  get id() {
+    return decamelize(this.schema.name);
+  }
+  get dataModelPath() {
+    return this.parent.dataModelPath.at(this.id);
+  }
+  get valueKind() {
+    return "command";
+  }
+  get value() {
+    return void 0;
+  }
+  async invoke(request) {
+    let input = new Envelope({ supervisor: this.supervisor, ...request });
+    if (input.js === void 0 || input.js === null) {
+      input = new Envelope({ supervisor: this.supervisor, js: {} });
+    }
+    const name = camelize(this.id);
+    const method = this.#behavior[name];
+    if (typeof method !== "function") {
+      throw new NotImplementedError();
+    }
+    input.validate();
+    const result = await method.call(this.#behavior, input.js);
+    const responseSchema = this.schema.responseModel;
+    if (!responseSchema) {
+      return;
+    }
+    const output = new Envelope({ supervisor: this.supervisorFor(responseSchema), js: result });
+    try {
+      output.validate();
+    } catch (e) {
+      const error = new ImplementationError("Command output validation failed");
+      error.cause = e;
+      throw error;
+    }
+    return output;
+  }
+}
+export {
+  CommandResource
+};
+//# sourceMappingURL=CommandResource.js.map

package/dist/esm/behavior/system/remote/api/resources/CommandResource.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/behavior/system/remote/api/resources/CommandResource.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,UAAU,YAAY,qBAAqB,2BAA2B;AAE/E,SAAS,mBAAmB;AAC5B,SAAS,gBAAgB;AAKlB,MAAM,wBAAwB,YAAY;AAAA,EAC7C;AAAA,EACA;AAAA,EAEkB,cAAc;AAAA,EAEhC,YAAY,QAAqB,UAAoB,QAAsB;AACvE,UAAM,MAAM;AACZ,SAAK,YAAY;AACjB,SAAK,aAAa,KAAK,cAAc,MAAM;AAAA,EAC/C;AAAA,EAEA,IAAa,SAAS;AAClB,WAAO,KAAK,WAAW;AAAA,EAC3B;AAAA,EAEA,IAAI,KAAK;AACL,WAAO,WAAW,KAAK,OAAO,IAAI;AAAA,EACtC;AAAA,EAEA,IAAI,gBAAgB;AAChB,WAAO,KAAK,OAAQ,cAAc,GAAG,KAAK,EAAE;AAAA,EAChD;AAAA,EAEA,IAAa,YAA8B;AACvC,WAAO;AAAA,EACX;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO;AAAA,EACX;AAAA,EAEA,MAAe,OAAO,SAAyB;AAC3C,QAAI,QAAQ,IAAI,SAAS,EAAE,YAAY,KAAK,YAAY,GAAG,QAAQ,CAAC;AACpE,QAAI,MAAM,OAAO,UAAa,MAAM,OAAO,MAAM;AAE7C,cAAQ,IAAI,SAAS,EAAE,YAAY,KAAK,YAAY,IAAI,CAAC,EAAE,CAAC;AAAA,IAChE;AAGA,UAAM,OAAO,SAAS,KAAK,EAAE;AAC7B,UAAM,SAAU,KAAK,UACjB,IACJ;AACA,QAAI,OAAO,WAAW,YAAY;AAC9B,YAAM,IAAI,oBAAoB;AAAA,IAClC;AAGA,UAAM,SAAS;AAGf,UAAM,SAAS,MAAM,OAAO,KAAK,KAAK,WAAW,MAAM,EAAE;AAGzD,UAAM,iBAAiB,KAAK,OAAO;AACnC,QAAI,CAAC,gBAAgB;AACjB;AAAA,IACJ;AAGA,UAAM,SAAS,IAAI,SAAS,EAAE,YAAY,KAAK,cAAc,cAAc,GAAG,IAAI,OAAO,CAAC;AAC1F,QAAI;AACA,aAAO,SAAS;AAAA,IACpB,SAAS,GAAG;AAER,YAAM,QAAQ,IAAI,oBAAoB,kCAAkC;AACxE,YAAM,QAAQ;AACd,YAAM;AAAA,IACV;AAGA,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/esm/behavior/system/remote/api/resources/EndpointContainerResource.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ApiResource } from "../ApiResource.js";
+import type { EndpointResource } from "./EndpointResource.js";
+/**
+ * API item for collections of endpoints.
+ */
+export declare class EndpointContainerResource extends ApiResource {
+    #private;
+    readonly id: string;
+    readonly parent: EndpointResource;
+    supervisor: undefined;
+    readonly valueKind: ApiResource.Kind;
+    constructor(parent: EndpointResource, id: string, list: () => string[], find: (path: string) => ApiResource | undefined);
+    get dataModelPath(): import("@matter/model").DataModelPath;
+    get value(): string[];
+    childFor(id: string): Promise<ApiResource | undefined>;
+}
+//# sourceMappingURL=EndpointContainerResource.d.ts.map

package/dist/esm/behavior/system/remote/api/resources/EndpointContainerResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointContainerResource.d.ts","sourceRoot":"","sources":["../../../../../../../src/behavior/system/remote/api/resources/EndpointContainerResource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,WAAW;;IACtD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAGpB,SAAiB,MAAM,EAAE,gBAAgB,CAAC;IAC1C,UAAU,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,CAAW;gBAG3C,MAAM,EAAE,gBAAgB,EACxB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,MAAM,EAAE,EACpB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,WAAW,GAAG,SAAS;IASnD,IAAI,aAAa,0CAEhB;IAED,IAAI,KAAK,aAER;IAEc,QAAQ,CAAC,EAAE,EAAE,MAAM;CAGrC"}

package/dist/esm/behavior/system/remote/api/resources/EndpointContainerResource.js

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ApiResource } from "../ApiResource.js";
+class EndpointContainerResource extends ApiResource {
+  id;
+  #list;
+  #find;
+  supervisor;
+  valueKind = "index";
+  constructor(parent, id, list, find) {
+    super(parent);
+    this.id = id;
+    this.#list = list;
+    this.#find = find;
+  }
+  get dataModelPath() {
+    return this.parent.dataModelPath.at(this.id);
+  }
+  get value() {
+    return this.#list();
+  }
+  async childFor(id) {
+    return this.#find(id);
+  }
+}
+export {
+  EndpointContainerResource
+};
+//# sourceMappingURL=EndpointContainerResource.js.map

package/dist/esm/behavior/system/remote/api/resources/EndpointContainerResource.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../../src/behavior/system/remote/api/resources/EndpointContainerResource.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,mBAAmB;AAMrB,MAAM,kCAAkC,YAAY;AAAA,EAC9C;AAAA,EACA;AAAA,EACA;AAAA,EAET;AAAA,EACS,YAA8B;AAAA,EAEvC,YACI,QACA,IACA,MACA,MACF;AACE,UAAM,MAAM;AAEZ,SAAK,KAAK;AACV,SAAK,QAAQ;AACb,SAAK,QAAQ;AAAA,EACjB;AAAA,EAEA,IAAI,gBAAgB;AAChB,WAAO,KAAK,OAAO,cAAc,GAAG,KAAK,EAAE;AAAA,EAC/C;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EAEA,MAAe,SAAS,IAAY;AAChC,WAAO,KAAK,MAAM,EAAE;AAAA,EACxB;AACJ;",
+  "names": []
+}

package/dist/esm/behavior/system/remote/api/resources/EndpointResource.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Agent } from "#endpoint/Agent.js";
+import { ApiResource } from "../ApiResource.js";
+/**
+ * API item for endpoints.
+ *
+ * Direct descendents are either behaviors or collections, represented by {@link BehaviorResource} and
+ * {@link EndpointContainerResource} respectively.
+ */
+export declare class EndpointResource extends ApiResource {
+    readonly agent: Agent;
+    readonly supervisor: undefined;
+    constructor(agent: Agent, parent: undefined | ApiResource);
+    get valueKind(): ApiResource.Kind;
+    get id(): string;
+    get dataModelPath(): import("@matter/model").DataModelPath;
+    get value(): {
+        readonly descriptor: {
+            readonly partsList: readonly import("@matter/types").EndpointNumber[];
+            readonly deviceTypeList: readonly {
+                readonly deviceType: import("@matter/types").DeviceTypeId;
+                readonly revision: number;
+            }[];
+            readonly serverList: readonly import("@matter/types").ClusterId[];
+            readonly clientList: readonly import("@matter/types").ClusterId[];
+        };
+    };
+    childFor(name: string): Promise<ApiResource | void>;
+}
+//# sourceMappingURL=EndpointResource.d.ts.map

package/dist/esm/behavior/system/remote/api/resources/EndpointResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointResource.d.ts","sourceRoot":"","sources":["../../../../../../../src/behavior/system/remote/api/resources/EndpointResource.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAIhD;;;;;GAKG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC;gBAEnB,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,GAAG,WAAW;IAKzD,IAAI,SAAS,IAAI,WAAW,CAAC,IAAI,CAEhC;IAED,IAAI,EAAE,WAEL;IAED,IAAI,aAAa,0CAEhB;IAED,IAAa,KAAK;;;;;;;;;;MAEjB;IAEc,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;CA+BrE"}