Skip to main content

Email Plugin Types

EventWithContext​

@vendure/email-plugintypes.ts

A VendureEvent which also includes a ctx property containing the current RequestContext, which is used to determine the channel and language to use when generating the email.

Signature
type EventWithContext = VendureEvent & { ctx: RequestContext }

EventWithAsyncData​

@vendure/email-plugintypes.ts

A VendureEvent with a RequestContext and a data property which contains the value resolved from the EmailEventHandler.loadData() callback.

Signature
type EventWithAsyncData<Event extends EventWithContext, R> = Event & { data: R }

EmailDetails​

@vendure/email-plugintypes.ts

The final, generated email details to be sent.

Signature
interface EmailDetails<Type extends 'serialized' | 'unserialized' = 'unserialized'> {
    from: string;
    recipient: string;
    subject: string;
    body: string;
    attachments: Array<Type extends 'serialized' ? SerializedAttachment : Attachment>;
    cc?: string;
    bcc?: string;
    replyTo?: string;
}

from​

property
string

recipient​

property
string

subject​

property
string

body​

property
string

attachments​

property
Array<Type extends 'serialized' ? SerializedAttachment : Attachment>

cc​

property
string

bcc​

property
string

replyTo​

property
string

LoadDataFn​

@vendure/email-plugintypes.ts

A function used to load async data for use by an EmailEventHandler.

Signature
type LoadDataFn<Event extends EventWithContext, R> = (context: {
    event: Event;
    injector: Injector;
}) => Promise<R>

EmailAttachment​

@vendure/email-plugintypes.ts

An object defining a file attachment for an email. Based on the object described here in the Nodemailer docs, but only uses the path property to define a filesystem path or a URL pointing to the attachment file.

Signature
type EmailAttachment = Omit<Attachment, 'raw'> & { path?: string }

SetTemplateVarsFn​

@vendure/email-plugintypes.ts

A function used to define template variables available to email templates. See EmailEventHandler.setTemplateVars().

Signature
type SetTemplateVarsFn<Event> = (
    event: Event,
    globals: { [key: string]: any },
) => { [key: string]: any }

SetAttachmentsFn​

@vendure/email-plugintypes.ts

A function used to define attachments to be sent with the email. See https://nodemailer.com/message/attachments/ for more information about how attachments work in Nodemailer.

Signature
type SetAttachmentsFn<Event> = (event: Event) => EmailAttachment[] | Promise<EmailAttachment[]>

SetSubjectFn​

@vendure/email-plugintypes.ts

A function used to define the subject to be sent with the email.

Signature
type SetSubjectFn<Event> = (
    event: Event,
    ctx: RequestContext,
    injector: Injector,
) => string | Promise<string>

OptionalAddressFields​

@vendure/email-plugintypes.ts
v1.1.0

Optional address-related fields for sending the email.

Signature
interface OptionalAddressFields {
    cc?: string;
    bcc?: string;
    replyTo?: string;
}

cc​

property
string

Comma separated list of recipients email addresses that will appear on the Cc: field

bcc​

property
string

Comma separated list of recipients email addresses that will appear on the Bcc: field

replyTo​

property
string

An email address that will appear on the Reply-To: field

SetOptionalAddressFieldsFn​

@vendure/email-plugintypes.ts
v1.1.0

A function used to set the OptionalAddressFields.

Signature
type SetOptionalAddressFieldsFn<Event> = (
    event: Event,
) => OptionalAddressFields | Promise<OptionalAddressFields>