Feature: Headers support for OpenApi and Postman parsers

src/Contracts/Parser.php

@@ -7,4 +7,6 @@
 interface Parser
 {
     public function parse(): ApiSpecification;
+
+    public function getExcludedHeaders(): array;
 }

src/Data/Generator/Endpoint.php

@@ -8,6 +8,7 @@ class Endpoint
      * @param  Parameter[]  $queryParameters
      * @param  Parameter[]  $pathParameters
      * @param  Parameter[]  $bodyParameters
+     * @param  Parameter[]  $headerParameters
      */
     public function __construct(
         public string $name,
@@ -22,6 +23,7 @@ public function __construct(
         public array $queryParameters = [],
         public array $pathParameters = [],
         public array $bodyParameters = [],
+        public array $headerParameters = [],
     ) {
     }
 
@@ -34,6 +36,7 @@ public function allParameters(): array
             ...$this->pathParameters,
             ...$this->bodyParameters,
             ...$this->queryParameters,
+            ...$this->headerParameters,
         ];
     }
 

src/Generators/RequestGenerator.php

@@ -120,6 +120,20 @@ protected function generateRequestClass(Endpoint $endpoint): PhpFile
             MethodGeneratorHelper::generateArrayReturnMethod($classType, 'defaultQuery', $queryParams, withArrayFilterWrapper: true);
         }
 
+        // Priority 4. - Header Parameters
+        if (! empty($endpoint->headerParameters)) {
+            $headerParams = collect($endpoint->headerParameters)
+                ->reject(fn (Parameter $parameter) => in_array($parameter->name, $this->config->ignoredQueryParams))
+                ->values()
+                ->toArray();
+
+            foreach ($headerParams as $headerParam) {
+                MethodGeneratorHelper::addParameterAsPromotedProperty($classConstructor, $headerParam);
+            }
+
+            MethodGeneratorHelper::generateArrayReturnMethod($classType, 'defaultHeaders', $headerParams, withArrayFilterWrapper: true);
+        }
+
         $namespace
             ->addUse(SaloonHttpMethod::class)
             ->addUse(DateTime::class)

src/Parsers/OpenApiParser.php

@@ -76,17 +76,18 @@ protected function parseEndpoint(Operation $operation, $pathParams, string $path
             // TODO: Check if this differs between spec versions
             pathParameters: $pathParams + $this->mapParams($operation->parameters, 'path'),
             bodyParameters: [], // TODO: implement "definition" parsing
+            headerParameters: $this->mapParams($operation->parameters, 'header', $this->getExcludedHeaders()),
         );
     }
 
     /**
      * @param  OpenApiParameter[]  $parameters
      * @return Parameter[] array
      */
-    protected function mapParams(array $parameters, string $in): array
+    protected function mapParams(array $parameters, string $in, array $exclude = []): array
     {
         return collect($parameters)
-            ->filter(fn (OpenApiParameter $parameter) => $parameter->in == $in)
+            ->filter(fn (OpenApiParameter $parameter) => $parameter->in == $in && ! in_array($parameter->name, $exclude))
             ->map(fn (OpenApiParameter $parameter) => new Parameter(
                 type: $this->mapSchemaTypeToPhpType($parameter->schema?->type),
                 nullable: $parameter->required == false,
@@ -107,4 +108,9 @@ protected function mapSchemaTypeToPhpType($type): string
             default => 'mixed',
         };
     }
+
+    public function getExcludedHeaders(): array
+    {
+        return ['Authorization', 'Content-Type', 'Accept'];
+    }
 }

src/Parsers/PostmanCollectionParser.php

@@ -80,7 +80,7 @@ public function parseEndpoint(Item $item): ?Endpoint
             queryParameters: $this->parseQueryParameters($item),
             pathParameters: $this->parsePathParameters($item),
             bodyParameters: $this->parseBodyParameters($item),
-
+            headerParameters: $this->parseHeaderParameters($item),
         );
     }
 
@@ -151,4 +151,34 @@ protected function parseBodyParameters(Item $item): array
             })
             ->toArray();
     }
+
+    protected function parseHeaderParameters(Item $item): array
+    {
+        return collect($item->request->header)
+            ->map(function ($param) {
+                $headerName = Arr::get($param, 'key');
+                if (! $headerName) {
+                    return null;
+                }
+
+                // Exclude headers already handled in Connectors
+                if (in_array($headerName, $this->getExcludedHeaders())) {
+                    return null;
+                }
+
+                return new Parameter(
+                    type: 'string',
+                    nullable: false,
+                    name: $headerName,
+                );
+            })
+            ->filter()
+            ->values()
+            ->toArray();
+    }
+
+    public function getExcludedHeaders(): array
+    {
+        return ['Authorization', 'Content-Type', 'Accept'];
+    }
 }