ussd

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

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

type LoanApproval struct {
	Approved     bool
	Reason       string
	InterestRate float64
}

type LoanProductConfig struct {
	ProductID         string // UUID of the loan product record.
	MinAmountCents    int64  // Minimum loan in fiat cents (e.g. 50000 = KES 500).
	MaxAmountCents    int64  // Maximum auto-approved loan in fiat cents (e.g. 300000 = KES 3,000).
	Currency          string // ISO 4217 currency code (e.g. "KES").
	DurationDays      int    // Fixed loan term in days (e.g. 30).
	RepaymentSchedule string // Repayment cadence (e.g. "lump_sum").
	InterestRateBps   int32  // Fallback annual rate in basis points; vault APR takes precedence.
}

type LoanRequest struct {
	UserID          string
	AccountID       string // Database UUID of the user's account record.
	StellarAddress  string // Stellar public key for vault borrow recipient.
	ProductID       string // Loan product ID from LoanProductConfig.
	PhoneNumber     string
	RecipientName   string
	NationalID      string
	CountryCode     string
	NetworkCode     string
	NetworkName     string
	PrincipalAmount int64 // USDC amount in stroops (converted from local currency).
	PrincipalAsset  string
	DurationDays    int
	RepaymentSched  string
	LocalAmount     int64   // Local currency amount in cents (e.g. KES cents).
	LocalCurrency   string  // ISO 4217 currency code (e.g. "KES").
	ConversionRate  float64 // YellowCard buy rate at quote time (e.g. 153.50).
}

type LoanService interface {
	// GetUserLoans returns all loans for the given user, formatted for USSD display.
	GetUserLoans(ctx context.Context, userID string) ([]any, error)

	// RequestLoan orchestrates the full loan disbursement cycle.
	RequestLoan(ctx context.Context, req *LoanRequest) (any, error)

	// CheckLoanEligibility checks whether the user qualifies for the requested amount.
	CheckLoanEligibility(ctx context.Context, userID string, amount int64, duration int) (*LoanApproval, error)

	// GetProductConfig returns the active loan product parameters used by the
	// USSD flow (limits, duration, schedule). Returns nil when no product is configured.
	GetProductConfig() *LoanProductConfig
}

type Localizer interface {
	// Get retrieves a localized message.
	Get(language, key string) string

	// GetWithDefault retrieves a localized message with a default fallback.
	GetWithDefault(language, key, defaultMsg string) string

	// HasKey checks if a key exists.
	HasKey(key string) bool

	// AddTranslation adds a translation.
	AddTranslation(key, language, message string)
}

type Menu struct {
	ID           string
	Title        map[string]string // Language -> Title
	Options      []MenuOption
	Handler      MenuHandler
	ParentMenu   string
	RequiresAuth bool
}

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

type MenuContext struct {
	Session *Session
	Input   string
	Manager *SessionManager
}

type MenuHandler func(ctx *MenuContext) (*MenuResponse, error)

type MenuOption struct {
	Key        string
	Label      map[string]string // Language -> Label
	TargetMenu string
	Handler    MenuHandler
}

type MenuPreset interface {
	// Initialize loads menus into the registry.
	Initialize(registry *MenuRegistry)

	// GetName returns the preset name.
	GetName() string
}

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

type MenuResponse struct {
	Type    MenuType
	Message string
}

type MenuType string

type NetworkMapper struct{}

type NetworkMapping struct {
	MobileNetworkCode string // Telco's mobile network code (MCC + MNC) (e.g., "63902")
	MomoNetworkCode   string // Momo network code (e.g., "MPESA")
	MomoNetworkName   string // Momo Display name (e.g., "M-Pesa")
	TelcoName         string // Telco name (e.g., "Safaricom Kenya")
	Country           string // ISO country code (e.g., "KE")
}

type PINService interface {
	// SetPIN creates a new PIN for a user (during registration).
	SetPIN(ctx context.Context, userID, pin string) error

	// VerifyPIN checks the supplied PIN against the stored hash.
	// Returns (true, nil) on success, (false, nil) on wrong PIN.
	VerifyPIN(ctx context.Context, userID, pin string) (bool, error)

	// ChangePIN verifies the old PIN and sets a new one.
	ChangePIN(ctx context.Context, userID, oldPin, newPin string) error

	// ResetPIN sets a new PIN after identity verification (security questions).
	ResetPIN(ctx context.Context, userID, newPin string) error

	// IsLocked reports whether the account is locked and when the lockout expires.
	IsLocked(ctx context.Context, userID string) (bool, time.Time, error)

	// HasPIN reports whether the user has a PIN set.
	HasPIN(ctx context.Context, userID string) (bool, error)

	// SetSecurityQuestions stores hashed answers for the given questions.
	SetSecurityQuestions(ctx context.Context, userID string, questions []pin.QuestionAnswer) error

	// VerifySecurityAnswers checks the supplied answers against stored hashes.
	VerifySecurityAnswers(ctx context.Context, userID string, answers []pin.QuestionAnswer) (bool, error)

	// GetUserQuestionIDs returns the predefined question IDs the user has configured.
	GetUserQuestionIDs(ctx context.Context, userID string) ([]int, error)

	// GetRemainingAttempts returns the number of PIN attempts left before lockout.
	GetRemainingAttempts(ctx context.Context, userID string) (int, error)
}

type RateService interface {
	// GetExchangeRate returns the current buying rate for the specified currency.
	GetExchangeRate(ctx context.Context, currency string) (buyRate float64, err error)
}

type RegisterUserRequest struct {
	MobileNumber      string
	MobileCountryCode string
	NetworkCode       string
	FullName          string
	NationalID        string
	PreferredLanguage string
}

type Session struct {
	SessionID     string         `json:"session_id"`
	PhoneNumber   string         `json:"phone_number"`
	ServiceCode   string         `json:"service_code"`
	NetworkCode   string         `json:"network_code"`
	UserID        string         `json:"user_id,omitempty"`
	CurrentMenu   string         `json:"current_menu"`
	PreviousMenus []string       `json:"previous_menus"`
	Language      string         `json:"language"`
	Data          map[string]any `json:"data"`
	CreatedAt     time.Time      `json:"created_at"`
	UpdatedAt     time.Time      `json:"updated_at"`
}

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

type SimplifiedMenuPreset struct{}

type StandardLoanMenuPreset struct{}

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

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

type USSDProvider interface {
	// ParseRequest parses the provider-specific HTTP request into a standardized USSDRequest.
	ParseRequest(ctx context.Context, data map[string]string) (*USSDRequest, error)

	// FormatResponse formats the USSDResponse into the provider-specific response format.
	FormatResponse(ctx context.Context, response *USSDResponse) (any, error)

	// GetProviderName returns the name of the USSD provider.
	GetProviderName() string

	// ValidateRequest validates the incoming request from the provider.
	ValidateRequest(ctx context.Context, data map[string]string) error
}

type USSDRequest struct {
	SessionID    string
	PhoneNumber  string
	Input        string
	ServiceCode  string
	NetworkCode  string
	ProviderData map[string]string // For provider-specific data
}

type USSDResponse struct {
	Type    string // "CON" for continue, "END" for terminate
	Message string
}

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

type UserService interface {
	// GetUserWithAccounts retrieves a user and their associated accounts.
	GetUserWithAccounts(ctx context.Context, userIDOrPhone string) (any, []any, error)
	// RegisterUser creates a new user account based on the provided registration request.
	RegisterUser(ctx context.Context, req *RegisterUserRequest) (any, []any, error)
}