@matter/node 0.16.0-alpha.0-20251004-92135c7df → 0.16.0-alpha.0-20251011-d8942d7d5

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

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { ValueSupervisor } from "#behavior/supervision/ValueSupervisor.js";
+import { Bytes } from "#general";
+import { DataModelPath } from "#model";
+/**
+ * Api data envelope packages used for request and response.
+ *
+ * This allows for transparent conversion between our three "native" formats -- JS values, serialized JSON and
+ * serialized TLV.
+ */
+export declare class Envelope<T = unknown> {
+    #private;
+    constructor({ supervisor, js, json, tlv }: Envelope.Definition<T>);
+    /**
+     * Validate against the schema.  Casts to appropriate types if necessary.
+     */
+    validate(path?: DataModelPath): void;
+    /**
+     * Convert a {@link js} value to {@link JSON}.
+     *
+     * This acts as a deep copy and optimizes JSON access.  If TLV becomes a priority then we can make this conversion
+     * configurable.
+     */
+    convertToJson(): void;
+    /**
+     * Native JS format.
+     */
+    get js(): T;
+    /**
+     * JSON format.
+     */
+    get json(): string;
+    /**
+     * Serialized TLV format.
+     */
+    get tlv(): AllowSharedBufferSource;
+}
+export declare namespace Envelope {
+    interface Data<T = unknown> {
+        id?: string;
+        js?: T;
+        json?: string;
+        tlv?: Bytes;
+    }
+    interface Definition<T = unknown> extends Data<T> {
+        supervisor: ValueSupervisor;
+    }
+}
+//# sourceMappingURL=Envelope.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Envelope.d.ts","sourceRoot":"","sources":["../../../../../../src/behavior/system/remote/api/Envelope.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAChF,OAAO,EAAU,KAAK,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAGvC;;;;;GAKG;AACH,qBAAa,QAAQ,CAAC,CAAC,GAAG,OAAO;;gBAMjB,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC;IAOjE;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa;IAS7B;;;;;OAKG;IACH,aAAa;IAOb;;OAEG;IACH,IAAI,EAAE,MAkBL;IAED;;OAEG;IACH,IAAI,IAAI,WAKP;IAED;;OAEG;IACH,IAAI,GAAG,4BAKN;CACJ;AAED,yBAAiB,QAAQ,CAAC;IACtB,UAAiB,IAAI,CAAC,CAAC,GAAG,OAAO;QAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,EAAE,CAAC,EAAE,CAAC,CAAC;QACP,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,KAAK,CAAC;KACf;IAED,UAAiB,UAAU,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,IAAI,CAAC,CAAC,CAAC;QACpD,UAAU,EAAE,eAAe,CAAC;KAC/B;CACJ"}

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

@@ -0,0 +1,87 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { LocalActorContext } from "#behavior/context/index.js";
+import { asJson } from "#general";
+import { DataModelPath } from "#model";
+import { StatusResponse, TlvOfModel } from "#types";
+class Envelope {
+  #supervisor;
+  #js;
+  #json;
+  #tlv;
+  constructor({ supervisor, js, json, tlv }) {
+    this.#supervisor = supervisor;
+    this.#js = js;
+    this.#json = json;
+    this.#tlv = tlv;
+  }
+  /**
+   * Validate against the schema.  Casts to appropriate types if necessary.
+   */
+  validate(path) {
+    if (!path) {
+      path = DataModelPath(this.#supervisor.schema.path);
+    }
+    this.#js = this.#supervisor.cast(this.#js);
+    this.#supervisor.validate?.(this.js, LocalActorContext.ReadOnly, { path });
+  }
+  /**
+   * Convert a {@link js} value to {@link JSON}.
+   *
+   * This acts as a deep copy and optimizes JSON access.  If TLV becomes a priority then we can make this conversion
+   * configurable.
+   */
+  convertToJson() {
+    if (this.#js !== void 0) {
+      void this.json;
+    }
+    this.#js = void 0;
+  }
+  /**
+   * Native JS format.
+   */
+  get js() {
+    if (this.#js === void 0) {
+      if (this.#json) {
+        try {
+          this.#js = JSON.parse(this.#json);
+        } catch (e) {
+          if (e instanceof SyntaxError) {
+            throw new StatusResponse.FailureError(`Unparseable JSON: ${e.message}`);
+          }
+          throw e;
+        }
+      } else if (this.#tlv) {
+        this.#js = TlvOfModel(this.#supervisor.schema).decode(this.#tlv);
+      } else {
+        this.#js = null;
+      }
+    }
+    return this.#js;
+  }
+  /**
+   * JSON format.
+   */
+  get json() {
+    if (this.#json === void 0) {
+      this.#json = asJson(this.js);
+    }
+    return this.#json;
+  }
+  /**
+   * Serialized TLV format.
+   */
+  get tlv() {
+    if (this.#tlv === void 0) {
+      this.#tlv = TlvOfModel(this.#supervisor.schema).encode(this.#js);
+    }
+    return this.#tlv;
+  }
+}
+export {
+  Envelope
+};
+//# sourceMappingURL=Envelope.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/system/remote/api/Envelope.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,yBAAyB;AAElC,SAAS,cAAqB;AAC9B,SAAS,qBAAqB;AAC9B,SAAS,gBAAgB,kBAAkB;AAQpC,MAAM,SAAsB;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,EAAE,YAAY,IAAI,MAAM,IAAI,GAA2B;AAC/D,SAAK,cAAc;AACnB,SAAK,MAAM;AACX,SAAK,QAAQ;AACb,SAAK,OAAO;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,MAAsB;AAC3B,QAAI,CAAC,MAAM;AACP,aAAO,cAAc,KAAK,YAAY,OAAO,IAAI;AAAA,IACrD;AAEA,SAAK,MAAM,KAAK,YAAY,KAAK,KAAK,GAAG;AACzC,SAAK,YAAY,WAAW,KAAK,IAAI,kBAAkB,UAAU,EAAE,KAAK,CAAC;AAAA,EAC7E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,gBAAgB;AACZ,QAAI,KAAK,QAAQ,QAAW;AACxB,WAAK,KAAK;AAAA,IACd;AACA,SAAK,MAAM;AAAA,EACf;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,KAAK;AACL,QAAI,KAAK,QAAQ,QAAW;AACxB,UAAI,KAAK,OAAO;AACZ,YAAI;AACA,eAAK,MAAM,KAAK,MAAM,KAAK,KAAK;AAAA,QACpC,SAAS,GAAG;AACR,cAAI,aAAa,aAAa;AAC1B,kBAAM,IAAI,eAAe,aAAa,qBAAqB,EAAE,OAAO,EAAE;AAAA,UAC1E;AACA,gBAAM;AAAA,QACV;AAAA,MACJ,WAAW,KAAK,MAAM;AAClB,aAAK,MAAM,WAAW,KAAK,YAAY,MAAM,EAAE,OAAO,KAAK,IAAI;AAAA,MACnE,OAAO;AACH,aAAK,MAAM;AAAA,MACf;AAAA,IACJ;AACA,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,OAAO;AACP,QAAI,KAAK,UAAU,QAAW;AAC1B,WAAK,QAAQ,OAAO,KAAK,EAAE;AAAA,IAC/B;AACA,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,MAAM;AACN,QAAI,KAAK,SAAS,QAAW;AACzB,WAAK,OAAO,WAAW,KAAK,YAAY,MAAM,EAAE,OAAO,KAAK,GAAG;AAAA,IACnE;AACA,WAAO,KAAK;AAAA,EAChB;AACJ;",
+  "names": []
+}

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

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Envelope } from "./Envelope.js";
+import { RemoteResponse } from "./RemoteResponse.js";
+/**
+ * The intermediate version of a {@link RemoteResponse}, transformed before transmission.
+ */
+export type LocalResponse = RemoteResponse.OK | RemoteResponse.Change | LocalResponse.Value | LocalResponse.Subscription | LocalResponse.Error;
+export declare namespace LocalResponse {
+    interface Value extends RemoteResponse.Base {
+        kind: "value";
+        value: Envelope;
+    }
+    interface Subscription extends RemoteResponse.Base {
+        kind: "subscription";
+        stream: Stream;
+    }
+    interface Error extends RemoteResponse.Base {
+        kind: "error";
+        error: globalThis.Error;
+    }
+    interface Stream extends AsyncIterableIterator<Envelope<LocalResponse>, void, void> {
+    }
+}
+//# sourceMappingURL=LocalResponse.d.ts.map

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,37 @@
+/**
+ * @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;
+}
+//# 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;CACtD"}

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

@@ -0,0 +1,32 @@
+/**
+ * @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`);
+  }
+}
+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;",
+  "names": []
+}

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"}