@lexmata/micropdf 0.4.0

package/dist/simple.d.ts

@@ -0,0 +1,276 @@
+/**
+ * Simple API - Ultra-simplified functions for common PDF tasks
+ *
+ * This module provides the simplest possible API for basic PDF operations.
+ * Perfect for beginners or quick scripts.
+ *
+ * @example
+ * ```typescript
+ * import * as pdf from 'micropdf/simple';
+ *
+ * // Extract all text
+ * const text = await pdf.extractText('document.pdf');
+ *
+ * // Render first page to PNG
+ * await pdf.renderToPNG('document.pdf', 'output.png');
+ *
+ * // Get page count
+ * const pages = await pdf.getPageCount('document.pdf');
+ * ```
+ */
+import { type PdfMetadata, type DocumentInfo } from './easy.js';
+/**
+ * Extract all text from a PDF
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns All text from the PDF
+ *
+ * @example
+ * ```typescript
+ * const text = await extractText('document.pdf');
+ * console.log(text);
+ * ```
+ */
+export declare function extractText(pdfPath: string, password?: string): Promise<string>;
+/**
+ * Extract text from a specific page
+ *
+ * @param pdfPath - Path to PDF file
+ * @param pageNumber - Page number (0-indexed)
+ * @param password - Optional password for encrypted PDFs
+ * @returns Text from the specified page
+ *
+ * @example
+ * ```typescript
+ * const text = await extractPageText('document.pdf', 0);
+ * console.log(text);
+ * ```
+ */
+export declare function extractPageText(pdfPath: string, pageNumber: number, password?: string): Promise<string>;
+/**
+ * Get the number of pages in a PDF
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns Number of pages
+ *
+ * @example
+ * ```typescript
+ * const count = await getPageCount('document.pdf');
+ * console.log(`Document has ${count} pages`);
+ * ```
+ */
+export declare function getPageCount(pdfPath: string, password?: string): Promise<number>;
+/**
+ * Get PDF metadata (title, author, etc.)
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns PDF metadata
+ *
+ * @example
+ * ```typescript
+ * const meta = await getMetadata('document.pdf');
+ * console.log(meta.title);
+ * console.log(meta.author);
+ * ```
+ */
+export declare function getMetadata(pdfPath: string, password?: string): Promise<PdfMetadata>;
+/**
+ * Get complete document information
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns Document information including metadata and page details
+ *
+ * @example
+ * ```typescript
+ * const info = await getInfo('document.pdf');
+ * console.log(`Pages: ${info.pageCount}`);
+ * console.log(`Title: ${info.metadata.title}`);
+ * info.pages.forEach((page, i) => {
+ *   console.log(`Page ${i}: ${page.width}x${page.height}`);
+ * });
+ * ```
+ */
+export declare function getInfo(pdfPath: string, password?: string): Promise<DocumentInfo>;
+/**
+ * Render a page to PNG
+ *
+ * @param pdfPath - Path to PDF file
+ * @param outputPath - Output PNG file path
+ * @param pageNumber - Page number (0-indexed, default: 0)
+ * @param dpi - DPI for rendering (default: 150)
+ * @param password - Optional password for encrypted PDFs
+ *
+ * @example
+ * ```typescript
+ * // Render first page at 150 DPI
+ * await renderToPNG('document.pdf', 'output.png');
+ *
+ * // Render second page at 300 DPI
+ * await renderToPNG('document.pdf', 'output.png', 1, 300);
+ * ```
+ */
+export declare function renderToPNG(pdfPath: string, outputPath: string, pageNumber?: number, dpi?: number, password?: string): Promise<void>;
+/**
+ * Render all pages to PNG files
+ *
+ * @param pdfPath - Path to PDF file
+ * @param outputPattern - Output file pattern (use {page} for page number)
+ * @param dpi - DPI for rendering (default: 150)
+ * @param password - Optional password for encrypted PDFs
+ *
+ * @example
+ * ```typescript
+ * // Render all pages
+ * await renderAllToPNG('document.pdf', 'output/page-{page}.png');
+ *
+ * // High quality rendering
+ * await renderAllToPNG('document.pdf', 'output/page-{page}.png', 300);
+ * ```
+ */
+export declare function renderAllToPNG(pdfPath: string, outputPattern: string, dpi?: number, password?: string): Promise<void>;
+/**
+ * Get a page as a PNG buffer
+ *
+ * @param pdfPath - Path to PDF file
+ * @param pageNumber - Page number (0-indexed, default: 0)
+ * @param dpi - DPI for rendering (default: 150)
+ * @param password - Optional password for encrypted PDFs
+ * @returns PNG buffer
+ *
+ * @example
+ * ```typescript
+ * const buffer = await getPageAsPNG('document.pdf', 0, 300);
+ * await fs.writeFile('output.png', buffer);
+ * ```
+ */
+export declare function getPageAsPNG(pdfPath: string, pageNumber?: number, dpi?: number, password?: string): Promise<Buffer>;
+/**
+ * Search for text in a PDF
+ *
+ * @param pdfPath - Path to PDF file
+ * @param query - Text to search for
+ * @param password - Optional password for encrypted PDFs
+ * @returns Array of page numbers where text was found
+ *
+ * @example
+ * ```typescript
+ * const pages = await searchText('document.pdf', 'important');
+ * console.log(`Found on pages: ${pages.join(', ')}`);
+ * ```
+ */
+export declare function searchText(pdfPath: string, query: string, password?: string): Promise<number[]>;
+/**
+ * Check if a PDF is encrypted
+ *
+ * @param pdfPath - Path to PDF file
+ * @returns True if the PDF is encrypted
+ *
+ * @example
+ * ```typescript
+ * if (await isEncrypted('document.pdf')) {
+ *   console.log('This PDF requires a password');
+ * }
+ * ```
+ */
+export declare function isEncrypted(pdfPath: string): Promise<boolean>;
+/**
+ * Save text extraction to a file
+ *
+ * @param pdfPath - Path to PDF file
+ * @param outputPath - Output text file path
+ * @param password - Optional password for encrypted PDFs
+ *
+ * @example
+ * ```typescript
+ * await saveTextToFile('document.pdf', 'output.txt');
+ * ```
+ */
+export declare function saveTextToFile(pdfPath: string, outputPath: string, password?: string): Promise<void>;
+/**
+ * Convert PDF to images (one per page)
+ *
+ * @param pdfPath - Path to PDF file
+ * @param outputDir - Output directory for images
+ * @param options - Rendering options
+ * @returns Array of output file paths
+ *
+ * @example
+ * ```typescript
+ * const files = await convertToImages('document.pdf', 'output/', {
+ *   dpi: 300,
+ *   format: 'png'
+ * });
+ * console.log(`Created ${files.length} images`);
+ * ```
+ */
+export declare function convertToImages(pdfPath: string, outputDir: string, options?: {
+    dpi?: number;
+    format?: 'png' | 'pnm' | 'pam';
+    password?: string;
+}): Promise<string[]>;
+/**
+ * Quick info summary for a PDF
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns Human-readable summary string
+ *
+ * @example
+ * ```typescript
+ * const summary = await quickSummary('document.pdf');
+ * console.log(summary);
+ * // Output:
+ * // Document: document.pdf
+ * // Pages: 42
+ * // Title: My Document
+ * // Author: John Doe
+ * // Encrypted: No
+ * ```
+ */
+export declare function quickSummary(pdfPath: string, password?: string): Promise<string>;
+/**
+ * Merge multiple PDF files into a single output file
+ *
+ * This is the simplest way to merge PDFs - just provide the input paths and output path.
+ * Handles large documents (5000+ pages) and corrupted PDFs robustly.
+ *
+ * @param inputPaths - Array of PDF file paths to merge (in order)
+ * @param outputPath - Path where the merged PDF will be saved
+ * @returns Promise that resolves to the number of pages in the merged PDF
+ * @throws Error if any input file is invalid, not found, or merge fails
+ *
+ * @example Basic merge
+ * ```typescript
+ * import { mergePDF } from 'micropdf/simple';
+ *
+ * const pageCount = await mergePDF(
+ *   ['document1.pdf', 'document2.pdf', 'document3.pdf'],
+ *   'merged.pdf'
+ * );
+ * console.log(`Merged ${pageCount} pages`);
+ * ```
+ *
+ * @example Large documents
+ * ```typescript
+ * // Works with large documents (5000+ pages)
+ * const pageCount = await mergePDF(
+ *   ['large_doc1.pdf', 'large_doc2.pdf'],
+ *   'combined.pdf'
+ * );
+ * ```
+ *
+ * @example Error handling
+ * ```typescript
+ * try {
+ *   await mergePDF(['doc1.pdf', 'doc2.pdf'], 'output.pdf');
+ * } catch (error) {
+ *   console.error('Merge failed:', error.message);
+ * }
+ * ```
+ */
+export declare function mergePDF(inputPaths: string[], outputPath: string): Promise<number>;
+//# sourceMappingURL=simple.d.ts.map

package/dist/simple.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.d.ts","sourceRoot":"","sources":["../src/simple.ts"],"names":[],"mappings":"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"}

package/dist/simple.js

@@ -0,0 +1,343 @@
+/**
+ * Simple API - Ultra-simplified functions for common PDF tasks
+ *
+ * This module provides the simplest possible API for basic PDF operations.
+ * Perfect for beginners or quick scripts.
+ *
+ * @example
+ * ```typescript
+ * import * as pdf from 'micropdf/simple';
+ *
+ * // Extract all text
+ * const text = await pdf.extractText('document.pdf');
+ *
+ * // Render first page to PNG
+ * await pdf.renderToPNG('document.pdf', 'output.png');
+ *
+ * // Get page count
+ * const pages = await pdf.getPageCount('document.pdf');
+ * ```
+ */
+import { EasyPDF } from './easy.js';
+import { Context } from './context.js';
+import { Enhanced } from './enhanced.js';
+import * as fs from 'fs/promises';
+/**
+ * Extract all text from a PDF
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns All text from the PDF
+ *
+ * @example
+ * ```typescript
+ * const text = await extractText('document.pdf');
+ * console.log(text);
+ * ```
+ */
+export async function extractText(pdfPath, password) {
+    return EasyPDF.open(pdfPath, password).use((pdf) => pdf.extractAllText());
+}
+/**
+ * Extract text from a specific page
+ *
+ * @param pdfPath - Path to PDF file
+ * @param pageNumber - Page number (0-indexed)
+ * @param password - Optional password for encrypted PDFs
+ * @returns Text from the specified page
+ *
+ * @example
+ * ```typescript
+ * const text = await extractPageText('document.pdf', 0);
+ * console.log(text);
+ * ```
+ */
+export async function extractPageText(pdfPath, pageNumber, password) {
+    return EasyPDF.open(pdfPath, password).use((pdf) => pdf.extractPageText(pageNumber));
+}
+/**
+ * Get the number of pages in a PDF
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns Number of pages
+ *
+ * @example
+ * ```typescript
+ * const count = await getPageCount('document.pdf');
+ * console.log(`Document has ${count} pages`);
+ * ```
+ */
+export async function getPageCount(pdfPath, password) {
+    return EasyPDF.open(pdfPath, password).use((pdf) => pdf.pageCount);
+}
+/**
+ * Get PDF metadata (title, author, etc.)
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns PDF metadata
+ *
+ * @example
+ * ```typescript
+ * const meta = await getMetadata('document.pdf');
+ * console.log(meta.title);
+ * console.log(meta.author);
+ * ```
+ */
+export async function getMetadata(pdfPath, password) {
+    return EasyPDF.open(pdfPath, password).use((pdf) => pdf.getMetadata());
+}
+/**
+ * Get complete document information
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns Document information including metadata and page details
+ *
+ * @example
+ * ```typescript
+ * const info = await getInfo('document.pdf');
+ * console.log(`Pages: ${info.pageCount}`);
+ * console.log(`Title: ${info.metadata.title}`);
+ * info.pages.forEach((page, i) => {
+ *   console.log(`Page ${i}: ${page.width}x${page.height}`);
+ * });
+ * ```
+ */
+export async function getInfo(pdfPath, password) {
+    return EasyPDF.open(pdfPath, password).use((pdf) => pdf.getInfo());
+}
+/**
+ * Render a page to PNG
+ *
+ * @param pdfPath - Path to PDF file
+ * @param outputPath - Output PNG file path
+ * @param pageNumber - Page number (0-indexed, default: 0)
+ * @param dpi - DPI for rendering (default: 150)
+ * @param password - Optional password for encrypted PDFs
+ *
+ * @example
+ * ```typescript
+ * // Render first page at 150 DPI
+ * await renderToPNG('document.pdf', 'output.png');
+ *
+ * // Render second page at 300 DPI
+ * await renderToPNG('document.pdf', 'output.png', 1, 300);
+ * ```
+ */
+export async function renderToPNG(pdfPath, outputPath, pageNumber = 0, dpi = 150, password) {
+    await EasyPDF.open(pdfPath, password).useAsync(async (pdf) => {
+        await pdf.renderToFile(pageNumber, outputPath, { dpi, format: 'png' });
+    });
+}
+/**
+ * Render all pages to PNG files
+ *
+ * @param pdfPath - Path to PDF file
+ * @param outputPattern - Output file pattern (use {page} for page number)
+ * @param dpi - DPI for rendering (default: 150)
+ * @param password - Optional password for encrypted PDFs
+ *
+ * @example
+ * ```typescript
+ * // Render all pages
+ * await renderAllToPNG('document.pdf', 'output/page-{page}.png');
+ *
+ * // High quality rendering
+ * await renderAllToPNG('document.pdf', 'output/page-{page}.png', 300);
+ * ```
+ */
+export async function renderAllToPNG(pdfPath, outputPattern, dpi = 150, password) {
+    await EasyPDF.open(pdfPath, password).useAsync(async (pdf) => {
+        await pdf.renderAllToFiles(outputPattern, { dpi, format: 'png' });
+    });
+}
+/**
+ * Get a page as a PNG buffer
+ *
+ * @param pdfPath - Path to PDF file
+ * @param pageNumber - Page number (0-indexed, default: 0)
+ * @param dpi - DPI for rendering (default: 150)
+ * @param password - Optional password for encrypted PDFs
+ * @returns PNG buffer
+ *
+ * @example
+ * ```typescript
+ * const buffer = await getPageAsPNG('document.pdf', 0, 300);
+ * await fs.writeFile('output.png', buffer);
+ * ```
+ */
+export async function getPageAsPNG(pdfPath, pageNumber = 0, dpi = 150, password) {
+    return EasyPDF.open(pdfPath, password).use((pdf) => pdf.renderToBuffer(pageNumber, { dpi, format: 'png' }));
+}
+/**
+ * Search for text in a PDF
+ *
+ * @param pdfPath - Path to PDF file
+ * @param query - Text to search for
+ * @param password - Optional password for encrypted PDFs
+ * @returns Array of page numbers where text was found
+ *
+ * @example
+ * ```typescript
+ * const pages = await searchText('document.pdf', 'important');
+ * console.log(`Found on pages: ${pages.join(', ')}`);
+ * ```
+ */
+export async function searchText(pdfPath, query, password) {
+    return EasyPDF.open(pdfPath, password).use((pdf) => {
+        const results = pdf.search(query);
+        // Return unique page numbers
+        return [...new Set(results.map((r) => r.pageNumber))];
+    });
+}
+/**
+ * Check if a PDF is encrypted
+ *
+ * @param pdfPath - Path to PDF file
+ * @returns True if the PDF is encrypted
+ *
+ * @example
+ * ```typescript
+ * if (await isEncrypted('document.pdf')) {
+ *   console.log('This PDF requires a password');
+ * }
+ * ```
+ */
+export async function isEncrypted(pdfPath) {
+    return EasyPDF.open(pdfPath).use((pdf) => pdf.isEncrypted);
+}
+/**
+ * Save text extraction to a file
+ *
+ * @param pdfPath - Path to PDF file
+ * @param outputPath - Output text file path
+ * @param password - Optional password for encrypted PDFs
+ *
+ * @example
+ * ```typescript
+ * await saveTextToFile('document.pdf', 'output.txt');
+ * ```
+ */
+export async function saveTextToFile(pdfPath, outputPath, password) {
+    const text = await extractText(pdfPath, password);
+    await fs.writeFile(outputPath, text, 'utf-8');
+}
+/**
+ * Convert PDF to images (one per page)
+ *
+ * @param pdfPath - Path to PDF file
+ * @param outputDir - Output directory for images
+ * @param options - Rendering options
+ * @returns Array of output file paths
+ *
+ * @example
+ * ```typescript
+ * const files = await convertToImages('document.pdf', 'output/', {
+ *   dpi: 300,
+ *   format: 'png'
+ * });
+ * console.log(`Created ${files.length} images`);
+ * ```
+ */
+export async function convertToImages(pdfPath, outputDir, options = {}) {
+    const { dpi = 150, format = 'png', password } = options;
+    // Ensure output directory exists
+    await fs.mkdir(outputDir, { recursive: true });
+    return EasyPDF.open(pdfPath, password).useAsync(async (pdf) => {
+        const files = [];
+        const pageCount = pdf.pageCount;
+        for (let i = 0; i < pageCount; i++) {
+            const outputPath = `${outputDir}/page-${String(i + 1).padStart(4, '0')}.${format}`;
+            await pdf.renderToFile(i, outputPath, { dpi, format });
+            files.push(outputPath);
+        }
+        return files;
+    });
+}
+/**
+ * Quick info summary for a PDF
+ *
+ * @param pdfPath - Path to PDF file
+ * @param password - Optional password for encrypted PDFs
+ * @returns Human-readable summary string
+ *
+ * @example
+ * ```typescript
+ * const summary = await quickSummary('document.pdf');
+ * console.log(summary);
+ * // Output:
+ * // Document: document.pdf
+ * // Pages: 42
+ * // Title: My Document
+ * // Author: John Doe
+ * // Encrypted: No
+ * ```
+ */
+export async function quickSummary(pdfPath, password) {
+    return EasyPDF.open(pdfPath, password).use((pdf) => {
+        const info = pdf.getInfo();
+        const lines = [
+            `Document: ${pdfPath}`,
+            `Pages: ${info.pageCount}`,
+            info.metadata.title ? `Title: ${info.metadata.title}` : null,
+            info.metadata.author ? `Author: ${info.metadata.author}` : null,
+            info.metadata.subject ? `Subject: ${info.metadata.subject}` : null,
+            `Encrypted: ${info.isEncrypted ? 'Yes' : 'No'}`,
+            `Has XFA: ${info.hasXfa ? 'Yes' : 'No'}`
+        ];
+        return lines.filter((l) => l !== null).join('\n');
+    });
+}
+/**
+ * Merge multiple PDF files into a single output file
+ *
+ * This is the simplest way to merge PDFs - just provide the input paths and output path.
+ * Handles large documents (5000+ pages) and corrupted PDFs robustly.
+ *
+ * @param inputPaths - Array of PDF file paths to merge (in order)
+ * @param outputPath - Path where the merged PDF will be saved
+ * @returns Promise that resolves to the number of pages in the merged PDF
+ * @throws Error if any input file is invalid, not found, or merge fails
+ *
+ * @example Basic merge
+ * ```typescript
+ * import { mergePDF } from 'micropdf/simple';
+ *
+ * const pageCount = await mergePDF(
+ *   ['document1.pdf', 'document2.pdf', 'document3.pdf'],
+ *   'merged.pdf'
+ * );
+ * console.log(`Merged ${pageCount} pages`);
+ * ```
+ *
+ * @example Large documents
+ * ```typescript
+ * // Works with large documents (5000+ pages)
+ * const pageCount = await mergePDF(
+ *   ['large_doc1.pdf', 'large_doc2.pdf'],
+ *   'combined.pdf'
+ * );
+ * ```
+ *
+ * @example Error handling
+ * ```typescript
+ * try {
+ *   await mergePDF(['doc1.pdf', 'doc2.pdf'], 'output.pdf');
+ * } catch (error) {
+ *   console.error('Merge failed:', error.message);
+ * }
+ * ```
+ */
+export async function mergePDF(inputPaths, outputPath) {
+    const ctx = new Context();
+    const enhanced = new Enhanced(ctx);
+    try {
+        return await enhanced.mergePDF(inputPaths, outputPath);
+    }
+    finally {
+        ctx.free();
+    }
+}
+//# sourceMappingURL=simple.js.map

package/dist/simple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.js","sourceRoot":"","sources":["../src/simple.ts"],"names":[],"mappings":"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"}