@naphatjm/cdh-thermal-printer 1.0.1 → 1.0.3

package/README.md

@@ -109,9 +109,66 @@ printer
     .print(printers[0]);
 ```
 
+### Convert Thai Text to Image (Client-side Helper)
+
+For **server-side printing** with Thai text, use the `textToImageData()` utility function to render text on the client, then send the image data to your server API.
+
+#### Client-side (React/Next.js):
+
+```javascript
+import { textToImageData } from "@naphatjm/cdh-thermal-printer";
+
+// Convert Thai text to image data
+const imageData = textToImageData("สวัสดีครับ", 384, 22);
+
+// Send image data to server API
+const response = await fetch("/api/print", {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({
+        imageData: {
+            data: Array.from(imageData.data),
+            width: imageData.width,
+            height: imageData.height,
+        },
+        printerName: "EPSON TM-58",
+    }),
+});
+```
+
+#### Server-side (Next.js API Route):
+
+```javascript
+// pages/api/print.js
+import { ThermalPrinter } from "@naphatjm/cdh-thermal-printer";
+
+export default function handler(req, res) {
+    if (req.method !== "POST") return res.status(405).end();
+
+    const { imageData, printerName } = req.body;
+
+    // Convert JSON data back to ImageDataLike object
+    const imageDataLike = {
+        data: new Uint8ClampedArray(imageData.data),
+        width: imageData.width,
+        height: imageData.height,
+    };
+
+    // Print using server-side library
+    const printer = new ThermalPrinter();
+    try {
+        printer.init().image(imageDataLike).feed(3).cut().print(printerName);
+
+        res.status(200).json({ message: "✅ Print successful" });
+    } catch (error) {
+        res.status(500).json({ error: error.message });
+    }
+}
+```
+
 ## ⚠️ Important: Font Setup for Thai Text
 
-When using `printThaiText()`, you **must** load the Sarabun font in your HTML file:
+When using `printThaiText()` or `textToImageData()`, you **must** load the Sarabun font in your HTML file:
 
 ```html
 <link
@@ -132,6 +189,28 @@ new ThermalPrinter((driverApiUrl = "http://localhost:9123"), (width = 384));
 - `driverApiUrl`: URL of the thermal printer driver API
 - `width`: Printer width in dots (384 = 58mm, 576 = 80mm)
 
+### Utility Functions
+
+#### `textToImageData(text, width, fontSize)`
+
+Converts Thai text to ImageData for use with `image()` method or server-side printing.
+
+**Parameters:**
+
+- `text` (string) - Thai text to convert
+- `width` (number, default: 384) - Canvas width in pixels
+- `fontSize` (number, default: 22) - Font size in pixels
+
+**Returns:** ImageData object
+
+**Example:**
+
+```javascript
+const imageData = textToImageData("สวัสดี", 384, 22);
+// Use with image() method
+printer.image(imageData).print();
+```
+
 ### Instance Methods
 
 #### Text & Formatting
@@ -152,8 +231,8 @@ new ThermalPrinter((driverApiUrl = "http://localhost:9123"), (width = 384));
 
 #### Image & Printing
 
-- `image(imageData)` - Print image from canvas ImageData
-- `printThaiText(text, fontSize)` - Print Thai text with automatic image rendering (default fontSize: 22px)
+- `image(imageData)` - Print image from canvas ImageData or ImageDataLike object
+- `printThaiText(text, fontSize)` - Print Thai text with automatic image rendering (client-side only, default fontSize: 22px)
 - `raw(bytes)` - Send raw byte array
 
 #### Buffer Management
@@ -189,12 +268,42 @@ printer
     .cut();
 ```
 
-## Requirements
+## Usage Patterns
 
-- Modern browser with Canvas API support
-- Active connection to thermal printer driver API (default: http://localhost:9123)
-- Sarabun font loaded for Thai text rendering
+### Pattern 1: Client-side Direct Printing
+
+```javascript
+// Simple, all processing on client
+printer.init().printThaiText("สวัสดี").feed(2).cut().print("Printer Name");
+```
+
+### Pattern 2: Client Render → Server Print (Recommended for production)
 
-## License
+```javascript
+// 1. Client renders
+const imageData = textToImageData("สวัสดี", 384, 22);
+
+// 2. Send to server
+await fetch("/api/print", { body: JSON.stringify(imageData) });
 
-MIT
+// 3. Server prints (more secure & flexible)
+printer.image(imageDataLike).print("Printer Name");
+```
+
+### Pattern 3: Custom Image Printing
+
+```javascript
+// Use with QR codes, logos, or custom images
+const canvas = document.createElement("canvas");
+const ctx = canvas.getContext("2d");
+// ... draw custom content ...
+const imageData = ctx.getImageData(0, 0, 384, 200);
+
+printer.image(imageData).print("Printer Name");
+```
+
+## Requirements
+
+- Modern browser with Canvas API support (for `printThaiText()` and `textToImageData()`)
+- Active connection to thermal printer driver API (default: http://localhost:9123)
+- Sarabun font loaded in HTML for Thai text rendering

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@naphatjm/cdh-thermal-printer",
-    "version": "1.0.1",
+    "version": "1.0.3",
     "description": "Thai Thermal Printer Library via Local Driver",
     "type": "module",
     "files": [
@@ -8,10 +8,12 @@
     ],
     "main": "./dist/thermal-printer.umd.js",
     "module": "./dist/thermal-printer.es.js",
+    "types": "./dist/index.d.ts",
     "exports": {
         ".": {
             "import": "./dist/thermal-printer.es.js",
-            "require": "./dist/thermal-printer.umd.js"
+            "require": "./dist/thermal-printer.umd.js",
+            "types": "./dist/index.d.ts"
         }
     },
     "scripts": {