favicon_fetcher.go RawHistoryFolder

1package port
2
3import (
4	"context"
5
6	"github.com/bnema/dumber/internal/domain/favicon"
7)
8
9// FaviconFetchRequest specifies the page and optional icon URL for a favicon fetch.
10// PageURL is the absolute source page URL; IconURL may be empty when the fetcher should discover or fall back.
11type FaviconFetchRequest struct {
12	PageURL string
13	IconURL string
14}
15
16// FaviconFetchedIcon contains fetched favicon bytes and their source metadata.
17// PageURL is the source page, IconURL is the resource URL, ResolvedKey optionally
18// overrides the storage key when a provider is host/domain scoped rather than exact-page scoped,
19// Source identifies discovery origin, and ContentType is the MIME type.
20type FaviconFetchedIcon struct {
21	PageURL     string
22	IconURL     string
23	ResolvedKey favicon.Key
24	Bytes       []byte
25	Source      favicon.Source
26	ContentType string
27}
28
29// FaviconFetcher safely fetches favicon resources for a FaviconFetchRequest.
30// Implementations validate URLs/content and return ErrFaviconMiss for not-found or disallowed resources.
31type FaviconFetcher interface {
32	Fetch(ctx context.Context, request FaviconFetchRequest) (*FaviconFetchedIcon, error)
33}