checker

type Checker struct {
	// contains filtered or unexported fields
}

type Link struct {
	URL      string // The URL to check
	FilePath string // Source file where the link was found
	Line     int    // Line number in the source file (0 if unknown)
	Text     string // Link text (e.g., "Click here") for display purposes
}

type LinkStatus int

type Options struct {
	// Concurrency is the number of concurrent workers checking links.
	// Higher values = faster checking but more resource usage.
	// Default: 10
	Concurrency int

	// Timeout is the maximum time to wait for a single HTTP request.
	// This includes connection, TLS handshake, and response headers.
	// Default: 10s
	Timeout time.Duration

	// MaxRetries is the number of times to retry a failed request.
	// Only transient errors (timeouts, 5xx, 429) are retried.
	// Default: 2
	MaxRetries int

	// MaxRedirects is the maximum number of redirects to follow.
	// Default: 10
	MaxRedirects int

	// UserAgent is the User-Agent header sent with requests.
	// Some servers block requests without a proper User-Agent.
	// Default: "gone-link-checker/1.0"
	UserAgent string
}

type Redirect struct {
	URL        string // The URL that redirected
	StatusCode int    // The redirect status code (301, 302, 307, 308)
}

type Result struct {
	Link       Link       // The original link that was checked
	StatusCode int        // HTTP status code (0 if request failed)
	Status     LinkStatus // Computed status category
	Error      string     // Error message if applicable

	// Redirect info (populated when redirects occurred)
	RedirectChain []Redirect // Full chain of redirects
	FinalURL      string     // Final destination URL after following redirects
	FinalStatus   int        // Status code of final destination

	// Duplicate info (populated when Status == StatusDuplicate)
	DuplicateOf *Result // Points to primary result if this is a duplicate
}

type Summary struct {
	Total      int // Total links checked (including duplicates)
	UniqueURLs int // Number of unique URLs actually checked
	Alive      int // Links that are alive (2xx)
	Redirects  int // Links that redirect to working pages
	Blocked    int // Links blocked by 403
	Dead       int // Links that are dead (4xx/5xx)
	Errors     int // Links that failed with network errors
	Duplicates int // Duplicate occurrences
}