pdf-oxide-wasm 0.3.17 → 0.3.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-oxide-wasm",
-  "version": "0.3.17",
+  "version": "0.3.18",
   "description": "Fast, zero-dependency PDF toolkit for Node.js, browsers, and edge runtimes — text extraction, markdown/HTML conversion, search, form filling, creation, and editing. Rust core compiled to WebAssembly.",
   "license": "MIT OR Apache-2.0",
   "repository": {

package/pdf_oxide.d.ts

@@ -143,6 +143,13 @@ export class WasmPdf {
    * @param images_array - Array of Uint8Arrays, each containing image file bytes (PNG/JPEG)
    */
   static fromMultipleImageBytes(images_array: any): WasmPdf;
+  /**
+   * Merge multiple PDF byte arrays into a single PDF.
+   *
+   * @param pdfs - Array of Uint8Array, each containing a PDF
+   * @returns WasmPdf containing all pages
+   */
+  static merge(pdfs: Uint8Array[]): WasmPdf;
   /**
    * Get the PDF as a Uint8Array.
    */
@@ -194,6 +201,10 @@ export class WasmPdfDocument {
    * Set the document author.
    */
   setAuthor(author: string): void;
+  /**
+   * Delete a page by index (0-based).
+   */
+  deletePage(index: number): void;
   /**
    * Deprecated: Use eraseFooter instead.
    */
@@ -324,6 +335,10 @@ export class WasmPdfDocument {
    * @returns Array of path objects
    */
   extractLines(page_index: number, region?: Float32Array | null): any;
+  /**
+   * Extract specific pages to a new PDF (returns bytes).
+   */
+  extractPages(pages: Uint32Array): Uint8Array;
   /**
    * Extract vector paths (lines, curves, shapes) from a page.
    *
@@ -371,7 +386,8 @@ export class WasmPdfDocument {
    */
   pageRotation(page_index: number): number;
   /**
-   * Save all edits and return the resulting PDF as bytes.
+   * Save the modified PDF and return as bytes.
+   * `saveToBytes()` is the original method; `save()` is a convenience alias.
    *
    * @returns Uint8Array containing the modified PDF
    */
@@ -419,6 +435,10 @@ export class WasmPdfDocument {
    * @param threshold - Fraction of pages (0.0-1.0) where text must repeat (heuristic mode)
    */
   removeHeaders(threshold: number): number;
+  /**
+   * Validate PDF/A compliance. Level: "1b", "2b", etc.
+   */
+  validatePdfA(level: string): any;
   /**
    * Erase both header and footer content.
    *
@@ -569,10 +589,17 @@ export class WasmPdfDocument {
   /**
    * Load a PDF document from raw bytes.
    *
-   * @param data - The PDF file contents as a Uint8Array
+   * @param data - PDF file contents as Uint8Array
+   * @param password - Optional password for encrypted PDFs
    * @throws Error if the PDF is invalid or cannot be parsed
    */
-  constructor(data: Uint8Array);
+  constructor(data: Uint8Array, password?: string | null);
+  /**
+   * Save all edits and return the resulting PDF as bytes.
+   *
+   * @returns Uint8Array containing the modified PDF
+   */
+  save(): Uint8Array;
   /**
    * Search for text across all pages.
    *

package/pdf_oxide.js

@@ -119,6 +119,14 @@ function getStringFromWasm0(ptr, len) {
     return decodeText(ptr, len);
 }
 
+let cachedUint32ArrayMemory0 = null;
+function getUint32ArrayMemory0() {
+    if (cachedUint32ArrayMemory0 === null || cachedUint32ArrayMemory0.byteLength === 0) {
+        cachedUint32ArrayMemory0 = new Uint32Array(wasm.memory.buffer);
+    }
+    return cachedUint32ArrayMemory0;
+}
+
 let cachedUint8ArrayMemory0 = null;
 function getUint8ArrayMemory0() {
     if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
@@ -146,6 +154,13 @@ function isLikeNone(x) {
     return x === undefined || x === null;
 }
 
+function passArray32ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 4, 4) >>> 0;
+    getUint32ArrayMemory0().set(arg, ptr / 4);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
 function passArray8ToWasm0(arg, malloc) {
     const ptr = malloc(arg.length * 1, 1) >>> 0;
     getUint8ArrayMemory0().set(arg, ptr / 1);
@@ -160,6 +175,16 @@ function passArrayF32ToWasm0(arg, malloc) {
     return ptr;
 }
 
+function passArrayJsValueToWasm0(array, malloc) {
+    const ptr = malloc(array.length * 4, 4) >>> 0;
+    const mem = getDataViewMemory0();
+    for (let i = 0; i < array.length; i++) {
+        mem.setUint32(ptr + 4 * i, addHeapObject(array[i]), true);
+    }
+    WASM_VECTOR_LEN = array.length;
+    return ptr;
+}
+
 function passStringToWasm0(arg, malloc, realloc) {
     if (realloc === undefined) {
         const buf = cachedTextEncoder.encode(arg);
@@ -831,6 +856,31 @@ class WasmPdf {
         const ret = wasm.wasmpdf_size(this.__wbg_ptr);
         return ret >>> 0;
     }
+    /**
+     * Merge multiple PDF byte arrays into a single PDF.
+     *
+     * @param pdfs - Array of Uint8Array, each containing a PDF
+     * @returns WasmPdf containing all pages
+     * @param {Uint8Array[]} pdfs
+     * @returns {WasmPdf}
+     */
+    static merge(pdfs) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArrayJsValueToWasm0(pdfs, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.wasmpdf_merge(retptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return WasmPdf.__wrap(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Get the PDF as a Uint8Array.
      * @returns {Uint8Array}
@@ -1021,6 +1071,23 @@ class WasmPdfDocument {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Delete a page by index (0-based).
+     * @param {number} index
+     */
+    deletePage(index) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmpdfdocument_deletePage(retptr, this.__wbg_ptr, index);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            if (r1) {
+                throw takeObject(r0);
+            }
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Deprecated: Use eraseFooter instead.
      * @param {number} page_index
@@ -1535,6 +1602,31 @@ class WasmPdfDocument {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Extract specific pages to a new PDF (returns bytes).
+     * @param {Uint32Array} pages
+     * @returns {Uint8Array}
+     */
+    extractPages(pages) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passArray32ToWasm0(pages, wasm.__wbindgen_export);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.wasmpdfdocument_extractPages(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v2 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v2;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Extract vector paths (lines, curves, shapes) from a page.
      *
@@ -1702,7 +1794,8 @@ class WasmPdfDocument {
         }
     }
     /**
-     * Save all edits and return the resulting PDF as bytes.
+     * Save the modified PDF and return as bytes.
+     * `saveToBytes()` is the original method; `save()` is a convenience alias.
      *
      * @returns Uint8Array containing the modified PDF
      * @returns {Uint8Array}
@@ -1710,7 +1803,7 @@ class WasmPdfDocument {
     saveToBytes() {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
-            wasm.wasmpdfdocument_saveToBytes(retptr, this.__wbg_ptr);
+            wasm.wasmpdfdocument_save(retptr, this.__wbg_ptr);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -1882,6 +1975,28 @@ class WasmPdfDocument {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Validate PDF/A compliance. Level: "1b", "2b", etc.
+     * @param {string} level
+     * @returns {any}
+     */
+    validatePdfA(level) {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            const ptr0 = passStringToWasm0(level, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            const len0 = WASM_VECTOR_LEN;
+            wasm.wasmpdfdocument_validatePdfA(retptr, this.__wbg_ptr, ptr0, len0);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            if (r2) {
+                throw takeObject(r1);
+            }
+            return takeObject(r0);
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Erase both header and footer content.
      *
@@ -2506,16 +2621,20 @@ class WasmPdfDocument {
     /**
      * Load a PDF document from raw bytes.
      *
-     * @param data - The PDF file contents as a Uint8Array
+     * @param data - PDF file contents as Uint8Array
+     * @param password - Optional password for encrypted PDFs
      * @throws Error if the PDF is invalid or cannot be parsed
      * @param {Uint8Array} data
+     * @param {string | null} [password]
      */
-    constructor(data) {
+    constructor(data, password) {
         try {
             const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
             const ptr0 = passArray8ToWasm0(data, wasm.__wbindgen_export);
             const len0 = WASM_VECTOR_LEN;
-            wasm.wasmpdfdocument_new(retptr, ptr0, len0);
+            var ptr1 = isLikeNone(password) ? 0 : passStringToWasm0(password, wasm.__wbindgen_export, wasm.__wbindgen_export2);
+            var len1 = WASM_VECTOR_LEN;
+            wasm.wasmpdfdocument_new(retptr, ptr0, len0, ptr1, len1);
             var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
             var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
             var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
@@ -2529,6 +2648,30 @@ class WasmPdfDocument {
             wasm.__wbindgen_add_to_stack_pointer(16);
         }
     }
+    /**
+     * Save all edits and return the resulting PDF as bytes.
+     *
+     * @returns Uint8Array containing the modified PDF
+     * @returns {Uint8Array}
+     */
+    save() {
+        try {
+            const retptr = wasm.__wbindgen_add_to_stack_pointer(-16);
+            wasm.wasmpdfdocument_save(retptr, this.__wbg_ptr);
+            var r0 = getDataViewMemory0().getInt32(retptr + 4 * 0, true);
+            var r1 = getDataViewMemory0().getInt32(retptr + 4 * 1, true);
+            var r2 = getDataViewMemory0().getInt32(retptr + 4 * 2, true);
+            var r3 = getDataViewMemory0().getInt32(retptr + 4 * 3, true);
+            if (r3) {
+                throw takeObject(r2);
+            }
+            var v1 = getArrayU8FromWasm0(r0, r1).slice();
+            wasm.__wbindgen_export4(r0, r1 * 1, 1);
+            return v1;
+        } finally {
+            wasm.__wbindgen_add_to_stack_pointer(16);
+        }
+    }
     /**
      * Search for text across all pages.
      *

package/pdf_oxide_bg.wasm.d.ts

@@ -28,6 +28,7 @@ export const wasmpdf_fromImageBytes: (a: number, b: number, c: number) => void;
 export const wasmpdf_fromMarkdown: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const wasmpdf_fromMultipleImageBytes: (a: number, b: number) => void;
 export const wasmpdf_fromText: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
+export const wasmpdf_merge: (a: number, b: number, c: number) => void;
 export const wasmpdf_size: (a: number) => number;
 export const wasmpdf_toBytes: (a: number, b: number) => void;
 export const wasmpdfdocument_applyAllRedactions: (a: number, b: number) => void;
@@ -35,6 +36,7 @@ export const wasmpdfdocument_applyPageRedactions: (a: number, b: number, c: numb
 export const wasmpdfdocument_authenticate: (a: number, b: number, c: number, d: number) => void;
 export const wasmpdfdocument_clearEraseRegions: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_cropMargins: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmpdfdocument_deletePage: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_editFooter: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_editHeader: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_embedFile: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
@@ -49,6 +51,7 @@ export const wasmpdfdocument_extractChars: (a: number, b: number, c: number, d:
 export const wasmpdfdocument_extractImageBytes: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_extractImages: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_extractLines: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmpdfdocument_extractPages: (a: number, b: number, c: number, d: number) => void;
 export const wasmpdfdocument_extractPaths: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_extractRects: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_extractSpans: (a: number, b: number, c: number, d: number, e: number) => void;
@@ -68,7 +71,7 @@ export const wasmpdfdocument_getOutline: (a: number, b: number) => void;
 export const wasmpdfdocument_hasStructureTree: (a: number, b: number) => void;
 export const wasmpdfdocument_hasXfa: (a: number, b: number) => void;
 export const wasmpdfdocument_mergeFrom: (a: number, b: number, c: number, d: number) => void;
-export const wasmpdfdocument_new: (a: number, b: number, c: number) => void;
+export const wasmpdfdocument_new: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_pageCount: (a: number, b: number) => void;
 export const wasmpdfdocument_pageCropBox: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_pageImages: (a: number, b: number, c: number) => void;
@@ -82,8 +85,8 @@ export const wasmpdfdocument_repositionImage: (a: number, b: number, c: number,
 export const wasmpdfdocument_resizeImage: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const wasmpdfdocument_rotateAllPages: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_rotatePage: (a: number, b: number, c: number, d: number) => void;
+export const wasmpdfdocument_save: (a: number, b: number) => void;
 export const wasmpdfdocument_saveEncryptedToBytes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
-export const wasmpdfdocument_saveToBytes: (a: number, b: number) => void;
 export const wasmpdfdocument_search: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
 export const wasmpdfdocument_searchPage: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
 export const wasmpdfdocument_setAuthor: (a: number, b: number, c: number, d: number) => void;
@@ -101,6 +104,7 @@ export const wasmpdfdocument_toMarkdown: (a: number, b: number, c: number, d: nu
 export const wasmpdfdocument_toMarkdownAll: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_toPlainText: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_toPlainTextAll: (a: number, b: number) => void;
+export const wasmpdfdocument_validatePdfA: (a: number, b: number, c: number, d: number) => void;
 export const wasmpdfdocument_version: (a: number, b: number) => void;
 export const wasmpdfdocument_within: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_xmpMetadata: (a: number, b: number) => void;
@@ -120,6 +124,7 @@ export const wasmfooter_right: (a: number, b: number) => number;
 export const wasmheader_center: (a: number, b: number) => number;
 export const wasmheader_left: (a: number, b: number) => number;
 export const wasmheader_right: (a: number, b: number) => number;
+export const wasmpdfdocument_saveToBytes: (a: number, b: number) => void;
 export const wasmfooter_new: () => number;
 export const wasmheader_new: () => number;
 export const __wbg_wasmocrengine_free: (a: number, b: number) => void;