Path.php

<?php
namespace WPOpenAPI\Spec;

use WPOpenAPI\Filters;

class Path {
	/**
	 * @var string
	 */
	private string $path;

	/**
	 * @var Operation[]
	 */
	private array $operations = array();
	private string $originalPath;
	private array $pathVariables = array();
	private ?string $schemaRef;

	public function __construct(
		string $path,
		string $schemaRef = null
	) {
		$this->originalPath = $path;
		$this->path         = $this->replacePathVariable( $path );
		if ( $schemaRef ) {
			$this->schemaRef = '#/components/schemas/' . $schemaRef;
		}
	}

	public function replacePathVariable( string $path ): string {
		if ( str_contains( $path, '(?P<' ) ) {
			$path = trim( $path, '?' );
			$path = preg_replace_callback(
				'/\(.*?<([^<>]*)>.*?\)(?=\/|$|\+)/',
				function ( $match ) {
					$this->pathVariables[] = $match[1];
					return '{' . $match[1] . '}';
				},
				$path
			);
			// it's possible that the path still have unwanted chars left
			// after the preg replacement. Clean them up.
			// @todo -- find a better regex that works for all
			 $path = str_replace( array( '(', ')', '?' ), '', $path );
		}

		return $path;
	}

	public function getOperations(): array {
		return $this->operations;
	}

	public function generateOperationsFromRouteArgs( $args, $routeResponses = null ): void {
		foreach ( $args as $arg ) {
			$responses = array();
			
			// Check if custom responses are provided
			if ( $routeResponses && is_array( $routeResponses ) ) {
				// Process custom responses from route registration
				foreach ( $routeResponses as $code => $responseDef ) {
					$code        = (int) $code;
					$description = $responseDef['description'] ?? '';
					$response    = new Response( $code, $description );
					
					// Process content/schema for each response
					if ( isset( $responseDef['content'] ) && is_array( $responseDef['content'] ) ) {
						foreach ( $responseDef['content'] as $mediaType => $contentDef ) {
							$schema  = $contentDef['schema'] ?? array();
							$example = $contentDef['example'] ?? null;
							$content = new ResponseContent( $mediaType, $schema, $example );
							$response->addContent( $content );
						}
					}
					
					$responses[] = $response;
				}
			} elseif ( ! empty( $this->schemaRef ) ) {
				// Fallback to schema reference if no custom responses
				$content  = new ResponseContent(
					'application/json',
					array(
						'$ref' => $this->schemaRef,
					)
				);
				$response = new Response( 200, 'OK' );
				$response->addContent( $content );
				$responses[] = $response;

			} else {
				// Default response
				$responses[] = new Response( 200, 'OK' );
			}

			foreach ( $arg['methods'] as $method => $value ) {
				$description = $arg['description'] ?? '';
				$method      = strtolower( $method );
				if($method == 'options') continue;
				$op          = new Operation( $method, $responses, $this->path );
				$op->setDescription( $description );
				$op->generateParametersFromRouteArgs( $method, $arg['args'], $this->pathVariables );
                if ( isset( $arg['security']) && is_array( $arg['security'] ) ) {
                    foreach ( $arg['security'] as $name => $values) {
                        $op->addSecurity( $name, $values );
                    }
                }
				$this->operations[] = $op;
			}
		}

		$this->operations = Filters::getInstance()->applyOperationsFilters( $this->operations );
	}

	public function getOriginalPath(): string {
		return $this->originalPath;
	}

	public function getPath(): string {
		return $this->path;
	}

	public function toArray(): array {
		$data = array();
		foreach ( $this->operations as $operation ) {
			$data[ $operation->getMethod() ] = $operation->toArray();
		}

		return $data;
	}
}