@depz/sensor-sdk 0.1.0

package/dist/discovery.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Device discovery & selection (contract 02 §4).
+ *
+ * The engine here is transport-agnostic: it takes an enumerated list of
+ * candidate ports plus a factory that turns a port into a (not-yet-open)
+ * `SerialTransport`. The Node entry (`@depz/sensor-sdk/node`) wires it to
+ * `serialport`; the browser entry (`@depz/sensor-sdk/web`) wires it to
+ * granted WebSerial ports. Both expose `openDevice` / `listDepzDevices`.
+ *
+ * Selection is by USB identity (`usb-ids.ts`) — never "first port in system
+ * order", which could grab an unrelated `/dev/ttyS0`. Mirrors the Python
+ * reference `depz_sensor_sdk.discovery`.
+ */
+import { DepzDevice } from "./device/device.js";
+import { type SensorType } from "./protocol/identity.js";
+import type { SerialTransport } from "./transport/types.js";
+/** One enumerated candidate port (Node: serialport.list; Web: granted port). */
+export interface DepzPortInfo {
+    /** Stable identifier: an OS path (Node) or a synthetic id (WebSerial). */
+    path: string;
+    /**
+     * USB iSerial as reported by the OS — the sort/selection key. WebSerial
+     * cannot read this, so it is undefined there (selection falls back to
+     * granted-port order).
+     */
+    serialNumber?: string;
+    usbVid?: number;
+    usbPid?: number;
+}
+/** Result of probing a port (parity with Python `DeviceInfo`). */
+export interface DeviceInfo {
+    path: string;
+    mode: "app" | "bootloader" | "unknown";
+    sensorType: SensorType | null;
+    softwareName: string;
+    fwVersion: string;
+    deviceName: string;
+    /** Device-reported serial (GET_SERIAL); "" when the device does not answer. */
+    serialNumber: string;
+    usbVid: number | null;
+    usbPid: number | null;
+}
+/** Turns an enumerated port into a fresh, not-yet-open transport. */
+export type TransportFactory = (port: DepzPortInfo) => SerialTransport;
+export interface OpenDeviceOptions {
+    /** Select the candidate whose USB iSerial equals this exact string. */
+    serial?: string;
+    /** Per-request timeout for the probe and the opened device (ms). */
+    timeoutMs?: number;
+}
+export interface ListOptions {
+    /** Probe only ports with a known DEPZ (vid,pid) (default). */
+    matchUsb?: boolean;
+    timeoutMs?: number;
+}
+/** `undefined` = auto; number = Nth candidate; string = port path; DeviceInfo = its port. */
+export type OpenTarget = number | string | DeviceInfo | null | undefined;
+/**
+ * Sort ports by USB iSerial ascending; empty/missing serials sort last, ties
+ * broken by path. Pure and deterministic — a given bench always maps the same
+ * serial to index 0. Exposed so the ordering rule can be golden-tested.
+ */
+export declare function orderPortsBySerial(ports: DepzPortInfo[]): DepzPortInfo[];
+export declare function isDeviceInfo(t: unknown): t is DeviceInfo;
+/**
+ * Order *probed* devices by their DEVICE-reported serial (GET_SERIAL, i.e.
+ * `DeviceInfo.serialNumber`); empty serials sort last, ties broken by path.
+ * This is the selection key for transports that cannot read the USB iSerial
+ * (WebSerial), where the serial is only knowable by probing.
+ */
+export declare function orderDevicesBySerial(infos: DeviceInfo[]): DeviceInfo[];
+/**
+ * Open `port`, ask its identity (+ device name/serial), then close. Returns
+ * null when nothing DEPZ-shaped answers. Probing *opens* the port, so callers
+ * should restrict the port list to plausible candidates.
+ */
+export declare function probePort(port: DepzPortInfo, factory: TransportFactory, timeoutMs?: number): Promise<DeviceInfo | null>;
+/**
+ * Probe candidate ports and return every DEPZ device found, in selection
+ * order (sorted by USB iSerial). With `matchUsb` (default) only ports with a
+ * known DEPZ (vid,pid) are probed.
+ */
+export declare function listDepzDevicesFrom(ports: DepzPortInfo[], factory: TransportFactory, opts?: ListOptions): Promise<DeviceInfo[]>;
+/**
+ * Open the right sensor class for `target` (contract 02 §4).
+ *
+ * - `undefined`/`null`: the candidate with the alphabetically-smallest USB
+ *   iSerial (or the one whose serial == `opts.serial`). No candidate → throws
+ *   `NoDepzDeviceError` (never falls back to "first port in system").
+ * - `number N`: the Nth candidate, sorted by USB iSerial (0-based). Out of
+ *   range → `NoDepzDeviceError`.
+ * - `string`: open exactly that port path; warns if its (vid,pid) is not a
+ *   known DEPZ id (may be an unprogrammed unit).
+ * - `DeviceInfo`: opens its `.path`.
+ */
+export declare function openDeviceFrom(ports: DepzPortInfo[], factory: TransportFactory, target?: OpenTarget, opts?: OpenDeviceOptions): Promise<DepzDevice>;
+/**
+ * Select and open a device by its DEVICE-reported serial (GET_SERIAL), for
+ * transports that cannot enumerate USB iSerials (WebSerial). Probes every
+ * given port (open → GET_SERIAL → close), orders the answers by device
+ * serial, then selects — `opts.serial` picks an exact match, a numeric
+ * `target` picks the Nth, otherwise the smallest serial — and reopens it.
+ *
+ * The probing cost (opening each granted port once) is the price of not
+ * having USB iSerials up front; the *result* matches Node's serial-based
+ * selection because for programmed units USB iSerial == device serial.
+ */
+export declare function openDeviceByDeviceSerial(ports: DepzPortInfo[], factory: TransportFactory, target?: number | null, opts?: OpenDeviceOptions): Promise<DepzDevice>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAEhD,OAAO,EAAqB,KAAK,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAK5E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,gFAAgF;AAChF,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,YAAY,GAAG,SAAS,CAAC;IACvC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,qEAAqE;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,YAAY,KAAK,eAAe,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,6FAA6F;AAC7F,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,IAAI,GAAG,SAAS,CAAC;AAUzE;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,GAAG,YAAY,EAAE,CAUxE;AAUD,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,UAAU,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAQtE;AAID;;;;GAIG;AACH,wBAAsB,SAAS,CAC7B,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,gBAAgB,EACzB,SAAS,SAA2B,GACnC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA4C5B;AAID;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,gBAAgB,EACzB,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,UAAU,EAAE,CAAC,CAUvB;AA0CD;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,UAAU,EACnB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,UAAU,CAAC,CA4DrB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,YAAY,EAAE,EACrB,OAAO,EAAE,gBAAgB,EACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,IAAI,GAAE,iBAAsB,GAC3B,OAAO,CAAC,UAAU,CAAC,CAwBrB"}

package/dist/discovery.js

@@ -0,0 +1,281 @@
+/**
+ * Device discovery & selection (contract 02 §4).
+ *
+ * The engine here is transport-agnostic: it takes an enumerated list of
+ * candidate ports plus a factory that turns a port into a (not-yet-open)
+ * `SerialTransport`. The Node entry (`@depz/sensor-sdk/node`) wires it to
+ * `serialport`; the browser entry (`@depz/sensor-sdk/web`) wires it to
+ * granted WebSerial ports. Both expose `openDevice` / `listDepzDevices`.
+ *
+ * Selection is by USB identity (`usb-ids.ts`) — never "first port in system
+ * order", which could grab an unrelated `/dev/ttyS0`. Mirrors the Python
+ * reference `depz_sensor_sdk.discovery`.
+ */
+import { DepzDevice } from "./device/device.js";
+import { DepzError, NoDepzDeviceError } from "./errors.js";
+import { parseSoftwareName } from "./protocol/identity.js";
+import { isKnownDepzUsb, usbModelHint } from "./protocol/usb-ids.js";
+import { Bno086 } from "./sensors/bno086/bno086.js";
+import { Sr04 } from "./sensors/sr04.js";
+import { Vl53l8Ch, Vl53l8Cx } from "./sensors/vl53l8/vl53l8.js";
+const DEFAULT_PROBE_TIMEOUT_MS = 200;
+// ── selection helpers ─────────────────────────────────────────────────────────
+function isKnownPort(p) {
+    return isKnownDepzUsb(p.usbVid, p.usbPid);
+}
+/**
+ * Sort ports by USB iSerial ascending; empty/missing serials sort last, ties
+ * broken by path. Pure and deterministic — a given bench always maps the same
+ * serial to index 0. Exposed so the ordering rule can be golden-tested.
+ */
+export function orderPortsBySerial(ports) {
+    return ports.slice().sort((a, b) => {
+        const sa = a.serialNumber ?? "";
+        const sb = b.serialNumber ?? "";
+        const ea = sa === "" ? 1 : 0;
+        const eb = sb === "" ? 1 : 0;
+        if (ea !== eb)
+            return ea - eb;
+        if (sa !== sb)
+            return sa < sb ? -1 : 1;
+        return a.path < b.path ? -1 : a.path > b.path ? 1 : 0;
+    });
+}
+/**
+ * Candidate ports (known DEPZ vid/pid) sorted by USB iSerial (index 0 = the
+ * one auto-select opens).
+ */
+function sortedCandidates(ports) {
+    return orderPortsBySerial(ports.filter(isKnownPort));
+}
+export function isDeviceInfo(t) {
+    return typeof t === "object" && t !== null && "path" in t && "sensorType" in t;
+}
+/**
+ * Order *probed* devices by their DEVICE-reported serial (GET_SERIAL, i.e.
+ * `DeviceInfo.serialNumber`); empty serials sort last, ties broken by path.
+ * This is the selection key for transports that cannot read the USB iSerial
+ * (WebSerial), where the serial is only knowable by probing.
+ */
+export function orderDevicesBySerial(infos) {
+    return infos.slice().sort((a, b) => {
+        const ea = a.serialNumber === "" ? 1 : 0;
+        const eb = b.serialNumber === "" ? 1 : 0;
+        if (ea !== eb)
+            return ea - eb;
+        if (a.serialNumber !== b.serialNumber)
+            return a.serialNumber < b.serialNumber ? -1 : 1;
+        return a.path < b.path ? -1 : a.path > b.path ? 1 : 0;
+    });
+}
+// ── probing ───────────────────────────────────────────────────────────────────
+/**
+ * Open `port`, ask its identity (+ device name/serial), then close. Returns
+ * null when nothing DEPZ-shaped answers. Probing *opens* the port, so callers
+ * should restrict the port list to plausible candidates.
+ */
+export async function probePort(port, factory, timeoutMs = DEFAULT_PROBE_TIMEOUT_MS) {
+    const transport = factory(port);
+    let dev;
+    try {
+        dev = new DepzDevice(transport, { timeoutMs });
+        await dev.open();
+    }
+    catch {
+        try {
+            await transport.close();
+        }
+        catch {
+            /* already gone */
+        }
+        return null;
+    }
+    try {
+        const ident = parseSoftwareName(await dev.getSoftwareName());
+        let deviceName = "";
+        try {
+            deviceName = await dev.getDeviceName();
+        }
+        catch {
+            /* optional */
+        }
+        let serialNumber = "";
+        try {
+            serialNumber = await dev.getSerialNumber();
+        }
+        catch {
+            /* optional */
+        }
+        return {
+            path: port.path,
+            mode: ident.mode,
+            sensorType: ident.sensorType,
+            softwareName: ident.softwareName,
+            fwVersion: ident.version,
+            deviceName,
+            serialNumber,
+            usbVid: port.usbVid ?? null,
+            usbPid: port.usbPid ?? null,
+        };
+    }
+    catch {
+        return null;
+    }
+    finally {
+        await dev.close();
+    }
+}
+// ── list ──────────────────────────────────────────────────────────────────────
+/**
+ * Probe candidate ports and return every DEPZ device found, in selection
+ * order (sorted by USB iSerial). With `matchUsb` (default) only ports with a
+ * known DEPZ (vid,pid) are probed.
+ */
+export async function listDepzDevicesFrom(ports, factory, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+    const matchUsb = opts.matchUsb ?? true;
+    const scan = matchUsb ? sortedCandidates(ports) : ports.slice();
+    const found = [];
+    for (const port of scan) {
+        const info = await probePort(port, factory, timeoutMs);
+        if (info !== null)
+            found.push(info);
+    }
+    return found;
+}
+// ── open ──────────────────────────────────────────────────────────────────────
+function constructSensor(transport, sensorType, timeoutMs, port) {
+    switch (sensorType) {
+        case "sr04":
+            return new Sr04(transport, { timeoutMs });
+        case "vl53l8":
+            // The USB model hint distinguishes CH silicon (PID 0xED40 → 'vl53l8ch')
+            // from CX; the dev-default id (0x56DC) and the silicon id are
+            // indistinguishable, so those fall through to the CX base class.
+            return usbModelHint(port?.usbVid, port?.usbPid) === "vl53l8ch"
+                ? new Vl53l8Ch(transport, { timeoutMs })
+                : new Vl53l8Cx(transport, { timeoutMs });
+        case "bno086":
+            return new Bno086(transport, { timeoutMs });
+        default:
+            return new DepzDevice(transport, { timeoutMs });
+    }
+}
+async function openProbed(port, info, factory, timeoutMs) {
+    if (info.mode === "bootloader") {
+        throw new DepzError("device is in bootloader mode; use the bootloader client (contract 06)");
+    }
+    const transport = factory(port);
+    const dev = constructSensor(transport, info.sensorType, timeoutMs, port);
+    await dev.open();
+    return dev;
+}
+/**
+ * Open the right sensor class for `target` (contract 02 §4).
+ *
+ * - `undefined`/`null`: the candidate with the alphabetically-smallest USB
+ *   iSerial (or the one whose serial == `opts.serial`). No candidate → throws
+ *   `NoDepzDeviceError` (never falls back to "first port in system").
+ * - `number N`: the Nth candidate, sorted by USB iSerial (0-based). Out of
+ *   range → `NoDepzDeviceError`.
+ * - `string`: open exactly that port path; warns if its (vid,pid) is not a
+ *   known DEPZ id (may be an unprogrammed unit).
+ * - `DeviceInfo`: opens its `.path`.
+ */
+export async function openDeviceFrom(ports, factory, target, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+    // Explicit port path (string or DeviceInfo) — open exactly that port.
+    if (typeof target === "string" || isDeviceInfo(target)) {
+        const path = typeof target === "string" ? target : target.path;
+        const enumerated = ports.find((p) => p.path === path);
+        const port = enumerated ?? { path };
+        const info = await probePort(port, factory, timeoutMs);
+        if (info === null) {
+            throw new NoDepzDeviceError(`no DEPZ device answered on ${path}`);
+        }
+        if (!isKnownDepzUsb(port.usbVid, port.usbPid)) {
+            console.warn(`depz: ${path} has an unrecognized USB id ` +
+                `(vid=${fmtId(port.usbVid)}, pid=${fmtId(port.usbPid)}); opening anyway`);
+        }
+        if (opts.serial !== undefined && enumerated?.serialNumber !== undefined && enumerated.serialNumber !== opts.serial) {
+            console.warn(`depz: requested serial ${opts.serial} but ${path} enumerates as ` +
+                `${enumerated.serialNumber}`);
+        }
+        return openProbed(port, info, factory, timeoutMs);
+    }
+    const candidates = sortedCandidates(ports);
+    // Nth candidate by USB iSerial.
+    if (typeof target === "number") {
+        if (!Number.isInteger(target) || target < 0 || target >= candidates.length) {
+            throw new NoDepzDeviceError(`no DEPZ device at index ${target} (${candidates.length} candidate(s) found)`);
+        }
+        const port = candidates[target];
+        if (opts.serial !== undefined && port.serialNumber !== opts.serial) {
+            console.warn(`depz: index ${target} selects serial ${port.serialNumber ?? "(none)"}, ` +
+                `not the requested ${opts.serial}`);
+        }
+        return openIndexed(port, factory, timeoutMs);
+    }
+    // Auto: by serial, else smallest serial (index 0).
+    let port;
+    if (opts.serial !== undefined) {
+        port = candidates.find((p) => p.serialNumber === opts.serial);
+        if (port === undefined) {
+            throw new NoDepzDeviceError(`no DEPZ device with serial ${opts.serial}`);
+        }
+    }
+    else {
+        port = candidates[0];
+        if (port === undefined) {
+            throw new NoDepzDeviceError("no DEPZ device found (no port with a known DEPZ USB id)");
+        }
+    }
+    return openIndexed(port, factory, timeoutMs);
+}
+/**
+ * Select and open a device by its DEVICE-reported serial (GET_SERIAL), for
+ * transports that cannot enumerate USB iSerials (WebSerial). Probes every
+ * given port (open → GET_SERIAL → close), orders the answers by device
+ * serial, then selects — `opts.serial` picks an exact match, a numeric
+ * `target` picks the Nth, otherwise the smallest serial — and reopens it.
+ *
+ * The probing cost (opening each granted port once) is the price of not
+ * having USB iSerials up front; the *result* matches Node's serial-based
+ * selection because for programmed units USB iSerial == device serial.
+ */
+export async function openDeviceByDeviceSerial(ports, factory, target, opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS;
+    // matchUsb:false — a granted port is user-curated and may not expose a
+    // recognizable vid/pid; the protocol probe is the real filter.
+    const infos = orderDevicesBySerial(await listDepzDevicesFrom(ports, factory, { matchUsb: false, timeoutMs }));
+    let chosen;
+    if (opts.serial !== undefined) {
+        chosen = infos.find((d) => d.serialNumber === opts.serial);
+        if (chosen === undefined)
+            throw new NoDepzDeviceError(`no DEPZ device with serial ${opts.serial}`);
+    }
+    else if (typeof target === "number") {
+        if (!Number.isInteger(target) || target < 0 || target >= infos.length) {
+            throw new NoDepzDeviceError(`no DEPZ device at index ${target} (${infos.length} candidate(s) found)`);
+        }
+        chosen = infos[target];
+    }
+    else {
+        chosen = infos[0];
+        if (chosen === undefined)
+            throw new NoDepzDeviceError("no DEPZ device found");
+    }
+    const port = ports.find((p) => p.path === chosen.path) ?? { path: chosen.path };
+    return openProbed(port, chosen, factory, timeoutMs);
+}
+async function openIndexed(port, factory, timeoutMs) {
+    const info = await probePort(port, factory, timeoutMs);
+    if (info === null) {
+        throw new NoDepzDeviceError(`no DEPZ device answered on ${port.path}`);
+    }
+    return openProbed(port, info, factory, timeoutMs);
+}
+function fmtId(v) {
+    return v == null ? "?" : `0x${v.toString(16).toUpperCase().padStart(4, "0")}`;
+}
+//# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAmB,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAkDhE,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC,iFAAiF;AAEjF,SAAS,WAAW,CAAC,CAAe;IAClC,OAAO,cAAc,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAqB;IACtD,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,IAAI,EAAE,CAAC;QAChC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC9B,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,KAAqB;IAC7C,OAAO,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,CAAU;IACrC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,MAAM,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,CAAC;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAmB;IACtD,OAAO,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACjC,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,YAAY;YAAE,OAAO,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvF,OAAO,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,IAAkB,EAClB,OAAyB,EACzB,SAAS,GAAG,wBAAwB;IAEpC,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,GAAe,CAAC;IACpB,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC/C,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,kBAAkB;QACpB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC;QAC7D,IAAI,UAAU,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,GAAG,CAAC,aAAa,EAAE,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,IAAI,YAAY,GAAG,EAAE,CAAC;QACtB,IAAI,CAAC;YACH,YAAY,GAAG,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,cAAc;QAChB,CAAC;QACD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,SAAS,EAAE,KAAK,CAAC,OAAO;YACxB,UAAU;YACV,YAAY;YACZ,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;YAC3B,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;SAC5B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IACpB,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,KAAqB,EACrB,OAAyB,EACzB,OAAoB,EAAE;IAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,wBAAwB,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;IACvC,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAChE,MAAM,KAAK,GAAiB,EAAE,CAAC;IAC/B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,iFAAiF;AAEjF,SAAS,eAAe,CACtB,SAA0B,EAC1B,UAA6B,EAC7B,SAAiB,EACjB,IAAmB;IAEnB,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,MAAM;YACT,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5C,KAAK,QAAQ;YACX,wEAAwE;YACxE,8DAA8D;YAC9D,iEAAiE;YACjE,OAAO,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,UAAU;gBAC5D,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC;gBACxC,CAAC,CAAC,IAAI,QAAQ,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC7C,KAAK,QAAQ;YACX,OAAO,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;QAC9C;YACE,OAAO,IAAI,UAAU,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,IAAkB,EAClB,IAAgB,EAChB,OAAyB,EACzB,SAAiB;IAEjB,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CAAC,uEAAuE,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,GAAG,GAAG,eAAe,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;IACzE,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IACjB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,KAAqB,EACrB,OAAyB,EACzB,MAAmB,EACnB,OAA0B,EAAE;IAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,wBAAwB,CAAC;IAE7D,sEAAsE;IACtE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QAC/D,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtD,MAAM,IAAI,GAAiB,UAAU,IAAI,EAAE,IAAI,EAAE,CAAC;QAClD,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QACvD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,IAAI,CACV,SAAS,IAAI,8BAA8B;gBACzC,QAAQ,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAC3E,CAAC;QACJ,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,UAAU,EAAE,YAAY,KAAK,SAAS,IAAI,UAAU,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACnH,OAAO,CAAC,IAAI,CACV,0BAA0B,IAAI,CAAC,MAAM,QAAQ,IAAI,iBAAiB;gBAChE,GAAG,UAAU,CAAC,YAAY,EAAE,CAC/B,CAAC;QACJ,CAAC;QACD,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAE3C,gCAAgC;IAChC,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;YAC3E,MAAM,IAAI,iBAAiB,CACzB,2BAA2B,MAAM,KAAK,UAAU,CAAC,MAAM,sBAAsB,CAC9E,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,CAAE,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YACnE,OAAO,CAAC,IAAI,CACV,eAAe,MAAM,mBAAmB,IAAI,CAAC,YAAY,IAAI,QAAQ,IAAI;gBACvE,qBAAqB,IAAI,CAAC,MAAM,EAAE,CACrC,CAAC;QACJ,CAAC;QACD,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,mDAAmD;IACnD,IAAI,IAA8B,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,iBAAiB,CAAC,yDAAyD,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,KAAqB,EACrB,OAAyB,EACzB,MAAsB,EACtB,OAA0B,EAAE;IAE5B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,wBAAwB,CAAC;IAC7D,uEAAuE;IACvE,+DAA+D;IAC/D,MAAM,KAAK,GAAG,oBAAoB,CAChC,MAAM,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAC1E,CAAC;IACF,IAAI,MAA8B,CAAC;IACnC,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACrG,CAAC;SAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACtE,MAAM,IAAI,iBAAiB,CACzB,2BAA2B,MAAM,KAAK,KAAK,CAAC,MAAM,sBAAsB,CACzE,CAAC;QACJ,CAAC;QACD,MAAM,GAAG,KAAK,CAAC,MAAM,CAAE,CAAC;IAC1B,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,MAAM,KAAK,SAAS;YAAE,MAAM,IAAI,iBAAiB,CAAC,sBAAsB,CAAC,CAAC;IAChF,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAO,CAAC,IAAI,EAAE,CAAC;IAClF,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AACtD,CAAC;AAED,KAAK,UAAU,WAAW,CACxB,IAAkB,EAClB,OAAyB,EACzB,SAAiB;IAEjB,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IACvD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,iBAAiB,CAAC,8BAA8B,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,KAAK,CAAC,CAA4B;IACzC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAChF,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Exception hierarchy of the DEPZ sensor SDK.
+ * Status code names follow contracts/02_COMMON_COMMANDS.md §3.
+ */
+/** Base class for all SDK errors. */
+export declare class DepzError extends Error {
+    constructor(message?: string);
+}
+/** A request got no matching reply within the timeout. */
+export declare class DepzTimeoutError extends DepzError {
+    readonly cmd: number;
+    readonly timeoutMs: number;
+    constructor(cmd: number, timeoutMs: number);
+}
+/** Device answered a request with a non-OK RPT_STATUS. */
+export declare class StatusError extends DepzError {
+    readonly cmd: number;
+    readonly status: number;
+    readonly statusName: string;
+    constructor(cmd: number, status: number);
+}
+/** Device answered ERR_BUSY; the operation may be retried later. */
+export declare class BusyError extends StatusError {
+    constructor(cmd: number);
+}
+/** The serial link dropped (unplug, reboot) while in use. */
+export declare class DeviceLostError extends DepzError {
+}
+/** Operation attempted on a closed link/device. */
+export declare class LinkClosedError extends DepzError {
+}
+/**
+ * Discovery found no DEPZ device matching the request (no candidate port by
+ * USB id, an out-of-range index, or a serial that nothing answered to).
+ * Mirrors the Python reference `NoDepzDeviceError`.
+ */
+export declare class NoDepzDeviceError extends DepzError {
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qCAAqC;AACrC,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,CAAC,EAAE,MAAM;CAI7B;AAMD,0DAA0D;AAC1D,qBAAa,gBAAiB,SAAQ,SAAS;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAK3C;AAeD,0DAA0D;AAC1D,qBAAa,WAAY,SAAQ,SAAS;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAEhB,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAOxC;AAED,oEAAoE;AACpE,qBAAa,SAAU,SAAQ,WAAW;gBAC5B,GAAG,EAAE,MAAM;CAGxB;AAED,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,SAAS;CAAG;AAEjD,mDAAmD;AACnD,qBAAa,eAAgB,SAAQ,SAAS;CAAG;AAEjD;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;CAAG"}

package/dist/errors.js

@@ -0,0 +1,69 @@
+/**
+ * Exception hierarchy of the DEPZ sensor SDK.
+ * Status code names follow contracts/02_COMMON_COMMANDS.md §3.
+ */
+/** Base class for all SDK errors. */
+export class DepzError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+function hex2(n) {
+    return n.toString(16).toUpperCase().padStart(2, "0");
+}
+/** A request got no matching reply within the timeout. */
+export class DepzTimeoutError extends DepzError {
+    cmd;
+    timeoutMs;
+    constructor(cmd, timeoutMs) {
+        super(`no reply to cmd 0x${hex2(cmd)} within ${timeoutMs}ms`);
+        this.cmd = cmd;
+        this.timeoutMs = timeoutMs;
+    }
+}
+const STATUS_NAMES = {
+    0x00: "OK",
+    0x01: "ERROR",
+    0x02: "ERR_INVALID_CMD",
+    0x03: "ERR_PAYLOAD_FORMAT",
+    0x04: "ERR_INVALID_PARAM",
+    0x05: "ERR_PAYLOAD_CRC",
+    0x06: "ERR_BUSY",
+    0x07: "ERR_CMD_NOT_SUPPORTED",
+    0x08: "ERR_NOT_INITIALIZED",
+    0x09: "ERR_HARDWARE_FAULT",
+};
+/** Device answered a request with a non-OK RPT_STATUS. */
+export class StatusError extends DepzError {
+    cmd;
+    status;
+    statusName;
+    constructor(cmd, status) {
+        const statusName = STATUS_NAMES[status] ?? `0x${hex2(status)}`;
+        super(`cmd 0x${hex2(cmd)} failed: ${statusName} (0x${hex2(status)})`);
+        this.cmd = cmd;
+        this.status = status;
+        this.statusName = statusName;
+    }
+}
+/** Device answered ERR_BUSY; the operation may be retried later. */
+export class BusyError extends StatusError {
+    constructor(cmd) {
+        super(cmd, 0x06);
+    }
+}
+/** The serial link dropped (unplug, reboot) while in use. */
+export class DeviceLostError extends DepzError {
+}
+/** Operation attempted on a closed link/device. */
+export class LinkClosedError extends DepzError {
+}
+/**
+ * Discovery found no DEPZ device matching the request (no candidate port by
+ * USB id, an out-of-range index, or a serial that nothing answered to).
+ * Mirrors the Python reference `NoDepzDeviceError`.
+ */
+export class NoDepzDeviceError extends DepzError {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qCAAqC;AACrC,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAgB;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF;AAED,SAAS,IAAI,CAAC,CAAS;IACrB,OAAO,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,0DAA0D;AAC1D,MAAM,OAAO,gBAAiB,SAAQ,SAAS;IACpC,GAAG,CAAS;IACZ,SAAS,CAAS;IAE3B,YAAY,GAAW,EAAE,SAAiB;QACxC,KAAK,CAAC,qBAAqB,IAAI,CAAC,GAAG,CAAC,WAAW,SAAS,IAAI,CAAC,CAAC;QAC9D,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,YAAY,GAA2B;IAC3C,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,mBAAmB;IACzB,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,uBAAuB;IAC7B,IAAI,EAAE,qBAAqB;IAC3B,IAAI,EAAE,oBAAoB;CAC3B,CAAC;AAEF,0DAA0D;AAC1D,MAAM,OAAO,WAAY,SAAQ,SAAS;IAC/B,GAAG,CAAS;IACZ,MAAM,CAAS;IACf,UAAU,CAAS;IAE5B,YAAY,GAAW,EAAE,MAAc;QACrC,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,KAAK,CAAC,SAAS,IAAI,CAAC,GAAG,CAAC,YAAY,UAAU,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACtE,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED,oEAAoE;AACpE,MAAM,OAAO,SAAU,SAAQ,WAAW;IACxC,YAAY,GAAW;QACrB,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACnB,CAAC;CACF;AAED,6DAA6D;AAC7D,MAAM,OAAO,eAAgB,SAAQ,SAAS;CAAG;AAEjD,mDAAmD;AACnD,MAAM,OAAO,eAAgB,SAAQ,SAAS;CAAG;AAEjD;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,SAAS;CAAG"}

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @depz/sensor-sdk — browser-safe root export.
+ * Node-only pieces live in `@depz/sensor-sdk/node`.
+ */
+export * from "./protocol/crc.js";
+export * from "./protocol/framing.js";
+export * from "./protocol/common.js";
+export * from "./protocol/identity.js";
+export * from "./protocol/sr04.js";
+export * from "./protocol/vl53l8.js";
+export * from "./protocol/bno086.js";
+export * from "./protocol/fwdepz.js";
+export * from "./protocol/usb-ids.js";
+export * from "./errors.js";
+export { isDeviceInfo, listDepzDevicesFrom, openDeviceByDeviceSerial, openDeviceFrom, orderDevicesBySerial, orderPortsBySerial, probePort, } from "./discovery.js";
+export type { DeviceInfo, DepzPortInfo, ListOptions, OpenDeviceOptions, OpenTarget, TransportFactory, } from "./discovery.js";
+export { DepzLink } from "./device/link.js";
+export type { LinkStats } from "./device/link.js";
+export { DEFAULT_TIMEOUT_MS, DepzDevice, NO_MATCH, StreamQueue, hostNowUs, syncTimeAll, } from "./device/device.js";
+export type { DeviceEvent, DeviceOptions, Matcher, RequestOptions, TimeSync, } from "./device/device.js";
+export { Sr04 } from "./sensors/sr04.js";
+export type { Sr04Measurement } from "./sensors/sr04.js";
+export { MIN_RANGING_FREQUENCY_HZ, Vl53l8, Vl53l8Ch, Vl53l8Cx, zoneGrid, } from "./sensors/vl53l8/vl53l8.js";
+export type { Vl53l8Frame, Vl53l8InitOptions, Vl53l8Options, } from "./sensors/vl53l8/vl53l8.js";
+export { CALIBRATE_XTALK, FW_CHECKSUM, GET_XTALK_CMD, MotionConfig, NB_THRESHOLDS, POWER_MODE_DEEP_SLEEP, POWER_MODE_SLEEP, POWER_MODE_WAKEUP, RANGING_MODE_AUTONOMOUS, RANGING_MODE_CONTINUOUS, RESOLUTION_4X4, RESOLUTION_8X8, TARGET_ORDER_CLOSEST, TARGET_ORDER_STRONGEST, THRESH_IN_WINDOW, THRESH_OP_AND, THRESH_OP_NONE, THRESH_OP_OR, THRESH_OUT_OF_WINDOW, VL53L8CX, Vl53l8cxError, defaultMotionConfig, motionConfigSetResolution, packDetectionThresholds, swapBuffer, xtalkMarginToRaw, } from "./sensors/vl53l8/uld.js";
+export type { DetectionThreshold, MotionResult, Vl53l8Platform, Vl53l8Results, } from "./sensors/vl53l8/uld.js";
+export { CNH_BIN_WIDTH_MM, CNH_MAX_DATA_BYTES, CnhConfig, CnhConfigError, MI_CFG_DEV_IDX, decode as decodeCnh, maxBins as cnhMaxBins, } from "./sensors/vl53l8/cnh.js";
+export type { CnhAggregate, CnhDecoded } from "./sensors/vl53l8/cnh.js";
+export { loadAssets } from "./sensors/vl53l8/assets/index.js";
+export type { Vl53l8Assets, Vl53l8Variant } from "./sensors/vl53l8/assets/index.js";
+export * from "./sensors/bno086/shtp.js";
+export * from "./sensors/bno086/reports.js";
+export * from "./sensors/bno086/sh2.js";
+export * from "./sensors/bno086/bno086.js";
+export { RECORDING_SCHEMA, RecordingTransport, ReplayTransport } from "./transport/replay.js";
+export { DATASET_SCHEMA, DatasetPlayer, DatasetReader, DatasetRecorder, DatasetWriter, } from "./dataset.js";
+export type { DatasetDeviceMeta, DatasetHeader, DatasetRecord, PlayerState, } from "./dataset.js";
+export type { SerialTransport, SerialTransportInfo } from "./transport/types.js";
+export { LoopbackTransport } from "./transport/loopback.js";
+export { WebSerialTransport, isWebSerialSupported, getGrantedPorts, watchConnect, } from "./transport/webserial.js";
+export type { WebSerialPortLike } from "./transport/webserial.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * @depz/sensor-sdk — browser-safe root export.
+ * Node-only pieces live in `@depz/sensor-sdk/node`.
+ */
+export * from "./protocol/crc.js";
+export * from "./protocol/framing.js";
+export * from "./protocol/common.js";
+export * from "./protocol/identity.js";
+export * from "./protocol/sr04.js";
+export * from "./protocol/vl53l8.js";
+export * from "./protocol/bno086.js";
+export * from "./protocol/fwdepz.js";
+export * from "./protocol/usb-ids.js";
+export * from "./errors.js";
+export { isDeviceInfo, listDepzDevicesFrom, openDeviceByDeviceSerial, openDeviceFrom, orderDevicesBySerial, orderPortsBySerial, probePort, } from "./discovery.js";
+export { DepzLink } from "./device/link.js";
+export { DEFAULT_TIMEOUT_MS, DepzDevice, NO_MATCH, StreamQueue, hostNowUs, syncTimeAll, } from "./device/device.js";
+export { Sr04 } from "./sensors/sr04.js";
+export { MIN_RANGING_FREQUENCY_HZ, Vl53l8, Vl53l8Ch, Vl53l8Cx, zoneGrid, } from "./sensors/vl53l8/vl53l8.js";
+export { CALIBRATE_XTALK, FW_CHECKSUM, GET_XTALK_CMD, MotionConfig, NB_THRESHOLDS, POWER_MODE_DEEP_SLEEP, POWER_MODE_SLEEP, POWER_MODE_WAKEUP, RANGING_MODE_AUTONOMOUS, RANGING_MODE_CONTINUOUS, RESOLUTION_4X4, RESOLUTION_8X8, TARGET_ORDER_CLOSEST, TARGET_ORDER_STRONGEST, THRESH_IN_WINDOW, THRESH_OP_AND, THRESH_OP_NONE, THRESH_OP_OR, THRESH_OUT_OF_WINDOW, VL53L8CX, Vl53l8cxError, defaultMotionConfig, motionConfigSetResolution, packDetectionThresholds, swapBuffer, xtalkMarginToRaw, } from "./sensors/vl53l8/uld.js";
+export { CNH_BIN_WIDTH_MM, CNH_MAX_DATA_BYTES, CnhConfig, CnhConfigError, MI_CFG_DEV_IDX, decode as decodeCnh, maxBins as cnhMaxBins, } from "./sensors/vl53l8/cnh.js";
+export { loadAssets } from "./sensors/vl53l8/assets/index.js";
+export * from "./sensors/bno086/shtp.js";
+export * from "./sensors/bno086/reports.js";
+export * from "./sensors/bno086/sh2.js";
+export * from "./sensors/bno086/bno086.js";
+export { RECORDING_SCHEMA, RecordingTransport, ReplayTransport } from "./transport/replay.js";
+export { DATASET_SCHEMA, DatasetPlayer, DatasetReader, DatasetRecorder, DatasetWriter, } from "./dataset.js";
+export { LoopbackTransport } from "./transport/loopback.js";
+export { WebSerialTransport, isWebSerialSupported, getGrantedPorts, watchConnect, } from "./transport/webserial.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,EACxB,cAAc,EACd,oBAAoB,EACpB,kBAAkB,EAClB,SAAS,GACV,MAAM,gBAAgB,CAAC;AASxB,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EACL,kBAAkB,EAClB,UAAU,EACV,QAAQ,EACR,WAAW,EACX,SAAS,EACT,WAAW,GACZ,MAAM,oBAAoB,CAAC;AAQ5B,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EACL,wBAAwB,EACxB,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,QAAQ,GACT,MAAM,4BAA4B,CAAC;AAMpC,OAAO,EACL,eAAe,EACf,WAAW,EACX,aAAa,EACb,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,uBAAuB,EACvB,uBAAuB,EACvB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,YAAY,EACZ,oBAAoB,EACpB,QAAQ,EACR,aAAa,EACb,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,EACvB,UAAU,EACV,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,cAAc,EACd,MAAM,IAAI,SAAS,EACnB,OAAO,IAAI,UAAU,GACtB,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,cAAc,0BAA0B,CAAC;AACzC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,yBAAyB,CAAC;AACxC,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC9F,OAAO,EACL,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,cAAc,CAAC;AAQtB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,eAAe,EACf,YAAY,GACb,MAAM,0BAA0B,CAAC"}