@ovok/native 0.4.5 → 0.4.7

package/lib/module/modules/bt-management/services/devices/polling-command-sequencer.js

@@ -0,0 +1,34 @@
+"use strict";
+
+import { hexToBytes } from "../../utils/hex-to-bytes.js";
+
+/**
+ * Sends the same commands on connect and after every frame.
+ *
+ * This is what the SDK did before a device could express anything else, and it remains
+ * right for the devices that only ever ask one question: a poll goes out, a reading comes
+ * back, and the answer is another poll. Keeping it as a named policy rather than as
+ * behaviour built into the transport is what lets a device replace it without every other
+ * device changing.
+ */
+class PollingCommandSequencer {
+  constructor(commands) {
+    this.commands = commands;
+  }
+  initialCommands = () => this.commands;
+  nextCommand = () => this.commands;
+}
+
+/**
+ * Builds the polling policy a device's declared services already describe.
+ *
+ * A service without a write characteristic contributes nothing, so a listen-only device
+ * gets an empty policy and is never written to.
+ */
+const pollingSequencerFor = services => new PollingCommandSequencer(services.flatMap(service => service.writeUuid ? [{
+  serviceUuid: service.uuid,
+  characteristicUuid: service.writeUuid.uuid,
+  frame: hexToBytes(service.writeUuid.mainCommandUuid)
+}] : []));
+export { PollingCommandSequencer, pollingSequencerFor };
+//# sourceMappingURL=polling-command-sequencer.js.map

package/lib/module/modules/bt-management/services/devices/polling-command-sequencer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["hexToBytes","PollingCommandSequencer","constructor","commands","initialCommands","nextCommand","pollingSequencerFor","services","flatMap","service","writeUuid","serviceUuid","uuid","characteristicUuid","frame","mainCommandUuid"],"sourceRoot":"../../../../../../src","sources":["modules/bt-management/services/devices/polling-command-sequencer.ts"],"mappings":";;AAGA,SAASA,UAAU,QAAQ,6BAA0B;;AAErD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,uBAAuB,CAA6B;EACjDC,WAAWA,CAAkBC,QAAkC,EAAE;IAAA,KAApCA,QAAkC,GAAlCA,QAAkC;EAAG;EAElEC,eAAe,GAAGA,CAAA,KAAgC,IAAI,CAACD,QAAQ;EAE/DE,WAAW,GAAGA,CAAA,KAAgC,IAAI,CAACF,QAAQ;AACpE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMG,mBAAmB,GACvBC,QAAuC,IAEvC,IAAIN,uBAAuB,CACzBM,QAAQ,CAACC,OAAO,CAAEC,OAAO,IACvBA,OAAO,CAACC,SAAS,GACb,CACE;EACEC,WAAW,EAAEF,OAAO,CAACG,IAAI;EACzBC,kBAAkB,EAAEJ,OAAO,CAACC,SAAS,CAACE,IAAI;EAC1CE,KAAK,EAAEd,UAAU,CAACS,OAAO,CAACC,SAAS,CAACK,eAAe;AACrD,CAAC,CACF,GACD,EACN,CACF,CAAC;AAEH,SAASd,uBAAuB,EAAEK,mBAAmB","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/standard-gatt/standard-gatt.devices.js

@@ -0,0 +1,149 @@
+"use strict";
+
+import { MeasurementTypeKey } from "@ovok/core";
+import { defineCustomDevice } from "../../custom/define-custom-device.js";
+
+/**
+ * Declarations for the Bluetooth SIG vital-signs profiles.
+ *
+ * These are the profiles a compliant patient device implements, and their layouts come from
+ * the public specification rather than from reading a vendor's app, so they can be written
+ * down exactly instead of inferred.
+ *
+ * The advertised name stays the caller's, because the SDK matches a scan result by name and
+ * every vendor names its hardware differently. A product declares the profile and supplies
+ * the name its own hardware advertises.
+ *
+ * Values are little-endian, as the specification requires. Only the layouts using each
+ * catalog's canonical unit are declared: a device reporting kPa, Fahrenheit or pounds needs
+ * a conversion a declaration cannot express, and leaving those flag values undeclared means
+ * such a device yields no reading rather than one that is quietly wrong.
+ */
+
+/** Milliseconds a spot-check device may take to produce its reading. */
+const SPOT_CHECK_TIMEOUT_MS = 60_000;
+const sigUuid = assigned => `0000${assigned}-0000-1000-8000-00805f9b34fb`;
+
+/**
+ * The flags byte selects the case, because it decides which optional fields are present and
+ * therefore where the later ones sit. Every declared case reads the same offsets, so only
+ * fields that keep their position across all of them may be declared.
+ */
+const declareProfile = (params, profile) => defineCustomDevice({
+  id: params.id,
+  nameMatch: params.nameMatch,
+  stuckDataTimeoutMs: params.stuckDataTimeoutMs ?? SPOT_CHECK_TIMEOUT_MS,
+  services: [{
+    uuid: sigUuid(profile.service),
+    monitor: [{
+      uuid: sigUuid(profile.characteristic),
+      frame: {
+        minLengthBytes: profile.minLengthBytes
+      },
+      caseSelectorBytes: [0],
+      cases: profile.selectors.map(selector => ({
+        selector,
+        kind: "result",
+        measurementTypeKey: profile.measurementTypeKey,
+        fields: [...profile.fields]
+      }))
+    }]
+  }]
+});
+const littleEndian = (name, byteIndexes, unit, encoding) => ({
+  name,
+  byteIndexes,
+  byteOrder: "little",
+  encoding,
+  unit
+});
+
+/**
+ * Blood Pressure Service 0x1810, Blood Pressure Measurement 0x2A35.
+ *
+ * The pulse rate is deliberately not read. Its offset moves with the timestamp flag, and
+ * every byte a declaration reads must fit inside one `minLengthBytes` for the whole
+ * characteristic - reading it would raise the minimum to sixteen bytes and reject the
+ * shorter frames outright. The pressures sit at bytes 1-4 whatever the flags say, so they
+ * are always safe. A device whose pulse matters needs a device class.
+ */
+const standardBloodPressureDevice = params => declareProfile(params, {
+  service: "1810",
+  characteristic: "2a35",
+  minLengthBytes: 7,
+  measurementTypeKey: MeasurementTypeKey.bloodPressure,
+  /** mmHg, with and without the timestamp and pulse the pressures sit in front of. */
+  selectors: ["00", "02", "04", "06"],
+  fields: [littleEndian("systolic", [1, 2], "mmHg", "sfloat"), littleEndian("diastolic", [3, 4], "mmHg", "sfloat")]
+});
+
+/** Health Thermometer Service 0x1809, Temperature Measurement 0x2A1C. */
+const standardThermometerDevice = params => declareProfile(params, {
+  service: "1809",
+  characteristic: "2a1c",
+  minLengthBytes: 5,
+  measurementTypeKey: MeasurementTypeKey.temperature,
+  /** Celsius, with and without the timestamp that follows the reading. */
+  selectors: ["00", "02"],
+  fields: [littleEndian("bodyTemp", [1, 2, 3, 4], "Cel", "float")]
+});
+
+/** The SI weight resolution the specification fixes at five grams per count. */
+const WEIGHT_KG_PER_COUNT = 0.005;
+
+/**
+ * Weight Scale Service 0x181D, Weight Measurement 0x2A9D.
+ *
+ * The reading is a scaled integer rather than a float, so the resolution is applied here.
+ */
+const standardWeightScaleDevice = params => declareProfile(params, {
+  service: "181d",
+  characteristic: "2a9d",
+  minLengthBytes: 3,
+  measurementTypeKey: MeasurementTypeKey.bodyWeight,
+  /** Kilograms, with and without the timestamp that follows the reading. */
+  selectors: ["00", "02"],
+  fields: [{
+    ...littleEndian("bodyWeight", [1, 2], "kg", "uint"),
+    scale: WEIGHT_KG_PER_COUNT,
+    decimals: 3
+  }]
+});
+
+/**
+ * Pulse Oximeter Service 0x1822, PLX Spot-Check Measurement 0x2A5E.
+ *
+ * Saturation and pulse rate are both required by the catalog, which matches the
+ * specification: a spot-check measurement always carries both.
+ */
+const standardPulseOximeterDevice = params => declareProfile(params, {
+  service: "1822",
+  characteristic: "2a5e",
+  minLengthBytes: 5,
+  measurementTypeKey: MeasurementTypeKey.bloodOxygenPulseRate,
+  selectors: ["00"],
+  fields: [littleEndian("bloodOxygen", [1, 2], "%", "sfloat"), littleEndian("pulseRate", [3, 4], "bpm", "sfloat")]
+});
+
+/**
+ * Heart Rate Service 0x180D, Heart Rate Measurement 0x2A37.
+ *
+ * Only the eight-bit layout is declared. The sixteen-bit variant needs byte 2, which would
+ * raise `minLengthBytes` to three and reject every eight-bit frame - the common case - so it
+ * is left out rather than made to displace it.
+ */
+const standardHeartRateDevice = params => declareProfile(params, {
+  service: "180d",
+  characteristic: "2a37",
+  minLengthBytes: 2,
+  measurementTypeKey: MeasurementTypeKey.heartRate,
+  selectors: ["00"],
+  fields: [{
+    name: "heartRate",
+    byteIndexes: [1],
+    encoding: "uint",
+    unit: "bpm"
+  }]
+});
+export { standardBloodPressureDevice, standardHeartRateDevice, standardPulseOximeterDevice, standardThermometerDevice, standardWeightScaleDevice };
+//# sourceMappingURL=standard-gatt.devices.js.map

package/lib/module/modules/bt-management/services/devices/standard-gatt/standard-gatt.devices.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MeasurementTypeKey","defineCustomDevice","SPOT_CHECK_TIMEOUT_MS","sigUuid","assigned","declareProfile","params","profile","id","nameMatch","stuckDataTimeoutMs","services","uuid","service","monitor","characteristic","frame","minLengthBytes","caseSelectorBytes","cases","selectors","map","selector","kind","measurementTypeKey","fields","littleEndian","name","byteIndexes","unit","encoding","byteOrder","standardBloodPressureDevice","bloodPressure","standardThermometerDevice","temperature","WEIGHT_KG_PER_COUNT","standardWeightScaleDevice","bodyWeight","scale","decimals","standardPulseOximeterDevice","bloodOxygenPulseRate","standardHeartRateDevice","heartRate"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/standard-gatt/standard-gatt.devices.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,118 @@
+"use strict";
+
+import { MeasurementTypeKey } from "@ovok/core";
+import { lepuNameMatch } from "../lepu/lepu.name-match.js";
+import { lepuDevice } from "../lepu/lepu.transports.js";
+
+/**
+ * The Viatom blood-pressure monitors that report a reading over the realtime channel.
+ *
+ * The vendor documents BP2, BP2A and BP2T as one product group on one set of characteristics
+ * with one API, and the SDK's own BP2 device class has run against that protocol on real
+ * hardware. The byte offsets below are that class's, unchanged.
+ *
+ * BP2W and the BP3 range decode the same struct rather than merely sharing a transport:
+ * their interfaces build `Bp2BleRtData`, which holds the device state in its first nine
+ * bytes and the result immediately after, and all of them answer the same `RT_DATA` opcode.
+ * That is still one step short of BP2A and BP2T, which the vendor groups with BP2 outright.
+ */
+
+/** Realtime data. Inert on this series: it reads state, it does not start a measurement. */
+const RT_DATA = 0x08;
+
+/**
+ * The command byte and the device's state byte together pick the case.
+ *
+ * The state is the first byte of the realtime payload and is what says whether the numbers
+ * that follow are a finished reading or a cuff still inflating.
+ */
+const CASE_SELECTOR_BYTES = [1, 7];
+
+/** Header, realtime state, and the result struct through its pulse-rate field. */
+const MIN_LENGTH_BYTES = 28;
+const READING = [{
+  name: "systolic",
+  byteIndexes: [20, 21],
+  byteOrder: "little",
+  encoding: "uint",
+  unit: "mmHg"
+}, {
+  name: "diastolic",
+  byteIndexes: [22, 23],
+  byteOrder: "little",
+  encoding: "uint",
+  unit: "mmHg"
+}, {
+  name: "heartRate",
+  byteIndexes: [26, 27],
+  byteOrder: "little",
+  encoding: "uint",
+  unit: "bpm"
+}];
+const result = (selector, description) => ({
+  selector,
+  kind: "result",
+  measurementTypeKey: MeasurementTypeKey.bloodPressure,
+  fields: [...READING],
+  description
+});
+const measuring = (selector, description) => ({
+  selector,
+  kind: "stream",
+  description
+});
+
+/**
+ * The states the series reports, and what each means for a reading.
+ *
+ * A finished measurement keeps reporting itself for as long as the device sits on the
+ * result screen, so the same numbers arrive on every poll. The state transition is what
+ * separates one measurement from the next, which is why the states in between are declared
+ * rather than ignored.
+ */
+const BP2_CASES = [measuring("0804", "Cuff inflating or deflating"), result("0805", "Measurement finished"), measuring("080f", "Averaging run: a measurement is in progress"), measuring("0810", "Averaging run: waiting between measurements"), result("0811", "Averaging run finished, carrying the same payload")];
+/**
+ * Declares one monitor of the BP2 series.
+ *
+ * `advertisedName` is the name the vendor's SDK matches - `BP2A`, `BP2T` - and the matcher
+ * derived from it excludes every longer name in the family, so a declaration for `BP2`
+ * cannot pick up a `BP2W`.
+ */
+const viatomBpMonitor = (advertisedName, params) => lepuDevice({
+  id: params.id,
+  nameMatch: params.nameMatch ?? lepuNameMatch(advertisedName),
+  pollCommand: RT_DATA,
+  minLengthBytes: MIN_LENGTH_BYTES,
+  caseSelectorBytes: CASE_SELECTOR_BYTES,
+  cases: BP2_CASES.map(each => ({
+    ...each
+  })),
+  ...(params.expectedDeviceTypes ? {
+    expectedDeviceTypes: params.expectedDeviceTypes
+  } : {})
+});
+
+/** BP2A, the arm-cuff monitor of the series. */
+const bp2aMonitor = params => viatomBpMonitor("BP2A", params);
+
+/** BP2T, documented by the vendor alongside BP2 and BP2A as the same protocol. */
+const bp2tMonitor = params => viatomBpMonitor("BP2T", params);
+
+/** BP2W. Documented in its own section, but decoding the same realtime struct. */
+const bp2wMonitor = params => viatomBpMonitor("BP2W", params);
+
+/**
+ * The names the BP3 range advertises.
+ *
+ * Fifteen products differing in cuff and casing rather than in protocol, so declaring the
+ * range is one line per name:
+ *
+ * ```typescript
+ * const bp3Devices = BP3_MODEL_NAMES.map((name) =>
+ *   viatomBpMonitor(name, { id: `viatom-${name.toLowerCase()}` }),
+ * );
+ * ```
+ */
+const BP3_MODEL_NAMES = ["BP3", "BP3-B", "BP3-C1", "BP3-C2", "BP3A", "BP3B", "BP3C", "BP3D", "BP3E", "BP3F", "BP3G", "BP3H", "BP3K", "BP3L", "BP3Z"];
+export { bp2aMonitor, bp2tMonitor, bp2wMonitor, BP3_MODEL_NAMES, viatomBpMonitor };
+//# sourceMappingURL=viatom.bp-monitors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["MeasurementTypeKey","lepuNameMatch","lepuDevice","RT_DATA","CASE_SELECTOR_BYTES","MIN_LENGTH_BYTES","READING","name","byteIndexes","byteOrder","encoding","unit","result","selector","description","kind","measurementTypeKey","bloodPressure","fields","measuring","BP2_CASES","viatomBpMonitor","advertisedName","params","id","nameMatch","pollCommand","minLengthBytes","caseSelectorBytes","cases","map","each","expectedDeviceTypes","bp2aMonitor","bp2tMonitor","bp2wMonitor","BP3_MODEL_NAMES"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/viatom/viatom.bp-monitors.ts"],"mappings":"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","ignoreList":[]}

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":[]}