tauri-plugin-thermal-printer 1.3.3 → 2.0.0

package/README.md

@@ -1,5 +1,8 @@
 # Tauri Plugin thermal-printer
 
+> **BREAKING CHANGES:** The 2.0.0 and newer versions **removed** the `PrinterOptions` interface to simplify configuration. The `options` field in `PrintJobRequest` now directly accepts a `CodePage` object. 
+> The shorthand options (`cut_paper`, `beep`, and `open_cash_drawer`) have been **removed**. If you need these actions, explicitly append them as sections (e.g., `{"Cut": {"mode": "partial", "feed": 0}}`) at the end of your `sections` array.
+
 This plugin provides thermal printer functionality for Tauri applications, allowing you to print documents, test printers, and list available printers.
 
 | Platform | Supported |
@@ -90,7 +93,7 @@ pub fn generate_document(&mut self, print_job: &PrintJobRequest) -> Result<Vec<u
 #### 4. **OS Integration** (`src/desktop_printers/` and `android/`)
 - **Linux/macOS**: Uses CUPS system (`lpstat`, `lp` commands)
 - **Windows**: Uses WinAPI (Windows API) to directly access system printers via functions such as EnumPrintersW for listing printers, OpenPrinterW for opening printer handles, and WritePrinter for sending raw data
-- **Android**: Kotlin plugin with Bluetooth SPP, USB, and Network (TCP/IP) printer discovery and printing
+- **Android**: Kotlin plugin with Bluetooth SPP and USB printer discovery and printing
 
 ### Workflow
 
@@ -106,8 +109,8 @@ pub fn generate_document(&mut self, print_job: &PrintJobRequest) -> Result<Vec<u
 
 1. **Frontend** sends `PrintJobRequest` with sections and configuration
 2. **Rust** generates ESC/POS binary data using the same `ProcessPrint` pipeline
-3. **Kotlin plugin** receives the binary data and the printer identifier (MAC, USB VID:PID, or IP:PORT)
-4. Connection is established via **Bluetooth SPP**, **USB Bulk Transfer**, or **TCP Socket**
+3. **Kotlin plugin** receives the binary data and the printer MAC address
+4. **Bluetooth SPP** connection is established to the printer
 5. **Thermal Printer** interprets ESC/POS commands and prints
 
 #### Print Structure Example:
@@ -116,8 +119,8 @@ pub fn generate_document(&mut self, print_job: &PrintJobRequest) -> Result<Vec<u
   "printer": "TM-T20II",
   "paper_size": "Mm80",
   "options": {
-    "cut_paper": true,
-    "beep": false
+    "code_page": 6,
+    "encode": "WINDOWS_1252"
   },
   "sections": [
     {"Title": {"text": "My Title"}},
@@ -150,18 +153,18 @@ The plugin translates all sections into **ESC/POS** (Escape Sequence for Point o
 - ✅ **Linux**: Fully functional (CUPS)
 - ✅ **macOS**: Fully functional (CUPS)
 - ✅ **Windows**: Fully functional (WinAPI)
-- ✅ **Android**: Bluetooth, USB, and Network printer discovery and printing
+- ✅ **Android**: Bluetooth and USB printer discovery and printing
 - ❌ **iOS**: Not implemented
 
 ### Supported Connections
 
 | Connection | Linux | macOS | Windows | Android |
 | ---------- | ----- | ----- | ------- | ------- |
-| USB        | ✅    | ✅    | ✅      | ✅      |
-| Network    | ✅    | ✅    | ✅      | ✅      |
+| USB        | ✅    | ✅    | ✅      | ✅ (discovery only) |
+| Network    | ✅    | ✅    | ✅      | ❌      |
 | Bluetooth  | ❌    | ❌    | ❌      | ✅      |
 
-> **Android note**: The `printer` field in `PrintJobRequest` must be the printer identifier returned by `list_thermal_printers`. For Bluetooth, it's the MAC address (e.g. `"AA:BB:CC:DD:EE:FF"`). For USB, it's `"VID:xxxx/PID:yyyy"`. For Network, it's `"IP:PORT"` (e.g. `"192.168.1.100:9100"`). Required permissions (Bluetooth, USB, Internet) are handled automatically at runtime.
+> **Android note**: The `printer` field in `PrintJobRequest` must be the Bluetooth MAC address of the printer (e.g. `"AA:BB:CC:DD:EE:FF"`). The printer must be previously paired in the Android Bluetooth settings. Bluetooth permissions are requested automatically at runtime.
 
 ## Installation
 
@@ -281,14 +284,9 @@ try { await test_thermal_printer({
     "printer": "TM-T20II",
     "paper_size": "Mm80",
     "options": {
-      "cut_paper": true,
-      "beep": true,
-      "open_cash_drawer": false,
-      "code_page": {
-        "code_page": 6,
-        "encode": ENCODE.WINDOWS_1252,
-        "use_gbk": false
-      }
+      "code_page": 6,
+      "encode": ENCODE.WINDOWS_1252,
+      "use_gbk": false
     },
     "sections": [] // it's not going to print anything
   },
@@ -352,14 +350,9 @@ try { await print_thermal_printer({
   "printer": "TM-T20II",
   "paper_size": "Mm80",
   "options": {
-    "cut_paper": true,
-    "beep": false,
-    "open_cash_drawer": false,
-    "code_page": {
-      "code_page": 6,
-      "encode": ENCODE.WINDOWS_1252,
-      "use_gbk": false
-    }
+    "code_page": 6,
+    "encode": ENCODE.WINDOWS_1252,
+    "use_gbk": false
   },
   "sections": [
     {"Title": {"text": "My Business"}},
@@ -390,15 +383,9 @@ Returns `Promise<void>`. Resolves when printing completes successfully. **Throws
 |-----------|------|----------|-------------|
 | `printer` | string | ✅ Yes | Printer name |
 | `paper_size` | PaperSize | ❌ No | Paper size (default: `"Mm80"`) — see [Paper Sizes](#paper-sizes) |
-| `options` | PrinterOptions | ❌ No | Configuration options |
-| `options.cut_paper` | boolean | ❌ No | Append a tail `Cut` section equivalent to `{ "Cut": { "mode": "partial", "feed": 0 } }` (default: `true`) |
-| `options.beep` | boolean | ❌ No | Append a tail `Beep` section equivalent to `{ "Beep": { "times": 1, "duration": 3 } }` (default: `false`) |
-| `options.open_cash_drawer` | boolean | ❌ No | Append a tail `Drawer` section equivalent to `{ "Drawer": { "pin": 2, "pulse_time": 100 } }` (default: `false`) |
-| `options.code_page` | CodePage | ✅ Yes | Required ESC/POS page selection plus host-side encoding strategy — see [CodePage](#codepage) |
+| `options` | CodePage | ✅ Yes | Required ESC/POS page selection plus host-side encoding strategy — see [CodePage](#codepage) |
 | `sections` | array | ✅ Yes | Array of sections to print (see [Section Types](#section-types)) |
 
-`options.cut_paper`, `options.beep`, and `options.open_cash_drawer` are tail-action shorthands. They append sections at the end of the document in this fixed order: `Beep` → `Cut` → `Drawer`. They do **not** disable or replace manually declared sections, so if you specify both, both actions are emitted.
-
 #### Paper Sizes
 
 | Value | Paper width | Chars/line | Typical use |
@@ -899,14 +886,9 @@ Each printer model assigns its own `ESC t n` values, so `CodePage.code_page` acc
 import { ENCODE, type CodePage } from "tauri-plugin-thermal-printer";
 
 const options = {
-  cut_paper: true,
-  beep: false,
-  open_cash_drawer: false,
-  code_page: {
-    code_page: 6,
-    encode: ENCODE.WINDOWS_1252,
-    use_gbk: false,
-  }, // sends ESC t 6
+  code_page: 6,
+  encode: ENCODE.WINDOWS_1252,
+  use_gbk: false,
 };
 ```
 
@@ -1070,14 +1052,9 @@ const job: PrintJobRequest = {
   printer: "TM-T20II",
   paper_size: "Mm80",
   options: {
-    cut_paper: true,
-    beep: false,
-    open_cash_drawer: false,
-    code_page: {
-      code_page: 6,
-      encode: ENCODE.WINDOWS_1252,
-      use_gbk: false,
-    },
+    code_page: 0,
+    encode: ENCODE.ACCENT_REMOVER,
+    use_gbk: false,
   },
   sections: [
     globalStyles({ align: TEXT_ALIGN.LEFT }),
@@ -1157,9 +1134,9 @@ const receipt: PrintJobRequest = {
   "printer": "TM-T20II",
   "paper_size": "Mm80",
   "options": {
-    "cut_paper": true,
-    "beep": false,
-    "open_cash_drawer": false
+    "code_page": 0,
+    "encode": ENCODE.ACCENT_REMOVER,
+    "use_gbk": false,
   },
   "sections": [
     {"Title": {"text": "SUPERMERCADO LA ECONOMÍA", "styles": {"bold": true, "underline": false, "align": "center", "italic": false, "invert": false, "font": "A", "rotate": false, "upside_down": false, "size": "Double"}}},
@@ -1279,9 +1256,9 @@ const restaurantTicket: PrintJobRequest = {
   "printer": "TM-T20II",
   "paper_size": "Mm80",
   "options": {
-    "cut_paper": true,
-    "beep": false,
-    "open_cash_drawer": false
+    "code_page": 0,
+    "encode": ENCODE.ACCENT_REMOVER,
+    "use_gbk": false,
   },
   "sections": [
     {"Title": {"text": "RESTAURANTE EL BUEN SABOR", "styles": {"bold": true, "underline": false, "align": "center", "italic": false, "invert": false, "font": "A", "rotate": false, "upside_down": false, "size": "Double"}}},
@@ -1366,9 +1343,9 @@ const kitchenOrder: PrintJobRequest = {
   "printer": "TM-T20II",
   "paper_size": "Mm80",
   "options": {
-    "cut_paper": true,
-    "beep": true,
-    "open_cash_drawer": false
+    "code_page": 0,
+    "encode": ENCODE.ACCENT_REMOVER,
+    "use_gbk": false,
   },
   "sections": [
     {"Title": {"text": "*** COMANDA COCINA ***", "styles": {"bold": true, "underline": false, "align": "center", "italic": false, "invert": false, "font": "A", "rotate": false, "upside_down": false, "size": "Double"}}},
@@ -1404,9 +1381,9 @@ const productLabel: PrintJobRequest = {
   "printer": "TM-T20II",
   "paper_size": "Mm58",
   "options": {
-    "cut_paper": true,
-    "beep": false,
-    "open_cash_drawer": false
+    "code_page": 0,
+    "encode": ENCODE.ACCENT_REMOVER,
+    "use_gbk": false,
   },
   "sections": [
     {"Title": {"text": "PRODUCTO", "styles": {"bold": true, "underline": false, "align": "center", "italic": false, "invert": false, "font": "A", "rotate": false, "upside_down": false, "size": "Double"}}},
@@ -1432,9 +1409,9 @@ const turnTicket: PrintJobRequest = {
   "printer": "TM-T20II",
   "paper_size": "Mm58",
   "options": {
-    "cut_paper": true,
-    "beep": true,
-    "open_cash_drawer": false
+    "code_page": 0,
+    "encode": ENCODE.ACCENT_REMOVER,
+    "use_gbk": false,
   },
   "sections": [
     {"Title": {"text": "TICKET DE TURNO", "styles": {"bold": true, "underline": false, "align": "center", "italic": false, "invert": false, "font": "A", "rotate": false, "upside_down": false, "size": "Double"}}},
@@ -1465,9 +1442,9 @@ const parkingTicket: PrintJobRequest = {
   "printer": "TM-T20II",
   "paper_size": "Mm80",
   "options": {
-    "cut_paper": true,
-    "beep": false,
-    "open_cash_drawer": false
+    "code_page": 0,
+    "encode": ENCODE.ACCENT_REMOVER,
+    "use_gbk": false,
   },
   "sections": [
     {"Title": {"text": "ESTACIONAMIENTO", "styles": {"bold": true, "underline": false, "align": "center", "italic": false, "invert": false, "font": "A", "rotate": false, "upside_down": false, "size": "Double"}}},
@@ -1502,9 +1479,9 @@ const eventTicket: PrintJobRequest = {
   "printer": "TM-T20II",
   "paper_size": "Mm80",
   "options": {
-    "cut_paper": true,
-    "beep": false,
-    "open_cash_drawer": false
+    "code_page": 0,
+    "encode": ENCODE.ACCENT_REMOVER,
+    "use_gbk": false,
   },
   "sections": [
     {"Title": {"text": "CONCIERTO 2025", "styles": {"bold": true, "underline": false, "align": "center", "italic": false, "invert": false, "font": "A", "rotate": false, "upside_down": false, "size": "Double"}}},
@@ -1561,9 +1538,9 @@ const paymentReceipt: PrintJobRequest = {
   "printer": "TM-T20II",
   "paper_size": "Mm80",
   "options": {
-    "cut_paper": true,
-    "beep": false,
-    "open_cash_drawer": false
+    "code_page": 0,
+    "encode": ENCODE.ACCENT_REMOVER,
+    "use_gbk": false,
   },
   "sections": [
     {"Title": {"text": "COMPROBANTE DE PAGO", "styles": {"bold": true, "underline": false, "align": "center", "italic": false, "invert": false, "font": "A", "rotate": false, "upside_down": false, "size": "Double"}}},

package/dist-js/index.d.ts

@@ -10,7 +10,7 @@ export declare function getPaperSizePixelsWidth(paperSize: PaperSize): number;
 /**
  * ESC/POS page selection plus explicit host-side encoding behavior.
  *
- * - `codepage` controls the `ESC t n` command sent to the printer.
+ * - `code_page` controls the `ESC t n` command sent to the printer. Default is 0.
  * - `encode` selects the host-side encoding and defaults to
  *   `ENCODE.ACCENT_REMOVER`.
  * - `use_gbk` controls whether unmapped non-ASCII characters may fall back
@@ -92,16 +92,6 @@ export declare const CUT_MODE: {
     readonly FULL: CutMode;
     readonly PARTIAL: CutMode;
 };
-export interface PrinterOptions {
-    /** Append a tail `Cut` section with mode `"partial"` and feed `0`. */
-    cut_paper: boolean;
-    /** Append a tail `Beep` section with times `1` and duration `3`. */
-    beep: boolean;
-    /** Append a tail `Drawer` section with pin `2` and pulse time `100`. */
-    open_cash_drawer: boolean;
-    /** Required ESC/POS page plus host-side encoding strategy. */
-    code_page: CodePage;
-}
 export interface GlobalStyles {
     bold?: boolean;
     underline?: boolean;
@@ -240,7 +230,7 @@ export type PrintSections = {
 export interface PrintJobRequest {
     printer: string;
     sections: PrintSections[];
-    options: PrinterOptions;
+    options: CodePage;
     paper_size: PaperSize;
 }
 export interface PrinterInfo {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tauri-plugin-thermal-printer",
-  "version": "1.3.3",
+  "version": "2.0.0",
   "author": "luis3132",
   "description": "Plugin for Tauri to send esc/pos commands to thermal_printer",
   "type": "module",