myio-js-library 0.1.6 → 0.1.8

package/dist/index.cjs

@@ -34,7 +34,6 @@ __export(index_exports, {
   determineInterval: () => determineInterval,
   exportToCSV: () => exportToCSV,
   exportToCSVAll: () => exportToCSVAll,
-  fetchWithRetry: () => fetchWithRetry,
   findValue: () => findValue,
   fmtPerc: () => fmtPerc,
   fmtPercLegacy: () => fmtPerc2,
@@ -50,18 +49,17 @@ __export(index_exports, {
   formatWaterVolumeM3: () => formatWaterVolumeM3,
   getAvailableContexts: () => getAvailableContexts,
   getDateRangeArray: () => getDateRangeArray,
-  getEntityInfoAndAttributesTB: () => getEntityInfoAndAttributesTB,
   getSaoPauloISOString: () => getSaoPauloISOString,
   getSaoPauloISOStringFixed: () => getSaoPauloISOStringFixed,
   getValueByDatakey: () => getValueByDatakey,
   getValueByDatakeyLegacy: () => getValueByDatakeyLegacy,
   getWaterCategories: () => getWaterCategories,
   groupByDay: () => groupByDay,
-  http: () => http,
   isWaterCategory: () => isWaterCategory,
   normalizeRecipients: () => normalizeRecipients,
   numbers: () => numbers_exports,
   parseInputDateToDate: () => parseInputDateToDate,
+  renderCardComponent: () => renderCardComponent,
   strings: () => strings_exports,
   timeWindowFromInputYMD: () => timeWindowFromInputYMD,
   toCSV: () => toCSV,
@@ -93,14 +91,26 @@ function formatEnergy(value, unit) {
   });
   return `${formattedValue} ${adjustedUnit}`;
 }
-function formatAllInSameUnit(values, targetUnit) {
+function formatAllInSameUnit(values, targetUnit, sourceUnit = "kWh") {
   const unitMultipliers = {
     "kWh": 1,
     "MWh": 1e3,
     "GWh": 1e6
   };
   const targetMultiplier = unitMultipliers[targetUnit] || 1;
-  return values.map((item) => {
+  if (typeof values[0] === "number") {
+    const numberValues = values;
+    const sourceMultiplier = unitMultipliers[sourceUnit] || 1;
+    return numberValues.map((value) => {
+      if (value === null || value === void 0 || isNaN(value)) {
+        return "-";
+      }
+      const convertedValue = value * sourceMultiplier / targetMultiplier;
+      return formatEnergy(convertedValue, targetUnit);
+    });
+  }
+  const objectValues = values;
+  return objectValues.map((item) => {
     if (item.value === null || item.value === void 0 || isNaN(item.value)) {
       return "-";
     }
@@ -725,69 +735,6 @@ function findValue(data, keyOrPath, legacyDataKey) {
   return getValueByDatakey(data, keyOrPath);
 }
 
-// src/thingsboard/entity.ts
-async function getEntityInfoAndAttributesTB(deviceId, opts) {
-  if (!deviceId) throw new Error("getEntityInfoAndAttributesTB: deviceId is required");
-  const {
-    jwt,
-    baseUrl = "",
-    scope = "SERVER_SCOPE",
-    attributeKeys = [
-      "floor",
-      "NumLoja",
-      "IDMedidor",
-      "deviceId",
-      "guid",
-      "maxDailyConsumption",
-      "maxNightConsumption"
-    ],
-    fetcher = globalThis.fetch?.bind(globalThis)
-  } = opts || {};
-  if (!jwt) throw new Error("getEntityInfoAndAttributesTB: opts.jwt (Bearer token) is required");
-  if (!fetcher) throw new Error("getEntityInfoAndAttributesTB: no fetch implementation available");
-  const headers = {
-    "Content-Type": "application/json",
-    "X-Authorization": `Bearer ${jwt}`
-  };
-  const base = baseUrl.endsWith("/") ? baseUrl.slice(0, -1) : baseUrl;
-  const deviceRes = await fetcher(`${base}/api/device/${encodeURIComponent(deviceId)}`, { headers });
-  if (!deviceRes.ok) {
-    throw new Error(`Failed to fetch device: HTTP ${deviceRes.status} ${deviceRes.statusText}`);
-  }
-  const device = await deviceRes.json();
-  const label = device?.label || device?.name || "Sem etiqueta";
-  const attrUrl = `${base}/api/plugins/telemetry/DEVICE/${encodeURIComponent(deviceId)}/values/attributes?scope=${encodeURIComponent(scope)}`;
-  const attrRes = await fetcher(attrUrl, { headers });
-  if (!attrRes.ok) {
-    throw new Error(`Failed to fetch attributes: HTTP ${attrRes.status} ${attrRes.statusText}`);
-  }
-  const attributes = await attrRes.json();
-  const map = /* @__PURE__ */ new Map();
-  for (const a of attributes) map.set(a.key, a.value);
-  const getStr = (k) => {
-    const v = map.get(k);
-    if (v == null) return "";
-    return typeof v === "string" ? v : String(v);
-  };
-  const getNum = (k) => {
-    const v = map.get(k);
-    if (v == null) return 0;
-    const n = typeof v === "string" ? Number(v.replace(",", ".")) : Number(v);
-    return Number.isFinite(n) ? n : 0;
-  };
-  void attributeKeys;
-  return {
-    label,
-    andar: getStr("floor") || "",
-    numeroLoja: getStr("NumLoja") || "",
-    identificadorMedidor: getStr("IDMedidor") || "",
-    identificadorDispositivo: getStr("deviceId") || "",
-    guid: getStr("guid") || "",
-    consumoDiario: getNum("maxDailyConsumption"),
-    consumoMadrugada: getNum("maxNightConsumption")
-  };
-}
-
 // src/utils/deviceType.js
 var contexts = {
   building: (name) => {
@@ -936,76 +883,164 @@ function base64ToBytesStrict(b64) {
   return out;
 }
 
-// src/net/http.js
-async function fetchWithRetry(url, options = {}) {
+// src/thingsboard/main-dashboard-shopping/v-4.0.0/card/template-card.js
+function renderCardComponent({
+  entityObject,
+  handleActionDashboard,
+  handleActionReport,
+  handleActionSettings,
+  handleSelect
+}) {
   const {
-    retries = 0,
-    retryDelay = 100,
-    timeout = 1e4,
-    retryCondition,
-    ...passThrough
-  } = options;
-  const baseInit = { ...passThrough, timeout };
-  let attempt = 0;
-  while (true) {
-    try {
-      const res = await withTimeout(fetch(url, baseInit), timeout);
-      if (!res.ok) {
-        const doRetry = typeof retryCondition === "function" && retryCondition(null, res) || res.status >= 500;
-        if (doRetry && attempt < retries) {
-          await delay(expBackoff(retryDelay, attempt));
-          attempt++;
-          continue;
-        }
-        const msg = `HTTP ${res.status}: ${res.statusText || ""}`.trim();
-        throw new Error(msg);
-      }
-      return res;
-    } catch (err) {
-      if (err && err.message === "Request timeout") {
-        if (attempt < retries) {
-          await delay(expBackoff(retryDelay, attempt));
-          attempt++;
-          continue;
-        }
-        throw err;
-      }
-      const doRetry = typeof retryCondition === "function" && retryCondition(err, void 0) || isRetryableNetworkError(err);
-      if (doRetry && attempt < retries) {
-        await delay(expBackoff(retryDelay, attempt));
-        attempt++;
-        continue;
-      }
-      throw err;
-    }
-  }
+    entityId,
+    labelOrName,
+    entityType,
+    slaveId,
+    ingestionId,
+    val,
+    centralId,
+    updatedIdentifiers = {},
+    img,
+    isOn = false,
+    perc = 0,
+    group,
+    connectionStatus = "online"
+  } = entityObject;
+  const MyIO = typeof MyIOLibrary !== "undefined" && MyIOLibrary || typeof window !== "undefined" && window.MyIOLibrary || {
+    formatEnergyByGroup: (v, g) => `${v} kWh${g ? " \xB7 " + g : ""}`,
+    formatNumberReadable: (n) => Number(n ?? 0).toFixed(1)
+  };
+  const valFormatted = MyIO.formatEnergyByGroup(val, group);
+  const percFormatted = MyIO.formatNumberReadable(perc);
+  if (!document.getElementById("myio-card-styles")) {
+    const style = document.createElement("style");
+    style.id = "myio-card-styles";
+    style.textContent = `
+     .device-card-centered,.clickable{width:98%;border-radius:10px;padding:8px 12px;background:#fff;
+       box-shadow:0 4px 10px rgba(0,0,0,.05);display:flex;align-items:center;justify-content:flex-start;
+       cursor:pointer;transition:transform .2s;position:relative;min-height:140px;box-sizing:border-box;gap:25px;
+       overflow:hidden;margin-bottom:15px}
+     .device-card-centered:hover,.clickable:hover{transform:scale(1.05)}
+     .device-title-row{width:100%;display:flex;justify-content:center;align-items:center;margin-bottom:4px;padding:0 4px;min-height:22px}
+     .device-title{font-weight:700;font-size:.85rem;text-align:center;white-space:nowrap;overflow:hidden;text-overflow:ellipsis;max-width:90%;line-height:1.1}
+     .device-image{max-height:44px;width:auto;margin:4px 0;display:block}
+     .device-data-row{display:flex;justify-content:center;align-items:center;margin-top:auto;margin-bottom:6px;gap:6px;width:100%}
+     .consumption-main{font-size:.9rem;font-weight:700;color:#28a745;display:flex;align-items:center;gap:6px;justify-content:center;white-space:nowrap}
+     .device-title-percent{font-size:.75rem;color:rgba(0,0,0,.45);font-weight:500}
+     .flash{animation:flash 1s infinite;color:#ff9800}
+     @keyframes flash{0%{opacity:1}50%{opacity:.2}100%{opacity:1}}
+     .card-actions{gap:13px;width:36px;padding:5px;height:100%;box-shadow:1px 0 2px rgba(0,0,0,.1);
+       display:flex;flex-direction:column;justify-content:center;align-items:center}
+     .card-action img{width:24px;height:24px;transition:transform .2s ease;cursor:pointer}
+     .card-action img:hover{transform:scale(1.15)}
+.device-card-centered.offline {
+  border: 2px solid #ff4d4f;
+  animation: border-blink 1s infinite;
 }
-var http = fetchWithRetry;
-function withTimeout(promise, ms) {
-  return new Promise((resolve, reject) => {
-    const t = setTimeout(() => reject(new Error("Request timeout")), ms);
-    promise.then(
-      (v) => {
-        clearTimeout(t);
-        resolve(v);
-      },
-      (e) => {
-        clearTimeout(t);
-        reject(e);
-      }
-    );
-  });
+
+@keyframes border-blink {
+  0%, 100% { box-shadow: 0 0 8px rgba(255, 77, 79, 0.9); }
+  50% { box-shadow: 0 0 16px rgba(255, 0, 0, 0.6); }
 }
-function delay(ms) {
-  return new Promise((r) => setTimeout(r, ms));
+
+.device-card-centered.offline .flash-icon {
+  color: #ff4d4f !important;
+  font-size: 1.2rem;
+}     
+
+.flash-icon.flash {
+  animation: icon-blink 1s infinite;
 }
-function expBackoff(base, attempt) {
-  return base * Math.pow(2, attempt);
+
+@keyframes icon-blink {
+  0%, 100% { opacity: 1; transform: scale(1); }
+  50%      { opacity: 0.2; transform: scale(1.2); }
 }
-function isRetryableNetworkError(err) {
-  if (!err) return false;
-  const msg = String(err.message || "").toLowerCase();
-  return msg.includes("network") || err.name === "AbortError";
+
+.device-card-centered.offline .flash-icon {
+  color: #ff4d4f !important;
+}
+
+.device-card-centered.online .flash-icon {
+  color: #28a745 !important; /* verde premium para online */
+}
+    `;
+    document.head.appendChild(style);
+  }
+  const html = `
+    <div class="device-card-centered clickable ${connectionStatus === "offline" ? "offline" : ""}"
+      data-entity-id="${entityId}"
+      data-entity-label="${labelOrName}"
+      data-entity-type="${entityType}"
+      data-entity-slaveid="${slaveId}"
+      data-entity-ingestionid="${ingestionId}"
+      data-entity-consumption="${val}"
+      data-entity-centralid="${centralId}"
+      data-entity-updated-identifiers='${JSON.stringify(updatedIdentifiers)}'>
+
+      <div class="card-actions">
+        <div class="card-action action-dashboard" data-action="dashboard" title="Dashboard">
+          <img src="https://dashboard.myio-bas.com/api/images/public/TAVXE0sTbCZylwGsMF9lIWdllBB3iFtS"/>
+        </div>
+        <div class="card-action action-report" data-action="report" title="Relat\xF3rio">
+          <img src="https://dashboard.myio-bas.com/api/images/public/d9XuQwMYQCG2otvtNSlqUHGavGaSSpz4"/>
+        </div>
+        <div class="card-action action-settings" data-action="settings" title="Configura\xE7\xF5es">
+          <img src="https://dashboard.myio-bas.com/api/images/public/5n9tze6vED2uwIs5VvJxGzNNZ9eV4yoz"/>
+        </div>
+        <input class="card-action action-checker" data-action="checker" title="Selecionar" type="checkbox">
+      </div>
+
+      <div style="display:flex;flex-direction:column;justify-content:center;align-items:center;height:100%;width:85%">
+        <div class="device-title-row">
+          <span class="device-title" title="${labelOrName}">
+            ${String(labelOrName ?? "").length > 15 ? String(labelOrName).slice(0, 15) + "\u2026" : String(labelOrName ?? "")}
+          </span>
+        </div>
+        <img class="device-image ${isOn ? "flash" : ""}" src="${img || ""}" />
+        <div class="device-data-row">
+          <div class="consumption-main">
+  <span class="flash-icon ${connectionStatus === "offline" ? "flash" : isOn ? "flash" : ""}">
+    ${connectionStatus === "offline" ? "\u{1F6A8}" : "\u26A1"}
+  </span>
+            <span class="consumption-value" data-entity-consumption="${val}">${valFormatted}</span>
+            <span class="device-title-percent">(${percFormatted}%)</span>
+          </div>
+        </div>
+      </div>
+    </div>
+  `;
+  const $card = $(html);
+  if (typeof handleActionDashboard === "function") {
+    $card.find(".action-dashboard").on("click", (e) => {
+      e.stopPropagation();
+      handleActionDashboard(entityObject);
+    });
+  }
+  if (typeof handleActionReport === "function") {
+    $card.find(".action-report").on("click", (e) => {
+      e.stopPropagation();
+      handleActionReport(entityObject);
+    });
+  }
+  if (typeof handleActionSettings === "function") {
+    $card.find(".action-settings").on("click", (e) => {
+      e.stopPropagation();
+      handleActionSettings(entityObject);
+    });
+  }
+  if (typeof handleSelect === "function") {
+    $card.on("click", (e) => {
+      if (!$(e.target).closest(".card-action").length) {
+        handleSelect(entityObject);
+      }
+    });
+    $card.find(".action-checker").on("click", (e) => {
+      e.stopPropagation();
+      handleSelect(entityObject);
+    });
+  }
+  return $card;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
@@ -1024,7 +1059,6 @@ function isRetryableNetworkError(err) {
   determineInterval,
   exportToCSV,
   exportToCSVAll,
-  fetchWithRetry,
   findValue,
   fmtPerc,
   fmtPercLegacy,
@@ -1040,18 +1074,17 @@ function isRetryableNetworkError(err) {
   formatWaterVolumeM3,
   getAvailableContexts,
   getDateRangeArray,
-  getEntityInfoAndAttributesTB,
   getSaoPauloISOString,
   getSaoPauloISOStringFixed,
   getValueByDatakey,
   getValueByDatakeyLegacy,
   getWaterCategories,
   groupByDay,
-  http,
   isWaterCategory,
   normalizeRecipients,
   numbers,
   parseInputDateToDate,
+  renderCardComponent,
   strings,
   timeWindowFromInputYMD,
   toCSV,

package/dist/index.d.cts

@@ -7,14 +7,15 @@
 declare function formatEnergy(value: number, unit?: string): string;
 /**
  * Formats all energy values to the same unit for consistent display
- * @param values - Array of energy values with their units
+ * @param values - Array of energy values with their units OR array of numbers (assumes kWh)
  * @param targetUnit - Target unit to convert all values to ('kWh', 'MWh', 'GWh')
+ * @param sourceUnit - Source unit when values is an array of numbers (defaults to 'kWh')
  * @returns Array of formatted energy strings in the target unit
  */
 declare function formatAllInSameUnit(values: Array<{
     value: number;
     unit: string;
-}>, targetUnit: string): string[];
+}> | number[], targetUnit: string, sourceUnit?: string): string[];
 
 /**
  * Formats a percentage value with Brazilian locale formatting
@@ -308,37 +309,6 @@ declare function getValueByDatakeyLegacy(dataList: any[], dataSourceNameTarget:
  */
 declare function findValue(data: any, keyOrPath: string, legacyDataKey?: string): any;
 
-/**
- * ThingsBoard entity and attributes fetching utilities
- */
-interface TBFetchOptions {
-    jwt: string;
-    baseUrl?: string;
-    scope?: 'SERVER_SCOPE' | 'CLIENT_SCOPE' | 'SHARED_SCOPE';
-    attributeKeys?: string[];
-    fetcher?: typeof fetch;
-}
-interface TBEntityInfo {
-    label: string;
-    andar: string;
-    numeroLoja: string;
-    identificadorMedidor: string;
-    identificadorDispositivo: string;
-    guid: string;
-    consumoDiario: number;
-    consumoMadrugada: number;
-}
-/**
- * Fetches ThingsBoard Device info + attributes (default: SERVER_SCOPE).
- * Safe defaults and robust coercion, suitable for direct UI use.
- *
- * @param deviceId - The ThingsBoard device ID
- * @param opts - Configuration options including JWT token and API settings
- * @returns Promise resolving to device info and attributes
- * @throws Error if deviceId is missing, JWT is missing, or HTTP requests fail
- */
-declare function getEntityInfoAndAttributesTB(deviceId: string, opts: TBFetchOptions): Promise<TBEntityInfo>;
-
 /**
  * Detects the device type based on the given name and context.
  * Uses the specified detection context to identify device types.
@@ -406,31 +376,12 @@ declare namespace strings {
 declare function decodePayload(encoded: any, key: any): string;
 declare function decodePayloadBase64Xor(encoded: any, xorKey?: number): string;
 
-/**
- * fetchWithRetry(url, {
- *   retries?: number = 0,
- *   retryDelay?: number = 100,
- *   timeout?: number = 10000,
- *   retryCondition?: (error, response) => boolean,
- *   ...RequestInit (method, headers, body, signal, etc.)
- * })
- *
- * Observação: os testes verificam que o objeto de options passado ao fetch
- * contém a prop `timeout`, então mantemos `{ timeout }` no init.
- */
-declare function fetchWithRetry(url: any, options?: {}): Promise<any>;
-/**
- * fetchWithRetry(url, {
- *   retries?: number = 0,
- *   retryDelay?: number = 100,
- *   timeout?: number = 10000,
- *   retryCondition?: (error, response) => boolean,
- *   ...RequestInit (method, headers, body, signal, etc.)
- * })
- *
- * Observação: os testes verificam que o objeto de options passado ao fetch
- * contém a prop `timeout`, então mantemos `{ timeout }` no init.
- */
-declare function http(url: any, options?: {}): Promise<any>;
+declare function renderCardComponent({ entityObject, handleActionDashboard, handleActionReport, handleActionSettings, handleSelect }: {
+    entityObject: any;
+    handleActionDashboard: any;
+    handleActionReport: any;
+    handleActionSettings: any;
+    handleSelect: any;
+}): any;
 
-export { type StoreRow, type TBEntityInfo, type TBFetchOptions, type TimedValue, type WaterRow, addDetectionContext, addNamespace, averageByDay, buildWaterReportCSV, buildWaterStoresCSV, calcDeltaPercent, classify, classifyWaterLabel, classifyWaterLabels, decodePayload, decodePayloadBase64Xor, detectDeviceType, determineInterval, exportToCSV, exportToCSVAll, fetchWithRetry, findValue, fmtPerc$1 as fmtPerc, fmtPerc as fmtPercLegacy, formatAllInSameUnit, formatAllInSameWaterUnit, formatDateForInput, formatDateToYMD, formatDateWithTimezoneOffset, formatEnergy, formatEnergyByGroup, formatNumberReadable, formatTankHeadFromCm, formatWaterVolumeM3, getAvailableContexts, getDateRangeArray, getEntityInfoAndAttributesTB, getSaoPauloISOString, getSaoPauloISOStringFixed, getValueByDatakey, getValueByDatakeyLegacy, getWaterCategories, groupByDay, http, isWaterCategory, normalizeRecipients, numbers, parseInputDateToDate, strings, timeWindowFromInputYMD, toCSV, toFixedSafe };
+export { type StoreRow, type TimedValue, type WaterRow, addDetectionContext, addNamespace, averageByDay, buildWaterReportCSV, buildWaterStoresCSV, calcDeltaPercent, classify, classifyWaterLabel, classifyWaterLabels, decodePayload, decodePayloadBase64Xor, detectDeviceType, determineInterval, exportToCSV, exportToCSVAll, findValue, fmtPerc$1 as fmtPerc, fmtPerc as fmtPercLegacy, formatAllInSameUnit, formatAllInSameWaterUnit, formatDateForInput, formatDateToYMD, formatDateWithTimezoneOffset, formatEnergy, formatEnergyByGroup, formatNumberReadable, formatTankHeadFromCm, formatWaterVolumeM3, getAvailableContexts, getDateRangeArray, getSaoPauloISOString, getSaoPauloISOStringFixed, getValueByDatakey, getValueByDatakeyLegacy, getWaterCategories, groupByDay, isWaterCategory, normalizeRecipients, numbers, parseInputDateToDate, renderCardComponent, strings, timeWindowFromInputYMD, toCSV, toFixedSafe };