fit-file-parser 2.1.0 → 2.2.1

package/dist/cjs/type_generator.js

@@ -206,6 +206,7 @@ function generateFitType() {
         definitions: 'unknown',
         tank_updates: 'parsed_tank_update',
         tank_summaries: 'parsed_tank_summary',
+        jumps: 'parsed_jump',
     };
     const referenceProperties = {
         file_creator: 'parsed_file_creator',

package/dist/fit-parser.js

@@ -99,6 +99,8 @@ export default class FitParser {
         const lengths = [];
         const tank_updates = [];
         const tank_summaries = [];
+        const jumps = [];
+        const time_in_zone = [];
         let loopIndex = headerLength;
         const messageTypes = [];
         const developerFields = [];
@@ -194,6 +196,12 @@ export default class FitParser {
                 case 'tank_summary':
                     tank_summaries.push(message);
                     break;
+                case 'jump':
+                    jumps.push(message);
+                    break;
+                case 'time_in_zone':
+                    time_in_zone.push(message);
+                    break;
                 default:
                     if (messageType !== '') {
                         fitObj[messageType] = message;
@@ -213,6 +221,8 @@ export default class FitParser {
         fitObj.definitions = definitions;
         fitObj.tank_updates = tank_updates;
         fitObj.tank_summaries = tank_summaries;
+        fitObj.jumps = jumps;
+        fitObj.time_in_zone = time_in_zone;
         if (isCascadeNeeded) {
             laps = mapDataIntoLap(laps, 'records', records);
             laps = mapDataIntoLap(laps, 'lengths', lengths);

package/dist/fit.js

@@ -1080,6 +1080,20 @@ export const FIT = {
                 offset: 0,
                 units: '%',
             },
+            38: {
+                field: 'end_position_lat',
+                type: 'sint32',
+                scale: null,
+                offset: 0,
+                units: 'semicircles',
+            },
+            39: {
+                field: 'end_position_long',
+                type: 'sint32',
+                scale: null,
+                offset: 0,
+                units: 'semicircles',
+            },
             41: {
                 field: 'avg_stroke_count',
                 type: 'uint32',
@@ -1634,7 +1648,7 @@ export const FIT = {
                 units: 'mm',
             },
             137: {
-                field: 'total_anaerobic_effect',
+                field: 'total_anaerobic_training_effect',
                 type: 'uint8',
                 scale: 10,
                 offset: 0,
@@ -1643,9 +1657,9 @@ export const FIT = {
             139: {
                 field: 'avg_vam',
                 type: 'uint16',
-                scale: 1000,
+                scale: 1, // Raw 100 -> 100 (User specific m/h)
                 offset: 0,
-                units: 'm/s',
+                units: 'm/h',
             },
             192: {
                 field: 'workout_feel',
@@ -1661,6 +1675,111 @@ export const FIT = {
                 offset: 0,
                 units: '',
             },
+            110: {
+                field: 'sport_profile_name',
+                type: 'string',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            168: {
+                field: 'training_load_peak',
+                type: 'uint32',
+                scale: 1,
+                offset: 0,
+                units: '',
+            },
+            169: {
+                field: 'enhanced_avg_respiration_rate',
+                type: 'uint16',
+                scale: 100,
+                offset: 0,
+                units: 'breaths/min',
+            },
+            150: {
+                field: 'min_temperature',
+                type: 'sint8',
+                scale: null,
+                offset: 0,
+                units: 'C',
+            },
+            170: {
+                field: 'enhanced_max_respiration_rate',
+                type: 'uint16',
+                scale: 100,
+                offset: 0,
+                units: 'breaths/min',
+            },
+            178: {
+                field: 'est_sweat_loss',
+                type: 'uint16',
+                scale: 1, // ml
+                offset: 0,
+                units: 'ml',
+            },
+            180: {
+                field: 'enhanced_min_respiration_rate',
+                type: 'uint16',
+                scale: 100,
+                offset: 0,
+                units: 'breaths/min',
+            },
+            181: {
+                field: 'total_grit',
+                type: 'float32',
+                scale: 1,
+                offset: 0,
+                units: 'kGrit',
+            },
+            183: {
+                field: 'jump_count',
+                type: 'uint16',
+                scale: 1,
+                offset: 0,
+                units: '',
+            },
+            187: {
+                field: 'avg_flow',
+                type: 'float32',
+                scale: 1,
+                offset: 0,
+                units: 'Flow',
+            },
+            188: {
+                field: 'primary_benefit',
+                type: 'uint8',
+                scale: 1,
+                offset: 0,
+                units: '',
+            },
+            196: {
+                field: 'resting_calories',
+                type: 'uint16',
+                scale: 1,
+                offset: 0,
+                units: 'kcal',
+            },
+            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?
+                scale: 1,
+                offset: 0,
+                units: 'min',
+            },
         },
         19: {
             name: 'lap',
@@ -2404,6 +2523,20 @@ export const FIT = {
                 offset: 0,
                 units: 's',
             },
+            114: {
+                field: 'grit',
+                type: 'float32',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            115: {
+                field: 'flow',
+                type: 'float32',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
             0: {
                 field: 'position_lat',
                 type: 'sint32',
@@ -2855,6 +2988,14 @@ export const FIT = {
                 units: 'percent',
             },
         },
+        140: {
+            name: 'jump',
+            253: { field: 'timestamp', type: 'date_time', scale: null, offset: 0, units: 's' },
+            9: { field: 'distance', type: 'uint16', scale: 100, offset: 0, units: 'm' },
+            10: { field: 'height', type: 'uint16', scale: 1000, offset: 0, units: 'm' },
+            37: { field: 'score', type: 'sint32', scale: null, offset: 0, units: '' },
+            7: { field: 'enhanced_mets', type: 'uint32', scale: 65536, offset: 0, units: 'METs' },
+        },
         21: {
             name: 'event',
             253: {
@@ -2997,6 +3138,13 @@ export const FIT = {
                 offset: 0,
                 units: 'V',
             },
+            32: {
+                field: 'battery_level',
+                type: 'uint8',
+                scale: null,
+                offset: 0,
+                units: 'percent',
+            },
             11: {
                 field: 'battery_status',
                 type: 'battery_status',
@@ -3039,6 +3187,13 @@ export const FIT = {
                 offset: 0,
                 units: '',
             },
+            24: {
+                field: 'ant_id',
+                type: 'uint32z',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
             25: {
                 field: 'source_type',
                 type: 'source_type',
@@ -4483,6 +4638,128 @@ export const FIT = {
                 units: 'cbar',
             },
         },
+        216: {
+            name: 'time_in_zone',
+            253: {
+                field: 'timestamp',
+                type: 'date_time',
+                scale: null,
+                offset: 0,
+                units: 's',
+            },
+            0: {
+                field: 'reference_mesg',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            1: {
+                field: 'reference_index',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            2: {
+                field: 'time_in_hr_zone',
+                type: 'uint32_array',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+            3: {
+                field: 'time_in_speed_zone',
+                type: 'uint32_array',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+            4: {
+                field: 'time_in_power_zone',
+                type: 'uint32_array',
+                scale: 1000,
+                offset: 0,
+                units: 's',
+            },
+            5: {
+                field: 'hr_zone_high_boundary_deprecated',
+                type: 'uint8_array',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            6: {
+                field: 'hr_zone_high_boundary',
+                type: 'uint8_array',
+                scale: null,
+                offset: 0,
+                units: 'bpm',
+            },
+            7: {
+                field: 'speed_zone_high_boundary',
+                type: 'uint16_array',
+                scale: 1000,
+                offset: 0,
+                units: 'm/s',
+            },
+            8: {
+                field: 'power_zone_high_boundary',
+                type: 'uint16_array',
+                scale: null,
+                offset: 0,
+                units: 'watts',
+            },
+            9: {
+                field: 'hr_calc_type',
+                type: 'hr_zone_calc',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            10: {
+                field: 'max_heart_rate_deprecated',
+                type: 'uint8',
+                scale: null,
+                offset: 0,
+                units: 'bpm',
+            },
+            11: {
+                field: 'max_heart_rate',
+                type: 'uint8',
+                scale: null,
+                offset: 0,
+                units: 'bpm',
+            },
+            12: {
+                field: 'resting_heart_rate',
+                type: 'uint8',
+                scale: null,
+                offset: 0,
+                units: 'bpm',
+            },
+            13: {
+                field: 'threshold_heart_rate',
+                type: 'uint8',
+                scale: null,
+                offset: 0,
+                units: 'bpm',
+            },
+            14: {
+                field: 'pwr_calc_type',
+                type: 'pwr_zone_calc',
+                scale: null,
+                offset: 0,
+                units: '',
+            },
+            15: {
+                field: 'functional_threshold_power',
+                type: 'uint16',
+                scale: null,
+                offset: 0,
+                units: 'watts',
+            },
+        },
     },
     types: {
         file: {

package/dist/fit_types.d.ts

@@ -16,7 +16,7 @@ export interface MessageIndex {
     selected: boolean;
 }
 export type File = 'device' | 'settings' | 'sport' | 'activity' | 'workout' | 'course' | 'schedules' | 'weight' | 'totals' | 'goals' | 'blood_pressure' | 'monitoring_a' | 'activity_summary' | 'monitoring_daily' | 'monitoring_b' | 'segment' | 'segment_list' | 'exd_configuration' | 'mfg_range_min' | 'mfg_range_max';
-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' | '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' | 'ant_rx' | 'ant_tx' | 'ant_channel_id' | 'length' | 'monitoring_info' | 'pad' | 'slave_device' | 'connectivity' | 'weather_conditions' | 'weather_alert' | 'cadence_zone' | 'hr' | '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' | 'exd_screen_configuration' | 'exd_data_field_configuration' | 'exd_data_concept_configuration' | 'field_description' | 'developer_data_id' | 'magnetometer_data' | 'barometer_data' | 'one_d_sensor_calibration' | 'set' | 'stress_level' | 'dive_settings' | 'dive_gas' | 'dive_alarm' | 'exercise_title' | 'dive_summary' | 'jump' | 'climb_pro' | 'tank_pressure' | 'tank_summary' | 'mfg_range_min' | 'mfg_range_max' | 'o_hr_settings' | 'tank_update' | 'definition';
+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' | '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' | 'ant_rx' | 'ant_tx' | 'ant_channel_id' | 'length' | 'monitoring_info' | 'pad' | 'slave_device' | 'connectivity' | 'weather_conditions' | 'weather_alert' | 'cadence_zone' | 'hr' | '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' | 'exd_screen_configuration' | 'exd_data_field_configuration' | 'exd_data_concept_configuration' | 'field_description' | 'developer_data_id' | 'magnetometer_data' | 'barometer_data' | 'one_d_sensor_calibration' | 'set' | 'stress_level' | 'dive_settings' | 'dive_gas' | 'dive_alarm' | 'exercise_title' | 'dive_summary' | 'jump' | 'climb_pro' | 'tank_pressure' | 'tank_summary' | 'time_in_zone' | 'mfg_range_min' | 'mfg_range_max' | 'o_hr_settings' | 'tank_update' | 'definition';
 export type Checksum = 'clear' | 'ok';
 export type FileFlags = '0' | 'read' | 'write' | 'erase';
 export type MesgCount = 'num_per_file' | 'max_per_file' | 'max_per_file_type';
@@ -444,8 +444,12 @@ export interface ParsedSession {
     avg_step_length?: number;
     total_anaerobic_effect?: number;
     avg_vam?: number;
+    total_grit?: number;
+    total_flow?: number;
     workout_feel?: number;
     workout_rpe?: number;
+    avg_grit?: number;
+    avg_flow?: number;
     timestamp: string;
     message_index?: MessageIndex;
     laps?: ParsedLap[];
@@ -627,6 +631,8 @@ export interface ParsedRecord {
     ndl_time?: number;
     cns_load?: number;
     n2_load?: number;
+    grit?: number;
+    flow?: number;
     timestamp: string;
 }
 export interface ParsedEvent {
@@ -662,6 +668,7 @@ export interface ParsedDeviceInfo {
     ant_network?: AntNetwork;
     source_type?: SourceType;
     product_name?: string;
+    battery_level?: number;
     timestamp: string;
 }
 export interface ParsedWorkout {
@@ -850,6 +857,12 @@ export interface ParsedOHrSettings {
     enabled?: number;
     timestamp: string;
 }
+export interface ParsedJump {
+    distance?: number;
+    height?: number;
+    score?: number;
+    timestamp: string;
+}
 export interface ParsedFieldDescription {
     developer_data_index?: number;
     field_definition_number?: number;
@@ -939,6 +952,23 @@ export interface ParsedTankSummary {
     end_pressure?: number;
     volume_used?: number;
 }
+export interface ParsedTimeInZone {
+    timestamp: string;
+    reference_mesg?: number;
+    reference_index?: number;
+    time_in_hr_zone?: number[];
+    time_in_speed_zone?: number[];
+    time_in_power_zone?: number[];
+    hr_zone_high_boundary?: number[];
+    speed_zone_high_boundary?: number[];
+    power_zone_high_boundary?: number[];
+    hr_calc_type?: HrZoneCalc;
+    max_heart_rate?: number;
+    resting_heart_rate?: number;
+    threshold_heart_rate?: number;
+    pwr_calc_type?: PwrZoneCalc;
+    functional_threshold_power?: number;
+}
 export interface ParsedFit {
     protocolVersion?: number;
     profileVersion?: number;
@@ -971,4 +1001,6 @@ export interface ParsedFit {
     definitions?: unknown[];
     tank_updates?: ParsedTankUpdate[];
     tank_summaries?: ParsedTankSummary[];
+    jumps?: ParsedJump[];
+    time_in_zone?: ParsedTimeInZone[];
 }

package/dist/helper.js

@@ -2,18 +2,16 @@ export function mapDataIntoLap(inputLaps, lapKey, data) {
     const laps = [...inputLaps];
     let index = 0;
     for (let i = 0; i < laps.length; i++) {
-        const lap = laps[i];
         const nextLap = laps[i + 1];
         const tempData = [];
-        const lapStartTime = new Date(lap.start_time).getTime();
         const nextLapStartTime = nextLap
             ? new Date(nextLap.start_time).getTime()
             : null;
         for (let j = index; j < data.length; j++) {
             const row = data[j];
             if (nextLap && nextLapStartTime) {
-                const timestamp = new Date(row.timestamp).getTime();
-                if (lapStartTime <= timestamp && nextLapStartTime > timestamp) {
+                const timestamp = new Date(row.timestamp || row.start_time).getTime();
+                if (nextLapStartTime > timestamp) {
                     tempData.push(row);
                 }
                 else if (nextLapStartTime <= timestamp) {
@@ -35,10 +33,8 @@ export function mapDataIntoSession(inputSessions, laps) {
     const sessions = [...inputSessions];
     let lapIndex = 0;
     for (let i = 0; i < sessions.length; i++) {
-        const session = sessions[i];
         const nextSession = sessions[i + 1];
         const tempLaps = [];
-        const sessionStartTime = new Date(session.start_time).getTime();
         const nextSessionStartTime = nextSession
             ? new Date(nextSession.start_time).getTime()
             : null;
@@ -46,8 +42,7 @@ export function mapDataIntoSession(inputSessions, laps) {
             const lap = laps[j];
             if (nextSession && nextSessionStartTime) {
                 const lapStartTime = new Date(lap.start_time).getTime();
-                if (sessionStartTime <= lapStartTime
-                    && nextSessionStartTime > lapStartTime) {
+                if (nextSessionStartTime > lapStartTime) {
                     tempLaps.push(lap);
                 }
                 else if (nextSessionStartTime <= lapStartTime) {

package/dist/type_generator.js

@@ -186,6 +186,7 @@ export function generateFitType() {
         definitions: 'unknown',
         tank_updates: 'parsed_tank_update',
         tank_summaries: 'parsed_tank_summary',
+        jumps: 'parsed_jump',
     };
     const referenceProperties = {
         file_creator: 'parsed_file_creator',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fit-file-parser",
   "type": "module",
-  "version": "2.1.0",
+  "version": "2.2.1",
   "private": false,
   "description": "Parse your .FIT files easily, directly from JS (Garmin, Polar, Suunto)",
   "author": {

package/probe_session.js

@@ -0,0 +1,44 @@
+
+import fs from 'fs';
+
+
+// Note: Importing TS directly might not work with node without a loader. 
+// Better to use the built file if available, or use ts-node.
+// But earlier I saw `dist/fit-parser.js`. Let's try to import that if key is default.
+// Actually, let's just use `fs.readFileSync` and basic node. 
+// If `dist` is CJS, I can use `createRequire`.
+
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+
+const FitParserDist = require('./dist/fit-parser.js').default;
+
+const content = fs.readFileSync('/Users/dimitrios/Projects/sports-lib/samples/fit/jumps-mtb.fit');
+const fitParser = new FitParserDist({
+    force: true,
+    speedUnit: 'km/h',
+    lengthUnit: 'm',
+    temperatureUnit: 'celsius',
+    elapsedRecordField: true,
+    mode: 'both',
+});
+
+fitParser.parse(content, (error, data) => {
+    if (error) {
+        console.error(error);
+    } else {
+        const session = data.sessions[0];
+        if (session) {
+            console.log("=== SESSION KEYS & VALUES ===");
+            Object.keys(session).forEach(key => {
+                const val = session[key];
+                console.log(`${key}: ${val}`);
+                if (Math.abs(val - 11) < 0.1) console.log(`>>> MATCH 11 (Jump Count?): ${key}`);
+                if (Math.abs(val - 159) < 0.1) console.log(`>>> MATCH 159 (Resting Cals?): ${key}`);
+                if (Math.abs(val - 6079174) < 1) console.log(`>>> MATCH 6M (Training Load?): ${key}`);
+                if (Math.abs(val - 100) < 0.1) console.log(`>>> MATCH 100 (Avg VAM?): ${key}`);
+                if (Math.abs(val - 2756) < 1) console.log(`>>> MATCH 2756 (Avg Resp?): ${key}`);
+            });
+        }
+    }
+});

package/tsconfig.cjs.json

@@ -1,8 +1,8 @@
 {
-    "extends": "./tsconfig.json",
-    "compilerOptions": {
-        "module": "commonjs",
-        "outDir": "./dist/cjs",
-        "verbatimModuleSyntax": false
-    }
-}
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "outDir": "./dist/cjs",
+    "verbatimModuleSyntax": false
+  }
+}