Files
app/.cursor/rules/debug-logging-ktor.mdc
T
2026-04-21 14:49:35 +03:00

17 lines
909 B
Plaintext

---
description: Use Ktor HttpClient for debug-mode logging instead of platform APIs
alwaysApply: true
---
# Debug-mode logging with Ktor
- Prefer **Ktor `HttpClient`** for all debug/instrumentation HTTP logging in this project.
- **Do NOT** use `HttpURLConnection`, raw `OkHttpClient`, or other low-level networking APIs for debug-only logging.
- Centralize debug logging behind `ru.fromchat.debug.DebugLogger` and keep it **best-effort only** (never throw, never crash the app).
- When adding new debug logging:
- Use a shared `HttpClient` instance (per platform) configured with the appropriate engine (e.g. OkHttp on Android).
- Send JSON NDJSON-style payloads to the configured debug endpoint.
- Avoid blocking the main thread; run network I/O in coroutines on a background dispatcher.
- Keep debug logging code small and self-contained so it is easy to remove or disable when no longer needed.