pdf-oxide 0.3.45 → 0.3.46

package/lib/index.d.ts

@@ -26,9 +26,21 @@ export interface RenderOptions {
     /** JPEG quality 1..=100 (default 85). */
     jpegQuality?: number;
 }
+/**
+ * Raw premultiplied RGBA8888 pixel buffer. Layout: row-major, top-left origin,
+ * 4 bytes (R,G,B,A) per pixel, `data.length === width * height * 4`.
+ * Alpha is premultiplied (PDF spec §11 transparency model).
+ */
+export interface RgbaPixmap {
+    data: Buffer;
+    width: number;
+    height: number;
+}
 declare class PdfDocumentImpl {
     private _handle;
     private _closed;
+    /** Promise-cached mutex; single Promise ensures no race on concurrent first calls. */
+    private _muPromise;
     constructor(handle: any);
     static open(path: string): PdfDocumentImpl;
     static openFromBuffer(buffer: Buffer | Uint8Array): PdfDocumentImpl;
@@ -91,6 +103,28 @@ declare class PdfDocumentImpl {
      * @param format      `'png'` (default) or `'jpeg'`
      */
     renderPageFit(pageIndex: number, width: number, height: number, format?: 'png' | 'jpeg'): Uint8Array;
+    /** Lazy-initialises the per-instance Mutex (avoids a hard dep at load time). */
+    private _getMutex;
+    /**
+     * Async variant of {@link renderPageWithOptions} serialised through a
+     * per-instance mutex. Use when calling from `worker_threads` or `Promise.all`.
+     */
+    renderPageWithOptionsAsync(pageIndex: number, options?: RenderOptions): Promise<Uint8Array>;
+    /**
+     * Async variant of {@link renderPageFit} serialised through a per-instance mutex.
+     */
+    renderPageFitAsync(pageIndex: number, width: number, height: number, format?: 'png' | 'jpeg'): Promise<Uint8Array>;
+    /**
+     * Renders a page as raw premultiplied RGBA8888 pixels. No PNG/JPEG encoding
+     * overhead — useful for direct handoff to image-processing libraries.
+     * @param pageIndex Zero-based page index.
+     * @param dpi Resolution in dots per inch (default 150).
+     */
+    renderToPixmap(pageIndex: number, dpi?: number): RgbaPixmap;
+    /**
+     * Async variant of {@link renderToPixmap} serialised through a per-instance mutex.
+     */
+    renderToPixmapAsync(pageIndex: number, dpi?: number): Promise<RgbaPixmap>;
     page(index: number): Page;
     [Symbol.iterator](): Iterator<Page>;
     /**
@@ -151,6 +185,9 @@ declare function generateBarcodeSvg(data: string, format?: number, sizePx?: numb
 declare function generateQrCodeSvg(data: string, errorCorrection?: number, sizePx?: number): string;
 declare const getVersion: any;
 declare const getPdfOxideVersion: any;
+declare const getActiveCryptoProvider: any;
+declare const isFipsCryptoAvailable: any;
+declare const useFipsCryptoProvider: any;
 declare const PdfDocument: any;
 declare const Pdf: any;
 declare const PdfError: typeof PdfException;
@@ -165,4 +202,4 @@ declare const TextSearcher: any;
 export { Timestamp, TimestampHashAlgorithm } from './timestamp.js';
 export { TsaClient, type TsaClientOptions } from './tsa-client.js';
 export type { BatchDocument, BatchOptions, BatchProgress, BatchResult, BatchStatistics, Column, SpanCell, StreamingTableConfig, Table, TableMode, TableSpec, WorkerResult, WorkerTask, };
-export { AccessibilityException, AccessibilityManager, Align, AnnotationBuilder, AnnotationManager, AnnotationProperties, BarcodeErrorCorrection, BarcodeFormat, BarcodeManager, BatchManager, CacheManager, CertificateLoadFailed, Color, ComplianceException, ComplianceIssueType, ComplianceManager, ContentType, ConversionOptions, ConversionOptionsBuilder, createExtractionStream, createMetadataStream, createSearchStream, DigestAlgorithm, DocumentBuilder, DocumentEditor, EditingManager, EmbeddedFont, EncryptionException, EnterpriseManager, ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, generateBarcodeSvg, generateQrCodeSvg, getPdfOxideVersion, getVersion, HybridMLManager, ImageFormat, ImageProperties, InvalidStateException, IoException, IssueSeverity, LayerManager, MetadataBuilder, MetadataManager, MetadataStream, mapFfiErrorCode, OCRDetectionMode, OCRLanguage, OCRManager, OcrException, OcrManager, OptimizationException, OptimizationManager, OutlineManager, Page, PageBuilder, PageComplexity, PageSize, ParseException, Pdf, PdfALevel, PdfBuilder, PdfDocument, PdfError, PdfException, PdfUALevel, PdfXLevel, Point, Rect, RedactionException, RenderingException, RenderingManager, ResultAccessorsManager, SearchException, SearchManager, SearchOptions, SearchOptionsBuilder, SearchResult, SearchResultProperties, SearchStream, SecurityManager, SignatureAlgorithm, SignatureException, SignatureManager, SigningFailed, StreamingTable, TextSearcher, ThumbnailManager, ThumbnailSize, UnknownError, UnsupportedFeatureException, ValidationException, WorkerPool, workerPool, wrapAsyncMethod, wrapError, wrapMethod, XfaFieldType, XfaFormType, XfaManager, };
+export { AccessibilityException, AccessibilityManager, Align, AnnotationBuilder, AnnotationManager, AnnotationProperties, BarcodeErrorCorrection, BarcodeFormat, BarcodeManager, BatchManager, CacheManager, CertificateLoadFailed, Color, ComplianceException, ComplianceIssueType, ComplianceManager, ContentType, ConversionOptions, ConversionOptionsBuilder, createExtractionStream, createMetadataStream, createSearchStream, DigestAlgorithm, DocumentBuilder, DocumentEditor, EditingManager, EmbeddedFont, EncryptionException, EnterpriseManager, ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, generateBarcodeSvg, generateQrCodeSvg, getActiveCryptoProvider, getPdfOxideVersion, getVersion, HybridMLManager, ImageFormat, ImageProperties, InvalidStateException, IoException, IssueSeverity, isFipsCryptoAvailable, LayerManager, MetadataBuilder, MetadataManager, MetadataStream, mapFfiErrorCode, OCRDetectionMode, OCRLanguage, OCRManager, OcrException, OcrManager, OptimizationException, OptimizationManager, OutlineManager, Page, PageBuilder, PageComplexity, PageSize, ParseException, Pdf, PdfALevel, PdfBuilder, PdfDocument, PdfError, PdfException, PdfUALevel, PdfXLevel, Point, Rect, RedactionException, RenderingException, RenderingManager, ResultAccessorsManager, SearchException, SearchManager, SearchOptions, SearchOptionsBuilder, SearchResult, SearchResultProperties, SearchStream, SecurityManager, SignatureAlgorithm, SignatureException, SignatureManager, SigningFailed, StreamingTable, TextSearcher, ThumbnailManager, ThumbnailSize, UnknownError, UnsupportedFeatureException, useFipsCryptoProvider, ValidationException, WorkerPool, workerPool, wrapAsyncMethod, wrapError, wrapMethod, XfaFieldType, XfaFormType, XfaManager, };

package/lib/index.js

@@ -138,6 +138,8 @@ function wrapNativeClass(nativeClass, asyncMethods = []) {
 class PdfDocumentImpl {
     constructor(handle) {
         this._closed = false;
+        /** Promise-cached mutex; single Promise ensures no race on concurrent first calls. */
+        this._muPromise = null;
         if (!handle)
             throw new Error('Failed to open document');
         this._handle = handle;
@@ -341,6 +343,55 @@ class PdfDocumentImpl {
             }
         }
     }
+    /** Lazy-initialises the per-instance Mutex (avoids a hard dep at load time). */
+    _getMutex() {
+        if (!this._muPromise) {
+            this._muPromise = import('async-mutex').then(({ Mutex }) => new Mutex());
+        }
+        return this._muPromise;
+    }
+    /**
+     * Async variant of {@link renderPageWithOptions} serialised through a
+     * per-instance mutex. Use when calling from `worker_threads` or `Promise.all`.
+     */
+    async renderPageWithOptionsAsync(pageIndex, options = {}) {
+        const mu = await this._getMutex();
+        return mu.runExclusive(() => this.renderPageWithOptions(pageIndex, options));
+    }
+    /**
+     * Async variant of {@link renderPageFit} serialised through a per-instance mutex.
+     */
+    async renderPageFitAsync(pageIndex, width, height, format = 'png') {
+        const mu = await this._getMutex();
+        return mu.runExclusive(() => this.renderPageFit(pageIndex, width, height, format));
+    }
+    /**
+     * Renders a page as raw premultiplied RGBA8888 pixels. No PNG/JPEG encoding
+     * overhead — useful for direct handoff to image-processing libraries.
+     * @param pageIndex Zero-based page index.
+     * @param dpi Resolution in dots per inch (default 150).
+     */
+    renderToPixmap(pageIndex, dpi = 150) {
+        this.ensureOpen();
+        if (dpi <= 0)
+            throw new RangeError(`dpi must be > 0, got ${dpi}`);
+        const { imgHandle, width, height } = native.renderPageRaw(this._handle, pageIndex, dpi);
+        try {
+            const buf = native.pdfGetRenderedImageData(imgHandle);
+            return { data: Buffer.from(buf), width, height };
+        }
+        finally {
+            if (native.freeRenderedImage)
+                native.freeRenderedImage(imgHandle);
+        }
+    }
+    /**
+     * Async variant of {@link renderToPixmap} serialised through a per-instance mutex.
+     */
+    async renderToPixmapAsync(pageIndex, dpi = 150) {
+        const mu = await this._getMutex();
+        return mu.runExclusive(() => this.renderToPixmap(pageIndex, dpi));
+    }
     page(index) {
         this.ensureOpen();
         const count = this.pageCount();
@@ -589,6 +640,9 @@ function generateQrCodeSvg(data, errorCorrection = 1, sizePx = 300) {
 // Export as ES module
 const getVersion = native.getVersion;
 const getPdfOxideVersion = native.getPdfOxideVersion;
+const getActiveCryptoProvider = native.getActiveCryptoProvider;
+const isFipsCryptoAvailable = native.isFipsCryptoAvailable;
+const useFipsCryptoProvider = native.useFipsCryptoProvider;
 const PdfDocument = PdfDocumentImpl;
 const Pdf = PdfImpl;
 const PdfError = PdfException;
@@ -614,9 +668,9 @@ DocumentBuilder,
 // Editor mutation API
 DocumentEditor, EditingManager, EmbeddedFont, EncryptionException, EnterpriseManager, 
 // Error utilities
-ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, generateBarcodeSvg, generateQrCodeSvg, getPdfOxideVersion, 
+ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, generateBarcodeSvg, generateQrCodeSvg, getActiveCryptoProvider, getPdfOxideVersion, 
 // Version info
-getVersion, HybridMLManager, ImageFormat, ImageProperties, InvalidStateException, IoException, IssueSeverity, LayerManager, MetadataBuilder, MetadataManager, MetadataStream, mapFfiErrorCode, OCRDetectionMode, OCRLanguage, OCRManager, OcrException, 
+getVersion, HybridMLManager, ImageFormat, ImageProperties, InvalidStateException, IoException, IssueSeverity, isFipsCryptoAvailable, LayerManager, MetadataBuilder, MetadataManager, MetadataStream, mapFfiErrorCode, OCRDetectionMode, OCRLanguage, OCRManager, OcrException, 
 // Managers (Phase 4+, consolidated in Phase 9)
 OcrManager, OptimizationException, OptimizationManager, 
 // Managers (Phase 1-3: Core)
@@ -634,6 +688,6 @@ SearchStream, SecurityManager, SignatureAlgorithm, SignatureException, Signature
 // v0.3.39 — managed streaming-table adapter (#393)
 StreamingTable, 
 // Utilities
-TextSearcher, ThumbnailManager, ThumbnailSize, UnknownError, UnsupportedFeatureException, ValidationException, 
+TextSearcher, ThumbnailManager, ThumbnailSize, UnknownError, UnsupportedFeatureException, useFipsCryptoProvider, ValidationException, 
 // Worker Threads API
 WorkerPool, workerPool, wrapAsyncMethod, wrapError, wrapMethod, XfaFieldType, XfaFormType, XfaManager, };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-oxide",
-  "version": "0.3.45",
+  "version": "0.3.46",
   "type": "module",
   "description": "High-performance PDF parsing and text extraction library — prebuilt native bindings, no build toolchain required",
   "main": "lib/index.js",
@@ -20,7 +20,7 @@
     "check:publint": "publint",
     "check:types": "attw --pack . --ignore-rules=cjs-resolves-to-esm",
     "audit:prod": "npm audit --omit=dev --audit-level=high",
-    "test": "node --test tests/smoke.test.mjs tests/feature-guard.test.mjs tests/api-coverage.test.mjs tests/html-css.test.mjs tests/document-builder.test.mjs tests/document-editor.test.mjs tests/render-options.test.mjs tests/tables.test.mjs"
+    "test": "node --test tests/smoke.test.mjs tests/feature-guard.test.mjs tests/api-coverage.test.mjs tests/html-css.test.mjs tests/document-builder.test.mjs tests/document-editor.test.mjs tests/render-options.test.mjs tests/tables.test.mjs tests/worker-threads-safety.test.mjs"
   },
   "files": [
     "lib/",
@@ -66,6 +66,9 @@
       "import": "./lib/errors.js"
     }
   },
+  "dependencies": {
+    "async-mutex": "^0.5.0"
+  },
   "devDependencies": {
     "@types/node": "^25.6.0",
     "node-addon-api": "^8.7.0",