@flusys/nestjs-auth 1.1.0-beta → 2.0.0

package/fesm/docs/auth-swagger.config.js

@@ -4,6 +4,16 @@
     'User Permissions',
     'Company Selection'
 ];
+/** Examples to exclude when company feature is disabled */ const COMPANY_EXAMPLE_EXCLUSIONS = [
+    {
+        pathPattern: '/auth/login',
+        method: 'post',
+        examples: [
+            'loginSuccessWithCompany',
+            'companySelection'
+        ]
+    }
+];
 /**
  * Schema properties to exclude when company feature is disabled
  *
@@ -48,16 +58,14 @@
         schemaName: 'RegistrationResponseDto',
         properties: [
             'company',
-            'branch',
-            'companyFeatureEnabled'
+            'branch'
         ]
     },
     {
         schemaName: 'LoginResponseDto',
         properties: [
             'company',
-            'branch',
-            'companyFeatureEnabled'
+            'branch'
         ]
     },
     {
@@ -92,7 +100,6 @@
             'id',
             'name',
             'slug',
-            'isActive',
             'logoId'
         ]
     },
@@ -102,7 +109,6 @@
             'id',
             'name',
             'slug',
-            'isActive',
             'logoId',
             'branches'
         ]
@@ -401,6 +407,7 @@ POST /auth/login → { accessToken, refreshToken, user }
         path: 'api/docs/auth',
         bearerAuth: true,
         excludeTags,
-        excludeSchemaProperties: enableCompanyFeature ? undefined : COMPANY_SCHEMA_EXCLUSIONS
+        excludeSchemaProperties: enableCompanyFeature ? undefined : COMPANY_SCHEMA_EXCLUSIONS,
+        excludeExamples: enableCompanyFeature ? undefined : COMPANY_EXAMPLE_EXCLUSIONS
     };
 }

package/fesm/dtos/authentication.dto.js

@@ -21,7 +21,8 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsEmail, IsNotEmpty, IsOptional, IsString, IsUUID, MaxLength, MinLength, ValidateIf } from 'class-validator';
+import { IsEmail, IsNotEmpty, IsOptional, IsString, IsUUID, MaxLength, ValidateIf } from 'class-validator';
+import { IsStrongPassword } from '../validators/password.validator';
 // Request DTOs
 /** Login Request DTO */ export class LoginDto {
     constructor(){
@@ -40,12 +41,12 @@ _ts_decorate([
 ], LoginDto.prototype, "email", void 0);
 _ts_decorate([
     ApiProperty({
-        example: '123456',
-        description: 'User password (min 6 chars)'
+        example: 'SecureP@ss1',
+        description: 'User password'
     }),
     IsString(),
     IsNotEmpty(),
-    MinLength(6),
+    MaxLength(128),
     _ts_metadata("design:type", String)
 ], LoginDto.prototype, "password", void 0);
 /** Registration Request DTO - Supports simple and company-based registration */ export class RegistrationDto {
@@ -84,13 +85,13 @@ _ts_decorate([
 ], RegistrationDto.prototype, "email", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'strongPassword123',
-        description: 'Password (min 6 chars)'
+        example: 'StrongP@ss123',
+        description: 'Password (min 8 chars, requires uppercase, lowercase, number, special char)'
     }),
     IsNotEmpty(),
     IsString(),
-    MinLength(6),
-    MaxLength(60),
+    IsStrongPassword(),
+    MaxLength(128),
     _ts_metadata("design:type", String)
 ], RegistrationDto.prototype, "password", void 0);
 _ts_decorate([
@@ -151,6 +152,7 @@ _ts_decorate([
     }),
     IsOptional(),
     IsString(),
+    MaxLength(500),
     _ts_metadata("design:type", String)
 ], RegistrationDto.prototype, "newCompanyAddress", void 0);
 /** Refresh Token Request DTO - refreshToken optional in body (browsers use HTTP-only cookie) */ export class RefreshTokenDto {
@@ -180,16 +182,17 @@ _ts_decorate([
     }),
     IsString(),
     IsNotEmpty(),
+    MaxLength(128),
     _ts_metadata("design:type", String)
 ], ChangePasswordDto.prototype, "currentPassword", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'newPassword456',
-        description: 'New password (min 6 chars)'
+        example: 'NewP@ssword456',
+        description: 'New password (min 8 chars, requires uppercase, lowercase, number, special char)'
     }),
     IsString(),
     IsNotEmpty(),
-    MinLength(6),
+    IsStrongPassword(),
     _ts_metadata("design:type", String)
 ], ChangePasswordDto.prototype, "newPassword", void 0);
 /** Select Company & Branch Request DTO - Used after login when user needs to select company and branch */ export class SelectDto {
@@ -358,7 +361,6 @@ _ts_decorate([
         _define_property(this, "id", void 0);
         _define_property(this, "name", void 0);
         _define_property(this, "slug", void 0);
-        _define_property(this, "isActive", void 0);
         _define_property(this, "logoId", void 0);
     }
 }
@@ -380,12 +382,6 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", String)
 ], BranchSelectionInfoDto.prototype, "slug", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: true
-    }),
-    _ts_metadata("design:type", Boolean)
-], BranchSelectionInfoDto.prototype, "isActive", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         example: '550e8400-e29b-41d4-a716-446655440077',
@@ -399,7 +395,6 @@ _ts_decorate([
         _define_property(this, "id", void 0);
         _define_property(this, "name", void 0);
         _define_property(this, "slug", void 0);
-        _define_property(this, "isActive", void 0);
         _define_property(this, "logoId", void 0);
         _define_property(this, "branches", void 0);
     }
@@ -422,12 +417,6 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", String)
 ], CompanyWithBranchesDto.prototype, "slug", void 0);
-_ts_decorate([
-    ApiProperty({
-        example: true
-    }),
-    _ts_metadata("design:type", Boolean)
-], CompanyWithBranchesDto.prototype, "isActive", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         example: '550e8400-e29b-41d4-a716-446655440088',
@@ -452,7 +441,6 @@ _ts_decorate([
         _define_property(this, "user", void 0);
         _define_property(this, "company", void 0);
         _define_property(this, "branch", void 0);
-        _define_property(this, "companyFeatureEnabled", void 0);
     }
 }
 _ts_decorate([
@@ -488,13 +476,6 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", typeof BranchInfoDto === "undefined" ? Object : BranchInfoDto)
 ], LoginResponseDto.prototype, "branch", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        example: true,
-        description: 'Whether company feature is enabled'
-    }),
-    _ts_metadata("design:type", Boolean)
-], LoginResponseDto.prototype, "companyFeatureEnabled", void 0);
 /** Registration Response DTO - Returned on successful registration */ export class RegistrationResponseDto {
     constructor(){
         _define_property(this, "accessToken", void 0);
@@ -502,7 +483,6 @@ _ts_decorate([
         _define_property(this, "user", void 0);
         _define_property(this, "company", void 0);
         _define_property(this, "branch", void 0);
-        _define_property(this, "companyFeatureEnabled", void 0);
         _define_property(this, "requiresEmailVerification", void 0);
     }
 }
@@ -539,13 +519,6 @@ _ts_decorate([
     }),
     _ts_metadata("design:type", typeof BranchInfoDto === "undefined" ? Object : BranchInfoDto)
 ], RegistrationResponseDto.prototype, "branch", void 0);
-_ts_decorate([
-    ApiPropertyOptional({
-        example: true,
-        description: 'Whether company feature is enabled'
-    }),
-    _ts_metadata("design:type", Boolean)
-], RegistrationResponseDto.prototype, "companyFeatureEnabled", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         example: true,
@@ -684,12 +657,12 @@ _ts_decorate([
 ], ResetPasswordDto.prototype, "token", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'newSecurePassword123',
-        description: 'New password (min 6 chars)'
+        example: 'NewSecureP@ss123',
+        description: 'New password (min 8 chars, requires uppercase, lowercase, number, special char)'
     }),
     IsString(),
     IsNotEmpty(),
-    MinLength(6),
+    IsStrongPassword(),
     _ts_metadata("design:type", String)
 ], ResetPasswordDto.prototype, "newPassword", void 0);
 /** Verify Email Request DTO - Verifies email using token */ export class VerifyEmailDto {

package/fesm/dtos/index.js

@@ -1,6 +1,5 @@
 export * from './authentication.dto';
 export * from './company-branch.dto';
 export * from './company.dto';
-export * from './user-company-permission.dto';
 export * from './user.dto';
 export * from './user-permission.dto';

package/fesm/dtos/user-permission.dto.js

@@ -233,9 +233,23 @@ _ts_decorate([
  * User companies response
  */ export class UserCompaniesResponseDto {
     constructor(){
+        _define_property(this, "success", void 0);
+        _define_property(this, "message", void 0);
         _define_property(this, "data", void 0);
     }
 }
+_ts_decorate([
+    ApiProperty({
+        example: true
+    }),
+    _ts_metadata("design:type", Boolean)
+], UserCompaniesResponseDto.prototype, "success", void 0);
+_ts_decorate([
+    ApiProperty({
+        example: 'User companies retrieved successfully'
+    }),
+    _ts_metadata("design:type", String)
+], UserCompaniesResponseDto.prototype, "message", void 0);
 _ts_decorate([
     ApiProperty({
         description: 'List of companies the user has access to',
@@ -265,9 +279,23 @@ _ts_decorate([
  * User branches response
  */ export class UserBranchesResponseDto {
     constructor(){
+        _define_property(this, "success", void 0);
+        _define_property(this, "message", void 0);
         _define_property(this, "data", void 0);
     }
 }
+_ts_decorate([
+    ApiProperty({
+        example: true
+    }),
+    _ts_metadata("design:type", Boolean)
+], UserBranchesResponseDto.prototype, "success", void 0);
+_ts_decorate([
+    ApiProperty({
+        example: 'User branches retrieved successfully'
+    }),
+    _ts_metadata("design:type", String)
+], UserBranchesResponseDto.prototype, "message", void 0);
 _ts_decorate([
     ApiProperty({
         description: 'List of branches the user has access to',

package/fesm/dtos/user.dto.js

@@ -21,7 +21,8 @@ function _ts_metadata(k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 import { ApiProperty, ApiPropertyOptional } from '@nestjs/swagger';
-import { IsBoolean, IsEmail, IsObject, IsOptional, IsString } from 'class-validator';
+import { IsBoolean, IsEmail, IsNotEmpty, IsObject, IsOptional, IsString, IsUUID, MaxLength } from 'class-validator';
+import { IsStrongPassword } from '../validators/password.validator';
 export class CreateUserDto {
     constructor(){
         _define_property(this, "name", void 0);
@@ -62,10 +63,13 @@ _ts_decorate([
 ], CreateUserDto.prototype, "email", void 0);
 _ts_decorate([
     ApiProperty({
-        example: 'password123',
-        description: 'Password'
+        example: 'SecureP@ss123',
+        description: 'Password (must meet complexity requirements)'
     }),
     IsString(),
+    IsNotEmpty(),
+    IsStrongPassword(),
+    MaxLength(128),
     _ts_metadata("design:type", String)
 ], CreateUserDto.prototype, "password", void 0);
 _ts_decorate([
@@ -118,6 +122,7 @@ export class UpdateUserDto {
         _define_property(this, "phone", void 0);
         _define_property(this, "email", void 0);
         _define_property(this, "password", void 0);
+        _define_property(this, "oldPassword", void 0);
         _define_property(this, "profilePictureId", void 0);
         _define_property(this, "isActive", void 0);
         _define_property(this, "emailVerified", void 0);
@@ -129,7 +134,7 @@ _ts_decorate([
     ApiProperty({
         description: 'User ID'
     }),
-    IsString(),
+    IsUUID(),
     _ts_metadata("design:type", String)
 ], UpdateUserDto.prototype, "id", void 0);
 _ts_decorate([
@@ -161,12 +166,22 @@ _ts_decorate([
 ], UpdateUserDto.prototype, "email", void 0);
 _ts_decorate([
     ApiPropertyOptional({
-        description: 'New password'
+        description: 'New password (must meet complexity requirements)'
     }),
     IsOptional(),
     IsString(),
+    IsStrongPassword(),
+    MaxLength(128),
     _ts_metadata("design:type", String)
 ], UpdateUserDto.prototype, "password", void 0);
+_ts_decorate([
+    ApiPropertyOptional({
+        description: 'Current password (required when changing password on own profile)'
+    }),
+    IsOptional(),
+    IsString(),
+    _ts_metadata("design:type", String)
+], UpdateUserDto.prototype, "oldPassword", void 0);
 _ts_decorate([
     ApiPropertyOptional({
         description: 'Profile picture file ID'

package/fesm/entities/user-company-permission.entity.js

@@ -27,12 +27,6 @@ import { Company } from './company.entity';
 import { User } from './user.entity';
 export { PermissionType };
 export class UserCompanyPermission {
-    /* ---------- Helpers ---------- */ isCompanyPermission() {
-        return this.permissionType === PermissionType.COMPANY;
-    }
-    isBranchPermission() {
-        return this.permissionType === PermissionType.BRANCH;
-    }
     constructor(){
         _define_property(this, "id", void 0);
         /* ---------- Ownership ---------- */ _define_property(this, "userId", void 0);

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

@@ -1,5 +1,5 @@
 /**
- * Auth Email Provider Interface
+ * 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.