import { type MeterValueDto, type SampledValue } from '@citrineos/types'; export declare class MeterValueUtils { private static readonly validContexts; /** * Calculate the total Kwh * * @param {array} meterValues - meterValues of a transaction. * @param {number} currentTotal - the current total Kwh to add to interval values, if needed. * @param {number} meterStart - the starting Kwh value at the beginning of the transaction, if available. * @return {number} total Kwh based on the best available energy measurement, or currentTotal when * this batch of meterValues carries no usable energy reading. */ static getTotalKwh(meterValues: MeterValueDto[], currentTotal: number, meterStart?: number): number; static getMeterStart(meterValues: MeterValueDto[]): number | null; /** * Filter out meter values whose context is not one of the valid reading contexts. * @param meterValues Array of MeterValueType to filter. * @returns Filtered array containing only meter values in Transaction_Begin, Sample_Periodic or Transaction_End contexts. */ private static filterValidMeterValues; /** * Extracts Energy.Active.Import.Register measurand values into a timestamp-to-kWh map. * @param meterValues Array of MeterValueType to search for register readings. * @returns Map where each key is the reading timestamp (ms since epoch) and each value is the normalized kWh. */ private static getRegisterValuesMap; /** * Extracts Energy.Active.Import.Interval measurand values into a timestamp-to-kWh map. * @param meterValues Array of MeterValueType to search for interval readings. * @returns Map where each key is the reading timestamp (ms since epoch) and each value is the normalized kWh. */ private static getIntervalValuesMap; /** * Extracts Energy.Active.Net measurand values into a timestamp-to-kWh map. * @param meterValues Array of MeterValueType to search for net readings. * @returns Map where each key is the reading timestamp (ms since epoch) and each value is the normalized kWh. */ private static getNetValuesMap; /** * Find a specific measurand value from sampledValues * @param sampledValues Array of sampled values * @param measurand The measurand type to look for * @param phased Whether to look for phased values (true) or non-phased values (false) * @returns The normalized value in kWh, or null if not found */ private static findMeasurandValue; /** * Sum phased values for a specific measurand * @param sampledValues Array of sampled values * @param measurand The measurand type to sum * @returns The sum of phase values in kWh, or null if no valid phase values found */ private static sumPhasedValues; /** * Convert a sampled energy value to kWh, applying the unit multiplier and Wh→kWh factor. * A missing unit is treated as Wh. Throws for a genuinely unknown energy unit. * @param value A SampledValueType entry. * @returns The converted value in kWh. */ static normalizeToKwh(value: SampledValue): number; /** * Sort the entries of a timestamp-to-kWh map ascending by timestamp and return the kWh values. * @param valuesMap Map of timestamp (ms since epoch) to kWh. * @returns Array of kWh values sorted by timestamp. */ private static getSortedKwhByTimestampAscending; }