@sincpro/printer-expo 1.0.4 → 1.0.6

package/README.md

@@ -8,10 +8,10 @@ A powerful React Native module for controlling thermal printers in Expo applicat
 
 ## ✨ Features
 
-- 🔗 **Bluetooth Connectivity**: Full device discovery and connection management
-- 📱 **Permission Management**: Smart handling of Android Bluetooth permissions
-- 🖨️ **Advanced Printing**: Receipt printing with flexible line types
-- 📋 **QR Code Support**: Print QR codes with customizable sizes
+- 🔗 **Multiple Connectivity**: Bluetooth, WiFi, and USB support
+- 🖨️ **Advanced Printing**: Text, QR codes, barcodes, images, and PDFs
+- 📋 **Structured Receipts**: Header/body/footer with flexible line types
+- ⚙️ **Configurable**: Margins, density, speed, orientation, auto-cutter
 - 🏗️ **Clean Architecture**: SOLID principles, testable, swappable adapters
 - 📚 **Official SDK**: Integration with Bixolon SDK (extensible to other brands)
 - 📝 **TypeScript**: 100% type-safe API with comprehensive definitions
@@ -26,6 +26,12 @@ npm install @sincpro/printer-expo
 yarn add @sincpro/printer-expo
 ```
 
+### Requirements
+
+- **Expo SDK**: `>=52.0.0`
+- **React Native**: Compatible with Expo SDK
+- **Platform**: Android (iOS not currently supported)
+
 ### Post-Installation
 
 ```bash
@@ -59,84 +65,79 @@ The module requires Bluetooth permissions. Add to your `app.json`:
 }
 ```
 
-**Note**: The module automatically handles runtime permission requests on Android 12+.
-
-````
+**Note**: These permissions are required for Bluetooth device discovery and connection on Android 12+.
 
 ## 🚀 Quick Start
 
 ### Basic Example
 
 ```typescript
-import Printer, { BluetoothDevice } from '@sincpro/printer-expo';
-
-// 1. Check Bluetooth status
-const isEnabled = await Printer.bluetooth.isEnabled();
-const isSupported = await Printer.bluetooth.isSupported();
+import { bluetooth, connection, config, print } from '@sincpro/printer-expo';
 
-// 2. Check permissions
-const permStatus = Printer.permission.getStatus();
-if (!permStatus.allGranted) {
-  console.log('Missing permissions:', permStatus.deniedPermissions);
-}
-
-// 3. Get paired devices
-const devices = await Printer.bluetooth.getPairedDevices();
+// 1. Get paired devices
+const devices = bluetooth.getPairedDevices();
 const printers = devices.filter(d => d.isPrinter);
 
-// 4. Connect to printer
-await Printer.connection.connect(printers[0].address);
+// 2. Connect to printer via Bluetooth
+await connection.connectBluetooth(printers[0].address, 30000); // 30s timeout
+
+// 3. Optional: Configure printer
+await config.set({
+  marginLeft: 10,
+  marginTop: 5,
+  density: 'dark',
+  speed: 'medium',
+  orientation: 'top_to_bottom',
+  autoCutter: { enabled: true, fullCut: true }
+});
 
-// 5. Print receipt
-await Printer.print.receipt({
+// 4. Print a simple text
+await print.text('Hello World!', {
+  fontSize: 'large',
+  alignment: 'center',
+  bold: true,
+  media: { preset: 'continuous80mm' }
+});
+
+// 5. Print a complete receipt
+await print.receipt({
   header: [
     { type: 'text', content: 'MY STORE', fontSize: 'large', alignment: 'center', bold: true },
+    { type: 'text', content: '123 Main Street', alignment: 'center' },
     { type: 'separator' },
   ],
-  details: [
-    { type: 'keyValue', key: 'Product', value: '$10.00' },
-    { type: 'keyValue', key: 'Tax', value: '$1.00' },
+  body: [
+    { type: 'keyValue', key: 'Product 1', value: '$10.00' },
+    { type: 'keyValue', key: 'Product 2', value: '$15.00' },
+    { type: 'separator' },
+    { type: 'keyValue', key: 'TOTAL', value: '$25.00', bold: true },
   ],
   footer: [
-    { type: 'separator' },
-    { type: 'keyValue', key: 'TOTAL', value: '$11.00', bold: true },
+    { type: 'qr', data: 'https://mystore.com/receipt/123', alignment: 'center' },
+    { type: 'text', content: 'Thank you!', alignment: 'center' },
     { type: 'space', lines: 2 },
-  ],
-});
-````
+  ]
+}, { media: { preset: 'continuous80mm' } });
+
+// 6. Disconnect
+await connection.disconnect();
+```
 
 ### Complete React Component
 
 ```typescript
-import React, { useState, useEffect } from 'react';
+import React, { useState } from 'react';
 import { View, Button, FlatList, Text, Alert } from 'react-native';
-import Printer, { BluetoothDevice } from '@sincpro/printer-expo';
+import { bluetooth, connection, print } from '@sincpro/printer-expo';
+import type { BluetoothDevice } from '@sincpro/printer-expo';
 
 export default function PrinterScreen() {
   const [devices, setDevices] = useState<BluetoothDevice[]>([]);
   const [connected, setConnected] = useState(false);
 
-  useEffect(() => {
-    checkPermissions();
-  }, []);
-
-  const checkPermissions = () => {
-    const status = Printer.permission.getStatus();
-
-    if (!status.allGranted) {
-      Alert.alert('Permissions Required', `Missing: ${status.deniedPermissions.join(', ')}`);
-    }
-  };
-
   const scanDevices = async () => {
     try {
-      const isEnabled = await Printer.bluetooth.isEnabled();
-      if (!isEnabled) {
-        Alert.alert('Error', 'Please enable Bluetooth');
-        return;
-      }
-
-      const foundDevices = await Printer.bluetooth.getPairedDevices();
+      const foundDevices = bluetooth.getPairedDevices();
       setDevices(foundDevices.filter((d) => d.isPrinter));
     } catch (error) {
       Alert.alert('Error', error.message);
@@ -145,7 +146,7 @@ export default function PrinterScreen() {
 
   const connectDevice = async (device: BluetoothDevice) => {
     try {
-      await Printer.connection.connect(device.address);
+      await connection.connectBluetooth(device.address, 30000);
       setConnected(true);
       Alert.alert('Success', `Connected to ${device.name}`);
     } catch (error) {
@@ -155,12 +156,12 @@ export default function PrinterScreen() {
 
   const printTest = async () => {
     try {
-      await Printer.print.receipt({
+      await print.receipt({
         header: [
           { type: 'text', content: 'Test Receipt', fontSize: 'large', alignment: 'center' },
           { type: 'separator' },
         ],
-        details: [{ type: 'text', content: 'This is a test print' }],
+        body: [{ type: 'text', content: 'This is a test print' }],
         footer: [{ type: 'space', lines: 2 }],
       });
       Alert.alert('Success', 'Receipt printed');
@@ -186,461 +187,313 @@ export default function PrinterScreen() {
 }
 ```
 
-````
-
-## 📱 Detailed Usage
-
-### Bluetooth Device Discovery
-
-```typescript
-// Check Bluetooth permissions
-const checkPermissions = async () => {
-  const permissions = await BixolonPrinter.checkBluetoothPermissions();
-  console.log('Permissions:', permissions);
-
-  // Check if all required permissions are granted
-  const allGranted = Object.values(permissions).every((granted) => granted);
-  if (!allGranted) {
-    await requestPermissions();
-  }
-};
-
-// Request permissions if needed
-const requestPermissions = async () => {
-  try {
-    const granted = await BixolonPrinter.requestBluetoothPermissions();
-    if (granted) {
-      console.log('✅ All permissions granted');
-    } else {
-      console.log('❌ Some permissions were denied');
-    }
-  } catch (error) {
-    console.error('Permission request failed:', error);
-  }
-};
-
-// Discover Bluetooth devices
-const discoverDevices = async () => {
-  try {
-    // Check if Bluetooth is enabled
-    const isEnabled = await BixolonPrinter.isBluetoothEnabled();
-    if (!isEnabled) {
-      Alert.alert('Error', 'Please enable Bluetooth first');
-      return;
-    }
+---
 
-    // Start discovery
-    await BixolonPrinter.startBluetoothDiscovery();
+## 📚 API Reference
 
-    // Get paired devices
-    const devices = await BixolonPrinter.discoverBluetoothDevices();
-    console.log('Found devices:', devices);
+### Connectivity API
 
-    // Filter for printer devices
-    const printers = devices.filter((device) => device.isPrinter);
-    console.log('Printer devices:', printers);
-  } catch (error) {
-    console.error('Device discovery failed:', error);
-  } finally {
-    // Stop discovery
-    await BixolonPrinter.stopBluetoothDiscovery();
-  }
-};
-````
+#### `bluetooth.getPairedDevices(): BluetoothDevice[]`
 
-### Connecting to a Printer
+Get all paired/bonded Bluetooth devices (synchronous).
 
 ```typescript
-// Connect to a Bluetooth device
-const connectToDevice = async (device: BluetoothDevice) => {
-  try {
-    console.log(`Connecting to ${device.name} (${device.address})...`);
-
-    const success = await BixolonPrinter.connectPrinter(
-      'BLUETOOTH', // Interface type
-      device.address, // Device MAC address
-      1 // Port (usually 1 for Bluetooth)
-    );
+import { bluetooth } from '@sincpro/printer-expo';
 
-    if (success) {
-      console.log('✅ Connected to printer successfully');
-      setIsConnected(true);
-    } else {
-      console.log('❌ Connection failed');
-    }
-  } catch (error) {
-    console.error('Connection error:', error);
-    Alert.alert('Connection Failed', error.message);
-  }
-};
-
-// Connect via WiFi (if supported)
-const connectViaWiFi = async (ipAddress: string, port: number = 9100) => {
-  try {
-    const success = await BixolonPrinter.connectPrinter('WIFI', ipAddress, port);
-
-    if (success) {
-      console.log('✅ Connected via WiFi');
-    }
-  } catch (error) {
-    console.error('WiFi connection failed:', error);
-  }
-};
+const devices = bluetooth.getPairedDevices();
+const printers = devices.filter(d => d.isPrinter);
 ```
 
-### Advanced Printing
-
-```typescript
-// Print formatted text with custom formatting
-const printFormattedText = async () => {
-  try {
-    const text = `COMPANY NAME
-123 Main Street
-City, State 12345
-
-Invoice #: INV-001
-Date: ${new Date().toLocaleDateString()}
-Customer: John Doe
+#### `bluetooth.getPairedPrinters(): PairedPrinter[]`
 
-Items:
-- Product A    $10.00
-- Product B    $15.00
-- Product C    $25.00
+Get only paired devices that are printers (synchronous).
 
-Total: $50.00
-
-Thank you for your business!`;
-
-    const success = await BixolonPrinter.printFormattedText(text, 10);
-    if (success) {
-      console.log('✅ Formatted text printed');
-    }
-  } catch (error) {
-    console.error('Print error:', error);
-  }
-};
+```typescript
+const printers = bluetooth.getPairedPrinters();
+console.log(printers); // [{ name: 'SPP-R200III', address: '00:11:22:AA:BB:CC' }]
+```
 
-// Print text in pages (for long content)
-const printLongText = async () => {
-  try {
-    const longText = `This is a very long text that will be split into multiple pages for better printing on thermal printers...`;
+---
 
-    const success = await BixolonPrinter.printTextInPages(longText);
-    if (success) {
-      console.log('✅ Long text printed in pages');
-    }
-  } catch (error) {
-    console.error('Page printing error:', error);
-  }
-};
+#### `connection.connectBluetooth(address: string, timeoutMs?: number): Promise<void>`
 
-// Print a complete invoice
-const printInvoice = async () => {
-  try {
-    const items = [
-      { description: 'Premium Coffee', quantity: 2, price: 4.5 },
-      { description: 'Chocolate Croissant', quantity: 1, price: 3.25 },
-      { description: 'Fresh Orange Juice', quantity: 1, price: 2.75 },
-    ];
-
-    const success = await BixolonPrinter.printInvoice(
-      'Jane Smith', // Customer name
-      items, // Items array
-      15.0 // Total amount
-    );
-
-    if (success) {
-      console.log('✅ Invoice printed successfully');
-    }
-  } catch (error) {
-    console.error('Invoice printing error:', error);
-  }
-};
-```
+Connect to a printer via Bluetooth.
 
-### Disconnecting and Cleanup
+**Parameters:**
+- `address`: MAC address of the printer (e.g., `"00:11:22:AA:BB:CC"`)
+- `timeoutMs`: Connection timeout in milliseconds (default: `10000`)
 
 ```typescript
-// Disconnect from printer
-const disconnect = async () => {
-  try {
-    const success = await BixolonPrinter.disconnectPrinter();
-    if (success) {
-      console.log('✅ Disconnected from printer');
-      setIsConnected(false);
-    }
-  } catch (error) {
-    console.error('Disconnection error:', error);
-  }
-};
+import { connection } from '@sincpro/printer-expo';
 
-// Cleanup on component unmount
-useEffect(() => {
-  return () => {
-    if (isConnected) {
-      disconnect();
-    }
-  };
-}, [isConnected]);
+await connection.connectBluetooth('00:11:22:AA:BB:CC', 30000);
 ```
 
-## 📋 Local Installation Guide
-
-### Creating a Local Package
+#### `connection.connectWifi(ip: string, port?: number, timeoutMs?: number): Promise<void>`
 
-If you want to distribute the module locally without publishing to NPM:
+Connect to a printer via WiFi.
 
-```bash
-# 1. Build the module
-cd /path/to/expo-bixolon
-npm run build
-
-# 2. Create a tarball
-npm pack
+**Parameters:**
+- `ip`: IP address (e.g., `"192.168.1.100"`)
+- `port`: TCP port (default: `9100`)
+- `timeoutMs`: Connection timeout in milliseconds (default: `10000`)
 
-# This creates: expo-bixolon-0.1.0.tgz
+```typescript
+await connection.connectWifi('192.168.1.100', 9100, 30000);
 ```
 
-### Installing in Another Project
+#### `connection.connectUsb(): Promise<void>`
 
-```bash
-# Method 1: Direct tarball installation
-cd /path/to/your-app
-npm install /path/to/expo-bixolon-0.1.0.tgz
-
-# Method 2: Using file path
-npm install /absolute/path/to/expo-bixolon
+Connect to a printer via USB.
 
-# Method 3: Using yarn
-yarn add /path/to/expo-bixolon-0.1.0.tgz
+```typescript
+await connection.connectUsb();
 ```
 
-### Post-Installation Steps
+#### `connection.disconnect(): Promise<void>`
 
-```bash
-# Install native dependencies
-npx expo install
-
-# Generate native code
-npx expo prebuild
+Disconnect from the current printer.
 
-# Run the app
-npx expo run:android
-# or
-npx expo run:ios
+```typescript
+await connection.disconnect();
 ```
 
-## 📚 API Reference
-
-### Namespaces
+#### `connection.isConnected(): boolean`
 
-The API is organized into four main namespaces:
+Check if currently connected (synchronous).
 
 ```typescript
-import Printer from '@sincpro/printer-expo';
-
-Printer.bluetooth; // Bluetooth operations
-Printer.permission; // Permission management
-Printer.connection; // Connection control
-Printer.print; // Printing operations
+const connected = connection.isConnected();
 ```
 
----
-
-### Bluetooth API
+#### `connection.getStatus(): Promise<PrinterStatus>`
 
-#### `bluetooth.isEnabled(): Promise<boolean>`
-
-Check if Bluetooth is enabled on the device.
+Get current printer status (paper, cover, errors).
 
 ```typescript
-const enabled = await Printer.bluetooth.isEnabled();
+const status = await connection.getStatus();
+console.log('Connection:', status.connectionState); // 'CONNECTED' | 'CONNECTING' | 'DISCONNECTED' | 'ERROR'
+console.log('Has paper:', status.hasPaper);
+console.log('Cover open:', status.isCoverOpen);
+console.log('Error:', status.errorMessage);
 ```
 
-#### `bluetooth.isSupported(): Promise<boolean>`
+#### `connection.getInfo(): Promise<PrinterInfo>`
 
-Check if Bluetooth is supported on the device.
+Get printer information (model, firmware, serial).
 
 ```typescript
-const supported = await Printer.bluetooth.isSupported();
+const info = await connection.getInfo();
+console.log('Model:', info.model);
+console.log('Firmware:', info.firmware);
+console.log('Serial:', info.serial);
+console.log('DPI:', info.dpi);
 ```
 
-#### `bluetooth.getPairedDevices(): Promise<BluetoothDevice[]>`
+#### `connection.getDpi(): number`
 
-Get list of paired/bonded Bluetooth devices.
+Get printer DPI (synchronous).
 
 ```typescript
-const devices = await Printer.bluetooth.getPairedDevices();
-const printers = devices.filter((d) => d.isPrinter);
+const dpi = connection.getDpi(); // e.g., 203 or 300
 ```
 
-#### `bluetooth.startDiscovery(): Promise<boolean>`
+---
+
+### Configuration API
 
-Start Bluetooth discovery to find nearby devices.
+#### `config.set(printerConfig: PrinterConfig): Promise<void>`
+
+Set printer configuration (margins, density, speed, orientation, cutter). This sets the default config and applies it immediately if connected.
 
 ```typescript
-await Printer.bluetooth.startDiscovery();
+import { config } from '@sincpro/printer-expo';
+
+await config.set({
+  marginLeft: 10,       // Left margin in dots
+  marginTop: 5,         // Top margin in dots
+  density: 'dark',      // 'light' | 'medium' | 'dark' | 'extra_dark'
+  speed: 'medium',      // 'slow' | 'medium' | 'fast' | 'extra_fast'
+  orientation: 'top_to_bottom', // 'top_to_bottom' | 'bottom_to_top'
+  autoCutter: {
+    enabled: true,
+    fullCut: true       // true = full cut, false = partial cut
+  }
+});
 ```
 
-#### `bluetooth.stopDiscovery(): Promise<boolean>`
+#### `config.get(): PrinterConfig`
 
-Stop Bluetooth discovery.
+Get current printer configuration (synchronous).
 
 ```typescript
-await Printer.bluetooth.stopDiscovery();
+const currentConfig = config.get();
+console.log('Density:', currentConfig.density);
+console.log('Speed:', currentConfig.speed);
 ```
 
 ---
 
-### Permission API
+### Print API
+
+#### `print.text(text: string, options?: PrintTextOptions): Promise<void>`
 
-#### `permission.hasBluetoothPermissions(): boolean`
+Print a single line of text.
 
-Check if all required Bluetooth permissions are granted (synchronous).
+**Options:**
+- `fontSize`: `'small'` | `'medium'` | `'large'` | `'xlarge'`
+- `alignment`: `'left'` | `'center'` | `'right'`
+- `bold`: `boolean`
+- `media`: `MediaConfig`
 
 ```typescript
-const hasAll = Printer.permission.hasBluetoothPermissions();
+import { print } from '@sincpro/printer-expo';
+
+await print.text('Hello World!', {
+  fontSize: 'large',
+  alignment: 'center',
+  bold: true,
+  media: { preset: 'continuous80mm' }
+});
 ```
 
-#### `permission.getRequiredPermissions(): string[]`
+#### `print.texts(texts: string[], options?: PrintTextsOptions): Promise<void>`
 
-Get list of required permissions for the current Android version.
+Print multiple lines of text.
 
 ```typescript
-const required = Printer.permission.getRequiredPermissions();
-// Returns: ['android.permission.BLUETOOTH_SCAN', 'android.permission.BLUETOOTH_CONNECT', ...]
+await print.texts(
+  ['Line 1', 'Line 2', 'Line 3'],
+  { fontSize: 'medium', media: { preset: 'continuous80mm' } }
+);
 ```
 
-#### `permission.getMissingPermissions(): string[]`
+#### `print.qr(data: string, options?: PrintQROptions): Promise<void>`
+
+Print a QR code.
 
-Get list of missing/denied permissions.
+**Options:**
+- `size`: QR size 1-10 (default: `5`)
+- `alignment`: `'left'` | `'center'` | `'right'`
+- `media`: `MediaConfig`
 
 ```typescript
-const missing = Printer.permission.getMissingPermissions();
-console.log('Need to request:', missing);
+await print.qr('https://sincpro.com', {
+  size: 8,
+  alignment: 'center',
+  media: { preset: 'continuous80mm' }
+});
 ```
 
-#### `permission.getStatus(): PermissionStatus`
+#### `print.barcode(data: string, options?: PrintBarcodeOptions): Promise<void>`
 
-Get detailed permission status.
+Print a barcode.
+
+**Options:**
+- `type`: `'CODE128'` | `'CODE39'` | `'EAN13'` | `'EAN8'` | `'UPCA'` | `'UPCE'` | `'CODE93'` | `'CODABAR'`
+- `height`: Barcode height in dots
+- `alignment`: `'left'` | `'center'` | `'right'`
+- `media`: `MediaConfig`
 
 ```typescript
-const status = Printer.permission.getStatus();
-console.log('All granted:', status.allGranted);
-console.log('Granted:', status.grantedPermissions);
-console.log('Denied:', status.deniedPermissions);
-console.log('Android version:', status.androidVersion);
+await print.barcode('123456789012', {
+  type: 'CODE128',
+  height: 80,
+  alignment: 'center',
+  media: { preset: 'continuous80mm' }
+});
 ```
 
----
+#### `print.imageBase64(base64Data: string, options?: PrintImageOptions): Promise<void>`
 
-### Connection API
+Print an image from base64 data.
 
-#### `connection.connect(address: string, port?: number): Promise<boolean>`
-
-Connect to a printer via Bluetooth.
-
-**Parameters:**
-
-- `address`: MAC address of the printer (e.g., `"00:11:22:AA:BB:CC"`)
-- `port`: TCP port (default: `9100`)
+**Options:**
+- `alignment`: `'left'` | `'center'` | `'right'`
+- `media`: `MediaConfig`
 
 ```typescript
-await Printer.connection.connect('00:11:22:AA:BB:CC');
+await print.imageBase64(base64ImageData, {
+  alignment: 'center',
+  media: { preset: 'continuous80mm' }
+});
 ```
 
-#### `connection.disconnect(): Promise<boolean>`
+#### `print.pdfBase64(base64Data: string, options?: PrintPdfOptions): Promise<void>`
 
-Disconnect from the current printer.
+Print a PDF page from base64 data.
+
+**Options:**
+- `page`: Page number to print (default: `0`)
+- `alignment`: `'left'` | `'center'` | `'right'`
+- `media`: `MediaConfig`
 
 ```typescript
-await Printer.connection.disconnect();
+await print.pdfBase64(base64PdfData, {
+  page: 0,
+  alignment: 'center',
+  media: { preset: 'continuous80mm' }
+});
 ```
 
-#### `connection.getStatus(): Promise<ConnectionInfo>`
+#### `print.getPdfPageCount(base64Data: string): number`
 
-Get current connection status and details.
+Get page count from a PDF (synchronous).
 
 ```typescript
-const info = await Printer.connection.getStatus();
-console.log('Address:', info.address);
-console.log('Type:', info.type); // 'BLUETOOTH' | 'WIFI' | 'USB'
-console.log('Status:', info.status); // 'CONNECTED' | 'CONNECTING' | 'DISCONNECTED' | 'ERROR'
+const pageCount = print.getPdfPageCount(base64PdfData);
 ```
 
-#### `connection.isConnected(): boolean`
+#### `print.keyValue(key: string, value: string, options?: PrintKeyValueOptions): Promise<void>`
 
-Check if currently connected (synchronous).
+Print a key-value pair (two columns).
 
 ```typescript
-const connected = Printer.connection.isConnected();
+await print.keyValue('Total', '$25.00', {
+  fontSize: 'large',
+  bold: true,
+  media: { preset: 'continuous80mm' }
+});
 ```
 
----
-
-### Print API
-
-#### `print.receipt(receipt: Receipt): Promise<void>`
+#### `print.receipt(receipt: Receipt, options?: PrintReceiptOptions): Promise<void>`
 
-Print a complete receipt with header, details, and footer sections.
+Print a complete structured receipt with header, body, and footer sections.
 
-**Parameters:**
-
-- `receipt`: Receipt object with sections and configuration
+**Options:**
+- `media`: `MediaConfig`
+- `copies`: Number of copies to print (default: `1`)
 
 ```typescript
-await Printer.print.receipt({
+await print.receipt({
   header: [
-    { type: 'text', content: 'STORE NAME', fontSize: 'large', alignment: 'center', bold: true },
-    { type: 'text', content: '123 Main St', alignment: 'center' },
+    { type: 'text', content: 'MY STORE', fontSize: 'large', alignment: 'center', bold: true },
+    { type: 'text', content: '123 Main Street', alignment: 'center' },
     { type: 'separator' },
   ],
-  details: [
-    { type: 'keyValue', key: 'Product A', value: '$10.00' },
-    { type: 'keyValue', key: 'Product B', value: '$15.00' },
-    { type: 'keyValue', key: 'Tax (10%)', value: '$2.50' },
+  body: [
+    { type: 'keyValue', key: 'Product 1', value: '$10.00' },
+    { type: 'keyValue', key: 'Product 2', value: '$15.00' },
+    { type: 'separator' },
+    { type: 'keyValue', key: 'Tax', value: '$2.50' },
   ],
   footer: [
     { type: 'separator' },
     { type: 'keyValue', key: 'TOTAL', value: '$27.50', bold: true, fontSize: 'large' },
-    { type: 'qrCode', data: 'https://mystore.com/receipt/12345', size: 5, alignment: 'center' },
+    { type: 'qr', data: 'https://mystore.com/receipt/123', alignment: 'center', size: 6 },
+    { type: 'text', content: 'Thank you for your purchase!', alignment: 'center' },
     { type: 'space', lines: 2 },
-  ],
-  copies: 1,
-});
-```
-
-#### `print.lines(lines: ReceiptLine[]): Promise<void>`
-
-Print a list of receipt lines without sections.
-
-```typescript
-await Printer.print.lines([
-  { type: 'text', content: 'Quick Receipt', alignment: 'center' },
-  { type: 'separator' },
-  { type: 'keyValue', key: 'Item', value: '$5.00' },
-  { type: 'space', lines: 1 },
-]);
-```
-
-#### `print.qrCode(data: string, size?: number): Promise<void>`
-
-Print a standalone QR code.
-
-**Parameters:**
-
-- `data`: QR code content (URL, text, etc.)
-- `size`: QR code size 1-10 (default: `5`)
-
-```typescript
-await Printer.print.qrCode('https://example.com', 7);
+  ]
+}, { media: { preset: 'continuous80mm' }, copies: 1 });
 ```
 
 ---
 
-## 🎨 Receipt Line Types
+### Receipt Line Types
 
-### TextLine
+Receipt lines are the building blocks of structured receipts. Each line type has specific properties.
+
+#### `TextLine`
 
 Print formatted text with customizable style.
 
@@ -655,87 +508,203 @@ Print formatted text with customizable style.
 ```
 
 **Example:**
-
 ```typescript
 { type: 'text', content: 'INVOICE', fontSize: 'xlarge', alignment: 'center', bold: true }
 ```
 
-### KeyValueLine
+#### `KeyValueLine`
 
-Print key-value pairs (common in receipts).
+Print key-value pairs in two columns (common in receipts).
 
 ```typescript
 {
   type: 'keyValue',
   key: string,
   value: string,
-  fontSize?: FontSize,
+  fontSize?: 'small' | 'medium' | 'large' | 'xlarge',
   bold?: boolean
 }
 ```
 
 **Example:**
-
 ```typescript
 { type: 'keyValue', key: 'Subtotal', value: '$25.00' }
-{ type: 'keyValue', key: 'TOTAL', value: '$27.50', bold: true }
+{ type: 'keyValue', key: 'TOTAL', value: '$27.50', bold: true, fontSize: 'large' }
 ```
 
-### QRCodeLine
+#### `QRLine`
 
 Embed QR codes in receipts.
 
 ```typescript
 {
-  type: 'qrCode',
+  type: 'qr',
+  data: string,
+  size?: number,           // 1-10, default: 5
+  alignment?: 'left' | 'center' | 'right'
+}
+```
+
+**Example:**
+```typescript
+{ type: 'qr', data: 'https://store.com/receipt/12345', size: 6, alignment: 'center' }
+```
+
+#### `BarcodeLine`
+
+Embed barcodes in receipts.
+
+```typescript
+{
+  type: 'barcode',
   data: string,
-  size?: number,       // 1-10, default: 5
-  alignment?: Alignment
+  barcodeType?: 'CODE128' | 'CODE39' | 'EAN13' | 'EAN8' | 'UPCA' | 'UPCE' | 'CODE93' | 'CODABAR',
+  height?: number,
+  alignment?: 'left' | 'center' | 'right'
 }
 ```
 
 **Example:**
+```typescript
+{ type: 'barcode', data: '123456789012', barcodeType: 'EAN13', height: 80, alignment: 'center' }
+```
+
+#### `ImageLine`
 
+Embed images (base64) in receipts.
+
+```typescript
+{
+  type: 'image',
+  base64: string,
+  alignment?: 'left' | 'center' | 'right'
+}
+```
+
+**Example:**
 ```typescript
-{ type: 'qrCode', data: 'https://store.com/receipt/12345', size: 6, alignment: 'center' }
+{ type: 'image', base64: 'iVBORw0KGgoAAAANS...', alignment: 'center' }
 ```
 
-### SeparatorLine
+#### `SeparatorLine`
 
 Print horizontal separator lines.
 
 ```typescript
 {
   type: 'separator',
-  char?: string,  // Character to repeat, default: '-'
-  length?: number // Line length, default: 48
+  char?: string,       // Character to repeat, default: '-'
+  length?: number      // Line length in characters, default: 48
 }
 ```
 
-**Example:**
-
+**Examples:**
 ```typescript
 { type: 'separator' }
 { type: 'separator', char: '=', length: 32 }
 ```
 
-### SpaceLine
+#### `SpaceLine`
 
 Add blank lines for spacing.
 
 ```typescript
 {
   type: 'space',
-  lines?: number  // Number of blank lines, default: 1
+  lines?: number       // Number of blank lines, default: 1
 }
 ```
 
 **Example:**
-
 ```typescript
 { type: 'space', lines: 2 }
 ```
 
+#### `ColumnsLine`
+
+Print multiple columns in one row.
+
+```typescript
+{
+  type: 'columns',
+  columns: Array<{
+    text: string,
+    widthRatio?: number,
+    alignment?: 'left' | 'center' | 'right'
+  }>,
+  fontSize?: 'small' | 'medium' | 'large' | 'xlarge',
+  bold?: boolean
+}
+```
+
+**Example:**
+```typescript
+{
+  type: 'columns',
+  columns: [
+    { text: 'Item', widthRatio: 2, alignment: 'left' },
+    { text: 'Qty', widthRatio: 1, alignment: 'center' },
+    { text: 'Price', widthRatio: 1, alignment: 'right' }
+  ],
+  bold: true
+}
+```
+
+---
+
+### MediaConfig - Paper Configuration
+
+Configure paper/label dimensions for printing. You can use presets or custom configurations.
+
+#### Using Presets
+
+```typescript
+// Continuous paper presets
+{ preset: 'continuous58mm' }  // 58mm continuous paper
+{ preset: 'continuous72mm' }  // 72mm continuous paper
+{ preset: 'continuous80mm' }  // 80mm continuous paper (most common)
+```
+
+#### Custom Configuration (Millimeters)
+
+```typescript
+// Custom continuous paper
+{
+  widthMm: 72,
+  type: 'continuous'
+}
+
+// Labels with gap
+{
+  widthMm: 50,
+  heightMm: 30,
+  gapMm: 3,
+  type: 'gap'
+}
+
+// Labels with black mark
+{
+  widthMm: 60,
+  heightMm: 40,
+  type: 'black_mark'
+}
+```
+
+#### Custom Configuration (Dots)
+
+If you need precise control, you can specify dimensions in dots (based on printer DPI).
+
+```typescript
+{
+  widthDots: 576,   // 72mm at 203 DPI
+  heightDots: 240,  // 30mm at 203 DPI
+  gapDots: 24,      // 3mm at 203 DPI
+  type: 'gap'
+}
+```
+
+**Note:** The module automatically converts millimeters to dots based on the printer's DPI. Using millimeters is recommended for easier configuration.
+
 ---
 
 ## 📦 TypeScript Types
@@ -744,44 +713,58 @@ Add blank lines for spacing.
 
 ```typescript
 interface BluetoothDevice {
-  name: string;
-  address: string;
-  type: 'CLASSIC' | 'LE' | 'DUAL' | 'UNKNOWN';
-  isPrinter: boolean;
+  name: string;            // Device name
+  address: string;         // MAC address (e.g., "00:11:22:AA:BB:CC")
+  isPrinter: boolean;      // True if device is identified as a printer
 }
 ```
 
-### PermissionStatus
+### PairedPrinter
 
 ```typescript
-interface PermissionStatus {
-  allGranted: boolean;
-  grantedPermissions: string[];
-  deniedPermissions: string[];
-  androidVersion: number;
+interface PairedPrinter {
+  name: string;            // Printer name
+  address: string;         // MAC address
 }
 ```
 
-### ConnectionInfo
+### PrinterStatus
 
 ```typescript
-interface ConnectionInfo {
-  address: string;
-  port: number;
-  type: 'BLUETOOTH' | 'WIFI' | 'USB' | 'UNKNOWN';
-  status: 'DISCONNECTED' | 'CONNECTING' | 'CONNECTED' | 'ERROR';
+interface PrinterStatus {
+  connectionState: 'DISCONNECTED' | 'CONNECTING' | 'CONNECTED' | 'ERROR';
+  hasPaper: boolean;       // True if paper is available
+  isCoverOpen: boolean;    // True if printer cover is open
+  isOverheated: boolean;   // True if printer is overheated
+  hasError: boolean;       // True if printer has an error
+  errorMessage: string | null; // Error message if hasError is true
 }
 ```
 
-### Receipt
+### PrinterInfo
 
 ```typescript
-interface Receipt {
-  header?: ReceiptLine[];
-  details?: ReceiptLine[];
-  footer?: ReceiptLine[];
-  mediaConfig?: MediaConfig;
-  copies?: number;
+interface PrinterInfo {
+  model: string;           // Printer model (e.g., "SPP-R200III")
+  firmware: string;        // Firmware version
+  serial: string;          // Serial number
+  dpi: number;             // Printer DPI (e.g., 203 or 300)
+}
+```
+
+### PrinterConfig
+
+```typescript
+interface PrinterConfig {
+  marginLeft?: number;     // Left margin in dots
+  marginTop?: number;      // Top margin in dots
+  density?: 'light' | 'medium' | 'dark' | 'extra_dark';
+  speed?: 'slow' | 'medium' | 'fast' | 'extra_fast';
+  orientation?: 'top_to_bottom' | 'bottom_to_top';
+  autoCutter?: {
+    enabled: boolean;      // Enable auto cutter
+    fullCut?: boolean;     // Full cut (true) or partial cut (false)
+  };
 }
 ```
 
@@ -789,128 +772,283 @@ interface Receipt {
 
 ```typescript
 interface MediaConfig {
-  type: 'continuous' | 'labelGap' | 'labelBlackMark';
-  width: number;
-  height: number;
-  offset?: number;
-  gap?: number;
+  // Use preset for common paper sizes
+  preset?: 'continuous58mm' | 'continuous72mm' | 'continuous80mm';
+  
+  // Or custom configuration in millimeters
+  widthMm?: number;        // Paper width in mm
+  heightMm?: number;       // Label height in mm (for labels)
+  gapMm?: number;          // Gap size in mm (for labels)
+  
+  // Or custom configuration in dots
+  widthDots?: number;      // Paper width in dots
+  heightDots?: number;     // Label height in dots
+  gapDots?: number;        // Gap size in dots
+  
+  // Media type
+  type?: 'continuous' | 'gap' | 'label' | 'black_mark';
+}
+```
+
+### Receipt
+
+```typescript
+interface Receipt {
+  header?: ReceiptLine[];  // Header section (logo, store info)
+  body?: ReceiptLine[];    // Body section (items, details)
+  footer?: ReceiptLine[];  // Footer section (totals, QR, thanks)
 }
 ```
 
+### ReceiptLine Types
+
+```typescript
+type ReceiptLine =
+  | TextLine
+  | KeyValueLine
+  | QRLine
+  | BarcodeLine
+  | ImageLine
+  | SeparatorLine
+  | SpaceLine
+  | ColumnsLine;
+```
+
 ---
 
-## 🎯 Advanced Examples
+## 🎯 Usage Examples
 
-### Complete Receipt with All Line Types
+### Example 1: Basic Connection and Text Printing
 
 ```typescript
-const fullReceipt: Receipt = {
-  header: [
-    {
-      type: 'text',
-      content: '🏪 MY RETAIL STORE',
-      fontSize: 'xlarge',
+import { bluetooth, connection, print } from '@sincpro/printer-expo';
+
+async function basicPrint() {
+  try {
+    // 1. Get paired printers
+    const printers = bluetooth.getPairedPrinters();
+    if (printers.length === 0) {
+      throw new Error('No paired printers found');
+    }
+
+    // 2. Connect to first printer
+    await connection.connectBluetooth(printers[0].address, 30000);
+    console.log('Connected to', printers[0].name);
+
+    // 3. Print simple text
+    await print.text('Hello from Expo!', {
+      fontSize: 'large',
       alignment: 'center',
       bold: true,
-    },
-    { type: 'text', content: '123 Commerce Street', alignment: 'center' },
-    { type: 'text', content: 'Phone: (555) 123-4567', alignment: 'center' },
-    { type: 'separator', char: '=' },
-    { type: 'text', content: 'SALES RECEIPT', fontSize: 'large', alignment: 'center' },
-    { type: 'separator', char: '=' },
-    { type: 'space' },
-  ],
-  details: [
-    { type: 'keyValue', key: 'Date', value: new Date().toLocaleDateString() },
-    { type: 'keyValue', key: 'Receipt #', value: '00123' },
-    { type: 'keyValue', key: 'Cashier', value: 'John Doe' },
-    { type: 'space' },
-    { type: 'separator' },
-    { type: 'text', content: 'ITEMS', bold: true },
-    { type: 'separator' },
-    { type: 'keyValue', key: 'Coffee (x2)', value: '$9.00' },
-    { type: 'keyValue', key: 'Croissant (x1)', value: '$3.50' },
-    { type: 'keyValue', key: 'Orange Juice (x1)', value: '$4.00' },
-    { type: 'space' },
-    { type: 'separator' },
-    { type: 'keyValue', key: 'Subtotal', value: '$16.50' },
-    { type: 'keyValue', key: 'Tax (8%)', value: '$1.32' },
-  ],
-  footer: [
-    { type: 'separator', char: '=' },
-    { type: 'keyValue', key: 'TOTAL', value: '$17.82', fontSize: 'large', bold: true },
-    { type: 'separator', char: '=' },
-    { type: 'space', lines: 2 },
-    { type: 'text', content: 'Thank you for your purchase!', alignment: 'center' },
-    { type: 'text', content: 'Visit us at www.mystore.com', alignment: 'center' },
-    { type: 'space' },
-    { type: 'qrCode', data: 'https://mystore.com/receipt/00123', size: 6, alignment: 'center' },
-    { type: 'space', lines: 3 },
-  ],
-  copies: 1,
-};
+      media: { preset: 'continuous80mm' }
+    });
+
+    // 4. Disconnect
+    await connection.disconnect();
+    console.log('Print complete!');
+  } catch (error) {
+    console.error('Print failed:', error);
+  }
+}
+```
+
+### Example 2: Sales Receipt
+
+```typescript
+import { connection, print } from '@sincpro/printer-expo';
+
+async function printSalesReceipt(items: Array<{ name: string; qty: number; price: number }>) {
+  const subtotal = items.reduce((sum, item) => sum + (item.qty * item.price), 0);
+  const tax = subtotal * 0.08; // 8% tax
+  const total = subtotal + tax;
+
+  await print.receipt({
+    header: [
+      { type: 'text', content: '🏪 MY RETAIL STORE', fontSize: 'xlarge', alignment: 'center', bold: true },
+      { type: 'text', content: '123 Commerce Street', alignment: 'center' },
+      { type: 'text', content: 'Phone: (555) 123-4567', alignment: 'center' },
+      { type: 'separator', char: '=' },
+      { type: 'text', content: 'SALES RECEIPT', fontSize: 'large', alignment: 'center' },
+      { type: 'separator', char: '=' },
+      { type: 'space' },
+      { type: 'keyValue', key: 'Date', value: new Date().toLocaleDateString() },
+      { type: 'keyValue', key: 'Receipt #', value: 'RCP-' + Date.now() },
+      { type: 'space' },
+      { type: 'separator' },
+    ],
+    body: [
+      { type: 'text', content: 'ITEMS', bold: true },
+      { type: 'separator' },
+      ...items.map(item => ({
+        type: 'keyValue' as const,
+        key: `${item.name} (x${item.qty})`,
+        value: `$${(item.qty * item.price).toFixed(2)}`
+      })),
+      { type: 'space' },
+      { type: 'separator' },
+      { type: 'keyValue', key: 'Subtotal', value: `$${subtotal.toFixed(2)}` },
+      { type: 'keyValue', key: 'Tax (8%)', value: `$${tax.toFixed(2)}` },
+    ],
+    footer: [
+      { type: 'separator', char: '=' },
+      { type: 'keyValue', key: 'TOTAL', value: `$${total.toFixed(2)}`, fontSize: 'large', bold: true },
+      { type: 'separator', char: '=' },
+      { type: 'space', lines: 2 },
+      { type: 'text', content: 'Thank you for your purchase!', alignment: 'center' },
+      { type: 'text', content: 'Visit us at www.mystore.com', alignment: 'center' },
+      { type: 'space' },
+      { type: 'qr', data: `https://mystore.com/receipt/${Date.now()}`, size: 6, alignment: 'center' },
+      { type: 'space', lines: 3 },
+    ]
+  }, { media: { preset: 'continuous80mm' } });
+}
+
+// Usage
+printSalesReceipt([
+  { name: 'Coffee', qty: 2, price: 4.50 },
+  { name: 'Croissant', qty: 1, price: 3.25 },
+  { name: 'Orange Juice', qty: 1, price: 2.75 }
+]);
+```
+
+### Example 3: Product Label Printing
 
-await Printer.print.receipt(fullReceipt);
+```typescript
+import { config, print } from '@sincpro/printer-expo';
+
+async function printProductLabel(product: { name: string; sku: string; price: number }) {
+  // Configure for label printing
+  await config.set({
+    marginLeft: 5,
+    marginTop: 5,
+    density: 'dark',
+    speed: 'medium'
+  });
+
+  await print.receipt({
+    header: [
+      { type: 'text', content: product.name, fontSize: 'large', alignment: 'center', bold: true },
+      { type: 'space' },
+    ],
+    body: [
+      { type: 'barcode', data: product.sku, barcodeType: 'CODE128', height: 60, alignment: 'center' },
+      { type: 'space' },
+      { type: 'text', content: `SKU: ${product.sku}`, alignment: 'center' },
+    ],
+    footer: [
+      { type: 'space' },
+      { type: 'text', content: `$${product.price.toFixed(2)}`, fontSize: 'xlarge', alignment: 'center', bold: true },
+    ]
+  }, {
+    media: {
+      widthMm: 50,
+      heightMm: 30,
+      gapMm: 3,
+      type: 'gap'
+    }
+  });
+}
+
+// Usage
+printProductLabel({
+  name: 'Premium Coffee Beans',
+  sku: '1234567890',
+  price: 12.99
+});
 ```
 
-### Error Handling Pattern
+### Example 4: Error Handling Pattern
 
 ```typescript
-const safePrint = async (receipt: Receipt) => {
+import { connection, print } from '@sincpro/printer-expo';
+import type { Receipt } from '@sincpro/printer-expo';
+
+async function safePrint(receipt: Receipt) {
   try {
     // Check connection
-    if (!Printer.connection.isConnected()) {
+    if (!connection.isConnected()) {
       throw new Error('Printer not connected');
     }
 
-    // Check status
-    const status = await Printer.connection.getStatus();
-    if (status.status !== 'CONNECTED') {
-      throw new Error(`Connection ${status.status.toLowerCase()}`);
+    // Check printer status
+    const status = await connection.getStatus();
+    
+    if (status.connectionState !== 'CONNECTED') {
+      throw new Error(`Printer is ${status.connectionState.toLowerCase()}`);
+    }
+    
+    if (!status.hasPaper) {
+      throw new Error('Printer is out of paper');
+    }
+    
+    if (status.isCoverOpen) {
+      throw new Error('Printer cover is open');
+    }
+    
+    if (status.isOverheated) {
+      throw new Error('Printer is overheated');
+    }
+    
+    if (status.hasError) {
+      throw new Error(`Printer error: ${status.errorMessage}`);
     }
 
-    // Print
-    await Printer.print.receipt(receipt);
+    // Print receipt
+    await print.receipt(receipt, { media: { preset: 'continuous80mm' } });
+    
     console.log('✅ Print successful');
+    return { success: true };
   } catch (error) {
-    console.error('❌ Print failed:', error.message);
-
-    // Show user-friendly message
-    Alert.alert('Print Error', error.message || 'Could not print receipt', [{ text: 'OK' }]);
+    console.error('❌ Print failed:', error);
+    
+    // Return user-friendly error
+    return {
+      success: false,
+      error: error instanceof Error ? error.message : 'Unknown error'
+    };
   }
-};
+}
+
+// Usage in React component
+function PrintButton() {
+  const handlePrint = async () => {
+    const result = await safePrint(myReceipt);
+    
+    if (result.success) {
+      Alert.alert('Success', 'Receipt printed successfully');
+    } else {
+      Alert.alert('Print Error', result.error);
+    }
+  };
+
+  return <Button title="Print" onPress={handlePrint} />;
+}
 ```
 
-### Custom Hook for Printer Management
+### Example 5: Custom Hook for Printer Management
 
 ```typescript
 import { useState, useEffect } from 'react';
-import Printer, { BluetoothDevice, ConnectionInfo } from '@sincpro/printer-expo';
+import { bluetooth, connection, print } from '@sincpro/printer-expo';
+import type { BluetoothDevice, PrinterStatus, Receipt } from '@sincpro/printer-expo';
 
 export function usePrinter() {
   const [devices, setDevices] = useState<BluetoothDevice[]>([]);
   const [connected, setConnected] = useState(false);
-  const [connectionInfo, setConnectionInfo] = useState<ConnectionInfo | null>(null);
+  const [status, setStatus] = useState<PrinterStatus | null>(null);
 
   useEffect(() => {
     checkConnection();
   }, []);
 
   const checkConnection = () => {
-    const isConnected = Printer.connection.isConnected();
-    setConnected(isConnected);
+    setConnected(connection.isConnected());
   };
 
-  const scanDevices = async () => {
+  const scanDevices = () => {
     try {
-      const isEnabled = await Printer.bluetooth.isEnabled();
-      if (!isEnabled) {
-        throw new Error('Bluetooth is disabled');
-      }
-
-      const foundDevices = await Printer.bluetooth.getPairedDevices();
-      setDevices(foundDevices.filter((d) => d.isPrinter));
-
+      const foundDevices = bluetooth.getPairedDevices();
+      setDevices(foundDevices.filter(d => d.isPrinter));
       return foundDevices;
     } catch (error) {
       console.error('Scan failed:', error);
@@ -918,14 +1056,14 @@ export function usePrinter() {
     }
   };
 
-  const connect = async (address: string) => {
+  const connect = async (address: string, timeoutMs = 30000) => {
     try {
-      await Printer.connection.connect(address);
+      await connection.connectBluetooth(address, timeoutMs);
       setConnected(true);
-
-      const info = await Printer.connection.getStatus();
-      setConnectionInfo(info);
-
+      
+      const printerStatus = await connection.getStatus();
+      setStatus(printerStatus);
+      
       return true;
     } catch (error) {
       console.error('Connection failed:', error);
@@ -935,9 +1073,9 @@ export function usePrinter() {
 
   const disconnect = async () => {
     try {
-      await Printer.connection.disconnect();
+      await connection.disconnect();
       setConnected(false);
-      setConnectionInfo(null);
+      setStatus(null);
       return true;
     } catch (error) {
       console.error('Disconnection failed:', error);
@@ -950,32 +1088,45 @@ export function usePrinter() {
       throw new Error('Not connected to printer');
     }
 
-    await Printer.print.receipt(receipt);
+    await print.receipt(receipt, { media: { preset: 'continuous80mm' } });
+  };
+
+  const refreshStatus = async () => {
+    if (connected) {
+      const printerStatus = await connection.getStatus();
+      setStatus(printerStatus);
+      return printerStatus;
+    }
+    return null;
   };
 
   return {
     devices,
     connected,
-    connectionInfo,
+    status,
     scanDevices,
     connect,
     disconnect,
     printReceipt,
+    refreshStatus,
   };
 }
 
-// Usage
-function MyComponent() {
+// Usage in component
+function MyPrinterComponent() {
   const printer = usePrinter();
 
   return (
     <View>
-      <Button title="Scan" onPress={printer.scanDevices} />
-      <Button
-        title="Print"
+      <Button title="Scan Printers" onPress={printer.scanDevices} />
+      <Button 
+        title="Print Receipt" 
         onPress={() => printer.printReceipt(myReceipt)}
         disabled={!printer.connected}
       />
+      {printer.status && (
+        <Text>Status: {printer.status.connectionState}</Text>
+      )}
     </View>
   );
 }
@@ -985,106 +1136,276 @@ function MyComponent() {
 
 ## 🏗️ Architecture
 
-This module follows **Clean Architecture** with **Hexagonal Architecture** (Ports & Adapters) principles:
+This module follows **Clean Architecture** with **Hexagonal Architecture** (Ports & Adapters) principles for maximum maintainability and extensibility.
+
+### Architecture Layers
 
 ```
+┌─────────────────────────────────────────────────────────┐
+│  Dependencies ALWAYS point inward (toward Domain)       │
+└─────────────────────────────────────────────────────────┘
+
 TypeScript (React Native)
          ↓
-   ENTRYPOINT - Expo Modules API bridge
-         ↓
-   SERVICE - Use cases & orchestration
-         ↓
-   DOMAIN - Business entities & rules
+   ENTRYPOINT ← Expo Modules API bridge
          ↓
-   ADAPTER - Printer implementations (Bixolon, Zebra, etc.)
+   SERVICE ← Use cases & orchestration
          ↓
-INFRASTRUCTURE - Android APIs & SDKs
+   DOMAIN ← Business entities & rules (interfaces)
+         ↑
+   ┌─────┴─────┐
+ADAPTER    INFRASTRUCTURE
+(Vendors)  (Platform APIs)
 ```
 
-**Benefits:**
+### Layer Responsibilities
 
-- ✅ **Testable**: Mock adapters and services
+| Layer | Purpose | Examples |
+|-------|---------|----------|
+| **TypeScript** | React Native API | `bluetooth`, `connection`, `config`, `print` |
+| **Entrypoint** | Expo ↔ Kotlin bridge | `PrinterModule.kt` |
+| **Service** | Business logic | `ConnectivityService`, `PrintService` |
+| **Domain** | Contracts & entities | `IPrinter`, `Receipt`, `MediaConfig` |
+| **Adapter** | Vendor SDKs | `BixolonPrinterAdapter` |
+| **Infrastructure** | Platform utilities | `AndroidBluetoothProvider`, `BinaryConverter` |
+
+### Benefits
+
+- ✅ **Testable**: Mock adapters and services independently
 - ✅ **Maintainable**: Clear separation of concerns
-- ✅ **Extensible**: Easy to add new printer brands
+- ✅ **Extensible**: Easy to add new printer brands (Zebra, Epson, Star, etc.)
 - ✅ **Swappable**: Change implementations without affecting business logic
+- ✅ **Framework-independent**: Domain layer has no Android/iOS dependencies
+
+### Adding New Printer Brands
 
-See [ARCHITECTURE.md](ARCHITECTURE.md) for details.
+The architecture makes it easy to support additional printer brands:
+
+1. **Create Adapter**: Implement `IPrinter` interface for new vendor SDK
+2. **Register in SDK**: Add to `SincproPrinterSdk` entry point
+3. **No changes needed**: Business logic and API remain unchanged
+
+See [ARCHITECTURE.md](./ARCHITECTURE.md) for detailed architecture documentation.
 
 ---
 
-## 🛠️ Troubleshooting
+## 🖨️ Supported Printers
 
-### Bluetooth Permissions
+### Bixolon Printers
 
-**Problem**: "Permission denied" errors
+This module currently supports **Bixolon thermal printers** via the official Bixolon SDK.
 
-**Solution**: Check permission status and request if needed
+#### Tested Models
 
-```typescript
-const status = Printer.permission.getStatus();
-if (!status.allGranted) {
-  console.log('Missing:', status.deniedPermissions);
-  // Guide user to app settings to grant permissions
-}
-```
+- ✅ **SPP-R200III** - 2" mobile printer (58mm)
+- ✅ **SPP-R300** - 3" mobile printer (80mm)
+- ✅ **SPP-R400** - 4" mobile printer (112mm)
+- ✅ **SRP-275III** - 3" desktop printer (80mm)
+- ✅ **SRP-350III** - 3" desktop printer (80mm)
+- ✅ **SRP-352III** - 3" desktop printer (80mm)
+
+#### Compatible Models
+
+The following Bixolon models should work but have not been tested:
+
+- SPP-R210, SPP-R220, SPP-R310, SPP-R410
+- SRP-330II, SRP-350plusIII, SRP-380
+- XD3-40d, XD5-40d
+- XT5-40, XT5-43
+
+#### Connectivity Support
+
+| Connection Type | Status | Notes |
+|----------------|--------|-------|
+| **Bluetooth** | ✅ Fully supported | Most common for mobile printers |
+| **WiFi** | ✅ Supported | For network-connected printers |
+| **USB** | ⚠️ Limited | Requires USB OTG on Android |
+
+### Adding Support for Other Brands
+
+The architecture supports adding other printer brands. To add support:
+
+1. Implement the `IPrinter` interface in a new adapter
+2. Integrate the vendor's SDK (Zebra, Epson, Star, etc.)
+3. Register the adapter in the SDK entry point
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md) for development guidelines.
+
+---
+
+## 🛠️ Troubleshooting
 
 ### Connection Issues
 
 **Problem**: Connection fails or times out
 
 **Solutions**:
+1. Verify Bluetooth is enabled on the device
+2. Check device is paired: `bluetooth.getPairedDevices()`
+3. Ensure printer is powered on and in range (< 10 meters)
+4. Try increasing timeout: `connectBluetooth(address, 60000)` (60 seconds)
+5. Restart printer and retry connection
 
-1. Verify Bluetooth is enabled: `await Printer.bluetooth.isEnabled()`
-2. Check device is paired: `await Printer.bluetooth.getPairedDevices()`
-3. Ensure printer is powered on and in range
-4. Try reconnecting: `await Printer.connection.connect(address)`
+**Example:**
+```typescript
+try {
+  await connection.connectBluetooth(address, 60000);
+} catch (error) {
+  console.error('Connection failed:', error);
+  // Try restarting printer
+}
+```
 
 ### Print Failures
 
 **Problem**: Print command succeeds but nothing prints
 
 **Solutions**:
+1. Check printer status:
+   ```typescript
+   const status = await connection.getStatus();
+   if (!status.hasPaper) console.error('No paper!');
+   if (status.isCoverOpen) console.error('Cover open!');
+   ```
+2. Verify connection: `connection.isConnected()`
+3. Check media configuration matches paper type
+4. Ensure printer is not in an error state
+
+### Paper Not Feeding
+
+**Problem**: Paper doesn't feed after printing
+
+**Solutions**:
+1. Add space lines at the end of receipt:
+   ```typescript
+   footer: [
+     // ... other lines
+     { type: 'space', lines: 3 }  // Add extra space
+   ]
+   ```
+2. Configure auto-cutter:
+   ```typescript
+   await config.set({
+     autoCutter: { enabled: true, fullCut: true }
+   });
+   ```
+
+### Bluetooth Permissions Denied
+
+**Problem**: "Permission denied" errors
+
+**Solution**: Ensure permissions are declared in `app.json` and granted at runtime. Android 12+ requires runtime permission grants.
+
+```json
+{
+  "expo": {
+    "android": {
+      "permissions": [
+        "android.permission.BLUETOOTH",
+        "android.permission.BLUETOOTH_ADMIN",
+        "android.permission.BLUETOOTH_SCAN",
+        "android.permission.BLUETOOTH_CONNECT"
+      ]
+    }
+  }
+}
+```
+
+### Image/QR Not Printing
+
+**Problem**: Images or QR codes don't appear
+
+**Solutions**:
+1. Check base64 data is valid
+2. Ensure alignment is correct
+3. Try different QR size (1-10)
+4. Verify printer supports graphics
+
+### Module Not Found Error
+
+**Problem**: `Module "SincproPrinter" not found`
 
-1. Check printer status (paper, errors)
-2. Verify connection: `Printer.connection.isConnected()`
-3. Try smaller test print first
-4. Check printer-specific requirements (media config)
+**Solutions**:
+1. Rebuild native modules:
+   ```bash
+   npx expo prebuild --clean
+   npx expo run:android
+   ```
+2. Clear cache:
+   ```bash
+   npm start -- --clear
+   ```
 
 ---
 
 ## 📖 Resources
 
-- **Architecture**: [ARCHITECTURE.md](ARCHITECTURE.md) - Detailed architecture guide
-- **Contributing**: [CONTRIBUTING.md](CONTRIBUTING.md) - Development guidelines
-- **Copilot**: [.github/copilot-instructions.md](.github/copilot-instructions.md) - AI coding assistant rules
+- **Package**: [NPM Package](https://www.npmjs.com/package/@sincpro/printer-expo)
+- **Repository**: [GitHub](https://github.com/Sincpro-SRL/sincpro_printer_expo)
+- **Architecture**: [ARCHITECTURE.md](./ARCHITECTURE.md) - Detailed architecture guide
+- **Contributing**: [CONTRIBUTING.md](./CONTRIBUTING.md) - Development guidelines
 - **Expo Modules**: [Official Documentation](https://docs.expo.dev/modules/overview/)
-- **Bixolon SDK**: [Official Documentation](https://www.bixolon.com/)
+- **Bixolon**: [Official Website](https://www.bixolon.com/)
 
 ---
 
 ## 🤝 Contributing
 
-We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for:
+We welcome contributions! Please see [CONTRIBUTING.md](./CONTRIBUTING.md) for:
+
+- Development setup and environment
+- Code standards (ktlint, Prettier, ESLint)
+- Architecture guidelines and patterns
+- Git workflow and branch naming
+- Pull request process and review
+- Testing requirements
+
+### Quick Start for Contributors
 
-- Development setup
-- Code standards (ktlint, Prettier)
-- Architecture guidelines
-- Git workflow
-- Pull request process
+```bash
+# Clone the repository
+git clone https://github.com/Sincpro-SRL/sincpro_printer_expo.git
+cd sincpro_printer_expo
+
+# Install dependencies
+npm install
+
+# Build TypeScript
+npm run build
+
+# Format code
+npm run format
+npm run format:kotlin
+
+# Lint code
+npm run lint
+npm run lint:kotlin
+```
 
 ---
 
 ## 📄 License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+MIT License - see [LICENSE](./LICENSE) file for details.
+
+Copyright (c) 2024 Sincpro SRL
 
 ---
 
 ## 🙏 Acknowledgments
 
-- Bixolon for the official printer SDK
-- Expo team for the Modules API
-- Contributors and testers
+- **Bixolon** for the official printer SDK
+- **Expo team** for the Modules API
+- **Contributors** and testers who helped improve this module
+- **Open source community** for inspiration and support
+
+---
+
+## 📞 Support
+
+- **Issues**: [GitHub Issues](https://github.com/Sincpro-SRL/sincpro_printer_expo/issues)
+- **Discussions**: [GitHub Discussions](https://github.com/Sincpro-SRL/sincpro_printer_expo/discussions)
+- **Email**: support@sincpro.com
 
 ---