autograph-test/dev.ynagai.autograph.test/InMemoryTestTransport

InMemoryTestTransport

A Transport that records every event in memory instead of sending it anywhere — for unit tests that need to assert "does this code fire the right event with the right properties?" without a real backend or dev.ynagai.autograph.DebugTransport's log-only, non-assertable output.

val transport = InMemoryTestTransport()
val tracker = Autograph {
    transport(transport)
    store = InMemorySeqStore() // don't let seq/session state leak onto disk between test runs
    dispatcher = kotlinx.coroutines.Dispatchers.Unconfined // stamp synchronously in tests
}

tracker.track("Recipe Saved", target = "share_button")

transport.assertEventFired("Recipe Saved", properties = mapOf("target" to "share_button"))

Constructors

constructor()

Types

Kind

enum Kind : Enum<InMemoryTestTransport.Kind>

RecordedEvent

data class RecordedEvent(val kind: InMemoryTestTransport.Kind, val name: String, val properties: JsonObject, val envelope: Envelope?)

One recorded call. name is the event/screen name for Kind.TRACK/Kind.SCREEN, or the user id for Kind.IDENTIFY.

Properties

events

val events: List<InMemoryTestTransport.RecordedEvent>

Every event recorded so far, in the order they were delivered to this transport.

flushCount

var flushCount: Int

How many times flush was called.

resetCount

var resetCount: Int

How many times reset was called.

stampsInPipeline

open val stampsInPipeline: Boolean

Functions

assertEventFired

fun InMemoryTestTransport.assertEventFired(name: String, properties: Map<String, Any?>? = null, exact: Boolean = false): InMemoryTestTransport.RecordedEvent

Asserts that a track event named name was recorded, and returns it.

assertEventNotFired

fun InMemoryTestTransport.assertEventNotFired(name: String)

Asserts that no track event named name was ever recorded.

assertIdentifyFired

fun InMemoryTestTransport.assertIdentifyFired(userId: String, traits: Map<String, Any?>? = null, exact: Boolean = false): InMemoryTestTransport.RecordedEvent

Asserts that identify(userId, ...) was recorded, and returns it. See assertEventFired for traits/exact.

assertNoSeqGaps

fun InMemoryTestTransport.assertNoSeqGaps()

Asserts that both dev.ynagai.autograph.Envelope.seq (gapless, +1 within each contiguous run of events sharing a session id — a session rotation restarts it at 1, which is expected and not a gap) and dev.ynagai.autograph.Envelope.globalSeq (gapless, +1 across the whole device lifetime, independent of session) hold wherever each is non-null. Depending on AutographConfig.sequence, only one, both, or neither may be stamped (SequenceMode.None stamps neither, so nothing is checked); events with no envelope are skipped.

assertOrder

fun InMemoryTestTransport.assertOrder(vararg names: String)

Asserts that events fired in exactly this names order (across all kinds — track/screen/identify).

assertScreenFired

fun InMemoryTestTransport.assertScreenFired(name: String, properties: Map<String, Any?>? = null, exact: Boolean = false): InMemoryTestTransport.RecordedEvent

Asserts that a screen event named name was recorded, and returns it. See assertEventFired for properties/exact.

assertSingleSession

fun InMemoryTestTransport.assertSingleSession(): String

Asserts every recorded event with an envelope belongs to the same session (no rotation occurred), and returns that session id.

clear

fun clear()

Discards every recorded event — useful between test cases sharing one transport/tracker.

connect

open override fun connect(envelopes: EnvelopeSource)

flush

open override fun flush()

identify

open override fun identify(userId: String, traits: JsonObject, envelope: Envelope?)

reset

open override fun reset()

screen

open override fun screen(name: String, properties: JsonObject, envelope: Envelope?)

track

open override fun track(name: String, properties: JsonObject, envelope: Envelope?)