bd7534658a
- Updated environment configuration to unify frontend for mail and drive under a single service. - Revised README to reflect changes in frontend setup and routing for the unified application. - Introduced new API documentation endpoints for better accessibility of API specifications. - Enhanced drive and mail services with improved handling of file uploads and metadata enrichment. - Implemented new API token management features, including creation, listing, and revocation of tokens. - Added tests for new functionalities in drive and mail services to ensure reliability and correctness.
92 lines
7.8 KiB
Go
92 lines
7.8 KiB
Go
package mail
|
|
|
|
import (
|
|
"context"
|
|
"io"
|
|
"time"
|
|
|
|
"github.com/ultisuite/ulti-backend/internal/api/query"
|
|
"github.com/ultisuite/ulti-backend/internal/mail/credentials"
|
|
"github.com/ultisuite/ulti-backend/internal/mail/listunsubscribe"
|
|
)
|
|
|
|
// ServiceAPI is the mail handler service boundary. *Service implements it in production.
|
|
type ServiceAPI interface {
|
|
ResolveUserID(ctx context.Context, externalID string) (string, error)
|
|
GetMailSettings(ctx context.Context, externalID string) (MailSettings, error)
|
|
UpdateMailSettings(ctx context.Context, externalID string, req *patchMailSettingsRequest) (MailSettings, error)
|
|
ListUnifiedFolders(ctx context.Context, externalID, accountID string, params query.ListParams) (UnifiedFoldersList, error)
|
|
CreateUnifiedFolder(ctx context.Context, userID string, req *createUnifiedFolderRequest) (string, error)
|
|
UpdateUnifiedFolder(ctx context.Context, externalID, folderID string, req *updateUnifiedFolderRequest) error
|
|
DeleteUnifiedFolder(ctx context.Context, externalID, folderID string) error
|
|
ListAccounts(ctx context.Context, externalID string, params query.ListParams) (AccountsList, error)
|
|
CreateAccount(ctx context.Context, externalID string, req *createAccountRequest) (string, error)
|
|
CreateAccountWithCredential(ctx context.Context, externalID string, req *createAccountRequest, cred credentials.Credential) (string, error)
|
|
GetAccount(ctx context.Context, externalID, accountID string) (map[string]any, error)
|
|
UpdateAccount(ctx context.Context, externalID, accountID string, req *updateAccountRequest) error
|
|
CredentialForConnectionTest(ctx context.Context, externalID string, req *testAccountRequest) (credentials.Credential, error)
|
|
DeleteAccount(ctx context.Context, externalID, accountID string) error
|
|
ResanitizeAccountBodies(ctx context.Context, externalID, accountID string) (ResanitizeBodiesResult, error)
|
|
ListMessages(ctx context.Context, externalID string, filter MessageListFilter, params query.ListParams) (MessagesList, error)
|
|
MessageAccountID(ctx context.Context, externalID, messageID string) (string, error)
|
|
AttachmentAccountID(ctx context.Context, externalID, attachmentID string) (string, error)
|
|
ThreadAccessible(ctx context.Context, externalID, threadID string, scopedAccountIDs []string) (bool, error)
|
|
GetMessage(ctx context.Context, externalID, messageID string) (map[string]any, error)
|
|
SendMailtoListUnsubscribe(ctx context.Context, externalID, messageID string, sender MailSender) (*listunsubscribe.Mailto, error)
|
|
UpdateLabels(ctx context.Context, externalID, messageID string, labels []string) error
|
|
UpdateFlags(ctx context.Context, externalID, messageID string, flags []string) error
|
|
DeleteMessage(ctx context.Context, externalID, messageID string) error
|
|
GetThread(ctx context.Context, externalID, threadID string, scopedAccountIDs []string) (map[string]any, error)
|
|
SendMessage(ctx context.Context, userID string, req *sendMessageRequest) (id, status string, err error)
|
|
SendOutboxNow(ctx context.Context, userID, outboxID string) (status string, err error)
|
|
RescheduleOutbox(ctx context.Context, userID, outboxID string, scheduledAt time.Time) (status string, err error)
|
|
CancelScheduledOutbox(ctx context.Context, userID, outboxID string) (status string, err error)
|
|
ListDrafts(ctx context.Context, externalID string, params query.ListParams) (DraftsList, error)
|
|
GetDraft(ctx context.Context, externalID, draftID string) (map[string]any, error)
|
|
CreateDraft(ctx context.Context, userID string, req *draftRequest) (string, error)
|
|
UpdateDraft(ctx context.Context, externalID, draftID string, req *draftRequest) error
|
|
DeleteDraft(ctx context.Context, externalID, draftID string) error
|
|
ListRules(ctx context.Context, externalID string, params query.ListParams) (RulesList, error)
|
|
CreateRule(ctx context.Context, userID string, req *createRuleRequest) (string, error)
|
|
UpdateRule(ctx context.Context, externalID, ruleID string, req *updateRuleRequest) error
|
|
DeleteRule(ctx context.Context, externalID, ruleID string) error
|
|
SimulateRule(ctx context.Context, externalID string, req *simulateRuleRequest) (any, error)
|
|
ListWebhooks(ctx context.Context, externalID string, params query.ListParams) (WebhooksList, error)
|
|
CreateWebhook(ctx context.Context, externalID string, req *createWebhookRequest, method string, maxRetries int) (string, error)
|
|
UpdateWebhook(ctx context.Context, externalID, webhookID string, req *updateWebhookRequest, method string, maxRetries int) error
|
|
PreviewWebhookTemplate(ctx context.Context, externalID string, req *previewWebhookRequest) (map[string]any, error)
|
|
DeleteWebhook(ctx context.Context, externalID, webhookID string) error
|
|
ListIdentities(ctx context.Context, externalID, accountID string, params query.ListParams) (IdentitiesList, error)
|
|
GetIdentity(ctx context.Context, externalID, identityID string) (map[string]any, error)
|
|
CreateIdentity(ctx context.Context, externalID, accountID string, req *createIdentityRequest) (string, error)
|
|
UpdateIdentity(ctx context.Context, externalID, identityID string, req *updateIdentityRequest) error
|
|
DeleteIdentity(ctx context.Context, externalID, identityID string) error
|
|
ListSignatures(ctx context.Context, externalID string, params query.ListParams) (SignaturesList, error)
|
|
GetSignature(ctx context.Context, externalID, signatureID string) (map[string]any, error)
|
|
CreateSignature(ctx context.Context, externalID string, req *createSignatureRequest) (string, error)
|
|
UpdateSignature(ctx context.Context, externalID, signatureID string, req *updateSignatureRequest) error
|
|
DeleteSignature(ctx context.Context, externalID, signatureID string) error
|
|
ListFolders(ctx context.Context, externalID, accountID string, params query.ListParams) (FoldersList, error)
|
|
GetFolder(ctx context.Context, externalID, folderID string) (map[string]any, error)
|
|
CreateFolder(ctx context.Context, userID string, req *createFolderRequest) (string, error)
|
|
UpdateFolder(ctx context.Context, externalID, folderID string, req *updateFolderRequest) error
|
|
DeleteFolder(ctx context.Context, externalID, folderID string) error
|
|
ListUserLabels(ctx context.Context, externalID string, params query.ListParams) (UserLabelsList, error)
|
|
CreateUserLabel(ctx context.Context, externalID string, req *createUserLabelRequest) (string, error)
|
|
UpdateUserLabel(ctx context.Context, externalID, labelID string, req *updateUserLabelRequest) error
|
|
DeleteUserLabel(ctx context.Context, externalID, labelID string) error
|
|
ReorderUserLabels(ctx context.Context, externalID string, req *reorderLabelsRequest) error
|
|
ReorderUnifiedFolders(ctx context.Context, externalID string, req *reorderUnifiedFoldersRequest) error
|
|
SearchMessages(ctx context.Context, externalID string, filter MessageSearchFilter, params query.ListParams) (MessageSearchResult, error)
|
|
ListMessageAttachments(ctx context.Context, externalID, messageID string) ([]map[string]any, error)
|
|
MessageAttachmentCIDMap(ctx context.Context, externalID, messageID string) (map[string]string, error)
|
|
UploadMessageAttachment(ctx context.Context, externalID, messageID, filename, contentType, contentID string, isInline bool, reader io.Reader, size int64) (string, error)
|
|
OpenAttachment(ctx context.Context, externalID, attachmentID string) (filename, contentType string, size int64, isInline bool, body io.ReadCloser, err error)
|
|
UploadDraftAttachment(ctx context.Context, externalID, draftID, filename, contentType, contentID string, isInline bool, reader io.Reader, size int64) (string, error)
|
|
OpenDraftAttachment(ctx context.Context, externalID, draftID, attachmentID string) (filename, contentType string, body io.ReadCloser, err error)
|
|
SaveAttachmentToDrive(ctx context.Context, externalID, email, sub, displayName, messageID, attachmentID, folderPath string) (string, error)
|
|
SaveMessageAttachmentsToDrive(ctx context.Context, externalID, email, sub, displayName, messageID, folderPath string) ([]map[string]any, error)
|
|
}
|
|
|
|
var _ ServiceAPI = (*Service)(nil)
|