32 lines
754 B
PHP
32 lines
754 B
PHP
<?php
|
||
|
||
declare(strict_types=1);
|
||
|
||
/**
|
||
* SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
|
||
* SPDX-License-Identifier: AGPL-3.0-or-later
|
||
*/
|
||
|
||
namespace KTXF\Resource\Identifier;
|
||
|
||
use KTXF\Json\JsonSerializable;
|
||
|
||
/**
|
||
* Top-level identifier for resources (provider level)
|
||
*/
|
||
interface ResourceIdentifierInterface extends JsonSerializable, \Stringable {
|
||
|
||
/** The provider segment (e.g. "imap") */
|
||
public function provider(): string;
|
||
|
||
/** Number of segments present (1–4) */
|
||
public function depth(): int;
|
||
|
||
/** Canonical string form: provider[:service[:collection[:entity]]] */
|
||
public function __toString(): string;
|
||
|
||
/** Canonical JSON form: provider[:service[:collection[:entity]]] */
|
||
public function jsonSerialize(): string;
|
||
|
||
}
|