Utilities

import {
  formatNumber,
  formatHashrate,
  formatDate,
  formatRelativeTime,
  cn,
  isEmpty,
  isValidEmail,
} from '@tetherto/mdk-react-devkit/core'

import { formatNumber, FALLBACK } from '@tetherto/mdk-react-devkit/core'

formatNumber(1234.567)                          // "1,234.57"
formatNumber(null)                              // "-"
formatNumber(1234, { minimumFractionDigits: 2 }) // "1,234.00"
formatNumber(undefined, {}, 'N/A')              // "N/A"

import { formatHashrate } from '@tetherto/mdk-react-devkit/core'

formatHashrate(150.456)  // "150.46"
formatHashrate(null)     // "-"

import { formatCurrency } from '@tetherto/mdk-react-devkit/core'

formatCurrency(1234.56, 'USD')      // "$1,234.56"
formatCurrency(0.00012345, 'BTC')   // "₿0.00012345"

import { getPercentFormattedNumber } from '@tetherto/mdk-react-devkit/core'

getPercentFormattedNumber(0.75)      // "75%"
getPercentFormattedNumber(0.1234, 1) // "12.3%"

import { formatValueUnit } from '@tetherto/mdk-react-devkit/core'

formatValueUnit(150, 'TH/s')  // "150 TH/s"

import { formatDate } from '@tetherto/mdk-react-devkit/core'

formatDate(new Date())                              // "Jan 15, 2025"
formatDate(1705334400000, { format: 'yyyy-MM-dd' }) // "2025-01-15"

import { formatRelativeTime } from '@tetherto/mdk-react-devkit/core'

formatRelativeTime(new Date(Date.now() - 3600000))  // "1h ago"
formatRelativeTime(new Date(Date.now() - 86400000)) // "1d ago"

import { formatChartDate } from '@tetherto/mdk-react-devkit/core'

formatChartDate(1705334400)        // "Jan 15"
formatChartDate(1705334400, true)  // "Jan 15, 2025"

import { isValidTimestamp } from '@tetherto/mdk-react-devkit/core'

isValidTimestamp(1705334400000)  // true
isValidTimestamp('invalid')      // false

import { parseMonthLabelToDate } from '@tetherto/mdk-react-devkit/core'

parseMonthLabelToDate('01-26')    // Date(2026, 0, 1)
parseMonthLabelToDate('03-2025')  // Date(2025, 2, 1)

import { getPastDateFromDate } from '@tetherto/mdk-react-devkit/core'

getPastDateFromDate({ dateTs: Date.now(), days: 7 })  // 7 days ago

import { isEmpty } from '@tetherto/mdk-react-devkit/core'

isEmpty(null)       // true
isEmpty('')         // true
isEmpty([])         // true
isEmpty({})         // true
isEmpty('hello')    // false
isEmpty([1, 2, 3])  // false

import { isValidEmail } from '@tetherto/mdk-react-devkit/core'

isValidEmail('user@example.com')  // true
isValidEmail('invalid')           // false

import { isValidUrl } from '@tetherto/mdk-react-devkit/core'

isValidUrl('https://example.com')  // true
isValidUrl('not-a-url')            // false

import { isNil } from '@tetherto/mdk-react-devkit/core'

isNil(null)       // true
isNil(undefined)  // true
isNil(0)          // false
isNil('')         // false

import { isPlainObject } from '@tetherto/mdk-react-devkit/core'

isPlainObject({})           // true
isPlainObject({ a: 1 })     // true
isPlainObject([])           // false
isPlainObject(new Date())   // false

import { cn } from '@tetherto/mdk-react-devkit/core'

cn('px-4', 'py-2')                    // "px-4 py-2"
cn('text-red', isError && 'bg-red')   // conditional classes
cn('p-4', { 'hidden': !visible })     // object syntax

import { toMW, toMWh } from '@tetherto/mdk-react-devkit/core'

toMW(1000000)   // 1
toMWh(1000000)  // 1

import { toPHS } from '@tetherto/mdk-react-devkit/core'

toPHS(1000000000000000)  // 1

import { convertMpaToBar } from '@tetherto/mdk-react-devkit/core'

convertMpaToBar(0.1)  // 1

import { unitToKilo } from '@tetherto/mdk-react-devkit/core'

unitToKilo(1000)  // 1

import { percentage } from '@tetherto/mdk-react-devkit/core'

percentage(25, 100)  // 25
percentage(1, 4)     // 25

import { getPercentChange } from '@tetherto/mdk-react-devkit/core'

getPercentChange(110, 100)  // 10
getPercentChange(90, 100)   // -10

import { convertUnits } from '@tetherto/mdk-react-devkit/core'

convertUnits(1, 'k', 'M')           // 0.001
convertUnits(1000, 'decimal', 'k')  // 1

import { safeNumber } from '@tetherto/mdk-react-devkit/core'

safeNumber('123')      // 123
safeNumber('invalid')  // 0
safeNumber(null)       // 0

import { toTitleCase } from '@tetherto/mdk-react-devkit/core'

toTitleCase('hello world')  // "Hello World"

import { formatMacAddress } from '@tetherto/mdk-react-devkit/core'

formatMacAddress('aa:bb:cc:dd:ee:ff')  // "AA:BB:CC:DD:EE:FF"

import { safeString } from '@tetherto/mdk-react-devkit/core'

safeString(123)    // "123"
safeString(null)   // ""

import { secondsToMs } from '@tetherto/mdk-react-devkit/core'

secondsToMs(60)  // 60000

import { breakTimeIntoIntervals } from '@tetherto/mdk-react-devkit/core'

breakTimeIntoIntervals(start, end, 3_600_000)  // Array of 1-hour { start, end } windows

import { timeRangeWalker } from '@tetherto/mdk-react-devkit/core'

for (const interval of timeRangeWalker(start, end, duration)) {
  // Process each interval
}

import { hexToRgba } from '@tetherto/mdk-react-devkit/core'

hexToRgba('#72F59E', 0.5)  // "rgba(114, 245, 158, 0.5)"

import { getNestedValue } from '@tetherto/mdk-react-devkit/core'

getNestedValue({ a: { b: 1 } }, 'a.b')  // 1

import { getWeightedAverage } from '@tetherto/mdk-react-devkit/core'

getWeightedAverage(items, 'value', 'weight')

import { circularArrayAccess } from '@tetherto/mdk-react-devkit/core'

const colors = circularArrayAccess(['red', 'green', 'blue'])
colors.next().value  // 'red'
colors.next().value  // 'green'
colors.next().value  // 'blue'
colors.next().value  // 'red' (cycles)

import {
  filterUsers,
  formatRoleLabel,
  formatLastActive,
  validateSettingsJson,
  parseSettingsFile,
  exportSettingsToFile,
} from '@tetherto/mdk-react-devkit/foundation'

import { filterUsers } from '@tetherto/mdk-react-devkit/foundation'

filterUsers({
  users,
  email: 'alice',   // partial, case-insensitive match on user.email
  role: 'admin',    // exact match on user.role; pass null to skip
})

import { formatRoleLabel } from '@tetherto/mdk-react-devkit/foundation'

formatRoleLabel('site_manager')           // "Site Manager"
formatRoleLabel('reporting_tool_manager') // "Reporting Tool Manager"
formatRoleLabel('admin')                  // "Admin"

import { formatLastActive } from '@tetherto/mdk-react-devkit/foundation'

formatLastActive('2025-01-15T14:30:00Z')  // "01/15/2025 - 14:30"
formatLastActive(undefined)               // "-"
formatLastActive('not-a-date')            // "-"

import { validateSettingsJson } from '@tetherto/mdk-react-devkit/foundation'

if (validateSettingsJson(parsed)) {
  // parsed is now narrowed to SettingsExportData
}

import { parseSettingsFile } from '@tetherto/mdk-react-devkit/foundation'

try {
  const settings = await parseSettingsFile(file)
  applySettings(settings)
} catch (err) {
  notifyError('Could not import settings', err.message)
}

import { exportSettingsToFile } from '@tetherto/mdk-react-devkit/foundation'

const filename = exportSettingsToFile({
  headerControls: { poolMiners: true, consumption: false },
  featureFlags: { betaCharts: true },
  timestamp: new Date().toISOString(),
  version: '1.0.0',
})

import {
  ONE_DAY_MS,
  DEFAULT_HISTORICAL_WINDOW_MS,
  getDefaultHistoricalAlertsRange,
  buildCurrentAlertDevicesParams,
  buildHistoricalAlertsParams,
  breakTimeIntoIntervals,
  mergeAlertsByUuid,
  fetchHistoricalAlertsInChunks,
} from '@tetherto/mdk-ui-core'

import { ONE_DAY_MS } from '@tetherto/mdk-ui-core'

ONE_DAY_MS  // 86400000

import { DEFAULT_HISTORICAL_WINDOW_MS } from '@tetherto/mdk-ui-core'

DEFAULT_HISTORICAL_WINDOW_MS  // 1209600000 (14 days in ms)

import { getDefaultHistoricalAlertsRange } from '@tetherto/mdk-ui-core'

const range = getDefaultHistoricalAlertsRange()
// { start: <14 days ago>, end: <now> }

// Injectable for tests
getDefaultHistoricalAlertsRange(1_700_000_000_000)
// { start: 1_700_000_000_000 - DEFAULT_HISTORICAL_WINDOW_MS, end: 1_700_000_000_000 }

import { buildCurrentAlertDevicesParams } from '@tetherto/mdk-ui-core'

// All devices with active alerts
const params = buildCurrentAlertDevicesParams()

// Narrowed to devices matching the active search chips
const filtered = buildCurrentAlertDevicesParams(['ip-192.168.1.1', 'sn-ABC123'])

import { buildHistoricalAlertsParams } from '@tetherto/mdk-ui-core'

const params = buildHistoricalAlertsParams({ start: range.start, end: range.end })
// { logType: 'alerts', start: ..., end: ... }

import { breakTimeIntoIntervals, ONE_DAY_MS } from '@tetherto/mdk-ui-core'

// 24-hour windows (default)
const windows = breakTimeIntoIntervals(start, end)

// Custom window size
const hourly = breakTimeIntoIntervals(start, end, 3_600_000)

import { mergeAlertsByUuid } from '@tetherto/mdk-ui-core'

const merged = mergeAlertsByUuid(previousAlerts, newAlerts)

import {
  fetchHistoricalAlertsInChunks,
  buildHistoricalAlertsParams,
} from '@tetherto/mdk-ui-core'

const alerts = await fetchHistoricalAlertsInChunks(
  { start: range.start, end: range.end },
  async (window) => {
    const result = await myApi.historyLog(buildHistoricalAlertsParams(window))
    return result.data
  },
  { signal: abortController.signal },
)