node-hp-scan-to 1.9.7 → 1.10.0

package/README.md

@@ -8,7 +8,7 @@
 [![CodeFactor](https://www.codefactor.io/repository/github/manuc66/node-hp-scan-to/badge)](https://www.codefactor.io/repository/github/manuc66/node-hp-scan-to)
 [![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fmanuc66%2Fnode-hp-scan-to.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2Fmanuc66%2Fnode-hp-scan-to?ref=badge_shield)
 
-**`node-hp-scan-to`** is a Node.js application that replicates HP's "_Scan to Computer_" functionality by [reverse engineering](protocol_doc/HP%20Officejet%206500%20E710n-z.md) the original protocol, allowing you to scan documents directly from your HP printer's scanner to your Linux, Windows, or macOS computer.
+**`node-hp-scan-to`** is a Node.js application that replicates HP's "_Scan to Computer_" functionality by [reverse engineering HP's proprietary protocols](protocol_doc/HP%20Officejet%206500%20E710n-z.md) and supporting the standardized [eSCL protocol](protocol_doc/HP%20PageWide%20Pro%20477dw%20MFP.md), allowing you to scan documents directly from your HP printer's scanner to your Linux, Windows, or macOS computer.
 
 
 Unlike the original HP program, `node-hp-scan-to` is cross-platform and can be run on a bare-metal desktop or server, or in a container on Docker or Kubernetes. It can also be integrated with third-party document management solutions such as [Paperless-ngx](https://docs.paperless-ngx.com/) and [Nextcloud](https://Nextcloud.com/).
@@ -22,6 +22,8 @@ Unlike the original HP program, `node-hp-scan-to` is cross-platform and can be r
   - [Supported Devices](#supported-devices)
   - [Supported Functions](#supported-functions)
   - [App Features](#app-features)
+  - [Protocol Support](#protocol-support)
+  - [Emulated Duplex Scanning Feature](#emulated-duplex-scanning-feature)
 - [Installation](#installation)
   - [Using NodeJS](#using-nodejs)
   - [Using Docker](#using-docker)
@@ -83,6 +85,14 @@ There is a good chance it also works on other unlisted HP All-in-One Printer.
   - Local folders
   - [Paperless-ngx API](https://docs.paperless-ngx.com/api/) upload
   - [Nextcloud WebDAV](https://docs.Nextcloud.com/server/latest/user_manual/en/files/access_webdav.html) upload
+
+### Protocol Support
+
+Supports both HP proprietary protocols (WalkupScanToComp, WalkupScan, ScanJob) and the standardized eSCL protocol.
+
+- **eSCL-only devices** (e.g., HP ScanJet Pro 4500 fn1): Automatically detected and supported ([#1307](https://github.com/manuc66/node-hp-scan-to/issues/1307))
+- **Dual-protocol devices**: Uses HP protocols by default; add `--prefer-eSCL` flag to use eSCL instead
+- See [eSCL protocol documentation](protocol_doc/HP%20PageWide%20Pro%20477dw%20MFP.md) for technical details
  
 ### Emulated Duplex Scanning Feature
 
@@ -160,6 +170,9 @@ Run `npx node-hp-scan-to --help` to see the full list of options below:
 | `-p`, `--pattern`                     | Filename pattern (no extension). Use quotes for static text, supports date/time masks (see [dateformat docs](https://www.npmjs.com/package/dateformat#mask-options)). Defaults to `scan<increasing number>_page<page number>`. | `-p scan1_page1`                                                  |
 | `-r`, `--resolution`                  | Scan resolution in DPI. Defaults to 200.                                                                         | `-r 200`                                                          |
 | `--mode <mode> `                      | Selects the scan mode (default: Color) (choices: "Gray", "Color").                                               | `--mode Gray`                                                     |
+| `--paper-size <size>`                 | Paper size preset: A4 (default), Letter, Legal, A5, B5, or Max (case-insensitive). Cannot be used with `--paper-dim`. | `--paper-size Letter`                                             |
+| `--paper-orientation <orientation>`   | Paper orientation: portrait (default) or landscape. Applied to `--paper-size` only.                              | `--paper-orientation landscape`                                   |
+| `--paper-dim <dimensions>`            | Custom paper dimensions with unit (e.g., 21x29.7cm, 8.5x11in, 210x297mm). Cannot be used with `--paper-size`. | `--paper-dim 8.5x11in`                                            |
 | `-s`, `--paperless-post-document-url` | Paperless-ngx API URL for uploading documents.                                                             | `-s https://domain.tld/api/documents/post_document/` (no default) |
 | `-t`, `--temp-directory`              | Temporary directory for processing. Defaults to `/tmp/scan-to-pc<random value>` if not set.                      | `-t /tmp/scan-to-pc5678`                                          |
 | `-w`, `--width`                       | Scan width in pixels. Defaults to 2481.                                                                          | `-w 2481`                                                         |
@@ -172,11 +185,97 @@ Run `npx node-hp-scan-to --help` to see the full list of options below:
 
 **Notes:**
 
-- Date/time patterns for `--pattern` follow the [dateformat](https://www.npmjs.com/package/dateformat) library’s “Mask options” section.
+- Date/time patterns for `--pattern` follow the [dateformat](https://www.npmjs.com/package/dateformat) library's "Mask options" section.
 
 - Defaults like `/tmp/scan-to-pc<random value>` include a random suffix in practice (e.g., `/tmp/scan-to-pc1234`).
 
-#### CLI Commands
+#### Paper Size Configuration
+
+By default, scans use **A4 paper size** (210×297 mm). You can specify a different paper size or custom dimensions via CLI flags, environment variables, or the config file.
+
+##### Preset Paper Sizes
+
+The following preset sizes are available (case-insensitive):
+
+| Preset | Dimensions | Use Case |
+|--------|-----------|----------|
+| **A4** (default) | 210×297 mm | Standard European paper size |
+| **Letter** | 215.9×279.4 mm | Standard US letter size |
+| **Legal** | 215.9×355.6 mm | Standard US legal size |
+| **A5** | 148×210 mm | Half of A4 size |
+| **B5** | 176×250 mm | Between A4 and A5 |
+| **Max** | Device maximum | Uses the device's maximum scannable area (not auto-detect) |
+
+##### Custom Sizes
+
+You can specify custom paper dimensions with explicit units using the `--paper-dim` option:
+
+```bash
+# Centimeters
+npx node-hp-scan-to single-scan --paper-dim 21x29.7cm
+
+# Inches
+npx node-hp-scan-to single-scan --paper-dim 8.5x11in
+
+# Millimeters
+npx node-hp-scan-to single-scan --paper-dim 210x297mm
+```
+
+**Supported units:** `cm`, `mm`, `in` (inches). Units are **required** and **case-insensitive**.
+
+##### Configuration Precedence
+
+Paper size is resolved in the following order (highest to lowest priority):
+
+1. **CLI flags**: `--paper-size` or `--paper-dim`
+2. **Environment variables**: `PAPER_SIZE` or `PAPER_DIM`
+3. **Config file**: `paper_size` or `paper_dim` in `config/default.json`
+4. **Default**: A4 (210×297 mm)
+
+##### Important Rules
+
+- **Cannot specify both `--paper-size` and `--paper-dim` simultaneously.** You must choose one; attempting to use both will result in an error.
+- **Resolution (DPI) is independent** of paper size. You can specify both independently:
+  ```bash
+  npx node-hp-scan-to single-scan --paper-size Letter --resolution 300
+  ```
+- **Device maximum is respected.** If your custom size exceeds the device's maximum scannable area, the scan will be clamped to the device's limits.
+- **"Max" uses device capabilities, not auto-detection.** The `Max` preset uses the device's reported maximum scan area; it does **not** automatically detect the actual paper size in the scanner.
+
+##### Examples
+
+```bash
+# Use Letter size
+npx node-hp-scan-to single-scan --paper-size Letter
+
+# Use A5 (smaller) size
+npx node-hp-scan-to single-scan --paper-size A5
+
+# Use maximum scannable area
+npx node-hp-scan-to single-scan --paper-size Max
+
+# Use custom size in centimeters
+npx node-hp-scan-to single-scan --paper-dim 21x29.7cm
+
+# Use custom size in inches (8.5" × 11")
+npx node-hp-scan-to single-scan --paper-dim 8.5x11in
+
+# With Docker (environment variable)
+docker run -e PAPER_SIZE=Letter manuc66/node-hp-scan-to
+
+# With Docker Compose
+environment:
+  PAPER_SIZE: "Letter"
+  PAPER_DIM: null  # Must be null if not using custom dimensions
+
+# In config file (config/default.json)
+{
+  "paper_size": "A4",
+  "paper_dim": null
+}
+```
+
+
 
 ##### `listen`
 
@@ -200,6 +299,9 @@ Scan Options:
   --mode <mode>                                                    Selects the scan mode (default: Color) (choices: "Gray", "Color")
   -w, --width <width>                                              Width in pixels of the scans (default: max)
   -h, --height <height>                                            Height in pixels of the scans (default: max)
+  --paper-size <size>                                              Paper size preset: A4 (default), Letter, Legal, A5, B5, or Max (case-insensitive)
+  --paper-orientation <orientation>                                Paper orientation: portrait (default) or landscape. Applied to --paper-size only. (choices: "portrait", "landscape")
+  --paper-dim <dimensions>                                         Custom paper dimensions with unit (e.g., 21x29.7cm, 8.5x11in, 210x297mm). Cannot be used with --paper-size.
   -t, --temp-directory <dir>                                       Temp directory used for processing (default: /tmp/scan-to-pcRANDOM)
   --prefer-eSCL                                                    Prefer eSCL protocol if available
 
@@ -265,6 +367,9 @@ Scan Options:
   --mode <mode>                                                    Selects the scan mode (default: Color) (choices: "Gray", "Color")
   -w, --width <width>                                              Width in pixels of the scans (default: max)
   -h, --height <height>                                            Height in pixels of the scans (default: max)
+  --paper-size <size>                                              Paper size preset: A4 (default), Letter, Legal, A5, B5, or Max (case-insensitive)
+  --paper-orientation <orientation>                                Paper orientation: portrait (default) or landscape. Applied to --paper-size only. (choices: "portrait", "landscape")
+  --paper-dim <dimensions>                                         Custom paper dimensions with unit (e.g., 21x29.7cm, 8.5x11in, 210x297mm). Cannot be used with --paper-size.
   -t, --temp-directory <dir>                                       Temp directory used for processing (default: /tmp/scan-to-pcRANDOM)
   --prefer-eSCL                                                    Prefer eSCL protocol if available
   --duplex                                                         If specified, all the scans will be in duplex if the device support it
@@ -359,6 +464,9 @@ Scan Options:
   --mode <mode>                                                    Selects the scan mode (default: Color) (choices: "Gray", "Color")
   -w, --width <width>                                              Width in pixels of the scans (default: max)
   -h, --height <height>                                            Height in pixels of the scans (default: max)
+  --paper-size <size>                                              Paper size preset: A4 (default), Letter, Legal, A5, B5, or Max (case-insensitive)
+  --paper-orientation <orientation>                                Paper orientation: portrait (default) or landscape. Applied to --paper-size only. (choices: "portrait", "landscape")
+  --paper-dim <dimensions>                                         Custom paper dimensions with unit (e.g., 21x29.7cm, 8.5x11in, 210x297mm). Cannot be used with --paper-size.
   -t, --temp-directory <dir>                                       Temp directory used for processing (default: /tmp/scan-to-pcRANDOM)
   --prefer-eSCL                                                    Prefer eSCL protocol if available
   --duplex                                                         If specified, all the scans will be in duplex if the device support it
@@ -437,6 +545,7 @@ List of supported environment variables and their meaning, or correspondence wit
 | `PUID`                        | ID of the user that will run the program                                                                      |                                                                               |
 | `RESOLUTION`                  | Resolution setting                                                                                            | `-r` / `--resolution`                                                         |
 | `MODE`                        | Scan mode setting                                                                                             | `--mode`                                                                      |
+| `PAPER_ORIENTATION`           | Paper orientation: portrait (default) or landscape. Applied to `PAPER_SIZE` only.                             | `--paper-orientation`                                                         |
 | `TEMP_DIR`                    | Temporary directory                                                                                           | `-t` / `--temp-directory`                                                     |
 
 **Additional Notes:**

package/dist/PaperSize.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Standard unit resolution (1/300 inch) used for eSCL ScanRegion (ThreeHundredthsOfInches)
+ * and potentially for non-eSCL legacy device configurations.
+ */
+export declare const THREE_HUNDREDTHS_OF_INCH_DPI = 300;
+/**
+ * Paper size in millimeters.
+ */
+export interface PaperSizeMm {
+    widthMm: number;
+    heightMm: number;
+}
+/**
+ * Resolved paper size with its human-readable source label (for logging).
+ */
+export interface ResolvedPaperSize {
+    resolvedMm: PaperSizeMm;
+    /** Human-readable label, e.g. "A4", "Custom (21x29.7cm)" */
+    source: string;
+}
+/**
+ * Scan region dimensions in device units (eSCL: 1/300", non-eSCL: pixels at scan DPI).
+ */
+export interface ScanRegionUnits {
+    width: number;
+    height: number;
+}
+/**
+ * Converts millimeters to scan region units using the given unit resolution.
+ *
+ * @param mm - Dimension in millimeters
+ * @param unitResolution - Units per inch (300 for eSCL, scan DPI for non-eSCL)
+ */
+export declare function mmToScanUnits(mm: number, unitResolution: number): number;
+/**
+ * Converts a paper size preset name to dimensions in millimeters.
+ * Returns null for the "Max" pseudo-preset (caller must handle device max).
+ */
+export declare function paperSizePresetToMm(preset: string): PaperSizeMm | null;
+/**
+ * Parses a custom paper size string in the format "WxH<unit>".
+ * Supported units: mm, cm, in.
+ * Example: "21x29.7cm", "8.5x11in", "210x297mm"
+ */
+export declare function parsePaperSize(input: string): PaperSizeMm | null;
+/**
+ * Resolves a paper size configuration (preset name or custom dimension string)
+ * to millimeters, without any device clamping.
+ *
+ * - If both paperSizeInput and paperDimInput are provided, throws.
+ * - If "Max" preset is provided, returns null (caller owns device-max logic).
+ * - If neither is provided, returns null.
+ *
+ * @param paperSizeInput - Preset name (e.g. "A4", "Letter", "Max")
+ * @param paperDimInput  - Custom dimension string (e.g. "21x29.7cm")
+ * @param orientation    - Orientation ("portrait" or "landscape")
+ */
+export declare function validateAndResolvePaperSize(paperSizeInput?: string | null, paperDimInput?: string | null, orientation?: "portrait" | "landscape" | null): ResolvedPaperSize | null;
+/**
+ * Converts resolved paper size (in mm) to scan region units, clamped to device
+ * maximum dimensions (also expressed in the same unit space).
+ *
+ * This is the final step before submitting a ScanRegion to the device.
+ *
+ * @param resolvedMm     - Paper size in millimeters (from validateAndResolvePaperSize)
+ * @param unitResolution - Units per inch: use THREE_HUNDREDTHS_OF_INCH_DPI (300) for eSCL,
+ *                         or the scan DPI for non-eSCL devices
+ * @param maxWidth       - Device max width in device units (null = unconstrained)
+ * @param maxHeight      - Device max height in device units (null = unconstrained)
+ */
+export declare function paperSizeMmToScanRegion(resolvedMm: PaperSizeMm, unitResolution: number, maxWidth: number | null, maxHeight: number | null): ScanRegionUnits;
+/**
+ * Returns the default paper size (A4).
+ */
+export declare function getDefaultPaperSize(): PaperSizeMm;
+/**
+ * Returns true if the given preset string is the "Max" pseudo-preset.
+ */
+export declare function isMaxPreset(preset?: string | null): boolean;

package/dist/PaperSize.js

@@ -0,0 +1,179 @@
+/**
+ * Standard unit resolution (1/300 inch) used for eSCL ScanRegion (ThreeHundredthsOfInches)
+ * and potentially for non-eSCL legacy device configurations.
+ */
+export const THREE_HUNDREDTHS_OF_INCH_DPI = 300;
+/**
+ * Paper size preset mapping to dimensions in millimeters.
+ */
+const PAPER_SIZE_PRESETS = {
+    // ISO A-series
+    a3: { widthMm: 297, heightMm: 420 },
+    a4: { widthMm: 210, heightMm: 297 },
+    a5: { widthMm: 148, heightMm: 210 },
+    a6: { widthMm: 105, heightMm: 148 },
+    a7: { widthMm: 74, heightMm: 105 },
+    a8: { widthMm: 52, heightMm: 74 },
+    // ISO B-series (JIS)
+    b4: { widthMm: 250, heightMm: 353 },
+    b5: { widthMm: 176, heightMm: 250 },
+    b6: { widthMm: 125, heightMm: 176 },
+    // North American
+    letter: { widthMm: 215.9, heightMm: 279.4 },
+    legal: { widthMm: 215.9, heightMm: 355.6 },
+    executive: { widthMm: 184.2, heightMm: 266.7 },
+    statement: { widthMm: 139.7, heightMm: 215.9 },
+    tabloid: { widthMm: 279.4, heightMm: 431.8 },
+    ledger: { widthMm: 431.8, heightMm: 279.4 }, // tabloid landscape
+    oficio: { widthMm: 215.9, heightMm: 330.2 }, // Latin America
+    folio: { widthMm: 215.9, heightMm: 330.2 },
+    // Photo
+    "4x6": { widthMm: 101.6, heightMm: 152.4 },
+    "5x7": { widthMm: 127, heightMm: 177.8 },
+    "8x10": { widthMm: 203.2, heightMm: 254 },
+    "10x15": { widthMm: 100, heightMm: 150 },
+    // Autres
+    "business-card": { widthMm: 85.6, heightMm: 53.98 },
+};
+/**
+ * Converts millimeters to scan region units using the given unit resolution.
+ *
+ * @param mm - Dimension in millimeters
+ * @param unitResolution - Units per inch (300 for eSCL, scan DPI for non-eSCL)
+ */
+export function mmToScanUnits(mm, unitResolution) {
+    return Math.round((mm / 25.4) * unitResolution);
+}
+/**
+ * Converts a paper size preset name to dimensions in millimeters.
+ * Returns null for the "Max" pseudo-preset (caller must handle device max).
+ */
+export function paperSizePresetToMm(preset) {
+    const normalized = preset.toLowerCase().trim();
+    if (normalized === "max") {
+        return null;
+    }
+    return PAPER_SIZE_PRESETS[normalized] ?? null;
+}
+/**
+ * Parses a custom paper size string in the format "WxH<unit>".
+ * Supported units: mm, cm, in.
+ * Example: "21x29.7cm", "8.5x11in", "210x297mm"
+ */
+export function parsePaperSize(input) {
+    const match = /^(\d+(?:\.\d+)?)\s*[xX]\s*(\d+(?:\.\d+)?)\s*(cm|mm|in)$/i.exec(input.trim());
+    if (!match) {
+        return null;
+    }
+    const width = parseFloat(match[1]);
+    const height = parseFloat(match[2]);
+    const unit = match[3].toLowerCase();
+    if (isNaN(width) || isNaN(height) || width <= 0 || height <= 0) {
+        return null;
+    }
+    switch (unit) {
+        case "cm":
+            return { widthMm: width * 10, heightMm: height * 10 };
+        case "in":
+            return { widthMm: width * 25.4, heightMm: height * 25.4 };
+        default:
+            return { widthMm: width, heightMm: height };
+    }
+}
+/**
+ * Resolves a paper size configuration (preset name or custom dimension string)
+ * to millimeters, without any device clamping.
+ *
+ * - If both paperSizeInput and paperDimInput are provided, throws.
+ * - If "Max" preset is provided, returns null (caller owns device-max logic).
+ * - If neither is provided, returns null.
+ *
+ * @param paperSizeInput - Preset name (e.g. "A4", "Letter", "Max")
+ * @param paperDimInput  - Custom dimension string (e.g. "21x29.7cm")
+ * @param orientation    - Orientation ("portrait" or "landscape")
+ */
+export function validateAndResolvePaperSize(paperSizeInput, paperDimInput, orientation) {
+    const normalizedSize = typeof paperSizeInput === "string"
+        ? paperSizeInput.trim() || undefined
+        : undefined;
+    const normalizedDim = typeof paperDimInput === "string"
+        ? paperDimInput.trim() || undefined
+        : undefined;
+    if (normalizedSize !== undefined && normalizedDim !== undefined) {
+        throw new Error("Cannot specify both --paper-size and --paper-dim. Choose one.");
+    }
+    if (normalizedDim !== undefined) {
+        const parsed = parsePaperSize(normalizedDim);
+        if (!parsed) {
+            throw new Error(`Invalid paper dimension format: "${normalizedDim}". ` +
+                'Use "21x29.7cm", "8.5x11in", or "210x297mm".');
+        }
+        return { resolvedMm: parsed, source: `Custom (${normalizedDim})` };
+    }
+    if (normalizedSize !== undefined) {
+        if (normalizedSize.toLowerCase() === "max") {
+            // Caller is responsible for substituting device max dimensions.
+            return null;
+        }
+        const preset = paperSizePresetToMm(normalizedSize);
+        if (!preset) {
+            throw new Error(`Unknown paper size preset: "${normalizedSize}".`);
+        }
+        let resolvedMm = { ...preset };
+        if (orientation === "landscape" &&
+            resolvedMm.widthMm < resolvedMm.heightMm) {
+            resolvedMm = {
+                widthMm: resolvedMm.heightMm,
+                heightMm: resolvedMm.widthMm,
+            };
+        }
+        else if (orientation === "portrait" &&
+            resolvedMm.widthMm > resolvedMm.heightMm) {
+            resolvedMm = {
+                widthMm: resolvedMm.heightMm,
+                heightMm: resolvedMm.widthMm,
+            };
+        }
+        return { resolvedMm, source: normalizedSize.toUpperCase() };
+    }
+    return null;
+}
+/**
+ * Converts resolved paper size (in mm) to scan region units, clamped to device
+ * maximum dimensions (also expressed in the same unit space).
+ *
+ * This is the final step before submitting a ScanRegion to the device.
+ *
+ * @param resolvedMm     - Paper size in millimeters (from validateAndResolvePaperSize)
+ * @param unitResolution - Units per inch: use THREE_HUNDREDTHS_OF_INCH_DPI (300) for eSCL,
+ *                         or the scan DPI for non-eSCL devices
+ * @param maxWidth       - Device max width in device units (null = unconstrained)
+ * @param maxHeight      - Device max height in device units (null = unconstrained)
+ */
+export function paperSizeMmToScanRegion(resolvedMm, unitResolution, maxWidth, maxHeight) {
+    let width = mmToScanUnits(resolvedMm.widthMm, unitResolution);
+    let height = mmToScanUnits(resolvedMm.heightMm, unitResolution);
+    if (maxWidth !== null) {
+        width = Math.min(width, maxWidth);
+    }
+    if (maxHeight !== null) {
+        height = Math.min(height, maxHeight);
+    }
+    return {
+        width: Math.max(1, width),
+        height: Math.max(1, height),
+    };
+}
+/**
+ * Returns the default paper size (A4).
+ */
+export function getDefaultPaperSize() {
+    return { widthMm: 210, heightMm: 297 };
+}
+/**
+ * Returns true if the given preset string is the "Max" pseudo-preset.
+ */
+export function isMaxPreset(preset) {
+    return preset?.toLowerCase().trim() === "max";
+}
+//# sourceMappingURL=PaperSize.js.map

package/dist/PaperSize.js.map

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

package/dist/commitInfo.json

@@ -1,3 +1,3 @@
 {
-    "commitId": "95dcb900e9a881e074db7f6a448822fcf6b3c54c"
+    "commitId": "ce94a1b2f34964a43eb808b85ae71a9a41afe64d"
 }

package/dist/hpModels/Job.d.ts

@@ -26,7 +26,8 @@ export interface JobData {
 export declare enum JobState {
     Completed = "Completed",
     Processing = "Processing",
-    Canceled = "Canceled"
+    Canceled = "Canceled",
+    Blocked = "Blocked"
 }
 export declare enum PageState {
     ReadyToUpload = "ReadyToUpload",

package/dist/hpModels/Job.js

@@ -6,6 +6,7 @@ export var JobState;
     JobState["Completed"] = "Completed";
     JobState["Processing"] = "Processing";
     JobState["Canceled"] = "Canceled";
+    JobState["Blocked"] = "Blocked";
 })(JobState || (JobState = {}));
 export var PageState;
 (function (PageState) {

package/dist/hpModels/Job.js.map

@@ -1 +1 @@
-{"version":3,"file":"Job.js","sourceRoot":"","sources":["../../src/hpModels/Job.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AA4B3C,MAAM,CAAN,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,mCAAuB,CAAA;IACvB,qCAAyB,CAAA;IACzB,iCAAqB,CAAA;AACvB,CAAC,EAJW,QAAQ,KAAR,QAAQ,QAInB;AAED,MAAM,CAAN,IAAY,SAGX;AAHD,WAAY,SAAS;IACnB,4CAA+B,CAAA;IAC/B,4CAA+B,CAAA;AACjC,CAAC,EAHW,SAAS,KAAT,SAAS,QAGpB;AAED,MAAM,CAAC,OAAO,OAAO,GAAG;IACL,IAAI,CAAU;IAC/B,YAAY,IAAa;QACvB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,OAAe;QACpC,MAAM,MAAM,GAAG,MAAM,cAAc,CAAU,OAAO,CAAC,CAAC;QACtD,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,iBAAiB;QACnB,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAC9D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACtC,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,eAAe;QACjB,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;YAC/C,OAAO,QAAQ,CACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,EAC3D,EAAE,CACH,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ;QACV,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;QACxD,OAAO,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAC/D,CAAC;IAED,IAAI,SAAS;QACX,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAE9D,IAAI,WAAW,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC,QAAQ,CACvB,WAAW,EACX,SAAS,EACT,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAC5B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,IAAI,SAAS;QACX,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU;QACZ,IACE,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CACnC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAC7B,aAAa,CACd,EACD,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,QAAQ,CACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;YAC7D,EAAE,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CACxB,CAAC;IACJ,CAAC;IACD,IAAI,WAAW;QACb,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9C,OAAO,QAAQ,CACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;iBACvD,WAAW,CAAC,CAAC,CAAC,CAClB,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,WAAW;QACb,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9C,OAAO,QAAQ,CACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;gBAC3D,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAC5C,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,WAAW;QACb,IACE,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAClC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAC7B,aAAa,CACd,EACD,CAAC;YACD,OAAO,QAAQ,CACb,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;gBAC7D,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAC5C,CAAC;QACJ,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"Job.js","sourceRoot":"","sources":["../../src/hpModels/Job.ts"],"names":[],"mappings":"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"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,sDAAsD;AAEtD,YAAY,CAAC;AAEb,OAAO,MAAM,EAAE,EAAgB,MAAM,QAAQ,CAAC;AAC9C,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,UAAU,MAAM,mBAAmB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjE,OAAO,EAAE,YAAY,EAAmB,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,cAAc,GAAG,CAAC,MAAe,EAAE,EAAE;IACzC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAe,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAEzC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAClE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,sDAAsD;AAEtD,YAAY,CAAC;AAEb,OAAO,MAAM,EAAE,EAAe,MAAM,QAAQ,CAAC;AAC7C,OAAO,CAAC,MAAM,KAAK,CAAC;AACpB,OAAO,UAAU,MAAM,mBAAmB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACjE,OAAO,EAAE,YAAY,EAAmB,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,cAAc,GAAG,CAAC,MAAc,EAAE,EAAE;IACxC,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7C,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,UAAU,GAAe,cAAc,CAAC,MAAM,CAAC,CAAC;IAEtD,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAEzC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC;AAED,OAAO,CAAC,GAAG,CAAC,+BAA+B,UAAU,CAAC,QAAQ,EAAE,CAAC,CAAC;AAClE,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC"}

package/dist/program.js

@@ -43,8 +43,30 @@ function setupScanParameters(commandName) {
         .addOption(new Option("--mode <mode>", "Selects the scan mode (default: Color)")
         .choices(["Gray", "Color"])
         .helpGroup(HelpGroupsHeadings.scan))
-        .addOption(new Option("-w, --width <width>", "Width in pixels of the scans (default: max)").helpGroup(HelpGroupsHeadings.scan))
-        .addOption(new Option("-h, --height <height>", "Height in pixels of the scans (default: max)").helpGroup(HelpGroupsHeadings.scan))
+        .addOption(new Option("-w, --width <width>", "Width in pixels of the scans (default: max)")
+        .conflicts("paperSize")
+        .conflicts("paperDim")
+        .helpGroup(HelpGroupsHeadings.scan))
+        .addOption(new Option("-h, --height <height>", "Height in pixels of the scans (default: max)")
+        .conflicts("paperSize")
+        .conflicts("paperDim")
+        .helpGroup(HelpGroupsHeadings.scan))
+        .addOption(new Option("--paper-size <size>", "Paper size preset: A4 (default), Letter, Legal, A5, B5, or Max (case-insensitive)")
+        .conflicts("paperDim")
+        .conflicts("width")
+        .conflicts("height")
+        .helpGroup(HelpGroupsHeadings.scan))
+        .addOption(new Option("--paper-orientation <orientation>", "Paper orientation: portrait (default) or landscape. Applied to --paper-size only.")
+        .choices(["portrait", "landscape"])
+        .conflicts("paperDim")
+        .conflicts("width")
+        .conflicts("height")
+        .helpGroup(HelpGroupsHeadings.scan))
+        .addOption(new Option("--paper-dim <dimensions>", "Custom paper dimensions with unit (e.g., 21x29.7cm, 8.5x11in, 210x297mm). Cannot be used with --paper-size.")
+        .conflicts("paperSize")
+        .conflicts("width")
+        .conflicts("height")
+        .helpGroup(HelpGroupsHeadings.scan))
         .addOption(new Option("-t, --temp-directory <dir>", "Temp directory used for processing (default: /tmp/scan-to-pcRANDOM)").helpGroup(HelpGroupsHeadings.scan))
         .addOption(new Option("--prefer-eSCL", "Prefer eSCL protocol if available").helpGroup(HelpGroupsHeadings.scan))
         .option("--device-up-polling-interval <deviceUpPollingInterval>", "Device up polling interval in milliseconds", parseFloat)
@@ -176,24 +198,40 @@ function getScanConfiguration(options, fileConfig) {
         tempDirectory: getOptConfiguredValue(options.tempDirectory, fileConfig.tempDirectory),
         filePattern: getOptConfiguredValue(options.pattern, fileConfig.pattern),
     };
-    const configWidth = getConfiguredValue(options.width, fileConfig.width?.toString(), "0");
-    const width = configWidth.toLowerCase() === "max"
-        ? Number.MAX_SAFE_INTEGER
-        : parseInt(configWidth, 10);
-    const configHeight = getConfiguredValue(options.height, fileConfig.height?.toString(), "0");
-    const height = configHeight.toLowerCase() === "max"
-        ? Number.MAX_SAFE_INTEGER
-        : parseInt(configHeight, 10);
     const paperlessConfig = getPaperlessConfig(options, fileConfig);
     const nextcloudConfig = getNextcloudConfig(options, fileConfig);
     const resolution = parseInt(getConfiguredValue(options.resolution, fileConfig.resolution?.toString(), "200"), 10);
     const mode = getConfiguredValue(options.mode, fileConfig.mode, ScanMode.Color);
     const preferEscl = getConfiguredValue(options.preferESCL, fileConfig.prefer_escl, false);
+    // Paper size configuration with precedence: CLI > Config > default (A4)
+    const paperSize = getOptConfiguredValue(options.paperSize, fileConfig.paper_size);
+    const paperDim = getOptConfiguredValue(options.paperDim, fileConfig.paper_dim);
+    const paperOrientation = getOptConfiguredValue(options.paperOrientation, fileConfig.paper_orientation);
+    const hasPaperSizeConfig = paperSize !== undefined || paperDim !== undefined;
+    const configWidth = getOptConfiguredValue(options.width, fileConfig.width?.toString());
+    const configHeight = getOptConfiguredValue(options.height, fileConfig.height?.toString());
+    if (hasPaperSizeConfig &&
+        (configWidth !== undefined || configHeight !== undefined)) {
+        throw new Error("Cannot specify both width/height and paper size (paper_size/paper_dim). Choose one or the other.");
+    }
+    const providedWidth = configWidth === undefined
+        ? undefined
+        : configWidth.toLowerCase() === "max"
+            ? "max"
+            : parseInt(configWidth, 10);
+    const providedHeight = configHeight === undefined
+        ? undefined
+        : configHeight.toLowerCase() === "max"
+            ? undefined
+            : parseInt(configHeight, 10);
     const scanConfig = {
         resolution,
         mode,
-        width: width,
-        height: height,
+        width: providedWidth,
+        height: providedHeight,
+        paperSize,
+        paperDim,
+        paperOrientation,
         directoryConfig,
         paperlessConfig,
         nextcloudConfig,