@matter/node 0.17.0-alpha.0-20260507-059f7763b → 0.17.0-alpha.0-20260508-29ff5ae9e

package/dist/cjs/endpoint/Endpoint.js

@@ -1,948 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __knownSymbol = (name, symbol) => (symbol = Symbol[name]) ? symbol : /* @__PURE__ */ Symbol.for("Symbol." + name);
-var __typeError = (msg) => {
-  throw TypeError(msg);
-};
-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 __using = (stack, value, async) => {
-  if (value != null) {
-    if (typeof value !== "object" && typeof value !== "function") __typeError("Object expected");
-    var dispose, inner;
-    if (async) dispose = value[__knownSymbol("asyncDispose")];
-    if (dispose === void 0) {
-      dispose = value[__knownSymbol("dispose")];
-      if (async) inner = dispose;
-    }
-    if (typeof dispose !== "function") __typeError("Object not disposable");
-    if (inner) dispose = function() {
-      try {
-        inner.call(this);
-      } catch (e) {
-        return Promise.reject(e);
-      }
-    };
-    stack.push([async, dispose, value]);
-  } else if (async) {
-    stack.push([async]);
-  }
-  return value;
-};
-var __callDispose = (stack, error, hasError) => {
-  var E = typeof SuppressedError === "function" ? SuppressedError : function(e, s, m, _) {
-    return _ = Error(m), _.name = "SuppressedError", _.error = e, _.suppressed = s, _;
-  };
-  var fail = (e) => error = hasError ? new E(e, error, "An error was suppressed during disposal") : (hasError = true, e);
-  var next = (it) => {
-    while (it = stack.pop()) {
-      try {
-        var result = it[1] && it[1].call(it[2]);
-        if (it[0]) return Promise.resolve(result).then(next, (e) => (fail(e), next()));
-      } catch (e) {
-        fail(e);
-      }
-    }
-    if (hasError) throw error;
-  };
-  return next();
-};
-var Endpoint_exports = {};
-__export(Endpoint_exports, {
-  Endpoint: () => Endpoint
-});
-module.exports = __toCommonJS(Endpoint_exports);
-var import_Behavior = require("#behavior/Behavior.js");
-var import_NodeActivity = require("#behavior/context/NodeActivity.js");
-var import_ContextAgents = require("#behavior/context/server/ContextAgents.js");
-var import_LocalActorContext = require("#behavior/context/server/LocalActorContext.js");
-var import_ProtocolService = require("#node/integration/ProtocolService.js");
-var import_IdentityService = require("#node/server/IdentityService.js");
-var import_general = require("@matter/general");
-var import_model = require("@matter/model");
-var import_protocol = require("@matter/protocol");
-var import_types = require("@matter/types");
-var import_root = require("../endpoints/root.js");
-var import_Agent = require("./Agent.js");
-var import_errors = require("./errors.js");
-var import_Behaviors = require("./properties/Behaviors.js");
-var import_Commands = require("./properties/Commands.js");
-var import_EndpointInitializer = require("./properties/EndpointInitializer.js");
-var import_EndpointLifecycle = require("./properties/EndpointLifecycle.js");
-var import_Parts = require("./properties/Parts.js");
-var import_EndpointType = require("./type/EndpointType.js");
-/**
- * @license
- * Copyright 2022-2026 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-const logger = import_general.Logger.get("Endpoint");
-class Endpoint {
-  #type;
-  #id;
-  #number;
-  #owner;
-  #agentType;
-  #behaviors;
-  #lifecycle;
-  #parts;
-  #construction;
-  #stateView = {};
-  #events = {};
-  #commands;
-  #activity;
-  /**
-   * A string that uniquely identifies an endpoint.
-   *
-   * This ID must be unique amongst all Parts with the same owner.
-   */
-  get id() {
-    if (this.#id === void 0) {
-      throw new import_general.UninitializedDependencyError(
-        this.toString(),
-        "endpoint ID is not yet assigned; set ID or await endpoint.construction to avoid this error"
-      );
-    }
-    return this.#id;
-  }
-  /**
-   * The endpoint ID or undefined if not yet assigned.
-   */
-  get maybeId() {
-    return this.#id;
-  }
-  /**
-   * The Matter {@link EndpointNumber} of the endpoint.  This uniquely identifies the {@link Endpoint} in the scope of the
-   * Matter node.
-   */
-  get number() {
-    if (this.#number === void 0) {
-      throw new import_general.UninitializedDependencyError(
-        this.toString(),
-        "endpoint number is not yet assigned; set number or await endpoint.construction to avoid this error"
-      );
-    }
-    return this.#number;
-  }
-  /**
-   * The endpoint number or undefined if not yet assigned.
-   */
-  get maybeNumber() {
-    return this.#number;
-  }
-  /**
-   * The owner of the endpoint.
-   *
-   * Every endpoint but the root endpoint (the "server node") is owned by another endpoint.
-   */
-  get owner() {
-    return this.#owner;
-  }
-  /**
-   * Access an {@link Agent} for this endpoint.
-   *
-   * An {@link Agent} allows you to interact directly with the behaviors supported by the endpoint.  Normally you
-   * would use {@link act} to obtain an agent but {@link agentFor} is useful if you need to interact with multiple
-   * endpoints in the same context.
-   */
-  agentFor(context) {
-    return (0, import_ContextAgents.ContextAgents)(context).agentFor(this);
-  }
-  get endpointProtocol() {
-    if (this.#number === void 0 || !this.env.has(import_ProtocolService.ProtocolService)) {
-      return void 0;
-    }
-    return this.env.get(import_ProtocolService.ProtocolService).protocol[this.#number];
-  }
-  /**
-   * Search for the owner of a specific type.
-   *
-   * Returns undefined if this owner is not found on the way up to the root endpoint.
-   */
-  ownerOfType(type) {
-    for (let endpoint = this; endpoint !== void 0; endpoint = endpoint.owner) {
-      if (endpoint.type.deviceType === type.deviceType) {
-        return endpoint;
-      }
-    }
-  }
-  /**
-   * The endpoint's environment.  Endpoint implementations use the environment to access platform components such as
-   * storage and network components.
-   */
-  get env() {
-    if (this.owner) {
-      return this.owner.env;
-    }
-    return import_general.Environment.default;
-  }
-  /**
-   * Access the pool of behaviors supported by this endpoint.
-   */
-  get behaviors() {
-    return this.#behaviors;
-  }
-  /**
-   * Current state values for all behaviors, keyed by behavior ID.  This view is read-only.
-   */
-  get state() {
-    return this.#stateView;
-  }
-  stateOf(type) {
-    const state = this.maybeStateOf(type);
-    if (state) {
-      return state;
-    }
-    const id = typeof type === "string" ? type : type.id;
-    throw new import_general.ImplementationError(`Behavior ${id} is not supported by ${this}`);
-  }
-  maybeStateOf(type) {
-    if (typeof type === "string") {
-      if (!(type in this.#stateView)) {
-        return void 0;
-      }
-    } else {
-      if (!this.behaviors.has(type)) {
-        return void 0;
-      }
-      type = type.id;
-    }
-    return this.#stateView[type];
-  }
-  /**
-   * Update state values.  This is a patch operation; it only modifies properties in {@link values}.
-   *
-   * {@link values} is an object with a {@link Behavior.id} as the key and state values as sub-objects.
-   *
-   * Input values must adhere to the {@link Behavior.schema} of the target {@link Behavior}.  If not, set will throw
-   * an error.
-   *
-   * This is a transactional operation.  An error results in no change.  The endpoint will wait for exclusive access
-   * before applying changes.
-   *
-   * @param values the values to change
-   */
-  async set(values) {
-    await this.act(`set<${this}>`, async (agent) => {
-      const tx = agent.context.transaction;
-      await tx.begin();
-      for (const behaviorId in values) {
-        const behavior = agent[behaviorId];
-        if (!(behavior instanceof import_Behavior.Behavior)) {
-          throw new import_general.ImplementationError(`Behavior ID ${behaviorId} does not exist`);
-        }
-        const vals = values[behaviorId];
-        if (vals === void 0) {
-          continue;
-        }
-        await tx.addResources(behavior);
-        const patch = behavior.type.supervisor.patch;
-        if (typeof vals !== "object") {
-          throw new import_general.ImplementationError(
-            `State values for ${behaviorId} must be an object, not ${typeof vals}`
-          );
-        }
-        if (vals instanceof Date) {
-          throw new import_general.ImplementationError(
-            `State values for ${behaviorId} must be an object, not ${vals.constructor.name}`
-          );
-        }
-        if (Array.isArray(vals)) {
-          throw new import_general.ImplementationError(`State value for ${behaviorId} must be an object, not an array`);
-        }
-        patch(vals, behavior.state, this.path);
-      }
-    });
-  }
-  async setStateOf(type, values) {
-    if (typeof type === "string") {
-      const typeName = type;
-      type = this.behaviors.supported[type];
-      if (type === void 0) {
-        throw new import_general.ImplementationError(`Behavior ${typeName} is not supported by ${this}`);
-      }
-    }
-    await this.act(`setStateOf<${this}>`, async (agent) => {
-      const behavior = agent.get(type);
-      const tx = agent.context.transaction;
-      await tx.begin();
-      await tx.addResources(behavior);
-      const patch = behavior.type.supervisor.patch;
-      if (typeof values !== "object") {
-        throw new import_general.ImplementationError(`State values for ${type.id} must be an object, not ${typeof values}`);
-      }
-      if (values instanceof Date) {
-        throw new import_general.ImplementationError(
-          `State values for ${type.id} must be an object, not ${values.constructor.name}`
-        );
-      }
-      if (Array.isArray(values)) {
-        throw new import_general.ImplementationError(`State values for ${type.id} must be an object, not an array`);
-      }
-      patch(values, behavior.state, this.path);
-    });
-  }
-  async getStateOf(type, selector, options) {
-    const id = typeof type === "string" ? type : type.id;
-    const resolved = typeof type === "string" ? this.behaviors.supported[id] : type;
-    if (resolved === void 0 || !this.behaviors.has(resolved)) {
-      throw new import_errors.EndpointBehaviorNotPresentError(id);
-    }
-    const slice = await this.#performRead(
-      { [id]: selector ?? true },
-      options
-    );
-    return slice[id];
-  }
-  async get(selector, options) {
-    return this.#performRead(selector, options);
-  }
-  /**
-   * Commands for all behaviors keyed by behavior ID.
-   */
-  get commands() {
-    if (this.#commands === void 0) {
-      this.#commands = (0, import_Commands.Commands)(this);
-    }
-    return this.#commands;
-  }
-  /**
-   * Commands for a specific behavior.
-   */
-  commandsOf(type) {
-    if (!this.behaviors.has(type)) {
-      throw new import_general.ImplementationError(`Behavior ${type.id} is not supported by this endpoint`);
-    }
-    return this.commands[type.id];
-  }
-  /**
-   * Events for all behaviors keyed by behavior ID.
-   */
-  get events() {
-    return this.#events;
-  }
-  eventsOf(type) {
-    if (typeof type === "string") {
-      if (!(type in this.#stateView)) {
-        throw new import_general.ImplementationError(`Behavior ${type} is not supported by ${this}`);
-      }
-    } else {
-      if (!this.behaviors.has(type)) {
-        throw new import_general.ImplementationError(`Behavior ${type.id} is not supported by ${this}`);
-      }
-      type = type.id;
-    }
-    return this.#events[type];
-  }
-  get construction() {
-    return this.#construction;
-  }
-  constructor(definition, options) {
-    const config = Endpoint.configurationFor(definition, options);
-    this.#type = config.type;
-    this.#construction = (0, import_general.Construction)(this);
-    this.#lifecycle = this.createLifecycle(config.isEssential);
-    this.#lifecycle.ready.on(() => this.#logReady());
-    if (config.id !== void 0) {
-      this.id = config.id;
-    }
-    if (config.number !== void 0) {
-      this.number = config.number;
-    }
-    this.#behaviors = new import_Behaviors.Behaviors(this, config);
-    if (config.owner) {
-      this.owner = config.owner instanceof import_Agent.Agent ? config.owner.endpoint : config.owner;
-    }
-    if (config.parts) {
-      for (const part of config.parts) {
-        this.parts.add(part);
-      }
-    }
-  }
-  set id(id) {
-    if (this.#id === id) {
-      return;
-    }
-    if (this.#id !== void 0) {
-      throw new import_general.ImplementationError(`${this} ID is already assigned, cannot reassign`);
-    }
-    if (typeof id !== "string") {
-      throw new import_general.ImplementationError(`Illegal endpoint ID type "${typeof id}"`);
-    }
-    if (id === "") {
-      throw new import_general.ImplementationError("Endpoint ID may not be empty");
-    }
-    if (id.includes(".")) {
-      throw new import_general.ImplementationError('Endpoint ID may not include "."');
-    }
-    if (this.lifecycle.isInstalled) {
-      this.#container.assertIdAvailable(id, this);
-    }
-    this.#id = id;
-    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.IdAssigned);
-  }
-  get container() {
-    return this.owner?.parts;
-  }
-  set number(number) {
-    if (this.#number === number) {
-      return;
-    }
-    if (this.#number !== void 0) {
-      throw new import_general.ImplementationError(
-        `${this} endpoint number ${this.#number} is already assigned, cannot reassign`
-      );
-    }
-    if (typeof number !== "number") {
-      throw new import_general.ImplementationError(`Illegal endpoint number type "${typeof number}"`);
-    }
-    if (!Number.isInteger(number)) {
-      throw new import_general.ImplementationError(`Endpoint number ${number} is not an integer`);
-    }
-    if (number < 0) {
-      throw new import_general.ImplementationError(`Endpoint number ${number} is negative`);
-    }
-    if (number > 65535) {
-      throw new import_general.ImplementationError(`Endpoint number ${number} is greater than the maximum of 65535`);
-    }
-    if (this.type.deviceClass === import_root.RootEndpoint.deviceClass) {
-      if (number !== 0) {
-        throw new import_general.ImplementationError("The root endpoint must have ID 0");
-      }
-    } else {
-      if (number === 0) {
-        throw new import_general.ImplementationError("Only root endpoint may have ID 0");
-      }
-      if (this.lifecycle.isInstalled) {
-        this.env.get(import_IdentityService.IdentityService).assertEndpointNumberAvailable(number, this);
-      }
-    }
-    this.#number = (0, import_types.EndpointNumber)(number);
-    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.NumberAssigned);
-  }
-  set owner(owner) {
-    if (this.#owner === owner) {
-      return;
-    }
-    if (this.#owner) {
-      this.#container.delete(this);
-    }
-    this.#owner = owner;
-    if (owner) {
-      try {
-        this.#container.add(this);
-      } catch (e) {
-        this.#container.delete(this);
-        this.#owner = void 0;
-        throw e;
-      }
-    }
-  }
-  async add(definition, options) {
-    if (!this.lifecycle.isInstalled) {
-      throw new import_general.ImplementationError(`You may not use add() here because ${this} is not installed in a Node`);
-    }
-    await this.construction;
-    let endpoint;
-    if (definition instanceof Endpoint) {
-      endpoint = definition;
-    } else {
-      endpoint = new Endpoint(definition, options);
-    }
-    if (this.#lifecycle.isPartsReady) {
-      endpoint.construction.onError(() => {
-      });
-    }
-    this.parts.add(endpoint);
-    try {
-      await endpoint.construction.ready;
-    } catch (e) {
-      if (endpoint.lifecycle.isEssential) {
-        await endpoint.reset();
-        this.parts.delete(endpoint);
-        endpoint.#owner = void 0;
-      }
-      if (!endpoint.lifecycle.isEssential) {
-        logger.error(`Initialization error in non-essential endpoint ${endpoint}:`, e);
-      }
-      throw e;
-    }
-    return endpoint;
-  }
-  /**
-   * The type of endpoint this endpoint implements.
-   */
-  get type() {
-    return this.#type;
-  }
-  /**
-   * Access child parts.
-   */
-  get parts() {
-    if (!this.#parts) {
-      this.#parts = new import_Parts.Parts(this);
-    }
-    return this.#parts;
-  }
-  /**
-   * Is this a parent Endpoint?
-   */
-  get hasParts() {
-    if (this.#parts?.size) {
-      return true;
-    }
-    return false;
-  }
-  /**
-   * Endpoint information that varies as the endpoint initializes.
-   */
-  get lifecycle() {
-    return this.#lifecycle;
-  }
-  createLifecycle(isEssential) {
-    return new import_EndpointLifecycle.EndpointLifecycle(this, isEssential);
-  }
-  /**
-   * Create an {@link Agent.Type} for the endpoint.
-   */
-  get agentType() {
-    if (!this.#agentType) {
-      this.#agentType = import_Agent.Agent.for(this.type, this.behaviors.supported);
-    }
-    return this.#agentType;
-  }
-  act(actorOrPurpose, actor) {
-    let purpose;
-    if (typeof actorOrPurpose === "string") {
-      purpose = actorOrPurpose;
-    } else {
-      actor = actorOrPurpose;
-      purpose = "offline";
-    }
-    if (typeof actor !== "function") {
-      throw new import_general.ImplementationError("Actor must be a function");
-    }
-    this.construction.assert(this.toString());
-    if (!this.#activity) {
-      this.#activity = this.env.get(import_NodeActivity.NodeActivity);
-    }
-    return import_LocalActorContext.LocalActorContext.act(
-      purpose,
-      (context) => {
-        return actor(this.agentFor(context));
-      },
-      { activity: this.#activity, lifetime: this.construction }
-    );
-  }
-  /**
-   * Perform "soft" reset of the endpoint, reverting all in-memory structures to uninitialized.
-   */
-  async reset() {
-    var _stack4 = [];
-    try {
-      const _resetting = __using(_stack4, this.construction.join("resetting"));
-      try {
-        this.lifecycle.resetting();
-        {
-          var _stack = [];
-          try {
-            const _parts = __using(_stack, _resetting.join("parts"));
-            await this.parts.reset();
-          } catch (_) {
-            var _error = _, _hasError = true;
-          } finally {
-            __callDispose(_stack, _error, _hasError);
-          }
-        }
-        {
-          var _stack2 = [];
-          try {
-            const _behaviors = __using(_stack2, _resetting.join("behaviors"));
-            await this.behaviors.close();
-          } catch (_2) {
-            var _error2 = _2, _hasError2 = true;
-          } finally {
-            __callDispose(_stack2, _error2, _hasError2);
-          }
-        }
-        {
-          var _stack3 = [];
-          try {
-            const _lifecycle = __using(_stack3, _resetting.join("lifecycle"));
-            await this.lifecycle.reset.emit();
-          } catch (_3) {
-            var _error3 = _3, _hasError3 = true;
-          } finally {
-            __callDispose(_stack3, _error3, _hasError3);
-          }
-        }
-        this.construction.setStatus(import_general.Lifecycle.Status.Inactive);
-      } catch (e) {
-        logger.error(`Unhandled error during reset of ${this}`, e);
-      }
-    } catch (_4) {
-      var _error4 = _4, _hasError4 = true;
-    } finally {
-      __callDispose(_stack4, _error4, _hasError4);
-    }
-  }
-  /**
-   * Perform "hard" reset of the endpoint, reverting all in-memory and persistent state to uninitialized.
-   */
-  async erase() {
-    await this.reset();
-    await this.env.get(import_EndpointInitializer.EndpointInitializer).eraseDescendant(this);
-  }
-  /**
-   * Erase all persisted data and destroy the endpoint.
-   */
-  async delete() {
-    this.construction.assert(this.toString());
-    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.Destroying);
-    await this.erase();
-    await this.close();
-  }
-  /**
-   * Apply a depth-first visitor function to myself and all descendents.
-   */
-  visit(visitor) {
-    const promise = visitor(this);
-    const childIterator = this.parts[Symbol.iterator]();
-    const visitChildren = () => {
-      for (let next = childIterator.next(); !next.done; next = childIterator.next()) {
-        const promise2 = next.value.visit(visitor);
-        if (import_general.MaybePromise.is(promise2)) {
-          return promise2.then(visitChildren);
-        }
-      }
-    };
-    if (import_general.MaybePromise.is(promise)) {
-      return promise.then(visitChildren);
-    }
-    return visitChildren();
-  }
-  async close() {
-    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.Destroying);
-    await this.env.get(import_EndpointInitializer.EndpointInitializer).deactivateDescendant(this);
-    await this.#construction.close();
-  }
-  async [import_general.Construction.destruct]() {
-    await this.#parts?.close();
-    await this.#behaviors?.close();
-    for (const id in this.#events) {
-      this.#events[id][Symbol.dispose]();
-    }
-    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.Destroyed);
-    this.#owner = void 0;
-  }
-  async [Symbol.asyncDispose]() {
-    await this.close();
-  }
-  toString() {
-    return this.path.toString();
-  }
-  /**
-   * Path identifying the endpoint in the Matter data model.
-   */
-  get path() {
-    if (this.#owner) {
-      return this.#owner.path.at(this.identity, this.#type.name);
-    }
-    return new import_model.DataModelPath(this.identity, this.type?.name);
-  }
-  /**
-   * Diagnostic identity.
-   *
-   * This is an unqualified path segment.
-   */
-  get identity() {
-    if (this.lifecycle?.hasId) {
-      return this.id;
-    }
-    if (this.lifecycle?.hasNumber) {
-      return this.number;
-    }
-    return "?";
-  }
-  /**
-   * Asynchronous initialization.
-   *
-   * Derivatives may override to perform async construction prior to full initialization.
-   */
-  initialize() {
-    this.env.get(import_EndpointInitializer.EndpointInitializer).initializeDescendant(this);
-    let promise = this.behaviors.initialize();
-    if (promise) {
-      promise = promise.then(this.parts.initialize.bind(this.parts));
-    } else {
-      promise = this.parts.initialize();
-    }
-    return promise;
-  }
-  /**
-   * Ensure requirements for construction are met.
-   */
-  assertConstructable() {
-    if (this.#owner === void 0) {
-      throw new import_general.ImplementationError(`Endpoint construction initiated without owner`);
-    }
-    if (!this.#owner.#lifecycle.isInstalled) {
-      throw new import_general.ImplementationError(`Endpoint construction initiated with uninstalled owner`);
-    }
-  }
-  /**
-   * Complete initialization.  Invoked via {@link Construction#start} by the owner.
-   */
-  [import_general.Construction.construct]() {
-    this.assertConstructable();
-    this.lifecycle.change(import_EndpointLifecycle.EndpointLifecycle.Change.Installed);
-    return this.initialize();
-  }
-  #resolveSelection(selector) {
-    const map = /* @__PURE__ */ new Map();
-    if (selector === void 0) {
-      for (const type of this.behaviors) {
-        map.set(type.id, true);
-      }
-      return map;
-    }
-    for (const id of Object.keys(selector)) {
-      const type = this.behaviors.supported[id];
-      if (type === void 0) {
-        throw new import_errors.EndpointBehaviorNotPresentError(id);
-      }
-      const raw = selector[id];
-      if (raw === void 0) continue;
-      map.set(id, raw);
-    }
-    return map;
-  }
-  async #performRead(selector, options) {
-    const selection = this.#resolveSelection(selector);
-    const attributePaths = new import_protocol.Read.AttributePaths();
-    const clusterLookup = /* @__PURE__ */ new Map();
-    for (const [id, raw] of selection) {
-      const type = this.behaviors.supported[id];
-      const schema = type.schema;
-      const endpointId = this.number;
-      if (!(schema instanceof import_model.ClusterModel)) {
-        continue;
-      }
-      const clusterId = schema.id;
-      if (clusterId === void 0) {
-        continue;
-      }
-      const attrs = /* @__PURE__ */ new Map();
-      const attrNameToId = /* @__PURE__ */ new Map();
-      for (const attr of schema.attributes) {
-        if (attr.id !== void 0 && attr.propertyName !== void 0) {
-          const attrId = attr.id;
-          attrs.set(attrId, attr.propertyName);
-          attrNameToId.set(attr.propertyName, attrId);
-        }
-      }
-      clusterLookup.set(clusterId, { behaviorId: id, attrs, attrNameToId });
-      if (raw === true) {
-        attributePaths.add({ endpointId, clusterId });
-        continue;
-      }
-      const elements = this.behaviors.elementsOf(type);
-      const allowedNames = elements.attributes;
-      for (const name of raw) {
-        if (!allowedNames.has(name)) {
-          throw new import_errors.AttributeNotPresentError(id, name);
-        }
-        const attrId = attrNameToId.get(name);
-        if (attrId === void 0) {
-          throw new import_errors.AttributeNotPresentError(id, name);
-        }
-        attributePaths.add({ endpointId, clusterId, attributeId: attrId });
-      }
-    }
-    if (attributePaths.paths.length === 0) {
-      return this.#assembleSlice(selection);
-    }
-    const nodeEndpoint = this.ownerOfType(import_root.RootEndpoint);
-    if (nodeEndpoint === void 0) {
-      throw new import_general.ImplementationError(`${this} is not installed in a node`);
-    }
-    const node = nodeEndpoint;
-    const failed = new Array();
-    if (node.nodeType === "group") {
-      throw new import_errors.InvalidGroupOperationError("Groups do not support reading attributes");
-    }
-    if (node.nodeType === "client") {
-      const fabricFilter = options?.fabricFilter ?? true;
-      const baseRequest = (0, import_protocol.Read)({ attributes: [...attributePaths.paths], fabricFilter });
-      const request2 = options?.includeKnownVersions ? { ...baseRequest, includeKnownVersions: true } : baseRequest;
-      const readValues = /* @__PURE__ */ new Map();
-      for await (const chunk of node.interaction.read(request2, void 0)) {
-        for (const report of chunk) {
-          if (report.kind === "attr-value") {
-            const info = clusterLookup.get(report.path.clusterId);
-            if (info !== void 0) {
-              const propName = info.attrs.get(report.path.attributeId);
-              if (propName !== void 0) {
-                let values = readValues.get(info.behaviorId);
-                if (values === void 0) {
-                  values = /* @__PURE__ */ new Map();
-                  readValues.set(info.behaviorId, values);
-                }
-                values.set(propName, report.value);
-              }
-            }
-          } else if (report.kind === "attr-status" && report.status !== import_types.Status.Success) {
-            failed.push({ path: report.path, status: report.status, clusterStatus: report.clusterStatus });
-          }
-        }
-      }
-      const stateSlice = this.#assembleSlice(selection);
-      const partial2 = {};
-      for (const [id] of selection) {
-        const stateValues = stateSlice[id] ?? {};
-        const freshValues = readValues.get(id);
-        partial2[id] = freshValues?.size ? { ...stateValues, ...Object.fromEntries(freshValues) } : stateValues;
-      }
-      if (failed.length > 0) {
-        this.#excludeFailedPaths(partial2, failed, clusterLookup);
-        throw new import_errors.EndpointReadFailedError({ failed, partial: partial2 });
-      }
-      return partial2;
-    }
-    const collectFailures = async (stream) => {
-      for await (const chunk of stream) {
-        for (const report of chunk) {
-          if (report.kind === "attr-status" && report.status !== import_types.Status.Success) {
-            failed.push({ path: report.path, status: report.status, clusterStatus: report.clusterStatus });
-          }
-        }
-      }
-    };
-    const request = (0, import_protocol.Read)({ attributes: [...attributePaths.paths], fabricFilter: false });
-    await import_LocalActorContext.LocalActorContext.act(
-      "endpoint-get",
-      (context) => collectFailures(node.interaction.read(request, context))
-    );
-    const partial = this.#assembleSlice(selection);
-    if (failed.length > 0) {
-      this.#excludeFailedPaths(partial, failed, clusterLookup);
-      throw new import_errors.EndpointReadFailedError({ failed, partial });
-    }
-    return partial;
-  }
-  #excludeFailedPaths(partial, failed, clusterLookup) {
-    for (const { path } of failed) {
-      const info = clusterLookup.get(path.clusterId);
-      if (info === void 0) continue;
-      if (path.attributeId === void 0) {
-        delete partial[info.behaviorId];
-        continue;
-      }
-      const propName = info.attrs.get(path.attributeId);
-      if (propName === void 0) continue;
-      const behaviorState = partial[info.behaviorId];
-      if (behaviorState === null || typeof behaviorState !== "object") continue;
-      const copy = { ...behaviorState };
-      delete copy[propName];
-      partial[info.behaviorId] = copy;
-    }
-  }
-  #assembleSlice(selection) {
-    const view = this.#stateView;
-    const out = {};
-    for (const [id, raw] of selection) {
-      const behaviorState = view[id];
-      if (raw === true) {
-        out[id] = behaviorState ?? {};
-        continue;
-      }
-      const filtered = {};
-      for (const name of raw) {
-        filtered[name] = behaviorState?.[name];
-      }
-      out[id] = filtered;
-    }
-    return out;
-  }
-  #logReady() {
-    logger.info(import_general.Diagnostic.strong(this.toString()), "ready", this.diagnosticDict);
-  }
-  /**
-   * Hierarchical diagnostics of endpoint and children.
-   */
-  get [import_general.Diagnostic.value]() {
-    const diagnostics = [
-      import_general.Diagnostic.strong(this.#id === void 0 ? "(no id)" : this.id),
-      import_general.Diagnostic.dict({
-        ...this.#diagnosticProps,
-        class: this.constructor.name
-      })
-    ];
-    if (this.#construction.status === import_general.Lifecycle.Status.Active) {
-      diagnostics.push(import_general.Diagnostic.list([...this.behaviors.detailedDiagnostic, ...this.parts]));
-    } else {
-      diagnostics.push(import_general.Diagnostic.weak(`(${this.#construction.status})`));
-    }
-    return diagnostics;
-  }
-  get [import_general.Lifetime.owner]() {
-    return this.#owner?.construction;
-  }
-  /**
-   * Diagnostic information regarding endpoint state.
-   */
-  get diagnosticDict() {
-    return import_general.Diagnostic.dict({
-      ...this.#diagnosticProps,
-      behaviors: this.behaviors
-    });
-  }
-  get #diagnosticProps() {
-    const type = this.type;
-    return {
-      "endpoint#": this.#number ? this.number : "(unassigned)",
-      type: `${type.name} (${type.deviceType === import_EndpointType.EndpointType.UNKNOWN_DEVICE_TYPE ? "unknown" : `0x${(0, import_general.toHex)(type.deviceType)}${type.deviceRevision === import_EndpointType.EndpointType.UNKNOWN_DEVICE_REVISION ? "" : `, rev ${type.deviceRevision}`}`})`
-    };
-  }
-  get #container() {
-    const container = this.container;
-    if (container === void 0) {
-      throw new import_general.ImplementationError(`No container for installed endpoint ${this}`);
-    }
-    return container;
-  }
-}
-((Endpoint2) => {
-  function configurationFor(definition, options) {
-    if (definition.deviceType) {
-      return {
-        ...options,
-        type: definition
-      };
-    }
-    return definition;
-  }
-  Endpoint2.configurationFor = configurationFor;
-  function partFor(definition) {
-    if (definition instanceof Endpoint2) {
-      return definition;
-    }
-    return new Endpoint2(definition);
-  }
-  Endpoint2.partFor = partFor;
-})(Endpoint || (Endpoint = {}));
-//# sourceMappingURL=Endpoint.js.map