@matterbridge/core 3.5.3

package/dist/workers/messageLab.d.ts

@@ -0,0 +1,134 @@
+/** Types of worker source */
+export type WorkerSrcType = 'manager' | 'matterbridge' | 'plugins' | 'devices' | 'frontend' | 'matter' | 'platform' | 'spawn' | 'updates';
+/** Types of worker destination */
+export type WorkerDstType = 'manager' | 'matterbridge' | 'plugins' | 'devices' | 'frontend' | 'matter' | 'platform' | 'spawn' | 'updates' | 'all';
+/** Normalized message request structure */
+type NormalizeRequest<T> = T extends {
+    params: infer P;
+} ? ([P] extends [undefined] ? {
+    params?: undefined;
+} : {
+    params: P;
+}) : Record<never, never>;
+/** Normalized message response structure that guarantees a successful result */
+type NormalizeResponseSuccess<T> = T & {
+    error?: never;
+};
+/** Normalized message response structure that contains an error */
+type NormalizeResponseError<T> = {
+    error: string;
+} & {
+    [K in keyof T]?: never;
+};
+/** Normalized message response structure */
+type NormalizeResponse<T> = NormalizeResponseSuccess<T> | NormalizeResponseError<T>;
+/** Message request structure with id, timestamp, src and dst */
+type WorkerMessageRequestMap = {
+    [K in keyof WorkerMessageTypes]: {
+        type: K;
+        id?: number;
+        timestamp?: number;
+        src: WorkerSrcType;
+        dst: WorkerDstType;
+    } & NormalizeRequest<WorkerMessageTypes[K]['request']>;
+};
+/** Message request structure with id, timestamp, src and dst */
+export type WorkerMessageRequest<K extends keyof WorkerMessageTypes = keyof WorkerMessageTypes> = WorkerMessageRequestMap[K];
+/** Message response structure with id, timestamp, elapsed, src and dst */
+type WorkerMessageResponseMap = {
+    [K in keyof WorkerMessageTypes]: {
+        type: K;
+        id?: number;
+        timestamp?: number;
+        elapsed?: number;
+        src: WorkerSrcType;
+        dst: WorkerDstType;
+    } & NormalizeResponse<WorkerMessageTypes[K]['response']>;
+};
+/** Message response structure with id, timestamp, elapsed, src and dst */
+export type WorkerMessageResponse<K extends keyof WorkerMessageTypes = keyof WorkerMessageTypes> = WorkerMessageResponseMap[K];
+/** Message response success structure that guarantees a successful result */
+type WorkerMessageResponseSuccessMap = {
+    [K in keyof WorkerMessageTypes]: {
+        type: K;
+        id?: number;
+        timestamp?: number;
+        elapsed?: number;
+        src: WorkerSrcType;
+        dst: WorkerDstType;
+    } & NormalizeResponseSuccess<WorkerMessageTypes[K]['response']>;
+};
+/** Message response success structure with id, timestamp, elapsed, src and dst */
+export type WorkerMessageResponseSuccess<K extends keyof WorkerMessageTypes = keyof WorkerMessageTypes> = WorkerMessageResponseSuccessMap[K];
+/** Union type for WorkerMessageRequest and WorkerMessageResponse */
+export type WorkerMessage<K extends keyof WorkerMessageTypes = keyof WorkerMessageTypes> = WorkerMessageRequest<K> | WorkerMessageResponse<K>;
+/** Map of all worker message types with their request and response structures */
+export type WorkerMessageTypes = {
+    jest: {
+        request: {
+            params: {
+                userId: number;
+            };
+        };
+        response: {
+            result: {
+                name: string;
+                age: number;
+            };
+        };
+    };
+    jest_simple: {
+        request: {
+            params: undefined;
+        };
+        response: {
+            result: {
+                success: true;
+            };
+        };
+    };
+};
+/**
+ * Generate a pseudo-random identifier between 1,000,000 and 9,999,999.
+ *
+ * @returns {number} A seven-digit identifier.
+ */
+export declare function getUniqueId(): number;
+/**
+ * Send a request message from the worker implementation.
+ *
+ * @template K
+ * @param {WorkerMessageRequest<K>} msg The request message to send.
+ * @returns {void}
+ */
+export declare function request<K extends keyof WorkerMessageTypes>(msg: WorkerMessageRequest<K>): void;
+/**
+ * Send a response message from the worker implementation.
+ *
+ * @template K
+ * @param {WorkerMessageResponse<K>} msg The response message to send.
+ * @returns {void}
+ */
+export declare function respond<K extends keyof WorkerMessageTypes>(msg: WorkerMessageResponse<K>): void;
+/**
+ * Type guard to verify a value matches the WorkerMessageRequest structure.
+ *
+ * @param {unknown} value Value to test.
+ * @returns {value is WorkerMessageRequest} True when the value looks like a request message.
+ */
+export declare function isWorkerRequest(value: unknown): value is WorkerMessageRequest;
+/**
+ * Type guard to verify a value matches the WorkerMessageResponse structure.
+ *
+ * @param {unknown} value Value to test.
+ * @returns {value is WorkerMessageResponse} True when the value looks like a response message.
+ */
+export declare function isWorkerResponse(value: unknown): value is WorkerMessageResponse;
+/**
+ * Example handler function demonstrating type guards.
+ *
+ * @param {WorkerMessage} msg The incoming worker message.
+ */
+export declare function handler(msg: WorkerMessage): void;
+export {};
+//# sourceMappingURL=messageLab.d.ts.map

package/dist/workers/messageLab.d.ts.map

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

package/dist/workers/messageLab.js

@@ -0,0 +1,129 @@
+/**
+ * Generate a pseudo-random identifier between 1,000,000 and 9,999,999.
+ *
+ * @returns {number} A seven-digit identifier.
+ */
+export function getUniqueId() {
+    return Math.floor(Math.random() * 900000000) + 100000000;
+}
+/**
+ * Send a request message from the worker implementation.
+ *
+ * @template K
+ * @param {WorkerMessageRequest<K>} msg The request message to send.
+ * @returns {void}
+ */
+export function request(msg) {
+    if (msg.id === undefined) {
+        msg.id = getUniqueId();
+    }
+    if (msg.timestamp === undefined) {
+        msg.timestamp = Date.now();
+    }
+    // to complete
+}
+/**
+ * Send a response message from the worker implementation.
+ *
+ * @template K
+ * @param {WorkerMessageResponse<K>} msg The response message to send.
+ * @returns {void}
+ */
+export function respond(msg) {
+    if (msg.timestamp) {
+        msg.elapsed = Date.now() - msg.timestamp;
+    }
+    msg.timestamp = Date.now();
+    // to complete
+}
+/**
+ * Type guard to verify a value matches the WorkerMessageRequest structure.
+ *
+ * @param {unknown} value Value to test.
+ * @returns {value is WorkerMessageRequest} True when the value looks like a request message.
+ */
+export function isWorkerRequest(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const message = value;
+    return (typeof message.type === 'string' &&
+        typeof message.src === 'string' &&
+        typeof message.dst === 'string' &&
+        typeof message.id === 'number' &&
+        typeof message.timestamp === 'number');
+}
+/**
+ * Type guard to verify a value matches the WorkerMessageResponse structure.
+ *
+ * @param {unknown} value Value to test.
+ * @returns {value is WorkerMessageResponse} True when the value looks like a response message.
+ */
+export function isWorkerResponse(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const message = value;
+    if (typeof message.type !== 'string' ||
+        typeof message.src !== 'string' ||
+        typeof message.dst !== 'string' ||
+        typeof message.id !== 'number' ||
+        typeof message.timestamp !== 'number') {
+        return false;
+    }
+    const hasError = typeof message.error === 'string';
+    const hasResult = message.result !== undefined;
+    return hasError !== hasResult;
+}
+/**
+ * Example handler function demonstrating type guards.
+ *
+ * @param {WorkerMessage} msg The incoming worker message.
+ */
+export function handler(msg) {
+    if (isWorkerRequest(msg)) {
+        switch (msg.type) {
+            case 'jest':
+                // msg.params is inferred as '{ userId: number }' here
+                if (msg.params.userId === 1) {
+                    respond({ type: 'jest', src: msg.src, dst: msg.dst, id: msg.id, timestamp: msg.timestamp, result: { name: 'Alice', age: 30 } });
+                }
+                else {
+                    respond({ type: 'jest', src: msg.src, dst: msg.dst, id: msg.id, timestamp: msg.timestamp, error: 'User not found' });
+                }
+                respond({ type: 'jest', src: msg.src, dst: msg.dst, id: msg.id, timestamp: msg.timestamp, result: { name: 'Test', age: 42 } });
+                break;
+        }
+    }
+}
+// Correct request example usage
+request({ type: 'jest', src: 'frontend', dst: 'manager', params: { userId: 1 } });
+request({ type: 'jest_simple', src: 'frontend', dst: 'manager' });
+// Negative request type assertions
+// @ts-expect-error unknown message type value
+request({ type: 'unknown', src: 'frontend', dst: 'manager' });
+// @ts-expect-error missing required params for jest request
+request({ type: 'jest', src: 'frontend', dst: 'manager' });
+// @ts-expect-error params.userId must be a number
+request({ type: 'jest', src: 'frontend', dst: 'manager', params: { userId: '1' } });
+// @ts-expect-error params must be undefined for jest_simple request
+request({ type: 'jest_simple', src: 'frontend', dst: 'manager', params: {} });
+// Correct response example usage
+respond({ type: 'jest', src: 'manager', dst: 'frontend', result: { name: 'Test', age: 42 } });
+respond({ type: 'jest', src: 'manager', dst: 'frontend', error: 'Not found' });
+respond({ type: 'jest_simple', src: 'manager', dst: 'frontend', result: { success: true } });
+respond({ type: 'jest_simple', src: 'manager', dst: 'frontend', error: 'Failed' });
+// Negative response type assertions
+// @ts-expect-error response.result.logLevel has wrong type
+respond({ type: 'unknown', src: 'manager', dst: 'frontend', result: { logLevel: 'info' } });
+// @ts-expect-error response.error must be a string when provided
+respond({ type: 'jest', src: 'manager', dst: 'frontend', error: 42 });
+// @ts-expect-error response.result.age must be a number
+respond({ type: 'jest', src: 'manager', dst: 'frontend', result: { name: 'Test', age: '42' } });
+// @ts-expect-error response.result.name must be a string
+respond({ type: 'jest', src: 'manager', dst: 'frontend', result: { name: 123, age: 42 } });
+// @ts-expect-error response.error must be a string when provided
+respond({ type: 'jest', src: 'manager', dst: 'frontend', error: 42 });
+// @ts-expect-error result with error is not allowed
+respond({ type: 'jest', src: 'manager', dst: 'frontend', result: { name: 'Test', age: 42 }, error: 'Not found' });
+//# sourceMappingURL=messageLab.js.map

package/dist/workers/messageLab.js.map

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

package/dist/workers/testWorker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=testWorker.d.ts.map

package/dist/workers/testWorker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testWorker.d.ts","sourceRoot":"","sources":["../../src/workers/testWorker.ts"],"names":[],"mappings":""}

package/dist/workers/testWorker.js

@@ -0,0 +1,45 @@
+// testWorker.ts
+// Worker entry for test logic
+import { parentPort, workerData } from 'node:worker_threads';
+// Third-party modules
+import { debugStringify } from 'node-ansi-logger';
+import { WorkerServer } from './workerServer.js';
+const server = new WorkerServer('TestWorker', parentPort, workerData);
+server.on('control_message', async (msg) => {
+    // Handle control messages from manager if needed
+    if (msg.type !== 'ping')
+        server.log.debug(`${server.name} received control message: ${debugStringify(msg)}`);
+    switch (msg.type) {
+        case 'init':
+            // Initialization logic if needed
+            server.parentPost({ ...msg, success: true });
+            break;
+        case 'ping':
+            // Ping handled in WorkerServer
+            break;
+        case 'exit':
+            // Cleanup logic if needed
+            server.parentPost({ ...msg, success: true });
+            server.exit(0);
+            break;
+    }
+});
+server.on('manager_message', async (msg) => {
+    // Handle direct messages from manager if needed
+    server.log.debug(`${server.name} received manager message: ${debugStringify(msg)}`);
+    switch (msg.type) {
+        default:
+            // Handle unknown message types
+            break;
+    }
+});
+server.on('broadcast_message', (msg) => {
+    // Handle broadcast messages from other workers if needed
+    server.log.debug(`${server.name} received broadcast message: ${debugStringify(msg)}`);
+    switch (msg.type) {
+        default:
+            // Handle unknown message types
+            break;
+    }
+});
+//# sourceMappingURL=testWorker.js.map

package/dist/workers/testWorker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testWorker.js","sourceRoot":"","sources":["../../src/workers/testWorker.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,8BAA8B;AAE9B,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE7D,sBAAsB;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,YAAY,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;AAEtE,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IACzC,iDAAiD;IACjD,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,8BAA8B,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC7G,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,iCAAiC;YACjC,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,MAAM;QACR,KAAK,MAAM;YACT,+BAA+B;YAC/B,MAAM;QACR,KAAK,MAAM;YACT,0BAA0B;YAC1B,MAAM,CAAC,UAAU,CAAC,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACf,MAAM;IACV,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE;IACzC,gDAAgD;IAChD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,8BAA8B,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpF,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB;YACE,+BAA+B;YAC/B,MAAM;IACV,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;IACrC,yDAAyD;IACzD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,gCAAgC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACtF,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB;YACE,+BAA+B;YAC/B,MAAM;IACV,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/workers/usage.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Memory Stress Test (malloc/free simulation).
+ *
+ * The allocated buffer stays in the rss space (not in the heap).
+ * As such, it is not tracked by V8's heap statistics.
+ * A call to global.gc() is needed to trigger garbage collection and free the memory.
+ * This requires Node.js to be started with the --expose-gc flag.
+ * If not started manually, the memory will be freed when the gc is called.
+ */
+export declare function mallocStressTest(): void;
+/**
+ * Read/Write Stress Test with readFileSync and writeFileSync
+ */
+export declare function readWriteStressTest(): Promise<void>;
+/**
+ * CPU Stress Test (simulated work)
+ */
+export declare function cpuStressTest(): void;
+//# sourceMappingURL=usage.d.ts.map

package/dist/workers/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/workers/usage.ts"],"names":[],"mappings":"AAwCA;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,SAe/B;AAED;;GAEG;AACH,wBAAsB,mBAAmB,kBAmCxC;AAED;;GAEG;AACH,wBAAgB,aAAa,SAgC5B"}

package/dist/workers/usage.js

@@ -0,0 +1,140 @@
+/* eslint-disable no-console */
+// Use: node --inspect=0.0.0.0:9229 --trace-gc --expose-gc  dist/workers/usage --debug  --trace --loader --verbose
+if (process.argv.includes('--loader') || process.argv.includes('-loader'))
+    console.log('\u001B[32mUsage loaded.\u001B[40;0m');
+// import { Logger, LogLevel as MatterLogLevel, LogFormat as MatterLogFormat } from '@matter/general';
+// import { BridgedDeviceBasicInformation } from '@matter/types/clusters/bridged-device-basic-information';
+// import { PowerSource } from '@matter/types/clusters/power-source';
+// import { FabricAction } from '@matter/protocol';
+import { Tracker, Inspector } from '@matterbridge/utils';
+// Logger.format = MatterLogFormat.ANSI;
+// Logger.level = MatterLogLevel.INFO;
+// Logger.get('UsageWorker').info('Usage worker started.');
+// Logger.get('UsageWorker').info('Usage worker started.', BridgedDeviceBasicInformation.Cluster.id, PowerSource.Cluster.id);
+const tracker = new Tracker('Tracker', true, true);
+tracker.start();
+const inspector = new Inspector('Inspector', true, true);
+await inspector.start();
+setTimeout(() => {
+    tracker.resetPeaks();
+}, 30000); // Reset peaks after 30 seconds
+setTimeout(() => {
+    // cpuStressTest();
+    // mallocStressTest();
+    // readWriteStressTest();
+}, 60000); // After 1 minute
+setInterval(() => {
+    // cpuStressTest();
+    // mallocStressTest();
+    // readWriteStressTest();
+}, 60000); // Each minute
+/**
+ * Memory Stress Test (malloc/free simulation).
+ *
+ * The allocated buffer stays in the rss space (not in the heap).
+ * As such, it is not tracked by V8's heap statistics.
+ * A call to global.gc() is needed to trigger garbage collection and free the memory.
+ * This requires Node.js to be started with the --expose-gc flag.
+ * If not started manually, the memory will be freed when the gc is called.
+ */
+export function mallocStressTest() {
+    const allocations = [];
+    for (let i = 0; i < 50; i++) {
+        // Allocate 10MB chunks
+        const buffer = Buffer.alloc(10 * 1024 * 1024, 'a');
+        allocations.push(buffer);
+        console.log(`Allocated ${(i + 1) * 10} MB`);
+    }
+    // Free memory after some time
+    setTimeout(() => {
+        allocations.length = 0; // Clear references
+        console.log('Freed allocated memory');
+        tracker.runGarbageCollector('minor');
+        tracker.runGarbageCollector('major');
+    }, 30000); // Free after 30 seconds
+}
+/**
+ * Read/Write Stress Test with readFileSync and writeFileSync
+ */
+export async function readWriteStressTest() {
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    const os = await import('node:os');
+    const filePath = path.join(os.tmpdir(), 'tempfile.dat');
+    const fd = fs.openSync(filePath, 'w');
+    const chunk = 'x'.repeat(64 * 1024); // small string stays in heap
+    const iterations = Math.ceil((50 * 1024 * 1024) / chunk.length);
+    for (let i = 0; i < iterations; i++) {
+        fs.writeSync(fd, chunk);
+    }
+    fs.closeSync(fd);
+    console.log('Wrote 50 MB');
+    const readFd = fs.openSync(filePath, 'r');
+    const buf = new Uint8Array(chunk.length); // Node accepts any ArrayBufferView
+    let total = 0;
+    while (true) {
+        const bytes = fs.readSync(readFd, buf);
+        if (bytes === 0)
+            break;
+        total += bytes;
+        // optionally process buf here
+    }
+    fs.closeSync(readFd);
+    console.log(`Read ${total / (1024 * 1024)} MB`);
+    fs.unlinkSync(filePath);
+    // Free memory after some time
+    setTimeout(() => {
+        tracker.runGarbageCollector('minor');
+        tracker.runGarbageCollector('major');
+    }, 30000); // Free after 30 seconds
+}
+/**
+ * CPU Stress Test (simulated work)
+ */
+export function cpuStressTest() {
+    // CPU-intensive work: prime number calculation
+    const startTime = Date.now();
+    let _primeCount = 0;
+    // Calculate primes up to 10000 (CPU intensive)
+    for (let num = 2; num <= 10000; num++) {
+        let isPrime = true;
+        for (let i = 2; i <= Math.sqrt(num); i++) {
+            if (num % i === 0) {
+                isPrime = false;
+                break;
+            }
+        }
+        if (isPrime)
+            _primeCount++;
+    }
+    // More CPU work: array sorting
+    const largeArray = Array.from({ length: 5000 }, () => Math.random() * 1000000);
+    largeArray.sort((a, b) => b - a); // Reverse sort
+    // Hash calculation simulation
+    let hash = 0;
+    const str = JSON.stringify(largeArray.slice(0, 100));
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = (hash << 5) - hash + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    const _duration = Date.now() - startTime;
+    console.log(`CPU work completed: Found ${_primeCount} primes, sorted ${largeArray.length} numbers, hash: ${hash}, duration: ${_duration}ms`);
+}
+/**
+ * Graceful shutdown
+ */
+async function shutdown() {
+    console.log('Stopping inspector...');
+    await inspector.stop();
+    console.log('Inspector stopped.');
+    console.log('Stopping tracker...');
+    tracker.stop();
+    console.log('Tracker stopped.');
+    console.log('Usage worker exiting.');
+    // eslint-disable-next-line n/no-process-exit
+    process.exit(0);
+}
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);
+//# sourceMappingURL=usage.js.map

package/dist/workers/usage.js.map

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

package/dist/workers/workerManager.d.ts

@@ -0,0 +1,115 @@
+import { Worker } from 'node:worker_threads';
+import { AnsiLogger } from 'node-ansi-logger';
+import { WorkerMessage } from '@matterbridge/types';
+import { ControlMessage } from './workerTypes.js';
+/**
+ * Generates a unique ID with range 100000-999999.
+ *
+ * @returns {number} - A unique ID between 100000 and 999999
+ */
+export declare function getUniqueId(): number;
+export declare class WorkerManager {
+    readonly log: AnsiLogger;
+    private readonly matterbridgeWorker;
+    private readonly frontendWorker;
+    private readonly matterWorker;
+    private readonly testWorker;
+    private readonly broadcastChannel;
+    private readonly matterbridgeChannel;
+    private readonly frontendChannel;
+    private readonly matterChannel;
+    private readonly testChannel;
+    private readonly pingIntervalTimeout;
+    private readonly pingIntervalMs;
+    private matterbridgePongTimeout;
+    private frontendPongTimeout;
+    private matterPongTimeout;
+    private testPongTimeout;
+    private readonly tracker;
+    /**
+     * Creates an instance of WorkerManager, initializing and managing multiple workers.
+     *
+     * @remarks
+     * The manager sets up communication channels between itself and the workers:
+     * - parentPort: manager <-> worker (control with ControlMessage)
+     * - port1: manager -> worker (direct communication for messages from manager to worker)
+     * - port2: manager <- worker (direct communication for messages from worker to manager)
+     * - broadcastChannel:  broadcast messages to manager and all workers
+     */
+    constructor();
+    /**
+     *  Sends a control message to a specific worker.
+     *
+     * @param {Worker} worker - The worker to send the message to.
+     * @param {ControlMessage} msg - The message to send.
+     */
+    postControlMessage(worker: Worker, msg: ControlMessage): void;
+    /**
+     * Sends a control message to all workers.
+     *
+     * @param {ControlMessage} msg - The message to send.
+     */
+    postControlMessageToAll(msg: ControlMessage): void;
+    /**
+     * Initializes all workers.
+     */
+    initializeAllWorkers(): void;
+    /**
+     * Shuts down all workers gracefully.
+     */
+    shutdownAllWorkers(): void;
+    /**
+     * Sends a message to the Matterbridge worker via the port 1 of the established MessageChannel.
+     *
+     * @param {MatterbridgeWorkerMessage} message - The message to be posted to the Matterbridge worker.
+     */
+    postToMatterbridgeWorker(message: WorkerMessage): void;
+    /**
+     * Sends a message to the Frontend worker via the port 1 of the established MessageChannel.
+     *
+     * @param {FrontendWorkerMessage} message - The message to be posted to the Frontend worker.
+     */
+    postToFrontendWorker(message: WorkerMessage): void;
+    /**
+     * Sends a message to the Plugin worker via the port 1 of the established MessageChannel.
+     *
+     * @param {PluginWorkerMessage} message - The message to be posted to the Plugin worker.
+     */
+    postToMatterWorker(message: WorkerMessage): void;
+    /**
+     * Handle messages from matterbridgeWorker.
+     * It uses the port 2 of the matterbridge MessageChannel for direct communication.
+     *
+     * @param {MatterbridgeWorkerMessage} msg The message from the matterbridgeWorker
+     */
+    matterbridgeMessageHandler(msg: WorkerMessage): void;
+    /**
+     * Handle messages from frontendWorker.
+     * It uses the port 2 of the frontend MessageChannel for direct communication.
+     *
+     * @param {FrontendWorkerMessage} msg The message from the frontendWorker
+     */
+    frontendMessageHandler(msg: WorkerMessage): void;
+    /**
+     * Handle messages from matterWorker.
+     * It uses the port 2 of the matter MessageChannel for direct communication.
+     *
+     * @param {MatterWorkerMessage} msg The message from the matterWorker
+     */
+    matterMessageHandler(msg: WorkerMessage): void;
+    /**
+     * Handle messages from testWorker.
+     * It uses the port 2 of the test MessageChannel for direct communication.
+     *
+     * @param {TestWorkerMessage} msg The message from the testWorker
+     */
+    testMessageHandler(msg: WorkerMessage): void;
+    /**
+     * Handle broadcast messages from other workers.
+     * It uses the BroadcastChannel for communication.
+     *
+     * @param {MessageEvent} event The message event containing the broadcast message
+     */
+    broadcastMessageHandler(event: MessageEvent): void;
+}
+//# sourceMappingURL=workerManager.d.ts.map

package/dist/workers/workerManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workerManager.d.ts","sourceRoot":"","sources":["../../src/workers/workerManager.ts"],"names":[],"mappings":"AAMA,OAAO,EAAoC,MAAM,EAAiB,MAAM,qBAAqB,CAAC;AAM9F,OAAO,EAAE,UAAU,EAAiD,MAAM,kBAAkB,CAAC;AAE7F,OAAO,EAAsB,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAIxE,OAAO,EAAc,cAAc,EAAE,MAAM,kBAAkB,CAAC;AA2D9D;;;;GAIG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAiCD,qBAAa,aAAa;IACxB,QAAQ,CAAC,GAAG,aAIT;IAEH,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAmB;IAEpD,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAiB;IACrD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiB;IACjD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiB;IAE7C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAiB;IACrD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,uBAAuB,CAAyC;IACxE,OAAO,CAAC,mBAAmB,CAAyC;IACpE,OAAO,CAAC,iBAAiB,CAAyC;IAClE,OAAO,CAAC,eAAe,CAAyC;IAEhE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6C;IAErE;;;;;;;;;OASG;;IAqKH;;;;;OAKG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc;IAItD;;;;OAIG;IACH,uBAAuB,CAAC,GAAG,EAAE,cAAc;IAO3C;;OAEG;IACH,oBAAoB;IAIpB;;OAEG;IACH,kBAAkB;IAUlB;;;;OAIG;IACH,wBAAwB,CAAC,OAAO,EAAE,aAAa;IAI/C;;;;OAIG;IACH,oBAAoB,CAAC,OAAO,EAAE,aAAa;IAI3C;;;;OAIG;IACH,kBAAkB,CAAC,OAAO,EAAE,aAAa;IAIzC;;;;;OAKG;IACH,0BAA0B,CAAC,GAAG,EAAE,aAAa;IAc7C;;;;;OAKG;IACH,sBAAsB,CAAC,GAAG,EAAE,aAAa;IAczC;;;;;OAKG;IACH,oBAAoB,CAAC,GAAG,EAAE,aAAa;IAcvC;;;;;OAKG;IACH,kBAAkB,CAAC,GAAG,EAAE,aAAa;IAQrC;;;;;OAKG;IACH,uBAAuB,CAAC,KAAK,EAAE,YAAY;CAI5C"}