Create New Item
Item Type
File
Folder
Item Name
Search file in folder and subfolders...
Are you sure want to rename?
File Manager
/
wp-content
/
plugins
/
elementor
/
vendor
/
wordpress
/
php-mcp-schema
/
src
:
Schema.php
Advanced Search
Upload
New Item
Settings
Back
Back Up
Advanced Editor
Save
<?php declare(strict_types=1); namespace WP\McpSchema; use WP\McpSchema\Exception\UnavailableTypeException; use WP\McpSchema\Internal\JsonDecoder; use WP\McpSchema\Internal\SchemaInterpreter; use WP\McpSchema\Internal\TypeRegistry; /** * One immutable, exact MCP revision schema. */ final class Schema { /** @var string */ private $version; /** @var array<string, array<string, mixed>> */ private $definitions; /** * @var array{ * clientToServer: array{requests: array<string, string>, notifications: array<string, string>}, * serverToClient: array{requests: array<string, string>, notifications: array<string, string>}, * embeddedInputs: array<string, string> * } */ private $messageAvailability; /** @var array<string, array{definition: string, versions: array<int, string>}> */ private $records; /** @var array<string, array{definition: string, versions: array<int, string>}> */ private $contracts; /** @var SchemaInterpreter */ private $interpreter; /** * @param array<string, mixed> $document * @param array{ * clientToServer: array{requests: array<string, string>, notifications: array<string, string>}, * serverToClient: array{requests: array<string, string>, notifications: array<string, string>}, * embeddedInputs: array<string, string> * } $messageAvailability */ private function __construct(string $version, array $document, array $messageAvailability) { if (! isset($document['$defs']) || ! is_array($document['$defs'])) { throw new \LogicException(sprintf('Catalog %s has no definitions.', $version)); } $this->version = $version; $this->definitions = $document['$defs']; $this->messageAvailability = $messageAvailability; $this->records = TypeRegistry::records(); $this->contracts = TypeRegistry::contracts(); $this->interpreter = new SchemaInterpreter($this->definitions, $version, $this->records); } public function version(): string { return $this->version; } /** * @template T of object * @param class-string<T> $rootClass * @param array<array-key, mixed> $value * @return T */ public function fromArray(string $rootClass, array $value) { return $this->hydrate($rootClass, $value, true); } /** * @template T of object * @param class-string<T> $rootClass * @param mixed $value * @return T */ public function fromValue(string $rootClass, $value) { return $this->hydrate($rootClass, $value, false); } /** * @template T of object * @param class-string<T> $rootClass * @return T */ public function fromJson(string $rootClass, string $json) { return $this->hydrate($rootClass, (new JsonDecoder())->decode($json), false); } public function allowsClientRequest(string $method): bool { return isset($this->messageAvailability['clientToServer']['requests'][$method]); } public function allowsClientNotification(string $method): bool { return isset($this->messageAvailability['clientToServer']['notifications'][$method]); } public function allowsServerRequest(string $method): bool { return isset($this->messageAvailability['serverToClient']['requests'][$method]); } public function allowsServerNotification(string $method): bool { return isset($this->messageAvailability['serverToClient']['notifications'][$method]); } public function allowsEmbeddedInput(string $method): bool { return isset($this->messageAvailability['embeddedInputs'][$method]); } /** * @template T of object * @param class-string<T> $rootClass * @param mixed $value * @return T */ private function hydrate(string $rootClass, $value, bool $programmaticArrays) { $metadata = $this->records[$rootClass] ?? $this->contracts[$rootClass] ?? null; if ($metadata === null) { throw UnavailableTypeException::unsupportedRoot($rootClass); } if (! in_array($this->version, $metadata['versions'], true)) { throw UnavailableTypeException::forRevision($rootClass, $this->version); } /** @var T $record */ $record = $this->interpreter->hydrate( $metadata['definition'], $rootClass, $value, $programmaticArrays ); return $record; } }