[UPDATE] Some minor changes

.phpstorm.meta.php

@@ -0,0 +1,10 @@
+<?php
+
+namespace PHPSTORM_META {
+    expectedArguments(
+        \Sensiolabs\GotenbergBundle\Builder\AbstractPdfBuilder::fileName(),
+        1,
+        \Symfony\Component\HttpFoundation\HeaderUtils::DISPOSITION_INLINE,
+        \Symfony\Component\HttpFoundation\HeaderUtils::DISPOSITION_ATTACHMENT,
+    );
+}

config/services.php

@@ -16,6 +16,7 @@
 use function Symfony\Component\DependencyInjection\Loader\Configurator\abstract_arg;
 use function Symfony\Component\DependencyInjection\Loader\Configurator\param;
 use function Symfony\Component\DependencyInjection\Loader\Configurator\service;
+use function Symfony\Component\DependencyInjection\Loader\Configurator\tagged_locator;
 
 return function (ContainerConfigurator $container): void {
     $services = $container->services();
@@ -81,7 +82,7 @@
 
     $services->set('sensiolabs_gotenberg', Gotenberg::class)
         ->args([
-            abstract_arg('All builders indexed by class FQCN')
+            tagged_locator('sensiolabs_gotenberg.builder'),
         ])
         ->alias(GotenbergInterface::class, 'sensiolabs_gotenberg')
     ;

src/Builder/AbstractChromiumPdfBuilder.php

@@ -194,6 +194,7 @@ public function nativePageRanges(string $range): static
     }
 
     /**
+     * @param string $template #Template
      * @param array<string, mixed> $context
      *
      * @throws PdfPartRenderingException if the template could not be rendered
@@ -204,6 +205,7 @@ public function header(string $template, array $context = []): static
     }
 
     /**
+     * @param string $template #Template
      * @param array<string, mixed> $context
      *
      * @throws PdfPartRenderingException if the template could not be rendered
@@ -439,6 +441,7 @@ protected function withPdfPartFile(PdfPart $pdfPart, string $path): static
     }
 
     /**
+     * @param string $template #Template
      * @param array<string, mixed> $context
      *
      * @throws PdfPartRenderingException if the template could not be rendered

src/Builder/HtmlPdfBuilder.php

@@ -11,6 +11,7 @@ final class HtmlPdfBuilder extends AbstractChromiumPdfBuilder
     private const ENDPOINT = '/forms/chromium/convert/html';
 
     /**
+     * @param string $template #Template
      * @param array<string, mixed> $context
      *
      * @throws PdfPartRenderingException if the template could not be rendered

src/Builder/MarkdownPdfBuilder.php

@@ -15,6 +15,7 @@ final class MarkdownPdfBuilder extends AbstractChromiumPdfBuilder
     /**
      * The HTML file that wraps the markdown content, rendered from a Twig template.
      *
+     * @param string $template #Template
      * @param array<string, mixed> $context
      *
      * @throws PdfPartRenderingException if the template could not be rendered

src/Client/PdfResponse.php

@@ -2,9 +2,7 @@
 
 namespace Sensiolabs\GotenbergBundle\Client;
 
-use Symfony\Component\Filesystem\Filesystem;
 use Symfony\Component\HttpFoundation\Response;
-use Symfony\Component\HttpKernel\Exception\HttpException;
 use Symfony\Contracts\HttpClient\ResponseInterface;
 
 class PdfResponse extends Response
@@ -13,17 +11,4 @@ public function __construct(public ResponseInterface $response)
     {
         parent::__construct($response->getContent(), $response->getStatusCode(), $response->getHeaders());
     }
-
-    public function saveTo(string $filename): string
-    {
-        $file = new Filesystem();
-
-        try {
-            $file->dumpFile($filename, $this->response->getContent());
-        } catch (\Exception $exception) {
-            throw new HttpException(500, $exception->getMessage());
-        }
-
-        return $filename;
-    }
 }

src/DependencyInjection/SensiolabsGotenbergExtension.php

@@ -44,9 +44,11 @@ public function load(array $configs, ContainerBuilder $container): void
     }
 
     /**
-     * @param array<string, mixed> $userConfigurations
+     * @template T of array<string, mixed>
      *
-     * @return array<string, mixed>
+     * @param T $userConfigurations
+     *
+     * @return array<key-of<T>, value-of<T>>
      */
     private function cleanUserOptions(array $userConfigurations): array
     {

src/Pdf/Gotenberg.php

@@ -21,23 +21,39 @@ public function get(string $builder): PdfBuilderInterface
         return $this->container->get($builder);
     }
 
+    /**
+     * @param 'html'|'url'|'markdown'|'office' $key
+     *
+     * @return (
+     *     $key is 'html' ? HtmlPdfBuilder :
+     *     $key is 'url' ? UrlPdfBuilder :
+     *     $key is 'office' ? LibreOfficePdfBuilder :
+     *     $key is 'markdown' ? MarkdownPdfBuilder :
+     *      PdfBuilderInterface
+     * )
+     */
+    private function getInternal(string $key): PdfBuilderInterface
+    {
+        return $this->get(".sensiolabs_gotenberg.builder.{$key}");
+    }
+
     public function html(): HtmlPdfBuilder
     {
-        return $this->get(HtmlPdfBuilder::class);
+        return $this->getInternal('html');
     }
 
     public function url(): UrlPdfBuilder
     {
-        return $this->get(UrlPdfBuilder::class);
+        return $this->getInternal('url');
     }
 
     public function office(): LibreOfficePdfBuilder
     {
-        return $this->get(LibreOfficePdfBuilder::class);
+        return $this->getInternal('office');
     }
 
     public function markdown(): MarkdownPdfBuilder
     {
-        return $this->get(MarkdownPdfBuilder::class);
+        return $this->getInternal('markdown');
     }
 }

src/Pdf/GotenbergInterface.php

@@ -13,9 +13,9 @@ interface GotenbergInterface
     /**
      * @template T of PdfBuilderInterface
      *
-     * @param class-string<T> $builder
+     * @param string|class-string<T> $builder
      *
-     * @return T
+     * @return ($builder is class-string<T> ? T : PdfBuilderInterface)
      */
     public function get(string $builder): PdfBuilderInterface;
 

src/SensiolabsGotenbergBundle.php

@@ -2,14 +2,8 @@
 
 namespace Sensiolabs\GotenbergBundle;
 
-use Sensiolabs\GotenbergBundle\DependencyInjection\CompilerPass\ProcessBuildersPass;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\HttpKernel\Bundle\Bundle;
 
 class SensiolabsGotenbergBundle extends Bundle
 {
-    public function build(ContainerBuilder $container)
-    {
-        $container->addCompilerPass(new ProcessBuildersPass());
-    }
 }