Package-level declarations

Configuration for the Autograph builder.

Marks a declaration that exists only so Autograph's own modules can share it across a module boundary — not a supported API for library users. It may change or disappear in any release, including a patch.

Sink for the library's own diagnostic messages — a delivery that failed, or an event dropped because it did not validate. Set one on AutographConfig.logger to route these into your app's logging framework (Logcat, os_log, Timber, …) or to silence them; the default prints to the console, matching the library's historical behavior.

Wraps delegate, logging every event before delivering it — for eyeballing outgoing events on a real device/build during manual QA, separate from the app's production transport. Not connected to a warehouse or any assertion tooling (see the planned autograph-test module for unit-test assertions instead).

The instrumentation envelope stamped onto every event.

Provides instrumentation envelopes. Implemented by the library core; transports that run their own event pipeline (e.g. Segment) call stamp from inside that pipeline so that sequence numbers match the actual enqueue order — including events the transport generates itself, such as lifecycle events.

Built-in EventIdGenerator strategies.

Generates a unique identifier for each event.

Checks a track/screen event against an app-defined tracking-plan contract — a fixed set of event types, required properties, naming conventions — before it reaches the transport.

A non-persistent SeqStore for tests or ephemeral configurations.

Controls how sequence counters are persisted.

Minimal key-value persistence used for sequence counters and session state.

Controls which sequence numbers are stamped into the event envelope.

Session semantics: a session ends when the app has been inactive for longer than backgroundTimeout. Session state is persisted, so a session survives process restarts as long as activity resumes within the timeout.

A snapshot of the session an event belongs to.

The main entry point for recording analytics events.

SPI implemented by transport adapters (e.g. autograph-segment).

An empty JsonObject, useful as a default for event properties.

Creates a Tracker.

Builds an Envelope with caller-chosen field values, bypassing the stamper.

Returns the platform-default SeqStore: a FileSeqStore under the app's private data directory, or an InMemorySeqStore if no writable directory is available (in which case counters do not survive a restart).