Skip to main content

Class: AuthenticationError

Defined in: web/lib/errors.ts:328

Authentication error for failed authentication attempts.

Remarks​

Thrown when:

  • Credentials are invalid
  • DID verification fails
  • Session token is missing or invalid
  • OAuth flow fails

Example​

if (!session.isValid()) {
  throw new AuthenticationError('Session expired');
}

Extends​

Constructors​

new AuthenticationError()​

new AuthenticationError(message, cause?): AuthenticationError

Defined in: web/lib/errors.ts:84

Creates a new ChiveError.

Parameters​

message​

string

Human-readable error message

cause?​

Error

Original error (if chained)

Returns​

AuthenticationError

Inherited from​

ChiveError.constructor

Properties​

cause?​

readonly optional cause: Error

Defined in: web/lib/errors.ts:76

Original error that caused this error (if any).

Remarks​

Error chaining allows tracking the full error context through multiple layers of the application. Useful for debugging complex error scenarios.

Inherited from​

ChiveError.cause

code​

readonly code: "AUTHENTICATION_ERROR" = 'AUTHENTICATION_ERROR'

Defined in: web/lib/errors.ts:329

Machine-readable error code.

Remarks​

Error codes are unique identifiers for error types, enabling programmatic error handling (switch statements, error maps), error tracking in monitoring systems, and client-side error translation (i18n).

Overrides​

ChiveError.code

Accessors​

isRetryable​

Get Signature​

get isRetryable(): boolean

Defined in: web/lib/errors.ts:109

Whether this error is retryable.

Remarks​

Override in subclasses to indicate whether the operation can be retried. Default is false (non-retryable).

Returns​

boolean

Inherited from​

ChiveError.isRetryable

severity​

Get Signature​

get severity(): ErrorSeverity

Defined in: web/lib/errors.ts:98

Error severity for monitoring and alerting.

Remarks​

Override in subclasses to customize severity based on error type. Default is 'medium' for most errors.

Returns​

ErrorSeverity

Inherited from​

ChiveError.severity

Methods​

toJSON()​

toJSON(): SerializedError

Defined in: web/lib/errors.ts:120

Converts error to a plain object for structured logging.

Returns​

SerializedError

Remarks​

Produces a JSON-serializable object with all error properties, including nested cause chains.

Inherited from​

ChiveError.toJSON