Getting the Pdf Format working properly

Added SetPdfUa in all the places it's supported. Added "Flatten" Support.

Author: Jaben

lib/Domain/Builders/BaseMergeBuilder.cs

@@ -1,4 +1,4 @@
-//  Copyright 2019-2025 Chris Mohan, Jaben Cargman
+// Copyright 2019-2025 Chris Mohan, Jaben Cargman
 //  and GotenbergSharpApiClient Contributors
 // 
 //  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,28 +13,11 @@
 //  See the License for the specific language governing permissions and
 //  limitations under the License.
 
-
-
 namespace Gotenberg.Sharp.API.Client.Domain.Builders;
 
-public abstract class BaseMergeBuilder<TRequest, TBuilder>(TRequest request)
-    : BaseBuilder<TRequest, TBuilder>(request)
-    where TRequest : BuildRequestBase
-    where TBuilder : BaseMergeBuilder<TRequest, TBuilder>
+public abstract class BaseMergeBuilder<TRequest, TBuilder>(TRequest request) : BaseBuilder<TRequest, TBuilder>(request)
+    where TRequest : BuildRequestBase where TBuilder : BaseMergeBuilder<TRequest, TBuilder>
 {
-    /// <summary>
-    ///     This tells gotenberg to have OfficeLibre perform the conversion.
-    ///     If you set <see cref="MergeOfficeRequest.UseNativePdfFormat" /> to true
-    ///     then gotenberg will hand the work off to unoconv to do the work
-    /// </summary>
-    
-    public TBuilder SetPdfFormat(PdfFormats format)
-    {
-        this.Request.Format = format;
-        return (TBuilder)this;
-    }
-
-    
     public TBuilder WithAssets(Action<AssetBuilder> action)
     {
         if (action == null) throw new ArgumentNullException(nameof(action));
@@ -44,13 +27,11 @@ public TBuilder WithAssets(Action<AssetBuilder> action)
         return (TBuilder)this;
     }
 
-    
     public TBuilder WithAsyncAssets(Func<AssetBuilder, Task> asyncAction)
     {
         if (asyncAction == null) throw new ArgumentNullException(nameof(asyncAction));
 
-        this.BuildTasks.Add(
-            asyncAction(new AssetBuilder(this.Request.Assets ??= new AssetDictionary())));
+        this.BuildTasks.Add(asyncAction(new AssetBuilder(this.Request.Assets ??= new AssetDictionary())));
 
         return (TBuilder)this;
     }

lib/Domain/Builders/Faceted/AssetBuilder.cs

@@ -1,4 +1,4 @@
-//  Copyright 2019-2025 Chris Mohan, Jaben Cargman
+// Copyright 2019-2025 Chris Mohan, Jaben Cargman
 //  and GotenbergSharpApiClient Contributors
 // 
 //  Licensed under the Apache License, Version 2.0 (the "License");
@@ -13,8 +13,6 @@
 //  See the License for the specific language governing permissions and
 //  limitations under the License.
 
-
-
 namespace Gotenberg.Sharp.API.Client.Domain.Builders.Faceted
 {
     public sealed class AssetBuilder
@@ -26,12 +24,10 @@ internal AssetBuilder(AssetDictionary assets)
             this._assets = assets;
         }
 
-        
         public AssetBuilder AddItem(string name, ContentItem value)
         {
             // ReSharper disable once ComplexConditionExpression
-            if (name.IsNotSet() || new FileInfo(name).Extension.IsNotSet()
-                                || name.LastIndexOf('/') >= 0)
+            if (name.IsNotSet() || new FileInfo(name).Extension.IsNotSet() || name.LastIndexOf('/') >= 0)
             {
                 throw new ArgumentOutOfRangeException(
                     nameof(name),
@@ -43,23 +39,16 @@ public AssetBuilder AddItem(string name, ContentItem value)
             return this;
         }
 
-        
-        public AssetBuilder AddItem(string name, string value) =>
-            AddItem(name, new ContentItem(value));
+        public AssetBuilder AddItem(string name, string value) => AddItem(name, new ContentItem(value));
 
-        
-        public AssetBuilder AddItem(string name, byte[] value) =>
-            AddItem(name, new ContentItem(value));
+        public AssetBuilder AddItem(string name, byte[] value) => AddItem(name, new ContentItem(value));
 
-        
-        public AssetBuilder AddItem(string name, Stream value) =>
-            AddItem(name, new ContentItem(value));
+        public AssetBuilder AddItem(string name, Stream value) => AddItem(name, new ContentItem(value));
 
         #region 'n' assets
 
         #region from dictionaries
 
-        
         public AssetBuilder AddItems(Dictionary<string, ContentItem>? items)
         {
             foreach (var item in items.IfNullEmpty())
@@ -70,47 +59,39 @@ public AssetBuilder AddItems(Dictionary<string, ContentItem>? items)
             return this;
         }
 
-        
         public AssetBuilder AddItems(Dictionary<string, string>? assets) =>
             AddItems(assets?.ToDictionary(a => a.Key, a => new ContentItem(a.Value)));
 
-        
         public AssetBuilder AddItems(Dictionary<string, byte[]>? assets) =>
             AddItems(assets?.ToDictionary(a => a.Key, a => new ContentItem(a.Value)));
 
-        
         public AssetBuilder AddItems(Dictionary<string, Stream>? assets) =>
             AddItems(assets?.ToDictionary(a => a.Key, a => new ContentItem(a.Value)));
 
         #endregion
 
         #region from KVP enumerables
 
-        
         public AssetBuilder AddItems(IEnumerable<KeyValuePair<string, ContentItem>> assets) =>
             AddItems(
                 new Dictionary<string, ContentItem>(
-                    assets?.ToDictionary(a => a.Key, a => a.Value) ??
-                    throw new ArgumentNullException(nameof(assets))));
+                    assets?.ToDictionary(a => a.Key, a => a.Value) ?? throw new ArgumentNullException(nameof(assets))));
 
-        
         public AssetBuilder AddItems(IEnumerable<KeyValuePair<string, string>> assets) =>
             AddItems(
                 new Dictionary<string, ContentItem>(
-                    assets?.ToDictionary(a => a.Key, a => new ContentItem(a.Value)) ??
-                    throw new ArgumentNullException(nameof(assets))));
+                    assets?.ToDictionary(a => a.Key, a => new ContentItem(a.Value))
+                    ?? throw new ArgumentNullException(nameof(assets))));
 
-        
         public AssetBuilder AddItems(IEnumerable<KeyValuePair<string, byte[]>> assets) =>
             AddItems(
-                assets?.ToDictionary(a => a.Key, a => new ContentItem(a.Value)) ??
-                throw new ArgumentNullException(nameof(assets)));
+                assets?.ToDictionary(a => a.Key, a => new ContentItem(a.Value))
+                ?? throw new ArgumentNullException(nameof(assets)));
 
-        
         public AssetBuilder AddItems(IEnumerable<KeyValuePair<string, Stream>> assets) =>
             AddItems(
-                assets?.ToDictionary(s => s.Key, a => new ContentItem(a.Value)) ??
-                throw new ArgumentNullException(nameof(assets)));
+                assets?.ToDictionary(s => s.Key, a => new ContentItem(a.Value))
+                ?? throw new ArgumentNullException(nameof(assets)));
 
         #endregion
 

lib/Domain/Builders/Faceted/ConfigBuilder.cs

@@ -1,4 +1,4 @@
-//  Copyright 2019-2025 Chris Mohan, Jaben Cargman
+// Copyright 2019-2025 Chris Mohan, Jaben Cargman
 //  and GotenbergSharpApiClient Contributors
 // 
 //  Licensed under the Apache License, Version 2.0 (the "License");
@@ -26,7 +26,6 @@ internal ConfigBuilder(RequestConfig requestConfig)
         this._requestConfig = requestConfig;
     }
 
-    
     public ConfigBuilder SetPageRanges(string? pageRanges)
     {
         this._requestConfig.PageRanges = Pages.PageRanges.Create(pageRanges);
@@ -41,14 +40,12 @@ public ConfigBuilder SetPageRanges(PageRanges? pageRanges)
         return this;
     }
 
-    
     [Obsolete("Renamed: Use SetPageRanges")]
     public ConfigBuilder PageRanges(string pageRanges)
     {
         return this.SetPageRanges(pageRanges);
     }
 
-    
     public ConfigBuilder SetResultFileName(string resultFileName)
     {
         if (resultFileName.IsNotSet())
@@ -59,13 +56,12 @@ public ConfigBuilder SetResultFileName(string resultFileName)
         return this;
     }
 
-    
     [Obsolete("Renamed: Use SetResultFileName")]
     public ConfigBuilder ResultFileName(string resultFileName)
     {
         return this.SetResultFileName(resultFileName);
     }
-    
+
     public ConfigBuilder SetTrace(string trace)
     {
         if (trace.IsNotSet())
@@ -93,7 +89,7 @@ public ConfigBuilder SetWebhook(Webhook webhook)
 
         return this;
     }
-    
+
     [Obsolete("Renamed: Use SetWebhook instead.")]
     public ConfigBuilder AddWebhook(Webhook webhook)
     {

lib/Domain/Builders/Faceted/ConversionPdfFormats.cs

@@ -0,0 +1,43 @@
+// Copyright 2019-2025 Chris Mohan, Jaben Cargman
+//  and GotenbergSharpApiClient Contributors
+// 
+//  Licensed under the Apache License, Version 2.0 (the "License");
+//  you may not use this file except in compliance with the License.
+//  You may obtain a copy of the License at
+// 
+//      http://www.apache.org/licenses/LICENSE-2.0
+// 
+//  Unless required by applicable law or agreed to in writing, software
+//  distributed under the License is distributed on an "AS IS" BASIS,
+//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//  See the License for the specific language governing permissions and
+//  limitations under the License.
+
+namespace Gotenberg.Sharp.API.Client.Domain.Builders.Faceted
+{
+    public enum ConversionPdfFormats
+    {
+        /// <summary>
+        /// No PDF conformance format specified.
+        /// </summary>
+        None = 0,
+
+        /// <summary>
+        /// PDF/A-1b format.
+        /// Long-term archiving conformance with basic visual reproducibility.
+        /// </summary>
+        A1b = 1,
+
+        /// <summary>
+        /// PDF/A-2b format.
+        /// Similar to A-2a but without requiring logical structure or tagging.
+        /// </summary>
+        A2b = 2,
+
+        /// <summary>
+        /// PDF/A-3b format.
+        /// Like A-3a but focused on visual fidelity, without logical tagging.
+        /// </summary>
+        A3b = 3,
+    }
+}

lib/Domain/Builders/Faceted/HtmlConversionBehaviorBuilder.cs

@@ -110,7 +110,7 @@ public HtmlConversionBehaviorBuilder AddAdditionalHeaders(JObject extraHeaders)
     /// <returns></returns>
     public HtmlConversionBehaviorBuilder SetMetadata(IDictionary<string, object> dictionary)
     {
-        SetMetadata(new JObject(dictionary));
+        SetMetadata(JObject.FromObject(dictionary));
 
         return this;
     }
@@ -121,7 +121,6 @@ public HtmlConversionBehaviorBuilder SetMetadata(IDictionary<string, object> dic
     /// </summary>
     /// <param name="metadata"></param>
     /// <returns></returns>
-
     public HtmlConversionBehaviorBuilder SetMetadata(JObject metadata)
     {
         if (metadata == null) throw new InvalidOperationException("metadata is null");
@@ -170,12 +169,22 @@ public HtmlConversionBehaviorBuilder SkipNetworkIdleEvent()
     /// <param name="format"></param>
     /// <returns></returns>
     /// <exception cref="InvalidOperationException"></exception>
-    public HtmlConversionBehaviorBuilder SetPdfFormat(PdfFormats format)
+    public HtmlConversionBehaviorBuilder SetPdfFormat(ConversionPdfFormats format)
     {
         if (format == default) throw new InvalidOperationException("Invalid PDF format specified");
 
         this._htmlConversionBehaviors.PdfFormat = format;
 
         return this;
     }
+
+    /// <summary>
+    ///     This tells gotenberg to enable Universal Access for the resulting PDF.
+    /// </summary>
+    public HtmlConversionBehaviorBuilder SetPdfUa(bool enablePdfUa = true)
+    {
+        this._htmlConversionBehaviors.EnablePdfUa = enablePdfUa;
+
+        return this;
+    }
 }

lib/Domain/Builders/Faceted/LibrePdfFormats.cs

@@ -0,0 +1,79 @@
+// Copyright 2019-2025 Chris Mohan, Jaben Cargman
+//  and GotenbergSharpApiClient Contributors
+// 
+//  Licensed under the Apache License, Version 2.0 (the "License");
+//  you may not use this file except in compliance with the License.
+//  You may obtain a copy of the License at
+// 
+//      http://www.apache.org/licenses/LICENSE-2.0
+// 
+//  Unless required by applicable law or agreed to in writing, software
+//  distributed under the License is distributed on an "AS IS" BASIS,
+//  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+//  See the License for the specific language governing permissions and
+//  limitations under the License.
+
+using System.Diagnostics.CodeAnalysis;
+
+namespace Gotenberg.Sharp.API.Client.Domain.Builders.Faceted;
+
+[SuppressMessage("ReSharper", "InconsistentNaming")]
+public enum LibrePdfFormats
+{
+    /// <summary>
+    /// No PDF conformance format specified.
+    /// </summary>
+    None = 0,
+
+    /// <summary>
+    /// PDF/A-1a format.
+    /// Ensures accessibility and document structure (tagged PDF).
+    /// Obsolete as of Gotenberg 7.6 — LibreOffice no longer supports it.
+    /// </summary>
+    [Obsolete(
+        "Beginning with version Gotenberg 7.6, LibreOffice has discontinued support for PDF/A-1a: https://gotenberg.dev/docs/troubleshooting#pdfa-1a")]
+    A1a = 1,
+
+    /// <summary>
+    /// PDF/A-1b format.
+    /// Long-term archiving conformance with basic visual reproducibility.
+    /// </summary>
+    A1b = 2,
+
+    /// <summary>
+    /// PDF/A-2a format.
+    /// Builds on A-1a with improved compression and transparency support; includes tagged structure.
+    /// </summary>
+    A2a = 3,
+
+    /// <summary>
+    /// PDF/A-2b format.
+    /// Similar to A-2a but without requiring logical structure or tagging.
+    /// </summary>
+    A2b = 4,
+
+    /// <summary>
+    /// PDF/A-2u format.
+    /// Like A-2b but requires Unicode mapping for all text (for searchability).
+    /// </summary>
+    A2u = 5,
+
+    /// <summary>
+    /// PDF/A-3a format.
+    /// Allows embedded files; includes full tagging for accessibility.
+    /// Useful for workflows that require attaching source data (e.g., XML, spreadsheets).
+    /// </summary>
+    A3a = 6,
+
+    /// <summary>
+    /// PDF/A-3b format.
+    /// Like A-3a but focused on visual fidelity, without logical tagging.
+    /// </summary>
+    A3b = 7,
+
+    /// <summary>
+    /// PDF/A-3u format.
+    /// Combines A-3b conformance with Unicode text requirements.
+    /// </summary>
+    A3u = 8
+}

lib/Domain/Builders/Faceted/PagePropertyBuilder.cs

@@ -269,10 +269,5 @@ public PagePropertyBuilder UseChromeDefaults()
         return this.SetPageProperties(PageProperties.ToChromeDefaults());
     }
 
-    public PagePropertyBuilder UseDeliverableDefaults()
-    {
-        return this.SetPageProperties(PageProperties.ToDeliverableDefault());
-    }
-
     #endregion
 }