source

type AuthInstructionsProvider interface{ AuthInstructions() string }

type Capabilities struct {
	Search       bool
	Dependencies bool
	Updates      bool
	Auth         bool
	// Versions: the source CAN carry per-file Version strings usable for
	// exact version->file resolution (#96). Advisory, not a guarantee:
	// resolution itself degrades dynamically per mod - a file list with no
	// version data yields ErrNotSupported even when this is true (see
	// core.ResolveVersionFiles).
	Versions bool
}

type CapabilityReporter interface {
	Capabilities() Capabilities
}

type DownloadHeaderProvider interface {
	DownloadHeaders(fileURL string) map[string]string
}

type EnvKeyProvider interface{ EnvKey() string }

type GameCatalog interface {
	ListGames(ctx context.Context) ([]GameEntry, error)
}

type GameEntry struct{ ID, Name, Slug string }

type KeyValidator interface {
	ValidateKey(ctx context.Context, key string) error
}

type MergeCompiler interface {
	// ValidateSource parses/validates sourceFilePath (the retained,
	// not-yet-merged source archive) without compiling anything - called at
	// ingest time (download/import) so a malformed archive fails loud
	// immediately rather than at the next merge.
	ValidateSource(sourceFilePath string) error

	// MergeCompile applies every entry in sources, in order (profile load
	// order), against basePakPath's tables, and writes the merged result to
	// outputPakPath. Returns non-fatal warnings (e.g. same-path asset
	// collisions - last-applied wins) alongside a nil error; a nil error
	// with warnings is still a fully-written, deployable pak. Pak-kind
	// sources that cannot be converted are skipped per-mod and reported in
	// failed (#221) - only exmodz-source errors and I/O failures are fatal.
	MergeCompile(ctx context.Context, basePakPath string, sources []MergeSource, outputPakPath string) (warnings []string, failed []MergeFailure, err error)
}

type MergeFailure struct {
	ModRef string
	Reason string
}

type MergeSource struct {
	ModRef     string // "sourceID:modID" - machine identity (MergeFailure, ownership tracking)
	ModName    string // display name preferred over ModRef in user-facing warnings; may be empty
	SourcePath string // the retained source archive to read (.exmodz, or a raw .pak eligible for conversion - #221)
	Kind       string // MergeSourceExmodz (default when empty) or MergeSourcePak
}

type ModSource interface {
	// Identity
	ID() string
	Name() string

	// Authentication
	AuthURL() string
	ExchangeToken(ctx context.Context, code string) (*Token, error)

	// Discovery
	Search(ctx context.Context, query SearchQuery) (SearchResult, error)
	GetMod(ctx context.Context, gameID, modID string) (*domain.Mod, error)
	GetDependencies(ctx context.Context, mod *domain.Mod) ([]domain.ModReference, error)

	// Downloads
	GetModFiles(ctx context.Context, mod *domain.Mod) ([]domain.DownloadableFile, error)
	GetDownloadURL(ctx context.Context, mod *domain.Mod, fileID string) (string, error)

	// Updates
	CheckUpdates(ctx context.Context, installed []domain.InstalledMod) ([]domain.Update, error)
}

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

type SearchQuery struct {
	GameID   string
	Query    string
	Category string   // Optional category filter (source-specific: ID or name)
	Tags     []string // Optional tag filters (source-specific)
	Page     int
	PageSize int
}

type SearchResult struct {
	Mods       []domain.Mod
	TotalCount int // Total results available (0 if unknown)
	Page       int
	PageSize   int
}

type Token struct {
	AccessToken  string
	RefreshToken string
	ExpiresAt    time.Time
}

type TypeLabeler interface{ TypeLabel() string }