1.1.0 • Published 6 months ago

pl-jwt v1.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
6 months ago

Biblioteca JWT para gerenciamento de tokens em localStorage ou sessionStorage

Esta é uma biblioteca JavaScript que oferece funcionalidades para gerenciar tokens JWT (JSON Web Tokens) em localStorage ou sessionStorage. Os dados do payload são decodificados dinamicamente, armazenando apenas o token no formato de string.

Token para teste: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjEyMzU0NjQ3NCIsIm5hbWUiOiJQYXVsbyIsImVtYWlsIjoicGF1bG9AdGVzdGV0b2tlbi5jb20iLCJyb2xlIjoiYWRtaW4ifQ.A0Bk9R9DFLeGxqPbhIUK6AHFkFGByjCID2oRJ2CmUgY

Configurações(opcionais)

JWT.name = 'Nome_do_seu_token'

Define o nome do token que será salvo

JWT.storage = true

Define se o armazenamento será em localStorage(true) ou sessionStorage(false)

JWT.setToken(token: string)

Armazena o token no localStorage ou sessionStorage.

JWT.getData(): object

Retorna o token descodificado no formato de objeto.

JWT.hasToken(): boolean

Verifica se o token existe e retorna um booleano.

JWT.getToken(): string | undefined

Retorna o token armazenado como string ou undefined se não houver token.

JWT.removeToken()

Remove o token armazenado.

JWT.permissions(permissions: array, groupsOfpermissions: object[], all: string | array): boolean

Verifica se o usuário atual está em um grupo de permissões específico. Exemplo de uso: let check = JWT.permissions('createx', [ { roles: 'admin', 'cliente', permissions: 'create', 'update' } ]) ? JWT.user('name') + " está permitido" : 'Não permitido';

JWT.auth(roles: string | array = null): boolean

Verifica se o usuário está autenticado, opcionalmente verificando o papel/tipo/função do usuário.

JWT.user(key: string, def: string = ''): any

Retorna os dados do usuário autenticado para uma chave específica ou um valor padrão se a chave não existir.

Funções Adicionais

JWT.getKey(index: string): any

Pega um índice específico do PAYLOAD do token JWT e retorna o seu valor no caso de sucesso ou undefined no caso de falha.

  • index: Índice específico a ser obtido do PAYLOAD.
  • Retorno: O valor correspondente ao índice do PAYLOAD ou undefined se não houver valor correspondente.

JWT.hasKey(index: string): boolean

Verifica se uma chave existe no PAYLOAD do token JWT armazenado e retorna um booleano indicando a existência.

  • index: Chave a ser verificada no PAYLOAD.
  • Retorno: true se a chave existir no PAYLOAD ou false se não existir.

JWT.getId(): any

Retorna o ID do usuário que está no PAYLOAD do token JWT.

  • Retorno: O ID do usuário do PAYLOAD.

JWT.getName(): any

Retorna o nome do usuário que está no PAYLOAD do token JWT.

  • Retorno: O nome do usuário do PAYLOAD.

JWT.getRole(): any

Retorna a função do usuário que está no PAYLOAD do token JWT.

  • Retorno: A função do usuário do PAYLOAD.

JWT.getEmail(): any

Retorna o e-mail do usuário que está no PAYLOAD do token JWT.

  • Retorno: O e-mail do usuário do PAYLOAD.

JWT.getFirstName(): any

Retorna o primeiro nome do usuário que está no PAYLOAD do token JWT.

  • Retorno: O primeiro nome do usuário do PAYLOAD.

JWT.getLastName(): any

Retorna o último nome do usuário que está no PAYLOAD do token JWT.

  • Retorno: O último nome do usuário do PAYLOAD.

JWT.getImage(): any

Retorna o caminho da imagem do usuário que está no PAYLOAD do token JWT.

  • Retorno: O caminho da imagem do usuário do PAYLOAD.

Observações

Esta documentação detalha os parâmetros e retornos das funções da biblioteca JWT. Certifique-se de consultar esta documentação para entender como utilizar cada função de forma adequada.

1.1.0

6 months ago

1.0.2

7 months ago

1.0.1

7 months ago