provider

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

type ExchangeInfo struct {
	OriginalAmount    float64
	OriginalCurrency  string
	ConvertedAmount   float64
	ConvertedCurrency string
	ConversionRate    float64
	Timestamp         time.Time
	Source            string
}

type ExchangeRate interface {
	// GetRate fetches the current exchange rate for a currency pair.
	GetRate(ctx context.Context, from, to string) (*ExchangeInfo, error)

	// GetRates fetches multiple exchange rates in a single request.
	GetRates(ctx context.Context, from string) (map[string]*ExchangeInfo, error)

	// IsSupported checks if a currency pair is supported by the provider.
	IsSupported(from, to string) bool

	// Name returns the provider's name for logging and identification.
	Name() string

	// IsHealthy checks if the provider is currently available.
	IsHealthy() bool
}

type GetPaymentStatusParams struct {
	PaymentID string
}

type HealthChecker interface {
	// CheckHealth checks if the provider is healthy
	CheckHealth(ctx context.Context) error
}

type InitiatePaymentParams struct {
	UserID        uuid.UUID
	AccountID     uuid.UUID
	TransactionID uuid.UUID
	Amount        int64
	Currency      string
}

type InitiatePaymentResponse struct {
	Status PaymentStatus
	// PaymentID is the ID of the payment in the payment provider
	// (e.g., Stripe Checkout Session ID)
	PaymentID string
}

type Payment interface {
	InitiatePayment(
		ctx context.Context,
		params *InitiatePaymentParams,
	) (*InitiatePaymentResponse, error)
	HandleWebhook(
		ctx context.Context,
		payload []byte,
		signature string,
	) (*PaymentEvent, error)
}

type PaymentEvent struct {
	ID        string
	Status    PaymentStatus
	Amount    int64
	Currency  string
	UserID    uuid.UUID
	AccountID uuid.UUID
	Metadata  map[string]string
}

type PaymentStatus string

type Provider interface {
	RateFetcher
	HealthChecker
	SupportedChecker

	// Metadata returns the provider's metadata
	Metadata() ProviderMetadata
}

type ProviderMetadata struct {
	Name        string    `json:"name"`
	Version     string    `json:"version"`
	LastUpdated time.Time `json:"last_updated"`
	IsActive    bool      `json:"is_active"`
}

type RateFetcher interface {
	// FetchRate gets the exchange rate for a currency pair
	FetchRate(ctx context.Context, from, to string) (*RateInfo, error)

	// FetchRates gets multiple exchange rates in a single request
	FetchRates(ctx context.Context, from string, to []string) (map[string]*RateInfo, error)
}

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

type RateInfo struct {
	FromCurrency string    `json:"from_currency"`
	ToCurrency   string    `json:"to_currency"`
	Rate         float64   `json:"rate"`
	Timestamp    time.Time `json:"timestamp"`
	Provider     string    `json:"provider"`
	IsDerived    bool      `json:"is_derived"`
	BaseCurrency string    `json:"base_currency,omitempty"`
	OriginalRate float64   `json:"original_rate,omitempty"`
}

type RateStats struct {
	Min     float64
	Max     float64
	Average float64
	Count   int
}

type SupportedChecker interface {
	// IsSupported checks if a currency pair is supported by the provider
	IsSupported(from, to string) bool

	// SupportedPairs returns all supported currency pairs
	SupportedPairs() []string
}

type UpdatePaymentStatusParams struct {
	TransactionID uuid.UUID
	PaymentID     string
	Status        PaymentStatus
}