@spidy092/auth-client 2.1.8 โ†’ 3.0.0

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/core.js DELETED
@@ -1,567 +0,0 @@
1
- // auth-client/core.js - MINIMAL WORKING VERSION
2
-
3
- import {
4
- setToken,
5
- clearToken,
6
- getToken,
7
- setRefreshToken,
8
- getRefreshToken,
9
- clearRefreshToken,
10
- } from './token';
11
- import { getConfig, isRouterMode } from './config';
12
-
13
- let callbackProcessed = false;
14
-
15
- export function login(clientKeyArg, redirectUriArg) {
16
- // โœ… Reset callback state when starting new login
17
- resetCallbackState();
18
-
19
- const {
20
- clientKey: defaultClientKey,
21
- authBaseUrl,
22
- redirectUri: defaultRedirectUri,
23
- accountUiUrl
24
- } = getConfig();
25
-
26
- const clientKey = clientKeyArg || defaultClientKey;
27
- const redirectUri = redirectUriArg || defaultRedirectUri;
28
-
29
- console.log('๐Ÿ”„ Smart Login initiated:', {
30
- mode: isRouterMode() ? 'ROUTER' : 'CLIENT',
31
- clientKey,
32
- redirectUri
33
- });
34
-
35
- if (!clientKey || !redirectUri) {
36
- throw new Error('Missing clientKey or redirectUri');
37
- }
38
-
39
- sessionStorage.setItem('originalApp', clientKey);
40
- sessionStorage.setItem('returnUrl', redirectUri);
41
-
42
- if (isRouterMode()) {
43
- // Router mode: Direct backend authentication
44
- return routerLogin(clientKey, redirectUri);
45
- } else {
46
- // Client mode: Redirect to centralized login
47
- return clientLogin(clientKey, redirectUri);
48
- }
49
- }
50
-
51
- // โœ… Router mode: Direct backend call
52
- function routerLogin(clientKey, redirectUri) {
53
- const { authBaseUrl } = getConfig();
54
-
55
- const params = new URLSearchParams();
56
- if (redirectUri) {
57
- params.append('redirect_uri', redirectUri);
58
- }
59
- const query = params.toString();
60
- const backendLoginUrl = `${authBaseUrl}/login/${clientKey}${query ? `?${query}` : ''}`;
61
-
62
- console.log('๐Ÿญ Router Login: Direct backend authentication', {
63
- clientKey,
64
- redirectUri,
65
- backendUrl: backendLoginUrl
66
- });
67
-
68
- window.location.href = backendLoginUrl;
69
- }
70
-
71
- // โœ… Client mode: Centralized login
72
- function clientLogin(clientKey, redirectUri) {
73
- const { accountUiUrl } = getConfig();
74
-
75
- const params = new URLSearchParams({
76
- client: clientKey
77
- });
78
- if (redirectUri) {
79
- params.append('redirect_uri', redirectUri);
80
- }
81
- const centralizedLoginUrl = `${accountUiUrl}/login?${params.toString()}`;
82
-
83
- console.log('๐Ÿ”„ Client Login: Redirecting to centralized login', {
84
- clientKey,
85
- redirectUri,
86
- centralizedUrl: centralizedLoginUrl
87
- });
88
-
89
- window.location.href = centralizedLoginUrl;
90
- }
91
-
92
- export function logout() {
93
- resetCallbackState();
94
-
95
- const { clientKey, authBaseUrl, accountUiUrl } = getConfig();
96
- const token = getToken();
97
-
98
- console.log('๐Ÿšช Smart Logout initiated');
99
-
100
- clearToken();
101
- clearRefreshToken();
102
- sessionStorage.removeItem('originalApp');
103
- sessionStorage.removeItem('returnUrl');
104
-
105
- if (isRouterMode()) {
106
- return routerLogout(clientKey, authBaseUrl, accountUiUrl, token);
107
- } else {
108
- return clientLogout(clientKey, accountUiUrl);
109
- }
110
- }
111
-
112
- async function routerLogout(clientKey, authBaseUrl, accountUiUrl, token) {
113
- console.log('๐Ÿญ Router Logout');
114
-
115
- const refreshToken = getRefreshToken();
116
-
117
- try {
118
- const response = await fetch(`${authBaseUrl}/logout/${clientKey}`, {
119
- method: 'POST',
120
- credentials: 'include',
121
- headers: {
122
- 'Authorization': token ? `Bearer ${token}` : '',
123
- 'Content-Type': 'application/json'
124
- },
125
- body: JSON.stringify({
126
- refreshToken: refreshToken
127
- })
128
- });
129
-
130
- const data = await response.json();
131
- console.log('โœ… Logout response:', data);
132
-
133
- clearRefreshToken();
134
- clearToken();
135
-
136
- // Skip Keycloak confirmation page - redirect directly to login
137
- // Backend has already revoked the session/tokens
138
- console.log('๐Ÿ”„ Redirecting to login (skipping Keycloak confirmation)');
139
- window.location.href = '/login';
140
-
141
- } catch (error) {
142
- console.warn('โš ๏ธ Logout failed:', error);
143
- clearRefreshToken();
144
- clearToken();
145
- // Still redirect to login even on error
146
- window.location.href = '/login';
147
- }
148
- }
149
-
150
- function clientLogout(clientKey, accountUiUrl) {
151
- console.log('๐Ÿ”„ Client Logout');
152
- const logoutUrl = `${accountUiUrl}/login?client=${clientKey}&logout=true`;
153
- window.location.href = logoutUrl;
154
- }
155
-
156
- export function handleCallback() {
157
- const params = new URLSearchParams(window.location.search);
158
- const accessToken = params.get('access_token');
159
- const error = params.get('error');
160
-
161
- console.log('๐Ÿ”„ Callback handling:', {
162
- hasAccessToken: !!accessToken,
163
- error
164
- });
165
-
166
- // โœ… Prevent duplicate callback processing
167
- if (callbackProcessed) {
168
- const existingToken = getToken();
169
- if (existingToken) {
170
- console.log('โœ… Callback already processed, returning existing token');
171
- return existingToken;
172
- }
173
- // Reset if no token found (might be a retry)
174
- callbackProcessed = false;
175
- }
176
-
177
- callbackProcessed = true;
178
- sessionStorage.removeItem('originalApp');
179
- sessionStorage.removeItem('returnUrl');
180
-
181
- if (error) {
182
- const errorDescription = params.get('error_description') || error;
183
- throw new Error(`Authentication failed: ${errorDescription}`);
184
- }
185
-
186
- if (accessToken) {
187
- setToken(accessToken);
188
-
189
- // โœ… For HTTP development, store refresh token from URL
190
- // In HTTPS production, refresh token is in httpOnly cookie (more secure)
191
- const refreshTokenInUrl = params.get('refresh_token');
192
- if (refreshTokenInUrl) {
193
- const isHttpDev = typeof window !== 'undefined' && window.location?.protocol === 'http:';
194
- if (isHttpDev) {
195
- console.log('๐Ÿ“ฆ HTTP dev mode: Storing refresh token from callback URL');
196
- setRefreshToken(refreshTokenInUrl);
197
- } else {
198
- console.log('๐Ÿ”’ HTTPS mode: Refresh token is in httpOnly cookie (ignoring URL param)');
199
- }
200
- }
201
-
202
- const url = new URL(window.location);
203
- url.searchParams.delete('access_token');
204
- url.searchParams.delete('refresh_token');
205
- url.searchParams.delete('state');
206
- url.searchParams.delete('error');
207
- url.searchParams.delete('error_description');
208
- window.history.replaceState({}, '', url);
209
-
210
- console.log('โœ… Callback processed successfully, token stored');
211
- return accessToken;
212
- }
213
-
214
- throw new Error('No access token found in callback URL');
215
- }
216
-
217
- export function resetCallbackState() {
218
- callbackProcessed = false;
219
- }
220
-
221
- // โœ… Add refresh lock to prevent concurrent refresh calls
222
- let refreshInProgress = false;
223
- let refreshPromise = null;
224
-
225
- export async function refreshToken() {
226
- const { clientKey, authBaseUrl } = getConfig();
227
-
228
- // โœ… Prevent concurrent refresh calls
229
- if (refreshInProgress && refreshPromise) {
230
- console.log('๐Ÿ”„ Token refresh already in progress, waiting...');
231
- return refreshPromise;
232
- }
233
-
234
- refreshInProgress = true;
235
- refreshPromise = (async () => {
236
- try {
237
- // Get stored refresh token (for HTTP development)
238
- const storedRefreshToken = getRefreshToken();
239
-
240
- console.log('๐Ÿ”„ Refreshing token:', {
241
- clientKey,
242
- mode: isRouterMode() ? 'ROUTER' : 'CLIENT',
243
- hasStoredRefreshToken: !!storedRefreshToken
244
- });
245
-
246
- // Build request options - send refresh token in body and header for HTTP dev
247
- const requestOptions = {
248
- method: 'POST',
249
- credentials: 'include', // โœ… Include httpOnly cookies (for HTTPS)
250
- headers: {
251
- 'Content-Type': 'application/json'
252
- }
253
- };
254
-
255
- // For HTTP development, send refresh token in body and header
256
- if (storedRefreshToken) {
257
- requestOptions.headers['X-Refresh-Token'] = storedRefreshToken;
258
- requestOptions.body = JSON.stringify({ refreshToken: storedRefreshToken });
259
- }
260
-
261
- const response = await fetch(`${authBaseUrl}/refresh/${clientKey}`, requestOptions);
262
-
263
- if (!response.ok) {
264
- const errorText = await response.text();
265
- console.error('โŒ Token refresh failed:', response.status, errorText);
266
- throw new Error(`Refresh failed: ${response.status}`);
267
- }
268
-
269
- const data = await response.json();
270
- const { access_token, refresh_token: new_refresh_token } = data;
271
-
272
- if (!access_token) {
273
- throw new Error('No access token in refresh response');
274
- }
275
-
276
- // โœ… This will trigger token listeners
277
- setToken(access_token);
278
-
279
- // โœ… Store new refresh token if provided (token rotation)
280
- if (new_refresh_token) {
281
- setRefreshToken(new_refresh_token);
282
- console.log('๐Ÿ”„ New refresh token stored from rotation');
283
- }
284
-
285
- console.log('โœ… Token refresh successful, listeners notified');
286
- return access_token;
287
- } catch (err) {
288
- console.error('โŒ Token refresh error:', err);
289
- // โœ… This will trigger token listeners
290
- clearToken();
291
- clearRefreshToken();
292
- throw err;
293
- } finally {
294
- refreshInProgress = false;
295
- refreshPromise = null;
296
- }
297
- })();
298
-
299
- return refreshPromise;
300
- }
301
-
302
- export async function validateCurrentSession() {
303
- try {
304
- const { authBaseUrl } = getConfig();
305
- const token = getToken();
306
-
307
- if (!token || !authBaseUrl) {
308
- return false;
309
- }
310
-
311
- const response = await fetch(`${authBaseUrl}/account/validate-session`, {
312
- method: 'GET',
313
- headers: {
314
- 'Authorization': `Bearer ${token}`,
315
- 'Content-Type': 'application/json'
316
- },
317
- credentials: 'include'
318
- });
319
-
320
- if (!response.ok) {
321
- if (response.status === 401) {
322
- return false;
323
- }
324
- throw new Error(`HTTP ${response.status}: ${response.statusText}`);
325
- }
326
-
327
- const data = await response.json();
328
- return data.valid === true;
329
- } catch (error) {
330
- console.warn('Session validation failed:', error.message);
331
- if (error.message.includes('401')) {
332
- return false;
333
- }
334
- throw error;
335
- }
336
- }
337
-
338
- // ========== SESSION SECURITY: PROACTIVE REFRESH & VALIDATION ==========
339
- // These functions ensure that:
340
- // 1. Tokens are refreshed before they expire (proactive refresh)
341
- // 2. Sessions deleted in Keycloak Admin UI are detected quickly (periodic validation)
342
-
343
- let proactiveRefreshTimer = null;
344
- let sessionValidationTimer = null;
345
- let visibilityHandler = null;
346
- let sessionInvalidCallbacks = new Set();
347
-
348
- // Register a callback to be called when session is invalidated
349
- export function onSessionInvalid(callback) {
350
- if (typeof callback === 'function') {
351
- sessionInvalidCallbacks.add(callback);
352
- }
353
- return () => sessionInvalidCallbacks.delete(callback);
354
- }
355
-
356
- // Notify all registered callbacks that session is invalid
357
- function notifySessionInvalid(reason = 'session_deleted') {
358
- console.log('๐Ÿšจ Session invalidated:', reason);
359
- sessionInvalidCallbacks.forEach(callback => {
360
- try {
361
- callback(reason);
362
- } catch (err) {
363
- console.error('Session invalid callback error:', err);
364
- }
365
- });
366
- }
367
-
368
- // ========== PROACTIVE TOKEN REFRESH ==========
369
- // Schedules token refresh before expiry to ensure seamless UX
370
-
371
- export function startProactiveRefresh() {
372
- const { enableProactiveRefresh, tokenRefreshBuffer } = getConfig();
373
-
374
- if (!enableProactiveRefresh) {
375
- console.log('โธ๏ธ Proactive refresh disabled by config');
376
- return null;
377
- }
378
-
379
- // Clear any existing timer
380
- stopProactiveRefresh();
381
-
382
- const token = getToken();
383
- if (!token) {
384
- console.log('โธ๏ธ No token, skipping proactive refresh setup');
385
- return null;
386
- }
387
-
388
- const { getTimeUntilExpiry } = require('./token');
389
- const timeUntilExpiry = getTimeUntilExpiry(token);
390
-
391
- if (timeUntilExpiry <= 0) {
392
- console.log('โš ๏ธ Token already expired, attempting immediate refresh');
393
- refreshToken().catch(err => {
394
- console.error('โŒ Immediate refresh failed:', err);
395
- notifySessionInvalid('token_expired');
396
- });
397
- return null;
398
- }
399
-
400
- // Schedule refresh for (expiry - buffer) seconds from now
401
- const refreshIn = Math.max(0, (timeUntilExpiry - tokenRefreshBuffer)) * 1000;
402
-
403
- console.log(`๐Ÿ”„ Scheduling proactive refresh in ${Math.round(refreshIn / 1000)}s (token expires in ${timeUntilExpiry}s)`);
404
-
405
- proactiveRefreshTimer = setTimeout(async () => {
406
- try {
407
- console.log('๐Ÿ”„ Proactive token refresh triggered');
408
- await refreshToken();
409
- console.log('โœ… Proactive refresh successful, scheduling next refresh');
410
- // Schedule next refresh after successful refresh
411
- startProactiveRefresh();
412
- } catch (err) {
413
- console.error('โŒ Proactive refresh failed:', err);
414
-
415
- // Check if this is a permanent failure (token revoked, invalid, etc.)
416
- const errorMessage = err.message?.toLowerCase() || '';
417
- const isPermanentFailure =
418
- errorMessage.includes('401') ||
419
- errorMessage.includes('revoked') ||
420
- errorMessage.includes('invalid') ||
421
- errorMessage.includes('expired') ||
422
- errorMessage.includes('unauthorized');
423
-
424
- if (isPermanentFailure) {
425
- console.log('๐Ÿšจ Token permanently invalid, triggering session expiry');
426
- notifySessionInvalid('refresh_token_revoked');
427
- } else {
428
- // Temporary failure (network issue), try again in 30 seconds
429
- proactiveRefreshTimer = setTimeout(() => startProactiveRefresh(), 30000);
430
- }
431
- }
432
- }, refreshIn);
433
-
434
- return proactiveRefreshTimer;
435
- }
436
-
437
- export function stopProactiveRefresh() {
438
- if (proactiveRefreshTimer) {
439
- clearTimeout(proactiveRefreshTimer);
440
- proactiveRefreshTimer = null;
441
- console.log('โน๏ธ Proactive refresh stopped');
442
- }
443
- }
444
-
445
- // ========== PERIODIC SESSION VALIDATION ==========
446
- // Validates with server that session still exists in Keycloak
447
- // Catches session deletions from Keycloak Admin UI
448
-
449
- export function startSessionMonitor(onInvalid) {
450
- const { enableSessionValidation, sessionValidationInterval, validateOnVisibility } = getConfig();
451
-
452
- if (!enableSessionValidation) {
453
- console.log('โธ๏ธ Session validation disabled by config');
454
- return null;
455
- }
456
-
457
- // Register callback if provided
458
- if (onInvalid && typeof onInvalid === 'function') {
459
- sessionInvalidCallbacks.add(onInvalid);
460
- }
461
-
462
- // Clear any existing timer
463
- stopSessionMonitor();
464
-
465
- const token = getToken();
466
- if (!token) {
467
- console.log('โธ๏ธ No token, skipping session monitor setup');
468
- return null;
469
- }
470
-
471
- console.log(`๐Ÿ‘๏ธ Starting session monitor (interval: ${sessionValidationInterval / 1000}s)`);
472
-
473
- // Periodic validation
474
- sessionValidationTimer = setInterval(async () => {
475
- try {
476
- const currentToken = getToken();
477
- if (!currentToken) {
478
- console.log('โธ๏ธ No token, stopping session validation');
479
- stopSessionMonitor();
480
- return;
481
- }
482
-
483
- console.log('๐Ÿ” Validating session...');
484
- const isValid = await validateCurrentSession();
485
-
486
- if (!isValid) {
487
- console.log('โŒ Session no longer valid on server');
488
- stopSessionMonitor();
489
- stopProactiveRefresh();
490
- clearToken();
491
- clearRefreshToken();
492
- notifySessionInvalid('session_deleted');
493
- } else {
494
- console.log('โœ… Session still valid');
495
- }
496
- } catch (error) {
497
- console.warn('โš ๏ธ Session validation check failed:', error.message);
498
- // Don't invalidate on network errors - wait for next check
499
- }
500
- }, sessionValidationInterval);
501
-
502
- // Visibility-based validation (when tab becomes visible again)
503
- if (validateOnVisibility && typeof document !== 'undefined') {
504
- visibilityHandler = async () => {
505
- if (document.visibilityState === 'visible') {
506
- const currentToken = getToken();
507
- if (!currentToken) return;
508
-
509
- console.log('๐Ÿ‘๏ธ Tab visible - validating session');
510
- try {
511
- const isValid = await validateCurrentSession();
512
- if (!isValid) {
513
- console.log('โŒ Session expired while tab was hidden');
514
- stopSessionMonitor();
515
- stopProactiveRefresh();
516
- clearToken();
517
- clearRefreshToken();
518
- notifySessionInvalid('session_deleted_while_hidden');
519
- }
520
- } catch (error) {
521
- console.warn('โš ๏ธ Visibility check failed:', error.message);
522
- }
523
- }
524
- };
525
- document.addEventListener('visibilitychange', visibilityHandler);
526
- }
527
-
528
- return sessionValidationTimer;
529
- }
530
-
531
- export function stopSessionMonitor() {
532
- if (sessionValidationTimer) {
533
- clearInterval(sessionValidationTimer);
534
- sessionValidationTimer = null;
535
- console.log('โน๏ธ Session monitor stopped');
536
- }
537
-
538
- if (visibilityHandler && typeof document !== 'undefined') {
539
- document.removeEventListener('visibilitychange', visibilityHandler);
540
- visibilityHandler = null;
541
- }
542
- }
543
-
544
- // ========== COMBINED SESSION SECURITY ==========
545
- // Start both proactive refresh and session monitoring
546
-
547
- export function startSessionSecurity(onSessionInvalidCallback) {
548
- console.log('๐Ÿ” Starting session security (proactive refresh + session monitoring)');
549
-
550
- startProactiveRefresh();
551
- startSessionMonitor(onSessionInvalidCallback);
552
-
553
- return {
554
- stopAll: () => {
555
- stopProactiveRefresh();
556
- stopSessionMonitor();
557
- }
558
- };
559
- }
560
-
561
- export function stopSessionSecurity() {
562
- stopProactiveRefresh();
563
- stopSessionMonitor();
564
- sessionInvalidCallbacks.clear();
565
- console.log('๐Ÿ” Session security stopped');
566
- }
567
-
package/index.js DELETED
@@ -1,106 +0,0 @@
1
- // auth-client/index.js
2
- import { setConfig, getConfig, isRouterMode } from './config';
3
- import {
4
- login,
5
- logout,
6
- handleCallback,
7
- refreshToken,
8
- resetCallbackState,
9
- validateCurrentSession,
10
- // Session Security Functions
11
- startProactiveRefresh,
12
- stopProactiveRefresh,
13
- startSessionMonitor,
14
- stopSessionMonitor,
15
- startSessionSecurity,
16
- stopSessionSecurity,
17
- onSessionInvalid
18
- } from './core';
19
- import {
20
- getToken,
21
- setToken,
22
- clearToken,
23
- setRefreshToken,
24
- getRefreshToken,
25
- clearRefreshToken,
26
- addTokenListener,
27
- removeTokenListener,
28
- getListenerCount,
29
- // Token Expiry Utilities
30
- getTokenExpiryTime,
31
- getTimeUntilExpiry,
32
- willExpireSoon
33
- } from './token';
34
- import api from './api';
35
- import { decodeToken, isTokenExpired, isAuthenticated } from './utils/jwt';
36
-
37
- export const auth = {
38
- // ๐Ÿ”ง Config
39
- setConfig,
40
- getConfig,
41
- isRouterMode,
42
-
43
- // ๐Ÿ” Core flows
44
- login,
45
- logout,
46
- handleCallback,
47
- refreshToken,
48
- resetCallbackState,
49
- validateCurrentSession,
50
-
51
- // ๐Ÿ”‘ Token management
52
- getToken,
53
- setToken,
54
- clearToken,
55
- setRefreshToken, // โœ… Refresh token for HTTP dev
56
- getRefreshToken,
57
- clearRefreshToken,
58
- addTokenListener, // โœ… Export new functions
59
- removeTokenListener,
60
- getListenerCount, // โœ… Debug function
61
-
62
- // ๐ŸŒ Authenticated API client
63
- api,
64
-
65
- // ๐Ÿงช Utilities
66
- decodeToken,
67
- isTokenExpired,
68
- isAuthenticated,
69
-
70
- // โฑ๏ธ Token Expiry Utilities (NEW)
71
- getTokenExpiryTime, // Get token expiry as Date object
72
- getTimeUntilExpiry, // Get seconds until token expires
73
- willExpireSoon, // Check if token expires within N seconds
74
-
75
- // ๐Ÿ” Session Security (NEW - Short-lived tokens + Periodic validation)
76
- startProactiveRefresh, // Start proactive token refresh before expiry
77
- stopProactiveRefresh, // Stop proactive refresh
78
- startSessionMonitor, // Start periodic session validation
79
- stopSessionMonitor, // Stop session validation
80
- startSessionSecurity, // Start both proactive refresh AND session monitoring
81
- stopSessionSecurity, // Stop all session security
82
- onSessionInvalid, // Register callback for session invalidation
83
-
84
- // ๐Ÿ”„ Legacy auto-refresh (DEPRECATED - use startSessionSecurity instead)
85
- startTokenRefresh: () => {
86
- console.warn('โš ๏ธ startTokenRefresh is deprecated. Use startSessionSecurity() instead for better session management.');
87
- const interval = setInterval(async () => {
88
- const token = getToken();
89
- if (token && isTokenExpired(token, 300)) {
90
- try {
91
- await refreshToken();
92
- console.log('๐Ÿ”„ Auto-refresh successful');
93
- } catch (err) {
94
- console.error('Auto-refresh failed:', err);
95
- clearInterval(interval);
96
- }
97
- }
98
- }, 60000);
99
- return interval;
100
- }
101
- };
102
-
103
- export { AuthProvider } from './react/AuthProvider';
104
- export { useAuth } from './react/useAuth';
105
- export { useSessionMonitor } from './react/useSessionMonitor';
106
-