Fasteer.js JWT

Small wrapper class around jsonwebtoken for JWT tokens.

Getting Started

This library is a Fasteer plugin. All you need to do is install it and register it.

Installation

$ npm i @fasteerjs/jwt
# or if you are using Yarn
$ yarn add @fasteerjs/jwt

Registering

import { hookFastify } from "@fasteerjs/fasteer"
// -- or -- const { hookFastify } = require("@fasteerjs/fasteer")

import fasteerJwt from "@fasteerjs/jwt"
// -- or -- const { fasteerJwt } = require("../dist")

const fasteer = hookFastify({}) // the Fasteer instance

fasteer.plugin(fasteerJwt({ secret: "theJwtSecret" }))

Usage

Creating JWT tokens

You can use the sign(payload: string | object) function to create JWT tokens.

const HelloController = async (fastify, { $jwt }) => {
  fastify.get("/new-token", async (req, res) => {
    // .. your route logic
    const token = $jwt.sign({ the: "payload" }) // your new JWT token
  })
}

export default HelloController

Decoding JWT tokens

You can use the decode(token: string, verify: boolean = true) function to decode JWT tokens. When verify is set to true (by default it is), the token signature is verified (using jsonwebtoken's verify function).

const HelloController = async (fastify, { $jwt }) => {
  // warning: having the token in the URL is insecure!   
  fastify.get("/check-token/:token", async (req, res) => {
    // .. your route logic
    const payload = $jwt.decode(req.params.token)
  })
}

export default HelloController

---

2021 © Froneb s.r.o. and Filip Vottus – Licensed under MIT (see the LICENSE file).