homebridge 2.0.0-alpha.4 → 2.0.0-alpha.41

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

package/dist/matter/portAllocator.js.map

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

package/dist/platformAccessory.d.ts

@@ -0,0 +1,56 @@
+import type { Controller, ControllerConstructor, SerializedAccessory, Service, WithUUID } from 'hap-nodejs';
+import type { ConstructorArgs } from 'hap-nodejs/dist/types.js';
+import type { PlatformName, PluginIdentifier, PluginName } from './api.js';
+import { EventEmitter } from 'node:events';
+import { Accessory, Categories } from 'hap-nodejs';
+export type UnknownContext = Record<string, any>;
+export interface SerializedPlatformAccessory<T extends UnknownContext = UnknownContext> extends SerializedAccessory {
+    plugin: PluginName;
+    platform: PlatformName;
+    context: T;
+}
+export declare const enum PlatformAccessoryEvent {
+    IDENTIFY = "identify"
+}
+export declare interface PlatformAccessory {
+    on: (event: 'identify', listener: () => void) => this;
+    emit: (event: 'identify') => boolean;
+}
+export declare class PlatformAccessory<T extends UnknownContext = UnknownContext> extends EventEmitter {
+    private static injectedAccessory?;
+    _associatedPlugin?: PluginIdentifier;
+    _associatedPlatform?: PlatformName;
+    _associatedHAPAccessory: Accessory;
+    displayName: string;
+    UUID: string;
+    category: Categories;
+    services: Service[];
+    /**
+     * This is a way for Plugin developers to store custom data with their accessory
+     */
+    context: T;
+    constructor(displayName: string, uuid: string, category?: Categories);
+    updateDisplayName(name: string): void;
+    addService(service: Service): Service;
+    addService<S extends typeof Service>(serviceConstructor: S, ...constructorArgs: ConstructorArgs<S>): Service;
+    removeService(service: Service): void;
+    getService<T extends WithUUID<typeof Service>>(name: string | T): Service | undefined;
+    getServiceById<T extends WithUUID<typeof Service>>(uuid: string | T, subType: string): Service | undefined;
+    /**
+     * Configures a new controller for the given accessory.
+     * See {@link https://developers.homebridge.io/HAP-NodeJS/classes/accessory.html#configurecontroller | Accessory.configureController}.
+     *
+     * @param controller
+     */
+    configureController(controller: Controller | ControllerConstructor): void;
+    /**
+     * Removes a configured controller from the given accessory.
+     * See {@link https://developers.homebridge.io/HAP-NodeJS/classes/accessory.html#removecontroller | Accessory.removeController}.
+     *
+     * @param controller
+     */
+    removeController(controller: Controller): void;
+    static serialize(accessory: PlatformAccessory): SerializedPlatformAccessory;
+    static deserialize(json: SerializedPlatformAccessory): PlatformAccessory;
+}
+//# sourceMappingURL=platformAccessory.d.ts.map

package/dist/platformAccessory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platformAccessory.d.ts","sourceRoot":"","sources":["../src/platformAccessory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,mBAAmB,EACnB,OAAO,EAEP,QAAQ,EACT,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,EAAE,SAAS,EAAuB,UAAU,EAAE,MAAM,YAAY,CAAA;AAEvE,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAEhD,MAAM,WAAW,2BAA2B,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,mBAAmB;IACjH,MAAM,EAAE,UAAU,CAAA;IAClB,QAAQ,EAAE,YAAY,CAAA;IACtB,OAAO,EAAE,CAAC,CAAA;CACX;AAGD,0BAAkB,sBAAsB;IACtC,QAAQ,aAAa;CACtB;AAGD,MAAM,CAAC,OAAO,WAAW,iBAAiB;IACxC,EAAE,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IACrD,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAA;CACrC;AAGD,qBAAa,iBAAiB,CAAC,CAAC,SAAS,cAAc,GAAG,cAAc,CAAE,SAAQ,YAAY;IAE5F,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAW;IAE5C,iBAAiB,CAAC,EAAE,gBAAgB,CAAA;IACpC,mBAAmB,CAAC,EAAE,YAAY,CAAA;IAClC,uBAAuB,EAAE,SAAS,CAAA;IAGlC,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,UAAU,CAAA;IACpB,QAAQ,EAAE,OAAO,EAAE,CAAK;IAGxB;;OAEG;IACI,OAAO,EAAE,CAAC,CAAU;gBAEf,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,UAAU;IAuB7D,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAOrC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;IACrC,UAAU,CAAC,CAAC,SAAS,OAAO,OAAO,EAAE,kBAAkB,EAAE,CAAC,EAAE,GAAG,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO;IAQ5G,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIrC,UAAU,CAAC,CAAC,SAAS,QAAQ,CAAC,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,GAAG,OAAO,GAAG,SAAS;IAIrF,cAAc,CAAC,CAAC,SAAS,QAAQ,CAAC,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIjH;;;;;OAKG;IACI,mBAAmB,CAAC,UAAU,EAAE,UAAU,GAAG,qBAAqB,GAAG,IAAI;IAIhF;;;;;OAKG;IACI,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAKrD,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,iBAAiB,GAAG,2BAA2B;IAU3E,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,2BAA2B,GAAG,iBAAiB;CAczE"}

package/dist/platformAccessory.js

@@ -0,0 +1,105 @@
+import { EventEmitter } from 'node:events';
+import { Accessory } from 'hap-nodejs';
+// eslint-disable-next-line no-restricted-syntax
+export var PlatformAccessoryEvent;
+(function (PlatformAccessoryEvent) {
+    PlatformAccessoryEvent["IDENTIFY"] = "identify";
+})(PlatformAccessoryEvent || (PlatformAccessoryEvent = {}));
+// eslint-disable-next-line ts/no-unsafe-declaration-merging
+export class PlatformAccessory extends EventEmitter {
+    // somewhat ugly way to inject custom Accessory object, while not changing the publicly exposed constructor signature
+    static injectedAccessory;
+    _associatedPlugin; // present as soon as it is registered
+    _associatedPlatform; // not present for external accessories
+    _associatedHAPAccessory;
+    // ---------------- HAP Accessory mirror ----------------
+    displayName;
+    UUID;
+    category;
+    services = [];
+    // ------------------------------------------------------
+    /**
+     * This is a way for Plugin developers to store custom data with their accessory
+     */
+    context = {}; // providing something to store
+    constructor(displayName, uuid, category) {
+        super();
+        this._associatedHAPAccessory = PlatformAccessory.injectedAccessory
+            ? PlatformAccessory.injectedAccessory
+            : new Accessory(displayName, uuid);
+        if (category) {
+            this._associatedHAPAccessory.category = category;
+        }
+        this.displayName = this._associatedHAPAccessory.displayName;
+        this.UUID = this._associatedHAPAccessory.UUID;
+        this.category = category || 1 /* Categories.OTHER */;
+        this.services = this._associatedHAPAccessory.services;
+        // forward identify event
+        this._associatedHAPAccessory.on("identify" /* AccessoryEventTypes.IDENTIFY */, (paired, callback) => {
+            // @ts-expect-error: empty callback for backwards compatibility
+            this.emit("identify" /* PlatformAccessoryEvent.IDENTIFY */, paired, () => { });
+            callback();
+        });
+    }
+    updateDisplayName(name) {
+        if (name) {
+            this.displayName = name;
+            this._associatedHAPAccessory.displayName = name;
+        }
+    }
+    addService(service, ...constructorArgs) {
+        // @ts-expect-error: while the HAP-NodeJS interface was refined, the underlying implementation
+        //  still only operates on an any[] array. Therefore, do not require any additional checks here
+        //  we force the parameter unpack with expecting a ts-error.
+        return this._associatedHAPAccessory.addService(service, ...constructorArgs);
+    }
+    removeService(service) {
+        this._associatedHAPAccessory.removeService(service);
+    }
+    getService(name) {
+        return this._associatedHAPAccessory.getService(name);
+    }
+    getServiceById(uuid, subType) {
+        return this._associatedHAPAccessory.getServiceById(uuid, subType);
+    }
+    /**
+     * Configures a new controller for the given accessory.
+     * See {@link https://developers.homebridge.io/HAP-NodeJS/classes/accessory.html#configurecontroller | Accessory.configureController}.
+     *
+     * @param controller
+     */
+    configureController(controller) {
+        this._associatedHAPAccessory.configureController(controller);
+    }
+    /**
+     * Removes a configured controller from the given accessory.
+     * See {@link https://developers.homebridge.io/HAP-NodeJS/classes/accessory.html#removecontroller | Accessory.removeController}.
+     *
+     * @param controller
+     */
+    removeController(controller) {
+        this._associatedHAPAccessory.removeController(controller);
+    }
+    // private
+    static serialize(accessory) {
+        accessory._associatedHAPAccessory.displayName = accessory.displayName;
+        return {
+            plugin: accessory._associatedPlugin,
+            platform: accessory._associatedPlatform,
+            context: accessory.context,
+            ...Accessory.serialize(accessory._associatedHAPAccessory),
+        };
+    }
+    static deserialize(json) {
+        const accessory = Accessory.deserialize(json);
+        PlatformAccessory.injectedAccessory = accessory;
+        const platformAccessory = new PlatformAccessory(accessory.displayName, accessory.UUID);
+        PlatformAccessory.injectedAccessory = undefined;
+        platformAccessory._associatedPlugin = json.plugin;
+        platformAccessory._associatedPlatform = json.platform;
+        platformAccessory.context = json.context;
+        platformAccessory.category = json.category;
+        return platformAccessory;
+    }
+}
+//# sourceMappingURL=platformAccessory.js.map

package/dist/platformAccessory.js.map

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

package/dist/plugin.d.ts

@@ -0,0 +1,30 @@
+import type { AccessoryIdentifier, AccessoryName, AccessoryPluginConstructor, API, DynamicPlatformPlugin, PlatformIdentifier, PlatformName, PlatformPluginConstructor, PluginIdentifier, PluginName } from './api.js';
+import type { PackageJSON } from './pluginManager.js';
+/**
+ * Represents a loaded Homebridge plugin.
+ */
+export declare class Plugin {
+    private readonly pluginName;
+    private readonly scope?;
+    private readonly pluginPath;
+    disabled: boolean;
+    readonly version: string;
+    private readonly main;
+    private loadContext?;
+    private pluginInitializer?;
+    private readonly registeredAccessories;
+    private readonly registeredPlatforms;
+    private readonly activeDynamicPlatforms;
+    constructor(name: PluginName, path: string, packageJSON: PackageJSON, scope?: string);
+    getPluginIdentifier(): PluginIdentifier;
+    getPluginPath(): string;
+    registerAccessory(name: AccessoryName, constructor: AccessoryPluginConstructor): void;
+    registerPlatform(name: PlatformName, constructor: PlatformPluginConstructor): void;
+    getAccessoryConstructor(accessoryIdentifier: AccessoryIdentifier | AccessoryName): AccessoryPluginConstructor;
+    getPlatformConstructor(platformIdentifier: PlatformIdentifier | PlatformName): PlatformPluginConstructor;
+    assignDynamicPlatform(platformIdentifier: PlatformIdentifier | PlatformName, platformPlugin: DynamicPlatformPlugin): void;
+    getActiveDynamicPlatform(platformName: PlatformName): DynamicPlatformPlugin | undefined;
+    load(): Promise<void>;
+    initialize(api: API): void | Promise<void>;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,aAAa,EACb,0BAA0B,EAC1B,GAAG,EACH,qBAAqB,EACrB,kBAAkB,EAClB,YAAY,EACZ,yBAAyB,EACzB,gBAAgB,EAEhB,UAAU,EACX,MAAM,UAAU,CAAA;AACjB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAerD;;GAEG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;IACvC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAQ;IAC5B,QAAQ,UAAQ;IAGvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAQ;IAC7B,OAAO,CAAC,WAAW,CAAC,CAGnB;IAGD,OAAO,CAAC,iBAAiB,CAAC,CAAmB;IAC7C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAA4D;IAClG,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA0D;IAC9F,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAwD;gBAEnF,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,MAAM;IA+C7E,mBAAmB,IAAI,gBAAgB;IAIvC,aAAa,IAAI,MAAM;IAIvB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,WAAW,EAAE,0BAA0B,GAAG,IAAI;IAYrF,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,yBAAyB,GAAG,IAAI;IAYlF,uBAAuB,CAAC,mBAAmB,EAAE,mBAAmB,GAAG,aAAa,GAAG,0BAA0B;IAW7G,sBAAsB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,YAAY,GAAG,yBAAyB;IAiBxG,qBAAqB,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,YAAY,EAAE,cAAc,EAAE,qBAAqB,GAAG,IAAI;IAczH,wBAAwB,CAAC,YAAY,EAAE,YAAY,GAAG,qBAAqB,GAAG,SAAS;IAMjF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAkD3B,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CAOlD"}