@sports-alliance/sports-lib 6.1.7 → 6.1.9

package/lib/cjs/activities/activity-parsing-options.d.ts

@@ -14,5 +14,6 @@ export declare class ActivityParsingOptions {
         };
     };
     maxActivityDurationDays: number;
+    generateUnitStreams: boolean;
     constructor(options: ActivityParsingOptions);
 }

package/lib/cjs/activities/activity-parsing-options.js

@@ -3,8 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActivityParsingOptions = void 0;
 class ActivityParsingOptions {
     constructor(options) {
+        var _a;
         this.streams = options.streams;
         this.maxActivityDurationDays = options.maxActivityDurationDays;
+        this.generateUnitStreams = (_a = options.generateUnitStreams) !== null && _a !== void 0 ? _a : true;
     }
 }
 exports.ActivityParsingOptions = ActivityParsingOptions;
@@ -13,5 +15,6 @@ ActivityParsingOptions.DEFAULT = new ActivityParsingOptions({
         smooth: { altitudeSmooth: true, grade: true, gradeSmooth: true },
         fixAbnormal: { speed: false }
     },
-    maxActivityDurationDays: 14
+    maxActivityDurationDays: 14,
+    generateUnitStreams: true
 });

package/lib/cjs/events/utilities/activity.utilities.js

@@ -291,7 +291,9 @@ class ActivityUtilities {
     static generateMissingStreams(activity) {
         // Compute missing streams
         this.generateMissingStreamsForActivity(activity);
-        activity.addStreams(this.createUnitStreamsFromStreams(activity.getAllStreams(), activity.type));
+        if (!activity.parseOptions || activity.parseOptions.generateUnitStreams) {
+            activity.addStreams(this.createUnitStreamsFromStreams(activity.getAllStreams(), activity.type));
+        }
     }
     static getSummaryStatsForActivities(activities) {
         const stats = [];

package/lib/cjs/events/utilities/activity.utilities.spec.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const event_1 = require("../event");
+const data_speed_max_1 = require("../../data/data.speed-max");
 const activity_1 = require("../../activities/activity");
 const data_heart_rate_1 = require("../../data/data.heart-rate");
 const data_altitude_1 = require("../../data/data.altitude");
@@ -261,4 +262,58 @@ describe('Activity Utilities', () => {
             expect(paceUnitStream).toBeUndefined();
         });
     });
+    describe('generateMissingStreams', () => {
+        it('should generate unit streams by default (generateUnitStreams = true)', () => {
+            const activity = new activity_1.Activity(new Date(), new Date(), activity_types_1.ActivityTypes.Running, new creator_1.Creator('test'));
+            // Add a speed stream
+            activity.addStream(new stream_1.Stream(data_speed_1.DataSpeed.type, [10, 20]));
+            activity_utilities_1.ActivityUtilities.generateMissingStreams(activity);
+            // Should have generated "sister" types (e.g. Pace) and unit variants (e.g. Speed km/h)
+            expect(activity.hasStreamData(data_speed_2.DataSpeedKilometersPerHour.type)).toBe(true);
+            expect(activity.hasStreamData(data_pace_1.DataPaceMinutesPerMile.type)).toBe(true);
+        });
+        it('should NOT generate unit streams when generateUnitStreams = false', () => {
+            const activity = new activity_1.Activity(new Date(), new Date(), activity_types_1.ActivityTypes.Running, new creator_1.Creator('test'));
+            // Mock parsing options
+            activity.parseOptions = {
+                streams: { smooth: {}, fixAbnormal: {} },
+                maxActivityDurationDays: 14,
+                generateUnitStreams: false,
+            };
+            // Add a speed stream
+            activity.addStream(new stream_1.Stream(data_speed_1.DataSpeed.type, [10, 20]));
+            activity_utilities_1.ActivityUtilities.generateMissingStreams(activity);
+            // Should NOT have generated unit variants
+            expect(activity.hasStreamData(data_speed_2.DataSpeedKilometersPerHour.type)).toBe(false);
+            // It might still generate some "derived" streams depending on other flags, but our specific unit loop should be skipped
+            // The Pace stream comes from createUnitStreamsFromStreams too, so it should also be missing
+            expect(activity.hasStreamData(data_pace_1.DataPaceMinutesPerMile.type)).toBe(false);
+        });
+    });
+    describe('generateMissingStreamsAndStatsForActivity', () => {
+        it('should generate unit STATS even if unit STREAMS are disabled', () => {
+            const activity = new activity_1.Activity(new Date(), new Date(), activity_types_1.ActivityTypes.Running, new creator_1.Creator('test'));
+            activity.parseOptions = {
+                streams: { smooth: {}, fixAbnormal: {} },
+                maxActivityDurationDays: 14,
+                generateUnitStreams: false, // DISABLE streams
+            };
+            // Add a speed stream [10 m/s, 20 m/s]
+            // Max speed = 20 m/s
+            activity.addStream(new stream_1.Stream(data_speed_1.DataSpeed.type, [10, 20]));
+            activity_utilities_1.ActivityUtilities.generateMissingStreamsAndStatsForActivity(activity);
+            // 1. Verify Streams are missing (as requested)
+            expect(activity.hasStreamData(data_speed_2.DataSpeedKilometersPerHour.type)).toBe(false);
+            // 1. Verify Streams are missing (as requested)
+            expect(activity.hasStreamData(data_speed_2.DataSpeedKilometersPerHour.type)).toBe(false);
+            // 2. Verify Stats are PRESENT (Safety Check)
+            // 20 m/s = 72 km/h
+            // We check for the stat by its string type if we can't import the constant easily, or iterate.
+            // Based on activity.utilities.ts it uses: DataSpeedMaxKilometersPerHour
+            const allStats = Array.from(activity.getStats().values());
+            const speedMaxKmh = allStats.find(s => s.getType() === data_speed_max_1.DataSpeedMaxKilometersPerHour.type);
+            expect(speedMaxKmh).toBeDefined();
+            expect(speedMaxKmh === null || speedMaxKmh === void 0 ? void 0 : speedMaxKmh.getValue()).toBe(72);
+        });
+    });
 });

package/lib/cjs/index.d.ts

@@ -34,6 +34,7 @@ export declare class SportsLib {
     static importFromJSON(json: EventJSONInterface): EventInterface;
 }
 export * from './activities/activity.interface';
+export * from './activities/activity-parsing-options';
 export * from './activities/activity.json.interface';
 export * from './activities/activity.types';
 export * from './constants/constants';

package/lib/cjs/index.js

@@ -60,6 +60,7 @@ class SportsLib {
 }
 exports.SportsLib = SportsLib;
 __exportStar(require("./activities/activity.interface"), exports);
+__exportStar(require("./activities/activity-parsing-options"), exports);
 __exportStar(require("./activities/activity.json.interface"), exports);
 __exportStar(require("./activities/activity.types"), exports);
 __exportStar(require("./constants/constants"), exports);

package/lib/esm/activities/activity-parsing-options.d.ts

@@ -14,5 +14,6 @@ export declare class ActivityParsingOptions {
         };
     };
     maxActivityDurationDays: number;
+    generateUnitStreams: boolean;
     constructor(options: ActivityParsingOptions);
 }

package/lib/esm/activities/activity-parsing-options.js

@@ -1,7 +1,9 @@
 export class ActivityParsingOptions {
     constructor(options) {
+        var _a;
         this.streams = options.streams;
         this.maxActivityDurationDays = options.maxActivityDurationDays;
+        this.generateUnitStreams = (_a = options.generateUnitStreams) !== null && _a !== void 0 ? _a : true;
     }
 }
 ActivityParsingOptions.DEFAULT = new ActivityParsingOptions({
@@ -9,5 +11,6 @@ ActivityParsingOptions.DEFAULT = new ActivityParsingOptions({
         smooth: { altitudeSmooth: true, grade: true, gradeSmooth: true },
         fixAbnormal: { speed: false }
     },
-    maxActivityDurationDays: 14
+    maxActivityDurationDays: 14,
+    generateUnitStreams: true
 });

package/lib/esm/events/utilities/activity.utilities.js

@@ -288,7 +288,9 @@ export class ActivityUtilities {
     static generateMissingStreams(activity) {
         // Compute missing streams
         this.generateMissingStreamsForActivity(activity);
-        activity.addStreams(this.createUnitStreamsFromStreams(activity.getAllStreams(), activity.type));
+        if (!activity.parseOptions || activity.parseOptions.generateUnitStreams) {
+            activity.addStreams(this.createUnitStreamsFromStreams(activity.getAllStreams(), activity.type));
+        }
     }
     static getSummaryStatsForActivities(activities) {
         const stats = [];

package/lib/esm/events/utilities/activity.utilities.spec.js

@@ -1,4 +1,5 @@
 import { Event } from '../event';
+import { DataSpeedMaxKilometersPerHour } from '../../data/data.speed-max';
 import { Activity } from '../../activities/activity';
 import { DataHeartRate } from '../../data/data.heart-rate';
 import { DataAltitude } from '../../data/data.altitude';
@@ -259,4 +260,58 @@ describe('Activity Utilities', () => {
             expect(paceUnitStream).toBeUndefined();
         });
     });
+    describe('generateMissingStreams', () => {
+        it('should generate unit streams by default (generateUnitStreams = true)', () => {
+            const activity = new Activity(new Date(), new Date(), ActivityTypes.Running, new Creator('test'));
+            // Add a speed stream
+            activity.addStream(new Stream(DataSpeed.type, [10, 20]));
+            ActivityUtilities.generateMissingStreams(activity);
+            // Should have generated "sister" types (e.g. Pace) and unit variants (e.g. Speed km/h)
+            expect(activity.hasStreamData(DataSpeedKilometersPerHour.type)).toBe(true);
+            expect(activity.hasStreamData(DataPaceMinutesPerMile.type)).toBe(true);
+        });
+        it('should NOT generate unit streams when generateUnitStreams = false', () => {
+            const activity = new Activity(new Date(), new Date(), ActivityTypes.Running, new Creator('test'));
+            // Mock parsing options
+            activity.parseOptions = {
+                streams: { smooth: {}, fixAbnormal: {} },
+                maxActivityDurationDays: 14,
+                generateUnitStreams: false,
+            };
+            // Add a speed stream
+            activity.addStream(new Stream(DataSpeed.type, [10, 20]));
+            ActivityUtilities.generateMissingStreams(activity);
+            // Should NOT have generated unit variants
+            expect(activity.hasStreamData(DataSpeedKilometersPerHour.type)).toBe(false);
+            // It might still generate some "derived" streams depending on other flags, but our specific unit loop should be skipped
+            // The Pace stream comes from createUnitStreamsFromStreams too, so it should also be missing
+            expect(activity.hasStreamData(DataPaceMinutesPerMile.type)).toBe(false);
+        });
+    });
+    describe('generateMissingStreamsAndStatsForActivity', () => {
+        it('should generate unit STATS even if unit STREAMS are disabled', () => {
+            const activity = new Activity(new Date(), new Date(), ActivityTypes.Running, new Creator('test'));
+            activity.parseOptions = {
+                streams: { smooth: {}, fixAbnormal: {} },
+                maxActivityDurationDays: 14,
+                generateUnitStreams: false, // DISABLE streams
+            };
+            // Add a speed stream [10 m/s, 20 m/s]
+            // Max speed = 20 m/s
+            activity.addStream(new Stream(DataSpeed.type, [10, 20]));
+            ActivityUtilities.generateMissingStreamsAndStatsForActivity(activity);
+            // 1. Verify Streams are missing (as requested)
+            expect(activity.hasStreamData(DataSpeedKilometersPerHour.type)).toBe(false);
+            // 1. Verify Streams are missing (as requested)
+            expect(activity.hasStreamData(DataSpeedKilometersPerHour.type)).toBe(false);
+            // 2. Verify Stats are PRESENT (Safety Check)
+            // 20 m/s = 72 km/h
+            // We check for the stat by its string type if we can't import the constant easily, or iterate.
+            // Based on activity.utilities.ts it uses: DataSpeedMaxKilometersPerHour
+            const allStats = Array.from(activity.getStats().values());
+            const speedMaxKmh = allStats.find(s => s.getType() === DataSpeedMaxKilometersPerHour.type);
+            expect(speedMaxKmh).toBeDefined();
+            expect(speedMaxKmh === null || speedMaxKmh === void 0 ? void 0 : speedMaxKmh.getValue()).toBe(72);
+        });
+    });
 });

package/lib/esm/index.d.ts

@@ -34,6 +34,7 @@ export declare class SportsLib {
     static importFromJSON(json: EventJSONInterface): EventInterface;
 }
 export * from './activities/activity.interface';
+export * from './activities/activity-parsing-options';
 export * from './activities/activity.json.interface';
 export * from './activities/activity.types';
 export * from './constants/constants';

package/lib/esm/index.js

@@ -46,6 +46,7 @@ export class SportsLib {
     }
 }
 export * from './activities/activity.interface';
+export * from './activities/activity-parsing-options';
 export * from './activities/activity.json.interface';
 export * from './activities/activity.types';
 export * from './constants/constants';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sports-alliance/sports-lib",
-  "version": "6.1.7",
+  "version": "6.1.9",
   "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",