@payez/next-mvp 4.1.11 → 4.1.13

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 (92) hide show
  1. package/dist/api-handlers/auth/refresh.js +15 -38
  2. package/dist/auth/better-auth.d.ts +0 -3
  3. package/dist/auth/better-auth.js +164 -69
  4. package/dist/client/better-auth-client.d.ts +14 -2
  5. package/dist/lib/ensure-fresh-access-token.js +8 -42
  6. package/dist/lib/session-store.d.ts +0 -1
  7. package/dist/lib/session-store.js +29 -33
  8. package/dist/lib/startup-init.js +19 -19
  9. package/dist/lib/token-lifecycle.d.ts +0 -2
  10. package/dist/lib/token-lifecycle.js +3 -21
  11. package/package.json +5 -4
  12. package/scripts/check-internal-url-usage.sh +73 -73
  13. package/src/api/index.ts +17 -17
  14. package/src/api-handlers/account/masked-info.ts +45 -45
  15. package/src/api-handlers/account/profile.ts +80 -80
  16. package/src/api-handlers/account/recovery/initiate.ts +23 -23
  17. package/src/api-handlers/account/recovery/send-code.ts +25 -25
  18. package/src/api-handlers/account/recovery/verify-code.ts +25 -25
  19. package/src/api-handlers/account/reset-password.ts +23 -23
  20. package/src/api-handlers/account/send-code.ts +76 -76
  21. package/src/api-handlers/account/validate-password.ts +118 -118
  22. package/src/api-handlers/admin/stats.ts +249 -249
  23. package/src/api-handlers/anon/preferences.ts +123 -123
  24. package/src/api-handlers/auth/jwks.ts +20 -20
  25. package/src/api-handlers/auth/login.ts +240 -240
  26. package/src/api-handlers/auth/refresh.ts +15 -38
  27. package/src/api-handlers/auth/validate.ts +43 -43
  28. package/src/api-handlers/session/viability.ts +142 -142
  29. package/src/auth/better-auth.ts +130 -29
  30. package/src/auth/unauthenticated-routes.ts +2 -2
  31. package/src/client/better-auth-client.ts +70 -70
  32. package/src/client/fetchWithSession.ts +21 -21
  33. package/src/client/index.ts +13 -13
  34. package/src/client/useAnonSession.ts +131 -131
  35. package/src/components/admin/VibeAdminContext.tsx +87 -87
  36. package/src/config/logging-config.ts +82 -82
  37. package/src/config/unauthenticated-routes.ts +19 -19
  38. package/src/edge/internal-api-url.ts +65 -65
  39. package/src/edge/middleware.ts +42 -42
  40. package/src/hooks/useProfile.ts +75 -75
  41. package/src/lib/anon-session.ts +213 -213
  42. package/src/lib/auth-secret.ts +137 -137
  43. package/src/lib/demo-mode.ts +17 -17
  44. package/src/lib/ensure-fresh-access-token.ts +8 -42
  45. package/src/lib/idp-client-config.ts +559 -559
  46. package/src/lib/idp-fetch.ts +126 -126
  47. package/src/lib/internal-api.ts +171 -171
  48. package/src/lib/jwt-decode-client.ts +45 -45
  49. package/src/lib/rate-limit-service.ts +9 -9
  50. package/src/lib/redis.ts +26 -26
  51. package/src/lib/refresh-token-validator.ts +64 -64
  52. package/src/lib/secret-validation.ts +8 -8
  53. package/src/lib/session-store.ts +692 -695
  54. package/src/lib/session.ts +34 -34
  55. package/src/lib/startup-init.ts +251 -251
  56. package/src/lib/token-expiry.ts +40 -40
  57. package/src/lib/token-lifecycle.ts +470 -497
  58. package/src/lib/types/api-responses.ts +336 -336
  59. package/src/middleware/auth-decision.ts +43 -43
  60. package/src/models/DecodedAccessToken.ts +16 -16
  61. package/src/models/SessionModel.ts +264 -264
  62. package/src/pages/admin-roles/index.ts +9 -9
  63. package/src/pages/security/EnhancedSecurityPage.tsx +9 -9
  64. package/src/routes/account/index.ts +31 -31
  65. package/src/routes/account/masked-info.ts +36 -36
  66. package/src/routes/account/send-code.ts +39 -39
  67. package/src/routes/account/verify-email.ts +40 -40
  68. package/src/routes/account/verify-sms.ts +40 -40
  69. package/src/routes/auth/index.ts +22 -22
  70. package/src/routes/auth/refresh.ts +48 -48
  71. package/src/routes/auth/session.ts +166 -166
  72. package/src/routes/index.ts +17 -17
  73. package/src/routes/session/index.ts +7 -7
  74. package/src/routes/session/refresh-viability.ts +17 -17
  75. package/src/server/auth.ts +373 -373
  76. package/src/server/decode-session.ts +202 -202
  77. package/src/services/signalrActivityService.ts +258 -258
  78. package/src/theme/ThemeProvider.tsx +39 -39
  79. package/src/theme/default.ts +33 -33
  80. package/src/theme/index.ts +31 -31
  81. package/src/theme/types.ts +69 -69
  82. package/src/theme/useTheme.ts +57 -57
  83. package/src/theme/utils.ts +40 -40
  84. package/src/types/api.ts +12 -12
  85. package/src/types/auth.d.ts +23 -23
  86. package/src/types/auth.ts +22 -22
  87. package/src/types/logging.ts +11 -11
  88. package/src/types/recovery.ts +54 -54
  89. package/src/utils/api.ts +353 -353
  90. package/src/utils/circuitBreaker.ts +40 -40
  91. package/src/utils/error-message.ts +108 -108
  92. package/src/utils/layout/reservedSpace.ts +124 -124
@@ -1,82 +1,82 @@
1
- import { promises as fs } from 'fs';
2
- import { watch, existsSync } from 'fs';
3
- import { LoggingConfig, LogLevel } from '../types/logging';
4
-
5
- const isEdgeRuntime = typeof (globalThis as any).EdgeRuntime !== 'undefined' || process.env.NEXT_RUNTIME === 'edge';
6
-
7
- class LoggingConfigManager {
8
- private config: LoggingConfig | null = null;
9
- private configPath: string;
10
- private watchers: Set<(config: LoggingConfig) => void> = new Set();
11
- private fileWatcher: ReturnType<typeof watch> | null = null;
12
- private isEdgeRuntime: boolean;
13
- private isBrowser: boolean;
14
-
15
- constructor() {
16
- this.isBrowser = typeof window !== 'undefined';
17
- this.isEdgeRuntime = typeof (globalThis as any).EdgeRuntime !== 'undefined' || process.env.NEXT_RUNTIME === 'edge';
18
- if (this.isEdgeRuntime || this.isBrowser) {
19
- this.configPath = '/config/logging.json';
20
- this.config = this.getDefaultConfig();
21
- } else {
22
- const cwd = process.cwd().replace(/\\/g, '/');
23
- this.configPath = cwd + '/config/logging.json';
24
- }
25
- }
26
-
27
- async loadConfig(): Promise<LoggingConfig> {
28
- if (this.isEdgeRuntime || this.isBrowser) {
29
- if (!this.config) { this.config = this.getDefaultConfig(); }
30
- return this.config;
31
- }
32
- try {
33
- const configContent = await fs.readFile(this.configPath, 'utf-8');
34
- const rawConfig = JSON.parse(configContent);
35
- const config = this.validateAndMergeConfig(rawConfig);
36
- this.config = config; this.notifyWatchers(config); return config;
37
- } catch (error) {
38
- console.warn(`Failed to load logging config from ${this.configPath}:`, error);
39
- return this.getDefaultConfig();
40
- }
41
- }
42
-
43
- async getConfig(): Promise<LoggingConfig> { if (!this.config) { return await this.loadConfig(); } return this.config; }
44
- getConfigSync(): LoggingConfig { return this.config || this.getDefaultConfig(); }
45
-
46
- startWatching(): void { if (this.isEdgeRuntime || this.isBrowser) { return; } if (this.fileWatcher) { return; } try { if (!existsSync(this.configPath)) { console.warn(`Logging config file not found at ${this.configPath} — watch disabled`); return; } this.fileWatcher = watch(this.configPath, { persistent: false }, (eventType) => { if (eventType === 'change') { this.loadConfig().catch(console.error); } }); } catch (error) { console.warn('Failed to start watching logging config file:', error); } }
47
- stopWatching(): void { if (this.isEdgeRuntime || this.isBrowser) { return; } if (this.fileWatcher) { this.fileWatcher.close(); this.fileWatcher = null; } }
48
- addWatcher(callback: (config: LoggingConfig) => void): void { this.watchers.add(callback); }
49
- removeWatcher(callback: (config: LoggingConfig) => void): void { this.watchers.delete(callback); }
50
- private notifyWatchers(config: LoggingConfig): void { this.watchers.forEach(cb => { try { cb(config); } catch (error) { console.error('Error in logging config watcher:', error); } }); }
51
-
52
- private validateAndMergeConfig(rawConfig: any): LoggingConfig {
53
- const defaults = this.getDefaultConfig();
54
- const config: LoggingConfig = {
55
- logLevel: this.validateLogLevel(rawConfig.logLevel) || this.validateLogLevel(process.env.LOG_LEVEL) || defaults.logLevel,
56
- console: { enabled: rawConfig.console?.enabled ?? (process.env.LOG_CONSOLE === 'true' || process.env.NODE_ENV === 'development'), colors: rawConfig.console?.colors ?? defaults.console.colors },
57
- graylog: { enabled: false, host: defaults.graylog.host, port: defaults.graylog.port, facility: defaults.graylog.facility, staticMeta: { ...defaults.graylog.staticMeta } },
58
- components: { ...defaults.components, ...rawConfig.components },
59
- levels: { ...defaults.levels, ...rawConfig.levels }
60
- };
61
- return config;
62
- }
63
- private validateLogLevel(level: any): LogLevel | null { const validLevels: LogLevel[] = ['error', 'warn', 'info', 'http', 'debug']; return validLevels.includes(level) ? level : null; }
64
- private getHostname(): string { if (this.isEdgeRuntime) return 'edge-runtime'; if (this.isBrowser) return 'browser-client'; try { return require('os').hostname(); } catch { return 'unknown'; } }
65
- private getDefaultConfig(): LoggingConfig {
66
- return {
67
- logLevel: 'info',
68
- console: { enabled: process.env.NODE_ENV === 'development', colors: true },
69
- graylog: { enabled: false, host: '127.0.0.1', port: 12201, facility: 'next-mvp', staticMeta: { service: 'next-mvp', application: 'next-mvp', version: '1.0.0', environment: process.env.NODE_ENV || 'development', hostname: this.getHostname(), instance: process.env.NEXT_INSTANCE_ID || 'unknown' } },
70
- components: { auth: { enabled: true, prefix: '[AUTH]' }, idp: { enabled: true, prefix: '[IDP]' }, api: { enabled: true, prefix: '[API]' }, circuitBreaker: { enabled: true, prefix: '[CIRCUIT-BREAKER]' }, token: { enabled: true, prefix: '[TOKEN]' }, tokenSync: { enabled: true, prefix: '[TOKEN-SYNC]' }, tokenRefresh: { enabled: true, prefix: '[TOKEN-REFRESH]' }, redis: { enabled: true, prefix: '[REDIS]' } },
71
- levels: { error: 0, warn: 1, info: 2, http: 3, debug: 4 }
72
- };
73
- }
74
- }
75
-
76
- export const loggingConfigManager = new LoggingConfigManager();
77
- export const getLoggingConfig = () => loggingConfigManager.getConfig();
78
- export const getLoggingConfigSync = () => loggingConfigManager.getConfigSync();
79
- export const startConfigWatching = () => loggingConfigManager.startWatching();
80
- export const stopConfigWatching = () => loggingConfigManager.stopWatching();
81
- export const addConfigWatcher = (callback: (config: LoggingConfig) => void) => loggingConfigManager.addWatcher(callback);
82
- export const removeConfigWatcher = (callback: (config: LoggingConfig) => void) => loggingConfigManager.removeWatcher(callback);
1
+ import { promises as fs } from 'fs';
2
+ import { watch, existsSync } from 'fs';
3
+ import { LoggingConfig, LogLevel } from '../types/logging';
4
+
5
+ const isEdgeRuntime = typeof (globalThis as any).EdgeRuntime !== 'undefined' || process.env.NEXT_RUNTIME === 'edge';
6
+
7
+ class LoggingConfigManager {
8
+ private config: LoggingConfig | null = null;
9
+ private configPath: string;
10
+ private watchers: Set<(config: LoggingConfig) => void> = new Set();
11
+ private fileWatcher: ReturnType<typeof watch> | null = null;
12
+ private isEdgeRuntime: boolean;
13
+ private isBrowser: boolean;
14
+
15
+ constructor() {
16
+ this.isBrowser = typeof window !== 'undefined';
17
+ this.isEdgeRuntime = typeof (globalThis as any).EdgeRuntime !== 'undefined' || process.env.NEXT_RUNTIME === 'edge';
18
+ if (this.isEdgeRuntime || this.isBrowser) {
19
+ this.configPath = '/config/logging.json';
20
+ this.config = this.getDefaultConfig();
21
+ } else {
22
+ const cwd = process.cwd().replace(/\\/g, '/');
23
+ this.configPath = cwd + '/config/logging.json';
24
+ }
25
+ }
26
+
27
+ async loadConfig(): Promise<LoggingConfig> {
28
+ if (this.isEdgeRuntime || this.isBrowser) {
29
+ if (!this.config) { this.config = this.getDefaultConfig(); }
30
+ return this.config;
31
+ }
32
+ try {
33
+ const configContent = await fs.readFile(this.configPath, 'utf-8');
34
+ const rawConfig = JSON.parse(configContent);
35
+ const config = this.validateAndMergeConfig(rawConfig);
36
+ this.config = config; this.notifyWatchers(config); return config;
37
+ } catch (error) {
38
+ console.warn(`Failed to load logging config from ${this.configPath}:`, error);
39
+ return this.getDefaultConfig();
40
+ }
41
+ }
42
+
43
+ async getConfig(): Promise<LoggingConfig> { if (!this.config) { return await this.loadConfig(); } return this.config; }
44
+ getConfigSync(): LoggingConfig { return this.config || this.getDefaultConfig(); }
45
+
46
+ startWatching(): void { if (this.isEdgeRuntime || this.isBrowser) { return; } if (this.fileWatcher) { return; } try { if (!existsSync(this.configPath)) { console.warn(`Logging config file not found at ${this.configPath} — watch disabled`); return; } this.fileWatcher = watch(this.configPath, { persistent: false }, (eventType) => { if (eventType === 'change') { this.loadConfig().catch(console.error); } }); } catch (error) { console.warn('Failed to start watching logging config file:', error); } }
47
+ stopWatching(): void { if (this.isEdgeRuntime || this.isBrowser) { return; } if (this.fileWatcher) { this.fileWatcher.close(); this.fileWatcher = null; } }
48
+ addWatcher(callback: (config: LoggingConfig) => void): void { this.watchers.add(callback); }
49
+ removeWatcher(callback: (config: LoggingConfig) => void): void { this.watchers.delete(callback); }
50
+ private notifyWatchers(config: LoggingConfig): void { this.watchers.forEach(cb => { try { cb(config); } catch (error) { console.error('Error in logging config watcher:', error); } }); }
51
+
52
+ private validateAndMergeConfig(rawConfig: any): LoggingConfig {
53
+ const defaults = this.getDefaultConfig();
54
+ const config: LoggingConfig = {
55
+ logLevel: this.validateLogLevel(rawConfig.logLevel) || this.validateLogLevel(process.env.LOG_LEVEL) || defaults.logLevel,
56
+ console: { enabled: rawConfig.console?.enabled ?? (process.env.LOG_CONSOLE === 'true' || process.env.NODE_ENV === 'development'), colors: rawConfig.console?.colors ?? defaults.console.colors },
57
+ graylog: { enabled: false, host: defaults.graylog.host, port: defaults.graylog.port, facility: defaults.graylog.facility, staticMeta: { ...defaults.graylog.staticMeta } },
58
+ components: { ...defaults.components, ...rawConfig.components },
59
+ levels: { ...defaults.levels, ...rawConfig.levels }
60
+ };
61
+ return config;
62
+ }
63
+ private validateLogLevel(level: any): LogLevel | null { const validLevels: LogLevel[] = ['error', 'warn', 'info', 'http', 'debug']; return validLevels.includes(level) ? level : null; }
64
+ private getHostname(): string { if (this.isEdgeRuntime) return 'edge-runtime'; if (this.isBrowser) return 'browser-client'; try { return require('os').hostname(); } catch { return 'unknown'; } }
65
+ private getDefaultConfig(): LoggingConfig {
66
+ return {
67
+ logLevel: 'info',
68
+ console: { enabled: process.env.NODE_ENV === 'development', colors: true },
69
+ graylog: { enabled: false, host: '127.0.0.1', port: 12201, facility: 'next-mvp', staticMeta: { service: 'next-mvp', application: 'next-mvp', version: '1.0.0', environment: process.env.NODE_ENV || 'development', hostname: this.getHostname(), instance: process.env.NEXT_INSTANCE_ID || 'unknown' } },
70
+ components: { auth: { enabled: true, prefix: '[AUTH]' }, idp: { enabled: true, prefix: '[IDP]' }, api: { enabled: true, prefix: '[API]' }, circuitBreaker: { enabled: true, prefix: '[CIRCUIT-BREAKER]' }, token: { enabled: true, prefix: '[TOKEN]' }, tokenSync: { enabled: true, prefix: '[TOKEN-SYNC]' }, tokenRefresh: { enabled: true, prefix: '[TOKEN-REFRESH]' }, redis: { enabled: true, prefix: '[REDIS]' } },
71
+ levels: { error: 0, warn: 1, info: 2, http: 3, debug: 4 }
72
+ };
73
+ }
74
+ }
75
+
76
+ export const loggingConfigManager = new LoggingConfigManager();
77
+ export const getLoggingConfig = () => loggingConfigManager.getConfig();
78
+ export const getLoggingConfigSync = () => loggingConfigManager.getConfigSync();
79
+ export const startConfigWatching = () => loggingConfigManager.startWatching();
80
+ export const stopConfigWatching = () => loggingConfigManager.stopWatching();
81
+ export const addConfigWatcher = (callback: (config: LoggingConfig) => void) => loggingConfigManager.addWatcher(callback);
82
+ export const removeConfigWatcher = (callback: (config: LoggingConfig) => void) => loggingConfigManager.removeWatcher(callback);
@@ -1,19 +1,19 @@
1
- export interface UnauthenticatedRouteConfig { pattern: string; description: string; allowDuringCircuitBreakerOpen?: boolean; requiresRateLimit?: boolean; }
2
- export const UNAUTHENTICATED_ROUTES: UnauthenticatedRouteConfig[] = [
3
- { pattern: '/account-auth/*', description: 'All authentication pages', allowDuringCircuitBreakerOpen: true },
4
- { pattern: '/account-auth/login', description: 'Login page', allowDuringCircuitBreakerOpen: true },
5
- { pattern: '/account-auth/verify-code', description: '2FA page', allowDuringCircuitBreakerOpen: true },
6
- { pattern: '/api/auth/*', description: 'Auth API endpoints', allowDuringCircuitBreakerOpen: true, requiresRateLimit: true },
7
- { pattern: '/api/session/refresh-viability', description: 'Refresh viability check', allowDuringCircuitBreakerOpen: true },
8
- { pattern: '/landing', description: 'Public landing', allowDuringCircuitBreakerOpen: true },
9
- { pattern: '/service-unavailable', description: 'Service unavailable', allowDuringCircuitBreakerOpen: true },
10
- { pattern: '/favicon.ico', description: 'Favicon', allowDuringCircuitBreakerOpen: true },
11
- { pattern: '/robots.txt', description: 'Robots.txt', allowDuringCircuitBreakerOpen: true },
12
- { pattern: '/sitemap.xml', description: 'Sitemap', allowDuringCircuitBreakerOpen: true },
13
- { pattern: '/_next/*', description: 'Next.js assets', allowDuringCircuitBreakerOpen: true },
14
- { pattern: '/public/*', description: 'Public assets', allowDuringCircuitBreakerOpen: true }
15
- ];
16
- export function isUnauthenticatedRoute(pathname: string): boolean { return UNAUTHENTICATED_ROUTES.some(route => route.pattern.endsWith('*') ? pathname.startsWith(route.pattern.slice(0, -1)) : pathname === route.pattern); }
17
- export function isAllowedDuringCircuitBreakerOpen(pathname: string): boolean { const route = UNAUTHENTICATED_ROUTES.find(route => route.pattern.endsWith('*') ? pathname.startsWith(route.pattern.slice(0, -1)) : pathname === route.pattern); return route?.allowDuringCircuitBreakerOpen === true; }
18
- export function requiresRateLimit(pathname: string): boolean { const route = UNAUTHENTICATED_ROUTES.find(route => route.pattern.endsWith('*') ? pathname.startsWith(route.pattern.slice(0, -1)) : pathname === route.pattern); return route?.requiresRateLimit === true; }
19
- export default { UNAUTHENTICATED_ROUTES, isUnauthenticatedRoute, isAllowedDuringCircuitBreakerOpen, requiresRateLimit };
1
+ export interface UnauthenticatedRouteConfig { pattern: string; description: string; allowDuringCircuitBreakerOpen?: boolean; requiresRateLimit?: boolean; }
2
+ export const UNAUTHENTICATED_ROUTES: UnauthenticatedRouteConfig[] = [
3
+ { pattern: '/account-auth/*', description: 'All authentication pages', allowDuringCircuitBreakerOpen: true },
4
+ { pattern: '/account-auth/login', description: 'Login page', allowDuringCircuitBreakerOpen: true },
5
+ { pattern: '/account-auth/verify-code', description: '2FA page', allowDuringCircuitBreakerOpen: true },
6
+ { pattern: '/api/auth/*', description: 'Auth API endpoints', allowDuringCircuitBreakerOpen: true, requiresRateLimit: true },
7
+ { pattern: '/api/session/refresh-viability', description: 'Refresh viability check', allowDuringCircuitBreakerOpen: true },
8
+ { pattern: '/landing', description: 'Public landing', allowDuringCircuitBreakerOpen: true },
9
+ { pattern: '/service-unavailable', description: 'Service unavailable', allowDuringCircuitBreakerOpen: true },
10
+ { pattern: '/favicon.ico', description: 'Favicon', allowDuringCircuitBreakerOpen: true },
11
+ { pattern: '/robots.txt', description: 'Robots.txt', allowDuringCircuitBreakerOpen: true },
12
+ { pattern: '/sitemap.xml', description: 'Sitemap', allowDuringCircuitBreakerOpen: true },
13
+ { pattern: '/_next/*', description: 'Next.js assets', allowDuringCircuitBreakerOpen: true },
14
+ { pattern: '/public/*', description: 'Public assets', allowDuringCircuitBreakerOpen: true }
15
+ ];
16
+ export function isUnauthenticatedRoute(pathname: string): boolean { return UNAUTHENTICATED_ROUTES.some(route => route.pattern.endsWith('*') ? pathname.startsWith(route.pattern.slice(0, -1)) : pathname === route.pattern); }
17
+ export function isAllowedDuringCircuitBreakerOpen(pathname: string): boolean { const route = UNAUTHENTICATED_ROUTES.find(route => route.pattern.endsWith('*') ? pathname.startsWith(route.pattern.slice(0, -1)) : pathname === route.pattern); return route?.allowDuringCircuitBreakerOpen === true; }
18
+ export function requiresRateLimit(pathname: string): boolean { const route = UNAUTHENTICATED_ROUTES.find(route => route.pattern.endsWith('*') ? pathname.startsWith(route.pattern.slice(0, -1)) : pathname === route.pattern); return route?.requiresRateLimit === true; }
19
+ export default { UNAUTHENTICATED_ROUTES, isUnauthenticatedRoute, isAllowedDuringCircuitBreakerOpen, requiresRateLimit };
@@ -1,65 +1,65 @@
1
- /**
2
- * Internal API URL Utility for Edge Runtime
3
- *
4
- * INTERNAL_API_URL is REQUIRED. This is the URL for THIS application calling ITSELF.
5
- * Used for middleware to call its own API routes (e.g., /api/session/viability).
6
- *
7
- * WHY HTTP IS REQUIRED (not optional):
8
- * - This is the app calling its OWN backend within the same pod/container
9
- * - NextAuth cookies are encrypted based on request protocol
10
- * - TLS is terminated at ingress, so the pod receives HTTP internally
11
- * - Using HTTPS here causes cookie decryption failures
12
- * - This is NOT about "K8s internal traffic doesn't need TLS" - it's about
13
- * protocol consistency for cookie encryption
14
- *
15
- * This is NOT for calling the IDP - use IDP_URL for that.
16
- *
17
- * For local dev, set INTERNAL_API_URL=http://localhost:3000 (or your dev port).
18
- *
19
- * @module edge/internal-api-url
20
- * @version 3.0.0
21
- */
22
-
23
- import { NextRequest } from 'next/server';
24
-
25
- /**
26
- * Get the internal API base URL for middleware to call its own API routes.
27
- *
28
- * THROWS if INTERNAL_API_URL is not set. No fallbacks.
29
- *
30
- * @param request - The Next.js request object (unused, kept for API compatibility)
31
- * @returns Base URL string for constructing internal API calls
32
- * @throws Error if INTERNAL_API_URL environment variable is not set
33
- *
34
- * @example
35
- * ```typescript
36
- * import { getInternalApiUrl } from '@payez/next-mvp/edge';
37
- *
38
- * export async function middleware(request: NextRequest) {
39
- * const baseUrl = getInternalApiUrl(request);
40
- * const apiUrl = new URL('/api/session/check', baseUrl);
41
- *
42
- * const response = await fetch(apiUrl, {
43
- * headers: {
44
- * 'Cookie': request.headers.get('cookie') || ''
45
- * }
46
- * });
47
- * }
48
- * ```
49
- *
50
- * @environment INTERNAL_API_URL - REQUIRED. URL for this app to call ITSELF.
51
- * MUST be HTTP (not HTTPS) - see module docs for why.
52
- * K8s: http://myapp.namespace.svc.cluster.local:80
53
- * Local: http://localhost:3000
54
- */
55
- export function getInternalApiUrl(request: NextRequest): string {
56
- const internalUrl = process.env.INTERNAL_API_URL;
57
- if (!internalUrl) {
58
- throw new Error(
59
- '[INTERNAL_API_URL] FATAL: INTERNAL_API_URL environment variable is REQUIRED. ' +
60
- 'This is for the app to call ITSELF. MUST be HTTP (not HTTPS). ' +
61
- 'Set to http://myapp.namespace.svc.cluster.local:80 (K8s) or http://localhost:3000 (local).'
62
- );
63
- }
64
- return internalUrl;
65
- }
1
+ /**
2
+ * Internal API URL Utility for Edge Runtime
3
+ *
4
+ * INTERNAL_API_URL is REQUIRED. This is the URL for THIS application calling ITSELF.
5
+ * Used for middleware to call its own API routes (e.g., /api/session/viability).
6
+ *
7
+ * WHY HTTP IS REQUIRED (not optional):
8
+ * - This is the app calling its OWN backend within the same pod/container
9
+ * - NextAuth cookies are encrypted based on request protocol
10
+ * - TLS is terminated at ingress, so the pod receives HTTP internally
11
+ * - Using HTTPS here causes cookie decryption failures
12
+ * - This is NOT about "K8s internal traffic doesn't need TLS" - it's about
13
+ * protocol consistency for cookie encryption
14
+ *
15
+ * This is NOT for calling the IDP - use IDP_URL for that.
16
+ *
17
+ * For local dev, set INTERNAL_API_URL=http://localhost:3000 (or your dev port).
18
+ *
19
+ * @module edge/internal-api-url
20
+ * @version 3.0.0
21
+ */
22
+
23
+ import { NextRequest } from 'next/server';
24
+
25
+ /**
26
+ * Get the internal API base URL for middleware to call its own API routes.
27
+ *
28
+ * THROWS if INTERNAL_API_URL is not set. No fallbacks.
29
+ *
30
+ * @param request - The Next.js request object (unused, kept for API compatibility)
31
+ * @returns Base URL string for constructing internal API calls
32
+ * @throws Error if INTERNAL_API_URL environment variable is not set
33
+ *
34
+ * @example
35
+ * ```typescript
36
+ * import { getInternalApiUrl } from '@payez/next-mvp/edge';
37
+ *
38
+ * export async function middleware(request: NextRequest) {
39
+ * const baseUrl = getInternalApiUrl(request);
40
+ * const apiUrl = new URL('/api/session/check', baseUrl);
41
+ *
42
+ * const response = await fetch(apiUrl, {
43
+ * headers: {
44
+ * 'Cookie': request.headers.get('cookie') || ''
45
+ * }
46
+ * });
47
+ * }
48
+ * ```
49
+ *
50
+ * @environment INTERNAL_API_URL - REQUIRED. URL for this app to call ITSELF.
51
+ * MUST be HTTP (not HTTPS) - see module docs for why.
52
+ * K8s: http://myapp.namespace.svc.cluster.local:80
53
+ * Local: http://localhost:3000
54
+ */
55
+ export function getInternalApiUrl(request: NextRequest): string {
56
+ const internalUrl = process.env.INTERNAL_API_URL;
57
+ if (!internalUrl) {
58
+ throw new Error(
59
+ '[INTERNAL_API_URL] FATAL: INTERNAL_API_URL environment variable is REQUIRED. ' +
60
+ 'This is for the app to call ITSELF. MUST be HTTP (not HTTPS). ' +
61
+ 'Set to http://myapp.namespace.svc.cluster.local:80 (K8s) or http://localhost:3000 (local).'
62
+ );
63
+ }
64
+ return internalUrl;
65
+ }
@@ -1,42 +1,42 @@
1
- /**
2
- * Edge Runtime Compatible Exports
3
- *
4
- * This module exports only Edge Runtime compatible code for use in Next.js middleware.
5
- * Client-side utilities that depend on browser APIs or server-only code are excluded.
6
- */
7
-
8
- // Authentication middleware and configuration (Edge Runtime compatible)
9
- export { makeAuthDecision } from '../auth/auth-decision';
10
- export {
11
- isUnauthenticatedRoute,
12
- configurePublicRoutes,
13
- getRouteConfig,
14
- configure2FABypassRoutes,
15
- should2FABypass,
16
- get2FABypassConfig
17
- } from '../auth/route-config';
18
- export type { UnauthenticatedRouteConfig, ProtectedRouteConfig } from '../auth/route-config';
19
- export { createMvpMiddleware } from '../middleware/create-middleware';
20
- export type {
21
- MvpMiddlewareOptions,
22
- CircuitBreakerProvider,
23
- MiddlewareLogger,
24
- AuthContext,
25
- AuthAction,
26
- SessionPointer,
27
- SessionStatus
28
- } from '../middleware/create-middleware';
29
-
30
- // Two-Factor Authentication Presets (Edge Runtime compatible)
31
- export {
32
- TwoFactorPresets,
33
- AMRValues,
34
- ACRLevels,
35
- validateAMR,
36
- validateACR,
37
- checkTwoFactorRequirements
38
- } from '../middleware/twofa-presets';
39
- export type { TwoFactorRequirements, RouteConfig } from '../middleware/twofa-presets';
40
-
41
- // Internal API URL utilities for Edge Runtime
42
- export { getInternalApiUrl } from './internal-api-url';
1
+ /**
2
+ * Edge Runtime Compatible Exports
3
+ *
4
+ * This module exports only Edge Runtime compatible code for use in Next.js middleware.
5
+ * Client-side utilities that depend on browser APIs or server-only code are excluded.
6
+ */
7
+
8
+ // Authentication middleware and configuration (Edge Runtime compatible)
9
+ export { makeAuthDecision } from '../auth/auth-decision';
10
+ export {
11
+ isUnauthenticatedRoute,
12
+ configurePublicRoutes,
13
+ getRouteConfig,
14
+ configure2FABypassRoutes,
15
+ should2FABypass,
16
+ get2FABypassConfig
17
+ } from '../auth/route-config';
18
+ export type { UnauthenticatedRouteConfig, ProtectedRouteConfig } from '../auth/route-config';
19
+ export { createMvpMiddleware } from '../middleware/create-middleware';
20
+ export type {
21
+ MvpMiddlewareOptions,
22
+ CircuitBreakerProvider,
23
+ MiddlewareLogger,
24
+ AuthContext,
25
+ AuthAction,
26
+ SessionPointer,
27
+ SessionStatus
28
+ } from '../middleware/create-middleware';
29
+
30
+ // Two-Factor Authentication Presets (Edge Runtime compatible)
31
+ export {
32
+ TwoFactorPresets,
33
+ AMRValues,
34
+ ACRLevels,
35
+ validateAMR,
36
+ validateACR,
37
+ checkTwoFactorRequirements
38
+ } from '../middleware/twofa-presets';
39
+ export type { TwoFactorRequirements, RouteConfig } from '../middleware/twofa-presets';
40
+
41
+ // Internal API URL utilities for Edge Runtime
42
+ export { getInternalApiUrl } from './internal-api-url';
@@ -1,75 +1,75 @@
1
- 'use client';
2
-
3
- /**
4
- * ⚠️ WARNING: This hook cannot be used directly from the @payez/next-mvp package!
5
- *
6
- * @deprecated Import this hook from your local app instead
7
- *
8
- * **Why?** This hook depends on useAuth, which requires SessionProvider context that cannot cross package boundaries.
9
- *
10
- * **Solution:** Create a local version in your app (e.g., src/hooks/useProfile.ts):
11
- *
12
- * @example
13
- * ```typescript
14
- * // src/hooks/useProfile.ts (YOUR APP)
15
- * 'use client';
16
- * import { useQuery } from '@tanstack/react-query';
17
- * import { useAuth } from './useAuth'; // Your local useAuth
18
- * import { isApiSuccess } from '@payez/next-mvp/lib/standardized-client-api';
19
- *
20
- * export function useProfile() {
21
- * const { isAuthenticated, apiCall } = useAuth();
22
- * return useQuery({
23
- * queryKey: ['account', 'profile'],
24
- * enabled: isAuthenticated,
25
- * queryFn: async () => {
26
- * const result = await apiCall('/api/account/profile', 'GET');
27
- * if (isApiSuccess(result)) return result.data;
28
- * throw new Error(result.message);
29
- * }
30
- * });
31
- * }
32
- * ```
33
- *
34
- * @see {@link https://github.com/payez/next-mvp/blob/main/docs/centralized-auth-api-pattern.md#usage-patterns Complete documentation}
35
- */
36
-
37
- import { useQuery } from '@tanstack/react-query';
38
- import { useAuth } from './useAuth';
39
- import { isApiSuccess, isApiError } from '../lib/standardized-client-api';
40
-
41
- export type ProfileResponse = {
42
- email: string;
43
- user_id?: string;
44
- first_name?: string;
45
- last_name?: string;
46
- full_name?: string;
47
- phone_number?: string;
48
- email_confirmed?: boolean;
49
- phone_confirmed?: boolean;
50
- two_factor_enabled?: boolean;
51
- roles?: string[];
52
- contact_information?: Record<string, any>;
53
- [key: string]: any;
54
- };
55
-
56
- export function useProfile() {
57
- const { isAuthenticated, apiCall } = useAuth();
58
-
59
- return useQuery<ProfileResponse, Error>({
60
- queryKey: ['account', 'profile'],
61
- enabled: isAuthenticated,
62
- queryFn: async () => {
63
- const result = await apiCall<ProfileResponse>('/api/account/profile', 'GET');
64
- if (isApiSuccess(result)) {
65
- return result.data;
66
- }
67
- // If API returned standardized error
68
- if (isApiError(result)) {
69
- throw new Error(result.message || 'Failed to load profile');
70
- }
71
- throw new Error('Failed to load profile');
72
- },
73
- staleTime: 5 * 60 * 1000,
74
- });
75
- }
1
+ 'use client';
2
+
3
+ /**
4
+ * ⚠️ WARNING: This hook cannot be used directly from the @payez/next-mvp package!
5
+ *
6
+ * @deprecated Import this hook from your local app instead
7
+ *
8
+ * **Why?** This hook depends on useAuth, which requires SessionProvider context that cannot cross package boundaries.
9
+ *
10
+ * **Solution:** Create a local version in your app (e.g., src/hooks/useProfile.ts):
11
+ *
12
+ * @example
13
+ * ```typescript
14
+ * // src/hooks/useProfile.ts (YOUR APP)
15
+ * 'use client';
16
+ * import { useQuery } from '@tanstack/react-query';
17
+ * import { useAuth } from './useAuth'; // Your local useAuth
18
+ * import { isApiSuccess } from '@payez/next-mvp/lib/standardized-client-api';
19
+ *
20
+ * export function useProfile() {
21
+ * const { isAuthenticated, apiCall } = useAuth();
22
+ * return useQuery({
23
+ * queryKey: ['account', 'profile'],
24
+ * enabled: isAuthenticated,
25
+ * queryFn: async () => {
26
+ * const result = await apiCall('/api/account/profile', 'GET');
27
+ * if (isApiSuccess(result)) return result.data;
28
+ * throw new Error(result.message);
29
+ * }
30
+ * });
31
+ * }
32
+ * ```
33
+ *
34
+ * @see {@link https://github.com/payez/next-mvp/blob/main/docs/centralized-auth-api-pattern.md#usage-patterns Complete documentation}
35
+ */
36
+
37
+ import { useQuery } from '@tanstack/react-query';
38
+ import { useAuth } from './useAuth';
39
+ import { isApiSuccess, isApiError } from '../lib/standardized-client-api';
40
+
41
+ export type ProfileResponse = {
42
+ email: string;
43
+ user_id?: string;
44
+ first_name?: string;
45
+ last_name?: string;
46
+ full_name?: string;
47
+ phone_number?: string;
48
+ email_confirmed?: boolean;
49
+ phone_confirmed?: boolean;
50
+ two_factor_enabled?: boolean;
51
+ roles?: string[];
52
+ contact_information?: Record<string, any>;
53
+ [key: string]: any;
54
+ };
55
+
56
+ export function useProfile() {
57
+ const { isAuthenticated, apiCall } = useAuth();
58
+
59
+ return useQuery<ProfileResponse, Error>({
60
+ queryKey: ['account', 'profile'],
61
+ enabled: isAuthenticated,
62
+ queryFn: async () => {
63
+ const result = await apiCall<ProfileResponse>('/api/account/profile', 'GET');
64
+ if (isApiSuccess(result)) {
65
+ return result.data;
66
+ }
67
+ // If API returned standardized error
68
+ if (isApiError(result)) {
69
+ throw new Error(result.message || 'Failed to load profile');
70
+ }
71
+ throw new Error('Failed to load profile');
72
+ },
73
+ staleTime: 5 * 60 * 1000,
74
+ });
75
+ }