@ovok/native 0.4.2 → 0.4.4

package/lib/module/modules/bt-management/services/custom/compile-custom-field.js

@@ -0,0 +1,78 @@
+"use strict";
+
+import { measurementFieldCatalog } from "../../constants/measurement-field-catalog.js";
+import { customDeviceError } from "./custom-device-error.js";
+const MAX_INTEGER_BYTES = 6;
+const WIDTHS = {
+  sfloat: 2,
+  float: 4
+};
+const assertByteIndexes = (id, path, field, minLengthBytes) => {
+  const indexes = field.byteIndexes;
+  if (!Array.isArray(indexes) || indexes.length === 0 || indexes.some(i => !Number.isInteger(i) || i < 0)) {
+    throw customDeviceError(id, `${path}.byteIndexes`, "must be a non-empty list of byte offsets that are integers of at least 0");
+  }
+  if (new Set(indexes).size !== indexes.length) {
+    throw customDeviceError(id, `${path}.byteIndexes`, "reads the same byte twice");
+  }
+  const encoding = field.encoding ?? "uint";
+  const required = WIDTHS[encoding];
+  if (required !== undefined && indexes.length !== required) {
+    throw customDeviceError(id, `${path}.encoding`, `"${encoding}" needs exactly ${required} bytes, but ${indexes.length} byte index(es) are declared`);
+  }
+  if (required === undefined && indexes.length > MAX_INTEGER_BYTES) {
+    throw customDeviceError(id, `${path}.byteIndexes`, `reads ${indexes.length} bytes; an integer field may read at most ${MAX_INTEGER_BYTES} bytes so the value stays exact in a JavaScript number`);
+  }
+  const outOfFrame = indexes.filter(i => i >= minLengthBytes);
+  if (outOfFrame.length > 0) {
+    throw customDeviceError(id, `${path}.byteIndexes`, `reads byte ${outOfFrame[0]}, which frame.minLengthBytes (${minLengthBytes}) does not guarantee is present`);
+  }
+};
+const assertArithmetic = (id, path, field) => {
+  const scale = field.scale ?? 1;
+  if (!Number.isFinite(scale) || scale === 0) {
+    throw customDeviceError(id, `${path}.scale`, "must be a finite, non-zero number");
+  }
+  if (!Number.isFinite(field.offset ?? 0)) {
+    throw customDeviceError(id, `${path}.offset`, "must be a finite number");
+  }
+  const decimals = field.decimals;
+  if (decimals !== undefined && (!Number.isInteger(decimals) || decimals < 0 || decimals > 6)) {
+    throw customDeviceError(id, `${path}.decimals`, "must be a whole number between 0 and 6");
+  }
+};
+
+/** Validates one declared field against the measurement catalog and resolves its defaults. */
+export const compileCustomField = (id, path, field, measurementTypeKey, minLengthBytes) => {
+  const catalog = measurementFieldCatalog[measurementTypeKey];
+  const known = catalog?.[field.name];
+  if (!catalog || !known) {
+    throw customDeviceError(id, `${path}.name`, `"${field.name}" is not a property of ${measurementTypeKey}; expected one of ${Object.keys(catalog ?? {}).join(", ")}`);
+  }
+  if (field.unit !== known.unit) {
+    throw customDeviceError(id, `${path}.unit`, `is "${field.unit}"; expected "${known.unit}", the canonical unit of ${field.name}. Convert with scale instead of changing the unit`);
+  }
+  assertByteIndexes(id, path, field, minLengthBytes);
+  assertArithmetic(id, path, field);
+  const min = field.min ?? known.min;
+  const max = field.max ?? known.max;
+  if (!Number.isFinite(min) || !Number.isFinite(max) || min >= max) {
+    throw customDeviceError(id, `${path}`, `declares min ${min} and max ${max}; min must be below max`);
+  }
+  if (min < known.min || max > known.max) {
+    throw customDeviceError(id, `${path}`, `declares ${min}-${max} ${known.unit}, which is outside the accepted range for ${field.name} (${known.min}-${known.max} ${known.unit})`);
+  }
+  const indexes = [...field.byteIndexes];
+  return {
+    name: field.name,
+    byteIndexes: field.byteOrder === "little" ? indexes.reverse() : indexes,
+    encoding: field.encoding ?? "uint",
+    scale: field.scale ?? 1,
+    offset: field.offset ?? 0,
+    decimals: field.decimals,
+    unit: known.unit,
+    min,
+    max
+  };
+};
+//# sourceMappingURL=compile-custom-field.js.map

package/lib/module/modules/bt-management/services/custom/compile-custom-field.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["measurementFieldCatalog","customDeviceError","MAX_INTEGER_BYTES","WIDTHS","sfloat","float","assertByteIndexes","id","path","field","minLengthBytes","indexes","byteIndexes","Array","isArray","length","some","i","Number","isInteger","Set","size","encoding","required","undefined","outOfFrame","filter","assertArithmetic","scale","isFinite","offset","decimals","compileCustomField","measurementTypeKey","catalog","known","name","Object","keys","join","unit","min","max","byteOrder","reverse"],"sourceRoot":"../../../../../../src","sources":["modules/bt-management/services/custom/compile-custom-field.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/custom/compile-custom-frame.js

@@ -0,0 +1,59 @@
+"use strict";
+
+import { customDeviceError } from "./custom-device-error.js";
+const HEX_BYTE = /^[0-9a-f]{2}$/;
+
+/**
+ * Checks that a frame declaration can actually recognise a complete package, and returns a
+ * frozen, lower-cased copy of it.
+ *
+ * The copy matters twice. The received buffer is always lower-case hex, so a header declared
+ * as ["AA","55"] would never match and the device would silently produce nothing until the
+ * stuck-data timeout. And the runtime must not read an object the caller still holds a
+ * reference to: mutating the declaration after registration would otherwise move byte offsets
+ * that were bounds-checked at registration.
+ */
+export const compileCustomFrame = (id, path, frame) => {
+  const minLengthBytes = frame?.minLengthBytes;
+  if (!Number.isInteger(minLengthBytes) || minLengthBytes < 1) {
+    throw customDeviceError(id, `${path}.minLengthBytes`, "must be a whole number of at least 1");
+  }
+  const declaredHeader = frame.header ?? [];
+  if (!Array.isArray(declaredHeader)) {
+    throw customDeviceError(id, `${path}.header`, "must be a list of hex bytes");
+  }
+  const header = declaredHeader.map(byte => String(byte).toLowerCase());
+  if (header.some(byte => !HEX_BYTE.test(byte))) {
+    throw customDeviceError(id, `${path}.header`, 'must be a list of single hex bytes, e.g. ["aa", "55"]');
+  }
+  if (header.length > minLengthBytes) {
+    throw customDeviceError(id, `${path}.header`, `is ${header.length} bytes, which does not fit inside minLengthBytes (${minLengthBytes})`);
+  }
+  const length = frame.length;
+  if (!length) {
+    return Object.freeze({
+      header: Object.freeze(header),
+      minLengthBytes
+    });
+  }
+  if (!Number.isInteger(length.index) || length.index < 0) {
+    throw customDeviceError(id, `${path}.length.index`, "must be a byte offset of at least 0");
+  }
+  if (length.widthBytes !== 1 && length.widthBytes !== 2) {
+    throw customDeviceError(id, `${path}.length.widthBytes`, "must be 1 or 2");
+  }
+  if (!Number.isInteger(length.overheadBytes) || length.overheadBytes < 0) {
+    throw customDeviceError(id, `${path}.length.overheadBytes`, "must be a whole number of at least 0");
+  }
+  if (length.index + length.widthBytes > minLengthBytes) {
+    throw customDeviceError(id, `${path}.length`, `reads bytes ${length.index}-${length.index + length.widthBytes - 1}, which frame.minLengthBytes (${minLengthBytes}) does not guarantee are present`);
+  }
+  return Object.freeze({
+    header: Object.freeze(header),
+    minLengthBytes,
+    length: Object.freeze({
+      ...length
+    })
+  });
+};
+//# sourceMappingURL=compile-custom-frame.js.map

package/lib/module/modules/bt-management/services/custom/compile-custom-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["customDeviceError","HEX_BYTE","compileCustomFrame","id","path","frame","minLengthBytes","Number","isInteger","declaredHeader","header","Array","isArray","map","byte","String","toLowerCase","some","test","length","Object","freeze","index","widthBytes","overheadBytes"],"sourceRoot":"../../../../../../src","sources":["modules/bt-management/services/custom/compile-custom-frame.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/custom/compile-custom-monitor.js

@@ -0,0 +1,71 @@
+"use strict";
+
+import { compileCustomCase } from "./compile-custom-case.js";
+import { compileCustomFrame } from "./compile-custom-frame.js";
+import { customDeviceError } from "./custom-device-error.js";
+import { normalizeBleUuid } from "./normalize-ble-uuid.js";
+const HEX = /^[0-9a-f]*$/;
+const assertSelectorBytes = (id, path, monitor, frame) => {
+  const selectorBytes = monitor.caseSelectorBytes;
+  if (selectorBytes === undefined) {
+    if (monitor.cases.length !== 1 || monitor.cases[0]?.selector !== "") {
+      throw customDeviceError(id, `${path}.caseSelectorBytes`, "is required unless the characteristic has exactly one case with an empty selector");
+    }
+    return [];
+  }
+  if (!Array.isArray(selectorBytes) || selectorBytes.length === 0 || selectorBytes.some(i => !Number.isInteger(i) || i < 0)) {
+    throw customDeviceError(id, `${path}.caseSelectorBytes`, "must be a non-empty list of byte offsets that are integers of at least 0");
+  }
+  const outOfFrame = selectorBytes.filter(i => i >= frame.minLengthBytes);
+  if (outOfFrame.length > 0) {
+    throw customDeviceError(id, `${path}.caseSelectorBytes`, `reads byte ${outOfFrame[0]}, which frame.minLengthBytes (${frame.minLengthBytes}) does not guarantee is present`);
+  }
+  return selectorBytes;
+};
+const assertSelector = (id, path, selector, selectorBytes, seen) => {
+  const value = String(selector ?? "").toLowerCase();
+  const expected = selectorBytes.length * 2;
+  if (!HEX.test(value)) {
+    throw customDeviceError(id, `${path}.selector`, `is "${selector}", which is not hex`);
+  }
+  if (value.length !== expected) {
+    throw customDeviceError(id, `${path}.selector`, `is ${value.length} hex digits but caseSelectorBytes declares ${selectorBytes.length} byte(s), so it must be ${expected}`);
+  }
+  if (seen.has(value)) {
+    throw customDeviceError(id, `${path}.selector`, `has the same selector "${value}" as an earlier case, which would silently shadow it`);
+  }
+  seen.add(value);
+};
+
+/** Validates one notify characteristic and turns it into a parsing model and a frame. */
+export const compileCustomMonitor = (id, path, monitor, fields) => {
+  if (typeof monitor !== "object" || monitor === null) {
+    throw customDeviceError(id, path, "must be a monitor characteristic object");
+  }
+  const uuid = normalizeBleUuid(id, `${path}.uuid`, monitor.uuid);
+  const frame = compileCustomFrame(id, `${path}.frame`, monitor.frame);
+  if (!Array.isArray(monitor.cases) || monitor.cases.length === 0) {
+    throw customDeviceError(id, `${path}.cases`, "must declare at least one case");
+  }
+  const selectorBytes = assertSelectorBytes(id, path, monitor, frame);
+  const seen = new Set();
+  const cases = monitor.cases.map((caseSpec, index) => {
+    const casePath = `${path}.cases[${index}]`;
+    if (typeof caseSpec !== "object" || caseSpec === null) {
+      throw customDeviceError(id, casePath, "must be a case object");
+    }
+    assertSelector(id, casePath, caseSpec.selector, selectorBytes, seen);
+    return compileCustomCase(id, casePath, caseSpec, frame.minLengthBytes, fields);
+  });
+  return {
+    characteristic: {
+      uuid,
+      parsingModel: {
+        caseValuePosition: selectorBytes.length > 0 ? selectorBytes : undefined,
+        cases
+      }
+    },
+    frame
+  };
+};
+//# sourceMappingURL=compile-custom-monitor.js.map

package/lib/module/modules/bt-management/services/custom/compile-custom-monitor.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["compileCustomCase","compileCustomFrame","customDeviceError","normalizeBleUuid","HEX","assertSelectorBytes","id","path","monitor","frame","selectorBytes","caseSelectorBytes","undefined","cases","length","selector","Array","isArray","some","i","Number","isInteger","outOfFrame","filter","minLengthBytes","assertSelector","seen","value","String","toLowerCase","expected","test","has","add","compileCustomMonitor","fields","uuid","Set","map","caseSpec","index","casePath","characteristic","parsingModel","caseValuePosition"],"sourceRoot":"../../../../../../src","sources":["modules/bt-management/services/custom/compile-custom-monitor.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/custom/custom-device-error.js

@@ -0,0 +1,8 @@
+"use strict";
+
+/**
+ * Every registration failure names the exact position in the declaration, because the
+ * author is looking at a datasheet and needs to know which line of it is wrong.
+ */
+export const customDeviceError = (id, path, message) => new Error(`Custom device "${id}": ${path} ${message}`);
+//# sourceMappingURL=custom-device-error.js.map

package/lib/module/modules/bt-management/services/custom/custom-device-error.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["customDeviceError","id","path","message","Error"],"sourceRoot":"../../../../../../src","sources":["modules/bt-management/services/custom/custom-device-error.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,OAAO,MAAMA,iBAAiB,GAAGA,CAC/BC,EAAU,EACVC,IAAY,EACZC,OAAe,KACL,IAAIC,KAAK,CAAC,kBAAkBH,EAAE,MAAMC,IAAI,IAAIC,OAAO,EAAE,CAAC","ignoreList":[]}

package/lib/module/modules/bt-management/services/custom/define-custom-device.js

@@ -0,0 +1,115 @@
+"use strict";
+
+import { CUSTOM_DEVICE_BRAND } from "../../constants/custom-device-brand.js";
+import { IntegratedDevices } from "../../types/integrated-devices.js";
+import { compileCustomMonitor } from "./compile-custom-monitor.js";
+import { customDeviceError } from "./custom-device-error.js";
+import { normalizeBleUuid } from "./normalize-ble-uuid.js";
+const MIN_STUCK_TIMEOUT_MS = 1_000;
+
+// The SDK's own F4 scale waits this long, because it sleeps while still connected.
+const MAX_STUCK_TIMEOUT_MS = 6_000_000;
+const HEX_BYTES = /^([0-9a-f]{2})+$/;
+const assertIdentity = spec => {
+  const id = typeof spec?.id === "string" ? spec.id.trim() : "";
+  if (!id) {
+    throw customDeviceError(String(spec?.id), "id", "must not be empty");
+  }
+  const builtIn = Object.values(IntegratedDevices).find(name => name.toLowerCase() === id.toLowerCase());
+  if (builtIn) {
+    throw customDeviceError(id, "id", `collides with the built-in device "${builtIn}"`);
+  }
+  return id;
+};
+const compileNameMatch = (id, spec) => {
+  const nameMatch = spec.nameMatch;
+  if (nameMatch instanceof RegExp) {
+    if (nameMatch.global || nameMatch.sticky) {
+      throw customDeviceError(id, "nameMatch", `must not use the ${nameMatch.global ? "global" : "sticky"} flag, because it makes RegExp.test advance lastIndex and alternate between true and false across scan results`);
+    }
+    return nameMatch;
+  }
+  const exact = typeof nameMatch === "string" ? nameMatch.trim() : "";
+  if (!exact) {
+    throw customDeviceError(id, "nameMatch", "must not be empty");
+  }
+  return new RegExp(`^${exact.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}$`);
+};
+const assertStuckTimeout = (id, spec) => {
+  const timeout = spec.stuckDataTimeoutMs;
+  if (!Number.isInteger(timeout) || timeout < MIN_STUCK_TIMEOUT_MS || timeout > MAX_STUCK_TIMEOUT_MS) {
+    throw customDeviceError(id, "stuckDataTimeoutMs", `must be a whole number of milliseconds between ${MIN_STUCK_TIMEOUT_MS} and ${MAX_STUCK_TIMEOUT_MS}`);
+  }
+  return timeout;
+};
+const compileWrite = (id, path, write) => {
+  if (!write) {
+    return undefined;
+  }
+  const commandHex = String(write.commandHex ?? "").toLowerCase();
+  if (!HEX_BYTES.test(commandHex)) {
+    throw customDeviceError(id, `${path}.write.commandHex`, `is "${write.commandHex}"; it must be an even number of hex digits`);
+  }
+  return {
+    uuid: normalizeBleUuid(id, `${path}.write.uuid`, write.uuid),
+    mainCommandUuid: commandHex
+  };
+};
+
+/**
+ * Validates a declaration and compiles it into a runnable device.
+ *
+ * Every rule the declarative decoder relies on is checked here, at registration, because the
+ * alternative is a plausible wrong number at read time. Registration fails loudly - it
+ * throws, naming the exact position in the declaration - and a device that fails to compile
+ * is never scanned for.
+ */
+export const defineCustomDevice = spec => {
+  const id = assertIdentity(spec);
+  const nameMatch = compileNameMatch(id, spec);
+  const stuckDataTimeout = assertStuckTimeout(id, spec);
+  if (!Array.isArray(spec.services) || spec.services.length === 0) {
+    throw customDeviceError(id, "services", "must declare at least one service");
+  }
+  const fields = new Map();
+  const frames = new Map();
+  const seenCharacteristics = new Set();
+  const mainServices = spec.services.map((service, serviceIndex) => {
+    const path = `services[${serviceIndex}]`;
+    if (typeof service !== "object" || service === null) {
+      throw customDeviceError(id, path, "must be a service object");
+    }
+    if (!Array.isArray(service.monitor) || service.monitor.length === 0) {
+      throw customDeviceError(id, `${path}.monitor`, "must declare at least one monitor characteristic");
+    }
+    const monitorUuids = service.monitor.map((monitor, monitorIndex) => {
+      const monitorPath = `${path}.monitor[${monitorIndex}]`;
+      const {
+        characteristic,
+        frame
+      } = compileCustomMonitor(id, monitorPath, monitor, fields);
+      if (seenCharacteristics.has(characteristic.uuid)) {
+        throw customDeviceError(id, `${monitorPath}.uuid`, `is declared twice; a characteristic may appear only once`);
+      }
+      seenCharacteristics.add(characteristic.uuid);
+      frames.set(characteristic.uuid, frame);
+      return characteristic;
+    });
+    return {
+      uuid: normalizeBleUuid(id, `${path}.uuid`, service.uuid),
+      monitorUuids,
+      writeUuid: compileWrite(id, path, service.write)
+    };
+  });
+  return {
+    [CUSTOM_DEVICE_BRAND]: true,
+    id: id,
+    spec,
+    nameMatch,
+    mainServices,
+    stuckDataTimeout,
+    fields,
+    frames
+  };
+};
+//# sourceMappingURL=define-custom-device.js.map

package/lib/module/modules/bt-management/services/custom/define-custom-device.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CUSTOM_DEVICE_BRAND","IntegratedDevices","compileCustomMonitor","customDeviceError","normalizeBleUuid","MIN_STUCK_TIMEOUT_MS","MAX_STUCK_TIMEOUT_MS","HEX_BYTES","assertIdentity","spec","id","trim","String","builtIn","Object","values","find","name","toLowerCase","compileNameMatch","nameMatch","RegExp","global","sticky","exact","replace","assertStuckTimeout","timeout","stuckDataTimeoutMs","Number","isInteger","compileWrite","path","write","undefined","commandHex","test","uuid","mainCommandUuid","defineCustomDevice","stuckDataTimeout","Array","isArray","services","length","fields","Map","frames","seenCharacteristics","Set","mainServices","map","service","serviceIndex","monitor","monitorUuids","monitorIndex","monitorPath","characteristic","frame","has","add","set","writeUuid"],"sourceRoot":"../../../../../../src","sources":["modules/bt-management/services/custom/define-custom-device.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/custom/normalize-ble-uuid.js

@@ -0,0 +1,27 @@
+"use strict";
+
+import { customDeviceError } from "./custom-device-error.js";
+const BASE_UUID_SUFFIX = "-0000-1000-8000-00805f9b34fb";
+const SHORT = /^[0-9a-f]{4}$/;
+const MEDIUM = /^[0-9a-f]{8}$/;
+const FULL = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
+
+/**
+ * Accepts a 16-bit, 32-bit or 128-bit UUID and returns the 128-bit form, because that is
+ * what react-native-ble-plx reports back on a notification and what the parsing model is
+ * matched against.
+ */
+export const normalizeBleUuid = (id, path, value) => {
+  const raw = typeof value === "string" ? value.trim().toLowerCase() : "";
+  if (SHORT.test(raw)) {
+    return `0000${raw}${BASE_UUID_SUFFIX}`;
+  }
+  if (MEDIUM.test(raw)) {
+    return `${raw}${BASE_UUID_SUFFIX}`;
+  }
+  if (FULL.test(raw)) {
+    return raw;
+  }
+  throw customDeviceError(id, path, `is "${String(value)}", which is not a 16-bit, 32-bit or 128-bit Bluetooth UUID`);
+};
+//# sourceMappingURL=normalize-ble-uuid.js.map

package/lib/module/modules/bt-management/services/custom/normalize-ble-uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["customDeviceError","BASE_UUID_SUFFIX","SHORT","MEDIUM","FULL","normalizeBleUuid","id","path","value","raw","trim","toLowerCase","test","String"],"sourceRoot":"../../../../../../src","sources":["modules/bt-management/services/custom/normalize-ble-uuid.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAAQ,0BAAuB;AAEzD,MAAMC,gBAAgB,GAAG,8BAA8B;AACvD,MAAMC,KAAK,GAAG,eAAe;AAC7B,MAAMC,MAAM,GAAG,eAAe;AAE9B,MAAMC,IAAI,GACR,gEAAgE;;AAElE;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,gBAAgB,GAAGA,CAC9BC,EAAU,EACVC,IAAY,EACZC,KAAc,KACH;EACX,MAAMC,GAAG,GAAG,OAAOD,KAAK,KAAK,QAAQ,GAAGA,KAAK,CAACE,IAAI,CAAC,CAAC,CAACC,WAAW,CAAC,CAAC,GAAG,EAAE;EAEvE,IAAIT,KAAK,CAACU,IAAI,CAACH,GAAG,CAAC,EAAE;IACnB,OAAO,OAAOA,GAAG,GAAGR,gBAAgB,EAAE;EACxC;EAEA,IAAIE,MAAM,CAACS,IAAI,CAACH,GAAG,CAAC,EAAE;IACpB,OAAO,GAAGA,GAAG,GAAGR,gBAAgB,EAAE;EACpC;EAEA,IAAIG,IAAI,CAACQ,IAAI,CAACH,GAAG,CAAC,EAAE;IAClB,OAAOA,GAAG;EACZ;EAEA,MAAMT,iBAAiB,CACrBM,EAAE,EACFC,IAAI,EACJ,OAAOM,MAAM,CAACL,KAAK,CAAC,4DACtB,CAAC;AACH,CAAC","ignoreList":[]}

package/lib/module/modules/bt-management/services/device-creator.js

@@ -2,28 +2,55 @@
 
 import { integratedDevicesMap } from "../constants/integrated-devices-map.js";
 import { IntegratedDevices } from "../types/integrated-devices.js";
+import { isCustomDeviceDefinition } from "../utils/is-custom-device-definition.js";
 import { BC01Device } from "./devices/bc01/bc01.device.js";
 import { BP2Device } from "./devices/bp2/bp2.device.js";
+import { CustomDevice } from "./devices/custom/custom.device.js";
 import { F4Device } from "./devices/f4/f4.device.js";
 import { SPO2Device } from "./devices/spo/spo2.device.js";
+const collectCustomDevices = acceptedDevices => {
+  const customDevices = new Map();
+  const matchers = new Set();
+  acceptedDevices.forEach((entry, index) => {
+    if (typeof entry === "string") {
+      return;
+    }
+    if (!isCustomDeviceDefinition(entry)) {
+      throw new Error(`acceptedDevices[${index}] is not a device registered with defineCustomDevice`);
+    }
+    if (customDevices.has(entry.id)) {
+      throw new Error(`acceptedDevices[${index}] registers the custom device "${entry.id}" twice`);
+    }
+    if (matchers.has(entry.nameMatch.source)) {
+      throw new Error(`acceptedDevices[${index}] ("${entry.id}") matches the same advertised name as an earlier custom device, so one would silently shadow the other`);
+    }
+    customDevices.set(entry.id, entry);
+    matchers.add(entry.nameMatch.source);
+  });
+  return customDevices;
+};
 export class DeviceCreator {
   deviceNameCache = new Map();
   CACHE_MAX_SIZE = 100;
   constructor(acceptedDeviceNames) {
     this.acceptedDeviceNames = acceptedDeviceNames;
+    this.customDevices = collectCustomDevices(acceptedDeviceNames);
   }
   getDeviceName = foundName => {
-    const deviceName = this.getIntegratedDeviceName(foundName);
-    if (!deviceName) {
-      return;
+    if (!foundName) {
+      return undefined;
     }
-    if (!this.acceptedDeviceNames.some(name => name === deviceName)) {
-      return;
+    if (this.deviceNameCache.has(foundName)) {
+      return this.deviceNameCache.get(foundName) ?? undefined;
     }
-    return deviceName;
+    const matched = this.matchDeviceName(foundName);
+
+    // Cache the result (store null for non-matches to avoid repeated tests)
+    this.cacheDeviceName(foundName, matched ?? null);
+    return matched;
   };
   createDevice(params) {
-    if (!params.deviceName.trim()) {
+    if (!String(params.deviceName ?? "").trim()) {
       throw new Error("Device name is required");
     }
     if (!params.device) {
@@ -35,6 +62,11 @@ export class DeviceCreator {
     if (!params.device.id) {
       throw new Error("Device ID is required");
     }
+    const custom = this.customDevices.get(params.deviceName);
+    if (custom) {
+      // @ts-expect-error - the caller asked for this custom device by its own id
+      return new CustomDevice(params.device, params, custom);
+    }
     const deviceMap = {
       [IntegratedDevices.BP2]: BP2Device,
       [IntegratedDevices.F4]: F4Device,
@@ -52,29 +84,23 @@ export class DeviceCreator {
   destroy = () => {
     this.deviceNameCache.clear();
   };
-  getIntegratedDeviceName = deviceName => {
-    if (!deviceName) {
-      return undefined;
-    }
-
-    // Check cache first
-    if (this.deviceNameCache.has(deviceName)) {
-      const cached = this.deviceNameCache.get(deviceName);
-      return cached ?? undefined;
-    }
 
-    // Not in cache - test regexes with early return
-    let matchedDevice;
+  /**
+   * A built-in device always wins over a declaration: its decoder is compiled and tested,
+   * and a declaration that happens to match the same advertised name must not displace it.
+   */
+  matchDeviceName = deviceName => {
     for (const [regex, deviceType] of integratedDevicesMap) {
-      if (regex.test(deviceName)) {
-        matchedDevice = deviceType;
-        break; // Early return!
+      if (regex.test(deviceName) && this.acceptedDeviceNames.some(name => name === deviceType)) {
+        return deviceType;
       }
     }
-
-    // Cache result (store null for non-matches to avoid repeated tests)
-    this.cacheDeviceName(deviceName, matchedDevice ?? null);
-    return matchedDevice;
+    for (const custom of this.customDevices.values()) {
+      if (custom.nameMatch.test(deviceName)) {
+        return custom.id;
+      }
+    }
+    return undefined;
   };
   cacheDeviceName(deviceName, deviceType) {
     // Implement simple LRU by clearing oldest entries when cache is full

package/lib/module/modules/bt-management/services/device-creator.js.map

@@ -1 +1 @@
-{"version":3,"names":["integratedDevicesMap","IntegratedDevices","BC01Device","BP2Device","F4Device","SPO2Device","DeviceCreator","deviceNameCache","Map","CACHE_MAX_SIZE","constructor","acceptedDeviceNames","getDeviceName","foundName","deviceName","getIntegratedDeviceName","some","name","createDevice","params","trim","Error","device","id","deviceMap","BP2","F4","PC60WF","BC01","deviceClass","destroy","clear","undefined","has","cached","get","matchedDevice","regex","deviceType","test","cacheDeviceName","size","firstKey","keys","next","value","delete","set"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/services/device-creator.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["integratedDevicesMap","IntegratedDevices","isCustomDeviceDefinition","BC01Device","BP2Device","CustomDevice","F4Device","SPO2Device","collectCustomDevices","acceptedDevices","customDevices","Map","matchers","Set","forEach","entry","index","Error","has","id","nameMatch","source","set","add","DeviceCreator","deviceNameCache","CACHE_MAX_SIZE","constructor","acceptedDeviceNames","getDeviceName","foundName","undefined","get","matched","matchDeviceName","cacheDeviceName","createDevice","params","String","deviceName","trim","device","name","custom","deviceMap","BP2","F4","PC60WF","BC01","deviceClass","destroy","clear","regex","deviceType","test","some","values","size","firstKey","keys","next","value","delete"],"sourceRoot":"../../../../../src","sources":["modules/bt-management/services/device-creator.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/modules/bt-management/services/devices/bt-data-processor.js

@@ -4,7 +4,16 @@ import { CaseType } from "../../types/case-type.js";
 import { DeviceStatus } from "../../types/device-status.js";
 import { parseMeasurement } from "../../utils/parse-measurement.js";
 export class BTDataProcessor {
-  collectedValues = [];
+  /**
+   * One buffer per characteristic.
+   *
+   * A frame that is still incomplete stays buffered until the rest of it arrives, so a
+   * shared buffer would prepend one characteristic's leftover bytes to the next
+   * characteristic's notification. Every declared byte offset is absolute, so that frame
+   * would then be decoded at a shifted offset - a plausible wrong reading rather than an
+   * error. Keeping the buffers apart makes that impossible.
+   */
+  buffers = new Map();
   isMeasuring = false;
   constructor(device, mainServices, stuckDataTimeoutDuration, callbacks) {
     this.device = device;
@@ -12,16 +21,24 @@ export class BTDataProcessor {
     this.stuckDataTimeoutDuration = stuckDataTimeoutDuration;
     this.callbacks = callbacks;
   }
+  get collectedValues() {
+    return this.buffers.get(this.currentUuid) ?? [];
+  }
+  currentUuid = "";
   destroy = () => {
-    this.collectedValues = [];
+    this.buffers.clear();
+    this.currentUuid = "";
     this.isMeasuring = false;
     clearTimeout(this.stuckDataTimeout);
     this.stuckDataTimeout = undefined;
   };
   processData = (uuid, hexValue) => {
-    this.collectedValues.push(...hexValue);
+    this.currentUuid = String(uuid ?? "").toLowerCase();
+    const buffer = this.buffers.get(this.currentUuid) ?? [];
+    buffer.push(...hexValue);
+    this.buffers.set(this.currentUuid, buffer);
     this.startStuckTimeout();
-    const isValid = this.callbacks.validatePackage(this.collectedValues, uuid);
+    const isValid = this.callbacks.validatePackage(buffer, uuid);
     if (!isValid) {
       return;
     }
@@ -111,7 +128,7 @@ export class BTDataProcessor {
     }
   }
   resetDataAndSendCommandToDevice = () => {
-    this.collectedValues = [];
+    this.buffers.set(this.currentUuid, []);
     this.callbacks.onSendCommandToDevice?.();
   };
   startStuckTimeout = () => {