<?php

declare(strict_types=1);

namespace App\Framework\Http;

use WeakMap;

final class MiddlewareStateManager
{
    /**
     * Creates a new middleware state manager.
     *
     * The WeakMap automatically garbage collects request states when
     * the associated Request objects are no longer referenced, preventing
     * memory leaks in long-running applications.
     *
     * @param WeakMap<object, mixed> $requestStates Storage for request-specific state data
     */
    public function __construct(
        private WeakMap $requestStates = new WeakMap()
    ) {
    }

    public function forRequest(Request $request): RequestStateManager
    {
        return new RequestStateManager($this->requestStates, $request);
    }
}