<?php

declare(strict_types=1);

/**
 * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
 * SPDX-License-Identifier: AGPL-3.0-or-later
 */

namespace KTXF\Resource\Identifier;

/**
 * Top-level identifier for resources (provider level)
 */
interface ResourceIdentifierInterface extends \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;

}