@payez/next-mvp 4.8.0 → 4.8.2

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 (301) hide show
  1. package/POST-INSTALL.md +408 -408
  2. package/README.md +859 -859
  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/lib/session-store.js +21 -21
  8. package/dist/lib/startup-init.js +19 -19
  9. package/dist/middleware/create-middleware.js +6 -5
  10. package/dist/pages/login/page.js +28 -28
  11. package/dist/pages/settings/EnhancedSettingsPage.js +17 -17
  12. package/dist/vibe/sessions.js +28 -3
  13. package/package.json +2 -2
  14. package/scripts/check-publish-eol.mjs +33 -15
  15. package/src/api/auth-handler.ts +550 -550
  16. package/src/api/index.ts +17 -17
  17. package/src/api-handlers/account/change-password.ts +170 -170
  18. package/src/api-handlers/account/masked-info.ts +46 -46
  19. package/src/api-handlers/account/profile.ts +99 -99
  20. package/src/api-handlers/account/recovery/forward.ts +117 -117
  21. package/src/api-handlers/account/recovery/initiate.ts +59 -59
  22. package/src/api-handlers/account/recovery/send-code.ts +21 -21
  23. package/src/api-handlers/account/recovery/verify-code.ts +20 -20
  24. package/src/api-handlers/account/reset-password.ts +87 -87
  25. package/src/api-handlers/account/send-code.ts +70 -70
  26. package/src/api-handlers/account/update-phone.ts +84 -84
  27. package/src/api-handlers/account/validate-password.ts +139 -139
  28. package/src/api-handlers/account/verify-email.ts +134 -134
  29. package/src/api-handlers/account/verify-sms.ts +134 -134
  30. package/src/api-handlers/admin/analytics.ts +452 -452
  31. package/src/api-handlers/admin/audit.ts +232 -232
  32. package/src/api-handlers/admin/index.ts +63 -63
  33. package/src/api-handlers/admin/redis-sessions.ts +259 -259
  34. package/src/api-handlers/admin/sessions.ts +327 -327
  35. package/src/api-handlers/admin/site-logs.ts +388 -388
  36. package/src/api-handlers/admin/stats.ts +260 -260
  37. package/src/api-handlers/admin/users.ts +251 -251
  38. package/src/api-handlers/admin/vibe-data.ts +333 -333
  39. package/src/api-handlers/anon/preferences.ts +123 -123
  40. package/src/api-handlers/auth/credential-login-email-code.ts +92 -92
  41. package/src/api-handlers/auth/credential-login.ts +948 -948
  42. package/src/api-handlers/auth/jwks.ts +31 -31
  43. package/src/api-handlers/auth/login.ts +252 -252
  44. package/src/api-handlers/auth/passkey-signin.ts +116 -116
  45. package/src/api-handlers/auth/refresh.ts +829 -829
  46. package/src/api-handlers/auth/signout.ts +201 -201
  47. package/src/api-handlers/auth/status.ts +23 -23
  48. package/src/api-handlers/auth/update-session.ts +144 -144
  49. package/src/api-handlers/auth/validate.ts +45 -45
  50. package/src/api-handlers/auth/verify-code.ts +116 -116
  51. package/src/api-handlers/mfa/backup-code-verify.ts +170 -170
  52. package/src/api-handlers/mfa/backup-codes.ts +42 -42
  53. package/src/api-handlers/mfa/methods.ts +47 -47
  54. package/src/api-handlers/mfa/totp-confirm.ts +43 -43
  55. package/src/api-handlers/mfa/totp-enroll.ts +43 -43
  56. package/src/api-handlers/mfa/totp-verify.ts +172 -172
  57. package/src/api-handlers/oauth/resume.ts +182 -182
  58. package/src/api-handlers/onboarding/send-email-code.ts +18 -18
  59. package/src/api-handlers/onboarding/set-password.ts +21 -21
  60. package/src/api-handlers/onboarding/verify-code.ts +20 -20
  61. package/src/api-handlers/onboarding/verify-welcome-email.ts +17 -17
  62. package/src/api-handlers/passkeys/list.ts +32 -32
  63. package/src/api-handlers/passkeys/manage.ts +55 -55
  64. package/src/api-handlers/passkeys/register-options.ts +43 -43
  65. package/src/api-handlers/passkeys/register-verify.ts +42 -42
  66. package/src/api-handlers/session/refresh-viability.ts +56 -56
  67. package/src/api-handlers/session/viability.ts +238 -238
  68. package/src/api-handlers/test/force-expire.ts +167 -167
  69. package/src/auth/auth-decision.ts +292 -292
  70. package/src/auth/better-auth.ts +1688 -1688
  71. package/src/auth/idp-oauth.ts +310 -310
  72. package/src/auth/password-reset-bridge.ts +98 -98
  73. package/src/auth/route-config.ts +236 -236
  74. package/src/auth/safe-callback.ts +199 -199
  75. package/src/auth/session-cookie-clear.ts +30 -30
  76. package/src/auth/session-reset-link.ts +159 -159
  77. package/src/auth/session-response-sanitizer.ts +151 -151
  78. package/src/auth/types/auth-types.ts +555 -555
  79. package/src/auth/types/index.ts +7 -7
  80. package/src/auth/unauthenticated-routes.ts +2 -2
  81. package/src/auth/utils/idp-client.ts +364 -364
  82. package/src/auth/utils/index.ts +6 -6
  83. package/src/auth/utils/token-utils.ts +243 -243
  84. package/src/client/AuthContext.tsx +192 -192
  85. package/src/client/better-auth-client.ts +70 -70
  86. package/src/client/fetch-with-auth.ts +47 -47
  87. package/src/client/fetchWithSession.ts +21 -21
  88. package/src/client/index.ts +13 -13
  89. package/src/client/useAnonSession.ts +131 -131
  90. package/src/components/SessionSync.tsx +138 -138
  91. package/src/components/SignalRHealthCheck.tsx +131 -131
  92. package/src/components/account/MobileNavDrawer.tsx +305 -305
  93. package/src/components/account/UserAvatarMenu.tsx +277 -277
  94. package/src/components/account/index.ts +13 -13
  95. package/src/components/admin/AlertSettingsTab.tsx +728 -728
  96. package/src/components/admin/AnalyticsTab.tsx +703 -703
  97. package/src/components/admin/DataBrowserTab.tsx +508 -508
  98. package/src/components/admin/LoggingSettingsTab.tsx +665 -665
  99. package/src/components/admin/SessionsTab.tsx +421 -421
  100. package/src/components/admin/StatsTab.tsx +379 -379
  101. package/src/components/admin/VibeAdminContext.tsx +87 -87
  102. package/src/components/admin/VibeAdminLayout.tsx +187 -187
  103. package/src/components/admin/index.ts +59 -59
  104. package/src/components/auth/CredentialSignInForm.tsx +240 -240
  105. package/src/components/auth/FederatedAuthSection.tsx +129 -129
  106. package/src/components/auth/ModeAwareLoginPage.tsx +146 -146
  107. package/src/components/auth/ModeAwareSignupPage.tsx +200 -200
  108. package/src/components/auth/PasswordResetBridge.tsx +30 -30
  109. package/src/components/auth/TraditionalAuthSection.tsx +103 -103
  110. package/src/components/recovery/CompleteStep.tsx +36 -36
  111. package/src/components/recovery/InitiateRecoveryStep.tsx +68 -68
  112. package/src/components/recovery/RequestedStep.tsx +30 -30
  113. package/src/components/recovery/SelectMethodStep.tsx +73 -73
  114. package/src/components/recovery/SetPasswordStep.tsx +118 -118
  115. package/src/components/recovery/VerifyCodeStep.tsx +90 -90
  116. package/src/components/reserved/ReservedRecoveryWarning.tsx +160 -160
  117. package/src/components/reserved/ReservedStatusBox.tsx +118 -118
  118. package/src/components/ui/BetaBadge.tsx +58 -58
  119. package/src/components/ui/Footer.tsx +93 -93
  120. package/src/config/env.ts +55 -55
  121. package/src/config/logger.ts +62 -62
  122. package/src/config/logging-config.ts +82 -82
  123. package/src/config/unauthenticated-routes.ts +19 -19
  124. package/src/config/vibe-log-transport.ts +264 -264
  125. package/src/edge/internal-api-url.ts +65 -65
  126. package/src/edge/middleware.ts +42 -42
  127. package/src/hooks/useAuth.ts +117 -117
  128. package/src/hooks/useAuthSettings.ts +109 -109
  129. package/src/hooks/useAvailableProviders.ts +143 -143
  130. package/src/hooks/usePasswordValidation.ts +127 -127
  131. package/src/hooks/useProfile.ts +82 -82
  132. package/src/hooks/usePublicAuthSettings.ts +171 -171
  133. package/src/hooks/useSessionExpiration.ts +101 -101
  134. package/src/hooks/useViabilitySession.ts +337 -337
  135. package/src/index.ts +64 -64
  136. package/src/lib/anon-session.ts +213 -213
  137. package/src/lib/api-handler.ts +643 -643
  138. package/src/lib/app-slug.ts +228 -228
  139. package/src/lib/authorize-resume.ts +172 -172
  140. package/src/lib/bearer-fetch.ts +31 -31
  141. package/src/lib/client-key.ts +88 -88
  142. package/src/lib/code-step-copy.ts +83 -83
  143. package/src/lib/credential-sign-in-client.ts +101 -101
  144. package/src/lib/demo-mode.ts +18 -18
  145. package/src/lib/device-id.ts +67 -67
  146. package/src/lib/ensure-fresh-access-token.ts +509 -509
  147. package/src/lib/geolocation.ts +265 -265
  148. package/src/lib/idp-client-config.ts +1005 -1005
  149. package/src/lib/idp-fetch.ts +169 -169
  150. package/src/lib/idp-url-guard.ts +37 -37
  151. package/src/lib/internal-api.ts +171 -171
  152. package/src/lib/jwt-decode-client.ts +45 -45
  153. package/src/lib/jwt-decode.ts +82 -82
  154. package/src/lib/lock-window.ts +49 -49
  155. package/src/lib/login-error-message.ts +41 -41
  156. package/src/lib/never-in-response.ts +64 -64
  157. package/src/lib/nextauth-secret.ts +168 -168
  158. package/src/lib/onboarding-proxy.ts +57 -57
  159. package/src/lib/password-rules.ts +50 -50
  160. package/src/lib/rate-limit-service.ts +9 -9
  161. package/src/lib/redis.ts +105 -105
  162. package/src/lib/refresh-token-validator.ts +64 -64
  163. package/src/lib/roles.ts +177 -177
  164. package/src/lib/safe-error-response.ts +149 -149
  165. package/src/lib/secret-validation.ts +8 -8
  166. package/src/lib/session-cookie-shape.ts +185 -185
  167. package/src/lib/session-store.ts +1092 -1092
  168. package/src/lib/session.ts +34 -34
  169. package/src/lib/single-flight.ts +64 -64
  170. package/src/lib/site-logger.ts +245 -245
  171. package/src/lib/standardized-client-api.ts +901 -901
  172. package/src/lib/startup-init.ts +276 -276
  173. package/src/lib/test-aware-get-token.ts +41 -41
  174. package/src/lib/token-expiry.ts +40 -40
  175. package/src/lib/token-lifecycle.ts +546 -546
  176. package/src/lib/token-log-id.ts +69 -69
  177. package/src/lib/twofa-rejection.ts +91 -91
  178. package/src/lib/types/api-responses.ts +336 -336
  179. package/src/lib/user-agent-parser.ts +252 -252
  180. package/src/logging/api/admin-analytics.ts +51 -51
  181. package/src/logging/api/audit-log.ts +53 -53
  182. package/src/logging/components/AdminAnalyticsLayout.tsx +49 -49
  183. package/src/logging/components/AuditLogViewer.tsx +125 -125
  184. package/src/logging/components/ErrorMetricsCard.tsx +98 -98
  185. package/src/logging/components/HealthMetricsCard.tsx +70 -70
  186. package/src/logging/hooks/useAdminAnalytics.ts +22 -22
  187. package/src/logging/hooks/useAuditLog.ts +24 -24
  188. package/src/logging/hooks/useErrorMetrics.ts +40 -40
  189. package/src/logging/hooks/useHealthMetrics.ts +44 -44
  190. package/src/logging/index.ts +18 -18
  191. package/src/logging/types/analytics.ts +81 -81
  192. package/src/logging/types/audit.ts +31 -31
  193. package/src/logging/types/index.ts +3 -3
  194. package/src/middleware/create-middleware.ts +1139 -1138
  195. package/src/middleware/rbac-check.ts +279 -279
  196. package/src/middleware/twofa-presets.ts +224 -224
  197. package/src/models/DecodedAccessToken.ts +16 -16
  198. package/src/models/SessionModel.ts +331 -331
  199. package/src/pages/admin-login/page.tsx +111 -111
  200. package/src/pages/admin-page-permissions/PagePermissionsAdminPage.tsx +527 -527
  201. package/src/pages/admin-page-permissions/index.ts +7 -7
  202. package/src/pages/admin-roles/RolesAdminPage.tsx +533 -533
  203. package/src/pages/admin-roles/index.ts +9 -9
  204. package/src/pages/admin-roles/modals.tsx +469 -469
  205. package/src/pages/client-admin/ClientSiteAdminPage.tsx +382 -382
  206. package/src/pages/client-admin/index.ts +33 -33
  207. package/src/pages/coming-soon/page.tsx +83 -83
  208. package/src/pages/login/page.tsx +338 -338
  209. package/src/pages/onboarding/index.ts +11 -11
  210. package/src/pages/onboarding/page.tsx +212 -212
  211. package/src/pages/profile/EnhancedProfilePage.tsx +514 -514
  212. package/src/pages/profile/index.ts +9 -9
  213. package/src/pages/profile/page.tsx +166 -166
  214. package/src/pages/recovery/page.tsx +267 -267
  215. package/src/pages/roles/MyRolesPage.tsx +211 -211
  216. package/src/pages/roles/components.tsx +294 -294
  217. package/src/pages/roles/index.ts +17 -17
  218. package/src/pages/security/EnhancedSecurityPage.tsx +660 -660
  219. package/src/pages/security/index.ts +12 -12
  220. package/src/pages/security/page.tsx +507 -507
  221. package/src/pages/settings/EnhancedSettingsPage.tsx +642 -642
  222. package/src/pages/settings/index.ts +9 -9
  223. package/src/pages/settings/page.tsx +47 -47
  224. package/src/pages/showcase/ShowcasePage.tsx +532 -532
  225. package/src/pages/showcase/index.ts +13 -13
  226. package/src/pages/test-env/EmergencyLogoutPage.tsx +192 -192
  227. package/src/pages/test-env/JwtInspectPage.tsx +449 -449
  228. package/src/pages/test-env/RefreshTokenPage.tsx +178 -178
  229. package/src/pages/test-env/TestEnvPage.tsx +130 -130
  230. package/src/pages/test-env/guarded.tsx +81 -81
  231. package/src/pages/test-env/index.ts +77 -77
  232. package/src/pages/test-env/redact-credentials.ts +96 -96
  233. package/src/pages/verify-code/page.tsx +746 -746
  234. package/src/routes/account/index.ts +31 -31
  235. package/src/routes/account/masked-info.ts +36 -36
  236. package/src/routes/account/send-code.ts +39 -39
  237. package/src/routes/account/update-phone.ts +13 -13
  238. package/src/routes/account/verify-email.ts +40 -40
  239. package/src/routes/account/verify-sms.ts +40 -40
  240. package/src/routes/auth/credential-login-email-code.ts +6 -6
  241. package/src/routes/auth/credential-login.ts +6 -6
  242. package/src/routes/auth/index.ts +22 -22
  243. package/src/routes/auth/logout.ts +111 -111
  244. package/src/routes/auth/nextauth.ts +45 -45
  245. package/src/routes/auth/passkey-signin.ts +13 -13
  246. package/src/routes/auth/refresh.ts +77 -77
  247. package/src/routes/auth/session-reset.ts +37 -37
  248. package/src/routes/auth/session.ts +261 -261
  249. package/src/routes/auth/settings.ts +181 -181
  250. package/src/routes/auth/viability.ts +519 -519
  251. package/src/routes/index.ts +17 -17
  252. package/src/routes/mfa/backup-code-verify.ts +1 -1
  253. package/src/routes/mfa/backup-codes.ts +10 -10
  254. package/src/routes/mfa/methods.ts +22 -22
  255. package/src/routes/mfa/totp-confirm.ts +10 -10
  256. package/src/routes/mfa/totp-enroll.ts +10 -10
  257. package/src/routes/mfa/totp-verify.ts +14 -14
  258. package/src/routes/onboarding/index.ts +15 -15
  259. package/src/routes/onboarding/send-email-code.ts +2 -2
  260. package/src/routes/onboarding/set-password.ts +2 -2
  261. package/src/routes/onboarding/verify-code.ts +2 -2
  262. package/src/routes/onboarding/verify-welcome-email.ts +2 -2
  263. package/src/routes/passkeys/list.ts +10 -10
  264. package/src/routes/passkeys/manage.ts +23 -23
  265. package/src/routes/passkeys/register-options.ts +10 -10
  266. package/src/routes/passkeys/register-verify.ts +10 -10
  267. package/src/routes/session/index.ts +7 -7
  268. package/src/routes/session/refresh-viability.ts +17 -17
  269. package/src/server/auth-guard.ts +203 -203
  270. package/src/server/auth.ts +486 -486
  271. package/src/server/decode-session.ts +309 -309
  272. package/src/server/slim-middleware.ts +117 -117
  273. package/src/server/verified-session-token.ts +103 -103
  274. package/src/server/with-auth.ts +93 -93
  275. package/src/services/signalrActivityService.ts +258 -258
  276. package/src/stores/authStore.ts +1900 -1900
  277. package/src/templates/instrumentation.ts +60 -60
  278. package/src/theme/ThemeProvider.tsx +39 -39
  279. package/src/theme/default.ts +33 -33
  280. package/src/theme/index.ts +31 -31
  281. package/src/theme/types.ts +69 -69
  282. package/src/theme/useTheme.ts +57 -57
  283. package/src/theme/utils.ts +40 -40
  284. package/src/types/api.ts +12 -12
  285. package/src/types/auth.d.ts +23 -23
  286. package/src/types/auth.ts +48 -48
  287. package/src/types/logging.ts +11 -11
  288. package/src/types/recovery.ts +54 -54
  289. package/src/utils/api.ts +401 -401
  290. package/src/utils/circuitBreaker.ts +40 -40
  291. package/src/utils/error-message.ts +108 -108
  292. package/src/utils/layout/reservedSpace.ts +124 -124
  293. package/src/utils/logout.ts +30 -30
  294. package/src/vibe/client.ts +877 -877
  295. package/src/vibe/enterprise-auth.ts +208 -208
  296. package/src/vibe/errors.ts +209 -209
  297. package/src/vibe/generic.ts +339 -339
  298. package/src/vibe/hooks/index.ts +367 -367
  299. package/src/vibe/index.ts +133 -133
  300. package/src/vibe/sessions.ts +925 -899
  301. package/src/vibe/types.ts +577 -577
@@ -1,276 +1,276 @@
1
- /**
2
- * Startup Initialization for MVP
3
- *
4
- * This module ensures that critical initialization tasks are completed
5
- * before the application serves requests.
6
- *
7
- * Uses unified IDP client config for:
8
- * - BETTER_AUTH_SECRET (the Better Auth signing secret)
9
- * - OAuth provider configuration
10
- * - Auth settings (2FA, session timeouts, etc.)
11
- */
12
-
13
- import 'server-only';
14
- import { getIDPClientConfig, clearConfigRedisCache, type IDPClientConfig } from './idp-client-config';
15
- import { slugStateReason } from './app-slug';
16
-
17
- let initializationStarted = false;
18
- let initializationComplete = false;
19
- let initializationFailed = false;
20
- let initializationPromise: Promise<void> | null = null;
21
- let lastInitError: Error | null = null;
22
-
23
- // Cached IDP config for access after initialization
24
- let cachedIDPConfig: IDPClientConfig | null = null;
25
-
26
- // Startup backoff to prevent pod restart storms from hammering IDP
27
- let lastStartupAttemptTime = 0;
28
- const STARTUP_BACKOFF_MS = 30000; // 30 seconds between startup attempts after failure
29
-
30
- /**
31
- * Initialize the application startup sequence (async)
32
- * Handles async initialization like fetching secrets from IDP
33
- */
34
- export async function ensureInitialized(): Promise<void> {
35
- // If already initialized, return immediately
36
- if (initializationComplete) {
37
- return;
38
- }
39
-
40
- // If initialization is in progress, wait for it
41
- if (initializationPromise) {
42
- return initializationPromise;
43
- }
44
-
45
- // Prevent hammering IDP on rapid pod restarts
46
- const now = Date.now();
47
- if (initializationFailed && (now - lastStartupAttemptTime) < STARTUP_BACKOFF_MS) {
48
- const remainingMs = STARTUP_BACKOFF_MS - (now - lastStartupAttemptTime);
49
- console.warn('[STARTUP] In backoff period after previous failure, skipping IDP call', {
50
- remainingMs: Math.round(remainingMs),
51
- lastError: lastInitError?.message
52
- });
53
- // Re-throw last error so callers know we're still in failed state
54
- throw lastInitError || new Error('Initialization in backoff period');
55
- }
56
-
57
- // Track this attempt time
58
- lastStartupAttemptTime = now;
59
-
60
- // Mark as started
61
- initializationStarted = true;
62
-
63
- // Start initialization.
64
- //
65
- // PAY-642: a FAILED attempt must not stay installed. This used to be
66
- // `initializationPromise = performInitialization(); await initializationPromise;` with no reset, and the
67
- // in-progress check above runs BEFORE the backoff check, so a pod that booted while the IdP was down replayed
68
- // its first rejection to every caller forever: the 30 s backoff could never lead to a retry. Same latch, same
69
- // fix, as createSingleFlight (lib/single-flight.ts): callers of the failing attempt still see the rejection
70
- // (loud), then the attempt clears itself, identity-guarded so a slow failure never evicts a newer attempt.
71
- // After a failure the backoff check above governs when the next attempt may start.
72
- const attempt = performInitialization();
73
- initializationPromise = attempt;
74
- attempt.catch(() => {
75
- if (initializationPromise === attempt) initializationPromise = null;
76
- });
77
- await attempt;
78
- }
79
-
80
- /**
81
- * Synchronously log startup status
82
- * Can be called before async initialization is complete
83
- */
84
- export function logStartupStatus(): void {
85
- if (!initializationStarted) {
86
- console.log('\n');
87
- console.log('╔══════════════════════════════════════════════════════════════╗');
88
- console.log('ā•‘ šŸš€ PayEz Next MVP - Starting Up ā•‘');
89
- console.log('ā•‘ ā•‘');
90
- console.log('ā•‘ Async initialization in progress... ā•‘');
91
- console.log('ā•‘ - Resolving BETTER_AUTH_SECRET from IDP ā•‘');
92
- console.log('ā•‘ - Verifying environment configuration ā•‘');
93
- console.log('ā•‘ ā•‘');
94
- console.log('ā•‘ Check logs below for detailed initialization status: ā•‘');
95
- console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
96
- console.log('');
97
- } else if (initializationComplete) {
98
- console.log('\n');
99
- console.log('╔══════════════════════════════════════════════════════════════╗');
100
- console.log('ā•‘ ✨ PayEz Next MVP Ready for Requests ✨ ā•‘');
101
- console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
102
- console.log('');
103
- } else if (lastInitError) {
104
- console.log('\n');
105
- console.log('╔══════════════════════════════════════════════════════════════╗');
106
- console.log('ā•‘ āš ļø Startup error detected - initialization may still retry ā•‘');
107
- console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
108
- console.log('');
109
- }
110
- }
111
-
112
- async function performInitialization(): Promise<void> {
113
- console.log('\n');
114
- console.log('╔══════════════════════════════════════════════════════════════╗');
115
- console.log('ā•‘ PayEz Next MVP - Async Startup ā•‘');
116
- console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
117
- console.log('');
118
-
119
- try {
120
- // Step 1: Fetch full client config from IDP (includes secret, providers, settings)
121
- console.log('[STARTUP] Step 1/2: Fetching client config from IDP...');
122
-
123
- // Clear any stale Redis cache so startup always gets fresh IDP data
124
- await clearConfigRedisCache();
125
-
126
- try {
127
- const config = await getIDPClientConfig(true);
128
- cachedIDPConfig = config;
129
-
130
- console.log('[STARTUP] Client config loaded successfully');
131
- console.log('[STARTUP] - Client ID:', config.clientId);
132
- console.log('[STARTUP] - Client Slug:', config.clientSlug);
133
- console.log('[STARTUP] - Secret length:', config.authSecret?.length || 0, 'chars');
134
- console.log('[STARTUP] - OAuth Providers:', config.oauthProviders?.filter(p => p.enabled).map(p => p.provider).join(', ') || 'none');
135
- console.log('[STARTUP] - Require 2FA:', config.authSettings?.require2FA);
136
- console.log('[STARTUP] - Cache TTL:', config.configCacheTtlSeconds, 'seconds');
137
- console.log('[STARTUP] - Base Client URL:', config.baseClientUrl || '(not set)');
138
-
139
- // Set BETTER_AUTH_SECRET from IDP response if not already set.
140
- // Also mirror to legacy NEXTAUTH_SECRET during the rename transition
141
- // so any consumer code still reading the old name keeps working.
142
- if (config.authSecret && !process.env.BETTER_AUTH_SECRET) {
143
- process.env.BETTER_AUTH_SECRET = config.authSecret;
144
- console.log('[STARTUP] Set BETTER_AUTH_SECRET from IDP config');
145
- }
146
- if (config.authSecret && !process.env.NEXTAUTH_SECRET) {
147
- process.env.NEXTAUTH_SECRET = config.authSecret;
148
- }
149
- } catch (error) {
150
- const errorMsg = error instanceof Error ? error.message : String(error);
151
- console.error('[STARTUP] IDP config fetch failed:', errorMsg);
152
-
153
- // No fallback available — IDP config is the only source for the auth secret
154
- console.error('[STARTUP] No fallback available for auth secret resolution');
155
- }
156
-
157
- // Step 2: Verify BETTER_AUTH_SECRET is available - FAIL FAST if not
158
- console.log('[STARTUP] Step 2/2: Verifying BETTER_AUTH_SECRET...');
159
-
160
- const secret = process.env.BETTER_AUTH_SECRET || process.env.NEXTAUTH_SECRET;
161
- if (!secret || secret.trim() === '') {
162
- console.error('');
163
- console.error('╔══════════════════════════════════════════════════════════════╗');
164
- console.error('ā•‘ āŒ FATAL: BETTER_AUTH_SECRET NOT AVAILABLE ā•‘');
165
- console.error('ā•‘ ā•‘');
166
- console.error('ā•‘ The app cannot start without a valid auth signing secret. ā•‘');
167
- console.error('ā•‘ This should be fetched from IDP at startup. ā•‘');
168
- console.error('ā•‘ ā•‘');
169
- console.error('ā•‘ Possible causes: ā•‘');
170
- console.error('ā•‘ • IDP is not running or unreachable ā•‘');
171
- console.error('ā•‘ • CLIENT_ID is not registered in IDP ā•‘');
172
- console.error('ā•‘ • IDP_URL is incorrect ā•‘');
173
- console.error('ā•‘ • Network connectivity issue ā•‘');
174
- console.error('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
175
- console.error('');
176
- throw new Error('FATAL: BETTER_AUTH_SECRET not available - cannot start without valid secret from IDP');
177
- }
178
-
179
- console.log('[STARTUP] BETTER_AUTH_SECRET verified (' + secret.length + ' chars)');
180
-
181
- // Step 3: Validate cookie name consistency
182
- // This catches bugs where getJwtCookieName() returns a different name than
183
- // what auth-options.ts configures, which causes sessions to fail in production
184
- const { validateCookieNameConsistency, getSessionCookieName, assertAppSlugMatchesIdp, assertIdpSlugKnown } = await import('./app-slug');
185
- validateCookieNameConsistency();
186
- // rigpert 60743: refuse to run with two cookie-name sources (IdP clientSlug vs APP_SLUG/CLIENT_ID).
187
- assertIdpSlugKnown(cachedIDPConfig?.clientSlug);
188
- assertAppSlugMatchesIdp(cachedIDPConfig?.clientSlug);
189
- console.log('[STARTUP] Cookie name consistency validated:', getSessionCookieName());
190
-
191
- // All done
192
- console.log('');
193
- console.log('╔══════════════════════════════════════════════════════════════╗');
194
- console.log('ā•‘ PayEz Next MVP Ready for Requests ā•‘');
195
- console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
196
- console.log('');
197
-
198
- initializationComplete = true;
199
- initializationFailed = false;
200
- lastInitError = null;
201
- } catch (error) {
202
- lastInitError = error instanceof Error ? error : new Error(String(error));
203
- initializationFailed = true;
204
-
205
- const errorMsg = lastInitError.message || 'Unknown error';
206
- const isConnectionError = errorMsg.includes('fetch failed') || errorMsg.includes('ECONNREFUSED');
207
- const idpUrl = (process.env.IDP_URL || 'NOT SET').padEnd(46);
208
- const clientId = (process.env.CLIENT_ID || 'NOT SET').padEnd(43);
209
-
210
- const connectionLine = isConnectionError
211
- ? 'ā•‘ šŸ”Œ CONNECTION REFUSED - IDP appears to be down ā•‘\nā•‘ ā•‘\n'
212
- : '';
213
-
214
- console.error(`
215
- ╔══════════════════════════════════════════════════════════════╗
216
- ā•‘ āŒ FATAL: BETTER_AUTH_SECRET NOT AVAILABLE ā•‘
217
- ā•‘ ā•‘
218
- ā•‘ The app cannot start without a valid auth signing secret. ā•‘
219
- ā•‘ This should be fetched from IDP at startup. ā•‘
220
- ā•‘ ā•‘
221
- ${connectionLine}ā•‘ Possible causes: ā•‘
222
- ā•‘ • IDP is not running or unreachable ā•‘
223
- ā•‘ • CLIENT_ID is not registered in IDP ā•‘
224
- ā•‘ • IDP_URL is incorrect ā•‘
225
- ā•‘ • Network connectivity issue ā•‘
226
- ā•‘ ā•‘
227
- ā•‘ Current config: ā•‘
228
- ā•‘ • IDP_URL: ${idpUrl}ā•‘
229
- ā•‘ • CLIENT_ID: ${clientId}ā•‘
230
- ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•
231
-
232
- [STARTUP] Error: ${errorMsg}
233
- `);
234
-
235
- // Re-throw so callers know initialization failed
236
- throw lastInitError;
237
- }
238
- }
239
-
240
- /**
241
- * Get the cached IDP config after initialization.
242
- * Returns null if not yet initialized.
243
- */
244
- /**
245
- * For health endpoints (rigpert 60765): a guard that does not stop the process is an empty red unless the mismatch is visible
246
- * where operators and promote-fe look. Returns `SLUG_MISMATCH: cookie=<idp slug> gate=<app slug>` while the drift holds, else null;
247
- * a health route should answer non-200 with this as the reason. Null until the IdP config has been fetched.
248
- */
249
- export function getSlugMismatchReason(): string | null {
250
- return slugStateReason(cachedIDPConfig?.clientSlug, initializationComplete || initializationFailed);
251
- }
252
-
253
- export function getStartupIDPConfig(): IDPClientConfig | null {
254
- return cachedIDPConfig;
255
- }
256
-
257
- /**
258
- * Check if initialization failed (auth signing secret couldn't be retrieved)
259
- */
260
- export function isInitializationFailed(): boolean {
261
- return initializationFailed;
262
- }
263
-
264
- /**
265
- * Get the last initialization error
266
- */
267
- export function getInitializationError(): Error | null {
268
- return lastInitError;
269
- }
270
-
271
- /**
272
- * Check if the app is ready to handle auth requests
273
- */
274
- export function isAppReady(): boolean {
275
- return initializationComplete && !initializationFailed;
276
- }
1
+ /**
2
+ * Startup Initialization for MVP
3
+ *
4
+ * This module ensures that critical initialization tasks are completed
5
+ * before the application serves requests.
6
+ *
7
+ * Uses unified IDP client config for:
8
+ * - BETTER_AUTH_SECRET (the Better Auth signing secret)
9
+ * - OAuth provider configuration
10
+ * - Auth settings (2FA, session timeouts, etc.)
11
+ */
12
+
13
+ import 'server-only';
14
+ import { getIDPClientConfig, clearConfigRedisCache, type IDPClientConfig } from './idp-client-config';
15
+ import { slugStateReason } from './app-slug';
16
+
17
+ let initializationStarted = false;
18
+ let initializationComplete = false;
19
+ let initializationFailed = false;
20
+ let initializationPromise: Promise<void> | null = null;
21
+ let lastInitError: Error | null = null;
22
+
23
+ // Cached IDP config for access after initialization
24
+ let cachedIDPConfig: IDPClientConfig | null = null;
25
+
26
+ // Startup backoff to prevent pod restart storms from hammering IDP
27
+ let lastStartupAttemptTime = 0;
28
+ const STARTUP_BACKOFF_MS = 30000; // 30 seconds between startup attempts after failure
29
+
30
+ /**
31
+ * Initialize the application startup sequence (async)
32
+ * Handles async initialization like fetching secrets from IDP
33
+ */
34
+ export async function ensureInitialized(): Promise<void> {
35
+ // If already initialized, return immediately
36
+ if (initializationComplete) {
37
+ return;
38
+ }
39
+
40
+ // If initialization is in progress, wait for it
41
+ if (initializationPromise) {
42
+ return initializationPromise;
43
+ }
44
+
45
+ // Prevent hammering IDP on rapid pod restarts
46
+ const now = Date.now();
47
+ if (initializationFailed && (now - lastStartupAttemptTime) < STARTUP_BACKOFF_MS) {
48
+ const remainingMs = STARTUP_BACKOFF_MS - (now - lastStartupAttemptTime);
49
+ console.warn('[STARTUP] In backoff period after previous failure, skipping IDP call', {
50
+ remainingMs: Math.round(remainingMs),
51
+ lastError: lastInitError?.message
52
+ });
53
+ // Re-throw last error so callers know we're still in failed state
54
+ throw lastInitError || new Error('Initialization in backoff period');
55
+ }
56
+
57
+ // Track this attempt time
58
+ lastStartupAttemptTime = now;
59
+
60
+ // Mark as started
61
+ initializationStarted = true;
62
+
63
+ // Start initialization.
64
+ //
65
+ // PAY-642: a FAILED attempt must not stay installed. This used to be
66
+ // `initializationPromise = performInitialization(); await initializationPromise;` with no reset, and the
67
+ // in-progress check above runs BEFORE the backoff check, so a pod that booted while the IdP was down replayed
68
+ // its first rejection to every caller forever: the 30 s backoff could never lead to a retry. Same latch, same
69
+ // fix, as createSingleFlight (lib/single-flight.ts): callers of the failing attempt still see the rejection
70
+ // (loud), then the attempt clears itself, identity-guarded so a slow failure never evicts a newer attempt.
71
+ // After a failure the backoff check above governs when the next attempt may start.
72
+ const attempt = performInitialization();
73
+ initializationPromise = attempt;
74
+ attempt.catch(() => {
75
+ if (initializationPromise === attempt) initializationPromise = null;
76
+ });
77
+ await attempt;
78
+ }
79
+
80
+ /**
81
+ * Synchronously log startup status
82
+ * Can be called before async initialization is complete
83
+ */
84
+ export function logStartupStatus(): void {
85
+ if (!initializationStarted) {
86
+ console.log('\n');
87
+ console.log('╔══════════════════════════════════════════════════════════════╗');
88
+ console.log('ā•‘ šŸš€ PayEz Next MVP - Starting Up ā•‘');
89
+ console.log('ā•‘ ā•‘');
90
+ console.log('ā•‘ Async initialization in progress... ā•‘');
91
+ console.log('ā•‘ - Resolving BETTER_AUTH_SECRET from IDP ā•‘');
92
+ console.log('ā•‘ - Verifying environment configuration ā•‘');
93
+ console.log('ā•‘ ā•‘');
94
+ console.log('ā•‘ Check logs below for detailed initialization status: ā•‘');
95
+ console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
96
+ console.log('');
97
+ } else if (initializationComplete) {
98
+ console.log('\n');
99
+ console.log('╔══════════════════════════════════════════════════════════════╗');
100
+ console.log('ā•‘ ✨ PayEz Next MVP Ready for Requests ✨ ā•‘');
101
+ console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
102
+ console.log('');
103
+ } else if (lastInitError) {
104
+ console.log('\n');
105
+ console.log('╔══════════════════════════════════════════════════════════════╗');
106
+ console.log('ā•‘ āš ļø Startup error detected - initialization may still retry ā•‘');
107
+ console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
108
+ console.log('');
109
+ }
110
+ }
111
+
112
+ async function performInitialization(): Promise<void> {
113
+ console.log('\n');
114
+ console.log('╔══════════════════════════════════════════════════════════════╗');
115
+ console.log('ā•‘ PayEz Next MVP - Async Startup ā•‘');
116
+ console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
117
+ console.log('');
118
+
119
+ try {
120
+ // Step 1: Fetch full client config from IDP (includes secret, providers, settings)
121
+ console.log('[STARTUP] Step 1/2: Fetching client config from IDP...');
122
+
123
+ // Clear any stale Redis cache so startup always gets fresh IDP data
124
+ await clearConfigRedisCache();
125
+
126
+ try {
127
+ const config = await getIDPClientConfig(true);
128
+ cachedIDPConfig = config;
129
+
130
+ console.log('[STARTUP] Client config loaded successfully');
131
+ console.log('[STARTUP] - Client ID:', config.clientId);
132
+ console.log('[STARTUP] - Client Slug:', config.clientSlug);
133
+ console.log('[STARTUP] - Secret length:', config.authSecret?.length || 0, 'chars');
134
+ console.log('[STARTUP] - OAuth Providers:', config.oauthProviders?.filter(p => p.enabled).map(p => p.provider).join(', ') || 'none');
135
+ console.log('[STARTUP] - Require 2FA:', config.authSettings?.require2FA);
136
+ console.log('[STARTUP] - Cache TTL:', config.configCacheTtlSeconds, 'seconds');
137
+ console.log('[STARTUP] - Base Client URL:', config.baseClientUrl || '(not set)');
138
+
139
+ // Set BETTER_AUTH_SECRET from IDP response if not already set.
140
+ // Also mirror to legacy NEXTAUTH_SECRET during the rename transition
141
+ // so any consumer code still reading the old name keeps working.
142
+ if (config.authSecret && !process.env.BETTER_AUTH_SECRET) {
143
+ process.env.BETTER_AUTH_SECRET = config.authSecret;
144
+ console.log('[STARTUP] Set BETTER_AUTH_SECRET from IDP config');
145
+ }
146
+ if (config.authSecret && !process.env.NEXTAUTH_SECRET) {
147
+ process.env.NEXTAUTH_SECRET = config.authSecret;
148
+ }
149
+ } catch (error) {
150
+ const errorMsg = error instanceof Error ? error.message : String(error);
151
+ console.error('[STARTUP] IDP config fetch failed:', errorMsg);
152
+
153
+ // No fallback available — IDP config is the only source for the auth secret
154
+ console.error('[STARTUP] No fallback available for auth secret resolution');
155
+ }
156
+
157
+ // Step 2: Verify BETTER_AUTH_SECRET is available - FAIL FAST if not
158
+ console.log('[STARTUP] Step 2/2: Verifying BETTER_AUTH_SECRET...');
159
+
160
+ const secret = process.env.BETTER_AUTH_SECRET || process.env.NEXTAUTH_SECRET;
161
+ if (!secret || secret.trim() === '') {
162
+ console.error('');
163
+ console.error('╔══════════════════════════════════════════════════════════════╗');
164
+ console.error('ā•‘ āŒ FATAL: BETTER_AUTH_SECRET NOT AVAILABLE ā•‘');
165
+ console.error('ā•‘ ā•‘');
166
+ console.error('ā•‘ The app cannot start without a valid auth signing secret. ā•‘');
167
+ console.error('ā•‘ This should be fetched from IDP at startup. ā•‘');
168
+ console.error('ā•‘ ā•‘');
169
+ console.error('ā•‘ Possible causes: ā•‘');
170
+ console.error('ā•‘ • IDP is not running or unreachable ā•‘');
171
+ console.error('ā•‘ • CLIENT_ID is not registered in IDP ā•‘');
172
+ console.error('ā•‘ • IDP_URL is incorrect ā•‘');
173
+ console.error('ā•‘ • Network connectivity issue ā•‘');
174
+ console.error('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
175
+ console.error('');
176
+ throw new Error('FATAL: BETTER_AUTH_SECRET not available - cannot start without valid secret from IDP');
177
+ }
178
+
179
+ console.log('[STARTUP] BETTER_AUTH_SECRET verified (' + secret.length + ' chars)');
180
+
181
+ // Step 3: Validate cookie name consistency
182
+ // This catches bugs where getJwtCookieName() returns a different name than
183
+ // what auth-options.ts configures, which causes sessions to fail in production
184
+ const { validateCookieNameConsistency, getSessionCookieName, assertAppSlugMatchesIdp, assertIdpSlugKnown } = await import('./app-slug');
185
+ validateCookieNameConsistency();
186
+ // rigpert 60743: refuse to run with two cookie-name sources (IdP clientSlug vs APP_SLUG/CLIENT_ID).
187
+ assertIdpSlugKnown(cachedIDPConfig?.clientSlug);
188
+ assertAppSlugMatchesIdp(cachedIDPConfig?.clientSlug);
189
+ console.log('[STARTUP] Cookie name consistency validated:', getSessionCookieName());
190
+
191
+ // All done
192
+ console.log('');
193
+ console.log('╔══════════════════════════════════════════════════════════════╗');
194
+ console.log('ā•‘ PayEz Next MVP Ready for Requests ā•‘');
195
+ console.log('ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•');
196
+ console.log('');
197
+
198
+ initializationComplete = true;
199
+ initializationFailed = false;
200
+ lastInitError = null;
201
+ } catch (error) {
202
+ lastInitError = error instanceof Error ? error : new Error(String(error));
203
+ initializationFailed = true;
204
+
205
+ const errorMsg = lastInitError.message || 'Unknown error';
206
+ const isConnectionError = errorMsg.includes('fetch failed') || errorMsg.includes('ECONNREFUSED');
207
+ const idpUrl = (process.env.IDP_URL || 'NOT SET').padEnd(46);
208
+ const clientId = (process.env.CLIENT_ID || 'NOT SET').padEnd(43);
209
+
210
+ const connectionLine = isConnectionError
211
+ ? 'ā•‘ šŸ”Œ CONNECTION REFUSED - IDP appears to be down ā•‘\nā•‘ ā•‘\n'
212
+ : '';
213
+
214
+ console.error(`
215
+ ╔══════════════════════════════════════════════════════════════╗
216
+ ā•‘ āŒ FATAL: BETTER_AUTH_SECRET NOT AVAILABLE ā•‘
217
+ ā•‘ ā•‘
218
+ ā•‘ The app cannot start without a valid auth signing secret. ā•‘
219
+ ā•‘ This should be fetched from IDP at startup. ā•‘
220
+ ā•‘ ā•‘
221
+ ${connectionLine}ā•‘ Possible causes: ā•‘
222
+ ā•‘ • IDP is not running or unreachable ā•‘
223
+ ā•‘ • CLIENT_ID is not registered in IDP ā•‘
224
+ ā•‘ • IDP_URL is incorrect ā•‘
225
+ ā•‘ • Network connectivity issue ā•‘
226
+ ā•‘ ā•‘
227
+ ā•‘ Current config: ā•‘
228
+ ā•‘ • IDP_URL: ${idpUrl}ā•‘
229
+ ā•‘ • CLIENT_ID: ${clientId}ā•‘
230
+ ā•šā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•ā•
231
+
232
+ [STARTUP] Error: ${errorMsg}
233
+ `);
234
+
235
+ // Re-throw so callers know initialization failed
236
+ throw lastInitError;
237
+ }
238
+ }
239
+
240
+ /**
241
+ * Get the cached IDP config after initialization.
242
+ * Returns null if not yet initialized.
243
+ */
244
+ /**
245
+ * For health endpoints (rigpert 60765): a guard that does not stop the process is an empty red unless the mismatch is visible
246
+ * where operators and promote-fe look. Returns `SLUG_MISMATCH: cookie=<idp slug> gate=<app slug>` while the drift holds, else null;
247
+ * a health route should answer non-200 with this as the reason. Null until the IdP config has been fetched.
248
+ */
249
+ export function getSlugMismatchReason(): string | null {
250
+ return slugStateReason(cachedIDPConfig?.clientSlug, initializationComplete || initializationFailed);
251
+ }
252
+
253
+ export function getStartupIDPConfig(): IDPClientConfig | null {
254
+ return cachedIDPConfig;
255
+ }
256
+
257
+ /**
258
+ * Check if initialization failed (auth signing secret couldn't be retrieved)
259
+ */
260
+ export function isInitializationFailed(): boolean {
261
+ return initializationFailed;
262
+ }
263
+
264
+ /**
265
+ * Get the last initialization error
266
+ */
267
+ export function getInitializationError(): Error | null {
268
+ return lastInitError;
269
+ }
270
+
271
+ /**
272
+ * Check if the app is ready to handle auth requests
273
+ */
274
+ export function isAppReady(): boolean {
275
+ return initializationComplete && !initializationFailed;
276
+ }
@@ -1,41 +1,41 @@
1
- import { NextRequest } from 'next/server';
2
- import { logger } from '../config/logger';
3
- import { getSession } from '../server/auth';
4
- import { getSessionCookieName } from './app-slug';
5
-
6
- export async function getTokenTestAware(req: NextRequest): Promise<any> {
7
- if (process.env.TEST_MODE === 'true') {
8
- try {
9
- let secret = process.env.BETTER_AUTH_SECRET || process.env.NEXTAUTH_SECRET;
10
- if (!secret || secret.trim() === '') {
11
- const { getIDPClientConfig } = await import('./idp-client-config');
12
- const idpConfig = await getIDPClientConfig();
13
- secret = idpConfig.authSecret;
14
- }
15
- // Use app-slug prefixed cookie name
16
- const cookieName = getSessionCookieName();
17
- const cookies = req.headers.get('cookie'); if (!cookies) { logger.debug('[GET_TOKEN] No cookies in request'); return null; }
18
- const cookieValue = cookies.split(';').find(c => c.trim().startsWith(`${cookieName}=`))?.split('=')[1];
19
- if (!cookieValue) { logger.debug('[GET_TOKEN] Session token cookie not found'); return null; }
20
- const { jwtVerify } = await import('jose');
21
- const secretKey = new TextEncoder().encode(secret);
22
- const { payload } = await jwtVerify(cookieValue, secretKey);
23
- logger.debug('[GET_TOKEN] TEST_MODE token decoded:', { hasPayload: !!payload, redisSessionId: (payload as any).redisSessionId, sub: (payload as any).sub });
24
- return payload;
25
- } catch (error) { logger.error('[GET_TOKEN] TEST_MODE token decode error:', { error: error instanceof Error ? error.message : String(error) }); return null; }
26
- }
27
- // Production path: Better Auth session
28
- const session = await getSession(req);
29
- if (session?.user && session?.session?.token) {
30
- return {
31
- sub: session.user.id,
32
- email: session.user.email,
33
- name: session.user.name,
34
- sessionToken: session.session.token,
35
- roles: session.user.roles || [],
36
- ...session.user,
37
- };
38
- }
39
-
40
- return null;
41
- }
1
+ import { NextRequest } from 'next/server';
2
+ import { logger } from '../config/logger';
3
+ import { getSession } from '../server/auth';
4
+ import { getSessionCookieName } from './app-slug';
5
+
6
+ export async function getTokenTestAware(req: NextRequest): Promise<any> {
7
+ if (process.env.TEST_MODE === 'true') {
8
+ try {
9
+ let secret = process.env.BETTER_AUTH_SECRET || process.env.NEXTAUTH_SECRET;
10
+ if (!secret || secret.trim() === '') {
11
+ const { getIDPClientConfig } = await import('./idp-client-config');
12
+ const idpConfig = await getIDPClientConfig();
13
+ secret = idpConfig.authSecret;
14
+ }
15
+ // Use app-slug prefixed cookie name
16
+ const cookieName = getSessionCookieName();
17
+ const cookies = req.headers.get('cookie'); if (!cookies) { logger.debug('[GET_TOKEN] No cookies in request'); return null; }
18
+ const cookieValue = cookies.split(';').find(c => c.trim().startsWith(`${cookieName}=`))?.split('=')[1];
19
+ if (!cookieValue) { logger.debug('[GET_TOKEN] Session token cookie not found'); return null; }
20
+ const { jwtVerify } = await import('jose');
21
+ const secretKey = new TextEncoder().encode(secret);
22
+ const { payload } = await jwtVerify(cookieValue, secretKey);
23
+ logger.debug('[GET_TOKEN] TEST_MODE token decoded:', { hasPayload: !!payload, redisSessionId: (payload as any).redisSessionId, sub: (payload as any).sub });
24
+ return payload;
25
+ } catch (error) { logger.error('[GET_TOKEN] TEST_MODE token decode error:', { error: error instanceof Error ? error.message : String(error) }); return null; }
26
+ }
27
+ // Production path: Better Auth session
28
+ const session = await getSession(req);
29
+ if (session?.user && session?.session?.token) {
30
+ return {
31
+ sub: session.user.id,
32
+ email: session.user.email,
33
+ name: session.user.name,
34
+ sessionToken: session.session.token,
35
+ roles: session.user.roles || [],
36
+ ...session.user,
37
+ };
38
+ }
39
+
40
+ return null;
41
+ }