fit-file-parser 6.0.2 → 6.1.2

package/CHANGELOG.md

@@ -1,5 +1,44 @@
 # Change Log
 
+## 6.1.2 - 2026-09-22
+
+### Changed
+
+- Keep the manufacturer, Garmin product, sport, sub-sport, and course-point
+  lookup maps in one authoritative internal module shared by the full decoder
+  profile and the lightweight `fit-file-parser/profile` entry point.
+- Prevent lookup-only consumers from loading the full decoder profile and its
+  message definitions.
+- Enforce the lookup entry point's dependency graph and a 25 KB minified bundle
+  ceiling in the profile checks run by CI.
+
+### Compatibility
+
+- Profile mappings, parsed output, and the public TypeScript API are unchanged.
+
+## 6.1.1 - 2026-09-21
+
+### Added
+
+- Export lookup helpers for FIT manufacturer, Garmin product, sport, and
+  sub-sport identifiers from the package root.
+- Export the same helpers from the lightweight `fit-file-parser/profile`
+  entry point for lookup-only consumers.
+- Add reverse sport, sub-sport, and course-point identifier lookups.
+- Add lightweight `fit-file-parser/raw` and `fit-file-parser/encoder` entry
+  points for profile-independent message scanning and encoding.
+- Add a strict raw-message reader with CRC, definition, developer-field, and
+  compressed-timestamp validation.
+- Export an opt-in Garmin product display-name helper without changing parsed
+  `product` or `product_name` fields.
+- Decode mountain enduro and mountain downhill sub-sport identifiers.
+
+### Compatibility
+
+- Existing parsed output remains unchanged except that sub-sport IDs 153 and
+  154 now resolve to `mountain_enduro` and `mountain_downhill`.
+- Existing Garmin product display names ported from SportsLib are preserved.
+
 ## 6.0.2 - 2026-09-21
 
 ### Changed

package/PROFILE.md

@@ -1,11 +1,18 @@
 # FIT Profile Maintenance
 
-The parser uses one static interoperability table in `src/profile.ts` for
-normal installs, builds, tests, and releases. It contains message and field
-identifiers, names, wire types, array behavior, scales, offsets, units, enum
-labels, and product identifiers. `npm run profile:check` pins full-table
-fingerprints and the resulting message, field, type, enum-value, and product
-counts so accidental drift fails CI.
+The parser uses one static interoperability profile for normal installs,
+builds, tests, and releases. Message definitions and general enum tables live
+in `src/profile.ts`; the manufacturer, Garmin product, sport, sub-sport, and
+course-point tables live in `src/profile-lookup-data.ts`. The full profile
+composes those exact objects, so lookup-only consumers and the decoder share
+one authoritative value for every mapping. `npm run profile:check` pins
+full-table fingerprints and the resulting message, field, type, enum-value,
+and product counts so accidental drift fails CI.
+
+`npm run profile:budget` also bundles the lookup entry point in isolation. It
+fails if anything beyond the lookup helpers and their authoritative data enters
+that graph, or if the minified bundle exceeds 25,000 bytes. Review any budget
+change together with the corresponding profile growth.
 
 ## Unknown and newer fields
 
@@ -28,8 +35,9 @@ table cannot decode.
 
 Every mapping change requires focused regression coverage. Do not guess
 adjacent identifiers or add a mapping solely to make `unmapped_messages`
-disappear. Update `src/profile.ts`, the relevant tests, and the public types,
-then verify the complete compatibility contract:
+disappear. Update the owning table in `src/profile.ts` or
+`src/profile-lookup-data.ts`, the relevant tests, and the public types, then
+verify the complete compatibility contract:
 
 ```sh
 npm run codegen

package/README.md

@@ -240,8 +240,9 @@ unchanged.
 ## Profile-backed output
 
 Recognized message names, field names, enum values, wire types, scales,
-offsets, arrays, and units come from the community-maintained table in
-`src/profile.ts`. Its maintenance and verification contract is documented in
+offsets, arrays, and units come from the community-maintained profile in
+`src/profile.ts` and `src/profile-lookup-data.ts`. Its maintenance and
+verification contract is documented in
 [`PROFILE.md`](./PROFILE.md).
 
 Public names use `snake_case` while preserving established alphanumeric tokens
@@ -257,6 +258,57 @@ 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.
 
+Applications that need profile lookups independently of parsing can use the
+exported manufacturer, Garmin product, sport, sub-sport, and course-point helpers:
+
+```javascript
+import {
+  getFitCoursePointId,
+  getFitGarminProductDisplayName,
+  getFitManufacturerName,
+  getFitSportId,
+  getFitSportName,
+  getFitSubSportId,
+  getFitSubSportName,
+} from 'fit-file-parser'
+
+getFitManufacturerName(1) // "garmin"
+getFitGarminProductDisplayName(4655) // "Edge MTB"
+getFitSportName(2) // "cycling"
+getFitSubSportName(153) // "mountain_enduro"
+getFitSportId('cycling') // 2
+getFitSubSportId('indoor_cycling') // 6
+getFitCoursePointId('rest_area') // 29
+```
+
+These helpers read the same maintained profile used by the decoder. The product
+display helper is opt-in and does not synthesize or overwrite parsed
+`product_name` values.
+
+Lookup-only consumers can import the same helpers from
+`fit-file-parser/profile` without loading the parser entry point.
+
+### Lightweight raw messages
+
+Consumers that need strict FIT framing, CRC validation, compressed timestamps,
+and exact fields without loading the semantic profile can use the lightweight
+raw entry point:
+
+```javascript
+import { readFitMessages } from 'fit-file-parser/raw'
+
+const { messages } = readFitMessages(content, {
+  messageNumbers: [18, 26, 72],
+  maxInputBytes: 64 * 1024 * 1024,
+})
+```
+
+The result retains native and developer fields as defensive `Uint8Array`
+copies. It does not apply names, enum formatting, scales, units, or
+provider-specific interpretation. Invalid input throws `FitMessageReaderError`
+with a stable `code` such as `invalid_header`, `invalid_crc`, or
+`invalid_structure`.
+
 ## Inputs
 
 Both parser methods accept:
@@ -283,7 +335,7 @@ base types, sizes, and values in their raw FIT representation. Applying FIT
 scales and offsets is the caller's responsibility.
 
 ```javascript
-import { FitBaseType, FitEncoder } from 'fit-file-parser'
+import { FitBaseType, FitEncoder } from 'fit-file-parser/encoder'
 
 const encoder = new FitEncoder()
 encoder.writeMessage(0, [
@@ -319,6 +371,9 @@ Scalar 64-bit values use `bigint`. Strings, numeric arrays, and other
 variable-length values use exact-size `Uint8Array` values. Invalid field
 definitions or numeric ranges throw before a partial message is written.
 
+The encoder remains available from the package root; the `/encoder` entry
+point avoids loading the decoder and semantic profile.
+
 ## TypeScript and module formats
 
 The package includes TypeScript declarations and exports
@@ -389,9 +444,10 @@ a reference package, compares their complete default outputs, and reports only
 aggregate counts. Files rejected by both strict parsers are retried in force
 mode.
 
-Edit `src/profile.ts` only through reviewed profile changes with focused
-regression coverage and a documented source. Do not edit `src/fit_types.ts`
-manually; run `npm run codegen` after changing the maintained profile.
+Edit `src/profile.ts` and `src/profile-lookup-data.ts` only through reviewed
+profile changes with focused regression coverage and a documented source. Do
+not edit `src/fit_types.ts` manually; run `npm run codegen` after changing the
+maintained profile.
 
 Repository-specific automation guidance is tracked in
 [`.agent/README.md`](./.agent/README.md). More examples are available in the

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;

package/dist/cjs/fit-parser.js

@@ -1,11 +1,27 @@
 "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, _d;

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;

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

@@ -0,0 +1,12 @@
+export type FitProfileValueMap = Record<number, string | number>;
+/**
+ * Lookup-oriented slices of the maintained FIT profile.
+ *
+ * The full decoder composes these exact objects into PROFILE_TYPES, keeping
+ * this module authoritative without loading message definitions in lookup-only consumers.
+ */
+export declare const FIT_PROFILE_COURSE_POINTS: FitProfileValueMap;
+export declare const FIT_PROFILE_GARMIN_PRODUCTS: FitProfileValueMap;
+export declare const FIT_PROFILE_MANUFACTURERS: FitProfileValueMap;
+export declare const FIT_PROFILE_SPORTS: FitProfileValueMap;
+export declare const FIT_PROFILE_SUB_SPORTS: FitProfileValueMap;