@matter/protocol 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/cjs/session/SessionManager.d.ts

@@ -0,0 +1,132 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { FabricManager } from "#fabric/FabricManager.js";
+import { BasicSet, Construction, Environment, Environmental, Observable, StorageContext } from "#general";
+import { Subscription } from "#interaction/Subscription.js";
+import { PeerAddress } from "#peer/PeerAddress.js";
+import { CaseAuthenticatedTag, FabricIndex, NodeId } from "#types";
+import { Fabric } from "../fabric/Fabric.js";
+import { InsecureSession } from "./InsecureSession.js";
+import { SecureSession } from "./SecureSession.js";
+import { Session, SessionParameterOptions, SessionParameters } from "./Session.js";
+export declare const UNICAST_UNSECURE_SESSION_ID = 0;
+export interface ResumptionRecord {
+    sharedSecret: Uint8Array;
+    resumptionId: Uint8Array;
+    fabric: Fabric;
+    peerNodeId: NodeId;
+    sessionParameters: SessionParameters;
+    caseAuthenticatedTags?: CaseAuthenticatedTag[];
+}
+/**
+ * Interfaces {@link SessionManager} with other components.
+ */
+export interface SessionManagerContext {
+    fabrics: FabricManager;
+    storage: StorageContext;
+    /**
+     * Parameter overrides.
+     */
+    parameters?: Partial<SessionParameters>;
+    /**
+     * This is an arbitrary contextual object attached to sessions used for compatibility with legacy APIs.
+     *
+     * @deprecated
+     */
+    owner?: unknown;
+}
+/**
+ * Manages Matter sessions associated with peer connections.
+ */
+export declare class SessionManager {
+    #private;
+    constructor(context: SessionManagerContext);
+    [Environmental.create](env: Environment): SessionManager;
+    get construction(): Construction<SessionManager>;
+    get context(): SessionManagerContext;
+    /**
+     * Active secure sessions.
+     */
+    get sessions(): BasicSet<SecureSession, SecureSession>;
+    /**
+     * Active insecure sessions.
+     */
+    get insecureSessions(): Map<NodeId, InsecureSession>;
+    /**
+     * Our session parameters.  These are the parameters we provide during session negotiation.  The peer may specify
+     * different parameters.
+     */
+    get sessionParameters(): {
+        idleIntervalMs: number;
+        activeIntervalMs: number;
+        activeThresholdMs: number;
+        dataModelRevision: number;
+        interactionModelRevision: number;
+        specificationVersion: number;
+        maxPathsPerInvoke: number;
+    };
+    /**
+     * Emits when there is a change to the subscription set.
+     */
+    get subscriptionsChanged(): Observable<[session: SecureSession, subscription: Subscription], void>;
+    /**
+     * Emits when resubmission is necessary due to timeout or network error.
+     */
+    get resubmissionStarted(): Observable<[session: Session], void>;
+    /**
+     * Convenience function for accessing a fabric by address.
+     */
+    fabricFor(address: FabricIndex | PeerAddress): Fabric;
+    /**
+     * @deprecated
+     */
+    get owner(): unknown;
+    createInsecureSession(options: {
+        initiatorNodeId?: NodeId;
+        sessionParameters?: SessionParameterOptions;
+        isInitiator?: boolean;
+    }): InsecureSession;
+    createSecureSession(args: {
+        sessionId: number;
+        fabric: Fabric | undefined;
+        peerNodeId: NodeId;
+        peerSessionId: number;
+        sharedSecret: Uint8Array;
+        salt: Uint8Array;
+        isInitiator: boolean;
+        isResumption: boolean;
+        peerSessionParameters?: SessionParameterOptions;
+        caseAuthenticatedTags?: CaseAuthenticatedTag[];
+    }): Promise<SecureSession>;
+    deleteResumptionRecord(address: PeerAddress): Promise<void>;
+    deleteResumptionRecordsForFabric(fabric: Fabric): Promise<void>;
+    findOldestInactiveSession(): SecureSession;
+    getNextAvailableSessionId(): Promise<number>;
+    getSession(sessionId: number): SecureSession | undefined;
+    getPaseSession(): SecureSession;
+    getSessionForNode(address: PeerAddress): SecureSession | undefined;
+    removeAllSessionsForNode(address: PeerAddress, sendClose?: boolean): Promise<void>;
+    getUnsecureSession(sourceNodeId?: NodeId): InsecureSession | undefined;
+    findGroupSession(groupId: number, groupSessionId: number): void;
+    findResumptionRecordById(resumptionId: Uint8Array): ResumptionRecord | undefined;
+    findResumptionRecordByAddress(address: PeerAddress): ResumptionRecord | undefined;
+    saveResumptionRecord(resumptionRecord: ResumptionRecord): Promise<void>;
+    getActiveSessionInformation(): {
+        name: string;
+        nodeId: NodeId;
+        peerNodeId: NodeId;
+        fabric: import("../fabric/Fabric.js").ExposedFabricInformation | undefined;
+        isPeerActive: boolean;
+        secure: boolean;
+        lastInteractionTimestamp: number | undefined;
+        lastActiveTimestamp: number | undefined;
+        numberOfActiveSubscriptions: number;
+    }[];
+    close(): Promise<void>;
+    updateAllSubscriptions(): void;
+    clearSubscriptionsForNode(fabricIndex: FabricIndex, nodeId: NodeId, flushSubscriptions?: boolean): Promise<void>;
+}
+//# sourceMappingURL=SessionManager.d.ts.map

package/dist/cjs/session/SessionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../../src/session/SessionManager.ts"],"names":[],"mappings":"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"}

package/dist/cjs/session/SessionManager.js

@@ -0,0 +1,410 @@
+"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 SessionManager_exports = {};
+__export(SessionManager_exports, {
+  SessionManager: () => SessionManager,
+  UNICAST_UNSECURE_SESSION_ID: () => UNICAST_UNSECURE_SESSION_ID
+});
+module.exports = __toCommonJS(SessionManager_exports);
+var import_FabricManager = require("#fabric/FabricManager.js");
+var import_general = require("#general");
+var import_model = require("#model");
+var import_PeerAddress = require("#peer/PeerAddress.js");
+var import_types = require("#types");
+var import_MessageCounter = require("../protocol/MessageCounter.js");
+var import_InsecureSession = require("./InsecureSession.js");
+var import_SecureSession = require("./SecureSession.js");
+var import_Session = require("./Session.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+const logger = import_general.Logger.get("SessionManager");
+const DEFAULT_SESSION_PARAMETERS = {
+  idleIntervalMs: import_Session.SESSION_IDLE_INTERVAL_MS,
+  activeIntervalMs: import_Session.SESSION_ACTIVE_INTERVAL_MS,
+  activeThresholdMs: import_Session.SESSION_ACTIVE_THRESHOLD_MS,
+  dataModelRevision: import_model.Specification.DATA_MODEL_REVISION,
+  interactionModelRevision: import_model.Specification.INTERACTION_MODEL_REVISION,
+  specificationVersion: import_model.Specification.SPECIFICATION_VERSION,
+  maxPathsPerInvoke: import_types.DEFAULT_MAX_PATHS_PER_INVOKE
+};
+const UNICAST_UNSECURE_SESSION_ID = 0;
+class SessionManager {
+  #context;
+  #insecureSessions = /* @__PURE__ */ new Map();
+  #sessions = new import_general.BasicSet();
+  #nextSessionId = import_general.Crypto.getRandomUInt16();
+  #resumptionRecords = new import_PeerAddress.PeerAddressMap();
+  #globalUnencryptedMessageCounter = new import_MessageCounter.MessageCounter();
+  #subscriptionsChanged = (0, import_general.Observable)();
+  #sessionParameters;
+  #resubmissionStarted = new import_general.Observable();
+  #construction;
+  #observers = new import_general.ObserverGroup();
+  #subscriptionUpdateMutex = new import_general.Mutex(this);
+  constructor(context) {
+    this.#context = context;
+    this.#sessionParameters = { ...DEFAULT_SESSION_PARAMETERS, ...context.parameters };
+    this.#observers.on(
+      context.fabrics.events.deleted,
+      async (fabric) => this.deleteResumptionRecordsForFabric(fabric)
+    );
+    this.#construction = (0, import_general.Construction)(this, () => this.#initialize());
+  }
+  [import_general.Environmental.create](env) {
+    const instance = new SessionManager({
+      storage: env.get(import_general.StorageManager).createContext("sessions"),
+      fabrics: env.get(import_FabricManager.FabricManager)
+    });
+    env.set(SessionManager, instance);
+    return instance;
+  }
+  get construction() {
+    return this.#construction;
+  }
+  get context() {
+    return this.#context;
+  }
+  /**
+   * Active secure sessions.
+   */
+  get sessions() {
+    return this.#sessions;
+  }
+  /**
+   * Active insecure sessions.
+   */
+  get insecureSessions() {
+    return this.#insecureSessions;
+  }
+  /**
+   * Our session parameters.  These are the parameters we provide during session negotiation.  The peer may specify
+   * different parameters.
+   */
+  get sessionParameters() {
+    return this.#sessionParameters;
+  }
+  /**
+   * Emits when there is a change to the subscription set.
+   */
+  get subscriptionsChanged() {
+    return this.#subscriptionsChanged;
+  }
+  /**
+   * Emits when resubmission is necessary due to timeout or network error.
+   */
+  get resubmissionStarted() {
+    return this.#resubmissionStarted;
+  }
+  /**
+   * Convenience function for accessing a fabric by address.
+   */
+  fabricFor(address) {
+    return this.#context.fabrics.for(address);
+  }
+  /**
+   * @deprecated
+   */
+  get owner() {
+    return this.#context.owner;
+  }
+  createInsecureSession(options) {
+    this.#construction.assert();
+    const { initiatorNodeId, sessionParameters, isInitiator } = options;
+    if (initiatorNodeId !== void 0) {
+      if (this.#insecureSessions.has(initiatorNodeId)) {
+        throw new import_general.MatterFlowError(`UnsecureSession with NodeId ${initiatorNodeId} already exists.`);
+      }
+    }
+    while (true) {
+      const session = new import_InsecureSession.InsecureSession({
+        manager: this,
+        messageCounter: this.#globalUnencryptedMessageCounter,
+        initiatorNodeId,
+        sessionParameters,
+        isInitiator: isInitiator ?? false
+      });
+      const ephemeralNodeId = session.nodeId;
+      if (this.#insecureSessions.has(ephemeralNodeId)) continue;
+      this.#insecureSessions.set(ephemeralNodeId, session);
+      return session;
+    }
+  }
+  async createSecureSession(args) {
+    await this.construction;
+    const {
+      sessionId,
+      fabric,
+      peerNodeId,
+      peerSessionId,
+      sharedSecret,
+      salt,
+      isInitiator,
+      isResumption,
+      peerSessionParameters,
+      caseAuthenticatedTags
+    } = args;
+    const session = await import_SecureSession.SecureSession.create({
+      manager: this,
+      id: sessionId,
+      fabric,
+      peerNodeId,
+      peerSessionId,
+      sharedSecret,
+      salt,
+      isInitiator,
+      isResumption,
+      peerSessionParameters,
+      caseAuthenticatedTags
+    });
+    const subscriptionsChanged = (subscription) => {
+      if (session.isClosing) {
+        return;
+      }
+      this.#subscriptionsChanged.emit(session, subscription);
+    };
+    session.subscriptions.added.on(subscriptionsChanged);
+    session.subscriptions.deleted.on(subscriptionsChanged);
+    this.#sessions.add(session);
+    return session;
+  }
+  async deleteResumptionRecord(address) {
+    await this.#construction;
+    this.#resumptionRecords.delete(address);
+    await this.#storeResumptionRecords();
+  }
+  async deleteResumptionRecordsForFabric(fabric) {
+    await this.#construction;
+    for (const address of this.#resumptionRecords.keys()) {
+      if (address.fabricIndex === fabric.fabricIndex) {
+        this.#resumptionRecords.delete(address);
+      }
+    }
+    await this.#storeResumptionRecords();
+  }
+  findOldestInactiveSession() {
+    this.#construction.assert();
+    let oldestSession = void 0;
+    for (const session of this.#sessions) {
+      if (!oldestSession || session.activeTimestamp < oldestSession.activeTimestamp) {
+        oldestSession = session;
+      }
+    }
+    if (oldestSession === void 0) {
+      throw new import_general.MatterFlowError("No session found to close and all session ids are taken.");
+    }
+    return oldestSession;
+  }
+  async getNextAvailableSessionId() {
+    await this.#construction;
+    for (let i = 0; i < 65535; i++) {
+      const id = this.#nextSessionId;
+      this.#nextSessionId = this.#nextSessionId + 1 & 65535;
+      if (this.#nextSessionId === 0) this.#nextSessionId++;
+      if (this.getSession(id) === void 0) {
+        return id;
+      }
+    }
+    const oldestSession = this.findOldestInactiveSession();
+    await oldestSession.end(true, false);
+    this.#nextSessionId = oldestSession.id;
+    return this.#nextSessionId++;
+  }
+  getSession(sessionId) {
+    this.#construction.assert();
+    return this.#sessions.get("id", sessionId);
+  }
+  getPaseSession() {
+    this.#construction.assert();
+    return [...this.#sessions].find(
+      (session) => session.isSecure && session.isPase && !session.closingAfterExchangeFinished
+    );
+  }
+  getSessionForNode(address) {
+    this.#construction.assert();
+    return [...this.#sessions].find((session) => {
+      if (!session.isSecure) return false;
+      const secureSession = session;
+      return secureSession.peerIs(address);
+    });
+  }
+  async removeAllSessionsForNode(address, sendClose = false) {
+    await this.#construction;
+    for (const session of this.#sessions) {
+      if (!session.isSecure) continue;
+      const secureSession = session;
+      if (secureSession.peerIs(address)) {
+        await secureSession.destroy(sendClose, false);
+      }
+    }
+  }
+  getUnsecureSession(sourceNodeId) {
+    this.#construction.assert();
+    if (sourceNodeId === void 0) {
+      return this.#insecureSessions.get(import_types.NodeId.UNSPECIFIED_NODE_ID);
+    }
+    return this.#insecureSessions.get(sourceNodeId);
+  }
+  findGroupSession(groupId, groupSessionId) {
+    this.#construction.assert();
+    throw new Error(`Not implemented ${groupId} ${groupSessionId}`);
+  }
+  findResumptionRecordById(resumptionId) {
+    this.#construction.assert();
+    return [...this.#resumptionRecords.values()].find((record) => import_general.Bytes.areEqual(record.resumptionId, resumptionId));
+  }
+  findResumptionRecordByAddress(address) {
+    this.#construction.assert();
+    return this.#resumptionRecords.get(address);
+  }
+  async saveResumptionRecord(resumptionRecord) {
+    await this.#construction;
+    this.#resumptionRecords.set(resumptionRecord.fabric.addressOf(resumptionRecord.peerNodeId), resumptionRecord);
+    await this.#storeResumptionRecords();
+  }
+  async #storeResumptionRecords() {
+    await this.#construction;
+    await this.#context.storage.set(
+      "resumptionRecords",
+      [...this.#resumptionRecords].map(
+        ([
+          address,
+          { sharedSecret, resumptionId, peerNodeId, fabric, sessionParameters, caseAuthenticatedTags }
+        ]) => ({
+          nodeId: address.nodeId,
+          sharedSecret,
+          resumptionId,
+          fabricId: fabric.fabricId,
+          peerNodeId,
+          sessionParameters,
+          caseAuthenticatedTags
+        })
+      )
+    );
+  }
+  async #initialize() {
+    await this.#context.fabrics.construction;
+    const storedResumptionRecords = await this.#context.storage.get(
+      "resumptionRecords",
+      []
+    );
+    storedResumptionRecords.forEach(
+      ({
+        nodeId,
+        sharedSecret,
+        resumptionId,
+        fabricId,
+        peerNodeId,
+        sessionParameters: {
+          idleIntervalMs,
+          activeIntervalMs,
+          activeThresholdMs,
+          dataModelRevision,
+          interactionModelRevision,
+          specificationVersion,
+          maxPathsPerInvoke
+        } = {},
+        caseAuthenticatedTags
+      }) => {
+        const fabric = this.#context.fabrics.getFabrics().find((fabric2) => fabric2.fabricId === fabricId);
+        logger.info(
+          "restoring resumption record for node",
+          nodeId,
+          "and peer node",
+          peerNodeId,
+          "for fabric index",
+          fabric?.fabricIndex
+        );
+        if (!fabric) {
+          logger.error("fabric not found for resumption record", fabricId);
+          return;
+        }
+        this.#resumptionRecords.set(fabric.addressOf(nodeId), {
+          sharedSecret,
+          resumptionId,
+          fabric,
+          peerNodeId,
+          sessionParameters: {
+            // Make sure to initialize default values when restoring an older resumption record
+            idleIntervalMs: idleIntervalMs ?? import_Session.SESSION_IDLE_INTERVAL_MS,
+            activeIntervalMs: activeIntervalMs ?? import_Session.SESSION_ACTIVE_INTERVAL_MS,
+            activeThresholdMs: activeThresholdMs ?? import_Session.SESSION_ACTIVE_THRESHOLD_MS,
+            dataModelRevision: dataModelRevision ?? import_Session.FALLBACK_DATAMODEL_REVISION,
+            interactionModelRevision: interactionModelRevision ?? import_Session.FALLBACK_INTERACTIONMODEL_REVISION,
+            specificationVersion: specificationVersion ?? import_Session.FALLBACK_SPECIFICATION_VERSION,
+            maxPathsPerInvoke: maxPathsPerInvoke ?? import_Session.FALLBACK_MAX_PATHS_PER_INVOKE
+          },
+          caseAuthenticatedTags
+        });
+      }
+    );
+  }
+  getActiveSessionInformation() {
+    this.#construction.assert();
+    return [...this.#sessions].filter((session) => session.isSecure && !session.isPase).map((session) => ({
+      name: session.name,
+      nodeId: session.nodeId,
+      peerNodeId: session.peerNodeId,
+      fabric: session instanceof import_SecureSession.SecureSession ? session.fabric?.externalInformation : void 0,
+      isPeerActive: session.isPeerActive(),
+      secure: session.isSecure,
+      lastInteractionTimestamp: session instanceof import_SecureSession.SecureSession ? session.timestamp : void 0,
+      lastActiveTimestamp: session instanceof import_SecureSession.SecureSession ? session.activeTimestamp : void 0,
+      numberOfActiveSubscriptions: session instanceof import_SecureSession.SecureSession ? session.subscriptions.size : 0
+    }));
+  }
+  async close() {
+    if (this.#construction.status === import_general.Lifecycle.Status.Initializing) {
+      await this.#construction;
+    }
+    await this.#subscriptionUpdateMutex;
+    this.#observers.close();
+    await this.#storeResumptionRecords();
+    for (const session of this.#sessions) {
+      await session?.end(false);
+      this.#sessions.delete(session);
+    }
+    for (const session of this.#insecureSessions.values()) {
+      await session?.end();
+    }
+  }
+  updateAllSubscriptions() {
+    this.#subscriptionUpdateMutex.run(async () => {
+      for (const session of this.#sessions) {
+        for (const subscription of session.subscriptions) {
+          await subscription.update();
+        }
+      }
+    });
+  }
+  async clearSubscriptionsForNode(fabricIndex, nodeId, flushSubscriptions) {
+    for (const session of this.#sessions) {
+      if (session.fabric?.fabricIndex !== fabricIndex) {
+        continue;
+      }
+      if (session.peerNodeId !== nodeId) {
+        continue;
+      }
+      await session.clearSubscriptions(flushSubscriptions);
+    }
+  }
+}
+//# sourceMappingURL=SessionManager.js.map

package/dist/cjs/session/SessionManager.js.map

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

package/dist/cjs/session/case/CaseClient.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SessionManager } from "#session/SessionManager.js";
+import { NodeId } from "#types";
+import { Fabric } from "../../fabric/Fabric.js";
+import { MessageExchange } from "../../protocol/MessageExchange.js";
+export declare class CaseClient {
+    #private;
+    constructor(sessions: SessionManager);
+    pair(exchange: MessageExchange, fabric: Fabric, peerNodeId: NodeId, expectedProcessingTimeMs?: number): Promise<{
+        session: import("../SecureSession.js").SecureSession;
+        resumed: boolean;
+    }>;
+}
+//# sourceMappingURL=CaseClient.d.ts.map

package/dist/cjs/session/case/CaseClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CaseClient.d.ts","sourceRoot":"","sources":["../../../../src/session/case/CaseClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAkBpE,qBAAa,UAAU;;gBAGP,QAAQ,EAAE,cAAc;IAI9B,IAAI,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,wBAAwB,CAAC,EAAE,MAAM;;;;CAsM9G"}