{

#[TestDox('a non-positive initialization timeout of $seconds seconds is rejected')]

#[DataProvider('provideNonPositiveTimeouts')]

public function testNonPositiveInitTimeoutIsRejected(int $seconds): void

{

$this->expectException(InvalidArgumentException::class);

$this->expectExceptionMessage(\sprintf('The initialization timeout must be a positive number of seconds, got %d.', $seconds));

$this->createConfiguration(initTimeout: $seconds);

}

#[TestDox('a non-positive request timeout of $seconds seconds is rejected')]

#[DataProvider('provideNonPositiveTimeouts')]

public function testNonPositiveRequestTimeoutIsRejected(int $seconds): void

{

$this->expectException(InvalidArgumentException::class);

$this->expectExceptionMessage(\sprintf('The request timeout must be a positive number of seconds, got %d.', $seconds));

$this->createConfiguration(requestTimeout: $seconds);

}

/**

public static function provideNonPositiveTimeouts(): iterable

{

yield 'zero' => [0];

yield 'negative' => [-1];

}

#[TestDox('prefers the modern era and falls back to the newest handshake revision by default')]

public function testDefaultsToModernWithHandshakeFallback(): void

{

$config = new Configuration(new Implementation('client', '1.0.0'), new ClientCapabilities());

$this->assertSame(ProtocolVersion::V2026_07_28, $config->protocolVersion);

$this->assertSame(ProtocolVersion::latestHandshake(), $config->fallbackProtocolVersion);

}

#[TestDox('a modern revision cannot be the handshake fallback')]

public function testModernFallbackIsRejected(): void

{

$this->expectException(InvalidArgumentException::class);

$this->expectExceptionMessage('The fallback protocol version must be one reached through the "initialize" handshake, got "2026-07-28".');

new Configuration(new Implementation('client', '1.0.0'), new ClientCapabilities(), fallbackProtocolVersion: ProtocolVersion::V2026_07_28);

}

#[TestDox('the builder rejects a non-positive initialization timeout')]

public function testBuilderRejectsNonPositiveInitTimeout(): void

{

$builder = Client::builder()->setInitTimeout(0);

$this->expectException(InvalidArgumentException::class);

$builder->build();

}

#[TestDox('the builder rejects a non-positive request timeout')]

public function testBuilderRejectsNonPositiveRequestTimeout(): void

{

$builder = Client::builder()->setRequestTimeout(-5);

$this->expectException(InvalidArgumentException::class);

$builder->build();

}

#[TestDox('positive timeouts are accepted')]

public function testPositiveTimeoutsAreAccepted(): void

{

$config = $this->createConfiguration(initTimeout: 1, requestTimeout: 1);

$this->assertSame(1, $config->initTimeout);

$this->assertSame(1, $config->requestTimeout);

}

private function createConfiguration(int $initTimeout = 30, int $requestTimeout = 120): Configuration

{

return new Configuration(

clientInfo: new Implementation('test-client', '1.0.0'),

capabilities: new ClientCapabilities(),

initTimeout: $initTimeout,

requestTimeout: $requestTimeout,

);

}