@garmin/fitsdk 21.170.0 → 21.178.0

package/README.md

@@ -9,7 +9,8 @@ The FIT JavaScript SDK uses ECMAScript module syntax and requires Node.js v14.0
 ```sh
 npm install @garmin/fitsdk
 ```
-## Usage
+## Decoder
+### Usage
 ````js
 import { Decoder, Stream, Profile, Utils } from '@garmin/fitsdk';
 
@@ -27,8 +28,6 @@ const { messages, errors } = decoder.read();
 console.log(errors);
 console.log(messages);
 ````
-## Decoder
-
 ### Constructor
 
 Decoder objects are created from Streams representing the binary FIT file data to be decoded. See [Creating Streams](#creatingstreams) for more information on constructing Stream objects.
@@ -37,16 +36,16 @@ Once a Decoder object is created it can be used to check that the Stream is a FI
 
 ### isFIT Method
 
-All valid FIT files should include a 12 or 14 byte file header. The 14 byte header is the preferred header size and the most common size used. Bytes 8–11 of the header contain the ASCII values ".FIT”. This string can easily be spotted when opening a binary FIT file in a text or hex editor.
+All valid FIT files should include a 12 or 14 byte file header. The 14 byte header is the preferred header size and the most common size used. Bytes 8–11 of the header contain the ASCII values ".FIT". This string can easily be spotted when opening a binary FIT file in a text or hex editor.
 
-```
+````bash
   Offset: 00 01 02 03 04 05 06 07 08 09 0A 0B 0C 0D 0E 0F
 00000000: 0E 10 43 08 78 06 09 00 2E 46 49 54 96 85 40 00    ..C.x....FIT..@.
 00000010: 00 00 00 07 03 04 8C 04 04 86 07 04 86 01 02 84    ................
 00000020: 02 02 84 05 02 84 00 01 00 00 19 28 7E C5 95 B0    ...........(~E.0
-```
+````
 
-The isFIT method reads the file header and returns true if bytes 8–11 are equal to the ACSII values ".FIT”. isFIT provides a quick way to check that the file is a FIT file before attempting to decode the file.
+The isFIT method reads the file header and returns true if bytes 8–11 are equal to the ACSII values ".FIT". isFIT provides a quick way to check that the file is a FIT file before attempting to decode the file.
 
 The Decoder class includes a static and instance version of the isFIT method.
 
@@ -54,7 +53,7 @@ The Decoder class includes a static and instance version of the isFIT method.
 
 The checkIntegrity method performs three checks on a FIT file:
 
-1. Checks that bytes 8–11 of the header contain the ASCII values ".FIT”.
+1. Checks that bytes 8–11 of the header contain the ASCII values ".FIT".
 2. Checks that the total file size is equal to Header Size + Data Size + CRC Size.
 3. Reads the contents of the file, computes the CRC, and then checks that the computed CRC matches the file CRC.
 
@@ -77,13 +76,13 @@ const { messages, errors } = decoder.read({
     convertDateTimesToDates: true,
     includeUnknownData: false,
     mergeHeartRates: true
+    decodeMemoGlobs: false,
 });
 ````
 #### mesgListener = (messageNumber, message) => {}
 Optional callback function that can be used to inspect or manipulate messages after they are fully decoded and all the options have been applied. The message is mutable and we be returned from the Read method in the messages dictionary.
 
 Example mesgListener callback that tracks the field names across all Record messages.
-
 ````js
 const recordFields = new Set();
 
@@ -180,6 +179,10 @@ When true unknown field values are stored in the message using the field id as t
 ````
 #### mergeHeartRates: true | false
 When true automatically merge heart rate values from HR messages into the Record messages. This option requires the applyScaleAndOffset and expandComponents options to be enabled. This option has no effect on the Record messages when no HR messages are present in the decoded messages.
+
+#### decodeMemoGlobs: true | false
+When true, the decoder will reconstruct strings from memoGlob messages. Each reconstructed string will overwrite the targeted message field.
+
 ## Creating Streams
 Stream objects contain the binary FIT data to be decoded. Streams objects can be created from byte-arrays, ArrayBuffers, and Node.js Buffers. Internally the Stream class uses an ArrayBuffer to manage the byte stream.
 #### From a Byte Array
@@ -221,3 +224,65 @@ A convince method for converting FIT Epoch values to JavaScript Date objects.
 ````js
 const jsDate = Utils.convertDateTimeToDate(fitDateTime);
 ````
+## Encoder
+### Usage
+````js 
+// Import the SDK
+import { Encoder, Profile} from "@garmin/fitsdk";
+
+// Create an Encoder
+const encoder = new Encoder();
+
+//
+// Write messages to the output-stream
+//
+// The message data should match the format returned by
+// the Decoder. Field names should be camelCase. The fields 
+// definitions can be found in the Profile.
+//
+
+// Pass the MesgNum and message data as separate parameters to the onMesg() method
+encoder.onMesg(Profile.MesgNum.FILE_ID, {
+  manufacturer: "development",
+  product: 1,
+  timeCreated: new Date(),
+  type: "activity",
+});
+
+// The writeMesg() method expects the mesgNum to be included in the message data
+// Internally, writeMesg() calls onMesg()
+encoder.writeMesg({
+  mesgNum: Profile.MesgNum.FILE_ID,
+  manufacturer: "development",
+  product: 1,
+  timeCreated: new Date(),
+  type: "activity",
+});
+
+// Unknown values in the message will be ignored by the Encoder
+encoder.onMesg(Profile.MesgNum.FILE_ID, {
+  manufacturer: "development",
+  product: 1,
+  timeCreated: new Date(),
+  type: "activity",
+  customField: 12345, // This value will be ignored by the Encoder
+});
+
+// Subfield values in the message will be ignored by the Encoder
+encoder.onMesg(Profile.MesgNum.FILE_ID, {
+  manufacturer: "development",
+  product: 4440, // This is the main product field, which is a uint16
+  garminProduct: "edge1050", // This value will be ignored by the Encoder, use the main field value instead
+  timeCreated: new Date(),
+  type: "activity",
+});
+
+// Closing the encoder returns the file as an UInt8 Array
+const uint8Array = encoder.close();
+
+// Write the file to disk,
+import * as fs from "fs";
+fs.writeFileSync("example.fit", uint8Array);
+       
+````
+See the [Encode Activity Recipe](https://github.com/garmin/fit-javascript-sdk/blob/main/test/encode-activity-recipe.test.js) for a complete example of encoding a FIT Activity file usine the FIT JavaScript SDK.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@garmin/fitsdk",
-  "version": "21.170.0",
+  "version": "21.178.0",
   "description": "FIT JavaScript SDK",
   "main": "src/index.js",
   "type": "module",

package/src/accumulator.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 

package/src/bit-stream.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 

package/src/crc-calculator.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 

package/src/decoder.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 
@@ -729,8 +729,8 @@ class Decoder {
             return rawFieldValue;
         }
 
-        const scale = Array.isArray(field?.scale ?? 1) ? field?.scale[0] : field?.scale ?? 1;
-        const offset = Array.isArray(field?.offset ?? 1) ? field?.offset[0] : field?.offset ?? 0;
+        const scale = Array.isArray(field?.scale ?? FIT.FIELD_DEFAULT_SCALE) ? field?.scale[0] : field?.scale ?? FIT.FIELD_DEFAULT_SCALE;
+        const offset = Array.isArray(field?.offset ?? FIT.FIELD_DEFAULT_OFFSET) ? field?.offset[0] : field?.offset ?? FIT.FIELD_DEFAULT_OFFSET;
 
         try {
             if (Array.isArray(rawFieldValue)) {

package/src/encoder.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 
@@ -20,9 +20,6 @@ import Utils from "./utils.js";
 const HEADER_WITH_CRC_SIZE = 14;
 const HEADER_WITHOUT_CRC_SIZE = 12;
 
-const FIELD_DEFAULT_SCALE = 1;
-const FIELD_DEFAULT_OFFSET = 0;
-
 /**
  * A class for encoding FIT files.
  * @class
@@ -131,7 +128,7 @@ class Encoder {
             throw new Error("addDeveloperField() - one or more developerDataIndex values are null.", {
                  cause: {
                     key,
-                    developerDataIdMesg, 
+                    developerDataIdMesg,
                     fieldDescriptionMesg
                 }
             });
@@ -141,7 +138,7 @@ class Encoder {
             throw new Error("addDeveloperField() - developerDataIndex values do not match.", {
                  cause: {
                     key,
-                    developerDataIdMesg, 
+                    developerDataIdMesg,
                     fieldDescriptionMesg
                 }
             });
@@ -215,12 +212,10 @@ class Encoder {
                     throw new Error();
                 }
 
-                const scale = fieldDefinition.components.length > 1 ? FIELD_DEFAULT_SCALE : fieldDefinition.scale;
-                const offset = fieldDefinition.components.length > 1 ? FIELD_DEFAULT_OFFSET : fieldDefinition.offset;
-                const hasScaleOrOffset = (scale != FIELD_DEFAULT_SCALE || offset != FIELD_DEFAULT_OFFSET);
+                const hasScaleOrOffset = (fieldDefinition.scale != FIT.FIELD_DEFAULT_SCALE || fieldDefinition.offset != FIT.FIELD_DEFAULT_OFFSET);
 
                 if (hasScaleOrOffset) {
-                    const scaledValue = (value + offset) * scale;
+                    const scaledValue = (value + fieldDefinition.offset) * fieldDefinition.scale;
 
                     return FIT.FloatingPointFieldTypes.includes(fieldDefinition.type) ? scaledValue : Math.round(scaledValue);
                 }

package/src/fit.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 
@@ -172,6 +172,8 @@ export default {
     isNumberStringDateOrBoolean,
     isNotNumberStringDateOrBoolean,
     MAX_FIELD_SIZE: 255,
+    FIELD_DEFAULT_SCALE: 1,
+    FIELD_DEFAULT_OFFSET: 0,
     MESG_DEFINITION_MASK: 0x40,
     LOCAL_MESG_NUM_MASK: 0x0F,
     ARCH_LITTLE_ENDIAN: 0x00,

package/src/index.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 

package/src/mesg-definition.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 
@@ -56,14 +56,20 @@ class MesgDefinition {
                 const baseType = FIT.FieldTypeToBaseType[fieldProfile[1].baseType];
                 const baseTypeDef = FIT.BaseTypeDefinitions[baseType];
 
+                let scale = fieldProfile[1].components.length > 1 ? FIT.FIELD_DEFAULT_SCALE : fieldProfile[1].scale;
+                let offset = fieldProfile[1].components.length > 1 ? FIT.FIELD_DEFAULT_OFFSET : fieldProfile[1].offset;
+
+                scale = Array.isArray(scale) ? scale[0] : scale ?? FIT.FIELD_DEFAULT_SCALE;
+                offset = Array.isArray(offset) ? offset[0] : offset ?? FIT.FIELD_DEFAULT_OFFSET;
+
                 this.fieldDefinitions.push({
                     name: fieldName,
                     num: fieldProfile[1].num,
                     size: this.#fieldSize(mesg[fieldName], baseTypeDef),
                     baseType: baseType,
                     type: fieldProfile[1].type,
-                    scale: fieldProfile[1].scale,
-                    offset: fieldProfile[1].offset,
+                    scale,
+                    offset,
                     components: fieldProfile[1].components,
                 });
             });

package/src/output-stream.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 

package/src/profile.js

@@ -5,15 +5,15 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 
 const Profile = {
     version: {
         major: 21,
-        minor: 170,
+        minor: 178,
         patch: 0,
         type: "Release"
     },
@@ -22980,6 +22980,95 @@ const Profile = {
                     subFields: []
             },
         },
+     },
+        470: {
+            num: 470,
+            name: "sleepDisruptionSeverityPeriod",
+            messagesKey: "sleepDisruptionSeverityPeriodMesgs",
+            fields: {
+            254: {
+                num: 254,
+                name: "messageIndex",
+                type: "messageIndex",
+                baseType: "uint16",
+                array: false,
+                scale: 1,
+                offset: 0,
+                units: "",
+                bits: [],
+                    components: [],
+                    isAccumulated: false,
+                    hasComponents: false,
+                    subFields: []
+            },
+            253: {
+                num: 253,
+                name: "timestamp",
+                type: "dateTime",
+                baseType: "uint32",
+                array: false,
+                scale: 1,
+                offset: 0,
+                units: "",
+                bits: [],
+                    components: [],
+                    isAccumulated: false,
+                    hasComponents: false,
+                    subFields: []
+            },
+            0: {
+                num: 0,
+                name: "severity",
+                type: "sleepDisruptionSeverity",
+                baseType: "enum",
+                array: false,
+                scale: 1,
+                offset: 0,
+                units: "",
+                bits: [],
+                    components: [],
+                    isAccumulated: false,
+                    hasComponents: false,
+                    subFields: []
+            },
+        },
+     },
+        471: {
+            num: 471,
+            name: "sleepDisruptionOvernightSeverity",
+            messagesKey: "sleepDisruptionOvernightSeverityMesgs",
+            fields: {
+            253: {
+                num: 253,
+                name: "timestamp",
+                type: "dateTime",
+                baseType: "uint32",
+                array: false,
+                scale: 1,
+                offset: 0,
+                units: "",
+                bits: [],
+                    components: [],
+                    isAccumulated: false,
+                    hasComponents: false,
+                    subFields: []
+            },
+            0: {
+                num: 0,
+                name: "severity",
+                type: "sleepDisruptionSeverity",
+                baseType: "enum",
+                array: false,
+                scale: 1,
+                offset: 0,
+                units: "",
+                bits: [],
+                    components: [],
+                    isAccumulated: false,
+                    hasComponents: false,
+                    subFields: []
+            },
+        },
      },
         398: {
             num: 398,
@@ -23216,6 +23305,8 @@ types: {
        393: "diveApneaAlarm",
        398: "skinTempOvernight",
        409: "hsaWristTemperatureData", // Message number for the HSA wrist temperature data message
+       470: "sleepDisruptionSeverityPeriod",
+       471: "sleepDisruptionOvernightSeverity",
        0xFF00: "mfgRangeMin", // 0xFF00 - 0xFFFE reserved for manufacturer specific messages
        0xFFFE: "mfgRangeMax", // 0xFF00 - 0xFFFE reserved for manufacturer specific messages
        },
@@ -24271,6 +24362,7 @@ types: {
        333: "tektroRacingProducts",
        334: "daradInnovationCorporation",
        335: "cycloptim",
+       337: "runna",
        5759: "actigraphcorp",
        },
    garminProduct: {
@@ -24716,7 +24808,11 @@ types: {
        4586: "instinct3Amoled45mm",
        4587: "instinct3Amoled50mm",
        4588: "descentG2",
+       4603: "venuX1",
+       4606: "hrm200",
+       4625: "vivoactive6",
        4647: "approachS44",
+       4655: "edgeMtb",
        4656: "approachS50",
        4666: "fenixE",
        4759: "instinct3Solar50mm",
@@ -24843,6 +24939,8 @@ types: {
        4: "drill",
        5: "mixed",
        6: "im", // IM is a mixed interval containing the same number of lengths for each of: Butterfly, Backstroke, Breaststroke, Freestyle, swam in that order.
+       7: "imByRound", // For repeated workout steps, a new individual medly stroke is used for each round.
+       8: "rimo", // Reverse IM Order
        },
    activityType: {
        0: "generic",
@@ -27752,6 +27850,12 @@ types: {
        2: "threatApproaching",
        3: "threatApproachingFast",
        },
+   sleepDisruptionSeverity: {
+       0: "none",
+       1: "low",
+       2: "medium",
+       3: "high",
+       },
    maxMetSpeedSource: {
        0: "onboardGps",
        1: "connectedGps",
@@ -27893,6 +27997,8 @@ MesgNum : {
    TANK_UPDATE: 319,
    TANK_SUMMARY: 323,
    SLEEP_ASSESSMENT: 346,
+   SLEEP_DISRUPTION_SEVERITY_PERIOD: 470,
+   SLEEP_DISRUPTION_OVERNIGHT_SEVERITY: 471,
    SKIN_TEMP_OVERNIGHT: 398,
    PAD: 105,
    }

package/src/stream.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 

package/src/utils-hr-mesg.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 

package/src/utils-internal.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 

package/src/utils-memo-glob.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////
 
 import Profile from "./profile.js";

package/src/utils.js

@@ -5,8 +5,8 @@
 // Transfer (FIT) Protocol License.
 /////////////////////////////////////////////////////////////////////////////////////////////
 // ****WARNING****  This file is auto-generated!  Do NOT edit this file.
-// Profile Version = 21.170.0Release
-// Tag = production/release/21.170.0-0-g5991e72
+// Profile Version = 21.178.0Release
+// Tag = production/release/21.178.0-0-g3bea629
 /////////////////////////////////////////////////////////////////////////////////////////////