@payez/next-mvp 4.8.0 → 4.8.2

package/src/logging/components/HealthMetricsCard.tsx

@@ -1,70 +1,70 @@
-'use client';
-
-import { useHealthMetrics } from '../hooks/useHealthMetrics';
-import { TimeRange } from '../types';
-
-interface HealthMetricsCardProps {
-  timeRange?: TimeRange;
-  className?: string;
-}
-
-export function HealthMetricsCard({ timeRange = '1h', className }: HealthMetricsCardProps) {
-  const { data, loading, error } = useHealthMetrics(timeRange);
-
-  if (loading) return <div className={className}>Loading health metrics...</div>;
-  if (error) return <div className={className}>Error: {error}</div>;
-  if (!data) return null;
-
-  return (
-    <div className={className}>
-      <h3 className="text-lg font-semibold mb-4">System Health ({data.timeRange})</h3>
-
-      {/* API health overview */}
-      <div className="grid grid-cols-2 gap-4 mb-4">
-        <div>
-          <div className="text-2xl font-bold">{data.apiHealth.avgResponseTimeMs}ms</div>
-          <div className="text-sm text-gray-600">Avg Response Time</div>
-        </div>
-        <div>
-          <div className="text-2xl font-bold">{data.apiHealth.requestCount}</div>
-          <div className="text-sm text-gray-600">Total Requests</div>
-        </div>
-        <div>
-          <div className="text-2xl font-bold">{data.apiHealth.p95ResponseTimeMs}ms</div>
-          <div className="text-sm text-gray-600">P95 Response Time</div>
-        </div>
-        <div>
-          <div className="text-2xl font-bold">
-            {(data.apiHealth.errorRate * 100).toFixed(2)}%
-          </div>
-          <div className="text-sm text-gray-600">Error Rate</div>
-        </div>
-      </div>
-
-      {/* Slowest endpoints */}
-      {data.endpointBreakdown.length > 0 && (
-        <div className="mb-4">
-          <h4 className="font-medium mb-2">Slowest Endpoints</h4>
-          <ul className="space-y-1">
-            {data.endpointBreakdown
-              .sort((a, b) => b.avgDurationMs - a.avgDurationMs)
-              .slice(0, 5)
-              .map((ep, i) => (
-                <li key={i} className="flex justify-between text-sm">
-                  <span className="font-mono">{ep.endpoint}</span>
-                  <span className="text-orange-600">{ep.avgDurationMs}ms</span>
-                </li>
-              ))}
-          </ul>
-        </div>
-      )}
-
-      {/* Rate limit hits */}
-      {data.rateLimitHits > 0 && (
-        <div className="text-sm text-yellow-600">
-          ⚠️ {data.rateLimitHits} rate limit hits
-        </div>
-      )}
-    </div>
-  );
-}
+'use client';
+
+import { useHealthMetrics } from '../hooks/useHealthMetrics';
+import { TimeRange } from '../types';
+
+interface HealthMetricsCardProps {
+  timeRange?: TimeRange;
+  className?: string;
+}
+
+export function HealthMetricsCard({ timeRange = '1h', className }: HealthMetricsCardProps) {
+  const { data, loading, error } = useHealthMetrics(timeRange);
+
+  if (loading) return <div className={className}>Loading health metrics...</div>;
+  if (error) return <div className={className}>Error: {error}</div>;
+  if (!data) return null;
+
+  return (
+    <div className={className}>
+      <h3 className="text-lg font-semibold mb-4">System Health ({data.timeRange})</h3>
+
+      {/* API health overview */}
+      <div className="grid grid-cols-2 gap-4 mb-4">
+        <div>
+          <div className="text-2xl font-bold">{data.apiHealth.avgResponseTimeMs}ms</div>
+          <div className="text-sm text-gray-600">Avg Response Time</div>
+        </div>
+        <div>
+          <div className="text-2xl font-bold">{data.apiHealth.requestCount}</div>
+          <div className="text-sm text-gray-600">Total Requests</div>
+        </div>
+        <div>
+          <div className="text-2xl font-bold">{data.apiHealth.p95ResponseTimeMs}ms</div>
+          <div className="text-sm text-gray-600">P95 Response Time</div>
+        </div>
+        <div>
+          <div className="text-2xl font-bold">
+            {(data.apiHealth.errorRate * 100).toFixed(2)}%
+          </div>
+          <div className="text-sm text-gray-600">Error Rate</div>
+        </div>
+      </div>
+
+      {/* Slowest endpoints */}
+      {data.endpointBreakdown.length > 0 && (
+        <div className="mb-4">
+          <h4 className="font-medium mb-2">Slowest Endpoints</h4>
+          <ul className="space-y-1">
+            {data.endpointBreakdown
+              .sort((a, b) => b.avgDurationMs - a.avgDurationMs)
+              .slice(0, 5)
+              .map((ep, i) => (
+                <li key={i} className="flex justify-between text-sm">
+                  <span className="font-mono">{ep.endpoint}</span>
+                  <span className="text-orange-600">{ep.avgDurationMs}ms</span>
+                </li>
+              ))}
+          </ul>
+        </div>
+      )}
+
+      {/* Rate limit hits */}
+      {data.rateLimitHits > 0 && (
+        <div className="text-sm text-yellow-600">
+          ⚠️ {data.rateLimitHits} rate limit hits
+        </div>
+      )}
+    </div>
+  );
+}

package/src/logging/hooks/useAdminAnalytics.ts

@@ -1,22 +1,22 @@
-import { TimeRange } from '../types';
-import { useErrorMetrics } from './useErrorMetrics';
-import { useHealthMetrics } from './useHealthMetrics';
-import { useAuditLog } from './useAuditLog';
-
-/**
- * Combined hook for admin analytics
- * Fetches both error and health metrics
- */
-export function useAdminAnalytics(timeRange: TimeRange = '24h') {
-  const errorMetrics = useErrorMetrics(timeRange);
-  const healthMetrics = useHealthMetrics(timeRange);
-  const auditLog = useAuditLog();
-
-  return {
-    errorMetrics,
-    healthMetrics,
-    auditLog,
-    loading: errorMetrics.loading || healthMetrics.loading,
-    error: errorMetrics.error || healthMetrics.error,
-  };
-}
+import { TimeRange } from '../types';
+import { useErrorMetrics } from './useErrorMetrics';
+import { useHealthMetrics } from './useHealthMetrics';
+import { useAuditLog } from './useAuditLog';
+
+/**
+ * Combined hook for admin analytics
+ * Fetches both error and health metrics
+ */
+export function useAdminAnalytics(timeRange: TimeRange = '24h') {
+  const errorMetrics = useErrorMetrics(timeRange);
+  const healthMetrics = useHealthMetrics(timeRange);
+  const auditLog = useAuditLog();
+
+  return {
+    errorMetrics,
+    healthMetrics,
+    auditLog,
+    loading: errorMetrics.loading || healthMetrics.loading,
+    error: errorMetrics.error || healthMetrics.error,
+  };
+}

package/src/logging/hooks/useAuditLog.ts

@@ -1,24 +1,24 @@
-import { useState } from 'react';
-import { AuditLogEntry } from '../types';
-import { writeAuditLog } from '../api/audit-log';
-
-export function useAuditLog() {
-  const [writing, setWriting] = useState(false);
-  const [error, setError] = useState<string | null>(null);
-
-  async function log(entry: Omit<AuditLogEntry, 'id' | 'timestamp'>) {
-    try {
-      setWriting(true);
-      setError(null);
-      await writeAuditLog(entry);
-    } catch (err) {
-      const errMessage = err instanceof Error ? err.message : 'Failed to write audit log';
-      setError(errMessage);
-      throw err;
-    } finally {
-      setWriting(false);
-    }
-  }
-
-  return { log, writing, error };
-}
+import { useState } from 'react';
+import { AuditLogEntry } from '../types';
+import { writeAuditLog } from '../api/audit-log';
+
+export function useAuditLog() {
+  const [writing, setWriting] = useState(false);
+  const [error, setError] = useState<string | null>(null);
+
+  async function log(entry: Omit<AuditLogEntry, 'id' | 'timestamp'>) {
+    try {
+      setWriting(true);
+      setError(null);
+      await writeAuditLog(entry);
+    } catch (err) {
+      const errMessage = err instanceof Error ? err.message : 'Failed to write audit log';
+      setError(errMessage);
+      throw err;
+    } finally {
+      setWriting(false);
+    }
+  }
+
+  return { log, writing, error };
+}

package/src/logging/hooks/useErrorMetrics.ts

@@ -1,40 +1,40 @@
-import { useState, useEffect } from 'react';
-import { ErrorMetrics, TimeRange } from '../types';
-import { getErrorMetrics } from '../api/admin-analytics';
-
-export function useErrorMetrics(timeRange: TimeRange = '24h') {
-  const [data, setData] = useState<ErrorMetrics | null>(null);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState<string | null>(null);
-
-  useEffect(() => {
-    let mounted = true;
-
-    async function fetchData() {
-      try {
-        setLoading(true);
-        const result = await getErrorMetrics(timeRange);
-        if (mounted) {
-          setData(result.data);
-          setError(null);
-        }
-      } catch (err) {
-        if (mounted) {
-          setError(err instanceof Error ? err.message : 'Failed to fetch error metrics');
-        }
-      } finally {
-        if (mounted) {
-          setLoading(false);
-        }
-      }
-    }
-
-    fetchData();
-
-    return () => {
-      mounted = false;
-    };
-  }, [timeRange]);
-
-  return { data, loading, error };
-}
+import { useState, useEffect } from 'react';
+import { ErrorMetrics, TimeRange } from '../types';
+import { getErrorMetrics } from '../api/admin-analytics';
+
+export function useErrorMetrics(timeRange: TimeRange = '24h') {
+  const [data, setData] = useState<ErrorMetrics | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    let mounted = true;
+
+    async function fetchData() {
+      try {
+        setLoading(true);
+        const result = await getErrorMetrics(timeRange);
+        if (mounted) {
+          setData(result.data);
+          setError(null);
+        }
+      } catch (err) {
+        if (mounted) {
+          setError(err instanceof Error ? err.message : 'Failed to fetch error metrics');
+        }
+      } finally {
+        if (mounted) {
+          setLoading(false);
+        }
+      }
+    }
+
+    fetchData();
+
+    return () => {
+      mounted = false;
+    };
+  }, [timeRange]);
+
+  return { data, loading, error };
+}

package/src/logging/hooks/useHealthMetrics.ts

@@ -1,44 +1,44 @@
-import { useState, useEffect } from 'react';
-import { HealthMetrics, TimeRange } from '../types';
-import { getHealthMetrics } from '../api/admin-analytics';
-
-export function useHealthMetrics(timeRange: TimeRange = '1h') {
-  const [data, setData] = useState<HealthMetrics | null>(null);
-  const [loading, setLoading] = useState(true);
-  const [error, setError] = useState<string | null>(null);
-
-  useEffect(() => {
-    let mounted = true;
-
-    async function fetchData() {
-      try {
-        setLoading(true);
-        const result = await getHealthMetrics(timeRange);
-        if (mounted) {
-          setData(result.data);
-          setError(null);
-        }
-      } catch (err) {
-        if (mounted) {
-          setError(err instanceof Error ? err.message : 'Failed to fetch health metrics');
-        }
-      } finally {
-        if (mounted) {
-          setLoading(false);
-        }
-      }
-    }
-
-    fetchData();
-
-    // Auto-refresh health metrics every minute
-    const interval = setInterval(fetchData, 60000);
-
-    return () => {
-      mounted = false;
-      clearInterval(interval);
-    };
-  }, [timeRange]);
-
-  return { data, loading, error };
-}
+import { useState, useEffect } from 'react';
+import { HealthMetrics, TimeRange } from '../types';
+import { getHealthMetrics } from '../api/admin-analytics';
+
+export function useHealthMetrics(timeRange: TimeRange = '1h') {
+  const [data, setData] = useState<HealthMetrics | null>(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState<string | null>(null);
+
+  useEffect(() => {
+    let mounted = true;
+
+    async function fetchData() {
+      try {
+        setLoading(true);
+        const result = await getHealthMetrics(timeRange);
+        if (mounted) {
+          setData(result.data);
+          setError(null);
+        }
+      } catch (err) {
+        if (mounted) {
+          setError(err instanceof Error ? err.message : 'Failed to fetch health metrics');
+        }
+      } finally {
+        if (mounted) {
+          setLoading(false);
+        }
+      }
+    }
+
+    fetchData();
+
+    // Auto-refresh health metrics every minute
+    const interval = setInterval(fetchData, 60000);
+
+    return () => {
+      mounted = false;
+      clearInterval(interval);
+    };
+  }, [timeRange]);
+
+  return { data, loading, error };
+}

package/src/logging/index.ts

@@ -1,18 +1,18 @@
-// Components
-export { ErrorMetricsCard } from './components/ErrorMetricsCard';
-export { HealthMetricsCard } from './components/HealthMetricsCard';
-export { AuditLogViewer } from './components/AuditLogViewer';
-export { AdminAnalyticsLayout } from './components/AdminAnalyticsLayout';
-
-// Hooks
-export { useErrorMetrics } from './hooks/useErrorMetrics';
-export { useHealthMetrics } from './hooks/useHealthMetrics';
-export { useAuditLog } from './hooks/useAuditLog';
-export { useAdminAnalytics } from './hooks/useAdminAnalytics';
-
-// Types
-export * from './types';
-
-// API (for advanced use cases)
-export * from './api/admin-analytics';
-export * from './api/audit-log';
+// Components
+export { ErrorMetricsCard } from './components/ErrorMetricsCard';
+export { HealthMetricsCard } from './components/HealthMetricsCard';
+export { AuditLogViewer } from './components/AuditLogViewer';
+export { AdminAnalyticsLayout } from './components/AdminAnalyticsLayout';
+
+// Hooks
+export { useErrorMetrics } from './hooks/useErrorMetrics';
+export { useHealthMetrics } from './hooks/useHealthMetrics';
+export { useAuditLog } from './hooks/useAuditLog';
+export { useAdminAnalytics } from './hooks/useAdminAnalytics';
+
+// Types
+export * from './types';
+
+// API (for advanced use cases)
+export * from './api/admin-analytics';
+export * from './api/audit-log';

package/src/logging/types/analytics.ts

@@ -1,81 +1,81 @@
-// Universal analytics types that work for ANY app
-
-export interface ErrorMetrics {
-  totalErrors: number;
-  errorCount: number;
-  warnCount: number;
-  fatalCount: number;
-  topFailingRoutes: RouteError[];
-  byCategory: CategoryCount[];
-  topErrorCodes?: TopErrorCode[];
-  hourlyTrend?: HourlyTrendPoint[];
-  periodStart: string;
-  periodEnd: string;
-}
-
-export interface RouteError {
-  route: string;
-  count: number;
-  percentage: number;
-}
-
-export interface LevelCount {
-  level: 'error' | 'warn' | 'fatal';
-  count: number;
-}
-
-export interface CategoryCount {
-  category: string; // Generic: 'api', 'auth', 'billing', etc.
-  count: number;
-}
-
-export interface TopErrorCode {
-  errorCode: string;
-  count: number;
-}
-
-export interface HourlyTrendPoint {
-  hour: string;
-  count: number;
-}
-
-export interface ErrorDetail {
-  timestamp: string;
-  level: string;
-  message: string;
-  path: string;
-  userId?: number;
-  errorCode?: string;
-}
-
-export interface HealthMetrics {
-  timeRange: string;
-  apiHealth: {
-    avgResponseTimeMs: number;
-    p95ResponseTimeMs: number;
-    p99ResponseTimeMs: number;
-    requestCount: number;
-    errorRate: number;
-  };
-  endpointBreakdown: EndpointHealth[];
-  rateLimitHits: number;
-  slowRequests: SlowRequest[];
-}
-
-export interface EndpointHealth {
-  endpoint: string;
-  avgDurationMs: number;
-  p95DurationMs: number;
-  requestCount: number;
-  errorRate: number;
-}
-
-export interface SlowRequest {
-  timestamp: string;
-  path: string;
-  durationMs: number;
-  userId?: number;
-}
-
-// Time range options
-export type TimeRange = '1h' | '24h' | '7d' | '30d';
+// Universal analytics types that work for ANY app
+
+export interface ErrorMetrics {
+  totalErrors: number;
+  errorCount: number;
+  warnCount: number;
+  fatalCount: number;
+  topFailingRoutes: RouteError[];
+  byCategory: CategoryCount[];
+  topErrorCodes?: TopErrorCode[];
+  hourlyTrend?: HourlyTrendPoint[];
+  periodStart: string;
+  periodEnd: string;
+}
+
+export interface RouteError {
+  route: string;
+  count: number;
+  percentage: number;
+}
+
+export interface LevelCount {
+  level: 'error' | 'warn' | 'fatal';
+  count: number;
+}
+
+export interface CategoryCount {
+  category: string; // Generic: 'api', 'auth', 'billing', etc.
+  count: number;
+}
+
+export interface TopErrorCode {
+  errorCode: string;
+  count: number;
+}
+
+export interface HourlyTrendPoint {
+  hour: string;
+  count: number;
+}
+
+export interface ErrorDetail {
+  timestamp: string;
+  level: string;
+  message: string;
+  path: string;
+  userId?: number;
+  errorCode?: string;
+}
+
+export interface HealthMetrics {
+  timeRange: string;
+  apiHealth: {
+    avgResponseTimeMs: number;
+    p95ResponseTimeMs: number;
+    p99ResponseTimeMs: number;
+    requestCount: number;
+    errorRate: number;
+  };
+  endpointBreakdown: EndpointHealth[];
+  rateLimitHits: number;
+  slowRequests: SlowRequest[];
+}
+
+export interface EndpointHealth {
+  endpoint: string;
+  avgDurationMs: number;
+  p95DurationMs: number;
+  requestCount: number;
+  errorRate: number;
+}
+
+export interface SlowRequest {
+  timestamp: string;
+  path: string;
+  durationMs: number;
+  userId?: number;
+}
+
+// Time range options
+export type TimeRange = '1h' | '24h' | '7d' | '30d';

package/src/logging/types/audit.ts

@@ -1,31 +1,31 @@
-export interface AuditLogEntry {
-  id?: number;
-  category: string;
-  action: string;
-  userId?: number;
-  adminUserId?: number;
-  details?: Record<string, any>;
-  ipAddress?: string;
-  userAgent?: string;
-  timestamp?: string;
-}
-
-export interface AuditLogQuery {
-  category?: string;
-  userId?: number;
-  startDate?: string;
-  endDate?: string;
-  page?: number;
-  pageSize?: number;
-}
-
-export interface AuditLogResponse {
-  success: boolean;
-  data: AuditLogEntry[];
-  pagination?: {
-    page: number;
-    pageSize: number;
-    totalCount: number;
-    totalPages: number;
-  };
-}
+export interface AuditLogEntry {
+  id?: number;
+  category: string;
+  action: string;
+  userId?: number;
+  adminUserId?: number;
+  details?: Record<string, any>;
+  ipAddress?: string;
+  userAgent?: string;
+  timestamp?: string;
+}
+
+export interface AuditLogQuery {
+  category?: string;
+  userId?: number;
+  startDate?: string;
+  endDate?: string;
+  page?: number;
+  pageSize?: number;
+}
+
+export interface AuditLogResponse {
+  success: boolean;
+  data: AuditLogEntry[];
+  pagination?: {
+    page: number;
+    pageSize: number;
+    totalCount: number;
+    totalPages: number;
+  };
+}