@ackplus/nest-auth 0.1.45 → 0.1.46

package/README.md

@@ -410,7 +410,108 @@ NestAuthModule.forRoot({
 - **Automatic tenant resolution**: No need to specify tenant ID in auth operations
 - **Backward compatibility**: Existing apps can add this without breaking changes
 
-For detailed examples and configuration options, see [TENANT_EXAMPLES.md](TENANT_EXAMPLES.md).
+For detailed examples and configuration options, see the Default Tenant Configuration section above.
+
+## Debug Logging
+
+The nest-auth package includes comprehensive debug logging to help you troubleshoot issues during development. Debug logging is configurable and can provide detailed insights into authentication flows, user operations, and more.
+
+### Enable Debug Logging
+
+```typescript
+NestAuthModule.forRoot({
+  jwt: { secret: 'your-secret' },
+  debug: {
+    enabled: true,
+    level: 'debug', // 'error' | 'warn' | 'info' | 'debug' | 'verbose'
+    prefix: '[NestAuth]',
+    includeTimestamp: true,
+    includeContext: true
+  },
+  // ... other options
+})
+```
+
+### Debug Configuration Options
+
+- **`enabled`** (default: `false`): Enable/disable debug logging
+- **`level`** (default: `'info'`): Log level - controls which messages are shown
+- **`prefix`** (default: `'[NestAuth]'`): Prefix for all log messages
+- **`includeTimestamp`** (default: `true`): Include timestamp in log messages
+- **`includeContext`** (default: `true`): Include context (service name) in log messages
+
+### Log Levels
+
+- **`error`**: Only error messages
+- **`warn`**: Errors and warnings
+- **`info`**: Errors, warnings, and info messages
+- **`debug`**: All above plus debug messages
+- **`verbose`**: All messages including verbose debugging
+
+### What Gets Logged
+
+With debug logging enabled, you'll see detailed information about:
+
+#### User Operations
+- User creation attempts and results
+- User lookup operations
+- Identity creation and linking
+- User validation steps
+
+#### Authentication Operations
+- Login attempts with provider information
+- Signup processes step-by-step
+- Token generation and validation
+- Session creation and management
+- MFA verification processes
+
+#### Tenant Operations
+- Default tenant resolution
+- Tenant creation and lookup
+- Multi-tenant routing decisions
+
+#### Error Handling
+- Detailed error contexts with stack traces
+- Input data that caused errors (sensitive data masked)
+- Operation states when errors occurred
+
+### Example Debug Output
+
+```
+[NestAuth] [2024-01-15T10:30:45.123Z] [AuthService] Entering function: signup | Data: {
+  "params": {
+    "email": "user@example.com",
+    "hasPassword": true
+  }
+}
+
+[NestAuth] [2024-01-15T10:30:45.125Z] [AuthService] Auth Operation: signup | Data: {
+  "operation": "signup",
+  "providerId": "email|phone",
+  "email": "user@example.com",
+  "resolvedTenantId": "tenant-123"
+}
+
+[NestAuth] [2024-01-15T10:30:45.127Z] [UserService] User Operation: createUser | Data: {
+  "operation": "createUser",
+  "email": true,
+  "resolvedTenantId": "tenant-123"
+}
+```
+
+### Development vs Production
+
+- **Development**: Use `debug` or `verbose` level for detailed troubleshooting
+- **Production**: Use `error` or `warn` level, or disable entirely for performance
+
+### Performance Considerations
+
+Debug logging adds minimal overhead when disabled. When enabled at `debug` or `verbose` levels, there is some performance impact due to:
+- JSON serialization of data objects
+- Additional function calls
+- Console I/O operations
+
+For production use, consider using `info` level or lower.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ackplus/nest-auth",
-  "version": "0.1.45",
+  "version": "0.1.46",
   "type": "commonjs",
   "main": "./src/index.js",
   "types": "./src/index.d.ts",

package/src/index.d.ts

@@ -8,3 +8,4 @@ export * from './lib/tenant';
 export * from './lib/core';
 export { AuthModuleOptions, AuthModuleAsyncOptions, AuthModuleOptionsFactory, DefaultTenantOptions } from './lib/core/interfaces/auth-module-options.interface';
 export { AuthConfigService } from './lib/core/services/auth-config.service';
+export { DebugLoggerService, DebugLogLevel, DebugLogOptions } from './lib/core/services/debug-logger.service';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AuthConfigService = void 0;
+exports.DebugLogLevel = exports.DebugLoggerService = exports.AuthConfigService = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./lib/nest-auth.module"), exports);
 tslib_1.__exportStar(require("./lib/auth.constants"), exports);
@@ -12,4 +12,7 @@ tslib_1.__exportStar(require("./lib/tenant"), exports);
 tslib_1.__exportStar(require("./lib/core"), exports);
 var auth_config_service_1 = require("./lib/core/services/auth-config.service");
 Object.defineProperty(exports, "AuthConfigService", { enumerable: true, get: function () { return auth_config_service_1.AuthConfigService; } });
+var debug_logger_service_1 = require("./lib/core/services/debug-logger.service");
+Object.defineProperty(exports, "DebugLoggerService", { enumerable: true, get: function () { return debug_logger_service_1.DebugLoggerService; } });
+Object.defineProperty(exports, "DebugLogLevel", { enumerable: true, get: function () { return debug_logger_service_1.DebugLogLevel; } });
 //# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/nest-auth/src/index.ts"],"names":[],"mappings":";;;;AAAA,iEAAuC;AAEvC,+DAAqC;AAGrC,qDAA2B;AAC3B,wDAA8B;AAC9B,qDAA2B;AAC3B,qDAA2B;AAC3B,uDAA6B;AAC7B,qDAA2B;AAM3B,+EAA4E;AAAnE,wHAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/nest-auth/src/index.ts"],"names":[],"mappings":";;;;AAAA,iEAAuC;AAEvC,+DAAqC;AAGrC,qDAA2B;AAC3B,wDAA8B;AAC9B,qDAA2B;AAC3B,qDAA2B;AAC3B,uDAA6B;AAC7B,qDAA2B;AAM3B,+EAA4E;AAAnE,wHAAA,iBAAiB,OAAA;AAG1B,iFAA8G;AAArG,0HAAA,kBAAkB,OAAA;AAAE,qHAAA,aAAa,OAAA"}

package/src/lib/auth/services/auth.service.d.ts

@@ -14,6 +14,7 @@ import { ForgotPasswordRequestDto } from '../dto/requests/forgot-password.reques
 import { ResetPasswordRequestDto } from '../dto/requests/reset-password.request.dto';
 import { AuthProviderRegistryService } from '../../core/services/auth-provider-registry.service';
 import { TenantService } from '../../tenant/services/tenant.service';
+import { DebugLoggerService } from '../../core/services/debug-logger.service';
 export declare class AuthService {
     private readonly userRepository;
     private otpRepository;
@@ -23,7 +24,8 @@ export declare class AuthService {
     private readonly jwtService;
     private readonly eventEmitter;
     private readonly tenantService;
-    constructor(userRepository: Repository<NestAuthUser>, otpRepository: Repository<NestAuthOTP>, authProviderRegistry: AuthProviderRegistryService, mfaService: MfaService, sessionService: BaseSessionService, jwtService: JwtService, eventEmitter: EventEmitter2, tenantService: TenantService);
+    private readonly debugLogger;
+    constructor(userRepository: Repository<NestAuthUser>, otpRepository: Repository<NestAuthOTP>, authProviderRegistry: AuthProviderRegistryService, mfaService: MfaService, sessionService: BaseSessionService, jwtService: JwtService, eventEmitter: EventEmitter2, tenantService: TenantService, debugLogger: DebugLoggerService);
     getUserWithRolesAndPermissions(userId: string, relations?: string[]): Promise<NestAuthUser>;
     getUser(): Promise<NestAuthUser>;
     signup(input: SignupRequestDto): Promise<AuthResponseDto>;