Skip to content

CHANGELOG.md

Latest commit

 

History

History
65 lines (56 loc) · 4.02 KB

CHANGELOG.md

File metadata and controls

65 lines (56 loc) · 4.02 KB

Changelog

All notable changes to AppLogger are documented in this file.

The format follows Keep a Changelog and the project adheres to Semantic Versioning.

[Unreleased]

Added

  • Exponential backoff with jitter — transport retries use base * 2^attempt capped at 30s.
  • Dead Letter Queue — events that exhaust retries are preserved for inspection.
  • Health Check API — AppLoggerHealth.snapshot() returns SDK internal state.
  • Certificate pinning support — SupabaseTransport accepts a custom HttpClient.
  • KDoc — comprehensive English documentation on all 19 public API files.
  • iOS distribution — Package.swift (SPM) and AppLogger.podspec (CocoaPods).
  • XCFramework task in sdk/logger-core/build.gradle.kts.
  • Dokka — API docs generation configured with CI upload.
  • Conventional Commits — git hook enforcer in .githooks/commit-msg.
  • CodeQL security scanning in CI workflow.
  • Dependency submission to GitHub for vulnerability alerts.
  • Detekt static analysis with SARIF reports.
  • JaCoCo code coverage with Codecov integration.
  • Dependabot for Gradle and GitHub Actions dependencies.
  • ProGuard/R8 consumer rules for logger-core and logger-transport-supabase.
  • .editorconfig for consistent code formatting.

[0.1.1] — 2026-03-17

Added

  • AppLogger interface — unified logging contract for Kotlin (Android / JVM / iOS).
  • LogTransport interface — swappable transport abstraction (REST, gRPC, stdio).
  • LogBuffer interface — temporary event storage with configurable overflow policy.
  • LogFilter interface — event filtering with chain-of-responsibility support.
  • LogFormatter interface — LogEvent serialization (JSON implementation included).
  • DeviceInfoProvider interface — technical device metadata without PII.
  • CrashHandler interface — UncaughtException capture with synchronous pre-death flush.
  • AppLoggerImpl — core event pipeline with Channel<LogEvent> from Kotlin Coroutines.
  • BatchProcessor — batch processor with size-based, time-based, and severity-based flush.
  • RateLimitFilter — per-tag rate limiter with auto-bypass for ERROR and CRITICAL.
  • NoOpLogger — empty implementation for pre-init state and tests.
  • InMemoryLogger — test implementation with built-in assertions.
  • FakeTransport — transport mock with success/failure control for tests.
  • SupabaseTransport — Supabase (PostgreSQL) transport with anon key auth via Ktor.
  • PlatformDetector — automatic detection of ANDROID_MOBILE, ANDROID_TV, WEAR_OS, JVM.
  • SqliteOfflineBuffer — persistent FIFO buffer in SQLite for offline operation on Android TV.
  • AppLoggerLifecycleObserver — automatic flush when app backgrounds.
  • AppLoggerConfig.Builder — typed configuration builder with adaptive defaults per platform.
  • AppLoggerSDK — public entry singleton (Android), idempotent initialization.
  • AppLoggerIos — public entry singleton (iOS), exported to Swift via KMP framework.
  • logger-test module — testing utilities: NoOpTestLogger, InMemoryLogger, FakeTransport.
  • Privacy by design: no PII captured, ephemeral session_id, optional user_id with consent.
  • Crash handler chaining: SDK chains the previous handler, never replaces it.
  • Mandatory TLS: builder rejects HTTP endpoints in production mode.
  • Complete documentation: docs/ES/desarrollo/, docs/ES/paquete/.
  • SQL migrations: docs/ES/migraciones/001 a docs/ES/migraciones/005 for PostgreSQL / Supabase.
  • CI/CD with GitHub Actions: test workflows on PRs and automated release on tags.

Security

  • API keys never hardcoded: injected via BuildConfig from local.properties or CI env vars.
  • Row Level Security in Supabase: anon role only has INSERT permission on app_logs.
  • Production endpoint requires https:// — validated at Config build time.