visbaseline

type BuildReportConfig struct {
	BaselineRoot string
	OutDir       string
	GeneratedAt  time.Time // optional; defaults to time.Now().UTC()
	Logger       *slog.Logger
}

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

type Config struct {
	// Target is the capture label ("beta" | "prod"). Used only as a tag
	// inside State tuples; the actual base URL is BaseURL.
	Target string

	// BaseURL is the PeeringDB root (e.g. https://beta.peeringdb.com). No
	// trailing slash. Must be non-empty.
	BaseURL string

	// Modes is the subset of {"anon", "auth"} to capture.
	Modes []string

	// Types is the subset of PeeringDB object types to walk. Use AllTypes
	// for beta; ProdTypes for prod.
	Types []string

	// Pages is the number of pages per (mode, type) to fetch. Defaults to
	// 2 when <1. The phase 57 baseline uses 2.
	Pages int

	// OutDir is the REPO-SIDE output root for anon fixtures. Auth fixtures
	// are written EXCLUSIVELY under a private /tmp directory created per
	// run — NEVER under OutDir. This invariant is enforced by the capture
	// loop and asserted by TestCaptureWritesAuthBytesToTmpOnly.
	OutDir string

	// APIKey is the PeeringDB API key. Required when Modes contains "auth".
	// Must never be logged (T-57-05); the Capture implementation uses the
	// peeringdb.Client's built-in Authorization header path, which does
	// not log the value.
	APIKey string

	// StatePath is the checkpoint file path. Defaults to DefaultStatePath
	// when empty.
	StatePath string

	// Logger receives structured capture events. Required.
	Logger *slog.Logger

	// InterTupleDelay is an optional pause between tuples. Tests set this
	// small enough to keep wall-clock low; prod runs leave it zero (the
	// peeringdb.Client rate limiter already paces requests).
	InterTupleDelay time.Duration

	// RateLimitJitter is the extra pause added on top of RateLimitError
	// RetryAfter before re-fetching the same tuple. Defaults to 5 seconds
	// in prod; tests override to 1ms to keep runtime low.
	RateLimitJitter time.Duration

	// ClientOverride, when non-nil, is used by New instead of constructing
	// a *peeringdb.Client internally. TESTS ONLY. Prod callers must leave
	// nil.
	//
	// Rationale: tests need to call client.SetRateLimit and
	// SetRetryBaseDelay before Run to keep wall-clock under 1 second. A
	// package-global mutable hook is race-prone under t.Parallel(); a
	// per-Config field has no shared mutable state.
	//
	// When both Modes contains "auth" and ClientOverride is set, the
	// override is used for BOTH anon and auth clients — tests that need
	// to assert auth-header presence should set the override WithAPIKey
	// and inspect the request on the httptest server side.
	ClientOverride *peeringdb.Client

	// PromptReader is the source for the Resume/Restart prompt. Defaults
	// to os.Stdin when nil. Tests inject strings.NewReader.
	PromptReader io.Reader

	// PromptWriter is the sink for the Resume/Restart prompt text.
	// Defaults to os.Stderr when nil. Tests inject io.Discard.
	PromptWriter io.Writer
}

type FieldDelta struct {
	Name          string `json:"name"`
	AuthOnly      bool   `json:"auth_only"`
	Placeholder   string `json:"placeholder,omitempty"`     // "<auth-only:TYPE>" sentinel
	RowsAdded     int    `json:"rows_added,omitempty"`      // count of auth rows with this field absent-in-anon
	ValueSetDrift bool   `json:"value_set_drift,omitempty"` // true for "visible" when new enum values appear
	IsPII         bool   `json:"is_pii,omitempty"`          // IsPIIField(Name) at construction time
}

type PromptAnswer int

type RedactDirConfig struct {
	AuthSrc string
	AnonDir string
	Dst     string
	Logger  *slog.Logger
}

type Report struct {
	SchemaVersion int                   `json:"schema_version"`
	GeneratedAt   time.Time             `json:"generated"`
	Targets       []string              `json:"targets"`
	Types         map[string]TypeReport `json:"types"`
}

type State struct {
	Version int     `json:"version"`
	Tuples  []Tuple `json:"tuples"`
}

type Tuple struct {
	Target string `json:"target"` // "beta" | "prod"
	Mode   string `json:"mode"`   // "anon" | "auth"
	Type   string `json:"type"`   // PeeringDB object type (poc, net, …)
	Page   int    `json:"page"`   // 1-based page number
	Done   bool   `json:"done"`   // true once bytes are on disk
}

type TypeReport struct {
	AnonRowCount      int          `json:"anon_row_count"`
	AuthRowCount      int          `json:"auth_row_count"`
	AuthOnlyRowCount  int          `json:"auth_only_row_count"`
	VisibleValuesAnon []string     `json:"visible_values_anon,omitempty"`
	VisibleValuesAuth []string     `json:"visible_values_auth,omitempty"`
	Fields            []FieldDelta `json:"fields"`
}