Serverpod Logging Rules

┌─────────────────────────────────────────────────────────┐
│                      Repository                          │
│  ┌─────────────────────────────────────────────────┐    │
│  │              ApiInterceptor                      │    │
│  │  ┌─────────────────────────────────────────┐    │    │
│  │  │         Serverpod Client                │    │    │
│  │  │  (kobic_client → kobic_server)          │    │    │
│  │  └─────────────────────────────────────────┘    │    │
│  └─────────────────────────────────────────────────┘    │
└─────────────────────────────────────────────────────────┘

const ApiInterceptor({
  this.enableLogging = true,   // Enable API call logging
  this.enableRetry = true,     // Enable retry on failure
  this.maxRetries = 3,         // Maximum retry count
  this.retryDelay = 1s,        // Delay between retries
})

class BookRepository implements IBookRepository {
  final ApiInterceptor _interceptor;

  @override
  Future<Either<Failure, Book>> getBook(int id) async {
    try {
      final result = await _interceptor.executeApiCall(
        apiCall: () => _client.book.getBook(id),
        apiName: 'getBook',
        parameters: {'id': id},
      );
      return Right(result);
    } on ApiException catch (error) {
      return Left(error.toFailure());
    }
  }
}

🚀 API Call: getBook
⏰ Start: 10:30:45.123
📝 Parameters:
  • id: 123

✅ API Success: getBook (245ms)
📊 Result: Book
  • Value: Book(id: 123, title:  ' Title ' )

❌ API Failure: getBook (1205ms)
💥 Error: ServerpodClientException
📄 Message: Not Found

⚠️ Retry 2/3 (after 1000ms)

// Custom retry configuration
final interceptor = ApiInterceptor(
  enableRetry: true,
  maxRetries: 5,
  retryDelay: const Duration(seconds: 2),
);

// ❌ Forbidden: Include sensitive info in parameters
await _interceptor.executeApiCall(
  apiCall: () => _client.auth.login(userId, password),
  apiName: 'login',
  parameters: {
    'userId': userId,
    'password': password,  // 🚨 Forbidden!
  },
);

// ✅ Recommended: Exclude sensitive info
await _interceptor.executeApiCall(
  apiCall: () => _client.auth.login(userId, password),
  apiName: 'login',
  parameters: {'userId': userId},  // password excluded
);

import 'package:flutter/foundation.dart' show kDebugMode;

// Set in ApiInterceptorConfig
class ApiInterceptorConfig {
  static const defaultEnableLogging = kDebugMode;
  // ...
}

// Or explicitly set during creation
final interceptor = ApiInterceptor(
  enableLogging: kDebugMode,
);

// In backend/kobic_server
Future<Book> getBook(Session session, int id) async {
  session.log('📚 Book lookup request: id=$id');

  final book = await Book.db.findById(session, id);

  if (book == null) {
    session.log('⚠️ Book not found: id=$id', level: LogLevel.warning);
    throw NotFoundException('Book not found');
  }

  session.log('✅ Book lookup success: ${book.title}');
  return book;
}