@esslassi/electron-printer 0.0.3 → 0.0.5

package/README.md

@@ -1,82 +1,251 @@
-# @esslassi/electron-printer
+Here is the clean **README.md** content ready to copy and paste:
 
-**No recompilation required when upgrading Node.js versions, thanks to N-API!** 🎉
+---
+
+# Electron Printer (@esslassi/electron-printer)
+
+Node.js and Electron bindings for printer management and direct printing. Supports Windows and Linux (CUPS).
 
-Native bind printers on POSIX and Windows OS from Node.js, Electron, and node-webkit.
+## Features
 
-!npm version !Prebuild Binaries and Publish
+* List all available printers
+* Get the system default printer
+* Get detailed printer status
+* Direct printing (raw printing)
+* TypeScript support
+* Asynchronous API (Promises)
+* Compatible with Node.js and Electron
 
-> Supports Node.js versions from 8.0.0 onwards, including the latest versions, thanks to the transition to N-API.
+## Requirements
 
-> Prebuild and CI integration courtesy of @ekoeryanto in his FORK
+* Node.js >= 18.20.6
+* Electron >= 20.0.0
+* Windows or Linux
+* For Windows: Visual Studio Build Tools
+* For Linux: CUPS development headers
+
+```bash
+sudo apt-get install libcups2-dev
+```
 
-If you have a problem, ask a question on !Gitter or find/create a new Github issue
+## Installation
 
-___
-### **Below is the original README**
-___
-### Reason:
+```bash
+npm install @esslassi/electron-printer
+```
 
-I was involved in a project where I needed to print from Node.js. This is the reason why I created this project and I want to share my code with others.
+For development:
 
-### Features:
+```bash
+git clone https://github.com/esslassi/electron-printer.git
+cd electron-printer
+npm install
+npm run rebuild
+```
 
-* No dependencies on NAN or V8;
-* Native method wrappers for Windows and POSIX (which uses CUPS 1.4/MAC OS X 10.6) APIs;
-* Compatible with Node.js versions that support N-API, ensuring long-term stability and compatibility;
-* Compatible with Electron versions that support N-API, reducing the need for frequent recompilation;
-* `getPrinters()` to enumerate all installed printers with current jobs and statuses;
-* `getPrinter(printerName)` to get a specific/default printer info with current jobs and statuses;
-* `getPrinterDriverOptions(printerName)` (POSIX only) to get a specific/default printer driver options such as supported paper size and other info;
-* `getSelectedPaperSize(printerName)` (POSIX only) to get a specific/default printer default paper size from its driver options;
-* `getDefaultPrinterName()` returns the default printer name;
-* `printDirect(options)` to send a job to a specific/default printer, now supports CUPS options passed in the form of a JS object (see `cancelJob.js` example). To print a PDF from Windows, it is possible by using node-pdfium module to convert a PDF format into EMF and then send it to the printer as EMF;
-* `printFile(options)` (POSIX only) to print a file;
-* `getSupportedPrintFormats()` to get all possible print formats for the `printDirect` method, which depends on the OS. `RAW` and `TEXT` are supported on all OSes;
-* `getJob(printerName, jobId)` to get specific job info including job status;
-* `setJob(printerName, jobId, command)` to send a command to a job (e.g., `'CANCEL'` to cancel the job);
-* `getSupportedJobCommands()` to get supported job commands for `setJob()`, depending on the OS. The `'CANCEL'` command is supported on all OSes.
+## Usage
+
+### JavaScript
+
+```javascript
+const printer = require('@esslassi/electron-printer');
+
+// List all printers
+printer.getPrinters()
+  .then(printers => {
+    console.log('Available printers:', printers);
+  })
+  .catch(console.error);
+
+// Get default printer
+printer.getDefaultPrinter()
+  .then(defaultPrinter => {
+    console.log('Default printer:', defaultPrinter);
+  })
+  .catch(console.error);
+
+// Check printer status
+printer.getStatusPrinter({ printerName: 'Printer Name' })
+  .then(status => {
+    console.log('Printer status:', status);
+  })
+  .catch(console.error);
+
+// Print directly
+const printOptions = {
+  printerName: 'Printer Name',
+  data: 'Text to print',
+  dataType: 'RAW' // optional (default is 'RAW')
+};
+
+printer.printDirect(printOptions)
+  .then(result => {
+    console.log('Result:', result);
+  })
+  .catch(console.error);
+```
 
-### How to install:
+### TypeScript
+
+```typescript
+import printer, { 
+  Printer, 
+  PrintDirectOptions, 
+  GetStatusPrinterOptions 
+} from '@esslassi/electron-printer';
+
+async function example() {
+  try {
+    const printers: Printer[] = await printer.getPrinters();
+    console.log('Printers:', printers);
+
+    const defaultPrinter: Printer = await printer.getDefaultPrinter();
+    console.log('Default printer:', defaultPrinter);
+
+    const statusOptions: GetStatusPrinterOptions = {
+      printerName: 'Printer Name'
+    };
+    const status: Printer = await printer.getStatusPrinter(statusOptions);
+    console.log('Status:', status);
+
+    const printOptions: PrintDirectOptions = {
+      printerName: 'Printer Name',
+      data: Buffer.from('Text to print'),
+      dataType: 'RAW'
+    };
+
+    const result = await printer.printDirect(printOptions);
+    console.log('Result:', result);
+
+  } catch (error) {
+    console.error('Error:', error);
+  }
+}
 ```
-npm install @esslassi/electron-printer
+
+## API
+
+### getPrinters(): Promise<Printer[]>
+
+Lists all printers installed on the system.
+
+```typescript
+interface Printer {
+  name: string;
+  isDefault: boolean;
+  status: string;
+  details: {
+    location?: string;
+    comment?: string;
+    driver?: string;
+    port?: string;
+    [key: string]: string | undefined;
+  };
+}
 ```
 
-### How to use:
+---
+
+### getDefaultPrinter(): Promise<Printer>
 
-See examples
+Returns the system default printer.
+
+---
 
-### Author(s):
+### getStatusPrinter(options: GetStatusPrinterOptions): Promise<Printer>
 
-* Mohammed Esslassi, contact@foxneer.com
+```typescript
+interface GetStatusPrinterOptions {
+  printerName: string;
+}
+```
 
-### Node.js Version Support:
+---
 
-This project supports Node.js versions from 8.0.0 onwards. N-API ensures that native addons do not require recompilation when upgrading Node.js versions. For more details, refer to the [Node.js N-API documentation](https://nodejs.org/api/n-api.html)¹(https://nodejs.org/api/n-api.html).
+### printDirect(options: PrintDirectOptions): Promise<string>
 
-Feel free to download, test, and propose new features.
+```typescript
+interface PrintDirectOptions {
+  printerName: string;
+  data: string | Buffer;
+  dataType?: 'RAW' | 'TEXT' | 'COMMAND' | 'AUTO';
+}
+```
 
-### License:
- The MIT License (MIT)
+### Possible Status Values
+
+* ready
+* offline
+* error
+* paper-jam
+* paper-out
+* manual-feed
+* paper-problem
+* busy
+* printing
+* output-bin-full
+* not-available
+* waiting
+* processing
+* initializing
+* warming-up
+* toner-low
+* no-toner
+* page-punt
+* user-intervention
+* out-of-memory
+* door-open
 
-## Contributing
+---
 
-Contributions are welcome! Please open an issue or submit a pull request on GitHub.
+## Supported Platforms
 
-## License
+* Windows (32/64-bit)
+* Linux (CUPS)
 
-This project is licensed under the MIT License.
+---
+
+## Troubleshooting
+
+### Windows
+
+1. Install Visual Studio Build Tools
+2. Run:
+
+```bash
+npm run rebuild
+```
+
+3. Verify printer access permissions
+
+### Linux
+
+```bash
+sudo apt-get install libcups2-dev
+sudo service cups status
+sudo usermod -a -G lp $USER
+```
 
-### Keywords:
+---
+
+## Development
+
+```bash
+git clone https://github.com/esslassi/electron-printer.git
+cd electron-printer
+npm install
+npm run rebuild
+node test.js
+```
+
+---
+
+## License
 
-* node-printer
-* printer
-* electron-printer
-* node-addon-api
-* POSIX printer
-* Windows printer
-* CUPS printer
-* print job
-* printer driver
+MIT
 
 ---
+
+## Author
+
+Esslassi

package/binding.gyp

@@ -1,39 +1,57 @@
 {
-  'variables': {
-    'module_name%': 'electron-printer',
-    'module_path%': 'lib'
-  },
-  'targets': [
-      {
-      "target_name": "action_after_build",
-      "type": "none",
-      "dependencies": [ "<(module_name)" ],
-      "copies": [
-        {
-          "files": [ "<(PRODUCT_DIR)/<(module_name).node" ],
-          "destination": "<(module_path)"
-        }
-      ]
-    },
+  "targets": [
     {
-      'target_name': '<(module_name)',
-      'sources': [
-        # is like "ls -1 src/*.cc", but gyp does not support direct patterns on
-        # sources
-        '<!@(["python", "tools/getSourceFiles.py", "src", "cc"])'
+      "target_name": "electron_printer",
+      "sources": [
+        "src/main.cpp",
+        "src/print.cpp",
+        "src/printer_factory.cpp"
+      ],
+      "include_dirs": [
+        "<!@(node -p \"require('node-addon-api').include\")"
       ],
-      'include_dirs': ["<!@(node -p \"require('node-addon-api').include\")"],
-      'dependencies': ["<!(node -p \"require('node-addon-api').gyp\")"],
-      'cflags!': [ '-fno-exceptions' ],
-      'cflags_cc!': [ '-fno-exceptions' ],
-      'xcode_settings': {
-        'GCC_ENABLE_CPP_EXCEPTIONS': 'YES',
-        'CLANG_CXX_LIBRARY': 'libc++',
-        'MACOSX_DEPLOYMENT_TARGET': '10.7'
-      },
-      'msvs_settings': {
-        'VCCLCompilerTool': { 'ExceptionHandling': 1 },
-      }
+      "dependencies": [
+        "<!(node -p \"require('node-addon-api').gyp\")"
+      ],
+      "defines": [ "NAPI_CPP_EXCEPTIONS" ],
+      "conditions": [
+        ['OS=="win"', {
+          "sources": ["src/windows_printer.cpp"],
+          "libraries": ["winspool.lib"],
+          "msvs_settings": {
+            "VCCLCompilerTool": {
+              "ExceptionHandling": 1
+            }
+          }
+        }],
+        ['OS=="mac"', {
+          "sources": ["src/mac_printer.cpp"],
+          "libraries": ["-lcups"],
+          "include_dirs": [
+            "/usr/include/cups"
+          ],
+          "xcode_settings": {
+            "OTHER_CFLAGS": ["-Wall"],
+            "GCC_ENABLE_CPP_EXCEPTIONS": "YES",
+            "CLANG_CXX_LIBRARY": "libc++",
+            "MACOSX_DEPLOYMENT_TARGET": "10.7"
+          }
+        }],
+        ['OS=="linux"', {
+          "sources": ["src/linux_printer.cpp"],
+          "libraries": ["-lcups"],
+          "include_dirs": [
+            "/usr/include/cups"
+          ],
+          "cflags": [
+            "-Wall",
+            "-fexceptions"
+          ],
+          "cflags_cc": [
+            "-fexceptions"
+          ]
+        }]
+      ]
     }
   ]
 }

package/package.json

@@ -1,48 +1,62 @@
 {
   "name": "@esslassi/electron-printer",
-  "description": "Node API (N-API) supported electron.s || node.js printer bindings",
-  "homepage": "https://github.com/esslassi/electron-printer",
-  "version": "0.0.3",
+  "description": "Node.js and Electron bindings",
+  "version": "0.0.5",
   "main": "./lib/index.js",
-  "types": "types/index.d.ts",
-  "dependencies": {
-    "node-addon-api": "^8.1.0"
-  },
+  "private": false,
   "scripts": {
-    "install": "prebuild-install || node-gyp rebuild",
+    "install": "node-gyp rebuild",
+    "prebuild:master": "prebuild-install || node-gyp rebuild",
+    "clean:lib": "rimraf lib/ && rimraf tsconfig-build.tsbuildinfo",
+    "build": "npm run clean:lib && tsc -p tsconfig-build.json && node-gyp build",
     "rebuild": "node-gyp rebuild",
-    "release": "node-pre-gyp-github publish --release --commitish main",
-    "electron-rebuild": "node-gyp rebuild --target_platform=win32 --target_arch=x64  --runtime=electron --target=35.0.1 --dist-url=https://electronjs.org/headers",
-    "test": "node --test test/"
-  },
-  "author": {
-    "name": "Esslassi Mohammed",
-    "url": "http://foxneer.com/",
-    "email": "contact@foxneer.com"
+    "release": "node release.js"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/esslassi/electron-printer.git"
+    "url": "git@github.com:esslassi/electron-printer.git"
+  },
+  "homepage": "https://github.com/esslassi/electron-printer/#readme",
+  "keywords": [
+    "native",
+    "electron",
+    "node",
+    "printer"
+  ],
+  "author": {
+    "name": "Esslassi Mohammed",
+    "url": "https://github.com/esslassi/electron-printer/#readme",
+    "email": "esslassi1996@gmail.com"
   },
   "binary": {
-    "module_name": "electron-printer",
-    "module_path": "./lib/",
+    "module_name": "electron_printer",
+    "module_path": "build/Release/",
     "host": "https://github.com/esslassi/electron-printer/releases/download/",
-    "remote_path": "v{version}",
-    "tag_path": "https://github.com/esslassi/electron-printer/releases/tag/v{version}"
+    "remote_path": "v{version}"
+  },
+  "license": "MIT",
+  "gypfile": true,
+  "dependencies": {
+    "bindings": "1.5.0",
+    "dotenv": "17.2.3",
+    "node-addon-api": "8.5.0",
+    "node-gyp": "12.1.0"
   },
-  "licenses": [
-    {
-      "type": "BSD"
-    }
-  ],
   "devDependencies": {
-    "@mapbox/node-pre-gyp": "^2.0.0",
-    "grunt": "^1.6.1",
-    "grunt-contrib-copy": "^1.0.0",
-    "grunt-contrib-jshint": "^3.2.0",
-    "grunt-node-gyp": "^5.0.0",
-    "grunt-shell": "^4.0.0",
-    "node-pre-gyp-github": "^2.0.0"
+    "@semantic-release/changelog": "6.0.3",
+    "@semantic-release/commit-analyzer": "13.0.1",
+    "@semantic-release/git": "10.0.1",
+    "@semantic-release/github": "11.0.1",
+    "@semantic-release/npm": "12.0.1",
+    "@semantic-release/release-notes-generator": "14.0.3",
+    "@tsconfig/node18": "^18.2.4",
+    "@types/bindings": "^1.5.5",
+    "@types/node": "22.12.0",
+    "prebuild-install": "7.1.3",
+    "rimraf": "^6.0.1",
+    "typescript": "5.7.3"
+  },
+  "engines": {
+    "node": ">= 18.x"
   }
 }

package/src/linux_printer.cpp

@@ -0,0 +1,171 @@
+#include "linux_printer.h"
+#include <cups/cups.h>
+#include <cups/ppd.h>
+
+std::string LinuxPrinter::GetPrinterStatus(ipp_pstate_t state)
+{
+    switch (state)
+    {
+    case IPP_PRINTER_IDLE:
+        return "ready";
+    case IPP_PRINTER_PROCESSING:
+        return "printing";
+    case IPP_PRINTER_STOPPED:
+        return "stopped";
+    default:
+        return "unknown";
+    }
+}
+
+PrinterInfo LinuxPrinter::GetPrinterDetails(const std::string &printerName, bool isDefault)
+{
+    PrinterInfo info;
+    info.name = printerName;
+    info.isDefault = isDefault;
+
+    cups_dest_t *dests;
+    int num_dests = cupsGetDests(&dests);
+    cups_dest_t *dest = cupsGetDest(printerName.c_str(), NULL, num_dests, dests);
+
+    if (dest != NULL)
+    {
+        for (int i = 0; i < dest->num_options; i++)
+        {
+            info.details[dest->options[i].name] = dest->options[i].value;
+        }
+
+        http_t *http = httpConnect2(cupsServer(), ippPort(), NULL, AF_UNSPEC,
+                                    HTTP_ENCRYPTION_IF_REQUESTED, 1, 30000, NULL);
+        if (http != NULL)
+        {
+            ipp_t *request = ippNewRequest(IPP_OP_GET_PRINTER_ATTRIBUTES);
+
+            char uri[HTTP_MAX_URI];
+            httpAssembleURIf(HTTP_URI_CODING_ALL, uri, sizeof(uri), "ipp", NULL,
+                             "localhost", 0, "/printers/%s", printerName.c_str());
+
+            ippAddString(request, IPP_TAG_OPERATION, IPP_TAG_URI,
+                         "printer-uri", NULL, uri);
+
+            ipp_t *response = cupsDoRequest(http, request, "/");
+            if (response != NULL)
+            {
+                ipp_attribute_t *attr = ippFindAttribute(response,
+                                                         "printer-state", IPP_TAG_ENUM);
+                if (attr != NULL)
+                {
+                    info.status = GetPrinterStatus((ipp_pstate_t)ippGetInteger(attr, 0));
+                }
+
+                attr = ippFindAttribute(response, "printer-location", IPP_TAG_TEXT);
+                if (attr != NULL)
+                    info.details["location"] = ippGetString(attr, 0, NULL);
+
+                attr = ippFindAttribute(response, "printer-info", IPP_TAG_TEXT);
+                if (attr != NULL)
+                    info.details["comment"] = ippGetString(attr, 0, NULL);
+
+                attr = ippFindAttribute(response, "printer-make-and-model", IPP_TAG_TEXT);
+                if (attr != NULL)
+                    info.details["driver"] = ippGetString(attr, 0, NULL);
+
+                attr = ippFindAttribute(response, "port", IPP_TAG_TEXT);
+                if (attr != NULL)
+                    info.details["port"] = ippGetString(attr, 0, NULL);
+
+                ippDelete(response);
+            }
+            httpClose(http);
+        }
+    }
+    cupsFreeDests(num_dests, dests);
+    return info;
+}
+
+std::vector<PrinterInfo> LinuxPrinter::GetPrinters()
+{
+    std::vector<PrinterInfo> printers;
+    cups_dest_t *dests;
+    int num_dests = cupsGetDests(&dests);
+
+    for (int i = 0; i < num_dests; i++)
+    {
+        printers.push_back(GetPrinterDetails(dests[i].name, dests[i].is_default));
+    }
+
+    cupsFreeDests(num_dests, dests);
+    return printers;
+}
+
+PrinterInfo LinuxPrinter::GetSystemDefaultPrinter()
+{
+    cups_dest_t *dests;
+    int num_dests = cupsGetDests(&dests);
+    cups_dest_t *dest = cupsGetDest(NULL, NULL, num_dests, dests);
+
+    PrinterInfo printer;
+    if (dest != NULL)
+    {
+        printer = GetPrinterDetails(dest->name, true);
+    }
+
+    cupsFreeDests(num_dests, dests);
+    return printer;
+}
+
+bool LinuxPrinter::PrintDirect(const std::string &printerName,
+                               const std::vector<uint8_t> &data,
+                               const std::string &dataType)
+{
+    int jobId = cupsCreateJob(CUPS_HTTP_DEFAULT, printerName.c_str(),
+                              "Node.js Print Job", 0, NULL);
+
+    if (jobId <= 0)
+        return false;
+
+    http_status_t status = cupsStartDocument(CUPS_HTTP_DEFAULT, printerName.c_str(),
+                                             jobId, "Node.js Print Job",
+                                             dataType.c_str(), 1);
+
+    if (status != HTTP_STATUS_CONTINUE)
+    {
+        cupsCancelJob(printerName.c_str(), jobId);
+        return false;
+    }
+
+    if (cupsWriteRequestData(CUPS_HTTP_DEFAULT,
+                             reinterpret_cast<const char *>(data.data()),
+                             data.size()) != HTTP_STATUS_CONTINUE)
+    {
+        cupsCancelJob(printerName.c_str(), jobId);
+        return false;
+    }
+
+    status = static_cast<http_status_t>(cupsFinishDocument(CUPS_HTTP_DEFAULT, printerName.c_str()));
+    return status == HTTP_STATUS_OK;
+}
+
+PrinterInfo LinuxPrinter::GetStatusPrinter(const std::string &printerName)
+{
+    cups_dest_t *dests;
+    int num_dests = cupsGetDests(&dests);
+
+    cups_dest_t *defaultDest = cupsGetDest(NULL, NULL, num_dests, dests);
+    bool isDefault = false;
+
+    if (defaultDest != NULL)
+    {
+        isDefault = (printerName == defaultDest->name);
+    }
+
+    cups_dest_t *dest = cupsGetDest(printerName.c_str(), NULL, num_dests, dests);
+    PrinterInfo printer;
+
+    if (dest != NULL)
+    {
+        printer = GetPrinterDetails(printerName, isDefault);
+    }
+
+    cupsFreeDests(num_dests, dests);
+    return printer;
+}

package/src/linux_printer.h

@@ -0,0 +1,21 @@
+#ifndef LINUX_PRINTER_H
+#define LINUX_PRINTER_H
+#include <cups/cups.h>
+#include <cups/ppd.h>
+#include <cstdint>
+#include "printer_interface.h"
+
+class LinuxPrinter : public PrinterInterface
+{
+private:
+    std::string GetPrinterStatus(ipp_pstate_t state);
+
+public:
+    virtual PrinterInfo GetPrinterDetails(const std::string &printerName, bool isDefault = false) override;
+    virtual std::vector<PrinterInfo> GetPrinters() override;
+    virtual PrinterInfo GetSystemDefaultPrinter() override;
+    virtual bool PrintDirect(const std::string &printerName, const std::vector<uint8_t> &data, const std::string &dataType) override;
+    virtual PrinterInfo GetStatusPrinter(const std::string &printerName) override;
+};
+
+#endif