pdf-codec 3.1.1 → 3.1.3

package/README.md

@@ -87,6 +87,8 @@ An encrypted PDF that opens without a password decrypts transparently — no ext
 
 Both accept an optional `signal` (`AbortSignal`); `readPdf` additionally takes a `sink` (`PdfDiagnosticSink`, called once per recoverable parse diagnostic — see the three-tier failure policy under [Conventions](#conventions)), and `writePdf` an `onSubstitution` callback (called once per character not representable in a standard-14 font — see [Fidelity](#fidelity)).
 
+**Cancellation granularity and cost, for CPU-metered runtimes.** Both pipelines are synchronous end to end — there is no `await` point for cancellation to hook into implicitly — so the `signal` is checked explicitly, once per page-loop iteration (and once before `readPdf`'s document-open phase begins). A signal aborted mid-parse therefore takes effect at the next page boundary, not instantly: `readPdf`'s document-open phase (cross-reference resolution, object parsing) and a single page's content-stream interpretation are the two spans that cannot be interrupted, and a document consisting of one enormous page is effectively uninterruptible however many pages it claims. Cost is roughly linear in decompressed content length, so budget for the worst single page, not the page count. On Cloudflare Workers this is the honest shape of the trade: the parse holds the isolate for its whole duration with no opportunity to yield or report progress, and an `AbortSignal` shared with whatever can abort concurrently (a binding, another context) makes a deadline enforceable at page granularity — but it cannot convert a synchronous parse into a resumable one. An async page-at-a-time API is a deliberate non-goal of this package's current surface.
+
 The same round trip is also available as a schema-validated [`z.codec()`](https://zod.dev) pair:
 
 ```ts

package/dist/read.cjs

@@ -30,6 +30,7 @@ function readPdf(bytes, options) {
 	const sink = options?.sink ?? require_diagnostics.NOOP_DIAGNOSTIC_SINK;
 	const signal = options?.signal;
 	if (!hasPdfHeader(bytes)) throw new require_diagnostics.PdfParseError("pdf/no-header", "no \"%PDF-\" header found within the first bytes of the file; this does not look like a PDF at all");
+	require_util_abort.throwIfAborted(signal);
 	const doc = require_document.openPdfDocument(bytes, sink);
 	const fontResolver = require_font_read.createFontResolver({
 		resolver: doc,

package/dist/read.js

@@ -29,6 +29,7 @@ function readPdf(bytes, options) {
 	const sink = options?.sink ?? NOOP_DIAGNOSTIC_SINK;
 	const signal = options?.signal;
 	if (!hasPdfHeader(bytes)) throw new PdfParseError("pdf/no-header", "no \"%PDF-\" header found within the first bytes of the file; this does not look like a PDF at all");
+	throwIfAborted(signal);
 	const doc = openPdfDocument(bytes, sink);
 	const fontResolver = createFontResolver({
 		resolver: doc,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-codec",
-  "version": "3.1.1",
+  "version": "3.1.3",
   "description": "Hand-written, dependency-minimal PDF codec: parses arbitrary real-world PDFs and generates new ones, built on its own codec-owned LayoutDocument item model and Zod 4 codecs.",
   "type": "module",
   "repository": {
@@ -98,7 +98,7 @@
   "packageManager": "pnpm@11.6.0",
   "dependencies": {
     "byte-codec": "^1.1.13",
-    "document-schema.js": "^4.5.0",
+    "document-schema.js": "^4.6.0",
     "fflate": "^0.8.3",
     "zod": "^4.4.3"
   },