- Check our API documentation
Code | Message | How to debug / fix |
---|---|---|
PasswordMismatch | You entered a wrong password! | Did you store password we hashed for you? |
UsernameRequired | Username is required field, please enter the username! | 🤔 |
PasswordRequired | Password is required field, please enter the password! | 🤔 |
UserNotFound | It seems this user doesn't exist, are you sure you entered correct credentials? | Do you want to enable auto registration? Declare saveNonExistingUser function |
Under heavy development
- supported features by Firebase Authentication, a fellow auth ideal service
- email and password authentication ref
- google authentication ref
- facebook authentication ref
- twitter authentication ref
- github authentication ref
- custom auth system authentication ref
- anonymous auth ref kept forever
- storing provider data ref what data
- reset password email ref
- recovery email ref
- verify email ref
import { createAuthenticator } from 'authist';
const authenticator = createAuthenticator({
getUserById: () => Promise.resolve(), // todo: add implementation
emailPassword: {
getUserByEmail: (email: string) => Promise.resolve(), // todo: add implementation
},
});
const { user, credentials } = await authenticator.signInWithEmailAndPassword(email, password);
import express from 'express';
const app = express();
app.get('/users/me', authenticator.expressBearer, (req, res) => {
res.json(req.user);
});
- The
signInWithFacebook
method takestoken
parameter that is Facebook access token you will get it on the frontend side - Your Facebook access token must have the
email
permission assigned to successfully get the user's email
import { createAuthenticator } from 'authist';
const authenticator = createAuthenticator({
getUserById: () => Promise.resolve(), // todo: add implementation
facebook: {
getUserByEmail: (email: string) => Promise.resolve(), // todo: add implementation
graphApiVersion: 'v9.0',
},
});
const { user, credentials } = await authenticator.signInWithFacebook(accessToken);
- The
signInWithGoogle
method takestoken
parameter that is Google access token - Your Google access token must have the
email
scope assigned to successfully get the user's email
import { createAuthenticator } from 'authist';
const authenticator = createAuthenticator({
getUserById: () => Promise.resolve(), // todo: add implementation
google: {
getUserByEmail: (email: string) => Promise.resolve(), // todo: add implementation
},
});
const { user, credentials } = await authenticator.signInWithGoogle(accessToken);
This project is licensed under MIT.