feat: Add comprehensive error boundaries for graceful error handling
Some checks failed
CI/CD Pipeline / Lint and Test (push) Has been cancelled
CI/CD Pipeline / E2E Tests (push) Has been cancelled
CI/CD Pipeline / Build Application (push) Has been cancelled

Implemented React error boundaries to catch and handle errors gracefully:

**Core Error Handling Components:**
- Created ErrorBoundary class component with error catching and logging
- Created specialized fallback UIs (MinimalErrorFallback, DataErrorFallback,
  ComponentErrorFallback, FormErrorFallback, ChartErrorFallback, ImageErrorFallback)
- Added withErrorBoundary HOC for easy component wrapping
- Created errorLogger service with Sentry integration placeholder

**Error Logging Service (errorLogger.ts):**
- Centralized error logging with severity levels (FATAL, ERROR, WARNING, INFO, DEBUG)
- Context enrichment (URL, userAgent, timestamp, environment)
- Local storage of last 10 errors in sessionStorage for debugging
- User context management (setUser, clearUser)
- Breadcrumb support for debugging trails

**App Integration:**
- Wrapped root layout with top-level ErrorBoundary for catastrophic errors
- Added NetworkStatusIndicator to main page for offline sync visibility
- Wrapped daily summary section with isolated DataErrorFallback
- Added error boundary to AI assistant page with ComponentErrorFallback
- Wrapped feeding tracking form with FormErrorFallback using withErrorBoundary HOC
- Protected analytics charts with isolated ChartErrorFallback boundaries

**Error Recovery Features:**
- Isolated error boundaries prevent cascade failures
- Retry buttons on all fallback UIs
- Error count tracking with user warnings
- Development-mode error details display
- Automatic error logging to service (when Sentry integrated)

Next: Integration with Sentry for production error tracking

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-10-01 19:37:04 +00:00
parent 7cb2ff97de
commit 68e33712f1
8 changed files with 797 additions and 69 deletions

View File

@@ -0,0 +1,253 @@
/**
* Error Logging Service
* Centralized error logging that can integrate with Sentry or other services
*/
export interface ErrorContext {
componentStack?: string;
errorBoundary?: string;
userId?: string;
userEmail?: string;
url?: string;
userAgent?: string;
timestamp?: string;
[key: string]: any;
}
export enum ErrorSeverity {
FATAL = 'fatal',
ERROR = 'error',
WARNING = 'warning',
INFO = 'info',
DEBUG = 'debug',
}
class ErrorLogger {
private enabled: boolean;
private environment: string;
constructor() {
this.enabled = process.env.NEXT_PUBLIC_SENTRY_ENABLED === 'true';
this.environment = process.env.NODE_ENV || 'development';
}
/**
* Initialize error logging service (e.g., Sentry)
*/
init() {
if (!this.enabled) {
console.log('[ErrorLogger] Error tracking disabled');
return;
}
// TODO: Initialize Sentry
// import * as Sentry from '@sentry/nextjs';
// Sentry.init({
// dsn: process.env.NEXT_PUBLIC_SENTRY_DSN,
// environment: this.environment,
// tracesSampleRate: 0.1,
// beforeSend(event) {
// // Filter out sensitive data
// return event;
// },
// });
console.log('[ErrorLogger] Error tracking initialized');
}
/**
* Log an error with context
*/
logError(error: Error, context?: ErrorContext, severity: ErrorSeverity = ErrorSeverity.ERROR) {
const enrichedContext = this.enrichContext(context);
// Log to console in development
if (this.environment === 'development') {
console.error(`[ErrorLogger] ${severity.toUpperCase()}:`, error.message, {
stack: error.stack,
context: enrichedContext,
});
}
// Send to error tracking service
if (this.enabled) {
this.sendToService(error, enrichedContext, severity);
}
// Store locally for debugging
this.storeLocally(error, enrichedContext, severity);
}
/**
* Log an exception (wrapper for logError)
*/
captureException(error: Error, context?: ErrorContext) {
this.logError(error, context, ErrorSeverity.ERROR);
}
/**
* Log a message (non-error logging)
*/
captureMessage(message: string, context?: ErrorContext, severity: ErrorSeverity = ErrorSeverity.INFO) {
const enrichedContext = this.enrichContext(context);
if (this.environment === 'development') {
console.log(`[ErrorLogger] ${severity.toUpperCase()}: ${message}`, enrichedContext);
}
if (this.enabled) {
// TODO: Send to Sentry as message
// Sentry.captureMessage(message, {
// level: severity,
// contexts: { custom: enrichedContext },
// });
}
}
/**
* Add breadcrumb for debugging
*/
addBreadcrumb(message: string, category?: string, data?: Record<string, any>) {
if (this.environment === 'development') {
console.log(`[ErrorLogger] Breadcrumb: ${category || 'default'} - ${message}`, data);
}
if (this.enabled) {
// TODO: Add to Sentry
// Sentry.addBreadcrumb({
// message,
// category,
// data,
// timestamp: Date.now() / 1000,
// });
}
}
/**
* Set user context for error tracking
*/
setUser(user: { id: string; email?: string; name?: string }) {
if (this.enabled) {
// TODO: Set in Sentry
// Sentry.setUser({
// id: user.id,
// email: user.email,
// username: user.name,
// });
}
}
/**
* Clear user context (e.g., on logout)
*/
clearUser() {
if (this.enabled) {
// TODO: Clear in Sentry
// Sentry.setUser(null);
}
}
/**
* Set additional context tags
*/
setTag(key: string, value: string) {
if (this.enabled) {
// TODO: Set in Sentry
// Sentry.setTag(key, value);
}
}
/**
* Enrich context with additional information
*/
private enrichContext(context?: ErrorContext): ErrorContext {
return {
...context,
url: typeof window !== 'undefined' ? window.location.href : undefined,
userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,
timestamp: new Date().toISOString(),
environment: this.environment,
// Add app version if available
appVersion: process.env.NEXT_PUBLIC_APP_VERSION,
};
}
/**
* Send error to tracking service
*/
private sendToService(error: Error, context: ErrorContext, severity: ErrorSeverity) {
// TODO: Implement Sentry integration
// Sentry.captureException(error, {
// level: severity,
// contexts: {
// custom: context,
// },
// tags: {
// errorBoundary: context.errorBoundary,
// },
// });
}
/**
* Store error locally for debugging
*/
private storeLocally(error: Error, context: ErrorContext, severity: ErrorSeverity) {
if (typeof window === 'undefined') return;
try {
const errorLog = {
message: error.message,
stack: error.stack,
severity,
context,
timestamp: new Date().toISOString(),
};
// Store in sessionStorage (limited to 10 most recent errors)
const storedErrors = JSON.parse(sessionStorage.getItem('error_logs') || '[]');
storedErrors.push(errorLog);
// Keep only last 10 errors
if (storedErrors.length > 10) {
storedErrors.shift();
}
sessionStorage.setItem('error_logs', JSON.stringify(storedErrors));
} catch (e) {
// Ignore storage errors
console.error('Failed to store error locally:', e);
}
}
/**
* Get locally stored errors (for debugging)
*/
getLocalErrors() {
if (typeof window === 'undefined') return [];
try {
return JSON.parse(sessionStorage.getItem('error_logs') || '[]');
} catch (e) {
return [];
}
}
/**
* Clear locally stored errors
*/
clearLocalErrors() {
if (typeof window !== 'undefined') {
sessionStorage.removeItem('error_logs');
}
}
}
// Export singleton instance
export const errorLogger = new ErrorLogger();
// Initialize on import
if (typeof window !== 'undefined') {
errorLogger.init();
}
export default errorLogger;