Skip to content
Infrastructure

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.