<?php

namespace NoahVet\Reef\Domain\Security\Port;

/**
 * Outbound port: finds a resource entity from its IAM slug.
 * Implement this to enable reverse lookup (IAM slug → domain entity).
 */
interface ResourceLocatorInterface extends ResourceFinderInterface
{
    /**
     * Returns the entity matching the given IAM slug, or null if this locator
     * does not handle the slug prefix or no entity is found.
     */
    public function findBySlug(string $slug): mixed;
}
