@jackgreen2018/pdf-engine 1.0.44 → 1.0.45

package/README.md

@@ -55,7 +55,7 @@ optimize_pdf (50 pages):  0.841 ms
 get_pdf_info (50 pages):  0.609 ms
 ```
 
-Run 2026-08-01 (v1.0.44); full stdout at evidence/benchmark-v1.0.44.log; raw results at benchmark-results.txt.
+Run 2026-08-01 (v1.0.45); full stdout at evidence/benchmark-v1.0.45.log; raw results at benchmark-results.txt.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackgreen2018/pdf-engine",
-  "version": "1.0.44",
+  "version": "1.0.45",
   "description": "Rust/WASM PDF library for merge, split, optimize and info operations",
   "license": "MIT",
   "repository": {

package/pkg/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Jack Green
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/pkg/README.md

@@ -0,0 +1,62 @@
+# @jackgreen2018/pdf-engine
+
+Rust/WASM PDF library for merge, split, optimize and info operations.
+
+## Install
+
+```bash
+npm install @jackgreen2018/pdf-engine
+```
+
+## Usage
+
+```javascript
+const { init, merge_pdfs, split_pdf, get_page_count, get_pdf_info, optimize_pdf } = require('@jackgreen2018/pdf-engine');
+
+async function example() {
+    await init();
+
+    // Merge two PDFs
+    const merged = merge_pdfs(pdfBuffer1, pdfBuffer2);
+
+    // Split a PDF (extract pages 1, 3, 5)
+    const split = split_pdf(inputPdf, [1, 3, 5]);
+
+    // Get page count
+    const count = get_page_count(pdfBuffer);
+
+    // Get PDF metadata
+    const info = get_pdf_info(pdfBuffer);
+    // Returns: { version, pageCount, Title, Author, ... }
+
+    // Optimize a PDF
+    const optimized = optimize_pdf(pdfBuffer);
+}
+```
+
+## API
+
+- `init()` - Initialize the WASM module (returns Promise)
+- `merge_pdfs(a, b)` - Merge two PDFs into one
+- `split_pdf(input, pages)` - Extract specific pages from a PDF
+- `get_page_count(input)` - Get the number of pages
+- `get_pdf_info(input)` - Get PDF metadata as an object
+- `optimize_pdf(input)` - Optimize a PDF by recompressing
+
+## Benchmarks
+
+```
+PDF Engine Benchmarks (20 iterations, avg ms)
+========================================================
+get_page_count (50 pages): 0.598 ms
+split_pdf (8 pages):      5.259 ms
+merge_pdfs (2 PDFs):      0.995 ms
+optimize_pdf (50 pages):  0.903 ms
+get_pdf_info (50 pages):  0.636 ms
+```
+
+Run 2026-08-01 (v1.0.41); full stdout at evidence/benchmark-v1.0.41.log; raw results at benchmark-results.txt.
+
+## License
+
+MIT

package/pkg/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "pdf_engine",
+  "type": "module",
+  "version": "1.0.41",
+  "license": "MIT",
+  "files": [
+    "pdf_engine_bg.wasm",
+    "pdf_engine.js",
+    "pdf_engine_bg.js",
+    "pdf_engine.d.ts"
+  ],
+  "main": "pdf_engine.js",
+  "types": "pdf_engine.d.ts",
+  "sideEffects": [
+    "./pdf_engine.js",
+    "./snippets/*"
+  ]
+}

package/pkg/pdf_engine.d.ts

@@ -0,0 +1,16 @@
+/* tslint:disable */
+/* eslint-disable */
+
+export function get_page_count(input: Uint8Array): number;
+
+export function get_pdf_info(input: Uint8Array): any;
+
+export function init(): Promise<any>;
+
+export function merge_pdfs(a: Uint8Array, b: Uint8Array): Uint8Array;
+
+export function merge_pdfs_vec(docs: Array<any>): Uint8Array;
+
+export function optimize_pdf(input: Uint8Array): Uint8Array;
+
+export function split_pdf(input: Uint8Array, pages: Array<any>): Array<any>;

package/pkg/pdf_engine.js

@@ -0,0 +1,9 @@
+/* @ts-self-types="./pdf_engine.d.ts" */
+import * as wasm from "./pdf_engine_bg.wasm";
+import { __wbg_set_wasm } from "./pdf_engine_bg.js";
+
+__wbg_set_wasm(wasm);
+wasm.__wbindgen_start();
+export {
+    get_page_count, get_pdf_info, init, merge_pdfs, merge_pdfs_vec, optimize_pdf, split_pdf
+} from "./pdf_engine_bg.js";

package/pkg/pdf_engine_bg.js

@@ -0,0 +1,238 @@
+/**
+ * @param {Uint8Array} input
+ * @returns {number}
+ */
+export function get_page_count(input) {
+    const ptr0 = passArray8ToWasm0(input, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.get_page_count(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return ret[0] >>> 0;
+}
+
+/**
+ * @param {Uint8Array} input
+ * @returns {any}
+ */
+export function get_pdf_info(input) {
+    const ptr0 = passArray8ToWasm0(input, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.get_pdf_info(ptr0, len0);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+
+/**
+ * @returns {Promise<any>}
+ */
+export function init() {
+    const ret = wasm.init();
+    return ret;
+}
+
+/**
+ * @param {Uint8Array} a
+ * @param {Uint8Array} b
+ * @returns {Uint8Array}
+ */
+export function merge_pdfs(a, b) {
+    const ptr0 = passArray8ToWasm0(a, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ptr1 = passArray8ToWasm0(b, wasm.__wbindgen_malloc);
+    const len1 = WASM_VECTOR_LEN;
+    const ret = wasm.merge_pdfs(ptr0, len0, ptr1, len1);
+    if (ret[3]) {
+        throw takeFromExternrefTable0(ret[2]);
+    }
+    var v3 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v3;
+}
+
+/**
+ * @param {Array<any>} docs
+ * @returns {Uint8Array}
+ */
+export function merge_pdfs_vec(docs) {
+    const ret = wasm.merge_pdfs_vec(docs);
+    if (ret[3]) {
+        throw takeFromExternrefTable0(ret[2]);
+    }
+    var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v1;
+}
+
+/**
+ * @param {Uint8Array} input
+ * @returns {Uint8Array}
+ */
+export function optimize_pdf(input) {
+    const ptr0 = passArray8ToWasm0(input, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.optimize_pdf(ptr0, len0);
+    if (ret[3]) {
+        throw takeFromExternrefTable0(ret[2]);
+    }
+    var v2 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+    wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+    return v2;
+}
+
+/**
+ * @param {Uint8Array} input
+ * @param {Array<any>} pages
+ * @returns {Array<any>}
+ */
+export function split_pdf(input, pages) {
+    const ptr0 = passArray8ToWasm0(input, wasm.__wbindgen_malloc);
+    const len0 = WASM_VECTOR_LEN;
+    const ret = wasm.split_pdf(ptr0, len0, pages);
+    if (ret[2]) {
+        throw takeFromExternrefTable0(ret[1]);
+    }
+    return takeFromExternrefTable0(ret[0]);
+}
+export function __wbg_Error_92b29b0548f8b746(arg0, arg1) {
+    const ret = Error(getStringFromWasm0(arg0, arg1));
+    return ret;
+}
+export function __wbg___wbindgen_number_get_394265ed1e1b84ee(arg0, arg1) {
+    const obj = arg1;
+    const ret = typeof(obj) === 'number' ? obj : undefined;
+    getDataViewMemory0().setFloat64(arg0 + 8 * 1, isLikeNone(ret) ? 0 : ret, true);
+    getDataViewMemory0().setInt32(arg0 + 4 * 0, !isLikeNone(ret), true);
+}
+export function __wbg___wbindgen_throw_344f42d3211c4765(arg0, arg1) {
+    throw new Error(getStringFromWasm0(arg0, arg1));
+}
+export function __wbg_get_507a50627bffa49b(arg0, arg1) {
+    const ret = arg0[arg1 >>> 0];
+    return ret;
+}
+export function __wbg_instanceof_Uint8Array_309b927aaf7a3fc7(arg0) {
+    let result;
+    try {
+        result = arg0 instanceof Uint8Array;
+    } catch (_) {
+        result = false;
+    }
+    const ret = result;
+    return ret;
+}
+export function __wbg_length_1f0964f4a5e2c6d8(arg0) {
+    const ret = arg0.length;
+    return ret;
+}
+export function __wbg_length_370319915dc99107(arg0) {
+    const ret = arg0.length;
+    return ret;
+}
+export function __wbg_new_32b398fb48b6d94a() {
+    const ret = new Array();
+    return ret;
+}
+export function __wbg_new_7796ffc7ed656783() {
+    const ret = new Map();
+    return ret;
+}
+export function __wbg_new_from_slice_77cdfb7977362f3c(arg0, arg1) {
+    const ret = new Uint8Array(getArrayU8FromWasm0(arg0, arg1));
+    return ret;
+}
+export function __wbg_prototypesetcall_4770620bbe4688a0(arg0, arg1, arg2) {
+    Uint8Array.prototype.set.call(getArrayU8FromWasm0(arg0, arg1), arg2);
+}
+export function __wbg_push_d2ae3af0c1217ae6(arg0, arg1) {
+    const ret = arg0.push(arg1);
+    return ret;
+}
+export function __wbg_resolve_2191a4dfe481c25b(arg0) {
+    const ret = Promise.resolve(arg0);
+    return ret;
+}
+export function __wbg_set_575dd786d51585f8(arg0, arg1, arg2) {
+    const ret = arg0.set(arg1, arg2);
+    return ret;
+}
+export function __wbindgen_cast_0000000000000001(arg0, arg1) {
+    // Cast intrinsic for `Ref(String) -> Externref`.
+    const ret = getStringFromWasm0(arg0, arg1);
+    return ret;
+}
+export function __wbindgen_init_externref_table() {
+    const table = wasm.__wbindgen_externrefs;
+    const offset = table.grow(4);
+    table.set(0, undefined);
+    table.set(offset + 0, undefined);
+    table.set(offset + 1, null);
+    table.set(offset + 2, true);
+    table.set(offset + 3, false);
+}
+function getArrayU8FromWasm0(ptr, len) {
+    ptr = ptr >>> 0;
+    return getUint8ArrayMemory0().subarray(ptr / 1, ptr / 1 + len);
+}
+
+let cachedDataViewMemory0 = null;
+function getDataViewMemory0() {
+    if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
+        cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
+    }
+    return cachedDataViewMemory0;
+}
+
+function getStringFromWasm0(ptr, len) {
+    return decodeText(ptr >>> 0, len);
+}
+
+let cachedUint8ArrayMemory0 = null;
+function getUint8ArrayMemory0() {
+    if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
+        cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
+    }
+    return cachedUint8ArrayMemory0;
+}
+
+function isLikeNone(x) {
+    return x === undefined || x === null;
+}
+
+function passArray8ToWasm0(arg, malloc) {
+    const ptr = malloc(arg.length * 1, 1) >>> 0;
+    getUint8ArrayMemory0().set(arg, ptr / 1);
+    WASM_VECTOR_LEN = arg.length;
+    return ptr;
+}
+
+function takeFromExternrefTable0(idx) {
+    const value = wasm.__wbindgen_externrefs.get(idx);
+    wasm.__externref_table_dealloc(idx);
+    return value;
+}
+
+let cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+cachedTextDecoder.decode();
+const MAX_SAFARI_DECODE_BYTES = 2146435072;
+let numBytesDecoded = 0;
+function decodeText(ptr, len) {
+    numBytesDecoded += len;
+    if (numBytesDecoded >= MAX_SAFARI_DECODE_BYTES) {
+        cachedTextDecoder = new TextDecoder('utf-8', { ignoreBOM: true, fatal: true });
+        cachedTextDecoder.decode();
+        numBytesDecoded = len;
+    }
+    return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
+}
+
+let WASM_VECTOR_LEN = 0;
+
+
+let wasm;
+export function __wbg_set_wasm(val) {
+    wasm = val;
+}

package/pkg/pdf_engine_bg.wasm.d.ts

@@ -0,0 +1,15 @@
+/* tslint:disable */
+/* eslint-disable */
+export const memory: WebAssembly.Memory;
+export const get_page_count: (a: number, b: number) => [number, number, number];
+export const get_pdf_info: (a: number, b: number) => [number, number, number];
+export const init: () => any;
+export const merge_pdfs: (a: number, b: number, c: number, d: number) => [number, number, number, number];
+export const merge_pdfs_vec: (a: any) => [number, number, number, number];
+export const optimize_pdf: (a: number, b: number) => [number, number, number, number];
+export const split_pdf: (a: number, b: number, c: any) => [number, number, number];
+export const __wbindgen_externrefs: WebAssembly.Table;
+export const __wbindgen_malloc: (a: number, b: number) => number;
+export const __externref_table_dealloc: (a: number) => void;
+export const __wbindgen_free: (a: number, b: number, c: number) => void;
+export const __wbindgen_start: () => void;