@ovok/native 0.4.6 → 0.4.7

package/lib/module/modules/bt-management/services/devices/lepu/lepu.file-transfer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["le32FromHex","le32ToBytes","LepuCommand","lepuNameBytes","lepuNamesFrom","lepuCommandOf","lepuPayloadOf","describeLepuResponseType","isLepuSuccess","FILE_SIZE_OFFSET","MAX_FILE_BYTES","TRANSFER_COMMANDS","GET_FILE_LIST","READ_FILE_START","READ_FILE_DATA","READ_FILE_END","LepuFileTransfer","files","fileIndex","name","totalBytes","content","isSessionOpen","isDone","constructor","params","initialCommands","commandFor","nextCommand","frame","command","includes","undefined","fail","openNextFile","openedFile","appendChunk","closedFile","payload","limit","maxFileBytes","closeFile","length","push","onProgress","receivedBytes","onFile","reason","onError","write","builder","build"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/lepu/lepu.file-transfer.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/lepu/lepu.frame-reader.js

@@ -0,0 +1,93 @@
+"use strict";
+
+import { FrameReadStatus } from "../../../types/frame-read-status.js";
+import { calculateCrc8 } from "../../../utils/calculate-crc-8.js";
+import { hexToByte } from "../../../utils/hex-to-byte.js";
+import { le16FromHex } from "../../../utils/le-16-from-hex.js";
+const COMMAND_INDEX = 1;
+const COMMAND_COMPLEMENT_INDEX = 2;
+const PAYLOAD_LENGTH_INDEX = 5;
+const HEADER_BYTES = 7;
+const CHECKSUM_BYTES = 1;
+const BYTE_MASK = 0xff;
+
+/** Start byte, command and its complement: the shortest run that can identify a start. */
+const START_PATTERN_BYTES = 3;
+
+/**
+ * Reads the frame every Lepu device shares.
+ *
+ * Layout: `start | cmd | ~cmd | type | seq | lenLow lenHigh | payload | crc8`, where the
+ * checksum covers every byte before it. The complement of the command byte only narrows the
+ * search for a start; the checksum is what actually decides a frame is trustworthy.
+ *
+ * The start byte is the only part that varies across the family. Most devices use `a5`, a
+ * smaller group uses `55`, and a few accept either and settle on one at runtime - so it is a
+ * list rather than a single value. Everything else is identical on every device speaking this
+ * protocol, which is why it is worth having once rather than once per device.
+ */
+export class LepuFrameReader {
+  constructor(startBytes) {
+    this.startBytes = startBytes;
+  }
+  readFrame(buffer) {
+    const start = this.findFrameStart(buffer);
+    if (start === -1) {
+      return {
+        status: FrameReadStatus.INCOMPLETE,
+        consumedBytes: this.droppableLeadingBytes(buffer)
+      };
+    }
+    const payloadLength = le16FromHex(buffer, start + PAYLOAD_LENGTH_INDEX);
+    const frameLength = HEADER_BYTES + payloadLength + CHECKSUM_BYTES;
+    if (start + frameLength > buffer.length) {
+      return {
+        status: FrameReadStatus.INCOMPLETE,
+        consumedBytes: start
+      };
+    }
+    const frame = buffer.slice(start, start + frameLength);
+    if (!this.hasValidChecksum(frame)) {
+      return {
+        status: FrameReadStatus.CORRUPT,
+        consumedBytes: start + START_PATTERN_BYTES
+      };
+    }
+    return {
+      status: FrameReadStatus.COMPLETE,
+      consumedBytes: start + frameLength,
+      frame
+    };
+  }
+  isFrameStart(buffer, index) {
+    if (!this.startBytes.includes((buffer[index] || "").toLowerCase())) {
+      return false;
+    }
+    const command = hexToByte(buffer[index + COMMAND_INDEX] || "0");
+    const complement = hexToByte(buffer[index + COMMAND_COMPLEMENT_INDEX] || "0");
+    return command === (~complement & BYTE_MASK);
+  }
+  findFrameStart(buffer) {
+    const lastCandidate = buffer.length - START_PATTERN_BYTES;
+    for (let index = 0; index <= lastCandidate; index++) {
+      if (this.isFrameStart(buffer, index)) {
+        return index;
+      }
+    }
+    return -1;
+  }
+
+  /**
+   * Bytes that cannot begin a frame start, and are therefore safe to drop when no start was
+   * found. The trailing bytes are kept because a start pattern may still be arriving.
+   */
+  droppableLeadingBytes(buffer) {
+    return Math.max(0, buffer.length - (START_PATTERN_BYTES - 1));
+  }
+  hasValidChecksum(frame) {
+    const checksummedBytes = frame.length - CHECKSUM_BYTES;
+    const declared = hexToByte(frame[checksummedBytes] || "0");
+    return declared === calculateCrc8(frame, checksummedBytes);
+  }
+}
+//# sourceMappingURL=lepu.frame-reader.js.map

package/lib/module/modules/bt-management/services/devices/lepu/lepu.frame-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["FrameReadStatus","calculateCrc8","hexToByte","le16FromHex","COMMAND_INDEX","COMMAND_COMPLEMENT_INDEX","PAYLOAD_LENGTH_INDEX","HEADER_BYTES","CHECKSUM_BYTES","BYTE_MASK","START_PATTERN_BYTES","LepuFrameReader","constructor","startBytes","readFrame","buffer","start","findFrameStart","status","INCOMPLETE","consumedBytes","droppableLeadingBytes","payloadLength","frameLength","length","frame","slice","hasValidChecksum","CORRUPT","COMPLETE","isFrameStart","index","includes","toLowerCase","command","complement","lastCandidate","Math","max","checksummedBytes","declared"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/lepu/lepu.frame-reader.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/lepu/lepu.frame.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { hexToByte } from "../../../utils/hex-to-byte.js";
+import { le16FromHex } from "../../../utils/le-16-from-hex.js";
+const COMMAND_INDEX = 1;
+const PAYLOAD_LENGTH_INDEX = 5;
+const HEADER_BYTES = 7;
+
+/** The opcode a frame answers, which is what correlates a reply to its request. */
+const lepuCommandOf = frame => hexToByte(frame[COMMAND_INDEX] ?? "0");
+
+/**
+ * The bytes a frame carries, from its own declared length.
+ *
+ * Declared rather than derived from what arrived: the frame reader has already checked that
+ * the buffer holds the whole frame, so the length field is the payload's end, and trusting
+ * the array instead would fold the checksum byte into the data.
+ */
+const lepuPayloadOf = frame => {
+  const length = le16FromHex(frame, PAYLOAD_LENGTH_INDEX);
+  return frame.slice(HEADER_BYTES, HEADER_BYTES + length);
+};
+export { lepuCommandOf, lepuPayloadOf };
+//# sourceMappingURL=lepu.frame.js.map

package/lib/module/modules/bt-management/services/devices/lepu/lepu.frame.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["hexToByte","le16FromHex","COMMAND_INDEX","PAYLOAD_LENGTH_INDEX","HEADER_BYTES","lepuCommandOf","frame","lepuPayloadOf","length","slice"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/lepu/lepu.frame.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,+BAA4B;AACtD,SAASC,WAAW,QAAQ,kCAA+B;AAE3D,MAAMC,aAAa,GAAG,CAAC;AACvB,MAAMC,oBAAoB,GAAG,CAAC;AAC9B,MAAMC,YAAY,GAAG,CAAC;;AAEtB;AACA,MAAMC,aAAa,GAAIC,KAAwB,IAC7CN,SAAS,CAACM,KAAK,CAACJ,aAAa,CAAC,IAAI,GAAG,CAAC;;AAExC;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMK,aAAa,GAAID,KAAwB,IAAe;EAC5D,MAAME,MAAM,GAAGP,WAAW,CAACK,KAAK,EAAEH,oBAAoB,CAAC;EAEvD,OAAOG,KAAK,CAACG,KAAK,CAACL,YAAY,EAAEA,YAAY,GAAGI,MAAM,CAAC;AACzD,CAAC;AAED,SAASH,aAAa,EAAEE,aAAa","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/lepu/lepu.identity-gate.js

@@ -0,0 +1,98 @@
+"use strict";
+
+import { hexToByte } from "../../../utils/hex-to-byte.js";
+import { LepuCommand } from "./lepu.commands.js";
+import { parseLepuDeviceInfo } from "./lepu.device-info.js";
+import { describeLepuResponseType, isLepuSuccess } from "./lepu.response-type.js";
+const COMMAND_INDEX = 1;
+
+/**
+ * Asks a Lepu device what it is before sending it anything that acts.
+ *
+ * The family shares one frame format, one checksum and one opcode space, but not one
+ * meaning: `0x08` polls realtime data on a BP2, starts a blood-pressure measurement on an
+ * AirBp and starts an ECG on a Lepod. A frame built for the wrong device is therefore
+ * perfectly well-formed - the CRC is computed the same way on every one of them - so
+ * nothing in the protocol catches a driver bound to the wrong hardware. What comes back is
+ * a cuff inflating on someone's arm because a name matched during a scan.
+ *
+ * `GET_INFO` is the one command that cannot cause that: it is generic, inert, and answered
+ * identically family-wide. So it goes first, and everything else waits on its reply.
+ *
+ * A declaration that names the models it was written for is refused permanently when the
+ * device answers with a different one. A declaration that names none is identified by the
+ * advertised name it already matched, which is the basis the vendor's own SDK binds every
+ * one of its products on; it is asked what it is anyway, and the answer reported, because
+ * that is the only place these model numbers exist - the vendor never reads the field back,
+ * so there is no table of them to copy.
+ *
+ * A reply that never arrives leaves the gate closed and nothing sent, which the data
+ * processor's stuck-data timeout reports and disconnects on. That is the watchdog for this
+ * too - the protocol has no retry of its own, so a dropped reply is recovered by
+ * reconnecting rather than by asking again.
+ */
+export class LepuIdentityGate {
+  isIdentified = false;
+  isRefused = false;
+  constructor(params) {
+    this.params = params;
+  }
+  initialCommands = () => [this.commandFor(LepuCommand.GET_INFO)];
+  nextCommand = frame => {
+    if (this.isRefused) {
+      return undefined;
+    }
+    if (this.isIdentified) {
+      return this.poll();
+    }
+    return this.admit(frame);
+  };
+
+  /**
+   * Decides on the reply to `GET_INFO`.
+   *
+   * A frame that is not that reply leaves the gate as it was rather than provoking another
+   * command, because the only command outstanding is the one still being waited on.
+   *
+   * A reply that is that command but carries an error type is refused rather than parsed.
+   * The payload of an error is the reason for it, so reading a model number out of it would
+   * identify the hardware from an error code.
+   */
+  admit = frame => {
+    if (hexToByte(frame[COMMAND_INDEX] ?? "0") !== LepuCommand.GET_INFO) {
+      return undefined;
+    }
+    if (!isLepuSuccess(frame)) {
+      return this.refuse(`the device would not say what it is: ${describeLepuResponseType(frame)}`);
+    }
+    const info = parseLepuDeviceInfo(frame);
+    if (!info) {
+      return this.refuse("the device answered with a frame too short to hold its own model number");
+    }
+    this.params.onIdentified?.(info);
+    if (this.params.pollCommand === undefined) {
+      return undefined;
+    }
+    const isNarrowed = this.params.expectedDeviceTypes.length > 0;
+    if (isNarrowed && !this.params.expectedDeviceTypes.includes(info.deviceType)) {
+      return this.refuse(`the hardware reported model ${info.deviceType} (branch "${info.branchCode}"), which this declaration was not written for`);
+    }
+    this.isIdentified = true;
+    return this.poll();
+  };
+
+  /** Closes the gate for good. There is no state a refused device can be talked back from. */
+  refuse = reason => {
+    this.isRefused = true;
+    this.params.onRefused(reason);
+    return undefined;
+  };
+
+  /** Nothing, for a declaration that asks what the device is and stops there. */
+  poll = () => this.params.pollCommand === undefined ? undefined : [this.commandFor(this.params.pollCommand)];
+  commandFor = command => ({
+    ...this.params.write,
+    frame: this.params.builder.build(command)
+  });
+}
+//# sourceMappingURL=lepu.identity-gate.js.map

package/lib/module/modules/bt-management/services/devices/lepu/lepu.identity-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["hexToByte","LepuCommand","parseLepuDeviceInfo","describeLepuResponseType","isLepuSuccess","COMMAND_INDEX","LepuIdentityGate","isIdentified","isRefused","constructor","params","initialCommands","commandFor","GET_INFO","nextCommand","frame","undefined","poll","admit","refuse","info","onIdentified","pollCommand","isNarrowed","expectedDeviceTypes","length","includes","deviceType","branchCode","reason","onRefused","command","write","builder","build"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/lepu/lepu.identity-gate.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/lepu/lepu.name-match.js

@@ -0,0 +1,27 @@
+"use strict";
+
+import { LEPU_DEVICE_NAMES } from "./lepu.device-names.js";
+const REGEXP_SPECIAL = /[.*+?^${}()|[\]\\]/g;
+const escapeRegExp = value => value.replace(REGEXP_SPECIAL, "\\$&");
+
+/**
+ * Builds a matcher for one advertised name that cannot also match a longer one.
+ *
+ * The vendor tests these names with a substring check in a hand-ordered cascade, so `BP2`
+ * only fails to match a BP2W because `BP2W` happens to be checked first. Order is a fragile
+ * place to keep a safety property: it lives in whoever wrote the list, is invisible at the
+ * point of use, and an insertion in the wrong place silently binds the wrong driver.
+ *
+ * Here the exclusions are derived instead. Every name in the vocabulary that extends this
+ * one becomes a negative lookahead, so the matcher is correct wherever it is used and in
+ * whatever order it is tried.
+ *
+ * The match is deliberately open at the end, because these devices advertise a serial after
+ * the model - `BP2 1234` - and the serial's shape varies across the family.
+ */
+export const lepuNameMatch = (name, vocabulary = LEPU_DEVICE_NAMES) => {
+  const extensions = vocabulary.filter(other => other !== name && other.startsWith(name)).map(other => escapeRegExp(other.slice(name.length)));
+  const exclusion = extensions.length > 0 ? `(?!${extensions.join("|")})` : "";
+  return new RegExp(`^${escapeRegExp(name)}${exclusion}`);
+};
+//# sourceMappingURL=lepu.name-match.js.map

package/lib/module/modules/bt-management/services/devices/lepu/lepu.name-match.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LEPU_DEVICE_NAMES","REGEXP_SPECIAL","escapeRegExp","value","replace","lepuNameMatch","name","vocabulary","extensions","filter","other","startsWith","map","slice","length","exclusion","join","RegExp"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/lepu/lepu.name-match.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,wBAAqB;AAEvD,MAAMC,cAAc,GAAG,qBAAqB;AAE5C,MAAMC,YAAY,GAAIC,KAAa,IACjCA,KAAK,CAACC,OAAO,CAACH,cAAc,EAAE,MAAM,CAAC;;AAEvC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMI,aAAa,GAAGA,CAC3BC,IAAY,EACZC,UAA6B,GAAGP,iBAAiB,KACtC;EACX,MAAMQ,UAAU,GAAGD,UAAU,CAC1BE,MAAM,CAAEC,KAAK,IAAKA,KAAK,KAAKJ,IAAI,IAAII,KAAK,CAACC,UAAU,CAACL,IAAI,CAAC,CAAC,CAC3DM,GAAG,CAAEF,KAAK,IAAKR,YAAY,CAACQ,KAAK,CAACG,KAAK,CAACP,IAAI,CAACQ,MAAM,CAAC,CAAC,CAAC;EAEzD,MAAMC,SAAS,GACbP,UAAU,CAACM,MAAM,GAAG,CAAC,GAAG,MAAMN,UAAU,CAACQ,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,EAAE;EAE5D,OAAO,IAAIC,MAAM,CAAC,IAAIf,YAAY,CAACI,IAAI,CAAC,GAAGS,SAAS,EAAE,CAAC;AACzD,CAAC","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/lepu/lepu.response-type.js

@@ -0,0 +1,59 @@
+"use strict";
+
+import { hexToByte } from "../../../utils/hex-to-byte.js";
+
+/** Byte 3 of every frame: the direction on a request, the outcome on a reply. */
+const RESPONSE_TYPE_INDEX = 3;
+
+/**
+ * What a Lepu device says about the request it just answered.
+ *
+ * Only `SUCCESS` means the payload holds what was asked for. Every other value is an error
+ * whose payload is not the requested data, so a reply has to be checked before it is
+ * decoded - otherwise a refusal is read as a reading, out of whatever bytes happen to
+ * follow the header.
+ */
+const LepuResponseType = {
+  /** A request, phone to device. Never seen on a reply. */
+  REQUEST: 0x00,
+  SUCCESS: 0x01,
+  /** The device rejected our checksum. */
+  CRC_ERROR: 0x02,
+  FILE_NOT_FOUND: 0xe0,
+  FILE_READ_FAILED: 0xe1,
+  FILE_WRITE_FAILED: 0xe2,
+  PARAMETER_ILLEGAL: 0xf1,
+  PERMISSION_DENIED: 0xf2,
+  DECRYPT_FAILED: 0xf3,
+  /** Mid-measurement or otherwise occupied. Worth backing off rather than giving up. */
+  DEVICE_BUSY: 0xfb,
+  COMMAND_FORMAT_ERROR: 0xfc,
+  /** The opcode is unknown to this firmware, which is how a feature is detected. */
+  COMMAND_NOT_SUPPORTED: 0xfd,
+  ERROR: 0xff
+};
+const RESPONSE_TYPE_NAMES = {
+  [LepuResponseType.CRC_ERROR]: "it rejected our checksum",
+  [LepuResponseType.FILE_NOT_FOUND]: "the file does not exist",
+  [LepuResponseType.FILE_READ_FAILED]: "the file could not be read",
+  [LepuResponseType.FILE_WRITE_FAILED]: "the file could not be written",
+  [LepuResponseType.PARAMETER_ILLEGAL]: "the parameter was rejected",
+  [LepuResponseType.PERMISSION_DENIED]: "permission was denied",
+  [LepuResponseType.DECRYPT_FAILED]: "it could not decrypt the request",
+  [LepuResponseType.DEVICE_BUSY]: "it is busy",
+  [LepuResponseType.COMMAND_FORMAT_ERROR]: "the command was malformed",
+  [LepuResponseType.COMMAND_NOT_SUPPORTED]: "the opcode is unknown to this firmware",
+  [LepuResponseType.ERROR]: "it reported a generic error"
+};
+const lepuResponseType = frame => hexToByte(frame[RESPONSE_TYPE_INDEX] ?? "0");
+const isLepuSuccess = frame => lepuResponseType(frame) === LepuResponseType.SUCCESS;
+
+/** Why a device refused, in words, for an error a person will read. */
+const describeLepuResponseType = frame => {
+  const type = lepuResponseType(frame);
+  const known = RESPONSE_TYPE_NAMES[type];
+  const code = `0x${type.toString(16).padStart(2, "0")}`;
+  return known ? `${known} (${code})` : `it answered with ${code}`;
+};
+export { describeLepuResponseType, isLepuSuccess, LepuResponseType, lepuResponseType };
+//# sourceMappingURL=lepu.response-type.js.map

package/lib/module/modules/bt-management/services/devices/lepu/lepu.response-type.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["hexToByte","RESPONSE_TYPE_INDEX","LepuResponseType","REQUEST","SUCCESS","CRC_ERROR","FILE_NOT_FOUND","FILE_READ_FAILED","FILE_WRITE_FAILED","PARAMETER_ILLEGAL","PERMISSION_DENIED","DECRYPT_FAILED","DEVICE_BUSY","COMMAND_FORMAT_ERROR","COMMAND_NOT_SUPPORTED","ERROR","RESPONSE_TYPE_NAMES","lepuResponseType","frame","isLepuSuccess","describeLepuResponseType","type","known","code","toString","padStart"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/lepu/lepu.response-type.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,+BAA4B;;AAEtD;AACA,MAAMC,mBAAmB,GAAG,CAAC;;AAE7B;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAMC,gBAAgB,GAAG;EACvB;EACAC,OAAO,EAAE,IAAI;EAEbC,OAAO,EAAE,IAAI;EAEb;EACAC,SAAS,EAAE,IAAI;EAEfC,cAAc,EAAE,IAAI;EACpBC,gBAAgB,EAAE,IAAI;EACtBC,iBAAiB,EAAE,IAAI;EACvBC,iBAAiB,EAAE,IAAI;EACvBC,iBAAiB,EAAE,IAAI;EACvBC,cAAc,EAAE,IAAI;EAEpB;EACAC,WAAW,EAAE,IAAI;EAEjBC,oBAAoB,EAAE,IAAI;EAE1B;EACAC,qBAAqB,EAAE,IAAI;EAE3BC,KAAK,EAAE;AACT,CAAU;AAEV,MAAMC,mBAAqD,GAAG;EAC5D,CAACd,gBAAgB,CAACG,SAAS,GAAG,0BAA0B;EACxD,CAACH,gBAAgB,CAACI,cAAc,GAAG,yBAAyB;EAC5D,CAACJ,gBAAgB,CAACK,gBAAgB,GAAG,4BAA4B;EACjE,CAACL,gBAAgB,CAACM,iBAAiB,GAAG,+BAA+B;EACrE,CAACN,gBAAgB,CAACO,iBAAiB,GAAG,4BAA4B;EAClE,CAACP,gBAAgB,CAACQ,iBAAiB,GAAG,uBAAuB;EAC7D,CAACR,gBAAgB,CAACS,cAAc,GAAG,kCAAkC;EACrE,CAACT,gBAAgB,CAACU,WAAW,GAAG,YAAY;EAC5C,CAACV,gBAAgB,CAACW,oBAAoB,GAAG,2BAA2B;EACpE,CAACX,gBAAgB,CAACY,qBAAqB,GACrC,wCAAwC;EAC1C,CAACZ,gBAAgB,CAACa,KAAK,GAAG;AAC5B,CAAC;AAED,MAAME,gBAAgB,GAAIC,KAAwB,IAChDlB,SAAS,CAACkB,KAAK,CAACjB,mBAAmB,CAAC,IAAI,GAAG,CAAC;AAE9C,MAAMkB,aAAa,GAAID,KAAwB,IAC7CD,gBAAgB,CAACC,KAAK,CAAC,KAAKhB,gBAAgB,CAACE,OAAO;;AAEtD;AACA,MAAMgB,wBAAwB,GAAIF,KAAwB,IAAa;EACrE,MAAMG,IAAI,GAAGJ,gBAAgB,CAACC,KAAK,CAAC;EACpC,MAAMI,KAAK,GAAGN,mBAAmB,CAACK,IAAI,CAAC;EACvC,MAAME,IAAI,GAAG,KAAKF,IAAI,CAACG,QAAQ,CAAC,EAAE,CAAC,CAACC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;EAEtD,OAAOH,KAAK,GAAG,GAAGA,KAAK,KAAKC,IAAI,GAAG,GAAG,oBAAoBA,IAAI,EAAE;AAClE,CAAC;AAED,SACEH,wBAAwB,EACxBD,aAAa,EACbjB,gBAAgB,EAChBe,gBAAgB","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/lepu/lepu.transports.js

@@ -0,0 +1,140 @@
+"use strict";
+
+import { defineCustomDevice } from "../../custom/define-custom-device.js";
+
+/**
+ * Declares a device from the Lepu/Viatom family.
+ *
+ * Thirty products in that family share one frame format, one CRC and one generic opcode
+ * space, and they differ in only three things: which characteristics they expose, what
+ * their payload means, and what they call themselves. The first of those is the same for
+ * almost all of them and is recorded here; the other two belong to the product and are
+ * asked of the caller.
+ *
+ * Two things a declaration cannot supply, and where they come from:
+ *
+ * - **The model numbers.** A device reports one in its information reply, but the vendor's
+ *   own SDK never reads that field back - it binds a driver from the advertised name - so
+ *   no table of them exists to copy. Declare the device without a `pollCommand`, connect
+ *   once, and it reports what it is without sending anything that acts.
+ * - **The payload layout.** Every product decodes differently, and a guessed offset yields
+ *   a plausible wrong reading rather than an error. Declared cases are the caller's.
+ *
+ * Some of these products negotiate encryption in the vendor app (`Bp2`, `Er2` and the
+ * oximeters do; `Er1`, `Er3`, `Bp3` and `Lepod` do not). The SDK speaks the cleartext
+ * protocol, which is what the BP2 already runs on in production, so a product that turns out
+ * to require the handshake will identify itself and then stop rather than mis-report.
+ */
+
+/**
+ * Most of the family. The vendor's own SDK reference lists 71 products on these three
+ * characteristics - the BP2 and BP3 monitors, Er1/Er2/Er3, Lepod, the whole O2Ring and
+ * Oxyfit range, Checkme, AirBp - and the SDK's own BP2 driver has run against them on real
+ * hardware.
+ */
+const STANDARD_SERVICE = "14839ac4-7d7e-415c-9a42-167340cf2339";
+const STANDARD_WRITE = "8b00ace7-eb0b-49b0-bbe9-9aee0a26e1a3";
+const STANDARD_NOTIFY = "0734594a-a8e7-4b1a-a6b1-cd5243059a57";
+
+/** Nine products in the vendor's reference: O2Ring S, the PF-10 wearables and the BBSM bands. */
+const AW1_SERVICE = "e8fb0001-a14b-98f9-831b-4e2941d01248";
+const AW1_WRITE = "e8fb0002-a14b-98f9-831b-4e2941d01248";
+const AW1_NOTIFY = "e8fb0003-a14b-98f9-831b-4e2941d01248";
+
+/**
+ * Read from an OEM build rather than from the vendor's published reference, which documents
+ * no product on these characteristics. Real, but unconfirmed by the vendor and untried here.
+ */
+const DING_SERVICE = "0000fe60-0000-1000-8000-00805f9b34fb";
+const DING_WRITE = "0000fe61-0000-1000-8000-00805f9b34fb";
+const DING_NOTIFY = "0000fe62-0000-1000-8000-00805f9b34fb";
+
+/** Also from an OEM build only, and likewise absent from the vendor's published reference. */
+const AI_TELE_SERVICE = "00002760-08c2-11e1-9073-0e8ac72e5450";
+const AI_TELE_WRITE = "00002760-08c2-11e1-9073-0e8ac72e5401";
+const AI_TELE_NOTIFY = "00002760-08c2-11e1-9073-0e8ac72e5402";
+
+/** What the vendor app asks for on every one of these links but the Er2's. */
+const PREFERRED_MTU = 247;
+
+/** The Er2 negotiates the link minimum, which is why commands are split to fit. */
+const MINIMUM_MTU = 23;
+
+/** Long enough for a device that waits on a person to start a measurement. */
+const DEFAULT_STUCK_TIMEOUT_MS = 60_000;
+const START_BYTE = "a5";
+/**
+ * The characteristics each group of products exposes, read from the vendor's own managers.
+ *
+ * `standard` and `aw1` match the vendor's published SDK reference exactly, and `standard`
+ * also matches the SDK's existing BP2 driver, which has run against hardware on precisely
+ * these UUIDs. `ding` and `aiTele` were read from an OEM build and the vendor documents no
+ * product on them, so they are the two entries here that nothing independent confirms.
+ */
+const lepuTransports = {
+  standard: {
+    serviceUuid: STANDARD_SERVICE,
+    notifyUuid: STANDARD_NOTIFY,
+    writeUuid: STANDARD_WRITE,
+    preferredMtu: PREFERRED_MTU
+  },
+  /** The same characteristics on a link that will not grow past the minimum. */
+  standardSmallMtu: {
+    serviceUuid: STANDARD_SERVICE,
+    notifyUuid: STANDARD_NOTIFY,
+    writeUuid: STANDARD_WRITE,
+    preferredMtu: MINIMUM_MTU
+  },
+  aw1: {
+    serviceUuid: AW1_SERVICE,
+    notifyUuid: AW1_NOTIFY,
+    writeUuid: AW1_WRITE,
+    preferredMtu: PREFERRED_MTU
+  },
+  ding: {
+    serviceUuid: DING_SERVICE,
+    notifyUuid: DING_NOTIFY,
+    writeUuid: DING_WRITE,
+    preferredMtu: PREFERRED_MTU
+  },
+  aiTele: {
+    serviceUuid: AI_TELE_SERVICE,
+    notifyUuid: AI_TELE_NOTIFY,
+    writeUuid: AI_TELE_WRITE,
+    preferredMtu: PREFERRED_MTU
+  }
+};
+const COMMAND_BYTE = 1;
+const lepuDevice = params => {
+  const transport = lepuTransports[params.transport ?? "standard"];
+  return defineCustomDevice({
+    id: params.id,
+    nameMatch: params.nameMatch,
+    stuckDataTimeoutMs: params.stuckDataTimeoutMs ?? DEFAULT_STUCK_TIMEOUT_MS,
+    preferredMtu: transport.preferredMtu,
+    lepu: {
+      startBytes: [START_BYTE],
+      write: {
+        serviceUuid: transport.serviceUuid,
+        characteristicUuid: transport.writeUuid
+      },
+      expectedDeviceTypes: [...(params.expectedDeviceTypes ?? [])],
+      ...(params.pollCommand === undefined ? {} : {
+        pollCommand: params.pollCommand
+      })
+    },
+    services: [{
+      uuid: transport.serviceUuid,
+      monitor: [{
+        uuid: transport.notifyUuid,
+        frame: {
+          minLengthBytes: params.minLengthBytes
+        },
+        caseSelectorBytes: params.caseSelectorBytes ?? [COMMAND_BYTE],
+        cases: params.cases
+      }]
+    }]
+  });
+};
+export { lepuDevice, lepuTransports };
+//# sourceMappingURL=lepu.transports.js.map

package/lib/module/modules/bt-management/services/devices/lepu/lepu.transports.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["defineCustomDevice","STANDARD_SERVICE","STANDARD_WRITE","STANDARD_NOTIFY","AW1_SERVICE","AW1_WRITE","AW1_NOTIFY","DING_SERVICE","DING_WRITE","DING_NOTIFY","AI_TELE_SERVICE","AI_TELE_WRITE","AI_TELE_NOTIFY","PREFERRED_MTU","MINIMUM_MTU","DEFAULT_STUCK_TIMEOUT_MS","START_BYTE","lepuTransports","standard","serviceUuid","notifyUuid","writeUuid","preferredMtu","standardSmallMtu","aw1","ding","aiTele","COMMAND_BYTE","lepuDevice","params","transport","id","nameMatch","stuckDataTimeoutMs","lepu","startBytes","write","characteristicUuid","expectedDeviceTypes","pollCommand","undefined","services","uuid","monitor","frame","minLengthBytes","caseSelectorBytes","cases"],"sourceRoot":"../../../../../../../src","sources":["modules/bt-management/services/devices/lepu/lepu.transports.ts"],"mappings":"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","ignoreList":[]}

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