Auto-refresh functionality for MishkaGervaz tables.

Provides automatic data reloading at configurable intervals with intelligent pausing during user interactions.

Configuration

Enable in domain table config:

mishka_gervaz do
  table do
    refresh do
      enabled true
      interval 30_000  # 30 seconds
      pause_on_interaction true
      show_indicator true
      pause_on_blur true
    end
  end
end

Usage in LiveComponent

The table LiveComponent integrates with this module:

def mount(socket) do
  socket =
    socket
    |> assign(:refresh_config, get_refresh_config())
    |> Refresh.init()

  {:ok, socket}
end

def handle_info(:gervaz_refresh, socket) do
  socket =
    socket
    |> reload_data()
    |> Refresh.schedule(socket.assigns.refresh_config)

  {:noreply, socket}
end

def handle_event("filter", params, socket) do
  # Pause refresh during interaction
  socket = Refresh.pause(socket)

  # ... handle filter ...

  # Resume after interaction
  socket = Refresh.resume(socket, socket.assigns.refresh_config)
  {:noreply, socket}
end

Client-side Integration

For pause_on_blur, add this to your app.js:

window.addEventListener("blur", () => {
  document.querySelectorAll("[data-gervaz-refresh]").forEach(el => {
    el.dispatchEvent(new CustomEvent("gervaz:pause_refresh"))
  })
})

window.addEventListener("focus", () => {
  document.querySelectorAll("[data-gervaz-refresh]").forEach(el => {
    el.dispatchEvent(new CustomEvent("gervaz:resume_refresh"))
  })
})

See MishkaGervaz.Table.Web.State, MishkaGervaz.Table.Web.AutoState, MishkaGervaz.Table.Web.DataLoader, MishkaGervaz.Table.Dsl.Refresh (resource-level DSL section), MishkaGervaz.Table.Dsl.Defaults (domain-level defaults).