@kb1rma/libcomm14cux-ts 0.0.0

package/dist/transport/simulated.js

@@ -0,0 +1,190 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)
+// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.
+// Ported to TypeScript and modified for comm14cux-ts, 2026.
+import { NotConnectedError, TimeoutError } from '../errors.js';
+import { DataSize, MemoryOffset, ReadCountValue } from '../constants.js';
+const MEMORY_SIZE = 0x10000;
+function lengthFromCode(code) {
+    if (code <= 0x0f) {
+        return code + 1;
+    }
+    switch (code) {
+        case ReadCountValue.Count1:
+            return 0x50;
+        case ReadCountValue.Count2:
+            return 0x64;
+        case ReadCountValue.Count3:
+            return 0x190;
+        case ReadCountValue.Count4:
+            return 0x200;
+        default:
+            return undefined;
+    }
+}
+/**
+ * Emulates the ECU's side of the serial protocol over an in-memory 64 KiB
+ * address space. Used for tests and for developing a UI without a car.
+ */
+export class SimulatedTransport {
+    /** The ECU's address space. Tests may read and modify it directly. */
+    memory = new Uint8Array(MEMORY_SIZE);
+    /** Every byte written to the ECU, in order. */
+    written = [];
+    /** Fault injection: invert the next echoed byte. */
+    corruptNextEcho = false;
+    /** Fault injection: never reply. */
+    silent = false;
+    /** Fault injection: reject every write. */
+    failWrites = false;
+    /** Fault injection: stream at most this many bytes per read command. */
+    streamLimit = undefined;
+    #open = false;
+    #state = 'idle';
+    #output = [];
+    #firstCoarse = 0;
+    #coarse = 0;
+    #latched = false;
+    #lengthCode = 0;
+    #writeAddr = 0;
+    /**
+     * Whether the transport is open.
+     *
+     * @returns `true` between {@link SimulatedTransport.open} and {@link SimulatedTransport.close}.
+     */
+    get isOpen() {
+        return this.#open;
+    }
+    /**
+     * Places a 16 KiB firmware image at 0xC000 to 0xFFFF.
+     *
+     * @param image - The ROM image, exactly 0x4000 bytes.
+     * @throws {@link RangeError} if the image is the wrong size.
+     */
+    loadRom(image) {
+        if (image.length !== DataSize.ROM) {
+            throw new RangeError(`ROM image must be ${DataSize.ROM} bytes`);
+        }
+        this.memory.set(image, MemoryOffset.ROMAddress);
+    }
+    /**
+     * Opens the simulated link.
+     *
+     * @returns A promise that resolves immediately.
+     */
+    open() {
+        this.#open = true;
+        return Promise.resolve();
+    }
+    /**
+     * Closes the simulated link and discards any pending ECU output.
+     *
+     * @returns A promise that resolves immediately.
+     */
+    close() {
+        this.#open = false;
+        this.#state = 'idle';
+        this.#latched = false;
+        this.#output = [];
+        return Promise.resolve();
+    }
+    /**
+     * Delivers bytes to the simulated ECU, which may queue a reply.
+     *
+     * @param data - Bytes to send.
+     * @returns A promise that resolves once the bytes are delivered.
+     * @throws {@link NotConnectedError} if the transport is closed.
+     * @throws Error if {@link SimulatedTransport.failWrites} is set.
+     */
+    write(data) {
+        if (!this.#open) {
+            return Promise.reject(new NotConnectedError('Transport is not open'));
+        }
+        if (this.failWrites) {
+            return Promise.reject(new Error('Simulated write failure'));
+        }
+        for (const byte of data) {
+            this.written.push(byte);
+            this.#receive(byte);
+        }
+        return Promise.resolve();
+    }
+    /**
+     * Takes bytes from the simulated ECU's reply.
+     *
+     * @param length - Number of bytes wanted.
+     * @param _timeoutMs - Ignored; the simulation answers immediately.
+     * @returns Exactly `length` bytes.
+     * @throws {@link TimeoutError} if the ECU has not produced that many bytes.
+     * @throws {@link NotConnectedError} if the transport is closed.
+     */
+    read(length, _timeoutMs) {
+        if (!this.#open) {
+            return Promise.reject(new NotConnectedError('Transport is not open'));
+        }
+        if (this.#output.length < length) {
+            this.#output = [];
+            return Promise.reject(new TimeoutError('Simulated ECU is silent'));
+        }
+        return Promise.resolve(Uint8Array.from(this.#output.splice(0, length)));
+    }
+    #echo(byte) {
+        if (this.silent) {
+            return;
+        }
+        if (this.corruptNextEcho) {
+            this.corruptNextEcho = false;
+            this.#output.push(byte ^ 0xff);
+        }
+        else {
+            this.#output.push(byte);
+        }
+    }
+    #receive(byte) {
+        if (this.#state === 'writeValue') {
+            this.memory[this.#writeAddr] = byte;
+            this.#echo(byte);
+            this.#state = 'idle';
+            this.#latched = false;
+            return;
+        }
+        if (this.#state === 'coarse2') {
+            this.#coarse = ((this.#firstCoarse & 0x03) << 14) | (byte << 6);
+            this.#lengthCode = (this.#firstCoarse >> 2) & 0x1f;
+            this.#echo(byte);
+            this.#state = 'idle';
+            this.#latched = true;
+            return;
+        }
+        if (byte < 0x80) {
+            this.#firstCoarse = byte;
+            this.#echo(byte);
+            this.#state = 'coarse2';
+            this.#latched = false;
+        }
+        else if (!this.#latched) {
+            // A command byte without a preceding coarse address is ignored.
+        }
+        else if ((byte & 0xc0) === 0xc0) {
+            this.#streamRead(this.#coarse | (byte & 0x3f));
+        }
+        else {
+            this.#writeAddr = this.#coarse | (byte & 0x3f);
+            this.#echo(byte);
+            this.#state = 'writeValue';
+        }
+    }
+    #streamRead(address) {
+        if (this.silent) {
+            return;
+        }
+        let length = lengthFromCode(this.#lengthCode) ?? 0;
+        if (this.streamLimit !== undefined) {
+            length = Math.min(length, this.streamLimit);
+        }
+        for (let i = 0; i < length; i++) {
+            this.#output.push(this.memory[(address + i) % MEMORY_SIZE] ?? 0);
+        }
+    }
+}
+//# sourceMappingURL=simulated.js.map

package/dist/transport/simulated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulated.js","sourceRoot":"","sources":["../../src/transport/simulated.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,4EAA4E;AAC5E,+DAA+D;AAC/D,4DAA4D;AAC5D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGzE,MAAM,WAAW,GAAG,OAAO,CAAC;AAI5B,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QACjB,OAAO,IAAI,GAAG,CAAC,CAAC;IAClB,CAAC;IAED,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,cAAc,CAAC,MAAM;YACxB,OAAO,IAAI,CAAC;QACd,KAAK,cAAc,CAAC,MAAM;YACxB,OAAO,IAAI,CAAC;QACd,KAAK,cAAc,CAAC,MAAM;YACxB,OAAO,KAAK,CAAC;QACf,KAAK,cAAc,CAAC,MAAM;YACxB,OAAO,KAAK,CAAC;QACf;YACE,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,kBAAkB;IAC7B,sEAAsE;IAC7D,MAAM,GAAG,IAAI,UAAU,CAAC,WAAW,CAAC,CAAC;IAC9C,+CAA+C;IACtC,OAAO,GAAa,EAAE,CAAC;IAEhC,oDAAoD;IACpD,eAAe,GAAG,KAAK,CAAC;IACxB,oCAAoC;IACpC,MAAM,GAAG,KAAK,CAAC;IACf,2CAA2C;IAC3C,UAAU,GAAG,KAAK,CAAC;IACnB,wEAAwE;IACxE,WAAW,GAAuB,SAAS,CAAC;IAE5C,KAAK,GAAG,KAAK,CAAC;IACd,MAAM,GAAU,MAAM,CAAC;IACvB,OAAO,GAAa,EAAE,CAAC;IACvB,YAAY,GAAG,CAAC,CAAC;IACjB,OAAO,GAAG,CAAC,CAAC;IACZ,QAAQ,GAAG,KAAK,CAAC;IACjB,WAAW,GAAG,CAAC,CAAC;IAChB,UAAU,GAAG,CAAC,CAAC;IAEf;;;;OAIG;IACH,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,KAAiB;QACvB,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,GAAG,EAAE,CAAC;YAClC,MAAM,IAAI,UAAU,CAAC,qBAAqB,QAAQ,CAAC,GAAG,QAAQ,CAAC,CAAC;QAClE,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAElB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACtB,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAElB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAgB;QACpB,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,iBAAiB,CAAC,uBAAuB,CAAC,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC,CAAC;QAC9D,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC3B,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,MAAc,EAAE,UAAkB;QACrC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,iBAAiB,CAAC,uBAAuB,CAAC,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;YACjC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;YAElB,OAAO,OAAO,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,yBAAyB,CAAC,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,IAAY;QAChB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,QAAQ,CAAC,IAAY;QACnB,IAAI,IAAI,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;YACpC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YAEtB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;YAChE,IAAI,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;YACnD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;YAErB,OAAO;QACT,CAAC;QAED,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;YAChB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;QACxB,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1B,gEAAgE;QAClE,CAAC;aAAM,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACjB,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,WAAW,CAAC,OAAe;QACzB,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAI,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAEnD,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAChC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,CAAC;IACH,CAAC;CACF","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Derived from libcomm14cux (https://github.com/colinbourassa/libcomm14cux)\n// Copyright (C) Colin Bourassa. Licensed under the GNU GPL v3.\n// Ported to TypeScript and modified for comm14cux-ts, 2026.\nimport { NotConnectedError, TimeoutError } from '../errors.js';\nimport { DataSize, MemoryOffset, ReadCountValue } from '../constants.js';\nimport type { Transport } from './types.js';\n\nconst MEMORY_SIZE = 0x10000;\n\ntype State = 'idle' | 'coarse2' | 'writeValue';\n\nfunction lengthFromCode(code: number): number | undefined {\n  if (code <= 0x0f) {\n    return code + 1;\n  }\n\n  switch (code) {\n    case ReadCountValue.Count1:\n      return 0x50;\n    case ReadCountValue.Count2:\n      return 0x64;\n    case ReadCountValue.Count3:\n      return 0x190;\n    case ReadCountValue.Count4:\n      return 0x200;\n    default:\n      return undefined;\n  }\n}\n\n/**\n * Emulates the ECU's side of the serial protocol over an in-memory 64 KiB\n * address space. Used for tests and for developing a UI without a car.\n */\nexport class SimulatedTransport implements Transport {\n  /** The ECU's address space. Tests may read and modify it directly. */\n  readonly memory = new Uint8Array(MEMORY_SIZE);\n  /** Every byte written to the ECU, in order. */\n  readonly written: number[] = [];\n\n  /** Fault injection: invert the next echoed byte. */\n  corruptNextEcho = false;\n  /** Fault injection: never reply. */\n  silent = false;\n  /** Fault injection: reject every write. */\n  failWrites = false;\n  /** Fault injection: stream at most this many bytes per read command. */\n  streamLimit: number | undefined = undefined;\n\n  #open = false;\n  #state: State = 'idle';\n  #output: number[] = [];\n  #firstCoarse = 0;\n  #coarse = 0;\n  #latched = false;\n  #lengthCode = 0;\n  #writeAddr = 0;\n\n  /**\n   * Whether the transport is open.\n   *\n   * @returns `true` between {@link SimulatedTransport.open} and {@link SimulatedTransport.close}.\n   */\n  get isOpen(): boolean {\n    return this.#open;\n  }\n\n  /**\n   * Places a 16 KiB firmware image at 0xC000 to 0xFFFF.\n   *\n   * @param image - The ROM image, exactly 0x4000 bytes.\n   * @throws {@link RangeError} if the image is the wrong size.\n   */\n  loadRom(image: Uint8Array): void {\n    if (image.length !== DataSize.ROM) {\n      throw new RangeError(`ROM image must be ${DataSize.ROM} bytes`);\n    }\n\n    this.memory.set(image, MemoryOffset.ROMAddress);\n  }\n\n  /**\n   * Opens the simulated link.\n   *\n   * @returns A promise that resolves immediately.\n   */\n  open(): Promise<void> {\n    this.#open = true;\n\n    return Promise.resolve();\n  }\n\n  /**\n   * Closes the simulated link and discards any pending ECU output.\n   *\n   * @returns A promise that resolves immediately.\n   */\n  close(): Promise<void> {\n    this.#open = false;\n    this.#state = 'idle';\n    this.#latched = false;\n    this.#output = [];\n\n    return Promise.resolve();\n  }\n\n  /**\n   * Delivers bytes to the simulated ECU, which may queue a reply.\n   *\n   * @param data - Bytes to send.\n   * @returns A promise that resolves once the bytes are delivered.\n   * @throws {@link NotConnectedError} if the transport is closed.\n   * @throws Error if {@link SimulatedTransport.failWrites} is set.\n   */\n  write(data: Uint8Array): Promise<void> {\n    if (!this.#open) {\n      return Promise.reject(new NotConnectedError('Transport is not open'));\n    }\n\n    if (this.failWrites) {\n      return Promise.reject(new Error('Simulated write failure'));\n    }\n\n    for (const byte of data) {\n      this.written.push(byte);\n      this.#receive(byte);\n    }\n\n    return Promise.resolve();\n  }\n\n  /**\n   * Takes bytes from the simulated ECU's reply.\n   *\n   * @param length - Number of bytes wanted.\n   * @param _timeoutMs - Ignored; the simulation answers immediately.\n   * @returns Exactly `length` bytes.\n   * @throws {@link TimeoutError} if the ECU has not produced that many bytes.\n   * @throws {@link NotConnectedError} if the transport is closed.\n   */\n  read(length: number, _timeoutMs: number): Promise<Uint8Array> {\n    if (!this.#open) {\n      return Promise.reject(new NotConnectedError('Transport is not open'));\n    }\n\n    if (this.#output.length < length) {\n      this.#output = [];\n\n      return Promise.reject(new TimeoutError('Simulated ECU is silent'));\n    }\n\n    return Promise.resolve(Uint8Array.from(this.#output.splice(0, length)));\n  }\n\n  #echo(byte: number): void {\n    if (this.silent) {\n      return;\n    }\n\n    if (this.corruptNextEcho) {\n      this.corruptNextEcho = false;\n      this.#output.push(byte ^ 0xff);\n    } else {\n      this.#output.push(byte);\n    }\n  }\n\n  #receive(byte: number): void {\n    if (this.#state === 'writeValue') {\n      this.memory[this.#writeAddr] = byte;\n      this.#echo(byte);\n      this.#state = 'idle';\n      this.#latched = false;\n\n      return;\n    }\n\n    if (this.#state === 'coarse2') {\n      this.#coarse = ((this.#firstCoarse & 0x03) << 14) | (byte << 6);\n      this.#lengthCode = (this.#firstCoarse >> 2) & 0x1f;\n      this.#echo(byte);\n      this.#state = 'idle';\n      this.#latched = true;\n\n      return;\n    }\n\n    if (byte < 0x80) {\n      this.#firstCoarse = byte;\n      this.#echo(byte);\n      this.#state = 'coarse2';\n      this.#latched = false;\n    } else if (!this.#latched) {\n      // A command byte without a preceding coarse address is ignored.\n    } else if ((byte & 0xc0) === 0xc0) {\n      this.#streamRead(this.#coarse | (byte & 0x3f));\n    } else {\n      this.#writeAddr = this.#coarse | (byte & 0x3f);\n      this.#echo(byte);\n      this.#state = 'writeValue';\n    }\n  }\n\n  #streamRead(address: number): void {\n    if (this.silent) {\n      return;\n    }\n\n    let length = lengthFromCode(this.#lengthCode) ?? 0;\n\n    if (this.streamLimit !== undefined) {\n      length = Math.min(length, this.streamLimit);\n    }\n\n    for (let i = 0; i < length; i++) {\n      this.#output.push(this.memory[(address + i) % MEMORY_SIZE] ?? 0);\n    }\n  }\n}\n"]}

package/dist/transport/types.d.ts

@@ -0,0 +1,9 @@
+/** Byte-level link to the ECU. The protocol layer uses nothing else. */
+export interface Transport {
+    open(): Promise<void>;
+    close(): Promise<void>;
+    write(data: Uint8Array): Promise<void>;
+    /** Resolves with exactly `length` bytes, or rejects with a TimeoutError. */
+    read(length: number, timeoutMs: number): Promise<Uint8Array>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/transport/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAGA,wEAAwE;AACxE,MAAM,WAAW,SAAS;IACxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,4EAA4E;IAC5E,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC9D"}

package/dist/transport/types.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Copyright (C) 2026 comm14cux-ts contributors
+export {};
+//# sourceMappingURL=types.js.map

package/dist/transport/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/transport/types.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,+CAA+C","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Copyright (C) 2026 comm14cux-ts contributors\n\n/** Byte-level link to the ECU. The protocol layer uses nothing else. */\nexport interface Transport {\n  open(): Promise<void>;\n  close(): Promise<void>;\n  write(data: Uint8Array): Promise<void>;\n  /** Resolves with exactly `length` bytes, or rejects with a TimeoutError. */\n  read(length: number, timeoutMs: number): Promise<Uint8Array>;\n}\n"]}

package/dist/transport/webSerial.d.ts

@@ -0,0 +1,49 @@
+import type { Transport } from './types.js';
+/**
+ * Options for {@link WebSerialTransport}.
+ */
+export interface WebSerialTransportOptions {
+    /** 7812 for standard ECUs; 15625 for modified double-speed firmware. */
+    baudRate?: number;
+}
+/** `Transport` over a Web Serial `SerialPort` (8N1, no flow control). */
+export declare class WebSerialTransport implements Transport {
+    #private;
+    /**
+     * Wraps a serial port. The port is not opened until {@link WebSerialTransport.open}.
+     *
+     * @param port - A port the user has granted access to, from
+     * `navigator.serial.requestPort()`.
+     * @param options - Optional settings.
+     */
+    constructor(port: SerialPort, options?: WebSerialTransportOptions);
+    /**
+     * Opens the port at the configured baud rate, 8N1 with no flow control.
+     * Does nothing if already open.
+     */
+    open(): Promise<void>;
+    /**
+     * Cancels any pending read, releases the stream locks and closes the port.
+     * Does nothing if not open.
+     */
+    close(): Promise<void>;
+    /**
+     * Writes bytes to the port.
+     *
+     * @param data - Bytes to send.
+     * @throws {@link NotConnectedError} if the port is not open.
+     */
+    write(data: Uint8Array): Promise<void>;
+    /**
+     * Reads exactly `length` bytes, assembling them from as many chunks as needed.
+     * Surplus bytes are kept for the next call.
+     *
+     * @param length - Number of bytes wanted.
+     * @param timeoutMs - Longest silence to wait for more data, in milliseconds.
+     * @returns Exactly `length` bytes.
+     * @throws {@link TimeoutError} if no data arrives within `timeoutMs`.
+     * @throws {@link NotConnectedError} if the port is not open or the stream ends.
+     */
+    read(length: number, timeoutMs: number): Promise<Uint8Array>;
+}
+//# sourceMappingURL=webSerial.d.ts.map

package/dist/transport/webSerial.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSerial.d.ts","sourceRoot":"","sources":["../../src/transport/webSerial.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,qBAAa,kBAAmB,YAAW,SAAS;;IAQlD;;;;;;OAMG;gBACS,IAAI,EAAE,UAAU,EAAE,OAAO,GAAE,yBAA8B;IAKrE;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB3B;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB5B;;;;;OAKG;IACG,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ5C;;;;;;;;;OASG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;CA2DnE"}

package/dist/transport/webSerial.js

@@ -0,0 +1,129 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Copyright (C) 2026 comm14cux-ts contributors
+import { BAUD } from '../constants.js';
+import { NotConnectedError, TimeoutError } from '../errors.js';
+/** `Transport` over a Web Serial `SerialPort` (8N1, no flow control). */
+export class WebSerialTransport {
+    #port;
+    #baudRate;
+    #reader;
+    #writer;
+    #pending;
+    #leftover = new Uint8Array(0);
+    /**
+     * Wraps a serial port. The port is not opened until {@link WebSerialTransport.open}.
+     *
+     * @param port - A port the user has granted access to, from
+     * `navigator.serial.requestPort()`.
+     * @param options - Optional settings.
+     */
+    constructor(port, options = {}) {
+        this.#port = port;
+        this.#baudRate = options.baudRate ?? BAUD;
+    }
+    /**
+     * Opens the port at the configured baud rate, 8N1 with no flow control.
+     * Does nothing if already open.
+     */
+    async open() {
+        if (this.#reader) {
+            return;
+        }
+        await this.#port.open({
+            baudRate: this.#baudRate,
+            dataBits: 8,
+            stopBits: 1,
+            parity: 'none',
+            flowControl: 'none',
+        });
+        this.#reader = this.#port.readable?.getReader();
+        this.#writer = this.#port.writable?.getWriter();
+    }
+    /**
+     * Cancels any pending read, releases the stream locks and closes the port.
+     * Does nothing if not open.
+     */
+    async close() {
+        const reader = this.#reader;
+        const writer = this.#writer;
+        this.#reader = undefined;
+        this.#writer = undefined;
+        this.#pending = undefined;
+        this.#leftover = new Uint8Array(0);
+        if (!reader) {
+            return;
+        }
+        await reader.cancel().catch(() => undefined);
+        reader.releaseLock();
+        writer?.releaseLock();
+        await this.#port.close();
+    }
+    /**
+     * Writes bytes to the port.
+     *
+     * @param data - Bytes to send.
+     * @throws {@link NotConnectedError} if the port is not open.
+     */
+    async write(data) {
+        if (!this.#writer) {
+            throw new NotConnectedError('Serial port is not open');
+        }
+        await this.#writer.write(data);
+    }
+    /**
+     * Reads exactly `length` bytes, assembling them from as many chunks as needed.
+     * Surplus bytes are kept for the next call.
+     *
+     * @param length - Number of bytes wanted.
+     * @param timeoutMs - Longest silence to wait for more data, in milliseconds.
+     * @returns Exactly `length` bytes.
+     * @throws {@link TimeoutError} if no data arrives within `timeoutMs`.
+     * @throws {@link NotConnectedError} if the port is not open or the stream ends.
+     */
+    async read(length, timeoutMs) {
+        const reader = this.#reader;
+        if (!reader) {
+            throw new NotConnectedError('Serial port is not open');
+        }
+        const result = new Uint8Array(length);
+        let filled = 0;
+        while (filled < length) {
+            if (this.#leftover.length === 0) {
+                this.#leftover = await this.#nextChunk(reader, timeoutMs);
+            }
+            const take = Math.min(length - filled, this.#leftover.length);
+            result.set(this.#leftover.subarray(0, take), filled);
+            this.#leftover = this.#leftover.subarray(take);
+            filled += take;
+        }
+        return result;
+    }
+    async #nextChunk(reader, timeoutMs) {
+        // A read that timed out is still pending; reuse it so no data is lost.
+        const pending = (this.#pending ??= reader.read());
+        let timer;
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => {
+                reject(new TimeoutError(`No data from ECU for ${timeoutMs} ms`));
+            }, timeoutMs);
+        });
+        try {
+            const chunk = await Promise.race([pending, timeout]);
+            this.#pending = undefined;
+            if (chunk.done) {
+                throw new NotConnectedError('Serial stream ended');
+            }
+            return chunk.value;
+        }
+        catch (error) {
+            if (!(error instanceof TimeoutError)) {
+                this.#pending = undefined;
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=webSerial.js.map

package/dist/transport/webSerial.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webSerial.js","sourceRoot":"","sources":["../../src/transport/webSerial.ts"],"names":[],"mappings":"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","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Copyright (C) 2026 comm14cux-ts contributors\n\nimport { BAUD } from '../constants.js';\nimport { NotConnectedError, TimeoutError } from '../errors.js';\nimport type { Transport } from './types.js';\n\n/**\n * Options for {@link WebSerialTransport}.\n */\nexport interface WebSerialTransportOptions {\n  /** 7812 for standard ECUs; 15625 for modified double-speed firmware. */\n  baudRate?: number;\n}\n\n/** `Transport` over a Web Serial `SerialPort` (8N1, no flow control). */\nexport class WebSerialTransport implements Transport {\n  readonly #port: SerialPort;\n  readonly #baudRate: number;\n  #reader: ReadableStreamDefaultReader<Uint8Array> | undefined;\n  #writer: WritableStreamDefaultWriter<Uint8Array> | undefined;\n  #pending: Promise<ReadableStreamReadResult<Uint8Array>> | undefined;\n  #leftover: Uint8Array = new Uint8Array(0);\n\n  /**\n   * Wraps a serial port. The port is not opened until {@link WebSerialTransport.open}.\n   *\n   * @param port - A port the user has granted access to, from\n   * `navigator.serial.requestPort()`.\n   * @param options - Optional settings.\n   */\n  constructor(port: SerialPort, options: WebSerialTransportOptions = {}) {\n    this.#port = port;\n    this.#baudRate = options.baudRate ?? BAUD;\n  }\n\n  /**\n   * Opens the port at the configured baud rate, 8N1 with no flow control.\n   * Does nothing if already open.\n   */\n  async open(): Promise<void> {\n    if (this.#reader) {\n      return;\n    }\n\n    await this.#port.open({\n      baudRate: this.#baudRate,\n      dataBits: 8,\n      stopBits: 1,\n      parity: 'none',\n      flowControl: 'none',\n    });\n    this.#reader = this.#port.readable?.getReader();\n    this.#writer = this.#port.writable?.getWriter();\n  }\n\n  /**\n   * Cancels any pending read, releases the stream locks and closes the port.\n   * Does nothing if not open.\n   */\n  async close(): Promise<void> {\n    const reader = this.#reader;\n    const writer = this.#writer;\n\n    this.#reader = undefined;\n    this.#writer = undefined;\n    this.#pending = undefined;\n    this.#leftover = new Uint8Array(0);\n\n    if (!reader) {\n      return;\n    }\n\n    await reader.cancel().catch(() => undefined);\n    reader.releaseLock();\n    writer?.releaseLock();\n    await this.#port.close();\n  }\n\n  /**\n   * Writes bytes to the port.\n   *\n   * @param data - Bytes to send.\n   * @throws {@link NotConnectedError} if the port is not open.\n   */\n  async write(data: Uint8Array): Promise<void> {\n    if (!this.#writer) {\n      throw new NotConnectedError('Serial port is not open');\n    }\n\n    await this.#writer.write(data);\n  }\n\n  /**\n   * Reads exactly `length` bytes, assembling them from as many chunks as needed.\n   * Surplus bytes are kept for the next call.\n   *\n   * @param length - Number of bytes wanted.\n   * @param timeoutMs - Longest silence to wait for more data, in milliseconds.\n   * @returns Exactly `length` bytes.\n   * @throws {@link TimeoutError} if no data arrives within `timeoutMs`.\n   * @throws {@link NotConnectedError} if the port is not open or the stream ends.\n   */\n  async read(length: number, timeoutMs: number): Promise<Uint8Array> {\n    const reader = this.#reader;\n\n    if (!reader) {\n      throw new NotConnectedError('Serial port is not open');\n    }\n\n    const result = new Uint8Array(length);\n    let filled = 0;\n\n    while (filled < length) {\n      if (this.#leftover.length === 0) {\n        this.#leftover = await this.#nextChunk(reader, timeoutMs);\n      }\n\n      const take = Math.min(length - filled, this.#leftover.length);\n\n      result.set(this.#leftover.subarray(0, take), filled);\n      this.#leftover = this.#leftover.subarray(take);\n      filled += take;\n    }\n\n    return result;\n  }\n\n  async #nextChunk(\n    reader: ReadableStreamDefaultReader<Uint8Array>,\n    timeoutMs: number,\n  ): Promise<Uint8Array> {\n    // A read that timed out is still pending; reuse it so no data is lost.\n    const pending = (this.#pending ??= reader.read());\n    let timer: ReturnType<typeof setTimeout> | undefined;\n\n    const timeout = new Promise<never>((_, reject) => {\n      timer = setTimeout(() => {\n        reject(new TimeoutError(`No data from ECU for ${timeoutMs} ms`));\n      }, timeoutMs);\n    });\n\n    try {\n      const chunk = await Promise.race([pending, timeout]);\n\n      this.#pending = undefined;\n\n      if (chunk.done) {\n        throw new NotConnectedError('Serial stream ended');\n      }\n\n      return chunk.value;\n    } catch (error) {\n      if (!(error instanceof TimeoutError)) {\n        this.#pending = undefined;\n      }\n\n      throw error;\n    } finally {\n      clearTimeout(timer);\n    }\n  }\n}\n"]}

package/dist/version.d.ts

@@ -0,0 +1,18 @@
+/** Major/minor/patch version of this library (`c14cux_version`). */
+export interface Version {
+    /**
+     * Major version number.
+     */
+    major: number;
+    /**
+     * Minor version number.
+     */
+    minor: number;
+    /**
+     * Patch version number.
+     */
+    patch: number;
+}
+/** Must match `version` in package.json (enforced by a test). */
+export declare const LIBRARY_VERSION: Version;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,oEAAoE;AACpE,MAAM,WAAW,OAAO;IACtB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CACf;AAED,iEAAiE;AACjE,eAAO,MAAM,eAAe,EAAE,OAA0C,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Copyright (C) 2026 comm14cux-ts contributors
+/** Must match `version` in package.json (enforced by a test). */
+export const LIBRARY_VERSION = { major: 0, minor: 0, patch: 0 };
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,+CAA+C;AAkB/C,iEAAiE;AACjE,MAAM,CAAC,MAAM,eAAe,GAAY,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC","sourcesContent":["// SPDX-License-Identifier: GPL-3.0-only\n// Copyright (C) 2026 comm14cux-ts contributors\n\n/** Major/minor/patch version of this library (`c14cux_version`). */\nexport interface Version {\n  /**\n   * Major version number.\n   */\n  major: number;\n  /**\n   * Minor version number.\n   */\n  minor: number;\n  /**\n   * Patch version number.\n   */\n  patch: number;\n}\n\n/** Must match `version` in package.json (enforced by a test). */\nexport const LIBRARY_VERSION: Version = { major: 0, minor: 0, patch: 0 };\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+	"name": "@kb1rma/libcomm14cux-ts",
+	"version": "0.0.0",
+	"description": "TypeScript library for communicating with the Lucas 14CUX engine ECU over a serial port using the Web Serial API",
+	"license": "GPL-3.0-only",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/KB1RMA/comm14cux-ts.git"
+	},
+	"type": "module",
+	"packageManager": "npm@11.8.0",
+	"engines": {
+		"node": ">=24"
+	},
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src",
+		"!src/**/*.test.ts",
+		"LICENSE",
+		"README.md"
+	],
+	"scripts": {
+		"build": "tsc -p tsconfig.build.json",
+		"lint": "eslint .",
+		"lint:fix": "eslint . --fix",
+		"type:check": "tsc --noEmit",
+		"test": "vitest",
+		"test:ui": "vitest --ui",
+		"test:coverage": "vitest --coverage",
+		"test:acceptance": "vitest run --config vitest.acceptance.config.ts",
+		"test:acceptance:dist": "npm run build && tsc -p tsconfig.acceptance.dist.json && ACCEPTANCE_TARGET=dist vitest run --config vitest.acceptance.config.ts"
+	},
+	"devDependencies": {
+		"@eslint/js": "^10.0.0",
+		"@types/node": "^25.9.1",
+		"@types/w3c-web-serial": "^1.0.8",
+		"@vitest/coverage-v8": "^4.1.11",
+		"@vitest/eslint-plugin": "^1.6.27",
+		"@vitest/ui": "^4.0.18",
+		"eslint": "^10.8.1",
+		"eslint-config-prettier": "^10.1.8",
+		"eslint-plugin-jsdoc": "^65.1.0",
+		"eslint-plugin-prettier": "^5.5.6",
+		"eslint-plugin-tsdoc": "^0.5.4",
+		"prettier": "^3.9.6",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.67.0",
+		"vitest": "^4.0.18"
+	}
+}

package/src/bytes.ts

@@ -0,0 +1,13 @@
+// SPDX-License-Identifier: GPL-3.0-only
+// Copyright (C) 2026 comm14cux-ts contributors
+
+/**
+ * Reads an unsigned big-endian 16-bit value, the ECU's byte order.
+ *
+ * @param bytes - Buffer to read from.
+ * @param offset - Index of the high byte. Defaults to 0.
+ * @returns The value, 0 to 65535. A missing byte is treated as 0.
+ */
+export function be16(bytes: Uint8Array, offset = 0): number {
+  return ((bytes[offset] ?? 0) << 8) | (bytes[offset + 1] ?? 0);
+}