go-garminconnect/internal/api/gear.go

package api

import (
	"context"
	"fmt"
	"net/url"
	"strconv"
	"time"
)

// GearStats represents detailed statistics for a gear item
type GearStats struct {
	UUID             string  `json:"uuid"`             // Unique identifier for the gear item
	Name             string  `json:"name"`             // Display name of the gear item
	Distance         float64 `json:"distance"`         // in meters
	TotalActivities  int     `json:"totalActivities"`  // number of activities
	TotalTime        int     `json:"totalTime"`        // in seconds
	Calories         int     `json:"calories"`         // total calories
	ElevationGain    float64 `json:"elevationGain"`    // in meters
	ElevationLoss    float64 `json:"elevationLoss"`    // in meters
}

// GearActivity represents a simplified activity linked to a gear item
type GearActivity struct {
	ActivityID   int64     `json:"activityId"`          // Activity identifier
	ActivityName string    `json:"activityName"`        // Name of the activity
	StartTime    time.Time `json:"startTimeLocal"`      // Local start time of the activity
	Duration     int       `json:"duration"`            // Duration in seconds
	Distance     float64   `json:"distance"`            // Distance in meters
}

// GetGearStats retrieves statistics for a specific gear item by its UUID
func (c *Client) GetGearStats(ctx context.Context, gearUUID string) (GearStats, error) {
	endpoint := fmt.Sprintf("/gear-service/stats/%s", gearUUID)
	
	var stats GearStats
	err := c.Get(ctx, endpoint, &stats)
	if err != nil {
		return GearStats{}, err
	}

	return stats, nil
}

// GetGearActivities retrieves paginated activities associated with a gear item
func (c *Client) GetGearActivities(ctx context.Context, gearUUID string, start, limit int) ([]GearActivity, error) {
	endpoint := fmt.Sprintf("/gear-service/activities/%s", gearUUID)
	params := url.Values{}
	params.Add("start", strconv.Itoa(start))
	params.Add("limit", strconv.Itoa(limit))
	
	u := c.baseURL.ResolveReference(&url.URL{
		Path:     endpoint,
		RawQuery: params.Encode(),
	})
	
	var activities []GearActivity
	err := c.Get(ctx, u.String(), &activities)
	if err != nil {
		return nil, err
	}

	return activities, nil
}