@nauth-toolkit/core 0.1.13 → 0.1.17

package/dist/dto/get-suspicious-activity.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-suspicious-activity.dto.js","sourceRoot":"","sources":["../../src/dto/get-suspicious-activity.dto.ts"],"names":[],"mappings":";;;AAiBA,MAAa,wBAAwB;IAMnC,OAAO,CAAU;IAOjB,KAAK,CAAU;CAChB;AAdD,4DAcC;AAKD,MAAa,gCAAgC;IAI3C,IAAI,CAAgB;CACrB;AALD,4EAKC"}
+{"version":3,"file":"get-suspicious-activity.dto.js","sourceRoot":"","sources":["../../src/dto/get-suspicious-activity.dto.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;;;GAcG;AACH,MAAa,wBAAwB;IACnC;;;;OAIG;IACH,OAAO,CAAU;IAEjB;;;;OAIG;IACH,KAAK,CAAU;CAChB;AAdD,4DAcC;AAED;;GAEG;AACH,MAAa,gCAAgC;IAC3C;;OAEG;IACH,IAAI,CAAgB;CACrB;AALD,4EAKC"}

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

@@ -1,4 +1,23 @@
+/**
+ * Response DTO for getting user agent
+ *
+ * Used to return just the user agent string from the current request context.
+ *
+ * @example
+ * ```typescript
+ * const result = await clientInfoService.getUserAgent();
+ * // Returns: { userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)...' }
+ * ```
+ */
+/**
+ * Response DTO for user agent
+ */
 export declare class GetUserAgentResponseDTO {
+    /**
+     * User agent string from the request
+     *
+     * Returns 'unknown' if called outside request context.
+     */
     userAgent: string;
 }
 //# sourceMappingURL=get-user-agent-response.dto.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-user-agent-response.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-agent-response.dto.ts"],"names":[],"mappings":"AAeA,qBAAa,uBAAuB;IAMlC,SAAS,EAAG,MAAM,CAAC;CACpB"}
+{"version":3,"file":"get-user-agent-response.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-agent-response.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;GAEG;AACH,qBAAa,uBAAuB;IAClC;;;;OAIG;IACH,SAAS,EAAG,MAAM,CAAC;CACpB"}

package/dist/dto/get-user-agent-response.dto.js

@@ -1,7 +1,26 @@
 "use strict";
+/**
+ * Response DTO for getting user agent
+ *
+ * Used to return just the user agent string from the current request context.
+ *
+ * @example
+ * ```typescript
+ * const result = await clientInfoService.getUserAgent();
+ * // Returns: { userAgent: 'Mozilla/5.0 (Windows NT 10.0; Win64; x64)...' }
+ * ```
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetUserAgentResponseDTO = void 0;
+/**
+ * Response DTO for user agent
+ */
 class GetUserAgentResponseDTO {
+    /**
+     * User agent string from the request
+     *
+     * Returns 'unknown' if called outside request context.
+     */
     userAgent;
 }
 exports.GetUserAgentResponseDTO = GetUserAgentResponseDTO;

package/dist/dto/get-user-agent-response.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-agent-response.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-agent-response.dto.ts"],"names":[],"mappings":";;;AAeA,MAAa,uBAAuB;IAMlC,SAAS,CAAU;CACpB;AAPD,0DAOC"}
+{"version":3,"file":"get-user-agent-response.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-agent-response.dto.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH;;GAEG;AACH,MAAa,uBAAuB;IAClC;;;;OAIG;IACH,SAAS,CAAU;CACpB;AAPD,0DAOC"}

package/dist/dto/get-user-auth-history.dto.d.ts

@@ -1,20 +1,84 @@
 import { AuthAuditEventType } from '../enums/auth-audit-event-type.enum';
 import { AuthAuditEventStatus } from '../entities/auth-audit.entity';
 import { IAuthAudit } from '../interfaces/entities.interface';
+/**
+ * Request DTO for getting user authentication history
+ *
+ * @example
+ * ```typescript
+ * const result = await auditService.getUserAuthHistory({
+ *   userSub: 'user-uuid',
+ *   page: 1,
+ *   limit: 50,
+ *   eventTypes: [AuthAuditEventType.LOGIN_SUCCESS],
+ *   startDate: new Date('2025-01-01'),
+ * });
+ * ```
+ */
 export declare class GetUserAuthHistoryDTO {
+    /**
+     * External user identifier (UUID)
+     *
+     * The service will automatically resolve this to the internal userId
+     * for efficient database queries.
+     */
     userSub: string;
+    /**
+     * Page number (1-indexed)
+     *
+     * @default 1
+     */
     page?: number;
+    /**
+     * Number of records per page
+     *
+     * @default 50
+     */
     limit?: number;
+    /**
+     * Filter events from this date onwards
+     */
     startDate?: Date;
+    /**
+     * Filter events up to this date
+     */
     endDate?: Date;
+    /**
+     * Filter by specific event types
+     *
+     * If provided, only events matching these types will be returned.
+     */
     eventTypes?: AuthAuditEventType[];
+    /**
+     * Filter by event status
+     *
+     * If provided, only events matching these statuses will be returned.
+     */
     eventStatus?: AuthAuditEventStatus[];
 }
+/**
+ * Response DTO for paginated user authentication history
+ */
 export declare class GetUserAuthHistoryResponseDTO {
+    /**
+     * Array of audit records
+     */
     data: IAuthAudit[];
+    /**
+     * Total number of records matching the query
+     */
     total: number;
+    /**
+     * Current page number
+     */
     page: number;
+    /**
+     * Number of records per page
+     */
     limit: number;
+    /**
+     * Total number of pages
+     */
     totalPages: number;
 }
 //# sourceMappingURL=get-user-auth-history.dto.d.ts.map

package/dist/dto/get-user-auth-history.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-auth-history.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-auth-history.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAgB9D,qBAAa,qBAAqB;IAOhC,OAAO,EAAG,MAAM,CAAC;IAOjB,IAAI,CAAC,EAAE,MAAM,CAAC;IAOd,KAAK,CAAC,EAAE,MAAM,CAAC;IAKf,SAAS,CAAC,EAAE,IAAI,CAAC;IAKjB,OAAO,CAAC,EAAE,IAAI,CAAC;IAOf,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAOlC,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACtC;AAKD,qBAAa,6BAA6B;IAIxC,IAAI,EAAG,UAAU,EAAE,CAAC;IAKpB,KAAK,EAAG,MAAM,CAAC;IAKf,IAAI,EAAG,MAAM,CAAC;IAKd,KAAK,EAAG,MAAM,CAAC;IAKf,UAAU,EAAG,MAAM,CAAC;CACrB"}
+{"version":3,"file":"get-user-auth-history.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-auth-history.dto.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAqB;IAChC;;;;;OAKG;IACH,OAAO,EAAG,MAAM,CAAC;IAEjB;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;IAEf;;;;OAIG;IACH,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAElC;;;;OAIG;IACH,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;CACtC;AAED;;GAEG;AACH,qBAAa,6BAA6B;IACxC;;OAEG;IACH,IAAI,EAAG,UAAU,EAAE,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAG,MAAM,CAAC;IAEf;;OAEG;IACH,IAAI,EAAG,MAAM,CAAC;IAEd;;OAEG;IACH,KAAK,EAAG,MAAM,CAAC;IAEf;;OAEG;IACH,UAAU,EAAG,MAAM,CAAC;CACrB"}

package/dist/dto/get-user-auth-history.dto.js

@@ -1,21 +1,85 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetUserAuthHistoryResponseDTO = exports.GetUserAuthHistoryDTO = void 0;
+/**
+ * Request DTO for getting user authentication history
+ *
+ * @example
+ * ```typescript
+ * const result = await auditService.getUserAuthHistory({
+ *   userSub: 'user-uuid',
+ *   page: 1,
+ *   limit: 50,
+ *   eventTypes: [AuthAuditEventType.LOGIN_SUCCESS],
+ *   startDate: new Date('2025-01-01'),
+ * });
+ * ```
+ */
 class GetUserAuthHistoryDTO {
+    /**
+     * External user identifier (UUID)
+     *
+     * The service will automatically resolve this to the internal userId
+     * for efficient database queries.
+     */
     userSub;
+    /**
+     * Page number (1-indexed)
+     *
+     * @default 1
+     */
     page;
+    /**
+     * Number of records per page
+     *
+     * @default 50
+     */
     limit;
+    /**
+     * Filter events from this date onwards
+     */
     startDate;
+    /**
+     * Filter events up to this date
+     */
     endDate;
+    /**
+     * Filter by specific event types
+     *
+     * If provided, only events matching these types will be returned.
+     */
     eventTypes;
+    /**
+     * Filter by event status
+     *
+     * If provided, only events matching these statuses will be returned.
+     */
     eventStatus;
 }
 exports.GetUserAuthHistoryDTO = GetUserAuthHistoryDTO;
+/**
+ * Response DTO for paginated user authentication history
+ */
 class GetUserAuthHistoryResponseDTO {
+    /**
+     * Array of audit records
+     */
     data;
+    /**
+     * Total number of records matching the query
+     */
     total;
+    /**
+     * Current page number
+     */
     page;
+    /**
+     * Number of records per page
+     */
     limit;
+    /**
+     * Total number of pages
+     */
     totalPages;
 }
 exports.GetUserAuthHistoryResponseDTO = GetUserAuthHistoryResponseDTO;

package/dist/dto/get-user-auth-history.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-auth-history.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-auth-history.dto.ts"],"names":[],"mappings":";;;AAkBA,MAAa,qBAAqB;IAOhC,OAAO,CAAU;IAOjB,IAAI,CAAU;IAOd,KAAK,CAAU;IAKf,SAAS,CAAQ;IAKjB,OAAO,CAAQ;IAOf,UAAU,CAAwB;IAOlC,WAAW,CAA0B;CACtC;AA9CD,sDA8CC;AAKD,MAAa,6BAA6B;IAIxC,IAAI,CAAgB;IAKpB,KAAK,CAAU;IAKf,IAAI,CAAU;IAKd,KAAK,CAAU;IAKf,UAAU,CAAU;CACrB;AAzBD,sEAyBC"}
+{"version":3,"file":"get-user-auth-history.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-auth-history.dto.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;GAaG;AACH,MAAa,qBAAqB;IAChC;;;;;OAKG;IACH,OAAO,CAAU;IAEjB;;;;OAIG;IACH,IAAI,CAAU;IAEd;;;;OAIG;IACH,KAAK,CAAU;IAEf;;OAEG;IACH,SAAS,CAAQ;IAEjB;;OAEG;IACH,OAAO,CAAQ;IAEf;;;;OAIG;IACH,UAAU,CAAwB;IAElC;;;;OAIG;IACH,WAAW,CAA0B;CACtC;AA9CD,sDA8CC;AAED;;GAEG;AACH,MAAa,6BAA6B;IACxC;;OAEG;IACH,IAAI,CAAgB;IAEpB;;OAEG;IACH,KAAK,CAAU;IAEf;;OAEG;IACH,IAAI,CAAU;IAEd;;OAEG;IACH,KAAK,CAAU;IAEf;;OAEG;IACH,UAAU,CAAU;CACrB;AAzBD,sEAyBC"}

package/dist/dto/get-user-by-email.dto.d.ts

@@ -1,5 +1,47 @@
+/**
+ * Get User By Email DTO
+ *
+ * Request DTO for retrieving a user by email address.
+ *
+ * Security:
+ * - Email format validated
+ * - Max length enforced
+ *
+ * @example
+ * ```typescript
+ * const user = await authService.getUserByEmail({
+ *   email: 'user@example.com',
+ *   requireEmailVerified: true
+ * });
+ * ```
+ */
+/**
+ * Request DTO for getting user by email
+ */
 export declare class GetUserByEmailDTO {
+    /**
+     * Email address to search for
+     *
+     * Validation:
+     * - Must be a valid email format
+     * - Max 255 characters (matches DB constraint)
+     *
+     * Sanitization:
+     * - Trimmed
+     * - Lowercased for consistency
+     *
+     * @example "user@example.com"
+     */
     email: string;
+    /**
+     * Only return user if email is verified
+     *
+     * Validation:
+     * - Must be a boolean if present
+     * - Default: false
+     *
+     * @example true
+     */
     requireEmailVerified?: boolean;
 }
 //# sourceMappingURL=get-user-by-email.dto.d.ts.map

package/dist/dto/get-user-by-email.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-by-email.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-by-email.dto.ts"],"names":[],"mappings":"AAwBA,qBAAa,iBAAiB;IAsB5B,KAAK,EAAG,MAAM,CAAC;IAaf,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC"}
+{"version":3,"file":"get-user-by-email.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-by-email.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;;;;;OAYG;IASH,KAAK,EAAG,MAAM,CAAC;IAEf;;;;;;;;OAQG;IAGH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC"}

package/dist/dto/get-user-by-email.dto.js

@@ -1,4 +1,21 @@
 "use strict";
+/**
+ * Get User By Email DTO
+ *
+ * Request DTO for retrieving a user by email address.
+ *
+ * Security:
+ * - Email format validated
+ * - Max length enforced
+ *
+ * @example
+ * ```typescript
+ * const user = await authService.getUserByEmail({
+ *   email: 'user@example.com',
+ *   requireEmailVerified: true
+ * });
+ * ```
+ */
 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);
@@ -12,8 +29,33 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetUserByEmailDTO = void 0;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
+/**
+ * Request DTO for getting user by email
+ */
 class GetUserByEmailDTO {
+    /**
+     * Email address to search for
+     *
+     * Validation:
+     * - Must be a valid email format
+     * - Max 255 characters (matches DB constraint)
+     *
+     * Sanitization:
+     * - Trimmed
+     * - Lowercased for consistency
+     *
+     * @example "user@example.com"
+     */
     email;
+    /**
+     * Only return user if email is verified
+     *
+     * Validation:
+     * - Must be a boolean if present
+     * - Default: false
+     *
+     * @example true
+     */
     requireEmailVerified;
 }
 exports.GetUserByEmailDTO = GetUserByEmailDTO;

package/dist/dto/get-user-by-email.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-by-email.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-by-email.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAkBA,qDAA4E;AAC5E,yDAA8C;AAK9C,MAAa,iBAAiB;IAsB5B,KAAK,CAAU;IAaf,oBAAoB,CAAW;CAChC;AApCD,8CAoCC;AAdC;IARC,IAAA,yBAAO,EAAC,EAAE,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;IAC9D,IAAA,2BAAS,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,sCAAsC,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;;gDACa;AAaf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;;+DAClC"}
+{"version":3,"file":"get-user-by-email.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-by-email.dto.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;GAgBG;;;;;;;;;;;;AAEH,qDAA4E;AAC5E,yDAA8C;AAE9C;;GAEG;AACH,MAAa,iBAAiB;IAC5B;;;;;;;;;;;;OAYG;IASH,KAAK,CAAU;IAEf;;;;;;;;OAQG;IAGH,oBAAoB,CAAW;CAChC;AApCD,8CAoCC;AAdC;IARC,IAAA,yBAAO,EAAC,EAAE,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC;IAC9D,IAAA,2BAAS,EAAC,GAAG,EAAE,EAAE,OAAO,EAAE,sCAAsC,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;;gDACa;AAaf;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,2BAAS,EAAC,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;;+DAClC"}

package/dist/dto/get-user-by-id.dto.d.ts

@@ -1,4 +1,36 @@
+/**
+ * Get User By ID DTO
+ *
+ * Request DTO for retrieving a user by their unique identifier (sub).
+ *
+ * Security:
+ * - UUID format validated
+ * - Prevents injection attacks
+ *
+ * @example
+ * ```typescript
+ * const user = await authService.getUserById({
+ *   sub: 'a21b654c-2746-4168-acee-c175083a65cd'
+ * });
+ * ```
+ */
+/**
+ * Request DTO for getting user by ID
+ */
 export declare class GetUserByIdDTO {
+    /**
+     * 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=get-user-by-id.dto.d.ts.map

package/dist/dto/get-user-by-id.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-by-id.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-by-id.dto.ts"],"names":[],"mappings":"AAuBA,qBAAa,cAAc;IAqBzB,GAAG,EAAG,MAAM,CAAC;CACd"}
+{"version":3,"file":"get-user-by-id.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-by-id.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAKH;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;;;;;;;;;OAYG;IAQH,GAAG,EAAG,MAAM,CAAC;CACd"}

package/dist/dto/get-user-by-id.dto.js

@@ -1,4 +1,20 @@
 "use strict";
+/**
+ * Get User By ID DTO
+ *
+ * Request DTO for retrieving a user by their unique identifier (sub).
+ *
+ * Security:
+ * - UUID format validated
+ * - Prevents injection attacks
+ *
+ * @example
+ * ```typescript
+ * const user = await authService.getUserById({
+ *   sub: 'a21b654c-2746-4168-acee-c175083a65cd'
+ * });
+ * ```
+ */
 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);
@@ -12,7 +28,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetUserByIdDTO = void 0;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
+/**
+ * Request DTO for getting user by ID
+ */
 class GetUserByIdDTO {
+    /**
+     * 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.GetUserByIdDTO = GetUserByIdDTO;

package/dist/dto/get-user-by-id.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-by-id.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-by-id.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAiBA,qDAAyC;AACzC,yDAA8C;AAK9C,MAAa,cAAc;IAqBzB,GAAG,CAAU;CACd;AAtBD,wCAsBC;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;;2CACW"}
+{"version":3,"file":"get-user-by-id.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-by-id.dto.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;GAeG;;;;;;;;;;;;AAEH,qDAAyC;AACzC,yDAA8C;AAE9C;;GAEG;AACH,MAAa,cAAc;IACzB;;;;;;;;;;;;OAYG;IAQH,GAAG,CAAU;CACd;AAtBD,wCAsBC;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;;2CACW"}

package/dist/dto/get-user-devices.dto.d.ts

@@ -1,8 +1,42 @@
+/**
+ * DTO for getting user MFA devices
+ *
+ * Used to retrieve all MFA devices configured for a user.
+ *
+ * @example
+ * ```typescript
+ * const devices = await mfaService.getUserDevices({
+ *   sub: 'user-uuid'
+ * });
+ * ```
+ */
 import { IMFADevice } from '../interfaces/entities.interface';
+/**
+ * DTO for getting user MFA devices
+ */
 export declare class GetUserDevicesDTO {
+    /**
+     * 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;
 }
+/**
+ * Response DTO for user MFA devices
+ */
 export declare class GetUserDevicesResponseDTO {
+    /**
+     * Array of user's MFA devices
+     */
     devices: IMFADevice[];
 }
 //# sourceMappingURL=get-user-devices.dto.d.ts.map

package/dist/dto/get-user-devices.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-devices.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-devices.dto.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAK9D,qBAAa,iBAAiB;IAqB5B,GAAG,EAAG,MAAM,CAAC;CACd;AAKD,qBAAa,yBAAyB;IAIpC,OAAO,EAAG,UAAU,EAAE,CAAC;CACxB"}
+{"version":3,"file":"get-user-devices.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-devices.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;GAEG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;;;;;;;OAYG;IAQH,GAAG,EAAG,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,yBAAyB;IACpC;;OAEG;IACH,OAAO,EAAG,UAAU,EAAE,CAAC;CACxB"}

package/dist/dto/get-user-devices.dto.js

@@ -1,4 +1,16 @@
 "use strict";
+/**
+ * DTO for getting user MFA devices
+ *
+ * Used to retrieve all MFA devices configured for a user.
+ *
+ * @example
+ * ```typescript
+ * const devices = await mfaService.getUserDevices({
+ *   sub: 'user-uuid'
+ * });
+ * ```
+ */
 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);
@@ -12,7 +24,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetUserDevicesResponseDTO = exports.GetUserDevicesDTO = void 0;
 const class_validator_1 = require("class-validator");
 const class_transformer_1 = require("class-transformer");
+/**
+ * DTO for getting user MFA devices
+ */
 class GetUserDevicesDTO {
+    /**
+     * 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.GetUserDevicesDTO = GetUserDevicesDTO;
@@ -26,7 +54,13 @@ __decorate([
     }),
     __metadata("design:type", String)
 ], GetUserDevicesDTO.prototype, "sub", void 0);
+/**
+ * Response DTO for user MFA devices
+ */
 class GetUserDevicesResponseDTO {
+    /**
+     * Array of user's MFA devices
+     */
     devices;
 }
 exports.GetUserDevicesResponseDTO = GetUserDevicesResponseDTO;

package/dist/dto/get-user-devices.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-devices.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-devices.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAaA,qDAAyC;AACzC,yDAA8C;AAM9C,MAAa,iBAAiB;IAqB5B,GAAG,CAAU;CACd;AAtBD,8CAsBC;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;;8CACW;AAMf,MAAa,yBAAyB;IAIpC,OAAO,CAAgB;CACxB;AALD,8DAKC"}
+{"version":3,"file":"get-user-devices.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-devices.dto.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;AAEH,qDAAyC;AACzC,yDAA8C;AAG9C;;GAEG;AACH,MAAa,iBAAiB;IAC5B;;;;;;;;;;;;OAYG;IAQH,GAAG,CAAU;CACd;AAtBD,8CAsBC;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;;8CACW;AAGf;;GAEG;AACH,MAAa,yBAAyB;IACpC;;OAEG;IACH,OAAO,CAAgB;CACxB;AALD,8DAKC"}

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

@@ -1,2 +1,16 @@
+/**
+ * Get User Response DTO
+ *
+ * Response DTO for user retrieval operations.
+ *
+ * Note: Methods like getUserById and getUserByEmail return UserResponseDto | null directly.
+ * This file exists for type consistency but UserResponseDto is used directly.
+ *
+ * @example
+ * ```typescript
+ * const user = await authService.getUserById({ sub: 'user-uuid' });
+ * // Returns: UserResponseDto | null
+ * ```
+ */
 export { UserResponseDto as GetUserResponseDTO } from './user-response.dto';
 //# sourceMappingURL=get-user-response.dto.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"get-user-response.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-response.dto.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"get-user-response.dto.d.ts","sourceRoot":"","sources":["../../src/dto/get-user-response.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,eAAe,IAAI,kBAAkB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/dto/get-user-response.dto.js

@@ -1,6 +1,21 @@
 "use strict";
+/**
+ * Get User Response DTO
+ *
+ * Response DTO for user retrieval operations.
+ *
+ * Note: Methods like getUserById and getUserByEmail return UserResponseDto | null directly.
+ * This file exists for type consistency but UserResponseDto is used directly.
+ *
+ * @example
+ * ```typescript
+ * const user = await authService.getUserById({ sub: 'user-uuid' });
+ * // Returns: UserResponseDto | null
+ * ```
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GetUserResponseDTO = void 0;
+// Re-export UserResponseDto for consistency
 var user_response_dto_1 = require("./user-response.dto");
 Object.defineProperty(exports, "GetUserResponseDTO", { enumerable: true, get: function () { return user_response_dto_1.UserResponseDto; } });
 //# sourceMappingURL=get-user-response.dto.js.map

package/dist/dto/get-user-response.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-user-response.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-response.dto.ts"],"names":[],"mappings":";;;AAgBA,yDAA4E;AAAnE,uHAAA,eAAe,OAAsB"}
+{"version":3,"file":"get-user-response.dto.js","sourceRoot":"","sources":["../../src/dto/get-user-response.dto.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;GAaG;;;AAEH,4CAA4C;AAC5C,yDAA4E;AAAnE,uHAAA,eAAe,OAAsB"}

package/dist/dto/has-provider.dto.d.ts

@@ -1,7 +1,40 @@
+/**
+ * DTO for checking if MFA provider is registered
+ *
+ * Used to check if a specific MFA provider is registered and available.
+ *
+ * @example
+ * ```typescript
+ * const hasTotp = await mfaService.hasProvider({
+ *   methodName: 'totp'
+ * });
+ * ```
+ */
+/**
+ * DTO for checking if MFA provider is registered
+ */
 export declare class HasProviderDTO {
+    /**
+     * Provider method name
+     *
+     * Validation:
+     * - Must be one of: totp, sms, email, passkey
+     * - Max 50 characters
+     *
+     * Sanitization:
+     * - Trimmed and lowercased
+     *
+     * @example "totp"
+     */
     methodName: string;
 }
+/**
+ * Response DTO for has provider check
+ */
 export declare class HasProviderResponseDTO {
+    /**
+     * Whether provider is registered
+     */
     hasProvider: boolean;
 }
 //# sourceMappingURL=has-provider.dto.d.ts.map

package/dist/dto/has-provider.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"has-provider.dto.d.ts","sourceRoot":"","sources":["../../src/dto/has-provider.dto.ts"],"names":[],"mappings":"AAoBA,qBAAa,cAAc;IAwBzB,UAAU,EAAG,MAAM,CAAC;CACrB;AAKD,qBAAa,sBAAsB;IAIjC,WAAW,EAAG,OAAO,CAAC;CACvB"}
+{"version":3,"file":"has-provider.dto.d.ts","sourceRoot":"","sources":["../../src/dto/has-provider.dto.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;GAEG;AACH,qBAAa,cAAc;IACzB;;;;;;;;;;;OAWG;IAYH,UAAU,EAAG,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC;;OAEG;IACH,WAAW,EAAG,OAAO,CAAC;CACvB"}