@atlantjs/backend 7.1.24 → 7.2.1

package/backend/application/envs/env-vars.d.ts

@@ -1,5 +1,10 @@
 import { EnvironmentPoint } from "@atlantjs/arch";
+import { EmailDeliveryProviderPoint } from "../../../email-delivery/points/email-delivery-provider.point";
 export declare const APP_PORT: number;
 export declare const LOAD_MODULES: string[];
 export declare const CORS_ALLOWED_ORIGINS: string;
 export declare const ENVIRONMENT: EnvironmentPoint;
+export declare const EMAIL_DELIVERY_SERVICE_PROVIDER: EmailDeliveryProviderPoint;
+export declare const EMAIL_DELIVERY_FALLBACK_PROVIDER: EmailDeliveryProviderPoint;
+export declare const RESEND_API_KEY: string;
+export declare const AWS_REGION: string;

package/backend/application/envs/env-vars.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ENVIRONMENT = exports.CORS_ALLOWED_ORIGINS = exports.LOAD_MODULES = exports.APP_PORT = void 0;
+exports.AWS_REGION = exports.RESEND_API_KEY = exports.EMAIL_DELIVERY_FALLBACK_PROVIDER = exports.EMAIL_DELIVERY_SERVICE_PROVIDER = exports.ENVIRONMENT = exports.CORS_ALLOWED_ORIGINS = exports.LOAD_MODULES = exports.APP_PORT = void 0;
 const arch_1 = require("@atlantjs/arch");
 const parchment_1 = require("@atlantjs/parchment");
+const email_delivery_provider_point_1 = require("../../../email-delivery/points/email-delivery-provider.point");
 exports.APP_PORT = parchment_1.Parchment.verse({
     name: "APP_PORT",
     type: "port-number",
@@ -34,3 +35,35 @@ exports.ENVIRONMENT = parchment_1.Parchment.verse({
     ],
     description: "The current environment in which the application is running",
 });
+exports.EMAIL_DELIVERY_SERVICE_PROVIDER = parchment_1.Parchment.verse({
+    name: "EMAIL_DELIVERY_SERVICE_PROVIDER",
+    type: "enum",
+    isRequired: true,
+    values: [
+        email_delivery_provider_point_1.EmailDeliveryProviderPoint.amazonSES,
+        email_delivery_provider_point_1.EmailDeliveryProviderPoint.resend,
+    ],
+    description: "The current environment in which the application is running",
+});
+exports.EMAIL_DELIVERY_FALLBACK_PROVIDER = parchment_1.Parchment.verse({
+    name: "EMAIL_DELIVERY_FALLBACK_PROVIDER",
+    type: "enum",
+    isRequired: true,
+    values: [
+        email_delivery_provider_point_1.EmailDeliveryProviderPoint.amazonSES,
+        email_delivery_provider_point_1.EmailDeliveryProviderPoint.resend,
+    ],
+    description: "The current environment in which the application is running",
+});
+exports.RESEND_API_KEY = parchment_1.Parchment.verse({
+    name: "RESEND_API_KEY",
+    type: "text",
+    isRequired: true,
+    description: "API key used to authenticate requests to the Resend email delivery service",
+});
+exports.AWS_REGION = parchment_1.Parchment.verse({
+    name: "AWS_REGION",
+    type: "text",
+    isRequired: true,
+    description: "Specifies the AWS region to be used by the application",
+});

package/email-delivery/email-delivery.factory.d.ts

@@ -0,0 +1,4 @@
+import { EmailDeliveryProviderParamsInterface } from "./email-delivery.provider.type";
+export declare class EmailDeliveryProvider {
+    static send({ to, from, subject, html, }: EmailDeliveryProviderParamsInterface): Promise<void>;
+}

package/email-delivery/email-delivery.factory.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailDeliveryProvider = void 0;
+const env_vars_1 = require("../backend/application/envs/env-vars");
+const email_delivery_service_1 = require("./email-delivery.service");
+const email_delivery_provider_point_1 = require("./points/email-delivery-provider.point");
+const email_delivery_amazon_ses_provider_1 = require("./providers/email-delivery-amazon-ses.provider");
+const email_delivery_resend_provider_1 = require("./providers/email-delivery-resend.provider");
+function createEmailServiceProvider() {
+    switch (env_vars_1.EMAIL_DELIVERY_SERVICE_PROVIDER) {
+        case email_delivery_provider_point_1.EmailDeliveryProviderPoint.amazonSES:
+            return new email_delivery_amazon_ses_provider_1.SESProvider();
+        default:
+            return new email_delivery_resend_provider_1.ResendProvider();
+    }
+}
+function createEmailFallBackProvider() {
+    switch (env_vars_1.EMAIL_DELIVERY_FALLBACK_PROVIDER) {
+        case email_delivery_provider_point_1.EmailDeliveryProviderPoint.amazonSES:
+            return new email_delivery_amazon_ses_provider_1.SESProvider();
+        default:
+            return new email_delivery_resend_provider_1.ResendProvider();
+    }
+}
+const emailService = new email_delivery_service_1.EmailDeliveryService(createEmailServiceProvider());
+const emailFallback = new email_delivery_service_1.EmailDeliveryService(createEmailFallBackProvider());
+class EmailDeliveryProvider {
+    static async send({ to, from, subject, html, }) {
+        try {
+            await emailService.send({ to, from, subject, html });
+        }
+        catch {
+            await emailFallback.send({ to, from, subject, html });
+        }
+    }
+}
+exports.EmailDeliveryProvider = EmailDeliveryProvider;

package/email-delivery/email-delivery.provider.type.d.ts

@@ -0,0 +1,9 @@
+export interface EmailDeliveryProviderParamsInterface {
+    to: string;
+    subject: string;
+    html: string;
+    from: string;
+}
+export interface EmailDeliveryProviderInterface {
+    send(params: EmailDeliveryProviderParamsInterface): Promise<void>;
+}

package/email-delivery/email-delivery.provider.type.js

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

package/email-delivery/email-delivery.service.d.ts

@@ -0,0 +1,6 @@
+import { EmailDeliveryProviderInterface, EmailDeliveryProviderParamsInterface } from "./email-delivery.provider.type";
+export declare class EmailDeliveryService {
+    private provider;
+    constructor(provider: EmailDeliveryProviderInterface);
+    send(params: EmailDeliveryProviderParamsInterface): Promise<void>;
+}

package/email-delivery/email-delivery.service.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailDeliveryService = void 0;
+class EmailDeliveryService {
+    constructor(provider) {
+        this.provider = provider;
+    }
+    async send(params) {
+        return this.provider.send(params);
+    }
+}
+exports.EmailDeliveryService = EmailDeliveryService;

package/email-delivery/points/email-delivery-provider.point.d.ts

@@ -0,0 +1,4 @@
+export declare enum EmailDeliveryProviderPoint {
+    resend = "resend",
+    amazonSES = "amazonSES"
+}

package/email-delivery/points/email-delivery-provider.point.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailDeliveryProviderPoint = void 0;
+var EmailDeliveryProviderPoint;
+(function (EmailDeliveryProviderPoint) {
+    EmailDeliveryProviderPoint["resend"] = "resend";
+    EmailDeliveryProviderPoint["amazonSES"] = "amazonSES";
+})(EmailDeliveryProviderPoint || (exports.EmailDeliveryProviderPoint = EmailDeliveryProviderPoint = {}));

package/email-delivery/providers/email-delivery-amazon-ses.provider.d.ts

@@ -0,0 +1,4 @@
+import { EmailDeliveryProvider } from "../email-delivery.factory";
+export declare class SESProvider implements EmailDeliveryProvider {
+    send({ to, subject, html, from }: any): Promise<void>;
+}

package/email-delivery/providers/email-delivery-amazon-ses.provider.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SESProvider = void 0;
+const client_ses_1 = require("@aws-sdk/client-ses");
+const env_vars_1 = require("../../backend/application/envs/env-vars");
+const ses = new client_ses_1.SESClient({
+    region: env_vars_1.AWS_REGION,
+});
+class SESProvider {
+    async send({ to, subject, html, from }) {
+        const command = new client_ses_1.SendEmailCommand({
+            Source: from,
+            Destination: {
+                ToAddresses: [to],
+            },
+            Message: {
+                Subject: { Data: subject },
+                Body: {
+                    Html: { Data: html },
+                },
+            },
+        });
+        await ses.send(command);
+    }
+}
+exports.SESProvider = SESProvider;

package/email-delivery/providers/email-delivery-resend.provider.d.ts

@@ -0,0 +1,4 @@
+import { EmailDeliveryProvider } from "../email-delivery.factory";
+export declare class ResendProvider implements EmailDeliveryProvider {
+    send({ to, subject, html, from }: any): Promise<void>;
+}

package/email-delivery/providers/email-delivery-resend.provider.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResendProvider = void 0;
+const resend_1 = require("resend");
+const env_vars_1 = require("../../backend/application/envs/env-vars");
+const resend = new resend_1.Resend(env_vars_1.RESEND_API_KEY);
+class ResendProvider {
+    async send({ to, subject, html, from }) {
+        await resend.emails.send({
+            from,
+            to,
+            subject,
+            html,
+        });
+    }
+}
+exports.ResendProvider = ResendProvider;

package/index.d.ts

@@ -22,3 +22,4 @@ export { initializeApi } from "./setup";
 export { InjectionsAbstract } from "./backend/application/injections.abstract";
 export { Injections } from "./backend/application/injections.abstract.type";
 export { ControllerResponse } from "./backend/infrastructure/controllers/controller-response.abstract";
+export { EmailDeliveryProvider } from "./email-delivery/email-delivery.factory";

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ControllerResponse = exports.InjectionsAbstract = exports.initializeApi = exports.injectable = exports.inject = exports.Container = exports.Server = exports.DefaultErrorHandlerMiddleware = exports.CorsMiddleware = exports.BodyParserMiddleware = exports.DiContainerAbstract = exports.diContainer = exports.startContainer = exports.ValidatorAbstract = exports.ControllerAbstract = exports.CommandAbstract = exports.ServiceAbstract = exports.RepositoryAbstract = exports.ProviderAbstract = exports.MiddlewareHandlerAbstract = exports.BeforeUpdate = exports.BeforeInsert = exports.ManyToMany = exports.OneToOne = exports.OneToMany = exports.ManyToOne = exports.JoinColumn = exports.Entity = exports.Column = exports.PrimaryColumn = exports.ENVIRONMENT = exports.CORS_ALLOWED_ORIGINS = exports.LOAD_MODULES = exports.APP_PORT = exports.Params = exports.Param = exports.Req = exports.Body = exports.Res = exports.JsonController = exports.UseBefore = exports.Patch = exports.Delete = exports.Post = exports.Get = exports.getFromContainer = void 0;
+exports.EmailDeliveryProvider = exports.ControllerResponse = exports.InjectionsAbstract = exports.initializeApi = exports.injectable = exports.inject = exports.Container = exports.Server = exports.DefaultErrorHandlerMiddleware = exports.CorsMiddleware = exports.BodyParserMiddleware = exports.DiContainerAbstract = exports.diContainer = exports.startContainer = exports.ValidatorAbstract = exports.ControllerAbstract = exports.CommandAbstract = exports.ServiceAbstract = exports.RepositoryAbstract = exports.ProviderAbstract = exports.MiddlewareHandlerAbstract = exports.BeforeUpdate = exports.BeforeInsert = exports.ManyToMany = exports.OneToOne = exports.OneToMany = exports.ManyToOne = exports.JoinColumn = exports.Entity = exports.Column = exports.PrimaryColumn = exports.ENVIRONMENT = exports.CORS_ALLOWED_ORIGINS = exports.LOAD_MODULES = exports.APP_PORT = exports.Params = exports.Param = exports.Req = exports.Body = exports.Res = exports.JsonController = exports.UseBefore = exports.Patch = exports.Delete = exports.Post = exports.Get = exports.getFromContainer = void 0;
 require("./backend/application/envs/load-envs");
 require("reflect-metadata");
 const setup_1 = require("./setup");
@@ -71,3 +71,5 @@ var injections_abstract_1 = require("./backend/application/injections.abstract")
 Object.defineProperty(exports, "InjectionsAbstract", { enumerable: true, get: function () { return injections_abstract_1.InjectionsAbstract; } });
 var controller_response_abstract_1 = require("./backend/infrastructure/controllers/controller-response.abstract");
 Object.defineProperty(exports, "ControllerResponse", { enumerable: true, get: function () { return controller_response_abstract_1.ControllerResponse; } });
+var email_delivery_factory_1 = require("./email-delivery/email-delivery.factory");
+Object.defineProperty(exports, "EmailDeliveryProvider", { enumerable: true, get: function () { return email_delivery_factory_1.EmailDeliveryProvider; } });

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlantjs/backend",
-	"version": "7.1.24",
+	"version": "7.2.1",
 	"main": "index.js",
 	"license": "UNLICENSED",
 	"publishConfig": {
@@ -28,9 +28,10 @@
 		"test:unit:cov": "yarn test:unit --coverage --runInBand"
 	},
 	"dependencies": {
-		"@atlantjs/arch": "14.0.3",
-		"@atlantjs/database": "1.0.29",
-		"@atlantjs/parchment": "1.0.21",
+		"@atlantjs/arch": "14.0.4",
+		"@atlantjs/database": "1.0.30",
+		"@atlantjs/parchment": "1.0.22",
+		"@aws-sdk/client-ses": "3.1009.0",
 		"body-parser": "1.20.2",
 		"class-transformer": "0.5.1",
 		"class-validator": "0.14.1",
@@ -40,9 +41,10 @@
 		"express": "4.19.2",
 		"helmet": "7.1.0",
 		"inversify": "6.0.2",
-		"lodash": "^4.17.21",
+		"lodash": "4.17.21",
 		"module-alias": "2.2.3",
 		"reflect-metadata": "0.2.2",
+		"resend": "6.9.3",
 		"routing-controllers": "0.10.4",
 		"routing-controllers-openapi": "4.0.0"
 	},
@@ -51,7 +53,7 @@
 		"@types/cookie-parser": "1.4.8",
 		"@types/cors": "2.8.17",
 		"@types/express": "5.0.0",
-		"@types/lodash": "^4.17.16",
+		"@types/lodash": "4.17.16",
 		"@types/node": "22.13.5",
 		"copyfiles": "2.4.1",
 		"cross-env": "7.0.3",