@shuji-bonji/pdf-reader-mcp 0.2.0

package/dist/services/pdflib-service.js

@@ -0,0 +1,318 @@
+/**
+ * pdf-lib wrapper service.
+ *
+ * Provides low-level PDF structure access via pdf-lib for Tier 2 tools.
+ * Runs alongside pdfjs-service.ts (which handles text/image extraction).
+ */
+import { PDFArray, PDFDict, PDFDocument, PDFName, PDFNumber, PDFRef, PDFStream, PDFString, PDFHexString, } from 'pdf-lib';
+import { open } from 'node:fs/promises';
+import { readPdfFile } from '../utils/pdf-helpers.js';
+/**
+ * Load a PDF document with pdf-lib.
+ */
+export async function loadWithPdfLib(filePath) {
+    const data = await readPdfFile(filePath);
+    const doc = await PDFDocument.load(data, {
+        ignoreEncryption: true,
+        updateMetadata: false,
+    });
+    return doc;
+}
+/**
+ * Check if a PDF is encrypted.
+ */
+export async function detectEncryption(filePath) {
+    try {
+        const data = await readPdfFile(filePath);
+        const doc = await PDFDocument.load(data, {
+            ignoreEncryption: true,
+            updateMetadata: false,
+        });
+        return doc.isEncrypted;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Analyze PDF internal structure (catalog, page tree, objects).
+ */
+export async function analyzeStructure(filePath) {
+    const doc = await loadWithPdfLib(filePath);
+    const catalog = doc.catalog;
+    const context = doc.context;
+    // Extract catalog entries
+    const catalogEntries = [];
+    for (const [key, value] of catalog.entries()) {
+        catalogEntries.push({
+            key: key.decodeText(),
+            type: value.constructor.name,
+            value: summarizeObject(value),
+        });
+    }
+    // Page tree info
+    const pages = doc.getPages();
+    const maxSamples = Math.min(pages.length, 5);
+    const mediaBoxSamples = [];
+    for (let i = 0; i < maxSamples; i++) {
+        const box = pages[i].getMediaBox();
+        mediaBoxSamples.push({
+            page: i + 1,
+            width: Math.round(box.width * 100) / 100,
+            height: Math.round(box.height * 100) / 100,
+        });
+    }
+    const pageTree = {
+        totalPages: doc.getPageCount(),
+        mediaBoxSamples,
+    };
+    // Object statistics
+    const allObjects = context.enumerateIndirectObjects();
+    const byType = {};
+    let streamCount = 0;
+    for (const [_ref, obj] of allObjects) {
+        const typeName = obj.constructor.name;
+        byType[typeName] = (byType[typeName] ?? 0) + 1;
+        if (obj instanceof PDFStream) {
+            streamCount++;
+        }
+    }
+    const objectStats = {
+        totalObjects: allObjects.length,
+        streamCount,
+        byType,
+    };
+    // PDF version: prefer catalog /Version, fallback to file header %PDF-x.y
+    let pdfVersion = null;
+    const versionEntry = catalog.lookupMaybe(PDFName.of('Version'), PDFName);
+    if (versionEntry) {
+        pdfVersion = versionEntry.decodeText();
+    }
+    else {
+        try {
+            // Read only the first 20 bytes for the PDF header instead of the entire file
+            const fh = await open(filePath, 'r');
+            try {
+                const buf = Buffer.alloc(20);
+                await fh.read(buf, 0, 20, 0);
+                const match = buf.toString('ascii').match(/%PDF-(\d+\.\d+)/);
+                if (match)
+                    pdfVersion = match[1];
+            }
+            finally {
+                await fh.close();
+            }
+        }
+        catch {
+            // Ignore header read errors
+        }
+    }
+    return {
+        catalog: catalogEntries,
+        pageTree,
+        objectStats,
+        isEncrypted: doc.isEncrypted,
+        pdfVersion,
+    };
+}
+/**
+ * Analyze fonts across all pages using pdf-lib's low-level access.
+ * Returns font map and total pages scanned.
+ */
+export async function analyzeFontsWithPdfLib(filePath) {
+    const doc = await loadWithPdfLib(filePath);
+    const fontMap = new Map();
+    const pages = doc.getPages();
+    for (let pageIdx = 0; pageIdx < pages.length; pageIdx++) {
+        const pageNum = pageIdx + 1;
+        const pageNode = pages[pageIdx].node;
+        const resources = pageNode.Resources();
+        if (!resources)
+            continue;
+        const fontDict = resources.lookupMaybe(PDFName.of('Font'), PDFDict);
+        if (!fontDict)
+            continue;
+        for (const [fontNameObj, fontRefOrDict] of fontDict.entries()) {
+            const fontKey = fontNameObj.decodeText();
+            // Resolve to actual font dictionary
+            let actualFont;
+            if (fontRefOrDict instanceof PDFRef) {
+                const resolved = doc.context.lookup(fontRefOrDict);
+                if (resolved instanceof PDFDict) {
+                    actualFont = resolved;
+                }
+            }
+            else if (fontRefOrDict instanceof PDFDict) {
+                actualFont = fontRefOrDict;
+            }
+            if (!actualFont)
+                continue;
+            // Extract font properties
+            const subtypeObj = actualFont.lookupMaybe(PDFName.of('Subtype'), PDFName);
+            const baseFontObj = actualFont.lookupMaybe(PDFName.of('BaseFont'), PDFName);
+            const encodingObj = actualFont.get(PDFName.of('Encoding'));
+            const baseFontName = baseFontObj?.decodeText() ?? fontKey;
+            const subtype = subtypeObj?.decodeText() ?? 'Unknown';
+            const encoding = encodingObj instanceof PDFName ? encodingObj.decodeText() : null;
+            // Check if font is embedded (has FontDescriptor with FontFile/FontFile2/FontFile3)
+            let isEmbedded = false;
+            const descriptorRef = actualFont.get(PDFName.of('FontDescriptor'));
+            if (descriptorRef) {
+                let descriptor;
+                if (descriptorRef instanceof PDFRef) {
+                    const resolved = doc.context.lookup(descriptorRef);
+                    if (resolved instanceof PDFDict)
+                        descriptor = resolved;
+                }
+                else if (descriptorRef instanceof PDFDict) {
+                    descriptor = descriptorRef;
+                }
+                if (descriptor) {
+                    isEmbedded =
+                        descriptor.has(PDFName.of('FontFile')) ||
+                            descriptor.has(PDFName.of('FontFile2')) ||
+                            descriptor.has(PDFName.of('FontFile3'));
+                }
+            }
+            // Check if subset (name starts with 6 uppercase + '+')
+            const isSubset = /^[A-Z]{6}\+/.test(baseFontName);
+            const existing = fontMap.get(baseFontName);
+            if (existing) {
+                if (!existing.pagesUsed.includes(pageNum)) {
+                    existing.pagesUsed.push(pageNum);
+                }
+            }
+            else {
+                fontMap.set(baseFontName, {
+                    name: baseFontName,
+                    type: subtype,
+                    encoding,
+                    isEmbedded,
+                    isSubset,
+                    pagesUsed: [pageNum],
+                });
+            }
+        }
+    }
+    return { fontMap, pagesScanned: pages.length };
+}
+/**
+ * Analyze digital signature fields.
+ */
+export async function analyzeSignatures(filePath) {
+    const doc = await loadWithPdfLib(filePath);
+    const fields = [];
+    try {
+        const acroForm = doc.catalog.getAcroForm();
+        if (!acroForm) {
+            return {
+                totalFields: 0,
+                signedCount: 0,
+                unsignedCount: 0,
+                fields: [],
+                note: 'No AcroForm found in the document.',
+            };
+        }
+        const allFields = acroForm.getAllFields();
+        for (const [field, _ref] of allFields) {
+            const ftName = field.dict.lookupMaybe(PDFName.of('FT'), PDFName);
+            if (!ftName || ftName.decodeText() !== 'Sig')
+                continue;
+            const fieldName = field.getFullyQualifiedName() ?? field.getPartialName() ?? '(unnamed)';
+            const vObj = field.dict.get(PDFName.of('V'));
+            let isSigned = false;
+            let signerName = null;
+            let reason = null;
+            let location = null;
+            let contactInfo = null;
+            let signingTime = null;
+            let filter = null;
+            let subFilter = null;
+            // If V exists, the field has been signed
+            if (vObj) {
+                isSigned = true;
+                let sigDict;
+                if (vObj instanceof PDFRef) {
+                    const resolved = doc.context.lookup(vObj);
+                    if (resolved instanceof PDFDict)
+                        sigDict = resolved;
+                }
+                else if (vObj instanceof PDFDict) {
+                    sigDict = vObj;
+                }
+                if (sigDict) {
+                    signerName = extractStringFromDict(sigDict, 'Name');
+                    reason = extractStringFromDict(sigDict, 'Reason');
+                    location = extractStringFromDict(sigDict, 'Location');
+                    contactInfo = extractStringFromDict(sigDict, 'ContactInfo');
+                    signingTime = extractStringFromDict(sigDict, 'M');
+                    const filterObj = sigDict.lookupMaybe(PDFName.of('Filter'), PDFName);
+                    filter = filterObj?.decodeText() ?? null;
+                    const subFilterObj = sigDict.lookupMaybe(PDFName.of('SubFilter'), PDFName);
+                    subFilter = subFilterObj?.decodeText() ?? null;
+                }
+            }
+            fields.push({
+                fieldName,
+                isSigned,
+                signerName,
+                reason,
+                location,
+                contactInfo,
+                signingTime,
+                filter,
+                subFilter,
+            });
+        }
+    }
+    catch {
+        // Some PDFs may have malformed AcroForm
+    }
+    const signedCount = fields.filter((f) => f.isSigned).length;
+    return {
+        totalFields: fields.length,
+        signedCount,
+        unsignedCount: fields.length - signedCount,
+        fields,
+        note: 'Cryptographic signature verification is not performed. Only field structure is inspected.',
+    };
+}
+// ─── Internal helpers ────────────────────────────────────
+/**
+ * Summarize a PDF object for display (truncated).
+ */
+function summarizeObject(obj) {
+    if (obj instanceof PDFRef)
+        return `ref(${obj.objectNumber})`;
+    if (obj instanceof PDFName)
+        return obj.decodeText();
+    if (obj instanceof PDFArray)
+        return `Array[${obj.size()}]`;
+    if (obj instanceof PDFDict)
+        return `Dict{${obj.entries().length} entries}`;
+    if (obj instanceof PDFStream)
+        return `Stream{${obj.getContentsSize()} bytes}`;
+    if (obj instanceof PDFNumber)
+        return String(obj.asNumber());
+    if (obj instanceof PDFString)
+        return obj.decodeText();
+    if (obj instanceof PDFHexString)
+        return obj.decodeText();
+    if (obj === undefined || obj === null)
+        return 'null';
+    return String(obj);
+}
+/**
+ * Extract a string value from a PDFDict by key name.
+ */
+function extractStringFromDict(dict, key) {
+    const obj = dict.get(PDFName.of(key));
+    if (obj instanceof PDFString)
+        return obj.decodeText();
+    if (obj instanceof PDFHexString)
+        return obj.decodeText();
+    if (obj instanceof PDFName)
+        return obj.decodeText();
+    return null;
+}
+//# sourceMappingURL=pdflib-service.js.map

package/dist/services/pdflib-service.js.map

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

package/dist/services/url-fetcher.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Remote PDF fetcher service.
+ */
+/**
+ * Fetch a PDF from a URL and return it as Uint8Array.
+ */
+export declare function fetchPdfFromUrl(url: string): Promise<Uint8Array>;
+//# sourceMappingURL=url-fetcher.d.ts.map

package/dist/services/url-fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-fetcher.d.ts","sourceRoot":"","sources":["../../src/services/url-fetcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH;;GAEG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAuDtE"}

package/dist/services/url-fetcher.js

@@ -0,0 +1,40 @@
+/**
+ * Remote PDF fetcher service.
+ */
+import { MAX_FILE_SIZE, SERVER_NAME, SERVER_VERSION } from '../constants.js';
+import { PdfReaderError } from '../utils/error-handler.js';
+/**
+ * Fetch a PDF from a URL and return it as Uint8Array.
+ */
+export async function fetchPdfFromUrl(url) {
+    let parsedUrl;
+    try {
+        parsedUrl = new URL(url);
+    }
+    catch {
+        throw new PdfReaderError(`Invalid URL: ${url}`, 'INVALID_URL', 'Provide a valid HTTP or HTTPS URL pointing to a PDF file.');
+    }
+    if (!['http:', 'https:'].includes(parsedUrl.protocol)) {
+        throw new PdfReaderError(`Unsupported protocol: ${parsedUrl.protocol}`, 'UNSUPPORTED_PROTOCOL', 'Only HTTP and HTTPS URLs are supported.');
+    }
+    const response = await fetch(url, {
+        headers: {
+            Accept: 'application/pdf',
+            'User-Agent': `${SERVER_NAME}/${SERVER_VERSION}`,
+        },
+        signal: AbortSignal.timeout(30_000),
+    });
+    if (!response.ok) {
+        throw new PdfReaderError(`Failed to fetch PDF: HTTP ${response.status} ${response.statusText}`, 'FETCH_FAILED', 'Check the URL is correct and accessible.');
+    }
+    const contentLength = response.headers.get('content-length');
+    if (contentLength && parseInt(contentLength, 10) > MAX_FILE_SIZE) {
+        throw new PdfReaderError(`Remote PDF size (${(parseInt(contentLength, 10) / 1024 / 1024).toFixed(1)}MB) exceeds the 50MB limit.`, 'FILE_TOO_LARGE', 'Try a smaller PDF file.');
+    }
+    const buffer = await response.arrayBuffer();
+    if (buffer.byteLength > MAX_FILE_SIZE) {
+        throw new PdfReaderError(`Downloaded PDF size (${(buffer.byteLength / 1024 / 1024).toFixed(1)}MB) exceeds the 50MB limit.`, 'FILE_TOO_LARGE', 'Try a smaller PDF file.');
+    }
+    return new Uint8Array(buffer);
+}
+//# sourceMappingURL=url-fetcher.js.map

package/dist/services/url-fetcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-fetcher.js","sourceRoot":"","sources":["../../src/services/url-fetcher.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAW;IAC/C,IAAI,SAAc,CAAC;IACnB,IAAI,CAAC;QACH,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CACtB,gBAAgB,GAAG,EAAE,EACrB,aAAa,EACb,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,MAAM,IAAI,cAAc,CACtB,yBAAyB,SAAS,CAAC,QAAQ,EAAE,EAC7C,sBAAsB,EACtB,yCAAyC,CAC1C,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAChC,OAAO,EAAE;YACP,MAAM,EAAE,iBAAiB;YACzB,YAAY,EAAE,GAAG,WAAW,IAAI,cAAc,EAAE;SACjD;QACD,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;KACpC,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,cAAc,CACtB,6BAA6B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,EACrE,cAAc,EACd,0CAA0C,CAC3C,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAC7D,IAAI,aAAa,IAAI,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,GAAG,aAAa,EAAE,CAAC;QACjE,MAAM,IAAI,cAAc,CACtB,oBAAoB,CAAC,QAAQ,CAAC,aAAa,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,EACvG,gBAAgB,EAChB,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,MAAM,CAAC,UAAU,GAAG,aAAa,EAAE,CAAC;QACtC,MAAM,IAAI,cAAc,CACtB,wBAAwB,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,6BAA6B,EACjG,gBAAgB,EAChB,yBAAyB,CAC1B,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/services/validation-service.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Validation & comparison service for Tier 3 tools.
+ *
+ * Provides PDF/UA tag validation, metadata conformance checks,
+ * and structural comparison between two PDFs.
+ */
+import type { MetadataValidation, StructureComparison, TaggedValidation } from '../types.js';
+/**
+ * Validate PDF/UA tagged structure requirements.
+ *
+ * Checks performed:
+ * - Document is marked as tagged
+ * - Structure tree root exists
+ * - Document-level root tag present
+ * - Heading hierarchy (H1-H6) is sequential
+ * - Figure tags have content (potential alt text)
+ * - Table tags are present when expected
+ * - Minimum structure depth
+ */
+export declare function validateTagged(filePath: string): Promise<TaggedValidation>;
+/**
+ * Validate PDF metadata conformance.
+ *
+ * Checks performed:
+ * - Title is present (required for PDF/UA, PDF/A)
+ * - Author is present
+ * - CreationDate format
+ * - ModificationDate format
+ * - Producer is present
+ * - PDF version is detected
+ * - Document is tagged (metadata flag)
+ * - Subject and Keywords (informational)
+ */
+export declare function validateMetadata(filePath: string): Promise<MetadataValidation>;
+/**
+ * Compare the structure of two PDF documents.
+ *
+ * Compares:
+ * - Page count
+ * - PDF version
+ * - Encryption status
+ * - Tagged status
+ * - Total objects
+ * - Stream count
+ * - Page dimensions (first page)
+ * - Fonts used (set difference)
+ */
+export declare function compareStructure(filePath1: string, filePath2: string): Promise<StructureComparison>;
+//# sourceMappingURL=validation-service.d.ts.map

package/dist/services/validation-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-service.d.ts","sourceRoot":"","sources":["../../src/services/validation-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EAEnB,gBAAgB,EAEjB,MAAM,aAAa,CAAC;AAYrB;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgShF;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8PpF;AAID;;;;;;;;;;;;GAYG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,mBAAmB,CAAC,CAyF9B"}