@ironsoftware/ironpdf-engine-macos-x64 2025.9.1 → 2025.11.2

package/index.js

@@ -1,4 +1,4 @@
-let version = "2025.9.4"
+let version = "2025.11.12"
 let dir = __dirname
 
 

package/{ironpdf-engine-bin-2025.9.4 → ironpdf-engine-bin-2025.11.12}/IronPdf.xml

@@ -350,6 +350,18 @@
             <param name="siblings">Bookmark siblings</param>
             <exception cref="T:System.ArgumentOutOfRangeException"></exception>
         </member>
+        <member name="M:IronPdf.Bookmarks.PdfBookMark.#ctor(IronSoftware.IDocumentId,System.String,System.String,System.Int32,IronPdf.Bookmarks.IPdfBookmark,IronPdf.Bookmarks.IPdfBookMarkCollection)">
+            <summary>
+            Describe a bookmark already associated with an existing document
+            </summary>
+            <param name="pdfDocumentId">Document identifier</param>
+            <param name="text">Bookmark text</param>
+            <param name="itemId">Bookmark ItemId</param>
+            <param name="pageIndex">Page index</param>
+            <param name="parent">Bookmark parent</param>
+            <param name="siblings">Bookmark siblings</param>
+            <exception cref="T:System.ArgumentOutOfRangeException"></exception>
+        </member>
         <member name="M:IronPdf.Bookmarks.PdfBookMark.#ctor">
             <summary>
             Create a new bookmark not yet added to a document
@@ -459,11 +471,12 @@
             <param name="pageIndex">The zero based page number to link to.  E.g.  Page 1 has a PageIndex of 0</param>
             <param name="nextBookmark">Bookmark before which to insert a new bookmark</param>
         </member>
-        <member name="M:IronPdf.Bookmarks.PdfBookMarkCollection.AddBookmarkInternal(System.String,System.Int32)">
+        <member name="M:IronPdf.Bookmarks.PdfBookMarkCollection.AddBookmarkInternal(System.String,System.String,System.Int32)">
             <summary>
             Internal method for adding a bookmark to the current bookmark collection, without invoking any Pdfium methods
             </summary>
             <param name="text">Bookmark text</param>
+            <param name="itemId">Bookmark ItemId</param>
             <param name="pageIndex">Bookmark page index</param>
             <remarks>This method should be invoked when retrieving bookmarks from Pdfium to populate a bookmark collection</remarks>
         </member>
@@ -1925,6 +1938,26 @@
             Pdf client implementation which facilitates requests with a remote server via gRPC
             </summary>
         </member>
+        <member name="M:IronPdf.Engines.Pdfium.GrpcQPdfClient.CompleteSavingAsPdfA4(IronSoftware.IDocumentId,System.String,System.String)">
+            <summary>
+            Applies final PDF/A-4 specific flags and saves the provided PDF as version 2 using QPdf.
+            </summary>
+            <remarks>
+            Note: <see cref="M:IronSoftware.Pdfium.IPdfClient.ConvertToPdfA(IronSoftware.IDocumentId,System.Byte[],IronPdf.InternalPdfAVersion)"/> should be called before invoking this method to perform the actual conversion.
+            </remarks>
+            <param name="documentId">The id of the input document.</param>
+            <param name="outputPath">The file path where the PDF should be saved.</param>
+            <param name="password">An optional password to encrypt the PDF. Pass <c>null</c> or an empty string for no password. </param>
+            <exception cref="T:System.ArgumentNullException">
+            Thrown if <paramref name="documentId"/> is null.
+            </exception>
+            <exception cref="T:System.IO.IOException">
+            Thrown if there is an error retrieving the PDF bytes from the native PDF library.
+            </exception>
+            <exception cref="T:System.Exception">
+            Thrown if the QPdf handle creation, reading, initialization, or writing fails.
+            </exception>
+        </member>
         <member name="T:IronPdf.Engines.Pdfium.PdfiumDeployment">
             <summary>
             Deployment class for native Pdfium binaries in IronPdf
@@ -1948,6 +1981,29 @@
             Ninject module for determining which Pdfium client to use
             </summary>
         </member>
+        <member name="T:IronPdf.Engines.Pdfium.QPdfInjectionModule">
+            <summary>
+            Ninject module for determining which QPdf client to use
+            </summary>
+        </member>
+        <member name="T:IronPdf.Engines.Qpdf.QPdfDeployment">
+            <summary>
+            Deployment class for native QPdf binaries in IronPdf
+            </summary>
+        </member>
+        <member name="P:IronPdf.Engines.Qpdf.QPdfDeployment.VersionFactory">
+            <inheritdoc/>
+        </member>
+        <member name="M:IronPdf.Engines.Qpdf.QPdfDeployment.#ctor(System.String)">
+            <summary>
+            Create a new QPdf deployment for IronPdf, optionally using the specified custom directory
+            </summary>
+            <param name="directory">Optional custom directory</param>
+            <remarks>Should be instantiated using <seealso cref="T:IronSoftware.Deployment.DeploymentEngine"/></remarks>
+        </member>
+        <member name="M:IronPdf.Engines.Qpdf.QPdfDeployment.GetPlatformSpecificErrorMessage(System.Exception)">
+            <inheritdoc/>
+        </member>
         <member name="T:IronPdf.Engines.ISystemClient">
             <summary>
             System client functionality
@@ -3815,6 +3871,19 @@
         <member name="M:IronPdf.PdfDocument.GetHashCode">
             <inheritdoc/>
         </member>
+        <member name="M:IronPdf.PdfDocument.ShouldCompleteSavingAsPdfA4(System.String)">
+            <summary>
+            Determines whether the PDF should be saved using QPDF.
+            Returns true only if the document is PDF/A-4x and the output filename has a ".pdf" extension (case-insensitive).
+            </summary>
+            <param name="outputFilename">The path and filename where the PDF will be saved.</param>
+        </member>
+        <member name="M:IronPdf.PdfDocument.TrySaveUsingQPdf(System.String)">
+            <summary>
+            Saves a PDF to the specified file using QPDF with enforced options.
+            </summary>
+            <param name="outputFilename">The path and filename where the PDF will be saved.</param>
+        </member>
         <member name="M:IronPdf.PdfDocument.AppendPdf(IronPdf.PdfDocument)">
             <summary>
             Appends another PDF to the end of the current <see cref="T:IronPdf.PdfDocument"/>
@@ -3956,17 +4025,6 @@
             Gets a boolean value indicating whether this document contains any form fields.
             </summary>
         </member>
-        <member name="P:IronPdf.PdfDocument.PdfAVer">
-            <summary>
-            Conformance version of PDF/A
-            </summary>
-        </member>
-        <member name="P:IronPdf.PdfDocument.IsAComformance">
-            <summary>
-            Verify whether "A" conformance
-            </summary>
-            <remarks>i.e. PDF/A-1A, PDF/A-2A, PDF/A-A</remarks>
-        </member>
         <member name="M:IronPdf.PdfDocument.ConvertToPdfA(IronPdf.PdfAVersions,System.String)">
             <summary>
             Convert the current document into the specified PDF/A standard format with selected icc file
@@ -4072,13 +4130,6 @@
             <remarks>currently only support embedding 3 types of file; .xml, .pdf, and .png</remarks>
             <returns></returns>
         </member>
-        <member name="M:IronPdf.PdfDocument.SetConformanceVersion(IronPdf.PdfAVersions)">
-            <summary>
-            Set conformance version values <see cref="P:IronPdf.PdfDocument.PdfAVer"/> and <see cref="P:IronPdf.PdfDocument.IsAComformance"/>.
-            </summary>
-            <param name="pdfAVersion"><see cref="T:IronPdf.PdfAVersions"/></param>
-            <exception cref="T:System.ArgumentOutOfRangeException">Throw if unsupported Pdf/A conformance version</exception>
-        </member>
         <member name="M:IronPdf.PdfDocument.StringPathsToEmbedFilePaths(System.Collections.Generic.IEnumerable{System.String})">
             <summary>
             Convert a collection of string paths to a collection of <see cref="T:IronPdf.EmbedFilePath"/> with the default <see cref="T:IronPdf.EmbedFileConfiguration"/>
@@ -4107,6 +4158,18 @@
             <param name="EmbedFileStreams">Collection of Stream to embedding file to the PDF/A document</param>
             <returns>PDF/A document with embeded files</returns>
         </member>
+        <member name="M:IronPdf.PdfDocument.IsPdfAVersionA4x">
+            <summary>
+            Checks if the current PDF document is of PDF/A-4x version.
+            Returns true if the 'part' metadata equals "4"; otherwise, false.
+            </summary>
+        </member>
+        <member name="M:IronPdf.PdfDocument.IsEmbeddingFileNotSupported(IronPdf.PdfAVersions)">
+            <summary>
+            Determines whether embedding files is unsupported for the specified PDF/A version.
+            Returns true if the version is one of the unsupported versions (PDF/A-1a, 1b, 2a, 2b, or 4); otherwise, false.
+            </summary>
+        </member>
         <member name="M:IronPdf.PdfDocument.ConvertToPdfUA(IronPdf.PdfUAVersions,IronPdf.NaturalLanguages)">
             <summary>
             Convert the current document into the specified PDF/UA standard format
@@ -4227,6 +4290,91 @@
             <returns>The number of printed pages.</returns>
             <seealso cref="M:IronPdf.PdfDocument.GetPrintDocument(System.Drawing.Printing.PrinterSettings,System.Drawing.Printing.PrintController,System.Boolean)"/>
         </member>
+        <member name="M:IronPdf.PdfDocument.IsLinearized(System.String,System.String)">
+            <summary>
+            <para>Loads a PDF document from a specified file path and check if the file is linearized or not.</para>
+            <para>------------------------------------------------</para>
+            <para><b>Usage:</b> <c>PdfDocument.IsLinearized("my-pdf-file.pdf");</c></para>
+            <para>------------------------------------------------</para>
+            </summary>
+            <param name="FilePath">The full path to the PDF file to load.</param>
+            <param name="Password">The password for the PDF file if it is encrypted. Default is empty string.</param>
+            <returns>True if the file is linearized or False if the file is not linearized</returns>
+            <exception cref="T:System.ArgumentException">Thrown when the FilePath is null, empty, or whitespace.</exception>
+            <exception cref="T:System.IO.FileNotFoundException">Thrown when the file at the specified FilePath does not exist.</exception>
+            <remarks>
+            <b>Important Notes:</b>
+            <para><description>⚡️ <b>Performance:</b> This method is highly performant.</description></para>
+            <para><description>🛡️ <b>Security:</b> Always validate file paths to prevent directory traversal vulnerabilities.</description></para>
+            <b>Related Documentation:</b>
+            <para><description>📖 <b>How-To Guide:</b> <see href="https://ironpdf.com/how-to/linearize-pdf/">Getting Started with PDF Linearization</see></description></para>
+            <para><description>📚 <b>API Reference:</b> <see href="https://ironpdf.com/object-reference/api/">Full API Documentation</see></description></para>
+            </remarks>
+        </member>
+        <member name="M:IronPdf.PdfDocument.SaveAsLinearized(System.String)">
+            <summary>
+            <para>Create a linearized file from the current pdf document.</para>
+            <para>------------------------------------------------</para>
+            <para><b>Usage:</b> <c>pdf.SaveAsLinearized("my-pdf-file-linearized.pdf");</c></para>
+            <para>------------------------------------------------</para>
+            </summary>
+            <param name="OutputPath">Path of the file where it will be saved in file system.</param>
+            <returns>Nothing</returns>
+            <exception cref="T:System.ArgumentException">Thrown when the OutputPath is null, empty, or whitespace.</exception>
+            <remarks>
+            <b>Important Notes:</b>
+            <para><description>⚡️ <b>Performance:</b> This method is highly performant.</description></para>
+            <para><description>🛡️ <b>Security:</b> Always validate file paths to prevent directory traversal vulnerabilities.</description></para>
+            <b>Related Documentation:</b>
+            <para><description>📖 <b>How-To Guide:</b> <see href="https://ironpdf.com/how-to/linearize-pdf/">Getting Started with PDF Linearization</see></description></para>
+            <para><description>📚 <b>API Reference:</b> <see href="https://ironpdf.com/object-reference/api/">Full API Documentation</see></description></para>
+            </remarks>
+        </member>
+        <member name="M:IronPdf.PdfDocument.SaveAsLinearized(System.Byte[],System.String,System.String)">
+            <summary>
+            <para>Create a linearized file from pdf byte array.</para>
+            <para>------------------------------------------------</para>
+            <para><b>Usage:</b> <c>PdfDocument.SaveAsLinearized(pdfBytes, "my-pdf-file-linearized.pdf", "");</c></para>
+            <para>------------------------------------------------</para>
+            </summary>
+            <param name="PdfBytes">byte arrray of the Pdf file</param>
+            <param name="OutputPath">Path of the file where it will be saved in file system</param>
+            <param name="Password">password to open the file</param>
+            <returns>Nothing</returns>
+            <exception cref="T:System.ArgumentException">Thrown when the PdfBytes array is null or empty.</exception>
+            <exception cref="T:System.ArgumentException">Thrown when the OutputPath is null, empty, or whitespace.</exception>
+            <remarks>
+            <b>Important Notes:</b>
+            <para><description>⚡️ <b>Performance:</b> This method is highly performant.</description></para>
+            <para><description>🛡️ <b>Security:</b> Always validate file paths to prevent directory traversal vulnerabilities.</description></para>
+            <b>Related Documentation:</b>
+            <para><description>📖 <b>How-To Guide:</b> <see href="https://ironpdf.com/how-to/linearize-pdf/">Getting Started with PDF Linearization</see></description></para>
+            <para><description>📚 <b>API Reference:</b> <see href="https://ironpdf.com/object-reference/api/">Full API Documentation</see></description></para>
+            </remarks>
+        </member>
+        <member name="M:IronPdf.PdfDocument.SaveAsLinearized(System.IO.Stream,System.String,System.String)">
+            <summary>
+            <para>Create a linearized file from pdf stream.</para>
+            <para>------------------------------------------------</para>
+            <para><b>Usage:</b> <c>PdfDocument.SaveAsLinearized(pdfStream, "my-pdf-file-linearized.pdf", "mypassword");</c></para>
+            <para>------------------------------------------------</para>
+            </summary>
+            <param name="Stream">Stream of the PDF file</param>
+            <param name="OutputPath">Path of the file where it will be saved in file system</param>
+            <param name="Password">password to open the file</param>
+            <returns>Nothing</returns>
+            <exception cref="T:System.ArgumentNullException">Thrown when the input Stream is null.</exception>
+            <exception cref="T:System.ArgumentException">Thrown when the input Stream is not readable.</exception>
+            <exception cref="T:System.ArgumentException">Thrown when the OutputPath is null, empty, or whitespace.</exception>
+            <remarks>
+            <b>Important Notes:</b>
+            <para><description>⚡️ <b>Performance:</b> This method is highly performant.</description></para>
+            <para><description>🛡️ <b>Security:</b> Always validate file paths to prevent directory traversal vulnerabilities.</description></para>
+            <b>Related Documentation:</b>
+            <para><description>📖 <b>How-To Guide:</b> <see href="https://ironpdf.com/how-to/linearize-pdf/">Getting Started with PDF Linearization</see></description></para>
+            <para><description>📚 <b>API Reference:</b> <see href="https://ironpdf.com/object-reference/api/">Full API Documentation</see></description></para>
+            </remarks>
+        </member>
         <member name="M:IronPdf.PdfDocument.RemovePage(System.Int32)">
             <summary>
             Removes a page from the PDF at the given index.
@@ -4419,6 +4567,29 @@
             any way will invalidate signatures.
             </returns>
         </member>
+        <member name="M:IronPdf.PdfDocument.SignAndSave(System.String,IronSoftware.Pdfium.Signing.IHsmSigner,IronPdf.Signing.PdfSignatureImage,IronPdf.Signing.SignaturePermissions)">
+            <summary>
+            <para>Saves a PDF document after signing it using an HSM (PKCS#11) signer.</para>
+            <para>------------------------------------------------</para>
+            <para><b>Usage:</b> 
+            <c>doc.SignAndSave(destinationPath, hsmSigner, signatureImage, signaturePermission);</c></para>
+            <para>------------------------------------------------</para>
+            </summary>
+            <param name="destinationPath">The file path where the signed PDF will be saved.</param>
+            <param name="hsmSigner">The HSM-based signer used to sign the PDF.</param>
+            <param name="signatureImage">An optional image to include in the signature.</param>
+            <param name="signaturePermission">The signaturePermission applied to the signed PDF. Defaults to <c>NoChangesAllowed</c>.</param>
+            <returns>None. The method saves a signed version of the PDF to the specified destination path.</returns>
+            <remarks>
+            <b>Important Notes:</b>
+            <para> ⚡️ <b>Performance:</b> This method writes the entire PDF file binary format for intermediate use, loads it into memory to modify the document bytes, and finally saves the signed version to the destination path. </para>
+            <para> 🛡️ <b>Security:</b> Always create a new temporary path and clean it up after execution.</para>
+            <para> 📝 <b>Note:</b> The optional <c>signaturePermission</c> parameter defaults to <c>NoChangesAllowed</c>.</para>
+            <b>Related Documentation:</b>
+            <para> 📖 <b>How-To Guide:</b> <see href="https://ironpdf.com/how-to/signing/">Guide to Digitally Signing PDFs</see></para>
+            <para> 📚 <b>API Reference:</b> <see href="https://ironpdf.com/object-reference/api/">Full API Documentation</see></para>
+            </remarks>
+        </member>
         <member name="M:IronPdf.PdfDocument.ApplyStamp(IronPdf.Editing.Stamper)">
             <summary>
             Edits the PDF by applying the <see cref="T:IronPdf.Editing.Stamper"/>'s rendered <see cref="P:IronPdf.Editing.Stamper.Html"/> to every page.
@@ -5317,11 +5488,26 @@
         </member>
         <member name="M:IronPdf.License.IsValidLicense(System.String)">
             <summary>
-            Determines whether a string license key is valid. <para>See https://ironpdf.com/licensing/ for trial,
-            development and commercial deployment licensing options.</para>
+            <para>Determines whether a string license is valid upon the validation process</para>
+            <para>------------------------------------------------</para>
+            <para><b>Usage:</b> <c>bool checkValidLicense = IronPdf.License.IsValidLicense(IronPdf.License.LicenseKey);</c></para>
+            <para>------------------------------------------------</para>
             </summary>
-            <param name="LicenseKey">IronPDF license key as a string</param>
-            <returns>True if the license key given is valid.</returns>
+            <param name="LicenseKey">IronPdf license key as a string</param>
+            <returns><c>true</c> if the license key given is valid and not expired.</returns>
+            <remarks>
+            <b>Important Notes:</b>
+            <para>❗ <b>Validation Behavior:</b> This method will return <c>false</c> for expired keys, even if they were previously valid. This includes:</para>
+            <list type="bullet">
+            <item><description>Expired TEAM KEY</description></item>
+            <item><description>Expired Subscription Key</description></item>
+            <item><description>Expired Enterprise Key</description></item>
+            </list>
+            <b>Related Documentation:</b>
+            <para><description> 🗝️ <b>Get a Trial Key:</b> <see href="https://ironpdf.com/licensing/#trial-license/"> Learn more and get a trial key</see></description></para>
+            <para><description> 🗝️ <b>Commercial Licensing:</b> <see href="https://ironpdf.com/licensing/"> View commercial licensing options</see></description></para>
+            <para><description> 📚 <b>API Reference:</b> <see href="https://ironpdf.com/object-reference/api/IronPdf.License.html#IronPdf_License_IsValidLicense_System_String_">Full API Documentation</see></description></para>
+            </remarks>
         </member>
         <member name="M:IronPdf.License.DisableAppAnalytics">
             <summary>
@@ -7168,9 +7354,14 @@
             PDF client implementation
             </summary>
         </member>
+        <member name="P:IronPdf.PdfClientAccessor.QPdfClient">
+            <summary>
+            QPdf client
+            </summary>
+        </member>
         <member name="M:IronPdf.PdfClientAccessor.#ctor">
             <summary>
-            Create a new PDF client accessor
+            Create a new PDF client accessor and a QPdf client accessor
             </summary>
         </member>
         <member name="T:IronPdf.PdfAttachment">
@@ -7266,6 +7457,21 @@
             A PDF compliant with the ISO 19005-3 (PDF/A-3A)
             </summary>
         </member>
+        <member name="F:IronPdf.PdfAVersions.PdfA4">
+            <summary>
+            A PDF compliant with ISO 19005-4 (PDF/A-4).
+            </summary>
+        </member>
+        <member name="F:IronPdf.PdfAVersions.PdfA4e">
+            <summary>
+            A PDF compliant with ISO 19005-4 (PDF/A-4E — engineering documents).
+            </summary>
+        </member>
+        <member name="F:IronPdf.PdfAVersions.PdfA4f">
+            <summary>
+            A PDF compliant with ISO 19005-4 (PDF/A-4F — embedded files allowed).
+            </summary>
+        </member>
         <member name="T:IronPdf.EmbedFilePath">
             <summary>
             Struct for storing path directory of embedding file with configuration

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "@ironsoftware/ironpdf-engine-macos-x64",
-	"version": "2025.9.1",
-	"ironPdfEngineVersion": "2025.9.4",
+	"version": "2025.11.2",
+	"ironPdfEngineVersion": "2025.11.12",
 	"homepage": "https://ironpdf.com/nodejs",
 	"platform": "MacOS",
 	"arch": "x64",