omitly-mcp 5.3.0 → 5.5.0

package/dist/pdf-edit/compose.js

@@ -0,0 +1,175 @@
+/**
+ * omitly#1841 phase B: the writers built on `extractPagesDoc` (design 4.3).
+ *
+ * `extractPagesTo` serves `extract_pages` and `split_pdf`; `composePages` serves
+ * `edit_pages`. Both start from `extractPages`' default-deny preparation (pages
+ * not kept are neutered in the private source copy first), never from a fresh
+ * document with pages copied in, because that route pulls excluded pages back in
+ * through form widgets (the #1004 leak). Signatures are removed in the SOURCE
+ * before anything is copied.
+ */
+import { PDFName, PDFNumber } from "pdf-lib";
+import { LAYERS_WARNING, SIGNATURE_WARNING, clearSigFlags, scrubDestinationFields, scrubDestinationSignatures, sourceFacts, stripSignaturesFromSource, } from "./docFacts.js";
+import { extractPagesDoc, openExtractionSession } from "./pageOps.js";
+import { EditRefusal } from "./refusals.js";
+const A4 = [595.28, 841.89];
+const LETTER = [612, 792];
+function isAscending(xs) {
+    for (let i = 1; i < xs.length; i++)
+        if (xs[i] <= xs[i - 1])
+            return false;
+    return true;
+}
+/** Shared source inspection: range check, dynamic-XFA refusal, signature removal. */
+function makeInspector(zeroBasedPages, onItem) {
+    return (src) => {
+        const pageCount = src.getPageCount();
+        for (const p of zeroBasedPages) {
+            if (p >= pageCount)
+                throw new EditRefusal("page_out_of_range", { item: p + 1, pageCount });
+        }
+        const facts = sourceFacts(src);
+        if (facts.xfa === "dynamic")
+            throw new EditRefusal("xfa");
+        // Before anything is copied; see docFacts.stripSignaturesFromSource.
+        const signed = stripSignaturesFromSource(src);
+        onItem(facts, signed);
+    };
+}
+/** Turn a prepared extraction into the writer's result: lost codes, warnings, the destination
+ *  backstop, and the save. Shared by the one-shot and the session path. */
+async function finishExtraction(doc, zeroBasedPages, facts, signedInSource) {
+    clearSigFlags(doc);
+    const lost = [];
+    const warnings = [];
+    let signed = signedInSource;
+    if (facts?.pageLabels && !isAscending(zeroBasedPages)) {
+        // copyPageLabelsForExtractedPages assumes ascending order.
+        doc.catalog.delete(PDFName.of("PageLabels"));
+        lost.push("page_labels");
+    }
+    if (facts?.layers) {
+        lost.push("layers");
+        warnings.push(LAYERS_WARNING);
+    }
+    if (facts?.xfa === "static")
+        lost.push("xfa");
+    // Backstops: anything the source scrubs missed, just before the bytes are written.
+    scrubDestinationFields(doc);
+    if (scrubDestinationSignatures(doc))
+        signed = true;
+    if (signed)
+        warnings.push(SIGNATURE_WARNING);
+    const out = await doc.save();
+    return { bytes: out, pageCount: doc.getPageCount(), lost, warnings };
+}
+/** `extract_pages`: keep these pages (0-based), in this order. */
+export async function extractPagesTo(bytes, zeroBasedPages) {
+    let facts;
+    let signed = false;
+    const doc = await extractPagesDoc(bytes, zeroBasedPages, {
+        preserveCatalog: true,
+        inspectSource: makeInspector(zeroBasedPages, (f, s) => {
+            facts = f;
+            signed = s;
+        }),
+    });
+    return finishExtraction(doc, zeroBasedPages, facts, signed);
+}
+/** `split_pdf`: parse the input ONCE, then one default-deny extraction per range (the same code as
+ *  `extractPagesTo`, with its source mutations undone between ranges; see openExtractionSession). */
+export async function openRangeExtractor(bytes) {
+    let facts;
+    let signed = false;
+    // Facts and the signature scrub of the SOURCE are properties of the document, not of a range:
+    // done once, here, before any copy. The page-range check is per range, below.
+    const session = await openExtractionSession(bytes, {
+        inspectSource: makeInspector([], (f, s) => {
+            facts = f;
+            signed = s;
+        }),
+    });
+    return {
+        async extract(zeroBasedPages) {
+            for (const p of zeroBasedPages) {
+                if (p >= session.pageCount)
+                    throw new EditRefusal("page_out_of_range", { item: p + 1, pageCount: session.pageCount });
+            }
+            const doc = await session.extract(zeroBasedPages, { preserveCatalog: true });
+            return finishExtraction(doc, zeroBasedPages, facts, signed);
+        },
+    };
+}
+/** `edit_pages`: the final page list. */
+export async function composePages(bytes, layout) {
+    const sources = [];
+    const seen = new Set();
+    let hasBlank = false;
+    for (const e of layout) {
+        if ("blank" in e) {
+            hasBlank = true;
+            continue;
+        }
+        if (seen.has(e.source))
+            throw new EditRefusal("duplicate_page", { item: e.source });
+        seen.add(e.source);
+        sources.push(e.source - 1);
+    }
+    if (sources.length === 0)
+        throw new EditRefusal("no_source_pages");
+    let facts;
+    let signed = false;
+    const doc = await extractPagesDoc(bytes, sources, {
+        preserveCatalog: true,
+        inspectSource: makeInspector(sources, (f, s) => {
+            facts = f;
+            signed = s;
+        }),
+    });
+    clearSigFlags(doc);
+    const extracted = doc.getPages(); // in `sources` order, which is list order
+    const echo = [];
+    let next = 0;
+    let out = 0;
+    for (const e of layout) {
+        if ("blank" in e) {
+            const prev = out > 0 ? doc.getPage(out - 1).getSize() : undefined;
+            const [w, h] = e.size === "Letter" ? LETTER : e.size === "A4" ? A4 : prev ? [prev.width, prev.height] : A4;
+            doc.insertPage(out, [w, h]);
+            echo.push({ pageNumber: out + 1, from: "blank", rotation: 0 });
+        }
+        else {
+            const page = extracted[next++];
+            const existing = page.node.Rotate()?.asNumber() ?? 0;
+            // Written directly: pdf-lib's setRotation throws on any non-multiple of 90,
+            // and some real files carry one.
+            const angle = (((existing + e.rotate) % 360) + 360) % 360;
+            if (e.rotate !== 0)
+                page.node.set(PDFName.of("Rotate"), PDFNumber.of(angle));
+            echo.push({ pageNumber: out + 1, from: e.source, rotation: angle });
+        }
+        out++;
+    }
+    const lost = [];
+    const warnings = [];
+    const reordered = !isAscending(sources);
+    if (facts?.pageLabels && (reordered || hasBlank)) {
+        // Their numbering would now be wrong.
+        doc.catalog.delete(PDFName.of("PageLabels"));
+        lost.push("page_labels");
+    }
+    if (facts?.layers) {
+        lost.push("layers");
+        warnings.push(LAYERS_WARNING);
+    }
+    if (facts?.xfa === "static")
+        lost.push("xfa");
+    scrubDestinationFields(doc);
+    if (scrubDestinationSignatures(doc))
+        signed = true;
+    if (signed)
+        warnings.push(SIGNATURE_WARNING);
+    const saved = await doc.save();
+    return { bytes: saved, pageCount: doc.getPageCount(), lost, warnings, layout: echo };
+}
+//# sourceMappingURL=compose.js.map

package/dist/pdf-edit/compose.js.map

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