react-native-earl-thermal-printer 1.0.0

package/src/index.ts

@@ -0,0 +1,160 @@
+import { NativeEventEmitter } from "react-native";
+
+import NativeUSBPrinterModule from "./NativeUSBPrinter";
+import NativeBLEPrinterModule from "./NativeBLEPrinter";
+import NativeNetPrinterModule from "./NativeNetPrinter";
+import * as EPToolkit from "./utils/EPToolkit";
+
+// ── Types ───────────────────────────────────────────────────────────────────
+
+export interface PrinterOptions {
+	beep?: boolean;
+	cut?: boolean;
+	tailingLine?: boolean;
+	encoding?: string;
+}
+
+export interface IUSBPrinter {
+	device_name: string;
+	device_id: number;
+	vendor_id: number;
+	product_id: number;
+}
+
+export interface IBLEPrinter {
+	device_name: string;
+	inner_mac_address: string;
+}
+
+export interface INetPrinter {
+	device_name: string;
+	host: string;
+	port: number;
+}
+
+// ── Helpers ─────────────────────────────────────────────────────────────────
+
+const textTo64Buffer = (text: string, opts: PrinterOptions): string => {
+	const options = {
+		beep: false,
+		cut: false,
+		tailingLine: false,
+		encoding: "UTF8",
+		...opts,
+	};
+	const buffer = EPToolkit.exchange_text(text, options);
+	return buffer.toString("base64");
+};
+
+const billTo64Buffer = (text: string, opts: PrinterOptions): string => {
+	const options = {
+		beep: true,
+		cut: true,
+		tailingLine: true,
+		encoding: "UTF8",
+		...opts,
+	};
+	const buffer = EPToolkit.exchange_text(text, options);
+	return buffer.toString("base64");
+};
+
+// ── USB Printer ─────────────────────────────────────────────────────────────
+
+export const USBPrinter = {
+	init: (): Promise<string> => NativeUSBPrinterModule.init(),
+
+	getDeviceList: (): Promise<IUSBPrinter[]> =>
+		NativeUSBPrinterModule.getDeviceList() as Promise<IUSBPrinter[]>,
+
+	connectPrinter: (
+		vendorId: number,
+		productId: number,
+	): Promise<IUSBPrinter> =>
+		NativeUSBPrinterModule.connectPrinter(
+			vendorId,
+			productId,
+		) as Promise<IUSBPrinter>,
+
+	closeConn: (): void => NativeUSBPrinterModule.closeConn(),
+
+	printText: (text: string, opts: PrinterOptions = {}): Promise<void> =>
+		NativeUSBPrinterModule.printRawData(textTo64Buffer(text, opts)),
+
+	printBill: (text: string, opts: PrinterOptions = {}): Promise<void> =>
+		NativeUSBPrinterModule.printRawData(billTo64Buffer(text, opts)),
+
+	printImage: (imageUrl: string): Promise<void> =>
+		NativeUSBPrinterModule.printImageData(imageUrl),
+
+	printQrCode: (qrCode: string): Promise<void> =>
+		NativeUSBPrinterModule.printQrCode(qrCode),
+};
+
+// ── BLE Printer ─────────────────────────────────────────────────────────────
+
+export const BLEPrinter = {
+	init: (): Promise<string> => NativeBLEPrinterModule.init(),
+
+	getDeviceList: (): Promise<IBLEPrinter[]> =>
+		NativeBLEPrinterModule.getDeviceList() as Promise<IBLEPrinter[]>,
+
+	connectPrinter: (innerMacAddress: string): Promise<IBLEPrinter> =>
+		NativeBLEPrinterModule.connectPrinter(
+			innerMacAddress,
+		) as Promise<IBLEPrinter>,
+
+	closeConn: (): void => NativeBLEPrinterModule.closeConn(),
+
+	printText: (text: string, opts: PrinterOptions = {}): Promise<void> =>
+		NativeBLEPrinterModule.printRawData(textTo64Buffer(text, opts)),
+
+	printBill: (text: string, opts: PrinterOptions = {}): Promise<void> =>
+		NativeBLEPrinterModule.printRawData(billTo64Buffer(text, opts)),
+
+	printImage: (imageUrl: string): Promise<void> =>
+		NativeBLEPrinterModule.printImageData(imageUrl),
+
+	printQrCode: (qrCode: string): Promise<void> =>
+		NativeBLEPrinterModule.printQrCode(qrCode),
+};
+
+// ── Net Printer ─────────────────────────────────────────────────────────────
+
+export const NetPrinter = {
+	init: (): Promise<string> => NativeNetPrinterModule.init(),
+
+	getDeviceList: (): Promise<INetPrinter[]> =>
+		NativeNetPrinterModule.getDeviceList() as Promise<INetPrinter[]>,
+
+	connectPrinter: (host: string, port: number): Promise<INetPrinter> =>
+		NativeNetPrinterModule.connectPrinter(
+			host,
+			port,
+		) as Promise<INetPrinter>,
+
+	closeConn: (): void => NativeNetPrinterModule.closeConn(),
+
+	printText: (text: string, opts: PrinterOptions = {}): Promise<void> =>
+		NativeNetPrinterModule.printRawData(textTo64Buffer(text, opts)),
+
+	printBill: (text: string, opts: PrinterOptions = {}): Promise<void> =>
+		NativeNetPrinterModule.printRawData(billTo64Buffer(text, opts)),
+
+	printImage: (imageUrl: string): Promise<void> =>
+		NativeNetPrinterModule.printImageData(imageUrl),
+
+	printQrCode: (qrCode: string): Promise<void> =>
+		NativeNetPrinterModule.printQrCode(qrCode),
+};
+
+// ── Events ──────────────────────────────────────────────────────────────────
+
+export const NetPrinterEventEmitter = new NativeEventEmitter(
+	NativeNetPrinterModule,
+);
+
+export enum RN_THERMAL_RECEIPT_PRINTER_EVENTS {
+	EVENT_NET_PRINTER_SCANNED_SUCCESS = "scannerResolved",
+	EVENT_NET_PRINTER_SCANNING = "scannerRunning",
+	EVENT_NET_PRINTER_SCANNED_ERROR = "registerError",
+}

package/src/utils/EPToolkit.ts

@@ -0,0 +1,193 @@
+import { Buffer } from "buffer";
+import * as iconv from "iconv-lite";
+// import * as Jimp from "jimp";
+
+import BufferHelper from "./buffer-helper";
+
+const init_printer_bytes = Buffer.from([27, 64]);
+const l_start_bytes = Buffer.from([27, 97, 0]);
+const l_end_bytes = Buffer.from([]);
+const c_start_bytes = Buffer.from([27, 97, 1]);
+const c_end_bytes = Buffer.from([]); // [ 27, 97, 0 ];
+const r_start_bytes = Buffer.from([27, 97, 2]);
+const r_end_bytes = Buffer.from([]);
+
+const default_space_bytes = Buffer.from([27, 50]);
+
+const reset_bytes = Buffer.from([27, 97, 0, 29, 33, 0, 27, 50]);
+const m_start_bytes = Buffer.from([27, 33, 16, 28, 33, 8]);
+const m_end_bytes = Buffer.from([27, 33, 0, 28, 33, 0]);
+const b_start_bytes = Buffer.from([27, 33, 48, 28, 33, 12]);
+const b_end_bytes = Buffer.from([27, 33, 0, 28, 33, 0]);
+const cm_start_bytes = Buffer.from([27, 97, 1, 27, 33, 16, 28, 33, 8]);
+const cm_end_bytes = Buffer.from([27, 33, 0, 28, 33, 0]);
+const cb_start_bytes = Buffer.from([27, 97, 1, 27, 33, 48, 28, 33, 12]);
+const cb_end_bytes = Buffer.from([27, 33, 0, 28, 33, 0]);
+const cd_start_bytes = Buffer.from([27, 97, 1, 27, 33, 32, 28, 33, 4]);
+const cd_end_bytes = Buffer.from([27, 33, 0, 28, 33, 0]);
+const d_start_bytes = Buffer.from([27, 33, 32, 28, 33, 4]);
+const d_end_bytes = Buffer.from([27, 33, 0, 28, 33, 0]);
+
+const cut_bytes = Buffer.from([27, 105]);
+const beep_bytes = Buffer.from([27, 66, 3, 2]);
+const line_bytes = Buffer.from([10, 10, 10, 10, 10]);
+
+const encoding_mappings_bytes: { [key: string]: Buffer } = {
+	// single byte encodings
+	CP437: Buffer.from([27, 116, 0]),
+	// multiple bit encodings
+	GB18030: Buffer.from([28, 38, 28, 67, 0]),
+	BIG5: Buffer.from([28, 38, 28, 67, 1]),
+	UTF8: Buffer.from([28, 38, 28, 67, 255]),
+};
+
+const options_controller = {
+	cut: cut_bytes,
+	beep: beep_bytes,
+	tailingLine: line_bytes,
+	encoding: encoding_mappings_bytes,
+};
+
+const controller: { [key: string]: Buffer } = {
+	"<M>": m_start_bytes,
+	"</M>": m_end_bytes,
+	"<B>": b_start_bytes,
+	"</B>": b_end_bytes,
+	"<D>": d_start_bytes,
+	"</D>": d_end_bytes,
+	"<C>": c_start_bytes,
+	"</C>": c_end_bytes,
+	"<CM>": cm_start_bytes,
+	"</CM>": cm_end_bytes,
+	"<CD>": cd_start_bytes,
+	"</CD>": cd_end_bytes,
+	"<CB>": cb_start_bytes,
+	"</CB>": cb_end_bytes,
+	"<L>": l_start_bytes,
+	"</L>": l_end_bytes,
+	"<R>": r_start_bytes,
+	"</R>": r_end_bytes,
+};
+
+type IOptions = {
+	beep: boolean;
+	cut: boolean;
+	tailingLine: boolean;
+	encoding: string;
+};
+
+const default_options: IOptions = {
+	beep: false,
+	cut: true,
+	tailingLine: true,
+	encoding: "UTF8",
+};
+
+export function exchange_text(text: string, options: IOptions): Buffer {
+	const m_options = options || default_options;
+
+	let bytes = new BufferHelper();
+	bytes.concat(init_printer_bytes);
+
+	// set encoding
+	if (
+		m_options["encoding"] &&
+		options_controller["encoding"][m_options["encoding"]]
+	) {
+		bytes.concat(options_controller["encoding"][m_options["encoding"]]);
+	}
+
+	bytes.concat(default_space_bytes);
+
+	let temp = "";
+	for (let i = 0; i < text.length; i++) {
+		let ch = text[i];
+		switch (ch) {
+			case "<":
+				bytes.concat(iconv.encode(temp, m_options.encoding));
+				temp = "";
+				// add bytes for changing font and justifying text
+				for (const tag in controller) {
+					if (text.substring(i, i + tag.length) === tag) {
+						bytes.concat(controller[tag]);
+						i += tag.length - 1;
+					}
+				}
+				break;
+			case "\n":
+				temp = `${temp}${ch}`;
+				bytes.concat(iconv.encode(temp, m_options.encoding));
+				bytes.concat(reset_bytes);
+				temp = "";
+				break;
+			default:
+				temp = `${temp}${ch}`;
+				break;
+		}
+	}
+	temp.length && bytes.concat(iconv.encode(temp, m_options.encoding));
+
+	// check for "tailingLine" flag
+	if (
+		typeof m_options["tailingLine"] === "boolean" &&
+		options_controller["tailingLine"]
+	) {
+		bytes.concat(options_controller["tailingLine"]);
+	}
+
+	// check for "cut" flag
+	if (typeof m_options["cut"] === "boolean" && options_controller["cut"]) {
+		bytes.concat(options_controller["cut"]);
+	}
+
+	// check for "beep" flag
+	if (typeof m_options["beep"] === "boolean" && options_controller["beep"]) {
+		bytes.concat(options_controller["beep"]);
+	}
+
+	return bytes.toBuffer();
+}
+
+// export async function exchange_image(
+//   imagePath: string,
+//   threshold: number
+// ): Promise<Buffer> {
+//   let bytes = new BufferHelper();
+
+//   try {
+//     // need to find other solution cause jimp is not working in RN
+//     const raw_image = await Jimp.read(imagePath);
+//     const img = raw_image.resize(250, 250).quality(60).greyscale();
+
+//     let hex;
+//     const nl = img.bitmap.width % 256;
+//     const nh = Math.round(img.bitmap.width / 256);
+
+//     // data
+//     const data = Buffer.from([0, 0, 0]);
+//     const line = Buffer.from([10]);
+//     for (let i = 0; i < Math.round(img.bitmap.height / 24) + 1; i++) {
+//       // ESC * m nL nH bitmap
+//       let header = Buffer.from([27, 42, 33, nl, nh]);
+//       bytes.concat(header);
+//       for (let j = 0; j < img.bitmap.width; j++) {
+//         data[0] = data[1] = data[2] = 0; // Clear to Zero.
+//         for (let k = 0; k < 24; k++) {
+//           if (i * 24 + k < img.bitmap.height) {
+//             // if within the BMP size
+//             hex = img.getPixelColor(j, i * 24 + k);
+//             if (Jimp.intToRGBA(hex).r <= threshold) {
+//               data[Math.round(k / 8)] += 128 >> k % 8;
+//             }
+//           }
+//         }
+//         const dit = Buffer.from([data[0], data[1], data[2]]);
+//         bytes.concat(dit);
+//       }
+//       bytes.concat(line);
+//     } // data
+//   } catch (error) {
+//     console.log(error);
+//   }
+//   return bytes.toBuffer();
+// }

package/src/utils/buffer-helper.ts

@@ -0,0 +1,42 @@
+import { Buffer } from "buffer";
+
+export default class BufferHelper {
+  buffers: Buffer[];
+  size: number;
+
+  constructor() {
+    this.buffers = [];
+    this.size = 0;
+  }
+
+  get length() {
+    return this.size;
+  }
+
+  concat = (buffer: Buffer): BufferHelper => {
+    this.buffers.push(buffer);
+    this.size += buffer.length;
+    return this;
+  };
+
+  empty = (): BufferHelper => {
+    this.buffers = [];
+    this.size = 0;
+    return this;
+  };
+
+  toBuffer = (): Buffer => Buffer.concat(this.buffers, this.size);
+
+  toString = (encoding: BufferEncoding): string =>
+    this.toBuffer().toString(encoding);
+
+  load = (stream: any, callback: any) => {
+    stream.on("data", (trunk: Buffer) => {
+      this.concat(trunk);
+    });
+    stream.on("end", () => {
+      callback(null, this.toBuffer());
+    });
+    stream.once("error", callback);
+  };
+}