myio-js-library 0.1.53 → 0.1.55

package/dist/index.cjs

@@ -592,6 +592,9 @@ __export(index_exports, {
   determineInterval: () => determineInterval,
   exportToCSV: () => exportToCSV,
   exportToCSVAll: () => exportToCSVAll,
+  extractMyIOCredentials: () => extractMyIOCredentials,
+  fetchThingsboardCustomerAttrsFromStorage: () => fetchThingsboardCustomerAttrsFromStorage,
+  fetchThingsboardCustomerServerScopeAttrs: () => fetchThingsboardCustomerServerScopeAttrs,
   findValue: () => findValue,
   fmtPerc: () => fmtPerc,
   fmtPercLegacy: () => fmtPerc2,
@@ -1503,6 +1506,88 @@ function getAuthCacheStats() {
   };
 }
 
+// src/thingsboard/api/fetchThingsboardCustomerServerScopeAttrs.ts
+async function fetchThingsboardCustomerServerScopeAttrs(config) {
+  const { customerId, tbToken, baseUrl = "" } = config;
+  if (!customerId || !tbToken) {
+    throw new Error("customerId and tbToken are required");
+  }
+  const url = `${baseUrl}/api/plugins/telemetry/CUSTOMER/${customerId}/values/attributes/SERVER_SCOPE`;
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Authorization": `Bearer ${tbToken}`
+      }
+    });
+    if (!response.ok) {
+      console.warn(`[ThingsBoard Customer Attrs] HTTP ${response.status} ${response.statusText}`);
+      if (response.status === 404 || response.status === 403) {
+        return {};
+      }
+      throw new Error(`ThingsBoard API error: HTTP ${response.status} ${response.statusText}`);
+    }
+    const payload = await response.json();
+    return processAttributesResponse(payload);
+  } catch (error) {
+    console.error("[ThingsBoard Customer Attrs] Error fetching attributes:", error);
+    if (error instanceof Error) {
+      throw new Error(`Failed to fetch customer attributes: ${error.message}`);
+    }
+    throw new Error("Failed to fetch customer attributes: Unknown error");
+  }
+}
+function processAttributesResponse(payload) {
+  const attributesMap = {};
+  if (!payload) {
+    return attributesMap;
+  }
+  if (Array.isArray(payload)) {
+    for (const item of payload) {
+      if (item && typeof item === "object" && item.key !== void 0) {
+        attributesMap[item.key] = item.value;
+      }
+    }
+    return attributesMap;
+  }
+  if (typeof payload === "object") {
+    for (const key of Object.keys(payload)) {
+      const value = payload[key];
+      if (Array.isArray(value) && value.length > 0) {
+        const firstItem = value[0];
+        attributesMap[key] = firstItem?.value ?? firstItem;
+      } else {
+        attributesMap[key] = value;
+      }
+    }
+    return attributesMap;
+  }
+  console.warn("[ThingsBoard Customer Attrs] Unexpected payload format:", typeof payload);
+  return attributesMap;
+}
+async function fetchThingsboardCustomerAttrsFromStorage(customerId, tbToken, baseUrl) {
+  return fetchThingsboardCustomerServerScopeAttrs({
+    customerId,
+    tbToken,
+    baseUrl
+  });
+}
+function extractMyIOCredentials(attributes) {
+  if (!attributes || typeof attributes !== "object") {
+    return {
+      clientId: "",
+      clientSecret: "",
+      ingestionId: ""
+    };
+  }
+  return {
+    clientId: attributes.client_id || attributes.clientId || "",
+    clientSecret: attributes.client_secret || attributes.clientSecret || "",
+    ingestionId: attributes.ingestionId || attributes.ingestion_id || ""
+  };
+}
+
 // src/utils/deviceType.js
 function normalize(str) {
   if (typeof str !== "string") return "";
@@ -10199,6 +10284,9 @@ async function openDemandModal(params) {
   determineInterval,
   exportToCSV,
   exportToCSVAll,
+  extractMyIOCredentials,
+  fetchThingsboardCustomerAttrsFromStorage,
+  fetchThingsboardCustomerServerScopeAttrs,
   findValue,
   fmtPerc,
   fmtPercLegacy,

package/dist/index.d.cts

@@ -408,6 +408,73 @@ declare function getAuthCacheStats(): {
     cacheKeys: string[];
 };
 
+/**
+ * ThingsBoard Customer Server Scope Attributes Fetcher
+ *
+ * Utility function to fetch customer server scope attributes from ThingsBoard API.
+ * Handles both array and object response formats with proper error handling.
+ */
+/**
+ * Configuration parameters for fetching customer attributes
+ */
+interface ThingsboardCustomerAttrsConfig {
+    customerId: string;
+    tbToken: string;
+    baseUrl?: string;
+}
+/**
+ * Fetch customer server scope attributes from ThingsBoard API
+ *
+ * @param config Configuration object with customerId and tbToken
+ * @returns Promise resolving to attributes map
+ *
+ * @example
+ * ```typescript
+ * const attrs = await fetchThingsboardCustomerServerScopeAttrs({
+ *   customerId: 'customer-uuid',
+ *   tbToken: 'jwt-token-from-localStorage'
+ * });
+ *
+ * console.log(attrs.client_id, attrs.client_secret, attrs.ingestionId);
+ * ```
+ */
+declare function fetchThingsboardCustomerServerScopeAttrs(config: ThingsboardCustomerAttrsConfig): Promise<Record<string, any>>;
+/**
+ * Fetch customer attributes with token parameter
+ * Convenience function for ThingsBoard widget contexts
+ *
+ * @param customerId Customer UUID
+ * @param tbToken JWT token for authentication
+ * @param baseUrl Optional base URL for ThingsBoard API
+ * @returns Promise resolving to attributes map
+ *
+ * @example
+ * ```typescript
+ * const tbToken = localStorage.getItem('jwt_token');
+ * const attrs = await fetchThingsboardCustomerAttrsFromStorage('customer-uuid', tbToken);
+ * ```
+ */
+declare function fetchThingsboardCustomerAttrsFromStorage(customerId: string, tbToken: string, baseUrl?: string): Promise<Record<string, any>>;
+/**
+ * Extract common credentials from attributes map
+ * Helper function to get standard MyIO credentials
+ *
+ * @param attributes Attributes map from fetchThingsboardCustomerServerScopeAttrs
+ * @returns Extracted credentials with fallbacks
+ *
+ * @example
+ * ```typescript
+ * const attrs = await fetchThingsboardCustomerServerScopeAttrs(config);
+ * const creds = extractMyIOCredentials(attrs);
+ * console.log(creds.clientId, creds.clientSecret, creds.ingestionId);
+ * ```
+ */
+declare function extractMyIOCredentials(attributes: Record<string, any> | null | undefined): {
+    clientId: string;
+    clientSecret: string;
+    ingestionId: string;
+};
+
 /**
  * Detects the device type based on the given name and context.
  * Uses the specified detection context to identify device types.
@@ -1187,4 +1254,4 @@ interface DemandModalInstance {
  */
 declare function openDemandModal(params: DemandModalParams): Promise<DemandModalInstance>;
 
-export { type CreateDateRangePickerOptions, type CreateInputDateRangePickerInsideDIVParams, type DateRangeControl, type DateRangeInputController, type DateRangeResult, type DemandModalInstance, type DemandModalParams, type DemandModalPdfConfig, type DemandModalStyles, type MyIOAuthConfig, type MyIOAuthInstance, MyIOChartModal, MyIODraggableCard, MyIOSelectionStore, MyIOSelectionStoreClass, type OpenDashboardPopupSettingsParams, type PersistResult, type SettingsError, type SettingsEvent, type StoreRow, type TbScope, type TelemetryFetcher, type TimedValue, type WaterRow, addDetectionContext, addNamespace, averageByDay, buildListItemsThingsboardByUniqueDatasource, buildMyioIngestionAuth, buildWaterReportCSV, buildWaterStoresCSV, calcDeltaPercent, classify, classifyWaterLabel, classifyWaterLabels, clearAllAuthCaches, createDateRangePicker, createInputDateRangePickerInsideDIV, decodePayload, decodePayloadBase64Xor, detectDeviceType, determineInterval, exportToCSV, exportToCSVAll, findValue, fmtPerc$1 as fmtPerc, fmtPerc as fmtPercLegacy, formatAllInSameUnit, formatAllInSameWaterUnit, formatDateForInput, formatDateToYMD, formatDateWithTimezoneOffset, formatEnergy, formatNumberReadable, formatTankHeadFromCm, formatWaterByGroup, formatWaterVolumeM3, getAuthCacheStats, getAvailableContexts, getDateRangeArray, getSaoPauloISOString, getSaoPauloISOStringFixed, getValueByDatakey, getValueByDatakeyLegacy, getWaterCategories, groupByDay, isWaterCategory, normalizeRecipients, numbers, openDashboardPopup, openDashboardPopupAllReport, openDashboardPopupEnergy, openDashboardPopupReport, openDashboardPopupSettings, openDemandModal, parseInputDateToDate, renderCardCompenteHeadOffice, renderCardComponent$1 as renderCardComponent, renderCardComponent as renderCardComponentEnhanced, renderCardComponentLegacy, renderCardComponentV2, strings, timeWindowFromInputYMD, toCSV, toFixedSafe };
+export { type CreateDateRangePickerOptions, type CreateInputDateRangePickerInsideDIVParams, type DateRangeControl, type DateRangeInputController, type DateRangeResult, type DemandModalInstance, type DemandModalParams, type DemandModalPdfConfig, type DemandModalStyles, type MyIOAuthConfig, type MyIOAuthInstance, MyIOChartModal, MyIODraggableCard, MyIOSelectionStore, MyIOSelectionStoreClass, type OpenDashboardPopupSettingsParams, type PersistResult, type SettingsError, type SettingsEvent, type StoreRow, type TbScope, type TelemetryFetcher, type ThingsboardCustomerAttrsConfig, type TimedValue, type WaterRow, addDetectionContext, addNamespace, averageByDay, buildListItemsThingsboardByUniqueDatasource, buildMyioIngestionAuth, buildWaterReportCSV, buildWaterStoresCSV, calcDeltaPercent, classify, classifyWaterLabel, classifyWaterLabels, clearAllAuthCaches, createDateRangePicker, createInputDateRangePickerInsideDIV, decodePayload, decodePayloadBase64Xor, detectDeviceType, determineInterval, exportToCSV, exportToCSVAll, extractMyIOCredentials, fetchThingsboardCustomerAttrsFromStorage, fetchThingsboardCustomerServerScopeAttrs, findValue, fmtPerc$1 as fmtPerc, fmtPerc as fmtPercLegacy, formatAllInSameUnit, formatAllInSameWaterUnit, formatDateForInput, formatDateToYMD, formatDateWithTimezoneOffset, formatEnergy, formatNumberReadable, formatTankHeadFromCm, formatWaterByGroup, formatWaterVolumeM3, getAuthCacheStats, getAvailableContexts, getDateRangeArray, getSaoPauloISOString, getSaoPauloISOStringFixed, getValueByDatakey, getValueByDatakeyLegacy, getWaterCategories, groupByDay, isWaterCategory, normalizeRecipients, numbers, openDashboardPopup, openDashboardPopupAllReport, openDashboardPopupEnergy, openDashboardPopupReport, openDashboardPopupSettings, openDemandModal, parseInputDateToDate, renderCardCompenteHeadOffice, renderCardComponent$1 as renderCardComponent, renderCardComponent as renderCardComponentEnhanced, renderCardComponentLegacy, renderCardComponentV2, strings, timeWindowFromInputYMD, toCSV, toFixedSafe };

package/dist/index.js

@@ -1432,6 +1432,88 @@ function getAuthCacheStats() {
   };
 }
 
+// src/thingsboard/api/fetchThingsboardCustomerServerScopeAttrs.ts
+async function fetchThingsboardCustomerServerScopeAttrs(config) {
+  const { customerId, tbToken, baseUrl = "" } = config;
+  if (!customerId || !tbToken) {
+    throw new Error("customerId and tbToken are required");
+  }
+  const url = `${baseUrl}/api/plugins/telemetry/CUSTOMER/${customerId}/values/attributes/SERVER_SCOPE`;
+  try {
+    const response = await fetch(url, {
+      method: "GET",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Authorization": `Bearer ${tbToken}`
+      }
+    });
+    if (!response.ok) {
+      console.warn(`[ThingsBoard Customer Attrs] HTTP ${response.status} ${response.statusText}`);
+      if (response.status === 404 || response.status === 403) {
+        return {};
+      }
+      throw new Error(`ThingsBoard API error: HTTP ${response.status} ${response.statusText}`);
+    }
+    const payload = await response.json();
+    return processAttributesResponse(payload);
+  } catch (error) {
+    console.error("[ThingsBoard Customer Attrs] Error fetching attributes:", error);
+    if (error instanceof Error) {
+      throw new Error(`Failed to fetch customer attributes: ${error.message}`);
+    }
+    throw new Error("Failed to fetch customer attributes: Unknown error");
+  }
+}
+function processAttributesResponse(payload) {
+  const attributesMap = {};
+  if (!payload) {
+    return attributesMap;
+  }
+  if (Array.isArray(payload)) {
+    for (const item of payload) {
+      if (item && typeof item === "object" && item.key !== void 0) {
+        attributesMap[item.key] = item.value;
+      }
+    }
+    return attributesMap;
+  }
+  if (typeof payload === "object") {
+    for (const key of Object.keys(payload)) {
+      const value = payload[key];
+      if (Array.isArray(value) && value.length > 0) {
+        const firstItem = value[0];
+        attributesMap[key] = firstItem?.value ?? firstItem;
+      } else {
+        attributesMap[key] = value;
+      }
+    }
+    return attributesMap;
+  }
+  console.warn("[ThingsBoard Customer Attrs] Unexpected payload format:", typeof payload);
+  return attributesMap;
+}
+async function fetchThingsboardCustomerAttrsFromStorage(customerId, tbToken, baseUrl) {
+  return fetchThingsboardCustomerServerScopeAttrs({
+    customerId,
+    tbToken,
+    baseUrl
+  });
+}
+function extractMyIOCredentials(attributes) {
+  if (!attributes || typeof attributes !== "object") {
+    return {
+      clientId: "",
+      clientSecret: "",
+      ingestionId: ""
+    };
+  }
+  return {
+    clientId: attributes.client_id || attributes.clientId || "",
+    clientSecret: attributes.client_secret || attributes.clientSecret || "",
+    ingestionId: attributes.ingestionId || attributes.ingestion_id || ""
+  };
+}
+
 // src/utils/deviceType.js
 function normalize(str) {
   if (typeof str !== "string") return "";
@@ -10127,6 +10209,9 @@ export {
   determineInterval,
   exportToCSV,
   exportToCSVAll,
+  extractMyIOCredentials,
+  fetchThingsboardCustomerAttrsFromStorage,
+  fetchThingsboardCustomerServerScopeAttrs,
   findValue,
   fmtPerc,
   fmtPerc2 as fmtPercLegacy,

package/dist/myio-js-library.umd.js

@@ -1438,6 +1438,88 @@
     };
   }
 
+  // src/thingsboard/api/fetchThingsboardCustomerServerScopeAttrs.ts
+  async function fetchThingsboardCustomerServerScopeAttrs(config) {
+    const { customerId, tbToken, baseUrl = "" } = config;
+    if (!customerId || !tbToken) {
+      throw new Error("customerId and tbToken are required");
+    }
+    const url = `${baseUrl}/api/plugins/telemetry/CUSTOMER/${customerId}/values/attributes/SERVER_SCOPE`;
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Authorization": `Bearer ${tbToken}`
+        }
+      });
+      if (!response.ok) {
+        console.warn(`[ThingsBoard Customer Attrs] HTTP ${response.status} ${response.statusText}`);
+        if (response.status === 404 || response.status === 403) {
+          return {};
+        }
+        throw new Error(`ThingsBoard API error: HTTP ${response.status} ${response.statusText}`);
+      }
+      const payload = await response.json();
+      return processAttributesResponse(payload);
+    } catch (error) {
+      console.error("[ThingsBoard Customer Attrs] Error fetching attributes:", error);
+      if (error instanceof Error) {
+        throw new Error(`Failed to fetch customer attributes: ${error.message}`);
+      }
+      throw new Error("Failed to fetch customer attributes: Unknown error");
+    }
+  }
+  function processAttributesResponse(payload) {
+    const attributesMap = {};
+    if (!payload) {
+      return attributesMap;
+    }
+    if (Array.isArray(payload)) {
+      for (const item of payload) {
+        if (item && typeof item === "object" && item.key !== void 0) {
+          attributesMap[item.key] = item.value;
+        }
+      }
+      return attributesMap;
+    }
+    if (typeof payload === "object") {
+      for (const key of Object.keys(payload)) {
+        const value = payload[key];
+        if (Array.isArray(value) && value.length > 0) {
+          const firstItem = value[0];
+          attributesMap[key] = firstItem?.value ?? firstItem;
+        } else {
+          attributesMap[key] = value;
+        }
+      }
+      return attributesMap;
+    }
+    console.warn("[ThingsBoard Customer Attrs] Unexpected payload format:", typeof payload);
+    return attributesMap;
+  }
+  async function fetchThingsboardCustomerAttrsFromStorage(customerId, tbToken, baseUrl) {
+    return fetchThingsboardCustomerServerScopeAttrs({
+      customerId,
+      tbToken,
+      baseUrl
+    });
+  }
+  function extractMyIOCredentials(attributes) {
+    if (!attributes || typeof attributes !== "object") {
+      return {
+        clientId: "",
+        clientSecret: "",
+        ingestionId: ""
+      };
+    }
+    return {
+      clientId: attributes.client_id || attributes.clientId || "",
+      clientSecret: attributes.client_secret || attributes.clientSecret || "",
+      ingestionId: attributes.ingestionId || attributes.ingestion_id || ""
+    };
+  }
+
   // src/utils/deviceType.js
   function normalize(str) {
     if (typeof str !== "string") return "";
@@ -10116,6 +10198,9 @@
   exports.determineInterval = determineInterval;
   exports.exportToCSV = exportToCSV;
   exports.exportToCSVAll = exportToCSVAll;
+  exports.extractMyIOCredentials = extractMyIOCredentials;
+  exports.fetchThingsboardCustomerAttrsFromStorage = fetchThingsboardCustomerAttrsFromStorage;
+  exports.fetchThingsboardCustomerServerScopeAttrs = fetchThingsboardCustomerServerScopeAttrs;
   exports.findValue = findValue;
   exports.fmtPerc = fmtPerc;
   exports.fmtPercLegacy = fmtPerc2;