sugarsense-units 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dcc1213237aae5f99e43cf1f88dc91a40e62e8e285227223961022d23863c13b
-  data.tar.gz: 5ef263aaa45acd74d33487b2a7657e702c566e4b6f208df7464953bf8426aa27
+  metadata.gz: '028fede44078011e763d7918cc5c6b8fa09526cbe3957e19e7385b29aa70c208'
+  data.tar.gz: 88f258d06d5eef997b667969ffa94afbf0c30c052c398d10cdf552217edf0aac
 SHA512:
-  metadata.gz: 6d7833ba0a82dc6e8a2761807dae113954a856edf8855240176e0b9ae436c7577602a81d1bbdb6fe8652ebf9796718797f8f2b51cea3a84f0c9c9c6ba2d0fbf0
-  data.tar.gz: 7bbe2fb05bbf457f2a62d902235e5422ff0188c6dd9b9d64991b71564b0105bf8a2d066753e3db0ff8834cd5b05106d0596bcfeb7c9b65924bddc88dea830016
+  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.0"
+    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.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Sugar Sense
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-08-01 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
@@ -30,6 +30,8 @@ licenses:
 metadata:
   homepage_uri: https://sugarsense.io
   documentation_uri: https://www.rubydoc.info/gems/sugarsense-units
+  source_code_uri: https://github.com/sugarsense/sugarsense-oss/tree/main/sugarsense-units
+  bug_tracker_uri: https://github.com/sugarsense/sugarsense-oss/issues
   rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []