homebridge 2.0.0-alpha.37 → 2.0.0-alpha.38

package/dist/matterService.d.ts

@@ -0,0 +1,168 @@
+import { HomebridgeAPI } from './api.js';
+import { ExternalPortService } from './externalPortService.js';
+import { PlatformAccessory } from './platformAccessory.js';
+import { PluginManager } from './pluginManager.js';
+import { HomebridgeOptions } from './server.js';
+import '@matter/main';
+export interface MatterConfiguration {
+    enabled?: boolean;
+    port?: number;
+    discriminator?: number;
+    passcode?: number;
+    vendorId?: number;
+    productId?: number;
+    deviceName?: string;
+    deviceType?: number;
+    storageDir?: string;
+    debugEnabled?: boolean;
+    interfaceName?: string;
+    announceInterval?: number;
+    commissioningTimeout?: number;
+}
+export interface MatterBridgeOptions extends HomebridgeOptions {
+    matterConfig?: MatterConfiguration;
+}
+/**
+ * Matter service for publishing accessories via Matter protocol
+ * This runs alongside the existing HAP bridge service
+ */
+export declare class MatterService {
+    private matterConfiguration;
+    private pluginManager;
+    private externalPortService;
+    private api;
+    private options;
+    private matterServer;
+    private commissioningServer;
+    private storageManager;
+    private readonly isEnabled;
+    private readonly matterConfig;
+    private publishedAccessories;
+    private isInitialized;
+    private isStarted;
+    constructor(matterConfiguration: MatterConfiguration, pluginManager: PluginManager, externalPortService: ExternalPortService, api: HomebridgeAPI, options: HomebridgeOptions);
+    /**
+     * Validate Matter configuration parameters
+     */
+    private validateConfiguration;
+    /**
+     * Initialize the Matter server if enabled
+     */
+    initialize(): Promise<void>;
+    /**
+     * Initialize storage for Matter server
+     */
+    private initializeStorage;
+    /**
+     * Create the Matter server node
+     */
+    private createMatterServer;
+    /**
+     * Setup commissioning server for device pairing
+     */
+    private setupCommissioningServer;
+    /**
+     * Generate a unique serial number for the Matter bridge
+     */
+    private generateSerialNumber;
+    /**
+     * Generate a unique identifier for the Matter bridge
+     */
+    private generateUniqueId;
+    /**
+     * Log commissioning information for users
+     */
+    private logCommissioningInfo;
+    /**
+     * Format passcode for manual pairing
+     */
+    private formatPairingCode;
+    /**
+     * Start the Matter server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the Matter server
+     */
+    stop(): Promise<void>;
+    /**
+     * Clean up resources
+     */
+    private cleanup;
+    /**
+     * Publish a platform accessory via Matter protocol
+     */
+    publishAccessory(accessory: PlatformAccessory): Promise<void>;
+    /**
+     * Unpublish a platform accessory from Matter protocol
+     */
+    unpublishAccessory(accessory: PlatformAccessory): Promise<void>;
+    /**
+     * Convert HAP accessory to Matter device
+     * This maps HAP services and characteristics to appropriate Matter clusters and attributes
+     */
+    private convertToMatterDevice;
+    /**
+     * Get the primary service from an accessory (excluding utility services)
+     */
+    private getPrimaryService;
+    /**
+     * Determine the appropriate Matter device type for a HAP service
+     */
+    private getMatterDeviceType;
+    /**
+     * Create a Matter device with the specified type and map characteristics
+     */
+    private createMatterDevice;
+    /**
+     * Get placeholder clusters for a device type
+     */
+    private getPlaceholderClusters;
+    /**
+     * Map HAP characteristics to Matter cluster attributes
+     */
+    private mapCharacteristicsToMatter;
+    /**
+     * Get the Matter cluster name for a HAP characteristic
+     */
+    private getMatterClusterForCharacteristic;
+    /**
+     * Get the Matter attribute name for a HAP characteristic
+     */
+    private getMatterAttributeForCharacteristic;
+    /**
+     * Get Matter server status
+     */
+    getStatus(): {
+        enabled: boolean;
+        running: boolean;
+        accessoryCount: number;
+        qrCode?: string;
+        setupCode?: string;
+    };
+    /**
+     * Get commissioning QR code for setup
+     */
+    getCommissioningQRCode(): string | null;
+    /**
+     * Get manual pairing code for setup
+     */
+    getManualPairingCode(): string | null;
+    /**
+     * Get list of published accessories
+     */
+    getPublishedAccessories(): PlatformAccessory[];
+    /**
+     * Check if an accessory is published via Matter
+     */
+    isAccessoryPublished(accessory: PlatformAccessory): boolean;
+    /**
+     * Get Matter configuration (read-only)
+     */
+    getConfiguration(): Readonly<MatterConfiguration>;
+    /**
+     * Force restart the Matter server (for configuration changes)
+     */
+    restart(): Promise<void>;
+}
+//# sourceMappingURL=matterService.d.ts.map

package/dist/matterService.d.ts.map

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