homebridge 2.0.0-alpha.5 → 2.0.0-alpha.50

package/dist/matter/matterStorage.js

@@ -0,0 +1,419 @@
+/* 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 is necessary because JSON.parse() doesn't automatically reconstruct:
+     * - BigInt values (serialized as {__type: 'bigint', value: string})
+     * - Uint8Array values (serialized as {__type: 'Uint8Array', value: number[]})
+     * - Buffer values (Node.js format: {type: 'Buffer', data: number[]})
+     *
+     * Matter.js fabric data contains these types which must be properly restored
+     * for commissioning to work across restarts.
+     *
+     * @param value - The value to deserialize (might be nested object/array)
+     * @returns The deserialized value with proper types restored
+     */
+    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);
+        // Ensure value is fully deserialized (handles nested special types)
+        return this.deserializeValue(value);
+    }
+    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'));
+        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

@@ -0,0 +1,250 @@
+/**
+ * Matter Types for Homebridge Plugin API
+ *
+ * This module provides types and interfaces for plugin developers
+ * to create Matter-compatible accessories.
+ */
+import type { Endpoint, EndpointType } from '@matter/main';
+import * as clusters from '@matter/main/clusters';
+import * as devices from '@matter/main/devices';
+/**
+ * Matter command handler function type
+ *
+ * Handlers can be synchronous or asynchronous (returning a Promise).
+ * The args parameter contains the command arguments passed by Matter.js (optional).
+ */
+export type MatterCommandHandler<TArgs = unknown> = (args?: TArgs) => Promise<void> | void;
+/**
+ * Matter cluster handlers interface
+ *
+ * Maps command names to their handler functions.
+ * Each command can have custom argument types.
+ */
+export interface MatterClusterHandlers {
+    [commandName: string]: MatterCommandHandler<any>;
+}
+/**
+ * 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 (Home app → Device)
+     *
+     * These handlers are called when a user controls the accessory via the Home app.
+     * Use handlers to send commands to your actual device (cloud API, local network, etc.).
+     */
+    handlers?: {
+        [clusterName: string]: MatterClusterHandlers;
+    };
+    /**
+     * 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 Configuration (for bridge or child bridge)
+ */
+export interface MatterConfig extends Record<string, unknown> {
+    /** Port for Matter server (optional, will auto-assign if not specified) */
+    port?: number;
+    /** Name for the Matter bridge (optional) */
+    name?: string;
+}
+/**
+ * Matter Fabric Information
+ * Represents a commissioned controller (fabric) on the Matter bridge
+ */
+export interface MatterFabricInfo {
+    fabricIndex: number;
+    fabricId: string;
+    nodeId: string;
+    rootVendorId: number;
+    label?: string;
+}
+/**
+ * Matter Server Events
+ * Event types emitted by the Matter server for commissioning lifecycle
+ */
+export interface MatterServerEvents {
+    /** Emitted when the bridge is commissioned for the first time */
+    'commissioned': (fabricInfo: MatterFabricInfo) => void;
+    /** Emitted when the last fabric is removed (bridge becomes uncommissioned) */
+    'decommissioned': () => void;
+    /** Emitted when a new fabric (controller) is added */
+    'fabric-added': (fabricInfo: MatterFabricInfo) => void;
+    /** Emitted when a fabric (controller) is removed */
+    'fabric-removed': (fabricInfo: MatterFabricInfo) => void;
+    /** Emitted whenever commissioning state changes (any fabric added/removed) */
+    'commissioning-changed': (commissioned: boolean, fabricCount: number) => void;
+    /** Emitted when an accessory is registered */
+    'accessory-registered': (accessory: MatterAccessory) => void;
+    /** Emitted when an accessory is unregistered */
+    'accessory-unregistered': (uuid: string) => void;
+}
+/**
+ * Internal Matter accessory representation
+ * (Used internally by MatterServer)
+ */
+export interface InternalMatterAccessory extends MatterAccessory {
+    _associatedPlugin?: string;
+    _associatedPlatform?: string;
+    endpoint?: Endpoint;
+    registered: boolean;
+}
+/**
+ * Matter error type enum (for error handler categorization)
+ */
+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"
+}
+/**
+ * Matter error details interface
+ */
+export interface MatterErrorDetails {
+    type?: MatterErrorType;
+    recoverable?: boolean;
+    code?: string;
+    context?: string;
+    originalError?: Error;
+}
+/**
+ * Matter error types
+ */
+export declare class MatterError extends Error {
+    readonly code: string;
+    readonly details?: MatterErrorDetails | undefined;
+    readonly type: MatterErrorType;
+    readonly timestamp: Date;
+    readonly recoverable: boolean;
+    constructor(message: string, code: string, details?: MatterErrorDetails | undefined, type?: MatterErrorType, recoverable?: boolean);
+}
+export declare class MatterCommissioningError extends MatterError {
+    constructor(message: string, details?: MatterErrorDetails);
+}
+export declare class MatterStorageError extends MatterError {
+    constructor(message: string, details?: MatterErrorDetails);
+}
+export declare class MatterDeviceError extends MatterError {
+    constructor(message: string, details?: MatterErrorDetails);
+}
+export declare class MatterNetworkError extends MatterError {
+    constructor(message: string, details?: MatterErrorDetails);
+}
+export { clusters };
+export { devices };
+/**
+ * Friendly device type names for the Plugin API
+ * Maps simplified names to actual Matter.js device types
+ */
+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;
+};
+/**
+ * Matter Cluster Names
+ * Commonly used cluster names for type safety and autocomplete
+ * Use these with api.updateMatterAccessoryState() and api.getAccessoryState()
+ *
+ * @example
+ * ```typescript
+ * // With autocomplete and type safety:
+ * api.updateMatterAccessoryState(uuid, api.matterClusterNames.OnOff, { onOff: true })
+ * api.getAccessoryState(uuid, api.matterClusterNames.LevelControl)
+ * ```
+ */
+export declare const 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 PumpConfigurationAndControl: "pumpConfigurationAndControl";
+    readonly Identify: "identify";
+    readonly BasicInformation: "basicInformation";
+    readonly BridgedDeviceBasicInformation: "bridgedDeviceBasicInformation";
+};
+/**
+ * Type for Matter cluster names
+ * Provides type safety for cluster name strings
+ */
+export type MatterClusterName = typeof clusterNames[keyof typeof clusterNames];
+//# sourceMappingURL=matterTypes.d.ts.map