@nats-io/jwt
v0.1.0
Published
NATS jwt.js
Readme
jwt.js
JWT tokens signed using nkeys for Ed25519 for the NATS JavaScript ecosystem.
Very Important Disclaimer
This repository provides an API to build NATS JWTs using JavaScript. However, at this time it is not a supported API. Use at your own risk.
One important take away from this project is that the purpose of the library is for building JWTs, not to validate them exhaustively. This means that tokens generated by this library are expected to be validated by a process that uses the NATS JWT Go library. As that library is the one used by:
Under that context, ultimate validity of the JWT is delegated to tools or servers that use the NATS JWT Go library. Use of this library implies an agreement with the above disclaimer.
Installation
This module is distributed in two different registries:
- npm a node-specific library supporting CJS (
require) and ESM (import) for node specific projects - jsr a node and other ESM (
import) compatible runtimes (deno, browser, node)
If your application doesn't use require, you can simply depend on the JSR
version.
NPM
The NPM registry hosts a node-only compatible version of the library supporting both CJS and ESM:
npm install @nats-io/nats-coreJSR
The JSR registry hosts the ESM-only version of the library.
deno add jsr:@nats-io/jwtnpx jsr add @nats-io/jwtyarn dlx jsr add @nats-io/jwtbunx jsr add @nats-io/jwtAPI
The API of this library requires knowledge of the NATS JWT entities.
How use it
For now please look at the tests, and investigate the source.
