@igxjs/node-components 1.0.10 → 1.0.12

package/index.d.ts

@@ -5,6 +5,78 @@ import { EncryptJWT, JWTDecryptResult, JWTPayload } from 'jose';
 import { RedisClientType } from '@redis/client';
 import { Application, RequestHandler, Request, Response, NextFunction, Router } from 'express';
 
+export { JWTPayload } from 'jose';
+
+// Logger class for configurable logging
+export class Logger {
+  /**
+   * Get or create a Logger instance (singleton pattern)
+   * @param componentName Component name for log prefix
+   * @param enableLogging Enable/disable logging (defaults to NODE_ENV !== 'production')
+   * @returns Logger instance
+   */
+  static getInstance(componentName: string, enableLogging?: boolean): Logger;
+
+  /**
+   * Clear all logger instances (useful for testing)
+   */
+  static clearInstances(): void;
+
+  /**
+   * Disable colors globally for all logger instances
+   */
+  static disableColors(): void;
+
+  /**
+   * Enable colors globally for all logger instances
+   */
+  static enableColors(): void;
+
+  /**
+   * Create a new Logger instance (backward compatibility)
+   * Note: Use Logger.getInstance() for singleton pattern
+   * @param componentName Component name for log prefix
+   * @param enableLogging Enable/disable logging (defaults to NODE_ENV !== 'production')
+   */
+  constructor(componentName: string, enableLogging?: boolean);
+
+  /**
+   * Log debug message
+   * @param args Arguments to log
+   */
+  debug(...args: any[]): void;
+
+  /**
+   * Log info message
+   * @param args Arguments to log
+   */
+  info(...args: any[]): void;
+
+  /**
+   * Log warning message
+   * @param args Arguments to log
+   */
+  warn(...args: any[]): void;
+
+  /**
+   * Log error message
+   * @param args Arguments to log
+   */
+  error(...args: any[]): void;
+
+  /**
+   * Log general message
+   * @param args Arguments to log
+   */
+  log(...args: any[]): void;
+}
+
+// Session Mode constants
+export const SessionMode: {
+  SESSION: string;
+  TOKEN: string;
+};
+
 // Session Configuration - uses strict UPPERCASE naming convention for all property names
 export interface SessionConfig {
   /** Identity Provider */
@@ -14,13 +86,27 @@ export interface SessionConfig {
   SSO_SUCCESS_URL?: string;
   SSO_FAILURE_URL?: string;
 
+  /** Authentication mode: 'session' or 'token' (default: 'session') */
+  SESSION_MODE?: string;
+
   SESSION_AGE?: number;
   SESSION_COOKIE_PATH?: string;
   SESSION_SECRET?: string;
   SESSION_PREFIX?: string;
+  SESSION_KEY?: string;
+  SESSION_EXPIRY_KEY?: string;
+  TOKEN_STORAGE_TEMPLATE_PATH?: string;
 
   REDIS_URL?: string;
   REDIS_CERT_PATH?: string;
+
+  JWT_ALGORITHM?: string;
+  JWT_ENCRYPTION?: string;
+  JWT_CLOCK_TOLERANCE?: number;
+  JWT_SECRET_HASH_ALGORITHM?: string;
+  JWT_ISSUER?: string;
+  JWT_AUDIENCE?: string;
+  JWT_SUBJECT?: string;
 }
 
 export interface SessionUserAttributes {
@@ -98,15 +184,35 @@ export class SessionManager {
   ): Promise<void>;
 
   /**
-   * Resource protection middleware
+   * Resource protection middleware based on configured SESSION_MODE
+   * Uses verifySession() for SESSION mode and verifyToken() for TOKEN mode
    * @param isDebugging Debugging flag (default: false)
    * @param redirectUrl Redirect URL (default: '')
    * @returns Returns express Request Handler
    */
   authenticate(isDebugging?: boolean, redirectUrl?: string): RequestHandler;
 
+  /**
+   * Resource protection by token (explicit token verification)
+   * Requires Authorization: Bearer {token} header
+   * @param isDebugging Debugging flag (default: false)
+   * @param redirectUrl Redirect URL (default: '')
+   * @returns Returns express Request Handler
+   */
+  verifyToken(isDebugging?: boolean, redirectUrl?: string): RequestHandler;
+
+  /**
+   * Resource protection by session (explicit session verification)
+   * @param isDebugging Debugging flag (default: false)
+   * @param redirectUrl Redirect URL (default: '')
+   * @returns Returns express Request Handler
+   */
+  verifySession(isDebugging?: boolean, redirectUrl?: string): RequestHandler;
+
   /**
    * SSO callback for successful login
+   * SESSION mode: Saves session and redirects
+   * TOKEN mode: Generates JWT token, returns HTML page with localStorage script
    * @param initUser Initialize user object function
    * @returns Returns express Request Handler
    */
@@ -119,17 +225,22 @@ export class SessionManager {
   identityProviders(): RequestHandler;
 
   /**
-   * Application logout (NOT SSO)
+   * Refresh user authentication based on configured SESSION_MODE
+   * SESSION mode: Refreshes session data
+   * TOKEN mode: Generates new token, invalidates old token
+   * @param initUser Initialize user object function
    * @returns Returns express Request Handler
    */
-  logout(): RequestHandler;
+  refresh(initUser: (user: SessionUser) => SessionUser): RequestHandler;
 
   /**
-   * Refresh user session
-   * @param initUser Initialize user object function
+   * Application logout based on configured SESSION_MODE (NOT SSO)
+   * SESSION mode: Destroys session and clears cookie
+   * TOKEN mode: Invalidates current token or all tokens (with ?all=true query param)
+   * Query params: redirect=true (redirect to success/failure URL), all=true (logout all tokens - TOKEN mode only)
    * @returns Returns express Request Handler
    */
-  refresh(initUser: (user: SessionUser) => SessionUser): RequestHandler;
+  logout(): RequestHandler;
 }
 
 // Custom Error class
@@ -196,32 +307,29 @@ export class RedisManager {
    * Disconnect from Redis
    * @returns Returns nothing
    */
-  disConnect(): Promise<void>;
+  disconnect(): Promise<void>;
 }
 
 // JWT Manager Configuration - uses strict UPPERCASE naming convention with JWT_ prefix for all property names
 export interface JwtManagerOptions {
   /** JWE algorithm (default: 'dir') */
   JWT_ALGORITHM?: string;
-  
+
   /** JWE encryption method (default: 'A256GCM') */
   JWT_ENCRYPTION?: string;
-  
-  /** Token expiration time (default: '10m') */
-  JWT_EXPIRATION_TIME?: string;
-  
+
   /** Clock tolerance in seconds for token validation (default: 30) */
   JWT_CLOCK_TOLERANCE?: number;
-  
+
   /** Hash algorithm for secret derivation (default: 'SHA-256') */
   JWT_SECRET_HASH_ALGORITHM?: string;
-  
+
   /** Optional JWT issuer claim */
   JWT_ISSUER?: string;
-  
+
   /** Optional JWT audience claim */
   JWT_AUDIENCE?: string;
-  
+
   /** Optional JWT subject claim */
   JWT_SUBJECT?: string;
 }
@@ -237,7 +345,7 @@ export interface JwtEncryptOptions {
   encryption?: string;
 
   /** Override default expiration time */
-  expirationTime?: string;
+  expirationTime?: number;
 
   /** Override default hash algorithm */
   secretHashAlgorithm?: string;
@@ -273,11 +381,12 @@ export interface JwtDecryptOptions {
 }
 
 export type JwtDecryptResult = JWTDecryptResult<EncryptJWT>;
+
 // JwtManager class for JWT encryption and decryption
 export class JwtManager {
   algorithm: string;
   encryption: string;
-  expirationTime: string;
+  expirationTime: number;
   clockTolerance: number;
   secretHashAlgorithm: string;
   issuer?: string;

package/index.js

@@ -1,5 +1,6 @@
-export { SessionConfig, SessionManager } from './components/session.js';
+export { SessionConfig, SessionManager, SessionMode } from './components/session.js';
 export { httpCodes, httpMessages, httpErrorHandler, httpNotFoundHandler, CustomError, httpHelper, httpError } from './components/http-handlers.js';
 export { RedisManager } from './components/redis.js';
 export { FlexRouter } from './components/router.js';
 export { JwtManager } from './components/jwt.js';
+export { Logger } from './components/logger.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@igxjs/node-components",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "Node components for igxjs",
   "main": "index.js",
   "type": "module",
@@ -26,14 +26,14 @@
     "axios": "^1.13.6",
     "connect-redis": "^9.0.0",
     "express-session": "^1.19.0",
-    "jose": "^6.2.0",
+    "jose": "^6.2.1",
     "memorystore": "^1.6.7"
   },
   "devDependencies": {
     "chai": "^6.2.2",
     "express": "^5.2.1",
     "mocha": "^12.0.0-beta-10",
-    "sinon": "^21.0.2",
+    "sinon": "^21.0.3",
     "supertest": "^7.0.0"
   },
   "files": [