homebridge 2.0.0-beta.30 → 2.0.0-beta.32

package/dist/matter/matterSharedTypes.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Shared Matter Types
+ *
+ * These types are used by both the homebridge core and the UI
+ * to ensure consistency across the Matter implementation.
+ */
+/**
+ * Matter bridge status states
+ */
+export declare enum MatterBridgeStatus {
+    /**
+     * When the Matter bridge is loading or restarting
+     */
+    PENDING = "pending",
+    /**
+     * The Matter bridge is online and ready for commissioning
+     */
+    OK = "ok",
+    /**
+     * The bridge is shutting down or stopped
+     */
+    DOWN = "down"
+}
+/**
+ * Metadata for a Matter bridge instance
+ */
+export interface MatterBridgeMetadata {
+    /** Bridge type identifier (always 'matter') */
+    type: 'matter';
+    /** Current operational status */
+    status: MatterBridgeStatus;
+    /** Bridge username/identifier */
+    username?: string;
+    /** Bridge port number */
+    port?: number;
+    /** Display name of the bridge */
+    name: string;
+    /** Plugin identifier that owns this bridge */
+    plugin: string;
+    /** Unique identifier for this bridge instance */
+    identifier: string;
+    /** Whether the bridge was manually stopped */
+    manuallyStopped?: boolean;
+    /** Process ID of the bridge if running as child process */
+    pid?: number;
+    /** QR code payload for commissioning */
+    qrCode?: string;
+    /** Manual pairing code for commissioning */
+    manualPairingCode?: string;
+    /** Device serial number */
+    serialNumber?: string;
+    /** Number of devices exposed by this bridge */
+    deviceCount: number;
+    /** Whether the bridge has been commissioned */
+    commissioned?: boolean;
+}
+/**
+ * Matter commissioning information
+ */
+export interface MatterCommissioningInfo {
+    /** Bridge type (always 'matter') */
+    type?: 'matter';
+    /** Setup URI/QR code for pairing */
+    setupUri?: string | null;
+    /** PIN/pairing code */
+    pin?: string | null;
+    /** QR code payload for commissioning */
+    qrCode?: string;
+    /** Manual pairing code for commissioning */
+    manualPairingCode?: string;
+    /** Device serial number */
+    serialNumber?: string;
+    /** Whether the device is commissioned */
+    commissioned: boolean;
+    /** Port number if applicable */
+    port?: number;
+}
+/**
+ * Matter accessory information
+ */
+export interface MatterAccessoryInfo {
+    /** Unique identifier */
+    uuid: string;
+    /** Display name */
+    displayName: string;
+    /** HAP category */
+    category: number;
+    /** Matter device information */
+    matterInfo?: {
+        /** Whether this is a bridged device */
+        bridged: boolean;
+        /** Child bridge identifier if bridged */
+        childBridge?: string;
+        /** Matter device type */
+        deviceType?: string;
+    };
+    /** HAP services */
+    services?: Array<{
+        type: string;
+        subtype?: string;
+        displayName?: string;
+        characteristics: Array<{
+            type: string;
+            value: any;
+            props: any;
+        }>;
+    }>;
+}
+/**
+ * Matter server configuration
+ * Used internally by MatterServer class
+ */
+export interface MatterServerConfig {
+    /** Server port */
+    port?: number;
+    /** Unique identifier (REQUIRED - must be unique for each Matter bridge instance) */
+    uniqueId: string;
+    /** Storage path */
+    storagePath?: string;
+    /** Manufacturer name (inherited from bridge config) */
+    manufacturer?: string;
+    /** Model name (inherited from bridge config) */
+    model?: string;
+    /** Firmware revision (inherited from bridge config) */
+    firmwareRevision?: string;
+    /** Serial number (inherited from bridge config) */
+    serialNumber?: string;
+    /** Enable debug mode for verbose logging */
+    debugModeEnabled?: boolean;
+    /** External accessory mode - device is not bridged and so added before server starts */
+    externalAccessory?: boolean;
+    /** Network interfaces to bind to (inherited from `bridge.bind` config) */
+    networkInterfaces?: string[];
+}
+/**
+ * Matter accessories collection
+ */
+export interface MatterAccessoriesResponse {
+    /** Child bridge accessories indexed by bridge ID */
+    children: {
+        [bridgeId: string]: MatterAccessoryInfo[];
+    };
+}
+/**
+ * IPC message types for Matter child bridges
+ * These message types coordinate communication between the main process and Matter child bridge processes
+ */
+export declare enum ChildMatterMessageType {
+    /** Sent from child process when ready to accept configuration */
+    READY = "ready",
+    /** Sent to child process with bridge configuration */
+    LOAD = "load",
+    /** Sent from child process when configuration has been loaded */
+    LOADED = "loaded",
+    /** Sent to child process to start the Matter bridge */
+    START = "start",
+    /** Sent from child process when Matter bridge is online and advertising */
+    ONLINE = "online",
+    /** Sent to/from child process to add a Matter accessory */
+    ADD_ACCESSORY = "addAccessory",
+    /** Sent to/from child process to remove a Matter accessory */
+    REMOVE_ACCESSORY = "removeAccessory",
+    /** Sent from child process with commissioning and operational status updates */
+    STATUS_UPDATE = "statusUpdate",
+    /** Sent from child process when an error occurs */
+    ERROR = "error",
+    /** Sent to child process to initiate graceful shutdown */
+    SHUTDOWN = "shutdown"
+}
+//# sourceMappingURL=matterSharedTypes.d.ts.map

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

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

package/dist/matter/matterSharedTypes.js

@@ -0,0 +1,52 @@
+/**
+ * Shared Matter Types
+ *
+ * These types are used by both the homebridge core and the UI
+ * to ensure consistency across the Matter implementation.
+ */
+/**
+ * Matter bridge status states
+ */
+export var MatterBridgeStatus;
+(function (MatterBridgeStatus) {
+    /**
+     * When the Matter bridge is loading or restarting
+     */
+    MatterBridgeStatus["PENDING"] = "pending";
+    /**
+     * The Matter bridge is online and ready for commissioning
+     */
+    MatterBridgeStatus["OK"] = "ok";
+    /**
+     * The bridge is shutting down or stopped
+     */
+    MatterBridgeStatus["DOWN"] = "down";
+})(MatterBridgeStatus || (MatterBridgeStatus = {}));
+/**
+ * IPC message types for Matter child bridges
+ * These message types coordinate communication between the main process and Matter child bridge processes
+ */
+export var ChildMatterMessageType;
+(function (ChildMatterMessageType) {
+    /** Sent from child process when ready to accept configuration */
+    ChildMatterMessageType["READY"] = "ready";
+    /** Sent to child process with bridge configuration */
+    ChildMatterMessageType["LOAD"] = "load";
+    /** Sent from child process when configuration has been loaded */
+    ChildMatterMessageType["LOADED"] = "loaded";
+    /** Sent to child process to start the Matter bridge */
+    ChildMatterMessageType["START"] = "start";
+    /** Sent from child process when Matter bridge is online and advertising */
+    ChildMatterMessageType["ONLINE"] = "online";
+    /** Sent to/from child process to add a Matter accessory */
+    ChildMatterMessageType["ADD_ACCESSORY"] = "addAccessory";
+    /** Sent to/from child process to remove a Matter accessory */
+    ChildMatterMessageType["REMOVE_ACCESSORY"] = "removeAccessory";
+    /** Sent from child process with commissioning and operational status updates */
+    ChildMatterMessageType["STATUS_UPDATE"] = "statusUpdate";
+    /** Sent from child process when an error occurs */
+    ChildMatterMessageType["ERROR"] = "error";
+    /** Sent to child process to initiate graceful shutdown */
+    ChildMatterMessageType["SHUTDOWN"] = "shutdown";
+})(ChildMatterMessageType || (ChildMatterMessageType = {}));
+//# sourceMappingURL=matterSharedTypes.js.map

package/dist/matter/matterSharedTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"matterSharedTypes.js","sourceRoot":"","sources":["../../src/matter/matterSharedTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,kBAeX;AAfD,WAAY,kBAAkB;IAC5B;;OAEG;IACH,yCAAmB,CAAA;IAEnB;;OAEG;IACH,+BAAS,CAAA;IAET;;OAEG;IACH,mCAAa,CAAA;AACf,CAAC,EAfW,kBAAkB,KAAlB,kBAAkB,QAe7B;AA6HD;;;GAGG;AACH,MAAM,CAAN,IAAY,sBAqBX;AArBD,WAAY,sBAAsB;IAChC,iEAAiE;IACjE,yCAAe,CAAA;IACf,sDAAsD;IACtD,uCAAa,CAAA;IACb,iEAAiE;IACjE,2CAAiB,CAAA;IACjB,uDAAuD;IACvD,yCAAe,CAAA;IACf,2EAA2E;IAC3E,2CAAiB,CAAA;IACjB,2DAA2D;IAC3D,wDAA8B,CAAA;IAC9B,8DAA8D;IAC9D,8DAAoC,CAAA;IACpC,gFAAgF;IAChF,wDAA8B,CAAA;IAC9B,mDAAmD;IACnD,yCAAe,CAAA;IACf,0DAA0D;IAC1D,+CAAqB,CAAA;AACvB,CAAC,EArBW,sBAAsB,KAAtB,sBAAsB,QAqBjC"}

package/dist/matter/matterStorage.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Custom Matter.js StorageContext implementation for Homebridge
+ * Provides persistent storage for fabric data and device configuration
+ */
+export declare class HomebridgeMatterStorage {
+    private namespace;
+    private storage;
+    private readonly filePath;
+    private isInitialized;
+    private writeTimer;
+    private pendingWrite;
+    private persistLock;
+    constructor(namespace: string, storagePath: string);
+    /**
+     * Synchronously initialize storage by loading existing data
+     * This is called in the constructor to ensure storage is ready immediately
+     */
+    private initializeSync;
+    /**
+     * Initialize storage and load existing data (async for compatibility)
+     * Note: Storage is now initialized synchronously in constructor
+     */
+    initialize(): Promise<void>;
+    /**
+     * Build a context key from an array of contexts
+     */
+    private buildContextKey;
+    /**
+     * 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
+     */
+    private deserializeValue;
+    /**
+     * Get a value from storage (Matter.js interface)
+     * Values are already deserialized during load, so no additional deserialization needed
+     */
+    get(contexts: string[], key: string): unknown | undefined;
+    /**
+     * Set a value in storage (Matter.js interface)
+     */
+    set(contexts: string[], key: string, value: unknown): void;
+    set(contexts: string[], values: Record<string, unknown>): void;
+    /**
+     * Delete a key from storage (Matter.js interface)
+     */
+    delete(contexts: string[], key: string): void;
+    /**
+     * Clear all storage in a context (Matter.js interface)
+     */
+    clearAll(contexts: string[]): void;
+    /**
+     * Get all keys in a context (Matter.js interface)
+     */
+    keys(contexts: string[]): string[];
+    /**
+     * Get all child context names (Matter.js interface)
+     */
+    contexts(contexts: string[]): string[];
+    /**
+     * Check if a key exists (Matter.js interface)
+     */
+    has(contexts: string[], key: string): boolean;
+    /**
+     * Get all values in a context
+     * Returns direct children only (does not include nested contexts)
+     */
+    values(contexts: string[]): Promise<Record<string, unknown>>;
+    /**
+     * Schedule a persist operation (debounced)
+     */
+    private schedulePersist;
+    /**
+     * Persist storage to disk with atomic write
+     */
+    private persist;
+    /**
+     * Force immediate persist (for shutdown)
+     */
+    forcePersist(): Promise<void>;
+    /**
+     * Close and cleanup storage
+     */
+    close(): Promise<void>;
+    /**
+     * Get storage statistics
+     */
+    getStats(): {
+        entries: number;
+        namespace: string;
+        path: string;
+    };
+}
+/**
+ * Storage Manager for Matter.js
+ * Manages multiple storage contexts for different namespaces
+ */
+export declare class MatterStorageManager {
+    private storagePath;
+    private storages;
+    constructor(storagePath: string);
+    /**
+     * Get or create a storage context for a namespace
+     */
+    getStorage(namespace: string): HomebridgeMatterStorage;
+    /**
+     * Close all storage contexts
+     */
+    closeAll(): Promise<void>;
+    /**
+     * Get statistics for all storage contexts
+     */
+    getAllStats(): Array<{
+        entries: number;
+        namespace: string;
+        path: string;
+    }>;
+}
+//# sourceMappingURL=matterStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"matterStorage.d.ts","sourceRoot":"","sources":["../../src/matter/matterStorage.ts"],"names":[],"mappings":"AAqBA;;;GAGG;AACH,qBAAa,uBAAuB;IAShC,OAAO,CAAC,SAAS;IARnB,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,aAAa,CAAQ;IAC7B,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,WAAW,CAA6B;gBAGtC,SAAS,EAAE,MAAM,EACzB,WAAW,EAAE,MAAM;IASrB;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgCtB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAKjC;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,gBAAgB;IAiCxB;;;OAGG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAMzD;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI;IAC1D,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAkB9D;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAQ7C;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI;IAsBlC;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IA8BlC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE;IA+BtC;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ7C;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAuBlE;;OAEG;YACW,eAAe;IAsB7B;;OAEG;YACW,OAAO;IAqDrB;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAUnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAM5B;;OAEG;IACH,QAAQ,IAAI;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;CAOjE;AAED;;;GAGG;AACH,qBAAa,oBAAoB;IAGnB,OAAO,CAAC,WAAW;IAF/B,OAAO,CAAC,QAAQ,CAAkD;gBAE9C,WAAW,EAAE,MAAM;IAEvC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,uBAAuB;IAStD;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAM/B;;OAEG;IACH,WAAW,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAG3E"}