foundation/io.github.maniramezan.kommon.foundation

Package-level declarations

Types

abstract class BaseViewModel<State, Event>(initialState: State) : ViewModel

Base ViewModel with a StateFlow-driven unidirectional data flow.

Minimal logging seam so shared-library modules (sync, auth-session bootstrap, etc.) can log without depending on any specific logging framework (Timber, java.util.logging, etc.).

LoadingError

data class LoadingError(val message: String, val isRetryable: Boolean = true)

Error wrapper for loading failures with user-friendly messages.

LoadingState

sealed class LoadingState<out T>

Generic loading state for async data-fetching operations backed by a kotlinx.coroutines.flow.StateFlow.

NoOpLogger

object NoOpLogger : KommonLogger

A KommonLogger that discards everything. Safe default for libraries and tests.

TimberLogger

class TimberLogger(tagPrefix: String) : KommonLogger

KommonLogger implementation backed by Timber, with a configurable tagPrefix (ported from Novalingo's Logger singleton) and a built-in release tree that suppresses verbose/debug/info logs, forwarding only warnings and errors to an optional ReleaseLogSink (e.g. crash reporting).

Functions

isValidEmail

fun String.isValidEmail(): Boolean

True when the trimmed string parses as a syntactically valid email address.

loadingStateOf

suspend fun <T> loadingStateOf(block: suspend () -> T): LoadingState<T>

Runs block and wraps its outcome as LoadingState.Loaded or LoadingState.Failed (classified through LoadingError.from). Coroutine cancellation is rethrown, never reported as a failure.

map

inline fun <T, R> LoadingState<T>.map(transform: (T) -> R): LoadingState<R>

Transforms the LoadingState.Loaded payload, leaving every other state untouched.