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

package/dist/__tests__/discovery.test.js

@@ -1,77 +1,150 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => {
-    /* suppress */
-});
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const { usbOpen, tcpConnect, serialOpen } = vi.hoisted(() => ({
+    usbOpen: vi.fn(),
+    tcpConnect: vi.fn(),
+    serialOpen: vi.fn(),
+}));
+vi.mock('@thermal-label/transport/node', () => ({
+    UsbTransport: { open: usbOpen },
+    TcpTransport: { connect: tcpConnect },
+    SerialTransport: { open: serialOpen },
+}));
 vi.mock('usb', () => ({
-    default: {
-        getDeviceList: vi.fn(() => []),
-    },
+    getDeviceList: vi.fn(() => []),
 }));
+import * as usb from 'usb';
+import { discovery } from '../discovery.js';
+function fakeTransport() {
+    return {
+        connected: true,
+        write: vi.fn(),
+        read: vi.fn(),
+        close: vi.fn(),
+    };
+}
+function makeUsbDevice(idVendor, idProduct, serialNumber) {
+    return {
+        deviceDescriptor: {
+            idVendor,
+            idProduct,
+            iSerialNumber: serialNumber ? 3 : 0,
+        },
+        busNumber: 1,
+        deviceAddress: 2,
+        open: vi.fn(),
+        close: vi.fn(),
+        getStringDescriptor: vi.fn((_idx, cb) => {
+            cb(null, serialNumber);
+        }),
+    };
+}
+const warnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {
+    /* suppress */
+});
 beforeEach(() => {
-    consoleSpy.mockClear();
+    usbOpen.mockReset();
+    tcpConnect.mockReset();
+    serialOpen.mockReset();
+    warnSpy.mockClear();
+    vi.mocked(usb.getDeviceList).mockReset().mockReturnValue([]);
 });
-describe('listPrinters', () => {
-    it('returns known Brother QL devices from USB enumeration', async () => {
-        const usb = await import('usb');
-        vi.mocked(usb.default.getDeviceList).mockReturnValueOnce([
-            {
-                deviceDescriptor: { idVendor: 0x04f9, idProduct: 0x20a7 },
-                busNumber: 1,
-                deviceAddress: 3,
-            },
-        ]);
-        const { listPrinters } = await import('../discovery.js');
-        const printers = listPrinters();
-        expect(printers).toHaveLength(1);
-        expect(printers[0].device.name).toBe('QL-820NWB');
-        expect(printers[0].transport).toBe('usb');
-    });
-    it('excludes unknown (non-Brother) USB devices', async () => {
-        const usb = await import('usb');
-        vi.mocked(usb.default.getDeviceList).mockReturnValueOnce([
-            {
-                deviceDescriptor: { idVendor: 0x1234, idProduct: 0x5678 },
-                busNumber: 1,
-                deviceAddress: 1,
-            },
-        ]);
-        const { listPrinters } = await import('../discovery.js');
-        const printers = listPrinters();
-        expect(printers).toHaveLength(0);
-    });
-    it('excludes mass storage mode PIDs and logs a warning', async () => {
-        const usb = await import('usb');
-        vi.mocked(usb.default.getDeviceList).mockReturnValueOnce([
-            {
-                deviceDescriptor: { idVendor: 0x04f9, idProduct: 0x20aa },
-                busNumber: 1,
-                deviceAddress: 2,
-            },
-        ]);
-        const { listPrinters } = await import('../discovery.js');
-        const printers = listPrinters();
-        expect(printers).toHaveLength(0);
-        expect(consoleSpy).toHaveBeenCalledOnce();
-        expect(consoleSpy.mock.calls[0][0]).toContain('Editor Lite');
+describe('BrotherQLDiscovery', () => {
+    it('exposes the brother-ql family', () => {
+        expect(discovery.family).toBe('brother-ql');
     });
-    it('returns empty array when no printers connected', async () => {
-        const { listPrinters } = await import('../discovery.js');
-        const printers = listPrinters();
-        expect(printers).toHaveLength(0);
+    describe('listPrinters', () => {
+        it('returns known Brother QL devices from USB enumeration', async () => {
+            vi.mocked(usb.getDeviceList).mockReturnValueOnce([makeUsbDevice(0x04f9, 0x20a7)]);
+            const printers = await discovery.listPrinters();
+            expect(printers).toHaveLength(1);
+            expect(printers[0].device.name).toBe('QL-820NWB');
+            expect(printers[0].transport).toBe('usb');
+            expect(printers[0].connectionId).toBe('1.2');
+        });
+        it('excludes unknown (non-Brother) USB devices', async () => {
+            vi.mocked(usb.getDeviceList).mockReturnValueOnce([makeUsbDevice(0x1234, 0x5678)]);
+            expect(await discovery.listPrinters()).toHaveLength(0);
+        });
+        it('excludes Brother-VID devices with unknown PIDs', async () => {
+            // Brother VID but not in the DEVICES registry and not a mass-storage PID
+            vi.mocked(usb.getDeviceList).mockReturnValueOnce([makeUsbDevice(0x04f9, 0x9999)]);
+            expect(await discovery.listPrinters()).toHaveLength(0);
+            expect(warnSpy).not.toHaveBeenCalled();
+        });
+        it('excludes mass-storage PIDs and warns', async () => {
+            vi.mocked(usb.getDeviceList).mockReturnValueOnce([makeUsbDevice(0x04f9, 0x20aa)]);
+            expect(await discovery.listPrinters()).toHaveLength(0);
+            expect(warnSpy).toHaveBeenCalledOnce();
+        });
+        it('reads the serial number when iSerialNumber is set', async () => {
+            vi.mocked(usb.getDeviceList).mockReturnValueOnce([
+                makeUsbDevice(0x04f9, 0x20a7, 'SN123'),
+            ]);
+            const [printer] = await discovery.listPrinters();
+            expect(printer?.serialNumber).toBe('SN123');
+        });
+        it('swallows serial-read errors and leaves serialNumber undefined', async () => {
+            const device = makeUsbDevice(0x04f9, 0x20a7, 'ignored');
+            device.getStringDescriptor.mockImplementation((_idx, cb) => {
+                cb(new Error('descriptor read failed'));
+            });
+            vi.mocked(usb.getDeviceList).mockReturnValueOnce([device]);
+            const [printer] = await discovery.listPrinters();
+            expect(printer?.serialNumber).toBeUndefined();
+        });
     });
-    it('excludes Brother devices with unrecognized non-mass-storage PID', async () => {
-        const usb = await import('usb');
-        vi.mocked(usb.default.getDeviceList).mockReturnValueOnce([
-            {
-                deviceDescriptor: { idVendor: 0x04f9, idProduct: 0x9999 },
-                busNumber: 1,
-                deviceAddress: 4,
-            },
-        ]);
-        const { listPrinters } = await import('../discovery.js');
-        const printers = listPrinters();
-        expect(printers).toHaveLength(0);
-        expect(consoleSpy).not.toHaveBeenCalled();
+    describe('openPrinter', () => {
+        it('opens a USB printer via UsbTransport', async () => {
+            vi.mocked(usb.getDeviceList).mockReturnValueOnce([makeUsbDevice(0x04f9, 0x20a7)]);
+            usbOpen.mockResolvedValue(fakeTransport());
+            const printer = await discovery.openPrinter();
+            expect(printer.device.pid).toBe(0x20a7);
+            expect(usbOpen).toHaveBeenCalledWith(0x04f9, 0x20a7);
+        });
+        it('filters by VID/PID when multiple devices are attached', async () => {
+            vi.mocked(usb.getDeviceList).mockReturnValueOnce([
+                makeUsbDevice(0x04f9, 0x20a7),
+                makeUsbDevice(0x04f9, 0x209b),
+            ]);
+            usbOpen.mockResolvedValue(fakeTransport());
+            const printer = await discovery.openPrinter({ vid: 0x04f9, pid: 0x209b });
+            expect(printer.device.pid).toBe(0x209b);
+            expect(usbOpen).toHaveBeenCalledWith(0x04f9, 0x209b);
+        });
+        it('filters by serialNumber when multiple devices share a PID', async () => {
+            vi.mocked(usb.getDeviceList).mockReturnValueOnce([
+                makeUsbDevice(0x04f9, 0x20a7, 'SN-A'),
+                makeUsbDevice(0x04f9, 0x20a7, 'SN-TARGET'),
+            ]);
+            usbOpen.mockResolvedValue(fakeTransport());
+            const printer = await discovery.openPrinter({ serialNumber: 'SN-TARGET' });
+            expect(printer.device.pid).toBe(0x20a7);
+        });
+        it('throws when no matching device is attached', async () => {
+            await expect(discovery.openPrinter()).rejects.toThrow('No compatible Brother QL printer found.');
+        });
+        it('opens a TCP printer when host is provided', async () => {
+            tcpConnect.mockResolvedValue(fakeTransport());
+            const printer = await discovery.openPrinter({ host: '192.168.1.100' });
+            expect(printer.transportType).toBe('tcp');
+            expect(tcpConnect).toHaveBeenCalledWith('192.168.1.100', undefined);
+        });
+        it('passes port override to TcpTransport', async () => {
+            tcpConnect.mockResolvedValue(fakeTransport());
+            await discovery.openPrinter({ host: '10.0.0.5', port: 9101 });
+            expect(tcpConnect).toHaveBeenCalledWith('10.0.0.5', 9101);
+        });
+        it('opens a serial printer when path is provided', async () => {
+            serialOpen.mockResolvedValue(fakeTransport());
+            const printer = await discovery.openPrinter({ path: '/dev/rfcomm0' });
+            expect(printer.transportType).toBe('serial');
+            expect(serialOpen).toHaveBeenCalledWith('/dev/rfcomm0', undefined);
+        });
+        it('forwards baudRate to SerialTransport', async () => {
+            serialOpen.mockResolvedValue(fakeTransport());
+            await discovery.openPrinter({ path: 'COM3', baudRate: 115200 });
+            expect(serialOpen).toHaveBeenCalledWith('COM3', 115200);
+        });
     });
 });
 //# sourceMappingURL=discovery.test.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"discovery.test.js","sourceRoot":"","sources":["../../src/__tests__/discovery.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAE9D,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE;IACnE,cAAc;AAChB,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACpB,OAAO,EAAE;QACP,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;KAC/B;CACF,CAAC,CAAC,CAAC;AAEJ,UAAU,CAAC,GAAG,EAAE;IACd,UAAU,CAAC,SAAS,EAAE,CAAC;AACzB,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;QACrE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC;YACvD;gBACE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE;gBACzD,SAAS,EAAE,CAAC;gBACZ,aAAa,EAAE,CAAC;aACR;SACX,CAAC,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC;YACvD;gBACE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE;gBACzD,SAAS,EAAE,CAAC;gBACZ,aAAa,EAAE,CAAC;aACR;SACX,CAAC,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;QAClE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC;YACvD;gBACE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE;gBACzD,SAAS,EAAE,CAAC;gBACZ,aAAa,EAAE,CAAC;aACR;SACX,CAAC,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,EAAE,CAAC;QAC1C,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;QAC9D,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,KAAK,IAAI,EAAE;QAC/E,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC;QAChC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC;YACvD;gBACE,gBAAgB,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE;gBACzD,SAAS,EAAE,CAAC;gBACZ,aAAa,EAAE,CAAC;aACR;SACX,CAAC,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACzD,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"discovery.test.js","sourceRoot":"","sources":["../../src/__tests__/discovery.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9D,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC5D,OAAO,EAAE,EAAE,CAAC,EAAE,EAAE;IAChB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;IACnB,UAAU,EAAE,EAAE,CAAC,EAAE,EAAE;CACpB,CAAC,CAAC,CAAC;AACJ,EAAE,CAAC,IAAI,CAAC,+BAA+B,EAAE,GAAG,EAAE,CAAC,CAAC;IAC9C,YAAY,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE;IAC/B,YAAY,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE;IACrC,eAAe,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;CACtC,CAAC,CAAC,CAAC;AAEJ,EAAE,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;IACpB,aAAa,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;CAC/B,CAAC,CAAC,CAAC;AAEJ,OAAO,KAAK,GAAG,MAAM,KAAK,CAAC;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,SAAS,aAAa;IAMpB,OAAO;QACL,SAAS,EAAE,IAAI;QACf,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;KACf,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,QAAgB,EAChB,SAAiB,EACjB,YAAqB;IASrB,OAAO;QACL,gBAAgB,EAAE;YAChB,QAAQ;YACR,SAAS;YACT,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACpC;QACD,SAAS,EAAE,CAAC;QACZ,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE;QACb,KAAK,EAAE,EAAE,CAAC,EAAE,EAAE;QACd,mBAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAY,EAAE,EAAuC,EAAE,EAAE;YACnF,EAAE,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACzB,CAAC,CAAC;KACH,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE;IAChE,cAAc;AAChB,CAAC,CAAC,CAAC;AAEH,UAAU,CAAC,GAAG,EAAE;IACd,OAAO,CAAC,SAAS,EAAE,CAAC;IACpB,UAAU,CAAC,SAAS,EAAE,CAAC;IACvB,UAAU,CAAC,SAAS,EAAE,CAAC;IACvB,OAAO,CAAC,SAAS,EAAE,CAAC;IACpB,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,SAAS,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;AAC/D,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;QACvC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;QAC5B,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YACrE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC,CAAC,CAAC;YAC3F,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC;YAChD,MAAM,CAAC,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACjC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3C,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC,CAAC,CAAC;YAC3F,MAAM,CAAC,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;YAC9D,yEAAyE;YACzE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC,CAAC,CAAC;YAC3F,MAAM,CAAC,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC,CAAC,CAAC;YAC3F,MAAM,CAAC,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACvD,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;YACjE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC;gBAC/C,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAU;aAChD,CAAC,CAAC;YACH,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC;YACjD,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;YAC7E,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,CAAC,IAAY,EAAE,EAAwB,EAAE,EAAE;gBACvF,EAAE,CAAC,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC,CAAC;YAC1C,CAAC,CAAC,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC,CAAC,MAAe,CAAC,CAAC,CAAC;YACpE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC;YACjD,MAAM,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC,aAAa,EAAE,CAAC;QAChD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;QAC3B,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC,CAAC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC,CAAC,CAAC;YAC3F,OAAO,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uDAAuD,EAAE,KAAK,IAAI,EAAE;YACrE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC;gBAC/C,aAAa,CAAC,MAAM,EAAE,MAAM,CAAU;gBACtC,aAAa,CAAC,MAAM,EAAE,MAAM,CAAU;aACvC,CAAC,CAAC;YACH,OAAO,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1E,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,MAAM,CAAC,OAAO,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;YACzE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,mBAAmB,CAAC;gBAC/C,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU;gBAC9C,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,CAAU;aACpD,CAAC,CAAC;YACH,OAAO,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC;YAE3C,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;YAC3E,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;YAC1D,MAAM,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CACnD,yCAAyC,CAC1C,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;YACzD,UAAU,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC;YAE9C,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC,CAAC;YACvE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1C,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,UAAU,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC;YAE9C,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC9D,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8CAA8C,EAAE,KAAK,IAAI,EAAE;YAC5D,UAAU,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC;YAE9C,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;YACtE,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,sCAAsC,EAAE,KAAK,IAAI,EAAE;YACpD,UAAU,CAAC,iBAAiB,CAAC,aAAa,EAAE,CAAC,CAAC;YAE9C,MAAM,SAAS,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;YAChE,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/integration/print.test.d.ts

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

package/dist/__tests__/integration/print.test.d.ts.map

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

package/dist/__tests__/integration/print.test.js

@@ -0,0 +1,71 @@
+import { describe, it } from 'vitest';
+const INTEGRATION = process.env.BROTHER_INTEGRATION === '1';
+/*
+ * Hardware verification — skipped unless BROTHER_INTEGRATION=1.
+ *
+ * Pre-reqs:
+ * - Printer connected via USB (or TCP — set BROTHER_TCP_HOST)
+ * - DK-22205 (62mm continuous) or DK-22251 (two-colour) loaded
+ * - Editor Lite mode disabled on QL-820NWB
+ */
+describe.skipIf(!INTEGRATION)('Integration: brother-ql', () => {
+    it('prints a single-colour label via USB', async () => {
+        const { discovery } = await import('../../index.js');
+        const { MEDIA } = await import('@thermal-label/brother-ql-core');
+        const printer = await discovery.openPrinter();
+        try {
+            const image = {
+                width: 696,
+                height: 300,
+                data: new Uint8Array(696 * 300 * 4).fill(0),
+            };
+            await printer.print(image, MEDIA[259]);
+        }
+        finally {
+            await printer.close();
+        }
+    });
+    it('prints a two-colour label when DK-22251 is loaded', async () => {
+        const { discovery } = await import('../../index.js');
+        const { MEDIA } = await import('@thermal-label/brother-ql-core');
+        const printer = await discovery.openPrinter();
+        try {
+            if (!printer.device.twoColor) {
+                console.warn(`Skipping two-colour test: ${printer.device.name} is single-colour.`);
+                return;
+            }
+            // Red-dominant test image
+            const width = 696;
+            const height = 200;
+            const data = new Uint8Array(width * height * 4);
+            for (let i = 0; i < data.length; i += 4) {
+                data[i] = 255;
+                data[i + 3] = 255;
+            }
+            await printer.print({ width, height, data }, MEDIA[251]);
+        }
+        finally {
+            await printer.close();
+        }
+    });
+    it('prints via TCP when BROTHER_TCP_HOST is set', async () => {
+        const host = process.env.BROTHER_TCP_HOST;
+        if (!host)
+            return;
+        const { discovery } = await import('../../index.js');
+        const { MEDIA } = await import('@thermal-label/brother-ql-core');
+        const printer = await discovery.openPrinter({ host });
+        try {
+            const image = {
+                width: 696,
+                height: 200,
+                data: new Uint8Array(696 * 200 * 4).fill(0),
+            };
+            await printer.print(image, MEDIA[259]);
+        }
+        finally {
+            await printer.close();
+        }
+    });
+});
+//# sourceMappingURL=print.test.js.map

package/dist/__tests__/integration/print.test.js.map

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