funpay

type AppData struct {
	CSRFToken string `json:"csrf-token"`
	UserID    int64  `json:"userId"`
	Locale    Locale `json:"locale"`
}

type Funpay interface {
	FunpayUser
	FunpayAuthHandler
	FunpayUpdater
	FunpayRequester
}

type FunpayAuthHandler interface {
	// CSRFToken returns CSRF token extracted from [AppData]. CSRF token updates every call [FunpayRequester.RequestHTML].
	CSRFToken() string

	// UserAgent returns the account's user agent provided into funpay (see [New]).
	GoldenKey() string

	// UserAgent returns the account's user agent provided into funpay (see [New]).
	UserAgent() string
}

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

type FunpayRequester interface {
	// Cookies returns a safe copy of all session cookies.
	Cookies() []*http.Cookie

	// SetProxy sets or updates the HTTP proxy for the requests.
	// To remove proxy and make direct connections, pass nil.
	SetProxy(proxy *url.URL)

	// Request executes an HTTP request using the account's session.
	//
	// It handles:
	//   - Proxy configuration (if set),
	//   - Locale settings (path or query param),
	//   - Cookie management (session and golden key),
	//   - User-Agent header,
	//   - Response status code validation,
	//
	// Specific returns:
	//   - [*http.Response] and [ErrAccountUnauthorized] if status code equals 403,
	//   - [*http.Response] and [ErrTooManyRequests] if status code equals 429,
	//   - [*http.Response] [ErrBadStatusCode] otherwise.
	Request(ctx context.Context, requestURL string, opts ...RequestOpt) (*http.Response, error)

	// RequestHTML calls [FunpayRequester.Request] and converting response as [*goquery.Document].
	// Updates [AppData] and account info (see [FunpayUser]).
	//
	// Returns nil and [ErrAccountUnauthorized] if [Funpay.UserID] is zero.
	RequestHTML(ctx context.Context, requestURL string, opts ...RequestOpt) (*goquery.Document, error)
}

type FunpayUpdater interface {
	// BaseURL returns clients baseURL. Needed for tests to substitute the [BaseURL] with test server.
	BaseURL() string

	// SetBaseURL updates clients baseURL. Needed for tests to substitute the [BaseURL] with test server.
	SetBaseURL(baseURL string)

	// Update calls [FunpayRequester.RequestHTML]. You should call it every 40-60 minutes to update PHPSESSIONID cookie.
	// [FunpayRequester.Request] saves all cookies from response if they are not empty.
	Update(ctx context.Context) error

	// UpdateLocale calls [FunpayRequester.RequestHTML] with setlocale query param.
	UpdateLocale(ctx context.Context, locale Locale) error
}

type FunpayUser interface {
	// UserID returns the unique identifier of the Funpay account.
	// Returns 0 if the account hasn't been updated yet.
	UserID() int64

	// Locale returns the account's locale (see [Locale]). Must be loaded after update.
	Locale() Locale

	// Username returns the account's username. Must be loaded after update.
	Username() string

	// Balance returns the account's balance. Must be loaded after update.
	Balance() int64
}

type Locale string

type RequestOpt func(options *RequestOpts)

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