homebridge 2.0.0-alpha.40 → 2.0.0-alpha.41

package/dist/matter/matterSharedTypes.d.ts

@@ -0,0 +1,167 @@
+/**
+ * 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 */
+    type: 'matter';
+    /** Current operational status */
+    status: MatterBridgeStatus;
+    /** Matter server port */
+    port?: number;
+    /** QR code payload for commissioning */
+    qrCode?: string;
+    /** Manual pairing code for commissioning */
+    manualPairingCode?: string;
+    /** Device serial number */
+    serialNumber?: string;
+    /** Display name of the bridge */
+    name: string;
+    /** Plugin identifier */
+    plugin: string;
+    /** Unique identifier for this bridge instance */
+    identifier: string;
+    /** Number of devices exposed by this bridge */
+    deviceCount: number;
+    /** Whether the bridge was manually stopped */
+    manuallyStopped?: boolean;
+    /** Process ID of the bridge if running as child process */
+    pid?: number;
+    /** Whether the bridge has been commissioned */
+    commissioned?: boolean;
+}
+/**
+ * Matter commissioning information
+ */
+export interface MatterCommissioningInfo {
+    /** 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;
+}
+/**
+ * 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
+ */
+export interface MatterServerConfig {
+    /** Server port */
+    port?: number;
+    /** Bridge name */
+    name?: string;
+    /** Unique identifier */
+    uniqueId?: string;
+    /** Storage path */
+    storagePath?: string;
+    /** mDNS interface */
+    mdnsInterface?: string;
+    /** Enable IPv4 */
+    ipv4?: boolean;
+    /** Enable IPv6 */
+    ipv6?: boolean;
+}
+/**
+ * Child Matter configuration (extends server config)
+ */
+export interface ChildMatterConfiguration extends Partial<MatterServerConfig> {
+    /** Whether Matter is enabled */
+    enabled?: boolean;
+    /** Bridge name override */
+    name?: string;
+    /** Debug mode flag */
+    debug?: boolean;
+}
+/**
+ * Matter accessories collection
+ */
+export interface MatterAccessoriesResponse {
+    /** Child bridge accessories indexed by bridge ID */
+    children: {
+        [bridgeId: string]: MatterAccessoryInfo[];
+    };
+}
+/**
+ * IPC message types for Matter child bridges
+ */
+export declare enum ChildMatterMessageType {
+    /** Sent from child when ready to accept config */
+    READY = "ready",
+    /** Sent to child with configuration */
+    LOAD = "load",
+    /** Sent from child when loaded */
+    LOADED = "loaded",
+    /** Sent to child to start the Matter bridge */
+    START = "start",
+    /** Sent from child when Matter bridge is online */
+    ONLINE = "online",
+    /** Sent to/from child to add an accessory */
+    ADD_ACCESSORY = "addAccessory",
+    /** Sent to/from child to remove an accessory */
+    REMOVE_ACCESSORY = "removeAccessory",
+    /** Sent from child with status updates */
+    STATUS_UPDATE = "statusUpdate",
+    /** Sent from child when requesting a port */
+    PORT_REQUEST = "portRequest",
+    /** Sent from child when an error occurs */
+    ERROR = "error",
+    /** Sent to child with allocated port */
+    PORT_ALLOCATED = "portAllocated",
+    /** Sent to child to shut down */
+    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,55 @@
+/**
+ * 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
+ */
+export var ChildMatterMessageType;
+(function (ChildMatterMessageType) {
+    /** Sent from child when ready to accept config */
+    ChildMatterMessageType["READY"] = "ready";
+    /** Sent to child with configuration */
+    ChildMatterMessageType["LOAD"] = "load";
+    /** Sent from child when loaded */
+    ChildMatterMessageType["LOADED"] = "loaded";
+    /** Sent to child to start the Matter bridge */
+    ChildMatterMessageType["START"] = "start";
+    /** Sent from child when Matter bridge is online */
+    ChildMatterMessageType["ONLINE"] = "online";
+    /** Sent to/from child to add an accessory */
+    ChildMatterMessageType["ADD_ACCESSORY"] = "addAccessory";
+    /** Sent to/from child to remove an accessory */
+    ChildMatterMessageType["REMOVE_ACCESSORY"] = "removeAccessory";
+    /** Sent from child with status updates */
+    ChildMatterMessageType["STATUS_UPDATE"] = "statusUpdate";
+    /** Sent from child when requesting a port */
+    ChildMatterMessageType["PORT_REQUEST"] = "portRequest";
+    /** Sent from child when an error occurs */
+    ChildMatterMessageType["ERROR"] = "error";
+    /** Sent to child with allocated port */
+    ChildMatterMessageType["PORT_ALLOCATED"] = "portAllocated";
+    /** Sent to child to shut down */
+    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;AAwHD;;GAEG;AACH,MAAM,CAAN,IAAY,sBAyBX;AAzBD,WAAY,sBAAsB;IAChC,kDAAkD;IAClD,yCAAe,CAAA;IACf,uCAAuC;IACvC,uCAAa,CAAA;IACb,kCAAkC;IAClC,2CAAiB,CAAA;IACjB,+CAA+C;IAC/C,yCAAe,CAAA;IACf,mDAAmD;IACnD,2CAAiB,CAAA;IACjB,6CAA6C;IAC7C,wDAA8B,CAAA;IAC9B,gDAAgD;IAChD,8DAAoC,CAAA;IACpC,0CAA0C;IAC1C,wDAA8B,CAAA;IAC9B,6CAA6C;IAC7C,sDAA4B,CAAA;IAC5B,2CAA2C;IAC3C,yCAAe,CAAA;IACf,wCAAwC;IACxC,0DAAgC,CAAA;IAChC,iCAAiC;IACjC,+CAAqB,CAAA;AACvB,CAAC,EAzBW,sBAAsB,KAAtB,sBAAsB,QAyBjC"}

package/dist/{matterTypes.d.ts → matter/matterTypes.d.ts}

@@ -1,3 +1,18 @@
+import { HomebridgeOptions } from '../server.js';
+/**
+ * Matter bridge configuration interface
+ */
+export interface MatterConfiguration {
+    port?: number;
+    name?: string;
+}
+/**
+ * Matter bridge options extending Homebridge options
+ */
+export interface MatterBridgeOptions extends HomebridgeOptions {
+    matterBridgeServerPort?: number;
+    configPath?: string;
+}
 declare const MatterClusters: Record<string, unknown>;
 declare const MatterDeviceTypes: Record<string, unknown>;
 /**

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

@@ -0,0 +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"}

package/dist/{matterTypes.js → matter/matterTypes.js}

@@ -7,8 +7,8 @@ import * as devices from '@matter/main/devices';
  * This module provides access to standard Matter device types and clusters
  * that plugin developers can use to create Matter-compatible devices.
  */
-import { Logger } from './logger.js';
-const log = Logger.internal;
+import { Logger } from '../logger.js';
+const log = Logger.withPrefix('Matter');
 const MatterClusters = {};
 const MatterDeviceTypes = {};
 try {
@@ -219,8 +219,8 @@ export const HAPToMatterDeviceMapping = {
     // Window covering services
     WindowCovering: 'WindowCovering',
     // Other services
-    StatelessProgrammableSwitch: 'GenericSwitch',
-    Valve: 'WaterValve',
+    StatelessProgrammableSwitch: 'OnOffLightSwitch', // Use light switch as closest match
+    Valve: 'OnOffPlugInUnit', // Use outlet as closest match for valve control
 };
 /**
  * Helper function to get Matter device type for a HomeKit service

package/dist/matter/matterTypes.js.map

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

package/dist/matter/portAllocator.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Port Allocator for Matter Bridges
+ *
+ * Thread-safe port allocation with conflict prevention
+ * and automatic port discovery
+ */
+/**
+ * Port allocation result
+ */
+export interface PortAllocation {
+    port: number;
+    type: 'matter' | 'hap';
+    identifier: string;
+    allocated: Date;
+}
+/**
+ * Port allocator with thread-safe allocation and tracking
+ */
+export declare class PortAllocator {
+    private static instance;
+    private allocatedPorts;
+    private reservedRanges;
+    private mutex;
+    private defaultMatterStart;
+    private defaultMatterEnd;
+    private defaultHAPStart;
+    private defaultHAPEnd;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(): PortAllocator;
+    /**
+     * Allocate a port for Matter or HAP
+     */
+    allocatePort(type: 'matter' | 'hap', identifier: string, preferredPort?: number): Promise<number>;
+    /**
+     * Release an allocated port
+     */
+    releasePort(port: number): Promise<void>;
+    /**
+     * Release all ports for an identifier
+     */
+    releasePorts(identifier: string): Promise<void>;
+    /**
+     * Check if a port is available
+     */
+    private isPortAvailable;
+    /**
+     * Find any available port
+     */
+    private findAvailablePort;
+    /**
+     * Get all allocated ports
+     */
+    getAllocatedPorts(): Map<number, PortAllocation>;
+    /**
+     * Check for port conflicts
+     */
+    checkForConflicts(): Promise<Array<{
+        port: number;
+        identifier: string;
+        available: boolean;
+    }>>;
+    /**
+     * Clear all allocations (use with caution)
+     */
+    clearAllocations(): void;
+    /**
+     * Set custom port range for a type
+     */
+    setPortRange(type: 'matter' | 'hap', start: number, end: number): void;
+    /**
+     * Get statistics about port allocation
+     */
+    getStats(): {
+        totalAllocated: number;
+        matterPorts: number;
+        hapPorts: number;
+        oldestAllocation?: Date;
+        newestAllocation?: Date;
+    };
+}
+export declare const portAllocator: PortAllocator;
+//# sourceMappingURL=portAllocator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portAllocator.d.ts","sourceRoot":"","sources":["../../src/matter/portAllocator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA4DH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,IAAI,CAAA;CAChB;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,cAAc,CAAoC;IAC1D,OAAO,CAAC,cAAc,CAAoD;IAC1E,OAAO,CAAC,KAAK,CAAc;IAC3B,OAAO,CAAC,kBAAkB,CAAO;IACjC,OAAO,CAAC,gBAAgB,CAAO;IAC/B,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,aAAa,CAAQ;IAE7B,OAAO;IAYP;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,aAAa;IAOnC;;OAEG;IACG,YAAY,CAChB,IAAI,EAAE,QAAQ,GAAG,KAAK,EACtB,UAAU,EAAE,MAAM,EAClB,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC;IAkDlB;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU9C;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrD;;OAEG;YACW,eAAe;IA6B7B;;OAEG;YACW,iBAAiB;IA0B/B;;OAEG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC;IAIhD;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAiBnG;;OAEG;IACH,gBAAgB,IAAI,IAAI;IAKxB;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAStE;;OAEG;IACH,QAAQ,IAAI;QACV,cAAc,EAAE,MAAM,CAAA;QACtB,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;QAChB,gBAAgB,CAAC,EAAE,IAAI,CAAA;QACvB,gBAAgB,CAAC,EAAE,IAAI,CAAA;KACxB;CA6BF;AAGD,eAAO,MAAM,aAAa,eAA8B,CAAA"}

package/dist/matter/portAllocator.js

@@ -0,0 +1,296 @@
+/**
+ * Port Allocator for Matter Bridges
+ *
+ * Thread-safe port allocation with conflict prevention
+ * and automatic port discovery
+ */
+import * as net from 'node:net';
+import { Logger } from '../logger.js';
+const log = Logger.withPrefix('Matter');
+/**
+ * Simple mutex implementation for synchronization
+ */
+class Mutex {
+    queue = [];
+    locked = false;
+    MAX_QUEUE_SIZE = 100; // Prevent unbounded growth
+    /**
+     * Acquire the lock
+     */
+    async acquire() {
+        if (!this.locked) {
+            this.locked = true;
+            return;
+        }
+        // Prevent queue from growing unbounded
+        if (this.queue.length >= this.MAX_QUEUE_SIZE) {
+            throw new Error(`Port allocator queue exceeded maximum size (${this.MAX_QUEUE_SIZE})`);
+        }
+        return new Promise((resolve) => {
+            this.queue.push(resolve);
+        });
+    }
+    /**
+     * Release the lock
+     */
+    release() {
+        const next = this.queue.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this.locked = false;
+        }
+    }
+    /**
+     * Run a function exclusively with the lock
+     */
+    async runExclusive(fn) {
+        await this.acquire();
+        try {
+            return await fn();
+        }
+        finally {
+            this.release();
+        }
+    }
+}
+/**
+ * Port allocator with thread-safe allocation and tracking
+ */
+export class PortAllocator {
+    static instance;
+    allocatedPorts = new Map();
+    reservedRanges = new Map();
+    mutex = new Mutex();
+    defaultMatterStart = 5540;
+    defaultMatterEnd = 5580;
+    defaultHAPStart = 51826;
+    defaultHAPEnd = 51926;
+    constructor() {
+        // Reserve default ranges
+        this.reservedRanges.set('matter', {
+            start: this.defaultMatterStart,
+            end: this.defaultMatterEnd,
+        });
+        this.reservedRanges.set('hap', {
+            start: this.defaultHAPStart,
+            end: this.defaultHAPEnd,
+        });
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance() {
+        if (!PortAllocator.instance) {
+            PortAllocator.instance = new PortAllocator();
+        }
+        return PortAllocator.instance;
+    }
+    /**
+     * Allocate a port for Matter or HAP
+     */
+    async allocatePort(type, identifier, preferredPort) {
+        return this.mutex.runExclusive(async () => {
+            // Try preferred port first
+            if (preferredPort) {
+                if (await this.isPortAvailable(preferredPort)) {
+                    this.allocatedPorts.set(preferredPort, {
+                        port: preferredPort,
+                        type,
+                        identifier,
+                        allocated: new Date(),
+                    });
+                    log.info(`Allocated port ${preferredPort} for ${type} bridge: ${identifier}`);
+                    return preferredPort;
+                }
+                else {
+                    log.warn(`Preferred port ${preferredPort} is not available for ${identifier}`);
+                }
+            }
+            // Find an available port in the appropriate range
+            const range = this.reservedRanges.get(type);
+            if (!range) {
+                throw new Error(`No port range defined for type: ${type}`);
+            }
+            for (let port = range.start; port <= range.end; port++) {
+                if (!this.allocatedPorts.has(port) && await this.isPortAvailable(port)) {
+                    this.allocatedPorts.set(port, {
+                        port,
+                        type,
+                        identifier,
+                        allocated: new Date(),
+                    });
+                    log.info(`Allocated port ${port} for ${type} bridge: ${identifier}`);
+                    return port;
+                }
+            }
+            // If no port in range is available, try to find any available port
+            const fallbackPort = await this.findAvailablePort();
+            this.allocatedPorts.set(fallbackPort, {
+                port: fallbackPort,
+                type,
+                identifier,
+                allocated: new Date(),
+            });
+            log.warn(`Allocated fallback port ${fallbackPort} for ${type} bridge: ${identifier}`);
+            return fallbackPort;
+        });
+    }
+    /**
+     * Release an allocated port
+     */
+    async releasePort(port) {
+        return this.mutex.runExclusive(async () => {
+            const allocation = this.allocatedPorts.get(port);
+            if (allocation) {
+                this.allocatedPorts.delete(port);
+                log.debug(`Released port ${port} (was allocated to ${allocation.identifier})`);
+            }
+        });
+    }
+    /**
+     * Release all ports for an identifier
+     */
+    async releasePorts(identifier) {
+        return this.mutex.runExclusive(async () => {
+            const portsToRelease = [];
+            for (const [port, allocation] of this.allocatedPorts) {
+                if (allocation.identifier === identifier) {
+                    portsToRelease.push(port);
+                }
+            }
+            for (const port of portsToRelease) {
+                this.allocatedPorts.delete(port);
+                log.debug(`Released port ${port} for identifier ${identifier}`);
+            }
+        });
+    }
+    /**
+     * Check if a port is available
+     */
+    async isPortAvailable(port) {
+        // Check if already allocated by us
+        if (this.allocatedPorts.has(port)) {
+            return false;
+        }
+        // Check if port is actually available on the system
+        return new Promise((resolve) => {
+            const server = net.createServer();
+            server.once('error', (err) => {
+                if (err.code === 'EADDRINUSE') {
+                    resolve(false);
+                }
+                else {
+                    // Other errors, assume port is not available
+                    resolve(false);
+                }
+            });
+            server.once('listening', () => {
+                server.close(() => {
+                    resolve(true);
+                });
+            });
+            server.listen(port, '0.0.0.0');
+        });
+    }
+    /**
+     * Find any available port
+     */
+    async findAvailablePort() {
+        return new Promise((resolve, reject) => {
+            const server = net.createServer();
+            server.once('error', (err) => {
+                reject(err);
+            });
+            server.once('listening', () => {
+                const address = server.address();
+                if (address && typeof address === 'object') {
+                    const port = address.port;
+                    server.close(() => {
+                        resolve(port);
+                    });
+                }
+                else {
+                    server.close();
+                    reject(new Error('Could not determine port'));
+                }
+            });
+            // Listen on port 0 to get a random available port
+            server.listen(0, '0.0.0.0');
+        });
+    }
+    /**
+     * Get all allocated ports
+     */
+    getAllocatedPorts() {
+        return new Map(this.allocatedPorts);
+    }
+    /**
+     * Check for port conflicts
+     */
+    async checkForConflicts() {
+        const conflicts = [];
+        for (const [port, allocation] of this.allocatedPorts) {
+            const available = await this.isPortAvailable(port);
+            if (!available) {
+                conflicts.push({
+                    port,
+                    identifier: allocation.identifier,
+                    available,
+                });
+            }
+        }
+        return conflicts;
+    }
+    /**
+     * Clear all allocations (use with caution)
+     */
+    clearAllocations() {
+        this.allocatedPorts.clear();
+        log.warn('Cleared all port allocations');
+    }
+    /**
+     * Set custom port range for a type
+     */
+    setPortRange(type, start, end) {
+        if (start < 1024 || end > 65535 || start > end) {
+            throw new Error('Invalid port range');
+        }
+        this.reservedRanges.set(type, { start, end });
+        log.info(`Set ${type} port range to ${start}-${end}`);
+    }
+    /**
+     * Get statistics about port allocation
+     */
+    getStats() {
+        let matterPorts = 0;
+        let hapPorts = 0;
+        let oldest;
+        let newest;
+        for (const allocation of this.allocatedPorts.values()) {
+            if (allocation.type === 'matter') {
+                matterPorts++;
+            }
+            else {
+                hapPorts++;
+            }
+            if (!oldest || allocation.allocated < oldest) {
+                oldest = allocation.allocated;
+            }
+            if (!newest || allocation.allocated > newest) {
+                newest = allocation.allocated;
+            }
+        }
+        return {
+            totalAllocated: this.allocatedPorts.size,
+            matterPorts,
+            hapPorts,
+            oldestAllocation: oldest,
+            newestAllocation: newest,
+        };
+    }
+}
+// Export singleton instance
+export const portAllocator = PortAllocator.getInstance();
+//# sourceMappingURL=portAllocator.js.map