fit-file-parser 6.1.1 → 6.2.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # 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
+
+- Keep the manufacturer, Garmin product, sport, sub-sport, and course-point
+  lookup maps in one authoritative internal module shared by the full decoder
+  profile and the lightweight `fit-file-parser/profile` entry point.
+- Prevent lookup-only consumers from loading the full decoder profile and its
+  message definitions.
+- Enforce the lookup entry point's dependency graph and a 25 KB minified bundle
+  ceiling in the profile checks run by CI.
+
+### Compatibility
+
+- Profile mappings, parsed output, and the public TypeScript API are unchanged.
+
 ## 6.1.1 - 2026-09-21
 
 ### Added

package/PROFILE.md

@@ -1,11 +1,18 @@
 # FIT Profile Maintenance
 
-The parser uses one static interoperability table in `src/profile.ts` for
-normal installs, builds, tests, and releases. It contains message and field
-identifiers, names, wire types, array behavior, scales, offsets, units, enum
-labels, and product identifiers. `npm run profile:check` pins full-table
-fingerprints and the resulting message, field, type, enum-value, and product
-counts so accidental drift fails CI.
+The parser uses one static interoperability profile for normal installs,
+builds, tests, and releases. Message definitions and general enum tables live
+in `src/profile.ts`; the manufacturer, Garmin product, sport, sub-sport, and
+course-point tables live in `src/profile-lookup-data.ts`. The full profile
+composes those exact objects, so lookup-only consumers and the decoder share
+one authoritative value for every mapping. `npm run profile:check` pins
+full-table fingerprints and the resulting message, field, type, enum-value,
+and product counts so accidental drift fails CI.
+
+`npm run profile:budget` also bundles the lookup entry point in isolation. It
+fails if anything beyond the lookup helpers and their authoritative data enters
+that graph, or if the minified bundle exceeds 25,000 bytes. Review any budget
+change together with the corresponding profile growth.
 
 ## Unknown and newer fields
 
@@ -24,12 +31,30 @@ 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
 adjacent identifiers or add a mapping solely to make `unmapped_messages`
-disappear. Update `src/profile.ts`, the relevant tests, and the public types,
-then verify the complete compatibility contract:
+disappear. Update the owning table in `src/profile.ts` or
+`src/profile-lookup-data.ts`, the relevant tests, and the public types, then
+verify the complete compatibility contract:
 
 ```sh
 npm run codegen
@@ -37,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
@@ -240,8 +277,9 @@ unchanged.
 ## Profile-backed output
 
 Recognized message names, field names, enum values, wire types, scales,
-offsets, arrays, and units come from the community-maintained table in
-`src/profile.ts`. Its maintenance and verification contract is documented in
+offsets, arrays, and units come from the community-maintained profile in
+`src/profile.ts` and `src/profile-lookup-data.ts`. Its maintenance and
+verification contract is documented in
 [`PROFILE.md`](./PROFILE.md).
 
 Public names use `snake_case` while preserving established alphanumeric tokens
@@ -443,9 +481,10 @@ a reference package, compares their complete default outputs, and reports only
 aggregate counts. Files rejected by both strict parsers are retried in force
 mode.
 
-Edit `src/profile.ts` only through reviewed profile changes with focused
-regression coverage and a documented source. Do not edit `src/fit_types.ts`
-manually; run `npm run codegen` after changing the maintained profile.
+Edit `src/profile.ts` and `src/profile-lookup-data.ts` only through reviewed
+profile changes with focused regression coverage and a documented source. Do
+not edit `src/fit_types.ts` manually; run `npm run codegen` after changing the
+maintained profile.
 
 Repository-specific automation guidance is tracked in
 [`.agent/README.md`](./.agent/README.md). More examples are available in the

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;