matterbridge 3.0.7-dev-20250620-076b34c → 3.0.7

package/dist/shelly.js

@@ -1,13 +1,53 @@
+/**
+ * This file contains the shelly api functions.
+ *
+ * @file shelly.ts
+ * @author Luca Liguori
+ * @date 2025-02-19
+ * @version 1.1.0
+ *
+ * Copyright 2025, 2026, 2027 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License. *
+ */
 import { WS_ID_SHELLY_MAIN_UPDATE, WS_ID_SHELLY_SYS_UPDATE } from './frontend.js';
 import { debugStringify } from './logger/export.js';
 let verifyIntervalSecs = 15;
 let verifyTimeoutSecs = 600;
+/**
+ * Sets the interval for verification in seconds.
+ *
+ * @param {number} seconds - The interval in seconds.
+ * @returns {void}
+ */
 export function setVerifyIntervalSecs(seconds) {
     verifyIntervalSecs = seconds;
 }
+/**
+ * Sets the timeout for verification in seconds.
+ *
+ * @param {number} seconds - The timeout in seconds.
+ * @returns {void}
+ */
 export function setVerifyTimeoutSecs(seconds) {
     verifyTimeoutSecs = seconds;
 }
+/**
+ * Fetches Shelly system updates. If available: logs the result, sends a snackbar message, and broadcasts the message.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function getShellySysUpdate(matterbridge) {
     try {
         const updates = (await getShelly('/api/updates/sys/check'));
@@ -26,19 +66,33 @@ export async function getShellySysUpdate(matterbridge) {
         matterbridge.log.error(`Error getting Shelly system updates: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
+/**
+ * Triggers Shelly system updates.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function triggerShellySysUpdate(matterbridge) {
     try {
+        // Trigger the update request
         await getShelly('/api/updates/sys/perform');
         matterbridge.log.notice('Installing Shelly system update...');
         matterbridge.matterbridgeInformation.shellySysUpdate = false;
         matterbridge.frontend.wssSendSnackbarMessage('Installing Shelly system update...', 15);
         matterbridge.frontend.wssBroadcastMessage(WS_ID_SHELLY_SYS_UPDATE, 'shelly-sys-update', { available: false });
+        // Begin polling update status
         await verifyShellyUpdate(matterbridge, '/api/updates/sys/status', 'Shelly system update');
     }
     catch (err) {
         matterbridge.log.error(`Error triggering Shelly system update: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
+/**
+ * Fetches Shelly main updates. If available: logs the result, sends a snackbar message, and broadcasts the message.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function getShellyMainUpdate(matterbridge) {
     try {
         const updates = (await getShelly('/api/updates/main/check'));
@@ -57,19 +111,33 @@ export async function getShellyMainUpdate(matterbridge) {
         matterbridge.log.error(`Error getting Shelly main updates: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
+/**
+ * Triggers Shelly main updates.
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function triggerShellyMainUpdate(matterbridge) {
     try {
+        // Trigger the perform-update request
         await getShelly('/api/updates/main/perform');
         matterbridge.log.notice('Installing Shelly software update...');
         matterbridge.matterbridgeInformation.shellyMainUpdate = false;
         matterbridge.frontend.wssSendSnackbarMessage('Installing Shelly software update...', 15);
         matterbridge.frontend.wssBroadcastMessage(WS_ID_SHELLY_MAIN_UPDATE, 'shelly-main-update', { available: false });
+        // Begin polling the update status
         await verifyShellyUpdate(matterbridge, '/api/updates/main/status', 'Shelly software update');
     }
     catch (err) {
         matterbridge.log.error(`Error triggering Shelly main update: ${err instanceof Error ? err.message : String(err)}`);
     }
 }
+/**
+ * Verifies Shelly update.
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @param {string} api - The api to call: /api/updates/sys/status or /api/updates/main/status
+ * @param {string} name - The name of the update.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function verifyShellyUpdate(matterbridge, api, name) {
     return new Promise((resolve) => {
         const timeout = setTimeout(() => {
@@ -77,9 +145,9 @@ export async function verifyShellyUpdate(matterbridge, api, name) {
             matterbridge.frontend.wssSendCloseSnackbarMessage(`${name} in progress...`);
             clearInterval(interval);
             resolve();
-        }, verifyTimeoutSecs * 1000);
+        }, verifyTimeoutSecs * 1000); // 10 minutes
         const interval = setInterval(() => {
-            getShelly(api, 10 * 1000)
+            getShelly(api, 10 * 1000) // 10 seconds
                 .then(async (data) => {
                 if (data.updatingInProgress) {
                     matterbridge.log.debug(`${name} in progress...`);
@@ -101,9 +169,15 @@ export async function verifyShellyUpdate(matterbridge, api, name) {
                 clearTimeout(timeout);
                 resolve();
             });
-        }, verifyIntervalSecs * 1000);
+        }, verifyIntervalSecs * 1000); // 15 seconds
     });
 }
+/**
+ * Triggers Shelly change network configuration.
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @param {object} config - The network configuration.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function triggerShellyChangeIp(matterbridge, config) {
     const api = config.type === 'static' ? '/api/network/connection/static' : '/api/network/connection/dynamic';
     const data = { interface: 'end0' };
@@ -126,6 +200,11 @@ export async function triggerShellyChangeIp(matterbridge, config) {
         matterbridge.frontend.wssSendSnackbarMessage('Error changing Shelly network configuration', 10, 'error');
     }
 }
+/**
+ * Triggers Shelly system reboot.
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function triggerShellyReboot(matterbridge) {
     matterbridge.log.debug(`Triggering Shelly system reboot`);
     try {
@@ -143,6 +222,13 @@ export async function triggerShellyReboot(matterbridge) {
         matterbridge.frontend.wssSendSnackbarMessage('Error rebooting Shelly board', 10, 'error');
     }
 }
+/**
+ * Triggers Shelly soft reset.
+ * It will replaces network config with the default one (edn0 on dhcp).
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function triggerShellySoftReset(matterbridge) {
     matterbridge.log.debug(`Triggering Shelly soft reset`);
     try {
@@ -160,6 +246,13 @@ export async function triggerShellySoftReset(matterbridge) {
         matterbridge.frontend.wssSendSnackbarMessage('Error resetting the network parameters on Shelly board', 10, 'error');
     }
 }
+/**
+ * Triggers Shelly hard reset.
+ * It will do a hard reset and will remove both directories .matterbridge Matterbridge.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function triggerShellyHardReset(matterbridge) {
     matterbridge.log.debug(`Triggering Shelly hard reset`);
     try {
@@ -177,6 +270,12 @@ export async function triggerShellyHardReset(matterbridge) {
         matterbridge.frontend.wssSendSnackbarMessage('Error while factory resetting the Shelly board', 10, 'error');
     }
 }
+/**
+ * Fetches Shelly system log and write it to shelly.log.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the operation is complete.
+ */
 export async function createShellySystemLog(matterbridge) {
     const { promises: fs } = await import('node:fs');
     const path = await import('node:path');
@@ -191,6 +290,27 @@ export async function createShellySystemLog(matterbridge) {
         matterbridge.log.error(`Error getting Shelly system log: ${error instanceof Error ? error.message : error}`);
     }
 }
+/**
+ * Perform a GET to Shelly board apis.
+ * @param {string} api - The api to call:
+ *
+ *      /api/updates/sys/check => [{name:string; ...}]
+ *      /api/updates/sys/perform => {"updatingInProgress":true} or {"updatingInProgress":false}
+ *      /api/updates/sys/status => {"updatingInProgress":true} or {"updatingInProgress":false}
+ *      /api/updates/main/check => [{name:string; ...}]
+ *      /api/updates/main/perform => {"updatingInProgress":true} or {"updatingInProgress":false}
+ *      /api/updates/main/status  => {"updatingInProgress":true} or {"updatingInProgress":false}
+ *
+ *      /api/logs/system => text
+ *
+ *      /api/reset/soft => "ok"                 Replaces network config with default one (edn0 on dhcp)
+ *      /api/reset/hard => reboot on success    Hard reset makes soft reset + removing both directories .matterbridge Matterbridge + reboot
+ *
+ *
+ * @param {number} [timeout=60000] - The timeout duration in milliseconds (default is 60000ms).
+ * @returns {Promise<any>} A promise that resolves to the response.
+ * @throws {Error} If the request fails.
+ */
 export async function getShelly(api, timeout = 60000) {
     const http = await import('node:http');
     return new Promise((resolve, reject) => {
@@ -204,12 +324,13 @@ export async function getShelly(api, timeout = 60000) {
             let data = '';
             if (res.statusCode !== 200) {
                 clearTimeout(timeoutId);
-                res.resume();
-                req.destroy();
+                res.resume(); // Discard response data to close the socket properly
+                req.destroy(); // Forcefully close the request
                 reject(new Error(`Failed to fetch data. Status code: ${res.statusCode}`));
                 return;
             }
             res.on('data', (chunk) => {
+                // console.log(chunk);
                 data += chunk;
             });
             res.on('end', () => {
@@ -224,6 +345,7 @@ export async function getShelly(api, timeout = 60000) {
                     }
                 }
                 else {
+                    // console.log(data);
                     resolve(data);
                 }
             });
@@ -234,6 +356,29 @@ export async function getShelly(api, timeout = 60000) {
         });
     });
 }
+/**
+ * Perform a POST request to Shelly board apis.
+ * @param {string} api - The api to call:
+ *
+ *     Set static ip
+ *     /api/network/connection/static -d '{"interface": "end0", "addr": "10.11.12.101", "mask": "255.255.255.0", "gw": "10.11.12.1", "dns": "1.1.1.1"}' => {}
+ *
+ *     Set dhcp
+ *     /api/network/connection/dynamic -d '{"interface": "end0"}' => {}
+ *
+ *     Reboot
+ *     /api/system/reboot => {"success":true}
+ *
+ *     curl -H "Content-Type: application/json" -X POST http://127.0.0.1:8101/api/network/connection/dynamic
+ *        -d '{"interface": "end0"}'
+ *
+ *     curl -H "Content-Type: application/json" -X POST http://127.0.0.1:8101/api/network/connection/static
+ *        -d '{"interface": "end0", "addr": "192.168.1.64", "mask": "255.255.255.0", "gw": "192.168.1.1", "dns": "192.168.1.1"}'
+ *
+ * @param {number} [timeout=60000] - The timeout duration in milliseconds (default is 60000ms).
+ * @returns {Promise<any>} A promise that resolves to the response.
+ * @throws {Error} If the request fails.
+ */
 export async function postShelly(api, data, timeout = 60000) {
     const http = await import('node:http');
     return new Promise((resolve, reject) => {
@@ -254,10 +399,11 @@ export async function postShelly(api, data, timeout = 60000) {
         };
         const req = http.request(url, options, (res) => {
             let responseData = '';
+            // Check for non-success status codes (e.g., 300+)
             if (res.statusCode && res.statusCode >= 300) {
                 clearTimeout(timeoutId);
-                res.resume();
-                req.destroy();
+                res.resume(); // Discard response data to free up memory
+                req.destroy(); // Close the request
                 return reject(new Error(`Failed to post data. Status code: ${res.statusCode}`));
             }
             res.on('data', (chunk) => {
@@ -278,7 +424,9 @@ export async function postShelly(api, data, timeout = 60000) {
             clearTimeout(timeoutId);
             reject(new Error(`Request failed: ${error instanceof Error ? error.message : error}`));
         });
+        // Send the JSON data
         req.write(jsonData);
         req.end();
     });
 }
+//# sourceMappingURL=shelly.js.map

package/dist/shelly.js.map

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

package/dist/storage/export.d.ts

@@ -0,0 +1,2 @@
+export * from 'node-persist-manager';
+//# sourceMappingURL=export.d.ts.map

package/dist/storage/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../src/storage/export.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/storage/export.js

@@ -1 +1,2 @@
 export * from 'node-persist-manager';
+//# sourceMappingURL=export.js.map

package/dist/storage/export.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.js","sourceRoot":"","sources":["../../src/storage/export.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC"}

package/dist/update.d.ts

@@ -0,0 +1,58 @@
+/**
+ * This file contains the check updates functions.
+ *
+ * @file update.ts
+ * @author Luca Liguori
+ * @date 2025-02-24
+ * @version 1.0.0
+ *
+ * Copyright 2025, 2026, 2027 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License. *
+ */
+import { Matterbridge } from './matterbridge.js';
+import { RegisteredPlugin } from './matterbridgeTypes.js';
+/**
+ * Checks for updates for Matterbridge and its plugins.
+ * If the 'shelly' parameter is present, also checks for Shelly updates.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the update checks are complete.
+ */
+export declare function checkUpdates(matterbridge: Matterbridge): Promise<void>;
+/**
+ * Retrieves the latest version of Matterbridge and updates the matterbridgeLatestVersion property.
+ * If there is an error retrieving the latest version, logs an error message.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<String | undefined>} A promise that resolves when the latest version is retrieved.
+ */
+export declare function getMatterbridgeLatestVersion(matterbridge: Matterbridge): Promise<string | undefined>;
+/**
+ * Retrieves the latest dev version of Matterbridge and updates the matterbridgeDevVersion property.
+ * If there is an error retrieving the latest version, logs an error message.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<string | undefined>} A promise that resolves when the latest dev version is retrieved.
+ */
+export declare function getMatterbridgeDevVersion(matterbridge: Matterbridge): Promise<string | undefined>;
+/**
+ * Retrieves the latest version of a plugin and updates the plugin's latestVersion property.
+ * If there is an error retrieving the latest version, logs an error message.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @param {RegisteredPlugin} plugin - The plugin for which to retrieve the latest version.
+ * @returns {Promise<string | undefined>} A promise that resolves when the latest version is retrieved.
+ */
+export declare function getPluginLatestVersion(matterbridge: Matterbridge, plugin: RegisteredPlugin): Promise<string | undefined>;
+//# sourceMappingURL=update.d.ts.map

package/dist/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../src/update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAO,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB5E;AAED;;;;;;GAMG;AACH,wBAAsB,4BAA4B,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB1G;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmBvG;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB9H"}

package/dist/update.js

@@ -1,5 +1,35 @@
+/**
+ * This file contains the check updates functions.
+ *
+ * @file update.ts
+ * @author Luca Liguori
+ * @date 2025-02-24
+ * @version 1.0.0
+ *
+ * Copyright 2025, 2026, 2027 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License. *
+ */
+// AnsiLogger module
 import { db, nt, wr } from 'node-ansi-logger';
 import { plg } from './matterbridgeTypes.js';
+/**
+ * Checks for updates for Matterbridge and its plugins.
+ * If the 'shelly' parameter is present, also checks for Shelly updates.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<void>} A promise that resolves when the update checks are complete.
+ */
 export async function checkUpdates(matterbridge) {
     const { hasParameter } = await import('./utils/commandLine.js');
     const latestVersion = getMatterbridgeLatestVersion(matterbridge);
@@ -19,6 +49,13 @@ export async function checkUpdates(matterbridge) {
     }
     await Promise.all([latestVersion, devVersion, ...pluginsVersions, ...shellyUpdates]);
 }
+/**
+ * Retrieves the latest version of Matterbridge and updates the matterbridgeLatestVersion property.
+ * If there is an error retrieving the latest version, logs an error message.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<String | undefined>} A promise that resolves when the latest version is retrieved.
+ */
 export async function getMatterbridgeLatestVersion(matterbridge) {
     const { getNpmPackageVersion } = await import('./utils/network.js');
     try {
@@ -40,6 +77,13 @@ export async function getMatterbridgeLatestVersion(matterbridge) {
         matterbridge.log.warn(`Error getting Matterbridge latest version: ${error instanceof Error ? error.message : error}`);
     }
 }
+/**
+ * Retrieves the latest dev version of Matterbridge and updates the matterbridgeDevVersion property.
+ * If there is an error retrieving the latest version, logs an error message.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @returns {Promise<string | undefined>} A promise that resolves when the latest dev version is retrieved.
+ */
 export async function getMatterbridgeDevVersion(matterbridge) {
     const { getNpmPackageVersion } = await import('./utils/network.js');
     try {
@@ -61,6 +105,14 @@ export async function getMatterbridgeDevVersion(matterbridge) {
         matterbridge.log.warn(`Error getting Matterbridge latest dev version: ${error instanceof Error ? error.message : error}`);
     }
 }
+/**
+ * Retrieves the latest version of a plugin and updates the plugin's latestVersion property.
+ * If there is an error retrieving the latest version, logs an error message.
+ *
+ * @param {Matterbridge} matterbridge - The Matterbridge instance.
+ * @param {RegisteredPlugin} plugin - The plugin for which to retrieve the latest version.
+ * @returns {Promise<string | undefined>} A promise that resolves when the latest version is retrieved.
+ */
 export async function getPluginLatestVersion(matterbridge, plugin) {
     const { getNpmPackageVersion } = await import('./utils/network.js');
     try {
@@ -79,3 +131,4 @@ export async function getPluginLatestVersion(matterbridge, plugin) {
         matterbridge.log.warn(`Error getting plugin ${plg}${plugin.name}${wr} latest version: ${error instanceof Error ? error.message : error}`);
     }
 }
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

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

package/dist/utils/colorUtils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * This file contains the color utilities.
+ *
+ * @file colorUtils.ts
+ * @author Luca Liguori
+ * @date 2023-10-05
+ * @version 1.3.0
+ *
+ * Copyright 2023, 2024, 2025 Luca Liguori.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License. *
+ */
+export interface RGB {
+    r: number;
+    g: number;
+    b: number;
+}
+export interface XY {
+    x: number;
+    y: number;
+}
+export interface HSL {
+    h: number;
+    s: number;
+    l: number;
+}
+export declare function hslColorToRgbColor(hue: number, saturation: number, luminance: number): RGB;
+export declare function rgbColorToXYColor(rgb: RGB): XY;
+export declare function xyColorToRgbColor(x: number, y: number, brightness?: number): RGB;
+export declare function rgbColorToHslColor(rgb: RGB): HSL;
+export declare function xyToHsl(x: number, y: number): HSL;
+export declare function miredToKelvin(mired: number): number;
+export declare function kelvinToMired(kelvin: number): number;
+export declare function kelvinToRGB(kelvin: number): RGB;
+/**
+ * Converts CIE color space to RGB color space
+ * @param {Number} x
+ * @param {Number} y
+ * @param {Number} brightness - Ranges from 1 to 254
+ * @return {Array} Array that contains the color values for red, green and blue
+ * From: https://github.com/usolved/cie-rgb-converter/blob/master/cie_rgb_converter.js
+ */
+/**
+ * Converts RGB color space to CIE color space
+ * @param {Number} red
+ * @param {Number} green
+ * @param {Number} blue
+ * @return {Array} Array that contains the CIE color values for x and y
+ * From: https://github.com/usolved/cie-rgb-converter/blob/master/cie_rgb_converter.js
+ */
+//# sourceMappingURL=colorUtils.d.ts.map

package/dist/utils/colorUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorUtils.d.ts","sourceRoot":"","sources":["../../src/utils/colorUtils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,EAAE;IACjB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,MAAM,WAAW,GAAG;IAClB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,GAAG,CA+C1F;AAGD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,CA6B9C;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,SAAM,GAAG,GAAG,CAgD7E;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAmChD;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG,CAGjD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAsC/C;AAwDD;;;;;;;GAOG;AAsDH;;;;;;;GAOG"}