utils/ on SAFER Documentation

background.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module defines the Android foreground service task that runs the heat risk prediction pipeline continuously while a monitoring session is active. It also provides helpers for requesting the permissions required to keep a foreground service alive on Android 13+.

backgroundIOS.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module implements the two iOS background execution paths used during monitoring: a BGTaskScheduler-driven periodic fetch (fired every ~15–30 minutes by the OS) and a HealthKit event-driven path (fired each time the Apple Watch pushes a new heart rate sample). Together they provide periodic full prediction runs and more frequent model updates triggered by fresh HR data.

forecastTime.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module provides a single conversion function that reduces any date-like value to the canonical UTC hour-boundary string used as the time dimension of weather cache keys.

Its responsibilities include:

global.d.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This declaration file extends the global namespace to make the logging functions installed by logging.ts available as typed globals throughout the application, without requiring an explicit import in every file.

localDay.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module provides the canonical local-day key format (YYYY-MM-DD) used throughout the work area store and other date-keyed persistence layers. All operations use the device’s local timezone, not UTC.

logging.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module implements the application’s logging infrastructure. It installs global.log and global.makeLogger, writes log entries to per-level rotating files on the device filesystem, and — in debug builds — also persists every entry to a SQLite debug_logs table for in-app inspection via the Debug screen.

ndfdTime.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module computes the inclusive local-time begin/end window sent to the NDFD XML API. NDFD requires local (non-UTC) datetime strings, and the window must be aligned to the anchor hour to produce consistent cache-compatible results.

sessionMonitor.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module manages the user-initiated “active monitoring session” — the equivalent of a workout mode. On iOS it uses a continuous GPS location watch to keep the app alive in the background, throttled to run the prediction pipeline at most once per minute. On Android it delegates to the react-native-background-actions foreground service.

tempUtils.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module provides the two temperature utility functions used across all screens to convert and format core temperature values according to the user’s unit system preference.

Its responsibilities include:

watchOS.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module delivers core body temperature predictions to a paired Apple Watch using react-native-watch-connectivity. It attempts a foreground message first and falls back to background user-info transfer if the watch is not reachable.

WBGT_physics.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module provides the physical calculations required to derive solar radiation from sky cover and geographic/temporal context, as well as unit conversion helpers used by the NDFD data normalization layer.

wearOS.ts

Mon, 01 Jan 0001 00:00:00 +0000

Purpose

This module delivers the current core body temperature prediction and the full 24-hour history to a paired WearOS device via react-native-wear-connectivity. Unlike the WatchOS module, it includes the full history payload so the watch can render a history graph without its own database access.