@buntal/core - Security

jwt

JWT (JSON Web Token) utility function for signing and verifying tokens using HS256 algorithm.

Source

View source on GitHub

Type Definition

function jwt(secret: string): {
  sign: (payload: Record<string, unknown>, options?: { expiresIn?: string | number | Date }) => Promise<string>
  verify: <T = unknown>(token: string) => Promise<T>
}

Parameters

ParameterTypeRequiredDefaultDescription
secretstring-Secret key for signing and verifying tokens

Methods

sign

Signs a JWT token with the provided payload.

Parameters

ParameterTypeRequiredDefaultDescription
payloadRecord<string, unknown>-Data to encode in the token
options{ expiresIn?: string | number | Date }-Token expiration options

Returns

Promise<string>

verify

Verifies and decodes a JWT token.

Parameters

ParameterTypeRequiredDefaultDescription
tokenstring-JWT token to verify

Returns

Promise<T>

Last modified: 2025-06-10

Content-Length: 0