@lichens-innovation/ts-common 1.6.1 → 1.6.3

package/dist/index.cjs

@@ -0,0 +1,468 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  HZ_TO_RPM: () => HZ_TO_RPM,
+  M3PS_TO_GPM: () => M3PS_TO_GPM,
+  M_TO_INCHES: () => M_TO_INCHES,
+  NO_OP: () => NO_OP,
+  PA_TO_FT: () => PA_TO_FT,
+  PeriodsInMS: () => PeriodsInMS,
+  REGEX_ALPHANUMERIC: () => REGEX_ALPHANUMERIC,
+  REGEX_IPV4: () => REGEX_IPV4,
+  SCHEME_PREFIXES: () => SCHEME_PREFIXES,
+  W_TO_HP: () => W_TO_HP,
+  capitalizeFirst: () => capitalizeFirst,
+  closeWebSocket: () => closeWebSocket,
+  countWords: () => countWords,
+  dateAs_HHMMSS: () => dateAs_HHMMSS,
+  dateAs_YYYYMMDD: () => dateAs_YYYYMMDD,
+  dateAs_YYYYMMDD_HHMMSS: () => dateAs_YYYYMMDD_HHMMSS,
+  formatUnixTimestamp: () => formatUnixTimestamp,
+  fromHzToRpm: () => fromHzToRpm,
+  fromM3psToGPM: () => fromM3psToGPM,
+  fromMToInches: () => fromMToInches,
+  fromPaToFt: () => fromPaToFt,
+  fromWToHp: () => fromWToHp,
+  getColorForPercentage: () => getColorForPercentage,
+  getContrastTextColor: () => getContrastTextColor,
+  getCurrentUnixTimestamp: () => getCurrentUnixTimestamp,
+  getErrorMessage: () => getErrorMessage,
+  getLuminance: () => getLuminance,
+  getOpacityHexValue: () => getOpacityHexValue,
+  getOrderOfMagnitudeExponent: () => getOrderOfMagnitudeExponent,
+  hasScheme: () => hasScheme,
+  hexToNormalizedRgb: () => hexToNormalizedRgb,
+  hexToRgb: () => hexToRgb,
+  isActiveTimestamp: () => isActiveTimestamp,
+  isAlphanumeric: () => isAlphanumeric,
+  isBlank: () => isBlank,
+  isExpiredTimestamp: () => isExpiredTimestamp,
+  isHttpClientErrorStatus: () => isHttpClientErrorStatus,
+  isHttpServerErrorStatus: () => isHttpServerErrorStatus,
+  isHttpSuccessStatus: () => isHttpSuccessStatus,
+  isLightColor: () => isLightColor,
+  isNotBlank: () => isNotBlank,
+  isNullish: () => isNullish,
+  isNumber: () => isNumber,
+  isString: () => isString,
+  isWsClosable: () => isWsClosable,
+  isWsOpenOrConnecting: () => isWsOpenOrConnecting,
+  nowAsDate: () => nowAsDate,
+  nowAsDateTime: () => nowAsDateTime,
+  nowAsDateTimeForFilename: () => nowAsDateTimeForFilename,
+  nowAsTime: () => nowAsTime,
+  removeDiacriticalMarks: () => removeDiacriticalMarks,
+  rgbToHex: () => rgbToHex,
+  rgbToString: () => rgbToString,
+  rgbaToHex: () => rgbaToHex,
+  rgbaToHexWithAlpha: () => rgbaToHexWithAlpha,
+  rgbaToString: () => rgbaToString,
+  roundUpToNearest10: () => roundUpToNearest10,
+  sleep: () => sleep,
+  toFixed: () => toFixed,
+  truncate: () => truncate
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/utils/color.utils.ts
+var rgbToHex = (r, g, b) => {
+  if (r > 255 || g > 255 || b > 255) {
+    throw new Error("Invalid color component");
+  }
+  return (r << 16 | g << 8 | b).toString(16).padStart(6, "0");
+};
+var hexToRgb = (hex) => {
+  const cleanHex = hex.replace("#", "");
+  const r = parseInt(cleanHex.substring(0, 2), 16);
+  const g = parseInt(cleanHex.substring(2, 4), 16);
+  const b = parseInt(cleanHex.substring(4, 6), 16);
+  return { r, g, b };
+};
+var rgbaToHex = (color) => {
+  return "#" + rgbToHex(color.r, color.g, color.b);
+};
+var getOpacityHexValue = (opacity) => {
+  if (opacity < 0 || opacity > 1) {
+    throw new Error("Invalid opacity value");
+  }
+  return Math.round(opacity * 255).toString(16).padStart(2, "0");
+};
+var rgbaToHexWithAlpha = (color) => {
+  return rgbaToHex(color) + getOpacityHexValue(color.a);
+};
+var rgbToString = (color) => {
+  return `rgb(${color.r}, ${color.g}, ${color.b})`;
+};
+var rgbaToString = (color) => {
+  return `rgba(${color.r}, ${color.g}, ${color.b}, ${color.a})`;
+};
+var getLuminance = (r, g, b) => {
+  return (0.299 * r + 0.587 * g + 0.114 * b) / 255;
+};
+var getContrastTextColor = (hexColor) => {
+  const { r, g, b } = hexToRgb(hexColor);
+  return getLuminance(r, g, b) > 0.5 ? "#000000" : "#ffffff";
+};
+var hexToNormalizedRgb = (hex) => {
+  const result = /^#?([a-f\d]{2})([a-f\d]{2})([a-f\d]{2})$/i.exec(hex);
+  return result ? {
+    r: parseInt(result[1], 16) / 255,
+    g: parseInt(result[2], 16) / 255,
+    b: parseInt(result[3], 16) / 255
+  } : { r: 0, g: 0, b: 0 };
+};
+var isLightColor = (hex) => {
+  const rgb = hexToNormalizedRgb(hex);
+  const luminance = 0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b;
+  return luminance > 0.5;
+};
+var PERCENT_COLORS = [
+  { pct: 0, color: { r: 255, g: 0, b: 0 } },
+  { pct: 0.5, color: { r: 255, g: 255, b: 0 } },
+  { pct: 1, color: { r: 0, g: 255, b: 0 } }
+];
+var getColorForPercentage = (percent) => {
+  if (percent < 0 || percent > 1) {
+    throw new Error(`Percentage must be between 0 and 1: ${percent}`);
+  }
+  let i = 0;
+  for (i = 1; i < PERCENT_COLORS.length - 1; i++) {
+    if (percent < PERCENT_COLORS[i].pct) {
+      break;
+    }
+  }
+  const lower = PERCENT_COLORS[i - 1];
+  const upper = PERCENT_COLORS[i];
+  const range = upper.pct - lower.pct;
+  const rangePct = (percent - lower.pct) / range;
+  const pctLower = 1 - rangePct;
+  const pctUpper = rangePct;
+  const color = {
+    r: Math.floor(lower.color.r * pctLower + upper.color.r * pctUpper),
+    g: Math.floor(lower.color.g * pctLower + upper.color.g * pctUpper),
+    b: Math.floor(lower.color.b * pctLower + upper.color.b * pctUpper)
+  };
+  return "rgb(" + [color.r, color.g, color.b].join(",") + ")";
+};
+
+// src/utils/date.utils.ts
+var import_date_fns = require("date-fns");
+
+// src/utils/types.utils.ts
+var NO_OP = () => {
+};
+var isNullish = (value) => value === null || value === void 0;
+var isNumber = (value) => {
+  if (isNullish(value)) {
+    return false;
+  }
+  if (typeof value !== "number") {
+    return false;
+  }
+  if (isNaN(value)) {
+    return false;
+  }
+  return true;
+};
+var isString = (value) => {
+  if (isNullish(value)) {
+    return false;
+  }
+  if (typeof value !== "string") {
+    return false;
+  }
+  return true;
+};
+
+// src/utils/date.utils.ts
+var dateAs_HHMMSS = (value) => {
+  if (isNullish(value)) return "";
+  return (0, import_date_fns.format)(value, "HH:mm:ss");
+};
+var dateAs_YYYYMMDD = (value) => {
+  if (isNullish(value)) return "";
+  return (0, import_date_fns.format)(value, "yyyy-MM-dd");
+};
+var dateAs_YYYYMMDD_HHMMSS = (value) => {
+  if (isNullish(value)) return "";
+  return (0, import_date_fns.format)(value, "yyyy-MM-dd HH:mm:ss");
+};
+var nowAsTime = () => dateAs_HHMMSS(/* @__PURE__ */ new Date());
+var nowAsDate = () => dateAs_YYYYMMDD(/* @__PURE__ */ new Date());
+var nowAsDateTime = () => dateAs_YYYYMMDD_HHMMSS(/* @__PURE__ */ new Date());
+var nowAsDateTimeForFilename = () => {
+  return (0, import_date_fns.format)(/* @__PURE__ */ new Date(), "yyyy-MM-dd_HH-mm-ss");
+};
+var DEFAULT_DATE_FORMAT = "yyyy-MM-dd HH:mm:ss";
+var formatUnixTimestamp = (timestamp, dateFormat = DEFAULT_DATE_FORMAT) => {
+  if (!timestamp) return "N/A";
+  try {
+    return (0, import_date_fns.format)(new Date(timestamp * 1e3), dateFormat);
+  } catch {
+    return "Invalid date";
+  }
+};
+var getCurrentUnixTimestamp = () => {
+  return Math.floor(Date.now() / 1e3);
+};
+var isExpiredTimestamp = (timestamp) => {
+  const now = getCurrentUnixTimestamp();
+  return timestamp < now;
+};
+var isActiveTimestamp = (timestamp) => {
+  const now = getCurrentUnixTimestamp();
+  return timestamp <= now;
+};
+
+// src/utils/errors.utils.ts
+var getErrorMessage = (error) => {
+  if (!error) {
+    return "";
+  }
+  if (typeof error === "string") {
+    return error;
+  }
+  if (typeof error === "object" && "message" in error) {
+    return error.message;
+  }
+  return JSON.stringify(error);
+};
+
+// src/utils/http.utils.ts
+var isHttpSuccessStatus = (status) => {
+  if (isNullish(status)) {
+    return false;
+  }
+  return status >= 200 && status < 300;
+};
+var isHttpClientErrorStatus = (status) => {
+  if (isNullish(status)) {
+    return false;
+  }
+  return status >= 400 && status < 500;
+};
+var isHttpServerErrorStatus = (status) => {
+  if (isNullish(status)) {
+    return false;
+  }
+  return status >= 500;
+};
+
+// src/utils/number.utils.ts
+var toFixed = (value, decimals = 0) => {
+  if (isNullish(value)) return 0;
+  if (decimals < 0) throw new Error("[toFixed] decimals must be >= 0");
+  if (decimals === 0) return Math.round(value);
+  const multiplier = Math.pow(10, decimals);
+  return Math.round(value * multiplier) / multiplier;
+};
+var roundUpToNearest10 = (value) => {
+  if (isNullish(value)) return 0;
+  return Math.ceil(value / 10) * 10;
+};
+var getOrderOfMagnitudeExponent = (n) => {
+  if (isNullish(n)) return 0;
+  if (!isNumber(n)) return 0;
+  const absValue = Math.abs(n);
+  if (absValue === 0) {
+    return 0;
+  }
+  const integerPart = Math.floor(absValue);
+  return Math.floor(Math.log10(integerPart));
+};
+
+// src/utils/regex.ts
+var REGEX_ALPHANUMERIC = /^[a-zA-Z0-9-_ $%#(){}:/.]+$/;
+var REGEX_IPV4 = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;
+
+// src/utils/string.utils.ts
+var isBlank = (str) => {
+  return isNullish(str) || str?.trim() === "";
+};
+var isNotBlank = (str) => {
+  return !isBlank(str);
+};
+var isAlphanumeric = (value) => {
+  return REGEX_ALPHANUMERIC.test(value);
+};
+var removeDiacriticalMarks = (value) => {
+  if (!value) {
+    return "";
+  }
+  return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+};
+var capitalizeFirst = (str) => {
+  if (!str) return str;
+  return str.charAt(0).toUpperCase() + str.slice(1);
+};
+var countWords = (text) => {
+  if (!text || text.trim().length === 0) return 0;
+  return text.split(/\s+/).filter((word) => word.length > 0).length;
+};
+var truncate = (str, maxLength, ellipsis = "...") => {
+  if (!str || str.length <= maxLength) return str;
+  return str.slice(0, maxLength - ellipsis.length) + ellipsis;
+};
+
+// src/utils/thread.utils.ts
+var sleep = (milliseconds) => new Promise((resolve) => setTimeout(resolve, milliseconds));
+
+// src/utils/time.utils.ts
+var ONE_SECOND_IN_MS = 1e3;
+var ONE_MINUTE_IN_MS = 60 * ONE_SECOND_IN_MS;
+var ONE_HOUR_IN_MS = 60 * ONE_MINUTE_IN_MS;
+var ONE_DAY_IN_MS = 24 * ONE_HOUR_IN_MS;
+var PeriodsInMS = {
+  oneSecond: ONE_SECOND_IN_MS,
+  oneMinute: ONE_MINUTE_IN_MS,
+  oneHour: ONE_HOUR_IN_MS,
+  oneDay: ONE_DAY_IN_MS
+};
+
+// src/utils/units.utils.ts
+var M3PS_TO_GPM = 15850.3;
+var PA_TO_FT = 334553e-9;
+var W_TO_HP = 134102e-8;
+var M_TO_INCHES = 39.3701;
+var HZ_TO_RPM = 60;
+var fromM3psToGPM = (value) => {
+  if (isNullish(value)) return 0;
+  return value * M3PS_TO_GPM;
+};
+var fromPaToFt = (value) => {
+  if (isNullish(value)) return 0;
+  return value * PA_TO_FT;
+};
+var fromWToHp = (value) => {
+  if (isNullish(value)) return 0;
+  return value * W_TO_HP;
+};
+var fromMToInches = (value) => {
+  if (isNullish(value)) return 0;
+  return value * M_TO_INCHES;
+};
+var fromHzToRpm = (value) => {
+  if (isNullish(value)) return 0;
+  return value * HZ_TO_RPM;
+};
+
+// src/utils/uri.utils.ts
+var SCHEME_PREFIXES = {
+  file: "file",
+  content: "content",
+  http: "http",
+  https: "https",
+  ftp: "ftp",
+  ftps: "ftps",
+  sftp: "sftp",
+  smb: "smb"
+};
+var SCHEME_PREFIXES_ARRAY = Object.values(SCHEME_PREFIXES);
+var hasScheme = (uri) => {
+  if (!uri) {
+    return false;
+  }
+  const lowerUri = uri.toLowerCase();
+  return SCHEME_PREFIXES_ARRAY.some((prefix) => lowerUri.startsWith(`${prefix}://`));
+};
+
+// src/utils/websocket.utils.ts
+var WEBSOCKET_CONNECT_STATES = [WebSocket.CONNECTING, WebSocket.OPEN];
+var isWsClosable = (ws) => {
+  if (isNullish(ws)) return false;
+  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);
+};
+var isWsOpenOrConnecting = (ws) => {
+  if (isNullish(ws)) return false;
+  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);
+};
+var closeWebSocket = (ws) => {
+  if (isNullish(ws) || !isWsClosable(ws)) return;
+  try {
+    ws.close();
+  } catch {
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HZ_TO_RPM,
+  M3PS_TO_GPM,
+  M_TO_INCHES,
+  NO_OP,
+  PA_TO_FT,
+  PeriodsInMS,
+  REGEX_ALPHANUMERIC,
+  REGEX_IPV4,
+  SCHEME_PREFIXES,
+  W_TO_HP,
+  capitalizeFirst,
+  closeWebSocket,
+  countWords,
+  dateAs_HHMMSS,
+  dateAs_YYYYMMDD,
+  dateAs_YYYYMMDD_HHMMSS,
+  formatUnixTimestamp,
+  fromHzToRpm,
+  fromM3psToGPM,
+  fromMToInches,
+  fromPaToFt,
+  fromWToHp,
+  getColorForPercentage,
+  getContrastTextColor,
+  getCurrentUnixTimestamp,
+  getErrorMessage,
+  getLuminance,
+  getOpacityHexValue,
+  getOrderOfMagnitudeExponent,
+  hasScheme,
+  hexToNormalizedRgb,
+  hexToRgb,
+  isActiveTimestamp,
+  isAlphanumeric,
+  isBlank,
+  isExpiredTimestamp,
+  isHttpClientErrorStatus,
+  isHttpServerErrorStatus,
+  isHttpSuccessStatus,
+  isLightColor,
+  isNotBlank,
+  isNullish,
+  isNumber,
+  isString,
+  isWsClosable,
+  isWsOpenOrConnecting,
+  nowAsDate,
+  nowAsDateTime,
+  nowAsDateTimeForFilename,
+  nowAsTime,
+  removeDiacriticalMarks,
+  rgbToHex,
+  rgbToString,
+  rgbaToHex,
+  rgbaToHexWithAlpha,
+  rgbaToString,
+  roundUpToNearest10,
+  sleep,
+  toFixed,
+  truncate
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/utils/color.utils.ts","../src/utils/date.utils.ts","../src/utils/types.utils.ts","../src/utils/errors.utils.ts","../src/utils/http.utils.ts","../src/utils/number.utils.ts","../src/utils/regex.ts","../src/utils/string.utils.ts","../src/utils/thread.utils.ts","../src/utils/time.utils.ts","../src/utils/units.utils.ts","../src/utils/uri.utils.ts","../src/utils/websocket.utils.ts"],"sourcesContent":["export * from \"./utils\";\n","export interface RgbColor {\n  r: number;\n  g: number;\n  b: number;\n}\n\nexport interface RgbaColor extends RgbColor {\n  a: number;\n}\n\nexport const rgbToHex = (r: number, g: number, b: number): string => {\n  if (r > 255 || g > 255 || b > 255) {\n    throw new Error(\"Invalid color component\");\n  }\n\n  return ((r << 16) | (g << 8) | b).toString(16).padStart(6, \"0\");\n};\n\nexport const hexToRgb = (hex: string): RgbColor => {\n  const cleanHex = hex.replace(\"#\", \"\");\n\n  const r = parseInt(cleanHex.substring(0, 2), 16);\n  const g = parseInt(cleanHex.substring(2, 4), 16);\n  const b = parseInt(cleanHex.substring(4, 6), 16);\n\n  return { r, g, b };\n};\n\nexport const rgbaToHex = (color: RgbaColor): string => {\n  return \"#\" + rgbToHex(color.r, color.g, color.b);\n};\n\nexport const getOpacityHexValue = (opacity: number): string => {\n  if (opacity < 0 || opacity > 1) {\n    throw new Error(\"Invalid opacity value\");\n  }\n\n  return Math.round(opacity * 255)\n    .toString(16)\n    .padStart(2, \"0\");\n};\n\nexport const rgbaToHexWithAlpha = (color: RgbaColor): string => {\n  return rgbaToHex(color) + getOpacityHexValue(color.a);\n};\n\nexport const rgbToString = (color: RgbColor): string => {\n  return `rgb(${color.r}, ${color.g}, ${color.b})`;\n};\n\nexport const rgbaToString = (color: RgbaColor): string => {\n  return `rgba(${color.r}, ${color.g}, ${color.b}, ${color.a})`;\n};\n\nexport const getLuminance = (r: number, g: number, b: number): number => {\n  return (0.299 * r + 0.587 * g + 0.114 * b) / 255;\n};\n\nexport const getContrastTextColor = (hexColor: string): string => {\n  const { r, g, b } = hexToRgb(hexColor);\n  return getLuminance(r, g, b) > 0.5 ? \"#000000\" : \"#ffffff\";\n};\n\n/**\n * Normalized RGB color with values between 0 and 1.\n * Useful for graphics libraries like Three.js.\n */\nexport interface NormalizedRgb {\n  r: number;\n  g: number;\n  b: number;\n}\n\n/**\n * Convert a hex color string to normalized RGB values (0-1 range).\n * @param hex - Hex color string (with or without # prefix)\n * @returns Normalized RGB object with values between 0 and 1\n */\nexport const hexToNormalizedRgb = (hex: string): NormalizedRgb => {\n  const result = /^#?([a-f\\d]{2})([a-f\\d]{2})([a-f\\d]{2})$/i.exec(hex);\n  return result\n    ? {\n        r: parseInt(result[1], 16) / 255,\n        g: parseInt(result[2], 16) / 255,\n        b: parseInt(result[3], 16) / 255,\n      }\n    : { r: 0, g: 0, b: 0 };\n};\n\n/**\n * Determine if a color is light or dark based on relative luminance.\n * Useful for choosing contrasting text colors.\n * @param hex - Hex color string\n * @returns True if the color is considered light (luminance > 0.5)\n */\nexport const isLightColor = (hex: string): boolean => {\n  const rgb = hexToNormalizedRgb(hex);\n  // Calculate relative luminance using standard coefficients\n  const luminance = 0.299 * rgb.r + 0.587 * rgb.g + 0.114 * rgb.b;\n  return luminance > 0.5;\n};\n\nconst PERCENT_COLORS = [\n  { pct: 0.0, color: { r: 0xff, g: 0x00, b: 0 } },\n  { pct: 0.5, color: { r: 0xff, g: 0xff, b: 0 } },\n  { pct: 1.0, color: { r: 0x00, g: 0xff, b: 0 } },\n] as const;\n\n// https://stackoverflow.com/a/7128796/704681\nexport const getColorForPercentage = (percent: number): string => {\n  if (percent < 0 || percent > 1) {\n    throw new Error(`Percentage must be between 0 and 1: ${percent}`);\n  }\n\n  let i = 0;\n  for (i = 1; i < PERCENT_COLORS.length - 1; i++) {\n    if (percent < PERCENT_COLORS[i].pct) {\n      break;\n    }\n  }\n\n  const lower = PERCENT_COLORS[i - 1];\n  const upper = PERCENT_COLORS[i];\n  const range = upper.pct - lower.pct;\n  const rangePct = (percent - lower.pct) / range;\n  const pctLower = 1 - rangePct;\n  const pctUpper = rangePct;\n  const color = {\n    r: Math.floor(lower.color.r * pctLower + upper.color.r * pctUpper),\n    g: Math.floor(lower.color.g * pctLower + upper.color.g * pctUpper),\n    b: Math.floor(lower.color.b * pctLower + upper.color.b * pctUpper),\n  };\n\n  return \"rgb(\" + [color.r, color.g, color.b].join(\",\") + \")\";\n};\n","import { format } from \"date-fns\";\nimport { isNullish } from \"./types.utils\";\n\nexport type DateInput = Date | string | number | null;\n\nexport const dateAs_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"HH:mm:ss\");\n};\n\nexport const dateAs_YYYYMMDD = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd\");\n};\n\nexport const dateAs_YYYYMMDD_HHMMSS = (value?: DateInput) => {\n  if (isNullish(value)) return \"\";\n  return format(value, \"yyyy-MM-dd HH:mm:ss\");\n};\n\nexport const nowAsTime = () => dateAs_HHMMSS(new Date());\nexport const nowAsDate = () => dateAs_YYYYMMDD(new Date());\nexport const nowAsDateTime = () => dateAs_YYYYMMDD_HHMMSS(new Date());\n\nexport const nowAsDateTimeForFilename = () => {\n  return format(new Date(), \"yyyy-MM-dd_HH-mm-ss\");\n};\n\nconst DEFAULT_DATE_FORMAT = \"yyyy-MM-dd HH:mm:ss\";\n\n/**\n * Format a Unix timestamp (seconds since epoch) to a human-readable string.\n * @param timestamp - Unix timestamp in seconds\n * @param dateFormat - Date format string (default: \"yyyy-MM-dd HH:mm:ss\")\n * @returns Formatted date string or \"N/A\" if invalid or zero.\n */\nexport const formatUnixTimestamp = (\n  timestamp: number,\n  dateFormat: string = DEFAULT_DATE_FORMAT\n): string => {\n  if (!timestamp) return \"N/A\";\n  try {\n    return format(new Date(timestamp * 1000), dateFormat);\n  } catch {\n    return \"Invalid date\";\n  }\n};\n\n/**\n * Get the current Unix timestamp in seconds.\n * @returns Current Unix timestamp\n */\nexport const getCurrentUnixTimestamp = (): number => {\n  return Math.floor(Date.now() / 1000);\n};\n\n/**\n * Check if a Unix timestamp has expired (is in the past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is in the past\n */\nexport const isExpiredTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp < now;\n};\n\n/**\n * Check if a Unix timestamp is active (current or past).\n * @param timestamp - Unix timestamp in seconds\n * @returns True if the timestamp is current or in the past\n */\nexport const isActiveTimestamp = (timestamp: number): boolean => {\n  const now = getCurrentUnixTimestamp();\n  return timestamp <= now;\n};\n","export const NO_OP: () => void = () => {};\n\nexport const isNullish = (value: unknown): value is null | undefined => value === null || value === undefined;\n\nexport const isNumber = (value?: unknown | null): value is number => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'number') {\n    return false;\n  }\n\n  if (isNaN(value)) {\n    return false;\n  }\n\n  return true;\n};\n\nexport const isString = (value?: unknown | null): value is string => {\n  if (isNullish(value)) {\n    return false;\n  }\n\n  if (typeof value !== 'string') {\n    return false;\n  }\n\n  return true;\n};\n","export const getErrorMessage = (error: unknown): string => {\n  if (!error) {\n    return \"\";\n  }\n\n  if (typeof error === \"string\") {\n    return error;\n  }\n\n  if (typeof error === \"object\" && \"message\" in error) {\n    return (error as { message: string }).message;\n  }\n\n  return JSON.stringify(error);\n};\n","import { isNullish } from './types.utils';\n\nexport const isHttpSuccessStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 200 && status < 300;\n};\n\nexport const isHttpClientErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 400 && status < 500;\n};\n\nexport const isHttpServerErrorStatus = (status?: number | null): boolean => {\n  if (isNullish(status)) {\n    return false;\n  }\n\n  return status >= 500;\n};\n","import { isNullish, isNumber } from \"./types.utils\";\n\n// Example: toFixed(3.14159, 3) // 3.142\nexport const toFixed = (value?: number | null, decimals = 0): number => {\n  if (isNullish(value)) return 0;\n  if (decimals < 0) throw new Error(\"[toFixed] decimals must be >= 0\");\n  if (decimals === 0) return Math.round(value);\n\n  const multiplier = Math.pow(10, decimals);\n  return Math.round(value * multiplier) / multiplier;\n};\n\nexport const roundUpToNearest10 = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n  return Math.ceil(value / 10) * 10;\n};\n\nexport const getOrderOfMagnitudeExponent = (n?: number | null): number => {\n  if (isNullish(n)) return 0;\n  if (!isNumber(n)) return 0;\n\n  const absValue = Math.abs(n);  \n  if (absValue === 0) {\n    return 0;\n  }\n  \n  const integerPart = Math.floor(absValue);\n  return Math.floor(Math.log10(integerPart));\n}\n","export const REGEX_ALPHANUMERIC = /^[a-zA-Z0-9-_ $%#(){}:/.]+$/;\n\nexport const REGEX_IPV4 = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)$/;\n","import { REGEX_ALPHANUMERIC } from './regex';\nimport { isNullish } from './types.utils';\n\nexport const isBlank = (str?: string | null): str is null | undefined | '' => {\n  return isNullish(str) || str?.trim() === '';\n};\n\nexport const isNotBlank = (str?: string | null): str is string => {\n  return !isBlank(str);\n};\n\nexport const isAlphanumeric = (value: string): boolean => {\n  return REGEX_ALPHANUMERIC.test(value);\n};\n\n/**\n * Removes diacritical marks (e.g., accents, umlauts) from a string.\n * This method normalizes the input string to its canonical decomposition\n * form (NFD) and removes any combining diacritical marks.\n *\n * @param {string} value - The input string to normalize.\n * @returns {string} - The normalized string with diacritical marks removed.\n *\n * @example\n * const result = removeDiacriticalMarks(\"Ça va très bien, n'est-ce pas?\");\n * console.log(result); // \"Ca va tres bien, n'est-ce pas?\"\n */\nexport const removeDiacriticalMarks = (value: string): string => {\n  if (!value) {\n    return '';\n  }\n\n  return value.normalize('NFD').replace(/[\\u0300-\\u036f]/g, '');\n};\n\n/**\n * Capitalize the first letter of a string.\n * @param str - The input string\n * @returns The string with the first character uppercased\n */\nexport const capitalizeFirst = (str: string): string => {\n  if (!str) return str;\n  return str.charAt(0).toUpperCase() + str.slice(1);\n};\n\n/**\n * Count the number of words in a text string.\n * Words are separated by whitespace.\n * @param text - The text to count words in\n * @returns The number of words found\n */\nexport const countWords = (text: string): number => {\n  if (!text || text.trim().length === 0) return 0;\n  return text.split(/\\s+/).filter((word) => word.length > 0).length;\n};\n\n/**\n * Truncate a string to a maximum length, adding an ellipsis if truncated.\n * @param str - The string to truncate\n * @param maxLength - Maximum length before truncation\n * @param ellipsis - The ellipsis string to append (default: \"...\")\n * @returns The truncated string\n */\nexport const truncate = (str: string, maxLength: number, ellipsis = \"...\"): string => {\n  if (!str || str.length <= maxLength) return str;\n  return str.slice(0, maxLength - ellipsis.length) + ellipsis;\n};\n","export const sleep = (milliseconds: number) =>\n  new Promise((resolve) => setTimeout(resolve, milliseconds));\n","const ONE_SECOND_IN_MS = 1000;\nconst ONE_MINUTE_IN_MS = 60 * ONE_SECOND_IN_MS;\nconst ONE_HOUR_IN_MS = 60 * ONE_MINUTE_IN_MS;\nconst ONE_DAY_IN_MS = 24 * ONE_HOUR_IN_MS;\n\nexport const PeriodsInMS = {\n  oneSecond: ONE_SECOND_IN_MS,\n  oneMinute: ONE_MINUTE_IN_MS,\n  oneHour: ONE_HOUR_IN_MS,\n  oneDay: ONE_DAY_IN_MS,\n} as const;\n","import { isNullish } from \"./types.utils\";\n\n/** m³/s to gallons per minute */\nexport const M3PS_TO_GPM = 15850.3;\n\n/** Pascals to feet of head (1 Pa = 1 N/m²) */\nexport const PA_TO_FT = 0.000334553;\n\n/** Watts to Horsepower */\nexport const W_TO_HP = 0.00134102;\n\n/** meters to inches */\nexport const M_TO_INCHES = 39.3701;\n\n/** Hz to RPM (for synchronous speed) */\nexport const HZ_TO_RPM = 60;\n\nexport const fromM3psToGPM = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M3PS_TO_GPM;\n};\n\nexport const fromPaToFt = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * PA_TO_FT;\n};\n\nexport const fromWToHp = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * W_TO_HP;\n};\n\nexport const fromMToInches = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * M_TO_INCHES;\n};\n\nexport const fromHzToRpm = (value?: number | null): number => {\n  if (isNullish(value)) return 0;\n\n  return value * HZ_TO_RPM;\n};\n","export const SCHEME_PREFIXES = {\n  file: 'file',\n  content: 'content',\n  http: 'http',\n  https: 'https',\n  ftp: 'ftp',\n  ftps: 'ftps',\n  sftp: 'sftp',\n  smb: 'smb',\n} as const;\n\nconst SCHEME_PREFIXES_ARRAY = Object.values(SCHEME_PREFIXES);\n\nexport const hasScheme = (uri?: string | null): boolean => {\n  if (!uri) {\n    return false;\n  }\n\n  const lowerUri = uri.toLowerCase();\n  return SCHEME_PREFIXES_ARRAY.some((prefix) => lowerUri.startsWith(`${prefix}://`));\n};\n","import { isNullish } from \"./types.utils\";\n\nconst WEBSOCKET_CONNECT_STATES: number[] = [WebSocket.CONNECTING, WebSocket.OPEN] as const;\n\nexport const isWsClosable = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const isWsOpenOrConnecting = (ws?: WebSocket | null): ws is WebSocket => {\n  if (isNullish(ws)) return false;\n  return WEBSOCKET_CONNECT_STATES.includes(ws.readyState);\n};\n\nexport const closeWebSocket = (ws?: WebSocket | null) => {\n  if (isNullish(ws) || !isWsClosable(ws)) return;\n\n  try {\n    ws.close();\n  } catch {\n    // do nothing (best effort to close, ignore unexpected errors)\n  }\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,172 @@
+interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
+}
+interface RgbaColor extends RgbColor {
+    a: number;
+}
+declare const rgbToHex: (r: number, g: number, b: number) => string;
+declare const hexToRgb: (hex: string) => RgbColor;
+declare const rgbaToHex: (color: RgbaColor) => string;
+declare const getOpacityHexValue: (opacity: number) => string;
+declare const rgbaToHexWithAlpha: (color: RgbaColor) => string;
+declare const rgbToString: (color: RgbColor) => string;
+declare const rgbaToString: (color: RgbaColor) => string;
+declare const getLuminance: (r: number, g: number, b: number) => number;
+declare const getContrastTextColor: (hexColor: string) => string;
+/**
+ * Normalized RGB color with values between 0 and 1.
+ * Useful for graphics libraries like Three.js.
+ */
+interface NormalizedRgb {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * Convert a hex color string to normalized RGB values (0-1 range).
+ * @param hex - Hex color string (with or without # prefix)
+ * @returns Normalized RGB object with values between 0 and 1
+ */
+declare const hexToNormalizedRgb: (hex: string) => NormalizedRgb;
+/**
+ * Determine if a color is light or dark based on relative luminance.
+ * Useful for choosing contrasting text colors.
+ * @param hex - Hex color string
+ * @returns True if the color is considered light (luminance > 0.5)
+ */
+declare const isLightColor: (hex: string) => boolean;
+declare const getColorForPercentage: (percent: number) => string;
+
+type DateInput = Date | string | number | null;
+declare const dateAs_HHMMSS: (value?: DateInput) => string;
+declare const dateAs_YYYYMMDD: (value?: DateInput) => string;
+declare const dateAs_YYYYMMDD_HHMMSS: (value?: DateInput) => string;
+declare const nowAsTime: () => string;
+declare const nowAsDate: () => string;
+declare const nowAsDateTime: () => string;
+declare const nowAsDateTimeForFilename: () => string;
+/**
+ * Format a Unix timestamp (seconds since epoch) to a human-readable string.
+ * @param timestamp - Unix timestamp in seconds
+ * @param dateFormat - Date format string (default: "yyyy-MM-dd HH:mm:ss")
+ * @returns Formatted date string or "N/A" if invalid or zero.
+ */
+declare const formatUnixTimestamp: (timestamp: number, dateFormat?: string) => string;
+/**
+ * Get the current Unix timestamp in seconds.
+ * @returns Current Unix timestamp
+ */
+declare const getCurrentUnixTimestamp: () => number;
+/**
+ * Check if a Unix timestamp has expired (is in the past).
+ * @param timestamp - Unix timestamp in seconds
+ * @returns True if the timestamp is in the past
+ */
+declare const isExpiredTimestamp: (timestamp: number) => boolean;
+/**
+ * Check if a Unix timestamp is active (current or past).
+ * @param timestamp - Unix timestamp in seconds
+ * @returns True if the timestamp is current or in the past
+ */
+declare const isActiveTimestamp: (timestamp: number) => boolean;
+
+declare const getErrorMessage: (error: unknown) => string;
+
+declare const isHttpSuccessStatus: (status?: number | null) => boolean;
+declare const isHttpClientErrorStatus: (status?: number | null) => boolean;
+declare const isHttpServerErrorStatus: (status?: number | null) => boolean;
+
+declare const toFixed: (value?: number | null, decimals?: number) => number;
+declare const roundUpToNearest10: (value?: number | null) => number;
+declare const getOrderOfMagnitudeExponent: (n?: number | null) => number;
+
+declare const REGEX_ALPHANUMERIC: RegExp;
+declare const REGEX_IPV4: RegExp;
+
+declare const isBlank: (str?: string | null) => str is null | undefined | "";
+declare const isNotBlank: (str?: string | null) => str is string;
+declare const isAlphanumeric: (value: string) => boolean;
+/**
+ * Removes diacritical marks (e.g., accents, umlauts) from a string.
+ * This method normalizes the input string to its canonical decomposition
+ * form (NFD) and removes any combining diacritical marks.
+ *
+ * @param {string} value - The input string to normalize.
+ * @returns {string} - The normalized string with diacritical marks removed.
+ *
+ * @example
+ * const result = removeDiacriticalMarks("Ça va très bien, n'est-ce pas?");
+ * console.log(result); // "Ca va tres bien, n'est-ce pas?"
+ */
+declare const removeDiacriticalMarks: (value: string) => string;
+/**
+ * Capitalize the first letter of a string.
+ * @param str - The input string
+ * @returns The string with the first character uppercased
+ */
+declare const capitalizeFirst: (str: string) => string;
+/**
+ * Count the number of words in a text string.
+ * Words are separated by whitespace.
+ * @param text - The text to count words in
+ * @returns The number of words found
+ */
+declare const countWords: (text: string) => number;
+/**
+ * Truncate a string to a maximum length, adding an ellipsis if truncated.
+ * @param str - The string to truncate
+ * @param maxLength - Maximum length before truncation
+ * @param ellipsis - The ellipsis string to append (default: "...")
+ * @returns The truncated string
+ */
+declare const truncate: (str: string, maxLength: number, ellipsis?: string) => string;
+
+declare const sleep: (milliseconds: number) => Promise<unknown>;
+
+declare const PeriodsInMS: {
+    readonly oneSecond: 1000;
+    readonly oneMinute: number;
+    readonly oneHour: number;
+    readonly oneDay: number;
+};
+
+declare const NO_OP: () => void;
+declare const isNullish: (value: unknown) => value is null | undefined;
+declare const isNumber: (value?: unknown | null) => value is number;
+declare const isString: (value?: unknown | null) => value is string;
+
+/** m³/s to gallons per minute */
+declare const M3PS_TO_GPM = 15850.3;
+/** Pascals to feet of head (1 Pa = 1 N/m²) */
+declare const PA_TO_FT = 0.000334553;
+/** Watts to Horsepower */
+declare const W_TO_HP = 0.00134102;
+/** meters to inches */
+declare const M_TO_INCHES = 39.3701;
+/** Hz to RPM (for synchronous speed) */
+declare const HZ_TO_RPM = 60;
+declare const fromM3psToGPM: (value?: number | null) => number;
+declare const fromPaToFt: (value?: number | null) => number;
+declare const fromWToHp: (value?: number | null) => number;
+declare const fromMToInches: (value?: number | null) => number;
+declare const fromHzToRpm: (value?: number | null) => number;
+
+declare const SCHEME_PREFIXES: {
+    readonly file: "file";
+    readonly content: "content";
+    readonly http: "http";
+    readonly https: "https";
+    readonly ftp: "ftp";
+    readonly ftps: "ftps";
+    readonly sftp: "sftp";
+    readonly smb: "smb";
+};
+declare const hasScheme: (uri?: string | null) => boolean;
+
+declare const isWsClosable: (ws?: WebSocket | null) => ws is WebSocket;
+declare const isWsOpenOrConnecting: (ws?: WebSocket | null) => ws is WebSocket;
+declare const closeWebSocket: (ws?: WebSocket | null) => void;
+
+export { type DateInput, HZ_TO_RPM, M3PS_TO_GPM, M_TO_INCHES, NO_OP, type NormalizedRgb, PA_TO_FT, PeriodsInMS, REGEX_ALPHANUMERIC, REGEX_IPV4, type RgbColor, type RgbaColor, SCHEME_PREFIXES, W_TO_HP, capitalizeFirst, closeWebSocket, countWords, dateAs_HHMMSS, dateAs_YYYYMMDD, dateAs_YYYYMMDD_HHMMSS, formatUnixTimestamp, fromHzToRpm, fromM3psToGPM, fromMToInches, fromPaToFt, fromWToHp, getColorForPercentage, getContrastTextColor, getCurrentUnixTimestamp, getErrorMessage, getLuminance, getOpacityHexValue, getOrderOfMagnitudeExponent, hasScheme, hexToNormalizedRgb, hexToRgb, isActiveTimestamp, isAlphanumeric, isBlank, isExpiredTimestamp, isHttpClientErrorStatus, isHttpServerErrorStatus, isHttpSuccessStatus, isLightColor, isNotBlank, isNullish, isNumber, isString, isWsClosable, isWsOpenOrConnecting, nowAsDate, nowAsDateTime, nowAsDateTimeForFilename, nowAsTime, removeDiacriticalMarks, rgbToHex, rgbToString, rgbaToHex, rgbaToHexWithAlpha, rgbaToString, roundUpToNearest10, sleep, toFixed, truncate };