pdf-oxide 0.3.24 → 0.3.28

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

@@ -0,0 +1,249 @@
+/**
+ * EditingManager - Document Editing Manager for redaction and flattening operations
+ *
+ * Provides PDF document editing capabilities:
+ * - Content redaction (add, apply, count redaction areas)
+ * - Metadata scrubbing (remove Info, XMP, JavaScript)
+ * - Form flattening (all pages or single page)
+ * - Annotation flattening (all pages or single page)
+ *
+ * Uses native FFI functions:
+ * - pdf_redaction_add, pdf_redaction_apply, pdf_redaction_scrub_metadata, pdf_redaction_count
+ * - pdf_document_editor_flatten_forms, pdf_document_editor_flatten_forms_page
+ * - pdf_document_editor_flatten_annotations, pdf_document_editor_flatten_annotations_page
+ */
+import { EventEmitter } from 'events';
+/**
+ * Rectangle coordinates for a redaction area.
+ */
+export interface RedactionRect {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+}
+/**
+ * RGB color specification (values 0.0-1.0).
+ */
+export interface RgbColor {
+    r: number;
+    g: number;
+    b: number;
+}
+/**
+ * Options for applying redactions.
+ */
+export interface ApplyRedactionsOptions {
+    /** Whether to also scrub document metadata when applying redactions. */
+    scrubMetadata?: boolean;
+    /** Default fill color for redacted areas. Defaults to black (0, 0, 0). */
+    fillColor?: RgbColor;
+}
+/**
+ * Options for scrubbing document metadata.
+ */
+export interface ScrubMetadataOptions {
+    /** Remove /Info dictionary entries (Title, Author, etc.). Default: true */
+    removeInfo?: boolean;
+    /** Remove XMP metadata stream. Default: true */
+    removeXmp?: boolean;
+    /** Remove JavaScript actions. Default: true */
+    removeJs?: boolean;
+}
+/**
+ * Manages document editing operations including redaction and flattening.
+ *
+ * @example
+ * ```typescript
+ * import { EditingManager } from 'pdf_oxide';
+ *
+ * const editor = new EditingManager(document);
+ *
+ * // Add redaction areas
+ * editor.addRedaction(0, { x1: 100, y1: 200, x2: 300, y2: 250 });
+ * editor.addRedaction(0, { x1: 50, y1: 400, x2: 200, y2: 450 }, { r: 0, g: 0, b: 0 });
+ *
+ * // Apply all queued redactions
+ * const count = editor.applyRedactions({ scrubMetadata: true });
+ * console.log(`Applied ${count} redactions`);
+ *
+ * // Flatten forms and annotations
+ * editor.flattenForms();
+ * editor.flattenAnnotations();
+ * ```
+ */
+export declare class EditingManager extends EventEmitter {
+    private document;
+    private native;
+    constructor(document: any);
+    /**
+     * Adds a redaction area to the document.
+     *
+     * Queues a rectangular region on a page for redaction. The content within
+     * the rectangle will be permanently removed when {@link applyRedactions}
+     * is called.
+     *
+     * @param page - Zero-based page index
+     * @param rect - Rectangle coordinates defining the redaction area
+     * @param color - Optional fill color for the redacted area (defaults to black)
+     * @throws {PdfException} If the document handle is invalid or page is out of range
+     *
+     * @example
+     * ```typescript
+     * // Redact a region with default black fill
+     * editor.addRedaction(0, { x1: 100, y1: 200, x2: 300, y2: 250 });
+     *
+     * // Redact with a custom gray fill
+     * editor.addRedaction(1, { x1: 50, y1: 100, x2: 200, y2: 150 }, { r: 0.5, g: 0.5, b: 0.5 });
+     * ```
+     */
+    addRedaction(page: number, rect: RedactionRect, color?: RgbColor): void;
+    /**
+     * Applies all queued redactions to the document.
+     *
+     * Permanently removes content within all previously added redaction
+     * rectangles. Optionally scrubs document metadata and applies a
+     * fill color overlay.
+     *
+     * @param options - Options controlling redaction behavior
+     * @returns Number of redactions applied
+     * @throws {PdfException} If redaction application fails
+     *
+     * @example
+     * ```typescript
+     * // Apply with metadata scrubbing
+     * const count = editor.applyRedactions({ scrubMetadata: true });
+     *
+     * // Apply with custom fill color
+     * const count = editor.applyRedactions({
+     *   fillColor: { r: 1.0, g: 1.0, b: 1.0 }
+     * });
+     * ```
+     */
+    applyRedactions(options?: ApplyRedactionsOptions): number;
+    /**
+     * Scrubs sensitive metadata from the document.
+     *
+     * Removes document metadata fields that may contain sensitive information,
+     * such as author names, creation tools, and JavaScript.
+     *
+     * @param options - Options controlling which metadata to remove
+     * @throws {PdfException} If metadata scrubbing fails
+     *
+     * @example
+     * ```typescript
+     * // Remove all metadata
+     * editor.scrubMetadata();
+     *
+     * // Remove only Info dictionary and JavaScript
+     * editor.scrubMetadata({ removeInfo: true, removeXmp: false, removeJs: true });
+     * ```
+     */
+    scrubMetadata(options?: ScrubMetadataOptions): void;
+    /**
+     * Gets the number of queued (pending) redaction areas.
+     *
+     * @returns Number of redaction areas queued for application
+     * @throws {PdfException} If the document handle is invalid
+     *
+     * @example
+     * ```typescript
+     * editor.addRedaction(0, { x1: 10, y1: 20, x2: 100, y2: 50 });
+     * editor.addRedaction(1, { x1: 30, y1: 40, x2: 200, y2: 80 });
+     * console.log(editor.getRedactionCount()); // 2
+     * ```
+     */
+    getRedactionCount(): number;
+    /**
+     * Flattens all form fields in the document.
+     *
+     * Renders form field widgets into page content and removes the AcroForm
+     * dictionary. After flattening, form fields become static content and
+     * can no longer be edited interactively.
+     *
+     * @throws {PdfException} If flattening fails
+     *
+     * @example
+     * ```typescript
+     * editor.flattenForms();
+     * ```
+     */
+    flattenForms(): void;
+    /**
+     * Flattens form fields on a specific page.
+     *
+     * Only flattens form field widgets located on the specified page,
+     * leaving form fields on other pages editable.
+     *
+     * @param page - Zero-based page index
+     * @throws {PdfException} If flattening fails or page is out of range
+     *
+     * @example
+     * ```typescript
+     * // Flatten forms on first page only
+     * editor.flattenFormsPage(0);
+     * ```
+     */
+    flattenFormsPage(page: number): void;
+    /**
+     * Flattens all annotations in the document.
+     *
+     * Renders annotations into page content and removes them from
+     * annotation arrays. After flattening, annotations become static
+     * content and can no longer be edited or deleted.
+     *
+     * @throws {PdfException} If flattening fails
+     *
+     * @example
+     * ```typescript
+     * editor.flattenAnnotations();
+     * ```
+     */
+    flattenAnnotations(): void;
+    /**
+     * Flattens annotations on a specific page.
+     *
+     * Only flattens annotations located on the specified page,
+     * leaving annotations on other pages editable.
+     *
+     * @param page - Zero-based page index
+     * @throws {PdfException} If flattening fails or page is out of range
+     *
+     * @example
+     * ```typescript
+     * // Flatten annotations on page 2
+     * editor.flattenAnnotationsPage(1);
+     * ```
+     */
+    flattenAnnotationsPage(page: number): void;
+    /**
+     * Import form data from a file (FDF or XFDF, auto-detected by extension).
+     * @param filePath Path to the FDF or XFDF file
+     * @returns Number of fields imported
+     */
+    importFormDataFromFile(filePath: string): number;
+    /**
+     * Import FDF form data from in-memory bytes.
+     * @param data FDF data bytes
+     * @returns Number of fields imported
+     */
+    importFdfBytes(data: Buffer): number;
+    /**
+     * Import XFDF form data from in-memory bytes.
+     * @param data XFDF data bytes
+     * @returns Number of fields imported
+     */
+    importXfdfBytes(data: Buffer): number;
+    /**
+     * Export form data to in-memory bytes.
+     * @param format 0 for FDF, 1 for XFDF
+     * @returns Exported form data bytes
+     */
+    exportFormDataToBytes(format?: 0 | 1): Buffer;
+    /**
+     * Releases resources held by this manager.
+     */
+    destroy(): void;
+}
+export default EditingManager;
+//# sourceMappingURL=editing-manager.d.ts.map

package/lib/managers/editing-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editing-manager.d.ts","sourceRoot":"","sources":["../../src/managers/editing-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAOtC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,QAAQ,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,gDAAgD;IAChD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,MAAM,CAAM;gBAER,QAAQ,EAAE,GAAG;IAczB;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,aAAa,EACnB,KAAK,CAAC,EAAE,QAAQ,GACf,IAAI;IA4BP;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM;IA8BzD;;;;;;;;;;;;;;;;;OAiBG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,IAAI;IAyBnD;;;;;;;;;;;;OAYG;IACH,iBAAiB,IAAI,MAAM;IAwB3B;;;;;;;;;;;;;OAaG;IACH,YAAY,IAAI,IAAI;IAkBpB;;;;;;;;;;;;;;OAcG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAuBpC;;;;;;;;;;;;;OAaG;IACH,kBAAkB,IAAI,IAAI;IAkB1B;;;;;;;;;;;;;;OAcG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAuB1C;;;;OAIG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAYhD;;;;OAIG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYpC;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYrC;;;;OAIG;IACH,qBAAqB,CAAC,MAAM,GAAE,CAAC,GAAG,CAAK,GAAG,MAAM;IAiBhD;;OAEG;IACH,OAAO,IAAI,IAAI;CAGhB;AAED,eAAe,cAAc,CAAC"}

package/lib/managers/editing-manager.js

@@ -0,0 +1,388 @@
+/**
+ * EditingManager - Document Editing Manager for redaction and flattening operations
+ *
+ * Provides PDF document editing capabilities:
+ * - Content redaction (add, apply, count redaction areas)
+ * - Metadata scrubbing (remove Info, XMP, JavaScript)
+ * - Form flattening (all pages or single page)
+ * - Annotation flattening (all pages or single page)
+ *
+ * Uses native FFI functions:
+ * - pdf_redaction_add, pdf_redaction_apply, pdf_redaction_scrub_metadata, pdf_redaction_count
+ * - pdf_document_editor_flatten_forms, pdf_document_editor_flatten_forms_page
+ * - pdf_document_editor_flatten_annotations, pdf_document_editor_flatten_annotations_page
+ */
+import { EventEmitter } from 'events';
+import { mapFfiErrorCode } from '../errors.js';
+// =============================================================================
+// Canonical EditingManager
+// =============================================================================
+/**
+ * Manages document editing operations including redaction and flattening.
+ *
+ * @example
+ * ```typescript
+ * import { EditingManager } from 'pdf_oxide';
+ *
+ * const editor = new EditingManager(document);
+ *
+ * // Add redaction areas
+ * editor.addRedaction(0, { x1: 100, y1: 200, x2: 300, y2: 250 });
+ * editor.addRedaction(0, { x1: 50, y1: 400, x2: 200, y2: 450 }, { r: 0, g: 0, b: 0 });
+ *
+ * // Apply all queued redactions
+ * const count = editor.applyRedactions({ scrubMetadata: true });
+ * console.log(`Applied ${count} redactions`);
+ *
+ * // Flatten forms and annotations
+ * editor.flattenForms();
+ * editor.flattenAnnotations();
+ * ```
+ */
+export class EditingManager extends EventEmitter {
+    constructor(document) {
+        super();
+        this.document = document;
+        try {
+            this.native = require('../../index.node');
+        }
+        catch {
+            this.native = null;
+        }
+    }
+    // ===========================================================================
+    // Redaction Operations
+    // ===========================================================================
+    /**
+     * Adds a redaction area to the document.
+     *
+     * Queues a rectangular region on a page for redaction. The content within
+     * the rectangle will be permanently removed when {@link applyRedactions}
+     * is called.
+     *
+     * @param page - Zero-based page index
+     * @param rect - Rectangle coordinates defining the redaction area
+     * @param color - Optional fill color for the redacted area (defaults to black)
+     * @throws {PdfException} If the document handle is invalid or page is out of range
+     *
+     * @example
+     * ```typescript
+     * // Redact a region with default black fill
+     * editor.addRedaction(0, { x1: 100, y1: 200, x2: 300, y2: 250 });
+     *
+     * // Redact with a custom gray fill
+     * editor.addRedaction(1, { x1: 50, y1: 100, x2: 200, y2: 150 }, { r: 0.5, g: 0.5, b: 0.5 });
+     * ```
+     */
+    addRedaction(page, rect, color) {
+        const fillColor = color ?? { r: 0, g: 0, b: 0 };
+        if (this.native?.pdf_redaction_add) {
+            const errorCode = { value: 0 };
+            const result = this.native.pdf_redaction_add(this.document?.handle ?? this.document, page, rect.x1, rect.y1, rect.x2, rect.y2, fillColor.r, fillColor.g, fillColor.b, errorCode);
+            if (result < 0 && errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, 'Failed to add redaction area');
+            }
+        }
+        else if (this.document?.addRedaction) {
+            this.document.addRedaction(page, rect, fillColor);
+        }
+        this.emit('redactionAdded', { page, rect, color: fillColor });
+    }
+    /**
+     * Applies all queued redactions to the document.
+     *
+     * Permanently removes content within all previously added redaction
+     * rectangles. Optionally scrubs document metadata and applies a
+     * fill color overlay.
+     *
+     * @param options - Options controlling redaction behavior
+     * @returns Number of redactions applied
+     * @throws {PdfException} If redaction application fails
+     *
+     * @example
+     * ```typescript
+     * // Apply with metadata scrubbing
+     * const count = editor.applyRedactions({ scrubMetadata: true });
+     *
+     * // Apply with custom fill color
+     * const count = editor.applyRedactions({
+     *   fillColor: { r: 1.0, g: 1.0, b: 1.0 }
+     * });
+     * ```
+     */
+    applyRedactions(options) {
+        const scrubMetadata = options?.scrubMetadata ?? false;
+        const fillColor = options?.fillColor ?? { r: 0, g: 0, b: 0 };
+        if (this.native?.pdf_redaction_apply) {
+            const errorCode = { value: 0 };
+            const result = this.native.pdf_redaction_apply(this.document?.handle ?? this.document, scrubMetadata, fillColor.r, fillColor.g, fillColor.b, errorCode);
+            if (result < 0 && errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, 'Failed to apply redactions');
+            }
+            this.emit('redactionsApplied', { count: result, scrubMetadata });
+            return result;
+        }
+        else if (this.document?.applyRedactions) {
+            const count = this.document.applyRedactions(options);
+            this.emit('redactionsApplied', { count, scrubMetadata });
+            return count ?? 0;
+        }
+        return 0;
+    }
+    /**
+     * Scrubs sensitive metadata from the document.
+     *
+     * Removes document metadata fields that may contain sensitive information,
+     * such as author names, creation tools, and JavaScript.
+     *
+     * @param options - Options controlling which metadata to remove
+     * @throws {PdfException} If metadata scrubbing fails
+     *
+     * @example
+     * ```typescript
+     * // Remove all metadata
+     * editor.scrubMetadata();
+     *
+     * // Remove only Info dictionary and JavaScript
+     * editor.scrubMetadata({ removeInfo: true, removeXmp: false, removeJs: true });
+     * ```
+     */
+    scrubMetadata(options) {
+        const removeInfo = options?.removeInfo ?? true;
+        const removeXmp = options?.removeXmp ?? true;
+        const removeJs = options?.removeJs ?? true;
+        if (this.native?.pdf_redaction_scrub_metadata) {
+            const errorCode = { value: 0 };
+            const result = this.native.pdf_redaction_scrub_metadata(this.document?.handle ?? this.document, removeInfo, removeXmp, removeJs, errorCode);
+            if (result < 0 && errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, 'Failed to scrub metadata');
+            }
+        }
+        else if (this.document?.scrubMetadata) {
+            this.document.scrubMetadata(options);
+        }
+        this.emit('metadataScrubbed', { removeInfo, removeXmp, removeJs });
+    }
+    /**
+     * Gets the number of queued (pending) redaction areas.
+     *
+     * @returns Number of redaction areas queued for application
+     * @throws {PdfException} If the document handle is invalid
+     *
+     * @example
+     * ```typescript
+     * editor.addRedaction(0, { x1: 10, y1: 20, x2: 100, y2: 50 });
+     * editor.addRedaction(1, { x1: 30, y1: 40, x2: 200, y2: 80 });
+     * console.log(editor.getRedactionCount()); // 2
+     * ```
+     */
+    getRedactionCount() {
+        if (this.native?.pdf_redaction_count) {
+            const errorCode = { value: 0 };
+            const result = this.native.pdf_redaction_count(this.document?.handle ?? this.document, errorCode);
+            if (result < 0 && errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, 'Failed to get redaction count');
+            }
+            return result;
+        }
+        else if (this.document?.getRedactionCount) {
+            return this.document.getRedactionCount() ?? 0;
+        }
+        return 0;
+    }
+    // ===========================================================================
+    // Form Flattening Operations
+    // ===========================================================================
+    /**
+     * Flattens all form fields in the document.
+     *
+     * Renders form field widgets into page content and removes the AcroForm
+     * dictionary. After flattening, form fields become static content and
+     * can no longer be edited interactively.
+     *
+     * @throws {PdfException} If flattening fails
+     *
+     * @example
+     * ```typescript
+     * editor.flattenForms();
+     * ```
+     */
+    flattenForms() {
+        if (this.native?.pdf_document_editor_flatten_forms) {
+            const errorCode = { value: 0 };
+            const result = this.native.pdf_document_editor_flatten_forms(this.document?.handle ?? this.document, errorCode);
+            if (result < 0 && errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, 'Failed to flatten forms');
+            }
+        }
+        else if (this.document?.flattenForms) {
+            this.document.flattenForms();
+        }
+        this.emit('formsFlattened');
+    }
+    /**
+     * Flattens form fields on a specific page.
+     *
+     * Only flattens form field widgets located on the specified page,
+     * leaving form fields on other pages editable.
+     *
+     * @param page - Zero-based page index
+     * @throws {PdfException} If flattening fails or page is out of range
+     *
+     * @example
+     * ```typescript
+     * // Flatten forms on first page only
+     * editor.flattenFormsPage(0);
+     * ```
+     */
+    flattenFormsPage(page) {
+        if (this.native?.pdf_document_editor_flatten_forms_page) {
+            const errorCode = { value: 0 };
+            const result = this.native.pdf_document_editor_flatten_forms_page(this.document?.handle ?? this.document, page, errorCode);
+            if (result < 0 && errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, `Failed to flatten forms on page ${page}`);
+            }
+        }
+        else if (this.document?.flattenFormsPage) {
+            this.document.flattenFormsPage(page);
+        }
+        this.emit('formsPageFlattened', { page });
+    }
+    // ===========================================================================
+    // Annotation Flattening Operations
+    // ===========================================================================
+    /**
+     * Flattens all annotations in the document.
+     *
+     * Renders annotations into page content and removes them from
+     * annotation arrays. After flattening, annotations become static
+     * content and can no longer be edited or deleted.
+     *
+     * @throws {PdfException} If flattening fails
+     *
+     * @example
+     * ```typescript
+     * editor.flattenAnnotations();
+     * ```
+     */
+    flattenAnnotations() {
+        if (this.native?.pdf_document_editor_flatten_annotations) {
+            const errorCode = { value: 0 };
+            const result = this.native.pdf_document_editor_flatten_annotations(this.document?.handle ?? this.document, errorCode);
+            if (result < 0 && errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, 'Failed to flatten annotations');
+            }
+        }
+        else if (this.document?.flattenAnnotations) {
+            this.document.flattenAnnotations();
+        }
+        this.emit('annotationsFlattened');
+    }
+    /**
+     * Flattens annotations on a specific page.
+     *
+     * Only flattens annotations located on the specified page,
+     * leaving annotations on other pages editable.
+     *
+     * @param page - Zero-based page index
+     * @throws {PdfException} If flattening fails or page is out of range
+     *
+     * @example
+     * ```typescript
+     * // Flatten annotations on page 2
+     * editor.flattenAnnotationsPage(1);
+     * ```
+     */
+    flattenAnnotationsPage(page) {
+        if (this.native?.pdf_document_editor_flatten_annotations_page) {
+            const errorCode = { value: 0 };
+            const result = this.native.pdf_document_editor_flatten_annotations_page(this.document?.handle ?? this.document, page, errorCode);
+            if (result < 0 && errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, `Failed to flatten annotations on page ${page}`);
+            }
+        }
+        else if (this.document?.flattenAnnotationsPage) {
+            this.document.flattenAnnotationsPage(page);
+        }
+        this.emit('annotationsPageFlattened', { page });
+    }
+    // ===========================================================================
+    // Form Data Import/Export
+    // ===========================================================================
+    /**
+     * Import form data from a file (FDF or XFDF, auto-detected by extension).
+     * @param filePath Path to the FDF or XFDF file
+     * @returns Number of fields imported
+     */
+    importFormDataFromFile(filePath) {
+        if (this.native?.pdf_document_import_form_data) {
+            const errorCode = { value: 0 };
+            const count = this.native.pdf_document_import_form_data(this.document?.handle ?? this.document, filePath, errorCode);
+            if (errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, `Failed to import form data from ${filePath}`);
+            }
+            return count;
+        }
+        throw new Error('Form data import not available');
+    }
+    /**
+     * Import FDF form data from in-memory bytes.
+     * @param data FDF data bytes
+     * @returns Number of fields imported
+     */
+    importFdfBytes(data) {
+        if (this.native?.pdf_editor_import_fdf_bytes) {
+            const errorCode = { value: 0 };
+            const count = this.native.pdf_editor_import_fdf_bytes(this.document?.handle ?? this.document, data, data.length, errorCode);
+            if (errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, 'Failed to import FDF bytes');
+            }
+            return count;
+        }
+        throw new Error('FDF byte import not available');
+    }
+    /**
+     * Import XFDF form data from in-memory bytes.
+     * @param data XFDF data bytes
+     * @returns Number of fields imported
+     */
+    importXfdfBytes(data) {
+        if (this.native?.pdf_editor_import_xfdf_bytes) {
+            const errorCode = { value: 0 };
+            const count = this.native.pdf_editor_import_xfdf_bytes(this.document?.handle ?? this.document, data, data.length, errorCode);
+            if (errorCode.value !== 0) {
+                throw mapFfiErrorCode(errorCode.value, 'Failed to import XFDF bytes');
+            }
+            return count;
+        }
+        throw new Error('XFDF byte import not available');
+    }
+    /**
+     * Export form data to in-memory bytes.
+     * @param format 0 for FDF, 1 for XFDF
+     * @returns Exported form data bytes
+     */
+    exportFormDataToBytes(format = 0) {
+        if (this.native?.pdf_document_export_form_data_to_bytes) {
+            const errorCode = { value: 0 };
+            const outLen = { value: 0 };
+            const ptr = this.native.pdf_document_export_form_data_to_bytes(this.document?.handle ?? this.document, format, outLen, errorCode);
+            if (errorCode.value !== 0 || !ptr) {
+                throw mapFfiErrorCode(errorCode.value, 'Failed to export form data');
+            }
+            return Buffer.from(ptr, 0, outLen.value);
+        }
+        throw new Error('Form data export not available');
+    }
+    // ===========================================================================
+    // Lifecycle
+    // ===========================================================================
+    /**
+     * Releases resources held by this manager.
+     */
+    destroy() {
+        this.removeAllListeners();
+    }
+}
+export default EditingManager;
+//# sourceMappingURL=editing-manager.js.map

package/lib/managers/editing-manager.js.map

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