fit-file-parser 6.1.2 → 6.2.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Change Log
 
+## 6.2.0 - 2026-10-10
+
+### Added
+
+- Add `parseFilesAsync()` to return every complete FIT file in concatenated
+  input as a separate result, with independent decoder state and file order.
+- Decode documented session and lap swimming summaries, segment and gear-shift
+  counts, lap bounds, metabolic calories, and grade-adjusted speed.
+- Retain every battery sample in `batteries` and `messages.battery`, including
+  timestamp and capacity percentage when present.
+- Add `--all-files` to the external corpus checker to validate appended files.
+
+### Fixed
+
+- Preserve exact bytes for developer fields without usable names in opt-in
+  `unmapped_messages`, including fields whose descriptions have been cached.
+- Recover unsigned-byte record temperatures from 0 through 126 with normal
+  unit conversion, while retaining their original bytes in opt-in output.
+- Reject records and definitions extending beyond the declared data section
+  when using the complete-file `parseFilesAsync()` API.
+
+### Compatibility
+
+- Existing `parseAsync()` and callback APIs retain their single-file output
+  and recovery behavior. Newly supported fields and battery collections are
+  additive.
+- `parseFilesAsync()` returns a one-element array for ordinary FIT input and
+  rejects incomplete files or trailing non-FIT data, even with `force: true`.
+  CRC validation follows the caller's `force` option for every file.
+- Unsigned temperature bytes from 127 through 255 and other undocumented or
+  incompatible fields remain undecoded and available through opt-in retention.
+
 ## 6.1.2 - 2026-09-22
 
 ### Changed

package/PROFILE.md

@@ -31,6 +31,23 @@ complete raw representation of selected messages can continue to use
 `includeRawMessages`; `unmapped_messages` stores only the fields the maintained
 table cannot decode.
 
+The unsigned-byte record-temperature interoperability recovery also retains
+the original byte here, even when its unambiguous value is decoded.
+
+## Focused interoperability additions
+
+Session fields 79, 80, 106, 107, 108, and 211; lap fields 27–30, 73, 90, 96,
+97, 155, and 161; and battery message 104 fields 2 and 253 were checked against
+independently observed wire definitions in the external FIT corpus and the
+redistributable interoperability definitions for
+[session](https://github.com/muktihari/fit/blob/126e1a11233f87b7f139254d991bc3d2d952b62c/profile/mesgdef/session_gen.go),
+[lap](https://github.com/muktihari/fit/blob/126e1a11233f87b7f139254d991bc3d2d952b62c/profile/mesgdef/lap_gen.go),
+and [battery](https://github.com/muktihari/fit/blob/126e1a11233f87b7f139254d991bc3d2d952b62c/profile/mesgdef/battery_gen.go).
+The focused mappings expose swimming summaries, segment and shift counts,
+lap bounds, metabolic calories, grade-adjusted speed, and battery samples.
+Synthetic regression tests pin identifiers, wire types, scales, units, invalid
+sentinels, and collection behavior. Other battery fields remain unmapped.
+
 ## Updating the table
 
 Every mapping change requires focused regression coverage. Do not guess
@@ -45,7 +62,13 @@ npm run profile:check
 npm run check
 npm run compatibility:check -- /path/to/reference-package /path/to/fit-corpus
 npm run corpus:check -- ../FIT-test-files --allow-force-recovery
+npm run corpus:check -- ../FIT-test-files --allow-force-recovery --all-files
 ```
 
 `src/fit_types.ts` is generated from the maintained table and must not be
 edited manually.
+
+`--all-files` validates every appended FIT file through `parseFilesAsync()` and
+reports both parsed FIT file counts and concatenated input counts. Recovery
+counts apply to whole inputs; unmapped summaries count each parsed FIT file
+separately in this mode.

package/README.md

@@ -11,6 +11,7 @@ including developer-defined data.
 ## Features
 
 - Parse Node.js `Buffer` and standard `ArrayBuffer` inputs.
+- Parse concatenated FIT files as separate results with `parseFilesAsync()`.
 - Choose flat lists, nested activity data, or both output shapes.
 - Convert speed, length, temperature, and pressure fields to preferred units.
 - Decode developer fields while preserving record alignment when descriptions
@@ -33,7 +34,7 @@ npm install fit-file-parser
 
 ## Profile coverage
 
-The static profile contains 126 messages, 1,444 fields, 200 types, and 4,403
+The static profile contains 127 messages, 1,462 fields, 200 types, and 4,406
 mapped values. Pass `includeUnmappedMessages: true` to retain fields outside
 that maintained surface by number and exact bytes; applications that need all
 bytes for recognized messages can also opt into `raw_messages`.
@@ -62,6 +63,27 @@ console.log({
 })
 ```
 
+### Concatenated FIT files
+
+Some exports append several complete FIT files into one input. Use
+`parseFilesAsync()` to return a `ParsedFit[]` in file order:
+
+```javascript
+const files = await new FitParser({ force: false }).parseFilesAsync(content)
+for (const file of files) {
+  console.log(file.sessions?.length ?? 0)
+}
+```
+
+Each result has independent message definitions, developer descriptions,
+timestamps, and activity collections. Results are never merged. A single FIT
+file returns a one-element array. Empty input, incomplete files (including
+missing file CRC bytes), and trailing non-FIT bytes reject the entire call,
+even with `force: true`. Records and definitions extending beyond the declared
+data section are also rejected. CRC validation follows the `force` option for every
+file. Failures reject with an `Error`. The existing `parseAsync()` and callback
+APIs continue to parse the first FIT file only.
+
 ### Callback API
 
 ```javascript
@@ -86,8 +108,9 @@ readFile('./activity.fit', (readError, content) => {
 })
 ```
 
-Parser errors are strings. `parseAsync()` rejects with the same value that the
-callback API receives as its first argument.
+The callback reports validation errors as strings. `parseAsync()` rejects with
+those values; decoder failures can reject with an `Error`. `parseFilesAsync()`
+consistently rejects with an `Error`.
 
 ## Parser options
 
@@ -148,8 +171,8 @@ message numbers.
 
 Set `includeUnmappedMessages: true` to return fields that are absent from the
 maintained profile or belong to an unknown global message in
-`unmapped_messages`. Only unmapped fields are retained, so normal known fields
-are not duplicated:
+`unmapped_messages`. Fields without usable developer names are also retained.
+Normal known fields are not duplicated:
 
 ```javascript
 const data = await new FitParser({ includeUnmappedMessages: true })
@@ -169,6 +192,20 @@ Each entry uses the same wire-level field representation as `raw_messages`.
 This opt-in ensures a newer FIT field cannot disappear merely because it
 does not yet have a reviewed semantic mapping.
 
+For record temperature encoded as one unsigned byte, values from 0 through
+126 can be decoded as Celsius before the selected temperature conversion.
+Values from 127 through 255 remain undecoded. This narrow interoperability
+recovery preserves the original unsigned byte in `unmapped_messages` when
+enabled, including values that also receive a decoded temperature.
+
+### Battery samples
+
+`batteries` retains every battery message in file order, including its
+timestamp and capacity percentage when present. These samples are also
+available in `messages.battery`. Undocumented battery fields remain available
+through `includeUnmappedMessages`; the parser does not infer their device
+association or calculate battery consumption.
+
 ### Lossless selected messages
 
 Set `includeRawMessages` when a consumer needs native FIT numeric codes rather

package/dist/binary.js

@@ -305,6 +305,7 @@ function applyOptions(data, field, options, fields) {
         case 'enhanced_speed':
         case 'vertical_speed':
         case 'avg_speed':
+        case 'avg_grade_adjusted_speed':
         case 'max_speed':
         case 'speed1s':
         case 'ball_speed':
@@ -465,7 +466,12 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
             const fieldSize = blob[fDefIndex + 1];
             const wireType = FIT.types.fit_base_type[baseType];
             const { field, type, baseType: profileBaseType, array, scale, offset, units, } = message.getAttributes(blob[fDefIndex]);
-            const profileCompatible = areProfileBaseTypesCompatible(profileBaseType, wireType);
+            // Narrow producer interoperability case: only the shared, non-sentinel
+            // temperature range is decoded below. All original bytes remain unmapped.
+            const unsignedTemperature = mTypeDef.globalMessageNumber === 20
+                && fieldNumber === 13 && fieldSize === 1
+                && profileBaseType === 'sint8' && wireType === 'uint8';
+            const profileCompatible = unsignedTemperature || areProfileBaseTypesCompatible(profileBaseType, wireType);
             const fDef = {
                 type: profileCompatible ? type : wireType,
                 rawType: wireType,
@@ -539,7 +545,11 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
             rawData[i] = InvalidFieldData;
             continue;
         }
-        if ((rawFields || (unmappedFields && !isOutputFieldName(fDef.name)))
+        const unsignedTemperature = messageType.globalMessageNumber === 20
+            && fDef.fDefNo === 13 && fDef.size === 1
+            && fDef.type === 'sint8' && fDef.rawType === 'uint8';
+        const preserveNative = !isOutputFieldName(fDef.name) || unsignedTemperature;
+        if ((rawFields || (unmappedFields && preserveNative))
             && readDataFromIndex + fDef.size <= dataEnd) {
             const rawField = {
                 fieldDefinitionNumber: fDef.fDefNo,
@@ -547,11 +557,13 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
                 rawValue: Array.from(blob.subarray(readDataFromIndex, readDataFromIndex + fDef.size)),
             };
             rawFields === null || rawFields === void 0 ? void 0 : rawFields.push(rawField);
-            if (!isOutputFieldName(fDef.name)) {
+            if (preserveNative) {
                 unmappedFields === null || unmappedFields === void 0 ? void 0 : unmappedFields.push(rawField);
             }
         }
-        const data = readData(blob, dataView, fDef, readDataFromIndex);
+        const data = unsignedTemperature && blob[readDataFromIndex] >= 127
+            ? InvalidFieldData
+            : readData(blob, dataView, fDef, readDataFromIndex);
         if (data !== InvalidFieldData
             && !isInvalidValue(data, fDef.type)
             && !isInvalidBaseTypeValue(data, fDef.baseTypeNo)) {
@@ -573,20 +585,21 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
     for (let i = 0; i < developerFieldDefs.length; i++) {
         const developerFieldDef = developerFieldDefs[i];
         const rawDataIndex = messageType.fieldDefs.length + i;
-        let rawDeveloperField;
-        if ((rawDeveloperFields
-            || (unmappedDeveloperFields && developerFieldDef.resolvedFieldDef === undefined))
+        // Resolve before deciding whether raw retention is needed. A resolved
+        // description can still have no usable output name, including after cache use.
+        const fDef = resolveDeveloperFieldDefinition(developerFieldDef, messageType.littleEndian, developerFields, options);
+        const preserveDeveloper = !fDef || !isOutputFieldName(fDef.name);
+        if ((rawDeveloperFields || (unmappedDeveloperFields && preserveDeveloper))
             && readDataFromIndex + developerFieldDef.size <= dataEnd) {
-            rawDeveloperField = {
+            const rawDeveloperField = {
                 developerDataIndex: developerFieldDef.developerDataIndex,
                 fieldDefinitionNumber: developerFieldDef.fieldDefinitionNumber,
                 rawValue: Array.from(blob.subarray(readDataFromIndex, readDataFromIndex + developerFieldDef.size)),
             };
             rawDeveloperFields === null || rawDeveloperFields === void 0 ? void 0 : rawDeveloperFields.push(rawDeveloperField);
-        }
-        const fDef = resolveDeveloperFieldDefinition(developerFieldDef, messageType.littleEndian, developerFields, options);
-        if (!fDef && rawDeveloperField) {
-            unmappedDeveloperFields === null || unmappedDeveloperFields === void 0 ? void 0 : unmappedDeveloperFields.push(rawDeveloperField);
+            if (preserveDeveloper) {
+                unmappedDeveloperFields === null || unmappedDeveloperFields === void 0 ? void 0 : unmappedDeveloperFields.push(rawDeveloperField);
+            }
         }
         if (fDef) {
             const data = readData(blob, dataView, fDef, readDataFromIndex);

package/dist/cjs/binary.js

@@ -311,6 +311,7 @@ function applyOptions(data, field, options, fields) {
         case 'enhanced_speed':
         case 'vertical_speed':
         case 'avg_speed':
+        case 'avg_grade_adjusted_speed':
         case 'max_speed':
         case 'speed1s':
         case 'ball_speed':
@@ -471,7 +472,12 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
             const fieldSize = blob[fDefIndex + 1];
             const wireType = fit_js_1.FIT.types.fit_base_type[baseType];
             const { field, type, baseType: profileBaseType, array, scale, offset, units, } = message.getAttributes(blob[fDefIndex]);
-            const profileCompatible = areProfileBaseTypesCompatible(profileBaseType, wireType);
+            // Narrow producer interoperability case: only the shared, non-sentinel
+            // temperature range is decoded below. All original bytes remain unmapped.
+            const unsignedTemperature = mTypeDef.globalMessageNumber === 20
+                && fieldNumber === 13 && fieldSize === 1
+                && profileBaseType === 'sint8' && wireType === 'uint8';
+            const profileCompatible = unsignedTemperature || areProfileBaseTypesCompatible(profileBaseType, wireType);
             const fDef = {
                 type: profileCompatible ? type : wireType,
                 rawType: wireType,
@@ -545,7 +551,11 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
             rawData[i] = InvalidFieldData;
             continue;
         }
-        if ((rawFields || (unmappedFields && !isOutputFieldName(fDef.name)))
+        const unsignedTemperature = messageType.globalMessageNumber === 20
+            && fDef.fDefNo === 13 && fDef.size === 1
+            && fDef.type === 'sint8' && fDef.rawType === 'uint8';
+        const preserveNative = !isOutputFieldName(fDef.name) || unsignedTemperature;
+        if ((rawFields || (unmappedFields && preserveNative))
             && readDataFromIndex + fDef.size <= dataEnd) {
             const rawField = {
                 fieldDefinitionNumber: fDef.fDefNo,
@@ -553,11 +563,13 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
                 rawValue: Array.from(blob.subarray(readDataFromIndex, readDataFromIndex + fDef.size)),
             };
             rawFields === null || rawFields === void 0 ? void 0 : rawFields.push(rawField);
-            if (!isOutputFieldName(fDef.name)) {
+            if (preserveNative) {
                 unmappedFields === null || unmappedFields === void 0 ? void 0 : unmappedFields.push(rawField);
             }
         }
-        const data = readData(blob, dataView, fDef, readDataFromIndex);
+        const data = unsignedTemperature && blob[readDataFromIndex] >= 127
+            ? InvalidFieldData
+            : readData(blob, dataView, fDef, readDataFromIndex);
         if (data !== InvalidFieldData
             && !isInvalidValue(data, fDef.type)
             && !isInvalidBaseTypeValue(data, fDef.baseTypeNo)) {
@@ -579,20 +591,21 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
     for (let i = 0; i < developerFieldDefs.length; i++) {
         const developerFieldDef = developerFieldDefs[i];
         const rawDataIndex = messageType.fieldDefs.length + i;
-        let rawDeveloperField;
-        if ((rawDeveloperFields
-            || (unmappedDeveloperFields && developerFieldDef.resolvedFieldDef === undefined))
+        // Resolve before deciding whether raw retention is needed. A resolved
+        // description can still have no usable output name, including after cache use.
+        const fDef = resolveDeveloperFieldDefinition(developerFieldDef, messageType.littleEndian, developerFields, options);
+        const preserveDeveloper = !fDef || !isOutputFieldName(fDef.name);
+        if ((rawDeveloperFields || (unmappedDeveloperFields && preserveDeveloper))
             && readDataFromIndex + developerFieldDef.size <= dataEnd) {
-            rawDeveloperField = {
+            const rawDeveloperField = {
                 developerDataIndex: developerFieldDef.developerDataIndex,
                 fieldDefinitionNumber: developerFieldDef.fieldDefinitionNumber,
                 rawValue: Array.from(blob.subarray(readDataFromIndex, readDataFromIndex + developerFieldDef.size)),
             };
             rawDeveloperFields === null || rawDeveloperFields === void 0 ? void 0 : rawDeveloperFields.push(rawDeveloperField);
-        }
-        const fDef = resolveDeveloperFieldDefinition(developerFieldDef, messageType.littleEndian, developerFields, options);
-        if (!fDef && rawDeveloperField) {
-            unmappedDeveloperFields === null || unmappedDeveloperFields === void 0 ? void 0 : unmappedDeveloperFields.push(rawDeveloperField);
+            if (preserveDeveloper) {
+                unmappedDeveloperFields === null || unmappedDeveloperFields === void 0 ? void 0 : unmappedDeveloperFields.push(rawDeveloperField);
+            }
         }
         if (fDef) {
             const data = readData(blob, dataView, fDef, readDataFromIndex);

package/dist/cjs/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/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");
@@ -51,7 +60,71 @@ 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)
@@ -111,6 +184,7 @@ class FitParser {
             protocolVersion,
         };
         const messages = {};
+        const batteries = [];
         let sessions = [];
         let laps = [];
         const records = [];
@@ -160,6 +234,12 @@ 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);
+            // 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;
@@ -210,6 +290,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 +437,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

@@ -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.js

@@ -1345,6 +1345,60 @@ export const 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',
@@ -2805,6 +2859,96 @@ export const 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',
@@ -6983,6 +7127,27 @@ export const 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',
     },
@@ -15263,6 +15428,7 @@ export const PROFILE_TYPES = {
         82: 'ant_channel_id',
         101: 'length',
         103: 'monitoring_info',
+        104: 'battery',
         105: 'pad',
         106: 'slave_device',
         127: 'connectivity',

package/dist/type_generator.js

@@ -240,6 +240,7 @@ export 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/package.json

@@ -1,9 +1,9 @@
 {
   "name": "fit-file-parser",
   "type": "module",
-  "version": "6.1.2",
+  "version": "6.2.0",
   "private": false,
-  "description": "Parse your .FIT files easily, directly from JS (Garmin, Polar, Suunto)",
+  "description": "JavaScript and TypeScript library for parsing and encoding FIT files, with developer-field support, raw message access, and ESM/CommonJS builds.",
   "author": {
     "name": "jimmykane"
   },
@@ -24,13 +24,22 @@
     "url": "git+ssh://git@github.com/jimmykane/fit-parser.git"
   },
   "bugs": {
-    "url": "https://github.com/jimmykane/fit-parser"
+    "url": "https://github.com/jimmykane/fit-parser/issues"
   },
   "keywords": [
     "fit",
-    "ant",
+    "fit-file",
+    "fit-parser",
+    "fit-file-parsing",
+    "fit-encoder",
+    "javascript",
+    "typescript",
+    "nodejs",
+    "fitness",
     "garmin",
-    "parse"
+    "polar",
+    "suunto",
+    "binary-parser"
   ],
   "exports": {
     ".": {