feat(shared): Add oiat field to JwtHeader type (#8107)

nikosdouvlis · web-flow · commit 636b496e42d4 · 2026-04-03T16:15:22.000+03:00
diff --git a/.changeset/session-minter-oiat-type.md b/.changeset/session-minter-oiat-type.md
@@ -0,0 +1,5 @@
+---
+'@clerk/shared': patch
+---
+
+Add `oiat` (original_issued_at) field to `JwtHeader` type for Session Minter monotonic token freshness checks.
diff --git a/packages/shared/src/types/jwtv2.ts b/packages/shared/src/types/jwtv2.ts
@@ -25,6 +25,8 @@ export interface JwtHeader {
   'x5t#S256'?: string;
   x5t?: string;
   x5c?: string | string[];
+  /** @internal - used by Session Minter for monotonic token freshness checks. Do not depend on this field. */
+  oiat?: number;
 }
 
 declare global {

-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'@clerk/shared': patch
 +---
++
 +Add `oiat` (original_issued_at) field to `JwtHeader` type for Session Minter monotonic token freshness checks.
Original file line number	Diff line number	Diff line change
`@@ -25,6 +25,8 @@ export interface JwtHeader {`
`25`	`25`	`'x5t#S256'?: string;`
`26`	`26`	`x5t?: string;`
`27`	`27`	`x5c?: string \| string[];`
	`28`	`+ /** @internal - used by Session Minter for monotonic token freshness checks. Do not depend on this field. */`
	`29`	`+ oiat?: number;`
`28`	`30`	`}`
`29`	`31`
`30`	`32`	`declare global {`