pdf-oxide 0.3.24 → 0.3.28

package/lib/managers/layer-manager.js

@@ -0,0 +1,403 @@
+/**
+ * Manager for PDF layers (Optional Content Groups - OCG)
+ *
+ * Provides methods to manage and interact with PDF layers which are used
+ * for optional content groups in PDF documents.
+ *
+ * @example
+ * ```typescript
+ * import { LayerManager } from 'pdf_oxide';
+ *
+ * const doc = PdfDocument.open('document.pdf');
+ * const layerManager = new LayerManager(doc);
+ *
+ * // Check if document has layers
+ * if (layerManager.hasLayers()) {
+ *   const layers = layerManager.getLayers();
+ *   console.log(`Document has ${layers.length} layers`);
+ * }
+ * ```
+ */
+export class LayerManager {
+    /**
+     * Creates a new LayerManager for the given document
+     * @param document - The PDF document
+     * @throws Error if document is null or undefined
+     */
+    constructor(document) {
+        if (!document) {
+            throw new Error('Document is required');
+        }
+        this._document = document;
+        // Performance optimization: cache layer data
+        this._layerCache = null;
+        this._hierarchyCache = null;
+        this._statisticsCache = null;
+    }
+    /**
+     * Clears the layer cache
+     * Useful when document content might have changed
+     */
+    clearCache() {
+        this._layerCache = null;
+        this._hierarchyCache = null;
+        this._statisticsCache = null;
+    }
+    /**
+     * Checks if document has layers
+     * @returns True if document contains layers
+     */
+    hasLayers() {
+        try {
+            return this.getLayerCount() > 0;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    /**
+     * Gets number of layers in document
+     * @returns Number of layers
+     */
+    getLayerCount() {
+        const layers = this.getLayers();
+        return layers.length;
+    }
+    /**
+     * Gets all layers in document
+     * @returns Array of layer objects with id, name, visible, etc.
+     *
+     * @example
+     * ```typescript
+     * const layers = manager.getLayers();
+     * layers.forEach(layer => {
+     *   console.log(`Layer: ${layer.name} (visible: ${layer.visible})`);
+     * });
+     * ```
+     */
+    getLayers() {
+        // Performance optimization: cache layer data
+        if (this._layerCache !== null) {
+            return this._layerCache;
+        }
+        try {
+            const rawLayers = this._document.getLayers();
+            // Convert native LayerInfo to the expected JS format
+            const layers = rawLayers.map((layer) => ({
+                id: layer.id,
+                name: layer.name,
+                visible: layer.visible,
+                index: layer.index,
+                parentId: null, // OCGs don't have hierarchy in PDF spec
+                printable: true, // Default assumption
+                export: true, // Default assumption
+            }));
+            this._layerCache = layers;
+            return layers;
+        }
+        catch (error) {
+            return [];
+        }
+    }
+    /**
+     * Gets layer by name
+     * @param name - Layer name to find
+     * @returns Layer object or null if not found
+     *
+     * @example
+     * ```typescript
+     * const layer = manager.getLayerByName('Background');
+     * if (layer) {
+     *   console.log(`Found layer: ${layer.name}`);
+     * }
+     * ```
+     */
+    getLayerByName(name) {
+        if (!name || typeof name !== 'string') {
+            throw new Error('Layer name must be a non-empty string');
+        }
+        const layers = this.getLayers();
+        return layers.find(layer => layer.name === name) || null;
+    }
+    /**
+     * Gets layer by ID
+     * @param id - Layer ID to find
+     * @returns Layer object or null if not found
+     */
+    getLayerById(id) {
+        if (!id || typeof id !== 'string') {
+            throw new Error('Layer ID must be a non-empty string');
+        }
+        const layers = this.getLayers();
+        return layers.find(layer => layer.id === id) || null;
+    }
+    /**
+     * Gets root-level layers (not nested under other layers)
+     * @returns Array of root-level layers
+     */
+    getRootLayers() {
+        const layers = this.getLayers();
+        return layers.filter(layer => !layer.parentId);
+    }
+    /**
+     * Gets the full layer hierarchy as a tree structure
+     * @returns Layer hierarchy tree
+     *
+     * @example
+     * ```typescript
+     * const hierarchy = manager.getLayerHierarchy();
+     * // { root: [{ name: 'Layer1', children: [...] }, ...] }
+     * ```
+     */
+    getLayerHierarchy() {
+        // Performance optimization: cache hierarchy
+        if (this._hierarchyCache !== null) {
+            return this._hierarchyCache;
+        }
+        const layers = this.getLayers();
+        const hierarchy = { root: [] };
+        // Build parent-child relationships
+        const layerMap = new Map(layers.map((l) => [l.id, { ...l, children: [] }]));
+        for (const layer of layerMap.values()) {
+            if (layer.parentId) {
+                const parent = layerMap.get(layer.parentId);
+                if (parent) {
+                    parent.children.push(layer);
+                }
+            }
+            else {
+                hierarchy.root.push(layer);
+            }
+        }
+        this._hierarchyCache = hierarchy;
+        return hierarchy;
+    }
+    /**
+     * Gets child layers of a parent layer
+     * @param parentId - Parent layer ID
+     * @returns Array of child layers
+     */
+    getChildLayers(parentId) {
+        if (!parentId || typeof parentId !== 'string') {
+            throw new Error('Parent layer ID must be a non-empty string');
+        }
+        const layers = this.getLayers();
+        return layers.filter(layer => layer.parentId === parentId);
+    }
+    /**
+     * Gets parent layer of a layer
+     * @param layerId - Layer ID
+     * @returns Parent layer object or null if no parent
+     */
+    getParentLayer(layerId) {
+        if (!layerId || typeof layerId !== 'string') {
+            throw new Error('Layer ID must be a non-empty string');
+        }
+        const layer = this.getLayerById(layerId);
+        if (!layer || !layer.parentId) {
+            return null;
+        }
+        return this.getLayerById(layer.parentId);
+    }
+    /**
+     * Checks if a layer is visible
+     * @param layerId - Layer ID
+     * @returns True if layer is visible
+     */
+    isLayerVisible(layerId) {
+        const layer = this.getLayerById(layerId);
+        return layer ? layer.visible !== false : false;
+    }
+    /**
+     * Gets visibility chain from root to layer
+     * Shows visibility state of all parent layers
+     * @param layerId - Layer ID
+     * @returns Array of layers from root to target
+     */
+    getVisibilityChain(layerId) {
+        const chain = [];
+        let current = this.getLayerById(layerId);
+        while (current) {
+            chain.unshift(current);
+            current = current.parentId ? this.getLayerById(current.parentId) : null;
+        }
+        return chain;
+    }
+    /**
+     * Gets layer usage information
+     * @returns Layer usage { view, print, export }
+     */
+    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,
+        };
+    }
+    /**
+     * Gets statistics about layers
+     * @returns Layer statistics
+     *
+     * @example
+     * ```typescript
+     * const stats = manager.getLayerStatistics();
+     * console.log(`Total layers: ${stats.count}`);
+     * console.log(`Max depth: ${stats.maxDepth}`);
+     * ```
+     */
+    getLayerStatistics() {
+        // Performance optimization: cache statistics
+        if (this._statisticsCache !== null) {
+            return this._statisticsCache;
+        }
+        const layers = this.getLayers();
+        const hierarchy = this.getLayerHierarchy();
+        // Calculate max depth
+        const calculateDepth = (node, depth = 0) => {
+            if (!node.children || node.children.length === 0) {
+                return depth;
+            }
+            return Math.max(...node.children.map((child) => calculateDepth(child, depth + 1)));
+        };
+        let maxDepth = 0;
+        for (const rootLayer of hierarchy.root) {
+            maxDepth = Math.max(maxDepth, calculateDepth(rootLayer));
+        }
+        const stats = {
+            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,
+            hasConflicts: this._detectLayerConflicts().length > 0,
+        };
+        this._statisticsCache = stats;
+        return stats;
+    }
+    /**
+     * Gets layer dependencies
+     * @returns Layer dependencies map
+     * @private
+     */
+    getLayerDependencies() {
+        const layers = this.getLayers();
+        const dependencies = {};
+        layers.forEach(layer => {
+            dependencies[layer.id] = {
+                dependsOn: layer.dependsOn || [],
+                dependents: [],
+            };
+        });
+        // Build reverse dependencies
+        Object.entries(dependencies).forEach(([layerId, deps]) => {
+            deps.dependsOn.forEach((depId) => {
+                if (dependencies[depId]) {
+                    dependencies[depId].dependents.push(layerId);
+                }
+            });
+        });
+        return dependencies;
+    }
+    /**
+     * Finds layers by pattern
+     * @param pattern - Pattern to match
+     * @returns Matching layers
+     *
+     * @example
+     * ```typescript
+     * const backgroundLayers = manager.findLayersByPattern(/background/i);
+     * ```
+     */
+    findLayersByPattern(pattern) {
+        if (!pattern) {
+            throw new Error('Pattern must be provided');
+        }
+        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)));
+    }
+    /**
+     * Validates layer state for conflicts and issues
+     * @returns Validation result { isValid, issues }
+     */
+    validateLayerState() {
+        const issues = [];
+        const conflicts = this._detectLayerConflicts();
+        const cycles = this._detectLayerCycles();
+        if (conflicts.length > 0) {
+            issues.push(...conflicts.map(c => `Conflict: ${c}`));
+        }
+        if (cycles.length > 0) {
+            issues.push(...cycles.map(c => `Cycle detected: ${c}`));
+        }
+        return {
+            isValid: issues.length === 0,
+            issues,
+        };
+    }
+    /**
+     * Detects layer conflicts
+     * @returns Array of conflict descriptions
+     * @private
+     */
+    _detectLayerConflicts() {
+        const conflicts = [];
+        const layers = this.getLayers();
+        // Check for layers with same name
+        const nameMap = new Map();
+        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 => {
+            if (!layerIds.has(parentId)) {
+                conflicts.push(`Orphaned layer reference: ${parentId}`);
+            }
+        });
+        return conflicts;
+    }
+    /**
+     * Detects cycles in layer hierarchy
+     * @returns Array of cycle descriptions
+     * @private
+     */
+    _detectLayerCycles() {
+        const cycles = [];
+        const layers = this.getLayers();
+        const visited = new Set();
+        const stack = new Set();
+        const detectCycle = (layerId, path = []) => {
+            if (stack.has(layerId)) {
+                cycles.push(`Cycle detected: ${path.join(' -> ')} -> ${layerId}`);
+                return;
+            }
+            if (visited.has(layerId)) {
+                return;
+            }
+            visited.add(layerId);
+            stack.add(layerId);
+            path.push(layerId);
+            const layer = this.getLayerById(layerId);
+            if (layer && layer.parentId) {
+                detectCycle(layer.parentId, [...path]);
+            }
+            stack.delete(layerId);
+        };
+        layers.forEach(layer => {
+            if (!visited.has(layer.id)) {
+                detectCycle(layer.id);
+            }
+        });
+        return cycles;
+    }
+}
+//# sourceMappingURL=layer-manager.js.map

package/lib/managers/layer-manager.js.map

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

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

@@ -0,0 +1,149 @@
+/**
+ * Manager for PDF document metadata
+ *
+ * Provides access to document metadata properties such as title, author,
+ * subject, keywords, creation and modification dates, and custom properties.
+ *
+ * @example
+ * ```typescript
+ * import { MetadataManager } from 'pdf_oxide';
+ *
+ * const doc = PdfDocument.open('document.pdf');
+ * const metadataManager = new MetadataManager(doc);
+ *
+ * console.log(`Title: ${metadataManager.getTitle()}`);
+ * console.log(`Author: ${metadataManager.getAuthor()}`);
+ * console.log(`Created: ${metadataManager.getCreationDate()}`);
+ * ```
+ */
+export interface MetadataComparison {
+    matching: Record<string, any>;
+    differing: Record<string, {
+        document1: any;
+        document2: any;
+    }>;
+}
+export interface ValidationResult {
+    isComplete: boolean;
+    issues: string[];
+    missingFieldCount: number;
+}
+export declare class MetadataManager {
+    private _document;
+    /**
+     * Creates a new MetadataManager for the given document
+     * @param document - The PDF document
+     * @throws Error if document is null or undefined
+     */
+    constructor(document: any);
+    /**
+     * Gets the document title
+     * @returns Document title or null if not set
+     */
+    getTitle(): string | null;
+    /**
+     * Gets the document author
+     * @returns Document author or null if not set
+     */
+    getAuthor(): string | null;
+    /**
+     * Gets the document subject
+     * @returns Document subject or null if not set
+     */
+    getSubject(): string | null;
+    /**
+     * Gets the document keywords
+     * @returns Array of document keywords (empty if none)
+     */
+    getKeywords(): string[];
+    /**
+     * Gets the document creator application
+     * @returns Creator application or null if not set
+     */
+    getCreator(): string | null;
+    /**
+     * Gets the document producer application
+     * @returns Producer application or null if not set
+     */
+    getProducer(): string | null;
+    /**
+     * Gets the document creation date
+     * @returns Creation date or null if not set
+     */
+    getCreationDate(): Date | null;
+    /**
+     * Gets the document modification date
+     * @returns Modification date or null if not set
+     */
+    getModificationDate(): Date | null;
+    /**
+     * Gets all metadata as a single object
+     * @returns Complete metadata object
+     *
+     * @example
+     * ```typescript
+     * const metadata = manager.getAllMetadata();
+     * console.log(JSON.stringify(metadata, null, 2));
+     * ```
+     */
+    getAllMetadata(): Record<string, any>;
+    /**
+     * Checks if metadata has been set
+     * @returns True if any metadata is present
+     */
+    hasMetadata(): boolean;
+    /**
+     * Gets a summary of key metadata fields
+     * @returns Formatted metadata summary
+     *
+     * @example
+     * ```typescript
+     * console.log(manager.getMetadataSummary());
+     * // Output: Title: My Document, Author: John Doe, Pages: 42
+     * ```
+     */
+    getMetadataSummary(): string;
+    /**
+     * Checks if a specific keyword is present
+     * @param keyword - Keyword to search for
+     * @returns True if keyword is found
+     */
+    hasKeyword(keyword: string): boolean;
+    /**
+     * Gets the number of keywords
+     * @returns Keyword count
+     */
+    getKeywordCount(): number;
+    /**
+     * Gets metadata comparison with another document
+     * @param otherDocument - Document to compare with
+     * @returns Comparison object with matching and differing fields
+     *
+     * @example
+     * ```typescript
+     * const doc1 = PdfDocument.open('file1.pdf');
+     * const doc2 = PdfDocument.open('file2.pdf');
+     * const mgr1 = new MetadataManager(doc1);
+     * const comparison = mgr1.compareWith(doc2);
+     * console.log(comparison.matching); // Fields that match
+     * console.log(comparison.differing); // Fields that differ
+     * ```
+     */
+    compareWith(otherDocument: any): MetadataComparison;
+    /**
+     * Validates metadata completeness
+     * @returns Validation result with issues array
+     *
+     * @example
+     * ```typescript
+     * const validation = manager.validate();
+     * if (validation.isComplete) {
+     *   console.log('Metadata is complete');
+     * } else {
+     *   console.log('Issues:', validation.issues);
+     * }
+     * ```
+     */
+    validate(): ValidationResult;
+}
+//# sourceMappingURL=metadata-manager.d.ts.map

package/lib/managers/metadata-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata-manager.d.ts","sourceRoot":"","sources":["../../src/managers/metadata-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,GAAG,CAAC;QAAC,SAAS,EAAE,GAAG,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAM;IAEvB;;;;OAIG;gBACS,QAAQ,EAAE,GAAG;IAOzB;;;OAGG;IACH,QAAQ,IAAI,MAAM,GAAG,IAAI;IAQzB;;;OAGG;IACH,SAAS,IAAI,MAAM,GAAG,IAAI;IAQ1B;;;OAGG;IACH,UAAU,IAAI,MAAM,GAAG,IAAI;IAQ3B;;;OAGG;IACH,WAAW,IAAI,MAAM,EAAE;IAQvB;;;OAGG;IACH,UAAU,IAAI,MAAM,GAAG,IAAI;IAQ3B;;;OAGG;IACH,WAAW,IAAI,MAAM,GAAG,IAAI;IAQ5B;;;OAGG;IACH,eAAe,IAAI,IAAI,GAAG,IAAI;IAQ9B;;;OAGG;IACH,mBAAmB,IAAI,IAAI,GAAG,IAAI;IAQlC;;;;;;;;;OASG;IACH,cAAc,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAQrC;;;OAGG;IACH,WAAW,IAAI,OAAO;IAKtB;;;;;;;;;OASG;IACH,kBAAkB,IAAI,MAAM;IA2B5B;;;;OAIG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IASpC;;;OAGG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;;;;;;;;;;;OAcG;IACH,WAAW,CAAC,aAAa,EAAE,GAAG,GAAG,kBAAkB;IA+BnD;;;;;;;;;;;;;OAaG;IACH,QAAQ,IAAI,gBAAgB;CAe7B"}