myio-js-library 0.1.52 → 0.1.53

package/dist/index.cjs

@@ -576,12 +576,14 @@ __export(index_exports, {
   addNamespace: () => addNamespace,
   averageByDay: () => averageByDay,
   buildListItemsThingsboardByUniqueDatasource: () => buildListItemsThingsboardByUniqueDatasource,
+  buildMyioIngestionAuth: () => buildMyioIngestionAuth,
   buildWaterReportCSV: () => buildWaterReportCSV,
   buildWaterStoresCSV: () => buildWaterStoresCSV,
   calcDeltaPercent: () => calcDeltaPercent,
   classify: () => classify,
   classifyWaterLabel: () => classifyWaterLabel,
   classifyWaterLabels: () => classifyWaterLabels,
+  clearAllAuthCaches: () => clearAllAuthCaches,
   createDateRangePicker: () => createDateRangePicker2,
   createInputDateRangePickerInsideDIV: () => createInputDateRangePickerInsideDIV,
   decodePayload: () => decodePayload,
@@ -603,6 +605,7 @@ __export(index_exports, {
   formatTankHeadFromCm: () => formatTankHeadFromCm,
   formatWaterByGroup: () => formatWaterByGroup,
   formatWaterVolumeM3: () => formatWaterVolumeM3,
+  getAuthCacheStats: () => getAuthCacheStats,
   getAvailableContexts: () => getAvailableContexts,
   getDateRangeArray: () => getDateRangeArray,
   getSaoPauloISOString: () => getSaoPauloISOString,
@@ -1371,6 +1374,135 @@ function buildListItemsThingsboardByUniqueDatasource(datasources, data) {
   return items;
 }
 
+// src/thingsboard/auth/buildMyioIngestionAuth.ts
+var globalCache = /* @__PURE__ */ new Map();
+function generateCacheKey(config) {
+  return `${config.dataApiHost}:${config.clientId}:${config.clientSecret}`;
+}
+function buildMyioIngestionAuth(config) {
+  const {
+    dataApiHost,
+    clientId,
+    clientSecret,
+    renewSkewSeconds = 60,
+    retryBaseMs = 500,
+    retryMaxAttempts = 3
+  } = config;
+  if (!dataApiHost || !clientId || !clientSecret) {
+    throw new Error("dataApiHost, clientId, and clientSecret are required");
+  }
+  const authUrl = new URL(`${dataApiHost}/api/v1/auth`);
+  const cacheKey = generateCacheKey(config);
+  if (!globalCache.has(cacheKey)) {
+    globalCache.set(cacheKey, {
+      token: null,
+      expiresAt: 0,
+      inFlight: null
+    });
+  }
+  const cache = globalCache.get(cacheKey);
+  function now() {
+    return Date.now();
+  }
+  function aboutToExpire() {
+    if (!cache.token) return true;
+    const skewMs = renewSkewSeconds * 1e3;
+    return now() >= cache.expiresAt - skewMs;
+  }
+  async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  async function requestNewToken() {
+    const body = {
+      client_id: clientId,
+      client_secret: clientSecret
+    };
+    let attempt = 0;
+    while (true) {
+      try {
+        const response = await fetch(authUrl, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(body)
+        });
+        if (!response.ok) {
+          const text = await response.text().catch(() => "");
+          throw new Error(
+            `Auth failed: HTTP ${response.status} ${response.statusText} ${text}`
+          );
+        }
+        const json = await response.json();
+        if (!json || !json.access_token || !json.expires_in) {
+          throw new Error("Auth response missing required fields (access_token, expires_in)");
+        }
+        cache.token = json.access_token;
+        cache.expiresAt = now() + Number(json.expires_in) * 1e3;
+        console.log(
+          `[MyIOAuth] New token obtained for ${clientId}. Expires in ~${Math.round(Number(json.expires_in) / 60)} min`
+        );
+        return cache.token;
+      } catch (error) {
+        attempt++;
+        console.warn(
+          `[MyIOAuth] Error obtaining token (attempt ${attempt}/${retryMaxAttempts}):`,
+          error instanceof Error ? error.message : error
+        );
+        if (attempt >= retryMaxAttempts) {
+          throw error;
+        }
+        const backoff = retryBaseMs * Math.pow(2, attempt - 1);
+        await sleep(backoff);
+      }
+    }
+  }
+  async function getToken() {
+    if (cache.inFlight) {
+      return cache.inFlight;
+    }
+    if (aboutToExpire()) {
+      cache.inFlight = requestNewToken().finally(() => {
+        cache.inFlight = null;
+      });
+      return cache.inFlight;
+    }
+    return cache.token;
+  }
+  function getExpiryInfo() {
+    return {
+      expiresAt: cache.expiresAt,
+      expiresInSeconds: Math.max(0, Math.floor((cache.expiresAt - now()) / 1e3))
+    };
+  }
+  function clearCache() {
+    cache.token = null;
+    cache.expiresAt = 0;
+    cache.inFlight = null;
+  }
+  function isTokenValid() {
+    if (!globalCache.has(cacheKey)) {
+      return false;
+    }
+    return !aboutToExpire();
+  }
+  return {
+    getToken,
+    getExpiryInfo,
+    clearCache,
+    isTokenValid
+  };
+}
+function clearAllAuthCaches() {
+  globalCache.clear();
+}
+function getAuthCacheStats() {
+  return {
+    totalCaches: globalCache.size,
+    cacheKeys: Array.from(globalCache.keys())
+  };
+}
+
 // src/utils/deviceType.js
 function normalize(str) {
   if (typeof str !== "string") return "";
@@ -10051,12 +10183,14 @@ async function openDemandModal(params) {
   addNamespace,
   averageByDay,
   buildListItemsThingsboardByUniqueDatasource,
+  buildMyioIngestionAuth,
   buildWaterReportCSV,
   buildWaterStoresCSV,
   calcDeltaPercent,
   classify,
   classifyWaterLabel,
   classifyWaterLabels,
+  clearAllAuthCaches,
   createDateRangePicker,
   createInputDateRangePickerInsideDIV,
   decodePayload,
@@ -10078,6 +10212,7 @@ async function openDemandModal(params) {
   formatTankHeadFromCm,
   formatWaterByGroup,
   formatWaterVolumeM3,
+  getAuthCacheStats,
   getAvailableContexts,
   getDateRangeArray,
   getSaoPauloISOString,

package/dist/index.d.cts

@@ -345,6 +345,69 @@ interface ThingsBoardItem {
  */
 declare function buildListItemsThingsboardByUniqueDatasource(datasources: any[], data: any[]): ThingsBoardItem[];
 
+/**
+ * MyIO Ingestion Authentication Component
+ *
+ * Factory function that creates authentication instances with shared token caching
+ * based on credentials. Multiple instances with the same credentials will share
+ * the same token cache for efficiency.
+ */
+/**
+ * Authentication configuration parameters
+ */
+interface MyIOAuthConfig {
+    dataApiHost: string;
+    clientId: string;
+    clientSecret: string;
+    renewSkewSeconds?: number;
+    retryBaseMs?: number;
+    retryMaxAttempts?: number;
+}
+/**
+ * Authentication instance interface
+ */
+interface MyIOAuthInstance {
+    getToken(): Promise<string>;
+    getExpiryInfo(): {
+        expiresAt: number;
+        expiresInSeconds: number;
+    };
+    clearCache(): void;
+    isTokenValid(): boolean;
+}
+/**
+ * Create a MyIO Ingestion Authentication instance
+ *
+ * Multiple instances with the same credentials will share the same token cache,
+ * which is efficient and prevents unnecessary API calls.
+ *
+ * @param config Authentication configuration
+ * @returns Authentication instance
+ *
+ * @example
+ * ```typescript
+ * const auth = buildMyioIngestionAuth({
+ *   dataApiHost: 'https://api.data.apps.myio-bas.com',
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret'
+ * });
+ *
+ * const token = await auth.getToken();
+ * ```
+ */
+declare function buildMyioIngestionAuth(config: MyIOAuthConfig): MyIOAuthInstance;
+/**
+ * Clear all cached tokens (useful for testing or logout scenarios)
+ */
+declare function clearAllAuthCaches(): void;
+/**
+ * Get cache statistics (useful for debugging)
+ */
+declare function getAuthCacheStats(): {
+    totalCaches: number;
+    cacheKeys: string[];
+};
+
 /**
  * Detects the device type based on the given name and context.
  * Uses the specified detection context to identify device types.
@@ -1124,4 +1187,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, 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, buildWaterReportCSV, buildWaterStoresCSV, calcDeltaPercent, classify, classifyWaterLabel, classifyWaterLabels, 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, 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 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 };

package/dist/index.js

@@ -1303,6 +1303,135 @@ function buildListItemsThingsboardByUniqueDatasource(datasources, data) {
   return items;
 }
 
+// src/thingsboard/auth/buildMyioIngestionAuth.ts
+var globalCache = /* @__PURE__ */ new Map();
+function generateCacheKey(config) {
+  return `${config.dataApiHost}:${config.clientId}:${config.clientSecret}`;
+}
+function buildMyioIngestionAuth(config) {
+  const {
+    dataApiHost,
+    clientId,
+    clientSecret,
+    renewSkewSeconds = 60,
+    retryBaseMs = 500,
+    retryMaxAttempts = 3
+  } = config;
+  if (!dataApiHost || !clientId || !clientSecret) {
+    throw new Error("dataApiHost, clientId, and clientSecret are required");
+  }
+  const authUrl = new URL(`${dataApiHost}/api/v1/auth`);
+  const cacheKey = generateCacheKey(config);
+  if (!globalCache.has(cacheKey)) {
+    globalCache.set(cacheKey, {
+      token: null,
+      expiresAt: 0,
+      inFlight: null
+    });
+  }
+  const cache = globalCache.get(cacheKey);
+  function now() {
+    return Date.now();
+  }
+  function aboutToExpire() {
+    if (!cache.token) return true;
+    const skewMs = renewSkewSeconds * 1e3;
+    return now() >= cache.expiresAt - skewMs;
+  }
+  async function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+  }
+  async function requestNewToken() {
+    const body = {
+      client_id: clientId,
+      client_secret: clientSecret
+    };
+    let attempt = 0;
+    while (true) {
+      try {
+        const response = await fetch(authUrl, {
+          method: "POST",
+          headers: {
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(body)
+        });
+        if (!response.ok) {
+          const text = await response.text().catch(() => "");
+          throw new Error(
+            `Auth failed: HTTP ${response.status} ${response.statusText} ${text}`
+          );
+        }
+        const json = await response.json();
+        if (!json || !json.access_token || !json.expires_in) {
+          throw new Error("Auth response missing required fields (access_token, expires_in)");
+        }
+        cache.token = json.access_token;
+        cache.expiresAt = now() + Number(json.expires_in) * 1e3;
+        console.log(
+          `[MyIOAuth] New token obtained for ${clientId}. Expires in ~${Math.round(Number(json.expires_in) / 60)} min`
+        );
+        return cache.token;
+      } catch (error) {
+        attempt++;
+        console.warn(
+          `[MyIOAuth] Error obtaining token (attempt ${attempt}/${retryMaxAttempts}):`,
+          error instanceof Error ? error.message : error
+        );
+        if (attempt >= retryMaxAttempts) {
+          throw error;
+        }
+        const backoff = retryBaseMs * Math.pow(2, attempt - 1);
+        await sleep(backoff);
+      }
+    }
+  }
+  async function getToken() {
+    if (cache.inFlight) {
+      return cache.inFlight;
+    }
+    if (aboutToExpire()) {
+      cache.inFlight = requestNewToken().finally(() => {
+        cache.inFlight = null;
+      });
+      return cache.inFlight;
+    }
+    return cache.token;
+  }
+  function getExpiryInfo() {
+    return {
+      expiresAt: cache.expiresAt,
+      expiresInSeconds: Math.max(0, Math.floor((cache.expiresAt - now()) / 1e3))
+    };
+  }
+  function clearCache() {
+    cache.token = null;
+    cache.expiresAt = 0;
+    cache.inFlight = null;
+  }
+  function isTokenValid() {
+    if (!globalCache.has(cacheKey)) {
+      return false;
+    }
+    return !aboutToExpire();
+  }
+  return {
+    getToken,
+    getExpiryInfo,
+    clearCache,
+    isTokenValid
+  };
+}
+function clearAllAuthCaches() {
+  globalCache.clear();
+}
+function getAuthCacheStats() {
+  return {
+    totalCaches: globalCache.size,
+    cacheKeys: Array.from(globalCache.keys())
+  };
+}
+
 // src/utils/deviceType.js
 function normalize(str) {
   if (typeof str !== "string") return "";
@@ -9982,12 +10111,14 @@ export {
   addNamespace,
   averageByDay,
   buildListItemsThingsboardByUniqueDatasource,
+  buildMyioIngestionAuth,
   buildWaterReportCSV,
   buildWaterStoresCSV,
   calcDeltaPercent,
   classify,
   classifyWaterLabel,
   classifyWaterLabels,
+  clearAllAuthCaches,
   createDateRangePicker2 as createDateRangePicker,
   createInputDateRangePickerInsideDIV,
   decodePayload,
@@ -10009,6 +10140,7 @@ export {
   formatTankHeadFromCm,
   formatWaterByGroup,
   formatWaterVolumeM3,
+  getAuthCacheStats,
   getAvailableContexts,
   getDateRangeArray,
   getSaoPauloISOString,

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

@@ -1309,6 +1309,135 @@
     return items;
   }
 
+  // src/thingsboard/auth/buildMyioIngestionAuth.ts
+  var globalCache = /* @__PURE__ */ new Map();
+  function generateCacheKey(config) {
+    return `${config.dataApiHost}:${config.clientId}:${config.clientSecret}`;
+  }
+  function buildMyioIngestionAuth(config) {
+    const {
+      dataApiHost,
+      clientId,
+      clientSecret,
+      renewSkewSeconds = 60,
+      retryBaseMs = 500,
+      retryMaxAttempts = 3
+    } = config;
+    if (!dataApiHost || !clientId || !clientSecret) {
+      throw new Error("dataApiHost, clientId, and clientSecret are required");
+    }
+    const authUrl = new URL(`${dataApiHost}/api/v1/auth`);
+    const cacheKey = generateCacheKey(config);
+    if (!globalCache.has(cacheKey)) {
+      globalCache.set(cacheKey, {
+        token: null,
+        expiresAt: 0,
+        inFlight: null
+      });
+    }
+    const cache = globalCache.get(cacheKey);
+    function now() {
+      return Date.now();
+    }
+    function aboutToExpire() {
+      if (!cache.token) return true;
+      const skewMs = renewSkewSeconds * 1e3;
+      return now() >= cache.expiresAt - skewMs;
+    }
+    async function sleep(ms) {
+      return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    async function requestNewToken() {
+      const body = {
+        client_id: clientId,
+        client_secret: clientSecret
+      };
+      let attempt = 0;
+      while (true) {
+        try {
+          const response = await fetch(authUrl, {
+            method: "POST",
+            headers: {
+              "Content-Type": "application/json"
+            },
+            body: JSON.stringify(body)
+          });
+          if (!response.ok) {
+            const text = await response.text().catch(() => "");
+            throw new Error(
+              `Auth failed: HTTP ${response.status} ${response.statusText} ${text}`
+            );
+          }
+          const json = await response.json();
+          if (!json || !json.access_token || !json.expires_in) {
+            throw new Error("Auth response missing required fields (access_token, expires_in)");
+          }
+          cache.token = json.access_token;
+          cache.expiresAt = now() + Number(json.expires_in) * 1e3;
+          console.log(
+            `[MyIOAuth] New token obtained for ${clientId}. Expires in ~${Math.round(Number(json.expires_in) / 60)} min`
+          );
+          return cache.token;
+        } catch (error) {
+          attempt++;
+          console.warn(
+            `[MyIOAuth] Error obtaining token (attempt ${attempt}/${retryMaxAttempts}):`,
+            error instanceof Error ? error.message : error
+          );
+          if (attempt >= retryMaxAttempts) {
+            throw error;
+          }
+          const backoff = retryBaseMs * Math.pow(2, attempt - 1);
+          await sleep(backoff);
+        }
+      }
+    }
+    async function getToken() {
+      if (cache.inFlight) {
+        return cache.inFlight;
+      }
+      if (aboutToExpire()) {
+        cache.inFlight = requestNewToken().finally(() => {
+          cache.inFlight = null;
+        });
+        return cache.inFlight;
+      }
+      return cache.token;
+    }
+    function getExpiryInfo() {
+      return {
+        expiresAt: cache.expiresAt,
+        expiresInSeconds: Math.max(0, Math.floor((cache.expiresAt - now()) / 1e3))
+      };
+    }
+    function clearCache() {
+      cache.token = null;
+      cache.expiresAt = 0;
+      cache.inFlight = null;
+    }
+    function isTokenValid() {
+      if (!globalCache.has(cacheKey)) {
+        return false;
+      }
+      return !aboutToExpire();
+    }
+    return {
+      getToken,
+      getExpiryInfo,
+      clearCache,
+      isTokenValid
+    };
+  }
+  function clearAllAuthCaches() {
+    globalCache.clear();
+  }
+  function getAuthCacheStats() {
+    return {
+      totalCaches: globalCache.size,
+      cacheKeys: Array.from(globalCache.keys())
+    };
+  }
+
   // src/utils/deviceType.js
   function normalize(str) {
     if (typeof str !== "string") return "";
@@ -9971,12 +10100,14 @@
   exports.addNamespace = addNamespace;
   exports.averageByDay = averageByDay;
   exports.buildListItemsThingsboardByUniqueDatasource = buildListItemsThingsboardByUniqueDatasource;
+  exports.buildMyioIngestionAuth = buildMyioIngestionAuth;
   exports.buildWaterReportCSV = buildWaterReportCSV;
   exports.buildWaterStoresCSV = buildWaterStoresCSV;
   exports.calcDeltaPercent = calcDeltaPercent;
   exports.classify = classify;
   exports.classifyWaterLabel = classifyWaterLabel;
   exports.classifyWaterLabels = classifyWaterLabels;
+  exports.clearAllAuthCaches = clearAllAuthCaches;
   exports.createDateRangePicker = createDateRangePicker2;
   exports.createInputDateRangePickerInsideDIV = createInputDateRangePickerInsideDIV;
   exports.decodePayload = decodePayload;
@@ -9998,6 +10129,7 @@
   exports.formatTankHeadFromCm = formatTankHeadFromCm;
   exports.formatWaterByGroup = formatWaterByGroup;
   exports.formatWaterVolumeM3 = formatWaterVolumeM3;
+  exports.getAuthCacheStats = getAuthCacheStats;
   exports.getAvailableContexts = getAvailableContexts;
   exports.getDateRangeArray = getDateRangeArray;
   exports.getSaoPauloISOString = getSaoPauloISOString;