@nauth-toolkit/core 0.1.13 → 0.1.17

package/dist/interfaces/template.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"template.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/template.interface.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"template.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/template.interface.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/template.interface.js

@@ -1,6 +1,19 @@
 "use strict";
+/**
+ * Email Template System Interfaces
+ *
+ * Provides flexible template system for email notifications with support for:
+ * - HTML templates with placeholder tokens ({{variable}})
+ * - Built-in and custom variables
+ * - Multiple template types (verification, password reset, etc.)
+ */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TemplateType = void 0;
+/**
+ * Template Type
+ *
+ * Enum of available email template types
+ */
 var TemplateType;
 (function (TemplateType) {
     TemplateType["VERIFICATION"] = "verification";

package/dist/interfaces/template.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"template.interface.js","sourceRoot":"","sources":["../../src/interfaces/template.interface.ts"],"names":[],"mappings":";;;AAkFA,IAAY,YASX;AATD,WAAY,YAAY;IACtB,6CAA6B,CAAA;IAC7B,gDAAgC,CAAA;IAChC,mCAAmB,CAAA;IACnB,kDAAkC,CAAA;IAClC,wCAAwB,CAAA;IACxB,oDAAoC,CAAA;IACpC,8CAA8B,CAAA;IAC9B,0CAA0B,CAAA;AAC5B,CAAC,EATW,YAAY,4BAAZ,YAAY,QASvB"}
+{"version":3,"file":"template.interface.js","sourceRoot":"","sources":["../../src/interfaces/template.interface.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAsEH;;;;GAIG;AACH,IAAY,YASX;AATD,WAAY,YAAY;IACtB,6CAA6B,CAAA;IAC7B,gDAAgC,CAAA;IAChC,mCAAmB,CAAA;IACnB,kDAAkC,CAAA;IAClC,wCAAwB,CAAA;IACxB,oDAAoC,CAAA;IACpC,8CAA8B,CAAA;IAC9B,0CAA0B,CAAA;AAC5B,CAAC,EATW,YAAY,4BAAZ,YAAY,QASvB"}

package/dist/interfaces/token-verifier.interface.d.ts

@@ -1,7 +1,108 @@
+/**
+ * Token Verifier Service Interface
+ *
+ * Defines the contract for OAuth token verification services.
+ * Each platform-specific implementation must follow this interface.
+ *
+ * Note: Provider-specific verified token profile types are defined in each provider package,
+ * not in core, to maintain proper separation of concerns.
+ *
+ * @example
+ * ```typescript
+ * // In Google provider package
+ * import { ITokenVerifierService } from '@nauth-toolkit/core';
+ *
+ * interface VerifiedGoogleTokenProfile {
+ *   sub: string;
+ *   email: string;
+ *   // ...
+ * }
+ *
+ * class GoogleTokenVerifierService implements ITokenVerifierService {
+ *   async verifyGoogleToken(idToken: string, clientId: string | string[]): Promise<VerifiedGoogleTokenProfile> {
+ *     // Implementation
+ *   }
+ * }
+ * ```
+ */
 export interface ITokenVerifierService {
+    /**
+     * Verify Google ID token with cryptographic signature validation
+     *
+     * Uses Google's public keys to verify the JWT signature, ensuring the token
+     * was issued by Google and has not been tampered with.
+     *
+     * @param idToken - ID token from Google OAuth
+     * @param clientId - Google OAuth client ID for audience validation (supports multiple IDs)
+     * @returns Verified user profile data (provider-specific type)
+     * @throws {BadRequestException} When token is invalid, expired, or signature fails
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const profile = await verifier.verifyGoogleToken(idToken, ['web-client-id', 'ios-client-id']);
+     *   console.log(`Verified email: ${profile.email}`);
+     * } catch (error) {
+     *   console.error('Token verification failed:', error.message);
+     * }
+     * ```
+     */
     verifyGoogleToken?(idToken: string, clientId: string | string[]): Promise<unknown>;
+    /**
+     * Verify Apple ID token with JWT signature validation
+     *
+     * Fetches Apple's public keys from their JWKS endpoint and verifies the
+     * JWT signature to ensure authenticity.
+     *
+     * @param idToken - ID token from Apple Sign In
+     * @param clientId - Apple Services ID (client ID) for audience validation
+     * @returns Verified user profile data (provider-specific type)
+     * @throws {BadRequestException} When token is invalid, expired, or signature fails
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const profile = await verifier.verifyAppleToken(idToken, 'com.yourapp.service');
+     *   console.log(`Verified email: ${profile.email}`);
+     * } catch (error) {
+     *   console.error('Token verification failed:', error.message);
+     * }
+     * ```
+     */
     verifyAppleToken?(idToken: string, clientId: string): Promise<unknown>;
+    /**
+     * Verify Facebook access token via Graph API
+     *
+     * Validates the access token by calling Facebook's debug_token endpoint,
+     * which checks the token's validity and returns user information.
+     *
+     * @param accessToken - Access token from Facebook OAuth
+     * @param appId - Facebook App ID
+     * @param appSecret - Facebook App Secret (server-side only)
+     * @returns Verified user profile data (provider-specific type)
+     * @throws {BadRequestException} When token is invalid or API call fails
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const profile = await verifier.verifyFacebookToken(accessToken, appId, appSecret);
+     *   console.log(`Verified Facebook user: ${profile.id}`);
+     * } catch (error) {
+     *   console.error('Token verification failed:', error.message);
+     * }
+     * ```
+     */
     verifyFacebookToken?(accessToken: string, appId: string, appSecret: string): Promise<unknown>;
+    /**
+     * Clear cached clients and keys
+     *
+     * Useful for testing or when configuration changes
+     *
+     * @example
+     * ```typescript
+     * verifier.clearCache();
+     * ```
+     */
     clearCache?(): void;
 }
 //# sourceMappingURL=token-verifier.interface.d.ts.map

package/dist/interfaces/token-verifier.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token-verifier.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/token-verifier.interface.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,qBAAqB;IAsBpC,iBAAiB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAuBnF,gBAAgB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAwBvE,mBAAmB,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAY9F,UAAU,CAAC,IAAI,IAAI,CAAC;CACrB"}
+{"version":3,"file":"token-verifier.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/token-verifier.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,iBAAiB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnF;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,gBAAgB,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvE;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,mBAAmB,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9F;;;;;;;;;OASG;IACH,UAAU,CAAC,IAAI,IAAI,CAAC;CACrB"}

package/dist/interfaces.d.ts

@@ -1,2 +1,10 @@
+/**
+ * Interfaces barrel export (shim)
+ *
+ * This file exists to ensure TypeScript's emitted declaration paths (e.g. `./interfaces.js`)
+ * resolve correctly for consumers.
+ *
+ * See `packages/core/src/dto.ts` for background.
+ */
 export * from './interfaces/index';
 //# sourceMappingURL=interfaces.d.ts.map

package/dist/interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAQA,cAAc,oBAAoB,CAAC"}
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,oBAAoB,CAAC"}

package/dist/interfaces.js

@@ -14,5 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Interfaces barrel export (shim)
+ *
+ * This file exists to ensure TypeScript's emitted declaration paths (e.g. `./interfaces.js`)
+ * resolve correctly for consumers.
+ *
+ * See `packages/core/src/dto.ts` for background.
+ */
 __exportStar(require("./interfaces/index"), exports);
 //# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAQA,qDAAmC"}
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA;;;;;;;GAOG;AACH,qDAAmC"}

package/dist/internal.d.ts

@@ -1,21 +1,141 @@
+/**
+ * @packageDocumentation
+ * @internal
+ *
+ * Internal Services - Framework Adapters Only
+ *
+ * This module exports internal implementation services that are used by
+ * framework adapters (NestJS, Express) but should NOT be used directly
+ * by consumer applications.
+ *
+ * **WARNING:** These APIs are considered internal implementation details
+ * and may change without notice. Use the public API instead:
+ * - `AuthService` - Main authentication API
+ * - `MFAService` - MFA operations
+ * - `SocialAuthService` - Social authentication
+ * - `EmailVerificationService` - Email verification
+ * - `PhoneVerificationService` - Phone verification
+ * - `ClientInfoService` - Access client context
+ *
+ * **When to use this module:**
+ * - You are building a new framework adapter (e.g., Fastify, Hapi)
+ * - You need access to low-level services for dependency injection
+ *
+ * **When NOT to use this module:**
+ * - You are building a consumer application
+ * - You are implementing authentication in your app
+ * - You need authentication features (use public API instead)
+ *
+ * @example
+ * ```typescript
+ * // Framework adapter usage
+ * import { ChallengeService, PasswordService } from '@nauth-toolkit/core/internal';
+ *
+ * // Inject internal services in adapter setup
+ * const challengeService = new ChallengeService(...);
+ * const authService = new AuthService(..., challengeService, ...);
+ * ```
+ */
+/**
+ * Challenge session management service
+ * @internal
+ */
 export { ChallengeService } from './services/challenge.service';
+/**
+ * Challenge orchestration helper service
+ * @internal
+ */
 export { AuthChallengeHelperService } from './services/auth-challenge-helper.service';
+/**
+ * State machine service for authentication flows
+ * @internal
+ */
 export { AuthFlowStateMachineService } from './services/auth-flow-state-machine.service';
+/**
+ * Context builder for state machine
+ * @internal
+ */
 export { AuthFlowContextBuilder } from './services/auth-flow-context-builder.service';
+/**
+ * State machine types
+ * @internal
+ */
 export * from './services/auth-flow-state-machine.types';
+/**
+ * State machine rules
+ * @internal
+ */
 export * from './services/auth-flow-rules';
+/**
+ * State definitions
+ * @internal
+ */
 export * from './services/auth-flow-state-definitions';
+/**
+ * Password hashing and validation service
+ * @internal
+ */
 export { PasswordService } from './services/password.service';
+/**
+ * JWT token generation and validation service
+ * @internal
+ */
 export { JwtService } from './services/jwt.service';
+/**
+ * Session management service
+ * @internal
+ */
 export { SessionService } from './services/session.service';
+/**
+ * Password reset (account recovery) service
+ * @internal
+ */
 export { PasswordResetService } from './services/password-reset.service';
+/**
+ * Trusted device management service
+ * @internal
+ */
 export { TrustedDeviceService } from './services/trusted-device.service';
+/**
+ * Geolocation service for IP-based location detection
+ * @internal
+ */
 export { GeoLocationService } from './services/geo-location.service';
+/**
+ * Risk detection service - analyzes authentication attempts
+ * @internal
+ */
 export { RiskDetectionService } from './services/risk-detection.service';
+/**
+ * Risk scoring service - calculates risk scores
+ * @internal
+ */
 export { RiskScoringService } from './services/risk-scoring.service';
+/**
+ * Adaptive MFA decision service - determines MFA requirements
+ * @internal
+ */
 export { AdaptiveMFADecisionService } from './services/adaptive-mfa-decision.service';
+/**
+ * Base class for MFA provider implementations
+ * @internal
+ */
 export { BaseMFAProviderService } from './services/mfa-base.service';
+/**
+ * Base class for social authentication provider implementations
+ * @internal
+ */
 export { BaseSocialAuthProviderService } from './services/social-auth-base.service';
+/**
+ * Social provider registry service
+ * Internal registry for managing social auth provider instances
+ * @internal
+ */
 export { SocialProviderRegistry } from './services/social-provider-registry.service';
+/**
+ * Authentication audit service with event recording
+ * Internal version that includes recordEvent() method for framework use
+ * @internal
+ */
 export { InternalAuthAuditService as AuthAuditService } from './services/auth-audit.service';
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AA+CA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAMhE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAUtF,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AAMzF,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAMtF,cAAc,0CAA0C,CAAC;AAMzD,cAAc,4BAA4B,CAAC;AAM3C,cAAc,wCAAwC,CAAC;AAUvD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAM9D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAMpD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAM5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAMzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAMzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAUrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAMzE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAMrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAUtF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAMrE,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAOpF,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAWrF,OAAO,EAAE,wBAAwB,IAAI,gBAAgB,EAAE,MAAM,+BAA+B,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAMH;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE;;;GAGG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAMtF;;;GAGG;AACH,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AAEzF;;;GAGG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AAEtF;;;GAGG;AACH,cAAc,0CAA0C,CAAC;AAEzD;;;GAGG;AACH,cAAc,4BAA4B,CAAC;AAE3C;;;GAGG;AACH,cAAc,wCAAwC,CAAC;AAMvD;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD;;;GAGG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAMrE;;;GAGG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AAEzE;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,iCAAiC,CAAC;AAErE;;;GAGG;AACH,OAAO,EAAE,0BAA0B,EAAE,MAAM,0CAA0C,CAAC;AAMtF;;;GAGG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE;;;GAGG;AACH,OAAO,EAAE,6BAA6B,EAAE,MAAM,qCAAqC,CAAC;AAEpF;;;;GAIG;AACH,OAAO,EAAE,sBAAsB,EAAE,MAAM,6CAA6C,CAAC;AAMrF;;;;GAIG;AACH,OAAO,EAAE,wBAAwB,IAAI,gBAAgB,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/internal.js

@@ -1,4 +1,42 @@
 "use strict";
+/**
+ * @packageDocumentation
+ * @internal
+ *
+ * Internal Services - Framework Adapters Only
+ *
+ * This module exports internal implementation services that are used by
+ * framework adapters (NestJS, Express) but should NOT be used directly
+ * by consumer applications.
+ *
+ * **WARNING:** These APIs are considered internal implementation details
+ * and may change without notice. Use the public API instead:
+ * - `AuthService` - Main authentication API
+ * - `MFAService` - MFA operations
+ * - `SocialAuthService` - Social authentication
+ * - `EmailVerificationService` - Email verification
+ * - `PhoneVerificationService` - Phone verification
+ * - `ClientInfoService` - Access client context
+ *
+ * **When to use this module:**
+ * - You are building a new framework adapter (e.g., Fastify, Hapi)
+ * - You need access to low-level services for dependency injection
+ *
+ * **When NOT to use this module:**
+ * - You are building a consumer application
+ * - You are implementing authentication in your app
+ * - You need authentication features (use public API instead)
+ *
+ * @example
+ * ```typescript
+ * // Framework adapter usage
+ * import { ChallengeService, PasswordService } from '@nauth-toolkit/core/internal';
+ *
+ * // Inject internal services in adapter setup
+ * const challengeService = new ChallengeService(...);
+ * const authService = new AuthService(..., challengeService, ...);
+ * ```
+ */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
     var desc = Object.getOwnPropertyDescriptor(m, k);
@@ -15,41 +53,141 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuthAuditService = exports.SocialProviderRegistry = exports.BaseSocialAuthProviderService = exports.BaseMFAProviderService = exports.AdaptiveMFADecisionService = exports.RiskScoringService = exports.RiskDetectionService = exports.GeoLocationService = exports.TrustedDeviceService = exports.PasswordResetService = exports.SessionService = exports.JwtService = exports.PasswordService = exports.AuthFlowContextBuilder = exports.AuthFlowStateMachineService = exports.AuthChallengeHelperService = exports.ChallengeService = void 0;
+// ============================================================================
+// Challenge System (Internal Orchestration)
+// ============================================================================
+/**
+ * Challenge session management service
+ * @internal
+ */
 var challenge_service_1 = require("./services/challenge.service");
 Object.defineProperty(exports, "ChallengeService", { enumerable: true, get: function () { return challenge_service_1.ChallengeService; } });
+/**
+ * Challenge orchestration helper service
+ * @internal
+ */
 var auth_challenge_helper_service_1 = require("./services/auth-challenge-helper.service");
 Object.defineProperty(exports, "AuthChallengeHelperService", { enumerable: true, get: function () { return auth_challenge_helper_service_1.AuthChallengeHelperService; } });
+// ============================================================================
+// Authentication Flow State Machine (Internal)
+// ============================================================================
+/**
+ * State machine service for authentication flows
+ * @internal
+ */
 var auth_flow_state_machine_service_1 = require("./services/auth-flow-state-machine.service");
 Object.defineProperty(exports, "AuthFlowStateMachineService", { enumerable: true, get: function () { return auth_flow_state_machine_service_1.AuthFlowStateMachineService; } });
+/**
+ * Context builder for state machine
+ * @internal
+ */
 var auth_flow_context_builder_service_1 = require("./services/auth-flow-context-builder.service");
 Object.defineProperty(exports, "AuthFlowContextBuilder", { enumerable: true, get: function () { return auth_flow_context_builder_service_1.AuthFlowContextBuilder; } });
+/**
+ * State machine types
+ * @internal
+ */
 __exportStar(require("./services/auth-flow-state-machine.types"), exports);
+/**
+ * State machine rules
+ * @internal
+ */
 __exportStar(require("./services/auth-flow-rules"), exports);
+/**
+ * State definitions
+ * @internal
+ */
 __exportStar(require("./services/auth-flow-state-definitions"), exports);
+// ============================================================================
+// Low-Level Service Primitives (Internal)
+// ============================================================================
+/**
+ * Password hashing and validation service
+ * @internal
+ */
 var password_service_1 = require("./services/password.service");
 Object.defineProperty(exports, "PasswordService", { enumerable: true, get: function () { return password_service_1.PasswordService; } });
+/**
+ * JWT token generation and validation service
+ * @internal
+ */
 var jwt_service_1 = require("./services/jwt.service");
 Object.defineProperty(exports, "JwtService", { enumerable: true, get: function () { return jwt_service_1.JwtService; } });
+/**
+ * Session management service
+ * @internal
+ */
 var session_service_1 = require("./services/session.service");
 Object.defineProperty(exports, "SessionService", { enumerable: true, get: function () { return session_service_1.SessionService; } });
+/**
+ * Password reset (account recovery) service
+ * @internal
+ */
 var password_reset_service_1 = require("./services/password-reset.service");
 Object.defineProperty(exports, "PasswordResetService", { enumerable: true, get: function () { return password_reset_service_1.PasswordResetService; } });
+/**
+ * Trusted device management service
+ * @internal
+ */
 var trusted_device_service_1 = require("./services/trusted-device.service");
 Object.defineProperty(exports, "TrustedDeviceService", { enumerable: true, get: function () { return trusted_device_service_1.TrustedDeviceService; } });
+/**
+ * Geolocation service for IP-based location detection
+ * @internal
+ */
 var geo_location_service_1 = require("./services/geo-location.service");
 Object.defineProperty(exports, "GeoLocationService", { enumerable: true, get: function () { return geo_location_service_1.GeoLocationService; } });
+// ============================================================================
+// Risk & Adaptive Security (Internal)
+// ============================================================================
+/**
+ * Risk detection service - analyzes authentication attempts
+ * @internal
+ */
 var risk_detection_service_1 = require("./services/risk-detection.service");
 Object.defineProperty(exports, "RiskDetectionService", { enumerable: true, get: function () { return risk_detection_service_1.RiskDetectionService; } });
+/**
+ * Risk scoring service - calculates risk scores
+ * @internal
+ */
 var risk_scoring_service_1 = require("./services/risk-scoring.service");
 Object.defineProperty(exports, "RiskScoringService", { enumerable: true, get: function () { return risk_scoring_service_1.RiskScoringService; } });
+/**
+ * Adaptive MFA decision service - determines MFA requirements
+ * @internal
+ */
 var adaptive_mfa_decision_service_1 = require("./services/adaptive-mfa-decision.service");
 Object.defineProperty(exports, "AdaptiveMFADecisionService", { enumerable: true, get: function () { return adaptive_mfa_decision_service_1.AdaptiveMFADecisionService; } });
+// ============================================================================
+// Base Classes (Internal - for Provider Implementations)
+// ============================================================================
+/**
+ * Base class for MFA provider implementations
+ * @internal
+ */
 var mfa_base_service_1 = require("./services/mfa-base.service");
 Object.defineProperty(exports, "BaseMFAProviderService", { enumerable: true, get: function () { return mfa_base_service_1.BaseMFAProviderService; } });
+/**
+ * Base class for social authentication provider implementations
+ * @internal
+ */
 var social_auth_base_service_1 = require("./services/social-auth-base.service");
 Object.defineProperty(exports, "BaseSocialAuthProviderService", { enumerable: true, get: function () { return social_auth_base_service_1.BaseSocialAuthProviderService; } });
+/**
+ * Social provider registry service
+ * Internal registry for managing social auth provider instances
+ * @internal
+ */
 var social_provider_registry_service_1 = require("./services/social-provider-registry.service");
 Object.defineProperty(exports, "SocialProviderRegistry", { enumerable: true, get: function () { return social_provider_registry_service_1.SocialProviderRegistry; } });
+// ============================================================================
+// Audit Service (Internal - with recordEvent)
+// ============================================================================
+/**
+ * Authentication audit service with event recording
+ * Internal version that includes recordEvent() method for framework use
+ * @internal
+ */
 var auth_audit_service_1 = require("./services/auth-audit.service");
 Object.defineProperty(exports, "AuthAuditService", { enumerable: true, get: function () { return auth_audit_service_1.InternalAuthAuditService; } });
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AA+CA,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AAMzB,0FAAsF;AAA7E,2IAAA,0BAA0B,OAAA;AAUnC,8FAAyF;AAAhF,8IAAA,2BAA2B,OAAA;AAMpC,kGAAsF;AAA7E,2IAAA,sBAAsB,OAAA;AAM/B,2EAAyD;AAMzD,6DAA2C;AAM3C,yEAAuD;AAUvD,gEAA8D;AAArD,mHAAA,eAAe,OAAA;AAMxB,sDAAoD;AAA3C,yGAAA,UAAU,OAAA;AAMnB,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AAMvB,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAM7B,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAM7B,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAU3B,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAM7B,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAM3B,0FAAsF;AAA7E,2IAAA,0BAA0B,OAAA;AAUnC,gEAAqE;AAA5D,0HAAA,sBAAsB,OAAA;AAM/B,gFAAoF;AAA3E,yIAAA,6BAA6B,OAAA;AAOtC,gGAAqF;AAA5E,0IAAA,sBAAsB,OAAA;AAW/B,oEAA6F;AAApF,sHAAA,wBAAwB,OAAoB"}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;;;;;;;;;;;;;;;;;AAEH,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E;;;GAGG;AACH,kEAAgE;AAAvD,qHAAA,gBAAgB,OAAA;AAEzB;;;GAGG;AACH,0FAAsF;AAA7E,2IAAA,0BAA0B,OAAA;AAEnC,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E;;;GAGG;AACH,8FAAyF;AAAhF,8IAAA,2BAA2B,OAAA;AAEpC;;;GAGG;AACH,kGAAsF;AAA7E,2IAAA,sBAAsB,OAAA;AAE/B;;;GAGG;AACH,2EAAyD;AAEzD;;;GAGG;AACH,6DAA2C;AAE3C;;;GAGG;AACH,yEAAuD;AAEvD,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E;;;GAGG;AACH,gEAA8D;AAArD,mHAAA,eAAe,OAAA;AAExB;;;GAGG;AACH,sDAAoD;AAA3C,yGAAA,UAAU,OAAA;AAEnB;;;GAGG;AACH,8DAA4D;AAAnD,iHAAA,cAAc,OAAA;AAEvB;;;GAGG;AACH,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAE7B;;;GAGG;AACH,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAE7B;;;GAGG;AACH,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAE3B,+EAA+E;AAC/E,sCAAsC;AACtC,+EAA+E;AAE/E;;;GAGG;AACH,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAE7B;;;GAGG;AACH,wEAAqE;AAA5D,0HAAA,kBAAkB,OAAA;AAE3B;;;GAGG;AACH,0FAAsF;AAA7E,2IAAA,0BAA0B,OAAA;AAEnC,+EAA+E;AAC/E,yDAAyD;AACzD,+EAA+E;AAE/E;;;GAGG;AACH,gEAAqE;AAA5D,0HAAA,sBAAsB,OAAA;AAE/B;;;GAGG;AACH,gFAAoF;AAA3E,yIAAA,6BAA6B,OAAA;AAEtC;;;;GAIG;AACH,gGAAqF;AAA5E,0IAAA,sBAAsB,OAAA;AAE/B,+EAA+E;AAC/E,8CAA8C;AAC9C,+EAA+E;AAE/E;;;;GAIG;AACH,oEAA6F;AAApF,sHAAA,wBAAwB,OAAoB"}