@risleylima/escpos 0.2.0 → 1.0.0

package/dist/usb-adapter/index.js

@@ -0,0 +1,264 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USB = void 0;
+const os = __importStar(require("os"));
+const adapter_1 = require("../adapter");
+const usb_1 = require("usb");
+const debug = require('debug')('escpos:usb-adapter');
+const IFACE_CLASS = {
+    AUDIO: 0x01,
+    HID: 0x03,
+    PRINTER: 0x07,
+    HUB: 0x09,
+};
+const NOT_CONNECTED_MSG = 'Not connected. Call connect([vid], [pid]) first.';
+const CHUNK_SIZE = 4096; // 4KB chunks for USB stability
+class USB extends adapter_1.Adapter {
+    constructor() {
+        super(...arguments);
+        this.device = null;
+        this.endpoint = null;
+        this.detachHandler = null;
+    }
+    static async listUSB() {
+        const devices = usb_1.usb.getDeviceList().filter((device) => {
+            try {
+                const configDescriptor = device.configDescriptor;
+                if (!configDescriptor || !configDescriptor.interfaces)
+                    return false;
+                return configDescriptor.interfaces.some((ifaceArray) => ifaceArray.some((iface) => iface.bInterfaceClass === IFACE_CLASS.PRINTER));
+            }
+            catch (e) {
+                debug('Error while get device info: ', e);
+                return false;
+            }
+        });
+        const getDescriptor = async (device, type) => {
+            try {
+                device.open();
+                const data = await new Promise((resolve, reject) => {
+                    device.getStringDescriptor(type, (err, res) => {
+                        if (err)
+                            reject(err);
+                        else
+                            resolve(res);
+                    });
+                });
+                device.close();
+                return data;
+            }
+            catch (e) {
+                debug('Error while read device description: ', e);
+                try {
+                    device.close();
+                }
+                catch { /* ignore */ }
+                return false;
+            }
+        };
+        const retorno = [];
+        for (const device of devices) {
+            const manufacturer = await getDescriptor(device, device.deviceDescriptor.iManufacturer);
+            const product = await getDescriptor(device, device.deviceDescriptor.iProduct);
+            retorno.push({
+                manufacturer: manufacturer ? manufacturer : undefined,
+                product: product ? product : undefined,
+                vendorId: device.deviceDescriptor.idVendor,
+                productId: device.deviceDescriptor.idProduct,
+            });
+        }
+        return retorno;
+    }
+    async connect(vid, pid) {
+        return this.synchronized(async () => {
+            this.device = null;
+            this.endpoint = null;
+            if (this.detachHandler) {
+                usb_1.usb.removeListener('detach', this.detachHandler);
+                this.detachHandler = null;
+            }
+            if (vid != null && pid != null) {
+                this.device = usb_1.usb.findByIds(vid, pid);
+            }
+            else {
+                const fullList = usb_1.usb.getDeviceList().filter((d) => {
+                    try {
+                        const cd = d.configDescriptor;
+                        if (!cd?.interfaces)
+                            return false;
+                        return cd.interfaces.some((arr) => arr.some((i) => i.bInterfaceClass === IFACE_CLASS.PRINTER));
+                    }
+                    catch {
+                        return false;
+                    }
+                });
+                if (fullList.length)
+                    this.device = fullList[0];
+            }
+            if (!this.device)
+                throw new Error('Cannot find printer!');
+            this.state = 'CONNECTED';
+            this.emit('connect', this.device);
+            this.detachHandler = (device) => {
+                if (device === this.device) {
+                    debug('Device Unplugged!');
+                    this.emit('detach');
+                    this.device = null;
+                    this.endpoint = null;
+                    this.state = 'DISCONNECTED';
+                }
+            };
+            usb_1.usb.on('detach', this.detachHandler);
+            debug('Device Connected!');
+            return true;
+        });
+    }
+    async open() {
+        return this.synchronized(async () => {
+            if (!this.device)
+                throw new Error(NOT_CONNECTED_MSG);
+            if (this.endpoint)
+                return true;
+            this.state = 'OPENING';
+            this.device.open();
+            const interfaces = this.device.interfaces;
+            if (!interfaces?.length)
+                throw new Error('Cannot access device interfaces');
+            for (const interfaceObj of interfaces) {
+                if (this.endpoint)
+                    break;
+                const descriptor = interfaceObj.descriptor;
+                if (descriptor?.bInterfaceClass !== IFACE_CLASS.PRINTER)
+                    continue;
+                if (os.platform() !== 'win32' && interfaceObj.isKernelDriverActive()) {
+                    try {
+                        interfaceObj.detachKernelDriver();
+                    }
+                    catch (e) {
+                        throw new Error(`[ERROR] Could not detach kernel driver: ${e.message}`);
+                    }
+                }
+                interfaceObj.claim();
+                for (const endpoint of interfaceObj.endpoints) {
+                    if (endpoint.direction === 'out') {
+                        this.endpoint = endpoint;
+                        this.state = 'READY';
+                        this.emit('open', this.device);
+                        debug('Device Opened!');
+                        break;
+                    }
+                }
+            }
+            if (!this.endpoint)
+                throw new Error('Can not find endpoint from printer');
+            return true;
+        });
+    }
+    async write(data) {
+        return this.synchronized(async () => {
+            if (!this.device || !this.endpoint)
+                throw new Error(NOT_CONNECTED_MSG);
+            const prevState = this.state;
+            this.state = 'BUSY';
+            try {
+                for (let i = 0; i < data.length; i += CHUNK_SIZE) {
+                    const chunk = data.subarray(i, i + CHUNK_SIZE);
+                    await this.writeChunk(chunk);
+                }
+                return true;
+            }
+            finally {
+                this.state = prevState === 'BUSY' ? 'READY' : prevState;
+            }
+        });
+    }
+    writeChunk(chunk) {
+        return new Promise((resolve, reject) => {
+            this.endpoint.transfer(chunk, (err) => {
+                if (err) {
+                    debug('Transfer Error: ', err);
+                    reject(err);
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+    async read() {
+        throw new Error('Read not supported for USB adapter yet.');
+    }
+    async close() {
+        return this.synchronized(async () => {
+            if (this.device) {
+                this.state = 'CLOSING';
+                try {
+                    const endpoint = this.endpoint;
+                    if (endpoint?.interface) {
+                        await new Promise((resolve, reject) => {
+                            endpoint.interface.release(true, (err) => {
+                                if (err)
+                                    reject(err);
+                                else
+                                    resolve();
+                            });
+                        });
+                    }
+                    this.device.close();
+                }
+                catch (e) {
+                    debug('Error closing device: ', e);
+                }
+            }
+            const closedDevice = this.device;
+            this.endpoint = null;
+            this.device = null;
+            this.state = 'DISCONNECTED';
+            if (this.detachHandler) {
+                usb_1.usb.removeListener('detach', this.detachHandler);
+                this.detachHandler = null;
+            }
+            this.emit('close', closedDevice);
+            debug('Device Closed!');
+            return true;
+        });
+    }
+    async disconnect() {
+        return this.close();
+    }
+}
+exports.USB = USB;
+//# sourceMappingURL=index.js.map

package/dist/usb-adapter/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/usb-adapter/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,39 +1,54 @@
 {
   "name": "@risleylima/escpos",
-  "version": "0.2.0",
-  "description": "Library to deal with ESCPOS using some adapters",
-  "main": "index.js",
+  "version": "1.0.0",
+  "description": "Node.js thermal printer library: ESC/POS, receipts, barcodes, images via USB or Serial",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "author": "Rlima Info",
   "license": "MIT",
   "private": false,
   "engines": {
     "node": ">=18.0.0"
   },
+  "scripts": {
+    "build": "tsc",
+    "test": "yarn build && jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "check:ts": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
   "dependencies": {
+    "@resvg/resvg-js": "^2.6.2",
     "debug": "^4.4.3",
-    "get-pixels": "https://github.com/risleylima/get-pixels",
-    "iconv-lite": "^0.7.0",
+    "jpeg-js": "^0.4.4",
+    "omggif": "^1.0.10",
     "serialport": "^13.0.0",
-    "usb": "^2.16.0"
+    "usb": "^2.17.0"
   },
   "devDependencies": {
-    "jest": "^30.2.0"
+    "@types/node": "^22.0.0",
+    "jest": "^30.2.0",
+    "typescript": "^5.8.0"
   },
   "directories": {
     "example": "examples"
   },
-  "scripts": {
-    "test": "jest",
-    "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
-  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/risleylima/escpos.git"
   },
   "keywords": [
-    "EscPos",
-    "USB"
+    "escpos",
+    "thermal-printer",
+    "receipt-printer",
+    "pos",
+    "usb",
+    "serial",
+    "nodejs",
+    "barcode",
+    "receipt",
+    "typescript"
   ],
   "bugs": {
     "url": "https://github.com/risleylima/escpos/issues"
@@ -41,5 +56,17 @@
   "homepage": "https://github.com/risleylima/escpos#readme",
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ]
 }

package/CHANGELOG.md

@@ -1,68 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [0.2.0] - 2025-11-23
-
-### Added
-- `Serial.listSerial()` method to list all available serial ports
-  - Returns array of serial port objects with path, manufacturer, vendorId, productId, etc.
-  - Similar functionality to `USB.listUSB()` for consistency between adapters
-
-## [0.1.0] - 2025-11-23
-
-### Added
-- Complete JSDoc documentation for all public APIs
-- Comprehensive test suite with 145+ tests achieving 100% coverage
-- Detailed documentation in `docs/` folder:
-  - Library Overview
-  - USB v2 Migration Review
-  - SerialPort v13 Migration Complete
-  - Test Coverage Analysis
-  - JSDoc Review
-  - Public API Analysis
-- Enhanced README with complete installation, usage examples, and API documentation
-
-### Changed
-- **BREAKING (Internal)**: Updated `usb` from `^1.9.1` to `^2.16.0`
-  - Migrated from callback-based to Promise-based API
-  - Improved error handling and interface management
-  - Note: Public API remains unchanged, no breaking changes for library users
-- **BREAKING (Internal)**: Updated `serialport` from `^12.0.0` to `^13.0.0`
-  - Migrated from callback-based to Promise-based API
-  - Improved connection handling and error management
-  - Note: Public API remains unchanged, no breaking changes for library users
-- Updated `debug` from `^4.3.1` to `^4.4.3`
-- Updated `iconv-lite` from `^0.6.3` to `^0.7.0`
-- Updated `jest` from `^29.7.0` to `^30.2.0`
-
-### Fixed
-- Fixed event emission consistency in USB and Serial adapters
-- Fixed adapter instantiation in Printer class to maintain consistency
-- Improved error handling in adapter close/disconnect methods
-- Fixed test coverage gaps in commands and printer utilities
-
-### Improved
-- Architecture improvements for better event handling
-- Enhanced error messages and debugging information
-- Better interface release logic in USB adapter
-- Improved test isolation and reliability
-
-### Security
-- Updated dependencies to latest versions with security patches
-
-## [0.0.14] - Previous Release
-
-Initial stable release with USB and Serial adapter support.
-
----
-
-## Version History
-
-- **0.2.0** - Added `Serial.listSerial()` method for listing available serial ports
-- **0.1.0** - Major dependency updates, 100% test coverage, complete documentation
-- **0.0.14** - Initial stable release
-

package/docs/COVERAGE_ANALYSIS.md

@@ -1,98 +0,0 @@
-# Test Coverage Analysis
-
-## Current Coverage Status
-
-- **Statements**: 100% ✅
-- **Branches**: 100% ✅ (was 88.09%, improved to 100%)
-- **Functions**: 100% ✅
-- **Lines**: 100% ✅
-
-**Status**: ✅ **100% Coverage Achieved!**
-
-## Uncovered Branches
-
-### 1. `commands.js` - `numToHexString` function (Line 12)
-
-```javascript
-if (!isNaN(num)) {
-  // This branch is covered
-} 
-// Missing: else branch when isNaN(num) === true
-```
-
-**Issue**: The function doesn't test the case when `Number(value)` results in `NaN`.
-
-**Current Test**: None - this function is only tested indirectly through other functions.
-
-**Fix Needed**: Test with invalid input (e.g., `numToHexString('invalid')` or `numToHexString(NaN)`).
-
-### 2. `commands.js` - `TXT_CUSTOM_SIZE` function (Lines 77-80)
-
-```javascript
-width = width > 8 ? 8 : width;      // Branch: width > 8 not tested
-width = width < 1 ? 1 : width;      // Branch: width < 1 not tested
-height = height > 8 ? 8 : height;   // Branch: height > 8 not tested
-height = height < 1 ? 1 : height;    // Branch: height < 1 not tested
-```
-
-**Issue**: The `size()` method is only tested with normal values (2, 2), not edge cases.
-
-**Current Test**: 
-```javascript
-it('should set text size', () => {
-  printer.size(2, 2);
-  // Only tests normal case
-});
-```
-
-**Missing Tests**:
-- `printer.size(10, 2)` - width > 8 (should clamp to 8)
-- `printer.size(0, 2)` - width < 1 (should clamp to 1)
-- `printer.size(2, 10)` - height > 8 (should clamp to 8)
-- `printer.size(2, 0)` - height < 1 (should clamp to 1)
-- `printer.size(10, 10)` - both > 8
-- `printer.size(0, 0)` - both < 1
-
-## Impact
-
-The uncovered branches are **edge case validations** that:
-- Clamp values to valid ranges (1-8 for width/height)
-- Handle invalid input gracefully
-
-While these branches are defensive code, they should be tested to ensure:
-1. The clamping logic works correctly
-2. Invalid inputs don't cause errors
-3. The behavior is documented through tests
-
-## ✅ Resolution
-
-Tests have been added for all uncovered branches:
-
-1. **`numToHexString` tests** (`tests/unit/printer/commands.test.js`):
-   - ✅ NaN input handling
-   - ✅ Invalid input handling
-   - ✅ Edge cases (zero, large numbers, odd-length hex)
-
-2. **`TXT_CUSTOM_SIZE` tests** (`tests/unit/printer/commands.test.js`):
-   - ✅ Width clamping (> 8, < 1)
-   - ✅ Height clamping (> 8, < 1)
-   - ✅ Both parameters out of range
-   - ✅ Boundary values (1 and 8)
-   - ✅ Valid range values
-
-3. **`size()` method tests** (`tests/unit/printer/printer.test.js`):
-   - ✅ Width > 8 clamping
-   - ✅ Width < 1 clamping
-   - ✅ Height > 8 clamping
-   - ✅ Height < 1 clamping
-   - ✅ Both out of range
-
-## Results
-
-- **Before**: 88.09% branch coverage (50% in commands.js)
-- **After**: 100% branch coverage ✅
-- **New Tests Added**: 19 tests
-- **Total Tests**: 145 (was 126)
-
-All edge cases are now properly tested and documented!
-

package/docs/DEPENDENCIES_REVIEW.md

@@ -1,127 +0,0 @@
-# Dependencies Review
-
-## Current Dependencies Status
-
-### Production Dependencies
-
-| Package | Current | Latest | Status | Notes |
-|---------|---------|--------|--------|-------|
-| `debug` | `^4.4.3` | `4.4.3` | ✅ Up to date | Updated from 4.3.1 |
-| `get-pixels` | `https://github.com/risleylima/get-pixels` | N/A | ✅ Custom | Custom fork, version not tracked |
-| `iconv-lite` | `^0.7.0` | `0.7.0` | ✅ Up to date | Updated from 0.6.3 |
-| `serialport` | `^13.0.0` | `13.0.0` | ✅ Up to date | Updated from 12.0.0 |
-| `usb` | `^2.16.0` | `2.16.0` | ✅ Up to date | Updated from 1.9.1 |
-
-### Development Dependencies
-
-| Package | Current | Latest | Status | Notes |
-|---------|---------|--------|--------|-------|
-| `jest` | `^30.2.0` | `30.2.0` | ✅ Up to date | Updated from 29.7.0 |
-
-## Detailed Analysis
-
-### 1. `debug` (4.3.1 → 4.4.3)
-- **Type**: Minor update
-- **Risk**: Low
-- **Breaking Changes**: None expected
-- **Recommendation**: ✅ Safe to update
-- **Changes**: Bug fixes and minor improvements
-
-### 2. `iconv-lite` (0.6.3 → 0.7.0)
-- **Type**: Major update
-- **Risk**: Medium
-- **Breaking Changes**: Possible
-- **Recommendation**: ⚠️ Review before updating
-- **Notes**: 
-  - Major version jump indicates potential breaking changes
-  - Need to verify API compatibility
-  - Check changelog for breaking changes
-
-### 3. `serialport` (12.0.0 → 13.0.0)
-- **Type**: Major update
-- **Risk**: High
-- **Breaking Changes**: Likely
-- **Recommendation**: ⚠️ Review carefully before updating
-- **Notes**:
-  - Major version jump (12 → 13)
-  - Serial adapter code may need updates
-  - Check migration guide
-  - Test thoroughly with hardware
-
-### 4. `jest` (29.7.0 → 30.2.0)
-- **Type**: Major update
-- **Risk**: Low to Medium
-- **Breaking Changes**: Possible
-- **Recommendation**: ⚠️ Review before updating
-- **Notes**:
-  - Major version jump (29 → 30)
-  - Test configuration may need updates
-  - Check Jest 30 migration guide
-  - All tests should still work, but config might need tweaks
-
-### 5. `usb` (2.16.0)
-- **Status**: ✅ Already updated
-- **Notes**: Recently migrated from 1.9.1 to 2.16.0
-
-## Update Recommendations
-
-### Priority 1: Safe Updates (Low Risk)
-1. **`debug`** → `^4.4.3`
-   - Minor version update
-   - No breaking changes expected
-   - Quick win
-
-### Priority 2: Review Required (Medium Risk)
-2. **`iconv-lite`** → `^0.7.0`
-   - Check changelog for breaking changes
-   - Test encoding functionality
-   - Verify all text encoding still works
-
-3. **`jest`** → `^30.2.0`
-   - Review Jest 30 release notes
-   - Check if test configuration needs updates
-   - Run all tests after update
-
-### Priority 3: Careful Review (High Risk)
-4. **`serialport`** → `^13.0.0`
-   - Major version jump
-   - Review migration guide
-   - Update serial adapter code if needed
-   - Test with real hardware
-   - May require significant code changes
-
-## Update Strategy
-
-### Option 1: Conservative (Recommended)
-- Update `debug` only (safe)
-- Keep others at current versions
-- Monitor for issues
-
-### Option 2: Moderate
-- Update `debug` and `iconv-lite`
-- Review and test `iconv-lite` changes
-- Keep `serialport` and `jest` for now
-
-### Option 3: Aggressive
-- Update all dependencies
-- Requires thorough testing
-- May need code changes for `serialport`
-- Higher risk of breaking changes
-
-## Testing Checklist (After Updates)
-
-- [ ] Run all unit tests
-- [ ] Run integration tests
-- [ ] Test USB adapter with real hardware
-- [ ] Test Serial adapter with real hardware
-- [ ] Test text encoding with various character sets
-- [ ] Verify all examples work
-- [ ] Check for deprecation warnings
-
-## Notes
-
-- `get-pixels` is a custom fork, version tracking not applicable
-- All major updates should be tested thoroughly
-- Consider updating one at a time to isolate issues
-- Keep backup of working `package-lock.json` before updates
-