fit-file-parser 5.2.1 → 6.1.1

package/dist/cjs/binary.js

@@ -528,6 +528,8 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
             && options.includeRawDeveloperFields.includes(messageType.globalMessageNumber));
     const rawFields = includeRawMessage ? [] : undefined;
     const rawDeveloperFields = includeRawDeveloperFields || includeRawMessage ? [] : undefined;
+    const unmappedFields = options.includeUnmappedMessages ? [] : undefined;
+    const unmappedDeveloperFields = options.includeUnmappedMessages ? [] : undefined;
     if (retainsRawMessages(options)) {
         const nativeSize = messageType.fieldDefs.reduce((total, field, index) => (total + (isCompressedTimestamp && index === 0 && field.fDefNo === 253 ? 0 : field.size)), 0);
         const developerSize = developerFieldDefs.reduce((total, field) => total + field.size, 0);
@@ -543,12 +545,17 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
             rawData[i] = InvalidFieldData;
             continue;
         }
-        if (rawFields && readDataFromIndex + fDef.size <= dataEnd) {
-            rawFields.push({
+        if ((rawFields || (unmappedFields && !isOutputFieldName(fDef.name)))
+            && readDataFromIndex + fDef.size <= dataEnd) {
+            const rawField = {
                 fieldDefinitionNumber: fDef.fDefNo,
                 baseType: fDef.baseTypeNo,
                 rawValue: Array.from(blob.subarray(readDataFromIndex, readDataFromIndex + fDef.size)),
-            });
+            };
+            rawFields === null || rawFields === void 0 ? void 0 : rawFields.push(rawField);
+            if (!isOutputFieldName(fDef.name)) {
+                unmappedFields === null || unmappedFields === void 0 ? void 0 : unmappedFields.push(rawField);
+            }
         }
         const data = readData(blob, dataView, fDef, readDataFromIndex);
         if (data !== InvalidFieldData
@@ -572,15 +579,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;
-        if (rawDeveloperFields
+        let rawDeveloperField;
+        if ((rawDeveloperFields
+            || (unmappedDeveloperFields && developerFieldDef.resolvedFieldDef === undefined))
             && readDataFromIndex + developerFieldDef.size <= dataEnd) {
-            rawDeveloperFields.push({
+            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 (fDef) {
             const data = readData(blob, dataView, fDef, readDataFromIndex);
             if (data !== InvalidFieldData
@@ -698,6 +711,10 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
         message: fields,
         rawFields,
         rawDeveloperFields,
+        unmappedFields: unmappedFields && unmappedFields.length > 0 ? unmappedFields : undefined,
+        unmappedDeveloperFields: unmappedDeveloperFields && unmappedDeveloperFields.length > 0
+            ? unmappedDeveloperFields
+            : undefined,
     };
 }
 function getArrayBuffer(buffer) {

package/dist/cjs/fit-parser.d.ts

@@ -3,6 +3,9 @@ import type { ParsedFit } from './fit_types.js';
 export { FitBaseType, FitEncoder } from './fit-encoder.js';
 export type { FitEncoderField, FitEncoderOptions } from './fit-encoder.js';
 export type { ParsedFit, ParsedRawDeveloperField, ParsedRawFitField, ParsedRawFitMessage, ParsedRawFitMessageDeveloperField, } from './fit_types.js';
+export { getFitCoursePointId, getFitGarminProductDisplayName, getFitGarminProductName, getFitManufacturerName, getFitSportId, getFitSportName, getFitSubSportId, getFitSubSportName, } from './profile-lookup.js';
+export { FitMessageReaderError, fitTimestampToUnixMilliseconds, getFitBaseTypeId, readFitMessages, readFitStringField, readFitUnsignedField, } from './raw-message-reader.js';
+export type { FitMessageReaderErrorCode, FitMessageReaderIssue, FitMessageReaderIssueCode, FitMessageReaderOptions, FitMessageReaderResult, FitRawDeveloperField, FitRawField, FitRawMessage, } from './raw-message-reader.js';
 export interface FitParserOptions {
     force?: boolean;
     speedUnit?: string;
@@ -15,6 +18,8 @@ export interface FitParserOptions {
     includeRawDeveloperFields?: boolean | readonly number[];
     /** Retains exact native and developer fields for all or selected global message numbers. */
     includeRawMessages?: boolean | readonly number[];
+    /** Retains exact bytes for fields that have no semantic profile mapping. */
+    includeUnmappedMessages?: boolean;
     /** Returns only parser metadata and retained raw messages instead of decoded activity collections. */
     rawMessagesOnly?: boolean;
 }

package/dist/cjs/fit-parser.js

@@ -1,14 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FitEncoder = exports.FitBaseType = void 0;
+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");
 const helper_js_1 = require("./helper.js");
 var fit_encoder_js_1 = require("./fit-encoder.js");
 Object.defineProperty(exports, "FitBaseType", { enumerable: true, get: function () { return fit_encoder_js_1.FitBaseType; } });
 Object.defineProperty(exports, "FitEncoder", { enumerable: true, get: function () { return fit_encoder_js_1.FitEncoder; } });
+var profile_lookup_js_1 = require("./profile-lookup.js");
+Object.defineProperty(exports, "getFitCoursePointId", { enumerable: true, get: function () { return profile_lookup_js_1.getFitCoursePointId; } });
+Object.defineProperty(exports, "getFitGarminProductDisplayName", { enumerable: true, get: function () { return profile_lookup_js_1.getFitGarminProductDisplayName; } });
+Object.defineProperty(exports, "getFitGarminProductName", { enumerable: true, get: function () { return profile_lookup_js_1.getFitGarminProductName; } });
+Object.defineProperty(exports, "getFitManufacturerName", { enumerable: true, get: function () { return profile_lookup_js_1.getFitManufacturerName; } });
+Object.defineProperty(exports, "getFitSportId", { enumerable: true, get: function () { return profile_lookup_js_1.getFitSportId; } });
+Object.defineProperty(exports, "getFitSportName", { enumerable: true, get: function () { return profile_lookup_js_1.getFitSportName; } });
+Object.defineProperty(exports, "getFitSubSportId", { enumerable: true, get: function () { return profile_lookup_js_1.getFitSubSportId; } });
+Object.defineProperty(exports, "getFitSubSportName", { enumerable: true, get: function () { return profile_lookup_js_1.getFitSubSportName; } });
+var raw_message_reader_js_1 = require("./raw-message-reader.js");
+Object.defineProperty(exports, "FitMessageReaderError", { enumerable: true, get: function () { return raw_message_reader_js_1.FitMessageReaderError; } });
+Object.defineProperty(exports, "fitTimestampToUnixMilliseconds", { enumerable: true, get: function () { return raw_message_reader_js_1.fitTimestampToUnixMilliseconds; } });
+Object.defineProperty(exports, "getFitBaseTypeId", { enumerable: true, get: function () { return raw_message_reader_js_1.getFitBaseTypeId; } });
+Object.defineProperty(exports, "readFitMessages", { enumerable: true, get: function () { return raw_message_reader_js_1.readFitMessages; } });
+Object.defineProperty(exports, "readFitStringField", { enumerable: true, get: function () { return raw_message_reader_js_1.readFitStringField; } });
+Object.defineProperty(exports, "readFitUnsignedField", { enumerable: true, get: function () { return raw_message_reader_js_1.readFitUnsignedField; } });
 class FitParser {
     constructor(options = {}) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
         this.options = {
             force: options.force != null ? options.force : true,
             speedUnit: options.speedUnit || 'm/s',
@@ -19,7 +35,8 @@ class FitParser {
             mode: options.mode || 'list',
             includeRawDeveloperFields: (_a = options.includeRawDeveloperFields) !== null && _a !== void 0 ? _a : false,
             includeRawMessages: (_b = options.includeRawMessages) !== null && _b !== void 0 ? _b : false,
-            rawMessagesOnly: (_c = options.rawMessagesOnly) !== null && _c !== void 0 ? _c : false,
+            includeUnmappedMessages: (_c = options.includeUnmappedMessages) !== null && _c !== void 0 ? _c : false,
+            rawMessagesOnly: (_d = options.rawMessagesOnly) !== null && _d !== void 0 ? _d : false,
         };
     }
     parseAsync(content) {
@@ -130,6 +147,7 @@ class FitParser {
             || Array.isArray(this.options.includeRawMessages)
             ? []
             : undefined;
+        const unmappedMessages = this.options.includeUnmappedMessages ? [] : undefined;
         const messageCountsByGlobalNumber = new Map();
         let loopIndex = headerLength;
         const messageTypes = [];
@@ -141,7 +159,7 @@ class FitParser {
         let lastStopTimestamp;
         let pausedTime = 0;
         while (loopIndex < crcStart) {
-            const { globalMessageNumber, littleEndian, message, messageType, nextIndex, compressedTimestamp, rawFields: recordRawFields, rawDeveloperFields: recordRawDeveloperFields, } = (0, binary_js_1.readRecord)(blob, messageTypes, developerFields, loopIndex, this.options, startDate, pausedTime, dataView, decoderState, 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);
             loopIndex = nextIndex;
             if (globalMessageNumber !== undefined) {
                 const messageIndex = (_a = messageCountsByGlobalNumber.get(globalMessageNumber)) !== null && _a !== void 0 ? _a : 0;
@@ -168,6 +186,20 @@ class FitParser {
                         raw_value: field.rawValue,
                     });
                 });
+                if (littleEndian !== undefined
+                    && ((recordUnmappedFields === null || recordUnmappedFields === void 0 ? void 0 : recordUnmappedFields.length) || (recordUnmappedDeveloperFields === null || recordUnmappedDeveloperFields === void 0 ? void 0 : recordUnmappedDeveloperFields.length))) {
+                    unmappedMessages === null || unmappedMessages === void 0 ? void 0 : unmappedMessages.push(Object.assign(Object.assign({ global_message_number: globalMessageNumber, message_index: messageIndex, little_endian: littleEndian }, (compressedTimestamp === undefined
+                        ? {}
+                        : { compressed_timestamp: compressedTimestamp })), { fields: (recordUnmappedFields !== null && recordUnmappedFields !== void 0 ? recordUnmappedFields : []).map(field => ({
+                            field_definition_number: field.fieldDefinitionNumber,
+                            base_type: field.baseType,
+                            raw_value: field.rawValue,
+                        })), developer_fields: (recordUnmappedDeveloperFields !== null && recordUnmappedDeveloperFields !== void 0 ? recordUnmappedDeveloperFields : []).map(field => ({
+                            developer_data_index: field.developerDataIndex,
+                            field_definition_number: field.fieldDefinitionNumber,
+                            raw_value: field.rawValue,
+                        })) }));
+                }
             }
             if (this.options.rawMessagesOnly) {
                 continue;
@@ -298,6 +330,9 @@ class FitParser {
             if (rawMessages) {
                 fitObj.raw_messages = rawMessages;
             }
+            if (unmappedMessages && unmappedMessages.length > 0) {
+                fitObj.unmapped_messages = unmappedMessages;
+            }
             callback(undefined, fitObj);
             return;
         }
@@ -326,6 +361,9 @@ class FitParser {
         if (rawMessages) {
             fitObj.raw_messages = rawMessages;
         }
+        if (unmappedMessages && unmappedMessages.length > 0) {
+            fitObj.unmapped_messages = unmappedMessages;
+        }
         if (isCascadeNeeded) {
             laps = (0, helper_js_1.mapDataIntoLap)(laps, 'records', records);
             laps = (0, helper_js_1.mapDataIntoLap)(laps, 'lengths', lengths);

package/dist/cjs/fit.d.ts

@@ -37,10 +37,4 @@ export interface FitType {
     messages: Record<number, Message>;
     types: Record<string, Record<number, string | number>>;
 }
-/**
- * Garmin fields observed in the external FIT corpus but absent from the pinned
- * public SDK profile. These additions may not replace standard SDK fields.
- */
-export declare const FIT_VENDOR_MESSAGE_EXTENSIONS: Record<number, Message>;
-export declare const FIT_VENDOR_TYPE_EXTENSIONS: Record<string, Record<number, string>>;
 export declare const FIT: FitType;

package/dist/cjs/fit.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FIT = exports.FIT_VENDOR_TYPE_EXTENSIONS = exports.FIT_VENDOR_MESSAGE_EXTENSIONS = void 0;
-const garmin_profile_generated_js_1 = require("./garmin_profile.generated.js");
+exports.FIT = void 0;
+const profile_js_1 = require("./profile.js");
 const metersInOneKilometer = 1000;
 const secondsInOneHour = 3600;
 // according to https://en.wikipedia.org/wiki/Mile
@@ -31,119 +31,9 @@ const options = {
         psi: { multiplier: psiInOneBar, offset: 0 },
     },
 };
-/**
- * Garmin fields observed in the external FIT corpus but absent from the pinned
- * public SDK profile. These additions may not replace standard SDK fields.
- */
-exports.FIT_VENDOR_MESSAGE_EXTENSIONS = {
-    18: {
-        name: 'session',
-        178: field('est_sweat_loss', 'uint16', 1, 'ml'),
-        188: field('primary_benefit', 'uint8'),
-        205: field('beginning_potential_stamina', 'uint8', 1, 'percent'),
-        206: field('ending_potential_stamina', 'uint8', 1, 'percent'),
-        207: field('min_stamina', 'uint8', 1, 'percent'),
-    },
-    20: {
-        name: 'record',
-        90: field('garmin_performance_condition', 'sint8'),
-        137: field('potential_stamina', 'uint8', 1, 'percent'),
-        138: field('stamina', 'uint8', 1, 'percent'),
-    },
-    23: {
-        name: 'device_info',
-        24: field('ant_id', 'uint32z'),
-    },
-    // Undocumented Garmin user metrics message observed in activity FIT files.
-    79: {
-        name: 'user_metrics',
-        0: field('vo2_max', 'uint16', 1024 / 3.5, 'ml/kg/min'),
-        1: field('age', 'uint8', 1, 'years'),
-        2: field('height', 'uint8', 100, 'm'),
-        3: field('weight', 'uint16', 10, 'kg'),
-        4: field('gender', 'gender'),
-        6: field('max_heart_rate', 'uint8', 1, 'bpm'),
-        8: field('remaining_recovery_time', 'uint16'),
-        11: field('lthr', 'uint16', 1, 'bpm'),
-        12: field('ltpower', 'uint16', 1, 'watts'),
-        13: field('ltspeed', 'uint16', 1000, 'm/s'),
-        16: field('start_of_activity', 'date_time'),
-        19: field('first_vo2_max', 'uint32', 65536 / 3.5, 'ml/kg/min'),
-        35: field('end_of_previous_activity', 'date_time'),
-        253: field('timestamp', 'date_time'),
-    },
-    // Undocumented Garmin activity metrics message observed in activity FIT files.
-    140: {
-        name: 'activity_metrics',
-        1: field('new_max_heart_rate', 'uint8', 1, 'bpm'),
-        4: field('aerobic_training_effect', 'uint8', 10),
-        7: field('vo2_max', 'uint32', 65536 / 3.5, 'ml/kg/min'),
-        9: field('recovery_time', 'uint16', 1, 'min'),
-        11: field('sport', 'sport'),
-        20: field('anaerobic_training_effect', 'uint8', 10),
-        29: field('first_vo2_max', 'uint32', 65536 / 3.5, 'ml/kg/min'),
-        41: field('primary_benefit', 'uint8'),
-        60: field('total_ascent', 'uint16', 1, 'm'),
-        61: field('total_descent', 'uint16', 1, 'm'),
-        62: field('avg_power', 'uint16', 1, 'watts'),
-        63: field('avg_heart_rate', 'uint8', 1, 'bpm'),
-    },
-    312: {
-        name: 'split',
-        107: field('beginning_potential_stamina', 'uint8', 1, 'percent'),
-        108: field('ending_potential_stamina', 'uint8', 1, 'percent'),
-        109: field('min_stamina', 'uint8', 1, 'percent'),
-    },
-};
-exports.FIT_VENDOR_TYPE_EXTENSIONS = {
-    mesg_num: {
-        79: 'user_metrics',
-        140: 'activity_metrics',
-    },
-};
-function field(name, type, scale = 1, units = '', baseType) {
-    return Object.assign(Object.assign({ field: name, type }, (baseType ? { baseType } : {})), { scale, offset: 0, units });
-}
-function mergeVendorMessages() {
-    const messages = Object.assign({}, garmin_profile_generated_js_1.GARMIN_MESSAGES);
-    Object.entries(exports.FIT_VENDOR_MESSAGE_EXTENSIONS).forEach(([messageIdText, extension]) => {
-        const messageId = Number(messageIdText);
-        const standardMessage = messages[messageId];
-        if (!standardMessage) {
-            messages[messageId] = extension;
-            return;
-        }
-        if (standardMessage.name !== extension.name) {
-            throw new Error(`Vendor message ${messageId} conflicts with the Garmin SDK name`);
-        }
-        Object.keys(extension)
-            .filter(key => key !== 'name')
-            .forEach((fieldId) => {
-            if (standardMessage[Number(fieldId)]) {
-                throw new Error(`Vendor message ${messageId}, field ${fieldId} conflicts with the Garmin SDK profile`);
-            }
-        });
-        messages[messageId] = Object.assign(Object.assign({}, standardMessage), extension);
-    });
-    return messages;
-}
-function mergeVendorTypes() {
-    const types = Object.fromEntries(Object.entries(garmin_profile_generated_js_1.GARMIN_TYPES).map(([name, values]) => [name, Object.assign({}, values)]));
-    Object.entries(exports.FIT_VENDOR_TYPE_EXTENSIONS).forEach(([name, extension]) => {
-        var _a;
-        const standardValues = (_a = types[name]) !== null && _a !== void 0 ? _a : {};
-        Object.keys(extension).forEach((valueId) => {
-            if (standardValues[Number(valueId)] !== undefined) {
-                throw new Error(`Vendor type ${name}, value ${valueId} conflicts with the Garmin SDK profile`);
-            }
-        });
-        types[name] = Object.assign(Object.assign({}, standardValues), extension);
-    });
-    return types;
-}
 exports.FIT = {
     scConst: 180 / Math.pow(2, 31),
     options,
-    messages: mergeVendorMessages(),
-    types: mergeVendorTypes(),
+    messages: profile_js_1.PROFILE_MESSAGES,
+    types: profile_js_1.PROFILE_TYPES,
 };

package/dist/cjs/fit_types.d.ts

@@ -213,7 +213,7 @@ export type SportEvent = 'uncategorized' | 'geocaching' | 'fitness' | 'recreatio
 export type SquatExerciseName = 'leg_press' | 'back_squat_with_body_bar' | 'back_squats' | 'weighted_back_squats' | 'balancing_squat' | 'weighted_balancing_squat' | 'barbell_back_squat' | 'barbell_box_squat' | 'barbell_front_squat' | 'barbell_hack_squat' | 'barbell_hang_squat_snatch' | 'barbell_lateral_step_up' | 'barbell_quarter_squat' | 'barbell_siff_squat' | 'barbell_squat_snatch' | 'barbell_squat_with_heels_raised' | 'barbell_stepover' | 'barbell_step_up' | 'bench_squat_with_rotational_chop' | 'weighted_bench_squat_with_rotational_chop' | 'body_weight_wall_squat' | 'weighted_wall_squat' | 'box_step_squat' | 'weighted_box_step_squat' | 'braced_squat' | 'crossed_arm_barbell_front_squat' | 'crossover_dumbbell_step_up' | 'dumbbell_front_squat' | 'dumbbell_split_squat' | 'dumbbell_squat' | 'dumbbell_squat_clean' | 'dumbbell_stepover' | 'dumbbell_step_up' | 'elevated_single_leg_squat' | 'weighted_elevated_single_leg_squat' | 'figure_four_squats' | 'weighted_figure_four_squats' | 'goblet_squat' | 'kettlebell_squat' | 'kettlebell_swing_overhead' | 'kettlebell_swing_with_flip_to_squat' | 'lateral_dumbbell_step_up' | 'one_legged_squat' | 'overhead_dumbbell_squat' | 'overhead_squat' | 'partial_single_leg_squat' | 'weighted_partial_single_leg_squat' | 'pistol_squat' | 'weighted_pistol_squat' | 'plie_slides' | 'weighted_plie_slides' | 'plie_squat' | 'weighted_plie_squat' | 'prisoner_squat' | 'weighted_prisoner_squat' | 'single_leg_bench_get_up' | 'weighted_single_leg_bench_get_up' | 'single_leg_bench_squat' | 'weighted_single_leg_bench_squat' | 'single_leg_squat_on_swiss_ball' | 'weighted_single_leg_squat_on_swiss_ball' | 'squat' | 'weighted_squat' | 'squats_with_band' | 'staggered_squat' | 'weighted_staggered_squat' | 'step_up' | 'weighted_step_up' | 'suitcase_squats' | 'sumo_squat' | 'sumo_squat_slide_in' | 'weighted_sumo_squat_slide_in' | 'sumo_squat_to_high_pull' | 'sumo_squat_to_stand' | 'weighted_sumo_squat_to_stand' | 'sumo_squat_with_rotation' | 'weighted_sumo_squat_with_rotation' | 'swiss_ball_body_weight_wall_squat' | 'weighted_swiss_ball_wall_squat' | 'thrusters' | 'uneven_squat' | 'weighted_uneven_squat' | 'waist_slimming_squat' | 'wall_ball' | 'wide_stance_barbell_squat' | 'wide_stance_goblet_squat' | 'zercher_squat' | 'kbs_overhead' | 'squat_and_side_kick' | 'squat_jumps_in_n_out' | 'pilates_plie_squats_parallel_turned_out_flat_and_heels' | 'releve_straight_leg_and_knee_bent_with_one_leg_variation' | 'alternating_box_dumbbell_step_ups' | 'dumbbell_overhead_squat_single_arm' | 'dumbbell_squat_snatch' | 'medicine_ball_squat' | 'wall_ball_squat_and_press' | 'squat_american_swing' | 'air_squat' | 'dumbbell_thrusters' | 'overhead_barbell_squat' | number;
 export type StairStepperExerciseName = 'stair_stepper' | number;
 export type StrokeType = 'no_event' | 'other' | 'serve' | 'forehand' | 'backhand' | 'smash' | number;
-export type SubSport = 'generic' | 'treadmill' | 'street' | 'trail' | 'track' | 'spin' | 'indoor_cycling' | 'road' | 'mountain' | 'downhill' | 'recumbent' | 'cyclocross' | 'hand_cycling' | 'track_cycling' | 'indoor_rowing' | 'elliptical' | 'stair_climbing' | 'lap_swimming' | 'open_water' | 'flexibility_training' | 'strength_training' | 'warm_up' | 'match' | 'exercise' | 'challenge' | 'indoor_skiing' | 'cardio_training' | 'indoor_walking' | 'e_bike_fitness' | 'bmx' | 'casual_walking' | 'speed_walking' | 'bike_to_run_transition' | 'run_to_bike_transition' | 'swim_to_bike_transition' | 'atv' | 'motocross' | 'backcountry' | 'resort' | 'rc_drone' | 'wingsuit' | 'whitewater' | 'skate_skiing' | 'yoga' | 'pilates' | 'indoor_running' | 'gravel_cycling' | 'e_bike_mountain' | 'commuting' | 'mixed_surface' | 'navigate' | 'track_me' | 'map' | 'single_gas_diving' | 'multi_gas_diving' | 'gauge_diving' | 'apnea_diving' | 'apnea_hunting' | 'virtual_activity' | 'obstacle' | 'breathing' | 'ccr_diving' | 'sail_race' | 'expedition' | 'ultra' | 'indoor_climbing' | 'bouldering' | 'hiit' | 'indoor_grinding' | 'hunting_with_dogs' | 'amrap' | 'emom' | 'tabata' | 'esport' | 'triathlon' | 'duathlon' | 'brick' | 'swim_run' | 'adventure_race' | 'trucker_workout' | 'pickleball' | 'padel' | 'indoor_wheelchair_walk' | 'indoor_wheelchair_run' | 'indoor_hand_cycling' | 'field' | 'ice' | 'ultimate' | 'platform' | 'squash' | 'badminton' | 'racquetball' | 'table_tennis' | 'overland' | 'trolling_motor' | 'fly_canopy' | 'fly_paraglide' | 'fly_paramotor' | 'fly_pressurized' | 'fly_navigate' | 'fly_timer' | 'fly_altimeter' | 'fly_wx' | 'fly_vfr' | 'fly_ifr' | 'dynamic_apnea' | 'enduro' | 'rucking' | 'rally' | 'pool_triathlon' | 'e_bike_enduro' | 'all' | number;
+export type SubSport = 'generic' | 'treadmill' | 'street' | 'trail' | 'track' | 'spin' | 'indoor_cycling' | 'road' | 'mountain' | 'downhill' | 'recumbent' | 'cyclocross' | 'hand_cycling' | 'track_cycling' | 'indoor_rowing' | 'elliptical' | 'stair_climbing' | 'lap_swimming' | 'open_water' | 'flexibility_training' | 'strength_training' | 'warm_up' | 'match' | 'exercise' | 'challenge' | 'indoor_skiing' | 'cardio_training' | 'indoor_walking' | 'e_bike_fitness' | 'bmx' | 'casual_walking' | 'speed_walking' | 'bike_to_run_transition' | 'run_to_bike_transition' | 'swim_to_bike_transition' | 'atv' | 'motocross' | 'backcountry' | 'resort' | 'rc_drone' | 'wingsuit' | 'whitewater' | 'skate_skiing' | 'yoga' | 'pilates' | 'indoor_running' | 'gravel_cycling' | 'e_bike_mountain' | 'commuting' | 'mixed_surface' | 'navigate' | 'track_me' | 'map' | 'single_gas_diving' | 'multi_gas_diving' | 'gauge_diving' | 'apnea_diving' | 'apnea_hunting' | 'virtual_activity' | 'obstacle' | 'breathing' | 'ccr_diving' | 'sail_race' | 'expedition' | 'ultra' | 'indoor_climbing' | 'bouldering' | 'hiit' | 'indoor_grinding' | 'hunting_with_dogs' | 'amrap' | 'emom' | 'tabata' | 'esport' | 'triathlon' | 'duathlon' | 'brick' | 'swim_run' | 'adventure_race' | 'trucker_workout' | 'pickleball' | 'padel' | 'indoor_wheelchair_walk' | 'indoor_wheelchair_run' | 'indoor_hand_cycling' | 'field' | 'ice' | 'ultimate' | 'platform' | 'squash' | 'badminton' | 'racquetball' | 'table_tennis' | 'overland' | 'trolling_motor' | 'fly_canopy' | 'fly_paraglide' | 'fly_paramotor' | 'fly_pressurized' | 'fly_navigate' | 'fly_timer' | 'fly_altimeter' | 'fly_wx' | 'fly_vfr' | 'fly_ifr' | 'dynamic_apnea' | 'enduro' | 'rucking' | 'rally' | 'pool_triathlon' | 'e_bike_enduro' | 'mountain_enduro' | 'mountain_downhill' | 'all' | number;
 export type SupportedExdScreenLayouts = 'full_screen' | 'half_vertical' | 'half_horizontal' | 'half_vertical_right_split' | 'half_horizontal_bottom_split' | 'full_quarter_split' | 'half_vertical_left_split' | 'half_horizontal_top_split' | number;
 export type SuspensionExerciseName = 'chest_fly' | 'chest_press' | 'crunch' | 'curl' | 'dip' | 'face_pull' | 'glute_bridge' | 'hamstring_curl' | 'hip_drop' | 'inverted_row' | 'knee_drive_jump' | 'knee_to_chest' | 'lat_pullover' | 'lunge' | 'mountain_climber' | 'pendulum' | 'pike' | 'plank' | 'power_pull' | 'pull_up' | 'push_up' | 'reverse_mountain_climber' | 'reverse_plank' | 'rollout' | 'row' | 'side_lunge' | 'side_plank' | 'single_leg_deadlift' | 'single_leg_squat' | 'sit_up' | 'split' | 'squat' | 'squat_jump' | 'tricep_press' | 'y_fly' | number;
 export type SwimStroke = 'freestyle' | 'backstroke' | 'breaststroke' | 'butterfly' | 'drill' | 'mixed' | 'im' | 'im_by_round' | 'rimo' | number;
@@ -2097,6 +2097,7 @@ export interface ParsedFit {
     messages?: ParsedMessages;
     raw_developer_fields?: ParsedRawDeveloperField[];
     raw_messages?: ParsedRawFitMessage[];
+    unmapped_messages?: ParsedRawFitMessage[];
     file_creator: ParsedFileCreator;
     device_settings: ParsedDeviceSettings;
     dive_summary?: ParsedDiveSummary;

package/dist/cjs/profile-lookup.d.ts

@@ -0,0 +1,19 @@
+/** Resolves a FIT manufacturer identifier to its canonical profile name. */
+export declare function getFitManufacturerName(value: number | string | null | undefined): string | null;
+/** Resolves a Garmin product identifier to its canonical profile name. */
+export declare function getFitGarminProductName(value: number | string | null | undefined): string | null;
+/** Resolves a FIT sport identifier to its canonical profile name. */
+export declare function getFitSportName(value: number | string | null | undefined): string | null;
+/** Resolves a FIT sub-sport identifier to its canonical profile name. */
+export declare function getFitSubSportName(value: number | string | null | undefined): string | null;
+/** Resolves a FIT sport name to its numeric profile identifier. */
+export declare function getFitSportId(value: string | null | undefined): number | null;
+/** Resolves a FIT sub-sport name to its numeric profile identifier. */
+export declare function getFitSubSportId(value: string | null | undefined): number | null;
+/** Resolves a FIT course-point name to its numeric profile identifier. */
+export declare function getFitCoursePointId(value: string | null | undefined): number | null;
+/**
+ * Resolves a Garmin product identifier to a human-readable device name.
+ * This does not alter parsed `product` or `product_name` fields.
+ */
+export declare function getFitGarminProductDisplayName(value: number | string | null | undefined): string | null;

package/dist/cjs/profile-lookup.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getFitManufacturerName = getFitManufacturerName;
+exports.getFitGarminProductName = getFitGarminProductName;
+exports.getFitSportName = getFitSportName;
+exports.getFitSubSportName = getFitSubSportName;
+exports.getFitSportId = getFitSportId;
+exports.getFitSubSportId = getFitSubSportId;
+exports.getFitCoursePointId = getFitCoursePointId;
+exports.getFitGarminProductDisplayName = getFitGarminProductDisplayName;
+const profile_js_1 = require("./profile.js");
+function normalizeProfileName(value) {
+    return value.trim().toLowerCase().replace(/[\s_-]/g, '');
+}
+const FIT_PROFILE_MANUFACTURERS = profile_js_1.PROFILE_TYPES.manufacturer;
+const FIT_PROFILE_GARMIN_PRODUCTS = profile_js_1.PROFILE_TYPES.garmin_product;
+const FIT_PROFILE_SPORTS = profile_js_1.PROFILE_TYPES.sport;
+const FIT_PROFILE_SUB_SPORTS = profile_js_1.PROFILE_TYPES.sub_sport;
+const FIT_PROFILE_COURSE_POINTS = profile_js_1.PROFILE_TYPES.course_point;
+function createProfileIdMap(mapping) {
+    return new Map(Object.entries(mapping)
+        .filter((entry) => typeof entry[1] === 'string')
+        .map(([id, name]) => [normalizeProfileName(name), Number(id)]));
+}
+const FIT_PROFILE_SPORT_IDS = createProfileIdMap(FIT_PROFILE_SPORTS);
+const FIT_PROFILE_SUB_SPORT_IDS = createProfileIdMap(FIT_PROFILE_SUB_SPORTS);
+const FIT_PROFILE_COURSE_POINT_IDS = createProfileIdMap(FIT_PROFILE_COURSE_POINTS);
+function getProfileName(mapping, value) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    if (typeof value !== 'number' && typeof value !== 'string') {
+        return null;
+    }
+    const normalizedValue = typeof value === 'string' ? value.trim() : value;
+    if (normalizedValue === '' || (typeof normalizedValue === 'string' && !/^\d+$/.test(normalizedValue))) {
+        return null;
+    }
+    const id = Number(normalizedValue);
+    if (!Number.isSafeInteger(id) || id < 0) {
+        return null;
+    }
+    const name = mapping[id];
+    return typeof name === 'string' ? name : null;
+}
+function getProfileId(mapping, value) {
+    var _a;
+    if (typeof value !== 'string') {
+        return null;
+    }
+    const name = normalizeProfileName(value);
+    if (name === '') {
+        return null;
+    }
+    return (_a = mapping.get(name)) !== null && _a !== void 0 ? _a : null;
+}
+/** Resolves a FIT manufacturer identifier to its canonical profile name. */
+function getFitManufacturerName(value) {
+    return getProfileName(FIT_PROFILE_MANUFACTURERS, value);
+}
+/** Resolves a Garmin product identifier to its canonical profile name. */
+function getFitGarminProductName(value) {
+    return getProfileName(FIT_PROFILE_GARMIN_PRODUCTS, value);
+}
+/** Resolves a FIT sport identifier to its canonical profile name. */
+function getFitSportName(value) {
+    return getProfileName(FIT_PROFILE_SPORTS, value);
+}
+/** Resolves a FIT sub-sport identifier to its canonical profile name. */
+function getFitSubSportName(value) {
+    return getProfileName(FIT_PROFILE_SUB_SPORTS, value);
+}
+/** Resolves a FIT sport name to its numeric profile identifier. */
+function getFitSportId(value) {
+    return getProfileId(FIT_PROFILE_SPORT_IDS, value);
+}
+/** Resolves a FIT sub-sport name to its numeric profile identifier. */
+function getFitSubSportId(value) {
+    return getProfileId(FIT_PROFILE_SUB_SPORT_IDS, value);
+}
+/** Resolves a FIT course-point name to its numeric profile identifier. */
+function getFitCoursePointId(value) {
+    return getProfileId(FIT_PROFILE_COURSE_POINT_IDS, value);
+}
+/**
+ * Resolves a Garmin product identifier to a human-readable device name.
+ * This does not alter parsed `product` or `product_name` fields.
+ */
+function getFitGarminProductDisplayName(value) {
+    const name = getFitGarminProductName(value);
+    if (!name) {
+        return null;
+    }
+    // Preserve the established display spelling for the optical heart-rate product.
+    const displaySource = name === 'o_hr' ? 'o_h_r' : name;
+    const formatted = displaySource
+        .replace(/^fr(\d+)/i, 'Forerunner $1')
+        .replace(/^fenix(\d+)/i, 'Fenix $1')
+        .replace(/^edge(\d+)/i, 'Edge $1')
+        .replace(/^vivoactive/i, 'VivoActive')
+        .replace(/^vivosmart/i, 'VivoSmart')
+        .replace(/^vivofit/i, 'VivoFit')
+        .replace(/^vivomove/i, 'VivoMove')
+        .replace(/^vivosport/i, 'VivoSport')
+        .replace(/^approach([A-Z\d])/i, 'Approach $1')
+        .replace(/^marq([A-Z])/i, 'Marq $1')
+        .replace(/^hrm/i, 'HRM ')
+        .replace(/_/g, ' ')
+        .replace(/([a-z])([A-Z0-9])/g, '$1 $2')
+        .replace(/(\d)([a-z])/gi, '$1 $2');
+    return formatted
+        .split(' ')
+        .map((word) => {
+        const lower = word.toLowerCase();
+        if (lower === 'apac')
+            return 'APAC';
+        if (lower === 'xt')
+            return 'XT';
+        if (lower === 'lte')
+            return 'LTE';
+        if (lower === 'hr')
+            return 'HR';
+        if (lower === 'gps')
+            return 'GPS';
+        if (lower === 'mtb')
+            return 'MTB';
+        if (lower === 'ii')
+            return 'II';
+        if (lower === 'iii')
+            return 'III';
+        if (lower === 'm' && name.toLowerCase().includes('645m'))
+            return 'Music';
+        if (lower === 'jpn')
+            return 'Japan';
+        if (lower === 'chn')
+            return 'China';
+        if (lower === 'twn')
+            return 'Taiwan';
+        if (lower === 'kor')
+            return 'Korea';
+        if (lower === 'rus')
+            return 'Russia';
+        if (lower === 'sea')
+            return 'SEA';
+        return word.charAt(0).toUpperCase() + word.slice(1).toLowerCase();
+    })
+        .join(' ')
+        .replace(/Vivo Active/g, 'VivoActive')
+        .trim();
+}

package/dist/cjs/profile.d.ts

@@ -0,0 +1,9 @@
+import type { Message } from './fit.js';
+/**
+ * Static, community-maintained FIT interoperability profile.
+ *
+ * This table is ordinary project source maintained under the repository's MIT
+ * license. See PROFILE.md for the maintenance and verification policy.
+ */
+export declare const PROFILE_MESSAGES: Record<number, Message>;
+export declare const PROFILE_TYPES: Record<string, Record<number, string | number>>;