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

package/dist/cjs/behavior/system/remote/api/ApiResource.js

@@ -0,0 +1,123 @@
+"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 ApiResource_exports = {};
+__export(ApiResource_exports, {
+  ApiResource: () => ApiResource
+});
+module.exports = __toCommonJS(ApiResource_exports);
+var import_RootSupervisor = require("#behavior/supervision/RootSupervisor.js");
+var import_general = require("#general");
+var import_model = require("#model");
+var import_Envelope = require("./Envelope.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class ApiResource {
+  /**
+   * The item's owner, if any.
+   */
+  parent;
+  /**
+   * Indicates whether this is an RPC endpoint.
+   */
+  isInvocable = false;
+  /**
+   * Indicates whether this is an event endpoint.
+   */
+  isSubscribable = false;
+  constructor(parent) {
+    this.parent = parent;
+  }
+  /**
+   * Retrieve the body of the item.
+   */
+  read() {
+    if (this.value === void 0) {
+      return;
+    }
+    return new import_Envelope.Envelope({
+      supervisor: this.supervisor ?? import_RootSupervisor.RootSupervisor.for(import_model.any),
+      js: this.value
+    });
+  }
+  /**
+   * Create or replace item.
+   */
+  write(_request) {
+    throw new import_general.NotImplementedError();
+  }
+  /**
+   * Update item using matter.js patch semantics.
+   */
+  patch(_request) {
+    throw new import_general.NotImplementedError();
+  }
+  /**
+   * Add a child item of this item.
+   */
+  add(_request) {
+    throw new import_general.NotImplementedError();
+  }
+  /**
+   * Remove this item.
+   */
+  delete() {
+    throw new import_general.NotImplementedError();
+  }
+  /**
+   * The {@link Schema} for this resource subtree.
+   */
+  get schema() {
+    return this.supervisor?.schema;
+  }
+  /**
+   * Obtain the appropriate {@link ValueSupervisor} for a {@link Schema} in this subtree.
+   */
+  supervisorFor(schema) {
+    return this.rootSupervisor?.get(schema) ?? import_RootSupervisor.RootSupervisor.for(schema);
+  }
+  /**
+   * The {@link RootSupervisor} for this resource subtree.
+   */
+  get rootSupervisor() {
+    return this.parent?.rootSupervisor;
+  }
+  /**
+   * Execute a procedure.
+   */
+  async invoke(_request) {
+    throw new import_general.NotImplementedError();
+  }
+  /**
+   * Subscribe to events.
+   */
+  // eslint-disable-next-line require-yield
+  async *subscribe(_abort, _request) {
+    throw new import_general.NotImplementedError();
+  }
+  /**
+   * Retrieve a child with the specified ID.
+   */
+  async childFor(_id) {
+    return void 0;
+  }
+}
+//# sourceMappingURL=ApiResource.js.map

package/dist/cjs/behavior/system/remote/api/ApiResource.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/system/remote/api/ApiResource.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,4BAA+B;AAE/B,qBAAyD;AACzD,mBAA2C;AAC3C,sBAAyB;AAVzB;AAAA;AAAA;AAAA;AAAA;AAkBO,MAAe,YAAY;AAAA;AAAA;AAAA;AAAA,EASrB;AAAA;AAAA;AAAA;AAAA,EAoBA,cAAuB;AAAA;AAAA;AAAA;AAAA,EAKvB,iBAA0B;AAAA,EAOnC,YAAY,QAAiC;AACzC,SAAK,SAAS;AAAA,EAClB;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO;AACH,QAAI,KAAK,UAAU,QAAW;AAC1B;AAAA,IACJ;AAEA,WAAO,IAAI,yBAAS;AAAA,MAChB,YAAY,KAAK,cAAc,qCAAe,IAAI,gBAAG;AAAA,MACrD,IAAI,KAAK;AAAA,IACb,CAAC;AAAA,EACL;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAA+B;AACjC,UAAM,IAAI,mCAAoB;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,UAA6C;AAC/C,UAAM,IAAI,mCAAoB;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,UAA6C;AAC7C,UAAM,IAAI,mCAAoB;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,SAA6B;AACzB,UAAM,IAAI,mCAAoB;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,SAAS;AACT,WAAO,KAAK,YAAY;AAAA,EAC5B;AAAA;AAAA;AAAA;AAAA,EAKA,cAAc,QAAgB;AAC1B,WAAO,KAAK,gBAAgB,IAAI,MAAM,KAAK,qCAAe,IAAI,MAAM;AAAA,EACxE;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,iBAA6C;AAC7C,WAAO,KAAK,QAAQ;AAAA,EACxB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,OAAO,UAAyD;AAClE,UAAM,IAAI,mCAAoB;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,OAAO,UACH,QACA,UACmD;AACnD,UAAM,IAAI,mCAAoB;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,SAAS,KAA0C;AACrD,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/cjs/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/cjs/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/cjs/behavior/system/remote/api/Envelope.js

@@ -0,0 +1,107 @@
+"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 Envelope_exports = {};
+__export(Envelope_exports, {
+  Envelope: () => Envelope
+});
+module.exports = __toCommonJS(Envelope_exports);
+var import_context = require("#behavior/context/index.js");
+var import_general = require("#general");
+var import_model = require("#model");
+var import_types = require("#types");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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 = (0, import_model.DataModelPath)(this.#supervisor.schema.path);
+    }
+    this.#js = this.#supervisor.cast(this.#js);
+    this.#supervisor.validate?.(this.js, import_context.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 import_types.StatusResponse.FailureError(`Unparseable JSON: ${e.message}`);
+          }
+          throw e;
+        }
+      } else if (this.#tlv) {
+        this.#js = (0, import_types.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 = (0, import_general.asJson)(this.js);
+    }
+    return this.#json;
+  }
+  /**
+   * Serialized TLV format.
+   */
+  get tlv() {
+    if (this.#tlv === void 0) {
+      this.#tlv = (0, import_types.TlvOfModel)(this.#supervisor.schema).encode(this.#js);
+    }
+    return this.#tlv;
+  }
+}
+//# sourceMappingURL=Envelope.js.map

package/dist/cjs/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,qBAAkC;AAElC,qBAA8B;AAC9B,mBAA8B;AAC9B,mBAA2C;AAV3C;AAAA;AAAA;AAAA;AAAA;AAkBO,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,iBAAO,4BAAc,KAAK,YAAY,OAAO,IAAI;AAAA,IACrD;AAEA,SAAK,MAAM,KAAK,YAAY,KAAK,KAAK,GAAG;AACzC,SAAK,YAAY,WAAW,KAAK,IAAI,iCAAkB,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,4BAAe,aAAa,qBAAqB,EAAE,OAAO,EAAE;AAAA,UAC1E;AACA,gBAAM;AAAA,QACV;AAAA,MACJ,WAAW,KAAK,MAAM;AAClB,aAAK,UAAM,yBAAW,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,YAAQ,uBAAO,KAAK,EAAE;AAAA,IAC/B;AACA,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,MAAM;AACN,QAAI,KAAK,SAAS,QAAW;AACzB,WAAK,WAAO,yBAAW,KAAK,YAAY,MAAM,EAAE,OAAO,KAAK,GAAG;AAAA,IACnE;AACA,WAAO,KAAK;AAAA,EAChB;AACJ;",
+  "names": []
+}

package/dist/cjs/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/cjs/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/cjs/behavior/system/remote/api/LocalResponse.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 LocalResponse_exports = {};
+module.exports = __toCommonJS(LocalResponse_exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=LocalResponse.js.map

package/dist/cjs/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;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/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/cjs/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/cjs/behavior/system/remote/api/RemoteRequest.js

@@ -0,0 +1,55 @@
+"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 RemoteRequest_exports = {};
+__export(RemoteRequest_exports, {
+  RemoteRequest: () => RemoteRequest
+});
+module.exports = __toCommonJS(RemoteRequest_exports);
+var import_general = require("#general");
+var import_types = require("#types");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function RemoteRequest(request) {
+  if (!(0, import_general.isObject)(request)) {
+    throw new import_types.StatusResponse.InvalidActionError("Request is not an object");
+  }
+  const { target, method } = request;
+  if (typeof method !== "string") {
+    throw new import_types.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 import_types.StatusResponse.InvalidActionError(`Unsupported request method "${method}"`);
+  }
+  if (typeof target !== "string") {
+    throw new import_types.StatusResponse.InvalidActionError('Request does not specify resource in "target" property');
+  }
+  return request;
+}
+//# sourceMappingURL=RemoteRequest.js.map

package/dist/cjs/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,qBAAyB;AAEzB,mBAA+B;AAR/B;AAAA;AAAA;AAAA;AAAA;AAwBO,SAAS,cAAc,SAAkB;AAC5C,MAAI,KAAC,yBAAS,OAAO,GAAG;AACpB,UAAM,IAAI,4BAAe,mBAAmB,0BAA0B;AAAA,EAC1E;AAEA,QAAM,EAAE,QAAQ,OAAO,IAAI;AAC3B,MAAI,OAAO,WAAW,UAAU;AAC5B,UAAM,IAAI,4BAAe,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,4BAAe,mBAAmB,+BAA+B,MAAM,GAAG;AAAA,EAC5F;AAEA,MAAI,OAAO,WAAW,UAAU;AAC5B,UAAM,IAAI,4BAAe,mBAAmB,wDAAwD;AAAA,EACxG;AAEA,SAAO;AACX;",
+  "names": []
+}

package/dist/cjs/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/cjs/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/cjs/behavior/system/remote/api/RemoteResponse.js

@@ -0,0 +1,65 @@
+"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 RemoteResponse_exports = {};
+__export(RemoteResponse_exports, {
+  RemoteResponse: () => RemoteResponse
+});
+module.exports = __toCommonJS(RemoteResponse_exports);
+var import_general = require("#general");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+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: import_general.MatterError.idFor(local.error.constructor),
+        message: local.error.bareMessage ?? local.error.message
+      };
+    default:
+      throw new import_general.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 = {}));
+//# sourceMappingURL=RemoteResponse.js.map

package/dist/cjs/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,qBAA2C;AAN3C;AAAA;AAAA;AAAA;AAAA;AAqBO,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,2BAAY,MAAM,MAAM,MAAM,WAAW;AAAA,QAC/C,SAAU,MAAM,MAA8B,eAAe,MAAM,MAAM;AAAA,MAC7E;AAAA,IAEJ;AACI,YAAM,IAAI,6BAAc,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/cjs/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/cjs/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/cjs/behavior/system/remote/api/index.js

@@ -0,0 +1,30 @@
+"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 api_exports = {};
+module.exports = __toCommonJS(api_exports);
+__reExport(api_exports, require("./Api.js"), module.exports);
+__reExport(api_exports, require("./ApiResource.js"), module.exports);
+__reExport(api_exports, require("./Envelope.js"), module.exports);
+__reExport(api_exports, require("./LocalResponse.js"), module.exports);
+__reExport(api_exports, require("./RemoteRequest.js"), module.exports);
+__reExport(api_exports, require("./RemoteResponse.js"), module.exports);
+__reExport(api_exports, require("./resources/index.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/system/remote/api/index.ts"],
+  "mappings": ";;;;;;;;;;;;;;;AAAA;AAAA;AAMA,wBAAc,qBANd;AAOA,wBAAc,6BAPd;AAQA,wBAAc,0BARd;AASA,wBAAc,+BATd;AAUA,wBAAc,+BAVd;AAWA,wBAAc,gCAXd;AAYA,wBAAc,iCAZd;AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}