fetch

type ChangeVerdict struct {
	Changed bool
	// Rung names which check answered, so the manifest can say how the
	// freshness conclusion was reached rather than merely asserting it.
	Rung string
	// Confident reports whether the check is conclusive. A raw-hash match is
	// conclusive; a raw-hash mismatch is not.
	Confident bool
	Response  *Response
}

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

type Freshness struct {
	ETag         string `json:"etag,omitempty"`
	LastModified string `json:"last_modified,omitempty"`
	// RawHash is the byte hash of the served HTML. It changes on every rebuild
	// even when nothing a reader would notice changed, so a mismatch proves
	// nothing -- but a match is conclusive.
	RawHash string `json:"raw_hash,omitempty"`
	// TextHash is the hash of the extracted static text. It survives asset
	// churn and build-id rotation, which is exactly what makes RawHash noisy.
	TextHash string `json:"text_hash,omitempty"`
	// ContentHash is the artifact's own semantic hash from the last run.
	ContentHash string    `json:"content_hash,omitempty"`
	CheckedAt   time.Time `json:"checked_at"`
	// TTL is how long this domain has earned before being re-checked.
	TTL time.Duration `json:"ttl,omitempty"`
}

type Options struct {
	// Timeout bounds a single request.
	Timeout time.Duration
	// MaxBytes bounds a response body. Remote input is untrusted, and an
	// unbounded read from an arbitrary host is a memory-exhaustion primitive.
	MaxBytes int64
	// MaxRedirects bounds a redirect chain.
	MaxRedirects int
	// Guard vets every URL, including every redirect hop.
	Guard *safety.Guard
	// AcceptLanguage is pinned rather than inherited.
	AcceptLanguage string
}

type Response struct {
	URL         string
	FinalURL    string
	Status      int
	Body        []byte
	ContentType string
	// ETag and LastModified are the rung-1 signals, stored so the next run can
	// make a conditional request.
	ETag         string
	LastModified string
	// NotModified reports that the server answered 304.
	NotModified bool
	// Blocked reports that the response looks like a refusal rather than a page.
	Blocked       bool
	BlockedReason string
	Elapsed       time.Duration
	// Redirects is the chain that was followed, recorded because a redirect to
	// a login page is a common and otherwise invisible failure.
	Redirects []string
}