elseware-nodejs 1.3.1 → 1.5.0

package/dist/index.d.cts

@@ -1,8 +1,9 @@
 import * as express from 'express';
 import { Request, Response, NextFunction } from 'express';
-import { Model, PopulateOptions, Query, UpdateQuery } from 'mongoose';
+import { Model, PopulateOptions, Query } from 'mongoose';
 import Joi, { Schema } from 'joi';
 import { CorsOptions } from 'cors';
+import { SignOptions, JwtPayload } from 'jsonwebtoken';
 
 /**
  * Options for API factory methods
@@ -57,6 +58,18 @@ declare class APIResponse {
 
 declare const asyncHandler: (fn: (req: Request, res: Response, next: NextFunction) => Promise<void>) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
 
+type FieldTransform<T> = (value: T) => any;
+type PickOptions<T extends Record<string, any>, K extends keyof T> = {
+    removeUndefined?: boolean;
+    removeNull?: boolean;
+    removeEmptyString?: boolean;
+    strict?: boolean;
+    defaults?: Partial<Record<K, any>>;
+    rename?: Partial<Record<K, string>>;
+    transform?: Partial<Record<K, FieldTransform<T[K]>>>;
+};
+declare function pickFields<T extends Record<string, any>, K extends keyof T>(obj: T, fields: readonly K[], options?: PickOptions<T, K>): Partial<Record<K | string, any>>;
+
 interface AzureBlobConfig {
     connectionString: string;
     accountName: string;
@@ -1847,27 +1860,30 @@ declare const GlobalErrorHandler: (isProd?: boolean) => (err: unknown, _req: Req
 
 declare const validate: (schema: Schema) => (req: Request, _res: Response, next: NextFunction) => void;
 
-/**
- * Generic Base Service
- * Provides default CRUD operations
- */
-declare abstract class BaseService<T> {
-    protected model: Model<T>;
-    protected resourceName: string;
-    constructor(model: Model<T>, resourceName: string);
-    create(data: Partial<T>): Promise<T>;
-    findAll(): Promise<T[]>;
-    findById(id: string): Promise<T>;
-    updateById(id: string, data: UpdateQuery<T>): Promise<T>;
-    deleteById(id: string): Promise<T>;
-}
-
-interface CrudService<T> {
-    create(data: Partial<T>): Promise<T>;
-    findAll(): Promise<T[]>;
-    findById(id: string): Promise<T>;
-    updateById(id: string, data: UpdateQuery<T>): Promise<T>;
-    deleteById(id: string): Promise<T>;
+interface JWTServiceOptions {
+    accessSecret: string;
+    refreshSecret: string;
+    accessExpires?: SignOptions["expiresIn"];
+    refreshExpires?: SignOptions["expiresIn"];
+    nodeEnv?: string;
+    refreshCookieName?: string;
+}
+declare class JWTService {
+    private accessSecret;
+    private refreshSecret;
+    private accessExpires;
+    private refreshExpires;
+    private nodeEnv;
+    private refreshCookieName;
+    constructor(options: JWTServiceOptions);
+    createAccessToken(payload: object): string;
+    createRefreshToken(payload: object): string;
+    verifyAccessToken<T extends JwtPayload = JwtPayload>(token: string): T | null;
+    verifyRefreshToken<T extends JwtPayload = JwtPayload>(token: string): T | null;
+    extractToken(req: Request): string | null;
+    setRefreshTokenCookie(res: Response, refreshToken: string): void;
+    clearRefreshTokenCookie(res: Response): void;
+    sendAuthTokens(res: Response, payload: object): string;
 }
 
 declare function errorToString(error: unknown): string;
@@ -1882,4 +1898,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 AzureBlobConfig, AzureBlobService, BPlusTree, BTree, BaseService, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CountMinSketch, type CrudService, type DatabaseConfig, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, FenwickTree, FibNode, FibonacciHeap, GlobalErrorHandler, Graph, HashMap, HashSet, HyperLogLog, type Interval, IntervalTree, 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, seconds, sleep, toHours, toMinutes, toSeconds, validate };
+export { APIFactory, APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, AppError, type AzureBlobConfig, AzureBlobService, 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 };

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import * as express from 'express';
 import { Request, Response, NextFunction } from 'express';
-import { Model, PopulateOptions, Query, UpdateQuery } from 'mongoose';
+import { Model, PopulateOptions, Query } from 'mongoose';
 import Joi, { Schema } from 'joi';
 import { CorsOptions } from 'cors';
+import { SignOptions, JwtPayload } from 'jsonwebtoken';
 
 /**
  * Options for API factory methods
@@ -57,6 +58,18 @@ declare class APIResponse {
 
 declare const asyncHandler: (fn: (req: Request, res: Response, next: NextFunction) => Promise<void>) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
 
+type FieldTransform<T> = (value: T) => any;
+type PickOptions<T extends Record<string, any>, K extends keyof T> = {
+    removeUndefined?: boolean;
+    removeNull?: boolean;
+    removeEmptyString?: boolean;
+    strict?: boolean;
+    defaults?: Partial<Record<K, any>>;
+    rename?: Partial<Record<K, string>>;
+    transform?: Partial<Record<K, FieldTransform<T[K]>>>;
+};
+declare function pickFields<T extends Record<string, any>, K extends keyof T>(obj: T, fields: readonly K[], options?: PickOptions<T, K>): Partial<Record<K | string, any>>;
+
 interface AzureBlobConfig {
     connectionString: string;
     accountName: string;
@@ -1847,27 +1860,30 @@ declare const GlobalErrorHandler: (isProd?: boolean) => (err: unknown, _req: Req
 
 declare const validate: (schema: Schema) => (req: Request, _res: Response, next: NextFunction) => void;
 
-/**
- * Generic Base Service
- * Provides default CRUD operations
- */
-declare abstract class BaseService<T> {
-    protected model: Model<T>;
-    protected resourceName: string;
-    constructor(model: Model<T>, resourceName: string);
-    create(data: Partial<T>): Promise<T>;
-    findAll(): Promise<T[]>;
-    findById(id: string): Promise<T>;
-    updateById(id: string, data: UpdateQuery<T>): Promise<T>;
-    deleteById(id: string): Promise<T>;
-}
-
-interface CrudService<T> {
-    create(data: Partial<T>): Promise<T>;
-    findAll(): Promise<T[]>;
-    findById(id: string): Promise<T>;
-    updateById(id: string, data: UpdateQuery<T>): Promise<T>;
-    deleteById(id: string): Promise<T>;
+interface JWTServiceOptions {
+    accessSecret: string;
+    refreshSecret: string;
+    accessExpires?: SignOptions["expiresIn"];
+    refreshExpires?: SignOptions["expiresIn"];
+    nodeEnv?: string;
+    refreshCookieName?: string;
+}
+declare class JWTService {
+    private accessSecret;
+    private refreshSecret;
+    private accessExpires;
+    private refreshExpires;
+    private nodeEnv;
+    private refreshCookieName;
+    constructor(options: JWTServiceOptions);
+    createAccessToken(payload: object): string;
+    createRefreshToken(payload: object): string;
+    verifyAccessToken<T extends JwtPayload = JwtPayload>(token: string): T | null;
+    verifyRefreshToken<T extends JwtPayload = JwtPayload>(token: string): T | null;
+    extractToken(req: Request): string | null;
+    setRefreshTokenCookie(res: Response, refreshToken: string): void;
+    clearRefreshTokenCookie(res: Response): void;
+    sendAuthTokens(res: Response, payload: object): string;
 }
 
 declare function errorToString(error: unknown): string;
@@ -1882,4 +1898,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 AzureBlobConfig, AzureBlobService, BPlusTree, BTree, BaseService, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, type CloudinaryConfig, CloudinaryService, ConsistentHash, CountMinSketch, type CrudService, type DatabaseConfig, Deque, type DirectedEdge, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, type Edge, FenwickTree, FibNode, FibonacciHeap, GlobalErrorHandler, Graph, HashMap, HashSet, HyperLogLog, type Interval, IntervalTree, 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, seconds, sleep, toHours, toMinutes, toSeconds, validate };
+export { APIFactory, APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, type AdjacentEdge, type AllowedOriginsOptions, AppError, type AzureBlobConfig, AzureBlobService, 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 };

package/dist/index.js

@@ -3,6 +3,7 @@ import fs from 'fs';
 import cloudinaryModule from 'cloudinary';
 import mongoose from 'mongoose';
 import dotenv from 'dotenv';
+import jwt from 'jsonwebtoken';
 
 // src/errors/appError.ts
 var AppError = class extends Error {
@@ -203,6 +204,42 @@ var APIFactory = class {
     });
   }
 };
+
+// src/api/pickFields.ts
+function pickFields(obj, fields, options = {}) {
+  const removeUndefined = options.removeUndefined ?? false;
+  const removeNull = options.removeNull ?? false;
+  const removeEmptyString = options.removeEmptyString ?? false;
+  const strict = options.strict ?? false;
+  const defaults = options.defaults ?? {};
+  const rename = options.rename ?? {};
+  const transform = options.transform ?? {};
+  const result = {};
+  if (strict) {
+    for (const key of Object.keys(obj)) {
+      if (!fields.includes(key)) {
+        throw new Error(`Unknown field: ${key}`);
+      }
+    }
+  }
+  for (const field of fields) {
+    let value = obj[field];
+    if (value === void 0 && field in defaults) {
+      value = defaults[field];
+    }
+    if (removeUndefined && value === void 0) continue;
+    if (removeNull && value === null) continue;
+    if (removeEmptyString && value === "") continue;
+    if (transform[field]) {
+      value = transform[field](value);
+    }
+    const outputKey = rename[field] ?? field;
+    if (Object.prototype.hasOwnProperty.call(obj, field) || field in defaults) {
+      result[outputKey] = value;
+    }
+  }
+  return result;
+}
 var AzureBlobService = class {
   containerName;
   blobServiceClient;
@@ -5250,51 +5287,96 @@ var validate = (schema) => (req, _res, next) => {
   }
   next();
 };
-
-// src/services/base.service.ts
-var BaseService = class {
-  model;
-  resourceName;
-  constructor(model, resourceName) {
-    this.model = model;
-    this.resourceName = resourceName;
-  }
-  async create(data) {
-    const doc = await this.model.create(data);
-    return doc;
-  }
-  async findAll() {
-    return this.model.find();
-  }
-  async findById(id) {
-    const doc = await this.model.findById(id);
-    if (!doc) {
-      throw new AppError(`${this.resourceName} not found`, 404, {
-        code: `${this.resourceName.toUpperCase()}_NOT_FOUND`
-      });
-    }
-    return doc;
+var JWTService = class {
+  accessSecret;
+  refreshSecret;
+  accessExpires;
+  refreshExpires;
+  nodeEnv;
+  refreshCookieName;
+  constructor(options) {
+    this.accessSecret = options.accessSecret;
+    this.refreshSecret = options.refreshSecret;
+    this.accessExpires = options.accessExpires || "15m";
+    this.refreshExpires = options.refreshExpires || "30d";
+    this.nodeEnv = options.nodeEnv || "development";
+    this.refreshCookieName = options.refreshCookieName || "refreshJwt";
+  }
+  // ---------------------------------
+  // Access and Refresh Token Creation
+  // ---------------------------------
+  createAccessToken(payload) {
+    return jwt.sign(payload, this.accessSecret, {
+      expiresIn: this.accessExpires
+    });
   }
-  async updateById(id, data) {
-    const doc = await this.model.findByIdAndUpdate(id, data, {
-      new: true,
-      runValidators: true
+  createRefreshToken(payload) {
+    return jwt.sign(payload, this.refreshSecret, {
+      expiresIn: this.refreshExpires
     });
-    if (!doc) {
-      throw new AppError(`${this.resourceName} not found`, 404, {
-        code: `${this.resourceName.toUpperCase()}_NOT_FOUND`
-      });
+  }
+  // ---------------------------------
+  // Token Verification
+  // ---------------------------------
+  verifyAccessToken(token) {
+    try {
+      return jwt.verify(token, this.accessSecret);
+    } catch (err) {
+      console.error("Access token verification failed:", err.message);
+      return null;
     }
-    return doc;
   }
-  async deleteById(id) {
-    const doc = await this.model.findByIdAndDelete(id);
-    if (!doc) {
-      throw new AppError(`${this.resourceName} not found`, 404, {
-        code: `${this.resourceName.toUpperCase()}_NOT_FOUND`
-      });
+  verifyRefreshToken(token) {
+    try {
+      return jwt.verify(token, this.refreshSecret);
+    } catch (err) {
+      console.error("Refresh token verification failed:", err.message);
+      return null;
+    }
+  }
+  // ---------------------------------
+  // Token Extraction
+  // ---------------------------------
+  extractToken(req) {
+    if (req.headers.authorization?.startsWith("Bearer ")) {
+      return req.headers.authorization.split(" ")[1];
+    }
+    if (req.cookies?.[this.refreshCookieName]) {
+      return req.cookies[this.refreshCookieName];
     }
-    return doc;
+    if (req.cookies?.jwt) {
+      return req.cookies.jwt;
+    }
+    return null;
+  }
+  // ---------------------------------
+  // Cookie Helpers
+  // ---------------------------------
+  setRefreshTokenCookie(res, refreshToken) {
+    res.cookie(this.refreshCookieName, refreshToken, {
+      httpOnly: true,
+      secure: this.nodeEnv === "production",
+      sameSite: this.nodeEnv === "production" ? "none" : "lax",
+      maxAge: 30 * 24 * 60 * 60 * 1e3,
+      path: "/"
+    });
+  }
+  clearRefreshTokenCookie(res) {
+    res.clearCookie(this.refreshCookieName, {
+      httpOnly: true,
+      secure: this.nodeEnv === "production",
+      sameSite: this.nodeEnv === "production" ? "none" : "lax",
+      path: "/"
+    });
+  }
+  // ---------------------------------
+  // Login Helpers
+  // ---------------------------------
+  sendAuthTokens(res, payload) {
+    const accessToken = this.createAccessToken(payload);
+    const refreshToken = this.createRefreshToken(payload);
+    this.setRefreshTokenCookie(res, refreshToken);
+    return accessToken;
   }
 };
 
@@ -5327,6 +5409,6 @@ function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
 
-export { APIFactory, apiFeatures_default as APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, AppError, AzureBlobService, BPlusTree, BTree, BaseService, BinaryHeap, BinarySearchTree, BinaryTree, BloomFilter, CircularArray, CircularLinkedList, CircularQueue, CloudinaryService, ConsistentHash, CountMinSketch, Deque, DirectedGraph, DisjointSetUnion, DoublyLinkedList, DynamicArray, FenwickTree, FibNode, FibonacciHeap, GlobalErrorHandler, Graph, HashMap, HashSet, HyperLogLog, IntervalTree, 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, seconds, sleep, toHours, toMinutes, toSeconds, validate };
+export { APIFactory, apiFeatures_default as APIFeatures, APIResponse, AVLTree, AdjacencyList, AdjacencyMatrix, AppError, AzureBlobService, 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 };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map