tauri-plugin-thermal-printer 1.3.2 → 1.3.3

package/README.md

@@ -90,7 +90,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 and USB printer discovery and printing
+- **Android**: Kotlin plugin with Bluetooth SPP, USB, and Network (TCP/IP) printer discovery and printing
 
 ### Workflow
 
@@ -106,8 +106,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 MAC address
-4. **Bluetooth SPP** connection is established to the printer
+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**
 5. **Thermal Printer** interprets ESC/POS commands and prints
 
 #### Print Structure Example:
@@ -150,18 +150,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 and USB printer discovery and printing
+- ✅ **Android**: Bluetooth, USB, and Network printer discovery and printing
 - ❌ **iOS**: Not implemented
 
 ### Supported Connections
 
 | Connection | Linux | macOS | Windows | Android |
 | ---------- | ----- | ----- | ------- | ------- |
-| USB        | ✅    | ✅    | ✅      | ✅ (discovery only) |
-| Network    | ✅    | ✅    | ✅      | ❌      |
+| USB        | ✅    | ✅    | ✅      | ✅      |
+| Network    | ✅    | ✅    | ✅      | ✅      |
 | Bluetooth  | ❌    | ❌    | ❌      | ✅      |
 
-> **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.
+> **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.
 
 ## Installation
 
@@ -391,12 +391,14 @@ 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 | Cut paper after printing (default: `true`) |
-| `options.beep` | boolean | ❌ No | Beep after printing (default: `false`) |
-| `options.open_cash_drawer` | boolean | ❌ No | Open cash drawer after printing (default: `false`) |
+| `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) |
 | `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 |
@@ -1144,7 +1146,7 @@ await print_thermal_printer(job);
 
 This section contains practical examples for different use cases. Each example demonstrates how to structure print jobs for various business scenarios.
 
-> **NOTE:** Paper is automatically cut at the end of printing with a full cut. You don't need to add a `Cut` section manually unless you want a specific partial cut.
+> **NOTE:** With default options, a tail `Cut` section is appended automatically as `{ "Cut": { "mode": "partial", "feed": 0 } }`. Add your own `Cut` section when you need an extra cut or different parameters.
 
 ### 🛒 Long Receipt (Supermarket - 80mm)
 
@@ -1625,5 +1627,6 @@ const paymentReceipt: PrintJobRequest = {
 - No need to manually reset styles
 
 #### Paper Cutting
-- **Automatic**: Paper is automatically cut at the end with a full cut
-- **Manual** (optional): Add a `Cut` section if you need a specific partial cut
+- **Automatic**: `options.cut_paper = true` appends a tail `Cut` section with `mode: "partial"` and `feed: 0`
+- **Manual**: Add a `Cut` section anywhere in `sections` to issue explicit cut commands
+- **Combined**: Automatic and manual cuts are both emitted when both are present

package/dist-js/index.d.ts

@@ -93,8 +93,11 @@ export declare const CUT_MODE: {
     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;

package/package.json

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