@nauth-toolkit/core 0.1.61 → 0.1.62

package/dist/services/hook-registry.service.d.ts

@@ -10,7 +10,7 @@
  *
  * @packageDocumentation
  */
-import { IPreSignupHookProvider, IPostSignupHookProvider, SignupMetadata, PreSignupHookData, IUserProfileUpdatedHook, UserProfileUpdatedMetadata } from '../interfaces/hooks.interface';
+import { IPreSignupHookProvider, IPostSignupHookProvider, SignupMetadata, PreSignupHookData, IOnboardingCompletedHook, OnboardingCompletedMetadata, IUserProfileUpdatedHook, UserProfileUpdatedMetadata, IPasswordChangedHook, PasswordChangedMetadata, IMFADeviceRemovedHook, MFADeviceRemovedMetadata, IAdaptiveMFARiskDetectedHook, AdaptiveMFARiskDetectedMetadata, IAccountStatusChangedHook, AccountStatusChangedMetadata, IEmailChangedHook, EmailChangedMetadata, IAccountLockedHook, AccountLockedMetadata, ISessionsRevokedHook, SessionsRevokedMetadata, IMFAFirstEnabledHook, MFAFirstEnabledMetadata, IMFAMethodAddedHook, MFAMethodAddedMetadata } from '../interfaces/hooks.interface';
 import { IUser } from '../interfaces/entities.interface';
 import { LoggerProvider } from '../interfaces/logger.interface';
 /**
@@ -22,7 +22,17 @@ export declare class HookRegistryService {
     private readonly logger?;
     private readonly preSignupHooks;
     private readonly postSignupHooks;
+    private readonly onboardingCompletedHooks;
     private readonly userProfileUpdatedHooks;
+    private readonly passwordChangedHooks;
+    private readonly mfaDeviceRemovedHooks;
+    private readonly adaptiveMFARiskDetectedHooks;
+    private readonly accountStatusChangedHooks;
+    private readonly emailChangedHooks;
+    private readonly accountLockedHooks;
+    private readonly sessionsRevokedHooks;
+    private readonly mfaFirstEnabledHooks;
+    private readonly mfaMethodAddedHooks;
     constructor(logger?: LoggerProvider | undefined);
     /**
      * Register a pre-signup hook provider
@@ -42,6 +52,15 @@ export declare class HookRegistryService {
      * @param provider - Post-signup hook provider instance
      */
     registerPostSignup(provider: IPostSignupHookProvider): void;
+    /**
+     * Register an onboarding completed hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block user flows (non-blocking).
+     *
+     * @param provider - Onboarding completed hook instance
+     */
+    registerOnboardingCompleted(provider: IOnboardingCompletedHook): void;
     /**
      * Register a user profile updated hook
      *
@@ -51,6 +70,87 @@ export declare class HookRegistryService {
      * @param provider - User profile updated hook instance
      */
     registerUserProfileUpdated(provider: IUserProfileUpdatedHook): void;
+    /**
+     * Register a password changed hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block password changes (non-blocking).
+     *
+     * @param provider - Password changed hook instance
+     */
+    registerPasswordChanged(provider: IPasswordChangedHook): void;
+    /**
+     * Register an MFA device removed hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block device removal (non-blocking).
+     *
+     * @param provider - MFA device removed hook instance
+     */
+    registerMFADeviceRemoved(provider: IMFADeviceRemovedHook): void;
+    /**
+     * Register an adaptive MFA risk detected hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block authentication (non-blocking).
+     *
+     * @param provider - Adaptive MFA risk detected hook instance
+     */
+    registerAdaptiveMFARiskDetected(provider: IAdaptiveMFARiskDetectedHook): void;
+    /**
+     * Register an account status changed hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block status changes (non-blocking).
+     *
+     * @param provider - Account status changed hook instance
+     */
+    registerAccountStatusChanged(provider: IAccountStatusChangedHook): void;
+    /**
+     * Register an email changed hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block email changes (non-blocking).
+     *
+     * @param provider - Email changed hook instance
+     */
+    registerEmailChanged(provider: IEmailChangedHook): void;
+    /**
+     * Register an account locked hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block lockout (non-blocking).
+     *
+     * @param provider - Account locked hook instance
+     */
+    registerAccountLocked(provider: IAccountLockedHook): void;
+    /**
+     * Register a sessions revoked hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block session revocation (non-blocking).
+     *
+     * @param provider - Sessions revoked hook instance
+     */
+    registerSessionsRevoked(provider: ISessionsRevokedHook): void;
+    /**
+     * Register an MFA first enabled hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block MFA enrollment (non-blocking).
+     *
+     * @param provider - MFA first enabled hook instance
+     */
+    registerMFAFirstEnabled(provider: IMFAFirstEnabledHook): void;
+    /**
+     * Register an MFA method added hook
+     *
+     * Hooks are executed in registration order.
+     * Hook errors are logged but do not block MFA enrollment (non-blocking).
+     *
+     * @param provider - MFA method added hook instance
+     */
+    registerMFAMethodAdded(provider: IMFAMethodAddedHook): void;
     /**
      * Execute all registered pre-signup hooks
      *
@@ -80,6 +180,19 @@ export declare class HookRegistryService {
      * @remarks This method is called internally by AuthService and BaseSocialAuthProviderService
      */
     executePostSignup(user: IUser, metadata?: SignupMetadata): Promise<void>;
+    /**
+     * Execute all registered onboarding completed hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param user - User entity (IUser interface)
+     * @param metadata - Completion metadata (verification method, source, timestamp)
+     *
+     * @internal
+     * @remarks This method is called internally by AuthService, EmailVerificationService, and PhoneVerificationService
+     */
+    executeOnboardingCompleted(user: IUser, metadata: OnboardingCompletedMetadata): Promise<void>;
     /**
      * Execute all registered user profile updated hooks
      *
@@ -92,5 +205,113 @@ export declare class HookRegistryService {
      * @remarks This method is called internally by AuthService, EmailVerificationService, and PhoneVerificationService
      */
     executeUserProfileUpdated(metadata: UserProfileUpdatedMetadata): Promise<void>;
+    /**
+     * Execute all registered password changed hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param metadata - Password change context with user and change details
+     *
+     * @internal
+     * @remarks This method is called internally by AuthServiceInternalHelpers
+     */
+    executePasswordChanged(metadata: PasswordChangedMetadata): Promise<void>;
+    /**
+     * Execute all registered MFA device removed hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param metadata - Device removal context with user and device details
+     *
+     * @internal
+     * @remarks This method is called internally by UserService and MFAService
+     */
+    executeMFADeviceRemoved(metadata: MFADeviceRemovedMetadata): Promise<void>;
+    /**
+     * Execute all registered adaptive MFA risk detected hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param metadata - Risk evaluation context with user and risk details
+     *
+     * @internal
+     * @remarks This method is called internally by AdaptiveMFADecisionService
+     */
+    executeAdaptiveMFARiskDetected(metadata: AdaptiveMFARiskDetectedMetadata): Promise<void>;
+    /**
+     * Execute all registered account status changed hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param metadata - Status change context with user and change details
+     *
+     * @internal
+     * @remarks This method is called internally by UserService
+     */
+    executeAccountStatusChanged(metadata: AccountStatusChangedMetadata): Promise<void>;
+    /**
+     * Execute all registered email changed hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param metadata - Email change context with old and new addresses
+     *
+     * @internal
+     * @remarks This method is called internally by UserService
+     */
+    executeEmailChanged(metadata: EmailChangedMetadata): Promise<void>;
+    /**
+     * Execute all registered account locked hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param metadata - Lockout context with user and lock details
+     *
+     * @internal
+     * @remarks This method is called internally by AuthServiceInternalHelpers
+     */
+    executeAccountLocked(metadata: AccountLockedMetadata): Promise<void>;
+    /**
+     * Execute all registered sessions revoked hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param metadata - Revocation context with user and session details
+     *
+     * @internal
+     * @remarks This method is called internally by SessionService
+     */
+    executeSessionsRevoked(metadata: SessionsRevokedMetadata): Promise<void>;
+    /**
+     * Execute all registered MFA first enabled hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param metadata - MFA enrollment context with user and device details
+     *
+     * @internal
+     * @remarks This method is called internally by BaseMFAProviderService
+     */
+    executeMFAFirstEnabled(metadata: MFAFirstEnabledMetadata): Promise<void>;
+    /**
+     * Execute all registered MFA method added hooks
+     *
+     * Hooks are executed sequentially in registration order.
+     * Hook errors are logged but do not stop execution (non-blocking).
+     *
+     * @param metadata - MFA method addition context
+     *
+     * @internal
+     * @remarks This method is called internally by BaseMFAProviderService
+     */
+    executeMFAMethodAdded(metadata: MFAMethodAddedMetadata): Promise<void>;
 }
 //# sourceMappingURL=hook-registry.service.d.ts.map

package/dist/services/hook-registry.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hook-registry.service.d.ts","sourceRoot":"","sources":["../../src/services/hook-registry.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,sBAAsB,EACtB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,EACjB,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,KAAK,EAAE,MAAM,kCAAkC,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAIhE;;;;GAIG;AACH,qBAAa,mBAAmB;IAKlB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAJpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAgC;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiC;IACjE,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAiC;gBAE5C,MAAM,CAAC,EAAE,cAAc,YAAA;IAMpD;;;;;;;OAOG;IACH,iBAAiB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAKzD;;;;;;;OAOG;IACH,kBAAkB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IAK3D;;;;;;;OAOG;IACH,0BAA0B,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI;IASnE;;;;;;;;;;;;;;OAcG;IACG,gBAAgB,CACpB,IAAI,EAAE,iBAAiB,EACvB,UAAU,EAAE,UAAU,GAAG,QAAQ,EACjC,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,IAAI,CAAC;IA4BhB;;;;;;;;;;;OAWG;IACG,iBAAiB,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB9E;;;;;;;;;;OAUG;IACG,yBAAyB,CAAC,QAAQ,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;CAkBrF"}
+{"version":3,"file":"hook-registry.service.d.ts","sourceRoot":"","sources":["../../src/services/hook-registry.service.ts"],"names":[],"mappings":"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"}