@project-chip/matter.js 0.2.1 → 0.3.0

package/dist/cjs/cluster/server/AdminCommissioningServer.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AdminCommissioningHandler = void 0;
+const PaseServer_js_1 = require("../../session/pase/PaseServer.js");
+const AdminCommissioningHandler = (secureChannelProtocol) => ({
+    openCommissioningWindow: function ({ request: { pakePasscodeVerifier: pakeVerifier, discriminator, iterations, salt, commissioningTimeout }, session, /* attributes: { windowStatus } */ }) {
+        return __awaiter(this, void 0, void 0, function* () {
+            //windowStatus.set(CommissioningWindowStatus.EnhancedWindowOpen);
+            secureChannelProtocol.updatePaseCommissioner(PaseServer_js_1.PaseServer.fromVerificationValue(pakeVerifier, { iterations, salt }));
+            session.getContext().openCommissioningModeWindow(2, discriminator, commissioningTimeout);
+        });
+    },
+    openBasicCommissioningWindow: function () {
+        return __awaiter(this, void 0, void 0, function* () {
+            throw new Error("Not implemented");
+        });
+    },
+    revokeCommissioning: function () {
+        return __awaiter(this, void 0, void 0, function* () {
+            // TODO: implement this
+            throw new Error("Not implemented");
+        });
+    }
+});
+exports.AdminCommissioningHandler = AdminCommissioningHandler;

package/dist/cjs/cluster/server/AttributeServer.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterDevice } from "../../MatterDevice.js";
+import { Session } from "../../session/Session.js";
+import { SecureSession } from "../../session/SecureSession.js";
+import { TlvSchema } from "../../tlv/TlvSchema.js";
+export declare class AttributeServer<T> {
+    readonly id: number;
+    readonly name: string;
+    readonly schema: TlvSchema<T>;
+    private readonly validator;
+    readonly isWritable: boolean;
+    readonly defaultValue: T;
+    private value;
+    private version;
+    private readonly matterListeners;
+    private readonly listeners;
+    constructor(id: number, name: string, schema: TlvSchema<T>, validator: (value: T, name: string) => void, isWritable: boolean, defaultValue: T);
+    set(value: T, _session?: Session<MatterDevice>): void;
+    setLocal(value: T): void;
+    /** Initialize the value of the attribute, used when a persisted value is set initially */
+    init(value: T, version: number): void;
+    get(_session?: Session<MatterDevice>): T;
+    getWithVersion(session?: Session<MatterDevice>): {
+        version: number;
+        value: T;
+    };
+    getLocal(): T;
+    addMatterListener(listener: (value: T, version: number) => void): void;
+    removeMatterListener(listener: (value: T, version: number) => void): void;
+    addListener(listener: (newValue: T, oldValue: T) => void): void;
+    removeListener(listener: (newValue: T, oldValue: T) => void): void;
+}
+export declare class AttributeGetterServer<T> extends AttributeServer<T> {
+    readonly getter: (session?: Session<MatterDevice>) => T;
+    constructor(id: number, name: string, schema: TlvSchema<T>, validator: (value: T, name: string) => void, isWritable: boolean, defaultValue: T, getter: (session?: Session<MatterDevice>) => T);
+    setLocal(_value: T): void;
+    get(session?: SecureSession<MatterDevice>): T;
+}
+//# sourceMappingURL=AttributeServer.d.ts.map

package/dist/cjs/cluster/server/AttributeServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttributeServer.d.ts","sourceRoot":"","sources":["../../../../src/cluster/server/AttributeServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAEnD,qBAAa,eAAe,CAAC,CAAC;IAOtB,QAAQ,CAAC,EAAE,EAAE,MAAM;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC7B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,QAAQ,CAAC,UAAU,EAAE,OAAO;IAC5B,QAAQ,CAAC,YAAY,EAAE,CAAC;IAX5B,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoD;IACpF,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;gBAGhE,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACZ,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,EACnD,UAAU,EAAE,OAAO,EACnB,YAAY,EAAE,CAAC;IAM5B,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAM9C,QAAQ,CAAC,KAAK,EAAE,CAAC;IAWjB,0FAA0F;IAC1F,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM;IAM9B,GAAG,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC;IAMxC,cAAc,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;;;;IAI9C,QAAQ,IAAI,CAAC;IAIb,iBAAiB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI;IAI/D,oBAAoB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI;IAIlE,WAAW,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,IAAI;IAIxD,cAAc,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,KAAK,IAAI;CAG9D;AAED,qBAAa,qBAAqB,CAAC,CAAC,CAAE,SAAQ,eAAe,CAAC,CAAC,CAAC;IASxD,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC;gBANvD,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,EAC3C,UAAU,EAAE,OAAO,EACnB,YAAY,EAAE,CAAC,EACN,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC;IAKlD,QAAQ,CAAC,MAAM,EAAE,CAAC;IAIlB,GAAG,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,CAAC;CAKzD"}

package/dist/cjs/cluster/server/AttributeServer.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttributeGetterServer = exports.AttributeServer = void 0;
+class AttributeServer {
+    constructor(id, name, schema, validator, isWritable, defaultValue) {
+        this.id = id;
+        this.name = name;
+        this.schema = schema;
+        this.validator = validator;
+        this.isWritable = isWritable;
+        this.defaultValue = defaultValue;
+        this.version = 0;
+        this.matterListeners = new Array();
+        this.listeners = new Array();
+        validator(defaultValue, name);
+        this.value = defaultValue;
+    }
+    set(value, _session) {
+        // TODO: check ACL
+        this.setLocal(value);
+    }
+    setLocal(value) {
+        const oldValue = this.value;
+        if (value !== oldValue) {
+            this.validator(value, this.name);
+            this.version++;
+            this.value = value;
+            this.matterListeners.forEach(listener => listener(value, this.version));
+        }
+        this.listeners.forEach(listener => listener(value, oldValue));
+    }
+    /** Initialize the value of the attribute, used when a persisted value is set initially */
+    init(value, version) {
+        this.validator(value, this.name);
+        this.version = version;
+        this.value = value;
+    }
+    get(_session) {
+        // TODO: check ACL
+        return this.getLocal();
+    }
+    getWithVersion(session) {
+        return { version: this.version, value: this.get(session) };
+    }
+    getLocal() {
+        return this.value;
+    }
+    addMatterListener(listener) {
+        this.matterListeners.push(listener);
+    }
+    removeMatterListener(listener) {
+        this.matterListeners.splice(this.matterListeners.findIndex(item => item === listener), 1);
+    }
+    addListener(listener) {
+        this.listeners.push(listener);
+    }
+    removeListener(listener) {
+        this.listeners.splice(this.listeners.findIndex(item => item === listener), 1);
+    }
+}
+exports.AttributeServer = AttributeServer;
+class AttributeGetterServer extends AttributeServer {
+    constructor(id, name, schema, validator, isWritable, defaultValue, getter) {
+        super(id, name, schema, validator, isWritable, defaultValue);
+        this.getter = getter;
+    }
+    setLocal(_value) {
+        throw new Error("Setter is not supported on attribute defined by a getter");
+    }
+    get(session) {
+        // TODO: check ACL
+        // TODO handle "version" for getter
+        return this.getter(session);
+    }
+}
+exports.AttributeGetterServer = AttributeGetterServer;

package/dist/cjs/cluster/server/ClusterServer.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AttributeServer } from "./AttributeServer.js";
+import { Cluster, Command, Commands, AttributeJsType, Attributes, Attribute, OptionalAttribute, OptionalCommand, OptionalWritableAttribute, WritableAttribute, GlobalAttributes } from "../Cluster.js";
+import { Message } from "../../codec/MessageCodec.js";
+import { Merge } from "../../util/Type.js";
+import { MatterDevice } from "../../MatterDevice.js";
+import { Session } from "../../session/Session.js";
+type MandatoryAttributeNames<A extends Attributes> = {
+    [K in keyof A]: A[K] extends OptionalAttribute<any> ? never : K;
+}[keyof A];
+type OptionalAttributeNames<A extends Attributes> = {
+    [K in keyof A]: A[K] extends OptionalAttribute<any> ? K : never;
+}[keyof A];
+/** Cluster attributes accessible on the cluster server */
+export type AttributeServers<A extends Attributes> = {
+    [P in MandatoryAttributeNames<A>]: AttributeServer<AttributeJsType<A[P]>>;
+};
+/** Initial values for the cluster attribute */
+export type AttributeInitialValues<A extends Attributes> = Merge<Omit<{
+    [P in MandatoryAttributeNames<A>]: AttributeJsType<A[P]>;
+}, keyof GlobalAttributes<any>>, {
+    [P in OptionalAttributeNames<A>]?: AttributeJsType<A[P]>;
+}>;
+type MandatoryCommandNames<C extends Commands> = {
+    [K in keyof C]: C[K] extends OptionalCommand<any, any> ? never : K;
+}[keyof C];
+type OptionalCommandNames<C extends Commands> = {
+    [K in keyof C]: C[K] extends OptionalCommand<any, any> ? K : never;
+}[keyof C];
+type AttributeGetters<A extends Attributes> = {
+    [P in keyof A as `get${Capitalize<string & P>}`]?: (session?: Session<MatterDevice>) => AttributeJsType<A[P]>;
+};
+type CommandHandler<C extends Command<any, any>, A extends AttributeServers<any>> = C extends Command<infer RequestT, infer ResponseT> ? (args: {
+    request: RequestT;
+    attributes: A;
+    session: Session<MatterDevice>;
+    message: Message;
+}) => Promise<ResponseT> : never;
+type CommandHandlers<T extends Commands, A extends AttributeServers<any>> = Merge<{
+    [P in MandatoryCommandNames<T>]: CommandHandler<T[P], A>;
+}, {
+    [P in OptionalCommandNames<T>]?: CommandHandler<T[P], A>;
+}>;
+/** Handlers to process cluster commands */
+export type ClusterServerHandlers<C extends Cluster<any, any, any, any>> = Merge<CommandHandlers<C["commands"], AttributeServers<C["attributes"]>>, AttributeGetters<C["attributes"]>>;
+type OptionalAttributeConf<T extends Attributes> = {
+    [K in OptionalAttributeNames<T>]?: true;
+};
+type MakeAttributeMandatory<A extends Attribute<any>> = A extends OptionalWritableAttribute<infer T> ? WritableAttribute<T> : (A extends OptionalAttribute<infer T> ? Attribute<T> : A);
+type MakeAttributesMandatory<T extends Attributes, C extends OptionalAttributeConf<T>> = {
+    [K in keyof T]: K extends keyof C ? MakeAttributeMandatory<T[K]> : T[K];
+};
+declare const MakeAttributesMandatory: <T extends Attributes, C extends OptionalAttributeConf<T>>(attributes: T, conf: C) => MakeAttributesMandatory<T, C>;
+type UseOptionalAttributes<C extends Cluster<any, any, any, any>, A extends OptionalAttributeConf<C["attributes"]>> = Cluster<C["features"], MakeAttributesMandatory<C["attributes"], A>, C["commands"], C["events"]>;
+/** Forces the presence of the specified optional attributes, so they can be used in the command handlers */
+export declare const UseOptionalAttributes: <C extends Cluster<any, any, any, any>, A extends OptionalAttributeConf<C["attributes"]>>(cluster: C, conf: A) => UseOptionalAttributes<C, A>;
+export {};
+//# sourceMappingURL=ClusterServer.d.ts.map

package/dist/cjs/cluster/server/ClusterServer.d.ts.map

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

package/dist/cjs/cluster/server/ClusterServer.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UseOptionalAttributes = void 0;
+const MakeAttributesMandatory = (attributes, conf) => {
+    const result = Object.assign({}, attributes);
+    for (const key in conf) {
+        result[key] = Object.assign(Object.assign({}, result[key]), { optional: false });
+    }
+    return result;
+};
+/** Forces the presence of the specified optional attributes, so they can be used in the command handlers */
+/* eslint-disable @typescript-eslint/no-unused-vars */
+const UseOptionalAttributes = (cluster, conf) => (Object.assign(Object.assign({}, cluster), { attributes: MakeAttributesMandatory(cluster.attributes, conf) }));
+exports.UseOptionalAttributes = UseOptionalAttributes;

package/dist/cjs/cluster/server/CommandServer.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterDevice } from "../../MatterDevice.js";
+import { Session } from "../../session/Session.js";
+import { TlvSchema, TlvStream } from "../../tlv/TlvSchema.js";
+import { Message } from "../../codec/MessageCodec.js";
+import { StatusCode } from "../../protocol/interaction/index.js";
+export declare class CommandServer<RequestT, ResponseT> {
+    readonly invokeId: number;
+    readonly responseId: number;
+    readonly name: string;
+    protected readonly requestSchema: TlvSchema<RequestT>;
+    protected readonly responseSchema: TlvSchema<ResponseT>;
+    protected readonly handler: (request: RequestT, session: Session<MatterDevice>, message: Message) => Promise<ResponseT> | ResponseT;
+    constructor(invokeId: number, responseId: number, name: string, requestSchema: TlvSchema<RequestT>, responseSchema: TlvSchema<ResponseT>, handler: (request: RequestT, session: Session<MatterDevice>, message: Message) => Promise<ResponseT> | ResponseT);
+    invoke(session: Session<MatterDevice>, args: TlvStream, message: Message): Promise<{
+        code: StatusCode;
+        responseId: number;
+        response: TlvStream;
+    }>;
+}
+//# sourceMappingURL=CommandServer.d.ts.map

package/dist/cjs/cluster/server/CommandServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandServer.d.ts","sourceRoot":"","sources":["../../../../src/cluster/server/CommandServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,qCAAqC,CAAC;AAIjE,qBAAa,aAAa,CAAC,QAAQ,EAAE,SAAS;IAEtC,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,QAAQ,CAAC;IACrD,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,SAAS,CAAC,SAAS,CAAC;IACvD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS;gBAL1H,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACF,aAAa,EAAE,SAAS,CAAC,QAAQ,CAAC,EAClC,cAAc,EAAE,SAAS,CAAC,SAAS,CAAC,EACpC,OAAO,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS;IAGjI,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC;CAO1J"}

package/dist/cjs/cluster/server/CommandServer.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandServer = void 0;
+const Logger_js_1 = require("../../log/Logger.js");
+const logger = Logger_js_1.Logger.get("CommandServer");
+class CommandServer {
+    constructor(invokeId, responseId, name, requestSchema, responseSchema, handler) {
+        this.invokeId = invokeId;
+        this.responseId = responseId;
+        this.name = name;
+        this.requestSchema = requestSchema;
+        this.responseSchema = responseSchema;
+        this.handler = handler;
+    }
+    invoke(session, args, message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const request = this.requestSchema.decodeTlv(args);
+            logger.debug(`Invoke ${this.name} with data ${Logger_js_1.Logger.toJSON(request)}`);
+            const response = yield this.handler(request, session, message);
+            logger.debug(`Invoke ${this.name} response : ${Logger_js_1.Logger.toJSON(response)}`);
+            return { code: 0 /* StatusCode.Success */, responseId: this.responseId, response: this.responseSchema.encodeTlv(response) };
+        });
+    }
+}
+exports.CommandServer = CommandServer;

package/dist/cjs/cluster/server/GeneralCommissioningServer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GeneralCommissioningCluster } from "../GeneralCommissioningCluster.js";
+import { ClusterServerHandlers } from "./ClusterServer.js";
+export declare const GeneralCommissioningClusterHandler: ClusterServerHandlers<typeof GeneralCommissioningCluster>;
+//# sourceMappingURL=GeneralCommissioningServer.d.ts.map

package/dist/cjs/cluster/server/GeneralCommissioningServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeneralCommissioningServer.d.ts","sourceRoot":"","sources":["../../../../src/cluster/server/GeneralCommissioningServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAsB,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AACpG,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAK3D,eAAO,MAAM,kCAAkC,EAAE,qBAAqB,CAAC,OAAO,2BAA2B,CAwDxG,CAAC"}

package/dist/cjs/cluster/server/GeneralCommissioningServer.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneralCommissioningClusterHandler = void 0;
+const Logger_js_1 = require("../../log/Logger.js");
+const SuccessResponse = { errorCode: 0 /* CommissioningError.Ok */, debugText: "" };
+const logger = Logger_js_1.Logger.get("GeneralCommissioningClusterHandler");
+exports.GeneralCommissioningClusterHandler = {
+    armFailSafe: ({ request: { breadcrumb: breadcrumbStep }, attributes: { breadcrumb }, session }) => __awaiter(void 0, void 0, void 0, function* () {
+        // TODO Add handling for ExpiryLengthSeconds field and Error handling, see 11.9.7.2
+        session.getContext().armFailSafe();
+        breadcrumb.set(breadcrumbStep);
+        return SuccessResponse;
+    }),
+    setRegulatoryConfig: ({ request: { breadcrumb: breadcrumbStep, newRegulatoryConfig }, attributes: { breadcrumb, regulatoryConfig, /* locationCapability */ } }) => __awaiter(void 0, void 0, void 0, function* () {
+        /*
+        TODO: test this code before activating again
+        const locationCapabilityValue = locationCapability.get();
+
+        let validValues;
+        switch (locationCapabilityValue) {
+            case (RegulatoryLocationType.Outdoor):
+                validValues = [RegulatoryLocationType.Outdoor];
+                break;
+            case (RegulatoryLocationType.Indoor):
+                validValues = [RegulatoryLocationType.Indoor];
+                break;
+            case (RegulatoryLocationType.IndoorOutdoor):
+                validValues = [RegulatoryLocationType.Indoor, RegulatoryLocationType.Outdoor, RegulatoryLocationType.IndoorOutdoor];
+                break;
+            default:
+                return { errorCode: CommissioningError.ValueOutsideRange, debugText: "Invalid regulatory location" };
+        }
+
+        if (!validValues.includes(newRegulatoryConfig)) {
+            return { errorCode: CommissioningError.ValueOutsideRange, debugText: "Invalid regulatory location" };
+        }
+        */
+        regulatoryConfig.set(newRegulatoryConfig);
+        // TODO countryCode should be set for the BasicInformationCluster.location!
+        breadcrumb.set(breadcrumbStep);
+        return SuccessResponse;
+    }),
+    commissioningComplete: ({ session, attributes: { breadcrumb } }) => __awaiter(void 0, void 0, void 0, function* () {
+        // TODO Add error handling as defined in 11.9.7.6
+        if (!session.isSecure())
+            throw new Error("commissioningComplete can only be called on a secure session");
+        const fabric = session.getFabric();
+        if (fabric === undefined)
+            throw new Error("commissioningComplete is called but the fabric has not been defined yet");
+        breadcrumb.set(BigInt(0));
+        logger.info(`Commissioning completed on fabric #${fabric.fabricId.id} as node #${fabric.nodeId}.`);
+        session.getContext().completeCommission();
+        return SuccessResponse;
+    }),
+};

package/dist/cjs/cluster/server/GroupsServer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022 The node-matter Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { GroupsCluster } from "../GroupsCluster.js";
+import { ClusterServerHandlers } from "./ClusterServer.js";
+export declare const GroupsClusterHandler: (endpointId: number) => ClusterServerHandlers<typeof GroupsCluster>;
+//# sourceMappingURL=GroupsServer.d.ts.map

package/dist/cjs/cluster/server/GroupsServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupsServer.d.ts","sourceRoot":"","sources":["../../../../src/cluster/server/GroupsServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAqB3D,eAAO,MAAM,oBAAoB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,qBAAqB,CAAC,OAAO,aAAa,CAkIpG,CAAC"}

package/dist/cjs/cluster/server/GroupsServer.js

@@ -0,0 +1,149 @@
+"use strict";
+/**
+ * @license
+ * Copyright 2022 The node-matter Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupsClusterHandler = void 0;
+const GroupsCluster_js_1 = require("../GroupsCluster.js");
+const GroupId_js_1 = require("../../datatype/GroupId.js");
+const InteractionMessenger_js_1 = require("../../protocol/interaction/InteractionMessenger.js");
+/*
+TODO: If the Scenes server cluster is implemented on the same endpoint, the following extension field SHALL
+      be added to the Scene Table:
+      * OnOff
+ */
+// TODO Put in a more central place once used by other clusters
+const getFabricFromSession = (session) => {
+    if (!session.isSecure())
+        throw new Error("Session needs to be a secure session");
+    const fabric = session.getFabric();
+    if (fabric === undefined)
+        throw new Error("Session needs to have an associated Fabric");
+    return fabric;
+};
+const GroupsClusterHandler = (endpointId) => {
+    const addGroupLogic = (groupId, groupName, sessionType, fabric) => {
+        // TODO If the AddGroup command was received as a unicast, the server SHALL generate an AddGroupResponse
+        //      command with the Status field set to the evaluated status. If the AddGroup command was received
+        //      as a groupcast, the server SHALL NOT generate an AddGroupResponse command.
+        if (sessionType !== 0 /* SessionType.Unicast */) {
+            throw new Error("Groupcast not supported");
+        }
+        if (groupId.id < 1) {
+            return { status: 135 /* StatusCode.ConstraintError */, groupId };
+        }
+        if (groupName.length > 16) {
+            return { status: 135 /* StatusCode.ConstraintError */, groupId };
+        }
+        let endpointGroups = fabric.getScopedClusterDataValue(GroupsCluster_js_1.GroupsCluster, endpointId.toString());
+        if (endpointGroups === undefined) {
+            endpointGroups = new Map();
+        }
+        endpointGroups.set(groupId.id, groupName || '');
+        fabric.setScopedClusterDataValue(GroupsCluster_js_1.GroupsCluster, endpointId.toString(), endpointGroups);
+        return { status: 0 /* StatusCode.Success */, groupId };
+    };
+    return {
+        addGroup: ({ request: { groupId, groupName }, session, message: { packetHeader: { sessionType } } }) => __awaiter(void 0, void 0, void 0, function* () {
+            return addGroupLogic(groupId, groupName, sessionType, getFabricFromSession(session));
+        }),
+        viewGroup: ({ request: { groupId }, session, message: { packetHeader: { sessionType } } }) => __awaiter(void 0, void 0, void 0, function* () {
+            // TODO If the ViewGroup command was received as a unicast, the server SHALL generate an ViewGroupResponse
+            //      command with the Status field set to the evaluated status. If the ViewGroup command was received
+            //      as a groupcast, the server SHALL NOT generate an ViewGroupResponse command.
+            if (sessionType !== 0 /* SessionType.Unicast */) {
+                throw new Error("Groupcast not supported");
+            }
+            if (groupId.id < 1) {
+                return { status: 135 /* StatusCode.ConstraintError */, groupId, groupName: '' };
+            }
+            const fabric = getFabricFromSession(session);
+            const endpointGroups = fabric.getScopedClusterDataValue(GroupsCluster_js_1.GroupsCluster, endpointId.toString());
+            if (endpointGroups !== undefined) {
+                const groupName = endpointGroups.get(groupId.id);
+                if (groupName !== undefined) {
+                    return { status: 0 /* StatusCode.Success */, groupId, groupName: groupName };
+                }
+            }
+            return { status: 139 /* StatusCode.NotFound */, groupId, groupName: '' };
+        }),
+        getGroupMembership: ({ request: { groupList }, session, message: { packetHeader: { sessionType } } }) => __awaiter(void 0, void 0, void 0, function* () {
+            // TODO Later:
+            //  Zigbee: If the total number of groups will cause the maximum payload length of a frame to be exceeded,
+            //  then the GroupList field SHALL contain only as many groups as will fit.
+            var _a;
+            // TODO the server SHALL only respond in this case if the command is unicast.
+            if (sessionType !== 0 /* SessionType.Unicast */) {
+                throw new Error("Groupcast not supported");
+            }
+            const fabric = getFabricFromSession(session);
+            const endpointGroups = (_a = fabric.getScopedClusterDataValue(GroupsCluster_js_1.GroupsCluster, endpointId.toString())) !== null && _a !== void 0 ? _a : new Map();
+            const fabricGroupsList = endpointGroups !== undefined ? Array.from(endpointGroups.keys()) : [];
+            const capacity = fabricGroupsList.length < 0xff ? 0xfe - fabricGroupsList.length : 0;
+            if (groupList.length === 0) {
+                return { capacity, groupList: fabricGroupsList.map(id => new GroupId_js_1.GroupId(id)) };
+            }
+            const filteredGroupsList = groupList.filter(groupId => endpointGroups.get(groupId.id));
+            if (filteredGroupsList.length === 0) {
+                // respond only when unicast!
+                return { capacity, groupList: [] };
+            }
+            return { capacity, groupList: filteredGroupsList };
+        }),
+        removeGroup: ({ request: { groupId }, session, message: { packetHeader: { sessionType } } }) => __awaiter(void 0, void 0, void 0, function* () {
+            // TODO If the RemoveGroup command was received as a unicast, the server SHALL generate a RemoveGroupResponse
+            //      command with the Status field set to the evaluated status. If the RemoveGroup command was received as
+            //      a groupcast, the server SHALL NOT generate a RemoveGroupResponse command.
+            if (sessionType !== 0 /* SessionType.Unicast */) {
+                throw new Error("Groupcast not supported");
+            }
+            if (groupId.id < 1) {
+                return { status: 135 /* StatusCode.ConstraintError */, groupId };
+            }
+            const fabric = getFabricFromSession(session);
+            const endpointGroups = fabric.getScopedClusterDataValue(GroupsCluster_js_1.GroupsCluster, endpointId.toString());
+            if (endpointGroups !== undefined) {
+                if (endpointGroups.has(groupId.id)) {
+                    endpointGroups.delete(groupId.id);
+                    fabric.persist(); // persist scoped cluster data changes
+                    return { status: 0 /* StatusCode.Success */, groupId };
+                }
+            }
+            return { status: 139 /* StatusCode.NotFound */, groupId };
+        }),
+        removeAllGroups: ({ session, message: { packetHeader: { sessionType } } }) => __awaiter(void 0, void 0, void 0, function* () {
+            // TODO Additionally, if the Scenes cluster is supported on the same endpoint, all scenes, except for scenes
+            //      associated with group ID 0, SHALL be removed on that endpoint.
+            // TODO If the RemoveAllGroups command was received as unicast and a response is not suppressed ... return Success
+            if (sessionType !== 0 /* SessionType.Unicast */) {
+                throw new Error("Groupcast not supported");
+            }
+            const fabric = getFabricFromSession(session);
+            fabric.deleteScopedClusterDataValue(GroupsCluster_js_1.GroupsCluster, endpointId.toString());
+            throw new InteractionMessenger_js_1.StatusResponseError("Return Status", 0 /* StatusCode.Success */);
+        }),
+        addGroupIfIdentifying: ({ request: { groupId, groupName }, session, message: { packetHeader: { sessionType } } }) => __awaiter(void 0, void 0, void 0, function* () {
+            // TODO The server verifies that it is currently identifying itself. If the server it not currently identifying
+            //      itself, the status SHALL be SUCCESS
+            // return {status: AdminCommissioningStatusCode.Success, groupId};
+            // TODO If the AddGroupIfIdentifying command was received as unicast and the evaluated status is not SUCCESS, or
+            //      if the AddGroupIfIdentifying command was received as unicast and the evaluated status is SUCCESS and a
+            //      response is not suppressed, the server SHALL generate a response with the Status field set to the
+            //      evaluated status.
+            const { status } = addGroupLogic(groupId, groupName, sessionType, getFabricFromSession(session));
+            throw new InteractionMessenger_js_1.StatusResponseError("Return Status", status);
+        }),
+    };
+};
+exports.GroupsClusterHandler = GroupsClusterHandler;

package/dist/cjs/cluster/server/LevelControlServer.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { LevelControlCluster } from "../LevelControlCluster.js";
+import { ClusterServerHandlers } from "./ClusterServer.js";
+export declare const LevelControlClusterHandler: () => ClusterServerHandlers<typeof LevelControlCluster>;
+//# sourceMappingURL=LevelControlServer.d.ts.map

package/dist/cjs/cluster/server/LevelControlServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LevelControlServer.d.ts","sourceRoot":"","sources":["../../../../src/cluster/server/LevelControlServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAK3D,eAAO,MAAM,0BAA0B,EAAE,MAAM,qBAAqB,CAAC,OAAO,mBAAmB,CA6C7F,CAAC"}