fit-file-parser 4.0.1 → 4.1.0

package/dist/cjs/fit-parser.js

@@ -31,23 +31,23 @@ class FitParser {
         });
     }
     parse(content, callback) {
-        var _a;
+        var _a, _b;
         const blob = content instanceof ArrayBuffer
             ? new Uint8Array(content)
             : new Uint8Array(content.buffer, content.byteOffset, content.byteLength);
         const dataView = new DataView(blob.buffer, blob.byteOffset, blob.byteLength);
         if (blob.length < 12) {
             callback('File to small to be a FIT file', undefined);
-            if (!this.options.force) {
-                return;
-            }
+            return;
         }
         const headerLength = blob[0];
         if (headerLength !== 14 && headerLength !== 12) {
             callback('Incorrect header size', undefined);
-            if (!this.options.force) {
-                return;
-            }
+            return;
+        }
+        if (blob.length < headerLength) {
+            callback('File to small to be a FIT file', undefined);
+            return;
         }
         let fileTypeString = '';
         for (let i = 8; i < 12; i++) {
@@ -55,29 +55,33 @@ class FitParser {
         }
         if (fileTypeString !== '.FIT') {
             callback('Missing \'.FIT\' in header', undefined);
-            if (!this.options.force) {
-                return;
-            }
+            return;
         }
         if (headerLength === 14 && !this.options.force) {
             const crcHeader = blob[12] + (blob[13] << 8);
             const crcHeaderCalc = (0, binary_js_1.calculateCRC)(blob, 0, 12);
-            if (crcHeader !== crcHeaderCalc) {
-                // callback('Header CRC mismatch', {});
-                // TODO: fix Header CRC check
+            if (crcHeader !== 0 && crcHeader !== crcHeaderCalc) {
+                callback('Header CRC mismatch', undefined);
                 return;
             }
         }
         const protocolVersion = blob[1];
         const profileVersion = blob[2] + (blob[3] << 8);
-        const dataLength = blob[4] + (blob[5] << 8) + (blob[6] << 16) + (blob[7] << 24);
+        const dataLength = dataView.getUint32(4, true);
         const crcStart = dataLength + headerLength;
+        if (crcStart > blob.length) {
+            callback('File data exceeds input length', undefined);
+            return;
+        }
+        if (!this.options.force && crcStart + 2 > blob.length) {
+            callback('File CRC missing', undefined);
+            return;
+        }
         if (!this.options.force) {
             const crcFile = blob[crcStart] + (blob[crcStart + 1] << 8);
-            const crcFileCalc = (0, binary_js_1.calculateCRC)(blob, headerLength === 12 ? 0 : headerLength, crcStart);
+            const crcFileCalc = (0, binary_js_1.calculateCRC)(blob, 0, crcStart);
             if (crcFile !== crcFileCalc) {
-                // callback('File CRC mismatch', {});
-                // TODO: fix File CRC check
+                callback('File CRC mismatch', undefined);
                 return;
             }
         }
@@ -85,6 +89,7 @@ class FitParser {
             profileVersion,
             protocolVersion,
         };
+        const messages = {};
         let sessions = [];
         let laps = [];
         const records = [];
@@ -107,6 +112,7 @@ class FitParser {
         const tank_updates = [];
         const tank_summaries = [];
         const jumps = [];
+        const sets = [];
         const splits = [];
         const split_summaries = [];
         const time_in_zone = [];
@@ -115,14 +121,20 @@ class FitParser {
         let loopIndex = headerLength;
         const messageTypes = [];
         const developerFields = [];
+        const decoderState = {};
         const isModeCascade = this.options.mode === 'cascade';
         const isCascadeNeeded = isModeCascade || this.options.mode === 'both';
         let startDate;
         let lastStopTimestamp;
         let pausedTime = 0;
         while (loopIndex < crcStart) {
-            const { nextIndex, messageType, message } = (0, binary_js_1.readRecord)(blob, messageTypes, developerFields, loopIndex, this.options, startDate, pausedTime, dataView);
+            const { nextIndex, messageType, message } = (0, binary_js_1.readRecord)(blob, messageTypes, developerFields, loopIndex, this.options, startDate, pausedTime, dataView, decoderState);
             loopIndex = nextIndex;
+            if (messageType !== ''
+                && messageType !== 'definition'
+                && message !== undefined) {
+                ((_a = messages[messageType]) !== null && _a !== void 0 ? _a : (messages[messageType] = [])).push(message);
+            }
             switch (messageType) {
                 case 'lap':
                     laps.push(message);
@@ -210,6 +222,9 @@ class FitParser {
                 case 'jump':
                     jumps.push(message);
                     break;
+                case 'set':
+                    sets.push(message);
+                    break;
                 case 'split':
                     splits.push(message);
                     break;
@@ -250,15 +265,17 @@ class FitParser {
         fitObj.time_in_zone = time_in_zone;
         fitObj.activity_metrics = activity_metrics;
         fitObj.user_metrics = user_metrics;
+        fitObj.messages = messages;
         if (isCascadeNeeded) {
             laps = (0, helper_js_1.mapDataIntoLap)(laps, 'records', records);
             laps = (0, helper_js_1.mapDataIntoLap)(laps, 'lengths', lengths);
             sessions = (0, helper_js_1.mapDataIntoSession)(sessions, laps);
-            fitObj.activity = Object.assign(Object.assign({}, ((_a = fitObj.activity) !== null && _a !== void 0 ? _a : {})), { // ugly but we assume the activity was parsed correctly with all other members correctly
+            fitObj.activity = Object.assign(Object.assign({}, ((_b = fitObj.activity) !== null && _b !== void 0 ? _b : {})), { // ugly but we assume the activity was parsed correctly with all other members correctly
                 sessions,
                 events,
                 hrv,
                 device_infos, developer_data_ids: applications, field_descriptions: fieldDescriptions, sports,
+                sets,
                 splits,
                 split_summaries });
         }
@@ -272,6 +289,7 @@ class FitParser {
             fitObj.developer_data_ids = applications;
             fitObj.field_descriptions = fieldDescriptions;
             fitObj.hrv = hrv;
+            fitObj.sets = sets;
         }
         callback(undefined, fitObj);
     }

package/dist/cjs/fit.d.ts

@@ -1,8 +1,10 @@
 import type { FitOptions, MesgNum } from './fit_types.js';
 export interface FieldDefinition {
     type: string | number;
+    rawType?: string | number;
     fDefNo: number;
     size: number;
+    array?: boolean;
     endianAbility: boolean;
     littleEndian: boolean;
     baseTypeNo: number;
@@ -13,13 +15,17 @@ export interface FieldDefinition {
     requiresBoundedDataView?: boolean;
     developerDataIndex?: number;
     isDeveloperField?: boolean;
+    aliases?: MessageObject[];
 }
 export interface MessageObject {
     field: string;
     type: string;
+    baseType?: string;
+    array?: boolean;
     scale: number | null;
     offset: number;
     units: string;
+    aliases?: MessageObject[];
 }
 export interface Message {
     name: MesgNum;

package/dist/cjs/fit.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FIT = void 0;
+const garmin_profile_generated_js_1 = require("./garmin_profile.generated.js");
 const metersInOneKilometer = 1000;
 const secondsInOneHour = 3600;
 // according to https://en.wikipedia.org/wiki/Mile
@@ -11,7 +12,7 @@ const psiInOneBar = 14.5037738;
 // which contains all the types and values
 // i would wish for some kind of inference mechanism here but for now we leave it as any
 // maybe zod could help here
-exports.FIT = {
+const FIT_OVERRIDES = {
     scConst: 180 / Math.pow(2, 31),
     options: {
         speedUnits: {
@@ -49,6 +50,11 @@ exports.FIT = {
             },
         },
         temperatureUnits: {
+            // canonical native temperature unit: degree Celsius [°C]
+            'celsius': {
+                multiplier: 1,
+                offset: 0,
+            },
             // native temperature unit: degree Celsius [°C]
             '°C': {
                 multiplier: 1,
@@ -57,7 +63,7 @@ exports.FIT = {
             // kelvin [K]
             'kelvin': {
                 multiplier: 1,
-                offset: -273.15,
+                offset: 273.15,
             },
             // degree fahrenheit [°F]
             'fahrenheit': {
@@ -1797,20 +1803,6 @@ exports.FIT = {
                 offset: 0,
                 units: 'percent',
             },
-            214: {
-                field: 'avg_grit',
-                type: 'float32',
-                scale: null,
-                offset: 0,
-                units: '',
-            },
-            215: {
-                field: 'avg_flow',
-                type: 'float32',
-                scale: null,
-                offset: 0,
-                units: '',
-            },
             140: {
                 field: 'recovery_advisor',
                 type: 'uint16', // Minutes?
@@ -4135,22 +4127,25 @@ exports.FIT = {
             },
             2: {
                 field: 'distance',
-                type: 'float32',
-                scale: null,
+                type: 'uint32',
+                baseType: 'uint32',
+                scale: 100,
                 offset: 0,
                 units: 'm',
             },
             3: {
                 field: 'cycles',
-                type: 'float32',
-                scale: null,
+                type: 'uint32',
+                baseType: 'uint32',
+                scale: 2,
                 offset: 0,
                 units: 'cycles',
             },
             4: {
                 field: 'active_time',
-                type: 'float32',
-                scale: null,
+                type: 'uint32',
+                baseType: 'uint32',
+                scale: 1000,
                 offset: 0,
                 units: 's',
             },
@@ -4205,28 +4200,33 @@ exports.FIT = {
             },
             12: {
                 field: 'temperature',
-                type: 'float32',
-                scale: null,
+                type: 'sint16',
+                baseType: 'sint16',
+                scale: 100,
                 offset: 0,
                 units: 'C',
             },
             14: {
                 field: 'temperature_min',
-                type: 'float32',
-                scale: null,
+                type: 'sint16',
+                baseType: 'sint16',
+                scale: 100,
                 offset: 0,
                 units: 'C',
             },
             15: {
                 field: 'temperature_max',
-                type: 'float32',
-                scale: null,
+                type: 'sint16',
+                baseType: 'sint16',
+                scale: 100,
                 offset: 0,
                 units: 'C',
             },
             16: {
                 field: 'activity_time',
-                type: 'int32',
+                type: 'uint16',
+                baseType: 'uint16',
+                array: true,
                 scale: null,
                 offset: 0,
                 units: '',
@@ -4597,17 +4597,6 @@ exports.FIT = {
                 units: '',
             },
         },
-        108: {
-            name: 'o_hr_settings',
-            253: {
-                field: 'timestamp',
-                type: 'date_time',
-                scale: null,
-                offset: 0,
-                units: '',
-            },
-            0: { field: 'enabled', type: 'byte', scale: null, offset: 0, units: '' },
-        },
         140: {
             name: 'activity_metrics',
             1: {
@@ -4742,6 +4731,86 @@ exports.FIT = {
                 units: '',
             },
         },
+        225: {
+            name: 'set',
+            254: {
+                field: 'timestamp',
+                type: 'date_time',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            0: {
+                field: 'duration',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+            3: {
+                field: 'repetitions',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            4: {
+                field: 'weight',
+                type: 'uint16',
+                scale: 16,
+                offset: 0,
+                units: 'kg',
+            },
+            5: {
+                field: 'set_type',
+                type: 'set_type',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            6: {
+                field: 'start_time',
+                type: 'date_time',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            7: {
+                field: 'category',
+                type: 'exercise_category_array',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            8: {
+                field: 'category_subtype',
+                type: 'uint16_array',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            9: {
+                field: 'weight_display_unit',
+                type: 'fit_base_unit',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            10: {
+                field: 'message_index',
+                type: 'message_index',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            11: {
+                field: 'wkt_step_index',
+                type: 'message_index',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+        },
         227: {
             name: 'stress_level',
             0: {
@@ -5203,7 +5272,7 @@ exports.FIT = {
                 units: 's',
             },
             4: {
-                field: 'time_in_power_zone',
+                field: 'time_in_cadence_zone',
                 type: 'uint32_array',
                 scale: 1000,
                 offset: 0,
@@ -5231,11 +5300,11 @@ exports.FIT = {
                 units: 'm/s',
             },
             8: {
-                field: 'power_zone_high_boundary',
-                type: 'uint16_array',
+                field: 'cadence_zone_high_boundary',
+                type: 'uint8_array',
                 scale: null,
                 offset: 0,
-                units: 'watts',
+                units: 'rpm',
             },
             9: {
                 field: 'power_zone_high_boundary',
@@ -9088,3 +9157,57 @@ exports.FIT = {
         },
     },
 };
+function equivalentProfileName(left, right) {
+    return String(left).replace(/_/g, '').toLowerCase()
+        === String(right).replace(/_/g, '').toLowerCase();
+}
+function mergeMessages() {
+    const messages = Object.assign({}, FIT_OVERRIDES.messages);
+    Object.entries(garmin_profile_generated_js_1.GARMIN_MESSAGES).forEach(([messageId, generatedMessage]) => {
+        const overrideMessage = FIT_OVERRIDES.messages[Number(messageId)];
+        if (!overrideMessage) {
+            messages[Number(messageId)] = generatedMessage;
+            return;
+        }
+        const mergedMessage = Object.assign(Object.assign({}, overrideMessage), generatedMessage);
+        Object.entries(generatedMessage).forEach(([fieldId, generatedField]) => {
+            var _a;
+            if (fieldId === 'name') {
+                return;
+            }
+            const overrideField = overrideMessage[Number(fieldId)];
+            const hasCompatibleName = overrideField
+                && equivalentProfileName(overrideField.field, generatedField.field);
+            mergedMessage[Number(fieldId)] = hasCompatibleName
+                ? Object.assign(Object.assign(Object.assign({}, generatedField), overrideField), { baseType: generatedField.baseType, array: (_a = overrideField.array) !== null && _a !== void 0 ? _a : generatedField.array }) : Object.assign(Object.assign(Object.assign({}, overrideField), generatedField), { aliases: overrideField ? [overrideField] : undefined });
+        });
+        messages[Number(messageId)] = mergedMessage;
+    });
+    return messages;
+}
+function mergeTypes() {
+    const typeNames = new Set([
+        ...Object.keys(garmin_profile_generated_js_1.GARMIN_TYPES),
+        ...Object.keys(FIT_OVERRIDES.types),
+    ]);
+    return Object.fromEntries([...typeNames].map((typeName) => {
+        var _a, _b;
+        const generatedValues = (_a = garmin_profile_generated_js_1.GARMIN_TYPES[typeName]) !== null && _a !== void 0 ? _a : {};
+        const overrideValues = (_b = FIT_OVERRIDES.types[typeName]) !== null && _b !== void 0 ? _b : {};
+        const values = Object.assign({}, generatedValues);
+        Object.entries(overrideValues).forEach(([valueId, overrideValue]) => {
+            const generatedValue = generatedValues[Number(valueId)];
+            if (generatedValue === undefined
+                || equivalentProfileName(overrideValue, generatedValue)) {
+                values[Number(valueId)] = overrideValue;
+            }
+        });
+        return [typeName, values];
+    }));
+}
+exports.FIT = {
+    scConst: FIT_OVERRIDES.scConst,
+    options: FIT_OVERRIDES.options,
+    messages: mergeMessages(),
+    types: mergeTypes(),
+};