@ovok/native 0.4.6 → 0.4.8

package/lib/module/modules/bt-management/services/devices/viatom/viatom.ecg-recorders.js

@@ -0,0 +1,108 @@
+"use strict";
+
+import { MeasurementTypeKey } from "@ovok/core";
+import { lepuNameMatch } from "../lepu/lepu.name-match.js";
+import { lepuDevice } from "../lepu/lepu.transports.js";
+
+/**
+ * The Viatom ECG recorders - ER1, ER2 and ER3.
+ *
+ * **What a declaration gets from these is the heart rate, not the waveform.** The ECG itself
+ * arrives as a stream of samples assembled across many notifications and belongs to a device
+ * class; the recorders also report a heart rate in the same realtime frame, at a fixed
+ * offset, and that is a reading a declaration can carry on its own.
+ *
+ * Their stored recordings are a separate matter and are reachable: these devices use the
+ * family's generic file opcodes, so `LepuFileTransfer` downloads their records unchanged.
+ * Turning a downloaded recording into a measurement still needs a device class.
+ *
+ * ## A note on the opcodes
+ *
+ * This range numbers its commands low, in the space where the family's meanings diverge
+ * most, so the poll is chosen deliberately rather than taken from whatever the vendor's SDK
+ * calls first:
+ *
+ * - `RT_PARAM` is `0x02` here and **`CALIBRATION_SLOPE` on a BP2**, a factory command that
+ *   silently biases every subsequent blood-pressure reading. It is never sent, even though
+ *   it would be the cheaper poll - it returns the parameters without the waveform.
+ * - `START_ECG` is `0x08` on a Lepod and `RT_DATA` on a BP2. It is never sent either.
+ *
+ * `RT_DATA` is a read on every one of them, which is why it is the poll here. The advertised
+ * name is what keeps these opcodes pointed at the right hardware, so a matcher for one of
+ * these devices should be narrowed, never widened.
+ */
+
+/** Reads the realtime parameters and waveform. A read on every device in this range. */
+const RT_DATA = 0x03;
+
+/** The ER3 answers its realtime data on a different opcode from the rest of the range. */
+const ER3_RT_DATA = 0x06;
+const HEART_RATE_UNIT = "bpm";
+/** ER1, ER2 and ER3 share one parameter block: the heart rate opens it. */
+const ER_HEART_RATE_BYTES = [7, 8];
+/**
+ * Declares one recorder, reporting the heart rate from its realtime frame.
+ *
+ * A recorder that is not against the skin reports a rate outside what a heart can beat at,
+ * so it is discarded rather than reported. The device marks that condition in bits of a
+ * status byte, which a declaration cannot select on, so a recorder left connected and unworn
+ * reports a decoding failure on each poll. Reading those bits quietly needs a device class.
+ */
+const declareRecorder = (advertisedName, profile, params) => lepuDevice({
+  id: params.id,
+  nameMatch: params.nameMatch ?? lepuNameMatch(advertisedName),
+  transport: profile.transport,
+  pollCommand: profile.pollCommand,
+  minLengthBytes: profile.heartRateBytes[1] + 1,
+  caseSelectorBytes: [1],
+  cases: [{
+    selector: profile.pollCommand.toString(16).padStart(2, "0"),
+    kind: "result",
+    measurementTypeKey: MeasurementTypeKey.heartRate,
+    description: "Realtime parameters and waveform",
+    fields: [{
+      name: "heartRate",
+      byteIndexes: [...profile.heartRateBytes],
+      byteOrder: "little",
+      encoding: "uint",
+      unit: HEART_RATE_UNIT
+    }]
+  }],
+  ...(params.expectedDeviceTypes ? {
+    expectedDeviceTypes: params.expectedDeviceTypes
+  } : {})
+});
+
+/** The ER1, and the handheld recorders sold under other names on the same protocol. */
+const er1Recorder = (advertisedName, params) => declareRecorder(advertisedName, {
+  pollCommand: RT_DATA,
+  heartRateBytes: ER_HEART_RATE_BYTES,
+  transport: "standard"
+}, params);
+
+/**
+ * The ER2, which reads the same block but over a link that grants nothing beyond the
+ * minimum. Asking it for the MTU the rest of the family grants is what the vendor's own SDK
+ * declines to do, and a command longer than the link carries is truncated rather than
+ * refused.
+ */
+const er2Recorder = (advertisedName, params) => declareRecorder(advertisedName, {
+  pollCommand: RT_DATA,
+  heartRateBytes: ER_HEART_RATE_BYTES,
+  transport: "standardSmallMtu"
+}, params);
+
+/** The ER3, which reads the same parameter block from a different opcode. */
+const er3Recorder = (advertisedName, params) => declareRecorder(advertisedName, {
+  pollCommand: ER3_RT_DATA,
+  heartRateBytes: ER_HEART_RATE_BYTES,
+  transport: "standard"
+}, params);
+
+/** The names the ER1 recorders advertise. */
+const ER1_MODEL_NAMES = ["ER1", "ER1-H", "ER1-L", "ER1-S", "ER1-SP", "ER1-W", "ER1S", "HHM1"];
+
+/** The names the ER2 recorders advertise, all of them on the small-MTU link. */
+const ER2_MODEL_NAMES = ["ER2", "ER2-S", "HHM2", "HHM3", "LP ER2"];
+export { er1Recorder, ER1_MODEL_NAMES, er2Recorder, ER2_MODEL_NAMES, er3Recorder };
+//# sourceMappingURL=viatom.ecg-recorders.js.map

package/lib/module/modules/bt-management/services/devices/viatom/viatom.ecg-recorders.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MeasurementTypeKey","lepuNameMatch","lepuDevice","RT_DATA","ER3_RT_DATA","HEART_RATE_UNIT","ER_HEART_RATE_BYTES","declareRecorder","advertisedName","profile","params","id","nameMatch","transport","pollCommand","minLengthBytes","heartRateBytes","caseSelectorBytes","cases","selector","toString","padStart","kind","measurementTypeKey","heartRate","description","fields","name","byteIndexes","byteOrder","encoding","unit","expectedDeviceTypes","er1Recorder","er2Recorder","er3Recorder","ER1_MODEL_NAMES","ER2_MODEL_NAMES"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/viatom/viatom.ecg-recorders.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/viatom/viatom.lepod.js

@@ -0,0 +1,114 @@
+"use strict";
+
+import { MeasurementTypeKey } from "@ovok/core";
+import { lepuNameMatch } from "../lepu/lepu.name-match.js";
+import { lepuDevice } from "../lepu/lepu.transports.js";
+
+/**
+ * The Lepod, a multi-parameter patient monitor.
+ *
+ * One realtime frame carries a heart rate, an oxygen saturation with its pulse rate, a
+ * respiration rate and a body temperature. They are four measurements taken by four
+ * instruments that happen to share a frame, so they are declared and reported separately: a
+ * temperature probe that is not attached is no reason to withhold the heart rate beside it.
+ *
+ * The ECG waveform in the same frame is not declared. It is a sample stream assembled across
+ * notifications and needs a device class; the recordings the device stores are reachable
+ * through the family's generic file opcodes.
+ */
+
+/**
+ * Reads the realtime frame. A read - unlike `START_ECG`, which is `0x08` here and `RT_DATA`
+ * on a BP2, and `RT_PARAM`, which is `0x02` here and `CALIBRATION_SLOPE` on a BP2.
+ */
+const RT_DATA = 0x03;
+
+/** Header plus the parameter block through the temperature, which ends it. */
+const MIN_LENGTH_BYTES = 46;
+
+/** Frame offsets: the vendor's parameter block starts at the seven-byte header. */
+const HEART_RATE = [31, 32];
+const RESPIRATION_RATE = 34;
+const BLOOD_OXYGEN = 36;
+const PULSE_RATE = [37, 38];
+const PERFUSION_INDEX = 39;
+const TEMPERATURE = [44, 45];
+
+/** The device counts perfusion in tenths of a percent and temperature in hundredths. */
+const PERFUSION_SCALE = 0.1;
+const TEMPERATURE_SCALE = 0.01;
+const littleEndian = (name, byteIndexes, unit) => ({
+  name,
+  byteIndexes,
+  byteOrder: "little",
+  encoding: "uint",
+  unit
+});
+const LEPOD_MEASUREMENTS = [{
+  measurementTypeKey: MeasurementTypeKey.bloodOxygenPulseRate,
+  fields: [{
+    name: "bloodOxygen",
+    byteIndexes: [BLOOD_OXYGEN],
+    encoding: "uint",
+    unit: "%"
+  }, littleEndian("pulseRate", PULSE_RATE, "bpm"), {
+    name: "perfusionIndex",
+    byteIndexes: [PERFUSION_INDEX],
+    encoding: "uint",
+    unit: "%",
+    scale: PERFUSION_SCALE,
+    decimals: 1
+  }]
+}, {
+  measurementTypeKey: MeasurementTypeKey.respiratoryRate,
+  fields: [{
+    name: "respiratoryRate",
+    byteIndexes: [RESPIRATION_RATE],
+    encoding: "uint",
+    unit: "/min"
+  }]
+}, {
+  measurementTypeKey: MeasurementTypeKey.temperature,
+  fields: [{
+    name: "bodyTemp",
+    byteIndexes: TEMPERATURE,
+    byteOrder: "little",
+    encoding: "uint",
+    unit: "Cel",
+    scale: TEMPERATURE_SCALE,
+    decimals: 2
+  }]
+}];
+/**
+ * Declares a Lepod, reporting every reading its realtime frame carries.
+ *
+ * An instrument that is not attached reports a value outside the physiological range for
+ * what it measures, so that reading is discarded and reported while the others in the same
+ * frame are still delivered. The device also marks those conditions in bits of a lead-off
+ * byte, which a declaration cannot select on - reading them quietly needs a device class.
+ */
+const lepodMonitor = (advertisedName, params) => lepuDevice({
+  id: params.id,
+  nameMatch: params.nameMatch ?? lepuNameMatch(advertisedName),
+  pollCommand: RT_DATA,
+  minLengthBytes: MIN_LENGTH_BYTES,
+  caseSelectorBytes: [1],
+  cases: [{
+    selector: "03",
+    kind: "result",
+    measurementTypeKey: MeasurementTypeKey.heartRate,
+    description: "Realtime parameters, waveform and lead state",
+    fields: [littleEndian("heartRate", HEART_RATE, "bpm")],
+    additionalMeasurements: LEPOD_MEASUREMENTS.map(each => ({
+      ...each
+    }))
+  }],
+  ...(params.expectedDeviceTypes ? {
+    expectedDeviceTypes: params.expectedDeviceTypes
+  } : {})
+});
+
+/** The names the Lepod range advertises. */
+const LEPOD_MODEL_NAMES = ["Lepod", "LepodPro"];
+export { LEPOD_MODEL_NAMES, lepodMonitor };
+//# sourceMappingURL=viatom.lepod.js.map

package/lib/module/modules/bt-management/services/devices/viatom/viatom.lepod.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MeasurementTypeKey","lepuNameMatch","lepuDevice","RT_DATA","MIN_LENGTH_BYTES","HEART_RATE","RESPIRATION_RATE","BLOOD_OXYGEN","PULSE_RATE","PERFUSION_INDEX","TEMPERATURE","PERFUSION_SCALE","TEMPERATURE_SCALE","littleEndian","name","byteIndexes","unit","byteOrder","encoding","LEPOD_MEASUREMENTS","measurementTypeKey","bloodOxygenPulseRate","fields","scale","decimals","respiratoryRate","temperature","lepodMonitor","advertisedName","params","id","nameMatch","pollCommand","minLengthBytes","caseSelectorBytes","cases","selector","kind","heartRate","description","additionalMeasurements","map","each","expectedDeviceTypes","LEPOD_MODEL_NAMES"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/viatom/viatom.lepod.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/viatom/viatom.oximeters.js

@@ -0,0 +1,79 @@
+"use strict";
+
+import { MeasurementTypeKey } from "@ovok/core";
+import { lepuNameMatch } from "../lepu/lepu.name-match.js";
+import { lepuDevice } from "../lepu/lepu.transports.js";
+
+/**
+ * The Viatom pulse oximeters - the O2Ring, Oxyfit, KidsO2 and BabyO2 ranges.
+ *
+ * They share the family's framing and characteristics but not its opcodes: this range
+ * numbers its own commands, so realtime parameters are `0x17` here rather than the `0x08`
+ * the blood-pressure monitors answer, and its stored files are read with `0x03`-`0x05`
+ * rather than the generic `0xF1`-`0xF4`. A file transfer written for the rest of the family
+ * does not apply to these.
+ */
+
+/** Realtime parameters. A read: it reports what the sensor sees and starts nothing. */
+const RT_PARAM = 0x17;
+
+/** Only the command byte, because what makes a reading valid here is a bit, not a byte. */
+const CASE_SELECTOR_BYTES = [1];
+
+/** Header plus the realtime parameters through the pulse rate. */
+const MIN_LENGTH_BYTES = 10;
+const PAYLOAD = 7;
+const SPOT_CHECK_TIMEOUT_MS = 60_000;
+/**
+ * Declares one oximeter of the range.
+ *
+ * **A finger that is not in the sensor yields no reading, reported as an error.** The device
+ * answers every poll whether or not it is measuring, and marks an unusable reading in two
+ * bits of a status byte - which a declaration cannot read, because a case is selected by
+ * whole bytes. What it can do is refuse the number: an oxygen saturation measured off the
+ * finger falls outside the physiological range, so it is discarded rather than reported.
+ * The reading is therefore never wrong, but a device left connected with nobody wearing it
+ * reports a decoding failure on each poll. Reading those bits quietly needs a device class.
+ */
+const viatomOximeter = (advertisedName, params) => lepuDevice({
+  id: params.id,
+  nameMatch: params.nameMatch ?? lepuNameMatch(advertisedName),
+  stuckDataTimeoutMs: SPOT_CHECK_TIMEOUT_MS,
+  pollCommand: RT_PARAM,
+  minLengthBytes: MIN_LENGTH_BYTES,
+  caseSelectorBytes: CASE_SELECTOR_BYTES,
+  cases: [{
+    selector: "17",
+    kind: "result",
+    measurementTypeKey: MeasurementTypeKey.bloodOxygenPulseRate,
+    description: "Realtime parameters",
+    fields: [{
+      name: "bloodOxygen",
+      byteIndexes: [PAYLOAD],
+      encoding: "uint",
+      unit: "%"
+    }, {
+      name: "pulseRate",
+      byteIndexes: [PAYLOAD + 1, PAYLOAD + 2],
+      byteOrder: "little",
+      encoding: "uint",
+      unit: "bpm"
+    }]
+  }],
+  ...(params.expectedDeviceTypes ? {
+    expectedDeviceTypes: params.expectedDeviceTypes
+  } : {})
+});
+
+/**
+ * The names the oximeter range advertises.
+ *
+ * ```typescript
+ * const oximeters = VIATOM_OXIMETER_NAMES.map((name) =>
+ *   viatomOximeter(name, { id: `viatom-${name.toLowerCase()}` }),
+ * );
+ * ```
+ */
+const VIATOM_OXIMETER_NAMES = ["BBSM S1", "BBSM S2", "CMRing", "KidsO2-WPS", "O2 Intg", "O2M-WPS", "O2R WAVE", "O2RMed S", "O2Ring", "O2Ring S", "O2Ring SC", "O2Ring SF", "O2Ring SP", "O2Ring-RE", "O2RingF", "Oxyfit", "Oxyfit-WPS", "OxyU", "OxyU SE", "SI PO2"];
+export { VIATOM_OXIMETER_NAMES, viatomOximeter };
+//# sourceMappingURL=viatom.oximeters.js.map

package/lib/module/modules/bt-management/services/devices/viatom/viatom.oximeters.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MeasurementTypeKey","lepuNameMatch","lepuDevice","RT_PARAM","CASE_SELECTOR_BYTES","MIN_LENGTH_BYTES","PAYLOAD","SPOT_CHECK_TIMEOUT_MS","viatomOximeter","advertisedName","params","id","nameMatch","stuckDataTimeoutMs","pollCommand","minLengthBytes","caseSelectorBytes","cases","selector","kind","measurementTypeKey","bloodOxygenPulseRate","description","fields","name","byteIndexes","encoding","unit","byteOrder","expectedDeviceTypes","VIATOM_OXIMETER_NAMES"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/viatom/viatom.oximeters.ts"],"mappings":";;AAAA,SAASA,kBAAkB,QAAQ,YAAY;AAG/C,SAASC,aAAa,QAAQ,4BAAyB;AACvD,SAASC,UAAU,QAAQ,4BAAyB;;AAEpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA,MAAMC,QAAQ,GAAG,IAAI;;AAErB;AACA,MAAMC,mBAAmB,GAAG,CAAC,CAAC,CAAC;;AAE/B;AACA,MAAMC,gBAAgB,GAAG,EAAE;AAE3B,MAAMC,OAAO,GAAG,CAAC;AAEjB,MAAMC,qBAAqB,GAAG,MAAM;AAoBpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,cAAc,GAAGA,CACrBC,cAAsB,EACtBC,MAA4B,KAE5BR,UAAU,CAAC;EACTS,EAAE,EAAED,MAAM,CAACC,EAAE;EACbC,SAAS,EAAEF,MAAM,CAACE,SAAS,IAAIX,aAAa,CAACQ,cAAc,CAAC;EAC5DI,kBAAkB,EAAEN,qBAAqB;EACzCO,WAAW,EAAEX,QAAQ;EACrBY,cAAc,EAAEV,gBAAgB;EAChCW,iBAAiB,EAAEZ,mBAAmB;EACtCa,KAAK,EAAE,CACL;IACEC,QAAQ,EAAE,IAAI;IACdC,IAAI,EAAE,QAAQ;IACdC,kBAAkB,EAAEpB,kBAAkB,CAACqB,oBAAoB;IAC3DC,WAAW,EAAE,qBAAqB;IAClCC,MAAM,EAAE,CACN;MACEC,IAAI,EAAE,aAAa;MACnBC,WAAW,EAAE,CAACnB,OAAO,CAAC;MACtBoB,QAAQ,EAAE,MAAM;MAChBC,IAAI,EAAE;IACR,CAAC,EACD;MACEH,IAAI,EAAE,WAAW;MACjBC,WAAW,EAAE,CAACnB,OAAO,GAAG,CAAC,EAAEA,OAAO,GAAG,CAAC,CAAC;MACvCsB,SAAS,EAAE,QAAQ;MACnBF,QAAQ,EAAE,MAAM;MAChBC,IAAI,EAAE;IACR,CAAC;EAEL,CAAC,CACF;EACD,IAAIjB,MAAM,CAACmB,mBAAmB,GAC1B;IAAEA,mBAAmB,EAAEnB,MAAM,CAACmB;EAAoB,CAAC,GACnD,CAAC,CAAC;AACR,CAAC,CAAC;;AAEJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,qBAAwC,GAAG,CAC/C,SAAS,EACT,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EACV,WAAW,EACX,WAAW,EACX,WAAW,EACX,WAAW,EACX,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,MAAM,EACN,SAAS,EACT,QAAQ,CACT;AAED,SAASA,qBAAqB,EAAEtB,cAAc","ignoreList":[]}

package/lib/module/modules/bt-management/types/command-sequencer.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=command-sequencer.js.map

package/lib/module/modules/bt-management/types/command-sequencer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/command-sequencer.ts"],"mappings":"","ignoreList":[]}

package/lib/module/modules/bt-management/types/custom-checksum-algorithm.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=custom-checksum-algorithm.js.map

package/lib/module/modules/bt-management/types/custom-checksum-algorithm.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/custom-checksum-algorithm.ts"],"mappings":"","ignoreList":[]}

package/lib/module/modules/bt-management/types/custom-checksum-spec.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=custom-checksum-spec.js.map

package/lib/module/modules/bt-management/types/custom-checksum-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/custom-checksum-spec.ts"],"mappings":"","ignoreList":[]}

package/lib/module/modules/bt-management/types/custom-device-definition.js.map

@@ -1 +1 @@
-{"version":3,"names":["CUSTOM_DEVICE_BRAND"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/custom-device-definition.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAAQ,qCAAkC;;AAQtE;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["CUSTOM_DEVICE_BRAND"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/custom-device-definition.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAAQ,qCAAkC;;AAStE;AACA;AACA","ignoreList":[]}

package/lib/module/modules/bt-management/types/custom-lepu-spec.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=custom-lepu-spec.js.map

package/lib/module/modules/bt-management/types/custom-lepu-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/custom-lepu-spec.ts"],"mappings":"","ignoreList":[]}

package/lib/module/modules/bt-management/types/custom-measurement-spec.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=custom-measurement-spec.js.map

package/lib/module/modules/bt-management/types/custom-measurement-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/custom-measurement-spec.ts"],"mappings":"","ignoreList":[]}

package/lib/module/modules/bt-management/types/device-command.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=device-command.js.map

package/lib/module/modules/bt-management/types/device-command.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/device-command.ts"],"mappings":"","ignoreList":[]}

package/lib/module/modules/bt-management/types/device-measurement-map.js

@@ -2,8 +2,8 @@
 
 import { IntegratedDevices } from "./integrated-devices.js";
 
-/**
- * A built-in device has a measurement type the SDK knows statically. A device registered
- * through defineCustomDevice reports the catalog-checked properties its declaration named.
+/**
+ * A built-in device has a measurement type the SDK knows statically. A device registered
+ * through defineCustomDevice reports the catalog-checked properties its declaration named.
  */
 //# sourceMappingURL=device-measurement-map.js.map

package/lib/module/modules/bt-management/types/device-measurement-map.js.map

@@ -1 +1 @@
-{"version":3,"names":["IntegratedDevices"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/device-measurement-map.ts"],"mappings":";;AAWA,SAASA,iBAAiB,QAAQ,yBAAsB;;AAwBxD;AACA;AACA;AACA","ignoreList":[]}
+{"version":3,"names":["IntegratedDevices"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/device-measurement-map.ts"],"mappings":";;AAWA,SAASA,iBAAiB,QAAQ,yBAAsB;;AA0BxD;AACA;AACA;AACA","ignoreList":[]}

package/lib/module/modules/bt-management/types/integrated-devices.js

@@ -20,6 +20,8 @@ export let IntegratedDevices = /*#__PURE__*/function (IntegratedDevices) {
   IntegratedDevices["S5"] = "Le S5";
   IntegratedDevices["ALIVE_COR"] = "alivecor";
   IntegratedDevices["BGM"] = "BGM";
+  IntegratedDevices["VEROVAL_DUO_CONTROL"] = "Veroval duo control";
+  IntegratedDevices["VEROVAL_ECG"] = "Veroval ECG";
   return IntegratedDevices;
 }({});
 //# sourceMappingURL=integrated-devices.js.map

package/lib/module/modules/bt-management/types/integrated-devices.js.map

@@ -1 +1 @@
-{"version":3,"names":["IntegratedDevices"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/integrated-devices.ts"],"mappings":";;AAAA,WAAYA,iBAAiB,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA","ignoreList":[]}
+{"version":3,"names":["IntegratedDevices"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/integrated-devices.ts"],"mappings":";;AAAA,WAAYA,iBAAiB,0BAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAjBA,iBAAiB;EAAA,OAAjBA,iBAAiB;AAAA","ignoreList":[]}

package/lib/module/modules/bt-management/types/measurement-group.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=measurement-group.js.map

package/lib/module/modules/bt-management/types/measurement-group.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["modules/bt-management/types/measurement-group.ts"],"mappings":"","ignoreList":[]}

package/lib/module/modules/bt-management/utils/calculate-checksum.js

@@ -0,0 +1,44 @@
+"use strict";
+
+import { calculateCrc8 } from "./calculate-crc-8.js";
+import { hexToByte } from "./hex-to-byte.js";
+const BYTE_MASK = 0xff;
+const foldBytes = (covered, combine) => covered.reduce((total, byte) => combine(total, hexToByte(byte || "0")) & BYTE_MASK, 0);
+
+/**
+ * One implementation per algorithm, looked up by name.
+ *
+ * A map rather than a switch, so adding an algorithm is adding an entry, and so a
+ * declaration naming one that does not exist is rejected at registration instead of falling
+ * through to a default that would accept every frame.
+ */
+const ALGORITHMS = {
+  crc8: covered => calculateCrc8(covered, covered.length),
+  xor: covered => foldBytes(covered, (total, byte) => total ^ byte),
+  sum: covered => foldBytes(covered, (total, byte) => total + byte)
+};
+const isChecksumAlgorithm = candidate => typeof candidate === "string" && candidate in ALGORITHMS;
+
+/** The bytes a checksum covers, defaulting to everything between `from` and the checksum. */
+const coveredBytes = (pkg, checksum) => {
+  const from = checksum.from ?? 0;
+  const byteCount = checksum.byteCount ?? checksum.index - from;
+  return pkg.slice(from, from + byteCount);
+};
+
+/**
+ * Whether a buffer's checksum byte matches the bytes it covers.
+ *
+ * A buffer too short to hold the checksum byte fails rather than reading it as zero: an
+ * absent byte is not a matching byte, and treating it as one would let a truncated
+ * notification through as a valid reading.
+ */
+const hasValidChecksum = (pkg, checksum) => {
+  const declared = pkg[checksum.index];
+  if (declared === undefined) {
+    return false;
+  }
+  return ALGORITHMS[checksum.algorithm](coveredBytes(pkg, checksum)) === hexToByte(declared);
+};
+export { hasValidChecksum, isChecksumAlgorithm };
+//# sourceMappingURL=calculate-checksum.js.map

package/lib/module/modules/bt-management/utils/calculate-checksum.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["calculateCrc8","hexToByte","BYTE_MASK","foldBytes","covered","combine","reduce","total","byte","ALGORITHMS","crc8","length","xor","sum","isChecksumAlgorithm","candidate","coveredBytes","pkg","checksum","from","byteCount","index","slice","hasValidChecksum","declared","undefined","algorithm"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/utils/calculate-checksum.ts"],"mappings":";;AAGA,SAASA,aAAa,QAAQ,sBAAmB;AACjD,SAASC,SAAS,QAAQ,kBAAe;AAEzC,MAAMC,SAAS,GAAG,IAAI;AAEtB,MAAMC,SAAS,GAAGA,CAChBC,OAAiB,EACjBC,OAAgD,KAEhDD,OAAO,CAACE,MAAM,CACZ,CAACC,KAAK,EAAEC,IAAI,KAAKH,OAAO,CAACE,KAAK,EAAEN,SAAS,CAACO,IAAI,IAAI,GAAG,CAAC,CAAC,GAAGN,SAAS,EACnE,CACF,CAAC;;AAEH;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMO,UAGL,GAAG;EACFC,IAAI,EAAGN,OAAO,IAAKJ,aAAa,CAACI,OAAO,EAAEA,OAAO,CAACO,MAAM,CAAC;EACzDC,GAAG,EAAGR,OAAO,IAAKD,SAAS,CAACC,OAAO,EAAE,CAACG,KAAK,EAAEC,IAAI,KAAKD,KAAK,GAAGC,IAAI,CAAC;EACnEK,GAAG,EAAGT,OAAO,IAAKD,SAAS,CAACC,OAAO,EAAE,CAACG,KAAK,EAAEC,IAAI,KAAKD,KAAK,GAAGC,IAAI;AACpE,CAAC;AAED,MAAMM,mBAAmB,GACvBC,SAAkB,IAElB,OAAOA,SAAS,KAAK,QAAQ,IAAIA,SAAS,IAAIN,UAAU;;AAE1D;AACA,MAAMO,YAAY,GAAGA,CAACC,GAAa,EAAEC,QAA4B,KAAe;EAC9E,MAAMC,IAAI,GAAGD,QAAQ,CAACC,IAAI,IAAI,CAAC;EAC/B,MAAMC,SAAS,GAAGF,QAAQ,CAACE,SAAS,IAAIF,QAAQ,CAACG,KAAK,GAAGF,IAAI;EAE7D,OAAOF,GAAG,CAACK,KAAK,CAACH,IAAI,EAAEA,IAAI,GAAGC,SAAS,CAAC;AAC1C,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMG,gBAAgB,GAAGA,CACvBN,GAAa,EACbC,QAA4B,KAChB;EACZ,MAAMM,QAAQ,GAAGP,GAAG,CAACC,QAAQ,CAACG,KAAK,CAAC;EAEpC,IAAIG,QAAQ,KAAKC,SAAS,EAAE;IAC1B,OAAO,KAAK;EACd;EAEA,OACEhB,UAAU,CAACS,QAAQ,CAACQ,SAAS,CAAC,CAACV,YAAY,CAACC,GAAG,EAAEC,QAAQ,CAAC,CAAC,KAC3DjB,SAAS,CAACuB,QAAQ,CAAC;AAEvB,CAAC;AAED,SAASD,gBAAgB,EAAET,mBAAmB","ignoreList":[]}

package/lib/module/modules/bt-management/utils/create-custom-field-parser.js

@@ -2,7 +2,28 @@
 
 import { decodeMedicalFloat } from "./decode-medical-float.js";
 const HEX_ONLY = /^[0-9a-f]+$/;
+const ASCII_ZERO = 0x30;
+const ASCII_NINE = 0x39;
+const HEX_BYTE = /../g;
+
+/**
+ * Reads bytes that are decimal digits written as characters, not a number.
+ *
+ * A byte outside "0"-"9" makes the whole field undefined rather than being skipped: these
+ * records are fixed width and a non-digit means the field was not what the declaration
+ * says it is, so decoding the rest of it would report a number built from part of a value.
+ */
+const fromAsciiDigits = hex => {
+  const codes = (hex.match(HEX_BYTE) ?? []).map(byte => parseInt(byte, 16));
+  if (codes.length === 0 || codes.some(code => code < ASCII_ZERO || code > ASCII_NINE)) {
+    return undefined;
+  }
+  return Number(codes.map(code => code - ASCII_ZERO).join(""));
+};
 const toRaw = (hex, field) => {
+  if (field.encoding === "ascii") {
+    return fromAsciiDigits(hex);
+  }
   const raw = parseInt(hex, 16);
   const bits = hex.length * 4;
   if (field.encoding === "int") {

package/lib/module/modules/bt-management/utils/create-custom-field-parser.js.map

@@ -1 +1 @@
-{"version":3,"names":["decodeMedicalFloat","HEX_ONLY","toRaw","hex","field","raw","parseInt","bits","length","encoding","sign","createCustomFieldParser","assembledHex","toLowerCase","byteIndexes","test","undefined","Number","isFinite","value","scale","offset","decimals","factor","Math","round"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/utils/create-custom-field-parser.ts"],"mappings":";;AAEA,SAASA,kBAAkB,QAAQ,2BAAwB;AAE3D,MAAMC,QAAQ,GAAG,aAAa;AAE9B,MAAMC,KAAK,GAAGA,CACZC,GAAW,EACXC,KAA0B,KACH;EACvB,MAAMC,GAAG,GAAGC,QAAQ,CAACH,GAAG,EAAE,EAAE,CAAC;EAC7B,MAAMI,IAAI,GAAGJ,GAAG,CAACK,MAAM,GAAG,CAAC;EAE3B,IAAIJ,KAAK,CAACK,QAAQ,KAAK,KAAK,EAAE;IAC5B,MAAMC,IAAI,GAAG,CAAC,KAAKH,IAAI,GAAG,CAAC,CAAC;IAE5B,OAAOF,GAAG,IAAIK,IAAI,GAAGL,GAAG,GAAGK,IAAI,GAAG,CAAC,GAAGL,GAAG;EAC3C;EAEA,IAAID,KAAK,CAACK,QAAQ,KAAK,QAAQ,EAAE;IAC/B,OAAOT,kBAAkB,CAACK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;EACvC;EAEA,IAAID,KAAK,CAACK,QAAQ,KAAK,OAAO,EAAE;IAC9B,OAAOT,kBAAkB,CAACK,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;EACvC;EAEA,OAAOA,GAAG;AACZ,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMM,uBAAuB,GACjCP,KAA0B,IAC1BQ,YAAoB,IAAyB;EAC5C,MAAMT,GAAG,GAAG,CAACS,YAAY,IAAI,EAAE,EAAEC,WAAW,CAAC,CAAC;EAE9C,IACEV,GAAG,CAACK,MAAM,KAAKJ,KAAK,CAACU,WAAW,CAACN,MAAM,GAAG,CAAC,IAC3C,CAACP,QAAQ,CAACc,IAAI,CAACZ,GAAG,CAAC,EACnB;IACA,OAAOa,SAAS;EAClB;EAEA,MAAMX,GAAG,GAAGH,KAAK,CAACC,GAAG,EAAEC,KAAK,CAAC;EAE7B,IAAIC,GAAG,KAAKW,SAAS,IAAI,CAACC,MAAM,CAACC,QAAQ,CAACb,GAAG,CAAC,EAAE;IAC9C,OAAOW,SAAS;EAClB;EAEA,MAAMG,KAAK,GAAGd,GAAG,GAAGD,KAAK,CAACgB,KAAK,GAAGhB,KAAK,CAACiB,MAAM;EAE9C,IAAI,CAACJ,MAAM,CAACC,QAAQ,CAACC,KAAK,CAAC,EAAE;IAC3B,OAAOH,SAAS;EAClB;EAEA,IAAIZ,KAAK,CAACkB,QAAQ,KAAKN,SAAS,EAAE;IAChC,OAAOG,KAAK;EACd;EAEA,MAAMI,MAAM,GAAG,EAAE,IAAInB,KAAK,CAACkB,QAAQ;EAEnC,OAAOE,IAAI,CAACC,KAAK,CAACN,KAAK,GAAGI,MAAM,CAAC,GAAGA,MAAM;AAC5C,CAAC","ignoreList":[]}
+{"version":3,"names":["decodeMedicalFloat","HEX_ONLY","ASCII_ZERO","ASCII_NINE","HEX_BYTE","fromAsciiDigits","hex","codes","match","map","byte","parseInt","length","some","code","undefined","Number","join","toRaw","field","encoding","raw","bits","sign","createCustomFieldParser","assembledHex","toLowerCase","byteIndexes","test","isFinite","value","scale","offset","decimals","factor","Math","round"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/utils/create-custom-field-parser.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/utils/create-frame-validator.js

@@ -1,5 +1,6 @@
 "use strict";
 
+import { hasValidChecksum } from "./calculate-checksum.js";
 const byteAt = (pkg, index) => parseInt(pkg[index] ?? "0", 16);
 const announcedLength = (pkg, length) => {
   const bytes = [];
@@ -27,6 +28,14 @@ export const createFrameValidator = frame => pkg => {
       return false;
     }
   }
+
+  /**
+   * Checked before the length, because a corrupted buffer can carry a plausible length.
+   * A frame that fails here is discarded rather than decoded at a wrong value.
+   */
+  if (frame.checksum && !hasValidChecksum(pkg, frame.checksum)) {
+    return false;
+  }
   if (!frame.length) {
     return true;
   }

package/lib/module/modules/bt-management/utils/create-frame-validator.js.map

@@ -1 +1 @@
-{"version":3,"names":["byteAt","pkg","index","parseInt","announcedLength","length","bytes","i","widthBytes","push","ordered","byteOrder","reverse","reduce","total","byte","createFrameValidator","frame","minLengthBytes","header","toLowerCase","overheadBytes"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/utils/create-frame-validator.ts"],"mappings":";;AAEA,MAAMA,MAAM,GAAGA,CAACC,GAAa,EAAEC,KAAa,KAC1CC,QAAQ,CAACF,GAAG,CAACC,KAAK,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;AAEjC,MAAME,eAAe,GAAGA,CACtBH,GAAa,EACbI,MAA8C,KACnC;EACX,MAAMC,KAAe,GAAG,EAAE;EAE1B,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGF,MAAM,CAACG,UAAU,EAAED,CAAC,EAAE,EAAE;IAC1CD,KAAK,CAACG,IAAI,CAACT,MAAM,CAACC,GAAG,EAAEI,MAAM,CAACH,KAAK,GAAGK,CAAC,CAAC,CAAC;EAC3C;EAEA,MAAMG,OAAO,GAAGL,MAAM,CAACM,SAAS,KAAK,QAAQ,GAAGL,KAAK,CAACM,OAAO,CAAC,CAAC,GAAGN,KAAK;EAEvE,OAAOI,OAAO,CAACG,MAAM,CAAC,CAACC,KAAK,EAAEC,IAAI,KAAKD,KAAK,GAAG,GAAG,GAAGC,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,GAC9BC,KAAsB,IACtBhB,GAAa,IAAc;EAC1B,IAAIA,GAAG,CAACI,MAAM,GAAGY,KAAK,CAACC,cAAc,EAAE;IACrC,OAAO,KAAK;EACd;EAEA,MAAMC,MAAM,GAAGF,KAAK,CAACE,MAAM,IAAI,EAAE;EAEjC,KAAK,IAAIZ,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGY,MAAM,CAACd,MAAM,EAAEE,CAAC,EAAE,EAAE;IACtC,IAAI,CAACN,GAAG,CAACM,CAAC,CAAC,IAAI,EAAE,EAAEa,WAAW,CAAC,CAAC,KAAKD,MAAM,CAACZ,CAAC,CAAC,EAAE;MAC9C,OAAO,KAAK;IACd;EACF;EAEA,IAAI,CAACU,KAAK,CAACZ,MAAM,EAAE;IACjB,OAAO,IAAI;EACb;EAEA,OACEJ,GAAG,CAACI,MAAM,IACVY,KAAK,CAACZ,MAAM,CAACgB,aAAa,GAAGjB,eAAe,CAACH,GAAG,EAAEgB,KAAK,CAACZ,MAAM,CAAC;AAEnE,CAAC","ignoreList":[]}
+{"version":3,"names":["hasValidChecksum","byteAt","pkg","index","parseInt","announcedLength","length","bytes","i","widthBytes","push","ordered","byteOrder","reverse","reduce","total","byte","createFrameValidator","frame","minLengthBytes","header","toLowerCase","checksum","overheadBytes"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/utils/create-frame-validator.ts"],"mappings":";;AAEA,SAASA,gBAAgB,QAAQ,yBAAsB;AAEvD,MAAMC,MAAM,GAAGA,CAACC,GAAa,EAAEC,KAAa,KAC1CC,QAAQ,CAACF,GAAG,CAACC,KAAK,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC;AAEjC,MAAME,eAAe,GAAGA,CACtBH,GAAa,EACbI,MAA8C,KACnC;EACX,MAAMC,KAAe,GAAG,EAAE;EAE1B,KAAK,IAAIC,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGF,MAAM,CAACG,UAAU,EAAED,CAAC,EAAE,EAAE;IAC1CD,KAAK,CAACG,IAAI,CAACT,MAAM,CAACC,GAAG,EAAEI,MAAM,CAACH,KAAK,GAAGK,CAAC,CAAC,CAAC;EAC3C;EAEA,MAAMG,OAAO,GAAGL,MAAM,CAACM,SAAS,KAAK,QAAQ,GAAGL,KAAK,CAACM,OAAO,CAAC,CAAC,GAAGN,KAAK;EAEvE,OAAOI,OAAO,CAACG,MAAM,CAAC,CAACC,KAAK,EAAEC,IAAI,KAAKD,KAAK,GAAG,GAAG,GAAGC,IAAI,EAAE,CAAC,CAAC;AAC/D,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAoB,GAC9BC,KAAsB,IACtBhB,GAAa,IAAc;EAC1B,IAAIA,GAAG,CAACI,MAAM,GAAGY,KAAK,CAACC,cAAc,EAAE;IACrC,OAAO,KAAK;EACd;EAEA,MAAMC,MAAM,GAAGF,KAAK,CAACE,MAAM,IAAI,EAAE;EAEjC,KAAK,IAAIZ,CAAC,GAAG,CAAC,EAAEA,CAAC,GAAGY,MAAM,CAACd,MAAM,EAAEE,CAAC,EAAE,EAAE;IACtC,IAAI,CAACN,GAAG,CAACM,CAAC,CAAC,IAAI,EAAE,EAAEa,WAAW,CAAC,CAAC,KAAKD,MAAM,CAACZ,CAAC,CAAC,EAAE;MAC9C,OAAO,KAAK;IACd;EACF;;EAEA;AACJ;AACA;AACA;EACI,IAAIU,KAAK,CAACI,QAAQ,IAAI,CAACtB,gBAAgB,CAACE,GAAG,EAAEgB,KAAK,CAACI,QAAQ,CAAC,EAAE;IAC5D,OAAO,KAAK;EACd;EAEA,IAAI,CAACJ,KAAK,CAACZ,MAAM,EAAE;IACjB,OAAO,IAAI;EACb;EAEA,OACEJ,GAAG,CAACI,MAAM,IACVY,KAAK,CAACZ,MAAM,CAACiB,aAAa,GAAGlB,eAAe,CAACH,GAAG,EAAEgB,KAAK,CAACZ,MAAM,CAAC;AAEnE,CAAC","ignoreList":[]}

package/lib/module/modules/bt-management/utils/hex-to-bytes.js

@@ -0,0 +1,14 @@
+"use strict";
+
+const HEX_BYTE = /[0-9a-f]{2}/g;
+
+/**
+ * Splits a hex string into the bytes it spells: "a508f7" -> ["a5","08","f7"].
+ *
+ * Anything that is not a pair of hex digits is dropped, so a malformed string yields a
+ * shorter command rather than a byte that is half a value. Both callers hand it hex that
+ * was already validated - a declaration checks it at registration, and a built frame is
+ * assembled a byte at a time - so the dropping is a floor, not a path anything relies on.
+ */
+export const hexToBytes = hex => hex.toLowerCase().match(HEX_BYTE) ?? [];
+//# sourceMappingURL=hex-to-bytes.js.map

package/lib/module/modules/bt-management/utils/hex-to-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["HEX_BYTE","hexToBytes","hex","toLowerCase","match"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/utils/hex-to-bytes.ts"],"mappings":";;AAAA,MAAMA,QAAQ,GAAG,cAAc;;AAE/B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,UAAU,GAAIC,GAAW,IACpCA,GAAG,CAACC,WAAW,CAAC,CAAC,CAACC,KAAK,CAACJ,QAAQ,CAAC,IAAI,EAAE","ignoreList":[]}

package/lib/module/modules/bt-management/utils/le-32-to-bytes.js

@@ -0,0 +1,8 @@
+"use strict";
+
+const BYTE_MASK = 0xff;
+const BYTE_BITS = 8;
+
+/** Little-endian unsigned 32-bit: 0x0000000A -> [0x0a, 0x00, 0x00, 0x00]. */
+export const le32ToBytes = value => [value & BYTE_MASK, value >> BYTE_BITS & BYTE_MASK, value >> BYTE_BITS * 2 & BYTE_MASK, value >> BYTE_BITS * 3 & BYTE_MASK];
+//# sourceMappingURL=le-32-to-bytes.js.map

package/lib/module/modules/bt-management/utils/le-32-to-bytes.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BYTE_MASK","BYTE_BITS","le32ToBytes","value"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/utils/le-32-to-bytes.ts"],"mappings":";;AAAA,MAAMA,SAAS,GAAG,IAAI;AACtB,MAAMC,SAAS,GAAG,CAAC;;AAEnB;AACA,OAAO,MAAMC,WAAW,GAAIC,KAAa,IAAe,CACtDA,KAAK,GAAGH,SAAS,EAChBG,KAAK,IAAIF,SAAS,GAAID,SAAS,EAC/BG,KAAK,IAAKF,SAAS,GAAG,CAAE,GAAID,SAAS,EACrCG,KAAK,IAAKF,SAAS,GAAG,CAAE,GAAID,SAAS,CACvC","ignoreList":[]}

package/lib/module/modules/bt-management/utils/parse-measurement.js

@@ -1,9 +1,12 @@
 "use strict";
 
-export const parseMeasurement = (measurementInHex, parsingCase) => {
+/**
+ * @param byteOffset added to every declared index, for a frame that repeats one record.
+ */
+export const parseMeasurement = (measurementInHex, parsingCase, byteOffset = 0) => {
   const parserDefinitions = parsingCase.parseDefinitions;
   const result = parserDefinitions.reduce((acc, parserDefinition) => {
-    const parsingValue = getFullValueForMeasurementProperty(measurementInHex, parserDefinition);
+    const parsingValue = getFullValueForMeasurementProperty(measurementInHex, parserDefinition, byteOffset);
     if (parserDefinition.customParserDefinition) {
       acc[parserDefinition.name] = parserDefinition.customParserDefinition(parsingValue);
     } else {
@@ -19,14 +22,14 @@ export const parseMeasurement = (measurementInHex, parsingCase) => {
   return measurement;
 };
 
-/** Example: We received message ["1A","02", "00", "50"]. Value for weight is on indexes 2,3. Which means we need to combine 2nd and 3rd indexes to get result
- * This method will combine them and return string "0050".
- * Indexes should be written in ParseDeinition
+/** Example: We received message ["1A","02", "00", "50"]. Value for weight is on indexes 2,3. Which means we need to combine 2nd and 3rd indexes to get result
+ * This method will combine them and return string "0050".
+ * Indexes should be written in ParseDeinition
  */
-const getFullValueForMeasurementProperty = (messageInHex, parseDefinition) => {
+const getFullValueForMeasurementProperty = (messageInHex, parseDefinition, byteOffset) => {
   let valuesInString = "";
   for (let i = 0; i < parseDefinition.byteIndexes.length; i++) {
-    valuesInString += messageInHex[parseDefinition.byteIndexes[i] || "0"];
+    valuesInString += messageInHex[(parseDefinition.byteIndexes[i] ?? 0) + byteOffset];
   }
   return valuesInString;
 };