@payez/next-mvp 4.1.7 → 4.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (154) hide show
  1. package/README.md +792 -792
  2. package/dist/auth/better-auth.js +15 -3
  3. package/dist/components/account/MobileNavDrawer.js +18 -18
  4. package/dist/components/account/UserAvatarMenu.js +1 -1
  5. package/dist/components/admin/AlertSettingsTab.js +40 -40
  6. package/dist/components/admin/LoggingSettingsTab.js +28 -28
  7. package/dist/pages/login/page.js +28 -28
  8. package/dist/pages/settings/EnhancedSettingsPage.js +17 -17
  9. package/package.json +1 -1
  10. package/scripts/dev-broker.ps1 +35 -35
  11. package/scripts/dev-local.ps1 +45 -45
  12. package/src/api/auth-handler.ts +548 -548
  13. package/src/api-handlers/account/change-password.ts +142 -142
  14. package/src/api-handlers/account/update-phone.ts +79 -79
  15. package/src/api-handlers/account/verify-email.ts +125 -125
  16. package/src/api-handlers/account/verify-sms.ts +125 -125
  17. package/src/api-handlers/admin/analytics.ts +443 -443
  18. package/src/api-handlers/admin/audit.ts +223 -223
  19. package/src/api-handlers/admin/index.ts +63 -63
  20. package/src/api-handlers/admin/redis-sessions.ts +251 -251
  21. package/src/api-handlers/admin/sessions.ts +318 -318
  22. package/src/api-handlers/admin/site-logs.ts +365 -365
  23. package/src/api-handlers/admin/users.ts +242 -242
  24. package/src/api-handlers/admin/vibe-data.ts +324 -324
  25. package/src/api-handlers/auth/refresh.ts +682 -682
  26. package/src/api-handlers/auth/signout.ts +199 -199
  27. package/src/api-handlers/auth/status.ts +20 -20
  28. package/src/api-handlers/auth/update-session.ts +110 -110
  29. package/src/api-handlers/auth/verify-code.ts +112 -112
  30. package/src/api-handlers/session/refresh-viability.ts +36 -36
  31. package/src/api-handlers/test/force-expire.ts +60 -60
  32. package/src/auth/auth-decision.ts +229 -229
  33. package/src/auth/better-auth.ts +15 -3
  34. package/src/auth/route-config.ts +219 -219
  35. package/src/auth/types/auth-types.ts +555 -555
  36. package/src/auth/types/index.ts +7 -7
  37. package/src/auth/utils/idp-client.ts +445 -445
  38. package/src/auth/utils/index.ts +6 -6
  39. package/src/auth/utils/token-utils.ts +243 -243
  40. package/src/client/AuthContext.tsx +143 -143
  41. package/src/client/fetch-with-auth.ts +47 -47
  42. package/src/components/SessionSync.tsx +138 -138
  43. package/src/components/SignalRHealthCheck.tsx +131 -131
  44. package/src/components/account/MobileNavDrawer.tsx +305 -305
  45. package/src/components/account/UserAvatarMenu.tsx +266 -266
  46. package/src/components/account/index.ts +13 -13
  47. package/src/components/admin/AlertSettingsTab.tsx +728 -728
  48. package/src/components/admin/AnalyticsTab.tsx +703 -703
  49. package/src/components/admin/DataBrowserTab.tsx +505 -505
  50. package/src/components/admin/LoggingSettingsTab.tsx +665 -665
  51. package/src/components/admin/SessionsTab.tsx +414 -414
  52. package/src/components/admin/StatsTab.tsx +379 -379
  53. package/src/components/admin/VibeAdminLayout.tsx +187 -187
  54. package/src/components/admin/index.ts +59 -59
  55. package/src/components/auth/FederatedAuthSection.tsx +95 -95
  56. package/src/components/auth/ModeAwareLoginPage.tsx +135 -135
  57. package/src/components/auth/ModeAwareSignupPage.tsx +267 -267
  58. package/src/components/auth/TraditionalAuthSection.tsx +99 -99
  59. package/src/components/recovery/CompleteStep.tsx +36 -36
  60. package/src/components/recovery/InitiateRecoveryStep.tsx +68 -68
  61. package/src/components/recovery/SelectMethodStep.tsx +73 -73
  62. package/src/components/recovery/SetPasswordStep.tsx +97 -97
  63. package/src/components/recovery/VerifyCodeStep.tsx +90 -90
  64. package/src/components/reserved/ReservedRecoveryWarning.tsx +160 -160
  65. package/src/components/reserved/ReservedStatusBox.tsx +118 -118
  66. package/src/components/ui/BetaBadge.tsx +58 -58
  67. package/src/components/ui/Footer.tsx +93 -93
  68. package/src/config/env.ts +57 -57
  69. package/src/config/logger.ts +62 -62
  70. package/src/config/vibe-log-transport.ts +264 -264
  71. package/src/hooks/useAuth.ts +117 -117
  72. package/src/hooks/useAuthSettings.ts +97 -97
  73. package/src/hooks/useAvailableProviders.ts +120 -120
  74. package/src/hooks/usePasswordValidation.ts +127 -127
  75. package/src/hooks/usePublicAuthSettings.ts +149 -149
  76. package/src/hooks/useSessionExpiration.ts +101 -101
  77. package/src/hooks/useViabilitySession.ts +336 -336
  78. package/src/index.ts +60 -60
  79. package/src/lib/api-handler.ts +643 -643
  80. package/src/lib/app-slug.ts +178 -178
  81. package/src/lib/geolocation.ts +265 -265
  82. package/src/lib/idp-fetch.ts +110 -110
  83. package/src/lib/jwt-decode.ts +82 -82
  84. package/src/lib/roles.ts +177 -177
  85. package/src/lib/site-logger.ts +245 -245
  86. package/src/lib/standardized-client-api.ts +901 -901
  87. package/src/lib/test-aware-get-token.ts +41 -41
  88. package/src/lib/user-agent-parser.ts +252 -252
  89. package/src/logging/api/admin-analytics.ts +51 -51
  90. package/src/logging/api/audit-log.ts +53 -53
  91. package/src/logging/components/AdminAnalyticsLayout.tsx +49 -49
  92. package/src/logging/components/AuditLogViewer.tsx +125 -125
  93. package/src/logging/components/ErrorMetricsCard.tsx +98 -98
  94. package/src/logging/components/HealthMetricsCard.tsx +70 -70
  95. package/src/logging/hooks/useAdminAnalytics.ts +22 -22
  96. package/src/logging/hooks/useAuditLog.ts +24 -24
  97. package/src/logging/hooks/useErrorMetrics.ts +40 -40
  98. package/src/logging/hooks/useHealthMetrics.ts +44 -44
  99. package/src/logging/index.ts +18 -18
  100. package/src/logging/types/analytics.ts +81 -81
  101. package/src/logging/types/audit.ts +31 -31
  102. package/src/logging/types/index.ts +3 -3
  103. package/src/middleware/create-middleware.ts +663 -663
  104. package/src/middleware/rbac-check.ts +279 -279
  105. package/src/middleware/twofa-presets.ts +224 -224
  106. package/src/pages/admin-login/page.tsx +221 -221
  107. package/src/pages/admin-page-permissions/PagePermissionsAdminPage.tsx +527 -527
  108. package/src/pages/admin-page-permissions/index.ts +7 -7
  109. package/src/pages/admin-roles/RolesAdminPage.tsx +533 -533
  110. package/src/pages/admin-roles/modals.tsx +469 -469
  111. package/src/pages/client-admin/ClientSiteAdminPage.tsx +382 -382
  112. package/src/pages/client-admin/index.ts +33 -33
  113. package/src/pages/coming-soon/page.tsx +83 -83
  114. package/src/pages/login/page.tsx +456 -456
  115. package/src/pages/profile/EnhancedProfilePage.tsx +485 -485
  116. package/src/pages/profile/index.ts +9 -9
  117. package/src/pages/profile/page.tsx +166 -166
  118. package/src/pages/recovery/page.tsx +234 -234
  119. package/src/pages/roles/MyRolesPage.tsx +211 -211
  120. package/src/pages/roles/components.tsx +294 -294
  121. package/src/pages/roles/index.ts +17 -17
  122. package/src/pages/security/EnhancedSecurityPage.tsx +565 -565
  123. package/src/pages/security/index.ts +9 -9
  124. package/src/pages/security/page.tsx +507 -507
  125. package/src/pages/settings/EnhancedSettingsPage.tsx +642 -642
  126. package/src/pages/settings/index.ts +9 -9
  127. package/src/pages/settings/page.tsx +47 -47
  128. package/src/pages/showcase/ShowcasePage.tsx +532 -532
  129. package/src/pages/showcase/index.ts +13 -13
  130. package/src/pages/test-env/EmergencyLogoutPage.tsx +180 -180
  131. package/src/pages/test-env/JwtInspectPage.tsx +456 -456
  132. package/src/pages/test-env/RefreshTokenPage.tsx +157 -157
  133. package/src/pages/test-env/TestEnvPage.tsx +118 -118
  134. package/src/pages/test-env/index.ts +25 -25
  135. package/src/pages/verify-code/page.tsx +652 -652
  136. package/src/routes/account/update-phone.ts +13 -13
  137. package/src/routes/auth/logout.ts +108 -108
  138. package/src/routes/auth/nextauth.ts +45 -45
  139. package/src/routes/auth/settings.ts +75 -75
  140. package/src/routes/auth/viability.ts +224 -224
  141. package/src/server/auth-guard.ts +170 -170
  142. package/src/server/slim-middleware.ts +117 -117
  143. package/src/server/with-auth.ts +93 -93
  144. package/src/stores/authStore.ts +1899 -1899
  145. package/src/templates/instrumentation.ts +41 -41
  146. package/src/utils/logout.ts +30 -30
  147. package/src/vibe/client.ts +590 -590
  148. package/src/vibe/enterprise-auth.ts +208 -208
  149. package/src/vibe/errors.ts +185 -185
  150. package/src/vibe/generic.ts +431 -431
  151. package/src/vibe/hooks/index.ts +367 -367
  152. package/src/vibe/index.ts +132 -132
  153. package/src/vibe/sessions.ts +551 -551
  154. package/src/vibe/types.ts +577 -577
@@ -1,111 +1,111 @@
1
- import { NextRequest } from 'next/server';
2
- import { getTokenTestAware } from './test-aware-get-token';
3
- import { getSession } from './session-store';
4
- import { internalRefresh } from './internal-api';
5
-
6
- /**
7
- * Centralized IDP fetch helper
8
- * - Injects Bearer from Redis session
9
- * - If access token is expired/near-expiry, triggers one refresh and retries fetch once
10
- * - Returns parsed JSON and HTTP status
11
- */
12
- export interface IdpFetchResult<T = any> {
13
- ok: boolean;
14
- status: number;
15
- json: T | null;
16
- attemptedRefresh: boolean;
17
- }
18
-
19
- function buildHeaders(req: NextRequest, bearer?: string, extra?: Record<string, string>) {
20
- const headers: Record<string, string> = {
21
- Accept: 'application/json',
22
- 'Content-Type': 'application/json',
23
- ...extra,
24
- };
25
- const xfwd = req.headers.get('x-forwarded-for') || req.headers.get('x-real-ip');
26
- if (xfwd) headers['X-Forwarded-For'] = xfwd.split(',')[0].trim();
27
- const ua = req.headers.get('user-agent');
28
- if (ua) headers['User-Agent'] = ua;
29
- if (bearer) headers['Authorization'] = `Bearer ${bearer}`;
30
- return headers;
31
- }
32
-
33
- async function ensureFreshAccessToken(req: NextRequest): Promise<{ sessionToken?: string; accessToken?: string }> {
34
- const token = await getTokenTestAware(req);
35
- // Support both field names: sessionToken (auth.ts JWT) and redisSessionId (legacy)
36
- const sessionToken = (token?.sessionToken || token?.redisSessionId) as string | undefined;
37
- console.log('[IDP_FETCH] ensureFreshAccessToken:', {
38
- hasToken: !!token,
39
- sessionToken: sessionToken?.substring(0, 20) + '...',
40
- pathname: req.nextUrl.pathname
41
- });
42
- if (!sessionToken) {
43
- console.warn('[IDP_FETCH] No sessionToken found in JWT - Bearer token will NOT be sent!');
44
- return {};
45
- }
46
- let session = await getSession(sessionToken);
47
- // Fall back to Better Auth: decode session from cookies to get IDP tokens
48
- if (!session?.idpAccessToken) {
49
- try {
50
- const { decodeSession } = await import('../server/decode-session');
51
- const decoded = await decodeSession(req.cookies);
52
- if (decoded?.sessionData?.idpAccessToken) {
53
- session = decoded.sessionData;
54
- }
55
- } catch { /* decodeSession unavailable in edge */ }
56
- }
57
- console.log('[IDP_FETCH] Redis session lookup:', {
58
- hasSession: !!session,
59
- hasAccessToken: !!session?.idpAccessToken,
60
- bearerKeyId: session?.bearerKeyId || 'NOT_SET',
61
- idpClientId: session?.idpClientId || 'NOT_SET',
62
- });
63
- if (!session?.idpAccessToken) return { sessionToken };
64
- const now = Date.now();
65
- const timeLeft = (session.idpAccessTokenExpires ?? now) - now;
66
- // Treat tokens as effectively expired if within 5 minutes of expiry
67
- if (timeLeft > 5 * 60 * 1000) {
68
- return { sessionToken, accessToken: session.idpAccessToken };
69
- }
70
- // attempt refresh once via centralized internal API helper
71
- try {
72
- await internalRefresh(req.headers.get('cookie') || '', sessionToken);
73
- } catch {}
74
- session = await getSession(sessionToken);
75
- return { sessionToken, accessToken: session?.idpAccessToken };
76
- }
77
-
78
- export async function idpFetchJSON<T = any>(
79
- req: NextRequest,
80
- targetUrl: string,
81
- init: RequestInit = {}
82
- ): Promise<IdpFetchResult<T>> {
83
- let attemptedRefresh = false;
84
- let { accessToken, sessionToken } = await ensureFreshAccessToken(req);
85
-
86
- const makeCall = async (bearer?: string) => {
87
- const res = await fetch(targetUrl, {
88
- ...init,
89
- headers: buildHeaders(req, bearer, init.headers as any),
90
- });
91
- let json: any = null;
92
- try { json = await res.json(); } catch { json = null; }
93
- return { res, json } as const;
94
- };
95
-
96
- // First attempt
97
- let { res, json } = await makeCall(accessToken);
98
- if ((res.status === 401 || res.status === 403) && sessionToken && !attemptedRefresh) {
99
- attemptedRefresh = true;
100
- try {
101
- // Use centralized internal API helper for server-to-server calls
102
- const rf = await internalRefresh(req.headers.get('cookie') || '', sessionToken);
103
- if (rf.ok) {
104
- const fresh = await getSession(sessionToken);
105
- ({ res, json } = await makeCall(fresh?.idpAccessToken));
106
- }
107
- } catch {}
108
- }
109
-
110
- return { ok: res.ok, status: res.status, json: json as T | null, attemptedRefresh };
1
+ import { NextRequest } from 'next/server';
2
+ import { getTokenTestAware } from './test-aware-get-token';
3
+ import { getSession } from './session-store';
4
+ import { internalRefresh } from './internal-api';
5
+
6
+ /**
7
+ * Centralized IDP fetch helper
8
+ * - Injects Bearer from Redis session
9
+ * - If access token is expired/near-expiry, triggers one refresh and retries fetch once
10
+ * - Returns parsed JSON and HTTP status
11
+ */
12
+ export interface IdpFetchResult<T = any> {
13
+ ok: boolean;
14
+ status: number;
15
+ json: T | null;
16
+ attemptedRefresh: boolean;
17
+ }
18
+
19
+ function buildHeaders(req: NextRequest, bearer?: string, extra?: Record<string, string>) {
20
+ const headers: Record<string, string> = {
21
+ Accept: 'application/json',
22
+ 'Content-Type': 'application/json',
23
+ ...extra,
24
+ };
25
+ const xfwd = req.headers.get('x-forwarded-for') || req.headers.get('x-real-ip');
26
+ if (xfwd) headers['X-Forwarded-For'] = xfwd.split(',')[0].trim();
27
+ const ua = req.headers.get('user-agent');
28
+ if (ua) headers['User-Agent'] = ua;
29
+ if (bearer) headers['Authorization'] = `Bearer ${bearer}`;
30
+ return headers;
31
+ }
32
+
33
+ async function ensureFreshAccessToken(req: NextRequest): Promise<{ sessionToken?: string; accessToken?: string }> {
34
+ const token = await getTokenTestAware(req);
35
+ // Support both field names: sessionToken (auth.ts JWT) and redisSessionId (legacy)
36
+ const sessionToken = (token?.sessionToken || token?.redisSessionId) as string | undefined;
37
+ console.log('[IDP_FETCH] ensureFreshAccessToken:', {
38
+ hasToken: !!token,
39
+ sessionToken: sessionToken?.substring(0, 20) + '...',
40
+ pathname: req.nextUrl.pathname
41
+ });
42
+ if (!sessionToken) {
43
+ console.warn('[IDP_FETCH] No sessionToken found in JWT - Bearer token will NOT be sent!');
44
+ return {};
45
+ }
46
+ let session = await getSession(sessionToken);
47
+ // Fall back to Better Auth: decode session from cookies to get IDP tokens
48
+ if (!session?.idpAccessToken) {
49
+ try {
50
+ const { decodeSession } = await import('../server/decode-session');
51
+ const decoded = await decodeSession(req.cookies);
52
+ if (decoded?.sessionData?.idpAccessToken) {
53
+ session = decoded.sessionData;
54
+ }
55
+ } catch { /* decodeSession unavailable in edge */ }
56
+ }
57
+ console.log('[IDP_FETCH] Redis session lookup:', {
58
+ hasSession: !!session,
59
+ hasAccessToken: !!session?.idpAccessToken,
60
+ bearerKeyId: session?.bearerKeyId || 'NOT_SET',
61
+ idpClientId: session?.idpClientId || 'NOT_SET',
62
+ });
63
+ if (!session?.idpAccessToken) return { sessionToken };
64
+ const now = Date.now();
65
+ const timeLeft = (session.idpAccessTokenExpires ?? now) - now;
66
+ // Treat tokens as effectively expired if within 5 minutes of expiry
67
+ if (timeLeft > 5 * 60 * 1000) {
68
+ return { sessionToken, accessToken: session.idpAccessToken };
69
+ }
70
+ // attempt refresh once via centralized internal API helper
71
+ try {
72
+ await internalRefresh(req.headers.get('cookie') || '', sessionToken);
73
+ } catch {}
74
+ session = await getSession(sessionToken);
75
+ return { sessionToken, accessToken: session?.idpAccessToken };
76
+ }
77
+
78
+ export async function idpFetchJSON<T = any>(
79
+ req: NextRequest,
80
+ targetUrl: string,
81
+ init: RequestInit = {}
82
+ ): Promise<IdpFetchResult<T>> {
83
+ let attemptedRefresh = false;
84
+ let { accessToken, sessionToken } = await ensureFreshAccessToken(req);
85
+
86
+ const makeCall = async (bearer?: string) => {
87
+ const res = await fetch(targetUrl, {
88
+ ...init,
89
+ headers: buildHeaders(req, bearer, init.headers as any),
90
+ });
91
+ let json: any = null;
92
+ try { json = await res.json(); } catch { json = null; }
93
+ return { res, json } as const;
94
+ };
95
+
96
+ // First attempt
97
+ let { res, json } = await makeCall(accessToken);
98
+ if ((res.status === 401 || res.status === 403) && sessionToken && !attemptedRefresh) {
99
+ attemptedRefresh = true;
100
+ try {
101
+ // Use centralized internal API helper for server-to-server calls
102
+ const rf = await internalRefresh(req.headers.get('cookie') || '', sessionToken);
103
+ if (rf.ok) {
104
+ const fresh = await getSession(sessionToken);
105
+ ({ res, json } = await makeCall(fresh?.idpAccessToken));
106
+ }
107
+ } catch {}
108
+ }
109
+
110
+ return { ok: res.ok, status: res.status, json: json as T | null, attemptedRefresh };
111
111
  }
@@ -1,83 +1,83 @@
1
- import { jwtDecode as originalJwtDecode } from 'jwt-decode';
2
-
3
- // Define JwtPayload interface since jwt-decode v4 doesn't export it
4
- export interface JwtPayload {
5
- iss?: string;
6
- sub?: string;
7
- aud?: string[] | string;
8
- exp?: number;
9
- nbf?: number;
10
- iat?: number;
11
- jti?: string;
12
- }
13
-
14
- /**
15
- * JWT Header structure.
16
- * Contains metadata about the token including the signing key ID.
17
- */
18
- export interface JwtHeader {
19
- /** Algorithm used to sign the token (e.g., 'RS256', 'HS256') */
20
- alg: string;
21
- /** Token type (typically 'JWT') */
22
- typ?: string;
23
- /** Key ID - identifies which key was used to sign this token */
24
- kid?: string;
25
- /** Content type */
26
- cty?: string;
27
- }
28
-
29
- /**
30
- * Decode JWT payload (standard claims).
31
- * This is a thin wrapper around jwt-decode library.
32
- */
33
- export function jwtDecode<T = JwtPayload>(token: string): T {
34
- return originalJwtDecode<T>(token);
35
- }
36
-
37
- /**
38
- * Decode JWT header to extract kid, alg, and other header claims.
39
- *
40
- * The JWT header contains critical information:
41
- * - kid: Key ID used to sign the token (needed for key governance)
42
- * - alg: Algorithm used for signing
43
- * - typ: Token type
44
- *
45
- * @param token - The JWT token string
46
- * @returns Decoded header or null if decoding fails
47
- */
48
- export function decodeJwtHeader(token: string): JwtHeader | null {
49
- try {
50
- if (!token || typeof token !== 'string') {
51
- return null;
52
- }
53
-
54
- const parts = token.split('.');
55
- if (parts.length !== 3) {
56
- console.warn('[JWT_DECODE] Invalid JWT structure - expected 3 parts, got', parts.length);
57
- return null;
58
- }
59
-
60
- // Decode base64url header (part 0)
61
- const headerB64 = parts[0].replace(/-/g, '+').replace(/_/g, '/');
62
- const headerJson = typeof atob !== 'undefined'
63
- ? atob(headerB64)
64
- : Buffer.from(headerB64, 'base64').toString('utf-8');
65
-
66
- return JSON.parse(headerJson) as JwtHeader;
67
- } catch (error) {
68
- console.error('[JWT_DECODE] Failed to decode JWT header:', error);
69
- return null;
70
- }
71
- }
72
-
73
- /**
74
- * Extract just the kid (Key ID) from a JWT token.
75
- * Convenience function for when you only need the key ID.
76
- *
77
- * @param token - The JWT token string
78
- * @returns The kid value or undefined if not present/decodable
79
- */
80
- export function extractKidFromToken(token: string): string | undefined {
81
- const header = decodeJwtHeader(token);
82
- return header?.kid;
1
+ import { jwtDecode as originalJwtDecode } from 'jwt-decode';
2
+
3
+ // Define JwtPayload interface since jwt-decode v4 doesn't export it
4
+ export interface JwtPayload {
5
+ iss?: string;
6
+ sub?: string;
7
+ aud?: string[] | string;
8
+ exp?: number;
9
+ nbf?: number;
10
+ iat?: number;
11
+ jti?: string;
12
+ }
13
+
14
+ /**
15
+ * JWT Header structure.
16
+ * Contains metadata about the token including the signing key ID.
17
+ */
18
+ export interface JwtHeader {
19
+ /** Algorithm used to sign the token (e.g., 'RS256', 'HS256') */
20
+ alg: string;
21
+ /** Token type (typically 'JWT') */
22
+ typ?: string;
23
+ /** Key ID - identifies which key was used to sign this token */
24
+ kid?: string;
25
+ /** Content type */
26
+ cty?: string;
27
+ }
28
+
29
+ /**
30
+ * Decode JWT payload (standard claims).
31
+ * This is a thin wrapper around jwt-decode library.
32
+ */
33
+ export function jwtDecode<T = JwtPayload>(token: string): T {
34
+ return originalJwtDecode<T>(token);
35
+ }
36
+
37
+ /**
38
+ * Decode JWT header to extract kid, alg, and other header claims.
39
+ *
40
+ * The JWT header contains critical information:
41
+ * - kid: Key ID used to sign the token (needed for key governance)
42
+ * - alg: Algorithm used for signing
43
+ * - typ: Token type
44
+ *
45
+ * @param token - The JWT token string
46
+ * @returns Decoded header or null if decoding fails
47
+ */
48
+ export function decodeJwtHeader(token: string): JwtHeader | null {
49
+ try {
50
+ if (!token || typeof token !== 'string') {
51
+ return null;
52
+ }
53
+
54
+ const parts = token.split('.');
55
+ if (parts.length !== 3) {
56
+ console.warn('[JWT_DECODE] Invalid JWT structure - expected 3 parts, got', parts.length);
57
+ return null;
58
+ }
59
+
60
+ // Decode base64url header (part 0)
61
+ const headerB64 = parts[0].replace(/-/g, '+').replace(/_/g, '/');
62
+ const headerJson = typeof atob !== 'undefined'
63
+ ? atob(headerB64)
64
+ : Buffer.from(headerB64, 'base64').toString('utf-8');
65
+
66
+ return JSON.parse(headerJson) as JwtHeader;
67
+ } catch (error) {
68
+ console.error('[JWT_DECODE] Failed to decode JWT header:', error);
69
+ return null;
70
+ }
71
+ }
72
+
73
+ /**
74
+ * Extract just the kid (Key ID) from a JWT token.
75
+ * Convenience function for when you only need the key ID.
76
+ *
77
+ * @param token - The JWT token string
78
+ * @returns The kid value or undefined if not present/decodable
79
+ */
80
+ export function extractKidFromToken(token: string): string | undefined {
81
+ const header = decodeJwtHeader(token);
82
+ return header?.kid;
83
83
  }