homebridge 2.0.0-alpha.40 → 2.0.0-alpha.42

package/dist/matter/matterStorage.js

@@ -0,0 +1,355 @@
+/* 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 * 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;
+    storagePath;
+    storage = new Map();
+    filePath;
+    isInitialized = false;
+    initializationPromise = null;
+    writeTimer = null;
+    pendingWrite = false;
+    constructor(namespace, storagePath) {
+        this.namespace = namespace;
+        this.storagePath = storagePath;
+        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');
+            // Custom reviver to handle BigInt deserialization
+            const data = JSON.parse(fileContent, (_key, value) => {
+                if (value && typeof value === 'object' && value.__type === 'bigint') {
+                    return BigInt(value.value);
+                }
+                return value;
+            });
+            // Ensure data is valid before loading
+            if (data && typeof data === 'object') {
+                this.storage = new Map(Object.entries(data));
+                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('.');
+    }
+    /**
+     * 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;
+        return this.storage.get(fullKey);
+    }
+    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] = value;
+                    }
+                }
+            }
+            else {
+                if (!key.includes('.')) {
+                    values[key] = 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') || key.includes('commissioning'));
+        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() {
+        if (!this.pendingWrite) {
+            return;
+        }
+        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
+            const tempFile = `${this.filePath}.tmp`;
+            // Custom replacer to handle BigInt serialization
+            const jsonString = JSON.stringify(data, (_key, value) => {
+                if (typeof value === 'bigint') {
+                    return { __type: 'bigint', value: value.toString() };
+                }
+                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
+        }
+    }
+    /**
+     * 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,163 @@
+/**
+ * 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 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
+     * Key is the cluster name, value is an object of command name -> handler function
+     *
+     * Example:
+     * {
+     *   onOff: {
+     *     on: async () => { ... },
+     *     off: async () => { ... }
+     *   }
+     * }
+     */
+    handlers?: {
+        [clusterName: string]: {
+            [commandName: string]: (...args: unknown[]) => Promise<void> | void;
+        };
+    };
+    /**
+     * 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 {
+    /** Port for Matter server (optional, will auto-assign if not specified) */
+    port?: number;
+    /** Name for the Matter bridge (optional) */
+    name?: string;
+}
+/**
+ * Internal Matter accessory representation
+ * (Used internally by MatterServer)
+ */
+export interface InternalMatterAccessory extends MatterAccessory {
+    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 types
+ */
+export declare class MatterError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    readonly type: MatterErrorType;
+    readonly timestamp: Date;
+    readonly recoverable: boolean;
+    constructor(message: string, code: string, details?: unknown | undefined, type?: MatterErrorType, recoverable?: boolean);
+}
+export declare class MatterCommissioningError extends MatterError {
+    constructor(message: string, details?: unknown);
+}
+export declare class MatterStorageError extends MatterError {
+    constructor(message: string, details?: unknown);
+}
+export declare class MatterDeviceError extends MatterError {
+    constructor(message: string, details?: unknown);
+}
+export declare class MatterNetworkError extends MatterError {
+    constructor(message: string, details?: unknown);
+}
+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;
+};
+//# sourceMappingURL=matterTypes.d.ts.map

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

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

package/dist/matter/matterTypes.js

@@ -0,0 +1,106 @@
+/**
+ * Matter Types for Homebridge Plugin API
+ *
+ * This module provides types and interfaces for plugin developers
+ * to create Matter-compatible accessories.
+ */
+// Import Matter.js clusters and device types
+import * as clusters from '@matter/main/clusters';
+import * as devices from '@matter/main/devices';
+/**
+ * Matter error type enum (for error handler categorization)
+ */
+export var MatterErrorType;
+(function (MatterErrorType) {
+    MatterErrorType["INITIALIZATION"] = "INITIALIZATION";
+    MatterErrorType["NETWORK"] = "NETWORK";
+    MatterErrorType["COMMISSIONING"] = "COMMISSIONING";
+    MatterErrorType["DEVICE_SYNC"] = "DEVICE_SYNC";
+    MatterErrorType["SERVER"] = "SERVER";
+    MatterErrorType["STORAGE"] = "STORAGE";
+    MatterErrorType["CONFIGURATION"] = "CONFIGURATION";
+    MatterErrorType["DEVICE_ERROR"] = "DEVICE_ERROR";
+    MatterErrorType["UNKNOWN"] = "UNKNOWN";
+})(MatterErrorType || (MatterErrorType = {}));
+/**
+ * Matter error types
+ */
+export class MatterError extends Error {
+    code;
+    details;
+    type;
+    timestamp;
+    recoverable;
+    constructor(message, code, details, type = MatterErrorType.UNKNOWN, recoverable = true) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'MatterError';
+        this.type = type;
+        this.timestamp = new Date();
+        this.recoverable = recoverable;
+    }
+}
+export class MatterCommissioningError extends MatterError {
+    constructor(message, details) {
+        super(message, 'COMMISSIONING_ERROR', details, MatterErrorType.COMMISSIONING);
+        this.name = 'MatterCommissioningError';
+    }
+}
+export class MatterStorageError extends MatterError {
+    constructor(message, details) {
+        super(message, 'STORAGE_ERROR', details, MatterErrorType.STORAGE);
+        this.name = 'MatterStorageError';
+    }
+}
+export class MatterDeviceError extends MatterError {
+    constructor(message, details) {
+        super(message, 'DEVICE_ERROR', details, MatterErrorType.DEVICE_ERROR);
+        this.name = 'MatterDeviceError';
+    }
+}
+export class MatterNetworkError extends MatterError {
+    constructor(message, details) {
+        super(message, 'NETWORK_ERROR', details, MatterErrorType.NETWORK);
+        this.name = 'MatterNetworkError';
+    }
+}
+// Export Matter.js clusters for direct access
+export { clusters };
+// Export raw devices namespace (for advanced use)
+export { devices };
+/**
+ * Friendly device type names for the Plugin API
+ * Maps simplified names to actual Matter.js device types
+ */
+export const deviceTypes = {
+    // Lighting
+    OnOffLight: devices.OnOffLightDevice,
+    DimmableLight: devices.DimmableLightDevice,
+    ColorTemperatureLight: devices.ColorTemperatureLightDevice,
+    ExtendedColorLight: devices.ExtendedColorLightDevice,
+    // Switches & Outlets
+    OnOffSwitch: devices.OnOffLightSwitchDevice,
+    OnOffOutlet: devices.OnOffPlugInUnitDevice,
+    DimmableOutlet: devices.DimmablePlugInUnitDevice,
+    // Sensors
+    TemperatureSensor: devices.TemperatureSensorDevice,
+    HumiditySensor: devices.HumiditySensorDevice,
+    LightSensor: devices.LightSensorDevice,
+    MotionSensor: devices.OccupancySensorDevice,
+    ContactSensor: devices.ContactSensorDevice,
+    LeakSensor: devices.WaterLeakDetectorDevice,
+    SmokeSensor: devices.SmokeCoAlarmDevice,
+    // HVAC
+    Thermostat: devices.ThermostatDevice,
+    Fan: devices.FanDevice,
+    // Security
+    DoorLock: devices.DoorLockDevice,
+    // Window Coverings
+    WindowCovering: devices.WindowCoveringDevice,
+    // Other
+    GenericSwitch: devices.GenericSwitchDevice,
+    Pump: devices.PumpDevice,
+    RoomAirConditioner: devices.RoomAirConditionerDevice,
+};
+//# sourceMappingURL=matterTypes.js.map

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/plugin.d.ts.map

@@ -1 +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"}
+{"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;IAmBxG,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"}

package/dist/plugin.js

@@ -107,9 +107,11 @@ export class Plugin {
             throw new Error(`The requested platform '${name}' was not registered by the plugin '${this.getPluginIdentifier()}'.`);
         }
         // If it's a dynamic platform plugin, ensure it's not enabled multiple times.
-        if (this.activeDynamicPlatforms.has(name)) {
+        // Skip this check in child bridge context (when process.send exists, we're a forked child)
+        const isChildBridge = typeof process.send === 'function';
+        if (!isChildBridge && this.activeDynamicPlatforms.has(name)) {
             throw new Error(`The dynamic platform ${name} from the plugin ${this.getPluginIdentifier()} is configured `
-                + 'times in your config.json.');
+                + 'multiple times in your config.json.');
         }
         return constructor;
     }