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

package/dist/cjs/behavior/system/remote/RemoteInterface.js

@@ -0,0 +1,105 @@
+"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 RemoteInterface_exports = {};
+__export(RemoteInterface_exports, {
+  RemoteInterface: () => RemoteInterface
+});
+module.exports = __toCommonJS(RemoteInterface_exports);
+var import_general = require("#general");
+var import_ApiPath = require("./api/ApiPath.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("RemoteAdapter");
+class RemoteInterface {
+  #node;
+  #address;
+  #abort = new AbortController();
+  #root;
+  #workers = new import_general.BasicMultiplex();
+  constructor(node, address) {
+    if (address.appProtocol !== this.constructor.protocol) {
+      throw new import_general.ImplementationError(
+        `API endpoint type ${this.constructor.name} does not support address ${address}`
+      );
+    }
+    this.#node = node;
+    this.#address = address;
+    this.#root = new import_ApiPath.ApiPath(address);
+  }
+  get root() {
+    return this.#root;
+  }
+  get env() {
+    return this.#node.env;
+  }
+  get node() {
+    return this.#node;
+  }
+  get address() {
+    return this.#address;
+  }
+  get isAborted() {
+    return this.#abort.signal.aborted;
+  }
+  get abort() {
+    return this.#abort.signal;
+  }
+  static async create(node, address) {
+    const instance = new this(node, address);
+    try {
+      await instance.start();
+    } catch (e) {
+      await instance.close();
+      throw e;
+    }
+    return instance;
+  }
+  async close() {
+    if (this.isAborted) {
+      return;
+    }
+    this.#abort.abort();
+    try {
+      await this.stop();
+    } catch (e) {
+      logger.error(`Error terminating API endpoint ${this.address}`);
+    }
+  }
+  assertProtocol(appProtocol) {
+    if (this.address.appProtocol !== appProtocol) {
+      throw new import_general.ImplementationError(
+        `Invalid protocol ${this.address} for API endpoin type ${this.constructor.name}`
+      );
+    }
+  }
+  addWorker(worker, description) {
+    this.#workers.add(worker, description);
+  }
+  static protocol = "";
+  /**
+   * Stop servicing requests.  Called on close.  The default implementation just waits for any workers to complete.
+   */
+  async stop() {
+    await this.#workers.close();
+  }
+}
+//# sourceMappingURL=RemoteInterface.js.map

package/dist/cjs/behavior/system/remote/RemoteInterface.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/system/remote/RemoteInterface.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAwE;AAExE,qBAAwB;AARxB;AAAA;AAAA;AAAA;AAAA;AAUA,MAAM,SAAS,sBAAO,IAAI,eAAe;AAKlC,MAAe,gBAAgB;AAAA,EAClC;AAAA,EACA;AAAA,EACA,SAAS,IAAI,gBAAgB;AAAA,EAC7B;AAAA,EACA,WAAW,IAAI,8BAAe;AAAA,EAE9B,YAAY,MAAkB,SAAqB;AAC/C,QAAI,QAAQ,gBAAiB,KAAK,YAAgD,UAAU;AACxF,YAAM,IAAI;AAAA,QACN,qBAAqB,KAAK,YAAY,IAAI,6BAA6B,OAAO;AAAA,MAClF;AAAA,IACJ;AACA,SAAK,QAAQ;AACb,SAAK,WAAW;AAChB,SAAK,QAAQ,IAAI,uBAAQ,OAAO;AAAA,EACpC;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,MAAM;AACN,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EAEA,IAAI,OAAO;AACP,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,UAAU;AACV,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,YAAY;AACZ,WAAO,KAAK,OAAO,OAAO;AAAA,EAC9B;AAAA,EAEA,IAAI,QAAQ;AACR,WAAO,KAAK,OAAO;AAAA,EACvB;AAAA,EAEA,aAAa,OAET,MACA,SACF;AACE,UAAM,WAAW,IAAI,KAAK,MAAM,OAAO;AACvC,QAAI;AACA,YAAM,SAAS,MAAM;AAAA,IACzB,SAAS,GAAG;AACR,YAAM,SAAS,MAAM;AACrB,YAAM;AAAA,IACV;AACA,WAAO;AAAA,EACX;AAAA,EAEA,MAAM,QAAuB;AACzB,QAAI,KAAK,WAAW;AAChB;AAAA,IACJ;AAEA,SAAK,OAAO,MAAM;AAElB,QAAI;AACA,YAAM,KAAK,KAAK;AAAA,IACpB,SAAS,GAAG;AACR,aAAO,MAAM,kCAAkC,KAAK,OAAO,EAAE;AAAA,IACjE;AAAA,EACJ;AAAA,EAEU,eAAe,aAAqB;AAC1C,QAAI,KAAK,QAAQ,gBAAgB,aAAa;AAC1C,YAAM,IAAI;AAAA,QACN,oBAAoB,KAAK,OAAO,yBAAyB,KAAK,YAAY,IAAI;AAAA,MAClF;AAAA,IACJ;AAAA,EACJ;AAAA,EAEU,UAAU,QAAuB,aAAqB;AAC5D,SAAK,SAAS,IAAI,QAAQ,WAAW;AAAA,EACzC;AAAA,EAEA,OAAO,WAAW;AAAA;AAAA;AAAA;AAAA,EAUlB,MAAgB,OAAsB;AAClC,UAAM,KAAK,SAAS,MAAM;AAAA,EAC9B;AACJ;",
+  "names": []
+}

package/dist/cjs/behavior/system/remote/RemoteServer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Behavior } from "#behavior/Behavior.js";
+import { DatatypeModel } from "#model";
+import { RemoteInterface } from "./RemoteInterface.js";
+/**
+ * Base class for {@link Behavior}s that enable remote access to a {@link ServerNode} via a non-Matter API.
+ *
+ * Each protocol supported by Matter.js implements a subclass of {@link RemoteServer} and {@link RemoteInterface}.
+ *
+ * The {@link RemoteServer} provides a convenient interface for adding a protocol to a {@link ServerNode}.  The The
+ * {@link RemoteInterface} implements the actual protocol.
+ *
+ * For greater control you may instantiate and manage {@link RemoteInterface} separately from {@link RemoteServer}. To
+ * implement your own protocol you may extend the server implementations provided by matter.js, or create a new protocol
+ * implementation by subclassing {@link RemoteInterface} yourself.
+ */
+export declare abstract class RemoteServer extends Behavior {
+    #private;
+    static readonly early = true;
+    static interfaceType: RemoteInterface.Type;
+    internal: RemoteServer.Internal;
+    state: RemoteServer.State;
+    initialize(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+    static readonly schema: DatatypeModel;
+}
+export declare namespace RemoteServer {
+    class Internal {
+        interface?: RemoteInterface;
+    }
+    class State {
+        /**
+         * The public address at which the service endpoint is accessible.
+         *
+         * The address is a URL.  See subclasses for supported protocols.  An "s" suffix indicates standard TLS support.
+         * The "+unix" suffix indicates that the hostname is a URL encoded path to a UNIX socket.  The socket path may
+         * be absolute or relative to the node's storage root.
+         *
+         * The path portion of the URL generally acts as a namespace prefix for the relevant protocol implementation.
+         * Matter.js replaces the special token `{node}` in the URL with the {@link ServerNode.id}.  This allows for
+         * multiple nodes to participate in a protocol in separate namespaces.
+         */
+        address: string;
+        /**
+         * Set to false to disable this service.
+         */
+        enabled: boolean;
+        /**
+         * By default the HTTP endpoint is available as soon as the {@link Node} initializes.
+         *
+         * If you set this to false, the HTTP endpoint is only available when the {@link Node}'s Matter networking is
+         * also online.
+         */
+        allowOfflineUse: boolean;
+    }
+}
+//# sourceMappingURL=RemoteServer.d.ts.map

package/dist/cjs/behavior/system/remote/RemoteServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteServer.d.ts","sourceRoot":"","sources":["../../../../../src/behavior/system/remote/RemoteServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGjD,OAAO,EAAE,aAAa,EAAgB,MAAM,QAAQ,CAAC;AAGrD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,8BAAsB,YAAa,SAAQ,QAAQ;;IAC/C,gBAAyB,KAAK,QAAQ;IAEtC,MAAM,CAAC,aAAa,EAAE,eAAe,CAAC,IAAI,CAAC;IAEnC,QAAQ,EAAE,YAAY,CAAC,QAAQ,CAAC;IAChC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;IAEnB,UAAU;IAiBhB,CAAC,MAAM,CAAC,YAAY,CAAC;IAoC9B,gBAAyB,MAAM,gBAS7B;CACL;AAED,yBAAiB,YAAY,CAAC;IAC1B,MAAa,QAAQ;QACjB,SAAS,CAAC,EAAE,eAAe,CAAC;KAC/B;IAED,MAAa,KAAK;QACd;;;;;;;;;;WAUG;QACH,OAAO,SAAM;QAEb;;WAEG;QACH,OAAO,UAAQ;QAEf;;;;;WAKG;QACH,eAAe,UAAQ;KAC1B;CACJ"}

package/dist/cjs/behavior/system/remote/RemoteServer.js

@@ -0,0 +1,118 @@
+"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 RemoteServer_exports = {};
+__export(RemoteServer_exports, {
+  RemoteServer: () => RemoteServer
+});
+module.exports = __toCommonJS(RemoteServer_exports);
+var import_Behavior = require("#behavior/Behavior.js");
+var import_endpoint = require("#endpoint/index.js");
+var import_general = require("#general");
+var import_model = require("#model");
+var import_node = require("#node/index.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class RemoteServer extends import_Behavior.Behavior {
+  static early = true;
+  static interfaceType;
+  async initialize() {
+    if (!(this.env.get(import_endpoint.EndpointInitializer) instanceof import_node.ServerEndpointInitializer)) {
+      throw new import_general.ImplementationError("Remote server is not installed in a ServerNode");
+    }
+    this.reactTo(this.endpoint.lifecycle.online, this.#start);
+    this.reactTo(this.endpoint.lifecycle.offline, this.#onOffline);
+    this.reactTo(this.endpoint.lifecycle.destroying, this.#stop);
+    if (this.state.allowOfflineUse) {
+      await this.#start();
+    }
+  }
+  [Symbol.asyncDispose]() {
+    return this.#stop();
+  }
+  async #start() {
+    if (!this.state.enabled || this.internal.interface) {
+      return;
+    }
+    const interfaceType = this.constructor.interfaceType;
+    if (typeof interfaceType !== "function") {
+      throw new import_general.InternalError(`Remote server ${this.constructor.name} does not define a remote interface`);
+    }
+    const address = new import_general.AppAddress(this.state.address);
+    const intf = await interfaceType.create(this.endpoint, address);
+    this.internal.interface = intf;
+  }
+  async #stop() {
+    const { interface: intf } = this.internal;
+    if (!intf) {
+      return;
+    }
+    this.internal.interface = void 0;
+    await intf.close();
+  }
+  async #onOffline() {
+    if (!this.state.allowOfflineUse) {
+      await this.#stop();
+    }
+  }
+  static schema = new import_model.DatatypeModel(
+    {
+      name: "ApiState",
+      type: "struct"
+    },
+    (0, import_model.FieldElement)({ name: "address", type: "string" }),
+    (0, import_model.FieldElement)({ name: "enabled", type: "bool" }),
+    (0, import_model.FieldElement)({ name: "allowOfflineUse", type: "bool" })
+  );
+}
+((RemoteServer2) => {
+  class Internal {
+    interface;
+  }
+  RemoteServer2.Internal = Internal;
+  class State {
+    /**
+     * The public address at which the service endpoint is accessible.
+     *
+     * The address is a URL.  See subclasses for supported protocols.  An "s" suffix indicates standard TLS support.
+     * The "+unix" suffix indicates that the hostname is a URL encoded path to a UNIX socket.  The socket path may
+     * be absolute or relative to the node's storage root.
+     *
+     * The path portion of the URL generally acts as a namespace prefix for the relevant protocol implementation.
+     * Matter.js replaces the special token `{node}` in the URL with the {@link ServerNode.id}.  This allows for
+     * multiple nodes to participate in a protocol in separate namespaces.
+     */
+    address = "";
+    /**
+     * Set to false to disable this service.
+     */
+    enabled = true;
+    /**
+     * By default the HTTP endpoint is available as soon as the {@link Node} initializes.
+     *
+     * If you set this to false, the HTTP endpoint is only available when the {@link Node}'s Matter networking is
+     * also online.
+     */
+    allowOfflineUse = true;
+  }
+  RemoteServer2.State = State;
+})(RemoteServer || (RemoteServer = {}));
+//# sourceMappingURL=RemoteServer.js.map

package/dist/cjs/behavior/system/remote/RemoteServer.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/behavior/system/remote/RemoteServer.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAAyB;AACzB,sBAAoC;AACpC,qBAA+D;AAC/D,mBAA4C;AAE5C,kBAA0C;AAX1C;AAAA;AAAA;AAAA;AAAA;AA0BO,MAAe,qBAAqB,yBAAS;AAAA,EAChD,OAAyB,QAAQ;AAAA,EAEjC,OAAO;AAAA,EAKP,MAAe,aAAa;AACxB,QAAI,EAAE,KAAK,IAAI,IAAI,mCAAmB,aAAa,wCAA4B;AAC3E,YAAM,IAAI,mCAAoB,gDAAgD;AAAA,IAClF;AAEA,SAAK,QAAS,KAAK,SAAwB,UAAU,QAAQ,KAAK,MAAM;AACxE,SAAK,QAAS,KAAK,SAAwB,UAAU,SAAS,KAAK,UAAU;AAI7E,SAAK,QAAS,KAAK,SAAwB,UAAU,YAAY,KAAK,KAAK;AAE3E,QAAI,KAAK,MAAM,iBAAiB;AAC5B,YAAM,KAAK,OAAO;AAAA,IACtB;AAAA,EACJ;AAAA,EAEA,CAAU,OAAO,YAAY,IAAI;AAC7B,WAAO,KAAK,MAAM;AAAA,EACtB;AAAA,EAEA,MAAM,SAAS;AACX,QAAI,CAAC,KAAK,MAAM,WAAW,KAAK,SAAS,WAAW;AAChD;AAAA,IACJ;AAEA,UAAM,gBAAiB,KAAK,YAAoC;AAChE,QAAI,OAAQ,kBAA0B,YAAY;AAC9C,YAAM,IAAI,6BAAc,iBAAiB,KAAK,YAAY,IAAI,qCAAqC;AAAA,IACvG;AAEA,UAAM,UAAU,IAAI,0BAAW,KAAK,MAAM,OAAO;AACjD,UAAM,OAAO,MAAM,cAAc,OAAO,KAAK,UAAwB,OAAO;AAE5E,SAAK,SAAS,YAAY;AAAA,EAC9B;AAAA,EAEA,MAAM,QAAQ;AACV,UAAM,EAAE,WAAW,KAAK,IAAI,KAAK;AACjC,QAAI,CAAC,MAAM;AACP;AAAA,IACJ;AAEA,SAAK,SAAS,YAAY;AAC1B,UAAM,KAAK,MAAM;AAAA,EACrB;AAAA,EAEA,MAAM,aAAa;AACf,QAAI,CAAC,KAAK,MAAM,iBAAiB;AAC7B,YAAM,KAAK,MAAM;AAAA,IACrB;AAAA,EACJ;AAAA,EAEA,OAAyB,SAAS,IAAI;AAAA,IAClC;AAAA,MACI,MAAM;AAAA,MACN,MAAM;AAAA,IACV;AAAA,QAEA,2BAAa,EAAE,MAAM,WAAW,MAAM,SAAS,CAAC;AAAA,QAChD,2BAAa,EAAE,MAAM,WAAW,MAAM,OAAO,CAAC;AAAA,QAC9C,2BAAa,EAAE,MAAM,mBAAmB,MAAM,OAAO,CAAC;AAAA,EAC1D;AACJ;AAAA,CAEO,CAAUA,kBAAV;AAAA,EACI,MAAM,SAAS;AAAA,IAClB;AAAA,EACJ;AAFO,EAAAA,cAAM;AAAA,EAIN,MAAM,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAYf,UAAU;AAAA;AAAA;AAAA;AAAA,IAKV,UAAU;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAQV,kBAAkB;AAAA,EACtB;AA1BO,EAAAA,cAAM;AAAA,GALA;",
+  "names": ["RemoteServer"]
+}

package/dist/cjs/behavior/system/remote/api/Api.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Agent } from "#endpoint/Agent.js";
+import { Abort } from "#general";
+import { ServerNode } from "#node/ServerNode.js";
+import { ApiPath } from "./ApiPath.js";
+import { ApiResource } from "./ApiResource.js";
+import { LocalResponse } from "./LocalResponse.js";
+import { RemoteRequest } from "./RemoteRequest.js";
+import { RemoteResponse } from "./RemoteResponse.js";
+/**
+ * Common substrate for the network APIs.
+ *
+ * The logical API covers RPC and read/write semantics.  These involve a "/"-separated path and a logical operation
+ * (read, write, invoke, etc.)
+ *
+ * This namespace provides utilities for mapping paths to resources and taking action on the resource.
+ */
+export declare namespace Api {
+    /**
+     * Retrieve the {@link ApiResource} for a path.
+     */
+    function resourceFor(agent: Agent, path: ApiPath): Promise<ApiResource | void>;
+    function log(level: "error" | "info", facility: string, id: string | undefined, ...message: unknown[]): void;
+    function logRequest(facility: string, id: string | undefined, method: string, target: string): void;
+    function logResponse(facility: string, response: RemoteResponse): void;
+    /**
+     * Execute a {@link RemoteRequest}.
+     */
+    function execute(facility: string, node: ServerNode, request: RemoteRequest, signal: Abort.Signal): Promise<LocalResponse>;
+    function errorResponseOf(facility: string, id: string | undefined, error: unknown): LocalResponse;
+}
+//# sourceMappingURL=Api.d.ts.map

package/dist/cjs/behavior/system/remote/api/Api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Api.d.ts","sourceRoot":"","sources":["../../../../../../src/behavior/system/remote/api/Api.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,KAAK,EAA8C,MAAM,UAAU,CAAC;AAE7E,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD;;;;;;;GAOG;AACH,yBAAiB,GAAG,CAAC;IACjB;;OAEG;IACH,SAAsB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwB1F;IAED,SAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,QAM3G;IAED,SAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAElG;IAED,SAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,QAerE;IAED;;OAEG;IACH,SAAsB,OAAO,CACzB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,aAAa,EACtB,MAAM,EAAE,KAAK,CAAC,MAAM,GACrB,OAAO,CAAC,aAAa,CAAC,CAmExB;IAED,SAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,GAAG,aAAa,CAWvG;CACJ"}

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

@@ -0,0 +1,156 @@
+"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 Api_exports = {};
+__export(Api_exports, {
+  Api: () => Api
+});
+module.exports = __toCommonJS(Api_exports);
+var import_general = require("#general");
+var import_Node = require("#node/Node.js");
+var import_types = require("#types");
+var import_ApiPath = require("./ApiPath.js");
+var import_EndpointResource = require("./resources/EndpointResource.js");
+var import_NodeResource = require("./resources/NodeResource.js");
+var import_ServerNodeResource = require("./resources/ServerNodeResource.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const loggers = /* @__PURE__ */ new Map();
+var Api;
+((Api2) => {
+  async function resourceFor(agent, path) {
+    let item;
+    if ("peers" in agent.endpoint) {
+      item = new import_ServerNodeResource.ServerNodeResource(agent, void 0);
+    } else if (agent.endpoint instanceof import_Node.Node) {
+      item = new import_NodeResource.NodeResource(agent, void 0);
+    } else {
+      item = new import_EndpointResource.EndpointResource(agent, void 0);
+    }
+    const breadcrumb = [item];
+    for (const segment of path) {
+      const parent = breadcrumb[breadcrumb.length - 1];
+      const item2 = await parent.childFor(segment);
+      if (!item2) {
+        return;
+      }
+      breadcrumb.push(item2);
+    }
+    return breadcrumb[breadcrumb.length - 1];
+  }
+  Api2.resourceFor = resourceFor;
+  function log(level, facility, id, ...message) {
+    let logger = loggers.get(facility);
+    if (!logger) {
+      loggers.set(facility, logger = import_general.Logger.get(facility));
+    }
+    logger[level](import_general.Diagnostic.via(id ?? "(anon)"), message);
+  }
+  Api2.log = log;
+  function logRequest(facility, id, method, target) {
+    log("info", facility, id, "\xAB", import_general.Diagnostic.strong(method), target);
+  }
+  Api2.logRequest = logRequest;
+  function logResponse(facility, response) {
+    const message = Array("\xBB", response.kind);
+    let level;
+    switch (response.kind) {
+      case "error":
+        message.push(import_general.Diagnostic.squash("[", import_general.Diagnostic.strong(response.code), "]"));
+        message.push(response.message);
+        level = "error";
+        break;
+      default:
+        level = "info";
+        break;
+    }
+    log(level, facility, response.id, message);
+  }
+  Api2.logResponse = logResponse;
+  async function execute(facility, node, request, signal) {
+    const { target, method, id } = request;
+    logRequest(facility, id, method, target);
+    try {
+      const message = await node.act("remote", async (agent) => {
+        const item = await resourceFor(agent, new import_ApiPath.ApiPath(target));
+        if (item === void 0) {
+          throw new import_types.StatusResponse.NotFoundError(`Target "${target}" not found`);
+        }
+        switch (method) {
+          case "read":
+            const value = item.read();
+            if (value === void 0) {
+              throw new import_types.StatusResponse.UnsupportedReadError(`Target "${target}" is not readable`);
+            }
+            value.convertToJson();
+            return {
+              kind: "value",
+              id,
+              // TODO - consider handling serialization here (in agent context) so copy is unnecessary
+              value
+            };
+          case "write":
+            item.write({ js: request.value });
+            return { kind: "ok", id };
+          case "add":
+            item.add({ js: item.value });
+            return { kind: "ok", id };
+          case "delete":
+            item.delete();
+            return { kind: "ok", id };
+          case "invoke": {
+            const value2 = await item.invoke({ js: request.parameters });
+            if (value2?.js === void 0 || value2?.js === null) {
+              return { kind: "ok", id };
+            }
+            value2.convertToJson();
+            return { id, kind: "value", value: value2 };
+          }
+          case "subscribe": {
+            const options = { ...request };
+            for (const field of ["target", "id", "method"]) {
+              delete options[field];
+            }
+            const stream = item.subscribe(signal, {
+              id,
+              js: options
+            });
+            return { kind: "subscription", id, stream };
+          }
+        }
+      });
+      return message;
+    } catch (error) {
+      return errorResponseOf(facility, id, error);
+    }
+  }
+  Api2.execute = execute;
+  function errorResponseOf(facility, id, error) {
+    error = (0, import_general.asError)(error);
+    if (error instanceof import_types.StatusResponseError) {
+      return { kind: "error", id, error };
+    }
+    log("error", facility, id, "Internal error:", error);
+    return { kind: "error", id, error: new import_general.InternalError() };
+  }
+  Api2.errorResponseOf = errorResponseOf;
+})(Api || (Api = {}));
+//# sourceMappingURL=Api.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/system/remote/api/Api.ts"],
+  "mappings": "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",
+  "names": ["Api", "item", "value"]
+}

package/dist/cjs/behavior/system/remote/api/ApiPath.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AppAddress } from "#general";
+/**
+ * A logical path in the API.
+ */
+export declare class ApiPath {
+    #private;
+    /**
+     * Create a new path from:
+     *
+     * * An {@link AppAddress#pathname}
+     * * A text path, delimited with "/" with URL encoded segments
+     * * An array of decoded segments
+     *
+     * Ignores path segments that are empty or ".".  ".." resolves up one level.
+     *
+     * So generally normal UNIX/URL semantics.
+     */
+    constructor(path: AppAddress | string | string[]);
+    get isEmpty(): boolean;
+    [Symbol.iterator](): ArrayIterator<string>;
+    slice(start?: number, end?: number): ApiPath;
+    at(path: AppAddress | string | string[]): ApiPath;
+    toString(): string;
+    includes(other: ApiPath): boolean;
+    subpathFor(other: ApiPath): ApiPath | undefined;
+}
+//# sourceMappingURL=ApiPath.d.ts.map

package/dist/cjs/behavior/system/remote/api/ApiPath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiPath.d.ts","sourceRoot":"","sources":["../../../../../../src/behavior/system/remote/api/ApiPath.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAe,MAAM,UAAU,CAAC;AAEnD;;GAEG;AACH,qBAAa,OAAO;;IAGhB;;;;;;;;;;OAUG;gBACS,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,EAAE;IAuBhD,IAAI,OAAO,YAEV;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC;IAIjB,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAIlC,EAAE,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,EAAE;IAqBvC,QAAQ;IAIR,QAAQ,CAAC,KAAK,EAAE,OAAO;IAIvB,UAAU,CAAC,KAAK,EAAE,OAAO;CAW5B"}

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

@@ -0,0 +1,101 @@
+"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 ApiPath_exports = {};
+__export(ApiPath_exports, {
+  ApiPath: () => ApiPath
+});
+module.exports = __toCommonJS(ApiPath_exports);
+var import_general = require("#general");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class ApiPath {
+  #segments = Array();
+  /**
+   * Create a new path from:
+   *
+   * * An {@link AppAddress#pathname}
+   * * A text path, delimited with "/" with URL encoded segments
+   * * An array of decoded segments
+   *
+   * Ignores path segments that are empty or ".".  ".." resolves up one level.
+   *
+   * So generally normal UNIX/URL semantics.
+   */
+  constructor(path) {
+    if (path instanceof URL) {
+      path = path.pathname;
+    }
+    if (!Array.isArray(path)) {
+      path = path.split("/").map(decodeURIComponent);
+    }
+    for (const segment of path) {
+      if (segment === "" || segment === ".") {
+        continue;
+      }
+      if (segment === "..") {
+        this.#segments.pop();
+        continue;
+      }
+      this.#segments.push(segment);
+    }
+  }
+  get isEmpty() {
+    return !this.#segments.length;
+  }
+  [Symbol.iterator]() {
+    return this.#segments[Symbol.iterator]();
+  }
+  slice(start, end) {
+    return new ApiPath(this.#segments.slice(start, end));
+  }
+  at(path) {
+    if (this.isEmpty) {
+      return new ApiPath(path);
+    }
+    if (path instanceof URL) {
+      path = path.pathname;
+    }
+    if (Array.isArray(path)) {
+      path = path.map(encodeURIComponent).join("/");
+    }
+    if (path.startsWith("/")) {
+      return new ApiPath(path);
+    }
+    return new ApiPath(`${this.toString()}/${path}`);
+  }
+  toString() {
+    return `${this.#segments.map(encodeURIComponent).join("/")}`;
+  }
+  includes(other) {
+    return (0, import_general.isDeepEqual)(this.#segments, other.slice(0, this.#segments.length).#segments);
+  }
+  subpathFor(other) {
+    if (!this.#segments.length) {
+      return other;
+    }
+    if (!this.includes(other)) {
+      return void 0;
+    }
+    return other.slice(this.#segments.length);
+  }
+}
+//# sourceMappingURL=ApiPath.js.map

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

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../../src/behavior/system/remote/api/ApiPath.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,qBAAwC;AANxC;AAAA;AAAA;AAAA;AAAA;AAWO,MAAM,QAAQ;AAAA,EACjB,YAAY,MAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAa1B,YAAY,MAAsC;AAC9C,QAAI,gBAAgB,KAAK;AACrB,aAAO,KAAK;AAAA,IAChB;AAEA,QAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACtB,aAAO,KAAK,MAAM,GAAG,EAAE,IAAI,kBAAkB;AAAA,IACjD;AAEA,eAAW,WAAW,MAAM;AACxB,UAAI,YAAY,MAAM,YAAY,KAAK;AACnC;AAAA,MACJ;AAEA,UAAI,YAAY,MAAM;AAClB,aAAK,UAAU,IAAI;AACnB;AAAA,MACJ;AAEA,WAAK,UAAU,KAAK,OAAO;AAAA,IAC/B;AAAA,EACJ;AAAA,EAEA,IAAI,UAAU;AACV,WAAO,CAAC,KAAK,UAAU;AAAA,EAC3B;AAAA,EAEA,CAAC,OAAO,QAAQ,IAAI;AAChB,WAAO,KAAK,UAAU,OAAO,QAAQ,EAAE;AAAA,EAC3C;AAAA,EAEA,MAAM,OAAgB,KAAc;AAChC,WAAO,IAAI,QAAQ,KAAK,UAAU,MAAM,OAAO,GAAG,CAAC;AAAA,EACvD;AAAA,EAEA,GAAG,MAAsC;AACrC,QAAI,KAAK,SAAS;AACd,aAAO,IAAI,QAAQ,IAAI;AAAA,IAC3B;AAEA,QAAI,gBAAgB,KAAK;AACrB,aAAO,KAAK;AAAA,IAChB;AAEA,QAAI,MAAM,QAAQ,IAAI,GAAG;AACrB,aAAO,KAAK,IAAI,kBAAkB,EAAE,KAAK,GAAG;AAAA,IAChD;AAEA,QAAI,KAAK,WAAW,GAAG,GAAG;AACtB,aAAO,IAAI,QAAQ,IAAI;AAAA,IAC3B;AAGA,WAAO,IAAI,QAAQ,GAAG,KAAK,SAAS,CAAC,IAAI,IAAI,EAAE;AAAA,EACnD;AAAA,EAEA,WAAW;AACP,WAAO,GAAG,KAAK,UAAU,IAAI,kBAAkB,EAAE,KAAK,GAAG,CAAC;AAAA,EAC9D;AAAA,EAEA,SAAS,OAAgB;AACrB,eAAO,4BAAY,KAAK,WAAW,MAAM,MAAM,GAAG,KAAK,UAAU,MAAM,EAAE,SAAS;AAAA,EACtF;AAAA,EAEA,WAAW,OAAgB;AACvB,QAAI,CAAC,KAAK,UAAU,QAAQ;AACxB,aAAO;AAAA,IACX;AAEA,QAAI,CAAC,KAAK,SAAS,KAAK,GAAG;AACvB,aAAO;AAAA,IACX;AAEA,WAAO,MAAM,MAAM,KAAK,UAAU,MAAM;AAAA,EAC5C;AACJ;",
+  "names": []
+}