@thermal-label/brother-ql-node 0.0.1 → 0.3.0

package/dist/discovery.js

@@ -1,11 +1,19 @@
-import usb from 'usb';
 import { DEVICES, findDevice, isMassStorageMode } from '@thermal-label/brother-ql-core';
-import {} from './types.js';
+import { SerialTransport, TcpTransport, UsbTransport } from '@thermal-label/transport/node';
+import * as usb from 'usb';
+import { BrotherQLPrinter } from './printer.js';
 const BROTHER_VID = 0x04f9;
-export function listPrinters() {
+async function readSerialNumber(device, idx) {
+    return new Promise(resolve => {
+        device.getStringDescriptor(idx, (err, value) => {
+            resolve(err ? undefined : value);
+        });
+    });
+}
+async function enumerateUsbDevices() {
     const results = [];
-    for (const usbDevice of usb.getDeviceList()) {
-        const desc = usbDevice.deviceDescriptor;
+    for (const device of usb.getDeviceList()) {
+        const desc = device.deviceDescriptor;
         if (desc.idVendor !== BROTHER_VID)
             continue;
         if (isMassStorageMode(desc.idProduct)) {
@@ -14,18 +22,83 @@ export function listPrinters() {
                 'Hold the Editor Lite button until the LED turns off to switch to printer mode.');
             continue;
         }
-        const device = findDevice(desc.idVendor, desc.idProduct);
-        if (!device)
+        const descriptor = findDevice(desc.idVendor, desc.idProduct);
+        if (!descriptor)
             continue;
-        const path = `${usbDevice.busNumber.toString()}.${usbDevice.deviceAddress.toString()}`;
-        results.push({
-            device,
-            serialNumber: undefined,
-            path,
+        let serialNumber;
+        if (desc.iSerialNumber) {
+            device.open();
+            try {
+                serialNumber = await readSerialNumber(device, desc.iSerialNumber);
+            }
+            finally {
+                device.close();
+            }
+        }
+        results.push({ device, descriptor, serialNumber });
+    }
+    return results;
+}
+/**
+ * `PrinterDiscovery` implementation for Brother QL printers.
+ *
+ * `listPrinters()` enumerates USB and skips printers in Editor Lite
+ * mass-storage mode (a warning is logged — the user has to switch
+ * them out of Editor Lite manually). Network printers open via
+ * `openPrinter({ host, port })`; there is no mDNS implementation so
+ * `listPrinters()` never surfaces them.
+ */
+export class BrotherQLDiscovery {
+    family = 'brother-ql';
+    async listPrinters() {
+        const found = await enumerateUsbDevices();
+        return found.map(({ device, descriptor, serialNumber }) => ({
+            device: descriptor,
+            ...(serialNumber === undefined ? {} : { serialNumber }),
             transport: 'usb',
+            connectionId: `${String(device.busNumber)}.${String(device.deviceAddress)}`,
+        }));
+    }
+    async openPrinter(options = {}) {
+        if (options.path !== undefined) {
+            const transport = await SerialTransport.open(options.path, options.baudRate);
+            // Serial (typically RFCOMM) carries no identifying metadata —
+            // fall back to the most capable descriptor with a serial
+            // transport tag. `getStatus()` still returns accurate
+            // detectedMedia regardless of which descriptor we attach.
+            const descriptor = Object.values(DEVICES).find(d => d.transports.includes('serial'));
+            /* v8 ignore next -- DEVICES always has QL_820NWB with 'serial' in transports */
+            if (!descriptor)
+                throw new Error('No serial-capable Brother QL descriptor found.');
+            return new BrotherQLPrinter(descriptor, transport, 'serial');
+        }
+        if (options.host !== undefined) {
+            const transport = await TcpTransport.connect(options.host, options.port);
+            const descriptor = Object.values(DEVICES).find(d => d.network !== 'none');
+            /* v8 ignore next -- DEVICES always has network-capable entries */
+            if (!descriptor)
+                throw new Error('No network-capable Brother QL descriptor found.');
+            return new BrotherQLPrinter(descriptor, transport, 'tcp');
+        }
+        const found = await enumerateUsbDevices();
+        const match = found.find(entry => {
+            if (options.vid !== undefined && entry.descriptor.vid !== options.vid)
+                return false;
+            if (options.pid !== undefined && entry.descriptor.pid !== options.pid)
+                return false;
+            if (options.serialNumber !== undefined && entry.serialNumber !== options.serialNumber)
+                return false;
+            return true;
         });
+        if (!match)
+            throw new Error('No compatible Brother QL printer found.');
+        const transport = await UsbTransport.open(match.descriptor.vid, match.descriptor.pid);
+        return new BrotherQLPrinter(match.descriptor, transport, 'usb');
     }
-    return results;
 }
-export { DEVICES };
+/**
+ * Named export discovered by the unified `thermal-label-cli` — the CLI
+ * walks installed drivers looking for `mod.discovery`.
+ */
+export const discovery = new BrotherQLDiscovery();
 //# sourceMappingURL=discovery.js.map

package/dist/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACxF,OAAO,EAAoB,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,GAAG,MAAM,CAAC;AAE3B,MAAM,UAAU,YAAY;IAC1B,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,KAAK,MAAM,SAAS,IAAI,GAAG,CAAC,aAAa,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,SAAS,CAAC,gBAAgB,CAAC;QACxC,IAAI,IAAI,CAAC,QAAQ,KAAK,WAAW;YAAE,SAAS;QAE5C,IAAI,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,sCAAsC;YACtC,OAAO,CAAC,IAAI,CACV,2EAA2E,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,KAAK;gBACvH,gFAAgF,CACnF,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,MAAM,IAAI,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,SAAS,CAAC,aAAa,CAAC,QAAQ,EAAE,EAAE,CAAC;QAEvF,OAAO,CAAC,IAAI,CAAC;YACX,MAAM;YACN,YAAY,EAAE,SAAS;YACvB,IAAI;YACJ,SAAS,EAAE,KAAK;SACjB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,9 +1,4 @@
-export { UsbTransport, TcpTransport } from './transport.js';
-export { BrotherQLPrinter, openPrinter, openPrinterTcp } from './printer.js';
-export { listPrinters } from './discovery.js';
-export { UnsupportedOperationError, PrinterError } from './errors.js';
-export type { Transport } from './transport.js';
-export type { OpenOptions, PrinterInfo } from './types.js';
-export { DEVICES, MEDIA, findDevice, findMedia, findMediaByWidth, encodeJob, renderText, renderImage, } from '@thermal-label/brother-ql-core';
-export type { DeviceDescriptor, MediaDescriptor, PageData, PageOptions, JobOptions, PrinterStatus, LabelBitmap, RawImageData, MediaType, TextPrintOptions, ImagePrintOptions, } from '@thermal-label/brother-ql-core';
+export { BrotherQLDiscovery, discovery } from './discovery.js';
+export type { BrotherQLOpenOptions } from './discovery.js';
+export { BrotherQLPrinter } from './printer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEtE,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG3D,OAAO,EACL,OAAO,EACP,KAAK,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,gCAAgC,CAAC;AACxC,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,QAAQ,EACR,WAAW,EACX,UAAU,EACV,aAAa,EACb,WAAW,EACX,YAAY,EACZ,SAAS,EACT,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,7 +1,3 @@
-export { UsbTransport, TcpTransport } from './transport.js';
-export { BrotherQLPrinter, openPrinter, openPrinterTcp } from './printer.js';
-export { listPrinters } from './discovery.js';
-export { UnsupportedOperationError, PrinterError } from './errors.js';
-// Re-export core API so consumers only need one import
-export { DEVICES, MEDIA, findDevice, findMedia, findMediaByWidth, encodeJob, renderText, renderImage, } from '@thermal-label/brother-ql-core';
+export { BrotherQLDiscovery, discovery } from './discovery.js';
+export { BrotherQLPrinter } from './printer.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKtE,uDAAuD;AACvD,OAAO,EACL,OAAO,EACP,KAAK,EACL,UAAU,EACV,SAAS,EACT,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,WAAW,GACZ,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC"}

package/dist/printer.d.ts

@@ -1,18 +1,41 @@
-import { type DeviceDescriptor, type MediaDescriptor, type PageData, type PageOptions, type JobOptions, type PrinterStatus, type LabelBitmap, type TextPrintOptions, type ImagePrintOptions } from '@thermal-label/brother-ql-core';
-import { type Transport } from './transport.js';
-import { type OpenOptions } from './types.js';
-export declare class BrotherQLPrinter {
-    readonly device: DeviceDescriptor;
-    readonly transport: 'usb' | 'tcp';
-    private readonly _transport;
-    constructor(transport: Transport, device: DeviceDescriptor, transportType: 'usb' | 'tcp');
-    getStatus(): Promise<PrinterStatus>;
-    print(pages: PageData[], options?: JobOptions): Promise<void>;
-    printText(text: string, media: MediaDescriptor, options?: TextPrintOptions): Promise<void>;
-    printImage(image: Buffer | string, media: MediaDescriptor, options?: ImagePrintOptions): Promise<void>;
-    printTwoColor(black: LabelBitmap, red: LabelBitmap, media: MediaDescriptor, options?: PageOptions): Promise<void>;
+import type { BrotherQLDevice, BrotherQLPrintOptions, BrotherQLStatus, MediaDescriptor, PreviewOptions, PreviewResult, PrinterAdapter, RawImageData, Transport, TransportType } from '@thermal-label/brother-ql-core';
+/**
+ * Node.js driver for Brother QL label printers.
+ *
+ * Implements `PrinterAdapter`. Callers get a printer instance from
+ * `discovery.openPrinter()` (USB or TCP) and interact solely through
+ * the adapter surface: `print(rgba, media?, options?)`, `createPreview`,
+ * `getStatus`, `close`.
+ *
+ * Multi-ink media (DK-22251) is handled transparently — when the
+ * resolved media carries a `palette`, the driver runs the bitmap
+ * library's `renderMultiPlaneImage()` internally before encoding.
+ *
+ * Orientation is auto-decided via `pickRotation`: landscape input on
+ * media tagged `defaultOrientation: 'horizontal'` rotates 90° CW so
+ * the visual reads along the tape feed direction. Override per-call
+ * with `options.rotate`.
+ */
+export declare class BrotherQLPrinter implements PrinterAdapter {
+    readonly family: "brother-ql";
+    readonly device: BrotherQLDevice;
+    readonly transportType: TransportType;
+    private readonly transport;
+    private lastStatus;
+    constructor(device: BrotherQLDevice, transport: Transport, transportType: TransportType);
+    get model(): string;
+    get connected(): boolean;
+    print(image: RawImageData, media?: MediaDescriptor, options?: BrotherQLPrintOptions): Promise<void>;
+    private writeChunked;
+    createPreview(image: RawImageData, options?: PreviewOptions): Promise<PreviewResult>;
+    /**
+     * Poll the status endpoint until 32 bytes are available.
+     *
+     * The USB `transferAsync()` call resolves immediately with 0 bytes if
+     * the printer hasn't queued a response yet, so retry with a short
+     * delay up to `STATUS_POLL_ATTEMPTS` times.
+     */
+    getStatus(): Promise<BrotherQLStatus>;
     close(): Promise<void>;
 }
-export declare function openPrinter(options?: OpenOptions): Promise<BrotherQLPrinter>;
-export declare function openPrinterTcp(host: string, port?: number): Promise<BrotherQLPrinter>;
 //# sourceMappingURL=printer.d.ts.map

package/dist/printer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../src/printer.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACvB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAI5E,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,KAAK,GAAG,KAAK,CAAC;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAY;gBAE3B,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAK,GAAG,KAAK;IAMlF,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IAYnC,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAK7D,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB1F,UAAU,CACd,KAAK,EAAE,MAAM,GAAG,MAAM,EACtB,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAyBV,aAAa,CACjB,KAAK,EAAE,WAAW,EAClB,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,eAAe,EACtB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,IAAI,CAAC;IAgBV,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B;AAED,wBAAsB,WAAW,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgBlF;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,SAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkBzF"}
+{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../src/printer.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,eAAe,EAEf,qBAAqB,EACrB,eAAe,EAEf,eAAe,EAEf,cAAc,EACd,aAAa,EACb,cAAc,EACd,YAAY,EACZ,SAAS,EACT,aAAa,EACd,MAAM,gCAAgC,CAAC;AAoBxC;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,QAAQ,CAAC,MAAM,eAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,UAAU,CAA8B;gBAEpC,MAAM,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa;IAMvF,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAEK,KAAK,CACT,KAAK,EAAE,YAAY,EACnB,KAAK,CAAC,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC,IAAI,CAAC;YAgCF,YAAY;IAU1B,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAWpF;;;;;;OAMG;IACG,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAcrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/printer.js

@@ -1,167 +1,126 @@
-import { encodeJob, findDevice, renderText, renderImage, } from '@thermal-label/brother-ql-core';
-import { rotateBitmap } from '@mbtech-nl/bitmap';
-import { UsbTransport, TcpTransport } from './transport.js';
-import { parseStatus, STATUS_REQUEST } from './status.js';
-import { listPrinters } from './discovery.js';
-import { UnsupportedOperationError } from './errors.js';
-import {} from './types.js';
-const BROTHER_VID = 0x04f9;
+import { DEFAULT_MEDIA, ROTATE_DIRECTION, STATUS_REQUEST, createPreviewOffline, encodeJob, flipHorizontal, parseStatus, pickRotation, renderImage, renderMultiPlaneImage, } from '@thermal-label/brother-ql-core';
+import { MediaNotSpecifiedError } from '@thermal-label/contracts';
+const STATUS_BYTE_COUNT = 32;
+const STATUS_POLL_INTERVAL_MS = 150;
+const STATUS_POLL_ATTEMPTS = 10;
+// Empirical: a single libusb bulk transfer of an entire raster job (~50 kB
+// uncompressed two-colour at 280 rows) reliably hangs the QL-820NWBc
+// firmware mid-print. Chunking the OUT pipe to ~1 kB with a 20 ms gap
+// keeps the printer's input ring buffer drained at roughly its raster
+// processing rate (~175 bytes/ms at 80 mm/s feed). Adds about 1 s to a
+// 50 kB job, which is negligible compared to physical print time.
+//
+// Python `brother_ql` users hit this less often because the typical CLI
+// path writes through `/dev/usb/lpN` where the kernel's usblp driver
+// provides flow control; libusb bypasses that.
+const USB_CHUNK_SIZE = 1024;
+const USB_CHUNK_DELAY_MS = 20;
+/**
+ * Node.js driver for Brother QL label printers.
+ *
+ * Implements `PrinterAdapter`. Callers get a printer instance from
+ * `discovery.openPrinter()` (USB or TCP) and interact solely through
+ * the adapter surface: `print(rgba, media?, options?)`, `createPreview`,
+ * `getStatus`, `close`.
+ *
+ * Multi-ink media (DK-22251) is handled transparently — when the
+ * resolved media carries a `palette`, the driver runs the bitmap
+ * library's `renderMultiPlaneImage()` internally before encoding.
+ *
+ * Orientation is auto-decided via `pickRotation`: landscape input on
+ * media tagged `defaultOrientation: 'horizontal'` rotates 90° CW so
+ * the visual reads along the tape feed direction. Override per-call
+ * with `options.rotate`.
+ */
 export class BrotherQLPrinter {
+    family = 'brother-ql';
     device;
+    transportType;
     transport;
-    _transport;
-    constructor(transport, device, transportType) {
-        this._transport = transport;
+    lastStatus;
+    constructor(device, transport, transportType) {
         this.device = device;
-        this.transport = transportType;
+        this.transport = transport;
+        this.transportType = transportType;
     }
-    async getStatus() {
-        await this._transport.write(STATUS_REQUEST);
-        // The USB IN endpoint (transferAsync) resolves immediately with 0 bytes if
-        // the printer hasn't queued its response yet. Retry until we have 32 bytes.
-        for (let attempt = 0; attempt < 10; attempt++) {
-            await new Promise(r => setTimeout(r, 150));
-            const bytes = await this._transport.read(32);
-            if (bytes.length >= 32)
-                return parseStatus(bytes);
-        }
-        throw new Error('Printer did not respond to status request within 1.5s');
+    get model() {
+        return this.device.name;
     }
-    async print(pages, options) {
-        const data = encodeJob(pages, options);
-        await this._transport.write(data);
-    }
-    async printText(text, media, options) {
-        const { invert, scaleX, scaleY, ...pageOptions } = options ?? {};
-        // Scale so the label is roughly square: largest integer scale where neither the tape
-        // width (base.heightPx axis) nor the label length (base.widthPx axis) exceeds printAreaDots.
-        const base = renderText(text, { scaleX: 1, scaleY: 1 });
-        const autoScale = Math.max(1, Math.floor(media.printAreaDots / Math.max(base.widthPx, base.heightPx)));
-        const effectiveScaleY = scaleY ?? autoScale;
-        const effectiveScaleX = scaleX ?? autoScale;
-        const rawBitmap = renderText(text, {
-            ...(invert !== undefined ? { invert } : {}),
-            scaleX: effectiveScaleX,
-            scaleY: effectiveScaleY,
-        });
-        const bitmap = rotateBitmap(rawBitmap, 270);
-        const page = {
-            bitmap,
-            media,
-            ...(Object.keys(pageOptions).length > 0 ? { options: pageOptions } : {}),
-        };
-        await this.print([page]);
+    get connected() {
+        return this.transport.connected;
     }
-    async printImage(image, media, options) {
-        const { threshold, dither, invert, rotate, ...pageOptions } = options ?? {};
-        let rawImageData;
-        if (typeof image === 'string') {
-            rawImageData = await loadImageFile(image);
+    async print(image, media, options) {
+        const resolvedMedia = (media ?? this.lastStatus?.detectedMedia);
+        if (!resolvedMedia) {
+            throw new MediaNotSpecifiedError();
+        }
+        const rotate = pickRotation(image, resolvedMedia, ROTATE_DIRECTION, options?.rotate);
+        // Brother QL print head: pin 0 (the first pin in each raster row) sits
+        // 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.
+        let page;
+        if (resolvedMedia.palette) {
+            const { black, red } = renderMultiPlaneImage(image, {
+                palette: resolvedMedia.palette,
+                rotate,
+            });
+            page = {
+                bitmap: flipHorizontal(black),
+                redBitmap: flipHorizontal(red),
+                media: resolvedMedia,
+            };
         }
         else {
-            rawImageData = await decodeBuffer(image);
+            const bitmap = flipHorizontal(renderImage(image, { dither: true, rotate }));
+            page = { bitmap, media: resolvedMedia };
         }
-        const rawBitmap = renderImage(rawImageData, {
-            ...(threshold !== undefined ? { threshold } : {}),
-            ...(dither !== undefined ? { dither } : {}),
-            ...(invert !== undefined ? { invert } : {}),
-            ...(rotate !== undefined ? { rotate } : {}),
-        });
-        const bitmap = rotateBitmap(rawBitmap, 270);
-        const page = {
-            bitmap,
-            media,
-            ...(Object.keys(pageOptions).length > 0 ? { options: pageOptions } : {}),
-        };
-        await this.print([page]);
+        const bytes = encodeJob([page]);
+        await this.writeChunked(bytes);
     }
-    async printTwoColor(black, red, media, options) {
-        if (!this.device.twoColor) {
-            throw new UnsupportedOperationError(`${this.device.name} does not support two-color printing. ` +
-                'Two-color printing requires a QL-800, QL-810W, or QL-820NWB with DK-22251 labels.');
+    async writeChunked(bytes) {
+        for (let off = 0; off < bytes.length; off += USB_CHUNK_SIZE) {
+            const end = Math.min(off + USB_CHUNK_SIZE, bytes.length);
+            await this.transport.write(bytes.subarray(off, end));
+            if (end < bytes.length) {
+                await new Promise(r => setTimeout(r, USB_CHUNK_DELAY_MS));
+            }
         }
-        const page = {
-            bitmap: black,
-            redBitmap: red,
-            media,
-            ...(options !== undefined ? { options } : {}),
-        };
-        await this.print([page]);
-    }
-    async close() {
-        await this._transport.close();
-    }
-}
-export async function openPrinter(options) {
-    const { vid = BROTHER_VID, pid } = options ?? {};
-    if (pid) {
-        const device = findDevice(vid, pid);
-        if (!device)
-            throw new Error(`Unknown device: ${vid.toString(16)}:${pid.toString(16)}`);
-        const transport = await UsbTransport.open(vid, pid);
-        return new BrotherQLPrinter(transport, device, 'usb');
     }
-    const printers = listPrinters();
-    if (printers.length === 0)
-        throw new Error('No Brother QL printers found');
-    const info = printers[0];
-    if (!info)
-        throw new Error('No Brother QL printers found');
-    const transport = await UsbTransport.open(info.device.vid, info.device.pid);
-    return new BrotherQLPrinter(transport, info.device, 'usb');
-}
-export async function openPrinterTcp(host, port = 9100) {
-    const transport = await TcpTransport.connect(host, port);
-    // We can't know the device descriptor from TCP alone — request status and detect
-    // Fall back to a generic QL-820NWB descriptor (most capable, verified by maintainer)
-    const status = await (async () => {
-        await transport.write(new Uint8Array([0x1b, 0x69, 0x53]));
-        return transport.read(32);
-    })();
-    const mediaWidthMm = status[10] ?? 0;
-    // Try to find a matching device by network capability
-    const { DEVICES } = await import('@thermal-label/brother-ql-core');
-    const networkDevice = Object.values(DEVICES).find(d => d.network !== 'none');
-    const device = networkDevice ?? DEVICES.QL_820NWB;
-    void mediaWidthMm; // may be used for smarter detection in future
-    return new BrotherQLPrinter(transport, device, 'tcp');
-}
-async function loadImageFile(filePath) {
-    try {
-        const canvas = await import('@napi-rs/canvas');
-        const img = await canvas.loadImage(filePath);
-        const canvasEl = canvas.createCanvas(img.width, img.height);
-        const ctx = canvasEl.getContext('2d');
-        ctx.drawImage(img, 0, 0);
-        const imageData = ctx.getImageData(0, 0, img.width, img.height);
-        return {
-            width: img.width,
-            height: img.height,
-            data: new Uint8Array(imageData.data.buffer),
-        };
-    }
-    catch {
-        throw new Error('Cannot load image file: install @napi-rs/canvas for image file support, ' +
-            'or pass a pre-decoded RawImageData to print().');
+    createPreview(image, options) {
+        const override = options?.media;
+        const detected = this.lastStatus?.detectedMedia;
+        if (override)
+            return Promise.resolve(createPreviewOffline(image, override));
+        if (detected)
+            return Promise.resolve(createPreviewOffline(image, detected));
+        return Promise.resolve({
+            ...createPreviewOffline(image, DEFAULT_MEDIA),
+            assumed: true,
+        });
     }
-}
-async function decodeBuffer(buffer) {
-    try {
-        const canvas = await import('@napi-rs/canvas');
-        const img = await canvas.loadImage(buffer);
-        const canvasEl = canvas.createCanvas(img.width, img.height);
-        const ctx = canvasEl.getContext('2d');
-        ctx.drawImage(img, 0, 0);
-        const imageData = ctx.getImageData(0, 0, img.width, img.height);
-        return {
-            width: img.width,
-            height: img.height,
-            data: new Uint8Array(imageData.data.buffer),
-        };
+    /**
+     * Poll the status endpoint until 32 bytes are available.
+     *
+     * The USB `transferAsync()` call resolves immediately with 0 bytes if
+     * the printer hasn't queued a response yet, so retry with a short
+     * delay up to `STATUS_POLL_ATTEMPTS` times.
+     */
+    async getStatus() {
+        await this.transport.write(STATUS_REQUEST);
+        for (let attempt = 0; attempt < STATUS_POLL_ATTEMPTS; attempt++) {
+            await new Promise(r => setTimeout(r, STATUS_POLL_INTERVAL_MS));
+            const bytes = await this.transport.read(STATUS_BYTE_COUNT);
+            if (bytes.length >= STATUS_BYTE_COUNT) {
+                const status = parseStatus(bytes);
+                this.lastStatus = status;
+                return status;
+            }
+        }
+        throw new Error('Printer did not respond to status request within 1.5s');
     }
-    catch {
-        throw new Error('Cannot decode image buffer: install @napi-rs/canvas for PNG/JPEG decoding, ' +
-            'or pass a pre-decoded RawImageData to print().');
+    async close() {
+        await this.transport.close();
     }
 }
 //# 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thermal-label/brother-ql-node",
-  "version": "0.0.1",
+  "version": "0.3.0",
   "description": "Node.js USB and TCP driver for Brother QL label printers",
   "keywords": [
     "brother",
@@ -45,17 +45,19 @@
   },
   "sideEffects": false,
   "main": "./dist/index.js",
-  "types": "./src/index.ts",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
       "import": "./dist/index.js",
-      "types": "./src/index.ts"
+      "types": "./dist/index.d.ts"
     }
   },
   "dependencies": {
-    "@mbtech-nl/bitmap": "^0.1.0",
+    "@mbtech-nl/bitmap": "^1.2.1",
+    "@thermal-label/contracts": "^0.2.0",
+    "@thermal-label/transport": "^0.2.1",
     "usb": "^2.0.0",
-    "@thermal-label/brother-ql-core": "0.0.1"
+    "@thermal-label/brother-ql-core": "0.3.0"
   },
   "optionalDependencies": {
     "@napi-rs/canvas": "^0.1.0"

package/dist/__tests__/errors.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=errors.test.d.ts.map

package/dist/__tests__/errors.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/errors.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/errors.test.js

@@ -1,20 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { UnsupportedOperationError, PrinterError } from '../errors.js';
-describe('UnsupportedOperationError', () => {
-    it('sets name and message', () => {
-        const err = new UnsupportedOperationError('not supported');
-        expect(err.name).toBe('UnsupportedOperationError');
-        expect(err.message).toBe('not supported');
-        expect(err).toBeInstanceOf(Error);
-    });
-});
-describe('PrinterError', () => {
-    it('sets name, message, and errors array', () => {
-        const err = new PrinterError('printer failed', ['Cover open', 'No media']);
-        expect(err.name).toBe('PrinterError');
-        expect(err.message).toBe('printer failed');
-        expect(err.errors).toEqual(['Cover open', 'No media']);
-        expect(err).toBeInstanceOf(Error);
-    });
-});
-//# sourceMappingURL=errors.test.js.map

package/dist/__tests__/errors.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.test.js","sourceRoot":"","sources":["../../src/__tests__/errors.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEvE,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,uBAAuB,EAAE,GAAG,EAAE;QAC/B,MAAM,GAAG,GAAG,IAAI,yBAAyB,CAAC,eAAe,CAAC,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QACnD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,GAAG,GAAG,IAAI,YAAY,CAAC,gBAAgB,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACtC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC3C,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}