useSession().session.lastActiveToken.jwt.claims has incorrect type

[ijxy]

Preliminary Checks

• I have reviewed the documentation: https://clerk.com/docs

• I have searched for existing issues: https://github.com/clerk/javascript/issues

• I have not already reached out to Clerk support via email or Discord (if you have, no need to open an issue here)

• This issue is not a question, general help request, or anything other than a bug report directly related to Clerk. Please ask questions in our Discord community: https://clerk.com/discord.

Reproduction

N/A

Publishable key

N/A

Description

useSession exposes the current token claims (including custom session claims) via:

const claims = useSession().session.lastActiveToken.jwt.claims;

However, the type of this value does not reflect the custom claims defined by the user (ie CustomJwtSessionClaims).

Proposed Solution

I believe that useSession should be using the JwtPayload type instead of the JWTClaims type, but it seems to be complicated by the fact that there are two sources of types for JWT stuff, namely the stuff in jwt.ts and jwtv2.ts.

I cannot understand why it is separated like this from the code alone (I suspect jwtv2.ts is intended for nodejs environments, and jwt.ts for the everywhere else).

That said, the headers and claims are necessarily the same in all environments, so I think it would make sense to refactor and simplify into:

• a common interface for spec-standard headers
• a common interface for just spec-standard claims
• a common interface for just Clerk-standard claims
• a common interface that combines spec + clerk + user defined claims

With that, the JWT and Jwt types can refer to the same interfaces for the headers and claims without losing the ability to target different runtime environments

Environment

N/A