homebridge 2.0.0-beta.44 → 2.0.0-beta.46

package/dist/matter/ClusterCommandMapper.js

@@ -0,0 +1,203 @@
+const CLUSTER_COMMAND_MAPPINGS = {
+    onOff: {
+        map: (attributes) => {
+            if ('onOff' in attributes) {
+                return {
+                    command: attributes.onOff ? 'on' : 'off',
+                };
+            }
+            return null;
+        },
+    },
+    levelControl: {
+        map: (attributes) => {
+            if ('currentLevel' in attributes) {
+                return {
+                    command: 'moveToLevel',
+                    args: { level: attributes.currentLevel },
+                };
+            }
+            return null;
+        },
+    },
+    colorControl: {
+        map: (attributes) => {
+            if ('colorTemperatureMireds' in attributes) {
+                return {
+                    command: 'moveToColorTemperature',
+                    args: {
+                        colorTemperatureMireds: attributes.colorTemperatureMireds,
+                        transitionTime: attributes.transitionTime ?? null,
+                    },
+                };
+            }
+            if ('colorX' in attributes && 'colorY' in attributes) {
+                return {
+                    command: 'moveToColor',
+                    args: {
+                        colorX: attributes.colorX,
+                        colorY: attributes.colorY,
+                        transitionTime: attributes.transitionTime ?? null,
+                    },
+                };
+            }
+            if ('currentHue' in attributes || 'currentSaturation' in attributes) {
+                return {
+                    command: 'moveToHueAndSaturation',
+                    args: {
+                        hue: attributes.currentHue ?? 0,
+                        saturation: attributes.currentSaturation ?? 0,
+                        transitionTime: attributes.transitionTime ?? null,
+                    },
+                };
+            }
+            return null;
+        },
+    },
+    fanControl: {
+        map: (attributes) => {
+            if ('_command' in attributes && attributes._command === 'step') {
+                return {
+                    command: 'step',
+                    args: {
+                        direction: attributes.direction ?? 0,
+                        wrap: attributes.wrap ?? false,
+                        lowestOff: attributes.lowestOff ?? true,
+                    },
+                };
+            }
+            if ('fanMode' in attributes) {
+                return null;
+            }
+            if ('percentSetting' in attributes) {
+                return null;
+            }
+            return null;
+        },
+    },
+    windowCovering: {
+        map: (attributes) => {
+            if ('_command' in attributes) {
+                const cmd = attributes._command;
+                if (cmd === 'upOrOpen' || cmd === 'downOrClose' || cmd === 'stopMotion') {
+                    return { command: cmd };
+                }
+            }
+            if ('targetPositionLiftPercent100ths' in attributes) {
+                return {
+                    command: 'goToLiftPercentage',
+                    args: {
+                        liftPercent100thsValue: attributes.targetPositionLiftPercent100ths,
+                    },
+                };
+            }
+            if ('targetPositionTiltPercent100ths' in attributes) {
+                return {
+                    command: 'goToTiltPercentage',
+                    args: {
+                        tiltPercent100thsValue: attributes.targetPositionTiltPercent100ths,
+                    },
+                };
+            }
+            return null;
+        },
+    },
+    doorLock: {
+        map: (attributes) => {
+            if ('_command' in attributes) {
+                const cmd = attributes._command;
+                if (cmd === 'lockDoor' || cmd === 'unlockDoor') {
+                    return { command: cmd };
+                }
+            }
+            if ('lockState' in attributes) {
+                return {
+                    command: attributes.lockState === 1 ? 'lockDoor' : 'unlockDoor',
+                };
+            }
+            return null;
+        },
+    },
+    thermostat: {
+        map: (attributes) => {
+            if ('_command' in attributes && attributes._command === 'setpointRaiseLower') {
+                return {
+                    command: 'setpointRaiseLower',
+                    args: {
+                        mode: attributes.mode ?? 0,
+                        amount: attributes.amount ?? 10,
+                    },
+                };
+            }
+            if ('systemMode' in attributes) {
+                return null;
+            }
+            if ('occupiedHeatingSetpoint' in attributes) {
+                return null;
+            }
+            if ('occupiedCoolingSetpoint' in attributes) {
+                return null;
+            }
+            return null;
+        },
+    },
+    rvcOperationalState: {
+        map: (attributes) => {
+            if ('_command' in attributes) {
+                return { command: attributes._command };
+            }
+            return null;
+        },
+    },
+    rvcRunMode: {
+        map: (attributes) => {
+            if ('currentMode' in attributes) {
+                return {
+                    command: 'changeToMode',
+                    args: { newMode: attributes.currentMode },
+                };
+            }
+            return null;
+        },
+    },
+    rvcCleanMode: {
+        map: (attributes) => {
+            if ('currentMode' in attributes) {
+                return {
+                    command: 'changeToMode',
+                    args: { newMode: attributes.currentMode },
+                };
+            }
+            return null;
+        },
+    },
+    serviceArea: {
+        map: (attributes) => {
+            if ('selectedAreas' in attributes && Array.isArray(attributes.selectedAreas)) {
+                return {
+                    command: 'selectAreas',
+                    args: { newAreas: attributes.selectedAreas },
+                };
+            }
+            if ('skipArea' in attributes) {
+                return {
+                    command: 'skipArea',
+                    args: { skippedArea: attributes.skipArea },
+                };
+            }
+            return null;
+        },
+    },
+};
+export function mapAttributesToCommand(cluster, attributes) {
+    const mapping = CLUSTER_COMMAND_MAPPINGS[cluster];
+    if (!mapping) {
+        throw new Error(`Command mapping not implemented for cluster: ${cluster}`);
+    }
+    const result = mapping.map(attributes);
+    if (result === null) {
+        return null;
+    }
+    return result;
+}
+//# sourceMappingURL=ClusterCommandMapper.js.map

package/dist/matter/ClusterCommandMapper.js.map

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

package/dist/matter/ExternalMatterAccessoryPublisher.d.ts

@@ -1,33 +1,15 @@
-/**
- * External Matter Accessory Publisher
- *
- * Shared logic for publishing external Matter accessories on dedicated bridges.
- * Used by both MatterBridgeManager and ChildBridgeMatterManager to avoid code duplication.
- */
 import type { InternalMatterAccessory } from './types.js';
 import { MatterServer } from './server.js';
-/**
- * Configuration context for publishing external Matter accessories
- */
 export interface ExternalAccessoryPublishContext {
-    /** Port service for allocating Matter ports */
     portService: {
         requestMatterPort: (uniqueId: string) => Promise<number | null | undefined>;
     };
-    /** Network interfaces to bind to (from bridge config) */
     networkInterfaces?: string[];
-    /** Whether debug mode is enabled */
     debugModeEnabled?: boolean;
 }
-/**
- * Result of publishing an external Matter accessory
- */
 export interface PublishedExternalAccessory {
-    /** The MatterServer instance for this accessory */
     server: MatterServer;
-    /** Port the server is running on */
     port: number;
-    /** Commissioning information */
     commissioningInfo: {
         qrCode?: string;
         manualPairingCode?: string;
@@ -35,14 +17,5 @@ export interface PublishedExternalAccessory {
         commissioned: boolean;
     };
 }
-/**
- * Publish an external Matter accessory on its own dedicated Matter server.
- * This is required for devices like Robotic Vacuum Cleaners that Apple Home
- * requires to be on their own bridge.
- *
- * @param accessory - The Matter accessory to publish
- * @param context - Configuration context for publishing
- * @returns Published accessory info, or null if publishing failed
- */
 export declare function publishExternalMatterAccessory(accessory: InternalMatterAccessory, context: ExternalAccessoryPublishContext): Promise<PublishedExternalAccessory | null>;
 //# sourceMappingURL=ExternalMatterAccessoryPublisher.d.ts.map

package/dist/matter/ExternalMatterAccessoryPublisher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExternalMatterAccessoryPublisher.d.ts","sourceRoot":"","sources":["../../src/matter/ExternalMatterAccessoryPublisher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAKzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAI1C;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C,+CAA+C;IAC/C,WAAW,EAAE;QACX,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;KAC5E,CAAA;IACD,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,mDAAmD;IACnD,MAAM,EAAE,YAAY,CAAA;IACpB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,gCAAgC;IAChC,iBAAiB,EAAE;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,YAAY,EAAE,OAAO,CAAA;KACtB,CAAA;CACF;AAED;;;;;;;;GAQG;AACH,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,uBAAuB,EAClC,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAgE5C"}
+{"version":3,"file":"ExternalMatterAccessoryPublisher.d.ts","sourceRoot":"","sources":["../../src/matter/ExternalMatterAccessoryPublisher.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAKzD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAO1C,MAAM,WAAW,+BAA+B;IAE9C,WAAW,EAAE;QACX,iBAAiB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;KAC5E,CAAA;IAED,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE5B,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAC3B;AAKD,MAAM,WAAW,0BAA0B;IAEzC,MAAM,EAAE,YAAY,CAAA;IAEpB,IAAI,EAAE,MAAM,CAAA;IAEZ,iBAAiB,EAAE;QACjB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,YAAY,EAAE,OAAO,CAAA;KACtB,CAAA;CACF;AAWD,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,uBAAuB,EAClC,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,0BAA0B,GAAG,IAAI,CAAC,CAgE5C"}

package/dist/matter/ExternalMatterAccessoryPublisher.js

@@ -1,25 +1,9 @@
-/**
- * External Matter Accessory Publisher
- *
- * Shared logic for publishing external Matter accessories on dedicated bridges.
- * Used by both MatterBridgeManager and ChildBridgeMatterManager to avoid code duplication.
- */
 import { Logger } from '../logger.js';
 import { User } from '../user.js';
 import { generate } from '../util/mac.js';
 import { MatterServer } from './server.js';
-const log = Logger.internal;
-/**
- * Publish an external Matter accessory on its own dedicated Matter server.
- * This is required for devices like Robotic Vacuum Cleaners that Apple Home
- * requires to be on their own bridge.
- *
- * @param accessory - The Matter accessory to publish
- * @param context - Configuration context for publishing
- * @returns Published accessory info, or null if publishing failed
- */
+const log = Logger.withPrefix('Matter/External');
 export async function publishExternalMatterAccessory(accessory, context) {
-    // Validate accessory has required fields
     if (!accessory.uuid) {
         log.error('External Matter accessory missing UUID - skipping');
         return null;
@@ -28,11 +12,8 @@ export async function publishExternalMatterAccessory(accessory, context) {
         log.error(`External Matter accessory ${accessory.uuid} missing displayName - skipping`);
         return null;
     }
-    // Generate deterministic MAC address from UUID (same pattern as HAP external accessories)
     const advertiseAddress = generate(accessory.uuid);
-    // For Matter, use the MAC without colons as uniqueId
     const uniqueId = advertiseAddress.replace(/:/g, '');
-    // Allocate Matter port for the external Matter server
     const port = await context.portService.requestMatterPort(uniqueId);
     if (!port) {
         log.error(`Failed to allocate Matter port for external Matter accessory ${accessory.displayName}`);
@@ -40,7 +21,6 @@ export async function publishExternalMatterAccessory(accessory, context) {
         return null;
     }
     log.info(`Allocated port ${port} for external Matter accessory: ${accessory.displayName}`);
-    // Create dedicated Matter server for this accessory
     const matterServer = new MatterServer({
         port,
         uniqueId,
@@ -48,21 +28,16 @@ export async function publishExternalMatterAccessory(accessory, context) {
         manufacturer: accessory.manufacturer,
         model: accessory.model,
         firmwareRevision: accessory.firmwareRevision,
-        serialNumber: accessory.serialNumber || uniqueId, // use uniqueId as fallback serial number
+        serialNumber: accessory.serialNumber || uniqueId,
         debugModeEnabled: context.debugModeEnabled,
-        externalAccessory: true, // external accessory, added before server runs
+        externalAccessory: true,
         networkInterfaces: context.networkInterfaces,
     });
-    // Start the Matter server (but don't run it yet due to externalAccessory mode)
     await matterServer.start();
-    // Get plugin identifier from accessory
     const pluginIdentifier = accessory._associatedPlugin || 'unknown';
-    // Register the accessory to this dedicated server
     await matterServer.registerPlatformAccessories(pluginIdentifier, 'ExternalMatter', [accessory]);
-    // Now run the server with the device already attached (required for external accessories)
     await matterServer.runServer();
     log.info(`✓ External Matter accessory published: ${accessory.displayName} on port ${port}`);
-    // Get commissioning info
     const commissioningInfo = matterServer.getCommissioningInfo();
     return {
         server: matterServer,

package/dist/matter/ExternalMatterAccessoryPublisher.js.map

@@ -1 +1 @@
-{"version":3,"file":"ExternalMatterAccessoryPublisher.js","sourceRoot":"","sources":["../../src/matter/ExternalMatterAccessoryPublisher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAA;AAiC3B;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,SAAkC,EAClC,OAAwC;IAExC,yCAAyC;IACzC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpB,GAAG,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,CAAC,6BAA6B,SAAS,CAAC,IAAI,iCAAiC,CAAC,CAAA;QACvF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,0FAA0F;IAC1F,MAAM,gBAAgB,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAEjD,qDAAqD;IACrD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAEnD,sDAAsD;IACtD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAClE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,GAAG,CAAC,KAAK,CAAC,gEAAgE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAA;QAClG,GAAG,CAAC,KAAK,CAAC,+FAA+F,CAAC,CAAA;QAC1G,OAAO,IAAI,CAAA;IACb,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,mCAAmC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAA;IAE1F,oDAAoD;IACpD,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;QACpC,IAAI;QACJ,QAAQ;QACR,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE;QAC9B,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;QAC5C,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,QAAQ,EAAE,yCAAyC;QAC3F,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,iBAAiB,EAAE,IAAI,EAAE,+CAA+C;QACxE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC7C,CAAC,CAAA;IAEF,+EAA+E;IAC/E,MAAM,YAAY,CAAC,KAAK,EAAE,CAAA;IAE1B,uCAAuC;IACvC,MAAM,gBAAgB,GAAG,SAAS,CAAC,iBAAiB,IAAI,SAAS,CAAA;IAEjE,kDAAkD;IAClD,MAAM,YAAY,CAAC,2BAA2B,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IAE/F,0FAA0F;IAC1F,MAAM,YAAY,CAAC,SAAS,EAAE,CAAA;IAE9B,GAAG,CAAC,IAAI,CAAC,0CAA0C,SAAS,CAAC,WAAW,YAAY,IAAI,EAAE,CAAC,CAAA;IAE3F,yBAAyB;IACzB,MAAM,iBAAiB,GAAG,YAAY,CAAC,oBAAoB,EAAE,CAAA;IAE7D,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,IAAI;QACJ,iBAAiB;KAClB,CAAA;AACH,CAAC"}
+{"version":3,"file":"ExternalMatterAccessoryPublisher.js","sourceRoot":"","sources":["../../src/matter/ExternalMatterAccessoryPublisher.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,GAAG,GAAG,MAAM,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAA;AA0ChD,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,SAAkC,EAClC,OAAwC;IAGxC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;QACpB,GAAG,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAA;QAC9D,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,CAAC,6BAA6B,SAAS,CAAC,IAAI,iCAAiC,CAAC,CAAA;QACvF,OAAO,IAAI,CAAA;IACb,CAAC;IAGD,MAAM,gBAAgB,GAAG,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAA;IAGjD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;IAGnD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,WAAW,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAA;IAClE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,GAAG,CAAC,KAAK,CAAC,gEAAgE,SAAS,CAAC,WAAW,EAAE,CAAC,CAAA;QAClG,GAAG,CAAC,KAAK,CAAC,+FAA+F,CAAC,CAAA;QAC1G,OAAO,IAAI,CAAA;IACb,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,mCAAmC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAA;IAG1F,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC;QACpC,IAAI;QACJ,QAAQ;QACR,WAAW,EAAE,IAAI,CAAC,UAAU,EAAE;QAC9B,YAAY,EAAE,SAAS,CAAC,YAAY;QACpC,KAAK,EAAE,SAAS,CAAC,KAAK;QACtB,gBAAgB,EAAE,SAAS,CAAC,gBAAgB;QAC5C,YAAY,EAAE,SAAS,CAAC,YAAY,IAAI,QAAQ;QAChD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,iBAAiB,EAAE,IAAI;QACvB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC7C,CAAC,CAAA;IAGF,MAAM,YAAY,CAAC,KAAK,EAAE,CAAA;IAG1B,MAAM,gBAAgB,GAAG,SAAS,CAAC,iBAAiB,IAAI,SAAS,CAAA;IAGjE,MAAM,YAAY,CAAC,2BAA2B,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,CAAC,SAAS,CAAC,CAAC,CAAA;IAG/F,MAAM,YAAY,CAAC,SAAS,EAAE,CAAA;IAE9B,GAAG,CAAC,IAAI,CAAC,0CAA0C,SAAS,CAAC,WAAW,YAAY,IAAI,EAAE,CAAC,CAAA;IAG3F,MAAM,iBAAiB,GAAG,YAAY,CAAC,oBAAoB,EAAE,CAAA;IAE7D,OAAO;QACL,MAAM,EAAE,YAAY;QACpB,IAAI;QACJ,iBAAiB;KAClB,CAAA;AACH,CAAC"}

package/dist/matter/MatterAPIImpl.d.ts

@@ -1,49 +1,13 @@
-/**
- * Matter API Implementation
- *
- * This class implements the Matter API facade, keeping Matter-specific logic
- * separate from the core HomebridgeAPI class.
- *
- * Benefits:
- * - Reduces changes to core api.ts file
- * - Lazy-loads Matter code only when used
- * - Clear separation between HAP and Matter
- * - Easier to test in isolation
- * - Validates accessories before registration
- * - Provides detailed error messages for debugging
- */
 import type { EndpointType } from '@matter/main';
 import type { HomebridgeAPI, MatterAPI, PlatformName, PluginIdentifier } from '../api.js';
 import { clusters, MatterAccessory } from './index.js';
-/**
- * Implementation of the Matter API
- * Delegates to the HomebridgeAPI instance for event emission and server access
- * Provides validation and coordination for Matter accessory operations
- */
 export declare class MatterAPIImpl implements MatterAPI {
     private readonly api;
     constructor(api: HomebridgeAPI);
-    /**
-     * Validate a Matter accessory has required fields
-     * @throws MatterAccessoryValidationError if validation fails
-     */
     private validateAccessory;
-    /**
-     * Validate an array of accessories, logging errors for invalid ones
-     * @returns Array of valid accessories only
-     */
     private validateAccessories;
-    /**
-     * Validate cluster name is valid
-     */
     private validateClusterName;
-    /**
-     * UUID generator (alias of api.hap.uuid for convenience)
-     */
     get uuid(): typeof import("hap-nodejs/dist/lib/util/uuid.js");
-    /**
-     * Matter device types for creating accessories
-     */
     get deviceTypes(): {
         readonly OnOffLight: import("@matter/node/devices").OnOffLightDevice;
         readonly DimmableLight: import("@matter/node/devices").DimmableLightDevice;
@@ -439,13 +403,7 @@ export declare class MatterAPIImpl implements MatterAPI {
         readonly Pump: import("@matter/node/devices").PumpDevice;
         readonly RoomAirConditioner: import("@matter/node/devices").RoomAirConditionerDevice;
     };
-    /**
-     * Matter clusters - Direct access to Matter.js cluster definitions
-     */
     get clusters(): typeof clusters;
-    /**
-     * Matter cluster names for type safety and autocomplete
-     */
     get clusterNames(): {
         readonly OnOff: "onOff";
         readonly LevelControl: "levelControl";
@@ -475,37 +433,11 @@ export declare class MatterAPIImpl implements MatterAPI {
         readonly BasicInformation: "basicInformation";
         readonly BridgedDeviceBasicInformation: "bridgedDeviceBasicInformation";
     };
-    /**
-     * Matter types - Access to Matter.js cluster type definitions and enums
-     */
     get types(): typeof clusters;
-    /**
-     * Register Matter platform accessories
-     * Automatically handles external accessories (e.g., RoboticVacuumCleaner) that need dedicated bridges
-     * Validates accessories before registration
-     * Returns a promise that resolves when all accessories are fully registered
-     */
     registerPlatformAccessories(pluginIdentifier: PluginIdentifier, platformName: PlatformName, accessories: MatterAccessory[]): Promise<void>;
-    /**
-     * Update Matter platform accessories in the cache
-     * Similar to api.updatePlatformAccessories() for HAP accessories
-     */
     updatePlatformAccessories(accessories: MatterAccessory[]): Promise<void>;
-    /**
-     * Unregister Matter platform accessories
-     * Automatically handles external accessories (e.g., RoboticVacuumCleaner) that have dedicated bridges
-     */
     unregisterPlatformAccessories(pluginIdentifier: PluginIdentifier, platformName: PlatformName, accessories: MatterAccessory[]): Promise<void>;
-    /**
-     * Update a Matter accessory's cluster state
-     * Validates inputs before updating
-     */
     updateAccessoryState(uuid: string, cluster: string, attributes: Record<string, unknown>, partId?: string): Promise<void>;
-    /**
-     * Get a Matter accessory's current cluster state
-     * Checks both external servers and main bridge server
-     * Validates inputs before retrieving state
-     */
     getAccessoryState(uuid: string, cluster: string, partId?: string): Promise<Record<string, unknown> | undefined>;
 }
 //# sourceMappingURL=MatterAPIImpl.d.ts.map

package/dist/matter/MatterAPIImpl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MatterAPIImpl.d.ts","sourceRoot":"","sources":["../../src/matter/MatterAPIImpl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAKzF,OAAO,EAAgB,QAAQ,EAAe,eAAe,EAA6B,MAAM,YAAY,CAAA;AA8B5G;;;;GAIG;AACH,qBAAa,aAAc,YAAW,SAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAE/C;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAW3B;;OAEG;IACH,IAAI,IAAI,sDAEP;IAED;;OAEG;IACH,IAAI,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uFA+P++9B,uBAAuB;;4EAAmL,uBAAuB;;;;;;;;;;4EAAkpB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;yFAAwwC,uBAAuB;;8EAAuL,uBAAuB;;;oFAAwO,uBAAuB;;;;;;;;;;;;;wFAAk2B,uBAAuB;;;;;;;;;;8EAAymB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA7P5mmC;IAED;;OAEG;IACH,IAAI,QAAQ,oBAEX;IAED;;OAEG;IACH,IAAI,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEf;IAED;;OAEG;IACH,IAAI,KAAK,oBAER;IAED;;;;;OAKG;IACG,2BAA2B,CAC/B,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,eAAe,EAAE,GAC7B,OAAO,CAAC,IAAI,CAAC;IA8EhB;;;OAGG;IACG,yBAAyB,CAAC,WAAW,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9E;;;OAGG;IACG,6BAA6B,CACjC,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,eAAe,EAAE,GAC7B,OAAO,CAAC,IAAI,CAAC;IAmChB;;;OAGG;IACG,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IA2BhB;;;;OAIG;IACG,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAqChD"}
+{"version":3,"file":"MatterAPIImpl.d.ts","sourceRoot":"","sources":["../../src/matter/MatterAPIImpl.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAKzF,OAAO,EAAgB,QAAQ,EAAe,eAAe,EAA6B,MAAM,YAAY,CAAA;AAmC5G,qBAAa,aAAc,YAAW,SAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,aAAa;IAM/C,OAAO,CAAC,iBAAiB;IAgDzB,OAAO,CAAC,mBAAmB;IAuB3B,OAAO,CAAC,mBAAmB;IAc3B,IAAI,IAAI,sDAEP;IAKD,IAAI,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uFAgQg59B,uBAAuB;;4EAAmL,uBAAuB;;;;;;;;;;4EAAkpB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;yFAAwwC,uBAAuB;;8EAAuL,uBAAuB;;;oFAAwO,uBAAuB;;;;;;;;;;;;;wFAAk2B,uBAAuB;;;;;;;;;;8EAAymB,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA9P7gmC;IAKD,IAAI,QAAQ,oBAEX;IAKD,IAAI,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAEf;IAKD,IAAI,KAAK,oBAER;IAQK,2BAA2B,CAC/B,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,eAAe,EAAE,GAC7B,OAAO,CAAC,IAAI,CAAC;IAkFV,yBAAyB,CAAC,WAAW,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBxE,6BAA6B,CACjC,gBAAgB,EAAE,gBAAgB,EAClC,YAAY,EAAE,YAAY,EAC1B,WAAW,EAAE,eAAe,EAAE,GAC7B,OAAO,CAAC,IAAI,CAAC;IAuCV,oBAAoB,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnC,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;IAiCV,iBAAiB,CACrB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;CAqChD"}