@crowsgear/escl-protocol-scanner 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,69 @@
+/**
+ * eSCL Protocol Client for Node.js
+ * HTTP client for communicating with eSCL/AirPrint network scanners
+ */
+import { ESCLScanner, ESCLCapabilities } from './types';
+/**
+ * eSCL HTTP Client
+ * Handles all HTTP communication with eSCL-compatible network scanners
+ */
+export declare class ESCLClient {
+    private timeout;
+    constructor(timeout?: number);
+    /**
+     * Get scanner capabilities
+     * @param scanner Target scanner
+     * @param debug Enable debug logging (default: false)
+     * @returns Scanner capabilities
+     */
+    getCapabilities(scanner: ESCLScanner, debug?: boolean): Promise<ESCLCapabilities | null>;
+    /**
+     * Start scan job
+     * @param scanner Target scanner
+     * @param dpi Resolution in DPI
+     * @param colorMode Color mode (BlackAndWhite1, Grayscale8, RGB24)
+     * @param source Scan source (Platen, Feeder)
+     * @returns Scan job UUID
+     */
+    createScanJob(scanner: ESCLScanner, dpi: number, colorMode: string, source: string): Promise<string | null>;
+    /**
+     * Poll scan job status
+     * @param scanner Target scanner
+     * @param jobId Scan job ID
+     * @returns Job status and image URLs if complete
+     */
+    getScanJobStatus(scanner: ESCLScanner, jobId: string): Promise<{
+        status: 'Processing' | 'Completed' | 'Aborted' | 'Unknown';
+        images: string[];
+    }>;
+    /**
+     * Download scanned image
+     * @param scanner Target scanner
+     * @param imageUrl Relative image URL
+     * @returns PNG image data as Buffer
+     */
+    downloadImage(scanner: ESCLScanner, imageUrl: string): Promise<Buffer | null>;
+    /**
+     * Build eSCL scan settings XML
+     */
+    private buildScanSettings;
+    /**
+     * Parse scanner capabilities from XML response
+     * @param xml XML response from scanner
+     * @param debug Enable debug logging (default: false)
+     */
+    private parseCapabilities;
+    /**
+     * HTTP GET request
+     */
+    private httpGet;
+    /**
+     * HTTP GET request (binary)
+     */
+    private httpGetBinary;
+    /**
+     * HTTP POST request
+     */
+    private httpPost;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAgB,MAAM,SAAS,CAAC;AAEtE;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAiB;gBAEpB,OAAO,CAAC,EAAE,MAAM;IAM5B;;;;;OAKG;IACG,eAAe,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAarG;;;;;;;OAOG;IACG,aAAa,CACjB,OAAO,EAAE,WAAW,EACpB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBzB;;;;;OAKG;IACG,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QACnE,MAAM,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;QAC3D,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC;IAyBF;;;;;OAKG;IACG,aAAa,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUnF;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA8BzB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAqEzB;;OAEG;IACH,OAAO,CAAC,OAAO;IAyBf;;OAEG;IACH,OAAO,CAAC,aAAa;IAyBrB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAmCjB"}

package/dist/client.js

@@ -0,0 +1,320 @@
+"use strict";
+/**
+ * eSCL Protocol Client for Node.js
+ * HTTP client for communicating with eSCL/AirPrint network scanners
+ */
+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.ESCLClient = void 0;
+const http = __importStar(require("http"));
+/**
+ * eSCL HTTP Client
+ * Handles all HTTP communication with eSCL-compatible network scanners
+ */
+class ESCLClient {
+    constructor(timeout) {
+        this.timeout = 10000;
+        if (timeout) {
+            this.timeout = timeout;
+        }
+    }
+    /**
+     * Get scanner capabilities
+     * @param scanner Target scanner
+     * @param debug Enable debug logging (default: false)
+     * @returns Scanner capabilities
+     */
+    async getCapabilities(scanner, debug = false) {
+        try {
+            const response = await this.httpGet(`http://${scanner.host}:${scanner.port}/eSCL/ScannerCapabilities`);
+            return this.parseCapabilities(response, debug);
+        }
+        catch (error) {
+            console.error(`Failed to get capabilities for ${scanner.name}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Start scan job
+     * @param scanner Target scanner
+     * @param dpi Resolution in DPI
+     * @param colorMode Color mode (BlackAndWhite1, Grayscale8, RGB24)
+     * @param source Scan source (Platen, Feeder)
+     * @returns Scan job UUID
+     */
+    async createScanJob(scanner, dpi, colorMode, source) {
+        try {
+            const scanSettings = this.buildScanSettings(dpi, colorMode, source);
+            const jobResponse = await this.httpPost(`http://${scanner.host}:${scanner.port}/eSCL/ScanJobs`, scanSettings);
+            // Extract job UUID from Location header or response
+            const jobMatch = jobResponse.match(/\/eSCL\/ScanJobs\/([a-f0-9-]+)/);
+            if (jobMatch) {
+                return jobMatch[1];
+            }
+            return null;
+        }
+        catch (error) {
+            console.error(`Failed to create scan job on ${scanner.name}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Poll scan job status
+     * @param scanner Target scanner
+     * @param jobId Scan job ID
+     * @returns Job status and image URLs if complete
+     */
+    async getScanJobStatus(scanner, jobId) {
+        try {
+            const response = await this.httpGet(`http://${scanner.host}:${scanner.port}/eSCL/ScanJobs/${jobId}`);
+            const status = response.match(/<JobState>(\w+)<\/JobState>/)?.[1] || 'Unknown';
+            const images = [];
+            // Extract image URLs
+            const imageMatches = response.matchAll(/<DocumentURI>([^<]+)<\/DocumentURI>/g);
+            for (const match of imageMatches) {
+                images.push(match[1]);
+            }
+            return {
+                status: status,
+                images
+            };
+        }
+        catch (error) {
+            console.error(`Failed to get scan job status:`, error);
+            return { status: 'Unknown', images: [] };
+        }
+    }
+    /**
+     * Download scanned image
+     * @param scanner Target scanner
+     * @param imageUrl Relative image URL
+     * @returns PNG image data as Buffer
+     */
+    async downloadImage(scanner, imageUrl) {
+        try {
+            const fullUrl = `http://${scanner.host}:${scanner.port}${imageUrl}`;
+            return await this.httpGetBinary(fullUrl);
+        }
+        catch (error) {
+            console.error(`Failed to download image:`, error);
+            return null;
+        }
+    }
+    /**
+     * Build eSCL scan settings XML
+     */
+    buildScanSettings(dpi, colorMode, source) {
+        // Match the Python implementation which uses proper namespaces
+        const ESCL_NS = 'http://schemas.hp.com/imaging/escl/2011/05/03';
+        const PWG_NS = 'http://www.pwg.org/schemas/2010/12/sm';
+        return `<?xml version="1.0" encoding="UTF-8"?>
+<scan:ScanSettings xmlns:scan="${ESCL_NS}" xmlns:pwg="${PWG_NS}">
+  <pwg:Version>2.0</pwg:Version>
+  <scan:Intent>Document</scan:Intent>
+  <pwg:ScanRegions>
+    <pwg:ScanRegion>
+      <pwg:ContentRegionUnits>escl:ThreeHundredthsOfInches</pwg:ContentRegionUnits>
+      <pwg:XOffset>0</pwg:XOffset>
+      <pwg:YOffset>0</pwg:YOffset>
+      <pwg:Width>3508</pwg:Width>
+      <pwg:Height>4961</pwg:Height>
+    </pwg:ScanRegion>
+  </pwg:ScanRegions>
+  <scan:Justification>
+    <pwg:XImagePosition>Center</pwg:XImagePosition>
+    <pwg:YImagePosition>Center</pwg:YImagePosition>
+  </scan:Justification>
+  <pwg:InputSource>${source}</pwg:InputSource>
+  <scan:ColorMode>${colorMode}</scan:ColorMode>
+  <scan:XResolution>${dpi}</scan:XResolution>
+  <scan:YResolution>${dpi}</scan:YResolution>
+  <pwg:DocumentFormat>image/jpeg</pwg:DocumentFormat>
+</scan:ScanSettings>`;
+    }
+    /**
+     * Parse scanner capabilities from XML response
+     * @param xml XML response from scanner
+     * @param debug Enable debug logging (default: false)
+     */
+    parseCapabilities(xml, debug = false) {
+        const resolutions = [];
+        const colorModes = [];
+        const sources = [];
+        // Debug: Print raw XML for inspection (only if debug enabled)
+        if (debug) {
+            console.log('[eSCL] Capabilities XML response (full):');
+            console.log(xml);
+        }
+        // eSCL uses XML namespaces, need to handle scan: and pwg: prefixes
+        // Extract resolutions - look for XResolution inside DiscreteResolution
+        const discreteResMatches = xml.matchAll(/<[a-z]*:?DiscreteResolution>[\s\S]*?<[a-z]*:?XResolution>(\d+)<\/[a-z]*:?XResolution>[\s\S]*?<\/[a-z]*:?DiscreteResolution>/g);
+        for (const match of discreteResMatches) {
+            resolutions.push(parseInt(match[1], 10));
+        }
+        // Also try simpler pattern for XResolution
+        if (resolutions.length === 0) {
+            const xResMatches = xml.matchAll(/<[a-z]*:?XResolution>(\d+)<\/[a-z]*:?XResolution>/g);
+            for (const match of xResMatches) {
+                const res = parseInt(match[1], 10);
+                if (!resolutions.includes(res)) {
+                    resolutions.push(res);
+                }
+            }
+        }
+        // Extract color modes - handle namespaced tags
+        const colorMatches = xml.matchAll(/<[a-z]*:?ColorMode>(\w+)<\/[a-z]*:?ColorMode>/g);
+        for (const match of colorMatches) {
+            const mode = match[1];
+            if (['BlackAndWhite1', 'Grayscale8', 'RGB24'].includes(mode)) {
+                colorModes.push(mode);
+            }
+        }
+        // Extract sources - look for InputSource tags or check for Platen/Adf elements
+        const sourceMatches = xml.matchAll(/<[a-z]*:?InputSource>(\w+)<\/[a-z]*:?InputSource>/g);
+        for (const match of sourceMatches) {
+            const source = match[1];
+            if (['Platen', 'Adf', 'Feeder'].includes(source)) {
+                sources.push(source);
+            }
+        }
+        // If no InputSource tags found, check for Platen/Adf elements directly
+        if (sources.length === 0) {
+            if (/<[a-z]*:?Platen[\s>]/.test(xml)) {
+                sources.push('Platen');
+            }
+            if (/<[a-z]*:?Adf[\s>]/.test(xml)) {
+                sources.push('Adf');
+            }
+        }
+        // Remove duplicates from resolutions
+        const uniqueResolutions = Array.from(new Set(resolutions)).sort((a, b) => a - b);
+        const uniqueColorModes = Array.from(new Set(colorModes));
+        const uniqueSources = Array.from(new Set(sources));
+        if (debug) {
+            console.log('[eSCL] Parsed capabilities:', { resolutions: uniqueResolutions, colorModes: uniqueColorModes, sources: uniqueSources });
+        }
+        return { resolutions: uniqueResolutions, colorModes: uniqueColorModes, sources: uniqueSources };
+    }
+    /**
+     * HTTP GET request
+     */
+    httpGet(url) {
+        return new Promise((resolve, reject) => {
+            const req = http.get(url, { timeout: this.timeout }, (res) => {
+                let data = '';
+                res.on('data', (chunk) => {
+                    data += chunk;
+                });
+                res.on('end', () => {
+                    if (res.statusCode === 200) {
+                        resolve(data);
+                    }
+                    else {
+                        reject(new Error(`HTTP ${res.statusCode}`));
+                    }
+                });
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                reject(new Error('Request timeout'));
+            });
+            req.on('error', reject);
+        });
+    }
+    /**
+     * HTTP GET request (binary)
+     */
+    httpGetBinary(url) {
+        return new Promise((resolve, reject) => {
+            const req = http.get(url, { timeout: this.timeout }, (res) => {
+                const chunks = [];
+                res.on('data', (chunk) => {
+                    chunks.push(chunk);
+                });
+                res.on('end', () => {
+                    if (res.statusCode === 200) {
+                        resolve(Buffer.concat(chunks));
+                    }
+                    else {
+                        reject(new Error(`HTTP ${res.statusCode}`));
+                    }
+                });
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                reject(new Error('Request timeout'));
+            });
+            req.on('error', reject);
+        });
+    }
+    /**
+     * HTTP POST request
+     */
+    httpPost(url, body) {
+        return new Promise((resolve, reject) => {
+            const options = {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/xml',
+                    'Content-Length': Buffer.byteLength(body)
+                },
+                timeout: this.timeout
+            };
+            const req = http.request(url, options, (res) => {
+                let data = '';
+                res.on('data', (chunk) => {
+                    data += chunk;
+                });
+                res.on('end', () => {
+                    if (res.statusCode === 201 || res.statusCode === 200) {
+                        resolve(data || res.headers.location || '');
+                    }
+                    else {
+                        reject(new Error(`HTTP ${res.statusCode}`));
+                    }
+                });
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                reject(new Error('Request timeout'));
+            });
+            req.on('error', reject);
+            req.write(body);
+            req.end();
+        });
+    }
+}
+exports.ESCLClient = ESCLClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/discovery.d.ts

@@ -0,0 +1,71 @@
+/**
+ * eSCL Scanner Discovery via Python Subprocess
+ * Uses Python's zeroconf library for mDNS discovery
+ */
+import { ESCLScanner, DiscoveryResponse } from './types';
+/**
+ * eSCL Scanner Discovery Service Options
+ */
+export interface ESCLDiscoveryOptions {
+    /** Custom Python executable path (e.g., /path/to/venv/bin/python3) */
+    pythonPath?: string;
+}
+/**
+ * eSCL Scanner Discovery Service
+ * Spawns Python subprocess to handle mDNS discovery using zeroconf
+ */
+export declare class ESCLDiscovery {
+    private pythonProcess;
+    private discovered;
+    private listeners;
+    private timeout;
+    private processReady;
+    private pythonPath;
+    constructor(timeout?: number, options?: ESCLDiscoveryOptions);
+    /**
+     * Validate Python path exists and is executable
+     * @throws Error if Python path is invalid
+     */
+    private validatePythonPath;
+    /**
+     * Start discovering scanners
+     * @param timeout Optional timeout in milliseconds (default: 5000ms)
+     * @returns Promise resolving with discovery response containing success status and scanner data
+     */
+    startDiscovery(timeout?: number): Promise<DiscoveryResponse>;
+    /**
+     * Stop active discovery and cleanup subprocess
+     */
+    stopDiscovery(): void;
+    /**
+     * Get currently discovered scanners
+     */
+    getScanners(): ESCLScanner[];
+    /**
+     * Subscribe to scanner discovery updates
+     */
+    onScannerDiscovered(callback: (scanners: ESCLScanner[]) => void): void;
+    /**
+     * Unsubscribe from scanner discovery updates
+     */
+    offScannerDiscovered(callback: (scanners: ESCLScanner[]) => void): void;
+    /**
+     * Start Python subprocess for eSCL operations
+     */
+    private startPythonService;
+    /**
+     * Cleanup Python subprocess
+     */
+    private cleanup;
+    /**
+     * Notify all listeners of scanner changes
+     */
+    private notifyListeners;
+}
+/**
+ * Convenience function for quick scanner discovery
+ * @param timeout Discovery timeout in milliseconds (default: 5000)
+ * @returns Discovery response with success status and scanner data
+ */
+export declare function discoverScanners(timeout?: number): Promise<DiscoveryResponse>;
+//# sourceMappingURL=discovery.d.ts.map

package/dist/discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.ts","sourceRoot":"","sources":["../src/discovery.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAAE,WAAW,EAA6B,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,aAAa,CAA6B;IAClD,OAAO,CAAC,UAAU,CAAuC;IACzD,OAAO,CAAC,SAAS,CAAqD;IACtE,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,UAAU,CAAqB;gBAE3B,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB;IAS5D;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAuB1B;;;;OAIG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoDlE;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;OAEG;IACH,WAAW,IAAI,WAAW,EAAE;IAI5B;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,IAAI;IAItE;;OAEG;IACH,oBAAoB,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,GAAG,IAAI;IAIvE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA6D1B;;OAEG;IACH,OAAO,CAAC,OAAO;IA2Bf;;OAEG;IACH,OAAO,CAAC,eAAe;CAMxB;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAGzF"}