# panva/jose · Reposen Release & Migration Intelligence

> Fixes JWE stream errors, JWKS response timeouts, and JWT claim replication. Drop-in upgrade. Migration: None.

## Metadata
- **Repository URL**: https://github.com/panva/jose
- **Primary Package**: `jose` (NPM)
- **Categories**: `ECOSYSTEM`, `BACKEND`
- **Latest Version**: `v6.2.18`
- **Semantic Status**: `COMPATIBLE`
- **Bundle Size Impact (unavailable)**: `Size Unavailable`
- **Atom Ingestion Feed**: https://github.com/panva/jose/releases.atom

## The Human Context (Plain-English Pitch)
jose is a universal TypeScript and JavaScript library for cryptography operations involving JSON Web Tokens (JWT), encryption (JWE), signing (JWS), and keys (JWK). It eliminates native dependency compilation and platform-specific crypto shims by running uniformly across Node.js, Bun, Deno, browsers, and edge runtimes. This gives developers a single, standards-compliant interface for secure identity verification and payload encryption across all JavaScript environments.

## Stage 1 Executive Summary ([Core Change] + [Required Action] + [Migration Effort])
Fixes JWE stream errors, JWKS response timeouts, and JWT claim replication. Drop-in upgrade. Migration: None.

## Breaking Changes & Required Actions
- Preserves underlying errors when compression streams are unavailable during `jwe` decompression rather than obscuring failures.
- Enforces required `alg` definitions on direct AKP key inputs within the `jwk` submodule.
- Surfaces timeout errors correctly when read stalls occur during the `jwks` HTTP response body streaming.
- Normalizes mixed-case `ago` time duration strings in `jwt` claims and preserves original headers during claims replication.

## Migration Snippet
```ts
npm install jose@6.2.18
```

## Ecosystem Compatibility Matrix & Graph Warnings
- **Node.js >=18** [`COMPATIBLE`]: Operates cleanly across modern Node.js runtimes leveraging native Web Crypto APIs.
- **TypeScript >=5.0** [`COMPATIBLE`]: Includes strict type definitions without breaking changes to existing interfaces.
- **Bun >=1.0** [`COMPATIBLE`]: Fully compliant with Bun Web Crypto primitives and runtime stream readers.
- **Deno >=1.30** [`COMPATIBLE`]: Standard Web Crypto and Streams API support functions with zero polyfills.

## Zero-Noise Release Timeline
- **v6.2.18** (2026-11-18) [COMPATIBLE]: Fixes JWE stream errors, JWKS response timeouts, and JWT claim replication. Drop-in upgrade. Migration: None.

## Upgrade & Migration Q&A (GEO Direct Answers)
### Is panva/jose v6.2.18 safe to upgrade in production?
panva/jose v6.2.18 is classified as COMPATIBLE (PATCH release). Fixes JWE stream errors, JWKS response timeouts, and JWT claim replication. Drop-in upgrade. Migration: None.

### What breaking changes or compatibility risks exist in panva/jose v6.2.18?
No breaking API changes or peer dependency conflicts are recorded for panva/jose v6.2.18 in the Reposen compatibility graph.

### What is the bundle size impact of jose v6.2.18?
Measured bundle size telemetry is currently unavailable for jose v6.2.18; verify build output locally before deploying.

### How do I upgrade jose to v6.2.18?
Upgrade jose to v6.2.18 by running "npm install jose@6.2.18" and applying the migration steps: npm install jose@6.2.18
