@auth/core
Version:
Authentication for the Web.
183 lines • 6.62 kB
TypeScript
interface ErrorCause extends Record<string, unknown> {
}
export declare class AuthError extends Error {
constructor(message: string | Error | ErrorCause, cause?: ErrorCause);
}
/**
* @todo
* One of the database `Adapter` methods failed.
*/
export declare class AdapterError extends AuthError {
}
/** @todo */
export declare class AuthorizedCallbackError extends AuthError {
}
/**
* This error occurs when the user cannot finish the sign-in process.
* Depending on the provider type, this could have happened for multiple reasons.
*
* :::tip
* Check out `[auth][details]` in the error message to know which provider failed.
* @example
* ```sh
* [auth][details]: { "provider": "github" }
* ```
* :::
*
* For an [OAuth provider](https://authjs.dev/reference/core/providers_oauth), possible causes are:
* - The user denied access to the application
* - There was an error parsing the OAuth Profile:
* Check out the provider's `profile` or `userinfo.request` method to make sure
* it correctly fetches the user's profile.
* - The `signIn` or `jwt` callback methods threw an uncaught error:
* Check the callback method implementations.
*
* For an [Email provider](https://authjs.dev/reference/core/providers_email), possible causes are:
* - The provided email/token combination was invalid/missing:
* Check if the provider's `sendVerificationRequest` method correctly sends the email.
* - The provided email/token combination has expired:
* Ask the user to log in again.
* - There was an error with the database:
* Check the database logs.
*
* For a [Credentials provider](https://authjs.dev/reference/core/providers_credentials), possible causes are:
* - The `authorize` method threw an uncaught error:
* Check the provider's `authorize` method.
* - The `signIn` or `jwt` callback methods threw an uncaught error:
* Check the callback method implementations.
*
* :::tip
* Check out `[auth][cause]` in the error message for more details.
* It will show the original stack trace.
* :::
*/
export declare class CallbackRouteError extends AuthError {
}
/** @todo */
export declare class ErrorPageLoop extends AuthError {
}
/** @todo */
export declare class EventError extends AuthError {
}
/** @todo */
export declare class InvalidCallbackUrl extends AuthError {
}
/** @todo */
export declare class InvalidEndpoints extends AuthError {
}
/** @todo */
export declare class InvalidCheck extends AuthError {
}
/** @todo */
export declare class JWTSessionError extends AuthError {
}
/** @todo */
export declare class MissingAdapter extends AuthError {
}
/** @todo */
export declare class MissingAdapterMethods extends AuthError {
}
/** @todo */
export declare class MissingAPIRoute extends AuthError {
}
/** @todo */
export declare class MissingAuthorize extends AuthError {
}
/**
* Auth.js requires a secret to be set, but none was not found. This is used to encrypt cookies, JWTs and other sensitive data.
*
* :::note
* If you are using a framework like Next.js, we try to automatically infer the secret from the `AUTH_SECRET` environment variable.
* Alternatively, you can also explicitly set the [`AuthConfig.secret`](https://authjs.dev/reference/core#secret).
* :::
*
*
* :::tip
* You can generate a good secret value:
* - On Unix systems: type `openssl rand -hex 32` in the terminal
* - Or generate one [online](https://generate-secret.vercel.app/32)
*
* :::
*/
export declare class MissingSecret extends AuthError {
}
/**
* @todo
* Thrown when an Email address is already associated with an account
* but the user is trying an OAuth account that is not linked to it.
*/
export declare class OAuthAccountNotLinked extends AuthError {
}
/**
* Thrown when an OAuth provider returns an error during the sign in process.
* This could happen for example if the user denied access to the application or there was a configuration error.
*
* For a full list of possible reasons, check out the specification [Authorization Code Grant: Error Response](https://www.rfc-editor.org/rfc/rfc6749#section-4.1.2.1)
*/
export declare class OAuthCallbackError extends AuthError {
}
/** @todo */
export declare class OAuthCreateUserError extends AuthError {
}
/**
* This error occurs during an OAuth sign in attempt when the provdier's
* response could not be parsed. This could for example happen if the provider's API
* changed, or the [`OAuth2Config.profile`](https://authjs.dev/reference/core/providers_oauth#profile) method is not implemented correctly.
*/
export declare class OAuthProfileParseError extends AuthError {
}
/** @todo */
export declare class SessionTokenError extends AuthError {
}
/**
* This error occurs when the user cannot initiate the sign-in process.
* Depending on the provider type, this could have happened for multiple reasons.
*
* :::tip
* Check out `[auth][details]` in the error message to know which provider failed.
* @example
* ```sh
* [auth][details]: { "provider": "github" }
* ```
* :::
*
* For an [OAuth provider](https://authjs.dev/reference/core/providers_oauth), possible causes are:
* - The Authorization Server is not compliant with the [OAuth 2.0 specifcation](https://www.ietf.org/rfc/rfc6749.html)
* Check the details in the error message.
* - A runtime error occurred in Auth.js. This should be reported as a bug.
*
* For an [Email provider](https://authjs.dev/reference/core/providers_email), possible causes are:
* - The email sent from the client is invalid, could not be normalized by [`EmailConfig.normalizeIdentifier`](https://authjs.dev/reference/core/providers_email#normalizeidentifier)
* - The provided email/token combination has expired:
* Ask the user to log in again.
* - There was an error with the database:
* Check the database logs.
*
*/
export declare class SignInError extends AuthError {
}
/** @todo */
export declare class SignOutError extends AuthError {
}
/**
* Auth.js was requested to handle an operation that it does not support.
*
* See [`AuthAction`](https://authjs.dev/reference/core/types#authaction) for the supported actions.
*/
export declare class UnknownAction extends AuthError {
}
/** @todo */
export declare class UnsupportedStrategy extends AuthError {
}
/** @todo */
export declare class UntrustedHost extends AuthError {
}
/**
* The user's email/token combination was invalid.
* This could be because the email/token combination was not found in the database,
* or because it token has expired. Ask the user to log in again.
*/
export declare class Verification extends AuthError {
}
export {};
//# sourceMappingURL=errors.d.ts.map