fiberx-backend-toolkit 0.0.78 → 0.1.0

package/dist/code_templates/email_enqueue_code_template.js

@@ -19,6 +19,7 @@ const GENERATE_NOTIFICATION_CODE_TYPE = (interface_name, db_obj, code) => {
  */
 export interface ${interface_name} {
 ${objectToType(db_obj, 8)}
+    attachment?s: EmailAttachmentInterface[]
 }
 `;
 };
@@ -53,6 +54,7 @@ const GENERATE_UTIL_METHOD_CODE = (interface_name, method_name, code) => {
 exports.GENERATE_UTIL_METHOD_CODE = GENERATE_UTIL_METHOD_CODE;
 const GENERATE_UTIL_CLASS_CODE = (types_file_name, generated_content) => {
     return `
+import { EmailAttachmentInterface } from "fiberx-backend-toolkit";
 import { EmailEnqueueProcessor } from "fiberx-backend-toolkit/dist/mailer/main";
 import { LoggerUtil } from "fiberx-backend-toolkit/dist/utils/main";
 import * as Types from "@/${types_file_name.replace(".ts", "")}";

package/dist/config/constants.d.ts

@@ -7,6 +7,7 @@ export declare const MODELS_DIR: string;
 export declare const MIGRATIONS_DIR: string;
 export declare const SEEDERS_DIR: string;
 export declare const EMAIL_ENQUEUE_DIR: string;
+export declare const EMAIL_PREVIEW_DIR: string;
 export declare const SEQUELIZE_META_TABLE_NAME = "sequelize_database_tables_meta";
 export declare const SEQUELIZE_SEEDER_META_TABLE_NAME = "sequelize_database_table_seeder_meta";
 export declare const REQUEST_ID_COOKIE_MAX_AGE: number;

package/dist/config/constants.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.DEFAULT_CONTENT_CACHE_TTL = exports.DEFAULT_CONTENT_LANG = exports.DEFAULT_CONTENT_URL = exports.CONTENT_LANG_KEY = exports.CONTENT_URL_KEY = exports.CONTENT_CACHE_TTL_KEY = exports.EMAIL_ENQUEUE_UTIL_FILE_NAME = exports.EMAIL_ENQUEUE_TYPES_FILE_NAME = exports.DEFAULT_MAILER_CACHE_TTL = exports.DEFAULT_MAILER_CACHE_KEY = exports.DEFAULT_RBAC_CACHE_TTL = exports.DEFAULT_RBAC_CACHE_KEY = exports.DEFAULT_TOTP_WINDOW = exports.DEFAULT_TOTP_DIGITS = exports.DEFAULT_TOTP_STEP = exports.ALPHABET_CORPUS = exports.CHARACTER_CORPUS = exports.REQUEST_RATE_LIMITTER_OPTIONS = exports.CORS_MAX_AGE_IN_MICRO_SECONDS = exports.CORS_MAX_AGE_IN_SECONDS = exports.CORS_ALLOWED_HEADERS = exports.HEADERS_KEY_NAME = exports.CORS_ALLOWED_METHODS = exports.DEVICE_ID_HEADERS_NAME = exports.DEVICE_ID_COOKIE_NAME = exports.DEVICE_ID_COOKIE_MAX_AGE = exports.REQUEST_ID_HEADERS_NAME = exports.REQUEST_ID_COOKIE_NAME = exports.REQUEST_ID_COOKIE_MAX_AGE = exports.SEQUELIZE_SEEDER_META_TABLE_NAME = exports.SEQUELIZE_META_TABLE_NAME = exports.EMAIL_ENQUEUE_DIR = exports.SEEDERS_DIR = exports.MIGRATIONS_DIR = exports.MODELS_DIR = exports.SCHEMA_SNAPSHOTS_DIR = exports.SCHEMAS_DIR = exports.ENV_VAR_DIR = exports.LOG_DIR = exports.BASE_DIR = void 0;
+exports.DEFAULT_CONTENT_CACHE_TTL = exports.DEFAULT_CONTENT_LANG = exports.DEFAULT_CONTENT_URL = exports.CONTENT_LANG_KEY = exports.CONTENT_URL_KEY = exports.CONTENT_CACHE_TTL_KEY = exports.EMAIL_ENQUEUE_UTIL_FILE_NAME = exports.EMAIL_ENQUEUE_TYPES_FILE_NAME = exports.DEFAULT_MAILER_CACHE_TTL = exports.DEFAULT_MAILER_CACHE_KEY = exports.DEFAULT_RBAC_CACHE_TTL = exports.DEFAULT_RBAC_CACHE_KEY = exports.DEFAULT_TOTP_WINDOW = exports.DEFAULT_TOTP_DIGITS = exports.DEFAULT_TOTP_STEP = exports.ALPHABET_CORPUS = exports.CHARACTER_CORPUS = exports.REQUEST_RATE_LIMITTER_OPTIONS = exports.CORS_MAX_AGE_IN_MICRO_SECONDS = exports.CORS_MAX_AGE_IN_SECONDS = exports.CORS_ALLOWED_HEADERS = exports.HEADERS_KEY_NAME = exports.CORS_ALLOWED_METHODS = exports.DEVICE_ID_HEADERS_NAME = exports.DEVICE_ID_COOKIE_NAME = exports.DEVICE_ID_COOKIE_MAX_AGE = exports.REQUEST_ID_HEADERS_NAME = exports.REQUEST_ID_COOKIE_NAME = exports.REQUEST_ID_COOKIE_MAX_AGE = exports.SEQUELIZE_SEEDER_META_TABLE_NAME = exports.SEQUELIZE_META_TABLE_NAME = exports.EMAIL_PREVIEW_DIR = exports.EMAIL_ENQUEUE_DIR = exports.SEEDERS_DIR = exports.MIGRATIONS_DIR = exports.MODELS_DIR = exports.SCHEMA_SNAPSHOTS_DIR = exports.SCHEMAS_DIR = exports.ENV_VAR_DIR = exports.LOG_DIR = exports.BASE_DIR = void 0;
 const path_1 = __importDefault(require("path"));
 exports.BASE_DIR = process.cwd();
 exports.LOG_DIR = path_1.default.join(exports.BASE_DIR, "logs");
@@ -14,6 +14,7 @@ exports.MODELS_DIR = path_1.default.join(exports.BASE_DIR, "src/database/models"
 exports.MIGRATIONS_DIR = path_1.default.join(exports.BASE_DIR, "src/database/migrations");
 exports.SEEDERS_DIR = path_1.default.join(exports.BASE_DIR, "src/database/seeders");
 exports.EMAIL_ENQUEUE_DIR = path_1.default.join(exports.BASE_DIR, "src/");
+exports.EMAIL_PREVIEW_DIR = path_1.default.join(exports.BASE_DIR, "local_media/email/email_preview");
 exports.SEQUELIZE_META_TABLE_NAME = "sequelize_database_tables_meta";
 exports.SEQUELIZE_SEEDER_META_TABLE_NAME = "sequelize_database_table_seeder_meta";
 exports.REQUEST_ID_COOKIE_MAX_AGE = (1000 * 60 * 60 * 24 * 30); // 7 days

package/dist/mailer/processors/email_delivery_processor.d.ts

@@ -0,0 +1,17 @@
+import { EmailDeliveryQueueAdapter, EmailDeliveryOptions } from "../../types/mailer_type";
+declare class EmailDeliveryProcessor<TQueueEntity, TTemplate, TBaseTemplate, TMailerConfig> {
+    private static instance;
+    readonly name = "email_delivery_processor";
+    private readonly logger;
+    private readonly adapter;
+    private readonly options;
+    private constructor();
+    private render;
+    private renderLocalEmailPreview;
+    private sendEmail;
+    static initialize<TQueueEntity, TTemplate, TBaseTemplate, TMailerConfig>(adapter: EmailDeliveryQueueAdapter<TQueueEntity, TTemplate, TBaseTemplate, TMailerConfig>, options?: EmailDeliveryOptions): EmailDeliveryProcessor<TQueueEntity, TTemplate, TBaseTemplate, TMailerConfig>;
+    static getInstance<TQueueEntity, TTemplate, TBaseTemplate, TMailerConfig>(): EmailDeliveryProcessor<TQueueEntity, TTemplate, TBaseTemplate, TMailerConfig>;
+    processSingleRecord(record: TQueueEntity): Promise<void>;
+    run(limit?: number): Promise<void>;
+}
+export default EmailDeliveryProcessor;

package/dist/mailer/processors/email_delivery_processor.js

@@ -0,0 +1,183 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const path_1 = __importDefault(require("path"));
+const nodemailer_1 = __importDefault(require("nodemailer"));
+const fs_1 = __importDefault(require("fs"));
+const main_1 = require("../../utils/main");
+const constants_1 = require("../../config/constants");
+class EmailDeliveryProcessor {
+    static instance = null;
+    name = "email_delivery_processor";
+    logger = new main_1.LoggerUtil(this.name);
+    adapter;
+    options;
+    constructor(adapter, options) {
+        this.adapter = adapter;
+        this.options = options || {};
+    }
+    // EMial Render method 
+    async render(template, payload) {
+        try {
+            return await main_1.EJSRenderUtil.safeRenderString(template, payload);
+        }
+        catch (error) {
+            this.logger.error(`Failed to render string with given payload`, { template, payload, error });
+            return null;
+        }
+    }
+    // Render preview in dev mode
+    async renderLocalEmailPreview(record, html) {
+        try {
+            const output_dir = this.options?.email_preview_dir ?? constants_1.EMAIL_PREVIEW_DIR;
+            const file_base_name = this.adapter.getLocalEmailPreviewFileBaseName(record);
+            const file_name = `${file_base_name}.html`;
+            const output_file = path_1.default.join(output_dir, file_name);
+            main_1.InputValidatorUtil.dirExists(output_dir, true);
+            fs_1.default.writeFileSync(output_file, html, "utf-8");
+            this.logger.success(`Local Email Preview saved to ${output_file}`);
+            return true;
+        }
+        catch (error) {
+            this.logger.error(`Failed to render local email preview`, { error });
+            return false;
+        }
+    }
+    // Send email live
+    async sendEmail(record, mailer_config, rendered_subject, rendered_body, attachments = []) {
+        const { id: record_id, recipient_email } = this.adapter.getEmailRecordIdAndRecipient(record);
+        try {
+            this.logger.info(`Sending Rendered Email for Record with ID ${record_id} -> sending to ${recipient_email}`);
+            const email_attachments = attachments?.map((attachemnt) => {
+                return {
+                    filename: attachemnt.file_name,
+                    path: attachemnt.file_path,
+                };
+            });
+            this.logger.info(`Done preparing ${email_attachments?.length} Email attachments for Record with ID ${record_id}`);
+            const { from_email_address, reply_to_email_address, host, port, username, decrypted_password, tls_reject_unauthorized = false } = await this.adapter.getMailerTransporterConfig(record, mailer_config);
+            const transporter = nodemailer_1.default.createTransport({
+                host,
+                port,
+                secure: port === 465,
+                auth: {
+                    user: username,
+                    pass: decrypted_password,
+                },
+                tls: { rejectUnauthorized: tls_reject_unauthorized }
+            });
+            this.logger.info(`Mailer transporter Config has been set for Record with ID ${record_id}`);
+            await transporter.sendMail({
+                from: from_email_address,
+                to: recipient_email,
+                subject: rendered_subject,
+                html: rendered_body,
+                replyTo: reply_to_email_address,
+                attachments: email_attachments.length ? email_attachments : undefined,
+            });
+            this.logger.success(`Done sending Rendered Email for Record with ID ${record_id} -> sending to ${recipient_email}`);
+            return true;
+        }
+        catch (error) {
+            this.logger.error(`Failed to send email`, { record_id, recipient_email, error });
+            return false;
+        }
+    }
+    // ==============================
+    // Singleton
+    // ==============================
+    static initialize(adapter, options) {
+        if (this.instance) {
+            throw new Error("EmailDeliveryProcessor already initialized.");
+        }
+        this.instance = new EmailDeliveryProcessor(adapter, options);
+        return this.instance;
+    }
+    static getInstance() {
+        if (!this.instance) {
+            throw new Error("EmailDeliveryProcessor not initialized.");
+        }
+        return this.instance;
+    }
+    // ==============================
+    // Process 1 Record
+    // ==============================
+    async processSingleRecord(record) {
+        const { id: record_id, recipient_email } = this.adapter.getEmailRecordIdAndRecipient(record);
+        try {
+            this.logger.info(`Processing email queue Record ${record_id}`, { record_id, recipient_email });
+            const template = await this.adapter.getEmailRecordTemplate(record);
+            if (!template) {
+                this.logger.error(`Missing Email Template for Record ${record_id}`, { record_id, recipient_email, template });
+                throw new Error(`Missing Email Template for Record ${record_id}`);
+            }
+            const base_template = await this.adapter.getEmailRecordBaseTemplate(record, template);
+            if (!base_template) {
+                this.logger.error(`Missing Base Email Template for Record ${record_id}`, { record_id, recipient_email, base_template });
+                throw new Error(`Missing Base Email Template for Record ${record_id}`);
+            }
+            const mailer_config = await this.adapter.getEmailRecordMailerConfig(record, base_template);
+            if (!mailer_config) {
+                this.logger.error(`Missing Mailer Config for Record ${record_id}`, { record_id, recipient_email, mailer_config });
+                throw new Error(`Missing Mailer Config for Record ${record_id}`);
+            }
+            const subject_value = this.adapter.getEmailRecordSubjectValue(record);
+            const body_value = this.adapter.getEmailRecordBodyValue(record);
+            const base_email_value = this.adapter.getEmailRecordBaseTemplateBody(record, base_template);
+            const email_payload = this.adapter.getEmailRecordPayload(record);
+            const rendered_subject = await this.render(subject_value, email_payload);
+            const rendered_body = await this.render(body_value, email_payload);
+            if (!rendered_subject || !rendered_body) {
+                this.logger.error(`Failed to render Email Subject or body for Record ${record_id}`, { rendered_subject, rendered_body });
+                throw new Error(`Failed to render Email Subject or body for Record ${record_id}`);
+            }
+            const full_email_payload = await this.adapter.getFullEmailPayload(record, rendered_subject, rendered_body, email_payload);
+            const full_email_render = await this.render(base_email_value, full_email_payload);
+            if (!full_email_render) {
+                this.logger.error(`Failed to render Full Email for Record ${record_id}`, { full_email_render });
+                throw new Error(`Failed to render Full Email for Record ${record_id}`);
+            }
+            let email_sent = false;
+            if (main_1.InputValidatorUtil.isDevelopment()) {
+                email_sent = await this.renderLocalEmailPreview(record, full_email_render);
+            }
+            else {
+                email_sent = await this.sendEmail(record, mailer_config, rendered_subject, rendered_body, email_payload?.attachments);
+            }
+            if (!email_sent) {
+                this.logger.error(`Failed to Send email for Record ${record_id}`, { email_sent, recipient_email });
+                throw new Error(`Failed to Send email for Record ${record_id}`);
+            }
+            await this.adapter.updateEmailRecordAsCompleted(record);
+            this.logger.success(`Completed Processing email queue Record ${record_id}`, { record_id, recipient_email });
+        }
+        catch (error) {
+            const message = error?.message ?? "Unknown error";
+            await this.adapter.updateEmailRecordAsFailed(record, message);
+            this.logger.error(`Failed to Process email queue Record ${record_id}`, { record_id, recipient_email });
+        }
+    }
+    // ==============================
+    // ENTRY METHOD
+    // ==============================
+    async run(limit = 50) {
+        try {
+            this.logger.info("Starting email delivery batch", { limit });
+            const records = await this.adapter.fetchRecordsToProcess(limit);
+            this.logger.info(`Found ${records.length} queued email(s) to process`);
+            const concurrency = this.options?.concurrency ?? 5;
+            for (let i = 0; i < records.length; i += concurrency) {
+                const batch = records.slice(i, i + concurrency);
+                await Promise.all(batch.map(r => this.processSingleRecord(r)));
+            }
+            this.logger.info(`Done Processing ${records.length} queued email(s)`);
+        }
+        catch (error) {
+            this.logger.error(`Failed to run Email Delivery processor`, { error });
+            throw error;
+        }
+    }
+}
+exports.default = EmailDeliveryProcessor;

package/dist/mailer/utils/mailer_data_loader_util.js

@@ -116,7 +116,7 @@ class MailerDataLoaderUtil {
         if (templates_by_notification_code.has(code)) {
             return templates_by_notification_code.get(code) ?? null;
         }
-        return await this.provider.fetchEmailContentTemplateByNotificationcode(code);
+        return await this.provider.fetchEmailContentTemplateByNotificationCode(code);
     }
     // --------------------------
     // Refresh

package/dist/types/mailer_type.d.ts

@@ -1,3 +1,17 @@
+export interface EmailAttachmentInterface {
+    file_name: string;
+    file_path: string;
+    content_type: string;
+}
+export interface MailerTransporterConfigInterface {
+    from_email_address: string;
+    reply_to_email_address: string;
+    host: string;
+    port: number;
+    username: string;
+    decrypted_password: string;
+    tls_reject_unauthorized: boolean;
+}
 export interface EmailEnqueueGeneratorOptions {
     output_dir: string;
     types_file_name?: string;
@@ -44,7 +58,7 @@ export interface MailerDataLoaderProvider<TMailerConfig, TBaseTemplate, TNotific
     fetchBaseTemplate(): Promise<TBaseTemplate | null>;
     fetchNotificationTypes(): Promise<TNotificationType[]>;
     fetchEmailContentTemplates(): Promise<TEmailContentTempltae[]>;
-    fetchEmailContentTemplateByNotificationcode(code: string): Promise<TEmailContentTempltae | null>;
+    fetchEmailContentTemplateByNotificationCode(code: string): Promise<TEmailContentTempltae | null>;
     getNotificaionCodeFromNotification(notification: TNotificationType): string;
     getNotificaionCodeFromTemplate(email_content_template: TEmailContentTempltae): string;
 }
@@ -60,3 +74,32 @@ export interface MailerDataLoaderOptionsInterface {
     cache_key?: string;
     cache_ttl?: number;
 }
+export interface EmailBasePayloadInterface {
+    static_content: Record<string, any>;
+    db_content: Record<string, any>;
+    attachments?: EmailAttachmentInterface[];
+}
+export interface EmailDeliveryOptions {
+    max_attempts?: number;
+    email_preview_dir?: string;
+    concurrency?: number;
+}
+export interface EmailDeliveryQueueAdapter<TQueueEntity, TTemplate, TBaseTemplate, TMailerConfig> {
+    fetchRecordsToProcess(limit: number): Promise<TQueueEntity[]>;
+    getEmailRecordIdAndRecipient(record: TQueueEntity): {
+        id: string;
+        recipient_email: string;
+    };
+    getEmailRecordTemplate(record: TQueueEntity): Promise<TTemplate | null>;
+    getEmailRecordBaseTemplate(record: TQueueEntity, template?: TTemplate): Promise<TBaseTemplate | null>;
+    getEmailRecordMailerConfig(record: TQueueEntity, base_template?: TBaseTemplate): Promise<TMailerConfig | null>;
+    getEmailRecordSubjectValue(record: TQueueEntity): string;
+    getEmailRecordBodyValue(record: TQueueEntity): string;
+    getEmailRecordBaseTemplateBody(record: TQueueEntity, base_template: TBaseTemplate): string;
+    getEmailRecordPayload(record: TQueueEntity): EmailBasePayloadInterface;
+    getLocalEmailPreviewFileBaseName(record: TQueueEntity): string;
+    getFullEmailPayload(record: TQueueEntity, subject: string, body: string, payload: EmailBasePayloadInterface): Promise<Record<string, any>>;
+    getMailerTransporterConfig(record: TQueueEntity, config: TMailerConfig): Promise<MailerTransporterConfigInterface>;
+    updateEmailRecordAsCompleted(record: TQueueEntity): Promise<TQueueEntity>;
+    updateEmailRecordAsFailed(record: TQueueEntity, message?: string): Promise<TQueueEntity>;
+}

package/dist/utils/ejs_render_util.d.ts

@@ -0,0 +1,27 @@
+import { Options as EjsOptions } from "ejs";
+declare class EJSRenderUtil {
+    /**
+     * Render an EJS template string with a payload.
+     *
+     * @param template_string - Raw EJS string (e.g "<h1><%= name %></h1>")
+     * @param payload - Data object injected into template
+     * @param options - Optional EJS rendering options
+     * @returns Rendered string
+     */
+    static renderString<T extends Record<string, any>>(template_string: string, payload: T, options?: EjsOptions): Promise<string>;
+    /**
+     * Async render from file path.
+     *
+     * @param file_path - Absolute or relative file path
+     * @param payload - Data object injected into template
+     * @param options - Optional EJS rendering options
+     * @returns Rendered string
+     */
+    static renderFile<T extends Record<string, any>>(file_path: string, payload: T, options?: EjsOptions): Promise<string>;
+    /**
+     * Safe render version (never throws).
+     * Returns null instead of throwing error.
+     */
+    static safeRenderString<T extends Record<string, any>>(template_string: string, payload: T, options?: EjsOptions): Promise<string | null>;
+}
+export default EJSRenderUtil;

package/dist/utils/ejs_render_util.js

@@ -0,0 +1,66 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ejs_1 = __importDefault(require("ejs"));
+class EJSRenderUtil {
+    /**
+     * Render an EJS template string with a payload.
+     *
+     * @param template_string - Raw EJS string (e.g "<h1><%= name %></h1>")
+     * @param payload - Data object injected into template
+     * @param options - Optional EJS rendering options
+     * @returns Rendered string
+     */
+    static async renderString(template_string, payload, options) {
+        if (!template_string || typeof template_string !== "string") {
+            throw new Error("Invalid template string provided.");
+        }
+        try {
+            return await ejs_1.default.render(template_string, payload, {
+                strict: false,
+                ...options,
+            });
+        }
+        catch (error) {
+            throw new Error(`EJS string rendering failed: ${error?.message ?? "Unknown error"}`);
+        }
+    }
+    /**
+     * Async render from file path.
+     *
+     * @param file_path - Absolute or relative file path
+     * @param payload - Data object injected into template
+     * @param options - Optional EJS rendering options
+     * @returns Rendered string
+     */
+    static async renderFile(file_path, payload, options) {
+        if (!file_path || typeof file_path !== "string") {
+            throw new Error("Invalid file path provided.");
+        }
+        try {
+            return await ejs_1.default.renderFile(file_path, payload, {
+                async: true,
+                strict: false,
+                ...options,
+            });
+        }
+        catch (error) {
+            throw new Error(`EJS file rendering failed: ${error?.message ?? "Unknown error"}`);
+        }
+    }
+    /**
+     * Safe render version (never throws).
+     * Returns null instead of throwing error.
+     */
+    static async safeRenderString(template_string, payload, options) {
+        try {
+            return await this.renderString(template_string, payload, options);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+exports.default = EJSRenderUtil;

package/dist/utils/main.d.ts

@@ -11,4 +11,6 @@ import EncryptorDecryptorUtil from "./encryptor_decryptor_util";
 import TOTPServiceUtil from "./totp_service_util";
 import ContentManagerUtil from "./content_manager_util";
 import FsActionsUtil from "./fs_actions_util";
-export { LoggerUtil, InputTransformerUtil, InputValidatorUtil, EnvManagerUtil, SqlFormatterUtil, ServerUtil, SafeExecuteUtil, InMemoryCacheUtil, UUIDGeneratorUtil, EncryptorDecryptorUtil, TOTPServiceUtil, ContentManagerUtil, FsActionsUtil };
+import EJSRenderUtil from "./ejs_render_util";
+import PLimitUtil from "./p_limit_util";
+export { LoggerUtil, InputTransformerUtil, InputValidatorUtil, EnvManagerUtil, SqlFormatterUtil, ServerUtil, SafeExecuteUtil, InMemoryCacheUtil, UUIDGeneratorUtil, EncryptorDecryptorUtil, TOTPServiceUtil, ContentManagerUtil, FsActionsUtil, EJSRenderUtil, PLimitUtil };

package/dist/utils/main.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.FsActionsUtil = exports.ContentManagerUtil = exports.TOTPServiceUtil = exports.EncryptorDecryptorUtil = exports.UUIDGeneratorUtil = exports.InMemoryCacheUtil = exports.SafeExecuteUtil = exports.ServerUtil = exports.SqlFormatterUtil = exports.EnvManagerUtil = exports.InputValidatorUtil = exports.InputTransformerUtil = exports.LoggerUtil = void 0;
+exports.PLimitUtil = exports.EJSRenderUtil = exports.FsActionsUtil = exports.ContentManagerUtil = exports.TOTPServiceUtil = exports.EncryptorDecryptorUtil = exports.UUIDGeneratorUtil = exports.InMemoryCacheUtil = exports.SafeExecuteUtil = exports.ServerUtil = exports.SqlFormatterUtil = exports.EnvManagerUtil = exports.InputValidatorUtil = exports.InputTransformerUtil = exports.LoggerUtil = void 0;
 const logger_util_1 = __importDefault(require("./logger_util"));
 exports.LoggerUtil = logger_util_1.default;
 const input_transformer_util_1 = __importDefault(require("./input_transformer_util"));
@@ -30,3 +30,7 @@ const content_manager_util_1 = __importDefault(require("./content_manager_util")
 exports.ContentManagerUtil = content_manager_util_1.default;
 const fs_actions_util_1 = __importDefault(require("./fs_actions_util"));
 exports.FsActionsUtil = fs_actions_util_1.default;
+const ejs_render_util_1 = __importDefault(require("./ejs_render_util"));
+exports.EJSRenderUtil = ejs_render_util_1.default;
+const p_limit_util_1 = __importDefault(require("./p_limit_util"));
+exports.PLimitUtil = p_limit_util_1.default;

package/dist/utils/p_limit_util.d.ts

@@ -0,0 +1,11 @@
+declare class PLimitUtil {
+    /**
+     * Run an array of async tasks with a concurrency limit.
+     */
+    static run<T>(tasks: Array<() => Promise<T>>, concurrency: number): Promise<T[]>;
+    /**
+     * Convenience method for mapping over items with concurrency limit.
+     */
+    static map<T, R>(items: T[], concurrency: number, asyncFn: (item: T, index: number) => Promise<R>): Promise<R[]>;
+}
+export default PLimitUtil;

package/dist/utils/p_limit_util.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class PLimitUtil {
+    /**
+     * Run an array of async tasks with a concurrency limit.
+     */
+    static async run(tasks, concurrency) {
+        if (concurrency <= 0) {
+            throw new Error("Concurrency must be greater than 0");
+        }
+        const results = [];
+        let current_index = 0;
+        const worker = async () => {
+            while (true) {
+                const index = current_index++;
+                if (index >= tasks.length) {
+                    break;
+                }
+                try {
+                    results[index] = await tasks[index]();
+                }
+                catch (error) {
+                    // Fail fast (you can change behavior if needed)
+                    throw error;
+                }
+            }
+        };
+        const workers = Array.from({ length: Math.min(concurrency, tasks.length) }, () => worker());
+        await Promise.all(workers);
+        return results;
+    }
+    /**
+     * Convenience method for mapping over items with concurrency limit.
+     */
+    static async map(items, concurrency, asyncFn) {
+        const tasks = items.map((item, index) => () => asyncFn(item, index));
+        return this.run(tasks, concurrency);
+    }
+}
+exports.default = PLimitUtil;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "fiberx-backend-toolkit",
-    "version": "0.0.78",
+    "version": "0.1.0",
     "description": "A TypeScript backend toolkit providing shared domain logic, infrastructure helpers, and utilities for FiberX server-side applications and services.",
     "type": "commonjs",
     "main": "./dist/index.js",
@@ -23,12 +23,15 @@
     "license": "ISC",
     "author": "David Matt-Ojo",
     "dependencies": {
+        "@types/nodemailer": "^7.0.11",
         "axios": "^1.11.0",
         "bcrypt": "^6.0.0",
         "dayjs": "^1.11.18",
+        "ejs": "^4.0.1",
         "express": "^5.2.1",
         "js-yaml": "^4.1.0",
         "jsonwebtoken": "^9.0.2",
+        "nodemailer": "^8.0.1",
         "sequelize": "^6.37.7",
         "sequelize-typescript": "^2.1.6",
         "uuid": "^12.0.0"
@@ -36,6 +39,7 @@
     "devDependencies": {
         "@types/axios": "^0.9.36",
         "@types/bcrypt": "^6.0.0",
+        "@types/ejs": "^3.1.5",
         "@types/express": "^5.0.6",
         "@types/js-yaml": "^4.0.9",
         "@types/jsonwebtoken": "^9.0.10",