fit-file-parser 2.3.3 → 3.0.1

package/dist/binary.js

@@ -190,6 +190,13 @@ function isInvalidValue(data, type) {
             return false;
     }
 }
+function isInvalidBaseTypeValue(data, baseTypeNo) {
+    if (Array.isArray(data)) {
+        return false;
+    }
+    const baseType = FIT.types.fit_base_type[baseTypeNo];
+    return typeof baseType === 'string' ? isInvalidValue(data, baseType) : false;
+}
 function convertTo(data, unitsList, unitName) {
     const options = FIT.options[unitsList];
     const unit = options[unitName];
@@ -266,6 +273,7 @@ function applyOptions(data, field, options, fields) {
     }
 }
 export function readRecord(blob, messageTypes, developerFields, startIndex, options, startDate, pausedTime) {
+    var _a, _b;
     const recordHeader = blob[startIndex];
     let localMessageType = recordHeader & 15;
     if ((recordHeader & CompressedHeaderMask) === CompressedHeaderMask) {
@@ -301,7 +309,7 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
                 size: blob[fDefIndex + 1],
                 endianAbility: (baseType & 128) === 128,
                 littleEndian: lEnd,
-                baseTypeNo: baseType & 15,
+                baseTypeNo: baseType,
                 name: field,
                 dataType: getFitMessageBaseType(baseType & 15),
             };
@@ -323,7 +331,7 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
                     size,
                     endianAbility: (baseType & 128) === 128,
                     littleEndian: lEnd,
-                    baseTypeNo: baseType & 15,
+                    baseTypeNo: baseType,
                     name: devDef.field_name,
                     dataType: getFitMessageBaseType(baseType & 15),
                     scale: devDef.scale || 1,
@@ -359,7 +367,7 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
     for (let i = 0; i < messageType.fieldDefs.length; i++) {
         const fDef = messageType.fieldDefs[i];
         const data = readData(blob, fDef, readDataFromIndex, options);
-        if (!isInvalidValue(data, fDef.type)) {
+        if (!isInvalidValue(data, fDef.type) && !isInvalidBaseTypeValue(data, fDef.baseTypeNo)) {
             rawFields.push({ fDef, data });
         }
         readDataFromIndex += fDef.size;
@@ -375,8 +383,8 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
         if (fDef.isDeveloperField) {
             const field = fDef.name;
             const { type } = fDef;
-            const { scale } = fDef;
-            const { offset } = fDef;
+            const scale = (_a = fDef.scale) !== null && _a !== void 0 ? _a : null;
+            const offset = (_b = fDef.offset) !== null && _b !== void 0 ? _b : 0;
             fields[fDef.name] = applyOptions(formatByType(data, type, scale, offset), field, options, fields);
         }
         else {

package/dist/cjs/binary.js

@@ -196,6 +196,13 @@ function isInvalidValue(data, type) {
             return false;
     }
 }
+function isInvalidBaseTypeValue(data, baseTypeNo) {
+    if (Array.isArray(data)) {
+        return false;
+    }
+    const baseType = fit_js_1.FIT.types.fit_base_type[baseTypeNo];
+    return typeof baseType === 'string' ? isInvalidValue(data, baseType) : false;
+}
 function convertTo(data, unitsList, unitName) {
     const options = fit_js_1.FIT.options[unitsList];
     const unit = options[unitName];
@@ -272,6 +279,7 @@ function applyOptions(data, field, options, fields) {
     }
 }
 function readRecord(blob, messageTypes, developerFields, startIndex, options, startDate, pausedTime) {
+    var _a, _b;
     const recordHeader = blob[startIndex];
     let localMessageType = recordHeader & 15;
     if ((recordHeader & CompressedHeaderMask) === CompressedHeaderMask) {
@@ -307,7 +315,7 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
                 size: blob[fDefIndex + 1],
                 endianAbility: (baseType & 128) === 128,
                 littleEndian: lEnd,
-                baseTypeNo: baseType & 15,
+                baseTypeNo: baseType,
                 name: field,
                 dataType: (0, messages_js_1.getFitMessageBaseType)(baseType & 15),
             };
@@ -329,7 +337,7 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
                     size,
                     endianAbility: (baseType & 128) === 128,
                     littleEndian: lEnd,
-                    baseTypeNo: baseType & 15,
+                    baseTypeNo: baseType,
                     name: devDef.field_name,
                     dataType: (0, messages_js_1.getFitMessageBaseType)(baseType & 15),
                     scale: devDef.scale || 1,
@@ -365,7 +373,7 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
     for (let i = 0; i < messageType.fieldDefs.length; i++) {
         const fDef = messageType.fieldDefs[i];
         const data = readData(blob, fDef, readDataFromIndex, options);
-        if (!isInvalidValue(data, fDef.type)) {
+        if (!isInvalidValue(data, fDef.type) && !isInvalidBaseTypeValue(data, fDef.baseTypeNo)) {
             rawFields.push({ fDef, data });
         }
         readDataFromIndex += fDef.size;
@@ -381,8 +389,8 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
         if (fDef.isDeveloperField) {
             const field = fDef.name;
             const { type } = fDef;
-            const { scale } = fDef;
-            const { offset } = fDef;
+            const scale = (_a = fDef.scale) !== null && _a !== void 0 ? _a : null;
+            const offset = (_b = fDef.offset) !== null && _b !== void 0 ? _b : 0;
             fields[fDef.name] = applyOptions(formatByType(data, type, scale, offset), field, options, fields);
         }
         else {

package/dist/cjs/fit-parser.js

@@ -102,8 +102,11 @@ class FitParser {
         const tank_updates = [];
         const tank_summaries = [];
         const jumps = [];
+        const splits = [];
+        const split_summaries = [];
         const time_in_zone = [];
         const activity_metrics = [];
+        const user_metrics = [];
         let loopIndex = headerLength;
         const messageTypes = [];
         const developerFields = [];
@@ -202,12 +205,21 @@ class FitParser {
                 case 'jump':
                     jumps.push(message);
                     break;
+                case 'split':
+                    splits.push(message);
+                    break;
+                case 'split_summary':
+                    split_summaries.push(message);
+                    break;
                 case 'time_in_zone':
                     time_in_zone.push(message);
                     break;
                 case 'activity_metrics':
                     activity_metrics.push(message);
                     break;
+                case 'user_metrics':
+                    user_metrics.push(message);
+                    break;
                 default:
                     if (messageType !== '') {
                         fitObj[messageType] = message;
@@ -228,8 +240,11 @@ class FitParser {
         fitObj.tank_updates = tank_updates;
         fitObj.tank_summaries = tank_summaries;
         fitObj.jumps = jumps;
+        fitObj.splits = splits;
+        fitObj.split_summaries = split_summaries;
         fitObj.time_in_zone = time_in_zone;
         fitObj.activity_metrics = activity_metrics;
+        fitObj.user_metrics = user_metrics;
         if (isCascadeNeeded) {
             laps = (0, helper_js_1.mapDataIntoLap)(laps, 'records', records);
             laps = (0, helper_js_1.mapDataIntoLap)(laps, 'lengths', lengths);
@@ -238,7 +253,9 @@ class FitParser {
                 sessions,
                 events,
                 hrv,
-                device_infos, developer_data_ids: applications, field_descriptions: fieldDescriptions, sports });
+                device_infos, developer_data_ids: applications, field_descriptions: fieldDescriptions, sports,
+                splits,
+                split_summaries });
         }
         if (!isModeCascade) {
             fitObj.sessions = sessions;

package/dist/cjs/fit.js

@@ -1776,6 +1776,27 @@ exports.FIT = {
                 offset: 0,
                 units: 'kcal',
             },
+            205: {
+                field: 'beginning_potential_stamina',
+                type: 'uint8',
+                scale: 1,
+                offset: 0,
+                units: 'percent',
+            },
+            206: {
+                field: 'ending_potential_stamina',
+                type: 'uint8',
+                scale: 1,
+                offset: 0,
+                units: 'percent',
+            },
+            207: {
+                field: 'min_stamina',
+                type: 'uint8',
+                scale: 1,
+                offset: 0,
+                units: 'percent',
+            },
             214: {
                 field: 'avg_grit',
                 type: 'float32',
@@ -3004,6 +3025,292 @@ exports.FIT = {
                 offset: 0,
                 units: 'percent',
             },
+            137: {
+                field: 'potential_stamina',
+                type: 'uint8',
+                scale: 1,
+                offset: 0,
+                units: 'percent',
+            },
+            138: {
+                field: 'stamina',
+                type: 'uint8',
+                scale: 1,
+                offset: 0,
+                units: 'percent',
+            },
+        },
+        312: {
+            name: 'split',
+            254: {
+                field: 'message_index',
+                type: 'message_index',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            0: {
+                field: 'split_type',
+                type: 'split_type',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            1: {
+                field: 'total_elapsed_time',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+            2: {
+                field: 'total_timer_time',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+            3: {
+                field: 'total_distance',
+                type: 'uint32',
+                scale: 100,
+                offset: 0,
+                units: 'm',
+            },
+            4: {
+                field: 'avg_speed',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 'm/s',
+            },
+            9: {
+                field: 'start_time',
+                type: 'date_time',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            13: {
+                field: 'total_ascent',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: 'm',
+            },
+            14: {
+                field: 'total_descent',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: 'm',
+            },
+            21: {
+                field: 'start_position_lat',
+                type: 'sint32',
+                scale: null,
+                offset: 0,
+                units: 'semicircles',
+            },
+            22: {
+                field: 'start_position_long',
+                type: 'sint32',
+                scale: null,
+                offset: 0,
+                units: 'semicircles',
+            },
+            23: {
+                field: 'end_position_lat',
+                type: 'sint32',
+                scale: null,
+                offset: 0,
+                units: 'semicircles',
+            },
+            24: {
+                field: 'end_position_long',
+                type: 'sint32',
+                scale: null,
+                offset: 0,
+                units: 'semicircles',
+            },
+            25: {
+                field: 'max_speed',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 'm/s',
+            },
+            26: {
+                field: 'avg_vert_speed',
+                type: 'sint32',
+                scale: 1000,
+                offset: 0,
+                units: 'm/s',
+            },
+            27: {
+                field: 'end_time',
+                type: 'date_time',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            28: {
+                field: 'total_calories',
+                type: 'uint32',
+                scale: null,
+                offset: 0,
+                units: 'kcal',
+            },
+            74: {
+                field: 'start_elevation',
+                type: 'uint32',
+                scale: 5,
+                offset: -500,
+                units: 'm',
+            },
+            78: {
+                field: 'active_time',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+            107: {
+                field: 'beginning_potential_stamina',
+                type: 'uint8',
+                scale: 1,
+                offset: 0,
+                units: 'percent',
+            },
+            108: {
+                field: 'ending_potential_stamina',
+                type: 'uint8',
+                scale: 1,
+                offset: 0,
+                units: 'percent',
+            },
+            109: {
+                field: 'min_stamina',
+                type: 'uint8',
+                scale: 1,
+                offset: 0,
+                units: 'percent',
+            },
+            110: {
+                field: 'total_moving_time',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+        },
+        313: {
+            name: 'split_summary',
+            254: {
+                field: 'message_index',
+                type: 'message_index',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            0: {
+                field: 'split_type',
+                type: 'split_type',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            3: {
+                field: 'num_splits',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            4: {
+                field: 'total_timer_time',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+            5: {
+                field: 'total_distance',
+                type: 'uint32',
+                scale: 100,
+                offset: 0,
+                units: 'm',
+            },
+            6: {
+                field: 'avg_speed',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 'm/s',
+            },
+            7: {
+                field: 'max_speed',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 'm/s',
+            },
+            8: {
+                field: 'total_ascent',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: 'm',
+            },
+            9: {
+                field: 'total_descent',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: 'm',
+            },
+            10: {
+                field: 'avg_heart_rate',
+                type: 'uint8',
+                scale: null,
+                offset: 0,
+                units: 'bpm',
+            },
+            11: {
+                field: 'max_heart_rate',
+                type: 'uint8',
+                scale: null,
+                offset: 0,
+                units: 'bpm',
+            },
+            12: {
+                field: 'avg_vert_speed',
+                type: 'sint32',
+                scale: 1000,
+                offset: 0,
+                units: 'm/s',
+            },
+            13: {
+                field: 'total_calories',
+                type: 'uint32',
+                scale: null,
+                offset: 0,
+                units: 'kcal',
+            },
+            65: {
+                field: 'active_time',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+            77: {
+                field: 'total_moving_time',
+                type: 'uint32',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
         },
         285: {
             name: 'jump',
@@ -4134,6 +4441,109 @@ exports.FIT = {
                 units: 'counts',
             },
         },
+        // Undocumented Garmin user metrics message. Observed in activity FIT files exported
+        // from Garmin Connect and displayed by fitfileviewer as "User Metrics".
+        79: {
+            name: 'user_metrics',
+            253: {
+                field: 'timestamp',
+                type: 'date_time',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            0: {
+                field: 'vo2_max',
+                type: 'uint16',
+                scale: 1024 / 3.5,
+                offset: 0,
+                units: 'ml/kg/min',
+            },
+            1: {
+                field: 'age',
+                type: 'uint8',
+                scale: null,
+                offset: 0,
+                units: 'years',
+            },
+            2: {
+                field: 'height',
+                type: 'uint8',
+                scale: 100,
+                offset: 0,
+                units: 'm',
+            },
+            3: {
+                field: 'weight',
+                type: 'uint16',
+                scale: 10,
+                offset: 0,
+                units: 'kg',
+            },
+            4: {
+                field: 'gender',
+                type: 'gender',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            6: {
+                field: 'max_heart_rate',
+                type: 'uint8',
+                scale: null,
+                offset: 0,
+                units: 'bpm',
+            },
+            8: {
+                field: 'remaining_recovery_time',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            11: {
+                field: 'lthr',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: 'bpm',
+            },
+            12: {
+                field: 'ltpower',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: 'watts',
+            },
+            13: {
+                field: 'ltspeed',
+                type: 'uint16',
+                scale: 1000,
+                offset: 0,
+                units: 'm/s',
+            },
+            16: {
+                field: 'start_of_activity',
+                type: 'date_time',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            19: {
+                field: 'first_vo2_max',
+                type: 'uint32',
+                scale: 65536 / 3.5,
+                offset: 0,
+                units: 'ml/kg/min',
+            },
+            35: {
+                field: 'end_of_previous_activity',
+                type: 'date_time',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+        },
         103: {
             name: 'monitoring_info',
             253: {
@@ -4930,6 +5340,7 @@ exports.FIT = {
             55: 'monitoring',
             72: 'training_file',
             78: 'hrv',
+            79: 'user_metrics',
             80: 'ant_rx',
             81: 'ant_tx',
             82: 'ant_channel_id',
@@ -4981,6 +5392,8 @@ exports.FIT = {
             264: 'exercise_title',
             268: 'dive_summary',
             285: 'jump',
+            312: 'split',
+            313: 'split_summary',
             317: 'climb_pro',
             319: 'tank_update',
             323: 'tank_summary',
@@ -6497,6 +6910,29 @@ exports.FIT = {
             0: 'starred',
             1: 'suggested',
         },
+        split_type: {
+            1: 'ascent_split',
+            2: 'descent_split',
+            3: 'interval_active',
+            4: 'interval_rest',
+            5: 'interval_warmup',
+            6: 'interval_cooldown',
+            7: 'interval_recovery',
+            8: 'interval_other',
+            9: 'climb_active',
+            10: 'climb_rest',
+            11: 'surf_active',
+            12: 'run_active',
+            13: 'run_rest',
+            14: 'workout_round',
+            17: 'rwd_run',
+            18: 'rwd_walk',
+            21: 'windsurf_active',
+            22: 'rwd_stand',
+            23: 'transition',
+            28: 'ski_lift_split',
+            29: 'ski_run_split',
+        },
         source_type: {
             0: 'ant',
             1: 'antplus',