pdf-oxide-fips 0.3.47

package/lib/managers/enterprise-manager.js

@@ -0,0 +1,307 @@
+/**
+ * EnterpriseManager - Enterprise PDF Operations
+ *
+ * Provides enterprise-level PDF operations including:
+ * - Bates numbering (standard and advanced)
+ * - Page-level and document-level comparison
+ * - Header and footer stamping
+ *
+ * @since 1.0.0
+ */
+import { EventEmitter } from 'events';
+import { mapFfiErrorCode, PdfException } from '../errors.js';
+// =============================================================================
+// Enums
+// =============================================================================
+/**
+ * Position for Bates number placement.
+ */
+export var BatesPosition;
+(function (BatesPosition) {
+    BatesPosition[BatesPosition["TOP_LEFT"] = 0] = "TOP_LEFT";
+    BatesPosition[BatesPosition["TOP_CENTER"] = 1] = "TOP_CENTER";
+    BatesPosition[BatesPosition["TOP_RIGHT"] = 2] = "TOP_RIGHT";
+    BatesPosition[BatesPosition["BOTTOM_LEFT"] = 3] = "BOTTOM_LEFT";
+    BatesPosition[BatesPosition["BOTTOM_CENTER"] = 4] = "BOTTOM_CENTER";
+    BatesPosition[BatesPosition["BOTTOM_RIGHT"] = 5] = "BOTTOM_RIGHT";
+})(BatesPosition || (BatesPosition = {}));
+/**
+ * Text alignment for header/footer stamps.
+ */
+export var StampAlignment;
+(function (StampAlignment) {
+    StampAlignment[StampAlignment["LEFT"] = 0] = "LEFT";
+    StampAlignment[StampAlignment["CENTER"] = 1] = "CENTER";
+    StampAlignment[StampAlignment["RIGHT"] = 2] = "RIGHT";
+})(StampAlignment || (StampAlignment = {}));
+/**
+ * Types of differences found in page comparison.
+ */
+export var DifferenceType;
+(function (DifferenceType) {
+    DifferenceType[DifferenceType["TEXT_ADDED"] = 0] = "TEXT_ADDED";
+    DifferenceType[DifferenceType["TEXT_REMOVED"] = 1] = "TEXT_REMOVED";
+    DifferenceType[DifferenceType["TEXT_CHANGED"] = 2] = "TEXT_CHANGED";
+    DifferenceType[DifferenceType["IMAGE_ADDED"] = 3] = "IMAGE_ADDED";
+    DifferenceType[DifferenceType["IMAGE_REMOVED"] = 4] = "IMAGE_REMOVED";
+    DifferenceType[DifferenceType["IMAGE_CHANGED"] = 5] = "IMAGE_CHANGED";
+    DifferenceType[DifferenceType["LAYOUT_CHANGED"] = 6] = "LAYOUT_CHANGED";
+    DifferenceType[DifferenceType["ANNOTATION_CHANGED"] = 7] = "ANNOTATION_CHANGED";
+})(DifferenceType || (DifferenceType = {}));
+// =============================================================================
+// EnterpriseManager
+// =============================================================================
+/**
+ * Manager for enterprise PDF operations.
+ *
+ * Provides methods for Bates numbering, document comparison,
+ * and header/footer stamping.
+ *
+ * @example
+ * ```typescript
+ * const enterprise = new EnterpriseManager(document);
+ *
+ * // Apply Bates numbering
+ * await enterprise.applyBates('DOC', 1, 6, BatesPosition.BOTTOM_RIGHT);
+ *
+ * // Compare pages
+ * const result = await enterprise.comparePages(docA, 0, docB, 0);
+ * console.log(`Pages are ${(result.similarity * 100).toFixed(1)}% similar`);
+ *
+ * // Stamp headers and footers
+ * await enterprise.stampHeader('CONFIDENTIAL', StampAlignment.CENTER, 12, 36);
+ * ```
+ */
+export class EnterpriseManager extends EventEmitter {
+    constructor(document) {
+        super();
+        if (!document) {
+            throw new Error('Document cannot be null or undefined');
+        }
+        this.document = document;
+        try {
+            this.native = require('../../index.node');
+        }
+        catch {
+            this.native = null;
+        }
+    }
+    // ===========================================================================
+    // Bates Numbering
+    // ===========================================================================
+    /**
+     * Applies Bates numbering to the document.
+     *
+     * @param prefix - Text prefix before the number (e.g., 'DOC')
+     * @param startNumber - Starting number
+     * @param numDigits - Number of digits (zero-padded)
+     * @param position - Position on the page
+     * @throws PdfException if the operation fails
+     */
+    async applyBates(prefix, startNumber, numDigits, position) {
+        if (!this.native?.pdf_bates_apply) {
+            throw new PdfException('9900', 'Native enterprise not available: pdf_bates_apply not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        this.native.pdf_bates_apply(this.document._handle ?? this.document, prefix, startNumber, numDigits, position, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to apply Bates numbering');
+        }
+        this.emit('bates-applied', { prefix, startNumber, numDigits, position });
+    }
+    /**
+     * Applies advanced Bates numbering with full configuration.
+     *
+     * @param prefix - Text prefix before the number
+     * @param suffix - Text suffix after the number
+     * @param startNumber - Starting number
+     * @param numDigits - Number of digits (zero-padded)
+     * @param position - Position on the page
+     * @param fontSize - Font size in points
+     * @param margin - Margin from page edge in points
+     * @param startPage - Starting page index (0-based)
+     * @param endPage - Ending page index (0-based, -1 for last page)
+     * @throws PdfException if the operation fails
+     */
+    async applyBatesAdvanced(prefix, suffix, startNumber, numDigits, position, fontSize, margin, startPage, endPage) {
+        if (!this.native?.pdf_bates_apply_advanced) {
+            throw new PdfException('9900', 'Native enterprise not available: pdf_bates_apply_advanced not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        this.native.pdf_bates_apply_advanced(this.document._handle ?? this.document, prefix, suffix, startNumber, numDigits, position, fontSize, margin, startPage, endPage, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to apply advanced Bates numbering');
+        }
+        this.emit('bates-applied-advanced', { prefix, suffix, startNumber, numDigits, position });
+    }
+    // ===========================================================================
+    // Document Comparison
+    // ===========================================================================
+    /**
+     * Compares two pages from potentially different documents.
+     *
+     * @param docA - First document handle
+     * @param pageA - Page index in first document (0-based)
+     * @param docB - Second document handle
+     * @param pageB - Page index in second document (0-based)
+     * @returns Comparison result with similarity score and differences
+     * @throws PdfException if the comparison fails
+     */
+    async comparePages(docA, pageA, docB, pageB) {
+        if (!this.native?.pdf_compare_pages) {
+            throw new PdfException('9900', 'Native enterprise not available: pdf_compare_pages not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        const comparisonPtr = this.native.pdf_compare_pages(docA._handle ?? docA, pageA, docB._handle ?? docB, pageB, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to compare pages');
+        }
+        try {
+            const similarity = this.native.pdf_comparison_get_similarity?.(comparisonPtr) ?? 0;
+            const diffCount = this.native.pdf_comparison_get_diff_count?.(comparisonPtr) ?? 0;
+            const differences = [];
+            for (let i = 0; i < diffCount; i++) {
+                const diffPtr = this.native.pdf_comparison_get_diff?.(comparisonPtr, i);
+                if (diffPtr) {
+                    const diffType = this.native.pdf_comparison_get_diff_type?.(diffPtr) ?? 0;
+                    differences.push({
+                        type: diffType,
+                        description: `Difference ${i + 1}`,
+                    });
+                }
+            }
+            const result = { similarity, diffCount, differences };
+            this.emit('pages-compared', { pageA, pageB, similarity });
+            return result;
+        }
+        finally {
+            if (this.native.pdf_comparison_free) {
+                this.native.pdf_comparison_free(comparisonPtr);
+            }
+        }
+    }
+    /**
+     * Compares two entire documents page by page.
+     *
+     * @param docA - First document handle
+     * @param docB - Second document handle
+     * @returns Document-level comparison result
+     * @throws PdfException if the comparison fails
+     */
+    async compareDocuments(docA, docB) {
+        if (!this.native?.pdf_compare_documents) {
+            throw new PdfException('9900', 'Native enterprise not available: pdf_compare_documents not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        const resultPtr = this.native.pdf_compare_documents(docA._handle ?? docA, docB._handle ?? docB, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to compare documents');
+        }
+        try {
+            let result;
+            if (typeof resultPtr === 'string') {
+                result = JSON.parse(resultPtr);
+            }
+            else {
+                result = resultPtr ?? {
+                    similarity: 0,
+                    pageResults: [],
+                    pagesA: 0,
+                    pagesB: 0,
+                    totalDifferences: 0,
+                };
+            }
+            this.emit('documents-compared', {
+                similarity: result.similarity,
+                totalDifferences: result.totalDifferences,
+            });
+            return result;
+        }
+        finally {
+            if (this.native.pdf_document_comparison_free && typeof resultPtr !== 'string') {
+                this.native.pdf_document_comparison_free(resultPtr);
+            }
+        }
+    }
+    // ===========================================================================
+    // Header / Footer Stamping
+    // ===========================================================================
+    /**
+     * Stamps a header on all pages of the document.
+     *
+     * @param text - Header text (supports placeholders: {page}, {pages}, {date})
+     * @param align - Text alignment
+     * @param size - Font size in points
+     * @param margin - Top margin in points
+     * @throws PdfException if the operation fails
+     */
+    async stampHeader(text, align, size, margin) {
+        if (!this.native?.pdf_stamp_header) {
+            throw new PdfException('9900', 'Native enterprise not available: pdf_stamp_header not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        this.native.pdf_stamp_header(this.document._handle ?? this.document, text, align, size, margin, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to stamp header');
+        }
+        this.emit('header-stamped', { text, align, size, margin });
+    }
+    /**
+     * Stamps a footer on all pages of the document.
+     *
+     * @param text - Footer text (supports placeholders: {page}, {pages}, {date})
+     * @param align - Text alignment
+     * @param size - Font size in points
+     * @param margin - Bottom margin in points
+     * @throws PdfException if the operation fails
+     */
+    async stampFooter(text, align, size, margin) {
+        if (!this.native?.pdf_stamp_footer) {
+            throw new PdfException('9900', 'Native enterprise not available: pdf_stamp_footer not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        this.native.pdf_stamp_footer(this.document._handle ?? this.document, text, align, size, margin, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to stamp footer');
+        }
+        this.emit('footer-stamped', { text, align, size, margin });
+    }
+    /**
+     * Stamps both header and footer on all pages of the document.
+     *
+     * @param headerText - Header text
+     * @param footerText - Footer text
+     * @param align - Text alignment for both
+     * @param size - Font size in points
+     * @param margin - Margin from page edge in points
+     * @throws PdfException if the operation fails
+     */
+    async stampHeaderFooter(headerText, footerText, align, size, margin) {
+        if (!this.native?.pdf_stamp_header_footer) {
+            throw new PdfException('9900', 'Native enterprise not available: pdf_stamp_header_footer not found');
+        }
+        const errorCode = Buffer.alloc(4);
+        this.native.pdf_stamp_header_footer(this.document._handle ?? this.document, headerText, footerText, align, size, margin, errorCode);
+        const code = errorCode.readInt32LE(0);
+        if (code !== 0) {
+            throw mapFfiErrorCode(code, 'Failed to stamp header and footer');
+        }
+        this.emit('header-footer-stamped', { headerText, footerText, align, size, margin });
+    }
+    // ===========================================================================
+    // Cleanup
+    // ===========================================================================
+    /**
+     * Releases resources held by this manager.
+     */
+    destroy() {
+        this.removeAllListeners();
+    }
+}
+export default EnterpriseManager;

package/lib/managers/extended-managers.d.ts

@@ -0,0 +1,122 @@
+import { EventEmitter } from 'events';
+/**
+ * Phase 6: Extended Managers and Utilities
+ * - Document Extensions (25) + Performance (15) + Batch Processing (12) + Utilities (18) = 70 Functions
+ */
+export interface DocumentMetadata {
+    title?: string;
+    author?: string;
+    subject?: string;
+    keywords?: string;
+    creator?: string;
+    producer?: string;
+    creationDate?: string;
+    modificationDate?: string;
+    pages: number;
+    encrypted: boolean;
+}
+export interface PerformanceMetrics {
+    operation: string;
+    durationMs: number;
+    memoryUsedKb: number;
+    itemsProcessed: number;
+    throughputPerSec: number;
+}
+export interface BatchJob {
+    jobId: string;
+    filePath: string;
+    operation: string;
+    status: 'pending' | 'processing' | 'completed' | 'failed' | 'cancelled';
+    progress: number;
+    errorMessage?: string;
+}
+export interface ExtractionResult {
+    success: boolean;
+    data?: string;
+    format: 'text' | 'json' | 'xml' | 'csv';
+    byteSize: number;
+    extractionTimeMs: number;
+}
+export declare class DocumentExtendedManager extends EventEmitter {
+    private document;
+    private metadataCache;
+    constructor(document: any);
+    getDocumentTitle(): Promise<string | null>;
+    setDocumentTitle(title: string): Promise<boolean>;
+    getDocumentAuthor(): Promise<string | null>;
+    setDocumentAuthor(author: string): Promise<boolean>;
+    getDocumentSubject(): Promise<string | null>;
+    setDocumentSubject(subject: string): Promise<boolean>;
+    getDocumentKeywords(): Promise<string | null>;
+    setDocumentKeywords(keywords: string): Promise<boolean>;
+    getDocumentCreator(): Promise<string | null>;
+    getDocumentProducer(): Promise<string | null>;
+    getDocumentCreationDate(): Promise<string | null>;
+    getDocumentModificationDate(): Promise<string | null>;
+    isDocumentEncrypted(): Promise<boolean>;
+    getEncryptionLevel(): Promise<string | null>;
+    isDocumentUserProtected(): Promise<boolean>;
+    isDocumentOwnerProtected(): Promise<boolean>;
+    getDocumentSize(): Promise<number>;
+    getPageMediaBox(pageIndex: number): Promise<[number, number, number, number] | null>;
+    getPageCropBox(pageIndex: number): Promise<[number, number, number, number] | null>;
+    getPageRotation(pageIndex: number): Promise<number>;
+    setPageRotation(pageIndex: number, rotation: number): Promise<boolean>;
+    getPageCount(): Promise<number>;
+    getDocumentMetadata(): Promise<DocumentMetadata | null>;
+}
+export declare class PerformanceManager extends EventEmitter {
+    private document;
+    private metrics;
+    constructor(document: any);
+    startTimer(operationName: string): Promise<string>;
+    stopTimer(timerId: string): Promise<PerformanceMetrics | null>;
+    getOperationTime(operation: string): Promise<number | null>;
+    getMemoryUsage(): Promise<number>;
+    enableCaching(): Promise<boolean>;
+    disableCaching(): Promise<boolean>;
+    clearCache(): Promise<boolean>;
+    getCacheSize(): Promise<number>;
+    setCacheLimit(limitMb: number): Promise<boolean>;
+    getMetrics(): Promise<PerformanceMetrics[]>;
+    resetMetrics(): Promise<boolean>;
+    optimizeDocument(): Promise<boolean>;
+    getOptimizationReport(): Promise<Record<string, any> | null>;
+    enableLogging(level: string): Promise<boolean>;
+    disableLogging(): Promise<boolean>;
+}
+export declare class BatchProcessingManager extends EventEmitter {
+    private jobs;
+    constructor();
+    createBatchJob(jobId: string, filePath: string, operation: string): Promise<BatchJob | null>;
+    submitBatchJob(jobId: string): Promise<boolean>;
+    getBatchJobStatus(jobId: string): Promise<string | null>;
+    getBatchJobProgress(jobId: string): Promise<number>;
+    cancelBatchJob(jobId: string): Promise<boolean>;
+    waitForBatchJob(jobId: string, timeoutSec?: number): Promise<boolean>;
+    getBatchJobResult(jobId: string): Promise<string | null>;
+    listBatchJobs(status?: string): Promise<BatchJob[]>;
+    clearBatchJobs(completedOnly?: boolean): Promise<number>;
+    processBatch(files: string[], operation: string): Promise<string[]>;
+    getBatchResults(jobIds: string[]): Promise<Record<string, string | null>>;
+}
+export declare class UtilitiesManager extends EventEmitter {
+    private document;
+    constructor(document: any);
+    extractToText(outputFile: string): Promise<ExtractionResult | null>;
+    extractToJSON(outputFile: string): Promise<ExtractionResult | null>;
+    extractToXML(outputFile: string): Promise<ExtractionResult | null>;
+    validateDocument(): Promise<boolean>;
+    repairDocument(): Promise<boolean>;
+    mergePDFs(outputFile: string, otherFiles: string[]): Promise<boolean>;
+    splitPDF(outputDir: string, pagesPerFile: number): Promise<number>;
+    rotatePDF(rotationDegrees: number, outputFile: string): Promise<boolean>;
+    scalePDF(scaleFactor: number, outputFile: string): Promise<boolean>;
+    addWatermark(text: string, opacity?: number, rotation?: number): Promise<boolean>;
+    addPageNumbers(formatStr?: string, startPage?: number): Promise<boolean>;
+    removePages(pageIndices: number[]): Promise<boolean>;
+    reorderPages(newOrder: number[]): Promise<boolean>;
+    duplicatePages(pageIndex: number, count: number): Promise<boolean>;
+    blankPages(pageIndices: number[]): Promise<boolean>;
+    getDocumentStatistics(): Promise<Record<string, any> | null>;
+}