Providers
Understand provider detection, safe resolution, caching, and error behavior.
Deterministic provider detection
Every adapter implements the same contract for URL support, resolution, metadata, live/HLS capability, and cache lifetime. Detection inspects the URL without making network requests and follows registry order before the direct-media fallback.
interface VideoProviderInterface
{
public function supports(string $url): bool;
public function resolve(string $url): array;
public function metadata(string $url): VideoMetadata;
public function slug(): string;
}
Network safety
Provider requests use fixed host allowlists, manual redirect handling, bounded responses, timeouts, and DNS-aware SSRF validation. Every adapter-produced source is validated again before persistence and every stream request revalidates its current destination.
Private, reserved, loopback, link-local, credential-bearing, and unsupported protocol destinations fail before an HTTP request is sent.
Provider guides
Browse the installed provider directory for recognized hosts, capabilities, public-link requirements, and provider-specific caveats.