@jackgreen2018/pdf-engine 1.0.1

package/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/README.md

@@ -0,0 +1,60 @@
+# @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.666 ms
+split_pdf (8 pages):      1.360 ms
+merge_pdfs (2 PDFs):      1.133 ms
+optimize_pdf (50 pages):  0.895 ms
+get_pdf_info (50 pages):  0.722 ms
+```
+
+## License
+
+MIT

package/index.d.ts

@@ -0,0 +1,6 @@
+export default function init(): Promise<void>;
+export function merge_pdfs(a: Uint8Array, b: Uint8Array): Uint8Array;
+export function split_pdf(input: Uint8Array, pages: number[]): Uint8Array;
+export function get_page_count(input: Uint8Array): number;
+export function get_pdf_info(input: Uint8Array): object;
+export function optimize_pdf(input: Uint8Array): Uint8Array;

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@jackgreen2018/pdf-engine",
+  "version": "1.0.1",
+  "description": "Rust/WASM PDF library for merge, split, optimize and info operations",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jackgreen2018/pdf-engine.git"
+  },
+  "main": "pkg/pdf_engine.js",
+  "types": "index.d.ts",
+  "files": [
+    "pkg/",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "pdf",
+    "wasm",
+    "rust",
+    "merge",
+    "split",
+    "optimize"
+  ],
+  "scripts": {
+    "build": "wasm-pack build --target bundler --release"
+  },
+  "devDependencies": {
+    "pdf-lib": "^1.17.1"
+  }
+}