@waysnx/ui-security

🤖 AI agents & LLMs: See LLM.md (shipped with this package) for a structured integration guide — pre-built auth/MFA/session/authorization components and providers.

Enterprise-grade security components from WaysNX — authentication, authorization, MFA, secure inputs, and session management.

Installation

npm install @waysnx/ui-security

Quick Start

import { PasswordInput, LoginForm, LoginCard, OTPInput } from '@waysnx/ui-security';
import '@waysnx/ui-security/dist/index.css';

Components

Password Management

• PasswordInput — Secure input with visibility toggle and strength indicator
• PasswordStrengthMeter — Visual password strength bar
• PasswordRequirements — Live checklist of policy compliance
• PasswordGenerator — Generate random passwords with configurable options
• ChangePasswordForm — Current + new + confirm password form
• ForgotPasswordForm — Email input for password reset

Authentication

• LoginForm — Complete login form (email, password, remember me)
• LoginCard — Styled card wrapper for auth forms

OTP & Verification

• OTPInput — Multi-digit input with auto-advance
• OTPVerificationCard — OTP verification flow card
• OTPResendButton — Resend button with countdown timer
• EmailVerificationCard — Email verification flow
• PhoneVerificationCard — Phone verification flow
• DeviceVerificationDialog — Device trust verification
• VerificationStatus — Verification state display

Providers

• AuthenticationProvider — Auth context for login/logout/user state
• AuthorizationProvider — Permission and role-based access
• MFAProvider — Multi-factor authentication state
• SessionProvider — Session management and timeout

Hooks

• useAuth() — Access auth state and methods
• useOTP() — OTP generation and verification
• usePasswordValidation() — Validate password against policy
• useBiometricAuth() — Biometric authentication
• useIdleDetection() — Auto-logout on inactivity
• useSecureStorage() — Encrypted localStorage

Utilities

• hashPassword, verifyPassword — Password hashing
• generateToken, verifyToken — Token management
• hasPermission, hasRole — Permission checks
• generateTOTPSecret, verifyTOTP — MFA utilities
• getDeviceFingerprint — Device identification
• createSession, isSessionValid — Session management

Theming

Uses shared --wx-* CSS tokens from the WaysNX UI Kit ecosystem. All components respond to theme overrides.

Dependencies

• @waysnx/ui-core — Input, Button, Checkbox components
• @waysnx/ui-layout — Card, Stack layout
• @waysnx/ui-feedback — Badge, Modal, Alert
• @waysnx/ui-i18n — Internationalization support

License

Apache-2.0