zoho

type APIError struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data struct {
		MoreInfo string `json:"moreInfo"`
	} `json:"data"`
}

type AccountData struct {
	AccountID string `json:"accountId"`
	ZUID      int64  `json:"zuid"`
	PolicyID  struct {
		Zoid int64 `json:"zoid"`
	} `json:"policyId"`
	PrimaryEmailAddress string `json:"primaryEmailAddress"`
	DisplayName         string `json:"displayName"`
	Role                string `json:"role"`
}

type AccountDetails struct {
	AccountDisplayName  string          `json:"accountDisplayName"`
	DisplayName         string          `json:"displayName"`
	PrimaryEmailAddress string          `json:"primaryEmailAddress"`
	EmailAddress        []EmailAddress  `json:"emailAddress"`
	VacationResponse    json.RawMessage `json:"vacationResponse,omitempty"`
	ForwardDetails      json.RawMessage `json:"forwardDetails,omitempty"`
}

type AccountDetailsResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data AccountDetails `json:"data"`
}

type AccountsResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []AccountData `json:"data"`
}

type AddDomainRequest struct {
	DomainName string `json:"domainName"`
}

type AddGroupMembersRequest struct {
	Mode                string             `json:"mode"` // "addMailGroupMember"
	MailGroupMemberList []GroupMemberToAdd `json:"mailGroupMemberList"`
}

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

type AdminService interface {
	ListUsers(ctx context.Context, start, limit int) ([]User, error)
	GetUser(ctx context.Context, accountID int64) (*User, error)
	GetUserByEmail(ctx context.Context, email string) (*User, error)
	GetUserByIdentifier(ctx context.Context, identifier string) (*User, error)
	CreateUser(ctx context.Context, req CreateUserRequest) (*User, error)
	UpdateUserRole(ctx context.Context, zuid int64, newRole string) error
	EnableUser(ctx context.Context, zuid int64) error
	DisableUser(ctx context.Context, zuid int64, opts DisableUserOpts) error
	DeleteUser(ctx context.Context, zuid int64) error

	ListGroups(ctx context.Context, start, limit int) ([]Group, error)
	GetGroup(ctx context.Context, zgid int64) (*Group, error)
	GetGroupByEmail(ctx context.Context, email string) (*Group, error)
	GetGroupMembers(ctx context.Context, zgid int64) ([]GroupMember, error)
	CreateGroup(ctx context.Context, req CreateGroupRequest) (*Group, error)
	UpdateGroup(ctx context.Context, zgid int64, name, description string) error
	DeleteGroup(ctx context.Context, zgid int64) error
	AddGroupMembers(ctx context.Context, zgid int64, members []GroupMemberToAdd) error
	RemoveGroupMembers(ctx context.Context, zgid int64, members []GroupMemberToRemove) error

	ListDomains(ctx context.Context) ([]Domain, error)
	GetDomain(ctx context.Context, domainName string) (*Domain, error)
	AddDomain(ctx context.Context, domainName string) (*Domain, error)
	VerifyDomain(ctx context.Context, domainName, method string) error
	UpdateDomainSettings(ctx context.Context, domainName, mode string) error

	GetAuditLogs(ctx context.Context, startTime, endTime time.Time, searchKey string, limit int) ([]AuditLog, error)
	GetLoginHistory(ctx context.Context, mode string, startTime, endTime time.Time, batchSize int) ([]LoginHistoryEntry, error)
	GetSMTPLogs(ctx context.Context, startTime, endTime time.Time, searchCriteria, searchKey string, limit int) ([]SMTPLogEntry, error)
}

type Attachment struct {
	AttachmentID   string `json:"attachmentId"`
	AttachmentName string `json:"attachmentName"`
	AttachmentSize int64  `json:"attachmentSize"`
	AttachmentType string `json:"attachmentType"` // MIME type
}

type AttachmentListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []Attachment `json:"data"`
}

type AttachmentReference struct {
	StoreName      string `json:"storeName"`
	AttachmentName string `json:"attachmentName"`
	AttachmentPath string `json:"attachmentPath"`
}

type AttachmentUploadResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data AttachmentReference `json:"data"`
}

type AuditLog struct {
	SubCategory   string          `json:"subCategory"`
	Data          json.RawMessage `json:"data"`
	Type          string          `json:"type"`
	RequestTime   int64           `json:"requestTime"` // Unix milliseconds
	PerformedBy   string          `json:"performedBy"`
	AuditLogType  string          `json:"auditLogType"`
	ClientIP      string          `json:"clientIp"`
	MainCategory  string          `json:"mainCategory"`
	OperationType string          `json:"operationType"`
	PerformedOn   string          `json:"performedOn"`
	Category      string          `json:"category"`
	Operation     string          `json:"operation"`
}

type AuditLogResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data struct {
		Audit         []AuditLog `json:"audit"`
		LastIndexTime string     `json:"lastIndexTime"`
		LastEntityID  string     `json:"lastEntityId"`
	} `json:"data"`
}

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

type CreateGroupRequest struct {
	GroupName         string   `json:"groupName"`
	GroupEmailAddress string   `json:"groupEmailAddress"`
	Description       string   `json:"description"`
	AdminsEmailList   []string `json:"adminsEmailList,omitempty"`
	MembersEmailList  []string `json:"membersEmailList,omitempty"`
}

type CreateUserRequest struct {
	PrimaryEmailAddress string   `json:"primaryEmailAddress"`
	Password            string   `json:"password"`
	FirstName           string   `json:"firstName"`
	LastName            string   `json:"lastName"`
	DisplayName         string   `json:"displayName"`
	Role                string   `json:"role"`
	Country             string   `json:"country"`
	Language            string   `json:"language"`
	TimeZone            string   `json:"timeZone"`
	OneTimePassword     bool     `json:"oneTimePassword"`
	GroupMailList       []string `json:"groupMailList,omitempty"`
}

type DKIM struct {
	Selector   string `json:"selector"`
	DomainName string `json:"domainName"`
	TXTRecord  string `json:"txtRecord"`
	Status     bool   `json:"status"`
}

type DeleteConfirmation struct {
	Mode string `json:"mode"` // "deleteUser" or similar
}

type DeliveryLog struct {
	MessageID    string `json:"messageId"`
	Subject      string `json:"subject"`
	FromAddress  string `json:"fromAddress"`
	ToAddress    string `json:"toAddress"`
	Status       string `json:"status"`
	SentTime     string `json:"sentTime"`
	DeliveryTime string `json:"deliveryTime"`
}

type DeliveryLogListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []DeliveryLog `json:"data"`
}

type DisableUserOpts struct {
	BlockIncoming         bool `json:"blockIncoming,omitempty"`
	RemoveMailForward     bool `json:"removeMailForward,omitempty"`
	RemoveGroupMembership bool `json:"removeGroupMembership,omitempty"`
	RemoveAlias           bool `json:"removeAlias,omitempty"`
}

type Domain struct {
	DomainName            string `json:"domainName"`
	DomainID              string `json:"domainId"`
	VerificationStatus    bool   `json:"verificationStatus"`
	DKIMStatus            bool   `json:"dkimstatus"`
	SPFStatus             bool   `json:"spfstatus"`
	MXStatus              string `json:"mxstatus"`
	VerifiedDate          int64  `json:"verifiedDate"` // Unix milliseconds
	MailHostingEnabled    bool   `json:"mailHostingEnabled"`
	IsDomainAlias         bool   `json:"isDomainAlias"`
	IsExpired             bool   `json:"isExpired"`
	Primary               bool   `json:"primary"`
	CNAMEVerificationCode string `json:"CNAMEVerificationCode"`
	HTMLVerificationCode  string `json:"HTMLVerificationCode"`
	TXTVerificationCode   string `json:"txtRecord"` // TXT record value for DNS verification
}

type DomainDetailResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data Domain `json:"data"`
}

type DomainListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data struct {
		DomainVO []Domain `json:"domainVO"`
	} `json:"data"`
}

type DomainModeRequest struct {
	Mode string `json:"mode"`
}

type EmailAddress struct {
	MailID    string `json:"mailId"`
	IsAlias   bool   `json:"isAlias"`
	IsPrimary bool   `json:"isPrimary"`
}

type Folder struct {
	FolderID     string `json:"folderId"`
	FolderName   string `json:"folderName"`
	FolderType   string `json:"folderType"`
	Path         string `json:"path"`
	UnreadCount  int    `json:"unreadCount"`
	MessageCount int    `json:"messageCount"`
}

type FolderListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []Folder `json:"data"`
}

type ForwardSettings struct {
	Enabled   bool   `json:"enabled"`
	ForwardTo string `json:"forwardTo"`
	KeepCopy  bool   `json:"keepCopy"`
}

type Group struct {
	ZGID              int64  `json:"zgid"`
	GroupName         string `json:"groupName"`
	GroupEmailAddress string `json:"groupEmailAddress"`
	Description       string `json:"description"`
	MembersCount      int    `json:"membersCount"`
}

type GroupDetailResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data Group `json:"data"`
}

type GroupListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data struct {
		Groups []Group `json:"groups"`
		Count  int     `json:"count"`
	} `json:"data"`
}

type GroupMember struct {
	MemberEmailID string `json:"memberEmailID"`
	Role          string `json:"role"`
	ZUID          int64  `json:"zuid"`
}

type GroupMemberToAdd struct {
	MemberEmailID string `json:"memberEmailID"`
	Role          string `json:"role"`
}

type GroupMemberToRemove struct {
	MemberEmailID string `json:"memberEmailID"`
}

type GroupMembersResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []GroupMember `json:"data"`
}

type Label struct {
	LabelID    string `json:"labelId"`
	LabelName  string `json:"labelName"`
	LabelColor string `json:"labelColor"`
}

type LabelListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []Label `json:"data"`
}

type LoginHistoryEntry struct {
	UserID       int64  `json:"userId"`
	EmailAddress string `json:"emailAddress"`
	IPAddress    string `json:"ipAddress"`
	LoginTime    int64  `json:"loginTime"` // Unix milliseconds
	Status       string `json:"status"`
	AccessType   string `json:"accessType"`
	ClientInfo   string `json:"clientInfo"`
}

type LoginHistoryResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data struct {
		LoginHistory []LoginHistoryEntry `json:"loginHistory"`
		ScrollID     string              `json:"scrollId"`
	} `json:"data"`
}

type MailAccount struct {
	AccountID           string         `json:"accountId"`
	EmailAddress        []EmailAddress `json:"emailAddress"`
	PrimaryEmailAddress string         `json:"primaryEmailAddress"`
	AccountDisplayName  string         `json:"accountDisplayName"`
	DisplayName         string         `json:"displayName"`
	Type                string         `json:"type"`
	Role                string         `json:"role"`
}

type MailAccountListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []MailAccount `json:"data"`
}

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

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

type MailService interface {
	// Folder and label operations
	ListFolders(ctx context.Context) ([]Folder, error)
	GetFolderByName(ctx context.Context, name string) (*Folder, error)
	ListLabels(ctx context.Context) ([]Label, error)

	// Message operations
	ListMessages(ctx context.Context, folderID string, start, limit int) ([]MessageSummary, error)
	GetMessageMetadata(ctx context.Context, folderID, messageID string) (*MessageMetadata, error)
	GetMessageContent(ctx context.Context, folderID, messageID string) (*MessageContent, error)
	SearchMessages(ctx context.Context, searchKey string, start, limit int) ([]MessageSummary, error)
	GetThread(ctx context.Context, folderID, threadID string, limit int) ([]MessageSummary, error)

	// Attachment operations
	ListAttachments(ctx context.Context, folderID, messageID string) ([]Attachment, error)
	DownloadAttachment(ctx context.Context, folderID, messageID, attachmentID, destPath string) error
	UploadAttachment(ctx context.Context, filePath string) (*AttachmentReference, error)

	// Send operations
	SendEmail(ctx context.Context, req *SendEmailRequest) error
	ReplyToEmail(ctx context.Context, messageID string, req *SendEmailRequest) error
	ReplyAllToEmail(ctx context.Context, messageID string, req *SendEmailRequest) error
	ForwardEmail(ctx context.Context, messageID string, req *SendEmailRequest) error

	// Settings operations
	ListSignatures(ctx context.Context) ([]Signature, error)
	AddSignature(ctx context.Context, sig *Signature) (string, error)
	GetAccountDetails(ctx context.Context) (*AccountDetails, error)
	AddVacationReply(ctx context.Context, vacation *VacationReply) error
	DisableVacationReply(ctx context.Context) error
	UpdateDisplayName(ctx context.Context, displayName string) error
}

type MessageContent struct {
	MessageID json.Number `json:"messageId"`
	Content   string      `json:"content"` // HTML body
}

type MessageContentResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data MessageContent `json:"data"`
}

type MessageListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []MessageSummary `json:"data"`
}

type MessageMetadata struct {
	MessageID     string `json:"messageId"`
	ThreadID      string `json:"threadId"`
	FolderID      string `json:"folderId"`
	Subject       string `json:"subject"`
	FromAddress   string `json:"fromAddress"`
	Sender        string `json:"sender"`
	ToAddress     string `json:"toAddress"`
	CcAddress     string `json:"ccAddress"`
	SentDateInGMT string `json:"sentDateInGMT"` // Unix milliseconds (as string)
	ReceivedTime  string `json:"receivedTime"`
	MessageSize   string `json:"messageSize"`
	HasAttachment string `json:"hasAttachment"` // "0", "1", or "true"/"false"
	HasInline     string `json:"hasInline"`
	Status        string `json:"status"`
	Priority      string `json:"priority"`
	FlagID        string `json:"flagid"`
}

type MessageMetadataResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data MessageMetadata `json:"data"`
}

type MessageSummary struct {
	MessageID     string `json:"messageId"`
	ThreadID      string `json:"threadId"`
	Subject       string `json:"subject"`
	FromAddress   string `json:"fromAddress"`
	Sender        string `json:"sender"`
	ReceivedTime  string `json:"receivedTime"` // Unix milliseconds (as string)
	Status        string `json:"status"`
	HasAttachment string `json:"hasAttachment"` // "0" or "1"
	FlagID        string `json:"flagid"`
	Priority      string `json:"priority"`
	Summary       string `json:"summary"`
}

type PageIterator[T any] struct {
	// contains filtered or unexported fields
}

type RateLimitTransport struct {
	Base    http.RoundTripper
	Limiter *rate.Limiter
}

type RemoveGroupMembersRequest struct {
	Mode                string                `json:"mode"` // "removeMailGroupMember"
	MailGroupMemberList []GroupMemberToRemove `json:"mailGroupMemberList"`
}

type SMTPLogEntry struct {
	MessageID     string   `json:"messageId"`
	FromAddress   string   `json:"fromAddr"`
	ToAddresses   []string `json:"toAddr"`
	Subject       string   `json:"subject"`
	TransactionID string   `json:"transactionId"`
	Timestamp     int64    `json:"timestamp"` // Unix milliseconds
	Status        string   `json:"status"`
}

type SMTPLogResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data struct {
		HasNext     bool           `json:"hnxt"`
		HasPrevious bool           `json:"hasPrevious"`
		PageKey     string         `json:"pagekey"`
		PagePrevKey string         `json:"pagePrevKey"`
		Response    []SMTPLogEntry `json:"response"`
	} `json:"data"`
}

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

type SendEmailRequest struct {
	FromAddress string                `json:"fromAddress"`
	ToAddress   string                `json:"toAddress"`
	CcAddress   string                `json:"ccAddress,omitempty"`
	BccAddress  string                `json:"bccAddress,omitempty"`
	Subject     string                `json:"subject"`
	Content     string                `json:"content"`
	MailFormat  string                `json:"mailFormat,omitempty"` // "html" or "plaintext"
	Action      string                `json:"action,omitempty"`     // "reply", "replyall", "forward"
	Attachments []AttachmentReference `json:"attachments,omitempty"`
}

type SendEmailResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
}

type Signature struct {
	ID          string `json:"id"`
	Name        string `json:"name"`
	Content     string `json:"content"`
	Position    int    `json:"position"`              // 0=below quoted, 1=above quoted
	AssignUsers string `json:"assignUsers,omitempty"` // comma-separated emails
}

type SignatureCreateResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data struct {
		ID   string `json:"id"`
		Name string `json:"name"`
	} `json:"data"`
}

type SignatureListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []Signature `json:"data"`
}

type SpamCategory string

type SpamListEntry struct {
	Category SpamCategory
	Value    string
}

type SpamSettingsResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []string `json:"data"`
}

type SpamUpdateRequest struct {
	SpamCategory string   `json:"spamCategory"`
	Value        []string `json:"Value"` // Capital V matches Zoho API
}

type UpdateUserRequest struct {
	Mode    string `json:"mode"`
	ZUID    int64  `json:"zuid"`
	NewRole string `json:"newRole,omitempty"`
}

type User struct {
	ZUID              int64          `json:"zuid"`
	AccountID         string         `json:"accountId"` // Zoho returns this as a quoted string
	EmailAddress      []EmailAddress `json:"emailAddress"`
	PrimaryEmailID    string         `json:"primaryEmailAddress"`
	FirstName         string         `json:"firstName"`
	LastName          string         `json:"lastName"`
	DisplayName       string         `json:"displayName"`
	Role              string         `json:"role"`
	MailboxStatus     string         `json:"mailboxStatus"`
	UsedStorage       int64          `json:"usedStorage"`
	PlanStorage       int64          `json:"planStorage"`
	TFAEnabled        bool           `json:"tfaEnabled"`
	IMAPAccessEnabled bool           `json:"imapAccessEnabled"`
	POPAccessEnabled  bool           `json:"popAccessEnabled"`
	LastLogin         int64          `json:"lastLogin"` // Unix timestamp in milliseconds
}

type UserDetailResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data User `json:"data"`
}

type UserListResponse struct {
	Status struct {
		Code        int    `json:"code"`
		Description string `json:"description"`
	} `json:"status"`
	Data []User `json:"data"`
}

type VacationReply struct {
	FromDate   string `json:"fromDate"`   // MM/DD/YYYY HH:MM:SS
	ToDate     string `json:"toDate"`     // MM/DD/YYYY HH:MM:SS
	SendingInt int    `json:"sendingInt"` // reply interval in minutes
	Subject    string `json:"subject"`
	Content    string `json:"content"`
	SendTo     string `json:"sendTo"` // "all"/"contacts"/"noncontacts"/"org"/"nonOrgAll"
}