@matter/node 0.17.4 → 0.17.5-alpha.0-20260704-9ea70abfa

package/dist/esm/behaviors/groupcast/GroupcastBehavior.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+import { Groupcast } from "@matter/types/clusters/groupcast";
+import { ClusterBehavior } from "../../behavior/cluster/ClusterBehavior.js";
+import { Identity } from "@matter/general";
+/**
+ * GroupcastBehavior is the base class for objects that support interaction with {@link Groupcast.Cluster}.
+ *
+ * Groupcast.Cluster requires you to enable one or more optional features. You can do so using
+ * {@link GroupcastBehavior.with}.
+ */
+export declare const GroupcastBehaviorConstructor: ClusterBehavior.Type<typeof ClusterBehavior, Groupcast, typeof Groupcast, new () => {}, Uncapitalize<string>> & {
+    readonly id: "groupcast";
+};
+export interface GroupcastBehaviorConstructor extends Identity<typeof GroupcastBehaviorConstructor> {
+}
+export declare const GroupcastBehavior: GroupcastBehaviorConstructor;
+export interface GroupcastBehavior extends InstanceType<GroupcastBehaviorConstructor> {
+}
+export declare namespace GroupcastBehavior {
+    interface State extends InstanceType<typeof GroupcastBehavior.State> {
+    }
+}
+//# sourceMappingURL=GroupcastBehavior.d.ts.map

package/dist/esm/behaviors/groupcast/GroupcastBehavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupcastBehavior.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/groupcast/GroupcastBehavior.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6CAA6C;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAC5E,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;;CAAiC,CAAC;AAE3E,MAAM,WAAW,4BAA6B,SAAQ,QAAQ,CAAC,OAAO,4BAA4B,CAAC;CAAG;AACtG,eAAO,MAAM,iBAAiB,EAAE,4BAA2D,CAAC;AAC5F,MAAM,WAAW,iBAAkB,SAAQ,YAAY,CAAC,4BAA4B,CAAC;CAAG;AACxF,yBAAiB,iBAAiB,CAAC,CAAC;IAAC,UAAiB,KAAM,SAAQ,YAAY,CAAC,OAAO,iBAAiB,CAAC,KAAK,CAAC;KAAG;CAAE"}

package/dist/esm/behaviors/groupcast/GroupcastBehavior.js

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Groupcast } from "@matter/types/clusters/groupcast";
+import { ClusterBehavior } from "../../behavior/cluster/ClusterBehavior.js";
+const GroupcastBehaviorConstructor = ClusterBehavior.for(Groupcast);
+const GroupcastBehavior = GroupcastBehaviorConstructor;
+export {
+  GroupcastBehavior,
+  GroupcastBehaviorConstructor
+};
+//# sourceMappingURL=GroupcastBehavior.js.map

package/dist/esm/behaviors/groupcast/GroupcastBehavior.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/behaviors/groupcast/GroupcastBehavior.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,iBAAiB;AAC1B,SAAS,uBAAuB;AASzB,MAAM,+BAA+B,gBAAgB,IAAI,SAAS;AAGlE,MAAM,oBAAkD;",
+  "names": []
+}

package/dist/esm/behaviors/groupcast/GroupcastClient.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+import { Groupcast } from "@matter/types/clusters/groupcast";
+import { Identity } from "@matter/general";
+export declare const GroupcastClientConstructor: import("../../index.js").ClusterBehavior.Complete<typeof import("../../index.js").ClusterBehavior, typeof Groupcast> & {
+    [x: symbol]: true;
+};
+export interface GroupcastClient extends InstanceType<typeof GroupcastClientConstructor> {
+}
+export interface GroupcastClientConstructor extends Identity<typeof GroupcastClientConstructor> {
+}
+export declare const GroupcastClient: GroupcastClientConstructor;
+//# sourceMappingURL=GroupcastClient.d.ts.map

package/dist/esm/behaviors/groupcast/GroupcastClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupcastClient.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/groupcast/GroupcastClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6CAA6C;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,eAAO,MAAM,0BAA0B;;CAA4B,CAAC;AACpE,MAAM,WAAW,eAAgB,SAAQ,YAAY,CAAC,OAAO,0BAA0B,CAAC;CAAG;AAC3F,MAAM,WAAW,0BAA2B,SAAQ,QAAQ,CAAC,OAAO,0BAA0B,CAAC;CAAG;AAClG,eAAO,MAAM,eAAe,EAAE,0BAAuD,CAAC"}

package/dist/esm/behaviors/groupcast/GroupcastClient.js

@@ -0,0 +1,14 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Groupcast } from "@matter/types/clusters/groupcast";
+import { ClientBehavior } from "../../behavior/cluster/ClientBehavior.js";
+const GroupcastClientConstructor = ClientBehavior(Groupcast);
+const GroupcastClient = GroupcastClientConstructor;
+export {
+  GroupcastClient,
+  GroupcastClientConstructor
+};
+//# sourceMappingURL=GroupcastClient.js.map

package/dist/esm/behaviors/groupcast/GroupcastClient.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/behaviors/groupcast/GroupcastClient.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAQA,SAAS,iBAAiB;AAC1B,SAAS,sBAAsB;AAGxB,MAAM,6BAA6B,eAAe,SAAS;AAG3D,MAAM,kBAA8C;",
+  "names": []
+}

package/dist/esm/behaviors/groupcast/GroupcastInterface.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/*** THIS FILE IS GENERATED, DO NOT EDIT ***/
+import { MaybePromise } from "@matter/general";
+import { Groupcast } from "@matter/types/clusters/groupcast";
+export declare namespace GroupcastInterface {
+    interface Base {
+        joinGroup(request: Groupcast.JoinGroupRequest): MaybePromise;
+        leaveGroup(request: Groupcast.LeaveGroupRequest): MaybePromise<Groupcast.LeaveGroupResponse>;
+        updateGroupKey(request: Groupcast.UpdateGroupKeyRequest): MaybePromise;
+        groupcastTesting(request: Groupcast.GroupcastTestingRequest): MaybePromise;
+    }
+    interface Listener {
+        configureAuxiliaryAcl(request: Groupcast.ConfigureAuxiliaryAclRequest): MaybePromise;
+    }
+}
+export type GroupcastInterface = {
+    components: [
+        {
+            flags: {};
+            methods: GroupcastInterface.Base;
+        },
+        {
+            flags: {
+                listener: true;
+            };
+            methods: GroupcastInterface.Listener;
+        }
+    ];
+};
+//# sourceMappingURL=GroupcastInterface.d.ts.map

package/dist/esm/behaviors/groupcast/GroupcastInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupcastInterface.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/groupcast/GroupcastInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,6CAA6C;AAE7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAE7D,yBAAiB,kBAAkB,CAAC,CAAC;IACjC,UAAiB,IAAI;QACjB,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,gBAAgB,GAAG,YAAY,CAAC;QAC7D,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,iBAAiB,GAAG,YAAY,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC;QAC7F,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,qBAAqB,GAAG,YAAY,CAAC;QACvE,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,uBAAuB,GAAG,YAAY,CAAC;KAC9E;IAED,UAAiB,QAAQ;QACrB,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,4BAA4B,GAAG,YAAY,CAAC;KACxF;CACJ;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC7B,UAAU,EAAE;QACR;YAAE,KAAK,EAAE,EAAE,CAAC;YAAC,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAA;SAAE;QAC/C;YAAE,KAAK,EAAE;gBAAE,QAAQ,EAAE,IAAI,CAAA;aAAE,CAAC;YAAC,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAA;SAAE;KACtE,CAAA;CACJ,CAAC"}

package/dist/esm/behaviors/groupcast/GroupcastInterface.js

@@ -0,0 +1,6 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=GroupcastInterface.js.map

package/dist/esm/behaviors/groupcast/GroupcastInterface.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/behaviors/groupcast/GroupcastInterface.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;",
+  "names": []
+}

package/dist/esm/behaviors/groupcast/GroupcastServer.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license
+ * Copyright 2022-2026 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AccessControlServer } from "#behaviors/access-control";
+import { GroupMessageEventInfo } from "@matter/protocol";
+import { Groupcast } from "@matter/types/clusters/groupcast";
+import { GroupcastBehavior } from "./GroupcastBehavior.js";
+/**
+ * This is the default server implementation of {@link GroupcastBehavior}.
+ *
+ * The Groupcast cluster is node-scoped and must be placed on the root endpoint.
+ * Use {@link GroupcastServer.with} to enable the desired features (e.g. "Listener", "Sender").
+ *
+ * Key behaviors:
+ * - Manages per-fabric group membership (persistent).
+ * - Drives {@link FabricGroups} with group-to-key-set mappings and multicast address policy.
+ * - Registers an {@link AccessControlServer.AuxAclObservable} to supply synthetic ACL entries for groups
+ *   with `hasAuxiliaryAcl=true`. AccessControlServer calls back to collect entries when needed.
+ * - On first use by a fabric, marks the fabric as "GroupcastAdopted" in GKM, making GroupKeyMap read-only.
+ * - Migrates legacy group data from the Groups cluster on startup.
+ */
+export declare class GroupcastServer extends GroupcastBehavior {
+    #private;
+    internal: GroupcastServer.Internal;
+    initialize(): void;
+    joinGroup(request: Groupcast.JoinGroupRequest): Promise<void>;
+    leaveGroup(request: Groupcast.LeaveGroupRequest): Groupcast.LeaveGroupResponse;
+    updateGroupKey(request: Groupcast.UpdateGroupKeyRequest): Promise<void>;
+    configureAuxiliaryAcl(request: Groupcast.ConfigureAuxiliaryAclRequest): void;
+    groupcastTesting(request: Groupcast.GroupcastTestingRequest): void;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+export declare namespace GroupcastServer {
+    /** Non-persistent internal state for GroupcastServer. */
+    class Internal {
+        /**
+         * Observable that holds all auxiliary ACL entries supplied by this cluster.
+         * AccessControlServer subscribes to this and rebuilds its ACL cache whenever it emits.
+         */
+        auxAcl: AccessControlServer.AuxAclObservable;
+        /** Active subscription handler on SessionManager.groupMessage while fabricUnderTest is set. */
+        groupMessageHandler?: (info: GroupMessageEventInfo) => void;
+    }
+    /** Default state overrides for GroupcastServer. */
+    class State extends GroupcastBehavior.State {
+        /**
+         * Implementation-defined maximum membership count (min 10 per spec).
+         * Set to 2 * GKM.maxGroupsPerFabric (44) so per-fabric quota floor(44/2)=22 aligns exactly
+         * with GKM's per-fabric cap. Even number avoids spillover semantics.
+         */
+        maxMembershipCount: number;
+        /** Implementation-defined maximum multicast address count (min 1 per spec). */
+        maxMcastAddrCount: number;
+    }
+}
+//# sourceMappingURL=GroupcastServer.d.ts.map

package/dist/esm/behaviors/groupcast/GroupcastServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupcastServer.d.ts","sourceRoot":"","sources":["../../../../src/behaviors/groupcast/GroupcastServer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAKhE,OAAO,EAKH,qBAAqB,EAExB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAU3D;;;;;;;;;;;;;GAaG;AACH,qBAAa,eAAgB,SAAQ,iBAAiB;;IAC1C,QAAQ,EAAE,eAAe,CAAC,QAAQ,CAAC;IAKlC,UAAU,SAUlB;IA8Dc,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,gBAAgB,iBAyG3D;IAEQ,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,iBAAiB,GAAG,SAAS,CAAC,kBAAkB,CAyDtF;IAEc,cAAc,CAAC,OAAO,EAAE,SAAS,CAAC,qBAAqB,iBAsBrE;IAED,qBAAqB,CAAC,OAAO,EAAE,SAAS,CAAC,4BAA4B,QAepE;IAEQ,gBAAgB,CAAC,OAAO,EAAE,SAAS,CAAC,uBAAuB,QA4BnE;IAiRc,CAAC,MAAM,CAAC,YAAY,CAAC,kBAKnC;CACJ;AAED,yBAAiB,eAAe,CAAC,CAAC;IAC9B,yDAAyD;IACzD,MAAa,QAAQ;QACjB;;;WAGG;QACH,MAAM,EAAE,mBAAmB,CAAC,gBAAgB,CAAuB;QAEnE,+FAA+F;QAC/F,mBAAmB,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,IAAI,CAAC;KAC/D;IAED,mDAAmD;IACnD,MAAa,KAAM,SAAQ,iBAAiB,CAAC,KAAK;QAC9C;;;;WAIG;QACM,kBAAkB,SAAM;QACjC,+EAA+E;QACtE,iBAAiB,SAAM;KACnC;CACJ"}