@openinc/parse-server-opendash 3.28.0 → 3.29.0

package/dist/features/config/helper/customOptions.js

@@ -276,14 +276,7 @@ exports.customoptions = {
         public: true,
         default: "false",
         description: "Enable SMTP for sending e-mails.",
-        dependencies: [
-            "SMTP_HOST",
-            "SMTP_PORT",
-            "SMTP_USER",
-            "SMTP_PASS",
-            "SMTP_FROM",
-            "SMTP_SECURE",
-        ],
+        dependencies: ["SMTP_HOST", "SMTP_PORT", "SMTP_FROM", "SMTP_SECURE"],
     },
     SMTP_HOST: {
         env: "OPENINC_PARSE_SMTP_HOST",

package/dist/features/notifications/index.d.ts

@@ -2,3 +2,6 @@ export { FunctionKeys, NotificationInterface, NotificationMap, } from "./types/N
 export { Notifications } from "./types/Notifications";
 export { RegisteredNotification } from "./states/NotificationClass";
 export { getAllNotifications, default as initNotifications, } from "./services/registerNotification";
+export { EmailState } from "./states/EmailState";
+export { sendSimpleEmail, sendTemplateEmail } from "./services/sendMails";
+export { initEmailTransport } from "./services/initEmailTransport";

package/dist/features/notifications/index.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initNotifications = exports.getAllNotifications = exports.RegisteredNotification = exports.Notifications = void 0;
+exports.initEmailTransport = exports.sendTemplateEmail = exports.sendSimpleEmail = exports.EmailState = exports.initNotifications = exports.getAllNotifications = exports.RegisteredNotification = exports.Notifications = void 0;
 var Notifications_1 = require("./types/Notifications");
 Object.defineProperty(exports, "Notifications", { enumerable: true, get: function () { return Notifications_1.Notifications; } });
 var NotificationClass_1 = require("./states/NotificationClass");
@@ -11,3 +11,10 @@ Object.defineProperty(exports, "RegisteredNotification", { enumerable: true, get
 var registerNotification_1 = require("./services/registerNotification");
 Object.defineProperty(exports, "getAllNotifications", { enumerable: true, get: function () { return registerNotification_1.getAllNotifications; } });
 Object.defineProperty(exports, "initNotifications", { enumerable: true, get: function () { return __importDefault(registerNotification_1).default; } });
+var EmailState_1 = require("./states/EmailState");
+Object.defineProperty(exports, "EmailState", { enumerable: true, get: function () { return EmailState_1.EmailState; } });
+var sendMails_1 = require("./services/sendMails");
+Object.defineProperty(exports, "sendSimpleEmail", { enumerable: true, get: function () { return sendMails_1.sendSimpleEmail; } });
+Object.defineProperty(exports, "sendTemplateEmail", { enumerable: true, get: function () { return sendMails_1.sendTemplateEmail; } });
+var initEmailTransport_1 = require("./services/initEmailTransport");
+Object.defineProperty(exports, "initEmailTransport", { enumerable: true, get: function () { return initEmailTransport_1.initEmailTransport; } });

package/dist/features/notifications/services/initEmailTransport.d.ts

@@ -0,0 +1 @@
+export declare function initEmailTransport(): Promise<void>;

package/dist/features/notifications/services/initEmailTransport.js

@@ -0,0 +1,45 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initEmailTransport = initEmailTransport;
+const nodemailer_1 = __importDefault(require("nodemailer"));
+const nunjucks_1 = __importDefault(require("nunjucks"));
+const path_1 = require("path");
+const __1 = require("..");
+const config_1 = require("../../config");
+async function initEmailTransport() {
+    const emailState = __1.EmailState.getInstance();
+    try {
+        if (config_1.ConfigInstance.getInstance().getBoolean("SMTP_ENABLED")) {
+            const transportOptions = {
+                host: config_1.ConfigInstance.getInstance().get("SMTP_HOST"),
+                port: config_1.ConfigInstance.getInstance().getNumber("SMTP_PORT"),
+                secure: config_1.ConfigInstance.getInstance().getBoolean("SMTP_SECURE"),
+                ignoreTLS: config_1.ConfigInstance.getInstance().getBoolean("SMTP_IGNORE_TLS"),
+            };
+            if (config_1.ConfigInstance.getInstance().get("SMTP_USER") &&
+                config_1.ConfigInstance.getInstance().get("SMTP_PASS")) {
+                transportOptions.auth = {
+                    user: config_1.ConfigInstance.getInstance().get("SMTP_USER"),
+                    pass: config_1.ConfigInstance.getInstance().get("SMTP_PASS"),
+                };
+            }
+            const transport = nodemailer_1.default.createTransport(transportOptions);
+            await transport.verify();
+            emailState.setTransport(transport);
+            const templateDir = (0, path_1.resolve)(process.cwd(), config_1.ConfigInstance.getInstance().get("EMAIL_TEMPLATE_DIR"));
+            emailState.setEmailTemplateDir(templateDir);
+            nunjucks_1.default.configure(templateDir, { autoescape: true });
+            console.log("[@openinc/parse-server-opendash] Email transport initialized successfully");
+        }
+        else {
+            console.log("[@openinc/parse-server-opendash] SMTP disabled, skipping email transport initialization");
+        }
+    }
+    catch (error) {
+        console.error(`Parse SMTP Adapter: Error when trying to establish the SMTP connection:`);
+        console.error(error);
+    }
+}

package/dist/features/notifications/services/sendMails.d.ts

@@ -0,0 +1,21 @@
+import { Core_Email } from "../../../types";
+/**
+ * Send a simple email
+ * @param to The recipient email address
+ * @param subject The subject of the email
+ * @param text The plain text content of the email
+ * @returns The saved email object
+ */
+export declare function sendSimpleEmail(to: string, subject: string, text: string): Promise<Core_Email>;
+/**
+ * Send a template email
+ * @param param0
+ * @returns
+ */
+export declare function sendTemplateEmail({ to, subject, fallback, template, data, }: {
+    to: string;
+    subject: string;
+    fallback: string;
+    template: string;
+    data: any;
+}): Promise<Core_Email>;

package/dist/features/notifications/services/sendMails.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendSimpleEmail = sendSimpleEmail;
+exports.sendTemplateEmail = sendTemplateEmail;
+const fs_1 = __importDefault(require("fs"));
+const nunjucks_1 = __importDefault(require("nunjucks"));
+const path_1 = require("path");
+const types_1 = require("../../../types");
+const EmailState_1 = require("../states/EmailState");
+/**
+ * Send a simple email
+ * @param to The recipient email address
+ * @param subject The subject of the email
+ * @param text The plain text content of the email
+ * @returns The saved email object
+ */
+async function sendSimpleEmail(to, subject, text) {
+    const email = new types_1.Core_Email({
+        payload: {
+            to,
+            subject,
+            text,
+        },
+    });
+    await email.save(null, { useMasterKey: true });
+    return email;
+}
+/**
+ * Send a template email
+ * @param param0
+ * @returns
+ */
+async function sendTemplateEmail({ to, subject, fallback, template, data, }) {
+    const email = new types_1.Core_Email({
+        payload: {
+            to,
+            subject: renderEmailTemplate("subject", template, data, subject),
+            text: renderEmailTemplate("txt", template, data, fallback),
+            html: renderEmailTemplate("html", template, data, undefined),
+        },
+    });
+    await email.save(null, { useMasterKey: true });
+    return email;
+}
+/**
+ * Validate if an email template exists in the specified directory
+ * @param templateDir The directory where email templates are stored
+ * @param template The specific template file to validate
+ * @returns Whether the template exists in the directory
+ */
+function validateEmailTemplate(templateDir, template) {
+    const templatePath = (0, path_1.join)(templateDir, template);
+    if (!fs_1.default.existsSync(templateDir)) {
+        return false;
+    }
+    if (!fs_1.default.existsSync(templatePath)) {
+        return false;
+    }
+    return true;
+}
+/**
+ * Render an email template
+ * @param type The type of the email template (txt, html, subject)
+ * @param template The base name of the template file
+ * @param data The data to be used for rendering the template
+ * @param fallback The fallback content if the template is not found
+ * @returns The rendered email content
+ */
+function renderEmailTemplate(type, template, data, fallback) {
+    const emailState = EmailState_1.EmailState.getInstance();
+    const emailTemplateDir = emailState.getEmailTemplateDir();
+    const fullTemplate = template + "." + type;
+    if (validateEmailTemplate(emailTemplateDir, fullTemplate)) {
+        return nunjucks_1.default.render(fullTemplate, data);
+    }
+    if (type === "html") {
+        return renderEmailTemplate("txt", template, data, fallback);
+    }
+    return fallback || "";
+}

package/dist/features/notifications/states/EmailState.d.ts

@@ -0,0 +1,39 @@
+import { Transporter } from "nodemailer";
+import SMTPTransport from "nodemailer/lib/smtp-transport";
+/**
+ * Singleton class to manage email transport and template directory
+ */
+export declare class EmailState {
+    private static instance;
+    emailTemplateDir: string;
+    transport: Transporter<SMTPTransport.SentMessageInfo> | undefined;
+    private constructor();
+    /**
+     * Get the singleton instance
+     */
+    static getInstance(): EmailState;
+    /**
+     * Set the email transport
+     */
+    setTransport(transport: Transporter<SMTPTransport.SentMessageInfo>): void;
+    /**
+     * Get the email transport
+     */
+    getTransport(): Transporter<SMTPTransport.SentMessageInfo> | undefined;
+    /**
+     * Set the email template directory
+     */
+    setEmailTemplateDir(dir: string): void;
+    /**
+     * Get the email template directory
+     */
+    getEmailTemplateDir(): string;
+    /**
+     * Check if email transport is configured and ready
+     */
+    isConfigured(): boolean;
+    /**
+     * Reset the singleton (useful for testing)
+     */
+    static reset(): void;
+}

package/dist/features/notifications/states/EmailState.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailState = void 0;
+/**
+ * Singleton class to manage email transport and template directory
+ */
+class EmailState {
+    constructor() {
+        this.emailTemplateDir = "";
+        this.transport = undefined;
+    }
+    /**
+     * Get the singleton instance
+     */
+    static getInstance() {
+        if (!EmailState.instance) {
+            EmailState.instance = new EmailState();
+        }
+        return EmailState.instance;
+    }
+    /**
+     * Set the email transport
+     */
+    setTransport(transport) {
+        this.transport = transport;
+    }
+    /**
+     * Get the email transport
+     */
+    getTransport() {
+        return this.transport;
+    }
+    /**
+     * Set the email template directory
+     */
+    setEmailTemplateDir(dir) {
+        this.emailTemplateDir = dir;
+    }
+    /**
+     * Get the email template directory
+     */
+    getEmailTemplateDir() {
+        return this.emailTemplateDir;
+    }
+    /**
+     * Check if email transport is configured and ready
+     */
+    isConfigured() {
+        return this.transport !== undefined;
+    }
+    /**
+     * Reset the singleton (useful for testing)
+     */
+    static reset() {
+        EmailState.instance = undefined;
+    }
+}
+exports.EmailState = EmailState;

package/dist/hooks/Core_Email.d.ts

@@ -1,11 +1 @@
-import { Core_Email } from "../types";
-export declare function initEmailTransport(): Promise<void>;
-export declare function sendSimpleEmail(to: string, subject: string, text: string): Promise<Core_Email>;
-export declare function sendTemplateEmail({ to, subject, fallback, template, data, }: {
-    to: string;
-    subject: string;
-    fallback: string;
-    template: string;
-    data: any;
-}): Promise<Core_Email>;
 export declare function init(): Promise<void>;

package/dist/hooks/Core_Email.js

@@ -1,92 +1,16 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.initEmailTransport = initEmailTransport;
-exports.sendSimpleEmail = sendSimpleEmail;
-exports.sendTemplateEmail = sendTemplateEmail;
 exports.init = init;
-const fs_1 = __importDefault(require("fs"));
-const nodemailer_1 = __importDefault(require("nodemailer"));
-const nunjucks_1 = __importDefault(require("nunjucks"));
-const path_1 = require("path");
 const __1 = require("..");
 const config_1 = require("../features/config");
+const notifications_1 = require("../features/notifications");
 const types_1 = require("../types");
-let emailTemplateDir = "";
-let transport = undefined;
-async function initEmailTransport() {
-    try {
-        if (config_1.ConfigInstance.getInstance().getBoolean("SMTP_ENABLED")) {
-            transport = nodemailer_1.default.createTransport({
-                host: config_1.ConfigInstance.getInstance().get("SMTP_HOST"),
-                port: config_1.ConfigInstance.getInstance().getNumber("SMTP_PORT"),
-                secure: config_1.ConfigInstance.getInstance().getBoolean("SMTP_SECURE"),
-                ignoreTLS: config_1.ConfigInstance.getInstance().getBoolean("SMTP_IGNORE_TLS"),
-                auth: {
-                    user: config_1.ConfigInstance.getInstance().get("SMTP_USER"),
-                    pass: config_1.ConfigInstance.getInstance().get("SMTP_PASS"),
-                },
-            });
-            await transport.verify();
-            emailTemplateDir = (0, path_1.resolve)(process.cwd(), config_1.ConfigInstance.getInstance().get("EMAIL_TEMPLATE_DIR"));
-            nunjucks_1.default.configure(emailTemplateDir, { autoescape: true });
-        }
-    }
-    catch (error) {
-        console.error(`Parse SMTP Adapter: Error when trying to establish the SMTP connection:`);
-        console.error(error);
-        process.exit(1);
-    }
-}
-async function sendSimpleEmail(to, subject, text) {
-    const email = new types_1.Core_Email({
-        payload: {
-            to,
-            subject,
-            text,
-        },
-    });
-    await email.save(null, { useMasterKey: true });
-    return email;
-}
-async function sendTemplateEmail({ to, subject, fallback, template, data, }) {
-    const email = new types_1.Core_Email({
-        payload: {
-            to,
-            subject: renderEmailTemplate("subject", template, data, subject),
-            text: renderEmailTemplate("txt", template, data, fallback),
-            html: renderEmailTemplate("html", template, data, undefined),
-        },
-    });
-    await email.save(null, { useMasterKey: true });
-    return email;
-}
-function validateEmailTemplate(templateDir, template) {
-    const templatePath = (0, path_1.join)(templateDir, template);
-    if (!fs_1.default.existsSync(templateDir)) {
-        return false;
-    }
-    if (!fs_1.default.existsSync(templatePath)) {
-        return false;
-    }
-    return true;
-}
-function renderEmailTemplate(type, template, data, fallback) {
-    const fullTemplate = template + "." + type;
-    if (validateEmailTemplate(emailTemplateDir, fullTemplate)) {
-        return nunjucks_1.default.render(fullTemplate, data);
-    }
-    if (type === "html") {
-        return renderEmailTemplate("txt", template, data, fallback);
-    }
-    return fallback || "";
-}
 async function init() {
     (0, __1.beforeSaveHook)(types_1.Core_Email, async (request) => {
         const { object } = request;
         object.setACL(new Parse.ACL());
+        const emailState = notifications_1.EmailState.getInstance();
+        const transport = emailState.getTransport();
         if (!transport) {
             object.sent = false;
             object.success = false;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import type { Cloud as ParseCloud } from "parse";
 import { Permission } from "./types";
-export { sendSimpleEmail, sendTemplateEmail } from "./hooks/Core_Email";
+export { sendSimpleEmail, sendTemplateEmail } from "./features/notifications";
 /**
  * Initializes the Cloud Code for open.DASH.
  * This function performs various initialization tasks such as

package/dist/index.js

@@ -38,7 +38,6 @@ const types_1 = require("./types");
 const notifications_1 = require("./features/notifications");
 const permissions_1 = require("./features/permissions");
 const settings_1 = require("./features/user/settings");
-const Core_Email_1 = require("./hooks/Core_Email");
 const importDocs_1 = require("./features/documentation/functions/importDocs");
 const openservice_1 = require("./features/openservice");
 const translations_1 = require("./features/translations");
@@ -49,9 +48,9 @@ dayjs_1.default.extend(weekday_1.default);
 dayjs_1.default.extend(dayOfYear_1.default);
 dayjs_1.default.extend(weekOfYear_1.default);
 dayjs_1.default.extend(duration_1.default);
-var Core_Email_2 = require("./hooks/Core_Email");
-Object.defineProperty(exports, "sendSimpleEmail", { enumerable: true, get: function () { return Core_Email_2.sendSimpleEmail; } });
-Object.defineProperty(exports, "sendTemplateEmail", { enumerable: true, get: function () { return Core_Email_2.sendTemplateEmail; } });
+var notifications_2 = require("./features/notifications");
+Object.defineProperty(exports, "sendSimpleEmail", { enumerable: true, get: function () { return notifications_2.sendSimpleEmail; } });
+Object.defineProperty(exports, "sendTemplateEmail", { enumerable: true, get: function () { return notifications_2.sendTemplateEmail; } });
 const PREFIX = "OD3_";
 let config;
 // const lang_deu = require("../i18n/deu.json");
@@ -85,7 +84,7 @@ async function init() {
     config = config_1.ConfigInstance.getInstance();
     await config.init(true);
     await (0, translations_1.initTranslations)();
-    await (0, Core_Email_1.initEmailTransport)();
+    await (0, notifications_1.initEmailTransport)();
     await initWebPush();
     await initSchema();
     await initDefaultRoles();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openinc/parse-server-opendash",
-  "version": "3.28.0",
+  "version": "3.29.0",
   "description": "Parse Server Cloud Code for open.INC Stack.",
   "packageManager": "pnpm@10.20.0",
   "keywords": [