libniimai 0.5.0 → 0.7.0

package/dist/libniimai.js

@@ -198,7 +198,7 @@ function packRows(data, width, height, order, head = 384) {
 	}
 	return rows;
 }
-var sleep$1 = (ms) => new Promise((r) => setTimeout(r, ms));
+var sleep$2 = (ms) => new Promise((r) => setTimeout(r, ms));
 /**
 * A thermal printer behind the same interface as a NIIMBOT client, so the
 * printer service drives both. It reports itself through model metadata with
@@ -227,7 +227,7 @@ var ThermalPrinterClient = class {
 	constructor(transport, pace, firstChunk) {
 		this.transport = transport;
 		this.pace = pace;
-		this.chunk = firstChunk;
+		this.chunk = transport.chunkBytes ?? firstChunk;
 		transport.onDisconnect(() => {
 			this.connected = false;
 			this.emit("disconnect", {});
@@ -288,7 +288,7 @@ var ThermalPrinterClient = class {
 	/** Sends bytes in chunks, waiting while the printer asks for a pause. `onSent` hears the share sent, 0–1. */
 	async send(bytes, onSent) {
 		for (let i = 0; i < bytes.length;) {
-			while (this.paused) await sleep$1(this.pace.pauseMs);
+			while (this.paused) await sleep$2(this.pace.pauseMs);
 			const part = bytes.subarray(i, i + this.chunk);
 			try {
 				await this.transport.write(part);
@@ -299,7 +299,7 @@ var ThermalPrinterClient = class {
 			}
 			i += part.length;
 			onSent?.(i / bytes.length);
-			await sleep$1(this.pace.chunkMs);
+			await sleep$2(this.pace.chunkMs);
 		}
 	}
 	protocol = {
@@ -835,6 +835,8 @@ var EscPosPrinterClient = class extends ThermalPrinterClient {
 	densityLevels = 1;
 	modelName;
 	headDots;
+	/** A stock module name or a printer matched by its services: the head's width is a guess until set. */
+	headUnknown;
 	constructor(transport, model, pace = {
 		chunkMs: 30,
 		pauseMs: 100
@@ -843,6 +845,11 @@ var EscPosPrinterClient = class extends ThermalPrinterClient {
 		this.model = model;
 		this.modelName = shownName(model, transport, "Thermal printer");
 		this.headDots = model?.headDots ?? 384;
+		this.headUnknown = !!model?.generic && model.headDots === void 0;
+	}
+	/** Sets the head's width, in whole bytes of dots, on a printer whose width is not known; a known head keeps its own. */
+	setHeadDots(dots) {
+		if (this.headUnknown) this.headDots = Math.max(8, Math.round(dots / 8) * 8);
 	}
 	encodeRows(data, width, height) {
 		return encodeRows$1(data, width, height, this.headDots);
@@ -868,7 +875,8 @@ var DOTS_PER_MM = 8;
 var TSPL_MODELS = [{
 	prefix: "QR380A",
 	confidence: "tested",
-	note: "Sold as CC390"
+	note: "Sold as CC390",
+	usbIds: [[10473, 649]]
 }, {
 	prefix: "GP-M322",
 	confidence: "medium",
@@ -1033,13 +1041,6 @@ var TsplPrinterClient = class extends ThermalPrinterClient {
 	}
 };
 // src/catalog.ts
-/**
-* Every printer outside NIIMBOT that libniimai knows, by Bluetooth name, in
-* one lookup across families. A name matches one family at most, and a name
-* that matches none is known to be unknown before anything is sent to it.
-* The models themselves live with their family: ESCPOS_MODELS, TSPL_MODELS
-* and CAT_MODELS.
-*/
 var PRINTER_CATALOG = [
 	...ESCPOS_MODELS.map((model) => ({
 		family: "escpos",
@@ -1061,6 +1062,20 @@ function identifyPrinter(name) {
 	for (const entry of PRINTER_CATALOG) if (name.startsWith(entry.model.prefix) && entry.model.prefix.length > (best?.model.prefix.length ?? 0)) best = entry;
 	return best;
 }
+/** The known printer behind a USB device: by its vendor and product IDs, then by its product name. */
+function identifyUsbPrinter({ vendorId, productId, productName }) {
+	return PRINTER_CATALOG.find((e) => e.model.usbIds?.some(([v, p]) => v === vendorId && p === productId)) ?? identifyPrinter(productName);
+}
+/**
+* The client for a thermal printer over a cable link. Cat printers are
+* Bluetooth only, so they get null. `ackTimeoutMs`: how long a label printer
+* waits for its "OK" before asking for its status.
+*/
+function cableClient({ family, model }, transport, pace, ackTimeoutMs) {
+	if (family === "tspl") return new TsplPrinterClient(transport, model, pace, ackTimeoutMs);
+	if (family === "escpos") return new EscPosPrinterClient(transport, model, pace);
+	return null;
+}
 /** The kinds of printer an unrecognised one can be set to, alongside NIIMBOT's MANUAL_PROFILES. */
 var PRINTER_TYPES = [
 	{
@@ -1108,6 +1123,76 @@ var PRINTER_TYPES = [
 	}
 ];
 var findPrinterType = (id) => PRINTER_TYPES.find((t) => t.id === id) ?? null;
+// src/routed.ts
+/**
+* A client that picks the real client when it connects, then passes
+* everything through to it: the Bluetooth and USB printers behind the
+* Connect buttons.
+*/
+var RoutedClient = class {
+	inner = null;
+	get client() {
+		if (!this.inner) throw new Error("Not connected");
+		return this.inner;
+	}
+	async disconnect() {
+		await this.inner?.disconnect();
+	}
+	isConnected() {
+		return !!this.inner?.isConnected();
+	}
+	on(event, fn) {
+		return this.client.on(event, fn);
+	}
+	off(event, fn) {
+		return this.inner?.off(event, fn);
+	}
+	getPrinterInfo() {
+		return this.inner?.getPrinterInfo() ?? {};
+	}
+	getModelMetadata() {
+		return this.inner?.getModelMetadata();
+	}
+	getPrintTaskType() {
+		return this.inner?.getPrintTaskType();
+	}
+	getRfidInfo() {
+		return this.inner?.getRfidInfo() ?? {};
+	}
+	fetchRfidInfo() {
+		return this.client.fetchRfidInfo();
+	}
+	startHeartbeat() {
+		this.inner?.startHeartbeat();
+	}
+	stopHeartbeat() {
+		this.inner?.stopHeartbeat();
+	}
+	isHeartbeatStarted() {
+		return !!this.inner?.isHeartbeatStarted?.();
+	}
+	get protocol() {
+		return this.client.protocol;
+	}
+	get encodePage() {
+		return this.inner?.encodePage?.bind(this.inner);
+	}
+	get rollKey() {
+		return this.inner?.rollKey?.bind(this.inner);
+	}
+	get feedPaper() {
+		return this.inner?.feedPaper?.bind(this.inner);
+	}
+	get headUnknown() {
+		return this.inner?.headUnknown;
+	}
+	get setHeadDots() {
+		return this.inner?.setHeadDots?.bind(this.inner);
+	}
+	get feedsBack() {
+		return this.inner?.feedsBack;
+	}
+};
 // src/bluetooth.ts
 /**
 * A writable characteristic on one of the serial services budget printers
@@ -1124,7 +1209,7 @@ async function writeChannel(server, services) {
 	}
 	return null;
 }
-var PRINTER_TYPE_NAMES = {
+var PRINTER_TYPE_NAMES$1 = {
 	escpos: "receipt printer",
 	tspl: "label printer",
 	cat: "cat printer"
@@ -1141,19 +1226,68 @@ async function thermalClient(device, server, services, { family, model }) {
 		write: TSPL_WRITE,
 		notify: TSPL_NOTIFY
 	}), model) : null;
-	const channel = services.includes("000018f0-0000-1000-8000-00805f9b34fb") ? {
+	const fixed = services.includes("000018f0-0000-1000-8000-00805f9b34fb") ? {
 		service: ESCPOS_SERVICE,
 		write: ESCPOS_WRITE
 	} : services.includes("e7810a71-73ae-499d-8c15-faa9aef0c3f2") ? {
 		service: ESCPOS_ALT_SERVICE,
 		write: ESCPOS_ALT_WRITE
-	} : await writeChannel(server, services);
+	} : null;
+	const transport = fixed && await webTransport(device, server, fixed).catch(() => null);
+	if (transport) return new EscPosPrinterClient(transport, model);
+	const channel = await writeChannel(server, services);
 	return channel ? new EscPosPrinterClient(await webTransport(device, server, channel), model) : null;
 }
+/** NIIMBOT printers offer one of these; a printer with neither cannot be one. */
+var NIIMBOT_SERVICES = CANDIDATE_SERVICES.slice(0, 2);
+/** A receipt printer matched by its services: its head's width is unknown until the paper says. */
+var RECEIPT = {
+	family: "escpos",
+	model: {
+		prefix: "",
+		confidence: "medium",
+		generic: true
+	}
+};
+var CAT = findPrinterType("cat");
+/**
+* What an unknown printer that did not answer as a NIIMBOT is, by its
+* services: the cat service makes it a cat printer, and any other serial
+* service outside NIIMBOT's a receipt printer. Null when it offers only
+* NIIMBOT services, or nothing to print through: those stay NIIMBOT's.
+*/
+function byServices(services) {
+	if (services.includes("0000ae30-0000-1000-8000-00805f9b34fb")) return CAT;
+	return services.some((s) => CANDIDATE_SERVICES.includes(s) && !NIIMBOT_SERVICES.includes(s)) ? RECEIPT : null;
+}
+/**
+* Clears out the NIIMBOT tries a receipt printer took as text: FS . leaves
+* Chinese character mode, so no half character swallows what follows; two
+* line feeds print what is left in the buffer, even after a dangling byte;
+* ESC @ resets the printer.
+*/
+var FLUSH = Uint8Array.from([
+	28,
+	46,
+	10,
+	10,
+	27,
+	64
+]);
+var sleep$1 = (ms) => new Promise((r) => setTimeout(r, ms));
+/** The printer's GATT server again after a failed attempt dropped the link, giving it a moment between tries. */
+async function reconnect(device) {
+	for (let i = 1; i <= 3; i++) {
+		await sleep$1(250 * i);
+		const server = await device.gatt?.connect().catch(() => null);
+		if (server) return server;
+	}
+	return null;
+}
 /** The name starts like one of niimbluelib's NIIMBOT models ("D110-…", "B21_…"). */
 function looksNiimbot(lib, name) {
 	const token = name?.split(/[-_ ]/)[0].toUpperCase();
-	return !!token && lib.modelsLibrary.some((m) => m.model.split("_")[0] === token);
+	return !!token && !!lib.modelsLibrary?.some((m) => m.model.split("_")[0] === token);
 }
 /**
 * The Bluetooth printer behind the Connect button. One chooser lists NIIMBOT
@@ -1164,22 +1298,26 @@ function looksNiimbot(lib, name) {
 * the TSPL client; and everything else the NIIMBOT client exactly as before.
 * Known names never overlap, so each printer matches one client at most.
 */
-var BluetoothPrinter = class {
+var BluetoothPrinter = class extends RoutedClient {
 	lib;
-	inner = null;
 	constructor(lib) {
+		super();
 		this.lib = lib;
 	}
-	get client() {
-		if (!this.inner) throw new Error("Not connected");
-		return this.inner;
-	}
 	/** The kind of printer to treat an unrecognised one as; null leaves it to NIIMBOT. */
 	fallback = null;
 	unrecognisedAs(typeId) {
 		this.fallback = findPrinterType(typeId);
 	}
+	/** Printers matched by their services before, by Bluetooth name: they skip the NIIMBOT handshake. */
+	remembered = {};
+	/** What the printer connected now was matched as by its services, if it was. */
+	matchedAs;
+	rememberMatches(matches) {
+		this.remembered = matches;
+	}
 	async connect() {
+		this.matchedAs = void 0;
 		const device = await requestPrinter(PRINTER_CATALOG.map((e) => e.model.prefix), !!this.fallback);
 		const known = identifyPrinter(device.name);
 		const fallback = !known && this.fallback && !looksNiimbot(await this.lib(), device.name) ? this.fallback : null;
@@ -1189,67 +1327,53 @@ var BluetoothPrinter = class {
 			const services = (await server.getPrimaryServices().catch(() => [])).map((s) => s.uuid);
 			this.inner = await thermalClient(device, server, services, entry);
 			if (this.inner) return this.inner.connect();
-			if (!known) throw new Error(`${device.name ?? "This printer"} does not offer a ${PRINTER_TYPE_NAMES[entry.family]} service`);
+			if (!known) throw new Error(`${device.name ?? "This printer"} does not offer a ${PRINTER_TYPE_NAMES$1[entry.family]} service`);
 		}
 		const lib = await this.lib();
+		const before = !entry && device.name && !looksNiimbot(lib, device.name) ? this.remembered[device.name] : void 0;
+		if (before && device.gatt) {
+			const server = await device.gatt.connect();
+			const client = await thermalClient(device, server, (await server.getPrimaryServices().catch(() => [])).map((s) => s.uuid), before === "cat" ? CAT : RECEIPT).catch(() => null);
+			if (client) {
+				this.inner = client;
+				this.matchedAs = before;
+				return client.connect();
+			}
+		}
 		this.inner = createBleClient(lib, device);
 		try {
 			return await this.inner.connect();
 		} catch (err) {
-			if (looksNiimbot(lib, device.name)) throw err;
-			throw new Error(`${device.name ?? "This printer"} did not answer as a NIIMBOT. If it is another kind, pick its type under Advanced and connect again.`);
+			if (looksNiimbot(lib, device.name) || entry) throw err;
+			return this.unknown(device, err);
 		}
 	}
-	async disconnect() {
-		await this.inner?.disconnect();
-	}
-	isConnected() {
-		return !!this.inner?.isConnected();
-	}
-	on(event, fn) {
-		return this.client.on(event, fn);
-	}
-	off(event, fn) {
-		return this.inner?.off(event, fn);
-	}
-	getPrinterInfo() {
-		return this.inner?.getPrinterInfo() ?? {};
-	}
-	getModelMetadata() {
-		return this.inner?.getModelMetadata();
-	}
-	getPrintTaskType() {
-		return this.inner?.getPrintTaskType();
-	}
-	getRfidInfo() {
-		return this.inner?.getRfidInfo() ?? {};
-	}
-	fetchRfidInfo() {
-		return this.client.fetchRfidInfo();
-	}
-	startHeartbeat() {
-		this.inner?.startHeartbeat();
-	}
-	stopHeartbeat() {
-		this.inner?.stopHeartbeat();
-	}
-	isHeartbeatStarted() {
-		return !!this.inner?.isHeartbeatStarted?.();
-	}
-	get protocol() {
-		return this.client.protocol;
-	}
-	get encodePage() {
-		return this.inner?.encodePage?.bind(this.inner);
-	}
-	get rollKey() {
-		return this.inner?.rollKey?.bind(this.inner);
-	}
-	get feedPaper() {
-		return this.inner?.feedPaper?.bind(this.inner);
-	}
-	get feedsBack() {
-		return this.inner?.feedsBack;
+	/**
+	* An unknown name that failed its first NIIMBOT try. NIIMBOT goes first
+	* again, so an unknown NIIMBOT that missed one handshake still gets its
+	* own client; only after a second miss do its services decide, and a
+	* printer offering only NIIMBOT services is never handed to another client.
+	*/
+	async unknown(device, first) {
+		await sleep$1(250);
+		try {
+			return await this.inner.connect();
+		} catch {}
+		const server = await reconnect(device);
+		const services = server ? (await server.getPrimaryServices().catch(() => [])).map((s) => s.uuid) : [];
+		console.info("[niimai] services", device.name, services);
+		const guess = byServices(services);
+		const client = server && guess ? await thermalClient(device, server, services, guess).catch(() => null) : null;
+		if (client) {
+			this.inner = client;
+			const info = await client.connect();
+			this.matchedAs = guess.family === "cat" ? "cat" : "escpos";
+			if (this.matchedAs === "escpos") await client.send(FLUSH).catch(() => {});
+			return info;
+		}
+		console.warn("[niimai] connect failed", device.name, first);
+		if (!services.length) throw new Error(`${device.name ?? "This printer"} offers no print service niimai knows. See Help → Printer not recognised.`);
+		throw new Error(`Could not connect to ${device.name ?? "this printer"}. Pick its type under Advanced and connect again.`);
 	}
 };
 // src/mock.ts
@@ -1621,7 +1745,7 @@ function withTimeout(p, ms) {
 /** Translates the library's error codes and messages into short, readable ones. */
 function friendlyError(err) {
 	const msg = err instanceof Error ? err.message : String(err);
-	if (/user cancelled|no device selected|chooser/i.test(msg)) return "Connection cancelled";
+	if (/user cancelled|no (device|port) selected|chooser/i.test(msg)) return "Connection cancelled";
 	if (/timeout waiting for the printer to finish/i.test(msg)) return "The printer did not confirm the print";
 	if (/timeout/i.test(msg)) return "Printer stopped responding";
 	if (/lid|cover/i.test(msg)) return "Close the printer lid";
@@ -1668,6 +1792,16 @@ var PrinterService = class {
 		this.status = status;
 		this.listeners.forEach((fn) => fn(this.status));
 	}
+	matches = {};
+	/**
+	* Printers matched by their services on earlier connections, by Bluetooth
+	* name (from `status.matchedAs` and `status.deviceName`). They connect
+	* straight to that client, skipping the NIIMBOT handshake, whose bytes a
+	* receipt printer would print as text.
+	*/
+	rememberMatches(matches) {
+		this.matches = matches;
+	}
 	setManualProfile(id) {
 		this.manualProfileId = id;
 		if (this.client) this.set({ profile: this.currentProfile() });
@@ -1711,6 +1845,7 @@ var PrinterService = class {
 		try {
 			client = await this.createClient(kind);
 			client.unrecognisedAs?.(this.manualProfileId);
+			client.rememberMatches?.(this.matches);
 			const info = await client.connect();
 			this.client = client;
 			this.set({ deviceName: info.deviceName });
@@ -1749,7 +1884,9 @@ var PrinterService = class {
 			profile: this.currentProfile(),
 			label: this.readRfid(),
 			...client.feedPaper ? { canFeed: true } : {},
-			...client.feedPaper && client.feedsBack ? { canRetract: true } : {}
+			...client.feedPaper && client.feedsBack ? { canRetract: true } : {},
+			...client.headUnknown && client.setHeadDots ? { headUnknown: true } : {},
+			...client.matchedAs ? { matchedAs: client.matchedAs } : {}
 		});
 		client.startHeartbeat();
 	}
@@ -1787,6 +1924,18 @@ var PrinterService = class {
 		} });
 	}
 	/**
+	* Sets the print width, in mm, on a printer whose head width is not known
+	* (`status.headUnknown`); the profile follows. Other printers keep theirs.
+	*/
+	setPrintWidth(mm) {
+		const client = this.client;
+		const profile = this.status.profile;
+		if (!client?.setHeadDots || !this.status.headUnknown || !profile) return;
+		client.setHeadDots(mmToPx(mm, profile.dpi));
+		const next = this.currentProfile();
+		if (next?.printheadPixels !== profile.printheadPixels) this.set({ profile: next });
+	}
+	/**
 	* Moves the paper by `mm`, out of the printer when positive and back in when
 	* negative, to line it up on printers that cannot sense it.
 	*/
@@ -1883,6 +2032,12 @@ var PrinterService = class {
 // src/client.ts
 var supportsBluetooth = () => typeof navigator !== "undefined" && "bluetooth" in navigator;
 var supportsSerial = () => typeof navigator !== "undefined" && "serial" in navigator;
+var supportsUsb = () => typeof navigator !== "undefined" && "usb" in navigator;
+var SUPPORTS = {
+	bluetooth: supportsBluetooth,
+	serial: supportsSerial,
+	usb: supportsUsb
+};
 function detectPlatform(ua = typeof navigator === "undefined" ? "" : navigator.userAgent, touchPoints = typeof navigator === "undefined" ? 0 : navigator.maxTouchPoints) {
 	if (/iPhone|iPad|iPod/.test(ua) || /Macintosh/.test(ua) && touchPoints > 1) return "ios";
 	if (/Android/.test(ua)) return "android";
@@ -1928,7 +2083,7 @@ var BROWSER_NAMES = {
 */
 function supportIssue(kind, env = {}) {
 	if (kind === "demo") return null;
-	if (kind === "bluetooth" ? supportsBluetooth() : supportsSerial()) return null;
+	if (SUPPORTS[kind]()) return null;
 	const { os, browser, chromium, secure } = detectBrowser(env);
 	const bluetooth = kind === "bluetooth";
 	if (os === "ios") return {
@@ -1994,36 +2149,182 @@ function unsupportedReason(kind, platform) {
 	return supportIssue(kind, platform ? PLATFORM_ENVS[platform] : {})?.reason ?? null;
 }
 /**
-* Errors browsers raise when Bluetooth is there but cannot be used: the
-* adapter is off or missing, or the browser turned the API off. The Help topic
-* to point to, or null.
+* Errors browsers raise when Bluetooth or USB is there but cannot be used:
+* the adapter is off or missing, the browser turned the API off, or the
+* system keeps a USB printer for itself. The Help topic to point to, or null.
 */
 function connectErrorTopic(err) {
 	const message = err instanceof Error ? err.message : String(err);
 	if (/globally disabled/i.test(message)) return "brave";
+	if (/claim interface|Access denied|Unable to open device/i.test(message)) return "usb";
 	if (/adapter not available|Bluetooth adapter|Bluetooth is (turned off|disabled|not available)/i.test(message)) return detectBrowser().os === "linux" ? "linux" : "browsers";
 	return null;
 }
+// src/usb.ts
+/**
+* Label and receipt printers on a USB cable that show up as standard USB
+* printers (interface class 7), which Web Serial cannot see. They take the
+* same TSPL or ESC/POS bytes as over Bluetooth, through WebUSB. NIIMBOT
+* printers show up as serial ports and keep using Web Serial.
+*/
+var USB_PRINTER_CLASS = 7;
+/** USB moves data far faster than Bluetooth and paces itself, so writes are large and back to back. */
+var USB_PACE = {
+	chunkMs: 0,
+	pauseMs: 100
+};
+var USB_CHUNK = 4096;
+/** Label printers may not send "OK" over USB; a status query after this long tells a fault from a quiet printer. */
+var USB_ACK_TIMEOUT_MS = 5e3;
+/**
+* The fields of an IEEE 1284 device ID, keys in capitals:
+* "MFG:ACME;COMMAND SET:TSC/ESC/POS;MODEL:CC390;" → { MFG, 'COMMAND SET', MODEL }.
+*/
+function parseDeviceId(text) {
+	const fields = {};
+	for (const part of text.split(";")) {
+		const at = part.indexOf(":");
+		if (at > 0) fields[part.slice(0, at).trim().toUpperCase()] = part.slice(at + 1).trim();
+	}
+	return fields;
+}
+/** The printer languages a device ID names, TSPL first: label printers often take ESC/POS as well. */
+function familiesFromDeviceId(text) {
+	const id = parseDeviceId(text);
+	const commands = id.CMD ?? id["COMMAND SET"] ?? "";
+	const families = [];
+	if (/\b(TSPL2?|TSC)\b/i.test(commands)) families.push("tspl");
+	if (/ESC\/?POS|\bEPSON\b/i.test(commands)) families.push("escpos");
+	return families;
+}
+var isPrinter = (device) => device.configuration?.interfaces.some((i) => i.alternates.some((a) => a.interfaceClass === 7)) ?? true;
+/** USB printers this site may already use that are plugged in. */
+async function rememberedUsbPrinters() {
+	if (!supportsUsb()) return [];
+	return (await navigator.usb.getDevices().catch(() => [])).filter(isPrinter);
+}
+/** Opens a USB printer and claims its printer interface. Also reads the printer's device ID. */
+async function usbTransport(device) {
+	await device.open();
+	if (!device.configuration) await device.selectConfiguration(1);
+	const iface = device.configuration.interfaces.find((i) => i.alternates.some((a) => a.interfaceClass === 7));
+	if (!iface) throw new Error(`${device.productName ?? "This device"} is not a USB printer`);
+	const alt = iface.alternates.find((a) => a.interfaceClass === 7);
+	await device.claimInterface(iface.interfaceNumber);
+	if (alt.alternateSetting !== 0) await device.selectAlternateInterface(iface.interfaceNumber, alt.alternateSetting);
+	const out = alt.endpoints.find((e) => e.direction === "out" && e.type === "bulk");
+	const back = alt.endpoints.find((e) => e.direction === "in" && e.type === "bulk");
+	if (!out) throw new Error(`${device.productName ?? "This printer"} has no way to send it data`);
+	const deviceId = await device.controlTransferIn({
+		requestType: "class",
+		recipient: "interface",
+		request: 0,
+		value: 0,
+		index: iface.interfaceNumber << 8 | alt.alternateSetting
+	}, 1024).then((r) => r.data ? new TextDecoder().decode(new Uint8Array(r.data.buffer, r.data.byteOffset + 2, Math.max(0, r.data.byteLength - 2))) : "").catch(() => "");
+	const notify = [];
+	const gone = [];
+	let open = true;
+	if (back) (async () => {
+		while (open) {
+			const r = await device.transferIn(back.endpointNumber, back.packetSize).catch(() => null);
+			if (!r) break;
+			if (r.data?.byteLength) notify.forEach((fn) => fn(new Uint8Array(r.data.buffer.slice(r.data.byteOffset, r.data.byteOffset + r.data.byteLength))));
+		}
+	})();
+	const onUnplug = (e) => {
+		if (e.device !== device) return;
+		open = false;
+		navigator.usb.removeEventListener("disconnect", onUnplug);
+		gone.forEach((fn) => fn());
+	};
+	navigator.usb.addEventListener("disconnect", onUnplug);
+	return {
+		deviceId,
+		transport: {
+			name: device.productName || void 0,
+			chunkBytes: USB_CHUNK,
+			write: async (chunk) => {
+				if ((await device.transferOut(out.endpointNumber, chunk.slice())).status !== "ok") throw new Error("The printer did not take the data");
+			},
+			onNotify: (fn) => notify.push(fn),
+			onDisconnect: (fn) => gone.push(fn),
+			disconnect: async () => {
+				open = false;
+				navigator.usb.removeEventListener("disconnect", onUnplug);
+				await device.releaseInterface(iface.interfaceNumber).catch(() => {});
+				await device.close().catch(() => {});
+			}
+		}
+	};
+}
+var PRINTER_TYPE_NAMES = {
+	escpos: "receipt printer",
+	tspl: "label printer",
+	cat: "cat printer"
+};
+/**
+* The USB printer behind the USB button for label and receipt printers. A
+* printer this site already uses connects straight away when it is the only
+* one plugged in; otherwise the browser lists USB printers. The printer's
+* language comes from the catalog, then from the type picked under Advanced
+* when the printer speaks it (or does not say), then from the device ID the
+* printer reports.
+*/
+var UsbPrinter = class extends RoutedClient {
+	fallback = null;
+	unrecognisedAs(typeId) {
+		this.fallback = findPrinterType(typeId);
+	}
+	async connect() {
+		const remembered = await rememberedUsbPrinters();
+		const device = remembered.length === 1 ? remembered[0] : await navigator.usb.requestDevice({ filters: [{ classCode: 7 }] });
+		const { transport, deviceId } = await usbTransport(device);
+		const name = device.productName || "This printer";
+		const families = familiesFromDeviceId(deviceId);
+		const picked = this.fallback && (!families.length || families.includes(this.fallback.family)) ? this.fallback : null;
+		const entry = identifyUsbPrinter(device) ?? picked ?? (families.length ? {
+			family: families[0],
+			model: {
+				prefix: "",
+				confidence: "medium",
+				generic: true
+			}
+		} : null);
+		if (!entry) {
+			await transport.disconnect();
+			throw new Error(`${name} did not say which printer language it speaks. Pick its type under Advanced and connect again.`);
+		}
+		this.inner = cableClient(entry, transport, USB_PACE, USB_ACK_TIMEOUT_MS);
+		if (!this.inner) {
+			await transport.disconnect();
+			throw new Error(`A ${PRINTER_TYPE_NAMES[entry.family]} cannot print over USB`);
+		}
+		return this.inner.connect();
+	}
+};
 // src/index.ts
 /**
 * libniimai: connect to NIIMBOT, TSPL, ESC/POS and cat printers from the
-* browser over Web Bluetooth or Web Serial, and print a canvas on them.
+* browser over Web Bluetooth, Web Serial or WebUSB, and print a canvas on them.
 */
 var niimbot = () => import("@mmote/niimbluelib");
 /**
 * A client for one kind of connection. Bluetooth finds the printer family
-* from the device the user picks; serial is NIIMBOT only; demo is a printer
-* in memory.
+* from the device the user picks; serial is NIIMBOT only; usb is for label
+* and receipt printers that show up as standard USB printers; demo is a
+* printer in memory.
 */
 async function createClient(kind) {
 	if (kind === "demo") return new MockClient();
 	if (kind === "bluetooth") return new BluetoothPrinter(niimbot);
+	if (kind === "usb") return new UsbPrinter();
 	return new (await (niimbot())).NiimbotSerialClient();
 }
 /** A ready printer service: connect, watch its status, print canvases. */
 function createPrinter(options = {}) {
 	return new PrinterService(options.createClient ?? createClient, async (canvas, direction) => (await niimbot()).ImageEncoder.encodeCanvas(canvas, 0, direction));
 }
-export { BluetoothPrinter, CAT_MODELS, CAT_UNSUPPORTED, CatPrinterClient, DEMO_META, DEMO_NAME, ESCPOS_MODELS, EscPosPrinterClient, MANUAL_PROFILES, MockClient, PAPER_TYPES, PRINTER_CATALOG, PRINTER_TYPES, PrinterService, THERMAL_DEFAULT_SIZE, THERMAL_HEAD_DOTS, THERMAL_HEAD_MM, THERMAL_SIZES, TSPL_MODELS, TSPL_SIZES, ThermalPrinterClient, TsplPrinterClient, catFeed, printJob as catJob, catModelFor, connectErrorTopic, correctTask, createClient, createPrinter, describeBleError, detectBrowser, detectPlatform, effectivePaper, escposFeed, escposJob, escposModelFor, findManualProfile, findPrinterType, fitToPrinthead, friendlyError, identifyPrinter, inkOutsideHead, labelTypeOf, modelFor, paperFromLabelType, paperName, printheadCrop, printheadMm, resolveProfile, rotateCanvas, shiftCanvas, supportIssue, supportsBluetooth, supportsSerial, tsplJob, tsplModelFor, unsupportedReason, webTransport };
+export { BluetoothPrinter, CAT_MODELS, CAT_UNSUPPORTED, CatPrinterClient, DEMO_META, DEMO_NAME, ESCPOS_MODELS, EscPosPrinterClient, MANUAL_PROFILES, MockClient, PAPER_TYPES, PRINTER_CATALOG, PRINTER_TYPES, PrinterService, THERMAL_DEFAULT_SIZE, THERMAL_HEAD_DOTS, THERMAL_HEAD_MM, THERMAL_SIZES, TSPL_MODELS, TSPL_SIZES, ThermalPrinterClient, TsplPrinterClient, USB_PRINTER_CLASS, UsbPrinter, byServices, catFeed, printJob as catJob, catModelFor, connectErrorTopic, correctTask, createClient, createPrinter, describeBleError, detectBrowser, detectPlatform, effectivePaper, escposFeed, escposJob, escposModelFor, familiesFromDeviceId, findManualProfile, findPrinterType, fitToPrinthead, friendlyError, identifyPrinter, identifyUsbPrinter, inkOutsideHead, labelTypeOf, modelFor, paperFromLabelType, paperName, parseDeviceId, printheadCrop, printheadMm, rememberedUsbPrinters, resolveProfile, rotateCanvas, shiftCanvas, supportIssue, supportsBluetooth, supportsSerial, supportsUsb, tsplJob, tsplModelFor, unsupportedReason, usbTransport, webTransport };
 
 //# sourceMappingURL=libniimai.js.map