@project-chip/matter.js 0.12.6-alpha.0-20250304-03716637c → 0.13.0-alpha.0-20250307-ebf84a05a

package/src/compat/crypto.ts

@@ -1,21 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export {
-    CRYPTO_AUTH_TAG_LENGTH,
-    CRYPTO_EC_CURVE,
-    CRYPTO_EC_KEY_BYTES,
-    CRYPTO_ENCRYPT_ALGORITHM,
-    CRYPTO_HASH_ALGORITHM,
-    CRYPTO_SYMMETRIC_KEY_LENGTH,
-    Crypto,
-    CryptoVerifyError,
-    Key,
-    PrivateKey,
-    PublicKey,
-    Spake2p,
-    type CryptoDsaEncoding,
-} from "#general";

package/src/compat/datatype.ts

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export * from "@matter/types/datatype";

package/src/compat/endpoint/definitions.ts

@@ -1,10 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export * from "@matter/node/endpoints";
-
-// Previously a codegen bug exposed "device" device types in the "endpoints" index
-export * from "@matter/node/devices";

package/src/compat/endpoint.ts

@@ -1,17 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export {
-    Agent,
-    Behaviors,
-    Endpoint,
-    EndpointServer,
-    EndpointType,
-    MutableEndpoint,
-    Parts,
-    SemanticNamespace,
-} from "#node";
-export { type EndpointInterface } from "#protocol";

package/src/compat/environment.ts

@@ -1,8 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export { Environment, Environmental, RuntimeService, StorageService, VariableService } from "#general";
-export { MdnsService } from "#protocol";

package/src/compat/fabric.ts

@@ -1,26 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { type Fabric } from "#protocol";
-
-export {
-    Fabric,
-    FabricAction,
-    FabricBuilder,
-    FabricManager,
-    FabricNotFoundError,
-    FabricTableFullError,
-    PairingHintBitmap,
-    PairingHintBitmapSchema,
-    PublicKeyError,
-    type CommissionerInstanceData,
-    type CommissioningModeInstanceData,
-    type ExposedFabricInformation,
-    type InstanceBroadcaster,
-    type OperationalInstanceData,
-} from "#protocol";
-
-export type FabricJsonObject = Fabric.Config;

package/src/compat/interaction.ts

@@ -1,72 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { Specification } from "#model";
-
-export {
-    attributePathToId,
-    canAttributePayloadBeChunked,
-    chunkAttributePayload,
-    clusterPathToId,
-    commandPathToId,
-    compressAttributeDataReportTags,
-    decodeAttributeValueWithSchema,
-    decodeListAttributeValueWithSchema,
-    decodeUnknownAttributeValue,
-    decodeUnknownEventValue,
-    encodeAttributePayload,
-    encodeEventPayload,
-    eventPathToId,
-    expandPathsInAttributeData,
-    genericElementPathToId,
-    IncomingInteractionClientMessenger,
-    InteractionClient,
-    InteractionClientMessenger,
-    InteractionEndpointStructure,
-    InteractionServer,
-    MessageType,
-    normalizeAndDecodeAttributeData,
-    normalizeAndDecodeEventData,
-    normalizeAndDecodeReadAttributeReport,
-    normalizeAndDecodeReadEventReport,
-    normalizeAttributeData,
-    normalizeEventData,
-    OccurrenceManager,
-    sortAttributeDataByPath,
-    structureReadAttributeDataToClusterObject,
-    ServerSubscription as SubscriptionHandler,
-    ServerSubscriptionConfig as SubscriptionOptions,
-    validateReadAttributesPath,
-    validateReadEventPath,
-    type AttributePath,
-    type AttributeReportPayload,
-    type AttributeWithPath,
-    type CommandPath,
-    type CommandWithPath,
-    type DataReport,
-    type DataReportPayload,
-    type DecodedAttributeReportValue,
-    type DecodedAttributeValue,
-    type DecodedEventData,
-    type DecodedEventReportValue,
-    type EventDataPayload,
-    type EventPath,
-    type EventReportPayload,
-    type EventWithPath,
-    type InteractionRecipient,
-    type InteractionServerMessenger,
-    type InvokeRequest,
-    type InvokeResponse,
-    type ReadRequest,
-    type SubscribeRequest,
-    type TimedRequest,
-    type WriteRequest,
-    type WriteResponse,
-} from "#protocol";
-export { DEFAULT_MAX_PATHS_PER_INVOKE, INTERACTION_PROTOCOL_ID, StatusResponseError } from "#types";
-export * from "@matter/types/protocol";
-
-export const INTERACTION_MODEL_REVISION = Specification.INTERACTION_MODEL_REVISION;

package/src/compat/log.ts

@@ -1,14 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export {
-    Diagnostic,
-    DiagnosticSource,
-    LogFormat as Format,
-    LogLevel as Level,
-    Logger,
-    logLevelFromString as levelFromString,
-} from "#general";

package/src/compat/math.ts

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export { ReedSolomon, Verhoeff } from "#general";

package/src/compat/mdns.ts

@@ -1,23 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-export {
-    MATTER_COMMISSIONER_SERVICE_QNAME,
-    MATTER_COMMISSION_SERVICE_QNAME,
-    MATTER_SERVICE_QNAME,
-    MdnsBroadcaster,
-    MdnsInstanceBroadcaster,
-    MdnsScanner,
-    MdnsServer,
-    SERVICE_DISCOVERY_QNAME,
-    getCommissioningModeQname,
-    getDeviceInstanceQname,
-    getDeviceMatterQname,
-    getDeviceTypeQname,
-    getFabricQname,
-    getLongDiscriminatorQname,
-    getShortDiscriminatorQname,
-    getVendorQname,
-} from "#protocol";

package/src/compat/model.ts

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export * from "#model";

package/src/compat/net.ts

@@ -1,22 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export {
-    InterfaceType,
-    MAX_UDP_MESSAGE_SIZE,
-    MockNetwork,
-    MockUdpChannel,
-    Network,
-    NetworkError,
-    NetworkSimulator,
-    UdpInterface,
-    UdpMulticastServer,
-    type NetInterface,
-    type NetworkInterface,
-    type NetworkInterfaceDetails,
-    type UdpChannel,
-    type UdpChannelOptions,
-} from "#general";

package/src/compat/node.ts

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export { Node, ServerNode } from "#node";

package/src/compat/protocol.ts

@@ -1,33 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export {
-    ChannelManager,
-    ChannelNotConnectedError,
-    CommissioningError,
-    ControllerCommissioningFlow as ControllerCommissioner,
-    ControllerDiscovery,
-    DiscoveryError,
-    DuplicateMessageError,
-    ExchangeCounter,
-    ExchangeManager,
-    ExchangeProvider,
-    MATTER_MESSAGE_OVERHEAD,
-    MAX_COUNTER_VALUE_32BIT,
-    MessageChannel,
-    MessageCounterTypes,
-    MessageExchange,
-    MessageReceptionState,
-    MessageReceptionStateEncryptedWithRollover,
-    MessageReceptionStateEncryptedWithoutRollover,
-    MessageReceptionStateUnencryptedWithRollover,
-    NoChannelError,
-    PairRetransmissionLimitReachedError,
-    UnexpectedMessageError,
-    type ControllerCommissioningFlowOptions as CommissioningOptions,
-    type ExchangeSendOptions,
-    type ProtocolHandler,
-} from "#protocol";

package/src/compat/schema.ts

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export * from "@matter/types/schema";

package/src/compat/securechannel.ts

@@ -1,18 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export {
-    ChannelStatusResponseError,
-    DEFAULT_NORMAL_PROCESSING_TIME_MS,
-    EXPECTED_CRYPTO_PROCESSING_TIME_MS,
-    SecureChannelMessenger,
-    SecureChannelProtocol,
-    SecureChannelStatusMessageSchema,
-    StatusReportOnlySecureChannelProtocol,
-    type StatusMessage,
-} from "#protocol";
-
-export { GeneralStatusCode, ProtocolStatusCode, SecureMessageType } from "#types";

package/src/compat/storage.ts

@@ -1,17 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export {
-    StorageBackendMemory,
-    StorageContext,
-    StorageError,
-    StorageManager,
-    SyncStorage,
-    fromJson,
-    toJson,
-    type Storage,
-    type SupportedStorageTypes,
-} from "#general";

package/src/compat/time.ts

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export { Time, Time as TimeNode, type Timer } from "#general";

package/src/compat/tlv.ts

@@ -1,7 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export * from "@matter/types/tlv";

package/src/compat/util.ts

@@ -1,24 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-export {
-    AsyncObservable,
-    Bytes,
-    Cache,
-    EventEmitter,
-    MaybePromise,
-    Observable,
-    DataReadQueue as Queue,
-    camelize,
-    createPromise,
-    deepCopy,
-    isDeepEqual,
-    isIPv6,
-    onSameNetwork,
-    serialize,
-    singleton,
-    type Identity,
-} from "#general";

package/src/device/DimmableDevices.ts

@@ -1,117 +0,0 @@
-// additional commands to be allowed for registering and triggering handlers
-
-import { LevelControl, OnOff } from "#clusters";
-import { AttributeInitialValues, ClusterServerHandlers } from "../cluster/server/ClusterServerTypes.js";
-
-import { extendPublicHandlerMethods } from "#general";
-import { ClusterId } from "#types";
-import { createDefaultLevelControlClusterServer } from "../cluster/server/LevelControlServer.js";
-import { createDefaultOnOffClusterServer } from "../cluster/server/OnOffServer.js";
-import { DeviceTypeDefinition, DeviceTypes } from "./DeviceTypes.js";
-import { EndpointOptions } from "./Endpoint.js";
-import { OnOffBaseDevice, getClusterInitialAttributeValues } from "./OnOffDevices.js";
-
-type DimmableDeviceCommands = {
-    moveToLevel: ClusterServerHandlers<typeof LevelControl.Complete>["moveToLevel"];
-    move: ClusterServerHandlers<typeof LevelControl.Complete>["move"];
-    step: ClusterServerHandlers<typeof LevelControl.Complete>["step"];
-    stop: ClusterServerHandlers<typeof LevelControl.Complete>["stop"];
-    moveToLevelWithOnOff: ClusterServerHandlers<typeof LevelControl.Complete>["moveToLevelWithOnOff"];
-    moveWithOnOff: ClusterServerHandlers<typeof LevelControl.Complete>["moveWithOnOff"];
-    stepWithOnOff: ClusterServerHandlers<typeof LevelControl.Complete>["stepWithOnOff"];
-    stopWithOnOff: ClusterServerHandlers<typeof LevelControl.Complete>["stopWithOnOff"];
-};
-
-class DimmableBaseDevice extends extendPublicHandlerMethods<typeof OnOffBaseDevice, DimmableDeviceCommands>(
-    OnOffBaseDevice,
-) {
-    constructor(
-        definition: DeviceTypeDefinition,
-        attributeInitialValues?: { [key: ClusterId]: AttributeInitialValues<any> },
-        options: EndpointOptions = {},
-        isLighting = false,
-    ) {
-        super(definition, attributeInitialValues, options, isLighting);
-    }
-
-    protected override addDeviceClusters(
-        attributeInitialValues?: { [key: ClusterId]: AttributeInitialValues<any> },
-        excludeList: ClusterId[] = [],
-    ) {
-        super.addDeviceClusters(attributeInitialValues, [...excludeList, OnOff.Cluster.id, LevelControl.Cluster.id]);
-        if (!excludeList.includes(OnOff.Cluster.id)) {
-            this.addClusterServer(
-                createDefaultOnOffClusterServer(
-                    this.commandHandler,
-                    getClusterInitialAttributeValues(
-                        attributeInitialValues,
-                        OnOff.Cluster.with(OnOff.Feature.Lighting),
-                    ),
-                    this.isLighting,
-                ),
-            );
-        }
-        if (!excludeList.includes(LevelControl.Cluster.id)) {
-            this.addClusterServer(
-                createDefaultLevelControlClusterServer(
-                    this.commandHandler,
-                    getClusterInitialAttributeValues(
-                        attributeInitialValues,
-                        LevelControl.Cluster.with(LevelControl.Feature.OnOff, LevelControl.Feature.Lighting),
-                    ),
-                ),
-            );
-        }
-    }
-
-    getCurrentLevel() {
-        return this.getClusterServer(LevelControl.Cluster)?.getCurrentLevelAttribute() ?? 0;
-    }
-
-    setCurrentLevel(level: number | null) {
-        this.getClusterServer(LevelControl.Cluster)?.setCurrentLevelAttribute(level);
-    }
-
-    /**
-     * Adds a listener for the CurrentLevel attribute
-     *
-     * @param listener Listener function to be called when the attribute changes
-     */
-    addCurrentLevelListener(listener: (newValue: number | null, oldValue: number | null) => void) {
-        this.getClusterServer(LevelControl.Cluster)?.subscribeCurrentLevelAttribute(listener);
-    }
-}
-
-export class DimmablePluginUnitDevice extends DimmableBaseDevice {
-    constructor(
-        onOffAttributeInitialValues?: AttributeInitialValues<typeof OnOff.Cluster.attributes>,
-        dimmableAttributeValues?: AttributeInitialValues<typeof LevelControl.Cluster.attributes>,
-        options: EndpointOptions = {},
-    ) {
-        const initialAttributeValues: { [key: ClusterId]: AttributeInitialValues<any> } = {};
-        if (onOffAttributeInitialValues !== undefined) {
-            initialAttributeValues[OnOff.Cluster.id] = onOffAttributeInitialValues;
-        }
-        if (dimmableAttributeValues !== undefined) {
-            initialAttributeValues[LevelControl.Cluster.id] = dimmableAttributeValues;
-        }
-        super(DeviceTypes.DIMMABLE_PLUGIN_UNIT, initialAttributeValues, options, false);
-    }
-}
-
-export class DimmableLightDevice extends DimmableBaseDevice {
-    constructor(
-        onOffAttributeInitialValues?: AttributeInitialValues<typeof OnOff.Cluster.attributes>,
-        dimmableAttributeValues?: AttributeInitialValues<typeof LevelControl.Cluster.attributes>,
-        options: EndpointOptions = {},
-    ) {
-        const initialAttributeValues: { [key: ClusterId]: AttributeInitialValues<any> } = {};
-        if (onOffAttributeInitialValues !== undefined) {
-            initialAttributeValues[OnOff.Cluster.id] = onOffAttributeInitialValues;
-        }
-        if (dimmableAttributeValues !== undefined) {
-            initialAttributeValues[LevelControl.Cluster.id] = dimmableAttributeValues;
-        }
-        super(DeviceTypes.DIMMABLE_LIGHT, initialAttributeValues, options, true);
-    }
-}

package/src/device/LegacyInteractionServer.ts

@@ -1,173 +0,0 @@
-/**
- * @license
- * Copyright 2022-2025 Matter.js Authors
- * SPDX-License-Identifier: Apache-2.0
- */
-
-import { AccessControlCluster } from "#clusters";
-import { Diagnostic, InternalError, Logger } from "#general";
-import { AccessLevel } from "#model";
-import {
-    AccessControlManager,
-    AccessDeniedError,
-    AnyAttributeServer,
-    AnyEventServer,
-    AttributePath,
-    AttributeServer,
-    CommandPath,
-    CommandServer,
-    EndpointInterface,
-    EventPath,
-    FabricScopedAttributeServer,
-    InteractionContext,
-    InteractionEndpointStructure,
-    InteractionServer,
-    Message,
-    MessageExchange,
-    NumberedOccurrence,
-    SecureSession,
-    Session,
-} from "#protocol";
-import { EndpointNumber, TlvEventFilter, TypeFromSchema } from "#types";
-import { Endpoint } from "./Endpoint.js";
-
-const logger = Logger.get("LegacyInteractionServer");
-
-/**
- * Interactionserver for the legacy API code paths which includes ACL checks before calling the actual
- * attribute/command handlers.
- */
-export class LegacyInteractionServer extends InteractionServer {
-    #endpointStructure: InteractionEndpointStructure;
-    #aclManager?: AccessControlManager;
-
-    constructor(context: InteractionContext) {
-        super(context);
-        this.#endpointStructure = context.structure;
-    }
-
-    #getAclManager(session: Session) {
-        if (this.#aclManager !== undefined) {
-            return this.#aclManager;
-        }
-        const rootEndpoint = this.#endpointStructure.getEndpoint(EndpointNumber(0)) as Endpoint;
-        if (rootEndpoint === undefined) {
-            throw new InternalError("Root endpoint must exist.");
-        }
-        const aclCluster = rootEndpoint.getClusterServer(AccessControlCluster);
-        if (aclCluster === undefined) {
-            throw new InternalError("Access control cluster must exist on root endpoint.");
-        }
-        const aclManager = (this.#aclManager = new AccessControlManager(aclCluster.attributes.acl.get(session, false)));
-        aclCluster.subscribeAclAttribute(() => {
-            const completeVal = aclCluster.attributes.acl.get(session, false);
-            logger.info("ACL updated", completeVal);
-            aclManager.updateAccessControlList(completeVal);
-        });
-        return aclManager;
-    }
-
-    #assertAccess(
-        path: AttributePath | EventPath | CommandPath,
-        exchange: MessageExchange,
-        desiredAccessLevel: AccessLevel,
-    ) {
-        const { endpointId, clusterId } = path;
-        const endpoint = this.#endpointStructure.getEndpoint(endpointId);
-        if (endpoint === undefined || endpoint.number === undefined) {
-            throw new InternalError("Endpoint not found for ACL check. This should never happen.");
-        }
-        const aclManager = this.#getAclManager(exchange.session);
-        if (
-            !aclManager.allowsPrivilege(
-                exchange.session as SecureSession,
-                { id: endpoint.number, deviceTypes: [endpoint.deviceType] },
-                clusterId,
-                desiredAccessLevel,
-            )
-        ) {
-            throw new AccessDeniedError(
-                `Access to ${endpointId}/${Diagnostic.hex(clusterId)} denied on ${exchange.session.name}.`,
-            );
-        }
-    }
-
-    protected override readAttribute(
-        path: AttributePath,
-        attribute: AnyAttributeServer<any>,
-        exchange: MessageExchange,
-        isFabricFiltered: boolean,
-        message: Message,
-        offline = false,
-    ) {
-        // Offline read do not require ACL checks
-        if (!offline) {
-            this.#assertAccess(path, exchange, attribute.readAcl);
-        }
-        const data = super.readAttribute(path, attribute, exchange, isFabricFiltered, message);
-        if (attribute instanceof FabricScopedAttributeServer && !isFabricFiltered) {
-            const { value, version } = data;
-            return {
-                value: attribute.sanitizeFabricSensitiveFields(value, (exchange.session as SecureSession).fabric),
-                version,
-            };
-        }
-        return data;
-    }
-
-    protected override async readEvent(
-        path: EventPath,
-        eventFilters: TypeFromSchema<typeof TlvEventFilter>[] | undefined,
-        event: AnyEventServer<any, any>,
-        exchange: MessageExchange,
-        isFabricFiltered: boolean,
-        message: Message,
-    ): Promise<NumberedOccurrence[]> {
-        this.#assertAccess(path, exchange, event.readAcl);
-        return super.readEvent(path, eventFilters, event, exchange, isFabricFiltered, message);
-    }
-
-    protected override async writeAttribute(
-        path: AttributePath,
-        attribute: AttributeServer<any>,
-        value: any,
-        exchange: MessageExchange,
-        message: Message,
-        endpoint: EndpointInterface,
-        receivedWithinTimedInteraction?: boolean,
-        isListWrite?: boolean,
-    ) {
-        this.#assertAccess(path, exchange, attribute.writeAcl);
-        return super.writeAttribute(
-            path,
-            attribute,
-            value,
-            exchange,
-            message,
-            endpoint,
-            receivedWithinTimedInteraction,
-            isListWrite,
-        );
-    }
-
-    protected override async invokeCommand(
-        path: CommandPath,
-        command: CommandServer<any, any>,
-        exchange: MessageExchange,
-        commandFields: any,
-        message: Message,
-        endpoint: EndpointInterface,
-        receivedWithinTimedInteraction = false,
-    ) {
-        this.#assertAccess(path, exchange, command.invokeAcl);
-        return super.invokeCommand(
-            path,
-            command,
-            exchange,
-            commandFields,
-            message,
-            endpoint,
-            receivedWithinTimedInteraction,
-        );
-    }
-}