feat(ocm): event on ocm discovery and ocm request

[ArtificialOwl]

Allow any app to register new OCM capabilities and manage requests to remote OCM endpoints.
This is done by:

• broadcasting a OCMEndpointRequestEvent event on incoming request on /ocm/,
• and completing current OCM API, aside with some global polishing, with tools to request a remote OCM endpoint.

Complete list of changes:

• rename local ocm discovery event to a more fitted description (ResourceTypeRegisterEvent => LocalOCMDiscoveryEvent)
• ability to add capability to local OCM discovery
• ability to generate custom OCM requests to remote instance
• event on /ocm/ requests to externally manage behavior
• event on /ocm/ requests can extract typed arguments
• event on /ocm/ support signed request
• event on /ocm/ contains attached payload
• remove slashes from capabilities (as expected in ocm 1.2)
• making legacy route parser to manage a list of methods
• get rid of ICapabilityAwareOCMProvider and rehabilitate IOCMProvider

---

• tests

---

Events Listeners

Examples of listeners to inject your app into OCM

Adding a new capability to the local instance

class OCMDiscovery implements IEventListener {
	public function __construct(
	) {
	}

	public function handle(Event $event): void {
		if (!($event instanceof \OCP\OCM\Events\LocalOCMDiscoveryEvent)) {
			return;
		}

		$event->addCapability('my-own-capability');
	}
}

Catching requests made on the ocm endpoint

base url is _https://cloud.example.net/ocm/..._

class OCMRequest implements IEventListener {
	public function __construct(
	) {
	}

	public function handle(Event $event): void {
		if (!($event instanceof \OCP\OCM\Events\OCMEndpointRequestEvent)) {
			return;
		}

		$event->setResponse(new DataResponse(
			[
				'_capability' => $event->getRequestedCapability(),
				'_method' => $event->getUsedMethod(),
				'_path' => $event->getPath(),
				'_args' => $event->getArgs(),
				'_typedArgs' => $event->getArgs(
					\OCP\OCM\Enum\ParamType::STRING,
					\OCP\OCM\Enum\ParamType::STRING,
					\OCP\OCM\Enum\ParamType::INT,
					\OCP\OCM\Enum\ParamType::BOOL,
					\OCP\OCM\Enum\ParamType::INT
				)
			]
		));
	}
}

Expected data

Some example of curl requests ...

Discovery endpoint

$ curl https://cloud.example.net/ocm-provider/ | jq .
{
  "enabled": true,
  "apiVersion": "1.0-proposal1",
  "version": "1.1.0",
  "endPoint": "https://cloud.example.net/index.php/ocm",
[...]  
  "capabilities": [
    "invite-accepted",
    "notifications",
    "shares",
    "my-own-capability"
  ]
}

OCM request

$ curl -X POST -k https://cloud.example.net/ocm/my-own-capability/arg1/arg2/50/yes/not-integer/moar/ignored | jq .
{
  "_capability": "my-own-capability",
  "_method": "POST",
  "_path": "/arg1/arg2/50/yes/not-integer/moar/ignored",
  "_args": [
    "arg1",
    "arg2",
    "50",
    "yes",
    "not-integer",
    "moar",
    "ignored"
  ],
  "_typedArgs": [
    "arg1",
    "arg2",
    50,
    true,
    null
  ]
}

[Altahrim]

Incomplete review

[ArtificialOwl]

Incomplete review

thanks for this, fixed most of the reported minor issues

[ArtificialOwl]

@Altahrim I did the requested changes