fit-file-parser 4.1.0 → 5.0.2

package/CHANGELOG.md

@@ -2,6 +2,65 @@
 
 ## Unreleased
 
+## 5.0.2
+
+### Fixed
+
+- Clarify the 5.0 migration for standard session field 196: use canonical
+  `metabolic_calories` rather than the old duplicate `resting_calories` label.
+- Clarify that the removed guessed `recovery_advisor` label was standard
+  session field 140, which the SDK defines as `avg_depth` in meters.
+
+## 5.0.1
+
+### Fixed
+
+- Run CI and version-driven npm publishing from the repository's `main`
+  branch, with a guarded manual recovery path for a missed release.
+
+## 5.0.0
+
+### Changed
+
+- Generate the complete standard message, field, and type surface from the
+  pinned Garmin FIT SDK without handwritten standard-profile overrides.
+- Preserve SDK alphanumeric tokens when generating public `snake_case` names,
+  including `n2`, `po2`, `time128`, and Garmin product identifiers.
+- Restrict non-SDK support to a collision-checked allowlist of Garmin fields
+  and private messages observed in the external FIT corpus.
+- Emit only parsed FIT values: Garmin product names are no longer inferred,
+  and record elapsed/timer values are generated only when
+  `elapsedRecordField: true` is requested.
+
+### Breaking
+
+- Remove compatibility aliases such as `resting_calories`,
+  `recovery_advisor`, `repeat_dive_time`, and deprecated time-in-zone names.
+- Remove guessed stress fields, handwritten enum/type additions, placeholder
+  zero-mask names, and the misspelled `hip_swing_excercise_name` type.
+- Use the pinned SDK's `cadence_zone_high_bondary` spelling and generated
+  alphanumeric field/type spellings instead of manual corrections.
+- Correct generated declarations to expose runtime `Date` values, numeric FIT
+  `bool` fields and unknown enum IDs, decoded mask objects, nullable array
+  entries, and optional profile fields.
+- Keep undated cascade rows in file order and avoid duplicating them when a lap
+  or session boundary timestamp is absent.
+
+## 4.1.1
+
+### Fixed
+
+- Apply Garmin FIT profile scale and offset to primitive numeric fields, while
+  retaining semicircle conversion only for fields declared in semicircles.
+- Apply FIT developer-field offsets with the parser's equivalent signed form,
+  including scaled signed developer values.
+- Decode native diving ascent-rate fields as meters per second instead of
+  geographic coordinates.
+- Decode native dive depth and bottom-time fields with their Garmin FIT SDK
+  scale instead of exposing their encoded integer representation.
+- Keep the pinned Garmin SDK authoritative for standard field types, arrays,
+  scales, offsets, and units while retaining compatible public field names.
+
 ## 4.1.0
 
 ### Added

package/README.md

@@ -29,6 +29,57 @@ including developer-defined data.
 npm install fit-file-parser
 ```
 
+## Migrating from 4.x to 5.0
+
+Version 5.0 is a breaking release because parsed output now follows the pinned
+Garmin FIT SDK profile without compatibility aliases or guessed fields. Parser
+construction, module imports, output modes, and parser options are unchanged.
+
+Update field access, destructuring, persisted schemas, and snapshots to use the
+SDK-backed names. Common migrations include:
+
+| 4.x name                       | 5.0 name                     |
+| ------------------------------ | ---------------------------- |
+| `speed_1s`                     | `speed1s`                    |
+| `start_n_2`, `end_n_2`         | `start_n2`, `end_n2`         |
+| `o_2_toxicity`                 | `o2_toxicity`                |
+| `avg_spo_2`, `reading_spo_2`   | `avg_spo2`, `reading_spo2`   |
+| `po_2`                         | `po2`                        |
+| `cycle_length_16`              | `cycle_length16`             |
+| `map_3_sample_mean`            | `map3_sample_mean`           |
+| `time_256`                     | `time256`                    |
+| `last_night_5_min_high`        | `last_night5_min_high`       |
+| `average_7_day_deviation`      | `average7_day_deviation`     |
+| `spo_2_data`, `hsa_spo_2_data` | `spo2_data`, `hsa_spo2_data` |
+| `repeat_dive_time`             | `repeat_dive_interval`       |
+| `cadence_zone_high_boundary`   | `cadence_zone_high_bondary`  |
+| `HipSwingExcerciseName`        | `HipSwingExerciseName`       |
+| `resting_calories`             | `metabolic_calories`         |
+
+The same alphanumeric-token rule applies to enum strings, for example
+`camera_orientation_90` becomes `camera_orientation90`, `po_2_warn` becomes
+`po2_warn`, and `power_3s` becomes `power3s`. The generated TypeScript
+declarations are the exhaustive name and value reference for the pinned SDK.
+
+Parser 4 exposed standard session field 196 (`metabolic_calories`) a second
+time as `resting_calories`; use the canonical `metabolic_calories` name in 5.0.
+`recovery_advisor` was a guessed label for standard session field 140, whose
+canonical SDK field is `avg_depth` in meters. Other behavior to account for
+during migration:
+
+- `product_name` is emitted only when it exists in the FIT input. It is no
+  longer inferred from `manufacturer` and `product`.
+- Record `elapsed_time` and `timer_time` require
+  `elapsedRecordField: true`.
+- FIT timestamps are typed as `Date`, FIT `bool` values remain numeric, mask
+  fields are `{ value, ...flags }` objects, unknown enum values remain numbers,
+  and array entries may be `null` when the FIT invalid sentinel is retained.
+- Every profile field is optional because individual FIT message definitions
+  determine which fields are present.
+- When upgrading from 4.1.0 or earlier, remove application-side scale or offset
+  corrections for parsed numeric values, including dive depth, bottom time,
+  ascent rate, and developer fields. The parser now applies the SDK metadata.
+
 ## Quick start
 
 The Promise API is the simplest way to parse a file:
@@ -125,6 +176,28 @@ const diveSummaries = data.messages?.dive_summary ?? []
 Existing root lists, cascade nesting, and last-message root properties remain
 unchanged.
 
+## Profile-backed output
+
+Standard message names, field names, enum values, wire types, scales, offsets,
+arrays, and units come from the exactly pinned Garmin FIT SDK profile. Public
+names use the parser's generated `snake_case` form while preserving SDK
+alphanumeric tokens such as `n2`, `po2`, and `time128`. The parser does not add
+compatibility aliases for alternate field spellings.
+
+The small vendor extension table contains only Garmin fields and private
+messages observed in the external FIT corpus. Extensions cannot replace a
+standard SDK field or type value; the profile audit rejects collisions and
+unregistered additions.
+
+Only values present in the FIT input are emitted. In particular,
+`product_name` is not inferred from `manufacturer` and `product`, and record
+`elapsed_time` and `timer_time` are added only when `elapsedRecordField: true`
+is requested. Parsed FIT timestamps are `Date` objects, FIT `bool` fields keep
+their numeric wire values, mask fields decode to `{ value, ...flags }` objects,
+unknown enum IDs remain numbers, and invalid entries retained inside FIT arrays
+are `null`. All profile fields are optional because each FIT message definition
+chooses which fields are present.
+
 ## Inputs
 
 Both parser methods accept:
@@ -228,8 +301,24 @@ Run commands from the repository root.
 | `npm run examples`                 | Build and regenerate checked-in example outputs.   |
 | `npm run check`                    | Run profile audit, lint, types, tests, and builds. |
 
+### External FIT corpus (optional)
+
+The external corpus is not part of this repository or the npm package. For the
+standard contributor layout, clone it alongside this checkout, then run the
+aggregate-only validation command:
+
+```sh
+git clone https://github.com/ThomasKuehne/FIT-test-files.git ../FIT-test-files
+npm run corpus:check -- ../FIT-test-files --allow-force-recovery
+```
+
+The command accepts any corpus path; the sibling location is only a convenient
+convention. The corpus contains a known header-CRC failure that is expected to
+recover only in force mode. It reports aggregate counts and never prints file
+names or parsed activity data.
+
 Do not edit `src/garmin_profile.generated.ts` or `src/fit_types.ts` manually.
-Update the pinned SDK, compatibility overrides, or a generator, then run
+Update the pinned SDK, audited vendor extensions, or a generator, then run
 `npm run codegen`.
 
 Repository-specific automation guidance is tracked in

package/dist/binary.d.ts

@@ -1,6 +1,5 @@
 import type { FitParserOptions } from './fit-parser.js';
-import type { FieldDefinition } from './fit.js';
-import type { MesgNum } from './fit_types.js';
+import type { FieldDefinition, MessageName } from './fit.js';
 import { Buffer } from 'buffer';
 export interface MessageTypeDefinition {
     littleEndian: boolean;
@@ -23,7 +22,7 @@ export interface DecoderState {
 }
 export declare function addEndian(littleEndian: boolean, bytes: number[]): number;
 export declare function readRecord(blob: Uint8Array, messageTypes: MessageTypeDefinition[], developerFields: any[], startIndex: number, options: FitParserOptions, startDate: number | undefined, pausedTime: number, dataView?: DataView, decoderState?: DecoderState): {
-    messageType: MesgNum | '';
+    messageType: MessageName | 'definition' | '';
     nextIndex: number;
     message?: any;
 };

package/dist/binary.js

@@ -118,17 +118,25 @@ function readData(blob, dataView, fDef, startIndex) {
     }
     return isArray ? values : values[0];
 }
-function formatByType(data, type, scale, offset) {
+function formatByType(data, type, scale, offset, units) {
     switch (type) {
         case 'date_time':
         case 'local_date_time':
             return new Date(data * 1000 + GarminTimeOffset);
         case 'sint32':
-            return data * FIT.scConst;
+            return units === 'semicircles'
+                ? data * FIT.scConst
+                : scale ? data / scale + offset : data;
+        case 'sint8':
         case 'uint8':
+        case 'uint8z':
         case 'sint16':
-        case 'uint32':
         case 'uint16':
+        case 'uint16z':
+        case 'uint32':
+        case 'uint32z':
+        case 'float32':
+        case 'float64':
             return scale ? data / scale + offset : data;
         case 'uint32_array':
         case 'uint16_array':
@@ -185,7 +193,7 @@ function formatByType(data, type, scale, offset) {
                         dataItem.value = data & Number(key);
                     }
                     else {
-                        dataItem[value] = !!((data & Number(key)) >> 7); // Not sure if we need the >> 7 and casting to boolean but from all the masked props of fields so far this seems to be the case
+                        dataItem[value] = (data & Number(key)) !== 0;
                     }
                 }
                 return dataItem;
@@ -254,10 +262,10 @@ function formatFieldValue(data, fDef, options, fields) {
             if (isInvalidValue(item, rawType)) {
                 return null;
             }
-            return applyOptions(formatByType(item, fDef.type, scale, offset), field, options, fields);
+            return applyOptions(formatByType(item, fDef.type, scale, offset, fDef.units), field, options, fields);
         });
     }
-    return applyOptions(formatByType(data, fDef.type, scale, offset), field, options, fields);
+    return applyOptions(formatByType(data, fDef.type, scale, offset, fDef.units), field, options, fields);
 }
 function isOutputFieldName(field) {
     return field !== 'unknown' && field !== '' && field !== undefined;
@@ -289,7 +297,7 @@ function applyOptions(data, field, options, fields) {
         case 'vertical_speed':
         case 'avg_speed':
         case 'max_speed':
-        case 'speed_1s':
+        case 'speed1s':
         case 'ball_speed':
         case 'enhanced_avg_speed':
         case 'enhanced_max_speed':
@@ -340,22 +348,8 @@ function applyOptions(data, field, options, fields) {
             return data;
     }
 }
-function applyGarminProductName(fields) {
-    if (fields.product_name !== undefined || fields.manufacturer !== 'garmin') {
-        return;
-    }
-    const product = fields.product;
-    if (typeof product !== 'number') {
-        return;
-    }
-    const productName = FIT.types.garmin_product[product];
-    if (typeof productName === 'string') {
-        // Keep the raw protocol ID and expose the SDK product name separately.
-        fields.product_name = productName;
-    }
-}
 function resolveDeveloperFieldDefinition(developerFieldDef, littleEndian, developerFields, options) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g;
     const description = (_a = developerFields[developerFieldDef.developerDataIndex]) === null || _a === void 0 ? void 0 : _a[developerFieldDef.fieldDefinitionNumber];
     if (!description) {
         developerFieldDef.resolvedFieldDef = undefined;
@@ -392,7 +386,11 @@ function resolveDeveloperFieldDefinition(developerFieldDef, littleEndian, develo
         name: (_d = description.field_name) !== null && _d !== void 0 ? _d : '',
         dataType: getFitMessageBaseType(baseType & 15),
         scale: (_e = description.scale) !== null && _e !== void 0 ? _e : 1,
-        offset: (_f = description.offset) !== null && _f !== void 0 ? _f : 0,
+        // FIT developer-field descriptions use `raw / scale - offset`. This
+        // parser's formatter retains the legacy equivalent signed offset and adds
+        // it after scaling.
+        offset: -((_f = description.offset) !== null && _f !== void 0 ? _f : 0),
+        units: (_g = description.units) !== null && _g !== void 0 ? _g : '',
         requiresBoundedDataView: requiresBoundedEndianDataView(type, developerFieldDef.size),
         developerDataIndex: developerFieldDef.developerDataIndex,
         isDeveloperField: true,
@@ -435,7 +433,7 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
             const fDefIndex = startIndex + 6 + i * 3;
             const baseType = blob[fDefIndex + 2];
             const wireType = FIT.types.fit_base_type[baseType];
-            const { field, type, baseType: profileBaseType, array, scale, offset, aliases, } = message.getAttributes(blob[fDefIndex]);
+            const { field, type, baseType: profileBaseType, array, scale, offset, units, } = message.getAttributes(blob[fDefIndex]);
             const profileCompatible = areProfileBaseTypesCompatible(profileBaseType, wireType);
             const fDef = {
                 type: profileCompatible ? type : wireType,
@@ -452,8 +450,8 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
                 dataType: getFitMessageBaseType(baseType & 15),
                 scale: profileCompatible ? scale : null,
                 offset: profileCompatible ? offset : 0,
+                units: profileCompatible ? units : '',
                 requiresBoundedDataView: requiresBoundedEndianDataView(wireType, blob[fDefIndex + 1]),
-                aliases: profileCompatible ? aliases : undefined,
             };
             mTypeDef.fieldDefs.push(fDef);
         }
@@ -532,13 +530,6 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
         if (isOutputFieldName(fDef.name)) {
             fields[fDef.name] = data;
         }
-        if (fDef.aliases) {
-            for (const alias of fDef.aliases) {
-                if (isOutputFieldName(alias.field)) {
-                    fields[alias.field] = data;
-                }
-            }
-        }
     }
     for (let i = 0; i < developerFieldDefs.length; i++) {
         const data = rawData[messageType.fieldDefs.length + i];
@@ -560,13 +551,6 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
         if (isOutputFieldName(fDef.name)) {
             fields[fDef.name] = formatFieldValue(data, fDef, options, fields);
         }
-        if (fDef.aliases) {
-            for (const alias of fDef.aliases) {
-                if (isOutputFieldName(alias.field)) {
-                    fields[alias.field] = formatFieldValue(data, Object.assign(Object.assign(Object.assign({}, fDef), alias), { name: alias.field, aliases: undefined }), options, fields);
-                }
-            }
-        }
     }
     for (let i = 0; i < developerFieldDefs.length; i++) {
         const data = rawData[messageType.fieldDefs.length + i];
@@ -596,7 +580,6 @@ export function readRecord(blob, messageTypes, developerFields, startIndex, opti
             validFieldCount++;
         }
     }
-    applyGarminProductName(fields);
     if (validFieldCount > 0 && message.name === 'record' && options.elapsedRecordField) {
         fields.elapsed_time = (fields.timestamp - (startDate || 0)) / 1000;
         fields.timer_time = fields.elapsed_time - pausedTime;

package/dist/cjs/binary.d.ts

@@ -1,6 +1,5 @@
 import type { FitParserOptions } from './fit-parser.js';
-import type { FieldDefinition } from './fit.js';
-import type { MesgNum } from './fit_types.js';
+import type { FieldDefinition, MessageName } from './fit.js';
 import { Buffer } from 'buffer';
 export interface MessageTypeDefinition {
     littleEndian: boolean;
@@ -23,7 +22,7 @@ export interface DecoderState {
 }
 export declare function addEndian(littleEndian: boolean, bytes: number[]): number;
 export declare function readRecord(blob: Uint8Array, messageTypes: MessageTypeDefinition[], developerFields: any[], startIndex: number, options: FitParserOptions, startDate: number | undefined, pausedTime: number, dataView?: DataView, decoderState?: DecoderState): {
-    messageType: MesgNum | '';
+    messageType: MessageName | 'definition' | '';
     nextIndex: number;
     message?: any;
 };

package/dist/cjs/binary.js

@@ -124,17 +124,25 @@ function readData(blob, dataView, fDef, startIndex) {
     }
     return isArray ? values : values[0];
 }
-function formatByType(data, type, scale, offset) {
+function formatByType(data, type, scale, offset, units) {
     switch (type) {
         case 'date_time':
         case 'local_date_time':
             return new Date(data * 1000 + GarminTimeOffset);
         case 'sint32':
-            return data * fit_js_1.FIT.scConst;
+            return units === 'semicircles'
+                ? data * fit_js_1.FIT.scConst
+                : scale ? data / scale + offset : data;
+        case 'sint8':
         case 'uint8':
+        case 'uint8z':
         case 'sint16':
-        case 'uint32':
         case 'uint16':
+        case 'uint16z':
+        case 'uint32':
+        case 'uint32z':
+        case 'float32':
+        case 'float64':
             return scale ? data / scale + offset : data;
         case 'uint32_array':
         case 'uint16_array':
@@ -191,7 +199,7 @@ function formatByType(data, type, scale, offset) {
                         dataItem.value = data & Number(key);
                     }
                     else {
-                        dataItem[value] = !!((data & Number(key)) >> 7); // Not sure if we need the >> 7 and casting to boolean but from all the masked props of fields so far this seems to be the case
+                        dataItem[value] = (data & Number(key)) !== 0;
                     }
                 }
                 return dataItem;
@@ -260,10 +268,10 @@ function formatFieldValue(data, fDef, options, fields) {
             if (isInvalidValue(item, rawType)) {
                 return null;
             }
-            return applyOptions(formatByType(item, fDef.type, scale, offset), field, options, fields);
+            return applyOptions(formatByType(item, fDef.type, scale, offset, fDef.units), field, options, fields);
         });
     }
-    return applyOptions(formatByType(data, fDef.type, scale, offset), field, options, fields);
+    return applyOptions(formatByType(data, fDef.type, scale, offset, fDef.units), field, options, fields);
 }
 function isOutputFieldName(field) {
     return field !== 'unknown' && field !== '' && field !== undefined;
@@ -295,7 +303,7 @@ function applyOptions(data, field, options, fields) {
         case 'vertical_speed':
         case 'avg_speed':
         case 'max_speed':
-        case 'speed_1s':
+        case 'speed1s':
         case 'ball_speed':
         case 'enhanced_avg_speed':
         case 'enhanced_max_speed':
@@ -346,22 +354,8 @@ function applyOptions(data, field, options, fields) {
             return data;
     }
 }
-function applyGarminProductName(fields) {
-    if (fields.product_name !== undefined || fields.manufacturer !== 'garmin') {
-        return;
-    }
-    const product = fields.product;
-    if (typeof product !== 'number') {
-        return;
-    }
-    const productName = fit_js_1.FIT.types.garmin_product[product];
-    if (typeof productName === 'string') {
-        // Keep the raw protocol ID and expose the SDK product name separately.
-        fields.product_name = productName;
-    }
-}
 function resolveDeveloperFieldDefinition(developerFieldDef, littleEndian, developerFields, options) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e, _f, _g;
     const description = (_a = developerFields[developerFieldDef.developerDataIndex]) === null || _a === void 0 ? void 0 : _a[developerFieldDef.fieldDefinitionNumber];
     if (!description) {
         developerFieldDef.resolvedFieldDef = undefined;
@@ -398,7 +392,11 @@ function resolveDeveloperFieldDefinition(developerFieldDef, littleEndian, develo
         name: (_d = description.field_name) !== null && _d !== void 0 ? _d : '',
         dataType: (0, messages_js_1.getFitMessageBaseType)(baseType & 15),
         scale: (_e = description.scale) !== null && _e !== void 0 ? _e : 1,
-        offset: (_f = description.offset) !== null && _f !== void 0 ? _f : 0,
+        // FIT developer-field descriptions use `raw / scale - offset`. This
+        // parser's formatter retains the legacy equivalent signed offset and adds
+        // it after scaling.
+        offset: -((_f = description.offset) !== null && _f !== void 0 ? _f : 0),
+        units: (_g = description.units) !== null && _g !== void 0 ? _g : '',
         requiresBoundedDataView: requiresBoundedEndianDataView(type, developerFieldDef.size),
         developerDataIndex: developerFieldDef.developerDataIndex,
         isDeveloperField: true,
@@ -441,7 +439,7 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
             const fDefIndex = startIndex + 6 + i * 3;
             const baseType = blob[fDefIndex + 2];
             const wireType = fit_js_1.FIT.types.fit_base_type[baseType];
-            const { field, type, baseType: profileBaseType, array, scale, offset, aliases, } = message.getAttributes(blob[fDefIndex]);
+            const { field, type, baseType: profileBaseType, array, scale, offset, units, } = message.getAttributes(blob[fDefIndex]);
             const profileCompatible = areProfileBaseTypesCompatible(profileBaseType, wireType);
             const fDef = {
                 type: profileCompatible ? type : wireType,
@@ -458,8 +456,8 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
                 dataType: (0, messages_js_1.getFitMessageBaseType)(baseType & 15),
                 scale: profileCompatible ? scale : null,
                 offset: profileCompatible ? offset : 0,
+                units: profileCompatible ? units : '',
                 requiresBoundedDataView: requiresBoundedEndianDataView(wireType, blob[fDefIndex + 1]),
-                aliases: profileCompatible ? aliases : undefined,
             };
             mTypeDef.fieldDefs.push(fDef);
         }
@@ -538,13 +536,6 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
         if (isOutputFieldName(fDef.name)) {
             fields[fDef.name] = data;
         }
-        if (fDef.aliases) {
-            for (const alias of fDef.aliases) {
-                if (isOutputFieldName(alias.field)) {
-                    fields[alias.field] = data;
-                }
-            }
-        }
     }
     for (let i = 0; i < developerFieldDefs.length; i++) {
         const data = rawData[messageType.fieldDefs.length + i];
@@ -566,13 +557,6 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
         if (isOutputFieldName(fDef.name)) {
             fields[fDef.name] = formatFieldValue(data, fDef, options, fields);
         }
-        if (fDef.aliases) {
-            for (const alias of fDef.aliases) {
-                if (isOutputFieldName(alias.field)) {
-                    fields[alias.field] = formatFieldValue(data, Object.assign(Object.assign(Object.assign({}, fDef), alias), { name: alias.field, aliases: undefined }), options, fields);
-                }
-            }
-        }
     }
     for (let i = 0; i < developerFieldDefs.length; i++) {
         const data = rawData[messageType.fieldDefs.length + i];
@@ -602,7 +586,6 @@ function readRecord(blob, messageTypes, developerFields, startIndex, options, st
             validFieldCount++;
         }
     }
-    applyGarminProductName(fields);
     if (validFieldCount > 0 && message.name === 'record' && options.elapsedRecordField) {
         fields.elapsed_time = (fields.timestamp - (startDate || 0)) / 1000;
         fields.timer_time = fields.elapsed_time - pausedTime;

package/dist/cjs/fit-parser.js

@@ -168,8 +168,10 @@ class FitParser {
                 case 'record':
                     if (!startDate) {
                         startDate = message.timestamp;
-                        message.elapsed_time = 0;
-                        message.timer_time = 0;
+                        if (this.options.elapsedRecordField) {
+                            message.elapsed_time = 0;
+                            message.timer_time = 0;
+                        }
                     }
                     records.push(message);
                     break;

package/dist/cjs/fit.d.ts

@@ -1,4 +1,5 @@
 import type { FitOptions, MesgNum } from './fit_types.js';
+export type MessageName = Exclude<MesgNum, number | 'definition'>;
 export interface FieldDefinition {
     type: string | number;
     rawType?: string | number;
@@ -12,10 +13,10 @@ export interface FieldDefinition {
     dataType: string;
     scale?: number | null;
     offset?: number;
+    units?: string;
     requiresBoundedDataView?: boolean;
     developerDataIndex?: number;
     isDeveloperField?: boolean;
-    aliases?: MessageObject[];
 }
 export interface MessageObject {
     field: string;
@@ -25,20 +26,21 @@ export interface MessageObject {
     scale: number | null;
     offset: number;
     units: string;
-    aliases?: MessageObject[];
 }
 export interface Message {
-    name: MesgNum;
+    name: MessageName;
     [fieldId: number]: MessageObject;
 }
 export interface FitType {
     scConst: number;
     options: FitOptions;
-    messages: {
-        [messageId: number]: Message;
-    };
-    types: {
-        [typeName: string]: Record<number, string | number>;
-    };
+    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;