@webiny/api-mailer 0.0.0-ee-vpcs.549378cf03

package/types.d.ts

@@ -0,0 +1,149 @@
+import { CmsContext } from "@webiny/api-headless-cms/types";
+import { Topic } from "@webiny/pubsub/types";
+export interface MailerTransporterContext<T extends Transport = Transport> {
+    onTransportBeforeSend: Topic<OnTransportBeforeSendParams>;
+    onTransportAfterSend: Topic<OnTransportAfterSendParams>;
+    onTransportError: Topic<OnTransportErrorParams>;
+    getTransport: () => Promise<T | null>;
+    sendMail: <D>(data: TransportSendData) => Promise<TransportSendResponse<D>>;
+}
+export interface MailerSettingsCreateParams {
+    input: Partial<TransportSettings>;
+}
+export interface MailerSettingsUpdateParams {
+    input: Partial<TransportSettings>;
+    original?: ExtendedTransportSettings | null;
+}
+export interface MailerSettingsSaveParams {
+    input: Partial<TransportSettings>;
+}
+export interface OnSettingsBeforeGetTopicParams {
+    tenant: string;
+}
+export interface OnSettingsAfterGetTopicParams {
+    tenant: string;
+    settings: TransportSettings | null;
+}
+export interface OnSettingsGetErrorTopicParams {
+    tenant: string;
+    error: Error;
+}
+export interface OnSettingsBeforeCreateTopicParams {
+    settings: TransportSettings;
+}
+export interface OnSettingsAfterCreateTopicParams {
+    settings: TransportSettings;
+}
+export interface OnSettingsCreateErrorTopicParams {
+    settings: TransportSettings;
+    error: Error;
+}
+export interface OnSettingsBeforeUpdateTopicParams {
+    settings: TransportSettings;
+    original: TransportSettings;
+}
+export interface OnSettingsAfterUpdateTopicParams {
+    original: TransportSettings;
+    settings: TransportSettings;
+}
+export interface OnSettingsUpdateErrorTopicParams {
+    original: TransportSettings;
+    settings: TransportSettings;
+    error: Error;
+}
+export interface ExtendedTransportSettings extends TransportSettings {
+    id: string;
+}
+export interface MailerSettingsContext {
+    getSettings: () => Promise<ExtendedTransportSettings | null>;
+    /**
+     * Method should not be used outside of mailer
+     * @internal
+     */
+    createSettings: (params: MailerSettingsCreateParams) => Promise<TransportSettings>;
+    /**
+     * Method should not be used outside of mailer
+     * @internal
+     */
+    updateSettings: (params: MailerSettingsUpdateParams) => Promise<TransportSettings>;
+    /**
+     * Use to store the settings data.
+     */
+    saveSettings: (params: MailerSettingsSaveParams) => Promise<TransportSettings>;
+    /**
+     * Lifecycle events
+     */
+    onSettingsBeforeGet: Topic<OnSettingsBeforeGetTopicParams>;
+    onSettingsAfterGet: Topic<OnSettingsAfterGetTopicParams>;
+    onSettingsGetError: Topic<OnSettingsGetErrorTopicParams>;
+    onSettingsBeforeCreate: Topic<OnSettingsBeforeCreateTopicParams>;
+    onSettingsAfterCreate: Topic<OnSettingsAfterCreateTopicParams>;
+    onSettingsCreateError: Topic<OnSettingsCreateErrorTopicParams>;
+    onSettingsBeforeUpdate: Topic<OnSettingsBeforeUpdateTopicParams>;
+    onSettingsAfterUpdate: Topic<OnSettingsAfterUpdateTopicParams>;
+    onSettingsUpdateError: Topic<OnSettingsUpdateErrorTopicParams>;
+}
+export interface MailerContextObject<T extends Transport = Transport> extends MailerTransporterContext<T>, MailerSettingsContext {
+}
+export interface MailerContext extends CmsContext {
+    mailer: MailerContextObject;
+}
+export interface OnTransportBeforeSendParams {
+    data: TransportSendData;
+    transport: Transport;
+}
+export interface OnTransportAfterSendParams {
+    data: TransportSendData;
+    transport: Transport;
+}
+export interface OnTransportErrorParams {
+    error: Error;
+    data: TransportSendData;
+    transport: Transport;
+}
+/**
+ * Interface to implement the actual mailer.
+ */
+export interface TransportSendResponse<T = any> {
+    result: T | null;
+    error: {
+        message: string;
+        code: string;
+        data?: {
+            [key: string]: any;
+        };
+    } | null;
+}
+interface TransportSendToData {
+    to: string[];
+}
+interface TransportSendCcData {
+    cc: string[];
+}
+interface TransportSendBccData {
+    bcc: string[];
+}
+interface BaseTransportSendData {
+    to?: string[];
+    cc?: string[];
+    bcc?: string[];
+    from?: string;
+    subject: string;
+    text: string;
+    html?: string;
+    replyTo?: string;
+}
+export declare type TransportSendData = BaseTransportSendData & (TransportSendToData | TransportSendBccData | TransportSendCcData);
+export interface Transport<T = any> {
+    name: string;
+    send: (params: TransportSendData) => Promise<TransportSendResponse<T>>;
+}
+export interface TransportSettings {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    from: string;
+    replyTo?: string;
+}
+export {};

package/types.js

@@ -0,0 +1,5 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});

package/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sources":["types.ts"],"sourcesContent":["import { CmsContext } from \"@webiny/api-headless-cms/types\";\nimport { Topic } from \"@webiny/pubsub/types\";\n\nexport interface MailerTransporterContext<T extends Transport = Transport> {\n    onTransportBeforeSend: Topic<OnTransportBeforeSendParams>;\n    onTransportAfterSend: Topic<OnTransportAfterSendParams>;\n    onTransportError: Topic<OnTransportErrorParams>;\n    getTransport: () => Promise<T | null>;\n    sendMail: <D>(data: TransportSendData) => Promise<TransportSendResponse<D>>;\n}\n\nexport interface MailerSettingsCreateParams {\n    input: Partial<TransportSettings>;\n}\nexport interface MailerSettingsUpdateParams {\n    input: Partial<TransportSettings>;\n    original?: ExtendedTransportSettings | null;\n}\n\nexport interface MailerSettingsSaveParams {\n    input: Partial<TransportSettings>;\n}\n\nexport interface OnSettingsBeforeGetTopicParams {\n    tenant: string;\n}\n\nexport interface OnSettingsAfterGetTopicParams {\n    tenant: string;\n    settings: TransportSettings | null;\n}\n\nexport interface OnSettingsGetErrorTopicParams {\n    tenant: string;\n    error: Error;\n}\n\nexport interface OnSettingsBeforeCreateTopicParams {\n    settings: TransportSettings;\n}\n\nexport interface OnSettingsAfterCreateTopicParams {\n    settings: TransportSettings;\n}\n\nexport interface OnSettingsCreateErrorTopicParams {\n    settings: TransportSettings;\n    error: Error;\n}\n\nexport interface OnSettingsBeforeUpdateTopicParams {\n    settings: TransportSettings;\n    original: TransportSettings;\n}\n\nexport interface OnSettingsAfterUpdateTopicParams {\n    original: TransportSettings;\n    settings: TransportSettings;\n}\n\nexport interface OnSettingsUpdateErrorTopicParams {\n    original: TransportSettings;\n    settings: TransportSettings;\n    error: Error;\n}\n\nexport interface ExtendedTransportSettings extends TransportSettings {\n    id: string;\n}\n\nexport interface MailerSettingsContext {\n    getSettings: () => Promise<ExtendedTransportSettings | null>;\n    /**\n     * Method should not be used outside of mailer\n     * @internal\n     */\n    createSettings: (params: MailerSettingsCreateParams) => Promise<TransportSettings>;\n    /**\n     * Method should not be used outside of mailer\n     * @internal\n     */\n    updateSettings: (params: MailerSettingsUpdateParams) => Promise<TransportSettings>;\n    /**\n     * Use to store the settings data.\n     */\n    saveSettings: (params: MailerSettingsSaveParams) => Promise<TransportSettings>;\n    /**\n     * Lifecycle events\n     */\n    onSettingsBeforeGet: Topic<OnSettingsBeforeGetTopicParams>;\n    onSettingsAfterGet: Topic<OnSettingsAfterGetTopicParams>;\n    onSettingsGetError: Topic<OnSettingsGetErrorTopicParams>;\n    onSettingsBeforeCreate: Topic<OnSettingsBeforeCreateTopicParams>;\n    onSettingsAfterCreate: Topic<OnSettingsAfterCreateTopicParams>;\n    onSettingsCreateError: Topic<OnSettingsCreateErrorTopicParams>;\n    onSettingsBeforeUpdate: Topic<OnSettingsBeforeUpdateTopicParams>;\n    onSettingsAfterUpdate: Topic<OnSettingsAfterUpdateTopicParams>;\n    onSettingsUpdateError: Topic<OnSettingsUpdateErrorTopicParams>;\n}\n\nexport interface MailerContextObject<T extends Transport = Transport>\n    extends MailerTransporterContext<T>,\n        MailerSettingsContext {}\nexport interface MailerContext extends CmsContext {\n    mailer: MailerContextObject;\n}\n\nexport interface OnTransportBeforeSendParams {\n    data: TransportSendData;\n    transport: Transport;\n}\nexport interface OnTransportAfterSendParams {\n    data: TransportSendData;\n    transport: Transport;\n}\nexport interface OnTransportErrorParams {\n    error: Error;\n    data: TransportSendData;\n    transport: Transport;\n}\n\n/**\n * Interface to implement the actual mailer.\n */\nexport interface TransportSendResponse<T = any> {\n    result: T | null;\n    error: {\n        message: string;\n        code: string;\n        data?: {\n            [key: string]: any;\n        };\n    } | null;\n}\n\ninterface TransportSendToData {\n    to: string[];\n}\ninterface TransportSendCcData {\n    cc: string[];\n}\ninterface TransportSendBccData {\n    bcc: string[];\n}\n\ninterface BaseTransportSendData {\n    to?: string[];\n    cc?: string[];\n    bcc?: string[];\n    from?: string;\n    subject: string;\n    text: string;\n    html?: string;\n    replyTo?: string;\n}\n\nexport type TransportSendData = BaseTransportSendData &\n    (TransportSendToData | TransportSendBccData | TransportSendCcData);\nexport interface Transport<T = any> {\n    name: string;\n    send: (params: TransportSendData) => Promise<TransportSendResponse<T>>;\n}\n\nexport interface TransportSettings {\n    host: string;\n    port: number;\n    user: string;\n    password: string;\n    from: string;\n    replyTo?: string;\n}\n"],"mappings":""}