suunto-api-wrapper 1.1.2 → 1.2.2

package/dist/index.d.ts

@@ -86,6 +86,68 @@ declare const DEFAULT_USER_AGENT = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15
 declare function login(options: LoginOptions): Promise<LoginResponse>;
 declare function sessionTokenFrom(response: LoginResponse): string | undefined;
 
+interface UserProfile {
+    username: string;
+    createdDate: number;
+    lastModified: number;
+    lastLogin: number;
+    realName: string;
+    /** ISO 3166-1 alpha-2 country code. */
+    country: string;
+    gender: string;
+    uuid: string;
+    blocked: boolean;
+    showLocale: boolean;
+    followersCount: number;
+    followingCount: number;
+    currentBlobStorageLocation: string;
+    defaultBinaryStorageLocation: string;
+}
+interface UserProfileResponse {
+    error: string | null;
+    payload: UserProfile;
+    metadata: {
+        ts: string;
+    };
+}
+/** User shape returned by the search endpoint (differs slightly from {@link UserProfile}). */
+interface SearchUser {
+    username: string;
+    createdDate: number;
+    lastModified: number;
+    lastLogin: number;
+    /** Absent on some legacy accounts. */
+    realName?: string;
+    /** Free-form profile bio. */
+    description?: string;
+    /** ISO 3166-1 country code. Mostly alpha-2, but legacy records may use alpha-3 (e.g. "FRA"). */
+    country?: string;
+    city?: string;
+    gender: string;
+    uuid: string;
+    imageKey?: string;
+    profileImageUrl?: string;
+    coverImageKey?: string;
+    coverImageUrl?: string;
+    showLocale: boolean;
+    defaultBinaryStorageLocation: string;
+    currentBlobStorageLocation: string;
+    key: string;
+}
+interface UserSearchResult {
+    /** Relationship to the searching user, e.g. "STRANGER". */
+    connection: string;
+    user: SearchUser;
+    workout: unknown | null;
+}
+interface UserSearchResponse {
+    error: string | null;
+    payload: UserSearchResult[];
+    metadata: {
+        ts: string;
+    };
+}
+
 interface GetWorkoutsParams {
     limit?: number;
     sortonst?: boolean;
@@ -95,6 +157,166 @@ interface GetOwnWorkoutsParams {
     offset?: number;
     limit?: number;
 }
+/** Bounding-box query for {@link getWorkoutsWithin}. All coords in decimal degrees. */
+interface GetWorkoutsWithinParams {
+    /** South latitude of the bounding box. */
+    lowerLat: number;
+    /** West longitude of the bounding box. */
+    lowerLng: number;
+    /** North latitude of the bounding box. */
+    upperLat: number;
+    /** East longitude of the bounding box. */
+    upperLng: number;
+    /** Max results. Defaults to 50. */
+    limit?: number;
+}
+/** Suunto activity type IDs returned by the API as `activityId` / `_id`. */
+declare enum SuuntoActivityType {
+    WALKING = 0,
+    RUNNING = 1,
+    CYCLING = 2,
+    CROSS_COUNTRY_SKIING = 3,
+    OTHER_1 = 4,
+    OTHER_2 = 5,
+    OTHER_3 = 6,
+    OTHER_4 = 7,
+    OTHER_5 = 8,
+    OTHER_6 = 9,
+    MOUNTAIN_BIKING = 10,
+    HIKING = 11,
+    ROLLER_SKATING = 12,
+    DOWNHILL_SKIING = 13,
+    PADDLING = 14,
+    ROWING = 15,
+    GOLF = 16,
+    INDOOR = 17,
+    PARKOUR = 18,
+    BALLGAMES = 19,
+    OUTDOOR_GYM = 20,
+    SWIMMING = 21,
+    TRAIL_RUNNING = 22,
+    GYM = 23,
+    NORDIC_WALKING = 24,
+    HORSEBACK_RIDING = 25,
+    MOTOR_SPORTS = 26,
+    SKATEBOARDING = 27,
+    WATER_SPORTS = 28,
+    CLIMBING = 29,
+    SNOWBOARDING = 30,
+    SKI_TOURING = 31,
+    FITNESS_CLASS = 32,
+    SOCCER = 33,
+    TENNIS = 34,
+    BASKETBALL = 35,
+    BADMINTON = 36,
+    BASEBALL = 37,
+    VOLLEYBALL = 38,
+    AMERICAN_FOOTBALL = 39,
+    TABLE_TENNIS = 40,
+    RACQUETBALL = 41,
+    SQUASH = 42,
+    FLOORBALL = 43,
+    HANDBALL = 44,
+    SOFTBALL = 45,
+    BOWLING = 46,
+    CRICKET = 47,
+    RUGBY = 48,
+    ICE_SKATING = 49,
+    ICE_HOCKEY = 50,
+    YOGA = 51,
+    INDOOR_CYCLING = 52,
+    TREADMILL = 53,
+    CROSSFIT = 54,
+    CROSSTRAINER = 55,
+    ROLLER_SKIING = 56,
+    INDOOR_ROWING = 57,
+    STRETCHING = 58,
+    TRACK_AND_FIELD = 59,
+    ORIENTEERING = 60,
+    SUP = 61,
+    COMBAT_SPORTS = 62,
+    KETTLEBELL = 63,
+    DANCING = 64,
+    SNOWSHOEING = 65,
+    FRISBEE_GOLF = 66,
+    FUTSAL = 67,
+    MULTISPORT = 68,
+    AEROBICS = 69,
+    TREKKING = 70,
+    SAILING = 71,
+    KAYAKING = 72,
+    CIRCUIT_TRAINING = 73,
+    TRIATHLON = 74,
+    PADEL = 75,
+    CHEERLEADING = 76,
+    BOXING = 77,
+    SCUBADIVING = 78,
+    FREEDIVING = 79,
+    ADVENTURE_RACING = 80,
+    GYMNASTICS = 81,
+    CANOEING = 82,
+    MOUNTAINEERING = 83,
+    TELEMARKSKIING = 84,
+    OPENWATER_SWIMMING = 85,
+    WINDSURFING = 86,
+    KITESURFING_KITING = 87,
+    PARAGLIDING = 88,
+    SNORKELING = 90,
+    SURFING = 91,
+    SWIMRUN = 92,
+    DUATHLON = 93,
+    AQUATHLON = 94,
+    OBSTACLE_RACING = 95,
+    FISHING = 96,
+    HUNTING = 97,
+    GRAVEL_CYCLING = 99,
+    MERMAIDING = 100,
+    SPEARFISHING = 101,
+    JUMP_ROPE = 102,
+    TRACK_RUNNING = 103,
+    CALISTHENICS = 104,
+    E_BIKING = 105,
+    E_MTB = 106,
+    BACKCOUNTRY_SKIING = 107,
+    WHEELCHAIR = 108,
+    HAND_CYCLING = 109,
+    SPLIT_BOARDING = 110,
+    BIATHLON = 111,
+    MEDITATION = 112,
+    FIELD_HOCKEY = 113,
+    CYCLOCROSS = 114,
+    VERTICAL_RUN = 115,
+    SKI_MOUNTAINEERING = 116,
+    SKATE_SKIING = 117,
+    CLASSIC_SKIING = 118,
+    CHORES = 119,
+    PILATES = 120,
+    NEW_YOGA = 121
+}
+/** Valid values for the `extensions` query param on the single-workout endpoint. */
+declare enum WorkoutExtensionName {
+    Dive = "DiveExtension",
+    JumpRope = "JumpRopeExtension",
+    Summary = "SummaryExtension",
+    Swimming = "SwimmingExtension",
+    Weather = "WeatherExtension",
+    Workout = "WorkoutExtension",
+    CompetitionHeader = "CompetitionHeaderExtension"
+}
+/** Valid values for the `additionalData` query param on the single-workout endpoint. */
+declare enum WorkoutAdditionalData {
+    Achievements = "achievements",
+    Photos = "photos",
+    Videos = "videos",
+    Comments = "comments",
+    UserReacted = "user_reacted"
+}
+interface GetWorkoutParams {
+    /** Extensions to include in the response. Defaults to `[Summary, CompetitionHeader]`. */
+    extensions?: WorkoutExtensionName[];
+    /** Extra data blocks to include. Defaults to all five values. */
+    additionalData?: WorkoutAdditionalData[];
+}
 /** GPS coordinate: x = longitude, y = latitude. */
 interface Position {
     x: number;
@@ -288,8 +510,7 @@ type WorkoutExtension = FitnessExtension | IntensityExtension | SummaryExtension
 interface Workout {
     username: string;
     sharingFlags: number;
-    /** Suunto activity type ID (e.g. 2 = cycling, 11 = trail running, 21 = pool swim, 36 = gym, 99 = other). */
-    activityId: number;
+    activityId: SuuntoActivityType;
     key: string;
     startTime: number;
     stopTime: number;
@@ -317,7 +538,8 @@ interface Workout {
     tss: TssEntry;
     tssList: TssEntry[];
     suuntoTags: string[];
-    clientCalculatedAchievements: ClientCalculatedAchievements;
+    /** Absent on some workouts (e.g. when the user has no achievements yet). */
+    clientCalculatedAchievements?: ClientCalculatedAchievements;
     workoutKey: string;
     visibilityFacebook: boolean;
     visibilityTwitter: boolean;
@@ -346,6 +568,16 @@ interface Workout {
     comments?: WorkoutComment[];
     /** Only present when reactionCount > 0. */
     reactions?: WorkoutReaction[];
+    /** Owner's display name. Returned on feed-style endpoints (e.g. `within`). */
+    fullname?: string;
+    /** Owner's profile picture URL. Returned on feed-style endpoints. */
+    userPhoto?: string;
+    /** Owner's cover photo URL. Returned on feed-style endpoints. */
+    coverPhoto?: string;
+    /** Free-text achievement labels (e.g. "Fastest time on this route"). */
+    achievements?: string[];
+    /** Average power, watts. Mirrors `SummaryExtension.avgPower` on feed responses. */
+    avgPower?: number;
 }
 interface WorkoutsResponse {
     error: string | null;
@@ -355,76 +587,99 @@ interface WorkoutsResponse {
         until: string;
     };
 }
-
-declare function getWorkouts(client: HttpClient, username: string, params?: GetWorkoutsParams): Promise<WorkoutsResponse>;
-declare function getOwnWorkouts(client: HttpClient, params?: GetOwnWorkoutsParams): Promise<WorkoutsResponse>;
-/** Workout endpoints, bound to an {@link HttpClient}. Accessed via `suunto.workouts`. */
-declare class WorkoutsResource {
-    private readonly client;
-    constructor(client: HttpClient);
-    /** The authenticated user's own workouts. */
-    own(params?: GetOwnWorkoutsParams): Promise<WorkoutsResponse>;
-    /** A given user's public workouts. */
-    public(username: string, params?: GetWorkoutsParams): Promise<WorkoutsResponse>;
+interface WorkoutResponse {
+    error: string | null;
+    payload: Workout;
+    metadata: Record<string, unknown>;
 }
-
-interface UserProfile {
-    username: string;
-    createdDate: number;
-    lastModified: number;
-    lastLogin: number;
-    realName: string;
-    /** ISO 3166-1 alpha-2 country code. */
-    country: string;
-    gender: string;
-    uuid: string;
-    blocked: boolean;
-    showLocale: boolean;
-    followersCount: number;
-    followingCount: number;
-    currentBlobStorageLocation: string;
-    defaultBinaryStorageLocation: string;
+/** Single item from the {@link getWorkoutsWithin} feed: owner + workout. */
+interface WorkoutsWithinItem {
+    user: SearchUser;
+    workout: Workout;
 }
-interface UserProfileResponse {
+interface WorkoutsWithinResponse {
     error: string | null;
-    payload: UserProfile;
+    payload: WorkoutsWithinItem[];
     metadata: {
-        ts: string;
+        workoutcount: string;
     };
 }
-/** User shape returned by the search endpoint (differs slightly from {@link UserProfile}). */
-interface SearchUser {
-    username: string;
-    createdDate: number;
-    lastModified: number;
-    lastLogin: number;
-    realName: string;
-    /** ISO 3166-1 country code. Mostly alpha-2, but legacy records may use alpha-3 (e.g. "FRA"). */
-    country?: string;
-    city?: string;
-    gender: string;
-    uuid: string;
-    imageKey?: string;
-    profileImageUrl?: string;
-    showLocale: boolean;
-    defaultBinaryStorageLocation: string;
-    currentBlobStorageLocation: string;
-    key: string;
-}
-interface UserSearchResult {
-    /** Relationship to the searching user, e.g. "STRANGER". */
-    connection: string;
-    user: SearchUser;
-    workout: unknown | null;
+/** Aggregated totals for a single activity type. */
+interface WorkoutStatsEntry {
+    /** Suunto activity type ID this entry aggregates. */
+    _id: SuuntoActivityType;
+    /** Metres. */
+    totalDistance: number;
+    /** Seconds. */
+    totalTime: number;
+    /** Kilocalories. */
+    energyConsumption: number;
+    /** Number of workouts of this activity. */
+    numberOfWorkouts: number;
+    /** Metres. Only meaningful for dives. */
+    maxDepth: number;
+}
+interface WorkoutStats {
+    /** Sum of distances across all activities, in metres. */
+    totalDistanceSum: number;
+    /** Sum of times across all activities, in seconds. */
+    totalTimeSum: number;
+    /** Sum of energy consumption across all activities, in kilocalories. */
+    totalEnergyConsumptionSum: number;
+    /** Total workout count across all activities. */
+    totalNumberOfWorkoutsSum: number;
+    /** Number of distinct days that have at least one workout. */
+    totalDays: number;
+    /**
+     * Per-activity aggregates, restricted to a curated set of activity types
+     * (the ones the official UI surfaces as headline cards).
+     */
+    allStats: WorkoutStatsEntry[];
+    /** Per-activity aggregates covering every activity type the user has recorded. */
+    allActualStats: WorkoutStatsEntry[];
 }
-interface UserSearchResponse {
+interface WorkoutStatsResponse {
     error: string | null;
-    payload: UserSearchResult[];
+    payload: WorkoutStats;
     metadata: {
         ts: string;
     };
 }
 
+declare function getWorkouts(client: HttpClient, username: string, params?: GetWorkoutsParams): Promise<WorkoutsResponse>;
+declare function getOwnWorkouts(client: HttpClient, params?: GetOwnWorkoutsParams): Promise<WorkoutsResponse>;
+/**
+ * Public workouts whose center position falls inside the given geographic
+ * bounding box. Used by the "explore nearby" map view. Unauthenticated.
+ */
+declare function getWorkoutsWithin(client: HttpClient, params: GetWorkoutsWithinParams): Promise<WorkoutsWithinResponse>;
+/**
+ * Aggregated workout stats per activity for a user. Unauthenticated — no
+ * session required.
+ */
+declare function getWorkoutStats(client: HttpClient, username: string): Promise<WorkoutStatsResponse>;
+/** Workout endpoints, bound to an {@link HttpClient}. Accessed via `suunto.workouts`. */
+declare class WorkoutsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** The authenticated user's own workouts. */
+    own(params?: GetOwnWorkoutsParams): Promise<WorkoutsResponse>;
+    /** A given user's public workouts. */
+    public(username: string, params?: GetWorkoutsParams): Promise<WorkoutsResponse>;
+    /**
+     * A single workout by username and workout key. Works for any public workout
+     * and, when the client is authenticated as the owner, for private ones too.
+     */
+    byKey(username: string, workoutKey: string, params?: GetWorkoutParams): Promise<WorkoutResponse>;
+    /**
+     * Aggregated workout stats per activity for the given user. Works
+     * unauthenticated.
+     */
+    stats(username: string): Promise<WorkoutStatsResponse>;
+    /** Public workouts whose center falls inside a geographic bounding box. */
+    within(params: GetWorkoutsWithinParams): Promise<WorkoutsWithinResponse>;
+}
+
 /**
  * Fetch a user's public profile by username. Unauthenticated — no session
  * required.
@@ -508,4 +763,4 @@ declare class SuuntoClient {
     static unauthenticated(options?: Omit<SuuntoClientOptions, "email" | "sessionKey">): SuuntoClient;
 }
 
-export { type ActivityCounts, type Cadence, type ClientCalculatedAchievements, type CumulativeAchievement, DEFAULT_USER_AGENT, type FitnessExtension, type Gear, GearResource, type GearResponse, type GearSummary, type GetLatestGearParams, type GetOwnWorkoutsParams, type GetWorkoutsParams, type HeartRateRecovery, type HrData, HttpClient, type HttpClientOptions, HttpError, type HttpResponse, type IntensityExtension, type IntensityZone, type IntensityZones, type LoginOptions, type LoginResponse, type PersonalBestAchievement, type Position, type Query, type Rankings, type RequestBody, type RequestContext, type RequestOptions, type RouteRanking, SPORTS_TRACKER_API, type SearchUser, type SummaryExtension, SuuntoClient, type SuuntoClientOptions, type SwimmingHeaderExtension, type TssEntry, type UserProfile, type UserProfileResponse, type UserSearchResponse, type UserSearchResult, UsersResource, type WeatherExtension, type Workout, type WorkoutComment, type WorkoutExtension, type WorkoutReaction, WorkoutsResource, type WorkoutsResponse, generateXtotp, getLatestGear, getOwnWorkouts, getUserByName, getWorkouts, login, searchUsers, secondsUntilRollover, sessionTokenFrom };
+export { type ActivityCounts, type Cadence, type ClientCalculatedAchievements, type CumulativeAchievement, DEFAULT_USER_AGENT, type FitnessExtension, type Gear, GearResource, type GearResponse, type GearSummary, type GetLatestGearParams, type GetOwnWorkoutsParams, type GetWorkoutsParams, type GetWorkoutsWithinParams, type HeartRateRecovery, type HrData, HttpClient, type HttpClientOptions, HttpError, type HttpResponse, type IntensityExtension, type IntensityZone, type IntensityZones, type LoginOptions, type LoginResponse, type PersonalBestAchievement, type Position, type Query, type Rankings, type RequestBody, type RequestContext, type RequestOptions, type RouteRanking, SPORTS_TRACKER_API, type SearchUser, type SummaryExtension, SuuntoActivityType, SuuntoClient, type SuuntoClientOptions, type SwimmingHeaderExtension, type TssEntry, type UserProfile, type UserProfileResponse, type UserSearchResponse, type UserSearchResult, UsersResource, type WeatherExtension, type Workout, type WorkoutComment, type WorkoutExtension, type WorkoutReaction, type WorkoutStats, type WorkoutStatsEntry, type WorkoutStatsResponse, WorkoutsResource, type WorkoutsResponse, type WorkoutsWithinItem, type WorkoutsWithinResponse, generateXtotp, getLatestGear, getOwnWorkouts, getUserByName, getWorkoutStats, getWorkouts, getWorkoutsWithin, login, searchUsers, secondsUntilRollover, sessionTokenFrom };

package/dist/index.js

@@ -25,6 +25,7 @@ __export(index_exports, {
   HttpClient: () => HttpClient,
   HttpError: () => HttpError,
   SPORTS_TRACKER_API: () => SPORTS_TRACKER_API,
+  SuuntoActivityType: () => SuuntoActivityType,
   SuuntoClient: () => SuuntoClient,
   UsersResource: () => UsersResource,
   WorkoutsResource: () => WorkoutsResource,
@@ -32,7 +33,9 @@ __export(index_exports, {
   getLatestGear: () => getLatestGear,
   getOwnWorkouts: () => getOwnWorkouts,
   getUserByName: () => getUserByName,
+  getWorkoutStats: () => getWorkoutStats,
   getWorkouts: () => getWorkouts,
+  getWorkoutsWithin: () => getWorkoutsWithin,
   login: () => login,
   searchUsers: () => searchUsers,
   secondsUntilRollover: () => secondsUntilRollover,
@@ -290,7 +293,143 @@ function sessionTokenFrom(response) {
   return response.sessionkey;
 }
 
+// src/workouts/types.ts
+var SuuntoActivityType = /* @__PURE__ */ ((SuuntoActivityType2) => {
+  SuuntoActivityType2[SuuntoActivityType2["WALKING"] = 0] = "WALKING";
+  SuuntoActivityType2[SuuntoActivityType2["RUNNING"] = 1] = "RUNNING";
+  SuuntoActivityType2[SuuntoActivityType2["CYCLING"] = 2] = "CYCLING";
+  SuuntoActivityType2[SuuntoActivityType2["CROSS_COUNTRY_SKIING"] = 3] = "CROSS_COUNTRY_SKIING";
+  SuuntoActivityType2[SuuntoActivityType2["OTHER_1"] = 4] = "OTHER_1";
+  SuuntoActivityType2[SuuntoActivityType2["OTHER_2"] = 5] = "OTHER_2";
+  SuuntoActivityType2[SuuntoActivityType2["OTHER_3"] = 6] = "OTHER_3";
+  SuuntoActivityType2[SuuntoActivityType2["OTHER_4"] = 7] = "OTHER_4";
+  SuuntoActivityType2[SuuntoActivityType2["OTHER_5"] = 8] = "OTHER_5";
+  SuuntoActivityType2[SuuntoActivityType2["OTHER_6"] = 9] = "OTHER_6";
+  SuuntoActivityType2[SuuntoActivityType2["MOUNTAIN_BIKING"] = 10] = "MOUNTAIN_BIKING";
+  SuuntoActivityType2[SuuntoActivityType2["HIKING"] = 11] = "HIKING";
+  SuuntoActivityType2[SuuntoActivityType2["ROLLER_SKATING"] = 12] = "ROLLER_SKATING";
+  SuuntoActivityType2[SuuntoActivityType2["DOWNHILL_SKIING"] = 13] = "DOWNHILL_SKIING";
+  SuuntoActivityType2[SuuntoActivityType2["PADDLING"] = 14] = "PADDLING";
+  SuuntoActivityType2[SuuntoActivityType2["ROWING"] = 15] = "ROWING";
+  SuuntoActivityType2[SuuntoActivityType2["GOLF"] = 16] = "GOLF";
+  SuuntoActivityType2[SuuntoActivityType2["INDOOR"] = 17] = "INDOOR";
+  SuuntoActivityType2[SuuntoActivityType2["PARKOUR"] = 18] = "PARKOUR";
+  SuuntoActivityType2[SuuntoActivityType2["BALLGAMES"] = 19] = "BALLGAMES";
+  SuuntoActivityType2[SuuntoActivityType2["OUTDOOR_GYM"] = 20] = "OUTDOOR_GYM";
+  SuuntoActivityType2[SuuntoActivityType2["SWIMMING"] = 21] = "SWIMMING";
+  SuuntoActivityType2[SuuntoActivityType2["TRAIL_RUNNING"] = 22] = "TRAIL_RUNNING";
+  SuuntoActivityType2[SuuntoActivityType2["GYM"] = 23] = "GYM";
+  SuuntoActivityType2[SuuntoActivityType2["NORDIC_WALKING"] = 24] = "NORDIC_WALKING";
+  SuuntoActivityType2[SuuntoActivityType2["HORSEBACK_RIDING"] = 25] = "HORSEBACK_RIDING";
+  SuuntoActivityType2[SuuntoActivityType2["MOTOR_SPORTS"] = 26] = "MOTOR_SPORTS";
+  SuuntoActivityType2[SuuntoActivityType2["SKATEBOARDING"] = 27] = "SKATEBOARDING";
+  SuuntoActivityType2[SuuntoActivityType2["WATER_SPORTS"] = 28] = "WATER_SPORTS";
+  SuuntoActivityType2[SuuntoActivityType2["CLIMBING"] = 29] = "CLIMBING";
+  SuuntoActivityType2[SuuntoActivityType2["SNOWBOARDING"] = 30] = "SNOWBOARDING";
+  SuuntoActivityType2[SuuntoActivityType2["SKI_TOURING"] = 31] = "SKI_TOURING";
+  SuuntoActivityType2[SuuntoActivityType2["FITNESS_CLASS"] = 32] = "FITNESS_CLASS";
+  SuuntoActivityType2[SuuntoActivityType2["SOCCER"] = 33] = "SOCCER";
+  SuuntoActivityType2[SuuntoActivityType2["TENNIS"] = 34] = "TENNIS";
+  SuuntoActivityType2[SuuntoActivityType2["BASKETBALL"] = 35] = "BASKETBALL";
+  SuuntoActivityType2[SuuntoActivityType2["BADMINTON"] = 36] = "BADMINTON";
+  SuuntoActivityType2[SuuntoActivityType2["BASEBALL"] = 37] = "BASEBALL";
+  SuuntoActivityType2[SuuntoActivityType2["VOLLEYBALL"] = 38] = "VOLLEYBALL";
+  SuuntoActivityType2[SuuntoActivityType2["AMERICAN_FOOTBALL"] = 39] = "AMERICAN_FOOTBALL";
+  SuuntoActivityType2[SuuntoActivityType2["TABLE_TENNIS"] = 40] = "TABLE_TENNIS";
+  SuuntoActivityType2[SuuntoActivityType2["RACQUETBALL"] = 41] = "RACQUETBALL";
+  SuuntoActivityType2[SuuntoActivityType2["SQUASH"] = 42] = "SQUASH";
+  SuuntoActivityType2[SuuntoActivityType2["FLOORBALL"] = 43] = "FLOORBALL";
+  SuuntoActivityType2[SuuntoActivityType2["HANDBALL"] = 44] = "HANDBALL";
+  SuuntoActivityType2[SuuntoActivityType2["SOFTBALL"] = 45] = "SOFTBALL";
+  SuuntoActivityType2[SuuntoActivityType2["BOWLING"] = 46] = "BOWLING";
+  SuuntoActivityType2[SuuntoActivityType2["CRICKET"] = 47] = "CRICKET";
+  SuuntoActivityType2[SuuntoActivityType2["RUGBY"] = 48] = "RUGBY";
+  SuuntoActivityType2[SuuntoActivityType2["ICE_SKATING"] = 49] = "ICE_SKATING";
+  SuuntoActivityType2[SuuntoActivityType2["ICE_HOCKEY"] = 50] = "ICE_HOCKEY";
+  SuuntoActivityType2[SuuntoActivityType2["YOGA"] = 51] = "YOGA";
+  SuuntoActivityType2[SuuntoActivityType2["INDOOR_CYCLING"] = 52] = "INDOOR_CYCLING";
+  SuuntoActivityType2[SuuntoActivityType2["TREADMILL"] = 53] = "TREADMILL";
+  SuuntoActivityType2[SuuntoActivityType2["CROSSFIT"] = 54] = "CROSSFIT";
+  SuuntoActivityType2[SuuntoActivityType2["CROSSTRAINER"] = 55] = "CROSSTRAINER";
+  SuuntoActivityType2[SuuntoActivityType2["ROLLER_SKIING"] = 56] = "ROLLER_SKIING";
+  SuuntoActivityType2[SuuntoActivityType2["INDOOR_ROWING"] = 57] = "INDOOR_ROWING";
+  SuuntoActivityType2[SuuntoActivityType2["STRETCHING"] = 58] = "STRETCHING";
+  SuuntoActivityType2[SuuntoActivityType2["TRACK_AND_FIELD"] = 59] = "TRACK_AND_FIELD";
+  SuuntoActivityType2[SuuntoActivityType2["ORIENTEERING"] = 60] = "ORIENTEERING";
+  SuuntoActivityType2[SuuntoActivityType2["SUP"] = 61] = "SUP";
+  SuuntoActivityType2[SuuntoActivityType2["COMBAT_SPORTS"] = 62] = "COMBAT_SPORTS";
+  SuuntoActivityType2[SuuntoActivityType2["KETTLEBELL"] = 63] = "KETTLEBELL";
+  SuuntoActivityType2[SuuntoActivityType2["DANCING"] = 64] = "DANCING";
+  SuuntoActivityType2[SuuntoActivityType2["SNOWSHOEING"] = 65] = "SNOWSHOEING";
+  SuuntoActivityType2[SuuntoActivityType2["FRISBEE_GOLF"] = 66] = "FRISBEE_GOLF";
+  SuuntoActivityType2[SuuntoActivityType2["FUTSAL"] = 67] = "FUTSAL";
+  SuuntoActivityType2[SuuntoActivityType2["MULTISPORT"] = 68] = "MULTISPORT";
+  SuuntoActivityType2[SuuntoActivityType2["AEROBICS"] = 69] = "AEROBICS";
+  SuuntoActivityType2[SuuntoActivityType2["TREKKING"] = 70] = "TREKKING";
+  SuuntoActivityType2[SuuntoActivityType2["SAILING"] = 71] = "SAILING";
+  SuuntoActivityType2[SuuntoActivityType2["KAYAKING"] = 72] = "KAYAKING";
+  SuuntoActivityType2[SuuntoActivityType2["CIRCUIT_TRAINING"] = 73] = "CIRCUIT_TRAINING";
+  SuuntoActivityType2[SuuntoActivityType2["TRIATHLON"] = 74] = "TRIATHLON";
+  SuuntoActivityType2[SuuntoActivityType2["PADEL"] = 75] = "PADEL";
+  SuuntoActivityType2[SuuntoActivityType2["CHEERLEADING"] = 76] = "CHEERLEADING";
+  SuuntoActivityType2[SuuntoActivityType2["BOXING"] = 77] = "BOXING";
+  SuuntoActivityType2[SuuntoActivityType2["SCUBADIVING"] = 78] = "SCUBADIVING";
+  SuuntoActivityType2[SuuntoActivityType2["FREEDIVING"] = 79] = "FREEDIVING";
+  SuuntoActivityType2[SuuntoActivityType2["ADVENTURE_RACING"] = 80] = "ADVENTURE_RACING";
+  SuuntoActivityType2[SuuntoActivityType2["GYMNASTICS"] = 81] = "GYMNASTICS";
+  SuuntoActivityType2[SuuntoActivityType2["CANOEING"] = 82] = "CANOEING";
+  SuuntoActivityType2[SuuntoActivityType2["MOUNTAINEERING"] = 83] = "MOUNTAINEERING";
+  SuuntoActivityType2[SuuntoActivityType2["TELEMARKSKIING"] = 84] = "TELEMARKSKIING";
+  SuuntoActivityType2[SuuntoActivityType2["OPENWATER_SWIMMING"] = 85] = "OPENWATER_SWIMMING";
+  SuuntoActivityType2[SuuntoActivityType2["WINDSURFING"] = 86] = "WINDSURFING";
+  SuuntoActivityType2[SuuntoActivityType2["KITESURFING_KITING"] = 87] = "KITESURFING_KITING";
+  SuuntoActivityType2[SuuntoActivityType2["PARAGLIDING"] = 88] = "PARAGLIDING";
+  SuuntoActivityType2[SuuntoActivityType2["SNORKELING"] = 90] = "SNORKELING";
+  SuuntoActivityType2[SuuntoActivityType2["SURFING"] = 91] = "SURFING";
+  SuuntoActivityType2[SuuntoActivityType2["SWIMRUN"] = 92] = "SWIMRUN";
+  SuuntoActivityType2[SuuntoActivityType2["DUATHLON"] = 93] = "DUATHLON";
+  SuuntoActivityType2[SuuntoActivityType2["AQUATHLON"] = 94] = "AQUATHLON";
+  SuuntoActivityType2[SuuntoActivityType2["OBSTACLE_RACING"] = 95] = "OBSTACLE_RACING";
+  SuuntoActivityType2[SuuntoActivityType2["FISHING"] = 96] = "FISHING";
+  SuuntoActivityType2[SuuntoActivityType2["HUNTING"] = 97] = "HUNTING";
+  SuuntoActivityType2[SuuntoActivityType2["GRAVEL_CYCLING"] = 99] = "GRAVEL_CYCLING";
+  SuuntoActivityType2[SuuntoActivityType2["MERMAIDING"] = 100] = "MERMAIDING";
+  SuuntoActivityType2[SuuntoActivityType2["SPEARFISHING"] = 101] = "SPEARFISHING";
+  SuuntoActivityType2[SuuntoActivityType2["JUMP_ROPE"] = 102] = "JUMP_ROPE";
+  SuuntoActivityType2[SuuntoActivityType2["TRACK_RUNNING"] = 103] = "TRACK_RUNNING";
+  SuuntoActivityType2[SuuntoActivityType2["CALISTHENICS"] = 104] = "CALISTHENICS";
+  SuuntoActivityType2[SuuntoActivityType2["E_BIKING"] = 105] = "E_BIKING";
+  SuuntoActivityType2[SuuntoActivityType2["E_MTB"] = 106] = "E_MTB";
+  SuuntoActivityType2[SuuntoActivityType2["BACKCOUNTRY_SKIING"] = 107] = "BACKCOUNTRY_SKIING";
+  SuuntoActivityType2[SuuntoActivityType2["WHEELCHAIR"] = 108] = "WHEELCHAIR";
+  SuuntoActivityType2[SuuntoActivityType2["HAND_CYCLING"] = 109] = "HAND_CYCLING";
+  SuuntoActivityType2[SuuntoActivityType2["SPLIT_BOARDING"] = 110] = "SPLIT_BOARDING";
+  SuuntoActivityType2[SuuntoActivityType2["BIATHLON"] = 111] = "BIATHLON";
+  SuuntoActivityType2[SuuntoActivityType2["MEDITATION"] = 112] = "MEDITATION";
+  SuuntoActivityType2[SuuntoActivityType2["FIELD_HOCKEY"] = 113] = "FIELD_HOCKEY";
+  SuuntoActivityType2[SuuntoActivityType2["CYCLOCROSS"] = 114] = "CYCLOCROSS";
+  SuuntoActivityType2[SuuntoActivityType2["VERTICAL_RUN"] = 115] = "VERTICAL_RUN";
+  SuuntoActivityType2[SuuntoActivityType2["SKI_MOUNTAINEERING"] = 116] = "SKI_MOUNTAINEERING";
+  SuuntoActivityType2[SuuntoActivityType2["SKATE_SKIING"] = 117] = "SKATE_SKIING";
+  SuuntoActivityType2[SuuntoActivityType2["CLASSIC_SKIING"] = 118] = "CLASSIC_SKIING";
+  SuuntoActivityType2[SuuntoActivityType2["CHORES"] = 119] = "CHORES";
+  SuuntoActivityType2[SuuntoActivityType2["PILATES"] = 120] = "PILATES";
+  SuuntoActivityType2[SuuntoActivityType2["NEW_YOGA"] = 121] = "NEW_YOGA";
+  return SuuntoActivityType2;
+})(SuuntoActivityType || {});
+
 // src/workouts/index.ts
+var DEFAULT_WORKOUT_EXTENSIONS = [
+  "SummaryExtension" /* Summary */,
+  "CompetitionHeaderExtension" /* CompetitionHeader */
+];
+var DEFAULT_WORKOUT_ADDITIONAL_DATA = [
+  "achievements" /* Achievements */,
+  "photos" /* Photos */,
+  "videos" /* Videos */,
+  "comments" /* Comments */,
+  "user_reacted" /* UserReacted */
+];
 async function getWorkouts(client, username, params = {}) {
   const { limit = 40, sortonst = true } = params;
   const res = await client.get(
@@ -310,6 +449,44 @@ async function getOwnWorkouts(client, params = {}) {
   );
   return res.data;
 }
+async function getWorkout(client, username, workoutKey, params = {}) {
+  const {
+    extensions = DEFAULT_WORKOUT_EXTENSIONS,
+    additionalData = DEFAULT_WORKOUT_ADDITIONAL_DATA
+  } = params;
+  const res = await client.get(
+    `/apiserver/v2/workouts/${encodeURIComponent(username)}/${encodeURIComponent(workoutKey)}/combined`,
+    {
+      query: {
+        extensions: extensions.join(","),
+        additionalData: additionalData.join(",")
+      }
+    }
+  );
+  return res.data;
+}
+async function getWorkoutsWithin(client, params) {
+  const { lowerLat, lowerLng, upperLat, upperLng, limit = 50 } = params;
+  const res = await client.get(
+    "/apiserver/v1/workouts/public/within",
+    {
+      query: {
+        lowerlat: lowerLat,
+        lowerlng: lowerLng,
+        upperlat: upperLat,
+        upperlng: upperLng,
+        limit
+      }
+    }
+  );
+  return res.data;
+}
+async function getWorkoutStats(client, username) {
+  const res = await client.get(
+    `/apiserver/v1/workouts/${encodeURIComponent(username)}/stats`
+  );
+  return res.data;
+}
 var WorkoutsResource = class {
   constructor(client) {
     this.client = client;
@@ -322,6 +499,24 @@ var WorkoutsResource = class {
   public(username, params) {
     return getWorkouts(this.client, username, params);
   }
+  /**
+   * A single workout by username and workout key. Works for any public workout
+   * and, when the client is authenticated as the owner, for private ones too.
+   */
+  byKey(username, workoutKey, params) {
+    return getWorkout(this.client, username, workoutKey, params);
+  }
+  /**
+   * Aggregated workout stats per activity for the given user. Works
+   * unauthenticated.
+   */
+  stats(username) {
+    return getWorkoutStats(this.client, username);
+  }
+  /** Public workouts whose center falls inside a geographic bounding box. */
+  within(params) {
+    return getWorkoutsWithin(this.client, params);
+  }
 };
 
 // src/users/index.ts
@@ -417,6 +612,7 @@ var SuuntoClient = class _SuuntoClient {
   HttpClient,
   HttpError,
   SPORTS_TRACKER_API,
+  SuuntoActivityType,
   SuuntoClient,
   UsersResource,
   WorkoutsResource,
@@ -424,7 +620,9 @@ var SuuntoClient = class _SuuntoClient {
   getLatestGear,
   getOwnWorkouts,
   getUserByName,
+  getWorkoutStats,
   getWorkouts,
+  getWorkoutsWithin,
   login,
   searchUsers,
   secondsUntilRollover,