KeySentry

A secure and flexible JWT (JSON Web Token) authentication library for Node.js applications.

Features

• Simple JWT token generation and verification
• Configurable token expiration times
• Support for access and refresh tokens
• Customizable signing algorithms
• Secure default settings

Installation

npm install key-sentry

Methods

generateToken(payload, withRefreshToken = true)

Generates an access token and optionally a refresh token.

Parameters:

• payload (Object): Data to include in the token
• withRefreshToken (boolean, optional): Whether to generate a refresh token (default: true)

Returns: Object containing:

• accessToken (string): The JWT access token
• accessTokenExpiresAt (number): Access token expiration timestamp
• issuedAt (number): Token issuance timestamp
• payload (Object): The data included in the token
• refreshToken (string, optional): The refresh token
• refreshTokenExpiresAt (number, optional): Refresh token expiration timestamp
• refreshIssuedAt (number, optional): Refresh token issuance timestamp

verifyToken(token, tokenType = 'access')

Verifies a token's authenticity and expiration status.

Parameters:

• token (string): The token to verify
• tokenType (string, optional): Type of token ('access' or 'refresh', default: 'access')

Returns: Object containing:

• valid (boolean): Whether the token is valid
• expired (boolean): Whether the token is expired
• payload (Object|null): The decoded payload if available, null otherwise
• error (string, optional): Error message if verification failed