@similie/hyphen-command-server-types 1.0.0

package/dist/tools/utils.js

@@ -0,0 +1,283 @@
+import CryptoJS from "crypto-js";
+import { v4 } from "uuid";
+export const mqttMessageIdentity = (payload) => {
+    try {
+        const value = JSON.parse(payload.toString());
+        value._uid = generateUniqueUUID();
+        return JSON.stringify(value);
+    }
+    catch {
+        return payload.toString();
+    }
+};
+export const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+export const wrapModelSet = (models, wrapOn = "uid") => {
+    const map = new Map();
+    models.forEach((m) => map.set(m[wrapOn], m));
+    return (key) => {
+        if (!map.has(key)) {
+            return null;
+        }
+        return map.get(key);
+    };
+};
+export const URL_HOST_PATTERN_FOR_INPUT = /^(https?:\/\/)?((([a-z0-9]([a-z0-9\-]*[a-z0-9])*)\.)+[a-z]{2,}|(([0-9]{1,3}\.){3}[0-9]{1,3}))(:[0-9]+)?(\/[\-a-z0-9%_.~+]*)*(\?[;&a-z0-9%_.~+=\-]*)?(#[-a-z0-9_]*)?$/;
+export const DOMAIN_PATTERN = /^(?:\*\.)?(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,}$/i;
+export function isNumeric(str) {
+    if (typeof str !== "string")
+        return false; // we only process strings
+    const trimmed = str.trim();
+    if (trimmed === "")
+        return false;
+    return !isNaN(Number(trimmed));
+}
+export const generateUniqueUUID = () => {
+    return v4();
+};
+export function formatDate(date, locale = "en-AU", options = {
+    year: "numeric",
+    month: "2-digit",
+    day: "2-digit",
+}) {
+    if (typeof date === "string") {
+        date = new Date(date);
+    }
+    return date.toLocaleDateString(locale, options);
+}
+export function formatMoney(value, currencySymbol = "$") {
+    let formattedValue = value.toString();
+    if (value.toString().includes(".")) {
+        formattedValue = value.toFixed(2);
+    }
+    else {
+        formattedValue = value.toString() + ".00";
+    }
+    return `${currencySymbol}${formattedValue}`;
+}
+export const siteMoneyFormatConfig = (value, currencyDivisor = 100, currencySymbol = "$") => {
+    if (typeof value !== "number" && isNaN(value)) {
+        return "0.00";
+    }
+    const divisor = currencyDivisor;
+    const formattedValue = (value / divisor).toFixed(2);
+    return `${currencySymbol}${formattedValue}`;
+};
+export const errorMessageWithCode = (message) => {
+    if (!message) {
+        return { code: 500, message: message };
+    }
+    const errorCode = message.split(":");
+    if (errorCode.length > 1) {
+        const code = errorCode[0] || "500";
+        const intValue = parseInt(code);
+        return {
+            code: Number.isNaN(intValue) ? 500 : intValue,
+            message: errorCode[1],
+        };
+    }
+    return { code: 500, message: message };
+};
+export const isDomainPattern = (str) => {
+    if (!str || typeof str !== "string")
+        return false;
+    return DOMAIN_PATTERN.test(str);
+};
+export const extractFormToJson = (form) => {
+    const asObject = Object.fromEntries(form.entries());
+    const data = {};
+    for (const key of Object.keys(asObject)) {
+        try {
+            data[key] = JSON.parse(asObject[key]);
+        }
+        catch {
+            data[key] = asObject[key];
+        }
+    }
+    return data;
+};
+export const delay = (timeout = 1000) => new Promise((resolve) => setTimeout(resolve, timeout));
+export const generateRandomInt = (min, max) => {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+};
+export const generateUniqueId = (numBytes = 16) => {
+    const wordArray = CryptoJS.lib.WordArray.random(numBytes);
+    // Convert the WordArray to a hexadecimal string
+    return wordArray.toString(CryptoJS.enc.Hex);
+};
+export const isUUID = (value) => {
+    const regex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}/i;
+    return regex.test(value);
+};
+export const validateEmail = (email) => {
+    const emailRegex = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+    return emailRegex.test(email);
+};
+export const generateRandomPassword = (length) => {
+    const characters = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789!@#$%^&*()_+[]{}|;:,.<>?";
+    let password = "";
+    for (let i = 0; i < length; i++) {
+        const randomIndex = Math.floor(Math.random() * characters.length);
+        password += characters[randomIndex];
+    }
+    return password;
+};
+export const fileToUint8Array = (file) => {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => {
+            const arrayBuffer = reader.result;
+            const uint8Array = new Uint8Array(arrayBuffer);
+            resolve(uint8Array);
+        };
+        reader.onerror = () => {
+            reject(new Error("Error reading file as ArrayBuffer"));
+        };
+        reader.readAsArrayBuffer(file);
+    });
+};
+function readFileAsArrayBuffer(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = function (event) {
+            const arrayBuffer = event.target?.result;
+            resolve(arrayBuffer);
+        };
+        reader.onerror = function () {
+            reject(new Error("Error reading file"));
+        };
+        reader.readAsArrayBuffer(file);
+    });
+}
+async function sha256Fallback(arrayBuffer) {
+    const wordArray = CryptoJS.lib.WordArray.create(arrayBuffer);
+    const hash = CryptoJS.SHA256(wordArray);
+    return hash.toString(CryptoJS.enc.Hex);
+}
+async function sha256(arrayBuffer) {
+    if (crypto.subtle) {
+        const hashBuffer = await crypto.subtle.digest("SHA-256", arrayBuffer);
+        return Array.from(new Uint8Array(hashBuffer))
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+    }
+    else {
+        // Use fallback if crypto.subtle isn't available
+        return sha256Fallback(arrayBuffer);
+    }
+}
+export function sha256String(values) {
+    const encoder = new TextEncoder();
+    const uint8Array = encoder.encode(values);
+    const wordArray = CryptoJS.lib.WordArray.create(uint8Array);
+    const hash = CryptoJS.SHA256(wordArray);
+    return hash.toString(CryptoJS.enc.Hex);
+}
+export const ParseSocketMessage = (message) => {
+    try {
+        return JSON.parse(message);
+    }
+    catch {
+        return message;
+    }
+};
+export const stripStateFromObject = (obj) => {
+    try {
+        return JSON.parse(JSON.stringify(obj));
+    }
+    catch {
+        return obj;
+    }
+};
+export const buildShaValueString = (data) => {
+    return sha256String(JSON.stringify(data));
+};
+async function computeHash(arrayBuffer) {
+    const hashBuffer = await sha256(arrayBuffer);
+    return hashBuffer;
+}
+export const hashFileContents = async (file) => {
+    const arrayBuffer = await readFileAsArrayBuffer(file);
+    return computeHash(arrayBuffer);
+};
+export const fileListToFile = async (file) => {
+    const uint8Array = await fileToUint8Array(file);
+    return new File([uint8Array], file.name, {
+        type: file.type,
+        lastModified: file.lastModified,
+    });
+};
+export const formatMessageServerMessage = (message) => {
+    const backup = "Failed to send verification email";
+    if (!message) {
+        return backup;
+    }
+    try {
+        const errMessage = JSON.parse(message);
+        if (errMessage?.error) {
+            return errMessage.error;
+        }
+        if (errMessage?.message) {
+            return errMessage.message;
+        }
+        throw new Error("Not known json");
+    }
+    catch {
+        return message;
+    }
+};
+export const isOlderThanInDays = (created_at, days) => {
+    // Get the current date and time
+    const currentDate = new Date();
+    // Calculate the target date by subtracting `days` from the current date
+    const targetDate = new Date();
+    targetDate.setDate(currentDate.getDate() - days);
+    // Compare created_at with the target date
+    return created_at < targetDate;
+};
+export const removeDoubleSpaces = (text) => {
+    return text.replace(/\s\s+/g, " ");
+};
+export const removeContentSpace = (text) => {
+    return removeDoubleSpaces(text.replace(/[\n\t]/g, " ")); // new lines and tabs
+};
+export const removeHtmlEntities = (text) => {
+    return text.replace(/(?:&#x[a-f0-9]{2};|&#[0-9]+;)/g, " ");
+};
+export function getLast30DaysLabels(locale = "en-US") {
+    const labels = [];
+    const today = new Date();
+    for (let daysAgo = 30; daysAgo >= 0; daysAgo--) {
+        const d = new Date(today);
+        d.setDate(d.getDate() - daysAgo);
+        // e.g. "Jan"
+        const month = d.toLocaleString(locale, { month: "short" });
+        // day of month, no leading zero: "1", "31", etc.
+        const day = d.getDate();
+        labels.push(`${month}, ${day}`);
+    }
+    return labels;
+}
+export function humanizeNumber(value, precision = 1) {
+    if (value === 0)
+        return "0";
+    const suffixes = [
+        "",
+        " thousand",
+        " million",
+        " billion",
+        " trillion",
+        " quadrillion",
+    ];
+    const abs = Math.abs(value);
+    const tier = Math.floor(Math.log10(abs) / 3);
+    // if in the ones (no suffix)
+    if (tier === 0) {
+        return value.toString();
+    }
+    const scale = 10 ** (tier * 3);
+    const scaled = value / scale;
+    // format to `precision` decimals, then drop any trailing “.0”
+    const formatted = scaled.toFixed(precision).replace(/\.0+$/, "");
+    return `${formatted}${suffixes[tier]}`;
+}
+//# sourceMappingURL=utils.js.map

package/dist/tools/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/tools/utils.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAQ1B,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,OAAgC,EACxB,EAAE;IACV,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7C,KAAK,CAAC,IAAI,GAAG,kBAAkB,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,QAAQ,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAG,kDAAkD,CAAC;AAE7E,MAAM,CAAC,MAAM,YAAY,GAAG,CAC1B,MAAW,EACX,SAAkB,KAAgB,EAClC,EAAE;IACF,MAAM,GAAG,GAAG,IAAI,GAAG,EAAc,CAAC;IAClC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAY,EAAE,CAAC,CAAC,CAAC,CAAC;IAExD,OAAO,CAAC,GAAY,EAAE,EAAE;QACtB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GACrC,sKAAsK,CAAC;AACzK,MAAM,CAAC,MAAM,cAAc,GACzB,kEAAkE,CAAC;AACrE,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC,CAAC,0BAA0B;IACrE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE;IACrC,OAAO,EAAE,EAAU,CAAC;AACtB,CAAC,CAAC;AAEF,MAAM,UAAU,UAAU,CACxB,IAAmB,EACnB,MAAM,GAAG,OAAO,EAChB,UAAsC;IACpC,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,SAAS;CACf;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,iBAAyB,GAAG;IACrE,IAAI,cAAc,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;IACtC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,cAAc,GAAG,KAAK,CAAC,QAAQ,EAAE,GAAG,KAAK,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,cAAc,GAAG,cAAc,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CACnC,KAAa,EACb,kBAA0B,GAAG,EAC7B,iBAAyB,GAAG,EACpB,EAAE;IACV,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,OAAO,GAAG,eAAe,CAAC;IAChC,MAAM,cAAc,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACpD,OAAO,GAAG,cAAc,GAAG,cAAc,EAAE,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,OAAe,EAAE,EAAE;IACtD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IACzC,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;QACnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ;YAC7C,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC;SACtB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AACzC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAW,EAAE;IACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClD,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAc,EACd,EAAE;IACF,MAAM,QAAQ,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,MAAM,IAAI,GAAQ,EAAE,CAAC;IACrB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAW,CAAC,CAAC;QAClD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,IAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE,CACtC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAW,EAAE,GAAW,EAAU,EAAE;IACpE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;AAC3D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAE,EAAU,EAAE;IAChE,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC1D,gDAAgD;IAChD,OAAO,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,KAAoB,EAAE,EAAE;IAC7C,MAAM,KAAK,GACT,uEAAuE,CAAC;IAC1E,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAa,EAAW,EAAE;IACtD,MAAM,UAAU,GAAG,kDAAkD,CAAC;IACtE,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAc,EAAU,EAAE;IAC/D,MAAM,UAAU,GACd,wFAAwF,CAAC;IAC3F,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAClE,QAAQ,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IACtC,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAU,EAAuB,EAAE;IAClE,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAChC,MAAM,CAAC,MAAM,GAAG,GAAG,EAAE;YACnB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAqB,CAAC;YACjD,MAAM,UAAU,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;YAC/C,OAAO,CAAC,UAAU,CAAC,CAAC;QACtB,CAAC,CAAC;QACF,MAAM,CAAC,OAAO,GAAG,GAAG,EAAE;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC;QACF,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,SAAS,qBAAqB,CAAC,IAAU;IACvC,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAClD,MAAM,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAEhC,MAAM,CAAC,MAAM,GAAG,UAAU,KAAK;YAC7B,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,MAAqB,CAAC;YACxD,OAAO,CAAC,WAAW,CAAC,CAAC;QACvB,CAAC,CAAC;QAEF,MAAM,CAAC,OAAO,GAAG;YACf,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;QAC1C,CAAC,CAAC;QAEF,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,WAAwB;IACpD,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,WAAwB;IAC5C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACtE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,UAAU,CAAC,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;aAC3C,IAAI,CAAC,EAAE,CAAC,CAAC;IACd,CAAC;SAAM,CAAC;QACN,gDAAgD;QAChD,OAAO,cAAc,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;IAClC,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAI,OAAe,EAAK,EAAE;IAC1D,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAiB,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAuB,CAAC;IACjC,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,GAAQ,EAAE,EAAE;IAC/C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,IAAS,EAAE,EAAE;IAC/C,OAAO,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF,KAAK,UAAU,WAAW,CAAC,WAAwB;IACjD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;IAC7C,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,IAAU,EAAmB,EAAE;IACpE,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACtD,OAAO,WAAW,CAAC,WAAW,CAAC,CAAC;AAClC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,IAAU,EAAiB,EAAE;IAChE,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,IAAI,IAAI,CAAC,CAAC,UAAsB,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE;QACnD,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,YAAY,EAAE,IAAI,CAAC,YAAY;KAChC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,OAAe,EAAE,EAAE;IAC5D,MAAM,MAAM,GAAG,mCAAmC,CAAC;IACnD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACvC,IAAI,UAAU,EAAE,KAAK,EAAE,CAAC;YACtB,OAAO,UAAU,CAAC,KAAK,CAAC;QAC1B,CAAC;QACD,IAAI,UAAU,EAAE,OAAO,EAAE,CAAC;YACxB,OAAO,UAAU,CAAC,OAAO,CAAC;QAC5B,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,UAAgB,EAAE,IAAY,EAAW,EAAE;IAC3E,gCAAgC;IAChC,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;IAE/B,wEAAwE;IACxE,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC;IAC9B,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAEjD,0CAA0C;IAC1C,OAAO,UAAU,GAAG,UAAU,CAAC;AACjC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,EAAE;IACjD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,EAAE;IACjD,OAAO,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,qBAAqB;AAChF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,EAAE;IACjD,OAAO,IAAI,CAAC,OAAO,CAAC,gCAAgC,EAAE,GAAG,CAAC,CAAC;AAC7D,CAAC,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,MAAM,GAAG,OAAO;IAClD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;IAEzB,KAAK,IAAI,OAAO,GAAG,EAAE,EAAE,OAAO,IAAI,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC;QAC/C,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;QAC1B,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC;QAEjC,aAAa;QACb,MAAM,KAAK,GAAG,CAAC,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3D,iDAAiD;QACjD,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;QAExB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,KAAK,GAAG,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,SAAS,GAAG,CAAC;IACzD,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC5B,MAAM,QAAQ,GAAG;QACf,EAAE;QACF,WAAW;QACX,UAAU;QACV,UAAU;QACV,WAAW;QACX,cAAc;KACf,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7C,6BAA6B;IAC7B,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;QACf,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,KAAK,GAAG,EAAE,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;IAC7B,8DAA8D;IAC9D,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAEjE,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;AACzC,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@similie/hyphen-command-server-types",
+  "version": "1.0.0",
+  "description": "Adds common types for Hyphen Command Center modules.",
+  "main": "./dist/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "tsc",
+    "release": "npm run build && standard-version"
+  },
+  "keywords": [],
+  "author": "guernica0131 (Similie)",
+  "license": "ISC",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@similie/ellipsies": "^1.0.16",
+    "@similie/http-connector": "^0.0.17",
+    "@similie/model-connect-entities": "^1.1.4",
+    "crypto-js": "^4.2.0",
+    "ioredis": "^5.8.2",
+    "redis": "^5.10.0",
+    "redlock": "5.0.0-beta.2",
+    "ts-node-dev": "^2.0.0",
+    "uuid": "^13.0.0"
+  },
+  "devDependencies": {
+    "@types/crypto-js": "^4.2.2",
+    "@types/node": "^24.7.0",
+    "standard-version": "^9.5.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1,4 @@
+export * from "./models";
+export * from "./tools";
+export * from "./services";
+export * from "./modules";

package/src/models/base-model.ts

@@ -0,0 +1,13 @@
+import { type UUID as _UUID } from "@similie/ellipsies";
+export type UUID = _UUID;
+export interface BaseModel {
+  id: number;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface BaseUIDModel {
+  uid: UUID; // TODO: needs to be UUID
+  createdAt: Date;
+  updatedAt: Date;
+}

package/src/models/index.ts

@@ -0,0 +1 @@
+export * from "./base-model";

package/src/modules/index.ts

@@ -0,0 +1,2 @@
+export * from "./types";
+export * from "./loader";

package/src/modules/loader.ts

@@ -0,0 +1,67 @@
+// src/modules/loader.ts
+import type { HyphenModule, ModuleContext, LoadedModule } from "./types";
+
+export async function loadModulesFromEnv(
+  ctx: ModuleContext,
+): Promise<LoadedModule[]> {
+  const raw = process.env.HYPHEN_MODULES?.trim();
+  if (!raw) return [];
+
+  const specList = raw
+    .split(",")
+    .map((s) => s.trim())
+    .filter(Boolean);
+
+  const loaded: LoadedModule[] = [];
+
+  for (const spec of specList) {
+    // spec can be:
+    // - "hyphen-rtsp-module"
+    // - "@similie/hyphen-rtsp-module"
+    // - "file:./dist/my-module.js" (dev)
+    try {
+      const imported = await import(spec);
+      const candidate: HyphenModule =
+        imported.default ?? imported.module ?? imported;
+
+      if (
+        !candidate ||
+        typeof candidate.init !== "function" ||
+        !candidate.name
+      ) {
+        ctx.log(`[modules] invalid module export: ${spec}`, { spec });
+        continue;
+      }
+
+      ctx.log(`[modules] init ${candidate.name}`, {
+        spec,
+        version: candidate.version,
+      });
+      const res = await candidate.init(ctx);
+      loaded.push({ mod: candidate, res });
+      ctx.log(`[modules] ready ${candidate.name}`, { spec });
+    } catch (e: any) {
+      ctx.log(`[modules] failed to load: ${spec}`, {
+        error: e?.message ?? String(e),
+      });
+    }
+  }
+
+  return loaded;
+}
+
+export async function shutdownModules(
+  ctx: ModuleContext,
+  loaded: LoadedModule[],
+) {
+  for (const { mod, res } of loaded) {
+    try {
+      res && (await res?.shutdown?.());
+      ctx.log(`[modules] shutdown ${mod.name}`);
+    } catch (e: any) {
+      ctx.log(`[modules] shutdown failed ${mod.name}`, {
+        error: e?.message ?? String(e),
+      });
+    }
+  }
+}

package/src/modules/types.ts

@@ -0,0 +1,40 @@
+// src/modules/types.ts
+import type { RedisCache, LeaderElector } from "../services"; // or your Redis wrapper type
+import type { Ellipsies } from "@similie/ellipsies";
+// If you have an Ellipsies instance type, use it. Otherwise keep as `any` and tighten later.
+export type EllipsiesInstance = Ellipsies;
+
+export type CommandCenterSystemIdentity = {
+  name: string;
+  identity: string;
+  host: string;
+  port: number;
+};
+
+export type ModuleContext = {
+  ellipsies: EllipsiesInstance;
+  redis: typeof RedisCache;
+  leader: LeaderElector;
+  identity?: CommandCenterSystemIdentity;
+  log: (msg: string, extra?: Record<string, any>) => void;
+};
+
+export type ModuleInitResult = {
+  // Optional cleanup hook called on shutdown
+  shutdown?: () => Promise<void> | void;
+};
+
+export interface HyphenModule {
+  name: string;
+  version?: string;
+
+  // Called once per process on boot
+  init(
+    ctx: ModuleContext,
+  ): Promise<ModuleInitResult | void> | (ModuleInitResult | void);
+}
+
+export type LoadedModule = {
+  mod: HyphenModule;
+  res?: ModuleInitResult | void;
+};

package/src/services/index.ts

@@ -0,0 +1,2 @@
+export * from "./leader-lock";
+export * from "./redis";

package/src/services/leader-lock.ts

@@ -0,0 +1,113 @@
+import { EventEmitter } from "events";
+import { Redis } from "ioredis";
+import Redlock, { Lock } from "redlock";
+import { randomUUID } from "crypto";
+
+export type LeaderEvents = {
+  elected: () => void;
+  revoked: () => void;
+  error: (err: Error) => void;
+};
+
+export class LeaderElector extends EventEmitter {
+  private static instance: LeaderElector;
+  private redlock!: Redlock;
+  private redis!: Redis;
+  private renewTimer?: NodeJS.Timeout;
+  private acquireTimer?: NodeJS.Timeout;
+  private lock?: Lock | undefined;
+
+  private readonly lockKey = "mqtt:leader:lock";
+  private readonly ttlMs = 10000; // lock TTL
+  private readonly renewEveryMs = 5000; // extend interval (< TTL)
+  private readonly retryDelayMs = 1500; // backoff when not leader
+  private readonly instanceId = randomUUID(); // for logging/diagnostics
+
+  private constructor() {
+    super();
+  }
+
+  static get(): LeaderElector {
+    if (!this.instance) this.instance = new LeaderElector();
+    return this.instance;
+  }
+
+  init(redisUrl: string) {
+    this.redis = new Redis(redisUrl);
+    this.redlock = new Redlock([this.redis], {
+      // Redlock will keep retrying for us when we explicitly request it,
+      // but we’ll manage our own retry loop here.
+      driftFactor: 0.01,
+      retryCount: 0,
+      retryDelay: 0,
+    });
+    this.startAcquireLoop();
+  }
+
+  /** Pure check: true only if we *currently* hold a live lock. */
+  amLeader(): boolean {
+    return !!this.lock;
+  }
+
+  /** Stop loops and release if we are leader. */
+  async shutdown() {
+    clearTimeout(this.acquireTimer as any);
+    clearInterval(this.renewTimer as any);
+    await this.safeRelease();
+    await this.redis?.quit();
+  }
+
+  // -------- internal --------
+
+  private startAcquireLoop() {
+    const tryAcquire = async () => {
+      if (this.lock) return; // already leader
+
+      try {
+        // Acquire without retries; we run our own loop.
+        const lock = await this.redlock.acquire([this.lockKey], this.ttlMs);
+        this.lock = lock;
+        this.emit("elected");
+        this.startRenewLoop();
+      } catch {
+        // Not acquired (someone else is leader). Back off a bit (with jitter).
+      } finally {
+        const jitter = Math.floor(Math.random() * 500);
+        this.acquireTimer = setTimeout(tryAcquire, this.retryDelayMs + jitter);
+      }
+    };
+
+    tryAcquire().catch((err) => this.emit("error", err as Error));
+  }
+
+  private startRenewLoop() {
+    clearInterval(this.renewTimer as any);
+    this.renewTimer = setInterval(async () => {
+      if (!this.lock) return;
+      try {
+        this.lock = await this.lock.extend(this.ttlMs);
+      } catch (err) {
+        // Couldn’t extend: we lost leadership (expired or Redis issue)
+        await this.safeRevoke();
+        // acquisition loop is already running, it’ll try to reacquire
+      }
+    }, this.renewEveryMs);
+  }
+
+  private async safeRevoke() {
+    clearInterval(this.renewTimer as any);
+    this.lock = undefined;
+    this.emit("revoked");
+  }
+
+  private async safeRelease() {
+    if (!this.lock) return;
+    try {
+      await this.lock.release();
+    } catch {
+      // If already expired or released, ignore.
+    } finally {
+      await this.safeRevoke();
+    }
+  }
+}

package/src/services/redis.ts

@@ -0,0 +1,69 @@
+// src/services/redis.ts
+import { createClient } from "redis";
+const getRedisConfig = () => {
+  return process.env.REDIS_CONFIG_URL || "redis://localhost:6379/1";
+};
+export class RedisCache {
+  // Create a Redis client instance.
+  private static client = createClient({ url: getRedisConfig() });
+  private static DEFAULT_EXPIRATION_SECONDS = 900; // 15 minutes
+
+  /**
+   * Initializes the Redis client. Call this once on server startup.
+   */
+  public static async init(): Promise<void> {
+    if (this.client.isOpen) {
+      return;
+    }
+    try {
+      await this.client.connect();
+      console.log("Connected to Redis");
+    } catch (err) {
+      console.error("Error connecting to Redis:", err);
+    }
+  }
+
+  /**
+   * Caches an object under a specified key.
+   * @param key The cache key.
+   * @param value The object to cache.
+   * @param expirationSeconds Optional expiration time in seconds (defaults to 15 minutes).
+   */
+  public static async set(
+    key: string,
+    value: any,
+    expirationSeconds?: number,
+  ): Promise<void> {
+    const exp = expirationSeconds || this.DEFAULT_EXPIRATION_SECONDS;
+    const stringValue = JSON.stringify(value);
+    await this.client.set(key, stringValue, { EX: exp });
+  }
+
+  /**
+   * Retrieves a cached object by its key.
+   * @param key The cache key.
+   * @returns The cached object, or null if not found.
+   */
+  public static async get<T>(key: string): Promise<T | null> {
+    const data = await this.client.get(key);
+    if (data) {
+      try {
+        return JSON.parse(
+          typeof data === "string" ? data : JSON.stringify(data),
+        );
+      } catch (err) {
+        console.error("Error parsing cached data:", err);
+        return data as unknown as T | null;
+      }
+    }
+    return null;
+  }
+
+  /**
+   * Deletes a cache entry.
+   * @param key The cache key.
+   */
+  public static async del(key: string): Promise<void> {
+    await this.client.del(key);
+  }
+}

package/src/tools/index.ts

@@ -0,0 +1 @@
+export * from "./utils";