Brunobkr/llama.cpp_AlgMor24_github

1# jose2 3`jose` is a JavaScript module for JSON Object Signing and Encryption, providing support for JSON Web Tokens (JWT), JSON Web Signature (JWS), JSON Web Encryption (JWE), JSON Web Key (JWK), JSON Web Key Set (JWKS), and more. The module is designed to work across various Web-interoperable runtimes including Node.js, browsers, Cloudflare Workers, Deno, Bun, and others.4 5## Sponsor6 7<picture>8  <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/panva/jose/HEAD/sponsor/Auth0byOkta_dark.png">9  <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/panva/jose/HEAD/sponsor/Auth0byOkta_light.png">10  <img height="65" align="left" alt="Auth0 by Okta" src="https://raw.githubusercontent.com/panva/jose/HEAD/sponsor/Auth0byOkta_light.png">11</picture>12 13If you want to quickly add JWT authentication to JavaScript apps, feel free to check out Auth0's JavaScript SDK and free plan. [Create an Auth0 account; it's free!][sponsor-auth0]<br><br>14 15## [💗 Help the project](https://github.com/sponsors/panva)16 17Support from the community to continue maintaining and improving this module is welcome. If you find the module useful, please consider supporting the project by [becoming a sponsor](https://github.com/sponsors/panva).18 19## Dependencies: 020 21`jose` has no dependencies and it exports tree-shakeable ESM[^cjs].22 23## Documentation24 25`jose` is distributed via [npmjs.com](https://www.npmjs.com/package/jose), [jsr.io](https://jsr.io/@panva/jose), [jsdelivr.com](https://www.jsdelivr.com/package/npm/jose), and [github.com](https://github.com/panva/jose).26 27**`example`** ESM import[^cjs]28 29```js30import * as jose from 'jose'31```32 33### JSON Web Tokens (JWT)34 35The `jose` module supports JSON Web Tokens (JWT) and provides functionality for signing and verifying tokens, as well as their JWT Claims Set validation.36 37- [JWT Claims Set Validation & Signature Verification](docs/jwt/verify/functions/jwtVerify.md) using the `jwtVerify` function38  - [Using a remote JSON Web Key Set (JWKS)](docs/jwks/remote/functions/createRemoteJWKSet.md)39  - [Using a local JSON Web Key Set (JWKS)](docs/jwks/local/functions/createLocalJWKSet.md)40- [Signing](docs/jwt/sign/classes/SignJWT.md) using the `SignJWT` class41- Utility functions42  - [Decoding Token's Protected Header](docs/util/decode_protected_header/functions/decodeProtectedHeader.md)43  - [Decoding JWT Claims Set](docs/util/decode_jwt/functions/decodeJwt.md) prior to its validation44 45### Encrypted JSON Web Tokens46 47The `jose` module supports encrypted JSON Web Tokens and provides functionality for encrypting and decrypting tokens, as well as their JWT Claims Set validation.48 49- [Decryption & JWT Claims Set Validation](docs/jwt/decrypt/functions/jwtDecrypt.md) using the `jwtDecrypt` function50- [Encryption](docs/jwt/encrypt/classes/EncryptJWT.md) using the `EncryptJWT` class51- Utility functions52  - [Decoding Token's Protected Header](docs/util/decode_protected_header/functions/decodeProtectedHeader.md)53 54### Key Utilities55 56The `jose` module supports importing, exporting, and generating keys and secrets in various formats, including PEM formats like SPKI, X.509 certificate, and PKCS #8, as well as JSON Web Key (JWK).57 58- Key Import Functions59  - [JWK Import](docs/key/import/functions/importJWK.md)60  - [Public Key Import (SPKI)](docs/key/import/functions/importSPKI.md)61  - [Public Key Import (X.509 Certificate)](docs/key/import/functions/importX509.md)62  - [Private Key Import (PKCS #8)](docs/key/import/functions/importPKCS8.md)63- Key and Secret Generation Functions64  - [Asymmetric Key Pair Generation](docs/key/generate_key_pair/functions/generateKeyPair.md)65  - [Symmetric Secret Generation](docs/key/generate_secret/functions/generateSecret.md)66- Key Export Functions67  - [JWK Export](docs/key/export/functions/exportJWK.md)68  - [Private Key Export](docs/key/export/functions/exportPKCS8.md)69  - [Public Key Export](docs/key/export/functions/exportSPKI.md)70 71### JSON Web Signature (JWS)72 73The `jose` module supports signing and verification of JWS messages with arbitrary payloads in Compact, Flattened JSON, and General JSON serialization syntaxes.74 75- Signing - [Compact](docs/jws/compact/sign/classes/CompactSign.md), [Flattened JSON](docs/jws/flattened/sign/classes/FlattenedSign.md), [General JSON](docs/jws/general/sign/classes/GeneralSign.md)76- Verification - [Compact](docs/jws/compact/verify/functions/compactVerify.md), [Flattened JSON](docs/jws/flattened/verify/functions/flattenedVerify.md), [General JSON](docs/jws/general/verify/functions/generalVerify.md)77  - [Using a remote JSON Web Key Set (JWKS)](docs/jwks/remote/functions/createRemoteJWKSet.md)78  - [Using a local JSON Web Key Set (JWKS)](docs/jwks/local/functions/createLocalJWKSet.md)79- Utility functions80  - [Decoding Token's Protected Header](docs/util/decode_protected_header/functions/decodeProtectedHeader.md)81 82### JSON Web Encryption (JWE)83 84The `jose` module supports encryption and decryption of JWE messages with arbitrary plaintext in Compact, Flattened JSON, and General JSON serialization syntaxes.85 86- Encryption - [Compact](docs/jwe/compact/encrypt/classes/CompactEncrypt.md), [Flattened JSON](docs/jwe/flattened/encrypt/classes/FlattenedEncrypt.md), [General JSON](docs/jwe/general/encrypt/classes/GeneralEncrypt.md)87- Decryption - [Compact](docs/jwe/compact/decrypt/functions/compactDecrypt.md), [Flattened JSON](docs/jwe/flattened/decrypt/functions/flattenedDecrypt.md), [General JSON](docs/jwe/general/decrypt/functions/generalDecrypt.md)88- Utility functions89  - [Decoding Token's Protected Header](docs/util/decode_protected_header/functions/decodeProtectedHeader.md)90 91### Other92 93The following are additional features and utilities provided by the `jose` module:94 95- [Calculating JWK Thumbprint](docs/jwk/thumbprint/functions/calculateJwkThumbprint.md)96- [Calculating JWK Thumbprint URI](docs/jwk/thumbprint/functions/calculateJwkThumbprintUri.md)97- [Verification using a JWK Embedded in a JWS Header](docs/jwk/embedded/functions/EmbeddedJWK.md)98- [Unsecured JWT](docs/jwt/unsecured/classes/UnsecuredJWT.md)99- [JOSE Errors](docs/util/errors/README.md)100 101## Supported Runtimes102 103The `jose` module is compatible with JavaScript runtimes that support the utilized Web API globals and standard built-in objects or are Node.js.104 105The following runtimes are supported _(this is not an exhaustive list)_:106 107- [Bun](https://github.com/panva/jose/issues/471)108- [Browsers](https://github.com/panva/jose/issues/263)109- [Cloudflare Workers](https://github.com/panva/jose/issues/265)110- [Deno](https://github.com/panva/jose/issues/266)111- [Electron](https://github.com/panva/jose/issues/264)112- [Node.js](https://github.com/panva/jose/issues/262)113 114Please note that certain algorithms may not be available depending on the runtime used. You can find a list of available algorithms for each runtime in the specific issue links provided above.115 116## Supported Versions117 118| Version                                         | Security Fixes 🔑 | Other Bug Fixes 🐞 | New Features ⭐ | Runtime and Module type         |119| ----------------------------------------------- | ----------------- | ------------------ | --------------- | ------------------------------- |120| [v6.x](https://github.com/panva/jose/tree/v6.x) | [Security Policy] | ✅                 | ✅              | Universal[^universal] ESM[^cjs] |121| [v5.x](https://github.com/panva/jose/tree/v5.x) | [Security Policy] | ❌                 | ❌              | Universal[^universal] CJS + ESM |122| [v4.x](https://github.com/panva/jose/tree/v4.x) | [Security Policy] | ❌                 | ❌              | Universal[^universal] CJS + ESM |123| [v2.x](https://github.com/panva/jose/tree/v2.x) | [Security Policy] | ❌                 | ❌              | Node.js CJS                     |124 125## Specifications126 127<details>128<summary>Details</summary>129 130- JSON Web Signature (JWS) - [RFC7515](https://www.rfc-editor.org/rfc/rfc7515)131- JSON Web Encryption (JWE) - [RFC7516](https://www.rfc-editor.org/rfc/rfc7516)132- JSON Web Key (JWK) - [RFC7517](https://www.rfc-editor.org/rfc/rfc7517)133- JSON Web Algorithms (JWA) - [RFC7518](https://www.rfc-editor.org/rfc/rfc7518)134- JSON Web Token (JWT) - [RFC7519](https://www.rfc-editor.org/rfc/rfc7519)135- JSON Web Key Thumbprint - [RFC7638](https://www.rfc-editor.org/rfc/rfc7638)136- JSON Web Key Thumbprint URI - [RFC9278](https://www.rfc-editor.org/rfc/rfc9278)137- JWS Unencoded Payload Option - [RFC7797](https://www.rfc-editor.org/rfc/rfc7797)138- CFRG Elliptic Curve ECDH and Signatures - [RFC8037](https://www.rfc-editor.org/rfc/rfc8037)139- Fully-Specified Algorithms for JOSE - [RFC9864](https://www.rfc-editor.org/rfc/rfc9864.html)140- ML-DSA for JOSE - [draft-ietf-cose-dilithium-10](https://www.ietf.org/archive/id/draft-ietf-cose-dilithium-10.html)141 142The algorithm implementations in `jose` have been tested using test vectors from their respective specifications as well as [RFC7520](https://www.rfc-editor.org/rfc/rfc7520).143 144</details>145 146[sponsor-auth0]: https://a0.to/signup/panva147[WebCryptoAPI]: https://w3c.github.io/webcrypto/148[Fetch API]: https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API149[Security Policy]: https://github.com/panva/jose/security/policy150 151[^cjs]: CJS style `let jose = require('jose')` is possible in Node.js versions where the `require(esm)` feature is enabled by default (^20.19.0 || ^22.12.0 || >= 23.0.0).152 153[^universal]: Assumes runtime support of [WebCryptoAPI][] and [Fetch API][]154