@flusys/nestjs-auth 1.0.0-beta → 1.0.0

package/fesm/entities/user-token.entity.js

@@ -0,0 +1,113 @@
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+function _ts_decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+function _ts_metadata(k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+}
+import { Column, CreateDateColumn, Entity, Index, PrimaryGeneratedColumn } from 'typeorm';
+/**
+ * Token types for various user actions
+ */ export var TokenType = /*#__PURE__*/ function(TokenType) {
+    TokenType["PASSWORD_RESET"] = "password_reset";
+    TokenType["EMAIL_VERIFICATION"] = "email_verification";
+    TokenType["EMAIL_CHANGE"] = "email_change";
+    return TokenType;
+}({});
+export class UserToken {
+    constructor(){
+        _define_property(this, "id", void 0);
+        _define_property(this, "userId", void 0);
+        _define_property(this, "type", void 0);
+        _define_property(this, "token", void 0);
+        _define_property(this, "expiresAt", void 0);
+        _define_property(this, "usedAt", void 0);
+        _define_property(this, "metadata", void 0);
+        _define_property(this, "createdAt", void 0);
+    }
+}
+_ts_decorate([
+    PrimaryGeneratedColumn('uuid'),
+    _ts_metadata("design:type", String)
+], UserToken.prototype, "id", void 0);
+_ts_decorate([
+    Column({
+        type: 'uuid',
+        name: 'user_id'
+    }),
+    _ts_metadata("design:type", String)
+], UserToken.prototype, "userId", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 32
+    }),
+    _ts_metadata("design:type", String)
+], UserToken.prototype, "type", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 64
+    }),
+    _ts_metadata("design:type", String)
+], UserToken.prototype, "token", void 0);
+_ts_decorate([
+    Column({
+        type: 'timestamp',
+        name: 'expires_at'
+    }),
+    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], UserToken.prototype, "expiresAt", void 0);
+_ts_decorate([
+    Column({
+        type: 'timestamp',
+        name: 'used_at',
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], UserToken.prototype, "usedAt", void 0);
+_ts_decorate([
+    Column({
+        type: 'varchar',
+        length: 255,
+        nullable: true
+    }),
+    _ts_metadata("design:type", Object)
+], UserToken.prototype, "metadata", void 0);
+_ts_decorate([
+    CreateDateColumn({
+        type: 'timestamp',
+        name: 'created_at'
+    }),
+    _ts_metadata("design:type", typeof Date === "undefined" ? Object : Date)
+], UserToken.prototype, "createdAt", void 0);
+UserToken = _ts_decorate([
+    Entity('user_tokens'),
+    Index('IDX_user_token_token', [
+        'token'
+    ], {
+        unique: true
+    }),
+    Index('IDX_user_token_user_type', [
+        'userId',
+        'type'
+    ]),
+    Index('IDX_user_token_expires', [
+        'expiresAt'
+    ])
+], UserToken);

package/fesm/interceptors/clear-token.interceptor.js

@@ -25,10 +25,11 @@ function _ts_param(paramIndex, decorator) {
         decorator(target, key, paramIndex);
     };
 }
+import { buildCookieOptions, isBrowserRequest } from '@flusys/nestjs-shared/utils';
 import { Injectable, Optional } from '@nestjs/common';
 import { map } from 'rxjs';
+import { DEFAULT_COOKIE_NAME } from '../config';
 import { AuthConfigService } from '../services/auth-config.service';
-const DEFAULT_COOKIE_NAME = 'fsn_refresh_token';
 export class ClearToken {
     get cookieName() {
         return this.authConfig?.getRefreshTokenCookieName() ?? DEFAULT_COOKIE_NAME;
@@ -37,30 +38,16 @@ export class ClearToken {
         const req = context.switchToHttp().getRequest();
         const res = context.switchToHttp().getResponse();
         return next.handle().pipe(map((value)=>{
-            // Clear the refresh token cookie
-            this.clearRefreshTokenCookie(req, res);
+            if (isBrowserRequest(req)) {
+                res.clearCookie(this.cookieName, {
+                    httpOnly: true,
+                    path: '/',
+                    ...buildCookieOptions(req)
+                });
+            }
             return value;
         }));
     }
-    /**
-   * Clear refresh token cookie
-   */ clearRefreshTokenCookie(req, res) {
-        const origin = req.headers.origin || '';
-        const hostname = req.hostname || '';
-        const isHttps = origin.startsWith('https://') || req.secure;
-        let cookieDomain = hostname;
-        const domainParts = hostname.split('.');
-        if (domainParts.length > 2) {
-            cookieDomain = '.' + domainParts.slice(-2).join('.');
-        }
-        res.clearCookie(this.cookieName, {
-            httpOnly: true,
-            secure: isHttps,
-            sameSite: isHttps ? 'strict' : 'lax',
-            domain: cookieDomain,
-            path: '/'
-        });
-    }
     constructor(authConfig){
         _define_property(this, "authConfig", void 0);
         this.authConfig = authConfig;

package/fesm/interceptors/set-token.interceptor.js

@@ -25,84 +25,43 @@ function _ts_param(paramIndex, decorator) {
         decorator(target, key, paramIndex);
     };
 }
-import { Injectable, Optional, PayloadTooLargeException } from '@nestjs/common';
+import { buildCookieOptions, isBrowserRequest, parseDurationToMs } from '@flusys/nestjs-shared/utils';
+import { Inject, Injectable, Optional, PayloadTooLargeException } from '@nestjs/common';
 import { Buffer } from 'buffer';
 import { catchError, map, throwError } from 'rxjs';
+import { DEFAULT_COOKIE_NAME, MAX_COOKIE_BYTES } from '../config';
 import { AuthConfigService } from '../services/auth-config.service';
-const DEFAULT_COOKIE_NAME = 'fsn_refresh_token';
-const MAX_COOKIE_BYTES = 3500;
 export class SetToken {
     get cookieName() {
         return this.authConfig?.getRefreshTokenCookieName() ?? DEFAULT_COOKIE_NAME;
     }
+    get maxAgeMs() {
+        return parseDurationToMs(this.authConfig?.getRefreshTokenExpiration() ?? '7d');
+    }
     intercept(context, next) {
         const req = context.switchToHttp().getRequest();
         const res = context.switchToHttp().getResponse();
         return next.handle().pipe(map((value)=>{
-            // Skip if no refreshToken in response
-            if (!value || !value.refreshToken) {
-                return value;
-            }
-            const isBrowser = this.isBrowserRequest(req);
-            const tokenValue = value.refreshToken;
-            if (isBrowser) {
-                // Browser: Set cookie and remove from response body
-                this.setRefreshTokenCookie(req, res, tokenValue);
-                // Return response without refreshToken for browsers
+            if (!value?.refreshToken) return value;
+            if (isBrowserRequest(req)) {
+                this.setRefreshTokenCookie(req, res, value.refreshToken);
                 const { refreshToken, ...responseWithoutToken } = value;
                 return responseWithoutToken;
             }
-            // API/Mobile: Keep refreshToken in response body
             return value;
         }), catchError((err)=>throwError(()=>err)));
     }
-    /**
-   * Detect if request is from a browser
-   * Checks Accept header and custom X-Client-Type header
-   */ isBrowserRequest(req) {
-        // Check custom header first (allows explicit client identification)
-        const clientType = req.headers['x-client-type'];
-        if (clientType) {
-            return clientType.toLowerCase() === 'browser' || clientType.toLowerCase() === 'web';
-        }
-        // Check Accept header - browsers typically include text/html
-        const accept = req.headers['accept'] || '';
-        if (accept.includes('text/html')) {
-            return true;
-        }
-        // Check User-Agent for common browsers
-        const userAgent = req.headers['user-agent'] || '';
-        const browserPatterns = /mozilla|chrome|safari|firefox|edge|opera|msie/i;
-        if (browserPatterns.test(userAgent) && !userAgent.includes('Postman')) {
-            return true;
-        }
-        return false;
-    }
-    /**
-   * Set refresh token in HTTP-only cookie
-   */ setRefreshTokenCookie(req, res, tokenValue) {
-        const origin = req.headers.origin || '';
-        const hostname = req.hostname || '';
-        const isHttps = origin.startsWith('https://') || req.secure;
-        let cookieDomain = hostname;
-        const domainParts = hostname.split('.');
-        if (domainParts.length > 2) {
-            cookieDomain = '.' + domainParts.slice(-2).join('.');
-        }
-        // Check cookie size
-        const rawCookieString = `${this.cookieName}=${tokenValue}; HttpOnly; Domain=${cookieDomain}`;
+    setRefreshTokenCookie(req, res, tokenValue) {
+        const rawCookieString = `${this.cookieName}=${tokenValue}; HttpOnly`;
         const estimatedBytes = Buffer.byteLength(rawCookieString, 'utf8');
         if (estimatedBytes > MAX_COOKIE_BYTES) {
             throw new PayloadTooLargeException(`Refresh token too large (≈${estimatedBytes} bytes)`);
         }
-        // Set HTTP-only secure cookie
         res.cookie(this.cookieName, tokenValue, {
             httpOnly: true,
-            secure: isHttps,
-            sameSite: isHttps ? 'strict' : 'lax',
-            domain: cookieDomain,
             path: '/',
-            maxAge: 7 * 24 * 60 * 60 * 1000
+            maxAge: this.maxAgeMs,
+            ...buildCookieOptions(req)
         });
     }
     constructor(authConfig){
@@ -113,6 +72,7 @@ export class SetToken {
 SetToken = _ts_decorate([
     Injectable(),
     _ts_param(0, Optional()),
+    _ts_param(0, Inject(AuthConfigService)),
     _ts_metadata("design:type", Function),
     _ts_metadata("design:paramtypes", [
         typeof AuthConfigService === "undefined" ? Object : AuthConfigService

package/fesm/interfaces/auth-email-provider.interface.js

@@ -0,0 +1,38 @@
+/**
+ * Auth Email  Provider Interface
+ *
+ * This interface defines the contract for email sending in the auth module.
+ * It allows auth to work independently of the email module.
+ *
+ * To use email features in auth:
+ * 1. Provide AUTH_EMAIL_PROVIDER in your app module
+ * 2. Implement IAuthEmailProvider using EmailSendService from nestjs-email
+ *
+ * @example
+ * ```typescript
+ * // In app.module.ts or a provider file
+ * {
+ *   provide: AUTH_EMAIL_PROVIDER,
+ *   useFactory: (emailSendService: EmailSendService) => ({
+ *     sendPasswordResetEmail: async (email, token, resetUrl) => {
+ *       await emailSendService.sendTemplateEmail({
+ *         templateSlug: 'password-reset',
+ *         to: email,
+ *         variables: { resetUrl, token },
+ *       });
+ *     },
+ *     sendVerificationEmail: async (email, token, verifyUrl) => {
+ *       await emailSendService.sendTemplateEmail({
+ *         templateSlug: 'email-verification',
+ *         to: email,
+ *         variables: { verifyUrl, token },
+ *       });
+ *     },
+ *   }),
+ *   inject: [EmailSendService],
+ * }
+ * ```
+ */ /**
+ * Injection token for auth email provider
+ * Use this to provide the email implementation
+ */ export const AUTH_EMAIL_PROVIDER = 'AUTH_EMAIL_PROVIDER';

package/fesm/interfaces/authentication.interface.js

@@ -1 +1 @@
-/** Login Response when company/branch selection is required */ export { };
+/** Login Response when email verification is required */ export { };

package/fesm/interfaces/index.js

@@ -1,5 +1,7 @@
 export * from './authentication.interface';
+export * from './auth-email-provider.interface';
 export * from './company-branch.interface';
 export * from './company.interface';
 export * from './user.interface';
+export * from './user-enricher.interface';
 export * from './auth-module-options.interface';

package/fesm/interfaces/user-enricher.interface.js

@@ -0,0 +1,26 @@
+/**
+ * User Enricher Provider Interface
+ *
+ * Allows consuming applications to extend user list and profile
+ * without modifying the base nestjs-auth package.
+ *
+ * This follows the Provider Interface Pattern:
+ * - nestjs-auth defines the interface (this file)
+ * - Consuming apps implement the interface
+ * - nestjs-auth optionally injects the implementation
+ *
+ * @example
+ * // In your app module
+ * providers: [
+ *   { provide: USER_ENRICHER, useClass: MyUserEnricher },
+ * ]
+ *
+ * // Your enricher implementation
+ * @Injectable()
+ * export class MyUserEnricher implements IUserEnricher {
+ *   async enrichListQuery(query, user) {
+ *     query.leftJoinAndSelect('user.department', 'department');
+ *     return { extraFields: ['department.name'] };
+ *   }
+ * }
+ */ export { };

package/fesm/modules/auth.module.js

@@ -5,95 +5,57 @@ function _ts_decorate(decorators, target, key, desc) {
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
 import { CacheModule, UtilsModule } from '@flusys/nestjs-shared/modules';
-import { Module, Scope } from '@nestjs/common';
+import { Module } from '@nestjs/common';
 import { JwtModule } from '@nestjs/jwt';
 import { PassportModule } from '@nestjs/passport';
-import { getRepositoryToken } from '@nestjs/typeorm';
-import { AuthConfigService } from '../services/auth-config.service';
-import { AuthDataSourceProvider } from '../services/auth-datasource.provider';
+import { JwtAuthGuard } from '@flusys/nestjs-shared/guards';
 import { AUTH_MODULE_OPTIONS } from '../config/auth.constants';
 import { AuthenticationController, BranchController, CompanyController, CompanySelectionController, UserController, UserPermissionController } from '../controllers';
 import { Company, CompanyBranch, User, UserCompanyPermission } from '../entities';
-import { JwtAuthGuard } from '@flusys/nestjs-shared/guards';
 import { ClearToken } from '../interceptors/clear-token.interceptor';
 import { SetToken } from '../interceptors/set-token.interceptor';
-import { AuthenticationService, BranchService, CompanySelectionSessionService, CompanyService, UserPermissionService, UserService } from '../services';
+import { AuthEmailService, AuthenticationService, BranchService, CompanySelectionSessionService, CompanyService, UserPermissionService, UserService } from '../services';
+import { AuthConfigService } from '../services/auth-config.service';
+import { AuthDataSourceProvider } from '../services/auth-datasource.provider';
 import { JwtStrategy } from '../strategies/jwt.strategy';
 export class AuthModule {
     static forRoot(options) {
-        return this.buildDynamicModule(options);
+        const optionsProvider = {
+            provide: AUTH_MODULE_OPTIONS,
+            useValue: options
+        };
+        return this.buildModule(options, [
+            optionsProvider,
+            ...options.providers ?? []
+        ]);
     }
-    static forRootAsync(asyncOptions) {
-        const { global = false, includeController = true, bootstrapAppConfig: { enableCompanyFeature } = {}, imports: externalImports = [] } = asyncOptions;
-        const asyncProviders = this.createAsyncProviders(asyncOptions);
-        // Build imports
-        const imports = [
-            ...externalImports,
-            PassportModule.register({
-                defaultStrategy: 'jwt'
-            }),
-            JwtModule.register({}),
-            CacheModule,
-            UtilsModule
-        ];
-        // Build controllers based on configuration
-        const controllers = [];
-        if (includeController) {
-            // Core authentication controller (always included)
-            controllers.push(AuthenticationController);
-            // User controller (always included)
-            controllers.push(UserController);
-            // Company feature controllers (conditional)
-            if (enableCompanyFeature) {
-                controllers.push(CompanySelectionController, CompanyController, BranchController, UserPermissionController);
-            }
-        }
-        // Build providers
-        const providers = [
+    static forRootAsync(options) {
+        const asyncProviders = this.createAsyncProviders(options);
+        return this.buildModule(options, [
             ...asyncProviders,
-            // Config & Infrastructure
-            AuthConfigService,
-            AuthDataSourceProvider,
-            // Auth core
-            JwtStrategy,
-            JwtAuthGuard,
-            AuthenticationService,
-            // Interceptors
-            SetToken,
-            ClearToken,
-            // Core services (always included)
-            UserService
-        ];
-        // Company feature services (conditional)
-        if (enableCompanyFeature) {
-            providers.push(CompanySelectionSessionService, CompanyService, BranchService, UserPermissionService);
-        }
-        // Build exports
-        const exports = [
-            PassportModule,
-            AUTH_MODULE_OPTIONS,
-            AuthConfigService,
-            AuthDataSourceProvider,
-            JwtStrategy,
-            JwtAuthGuard,
-            AuthenticationService,
-            UserService
-        ];
-        if (enableCompanyFeature) {
-            exports.push(CompanySelectionSessionService, CompanyService, BranchService, UserPermissionService);
-        }
+            ...options.providers ?? []
+        ], options.imports);
+    }
+    /** Build the dynamic module with shared logic */ static buildModule(options, providers, externalImports = []) {
+        const { global = false, includeController = true, bootstrapAppConfig } = options;
+        const enableCompanyFeature = bootstrapAppConfig?.enableCompanyFeature ?? false;
         return {
             module: AuthModule,
             global,
-            imports,
-            controllers,
-            providers,
-            exports
+            imports: [
+                ...externalImports,
+                ...this.buildImports()
+            ],
+            controllers: this.buildControllers(includeController, enableCompanyFeature),
+            providers: [
+                ...providers,
+                ...this.buildProviders(enableCompanyFeature)
+            ],
+            exports: this.buildExports(enableCompanyFeature)
         };
     }
-    static buildDynamicModule(options) {
-        const { bootstrapAppConfig: { enableCompanyFeature } = {}, includeController = true, global = false } = options;
-        const imports = [
+    /** Common module imports */ static buildImports() {
+        return [
             PassportModule.register({
                 defaultStrategy: 'jwt'
             }),
@@ -101,40 +63,36 @@ export class AuthModule {
             CacheModule,
             UtilsModule
         ];
-        // Build controllers based on configuration
-        const controllers = [];
-        if (includeController) {
-            // Core authentication controller (always included)
-            controllers.push(AuthenticationController);
-            // User controller (always included)
-            controllers.push(UserController);
-            // Company feature controllers (conditional)
-            if (enableCompanyFeature) {
-                controllers.push(CompanySelectionController, CompanyController, BranchController, UserPermissionController);
-            }
+    }
+    /** Build controllers based on feature flags */ static buildControllers(includeController, enableCompanyFeature) {
+        if (!includeController) return [];
+        const controllers = [
+            AuthenticationController,
+            UserController
+        ];
+        if (enableCompanyFeature) {
+            controllers.push(CompanySelectionController, CompanyController, BranchController, UserPermissionController);
         }
+        return controllers;
+    }
+    /** Core providers (without AUTH_MODULE_OPTIONS - that's added separately) */ static buildProviders(enableCompanyFeature) {
         const providers = [
-            {
-                provide: AUTH_MODULE_OPTIONS,
-                useValue: options
-            },
-            // Config & Infrastructure
             AuthConfigService,
             AuthDataSourceProvider,
-            // Auth core
             JwtStrategy,
             JwtAuthGuard,
             AuthenticationService,
-            // Interceptors
+            AuthEmailService,
             SetToken,
             ClearToken,
-            // Core services (always included)
             UserService
         ];
-        // Company feature services (conditional)
         if (enableCompanyFeature) {
             providers.push(CompanySelectionSessionService, CompanyService, BranchService, UserPermissionService);
         }
+        return providers;
+    }
+    /** Build module exports */ static buildExports(enableCompanyFeature) {
         const exports = [
             PassportModule,
             AUTH_MODULE_OPTIONS,
@@ -143,21 +101,15 @@ export class AuthModule {
             JwtStrategy,
             JwtAuthGuard,
             AuthenticationService,
+            AuthEmailService,
             UserService
         ];
         if (enableCompanyFeature) {
             exports.push(CompanySelectionSessionService, CompanyService, BranchService, UserPermissionService);
         }
-        return {
-            module: AuthModule,
-            global,
-            imports,
-            controllers,
-            providers,
-            exports
-        };
+        return exports;
     }
-    static createAsyncProviders(options) {
+    /** Create async providers for forRootAsync */ static createAsyncProviders(options) {
         const staticOptions = {
             global: options.global,
             includeController: options.includeController,
@@ -167,13 +119,10 @@ export class AuthModule {
             return [
                 {
                     provide: AUTH_MODULE_OPTIONS,
-                    useFactory: async (...args)=>{
-                        const config = await options.useFactory(...args);
-                        return {
+                    useFactory: async (...args)=>({
                             ...staticOptions,
-                            config
-                        };
-                    },
+                            config: await options.useFactory(...args)
+                        }),
                     inject: options.inject || []
                 }
             ];
@@ -186,13 +135,10 @@ export class AuthModule {
                 },
                 {
                     provide: AUTH_MODULE_OPTIONS,
-                    useFactory: async (factory)=>{
-                        const config = await factory.createAuthOptions();
-                        return {
+                    useFactory: async (factory)=>({
                             ...staticOptions,
-                            config
-                        };
-                    },
+                            config: await factory.createAuthOptions()
+                        }),
                     inject: [
                         options.useClass
                     ]
@@ -203,13 +149,10 @@ export class AuthModule {
             return [
                 {
                     provide: AUTH_MODULE_OPTIONS,
-                    useFactory: async (factory)=>{
-                        const config = await factory.createAuthOptions();
-                        return {
+                    useFactory: async (factory)=>({
                             ...staticOptions,
-                            config
-                        };
-                    },
+                            config: await factory.createAuthOptions()
+                        }),
                     inject: [
                         options.useExisting
                     ]
@@ -223,35 +166,14 @@ export class AuthModule {
             }
         ];
     }
-    /**
-   * Create repository providers that use AuthDataSourceProvider
-   * This replaces TypeOrmModule.forFeature() functionality
-   * Note: Must be REQUEST-scoped since AuthDataSourceProvider is REQUEST-scoped
-   */ static getRepositoryProviders(enableCompanyFeature) {
-        const entities = this.getEntities(enableCompanyFeature);
-        return entities.map((entity)=>({
-                provide: getRepositoryToken(entity),
-                scope: Scope.REQUEST,
-                useFactory: async (dataSourceProvider)=>{
-                    return await dataSourceProvider.getRepository(entity);
-                },
-                inject: [
-                    AuthDataSourceProvider
-                ]
-            }));
-    }
-    static getEntities(enableCompanyFeature = false) {
-        const coreEntities = [
-            User
-        ];
-        const companyEntities = enableCompanyFeature ? [
+    /** Get auth entities based on feature flags */ static getEntities(enableCompanyFeature = false) {
+        return enableCompanyFeature ? [
+            User,
             Company,
             CompanyBranch,
             UserCompanyPermission
-        ] : [];
-        return [
-            ...coreEntities,
-            ...companyEntities
+        ] : [
+            User
         ];
     }
 }