@embedpdf/engines 1.3.0 → 1.3.1

package/dist/{engine-BSP2yN_k.js → engine-BVe88qdX.js}

@@ -1682,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}
    *
@@ -3847,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 )
    *
@@ -5238,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
@@ -5329,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
@@ -5345,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.
@@ -5360,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
@@ -6144,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) => {
@@ -6168,9 +6341,13 @@ class PdfiumEngine {
       },
       this.pdfiumModule.pdfium.UTF16ToString
     );
+    const size = this.getAttachmentNumber(attachmentPtr, "Size");
     return {
       index,
       name,
+      description,
+      mimeType,
+      size,
       creationDate,
       checksum
     };
@@ -6849,4 +7026,4 @@ export {
   isValidCustomKey as i,
   readString as r
 };
-//# sourceMappingURL=engine-BSP2yN_k.js.map
+//# sourceMappingURL=engine-BVe88qdX.js.map