@embedpdf/engines 1.0.19 → 1.0.21

package/dist/{engine-DMU8HkGx.js → engine-D0zKoYug.js}

@@ -1,4 +1,4 @@
-import { NoopLogger, PdfTaskHelper, PdfErrorCode, Task, ignore, isUuidV4, uuidV4, PdfAnnotationSubtype, Rotation, PdfPageFlattenFlag, stripPdfUnwantedMarkers, PdfAnnotationIcon, PdfAnnotationBorderStyle, PdfAnnotationColorType, PdfAnnotationLineEnding, pdfColorToWebColor, webColorToPdfColor, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, pdfDateToDate, dateToPdfDate, quadToRect, rectToQuad, PdfStandardFont, PdfPageObjectType, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, AppearanceMode, toIntRect, transformRect, makeMatrix, toIntSize, transformSize, PdfActionType, PdfZoomMode, MatchFlag } from "@embedpdf/models";
+import { NoopLogger, PdfTaskHelper, PdfErrorCode, pdfDateToDate, Task, ignore, isUuidV4, uuidV4, PdfAnnotationSubtype, Rotation, PdfPageFlattenFlag, stripPdfUnwantedMarkers, PdfAnnotationIcon, PdfAnnotationBorderStyle, PdfAnnotationColorType, PdfAnnotationLineEnding, pdfColorToWebColor, webColorToPdfColor, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, dateToPdfDate, quadToRect, rectToQuad, PdfStandardFont, PdfPageObjectType, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, AppearanceMode, toIntRect, transformRect, makeMatrix, toIntSize, transformSize, PdfActionType, PdfZoomMode, MatchFlag } from "@embedpdf/models";
 function readString(wasmModule, readChars, parseChars, defaultLength = 100) {
   let buffer = wasmModule.wasmExports.malloc(defaultLength);
   for (let i = 0; i < defaultLength; i++) {
@@ -367,6 +367,7 @@ class PdfiumEngine {
     const arrayBuf = await response.arrayBuffer();
     const pdfFile = {
       id: file.id,
+      name: file.name,
       content: arrayBuf
     };
     return this.openDocumentBuffer(pdfFile, { password });
@@ -483,6 +484,7 @@ class PdfiumEngine {
     this.free(sizePtr);
     const pdfDoc = {
       id: file.id,
+      name: file.name,
       pageCount,
       pages
     };
@@ -564,6 +566,7 @@ class PdfiumEngine {
     this.free(sizePtr);
     const pdfDoc = {
       id: file.id,
+      name: file.name,
       pageCount,
       pages
     };
@@ -587,6 +590,8 @@ class PdfiumEngine {
         message: "document does not open"
       });
     }
+    const creationRaw = this.readMetaText(ctx.docPtr, "CreationDate");
+    const modRaw = this.readMetaText(ctx.docPtr, "ModDate");
     const metadata = {
       title: this.readMetaText(ctx.docPtr, "Title"),
       author: this.readMetaText(ctx.docPtr, "Author"),
@@ -594,12 +599,62 @@ class PdfiumEngine {
       keywords: this.readMetaText(ctx.docPtr, "Keywords"),
       producer: this.readMetaText(ctx.docPtr, "Producer"),
       creator: this.readMetaText(ctx.docPtr, "Creator"),
-      creationDate: this.readMetaText(ctx.docPtr, "CreationDate"),
-      modificationDate: this.readMetaText(ctx.docPtr, "ModDate")
+      creationDate: creationRaw ? pdfDateToDate(creationRaw) ?? null : null,
+      modificationDate: modRaw ? pdfDateToDate(modRaw) ?? null : null
     };
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `GetMetadata`, "End", doc.id);
     return PdfTaskHelper.resolve(metadata);
   }
+  /**
+   * {@inheritDoc @embedpdf/models!PdfEngine.setMetadata}
+   *
+   * @public
+   */
+  setMetadata(doc, meta) {
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "setMetadata", doc, meta);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "SetMetadata", "Begin", doc.id);
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "SetMetadata", "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "document does not open"
+      });
+    }
+    const strMap = [
+      ["title", "Title"],
+      ["author", "Author"],
+      ["subject", "Subject"],
+      ["keywords", "Keywords"],
+      ["producer", "Producer"],
+      ["creator", "Creator"]
+    ];
+    let ok = true;
+    for (const [field, key] of strMap) {
+      const v = meta[field];
+      if (v === void 0) continue;
+      const s = v === null ? null : v;
+      if (!this.setMetaText(ctx.docPtr, key, s)) ok = false;
+    }
+    const writeDate = (field, key) => {
+      const v = meta[field];
+      if (v === void 0) return;
+      if (v === null) {
+        if (!this.setMetaText(ctx.docPtr, key, null)) ok = false;
+        return;
+      }
+      const d = v;
+      const raw = dateToPdfDate(d);
+      if (!this.setMetaText(ctx.docPtr, key, raw)) ok = false;
+    };
+    writeDate("creationDate", "CreationDate");
+    writeDate("modificationDate", "ModDate");
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, "SetMetadata", "End", doc.id);
+    return ok ? PdfTaskHelper.resolve(true) : PdfTaskHelper.reject({
+      code: PdfErrorCode.Unknown,
+      message: "one or more metadata fields could not be written"
+    });
+  }
   /**
    * {@inheritDoc @embedpdf/models!PdfEngine.getDocPermissions}
    *
@@ -1336,7 +1391,7 @@ class PdfiumEngine {
       });
     }
     const attachmentPtr = this.pdfiumModule.FPDFDoc_GetAttachment(ctx.docPtr, attachment.index);
-    const sizePtr = this.malloc(8);
+    const sizePtr = this.malloc(4);
     if (!this.pdfiumModule.FPDFAttachment_GetFile(attachmentPtr, 0, 0, sizePtr)) {
       this.free(sizePtr);
       this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `ReadAttachmentContent`, "End", doc.id);
@@ -1345,7 +1400,7 @@ class PdfiumEngine {
         message: "can not read attachment size"
       });
     }
-    const size = this.pdfiumModule.pdfium.getValue(sizePtr, "i64");
+    const size = this.pdfiumModule.pdfium.getValue(sizePtr, "i32") >>> 0;
     const contentPtr = this.malloc(size);
     if (!this.pdfiumModule.FPDFAttachment_GetFile(attachmentPtr, contentPtr, size, sizePtr)) {
       this.free(sizePtr);
@@ -1960,6 +2015,9 @@ class PdfiumEngine {
     if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
       return false;
     }
+    if (annotation.flags && !this.setAnnotationFlags(annotationPtr, annotation.flags)) {
+      return false;
+    }
     if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
       return false;
     }
@@ -2022,6 +2080,9 @@ class PdfiumEngine {
     if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
       return false;
     }
+    if (annotation.flags && !this.setAnnotationFlags(annotationPtr, annotation.flags)) {
+      return false;
+    }
     if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
       return false;
     }
@@ -2067,6 +2128,9 @@ class PdfiumEngine {
     if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
       return false;
     }
+    if (annotation.flags && !this.setAnnotationFlags(annotationPtr, annotation.flags)) {
+      return false;
+    }
     if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
       return false;
     }
@@ -2144,6 +2208,9 @@ class PdfiumEngine {
     if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
       return false;
     }
+    if (annotation.flags && !this.setAnnotationFlags(annotationPtr, annotation.flags)) {
+      return false;
+    }
     if (!this.setPageAnnoRect(page, pagePtr, annotationPtr, annotation.rect)) {
       return false;
     }
@@ -2266,6 +2333,9 @@ class PdfiumEngine {
     if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
       return false;
     }
+    if (annotation.flags && !this.setAnnotationFlags(annotationPtr, annotation.flags)) {
+      return false;
+    }
     if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
       return false;
     }
@@ -2309,6 +2379,9 @@ class PdfiumEngine {
     if (annotation.created && !this.setAnnotationDate(annotationPtr, "CreationDate", annotation.created)) {
       return false;
     }
+    if (annotation.flags && !this.setAnnotationFlags(annotationPtr, annotation.flags)) {
+      return false;
+    }
     if (annotation.modified && !this.setAnnotationDate(annotationPtr, "M", annotation.modified)) {
       return false;
     }
@@ -2445,14 +2518,42 @@ class PdfiumEngine {
    * @private
    */
   readMetaText(docPtr, key) {
+    const exists = !!this.pdfiumModule.EPDF_HasMetaText(docPtr, key);
+    if (!exists) return null;
+    const len = this.pdfiumModule.FPDF_GetMetaText(docPtr, key, 0, 0);
+    if (len === 2) return "";
     return readString(
       this.pdfiumModule.pdfium,
-      (buffer, bufferLength) => {
-        return this.pdfiumModule.FPDF_GetMetaText(docPtr, key, buffer, bufferLength);
-      },
-      this.pdfiumModule.pdfium.UTF16ToString
+      (buffer, bufferLength) => this.pdfiumModule.FPDF_GetMetaText(docPtr, key, buffer, bufferLength),
+      this.pdfiumModule.pdfium.UTF16ToString,
+      len
     );
   }
+  /**
+   * Write metadata into the PDF's Info dictionary.
+   * If `value` is null or empty string, the key is removed.
+   * @param docPtr - pointer to pdf document
+   * @param key - key of metadata field
+   * @param value - value of metadata field
+   * @returns whether metadata is written to the pdf document
+   *
+   * @private
+   */
+  setMetaText(docPtr, key, value) {
+    if (value == null || value.length === 0) {
+      const ok = this.pdfiumModule.EPDF_SetMetaText(docPtr, key, 0);
+      return !!ok;
+    }
+    const bytes = 2 * (value.length + 1);
+    const ptr = this.malloc(bytes);
+    try {
+      this.pdfiumModule.pdfium.stringToUTF16(value, ptr, bytes);
+      const ok = this.pdfiumModule.EPDF_SetMetaText(docPtr, key, ptr);
+      return !!ok;
+    } finally {
+      this.free(ptr);
+    }
+  }
   /**
    * Read bookmarks in the pdf document
    * @param docPtr - pointer to pdf document
@@ -5915,6 +6016,240 @@ class PdfiumEngine {
       return pageResults;
     });
   }
+  /**
+   * {@inheritDoc @embedpdf/models!PdfEngine.preparePrintDocument}
+   *
+   * Prepares a PDF document for printing with specified options.
+   * Creates a new document with selected pages and optionally removes annotations
+   * for optimal printing performance.
+   *
+   * @public
+   */
+  preparePrintDocument(doc, options) {
+    const { includeAnnotations = true, pageRange = null } = options ?? {};
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "preparePrintDocument", doc, options);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `PreparePrintDocument`, "Begin", doc.id);
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `PreparePrintDocument`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "Document is not open"
+      });
+    }
+    const printDocPtr = this.pdfiumModule.FPDF_CreateNewDocument();
+    if (!printDocPtr) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `PreparePrintDocument`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.CantCreateNewDoc,
+        message: "Cannot create print document"
+      });
+    }
+    try {
+      const sanitizedPageRange = this.sanitizePageRange(pageRange, doc.pageCount);
+      if (!this.pdfiumModule.FPDF_ImportPages(
+        printDocPtr,
+        ctx.docPtr,
+        sanitizedPageRange ?? "",
+        0
+        // Insert at beginning
+      )) {
+        this.pdfiumModule.FPDF_CloseDocument(printDocPtr);
+        this.logger.error(LOG_SOURCE, LOG_CATEGORY, "Failed to import pages for printing");
+        this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `PreparePrintDocument`, "End", doc.id);
+        return PdfTaskHelper.reject({
+          code: PdfErrorCode.CantImportPages,
+          message: "Failed to import pages for printing"
+        });
+      }
+      if (!includeAnnotations) {
+        const removalResult = this.removeAnnotationsFromPrintDocument(printDocPtr);
+        if (!removalResult.success) {
+          this.pdfiumModule.FPDF_CloseDocument(printDocPtr);
+          this.logger.error(
+            LOG_SOURCE,
+            LOG_CATEGORY,
+            `Failed to remove annotations: ${removalResult.error}`
+          );
+          this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `PreparePrintDocument`, "End", doc.id);
+          return PdfTaskHelper.reject({
+            code: PdfErrorCode.Unknown,
+            message: `Failed to prepare print document: ${removalResult.error}`
+          });
+        }
+        this.logger.debug(
+          LOG_SOURCE,
+          LOG_CATEGORY,
+          `Removed ${removalResult.annotationsRemoved} annotations from ${removalResult.pagesProcessed} pages`
+        );
+      }
+      const buffer = this.saveDocument(printDocPtr);
+      this.pdfiumModule.FPDF_CloseDocument(printDocPtr);
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `PreparePrintDocument`, "End", doc.id);
+      return PdfTaskHelper.resolve(buffer);
+    } catch (error) {
+      if (printDocPtr) {
+        this.pdfiumModule.FPDF_CloseDocument(printDocPtr);
+      }
+      this.logger.error(LOG_SOURCE, LOG_CATEGORY, "preparePrintDocument failed", error);
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `PreparePrintDocument`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.Unknown,
+        message: error instanceof Error ? error.message : "Failed to prepare print document"
+      });
+    }
+  }
+  /**
+   * Removes all annotations from a print document using fast raw annotation functions.
+   * This method is optimized for performance by avoiding full page loading.
+   *
+   * @param printDocPtr - Pointer to the print document
+   * @returns Result object with success status and statistics
+   *
+   * @private
+   */
+  removeAnnotationsFromPrintDocument(printDocPtr) {
+    let totalAnnotationsRemoved = 0;
+    let pagesProcessed = 0;
+    try {
+      const pageCount = this.pdfiumModule.FPDF_GetPageCount(printDocPtr);
+      for (let pageIndex = 0; pageIndex < pageCount; pageIndex++) {
+        const annotCount = this.pdfiumModule.EPDFPage_GetAnnotCountRaw(printDocPtr, pageIndex);
+        if (annotCount <= 0) {
+          pagesProcessed++;
+          continue;
+        }
+        let annotationsRemovedFromPage = 0;
+        for (let annotIndex = annotCount - 1; annotIndex >= 0; annotIndex--) {
+          const removed = this.pdfiumModule.EPDFPage_RemoveAnnotRaw(
+            printDocPtr,
+            pageIndex,
+            annotIndex
+          );
+          if (removed) {
+            annotationsRemovedFromPage++;
+            totalAnnotationsRemoved++;
+          } else {
+            this.logger.warn(
+              LOG_SOURCE,
+              LOG_CATEGORY,
+              `Failed to remove annotation ${annotIndex} from page ${pageIndex}`
+            );
+          }
+        }
+        if (annotationsRemovedFromPage > 0) {
+          const pagePtr = this.pdfiumModule.FPDF_LoadPage(printDocPtr, pageIndex);
+          if (pagePtr) {
+            this.pdfiumModule.FPDFPage_GenerateContent(pagePtr);
+            this.pdfiumModule.FPDF_ClosePage(pagePtr);
+          }
+        }
+        pagesProcessed++;
+      }
+      return {
+        success: true,
+        annotationsRemoved: totalAnnotationsRemoved,
+        pagesProcessed
+      };
+    } catch (error) {
+      return {
+        success: false,
+        annotationsRemoved: totalAnnotationsRemoved,
+        pagesProcessed,
+        error: error instanceof Error ? error.message : "Unknown error during annotation removal"
+      };
+    }
+  }
+  /**
+   * Sanitizes and validates a page range string.
+   * Ensures page numbers are within valid bounds and properly formatted.
+   *
+   * @param pageRange - Page range string (e.g., "1,3,5-7") or null for all pages
+   * @param totalPages - Total number of pages in the document
+   * @returns Sanitized page range string or null for all pages
+   *
+   * @private
+   */
+  sanitizePageRange(pageRange, totalPages) {
+    if (!pageRange || pageRange.trim() === "") {
+      return null;
+    }
+    try {
+      const sanitized = [];
+      const parts = pageRange.split(",");
+      for (const part of parts) {
+        const trimmed = part.trim();
+        if (trimmed.includes("-")) {
+          const [startStr, endStr] = trimmed.split("-").map((s) => s.trim());
+          const start = parseInt(startStr, 10);
+          const end = parseInt(endStr, 10);
+          if (isNaN(start) || isNaN(end)) {
+            this.logger.warn(LOG_SOURCE, LOG_CATEGORY, `Invalid range: ${trimmed}`);
+            continue;
+          }
+          const validStart = Math.max(1, Math.min(start, totalPages));
+          const validEnd = Math.max(1, Math.min(end, totalPages));
+          for (let i = validStart; i <= validEnd; i++) {
+            if (!sanitized.includes(i)) {
+              sanitized.push(i);
+            }
+          }
+        } else {
+          const pageNum = parseInt(trimmed, 10);
+          if (isNaN(pageNum)) {
+            this.logger.warn(LOG_SOURCE, LOG_CATEGORY, `Invalid page number: ${trimmed}`);
+            continue;
+          }
+          const validPageNum = Math.max(1, Math.min(pageNum, totalPages));
+          if (!sanitized.includes(validPageNum)) {
+            sanitized.push(validPageNum);
+          }
+        }
+      }
+      if (sanitized.length === 0) {
+        this.logger.warn(LOG_SOURCE, LOG_CATEGORY, "No valid pages in range, using all pages");
+        return null;
+      }
+      sanitized.sort((a, b) => a - b);
+      const optimized = [];
+      let rangeStart = sanitized[0];
+      let rangeEnd = sanitized[0];
+      for (let i = 1; i < sanitized.length; i++) {
+        if (sanitized[i] === rangeEnd + 1) {
+          rangeEnd = sanitized[i];
+        } else {
+          if (rangeStart === rangeEnd) {
+            optimized.push(rangeStart.toString());
+          } else if (rangeEnd - rangeStart === 1) {
+            optimized.push(rangeStart.toString());
+            optimized.push(rangeEnd.toString());
+          } else {
+            optimized.push(`${rangeStart}-${rangeEnd}`);
+          }
+          rangeStart = sanitized[i];
+          rangeEnd = sanitized[i];
+        }
+      }
+      if (rangeStart === rangeEnd) {
+        optimized.push(rangeStart.toString());
+      } else if (rangeEnd - rangeStart === 1) {
+        optimized.push(rangeStart.toString());
+        optimized.push(rangeEnd.toString());
+      } else {
+        optimized.push(`${rangeStart}-${rangeEnd}`);
+      }
+      const result = optimized.join(",");
+      this.logger.debug(
+        LOG_SOURCE,
+        LOG_CATEGORY,
+        `Sanitized page range: "${pageRange}" -> "${result}"`
+      );
+      return result;
+    } catch (error) {
+      this.logger.error(LOG_SOURCE, LOG_CATEGORY, `Error sanitizing page range: ${error}`);
+      return null;
+    }
+  }
 }
 export {
   BitmapFormat as B,
@@ -5925,4 +6260,4 @@ export {
   readArrayBuffer as c,
   readString as r
 };
-//# sourceMappingURL=engine-DMU8HkGx.js.map
+//# sourceMappingURL=engine-D0zKoYug.js.map