@depz/sensor-sdk 0.1.0

package/dist/protocol/bno086.d.ts

@@ -0,0 +1,36 @@
+/**
+ * BNO086 bridge-level wire codecs (contracts/05_SENSOR_BNO086.md §1–2).
+ *
+ * The MCU is a thin SHTP pass-through: SEND_SHTP_PACKET carries a raw SHTP
+ * frame to the sensor, and every inbound SHTP frame arrives as RPT_DATA.
+ * Per ERRATA E2 the RPT_DATA `cmd` echo is always 0x00 — correlation happens
+ * at the SH-2 layer, never here.
+ *
+ * Mirrors the Python reference `depz_sensor_sdk.protocol.bno086`.
+ */
+export declare enum Bno086Cmd {
+    /** Hardware reset via nRST; RPT_STATUS OK. */
+    SensorReset = 50,
+    /** 1 ms WAKE (PS0) pulse; RPT_STATUS OK. */
+    SensorWakeUp = 51,
+    /** Payload = raw SHTP frame; RPT_STATUS OK/ERR_BUSY. */
+    SendShtpPacket = 52
+}
+export declare enum Bno086Rpt {
+    /** rpt_data_t: cmd u8, timestamp_us u64, raw SHTP frame. */
+    Data = 145
+}
+export declare const TX_SLOTS = 2;
+export declare const TX_SLOT_SIZE = 64;
+export declare const BUSY_BACKOFF_MS = 200;
+/** One RPT_DATA report: an SHTP frame captured from the sensor bus. */
+export interface Bno086Data {
+    /** Always 0x00 in practice (ERRATA E2) — never correlate on it. */
+    cmd: number;
+    /** MCU uptime at frame capture (µs). */
+    timestampUs: bigint;
+    /** Raw SHTP frame (4-byte header + cargo fragment). */
+    shtp: Uint8Array;
+}
+export declare function unpackBno086Data(payload: Uint8Array): Bno086Data;
+//# sourceMappingURL=bno086.d.ts.map

package/dist/protocol/bno086.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bno086.d.ts","sourceRoot":"","sources":["../../src/protocol/bno086.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oBAAY,SAAS;IACnB,8CAA8C;IAC9C,WAAW,KAAO;IAClB,4CAA4C;IAC5C,YAAY,KAAO;IACnB,wDAAwD;IACxD,cAAc,KAAO;CACtB;AAED,oBAAY,SAAS;IACnB,4DAA4D;IAC5D,IAAI,MAAO;CACZ;AAID,eAAO,MAAM,QAAQ,IAAI,CAAC;AAC1B,eAAO,MAAM,YAAY,KAAK,CAAC;AAC/B,eAAO,MAAM,eAAe,MAAM,CAAC;AAEnC,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,GAAG,EAAE,MAAM,CAAC;IACZ,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,UAAU,GAAG,UAAU,CAOhE"}

package/dist/protocol/bno086.js

@@ -0,0 +1,38 @@
+/**
+ * BNO086 bridge-level wire codecs (contracts/05_SENSOR_BNO086.md §1–2).
+ *
+ * The MCU is a thin SHTP pass-through: SEND_SHTP_PACKET carries a raw SHTP
+ * frame to the sensor, and every inbound SHTP frame arrives as RPT_DATA.
+ * Per ERRATA E2 the RPT_DATA `cmd` echo is always 0x00 — correlation happens
+ * at the SH-2 layer, never here.
+ *
+ * Mirrors the Python reference `depz_sensor_sdk.protocol.bno086`.
+ */
+export var Bno086Cmd;
+(function (Bno086Cmd) {
+    /** Hardware reset via nRST; RPT_STATUS OK. */
+    Bno086Cmd[Bno086Cmd["SensorReset"] = 50] = "SensorReset";
+    /** 1 ms WAKE (PS0) pulse; RPT_STATUS OK. */
+    Bno086Cmd[Bno086Cmd["SensorWakeUp"] = 51] = "SensorWakeUp";
+    /** Payload = raw SHTP frame; RPT_STATUS OK/ERR_BUSY. */
+    Bno086Cmd[Bno086Cmd["SendShtpPacket"] = 52] = "SendShtpPacket";
+})(Bno086Cmd || (Bno086Cmd = {}));
+export var Bno086Rpt;
+(function (Bno086Rpt) {
+    /** rpt_data_t: cmd u8, timestamp_us u64, raw SHTP frame. */
+    Bno086Rpt[Bno086Rpt["Data"] = 145] = "Data";
+})(Bno086Rpt || (Bno086Rpt = {}));
+// The MCU keeps two fixed 64-byte SHTP transmit slots (ERRATA E2). A third
+// in-flight SEND_SHTP_PACKET gets RPT_STATUS(ERR_BUSY); back off >= 200 ms.
+export const TX_SLOTS = 2;
+export const TX_SLOT_SIZE = 64;
+export const BUSY_BACKOFF_MS = 200;
+export function unpackBno086Data(payload) {
+    const v = new DataView(payload.buffer, payload.byteOffset, payload.byteLength);
+    return {
+        cmd: v.getUint8(0),
+        timestampUs: v.getBigUint64(1, true),
+        shtp: payload.subarray(9),
+    };
+}
+//# sourceMappingURL=bno086.js.map

package/dist/protocol/bno086.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bno086.js","sourceRoot":"","sources":["../../src/protocol/bno086.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,8CAA8C;IAC9C,wDAAkB,CAAA;IAClB,4CAA4C;IAC5C,0DAAmB,CAAA;IACnB,wDAAwD;IACxD,8DAAqB,CAAA;AACvB,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAED,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,4DAA4D;IAC5D,2CAAW,CAAA;AACb,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAED,2EAA2E;AAC3E,4EAA4E;AAC5E,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC;AAC1B,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,CAAC;AAYnC,MAAM,UAAU,gBAAgB,CAAC,OAAmB;IAClD,MAAM,CAAC,GAAG,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC/E,OAAO;QACL,GAAG,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAClB,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC;QACpC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;KAC1B,CAAC;AACJ,CAAC"}

package/dist/protocol/common.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Common command/report IDs and payload codecs
+ * (contracts/02_COMMON_COMMANDS.md). Raw wire integers only; unit
+ * conversions (0.1 °C, µs) happen in the device layer. u64 timestamps are
+ * `bigint`.
+ */
+export declare enum Cmd {
+    Bootloader = 1,
+    DeviceReset = 2,
+    GetDeviceName = 3,
+    GetNameActiveSoftware = 4,
+    GetSerial = 5,
+    SyncTime = 6,
+    GetMcuTemperature = 7,
+    GetPayloadCrcType = 8,
+    SetPayloadCrcType = 9,
+    ThroughputTxStart = 28,
+    ThroughputTxStop = 29,
+    ThroughputRxData = 30,
+    GetSyncPinConfig = 48,
+    SetSyncPinConfig = 49
+}
+export declare enum Rpt {
+    Status = 128,
+    Text = 129,
+    SyncTime = 130,
+    Temperature = 131,
+    SequenceError = 132,
+    PayloadCrcType = 135,
+    ThroughputData = 136,
+    SyncPinConfig = 144
+}
+export declare enum Status {
+    Ok = 0,
+    Error = 1,
+    ErrInvalidCmd = 2,
+    ErrPayloadFormat = 3,
+    ErrInvalidParam = 4,
+    ErrPayloadCrc = 5,
+    ErrBusy = 6,
+    ErrCmdNotSupported = 7,
+    ErrNotInitialized = 8,
+    ErrHardwareFault = 9
+}
+export declare enum SyncPinMode {
+    Disable = 0,
+    In = 1,
+    OutStart = 2,
+    OutEnd = 3,
+    OutBoth = 4
+}
+export declare enum SyncPinPolarity {
+    IdleLow = 0,
+    IdleHigh = 1
+}
+/** Value of the echoed-cmd byte in unsolicited reports. */
+export declare const UNSOLICITED = 0;
+export interface StatusReport {
+    cmd: number;
+    status: number;
+}
+export interface TextReport {
+    cmd: number;
+    text: string;
+}
+export interface SyncTimeReport {
+    pcTimestampUs: bigint;
+    mcuRxUs: bigint;
+    mcuTxUs: bigint;
+}
+export interface TemperatureReport {
+    timestampUs: bigint;
+    rawDecidegrees: number;
+}
+export interface SequenceErrorReport {
+    expectedSeq: number;
+    receivedSeq: number;
+}
+export interface SyncPinConfig {
+    pin: number;
+    mode: SyncPinMode;
+    polarity: SyncPinPolarity;
+}
+export declare function unpackStatus(p: Uint8Array): StatusReport;
+export declare function unpackText(p: Uint8Array): TextReport;
+export declare function unpackSyncTime(p: Uint8Array): SyncTimeReport;
+export declare function unpackTemperature(p: Uint8Array): TemperatureReport;
+export declare function unpackSequenceError(p: Uint8Array): SequenceErrorReport;
+export declare function packSyncTime(pcTimestampUs: bigint): Uint8Array;
+export declare function packSyncPinConfig(cfg: SyncPinConfig): Uint8Array;
+export declare function unpackSyncPinConfig(p: Uint8Array): SyncPinConfig;
+/**
+ * NTP-style clock math, all µs (contract 02 §5). offset = device − host,
+ * `((T2-T1)+(T3-T4))/2` truncated toward zero (bigint division is exactly
+ * that); rtt = (T4-T1)-(T3-T2).
+ */
+export declare function syncTimeOffsetRtt(t1: bigint, t2: bigint, t3: bigint, t4: bigint): {
+    offsetUs: bigint;
+    rttUs: bigint;
+};
+/** Decode an ASCII device string, dropping trailing NUL/0xFF filler. */
+export declare function stripDeviceString(raw: Uint8Array): string;
+//# sourceMappingURL=common.d.ts.map

package/dist/protocol/common.d.ts.map

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

package/dist/protocol/common.js

@@ -0,0 +1,121 @@
+/**
+ * Common command/report IDs and payload codecs
+ * (contracts/02_COMMON_COMMANDS.md). Raw wire integers only; unit
+ * conversions (0.1 °C, µs) happen in the device layer. u64 timestamps are
+ * `bigint`.
+ */
+export var Cmd;
+(function (Cmd) {
+    Cmd[Cmd["Bootloader"] = 1] = "Bootloader";
+    Cmd[Cmd["DeviceReset"] = 2] = "DeviceReset";
+    Cmd[Cmd["GetDeviceName"] = 3] = "GetDeviceName";
+    Cmd[Cmd["GetNameActiveSoftware"] = 4] = "GetNameActiveSoftware";
+    Cmd[Cmd["GetSerial"] = 5] = "GetSerial";
+    Cmd[Cmd["SyncTime"] = 6] = "SyncTime";
+    Cmd[Cmd["GetMcuTemperature"] = 7] = "GetMcuTemperature";
+    Cmd[Cmd["GetPayloadCrcType"] = 8] = "GetPayloadCrcType";
+    Cmd[Cmd["SetPayloadCrcType"] = 9] = "SetPayloadCrcType";
+    Cmd[Cmd["ThroughputTxStart"] = 28] = "ThroughputTxStart";
+    Cmd[Cmd["ThroughputTxStop"] = 29] = "ThroughputTxStop";
+    Cmd[Cmd["ThroughputRxData"] = 30] = "ThroughputRxData";
+    Cmd[Cmd["GetSyncPinConfig"] = 48] = "GetSyncPinConfig";
+    Cmd[Cmd["SetSyncPinConfig"] = 49] = "SetSyncPinConfig";
+})(Cmd || (Cmd = {}));
+export var Rpt;
+(function (Rpt) {
+    Rpt[Rpt["Status"] = 128] = "Status";
+    Rpt[Rpt["Text"] = 129] = "Text";
+    Rpt[Rpt["SyncTime"] = 130] = "SyncTime";
+    Rpt[Rpt["Temperature"] = 131] = "Temperature";
+    Rpt[Rpt["SequenceError"] = 132] = "SequenceError";
+    Rpt[Rpt["PayloadCrcType"] = 135] = "PayloadCrcType";
+    Rpt[Rpt["ThroughputData"] = 136] = "ThroughputData";
+    Rpt[Rpt["SyncPinConfig"] = 144] = "SyncPinConfig";
+})(Rpt || (Rpt = {}));
+export var Status;
+(function (Status) {
+    Status[Status["Ok"] = 0] = "Ok";
+    Status[Status["Error"] = 1] = "Error";
+    Status[Status["ErrInvalidCmd"] = 2] = "ErrInvalidCmd";
+    Status[Status["ErrPayloadFormat"] = 3] = "ErrPayloadFormat";
+    Status[Status["ErrInvalidParam"] = 4] = "ErrInvalidParam";
+    Status[Status["ErrPayloadCrc"] = 5] = "ErrPayloadCrc";
+    Status[Status["ErrBusy"] = 6] = "ErrBusy";
+    Status[Status["ErrCmdNotSupported"] = 7] = "ErrCmdNotSupported";
+    Status[Status["ErrNotInitialized"] = 8] = "ErrNotInitialized";
+    Status[Status["ErrHardwareFault"] = 9] = "ErrHardwareFault";
+})(Status || (Status = {}));
+export var SyncPinMode;
+(function (SyncPinMode) {
+    SyncPinMode[SyncPinMode["Disable"] = 0] = "Disable";
+    SyncPinMode[SyncPinMode["In"] = 1] = "In";
+    SyncPinMode[SyncPinMode["OutStart"] = 2] = "OutStart";
+    SyncPinMode[SyncPinMode["OutEnd"] = 3] = "OutEnd";
+    SyncPinMode[SyncPinMode["OutBoth"] = 4] = "OutBoth";
+})(SyncPinMode || (SyncPinMode = {}));
+export var SyncPinPolarity;
+(function (SyncPinPolarity) {
+    SyncPinPolarity[SyncPinPolarity["IdleLow"] = 0] = "IdleLow";
+    SyncPinPolarity[SyncPinPolarity["IdleHigh"] = 1] = "IdleHigh";
+})(SyncPinPolarity || (SyncPinPolarity = {}));
+/** Value of the echoed-cmd byte in unsolicited reports. */
+export const UNSOLICITED = 0x00;
+function dv(p) {
+    return new DataView(p.buffer, p.byteOffset, p.byteLength);
+}
+export function unpackStatus(p) {
+    return { cmd: p[0], status: p[1] };
+}
+export function unpackText(p) {
+    return { cmd: p[0], text: stripDeviceString(p.subarray(1)) };
+}
+export function unpackSyncTime(p) {
+    const v = dv(p);
+    return {
+        pcTimestampUs: v.getBigUint64(0, true),
+        mcuRxUs: v.getBigUint64(8, true),
+        mcuTxUs: v.getBigUint64(16, true),
+    };
+}
+export function unpackTemperature(p) {
+    const v = dv(p);
+    return { timestampUs: v.getBigUint64(0, true), rawDecidegrees: v.getInt16(8, true) };
+}
+export function unpackSequenceError(p) {
+    return { expectedSeq: p[0], receivedSeq: p[1] };
+}
+export function packSyncTime(pcTimestampUs) {
+    const out = new Uint8Array(8);
+    new DataView(out.buffer).setBigUint64(0, pcTimestampUs, true);
+    return out;
+}
+export function packSyncPinConfig(cfg) {
+    return Uint8Array.of(cfg.pin, cfg.mode, cfg.polarity);
+}
+export function unpackSyncPinConfig(p) {
+    return { pin: p[0], mode: p[1], polarity: p[2] };
+}
+/**
+ * NTP-style clock math, all µs (contract 02 §5). offset = device − host,
+ * `((T2-T1)+(T3-T4))/2` truncated toward zero (bigint division is exactly
+ * that); rtt = (T4-T1)-(T3-T2).
+ */
+export function syncTimeOffsetRtt(t1, t2, t3, t4) {
+    return {
+        offsetUs: (t2 - t1 + (t3 - t4)) / 2n,
+        rttUs: t4 - t1 - (t3 - t2),
+    };
+}
+/** Decode an ASCII device string, dropping trailing NUL/0xFF filler. */
+export function stripDeviceString(raw) {
+    let end = raw.length;
+    while (end > 0 && (raw[end - 1] === 0x00 || raw[end - 1] === 0xff))
+        end--;
+    let s = "";
+    for (let i = 0; i < end; i++) {
+        const c = raw[i];
+        s += c < 0x80 ? String.fromCharCode(c) : "�";
+    }
+    return s;
+}
+//# sourceMappingURL=common.js.map

package/dist/protocol/common.js.map

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

package/dist/protocol/crc.d.ts

@@ -0,0 +1,17 @@
+/**
+ * CRC algorithms of the DEPZ transport (contracts/01_TRANSPORT_FRAMING.md §3).
+ * Byte-exact with the firmware; CRC-8 init is 0x00 for every device
+ * (contracts/ERRATA.md E1).
+ */
+/** CRC-8/MAXIM: poly 0x31 reflected, init 0x00, xorout 0x00. */
+export declare function crc8Maxim(data: Uint8Array): number;
+/** CRC-16/MODBUS: poly 0x8005 reflected, init 0xFFFF, xorout 0x0000. */
+export declare function crc16Modbus(data: Uint8Array): number;
+/** CRC-32/ISO-HDLC: poly 0x04C11DB7 reflected, init/xorout 0xFFFFFFFF. */
+export declare function crc32IsoHdlc(data: Uint8Array): number;
+/**
+ * CRC-16/CCITT-FALSE: poly 0x1021, init 0xFFFF, not reflected.
+ * Used only for the `.fwdepz` file header (contract 06), never on the wire.
+ */
+export declare function crc16CcittFalse(data: Uint8Array): number;
+//# sourceMappingURL=crc.d.ts.map

package/dist/protocol/crc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc.d.ts","sourceRoot":"","sources":["../../src/protocol/crc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH,gEAAgE;AAChE,wBAAgB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAIlD;AAED,wEAAwE;AACxE,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAIpD;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAIrD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CASxD"}

package/dist/protocol/crc.js

@@ -0,0 +1,55 @@
+/**
+ * CRC algorithms of the DEPZ transport (contracts/01_TRANSPORT_FRAMING.md §3).
+ * Byte-exact with the firmware; CRC-8 init is 0x00 for every device
+ * (contracts/ERRATA.md E1).
+ */
+function makeTable(polyReflected) {
+    const t = new Uint32Array(256);
+    for (let i = 0; i < 256; i++) {
+        let crc = i;
+        for (let b = 0; b < 8; b++) {
+            crc = crc & 1 ? (crc >>> 1) ^ polyReflected : crc >>> 1;
+        }
+        t[i] = crc >>> 0;
+    }
+    return t;
+}
+const CRC8_TABLE = makeTable(0x8c);
+const CRC16_TABLE = makeTable(0xa001);
+const CRC32_TABLE = makeTable(0xedb88320);
+/** CRC-8/MAXIM: poly 0x31 reflected, init 0x00, xorout 0x00. */
+export function crc8Maxim(data) {
+    let crc = 0x00;
+    for (const b of data)
+        crc = CRC8_TABLE[crc ^ b];
+    return crc;
+}
+/** CRC-16/MODBUS: poly 0x8005 reflected, init 0xFFFF, xorout 0x0000. */
+export function crc16Modbus(data) {
+    let crc = 0xffff;
+    for (const b of data)
+        crc = (crc >>> 8) ^ CRC16_TABLE[(crc ^ b) & 0xff];
+    return crc;
+}
+/** CRC-32/ISO-HDLC: poly 0x04C11DB7 reflected, init/xorout 0xFFFFFFFF. */
+export function crc32IsoHdlc(data) {
+    let crc = 0xffffffff;
+    for (const b of data)
+        crc = (crc >>> 8) ^ CRC32_TABLE[(crc ^ b) & 0xff];
+    return (crc ^ 0xffffffff) >>> 0;
+}
+/**
+ * CRC-16/CCITT-FALSE: poly 0x1021, init 0xFFFF, not reflected.
+ * Used only for the `.fwdepz` file header (contract 06), never on the wire.
+ */
+export function crc16CcittFalse(data) {
+    let crc = 0xffff;
+    for (const b of data) {
+        crc ^= b << 8;
+        for (let i = 0; i < 8; i++) {
+            crc = crc & 0x8000 ? ((crc << 1) ^ 0x1021) & 0xffff : (crc << 1) & 0xffff;
+        }
+    }
+    return crc;
+}
+//# sourceMappingURL=crc.js.map

package/dist/protocol/crc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crc.js","sourceRoot":"","sources":["../../src/protocol/crc.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS,SAAS,CAAC,aAAqB;IACtC,MAAM,CAAC,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,GAAG,GAAG,CAAC,CAAC;QACZ,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1D,CAAC;QACD,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AACnC,MAAM,WAAW,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;AACtC,MAAM,WAAW,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;AAE1C,gEAAgE;AAChE,MAAM,UAAU,SAAS,CAAC,IAAgB;IACxC,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,GAAG,GAAG,UAAU,CAAC,GAAG,GAAG,CAAC,CAAE,CAAC;IACjD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC1C,IAAI,GAAG,GAAG,MAAM,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAE,CAAC;IACzE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,YAAY,CAAC,IAAgB;IAC3C,IAAI,GAAG,GAAG,UAAU,CAAC;IACrB,KAAK,MAAM,CAAC,IAAI,IAAI;QAAE,GAAG,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,GAAG,WAAW,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,IAAI,CAAE,CAAC;IACzE,OAAO,CAAC,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAgB;IAC9C,IAAI,GAAG,GAAG,MAAM,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,GAAG,GAAG,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC;QAC5E,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/protocol/framing.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Packet framing and incremental parser (contracts/01_TRANSPORT_FRAMING.md).
+ * Mirrors the Python reference (`depz_sensor_sdk.transport.framing`) and the
+ * firmware `common/transport/transport.c`. Empty payloads never carry CRC
+ * bytes even when crc_type bits are set (contracts/ERRATA.md E6).
+ */
+export declare const MAGIC0 = 165;
+export declare const MAGIC1 = 195;
+export declare const HEADER_SIZE = 7;
+export declare const MAX_PAYLOAD = 16383;
+export declare enum CrcType {
+    None = 0,
+    Crc8 = 1,
+    Crc16 = 2,
+    Crc32 = 3
+}
+/** CRC trailer for a payload; empty payloads never carry CRC bytes. */
+export declare function payloadCrcBytes(crcType: CrcType, payload: Uint8Array): Uint8Array;
+/**
+ * Frame one packet. `crcType` bits are set in the header even for an empty
+ * payload (matching device TX), but CRC bytes are only appended for
+ * non-empty payloads.
+ */
+export declare function buildPacket(cmd: number, payload?: Uint8Array, seq?: number, crcType?: CrcType): Uint8Array;
+export interface PacketEvent {
+    type: "packet";
+    cmd: number;
+    seq: number;
+    payload: Uint8Array;
+}
+/**
+ * Bytes discarded while hunting for a valid frame. Boundaries between
+ * consecutive trash events depend on read chunking; only the concatenated
+ * byte stream is deterministic.
+ */
+export interface TrashEvent {
+    type: "trash";
+    data: Uint8Array;
+}
+/** A frame with a valid header whose payload CRC failed; dropped. */
+export interface CrcErrorEvent {
+    type: "crcError";
+    cmd: number;
+    seq: number;
+}
+export type ParserEvent = PacketEvent | TrashEvent | CrcErrorEvent;
+/**
+ * Incremental frame parser. Feed arbitrary byte chunks; get events.
+ * Event order is invariant to chunking (contract 01 §5) except trash event
+ * boundaries — concatenate trash data when comparing streams.
+ */
+export declare class PacketParser {
+    private buf;
+    packets: number;
+    crcErrors: number;
+    headerErrors: number;
+    trashBytes: number;
+    feed(data: Uint8Array): ParserEvent[];
+    /** Unconsumed bytes currently buffered (diagnostics/tests). */
+    get residue(): Uint8Array;
+    private findMagic;
+    private emitTrash;
+    private parseOne;
+}
+//# sourceMappingURL=framing.d.ts.map

package/dist/protocol/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../src/protocol/framing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,eAAO,MAAM,MAAM,MAAO,CAAC;AAC3B,eAAO,MAAM,MAAM,MAAO,CAAC;AAC3B,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,WAAW,QAAS,CAAC;AAElC,oBAAY,OAAO;IACjB,IAAI,IAAI;IACR,IAAI,IAAI;IACR,KAAK,IAAI;IACT,KAAK,IAAI;CACV;AASD,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAQjF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,UAA8B,EACvC,GAAG,SAAI,EACP,OAAO,GAAE,OAAsB,GAC9B,UAAU,CAiBZ;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,UAAU,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,qEAAqE;AACrE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,MAAM,WAAW,GAAG,WAAW,GAAG,UAAU,GAAG,aAAa,CAAC;AAEnE;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,GAAG,CAAqB;IAChC,OAAO,SAAK;IACZ,SAAS,SAAK;IACd,YAAY,SAAK;IACjB,UAAU,SAAK;IAEf,IAAI,CAAC,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE;IAgBrC,+DAA+D;IAC/D,IAAI,OAAO,IAAI,UAAU,CAExB;IAED,OAAO,CAAC,SAAS;IAQjB,OAAO,CAAC,SAAS;IAOjB,OAAO,CAAC,QAAQ;CAwCjB"}

package/dist/protocol/framing.js

@@ -0,0 +1,152 @@
+/**
+ * Packet framing and incremental parser (contracts/01_TRANSPORT_FRAMING.md).
+ * Mirrors the Python reference (`depz_sensor_sdk.transport.framing`) and the
+ * firmware `common/transport/transport.c`. Empty payloads never carry CRC
+ * bytes even when crc_type bits are set (contracts/ERRATA.md E6).
+ */
+import { crc8Maxim, crc16Modbus, crc32IsoHdlc } from "./crc.js";
+export const MAGIC0 = 0xa5;
+export const MAGIC1 = 0xc3;
+export const HEADER_SIZE = 7;
+export const MAX_PAYLOAD = 0x3fff;
+export var CrcType;
+(function (CrcType) {
+    CrcType[CrcType["None"] = 0] = "None";
+    CrcType[CrcType["Crc8"] = 1] = "Crc8";
+    CrcType[CrcType["Crc16"] = 2] = "Crc16";
+    CrcType[CrcType["Crc32"] = 3] = "Crc32";
+})(CrcType || (CrcType = {}));
+const CRC_SIZES = {
+    [CrcType.None]: 0,
+    [CrcType.Crc8]: 1,
+    [CrcType.Crc16]: 2,
+    [CrcType.Crc32]: 4,
+};
+/** CRC trailer for a payload; empty payloads never carry CRC bytes. */
+export function payloadCrcBytes(crcType, payload) {
+    if (crcType === CrcType.None || payload.length === 0)
+        return new Uint8Array(0);
+    const out = new Uint8Array(CRC_SIZES[crcType]);
+    const dv = new DataView(out.buffer);
+    if (crcType === CrcType.Crc8)
+        dv.setUint8(0, crc8Maxim(payload));
+    else if (crcType === CrcType.Crc16)
+        dv.setUint16(0, crc16Modbus(payload), true);
+    else
+        dv.setUint32(0, crc32IsoHdlc(payload), true);
+    return out;
+}
+/**
+ * Frame one packet. `crcType` bits are set in the header even for an empty
+ * payload (matching device TX), but CRC bytes are only appended for
+ * non-empty payloads.
+ */
+export function buildPacket(cmd, payload = new Uint8Array(0), seq = 0, crcType = CrcType.None) {
+    if (payload.length > MAX_PAYLOAD) {
+        throw new RangeError(`payload too long: ${payload.length} > ${MAX_PAYLOAD}`);
+    }
+    const trailer = payloadCrcBytes(crcType, payload);
+    const out = new Uint8Array(HEADER_SIZE + payload.length + trailer.length);
+    const dataSize = payload.length | (crcType << 14);
+    out[0] = MAGIC0;
+    out[1] = MAGIC1;
+    out[2] = dataSize & 0xff;
+    out[3] = dataSize >>> 8;
+    out[4] = cmd & 0xff;
+    out[5] = seq & 0xff;
+    out[6] = crc8Maxim(out.subarray(2, 6));
+    out.set(payload, HEADER_SIZE);
+    out.set(trailer, HEADER_SIZE + payload.length);
+    return out;
+}
+/**
+ * Incremental frame parser. Feed arbitrary byte chunks; get events.
+ * Event order is invariant to chunking (contract 01 §5) except trash event
+ * boundaries — concatenate trash data when comparing streams.
+ */
+export class PacketParser {
+    buf = new Uint8Array(0);
+    packets = 0;
+    crcErrors = 0;
+    headerErrors = 0;
+    trashBytes = 0;
+    feed(data) {
+        if (data.length > 0) {
+            const next = new Uint8Array(this.buf.length + data.length);
+            next.set(this.buf, 0);
+            next.set(data, this.buf.length);
+            this.buf = next;
+        }
+        const out = [];
+        for (;;) {
+            const ev = this.parseOne();
+            if (ev === null)
+                break;
+            out.push(ev);
+        }
+        return out;
+    }
+    /** Unconsumed bytes currently buffered (diagnostics/tests). */
+    get residue() {
+        return this.buf;
+    }
+    findMagic(from = 0) {
+        const b = this.buf;
+        for (let i = from; i + 1 < b.length; i++) {
+            if (b[i] === MAGIC0 && b[i + 1] === MAGIC1)
+                return i;
+        }
+        return -1;
+    }
+    emitTrash(count) {
+        const data = this.buf.slice(0, count);
+        this.buf = this.buf.slice(count);
+        this.trashBytes += count;
+        return { type: "trash", data };
+    }
+    parseOne() {
+        const buf = this.buf;
+        const pos = this.findMagic();
+        if (pos === -1) {
+            // Keep the last byte: it may be a split 0xA5.
+            if (buf.length > 1)
+                return this.emitTrash(buf.length - 1);
+            return null;
+        }
+        if (pos > 0)
+            return this.emitTrash(pos);
+        if (buf.length < HEADER_SIZE)
+            return null;
+        const dataSize = buf[2] | (buf[3] << 8);
+        const payloadSize = dataSize & MAX_PAYLOAD;
+        const crcType = ((dataSize >>> 14) & 0x03);
+        if (crc8Maxim(buf.subarray(2, 6)) !== buf[6]) {
+            // Header corrupt: advance one byte past the magic start and let the
+            // magic hunt resync (firmware: rb_skip(off + 1)).
+            this.headerErrors += 1;
+            return this.emitTrash(1);
+        }
+        // ERRATA E6: empty payload never carries CRC bytes.
+        const crcSize = payloadSize > 0 ? CRC_SIZES[crcType] : 0;
+        const total = HEADER_SIZE + payloadSize + crcSize;
+        if (buf.length < total)
+            return null;
+        const cmd = buf[4];
+        const seq = buf[5];
+        const payload = buf.slice(HEADER_SIZE, HEADER_SIZE + payloadSize);
+        const trailer = buf.subarray(HEADER_SIZE + payloadSize, total);
+        this.buf = this.buf.slice(total);
+        if (crcSize > 0) {
+            const expected = payloadCrcBytes(crcType, payload);
+            for (let i = 0; i < crcSize; i++) {
+                if (expected[i] !== trailer[i]) {
+                    this.crcErrors += 1;
+                    return { type: "crcError", cmd, seq };
+                }
+            }
+        }
+        this.packets += 1;
+        return { type: "packet", cmd, seq, payload };
+    }
+}
+//# sourceMappingURL=framing.js.map

package/dist/protocol/framing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.js","sourceRoot":"","sources":["../../src/protocol/framing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAEhE,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;AAC3B,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;AAC3B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC;AAElC,MAAM,CAAN,IAAY,OAKX;AALD,WAAY,OAAO;IACjB,qCAAQ,CAAA;IACR,qCAAQ,CAAA;IACR,uCAAS,CAAA;IACT,uCAAS,CAAA;AACX,CAAC,EALW,OAAO,KAAP,OAAO,QAKlB;AAED,MAAM,SAAS,GAA4B;IACzC,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IACjB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IAClB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;CACnB,CAAC;AAEF,uEAAuE;AACvE,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,OAAmB;IACnE,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI;QAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;SAC5D,IAAI,OAAO,KAAK,OAAO,CAAC,KAAK;QAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;;QAC3E,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IAClD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CACzB,GAAW,EACX,UAAsB,IAAI,UAAU,CAAC,CAAC,CAAC,EACvC,GAAG,GAAG,CAAC,EACP,UAAmB,OAAO,CAAC,IAAI;IAE/B,IAAI,OAAO,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;QACjC,MAAM,IAAI,UAAU,CAAC,qBAAqB,OAAO,CAAC,MAAM,MAAM,WAAW,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1E,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IAClD,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAChB,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IAChB,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,GAAG,IAAI,CAAC;IACzB,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC;IACxB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC;IACpB,GAAG,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvC,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9B,GAAG,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,GAAG,CAAC;AACb,CAAC;AA4BD;;;;GAIG;AACH,MAAM,OAAO,YAAY;IACf,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;IAChC,OAAO,GAAG,CAAC,CAAC;IACZ,SAAS,GAAG,CAAC,CAAC;IACd,YAAY,GAAG,CAAC,CAAC;IACjB,UAAU,GAAG,CAAC,CAAC;IAEf,IAAI,CAAC,IAAgB;QACnB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3D,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAClB,CAAC;QACD,MAAM,GAAG,GAAkB,EAAE,CAAC;QAC9B,SAAS,CAAC;YACR,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC3B,IAAI,EAAE,KAAK,IAAI;gBAAE,MAAM;YACvB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,+DAA+D;IAC/D,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAEO,SAAS,CAAC,IAAI,GAAG,CAAC;QACxB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC;QACnB,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACzC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM;gBAAE,OAAO,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IAEO,SAAS,CAAC,KAAa;QAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC;QACzB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACjC,CAAC;IAEO,QAAQ;QACd,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7B,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC;YACf,8CAA8C;YAC9C,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,GAAG,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,GAAG,CAAC,MAAM,GAAG,WAAW;YAAE,OAAO,IAAI,CAAC;QAC1C,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAE,IAAI,CAAC,CAAC,CAAC;QAC1C,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;QAC3C,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,KAAK,EAAE,CAAC,GAAG,IAAI,CAAY,CAAC;QACtD,IAAI,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,oEAAoE;YACpE,kDAAkD;YAClD,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;QACD,oDAAoD;QACpD,MAAM,OAAO,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;QAClD,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK;YAAE,OAAO,IAAI,CAAC;QACpC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACpB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QACpB,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,WAAW,GAAG,WAAW,CAAC,CAAC;QAClE,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,WAAW,GAAG,WAAW,EAAE,KAAK,CAAC,CAAC;QAC/D,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjC,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC/B,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;oBACpB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;gBACxC,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IAC/C,CAAC;CACF"}

package/dist/protocol/fwdepz.d.ts

@@ -0,0 +1,21 @@
+/**
+ * `.fwdepz` firmware container parse/validate (contracts/06 §2).
+ * Pure functions — used by the browser flashing flow to validate a dropped
+ * file before touching the device.
+ */
+export declare const FWDEPZ_MAGIC = "FWDEPZ00";
+export declare const FWDEPZ_HEADER_SIZE = 64;
+export declare class FwDepzError extends Error {
+}
+export interface FwDepzImage {
+    loadAddr: number;
+    fwSize: number;
+    fwCrc32: number;
+    curSec: number;
+    totSec: number;
+    payload: Uint8Array;
+}
+/** Validation order (contract 06 §2): magic → header CRC → size. */
+export declare function parseFwDepz(blob: Uint8Array): FwDepzImage;
+export declare function fwDepzPayloadCrcOk(img: FwDepzImage): boolean;
+//# sourceMappingURL=fwdepz.d.ts.map