retrace_frontend/client

JavaScript delivery runtime. Capture and application updates remain separate. The host owns start/stop; saved batches drain across runtime restarts.

Types

Client

</>

pub type Client

Config

</>

pub type Config {
  Config(
    endpoint: String,
    queue_name: String,
    max_items: Int,
    max_bytes: Int,
  )
}

Constructors

Config(
  endpoint: String,
  queue_name: String,
  max_items: Int,
  max_bytes: Int,
)

Status

</>

pub type Status {
  Status(queued: Int, acknowledged: Int, detail: String)
}

Constructors

Status(queued: Int, acknowledged: Int, detail: String)

Storage

</>

A factory that opens caller-owned persistence. Use retrace_frontend/client/adapter to construct one from Gleam operations, or provide an existing FFI adapter.

pub type Storage

Transport

</>

An abortable upload returning acknowledgement JSON. Construct one through retrace_frontend/client/adapter or use a provided transport. No reducer runs here.

pub type Transport

Values

browser_storage

</>

pub fn browser_storage() -> Storage

enqueue

</>

pub fn enqueue(
  client: Client,
  batch: wire.Batch,
  saved: fn(Result(Nil, String)) -> Nil,
) -> Nil

Called after projection. The callback confirms local persistence, not upload. Validation failure does not touch local storage or the network.

http_transport

</>

pub fn http_transport(endpoint: String) -> Transport

retry

</>

pub fn retry(client: Client) -> Nil

start

</>

pub fn start(
  config: Config,
  on_status: fn(Status) -> Nil,
) -> Client

start_with

</>

pub fn start_with(
  config: Config,
  storage: Storage,
  transport: Transport,
  on_status: fn(Status) -> Nil,
) -> Client

Advanced entrypoint; the caller selects persistence and upload policy.

stop

</>

pub fn stop(client: Client) -> Nil