pdflib-syntax-document

To load and save a PDF without losing original metadata, use the `updateMetadata: false` option when loading the document. This preserves archival fields like title, author, and keywords during modification, preventing unintentional overwrites when you await the final save operation.

Silent save failures occur when pdf-lib asynchronous APIs are not awaited. You must await the `save` or `saveAsBase64` methods to ensure the PDF binary or base64 output is fully processed before the workflow continues, preventing data loss.

For browser contexts, use `saveAsBase64` to generate a data URI suitable for downloads or embedding. Binary saves are intended for Node.js file system workflows, ensuring the output format matches your platform's compatibility requirements.

Yes, you can load encrypted PDFs by passing the `ignoreEncryption: true` option during the load operation. This allows you to access and modify the document contents, though it bypasses the encryption layer rather than decrypting it for re-saving.

The best way to attach files to a PDF is to load the document bytes, call the attachment methods provided by pdf-lib, and then await the `save` operation with `useObjectStreams` configured to meet your compatibility and preservation requirements.

Yes, pdf-lib works with both JavaScript and TypeScript workflows in Node.js and browser contexts. It handles tasks like creating new PDFs, preserving metadata, attaching files, and producing binary or base64 outputs across these environments.