Ngstack 1017 schema processor

src/DependencyInjection/CompilerPass/SchemaProcessorCompilerPass.php

@@ -0,0 +1,41 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Netgen\ApiPlatformExtras\DependencyInjection\CompilerPass;
+
+use Netgen\ApiPlatformExtras\OpenApi\Factory\OpenApiFactory;
+use Symfony\Component\DependencyInjection\Argument\TaggedIteratorArgument;
+use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
+use Symfony\Component\DependencyInjection\Definition;
+use Symfony\Component\DependencyInjection\Reference;
+
+final class SchemaProcessorCompilerPass implements CompilerPassInterface
+{
+    private const FEATURE_ENABLED_PARAMETER = 'netgen_api_platform_extras.features.schema_processor.enabled';
+
+    public function process(ContainerBuilder $container): void
+    {
+        if (
+            !$container->hasParameter(self::FEATURE_ENABLED_PARAMETER)
+            || $container->getParameter(self::FEATURE_ENABLED_PARAMETER) === false
+        ) {
+            return;
+        }
+
+        $container
+            ->setDefinition(
+                OpenApiFactory::class,
+                new Definition(OpenApiFactory::class),
+            )
+            ->setArguments([
+                new Reference('api_platform.openapi.factory.inner'),
+                new TaggedIteratorArgument(
+                    tag: 'netgen_api_platform_extras.open_api_processor',
+                    defaultPriorityMethod: 'getPriority',
+                ),
+            ])
+            ->setDecoratedService('api_platform.openapi.factory', 'api_platform.openapi.factory.inner', -25);
+    }
+}

src/NetgenApiPlatformExtrasBundle.php

@@ -4,6 +4,20 @@
 
 namespace Netgen\ApiPlatformExtras;
 
+use Netgen\ApiPlatformExtras\DependencyInjection\CompilerPass\SchemaProcessorCompilerPass;
+use Netgen\ApiPlatformExtras\OpenApi\Processor\OpenApiProcessorInterface;
+use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\HttpKernel\Bundle\Bundle;
 
-final class NetgenApiPlatformExtrasBundle extends Bundle {}
+final class NetgenApiPlatformExtrasBundle extends Bundle
+{
+    public function build(ContainerBuilder $container): void
+    {
+        $container->addCompilerPass(
+            new SchemaProcessorCompilerPass(),
+        );
+
+        $container->registerForAutoconfiguration(OpenApiProcessorInterface::class)
+            ->addTag('netgen_api_platform_extras.open_api_processor');
+    }
+}

src/OpenApi/Factory/OpenApiFactory.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Netgen\ApiPlatformExtras\OpenApi\Factory;
+
+use ApiPlatform\OpenApi\Factory\OpenApiFactoryInterface;
+use ApiPlatform\OpenApi\OpenApi;
+use Netgen\ApiPlatformExtras\OpenApi\Processor\OpenApiProcessorInterface;
+
+final readonly class OpenApiFactory implements OpenApiFactoryInterface
+{
+    /**
+     * @param iterable<OpenApiProcessorInterface> $processors
+     */
+    public function __construct(
+        private OpenApiFactoryInterface $decorated,
+        private iterable $processors,
+    ) {}
+
+    public function __invoke(array $context = []): OpenApi
+    {
+        $openApi = ($this->decorated)($context);
+
+        return $this->applyProcessors($openApi);
+    }
+
+    private function applyProcessors(OpenApi $openApi): OpenApi
+    {
+        foreach ($this->processors as $processor) {
+            $openApi = $processor->process($openApi);
+        }
+
+        return $openApi;
+    }
+}

src/OpenApi/Processor/OpenApiProcessorInterface.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Netgen\ApiPlatformExtras\OpenApi\Processor;
+
+use ApiPlatform\OpenApi\OpenApi;
+
+interface OpenApiProcessorInterface
+{
+    /**
+     * Used in compiler pass to set the tagged items service priority.
+     */
+    public static function getPriority(): int;
+
+    /**
+     * Process the OpenAPI specification.
+     * Can modify schemas, paths, operations, or any other part of the spec.
+     */
+    public function process(OpenApi $openApi): OpenApi;
+}