ruby_garmin_connect 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '08c6d390104bc4f19e46f95d0726171890e2c0f3c41e165b1afca94031c0f243'
-  data.tar.gz: 8225469c95d81af76180c1e6e1c4229f3caaa27cef9eb675e1c514ec208b1145
+  metadata.gz: 9b18f0c8f89a53ffc4f5f823c156aa14efcdcdd4fdcbcc11bfcf2c96ad8026fa
+  data.tar.gz: b041d02818b7e1cc499bfce5b24982b73d3b616a2e2f41eb6599b6f0bb9b70c1
 SHA512:
-  metadata.gz: e3f740b9dda27508940450bacfe50f7ad74e060f2c9f97100500fcb1b200424cfb425efd0a187d61f5d55e03af04e3ada0b2029284a6542adbefb70f971c0ede
-  data.tar.gz: 2609e8c7e033db637fa8358c409cda7d5d31c8018b6d43a7506a309140febaa90c7ce271a79600cdeea40b0a5f278304f7511ccb045cfe6b7b2ac706ada4e6e1
+  metadata.gz: a1975143fb61ac5c6af8ca844416415946babf90240eb6cb6ac52ec40a4a37f606c233d2d60304609066303b4a472026cc2942c7a4b6e2cd750b36c8fa900185
+  data.tar.gz: 500020861e427e9795a78bc242cb80a7755a9e714f6f341c0141496a6292abca62a1fdfbae9420f0d894bc1049e5c11f3c371aa1e95d9cd5cc3eaba1d5eb3fe4

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.2.0 (2026-02-11)
+
+### Added
+
+- `add_body_composition` - upload body scale data (body fat %, muscle mass, etc.) as a FIT file
+- `add_weigh_in_with_timestamps` - add a weigh-in with explicit local and GMT timestamps
+- `delete_weigh_ins` - batch delete all weigh-ins for a given date
+- Typed workout creation helpers:
+  - `create_running_workout`
+  - `create_cycling_workout`
+  - `create_swimming_workout`
+  - `create_walking_workout`
+  - `create_hiking_workout`
+
+### Improved
+
+- Comprehensive test coverage for all 9 API modules (199 examples, up from 48)
+  - User, Health, Activities, Body Composition, Metrics, Devices, Badges, Workouts, Wellness
+
 ## 0.1.0 (2026-02-11)
 
 - Initial release

data/lib/garmin_connect/api/body_composition.rb

@@ -54,6 +54,31 @@ module GarminConnect
         )
       end
 
+      # Add a weigh-in with explicit timestamps.
+      # @param value [Float] weight value
+      # @param date_timestamp [String] local timestamp (e.g., "2026-02-11T08:30:00.000")
+      # @param gmt_timestamp [String] GMT timestamp (e.g., "2026-02-11T14:30:00.000")
+      # @param unit_key [String] "kg" or "lbs"
+      def add_weigh_in_with_timestamps(value, date_timestamp:, gmt_timestamp:, unit_key: "kg")
+        connection.post(
+          "/weight-service/user-weight",
+          body: {
+            "dateTimestamp" => date_timestamp,
+            "gmtTimestamp" => gmt_timestamp,
+            "unitKey" => unit_key,
+            "sourceType" => "MANUAL",
+            "value" => value
+          }
+        )
+      end
+
+      # Upload body composition data as a FIT file.
+      # This is used for full body scale data (body fat %, muscle mass, bone mass, etc.).
+      # @param file_path [String] path to the FIT file containing body composition data
+      def add_body_composition(file_path)
+        connection.upload("/upload-service/upload", file_path: file_path)
+      end
+
       # Delete a specific weigh-in.
       # @param date [Date, String]
       # @param weight_pk [String, Integer] the weigh-in version/pk
@@ -61,6 +86,18 @@ module GarminConnect
         connection.delete("/weight-service/weight/#{format_date(date)}/byversion/#{weight_pk}")
       end
 
+      # Delete all weigh-ins for a specific date.
+      # Fetches all weigh-ins for the day, then deletes each one.
+      # @param date [Date, String]
+      def delete_weigh_ins(date)
+        day_data = daily_weigh_ins(date)
+        entries = day_data&.dig("dateWeightList") || []
+        entries.each do |entry|
+          weight_pk = entry["version"] || entry["samplePk"]
+          delete_weigh_in(date, weight_pk) if weight_pk
+        end
+      end
+
       # --- Hydration ---
 
       # Get daily hydration data.

data/lib/garmin_connect/api/workouts.rb

@@ -39,6 +39,48 @@ module GarminConnect
         connection.get("/workout-service/schedule/#{scheduled_workout_id}")
       end
 
+      # --- Typed Workout Helpers ---
+
+      # Create a running workout.
+      # @param name [String] workout name
+      # @param steps [Array<Hash>] workout step definitions
+      # @param description [String, nil] optional description
+      def create_running_workout(name, steps: [], description: nil)
+        create_typed_workout(name, sport_type: running_sport_type, steps: steps, description: description)
+      end
+
+      # Create a cycling workout.
+      # @param name [String] workout name
+      # @param steps [Array<Hash>] workout step definitions
+      # @param description [String, nil] optional description
+      def create_cycling_workout(name, steps: [], description: nil)
+        create_typed_workout(name, sport_type: cycling_sport_type, steps: steps, description: description)
+      end
+
+      # Create a swimming workout.
+      # @param name [String] workout name
+      # @param steps [Array<Hash>] workout step definitions
+      # @param description [String, nil] optional description
+      def create_swimming_workout(name, steps: [], description: nil)
+        create_typed_workout(name, sport_type: swimming_sport_type, steps: steps, description: description)
+      end
+
+      # Create a walking workout.
+      # @param name [String] workout name
+      # @param steps [Array<Hash>] workout step definitions
+      # @param description [String, nil] optional description
+      def create_walking_workout(name, steps: [], description: nil)
+        create_typed_workout(name, sport_type: walking_sport_type, steps: steps, description: description)
+      end
+
+      # Create a hiking workout.
+      # @param name [String] workout name
+      # @param steps [Array<Hash>] workout step definitions
+      # @param description [String, nil] optional description
+      def create_hiking_workout(name, steps: [], description: nil)
+        create_typed_workout(name, sport_type: hiking_sport_type, steps: steps, description: description)
+      end
+
       # --- Training Plans ---
 
       # Get all available training plans.
@@ -57,6 +99,45 @@ module GarminConnect
       def adaptive_training_plan(plan_id)
         connection.get("/trainingplan-service/trainingplan/fbt-adaptive/#{plan_id}")
       end
+
+      private
+
+      def create_typed_workout(name, sport_type:, steps: [], description: nil)
+        payload = {
+          "workoutName" => name,
+          "sportType" => sport_type,
+          "workoutSegments" => [
+            {
+              "segmentOrder" => 1,
+              "sportType" => sport_type,
+              "workoutSteps" => steps
+            }
+          ]
+        }
+        payload["description"] = description if description
+
+        create_workout(payload)
+      end
+
+      def running_sport_type
+        { "sportTypeId" => 1, "sportTypeKey" => "running" }
+      end
+
+      def cycling_sport_type
+        { "sportTypeId" => 2, "sportTypeKey" => "cycling" }
+      end
+
+      def swimming_sport_type
+        { "sportTypeId" => 5, "sportTypeKey" => "swimming" }
+      end
+
+      def walking_sport_type
+        { "sportTypeId" => 9, "sportTypeKey" => "walking" }
+      end
+
+      def hiking_sport_type
+        { "sportTypeId" => 3, "sportTypeKey" => "hiking" }
+      end
     end
   end
 end

data/lib/garmin_connect/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module GarminConnect
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_garmin_connect
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - DRBragg