homebridge 2.0.0-alpha.41 → 2.0.0-alpha.43

package/dist/matter/matterServer.d.ts

@@ -1,40 +1,59 @@
-import { PlatformAccessory } from '../platformAccessory.js';
-import { MatterDevice } from './matterDevice.js';
+/**
+ * Matter.js Server Implementation for Homebridge Plugin API
+ *
+ * This provides a Matter bridge that plugins can use to register
+ * Matter accessories via the Homebridge API.
+ */
 import { MatterServerConfig } from './matterSharedTypes.js';
+import { clusters, MatterAccessory } from './matterTypes.js';
 export { MatterServerConfig } from './matterSharedTypes.js';
 /**
- * Real Matter.js Server for Homebridge
- * Creates a Matter bridge that exposes HAP accessories to Matter controllers
+ * Matter Server for Homebridge Plugin API
+ * Allows plugins to register Matter accessories explicitly
  */
 export declare class MatterServer {
     private readonly config;
     private serverNode;
     private aggregator;
-    private devices;
-    private removedDevices;
+    private accessories;
     private isRunning;
-    private restartTimer;
-    private isRestarting;
     private readonly MAX_DEVICES;
-    private readonly MAX_REMOVED_DEVICES;
-    private readonly RESTART_DELAY_MS;
     private shutdownHandler;
     private passcode;
     private discriminator;
-    private vendorId;
-    private productId;
+    private readonly vendorId;
+    private readonly productId;
     private commissioningInfo;
     private serialNumber?;
     private cleanupHandlers;
+    private storageManager;
+    private matterStoragePath?;
     constructor(config?: MatterServerConfig);
     /**
      * 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
+     * If ServerNode creation fails due to corrupted fabric data, automatically
+     * clean up the ServerNodeStore and retry once
+     */
+    private createServerNodeWithRecovery;
     /**
      * Start the Matter server
      */
@@ -43,6 +62,11 @@ export declare class MatterServer {
      * 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 serial number for the bridge
      */
@@ -56,27 +80,65 @@ export declare class MatterServer {
      */
     private waitForServerReady;
     /**
-     * Add a Homebridge accessory as a bridged Matter device
+     * Register a Matter accessory (Plugin API)
+     */
+    registerAccessory(accessory: MatterAccessory): Promise<void>;
+    /**
+     * Unregister a Matter accessory (Plugin API)
+     */
+    unregisterAccessory(uuid: string): Promise<void>;
+    /**
+     * Update a Matter accessory's state (Plugin API)
+     */
+    updateAccessoryState(uuid: string, cluster: string, attributes: Record<string, unknown>): Promise<void>;
+    /**
+     * Get all registered accessories (Plugin API)
+     */
+    getAccessories(): MatterAccessory[];
+    /**
+     * Get a specific accessory by UUID (Plugin API)
+     */
+    getAccessory(uuid: string): MatterAccessory | undefined;
+    /**
+     * Configure a Matter endpoint after it's been added to the aggregator
+     */
+    private configureEndpoint;
+    /**
+     * Stop the Matter server
+     */
+    stop(): Promise<void>;
+    /**
+     * Cleanup resources
+     */
+    private cleanup;
+    /**
+     * Get fabric information for commissioned controllers
      */
-    addAccessory(accessory: PlatformAccessory): Promise<MatterDevice | null>;
+    getFabricInfo(): Array<{
+        fabricIndex: number;
+        fabricId: string;
+        nodeId: string;
+        rootVendorId: number;
+        label?: string;
+    }>;
     /**
-     * Remove a Matter device
+     * Check if the server is commissioned
      */
-    removeAccessory(accessory: PlatformAccessory): Promise<void>;
+    isCommissioned(): boolean;
     /**
-     * Schedule a server restart to clean up removed endpoints
+     * Get the number of commissioned fabrics
      */
-    private scheduleRestart;
+    getCommissionedFabricCount(): number;
     /**
-     * Get server information
+     * Get server status information
      */
-    getInfo(): {
+    getServerInfo(): {
         running: boolean;
         port: number;
         deviceCount: number;
-        config: MatterServerConfig;
+        commissioned: boolean;
+        fabricCount: number;
         serialNumber?: string;
-        commissioned?: boolean;
     };
     /**
      * Get commissioning information
@@ -84,27 +146,52 @@ export declare class MatterServer {
     getCommissioningInfo(): {
         qrCode?: string;
         manualPairingCode?: string;
+        serialNumber?: string;
+        passcode?: number;
+        discriminator?: number;
         commissioned: boolean;
     };
     /**
-     * Check if the server is commissioned
-     */
-    isCommissioned(): boolean;
-    /**
-     * Get all Matter devices
-     */
-    getDevices(): Map<string, MatterDevice>;
-    /**
-     * Stop the Matter server
-     */
-    stop(): Promise<void>;
-    /**
-     * Cleanup resources
-     */
-    private cleanup;
+     * 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: 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/node/devices").ThermostatDevice;
+        readonly Fan: import("@matter/node/devices").FanDevice;
+        readonly DoorLock: import("@matter/node/devices").DoorLockDevice;
+        readonly WindowCovering: import("@matter/node/devices").WindowCoveringDevice;
+        readonly GenericSwitch: import("@matter/node/devices").GenericSwitchDevice;
+        readonly Pump: import("@matter/node/devices").PumpDevice;
+        readonly RoomAirConditioner: import("@matter/node/devices").RoomAirConditionerDevice;
+    };
     /**
-     * Clean up all devices
+     * Get Matter clusters available for plugin use
      */
-    private cleanupAllDevices;
+    getClusters(): typeof clusters;
 }
 //# sourceMappingURL=matterServer.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"matterServer.d.ts","sourceRoot":"","sources":["../../src/matter/matterServer.ts"],"names":[],"mappings":"AAgCA,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAK3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAE3D;;;GAGG;AACH,qBAAa,YAAY;IA4BX,OAAO,CAAC,QAAQ,CAAC,MAAM;IA3BnC,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,UAAU,CAAmD;IACrE,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAO;IACnC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAK;IACzC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAQ;IACzC,OAAO,CAAC,eAAe,CAAqC;IAE5D,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,SAAS,CAAQ;IAEzB,OAAO,CAAC,iBAAiB,CAInB;IAEN,OAAO,CAAC,YAAY,CAAC,CAAQ;IAE7B,OAAO,CAAC,eAAe,CAAwC;gBAElC,MAAM,GAAE,kBAAuB;IAoB5D;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsC9B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAMnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+G5B;;OAEG;YACW,YAAY;IA6C1B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;YACW,yBAAyB;IAmDvC;;OAEG;YACW,kBAAkB;IAchC;;OAEG;IACG,YAAY,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAgD9E;;OAEG;IACG,eAAe,CAAC,SAAS,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyClE;;OAEG;IACH,OAAO,CAAC,eAAe;IAwDvB;;OAEG;IACH,OAAO,IAAI;QACT,OAAO,EAAE,OAAO,CAAA;QAChB,IAAI,EAAE,MAAM,CAAA;QACZ,WAAW,EAAE,MAAM,CAAA;QACnB,MAAM,EAAE,kBAAkB,CAAA;QAC1B,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,YAAY,CAAC,EAAE,OAAO,CAAA;KACvB;IAqBD;;OAEG;IACH,oBAAoB,IAAI;QACtB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,iBAAiB,CAAC,EAAE,MAAM,CAAA;QAC1B,YAAY,EAAE,OAAO,CAAA;KACtB;IAOD;;OAEG;IACH,cAAc,IAAI,OAAO;IAUzB;;OAEG;IACH,UAAU,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC;IAIvC;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC3B;;OAEG;YACW,OAAO;IA+BrB;;OAEG;YACW,iBAAiB;CAoBhC"}
+{"version":3,"file":"matterServer.d.ts","sourceRoot":"","sources":["../../src/matter/matterServer.ts"],"names":[],"mappings":"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"}