File Core/Schema/RequestParams/SubscribeRequestParams.php

1:	<?php
2:
3:	declare(strict_types=1);
4:
5:	/**
6:	* This file is part of the Nexus MCP SDK package.
7:	*
8:	* (c) 2026 John Paul E. Balandan, CPA <paulbalandan@gmail.com>
9:	*
10:	* For the full copyright and license information, please view
11:	* the LICENSE file that was distributed with this source code.
12:	*/
13:
14:	namespace Nexus\Mcp\Core\Schema\RequestParams;
15:
16:	use Nexus\Assert\Assert;
17:	use Nexus\Mcp\Core\Schema\RequestMetaObject;
18:
19:	/**
20:	* Parameters for a `resources/subscribe` request.
21:	*
22:	* @see https://modelcontextprotocol.io/specification/2025-11-25/schema#subscriberequestparams
23:	*/
24:	final readonly class SubscribeRequestParams extends ResourceRequestParams
25:	{
26:	/**
27:	* @param array<string, mixed> $data
28:	*/
29:	#[\Override]
30:	public static function fromArray(array $data): static
31:	{
32:	Assert::that($data)->hasOffset('uri', 'missing the required "uri" key.');
33:	$uri = $data['uri'];
34:	Assert::that($uri)->isString('"params.uri" must be a string, {type} given.');
35:
36:	$meta = new RequestMetaObject();
37:
38:	if (\array_key_exists('_meta', $data)) {
39:	Assert::that($data['_meta'])
40:	->isArray('"params._meta" must be an object, {type} given.')
41:	->isMap('"params._meta" must be a string-keyed object.')
42:	;
43:	$meta = RequestMetaObject::fromArray($data['_meta']);
44:	}
45:
46:	return new self($uri, $meta);
47:	}
48:	}
49: