elseware-nodejs 1.7.9 → 1.8.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as express from 'express';
 import { Request, Response, NextFunction } from 'express';
-import { Model, PopulateOptions, Query } from 'mongoose';
-import { ZodSchema } from 'zod';
+import { Model, PopulateOptions, Query, UpdateQuery } from 'mongoose';
+import { ZodTypeAny, infer } from 'zod';
 import { CorsOptions } from 'cors';
 import { Schema } from 'joi';
 import { SignOptions, JwtPayload } from 'jsonwebtoken';
@@ -76,10 +76,19 @@ interface DatabaseConfig {
 }
 declare function connectMongoDB(config: DatabaseConfig): Promise<void>;
 
-declare function loadEnv(options: {
-    schema: ZodSchema;
-    transform?: (env: any) => any;
-}): any;
+/**
+ * Overload 1: No transform → return schema inferred type
+ */
+declare function loadEnv<TSchema extends ZodTypeAny>(options: {
+    schema: TSchema;
+}): infer<TSchema>;
+/**
+ * Overload 2: With transform → return transformed type
+ */
+declare function loadEnv<TSchema extends ZodTypeAny, TConfig>(options: {
+    schema: TSchema;
+    transform: (env: infer<TSchema>) => TConfig;
+}): TConfig;
 
 interface LoggerOptions {
     timestamp?: boolean;
@@ -1817,6 +1826,47 @@ declare const GlobalErrorHandler: (isProd?: boolean) => (err: unknown, _req: Req
 
 declare const validate: (schema: Schema) => (req: Request, _res: Response, next: NextFunction) => void;
 
+interface IRepository<T> {
+    findAll(filter?: any, options?: any): Promise<T[]>;
+    findById(id: string): Promise<T | null>;
+    findOne(filter: any): Promise<T | null>;
+    create(data: Partial<T>): Promise<T>;
+    updateById(id: string, data: Partial<T>): Promise<T | null>;
+    deleteById(id: string): Promise<T | null>;
+}
+
+declare class BaseMongoRepository<T> implements IRepository<T> {
+    protected model: Model<T>;
+    constructor(model: Model<T>);
+    findAll(filter?: Record<string, any>, options?: {
+        select?: string;
+        sort?: any;
+        limit?: number;
+        skip?: number;
+    }): Promise<T[]>;
+    findById(id: string): Promise<T | null>;
+    findOne(filter: Record<string, any>): Promise<T | null>;
+    create(data: Partial<T>): Promise<T>;
+    updateById(id: string, data: UpdateQuery<T>): Promise<T | null>;
+    deleteById(id: string): Promise<T | null>;
+}
+
+declare class BasePostgresRepository<T> implements IRepository<T> {
+    protected model: any;
+    constructor(model: any);
+    findAll(filter?: Record<string, any>, options?: {
+        select?: any;
+        sort?: any;
+        limit?: number;
+        skip?: number;
+    }): Promise<T[]>;
+    findById(id: string): Promise<T | null>;
+    findOne(filter: Record<string, any>): Promise<T | null>;
+    create(data: Partial<T>): Promise<T>;
+    updateById(id: string, data: Partial<T>): Promise<T | null>;
+    deleteById(id: string): Promise<T | null>;
+}
+
 interface AzureBlobStorageConfig {
     connectionString: string;
     accountName: string;
@@ -1963,4 +2013,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, 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 };
+export { APIFactory, APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, AppError, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BaseMongoRepository, BasePostgresRepository, 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 IRepository, 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

@@ -1,7 +1,7 @@
 import * as express from 'express';
 import { Request, Response, NextFunction } from 'express';
-import { Model, PopulateOptions, Query } from 'mongoose';
-import { ZodSchema } from 'zod';
+import { Model, PopulateOptions, Query, UpdateQuery } from 'mongoose';
+import { ZodTypeAny, infer } from 'zod';
 import { CorsOptions } from 'cors';
 import { Schema } from 'joi';
 import { SignOptions, JwtPayload } from 'jsonwebtoken';
@@ -76,10 +76,19 @@ interface DatabaseConfig {
 }
 declare function connectMongoDB(config: DatabaseConfig): Promise<void>;
 
-declare function loadEnv(options: {
-    schema: ZodSchema;
-    transform?: (env: any) => any;
-}): any;
+/**
+ * Overload 1: No transform → return schema inferred type
+ */
+declare function loadEnv<TSchema extends ZodTypeAny>(options: {
+    schema: TSchema;
+}): infer<TSchema>;
+/**
+ * Overload 2: With transform → return transformed type
+ */
+declare function loadEnv<TSchema extends ZodTypeAny, TConfig>(options: {
+    schema: TSchema;
+    transform: (env: infer<TSchema>) => TConfig;
+}): TConfig;
 
 interface LoggerOptions {
     timestamp?: boolean;
@@ -1817,6 +1826,47 @@ declare const GlobalErrorHandler: (isProd?: boolean) => (err: unknown, _req: Req
 
 declare const validate: (schema: Schema) => (req: Request, _res: Response, next: NextFunction) => void;
 
+interface IRepository<T> {
+    findAll(filter?: any, options?: any): Promise<T[]>;
+    findById(id: string): Promise<T | null>;
+    findOne(filter: any): Promise<T | null>;
+    create(data: Partial<T>): Promise<T>;
+    updateById(id: string, data: Partial<T>): Promise<T | null>;
+    deleteById(id: string): Promise<T | null>;
+}
+
+declare class BaseMongoRepository<T> implements IRepository<T> {
+    protected model: Model<T>;
+    constructor(model: Model<T>);
+    findAll(filter?: Record<string, any>, options?: {
+        select?: string;
+        sort?: any;
+        limit?: number;
+        skip?: number;
+    }): Promise<T[]>;
+    findById(id: string): Promise<T | null>;
+    findOne(filter: Record<string, any>): Promise<T | null>;
+    create(data: Partial<T>): Promise<T>;
+    updateById(id: string, data: UpdateQuery<T>): Promise<T | null>;
+    deleteById(id: string): Promise<T | null>;
+}
+
+declare class BasePostgresRepository<T> implements IRepository<T> {
+    protected model: any;
+    constructor(model: any);
+    findAll(filter?: Record<string, any>, options?: {
+        select?: any;
+        sort?: any;
+        limit?: number;
+        skip?: number;
+    }): Promise<T[]>;
+    findById(id: string): Promise<T | null>;
+    findOne(filter: Record<string, any>): Promise<T | null>;
+    create(data: Partial<T>): Promise<T>;
+    updateById(id: string, data: Partial<T>): Promise<T | null>;
+    deleteById(id: string): Promise<T | null>;
+}
+
 interface AzureBlobStorageConfig {
     connectionString: string;
     accountName: string;
@@ -1963,4 +2013,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, 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 };
+export { APIFactory, APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, AppError, type AzureBlobStorageConfig, AzureBlobStorageService, BPlusTree, BTree, BaseMongoRepository, BasePostgresRepository, 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 IRepository, 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

@@ -332,20 +332,29 @@ function loadEnv(options) {
   return options.transform ? options.transform(result.data) : result.data;
 }
 function handleError(error) {
-  logger.danger("ENV VALIDATION FAILED");
+  logger.danger("Env validation failed");
   const grouped = {};
   error.issues.forEach((err) => {
     const key = err.path.join(".") || "unknown";
+    const rawValue = key !== "unknown" ? process.env[key] : void 0;
+    const isSecret = key.toLowerCase().includes("secret");
+    const safeValue = isSecret ? "***" : rawValue;
+    const messageParts = [
+      `message: ${err.message}`,
+      `code: ${err.code}`,
+      rawValue !== void 0 ? `value: ${JSON.stringify(safeValue)}` : null
+    ].filter(Boolean);
+    const fullMessage = messageParts.join(" | ");
     if (!grouped[key]) grouped[key] = [];
-    grouped[key].push(err.message);
+    grouped[key].push(fullMessage);
   });
   Object.entries(grouped).forEach(([key, messages]) => {
     logger.info(`${key}`);
     messages.forEach((msg) => {
-      logger.log(`${msg}`);
+      logger.log(`   - ${msg}`);
     });
   });
-  logger.danger("Application startup aborted.\n");
+  logger.danger("Application startup aborted!");
   process.exit(1);
 }
 
@@ -5152,6 +5161,84 @@ var validate = (schema) => (req, _res, next) => {
   }
   next();
 };
+
+// src/repositories/mongo.repository.ts
+var BaseMongoRepository = class {
+  model;
+  constructor(model) {
+    this.model = model;
+  }
+  async findAll(filter = {}, options = {}) {
+    let query = this.model.find(filter);
+    if (options.select) query = query.select(options.select);
+    if (options.sort) query = query.sort(options.sort);
+    if (options.limit) query = query.limit(options.limit);
+    if (options.skip) query = query.skip(options.skip);
+    return query.exec();
+  }
+  async findById(id) {
+    return this.model.findById(id).exec();
+  }
+  async findOne(filter) {
+    return this.model.findOne(filter).exec();
+  }
+  async create(data) {
+    return this.model.create(data);
+  }
+  async updateById(id, data) {
+    return this.model.findByIdAndUpdate(id, data, {
+      new: true,
+      runValidators: true
+    }).exec();
+  }
+  async deleteById(id) {
+    return this.model.findByIdAndDelete(id).exec();
+  }
+};
+
+// src/repositories/postgres.repository.ts
+var BasePostgresRepository = class {
+  model;
+  // prisma model (e.g. prisma.testPost)
+  constructor(model) {
+    this.model = model;
+  }
+  async findAll(filter = {}, options = {}) {
+    return this.model.findMany({
+      where: filter,
+      select: options.select,
+      orderBy: options.sort,
+      take: options.limit,
+      skip: options.skip
+    });
+  }
+  async findById(id) {
+    return this.model.findUnique({
+      where: { id }
+    });
+  }
+  async findOne(filter) {
+    return this.model.findFirst({
+      where: filter
+    });
+  }
+  async create(data) {
+    return this.model.create({
+      data
+    });
+  }
+  async updateById(id, data) {
+    return this.model.update({
+      where: { id },
+      data
+    });
+  }
+  async deleteById(id) {
+    return this.model.delete({
+      where: { id }
+    });
+  }
+};
 var AzureBlobStorageService = class {
   containerName;
   blobServiceClient;
@@ -5603,6 +5690,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, 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 };
+export { APIFactory, apiFeatures_default as APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, AppError, AzureBlobStorageService, BPlusTree, BTree, BaseMongoRepository, BasePostgresRepository, 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