@project-chip/matter.js 0.9.2 → 0.9.4

package/dist/cjs/session/SecureSession.js

@@ -248,7 +248,8 @@ class SecureSession extends import_Session.Session {
     }
   }
   async clearSubscriptions(flushSubscriptions = false) {
-    for (const subscription of this.#subscriptions) {
+    const subscriptions = [...this.#subscriptions];
+    for (const subscription of subscriptions) {
       await subscription.cancel(flushSubscriptions);
     }
     this.#subscriptions.length = 0;

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/session/SecureSession.ts"],
-  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { DecodedMessage, DecodedPacket, Message, MessageCodec, Packet } from \"../codec/MessageCodec.js\";\nimport { MatterFlowError } from \"../common/MatterError.js\";\nimport { CRYPTO_SYMMETRIC_KEY_LENGTH, Crypto } from \"../crypto/Crypto.js\";\nimport { CaseAuthenticatedTag } from \"../datatype/CaseAuthenticatedTag.js\";\nimport { NodeId } from \"../datatype/NodeId.js\";\nimport { Fabric } from \"../fabric/Fabric.js\";\nimport { Diagnostic } from \"../log/Diagnostic.js\";\nimport { Logger } from \"../log/Logger.js\";\nimport { MessageCounter } from \"../protocol/MessageCounter.js\";\nimport { MessageReceptionStateEncryptedWithoutRollover } from \"../protocol/MessageReceptionState.js\";\nimport { StatusCode, StatusResponseError } from \"../protocol/interaction/StatusCode.js\";\nimport { SubscriptionHandler } from \"../protocol/interaction/SubscriptionHandler.js\";\nimport { ByteArray, Endian } from \"../util/ByteArray.js\";\nimport { DataWriter } from \"../util/DataWriter.js\";\nimport { Session, SessionParameterOptions } from \"./Session.js\";\n\nconst logger = Logger.get(\"SecureSession\");\n\nconst SESSION_KEYS_INFO = ByteArray.fromString(\"SessionKeys\");\nconst SESSION_RESUMPTION_KEYS_INFO = ByteArray.fromString(\"SessionResumptionKeys\");\n\nexport class NoAssociatedFabricError extends StatusResponseError {\n    constructor(message: string) {\n        super(message, StatusCode.UnsupportedAccess);\n    }\n}\n\nexport class SecureSession<T> extends Session<T> {\n    readonly #subscriptions = new Array<SubscriptionHandler>();\n    #closingAfterExchangeFinished = false;\n    #sendCloseMessageWhenClosing = true;\n    readonly #context: T;\n    readonly #id: number;\n    #fabric: Fabric | undefined;\n    readonly #peerNodeId: NodeId;\n    readonly #peerSessionId: number;\n    readonly #decryptKey: ByteArray;\n    readonly #encryptKey: ByteArray;\n    readonly #attestationKey: ByteArray;\n    readonly #subscriptionChangedCallback: () => void;\n    #caseAuthenticatedTags: CaseAuthenticatedTag[];\n\n    static async create<T>(args: {\n        context: T;\n        id: number;\n        fabric: Fabric | undefined;\n        peerNodeId: NodeId;\n        peerSessionId: number;\n        sharedSecret: ByteArray;\n        salt: ByteArray;\n        isInitiator: boolean;\n        isResumption: boolean;\n        closeCallback: () => Promise<void>;\n        subscriptionChangedCallback?: () => void;\n        sessionParameters?: SessionParameterOptions;\n        caseAuthenticatedTags?: CaseAuthenticatedTag[];\n    }) {\n        const {\n            context,\n            id,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            sharedSecret,\n            salt,\n            isInitiator,\n            isResumption,\n            closeCallback,\n            sessionParameters,\n            caseAuthenticatedTags,\n            subscriptionChangedCallback,\n        } = args;\n        const keys = await Crypto.hkdf(\n            sharedSecret,\n            salt,\n            isResumption ? SESSION_RESUMPTION_KEYS_INFO : SESSION_KEYS_INFO,\n            CRYPTO_SYMMETRIC_KEY_LENGTH * 3,\n        );\n        const decryptKey = isInitiator ? keys.slice(16, 32) : keys.slice(0, 16);\n        const encryptKey = isInitiator ? keys.slice(0, 16) : keys.slice(16, 32);\n        const attestationKey = keys.slice(32, 48);\n        return new SecureSession({\n            context,\n            id,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            decryptKey,\n            encryptKey,\n            attestationKey,\n            closeCallback,\n            subscriptionChangedCallback,\n            sessionParameters,\n            isInitiator,\n            caseAuthenticatedTags,\n        });\n    }\n\n    constructor(args: {\n        context: T;\n        id: number;\n        fabric: Fabric | undefined;\n        peerNodeId: NodeId;\n        peerSessionId: number;\n        decryptKey: ByteArray;\n        encryptKey: ByteArray;\n        attestationKey: ByteArray;\n        closeCallback: () => Promise<void>;\n        subscriptionChangedCallback?: () => void;\n        sessionParameters?: SessionParameterOptions;\n        caseAuthenticatedTags?: CaseAuthenticatedTag[];\n        isInitiator: boolean;\n    }) {\n        super({\n            ...args,\n            setActiveTimestamp: true, // We always set the active timestamp for Secure sessions\n            // Can be changed to a PersistedMessageCounter if we implement session storage\n            messageCounter: new MessageCounter(() => {\n                // Secure Session Message Counter\n                // Expire/End the session before the counter rolls over\n                this.end(true, true).catch(error => logger.error(`Error while closing session: ${error}`));\n            }),\n            messageReceptionState: new MessageReceptionStateEncryptedWithoutRollover(),\n        });\n        const {\n            context,\n            id,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            decryptKey,\n            encryptKey,\n            attestationKey,\n            subscriptionChangedCallback = () => {},\n            caseAuthenticatedTags,\n        } = args;\n\n        this.#context = context;\n        this.#id = id;\n        this.#fabric = fabric;\n        this.#peerNodeId = peerNodeId;\n        this.#peerSessionId = peerSessionId;\n        this.#decryptKey = decryptKey;\n        this.#encryptKey = encryptKey;\n        this.#attestationKey = attestationKey;\n        this.#subscriptionChangedCallback = subscriptionChangedCallback;\n        this.#caseAuthenticatedTags = caseAuthenticatedTags ?? fabric?.caseAuthenticatedTags ?? [];\n\n        fabric?.addSession(this);\n\n        logger.debug(\n            `Created secure ${this.isPase ? \"PASE\" : \"CASE\"} session for fabric index ${fabric?.fabricIndex}`,\n            this.name,\n            Diagnostic.dict({\n                idleIntervalMs: this.idleIntervalMs,\n                activeIntervalMs: this.activeIntervalMs,\n                activeThresholdMs: this.activeThresholdMs,\n            }),\n        );\n    }\n\n    get caseAuthenticatedTags() {\n        return this.#caseAuthenticatedTags;\n    }\n\n    get closingAfterExchangeFinished() {\n        return this.#closingAfterExchangeFinished;\n    }\n\n    get sendCloseMessageWhenClosing() {\n        return this.#sendCloseMessageWhenClosing;\n    }\n\n    get isSecure(): boolean {\n        return true;\n    }\n\n    get isPase(): boolean {\n        return this.#peerNodeId === NodeId.UNSPECIFIED_NODE_ID;\n    }\n\n    async close(closeAfterExchangeFinished?: boolean) {\n        if (closeAfterExchangeFinished === undefined) {\n            closeAfterExchangeFinished = this.isPeerActive(); // We delay session close if the peer is actively communicating with us\n        }\n        await this.end(true, closeAfterExchangeFinished);\n    }\n\n    decode({ header, applicationPayload, messageExtension }: DecodedPacket, aad: ByteArray): DecodedMessage {\n        if (header.hasMessageExtensions) {\n            logger.info(`Message extensions are not supported. Ignoring ${messageExtension?.toHex()}`);\n        }\n        const nonce = this.generateNonce(header.securityFlags, header.messageId, this.#peerNodeId);\n        const message = MessageCodec.decodePayload({\n            header,\n            applicationPayload: Crypto.decrypt(this.#decryptKey, applicationPayload, nonce, aad),\n        });\n\n        if (message.payloadHeader.hasSecuredExtension) {\n            logger.info(`Secured extensions are not supported. Ignoring ${message.securityExtension?.toHex()}`);\n        }\n\n        return message;\n    }\n\n    encode(message: Message): Packet {\n        message.packetHeader.sessionId = this.#peerSessionId;\n        const { header, applicationPayload } = MessageCodec.encodePayload(message);\n        const headerBytes = MessageCodec.encodePacketHeader(message.packetHeader);\n        const securityFlags = headerBytes[3];\n        const sessionNodeId = this.isPase\n            ? NodeId.UNSPECIFIED_NODE_ID\n            : this.#fabric?.nodeId ?? NodeId.UNSPECIFIED_NODE_ID;\n        const nonce = this.generateNonce(securityFlags, header.messageId, sessionNodeId);\n        return { header, applicationPayload: Crypto.encrypt(this.#encryptKey, applicationPayload, nonce, headerBytes) };\n    }\n\n    getAttestationChallengeKey(): ByteArray {\n        return this.#attestationKey;\n    }\n\n    get fabric() {\n        return this.#fabric;\n    }\n\n    addAssociatedFabric(fabric: Fabric) {\n        if (this.#fabric !== undefined) {\n            throw new MatterFlowError(\"Session already has an associated Fabric. Cannot change this.\");\n        }\n        this.#fabric = fabric;\n        this.#caseAuthenticatedTags = fabric.caseAuthenticatedTags;\n    }\n\n    get id() {\n        return this.#id;\n    }\n\n    get name() {\n        return `secure/${this.#id}`;\n    }\n\n    get context() {\n        return this.#context;\n    }\n\n    get peerSessionId(): number {\n        return this.#peerSessionId;\n    }\n\n    get nodeId() {\n        return this.#fabric?.nodeId ?? NodeId.UNSPECIFIED_NODE_ID;\n    }\n\n    get peerNodeId() {\n        return this.#peerNodeId;\n    }\n\n    get numberOfActiveSubscriptions() {\n        return this.#subscriptions.length;\n    }\n\n    get associatedFabric(): Fabric {\n        if (this.#fabric === undefined) {\n            throw new NoAssociatedFabricError(\n                `${this.isPase ? \"PASE \" : \"\"}Session needs to have an associated Fabric for fabric sensitive data handling.`,\n            );\n        }\n        return this.#fabric;\n    }\n\n    addSubscription(subscription: SubscriptionHandler) {\n        this.#subscriptions.push(subscription);\n        logger.debug(`Added subscription ${subscription.subscriptionId} to ${this.name}`);\n        this.#subscriptionChangedCallback();\n    }\n\n    removeSubscription(subscriptionId: number) {\n        const index = this.#subscriptions.findIndex(subscription => subscription.subscriptionId === subscriptionId);\n        if (index !== -1) {\n            this.#subscriptions.splice(index, 1);\n            logger.debug(`Removed subscription ${subscriptionId} from ${this.name}`);\n            this.#subscriptionChangedCallback();\n        }\n    }\n\n    async clearSubscriptions(flushSubscriptions = false) {\n        for (const subscription of this.#subscriptions) {\n            await subscription.cancel(flushSubscriptions);\n        }\n        this.#subscriptions.length = 0;\n    }\n\n    /** Ends a session. Outstanding subscription data will be flushed before the session is destroyed. */\n    async end(sendClose: boolean, closeAfterExchangeFinished = false) {\n        await this.clearSubscriptions(true);\n        await this.destroy(sendClose, closeAfterExchangeFinished);\n    }\n\n    /** Destroys a session. Outstanding subscription data will be discarded. */\n    async destroy(sendClose = false, closeAfterExchangeFinished = true) {\n        await this.clearSubscriptions(false);\n        this.#fabric?.removeSession(this);\n        if (!sendClose) {\n            this.#sendCloseMessageWhenClosing = false;\n        }\n\n        if (closeAfterExchangeFinished) {\n            logger.info(`Register Session ${this.name} to send a close when exchange is ended.`);\n            this.#closingAfterExchangeFinished = true;\n        } else {\n            await this.closeCallback();\n        }\n    }\n\n    private generateNonce(securityFlags: number, messageId: number, nodeId: NodeId) {\n        const writer = new DataWriter(Endian.Little);\n        writer.writeUInt8(securityFlags);\n        writer.writeUInt32(messageId);\n        writer.writeUInt64(nodeId);\n        return writer.toByteArray();\n    }\n}\n\nexport function assertSecureSession<T>(session: Session<T>, errorText?: string): asserts session is SecureSession<T> {\n    if (!session.isSecure) {\n        throw new MatterFlowError(errorText ?? \"Insecure session in secure context\");\n    }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { DecodedMessage, DecodedPacket, Message, MessageCodec, Packet } from \"../codec/MessageCodec.js\";\nimport { MatterFlowError } from \"../common/MatterError.js\";\nimport { CRYPTO_SYMMETRIC_KEY_LENGTH, Crypto } from \"../crypto/Crypto.js\";\nimport { CaseAuthenticatedTag } from \"../datatype/CaseAuthenticatedTag.js\";\nimport { NodeId } from \"../datatype/NodeId.js\";\nimport { Fabric } from \"../fabric/Fabric.js\";\nimport { Diagnostic } from \"../log/Diagnostic.js\";\nimport { Logger } from \"../log/Logger.js\";\nimport { MessageCounter } from \"../protocol/MessageCounter.js\";\nimport { MessageReceptionStateEncryptedWithoutRollover } from \"../protocol/MessageReceptionState.js\";\nimport { StatusCode, StatusResponseError } from \"../protocol/interaction/StatusCode.js\";\nimport { SubscriptionHandler } from \"../protocol/interaction/SubscriptionHandler.js\";\nimport { ByteArray, Endian } from \"../util/ByteArray.js\";\nimport { DataWriter } from \"../util/DataWriter.js\";\nimport { Session, SessionParameterOptions } from \"./Session.js\";\n\nconst logger = Logger.get(\"SecureSession\");\n\nconst SESSION_KEYS_INFO = ByteArray.fromString(\"SessionKeys\");\nconst SESSION_RESUMPTION_KEYS_INFO = ByteArray.fromString(\"SessionResumptionKeys\");\n\nexport class NoAssociatedFabricError extends StatusResponseError {\n    constructor(message: string) {\n        super(message, StatusCode.UnsupportedAccess);\n    }\n}\n\nexport class SecureSession<T> extends Session<T> {\n    readonly #subscriptions = new Array<SubscriptionHandler>();\n    #closingAfterExchangeFinished = false;\n    #sendCloseMessageWhenClosing = true;\n    readonly #context: T;\n    readonly #id: number;\n    #fabric: Fabric | undefined;\n    readonly #peerNodeId: NodeId;\n    readonly #peerSessionId: number;\n    readonly #decryptKey: ByteArray;\n    readonly #encryptKey: ByteArray;\n    readonly #attestationKey: ByteArray;\n    readonly #subscriptionChangedCallback: () => void;\n    #caseAuthenticatedTags: CaseAuthenticatedTag[];\n\n    static async create<T>(args: {\n        context: T;\n        id: number;\n        fabric: Fabric | undefined;\n        peerNodeId: NodeId;\n        peerSessionId: number;\n        sharedSecret: ByteArray;\n        salt: ByteArray;\n        isInitiator: boolean;\n        isResumption: boolean;\n        closeCallback: () => Promise<void>;\n        subscriptionChangedCallback?: () => void;\n        sessionParameters?: SessionParameterOptions;\n        caseAuthenticatedTags?: CaseAuthenticatedTag[];\n    }) {\n        const {\n            context,\n            id,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            sharedSecret,\n            salt,\n            isInitiator,\n            isResumption,\n            closeCallback,\n            sessionParameters,\n            caseAuthenticatedTags,\n            subscriptionChangedCallback,\n        } = args;\n        const keys = await Crypto.hkdf(\n            sharedSecret,\n            salt,\n            isResumption ? SESSION_RESUMPTION_KEYS_INFO : SESSION_KEYS_INFO,\n            CRYPTO_SYMMETRIC_KEY_LENGTH * 3,\n        );\n        const decryptKey = isInitiator ? keys.slice(16, 32) : keys.slice(0, 16);\n        const encryptKey = isInitiator ? keys.slice(0, 16) : keys.slice(16, 32);\n        const attestationKey = keys.slice(32, 48);\n        return new SecureSession({\n            context,\n            id,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            decryptKey,\n            encryptKey,\n            attestationKey,\n            closeCallback,\n            subscriptionChangedCallback,\n            sessionParameters,\n            isInitiator,\n            caseAuthenticatedTags,\n        });\n    }\n\n    constructor(args: {\n        context: T;\n        id: number;\n        fabric: Fabric | undefined;\n        peerNodeId: NodeId;\n        peerSessionId: number;\n        decryptKey: ByteArray;\n        encryptKey: ByteArray;\n        attestationKey: ByteArray;\n        closeCallback: () => Promise<void>;\n        subscriptionChangedCallback?: () => void;\n        sessionParameters?: SessionParameterOptions;\n        caseAuthenticatedTags?: CaseAuthenticatedTag[];\n        isInitiator: boolean;\n    }) {\n        super({\n            ...args,\n            setActiveTimestamp: true, // We always set the active timestamp for Secure sessions\n            // Can be changed to a PersistedMessageCounter if we implement session storage\n            messageCounter: new MessageCounter(() => {\n                // Secure Session Message Counter\n                // Expire/End the session before the counter rolls over\n                this.end(true, true).catch(error => logger.error(`Error while closing session: ${error}`));\n            }),\n            messageReceptionState: new MessageReceptionStateEncryptedWithoutRollover(),\n        });\n        const {\n            context,\n            id,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            decryptKey,\n            encryptKey,\n            attestationKey,\n            subscriptionChangedCallback = () => {},\n            caseAuthenticatedTags,\n        } = args;\n\n        this.#context = context;\n        this.#id = id;\n        this.#fabric = fabric;\n        this.#peerNodeId = peerNodeId;\n        this.#peerSessionId = peerSessionId;\n        this.#decryptKey = decryptKey;\n        this.#encryptKey = encryptKey;\n        this.#attestationKey = attestationKey;\n        this.#subscriptionChangedCallback = subscriptionChangedCallback;\n        this.#caseAuthenticatedTags = caseAuthenticatedTags ?? fabric?.caseAuthenticatedTags ?? [];\n\n        fabric?.addSession(this);\n\n        logger.debug(\n            `Created secure ${this.isPase ? \"PASE\" : \"CASE\"} session for fabric index ${fabric?.fabricIndex}`,\n            this.name,\n            Diagnostic.dict({\n                idleIntervalMs: this.idleIntervalMs,\n                activeIntervalMs: this.activeIntervalMs,\n                activeThresholdMs: this.activeThresholdMs,\n            }),\n        );\n    }\n\n    get caseAuthenticatedTags() {\n        return this.#caseAuthenticatedTags;\n    }\n\n    get closingAfterExchangeFinished() {\n        return this.#closingAfterExchangeFinished;\n    }\n\n    get sendCloseMessageWhenClosing() {\n        return this.#sendCloseMessageWhenClosing;\n    }\n\n    get isSecure(): boolean {\n        return true;\n    }\n\n    get isPase(): boolean {\n        return this.#peerNodeId === NodeId.UNSPECIFIED_NODE_ID;\n    }\n\n    async close(closeAfterExchangeFinished?: boolean) {\n        if (closeAfterExchangeFinished === undefined) {\n            closeAfterExchangeFinished = this.isPeerActive(); // We delay session close if the peer is actively communicating with us\n        }\n        await this.end(true, closeAfterExchangeFinished);\n    }\n\n    decode({ header, applicationPayload, messageExtension }: DecodedPacket, aad: ByteArray): DecodedMessage {\n        if (header.hasMessageExtensions) {\n            logger.info(`Message extensions are not supported. Ignoring ${messageExtension?.toHex()}`);\n        }\n        const nonce = this.generateNonce(header.securityFlags, header.messageId, this.#peerNodeId);\n        const message = MessageCodec.decodePayload({\n            header,\n            applicationPayload: Crypto.decrypt(this.#decryptKey, applicationPayload, nonce, aad),\n        });\n\n        if (message.payloadHeader.hasSecuredExtension) {\n            logger.info(`Secured extensions are not supported. Ignoring ${message.securityExtension?.toHex()}`);\n        }\n\n        return message;\n    }\n\n    encode(message: Message): Packet {\n        message.packetHeader.sessionId = this.#peerSessionId;\n        const { header, applicationPayload } = MessageCodec.encodePayload(message);\n        const headerBytes = MessageCodec.encodePacketHeader(message.packetHeader);\n        const securityFlags = headerBytes[3];\n        const sessionNodeId = this.isPase\n            ? NodeId.UNSPECIFIED_NODE_ID\n            : this.#fabric?.nodeId ?? NodeId.UNSPECIFIED_NODE_ID;\n        const nonce = this.generateNonce(securityFlags, header.messageId, sessionNodeId);\n        return { header, applicationPayload: Crypto.encrypt(this.#encryptKey, applicationPayload, nonce, headerBytes) };\n    }\n\n    getAttestationChallengeKey(): ByteArray {\n        return this.#attestationKey;\n    }\n\n    get fabric() {\n        return this.#fabric;\n    }\n\n    addAssociatedFabric(fabric: Fabric) {\n        if (this.#fabric !== undefined) {\n            throw new MatterFlowError(\"Session already has an associated Fabric. Cannot change this.\");\n        }\n        this.#fabric = fabric;\n        this.#caseAuthenticatedTags = fabric.caseAuthenticatedTags;\n    }\n\n    get id() {\n        return this.#id;\n    }\n\n    get name() {\n        return `secure/${this.#id}`;\n    }\n\n    get context() {\n        return this.#context;\n    }\n\n    get peerSessionId(): number {\n        return this.#peerSessionId;\n    }\n\n    get nodeId() {\n        return this.#fabric?.nodeId ?? NodeId.UNSPECIFIED_NODE_ID;\n    }\n\n    get peerNodeId() {\n        return this.#peerNodeId;\n    }\n\n    get numberOfActiveSubscriptions() {\n        return this.#subscriptions.length;\n    }\n\n    get associatedFabric(): Fabric {\n        if (this.#fabric === undefined) {\n            throw new NoAssociatedFabricError(\n                `${this.isPase ? \"PASE \" : \"\"}Session needs to have an associated Fabric for fabric sensitive data handling.`,\n            );\n        }\n        return this.#fabric;\n    }\n\n    addSubscription(subscription: SubscriptionHandler) {\n        this.#subscriptions.push(subscription);\n        logger.debug(`Added subscription ${subscription.subscriptionId} to ${this.name}`);\n        this.#subscriptionChangedCallback();\n    }\n\n    removeSubscription(subscriptionId: number) {\n        const index = this.#subscriptions.findIndex(subscription => subscription.subscriptionId === subscriptionId);\n        if (index !== -1) {\n            this.#subscriptions.splice(index, 1);\n            logger.debug(`Removed subscription ${subscriptionId} from ${this.name}`);\n            this.#subscriptionChangedCallback();\n        }\n    }\n\n    async clearSubscriptions(flushSubscriptions = false) {\n        const subscriptions = [...this.#subscriptions]; // get all values because subscriptions will remove themselves when cancelled\n        for (const subscription of subscriptions) {\n            await subscription.cancel(flushSubscriptions);\n        }\n        this.#subscriptions.length = 0;\n    }\n\n    /** Ends a session. Outstanding subscription data will be flushed before the session is destroyed. */\n    async end(sendClose: boolean, closeAfterExchangeFinished = false) {\n        await this.clearSubscriptions(true);\n        await this.destroy(sendClose, closeAfterExchangeFinished);\n    }\n\n    /** Destroys a session. Outstanding subscription data will be discarded. */\n    async destroy(sendClose = false, closeAfterExchangeFinished = true) {\n        await this.clearSubscriptions(false);\n        this.#fabric?.removeSession(this);\n        if (!sendClose) {\n            this.#sendCloseMessageWhenClosing = false;\n        }\n\n        if (closeAfterExchangeFinished) {\n            logger.info(`Register Session ${this.name} to send a close when exchange is ended.`);\n            this.#closingAfterExchangeFinished = true;\n        } else {\n            await this.closeCallback();\n        }\n    }\n\n    private generateNonce(securityFlags: number, messageId: number, nodeId: NodeId) {\n        const writer = new DataWriter(Endian.Little);\n        writer.writeUInt8(securityFlags);\n        writer.writeUInt32(messageId);\n        writer.writeUInt64(nodeId);\n        return writer.toByteArray();\n    }\n}\n\nexport function assertSecureSession<T>(session: Session<T>, errorText?: string): asserts session is SecureSession<T> {\n    if (!session.isSecure) {\n        throw new MatterFlowError(errorText ?? \"Insecure session in secure context\");\n    }\n}\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -4,6 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { CaseAuthenticatedTag } from "../datatype/CaseAuthenticatedTag.js";
+import { FabricIndex } from "../datatype/FabricIndex.js";
 import { NodeId } from "../datatype/NodeId.js";
 import { Fabric } from "../fabric/Fabric.js";
 import { StorageContext } from "../storage/StorageContext.js";
@@ -72,6 +73,7 @@ export declare class SessionManager<ContextT> {
         lastActiveTimestamp: number | undefined;
         numberOfActiveSubscriptions: number;
     }[];
+    clearSubscriptionsForNode(fabricIndex: FabricIndex, nodeId: NodeId, flushSubscriptions?: boolean): Promise<void>;
     close(): Promise<void>;
 }
 //# sourceMappingURL=SessionManager.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../../src/session/SessionManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAI1E,eAAO,MAAM,2BAA2B,IAAS,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC7B,YAAY,EAAE,SAAS,CAAC;IACxB,YAAY,EAAE,SAAS,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAClD;AAgBD,qBAAa,cAAc,CAAC,QAAQ;;IAY5B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,QAAQ,EAClC,cAAc,EAAE,cAAc;IAKlC,IAAI,oBAAoB,yDAEvB;IAED,IAAI,aAAa,yDAEhB;IAED,IAAI,aAAa,8DAEhB;IAED,qBAAqB,CAAC,OAAO,EAAE;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;QAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;KACzB;IA4BK,mBAAmB,CAAC,IAAI,EAAE;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,SAAS,CAAC;QACxB,IAAI,EAAE,SAAS,CAAC;QAChB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;QAC5C,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;KAClD;IA0CD,aAAa,CAAC,SAAS,EAAE,MAAM;IAOzB,sBAAsB,CAAC,UAAU,EAAE,MAAM;IAK/C,yBAAyB;IAanB,yBAAyB;IAkB/B,UAAU,CAAC,SAAS,EAAE,MAAM;IAI5B,cAAc;IAMd,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAS1C,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,UAAQ;IAUhE,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM;IAOxC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IASxD,wBAAwB,CAAC,YAAY,EAAE,SAAS;IAIhD,4BAA4B,CAAC,MAAM,EAAE,MAAM;IAIrC,oBAAoB,CAAC,gBAAgB,EAAE,gBAAgB;IAKvD,gCAAgC,CAAC,MAAM,EAAE,MAAM;IAS/C,sBAAsB;IAqBtB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE;IAkCvC,2BAA2B;;;;;;;;;;;IAgBrB,KAAK;CAWd"}
+{"version":3,"file":"SessionManager.d.ts","sourceRoot":"","sources":["../../../src/session/SessionManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAG7C,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAI1E,eAAO,MAAM,2BAA2B,IAAS,CAAC;AAElD,MAAM,WAAW,gBAAgB;IAC7B,YAAY,EAAE,SAAS,CAAC;IACxB,YAAY,EAAE,SAAS,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;CAClD;AAgBD,qBAAa,cAAc,CAAC,QAAQ;;IAY5B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,QAAQ,EAClC,cAAc,EAAE,cAAc;IAKlC,IAAI,oBAAoB,yDAEvB;IAED,IAAI,aAAa,yDAEhB;IAED,IAAI,aAAa,8DAEhB;IAED,qBAAqB,CAAC,OAAO,EAAE;QAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;QAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;KACzB;IA4BK,mBAAmB,CAAC,IAAI,EAAE;QAC5B,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,SAAS,CAAC;QACxB,IAAI,EAAE,SAAS,CAAC;QAChB,WAAW,EAAE,OAAO,CAAC;QACrB,YAAY,EAAE,OAAO,CAAC;QACtB,iBAAiB,CAAC,EAAE,uBAAuB,CAAC;QAC5C,qBAAqB,CAAC,EAAE,oBAAoB,EAAE,CAAC;KAClD;IA0CD,aAAa,CAAC,SAAS,EAAE,MAAM;IAOzB,sBAAsB,CAAC,UAAU,EAAE,MAAM;IAK/C,yBAAyB;IAanB,yBAAyB;IAkB/B,UAAU,CAAC,SAAS,EAAE,MAAM;IAI5B,cAAc;IAMd,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAS1C,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,UAAQ;IAUhE,kBAAkB,CAAC,YAAY,CAAC,EAAE,MAAM;IAOxC,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM;IASxD,wBAAwB,CAAC,YAAY,EAAE,SAAS;IAIhD,4BAA4B,CAAC,MAAM,EAAE,MAAM;IAIrC,oBAAoB,CAAC,gBAAgB,EAAE,gBAAgB;IAKvD,gCAAgC,CAAC,MAAM,EAAE,MAAM;IAS/C,sBAAsB;IAqBtB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE;IAkCvC,2BAA2B;;;;;;;;;;;IAgBrB,yBAAyB,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,kBAAkB,CAAC,EAAE,OAAO;IAQhG,KAAK;CAWd"}

package/dist/cjs/session/SessionManager.js

@@ -275,6 +275,13 @@ class SessionManager {
       numberOfActiveSubscriptions: session instanceof import_SecureSession.SecureSession ? session.numberOfActiveSubscriptions : 0
     }));
   }
+  async clearSubscriptionsForNode(fabricIndex, nodeId, flushSubscriptions) {
+    for (const session of this.#sessions) {
+      if (session.fabric?.fabricIndex === fabricIndex && session.peerNodeId === nodeId) {
+        await session.clearSubscriptions(flushSubscriptions);
+      }
+    }
+  }
   async close() {
     await this.storeResumptionRecords();
     for (const session of this.#sessions) {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/session/SessionManager.ts"],
-  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { MatterFlowError } from \"../common/MatterError.js\";\nimport { Crypto } from \"../crypto/Crypto.js\";\nimport { CaseAuthenticatedTag } from \"../datatype/CaseAuthenticatedTag.js\";\nimport { FabricId } from \"../datatype/FabricId.js\";\nimport { NodeId } from \"../datatype/NodeId.js\";\nimport { Fabric } from \"../fabric/Fabric.js\";\nimport { Logger } from \"../log/Logger.js\";\nimport { MessageCounter } from \"../protocol/MessageCounter.js\";\nimport { StorageContext } from \"../storage/StorageContext.js\";\nimport { ByteArray } from \"../util/ByteArray.js\";\nimport { AsyncObservable, Observable } from \"../util/Observable.js\";\nimport { BasicSet } from \"../util/Set.js\";\nimport { InsecureSession } from \"./InsecureSession.js\";\nimport { SecureSession } from \"./SecureSession.js\";\nimport { SessionParameterOptions, SessionParameters } from \"./Session.js\";\n\nconst logger = Logger.get(\"SessionManager\");\n\nexport const UNICAST_UNSECURE_SESSION_ID = 0x0000;\n\nexport interface ResumptionRecord {\n    sharedSecret: ByteArray;\n    resumptionId: ByteArray;\n    fabric: Fabric;\n    peerNodeId: NodeId;\n    sessionParameters: SessionParameters;\n    caseAuthenticatedTags?: CaseAuthenticatedTag[];\n}\n\ntype ResumptionStorageRecord = {\n    nodeId: NodeId;\n    sharedSecret: Uint8Array;\n    resumptionId: Uint8Array;\n    fabricId: FabricId;\n    peerNodeId: NodeId;\n    sessionParameters: {\n        idleIntervalMs: number;\n        activeIntervalMs: number;\n        activeThresholdMs: number;\n    };\n    caseAuthenticatedTags?: CaseAuthenticatedTag[];\n};\n\nexport class SessionManager<ContextT> {\n    readonly #insecureSessions = new Map<NodeId, InsecureSession<ContextT>>();\n    readonly #sessions = new BasicSet<SecureSession<ContextT>>();\n    #nextSessionId = Crypto.getRandomUInt16();\n    #resumptionRecords = new Map<NodeId, ResumptionRecord>();\n    readonly #sessionStorage: StorageContext;\n    readonly #globalUnencryptedMessageCounter = new MessageCounter();\n    readonly #subscriptionsChanged = new Observable<[session: SecureSession<ContextT>]>();\n    readonly #sessionOpened = new Observable<[session: SecureSession<ContextT>]>();\n    readonly #sessionClosed = new AsyncObservable<[session: SecureSession<ContextT>], void>();\n\n    constructor(\n        private readonly context: ContextT,\n        sessionStorage: StorageContext,\n    ) {\n        this.#sessionStorage = sessionStorage;\n    }\n\n    get subscriptionsChanged() {\n        return this.#subscriptionsChanged;\n    }\n\n    get sessionOpened() {\n        return this.#sessionOpened;\n    }\n\n    get sessionClosed() {\n        return this.#sessionClosed;\n    }\n\n    createUnsecureSession(options: {\n        initiatorNodeId?: NodeId;\n        sessionParameters?: SessionParameterOptions;\n        isInitiator?: boolean;\n    }) {\n        const { initiatorNodeId, sessionParameters, isInitiator } = options;\n        if (initiatorNodeId !== undefined) {\n            if (this.#insecureSessions.has(initiatorNodeId)) {\n                throw new MatterFlowError(`UnsecureSession with NodeId ${initiatorNodeId} already exists.`);\n            }\n        }\n        while (true) {\n            const session = new InsecureSession({\n                context: this.context,\n                messageCounter: this.#globalUnencryptedMessageCounter,\n                closeCallback: async () => {\n                    logger.info(`End insecure session ${session.name}`);\n                    this.#insecureSessions.delete(session.nodeId);\n                },\n                initiatorNodeId,\n                sessionParameters,\n                isInitiator: isInitiator ?? false,\n            });\n\n            const ephermalNodeId = session.nodeId;\n            if (this.#insecureSessions.has(ephermalNodeId)) continue;\n\n            this.#insecureSessions.set(ephermalNodeId, session);\n            return session;\n        }\n    }\n\n    async createSecureSession(args: {\n        sessionId: number;\n        fabric: Fabric | undefined;\n        peerNodeId: NodeId;\n        peerSessionId: number;\n        sharedSecret: ByteArray;\n        salt: ByteArray;\n        isInitiator: boolean;\n        isResumption: boolean;\n        sessionParameters?: SessionParameterOptions;\n        caseAuthenticatedTags?: CaseAuthenticatedTag[];\n    }) {\n        const {\n            sessionId,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            sharedSecret,\n            salt,\n            isInitiator,\n            isResumption,\n            sessionParameters,\n            caseAuthenticatedTags,\n        } = args;\n        const session = await SecureSession.create({\n            context: this.context,\n            id: sessionId,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            sharedSecret,\n            salt,\n            isInitiator,\n            isResumption,\n            closeCallback: async () => {\n                logger.info(`End ${session.isPase ? \"PASE\" : \"CASE\"} session ${session.name}`);\n                this.#sessions.delete(session);\n                await this.#sessionClosed.emit(session);\n            },\n            sessionParameters,\n            caseAuthenticatedTags,\n            subscriptionChangedCallback: () => {\n                this.#subscriptionsChanged.emit(session);\n            },\n        });\n\n        this.#sessions.add(session);\n        this.#sessionOpened.emit(session);\n\n        // TODO: Add a maximum of sessions and respect/close the \"least recently used\" session. See Core Specs 4.10.1.1\n        return session;\n    }\n\n    removeSession(sessionId: number) {\n        const session = this.getSession(sessionId);\n        if (session !== undefined) {\n            this.#sessions.delete(session);\n        }\n    }\n\n    async removeResumptionRecord(peerNodeId: NodeId) {\n        this.#resumptionRecords.delete(peerNodeId);\n        await this.storeResumptionRecords();\n    }\n\n    findOldestInactiveSession() {\n        let oldestSession: SecureSession<ContextT> | undefined = undefined;\n        for (const session of this.#sessions) {\n            if (!oldestSession || session.activeTimestamp < oldestSession.activeTimestamp) {\n                oldestSession = session;\n            }\n        }\n        if (oldestSession === undefined) {\n            throw new MatterFlowError(\"No session found to close and all session ids are taken.\");\n        }\n        return oldestSession;\n    }\n\n    async getNextAvailableSessionId() {\n        for (let i = 0; i < 0xffff; i++) {\n            const id = this.#nextSessionId;\n            this.#nextSessionId = (this.#nextSessionId + 1) & 0xffff;\n            if (this.#nextSessionId === 0) this.#nextSessionId++;\n\n            if (this.getSession(id) === undefined) {\n                return id;\n            }\n        }\n\n        // All session ids are taken, search for the oldest unused session, and close it and re-use its ID\n        const oldestSession = this.findOldestInactiveSession();\n        await oldestSession.end(true, false);\n        this.#nextSessionId = oldestSession.id;\n        return this.#nextSessionId++;\n    }\n\n    getSession(sessionId: number) {\n        return this.#sessions.get(\"id\", sessionId);\n    }\n\n    getPaseSession() {\n        return [...this.#sessions].find(\n            session => session.isSecure && session.isPase && !session.closingAfterExchangeFinished,\n        ) as SecureSession<ContextT>;\n    }\n\n    getSessionForNode(fabric: Fabric, nodeId: NodeId) {\n        //TODO: It can have multiple sessions for one node ...\n        return [...this.#sessions].find(session => {\n            if (!session.isSecure) return false;\n            const secureSession = session as SecureSession<any>;\n            return secureSession.fabric?.fabricId === fabric.fabricId && secureSession.peerNodeId === nodeId;\n        });\n    }\n\n    async removeAllSessionsForNode(nodeId: NodeId, sendClose = false) {\n        for (const session of this.#sessions) {\n            if (!session.isSecure) continue;\n            const secureSession = session as SecureSession<any>;\n            if (secureSession.peerNodeId === nodeId) {\n                await secureSession.destroy(sendClose, false);\n            }\n        }\n    }\n\n    getUnsecureSession(sourceNodeId?: NodeId) {\n        if (sourceNodeId === undefined) {\n            return this.#insecureSessions.get(NodeId.UNSPECIFIED_NODE_ID);\n        }\n        return this.#insecureSessions.get(sourceNodeId);\n    }\n\n    findGroupSession(groupId: number, groupSessionId: number) {\n        // Use groupsession id to find the key ??!!\n        // The Group Session ID MAY help receiving nodes efficiently locate the Operational Group Key used to encrypt an incoming groupcast message. It SHALL NOT be used as the sole means to locate the asso\u00AD ciated Operational Group Key, since it MAY collide within the fabric. Instead, the Group Session ID provides receiving nodes a means to identify Operational Group Key candidates without the need to first attempt to decrypt groupcast messages using all available keys.\n        // On receipt of a message of Group Session Type, all valid, installed, operational group key candidates referenced by the given Group Session ID SHALL be attempted until authentication is passed or there are no more operational group keys to try. This is done because the same Group Session ID might arise from different keys. The chance of a Group Session ID collision is 2-16 but the chance of both a Group Session ID collision and the message MIC matching two different operational group keys is 2-80.\n\n        // TODO\n        throw new Error(`Not implemented ${groupId} ${groupSessionId}`);\n    }\n\n    findResumptionRecordById(resumptionId: ByteArray) {\n        return [...this.#resumptionRecords.values()].find(record => record.resumptionId.equals(resumptionId));\n    }\n\n    findResumptionRecordByNodeId(nodeId: NodeId) {\n        return this.#resumptionRecords.get(nodeId);\n    }\n\n    async saveResumptionRecord(resumptionRecord: ResumptionRecord) {\n        this.#resumptionRecords.set(resumptionRecord.peerNodeId, resumptionRecord);\n        await this.storeResumptionRecords();\n    }\n\n    async updateFabricForResumptionRecords(fabric: Fabric) {\n        const record = this.#resumptionRecords.get(fabric.rootNodeId);\n        if (record === undefined) {\n            throw new MatterFlowError(\"Resumption record not found. Should never happen.\");\n        }\n        this.#resumptionRecords.set(fabric.rootNodeId, { ...record, fabric });\n        await this.storeResumptionRecords();\n    }\n\n    async storeResumptionRecords() {\n        await this.#sessionStorage.set(\n            \"resumptionRecords\",\n            [...this.#resumptionRecords].map(\n                ([\n                    nodeId,\n                    { sharedSecret, resumptionId, peerNodeId, fabric, sessionParameters, caseAuthenticatedTags },\n                ]) =>\n                    ({\n                        nodeId,\n                        sharedSecret,\n                        resumptionId,\n                        fabricId: fabric.fabricId,\n                        peerNodeId: peerNodeId,\n                        sessionParameters,\n                        caseAuthenticatedTags,\n                    }) as ResumptionStorageRecord,\n            ),\n        );\n    }\n\n    async initFromStorage(fabrics: Fabric[]) {\n        const storedResumptionRecords = await this.#sessionStorage.get<ResumptionStorageRecord[]>(\n            \"resumptionRecords\",\n            [],\n        );\n\n        storedResumptionRecords.forEach(\n            ({\n                nodeId,\n                sharedSecret,\n                resumptionId,\n                fabricId,\n                peerNodeId,\n                sessionParameters,\n                caseAuthenticatedTags,\n            }) => {\n                logger.info(\"restoring resumption record for node\", nodeId);\n                const fabric = fabrics.find(fabric => fabric.fabricId === fabricId);\n                if (!fabric) {\n                    logger.error(\"fabric not found for resumption record\", fabricId);\n                    return;\n                }\n                this.#resumptionRecords.set(nodeId, {\n                    sharedSecret,\n                    resumptionId,\n                    fabric,\n                    peerNodeId,\n                    sessionParameters,\n                    caseAuthenticatedTags,\n                });\n            },\n        );\n    }\n\n    getActiveSessionInformation() {\n        return [...this.#sessions]\n            .filter(session => session.isSecure && !session.isPase)\n            .map(session => ({\n                name: session.name,\n                nodeId: session.nodeId,\n                peerNodeId: session.peerNodeId,\n                fabric: session instanceof SecureSession ? session.fabric?.externalInformation : undefined,\n                isPeerActive: session.isPeerActive(),\n                secure: session.isSecure,\n                lastInteractionTimestamp: session instanceof SecureSession ? session.timestamp : undefined,\n                lastActiveTimestamp: session instanceof SecureSession ? session.activeTimestamp : undefined,\n                numberOfActiveSubscriptions: session instanceof SecureSession ? session.numberOfActiveSubscriptions : 0,\n            }));\n    }\n\n    async close() {\n        await this.storeResumptionRecords();\n        for (const session of this.#sessions) {\n            await session?.end(false);\n            this.#sessions.delete(session);\n        }\n        for (const session of this.#insecureSessions.values()) {\n            await session?.end();\n            this.#insecureSessions.delete(session.nodeId);\n        }\n    }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { MatterFlowError } from \"../common/MatterError.js\";\nimport { Crypto } from \"../crypto/Crypto.js\";\nimport { CaseAuthenticatedTag } from \"../datatype/CaseAuthenticatedTag.js\";\nimport { FabricId } from \"../datatype/FabricId.js\";\nimport { FabricIndex } from \"../datatype/FabricIndex.js\";\nimport { NodeId } from \"../datatype/NodeId.js\";\nimport { Fabric } from \"../fabric/Fabric.js\";\nimport { Logger } from \"../log/Logger.js\";\nimport { MessageCounter } from \"../protocol/MessageCounter.js\";\nimport { StorageContext } from \"../storage/StorageContext.js\";\nimport { ByteArray } from \"../util/ByteArray.js\";\nimport { AsyncObservable, Observable } from \"../util/Observable.js\";\nimport { BasicSet } from \"../util/Set.js\";\nimport { InsecureSession } from \"./InsecureSession.js\";\nimport { SecureSession } from \"./SecureSession.js\";\nimport { SessionParameterOptions, SessionParameters } from \"./Session.js\";\n\nconst logger = Logger.get(\"SessionManager\");\n\nexport const UNICAST_UNSECURE_SESSION_ID = 0x0000;\n\nexport interface ResumptionRecord {\n    sharedSecret: ByteArray;\n    resumptionId: ByteArray;\n    fabric: Fabric;\n    peerNodeId: NodeId;\n    sessionParameters: SessionParameters;\n    caseAuthenticatedTags?: CaseAuthenticatedTag[];\n}\n\ntype ResumptionStorageRecord = {\n    nodeId: NodeId;\n    sharedSecret: Uint8Array;\n    resumptionId: Uint8Array;\n    fabricId: FabricId;\n    peerNodeId: NodeId;\n    sessionParameters: {\n        idleIntervalMs: number;\n        activeIntervalMs: number;\n        activeThresholdMs: number;\n    };\n    caseAuthenticatedTags?: CaseAuthenticatedTag[];\n};\n\nexport class SessionManager<ContextT> {\n    readonly #insecureSessions = new Map<NodeId, InsecureSession<ContextT>>();\n    readonly #sessions = new BasicSet<SecureSession<ContextT>>();\n    #nextSessionId = Crypto.getRandomUInt16();\n    #resumptionRecords = new Map<NodeId, ResumptionRecord>();\n    readonly #sessionStorage: StorageContext;\n    readonly #globalUnencryptedMessageCounter = new MessageCounter();\n    readonly #subscriptionsChanged = new Observable<[session: SecureSession<ContextT>]>();\n    readonly #sessionOpened = new Observable<[session: SecureSession<ContextT>]>();\n    readonly #sessionClosed = new AsyncObservable<[session: SecureSession<ContextT>], void>();\n\n    constructor(\n        private readonly context: ContextT,\n        sessionStorage: StorageContext,\n    ) {\n        this.#sessionStorage = sessionStorage;\n    }\n\n    get subscriptionsChanged() {\n        return this.#subscriptionsChanged;\n    }\n\n    get sessionOpened() {\n        return this.#sessionOpened;\n    }\n\n    get sessionClosed() {\n        return this.#sessionClosed;\n    }\n\n    createUnsecureSession(options: {\n        initiatorNodeId?: NodeId;\n        sessionParameters?: SessionParameterOptions;\n        isInitiator?: boolean;\n    }) {\n        const { initiatorNodeId, sessionParameters, isInitiator } = options;\n        if (initiatorNodeId !== undefined) {\n            if (this.#insecureSessions.has(initiatorNodeId)) {\n                throw new MatterFlowError(`UnsecureSession with NodeId ${initiatorNodeId} already exists.`);\n            }\n        }\n        while (true) {\n            const session = new InsecureSession({\n                context: this.context,\n                messageCounter: this.#globalUnencryptedMessageCounter,\n                closeCallback: async () => {\n                    logger.info(`End insecure session ${session.name}`);\n                    this.#insecureSessions.delete(session.nodeId);\n                },\n                initiatorNodeId,\n                sessionParameters,\n                isInitiator: isInitiator ?? false,\n            });\n\n            const ephermalNodeId = session.nodeId;\n            if (this.#insecureSessions.has(ephermalNodeId)) continue;\n\n            this.#insecureSessions.set(ephermalNodeId, session);\n            return session;\n        }\n    }\n\n    async createSecureSession(args: {\n        sessionId: number;\n        fabric: Fabric | undefined;\n        peerNodeId: NodeId;\n        peerSessionId: number;\n        sharedSecret: ByteArray;\n        salt: ByteArray;\n        isInitiator: boolean;\n        isResumption: boolean;\n        sessionParameters?: SessionParameterOptions;\n        caseAuthenticatedTags?: CaseAuthenticatedTag[];\n    }) {\n        const {\n            sessionId,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            sharedSecret,\n            salt,\n            isInitiator,\n            isResumption,\n            sessionParameters,\n            caseAuthenticatedTags,\n        } = args;\n        const session = await SecureSession.create({\n            context: this.context,\n            id: sessionId,\n            fabric,\n            peerNodeId,\n            peerSessionId,\n            sharedSecret,\n            salt,\n            isInitiator,\n            isResumption,\n            closeCallback: async () => {\n                logger.info(`End ${session.isPase ? \"PASE\" : \"CASE\"} session ${session.name}`);\n                this.#sessions.delete(session);\n                await this.#sessionClosed.emit(session);\n            },\n            sessionParameters,\n            caseAuthenticatedTags,\n            subscriptionChangedCallback: () => {\n                this.#subscriptionsChanged.emit(session);\n            },\n        });\n\n        this.#sessions.add(session);\n        this.#sessionOpened.emit(session);\n\n        // TODO: Add a maximum of sessions and respect/close the \"least recently used\" session. See Core Specs 4.10.1.1\n        return session;\n    }\n\n    removeSession(sessionId: number) {\n        const session = this.getSession(sessionId);\n        if (session !== undefined) {\n            this.#sessions.delete(session);\n        }\n    }\n\n    async removeResumptionRecord(peerNodeId: NodeId) {\n        this.#resumptionRecords.delete(peerNodeId);\n        await this.storeResumptionRecords();\n    }\n\n    findOldestInactiveSession() {\n        let oldestSession: SecureSession<ContextT> | undefined = undefined;\n        for (const session of this.#sessions) {\n            if (!oldestSession || session.activeTimestamp < oldestSession.activeTimestamp) {\n                oldestSession = session;\n            }\n        }\n        if (oldestSession === undefined) {\n            throw new MatterFlowError(\"No session found to close and all session ids are taken.\");\n        }\n        return oldestSession;\n    }\n\n    async getNextAvailableSessionId() {\n        for (let i = 0; i < 0xffff; i++) {\n            const id = this.#nextSessionId;\n            this.#nextSessionId = (this.#nextSessionId + 1) & 0xffff;\n            if (this.#nextSessionId === 0) this.#nextSessionId++;\n\n            if (this.getSession(id) === undefined) {\n                return id;\n            }\n        }\n\n        // All session ids are taken, search for the oldest unused session, and close it and re-use its ID\n        const oldestSession = this.findOldestInactiveSession();\n        await oldestSession.end(true, false);\n        this.#nextSessionId = oldestSession.id;\n        return this.#nextSessionId++;\n    }\n\n    getSession(sessionId: number) {\n        return this.#sessions.get(\"id\", sessionId);\n    }\n\n    getPaseSession() {\n        return [...this.#sessions].find(\n            session => session.isSecure && session.isPase && !session.closingAfterExchangeFinished,\n        ) as SecureSession<ContextT>;\n    }\n\n    getSessionForNode(fabric: Fabric, nodeId: NodeId) {\n        //TODO: It can have multiple sessions for one node ...\n        return [...this.#sessions].find(session => {\n            if (!session.isSecure) return false;\n            const secureSession = session as SecureSession<any>;\n            return secureSession.fabric?.fabricId === fabric.fabricId && secureSession.peerNodeId === nodeId;\n        });\n    }\n\n    async removeAllSessionsForNode(nodeId: NodeId, sendClose = false) {\n        for (const session of this.#sessions) {\n            if (!session.isSecure) continue;\n            const secureSession = session as SecureSession<any>;\n            if (secureSession.peerNodeId === nodeId) {\n                await secureSession.destroy(sendClose, false);\n            }\n        }\n    }\n\n    getUnsecureSession(sourceNodeId?: NodeId) {\n        if (sourceNodeId === undefined) {\n            return this.#insecureSessions.get(NodeId.UNSPECIFIED_NODE_ID);\n        }\n        return this.#insecureSessions.get(sourceNodeId);\n    }\n\n    findGroupSession(groupId: number, groupSessionId: number) {\n        // Use groupsession id to find the key ??!!\n        // The Group Session ID MAY help receiving nodes efficiently locate the Operational Group Key used to encrypt an incoming groupcast message. It SHALL NOT be used as the sole means to locate the asso\u00AD ciated Operational Group Key, since it MAY collide within the fabric. Instead, the Group Session ID provides receiving nodes a means to identify Operational Group Key candidates without the need to first attempt to decrypt groupcast messages using all available keys.\n        // On receipt of a message of Group Session Type, all valid, installed, operational group key candidates referenced by the given Group Session ID SHALL be attempted until authentication is passed or there are no more operational group keys to try. This is done because the same Group Session ID might arise from different keys. The chance of a Group Session ID collision is 2-16 but the chance of both a Group Session ID collision and the message MIC matching two different operational group keys is 2-80.\n\n        // TODO\n        throw new Error(`Not implemented ${groupId} ${groupSessionId}`);\n    }\n\n    findResumptionRecordById(resumptionId: ByteArray) {\n        return [...this.#resumptionRecords.values()].find(record => record.resumptionId.equals(resumptionId));\n    }\n\n    findResumptionRecordByNodeId(nodeId: NodeId) {\n        return this.#resumptionRecords.get(nodeId);\n    }\n\n    async saveResumptionRecord(resumptionRecord: ResumptionRecord) {\n        this.#resumptionRecords.set(resumptionRecord.peerNodeId, resumptionRecord);\n        await this.storeResumptionRecords();\n    }\n\n    async updateFabricForResumptionRecords(fabric: Fabric) {\n        const record = this.#resumptionRecords.get(fabric.rootNodeId);\n        if (record === undefined) {\n            throw new MatterFlowError(\"Resumption record not found. Should never happen.\");\n        }\n        this.#resumptionRecords.set(fabric.rootNodeId, { ...record, fabric });\n        await this.storeResumptionRecords();\n    }\n\n    async storeResumptionRecords() {\n        await this.#sessionStorage.set(\n            \"resumptionRecords\",\n            [...this.#resumptionRecords].map(\n                ([\n                    nodeId,\n                    { sharedSecret, resumptionId, peerNodeId, fabric, sessionParameters, caseAuthenticatedTags },\n                ]) =>\n                    ({\n                        nodeId,\n                        sharedSecret,\n                        resumptionId,\n                        fabricId: fabric.fabricId,\n                        peerNodeId: peerNodeId,\n                        sessionParameters,\n                        caseAuthenticatedTags,\n                    }) as ResumptionStorageRecord,\n            ),\n        );\n    }\n\n    async initFromStorage(fabrics: Fabric[]) {\n        const storedResumptionRecords = await this.#sessionStorage.get<ResumptionStorageRecord[]>(\n            \"resumptionRecords\",\n            [],\n        );\n\n        storedResumptionRecords.forEach(\n            ({\n                nodeId,\n                sharedSecret,\n                resumptionId,\n                fabricId,\n                peerNodeId,\n                sessionParameters,\n                caseAuthenticatedTags,\n            }) => {\n                logger.info(\"restoring resumption record for node\", nodeId);\n                const fabric = fabrics.find(fabric => fabric.fabricId === fabricId);\n                if (!fabric) {\n                    logger.error(\"fabric not found for resumption record\", fabricId);\n                    return;\n                }\n                this.#resumptionRecords.set(nodeId, {\n                    sharedSecret,\n                    resumptionId,\n                    fabric,\n                    peerNodeId,\n                    sessionParameters,\n                    caseAuthenticatedTags,\n                });\n            },\n        );\n    }\n\n    getActiveSessionInformation() {\n        return [...this.#sessions]\n            .filter(session => session.isSecure && !session.isPase)\n            .map(session => ({\n                name: session.name,\n                nodeId: session.nodeId,\n                peerNodeId: session.peerNodeId,\n                fabric: session instanceof SecureSession ? session.fabric?.externalInformation : undefined,\n                isPeerActive: session.isPeerActive(),\n                secure: session.isSecure,\n                lastInteractionTimestamp: session instanceof SecureSession ? session.timestamp : undefined,\n                lastActiveTimestamp: session instanceof SecureSession ? session.activeTimestamp : undefined,\n                numberOfActiveSubscriptions: session instanceof SecureSession ? session.numberOfActiveSubscriptions : 0,\n            }));\n    }\n\n    async clearSubscriptionsForNode(fabricIndex: FabricIndex, nodeId: NodeId, flushSubscriptions?: boolean) {\n        for (const session of this.#sessions) {\n            if (session.fabric?.fabricIndex === fabricIndex && session.peerNodeId === nodeId) {\n                await session.clearSubscriptions(flushSubscriptions);\n            }\n        }\n    }\n\n    async close() {\n        await this.storeResumptionRecords();\n        for (const session of this.#sessions) {\n            await session?.end(false);\n            this.#sessions.delete(session);\n        }\n        for (const session of this.#insecureSessions.values()) {\n            await session?.end();\n            this.#insecureSessions.delete(session.nodeId);\n        }\n    }\n}\n"],
+  "mappings": "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",
   "names": ["fabric"]
 }

package/dist/cjs/tlv/TlvArray.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { TlvTag, TlvTypeLength } from "./TlvCodec.js";
-import { TlvReader, TlvSchema, TlvStream, TlvWriter } from "./TlvSchema.js";
+import { TlvEncodingOptions, TlvReader, TlvSchema, TlvStream, TlvWriter } from "./TlvSchema.js";
 export type LengthConstraints = {
     minLength?: number;
     maxLength?: number;
@@ -25,7 +25,7 @@ export declare class ArraySchema<T> extends TlvSchema<T[]> {
     readonly minLength: number;
     readonly maxLength: number;
     constructor(elementSchema: TlvSchema<T>, minLength?: number, maxLength?: number);
-    encodeTlvInternal(writer: TlvWriter, value: T[], tag?: TlvTag, forWriteInteraction?: boolean): void;
+    encodeTlvInternal(writer: TlvWriter, value: T[], tag?: TlvTag, options?: TlvEncodingOptions): void;
     decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T[];
     injectField(value: T[], fieldId: number, fieldValue: any, injectChecker: (fieldValue: any) => boolean): T[];
     removeField(value: T[], fieldId: number, removeChecker: (fieldValue: any) => boolean): T[];

package/dist/cjs/tlv/TlvArray.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TlvArray.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvArray.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,MAAM,EAAW,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,cAAc,GAAG;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,cAAc,EAAE,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,EAAE,CAAC;IAE1C,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAFjB,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,EAC3B,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAc;IAK7B,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI;IAMnG,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC,EAAE;IAazE,WAAW,CAChB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,GAAG,EACf,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAC5C,CAAC,EAAE;IAUG,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAAG,CAAC,EAAE;IAS1F,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI;IAkBlC,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IA0BvE,oBAAoB,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,cAAc;CASnD;AAED,wBAAwB;AACxB,eAAO,MAAM,QAAQ,qBAAsB,UAAU,CAAC,CAAC,qCAAoC,iBAAiB,mBAChC,CAAC"}
+{"version":3,"file":"TlvArray.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvArray.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,EAAE,MAAM,EAAW,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhG,MAAM,MAAM,iBAAiB,GAAG;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,cAAc,GAAG;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,OAAO,EAAE,SAAS,CAAC;CACtB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG,cAAc,EAAE,CAAC;AAE9C;;;;GAIG;AACH,qBAAa,WAAW,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,EAAE,CAAC;IAE1C,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM;gBAFjB,aAAa,EAAE,SAAS,CAAC,CAAC,CAAC,EAC3B,SAAS,GAAE,MAAU,EACrB,SAAS,GAAE,MAAc;IAK7B,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAMlG,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC,EAAE;IAazE,WAAW,CAChB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,GAAG,EACf,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAC5C,CAAC,EAAE;IAUG,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAAG,CAAC,EAAE;IAS1F,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI;IAkBlC,sBAAsB,CAAC,MAAM,EAAE,cAAc,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IA0BvE,oBAAoB,CAAC,KAAK,EAAE,CAAC,EAAE,GAAG,cAAc;CASnD;AAED,wBAAwB;AACxB,eAAO,MAAM,QAAQ,qBAAsB,UAAU,CAAC,CAAC,qCAAoC,iBAAiB,mBAChC,CAAC"}

package/dist/cjs/tlv/TlvArray.js

@@ -41,9 +41,9 @@ class ArraySchema extends import_TlvSchema.TlvSchema {
     this.minLength = minLength;
     this.maxLength = maxLength;
   }
-  encodeTlvInternal(writer, value, tag, forWriteInteraction) {
+  encodeTlvInternal(writer, value, tag, options) {
     writer.writeTag({ type: import_TlvCodec.TlvType.Array }, tag);
-    value.forEach((element) => this.elementSchema.encodeTlvInternal(writer, element, void 0, forWriteInteraction));
+    value.forEach((element) => this.elementSchema.encodeTlvInternal(writer, element, void 0, options));
     writer.writeTag({ type: import_TlvCodec.TlvType.EndOfContainer });
   }
   decodeTlvInternalValue(reader, typeLength) {

package/dist/cjs/tlv/TlvArray.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/tlv/TlvArray.ts"],
-  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { UnexpectedDataError } from \"../common/MatterError.js\";\nimport { tryCatch } from \"../common/TryCatchHandler.js\";\nimport { ValidationError } from \"../common/ValidationError.js\";\nimport { deepCopy } from \"../util/DeepCopy.js\";\nimport { serialize } from \"../util/String.js\";\nimport { TlvTag, TlvType, TlvTypeLength } from \"./TlvCodec.js\";\nimport { TlvReader, TlvSchema, TlvStream, TlvWriter } from \"./TlvSchema.js\";\n\nexport type LengthConstraints = {\n    minLength?: number;\n    maxLength?: number;\n    length?: number;\n};\n\ntype ArrayChunkData = {\n    listIndex: number | null | undefined;\n    element: TlvStream;\n};\nexport type ArrayAsChunked = ArrayChunkData[];\n\n/**\n * Schema to encode an array or string in TLV.\n *\n * @see {@link MatterSpecification.v10.Core} \u00A7 A.11.2 and A.11.4\n */\nexport class ArraySchema<T> extends TlvSchema<T[]> {\n    constructor(\n        readonly elementSchema: TlvSchema<T>,\n        readonly minLength: number = 0,\n        readonly maxLength: number = 65535,\n    ) {\n        super();\n    }\n\n    override encodeTlvInternal(writer: TlvWriter, value: T[], tag?: TlvTag, forWriteInteraction?: boolean): void {\n        writer.writeTag({ type: TlvType.Array }, tag);\n        value.forEach(element => this.elementSchema.encodeTlvInternal(writer, element, undefined, forWriteInteraction));\n        writer.writeTag({ type: TlvType.EndOfContainer });\n    }\n\n    override decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T[] {\n        if (typeLength.type !== TlvType.Array)\n            throw new UnexpectedDataError(`Unexpected type ${typeLength.type}, expected Array (${TlvType.Array}).`);\n        const result = new Array<T>();\n        while (true) {\n            const { tag: elementTag, typeLength: elementTypeLength } = reader.readTagType();\n            if (elementTag !== undefined) throw new UnexpectedDataError(\"Array element tags should be anonymous.\");\n            if (elementTypeLength.type === TlvType.EndOfContainer) break;\n            result.push(this.elementSchema.decodeTlvInternalValue(reader, elementTypeLength));\n        }\n        return result;\n    }\n\n    override injectField(\n        value: T[],\n        fieldId: number,\n        fieldValue: any,\n        injectChecker: (fieldValue: any) => boolean,\n    ): T[] {\n        if (Array.isArray(value)) {\n            value.forEach(\n                (item, index) =>\n                    (value[index] = this.elementSchema.injectField(item, fieldId, fieldValue, injectChecker)),\n            );\n        }\n        return value;\n    }\n\n    override removeField(value: T[], fieldId: number, removeChecker: (fieldValue: any) => boolean): T[] {\n        if (Array.isArray(value)) {\n            value.forEach(\n                (item, index) => (value[index] = this.elementSchema.removeField(item, fieldId, removeChecker)),\n            );\n        }\n        return value;\n    }\n\n    override validate(data: T[]): void {\n        if (!Array.isArray(data)) throw new ValidationError(`Expected array, got ${typeof data}.`);\n        if (data.length > this.maxLength)\n            throw new ValidationError(`Array ${serialize(data)} is too long: ${data.length}, max ${this.maxLength}.`);\n        if (data.length < this.minLength)\n            throw new ValidationError(`Array ${serialize(data)} is too short: ${data.length}, min ${this.minLength}.`);\n        data.forEach((element, index) => {\n            tryCatch(\n                () => this.elementSchema.validate(element),\n                ValidationError,\n                error => {\n                    error.fieldName = `[${index}]${error.fieldName !== undefined ? `.${error.fieldName}` : \"\"}`;\n                    throw error;\n                },\n            );\n        });\n    }\n\n    decodeFromChunkedArray(chunks: ArrayAsChunked, currentValue?: T[]): T[] {\n        if (currentValue === undefined && chunks[0].listIndex !== undefined) {\n            throw new UnexpectedDataError(\n                `When no current value is supplied the first chunked element needs to have a list index of undefined, but received ${chunks[0].listIndex}.`,\n            );\n        }\n        currentValue = currentValue !== undefined ? deepCopy(currentValue) : []; // For the sake of typing; the above check makes sure it is an array\n        for (const { listIndex, element } of chunks) {\n            if (listIndex === undefined) {\n                // not set listIndex means \"Override the whole array\"\n                currentValue = this.decodeTlv(element);\n            } else if (listIndex === null) {\n                // null listIndex means \"Append to the array\"\n                const decodedElement = this.elementSchema.decodeTlv(element);\n                currentValue.push(decodedElement);\n            } else if (element[0].typeLength.type === TlvType.Null) {\n                // null element means \"Remove from the array\"\n                currentValue.splice(listIndex, 1);\n            } else {\n                // otherwise, set the element at the given index\n                currentValue[listIndex] = this.elementSchema.decodeTlv(element);\n            }\n        }\n        return currentValue;\n    }\n\n    encodeAsChunkedArray(value: T[]): ArrayAsChunked {\n        const result: ArrayAsChunked = [];\n        result.push({ listIndex: undefined, element: this.encodeTlv([]) });\n        value.forEach(element => {\n            const elementStream = this.elementSchema.encodeTlv(element);\n            result.push({ listIndex: null, element: elementStream });\n        });\n        return result;\n    }\n}\n\n/** Array TLV schema. */\nexport const TlvArray = <T>(elementSchema: TlvSchema<T>, { minLength, maxLength, length }: LengthConstraints = {}) =>\n    new ArraySchema(elementSchema, length ?? minLength, length ?? maxLength);\n"],
-  "mappings": "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",
+  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { UnexpectedDataError } from \"../common/MatterError.js\";\nimport { tryCatch } from \"../common/TryCatchHandler.js\";\nimport { ValidationError } from \"../common/ValidationError.js\";\nimport { deepCopy } from \"../util/DeepCopy.js\";\nimport { serialize } from \"../util/String.js\";\nimport { TlvTag, TlvType, TlvTypeLength } from \"./TlvCodec.js\";\nimport { TlvEncodingOptions, TlvReader, TlvSchema, TlvStream, TlvWriter } from \"./TlvSchema.js\";\n\nexport type LengthConstraints = {\n    minLength?: number;\n    maxLength?: number;\n    length?: number;\n};\n\ntype ArrayChunkData = {\n    listIndex: number | null | undefined;\n    element: TlvStream;\n};\nexport type ArrayAsChunked = ArrayChunkData[];\n\n/**\n * Schema to encode an array or string in TLV.\n *\n * @see {@link MatterSpecification.v10.Core} \u00A7 A.11.2 and A.11.4\n */\nexport class ArraySchema<T> extends TlvSchema<T[]> {\n    constructor(\n        readonly elementSchema: TlvSchema<T>,\n        readonly minLength: number = 0,\n        readonly maxLength: number = 65535,\n    ) {\n        super();\n    }\n\n    override encodeTlvInternal(writer: TlvWriter, value: T[], tag?: TlvTag, options?: TlvEncodingOptions): void {\n        writer.writeTag({ type: TlvType.Array }, tag);\n        value.forEach(element => this.elementSchema.encodeTlvInternal(writer, element, undefined, options));\n        writer.writeTag({ type: TlvType.EndOfContainer });\n    }\n\n    override decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T[] {\n        if (typeLength.type !== TlvType.Array)\n            throw new UnexpectedDataError(`Unexpected type ${typeLength.type}, expected Array (${TlvType.Array}).`);\n        const result = new Array<T>();\n        while (true) {\n            const { tag: elementTag, typeLength: elementTypeLength } = reader.readTagType();\n            if (elementTag !== undefined) throw new UnexpectedDataError(\"Array element tags should be anonymous.\");\n            if (elementTypeLength.type === TlvType.EndOfContainer) break;\n            result.push(this.elementSchema.decodeTlvInternalValue(reader, elementTypeLength));\n        }\n        return result;\n    }\n\n    override injectField(\n        value: T[],\n        fieldId: number,\n        fieldValue: any,\n        injectChecker: (fieldValue: any) => boolean,\n    ): T[] {\n        if (Array.isArray(value)) {\n            value.forEach(\n                (item, index) =>\n                    (value[index] = this.elementSchema.injectField(item, fieldId, fieldValue, injectChecker)),\n            );\n        }\n        return value;\n    }\n\n    override removeField(value: T[], fieldId: number, removeChecker: (fieldValue: any) => boolean): T[] {\n        if (Array.isArray(value)) {\n            value.forEach(\n                (item, index) => (value[index] = this.elementSchema.removeField(item, fieldId, removeChecker)),\n            );\n        }\n        return value;\n    }\n\n    override validate(data: T[]): void {\n        if (!Array.isArray(data)) throw new ValidationError(`Expected array, got ${typeof data}.`);\n        if (data.length > this.maxLength)\n            throw new ValidationError(`Array ${serialize(data)} is too long: ${data.length}, max ${this.maxLength}.`);\n        if (data.length < this.minLength)\n            throw new ValidationError(`Array ${serialize(data)} is too short: ${data.length}, min ${this.minLength}.`);\n        data.forEach((element, index) => {\n            tryCatch(\n                () => this.elementSchema.validate(element),\n                ValidationError,\n                error => {\n                    error.fieldName = `[${index}]${error.fieldName !== undefined ? `.${error.fieldName}` : \"\"}`;\n                    throw error;\n                },\n            );\n        });\n    }\n\n    decodeFromChunkedArray(chunks: ArrayAsChunked, currentValue?: T[]): T[] {\n        if (currentValue === undefined && chunks[0].listIndex !== undefined) {\n            throw new UnexpectedDataError(\n                `When no current value is supplied the first chunked element needs to have a list index of undefined, but received ${chunks[0].listIndex}.`,\n            );\n        }\n        currentValue = currentValue !== undefined ? deepCopy(currentValue) : []; // For the sake of typing; the above check makes sure it is an array\n        for (const { listIndex, element } of chunks) {\n            if (listIndex === undefined) {\n                // not set listIndex means \"Override the whole array\"\n                currentValue = this.decodeTlv(element);\n            } else if (listIndex === null) {\n                // null listIndex means \"Append to the array\"\n                const decodedElement = this.elementSchema.decodeTlv(element);\n                currentValue.push(decodedElement);\n            } else if (element[0].typeLength.type === TlvType.Null) {\n                // null element means \"Remove from the array\"\n                currentValue.splice(listIndex, 1);\n            } else {\n                // otherwise, set the element at the given index\n                currentValue[listIndex] = this.elementSchema.decodeTlv(element);\n            }\n        }\n        return currentValue;\n    }\n\n    encodeAsChunkedArray(value: T[]): ArrayAsChunked {\n        const result: ArrayAsChunked = [];\n        result.push({ listIndex: undefined, element: this.encodeTlv([]) });\n        value.forEach(element => {\n            const elementStream = this.elementSchema.encodeTlv(element);\n            result.push({ listIndex: null, element: elementStream });\n        });\n        return result;\n    }\n}\n\n/** Array TLV schema. */\nexport const TlvArray = <T>(elementSchema: TlvSchema<T>, { minLength, maxLength, length }: LengthConstraints = {}) =>\n    new ArraySchema(elementSchema, length ?? minLength, length ?? maxLength);\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/cjs/tlv/TlvNullable.d.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { TlvTag, TlvTypeLength } from "./TlvCodec.js";
-import { TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
+import { TlvEncodingOptions, TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
 /**
  * Schema to encode a nullable value in TLV.
  *
@@ -13,7 +13,7 @@ import { TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
 export declare class NullableSchema<T> extends TlvSchema<T | null> {
     private readonly schema;
     constructor(schema: TlvSchema<T>);
-    encodeTlvInternal(writer: TlvWriter, value: T | null, tag?: TlvTag, forWriteInteraction?: boolean): void;
+    encodeTlvInternal(writer: TlvWriter, value: T | null, tag?: TlvTag, options?: TlvEncodingOptions): void;
     decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T | null;
     validate(value: T | null): void;
     injectField(value: T, fieldId: number, fieldValue: any, injectChecker: (fieldValue: any) => boolean): T;

package/dist/cjs/tlv/TlvNullable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TlvNullable.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvNullable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAW,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGjE;;;;GAIG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAIxC,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,OAAO,GAAG,IAAI;IAQxG,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC,GAAG,IAAI;IAgB9E,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAI/B,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAAG,CAAC;IAOvG,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAAG,CAAC;CAMlG;AAED,2BAA2B;AAC3B,eAAO,MAAM,WAAW,cAAe,UAAU,CAAC,CAAC,sBAA+B,CAAC"}
+{"version":3,"file":"TlvNullable.d.ts","sourceRoot":"","sources":["../../../src/tlv/TlvNullable.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAW,aAAa,EAAE,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGrF;;;;GAIG;AACH,qBAAa,cAAc,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1C,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAIxC,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAQvG,sBAAsB,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,aAAa,GAAG,CAAC,GAAG,IAAI;IAgB9E,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;IAI/B,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAAG,CAAC;IAOvG,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,UAAU,EAAE,GAAG,KAAK,OAAO,GAAG,CAAC;CAMlG;AAED,2BAA2B;AAC3B,eAAO,MAAM,WAAW,cAAe,UAAU,CAAC,CAAC,sBAA+B,CAAC"}

package/dist/cjs/tlv/TlvNullable.js

@@ -36,11 +36,11 @@ class NullableSchema extends import_TlvSchema.TlvSchema {
     super();
     this.schema = schema;
   }
-  encodeTlvInternal(writer, value, tag, forWriteInteraction) {
+  encodeTlvInternal(writer, value, tag, options) {
     if (value === null) {
       writer.writeTag({ type: import_TlvCodec.TlvType.Null }, tag);
     } else {
-      this.schema.encodeTlvInternal(writer, value, tag, forWriteInteraction);
+      this.schema.encodeTlvInternal(writer, value, tag, options);
     }
   }
   decodeTlvInternalValue(reader, typeLength) {

package/dist/cjs/tlv/TlvNullable.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/tlv/TlvNullable.ts"],
-  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { ArraySchema } from \"./TlvArray.js\";\nimport { TlvTag, TlvType, TlvTypeLength } from \"./TlvCodec.js\";\nimport { TlvReader, TlvSchema, TlvWriter } from \"./TlvSchema.js\";\nimport { StringSchema } from \"./TlvString.js\";\n\n/**\n * Schema to encode a nullable value in TLV.\n *\n * @see {@link MatterSpecification.v10.Core} \u00A7 A.11.6\n */\nexport class NullableSchema<T> extends TlvSchema<T | null> {\n    constructor(private readonly schema: TlvSchema<T>) {\n        super();\n    }\n\n    override encodeTlvInternal(writer: TlvWriter, value: T | null, tag?: TlvTag, forWriteInteraction?: boolean): void {\n        if (value === null) {\n            writer.writeTag({ type: TlvType.Null }, tag);\n        } else {\n            this.schema.encodeTlvInternal(writer, value, tag, forWriteInteraction);\n        }\n    }\n\n    override decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T | null {\n        if (typeLength.type === TlvType.Null) return null;\n        const value = this.schema.decodeTlvInternalValue(reader, typeLength);\n        // The Matter standard allows to send an empty string or Array for nullable elements that have a length.\n        // This should be handled like null, so make sure to convert that correctly when decoding.\n        // @see {@link MatterSpecification.v12.Core} \u00A7 7.17.1\n        if (\n            value !== null &&\n            (this.schema instanceof ArraySchema || this.schema instanceof StringSchema) &&\n            (value as any).length === 0\n        ) {\n            return null;\n        }\n        return value;\n    }\n\n    override validate(value: T | null): void {\n        if (value !== null) this.schema.validate(value);\n    }\n\n    override injectField(value: T, fieldId: number, fieldValue: any, injectChecker: (fieldValue: any) => boolean): T {\n        if (value !== null) {\n            return this.schema.injectField(value, fieldId, fieldValue, injectChecker);\n        }\n        return value;\n    }\n\n    override removeField(value: T, fieldId: number, removeChecker: (fieldValue: any) => boolean): T {\n        if (value !== null) {\n            return this.schema.removeField(value, fieldId, removeChecker);\n        }\n        return value;\n    }\n}\n\n/** Nullable TLV schema. */\nexport const TlvNullable = <T>(schema: TlvSchema<T>) => new NullableSchema(schema);\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAA4B;AAC5B,sBAA+C;AAC/C,uBAAgD;AAChD,uBAA6B;AAT7B;AAAA;AAAA;AAAA;AAAA;AAgBO,MAAM,uBAA0B,2BAAoB;AAAA,EACvD,YAA6B,QAAsB;AAC/C,UAAM;AADmB;AAAA,EAE7B;AAAA,EAES,kBAAkB,QAAmB,OAAiB,KAAc,qBAAqC;AAC9G,QAAI,UAAU,MAAM;AAChB,aAAO,SAAS,EAAE,MAAM,wBAAQ,KAAK,GAAG,GAAG;AAAA,IAC/C,OAAO;AACH,WAAK,OAAO,kBAAkB,QAAQ,OAAO,KAAK,mBAAmB;AAAA,IACzE;AAAA,EACJ;AAAA,EAES,uBAAuB,QAAmB,YAAqC;AACpF,QAAI,WAAW,SAAS,wBAAQ,KAAM,QAAO;AAC7C,UAAM,QAAQ,KAAK,OAAO,uBAAuB,QAAQ,UAAU;AAInE,QACI,UAAU,SACT,KAAK,kBAAkB,+BAAe,KAAK,kBAAkB,kCAC7D,MAAc,WAAW,GAC5B;AACE,aAAO;AAAA,IACX;AACA,WAAO;AAAA,EACX;AAAA,EAES,SAAS,OAAuB;AACrC,QAAI,UAAU,KAAM,MAAK,OAAO,SAAS,KAAK;AAAA,EAClD;AAAA,EAES,YAAY,OAAU,SAAiB,YAAiB,eAAgD;AAC7G,QAAI,UAAU,MAAM;AAChB,aAAO,KAAK,OAAO,YAAY,OAAO,SAAS,YAAY,aAAa;AAAA,IAC5E;AACA,WAAO;AAAA,EACX;AAAA,EAES,YAAY,OAAU,SAAiB,eAAgD;AAC5F,QAAI,UAAU,MAAM;AAChB,aAAO,KAAK,OAAO,YAAY,OAAO,SAAS,aAAa;AAAA,IAChE;AACA,WAAO;AAAA,EACX;AACJ;AAGO,MAAM,cAAc,CAAI,WAAyB,IAAI,eAAe,MAAM;",
+  "sourcesContent": ["/**\n * @license\n * Copyright 2022-2024 Matter.js Authors\n * SPDX-License-Identifier: Apache-2.0\n */\n\nimport { ArraySchema } from \"./TlvArray.js\";\nimport { TlvTag, TlvType, TlvTypeLength } from \"./TlvCodec.js\";\nimport { TlvEncodingOptions, TlvReader, TlvSchema, TlvWriter } from \"./TlvSchema.js\";\nimport { StringSchema } from \"./TlvString.js\";\n\n/**\n * Schema to encode a nullable value in TLV.\n *\n * @see {@link MatterSpecification.v10.Core} \u00A7 A.11.6\n */\nexport class NullableSchema<T> extends TlvSchema<T | null> {\n    constructor(private readonly schema: TlvSchema<T>) {\n        super();\n    }\n\n    override encodeTlvInternal(writer: TlvWriter, value: T | null, tag?: TlvTag, options?: TlvEncodingOptions): void {\n        if (value === null) {\n            writer.writeTag({ type: TlvType.Null }, tag);\n        } else {\n            this.schema.encodeTlvInternal(writer, value, tag, options);\n        }\n    }\n\n    override decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): T | null {\n        if (typeLength.type === TlvType.Null) return null;\n        const value = this.schema.decodeTlvInternalValue(reader, typeLength);\n        // The Matter standard allows to send an empty string or Array for nullable elements that have a length.\n        // This should be handled like null, so make sure to convert that correctly when decoding.\n        // @see {@link MatterSpecification.v12.Core} \u00A7 7.17.1\n        if (\n            value !== null &&\n            (this.schema instanceof ArraySchema || this.schema instanceof StringSchema) &&\n            (value as any).length === 0\n        ) {\n            return null;\n        }\n        return value;\n    }\n\n    override validate(value: T | null): void {\n        if (value !== null) this.schema.validate(value);\n    }\n\n    override injectField(value: T, fieldId: number, fieldValue: any, injectChecker: (fieldValue: any) => boolean): T {\n        if (value !== null) {\n            return this.schema.injectField(value, fieldId, fieldValue, injectChecker);\n        }\n        return value;\n    }\n\n    override removeField(value: T, fieldId: number, removeChecker: (fieldValue: any) => boolean): T {\n        if (value !== null) {\n            return this.schema.removeField(value, fieldId, removeChecker);\n        }\n        return value;\n    }\n}\n\n/** Nullable TLV schema. */\nexport const TlvNullable = <T>(schema: TlvSchema<T>) => new NullableSchema(schema);\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,sBAA4B;AAC5B,sBAA+C;AAC/C,uBAAoE;AACpE,uBAA6B;AAT7B;AAAA;AAAA;AAAA;AAAA;AAgBO,MAAM,uBAA0B,2BAAoB;AAAA,EACvD,YAA6B,QAAsB;AAC/C,UAAM;AADmB;AAAA,EAE7B;AAAA,EAES,kBAAkB,QAAmB,OAAiB,KAAc,SAAoC;AAC7G,QAAI,UAAU,MAAM;AAChB,aAAO,SAAS,EAAE,MAAM,wBAAQ,KAAK,GAAG,GAAG;AAAA,IAC/C,OAAO;AACH,WAAK,OAAO,kBAAkB,QAAQ,OAAO,KAAK,OAAO;AAAA,IAC7D;AAAA,EACJ;AAAA,EAES,uBAAuB,QAAmB,YAAqC;AACpF,QAAI,WAAW,SAAS,wBAAQ,KAAM,QAAO;AAC7C,UAAM,QAAQ,KAAK,OAAO,uBAAuB,QAAQ,UAAU;AAInE,QACI,UAAU,SACT,KAAK,kBAAkB,+BAAe,KAAK,kBAAkB,kCAC7D,MAAc,WAAW,GAC5B;AACE,aAAO;AAAA,IACX;AACA,WAAO;AAAA,EACX;AAAA,EAES,SAAS,OAAuB;AACrC,QAAI,UAAU,KAAM,MAAK,OAAO,SAAS,KAAK;AAAA,EAClD;AAAA,EAES,YAAY,OAAU,SAAiB,YAAiB,eAAgD;AAC7G,QAAI,UAAU,MAAM;AAChB,aAAO,KAAK,OAAO,YAAY,OAAO,SAAS,YAAY,aAAa;AAAA,IAC5E;AACA,WAAO;AAAA,EACX;AAAA,EAES,YAAY,OAAU,SAAiB,eAAgD;AAC5F,QAAI,UAAU,MAAM;AAChB,aAAO,KAAK,OAAO,YAAY,OAAO,SAAS,aAAa;AAAA,IAChE;AACA,WAAO;AAAA,EACX;AACJ;AAGO,MAAM,cAAc,CAAI,WAAyB,IAAI,eAAe,MAAM;",
   "names": []
 }

package/dist/cjs/tlv/TlvObject.d.ts

@@ -6,7 +6,7 @@
 import { Merge } from "../util/Type.js";
 import { LengthConstraints } from "./TlvArray.js";
 import { TlvTag, TlvType, TlvTypeLength } from "./TlvCodec.js";
-import { TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
+import { TlvEncodingOptions, TlvReader, TlvSchema, TlvWriter } from "./TlvSchema.js";
 export interface FieldType<T> {
     id: number;
     schema: TlvSchema<T>;
@@ -55,7 +55,7 @@ export declare class ObjectSchema<F extends TlvFields> extends TlvSchema<TypeFro
     private readonly allowProtocolSpecificTags;
     private readonly fieldById;
     constructor(fieldDefinitions: F, type?: TlvType.Structure | TlvType.List, allowProtocolSpecificTags?: boolean);
-    encodeTlvInternal(writer: TlvWriter, value: TypeFromFields<F>, tag?: TlvTag, forWriteInteraction?: boolean): void;
+    encodeTlvInternal(writer: TlvWriter, value: TypeFromFields<F>, tag?: TlvTag, options?: TlvEncodingOptions): void;
     decodeTlvInternalValue(reader: TlvReader, typeLength: TlvTypeLength): TypeFromFields<F>;
     validate(value: TypeFromFields<F>): void;
     injectField(value: TypeFromFields<F>, fieldId: number, fieldValue: any, injectChecker: (fieldValue: any) => boolean): TypeFromFields<F>;

package/dist/cjs/tlv/TlvObject.d.ts.map

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

package/dist/cjs/tlv/TlvObject.js

@@ -54,11 +54,17 @@ class ObjectSchema extends import_TlvSchema.TlvSchema {
       this.fieldById[field.id] = { name, field };
     }
   }
-  #encodeEntryToTlv(writer, name, value, forWriteInteraction) {
+  #encodeEntryToTlv(writer, name, value, options) {
     const { id, schema, optional: isOptional, repeated: isRepeated } = this.fieldDefinitions[name];
+    const { forWriteInteraction = false, allowMissingFieldsForNonFabricFilteredRead = false } = options ?? {};
+    if (forWriteInteraction && allowMissingFieldsForNonFabricFilteredRead) {
+      throw new import_MatterError.InternalError(
+        "Encode options can not indicate a write interaction and a fabric filtered read interaction at the same time."
+      );
+    }
     const fieldValue = value[name];
     if (fieldValue === void 0) {
-      if (!isOptional) {
+      if (!isOptional && !allowMissingFieldsForNonFabricFilteredRead) {
         if (forWriteInteraction && id === import_model.Globals.FabricIndex.id) {
           return;
         }
@@ -71,40 +77,40 @@ class ObjectSchema extends import_TlvSchema.TlvSchema {
         throw new import_ValidationError.ValidationError(`Repeated field ${name} should be an array.`, name);
       }
       for (const element of fieldValue) {
-        schema.encodeTlvInternal(writer, element, { id }, forWriteInteraction);
+        schema.encodeTlvInternal(writer, element, { id }, options);
       }
     } else {
-      schema.encodeTlvInternal(writer, fieldValue, { id }, forWriteInteraction);
+      schema.encodeTlvInternal(writer, fieldValue, { id }, options);
     }
   }
   /**
    * Encode the object as Structure, by the order of field definitions.
    */
-  #encodeStructure(writer, value, forWriteInteraction) {
+  #encodeStructure(writer, value, options) {
     for (const name in this.fieldDefinitions) {
-      this.#encodeEntryToTlv(writer, name, value, forWriteInteraction);
+      this.#encodeEntryToTlv(writer, name, value, options);
     }
   }
   /**
    * Encode the object as List, by the order of the fields in the object.
    */
-  #encodeList(writer, value, forWriteInteraction) {
+  #encodeList(writer, value, options) {
     const encodedFields = /* @__PURE__ */ new Set();
     for (const name of Object.keys(value)) {
-      this.#encodeEntryToTlv(writer, name, value, forWriteInteraction);
+      this.#encodeEntryToTlv(writer, name, value, options);
       encodedFields.add(name);
     }
     for (const name in this.fieldDefinitions) {
       if (encodedFields.has(name)) continue;
-      this.#encodeEntryToTlv(writer, name, value, forWriteInteraction);
+      this.#encodeEntryToTlv(writer, name, value, options);
     }
   }
-  encodeTlvInternal(writer, value, tag, forWriteInteraction) {
+  encodeTlvInternal(writer, value, tag, options) {
     writer.writeTag({ type: this.type }, tag);
     if (this.type === import_TlvCodec.TlvType.Structure) {
-      this.#encodeStructure(writer, value, forWriteInteraction);
+      this.#encodeStructure(writer, value, options);
     } else {
-      this.#encodeList(writer, value, forWriteInteraction);
+      this.#encodeList(writer, value, options);
     }
     writer.writeTag({ type: import_TlvCodec.TlvType.EndOfContainer });
   }