📄 stitchPDF

stitchPDF is a powerful Node.js library and CLI tool for advanced PDF processing with real optimization capabilities. Unlike other solutions, stitchPDF delivers actual file size reduction through Ghostscript integration.

🚀 Key Features

• 🔥 REAL PDF Optimization - 90%+ compression using Ghostscript
• 📊 Font Analysis & Deduplication - Advanced font detection and optimization
• 📝 Text Extraction - Coordinate-based text extraction with PDF.js
• 🔍 PDF Validation - Security scanning and document validation
• 📄 Page Insertion - Insert pages at specific positions
• 📧 Mail Merge - Create personalized documents
• 🛡️ Security Scanning - Detect JavaScript and malicious content

⚙️ Installation

npm install stitchpdf

For real PDF optimization, ensure Ghostscript is installed:

macOS

brew install ghostscript

Ubuntu/Debian

sudo apt-get install ghostscript

Windows

# Using Chocolatey
choco install ghostscript

📚 CLI Usage

stitchPDF provides a comprehensive CLI interface:

PDF Optimization (Premium Feature)

Analyze optimization opportunities:

# Basic analysis
stitchpdf optimize analyze document.pdf

# Save analysis report
stitchpdf optimize analyze document.pdf --output analysis.json

Optimize PDF files:

# Basic optimization with Ghostscript
stitchpdf premium optimize input.pdf --output optimized.pdf

# Advanced optimization options
stitchpdf premium optimize large-file.pdf \
  --output compressed.pdf \
  --compression high \
  --fonts true \
  --images true \
  --cleanup true

Compression levels:

• --compression low - 15% reduction, preserve quality
• --compression medium - 35% reduction, balanced (default)
• --compression high - 55% reduction, aggressive

Font Analysis

# Analyze fonts in PDF
stitchpdf fonts analyze document.pdf

# Detailed font analysis with output
stitchpdf fonts analyze document.pdf --output fonts.json --details

Text Extraction

# Extract all text
stitchpdf text extract document.pdf

# Extract with coordinates
stitchpdf text extract document.pdf --coordinates

# Save to file
stitchpdf text extract document.pdf --output extracted.txt

PDF Validation

# Basic validation
stitchpdf validate document.pdf

# Security scan with options
stitchpdf validate document.pdf \
  --javascript \
  --forms \
  --metadata \
  --output security-report.json

Page Operations

# Insert page at specific position
stitchpdf pages insert source.pdf \
  --page-to-insert insert.pdf \
  --position 5 \
  --output result.pdf

Mail Merge

# Create mail merge template
stitchpdf merge create template.pdf data.json --output merged.pdf

# Process mail merge
stitchpdf merge process template.pdf recipients.csv --output-dir ./output

License Management

# Check current license status
stitchpdf license status

# Activate 7-day demo license (unlocks all Pro features)
stitchpdf license demo

Information Commands

# Show version
stitchpdf --version

# Show help for any command
stitchpdf optimize --help
stitchpdf premium --help

📦 NPM/JavaScript Usage

ES Modules (Recommended)

import { 
  optimizePdfWithGhostscript,
  analyzeFonts,
  extractText,
  validatePdf,
  insertAtPage,
  createMailMerge
} from 'stitchpdf';

// Real PDF optimization with Ghostscript
const result = await optimizePdfWithGhostscript('large-file.pdf', {
  outputPath: 'optimized.pdf',
  compressionLevel: 'medium',
  optimizeImages: true,
  optimizeFonts: true
});

console.log(`Saved ${result.savingsPercent}%!`); // e.g., "Saved 94.6%!"

// Font analysis
const fontAnalysis = await analyzeFonts('document.pdf');
console.log(`Found ${fontAnalysis.totalFonts} fonts`);

// Text extraction with coordinates
const text = await extractText('document.pdf', { includeCoordinates: true });

// PDF validation
const validation = await validatePdf('document.pdf');
console.log(`Valid: ${validation.isValid}`);

CommonJS

const { 
  optimizePdfWithGhostscript,
  analyzeFonts,
  extractText 
} = require('stitchpdf');

// Same usage as above

All Available Exports

import {
  // PDF Optimization (REAL results with Ghostscript)
  optimizePdfWithGhostscript,
  optimizePdf,
  analyzePdfOptimization,
  checkGhostscriptAvailability,
  estimateGhostscriptSavings,
  compareOptimizationMethods,
  
  // Font Analysis
  analyzeFonts,
  
  // Text Extraction
  extractText,
  extractTextWithCoordinates,
  
  // PDF Validation
  validatePdf,
  scanForJavaScript,
  
  // Page Operations
  insertAtPage,
  
  // Mail Merge
  createMailMerge,
  processMailMerge,
  
  // Licensing
  LicenseManager,
  
  // Constants
  VERSION,
  LIBRARY_NAME
} from 'stitchpdf';

🏆 Real Performance Results

Our Ghostscript integration delivers actual optimization unlike broken pdf-lib solutions:

vs. pdf-lib: 0.9% savings (BROKEN) vs. stitchPDF: 90%+ savings (WORKS!)

🛠️ API Examples

PDF Optimization Analysis

import { analyzePdfOptimization } from 'stitchpdf';

const analysis = await analyzePdfOptimization('document.pdf');
console.log(`Estimated savings: ${analysis.estimatedSavingsPercent}%`);
console.log(`Optimization score: ${analysis.optimizationScore}`);

Font Analysis

import { analyzeFonts } from 'stitchpdf';

const fonts = await analyzeFonts('document.pdf');
console.log(`Total fonts: ${fonts.totalFonts}`);
console.log(`Unique families: ${fonts.uniqueFamilies}`);
console.log(`Embedded fonts: ${fonts.embeddedFonts}`);

Advanced Text Extraction

import { extractTextWithCoordinates } from 'stitchpdf';

const result = await extractTextWithCoordinates('document.pdf');
result.pages.forEach((page, index) => {
  console.log(`Page ${index + 1}:`);
  page.textItems.forEach(item => {
    console.log(`  "${item.str}" at (${item.x}, ${item.y})`);
  });
});

🔧 Configuration

Optimization Options

const options = {
  outputPath: 'optimized.pdf',
  compressionLevel: 'medium', // 'low', 'medium', 'high'
  optimizeImages: true,
  optimizeFonts: true,
  removeMetadata: true
};

const result = await optimizePdfWithGhostscript('input.pdf', options);

Analysis Options

const fontOptions = {
  includeDetails: true,
  analyzeEmbedding: true,
  detectDuplicates: true
};

const fonts = await analyzeFonts('document.pdf', fontOptions);

🔒 Licensing & Features

stitchPDF uses a freemium model - start free, upgrade for advanced features:

📗 FREE Package (stitchpdf)

• ✅ Font Analysis - Detect fonts and duplicates
• ✅ Text Extraction - Extract text with coordinates
• ✅ PDF Validation - Security scanning and document validation
• ✅ Basic Analysis - Optimization opportunities assessment
• ✅ Open Source - MIT licensed

💎 PREMIUM Package (stitchpdf-premium)

Get access to advanced PDF processing capabilities:

• 🚀 Real PDF Optimization - 90%+ compression with Ghostscript
• 📧 Mail Merge - Create personalized documents
• ⚡ Bulk Processing - Process multiple files simultaneously
• 📄 Advanced Page Operations - Insert, merge, split pages
• 🏢 Commercial License - Use in commercial applications
• 📞 Priority Support - Direct technical assistance

💰 Premium Pricing

📞 Get Your Premium License
Contact: Peter Allain, Founder
Email: pballain910@gmail.com
Subject: "stitchPDF Premium License Request"

Smart Pricing with Auto-Optimization

💎 Pro - $29/month

• 1,000 operations included
• $0.01 per additional operation
• 10% grace buffer (100 free extra operations)
• Auto-upgrade after 2 consecutive overage months

🏢 Business - $99/month

• 10,000 operations included
• $0.008 per additional operation
• 10% grace buffer (1,000 free extra operations)
• Auto-upgrade after 2 consecutive overage months

🚀 Enterprise - $299/month

• 50,000 operations included
• $0.006 per additional operation
• 10% grace buffer (5,000 free extra operations)
• Auto-upgrade after 2 consecutive overage months

🌟 Enterprise Unlimited - $999/month

• Up to 650,000 operations (no overages)
• Fair use policy with pricing renegotiation beyond 650K
• Dedicated support and custom integrations

How Smart Pricing Works

🎯 One-time spikes? Just pay the overage fee - perfect for seasonal businesses.
🎯 Consistent growth? We automatically upgrade you to a better tier after 2 months.
🎯 No surprises! Grace buffers and clear overage rates prevent unexpected bills.

🎁 Free 7-day trial included with every tier!

Simply email with your use case and expected volume. I personally handle all premium licenses to ensure you get exactly what you need.

Try Premium Features

# Install premium package
npm install stitchpdf-premium

# Contact for license key
# Email: pballain910@gmail.com

⚡ Performance Tips

1. Use Ghostscript optimization for files > 10MB
2. Medium compression balances size vs quality
3. Font analysis before optimization shows potential savings
4. Validation ensures PDF integrity after processing

🛡️ Security Features

import { validatePdf, scanForJavaScript } from 'stitchpdf';

// Comprehensive security scan
const validation = await validatePdf('document.pdf', {
  checkJavaScript: true,
  checkForms: true,
  checkMetadata: true
});

// Specific JavaScript detection
const jsResult = await scanForJavaScript('document.pdf');
console.log(`JavaScript found: ${jsResult.hasJavaScript}`);

🚀 System Requirements

• Node.js 18+
• Ghostscript (for real optimization)
• Memory: 2GB+ for large PDF processing

📄 License

MIT License © 2025

🔗 Links

• npm package
• GitHub repository
• Issue tracker

stitchPDF: Finally, PDF optimization that actually works! 🎉