@ecobridge.xyz/devicemanager 3.0.2

package/dist_ts/features/feature.print.js

@@ -0,0 +1,226 @@
+/**
+ * Print Feature
+ * Provides document printing capability using IPP protocol
+ */
+import { Feature } from './feature.abstract.js';
+import { IppProtocol } from '../protocols/index.js';
+/**
+ * Print Feature - provides document printing capability
+ *
+ * Wraps the IPP protocol to provide a unified printing interface.
+ *
+ * @example
+ * ```typescript
+ * const printFeature = device.getFeature<PrintFeature>('print');
+ * if (printFeature) {
+ *   await printFeature.connect();
+ *   const job = await printFeature.print(pdfBuffer, { copies: 2 });
+ *   console.log(`Print job ${job.id} created`);
+ * }
+ * ```
+ */
+export class PrintFeature extends Feature {
+    type = 'print';
+    protocol;
+    // Protocol client
+    ippClient = null;
+    // Configuration
+    uri;
+    // Capabilities
+    supportsColor = true;
+    supportsDuplex = false;
+    supportedMediaSizes = ['iso_a4_210x297mm', 'na_letter_8.5x11in'];
+    supportedMediaTypes = ['stationery'];
+    maxCopies = 99;
+    supportedSides = ['one-sided'];
+    supportedQualities = ['normal'];
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options?.protocol ?? 'ipp';
+        this.uri = options?.uri ?? `ipp://${device.address}:${port}/ipp/print`;
+        // Set capabilities from options if provided
+        if (options?.supportsColor !== undefined)
+            this.supportsColor = options.supportsColor;
+        if (options?.supportsDuplex !== undefined) {
+            this.supportsDuplex = options.supportsDuplex;
+            if (options.supportsDuplex) {
+                this.supportedSides = ['one-sided', 'two-sided-long-edge', 'two-sided-short-edge'];
+            }
+        }
+        if (options?.supportedMediaSizes)
+            this.supportedMediaSizes = options.supportedMediaSizes;
+        if (options?.supportedMediaTypes)
+            this.supportedMediaTypes = options.supportedMediaTypes;
+        if (options?.maxCopies)
+            this.maxCopies = options.maxCopies;
+    }
+    // ============================================================================
+    // Connection
+    // ============================================================================
+    async doConnect() {
+        if (this.protocol === 'ipp') {
+            // Parse URI to get address, port, and path
+            const url = new URL(this.uri.replace('ipp://', 'http://').replace('ipps://', 'https://'));
+            const address = url.hostname;
+            const port = parseInt(url.port) || this._port;
+            const path = url.pathname || '/ipp/print';
+            this.ippClient = new IppProtocol(address, port, path);
+            // Verify connection by getting printer attributes
+            const attrs = await this.ippClient.getAttributes();
+            this.updateCapabilitiesFromIpp(attrs);
+        }
+        // JetDirect and LPD don't need connection verification
+    }
+    async doDisconnect() {
+        this.ippClient = null;
+    }
+    // ============================================================================
+    // Printing Operations
+    // ============================================================================
+    /**
+     * Get printer capabilities
+     */
+    async getCapabilities() {
+        return {
+            colorSupported: this.supportsColor,
+            duplexSupported: this.supportsDuplex,
+            mediaSizes: this.supportedMediaSizes,
+            mediaTypes: this.supportedMediaTypes,
+            resolutions: [300, 600],
+            maxCopies: this.maxCopies,
+            sidesSupported: this.supportedSides,
+            qualitySupported: this.supportedQualities,
+        };
+    }
+    /**
+     * Print a document
+     */
+    async print(data, options) {
+        if (!this.isConnected) {
+            throw new Error('Print feature not connected');
+        }
+        if (this.protocol === 'ipp' && this.ippClient) {
+            return this.printWithIpp(data, options);
+        }
+        throw new Error(`Protocol ${this.protocol} not supported yet`);
+    }
+    /**
+     * Get active print jobs
+     */
+    async getJobs() {
+        if (!this.isConnected || !this.ippClient) {
+            throw new Error('Print feature not connected');
+        }
+        return this.ippClient.getJobs();
+    }
+    /**
+     * Get info about a specific job
+     */
+    async getJobInfo(jobId) {
+        if (!this.isConnected || !this.ippClient) {
+            throw new Error('Print feature not connected');
+        }
+        return this.ippClient.getJobInfo(jobId);
+    }
+    /**
+     * Cancel a print job
+     */
+    async cancelJob(jobId) {
+        if (!this.isConnected || !this.ippClient) {
+            throw new Error('Print feature not connected');
+        }
+        await this.ippClient.cancelJob(jobId);
+        this.emit('job:cancelled', jobId);
+    }
+    // ============================================================================
+    // Protocol-Specific Printing
+    // ============================================================================
+    async printWithIpp(data, options) {
+        if (!this.ippClient) {
+            throw new Error('IPP client not initialized');
+        }
+        this.emit('print:started', options);
+        // IppProtocol.print() accepts IPrintOptions and returns IPrintJob
+        const job = await this.ippClient.print(data, options);
+        this.emit('print:submitted', job);
+        return job;
+    }
+    // ============================================================================
+    // Helper Methods
+    // ============================================================================
+    updateCapabilitiesFromIpp(caps) {
+        this.supportsColor = caps.colorSupported;
+        this.supportsDuplex = caps.duplexSupported;
+        this.maxCopies = caps.maxCopies;
+        if (caps.mediaSizes && caps.mediaSizes.length > 0) {
+            this.supportedMediaSizes = caps.mediaSizes;
+        }
+        if (caps.mediaTypes && caps.mediaTypes.length > 0) {
+            this.supportedMediaTypes = caps.mediaTypes;
+        }
+        if (caps.sidesSupported && caps.sidesSupported.length > 0) {
+            this.supportedSides = caps.sidesSupported.filter((s) => ['one-sided', 'two-sided-long-edge', 'two-sided-short-edge'].includes(s));
+        }
+        if (caps.qualitySupported && caps.qualitySupported.length > 0) {
+            this.supportedQualities = caps.qualitySupported.filter((q) => ['draft', 'normal', 'high'].includes(q));
+        }
+    }
+    qualityToIpp(quality) {
+        switch (quality) {
+            case 'draft': return 3;
+            case 'normal': return 4;
+            case 'high': return 5;
+            default: return 4;
+        }
+    }
+    mapIppJob(job) {
+        const stateMap = {
+            3: 'pending',
+            4: 'pending',
+            5: 'processing',
+            6: 'processing',
+            7: 'canceled',
+            8: 'aborted',
+            9: 'completed',
+        };
+        return {
+            id: job['job-id'],
+            name: job['job-name'] ?? 'Unknown',
+            state: stateMap[job['job-state'] ?? 3] ?? 'pending',
+            stateReason: job['job-state-reasons']?.[0],
+            createdAt: new Date(job['time-at-creation'] * 1000),
+            completedAt: job['time-at-completed']
+                ? new Date(job['time-at-completed'] * 1000)
+                : undefined,
+        };
+    }
+    // ============================================================================
+    // Serialization
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'print',
+            protocol: this.protocol,
+            supportsColor: this.supportsColor,
+            supportsDuplex: this.supportsDuplex,
+            supportedMediaSizes: this.supportedMediaSizes,
+        };
+    }
+    // ============================================================================
+    // Static Factory
+    // ============================================================================
+    /**
+     * Create from discovery metadata
+     */
+    static fromDiscovery(device, port, protocol, metadata) {
+        const txtRecords = metadata.txtRecords ?? {};
+        return new PrintFeature(device, port, {
+            protocol,
+            uri: metadata.uri,
+            supportsColor: txtRecords['Color'] === 'T' || txtRecords['color'] === 'true',
+            supportsDuplex: txtRecords['Duplex'] === 'T' || txtRecords['duplex'] === 'true',
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5wcmludC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2ZlYXR1cmVzL2ZlYXR1cmUucHJpbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsT0FBTyxFQUFFLE9BQU8sRUFBeUIsTUFBTSx1QkFBdUIsQ0FBQztBQUN2RSxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUEyQnBEOzs7Ozs7Ozs7Ozs7OztHQWNHO0FBQ0gsTUFBTSxPQUFPLFlBQWEsU0FBUSxPQUFPO0lBQ3ZCLElBQUksR0FBRyxPQUFnQixDQUFDO0lBQ3hCLFFBQVEsQ0FBaUI7SUFFekMsa0JBQWtCO0lBQ1YsU0FBUyxHQUF1QixJQUFJLENBQUM7SUFFN0MsZ0JBQWdCO0lBQ0EsR0FBRyxDQUFTO0lBRTVCLGVBQWU7SUFDUixhQUFhLEdBQVksSUFBSSxDQUFDO0lBQzlCLGNBQWMsR0FBWSxLQUFLLENBQUM7SUFDaEMsbUJBQW1CLEdBQWEsQ0FBQyxrQkFBa0IsRUFBRSxvQkFBb0IsQ0FBQyxDQUFDO0lBQzNFLG1CQUFtQixHQUFhLENBQUMsWUFBWSxDQUFDLENBQUM7SUFDL0MsU0FBUyxHQUFXLEVBQUUsQ0FBQztJQUN2QixjQUFjLEdBQWtCLENBQUMsV0FBVyxDQUFDLENBQUM7SUFDOUMsa0JBQWtCLEdBQW9CLENBQUMsUUFBUSxDQUFDLENBQUM7SUFFeEQsWUFDRSxNQUF3QixFQUN4QixJQUFZLEVBQ1osT0FBOEI7UUFFOUIsS0FBSyxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDN0IsSUFBSSxDQUFDLFFBQVEsR0FBRyxPQUFPLEVBQUUsUUFBUSxJQUFJLEtBQUssQ0FBQztRQUMzQyxJQUFJLENBQUMsR0FBRyxHQUFHLE9BQU8sRUFBRSxHQUFHLElBQUksU0FBUyxNQUFNLENBQUMsT0FBTyxJQUFJLElBQUksWUFBWSxDQUFDO1FBRXZFLDRDQUE0QztRQUM1QyxJQUFJLE9BQU8sRUFBRSxhQUFhLEtBQUssU0FBUztZQUFFLElBQUksQ0FBQyxhQUFhLEdBQUcsT0FBTyxDQUFDLGFBQWEsQ0FBQztRQUNyRixJQUFJLE9BQU8sRUFBRSxjQUFjLEtBQUssU0FBUyxFQUFFLENBQUM7WUFDMUMsSUFBSSxDQUFDLGNBQWMsR0FBRyxPQUFPLENBQUMsY0FBYyxDQUFDO1lBQzdDLElBQUksT0FBTyxDQUFDLGNBQWMsRUFBRSxDQUFDO2dCQUMzQixJQUFJLENBQUMsY0FBYyxHQUFHLENBQUMsV0FBVyxFQUFFLHFCQUFxQixFQUFFLHNCQUFzQixDQUFDLENBQUM7WUFDckYsQ0FBQztRQUNILENBQUM7UUFDRCxJQUFJLE9BQU8sRUFBRSxtQkFBbUI7WUFBRSxJQUFJLENBQUMsbUJBQW1CLEdBQUcsT0FBTyxDQUFDLG1CQUFtQixDQUFDO1FBQ3pGLElBQUksT0FBTyxFQUFFLG1CQUFtQjtZQUFFLElBQUksQ0FBQyxtQkFBbUIsR0FBRyxPQUFPLENBQUMsbUJBQW1CLENBQUM7UUFDekYsSUFBSSxPQUFPLEVBQUUsU0FBUztZQUFFLElBQUksQ0FBQyxTQUFTLEdBQUcsT0FBTyxDQUFDLFNBQVMsQ0FBQztJQUM3RCxDQUFDO0lBRUQsK0VBQStFO0lBQy9FLGFBQWE7SUFDYiwrRUFBK0U7SUFFckUsS0FBSyxDQUFDLFNBQVM7UUFDdkIsSUFBSSxJQUFJLENBQUMsUUFBUSxLQUFLLEtBQUssRUFBRSxDQUFDO1lBQzVCLDJDQUEyQztZQUMzQyxNQUFNLEdBQUcsR0FBRyxJQUFJLEdBQUcsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsU0FBUyxDQUFDLENBQUMsT0FBTyxDQUFDLFNBQVMsRUFBRSxVQUFVLENBQUMsQ0FBQyxDQUFDO1lBQzFGLE1BQU0sT0FBTyxHQUFHLEdBQUcsQ0FBQyxRQUFRLENBQUM7WUFDN0IsTUFBTSxJQUFJLEdBQUcsUUFBUSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDO1lBQzlDLE1BQU0sSUFBSSxHQUFHLEdBQUcsQ0FBQyxRQUFRLElBQUksWUFBWSxDQUFDO1lBRTFDLElBQUksQ0FBQyxTQUFTLEdBQUcsSUFBSSxXQUFXLENBQUMsT0FBTyxFQUFFLElBQUksRUFBRSxJQUFJLENBQUMsQ0FBQztZQUN0RCxrREFBa0Q7WUFDbEQsTUFBTSxLQUFLLEdBQUcsTUFBTSxJQUFJLENBQUMsU0FBUyxDQUFDLGFBQWEsRUFBRSxDQUFDO1lBQ25ELElBQUksQ0FBQyx5QkFBeUIsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUN4QyxDQUFDO1FBQ0QsdURBQXVEO0lBQ3pELENBQUM7SUFFUyxLQUFLLENBQUMsWUFBWTtRQUMxQixJQUFJLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQztJQUN4QixDQUFDO0lBRUQsK0VBQStFO0lBQy9FLHNCQUFzQjtJQUN0QiwrRUFBK0U7SUFFL0U7O09BRUc7SUFDSSxLQUFLLENBQUMsZUFBZTtRQUMxQixPQUFPO1lBQ0wsY0FBYyxFQUFFLElBQUksQ0FBQyxhQUFhO1lBQ2xDLGVBQWUsRUFBRSxJQUFJLENBQUMsY0FBYztZQUNwQyxVQUFVLEVBQUUsSUFBSSxDQUFDLG1CQUFtQjtZQUNwQyxVQUFVLEVBQUUsSUFBSSxDQUFDLG1CQUFtQjtZQUNwQyxXQUFXLEVBQUUsQ0FBQyxHQUFHLEVBQUUsR0FBRyxDQUFDO1lBQ3ZCLFNBQVMsRUFBRSxJQUFJLENBQUMsU0FBUztZQUN6QixjQUFjLEVBQUUsSUFBSSxDQUFDLGNBQWM7WUFDbkMsZ0JBQWdCLEVBQUUsSUFBSSxDQUFDLGtCQUFrQjtTQUMxQyxDQUFDO0lBQ0osQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSyxDQUFDLEtBQUssQ0FBQyxJQUFZLEVBQUUsT0FBdUI7UUFDdEQsSUFBSSxDQUFDLElBQUksQ0FBQyxXQUFXLEVBQUUsQ0FBQztZQUN0QixNQUFNLElBQUksS0FBSyxDQUFDLDZCQUE2QixDQUFDLENBQUM7UUFDakQsQ0FBQztRQUVELElBQUksSUFBSSxDQUFDLFFBQVEsS0FBSyxLQUFLLElBQUksSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQzlDLE9BQU8sSUFBSSxDQUFDLFlBQVksQ0FBQyxJQUFJLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFDMUMsQ0FBQztRQUVELE1BQU0sSUFBSSxLQUFLLENBQUMsWUFBWSxJQUFJLENBQUMsUUFBUSxvQkFBb0IsQ0FBQyxDQUFDO0lBQ2pFLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxPQUFPO1FBQ2xCLElBQUksQ0FBQyxJQUFJLENBQUMsV0FBVyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ3pDLE1BQU0sSUFBSSxLQUFLLENBQUMsNkJBQTZCLENBQUMsQ0FBQztRQUNqRCxDQUFDO1FBRUQsT0FBTyxJQUFJLENBQUMsU0FBUyxDQUFDLE9BQU8sRUFBRSxDQUFDO0lBQ2xDLENBQUM7SUFFRDs7T0FFRztJQUNJLEtBQUssQ0FBQyxVQUFVLENBQUMsS0FBYTtRQUNuQyxJQUFJLENBQUMsSUFBSSxDQUFDLFdBQVcsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUN6QyxNQUFNLElBQUksS0FBSyxDQUFDLDZCQUE2QixDQUFDLENBQUM7UUFDakQsQ0FBQztRQUVELE9BQU8sSUFBSSxDQUFDLFNBQVMsQ0FBQyxVQUFVLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDMUMsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSyxDQUFDLFNBQVMsQ0FBQyxLQUFhO1FBQ2xDLElBQUksQ0FBQyxJQUFJLENBQUMsV0FBVyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxDQUFDO1lBQ3pDLE1BQU0sSUFBSSxLQUFLLENBQUMsNkJBQTZCLENBQUMsQ0FBQztRQUNqRCxDQUFDO1FBRUQsTUFBTSxJQUFJLENBQUMsU0FBUyxDQUFDLFNBQVMsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUN0QyxJQUFJLENBQUMsSUFBSSxDQUFDLGVBQWUsRUFBRSxLQUFLLENBQUMsQ0FBQztJQUNwQyxDQUFDO0lBRUQsK0VBQStFO0lBQy9FLDZCQUE2QjtJQUM3QiwrRUFBK0U7SUFFdkUsS0FBSyxDQUFDLFlBQVksQ0FBQyxJQUFZLEVBQUUsT0FBdUI7UUFDOUQsSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNwQixNQUFNLElBQUksS0FBSyxDQUFDLDRCQUE0QixDQUFDLENBQUM7UUFDaEQsQ0FBQztRQUVELElBQUksQ0FBQyxJQUFJLENBQUMsZUFBZSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBRXBDLGtFQUFrRTtRQUNsRSxNQUFNLEdBQUcsR0FBRyxNQUFNLElBQUksQ0FBQyxTQUFTLENBQUMsS0FBSyxDQUFDLElBQUksRUFBRSxPQUFPLENBQUMsQ0FBQztRQUV0RCxJQUFJLENBQUMsSUFBSSxDQUFDLGlCQUFpQixFQUFFLEdBQUcsQ0FBQyxDQUFDO1FBQ2xDLE9BQU8sR0FBRyxDQUFDO0lBQ2IsQ0FBQztJQUVELCtFQUErRTtJQUMvRSxpQkFBaUI7SUFDakIsK0VBQStFO0lBRXZFLHlCQUF5QixDQUFDLElBQTBCO1FBQzFELElBQUksQ0FBQyxhQUFhLEdBQUcsSUFBSSxDQUFDLGNBQWMsQ0FBQztRQUN6QyxJQUFJLENBQUMsY0FBYyxHQUFHLElBQUksQ0FBQyxlQUFlLENBQUM7UUFDM0MsSUFBSSxDQUFDLFNBQVMsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDO1FBRWhDLElBQUksSUFBSSxDQUFDLFVBQVUsSUFBSSxJQUFJLENBQUMsVUFBVSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztZQUNsRCxJQUFJLENBQUMsbUJBQW1CLEdBQUcsSUFBSSxDQUFDLFVBQVUsQ0FBQztRQUM3QyxDQUFDO1FBQ0QsSUFBSSxJQUFJLENBQUMsVUFBVSxJQUFJLElBQUksQ0FBQyxVQUFVLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO1lBQ2xELElBQUksQ0FBQyxtQkFBbUIsR0FBRyxJQUFJLENBQUMsVUFBVSxDQUFDO1FBQzdDLENBQUM7UUFDRCxJQUFJLElBQUksQ0FBQyxjQUFjLElBQUksSUFBSSxDQUFDLGNBQWMsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUM7WUFDMUQsSUFBSSxDQUFDLGNBQWMsR0FBRyxJQUFJLENBQUMsY0FBYyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBb0IsRUFBRSxDQUN2RSxDQUFDLFdBQVcsRUFBRSxxQkFBcUIsRUFBRSxzQkFBc0IsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FDekUsQ0FBQztRQUNKLENBQUM7UUFDRCxJQUFJLElBQUksQ0FBQyxnQkFBZ0IsSUFBSSxJQUFJLENBQUMsZ0JBQWdCLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO1lBQzlELElBQUksQ0FBQyxrQkFBa0IsR0FBRyxJQUFJLENBQUMsZ0JBQWdCLENBQUMsTUFBTSxDQUFDLENBQUMsQ0FBQyxFQUFzQixFQUFFLENBQy9FLENBQUMsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLENBQUMsQ0FBQyxRQUFRLENBQUMsQ0FBQyxDQUFDLENBQ3hDLENBQUM7UUFDSixDQUFDO0lBQ0gsQ0FBQztJQUVPLFlBQVksQ0FBQyxPQUFzQjtRQUN6QyxRQUFRLE9BQU8sRUFBRSxDQUFDO1lBQ2hCLEtBQUssT0FBTyxDQUFDLENBQUMsT0FBTyxDQUFDLENBQUM7WUFDdkIsS0FBSyxRQUFRLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQztZQUN4QixLQUFLLE1BQU0sQ0FBQyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1lBQ3RCLE9BQU8sQ0FBQyxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBQ3BCLENBQUM7SUFDSCxDQUFDO0lBRU8sU0FBUyxDQUFDLEdBQTRCO1FBQzVDLE1BQU0sUUFBUSxHQUF1QztZQUNuRCxDQUFDLEVBQUUsU0FBUztZQUNaLENBQUMsRUFBRSxTQUFTO1lBQ1osQ0FBQyxFQUFFLFlBQVk7WUFDZixDQUFDLEVBQUUsWUFBWTtZQUNmLENBQUMsRUFBRSxVQUFVO1lBQ2IsQ0FBQyxFQUFFLFNBQVM7WUFDWixDQUFDLEVBQUUsV0FBVztTQUNmLENBQUM7UUFFRixPQUFPO1lBQ0wsRUFBRSxFQUFFLEdBQUcsQ0FBQyxRQUFRLENBQVc7WUFDM0IsSUFBSSxFQUFFLEdBQUcsQ0FBQyxVQUFVLENBQVcsSUFBSSxTQUFTO1lBQzVDLEtBQUssRUFBRSxRQUFRLENBQUUsR0FBRyxDQUFDLFdBQVcsQ0FBWSxJQUFJLENBQUMsQ0FBQyxJQUFJLFNBQVM7WUFDL0QsV0FBVyxFQUFHLEdBQUcsQ0FBQyxtQkFBbUIsQ0FBYyxFQUFFLENBQUMsQ0FBQyxDQUFDO1lBQ3hELFNBQVMsRUFBRSxJQUFJLElBQUksQ0FBRSxHQUFHLENBQUMsa0JBQWtCLENBQVksR0FBRyxJQUFJLENBQUM7WUFDL0QsV0FBVyxFQUFFLEdBQUcsQ0FBQyxtQkFBbUIsQ0FBQztnQkFDbkMsQ0FBQyxDQUFDLElBQUksSUFBSSxDQUFFLEdBQUcsQ0FBQyxtQkFBbUIsQ0FBWSxHQUFHLElBQUksQ0FBQztnQkFDdkQsQ0FBQyxDQUFDLFNBQVM7U0FDZCxDQUFDO0lBQ0osQ0FBQztJQUVELCtFQUErRTtJQUMvRSxnQkFBZ0I7SUFDaEIsK0VBQStFO0lBRXhFLGNBQWM7UUFDbkIsT0FBTztZQUNMLEdBQUcsSUFBSSxDQUFDLGtCQUFrQixFQUFFO1lBQzVCLElBQUksRUFBRSxPQUFPO1lBQ2IsUUFBUSxFQUFFLElBQUksQ0FBQyxRQUFRO1lBQ3ZCLGFBQWEsRUFBRSxJQUFJLENBQUMsYUFBYTtZQUNqQyxjQUFjLEVBQUUsSUFBSSxDQUFDLGNBQWM7WUFDbkMsbUJBQW1CLEVBQUUsSUFBSSxDQUFDLG1CQUFtQjtTQUM5QyxDQUFDO0lBQ0osQ0FBQztJQUVELCtFQUErRTtJQUMvRSxpQkFBaUI7SUFDakIsK0VBQStFO0lBRS9FOztPQUVHO0lBQ0ksTUFBTSxDQUFDLGFBQWEsQ0FDekIsTUFBd0IsRUFDeEIsSUFBWSxFQUNaLFFBQXdCLEVBQ3hCLFFBQWlDO1FBRWpDLE1BQU0sVUFBVSxHQUFHLFFBQVEsQ0FBQyxVQUFvQyxJQUFJLEVBQUUsQ0FBQztRQUV2RSxPQUFPLElBQUksWUFBWSxDQUFDLE1BQU0sRUFBRSxJQUFJLEVBQUU7WUFDcEMsUUFBUTtZQUNSLEdBQUcsRUFBRSxRQUFRLENBQUMsR0FBYTtZQUMzQixhQUFhLEVBQUUsVUFBVSxDQUFDLE9BQU8sQ0FBQyxLQUFLLEdBQUcsSUFBSSxVQUFVLENBQUMsT0FBTyxDQUFDLEtBQUssTUFBTTtZQUM1RSxjQUFjLEVBQUUsVUFBVSxDQUFDLFFBQVEsQ0FBQyxLQUFLLEdBQUcsSUFBSSxVQUFVLENBQUMsUUFBUSxDQUFDLEtBQUssTUFBTTtTQUNoRixDQUFDLENBQUM7SUFDTCxDQUFDO0NBQ0YifQ==

package/dist_ts/features/feature.scan.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Scan Feature
+ * Provides document scanning capability using eSCL or SANE protocols
+ */
+import { Feature, type TDeviceReference } from './feature.abstract.js';
+import type { TScanProtocol, TScanFormat, TColorMode, TScanSource, IScanCapabilities, IScanOptions, IScanResult, IScanFeatureInfo, IFeatureOptions } from '../interfaces/feature.interfaces.js';
+/**
+ * Options for creating a ScanFeature
+ */
+export interface IScanFeatureOptions extends IFeatureOptions {
+    protocol: TScanProtocol;
+    secure?: boolean;
+    deviceName?: string;
+    supportedFormats?: TScanFormat[];
+    supportedResolutions?: number[];
+    supportedColorModes?: TColorMode[];
+    supportedSources?: TScanSource[];
+    hasAdf?: boolean;
+    hasDuplex?: boolean;
+}
+/**
+ * Scan Feature - provides document scanning capability
+ *
+ * Wraps eSCL (AirScan) or SANE protocols to provide a unified scanning interface.
+ *
+ * @example
+ * ```typescript
+ * const scanFeature = device.getFeature<ScanFeature>('scan');
+ * if (scanFeature) {
+ *   await scanFeature.connect();
+ *   const result = await scanFeature.scan({ format: 'pdf', resolution: 300 });
+ *   console.log(`Scanned ${result.width}x${result.height} pixels`);
+ * }
+ * ```
+ */
+export declare class ScanFeature extends Feature {
+    readonly type: "scan";
+    readonly protocol: TScanProtocol;
+    private esclClient;
+    private saneClient;
+    private readonly isSecure;
+    private readonly deviceName;
+    supportedFormats: TScanFormat[];
+    supportedResolutions: number[];
+    supportedColorModes: TColorMode[];
+    supportedSources: TScanSource[];
+    hasAdf: boolean;
+    hasDuplex: boolean;
+    maxWidth: number;
+    maxHeight: number;
+    minWidth: number;
+    minHeight: number;
+    constructor(device: TDeviceReference, port: number, options: IScanFeatureOptions);
+    protected doConnect(): Promise<void>;
+    protected doDisconnect(): Promise<void>;
+    /**
+     * Get scanner capabilities
+     */
+    getCapabilities(): Promise<IScanCapabilities>;
+    /**
+     * Perform a scan
+     */
+    scan(options?: IScanOptions): Promise<IScanResult>;
+    /**
+     * Cancel an ongoing scan
+     */
+    cancelScan(): Promise<void>;
+    private scanWithEscl;
+    private scanWithSane;
+    private resolveOptions;
+    private updateCapabilitiesFromEscl;
+    private colorModeToSane;
+    private getMimeType;
+    getFeatureInfo(): IScanFeatureInfo;
+    /**
+     * Create from discovery metadata
+     */
+    static fromDiscovery(device: TDeviceReference, port: number, protocol: TScanProtocol, metadata: Record<string, unknown>): ScanFeature;
+}

package/dist_ts/features/feature.scan.js

@@ -0,0 +1,315 @@
+/**
+ * Scan Feature
+ * Provides document scanning capability using eSCL or SANE protocols
+ */
+import { Feature } from './feature.abstract.js';
+import { EsclProtocol, SaneProtocol } from '../protocols/index.js';
+/**
+ * Scan Feature - provides document scanning capability
+ *
+ * Wraps eSCL (AirScan) or SANE protocols to provide a unified scanning interface.
+ *
+ * @example
+ * ```typescript
+ * const scanFeature = device.getFeature<ScanFeature>('scan');
+ * if (scanFeature) {
+ *   await scanFeature.connect();
+ *   const result = await scanFeature.scan({ format: 'pdf', resolution: 300 });
+ *   console.log(`Scanned ${result.width}x${result.height} pixels`);
+ * }
+ * ```
+ */
+export class ScanFeature extends Feature {
+    type = 'scan';
+    protocol;
+    // Protocol clients
+    esclClient = null;
+    saneClient = null;
+    // Configuration
+    isSecure;
+    deviceName;
+    // Capabilities
+    supportedFormats = ['jpeg', 'png', 'pdf'];
+    supportedResolutions = [75, 150, 300, 600];
+    supportedColorModes = ['color', 'grayscale', 'blackwhite'];
+    supportedSources = ['flatbed'];
+    hasAdf = false;
+    hasDuplex = false;
+    maxWidth = 215.9; // A4 width in mm
+    maxHeight = 297; // A4 height in mm
+    minWidth = 10;
+    minHeight = 10;
+    constructor(device, port, options) {
+        super(device, port, options);
+        this.protocol = options.protocol;
+        this.isSecure = options.secure ?? false;
+        this.deviceName = options.deviceName ?? '';
+        // Set capabilities from options if provided
+        if (options.supportedFormats)
+            this.supportedFormats = options.supportedFormats;
+        if (options.supportedResolutions)
+            this.supportedResolutions = options.supportedResolutions;
+        if (options.supportedColorModes)
+            this.supportedColorModes = options.supportedColorModes;
+        if (options.supportedSources)
+            this.supportedSources = options.supportedSources;
+        if (options.hasAdf !== undefined)
+            this.hasAdf = options.hasAdf;
+        if (options.hasDuplex !== undefined)
+            this.hasDuplex = options.hasDuplex;
+    }
+    // ============================================================================
+    // Connection
+    // ============================================================================
+    async doConnect() {
+        if (this.protocol === 'escl') {
+            this.esclClient = new EsclProtocol(this.address, this._port, this.isSecure);
+            // Fetch capabilities to verify connection
+            const caps = await this.esclClient.getCapabilities();
+            this.updateCapabilitiesFromEscl(caps);
+        }
+        else if (this.protocol === 'sane') {
+            this.saneClient = new SaneProtocol(this.address, this._port);
+            await this.saneClient.connect();
+            // Open the device if we have a name
+            if (this.deviceName) {
+                await this.saneClient.open(this.deviceName);
+            }
+        }
+    }
+    async doDisconnect() {
+        if (this.saneClient) {
+            try {
+                await this.saneClient.close();
+                await this.saneClient.disconnect();
+            }
+            catch {
+                // Ignore disconnect errors
+            }
+            this.saneClient = null;
+        }
+        this.esclClient = null;
+    }
+    // ============================================================================
+    // Scanning Operations
+    // ============================================================================
+    /**
+     * Get scanner capabilities
+     */
+    async getCapabilities() {
+        return {
+            resolutions: this.supportedResolutions,
+            formats: this.supportedFormats,
+            colorModes: this.supportedColorModes,
+            sources: this.supportedSources,
+            maxWidth: this.maxWidth,
+            maxHeight: this.maxHeight,
+            minWidth: this.minWidth,
+            minHeight: this.minHeight,
+        };
+    }
+    /**
+     * Perform a scan
+     */
+    async scan(options) {
+        if (!this.isConnected) {
+            throw new Error('Scan feature not connected');
+        }
+        const opts = this.resolveOptions(options);
+        if (this.protocol === 'escl' && this.esclClient) {
+            return this.scanWithEscl(opts);
+        }
+        else if (this.protocol === 'sane' && this.saneClient) {
+            return this.scanWithSane(opts);
+        }
+        throw new Error('No scanner protocol available');
+    }
+    /**
+     * Cancel an ongoing scan
+     */
+    async cancelScan() {
+        if (this.protocol === 'sane' && this.saneClient) {
+            await this.saneClient.cancel();
+        }
+        // eSCL cancellation is handled by deleting the job
+        this.emit('scan:cancelled');
+    }
+    // ============================================================================
+    // Protocol-Specific Scanning
+    // ============================================================================
+    async scanWithEscl(options) {
+        if (!this.esclClient) {
+            throw new Error('eSCL client not initialized');
+        }
+        this.emit('scan:started', options);
+        // Use the protocol's scan method which handles job submission,
+        // waiting for completion, and downloading in one operation
+        const result = await this.esclClient.scan({
+            format: options.format,
+            resolution: options.resolution,
+            colorMode: options.colorMode,
+            source: options.source,
+            area: options.area,
+            intent: options.intent,
+        });
+        this.emit('scan:completed', result);
+        return result;
+    }
+    async scanWithSane(options) {
+        if (!this.saneClient) {
+            throw new Error('SANE client not initialized');
+        }
+        this.emit('scan:started', options);
+        // Use the protocol's scan method which handles option configuration,
+        // parameter retrieval, and image reading in one operation
+        const result = await this.saneClient.scan({
+            format: options.format,
+            resolution: options.resolution,
+            colorMode: options.colorMode,
+            source: options.source,
+            area: options.area,
+        });
+        this.emit('scan:completed', result);
+        return result;
+    }
+    // ============================================================================
+    // Helper Methods
+    // ============================================================================
+    resolveOptions(options) {
+        return {
+            resolution: options?.resolution ?? 300,
+            format: options?.format ?? 'jpeg',
+            colorMode: options?.colorMode ?? 'color',
+            source: options?.source ?? 'flatbed',
+            area: options?.area ?? {
+                x: 0,
+                y: 0,
+                width: this.maxWidth,
+                height: this.maxHeight,
+            },
+            intent: options?.intent ?? 'document',
+            quality: options?.quality ?? 85,
+        };
+    }
+    updateCapabilitiesFromEscl(caps) {
+        if (caps.platen) {
+            this.supportedResolutions = caps.platen.supportedResolutions || this.supportedResolutions;
+            this.maxWidth = caps.platen.maxWidth || this.maxWidth;
+            this.maxHeight = caps.platen.maxHeight || this.maxHeight;
+            this.minWidth = caps.platen.minWidth || this.minWidth;
+            this.minHeight = caps.platen.minHeight || this.minHeight;
+        }
+        if (caps.adf) {
+            this.hasAdf = true;
+            if (!this.supportedSources.includes('adf')) {
+                this.supportedSources.push('adf');
+            }
+        }
+        if (caps.adfDuplex) {
+            this.hasDuplex = true;
+            if (!this.supportedSources.includes('adf-duplex')) {
+                this.supportedSources.push('adf-duplex');
+            }
+        }
+    }
+    colorModeToSane(mode) {
+        switch (mode) {
+            case 'color': return 'Color';
+            case 'grayscale': return 'Gray';
+            case 'blackwhite': return 'Lineart';
+            default: return 'Color';
+        }
+    }
+    getMimeType(format) {
+        switch (format) {
+            case 'jpeg': return 'image/jpeg';
+            case 'png': return 'image/png';
+            case 'pdf': return 'application/pdf';
+            case 'tiff': return 'image/tiff';
+            default: return 'application/octet-stream';
+        }
+    }
+    // ============================================================================
+    // Serialization
+    // ============================================================================
+    getFeatureInfo() {
+        return {
+            ...this.getBaseFeatureInfo(),
+            type: 'scan',
+            protocol: this.protocol,
+            supportedFormats: this.supportedFormats,
+            supportedResolutions: this.supportedResolutions,
+            supportedColorModes: this.supportedColorModes,
+            supportedSources: this.supportedSources,
+            hasAdf: this.hasAdf,
+            hasDuplex: this.hasDuplex,
+        };
+    }
+    // ============================================================================
+    // Static Factory
+    // ============================================================================
+    /**
+     * Create from discovery metadata
+     */
+    static fromDiscovery(device, port, protocol, metadata) {
+        const txtRecords = metadata.txtRecords ?? {};
+        return new ScanFeature(device, port, {
+            protocol,
+            secure: metadata.secure ?? port === 443,
+            deviceName: metadata.deviceName,
+            supportedFormats: parseFormats(txtRecords),
+            supportedResolutions: parseResolutions(txtRecords),
+            supportedColorModes: parseColorModes(txtRecords),
+            supportedSources: parseSources(txtRecords),
+            hasAdf: Boolean(metadata.hasAdf),
+            hasDuplex: Boolean(metadata.hasDuplex),
+        });
+    }
+}
+// ============================================================================
+// Parsing Helpers
+// ============================================================================
+function parseFormats(txt) {
+    const pdl = txt['pdl'] || '';
+    const formats = [];
+    if (pdl.includes('image/jpeg'))
+        formats.push('jpeg');
+    if (pdl.includes('image/png'))
+        formats.push('png');
+    if (pdl.includes('application/pdf'))
+        formats.push('pdf');
+    if (pdl.includes('image/tiff'))
+        formats.push('tiff');
+    return formats.length > 0 ? formats : ['jpeg', 'png', 'pdf'];
+}
+function parseResolutions(txt) {
+    const rs = txt['rs'] || '';
+    if (!rs)
+        return [75, 150, 300, 600];
+    return rs.split(',')
+        .map((r) => parseInt(r.trim(), 10))
+        .filter((r) => !isNaN(r) && r > 0);
+}
+function parseColorModes(txt) {
+    const cs = txt['cs'] || '';
+    const modes = [];
+    if (cs.includes('color') || cs.includes('RGB'))
+        modes.push('color');
+    if (cs.includes('grayscale') || cs.includes('gray'))
+        modes.push('grayscale');
+    if (cs.includes('binary') || cs.includes('lineart'))
+        modes.push('blackwhite');
+    return modes.length > 0 ? modes : ['color', 'grayscale', 'blackwhite'];
+}
+function parseSources(txt) {
+    const is = txt['is'] || '';
+    const sources = [];
+    if (is.includes('platen') || is.includes('flatbed') || !is)
+        sources.push('flatbed');
+    if (is.includes('adf') && is.includes('duplex'))
+        sources.push('adf-duplex');
+    else if (is.includes('adf'))
+        sources.push('adf');
+    return sources.length > 0 ? sources : ['flatbed'];
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmVhdHVyZS5zY2FuLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvZmVhdHVyZXMvZmVhdHVyZS5zY2FuLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sRUFBRSxPQUFPLEVBQXlCLE1BQU0sdUJBQXVCLENBQUM7QUFDdkUsT0FBTyxFQUFFLFlBQVksRUFBRSxZQUFZLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQTRCbkU7Ozs7Ozs7Ozs7Ozs7O0dBY0c7QUFDSCxNQUFNLE9BQU8sV0FBWSxTQUFRLE9BQU87SUFDdEIsSUFBSSxHQUFHLE1BQWUsQ0FBQztJQUN2QixRQUFRLENBQWdCO0lBRXhDLG1CQUFtQjtJQUNYLFVBQVUsR0FBd0IsSUFBSSxDQUFDO0lBQ3ZDLFVBQVUsR0FBd0IsSUFBSSxDQUFDO0lBRS9DLGdCQUFnQjtJQUNDLFFBQVEsQ0FBVTtJQUNsQixVQUFVLENBQVM7SUFFcEMsZUFBZTtJQUNSLGdCQUFnQixHQUFrQixDQUFDLE1BQU0sRUFBRSxLQUFLLEVBQUUsS0FBSyxDQUFDLENBQUM7SUFDekQsb0JBQW9CLEdBQWEsQ0FBQyxFQUFFLEVBQUUsR0FBRyxFQUFFLEdBQUcsRUFBRSxHQUFHLENBQUMsQ0FBQztJQUNyRCxtQkFBbUIsR0FBaUIsQ0FBQyxPQUFPLEVBQUUsV0FBVyxFQUFFLFlBQVksQ0FBQyxDQUFDO0lBQ3pFLGdCQUFnQixHQUFrQixDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQzlDLE1BQU0sR0FBWSxLQUFLLENBQUM7SUFDeEIsU0FBUyxHQUFZLEtBQUssQ0FBQztJQUMzQixRQUFRLEdBQVcsS0FBSyxDQUFDLENBQUUsaUJBQWlCO0lBQzVDLFNBQVMsR0FBVyxHQUFHLENBQUMsQ0FBRyxrQkFBa0I7SUFDN0MsUUFBUSxHQUFXLEVBQUUsQ0FBQztJQUN0QixTQUFTLEdBQVcsRUFBRSxDQUFDO0lBRTlCLFlBQ0UsTUFBd0IsRUFDeEIsSUFBWSxFQUNaLE9BQTRCO1FBRTVC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