sugarsense-units 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9c9683f3fd63728032dbbe78b687f5a130ad5fd9dd63aba3118123115790fa7a
-  data.tar.gz: 3b8a546830c96425dcc3c9955e7ef38bf6684b8fba842b5e43c792f0e1d66b9c
+  metadata.gz: '028fede44078011e763d7918cc5c6b8fa09526cbe3957e19e7385b29aa70c208'
+  data.tar.gz: 88f258d06d5eef997b667969ffa94afbf0c30c052c398d10cdf552217edf0aac
 SHA512:
-  metadata.gz: 203f1d76f7312187e2f313379a88762fc9b9b7cc6b19f098d9ed13dca9cff8c923be86298854eb2f6369e88204c42853c16dbef4b2f864157e42cac351eb56e8
-  data.tar.gz: 4272b97be13a18f20573dbc9cf473302940efcbfa32bae0c1638206d938908cc7f7816e524f0b3a4e2a444fa9dc41cd33590f8ee61d299d6452d40938d22236e
+  metadata.gz: f6b639672dde3c66072464a4dcb540b35920ed8865c9752c758bfc596eacf4a538caf371060f23ced3ae6176887d5b25a6792ec72b59e460bbacb7be715bac01
+  data.tar.gz: fc61831c444a7446b0edee72f64da4e8e963f591f87df12f21f21e07193978f047672463634a0c13f500387ef811b97a4a5b86b43c9b09b1e90fb71e47d57223

data/README.md

@@ -22,6 +22,7 @@ SugarSense::Units.format_glucose(120, :mmol)   # => "6.7"  (display form, 1 deci
 SugarSense::Units.trend_arrow(2)               # => "↘"
 SugarSense::Units.classify_zone(65)            # => :low
 SugarSense::Units.gmi(154)                     # => 6.99  (approximates lab A1C, %)
+SugarSense::Units.stale?(reading_time_ms)      # => true once a reading is over 15 min old
 
 SugarSense::Units.time_in_range([50, 60, 100, 150, 200, 300])
 # => { total: 6,
@@ -37,6 +38,7 @@ These match the Sugar Sense production apps and backend:
 - **Trend codes** are integers 1 to 5: `1 ↓ falling fast, 2 ↘ falling, 3 → steady, 4 ↗ rising, 5 ↑ rising fast` (the same scheme Dexcom, Libre and Nightscout data can be normalized to).
 - **Zones**: `:very_low, :low, :in_range, :high, :very_high`, with boundaries inclusive on the out-of-range side (a value exactly at the low limit is `:low`, exactly at the high limit is `:high`).
 - **Default thresholds** are `55 / 70 / 180 / 250` mg/dL (`DEFAULT_THRESHOLDS`), aligned with ADA guidance. Every method accepts custom thresholds.
+- **Staleness**: a reading strictly older than 15 minutes counts as stale (`stale?`) and should be presented as "no current data", never as a live value.
 
 ## About Sugar Sense
 

data/lib/sugarsense/units/version.rb

@@ -2,6 +2,6 @@
 
 module SugarSense
   module Units
-    VERSION = "0.1.1"
+    VERSION = "0.2.0"
   end
 end

data/lib/sugarsense/units.rb

@@ -87,6 +87,14 @@ module SugarSense
       3.31 + 0.02392 * Float(mean_mgdl)
     end
 
+    # A reading older than stale_minutes (default 15, the Sugar Sense rule) is
+    # stale and should be presented as "no current data". Strictly greater: a
+    # reading exactly 15 minutes old is NOT stale. Timestamps in epoch ms,
+    # mirroring the npm package's isStale.
+    def stale?(reading_time_ms, now_ms = Time.now.to_f * 1000, stale_minutes = 15)
+      Float(now_ms) - Float(reading_time_ms) > Float(stale_minutes) * 60 * 1000
+    end
+
     def validate_thresholds(t)
       unless t[:very_low] < t[:low] && t[:low] < t[:high] && t[:high] < t[:very_high]
         raise ArgumentError, "thresholds must satisfy very_low < low < high < very_high"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sugarsense-units
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Sugar Sense
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-07 00:00:00.000000000 Z
+date: 2026-08-31 00:00:00.000000000 Z
 dependencies: []
 description: 'Glucose helpers extracted from the Sugar Sense CGM monitoring app: mg/dL
   to mmol/L conversion, trend arrow codes, glucose zone classification, time in range