@embedpdf/engines 1.2.1 → 1.3.1

package/dist/{engine-4h8XG4y4.js → engine-BVe88qdX.js}

@@ -1,4 +1,4 @@
-import { NoopLogger, PdfTaskHelper, PdfErrorCode, pdfDateToDate, ignore, isUuidV4, uuidV4, PdfAnnotationSubtype, PdfPageFlattenFlag, stripPdfUnwantedMarkers, PdfAnnotationIcon, PdfAnnotationBorderStyle, PdfAnnotationColorType, PdfAnnotationLineEnding, PdfStampFit, PdfTrappedStatus, pdfColorToWebColor, webColorToPdfColor, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, dateToPdfDate, quadToRect, rectToQuad, PdfStandardFont, PdfPageObjectType, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, Rotation, AppearanceMode, Task, toIntRect, transformRect, buildUserToDeviceMatrix, PdfActionType, PdfZoomMode, MatchFlag } from "@embedpdf/models";
+import { NoopLogger, PdfTaskHelper, PdfErrorCode, pdfDateToDate, ignore, isUuidV4, uuidV4, PdfAnnotationSubtype, PdfPageFlattenFlag, stripPdfUnwantedMarkers, PdfAnnotationIcon, PdfAnnotationBorderStyle, PdfAnnotationColorType, PdfAnnotationLineEnding, PdfStampFit, PdfTrappedStatus, pdfColorToWebColor, webColorToPdfColor, pdfAlphaToWebOpacity, webOpacityToPdfAlpha, dateToPdfDate, quadToRect, rectToQuad, PdfStandardFont, PdfPageObjectType, flagsToNames, namesToFlags, PDF_FORM_FIELD_TYPE, Rotation, AppearanceMode, Task, toIntRect, transformRect, buildUserToDeviceMatrix, PdfZoomMode, PdfActionType, MatchFlag } from "@embedpdf/models";
 function readString(wasmModule, readChars, parseChars, defaultLength = 100) {
   let buffer = wasmModule.wasmExports.malloc(defaultLength);
   for (let i = 0; i < defaultLength; i++) {
@@ -514,6 +514,33 @@ class PdfiumEngine {
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `Destroy`, "End", "General");
     return PdfTaskHelper.resolve(true);
   }
+  /** Write a UTF-16LE (WIDESTRING) to wasm, call `fn(ptr)`, then free. */
+  withWString(value, fn) {
+    const length = (value.length + 1) * 2;
+    const ptr = this.memoryManager.malloc(length);
+    try {
+      this.pdfiumModule.pdfium.stringToUTF16(value, ptr, length);
+      return fn(ptr);
+    } finally {
+      this.memoryManager.free(ptr);
+    }
+  }
+  /** Write a float[] to wasm, call `fn(ptr, count)`, then free. */
+  withFloatArray(values, fn) {
+    const arr = values ?? [];
+    const bytes = arr.length * 4;
+    const ptr = bytes ? this.memoryManager.malloc(bytes) : WasmPointer(0);
+    try {
+      if (bytes) {
+        for (let i = 0; i < arr.length; i++) {
+          this.pdfiumModule.pdfium.setValue(ptr + i * 4, arr[i], "float");
+        }
+      }
+      return fn(ptr, arr.length);
+    } finally {
+      if (bytes) this.memoryManager.free(ptr);
+    }
+  }
   /**
    * {@inheritDoc @embedpdf/models!PdfEngine.openDocumentUrl}
    *
@@ -1014,6 +1041,85 @@ class PdfiumEngine {
       bookmarks
     });
   }
+  /**
+   * {@inheritDoc @embedpdf/models!PdfEngine.setBookmarks}
+   *
+   * @public
+   */
+  setBookmarks(doc, list) {
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "setBookmarks", doc, list);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `SetBookmarks`, "Begin", doc.id);
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `SetBookmarks`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "document does not open"
+      });
+    }
+    if (!this.pdfiumModule.EPDFBookmark_Clear(ctx.docPtr)) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `SetBookmarks`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.Unknown,
+        message: "failed to clear existing bookmarks"
+      });
+    }
+    const build = (parentPtr, items) => {
+      var _a;
+      for (const item of items) {
+        const bmPtr = this.withWString(
+          item.title ?? "",
+          (wptr) => this.pdfiumModule.EPDFBookmark_AppendChild(ctx.docPtr, parentPtr, wptr)
+        );
+        if (!bmPtr) return false;
+        if (item.target) {
+          const ok2 = this.applyBookmarkTarget(ctx.docPtr, bmPtr, item.target);
+          if (!ok2) return false;
+        }
+        if ((_a = item.children) == null ? void 0 : _a.length) {
+          const ok2 = build(bmPtr, item.children);
+          if (!ok2) return false;
+        }
+      }
+      return true;
+    };
+    const ok = build(
+      /*top-level*/
+      0,
+      list
+    );
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `SetBookmarks`, "End", doc.id);
+    if (!ok) {
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.Unknown,
+        message: "failed to build bookmark tree"
+      });
+    }
+    return PdfTaskHelper.resolve(true);
+  }
+  /**
+   * {@inheritDoc @embedpdf/models!PdfEngine.deleteBookmarks}
+   *
+   * @public
+   */
+  deleteBookmarks(doc) {
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "deleteBookmarks", doc);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `DeleteBookmarks`, "Begin", doc.id);
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `DeleteBookmarks`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "document does not open"
+      });
+    }
+    const ok = this.pdfiumModule.EPDFBookmark_Clear(ctx.docPtr);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `DeleteBookmarks`, "End", doc.id);
+    return ok ? PdfTaskHelper.resolve(true) : PdfTaskHelper.reject({
+      code: PdfErrorCode.Unknown,
+      message: "failed to clear bookmarks"
+    });
+  }
   /**
    * {@inheritDoc @embedpdf/models!PdfEngine.renderPage}
    *
@@ -1576,6 +1682,111 @@ class PdfiumEngine {
     this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `GetAttachments`, "End", doc.id);
     return PdfTaskHelper.resolve(attachments);
   }
+  /**
+   * {@inheritDoc @embedpdf/models!PdfEngine.addAttachment}
+   *
+   * @public
+   */
+  addAttachment(doc, params) {
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "addAttachment", doc, params == null ? void 0 : params.name);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `AddAttachment`, "Begin", doc.id);
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `AddAttachment`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "document does not open"
+      });
+    }
+    const { name, description, mimeType, data } = params ?? {};
+    if (!name) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `AddAttachment`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.NotFound,
+        message: "attachment name is required"
+      });
+    }
+    if (!data || (data instanceof Uint8Array ? data.byteLength === 0 : data.byteLength === 0)) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `AddAttachment`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.NotFound,
+        message: "attachment data is empty"
+      });
+    }
+    const attachmentPtr = this.withWString(
+      name,
+      (wNamePtr) => this.pdfiumModule.FPDFDoc_AddAttachment(ctx.docPtr, wNamePtr)
+    );
+    if (!attachmentPtr) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `AddAttachment`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.Unknown,
+        message: `An attachment named "${name}" already exists`
+      });
+    }
+    this.withWString(
+      description,
+      (wDescriptionPtr) => this.pdfiumModule.EPDFAttachment_SetDescription(attachmentPtr, wDescriptionPtr)
+    );
+    this.pdfiumModule.EPDFAttachment_SetSubtype(attachmentPtr, mimeType);
+    const u8 = data instanceof Uint8Array ? data : new Uint8Array(data);
+    const len = u8.byteLength;
+    const contentPtr = this.memoryManager.malloc(len);
+    try {
+      this.pdfiumModule.pdfium.HEAPU8.set(u8, contentPtr);
+      const ok = this.pdfiumModule.FPDFAttachment_SetFile(
+        attachmentPtr,
+        ctx.docPtr,
+        contentPtr,
+        len
+      );
+      if (!ok) {
+        this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `AddAttachment`, "End", doc.id);
+        return PdfTaskHelper.reject({
+          code: PdfErrorCode.Unknown,
+          message: "failed to write attachment bytes"
+        });
+      }
+    } finally {
+      this.memoryManager.free(contentPtr);
+    }
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `AddAttachment`, "End", doc.id);
+    return PdfTaskHelper.resolve(true);
+  }
+  /**
+   * {@inheritDoc @embedpdf/models!PdfEngine.removeAttachment}
+   *
+   * @public
+   */
+  removeAttachment(doc, attachment) {
+    this.logger.debug(LOG_SOURCE, LOG_CATEGORY, "deleteAttachment", doc, attachment);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `DeleteAttachment`, "Begin", doc.id);
+    const ctx = this.cache.getContext(doc.id);
+    if (!ctx) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `DeleteAttachment`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.DocNotOpen,
+        message: "document does not open"
+      });
+    }
+    const count = this.pdfiumModule.FPDFDoc_GetAttachmentCount(ctx.docPtr);
+    if (attachment.index < 0 || attachment.index >= count) {
+      this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `DeleteAttachment`, "End", doc.id);
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.Unknown,
+        message: `attachment index ${attachment.index} out of range`
+      });
+    }
+    const ok = this.pdfiumModule.FPDFDoc_DeleteAttachment(ctx.docPtr, attachment.index);
+    this.logger.perf(LOG_SOURCE, LOG_CATEGORY, `DeleteAttachment`, "End", doc.id);
+    if (!ok) {
+      return PdfTaskHelper.reject({
+        code: PdfErrorCode.Unknown,
+        message: "failed to delete attachment"
+      });
+    }
+    return PdfTaskHelper.resolve(true);
+  }
   /**
    * {@inheritDoc @embedpdf/models!PdfEngine.readAttachmentContent}
    *
@@ -3741,6 +3952,29 @@ class PdfiumEngine {
     const raw = dateToPdfDate(date);
     return this.setAnnotString(annotationPtr, key, raw);
   }
+  /**
+   * Get the date of the attachment
+   *
+   * @param attachmentPtr - pointer to an `FPDF_ATTACHMENT`
+   * @param key - 'ModDate' for modified date, 'CreationDate' for creation date
+   * @returns `Date` or `undefined` when PDFium can't read the date
+   */
+  getAttachmentDate(attachmentPtr, key) {
+    const raw = this.getAttachmentString(attachmentPtr, key);
+    return raw ? pdfDateToDate(raw) : void 0;
+  }
+  /**
+   * Set the date of the attachment
+   *
+   * @param attachmentPtr - pointer to an `FPDF_ATTACHMENT`
+   * @param key - 'ModDate' for modified date, 'CreationDate' for creation date
+   * @param date - `Date` to set
+   * @returns `true` on success
+   */
+  setAttachmentDate(attachmentPtr, key, date) {
+    const raw = dateToPdfDate(date);
+    return this.setAttachmentString(attachmentPtr, key, raw);
+  }
   /**
    * Dash-pattern helper ( /BS → /D array, dashed borders only )
    *
@@ -5132,6 +5366,45 @@ class PdfiumEngine {
     this.memoryManager.free(ptr);
     return value || void 0;
   }
+  /**
+   * Get a string value (`/T`, `/M`, `/State`, …) from an attachment.
+   *
+   * @returns decoded UTF-8 string or `undefined` when the key is absent
+   *
+   * @private
+   */
+  getAttachmentString(attachmentPtr, key) {
+    const len = this.pdfiumModule.FPDFAttachment_GetStringValue(attachmentPtr, key, 0, 0);
+    if (len === 0) return;
+    const bytes = (len + 1) * 2;
+    const ptr = this.memoryManager.malloc(bytes);
+    this.pdfiumModule.FPDFAttachment_GetStringValue(attachmentPtr, key, ptr, bytes);
+    const value = this.pdfiumModule.pdfium.UTF16ToString(ptr);
+    this.memoryManager.free(ptr);
+    return value || void 0;
+  }
+  /**
+   * Get a number value (`/Size`) from an attachment.
+   *
+   * @returns number or `null` when the key is absent
+   *
+   * @private
+   */
+  getAttachmentNumber(attachmentPtr, key) {
+    const outPtr = this.memoryManager.malloc(4);
+    try {
+      const ok = this.pdfiumModule.EPDFAttachment_GetIntegerValue(
+        attachmentPtr,
+        key,
+        // FPDF_BYTESTRING → ASCII JS string is fine in your glue
+        outPtr
+      );
+      if (!ok) return void 0;
+      return this.pdfiumModule.pdfium.getValue(outPtr, "i32") >>> 0;
+    } finally {
+      this.memoryManager.free(outPtr);
+    }
+  }
   /**
    * Get custom data of the annotation
    * @param annotationPtr - pointer to pdf annotation
@@ -5223,12 +5496,9 @@ class PdfiumEngine {
    * @private
    */
   getAnnotationByName(pagePtr, name) {
-    const bytes = 2 * (name.length + 1);
-    const ptr = this.memoryManager.malloc(bytes);
-    this.pdfiumModule.pdfium.stringToUTF16(name, ptr, bytes);
-    const ok = this.pdfiumModule.EPDFPage_GetAnnotByName(pagePtr, ptr);
-    this.memoryManager.free(ptr);
-    return ok;
+    return this.withWString(name, (wNamePtr) => {
+      return this.pdfiumModule.EPDFPage_GetAnnotByName(pagePtr, wNamePtr);
+    });
   }
   /**
    * Remove annotation by name
@@ -5239,12 +5509,9 @@ class PdfiumEngine {
    * @private
    */
   removeAnnotationByName(pagePtr, name) {
-    const bytes = 2 * (name.length + 1);
-    const ptr = this.memoryManager.malloc(bytes);
-    this.pdfiumModule.pdfium.stringToUTF16(name, ptr, bytes);
-    const ok = this.pdfiumModule.EPDFPage_RemoveAnnotByName(pagePtr, ptr);
-    this.memoryManager.free(ptr);
-    return ok;
+    return this.withWString(name, (wNamePtr) => {
+      return this.pdfiumModule.EPDFPage_RemoveAnnotByName(pagePtr, wNamePtr);
+    });
   }
   /**
    * Set a string value (`/T`, `/M`, `/State`, …) to an annotation.
@@ -5254,12 +5521,21 @@ class PdfiumEngine {
    * @private
    */
   setAnnotString(annotationPtr, key, value) {
-    const bytes = 2 * (value.length + 1);
-    const ptr = this.memoryManager.malloc(bytes);
-    this.pdfiumModule.pdfium.stringToUTF16(value, ptr, bytes);
-    const ok = this.pdfiumModule.FPDFAnnot_SetStringValue(annotationPtr, key, ptr);
-    this.memoryManager.free(ptr);
-    return ok;
+    return this.withWString(value, (wValPtr) => {
+      return this.pdfiumModule.FPDFAnnot_SetStringValue(annotationPtr, key, wValPtr);
+    });
+  }
+  /**
+   * Set a string value (`/T`, `/M`, `/State`, …) to an attachment.
+   *
+   * @returns `true` if the operation was successful
+   *
+   * @private
+   */
+  setAttachmentString(attachmentPtr, key, value) {
+    return this.withWString(value, (wValPtr) => {
+      return this.pdfiumModule.FPDFAttachment_SetStringValue(attachmentPtr, key, wValPtr);
+    });
   }
   /**
    * Read vertices of pdf annotation
@@ -5759,6 +6035,95 @@ class PdfiumEngine {
       }
     }
   }
+  createLocalDestPtr(docPtr, dest) {
+    var _a, _b;
+    const pagePtr = this.pdfiumModule.FPDF_LoadPage(docPtr, dest.pageIndex);
+    if (!pagePtr) return 0;
+    try {
+      if (dest.zoom.mode === PdfZoomMode.XYZ) {
+        const { x, y, zoom } = dest.zoom.params;
+        return this.pdfiumModule.EPDFDest_CreateXYZ(
+          pagePtr,
+          /*has_left*/
+          true,
+          x,
+          /*has_top*/
+          true,
+          y,
+          /*has_zoom*/
+          true,
+          zoom
+        );
+      }
+      let viewEnum;
+      let params = [];
+      switch (dest.zoom.mode) {
+        case PdfZoomMode.FitPage:
+          viewEnum = PdfZoomMode.FitPage;
+          break;
+        case PdfZoomMode.FitHorizontal:
+          viewEnum = PdfZoomMode.FitHorizontal;
+          params = [((_a = dest.view) == null ? void 0 : _a[0]) ?? 0];
+          break;
+        case PdfZoomMode.FitVertical:
+          viewEnum = PdfZoomMode.FitVertical;
+          params = [((_b = dest.view) == null ? void 0 : _b[0]) ?? 0];
+          break;
+        case PdfZoomMode.FitRectangle:
+          {
+            const v = dest.view ?? [];
+            params = [v[0] ?? 0, v[1] ?? 0, v[2] ?? 0, v[3] ?? 0];
+            viewEnum = PdfZoomMode.FitRectangle;
+          }
+          break;
+        case PdfZoomMode.Unknown:
+        default:
+          return 0;
+      }
+      return this.withFloatArray(
+        params,
+        (ptr, count) => this.pdfiumModule.EPDFDest_CreateView(pagePtr, viewEnum, ptr, count)
+      );
+    } finally {
+      this.pdfiumModule.FPDF_ClosePage(pagePtr);
+    }
+  }
+  applyBookmarkTarget(docPtr, bmPtr, target) {
+    if (target.type === "destination") {
+      const destPtr = this.createLocalDestPtr(docPtr, target.destination);
+      if (!destPtr) return false;
+      const ok = this.pdfiumModule.EPDFBookmark_SetDest(docPtr, bmPtr, destPtr);
+      return !!ok;
+    }
+    const action = target.action;
+    switch (action.type) {
+      case PdfActionType.Goto: {
+        const destPtr = this.createLocalDestPtr(docPtr, action.destination);
+        if (!destPtr) return false;
+        const actPtr = this.pdfiumModule.EPDFAction_CreateGoTo(docPtr, destPtr);
+        if (!actPtr) return false;
+        return !!this.pdfiumModule.EPDFBookmark_SetAction(docPtr, bmPtr, actPtr);
+      }
+      case PdfActionType.URI: {
+        const actPtr = this.pdfiumModule.EPDFAction_CreateURI(docPtr, action.uri);
+        if (!actPtr) return false;
+        return !!this.pdfiumModule.EPDFBookmark_SetAction(docPtr, bmPtr, actPtr);
+      }
+      case PdfActionType.LaunchAppOrOpenFile: {
+        const actPtr = this.withWString(
+          action.path,
+          (wptr) => this.pdfiumModule.EPDFAction_CreateLaunch(docPtr, wptr)
+        );
+        if (!actPtr) return false;
+        return !!this.pdfiumModule.EPDFBookmark_SetAction(docPtr, bmPtr, actPtr);
+      }
+      case PdfActionType.RemoteGoto:
+        return false;
+      case PdfActionType.Unsupported:
+      default:
+        return false;
+    }
+  }
   /**
    * Read pdf action from pdf document
    * @param docPtr - pointer to pdf document object
@@ -5949,18 +6314,21 @@ class PdfiumEngine {
       },
       this.pdfiumModule.pdfium.UTF16ToString
     );
-    const creationDate = readString(
+    const description = readString(
       this.pdfiumModule.pdfium,
       (buffer, bufferLength) => {
-        return this.pdfiumModule.FPDFAttachment_GetStringValue(
-          attachmentPtr,
-          "CreationDate",
-          buffer,
-          bufferLength
-        );
+        return this.pdfiumModule.EPDFAttachment_GetDescription(attachmentPtr, buffer, bufferLength);
       },
       this.pdfiumModule.pdfium.UTF16ToString
     );
+    const mimeType = readString(
+      this.pdfiumModule.pdfium,
+      (buffer, bufferLength) => {
+        return this.pdfiumModule.FPDFAttachment_GetSubtype(attachmentPtr, buffer, bufferLength);
+      },
+      this.pdfiumModule.pdfium.UTF16ToString
+    );
+    const creationDate = this.getAttachmentDate(attachmentPtr, "CreationDate");
     const checksum = readString(
       this.pdfiumModule.pdfium,
       (buffer, bufferLength) => {
@@ -5973,9 +6341,13 @@ class PdfiumEngine {
       },
       this.pdfiumModule.pdfium.UTF16ToString
     );
+    const size = this.getAttachmentNumber(attachmentPtr, "Size");
     return {
       index,
       name,
+      description,
+      mimeType,
+      size,
       creationDate,
       checksum
     };
@@ -6654,4 +7026,4 @@ export {
   isValidCustomKey as i,
   readString as r
 };
-//# sourceMappingURL=engine-4h8XG4y4.js.map
+//# sourceMappingURL=engine-BVe88qdX.js.map