fit-file-parser 6.1.2 → 6.2.1

package/dist/cjs/fit-parser.js

@@ -1,4 +1,13 @@
 "use strict";
+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());
+    });
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readFitUnsignedField = exports.readFitStringField = exports.readFitMessages = exports.getFitBaseTypeId = exports.fitTimestampToUnixMilliseconds = exports.FitMessageReaderError = exports.getFitSubSportName = exports.getFitSubSportId = exports.getFitSportName = exports.getFitSportId = exports.getFitManufacturerName = exports.getFitGarminProductName = exports.getFitGarminProductDisplayName = exports.getFitCoursePointId = exports.FitEncoder = exports.FitBaseType = void 0;
 const binary_js_1 = require("./binary.js");
@@ -22,21 +31,31 @@ Object.defineProperty(exports, "getFitBaseTypeId", { enumerable: true, get: func
 Object.defineProperty(exports, "readFitMessages", { enumerable: true, get: function () { return raw_message_reader_js_1.readFitMessages; } });
 Object.defineProperty(exports, "readFitStringField", { enumerable: true, get: function () { return raw_message_reader_js_1.readFitStringField; } });
 Object.defineProperty(exports, "readFitUnsignedField", { enumerable: true, get: function () { return raw_message_reader_js_1.readFitUnsignedField; } });
+function hasFitHeader(blob, start) {
+    const headerLength = blob[start];
+    return blob.length - start >= headerLength
+        && (headerLength === 12 || headerLength === 14)
+        && blob[start + 8] === 0x2E
+        && blob[start + 9] === 0x46
+        && blob[start + 10] === 0x49
+        && blob[start + 11] === 0x54;
+}
 class FitParser {
     constructor(options = {}) {
-        var _a, _b, _c, _d;
+        var _a, _b, _c, _d, _e;
         this.options = {
             force: options.force != null ? options.force : true,
+            strict: (_a = options.strict) !== null && _a !== void 0 ? _a : false,
             speedUnit: options.speedUnit || 'm/s',
             lengthUnit: options.lengthUnit || 'm',
             temperatureUnit: options.temperatureUnit || 'celsius',
             elapsedRecordField: options.elapsedRecordField || false,
             pressureUnit: options.pressureUnit || 'bar',
             mode: options.mode || 'list',
-            includeRawDeveloperFields: (_a = options.includeRawDeveloperFields) !== null && _a !== void 0 ? _a : false,
-            includeRawMessages: (_b = options.includeRawMessages) !== null && _b !== void 0 ? _b : false,
-            includeUnmappedMessages: (_c = options.includeUnmappedMessages) !== null && _c !== void 0 ? _c : false,
-            rawMessagesOnly: (_d = options.rawMessagesOnly) !== null && _d !== void 0 ? _d : false,
+            includeRawDeveloperFields: (_b = options.includeRawDeveloperFields) !== null && _b !== void 0 ? _b : false,
+            includeRawMessages: (_c = options.includeRawMessages) !== null && _c !== void 0 ? _c : false,
+            includeUnmappedMessages: (_d = options.includeUnmappedMessages) !== null && _d !== void 0 ? _d : false,
+            rawMessagesOnly: (_e = options.rawMessagesOnly) !== null && _e !== void 0 ? _e : false,
         };
     }
     parseAsync(content) {
@@ -51,7 +70,81 @@ class FitParser {
             });
         });
     }
+    /**
+     * Parses FIT files in input order with independent decoder state. Uses the
+     * same force and strict policies as parseAsync; strict mode rejects trailing
+     * bytes, while the default ignores a non-FIT suffix after parsed files.
+     * 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;
+                const headerLength = blob[start];
+                if (results.length > 0 && !this.options.strict && !hasFitHeader(blob, start)) {
+                    break;
+                }
+                if (remaining < 12) {
+                    throw new Error('File to small to be a FIT file');
+                }
+                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;
+                // File completeness and CRC checks belong to the shared parser below,
+                // preserving the same validation policy and error order in every API.
+                let end = Math.min(crcStart + 2, blob.length);
+                // Missing CRC bytes can also precede the next file. Check only the
+                // declared boundary and its one-byte CRC variant; never scan activity
+                // payloads for a guessed file boundary.
+                if (this.options.force && !this.options.strict) {
+                    if (hasFitHeader(blob, crcStart)) {
+                        end = crcStart;
+                    }
+                    else if (hasFitHeader(blob, crcStart + 1)) {
+                        end = crcStart + 1;
+                    }
+                }
+                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);
+                            }
+                        });
+                    }));
+                }
+                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) {
         var _a, _b, _c;
         const blob = content instanceof ArrayBuffer
             ? new Uint8Array(content)
@@ -94,10 +187,14 @@ class FitParser {
             callback('File data exceeds input length', undefined);
             return;
         }
-        if (!this.options.force && crcStart + 2 > blob.length) {
+        if ((!this.options.force || this.options.strict) && crcStart + 2 > blob.length) {
             callback('File CRC missing', undefined);
             return;
         }
+        if (this.options.strict && crcStart + 2 < blob.length) {
+            callback('Unexpected bytes after FIT file', undefined);
+            return;
+        }
         if (!this.options.force) {
             const crcFile = blob[crcStart] + (blob[crcStart + 1] << 8);
             const crcFileCalc = (0, binary_js_1.calculateCRC)(blob, 0, crcStart);
@@ -111,6 +208,7 @@ class FitParser {
             protocolVersion,
         };
         const messages = {};
+        const batteries = [];
         let sessions = [];
         let laps = [];
         const records = [];
@@ -160,6 +258,10 @@ class FitParser {
         let pausedTime = 0;
         while (loopIndex < crcStart) {
             const { globalMessageNumber, littleEndian, message, messageType, nextIndex, compressedTimestamp, rawFields: recordRawFields, rawDeveloperFields: recordRawDeveloperFields, unmappedFields: recordUnmappedFields, unmappedDeveloperFields: recordUnmappedDeveloperFields, } = (0, binary_js_1.readRecord)(blob, messageTypes, developerFields, loopIndex, this.options, startDate, pausedTime, dataView, decoderState, crcStart);
+            if (this.options.strict
+                && (!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;
@@ -210,6 +312,9 @@ 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;
@@ -354,6 +459,7 @@ 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/cjs/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/cjs/profile.js

@@ -1348,6 +1348,60 @@ exports.PROFILE_MESSAGES = {
         name: 'goal',
     },
     18: {
+        79: {
+            field: 'avg_strokes_per_length',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 10,
+            offset: 0,
+            units: 'strokes/length',
+        },
+        80: {
+            field: 'avg_swolf',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        106: {
+            field: 'num_segment_laps',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        107: {
+            field: 'front_gear_shift_count',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        108: {
+            field: 'rear_gear_shift_count',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        211: {
+            field: 'avg_grade_adjusted_speed',
+            type: 'uint32',
+            baseType: 'uint32',
+            array: false,
+            scale: 1000,
+            offset: 0,
+            units: 'm/s',
+        },
         0: {
             field: 'event',
             type: 'event',
@@ -2808,6 +2862,96 @@ exports.PROFILE_MESSAGES = {
         name: 'session',
     },
     19: {
+        27: {
+            field: 'nec_lat',
+            type: 'sint32',
+            baseType: 'sint32',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: 'semicircles',
+        },
+        28: {
+            field: 'nec_long',
+            type: 'sint32',
+            baseType: 'sint32',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: 'semicircles',
+        },
+        29: {
+            field: 'swc_lat',
+            type: 'sint32',
+            baseType: 'sint32',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: 'semicircles',
+        },
+        30: {
+            field: 'swc_long',
+            type: 'sint32',
+            baseType: 'sint32',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: 'semicircles',
+        },
+        73: {
+            field: 'avg_swolf',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        90: {
+            field: 'avg_strokes_per_length',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 10,
+            offset: 0,
+            units: 'strokes / length',
+        },
+        96: {
+            field: 'front_gear_shift_count',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        97: {
+            field: 'rear_gear_shift_count',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        155: {
+            field: 'metabolic_calories',
+            type: 'uint16',
+            baseType: 'uint16',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: 'kcal',
+        },
+        161: {
+            field: 'avg_grade_adjusted_speed',
+            type: 'uint32',
+            baseType: 'uint32',
+            array: false,
+            scale: 1000,
+            offset: 0,
+            units: 'm/s',
+        },
         0: {
             field: 'event',
             type: 'event',
@@ -6986,6 +7130,27 @@ exports.PROFILE_MESSAGES = {
         },
         name: 'monitoring_info',
     },
+    104: {
+        2: {
+            field: 'capacity',
+            type: 'uint8',
+            baseType: 'uint8',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: '%',
+        },
+        253: {
+            field: 'timestamp',
+            type: 'date_time',
+            baseType: 'uint32',
+            array: false,
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        name: 'battery',
+    },
     105: {
         name: 'pad',
     },
@@ -15266,6 +15431,7 @@ exports.PROFILE_TYPES = {
         82: 'ant_channel_id',
         101: 'length',
         103: 'monitoring_info',
+        104: 'battery',
         105: 'pad',
         106: 'slave_device',
         127: 'connectivity',

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

@@ -7,7 +7,10 @@ export { getFitCoursePointId, getFitGarminProductDisplayName, getFitGarminProduc
 export { FitMessageReaderError, fitTimestampToUnixMilliseconds, getFitBaseTypeId, readFitMessages, readFitStringField, readFitUnsignedField, } from './raw-message-reader.js';
 export type { FitMessageReaderErrorCode, FitMessageReaderIssue, FitMessageReaderIssueCode, FitMessageReaderOptions, FitMessageReaderResult, FitRawDeveloperField, FitRawField, FitRawMessage, } from './raw-message-reader.js';
 export interface FitParserOptions {
+    /** Skips CRC validation and enables supported best-effort recovery. Defaults to true. */
     force?: boolean;
+    /** Requires complete files and records, and rejects trailing bytes. Defaults to false. */
+    strict?: boolean;
     speedUnit?: string;
     lengthUnit?: string;
     temperatureUnit?: string;
@@ -28,5 +31,13 @@ export default class FitParser {
     private readonly options;
     constructor(options?: FitParserOptions);
     parseAsync(content: ArrayBuffer | Buffer<ArrayBuffer>): Promise<ParsedFit>;
+    /**
+     * Parses FIT files in input order with independent decoder state. Uses the
+     * same force and strict policies as parseAsync; strict mode rejects trailing
+     * bytes, while the default ignores a non-FIT suffix after parsed files.
+     * 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;
 }