@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.
- package/README.md +792 -792
- package/dist/auth/better-auth.js +15 -3
- package/dist/components/account/MobileNavDrawer.js +18 -18
- package/dist/components/account/UserAvatarMenu.js +1 -1
- package/dist/components/admin/AlertSettingsTab.js +40 -40
- package/dist/components/admin/LoggingSettingsTab.js +28 -28
- package/dist/pages/login/page.js +28 -28
- package/dist/pages/settings/EnhancedSettingsPage.js +17 -17
- package/package.json +1 -1
- package/scripts/dev-broker.ps1 +35 -35
- package/scripts/dev-local.ps1 +45 -45
- package/src/api/auth-handler.ts +548 -548
- package/src/api-handlers/account/change-password.ts +142 -142
- package/src/api-handlers/account/update-phone.ts +79 -79
- package/src/api-handlers/account/verify-email.ts +125 -125
- package/src/api-handlers/account/verify-sms.ts +125 -125
- package/src/api-handlers/admin/analytics.ts +443 -443
- package/src/api-handlers/admin/audit.ts +223 -223
- package/src/api-handlers/admin/index.ts +63 -63
- package/src/api-handlers/admin/redis-sessions.ts +251 -251
- package/src/api-handlers/admin/sessions.ts +318 -318
- package/src/api-handlers/admin/site-logs.ts +365 -365
- package/src/api-handlers/admin/users.ts +242 -242
- package/src/api-handlers/admin/vibe-data.ts +324 -324
- package/src/api-handlers/auth/refresh.ts +682 -682
- package/src/api-handlers/auth/signout.ts +199 -199
- package/src/api-handlers/auth/status.ts +20 -20
- package/src/api-handlers/auth/update-session.ts +110 -110
- package/src/api-handlers/auth/verify-code.ts +112 -112
- package/src/api-handlers/session/refresh-viability.ts +36 -36
- package/src/api-handlers/test/force-expire.ts +60 -60
- package/src/auth/auth-decision.ts +229 -229
- package/src/auth/better-auth.ts +15 -3
- package/src/auth/route-config.ts +219 -219
- package/src/auth/types/auth-types.ts +555 -555
- package/src/auth/types/index.ts +7 -7
- package/src/auth/utils/idp-client.ts +445 -445
- package/src/auth/utils/index.ts +6 -6
- package/src/auth/utils/token-utils.ts +243 -243
- package/src/client/AuthContext.tsx +143 -143
- package/src/client/fetch-with-auth.ts +47 -47
- package/src/components/SessionSync.tsx +138 -138
- package/src/components/SignalRHealthCheck.tsx +131 -131
- package/src/components/account/MobileNavDrawer.tsx +305 -305
- package/src/components/account/UserAvatarMenu.tsx +266 -266
- package/src/components/account/index.ts +13 -13
- package/src/components/admin/AlertSettingsTab.tsx +728 -728
- package/src/components/admin/AnalyticsTab.tsx +703 -703
- package/src/components/admin/DataBrowserTab.tsx +505 -505
- package/src/components/admin/LoggingSettingsTab.tsx +665 -665
- package/src/components/admin/SessionsTab.tsx +414 -414
- package/src/components/admin/StatsTab.tsx +379 -379
- package/src/components/admin/VibeAdminLayout.tsx +187 -187
- package/src/components/admin/index.ts +59 -59
- package/src/components/auth/FederatedAuthSection.tsx +95 -95
- package/src/components/auth/ModeAwareLoginPage.tsx +135 -135
- package/src/components/auth/ModeAwareSignupPage.tsx +267 -267
- package/src/components/auth/TraditionalAuthSection.tsx +99 -99
- package/src/components/recovery/CompleteStep.tsx +36 -36
- package/src/components/recovery/InitiateRecoveryStep.tsx +68 -68
- package/src/components/recovery/SelectMethodStep.tsx +73 -73
- package/src/components/recovery/SetPasswordStep.tsx +97 -97
- package/src/components/recovery/VerifyCodeStep.tsx +90 -90
- package/src/components/reserved/ReservedRecoveryWarning.tsx +160 -160
- package/src/components/reserved/ReservedStatusBox.tsx +118 -118
- package/src/components/ui/BetaBadge.tsx +58 -58
- package/src/components/ui/Footer.tsx +93 -93
- package/src/config/env.ts +57 -57
- package/src/config/logger.ts +62 -62
- package/src/config/vibe-log-transport.ts +264 -264
- package/src/hooks/useAuth.ts +117 -117
- package/src/hooks/useAuthSettings.ts +97 -97
- package/src/hooks/useAvailableProviders.ts +120 -120
- package/src/hooks/usePasswordValidation.ts +127 -127
- package/src/hooks/usePublicAuthSettings.ts +149 -149
- package/src/hooks/useSessionExpiration.ts +101 -101
- package/src/hooks/useViabilitySession.ts +336 -336
- package/src/index.ts +60 -60
- package/src/lib/api-handler.ts +643 -643
- package/src/lib/app-slug.ts +178 -178
- package/src/lib/geolocation.ts +265 -265
- package/src/lib/idp-fetch.ts +110 -110
- package/src/lib/jwt-decode.ts +82 -82
- package/src/lib/roles.ts +177 -177
- package/src/lib/site-logger.ts +245 -245
- package/src/lib/standardized-client-api.ts +901 -901
- package/src/lib/test-aware-get-token.ts +41 -41
- package/src/lib/user-agent-parser.ts +252 -252
- package/src/logging/api/admin-analytics.ts +51 -51
- package/src/logging/api/audit-log.ts +53 -53
- package/src/logging/components/AdminAnalyticsLayout.tsx +49 -49
- package/src/logging/components/AuditLogViewer.tsx +125 -125
- package/src/logging/components/ErrorMetricsCard.tsx +98 -98
- package/src/logging/components/HealthMetricsCard.tsx +70 -70
- package/src/logging/hooks/useAdminAnalytics.ts +22 -22
- package/src/logging/hooks/useAuditLog.ts +24 -24
- package/src/logging/hooks/useErrorMetrics.ts +40 -40
- package/src/logging/hooks/useHealthMetrics.ts +44 -44
- package/src/logging/index.ts +18 -18
- package/src/logging/types/analytics.ts +81 -81
- package/src/logging/types/audit.ts +31 -31
- package/src/logging/types/index.ts +3 -3
- package/src/middleware/create-middleware.ts +663 -663
- package/src/middleware/rbac-check.ts +279 -279
- package/src/middleware/twofa-presets.ts +224 -224
- package/src/pages/admin-login/page.tsx +221 -221
- package/src/pages/admin-page-permissions/PagePermissionsAdminPage.tsx +527 -527
- package/src/pages/admin-page-permissions/index.ts +7 -7
- package/src/pages/admin-roles/RolesAdminPage.tsx +533 -533
- package/src/pages/admin-roles/modals.tsx +469 -469
- package/src/pages/client-admin/ClientSiteAdminPage.tsx +382 -382
- package/src/pages/client-admin/index.ts +33 -33
- package/src/pages/coming-soon/page.tsx +83 -83
- package/src/pages/login/page.tsx +456 -456
- package/src/pages/profile/EnhancedProfilePage.tsx +485 -485
- package/src/pages/profile/index.ts +9 -9
- package/src/pages/profile/page.tsx +166 -166
- package/src/pages/recovery/page.tsx +234 -234
- package/src/pages/roles/MyRolesPage.tsx +211 -211
- package/src/pages/roles/components.tsx +294 -294
- package/src/pages/roles/index.ts +17 -17
- package/src/pages/security/EnhancedSecurityPage.tsx +565 -565
- package/src/pages/security/index.ts +9 -9
- package/src/pages/security/page.tsx +507 -507
- package/src/pages/settings/EnhancedSettingsPage.tsx +642 -642
- package/src/pages/settings/index.ts +9 -9
- package/src/pages/settings/page.tsx +47 -47
- package/src/pages/showcase/ShowcasePage.tsx +532 -532
- package/src/pages/showcase/index.ts +13 -13
- package/src/pages/test-env/EmergencyLogoutPage.tsx +180 -180
- package/src/pages/test-env/JwtInspectPage.tsx +456 -456
- package/src/pages/test-env/RefreshTokenPage.tsx +157 -157
- package/src/pages/test-env/TestEnvPage.tsx +118 -118
- package/src/pages/test-env/index.ts +25 -25
- package/src/pages/verify-code/page.tsx +652 -652
- package/src/routes/account/update-phone.ts +13 -13
- package/src/routes/auth/logout.ts +108 -108
- package/src/routes/auth/nextauth.ts +45 -45
- package/src/routes/auth/settings.ts +75 -75
- package/src/routes/auth/viability.ts +224 -224
- package/src/server/auth-guard.ts +170 -170
- package/src/server/slim-middleware.ts +117 -117
- package/src/server/with-auth.ts +93 -93
- package/src/stores/authStore.ts +1899 -1899
- package/src/templates/instrumentation.ts +41 -41
- package/src/utils/logout.ts +30 -30
- package/src/vibe/client.ts +590 -590
- package/src/vibe/enterprise-auth.ts +208 -208
- package/src/vibe/errors.ts +185 -185
- package/src/vibe/generic.ts +431 -431
- package/src/vibe/hooks/index.ts +367 -367
- package/src/vibe/index.ts +132 -132
- package/src/vibe/sessions.ts +551 -551
- package/src/vibe/types.ts +577 -577
package/src/lib/idp-fetch.ts
CHANGED
|
@@ -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
|
}
|
package/src/lib/jwt-decode.ts
CHANGED
|
@@ -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
|
}
|