enhanced-printer 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Akshay Malaviya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,313 @@
+# Enhanced Printer Library
+
+A powerful Node.js/Electron library for advanced PDF printing with job tracking, custom page sizes, and tray selection. Compatible with **Node.js 20+** and **Electron 39+**.
+
+## Features
+
+✅ **PDF Printing** - Print PDF files with full control  
+✅ **Job ID Tracking** - Retrieve Windows print spooler job IDs  
+✅ **Custom Page Sizes** - Support for standard and custom paper sizes  
+✅ **Tray Selection** - Select specific printer trays/bins  
+✅ **Default Preferences** - Automatically uses printer defaults when settings not specified  
+✅ **Job Monitoring** - Query job status and manage print queue  
+✅ **Electron Compatible** - Works seamlessly with Electron 39+  
+
+## Installation
+
+```bash
+npm install enhanced-printer
+```
+
+> **Note**: Replace `enhanced-printer` with the actual package name you choose when publishing to npm.
+> Check `PUBLISH-CHECKLIST.md` for publishing steps.
+
+## Requirements
+
+- **Node.js**: 20.0.0 or higher
+- **Electron**: 39.0.0 or higher (optional)
+- **OS**: Windows (uses PowerShell for job tracking)
+
+## Quick Start
+
+```javascript
+const { print, getPrinters } = require('enhanced-printer');
+
+async function printPDF() {
+  // Get available printers
+  const printers = await getPrinters();
+  console.log('Available printers:', printers);
+  
+  // Print with default settings
+  const result = await print({
+    printerName: 'Your Printer Name',
+    filePath: 'C:\\path\\to\\document.pdf'
+  });
+  
+  console.log('Success:', result.success);
+  console.log('Job ID:', result.jobId);
+}
+
+printPDF();
+```
+
+## API Reference
+
+### `print(options: PrintOptions): Promise<PrintResult>`
+
+Prints a PDF file with the specified options.
+
+**Parameters:**
+
+```typescript
+interface PrintOptions {
+  printerName: string;     // Required: Name of the printer
+  filePath: string;        // Required: Path to PDF file
+  
+  // Optional settings - defaults to printer preferences if not specified
+  pageSize?: string;       // e.g., "A4", "A5", "A6", "Letter", "Legal"
+  tray?: string | number;  // Tray name or number
+  jobName?: string;        // Document/job name for tracking
+  copies?: number;         // Number of copies
+  orientation?: 'portrait' | 'landscape';
+  duplex?: 'simplex' | 'duplex';
+  monochrome?: boolean;    // Black & white printing
+  pages?: string;          // e.g., "1-3,5" to print specific pages
+  subset?: 'odd' | 'even'; // Print only odd or even pages
+}
+```
+
+**Returns:**
+
+```typescript
+interface PrintResult {
+  success: boolean;
+  jobId?: number;        // Job ID from print spooler (if available)
+  jobName: string;       // Document name used for tracking
+  error?: string;        // Error message if print failed
+}
+```
+
+**Example:**
+
+```javascript
+const result = await print({
+  printerName: 'HP LaserJet',
+  filePath: './invoice.pdf',
+  pageSize: 'A4',
+  tray: 2,
+  copies: 2
+});
+```
+
+### `getPrinters(): Promise<PrinterInfo[]>`
+
+Gets a list of available printers.
+
+**Returns:**
+
+```typescript
+interface PrinterInfo {
+  name: string;
+  isDefault: boolean;
+  status: string;
+}
+```
+
+**Example:**
+
+```javascript
+const printers = await getPrinters();
+printers.forEach(p => {
+  console.log(`${p.name} - ${p.status} ${p.isDefault ? '(Default)' : ''}`);
+});
+```
+
+### `getDefaultPrinter(): Promise<string | null>`
+
+Gets the name of the default printer.
+
+### `getJobStatus(printerName: string, jobId: number): Promise<JobInfo | null>`
+
+Gets information about a specific print job.
+
+**Example:**
+
+```javascript
+const jobInfo = await getJobStatus('HP LaserJet', 123);
+console.log('Status:', jobInfo.status);
+console.log('Pages:', jobInfo.pages);
+```
+
+### `getPrinterJobs(printerName: string): Promise<JobInfo[]>`
+
+Gets all print jobs for a specific printer.
+
+### `cancelJob(printerName: string, jobId: number): Promise<boolean>`
+
+Cancels a print job.
+
+## Usage Examples
+
+### Using Printer Defaults
+
+When you don't specify optional settings, the library automatically uses the printer's default configuration:
+
+```javascript
+// Uses printer's default page size, tray, and other settings
+const result = await print({
+  printerName: 'My Printer',
+  filePath: './document.pdf'
+});
+```
+
+### Custom Page Size with Default Tray
+
+```javascript
+// Custom page size, but uses printer's default tray
+const result = await print({
+  printerName: 'Label Printer',
+  filePath: './label.pdf',
+  pageSize: 'A6'  // 4x6 inches for labels
+  // tray not specified - uses default
+});
+```
+
+### Custom Tray with Default Page Size
+
+```javascript
+// Specific tray, but uses printer's default page size
+const result = await print({
+  printerName: 'Office Printer',
+  filePath: './document.pdf',
+  tray: 'Tray 2'  // or use number: tray: 2
+  // pageSize not specified - uses default
+});
+```
+
+### Multiple Custom Settings
+
+```javascript
+const result = await print({
+  printerName: 'My Printer',
+  filePath: './document.pdf',
+  pageSize: 'Legal',
+  tray: 1,
+  copies: 3,
+  orientation: 'landscape',
+  duplex: 'duplex',
+  monochrome: true,
+  jobName: 'Important-Document'
+});
+```
+
+### Job Tracking
+
+```javascript
+const result = await print({
+  printerName: 'My Printer',
+  filePath: './document.pdf'
+});
+
+if (result.jobId) {
+  // Monitor job status
+  const jobInfo = await getJobStatus('My Printer', result.jobId);
+  console.log(`Job ${jobInfo.jobId}: ${jobInfo.status}`);
+  
+  // Cancel if needed
+  // await cancelJob('My Printer', result.jobId);
+}
+```
+
+## Electron Integration
+
+See `examples/electron-integration.js` for a complete example.
+
+**Main Process:**
+
+```javascript
+const { ipcMain } = require('electron');
+const { print, getPrinters } = require('@your-org/enhanced-printer');
+
+ipcMain.handle('print-pdf', async (event, options) => {
+  return await print(options);
+});
+
+ipcMain.handle('get-printers', async () => {
+  return await getPrinters();
+});
+```
+
+**Renderer Process:**
+
+```javascript
+const result = await window.printerAPI.print({
+  printerName: 'My Printer',
+  filePath: pdfPath
+});
+```
+
+## TypeScript Support
+
+This library is written in TypeScript and includes full type definitions.
+
+```typescript
+import { print, PrintOptions, PrintResult } from '@your-org/enhanced-printer';
+
+const options: PrintOptions = {
+  printerName: 'My Printer',
+  filePath: './document.pdf',
+  pageSize: 'A4'
+};
+
+const result: PrintResult = await print(options);
+```
+
+## How It Works
+
+1. **PDF Printing**: Uses `pdf-to-printer` library which wraps SumatraPDF on Windows
+2. **Job ID Retrieval**: Queries Windows print spooler using PowerShell commands
+3. **Default Settings**: When settings aren't specified, SumatraPDF uses the printer's DEVMODE defaults
+
+## Limitations
+
+- **Windows Only**: Job ID tracking requires PowerShell (Windows-specific)
+- **PDF Files**: Designed for PDF printing (for raw data, convert to PDF first)
+- **Job ID Timing**: Very fast printers may complete jobs before ID can be retrieved
+
+## Examples
+
+See the `examples/` directory for complete working examples:
+
+- `basic-print.js` - Simple printing with defaults
+- `custom-settings.js` - Custom page sizes, trays, and options
+- `job-monitoring.js` - Job status tracking
+- `electron-integration.js` - Electron app integration
+
+## Troubleshooting
+
+### Job ID is undefined
+
+This can happen if:
+- The print job completes very quickly
+- The printer isn't accessible
+- PowerShell execution is blocked
+
+The library will still print successfully; only job ID retrieval may fail.
+
+### Custom page size not working
+
+Ensure the page size is either:
+1. A standard size name ("A4", "Letter", etc.)
+2. A custom size that's been pre-configured in Windows printer settings
+
+### Printer not found
+
+Use `getPrinters()` to see available printers and verify the exact printer name (case-sensitive).
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome! Please open an issue or pull request.

package/lib/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Enhanced Printer Library
+ *
+ * A Node.js/Electron library for advanced PDF printing with job tracking.
+ * Compatible with Node.js 20+ and Electron 39+.
+ *
+ * Features:
+ * - Print PDFs with custom page sizes and tray selection
+ * - Retrieve job IDs from Windows print spooler
+ * - Automatic use of printer defaults when settings not specified
+ * - Query job status and printer information
+ */
+export { print, getPrinters, getDefaultPrinter, getJobStatus, getPrinterJobs, cancelJob } from './print-manager';
+export { PrintOptions, PrintResult, PrinterInfo, JobInfo } from './types';

package/lib/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Enhanced Printer Library
+ *
+ * A Node.js/Electron library for advanced PDF printing with job tracking.
+ * Compatible with Node.js 20+ and Electron 39+.
+ *
+ * Features:
+ * - Print PDFs with custom page sizes and tray selection
+ * - Retrieve job IDs from Windows print spooler
+ * - Automatic use of printer defaults when settings not specified
+ * - Query job status and printer information
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cancelJob = exports.getPrinterJobs = exports.getJobStatus = exports.getDefaultPrinter = exports.getPrinters = exports.print = void 0;
+var print_manager_1 = require("./print-manager");
+Object.defineProperty(exports, "print", { enumerable: true, get: function () { return print_manager_1.print; } });
+Object.defineProperty(exports, "getPrinters", { enumerable: true, get: function () { return print_manager_1.getPrinters; } });
+Object.defineProperty(exports, "getDefaultPrinter", { enumerable: true, get: function () { return print_manager_1.getDefaultPrinter; } });
+Object.defineProperty(exports, "getJobStatus", { enumerable: true, get: function () { return print_manager_1.getJobStatus; } });
+Object.defineProperty(exports, "getPrinterJobs", { enumerable: true, get: function () { return print_manager_1.getPrinterJobs; } });
+Object.defineProperty(exports, "cancelJob", { enumerable: true, get: function () { return print_manager_1.cancelJob; } });

package/lib/job-tracker.d.ts

@@ -0,0 +1,13 @@
+import { JobInfo } from './types';
+/**
+ * Retrieves job ID by document name using PowerShell
+ */
+export declare function getJobIdByName(printerName: string, jobName: string, maxRetries?: number, retryDelay?: number): Promise<number | null>;
+/**
+ * Gets detailed information about a print job
+ */
+export declare function getJobInfo(printerName: string, jobId: number): Promise<JobInfo | null>;
+/**
+ * Gets all print jobs for a printer
+ */
+export declare function getAllJobs(printerName: string): Promise<JobInfo[]>;

package/lib/job-tracker.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getJobIdByName = getJobIdByName;
+exports.getJobInfo = getJobInfo;
+exports.getAllJobs = getAllJobs;
+const child_process_1 = require("child_process");
+/**
+ * Retrieves job ID by document name using PowerShell
+ */
+async function getJobIdByName(printerName, jobName, maxRetries = 3, retryDelay = 200) {
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const jobId = await queryJobId(printerName, jobName);
+        if (jobId !== null) {
+            return jobId;
+        }
+        // Wait before retrying (job might not be in spooler yet)
+        if (attempt < maxRetries - 1) {
+            await sleep(retryDelay);
+        }
+    }
+    return null;
+}
+/**
+ * Gets detailed information about a print job
+ */
+async function getJobInfo(printerName, jobId) {
+    const script = `
+    Get-PrintJob -PrinterName "${escapePowerShellString(printerName)}" |
+    Where-Object {$_.Id -eq ${jobId}} |
+    Select-Object Id, DocumentName, JobStatus, TotalPages, Size |
+    ConvertTo-Json
+  `;
+    try {
+        const output = await executePowerShell(script);
+        const result = JSON.parse(output);
+        if (!result || !result.Id) {
+            return null;
+        }
+        return {
+            jobId: result.Id,
+            jobName: result.DocumentName || '',
+            printerName: printerName,
+            status: result.JobStatus || 'Unknown',
+            pages: result.TotalPages || 0,
+            size: result.Size
+        };
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Gets all print jobs for a printer
+ */
+async function getAllJobs(printerName) {
+    const script = `
+    Get-PrintJob -PrinterName "${escapePowerShellString(printerName)}" |
+    Select-Object Id, DocumentName, JobStatus, TotalPages, Size |
+    ConvertTo-Json
+  `;
+    try {
+        const output = await executePowerShell(script);
+        const result = JSON.parse(output);
+        // Handle single result vs array
+        const jobs = Array.isArray(result) ? result : (result ? [result] : []);
+        return jobs.map((job) => ({
+            jobId: job.Id,
+            jobName: job.DocumentName || '',
+            printerName: printerName,
+            status: job.JobStatus || 'Unknown',
+            pages: job.TotalPages || 0,
+            size: job.Size
+        }));
+    }
+    catch (error) {
+        return [];
+    }
+}
+/**
+ * Query job ID by document name
+ */
+async function queryJobId(printerName, jobName) {
+    const script = `
+    Get-PrintJob -PrinterName "${escapePowerShellString(printerName)}" |
+    Where-Object {$_.DocumentName -eq "${escapePowerShellString(jobName)}"} |
+    Select-Object Id |
+    ConvertTo-Json
+  `;
+    try {
+        const output = await executePowerShell(script);
+        const result = JSON.parse(output);
+        return result?.Id || null;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Executes a PowerShell script and returns output
+ */
+function executePowerShell(script) {
+    return new Promise((resolve, reject) => {
+        const ps = (0, child_process_1.spawn)('powershell.exe', [
+            '-NoProfile',
+            '-NonInteractive',
+            '-Command',
+            script
+        ]);
+        let output = '';
+        let errorOutput = '';
+        ps.stdout.on('data', (data) => {
+            output += data.toString();
+        });
+        ps.stderr.on('data', (data) => {
+            errorOutput += data.toString();
+        });
+        ps.on('close', (code) => {
+            if (code === 0 && output.trim()) {
+                resolve(output.trim());
+            }
+            else {
+                reject(new Error(`PowerShell error: ${errorOutput || 'Unknown error'}`));
+            }
+        });
+        ps.on('error', (err) => {
+            reject(err);
+        });
+    });
+}
+/**
+ * Escapes string for use in PowerShell
+ */
+function escapePowerShellString(str) {
+    return str.replace(/["'`$]/g, '`$&');
+}
+/**
+ * Sleep utility
+ */
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}

package/lib/print-manager.d.ts

@@ -0,0 +1,25 @@
+import { PrintOptions, PrintResult, PrinterInfo, JobInfo } from './types';
+/**
+ * Prints a PDF file with the specified options
+ */
+export declare function print(options: PrintOptions): Promise<PrintResult>;
+/**
+ * Gets a list of available printers
+ */
+export declare function getPrinters(): Promise<PrinterInfo[]>;
+/**
+ * Gets the default printer name
+ */
+export declare function getDefaultPrinter(): Promise<string | null>;
+/**
+ * Gets information about a specific print job
+ */
+export declare function getJobStatus(printerName: string, jobId: number): Promise<JobInfo | null>;
+/**
+ * Gets all print jobs for a specific printer
+ */
+export declare function getPrinterJobs(printerName: string): Promise<JobInfo[]>;
+/**
+ * Cancels a print job
+ */
+export declare function cancelJob(printerName: string, jobId: number): Promise<boolean>;

package/lib/print-manager.js

@@ -0,0 +1,183 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.print = print;
+exports.getPrinters = getPrinters;
+exports.getDefaultPrinter = getDefaultPrinter;
+exports.getJobStatus = getJobStatus;
+exports.getPrinterJobs = getPrinterJobs;
+exports.cancelJob = cancelJob;
+const pdf_to_printer_1 = __importDefault(require("pdf-to-printer"));
+const uuid_1 = require("uuid");
+const child_process_1 = require("child_process");
+const job_tracker_1 = require("./job-tracker");
+/**
+ * Prints a PDF file with the specified options
+ */
+async function print(options) {
+    try {
+        // Validate required options
+        if (!options.printerName) {
+            return {
+                success: false,
+                jobName: '',
+                error: 'Printer name is required'
+            };
+        }
+        if (!options.filePath) {
+            return {
+                success: false,
+                jobName: '',
+                error: 'File path is required'
+            };
+        }
+        // Generate unique job name if not provided
+        const jobName = options.jobName || `PrintJob_${(0, uuid_1.v4)()}`;
+        // Build pdf-to-printer options
+        // Only include settings that user explicitly provided
+        const printOptions = {
+            printer: options.printerName
+        };
+        // Optional settings - only add if provided
+        if (options.pageSize !== undefined) {
+            printOptions.paperSize = options.pageSize;
+        }
+        if (options.tray !== undefined) {
+            printOptions.bin = options.tray;
+        }
+        if (options.copies !== undefined) {
+            printOptions.copies = options.copies;
+        }
+        if (options.orientation !== undefined) {
+            printOptions.orientation = options.orientation;
+        }
+        if (options.duplex !== undefined) {
+            printOptions.side = options.duplex;
+        }
+        if (options.monochrome !== undefined) {
+            printOptions.monochrome = options.monochrome;
+        }
+        if (options.pages !== undefined) {
+            printOptions.pages = options.pages;
+        }
+        if (options.subset !== undefined) {
+            printOptions.subset = options.subset;
+        }
+        // Set the document name for job tracking
+        printOptions.win32 = ['-print-settings', `${jobName}`];
+        // Print the document
+        await pdf_to_printer_1.default.print(options.filePath, printOptions);
+        // Try to retrieve job ID
+        const jobId = await (0, job_tracker_1.getJobIdByName)(options.printerName, jobName);
+        return {
+            success: true,
+            jobId: jobId || undefined,
+            jobName: jobName
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            jobName: options.jobName || '',
+            error: error.message || 'Unknown error occurred'
+        };
+    }
+}
+/**
+ * Gets a list of available printers
+ */
+async function getPrinters() {
+    const script = `
+    Get-Printer | Select-Object Name, PrinterStatus, Default |
+    ConvertTo-Json
+  `;
+    try {
+        const output = await executePowerShell(script);
+        const result = JSON.parse(output);
+        // Handle single result vs array
+        const printers = Array.isArray(result) ? result : (result ? [result] : []);
+        return printers.map((printer) => ({
+            name: printer.Name,
+            isDefault: printer.Default === true,
+            status: printer.PrinterStatus || 'Unknown'
+        }));
+    }
+    catch (error) {
+        return [];
+    }
+}
+/**
+ * Gets the default printer name
+ */
+async function getDefaultPrinter() {
+    const printers = await getPrinters();
+    const defaultPrinter = printers.find(p => p.isDefault);
+    return defaultPrinter ? defaultPrinter.name : null;
+}
+/**
+ * Gets information about a specific print job
+ */
+async function getJobStatus(printerName, jobId) {
+    return (0, job_tracker_1.getJobInfo)(printerName, jobId);
+}
+/**
+ * Gets all print jobs for a specific printer
+ */
+async function getPrinterJobs(printerName) {
+    return (0, job_tracker_1.getAllJobs)(printerName);
+}
+/**
+ * Cancels a print job
+ */
+async function cancelJob(printerName, jobId) {
+    const script = `
+    Remove-PrintJob -PrinterName "${escapePowerShellString(printerName)}" -ID ${jobId}
+  `;
+    try {
+        await executePowerShell(script);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+/**
+ * Executes a PowerShell script and returns output
+ */
+function executePowerShell(script) {
+    return new Promise((resolve, reject) => {
+        const ps = (0, child_process_1.spawn)('powershell.exe', [
+            '-NoProfile',
+            '-NonInteractive',
+            '-Command',
+            script
+        ]);
+        let output = '';
+        let errorOutput = '';
+        ps.stdout.on('data', (data) => {
+            output += data.toString();
+        });
+        ps.stderr.on('data', (data) => {
+            errorOutput += data.toString();
+        });
+        ps.on('close', (code) => {
+            if (code === 0 && output.trim()) {
+                resolve(output.trim());
+            }
+            else {
+                reject(new Error(`PowerShell error: ${errorOutput || 'Unknown error'}`));
+            }
+        });
+        ps.on('error', (err) => {
+            reject(err);
+        });
+    });
+}
+/**
+ * Escapes string for use in PowerShell
+ */
+function escapePowerShellString(str) {
+    return str.replace(/["'`$]/g, '`$&');
+}

package/lib/types.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Information about a printer
+ */
+export interface PrinterInfo {
+    name: string;
+    isDefault: boolean;
+    status: string;
+    defaultPageSize?: string;
+    defaultTray?: string;
+}
+/**
+ * Options for printing a document
+ */
+export interface PrintOptions {
+    /** Name of the printer to use */
+    printerName: string;
+    /** Path to PDF file to print */
+    filePath: string;
+    /**
+     * Paper size (optional - defaults to printer's default)
+     * Examples: "A4", "A5", "A6", "Letter", "Legal", "Tabloid"
+     */
+    pageSize?: string;
+    /**
+     * Tray/bin selection (optional - defaults to printer's default)
+     * Can be tray number (1, 2, 3...) or tray name
+     */
+    tray?: string | number;
+    /**
+     * Document/job name for tracking (optional - auto-generated if not provided)
+     */
+    jobName?: string;
+    /** Number of copies (optional - defaults to 1) */
+    copies?: number;
+    /** Page orientation (optional) */
+    orientation?: 'portrait' | 'landscape';
+    /** Duplex printing mode (optional) */
+    duplex?: 'simplex' | 'duplex';
+    /** Print in monochrome/black & white (optional) */
+    monochrome?: boolean;
+    /** Print specific pages (optional, e.g., "1-3,5") */
+    pages?: string;
+    /** Print only odd or even pages (optional) */
+    subset?: 'odd' | 'even';
+}
+/**
+ * Result of a print operation
+ */
+export interface PrintResult {
+    /** Whether the print was successful */
+    success: boolean;
+    /** Job ID from Windows print spooler (may be undefined if retrieval failed) */
+    jobId?: number;
+    /** Document/job name used for tracking */
+    jobName: string;
+    /** Error message if print failed */
+    error?: string;
+}
+/**
+ * Information about a print job
+ */
+export interface JobInfo {
+    /** Job ID in the print queue */
+    jobId: number;
+    /** Document name */
+    jobName: string;
+    /** Name of the printer */
+    printerName: string;
+    /** Current status of the job */
+    status: string;
+    /** Number of pages */
+    pages: number;
+    /** Size in bytes */
+    size?: number;
+}

package/lib/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "enhanced-printer",
+  "version": "1.0.0",
+  "description": "Advanced PDF printing library with job tracking, custom page sizes, and tray selection for Node.js and Electron",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "files": [
+    "lib/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "printer",
+    "print",
+    "printing",
+    "pdf",
+    "pdf-printer",
+    "electron",
+    "windows",
+    "job-tracking",
+    "print-spooler",
+    "tray-selection",
+    "page-size",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "os": [
+    "win32"
+  ],
+  "dependencies": {
+    "pdf-to-printer": "^5.6.1",
+    "uuid": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.17.10",
+    "@types/uuid": "^10.0.0",
+    "typescript": "^5.7.3"
+  },
+  "author": "Akshay Malaviya",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/akshaymalaviya/enhanced-printer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/akshaymalaviya/enhanced-printer/issues"
+  },
+  "homepage": "https://github.com/akshaymalaviya/enhanced-printer#readme"
+}