ordetra

Core types and helpers for normalized energy telemetry.

Installation

npm install ordetra

API

• Site
• EnergyReading
• normalizeSiteId(value)
• estimateEnergyWh(powerW, intervalSeconds)
• isEnergyReading(value)
• sortReadingsByTimestamp(readings)
• mergeReadings(...groups)

Example

import {
  estimateEnergyWh,
  mergeReadings,
  normalizeSiteId,
} from "ordetra"

const siteId = normalizeSiteId(12345)
const estimatedEnergyWh = estimateEnergyWh(400, 900)

const readings = mergeReadings(
  [
    {
      timestamp: "2026-04-03T19:00:00.000Z",
      provider: "enphase",
      siteId,
      production: {
        powerW: 400,
        energyWh: estimatedEnergyWh,
        provenance: "estimated",
      },
      intervalSeconds: 900,
    },
  ],
  []
)