File Server/Resource/ResourceStoreInterface.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\Server\Resource;
15:
16:	use Nexus\Mcp\Core\Schema\Cursor;
17:	use Nexus\Mcp\Core\Schema\Result\InputRequiredResult;
18:	use Nexus\Mcp\Core\Schema\Result\ListResourcesResult;
19:	use Nexus\Mcp\Core\Schema\Result\ReadResourceResult;
20:	use Nexus\Mcp\Server\Exception\InvalidCursorException;
21:	use Nexus\Mcp\Server\Exception\ResourceNotFoundException;
22:	use Nexus\Mcp\Server\Exception\ResourceNotRegisteredException;
23:	use Nexus\Mcp\Server\ServerContext;
24:
25:	/**
26:	* Read surface that the built-in `resources/*` request handlers depend on.
27:	*/
28:	interface ResourceStoreInterface
29:	{
30:	/**
31:	* @throws InvalidCursorException
32:	*/
33:	public function list(?Cursor $cursor): ListResourcesResult;
34:
35:	/**
36:	* Throw `ResourceNotRegisteredException` for a URI this store does not hold, so a composite may fall
37:	* through to templates. A `ResourceNotFoundException` is authoritative and ends the read.
38:	*
39:	* @param non-empty-string $uri
40:	*
41:	* @throws ResourceNotFoundException
42:	* @throws ResourceNotRegisteredException
43:	*/
44:	public function read(string $uri, ServerContext $context): InputRequiredResult\|ReadResourceResult;
45:	}
46: