Class BaseCommunicationProvider`Abstract`

Base class for all communication providers. Each provider sub-classes this base class and implements functionality specific to the provider.

Remarks

All methods accept an optional credentials parameter that allows per-request credential overrides. When credentials are provided, they take precedence over environment variables. Set credentials.disableEnvironmentFallback = true to disable environment variable fallback.

Each provider defines its own credential interface that extends ProviderCredentialsBase. For example, SendGridCredentials, MSGraphCredentials, etc.

Example

// Use environment credentials (default behavior)
await provider.SendSingleMessage(message);

// Override with request credentials
await provider.SendSingleMessage(message, { apiKey: 'SG.xxx' });

// Require explicit credentials (no env fallback)
await provider.SendSingleMessage(message, {
    apiKey: 'SG.xxx',
    disableEnvironmentFallback: true
});

Hierarchy

BaseCommunicationProvider

Index

Constructors

constructor

new BaseCommunicationProvider(): BaseCommunicationProvider
Returns BaseCommunicationProvider

Accessors

`Protected` ProviderName

get ProviderName(): string
Returns the name of this provider for use in error messages. Override in subclasses to provide a more descriptive name.

Returns string
- Defined in Communication/base-types/src/BaseProvider.ts:787

Methods

ArchiveMessage

ArchiveMessage(params, credentials?): Promise<ArchiveMessageResult<Record<string, any>>>
Archives a message. Override in subclasses that support this operation.
Parameters
- params: ArchiveMessageParams<Record<string, any>>
  Parameters for archiving the message
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<ArchiveMessageResult<Record<string, any>>>
Promise - Result of the archive operation
- Defined in Communication/base-types/src/BaseProvider.ts:901

`Abstract` CreateDraft

CreateDraft(params, credentials?): Promise<CreateDraftResult<Record<string, any>>>
Creates a draft message using the provider. Providers that don't support drafts should return Success: false with an appropriate error message.
Parameters
- params: CreateDraftParams
  Parameters for creating the draft
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<CreateDraftResult<Record<string, any>>>
Promise - Result containing draft ID if successful
- Defined in Communication/base-types/src/BaseProvider.ts:773

DeleteMessage

DeleteMessage(params, credentials?): Promise<DeleteMessageResult<Record<string, any>>>
Deletes a message. Override in subclasses that support this operation.
Parameters
- params: DeleteMessageParams<Record<string, any>>
  Parameters for deleting the message
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<DeleteMessageResult<Record<string, any>>>
Promise - Result of the delete operation
- Defined in Communication/base-types/src/BaseProvider.ts:833

DownloadAttachment

DownloadAttachment(params, credentials?): Promise<DownloadAttachmentResult<Record<string, any>>>
Downloads an attachment from a message. Override in subclasses that support this operation.
Parameters
- params: DownloadAttachmentParams<Record<string, any>>
  Parameters for downloading the attachment
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<DownloadAttachmentResult<Record<string, any>>>
Promise - The attachment content
- Defined in Communication/base-types/src/BaseProvider.ts:952

`Abstract` ForwardMessage

ForwardMessage(params, credentials?): Promise<ForwardMessageResult<Record<string, any>>>
Forwards a message to another client using the provider
Parameters
- params: ForwardMessageParams
  Parameters for forwarding the message
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<ForwardMessageResult<Record<string, any>>>
Promise - Result of the forward operation
- Defined in Communication/base-types/src/BaseProvider.ts:749

`Abstract` GetMessages

GetMessages(params, credentials?): Promise<GetMessagesResult<Record<string, any>>>
Fetches messages using the provider
Parameters
- params: GetMessagesParams<Record<string, any>>
  Parameters for fetching messages
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<GetMessagesResult<Record<string, any>>>
Promise - Retrieved messages
- Defined in Communication/base-types/src/BaseProvider.ts:738

GetSingleMessage

GetSingleMessage(params, credentials?): Promise<GetSingleMessageResult<Record<string, any>>>
Gets a single message by ID. Override in subclasses that support this operation.
Parameters
- params: GetSingleMessageParams<Record<string, any>>
  Parameters for retrieving the message
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<GetSingleMessageResult<Record<string, any>>>
Promise - The retrieved message
- Defined in Communication/base-types/src/BaseProvider.ts:816

ListAttachments

ListAttachments(params, credentials?): Promise<ListAttachmentsResult<Record<string, any>>>
Lists attachments on a message. Override in subclasses that support this operation.
Parameters
- params: ListAttachmentsParams<Record<string, any>>
  Parameters for listing attachments
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<ListAttachmentsResult<Record<string, any>>>
Promise - The list of attachments
- Defined in Communication/base-types/src/BaseProvider.ts:935

ListFolders

ListFolders(params, credentials?): Promise<ListFoldersResult<Record<string, any>>>
Lists folders/mailboxes available in the provider. Override in subclasses that support this operation.
Parameters
- params: ListFoldersParams<Record<string, any>>
  Parameters for listing folders
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<ListFoldersResult<Record<string, any>>>
Promise - The list of folders
- Defined in Communication/base-types/src/BaseProvider.ts:867

MarkAsRead

MarkAsRead(params, credentials?): Promise<MarkAsReadResult<Record<string, any>>>
Marks message(s) as read or unread. Override in subclasses that support this operation.
Parameters
- params: MarkAsReadParams<Record<string, any>>
  Parameters for marking messages
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<MarkAsReadResult<Record<string, any>>>
Promise - Result of the operation
- Defined in Communication/base-types/src/BaseProvider.ts:884

MoveMessage

MoveMessage(params, credentials?): Promise<MoveMessageResult<Record<string, any>>>
Moves a message to a different folder. Override in subclasses that support this operation.
Parameters
- params: MoveMessageParams<Record<string, any>>
  Parameters for moving the message
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<MoveMessageResult<Record<string, any>>>
Promise - Result of the move operation
- Defined in Communication/base-types/src/BaseProvider.ts:850

`Abstract` ReplyToMessage

ReplyToMessage(params, credentials?): Promise<ReplyToMessageResult<Record<string, any>>>
Replies to a message using the provider
Parameters
- params: ReplyToMessageParams<Record<string, any>>
  Parameters for replying to the message
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<ReplyToMessageResult<Record<string, any>>>
Promise - Result of the reply operation
- Defined in Communication/base-types/src/BaseProvider.ts:760

SearchMessages

SearchMessages(params, credentials?): Promise<SearchMessagesResult<Record<string, any>>>
Searches messages using a query string. Override in subclasses that support this operation.
Parameters
- params: SearchMessagesParams<Record<string, any>>
  Parameters for searching messages
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request
Returns Promise<SearchMessagesResult<Record<string, any>>>
Promise - Messages matching the search criteria
- Defined in Communication/base-types/src/BaseProvider.ts:918

`Abstract` SendSingleMessage

SendSingleMessage(message, credentials?): Promise<MessageResult>
Sends a single message using the provider
Parameters
- message: ProcessedMessage
  The processed message to send
- Optional credentials: ProviderCredentialsBase
  Optional credentials override for this request. Provider-specific credential interface (e.g., SendGridCredentials). If not provided, uses environment variables.
Returns Promise<MessageResult>
Promise - Result of the send operation
- Defined in Communication/base-types/src/BaseProvider.ts:727

getSupportedOperations

getSupportedOperations(): ProviderOperation[]
Returns the list of operations supported by this provider. Override in subclasses to accurately reflect capabilities. Default implementation returns only the core abstract methods.

Returns ProviderOperation[]
- Defined in Communication/base-types/src/BaseProvider.ts:796

supportsOperation

supportsOperation(operation): boolean
Checks if this provider supports a specific operation.
Parameters
- operation: ProviderOperation
  The operation to check
Returns boolean
true if the operation is supported
- Defined in Communication/base-types/src/BaseProvider.ts:805

Class BaseCommunicationProviderAbstract

Remarks

Example

Hierarchy

Index

Constructors

Accessors

Methods

Constructors

constructor

Returns BaseCommunicationProvider

Accessors

Protected ProviderName

Returns string

Methods

ArchiveMessage

Parameters

Returns Promise<ArchiveMessageResult<Record<string, any>>>

Abstract CreateDraft

Parameters

Returns Promise<CreateDraftResult<Record<string, any>>>

DeleteMessage

Parameters

Returns Promise<DeleteMessageResult<Record<string, any>>>

DownloadAttachment

Parameters

Returns Promise<DownloadAttachmentResult<Record<string, any>>>

Abstract ForwardMessage

Parameters

Returns Promise<ForwardMessageResult<Record<string, any>>>

Abstract GetMessages

Parameters

Returns Promise<GetMessagesResult<Record<string, any>>>

GetSingleMessage

Parameters

Returns Promise<GetSingleMessageResult<Record<string, any>>>

ListAttachments

Parameters

Returns Promise<ListAttachmentsResult<Record<string, any>>>

ListFolders

Parameters

Returns Promise<ListFoldersResult<Record<string, any>>>

MarkAsRead

Parameters

Returns Promise<MarkAsReadResult<Record<string, any>>>

MoveMessage

Parameters

Returns Promise<MoveMessageResult<Record<string, any>>>

Abstract ReplyToMessage

Parameters

Returns Promise<ReplyToMessageResult<Record<string, any>>>

SearchMessages

Parameters

Returns Promise<SearchMessagesResult<Record<string, any>>>

Abstract SendSingleMessage

Parameters

Returns Promise<MessageResult>

getSupportedOperations

Returns ProviderOperation[]

supportsOperation

Parameters

Returns boolean

Settings

Member Visibility

Theme

On This Page

Class BaseCommunicationProvider`Abstract`

`Protected` ProviderName

`Abstract` CreateDraft

`Abstract` ForwardMessage

`Abstract` GetMessages

`Abstract` ReplyToMessage

`Abstract` SendSingleMessage