feat: Document.ToBytesAsync() — in-memory PDF output (3.0.5)

CreatePdf.NET/CreatePdf.NET.csproj

@@ -7,7 +7,7 @@
 
     <PackageId>CreatePdf.NET</PackageId>
     <Title>CreatePdf.NET - Simple PDF Creation Library</Title>
-    <Version>3.0.4</Version>
+    <Version>3.0.5</Version>
     <Authors>Alexander Nachtmann</Authors>
     <Summary>Lightweight PDF generation library for .NET 10/9/8 with text rendering, bitmap graphics, and OCR</Summary>
     <Description>CreatePdf.NET is a simple, fast PDF creation library for .NET applications. Generate PDF documents with text rendering, bitmap graphics, and optional OCR text extraction. Lightweight, dependency-free, 100% test coverage. Perfect for creating reports, invoices, receipts, labels, and documents. Supports .NET 10, .NET 9, and .NET 8 with fluent C# API.</Description>

CreatePdf.NET/Document.cs

@@ -202,21 +202,37 @@ public async Task SaveAndShowDirectoryAsync(string? filename = null)
     }
 
     /// <summary>
-    ///     Saves the document to a PDF file.
+    ///     Renders the document to an in-memory PDF and returns its bytes, without touching the disk.
     /// </summary>
-    /// <param name="filename">Optional filename. If not provided, generates a timestamped name.</param>
-    /// <returns>The full path to the saved PDF file.</returns>
-    public async Task<string> SaveAsync(string? filename = null)
+    /// <returns>The complete PDF document as a byte array.</returns>
+    /// <example>
+    ///     <code>
+    /// byte[] pdf = await Pdf.Create(Dye.White)
+    ///     .AddText("Hello World")
+    ///     .ToBytesAsync();
+    /// </code>
+    /// </example>
+    public async Task<byte[]> ToBytesAsync()
     {
-        var path = FileOperations.GetOutputPath(filename);
-
-        await using var stream = File.Create(path);
+        await using var stream = new MemoryStream();
         await using var writer = new PdfWriter(stream, _background);
 
         foreach (var content in _contents)
             content.Render(writer);
 
         await writer.FinalizeAsync();
+        return stream.ToArray();
+    }
+
+    /// <summary>
+    ///     Saves the document to a PDF file.
+    /// </summary>
+    /// <param name="filename">Optional filename. If not provided, generates a timestamped name.</param>
+    /// <returns>The full path to the saved PDF file.</returns>
+    public async Task<string> SaveAsync(string? filename = null)
+    {
+        var path = FileOperations.GetOutputPath(filename);
+        await File.WriteAllBytesAsync(path, await ToBytesAsync());
         return path;
     }