pdf-oxide-fips 0.3.47

package/lib/properties.js

@@ -0,0 +1,454 @@
+/**
+ * PDF Oxide Property Getters for Node.js
+ *
+ * Adds JavaScript property getters to native classes for idiomatic API.
+ * Converts Java-style getters (getPageCount()) to JavaScript properties (pageCount).
+ * Caches results where appropriate for performance.
+ */
+/**
+ * Adds property getters to PdfDocument class
+ * Converts methods to idiomatic JavaScript properties
+ *
+ * @param PdfDocument - The native PdfDocument class
+ * @returns Enhanced PdfDocument class with property getters
+ *
+ * @example
+ * ```typescript
+ * const { PdfDocument } = require('pdf_oxide');
+ * const doc = PdfDocument.open('file.pdf');
+ * console.log(doc.pageCount);  // Instead of doc.get_page_count()
+ * console.log(doc.version);     // Instead of doc.get_version()
+ * ```
+ */
+export function addPdfDocumentProperties(PdfDocument) {
+    if (!PdfDocument || !PdfDocument.prototype) {
+        return PdfDocument;
+    }
+    const prototype = PdfDocument.prototype;
+    // Cache for frequently accessed properties
+    const cache = new WeakMap();
+    /**
+     * Gets the PDF version as [major, minor]
+     * Caches result for performance
+     */
+    Object.defineProperty(prototype, 'version', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.version) {
+                obj.version = this.get_version ? this.get_version() : [1, 4];
+            }
+            return obj.version;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets the number of pages
+     * Caches result for performance
+     */
+    Object.defineProperty(prototype, 'pageCount', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (obj.pageCount === undefined) {
+                try {
+                    obj.pageCount = this.get_page_count ? this.get_page_count() : 0;
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.pageCount;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Checks if document has structure tree (Tagged PDF)
+     */
+    Object.defineProperty(prototype, 'hasStructureTree', {
+        get() {
+            return this.has_structure_tree ? this.has_structure_tree() : false;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets document information metadata
+     */
+    Object.defineProperty(prototype, 'documentInfo', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.documentInfo) {
+                try {
+                    obj.documentInfo = this.get_document_info ? this.get_document_info() : {};
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.documentInfo;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets document XMP metadata
+     */
+    Object.defineProperty(prototype, 'metadata', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.metadata) {
+                try {
+                    obj.metadata = this.get_metadata ? this.get_metadata() : {};
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.metadata;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets document forms (AcroForm)
+     */
+    Object.defineProperty(prototype, 'forms', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.forms) {
+                try {
+                    obj.forms = this.get_forms ? this.get_forms() : null;
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.forms;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets page labels
+     */
+    Object.defineProperty(prototype, 'pageLabels', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.pageLabels) {
+                try {
+                    obj.pageLabels = this.get_page_labels ? this.get_page_labels() : [];
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.pageLabels;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets embedded files
+     */
+    Object.defineProperty(prototype, 'embeddedFiles', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.embeddedFiles) {
+                try {
+                    obj.embeddedFiles = this.get_embedded_files ? this.get_embedded_files() : [];
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.embeddedFiles;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    return PdfDocument;
+}
+/**
+ * Adds property getters to Pdf class
+ *
+ * @param Pdf - The native Pdf class
+ * @returns Enhanced Pdf class with property getters
+ *
+ * @example
+ * ```typescript
+ * const { Pdf } = require('pdf_oxide');
+ * const doc = Pdf.fromMarkdown('# Hello');
+ * console.log(doc.pageCount);  // Instead of doc.get_page_count()
+ * console.log(doc.version);     // Instead of doc.get_version()
+ * ```
+ */
+export function addPdfProperties(Pdf) {
+    if (!Pdf || !Pdf.prototype) {
+        return Pdf;
+    }
+    const prototype = Pdf.prototype;
+    const cache = new WeakMap();
+    /**
+     * Gets the PDF version as [major, minor]
+     */
+    Object.defineProperty(prototype, 'version', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.version) {
+                obj.version = this.get_version ? this.get_version() : [1, 4];
+            }
+            return obj.version;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets the number of pages
+     */
+    Object.defineProperty(prototype, 'pageCount', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (obj.pageCount === undefined) {
+                try {
+                    obj.pageCount = this.get_page_count ? this.get_page_count() : 0;
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.pageCount;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets document information metadata
+     */
+    Object.defineProperty(prototype, 'documentInfo', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.documentInfo) {
+                try {
+                    obj.documentInfo = this.get_document_info ? this.get_document_info() : {};
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.documentInfo;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets document XMP metadata
+     */
+    Object.defineProperty(prototype, 'metadata', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.metadata) {
+                try {
+                    obj.metadata = this.get_metadata ? this.get_metadata() : {};
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.metadata;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets document forms
+     */
+    Object.defineProperty(prototype, 'forms', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.forms) {
+                try {
+                    obj.forms = this.get_forms ? this.get_forms() : null;
+                }
+                catch (err) {
+                    throw err;
+                }
+            }
+            return obj.forms;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    return Pdf;
+}
+/**
+ * Adds property getters to PdfPage class
+ *
+ * @param PdfPage - The native PdfPage class
+ * @returns Enhanced PdfPage class with property getters
+ *
+ * @example
+ * ```typescript
+ * const page = doc.page(0);
+ * console.log(page.width);      // Instead of page.get_width()
+ * console.log(page.height);     // Instead of page.get_height()
+ * console.log(page.pageIndex);  // Instead of page.get_page_index()
+ * ```
+ */
+export function addPdfPageProperties(PdfPage) {
+    if (!PdfPage || !PdfPage.prototype) {
+        return PdfPage;
+    }
+    const prototype = PdfPage.prototype;
+    const cache = new WeakMap();
+    /**
+     * Gets the page index (zero-based)
+     */
+    Object.defineProperty(prototype, 'pageIndex', {
+        get() {
+            return this.get_page_index ? this.get_page_index() : 0;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets the page width in points
+     */
+    Object.defineProperty(prototype, 'width', {
+        get() {
+            return this.get_width ? this.get_width() : 612.0;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets the page height in points
+     */
+    Object.defineProperty(prototype, 'height', {
+        get() {
+            return this.get_height ? this.get_height() : 792.0;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets the page bounds as a Rect
+     */
+    Object.defineProperty(prototype, 'bounds', {
+        get() {
+            if (!cache.has(this)) {
+                cache.set(this, {});
+            }
+            const obj = cache.get(this);
+            if (!obj.bounds) {
+                if (this.get_bounds) {
+                    obj.bounds = this.get_bounds();
+                }
+                else {
+                    // Return default bounds [0, 0, width, height]
+                    obj.bounds = {
+                        x: 0,
+                        y: 0,
+                        width: this.width || 612.0,
+                        height: this.height || 792.0,
+                    };
+                }
+            }
+            return obj.bounds;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets the page orientation (portrait or landscape)
+     */
+    Object.defineProperty(prototype, 'orientation', {
+        get() {
+            const width = this.width || 612.0;
+            const height = this.height || 792.0;
+            return height >= width ? 'portrait' : 'landscape';
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    /**
+     * Gets the page aspect ratio (width / height)
+     */
+    Object.defineProperty(prototype, 'aspectRatio', {
+        get() {
+            const width = this.width || 612.0;
+            const height = this.height || 792.0;
+            return width / height;
+        },
+        configurable: true,
+        enumerable: true,
+    });
+    return PdfPage;
+}
+/**
+ * Adds property getters to all supported classes
+ *
+ * @param classes - Object with class references
+ * @returns Object with enhanced classes
+ *
+ * @example
+ * ```typescript
+ * const classes = {
+ *   PdfDocument,
+ *   Pdf,
+ *   PdfPage,
+ *   PdfElement,
+ *   PdfText,
+ *   PdfImage,
+ * };
+ * const enhanced = addPropertiesToAll(classes);
+ * ```
+ */
+export function addPropertiesToAll(classes) {
+    if (classes.PdfDocument) {
+        classes.PdfDocument = addPdfDocumentProperties(classes.PdfDocument);
+    }
+    if (classes.Pdf) {
+        classes.Pdf = addPdfProperties(classes.Pdf);
+    }
+    if (classes.PdfPage) {
+        classes.PdfPage = addPdfPageProperties(classes.PdfPage);
+    }
+    return classes;
+}