@nauth-toolkit/core 0.1.14 → 0.1.18

package/dist/dto/social-auth.dto.js

@@ -12,8 +12,35 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SetPasswordForSocialUserResponseDTO = exports.SetPasswordForSocialUserDTO = exports.CanSetPasswordResponseDTO = exports.CanSetPasswordDTO = exports.UnlinkSocialAccountResponseDTO = exports.UnlinkSocialAccountDTO = exports.GetLinkedAccountsResponseDTO = exports.GetLinkedAccountsDTO = exports.LinkSocialAccountResponseDTO = exports.LinkSocialAccountDTO = exports.HandleSocialCallbackDTO = exports.GetSocialAuthUrlResponseDTO = exports.GetSocialAuthUrlDTO = void 0;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
+/**
+ * DTO for getting social authentication URL
+ *
+ * Security:
+ * - Provider name validated as string
+ * - State parameter validated for length (CSRF protection)
+ */
 class GetSocialAuthUrlDTO {
+    /**
+     * Social provider name (e.g., 'google', 'apple', 'facebook')
+     *
+     * Validation:
+     * - Must be non-empty string
+     * - Max 50 characters
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     */
     provider;
+    /**
+     * Optional CSRF state parameter
+     *
+     * Validation:
+     * - Max 500 characters (typical state token length)
+     * - Optional field
+     *
+     * Sanitization:
+     * - Trimmed
+     */
     state;
 }
 exports.GetSocialAuthUrlDTO = GetSocialAuthUrlDTO;
@@ -40,13 +67,57 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], GetSocialAuthUrlDTO.prototype, "state", void 0);
+/**
+ * Response DTO for getSocialAuthUrl
+ */
 class GetSocialAuthUrlResponseDTO {
+    /**
+     * OAuth authorization URL
+     */
     url;
 }
 exports.GetSocialAuthUrlResponseDTO = GetSocialAuthUrlResponseDTO;
+/**
+ * DTO for handling social authentication callback
+ *
+ * Security:
+ * - Provider name validated
+ * - Code validated for length
+ * - State validated for CSRF protection
+ */
 class HandleSocialCallbackDTO {
+    /**
+     * Social provider name (e.g., 'google', 'apple', 'facebook')
+     *
+     * Validation:
+     * - Must be non-empty string
+     * - Max 50 characters
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     */
     provider;
+    /**
+     * Authorization code from OAuth callback
+     *
+     * Validation:
+     * - Must be non-empty string
+     * - Max 1000 characters (OAuth codes can be long)
+     *
+     * Sanitization:
+     * - Trimmed
+     */
     code;
+    /**
+     * State parameter from OAuth callback (for CSRF validation)
+     *
+     * Validation:
+     * - Must be non-empty string
+     * - Max 500 characters
+     *
+     * Sanitization:
+     * - Trimmed
+     */
     state;
 }
 exports.HandleSocialCallbackDTO = HandleSocialCallbackDTO;
@@ -83,10 +154,57 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], HandleSocialCallbackDTO.prototype, "state", void 0);
+/**
+ * DTO for linking social account
+ *
+ * Security:
+ * - User ID validated as UUID v4
+ * - Provider name validated
+ * - Code and state validated for length
+ */
 class LinkSocialAccountDTO {
+    /**
+     * User identifier (UUID v4)
+     *
+     * Validation:
+     * - Must be valid UUID v4 format
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     */
     userId;
+    /**
+     * Social provider name (e.g., 'google', 'apple', 'facebook')
+     *
+     * Validation:
+     * - Must be non-empty string
+     * - Max 50 characters
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     */
     provider;
+    /**
+     * Authorization code from OAuth callback
+     *
+     * Validation:
+     * - Must be non-empty string
+     * - Max 1000 characters
+     *
+     * Sanitization:
+     * - Trimmed
+     */
     code;
+    /**
+     * State parameter from OAuth callback (for CSRF validation)
+     *
+     * Validation:
+     * - Must be non-empty string
+     * - Max 500 characters
+     *
+     * Sanitization:
+     * - Trimmed
+     */
     state;
 }
 exports.LinkSocialAccountDTO = LinkSocialAccountDTO;
@@ -133,12 +251,36 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], LinkSocialAccountDTO.prototype, "state", void 0);
+/**
+ * Response DTO for linkSocialAccount
+ */
 class LinkSocialAccountResponseDTO {
+    /**
+     * Success message
+     */
     message;
+    /**
+     * Provider name
+     */
     provider;
 }
 exports.LinkSocialAccountResponseDTO = LinkSocialAccountResponseDTO;
+/**
+ * DTO for getting linked social accounts
+ *
+ * Security:
+ * - User ID validated as UUID v4
+ */
 class GetLinkedAccountsDTO {
+    /**
+     * User identifier (UUID v4)
+     *
+     * Validation:
+     * - Must be valid UUID v4 format
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     */
     userId;
 }
 exports.GetLinkedAccountsDTO = GetLinkedAccountsDTO;
@@ -152,12 +294,44 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], GetLinkedAccountsDTO.prototype, "userId", void 0);
+/**
+ * Response DTO for getLinkedAccounts
+ */
 class GetLinkedAccountsResponseDTO {
+    /**
+     * Array of linked social accounts
+     */
     accounts;
 }
 exports.GetLinkedAccountsResponseDTO = GetLinkedAccountsResponseDTO;
+/**
+ * DTO for unlinking social account
+ *
+ * Security:
+ * - User ID validated as UUID v4
+ * - Provider name validated
+ */
 class UnlinkSocialAccountDTO {
+    /**
+     * User identifier (UUID v4)
+     *
+     * Validation:
+     * - Must be valid UUID v4 format
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     */
     userId;
+    /**
+     * Social provider name (e.g., 'google', 'apple', 'facebook')
+     *
+     * Validation:
+     * - Must be non-empty string
+     * - Max 50 characters
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     */
     provider;
 }
 exports.UnlinkSocialAccountDTO = UnlinkSocialAccountDTO;
@@ -182,11 +356,32 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], UnlinkSocialAccountDTO.prototype, "provider", void 0);
+/**
+ * Response DTO for unlinkSocialAccount
+ */
 class UnlinkSocialAccountResponseDTO {
+    /**
+     * Success message
+     */
     message;
 }
 exports.UnlinkSocialAccountResponseDTO = UnlinkSocialAccountResponseDTO;
+/**
+ * DTO for checking if user can set password
+ *
+ * Security:
+ * - User ID validated as UUID v4
+ */
 class CanSetPasswordDTO {
+    /**
+     * User identifier (UUID v4)
+     *
+     * Validation:
+     * - Must be valid UUID v4 format
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     */
     userId;
 }
 exports.CanSetPasswordDTO = CanSetPasswordDTO;
@@ -200,12 +395,45 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], CanSetPasswordDTO.prototype, "userId", void 0);
+/**
+ * Response DTO for canSetPassword
+ */
 class CanSetPasswordResponseDTO {
+    /**
+     * Whether user can set password
+     */
     canSetPassword;
 }
 exports.CanSetPasswordResponseDTO = CanSetPasswordResponseDTO;
+/**
+ * DTO for setting password for social-only user
+ *
+ * Security:
+ * - User ID validated as UUID v4
+ * - Password validated for strength (delegated to AuthService)
+ */
 class SetPasswordForSocialUserDTO {
+    /**
+     * User identifier (UUID v4)
+     *
+     * Validation:
+     * - Must be valid UUID v4 format
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     */
     userId;
+    /**
+     * New password
+     *
+     * Validation:
+     * - Must be non-empty string
+     * - Min 1 character (actual validation in AuthService)
+     * - Max 128 characters (matches DB constraint)
+     *
+     * Sanitization:
+     * - Not trimmed (passwords may have leading/trailing spaces intentionally)
+     */
     password;
 }
 exports.SetPasswordForSocialUserDTO = SetPasswordForSocialUserDTO;
@@ -225,7 +453,13 @@ __decorate([
     (0, class_validator_1.MaxLength)(128, { message: 'Password must not exceed 128 characters' }),
     __metadata("design:type", String)
 ], SetPasswordForSocialUserDTO.prototype, "password", void 0);
+/**
+ * Response DTO for setPasswordForSocialUser
+ */
 class SetPasswordForSocialUserResponseDTO {
+    /**
+     * Success message
+     */
     message;
 }
 exports.SetPasswordForSocialUserResponseDTO = SetPasswordForSocialUserResponseDTO;

package/dist/dto/social-auth.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"social-auth.dto.js","sourceRoot":"","sources":["../../src/dto/social-auth.dto.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"social-auth.dto.js","sourceRoot":"","sources":["../../src/dto/social-auth.dto.ts"],"names":[],"mappings":"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"}

package/dist/dto/trust-device-response.dto.d.ts

@@ -1,4 +1,30 @@
+/**
+ * Trust Device Response DTO
+ *
+ * Response DTO for trusting a device.
+ * No validators needed - this is generated internally by the library.
+ *
+ * Security:
+ * - Device token should be stored securely on client
+ * - Used for MFA bypass on trusted devices
+ *
+ * @example
+ * ```typescript
+ * const result = await authService.trustDevice();
+ * // Returns: { deviceToken: 'device-token-string' }
+ * ```
+ */
+/**
+ * Response DTO for trust device
+ */
 export declare class TrustDeviceResponseDTO {
+    /**
+     * Device trust token
+     *
+     * Note: Store this token securely on the client device
+     *
+     * @example "device-token-uuid-string"
+     */
     deviceToken: string;
 }
 //# sourceMappingURL=trust-device-response.dto.d.ts.map

package/dist/dto/trust-device-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trust-device-response.dto.d.ts","sourceRoot":"","sources":["../../src/dto/trust-device-response.dto.ts"],"names":[],"mappings":"AAoBA,qBAAa,sBAAsB;IAQjC,WAAW,EAAG,MAAM,CAAC;CACtB"}
+{"version":3,"file":"trust-device-response.dto.d.ts","sourceRoot":"","sources":["../../src/dto/trust-device-response.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;;;;;OAMG;IACH,WAAW,EAAG,MAAM,CAAC;CACtB"}

package/dist/dto/trust-device-response.dto.js

@@ -1,7 +1,33 @@
 "use strict";
+/**
+ * Trust Device Response DTO
+ *
+ * Response DTO for trusting a device.
+ * No validators needed - this is generated internally by the library.
+ *
+ * Security:
+ * - Device token should be stored securely on client
+ * - Used for MFA bypass on trusted devices
+ *
+ * @example
+ * ```typescript
+ * const result = await authService.trustDevice();
+ * // Returns: { deviceToken: 'device-token-string' }
+ * ```
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TrustDeviceResponseDTO = void 0;
+/**
+ * Response DTO for trust device
+ */
 class TrustDeviceResponseDTO {
+    /**
+     * Device trust token
+     *
+     * Note: Store this token securely on the client device
+     *
+     * @example "device-token-uuid-string"
+     */
     deviceToken;
 }
 exports.TrustDeviceResponseDTO = TrustDeviceResponseDTO;

package/dist/dto/trust-device-response.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"trust-device-response.dto.js","sourceRoot":"","sources":["../../src/dto/trust-device-response.dto.ts"],"names":[],"mappings":";;;AAoBA,MAAa,sBAAsB;IAQjC,WAAW,CAAU;CACtB;AATD,wDASC"}
+{"version":3,"file":"trust-device-response.dto.js","sourceRoot":"","sources":["../../src/dto/trust-device-response.dto.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;AAEH;;GAEG;AACH,MAAa,sBAAsB;IACjC;;;;;;OAMG;IACH,WAAW,CAAU;CACtB;AATD,wDASC"}

package/dist/dto/trust-device.dto.d.ts

@@ -1 +1,10 @@
+/**
+ * Trust Device DTO
+ *
+ * Note: No request DTO needed - sessionId is automatically extracted from JWT token context
+ * via ClientInfoService, similar to how IP address and user agent are handled.
+ *
+ * This file is kept for backward compatibility but TrustDeviceDTO is no longer used.
+ * The trustDevice() method now takes no parameters.
+ */
 //# sourceMappingURL=trust-device.dto.d.ts.map

package/dist/dto/trust-device.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trust-device.dto.d.ts","sourceRoot":"","sources":["../../src/dto/trust-device.dto.ts"],"names":[],"mappings":""}
+{"version":3,"file":"trust-device.dto.d.ts","sourceRoot":"","sources":["../../src/dto/trust-device.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/dto/trust-device.dto.js

@@ -1,2 +1,11 @@
 "use strict";
+/**
+ * Trust Device DTO
+ *
+ * Note: No request DTO needed - sessionId is automatically extracted from JWT token context
+ * via ClientInfoService, similar to how IP address and user agent are handled.
+ *
+ * This file is kept for backward compatibility but TrustDeviceDTO is no longer used.
+ * The trustDevice() method now takes no parameters.
+ */
 //# sourceMappingURL=trust-device.dto.js.map

package/dist/dto/trust-device.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"trust-device.dto.js","sourceRoot":"","sources":["../../src/dto/trust-device.dto.ts"],"names":[],"mappings":""}
+{"version":3,"file":"trust-device.dto.js","sourceRoot":"","sources":["../../src/dto/trust-device.dto.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG"}

package/dist/dto/update-user-attributes-request.dto.d.ts

@@ -1,5 +1,41 @@
+/**
+ * Update User Attributes Request DTO
+ *
+ * Request DTO for updating user profile information (includes user sub).
+ *
+ * Security:
+ * - User sub validated (UUID)
+ * - All fields validated according to UserUpdateDTO rules
+ * - Uniqueness constraints enforced
+ *
+ * @example
+ * ```typescript
+ * const result = await authService.updateUserAttributes({
+ *   sub: 'user-uuid',
+ *   username: 'newusername',
+ *   firstName: 'John',
+ *   lastName: 'Doe'
+ * });
+ * ```
+ */
 import { UserUpdateDTO } from './user-update.dto';
+/**
+ * Request DTO for updating user attributes (includes user sub)
+ */
 export declare class UpdateUserAttributesRequestDTO extends UserUpdateDTO {
+    /**
+     * User's unique identifier (UUID v4)
+     *
+     * Validation:
+     * - Must be a valid UUID v4 format
+     * - Matches DB constraint: char(36) or uuid
+     *
+     * Sanitization:
+     * - Trimmed
+     * - Lowercased for consistency
+     *
+     * @example "a21b654c-2746-4168-acee-c175083a65cd"
+     */
     sub: string;
 }
 //# sourceMappingURL=update-user-attributes-request.dto.d.ts.map

package/dist/dto/update-user-attributes-request.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-user-attributes-request.dto.d.ts","sourceRoot":"","sources":["../../src/dto/update-user-attributes-request.dto.ts"],"names":[],"mappings":"AAuBA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAKlD,qBAAa,8BAA+B,SAAQ,aAAa;IAqB/D,GAAG,EAAG,MAAM,CAAC;CACd"}
+{"version":3,"file":"update-user-attributes-request.dto.d.ts","sourceRoot":"","sources":["../../src/dto/update-user-attributes-request.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD;;GAEG;AACH,qBAAa,8BAA+B,SAAQ,aAAa;IAC/D;;;;;;;;;;;;OAYG;IAQH,GAAG,EAAG,MAAM,CAAC;CACd"}

package/dist/dto/update-user-attributes-request.dto.js

@@ -1,4 +1,24 @@
 "use strict";
+/**
+ * Update User Attributes Request DTO
+ *
+ * Request DTO for updating user profile information (includes user sub).
+ *
+ * Security:
+ * - User sub validated (UUID)
+ * - All fields validated according to UserUpdateDTO rules
+ * - Uniqueness constraints enforced
+ *
+ * @example
+ * ```typescript
+ * const result = await authService.updateUserAttributes({
+ *   sub: 'user-uuid',
+ *   username: 'newusername',
+ *   firstName: 'John',
+ *   lastName: 'Doe'
+ * });
+ * ```
+ */
 var __decorate = (this && this.__decorate) || function (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);
@@ -13,7 +33,23 @@ exports.UpdateUserAttributesRequestDTO = void 0;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
 const user_update_dto_1 = require("./user-update.dto");
+/**
+ * Request DTO for updating user attributes (includes user sub)
+ */
 class UpdateUserAttributesRequestDTO extends user_update_dto_1.UserUpdateDTO {
+    /**
+     * User's unique identifier (UUID v4)
+     *
+     * Validation:
+     * - Must be a valid UUID v4 format
+     * - Matches DB constraint: char(36) or uuid
+     *
+     * Sanitization:
+     * - Trimmed
+     * - Lowercased for consistency
+     *
+     * @example "a21b654c-2746-4168-acee-c175083a65cd"
+     */
     sub;
 }
 exports.UpdateUserAttributesRequestDTO = UpdateUserAttributesRequestDTO;

package/dist/dto/update-user-attributes-request.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-user-attributes-request.dto.js","sourceRoot":"","sources":["../../src/dto/update-user-attributes-request.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAqBA,qDAAyC;AACzC,yDAA8C;AAC9C,uDAAkD;AAKlD,MAAa,8BAA+B,SAAQ,+BAAa;IAqB/D,GAAG,CAAU;CACd;AAtBD,wEAsBC;AADC;IAPC,IAAA,wBAAM,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;IACnE,IAAA,6BAAS,EAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;;2DACW"}
+{"version":3,"file":"update-user-attributes-request.dto.js","sourceRoot":"","sources":["../../src/dto/update-user-attributes-request.dto.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;;;;;;;;;;AAEH,qDAAyC;AACzC,yDAA8C;AAC9C,uDAAkD;AAElD;;GAEG;AACH,MAAa,8BAA+B,SAAQ,+BAAa;IAC/D;;;;;;;;;;;;OAYG;IAQH,GAAG,CAAU;CACd;AAtBD,wEAsBC;AADC;IAPC,IAAA,wBAAM,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;IACnE,IAAA,6BAAS,EAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE;QACvB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;;2DACW"}

package/dist/dto/user-response.dto.d.ts

@@ -1,20 +1,101 @@
 import { IUser } from '../interfaces/entities.interface';
+/**
+ * User Response DTO
+ *
+ * Sanitized user object for API responses.
+ * Excludes all sensitive and internal fields.
+ *
+ * Security:
+ * - Never exposes password hash
+ * - Never exposes MFA secrets
+ * - Never exposes internal tracking fields
+ * - Exposes 'sub' (external UUID) instead of internal 'id'
+ *
+ * No validators needed - this is generated internally by the library via fromEntity().
+ *
+ * @example
+ * ```typescript
+ * const user = await userRepository.findOne({ where: { sub } });
+ * return UserResponseDto.fromEntity(user);
+ * ```
+ */
 export declare class UserResponseDto {
+    /**
+     * External user identifier (UUID v4)
+     * This is the 'sub' (subject) field from JWT tokens
+     */
     sub: string;
+    /**
+     * User's email address
+     */
     email: string;
+    /**
+     * User's username (optional)
+     */
     username?: string | null;
+    /**
+     * User's first name (optional)
+     */
     firstName?: string | null;
+    /**
+     * User's last name (optional)
+     */
     lastName?: string | null;
+    /**
+     * User's phone number (optional)
+     * E.164 format validated in service layer if present
+     */
     phone?: string | null;
+    /**
+     * Email verification status
+     */
     isEmailVerified: boolean;
+    /**
+     * Phone verification status
+     */
     isPhoneVerified: boolean;
+    /**
+     * Account active status
+     */
     isActive: boolean;
+    /**
+     * MFA enabled status
+     */
     mfaEnabled: boolean;
+    /**
+     * Array of social providers linked to this account
+     *
+     * Examples: ['google', 'apple', 'facebook']
+     * null/undefined means no social auth, only password-based
+     */
     socialProviders?: string[] | null;
+    /**
+     * Whether this user has a password set
+     * Used to determine if user can use password-based authentication
+     * or is a pure social signup (no password, only social auth)
+     */
     hasPasswordHash: boolean;
+    /**
+     * Account creation timestamp
+     */
     createdAt: Date;
+    /**
+     * Last account update timestamp
+     */
     updatedAt: Date;
+    /**
+     * Convert User entity to safe response DTO
+     *
+     * @param user - User entity from database
+     * @returns Sanitized user object with external identifier (sub)
+     */
     static fromEntity(user: IUser): UserResponseDto;
+    /**
+     * Convert array of User entities to safe response DTOs
+     *
+     * @param users - Array of User entities
+     * @returns Array of sanitized user objects
+     */
     static fromEntities(users: IUser[]): UserResponseDto[];
 }
 //# sourceMappingURL=user-response.dto.d.ts.map

package/dist/dto/user-response.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"user-response.dto.d.ts","sourceRoot":"","sources":["../../src/dto/user-response.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAsBzD,qBAAa,eAAe;IAK1B,GAAG,EAAG,MAAM,CAAC;IAKb,KAAK,EAAG,MAAM,CAAC;IAKf,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAKzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAK1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAMzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAKtB,eAAe,EAAG,OAAO,CAAC;IAK1B,eAAe,EAAG,OAAO,CAAC;IAK1B,QAAQ,EAAG,OAAO,CAAC;IAKnB,UAAU,EAAG,OAAO,CAAC;IAQrB,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAOlC,eAAe,EAAG,OAAO,CAAC;IAK1B,SAAS,EAAG,IAAI,CAAC;IAKjB,SAAS,EAAG,IAAI,CAAC;IAQjB,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,eAAe;IA4B/C,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,eAAe,EAAE;CAGvD"}
+{"version":3,"file":"user-response.dto.d.ts","sourceRoot":"","sources":["../../src/dto/user-response.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,eAAe;IAC1B;;;OAGG;IACH,GAAG,EAAG,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAG,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtB;;OAEG;IACH,eAAe,EAAG,OAAO,CAAC;IAE1B;;OAEG;IACH,eAAe,EAAG,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAG,OAAO,CAAC;IAEnB;;OAEG;IACH,UAAU,EAAG,OAAO,CAAC;IAErB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAElC;;;;OAIG;IACH,eAAe,EAAG,OAAO,CAAC;IAE1B;;OAEG;IACH,SAAS,EAAG,IAAI,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAG,IAAI,CAAC;IAEjB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,eAAe;IAsB/C;;;;;OAKG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,eAAe,EAAE;CAGvD"}