@matter/protocol 0.16.0-alpha.0-20251030-e9ca79f93 → 0.16.0-alpha.0-20251101-70c8d51d7

package/dist/esm/action/client/subscription/ClientSubscriptionHandler.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/action/client/subscription/ClientSubscriptionHandler.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,YAAY,eAAe,cAAc;AAClD,SAAS,yBAAyB;AAClC,SAAS,0CAA0C;AAInD,SAAS,qBAAqB;AAC9B,SAAqB,yBAAyB,cAAc;AAC5D,SAAS,kBAAkB;AAG3B,MAAM,SAAS,OAAO,IAAI,2BAA2B;AAK9C,MAAM,0BAAqD;AAAA,EAC9D,KAAK;AAAA,EACL,wBAAwB;AAAA,EAExB;AAAA,EAEA,YAAY,eAAoC;AAC5C,SAAK,iBAAiB;AAAA,EAC1B;AAAA,EAEA,MAAM,cAAc,UAA2B;AAC3C,UAAM,YAAY,IAAI,mCAAmC,QAAQ;AAEjE,UAAM,UAAU,UAAU,gBAAgB;AAE1C,UAAM,mBAAmB,MAAM,QAAQ,KAAK;AAC5C,QAAI,iBAAiB,MAAM;AACvB,YAAM,IAAI,cAAc,4CAA4C;AAAA,IACxE;AACA,UAAM,gBAAgB,iBAAiB;AAGvC,UAAM,EAAE,eAAe,IAAI;AAC3B,QAAI,mBAAmB,QAAW;AAC9B,aAAO,MAAM,0DAA0D;AACvE,YAAM,YAAY,WAAW,MAAS;AACtC;AAAA,IACJ;AAGA,UAAM,EAAE,QAAQ,IAAI,SAAS;AAC7B,kBAAc,OAAO,OAAO;AAC5B,UAAM,eAAe,KAAK,eAAe,QAAQ,QAAQ,aAAa,cAAc;AACpF,QAAI,iBAAiB,QAAW;AAC5B,aAAO,MAAM,oDAAoD,WAAW,OAAO,cAAc,CAAC;AAClG,YAAM,YAAY,WAAW,cAAc;AAC3C;AAAA,IACJ;AAGA,QAAI,CAAC,cAAc,kBAAkB,UAAU,CAAC,cAAc,cAAc,QAAQ;AAChF,mBAAa,YAAY;AACzB,WAAK,eAAe,WAAW;AAC/B,YAAM,SAAS,MAAM;AACrB;AAAA,IACJ;AAGA,QAAI;AACA,mBAAa,YAAY;AAEzB,UAAI,aAAa,QAAQ,SAAS;AAC9B,cAAM,aAAa,QAAQ,QAAQ,eAAe,eAAe,SAAS,SAAS,CAAC;AAAA,MACxF,OAAO;AAIH,yBAAiB,UAAU,QAAQ;AAAA,MACvC;AAAA,IACJ,UAAE;AACE,mBAAa,YAAY;AACzB,mBAAa,YAAY;AACzB,WAAK,eAAe,WAAW;AAC/B,YAAM,SAAS,MAAM;AAAA,IACzB;AAAA,EACJ;AAAA,EAEA,MAAM,QAAQ;AAAA,EAAC;AACnB;AAEA,eAAe,YAAY,WAA+C,gBAAiC;AACvG,QAAM,UAAU,WAAW,OAAO,qBAAqB;AAAA,IACnD,4BAA4B;AAAA,IAC5B,YAAY;AAAA,MACR,OAAO;AAAA,IACX;AAAA,EACJ,CAAC;AACD,QAAM,UAAU,MAAM;AAC1B;AAOA,gBAAgB,eACZ,eACA,cACA,WACU;AACV,QAAM,WAAW,aAAa;AAE9B,QAAM,EAAE,eAAe,IAAI;AAE3B,mBAAiB,UAAU,cAAc;AACrC,UAAM,UAAU,kBAAkB,MAAM;AAExC,QAAI,QAAQ,mBAAmB,QAAW;AACtC,aAAO;AAAA,QACH;AAAA,QACA,WAAW,OAAO,QAAQ,cAAc;AAAA,MAC5C;AACA,YAAM,YAAY,WAAW,QAAQ,cAAc;AAAA,IACvD;AAEA,QAAI,QAAQ,mBAAmB,gBAAgB;AAC3C,aAAO;AAAA,QACH;AAAA,QACA,WAAW,OAAO,QAAQ,cAAc;AAAA,MAC5C;AACA,YAAM,YAAY,WAAW,QAAQ,cAAc;AACnD;AAAA,IACJ;AAEA,UAAM,WAAW,MAAM;AAAA,EAC3B;AACJ;",
+  "names": []
+}

package/dist/{cjs/action/client → esm/action/client/subscription}/ClientSubscriptions.d.ts

@@ -3,27 +3,34 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { Subscribe } from "#action/request/Subscribe.js";
 import { ReadResult } from "#action/response/ReadResult.js";
-import { ActiveSubscription } from "#action/response/SubscribeResult.js";
 import { Environment, Environmental } from "#general";
 import { SubscriptionId } from "#interaction/Subscription.js";
-import { SubscribeResponse } from "#types";
+import { PeerAddress } from "#peer/PeerAddress.js";
 import { ClientSubscription } from "./ClientSubscription.js";
+import type { PeerSubscription } from "./PeerSubscription.js";
 /**
- * A managed set of {@link ClientSubscription} instances.
+ * A managed set of {@link ActiveSubscription} instances.
  */
 export declare class ClientSubscriptions {
     #private;
     static [Environmental.create](env: Environment): ClientSubscriptions;
     /**
-     * Register an active subscription.
+     * Register a user-facing {@link ClientSubscription}.
      */
-    add(request: Subscribe, response: SubscribeResponse): ActiveSubscription;
+    addActive(subscription: ClientSubscription): void;
     /**
-     * Retrieve a subscription by ID.
+     * Register a {@link PeerSubscription}.
      */
-    get(id: SubscriptionId): ClientSubscription | undefined;
+    addPeer(subscription: PeerSubscription): void;
+    /**
+     * Retrieve a {@link PeerSubscription} by ID.
+     */
+    getPeer(address: PeerAddress, id: SubscriptionId): PeerSubscription | undefined;
+    /**
+     * Unregister a {@link PeerSubscription}.
+     */
+    delete(subscription: ClientSubscription): void;
     /**
      * Iterate over active subscriptions.
      */

package/dist/esm/action/client/subscription/ClientSubscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientSubscriptions.d.ts","sourceRoot":"","sources":["../../../../../src/action/client/subscription/ClientSubscriptions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAE5D,OAAO,EAAY,WAAW,EAAE,aAAa,EAAkC,MAAM,UAAU,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,qBAAa,mBAAmB;;IAK5B,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW;IAM9C;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,kBAAkB;IAI1C;;OAEG;IACH,OAAO,CAAC,YAAY,EAAE,gBAAgB;IAUtC;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,cAAc;IAIhD;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,kBAAkB;IAUvC;;OAEG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC;IAIjB;;OAEG;IACG,KAAK;IAaX;;OAEG;IACH,UAAU;CAiDb;AAED,yBAAiB,mBAAmB,CAAC;IACjC,UAAiB,QAAQ;QACrB,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7D;CACJ"}

package/dist/esm/action/client/subscription/ClientSubscriptions.js

@@ -0,0 +1,113 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { BasicSet, Environmental, Millis, Time, Timestamp } from "#general";
+class ClientSubscriptions {
+  #active = new BasicSet();
+  #peers = /* @__PURE__ */ new Map();
+  #timeout;
+  static [Environmental.create](env) {
+    const instance = new ClientSubscriptions();
+    env.set(ClientSubscriptions, instance);
+    return instance;
+  }
+  /**
+   * Register a user-facing {@link ClientSubscription}.
+   */
+  addActive(subscription) {
+    this.#active.add(subscription);
+  }
+  /**
+   * Register a {@link PeerSubscription}.
+   */
+  addPeer(subscription) {
+    let forPeer = this.#peers.get(subscription.peer);
+    if (forPeer === void 0) {
+      this.#peers.set(subscription.peer, forPeer = /* @__PURE__ */ new Map());
+    }
+    forPeer.set(subscription.subscriptionId, subscription);
+    this.resetTimer();
+  }
+  /**
+   * Retrieve a {@link PeerSubscription} by ID.
+   */
+  getPeer(address, id) {
+    return this.#peers.get(address)?.get(id);
+  }
+  /**
+   * Unregister a {@link PeerSubscription}.
+   */
+  delete(subscription) {
+    const forPeer = this.#peers.get(subscription.peer);
+    if (forPeer?.delete(subscription.subscriptionId)) {
+      if (!forPeer.size) {
+        this.#peers.delete(subscription.peer);
+      }
+    }
+    this.#active.delete(subscription);
+  }
+  /**
+   * Iterate over active subscriptions.
+   */
+  [Symbol.iterator]() {
+    return this.#active[Symbol.iterator]();
+  }
+  /**
+   * Terminate all subscriptions.
+   */
+  async close() {
+    if (this.#timeout) {
+      this.#timeout.stop();
+      this.#timeout = void 0;
+    }
+    for (const subscription of this.#active) {
+      subscription.close();
+    }
+    await this.#active.empty;
+  }
+  /**
+   * Restart the timeout timer for the current set of active subscriptions.
+   */
+  resetTimer() {
+    const now = Time.nowMs;
+    let nextTimeoutAt;
+    for (const peer of this.#peers.values()) {
+      for (const subscription of peer.values()) {
+        if (subscription.isReading) {
+          continue;
+        }
+        let { timeoutAt } = subscription;
+        if (timeoutAt === void 0) {
+          timeoutAt = subscription.timeoutAt = Timestamp(now + subscription.timeout);
+        } else if (timeoutAt < now) {
+          subscription.timedOut();
+          continue;
+        }
+        if (nextTimeoutAt === void 0 || nextTimeoutAt > timeoutAt) {
+          nextTimeoutAt = timeoutAt;
+        }
+      }
+    }
+    if (nextTimeoutAt === void 0) {
+      this.#timeout?.stop();
+      return;
+    }
+    if (this.#timeout) {
+      this.#timeout?.stop();
+      this.#timeout.interval = Millis(nextTimeoutAt - now);
+    } else {
+      this.#timeout = Time.getTimer(
+        "Subscription timeout",
+        Millis(nextTimeoutAt - now),
+        this.resetTimer.bind(this)
+      );
+    }
+    this.#timeout.start();
+  }
+}
+export {
+  ClientSubscriptions
+};
+//# sourceMappingURL=ClientSubscriptions.js.map

package/dist/esm/action/client/subscription/ClientSubscriptions.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/action/client/subscription/ClientSubscriptions.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,UAAuB,eAAe,QAAQ,MAAa,iBAAiB;AAS9E,MAAM,oBAAoB;AAAA,EAC7B,UAAU,IAAI,SAA6B;AAAA,EAC3C,SAAS,oBAAI,IAAgD;AAAA,EAC7D;AAAA,EAEA,QAAQ,cAAc,MAAM,EAAE,KAAkB;AAC5C,UAAM,WAAW,IAAI,oBAAoB;AACzC,QAAI,IAAI,qBAAqB,QAAQ;AACrC,WAAO;AAAA,EACX;AAAA;AAAA;AAAA;AAAA,EAKA,UAAU,cAAkC;AACxC,SAAK,QAAQ,IAAI,YAAY;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,cAAgC;AACpC,QAAI,UAAU,KAAK,OAAO,IAAI,aAAa,IAAI;AAC/C,QAAI,YAAY,QAAW;AACvB,WAAK,OAAO,IAAI,aAAa,MAAO,UAAU,oBAAI,IAAI,CAAE;AAAA,IAC5D;AACA,YAAQ,IAAI,aAAa,gBAAgB,YAAY;AAErD,SAAK,WAAW;AAAA,EACpB;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,SAAsB,IAAoB;AAC9C,WAAO,KAAK,OAAO,IAAI,OAAO,GAAG,IAAI,EAAE;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA,EAKA,OAAO,cAAkC;AACrC,UAAM,UAAU,KAAK,OAAO,IAAI,aAAa,IAAI;AACjD,QAAI,SAAS,OAAO,aAAa,cAAc,GAAG;AAC9C,UAAI,CAAC,QAAQ,MAAM;AACf,aAAK,OAAO,OAAO,aAAa,IAAI;AAAA,MACxC;AAAA,IACJ;AACA,SAAK,QAAQ,OAAO,YAAY;AAAA,EACpC;AAAA;AAAA;AAAA;AAAA,EAKA,CAAC,OAAO,QAAQ,IAAI;AAChB,WAAO,KAAK,QAAQ,OAAO,QAAQ,EAAE;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,QAAQ;AACV,QAAI,KAAK,UAAU;AACf,WAAK,SAAS,KAAK;AACnB,WAAK,WAAW;AAAA,IACpB;AAEA,eAAW,gBAAgB,KAAK,SAAS;AACrC,mBAAa,MAAM;AAAA,IACvB;AAEA,UAAM,KAAK,QAAQ;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,aAAa;AACT,UAAM,MAAM,KAAK;AACjB,QAAI;AAGJ,eAAW,QAAQ,KAAK,OAAO,OAAO,GAAG;AACrC,iBAAW,gBAAgB,KAAK,OAAO,GAAG;AAEtC,YAAI,aAAa,WAAW;AACxB;AAAA,QACJ;AAGA,YAAI,EAAE,UAAU,IAAI;AACpB,YAAI,cAAc,QAAW;AAEzB,sBAAY,aAAa,YAAY,UAAU,MAAM,aAAa,OAAO;AAAA,QAC7E,WAAW,YAAY,KAAK;AAExB,uBAAa,SAAS;AACtB;AAAA,QACJ;AAGA,YAAI,kBAAkB,UAAa,gBAAgB,WAAW;AAC1D,0BAAgB;AAAA,QACpB;AAAA,MACJ;AAAA,IACJ;AAGA,QAAI,kBAAkB,QAAW;AAC7B,WAAK,UAAU,KAAK;AACpB;AAAA,IACJ;AAGA,QAAI,KAAK,UAAU;AACf,WAAK,UAAU,KAAK;AACpB,WAAK,SAAS,WAAW,OAAO,gBAAgB,GAAG;AAAA,IACvD,OAAO;AACH,WAAK,WAAW,KAAK;AAAA,QACjB;AAAA,QACA,OAAO,gBAAgB,GAAG;AAAA,QAC1B,KAAK,WAAW,KAAK,IAAI;AAAA,MAC7B;AAAA,IACJ;AACA,SAAK,SAAS,MAAM;AAAA,EACxB;AACJ;",
+  "names": []
+}

package/dist/esm/action/client/subscription/PeerSubscription.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Duration, Timestamp } from "#general";
+import type { SubscribeResponse } from "#types";
+import { ClientSubscription } from "./ClientSubscription.js";
+/**
+ * A Matter protocol-level subscription established with a peer.
+ */
+export declare class PeerSubscription extends ClientSubscription {
+    readonly interactionModelRevision: number;
+    readonly maxInterval: number;
+    readonly subscriptionId: number;
+    isReading: boolean;
+    timeoutAt?: Timestamp;
+    constructor(config: PeerSubscription.Configuration);
+    get timeout(): Duration;
+    timedOut(): void;
+}
+export declare namespace PeerSubscription {
+    interface Configuration extends ClientSubscription.Configuration {
+        response: SubscribeResponse;
+    }
+}
+//# sourceMappingURL=PeerSubscription.d.ts.map

package/dist/esm/action/client/subscription/PeerSubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PeerSubscription.d.ts","sourceRoot":"","sources":["../../../../../src/action/client/subscription/PeerSubscription.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAc,QAAQ,EAAmB,SAAS,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IACpD,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAC1C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,SAAS,UAAS;IAElB,SAAS,CAAC,EAAE,SAAS,CAAC;gBAEV,MAAM,EAAE,gBAAgB,CAAC,aAAa;IASlD,IAAI,OAAO,aAEV;IAED,QAAQ;CAUX;AAED,yBAAiB,gBAAgB,CAAC;IAC9B,UAAiB,aAAc,SAAQ,kBAAkB,CAAC,aAAa;QACnE,QAAQ,EAAE,iBAAiB,CAAC;KAC/B;CACJ"}

package/dist/esm/action/client/subscription/PeerSubscription.js

@@ -0,0 +1,37 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Diagnostic, Duration, Millis, Seconds } from "#general";
+import { ClientSubscription } from "./ClientSubscription.js";
+class PeerSubscription extends ClientSubscription {
+  interactionModelRevision;
+  maxInterval;
+  subscriptionId;
+  isReading = false;
+  timeoutAt;
+  constructor(config) {
+    super(config);
+    const { subscriptionId, interactionModelRevision, maxInterval } = config.response;
+    this.subscriptionId = subscriptionId;
+    this.interactionModelRevision = interactionModelRevision;
+    this.maxInterval = maxInterval;
+  }
+  get timeout() {
+    return Millis(Seconds(this.maxInterval) + (this.request.maxPeerResponseTime ?? 0));
+  }
+  timedOut() {
+    this.logger.info(
+      "Subscription",
+      Diagnostic.strong(this.subscriptionId),
+      "timed out after",
+      Diagnostic.strong(Duration.format(this.timeout))
+    );
+    this.close();
+  }
+}
+export {
+  PeerSubscription
+};
+//# sourceMappingURL=PeerSubscription.js.map

package/dist/esm/action/client/subscription/PeerSubscription.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/action/client/subscription/PeerSubscription.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,YAAY,UAAU,QAAQ,eAA0B;AAEjE,SAAS,0BAA0B;AAK5B,MAAM,yBAAyB,mBAAmB;AAAA,EAC5C;AAAA,EACA;AAAA,EACA;AAAA,EACT,YAAY;AAAA,EAEZ;AAAA,EAEA,YAAY,QAAwC;AAChD,UAAM,MAAM;AAEZ,UAAM,EAAE,gBAAgB,0BAA0B,YAAY,IAAI,OAAO;AACzE,SAAK,iBAAiB;AACtB,SAAK,2BAA2B;AAChC,SAAK,cAAc;AAAA,EACvB;AAAA,EAEA,IAAI,UAAU;AACV,WAAO,OAAO,QAAQ,KAAK,WAAW,KAAK,KAAK,QAAQ,uBAAuB,EAAE;AAAA,EACrF;AAAA,EAEA,WAAW;AACP,SAAK,OAAO;AAAA,MACR;AAAA,MACA,WAAW,OAAO,KAAK,cAAc;AAAA,MACrC;AAAA,MACA,WAAW,OAAO,SAAS,OAAO,KAAK,OAAO,CAAC;AAAA,IACnD;AAEA,SAAK,MAAM;AAAA,EACf;AACJ;",
+  "names": []
+}

package/dist/esm/action/client/subscription/SustainedSubscription.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Subscribe } from "#action/request/Subscribe.js";
+import { AsyncObservableValue, RetrySchedule } from "#general";
+import { SubscribeResponse } from "#types";
+import { ClientSubscription } from "./ClientSubscription.js";
+import { PeerSubscription } from "./PeerSubscription.js";
+/**
+ * An {@link ActiveSubscription} that remains active regardless of the state of the peer.
+ *
+ * This class performs retries in response to connection errors and timeouts.  The underlying Matter subscription and
+ * thus {@link ActiveSubscription#subscriptionId} may change if the peer goes offline or experiences transient errors.
+ *
+ * TODO - need to make underlying exchange provider abortable and work out how the retry schedule at this level
+ *   interacts with the MDNS and secure protocol retries.  Will require some refactoring at lower levels.  Leaving
+ *   retries at this level relatively conservative for now
+ */
+export declare class SustainedSubscription extends ClientSubscription {
+    #private;
+    constructor(config: SustainedSubscription.Configuration);
+    /**
+     * Emits when active state changes.
+     */
+    get active(): AsyncObservableValue<[any, ...any[]]>;
+    /**
+     * Emits when inactive state changes.
+     */
+    get inactive(): AsyncObservableValue<[any, ...any[]]>;
+    get interactionModelRevision(): number;
+    get maxInterval(): number;
+    get subscriptionId(): number;
+}
+export declare namespace SustainedSubscription {
+    /**
+     * Configuration for {@link SustainedSubscription}.
+     */
+    interface Configuration extends ClientSubscription.Configuration {
+        /**
+         * Function to establish underlying subscription.
+         */
+        subscribe: (request: Subscribe) => Promise<PeerSubscription>;
+        /**
+         * The schedule we use for retrying subscription connections.
+         *
+         * We handle reconnection separately at the exchange level.  This retry schedule only applies to establishing a
+         * subscription once we have an active exchange.  Exchange reconnection is handled by lower-level components.
+         */
+        retries: RetrySchedule;
+    }
+    function assert(subscription: SubscribeResponse): asserts subscription is SustainedSubscription;
+    const NO_SUBSCRIPTION = -1;
+    const DefaultRetrySchedule: RetrySchedule.Configuration;
+}
+//# sourceMappingURL=SustainedSubscription.d.ts.map

package/dist/esm/action/client/subscription/SustainedSubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SustainedSubscription.d.ts","sourceRoot":"","sources":["../../../../../src/action/client/subscription/SustainedSubscription.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAEzD,OAAO,EAEH,oBAAoB,EAMpB,aAAa,EAGhB,MAAM,UAAU,CAAC;AAElB,OAAO,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAE3C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAIzD;;;;;;;;;GASG;AACH,qBAAa,qBAAsB,SAAQ,kBAAkB;;gBAQ7C,MAAM,EAAE,qBAAqB,CAAC,aAAa;IAWvD;;OAEG;IACH,IAAI,MAAM,0CAET;IAED;;OAEG;IACH,IAAI,QAAQ,0CAEX;IAwED,IAAI,wBAAwB,WAE3B;IAED,IAAI,WAAW,WAEd;IAED,IAAI,cAAc,WAEjB;CACJ;AAED,yBAAiB,qBAAqB,CAAC;IACnC;;OAEG;IACH,UAAiB,aAAc,SAAQ,kBAAkB,CAAC,aAAa;QACnE;;WAEG;QACH,SAAS,EAAE,CAAC,OAAO,EAAE,SAAS,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAE7D;;;;;WAKG;QACH,OAAO,EAAE,aAAa,CAAC;KAC1B;IAED,SAAgB,MAAM,CAAC,YAAY,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,IAAI,qBAAqB,CAIrG;IAEM,MAAM,eAAe,KAAK,CAAC;IAE3B,MAAM,oBAAoB,EAAE,aAAa,CAAC,aAgBhD,CAAC;CACL"}

package/dist/esm/action/client/subscription/SustainedSubscription.js

@@ -0,0 +1,133 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import {
+  asError,
+  AsyncObservableValue,
+  Diagnostic,
+  Duration,
+  Hours,
+  ImplementationError,
+  Logger,
+  Seconds,
+  Time
+} from "#general";
+import { Specification } from "#model";
+import { ClientSubscription } from "./ClientSubscription.js";
+const logger = Logger.get("ClientSubscription");
+class SustainedSubscription extends ClientSubscription {
+  #request;
+  #subscription;
+  #retries;
+  #subscribe;
+  #active = AsyncObservableValue(false);
+  #inactive = AsyncObservableValue(true);
+  constructor(config) {
+    super(config);
+    const { request, retries, subscribe } = config;
+    this.#request = request;
+    this.#retries = retries;
+    this.#subscribe = subscribe;
+    this.done = this.#run();
+  }
+  /**
+   * Emits when active state changes.
+   */
+  get active() {
+    return this.#active;
+  }
+  /**
+   * Emits when inactive state changes.
+   */
+  get inactive() {
+    return this.#inactive;
+  }
+  async #run() {
+    const updated = this.#request.updated?.bind(this.#request);
+    while (true) {
+      const request = { ...this.#request, updated };
+      if (this.#request.updated) {
+        request.updated = this.#request.updated.bind(request);
+      }
+      const closed = new Promise((resolve) => {
+        request.closed = () => {
+          this.#subscription = void 0;
+          resolve();
+        };
+      });
+      for (const retry of this.#retries) {
+        try {
+          this.#subscription = await this.#subscribe(request);
+          break;
+        } catch (e) {
+          if (this.abort.aborted) {
+            return;
+          }
+          logger.error(
+            `Failed to establish subscription to ${this.peer}, retry in ${Duration.format(retry)}:`,
+            Diagnostic.errorMessage(asError(e))
+          );
+        }
+        const readyForRetry = Time.sleep("subscription retry", retry);
+        await this.abort.race(readyForRetry);
+        readyForRetry.cancel();
+        if (this.abort.aborted) {
+          break;
+        }
+      }
+      await this.#inactive.emit(false);
+      await this.#active.emit(true);
+      if (this.abort.aborted) {
+        break;
+      }
+      await closed;
+      await this.#active.emit(false);
+      await this.#inactive.emit(true);
+      if (this.abort.aborted) {
+        break;
+      }
+      if (this.abort.aborted) {
+        break;
+      }
+      logger.error(`Replacing subscription to ${this.peer} due to timeout`);
+    }
+    this.#request.closed?.();
+  }
+  get interactionModelRevision() {
+    return this.#subscription?.interactionModelRevision ?? Specification.INTERACTION_MODEL_REVISION;
+  }
+  get maxInterval() {
+    return this.#subscription?.maxInterval ?? Hours.one;
+  }
+  get subscriptionId() {
+    return this.#subscription?.subscriptionId ?? SustainedSubscription.NO_SUBSCRIPTION;
+  }
+}
+((SustainedSubscription2) => {
+  function assert(subscription) {
+    if (!(subscription instanceof SustainedSubscription2)) {
+      throw new ImplementationError(`Non-sustained subscription provided where sustained subscription required`);
+    }
+  }
+  SustainedSubscription2.assert = assert;
+  SustainedSubscription2.NO_SUBSCRIPTION = -1;
+  SustainedSubscription2.DefaultRetrySchedule = {
+    // Protocol-level level happens at the exchange level and is faster; this is an application-level retry.  Retry
+    // more slowly so we do not hammer devices that are experiencing transient errors
+    initialInterval: Seconds(15),
+    // Similarly, we have an exchange.  If a device repeatedly fails to establish a subscription, give it plenty of
+    // time to recover.  It's even possible our subscription attempt is invalid for some reason, in which case we
+    // an aggressive interval would be particularly bad form
+    maximumInterval: Hours(1),
+    // No timeout; we run until aborted
+    timeout: void 0,
+    backoffFactor: 2,
+    jitterFactor: 0.25
+  };
+})(SustainedSubscription || (SustainedSubscription = {}));
+export {
+  SustainedSubscription
+};
+//# sourceMappingURL=SustainedSubscription.js.map

package/dist/esm/action/client/subscription/SustainedSubscription.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/action/client/subscription/SustainedSubscription.ts"],
+  "mappings": "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",
+  "names": ["SustainedSubscription"]
+}

package/dist/esm/action/client/subscription/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./ClientSubscribe.js";
+export * from "./ClientSubscription.js";
+export * from "./ClientSubscriptionHandler.js";
+export * from "./ClientSubscriptions.js";
+export * from "./PeerSubscription.js";
+export * from "./SustainedSubscription.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/action/client/subscription/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/action/client/subscription/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC"}

package/dist/esm/action/client/subscription/index.js

@@ -0,0 +1,12 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./ClientSubscribe.js";
+export * from "./ClientSubscription.js";
+export * from "./ClientSubscriptionHandler.js";
+export * from "./ClientSubscriptions.js";
+export * from "./PeerSubscription.js";
+export * from "./SustainedSubscription.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/action/client/subscription/index.js.map

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

package/dist/esm/action/errors.d.ts

@@ -7,7 +7,7 @@ import { Schema, SchemaErrorPath } from "#model";
 import { Status, StatusResponseError } from "#types";
 export { SchemaImplementationError } from "#model";
 /**
- * Thrown due operational schema violations.
+ * Thrown due operational schema violation.
  */
 export declare class SchemaViolationError extends StatusResponseError {
     constructor(prefix: string, path: SchemaErrorPath, message: string, code: Status);
@@ -48,6 +48,12 @@ export declare class DatatypeError extends ValidateError {
 export declare class ConstraintError extends ValidateError {
     constructor(schema: Schema, path: SchemaErrorPath, message: string);
 }
+/**
+ * Thrown when a numeric value can't fit in an integer type.
+ */
+export declare class IntegerRangeError extends ValidateError {
+    constructor(path: SchemaErrorPath, message: string);
+}
 /**
  * Thrown when an enum value is not known based on Matter specification
  */
@@ -64,7 +70,6 @@ export declare class ConformanceError extends ValidateError {
  * Thrown when an enum value is not valid based on conformance definitions
  */
 export declare class EnumValueConformanceError extends ConformanceError {
-    constructor(schema: Schema, path: SchemaErrorPath, message: string);
 }
 /**
  * Thrown for access attempts against a managed value that is no longer valid.

package/dist/esm/action/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/action/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,eAAe,EAAc,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAErD,OAAO,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AAEnD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;gBAC7C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAOnF;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,oBAAoB;gBACnC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAGpE;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,oBAAoB;gBACpC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAGpE;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,oBAAoB;gBACrC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAGpE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,oBAAoB;gBACvC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAGpE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAChC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM;CAOjF;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBAClC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAGrE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;gBACxC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAGrD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;gBACnC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAStF;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;gBAC/C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAGrE;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,oBAAoB;gBAC/C,IAAI,EAAE,eAAe;CAGpC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,oBAAoB;gBAC/C,IAAI,EAAE,eAAe;CAGpC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/action/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,eAAe,EAAc,MAAM,QAAQ,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAErD,OAAO,EAAE,yBAAyB,EAAE,MAAM,QAAQ,CAAC;AAEnD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,mBAAmB;gBAC7C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAOnF;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,oBAAoB;gBACnC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAGpE;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,oBAAoB;gBACpC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAGpE;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,oBAAoB;gBACrC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAGpE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,oBAAoB;gBACvC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAGpE;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAChC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM;CAOjF;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBAClC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAGrE;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;gBACpC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAGrD;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,aAAa;gBACxC,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM;CAGrD;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;gBACnC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;CAStF;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,gBAAgB;CAAG;AAElE;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,oBAAoB;gBAC/C,IAAI,EAAE,eAAe;CAGpC;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,oBAAoB;gBAC/C,IAAI,EAAE,eAAe;CAGpC"}

package/dist/esm/action/errors.js

@@ -46,6 +46,11 @@ class ConstraintError extends ValidateError {
     super(path, `Constraint "${schema.constraint}": ${message}`, Status.ConstraintError);
   }
 }
+class IntegerRangeError extends ValidateError {
+  constructor(path, message) {
+    super(path, message, Status.ConstraintError);
+  }
+}
 class UnknownEnumValueError extends ValidateError {
   constructor(path, message) {
     super(path, message, Status.ConstraintError);
@@ -63,9 +68,6 @@ class ConformanceError extends ValidateError {
   }
 }
 class EnumValueConformanceError extends ConformanceError {
-  constructor(schema, path, message) {
-    super(schema, path, message);
-  }
 }
 class ExpiredReferenceError extends SchemaViolationError {
   constructor(path) {
@@ -83,6 +85,7 @@ export {
   DatatypeError,
   EnumValueConformanceError,
   ExpiredReferenceError,
+  IntegerRangeError,
   InvokeError,
   PhantomReferenceError,
   ReadError,

package/dist/esm/action/errors.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../src/action/errors.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,QAAQ,2BAA2B;AAE5C,SAAS,iCAAiC;AAKnC,MAAM,6BAA6B,oBAAoB;AAAA,EAC1D,YAAY,QAAgB,MAAuB,SAAiB,MAAc;AAC9E,UAAM,OAAO,GAAG,MAAM,IAAI,KAAK,QAAQ,IAAI,KAAK,OAAO,KAAK,IAAI;AAChE,UAAM,MAAM,IAAI;AAGhB,SAAK,UAAU;AAAA,EACnB;AACJ;AAKO,MAAM,kBAAkB,qBAAqB;AAAA,EAChD,YAAY,MAAuB,SAAiB,MAAe;AAC/D,UAAM,WAAW,MAAM,SAAS,QAAQ,OAAO,eAAe;AAAA,EAClE;AACJ;AAKO,MAAM,mBAAmB,qBAAqB;AAAA,EACjD,YAAY,MAAuB,SAAiB,MAAe;AAC/D,UAAM,WAAW,MAAM,SAAS,QAAQ,OAAO,gBAAgB;AAAA,EACnE;AACJ;AAKO,MAAM,oBAAoB,qBAAqB;AAAA,EAClD,YAAY,MAAuB,SAAiB,MAAe;AAC/D,UAAM,YAAY,MAAM,SAAS,QAAQ,OAAO,iBAAiB;AAAA,EACrE;AACJ;AAKO,MAAM,sBAAsB,qBAAqB;AAAA,EACpD,YAAY,MAAuB,SAAiB,MAAe;AAC/D,UAAM,cAAc,MAAM,SAAS,QAAQ,OAAO,eAAe;AAAA,EACrE;AACJ;AAKO,MAAM,sBAAsB,cAAc;AAAA,EAC7C,YAAY,MAAuB,MAAc,OAAgB,MAAe;AAC5E,QAAI,MAAM,GAAG,KAAK;AAClB,QAAI,IAAI,SAAS,IAAI;AACjB,YAAM,GAAG,IAAI,UAAU,EAAE,CAAC;AAAA,IAC9B;AACA,UAAM,MAAM,UAAU,GAAG,YAAY,IAAI,IAAI,IAAI;AAAA,EACrD;AACJ;AAKO,MAAM,wBAAwB,cAAc;AAAA,EAC/C,YAAY,QAAgB,MAAuB,SAAiB;AAChE,UAAM,MAAM,eAAgB,OAAsB,UAAU,MAAM,OAAO,IAAI,OAAO,eAAe;AAAA,EACvG;AACJ;AAKO,MAAM,8BAA8B,cAAc;AAAA,EACrD,YAAY,MAAuB,SAAiB;AAChD,UAAM,MAAM,SAAS,OAAO,eAAe;AAAA,EAC/C;AACJ;AAKO,MAAM,yBAAyB,cAAc;AAAA,EAChD,YAAY,QAAgB,MAAuB,SAAiB,QAAiB;AACjF,QAAI;AACJ,QAAI,QAAQ;AACR,eAAS,uBAAuB,MAAM;AAAA,IAC1C,OAAO;AACH,eAAS,gBAAiB,OAAsB,WAAW;AAAA,IAC/D;AACA,UAAM,MAAM,GAAG,MAAM,KAAK,OAAO,IAAI,OAAO,eAAe;AAAA,EAC/D;AACJ;AAKO,MAAM,kCAAkC,iBAAiB;AAAA,EAC5D,YAAY,QAAgB,MAAuB,SAAiB;AAChE,UAAM,QAAQ,MAAM,OAAO;AAAA,EAC/B;AACJ;AAKO,MAAM,8BAA8B,qBAAqB;AAAA,EAC5D,YAAY,MAAuB;AAC/B,UAAM,eAAe,MAAM,oEAAoE,OAAO,OAAO;AAAA,EACjH;AACJ;AAKO,MAAM,8BAA8B,qBAAqB;AAAA,EAC5D,YAAY,MAAuB;AAC/B,UAAM,eAAe,MAAM,yBAAyB,OAAO,OAAO;AAAA,EACtE;AACJ;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,QAAQ,2BAA2B;AAE5C,SAAS,iCAAiC;AAKnC,MAAM,6BAA6B,oBAAoB;AAAA,EAC1D,YAAY,QAAgB,MAAuB,SAAiB,MAAc;AAC9E,UAAM,OAAO,GAAG,MAAM,IAAI,KAAK,QAAQ,IAAI,KAAK,OAAO,KAAK,IAAI;AAChE,UAAM,MAAM,IAAI;AAGhB,SAAK,UAAU;AAAA,EACnB;AACJ;AAKO,MAAM,kBAAkB,qBAAqB;AAAA,EAChD,YAAY,MAAuB,SAAiB,MAAe;AAC/D,UAAM,WAAW,MAAM,SAAS,QAAQ,OAAO,eAAe;AAAA,EAClE;AACJ;AAKO,MAAM,mBAAmB,qBAAqB;AAAA,EACjD,YAAY,MAAuB,SAAiB,MAAe;AAC/D,UAAM,WAAW,MAAM,SAAS,QAAQ,OAAO,gBAAgB;AAAA,EACnE;AACJ;AAKO,MAAM,oBAAoB,qBAAqB;AAAA,EAClD,YAAY,MAAuB,SAAiB,MAAe;AAC/D,UAAM,YAAY,MAAM,SAAS,QAAQ,OAAO,iBAAiB;AAAA,EACrE;AACJ;AAKO,MAAM,sBAAsB,qBAAqB;AAAA,EACpD,YAAY,MAAuB,SAAiB,MAAe;AAC/D,UAAM,cAAc,MAAM,SAAS,QAAQ,OAAO,eAAe;AAAA,EACrE;AACJ;AAKO,MAAM,sBAAsB,cAAc;AAAA,EAC7C,YAAY,MAAuB,MAAc,OAAgB,MAAe;AAC5E,QAAI,MAAM,GAAG,KAAK;AAClB,QAAI,IAAI,SAAS,IAAI;AACjB,YAAM,GAAG,IAAI,UAAU,EAAE,CAAC;AAAA,IAC9B;AACA,UAAM,MAAM,UAAU,GAAG,YAAY,IAAI,IAAI,IAAI;AAAA,EACrD;AACJ;AAKO,MAAM,wBAAwB,cAAc;AAAA,EAC/C,YAAY,QAAgB,MAAuB,SAAiB;AAChE,UAAM,MAAM,eAAgB,OAAsB,UAAU,MAAM,OAAO,IAAI,OAAO,eAAe;AAAA,EACvG;AACJ;AAKO,MAAM,0BAA0B,cAAc;AAAA,EACjD,YAAY,MAAuB,SAAiB;AAChD,UAAM,MAAM,SAAS,OAAO,eAAe;AAAA,EAC/C;AACJ;AAKO,MAAM,8BAA8B,cAAc;AAAA,EACrD,YAAY,MAAuB,SAAiB;AAChD,UAAM,MAAM,SAAS,OAAO,eAAe;AAAA,EAC/C;AACJ;AAKO,MAAM,yBAAyB,cAAc;AAAA,EAChD,YAAY,QAAgB,MAAuB,SAAiB,QAAiB;AACjF,QAAI;AACJ,QAAI,QAAQ;AACR,eAAS,uBAAuB,MAAM;AAAA,IAC1C,OAAO;AACH,eAAS,gBAAiB,OAAsB,WAAW;AAAA,IAC/D;AACA,UAAM,MAAM,GAAG,MAAM,KAAK,OAAO,IAAI,OAAO,eAAe;AAAA,EAC/D;AACJ;AAKO,MAAM,kCAAkC,iBAAiB;AAAC;AAK1D,MAAM,8BAA8B,qBAAqB;AAAA,EAC5D,YAAY,MAAuB;AAC/B,UAAM,eAAe,MAAM,oEAAoE,OAAO,OAAO;AAAA,EACjH;AACJ;AAKO,MAAM,8BAA8B,qBAAqB;AAAA,EAC5D,YAAY,MAAuB;AAC/B,UAAM,eAAe,MAAM,yBAAyB,OAAO,OAAO;AAAA,EACtE;AACJ;",
   "names": []
 }

package/dist/esm/action/request/Subscribe.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import type { ReadResult } from "#action/response/ReadResult.js";
-import { CanceledError, Duration, TimeoutError } from "#general";
+import { Duration } from "#general";
 import { Read } from "./Read.js";
 /**
  * Defines a subscription.
@@ -24,7 +24,7 @@ export interface Subscribe extends Read {
     /**
      * Invoked when the subscription is no longer active.
      */
-    closed?: (cause: CanceledError | TimeoutError) => void;
+    closed?: () => void;
 }
 export declare function Subscribe(options: Subscribe.Options, ...selectors: Read.Selector[]): Subscribe;
 export declare namespace Subscribe {

package/dist/esm/action/request/Subscribe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Subscribe.d.ts","sourceRoot":"","sources":["../../../../src/action/request/Subscribe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAW,YAAY,EAAc,MAAM,UAAU,CAAC;AAEtF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,QAAQ,CAAC;IAC5B,kBAAkB,CAAC,EAAE,QAAQ,CAAC;IAC9B,mBAAmB,CAAC,EAAE,QAAQ,CAAC;IAE/B;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,GAAG,YAAY,KAAK,IAAI,CAAC;CAC1D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,CAuB9F;AAED,yBAAiB,SAAS,CAAC;IACvB,UAAiB,OAAQ,SAAQ,IAAI,CAAC,OAAO;QACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,gBAAgB,CAAC,EAAE,QAAQ,CAAC;QAC5B,kBAAkB,CAAC,EAAE,QAAQ,CAAC;QAC9B,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;KAChC;CACJ"}
+{"version":3,"file":"Subscribe.d.ts","sourceRoot":"","sources":["../../../../src/action/request/Subscribe.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAuB,MAAM,UAAU,CAAC;AAEzD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI;IACnC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,CAAC,EAAE,QAAQ,CAAC;IAC5B,kBAAkB,CAAC,EAAE,QAAQ,CAAC;IAC9B,mBAAmB,CAAC,EAAE,QAAQ,CAAC;IAE/B;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,EAAE,GAAG,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,CAuB9F;AAED,yBAAiB,SAAS,CAAC;IACvB,UAAiB,OAAQ,SAAQ,IAAI,CAAC,OAAO;QACzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,gBAAgB,CAAC,EAAE,QAAQ,CAAC;QAC5B,kBAAkB,CAAC,EAAE,QAAQ,CAAC;QAC9B,MAAM,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QAC9B,MAAM,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;KAChC;CACJ"}

package/dist/esm/action/request/Subscribe.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/action/request/Subscribe.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAkC,SAAuB,kBAAkB;AAC3E,SAAS,6BAA6B;AACtC,SAAS,YAAY;AAyBd,SAAS,UAAU,YAA+B,WAAuC;AAC5F,QAAM,YAAY,KAAK,SAAS,GAAG,SAAS;AAE5C,QAAM,EAAE,mBAAmB,kBAAkB,mBAAmB,IAAI;AACpE,YAAU,oBAAoB,qBAAqB;AAEnD,MAAI,qBAAqB,QAAW;AAChC,QAAI,mBAAmB,KAAK,QAAQ,GAAG,gBAAgB,IAAI,YAAY;AACnE,YAAM,IAAI,sBAAsB,0BAA0B,QAAQ,GAAG,gBAAgB,CAAC,kBAAkB;AAAA,IAC5G;AACA,cAAU,mBAAmB;AAAA,EACjC;AAEA,MAAI,uBAAuB,QAAW;AAClC,QAAI,qBAAqB,KAAK,QAAQ,GAAG,kBAAkB,IAAI,YAAY;AACvE,YAAM,IAAI;AAAA,QACN,4BAA4B,QAAQ,GAAG,kBAAkB,CAAC;AAAA,MAC9D;AAAA,IACJ;AACA,cAAU,qBAAqB;AAAA,EACnC;AAEA,SAAO;AACX;",
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAmB,SAAS,kBAAkB;AAC9C,SAAS,6BAA6B;AACtC,SAAS,YAAY;AAyBd,SAAS,UAAU,YAA+B,WAAuC;AAC5F,QAAM,YAAY,KAAK,SAAS,GAAG,SAAS;AAE5C,QAAM,EAAE,mBAAmB,kBAAkB,mBAAmB,IAAI;AACpE,YAAU,oBAAoB,qBAAqB;AAEnD,MAAI,qBAAqB,QAAW;AAChC,QAAI,mBAAmB,KAAK,QAAQ,GAAG,gBAAgB,IAAI,YAAY;AACnE,YAAM,IAAI,sBAAsB,0BAA0B,QAAQ,GAAG,gBAAgB,CAAC,kBAAkB;AAAA,IAC5G;AACA,cAAU,mBAAmB;AAAA,EACjC;AAEA,MAAI,uBAAuB,QAAW;AAClC,QAAI,qBAAqB,KAAK,QAAQ,GAAG,kBAAkB,IAAI,YAAY;AACvE,YAAM,IAAI;AAAA,QACN,4BAA4B,QAAQ,GAAG,kBAAkB,CAAC;AAAA,MAC9D;AAAA,IACJ;AACA,cAAU,qBAAqB;AAAA,EACnC;AAEA,SAAO;AACX;",
   "names": []
 }

package/dist/esm/action/response/ReadResult.d.ts

@@ -13,7 +13,7 @@ import type { AttributeId, AttributePath, ClusterId, EndpointNumber, EventId, Ev
  * Iteration occurs in chunks for performance reasons.  A chunk is an iterable of reports, one per output attribute or
  * event.
  */
-export interface ReadResult<Chunk = ReadResult.Chunk> extends AsyncIterable<ReadResult.Chunk> {
+export interface ReadResult<Chunk = ReadResult.Chunk> extends AsyncIterableIterator<ReadResult.Chunk> {
 }
 export declare namespace ReadResult {
     type Chunk = Iterable<Report>;

package/dist/esm/action/response/ReadResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReadResult.d.ts","sourceRoot":"","sources":["../../../../src/action/response/ReadResult.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACR,WAAW,EACX,aAAa,EACb,SAAS,EACT,cAAc,EACd,OAAO,EACP,WAAW,EACX,SAAS,EACT,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,SAAS,EACZ,MAAM,QAAQ,CAAC;AAEhB;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAE,SAAQ,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC;CAAG;AAEhG,yBAAiB,UAAU,CAAC;IACxB,KAAY,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAErC,KAAY,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,UAAU,GAAG,WAAW,CAAC;IAEjF,UAAiB,qBAAsB,SAAQ,aAAa;QACxD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,cAAc,CAAC;QAC3B,SAAS,EAAE,SAAS,CAAC;QACrB,WAAW,EAAE,WAAW,CAAC;KAC5B;IAED,UAAiB,cAAc;QAC3B,IAAI,EAAE,YAAY,CAAC;QACnB,IAAI,EAAE,qBAAqB,CAAC;QAC5B,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;KAC3B;IAED,UAAiB,eAAe;QAC5B,IAAI,EAAE,aAAa,CAAC;QACpB,IAAI,EAAE,qBAAqB,CAAC;QAC5B,MAAM,EAAE,UAAU,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KAC1B;IAED,UAAiB,iBAAkB,SAAQ,SAAS;QAChD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,cAAc,CAAC;QAC3B,SAAS,EAAE,SAAS,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC;KACpB;IAED,UAAiB,UAAU;QACvB,IAAI,EAAE,aAAa,CAAC;QACpB,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE,WAAW,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,QAAQ,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;KAC3B;IAED,UAAiB,WAAW;QACxB,IAAI,EAAE,cAAc,CAAC;QACrB,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KAC1B;CACJ"}
+{"version":3,"file":"ReadResult.d.ts","sourceRoot":"","sources":["../../../../src/action/response/ReadResult.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACR,WAAW,EACX,aAAa,EACb,SAAS,EACT,cAAc,EACd,OAAO,EACP,WAAW,EACX,SAAS,EACT,MAAM,EACN,QAAQ,EACR,MAAM,EACN,UAAU,EACV,SAAS,EACZ,MAAM,QAAQ,CAAC;AAEhB;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,CAAE,SAAQ,qBAAqB,CAAC,UAAU,CAAC,KAAK,CAAC;CAAG;AAExG,yBAAiB,UAAU,CAAC;IACxB,KAAY,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAErC,KAAY,MAAM,GAAG,cAAc,GAAG,eAAe,GAAG,UAAU,GAAG,WAAW,CAAC;IAEjF,UAAiB,qBAAsB,SAAQ,aAAa;QACxD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,cAAc,CAAC;QAC3B,SAAS,EAAE,SAAS,CAAC;QACrB,WAAW,EAAE,WAAW,CAAC;KAC5B;IAED,UAAiB,cAAc;QAC3B,IAAI,EAAE,YAAY,CAAC;QACnB,IAAI,EAAE,qBAAqB,CAAC;QAC5B,KAAK,EAAE,OAAO,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;KAC3B;IAED,UAAiB,eAAe;QAC5B,IAAI,EAAE,aAAa,CAAC;QACpB,IAAI,EAAE,qBAAqB,CAAC;QAC5B,MAAM,EAAE,UAAU,CAAC;QACnB,aAAa,CAAC,EAAE,MAAM,CAAC;KAC1B;IAED,UAAiB,iBAAkB,SAAQ,SAAS;QAChD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,cAAc,CAAC;QAC3B,SAAS,EAAE,SAAS,CAAC;QACrB,OAAO,EAAE,OAAO,CAAC;KACpB;IAED,UAAiB,UAAU;QACvB,IAAI,EAAE,aAAa,CAAC;QACpB,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE,WAAW,CAAC;QACpB,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,QAAQ,CAAC;QACnB,KAAK,EAAE,OAAO,CAAC;QACf,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;KAC3B;IAED,UAAiB,WAAW;QACxB,IAAI,EAAE,cAAc,CAAC;QACrB,IAAI,EAAE,iBAAiB,CAAC;QACxB,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KAC1B;CACJ"}