pdf-oxide 0.3.40 → 0.3.42

package/lib/index.d.ts

@@ -81,6 +81,26 @@ declare class PdfDocumentImpl {
     estimateRenderTime(pageIndex: number, dpi?: number): number;
     page(index: number): Page;
     [Symbol.iterator](): Iterator<Page>;
+    /**
+     * Validate PDF/A conformance at a given level.
+     * @param level - "1a"|"1b"|"2a"|"2b"|"2u"|"3a"|"3b"|"3u" (default "2b")
+     */
+    validatePdfA(level?: '1a' | '1b' | '2a' | '2b' | '2u' | '3a' | '3b' | '3u'): {
+        compliant: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+    /**
+     * Convert document to PDF/A conformance in-place.
+     * @param level - "1b"|"2b"|"2u"|"3b" etc. (default "2b")
+     * @returns true if the document is fully PDF/A-compliant after conversion (false if errors remain, e.g. fonts not embeddable without the rendering feature)
+     */
+    convertToPdfA(level?: '1a' | '1b' | '2a' | '2b' | '2u' | '3a' | '3b' | '3u'): boolean;
+    /**
+     * Return the current document bytes (including any in-place modifications
+     * made by convertToPdfA).
+     */
+    toBuffer(): Buffer;
     close(): void;
     [Symbol.dispose](): void;
 }
@@ -107,6 +127,8 @@ declare class Page {
     search(query: string, caseSensitive?: boolean): any;
     toString(): string;
 }
+declare function generateBarcodeSvg(data: string, format?: number, sizePx?: number): string;
+declare function generateQrCodeSvg(data: string, errorCorrection?: number, sizePx?: number): string;
 declare const getVersion: any;
 declare const getPdfOxideVersion: any;
 declare const PdfDocument: any;
@@ -123,4 +145,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, 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, 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, };

package/lib/index.js

@@ -334,6 +334,57 @@ class PdfDocumentImpl {
             },
         };
     }
+    /**
+     * Validate PDF/A conformance at a given level.
+     * @param level - "1a"|"1b"|"2a"|"2b"|"2u"|"3a"|"3b"|"3u" (default "2b")
+     */
+    validatePdfA(level = '2b') {
+        this.ensureOpen();
+        const levelMap = {
+            '1b': 0,
+            '1a': 1,
+            '2b': 2,
+            '2a': 3,
+            '2u': 4,
+            '3b': 5,
+            '3a': 6,
+            '3u': 7,
+        };
+        const levelInt = levelMap[level];
+        if (levelInt === undefined)
+            throw new RangeError(`Unknown PDF/A level: "${level}"`);
+        return native.validatePdfALevel(this._handle, levelInt);
+    }
+    /**
+     * Convert document to PDF/A conformance in-place.
+     * @param level - "1b"|"2b"|"2u"|"3b" etc. (default "2b")
+     * @returns true if the document is fully PDF/A-compliant after conversion (false if errors remain, e.g. fonts not embeddable without the rendering feature)
+     */
+    convertToPdfA(level = '2b') {
+        this.ensureOpen();
+        const levelMap = {
+            '1b': 0,
+            '1a': 1,
+            '2b': 2,
+            '2a': 3,
+            '2u': 4,
+            '3b': 5,
+            '3a': 6,
+            '3u': 7,
+        };
+        const levelInt = levelMap[level];
+        if (levelInt === undefined)
+            throw new RangeError(`Unknown PDF/A level: "${level}"`);
+        return native.convertToPdfA(this._handle, levelInt);
+    }
+    /**
+     * Return the current document bytes (including any in-place modifications
+     * made by convertToPdfA).
+     */
+    toBuffer() {
+        this.ensureOpen();
+        return native.documentGetSourceBytes(this._handle);
+    }
     close() {
         if (!this._closed && this._handle) {
             native.closeDocument(this._handle);
@@ -465,6 +516,28 @@ class PdfImpl {
         this.close();
     }
 }
+// Generate a 1D barcode as a vector SVG string.
+// format: 0=Code128, 1=Code39, 2=EAN13, 3=EAN8, 4=UPCA, 5=ITF, 6=Code93, 7=Codabar.
+function generateBarcodeSvg(data, format = 0, sizePx = 300) {
+    const handle = native.generateBarcode(format, data);
+    try {
+        return native.barcodeGetSVG(handle, sizePx);
+    }
+    finally {
+        native.freeBarcode(handle);
+    }
+}
+// Generate a QR code as a vector SVG string.
+// errorCorrection: 0=Low, 1=Medium, 2=Quartile, 3=High.
+function generateQrCodeSvg(data, errorCorrection = 1, sizePx = 300) {
+    const handle = native.generateQRCode(data, errorCorrection);
+    try {
+        return native.barcodeGetSVG(handle, sizePx);
+    }
+    finally {
+        native.freeBarcode(handle);
+    }
+}
 // Export as ES module
 const getVersion = native.getVersion;
 const getPdfOxideVersion = native.getPdfOxideVersion;
@@ -493,7 +566,7 @@ DocumentBuilder,
 // Editor mutation API
 DocumentEditor, EditingManager, EmbeddedFont, EncryptionException, EnterpriseManager, 
 // Error utilities
-ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, getPdfOxideVersion, 
+ErrorCategory, ErrorSeverity, ExtractionManager, ExtractionStream, FieldVisibility, FontProperties, FormFieldManager, FormFieldType, generateBarcodeSvg, generateQrCodeSvg, getPdfOxideVersion, 
 // Version info
 getVersion, HybridMLManager, ImageFormat, ImageProperties, InvalidStateException, IoException, IssueSeverity, LayerManager, MetadataBuilder, MetadataManager, MetadataStream, mapFfiErrorCode, OCRDetectionMode, OCRLanguage, OCRManager, OcrException, 
 // Managers (Phase 4+, consolidated in Phase 9)

package/lib/managers/barcode-manager.d.ts

@@ -49,6 +49,7 @@ export interface BarcodeGenerationConfig {
     format?: BarcodeFormat;
     width?: number;
     height?: number;
+    sizePx?: number;
     errorCorrection?: BarcodeErrorCorrection;
     margin?: number;
 }
@@ -68,6 +69,8 @@ export declare class BarcodeManager extends EventEmitter {
     generateQrCode(data: string, errorCorrection?: QrErrorCorrection, sizePx?: number): Promise<Buffer>;
     barcodeToPng(barcodeData: Buffer, sizePx?: number): Promise<Buffer>;
     barcodeToSvg(barcodeData: Buffer, sizePx?: number): Promise<string>;
+    generateSvg(data: string, config?: BarcodeGenerationConfig): Promise<string>;
+    generateQrSvg(data: string, errorCorrection?: QrErrorCorrection, sizePx?: number): Promise<string>;
     addBarcodeToPage(pageIndex: number, barcodeData: Buffer, x: number, y: number, width: number, height: number): Promise<boolean>;
     detectBarcodeFormat(barcodeData: Buffer): BarcodeFormat;
     decodeBarcodeData(barcodeData: Buffer): string;

package/lib/managers/barcode-manager.js

@@ -187,9 +187,36 @@ export class BarcodeManager extends EventEmitter {
         return barcodeData;
     }
     async barcodeToSvg(barcodeData, sizePx = 256) {
+        // Legacy: wraps existing PNG bytes in an SVG <image> element.
+        // For real vector SVG use generateBarcodeSvg() / generateQrCodeSvg() from the top-level API.
         const encoded = barcodeData.toString('base64');
         return `<svg xmlns="http://www.w3.org/2000/svg"><image href="data:image/png;base64,${encoded}"/></svg>`;
     }
+    async generateSvg(data, config) {
+        const format = config?.format ?? BarcodeFormat.CODE128;
+        if (this.native?.generateBarcode && this.native?.barcodeGetSVG && this.native?.freeBarcode) {
+            const handle = this.native.generateBarcode(format, data);
+            try {
+                return this.native.barcodeGetSVG(handle, config?.sizePx ?? 300);
+            }
+            finally {
+                this.native.freeBarcode(handle);
+            }
+        }
+        return '';
+    }
+    async generateQrSvg(data, errorCorrection = QrErrorCorrection.M, sizePx = 300) {
+        if (this.native?.generateQRCode && this.native?.barcodeGetSVG && this.native?.freeBarcode) {
+            const handle = this.native.generateQRCode(data, errorCorrection);
+            try {
+                return this.native.barcodeGetSVG(handle, sizePx);
+            }
+            finally {
+                this.native.freeBarcode(handle);
+            }
+        }
+        return '';
+    }
     async addBarcodeToPage(pageIndex, barcodeData, x, y, width, height) {
         try {
             if (!this.document)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pdf-oxide",
-  "version": "0.3.40",
+  "version": "0.3.42",
   "type": "module",
   "description": "High-performance PDF parsing and text extraction library — prebuilt native bindings, no build toolchain required",
   "main": "lib/index.js",