@plurnk/plurnk-mimetypes-application-pdf 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 PossumTech Laboratories, LLC
+
+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,23 @@
+# @plurnk/plurnk-mimetypes-application-pdf
+
+`application/pdf` mimetype handler for the [plurnk](https://github.com/plurnk) ecosystem. Binary content; extracts text via [pdfjs-dist](https://www.npmjs.com/package/pdfjs-dist).
+
+## install
+
+```
+npm i @plurnk/plurnk-mimetypes-application-pdf
+```
+
+## what it does
+
+PDF is a binary mimetype — the package declares `plurnk.binary: true`, and the framework reads files as `Uint8Array` before passing to handler methods.
+
+- `validate(content)` parses the PDF via pdfjs-dist's legacy build (Node-compatible); throws on parse failure or on image-only PDFs (scans without OCR — no extractable text means the LLM would get nothing useful).
+- `preview(content, budget)` extracts text page-by-page (joined with `\n\n`), budgeted via the framework's `fitContent`. This is the value-add: the consumer gets readable text content suitable for LLM ingestion.
+- `symbols(content)` empty (the preview *is* the structural signal for a PDF; future enhancement could surface the document outline / bookmarks as heading symbols).
+
+Salvage pattern from [rummy.web/WebFetcher.js](https://github.com/possumtech/rummy.web): pdfjs configured with `isEvalSupported: false` (no PDF JS execution) and `verbosity: 0` (silences font-warning noise — we read text streams directly, not glyphs).
+
+## license
+
+MIT.

package/dist/ApplicationPdf.d.ts

@@ -0,0 +1,6 @@
+import { BaseHandler } from "@plurnk/plurnk-mimetypes";
+export default class ApplicationPdf extends BaseHandler {
+    validate(content: string | Uint8Array): Promise<void>;
+    preview(content: string | Uint8Array, budget: number): Promise<string>;
+}
+//# sourceMappingURL=ApplicationPdf.d.ts.map

package/dist/ApplicationPdf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationPdf.d.ts","sourceRoot":"","sources":["../src/ApplicationPdf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAc,MAAM,0BAA0B,CAAC;AAqBnE,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQrD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAU/E"}

package/dist/ApplicationPdf.js

@@ -0,0 +1,77 @@
+import { BaseHandler, fitContent } from "@plurnk/plurnk-mimetypes";
+// application/pdf handler. Binary mimetype — receives Uint8Array content.
+// Validates the PDF parses cleanly and extracts text via pdfjs-dist; the
+// preview is the joined text content, budgeted via the framework's
+// fitContent.
+//
+// Salvage pattern from rummy.web/WebFetcher.js:
+//   - pdfjs-dist legacy build (Node-compatible)
+//   - isEvalSupported:false (no PDF JS execution)
+//   - verbosity:0 (silences "standardFontDataUrl not provided" noise;
+//     we read text streams directly and don't render glyphs)
+//   - Pages joined with "\n\n"
+//   - Image-only PDFs (scans without OCR) parse cleanly but produce no
+//     text — surfaced as a validate error, not an empty preview
+//
+// symbols() stays empty — PDFs have no exposed structural outline in the
+// duck contract today. (A future enhancement could read the PDF's
+// document outline / bookmarks as heading symbols, but the simpler
+// "extracted text as preview" path covers the LLM-consumption use case
+// cleanly.)
+export default class ApplicationPdf extends BaseHandler {
+    async validate(content) {
+        const bytes = toBytes(content);
+        const text = await extractAllText(bytes);
+        if (text.trim() === "") {
+            throw new Error("PDF has no extractable text (image-only scan, or encrypted/protected document)");
+        }
+    }
+    async preview(content, budget) {
+        const bytes = toBytes(content);
+        let text;
+        try {
+            text = await extractAllText(bytes);
+        }
+        catch {
+            return "";
+        }
+        return fitContent(text, budget, this.tokenize);
+    }
+}
+function toBytes(content) {
+    if (content instanceof Uint8Array)
+        return content;
+    // Treat string content as latin1 byte sequence — preserves bytes round-tripped
+    // through utf-8 only if every byte fits in 0–255, but consumers passing inline
+    // string content for binary mimetypes are responsible for the encoding choice.
+    return new TextEncoder().encode(content);
+}
+async function extractAllText(bytes) {
+    const pdfjs = await import("pdfjs-dist/legacy/build/pdf.mjs");
+    // isEvalSupported and verbosity are real pdfjs runtime parameters but
+    // aren't declared in DocumentInitParameters' published .d.ts — cast through
+    // unknown to set them without disabling type safety wholesale.
+    const params = {
+        data: bytes,
+        isEvalSupported: false,
+        verbosity: 0,
+    };
+    const doc = await pdfjs.getDocument(params).promise;
+    try {
+        const pages = [];
+        for (let i = 1; i <= doc.numPages; i += 1) {
+            const page = await doc.getPage(i);
+            const tc = await page.getTextContent();
+            const pageText = tc.items
+                .map((it) => it.str ?? "")
+                .join(" ");
+            pages.push(pageText);
+            page.cleanup();
+        }
+        return pages.join("\n\n");
+    }
+    finally {
+        await doc.destroy();
+    }
+}
+//# sourceMappingURL=ApplicationPdf.js.map

package/dist/ApplicationPdf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationPdf.js","sourceRoot":"","sources":["../src/ApplicationPdf.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEnE,0EAA0E;AAC1E,yEAAyE;AACzE,mEAAmE;AACnE,cAAc;AACd,EAAE;AACF,gDAAgD;AAChD,gDAAgD;AAChD,kDAAkD;AAClD,sEAAsE;AACtE,6DAA6D;AAC7D,+BAA+B;AAC/B,uEAAuE;AACvE,gEAAgE;AAChE,EAAE;AACF,yEAAyE;AACzE,kEAAkE;AAClE,mEAAmE;AACnE,uEAAuE;AACvE,YAAY;AACZ,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACnD,KAAK,CAAC,QAAQ,CAAC,OAA4B;QACvC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;QACtG,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAA4B,EAAE,MAAc;QACtD,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC/B,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACD,IAAI,GAAG,MAAM,cAAc,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;QACD,OAAO,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnD,CAAC;CACJ;AAED,SAAS,OAAO,CAAC,OAA4B;IACzC,IAAI,OAAO,YAAY,UAAU;QAAE,OAAO,OAAO,CAAC;IAClD,+EAA+E;IAC/E,+EAA+E;IAC/E,+EAA+E;IAC/E,OAAO,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,KAAiB;IAC3C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAC9D,sEAAsE;IACtE,4EAA4E;IAC5E,+DAA+D;IAC/D,MAAM,MAAM,GAAG;QACX,IAAI,EAAE,KAAK;QACX,eAAe,EAAE,KAAK;QACtB,SAAS,EAAE,CAAC;KACuC,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;IACpD,IAAI,CAAC;QACD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAClC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,EAAE,CAAC,KAAK;iBACpB,GAAG,CAAC,CAAC,EAAW,EAAE,EAAE,CAAE,EAAuB,CAAC,GAAG,IAAI,EAAE,CAAC;iBACxD,IAAI,CAAC,GAAG,CAAC,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrB,IAAI,CAAC,OAAO,EAAE,CAAC;QACnB,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;YAAS,CAAC;QACP,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default as ApplicationPdf } from "./ApplicationPdf.ts";
+export { default } from "./ApplicationPdf.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as ApplicationPdf } from "./ApplicationPdf.js";
+export { default } from "./ApplicationPdf.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+    "name": "@plurnk/plurnk-mimetypes-application-pdf",
+    "version": "0.1.0",
+    "description": "application/pdf mimetype handler for plurnk-service. Binary content; extracts text via pdfjs-dist.",
+    "type": "module",
+    "license": "MIT",
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": ">=25"
+    },
+    "plurnk": {
+        "kind": "mimetype",
+        "binary": true,
+        "handlers": [
+            { "name": "application/pdf", "glyph": "📕", "extensions": [".pdf"] }
+        ]
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "files": [
+        "dist/**/*",
+        "README.md"
+    ],
+    "scripts": {
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --test src/**/*.test.ts",
+        "test": "npm run test:lint && npm run test:unit",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:dist",
+        "prepare": "npm run build"
+    },
+    "dependencies": {
+        "@plurnk/plurnk-mimetypes": "^0.3.0",
+        "pdfjs-dist": "^5.0.0"
+    },
+    "devDependencies": {
+        "@types/node": "^25.8.0",
+        "typescript": "^6.0.3"
+    }
+}