fit-file-parser 6.1.1 → 6.2.0

package/dist/cjs/type_generator.js

@@ -261,6 +261,7 @@ function generateFitType() {
         time_in_zone: 'parsed_time_in_zone',
         activity_metrics: 'parsed_activity_metrics',
         user_metrics: 'parsed_user_metrics',
+        batteries: 'parsed_battery',
     };
     const referenceProperties = {
         file_creator: 'parsed_file_creator',

package/dist/fit-parser.d.ts

@@ -28,5 +28,13 @@ export default class FitParser {
     private readonly options;
     constructor(options?: FitParserOptions);
     parseAsync(content: ArrayBuffer | Buffer<ArrayBuffer>): Promise<ParsedFit>;
+    /**
+     * Parses every complete FIT file in an input, preserving file order and
+     * independent decoder state. Rejects incomplete files and trailing bytes;
+     * each file uses this parser's options, including its CRC policy.
+     * Rejects with an Error when any file cannot be parsed.
+     */
+    parseFilesAsync(content: ArrayBuffer | Buffer<ArrayBuffer>): Promise<ParsedFit[]>;
     parse(content: ArrayBuffer | Buffer<ArrayBuffer>, callback: FitParserCallback): void;
+    private parseFile;
 }

package/dist/fit-parser.js

@@ -1,3 +1,12 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
 import { calculateCRC, readRecord } from './binary.js';
 import { mapDataIntoLap, mapDataIntoSession } from './helper.js';
 export { FitBaseType, FitEncoder } from './fit-encoder.js';
@@ -32,7 +41,71 @@ export default class FitParser {
             });
         });
     }
+    /**
+     * Parses every complete FIT file in an input, preserving file order and
+     * independent decoder state. Rejects incomplete files and trailing bytes;
+     * each file uses this parser's options, including its CRC policy.
+     * Rejects with an Error when any file cannot be parsed.
+     */
+    parseFilesAsync(content) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const blob = content instanceof ArrayBuffer
+                ? new Uint8Array(content)
+                : new Uint8Array(content.buffer, content.byteOffset, content.byteLength);
+            const results = [];
+            let start = 0;
+            do {
+                const remaining = blob.length - start;
+                if (remaining < 12) {
+                    throw new Error('File to small to be a FIT file');
+                }
+                const headerLength = blob[start];
+                if (headerLength !== 12 && headerLength !== 14) {
+                    throw new Error('Incorrect header size');
+                }
+                if (remaining < headerLength) {
+                    throw new Error('File to small to be a FIT file');
+                }
+                if (blob[start + 8] !== 0x2E
+                    || blob[start + 9] !== 0x46
+                    || blob[start + 10] !== 0x49
+                    || blob[start + 11] !== 0x54) {
+                    throw new Error('Missing \'.FIT\' in header');
+                }
+                const dataLength = new DataView(blob.buffer, blob.byteOffset + start, remaining)
+                    .getUint32(4, true);
+                const crcStart = start + headerLength + dataLength;
+                if (crcStart > blob.length) {
+                    throw new Error('File data exceeds input length');
+                }
+                if (crcStart + 2 > blob.length) {
+                    throw new Error('File CRC missing');
+                }
+                const end = crcStart + 2;
+                try {
+                    results.push(yield new Promise((resolve, reject) => {
+                        this.parseFile(blob.slice(start, end).buffer, (error, data) => {
+                            if (error) {
+                                reject(error);
+                            }
+                            else if (data) {
+                                resolve(data);
+                            }
+                        }, true);
+                    }));
+                }
+                catch (error) {
+                    throw error instanceof Error ? error : new Error(String(error));
+                }
+                start = end;
+            } while (start < blob.length);
+            return results;
+        });
+    }
     parse(content, callback) {
+        this.parseFile(content, callback);
+    }
+    parseFile(content, callback, validateRecordBounds = false) {
         var _a, _b, _c;
         const blob = content instanceof ArrayBuffer
             ? new Uint8Array(content)
@@ -92,6 +165,7 @@ export default class FitParser {
             protocolVersion,
         };
         const messages = {};
+        const batteries = [];
         let sessions = [];
         let laps = [];
         const records = [];
@@ -141,6 +215,12 @@ export default class FitParser {
         let pausedTime = 0;
         while (loopIndex < crcStart) {
             const { globalMessageNumber, littleEndian, message, messageType, nextIndex, compressedTimestamp, rawFields: recordRawFields, rawDeveloperFields: recordRawDeveloperFields, unmappedFields: recordUnmappedFields, unmappedDeveloperFields: recordUnmappedDeveloperFields, } = readRecord(blob, messageTypes, developerFields, loopIndex, this.options, startDate, pausedTime, dataView, decoderState, crcStart);
+            // Complete-file parsing also validates bounds without requiring raw
+            // retention. The single-file API keeps its existing recovery behavior.
+            if (validateRecordBounds
+                && (!Number.isInteger(nextIndex) || nextIndex <= loopIndex || nextIndex > crcStart)) {
+                throw new Error('Invalid FIT record bounds');
+            }
             loopIndex = nextIndex;
             if (globalMessageNumber !== undefined) {
                 const messageIndex = (_a = messageCountsByGlobalNumber.get(globalMessageNumber)) !== null && _a !== void 0 ? _a : 0;
@@ -191,6 +271,9 @@ export default class FitParser {
                 ((_b = messages[messageType]) !== null && _b !== void 0 ? _b : (messages[messageType] = [])).push(message);
             }
             switch (messageType) {
+                case 'battery':
+                    batteries.push(message);
+                    break;
                 case 'lap':
                     laps.push(message);
                     break;
@@ -335,6 +418,7 @@ export default class FitParser {
         fitObj.time_in_zone = time_in_zone;
         fitObj.activity_metrics = activity_metrics;
         fitObj.user_metrics = user_metrics;
+        fitObj.batteries = batteries;
         fitObj.messages = messages;
         if (rawDeveloperFields) {
             fitObj.raw_developer_fields = rawDeveloperFields;

package/dist/fit_types.d.ts

@@ -156,7 +156,7 @@ export type MaxMetCategory = 'generic' | 'cycling' | number;
 export type MaxMetHeartRateSource = 'whr' | 'hrm' | number;
 export type MaxMetSpeedSource = 'onboard_gps' | 'connected_gps' | 'cadence' | number;
 export type MesgCount = 'num_per_file' | 'max_per_file' | 'max_per_file_type' | number;
-export type MesgNum = 'file_id' | 'capabilities' | 'device_settings' | 'user_profile' | 'hrm_profile' | 'sdm_profile' | 'bike_profile' | 'zones_target' | 'hr_zone' | 'power_zone' | 'met_zone' | 'sport' | 'training_settings' | 'goal' | 'session' | 'lap' | 'record' | 'event' | 'device_info' | 'workout' | 'workout_step' | 'schedule' | 'weight_scale' | 'course' | 'course_point' | 'totals' | 'activity' | 'software' | 'file_capabilities' | 'mesg_capabilities' | 'field_capabilities' | 'file_creator' | 'blood_pressure' | 'speed_zone' | 'monitoring' | 'training_file' | 'hrv' | 'user_metrics' | 'ant_rx' | 'ant_tx' | 'ant_channel_id' | 'length' | 'monitoring_info' | 'pad' | 'slave_device' | 'connectivity' | 'weather_conditions' | 'weather_alert' | 'cadence_zone' | 'hr' | 'activity_metrics' | 'segment_lap' | 'memo_glob' | 'segment_id' | 'segment_leaderboard_entry' | 'segment_point' | 'segment_file' | 'workout_session' | 'watchface_settings' | 'gps_metadata' | 'camera_event' | 'timestamp_correlation' | 'gyroscope_data' | 'accelerometer_data' | 'three_d_sensor_calibration' | 'video_frame' | 'obdii_data' | 'nmea_sentence' | 'aviation_attitude' | 'video' | 'video_title' | 'video_description' | 'video_clip' | 'ohr_settings' | 'exd_screen_configuration' | 'exd_data_field_configuration' | 'exd_data_concept_configuration' | 'field_description' | 'developer_data_id' | 'magnetometer_data' | 'barometer_data' | 'one_d_sensor_calibration' | 'monitoring_hr_data' | 'time_in_zone' | 'set' | 'stress_level' | 'max_met_data' | 'dive_settings' | 'dive_gas' | 'dive_alarm' | 'exercise_title' | 'dive_summary' | 'spo2_data' | 'sleep_level' | 'jump' | 'aad_accel_features' | 'beat_intervals' | 'respiration_rate' | 'hsa_accelerometer_data' | 'hsa_step_data' | 'hsa_spo2_data' | 'hsa_stress_data' | 'hsa_respiration_data' | 'hsa_heart_rate_data' | 'split' | 'split_summary' | 'hsa_body_battery_data' | 'hsa_event' | 'climb_pro' | 'tank_update' | 'tank_summary' | 'sleep_assessment' | 'hrv_status_summary' | 'hrv_value' | 'raw_bbi' | 'device_aux_battery_info' | 'hsa_gyroscope_data' | 'chrono_shot_session' | 'chrono_shot_data' | 'hsa_configuration_data' | 'dive_apnea_alarm' | 'skin_temp_overnight' | 'hsa_wrist_temperature_data' | 'nap_event' | 'sleep_disruption_severity_period' | 'sleep_disruption_overnight_severity' | 'mfg_range_min' | 'mfg_range_max' | 'definition' | number;
+export type MesgNum = 'file_id' | 'capabilities' | 'device_settings' | 'user_profile' | 'hrm_profile' | 'sdm_profile' | 'bike_profile' | 'zones_target' | 'hr_zone' | 'power_zone' | 'met_zone' | 'sport' | 'training_settings' | 'goal' | 'session' | 'lap' | 'record' | 'event' | 'device_info' | 'workout' | 'workout_step' | 'schedule' | 'weight_scale' | 'course' | 'course_point' | 'totals' | 'activity' | 'software' | 'file_capabilities' | 'mesg_capabilities' | 'field_capabilities' | 'file_creator' | 'blood_pressure' | 'speed_zone' | 'monitoring' | 'training_file' | 'hrv' | 'user_metrics' | 'ant_rx' | 'ant_tx' | 'ant_channel_id' | 'length' | 'monitoring_info' | 'battery' | 'pad' | 'slave_device' | 'connectivity' | 'weather_conditions' | 'weather_alert' | 'cadence_zone' | 'hr' | 'activity_metrics' | 'segment_lap' | 'memo_glob' | 'segment_id' | 'segment_leaderboard_entry' | 'segment_point' | 'segment_file' | 'workout_session' | 'watchface_settings' | 'gps_metadata' | 'camera_event' | 'timestamp_correlation' | 'gyroscope_data' | 'accelerometer_data' | 'three_d_sensor_calibration' | 'video_frame' | 'obdii_data' | 'nmea_sentence' | 'aviation_attitude' | 'video' | 'video_title' | 'video_description' | 'video_clip' | 'ohr_settings' | 'exd_screen_configuration' | 'exd_data_field_configuration' | 'exd_data_concept_configuration' | 'field_description' | 'developer_data_id' | 'magnetometer_data' | 'barometer_data' | 'one_d_sensor_calibration' | 'monitoring_hr_data' | 'time_in_zone' | 'set' | 'stress_level' | 'max_met_data' | 'dive_settings' | 'dive_gas' | 'dive_alarm' | 'exercise_title' | 'dive_summary' | 'spo2_data' | 'sleep_level' | 'jump' | 'aad_accel_features' | 'beat_intervals' | 'respiration_rate' | 'hsa_accelerometer_data' | 'hsa_step_data' | 'hsa_spo2_data' | 'hsa_stress_data' | 'hsa_respiration_data' | 'hsa_heart_rate_data' | 'split' | 'split_summary' | 'hsa_body_battery_data' | 'hsa_event' | 'climb_pro' | 'tank_update' | 'tank_summary' | 'sleep_assessment' | 'hrv_status_summary' | 'hrv_value' | 'raw_bbi' | 'device_aux_battery_info' | 'hsa_gyroscope_data' | 'chrono_shot_session' | 'chrono_shot_data' | 'hsa_configuration_data' | 'dive_apnea_alarm' | 'skin_temp_overnight' | 'hsa_wrist_temperature_data' | 'nap_event' | 'sleep_disruption_severity_period' | 'sleep_disruption_overnight_severity' | 'mfg_range_min' | 'mfg_range_max' | 'definition' | number;
 export interface MessageIndex {
     value: number;
     reserved: boolean;
@@ -498,6 +498,8 @@ export interface ParsedSession {
     best_lap_index?: number;
     min_altitude?: number;
     active_time?: number;
+    avg_strokes_per_length?: number;
+    avg_swolf?: number;
     player_score?: number;
     opponent_score?: number;
     opponent_name?: string;
@@ -522,6 +524,9 @@ export interface ParsedSession {
     avg_left_pedal_smoothness?: number;
     avg_right_pedal_smoothness?: number;
     avg_combined_pedal_smoothness?: number;
+    num_segment_laps?: number;
+    front_gear_shift_count?: number;
+    rear_gear_shift_count?: number;
     sport_profile_name?: string;
     sport_index?: number;
     time_standing?: number;
@@ -588,6 +593,7 @@ export interface ParsedSession {
     avg_core_temperature?: number;
     min_core_temperature?: number;
     max_core_temperature?: number;
+    avg_grade_adjusted_speed?: number;
     timestamp?: Date;
     message_index?: MessageIndex;
     laps?: ParsedLap[];
@@ -620,6 +626,10 @@ export interface ParsedLap {
     lap_trigger?: LapTrigger;
     sport?: Sport;
     event_group?: number;
+    nec_lat?: number;
+    nec_long?: number;
+    swc_lat?: number;
+    swc_long?: number;
     num_lengths?: number;
     normalized_power?: number;
     left_right_balance?: LeftRightBalance100;
@@ -653,6 +663,7 @@ export interface ParsedLap {
     min_heart_rate?: number;
     active_time?: number;
     wkt_step_index?: MessageIndex;
+    avg_swolf?: number;
     opponent_score?: number;
     stroke_count?: (number | null)[];
     zone_count?: (number | null)[];
@@ -669,11 +680,14 @@ export interface ParsedLap {
     avg_saturated_hemoglobin_percent?: (number | null)[];
     min_saturated_hemoglobin_percent?: (number | null)[];
     max_saturated_hemoglobin_percent?: (number | null)[];
+    avg_strokes_per_length?: number;
     avg_left_torque_effectiveness?: number;
     avg_right_torque_effectiveness?: number;
     avg_left_pedal_smoothness?: number;
     avg_right_pedal_smoothness?: number;
     avg_combined_pedal_smoothness?: number;
+    front_gear_shift_count?: number;
+    rear_gear_shift_count?: number;
     time_standing?: number;
     stand_count?: number;
     avg_left_pco?: number;
@@ -710,11 +724,13 @@ export interface ParsedLap {
     jump_count?: number;
     avg_grit?: number;
     avg_flow?: number;
+    metabolic_calories?: number;
     total_fractional_ascent?: number;
     total_fractional_descent?: number;
     avg_core_temperature?: number;
     min_core_temperature?: number;
     max_core_temperature?: number;
+    avg_grade_adjusted_speed?: number;
     timestamp?: Date;
     message_index?: MessageIndex;
     records?: ParsedRecord[];
@@ -1119,6 +1135,10 @@ export interface ParsedMonitoringInfo {
     resting_metabolic_rate?: number;
     timestamp?: Date;
 }
+export interface ParsedBattery {
+    capacity?: number;
+    timestamp?: Date;
+}
 export interface ParsedPad {
 }
 export interface ParsedSlaveDevice {
@@ -2007,6 +2027,7 @@ export interface ParsedMessages {
     ant_channel_id?: ParsedAntChannelId[];
     length?: ParsedLength[];
     monitoring_info?: ParsedMonitoringInfo[];
+    battery?: ParsedBattery[];
     pad?: ParsedPad[];
     slave_device?: ParsedSlaveDevice[];
     connectivity?: ParsedConnectivity[];
@@ -2134,6 +2155,7 @@ export interface ParsedFit {
     time_in_zone?: ParsedTimeInZone[];
     activity_metrics?: ParsedActivityMetrics[];
     user_metrics?: ParsedUserMetrics[];
+    batteries?: ParsedBattery[];
     capabilities?: ParsedCapabilities;
     hrm_profile?: ParsedHrmProfile;
     sdm_profile?: ParsedSdmProfile;

package/dist/profile-lookup-data.d.ts

@@ -0,0 +1,12 @@
+export type FitProfileValueMap = Record<number, string | number>;
+/**
+ * Lookup-oriented slices of the maintained FIT profile.
+ *
+ * The full decoder composes these exact objects into PROFILE_TYPES, keeping
+ * this module authoritative without loading message definitions in lookup-only consumers.
+ */
+export declare const FIT_PROFILE_COURSE_POINTS: FitProfileValueMap;
+export declare const FIT_PROFILE_GARMIN_PRODUCTS: FitProfileValueMap;
+export declare const FIT_PROFILE_MANUFACTURERS: FitProfileValueMap;
+export declare const FIT_PROFILE_SPORTS: FitProfileValueMap;
+export declare const FIT_PROFILE_SUB_SPORTS: FitProfileValueMap;