models

type AccountType string

type Address struct {
	Street  string `json:"street"`
	City    string `json:"city"`
	State   string `json:"state"`
	PIN     string `json:"pin"`     // 6-digit Indian PIN code
	Country string `json:"country"` // Default: "IN"
}

type AdminPortalInfo struct {
	Available   bool   `json:"available"`   // Whether User-Admin portal is available
	Description string `json:"description"` // Explanation of what the portal is for
}

type ChangePasswordRequest struct {
	CurrentPassword string `json:"current_password" validate:"required"`
	NewPassword     string `json:"new_password" validate:"required,min=8,max=100"`
}

type CreateUserRequest struct {
	Email    string `json:"email" validate:"required,email"`
	Phone    string `json:"phone" validate:"required,indian_phone"`
	FullName string `json:"full_name" validate:"required,min=2,max=100"`
	Password string `json:"password" validate:"required,min=8,max=100"`
}

type CreateVerificationRequest struct {
	OperationType OperationType          `json:"operation_type" validate:"required"`
	Metadata      map[string]interface{} `json:"metadata,omitempty"`
}

type KYCInfo struct {
	UserID          string            `json:"user_id" db:"user_id"`
	Status          KYCStatus         `json:"status" db:"status"`
	PAN             string            `json:"pan" db:"pan"`                     // Permanent Account Number
	Aadhaar         string            `json:"-" db:"aadhaar"`                   // Never expose in API (PII)
	DateOfBirth     string            `json:"date_of_birth" db:"date_of_birth"` // YYYY-MM-DD
	Address         Address           `json:"address" db:"-"`                   // Stored as JSONB
	VerifiedAt      *models.Timestamp `json:"verified_at,omitempty" db:"verified_at"`
	RejectedAt      *models.Timestamp `json:"rejected_at,omitempty" db:"rejected_at"`
	RejectionReason string            `json:"rejection_reason,omitempty" db:"rejection_reason"`
	CreatedAt       models.Timestamp  `json:"created_at" db:"created_at"`
	UpdatedAt       models.Timestamp  `json:"updated_at" db:"updated_at"`
}

type KYCStatus string

type LoginRequest struct {
	Identifier string     `json:"identifier" validate:"required"` // Email or phone number
	Password   string     `json:"password" validate:"required"`
	Portal     PortalType `json:"portal,omitempty"` // Portal context: "user" or "admin" (defaults to "user")
}

type LoginResponse struct {
	Token        string           `json:"token"`
	ExpiresAt    int64            `json:"expires_at"`
	User         *User            `json:"user"`
	AccountType  AccountType      `json:"account_type"`             // Account type for easy frontend handling
	PairedUserID string           `json:"paired_user_id,omitempty"` // For User-Admin: the regular user ID
	AdminPortal  *AdminPortalInfo `json:"admin_portal,omitempty"`   // For regular users: admin portal info
}

type OperationType string

type PortalType string

type Session struct {
	ID        string           `json:"id" db:"id"`
	UserID    string           `json:"user_id" db:"user_id"`
	Token     string           `json:"token" db:"token_hash"` // JWT token hash
	IPAddress string           `json:"ip_address" db:"ip_address"`
	UserAgent string           `json:"user_agent" db:"user_agent"`
	ExpiresAt models.Timestamp `json:"expires_at" db:"expires_at"`
	CreatedAt models.Timestamp `json:"created_at" db:"created_at"`
}

type UpdateKYCRequest struct {
	PAN         string  `json:"pan" validate:"required,pan"`
	Aadhaar     string  `json:"aadhaar" validate:"required,aadhaar"`
	DateOfBirth string  `json:"date_of_birth" validate:"required"` // Format: YYYY-MM-DD
	Address     Address `json:"address" validate:"required"`
}

type UpdateProfileRequest struct {
	FullName string `json:"full_name" validate:"required,min=2,max=100"`
	Email    string `json:"email" validate:"required,email"`
	Phone    string `json:"phone" validate:"required,indian_phone"`
}

type User struct {
	ID          string           `json:"id" db:"id"`
	Email       string           `json:"email" db:"email"`
	Phone       string           `json:"phone" db:"phone"` // Indian phone with +91
	FullName    string           `json:"full_name" db:"full_name"`
	Status      UserStatus       `json:"status" db:"status"`
	AccountType AccountType      `json:"account_type" db:"account_type"` // user, user_admin, admin, super_admin
	CreatedAt   models.Timestamp `json:"created_at" db:"created_at"`
	UpdatedAt   models.Timestamp `json:"updated_at" db:"updated_at"`

	// Password (hashed, never exposed in JSON)
	PasswordHash string `json:"-" db:"password_hash"`

	// Suspension tracking (admin actions)
	SuspendedAt      *models.Timestamp `json:"suspended_at,omitempty" db:"suspended_at"`
	SuspensionReason *string           `json:"suspension_reason,omitempty" db:"suspension_reason"`
	SuspendedBy      *string           `json:"suspended_by,omitempty" db:"suspended_by"` // Admin user ID

	// KYC Information (India-specific)
	KYC KYCInfo `json:"kyc" db:"-"` // Embedded, stored separately
}

type UserStatus string

type VerificationClaims struct {
	VerificationID string           `json:"verification_id"`
	UserID         string           `json:"user_id"`
	OperationType  OperationType    `json:"operation_type"`
	Metadata       VerificationMeta `json:"metadata,omitempty"`
	jwt.RegisteredClaims
}

type VerificationMeta map[string]interface{}

type VerificationRequest struct {
	ID            string                  `json:"id" db:"id"`
	UserID        string                  `json:"user_id" db:"user_id"`
	OperationType OperationType           `json:"operation_type" db:"operation_type"`
	OTPCode       string                  `json:"otp_code,omitempty" db:"otp_code"` // Only visible to User-Admin
	Status        VerificationStatus      `json:"status" db:"status"`
	Metadata      VerificationMeta        `json:"metadata,omitempty" db:"metadata"`
	ExpiresAt     sharedModels.Timestamp  `json:"expires_at" db:"expires_at"`
	CreatedAt     sharedModels.Timestamp  `json:"created_at" db:"created_at"`
	VerifiedAt    *sharedModels.Timestamp `json:"verified_at,omitempty" db:"verified_at"`
	AttemptCount  int                     `json:"attempt_count" db:"attempt_count"`
	LastAttemptAt *sharedModels.Timestamp `json:"last_attempt_at,omitempty" db:"last_attempt_at"`
}

type VerificationStatus string

type VerificationToken struct {
	Token         string           `json:"token"`
	OperationType OperationType    `json:"operation_type"`
	Metadata      VerificationMeta `json:"metadata,omitempty"`
	ExpiresAt     time.Time        `json:"expires_at"`
}

type VerifyOTPRequest struct {
	OTP string `json:"otp" validate:"required,len=6,numeric"`
}