@ironsoftware/ironpdf 2024.12.9 → 2025.2.1

package/src/public/pdfDocument.ts

@@ -54,7 +54,7 @@ import {pdfPaperSizeSchema} from "../internal/zod/paperSchema";
 import {pageRotationSchema} from "../internal/zod/pageSchema";
 import {chromePdfRenderOptionsSchema, httpLoginCredentialsSchema} from "../internal/zod/renderSchema";
 import {
-	getFileNames,
+	getFileName,
 	getImageExtType,
 	separateImageBufferOrImagePathInput,
 	separatePdfInput
@@ -111,34 +111,34 @@ export class PdfDocument{
 			 * required for open a protected PDF file
 			 * @default undefined
 			 */
-			password?: PdfPassword;
+			password?: PdfPassword | undefined;
 			/**
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			renderOptions?: ChromePdfRenderOptions;
+			renderOptions?: ChromePdfRenderOptions | undefined;
 			/**
 			 * Apply httpLoginCredentials if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			httpLoginCredentials?: HttpLoginCredentials;
+			httpLoginCredentials?: HttpLoginCredentials | undefined;
 			/**
 			 * Apply mainHtmlFile if PdfInput is {@link ZipFilePath}
 			 * @default index.html
 			 */
-			mainHtmlFile?: string;
+			mainHtmlFile?: string | undefined;
 			/**
 			 * Optionally track changes to the document (for use with incremental saves)
 			 * @default {@link ChangeTrackingModes.AutoChangeTracking}
 			 */
-			trackChanges?: ChangeTrackingModes;
+			trackChanges?: ChangeTrackingModes | undefined;
 			// /**
 			//  * Apply baseUrl if
 			//  * The HTML base URL for which references to external CSS, Javascript and Image files will be relative.
 			//  * @default undefined
 			//  */
-			// baseUrl?: string;  //not supported
-		}
+			// baseUrl ?: string | undefined;  //not supported
+		} | undefined
 	): Promise<PdfDocument> {
 		return z.function()
 			.args(
@@ -162,7 +162,7 @@ export class PdfDocument{
 	 * @param Optionally track changes to the document (for use with incremental saves)
 	 */
 	public static async fromFile(
-		pdfFilePath: string, trackChanges?: ChangeTrackingModes
+		pdfFilePath: string, trackChanges?: ChangeTrackingModes | undefined
 	): Promise<PdfDocument> {
 		return z.function()
 			.args(
@@ -186,8 +186,8 @@ export class PdfDocument{
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			renderOptions?: ChromePdfRenderOptions;
-		}
+			renderOptions?: ChromePdfRenderOptions | undefined;
+		} | undefined
 	): Promise<PdfDocument> {
 		return z.function()
 			.args(
@@ -222,12 +222,12 @@ export class PdfDocument{
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			renderOptions?: ChromePdfRenderOptions;
+			renderOptions?: ChromePdfRenderOptions | undefined;
 			/**
 			 * a main .html file default: `index.html`
 			 */
-			mainHtmlFile?: string;
-		}
+			mainHtmlFile?: string | undefined;
+		} | undefined
 	): Promise<PdfDocument> {
 		return z.function()
 			.args(
@@ -254,8 +254,8 @@ export class PdfDocument{
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			renderOptions?: ChromePdfRenderOptions;
-		}
+			renderOptions?: ChromePdfRenderOptions | undefined;
+		} | undefined
 	): Promise<PdfDocument> {
 		return z.function()
 			.args(
@@ -283,7 +283,7 @@ export class PdfDocument{
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			imageToPdfOptions?: ImageToPdfOptions;
+			imageToPdfOptions?: ImageToPdfOptions | undefined;
 		}
 	): Promise<PdfDocument> {
 		return z.function()
@@ -318,7 +318,7 @@ export class PdfDocument{
 	 * @param filePath Target file path
 	 * @param saveOptions see {@link SaveOptions}
 	 */
-	public saveAs(filePath: string, saveOptions?: SaveOptions): Promise<void> {
+	public saveAs(filePath: string, saveOptions?: SaveOptions | undefined): Promise<void> {
 		return z.function()
 			.args(
 				stringSchema,
@@ -333,7 +333,7 @@ export class PdfDocument{
 	 * Saves the PdfDocument to a binary (Buffer)
 	 * @param saveOptions see {@link SaveOptions}
 	 */
-	public async saveAsBuffer(saveOptions?: SaveOptions): Promise<Buffer> {
+	public async saveAsBuffer(saveOptions?: SaveOptions | undefined): Promise<Buffer> {
 		return z.function()
 			.args(
 				saveOptionsSchema.optional()
@@ -402,8 +402,8 @@ export class PdfDocument{
 			/**
 			 * @default "all"
 			 */
-			pdfPageSelection?: PdfPageSelection;
-		}
+			pdfPageSelection?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		return z.function()
 			.args(
@@ -426,8 +426,8 @@ export class PdfDocument{
 			/**
 			 * @default "all"
 			 */
-			pdfPageSelection?: PdfPageSelection;
-		}
+			pdfPageSelection?: PdfPageSelection | undefined;
+		} | undefined
 	): Promise<void> {
 		return z.function()
 			.args(
@@ -522,7 +522,7 @@ export class PdfDocument{
 		 * @default "all"
 		 */
 		fromPages?: PdfPageSelection;
-	}): Promise<Buffer[]> {
+	} | undefined): Promise<Buffer[]> {
 		return z.function()
 			.args(
 				z.object({fromPages: pdfPageSelectionSchema.optional()}).optional()
@@ -544,12 +544,12 @@ export class PdfDocument{
 		/**
 		 * @default "all"
 		 */
-		fromPages?: PdfPageSelection;
+		fromPages?: PdfPageSelection | undefined;
 		/**
 		 * @default {@link ImageType.PNG}
 		 */
-		imageType?: ImageType;
-	}): Promise<Buffer[]> {
+		imageType?: ImageType | undefined;
+	} | undefined): Promise<Buffer[]> {
 		return z.function()
 			.args(
 				z.object({
@@ -577,12 +577,12 @@ export class PdfDocument{
 			/**
 			 * @default "all"
 			 */
-			fromPages?: PdfPageSelection;
+			fromPages?: PdfPageSelection | undefined;
 			/**
 			 * @default {@link ImageType.PNG}
 			 */
-			type?: ImageType;
-		}
+			type?: ImageType | undefined;
+		} | undefined
 	): Promise<string[]> {
 		return z.function()
 			.args(
@@ -609,7 +609,7 @@ export class PdfDocument{
 	public async replaceText(
 		oldText: string,
 		newText: string,
-		onPages?: PdfPageSelection
+		onPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return z.function()
 			.args(
@@ -622,7 +622,7 @@ export class PdfDocument{
 	}
 
 	public async extractText(
-		onPages?: PdfPageSelection
+		onPages?: PdfPageSelection | undefined
 	): Promise<string> {
 		return z.function()
 			.args(pdfPageSelectionSchema.optional())
@@ -638,7 +638,7 @@ export class PdfDocument{
 	 * Convert the current document into the specified PDF-A standard format
 	 * @param customICC (Optional) Custom color profile file path
 	 */
-	public async convertToPdfA(customICC?: string): Promise<void> {
+	public async convertToPdfA(customICC?: string | undefined): Promise<void> {
 		return z.function()
 			.args(z.string({description: "customICC: string"}).optional())
 			.returns(z.promise(z.void()))
@@ -748,7 +748,7 @@ export class PdfDocument{
 	 */
 	public async addTextHeader(
 		header: TextAffix,
-		toPages?: PdfPageSelection
+		toPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return z.function()
 			.args(textAffixSchema, pdfPageSelectionSchema.optional())
@@ -764,7 +764,7 @@ export class PdfDocument{
 	 */
 	public async addTextFooter(
 		footer: TextAffix,
-		toPages?: PdfPageSelection
+		toPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return z.function()
 			.args(textAffixSchema, pdfPageSelectionSchema.optional())
@@ -780,7 +780,7 @@ export class PdfDocument{
 	 */
 	public async addHtmlHeader(
 		header: HtmlAffix,
-		toPages?: PdfPageSelection
+		toPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return z.function()
 			.args(htmlAffixSchema, pdfPageSelectionSchema.optional())
@@ -796,7 +796,7 @@ export class PdfDocument{
 	 */
 	public async addHtmlFooter(
 		footer: HtmlAffix,
-		toPages?: PdfPageSelection
+		toPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return z.function()
 			.args(htmlAffixSchema, pdfPageSelectionSchema.optional())
@@ -816,9 +816,9 @@ export class PdfDocument{
 	public async stampHtml(
 		htmlStringOrHtmlFilePath: HtmlFilePath | HtmlString,
 		options?: {
-			htmlStampOptions?: HtmlStampOptions;
-			toPages?: PdfPageSelection;
-		}
+			htmlStampOptions?: HtmlStampOptions | undefined;
+			toPages?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		return z.function()
 			.args(z.union([htmlFilePathSchema, htmlStringSchema]), z.object({
@@ -838,9 +838,9 @@ export class PdfDocument{
 	public async stampImage(
 		image: ImageFilePath | ImageBuffer,
 		options?: {
-			imageStampOptions?: ImageStampOptions;
-			toPages?: PdfPageSelection;
-		}
+			imageStampOptions?: ImageStampOptions | undefined;
+			toPages?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		return z.function()
 			.args(z.union([imageFilePathSchema, imageBufferSchema]), z.object({
@@ -860,9 +860,9 @@ export class PdfDocument{
 	public async stampText(
 		text: string,
 		options?: {
-			textStampOptions?: TextStampOptions;
-			toPages?: PdfPageSelection;
-		}
+			textStampOptions?: TextStampOptions | undefined;
+			toPages?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		return z.function()
 			.args(stringSchema, z.object({
@@ -883,9 +883,9 @@ export class PdfDocument{
 		barcodeValue: string,
 		options?: {
 			barcodeEncoding: BarcodeType;
-			barcodeStampOptions?: BarcodeStampOptions;
-			toPages?: PdfPageSelection;
-		}
+			barcodeStampOptions?: BarcodeStampOptions | undefined;
+			toPages?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		return z.function()
 			.args(stringSchema, z.object({
@@ -912,7 +912,7 @@ export class PdfDocument{
 	public async addBackgroundFromAnotherPdf(
 		fromPdf: PdfDocument,
 		sourcePageIndex = 0,
-		applyToPages?: PdfPageSelection
+		applyToPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return z.function()
 			.args(pdfDocumentSchema, numberSchema, pdfPageSelectionSchema.optional())
@@ -932,7 +932,7 @@ export class PdfDocument{
 	public async addForegroundFromAnotherPdf(
 		fromPdf: PdfDocument,
 		sourcePageIndex = 0,
-		applyToPages?: PdfPageSelection
+		applyToPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return z.function()
 			.args(pdfDocumentSchema, numberSchema, pdfPageSelectionSchema.optional())
@@ -1033,25 +1033,25 @@ export class PdfDocument{
 	 * Internal PDF document ID
 	 * @private
 	 */
-	private pdfDocumentId?: string;
+	private pdfDocumentId?: string | undefined;
 	/**
 	 * @private
 	 */
-	private readonly promiseDocumentId?: Promise<string>;
+	private readonly promiseDocumentId?: Promise<string> | undefined;
 	/**
 	 * @private
 	 */
-	private pdfPassword?: PdfPassword;
+	private pdfPassword?: PdfPassword | undefined;
 
 	/**
 	 * Create a PdfDocument object from a {@link PdfInput}
 	 * For more specific way to create/open PdfDocument see {@link fromUrl} {@link fromZip} {@link fromHtml} {@link fromImage}  {@link open}
 	 *
-	 * @param pdfInput see {@link PdfInput} (required)
-	 * @param password a password to open the PDF required if PDF file was private (pdfInput is {@link PdfFilePath} or {@link Buffer})
+	 * @param pdfInput see {@link PdfInput} (required) (pdfInput is {@link PdfFilePath} or {@link Buffer})
+	 * @param password a password to open the PDF required if PDF file was private.
 	 * @param trackChanges Optionally track changes to the document (for use with incremental saves)
 	 */
-	constructor(pdfInput?: PdfInput, password?: PdfPassword, trackChanges?: ChangeTrackingModes) {
+	constructor(pdfInput?: PdfInput | undefined, password?: PdfPassword | undefined, trackChanges?: ChangeTrackingModes | undefined) {
 		if (pdfInput) {
 			this.pdfDocumentId = undefined;
 			const input = separatePdfInput(pdfInput);
@@ -1071,14 +1071,14 @@ export class PdfDocument{
 				case "buffer":
 					this.promiseDocumentId = openPdfFileBuffer(
 						input.buffer,
-						password
+						{userPassword: password?.userPassword, ownerPassword: password?.ownerPassword, trackChanges: trackChanges}
 					);
 					break;
 				case "pdfFile":
 					this.pdfPassword = password;
 					this.promiseDocumentId = openPdfFileBuffer(
 						fs.readFileSync(input.pdfFile),
-						password
+						{userPassword: password?.userPassword, ownerPassword: password?.ownerPassword, trackChanges: trackChanges}
 					);
 					break;
 				case "url":
@@ -1136,34 +1136,34 @@ export class PdfDocument{
 			 * required for open a private PDF file
 			 * @default undefined
 			 */
-			password?: PdfPassword;
+			password?: PdfPassword | undefined;
 			/**
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			renderOptions?: ChromePdfRenderOptions;
+			renderOptions?: ChromePdfRenderOptions | undefined;
 			/**
 			 * Apply httpLoginCredentials if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			httpLoginCredentials?: HttpLoginCredentials;
+			httpLoginCredentials?: HttpLoginCredentials | undefined;
 			/**
 			 * Apply mainHtmlFile if PdfInput is {@link ZipFilePath}
 			 * @default index.html
 			 */
-			mainHtmlFile?: string;
+			mainHtmlFile?: string | undefined;
 			/**
 			 * Optionally track changes to the document (for use with incremental saves)
 			 * @default {@link ChangeTrackingModes.AutoChangeTracking}
 			 */
-			trackChanges?: ChangeTrackingModes;
+			trackChanges?: ChangeTrackingModes | undefined;
 			// /**
 			//  * Apply baseUrl if
 			//  * The HTML base URL for which references to external CSS, Javascript and Image files will be relative.
 			//  * @default undefined
 			//  */
-			// baseUrl?: string;  //not supported
-		}
+			// baseUrl ?: string | undefined;  //not supported
+		} | undefined
 	): Promise<PdfDocument> {
 		if (pdfInput) {
 			const input = separatePdfInput(pdfInput);
@@ -1242,7 +1242,8 @@ export class PdfDocument{
 	 * @param Optionally track changes to the document (for use with incremental saves)
 	 */
 	private static async internal_fromFile(
-		pdfFilePath: string, trackChanges?: ChangeTrackingModes
+		pdfFilePath: string,
+		trackChanges?: ChangeTrackingModes | undefined
 	): Promise<PdfDocument> {
 		return this.internal_open(pdfFilePath, {trackChanges: trackChanges});
 	}
@@ -1259,8 +1260,8 @@ export class PdfDocument{
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			renderOptions?: ChromePdfRenderOptions;
-		}
+			renderOptions?: ChromePdfRenderOptions | undefined;
+		} | undefined
 	): Promise<PdfDocument> {
 		return this.internal_open(url, options);
 	}
@@ -1286,12 +1287,12 @@ export class PdfDocument{
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			renderOptions?: ChromePdfRenderOptions;
+			renderOptions?: ChromePdfRenderOptions | undefined;
 			/**
 			 * a main .html file default: `index.html`
 			 */
-			mainHtmlFile?: string;
-		}
+			mainHtmlFile?: string | undefined;
+		} | undefined
 	): Promise<PdfDocument> {
 		return this.internal_open(zipFilePath, options);
 	}
@@ -1308,8 +1309,8 @@ export class PdfDocument{
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			renderOptions?: ChromePdfRenderOptions;
-		}
+			renderOptions?: ChromePdfRenderOptions | undefined;
+		} | undefined
 	): Promise<PdfDocument> {
 		return this.internal_open(htmlStringOrHtmlFilePath, options);
 	}
@@ -1328,33 +1329,33 @@ export class PdfDocument{
 			 * Apply renderOptions if PdfInput is a {@link HtmlString} or {@link HtmlFilePath} or {@link ZipFilePath} or {@link Url}}
 			 * @default undefined
 			 */
-			imageToPdfOptions?: ImageToPdfOptions;
-		}
+			imageToPdfOptions?: ImageToPdfOptions | undefined;
+		} | undefined
 	): Promise<PdfDocument> {
 		let temp: Promise<string>;
 
 		if (Array.isArray(images)) {
 			// const imageArray = images as Array<any>;
-			if (images.length == 0) {
+			if(images[0]){
+				const t = separateImageBufferOrImagePathInput(images[0]);
+
+				switch (t.type) {
+					case "imageBuffer":
+						temp = renderImagesBufferToPdf(
+							images as Buffer[],
+							options?.imageToPdfOptions
+						);
+						break;
+					case "imageFilePath":
+						temp = renderImagesFilesToPdf(
+							images as string[],
+							options?.imageToPdfOptions
+						);
+						break;
+				}
+			}else{
 				throw new Error("imageToPdf input Array is Empty");
 			}
-
-			const t = separateImageBufferOrImagePathInput(images[0]);
-
-			switch (t.type) {
-				case "imageBuffer":
-					temp = renderImagesBufferToPdf(
-						images as Buffer[],
-						options?.imageToPdfOptions
-					);
-					break;
-				case "imageFilePath":
-					temp = renderImagesFilesToPdf(
-						images as string[],
-						options?.imageToPdfOptions
-					);
-					break;
-			}
 		} else {
 			const image = separateImageBufferOrImagePathInput(images);
 			switch (image.type) {
@@ -1402,7 +1403,7 @@ export class PdfDocument{
 	 * @param filePath Target file path
 	 * @param saveOptions see {@link SaveOptions}
 	 */
-	private async internal_saveAs(filePath: string, saveOptions?: SaveOptions): Promise<void> {
+	private async internal_saveAs(filePath: string, saveOptions?: SaveOptions | undefined): Promise<void> {
 		return this.internal_saveAsBuffer(saveOptions).then((pdfFileBuffer) => {
 			fs.writeFile(filePath, pdfFileBuffer, "binary", (err) => {
 				if (err) throw err;
@@ -1414,7 +1415,7 @@ export class PdfDocument{
 	 * Saves the PdfDocument to a binary (Buffer)
 	 * @param saveOptions see {@link SaveOptions}
 	 */
-	private async internal_saveAsBuffer(saveOptions?: SaveOptions): Promise<Buffer> {
+	private async internal_saveAsBuffer(saveOptions?: SaveOptions | undefined): Promise<Buffer> {
 		return getBinaryData(await this.internal_getId(), saveOptions);
 	}
 
@@ -1478,8 +1479,8 @@ export class PdfDocument{
 			/**
 			 * @default "all"
 			 */
-			pdfPageSelection?: PdfPageSelection;
-		}
+			pdfPageSelection?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		return await setPageRotation(await this.internal_getId(), pageRotation, options);
 	}
@@ -1495,8 +1496,8 @@ export class PdfDocument{
 			/**
 			 * @default "all"
 			 */
-			pdfPageSelection?: PdfPageSelection;
-		}
+			pdfPageSelection?: PdfPageSelection | undefined;
+		} | undefined
 	): Promise<void> {
 		return await resizePage(await this.internal_getId(), newSize, options);
 	}
@@ -1574,8 +1575,8 @@ export class PdfDocument{
 		/**
 		 * @default "all"
 		 */
-		fromPages?: PdfPageSelection;
-	}): Promise<Buffer[]> {
+		fromPages?: PdfPageSelection | undefined;
+	} | undefined): Promise<Buffer[]> {
 		return extractRawImages(
 			await this.internal_getId(),
 			options?.fromPages ?? "all"
@@ -1594,11 +1595,11 @@ export class PdfDocument{
 		/**
 		 * @default "all"
 		 */
-		fromPages?: PdfPageSelection;
+		fromPages?: PdfPageSelection | undefined;
 		/**
 		 * @default {@link ImageType.PNG}
 		 */
-		imageType?: ImageType;
+		imageType?: ImageType | undefined;
 	}): Promise<Buffer[]> {
 		const images = await rasterizeToImageBuffers(
 			await this.internal_getId(),
@@ -1640,29 +1641,24 @@ export class PdfDocument{
 			/**
 			 * @default "all"
 			 */
-			fromPages?: PdfPageSelection;
+			fromPages?: PdfPageSelection | undefined;
 			/**
 			 * @default {@link ImageType.PNG}
 			 */
-			type?: ImageType;
-		}
+			type?: ImageType | undefined;
+		} | undefined
 	): Promise<string[]> {
 		const images = await rasterizeToImageBuffers(
 			await this.internal_getId(),
 			options?.fromPages ?? "all"
 		);
-		const filesName = getFileNames(
-			filePath,
-			images.length,
-			getImageExtType(options?.type),
-			"image"
-		);
 
 		const promises = images.map(async (imageBuffer, index) => {
-			await Jimp.read(imageBuffer).then((value) =>
-				value.write(filesName[index])
-			);
-			return filesName[index];
+			const outputFileName = getFileName(filePath,index.toString(),getImageExtType(options?.type),"image");
+			await Jimp.read(imageBuffer).then((value) => {
+				return value.write(outputFileName);
+			});
+			return outputFileName;
 		});
 
 		return await Promise.all(promises);
@@ -1680,13 +1676,13 @@ export class PdfDocument{
 	private async internal_replaceText(
 		oldText: string,
 		newText: string,
-		onPages?: PdfPageSelection
+		onPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return replaceText(await this.internal_getId(), oldText, newText, onPages);
 	}
 
 	private async internal_extractText(
-		onPages?: PdfPageSelection
+		onPages?: PdfPageSelection | undefined
 	): Promise<string> {
 		return extractAllText(await this.internal_getId(), onPages);
 	}
@@ -1698,7 +1694,7 @@ export class PdfDocument{
 	 * Convert the current document into the specified PDF-A standard format
 	 * @param customICC (Optional) Custom color profile file path
 	 */
-	private async internal_convertToPdfA(customICC?: string): Promise<void> {
+	private async internal_convertToPdfA(customICC?: string | undefined): Promise<void> {
 		return await toPdfA(await this.internal_getId(), customICC);
 	}
 
@@ -1790,7 +1786,7 @@ export class PdfDocument{
 	 */
 	private async internal_addTextHeader(
 		header: TextAffix,
-		toPages?: PdfPageSelection
+		toPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		await addTextAffix(await this.internal_getId(), toPages, header, true);
 	}
@@ -1802,7 +1798,7 @@ export class PdfDocument{
 	 */
 	private async internal_addTextFooter(
 		footer: TextAffix,
-		toPages?: PdfPageSelection
+		toPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		await addTextAffix(await this.internal_getId(), toPages, footer, false);
 	}
@@ -1814,7 +1810,7 @@ export class PdfDocument{
 	 */
 	private async internal_addHtmlHeader(
 		header: HtmlAffix,
-		toPages?: PdfPageSelection
+		toPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		await addHtmlAffix(await this.internal_getId(), toPages, header, true);
 	}
@@ -1826,7 +1822,7 @@ export class PdfDocument{
 	 */
 	private async internal_addHtmlFooter(
 		footer: HtmlAffix,
-		toPages?: PdfPageSelection
+		toPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		await addHtmlAffix(await this.internal_getId(), toPages, footer, false);
 	}
@@ -1842,9 +1838,9 @@ export class PdfDocument{
 	private async internal_stampHtml(
 		htmlStringOrHtmlFilePath: HtmlFilePath | HtmlString,
 		options?: {
-			htmlStampOptions?: HtmlStampOptions;
-			toPages?: PdfPageSelection;
-		}
+			htmlStampOptions?: HtmlStampOptions | undefined;
+			toPages?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		const html =
 			htmlStringOrHtmlFilePath.endsWith(".html") ||
@@ -1867,9 +1863,9 @@ export class PdfDocument{
 	private async internal_stampImage(
 		image: ImageFilePath | ImageBuffer,
 		options?: {
-			imageStampOptions?: ImageStampOptions;
-			toPages?: PdfPageSelection;
-		}
+			imageStampOptions?: ImageStampOptions | undefined;
+			toPages?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		const imageBuffer =
 			image instanceof Buffer ? image : fs.readFileSync(image);
@@ -1889,9 +1885,9 @@ export class PdfDocument{
 	private async internal_stampText(
 		text: string,
 		options?: {
-			textStampOptions?: TextStampOptions;
-			toPages?: PdfPageSelection;
-		}
+			textStampOptions?: TextStampOptions | undefined;
+			toPages?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		await stampText(await this.internal_getId(), text, {
 			password: this.pdfPassword,
@@ -1909,9 +1905,9 @@ export class PdfDocument{
 		barcodeValue: string,
 		options?: {
 			barcodeEncoding: BarcodeType;
-			barcodeStampOptions?: BarcodeStampOptions;
-			toPages?: PdfPageSelection;
-		}
+			barcodeStampOptions?: BarcodeStampOptions | undefined;
+			toPages?: PdfPageSelection | undefined;
+		} | undefined
 	) {
 		await stampBarcode(
 			await this.internal_getId(),
@@ -1938,7 +1934,7 @@ export class PdfDocument{
 	private async internal_addBackgroundFromAnotherPdf(
 		fromPdf: PdfDocument,
 		sourcePageIndex = 0,
-		applyToPages?: PdfPageSelection
+		applyToPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return await addBackgroundForeground(
 			await this.internal_getId(),
@@ -1960,7 +1956,7 @@ export class PdfDocument{
 	private async internal_addForegroundFromAnotherPdf(
 		fromPdf: PdfDocument,
 		sourcePageIndex = 0,
-		applyToPages?: PdfPageSelection
+		applyToPages?: PdfPageSelection | undefined
 	): Promise<void> {
 		return await addBackgroundForeground(
 			await this.internal_getId(),