convertkit / vendor / wordpress / php-mcp-schema / src / Server / Resources / DTO / ResourceUpdatedNotification.php

ResourceUpdatedNotification.php in Kit (formerly ConvertKit) – Email Newsletter, Email Marketing, Membership, Subscribers and Landing Pages 3.4.3, at vendor/wordpress/php-mcp-schema/src/Server/Resources/DTO/ResourceUpdatedNotification.php

98 lines 2.9 KB

Raw Download Zip

1	<?php
2
3	declare(strict_types=1);
4
5	namespace WP\McpSchema\Server\Resources\DTO;
6
7	use WP\McpSchema\Common\JsonRpc\DTO\JSONRPCNotification;
8	use WP\McpSchema\Common\Traits\ValidatesRequiredFields;
9	use WP\McpSchema\Server\Lifecycle\Union\ServerNotificationInterface;
10
11	/**
12	* A notification from the server to the client, informing it that a resource has changed and may need to be read again. This should only be sent if the client previously sent a resources/subscribe request.
13	*
14	* @since 2024-11-05
15	* @last-updated 2025-11-25 (modified property: params)
16	*
17	* @mcp-domain Server
18	* @mcp-subdomain Resources
19	* @mcp-version 2025-11-25
20	*/
21	class ResourceUpdatedNotification extends JSONRPCNotification implements ServerNotificationInterface
22	{
23	use ValidatesRequiredFields;
24
25	public const METHOD = 'notifications/resources/updated';
26
27	public const DISCRIMINATOR_FIELD = 'method';
28	public const DISCRIMINATOR_VALUE = 'notifications/resources/updated';
29
30	/**
31	* @var \WP\McpSchema\Server\Resources\DTO\ResourceUpdatedNotificationParams
32	*/
33	protected ResourceUpdatedNotificationParams $typedParams;
34
35	/**
36	* @param '2.0' $jsonrpc @since 2025-11-25
37	* @param \WP\McpSchema\Server\Resources\DTO\ResourceUpdatedNotificationParams $params @since 2024-11-05
38	*/
39	public function __construct(
40	string $jsonrpc,
41	ResourceUpdatedNotificationParams $params
42	) {
43	parent::__construct(self::METHOD, $jsonrpc, null);
44	$this->typedParams = $params;
45	}
46
47	/**
48	* Creates an instance from an array.
49	*
50	* @param array{
51	* jsonrpc: '2.0',
52	* method: 'notifications/resources/updated',
53	* params: array<string, mixed>\|\WP\McpSchema\Server\Resources\DTO\ResourceUpdatedNotificationParams
54	* } $data
55	* @phpstan-param array<string, mixed> $data
56	* @return self
57	*/
58	public static function fromArray(array $data): self
59	{
60	self::assertRequired($data, ['jsonrpc', 'params']);
61
62	/** @var '2.0' $jsonrpc */
63	$jsonrpc = self::asString($data['jsonrpc']);
64
65	/** @var \WP\McpSchema\Server\Resources\DTO\ResourceUpdatedNotificationParams $params */
66	$params = is_array($data['params'])
67	? ResourceUpdatedNotificationParams::fromArray(self::asArray($data['params']))
68	: $data['params'];
69
70	return new self(
71	$jsonrpc,
72	$params
73	);
74	}
75
76	/**
77	* Converts the instance to an array.
78	*
79	* @return array<string, mixed>
80	*/
81	public function toArray(): array
82	{
83	$result = parent::toArray();
84
85	$result['params'] = $this->typedParams->toArray();
86
87	return $result;
88	}
89
90	/**
91	* @return \WP\McpSchema\Server\Resources\DTO\ResourceUpdatedNotificationParams
92	*/
93	public function getTypedParams(): ResourceUpdatedNotificationParams
94	{
95	return $this->typedParams;
96	}
97	}
98