elseware-nodejs 1.5.3 → 1.7.0

package/dist/index.d.cts

@@ -1860,6 +1860,45 @@ declare class CloudinaryService {
     private buildFolderPath;
 }
 
+interface EmailProvider {
+    sendMail(options: {
+        to: string;
+        subject: string;
+        html: string;
+        from: string;
+    }): Promise<void>;
+}
+
+declare class SMTPProvider implements EmailProvider {
+    private transporter;
+    constructor(config: {
+        host: string;
+        port: number;
+        user: string;
+        pass: string;
+    });
+    sendMail({ to, subject, html, from }: any): Promise<void>;
+}
+
+interface SendEmailOptions {
+    to: string;
+    subject: string;
+    template: string;
+    data?: Record<string, any>;
+}
+declare class EmailService {
+    private provider;
+    private from;
+    private templateDir;
+    constructor(provider: EmailProvider, from: string, templateDir: string);
+    send(options: SendEmailOptions): Promise<void>;
+}
+
+declare class TemplateEngine {
+    static cache: Record<string, HandlebarsTemplateDelegate>;
+    static render(templateName: string, data: any, templateDir: string): string;
+}
+
 interface JWTServiceOptions {
     accessSecret: string;
     refreshSecret: string;
@@ -1888,6 +1927,26 @@ declare class JWTService {
     private parseExpires;
 }
 
+type MulterFileHandlerOptions = {
+    storage?: "memory" | "disk";
+    allowedMimeTypes?: string[];
+    allowedExtensions?: string[];
+    fileSizeLimit?: number;
+};
+declare class MulterFileHandlerService {
+    private storage;
+    private options;
+    constructor(options?: MulterFileHandlerOptions);
+    private fileFilter;
+    private buildUploader;
+    single(fieldName: string): any;
+    array(fieldName: string, maxCount: number): any;
+    fields(fields: {
+        name: string;
+        maxCount?: number;
+    }[]): any;
+}
+
 declare function errorToString(error: unknown): string;
 
 declare function milliseconds(value: number): number;
@@ -1900,4 +1959,4 @@ declare function toMinutes(ms: number): number;
 declare function toHours(ms: number): number;
 declare function sleep(ms: number): Promise<void>;
 
-export { APIFactory, APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, AppError, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CountMinSketch, type DatabaseConfig, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, FenwickTree, FibNode, FibonacciHeap, GlobalErrorHandler, Graph, HashMap, HashSet, HyperLogLog, type Interval, IntervalTree, JWTService, type JWTServiceOptions, KDTree, LFUCache, LRUCache, type LoggerOptions, MaxHeap, MaxStack, MinHeap, MinStack, MultiSet, Node, OrderedSet, PairingHeap, PairingNode, type Point, type Point2D, PriorityQueue, type ProgressCallback, QuadTree, Queue, RadixTree, type Rect, RedBlackTree, SegmentTree, Set, SinglyLinkedList, SparseTable, SplayTree, Stack, StaticArray, SuffixArray, SuffixTree, TernarySearchTree, TreeNode, Trie, type UploadOptions, asyncHandler, authMiddleware, connectMongoDB, createAllowedOrigins, createCorsOptions, days, errorToString, hours, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };
+export { APIFactory, APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, AppError, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CountMinSketch, type DatabaseConfig, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, type EmailProvider, EmailService, FenwickTree, FibNode, FibonacciHeap, GlobalErrorHandler, Graph, HashMap, HashSet, HyperLogLog, type Interval, IntervalTree, JWTService, type JWTServiceOptions, KDTree, LFUCache, LRUCache, type LoggerOptions, MaxHeap, MaxStack, MinHeap, MinStack, MulterFileHandlerService, MultiSet, Node, OrderedSet, PairingHeap, PairingNode, type Point, type Point2D, PriorityQueue, type ProgressCallback, QuadTree, Queue, RadixTree, type Rect, RedBlackTree, SMTPProvider, SegmentTree, type SendEmailOptions, Set, SinglyLinkedList, SparseTable, SplayTree, Stack, StaticArray, SuffixArray, SuffixTree, TemplateEngine, TernarySearchTree, TreeNode, Trie, type UploadOptions, asyncHandler, authMiddleware, connectMongoDB, createAllowedOrigins, createCorsOptions, days, errorToString, hours, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };

package/dist/index.d.ts

@@ -1860,6 +1860,45 @@ declare class CloudinaryService {
     private buildFolderPath;
 }
 
+interface EmailProvider {
+    sendMail(options: {
+        to: string;
+        subject: string;
+        html: string;
+        from: string;
+    }): Promise<void>;
+}
+
+declare class SMTPProvider implements EmailProvider {
+    private transporter;
+    constructor(config: {
+        host: string;
+        port: number;
+        user: string;
+        pass: string;
+    });
+    sendMail({ to, subject, html, from }: any): Promise<void>;
+}
+
+interface SendEmailOptions {
+    to: string;
+    subject: string;
+    template: string;
+    data?: Record<string, any>;
+}
+declare class EmailService {
+    private provider;
+    private from;
+    private templateDir;
+    constructor(provider: EmailProvider, from: string, templateDir: string);
+    send(options: SendEmailOptions): Promise<void>;
+}
+
+declare class TemplateEngine {
+    static cache: Record<string, HandlebarsTemplateDelegate>;
+    static render(templateName: string, data: any, templateDir: string): string;
+}
+
 interface JWTServiceOptions {
     accessSecret: string;
     refreshSecret: string;
@@ -1888,6 +1927,26 @@ declare class JWTService {
     private parseExpires;
 }
 
+type MulterFileHandlerOptions = {
+    storage?: "memory" | "disk";
+    allowedMimeTypes?: string[];
+    allowedExtensions?: string[];
+    fileSizeLimit?: number;
+};
+declare class MulterFileHandlerService {
+    private storage;
+    private options;
+    constructor(options?: MulterFileHandlerOptions);
+    private fileFilter;
+    private buildUploader;
+    single(fieldName: string): any;
+    array(fieldName: string, maxCount: number): any;
+    fields(fields: {
+        name: string;
+        maxCount?: number;
+    }[]): any;
+}
+
 declare function errorToString(error: unknown): string;
 
 declare function milliseconds(value: number): number;
@@ -1900,4 +1959,4 @@ declare function toMinutes(ms: number): number;
 declare function toHours(ms: number): number;
 declare function sleep(ms: number): Promise<void>;
 
-export { APIFactory, APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, AppError, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CountMinSketch, type DatabaseConfig, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, FenwickTree, FibNode, FibonacciHeap, GlobalErrorHandler, Graph, HashMap, HashSet, HyperLogLog, type Interval, IntervalTree, JWTService, type JWTServiceOptions, KDTree, LFUCache, LRUCache, type LoggerOptions, MaxHeap, MaxStack, MinHeap, MinStack, MultiSet, Node, OrderedSet, PairingHeap, PairingNode, type Point, type Point2D, PriorityQueue, type ProgressCallback, QuadTree, Queue, RadixTree, type Rect, RedBlackTree, SegmentTree, Set, SinglyLinkedList, SparseTable, SplayTree, Stack, StaticArray, SuffixArray, SuffixTree, TernarySearchTree, TreeNode, Trie, type UploadOptions, asyncHandler, authMiddleware, connectMongoDB, createAllowedOrigins, createCorsOptions, days, errorToString, hours, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };
+export { APIFactory, APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, AppError, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CountMinSketch, type DatabaseConfig, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, type EmailProvider, EmailService, FenwickTree, FibNode, FibonacciHeap, GlobalErrorHandler, Graph, HashMap, HashSet, HyperLogLog, type Interval, IntervalTree, JWTService, type JWTServiceOptions, KDTree, LFUCache, LRUCache, type LoggerOptions, MaxHeap, MaxStack, MinHeap, MinStack, MulterFileHandlerService, MultiSet, Node, OrderedSet, PairingHeap, PairingNode, type Point, type Point2D, PriorityQueue, type ProgressCallback, QuadTree, Queue, RadixTree, type Rect, RedBlackTree, SMTPProvider, SegmentTree, type SendEmailOptions, Set, SinglyLinkedList, SparseTable, SplayTree, Stack, StaticArray, SuffixArray, SuffixTree, TemplateEngine, TernarySearchTree, TreeNode, Trie, type UploadOptions, asyncHandler, authMiddleware, connectMongoDB, createAllowedOrigins, createCorsOptions, days, errorToString, hours, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };

package/dist/index.js

@@ -3,7 +3,11 @@ import dotenv from 'dotenv';
 import { BlobServiceClient, StorageSharedKeyCredential, generateBlobSASQueryParameters, BlobSASPermissions } from '@azure/storage-blob';
 import fs from 'fs';
 import cloudinaryModule from 'cloudinary';
+import nodemailer from 'nodemailer';
+import path from 'path';
+import Handlebars from 'handlebars';
 import jwt from 'jsonwebtoken';
+import multer from 'multer';
 
 // src/errors/appError.ts
 var AppError = class extends Error {
@@ -5287,6 +5291,65 @@ var CloudinaryService = class {
     return this.rootFolder || subFolder;
   }
 };
+var SMTPProvider = class {
+  transporter;
+  constructor(config) {
+    this.transporter = nodemailer.createTransport({
+      host: config.host,
+      port: config.port,
+      secure: config.port === 465,
+      auth: {
+        user: config.user,
+        pass: config.pass
+      }
+    });
+  }
+  async sendMail({ to, subject, html, from }) {
+    await this.transporter.sendMail({
+      from,
+      to,
+      subject,
+      html
+    });
+  }
+};
+var TemplateEngine = class {
+  static cache = {};
+  static render(templateName, data, templateDir) {
+    const cacheKey = `${templateDir}:${templateName}`;
+    if (!this.cache[cacheKey]) {
+      const filePath = path.join(templateDir, `${templateName}.hbs`);
+      const source = fs.readFileSync(filePath, "utf-8");
+      this.cache[cacheKey] = Handlebars.compile(source);
+    }
+    return this.cache[cacheKey](data);
+  }
+};
+
+// src/services/email/email.service.ts
+var EmailService = class {
+  provider;
+  from;
+  templateDir;
+  constructor(provider, from, templateDir) {
+    this.provider = provider;
+    this.from = from;
+    this.templateDir = templateDir;
+  }
+  async send(options) {
+    const html = TemplateEngine.render(
+      options.template,
+      options.data,
+      this.templateDir
+    );
+    await this.provider.sendMail({
+      to: options.to,
+      subject: options.subject,
+      html,
+      from: this.from
+    });
+  }
+};
 var JWTService = class {
   accessSecret;
   refreshSecret;
@@ -5402,6 +5465,61 @@ var JWTService = class {
     return value;
   }
 };
+var MulterFileHandlerService = class {
+  storage;
+  options;
+  constructor(options = {}) {
+    this.options = options;
+    this.storage = options.storage === "memory" ? multer.memoryStorage() : multer.diskStorage({});
+  }
+  // File Filter
+  fileFilter = (req, file, cb) => {
+    const { allowedMimeTypes, allowedExtensions } = this.options;
+    const mimeType = file.mimetype;
+    const extFromMime = mimeType.split("/")[1]?.toLowerCase();
+    if (allowedMimeTypes?.length) {
+      if (!allowedMimeTypes.includes(mimeType)) {
+        return cb(
+          new AppError(
+            `Invalid file type! Allowed: ${allowedMimeTypes.join(", ")}`,
+            400
+          ),
+          false
+        );
+      }
+    }
+    if (allowedExtensions?.length) {
+      if (!extFromMime || !allowedExtensions.includes(extFromMime)) {
+        return cb(
+          new AppError(
+            `Invalid file extension! Allowed: ${allowedExtensions.join(", ")}`,
+            400
+          ),
+          false
+        );
+      }
+    }
+    cb(null, true);
+  };
+  // Build multer instance
+  buildUploader() {
+    return multer({
+      storage: this.storage,
+      fileFilter: this.fileFilter,
+      limits: this.options.fileSizeLimit ? { fileSize: this.options.fileSizeLimit } : void 0
+    });
+  }
+  // Public API
+  single(fieldName) {
+    return this.buildUploader().single(fieldName);
+  }
+  array(fieldName, maxCount) {
+    return this.buildUploader().array(fieldName, maxCount);
+  }
+  fields(fields) {
+    return this.buildUploader().fields(fields);
+  }
+};
 
 // src/utils/time.ts
 function milliseconds(value) {
@@ -5432,6 +5550,6 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-export { APIFactory, apiFeatures_default as APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, AppError, AzureBlobStorageService, BPlusTree, BTree, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, CloudinaryService, ConsistentHash, CountMinSketch, Deque, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, FenwickTree, FibNode, FibonacciHeap, GlobalErrorHandler, Graph, HashMap, HashSet, HyperLogLog, IntervalTree, JWTService, KDTree, LFUCache, LRUCache, MaxHeap, MaxStack, MinHeap, MinStack, MultiSet, Node, OrderedSet, PairingHeap, PairingNode, PriorityQueue, QuadTree, Queue, RadixTree, RedBlackTree, SegmentTree, Set2 as Set, SinglyLinkedList, SparseTable, SplayTree, Stack, StaticArray, SuffixArray, SuffixTree, TernarySearchTree, TreeNode, Trie, asyncHandler, authMiddleware, connectMongoDB, createAllowedOrigins, createCorsOptions, days, errorToString, hours, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };
+export { APIFactory, apiFeatures_default as APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, AppError, AzureBlobStorageService, BPlusTree, BTree, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, CloudinaryService, ConsistentHash, CountMinSketch, Deque, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, EmailService, FenwickTree, FibNode, FibonacciHeap, GlobalErrorHandler, Graph, HashMap, HashSet, HyperLogLog, IntervalTree, JWTService, KDTree, LFUCache, LRUCache, MaxHeap, MaxStack, MinHeap, MinStack, MulterFileHandlerService, MultiSet, Node, OrderedSet, PairingHeap, PairingNode, PriorityQueue, QuadTree, Queue, RadixTree, RedBlackTree, SMTPProvider, SegmentTree, Set2 as Set, SinglyLinkedList, SparseTable, SplayTree, Stack, StaticArray, SuffixArray, SuffixTree, TemplateEngine, TernarySearchTree, TreeNode, Trie, asyncHandler, authMiddleware, connectMongoDB, createAllowedOrigins, createCorsOptions, days, errorToString, hours, loadEnv, logger, milliseconds, minutes, pickFields, seconds, sleep, toHours, toMinutes, toSeconds, validate };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map