@payez/next-mvp 4.1.7 → 4.1.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (154) hide show
  1. package/README.md +792 -792
  2. package/dist/auth/better-auth.js +15 -3
  3. package/dist/components/account/MobileNavDrawer.js +18 -18
  4. package/dist/components/account/UserAvatarMenu.js +1 -1
  5. package/dist/components/admin/AlertSettingsTab.js +40 -40
  6. package/dist/components/admin/LoggingSettingsTab.js +28 -28
  7. package/dist/pages/login/page.js +28 -28
  8. package/dist/pages/settings/EnhancedSettingsPage.js +17 -17
  9. package/package.json +1 -1
  10. package/scripts/dev-broker.ps1 +35 -35
  11. package/scripts/dev-local.ps1 +45 -45
  12. package/src/api/auth-handler.ts +548 -548
  13. package/src/api-handlers/account/change-password.ts +142 -142
  14. package/src/api-handlers/account/update-phone.ts +79 -79
  15. package/src/api-handlers/account/verify-email.ts +125 -125
  16. package/src/api-handlers/account/verify-sms.ts +125 -125
  17. package/src/api-handlers/admin/analytics.ts +443 -443
  18. package/src/api-handlers/admin/audit.ts +223 -223
  19. package/src/api-handlers/admin/index.ts +63 -63
  20. package/src/api-handlers/admin/redis-sessions.ts +251 -251
  21. package/src/api-handlers/admin/sessions.ts +318 -318
  22. package/src/api-handlers/admin/site-logs.ts +365 -365
  23. package/src/api-handlers/admin/users.ts +242 -242
  24. package/src/api-handlers/admin/vibe-data.ts +324 -324
  25. package/src/api-handlers/auth/refresh.ts +682 -682
  26. package/src/api-handlers/auth/signout.ts +199 -199
  27. package/src/api-handlers/auth/status.ts +20 -20
  28. package/src/api-handlers/auth/update-session.ts +110 -110
  29. package/src/api-handlers/auth/verify-code.ts +112 -112
  30. package/src/api-handlers/session/refresh-viability.ts +36 -36
  31. package/src/api-handlers/test/force-expire.ts +60 -60
  32. package/src/auth/auth-decision.ts +229 -229
  33. package/src/auth/better-auth.ts +15 -3
  34. package/src/auth/route-config.ts +219 -219
  35. package/src/auth/types/auth-types.ts +555 -555
  36. package/src/auth/types/index.ts +7 -7
  37. package/src/auth/utils/idp-client.ts +445 -445
  38. package/src/auth/utils/index.ts +6 -6
  39. package/src/auth/utils/token-utils.ts +243 -243
  40. package/src/client/AuthContext.tsx +143 -143
  41. package/src/client/fetch-with-auth.ts +47 -47
  42. package/src/components/SessionSync.tsx +138 -138
  43. package/src/components/SignalRHealthCheck.tsx +131 -131
  44. package/src/components/account/MobileNavDrawer.tsx +305 -305
  45. package/src/components/account/UserAvatarMenu.tsx +266 -266
  46. package/src/components/account/index.ts +13 -13
  47. package/src/components/admin/AlertSettingsTab.tsx +728 -728
  48. package/src/components/admin/AnalyticsTab.tsx +703 -703
  49. package/src/components/admin/DataBrowserTab.tsx +505 -505
  50. package/src/components/admin/LoggingSettingsTab.tsx +665 -665
  51. package/src/components/admin/SessionsTab.tsx +414 -414
  52. package/src/components/admin/StatsTab.tsx +379 -379
  53. package/src/components/admin/VibeAdminLayout.tsx +187 -187
  54. package/src/components/admin/index.ts +59 -59
  55. package/src/components/auth/FederatedAuthSection.tsx +95 -95
  56. package/src/components/auth/ModeAwareLoginPage.tsx +135 -135
  57. package/src/components/auth/ModeAwareSignupPage.tsx +267 -267
  58. package/src/components/auth/TraditionalAuthSection.tsx +99 -99
  59. package/src/components/recovery/CompleteStep.tsx +36 -36
  60. package/src/components/recovery/InitiateRecoveryStep.tsx +68 -68
  61. package/src/components/recovery/SelectMethodStep.tsx +73 -73
  62. package/src/components/recovery/SetPasswordStep.tsx +97 -97
  63. package/src/components/recovery/VerifyCodeStep.tsx +90 -90
  64. package/src/components/reserved/ReservedRecoveryWarning.tsx +160 -160
  65. package/src/components/reserved/ReservedStatusBox.tsx +118 -118
  66. package/src/components/ui/BetaBadge.tsx +58 -58
  67. package/src/components/ui/Footer.tsx +93 -93
  68. package/src/config/env.ts +57 -57
  69. package/src/config/logger.ts +62 -62
  70. package/src/config/vibe-log-transport.ts +264 -264
  71. package/src/hooks/useAuth.ts +117 -117
  72. package/src/hooks/useAuthSettings.ts +97 -97
  73. package/src/hooks/useAvailableProviders.ts +120 -120
  74. package/src/hooks/usePasswordValidation.ts +127 -127
  75. package/src/hooks/usePublicAuthSettings.ts +149 -149
  76. package/src/hooks/useSessionExpiration.ts +101 -101
  77. package/src/hooks/useViabilitySession.ts +336 -336
  78. package/src/index.ts +60 -60
  79. package/src/lib/api-handler.ts +643 -643
  80. package/src/lib/app-slug.ts +178 -178
  81. package/src/lib/geolocation.ts +265 -265
  82. package/src/lib/idp-fetch.ts +110 -110
  83. package/src/lib/jwt-decode.ts +82 -82
  84. package/src/lib/roles.ts +177 -177
  85. package/src/lib/site-logger.ts +245 -245
  86. package/src/lib/standardized-client-api.ts +901 -901
  87. package/src/lib/test-aware-get-token.ts +41 -41
  88. package/src/lib/user-agent-parser.ts +252 -252
  89. package/src/logging/api/admin-analytics.ts +51 -51
  90. package/src/logging/api/audit-log.ts +53 -53
  91. package/src/logging/components/AdminAnalyticsLayout.tsx +49 -49
  92. package/src/logging/components/AuditLogViewer.tsx +125 -125
  93. package/src/logging/components/ErrorMetricsCard.tsx +98 -98
  94. package/src/logging/components/HealthMetricsCard.tsx +70 -70
  95. package/src/logging/hooks/useAdminAnalytics.ts +22 -22
  96. package/src/logging/hooks/useAuditLog.ts +24 -24
  97. package/src/logging/hooks/useErrorMetrics.ts +40 -40
  98. package/src/logging/hooks/useHealthMetrics.ts +44 -44
  99. package/src/logging/index.ts +18 -18
  100. package/src/logging/types/analytics.ts +81 -81
  101. package/src/logging/types/audit.ts +31 -31
  102. package/src/logging/types/index.ts +3 -3
  103. package/src/middleware/create-middleware.ts +663 -663
  104. package/src/middleware/rbac-check.ts +279 -279
  105. package/src/middleware/twofa-presets.ts +224 -224
  106. package/src/pages/admin-login/page.tsx +221 -221
  107. package/src/pages/admin-page-permissions/PagePermissionsAdminPage.tsx +527 -527
  108. package/src/pages/admin-page-permissions/index.ts +7 -7
  109. package/src/pages/admin-roles/RolesAdminPage.tsx +533 -533
  110. package/src/pages/admin-roles/modals.tsx +469 -469
  111. package/src/pages/client-admin/ClientSiteAdminPage.tsx +382 -382
  112. package/src/pages/client-admin/index.ts +33 -33
  113. package/src/pages/coming-soon/page.tsx +83 -83
  114. package/src/pages/login/page.tsx +456 -456
  115. package/src/pages/profile/EnhancedProfilePage.tsx +485 -485
  116. package/src/pages/profile/index.ts +9 -9
  117. package/src/pages/profile/page.tsx +166 -166
  118. package/src/pages/recovery/page.tsx +234 -234
  119. package/src/pages/roles/MyRolesPage.tsx +211 -211
  120. package/src/pages/roles/components.tsx +294 -294
  121. package/src/pages/roles/index.ts +17 -17
  122. package/src/pages/security/EnhancedSecurityPage.tsx +565 -565
  123. package/src/pages/security/index.ts +9 -9
  124. package/src/pages/security/page.tsx +507 -507
  125. package/src/pages/settings/EnhancedSettingsPage.tsx +642 -642
  126. package/src/pages/settings/index.ts +9 -9
  127. package/src/pages/settings/page.tsx +47 -47
  128. package/src/pages/showcase/ShowcasePage.tsx +532 -532
  129. package/src/pages/showcase/index.ts +13 -13
  130. package/src/pages/test-env/EmergencyLogoutPage.tsx +180 -180
  131. package/src/pages/test-env/JwtInspectPage.tsx +456 -456
  132. package/src/pages/test-env/RefreshTokenPage.tsx +157 -157
  133. package/src/pages/test-env/TestEnvPage.tsx +118 -118
  134. package/src/pages/test-env/index.ts +25 -25
  135. package/src/pages/verify-code/page.tsx +652 -652
  136. package/src/routes/account/update-phone.ts +13 -13
  137. package/src/routes/auth/logout.ts +108 -108
  138. package/src/routes/auth/nextauth.ts +45 -45
  139. package/src/routes/auth/settings.ts +75 -75
  140. package/src/routes/auth/viability.ts +224 -224
  141. package/src/server/auth-guard.ts +170 -170
  142. package/src/server/slim-middleware.ts +117 -117
  143. package/src/server/with-auth.ts +93 -93
  144. package/src/stores/authStore.ts +1899 -1899
  145. package/src/templates/instrumentation.ts +41 -41
  146. package/src/utils/logout.ts +30 -30
  147. package/src/vibe/client.ts +590 -590
  148. package/src/vibe/enterprise-auth.ts +208 -208
  149. package/src/vibe/errors.ts +185 -185
  150. package/src/vibe/generic.ts +431 -431
  151. package/src/vibe/hooks/index.ts +367 -367
  152. package/src/vibe/index.ts +132 -132
  153. package/src/vibe/sessions.ts +551 -551
  154. package/src/vibe/types.ts +577 -577
@@ -1,382 +1,382 @@
1
- 'use client';
2
-
3
- /**
4
- * =============================================================================
5
- * CLIENT SITE ADMIN - Your App's Admin Dashboard
6
- * =============================================================================
7
- *
8
- * This is the foundation for YOUR app-specific admin area.
9
- * The MVP admin (/admin) handles membership - this handles YOUR data.
10
- *
11
- * SEPARATION OF CONCERNS:
12
- * ┌─────────────────────────────────────────────────────────────────────┐
13
- * │ /admin (MVP Admin) │ /admin/[your-area] (This) │
14
- * │ ───────────────── │ ──────────────────────── │
15
- * │ • User authentication │ • Your app's collections │
16
- * │ • Sessions management │ • Your app's features │
17
- * │ • Role assignments │ • Content moderation │
18
- * │ • Tier/subscription mgmt │ • App-specific analytics │
19
- * │ • Site-wide analytics │ • Custom admin tools │
20
- * │ • vibe_app collection │ • your_app collection │
21
- * └─────────────────────────────────────────────────────────────────────┘
22
- *
23
- * USAGE:
24
- * ```tsx
25
- * // app/admin/your-area/page.tsx
26
- * import { ClientSiteAdminPage } from '@payez/next-mvp/pages/client-admin';
27
- *
28
- * export default function YourAdminPage() {
29
- * return (
30
- * <ClientSiteAdminPage
31
- * title="Your Admin"
32
- * subtitle="Manage your app data"
33
- * collectionName="your_collection"
34
- * tabs={[
35
- * { id: 'overview', label: 'Overview', icon: '📊' },
36
- * { id: 'items', label: 'Items', icon: '📦', table: 'items' },
37
- * ]}
38
- * renderTabContent={(tab, data) => <YourCustomContent />}
39
- * />
40
- * );
41
- * }
42
- * ```
43
- *
44
- * =============================================================================
45
- */
46
-
47
- import React, { useEffect, useState, useCallback } from 'react';
48
- import { authClient } from '../../client/better-auth-client';
49
- import { useRouter } from 'next/navigation';
50
- import Link from 'next/link';
51
-
52
- // Icons - using basic SVGs to avoid lucide dependency issues
53
- const IconRefresh = () => (
54
- <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
55
- <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
56
- </svg>
57
- );
58
-
59
- const IconArrowLeft = () => (
60
- <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
61
- <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 19l-7-7m0 0l7-7m-7 7h18" />
62
- </svg>
63
- );
64
-
65
- const IconShield = () => (
66
- <svg className="w-16 h-16" fill="none" stroke="currentColor" viewBox="0 0 24 24">
67
- <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
68
- </svg>
69
- );
70
-
71
- const IconChart = ({ className = "w-5 h-5" }: { className?: string }) => (
72
- <svg className={className} fill="none" stroke="currentColor" viewBox="0 0 24 24">
73
- <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" />
74
- </svg>
75
- );
76
-
77
- export interface ClientAdminTab {
78
- id: string;
79
- label: string;
80
- icon: string;
81
- table?: string; // If set, will auto-fetch from this table
82
- }
83
-
84
- export interface TableStats {
85
- table: string;
86
- count: number;
87
- label: string;
88
- }
89
-
90
- export interface ClientSiteAdminProps {
91
- /** Admin area title */
92
- title: string;
93
- /** Subtitle shown under title */
94
- subtitle?: string;
95
- /** Vibe collection name for this admin area */
96
- collectionName: string;
97
- /** Tabs to display */
98
- tabs: ClientAdminTab[];
99
- /** Roles that can access (defaults to vibe_app_admin) */
100
- allowedRoles?: string[];
101
- /** Custom overview content renderer */
102
- renderOverview?: (stats: TableStats[]) => React.ReactNode;
103
- /** Custom tab content renderer */
104
- renderTabContent?: (tab: ClientAdminTab, data: any[], loading: boolean) => React.ReactNode;
105
- /** Theme detection function (optional) */
106
- isDark?: boolean;
107
- /** Back link URL (defaults to /) */
108
- backUrl?: string;
109
- /** Back link label (defaults to "Back to Site") */
110
- backLabel?: string;
111
- }
112
-
113
- export function ClientSiteAdminPage({
114
- title,
115
- subtitle = 'Manage your app data',
116
- collectionName,
117
- tabs,
118
- allowedRoles = ['vibe_app_admin'],
119
- renderOverview,
120
- renderTabContent,
121
- isDark: isDarkProp,
122
- backUrl = '/',
123
- backLabel = 'Back to Site',
124
- }: ClientSiteAdminProps) {
125
- const { data: sessionData, isPending } = authClient.useSession();
126
- const session = sessionData;
127
- const status = isPending ? 'loading' : session ? 'authenticated' : 'unauthenticated';
128
- const router = useRouter();
129
-
130
- // Theme detection
131
- const [isDarkState, setIsDarkState] = useState(false);
132
- useEffect(() => {
133
- if (isDarkProp === undefined) {
134
- const checkDark = () => {
135
- const isDark = document.documentElement.classList.contains('dark') ||
136
- window.matchMedia('(prefers-color-scheme: dark)').matches;
137
- setIsDarkState(isDark);
138
- };
139
- checkDark();
140
- const mq = window.matchMedia('(prefers-color-scheme: dark)');
141
- mq.addEventListener('change', checkDark);
142
- return () => mq.removeEventListener('change', checkDark);
143
- }
144
- }, [isDarkProp]);
145
- const isDark = isDarkProp ?? isDarkState;
146
-
147
- const [activeTab, setActiveTab] = useState(tabs[0]?.id || 'overview');
148
- const [tableData, setTableData] = useState<any[]>([]);
149
- const [loading, setLoading] = useState(false);
150
- const [stats, setStats] = useState<TableStats[]>([]);
151
- const [statsLoading, setStatsLoading] = useState(false);
152
-
153
- const userRoles = (session?.user as any)?.roles || [];
154
- const hasAccess = allowedRoles.some(role => userRoles.includes(role));
155
-
156
- const themeClasses = {
157
- bg: isDark ? 'bg-slate-950' : 'bg-gray-50',
158
- cardBg: isDark ? 'bg-slate-800 border-slate-700' : 'bg-white border-gray-200',
159
- headerBg: isDark ? 'bg-slate-900 border-slate-800' : 'bg-white border-gray-200',
160
- text: isDark ? 'text-white' : 'text-gray-900',
161
- textMuted: isDark ? 'text-slate-400' : 'text-gray-600',
162
- tabBg: isDark ? 'bg-slate-800' : 'bg-gray-100',
163
- tabActive: 'bg-amber-600 text-white shadow-lg',
164
- tabInactive: isDark ? 'text-slate-400 hover:bg-slate-700' : 'text-gray-600 hover:bg-gray-200',
165
- };
166
-
167
- // Fetch collection stats
168
- const fetchStats = useCallback(async () => {
169
- setStatsLoading(true);
170
- try {
171
- const res = await fetch(`/api/vibe/collections/${collectionName}/tables`);
172
- if (res.ok) {
173
- const data = await res.json();
174
- const tables = data.tables || data || [];
175
- setStats(tables.map((tbl: any) => ({
176
- table: typeof tbl === 'string' ? tbl : tbl.name,
177
- count: typeof tbl === 'object' ? (tbl.document_count || tbl.count || 0) : 0,
178
- label: (typeof tbl === 'string' ? tbl : tbl.name)
179
- .replace(/_/g, ' ')
180
- .replace(/\b\w/g, (c: string) => c.toUpperCase()),
181
- })));
182
- }
183
- } catch (err) {
184
- console.error('Failed to fetch stats:', err);
185
- } finally {
186
- setStatsLoading(false);
187
- }
188
- }, [collectionName]);
189
-
190
- // Fetch table data
191
- const fetchTableData = useCallback(async (tableName: string) => {
192
- setLoading(true);
193
- try {
194
- const res = await fetch(`/api/vibe/data/${collectionName}/${tableName}?limit=100`);
195
- if (res.ok) {
196
- const data = await res.json();
197
- setTableData(data.data || []);
198
- }
199
- } catch (err) {
200
- console.error('Failed to fetch table:', err);
201
- setTableData([]);
202
- } finally {
203
- setLoading(false);
204
- }
205
- }, [collectionName]);
206
-
207
- // Handle tab change
208
- const handleTabChange = useCallback((tabId: string) => {
209
- setActiveTab(tabId);
210
- const tab = tabs.find(t => t.id === tabId);
211
- if (tab?.table) {
212
- fetchTableData(tab.table);
213
- }
214
- }, [tabs, fetchTableData]);
215
-
216
- // Initial load
217
- useEffect(() => {
218
- if (status === 'unauthenticated') {
219
- router.push(`/account-auth/login?callbackUrl=${encodeURIComponent(window.location.pathname)}`);
220
- } else if (status === 'authenticated' && !hasAccess) {
221
- router.push('/?error=unauthorized');
222
- } else if (status === 'authenticated' && hasAccess) {
223
- fetchStats();
224
- }
225
- }, [status, hasAccess, router, fetchStats]);
226
-
227
- // Loading state
228
- if (status === 'loading') {
229
- return (
230
- <div className={`min-h-screen flex items-center justify-center ${themeClasses.bg}`}>
231
- <div className="animate-spin rounded-full h-12 w-12 border-b-2 border-amber-500" />
232
- </div>
233
- );
234
- }
235
-
236
- // Access denied
237
- if (status === 'authenticated' && !hasAccess) {
238
- return (
239
- <div className={`min-h-screen flex items-center justify-center ${themeClasses.bg}`}>
240
- <div className="text-center">
241
- <div className={isDark ? 'text-red-400' : 'text-red-500'}><IconShield /></div>
242
- <h1 className={`text-2xl font-bold mb-2 ${themeClasses.text}`}>Access Denied</h1>
243
- <p className={`mb-6 ${themeClasses.textMuted}`}>You need admin access for this area.</p>
244
- <Link href="/" className="inline-flex items-center gap-2 px-4 py-2 bg-amber-600 text-white rounded-lg hover:bg-amber-700">
245
- <IconArrowLeft /> Return to Home
246
- </Link>
247
- </div>
248
- </div>
249
- );
250
- }
251
-
252
- if (status === 'unauthenticated') return null;
253
-
254
- const currentTab = tabs.find(t => t.id === activeTab);
255
-
256
- return (
257
- <div className={`min-h-screen ${themeClasses.bg}`}>
258
- {/* Header */}
259
- <header className={`sticky top-0 z-40 border-b ${themeClasses.headerBg}`}>
260
- <div className="container mx-auto px-4 py-4">
261
- <div className="flex items-center justify-between">
262
- <div className="flex items-center gap-3">
263
- <div className={`p-2 rounded-lg ${isDark ? 'bg-amber-900/30' : 'bg-amber-100'}`}>
264
- <IconChart className={`w-5 h-5 ${isDark ? 'text-amber-400' : 'text-amber-600'}`} />
265
- </div>
266
- <div>
267
- <h1 className={`text-xl font-bold ${themeClasses.text}`}>{title}</h1>
268
- <p className={`text-sm ${themeClasses.textMuted}`}>{subtitle}</p>
269
- </div>
270
- </div>
271
- <div className="flex items-center gap-4">
272
- <button
273
- onClick={() => { fetchStats(); if (currentTab?.table) fetchTableData(currentTab.table); }}
274
- disabled={loading || statsLoading}
275
- className={`flex items-center gap-2 px-3 py-2 rounded-lg transition-colors ${themeClasses.textMuted} ${isDark ? 'hover:bg-slate-800' : 'hover:bg-gray-100'} ${(loading || statsLoading) ? 'opacity-50' : ''}`}
276
- >
277
- <span className={(loading || statsLoading) ? 'animate-spin' : ''}><IconRefresh /></span>
278
- Refresh
279
- </button>
280
- <Link href={backUrl} className={`flex items-center gap-2 px-3 py-2 rounded-lg transition-colors ${themeClasses.textMuted} ${isDark ? 'hover:bg-slate-800' : 'hover:bg-gray-100'}`}>
281
- <IconArrowLeft /> {backLabel}
282
- </Link>
283
- </div>
284
- </div>
285
- </div>
286
- </header>
287
-
288
- {/* Content */}
289
- <div className="container mx-auto px-4 py-6 space-y-6">
290
- {/* Tab Navigation */}
291
- <div className={`flex flex-wrap gap-1 p-1 rounded-xl ${themeClasses.tabBg}`}>
292
- {tabs.map((tab) => (
293
- <button
294
- key={tab.id}
295
- onClick={() => handleTabChange(tab.id)}
296
- className={`py-2 px-4 rounded-lg text-sm font-medium transition-all ${
297
- activeTab === tab.id ? themeClasses.tabActive : themeClasses.tabInactive
298
- }`}
299
- >
300
- <span className="mr-2">{tab.icon}</span>
301
- {tab.label}
302
- </button>
303
- ))}
304
- </div>
305
-
306
- {/* Tab Content */}
307
- {renderTabContent ? (
308
- renderTabContent(currentTab!, tableData, loading)
309
- ) : activeTab === 'overview' || !currentTab?.table ? (
310
- // Default Overview
311
- <div className="space-y-6">
312
- <div>
313
- <h2 className={`text-lg font-semibold mb-4 ${themeClasses.text}`}>Data Overview</h2>
314
- <div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-4 gap-4">
315
- {stats.map((stat) => (
316
- <Link
317
- key={stat.table}
318
- href={`/admin/data?collection=${collectionName}&table=${stat.table}`}
319
- className={`p-4 rounded-xl border transition-all hover:scale-[1.02] ${themeClasses.cardBg}`}
320
- >
321
- <p className={`text-xs font-medium ${themeClasses.textMuted}`}>{stat.label}</p>
322
- <p className={`text-2xl font-bold ${themeClasses.text}`}>
323
- {statsLoading ? '...' : stat.count.toLocaleString()}
324
- </p>
325
- </Link>
326
- ))}
327
- </div>
328
- </div>
329
- {renderOverview && renderOverview(stats)}
330
- </div>
331
- ) : (
332
- // Default Table View
333
- <div>
334
- <h2 className={`text-lg font-semibold mb-4 ${themeClasses.text}`}>
335
- {currentTab.label} ({tableData.length})
336
- </h2>
337
- {loading ? (
338
- <div className="flex items-center justify-center py-12">
339
- <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-amber-500" />
340
- </div>
341
- ) : (
342
- <div className={`rounded-lg border overflow-hidden ${themeClasses.cardBg}`}>
343
- <div className="overflow-x-auto">
344
- <table className="w-full text-sm">
345
- <thead className={isDark ? 'bg-slate-800' : 'bg-gray-50'}>
346
- <tr>
347
- <th className={`px-4 py-3 text-left font-medium ${themeClasses.textMuted}`}>ID</th>
348
- <th className={`px-4 py-3 text-left font-medium ${themeClasses.textMuted}`}>User</th>
349
- <th className={`px-4 py-3 text-left font-medium ${themeClasses.textMuted}`}>Data</th>
350
- <th className={`px-4 py-3 text-left font-medium ${themeClasses.textMuted}`}>Created</th>
351
- </tr>
352
- </thead>
353
- <tbody className={`divide-y ${isDark ? 'divide-slate-700' : 'divide-gray-200'}`}>
354
- {tableData.length === 0 ? (
355
- <tr>
356
- <td colSpan={4} className={`px-4 py-8 text-center ${themeClasses.textMuted}`}>No data found</td>
357
- </tr>
358
- ) : tableData.map((row: any) => (
359
- <tr key={row.document_id} className={isDark ? 'hover:bg-slate-800/50' : 'hover:bg-gray-50'}>
360
- <td className={`px-4 py-3 ${themeClasses.text}`}>{row.document_id}</td>
361
- <td className={`px-4 py-3 ${themeClasses.text}`}>{row.user_id}</td>
362
- <td className={`px-4 py-3 ${themeClasses.textMuted} max-w-xs truncate`}>
363
- {JSON.stringify(row.data).substring(0, 50)}...
364
- </td>
365
- <td className={`px-4 py-3 ${themeClasses.textMuted}`}>
366
- {new Date(row.created_at).toLocaleDateString()}
367
- </td>
368
- </tr>
369
- ))}
370
- </tbody>
371
- </table>
372
- </div>
373
- </div>
374
- )}
375
- </div>
376
- )}
377
- </div>
378
- </div>
379
- );
380
- }
381
-
382
- export default ClientSiteAdminPage;
1
+ 'use client';
2
+
3
+ /**
4
+ * =============================================================================
5
+ * CLIENT SITE ADMIN - Your App's Admin Dashboard
6
+ * =============================================================================
7
+ *
8
+ * This is the foundation for YOUR app-specific admin area.
9
+ * The MVP admin (/admin) handles membership - this handles YOUR data.
10
+ *
11
+ * SEPARATION OF CONCERNS:
12
+ * ┌─────────────────────────────────────────────────────────────────────┐
13
+ * │ /admin (MVP Admin) │ /admin/[your-area] (This) │
14
+ * │ ───────────────── │ ──────────────────────── │
15
+ * │ • User authentication │ • Your app's collections │
16
+ * │ • Sessions management │ • Your app's features │
17
+ * │ • Role assignments │ • Content moderation │
18
+ * │ • Tier/subscription mgmt │ • App-specific analytics │
19
+ * │ • Site-wide analytics │ • Custom admin tools │
20
+ * │ • vibe_app collection │ • your_app collection │
21
+ * └─────────────────────────────────────────────────────────────────────┘
22
+ *
23
+ * USAGE:
24
+ * ```tsx
25
+ * // app/admin/your-area/page.tsx
26
+ * import { ClientSiteAdminPage } from '@payez/next-mvp/pages/client-admin';
27
+ *
28
+ * export default function YourAdminPage() {
29
+ * return (
30
+ * <ClientSiteAdminPage
31
+ * title="Your Admin"
32
+ * subtitle="Manage your app data"
33
+ * collectionName="your_collection"
34
+ * tabs={[
35
+ * { id: 'overview', label: 'Overview', icon: '📊' },
36
+ * { id: 'items', label: 'Items', icon: '📦', table: 'items' },
37
+ * ]}
38
+ * renderTabContent={(tab, data) => <YourCustomContent />}
39
+ * />
40
+ * );
41
+ * }
42
+ * ```
43
+ *
44
+ * =============================================================================
45
+ */
46
+
47
+ import React, { useEffect, useState, useCallback } from 'react';
48
+ import { authClient } from '../../client/better-auth-client';
49
+ import { useRouter } from 'next/navigation';
50
+ import Link from 'next/link';
51
+
52
+ // Icons - using basic SVGs to avoid lucide dependency issues
53
+ const IconRefresh = () => (
54
+ <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
55
+ <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15" />
56
+ </svg>
57
+ );
58
+
59
+ const IconArrowLeft = () => (
60
+ <svg className="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
61
+ <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M10 19l-7-7m0 0l7-7m-7 7h18" />
62
+ </svg>
63
+ );
64
+
65
+ const IconShield = () => (
66
+ <svg className="w-16 h-16" fill="none" stroke="currentColor" viewBox="0 0 24 24">
67
+ <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 12l2 2 4-4m5.618-4.016A11.955 11.955 0 0112 2.944a11.955 11.955 0 01-8.618 3.04A12.02 12.02 0 003 9c0 5.591 3.824 10.29 9 11.622 5.176-1.332 9-6.03 9-11.622 0-1.042-.133-2.052-.382-3.016z" />
68
+ </svg>
69
+ );
70
+
71
+ const IconChart = ({ className = "w-5 h-5" }: { className?: string }) => (
72
+ <svg className={className} fill="none" stroke="currentColor" viewBox="0 0 24 24">
73
+ <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 19v-6a2 2 0 00-2-2H5a2 2 0 00-2 2v6a2 2 0 002 2h2a2 2 0 002-2zm0 0V9a2 2 0 012-2h2a2 2 0 012 2v10m-6 0a2 2 0 002 2h2a2 2 0 002-2m0 0V5a2 2 0 012-2h2a2 2 0 012 2v14a2 2 0 01-2 2h-2a2 2 0 01-2-2z" />
74
+ </svg>
75
+ );
76
+
77
+ export interface ClientAdminTab {
78
+ id: string;
79
+ label: string;
80
+ icon: string;
81
+ table?: string; // If set, will auto-fetch from this table
82
+ }
83
+
84
+ export interface TableStats {
85
+ table: string;
86
+ count: number;
87
+ label: string;
88
+ }
89
+
90
+ export interface ClientSiteAdminProps {
91
+ /** Admin area title */
92
+ title: string;
93
+ /** Subtitle shown under title */
94
+ subtitle?: string;
95
+ /** Vibe collection name for this admin area */
96
+ collectionName: string;
97
+ /** Tabs to display */
98
+ tabs: ClientAdminTab[];
99
+ /** Roles that can access (defaults to vibe_app_admin) */
100
+ allowedRoles?: string[];
101
+ /** Custom overview content renderer */
102
+ renderOverview?: (stats: TableStats[]) => React.ReactNode;
103
+ /** Custom tab content renderer */
104
+ renderTabContent?: (tab: ClientAdminTab, data: any[], loading: boolean) => React.ReactNode;
105
+ /** Theme detection function (optional) */
106
+ isDark?: boolean;
107
+ /** Back link URL (defaults to /) */
108
+ backUrl?: string;
109
+ /** Back link label (defaults to "Back to Site") */
110
+ backLabel?: string;
111
+ }
112
+
113
+ export function ClientSiteAdminPage({
114
+ title,
115
+ subtitle = 'Manage your app data',
116
+ collectionName,
117
+ tabs,
118
+ allowedRoles = ['vibe_app_admin'],
119
+ renderOverview,
120
+ renderTabContent,
121
+ isDark: isDarkProp,
122
+ backUrl = '/',
123
+ backLabel = 'Back to Site',
124
+ }: ClientSiteAdminProps) {
125
+ const { data: sessionData, isPending } = authClient.useSession();
126
+ const session = sessionData;
127
+ const status = isPending ? 'loading' : session ? 'authenticated' : 'unauthenticated';
128
+ const router = useRouter();
129
+
130
+ // Theme detection
131
+ const [isDarkState, setIsDarkState] = useState(false);
132
+ useEffect(() => {
133
+ if (isDarkProp === undefined) {
134
+ const checkDark = () => {
135
+ const isDark = document.documentElement.classList.contains('dark') ||
136
+ window.matchMedia('(prefers-color-scheme: dark)').matches;
137
+ setIsDarkState(isDark);
138
+ };
139
+ checkDark();
140
+ const mq = window.matchMedia('(prefers-color-scheme: dark)');
141
+ mq.addEventListener('change', checkDark);
142
+ return () => mq.removeEventListener('change', checkDark);
143
+ }
144
+ }, [isDarkProp]);
145
+ const isDark = isDarkProp ?? isDarkState;
146
+
147
+ const [activeTab, setActiveTab] = useState(tabs[0]?.id || 'overview');
148
+ const [tableData, setTableData] = useState<any[]>([]);
149
+ const [loading, setLoading] = useState(false);
150
+ const [stats, setStats] = useState<TableStats[]>([]);
151
+ const [statsLoading, setStatsLoading] = useState(false);
152
+
153
+ const userRoles = (session?.user as any)?.roles || [];
154
+ const hasAccess = allowedRoles.some(role => userRoles.includes(role));
155
+
156
+ const themeClasses = {
157
+ bg: isDark ? 'bg-slate-950' : 'bg-gray-50',
158
+ cardBg: isDark ? 'bg-slate-800 border-slate-700' : 'bg-white border-gray-200',
159
+ headerBg: isDark ? 'bg-slate-900 border-slate-800' : 'bg-white border-gray-200',
160
+ text: isDark ? 'text-white' : 'text-gray-900',
161
+ textMuted: isDark ? 'text-slate-400' : 'text-gray-600',
162
+ tabBg: isDark ? 'bg-slate-800' : 'bg-gray-100',
163
+ tabActive: 'bg-amber-600 text-white shadow-lg',
164
+ tabInactive: isDark ? 'text-slate-400 hover:bg-slate-700' : 'text-gray-600 hover:bg-gray-200',
165
+ };
166
+
167
+ // Fetch collection stats
168
+ const fetchStats = useCallback(async () => {
169
+ setStatsLoading(true);
170
+ try {
171
+ const res = await fetch(`/api/vibe/collections/${collectionName}/tables`);
172
+ if (res.ok) {
173
+ const data = await res.json();
174
+ const tables = data.tables || data || [];
175
+ setStats(tables.map((tbl: any) => ({
176
+ table: typeof tbl === 'string' ? tbl : tbl.name,
177
+ count: typeof tbl === 'object' ? (tbl.document_count || tbl.count || 0) : 0,
178
+ label: (typeof tbl === 'string' ? tbl : tbl.name)
179
+ .replace(/_/g, ' ')
180
+ .replace(/\b\w/g, (c: string) => c.toUpperCase()),
181
+ })));
182
+ }
183
+ } catch (err) {
184
+ console.error('Failed to fetch stats:', err);
185
+ } finally {
186
+ setStatsLoading(false);
187
+ }
188
+ }, [collectionName]);
189
+
190
+ // Fetch table data
191
+ const fetchTableData = useCallback(async (tableName: string) => {
192
+ setLoading(true);
193
+ try {
194
+ const res = await fetch(`/api/vibe/data/${collectionName}/${tableName}?limit=100`);
195
+ if (res.ok) {
196
+ const data = await res.json();
197
+ setTableData(data.data || []);
198
+ }
199
+ } catch (err) {
200
+ console.error('Failed to fetch table:', err);
201
+ setTableData([]);
202
+ } finally {
203
+ setLoading(false);
204
+ }
205
+ }, [collectionName]);
206
+
207
+ // Handle tab change
208
+ const handleTabChange = useCallback((tabId: string) => {
209
+ setActiveTab(tabId);
210
+ const tab = tabs.find(t => t.id === tabId);
211
+ if (tab?.table) {
212
+ fetchTableData(tab.table);
213
+ }
214
+ }, [tabs, fetchTableData]);
215
+
216
+ // Initial load
217
+ useEffect(() => {
218
+ if (status === 'unauthenticated') {
219
+ router.push(`/account-auth/login?callbackUrl=${encodeURIComponent(window.location.pathname)}`);
220
+ } else if (status === 'authenticated' && !hasAccess) {
221
+ router.push('/?error=unauthorized');
222
+ } else if (status === 'authenticated' && hasAccess) {
223
+ fetchStats();
224
+ }
225
+ }, [status, hasAccess, router, fetchStats]);
226
+
227
+ // Loading state
228
+ if (status === 'loading') {
229
+ return (
230
+ <div className={`min-h-screen flex items-center justify-center ${themeClasses.bg}`}>
231
+ <div className="animate-spin rounded-full h-12 w-12 border-b-2 border-amber-500" />
232
+ </div>
233
+ );
234
+ }
235
+
236
+ // Access denied
237
+ if (status === 'authenticated' && !hasAccess) {
238
+ return (
239
+ <div className={`min-h-screen flex items-center justify-center ${themeClasses.bg}`}>
240
+ <div className="text-center">
241
+ <div className={isDark ? 'text-red-400' : 'text-red-500'}><IconShield /></div>
242
+ <h1 className={`text-2xl font-bold mb-2 ${themeClasses.text}`}>Access Denied</h1>
243
+ <p className={`mb-6 ${themeClasses.textMuted}`}>You need admin access for this area.</p>
244
+ <Link href="/" className="inline-flex items-center gap-2 px-4 py-2 bg-amber-600 text-white rounded-lg hover:bg-amber-700">
245
+ <IconArrowLeft /> Return to Home
246
+ </Link>
247
+ </div>
248
+ </div>
249
+ );
250
+ }
251
+
252
+ if (status === 'unauthenticated') return null;
253
+
254
+ const currentTab = tabs.find(t => t.id === activeTab);
255
+
256
+ return (
257
+ <div className={`min-h-screen ${themeClasses.bg}`}>
258
+ {/* Header */}
259
+ <header className={`sticky top-0 z-40 border-b ${themeClasses.headerBg}`}>
260
+ <div className="container mx-auto px-4 py-4">
261
+ <div className="flex items-center justify-between">
262
+ <div className="flex items-center gap-3">
263
+ <div className={`p-2 rounded-lg ${isDark ? 'bg-amber-900/30' : 'bg-amber-100'}`}>
264
+ <IconChart className={`w-5 h-5 ${isDark ? 'text-amber-400' : 'text-amber-600'}`} />
265
+ </div>
266
+ <div>
267
+ <h1 className={`text-xl font-bold ${themeClasses.text}`}>{title}</h1>
268
+ <p className={`text-sm ${themeClasses.textMuted}`}>{subtitle}</p>
269
+ </div>
270
+ </div>
271
+ <div className="flex items-center gap-4">
272
+ <button
273
+ onClick={() => { fetchStats(); if (currentTab?.table) fetchTableData(currentTab.table); }}
274
+ disabled={loading || statsLoading}
275
+ className={`flex items-center gap-2 px-3 py-2 rounded-lg transition-colors ${themeClasses.textMuted} ${isDark ? 'hover:bg-slate-800' : 'hover:bg-gray-100'} ${(loading || statsLoading) ? 'opacity-50' : ''}`}
276
+ >
277
+ <span className={(loading || statsLoading) ? 'animate-spin' : ''}><IconRefresh /></span>
278
+ Refresh
279
+ </button>
280
+ <Link href={backUrl} className={`flex items-center gap-2 px-3 py-2 rounded-lg transition-colors ${themeClasses.textMuted} ${isDark ? 'hover:bg-slate-800' : 'hover:bg-gray-100'}`}>
281
+ <IconArrowLeft /> {backLabel}
282
+ </Link>
283
+ </div>
284
+ </div>
285
+ </div>
286
+ </header>
287
+
288
+ {/* Content */}
289
+ <div className="container mx-auto px-4 py-6 space-y-6">
290
+ {/* Tab Navigation */}
291
+ <div className={`flex flex-wrap gap-1 p-1 rounded-xl ${themeClasses.tabBg}`}>
292
+ {tabs.map((tab) => (
293
+ <button
294
+ key={tab.id}
295
+ onClick={() => handleTabChange(tab.id)}
296
+ className={`py-2 px-4 rounded-lg text-sm font-medium transition-all ${
297
+ activeTab === tab.id ? themeClasses.tabActive : themeClasses.tabInactive
298
+ }`}
299
+ >
300
+ <span className="mr-2">{tab.icon}</span>
301
+ {tab.label}
302
+ </button>
303
+ ))}
304
+ </div>
305
+
306
+ {/* Tab Content */}
307
+ {renderTabContent ? (
308
+ renderTabContent(currentTab!, tableData, loading)
309
+ ) : activeTab === 'overview' || !currentTab?.table ? (
310
+ // Default Overview
311
+ <div className="space-y-6">
312
+ <div>
313
+ <h2 className={`text-lg font-semibold mb-4 ${themeClasses.text}`}>Data Overview</h2>
314
+ <div className="grid grid-cols-2 md:grid-cols-3 lg:grid-cols-4 gap-4">
315
+ {stats.map((stat) => (
316
+ <Link
317
+ key={stat.table}
318
+ href={`/admin/data?collection=${collectionName}&table=${stat.table}`}
319
+ className={`p-4 rounded-xl border transition-all hover:scale-[1.02] ${themeClasses.cardBg}`}
320
+ >
321
+ <p className={`text-xs font-medium ${themeClasses.textMuted}`}>{stat.label}</p>
322
+ <p className={`text-2xl font-bold ${themeClasses.text}`}>
323
+ {statsLoading ? '...' : stat.count.toLocaleString()}
324
+ </p>
325
+ </Link>
326
+ ))}
327
+ </div>
328
+ </div>
329
+ {renderOverview && renderOverview(stats)}
330
+ </div>
331
+ ) : (
332
+ // Default Table View
333
+ <div>
334
+ <h2 className={`text-lg font-semibold mb-4 ${themeClasses.text}`}>
335
+ {currentTab.label} ({tableData.length})
336
+ </h2>
337
+ {loading ? (
338
+ <div className="flex items-center justify-center py-12">
339
+ <div className="animate-spin rounded-full h-8 w-8 border-b-2 border-amber-500" />
340
+ </div>
341
+ ) : (
342
+ <div className={`rounded-lg border overflow-hidden ${themeClasses.cardBg}`}>
343
+ <div className="overflow-x-auto">
344
+ <table className="w-full text-sm">
345
+ <thead className={isDark ? 'bg-slate-800' : 'bg-gray-50'}>
346
+ <tr>
347
+ <th className={`px-4 py-3 text-left font-medium ${themeClasses.textMuted}`}>ID</th>
348
+ <th className={`px-4 py-3 text-left font-medium ${themeClasses.textMuted}`}>User</th>
349
+ <th className={`px-4 py-3 text-left font-medium ${themeClasses.textMuted}`}>Data</th>
350
+ <th className={`px-4 py-3 text-left font-medium ${themeClasses.textMuted}`}>Created</th>
351
+ </tr>
352
+ </thead>
353
+ <tbody className={`divide-y ${isDark ? 'divide-slate-700' : 'divide-gray-200'}`}>
354
+ {tableData.length === 0 ? (
355
+ <tr>
356
+ <td colSpan={4} className={`px-4 py-8 text-center ${themeClasses.textMuted}`}>No data found</td>
357
+ </tr>
358
+ ) : tableData.map((row: any) => (
359
+ <tr key={row.document_id} className={isDark ? 'hover:bg-slate-800/50' : 'hover:bg-gray-50'}>
360
+ <td className={`px-4 py-3 ${themeClasses.text}`}>{row.document_id}</td>
361
+ <td className={`px-4 py-3 ${themeClasses.text}`}>{row.user_id}</td>
362
+ <td className={`px-4 py-3 ${themeClasses.textMuted} max-w-xs truncate`}>
363
+ {JSON.stringify(row.data).substring(0, 50)}...
364
+ </td>
365
+ <td className={`px-4 py-3 ${themeClasses.textMuted}`}>
366
+ {new Date(row.created_at).toLocaleDateString()}
367
+ </td>
368
+ </tr>
369
+ ))}
370
+ </tbody>
371
+ </table>
372
+ </div>
373
+ </div>
374
+ )}
375
+ </div>
376
+ )}
377
+ </div>
378
+ </div>
379
+ );
380
+ }
381
+
382
+ export default ClientSiteAdminPage;