fit-file-parser 5.2.1 → 6.1.1

package/dist/{garmin_profile.generated.js → cjs/profile.js}

@@ -1,10 +1,13 @@
-export const GARMIN_PROFILE_VERSION = {
-    major: 21,
-    minor: 208,
-    patch: 0,
-    type: 'Release',
-};
-export const GARMIN_MESSAGES = {
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROFILE_TYPES = exports.PROFILE_MESSAGES = void 0;
+/**
+ * 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.
+ */
+exports.PROFILE_MESSAGES = {
     0: {
         0: {
             field: 'type',
@@ -2586,6 +2589,13 @@ export const GARMIN_MESSAGES = {
             offset: 0,
             units: 'Breaths/min',
         },
+        178: {
+            field: 'est_sweat_loss',
+            type: 'uint16',
+            scale: 1,
+            offset: 0,
+            units: 'ml',
+        },
         180: {
             field: 'enhanced_min_respiration_rate',
             type: 'uint16',
@@ -2640,6 +2650,13 @@ export const GARMIN_MESSAGES = {
             offset: 0,
             units: 'Flow',
         },
+        188: {
+            field: 'primary_benefit',
+            type: 'uint8',
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
         192: {
             field: 'workout_feel',
             type: 'uint8',
@@ -2721,6 +2738,27 @@ export const GARMIN_MESSAGES = {
             offset: 0,
             units: 'm',
         },
+        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',
+        },
         208: {
             field: 'avg_core_temperature',
             type: 'uint16',
@@ -4419,6 +4457,13 @@ export const GARMIN_MESSAGES = {
             offset: 0,
             units: 'm',
         },
+        90: {
+            field: 'garmin_performance_condition',
+            type: 'sint8',
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
         91: {
             field: 'absolute_pressure',
             type: 'uint32',
@@ -4626,6 +4671,20 @@ export const GARMIN_MESSAGES = {
             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',
+        },
         139: {
             field: 'core_temperature',
             type: 'uint16',
@@ -4956,6 +5015,13 @@ export const GARMIN_MESSAGES = {
             offset: 0,
             units: '',
         },
+        24: {
+            field: 'ant_id',
+            type: 'uint32z',
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
         25: {
             field: 'source_type',
             type: 'source_type',
@@ -6398,6 +6464,107 @@ export const GARMIN_MESSAGES = {
         },
         name: 'hrv',
     },
+    79: {
+        0: {
+            field: 'vo2_max',
+            type: 'uint16',
+            scale: 292.57142857142856,
+            offset: 0,
+            units: 'ml/kg/min',
+        },
+        1: {
+            field: 'age',
+            type: 'uint8',
+            scale: 1,
+            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: 1,
+            offset: 0,
+            units: '',
+        },
+        6: {
+            field: 'max_heart_rate',
+            type: 'uint8',
+            scale: 1,
+            offset: 0,
+            units: 'bpm',
+        },
+        8: {
+            field: 'remaining_recovery_time',
+            type: 'uint16',
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        11: {
+            field: 'lthr',
+            type: 'uint16',
+            scale: 1,
+            offset: 0,
+            units: 'bpm',
+        },
+        12: {
+            field: 'ltpower',
+            type: 'uint16',
+            scale: 1,
+            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: 1,
+            offset: 0,
+            units: '',
+        },
+        19: {
+            field: 'first_vo2_max',
+            type: 'uint32',
+            scale: 18724.571428571428,
+            offset: 0,
+            units: 'ml/kg/min',
+        },
+        35: {
+            field: 'end_of_previous_activity',
+            type: 'date_time',
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        253: {
+            field: 'timestamp',
+            type: 'date_time',
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        name: 'user_metrics',
+    },
     80: {
         0: {
             field: 'fractional_timestamp',
@@ -7253,6 +7420,93 @@ export const GARMIN_MESSAGES = {
         },
         name: 'hr',
     },
+    140: {
+        1: {
+            field: 'new_max_heart_rate',
+            type: 'uint8',
+            scale: 1,
+            offset: 0,
+            units: 'bpm',
+        },
+        4: {
+            field: 'aerobic_training_effect',
+            type: 'uint8',
+            scale: 10,
+            offset: 0,
+            units: '',
+        },
+        7: {
+            field: 'vo2_max',
+            type: 'uint32',
+            scale: 18724.571428571428,
+            offset: 0,
+            units: 'ml/kg/min',
+        },
+        9: {
+            field: 'recovery_time',
+            type: 'uint16',
+            scale: 1,
+            offset: 0,
+            units: 'min',
+        },
+        11: {
+            field: 'sport',
+            type: 'sport',
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        20: {
+            field: 'anaerobic_training_effect',
+            type: 'uint8',
+            scale: 10,
+            offset: 0,
+            units: '',
+        },
+        29: {
+            field: 'first_vo2_max',
+            type: 'uint32',
+            scale: 18724.571428571428,
+            offset: 0,
+            units: 'ml/kg/min',
+        },
+        41: {
+            field: 'primary_benefit',
+            type: 'uint8',
+            scale: 1,
+            offset: 0,
+            units: '',
+        },
+        60: {
+            field: 'total_ascent',
+            type: 'uint16',
+            scale: 1,
+            offset: 0,
+            units: 'm',
+        },
+        61: {
+            field: 'total_descent',
+            type: 'uint16',
+            scale: 1,
+            offset: 0,
+            units: 'm',
+        },
+        62: {
+            field: 'avg_power',
+            type: 'uint16',
+            scale: 1,
+            offset: 0,
+            units: 'watts',
+        },
+        63: {
+            field: 'avg_heart_rate',
+            type: 'uint8',
+            scale: 1,
+            offset: 0,
+            units: 'bpm',
+        },
+        name: 'activity_metrics',
+    },
     142: {
         0: {
             field: 'event',
@@ -11787,6 +12041,27 @@ export const GARMIN_MESSAGES = {
             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',
@@ -13032,7 +13307,7 @@ export const GARMIN_MESSAGES = {
         name: 'sleep_disruption_overnight_severity',
     },
 };
-export const GARMIN_TYPES = {
+exports.PROFILE_TYPES = {
     activity: {
         0: 'manual',
         1: 'auto_multi_sport',
@@ -15762,6 +16037,7 @@ export const GARMIN_TYPES = {
         55: 'monitoring',
         72: 'training_file',
         78: 'hrv',
+        79: 'user_metrics',
         80: 'ant_rx',
         81: 'ant_tx',
         82: 'ant_channel_id',
@@ -15774,6 +16050,7 @@ export const GARMIN_TYPES = {
         129: 'weather_alert',
         131: 'cadence_zone',
         132: 'hr',
+        140: 'activity_metrics',
         142: 'segment_lap',
         145: 'memo_glob',
         148: 'segment_id',
@@ -17202,6 +17479,8 @@ export const GARMIN_TYPES = {
         125: 'rally',
         126: 'pool_triathlon',
         127: 'e_bike_enduro',
+        153: 'mountain_enduro',
+        154: 'mountain_downhill',
         254: 'all',
     },
     supported_exd_screen_layouts: {

package/dist/cjs/raw-message-reader.d.ts

@@ -0,0 +1,60 @@
+export type FitMessageReaderErrorCode = 'invalid_input' | 'input_limit' | 'invalid_header' | 'invalid_crc' | 'invalid_structure';
+export type FitMessageReaderIssueCode = 'invalid_timestamp';
+export interface FitRawField {
+    fieldNumber: number;
+    size: number;
+    baseType: number;
+    bytes: Uint8Array;
+}
+export interface FitRawDeveloperField {
+    fieldNumber: number;
+    size: number;
+    developerDataIndex: number;
+    bytes: Uint8Array;
+}
+export interface FitRawMessage {
+    globalMessageNumber: number;
+    messageIndex: number;
+    littleEndian: boolean;
+    /** Native FIT timestamp in seconds since the FIT epoch, when available. */
+    timestamp?: number;
+    /** Reconstructed native timestamp when the record used a compressed header. */
+    compressedTimestamp?: number;
+    fields: FitRawField[];
+    developerFields: FitRawDeveloperField[];
+}
+export interface FitMessageReaderIssue {
+    code: FitMessageReaderIssueCode;
+    globalMessageNumber: number;
+    messageIndex: number;
+}
+export interface FitMessageReaderResult {
+    protocolVersion: number;
+    profileVersion: number;
+    messages: FitRawMessage[];
+    issues: FitMessageReaderIssue[];
+}
+export interface FitMessageReaderOptions {
+    /** Retain only these global message numbers. Omit to retain every message. */
+    messageNumbers?: readonly number[];
+    /** Reject larger inputs before allocating retained message data. */
+    maxInputBytes?: number;
+}
+/** Error thrown when the strict raw-message reader rejects a FIT input. */
+export declare class FitMessageReaderError extends Error {
+    readonly code: FitMessageReaderErrorCode;
+    constructor(code: FitMessageReaderErrorCode);
+}
+/** Returns the five-bit FIT base-type identifier, or null for reserved/unknown values. */
+export declare function getFitBaseTypeId(baseType: number): number | null;
+/** Reads an unsigned one-, two-, or four-byte raw FIT field. */
+export declare function readFitUnsignedField(field: FitRawField | undefined, expectedBaseType: number, size: 1 | 2 | 4, littleEndian: boolean): number | undefined;
+/** Reads UTF-8 bytes, removes trailing NUL padding, and preserves interior NUL separators. */
+export declare function readFitStringField(field: FitRawField | undefined): string | undefined;
+/**
+ * Strictly validates a FIT file and retains raw fields for selected messages.
+ * This entry point does not load the semantic FIT profile or format field values.
+ */
+export declare function readFitMessages(input: ArrayBuffer | Uint8Array, options?: FitMessageReaderOptions): FitMessageReaderResult;
+/** Converts a native FIT timestamp to a JavaScript epoch millisecond value. */
+export declare function fitTimestampToUnixMilliseconds(timestamp: number): number;