libniimai 0.2.0 → 0.3.0

package/dist/libniimai.js

@@ -29,8 +29,12 @@ var NAME_PREFIXES = [
 	"T",
 	"Z"
 ];
-/** Opens the browser's printer chooser. */
-function requestPrinter(extraPrefixes = []) {
+/** Opens the browser's printer chooser. `all` lists every device, for printers whose names niimai does not know. */
+function requestPrinter(extraPrefixes = [], all = false) {
+	if (all) return navigator.bluetooth.requestDevice({
+		acceptAllDevices: true,
+		optionalServices: CANDIDATE_SERVICES
+	});
 	return navigator.bluetooth.requestDevice({
 		filters: [...[...NAME_PREFIXES, ...extraPrefixes].map((namePrefix) => ({ namePrefix })), { services: [CANDIDATE_SERVICES[0]] }],
 		optionalServices: CANDIDATE_SERVICES
@@ -154,6 +158,8 @@ function createBleClient(lib, chosen) {
 var THERMAL_HEAD_DOTS = 384;
 /** The print width in whole millimetres, the widest a design on continuous paper can be. */
 var THERMAL_HEAD_MM = 48;
+/** The name a printer shows: its model, or its own Bluetooth name when the model entry is only a brand or a stock name. */
+var shownName = (model, transport, fallback) => (model && !model.generic ? model.prefix : transport.name) || model?.prefix || fallback;
 /** The known model a Bluetooth name belongs to, longest prefix first. */
 function modelFor(models, name) {
 	if (!name) return null;
@@ -301,13 +307,14 @@ var ThermalPrinterClient = class {
 		newPrintTask: (_name, options) => {
 			const density = Number(options.density ?? 1);
 			const labelType = Number(options.labelType ?? 1);
+			const gapDots = options.gapDots === void 0 ? void 0 : Math.max(0, Math.round(Number(options.gapDots)));
 			let printed = 0;
 			return {
 				printInit: async () => {},
 				printPage: async (image, quantity = 1) => {
 					const total = () => Math.max(printed, Number(options.totalPages ?? printed));
 					let shown = -1;
-					await this.send(this.job(image, density, Math.max(1, quantity), labelType), (share) => {
+					await this.send(this.job(image, density, Math.max(1, quantity), labelType, gapDots), (share) => {
 						const sending = Math.floor(share * 100);
 						if (sending === shown) return;
 						shown = sending;
@@ -371,7 +378,7 @@ async function webTransport(device, server, ids) {
 var CAT_SERVICE = "0000ae30-0000-1000-8000-00805f9b34fb";
 var CAT_TX = "0000ae01-0000-1000-8000-00805f9b34fb";
 var CAT_RX = "0000ae02-0000-1000-8000-00805f9b34fb";
-var ROW_BYTES$1 = 48;
+var ROW_BYTES = 48;
 /**
 * Models known to speak this protocol. "high": supported by both reference
 * projects and widely used. "medium": listed by Cat-Printer, fewer reports.
@@ -483,6 +490,7 @@ function packet(cmd, payload) {
 }
 var u16 = (v) => [v & 255, v >> 8 & 255];
 var CMD = {
+	retract: 160,
 	feed: 161,
 	row: 162,
 	state: 163,
@@ -556,8 +564,12 @@ var FEED_AFTER = 128;
 var GAP_BETWEEN = 24;
 /** Rows for a cat printer: leftmost dot in the lowest bit. */
 var encodeRows$2 = (data, width, height) => packRows(data, width, height, "lsb");
-/** Everything sent for one job: setup, the rows for each copy, then feed and finish. */
-function printJob(rows, { density, copies, model }) {
+/**
+* Everything sent for one job: setup, the rows for each copy, then feed and
+* finish. With `gapDots`, for labels with gaps, every label is followed by
+* exactly that feed, so the next print starts on the next label.
+*/
+function printJob(rows, { density, copies, model, gapDots }) {
 	const out = [];
 	const push = (cmd, payload) => out.push(...packet(cmd, payload));
 	push(CMD.state, [0]);
@@ -569,18 +581,28 @@ function printJob(rows, { density, copies, model }) {
 	push(CMD.applyEnergy, [1]);
 	push(CMD.update, [0]);
 	push(CMD.lattice, LATTICE_START);
-	const blank = new Uint8Array(ROW_BYTES$1);
+	const blank = new Uint8Array(ROW_BYTES);
 	for (let c = 0; c < copies; c++) {
-		if (c > 0) for (let i = 0; i < GAP_BETWEEN; i++) push(CMD.row, blank);
+		if (c > 0) for (let i = 0; i < (gapDots ?? GAP_BETWEEN); i++) push(CMD.row, blank);
 		for (const row of rows) push(CMD.row, row);
 	}
 	push(CMD.lattice, LATTICE_END);
 	push(CMD.speed, [8]);
-	if (model?.feedWithRows) for (let i = 0; i < FEED_AFTER; i++) push(CMD.row, blank);
+	if (gapDots !== void 0) out.push(...catFeed(gapDots, model));
+	else if (model?.feedWithRows) for (let i = 0; i < FEED_AFTER; i++) push(CMD.row, blank);
 	else push(CMD.feed, u16(FEED_AFTER));
 	push(CMD.state, [0]);
 	return Uint8Array.from(out);
 }
+/** Moves the paper by `dots`, back when negative. Models that mishandle the feed command get blank rows. */
+function catFeed(dots, model) {
+	const n = Math.abs(Math.round(dots));
+	if (!n) return /* @__PURE__ */ new Uint8Array();
+	if (dots < 0) return Uint8Array.from(packet(CMD.retract, u16(n)));
+	if (!model?.feedWithRows) return Uint8Array.from(packet(CMD.feed, u16(n)));
+	const blank = new Uint8Array(ROW_BYTES);
+	return Uint8Array.from(Array.from({ length: n }, () => packet(CMD.row, blank)).flat());
+}
 /** A cat printer: the shared thermal client with cat packets and flow control. */
 var CatPrinterClient = class extends ThermalPrinterClient {
 	model;
@@ -592,7 +614,7 @@ var CatPrinterClient = class extends ThermalPrinterClient {
 	}) {
 		super(transport, pace, 180);
 		this.model = model;
-		this.modelName = model?.prefix ?? (transport.name || "Cat printer");
+		this.modelName = shownName(model, transport, "Cat printer");
 		transport.onNotify((data) => {
 			if (same(data, FLOW_PAUSE)) this.paused = true;
 			else if (same(data, FLOW_RESUME)) this.paused = false;
@@ -601,13 +623,19 @@ var CatPrinterClient = class extends ThermalPrinterClient {
 	encodeRows(data, width, height) {
 		return encodeRows$2(data, width, height);
 	}
-	job(rows, density, copies) {
+	job(rows, density, copies, _labelType, gapDots) {
 		return printJob(rows, {
 			density,
 			copies,
-			model: this.model
+			model: this.model,
+			gapDots
 		});
 	}
+	feedsBack = true;
+	/** These printers cannot sense the paper, so the user lines it up by hand. */
+	async feedPaper(dots) {
+		await this.send(catFeed(dots, this.model));
+	}
 };
 var same = (a, b) => a.length === b.length && b.every((v, i) => a[i] === v);
 // src/escpos.ts
@@ -618,10 +646,17 @@ var same = (a, b) => a.length === b.length && b.every((v, i) => a[i] === v);
 */
 var ESCPOS_SERVICE = "000018f0-0000-1000-8000-00805f9b34fb";
 var ESCPOS_WRITE = "00002af1-0000-1000-8000-00805f9b34fb";
+/** The serial service many budget printers offer, Xprinter among them; NIIMBOT printers use it too. */
+var ESCPOS_ALT_SERVICE = "e7810a71-73ae-499d-8c15-faa9aef0c3f2";
+var ESCPOS_ALT_WRITE = "bef8d6c9-9c21-4c9e-b632-bd58c1009f9f";
 /**
-* Models known to take ESC/POS raster images over 18F0. "tested": printed
-* with niimai on real hardware. "medium": the same chipset and service are
-* widely reported, untested here.
+* Models known to take ESC/POS raster images, by Bluetooth name. "tested":
+* printed with niimai on real hardware. "high": supported by several
+* open-source printer projects. "medium": the name is reported by one or two
+* of them, untested here. Names from receipt-printer projects such as
+* WebBluetoothReceiptPrinter and bitbank2/Thermal_Printer; see
+* docs/thermal-printers.md for sources. Most of these printers share one
+* Bluetooth module, so its services tell nothing apart: the name decides.
 */
 var ESCPOS_MODELS = [
 	{
@@ -631,19 +666,57 @@ var ESCPOS_MODELS = [
 	},
 	{
 		prefix: "MPT-II",
-		confidence: "high"
+		confidence: "high",
+		note: "Stock module name on many 58 mm printers"
 	},
 	{
 		prefix: "MP58",
 		confidence: "medium"
 	},
+	{
+		prefix: "MP210",
+		confidence: "medium"
+	},
 	{
 		prefix: "MTP-II",
+		confidence: "high",
+		note: "Stock module name on many 58 mm printers"
+	},
+	{
+		prefix: "MTP-2",
 		confidence: "medium"
 	},
+	{
+		prefix: "MPT-3",
+		confidence: "medium",
+		note: "80 mm",
+		headDots: 576
+	},
+	{
+		prefix: "MTP-3",
+		confidence: "medium",
+		note: "80 mm",
+		headDots: 576
+	},
 	{
 		prefix: "PT-210",
-		confidence: "medium"
+		confidence: "high",
+		brand: "Goojprt PT-210"
+	},
+	{
+		prefix: "PT210",
+		confidence: "medium",
+		brand: "Goojprt PT-210"
+	},
+	{
+		prefix: "GOJRPT",
+		confidence: "medium",
+		brand: "Goojprt"
+	},
+	{
+		prefix: "Gojprt",
+		confidence: "medium",
+		brand: "Goojprt"
 	},
 	{
 		prefix: "PT-200",
@@ -651,35 +724,105 @@ var ESCPOS_MODELS = [
 	},
 	{
 		prefix: "RPP02",
-		confidence: "medium"
+		confidence: "high",
+		brand: "Rongta RPP02N",
+		note: "Also sold as EPPOS EP58 Plus"
+	},
+	{
+		prefix: "RPP300",
+		confidence: "medium",
+		brand: "Rongta RPP300",
+		note: "80 mm",
+		headDots: 576
 	},
 	{
 		prefix: "ZJ-58",
-		confidence: "medium"
+		confidence: "medium",
+		brand: "Zjiang"
+	},
+	{
+		prefix: "TM-P",
+		confidence: "medium",
+		brand: "Epson TM-P series"
+	},
+	{
+		prefix: "XP-P323B",
+		confidence: "medium",
+		brand: "Xprinter XP-P323B",
+		note: "80 mm",
+		headDots: 576
+	},
+	{
+		prefix: "XP-",
+		confidence: "medium",
+		brand: "other Xprinters",
+		generic: true
+	},
+	{
+		prefix: "Printer",
+		confidence: "tested",
+		brand: "Xprinter XP-58IIL, HOIN, Gprinter",
+		note: "Stock module name",
+		generic: true
+	},
+	{
+		prefix: "printer",
+		confidence: "medium",
+		note: "Stock module name",
+		generic: true
+	},
+	{
+		prefix: "BlueTooth Printer",
+		confidence: "medium",
+		note: "Stock module name: Zjiang POS-5805 and others",
+		generic: true
+	},
+	{
+		prefix: "58Printer",
+		confidence: "medium",
+		note: "Stock module name",
+		generic: true
 	}
 ];
 var escposModelFor = (name) => modelFor(ESCPOS_MODELS, name);
-var ROW_BYTES = 48;
 /** Rows per raster command; small bands keep the printer's buffer from overflowing. */
 var BAND = 24;
 /** Dots fed between copies. */
 var GAP_DOTS = 24;
 /** Lines fed after the last copy, so the print clears the tear bar. */
 var FEED_LINES = 4;
-/** Rows for an ESC/POS printer: leftmost dot in the highest bit. */
-var encodeRows$1 = (data, width, height) => packRows(data, width, height, "msb");
-/** ESC @, then each copy as GS v 0 bands with a gap between, then a feed. */
-function escposJob(rows, copies) {
+/** Rows for an ESC/POS printer: leftmost dot in the highest bit, centred on a head `head` dots wide. */
+var encodeRows$1 = (data, width, height, head = 384) => packRows(data, width, height, "msb", head);
+/**
+* ESC @, then each copy as GS v 0 bands with a gap between, then a feed past
+* the tear bar. With `gapDots`, for labels with gaps, every label is followed
+* by exactly that feed, so the next print starts on the next label.
+*/
+function escposJob(rows, copies, gapDots) {
 	const out = [27, 64];
+	const rowBytes = rows[0]?.length ?? 48;
 	for (let c = 0; c < copies; c++) {
-		if (c > 0) out.push(27, 74, GAP_DOTS);
+		if (c > 0) out.push(...escposFeed(gapDots ?? GAP_DOTS));
 		for (let i = 0; i < rows.length; i += BAND) {
 			const band = rows.slice(i, i + BAND);
-			out.push(29, 118, 48, 0, ROW_BYTES & 255, ROW_BYTES >> 8, band.length & 255, band.length >> 8);
+			out.push(29, 118, 48, 0, rowBytes & 255, rowBytes >> 8, band.length & 255, band.length >> 8);
 			for (const row of band) out.push(...row);
 		}
 	}
-	out.push(27, 100, FEED_LINES);
+	if (gapDots === void 0) out.push(27, 100, FEED_LINES);
+	else out.push(...escposFeed(gapDots));
+	return Uint8Array.from(out);
+}
+/**
+* Moves the paper forward by `dots`: line feeds with the line spacing set to
+* the distance (ESC 3 n, LF), then the default spacing back (ESC 2). The
+* MP583 ignores ESC J, the usual dot feed, but takes line feeds. These
+* printers have no reverse feed.
+*/
+function escposFeed(dots) {
+	const out = [];
+	for (let left = Math.round(dots); left > 0; left -= 255) out.push(27, 51, Math.min(255, left), 10);
+	if (out.length) out.push(27, 50);
 	return Uint8Array.from(out);
 }
 /**
@@ -691,19 +834,26 @@ var EscPosPrinterClient = class extends ThermalPrinterClient {
 	model;
 	densityLevels = 1;
 	modelName;
+	headDots;
 	constructor(transport, model, pace = {
 		chunkMs: 30,
 		pauseMs: 100
 	}) {
 		super(transport, pace, 100);
 		this.model = model;
-		this.modelName = model?.prefix ?? (transport.name || "Thermal printer");
+		this.modelName = shownName(model, transport, "Thermal printer");
+		this.headDots = model?.headDots ?? 384;
 	}
 	encodeRows(data, width, height) {
-		return encodeRows$1(data, width, height);
+		return encodeRows$1(data, width, height, this.headDots);
+	}
+	job(rows, _density, copies, _labelType, gapDots) {
+		return escposJob(rows, copies, gapDots);
 	}
-	job(rows, _density, copies) {
-		return escposJob(rows, copies);
+	/** These printers cannot sense the paper, so the user lines it up by hand. */
+	async feedPaper(dots) {
+		if (dots < 0) throw new Error("This printer cannot move the paper back");
+		await this.send(escposFeed(dots));
 	}
 };
 // src/tspl.ts
@@ -713,12 +863,17 @@ var TSPL_NOTIFY = "00002af0-0000-1000-8000-00805f9b34fb";
 var DOTS_PER_MM = 8;
 /**
 * Models known to take TSPL over 18F0. "tested": printed with niimai on real
-* hardware.
+* hardware. "medium": reported by open-source printer projects, untested here.
 */
 var TSPL_MODELS = [{
 	prefix: "QR380A",
 	confidence: "tested",
 	note: "Sold as CC390"
+}, {
+	prefix: "GP-M322",
+	confidence: "medium",
+	brand: "Gprinter GP-M322",
+	headDots: 576
 }];
 var tsplModelFor = (name) => modelFor(TSPL_MODELS, name);
 /** Common 2- to 3-inch label sizes, width × height in mm, smallest first. */
@@ -815,7 +970,7 @@ var TsplPrinterClient = class extends ThermalPrinterClient {
 	ackTimeoutMs;
 	densityLevels = DENSITY_LEVELS;
 	modelName;
-	headDots = 640;
+	headDots;
 	kind = void 0;
 	labelSizes = TSPL_SIZES;
 	oks = 0;
@@ -828,7 +983,8 @@ var TsplPrinterClient = class extends ThermalPrinterClient {
 		super(transport, pace, 100);
 		this.model = model;
 		this.ackTimeoutMs = ackTimeoutMs;
-		this.modelName = model?.prefix ?? (transport.name || "Label printer");
+		this.modelName = shownName(model, transport, "Label printer");
+		this.headDots = model?.headDots ?? 640;
 		transport.onNotify((data) => {
 			if (data.length >= 2 && data[0] === OK[0] && data[1] === OK[1]) this.oks++;
 			else if (data.length === 1) this.status = data[0];
@@ -876,14 +1032,137 @@ var TsplPrinterClient = class extends ThermalPrinterClient {
 		console.warn("[niimai] Label printer did not confirm the job");
 	}
 };
+// 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",
+		model
+	})),
+	...TSPL_MODELS.map((model) => ({
+		family: "tspl",
+		model
+	})),
+	...CAT_MODELS.map((model) => ({
+		family: "cat",
+		model
+	}))
+];
+/** The known printer a Bluetooth name belongs to, longest prefix first across every family. */
+function identifyPrinter(name) {
+	if (!name) return null;
+	let best = null;
+	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 kinds of printer an unrecognised one can be set to, alongside NIIMBOT's MANUAL_PROFILES. */
+var PRINTER_TYPES = [
+	{
+		id: "escpos-58",
+		name: "Receipt printer, 58 mm",
+		family: "escpos",
+		model: {
+			prefix: "",
+			confidence: "medium",
+			generic: true,
+			headDots: 384
+		}
+	},
+	{
+		id: "escpos-80",
+		name: "Receipt printer, 80 mm",
+		family: "escpos",
+		model: {
+			prefix: "",
+			confidence: "medium",
+			generic: true,
+			headDots: 576
+		}
+	},
+	{
+		id: "tspl",
+		name: "Label printer (TSPL)",
+		family: "tspl",
+		model: {
+			prefix: "",
+			confidence: "medium",
+			generic: true,
+			headDots: 640
+		}
+	},
+	{
+		id: "cat",
+		name: "Cat printer",
+		family: "cat",
+		model: {
+			prefix: "",
+			confidence: "medium",
+			generic: true
+		}
+	}
+];
+var findPrinterType = (id) => PRINTER_TYPES.find((t) => t.id === id) ?? null;
 // src/bluetooth.ts
 /**
+* A writable characteristic on one of the serial services budget printers
+* offer, for ESC/POS printers on none of the known layouts.
+*/
+async function writeChannel(server, services) {
+	for (const service of CANDIDATE_SERVICES) {
+		if (!services.includes(service) || service === "0000ae30-0000-1000-8000-00805f9b34fb") continue;
+		const write = (await server.getPrimaryService(service).then((s) => s.getCharacteristics()).catch(() => [])).find((c) => c.properties.writeWithoutResponse || c.properties.write);
+		if (write) return {
+			service,
+			write: write.uuid
+		};
+	}
+	return null;
+}
+var PRINTER_TYPE_NAMES = {
+	escpos: "receipt printer",
+	tspl: "label printer",
+	cat: "cat printer"
+};
+/** The client for a known or hand-picked thermal printer, over the service its family uses; null when the printer lacks it. */
+async function thermalClient(device, server, services, { family, model }) {
+	if (family === "cat") return services.includes("0000ae30-0000-1000-8000-00805f9b34fb") ? new CatPrinterClient(await webTransport(device, server, {
+		service: CAT_SERVICE,
+		write: CAT_TX,
+		notify: CAT_RX
+	}), model) : null;
+	if (family === "tspl") return services.includes("000018f0-0000-1000-8000-00805f9b34fb") ? new TsplPrinterClient(await webTransport(device, server, {
+		service: TSPL_SERVICE,
+		write: TSPL_WRITE,
+		notify: TSPL_NOTIFY
+	}), model) : null;
+	const channel = 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);
+	return channel ? new EscPosPrinterClient(await webTransport(device, server, channel), model) : 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);
+}
+/**
 * The Bluetooth printer behind the Connect button. One chooser lists NIIMBOT
 * printers and the known extra thermal printers. A known cat printer offering
-* AE30 gets the cat client, a known ESC/POS printer offering 18F0 the ESC/POS
-* client, a known TSPL label printer offering 18F0 the TSPL client, and
-* everything else the NIIMBOT client exactly as before. Known names never
-* overlap, so each printer matches one client at most.
+* AE30 gets the cat client; a known ESC/POS printer the ESC/POS client, over
+* 18F0, the shared E781 service (as Xprinters use), or any serial service
+* with a writable characteristic; a known TSPL label printer offering 18F0
+* 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 {
 	lib;
@@ -895,36 +1174,31 @@ var BluetoothPrinter = class {
 		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);
+	}
 	async connect() {
-		const device = await requestPrinter([
-			...CAT_MODELS,
-			...ESCPOS_MODELS,
-			...TSPL_MODELS
-		].map((m) => m.prefix));
-		const cat = catModelFor(device.name);
-		const escpos = escposModelFor(device.name);
-		const tspl = tsplModelFor(device.name);
-		if ((cat || escpos || tspl) && device.gatt) {
+		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;
+		const entry = known ?? fallback;
+		if (entry && device.gatt) {
 			const server = await device.gatt.connect();
 			const services = (await server.getPrimaryServices().catch(() => [])).map((s) => s.uuid);
-			if (cat && services.includes("0000ae30-0000-1000-8000-00805f9b34fb")) this.inner = new CatPrinterClient(await webTransport(device, server, {
-				service: CAT_SERVICE,
-				write: CAT_TX,
-				notify: CAT_RX
-			}), cat);
-			else if (escpos && services.includes("000018f0-0000-1000-8000-00805f9b34fb")) this.inner = new EscPosPrinterClient(await webTransport(device, server, {
-				service: ESCPOS_SERVICE,
-				write: ESCPOS_WRITE
-			}), escpos);
-			else if (tspl && services.includes("000018f0-0000-1000-8000-00805f9b34fb")) this.inner = new TsplPrinterClient(await webTransport(device, server, {
-				service: TSPL_SERVICE,
-				write: TSPL_WRITE,
-				notify: TSPL_NOTIFY
-			}), tspl);
+			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`);
+		}
+		const lib = await this.lib();
+		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.`);
 		}
-		this.inner = createBleClient(await this.lib(), device);
-		return this.inner.connect();
 	}
 	async disconnect() {
 		await this.inner?.disconnect();
@@ -971,6 +1245,12 @@ var BluetoothPrinter = class {
 	get rollKey() {
 		return this.inner?.rollKey?.bind(this.inner);
 	}
+	get feedPaper() {
+		return this.inner?.feedPaper?.bind(this.inner);
+	}
+	get feedsBack() {
+		return this.inner?.feedsBack;
+	}
 };
 // src/mock.ts
 /** A printer that only exists in memory. Used by the demo mode and the tests. */
@@ -1346,6 +1626,8 @@ var PrinterService = class {
 	listeners = /* @__PURE__ */ new Set();
 	manualProfileId = null;
 	detach = null;
+	/** Paper moves run one after another, and a print waits for them. */
+	feeding = Promise.resolve();
 	/** How the current printer is connected. */
 	kind = null;
 	constructor(createClient, encode) {
@@ -1412,6 +1694,7 @@ var PrinterService = class {
 		let client;
 		try {
 			client = await this.createClient(kind);
+			client.unrecognisedAs?.(this.manualProfileId);
 			const info = await client.connect();
 			this.client = client;
 			this.set({ deviceName: info.deviceName });
@@ -1448,7 +1731,9 @@ var PrinterService = class {
 			battery: client.getPrinterInfo().batteryPercents,
 			detectedModel: meta?.model,
 			profile: this.currentProfile(),
-			label: this.readRfid()
+			label: this.readRfid(),
+			...client.feedPaper ? { canFeed: true } : {},
+			...client.feedPaper && client.feedsBack ? { canRetract: true } : {}
 		});
 		client.startHeartbeat();
 	}
@@ -1485,12 +1770,31 @@ var PrinterService = class {
 			total: copies
 		} });
 	}
+	/**
+	* 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.
+	*/
+	feed(mm) {
+		const client = this.client;
+		const profile = this.status.profile;
+		if (!client || !profile) return Promise.reject(/* @__PURE__ */ new Error("Connect a printer first"));
+		if (!client.feedPaper) return Promise.reject(/* @__PURE__ */ new Error("This printer finds the paper itself"));
+		if (mm < 0 && !client.feedsBack) return Promise.reject(/* @__PURE__ */ new Error("This printer cannot move the paper back"));
+		if (this.status.state === "printing") return Promise.reject(/* @__PURE__ */ new Error("Wait for the print to finish"));
+		const dots = Math.round(mmToPx(mm, profile.dpi));
+		const run = this.feeding.then(() => dots ? client.feedPaper(dots) : void 0);
+		this.feeding = run.catch(() => {});
+		return run.catch((err) => {
+			throw new Error(friendlyError(err));
+		});
+	}
 	async print(source, opts) {
 		const client = this.client;
 		const profile = this.status.profile;
 		if (!client) throw new Error("Connect a printer first");
 		if (!profile) throw new Error("Choose your printer type");
 		if (this.status.state === "printing") throw new Error("Already printing");
+		await this.feeding;
 		const pages = "page" in source ? source : {
 			count: 1,
 			page: async () => source
@@ -1502,6 +1806,7 @@ var PrinterService = class {
 			totalPages: total,
 			density,
 			labelType: opts.labelType ?? 1,
+			...opts.gapMm !== void 0 && client.feedPaper ? { gapDots: Math.round(mmToPx(Math.max(0, opts.gapMm), profile.dpi)) } : {},
 			pageColor: 0,
 			statusPollIntervalMs: 100,
 			statusTimeoutMs: 8e3
@@ -1598,6 +1903,6 @@ async function createClient(kind) {
 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, PrinterService, THERMAL_DEFAULT_SIZE, THERMAL_HEAD_DOTS, THERMAL_HEAD_MM, THERMAL_SIZES, TSPL_MODELS, TSPL_SIZES, ThermalPrinterClient, TsplPrinterClient, printJob as catJob, catModelFor, correctTask, createClient, createPrinter, describeBleError, detectPlatform, effectivePaper, escposJob, escposModelFor, findManualProfile, fitToPrinthead, friendlyError, inkOutsideHead, labelTypeOf, modelFor, paperFromLabelType, paperName, printheadCrop, printheadMm, resolveProfile, shiftCanvas, 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, catFeed, printJob as catJob, catModelFor, correctTask, createClient, createPrinter, describeBleError, detectPlatform, effectivePaper, escposFeed, escposJob, escposModelFor, findManualProfile, findPrinterType, fitToPrinthead, friendlyError, identifyPrinter, inkOutsideHead, labelTypeOf, modelFor, paperFromLabelType, paperName, printheadCrop, printheadMm, resolveProfile, shiftCanvas, supportsBluetooth, supportsSerial, tsplJob, tsplModelFor, unsupportedReason, webTransport };
 
 //# sourceMappingURL=libniimai.js.map