services/ on SAFER Documentation

activityService.ts

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

Purpose

This module orchestrates the full activity sensing pipeline: starting and stopping the accelerometer, computing CPM from the live sensor buffer on a 1-minute tick, persisting each result to the CPM database, and exposing a 40-minute rolling average for downstream core temperature inference.

dailyWorkAreaService.ts

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

Purpose

This module takes a geographic work area circle and produces the set of weather cache cell coordinates that must be pre-fetched to fully cover that area. It is the bridge between the user-defined work area and the weather pre-caching pipeline.

dailyWorkAreaStore.ts

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

Purpose

This module manages the persistent record of user-defined work area circles and the daily prompt gate that determines whether the user has been asked to set their work area today. All data is stored in AsyncStorage under a single versioned key.

debugCoreTempDummy.ts

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

Purpose

This module provides a one-shot debug helper for verifying that the core temperature ONNX model loads, runs, and produces a result for a known set of hardcoded inputs. It is intended to be called from the Debug screen or a test harness and has no effect on application state.

debugWBGTDummy.ts

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

Purpose

This module provides a one-shot debug helper for verifying that the WBGT ONNX models load, run, and produce results for a known set of hardcoded meteorological inputs. It is intended to be called from the Debug screen or a test harness and has no effect on application state.

location.ts

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

Purpose

This module handles all device location concerns: requesting the appropriate permission scope, resolving the current GPS position, and geocoding a text address into coordinates via the Google Places API.

notifications.ts

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

Purpose

This module configures the global Expo notification handler and exposes functions for requesting notification permissions and sending immediate heatstroke risk alerts. Alert message content is determined by core temperature thresholds.

notificationService.ts

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

Purpose

This module configures the global Expo notification handler and exposes functions for requesting notification permissions and sending heatstroke risk alerts. Unlike notifications.ts, alert content is determined by a normalized risk level value rather than a raw core temperature.

predictionHeatRisk.ts

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

Purpose

This module is the top-level prediction orchestrator. It gathers all required inputs from their respective services, selects the appropriate core temperature model variant, runs inference, persists the result to connected wearables, and returns a structured prediction payload.

predictionWGBT.ts

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

Purpose

This module produces a WBGT (Wet Bulb Globe Temperature) prediction for the user’s current GPS location by combining cached weather data with a computed solar radiation estimate and running the WBGT ONNX inference model.

profileStore.ts

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

Purpose

This module manages the user’s physiological profile, providing typed load and save operations backed by AsyncStorage. It is the single source of truth for profile data consumed by inference, the home screen, and the landing screen.

weatherCacheCells.ts

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

Purpose

This module implements the geographic cell grid that underpins the weather cache. It partitions the globe into a fixed-resolution grid of cells, assigns each cell a deterministic string key, and provides helpers for working with cell geometry and distance.

weatherService.ts

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

Purpose

This module is the central weather data layer. It provides a single cached-read entry point for getting a weather point for any coordinate and time, and a bulk pre-cache entry point for warming the cache across a set of work-area locations before they are needed.

wgbtModel.ts

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

Purpose

This module is an early standalone ONNX session wrapper for the Natural Wet Bulb model, predating the unified inferenceWGBT.ts + onnxAsset.ts architecture. It is no longer called by any active code path and is retained only as a historical reference.

workAreaAddressSearch.ts

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

Purpose

This module provides a two-step address resolution flow backed by the Google Places Autocomplete and Place Details APIs. It is used by location.ts to convert a user-entered address string into geographic coordinates for work area setup.