Class ActivityService

Service for activity-related operations.

IMPORTANT: Single-activity endpoints use /activity/{activityId} (no athlete prefix). List/upload endpoints use /athlete/{athleteId}/activities.

Constructors

constructor

new ActivityService(
httpClient: IHttpClient,
defaultAthleteId: string,
): ActivityService
Parameters
- httpClient: IHttpClient
- defaultAthleteId: string
Returns ActivityService
- Defined in services/activity.service.ts:18

Methods

createManualActivitiesBulk

createManualActivitiesBulk(
data: Partial<Activity>[],
athleteId?: string,
): Promise<Activity[]>
Create multiple manual activities (upsert on external_id)
Parameters
- data: Partial<Activity>[]
- OptionalathleteId: string
Returns Promise<Activity[]>
- Defined in services/activity.service.ts:58

createManualActivity

createManualActivity(
data: Partial<Activity>,
athleteId?: string,
): Promise<Activity>
Create a manual activity
Parameters
- data: Partial<Activity>
- OptionalathleteId: string
Returns Promise<Activity>
- Defined in services/activity.service.ts:52

deleteActivity

deleteActivity(activityId: string): Promise<ActivityId>
Delete an activity
Parameters
- activityId: string
Returns Promise<ActivityId>
- Defined in services/activity.service.ts:87

deleteIntervals

deleteIntervals(activityId: string, data: Interval[]): Promise<IntervalsDTO>
Delete intervals
Parameters
- activityId: string
- data: Interval[]
Returns Promise<IntervalsDTO>
- Defined in services/activity.service.ts:132

deleteTombstone

deleteTombstone(activityId: string): Promise<void>
Remove the tombstone left by a deleted activity so the same file can be re-uploaded The id is URL-encoded: this route is destructive, and an unencoded delimiter (e.g. a trailing "#") would turn it into DELETE /activity/{id}.
Parameters
- activityId: string
Returns Promise<void>
- Defined in services/activity.service.ts:279

downloadActivitiesCSV

downloadActivitiesCSV(athleteId?: string): Promise<Buffer<ArrayBufferLike>>
All activities as CSV
Parameters
- OptionalathleteId: string
Returns Promise<Buffer<ArrayBufferLike>>
- Defined in services/activity.service.ts:265

downloadFile

downloadFile(activityId: string): Promise<Buffer<ArrayBufferLike>>
Download the original activity file (gzip compressed)
Parameters
- activityId: string
Returns Promise<Buffer<ArrayBufferLike>>
- Defined in services/activity.service.ts:144

downloadFitFile

downloadFitFile(activityId: string): Promise<Buffer<ArrayBufferLike>>
Download the Intervals.icu generated fit file
Parameters
- activityId: string
Returns Promise<Buffer<ArrayBufferLike>>
- Defined in services/activity.service.ts:149

downloadFitFiles

downloadFitFiles(
    activityIds: string[],
    options?: { hr?: boolean; power?: boolean },
    athleteId?: string,
): Promise<Buffer<ArrayBufferLike>>
Download a zip of Intervals.icu-generated FIT files for the given activities. The API exposes this as POST with query parameters (see AUDIT.md). ids is a comma-joined value, confirmed live against the real API (see AUDIT.md).
Parameters
- activityIds: string[]
- Optionaloptions: { hr?: boolean; power?: boolean }
- OptionalathleteId: string
Returns Promise<Buffer<ArrayBufferLike>>
- Defined in services/activity.service.ts:68

downloadGPX

downloadGPX(
activityId: string,
options?: { hr?: boolean; power?: boolean },
): Promise<Buffer<ArrayBufferLike>>
The activity as a GPX file, optionally with power and heart-rate extensions
Parameters
- activityId: string
- Optionaloptions: { hr?: boolean; power?: boolean }
Returns Promise<Buffer<ArrayBufferLike>>
- Defined in services/activity.service.ts:271

getActivities

getActivities(
    ids: string[],
    options?: { intervals?: boolean },
    athleteId?: string,
): Promise<Activity[]>
Fetch multiple activities by id in one call. Ids the athlete does not own are ignored.
Parameters
- ids: string[]
- Optionaloptions: { intervals?: boolean }
- OptionalathleteId: string
Returns Promise<Activity[]>
- Defined in services/activity.service.ts:217

getActivity

getActivity(
activityId: string,
options?: { intervals?: boolean },
): Promise<Activity>
Get an activity
Parameters
- activityId: string
- Optionaloptions: { intervals?: boolean }
Returns Promise<Activity>
- Defined in services/activity.service.ts:77

getBestEfforts

getBestEfforts(activityId: string): Promise<BestEfforts>
Get best efforts for an activity
Parameters
- activityId: string
Returns Promise<BestEfforts>
- Defined in services/activity.service.ts:183

getHRCurve

getHRCurve(activityId: string): Promise<unknown>
Get HR curve for an activity
Parameters
- activityId: string
Returns Promise<unknown>
- Defined in services/activity.service.ts:178

getHRLoadModel

getHRLoadModel(activityId: string): Promise<HRLoadModel>
Get HR load model for an activity
Parameters
- activityId: string
Returns Promise<HRLoadModel>
- Defined in services/activity.service.ts:193

getIntervals

getIntervals(activityId: string): Promise<IntervalsDTO>
Get activity intervals
Parameters
- activityId: string
Returns Promise<IntervalsDTO>
- Defined in services/activity.service.ts:117

getMap

getMap(activityId: string): Promise<MapData>
Get map data (bounds, latlngs, route, weather)
Parameters
- activityId: string
Returns Promise<MapData>
- Defined in services/activity.service.ts:156

getPaceCurve

getPaceCurve(activityId: string): Promise<unknown>
Get pace curve for an activity
Parameters
- activityId: string
Returns Promise<unknown>
- Defined in services/activity.service.ts:173

getPowerCurve

getPowerCurve(activityId: string): Promise<unknown>
Get power curve for an activity
Parameters
- activityId: string
Returns Promise<unknown>
- Defined in services/activity.service.ts:168

getPowerVsHR

getPowerVsHR(activityId: string): Promise<PowerVsHRPlot>
Get power vs HR analysis
Parameters
- activityId: string
Returns Promise<PowerVsHRPlot>
- Defined in services/activity.service.ts:188

getSegments

getSegments(activityId: string): Promise<IcuSegment[]>
Get segments matched in an activity
Parameters
- activityId: string
Returns Promise<IcuSegment[]>
- Defined in services/activity.service.ts:198

getStreams

getStreams(activityId: string, types?: string[]): Promise<ActivityStream[]>
Get activity streams (JSON)
Parameters
- activityId: string
- Optionaltypes: string[]
Returns Promise<ActivityStream[]>
- Defined in services/activity.service.ts:94

getStreamsCSV

getStreamsCSV(activityId: string): Promise<Buffer<ArrayBufferLike>>
Download activity streams as CSV
Parameters
- activityId: string
Returns Promise<Buffer<ArrayBufferLike>>
- Defined in services/activity.service.ts:105

getWeatherSummary

getWeatherSummary(activityId: string): Promise<ActivityWeatherSummary>
Get activity weather summary
Parameters
- activityId: string
Returns Promise<ActivityWeatherSummary>
- Defined in services/activity.service.ts:161

listActivities

listActivities(
options?: ListActivitiesOptions,
athleteId?: string,
): Promise<Activity[]>
List activities for a date range (descending order)
Parameters
- Optionaloptions: ListActivitiesOptions
- OptionalathleteId: string
Returns Promise<Activity[]>
- Defined in services/activity.service.ts:26

listActivitiesAround

listActivitiesAround(
    activityId: string,
    options?: ActivitiesAroundOptions,
    athleteId?: string,
): Promise<Activity[]>
Activities before and after another activity, closest first; optionally only those on a route.
Parameters
- activityId: string
- Optionaloptions: ActivitiesAroundOptions
- OptionalathleteId: string
Returns Promise<Activity[]>
- Defined in services/activity.service.ts:229

listActivityTags

listActivityTags(athleteId?: string): Promise<string[]>
Every tag that has been applied to the athlete's activities
Parameters
- OptionalathleteId: string
Returns Promise<string[]>
- Defined in services/activity.service.ts:259

listMessages

listMessages(
activityId: string,
options?: { limit?: number; sinceId?: number },
): Promise<Message[]>
List all messages (comments) for an activity
Parameters
- activityId: string
- Optionaloptions: { limit?: number; sinceId?: number }
Returns Promise<Message[]>
- Defined in services/activity.service.ts:205

searchActivitiesFull

searchActivitiesFull(
    q: string,
    options?: { limit?: number },
    athleteId?: string,
): Promise<Activity[]>
Search by name or tag and return full Activity objects (search.searchActivities returns summaries).
Parameters
- q: string
- Optionaloptions: { limit?: number }
- OptionalathleteId: string
Returns Promise<Activity[]>
- Defined in services/activity.service.ts:239

searchIntervals

searchIntervals(
options: IntervalSearchOptions,
athleteId?: string,
): Promise<Activity[]>
Find activities containing intervals that match a duration and intensity window.
Parameters
- options: IntervalSearchOptions
- OptionalathleteId: string
Returns Promise<Activity[]>
- Defined in services/activity.service.ts:249

sendMessage

sendMessage(activityId: string, data: NewActivityMsg): Promise<NewMsg>
Add a message (comment) to an activity
Parameters
- activityId: string
- data: NewActivityMsg
Returns Promise<NewMsg>
- Defined in services/activity.service.ts:210

splitInterval

splitInterval(activityId: string, splitAt: number): Promise<IntervalsDTO>
Split an interval at an index
Parameters
- activityId: string
- splitAt: number
Returns Promise<IntervalsDTO>
- Defined in services/activity.service.ts:137

updateActivity

updateActivity(activityId: string, data: ActivityInput): Promise<Activity>
Update an activity (Strava activities cannot be updated)
Parameters
- activityId: string
- data: ActivityInput
Returns Promise<Activity>
- Defined in services/activity.service.ts:82

updateInterval

updateInterval(
    activityId: string,
    intervalId: number,
    data: Interval,
): Promise<IntervalsDTO>
Update/create a single interval
Parameters
- activityId: string
- intervalId: number
- data: Interval
Returns Promise<IntervalsDTO>
- Defined in services/activity.service.ts:127

updateIntervals

updateIntervals(
    activityId: string,
    data: Interval[],
    options?: { all?: boolean },
): Promise<IntervalsDTO>
Update intervals (replace all or merge)
Parameters
- activityId: string
- data: Interval[]
- Optionaloptions: { all?: boolean }
Returns Promise<IntervalsDTO>
- Defined in services/activity.service.ts:122

updateStreams

updateStreams(
activityId: string,
data: ActivityStream[],
): Promise<UpdateStreamsResult>
Update activity streams (JSON)
Parameters
- activityId: string
- data: ActivityStream[]
Returns Promise<UpdateStreamsResult>
- Defined in services/activity.service.ts:100

updateStreamsCSV

updateStreamsCSV(
    activityId: string,
    file: Buffer<ArrayBufferLike> | Blob | Uint8Array<ArrayBufferLike>,
    fileName: string,
): Promise<UpdateStreamsResult>
Replace activity streams from a CSV file (PUT multipart/form-data)
Parameters
- activityId: string
- file: Buffer<ArrayBufferLike> | Blob | Uint8Array<ArrayBufferLike>
- fileName: string
Returns Promise<UpdateStreamsResult>
- Defined in services/activity.service.ts:110

uploadActivity

uploadActivity(
    file: Buffer<ArrayBufferLike> | Blob | Uint8Array<ArrayBufferLike>,
    fileName: string,
    options?: UploadActivityOptions,
    athleteId?: string,
): Promise<UploadResponse>
Upload a new activity from file (fit, tcx, gpx, or zip/gz)
Parameters
- file: Buffer<ArrayBufferLike> | Blob | Uint8Array<ArrayBufferLike>
- fileName: string
- Optionaloptions: UploadActivityOptions
- OptionalathleteId: string
Returns Promise<UploadResponse>
- Defined in services/activity.service.ts:36

Class ActivityService

Index

Constructors

Methods

Constructors

constructor

Parameters

Returns ActivityService

Methods

createManualActivitiesBulk

Parameters

Returns Promise<Activity[]>

createManualActivity

Parameters

Returns Promise<Activity>

deleteActivity

Parameters

Returns Promise<ActivityId>

deleteIntervals

Parameters

Returns Promise<IntervalsDTO>

deleteTombstone

Parameters

Returns Promise<void>

downloadActivitiesCSV

Parameters

Returns Promise<Buffer<ArrayBufferLike>>

downloadFile

Parameters

Returns Promise<Buffer<ArrayBufferLike>>

downloadFitFile

Parameters

Returns Promise<Buffer<ArrayBufferLike>>

downloadFitFiles

Parameters

Returns Promise<Buffer<ArrayBufferLike>>

downloadGPX

Parameters

Returns Promise<Buffer<ArrayBufferLike>>

getActivities

Parameters

Returns Promise<Activity[]>

getActivity

Parameters

Returns Promise<Activity>

getBestEfforts

Parameters

Returns Promise<BestEfforts>

getHRCurve

Parameters

Returns Promise<unknown>

getHRLoadModel

Parameters

Returns Promise<HRLoadModel>

getIntervals

Parameters

Returns Promise<IntervalsDTO>

getMap

Parameters

Returns Promise<MapData>

getPaceCurve

Parameters

Returns Promise<unknown>

getPowerCurve

Parameters

Returns Promise<unknown>

getPowerVsHR

Parameters

Returns Promise<PowerVsHRPlot>

getSegments

Parameters

Returns Promise<IcuSegment[]>

getStreams

Parameters

Returns Promise<ActivityStream[]>

getStreamsCSV

Parameters

Returns Promise<Buffer<ArrayBufferLike>>

getWeatherSummary

Parameters