/**
 * Authentication Handler
 *
 * Validates JWT tokens and attaches user to request.
 *
 * **Platform-Agnostic:**
 * This handler operates purely on NAuthRequest interface.
 * Context is managed by the adapter, not this handler.
 */
import { NAuthConfig, NAuthLogger, AuthService } from '../index';
import { JwtService, SessionService } from '../internal';
import { NAuthRequest, NAuthResponse } from '../platform/interfaces';
/**
 * AuthHandler
 *
 * Validates JWT tokens and populates user context.
 * Performs optional authentication by default (doesn't reject unauthenticated requests).
 */
export declare class AuthHandler {
    private jwtService;
    private sessionService;
    private authService;
    private config;
    private logger?;
    constructor(jwtService: JwtService, sessionService: SessionService, authService: AuthService, config: NAuthConfig, logger?: NAuthLogger | undefined);
    /**
     * Handle request - validate token and attach user
     *
     * Note: Context is managed by adapter. This handler assumes context is available.
     */
    handle(req: NAuthRequest, _res: NAuthResponse, next: () => Promise<void> | void): Promise<void>;
    /**
     * Extract token from request based on delivery mode
     */
    private extractToken;
    /**
     * Update CLIENT_INFO with session ID from token
     */
    private updateClientInfoSessionId;
    /**
     * Update CLIENT_INFO with user ID from token (internal id)
     */
    private updateClientInfoUserId;
    /**
     * Update CLIENT_INFO with user sub (UUID) from authenticated user
     */
    private updateClientInfoSub;
}
//# sourceMappingURL=auth.handler.d.ts.map