network/io.github.maniramezan.kenwork.network/NetworkEvent

NetworkEvent

class NetworkEvent(val endpointId: String, val method: String, val durationMs: Long, val statusCode: Int? = null, val errorType: String? = null, val isRetryable: Boolean = false, val attempt: Int = 0, val isFinalAttempt: Boolean = true)

A single observed network request outcome, for telemetry/analytics. The Kotlin counterpart of Novalingo's NetworkTelemetryEvent, kept transport-agnostic so any analytics backend can consume it.

Constructors

NetworkEvent

constructor(endpointId: String, method: String, durationMs: Long, statusCode: Int? = null, errorType: String? = null, isRetryable: Boolean = false, attempt: Int = 0, isFinalAttempt: Boolean = true)

Properties

attempt

val attempt: Int

the 0-based attempt index this event describes (0 = first try). A request that is retried emits one event per failed attempt followed by a final success/failure event.

durationMs

val durationMs: Long

wall-clock duration of the attempt(s).

endpointId

val endpointId: String

a normalized, low-cardinality endpoint identifier (e.g. videos/:id).

errorType

val errorType: String?

a coarse error classification, or null on success.

isFinalAttempt

val isFinalAttempt: Boolean

whether this event is the last one for its logical request — true for a success, or for a failure the RetryPolicy declined to retry; false for a failed attempt that's about to be retried. Lets a metrics bridge emit exactly one request-duration observation per logical request (filter on isFinalAttempt) while still using every event, including non-final ones, for a per-attempt/retry-count counter.

isRetryable

val isRetryable: Boolean

whether the failure is considered transient.

isSuccess

val isSuccess: Boolean

Whether this event represents a successful (2xx) request.

method

val method: String

the HTTP method.

statusCode

val statusCode: Int?

the final HTTP status, or null if the request never completed.

Functions

component1

operator fun component1(): String

component2

operator fun component2(): String

component3

operator fun component3(): Long

component4

operator fun component4(): Int?

component5

operator fun component5(): String?

component6

operator fun component6(): Boolean

component7

operator fun component7(): Int

copy

fun copy(endpointId: String = this.endpointId, method: String = this.method, durationMs: Long = this.durationMs, statusCode: Int? = this.statusCode, errorType: String? = this.errorType, isRetryable: Boolean = this.isRetryable, attempt: Int = this.attempt): NetworkEvent

Preserves the copy method and copy$default bridge generated by the pre-0.4 data class.

fun copy(endpointId: String, method: String, durationMs: Long, statusCode: Int?, errorType: String?, isRetryable: Boolean, attempt: Int, isFinalAttempt: Boolean): NetworkEvent

Copies an event while explicitly changing whether it is the final attempt.

equals

open operator override fun equals(other: Any?): Boolean

hashCode

open override fun hashCode(): Int

toString

open override fun toString(): String