webserial-flasher 1.0.0

package/dist/transport/NodeSerialTransport.js

@@ -0,0 +1,102 @@
+// Node.js transport adapter for webserial-flasher.
+// Works with the `serialport` npm package (https://serialport.io).
+//
+// Usage:
+//   import { SerialPort } from 'serialport';
+//   const port = new SerialPort({ path: '/dev/ttyACM0', baudRate: 115200, autoOpen: false });
+//   await port.open();  // or pass openImmediately:true
+//   const transport = new NodeSerialTransport(port);
+//   const stk = new STK500(transport, board);
+//   await stk.bootload(hex);
+//   await transport.close();
+export class NodeSerialTransport {
+    constructor(port) {
+        this.port = port;
+        // Map user handlers → wrapped handlers so removeListener works correctly
+        this.handlerMap = new Map();
+    }
+    async write(data) {
+        return new Promise((resolve, reject) => {
+            this.port.write(data, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    on(_event, handler) {
+        const wrapped = (buf) => handler(new Uint8Array(buf));
+        this.handlerMap.set(handler, wrapped);
+        this.port.on('data', wrapped);
+    }
+    off(_event, handler) {
+        const wrapped = this.handlerMap.get(handler);
+        if (wrapped) {
+            this.port.removeListener('data', wrapped);
+            this.handlerMap.delete(handler);
+        }
+    }
+    async setSignals(opts) {
+        if (!this.port.set)
+            return; // Port implementation doesn't support signal control
+        return new Promise((resolve, reject) => {
+            this.port.set(opts, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+    /**
+     * Send a BREAK condition for UPDI.
+     *
+     * Uses hardware SET{brk} if the port supports it (serialport >= 10).
+     * Holds TX low for ~12 ms (≥ 12 bit-times at any supported baud rate).
+     */
+    async sendBreak() {
+        if (!this.port.set) {
+            throw new Error('NodeSerialTransport: sendBreak() requires port.set() ' +
+                '(not available on this port implementation)');
+        }
+        await new Promise((resolve, reject) => {
+            this.port.set({ brk: true }, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+        await new Promise((r) => setTimeout(r, 12)); // ≥12 ms = ≥12 bit-times @ 1 Mbaud
+        await new Promise((resolve, reject) => {
+            this.port.set({ brk: false }, (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+        await new Promise((r) => setTimeout(r, 2)); // settling
+    }
+    async close() {
+        this.handlerMap.clear();
+        if (this.port.drain) {
+            await new Promise((resolve) => {
+                this.port.drain((err) => {
+                    if (err) { /* ignore drain errors on close */ }
+                    resolve();
+                });
+            });
+        }
+        if (this.port.close) {
+            await new Promise((resolve) => {
+                this.port.close((err) => {
+                    if (err) { /* ignore */ }
+                    resolve();
+                });
+            });
+        }
+    }
+}
+//# sourceMappingURL=NodeSerialTransport.js.map

package/dist/transport/NodeSerialTransport.js.map

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

package/dist/transport/NodeUSBTransport.d.ts

@@ -0,0 +1,24 @@
+import type { IPicobootTransport } from './IPicobootTransport.js';
+export declare class NodeUSBTransport implements IPicobootTransport {
+    private readonly device;
+    private readonly iface;
+    private readonly outEp;
+    private readonly inEp;
+    private constructor();
+    /**
+     * Find the first RP2040 / RP2350 in BOOTSEL mode, claim the PICOBOOT
+     * interface, and return a ready-to-use transport instance.
+     *
+     * @param vid  USB Vendor ID (default: 0x2E8A — Raspberry Pi)
+     * @param pid  USB Product ID (default: 0x0003 — RP2040 USBBOOT)
+     * @throws STK500ProtocolError if the 'usb' package is missing or no device found
+     */
+    static open(vid?: number, pid?: number): Promise<NodeUSBTransport>;
+    sendCommand(cmd: Uint8Array): Promise<void>;
+    receiveBytes(maxLength: number): Promise<Uint8Array>;
+    sendBytes(data: Uint8Array): Promise<void>;
+    resetInterface(): Promise<void>;
+    close(): Promise<void>;
+    private _transferOut;
+}
+//# sourceMappingURL=NodeUSBTransport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NodeUSBTransport.d.ts","sourceRoot":"","sources":["../../src/transport/NodeUSBTransport.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAIlE,qBAAa,gBAAiB,YAAW,kBAAkB;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAW;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,OAAO;IASP;;;;;;;OAOG;WACU,IAAI,CAAC,GAAG,SAAS,EAAE,GAAG,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAoElE,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAWpD,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1C,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAiB/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B,OAAO,CAAC,YAAY;CAQrB"}

package/dist/transport/NodeUSBTransport.js

@@ -0,0 +1,146 @@
+// Node.js USB transport for the PICOBOOT protocol.
+// Requires the 'usb' npm package: npm install usb
+//
+// Usage:
+//   const transport = await NodeUSBTransport.open();
+//   const pico = new PicoBoot(transport);
+//   await pico.bootload(uf2Data);
+//   await transport.close();
+import { PICOBOOT_INTERFACE } from '../protocol/picoboot/constants.js';
+import { STK500ProtocolError } from '../core/errors.js';
+export class NodeUSBTransport {
+    constructor(device, iface, outEp, inEp) {
+        this.device = device;
+        this.iface = iface;
+        this.outEp = outEp;
+        this.inEp = inEp;
+    }
+    // ── Factory ────────────────────────────────────────────────────────────────
+    /**
+     * Find the first RP2040 / RP2350 in BOOTSEL mode, claim the PICOBOOT
+     * interface, and return a ready-to-use transport instance.
+     *
+     * @param vid  USB Vendor ID (default: 0x2E8A — Raspberry Pi)
+     * @param pid  USB Product ID (default: 0x0003 — RP2040 USBBOOT)
+     * @throws STK500ProtocolError if the 'usb' package is missing or no device found
+     */
+    static async open(vid = 0x2E8A, pid = 0x0003) {
+        // Dynamic import: 'usb' is an optional peer dependency.
+        // The new Function wrapper prevents TypeScript from resolving 'usb' statically,
+        // avoiding build errors when the package is not installed.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        let usbModule;
+        try {
+            // eslint-disable-next-line no-new-func
+            usbModule = await (new Function('m', 'return import(m)'))('usb');
+        }
+        catch {
+            throw new STK500ProtocolError("Package 'usb' is not installed. Run: npm install usb");
+        }
+        const device = (usbModule.findByIds ?? usbModule.default?.findByIds)?.(vid, pid);
+        if (!device) {
+            throw new STK500ProtocolError(`No device found in BOOTSEL mode ` +
+                `(VID=0x${vid.toString(16).toUpperCase()}, PID=0x${pid.toString(16).toUpperCase()}). ` +
+                'Hold the BOOTSEL button while connecting USB.');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const dev = device;
+        dev.open();
+        // Interface 1 = PICOBOOT (vendor class 0xFF).
+        // If the device only exposes 1 interface (MSD without PICOBOOT), that is interface 0.
+        const ifaceCount = dev.interfaces?.length ?? 0;
+        const ifaceIndex = ifaceCount >= 2 ? PICOBOOT_INTERFACE : 0;
+        const iface = dev.interface(ifaceIndex);
+        // Detach kernel driver on Linux / macOS if necessary
+        try {
+            if (iface.isKernelDriverActive?.()) {
+                iface.detachKernelDriver();
+            }
+        }
+        catch {
+            // Not available on Windows — silently ignore
+        }
+        iface.claim();
+        // Discover OUT and IN bulk endpoints dynamically (endpoint addresses vary
+        // between bootrom revisions)
+        let outEp = null;
+        let inEp = null;
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        for (const ep of iface.endpoints) {
+            if (ep.direction === 'out')
+                outEp = ep;
+            else if (ep.direction === 'in')
+                inEp = ep;
+        }
+        if (!outEp || !inEp) {
+            try {
+                dev.close();
+            }
+            catch { /* ignore */ }
+            throw new STK500ProtocolError('PICOBOOT bulk endpoints not found. ' +
+                'Is the device in BOOTSEL mode?');
+        }
+        return new NodeUSBTransport(dev, iface, outEp, inEp);
+    }
+    // ── IPicobootTransport ─────────────────────────────────────────────────────
+    async sendCommand(cmd) {
+        return this._transferOut(cmd);
+    }
+    async receiveBytes(maxLength) {
+        if (maxLength === 0)
+            return new Uint8Array(0);
+        return new Promise((resolve, reject) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.inEp.transfer(maxLength, (err, data) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve(data ? new Uint8Array(data) : new Uint8Array(0));
+            });
+        });
+    }
+    async sendBytes(data) {
+        return this._transferOut(data);
+    }
+    async resetInterface() {
+        // PICOBOOT_RESET control transfer (bmRequestType=0x41, bRequest=0x41)
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const dev = this.device;
+        const iface = this.iface;
+        return new Promise((resolve, reject) => {
+            dev.controlTransfer(0x41, // bmRequestType: host→device, class, interface
+            0x41, // bRequest: PICOBOOT_RESET
+            0, // wValue
+            iface.interfaceNumber ?? 1, // wIndex
+            Buffer.alloc(0), (err) => { if (err)
+                reject(err);
+            else
+                resolve(); });
+        });
+    }
+    async close() {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            await new Promise((res) => this.iface.release(true, () => res()));
+        }
+        catch { /* ignore */ }
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.device.close();
+        }
+        catch { /* ignore */ }
+    }
+    // ── Private ────────────────────────────────────────────────────────────────
+    _transferOut(data) {
+        return new Promise((resolve, reject) => {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            this.outEp.transfer(Buffer.from(data), (err) => {
+                if (err)
+                    reject(err);
+                else
+                    resolve();
+            });
+        });
+    }
+}
+//# sourceMappingURL=NodeUSBTransport.js.map

package/dist/transport/NodeUSBTransport.js.map

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

package/dist/transport/WebSerialTransport.d.ts

@@ -0,0 +1,63 @@
+import type { ISTKTransport, SerialSignals } from './ITransport.js';
+export interface WebSerialPortFilter {
+    usbVendorId?: number;
+    usbProductId?: number;
+}
+type WebSerialPort = any;
+/** Options passed to WebSerial port.open() */
+export interface WebSerialOpenOptions {
+    /** Baud rate (required) */
+    baudRate: number;
+    /** Data bits (default: 8) */
+    dataBits?: 7 | 8;
+    /** Stop bits (default: 1) — use 2 for UPDI */
+    stopBits?: 1 | 2;
+    /** Parity (default: 'none') — use 'even' for UPDI */
+    parity?: 'none' | 'even' | 'odd';
+    /** Flow control (default: 'none') */
+    flowControl?: 'none' | 'hardware';
+}
+export declare class WebSerialTransport implements ISTKTransport {
+    private readonly port;
+    private writer;
+    private reader;
+    private readLoopActive;
+    private readonly listeners;
+    private lastOpenOptions;
+    constructor(port: WebSerialPort);
+    /** Check whether WebSerial is available in the current environment */
+    static isSupported(): boolean;
+    /**
+     * Show the browser's port-picker dialog and return a transport wrapping the selected port.
+     * @param filters - Optional USB vendor/product ID filters to narrow the list shown to the user
+     */
+    static requestPort(filters?: WebSerialPortFilter[]): Promise<WebSerialTransport>;
+    /**
+     * Return transports for all previously-approved ports (no dialog).
+     * Useful for re-connecting without prompting the user again.
+     */
+    static getPorts(): Promise<WebSerialTransport[]>;
+    /** Open the serial port at the given baud rate with optional serial settings */
+    open(baudRate: number, options?: Partial<WebSerialOpenOptions>): Promise<void>;
+    /**
+     * Send a BREAK condition to reset the UPDI state machine.
+     *
+     * Implementation: close the port, reopen at 300 baud 8N1, transmit 0x00
+     * (which produces a ~33 ms break period relative to 115200 baud), then
+     * reopen at the original settings.
+     *
+     * The current port must have been opened with open() before calling this.
+     */
+    sendBreak(): Promise<void>;
+    /** Internal helper: close writer, reader, and port without clearing lastOpenOptions */
+    private _closePort;
+    /** Set DTR/RTS hardware signals to trigger Arduino bootloader entry */
+    setSignals(opts: SerialSignals): Promise<void>;
+    write(data: Uint8Array): Promise<void>;
+    on(_event: 'data', handler: (data: Uint8Array) => void): void;
+    off(_event: 'data', handler: (data: Uint8Array) => void): void;
+    private startReadLoop;
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=WebSerialTransport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"WebSerialTransport.d.ts","sourceRoot":"","sources":["../../src/transport/WebSerialTransport.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEpE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,KAAK,aAAa,GAAG,GAAG,CAAC;AAEzB,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACnC,2BAA2B;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IACjB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IACjC,qCAAqC;IACrC,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;CACnC;AAED,qBAAa,kBAAmB,YAAW,aAAa;IAO1C,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,MAAM,CAAwD;IACtE,OAAO,CAAC,MAAM,CAAwD;IACtE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;IACnE,OAAO,CAAC,eAAe,CAAqC;gBAE/B,IAAI,EAAE,aAAa;IAEhD,sEAAsE;IACtE,MAAM,CAAC,WAAW,IAAI,OAAO;IAI7B;;;OAGG;WACU,WAAW,CACtB,OAAO,GAAE,mBAAmB,EAAO,GAClC,OAAO,CAAC,kBAAkB,CAAC;IAW9B;;;OAGG;WACU,QAAQ,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOtD,gFAAgF;IAC1E,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpF;;;;;;;;OAQG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAyBhC,uFAAuF;YACzE,UAAU;IAYxB,uEAAuE;IACjE,UAAU,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAK5C,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAI7D,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAI9D,OAAO,CAAC,aAAa;IAiBf,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/transport/WebSerialTransport.js

@@ -0,0 +1,159 @@
+// Browser WebSerial API transport for webserial-flasher.
+// Works in Chrome 89+ and Edge 89+. Not available in Firefox or Safari.
+//
+// Usage:
+//   const transport = await WebSerialTransport.requestPort([{ usbVendorId: 0x2341 }]);
+//   await transport.open(115200);
+//   const stk = new STK500(transport, board);
+//   await stk.bootload(hex);
+//   await transport.close();
+export class WebSerialTransport {
+    constructor(port) {
+        this.port = port;
+        this.writer = null;
+        this.reader = null;
+        this.readLoopActive = false;
+        this.listeners = new Set();
+        this.lastOpenOptions = null;
+    }
+    /** Check whether WebSerial is available in the current environment */
+    static isSupported() {
+        return typeof navigator !== 'undefined' && 'serial' in navigator;
+    }
+    /**
+     * Show the browser's port-picker dialog and return a transport wrapping the selected port.
+     * @param filters - Optional USB vendor/product ID filters to narrow the list shown to the user
+     */
+    static async requestPort(filters = []) {
+        if (!WebSerialTransport.isSupported()) {
+            throw new Error('WebSerial API is not supported. Use Chrome 89+ or Edge 89+.');
+        }
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const port = await navigator.serial.requestPort({ filters });
+        return new WebSerialTransport(port);
+    }
+    /**
+     * Return transports for all previously-approved ports (no dialog).
+     * Useful for re-connecting without prompting the user again.
+     */
+    static async getPorts() {
+        if (!WebSerialTransport.isSupported())
+            return [];
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const ports = await navigator.serial.getPorts();
+        return ports.map((p) => new WebSerialTransport(p));
+    }
+    /** Open the serial port at the given baud rate with optional serial settings */
+    async open(baudRate, options) {
+        const opts = {
+            baudRate,
+            dataBits: options?.dataBits ?? 8,
+            stopBits: options?.stopBits ?? 1,
+            parity: options?.parity ?? 'none',
+            flowControl: options?.flowControl ?? 'none',
+        };
+        this.lastOpenOptions = opts;
+        await this.port.open(opts);
+        this.writer = this.port.writable.getWriter();
+        this.reader = this.port.readable.getReader();
+        this.readLoopActive = true;
+        this.startReadLoop();
+    }
+    /**
+     * Send a BREAK condition to reset the UPDI state machine.
+     *
+     * Implementation: close the port, reopen at 300 baud 8N1, transmit 0x00
+     * (which produces a ~33 ms break period relative to 115200 baud), then
+     * reopen at the original settings.
+     *
+     * The current port must have been opened with open() before calling this.
+     */
+    async sendBreak() {
+        if (!this.lastOpenOptions) {
+            throw new Error('WebSerialTransport: call open() before sendBreak()');
+        }
+        const originalOptions = { ...this.lastOpenOptions };
+        // 1. Tear down current connection
+        await this._closePort();
+        // 2. Reopen at 300 baud to generate a BREAK pulse
+        await this.port.open({ baudRate: 300, dataBits: 8, stopBits: 1, parity: 'none', flowControl: 'none' });
+        const breakWriter = this.port.writable.getWriter();
+        await breakWriter.write(new Uint8Array([0x00])); // 0x00 at 300 baud ≈ 33 ms low
+        await new Promise((r) => setTimeout(r, 50)); // ensure byte clocks out
+        breakWriter.releaseLock();
+        await this.port.close();
+        // 3. Reopen at original settings
+        await this.port.open(originalOptions);
+        this.writer = this.port.writable.getWriter();
+        this.reader = this.port.readable.getReader();
+        this.readLoopActive = true;
+        this.startReadLoop();
+    }
+    /** Internal helper: close writer, reader, and port without clearing lastOpenOptions */
+    async _closePort() {
+        this.readLoopActive = false;
+        this.listeners.clear();
+        try {
+            await this.reader?.cancel();
+        }
+        catch { /* ignore */ }
+        try {
+            this.reader?.releaseLock();
+        }
+        catch { /* ignore */ }
+        try {
+            await this.writer?.abort();
+        }
+        catch { /* ignore */ }
+        try {
+            this.writer?.releaseLock();
+        }
+        catch { /* ignore */ }
+        try {
+            await this.port.close();
+        }
+        catch { /* ignore */ }
+        this.reader = null;
+        this.writer = null;
+    }
+    /** Set DTR/RTS hardware signals to trigger Arduino bootloader entry */
+    async setSignals(opts) {
+        // WebSerialPort.setSignals is defined in the WebSerial spec
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        await this.port.setSignals(opts);
+    }
+    async write(data) {
+        if (!this.writer)
+            throw new Error('Transport not open — call open() first');
+        await this.writer.write(data);
+    }
+    on(_event, handler) {
+        this.listeners.add(handler);
+    }
+    off(_event, handler) {
+        this.listeners.delete(handler);
+    }
+    startReadLoop() {
+        void (async () => {
+            while (this.readLoopActive) {
+                try {
+                    const { value, done } = await this.reader.read();
+                    if (done || !this.readLoopActive)
+                        break;
+                    if (value && value.byteLength > 0) {
+                        this.listeners.forEach((fn) => fn(value));
+                    }
+                }
+                catch {
+                    // Port closed externally or connection lost — stop loop silently
+                    break;
+                }
+            }
+        })();
+    }
+    async close() {
+        this.lastOpenOptions = null;
+        await this._closePort();
+    }
+}
+//# sourceMappingURL=WebSerialTransport.js.map

package/dist/transport/WebSerialTransport.js.map

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

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "webserial-flasher",
+  "version": "1.0.0",
+  "description": "Multi-protocol firmware flasher — STK500v1, STK500v2, AVR109, UPDI, PICOBOOT (RP2040) — ESM, TypeScript, Node.js + WebSerial browser support.",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types":  "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "lint": "eslint src",
+    "build": "tsc",
+    "test": "tsx --test test/unit/*.test.ts test/integration/*.test.ts",
+    "test:unit": "tsx --test test/unit/*.test.ts",
+    "test:integration": "tsx --test test/integration/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vielang/webserial-flasher.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vielang/webserial-flasher/issues"
+  },
+  "homepage": "https://github.com/vielang/webserial-flasher#readme",
+  "keywords": [
+    "arduino",
+    "stk500",
+    "stk500v2",
+    "avr109",
+    "updi",
+    "picoboot",
+    "avr",
+    "attiny",
+    "atmega",
+    "rp2040",
+    "raspberry-pi-pico",
+    "avrdude",
+    "typescript",
+    "esm",
+    "webserial",
+    "webusb",
+    "firmware",
+    "flasher"
+  ],
+  "author": "Vie Lang <chongnguoithuong@gmail.com>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "usb": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "usb": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.16.0",
+    "@types/node": "^22.10.1",
+    "eslint": "^9.16.0",
+    "globals": "^15.13.0",
+    "serialport": "^12.0.0",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.18.0"
+  }
+}