@thermal-label/brother-ql-node 0.6.1 → 0.6.2

package/dist/discovery.js

@@ -1,87 +1,142 @@
-import { DEVICES, findDevice, getUsbIds, isMassStorageMode } from '@thermal-label/brother-ql-core';
-import { SerialTransport, TcpTransport, UsbTransport } from '@thermal-label/transport/node';
-import * as usb from 'usb';
+import { DEVICES, getUsbIds, MEDIA } from '@thermal-label/brother-ql-core';
+import { DeviceIdentificationRequiredError, DeviceNotFoundError } from '@thermal-label/contracts';
+import { enumerateNetworkDevices, enumerateUsbDevices, identifyNetworkDevice, PRINTER_MIB, SerialTransport, snmpGet, TcpTransport, UsbTransport, } from '@thermal-label/transport/node';
 import { BrotherQLPrinter } from './printer.js';
-const BROTHER_VID = 0x04f9;
-async function readSerialNumber(device, idx) {
-    return new Promise(resolve => {
-        device.getStringDescriptor(idx, (err, value) => {
-            resolve(err ? undefined : value);
-        });
-    });
+const REGISTRY = Object.values(DEVICES);
+function tcpCandidates() {
+    return REGISTRY.filter(d => d.transports.tcp !== undefined);
 }
-async function enumerateUsbDevices() {
-    const results = [];
-    for (const device of usb.getDeviceList()) {
-        const desc = device.deviceDescriptor;
-        if (desc.idVendor !== BROTHER_VID)
-            continue;
-        if (isMassStorageMode(desc.idProduct)) {
-            // eslint-disable-next-line no-console
-            console.warn(`[brother-ql] Detected printer in Editor Lite (mass storage) mode (PID 0x${desc.idProduct.toString(16).toUpperCase()}). ` +
-                'Hold the Editor Lite button until the LED turns off to switch to printer mode.');
-            continue;
-        }
-        const descriptor = findDevice(desc.idVendor, desc.idProduct);
-        if (!descriptor)
-            continue;
-        let serialNumber;
-        if (desc.iSerialNumber) {
-            device.open();
-            try {
-                serialNumber = await readSerialNumber(device, desc.iSerialNumber);
-            }
-            finally {
-                device.close();
-            }
-        }
-        results.push({ device, descriptor, serialNumber });
-    }
-    return results;
+function serialCandidates() {
+    return REGISTRY.filter(d => d.transports.serial !== undefined || d.transports['bluetooth-spp'] !== undefined);
+}
+function keyList(candidates) {
+    return candidates
+        .map(d => d.key)
+        .sort()
+        .join(', ');
+}
+function snmpOptions(community) {
+    return community === undefined ? {} : { community };
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/**
+ * `DeviceIdentificationRequiredError` with a message that says why the
+ * printer could not be identified, instead of the contract's generic
+ * one; `candidates` and `continueWith` keep the contract shape.
+ */
+function identificationRequired(candidates, reason, open) {
+    const err = new DeviceIdentificationRequiredError(candidates, async (deviceKey) => {
+        const printer = await open(deviceKey);
+        return { [printer.device.engines[0]?.role ?? 'primary']: printer };
+    });
+    err.message = `${reason}. Pass deviceKey, one of: ${keyList(candidates)}.`;
+    return err;
 }
 /**
  * `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.
+ * `listPrinters()` is the USB enumeration plus one SNMP broadcast on the
+ * local subnets. Network printers open by `host`: the model comes from
+ * SNMP (`hrDeviceDescr`) because port 9100 carries no model or status
+ * signal, and `deviceKey` overrides that. A printer in Editor Lite
+ * (mass-storage) mode exposes a PID outside the registry, so it is
+ * simply absent from the USB list.
  */
 export class BrotherQLDiscovery {
     family = 'brother-ql';
+    network;
+    community;
+    constructor(options = {}) {
+        this.network = options.network ?? true;
+        this.community = options.community;
+    }
     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)}`,
-        }));
+        const [usb, network] = await Promise.allSettled([
+            enumerateUsbDevices(REGISTRY),
+            this.network ? enumerateNetworkDevices(REGISTRY, snmpOptions(this.community)) : [],
+        ]);
+        // Either half may be unavailable (no `usb` addon installed, no
+        // network); the other still lists. Both failing is a real error.
+        if (usb.status === 'rejected' && network.status === 'rejected') {
+            throw usb.reason instanceof Error ? usb.reason : new Error(String(usb.reason));
+        }
+        const printers = [];
+        if (usb.status === 'fulfilled') {
+            for (const { descriptor, serialNumber, connectionId } of usb.value) {
+                printers.push({
+                    device: descriptor,
+                    ...(serialNumber === undefined ? {} : { serialNumber }),
+                    transport: 'usb',
+                    connectionId,
+                });
+            }
+        }
+        if (network.status === 'fulfilled') {
+            for (const found of network.value)
+                printers.push(networkPrinter(found));
+        }
+        return printers;
+    }
+    listMedia() {
+        return Object.values(MEDIA);
     }
     async openPrinter(options = {}) {
-        if (options.path !== undefined) {
-            const transport = await SerialTransport.open(options.path, options.baudRate);
-            // Serial (typically RFCOMM over OS-paired Bluetooth) carries no
-            // identifying metadata — attach any descriptor that declares the
-            // `bluetooth-spp` transport. `getStatus()` returns accurate
-            // detectedMedia regardless of which descriptor we attach, but
-            // the descriptor's `name` is what surfaces in logs.
-            const descriptor = Object.values(DEVICES).find(d => d.transports['bluetooth-spp'] !== undefined);
-            /* v8 ignore next -- the registry carries QL_820NWBc with bluetooth-spp */
-            if (!descriptor)
-                throw new Error('No bluetooth-spp-capable Brother QL descriptor found.');
-            return new BrotherQLPrinter(descriptor, transport, 'serial');
+        // eslint-disable-next-line @typescript-eslint/no-deprecated -- alias kept for one release
+        const serialPath = options.serialPath ?? options.path;
+        if (serialPath !== undefined)
+            return this.openSerial(serialPath, options);
+        if (options.host !== undefined)
+            return this.openTcp(options.host, options);
+        return this.openUsb(options);
+    }
+    async openSerial(serialPath, options) {
+        // Serial carries no identifying metadata and the registry has more
+        // than one serial-capable entry, so the caller names the model.
+        const candidates = serialCandidates();
+        if (options.deviceKey === undefined) {
+            throw identificationRequired(candidates, `Serial port ${serialPath} carries no model signal`, deviceKey => this.openSerial(serialPath, { ...options, deviceKey }));
         }
-        if (options.host !== undefined) {
-            const transport = await TcpTransport.connect(options.host, options.port);
-            const descriptor = Object.values(DEVICES).find(d => d.transports.tcp !== undefined);
-            /* v8 ignore next -- the registry always has TCP-capable entries */
-            if (!descriptor)
-                throw new Error('No network-capable Brother QL descriptor found.');
-            return new BrotherQLPrinter(descriptor, transport, 'tcp');
+        const descriptor = descriptorForKey(options.deviceKey, candidates, 'serial');
+        const transport = await SerialTransport.open(serialPath, options.baudRate);
+        return new BrotherQLPrinter(descriptor, transport, 'serial');
+    }
+    async openTcp(host, options) {
+        // Resolve the descriptor before connecting: a declined open must
+        // leave no session on a print server that serves one 9100 client.
+        const descriptor = options.deviceKey === undefined
+            ? await this.identifyTcp(host, options)
+            : descriptorForKey(options.deviceKey, tcpCandidates(), 'tcp');
+        const transport = await TcpTransport.connect(host, options.port);
+        const community = options.snmpCommunity ?? this.community;
+        return new BrotherQLPrinter(descriptor, transport, 'tcp', {
+            host,
+            ...(community === undefined ? {} : { community }),
+        });
+    }
+    async identifyTcp(host, options) {
+        const snmp = snmpOptions(options.snmpCommunity ?? this.community);
+        let reason;
+        try {
+            const found = await identifyNetworkDevice(host, REGISTRY, snmp);
+            if (found)
+                return found.descriptor;
+            reason = `${host} reports ${await reportedModel(host, snmp)}, which is not in the brother-ql registry`;
         }
-        const found = await enumerateUsbDevices();
+        catch (err) {
+            // "no SNMP answer" / "status is unavailable" are matched by
+            // thermal-label-cli to add `--media` to its hint; keep them.
+            reason = `No SNMP answer from ${host} (${errorMessage(err)}); the model cannot be identified and status is unavailable, so pass media too`;
+        }
+        throw identificationRequired(tcpCandidates(), reason, deviceKey => this.openTcp(host, { ...options, deviceKey }));
+    }
+    async openUsb(options) {
+        let usbError;
+        const found = await enumerateUsbDevices(REGISTRY).catch((err) => {
+            usbError = err;
+            return [];
+        });
         const match = found.find(entry => {
             const ids = getUsbIds(entry.descriptor);
             if (options.vid !== undefined && ids?.vid !== options.vid)
@@ -92,8 +147,22 @@ export class BrotherQLDiscovery {
                 return false;
             return true;
         });
-        if (!match)
-            throw new Error('No compatible Brother QL printer found.');
+        if (!match) {
+            // A serial number can also belong to a network printer.
+            if (options.serialNumber !== undefined && this.network) {
+                const remote = await this.findNetworkBySerial(options.serialNumber);
+                if (remote) {
+                    return this.openTcp(remote.host, {
+                        ...options,
+                        port: remote.port,
+                        deviceKey: remote.descriptor.key,
+                    });
+                }
+            }
+            if (usbError instanceof Error)
+                throw usbError;
+            throw new DeviceNotFoundError();
+        }
         const ids = getUsbIds(match.descriptor);
         /* v8 ignore next -- USB-discovered devices always have USB transport */
         if (!ids)
@@ -101,6 +170,43 @@ export class BrotherQLDiscovery {
         const transport = await UsbTransport.open(ids.vid, ids.pid);
         return new BrotherQLPrinter(match.descriptor, transport, 'usb');
     }
+    async findNetworkBySerial(serialNumber) {
+        const found = await enumerateNetworkDevices(REGISTRY, snmpOptions(this.community)).catch(() => []);
+        return found.find(d => d.serialNumber === serialNumber);
+    }
+}
+function descriptorForKey(deviceKey, candidates, kind) {
+    const descriptor = DEVICES[deviceKey];
+    if (!descriptor) {
+        throw new Error(`Unknown deviceKey "${deviceKey}". ${kind === 'tcp' ? 'TCP' : 'Serial'}-capable Brother QL keys: ${keyList(candidates)}.`);
+    }
+    if (!candidates.includes(descriptor)) {
+        throw new Error(`Device ${descriptor.key} has no ${kind} transport — it cannot be opened over ${kind === 'tcp' ? '`host`' : '`serialPath`'}. ${kind === 'tcp' ? 'TCP' : 'Serial'}-capable keys: ${keyList(candidates)}.`);
+    }
+    return descriptor;
+}
+/** One extra unicast, only on the failure path, so the message can name the model. */
+async function reportedModel(host, snmp) {
+    try {
+        const answers = await snmpGet(host, [PRINTER_MIB.hrDeviceDescr, PRINTER_MIB.sysDescr], snmp);
+        const value = answers[PRINTER_MIB.hrDeviceDescr] ?? answers[PRINTER_MIB.sysDescr];
+        if (value?.type === 'string' && value.value.length > 0)
+            return JSON.stringify(value.value);
+    }
+    catch {
+        /* fall through */
+    }
+    return 'a model';
+}
+function networkPrinter(found) {
+    return {
+        device: found.descriptor,
+        ...(found.serialNumber === undefined ? {} : { serialNumber: found.serialNumber }),
+        transport: 'tcp',
+        connectionId: found.connectionId,
+        host: found.host,
+        port: found.port,
+    };
 }
 /**
  * Named export discovered by the unified `thermal-label-cli` — the CLI

package/dist/discovery.js.map

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { BrotherQLDiscovery, discovery } from './discovery.js';
-export type { BrotherQLOpenOptions } from './discovery.js';
+export type { BrotherQLDiscoveryOptions, BrotherQLOpenOptions } from './discovery.js';
 export { BrotherQLPrinter } from './printer.js';
+export type { BrotherQLNetworkOptions } 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,kBAAkB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC/D,YAAY,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,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,yBAAyB,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC"}

package/dist/printer.d.ts

@@ -1,4 +1,13 @@
 import type { BrotherQLDevice, BrotherQLPrintOptions, BrotherQLStatus, MediaDescriptor, PreviewOptions, PreviewResult, PrinterAdapter, RawImageData, Transport, TransportType } from '@thermal-label/brother-ql-core';
+/**
+ * Where the SNMP side channel of a `'tcp'` printer lives. Status and
+ * print confirmation go there; the 9100 socket only ever receives.
+ */
+export interface BrotherQLNetworkOptions {
+    host: string;
+    /** SNMP community. Default `'public'`. */
+    community?: string;
+}
 /**
  * Node.js driver for Brother QL label printers.
  *
@@ -21,6 +30,7 @@ export declare class BrotherQLPrinter implements PrinterAdapter {
     readonly device: BrotherQLDevice;
     readonly transportType: TransportType;
     private readonly transport;
+    private readonly network;
     private lastStatus;
     /**
      * Serialises every bulk-OUT operation (print + getStatus) so a
@@ -33,20 +43,33 @@ export declare class BrotherQLPrinter implements PrinterAdapter {
      * all four drivers identical. See `@thermal-label/contracts`.
      */
     private readonly serializer;
-    constructor(device: BrotherQLDevice, transport: Transport, transportType: TransportType);
+    constructor(device: BrotherQLDevice, transport: Transport, transportType: TransportType, network?: BrotherQLNetworkOptions);
     get model(): string;
     get connected(): boolean;
     print(image: RawImageData, media?: MediaDescriptor, options?: BrotherQLPrintOptions): Promise<void>;
+    /**
+     * Send the job and wait for the page counter to move. Reads the
+     * counter first: when SNMP is unreachable nothing is sent, and the
+     * caller gets told to pass `confirm: false` rather than a job that
+     * silently went nowhere.
+     */
+    private writeConfirmed;
+    private readCounter;
+    private requireNetwork;
     private writeChunked;
     createPreview(image: RawImageData, options?: PreviewOptions): Promise<PreviewResult>;
     /**
-     * Poll the status endpoint until 32 bytes are available.
-     *
+     * USB / serial: 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.
+     * the printer hasn't queued a response yet; a transport that blocks
+     * instead is bounded by the read timeout. `STATUS_POLL_ATTEMPTS`
+     * rounds of `STATUS_POLL_INTERVAL_MS` either way.
+     *
+     * TCP: port 9100 never answers, so the status comes from the
+     * printer's SNMP agent and the socket is not touched.
      */
     getStatus(): Promise<BrotherQLStatus>;
+    private getNetworkStatus;
     close(): Promise<void>;
 }
 //# 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":"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;IAChD;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;gBAExC,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;YAyCF,YAAY;IAU1B,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAWpF;;;;;;OAMG;IACH,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;IAkB/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}
+{"version":3,"file":"printer.d.ts","sourceRoot":"","sources":["../src/printer.ts"],"names":[],"mappings":"AAcA,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;AA6BxC;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmCD;;;;;;;;;;;;;;;;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,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,UAAU,CAA8B;IAChD;;;;;;;;;OASG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAyB;gBAGlD,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,uBAAuB;IAQnC,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;IA+ChB;;;;;OAKG;YACW,cAAc;YAyCd,WAAW;IASzB,OAAO,CAAC,cAAc;YAOR,YAAY;IAU1B,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;IAWpF;;;;;;;;;OASG;IACH,SAAS,IAAI,OAAO,CAAC,eAAe,CAAC;YA0BvB,gBAAgB;IA6BxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/printer.js

@@ -1,8 +1,39 @@
-import { DEFAULT_MEDIA, ROTATE_DIRECTION, STATUS_REQUEST, createPreviewOffline, encodeJobForEngine, flipHorizontal, parseStatus, pickRotation, renderImage, renderMultiPlaneImage, } from '@thermal-label/brother-ql-core';
-import { MediaNotSpecifiedError, WriteSerializer } from '@thermal-label/contracts';
+import { DEFAULT_MEDIA, ROTATE_DIRECTION, STATUS_REQUEST, createPreviewOffline, encodeJobForEngine, flipHorizontal, hasTwoColourSibling, parseStatus, pickRotation, renderImage, renderMultiPlaneImage, statusFromPrinterMib, } from '@thermal-label/brother-ql-core';
+import { MediaNotSpecifiedError, TransportTimeoutError, WriteSerializer, } from '@thermal-label/contracts';
+import { PRINTER_MIB, snmpGet } from '@thermal-label/transport/node';
 const STATUS_BYTE_COUNT = 32;
 const STATUS_POLL_INTERVAL_MS = 150;
 const STATUS_POLL_ATTEMPTS = 10;
+// TCP print confirmation (plan 17 D5): port 9100 never answers, so the
+// only proof a job ran is `prtMarkerLifeCount` moving. A label takes
+// ~2 s; keep waiting while the agent says "printing".
+const CONFIRM_POLL_INTERVAL_MS = 500;
+const CONFIRM_IDLE_BUDGET_MS = 10_000;
+const CONFIRM_MAX_WAIT_MS = 60_000;
+const HR_PRINTER_STATUS_PRINTING = 4;
+const STATUS_OIDS = [
+    PRINTER_MIB.hrPrinterStatus,
+    PRINTER_MIB.hrPrinterDetectedErrorState,
+    PRINTER_MIB.prtInputMediaName,
+    PRINTER_MIB.prtInputDimUnit,
+    PRINTER_MIB.prtInputMediaDimFeedDir,
+    PRINTER_MIB.prtInputMediaDimXFeedDir,
+];
+function integerValue(value) {
+    return value?.type === 'integer' ? value.value : undefined;
+}
+function stringValue(value) {
+    return value?.type === 'string' ? value.value : undefined;
+}
+function rawValue(value) {
+    return value?.type === 'string' || value?.type === 'octets' ? value.raw : undefined;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function sleep(ms) {
+    return new Promise(r => setTimeout(r, ms));
+}
 // 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
@@ -37,6 +68,7 @@ export class BrotherQLPrinter {
     device;
     transportType;
     transport;
+    network;
     lastStatus;
     /**
      * Serialises every bulk-OUT operation (print + getStatus) so a
@@ -49,10 +81,11 @@ export class BrotherQLPrinter {
      * all four drivers identical. See `@thermal-label/contracts`.
      */
     serializer = new WriteSerializer();
-    constructor(device, transport, transportType) {
+    constructor(device, transport, transportType, network) {
         this.device = device;
         this.transport = transport;
         this.transportType = transportType;
+        this.network = network;
     }
     get model() {
         return this.device.name;
@@ -95,14 +128,70 @@ export class BrotherQLPrinter {
         // 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);
+        // `confirm` (contracts PrintOptions): on TCP it means "wait for
+        // prtMarkerLifeCount to move"; `false` sends blind.
+        if (this.transportType === 'tcp' && options?.confirm !== false) {
+            await this.serializer.run(() => this.writeConfirmed(bytes, resolvedMedia));
+            return;
+        }
         await this.serializer.run(() => this.writeChunked(bytes));
     }
+    /**
+     * Send the job and wait for the page counter to move. Reads the
+     * counter first: when SNMP is unreachable nothing is sent, and the
+     * caller gets told to pass `confirm: false` rather than a job that
+     * silently went nowhere.
+     */
+    async writeConfirmed(bytes, media) {
+        const net = this.requireNetwork();
+        let before;
+        try {
+            before = await this.readCounter(net);
+        }
+        catch (err) {
+            throw new Error(`Cannot confirm prints on ${net.host}: SNMP prtMarkerLifeCount unreadable (${errorMessage(err)}). Pass confirm: false to send the job blind.`, { cause: err });
+        }
+        await this.writeChunked(bytes);
+        const started = Date.now();
+        for (;;) {
+            await sleep(CONFIRM_POLL_INTERVAL_MS);
+            let answers;
+            try {
+                answers = await snmpGet(net.host, [PRINTER_MIB.prtMarkerLifeCount, PRINTER_MIB.hrPrinterStatus], { community: net.community ?? 'public' });
+            }
+            catch (err) {
+                throw new Error(`Job sent to ${net.host} but could not be confirmed: SNMP stopped answering (${errorMessage(err)}).`, { cause: err });
+            }
+            const count = integerValue(answers[PRINTER_MIB.prtMarkerLifeCount]);
+            if (count !== undefined && count !== before)
+                return;
+            const elapsed = Date.now() - started;
+            const printing = integerValue(answers[PRINTER_MIB.hrPrinterStatus]) === HR_PRINTER_STATUS_PRINTING;
+            if (elapsed >= CONFIRM_MAX_WAIT_MS || (elapsed >= CONFIRM_IDLE_BUDGET_MS && !printing)) {
+                throw new Error(notPrintedMessage(net.host, media, elapsed));
+            }
+        }
+    }
+    async readCounter(net) {
+        const answers = await snmpGet(net.host, [PRINTER_MIB.prtMarkerLifeCount], {
+            community: net.community ?? 'public',
+        });
+        const count = integerValue(answers[PRINTER_MIB.prtMarkerLifeCount]);
+        if (count === undefined)
+            throw new Error('agent has no prtMarkerLifeCount');
+        return count;
+    }
+    requireNetwork() {
+        if (this.network)
+            return this.network;
+        throw new Error('This TCP printer was constructed without its host; SNMP status and print confirmation need it.');
+    }
     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));
+                await sleep(USB_CHUNK_DELAY_MS);
             }
         }
     }
@@ -119,31 +208,75 @@ export class BrotherQLPrinter {
         });
     }
     /**
-     * Poll the status endpoint until 32 bytes are available.
-     *
+     * USB / serial: 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.
+     * the printer hasn't queued a response yet; a transport that blocks
+     * instead is bounded by the read timeout. `STATUS_POLL_ATTEMPTS`
+     * rounds of `STATUS_POLL_INTERVAL_MS` either way.
+     *
+     * TCP: port 9100 never answers, so the status comes from the
+     * printer's SNMP agent and the socket is not touched.
      */
     getStatus() {
+        if (this.transportType === 'tcp')
+            return this.getNetworkStatus();
         // Serialised against `print()` so the status request + poll-read
         // round-trip can't interleave into an in-flight raster stream.
         return this.serializer.run(async () => {
             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);
+                const started = Date.now();
+                const bytes = await this.transport
+                    .read(STATUS_BYTE_COUNT, STATUS_POLL_INTERVAL_MS)
+                    .catch((err) => {
+                    if (err instanceof TransportTimeoutError)
+                        return new Uint8Array(0);
+                    throw err;
+                });
                 if (bytes.length >= STATUS_BYTE_COUNT) {
                     const status = parseStatus(bytes, this.device.engines[0]);
                     this.lastStatus = status;
                     return status;
                 }
+                const remaining = STATUS_POLL_INTERVAL_MS - (Date.now() - started);
+                if (remaining > 0)
+                    await sleep(remaining);
             }
             throw new Error('Printer did not respond to status request within 1.5s');
         });
     }
+    async getNetworkStatus() {
+        const net = this.requireNetwork();
+        let answers;
+        try {
+            answers = await snmpGet(net.host, STATUS_OIDS, { community: net.community ?? 'public' });
+        }
+        catch (err) {
+            throw new Error(`Could not read status from ${net.host} over SNMP (${errorMessage(err)}); port 9100 carries no status. Pass media explicitly.`, { cause: err });
+        }
+        const feedDir = integerValue(answers[PRINTER_MIB.prtInputMediaDimFeedDir]);
+        const xFeedDir = integerValue(answers[PRINTER_MIB.prtInputMediaDimXFeedDir]);
+        const dimUnit = integerValue(answers[PRINTER_MIB.prtInputDimUnit]);
+        const status = statusFromPrinterMib({
+            printerStatus: integerValue(answers[PRINTER_MIB.hrPrinterStatus]) ?? 2,
+            errorState: rawValue(answers[PRINTER_MIB.hrPrinterDetectedErrorState]) ?? new Uint8Array(0),
+            mediaName: stringValue(answers[PRINTER_MIB.prtInputMediaName]) ?? '',
+            ...(feedDir === undefined ? {} : { feedDir }),
+            ...(xFeedDir === undefined ? {} : { xFeedDir }),
+            ...(dimUnit === undefined ? {} : { dimUnit }),
+        }, this.device.engines[0]);
+        this.lastStatus = status;
+        return status;
+    }
     async close() {
         await this.transport.close();
     }
 }
+function notPrintedMessage(host, media, elapsedMs) {
+    const seconds = (elapsedMs / 1000).toFixed(0);
+    const hint = hasTwoColourSibling(media)
+        ? ` ${String(media.widthMm)} mm rolls come in a two-colour variant that is invisible over the network and rejects single-colour jobs; on such a roll pass its media (DK-22251 = id 251).`
+        : '';
+    return `Job sent to ${host} but the page counter did not move in ${seconds} s: the printer did not print it.${hint}`;
+}
 //# sourceMappingURL=printer.js.map