helios-tracker 0.0.2 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e7b77ee84b04d1dfc32b877617dd7bb97bc1fcad890e13476d7e169801ad2279
-  data.tar.gz: 9e5bc143fceb4b90aca134d3281514c0bd0b00161f53ae031be2e0425d07522b
+  metadata.gz: b47373781f52e1842f828859f8b87e3d18ba95ffbeb04bde7b4aec8f76e0ffa3
+  data.tar.gz: ac2c4da6b6888e47271498ec22cc49faf1cecc0cf0938299bea955cf9f09d043
 SHA512:
-  metadata.gz: 41a8d33e889318d2fa1bb49a21db22d5da1c4dab8d6b7a365ac0bc469155ec12a76bf3460d96bd8af6bb21b01888c52310779f0ca47c7cfe041ef1c546dbd210
-  data.tar.gz: 04a89ab9def660e8e8d10b5b316b20fabcf67332879a4ea7f3dfcc5f6a9168e6ef1c868704c6544270af4c899793b0269ef0656bc94408c0b63685cdbb44c69f
+  metadata.gz: 49d1bee23fa90865700b51f3250322c1ec7633f09078ceab23f74f7be12bd6c0ab899bf8665e3f6663071bb6888f4385f60a7e608bdc1dd4195476226f00cda5
+  data.tar.gz: a482d036960bc620bde085b7f31c736f2fd799a126beb4b8111ec607ad3ce910afbf5c469ffbe7f28a870e1fa06eba722694b49faa905258df212c742fcf64e2

data/lib/generators/helios_tracker/templates/helios_tracker.rb.erb

@@ -17,17 +17,21 @@ HeliosTracker.configure do |config|
   # Map API response field names to your model's attributes or lambdas.
   # :email is required by the Helios API. All other fields are optional —
   # simply remove any lines you don't need.
+  #
+  # IMPORTANT: All numeric data points must return CUMULATIVE LIFETIME TOTALS,
+  # not counts within the query_start window. Helios stores the cumulative
+  # value and derives points from the delta between successive pulls.
   config.user_fields = {
     email:                      :email,
     created_at:                 :created_at,
     # source_ip:                :source_ip,
     # first_unconfirmed_visit_id: :first_unconfirmed_visit_id,
     # login_attempt_count:      :login_attempt_count,
-    # login_count:              :login_count,
+    # login_count:              ->(user) { user.sign_in_count },
     # accounts_owned_count:     ->(user) { user.accounts_owned_count },
     # free_accounts_count:      ->(user) { user.free_accounts_count },
     # unsubscribe_nonce:        :unsubscribe_nonce,
-    # app_open_days_count:      :app_open_days_count,
+    # app_open_days_count:      ->(user) { user.app_opens.count },
   }
 
   # -----------------------------------------------------------------------

data/lib/helios_tracker/configuration.rb

@@ -35,6 +35,11 @@ module HeliosTracker
     # Optional user fields — map API field names to model attributes or lambdas.
     # :email is always required and included automatically.
     #
+    # IMPORTANT: All numeric data points (login_count, accounts_owned_count,
+    # app_open_days_count, etc.) must return CUMULATIVE LIFETIME TOTALS,
+    # not counts within the query_start window. Helios stores the cumulative
+    # value and derives points from the delta between successive pulls.
+    #
     # Example:
     #   config.user_fields = {
     #     email:                      :email,
@@ -42,11 +47,11 @@ module HeliosTracker
     #     source_ip:                  ->(user) { user.try(:source_ip) },
     #     first_unconfirmed_visit_id: :first_unconfirmed_visit_id,
     #     login_attempt_count:        :login_attempt_count,
-    #     login_count:                :login_count,
+    #     login_count:                ->(user) { user.sign_in_count },
     #     accounts_owned_count:       ->(user) { user.accounts_owned_count },
     #     free_accounts_count:        ->(user) { user.free_accounts_count },
     #     unsubscribe_nonce:          :unsubscribe_nonce,
-    #     app_open_days_count:        :app_open_days_count,
+    #     app_open_days_count:        ->(user) { user.app_opens.count },
     #   }
     attr_accessor :user_fields
 

data/lib/helios_tracker/version.rb

@@ -1,5 +1,5 @@
 module HeliosTracker
   class Version
-    CURRENT = '0.0.2'
+    CURRENT = '0.0.3'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: helios-tracker
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors:
 - Jason Fleetwood-Boldt
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-08 00:00:00.000000000 Z
+date: 2026-05-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails