analytics-core/io.github.maniramezan.kommon.analytics

Package-level declarations

Types

Provider-agnostic analytics client interface. Apps implement (or bridge) this against whatever analytics SDK they use (Firebase, Amplitude, PostHog, etc.); the shared library only depends on this interface, never a concrete provider.

AnalyticsEvent

data class AnalyticsEvent(val name: String, val properties: Map<String, Any> = emptyMap())

A trackable analytics event.

AnalyticsPayloadSanitizer

object AnalyticsPayloadSanitizer

Truncates/limits event and user-property payloads to conservative size limits shared by most analytics providers (event parameter counts, string lengths). Apply before calling AnalyticsClient.track/AnalyticsClient.setUserProperties to avoid provider-side rejection or truncation surprises.

CompositeAnalyticsClient

class CompositeAnalyticsClient(clients: List<AnalyticsClient>) : AnalyticsClient

Forwards every call to all configured clients, so apps can fan out to multiple providers.

LoggingAnalyticsClient

class LoggingAnalyticsClient(logger: KommonLogger) : AnalyticsClient

Analytics client that logs every call, for local and staging verification.

NoOpAnalyticsClient

class NoOpAnalyticsClient(logger: KommonLogger = NoOpLogger) : AnalyticsClient

Analytics client that does nothing but log at debug level. Useful for debug builds.