Class Webauthn

Main WebAuthn class for authentication management

Hierarchy

EventEmitter
- Webauthn

Constructors

constructor

new Webauthn(
gunInstance?: IGunInstance<unknown>,
config?: Partial<WebAuthnConfig>,
): Webauthn
Creates a new WebAuthn instance
Parameters
- OptionalgunInstance: IGunInstance<unknown>
- Optionalconfig: Partial<WebAuthnConfig>
Returns Webauthn
Overrides EventEmitter.constructor

Properties

`Private`abortController

abortController: null | AbortController = null

`Private` `Readonly`config

config: WebAuthnConfig

`Private`credential

credential: null | WebAuthnCredentialData

`Private` `Optional` `Readonly`gunInstance

gunInstance?: IGunInstance<unknown>

Methods

abortAuthentication

abortAuthentication(): void
Aborts current authentication attempt

Returns void

authenticateUser

authenticateUser(
    username: string,
    salt: null | string,
    options?: WebAuthnOperationOptions,
): Promise<CredentialResult>
Authenticates a user with timeout and abort handling
Parameters
- username: string
- salt: null | string
- options: WebAuthnOperationOptions = {}
Returns Promise<CredentialResult>

`Private`bufferToBase64

bufferToBase64(buffer: ArrayBuffer): string
Converts ArrayBuffer to URL-safe base64 string
Parameters
- buffer: ArrayBuffer
Returns string

createAccount

createAccount(
    username: string,
    credentials: null | WebAuthnCredentials,
    isNewDevice?: boolean,
): Promise<CredentialResult>
Creates a new WebAuthn account with retry logic
Parameters
- username: string
- credentials: null | WebAuthnCredentials
- isNewDevice: boolean = false
Returns Promise<CredentialResult>

`Private`createCredential

createCredential(username: string): Promise<WebAuthnCredentialData>
Creates a WebAuthn credential for registration
Parameters
- username: string
Returns Promise<WebAuthnCredentialData>

emit

emit(event: EventType, data?: unknown): boolean
Emits an event with arguments
Parameters
- event: EventType
- Optionaldata: unknown
Returns boolean
Inherited from EventEmitter.emit

`Private`generateChallenge

generateChallenge(username: string): Uint8Array
Generates a challenge for WebAuthn operations
Parameters
- username: string
Returns Uint8Array

generateCredentials

generateCredentials(
    username: string,
    existingCredential?: null | WebAuthnCredentials,
    isLogin?: boolean,
): Promise<CredentialResult>
Generates WebAuthn credentials
Parameters
- username: string
- OptionalexistingCredential: null | WebAuthnCredentials
- isLogin: boolean = false
Returns Promise<CredentialResult>

`Private`generateCredentialsFromSalt

generateCredentialsFromSalt(
username: string,
salt: string,
): { password: string }
Generates credentials from username and salt
Parameters
- username: string
- salt: string
Returns { password: string }

`Private`getDeviceInfo

getDeviceInfo(credentialId: string): DeviceInfo
Gets device information
Parameters
- credentialId: string
Returns DeviceInfo

`Private`getPlatformInfo

getPlatformInfo(): { name: string; platform: string }
Gets platform information

Returns { name: string; platform: string }

`Private`getRandomBytes

getRandomBytes(length: number): Uint8Array
Gets cryptographically secure random bytes
Parameters
- length: number
Returns Uint8Array

isSupported

isSupported(): boolean
Checks if WebAuthn is supported

Returns boolean

off

off(event: EventType, listener: (data: unknown) => void): void
Removes an event listener
Parameters
- event: EventType
- listener: (data: unknown) => void
Returns void
Inherited from EventEmitter.off

on

on(event: EventType, listener: (data: unknown) => void): void
Registers an event listener
Parameters
- event: EventType
- listener: (data: unknown) => void
Returns void
Inherited from EventEmitter.on

once

once(event: EventType, listener: (data: unknown) => void): void
Registers a one-time event listener
Parameters
- event: EventType
- listener: (data: unknown) => void
Returns void
Inherited from EventEmitter.once

removeAllListeners

removeAllListeners(event?: EventType): void
Removes all listeners for an event or all events
Parameters
- Optionalevent: EventType
Returns void
Inherited from EventEmitter.removeAllListeners

removeDevice

removeDevice(
    username: string,
    credentialId: string,
    credentials: WebAuthnCredentials,
): Promise<{ success: boolean; updatedCredentials?: WebAuthnCredentials }>
Removes device credentials
Parameters
- username: string
- credentialId: string
- credentials: WebAuthnCredentials
Returns Promise<{ success: boolean; updatedCredentials?: WebAuthnCredentials }>

`Private`saveToGun

saveToGun(username: string, credential: WebAuthnCredentialData): Promise<void>
Saves credential to GunDB
Parameters
- username: string
- credential: WebAuthnCredentialData
Returns Promise<void>

sign

sign(data: Record<string, unknown>): Promise<unknown>
Signs data with the credential
Parameters
- data: Record<string, unknown>
Returns Promise<unknown>

`Private`uint8ArrayToHex

uint8ArrayToHex(arr: Uint8Array): string
Converts Uint8Array to hexadecimal string
Parameters
- arr: Uint8Array
Returns string

validateUsername

validateUsername(username: string): void
Validates a username
Parameters
- username: string
Returns void

`Private`verifyCredential

verifyCredential(username: string): Promise<WebAuthnVerificationResult>
Verifies a credential
Parameters
- username: string
Returns Promise<WebAuthnVerificationResult>