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

package/dist/cjs/action/client/subscription/ClientSubscription.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { Subscribe } from "#action/request/Subscribe.js";
+import type { ActiveSubscription } from "#action/response/SubscribeResult.js";
+import { Abort, Logger } from "#general";
+import { PeerAddress } from "#peer/PeerAddress.js";
+import { ClientSubscribe } from "./ClientSubscribe.js";
+/**
+ * The client view of an established Matter subscription.
+ */
+export declare abstract class ClientSubscription implements ActiveSubscription {
+    #private;
+    readonly request: Subscribe;
+    readonly peer: PeerAddress;
+    abstract subscriptionId: number;
+    abstract maxInterval: number;
+    abstract interactionModelRevision: number;
+    /**
+     * If the subscription has an async worker, this is the promise associated with the worker.
+     */
+    done?: Promise<void>;
+    constructor({ request, peer, closed, abort }: ClientSubscription.Configuration);
+    close(): void;
+    protected get abort(): Abort;
+    protected get logger(): Logger;
+}
+export declare namespace ClientSubscription {
+    interface Configuration {
+        request: ClientSubscribe;
+        peer: PeerAddress;
+        closed: () => void;
+        abort?: AbortSignal;
+    }
+}
+//# sourceMappingURL=ClientSubscription.d.ts.map

package/dist/cjs/action/client/subscription/ClientSubscription.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientSubscription.d.ts","sourceRoot":"","sources":["../../../../../src/action/client/subscription/ClientSubscription.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,KAAK,EAAc,MAAM,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAIvD;;GAEG;AACH,8BAAsB,kBAAmB,YAAW,kBAAkB;;IAClE,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,wBAAwB,EAAE,MAAM,CAAC;IAE1C;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAMT,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,kBAAkB,CAAC,aAAa;IAU9E,KAAK;IA4BL,SAAS,KAAK,KAAK,UAElB;IAED,SAAS,KAAK,MAAM,WAEnB;CACJ;AAED,yBAAiB,kBAAkB,CAAC;IAChC,UAAiB,aAAa;QAC1B,OAAO,EAAE,eAAe,CAAC;QACzB,IAAI,EAAE,WAAW,CAAC;QAClB,MAAM,EAAE,MAAM,IAAI,CAAC;QACnB,KAAK,CAAC,EAAE,WAAW,CAAC;KACvB;CACJ"}

package/dist/cjs/action/client/subscription/ClientSubscription.js

@@ -0,0 +1,79 @@
+"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 ClientSubscription_exports = {};
+__export(ClientSubscription_exports, {
+  ClientSubscription: () => ClientSubscription
+});
+module.exports = __toCommonJS(ClientSubscription_exports);
+var import_general = require("#general");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("ClientSubscription");
+class ClientSubscription {
+  request;
+  peer;
+  /**
+   * If the subscription has an async worker, this is the promise associated with the worker.
+   */
+  done;
+  #closed;
+  #abort;
+  #isClosed = false;
+  constructor({ request, peer, closed, abort }) {
+    this.request = request;
+    this.peer = peer;
+    this.#closed = closed;
+    this.#abort = new import_general.Abort({
+      abort,
+      handler: this.close.bind(this)
+    });
+  }
+  close() {
+    if (this.#isClosed) {
+      return;
+    }
+    this.#isClosed = true;
+    this.#abort();
+    this.#closed();
+    const unhandledError = (e) => {
+      this.logger.error("Unhandled error in subscription to", import_general.Diagnostic.strong(this.peer.toString()), e);
+    };
+    if (this.done) {
+      this.done.finally(() => {
+        this.request.closed?.();
+      }).catch(unhandledError);
+    } else {
+      try {
+        this.request.closed?.();
+      } catch (e) {
+        unhandledError(e);
+      }
+    }
+  }
+  get abort() {
+    return this.#abort;
+  }
+  get logger() {
+    return logger;
+  }
+}
+//# sourceMappingURL=ClientSubscription.js.map

package/dist/cjs/action/client/subscription/ClientSubscription.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/action/client/subscription/ClientSubscription.ts"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,qBAA0C;AAR1C;AAAA;AAAA;AAAA;AAAA;AAYA,MAAM,SAAS,sBAAO,IAAI,oBAAoB;AAKvC,MAAe,mBAAiD;AAAA,EAC1D;AAAA,EACA;AAAA;AAAA;AAAA;AAAA,EAQT;AAAA,EAES;AAAA,EACA;AAAA,EACT,YAAY;AAAA,EAEZ,YAAY,EAAE,SAAS,MAAM,QAAQ,MAAM,GAAqC;AAC5E,SAAK,UAAU;AACf,SAAK,OAAO;AACZ,SAAK,UAAU;AACf,SAAK,SAAS,IAAI,qBAAM;AAAA,MACpB;AAAA,MACA,SAAS,KAAK,MAAM,KAAK,IAAI;AAAA,IACjC,CAAC;AAAA,EACL;AAAA,EAEA,QAAQ;AACJ,QAAI,KAAK,WAAW;AAChB;AAAA,IACJ;AACA,SAAK,YAAY;AAEjB,SAAK,OAAO;AACZ,SAAK,QAAQ;AAEb,UAAM,iBAAiB,CAAC,MAAe;AACnC,WAAK,OAAO,MAAM,sCAAsC,0BAAW,OAAO,KAAK,KAAK,SAAS,CAAC,GAAG,CAAC;AAAA,IACtG;AAEA,QAAI,KAAK,MAAM;AACX,WAAK,KACA,QAAQ,MAAM;AACX,aAAK,QAAQ,SAAS;AAAA,MAC1B,CAAC,EACA,MAAM,cAAc;AAAA,IAC7B,OAAO;AACH,UAAI;AACA,aAAK,QAAQ,SAAS;AAAA,MAC1B,SAAS,GAAG;AACR,uBAAe,CAAC;AAAA,MACpB;AAAA,IACJ;AAAA,EACJ;AAAA,EAEA,IAAc,QAAQ;AAClB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAc,SAAS;AACnB,WAAO;AAAA,EACX;AACJ;",
+  "names": []
+}

package/dist/cjs/action/client/subscription/ClientSubscriptionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClientSubscriptionHandler.d.ts","sourceRoot":"","sources":["../../../../../src/action/client/subscription/ClientSubscriptionHandler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAI/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAI/D;;GAEG;AACH,qBAAa,yBAA0B,YAAW,eAAe;;IAC7D,EAAE,SAA2B;IAC7B,qBAAqB,UAAQ;gBAIjB,aAAa,EAAE,mBAAmB;IAIxC,aAAa,CAAC,QAAQ,EAAE,eAAe;IAyDvC,KAAK;CACd"}

package/dist/cjs/action/client/{ClientSubscriptionHandler.js → subscription/ClientSubscriptionHandler.js}

@@ -24,8 +24,9 @@ module.exports = __toCommonJS(ClientSubscriptionHandler_exports);
 var import_general = require("#general");
 var import_DecodedDataReport = require("#interaction/DecodedDataReport.js");
 var import_InteractionMessenger = require("#interaction/InteractionMessenger.js");
+var import_SecureSession = require("#session/SecureSession.js");
 var import_types = require("#types");
-var import_InputChunk = require("./InputChunk.js");
+var import_InputChunk = require("../InputChunk.js");
 /**
  * @license
  * Copyright 2022-2025 Matter.js Authors
@@ -53,7 +54,9 @@ class ClientSubscriptionHandler {
       await sendInvalid(messenger, void 0);
       return;
     }
-    const subscription = this.#subscriptions.get(subscriptionId);
+    const { session } = exchange.channel;
+    import_SecureSession.SecureSession.assert(session);
+    const subscription = this.#subscriptions.getPeer(session.peerAddress, subscriptionId);
     if (subscription === void 0) {
       logger.debug("Ignoring data report for unknown subscription ID", import_general.Diagnostic.strong(subscriptionId));
       await sendInvalid(messenger, subscriptionId);

package/dist/cjs/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,qBAAkD;AAClD,+BAAkC;AAClC,kCAAmD;AAInD,2BAA8B;AAC9B,mBAA4D;AAC5D,wBAA2B;AAf3B;AAAA;AAAA;AAAA;AAAA;AAkBA,MAAM,SAAS,sBAAO,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,+DAAmC,QAAQ;AAEjE,UAAM,UAAU,UAAU,gBAAgB;AAE1C,UAAM,mBAAmB,MAAM,QAAQ,KAAK;AAC5C,QAAI,iBAAiB,MAAM;AACvB,YAAM,IAAI,6BAAc,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,uCAAc,OAAO,OAAO;AAC5B,UAAM,eAAe,KAAK,eAAe,QAAQ,QAAQ,aAAa,cAAc;AACpF,QAAI,iBAAiB,QAAW;AAC5B,aAAO,MAAM,oDAAoD,0BAAW,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,oBAAO,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,YAAM,8BAAW,aAAa;AAE9B,QAAM,EAAE,eAAe,IAAI;AAE3B,mBAAiB,UAAU,cAAc;AACrC,UAAM,cAAU,4CAAkB,MAAM;AAExC,QAAI,QAAQ,mBAAmB,QAAW;AACtC,aAAO;AAAA,QACH;AAAA,QACA,0BAAW,OAAO,QAAQ,cAAc;AAAA,MAC5C;AACA,YAAM,YAAY,WAAW,QAAQ,cAAc;AAAA,IACvD;AAEA,QAAI,QAAQ,mBAAmB,gBAAgB;AAC3C,aAAO;AAAA,QACH;AAAA,QACA,0BAAW,OAAO,QAAQ,cAAc;AAAA,MAC5C;AACA,YAAM,YAAY,WAAW,QAAQ,cAAc;AACnD;AAAA,IACJ;AAEA,cAAM,8BAAW,MAAM;AAAA,EAC3B;AACJ;",
+  "names": []
+}

package/dist/{esm/action/client → cjs/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/cjs/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/cjs/action/client/subscription/ClientSubscriptions.js

@@ -0,0 +1,133 @@
+"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 ClientSubscriptions_exports = {};
+__export(ClientSubscriptions_exports, {
+  ClientSubscriptions: () => ClientSubscriptions
+});
+module.exports = __toCommonJS(ClientSubscriptions_exports);
+var import_general = require("#general");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class ClientSubscriptions {
+  #active = new import_general.BasicSet();
+  #peers = /* @__PURE__ */ new Map();
+  #timeout;
+  static [import_general.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 = import_general.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 = (0, import_general.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 = (0, import_general.Millis)(nextTimeoutAt - now);
+    } else {
+      this.#timeout = import_general.Time.getTimer(
+        "Subscription timeout",
+        (0, import_general.Millis)(nextTimeoutAt - now),
+        this.resetTimer.bind(this)
+      );
+    }
+    this.#timeout.start();
+  }
+}
+//# sourceMappingURL=ClientSubscriptions.js.map

package/dist/cjs/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,qBAAqF;AARrF;AAAA;AAAA;AAAA;AAAA;AAiBO,MAAM,oBAAoB;AAAA,EAC7B,UAAU,IAAI,wBAA6B;AAAA,EAC3C,SAAS,oBAAI,IAAgD;AAAA,EAC7D;AAAA,EAEA,QAAQ,6BAAc,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,oBAAK;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,gBAAY,0BAAU,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,eAAW,uBAAO,gBAAgB,GAAG;AAAA,IACvD,OAAO;AACH,WAAK,WAAW,oBAAK;AAAA,QACjB;AAAA,YACA,uBAAO,gBAAgB,GAAG;AAAA,QAC1B,KAAK,WAAW,KAAK,IAAI;AAAA,MAC7B;AAAA,IACJ;AACA,SAAK,SAAS,MAAM;AAAA,EACxB;AACJ;",
+  "names": []
+}

package/dist/cjs/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/cjs/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/cjs/action/client/subscription/PeerSubscription.js

@@ -0,0 +1,57 @@
+"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 PeerSubscription_exports = {};
+__export(PeerSubscription_exports, {
+  PeerSubscription: () => PeerSubscription
+});
+module.exports = __toCommonJS(PeerSubscription_exports);
+var import_general = require("#general");
+var import_ClientSubscription = require("./ClientSubscription.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+class PeerSubscription extends import_ClientSubscription.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 (0, import_general.Millis)((0, import_general.Seconds)(this.maxInterval) + (this.request.maxPeerResponseTime ?? 0));
+  }
+  timedOut() {
+    this.logger.info(
+      "Subscription",
+      import_general.Diagnostic.strong(this.subscriptionId),
+      "timed out after",
+      import_general.Diagnostic.strong(import_general.Duration.format(this.timeout))
+    );
+    this.close();
+  }
+}
+//# sourceMappingURL=PeerSubscription.js.map

package/dist/cjs/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,qBAAiE;AAEjE,gCAAmC;AARnC;AAAA;AAAA;AAAA;AAAA;AAaO,MAAM,yBAAyB,6CAAmB;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,eAAO,2BAAO,wBAAQ,KAAK,WAAW,KAAK,KAAK,QAAQ,uBAAuB,EAAE;AAAA,EACrF;AAAA,EAEA,WAAW;AACP,SAAK,OAAO;AAAA,MACR;AAAA,MACA,0BAAW,OAAO,KAAK,cAAc;AAAA,MACrC;AAAA,MACA,0BAAW,OAAO,wBAAS,OAAO,KAAK,OAAO,CAAC;AAAA,IACnD;AAEA,SAAK,MAAM;AAAA,EACf;AACJ;",
+  "names": []
+}

package/dist/cjs/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/cjs/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/cjs/action/client/subscription/SustainedSubscription.js

@@ -0,0 +1,143 @@
+"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 SustainedSubscription_exports = {};
+__export(SustainedSubscription_exports, {
+  SustainedSubscription: () => SustainedSubscription
+});
+module.exports = __toCommonJS(SustainedSubscription_exports);
+var import_general = require("#general");
+var import_model = require("#model");
+var import_ClientSubscription = require("./ClientSubscription.js");
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("ClientSubscription");
+class SustainedSubscription extends import_ClientSubscription.ClientSubscription {
+  #request;
+  #subscription;
+  #retries;
+  #subscribe;
+  #active = (0, import_general.AsyncObservableValue)(false);
+  #inactive = (0, import_general.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 ${import_general.Duration.format(retry)}:`,
+            import_general.Diagnostic.errorMessage((0, import_general.asError)(e))
+          );
+        }
+        const readyForRetry = import_general.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 ?? import_model.Specification.INTERACTION_MODEL_REVISION;
+  }
+  get maxInterval() {
+    return this.#subscription?.maxInterval ?? import_general.Hours.one;
+  }
+  get subscriptionId() {
+    return this.#subscription?.subscriptionId ?? SustainedSubscription.NO_SUBSCRIPTION;
+  }
+}
+((SustainedSubscription2) => {
+  function assert(subscription) {
+    if (!(subscription instanceof SustainedSubscription2)) {
+      throw new import_general.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: (0, import_general.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: (0, import_general.Hours)(1),
+    // No timeout; we run until aborted
+    timeout: void 0,
+    backoffFactor: 2,
+    jitterFactor: 0.25
+  };
+})(SustainedSubscription || (SustainedSubscription = {}));
+//# sourceMappingURL=SustainedSubscription.js.map