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

package/dist/matter/matterStorage.js

@@ -0,0 +1,442 @@
+/* global NodeJS */
+/**
+ * Custom Matter.js Storage Implementation for Homebridge
+ *
+ * Provides persistent storage for Matter fabric data and device configuration.
+ * This ensures commissioning data persists across Homebridge restarts.
+ */
+import { Buffer } from 'node:buffer';
+import * as fs from 'node:fs';
+import * as fsp from 'node:fs/promises';
+import * as path from 'node:path';
+import { Logger } from '../logger.js';
+const log = Logger.withPrefix('Matter:Storage');
+// Storage configuration constants
+const STORAGE_WRITE_DEBOUNCE_MS = 100; // Delay for non-critical writes
+/**
+ * Custom Matter.js StorageContext implementation for Homebridge
+ * Provides persistent storage for fabric data and device configuration
+ */
+export class HomebridgeMatterStorage {
+    namespace;
+    storage = new Map();
+    filePath;
+    isInitialized = false;
+    writeTimer = null;
+    pendingWrite = false;
+    persistLock = null;
+    constructor(namespace, storagePath) {
+        this.namespace = namespace;
+        this.filePath = path.join(storagePath, `${namespace}.json`);
+        // Synchronously load existing data to avoid race conditions with Matter.js
+        // Matter.js expects storage to be immediately available
+        this.initializeSync();
+    }
+    /**
+     * Synchronously initialize storage by loading existing data
+     * This is called in the constructor to ensure storage is ready immediately
+     */
+    initializeSync() {
+        try {
+            const fileContent = fs.readFileSync(this.filePath, 'utf-8');
+            // Parse WITHOUT a reviver - we'll deserialize manually
+            const data = JSON.parse(fileContent);
+            // Ensure data is valid before loading
+            if (data && typeof data === 'object') {
+                // Deserialize ALL values as we load them into the Map
+                const entries = Object.entries(data).map(([key, value]) => [
+                    key,
+                    this.deserializeValue(value),
+                ]);
+                this.storage = new Map(entries);
+                log.debug(`Loaded ${this.storage.size} entries for namespace: ${this.namespace}`);
+            }
+            else {
+                log.warn(`Invalid storage data for ${this.namespace}, starting fresh`);
+                this.storage = new Map();
+            }
+            this.isInitialized = true;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                log.debug(`No existing storage for namespace: ${this.namespace}`);
+            }
+            else {
+                log.warn(`Failed to load storage for ${this.namespace} (${error.message}), starting fresh`);
+            }
+            // Create fresh storage if file doesn't exist or is corrupted
+            this.storage = new Map();
+            this.isInitialized = true;
+        }
+    }
+    /**
+     * Initialize storage and load existing data (async for compatibility)
+     * Note: Storage is now initialized synchronously in constructor
+     */
+    async initialize() {
+        // Storage is already initialized in constructor
+        return Promise.resolve();
+    }
+    /**
+     * Build a context key from an array of contexts
+     */
+    buildContextKey(contexts) {
+        return contexts.join('.');
+    }
+    /**
+     * Recursively convert special serialized types back to their original types
+     * This handles cases where objects weren't fully deserialized by the JSON reviver
+     */
+    deserializeValue(value) {
+        if (value && typeof value === 'object') {
+            // Handle special type markers
+            const obj = value;
+            if (obj.__type === 'bigint' && typeof obj.value === 'string') {
+                return BigInt(obj.value);
+            }
+            if (obj.__type === 'Uint8Array' && Array.isArray(obj.value)) {
+                return new Uint8Array(obj.value);
+            }
+            // Handle Node.js Buffer JSON format: {type: "Buffer", data: [...]}
+            if (obj.type === 'Buffer' && Array.isArray(obj.data)) {
+                return new Uint8Array(obj.data);
+            }
+            // Recursively process arrays
+            if (Array.isArray(value)) {
+                return value.map(item => this.deserializeValue(item));
+            }
+            // Recursively process plain objects
+            if (Object.getPrototypeOf(value) === Object.prototype) {
+                const result = {};
+                for (const [k, v] of Object.entries(value)) {
+                    result[k] = this.deserializeValue(v);
+                }
+                return result;
+            }
+        }
+        return value;
+    }
+    /**
+     * Get a value from storage (Matter.js interface)
+     */
+    get(contexts, key) {
+        // Storage is initialized in constructor, so this should always work
+        const fullKey = contexts.length ? `${this.buildContextKey(contexts)}.${key}` : key;
+        const value = this.storage.get(fullKey);
+        // Debug logging for fabric data
+        if (fullKey.includes('fabric')) {
+            log.info(`[STORAGE GET] ${fullKey}`);
+            log.info(`  Before deserialize: type=${typeof value}, constructor=${value?.constructor?.name}, isUint8Array=${value instanceof Uint8Array}`);
+            if (value && typeof value === 'object' && !(value instanceof Uint8Array)) {
+                const obj = value;
+                if (obj.__type) {
+                    log.info(`  Has __type: ${obj.__type}`);
+                }
+                // Check for nested Uint8Arrays
+                for (const key of Object.keys(obj).slice(0, 5)) {
+                    const val = obj[key];
+                    if (val && typeof val === 'object') {
+                        log.info(`  ${key}: type=${typeof val}, constructor=${val?.constructor?.name}, __type=${val.__type}, isUint8Array=${val instanceof Uint8Array}`);
+                    }
+                }
+            }
+        }
+        // Ensure value is fully deserialized (handles nested special types)
+        const result = this.deserializeValue(value);
+        // Debug logging after deserialization
+        if (fullKey.includes('fabric')) {
+            log.info(`  After deserialize: type=${typeof result}, constructor=${result?.constructor?.name}, isUint8Array=${result instanceof Uint8Array}`);
+            if (result && typeof result === 'object' && !(result instanceof Uint8Array)) {
+                const obj = result;
+                // Check for nested Uint8Arrays
+                for (const key of Object.keys(obj).slice(0, 5)) {
+                    const val = obj[key];
+                    if (val && typeof val === 'object') {
+                        log.info(`  ${key}: isUint8Array=${val instanceof Uint8Array}`);
+                    }
+                }
+            }
+        }
+        return result;
+    }
+    set(contexts, keyOrValues, value) {
+        const contextKey = this.buildContextKey(contexts);
+        if (typeof keyOrValues === 'string') {
+            const fullKey = contextKey ? `${contextKey}.${keyOrValues}` : keyOrValues;
+            this.storage.set(fullKey, value);
+        }
+        else {
+            for (const [k, v] of Object.entries(keyOrValues)) {
+                const fullKey = contextKey ? `${contextKey}.${k}` : k;
+                this.storage.set(fullKey, v);
+            }
+        }
+        // Debounce writes to avoid excessive disk I/O
+        void this.schedulePersist();
+    }
+    /**
+     * Delete a key from storage (Matter.js interface)
+     */
+    delete(contexts, key) {
+        const fullKey = contexts.length ? `${this.buildContextKey(contexts)}.${key}` : key;
+        const deleted = this.storage.delete(fullKey);
+        if (deleted) {
+            void this.schedulePersist();
+        }
+    }
+    /**
+     * Clear all storage in a context (Matter.js interface)
+     */
+    clearAll(contexts) {
+        const contextKey = this.buildContextKey(contexts);
+        const prefix = contextKey ? `${contextKey}.` : '';
+        // Collect keys to delete first to avoid modifying during iteration
+        const keysToDelete = [];
+        for (const key of this.storage.keys()) {
+            if (!prefix || key.startsWith(prefix)) {
+                keysToDelete.push(key);
+            }
+        }
+        // Delete collected keys
+        for (const key of keysToDelete) {
+            this.storage.delete(key);
+        }
+        if (keysToDelete.length > 0) {
+            void this.schedulePersist();
+        }
+    }
+    /**
+     * Get all keys in a context (Matter.js interface)
+     */
+    keys(contexts) {
+        if (!this.isInitialized) {
+            return [];
+        }
+        const contextKey = this.buildContextKey(contexts);
+        const prefix = contextKey ? `${contextKey}.` : '';
+        const contextKeys = [];
+        for (const key of this.storage.keys()) {
+            if (prefix) {
+                // Return keys within this context (strip context prefix)
+                if (key.startsWith(prefix)) {
+                    const subKey = key.substring(prefix.length);
+                    // Only include direct children (no further nesting)
+                    if (!subKey.includes('.')) {
+                        contextKeys.push(subKey);
+                    }
+                }
+            }
+            else {
+                // Root level - return keys with no dots
+                if (!key.includes('.')) {
+                    contextKeys.push(key);
+                }
+            }
+        }
+        return contextKeys;
+    }
+    /**
+     * Get all child context names (Matter.js interface)
+     */
+    contexts(contexts) {
+        if (!this.isInitialized) {
+            return [];
+        }
+        const contextKey = this.buildContextKey(contexts);
+        const prefix = contextKey ? `${contextKey}.` : '';
+        const childContexts = new Set();
+        for (const key of this.storage.keys()) {
+            if (prefix) {
+                // Find sub-contexts within this context
+                if (key.startsWith(prefix)) {
+                    const subKey = key.substring(prefix.length);
+                    const nextDot = subKey.indexOf('.');
+                    if (nextDot > 0) {
+                        childContexts.add(subKey.substring(0, nextDot));
+                    }
+                }
+            }
+            else {
+                // Root level - find top-level contexts
+                const dotIndex = key.indexOf('.');
+                if (dotIndex > 0) {
+                    childContexts.add(key.substring(0, dotIndex));
+                }
+            }
+        }
+        return Array.from(childContexts);
+    }
+    /**
+     * Check if a key exists (Matter.js interface)
+     */
+    has(contexts, key) {
+        if (!this.isInitialized) {
+            return false;
+        }
+        const fullKey = contexts.length ? `${this.buildContextKey(contexts)}.${key}` : key;
+        return this.storage.has(fullKey);
+    }
+    /**
+     * Get all values in a context
+     */
+    async values(contexts) {
+        await this.initialize();
+        const contextKey = this.buildContextKey(contexts);
+        const prefix = contextKey ? `${contextKey}.` : '';
+        const values = {};
+        for (const [key, value] of this.storage.entries()) {
+            if (prefix) {
+                if (key.startsWith(prefix)) {
+                    const subKey = key.substring(prefix.length);
+                    if (!subKey.includes('.')) {
+                        values[subKey] = this.deserializeValue(value);
+                    }
+                }
+            }
+            else {
+                if (!key.includes('.')) {
+                    values[key] = this.deserializeValue(value);
+                }
+            }
+        }
+        return values;
+    }
+    /**
+     * Schedule a persist operation (debounced)
+     */
+    async schedulePersist() {
+        if (this.writeTimer) {
+            clearTimeout(this.writeTimer);
+        }
+        this.pendingWrite = true;
+        // Immediate persist for critical data (fabric information)
+        const hasCriticalData = Array.from(this.storage.keys()).some(key => key.includes('fabric') || key.includes('commissioning'));
+        if (hasCriticalData) {
+            await this.persist();
+        }
+        else {
+            // Debounce non-critical writes
+            this.writeTimer = setTimeout(() => {
+                void this.persist();
+            }, STORAGE_WRITE_DEBOUNCE_MS);
+        }
+    }
+    /**
+     * Persist storage to disk with atomic write
+     */
+    async persist() {
+        // Wait for any in-progress persist operation to complete
+        if (this.persistLock) {
+            await this.persistLock;
+        }
+        if (!this.pendingWrite) {
+            return;
+        }
+        // Create a new lock for this persist operation
+        this.persistLock = (async () => {
+            try {
+                const data = Object.fromEntries(this.storage.entries());
+                const dir = path.dirname(this.filePath);
+                // Ensure directory exists
+                await fsp.mkdir(dir, { recursive: true });
+                // Atomic write: write to temp file then rename
+                // Use a unique temp file to avoid conflicts
+                const tempFile = `${this.filePath}.tmp.${Date.now()}`;
+                // Custom replacer to handle BigInt, Uint8Array, and Buffer serialization
+                const jsonString = JSON.stringify(data, (_key, value) => {
+                    if (typeof value === 'bigint') {
+                        return { __type: 'bigint', value: value.toString() };
+                    }
+                    // Handle Buffer before Uint8Array since Buffer extends Uint8Array
+                    // Note: Buffer.toJSON() returns {type: 'Buffer', data: [...]}, but we want consistent format
+                    if (Buffer.isBuffer(value)) {
+                        return { __type: 'Uint8Array', value: Array.from(value) };
+                    }
+                    if (value instanceof Uint8Array) {
+                        return { __type: 'Uint8Array', value: Array.from(value) };
+                    }
+                    return value;
+                }, 2);
+                await fsp.writeFile(tempFile, jsonString, 'utf-8');
+                await fsp.rename(tempFile, this.filePath);
+                this.pendingWrite = false;
+                log.debug(`Persisted ${this.storage.size} entries for namespace: ${this.namespace}`);
+            }
+            catch (error) {
+                log.error(`Failed to persist storage for ${this.namespace}:`, error);
+                // Don't throw - we don't want to break Matter operations
+            }
+            finally {
+                this.persistLock = null;
+            }
+        })();
+        await this.persistLock;
+    }
+    /**
+     * Force immediate persist (for shutdown)
+     */
+    async forcePersist() {
+        if (this.writeTimer) {
+            clearTimeout(this.writeTimer);
+            this.writeTimer = null;
+        }
+        if (this.pendingWrite) {
+            await this.persist();
+        }
+    }
+    /**
+     * Close and cleanup storage
+     */
+    async close() {
+        await this.forcePersist();
+        this.storage.clear();
+        this.isInitialized = false;
+    }
+    /**
+     * Get storage statistics
+     */
+    getStats() {
+        return {
+            entries: this.storage.size,
+            namespace: this.namespace,
+            path: this.filePath,
+        };
+    }
+}
+/**
+ * Storage Manager for Matter.js
+ * Manages multiple storage contexts for different namespaces
+ */
+export class MatterStorageManager {
+    storagePath;
+    storages = new Map();
+    constructor(storagePath) {
+        this.storagePath = storagePath;
+    }
+    /**
+     * Get or create a storage context for a namespace
+     */
+    getStorage(namespace) {
+        let storage = this.storages.get(namespace);
+        if (!storage) {
+            storage = new HomebridgeMatterStorage(namespace, this.storagePath);
+            this.storages.set(namespace, storage);
+        }
+        return storage;
+    }
+    /**
+     * Close all storage contexts
+     */
+    async closeAll() {
+        const promises = Array.from(this.storages.values()).map(storage => storage.close());
+        await Promise.all(promises);
+        this.storages.clear();
+    }
+    /**
+     * Get statistics for all storage contexts
+     */
+    getAllStats() {
+        return Array.from(this.storages.values()).map(storage => storage.getStats());
+    }
+}
+//# sourceMappingURL=matterStorage.js.map

package/dist/matter/matterStorage.js.map

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

package/dist/matter/matterTypes.d.ts

@@ -1,35 +1,163 @@
-import { HomebridgeOptions } from '../server.js';
 /**
- * Matter bridge configuration interface
+ * Matter Types for Homebridge Plugin API
+ *
+ * This module provides types and interfaces for plugin developers
+ * to create Matter-compatible accessories.
  */
-export interface MatterConfiguration {
-    port?: number;
-    name?: string;
+import type { Endpoint, EndpointType } from '@matter/main';
+import * as clusters from '@matter/main/clusters';
+import * as devices from '@matter/main/devices';
+/**
+ * Matter Accessory - Plugin API Interface
+ *
+ * This is the main interface that plugin developers use to register
+ * Matter accessories with Homebridge.
+ */
+export interface MatterAccessory<T = Record<string, any>> {
+    /** Unique identifier for this accessory (must be unique across all accessories) */
+    uuid: string;
+    /** Display name for the accessory */
+    displayName: string;
+    /** Matter device type (e.g., OnOffLightDevice, DimmableLightDevice, etc.) */
+    deviceType: EndpointType;
+    /** Serial number for the device */
+    serialNumber: string;
+    /** Manufacturer name */
+    manufacturer: string;
+    /** Model name/identifier */
+    model: string;
+    /** Firmware revision (optional) */
+    firmwareRevision?: string;
+    /** Hardware revision (optional) */
+    hardwareRevision?: string;
+    /** Software version (optional) */
+    softwareVersion?: string;
+    /**
+     * Plugin developer storage - persists across restarts
+     * This is a way for plugin developers to store custom data with their accessory
+     * Similar to PlatformAccessory.context for HAP accessories
+     */
+    context?: T;
+    /**
+     * Initial cluster states
+     * Key is the cluster name, value is an object of attribute name -> value
+     *
+     * Example:
+     * {
+     *   onOff: { onOff: true },
+     *   levelControl: { currentLevel: 127, minLevel: 1, maxLevel: 254 }
+     * }
+     */
+    clusters: {
+        [clusterName: string]: {
+            [attributeName: string]: unknown;
+        };
+    };
+    /**
+     * Handlers for Matter commands
+     * Key is the cluster name, value is an object of command name -> handler function
+     *
+     * Example:
+     * {
+     *   onOff: {
+     *     on: async () => { ... },
+     *     off: async () => { ... }
+     *   }
+     * }
+     */
+    handlers?: {
+        [clusterName: string]: {
+            [commandName: string]: (...args: unknown[]) => Promise<void> | void;
+        };
+    };
+    /**
+     * Optional: Get current state handler
+     * Called when a Matter controller reads an attribute
+     * If not provided, the last set value is returned
+     */
+    getState?: (cluster: string, attribute: string) => Promise<any> | any;
 }
 /**
- * Matter bridge options extending Homebridge options
+ * Matter Configuration (for bridge or child bridge)
  */
-export interface MatterBridgeOptions extends HomebridgeOptions {
-    matterBridgeServerPort?: number;
-    configPath?: string;
+export interface MatterConfig {
+    /** Port for Matter server (optional, will auto-assign if not specified) */
+    port?: number;
+    /** Name for the Matter bridge (optional) */
+    name?: string;
 }
-declare const MatterClusters: Record<string, unknown>;
-declare const MatterDeviceTypes: Record<string, unknown>;
 /**
- * Maps common HomeKit service types to appropriate Matter clusters
+ * Internal Matter accessory representation
+ * (Used internally by MatterServer)
  */
-export declare const HAPToMatterClusterMapping: Record<string, string[]>;
+export interface InternalMatterAccessory extends MatterAccessory {
+    endpoint?: Endpoint;
+    registered: boolean;
+}
 /**
- * Maps common HomeKit service types to appropriate Matter device types
+ * Matter error type enum (for error handler categorization)
  */
-export declare const HAPToMatterDeviceMapping: Record<string, string>;
+export declare enum MatterErrorType {
+    INITIALIZATION = "INITIALIZATION",
+    NETWORK = "NETWORK",
+    COMMISSIONING = "COMMISSIONING",
+    DEVICE_SYNC = "DEVICE_SYNC",
+    SERVER = "SERVER",
+    STORAGE = "STORAGE",
+    CONFIGURATION = "CONFIGURATION",
+    DEVICE_ERROR = "DEVICE_ERROR",
+    UNKNOWN = "UNKNOWN"
+}
 /**
- * Helper function to get Matter device type for a HomeKit service
+ * Matter error types
  */
-export declare function getMatterDeviceTypeForHAPService(serviceType: string, characteristics?: string[]): string | null;
+export declare class MatterError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    readonly type: MatterErrorType;
+    readonly timestamp: Date;
+    readonly recoverable: boolean;
+    constructor(message: string, code: string, details?: unknown | undefined, type?: MatterErrorType, recoverable?: boolean);
+}
+export declare class MatterCommissioningError extends MatterError {
+    constructor(message: string, details?: unknown);
+}
+export declare class MatterStorageError extends MatterError {
+    constructor(message: string, details?: unknown);
+}
+export declare class MatterDeviceError extends MatterError {
+    constructor(message: string, details?: unknown);
+}
+export declare class MatterNetworkError extends MatterError {
+    constructor(message: string, details?: unknown);
+}
+export { clusters };
+export { devices };
 /**
- * Helper function to get Matter clusters for a HomeKit service
+ * Friendly device type names for the Plugin API
+ * Maps simplified names to actual Matter.js device types
  */
-export declare function getMatterClustersForHAPService(serviceType: string, characteristics?: string[]): string[];
-export { MatterClusters, MatterDeviceTypes };
+export declare const deviceTypes: {
+    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;
+    readonly Thermostat: devices.ThermostatDevice;
+    readonly Fan: devices.FanDevice;
+    readonly DoorLock: devices.DoorLockDevice;
+    readonly WindowCovering: devices.WindowCoveringDevice;
+    readonly GenericSwitch: devices.GenericSwitchDevice;
+    readonly Pump: devices.PumpDevice;
+    readonly RoomAirConditioner: devices.RoomAirConditionerDevice;
+};
 //# sourceMappingURL=matterTypes.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"matterTypes.d.ts","sourceRoot":"","sources":["../../src/matter/matterTypes.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAEhD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,iBAAiB;IAC5D,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAGD,QAAA,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,CAAA;AAClD,QAAA,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,CAAA;AAuHrD;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAoF9D,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAmC3D,CAAA;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAwB/G;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CA2BxG;AAED,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"matterTypes.d.ts","sourceRoot":"","sources":["../../src/matter/matterTypes.ts"],"names":[],"mappings":"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"}