pdf-oxide 0.3.37 → 0.3.39

package/lib/managers/index.js

@@ -38,32 +38,32 @@
  * const highlights = annotationManager.getHighlights();
  * ```
  */
-// Core Managers
-export { OutlineManager } from './outline-manager.js';
-export { MetadataManager, } from './metadata-manager.js';
-export { ExtractionManager, } from './extraction-manager.js';
-export { SearchManager, } from './search-manager.js';
-export { SecurityManager, } from './security-manager.js';
+export { FieldVisibility, FormFieldManager, FormFieldType, } from '../form-field-manager.js';
+// Phase 1 Expansion: Result Accessors and Forms
+export { ResultAccessorsManager, } from '../result-accessors-manager.js';
+export { AccessibilityManager, } from './accessibility-manager.js';
 export { AnnotationManager, } from './annotation-manager.js';
-export { LayerManager, } from './layer-manager.js';
-export { RenderingManager, RenderOptions, } from './rendering-manager.js';
-export { PageManager, } from './page-manager.js';
-export { ContentManager, } from './content-manager.js';
-// Phase 2.4: Stream API support
-export { SearchStream, ExtractionStream, MetadataStream, createSearchStream, createExtractionStream, createMetadataStream, } from './streams.js';
+export { BarcodeErrorCorrection, BarcodeFormat, BarcodeManager, QrErrorCorrection, } from './barcode-manager.js';
 // Phase 2.5: Batch Processing API
 export { BatchManager, } from './batch-manager.js';
-// Phase 1 Expansion: Result Accessors and Forms
-export { ResultAccessorsManager, } from '../result-accessors-manager.js';
-export { FormFieldManager, FormFieldType, FieldVisibility, } from '../form-field-manager.js';
-// Canonical Managers (Phase 9 consolidation)
-export { OcrManager, OCRManager, OcrDetectionMode, } from './ocr-manager.js';
-export { SignatureManager, SignatureAlgorithm, DigestAlgorithm, SignatureType, CertificationPermission, CertificateFormat, TimestampStatus, FfiDigestAlgorithm, FfiSignatureSubFilter, } from './signature-manager.js';
-export { XfaManager, XFAManager, XfaFormType, XfaFieldType, XfaValidationType, XfaBindingType, } from './xfa-manager.js';
-export { ComplianceManager, PdfALevel, PdfXLevel, PdfUALevel, ComplianceIssueType, IssueSeverity, } from './compliance-manager.js';
-export { BarcodeManager, BarcodeFormat, BarcodeErrorCorrection, QrErrorCorrection, } from './barcode-manager.js';
 export { CacheManager, } from './cache-manager.js';
+export { ComplianceIssueType, ComplianceManager, IssueSeverity, PdfALevel, PdfUALevel, PdfXLevel, } from './compliance-manager.js';
+export { ContentManager, } from './content-manager.js';
 export { EditingManager, } from './editing-manager.js';
-export { AccessibilityManager, } from './accessibility-manager.js';
+export { BatesPosition, DifferenceType, EnterpriseManager, StampAlignment, } from './enterprise-manager.js';
+export { ExtractionManager, } from './extraction-manager.js';
+export { LayerManager, } from './layer-manager.js';
+export { MetadataManager, } from './metadata-manager.js';
+// Canonical Managers (Phase 9 consolidation)
+export { OCRManager, OcrDetectionMode, OcrManager, } from './ocr-manager.js';
 export { OptimizationManager, } from './optimization-manager.js';
-export { EnterpriseManager, BatesPosition, StampAlignment, DifferenceType, } from './enterprise-manager.js';
+// Core Managers
+export { OutlineManager } from './outline-manager.js';
+export { PageManager, } from './page-manager.js';
+export { RenderingManager, RenderOptions, } from './rendering-manager.js';
+export { SearchManager, } from './search-manager.js';
+export { SecurityManager, } from './security-manager.js';
+export { CertificateFormat, CertificationPermission, DigestAlgorithm, FfiDigestAlgorithm, FfiSignatureSubFilter, SignatureAlgorithm, SignatureManager, SignatureType, TimestampStatus, } from './signature-manager.js';
+// Phase 2.4: Stream API support
+export { createExtractionStream, createMetadataStream, createSearchStream, ExtractionStream, MetadataStream, SearchStream, } from './streams.js';
+export { XFAManager, XfaBindingType, XfaFieldType, XfaFormType, XfaManager, XfaValidationType, } from './xfa-manager.js';

package/lib/managers/layer-manager.js

@@ -117,7 +117,7 @@ export class LayerManager {
             throw new Error('Layer name must be a non-empty string');
         }
         const layers = this.getLayers();
-        return layers.find(layer => layer.name === name) || null;
+        return layers.find((layer) => layer.name === name) || null;
     }
     /**
      * Gets layer by ID
@@ -129,7 +129,7 @@ export class LayerManager {
             throw new Error('Layer ID must be a non-empty string');
         }
         const layers = this.getLayers();
-        return layers.find(layer => layer.id === id) || null;
+        return layers.find((layer) => layer.id === id) || null;
     }
     /**
      * Gets root-level layers (not nested under other layers)
@@ -137,7 +137,7 @@ export class LayerManager {
      */
     getRootLayers() {
         const layers = this.getLayers();
-        return layers.filter(layer => !layer.parentId);
+        return layers.filter((layer) => !layer.parentId);
     }
     /**
      * Gets the full layer hierarchy as a tree structure
@@ -182,7 +182,7 @@ export class LayerManager {
             throw new Error('Parent layer ID must be a non-empty string');
         }
         const layers = this.getLayers();
-        return layers.filter(layer => layer.parentId === parentId);
+        return layers.filter((layer) => layer.parentId === parentId);
     }
     /**
      * Gets parent layer of a layer
@@ -230,9 +230,9 @@ export class LayerManager {
     getLayerUsages() {
         const layers = this.getLayers();
         return {
-            view: layers.filter(l => l.printable === false).length,
-            print: layers.filter(l => l.printable === true).length,
-            export: layers.filter(l => l.export !== false).length,
+            view: layers.filter((l) => l.printable === false).length,
+            print: layers.filter((l) => l.printable === true).length,
+            export: layers.filter((l) => l.export !== false).length,
         };
     }
     /**
@@ -268,10 +268,10 @@ export class LayerManager {
             count: layers.length,
             rootCount: hierarchy.root.length,
             maxDepth,
-            visible: layers.filter(l => l.visible !== false).length,
-            hidden: layers.filter(l => l.visible === false).length,
-            printable: layers.filter(l => l.printable !== false).length,
-            exportable: layers.filter(l => l.export !== false).length,
+            visible: layers.filter((l) => l.visible !== false).length,
+            hidden: layers.filter((l) => l.visible === false).length,
+            printable: layers.filter((l) => l.printable !== false).length,
+            exportable: layers.filter((l) => l.export !== false).length,
             hasConflicts: this._detectLayerConflicts().length > 0,
         };
         this._statisticsCache = stats;
@@ -285,7 +285,7 @@ export class LayerManager {
     getLayerDependencies() {
         const layers = this.getLayers();
         const dependencies = {};
-        layers.forEach(layer => {
+        layers.forEach((layer) => {
             dependencies[layer.id] = {
                 dependsOn: layer.dependsOn || [],
                 dependents: [],
@@ -317,8 +317,7 @@ export class LayerManager {
         }
         const regex = pattern instanceof RegExp ? pattern : new RegExp(pattern, 'i');
         const layers = this.getLayers();
-        return layers.filter(layer => regex.test(layer.name) ||
-            (layer.description && regex.test(layer.description)));
+        return layers.filter((layer) => regex.test(layer.name) || (layer.description && regex.test(layer.description)));
     }
     /**
      * Validates layer state for conflicts and issues
@@ -329,10 +328,10 @@ export class LayerManager {
         const conflicts = this._detectLayerConflicts();
         const cycles = this._detectLayerCycles();
         if (conflicts.length > 0) {
-            issues.push(...conflicts.map(c => `Conflict: ${c}`));
+            issues.push(...conflicts.map((c) => `Conflict: ${c}`));
         }
         if (cycles.length > 0) {
-            issues.push(...cycles.map(c => `Cycle detected: ${c}`));
+            issues.push(...cycles.map((c) => `Cycle detected: ${c}`));
         }
         return {
             isValid: issues.length === 0,
@@ -349,16 +348,16 @@ export class LayerManager {
         const layers = this.getLayers();
         // Check for layers with same name
         const nameMap = new Map();
-        layers.forEach(layer => {
+        layers.forEach((layer) => {
             if (nameMap.has(layer.name)) {
                 conflicts.push(`Duplicate layer name: ${layer.name}`);
             }
             nameMap.set(layer.name, layer.id);
         });
         // Check for orphaned layers
-        const parentIds = new Set(layers.map(l => l.parentId).filter(id => id));
-        const layerIds = new Set(layers.map(l => l.id));
-        parentIds.forEach(parentId => {
+        const parentIds = new Set(layers.map((l) => l.parentId).filter((id) => id));
+        const layerIds = new Set(layers.map((l) => l.id));
+        parentIds.forEach((parentId) => {
             if (!layerIds.has(parentId)) {
                 conflicts.push(`Orphaned layer reference: ${parentId}`);
             }
@@ -392,7 +391,7 @@ export class LayerManager {
             }
             stack.delete(layerId);
         };
-        layers.forEach(layer => {
+        layers.forEach((layer) => {
             if (!visited.has(layer.id)) {
                 detectCycle(layer.id);
             }

package/lib/managers/ocr-manager.d.ts

@@ -9,9 +9,9 @@
  * Provides optical character recognition operations with complete type safety,
  * proper error handling, and full FFI integration.
  */
-import { BaseManager, OcrLanguage, OcrResult, OcrBatchResult, TextRegion, PdfDocumentHandle, ManagerOptions } from '../types/manager-types.js';
+import { BaseManager, type ManagerOptions, type OcrBatchResult, OcrLanguage, type OcrResult, type PdfDocumentHandle, type TextRegion } from '../types/manager-types.js';
+export type { OcrBatchResult, OcrResult, TextRegion };
 export { OcrLanguage };
-export type { OcrResult, OcrBatchResult, TextRegion };
 /**
  * OCR detection modes for accuracy/speed tradeoff
  */

package/lib/managers/ocr-manager.js

@@ -9,9 +9,9 @@
  * Provides optical character recognition operations with complete type safety,
  * proper error handling, and full FFI integration.
  */
-import { BaseManager, OcrLanguage, } from '../types/manager-types.js';
 import { promises as fs } from 'fs';
 import { dirname } from 'path';
+import { BaseManager, OcrLanguage, } from '../types/manager-types.js';
 // Re-export types for convenience
 export { OcrLanguage };
 /**
@@ -214,8 +214,7 @@ export class OcrManager extends BaseManager {
     async getAvailableLanguages() {
         try {
             this.recordOperation();
-            const languages = (await this.document?.getAvailableLanguages()) ||
-                Object.values(OcrLanguage);
+            const languages = (await this.document?.getAvailableLanguages()) || Object.values(OcrLanguage);
             return languages;
         }
         catch (error) {
@@ -260,7 +259,10 @@ export class OcrManager extends BaseManager {
                     content = JSON.stringify({ pageIndex, text, timestamp: Date.now() }, null, 2);
                     break;
                 case 'xml':
-                    content = `<?xml version="1.0"?>\n<page index="${pageIndex}">\n${text.split('\n').map(line => `  <line>${line}</line>`).join('\n')}\n</page>`;
+                    content = `<?xml version="1.0"?>\n<page index="${pageIndex}">\n${text
+                        .split('\n')
+                        .map((line) => `  <line>${line}</line>`)
+                        .join('\n')}\n</page>`;
                     break;
                 default:
                     content = text;
@@ -356,9 +358,7 @@ export class OcrManager extends BaseManager {
                     totalSpans += Math.max(regions.length, text ? 1 : 0);
                     confidenceSum += confidence;
                 }
-                catch {
-                    continue;
-                }
+                catch { }
             }
             const processedPages = endPage - startPage + 1 - skippedPages;
             const avgConfidence = processedPages > 0 ? confidenceSum / processedPages : 0;

package/lib/managers/optimization-manager.js

@@ -96,7 +96,11 @@ export class OptimizationManager extends EventEmitter {
             throw mapFfiErrorCode(code, 'Failed to downsample images');
         }
         const result = this.parseOptimizationResult(resultPtr);
-        this.emit('images-downsampled', { dpi: dpi ?? 150, quality: quality ?? 80, bytesSaved: result.bytesSaved });
+        this.emit('images-downsampled', {
+            dpi: dpi ?? 150,
+            quality: quality ?? 80,
+            bytesSaved: result.bytesSaved,
+        });
         this.freeOptimizationResult(resultPtr);
         return result;
     }
@@ -146,7 +150,11 @@ export class OptimizationManager extends EventEmitter {
             throw mapFfiErrorCode(code, 'Failed to run full optimization');
         }
         const result = this.parseOptimizationResult(resultPtr);
-        this.emit('optimized-full', { dpi: dpi ?? 150, quality: quality ?? 80, bytesSaved: result.bytesSaved });
+        this.emit('optimized-full', {
+            dpi: dpi ?? 150,
+            quality: quality ?? 80,
+            bytesSaved: result.bytesSaved,
+        });
         this.freeOptimizationResult(resultPtr);
         return result;
     }
@@ -155,14 +163,26 @@ export class OptimizationManager extends EventEmitter {
     // ===========================================================================
     parseOptimizationResult(resultPtr) {
         if (!resultPtr) {
-            return { success: true, bytesSaved: 0, originalSize: 0, optimizedSize: 0, compressionRatio: 0 };
+            return {
+                success: true,
+                bytesSaved: 0,
+                originalSize: 0,
+                optimizedSize: 0,
+                compressionRatio: 0,
+            };
         }
         if (typeof resultPtr === 'string') {
             try {
                 return JSON.parse(resultPtr);
             }
             catch {
-                return { success: true, bytesSaved: 0, originalSize: 0, optimizedSize: 0, compressionRatio: 0 };
+                return {
+                    success: true,
+                    bytesSaved: 0,
+                    originalSize: 0,
+                    optimizedSize: 0,
+                    compressionRatio: 0,
+                };
             }
         }
         // Handle native result handle

package/lib/managers/page-manager.js

@@ -185,8 +185,8 @@ export class PageManager {
                 hasVariableSizes: false,
             };
         }
-        const widths = pages.map(p => p.width);
-        const heights = pages.map(p => p.height);
+        const widths = pages.map((p) => p.width);
+        const heights = pages.map((p) => p.height);
         const minWidth = Math.min(...widths);
         const maxWidth = Math.max(...widths);
         const minHeight = Math.min(...heights);
@@ -214,8 +214,7 @@ export class PageManager {
      */
     getPagesInSizeRange(minWidth, maxWidth, minHeight, maxHeight) {
         const pages = this.getAllPageInfo();
-        return pages.filter(p => p.width >= minWidth && p.width <= maxWidth &&
-            p.height >= minHeight && p.height <= maxHeight);
+        return pages.filter((p) => p.width >= minWidth && p.width <= maxWidth && p.height >= minHeight && p.height <= maxHeight);
     }
     /**
      * Gets landscape pages
@@ -223,7 +222,7 @@ export class PageManager {
      */
     getLandscapePages() {
         const pages = this.getAllPageInfo();
-        return pages.filter(p => p.width > p.height);
+        return pages.filter((p) => p.width > p.height);
     }
     /**
      * Gets portrait pages
@@ -231,6 +230,6 @@ export class PageManager {
      */
     getPortraitPages() {
         const pages = this.getAllPageInfo();
-        return pages.filter(p => p.height > p.width);
+        return pages.filter((p) => p.height > p.width);
     }
 }

package/lib/managers/pattern-detection.d.ts

@@ -8,7 +8,7 @@
  * - Form field detection
  * - Layout pattern recognition
  */
-import type { PdfDocument } from "../types/document-types.js";
+import type { PdfDocument } from '../types/document-types.js';
 /**
  * Represents a detected table region on a page.
  */

package/lib/managers/pattern-detection.js

@@ -52,7 +52,7 @@ export class PatternDetectionManager {
         }
         // Simple heuristic: detect table-like patterns
         const tables = [];
-        const lines = text.split("\n");
+        const lines = text.split('\n');
         // Look for lines with multiple columns (tabs or spaces)
         let currentTableStart = -1;
         let tableLines = 0;
@@ -101,7 +101,7 @@ export class PatternDetectionManager {
         }
         // Simple heuristic: detect multi-column layouts
         const columns = [];
-        const lines = text.split("\n");
+        const lines = text.split('\n');
         // Check for indentation patterns suggesting columns
         const indentationPattern = new Map();
         for (const line of lines) {
@@ -184,7 +184,7 @@ export class PatternDetectionManager {
                 y: f.y || 0,
                 width: f.width || 100,
                 height: f.height || 20,
-                fieldType: f.type || "unknown",
+                fieldType: f.type || 'unknown',
                 fieldName: f.name,
                 confidence: 0.9,
             }));
@@ -279,9 +279,7 @@ export class PatternDetectionManager {
      */
     async findPagesWithPattern(patternType) {
         const patterns = await this.analyzeDocumentPatterns();
-        return patterns
-            .filter((p) => p.patternType === patternType)
-            .map((p) => p.pageIndex);
+        return patterns.filter((p) => p.patternType === patternType).map((p) => p.pageIndex);
     }
     /**
      * Get pattern statistics for the document.

package/lib/managers/search-manager.js

@@ -88,7 +88,7 @@ export class SearchManager {
         try {
             for (let i = 0; i < this._document.pageCount; i++) {
                 const results = this.search(searchText, i, options);
-                results.forEach(result => {
+                results.forEach((result) => {
                     result.pageIndex = i;
                     result.pageNumber = i + 1;
                 });
@@ -182,7 +182,7 @@ export class SearchManager {
      */
     getPagesContaining(searchText, options) {
         const results = this.searchAll(searchText, options);
-        const pageSet = new Set(results.map(r => r.pageIndex || 0));
+        const pageSet = new Set(results.map((r) => r.pageIndex || 0));
         return Array.from(pageSet).sort((a, b) => a - b);
     }
     /**
@@ -218,7 +218,7 @@ export class SearchManager {
             firstMatchPage: pages.length > 0 ? pages[0] : -1,
             lastMatchPage: pages.length > 0 ? pages[pages.length - 1] : -1,
             pages,
-            occurrencesPerPage: pages.map(p => ({
+            occurrencesPerPage: pages.map((p) => ({
                 pageIndex: p,
                 pageNumber: p + 1,
                 count: pageMap.get(p) || 0,

package/lib/managers/signature-manager.d.ts

@@ -718,6 +718,20 @@ export declare class SignatureManager extends EventEmitter {
     clearCache(): void;
     getCacheStats(): Record<string, any>;
     destroy(): void;
+    /**
+     * Sign a PDF from raw bytes using PEM credentials.
+     *
+     * Calls the native `signPdfBytes` FFI function (two-pass ByteRange writer).
+     * Credentials are loaded and freed within this call.
+     *
+     * @param pdfData - Buffer containing the PDF document bytes
+     * @param certPem - PEM-encoded certificate string
+     * @param keyPem  - PEM-encoded private key string
+     * @param reason  - Optional signature reason
+     * @param location - Optional signature location
+     * @returns Buffer containing the signed PDF
+     */
+    signPdfData(pdfData: Buffer, certPem: string, keyPem: string, reason?: string, location?: string): Promise<Buffer>;
     private setCached;
     private clearCachePattern;
 }