Live Model

classifyGlucoseTrend

Import: @glucoseiq/core

classifyGlucoseTrend(rocPerMin: number): CGMTrend

Classifies a rate-of-change (mg/dL per minute) into a CGM trend using Dexcom-style thresholds: <1 flat, 1–2 slight, 2–3 single, ≥3 rapid.

Returns: The corresponding CGMTrend

computeGlucoseTrend

Import: @glucoseiq/core

computeGlucoseTrend(readings: GlucoseReading[], options?: GlucoseTrendOptions): GlucoseTrendResult

Computes glucose rate-of-change and derives a trend from recent readings.

Fits a least-squares slope over readings in the trailing window, normalizing mixed units to mg/dL. Hosts can use the result for a live trend arrow or to back-fill a trend when a feed (e.g. Nightscout) does not provide one.

Returns: Rate-of-change (mg/dL/min) and derived trend

Throws: If windowMin is not a finite positive number

import { computeGlucoseTrend, type GlucoseReading } from '@glucoseiq/core'

const readings: GlucoseReading[] = [
  { value: 110, unit: 'mg/dL', timestamp: '2024-01-01T08:00:00Z' },
  { value: 120, unit: 'mg/dL', timestamp: '2024-01-01T08:05:00Z' },
]
const { rocPerMin, trend } = computeGlucoseTrend(readings)
// rocPerMin: 2, trend: 'rising'

latestReading

Import: @glucoseiq/core

latestReading(readings: GlucoseReading[]): GlucoseReading | null

Returns the most recent fully usable reading by timestamp (readings need not be sorted). A usable reading has a supported unit, a finite positive value at or below 600 mg/dL after normalization, and a parseable timestamp.

Returns: The latest fully usable reading, or null when none are usable

minutesSinceLastReading

Import: @glucoseiq/core

minutesSinceLastReading(readings: GlucoseReading[], now?: string | number | Date): number | null

Returns signed minutes since the most recent reading (sensor staleness).

Remarks: Returns a negative value when the latest usable reading is later than now or the current clock. Callers choose how to handle clock skew or source timing problems.

Returns: Signed minutes since the latest reading, or null if there are none

Throws: If an explicit reference time is invalid