github

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

type APIResponse struct {
	RateLimit       RateLimitInfo        `json:"rate_limit"`       // Current rate limit status
	PageInfo        PageInfo             `json:"page_info"`        // Pagination metadata
	Repositories    []storage.Repository `json:"repositories"`     // Repository data from current API call
	RequestDuration time.Duration        `json:"request_duration"` // Time taken for API request
	StatusCode      int                  `json:"status_code"`      // HTTP response status code
}

type GitHubClient interface {
	// GetStarredRepositories fetches all starred repositories for a user
	// Returns paginated results with rate limit information
	GetStarredRepositories(ctx context.Context, username string, opts *StarredOptions) (*StarredResponse, error)

	// GetRateLimit returns current rate limit status
	GetRateLimit(ctx context.Context) (*RateLimitInfo, error)

	// ValidateUser checks if a GitHub username exists
	ValidateUser(ctx context.Context, username string) error
}

type PageInfo struct {
	HasNext    bool   `json:"has_next"`    // Whether more pages are available
	NextCursor string `json:"next_cursor"` // Cursor for next page (GitHub pagination)
	TotalCount int    `json:"total_count"` // Total items across all pages
	PerPage    int    `json:"per_page"`    // Items per page
}

type RateLimitError struct {
	ResetTime string
	Limit     int
	Used      int
}

type RateLimitInfo struct {
	Limit     int       `json:"limit"`      // Maximum requests per hour
	Remaining int       `json:"remaining"`  // Requests remaining in current window
	ResetTime time.Time `json:"reset_time"` // When rate limit resets
	Used      int       `json:"used"`       // Requests used in current window
}

type StarredOptions struct {
	Cursor    string `json:"cursor"`    // Page pagination cursor (empty for first page)
	PerPage   int    `json:"per_page"`  // Number of items per page (max 100)
	Sort      string `json:"sort"`      // Sort order: "created", "updated", "pushed", "full_name"
	Direction string `json:"direction"` // Direction: "asc" or "desc"
}

type StarredResponse struct {
	Repositories []storage.Repository `json:"repositories"`
	PageInfo     PageInfo             `json:"page_info"`
	RateLimit    RateLimitInfo        `json:"rate_limit"`
}

type UserNotFoundError struct {
	Username string
}