<?php

declare(strict_types=1);

namespace Lightscale\Router\Contracts;

use Lightscale\Router\RouteCall;
use Psr\Http\Message\RequestInterface;
use Psr\Http\Message\ResponseInterface;

interface Strategy
{
    /**
     * @param Middleware[] $middlewares
     * @param callable(RequestInterface): ResponseInterface $handler
     */
    public function runMiddleware(
        RequestInterface $request,
        array $middlewares,
        callable $handler,
    ): ResponseInterface;

    public function runRoute(RouteCall $call): ResponseInterface;

    public function notFound(RequestInterface $request): ResponseInterface;

    /**
     * @param array<string, mixed> $parameters
     *
     * @return array<string, string>
     */
    public function parseParameters(array $parameters): array;
}