pdf-oxide-wasm 0.3.49 → 0.3.51

package/bundler/pdf_oxide_bg.wasm.d.ts

@@ -2,6 +2,8 @@
 /* eslint-disable */
 export const memory: WebAssembly.Memory;
 export const __wbg_artifactstyle_free: (a: number, b: number) => void;
+export const __wbg_dss_free: (a: number, b: number) => void;
+export const __wbg_revocationmaterial_free: (a: number, b: number) => void;
 export const __wbg_streamingtable_free: (a: number, b: number) => void;
 export const __wbg_wasmartifact_free: (a: number, b: number) => void;
 export const __wbg_wasmcertificate_free: (a: number, b: number) => void;
@@ -15,10 +17,20 @@ export const __wbg_wasmpdfdocument_free: (a: number, b: number) => void;
 export const __wbg_wasmpdfpageregion_free: (a: number, b: number) => void;
 export const __wbg_wasmsignature_free: (a: number, b: number) => void;
 export const __wbg_wasmtimestamp_free: (a: number, b: number) => void;
+export const cryptoCbom: (a: number) => void;
+export const cryptoInventory: (a: number) => void;
+export const cryptoPolicy: (a: number) => void;
 export const generateBarcodeSvg: (a: number, b: number, c: number, d: number) => void;
 export const generateQrSvg: (a: number, b: number, c: number, d: number, e: number) => void;
+export const hasDocumentTimestamp: (a: number, b: number) => number;
+export const modelManifest: (a: number) => void;
+export const planSplitByBookmarks: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+export const prefetchAvailable: () => number;
+export const setCryptoPolicy: (a: number, b: number, c: number) => void;
 export const setLogLevel: (a: number, b: number, c: number) => void;
 export const signPdfBytes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
+export const signPdfBytesPades: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number, k: number, l: number) => void;
+export const splitByBookmarks: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number) => void;
 export const streamingtable_batchCount: (a: number) => number;
 export const streamingtable_columnCount: (a: number) => number;
 export const streamingtable_finish: (a: number, b: number) => void;
@@ -61,6 +73,11 @@ export const wasmdocumentbuilder_subject: (a: number, b: number, c: number, d: n
 export const wasmdocumentbuilder_taggedPdfUa1: (a: number, b: number) => void;
 export const wasmdocumentbuilder_title: (a: number, b: number, c: number, d: number) => void;
 export const wasmdocumentbuilder_toBytesEncrypted: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
+export const wasmdss_certCount: (a: number) => number;
+export const wasmdss_getCert: (a: number, b: number, c: number) => void;
+export const wasmdss_getCrl: (a: number, b: number, c: number) => void;
+export const wasmdss_getOcsp: (a: number, b: number, c: number) => void;
+export const wasmdss_vri: (a: number, b: number) => void;
 export const wasmembeddedfont_fromBytes: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmembeddedfont_name: (a: number, b: number) => void;
 export const wasmfluentpagebuilder_at: (a: number, b: number, c: number, d: number) => void;
@@ -138,13 +155,18 @@ export const wasmpdf_fromText: (a: number, b: number, c: number, d: number, e: n
 export const wasmpdf_merge: (a: number, b: number, c: number) => void;
 export const wasmpdf_size: (a: number) => number;
 export const wasmpdf_toBytes: (a: number, b: number) => void;
+export const wasmpdfdocument_addRedaction: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number) => void;
 export const wasmpdfdocument_applyAllRedactions: (a: number, b: number) => void;
 export const wasmpdfdocument_applyPageRedactions: (a: number, b: number, c: number) => void;
+export const wasmpdfdocument_applyRedactionsDestructive: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_authenticate: (a: number, b: number, c: number, d: number) => void;
+export const wasmpdfdocument_classifyDocument: (a: number, b: number) => void;
+export const wasmpdfdocument_classifyPage: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_clearEraseRegions: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_convertToPdfA: (a: number, b: number, c: number, d: number) => void;
 export const wasmpdfdocument_cropMargins: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
 export const wasmpdfdocument_deletePage: (a: number, b: number, c: number) => void;
+export const wasmpdfdocument_dss: (a: number, b: number) => void;
 export const wasmpdfdocument_editFooter: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_editHeader: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_embedFile: (a: number, b: number, c: number, d: number, e: number, f: number) => void;
@@ -159,6 +181,7 @@ export const wasmpdfdocument_extractChars: (a: number, b: number, c: number, d:
 export const wasmpdfdocument_extractImageBytes: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_extractImages: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_extractLines: (a: number, b: number, c: number, d: number, e: number) => void;
+export const wasmpdfdocument_extractPageAuto: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_extractPageText: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_extractPages: (a: number, b: number, c: number, d: number) => void;
 export const wasmpdfdocument_extractPaths: (a: number, b: number, c: number, d: number, e: number) => void;
@@ -166,6 +189,7 @@ export const wasmpdfdocument_extractRects: (a: number, b: number, c: number, d:
 export const wasmpdfdocument_extractSpans: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const wasmpdfdocument_extractTables: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_extractText: (a: number, b: number, c: number, d: number) => void;
+export const wasmpdfdocument_extractTextAuto: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_extractTextLines: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_extractTextOcr: (a: number, b: number, c: number, d: number) => void;
 export const wasmpdfdocument_extractWords: (a: number, b: number, c: number, d: number, e: number) => void;
@@ -193,6 +217,7 @@ export const wasmpdfdocument_pageImages: (a: number, b: number, c: number) => vo
 export const wasmpdfdocument_pageLabels: (a: number, b: number) => void;
 export const wasmpdfdocument_pageMediaBox: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_pageRotation: (a: number, b: number, c: number) => void;
+export const wasmpdfdocument_redactionCount: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_removeArtifacts: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_removeFooters: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_removeHeaders: (a: number, b: number, c: number) => void;
@@ -201,6 +226,7 @@ export const wasmpdfdocument_repositionImage: (a: number, b: number, c: number,
 export const wasmpdfdocument_resizeImage: (a: number, b: number, c: number, d: number, e: number, f: number, g: number) => void;
 export const wasmpdfdocument_rotateAllPages: (a: number, b: number, c: number) => void;
 export const wasmpdfdocument_rotatePage: (a: number, b: number, c: number, d: number) => void;
+export const wasmpdfdocument_sanitizeDocument: (a: number, b: number, c: number, d: number, e: number) => void;
 export const wasmpdfdocument_save: (a: number, b: number) => void;
 export const wasmpdfdocument_saveEncryptedToBytes: (a: number, b: number, c: number, d: number, e: number, f: number, g: number, h: number, i: number, j: number) => void;
 export const wasmpdfdocument_saveWithOptions: (a: number, b: number, c: number, d: number, e: number) => void;
@@ -242,9 +268,14 @@ export const wasmpdfpageregion_extractText: (a: number, b: number) => void;
 export const wasmpdfpageregion_extractTextLines: (a: number, b: number) => void;
 export const wasmpdfpageregion_extractTextOcr: (a: number, b: number, c: number) => void;
 export const wasmpdfpageregion_extractWords: (a: number, b: number) => void;
+export const wasmrevocationmaterial_addCert: (a: number, b: number, c: number) => void;
+export const wasmrevocationmaterial_addCrl: (a: number, b: number, c: number) => void;
+export const wasmrevocationmaterial_addOcsp: (a: number, b: number, c: number) => void;
+export const wasmrevocationmaterial_new: () => number;
 export const wasmsignature_contactInfo: (a: number, b: number) => void;
 export const wasmsignature_coversWholeDocument: (a: number) => number;
 export const wasmsignature_location: (a: number, b: number) => void;
+export const wasmsignature_padesLevel: (a: number) => number;
 export const wasmsignature_reason: (a: number, b: number) => void;
 export const wasmsignature_signerName: (a: number, b: number) => void;
 export const wasmsignature_signingTime: (a: number, b: number) => void;
@@ -258,6 +289,8 @@ export const wasmtimestamp_serial: (a: number, b: number) => void;
 export const wasmtimestamp_time: (a: number) => bigint;
 export const wasmtimestamp_tsaName: (a: number, b: number) => void;
 export const wasmtimestamp_verify: (a: number, b: number) => void;
+export const wasmdss_crlCount: (a: number) => number;
+export const wasmdss_ocspCount: (a: number) => number;
 export const wasmocrconfig_new: () => number;
 export const wasmpdfdocument_saveToBytes: (a: number, b: number) => void;
 export const wasmfooter_center: (a: number, b: number) => number;
@@ -270,8 +303,8 @@ export const wasmfooter_new: () => number;
 export const wasmheader_new: () => number;
 export const __wbg_wasmocrengine_free: (a: number, b: number) => void;
 export const disableLogging: () => void;
-export const __wbg_wasmfooter_free: (a: number, b: number) => void;
 export const __wbg_wasmheader_free: (a: number, b: number) => void;
+export const __wbg_wasmfooter_free: (a: number, b: number) => void;
 export const lut_inverse_interp16: (a: number, b: number, c: number) => number;
 export const qcms_profile_precache_output_transform: (a: number) => void;
 export const lut_interp_linear16: (a: number, b: number, c: number) => number;

package/nodejs/pdf_oxide.d.ts

@@ -45,6 +45,93 @@ export class ArtifactStyle {
     constructor();
 }
 
+/**
+ * A parsed Document Security Store (`/DSS`, ISO 32000-2 §12.8.4.3).
+ * Count + index accessors mirror `WasmCertificate`'s flat shape
+ * (wasm-bindgen cannot return `Uint8Array[]` directly).
+ */
+export class Dss {
+    private constructor();
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * The `i`-th DER certificate, or `undefined` if out of range.
+     */
+    getCert(i: number): Uint8Array | undefined;
+    /**
+     * The `i`-th DER CRL, or `undefined` if out of range.
+     */
+    getCrl(i: number): Uint8Array | undefined;
+    /**
+     * The `i`-th DER OCSP response, or `undefined` if out of range.
+     */
+    getOcsp(i: number): Uint8Array | undefined;
+    /**
+     * Number of DER X.509 certificates in the DSS.
+     */
+    readonly certCount: number;
+    /**
+     * Number of DER CRLs in the DSS.
+     */
+    readonly crlCount: number;
+    /**
+     * Number of DER OCSP responses in the DSS.
+     */
+    readonly ocspCount: number;
+    /**
+     * Per-signature VRI keys (uppercase-hex SHA-1 of `/Contents`).
+     */
+    readonly vri: string[];
+}
+
+/**
+ * PAdES baseline level. Frozen integer mapping (BB=0, BT=1, BLt=2,
+ * BLta=3) shared with the C ABI and every binding — never renumber.
+ */
+export enum PadesLevel {
+    /**
+     * B-B: signed attrs incl. the ESS signing-certificate-v2.
+     */
+    BB = 0,
+    /**
+     * B-T: B-B + an RFC 3161 signature-time-stamp unsigned attr.
+     */
+    BT = 1,
+    /**
+     * B-LT: B-T + a Document Security Store (DSS/VRI).
+     */
+    BLt = 2,
+    /**
+     * B-LTA: B-LT + a document-scoped `/DocTimeStamp`.
+     */
+    BLta = 3,
+}
+
+/**
+ * Offline B-LT validation material (DER certs / CRLs / OCSP
+ * responses). Build with `new()` then `addCert`/`addCrl`/`addOcsp`.
+ */
+export class RevocationMaterial {
+    free(): void;
+    [Symbol.dispose](): void;
+    /**
+     * Add a DER X.509 certificate.
+     */
+    addCert(der: Uint8Array): void;
+    /**
+     * Add a DER CRL.
+     */
+    addCrl(der: Uint8Array): void;
+    /**
+     * Add a DER OCSP response.
+     */
+    addOcsp(der: Uint8Array): void;
+    /**
+     * Create an empty revocation-material set.
+     */
+    constructor();
+}
+
 /**
  * WASM handle to a streaming-table building session. Created by
  * `FluentPageBuilder.streamingTable()`; rows are pushed via `pushRow`,
@@ -703,6 +790,11 @@ export class WasmPdf {
 export class WasmPdfDocument {
     free(): void;
     [Symbol.dispose](): void;
+    /**
+     * Queue an explicit destructive redaction rectangle on a page
+     * (page user space; `fill` is an optional DeviceRGB `[r,g,b]`).
+     */
+    addRedaction(page: number, x0: number, y0: number, x1: number, y1: number, fill?: Float32Array | null): void;
     /**
      * Apply all redactions in the document.
      */
@@ -711,6 +803,11 @@ export class WasmPdfDocument {
      * Apply redactions on a page (removes redacted content permanently).
      */
     applyPageRedactions(page_index: number): void;
+    /**
+     * Destructively apply all queued redactions (true content removal,
+     * ISO 32000-1:2008 §12.5.6.23). Returns a `RedactionReport` object.
+     */
+    applyRedactionsDestructive(scrub_metadata?: boolean | null): any;
     /**
      * Authenticate with a password to decrypt an encrypted PDF.
      *
@@ -718,6 +815,15 @@ export class WasmPdfDocument {
      * @returns true if authentication succeeded
      */
     authenticate(password: string): boolean;
+    /**
+     * Cheap per-page text-vs-OCR classification → JSON
+     * `DocumentClassification`.
+     */
+    classifyDocument(): string;
+    /**
+     * Cheap per-page classification → JSON `PageClassification`.
+     */
+    classifyPage(page_index: number): string;
     /**
      * Clear all pending erase operations for a page.
      */
@@ -737,6 +843,11 @@ export class WasmPdfDocument {
      * Delete a page by index (0-based).
      */
     deletePage(index: number): void;
+    /**
+     * The document's Document Security Store (`/DSS`) as a `Dss`, or
+     * `undefined` if absent. Mirrors Rust `signatures::read_dss`.
+     */
+    dss(): Dss | undefined;
     /**
      * Deprecated: Use eraseFooter instead.
      */
@@ -832,6 +943,12 @@ export class WasmPdfDocument {
      * @returns Array of path objects
      */
     extractLines(page_index: number, region?: Float32Array | null): any;
+    /**
+     * Rich per-page extraction → JSON `PageExtraction` (per-region
+     * bbox + typed reason). `optionsJson` is `{}`-tolerant
+     * `AutoExtractOptions`; undefined/empty → defaults.
+     */
+    extractPageAuto(page_index: number, options_json?: string | null): string;
     /**
      * Extract complete page text data in a single call.
      *
@@ -888,6 +1005,11 @@ export class WasmPdfDocument {
      * @param region - Optional [x, y, width, height] to filter by
      */
     extractText(page_index: number, region: any): string;
+    /**
+     * One-shot auto text extraction — graceful native fallback (never
+     * the opaque OCR error #513).
+     */
+    extractTextAuto(page_index: number): string;
     /**
      * Extract text lines from a page.
      *
@@ -1051,6 +1173,10 @@ export class WasmPdfDocument {
      * Get the rotation of a page in degrees (0, 90, 180, 270).
      */
     pageRotation(page_index: number): number;
+    /**
+     * Number of redaction regions queued for `page`.
+     */
+    redactionCount(page: number): number;
     /**
      * Identify and remove both headers and footers.
      *
@@ -1104,6 +1230,12 @@ export class WasmPdfDocument {
      * Rotate a page by the given degrees (adds to current rotation).
      */
     rotatePage(page_index: number, degrees: number): void;
+    /**
+     * Standalone document sanitization (#231 T10): strip `/Info`,
+     * catalog XMP `/Metadata`, document JavaScript and embedded files
+     * without geometric redaction. Returns a `RedactionReport` object.
+     */
+    sanitizeDocument(scrub_metadata?: boolean | null, remove_javascript?: boolean | null, remove_embedded_files?: boolean | null): any;
     /**
      * Save all edits and return the resulting PDF as bytes.
      *
@@ -1374,6 +1506,12 @@ export class WasmSignature {
      * `/Location` entry from the signature dictionary, if present.
      */
     readonly location: string | undefined;
+    /**
+     * PAdES baseline level from this signature's CMS attributes alone
+     * (`BB` vs `BT`). `BLt` additionally needs the document `/DSS` —
+     * read it via `WasmPdfDocument.dss()` and re-classify there.
+     */
+    readonly padesLevel: PadesLevel;
     /**
      * `/Reason` entry from the signature dictionary, if present.
      */
@@ -1437,6 +1575,23 @@ export class WasmTimestamp {
     readonly tsaName: string;
 }
 
+/**
+ * A CycloneDX 1.6 Cryptographic Bill of Materials (JSON string) of the
+ * algorithms exercised so far this process (#230 Phase F).
+ */
+export function cryptoCbom(): string;
+
+/**
+ * The cryptographic algorithm tokens exercised so far this process
+ * (governance report), as a JSON string array.
+ */
+export function cryptoInventory(): any;
+
+/**
+ * The active crypto policy as its canonical grammar string.
+ */
+export function cryptoPolicy(): string;
+
 /**
  * Disable all pdf_oxide log output — convenience wrapper for
  * `setLogLevel("off")`.
@@ -1457,6 +1612,50 @@ export function generateBarcodeSvg(barcode_type: number, data: string): string;
  */
 export function generateQrSvg(data: string, error_correction: number, size: number): string;
 
+/**
+ * Whether `pdf_data` carries a document-scoped RFC 3161
+ * `/DocTimeStamp` archival timestamp (PAdES-B-LTA). This is the
+ * document-level reader signal; a `WasmSignature`'s `padesLevel`
+ * getter is signature-scoped and tops out at B-LT by design.
+ */
+export function hasDocumentTimestamp(pdf_data: Uint8Array): boolean;
+
+/**
+ * #519: Air-gapped OCR model manifest — JSON (detector + every
+ * supported language's cache filenames and source URLs).
+ *
+ * WASM provisioning is **host-side**: browser/WASM has no filesystem
+ * or network-to-disk, so a download-to-cache prefetch cannot run
+ * here. This manifest is informational — it lets the JS host learn
+ * which model files/URLs to fetch and bundle (or ship out of band)
+ * before driving OCR. There is intentionally no `prefetchModels` in
+ * the WASM surface (see `prefetchAvailable`, which always returns
+ * `false`).
+ */
+export function modelManifest(): string;
+
+/**
+ * Plan a bookmark split without producing PDFs. Returns a JSON array
+ * of segment objects (`index, startPage…` shape from
+ * `BookmarkSegment`). `level`: 0 = all depths, 1 = top-level.
+ */
+export function planSplitByBookmarks(src_bytes: Uint8Array, title_prefix: string | null | undefined, ignore_case: boolean, level: number, include_front_matter: boolean): any;
+
+/**
+ * #519: Whether this build can download OCR models to a local cache.
+ * Always `false` in WASM — provisioning is host-side (see
+ * `modelManifest`).
+ */
+export function prefetchAvailable(): boolean;
+
+/**
+ * Install the process-wide runtime crypto policy from its grammar
+ * string (`"compat"|"strict"|"fips-strict"[;…]`). Fail-closed:
+ * throws on an unparseable spec (policy NOT installed) or if a
+ * policy is already set. Default (never set) is `compat`.
+ */
+export function setCryptoPolicy(spec: string): void;
+
 /**
  * Set the maximum log level for pdf_oxide messages.
  *
@@ -1483,3 +1682,22 @@ export function setLogLevel(level: string): void;
  * `Certificate.loadPkcs12`).
  */
 export function signPdfBytes(pdf_data: Uint8Array, cert: WasmCertificate, reason?: string | null, location?: string | null): Uint8Array;
+
+/**
+ * Sign raw PDF bytes at a PAdES baseline level and return the signed
+ * PDF as a `Uint8Array`.
+ *
+ * `level` `BLTA` is reserved (→ error). For `BT`/`BLt` pass a
+ * pre-fetched RFC 3161 `timestampToken` (DER): WASM intentionally
+ * omits the online TSA client (same `ureq`-incompat carve-out as
+ * v0.3.38) — without a token the core fail-closes with `Unsupported`.
+ * `revocation` supplies the B-LT DSS material.
+ */
+export function signPdfBytesPades(pdf_data: Uint8Array, cert: WasmCertificate, level: PadesLevel, timestamp_token?: Uint8Array | null, revocation?: RevocationMaterial | null, reason?: string | null, location?: string | null): Uint8Array;
+
+/**
+ * Split at bookmark boundaries. Returns a JSON array of
+ * `[segment, bytes]` pairs (bytes as a number array; source
+ * unmodified).
+ */
+export function splitByBookmarks(src_bytes: Uint8Array, title_prefix: string | null | undefined, ignore_case: boolean, level: number, include_front_matter: boolean): any;