@thermal-label/brother-ql-web 0.4.0 → 0.6.0

package/dist/printer.js

@@ -1,7 +1,22 @@
-import { DEFAULT_MEDIA, DEVICES, ROTATE_DIRECTION, STATUS_REQUEST, createPreviewOffline, encodeJobForEngine, findDevice, flipHorizontal, parseStatus, pickRotation, renderImage, renderMultiPlaneImage, } from '@thermal-label/brother-ql-core';
-import { MediaNotSpecifiedError } from '@thermal-label/contracts';
+import { DEFAULT_MEDIA, DEVICES, ROTATE_DIRECTION, STATUS_REQUEST, buildInitialize, buildInvalidate, createPreviewOffline, encodeJobForEngine, findDevice, flipHorizontal, parseStatus, pickRotation, renderImage, renderMultiPlaneImage, } from '@thermal-label/brother-ql-core';
+import { MediaNotSpecifiedError, pollingOnStatus, WriteSerializer } from '@thermal-label/contracts';
 import { WebUsbTransport } from '@thermal-label/transport/web';
+// Detect transport errors across module boundaries — under pnpm link /
+// multi-version installs `instanceof` checks against the contracts
+// classes can return false even for the right class. The contracts
+// classes pin `this.name`, so name-checking is the portable test.
+function isTransportClosedError(err) {
+    return err instanceof Error && err.name === 'TransportClosedError';
+}
 const STATUS_BYTE_COUNT = 32;
+// A persistent read loop is the sole reader of the bulk-IN pipe: it
+// parses every 32-byte status frame the printer emits and dispatches it
+// to `statusListeners`. `getStatus()` writes ESC iS and awaits the next
+// frame from that stream; spontaneous frames (lid open/close, media
+// insert, end of job, errors) flow through the same loop. `onStatus()`
+// is a polling shim over `getStatus()` — see that method.
+const STATUS_RESPONSE_TIMEOUT_MS = 1500;
+const READ_LOOP_BACKOFF_MS = 100;
 // Same OUT-pipe chunking as the Node driver — see packages/node/src/printer.ts
 // for the rationale. WebUSB rides the same libusb-style bulk transfer path,
 // so the firmware buffer-overrun risk is identical.
@@ -20,9 +35,34 @@ export class WebBrotherQLPrinter {
     device;
     transport;
     lastStatus;
+    statusListeners = new Set();
+    readLoopStarted = false;
+    readLoopStopped = false;
+    /**
+     * Serialises every bulk-OUT operation (print + getStatus). Required
+     * because `getStatus()` may write the QL preamble (`buildInvalidate` —
+     * 200×0x00 + `ESC @`) to put the parser in a known state, and the
+     * preamble's "invalidate" cancels any in-flight print job. Polling
+     * concurrently with a print would shred the raster stream.
+     *
+     * Plan 15 A4: this was a hand-rolled `writeLock`/`runLocked` pair;
+     * it is now the shared `WriteSerializer` from `@thermal-label/contracts`
+     * so all four drivers serialise identically. Behaviour is unchanged —
+     * `WriteSerializer.run()` is exactly the old `runLocked` semantics.
+     */
+    serializer = new WriteSerializer();
+    /**
+     * Whether the printer's command parser is in a known-clean state.
+     * Set to `true` after a successful `getStatus()`; flipped back to
+     * `false` on timeout so the next attempt re-sends the preamble. The
+     * preamble (200-byte invalidate + `ESC @`) is only needed once per
+     * session unless the parser falls back into a confused state.
+     */
+    parserReady = false;
     constructor(device, transport) {
         this.device = device;
         this.transport = transport;
+        this.startReadLoop();
     }
     get model() {
         return this.device.name;
@@ -39,7 +79,16 @@ export class WebBrotherQLPrinter {
         // on the right side of the printed face when the leading edge is held
         // up. Mirror the rendered bitmap so the input image's x-axis matches
         // the printed x-axis. Verified on QL-820NWBc + DK-22251.
-        const pageOptions = options?.highRes === true ? { highResolution: true } : undefined;
+        // PackBits compression on by default for the web path. Bench
+        // experience: WebUSB pacing alone (1024 / 20 ms) isn't enough on
+        // QL_700-class firmware — uncompressed raster rows can stall the
+        // print engine even when bytes are arriving. Compression keeps
+        // each row small enough to ride the firmware's buffer comfortably
+        // and matches the encoding the Brother driver itself emits.
+        const pageOptions = {
+            compress: true,
+            ...(options?.highRes === true ? { highResolution: true } : {}),
+        };
         let page;
         if (resolvedMedia.palette) {
             const { black, red } = renderMultiPlaneImage(image, {
@@ -50,7 +99,7 @@ export class WebBrotherQLPrinter {
                 bitmap: flipHorizontal(black),
                 redBitmap: flipHorizontal(red),
                 media: resolvedMedia,
-                ...(pageOptions ? { options: pageOptions } : {}),
+                options: pageOptions,
             };
         }
         else {
@@ -58,13 +107,13 @@ export class WebBrotherQLPrinter {
             page = {
                 bitmap,
                 media: resolvedMedia,
-                ...(pageOptions ? { options: pageOptions } : {}),
+                options: pageOptions,
             };
         }
         // eslint-disable-next-line @typescript-eslint/no-non-null-assertion -- every brother-ql device has at least one engine (data invariant)
         const engine = this.device.engines[0];
         const bytes = encodeJobForEngine([page], {}, engine, this.device.name);
-        await this.writeChunked(bytes);
+        await this.serializer.run(() => this.writeChunked(bytes));
     }
     async writeChunked(bytes) {
         for (let off = 0; off < bytes.length; off += USB_CHUNK_SIZE) {
@@ -87,14 +136,125 @@ export class WebBrotherQLPrinter {
             assumed: true,
         });
     }
+    /**
+     * Send ESC iS and resolve with the next status frame the printer
+     * emits. The read loop is the sole reader of the bulk-IN pipe —
+     * `getStatus()` subscribes transiently, writes the request, and the
+     * subscription receives the response (alongside any spontaneous
+     * frames; see `onStatus()`).
+     *
+     * The QL preamble (200×0x00 invalidate + `ESC @` initialize) is
+     * sent only when the parser hasn't been confirmed clean — first
+     * call of the session, or after a previous timeout. Steady-state
+     * polls send bare `ESC iS`. Bench observation: a freshly-opened QL
+     * doesn't reply to bare `ESC iS` until the invalidate flushes any
+     * stale parser state from a prior session.
+     */
     async getStatus() {
-        await this.transport.write(STATUS_REQUEST);
-        const bytes = await this.transport.read(STATUS_BYTE_COUNT);
-        const status = parseStatus(bytes, this.device.engines[0]);
-        this.lastStatus = status;
-        return status;
+        return this.serializer.run(async () => {
+            const next = this.nextStatusFrame(STATUS_RESPONSE_TIMEOUT_MS);
+            if (!this.parserReady) {
+                await this.transport.write(buildInvalidate());
+                await this.transport.write(buildInitialize());
+            }
+            await this.transport.write(STATUS_REQUEST);
+            try {
+                const status = await next;
+                this.parserReady = true;
+                return status;
+            }
+            catch (err) {
+                // Timeout / read failure — printer may be in a confused
+                // state. Re-arm the preamble for the next attempt.
+                this.parserReady = false;
+                throw err;
+            }
+        });
+    }
+    /**
+     * Subscribe to status updates. A polling shim built on
+     * `pollingOnStatus` from contracts — it calls `getStatus()` on first
+     * subscribe and then every `DEFAULT_POLLING_INTERVAL_MS`, matching the
+     * labelwriter and labelmanager web drivers (plan 11 §`onStatus`
+     * parity).
+     *
+     * An earlier revision skipped polling and relied solely on the
+     * printer's unsolicited frames. That was a workaround for the Chromium
+     * WebUSB sub-packet stall — `getStatus()`'s `read()` would hang, so
+     * polling looked unreliable and was dropped. `WebUsbTransport.read()`
+     * now rounds reads up to the endpoint packet size, so `getStatus()` is
+     * dependable and polling is restored.
+     */
+    onStatus(cb) {
+        return pollingOnStatus(this, cb);
+    }
+    nextStatusFrame(timeoutMs) {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.statusListeners.delete(handler);
+                reject(new Error(`Printer did not respond to status request within ${String(timeoutMs)}ms`));
+            }, timeoutMs);
+            const handler = (s) => {
+                clearTimeout(timer);
+                this.statusListeners.delete(handler);
+                resolve(s);
+            };
+            this.statusListeners.add(handler);
+        });
+    }
+    startReadLoop() {
+        /* v8 ignore next -- defensive: startReadLoop is only ever called once, from the constructor, where readLoopStarted is still false; the re-entry guard can never be true */
+        if (this.readLoopStarted)
+            return;
+        this.readLoopStarted = true;
+        void this.readLoop();
+    }
+    async readLoop() {
+        while (!this.readLoopStopped && this.transport.connected) {
+            let bytes;
+            try {
+                bytes = await this.transport.read(STATUS_BYTE_COUNT);
+            }
+            catch (err) {
+                if (isTransportClosedError(err))
+                    return;
+                // If close() ran while the read was pending, the next iteration's
+                // while-guard exits the loop — no early return needed.
+                // Transient error — back off briefly to avoid hot-spinning.
+                // eslint-disable-next-line no-console -- driver-level diagnostic
+                console.warn('[brother-ql-web] status read error, backing off:', err);
+                await new Promise(r => setTimeout(r, READ_LOOP_BACKOFF_MS));
+                continue;
+            }
+            if (bytes.length < STATUS_BYTE_COUNT)
+                continue;
+            let status;
+            try {
+                status = parseStatus(bytes, this.device.engines[0]);
+            }
+            catch (err) {
+                // eslint-disable-next-line no-console -- driver-level diagnostic
+                console.warn('[brother-ql-web] failed to parse status frame:', err);
+                continue;
+            }
+            this.lastStatus = status;
+            // Snapshot listeners so unsubscribes during dispatch don't skip siblings.
+            const snapshot = Array.from(this.statusListeners);
+            for (const cb of snapshot) {
+                try {
+                    cb(status);
+                    /* v8 ignore next 4 -- defensive: the only registrant of statusListeners is nextStatusFrame's internal handler (clearTimeout + delete + resolve), which cannot throw; kept for future persistent-listener callers */
+                }
+                catch (err) {
+                    // eslint-disable-next-line no-console -- driver-level diagnostic
+                    console.warn('[brother-ql-web] status listener threw:', err);
+                }
+            }
+        }
     }
     async close() {
+        this.readLoopStopped = true;
+        this.statusListeners.clear();
         await this.transport.close();
     }
 }
@@ -107,16 +267,46 @@ export const DEFAULT_FILTERS = Object.values(DEVICES)
  *
  * Requires a user gesture. Opens the device and claims interface 0 via
  * `WebUsbTransport.fromDevice()`.
+ *
+ * Single-instance entry point — preserved for back-compat with existing
+ * consumers (CLIs, ad-hoc scripts). For the symmetric driver-web shape
+ * (1-key map keyed by engine role) call `requestPrinters()` instead;
+ * the harness shell uses that path.
+ *
+ * @deprecated Use `requestPrinters({ transport: 'usb' })` from
+ *   `./request-printers.ts`. Removed once consumers migrate (plan 11).
  */
 export async function requestPrinter(options = {}) {
     const filters = options.filters ?? DEFAULT_FILTERS;
     const usbDevice = await navigator.usb.requestDevice({ filters });
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- legacy alias chain; the deprecation guidance is aimed at external callers, not internal usage
     return fromUSBDevice(usbDevice);
 }
+/**
+ * Show the browser's USB picker and return one `PrinterAdapter` per
+ * drivable engine on the selected device, keyed by engine role.
+ *
+ * Brother QL devices are always single-engine — this returns a 1-key
+ * record keyed by the device's `engines[0].role` (typically `'primary'`).
+ *
+ * @deprecated Use the generic `requestPrinters({ transport: 'usb' })`
+ *   from `./request-printers.ts` — the legacy USB-only name is preserved
+ *   as `requestPrintersUsbLegacy` for back-compat. Removed once
+ *   consumers migrate (plan 11).
+ */
+export async function requestPrintersUsbLegacy(options = {}) {
+    const filters = options.filters ?? DEFAULT_FILTERS;
+    const usbDevice = await navigator.usb.requestDevice({ filters });
+    // eslint-disable-next-line @typescript-eslint/no-deprecated -- legacy alias chain
+    return fromUSBDeviceAll(usbDevice);
+}
 /**
  * Wrap an already-selected `USBDevice`.
  *
  * @throws when the VID/PID is not in the Brother QL registry.
+ *
+ * @deprecated Use `requestPrinters({ transport: 'usb' })` from
+ *   `./request-printers.ts`. Removed once consumers migrate (plan 11).
  */
 export async function fromUSBDevice(usbDevice) {
     const descriptor = findDevice(usbDevice.vendorId, usbDevice.productId);
@@ -126,4 +316,29 @@ export async function fromUSBDevice(usbDevice) {
     const transport = await WebUsbTransport.fromDevice(usbDevice);
     return new WebBrotherQLPrinter(descriptor, transport);
 }
+/**
+ * Wrap an already-selected `USBDevice` and return a 1-key adapter map
+ * keyed by the device's `engines[0].role`. Public surface for
+ * `requestPrinters()`; exported so harnesses that already hold a
+ * `USBDevice` (e.g. picked-up via `navigator.usb.getDevices()` on a
+ * returning visit) can skip the picker.
+ *
+ * Brother QL is single-engine and single-interface (IF 0).
+ *
+ * @deprecated Use `requestPrinters({ transport: 'usb' })` from
+ *   `./request-printers.ts`. Removed once consumers migrate (plan 11).
+ */
+export async function fromUSBDeviceAll(usbDevice) {
+    const descriptor = findDevice(usbDevice.vendorId, usbDevice.productId);
+    if (!descriptor) {
+        throw new Error(`Unsupported USB device: VID=0x${usbDevice.vendorId.toString(16)} PID=0x${usbDevice.productId.toString(16)}`);
+    }
+    const engine = descriptor.engines[0];
+    /* v8 ignore next 3 -- defensive: every brother-ql registry entry declares at least one engine (data invariant); guard kept against a malformed future registry edit */
+    if (!engine) {
+        throw new Error(`Device ${descriptor.key} has no engines.`);
+    }
+    const transport = await WebUsbTransport.fromDevice(usbDevice);
+    return { [engine.role]: new WebBrotherQLPrinter(descriptor, transport) };
+}
 //# sourceMappingURL=printer.js.map

package/dist/printer.js.map

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

package/dist/request-printers.d.ts

@@ -0,0 +1,31 @@
+import { type ConnectOptions, type DeviceEntry, type PrinterAdapterMap, type TransportType } from '@thermal-label/contracts';
+/**
+ * Unified browser-picker factory for the brother-ql driver family.
+ *
+ * Dispatches on `opts.transport`:
+ *
+ * - `'usb'` — opens `navigator.usb` picker. Auto-identifies via
+ *   `usbDevice.vendorId/productId` against the registry. Throws
+ *   `DeviceIdentificationRequiredError` only if the picked device's
+ *   VID/PID is not in the brother-ql registry.
+ * - `'bluetooth-spp'` — always-ask (Web Serial has no BT name
+ *   surface). `opts.deviceKey` required; if omitted, throws
+ *   `DeviceIdentificationRequiredError` with the BT-SPP-capable
+ *   subset of `DEVICES` (e.g. QL_820NWBc, PT_P910BT).
+ *   `continueWith(deviceKey)` opens the Web Serial picker for the
+ *   chosen device.
+ * - `'serial'` — not declared in the brother-ql registry today;
+ *   throws unconditionally.
+ * - `'bluetooth-gatt'` — not declared in the brother-ql registry today;
+ *   throws unconditionally.
+ *
+ * Returns a 1-key `PrinterAdapterMap` keyed by the device's primary
+ * engine role.
+ */
+export declare function requestPrinters(opts: ConnectOptions): Promise<PrinterAdapterMap>;
+/**
+ * Filter the registry to entries declaring `transport`. Used to
+ * populate `DeviceIdentificationRequiredError.candidates`.
+ */
+export declare function devicesForTransport(transport: TransportType): readonly DeviceEntry[];
+//# sourceMappingURL=request-printers.d.ts.map

package/dist/request-printers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-printers.d.ts","sourceRoot":"","sources":["../src/request-printers.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EAEtB,KAAK,aAAa,EACnB,MAAM,0BAA0B,CAAC;AAKlC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAWtF;AAgFD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,aAAa,GAAG,SAAS,WAAW,EAAE,CAEpF"}

package/dist/request-printers.js

@@ -0,0 +1,109 @@
+import { DeviceIdentificationRequiredError, } from '@thermal-label/contracts';
+import { DEVICES, findDevice } from '@thermal-label/brother-ql-core';
+import { WebSerialTransport, WebUsbTransport } from '@thermal-label/transport/web';
+import { DEFAULT_FILTERS, WebBrotherQLPrinter } from './printer.js';
+/**
+ * Unified browser-picker factory for the brother-ql driver family.
+ *
+ * Dispatches on `opts.transport`:
+ *
+ * - `'usb'` — opens `navigator.usb` picker. Auto-identifies via
+ *   `usbDevice.vendorId/productId` against the registry. Throws
+ *   `DeviceIdentificationRequiredError` only if the picked device's
+ *   VID/PID is not in the brother-ql registry.
+ * - `'bluetooth-spp'` — always-ask (Web Serial has no BT name
+ *   surface). `opts.deviceKey` required; if omitted, throws
+ *   `DeviceIdentificationRequiredError` with the BT-SPP-capable
+ *   subset of `DEVICES` (e.g. QL_820NWBc, PT_P910BT).
+ *   `continueWith(deviceKey)` opens the Web Serial picker for the
+ *   chosen device.
+ * - `'serial'` — not declared in the brother-ql registry today;
+ *   throws unconditionally.
+ * - `'bluetooth-gatt'` — not declared in the brother-ql registry today;
+ *   throws unconditionally.
+ *
+ * Returns a 1-key `PrinterAdapterMap` keyed by the device's primary
+ * engine role.
+ */
+export async function requestPrinters(opts) {
+    switch (opts.transport) {
+        case 'usb':
+            return requestPrintersUsb(opts);
+        case 'bluetooth-spp':
+            return requestPrintersBluetoothSpp(opts);
+        case 'serial':
+            throw new Error('brother-ql: serial transport not declared in the registry');
+        case 'bluetooth-gatt':
+            throw new Error('brother-ql: bluetooth-gatt transport not declared in the registry');
+    }
+}
+async function requestPrintersUsb(opts) {
+    const filters = DEFAULT_FILTERS;
+    const usbDevice = await navigator.usb.requestDevice({ filters });
+    if (opts.deviceKey !== undefined) {
+        const entry = entryByKey(opts.deviceKey);
+        if (!entry) {
+            throw new Error(`requestPrinters(usb): unknown deviceKey "${opts.deviceKey}"`);
+        }
+        const transport = await WebUsbTransport.fromDevice(usbDevice);
+        return adapterMap(entry, transport);
+    }
+    const entry = findDevice(usbDevice.vendorId, usbDevice.productId);
+    if (entry) {
+        const transport = await WebUsbTransport.fromDevice(usbDevice);
+        return adapterMap(entry, transport);
+    }
+    // No registry match — let the caller pick from the USB-capable
+    // candidates and keep the same USBDevice across the
+    // `continueWith` resume.
+    throw new DeviceIdentificationRequiredError(devicesForTransport('usb'), async (deviceKey) => {
+        const chosen = entryByKey(deviceKey);
+        if (!chosen) {
+            throw new Error(`continueWith: unknown deviceKey "${deviceKey}"`);
+        }
+        const transport = await WebUsbTransport.fromDevice(usbDevice);
+        return adapterMap(chosen, transport);
+    });
+}
+function requestPrintersBluetoothSpp(opts) {
+    if (opts.deviceKey === undefined) {
+        return Promise.reject(new DeviceIdentificationRequiredError(devicesForTransport('bluetooth-spp'), deviceKey => openBluetoothSpp(deviceKey, opts.baudRate)));
+    }
+    return openBluetoothSpp(opts.deviceKey, opts.baudRate);
+}
+async function openBluetoothSpp(deviceKey, baudRate) {
+    const entry = entryByKey(deviceKey);
+    if (!entry) {
+        throw new Error(`requestPrinters(bluetooth-spp): unknown deviceKey "${deviceKey}"`);
+    }
+    if (!entry.transports['bluetooth-spp']) {
+        throw new Error(`requestPrinters(bluetooth-spp): ${deviceKey} does not declare bluetooth-spp transport`);
+    }
+    // SPP baud is negotiated on the link; default to 9600 when not
+    // specified.
+    const transport = await WebSerialTransport.request(undefined, baudRate ?? 9600);
+    return adapterMap(entry, transport);
+}
+function adapterMap(entry, transport) {
+    const engine = entry.engines[0];
+    /* v8 ignore next -- defensive: every brother-ql registry entry declares at least one engine (data invariant); guard kept against a malformed future registry edit */
+    if (!engine)
+        throw new Error(`Device ${entry.key} has no engines.`);
+    // WebBrotherQLPrinter accepts a generic Transport — the encoder is
+    // transport-agnostic, so the BT-SPP path is just the same printer
+    // class wrapped around a WebSerialTransport. Bench-confirmed on
+    // QL-820NWBc.
+    const printer = new WebBrotherQLPrinter(entry, transport);
+    return { [engine.role]: printer };
+}
+/**
+ * Filter the registry to entries declaring `transport`. Used to
+ * populate `DeviceIdentificationRequiredError.candidates`.
+ */
+export function devicesForTransport(transport) {
+    return Object.values(DEVICES).filter(d => transport in d.transports);
+}
+function entryByKey(key) {
+    return DEVICES[key];
+}
+//# sourceMappingURL=request-printers.js.map

package/dist/request-printers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-printers.js","sourceRoot":"","sources":["../src/request-printers.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,GAMlC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEpE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAoB;IACxD,QAAQ,IAAI,CAAC,SAAS,EAAE,CAAC;QACvB,KAAK,KAAK;YACR,OAAO,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,eAAe;YAClB,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC;QAC3C,KAAK,QAAQ;YACX,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC/E,KAAK,gBAAgB;YACnB,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,IAAmD;IAEnD,MAAM,OAAO,GAAG,eAAe,CAAC;IAChC,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;IAEjE,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9D,OAAO,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAClE,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9D,OAAO,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IACtC,CAAC;IAED,+DAA+D;IAC/D,oDAAoD;IACpD,yBAAyB;IACzB,MAAM,IAAI,iCAAiC,CACzC,mBAAmB,CAAC,KAAK,CAAC,EAC1B,KAAK,EAAE,SAAiB,EAAE,EAAE;QAC1B,MAAM,MAAM,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,oCAAoC,SAAS,GAAG,CAAC,CAAC;QACpE,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC9D,OAAO,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAClC,IAA6D;IAE7D,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,iCAAiC,CAAC,mBAAmB,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,EAAE,CACtF,gBAAgB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAC3C,CACF,CAAC;IACJ,CAAC;IACD,OAAO,gBAAgB,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,SAAiB,EAAE,QAAiB;IAClE,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IACpC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,sDAAsD,SAAS,GAAG,CAAC,CAAC;IACtF,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,mCAAmC,SAAS,2CAA2C,CACxF,CAAC;IACJ,CAAC;IACD,+DAA+D;IAC/D,aAAa;IACb,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,SAAS,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC;IAChF,OAAO,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,UAAU,CAAC,KAAkB,EAAE,SAAoB;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAChC,qKAAqK;IACrK,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,GAAG,kBAAkB,CAAC,CAAC;IACpE,mEAAmE;IACnE,kEAAkE;IAClE,gEAAgE;IAChE,cAAc;IACd,MAAM,OAAO,GAAG,IAAI,mBAAmB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAC1D,OAAO,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAwB;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,OAAQ,OAAmD,CAAC,GAAG,CAAC,CAAC;AACnE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thermal-label/brother-ql-web",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "WebUSB browser driver for Brother QL label printers",
   "keywords": [
     "brother",
@@ -13,7 +13,7 @@
   "type": "module",
   "author": "Mannes Brak",
   "license": "MIT",
-  "homepage": "https://thermal-label.github.io/brother-ql/",
+  "homepage": "https://thermal-label.github.io/brother-ql/web",
   "repository": {
     "type": "git",
     "url": "https://github.com/thermal-label/brother-ql.git",
@@ -52,9 +52,9 @@
     }
   },
   "dependencies": {
-    "@thermal-label/contracts": "^0.3.1",
-    "@thermal-label/transport": "^0.3.0",
-    "@thermal-label/brother-ql-core": "0.4.0"
+    "@thermal-label/contracts": "^0.6.0",
+    "@thermal-label/transport": "^0.6.0",
+    "@thermal-label/brother-ql-core": "0.6.0"
   },
   "peerDependencies": {
     "typescript": ">=5.0"