myio-js-library 0.1.140 → 0.1.142

package/dist/index.d.cts

@@ -2073,4 +2073,213 @@ declare function openGoalsPanel(params: {
     locale?: string;
 }): any;
 
-export { ConnectionStatusType, type CreateDateRangePickerOptions, type CreateInputDateRangePickerInsideDIVParams, type DateRangeControl, type DateRangeInputController, type DateRangeResult, type DemandModalInstance, type DemandModalParams, type DemandModalPdfConfig, type DemandModalStyles, DeviceStatusType, type EnergyModalContext, type EnergyModalError, type EnergyModalI18n, type EnergyModalStyleOverrides, type MyIOAuthConfig, type MyIOAuthInstance, MyIOChartModal, MyIODraggableCard, MyIOSelectionStore, MyIOSelectionStoreClass, MyIOToast, type OpenDashboardPopupEnergyOptions, type OpenDashboardPopupSettingsParams, type OpenDashboardPopupWaterTankOptions, type PersistResult, type RealTimeTelemetryInstance, type RealTimeTelemetryParams, type SettingsError, type SettingsEvent, type StoreRow, type TbScope, type TelemetryFetcher, type ThingsboardCustomerAttrsConfig, type TimedValue, type WaterRow, type WaterTankDataPoint, type WaterTankModalContext, type WaterTankModalError, type WaterTankModalI18n, type WaterTankModalStyleOverrides, type WaterTankTelemetryData, addDetectionContext, addNamespace, averageByDay, buildListItemsThingsboardByUniqueDatasource, buildMyioIngestionAuth, buildWaterReportCSV, buildWaterStoresCSV, calcDeltaPercent, calculateDeviceStatus, calculateDeviceStatusWithRanges, classify, classifyWaterLabel, classifyWaterLabels, clearAllAuthCaches, connectionStatusIcons, createDateRangePicker, createInputDateRangePickerInsideDIV, decodePayload, decodePayloadBase64Xor, detectDeviceType, determineInterval, deviceStatusIcons, 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, getConnectionStatusIcon, getDateRangeArray, getDeviceStatusIcon, getDeviceStatusInfo, getSaoPauloISOString, getSaoPauloISOStringFixed, getValueByDatakey, getValueByDatakeyLegacy, getWaterCategories, groupByDay, isDeviceOffline, isValidConnectionStatus, isValidDeviceStatus, isWaterCategory, mapDeviceStatusToCardStatus, mapDeviceToConnectionStatus, normalizeRecipients, numbers, openDashboardPopup, openDashboardPopupAllReport, openDashboardPopupEnergy, openDashboardPopupReport, openDashboardPopupSettings, openDashboardPopupWaterTank, openDemandModal, openGoalsPanel, openRealTimeTelemetryModal, parseInputDateToDate, renderCardComponent$2 as renderCardComponent, renderCardComponent$1 as renderCardComponentEnhanced, renderCardComponentHeadOffice, renderCardComponentLegacy, renderCardComponentV2, renderCardComponent as renderCardComponentV5, renderCardComponentV5 as renderCardV5, shouldFlashIcon, strings, timeWindowFromInputYMD, toCSV, toFixedSafe, waterDeviceStatusIcons };
+/**
+ * Temperature Modal Utilities
+ * Shared functions for temperature modal components
+ * RFC-0085: Temperature Modal Component
+ */
+interface TemperatureTelemetry {
+    ts: number;
+    value: number | string;
+}
+interface TemperatureStats {
+    avg: number;
+    min: number;
+    max: number;
+    count: number;
+}
+interface DailyTemperatureStats {
+    date: string;
+    dateTs: number;
+    avg: number;
+    min: number;
+    max: number;
+    count: number;
+}
+interface ClampRange {
+    min: number;
+    max: number;
+}
+type TemperatureGranularity = 'hour' | 'day';
+declare const DEFAULT_CLAMP_RANGE: ClampRange;
+declare const CHART_COLORS: string[];
+/**
+ * Fetches temperature telemetry data from ThingsBoard API
+ */
+declare function fetchTemperatureData(token: string, deviceId: string, startTs: number, endTs: number): Promise<TemperatureTelemetry[]>;
+/**
+ * Clamps temperature value to avoid outliers
+ * Values below min are clamped to min, values above max are clamped to max
+ */
+declare function clampTemperature(value: number | string, range?: ClampRange): number;
+/**
+ * Calculates statistics from temperature data
+ */
+declare function calculateStats(data: TemperatureTelemetry[], clampRange?: ClampRange): TemperatureStats;
+/**
+ * Interpolates temperature data to fill gaps with 30-minute intervals
+ * Uses 'repeat-last' strategy: if no reading in interval, repeats last known temperature
+ */
+declare function interpolateTemperature(data: TemperatureTelemetry[], options: {
+    intervalMinutes: number;
+    startTs: number;
+    endTs: number;
+    clampRange?: ClampRange;
+}): TemperatureTelemetry[];
+/**
+ * Aggregates temperature data by day, calculating daily statistics
+ */
+declare function aggregateByDay(data: TemperatureTelemetry[], clampRange?: ClampRange): DailyTemperatureStats[];
+/**
+ * Formats temperature value for display
+ */
+declare function formatTemperature(value: number, decimals?: number): string;
+/**
+ * Exports temperature data to CSV format
+ */
+declare function exportTemperatureCSV(data: TemperatureTelemetry[], deviceLabel: string, stats: TemperatureStats, startDate: string, endDate: string): void;
+
+/**
+ * Temperature Modal Component
+ * RFC-0085: Single device temperature visualization
+ *
+ * Displays temperature telemetry data with statistics and timeline chart.
+ * Fetches data from ThingsBoard API.
+ */
+
+interface TemperatureModalParams {
+    /** JWT token for ThingsBoard API */
+    token: string;
+    /** ThingsBoard device UUID */
+    deviceId: string;
+    /** Start date in ISO format */
+    startDate: string;
+    /** End date in ISO format */
+    endDate: string;
+    /** Device label for display */
+    label?: string;
+    /** Current temperature value */
+    currentTemperature?: number;
+    /** Minimum threshold for visual range */
+    temperatureMin?: number;
+    /** Maximum threshold for visual range */
+    temperatureMax?: number;
+    /** Temperature status indicator */
+    temperatureStatus?: 'ok' | 'above' | 'below';
+    /** Container element or selector */
+    container?: HTMLElement | string;
+    /** Callback when modal closes */
+    onClose?: () => void;
+    /** Locale for formatting */
+    locale?: 'pt-BR' | 'en-US';
+    /** Outlier clamping range */
+    clampRange?: ClampRange;
+    /** Initial granularity */
+    granularity?: TemperatureGranularity;
+    /** Initial theme */
+    theme?: 'dark' | 'light';
+}
+interface TemperatureModalInstance {
+    /** Destroys the modal */
+    destroy: () => void;
+    /** Updates data with new date range */
+    updateData: (startDate: string, endDate: string, granularity?: TemperatureGranularity) => Promise<void>;
+}
+/**
+ * Opens a temperature modal for a single device
+ */
+declare function openTemperatureModal(params: TemperatureModalParams): Promise<TemperatureModalInstance>;
+
+/**
+ * Temperature Comparison Modal Component
+ * RFC-0085: Multi-device temperature comparison visualization
+ *
+ * Displays temperature telemetry data for multiple devices with comparison chart.
+ * Fetches data from ThingsBoard API.
+ */
+
+interface TemperatureDevice {
+    /** ThingsBoard device UUID */
+    id: string;
+    /** Device label for legend */
+    label: string;
+    /** Alternative ThingsBoard ID */
+    tbId?: string;
+    /** Customer name (for grouping/display) */
+    customerName?: string;
+    /** Minimum threshold for this device's ideal range */
+    temperatureMin?: number;
+    /** Maximum threshold for this device's ideal range */
+    temperatureMax?: number;
+}
+interface TemperatureComparisonModalParams {
+    /** JWT token for ThingsBoard API */
+    token: string;
+    /** Array of devices to compare */
+    devices: TemperatureDevice[];
+    /** Start date in ISO format */
+    startDate: string;
+    /** End date in ISO format */
+    endDate: string;
+    /** Container element or selector */
+    container?: HTMLElement | string;
+    /** Callback when modal closes */
+    onClose?: () => void;
+    /** Locale for formatting */
+    locale?: 'pt-BR' | 'en-US';
+    /** Outlier clamping range */
+    clampRange?: ClampRange;
+    /** Initial granularity */
+    granularity?: TemperatureGranularity;
+    /** Initial theme */
+    theme?: 'dark' | 'light';
+    /** Minimum threshold for ideal range (Y-axis will include this) */
+    temperatureMin?: number;
+    /** Maximum threshold for ideal range (Y-axis will include this) */
+    temperatureMax?: number;
+}
+interface TemperatureComparisonModalInstance {
+    /** Destroys the modal */
+    destroy: () => void;
+    /** Updates data with new date range */
+    updateData: (startDate: string, endDate: string, granularity?: TemperatureGranularity) => Promise<void>;
+}
+/**
+ * Opens a temperature comparison modal for multiple devices
+ */
+declare function openTemperatureComparisonModal(params: TemperatureComparisonModalParams): Promise<TemperatureComparisonModalInstance>;
+
+/**
+ * Temperature Settings Modal Component
+ * RFC-0085: Customer-level temperature threshold configuration
+ *
+ * Allows configuring minTemperature and maxTemperature attributes
+ * for a ThingsBoard customer (SERVER_SCOPE).
+ */
+interface TemperatureSettingsParams {
+    /** JWT token for ThingsBoard API */
+    token: string;
+    /** Customer ID (ThingsBoard UUID) */
+    customerId: string;
+    /** Customer name for display */
+    customerName?: string;
+    /** Callback when settings are saved */
+    onSave?: (settings: {
+        minTemperature: number;
+        maxTemperature: number;
+    }) => void;
+    /** Callback when modal closes */
+    onClose?: () => void;
+    /** Initial theme */
+    theme?: 'dark' | 'light';
+}
+interface TemperatureSettingsInstance {
+    /** Destroys the modal */
+    destroy: () => void;
+}
+/**
+ * Opens the temperature settings modal for a customer
+ */
+declare function openTemperatureSettingsModal(params: TemperatureSettingsParams): TemperatureSettingsInstance;
+
+export { CHART_COLORS, type ClampRange, ConnectionStatusType, type CreateDateRangePickerOptions, type CreateInputDateRangePickerInsideDIVParams, DEFAULT_CLAMP_RANGE, type DateRangeControl, type DateRangeInputController, type DateRangeResult, type DemandModalInstance, type DemandModalParams, type DemandModalPdfConfig, type DemandModalStyles, DeviceStatusType, type EnergyModalContext, type EnergyModalError, type EnergyModalI18n, type EnergyModalStyleOverrides, type MyIOAuthConfig, type MyIOAuthInstance, MyIOChartModal, MyIODraggableCard, MyIOSelectionStore, MyIOSelectionStoreClass, MyIOToast, type OpenDashboardPopupEnergyOptions, type OpenDashboardPopupSettingsParams, type OpenDashboardPopupWaterTankOptions, type PersistResult, type RealTimeTelemetryInstance, type RealTimeTelemetryParams, type SettingsError, type SettingsEvent, type StoreRow, type TbScope, type TelemetryFetcher, type TemperatureComparisonModalInstance, type TemperatureComparisonModalParams, type TemperatureDevice, type TemperatureGranularity, type TemperatureModalInstance, type TemperatureModalParams, type TemperatureSettingsInstance, type TemperatureSettingsParams, type TemperatureStats, type TemperatureTelemetry, type ThingsboardCustomerAttrsConfig, type TimedValue, type WaterRow, type WaterTankDataPoint, type WaterTankModalContext, type WaterTankModalError, type WaterTankModalI18n, type WaterTankModalStyleOverrides, type WaterTankTelemetryData, addDetectionContext, addNamespace, aggregateByDay, averageByDay, buildListItemsThingsboardByUniqueDatasource, buildMyioIngestionAuth, buildWaterReportCSV, buildWaterStoresCSV, calcDeltaPercent, calculateDeviceStatus, calculateDeviceStatusWithRanges, calculateStats, clampTemperature, classify, classifyWaterLabel, classifyWaterLabels, clearAllAuthCaches, connectionStatusIcons, createDateRangePicker, createInputDateRangePickerInsideDIV, decodePayload, decodePayloadBase64Xor, detectDeviceType, determineInterval, deviceStatusIcons, exportTemperatureCSV, exportToCSV, exportToCSVAll, extractMyIOCredentials, fetchTemperatureData, fetchThingsboardCustomerAttrsFromStorage, fetchThingsboardCustomerServerScopeAttrs, findValue, fmtPerc$1 as fmtPerc, fmtPerc as fmtPercLegacy, formatAllInSameUnit, formatAllInSameWaterUnit, formatDateForInput, formatDateToYMD, formatDateWithTimezoneOffset, formatEnergy, formatNumberReadable, formatTankHeadFromCm, formatTemperature, formatWaterByGroup, formatWaterVolumeM3, getAuthCacheStats, getAvailableContexts, getConnectionStatusIcon, getDateRangeArray, getDeviceStatusIcon, getDeviceStatusInfo, getSaoPauloISOString, getSaoPauloISOStringFixed, getValueByDatakey, getValueByDatakeyLegacy, getWaterCategories, groupByDay, interpolateTemperature, isDeviceOffline, isValidConnectionStatus, isValidDeviceStatus, isWaterCategory, mapDeviceStatusToCardStatus, mapDeviceToConnectionStatus, normalizeRecipients, numbers, openDashboardPopup, openDashboardPopupAllReport, openDashboardPopupEnergy, openDashboardPopupReport, openDashboardPopupSettings, openDashboardPopupWaterTank, openDemandModal, openGoalsPanel, openRealTimeTelemetryModal, openTemperatureComparisonModal, openTemperatureModal, openTemperatureSettingsModal, parseInputDateToDate, renderCardComponent$2 as renderCardComponent, renderCardComponent$1 as renderCardComponentEnhanced, renderCardComponentHeadOffice, renderCardComponentLegacy, renderCardComponentV2, renderCardComponent as renderCardComponentV5, renderCardComponentV5 as renderCardV5, shouldFlashIcon, strings, timeWindowFromInputYMD, toCSV, toFixedSafe, waterDeviceStatusIcons };