homebridge 2.0.0-beta.35 → 2.0.0-beta.36

package/dist/matter/{matterServer.d.ts → MatterAPIImpl.d.ts}

@@ -1,324 +1,120 @@
 /**
- * Matter.js Server Implementation for Homebridge Plugin API
+ * Matter API Implementation
  *
- * This provides a Matter bridge that plugins can use to register
- * Matter accessories via the Homebridge API.
+ * 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 { SerializedMatterAccessory } from './matterAccessoryCache.js';
-import { EventEmitter } from 'node:events';
-import * as clusters from '@matter/main/clusters';
-import * as devices from '@matter/main/devices';
-import { MatterServerConfig } from './matterSharedTypes.js';
-import { MatterAccessory, MatterServerEvents } from './matterTypes.js';
-export { MatterServerConfig } from './matterSharedTypes.js';
+import type { HomebridgeAPI, MatterAPI, PlatformName, PluginIdentifier } from '../api.js';
+import { clusters, MatterAccessory } from './index.js';
 /**
- * Matter Server for Homebridge Plugin API
- * Allows plugins to register Matter accessories explicitly
- *
- * Extends EventEmitter to provide commissioning lifecycle events
+ * 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 MatterServer extends EventEmitter {
-    on: <K extends keyof MatterServerEvents>(event: K, listener: MatterServerEvents[K]) => this;
-    emit: <K extends keyof MatterServerEvents>(event: K, ...args: Parameters<MatterServerEvents[K]>) => boolean;
-    removeListener: <K extends keyof MatterServerEvents>(event: K, listener: MatterServerEvents[K]) => this;
-    removeAllListeners: (event?: keyof MatterServerEvents) => this;
-    private readonly config;
-    private serverNode;
-    private aggregator;
-    private accessories;
-    private isRunning;
-    private readonly MAX_DEVICES;
-    private shutdownHandler;
-    private passcode;
-    private discriminator;
-    private readonly vendorId;
-    private readonly productId;
-    private commissioningInfo;
-    private serialNumber?;
-    private cleanupHandlers;
-    private storageManager;
-    private matterStoragePath?;
-    private accessoryCache;
-    private fabricMonitorInterval;
-    private previousFabrics;
-    constructor(config: MatterServerConfig);
-    /**
-     * Validate and sanitize Matter server configuration
-     * Throws descriptive errors if configuration is invalid
-     */
-    private validateAndSanitizeConfig;
-    /**
-     * Generate a secure random passcode
-     * According to Matter spec, passcode must be:
-     * - 8 digits (00000001 to 99999998)
-     * - Not in the invalid list
-     * - Not sequential or repeating patterns
-     */
-    private generateSecurePasscode;
-    /**
-     * Validate a passcode according to Matter specifications
-     */
-    private isValidPasscode;
-    /**
-     * Generate a random discriminator
-     * According to Matter spec, discriminator must be:
-     * - 12 bits (0-4095)
-     * - Should be random for security
-     */
-    private generateRandomDiscriminator;
-    /**
-     * Create ServerNode with automatic recovery from corrupted storage
-     *
-     * Matter.js can fail to start if fabric data is corrupted (common after
-     * hard shutdowns or disk errors). This method implements automatic recovery by:
-     *
-     * 1. Attempting normal ServerNode creation
-     * 2. If it fails with storage errors, identifying and removing corrupted files
-     * 3. Retrying ServerNode creation with fresh storage
-     *
-     * This prevents the need for manual intervention while preserving data
-     * safety by only removing storage on confirmed corruption errors.
-     *
-     * @param nodeOptions - Matter.js ServerNode configuration
-     * @param sanitizedId - Filesystem-safe bridge identifier
-     * @returns Initialized ServerNode instance
-     * @throws Error if recovery fails or error is not storage-related
-     */
-    private createServerNodeWithRecovery;
-    /**
-     * Start the Matter server
-     */
-    start(): Promise<void>;
-    /**
-     * Run the server after devices have been added (for external accessory mode)
-     * This must be called after registerPlatformAccessories() when using externalAccessory mode
-     */
-    runServer(): Promise<void>;
-    /**
-     * Set up and validate storage
-     */
-    private setupStorage;
-    /**
-     * Load or generate commissioning credentials (passcode and discriminator)
-     * These must be persistent across restarts to maintain the same QR code
-     */
-    private loadOrGenerateCredentials;
-    /**
-     * Generate and display commissioning information
-     */
-    private generateCommissioningInfo;
-    /**
-     * Wait for the server to be ready
-     */
-    private waitForServerReady;
-    /**
-     * Start monitoring fabric changes to emit commissioning events
-     */
-    private startFabricMonitoring;
-    /**
-     * Stop fabric monitoring
-     */
-    private stopFabricMonitoring;
-    /**
-     * Check for fabric changes and emit appropriate events
-     */
-    private checkFabricChanges;
-    /**
-     * Update commissioning info file when commissioning state changes
-     */
-    private updateCommissioningFile;
-    /**
-     * Register Matter platform accessories (Plugin API - matches HAP pattern)
-     */
-    registerPlatformAccessories(pluginIdentifier: string, platformName: string, accessories: MatterAccessory[]): Promise<void>;
-    /**
-     * Unregister Matter platform accessories (Plugin API - matches HAP pattern)
-     */
-    unregisterPlatformAccessories(pluginIdentifier: string, platformName: string, accessories: MatterAccessory[]): Promise<void>;
-    /**
-     * Register a single Matter accessory (internal method)
-     */
-    private registerAccessory;
-    /**
-     * Unregister a Matter accessory (Plugin API)
-     */
-    unregisterAccessory(uuid: string): Promise<void>;
-    /**
-     * Update a Matter accessory's state (Plugin API)
-     *
-     * This method can be called from anywhere, including from within handlers.
-     * State updates are automatically deferred to avoid transaction conflicts.
-     *
-     * @param uuid - The UUID of the accessory
-     * @param cluster - The cluster name
-     * @param attributes - The attributes to update
-     * @param partId - Optional: ID of the part to update (for composed devices)
-     */
-    updateAccessoryState(uuid: string, cluster: string, attributes: Record<string, unknown>, partId?: string): Promise<void>;
-    /**
-     * Get a Matter accessory's current state (Plugin API)
-     *
-     * Returns the current cluster attribute values that are exposed to Matter controllers.
-     * This is useful for:
-     * - Reading state after plugin restart (when local variables are lost)
-     * - Verifying current state before making changes
-     * - Multiple parts of code that need to read state
-     * - Debugging and logging
-     *
-     * @param uuid - The UUID of the accessory
-     * @param cluster - The cluster name (e.g., 'onOff', 'levelControl')
-     * @param partId - Optional: ID of the part to get state from (for composed devices)
-     * @returns Current cluster attribute values, or undefined if cluster not found
-     */
-    getAccessoryState(uuid: string, cluster: string, partId?: string): Record<string, unknown> | undefined;
-    /**
-     * Get all cached accessories (Internal - for restore process)
-     * @internal
-     */
-    getAllCachedAccessories(): SerializedMatterAccessory[];
-    /**
-     * Get all registered accessories (Plugin API)
-     */
-    getAccessories(): MatterAccessory[];
-    /**
-     * Get a specific accessory by UUID (Plugin API)
-     */
-    getAccessory(uuid: string): MatterAccessory | undefined;
-    /**
-     * Stop the Matter server
-     */
-    stop(): Promise<void>;
+export declare class MatterAPIImpl implements MatterAPI {
+    private readonly api;
+    constructor(api: HomebridgeAPI);
     /**
-     * Cleanup resources
+     * Validate a Matter accessory has required fields
+     * @throws MatterAccessoryValidationError if validation fails
      */
-    private cleanup;
+    private validateAccessory;
     /**
-     * Get fabric information for commissioned controllers
+     * Validate an array of accessories, logging errors for invalid ones
+     * @returns Array of valid accessories only
      */
-    getFabricInfo(): Array<{
-        fabricIndex: number;
-        fabricId: string;
-        nodeId: string;
-        rootVendorId: number;
-        label?: string;
-    }>;
+    private validateAccessories;
     /**
-     * Check if the server is commissioned
+     * Validate cluster name is valid
      */
-    isCommissioned(): boolean;
+    private validateClusterName;
     /**
-     * Get the number of commissioned fabrics
+     * UUID generator (alias of api.hap.uuid for convenience)
      */
-    getCommissionedFabricCount(): number;
+    get uuid(): typeof import("hap-nodejs/dist/lib/util/uuid.js");
     /**
-     * Get server status information
+     * Matter device types for creating accessories
      */
-    getServerInfo(): {
-        running: boolean;
-        port: number;
-        deviceCount: number;
-        commissioned: boolean;
-        fabricCount: number;
-        serialNumber?: string;
-    };
-    /**
-     * Get commissioning information
-     */
-    getCommissioningInfo(): {
-        qrCode?: string;
-        manualPairingCode?: string;
-        serialNumber?: string;
-        passcode?: number;
-        discriminator?: number;
-        commissioned: boolean;
-    };
-    /**
-     * Get storage statistics
-     */
-    getStorageStats(): Array<{
-        entries: number;
-        namespace: string;
-        path: string;
-    }> | null;
-    /**
-     * Check if server is running
-     */
-    isServerRunning(): boolean;
-    /**
-     * Get Matter device types available for plugin use
-     */
-    getDeviceTypes(): {
-        readonly OnOffLight: devices.OnOffLightDevice;
-        readonly DimmableLight: devices.DimmableLightDevice;
-        readonly ColorTemperatureLight: devices.ColorTemperatureLightDevice;
-        readonly ExtendedColorLight: devices.ExtendedColorLightDevice;
-        readonly OnOffSwitch: devices.OnOffLightSwitchDevice;
-        readonly OnOffOutlet: devices.OnOffPlugInUnitDevice;
-        readonly DimmableOutlet: devices.DimmablePlugInUnitDevice;
-        readonly TemperatureSensor: devices.TemperatureSensorDevice;
-        readonly HumiditySensor: devices.HumiditySensorDevice;
-        readonly LightSensor: devices.LightSensorDevice;
-        readonly MotionSensor: devices.OccupancySensorDevice;
-        readonly ContactSensor: devices.ContactSensorDevice;
-        readonly LeakSensor: devices.WaterLeakDetectorDevice;
-        readonly SmokeSensor: devices.SmokeCoAlarmDevice;
+    get deviceTypes(): {
+        readonly OnOffLight: import("@matter/node/devices").OnOffLightDevice;
+        readonly DimmableLight: import("@matter/node/devices").DimmableLightDevice;
+        readonly ColorTemperatureLight: import("@matter/node/devices").ColorTemperatureLightDevice;
+        readonly ExtendedColorLight: import("@matter/node/devices").ExtendedColorLightDevice;
+        readonly OnOffSwitch: import("@matter/node/devices").OnOffLightSwitchDevice;
+        readonly OnOffOutlet: import("@matter/node/devices").OnOffPlugInUnitDevice;
+        readonly DimmableOutlet: import("@matter/node/devices").DimmablePlugInUnitDevice;
+        readonly TemperatureSensor: import("@matter/node/devices").TemperatureSensorDevice;
+        readonly HumiditySensor: import("@matter/node/devices").HumiditySensorDevice;
+        readonly LightSensor: import("@matter/node/devices").LightSensorDevice;
+        readonly MotionSensor: import("@matter/node/devices").OccupancySensorDevice;
+        readonly ContactSensor: import("@matter/node/devices").ContactSensorDevice;
+        readonly LeakSensor: import("@matter/node/devices").WaterLeakDetectorDevice;
+        readonly SmokeSensor: import("@matter/node/devices").SmokeCoAlarmDevice;
         readonly Thermostat: import("@matter/main").MutableEndpoint.With<EndpointType.For<{
             readonly name: "Thermostat";
             readonly deviceType: 769;
             readonly deviceRevision: 4;
-            readonly requirements: typeof devices.ThermostatRequirements;
+            readonly requirements: typeof import("@matter/node/devices").ThermostatRequirements;
             readonly behaviors: {
-                readonly identify: typeof import("@matter/main/behaviors").IdentifyServer;
+                readonly identify: typeof import("@matter/node/behaviors").IdentifyServer;
             };
         }>, import("@matter/main").SupportedBehaviors.With<{
-            readonly identify: typeof import("@matter/main/behaviors").IdentifyServer;
+            readonly identify: typeof import("@matter/node/behaviors").IdentifyServer;
         }, readonly [import("@matter/main").ClusterBehavior.Type<import("@matter/types").ClusterComposer.WithFeatures<import("@matter/types").ClusterType.Of<{
             readonly id: 513;
             readonly name: "Thermostat";
-            readonly revision: 8;
+            readonly revision: 9;
             readonly features: {
-                readonly heating: import("@matter/types/schema").BitFlag;
-                readonly cooling: import("@matter/types/schema").BitFlag;
-                readonly occupancy: import("@matter/types/schema").BitFlag;
-                readonly scheduleConfiguration: import("@matter/types/schema").BitFlag;
-                readonly setback: import("@matter/types/schema").BitFlag;
-                readonly autoMode: import("@matter/types/schema").BitFlag;
-                readonly localTemperatureNotExposed: import("@matter/types/schema").BitFlag;
-                readonly matterScheduleConfiguration: import("@matter/types/schema").BitFlag;
-                readonly presets: import("@matter/types/schema").BitFlag;
+                readonly heating: import("@matter/types").BitFlag;
+                readonly cooling: import("@matter/types").BitFlag;
+                readonly occupancy: import("@matter/types").BitFlag;
+                readonly scheduleConfiguration: import("@matter/types").BitFlag;
+                readonly setback: import("@matter/types").BitFlag;
+                readonly autoMode: import("@matter/types").BitFlag;
+                readonly localTemperatureNotExposed: import("@matter/types").BitFlag;
+                readonly matterScheduleConfiguration: import("@matter/types").BitFlag;
+                readonly presets: import("@matter/types").BitFlag;
             };
             readonly attributes: {
                 readonly localTemperature: import("@matter/types").Attribute<number | null, any>;
                 readonly outdoorTemperature: import("@matter/types").OptionalAttribute<number | null, any>;
-                readonly hvacSystemTypeConfiguration: import("@matter/types").OptionalWritableAttribute<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                    coolingStage: import("@matter/types/schema").BitField;
-                    heatingStage: import("@matter/types/schema").BitField;
-                    heatingIsHeatPump: import("@matter/types/schema").BitFlag;
-                    heatingUsesFuel: import("@matter/types/schema").BitFlag;
+                readonly hvacSystemTypeConfiguration: import("@matter/types").OptionalWritableAttribute<import("@matter/types").TypeFromPartialBitSchema<{
+                    coolingStage: import("@matter/types").BitField;
+                    heatingStage: import("@matter/types").BitField;
+                    heatingIsHeatPump: import("@matter/types").BitFlag;
+                    heatingUsesFuel: import("@matter/types").BitFlag;
                 }>, any>;
-                readonly remoteSensing: import("@matter/types").OptionalWritableAttribute<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                    localTemperature: import("@matter/types/schema").BitFlag;
-                    outdoorTemperature: import("@matter/types/schema").BitFlag;
-                    occupancy: import("@matter/types/schema").BitFlag;
+                readonly remoteSensing: import("@matter/types").OptionalWritableAttribute<import("@matter/types").TypeFromPartialBitSchema<{
+                    localTemperature: import("@matter/types").BitFlag;
+                    outdoorTemperature: import("@matter/types").BitFlag;
+                    occupancy: import("@matter/types").BitFlag;
                 }>, any>;
                 readonly controlSequenceOfOperation: import("@matter/types").WritableAttribute<clusters.Thermostat.ControlSequenceOfOperation, any>;
                 readonly systemMode: import("@matter/types").WritableAttribute<clusters.Thermostat.SystemMode, any>;
                 readonly temperatureSetpointHold: import("@matter/types").OptionalWritableAttribute<clusters.Thermostat.TemperatureSetpointHold, any>;
                 readonly temperatureSetpointHoldDuration: import("@matter/types").OptionalWritableAttribute<number | null, any>;
-                readonly thermostatProgrammingOperationMode: import("@matter/types").OptionalWritableAttribute<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                    scheduleActive: import("@matter/types/schema").BitFlag;
-                    autoRecovery: import("@matter/types/schema").BitFlag;
-                    economy: import("@matter/types/schema").BitFlag;
+                readonly thermostatProgrammingOperationMode: import("@matter/types").OptionalWritableAttribute<import("@matter/types").TypeFromPartialBitSchema<{
+                    scheduleActive: import("@matter/types").BitFlag;
+                    autoRecovery: import("@matter/types").BitFlag;
+                    economy: import("@matter/types").BitFlag;
                 }>, any>;
-                readonly thermostatRunningState: import("@matter/types").OptionalAttribute<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                    heat: import("@matter/types/schema").BitFlag;
-                    cool: import("@matter/types/schema").BitFlag;
-                    fan: import("@matter/types/schema").BitFlag;
-                    heatStage2: import("@matter/types/schema").BitFlag;
-                    coolStage2: import("@matter/types/schema").BitFlag;
-                    fanStage2: import("@matter/types/schema").BitFlag;
-                    fanStage3: import("@matter/types/schema").BitFlag;
+                readonly thermostatRunningState: import("@matter/types").OptionalAttribute<import("@matter/types").TypeFromPartialBitSchema<{
+                    heat: import("@matter/types").BitFlag;
+                    cool: import("@matter/types").BitFlag;
+                    fan: import("@matter/types").BitFlag;
+                    heatStage2: import("@matter/types").BitFlag;
+                    coolStage2: import("@matter/types").BitFlag;
+                    fanStage2: import("@matter/types").BitFlag;
+                    fanStage3: import("@matter/types").BitFlag;
                 }>, any>;
                 readonly setpointChangeSource: import("@matter/types").OptionalAttribute<clusters.Thermostat.SetpointChangeSource, any>;
                 readonly setpointChangeAmount: import("@matter/types").OptionalAttribute<number | null, any>;
@@ -328,12 +124,12 @@ export declare class MatterServer extends EventEmitter {
                 readonly acCapacity: import("@matter/types").OptionalWritableAttribute<number, any>;
                 readonly acRefrigerantType: import("@matter/types").OptionalWritableAttribute<clusters.Thermostat.AcRefrigerantType, any>;
                 readonly acCompressorType: import("@matter/types").OptionalWritableAttribute<clusters.Thermostat.AcCompressorType, any>;
-                readonly acErrorCode: import("@matter/types").OptionalWritableAttribute<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                    compressorFail: import("@matter/types/schema").BitFlag;
-                    roomSensorFail: import("@matter/types/schema").BitFlag;
-                    outdoorSensorFail: import("@matter/types/schema").BitFlag;
-                    coilSensorFail: import("@matter/types/schema").BitFlag;
-                    fanFail: import("@matter/types/schema").BitFlag;
+                readonly acErrorCode: import("@matter/types").OptionalWritableAttribute<import("@matter/types").TypeFromPartialBitSchema<{
+                    compressorFail: import("@matter/types").BitFlag;
+                    roomSensorFail: import("@matter/types").BitFlag;
+                    outdoorSensorFail: import("@matter/types").BitFlag;
+                    coilSensorFail: import("@matter/types").BitFlag;
+                    fanFail: import("@matter/types").BitFlag;
                 }>, any>;
                 readonly acLouverPosition: import("@matter/types").OptionalWritableAttribute<clusters.Thermostat.AcLouverPosition, any>;
                 readonly acCoilTemperature: import("@matter/types").OptionalAttribute<number | null, any>;
@@ -352,8 +148,8 @@ export declare class MatterServer extends EventEmitter {
                 };
                 readonly component: {
                     readonly attributes: {
-                        readonly occupancy: import("@matter/types").Attribute<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                            occupied: import("@matter/types/schema").BitFlag;
+                        readonly occupancy: import("@matter/types").Attribute<import("@matter/types").TypeFromPartialBitSchema<{
+                            occupied: import("@matter/types").BitFlag;
                         }>, any>;
                     };
                 };
@@ -437,19 +233,19 @@ export declare class MatterServer extends EventEmitter {
                     readonly commands: {
                         readonly setWeeklySchedule: import("@matter/types").Command<import("@matter/types").TypeFromFields<{
                             numberOfTransitionsForSequence: import("@matter/types").FieldType<number>;
-                            dayOfWeekForSequence: import("@matter/types").FieldType<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                                sunday: import("@matter/types/schema").BitFlag;
-                                monday: import("@matter/types/schema").BitFlag;
-                                tuesday: import("@matter/types/schema").BitFlag;
-                                wednesday: import("@matter/types/schema").BitFlag;
-                                thursday: import("@matter/types/schema").BitFlag;
-                                friday: import("@matter/types/schema").BitFlag;
-                                saturday: import("@matter/types/schema").BitFlag;
-                                away: import("@matter/types/schema").BitFlag;
+                            dayOfWeekForSequence: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
+                                sunday: import("@matter/types").BitFlag;
+                                monday: import("@matter/types").BitFlag;
+                                tuesday: import("@matter/types").BitFlag;
+                                wednesday: import("@matter/types").BitFlag;
+                                thursday: import("@matter/types").BitFlag;
+                                friday: import("@matter/types").BitFlag;
+                                saturday: import("@matter/types").BitFlag;
+                                away: import("@matter/types").BitFlag;
                             }>>;
-                            modeForSequence: import("@matter/types").FieldType<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                                heatSetpointPresent: import("@matter/types/schema").BitFlag;
-                                coolSetpointPresent: import("@matter/types/schema").BitFlag;
+                            modeForSequence: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
+                                heatSetpointPresent: import("@matter/types").BitFlag;
+                                coolSetpointPresent: import("@matter/types").BitFlag;
                             }>>;
                             transitions: import("@matter/types").FieldType<import("@matter/types").TypeFromFields<{
                                 transitionTime: import("@matter/types").FieldType<number>;
@@ -458,35 +254,35 @@ export declare class MatterServer extends EventEmitter {
                             }>[]>;
                         }>, void, any>;
                         readonly getWeeklySchedule: import("@matter/types").Command<import("@matter/types").TypeFromFields<{
-                            daysToReturn: import("@matter/types").FieldType<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                                sunday: import("@matter/types/schema").BitFlag;
-                                monday: import("@matter/types/schema").BitFlag;
-                                tuesday: import("@matter/types/schema").BitFlag;
-                                wednesday: import("@matter/types/schema").BitFlag;
-                                thursday: import("@matter/types/schema").BitFlag;
-                                friday: import("@matter/types/schema").BitFlag;
-                                saturday: import("@matter/types/schema").BitFlag;
-                                away: import("@matter/types/schema").BitFlag;
+                            daysToReturn: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
+                                sunday: import("@matter/types").BitFlag;
+                                monday: import("@matter/types").BitFlag;
+                                tuesday: import("@matter/types").BitFlag;
+                                wednesday: import("@matter/types").BitFlag;
+                                thursday: import("@matter/types").BitFlag;
+                                friday: import("@matter/types").BitFlag;
+                                saturday: import("@matter/types").BitFlag;
+                                away: import("@matter/types").BitFlag;
                             }>>;
-                            modeToReturn: import("@matter/types").FieldType<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                                heatSetpointPresent: import("@matter/types/schema").BitFlag;
-                                coolSetpointPresent: import("@matter/types/schema").BitFlag;
+                            modeToReturn: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
+                                heatSetpointPresent: import("@matter/types").BitFlag;
+                                coolSetpointPresent: import("@matter/types").BitFlag;
                             }>>;
                         }>, import("@matter/types").TypeFromFields<{
                             numberOfTransitionsForSequence: import("@matter/types").FieldType<number>;
-                            dayOfWeekForSequence: import("@matter/types").FieldType<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                                sunday: import("@matter/types/schema").BitFlag;
-                                monday: import("@matter/types/schema").BitFlag;
-                                tuesday: import("@matter/types/schema").BitFlag;
-                                wednesday: import("@matter/types/schema").BitFlag;
-                                thursday: import("@matter/types/schema").BitFlag;
-                                friday: import("@matter/types/schema").BitFlag;
-                                saturday: import("@matter/types/schema").BitFlag;
-                                away: import("@matter/types/schema").BitFlag;
+                            dayOfWeekForSequence: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
+                                sunday: import("@matter/types").BitFlag;
+                                monday: import("@matter/types").BitFlag;
+                                tuesday: import("@matter/types").BitFlag;
+                                wednesday: import("@matter/types").BitFlag;
+                                thursday: import("@matter/types").BitFlag;
+                                friday: import("@matter/types").BitFlag;
+                                saturday: import("@matter/types").BitFlag;
+                                away: import("@matter/types").BitFlag;
                             }>>;
-                            modeForSequence: import("@matter/types").FieldType<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                                heatSetpointPresent: import("@matter/types/schema").BitFlag;
-                                coolSetpointPresent: import("@matter/types/schema").BitFlag;
+                            modeForSequence: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
+                                heatSetpointPresent: import("@matter/types").BitFlag;
+                                coolSetpointPresent: import("@matter/types").BitFlag;
                             }>>;
                             transitions: import("@matter/types").FieldType<import("@matter/types").TypeFromFields<{
                                 transitionTime: import("@matter/types").FieldType<number>;
@@ -529,9 +325,9 @@ export declare class MatterServer extends EventEmitter {
                         readonly presetTypes: import("@matter/types").FixedAttribute<import("@matter/types").TypeFromFields<{
                             presetScenario: import("@matter/types").FieldType<clusters.Thermostat.PresetScenario>;
                             numberOfPresets: import("@matter/types").FieldType<number>;
-                            presetTypeFeatures: import("@matter/types").FieldType<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                                automatic: import("@matter/types/schema").BitFlag;
-                                supportsNames: import("@matter/types/schema").BitFlag;
+                            presetTypeFeatures: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
+                                automatic: import("@matter/types").BitFlag;
+                                supportsNames: import("@matter/types").BitFlag;
                             }>>;
                         }>[], any>;
                         readonly numberOfPresets: import("@matter/types").FixedAttribute<number, any>;
@@ -560,11 +356,11 @@ export declare class MatterServer extends EventEmitter {
                         readonly scheduleTypes: import("@matter/types").FixedAttribute<import("@matter/types").TypeFromFields<{
                             systemMode: import("@matter/types").FieldType<clusters.Thermostat.SystemMode>;
                             numberOfSchedules: import("@matter/types").FieldType<number>;
-                            scheduleTypeFeatures: import("@matter/types").FieldType<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                                supportsPresets: import("@matter/types/schema").BitFlag;
-                                supportsSetpoints: import("@matter/types/schema").BitFlag;
-                                supportsNames: import("@matter/types/schema").BitFlag;
-                                supportsOff: import("@matter/types/schema").BitFlag;
+                            scheduleTypeFeatures: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
+                                supportsPresets: import("@matter/types").BitFlag;
+                                supportsSetpoints: import("@matter/types").BitFlag;
+                                supportsNames: import("@matter/types").BitFlag;
+                                supportsOff: import("@matter/types").BitFlag;
                             }>>;
                         }>[], any>;
                         readonly numberOfSchedules: import("@matter/types").FixedAttribute<number, any>;
@@ -577,15 +373,15 @@ export declare class MatterServer extends EventEmitter {
                             name: import("@matter/types").OptionalFieldType<string>;
                             presetHandle: import("@matter/types").OptionalFieldType<AllowSharedBufferSource>;
                             transitions: import("@matter/types").FieldType<import("@matter/types").TypeFromFields<{
-                                dayOfWeek: import("@matter/types").FieldType<import("@matter/types/schema").TypeFromPartialBitSchema<{
-                                    sunday: import("@matter/types/schema").BitFlag;
-                                    monday: import("@matter/types/schema").BitFlag;
-                                    tuesday: import("@matter/types/schema").BitFlag;
-                                    wednesday: import("@matter/types/schema").BitFlag;
-                                    thursday: import("@matter/types/schema").BitFlag;
-                                    friday: import("@matter/types/schema").BitFlag;
-                                    saturday: import("@matter/types/schema").BitFlag;
-                                    away: import("@matter/types/schema").BitFlag;
+                                dayOfWeek: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
+                                    sunday: import("@matter/types").BitFlag;
+                                    monday: import("@matter/types").BitFlag;
+                                    tuesday: import("@matter/types").BitFlag;
+                                    wednesday: import("@matter/types").BitFlag;
+                                    thursday: import("@matter/types").BitFlag;
+                                    friday: import("@matter/types").BitFlag;
+                                    saturday: import("@matter/types").BitFlag;
+                                    away: import("@matter/types").BitFlag;
                                 }>>;
                                 transitionTime: import("@matter/types").FieldType<number>;
                                 presetHandle: import("@matter/types").OptionalFieldType<AllowSharedBufferSource>;
@@ -621,36 +417,76 @@ export declare class MatterServer extends EventEmitter {
                 };
                 readonly component: false;
             }];
-        }>, readonly ["Heating", "Cooling"]>, typeof import("@matter/main/behaviors").ThermostatServer, import("@matter/main/behaviors").ThermostatInterface>]>>;
-        readonly Fan: devices.FanDevice;
-        readonly DoorLock: devices.DoorLockDevice;
-        readonly WindowCovering: devices.WindowCoveringDevice;
-        readonly RoboticVacuumCleaner: devices.RoboticVacuumCleanerDevice;
-        readonly GenericSwitch: devices.GenericSwitchDevice;
-        readonly Pump: devices.PumpDevice;
-        readonly RoomAirConditioner: devices.RoomAirConditionerDevice;
+        }>, readonly ["Heating", "Cooling"]>, typeof import("@matter/node/behaviors").ThermostatServer, import("@matter/node/behaviors").ThermostatInterface>]>>;
+        readonly Fan: import("@matter/node/devices").FanDevice;
+        readonly DoorLock: import("@matter/node/devices").DoorLockDevice;
+        readonly WindowCovering: import("@matter/node/devices").WindowCoveringDevice;
+        readonly RoboticVacuumCleaner: import("@matter/node/devices").RoboticVacuumCleanerDevice;
+        readonly GenericSwitch: import("@matter/node/devices").GenericSwitchDevice;
+        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";
+        readonly ColorControl: "colorControl";
+        readonly DoorLock: "doorLock";
+        readonly WindowCovering: "windowCovering";
+        readonly Thermostat: "thermostat";
+        readonly FanControl: "fanControl";
+        readonly TemperatureMeasurement: "temperatureMeasurement";
+        readonly RelativeHumidityMeasurement: "relativeHumidityMeasurement";
+        readonly IlluminanceMeasurement: "illuminanceMeasurement";
+        readonly OccupancySensing: "occupancySensing";
+        readonly BooleanState: "booleanState";
+        readonly SmokeCoAlarm: "smokeCoAlarm";
+        readonly RvcRunMode: "rvcRunMode";
+        readonly RvcOperationalState: "rvcOperationalState";
+        readonly RvcCleanMode: "rvcCleanMode";
+        readonly ServiceArea: "serviceArea";
+        readonly PumpConfigurationAndControl: "pumpConfigurationAndControl";
+        readonly Identify: "identify";
+        readonly BasicInformation: "basicInformation";
+        readonly BridgedDeviceBasicInformation: "bridgedDeviceBasicInformation";
     };
     /**
-     * Get Matter clusters available for plugin use
+     * 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
      */
-    getClusters(): typeof clusters;
+    updatePlatformAccessories(accessories: MatterAccessory[]): Promise<void>;
     /**
-     * Remove a specific fabric (controller) from the bridge
-     * This decommissions a single controller while leaving others intact
-     *
-     * @param fabricIndex - The fabric index to remove
-     * @returns Promise that resolves when the fabric is removed
+     * Unregister Matter platform accessories
+     * Automatically handles external accessories (e.g., RoboticVacuumCleaner) that have dedicated bridges
      */
-    removeFabric(fabricIndex: number): Promise<void>;
+    unregisterPlatformAccessories(pluginIdentifier: PluginIdentifier, platformName: PlatformName, accessories: MatterAccessory[]): Promise<void>;
     /**
-     * Check if a specific fabric exists
+     * Update a Matter accessory's cluster state
+     * Validates inputs before updating
      */
-    hasFabric(fabricIndex: number): boolean;
+    updateAccessoryState(uuid: string, cluster: string, attributes: Record<string, unknown>, partId?: string): Promise<void>;
     /**
-     * Notify controllers that the parts list has changed
-     * This triggers controllers (like Home app) to re-read the device list
-     * and discover new or removed accessories without needing to re-pair
+     * Get a Matter accessory's current cluster state
+     * Checks both external servers and main bridge server
+     * Validates inputs before retrieving state
      */
-    private notifyPartsListChanged;
+    getAccessoryState(uuid: string, cluster: string, partId?: string): Promise<Record<string, unknown> | undefined>;
 }
-//# sourceMappingURL=matterServer.d.ts.map
+//# sourceMappingURL=MatterAPIImpl.d.ts.map