It is Auth Template For express using Typescript.
The auth-typescript-template is a npm package designed to simplify the setup of authentication routes (login, signup, and logout) in your project. After installation, it creates a separate folder in your project root directory and makes necessary changes to index.js, allowing you to test these routes directly without additional coding.
npm i npm i auth-typescript-template
npx auth-typescript-template
npm install express mongoose jsonwebtoken bcryptjs dotenv cors cookie-parser
npm install --save-dev @types/express @types/mongoose @types/jsonwebtoken @types/bcryptjs @types/dotenv @types/cors @types/cookie-parser @types/nodemon
.env
file in your project(which is generated from the auth-typescript-template) and here you have to give MONGO_URI
and JWT_SECRET
and PORT
.npm init -y
. This npm package automatically creates an index.ts file to run the auth routes, so installing the package first is recommended. npm i auth-typescript-template
npx auth-typescript-template
npm install express mongoose jsonwebtoken bcryptjs dotenv cors cookie-parser nodemon
npm install --save-dev @types/express @types/mongoose @types/jsonwebtoken @types/bcryptjs @types/dotenv @types/cors @types/cookie-parser @types/nodemon
express
: Express is used to create the web server and handle routing. It provides a simple way to define routes for login, signup, and logout, which are core features of your authentication package.
mongoose
: Mongoose is used to interact with MongoDB. It allows for defining schemas and models for users, managing data relationships, and performing database operations, which are crucial for storing and retrieving user information securely.
jsonwebtoken
: JSON Web Token (JWT) is used for token-based authentication. It helps in securely transmitting information between parties as a JSON object. This is essential for managing user sessions and ensuring that only authenticated users can access certain routes.
bcryptjs
: bcrypt.js is used for hashing and comparing passwords. It ensures that user passwords are stored securely in the database, protecting against potential breaches.
dotenv
: dotenv is used to manage environment variables. It allows you to keep sensitive data such as JWT secrets and database URLs out of your codebase, enhancing security and flexibility.
cors
: CORS (Cross-Origin Resource Sharing) middleware is used to enable requests from different origins. This is important for your project if you want to allow your frontend application (hosted on a different domain) to communicate with your backend server.
cookie-parser
: cookie-parser is used to parse cookies attached to client requests. This is useful for handling session cookies and other cookie-based authentication mechanisms.
nodemon
: nodemon is used during development to automatically restart the server when file changes are detected. This enhances productivity by eliminating the need to manually restart the server after every change.
Althogh nodemon
is not required to run this package but it makes your experiance better.
Change the package.json
file to use the nodemon.
"scripts": {
"dev": "nodemon index.ts",
"start": "node index.ts",
},
"type": "module",
config
: It is basically for connecting mongoDB database.
controllers
: It has one file named authController.ts which handles all the Login,Logout and Signup process.
Function | Parameter |
---|---|
SignUp |
Required fullName ,username ,email ,password . |
Login |
Required username , password
|
Logout |
Nothing Required |
You can modify all the functions as all the code is available. Add variables or parameters as needed, and update the user model and function code accordingly.
In updated versions of this package, we will try to give customizations of this parameters.
middleware
:The protectRoute middleware function verifies the JWT token from cookies, retrieves the corresponding user from the database, and attaches the user object to the request for protected routes.
models
: user models.
Fields | Data types |
---|---|
username |
Required String |
fullName |
Required String |
password |
Required String min length 6
|
email |
Required String |
routes
:The code sets up an Express router with routes for user authentication (/signup, /login, /logout) and a protected route (/me) using the protectRoute middleware to retrieve the authenticated user's details(This /me is in development mode..so you will not get it in your package..but you can add it my yourself..protectRoute middleware is available for your use.).
Routes | Method |
---|---|
/signup |
Post |
/login |
Post |
/logout |
Post |
utils
: The generateTokenAndSetCookie function creates a JWT for a given user ID, sets it as an HTTP-only, same-site cookie with a 15-day expiration on the response, enhancing security against XSS and CSRF attacks.
env | Description |
---|---|
MONGO_URI |
Required URI for connecting to your MongoDB database. |
JWT_SECRET |
Required contains the secret key used to sign and verify JSON Web Tokens (JWT). |
NODE_ENV |
By default Development |
PORT |
Required PORT required for running the server |
Now all is set you can run your server by npm run dev
and test your server by Postman or other applications.