@sports-alliance/sports-lib 6.1.0 → 6.1.3

package/lib/esm/events/adapters/importers/fit/importer.fit.garmin.profile.mapper.d.ts

@@ -0,0 +1,22 @@
+export declare class GarminProfileMapper {
+    /**
+     * Translates a Garmin Product ID to a readable device name
+     */
+    static getDeviceName(productId: number | string): string | null;
+    /**
+     * Translates a Manufacturer ID to a readable name
+     */
+    static getManufacturerName(manufacturerId: number | string): string | null;
+    /**
+     * Translates a Sport ID to a readable name
+     */
+    static getSportName(sportId: number | string): string | null;
+    /**
+     * Translates a Sub-Sport ID to a readable name
+     */
+    static getSubSportName(subSportId: number | string): string | null;
+    /**
+     * Formats internal Garmin names into pretty names (e.g. fr945 -> Forerunner 945)
+     */
+    private static formatDeviceName;
+}

package/lib/esm/events/adapters/importers/fit/importer.fit.garmin.profile.mapper.js

@@ -0,0 +1,106 @@
+import { GarminManufacturers, GarminProducts, GarminSports, GarminSubSports } from './importer.fit.garmin.profile.data';
+export class GarminProfileMapper {
+    /**
+     * Translates a Garmin Product ID to a readable device name
+     */
+    static getDeviceName(productId) {
+        if (productId === null || productId === undefined) {
+            return null;
+        }
+        const id = typeof productId === 'string' ? parseInt(productId, 10) : productId;
+        const name = GarminProducts[id];
+        return name ? this.formatDeviceName(name) : null;
+    }
+    /**
+     * Translates a Manufacturer ID to a readable name
+     */
+    static getManufacturerName(manufacturerId) {
+        if (manufacturerId === null || manufacturerId === undefined) {
+            return null;
+        }
+        const id = typeof manufacturerId === 'string' ? parseInt(manufacturerId, 10) : manufacturerId;
+        return GarminManufacturers[id] || null;
+    }
+    /**
+     * Translates a Sport ID to a readable name
+     */
+    static getSportName(sportId) {
+        if (sportId === null || sportId === undefined) {
+            return null;
+        }
+        const id = typeof sportId === 'string' ? parseInt(sportId, 10) : sportId;
+        return GarminSports[id] || null;
+    }
+    /**
+     * Translates a Sub-Sport ID to a readable name
+     */
+    static getSubSportName(subSportId) {
+        if (subSportId === null || subSportId === undefined) {
+            return null;
+        }
+        const id = typeof subSportId === 'string' ? parseInt(subSportId, 10) : subSportId;
+        return GarminSubSports[id] || null;
+    }
+    /**
+     * Formats internal Garmin names into pretty names (e.g. fr945 -> Forerunner 945)
+     */
+    static formatDeviceName(name) {
+        if (!name)
+            return 'Unknown';
+        // First expand known abbreviations and add spaces
+        let formatted = name
+            .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 underscores with spaces
+            .replace(/([a-z])([A-Z0-9])/g, '$1 $2') // Add spaces between camelCase
+            .replace(/([0-9])([a-zA-Z])/g, '$1 $2'); // Add spaces between numbers and letters
+        // Capitalize and clean up special terms
+        formatted = 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 === 'ii')
+                return 'II';
+            if (lower === 'iii')
+                return 'III';
+            if (lower === 'm' && name.toLowerCase().includes('645m'))
+                return 'Music'; // Special case for Fr645m
+            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();
+        return formatted;
+    }
+}

package/lib/esm/events/adapters/importers/fit/importer.fit.js

@@ -15,8 +15,8 @@ import { ActivityTypes, ActivityTypesMoving } from '../../../../activities/activ
 import { DataDuration } from '../../../../data/data.duration';
 import { DataEnergy } from '../../../../data/data.energy';
 import { DataDistance } from '../../../../data/data.distance';
-import { ImporterFitGarminDeviceNames } from './importer.fit.garmin.device.names';
 import { ImporterFitSuuntoDeviceNames } from './importer.fit.suunto.device.names';
+import { GarminProfileMapper } from './importer.fit.garmin.profile.mapper';
 import { DataPause } from '../../../../data/data.pause';
 import { DataCadenceAvg } from '../../../../data/data.cadence-avg';
 import { DataPowerAvg } from '../../../../data/data.power-avg';
@@ -538,13 +538,24 @@ export class EventImporterFIT {
         }
     }
     static getActivityTypeFromSessionObject(session) {
-        if (session.sub_sport && session.sub_sport !== 'generic') {
-            return (ActivityTypes[`${session.sport}_${session.sub_sport}`] ||
-                `${session.sport}_${session.sub_sport}` ||
-                session.sport ||
-                ActivityTypes.unknown);
-        }
-        return ActivityTypes[session.sport] || session.sport || ActivityTypes.unknown;
+        const activityTypeKey = session.sub_sport && session.sub_sport !== 'generic' ? `${session.sport}_${session.sub_sport}` : session.sport;
+        let activityType = ActivityTypes[activityTypeKey];
+        if (!activityType || activityType === ActivityTypes.unknown) {
+            // Fallback to Garmin SDK mappings
+            const sportName = GarminProfileMapper.getSportName(session.sport);
+            const subSportName = session.sub_sport && session.sub_sport !== 'generic'
+                ? GarminProfileMapper.getSubSportName(session.sub_sport)
+                : null;
+            if (sportName || subSportName) {
+                // Try to find in ActivityTypes using the name from Garmin SDK
+                const nameKey = subSportName ? `${sportName}_${subSportName}` : sportName;
+                activityType =
+                    ActivityTypes[nameKey] ||
+                        ActivityTypes[sportName] ||
+                        nameKey;
+            }
+        }
+        return activityType || session.sport || ActivityTypes.unknown;
     }
     // @todo move this to a mapper
     static getStatsFromObject(object, activity, isLap) {
@@ -841,7 +852,7 @@ export class EventImporterFIT {
                 break;
             }
             case 'garmin': {
-                recognizedName = ImporterFitGarminDeviceNames[productId];
+                recognizedName = GarminProfileMapper.getDeviceName(productId);
                 creator = new Creator(formatDeviceName(manufacturer, productName, recognizedName, 'Garmin'), productId);
                 break;
             }
@@ -902,7 +913,12 @@ export class EventImporterFIT {
                 break;
             }
             default: {
-                creator = new Creator(formatDeviceName(manufacturer, productName, null, null), productId);
+                // Try to find if it's a numeric Garmin mapping that was missed
+                const manufacturerName = typeof manufacturer === 'number' ? GarminProfileMapper.getManufacturerName(manufacturer) : manufacturer;
+                if (manufacturerName === 'garmin') {
+                    recognizedName = GarminProfileMapper.getDeviceName(productId);
+                }
+                creator = new Creator(formatDeviceName(manufacturer, productName, recognizedName, manufacturerName === 'garmin' ? 'Garmin' : null), productId);
             }
         }
         creator.manufacturer = manufacturer;

package/lib/esm/events/adapters/importers/fit/importer.fit.spec.js

@@ -46,7 +46,7 @@ describe('EventImporterFIT', () => {
             it('should recognize a known Garmin device', done => {
                 const manufacturer = 'garmin';
                 const expectedName = 'Garmin Edge 1000';
-                const productId = 2274;
+                const productId = 1836;
                 const fitDataObject = generateFitDeviceDataObject(manufacturer, productId);
                 // When
                 const creator = EventImporterFIT.getCreatorFromFitDataObject(fitDataObject);

package/lib/esm/index.d.ts

@@ -33,3 +33,117 @@ export declare class SportsLib {
      */
     static importFromJSON(json: EventJSONInterface): EventInterface;
 }
+export * from './activities/activity.interface';
+export * from './activities/activity.json.interface';
+export * from './activities/activity.types';
+export * from './constants/constants';
+export * from './data/data-aerobic-training-effect';
+export * from './data/data.absolute-pressure';
+export * from './data/data.accumulated-power';
+export * from './data/data.activity-types';
+export * from './data/data.air-power';
+export * from './data/data.altitude';
+export * from './data/data.altitude-avg';
+export * from './data/data.altitude-gps';
+export * from './data/data.altitude-max';
+export * from './data/data.altitude-min';
+export * from './data/data.ascent';
+export * from './data/data.cadence-avg';
+export * from './data/data.cadence-max';
+export * from './data/data.cadence-min';
+export * from './data/data.descent';
+export * from './data/data.description';
+export * from './data/data.device-names';
+export * from './data/data.distance';
+export * from './data/data.duration';
+export * from './data/data.ehpe';
+export * from './data/data.energy';
+export * from './data/data.epoc';
+export * from './data/data.evpe';
+export * from './data/data.feeling';
+export * from './data/data.grade-adjusted-pace';
+export * from './data/data.grade-adjusted-pace-avg';
+export * from './data/data.grade-adjusted-speed';
+export * from './data/data.grade-adjusted-speed-avg';
+export * from './data/data.heart-rate';
+export * from './data/data.heart-rate-avg';
+export * from './data/data.heart-rate-max';
+export * from './data/data.heart-rate-min';
+export * from './data/data.ibi';
+export * from './data/data.interface';
+export * from './data/data.latitude-degrees';
+export * from './data/data.left-balance';
+export * from './data/data.longitude-degrees';
+export * from './data/data.moving-time';
+export * from './data/data.pace';
+export * from './data/data.pace-avg';
+export * from './data/data.peak-epoc';
+export * from './data/data.peak-training-effect';
+export * from './data/data.position.interface';
+export * from './data/data.power';
+export * from './data/data.power-avg';
+export * from './data/data.power-left';
+export * from './data/data.power-max';
+export * from './data/data.power-min';
+export * from './data/data.power-right';
+export * from './data/data.recovery-time';
+export * from './data/data.right-balance';
+export * from './data/data.rpe';
+export * from './data/data.sea-level-pressure';
+export * from './data/data.speed';
+export * from './data/data.speed-avg';
+export * from './data/data.speed-max';
+export * from './data/data.speed-min';
+export * from './data/data.start-position';
+export * from './data/data.store';
+export * from './data/data.stryd-altitude';
+export * from './data/data.stryd-distance';
+export * from './data/data.stryd-speed';
+export * from './data/data.swim-pace';
+export * from './data/data.swim-pace-avg';
+export * from './data/data.swim-pace-max';
+export * from './data/data.temperature';
+export * from './data/data.temperature-avg';
+export * from './data/data.temperature-max';
+export * from './data/data.temperature-min';
+export * from './data/data.vertical-speed';
+export * from './data/data.vertical-speed-avg';
+export * from './data/data.vo2-max';
+export * from './data/ibi/data.ibi';
+export * from './events/adapters/exporters/exporter.gpx';
+export * from './events/adapters/exporters/exporter.json';
+export * from './events/adapters/importers/fit/importer.fit';
+export * from './events/adapters/importers/gpx/importer.gpx';
+export * from './events/adapters/importers/json/importer.json';
+export * from './events/adapters/importers/suunto/importer.suunto.json';
+export * from './events/adapters/importers/suunto/importer.suunto.sml';
+export * from './events/adapters/importers/tcx/importer.tcx';
+export * from './events/event.interface';
+export * from './events/event.json.interface';
+export * from './events/utilities/activity.utilities';
+export * from './events/utilities/event.utilities';
+export * from './events/utilities/helpers';
+export * from './geodesy/adapters/geolib.adapter';
+export * from './laps/lap.interface';
+export * from './laps/lap.types';
+export * from './meta-data/event-meta-data.interface';
+export * from './meta-data/meta-data';
+export * from './privacy/privacy.class.interface';
+export * from './service-tokens/oauth1-service-token.interface';
+export * from './service-tokens/oauth2-service-token.interface';
+export * from './stats/stats.class.interface';
+export * from './streams/compressed.stream.interface';
+export * from './streams/stream';
+export * from './streams/stream.interface';
+export * from './tiles/tile.settings.interface';
+export * from './users/settings/dashboard/user.dashboard.settings.interface';
+export * from './users/settings/user.app.settings.interface';
+export * from './users/settings/user.chart.settings.interface';
+export * from './users/settings/user.map.settings.interface';
+export * from './users/settings/user.my-tracks.settings.interface';
+export * from './users/settings/user.settings.interface';
+export * from './users/settings/user.summaries.settings.interface';
+export * from './users/settings/user.unit.settings.interface';
+export * from './users/user';
+export * from './users/user.export-to-csv.settings.interface';
+export * from './users/user.service.meta.interface';

package/lib/esm/index.js

@@ -45,3 +45,117 @@ export class SportsLib {
         return EventImporterJSON.getEventFromJSON(json);
     }
 }
+export * from './activities/activity.interface';
+export * from './activities/activity.json.interface';
+export * from './activities/activity.types';
+export * from './constants/constants';
+export * from './data/data-aerobic-training-effect';
+export * from './data/data.absolute-pressure';
+export * from './data/data.accumulated-power';
+export * from './data/data.activity-types';
+export * from './data/data.air-power';
+export * from './data/data.altitude';
+export * from './data/data.altitude-avg';
+export * from './data/data.altitude-gps';
+export * from './data/data.altitude-max';
+export * from './data/data.altitude-min';
+export * from './data/data.ascent';
+export * from './data/data.cadence-avg';
+export * from './data/data.cadence-max';
+export * from './data/data.cadence-min';
+export * from './data/data.descent';
+export * from './data/data.description';
+export * from './data/data.device-names';
+export * from './data/data.distance';
+export * from './data/data.duration';
+export * from './data/data.ehpe';
+export * from './data/data.energy';
+export * from './data/data.epoc';
+export * from './data/data.evpe';
+export * from './data/data.feeling';
+export * from './data/data.grade-adjusted-pace';
+export * from './data/data.grade-adjusted-pace-avg';
+export * from './data/data.grade-adjusted-speed';
+export * from './data/data.grade-adjusted-speed-avg';
+export * from './data/data.heart-rate';
+export * from './data/data.heart-rate-avg';
+export * from './data/data.heart-rate-max';
+export * from './data/data.heart-rate-min';
+export * from './data/data.ibi';
+export * from './data/data.interface';
+export * from './data/data.latitude-degrees';
+export * from './data/data.left-balance';
+export * from './data/data.longitude-degrees';
+export * from './data/data.moving-time';
+export * from './data/data.pace';
+export * from './data/data.pace-avg';
+export * from './data/data.peak-epoc';
+export * from './data/data.peak-training-effect';
+export * from './data/data.position.interface';
+export * from './data/data.power';
+export * from './data/data.power-avg';
+export * from './data/data.power-left';
+export * from './data/data.power-max';
+export * from './data/data.power-min';
+export * from './data/data.power-right';
+export * from './data/data.recovery-time';
+export * from './data/data.right-balance';
+export * from './data/data.rpe';
+export * from './data/data.sea-level-pressure';
+export * from './data/data.speed';
+export * from './data/data.speed-avg';
+export * from './data/data.speed-max';
+export * from './data/data.speed-min';
+export * from './data/data.start-position';
+export * from './data/data.store';
+export * from './data/data.stryd-altitude';
+export * from './data/data.stryd-distance';
+export * from './data/data.stryd-speed';
+export * from './data/data.swim-pace';
+export * from './data/data.swim-pace-avg';
+export * from './data/data.swim-pace-max';
+export * from './data/data.temperature';
+export * from './data/data.temperature-avg';
+export * from './data/data.temperature-max';
+export * from './data/data.temperature-min';
+export * from './data/data.vertical-speed';
+export * from './data/data.vertical-speed-avg';
+export * from './data/data.vo2-max';
+export * from './data/ibi/data.ibi';
+export * from './events/adapters/exporters/exporter.gpx';
+export * from './events/adapters/exporters/exporter.json';
+export * from './events/adapters/importers/fit/importer.fit';
+export * from './events/adapters/importers/gpx/importer.gpx';
+export * from './events/adapters/importers/json/importer.json';
+export * from './events/adapters/importers/suunto/importer.suunto.json';
+export * from './events/adapters/importers/suunto/importer.suunto.sml';
+export * from './events/adapters/importers/tcx/importer.tcx';
+export * from './events/event.interface';
+export * from './events/event.json.interface';
+export * from './events/utilities/activity.utilities';
+export * from './events/utilities/event.utilities';
+export * from './events/utilities/helpers';
+export * from './geodesy/adapters/geolib.adapter';
+export * from './laps/lap.interface';
+export * from './laps/lap.types';
+export * from './meta-data/event-meta-data.interface';
+export * from './meta-data/meta-data';
+export * from './privacy/privacy.class.interface';
+export * from './service-tokens/oauth1-service-token.interface';
+export * from './service-tokens/oauth2-service-token.interface';
+export * from './stats/stats.class.interface';
+export * from './streams/compressed.stream.interface';
+export * from './streams/stream';
+export * from './streams/stream.interface';
+export * from './tiles/tile.settings.interface';
+export * from './users/settings/dashboard/user.dashboard.settings.interface';
+export * from './users/settings/user.app.settings.interface';
+export * from './users/settings/user.chart.settings.interface';
+export * from './users/settings/user.map.settings.interface';
+export * from './users/settings/user.my-tracks.settings.interface';
+export * from './users/settings/user.settings.interface';
+export * from './users/settings/user.summaries.settings.interface';
+export * from './users/settings/user.unit.settings.interface';
+export * from './users/user';
+export * from './users/user.export-to-csv.settings.interface';
+export * from './users/user.service.meta.interface';

package/lib/esm/specs/activity-duration-stream.integration.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/esm/specs/activity-duration-stream.integration.spec.js

@@ -0,0 +1,57 @@
+import { Activity } from '../activities/activity';
+import { Creator } from '../creators/creator';
+import { DataDistance } from '../data/data.distance';
+import { ActivityTypes } from '../activities/activity.types';
+import { DataDuration } from '../data/data.duration';
+describe('Activity Duration Stream', () => {
+    let activity;
+    beforeEach(() => {
+        // Create a 10-second activity
+        const startDate = new Date('2023-01-01T10:00:00Z');
+        const endDate = new Date('2023-01-01T10:00:10Z');
+        const creator = new Creator('Test Creator');
+        activity = new Activity(startDate, endDate, ActivityTypes.Running, creator);
+    });
+    it('should generate a duration stream based on time stream logic', () => {
+        // Add a distance stream with some data
+        const distanceStream = activity.createStream(DataDistance.type);
+        // Data at 0s, 5s, 10s
+        distanceStream.getData()[0] = 0;
+        distanceStream.getData()[5] = 50;
+        distanceStream.getData()[10] = 100;
+        activity.addStream(distanceStream);
+        const durationStream = activity.generateDurationStream();
+        expect(durationStream.type).toBe(DataDuration.type);
+        const data = durationStream.getData();
+        // Assuming generateTimeStream fills data where source stream has data
+        expect(data[0]).toBe(0);
+        expect(data[5]).toBe(5);
+        expect(data[10]).toBe(10);
+        // Other indices should be null/undefined as per generateTimeStream logic?
+        // Let's verify what generateTimeStream does.
+        // It uses `getStreamDataByDuration` with filterNull=true.
+        // So it only populates indices where source stream has data.
+        expect(data[1]).toBeFalsy();
+        expect(data[2]).toBeFalsy();
+    });
+    it('should allow specifying stream types to base duration on', () => {
+        // Scenario where we want duration based on HeartRate, not Distance
+        // Although logic reuses generateTimeStream which filters by streamTypes if provided.
+        // But generateTimeStream implementation:
+        /*
+            if (streamTypes.length) {
+              streams = streams.filter(stream => streamTypes.indexOf(stream.type) !== -1);
+            }
+            */
+        // It unions all provided streams?
+        // "streams.forEach(stream => { ... })"
+        // Yes, it iterates all matching streams and fills the time stream.
+        // Let's create a custom stream
+        const customStream = activity.createStream('Custom');
+        customStream.getData()[2] = 123;
+        activity.addStream(customStream);
+        const durationStream = activity.generateDurationStream(['Custom']);
+        expect(durationStream.getData()[2]).toBe(2);
+        expect(durationStream.getData()[0]).toBeFalsy(); // Distance stream at 0 should be ignored if we only asked for Custom
+    });
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sports-alliance/sports-lib",
-  "version": "6.1.0",
+  "version": "6.1.3",
   "description": "A Library to for importing / exporting and processing GPX, TCX, FIT and JSON files from services such as Strava, Movescount, Garmin, Polar etc",
   "keywords": [
     "gpx",
@@ -64,6 +64,7 @@
   "devDependencies": {
     "@babel/core": "^7.28.5",
     "@babel/preset-env": "^7.28.5",
+    "@garmin/fitsdk": "^21.178.0",
     "@types/jest": "^27.0.1",
     "@types/node": "^14.6.1",
     "@types/xmldom": "^0.1.31",