A lightweight JS execution context on a shared runtime thread.

Unlike a full runtime, a context does not spawn a dedicated OS thread. Many contexts share a single JSRuntime thread managed by a QuickBEAM.ContextPool. This makes each context ~58 KB (bare) to ~429 KB (full browser APIs) vs ~2 MB+ for a full runtime — ideal for per-connection state in Phoenix LiveView.

Example

{:ok, pool} = QuickBEAM.ContextPool.start_link()
{:ok, ctx} = QuickBEAM.Context.start_link(pool: pool)
{:ok, 3} = QuickBEAM.Context.eval(ctx, "1 + 2")
QuickBEAM.Context.stop(ctx)

With LiveView

def mount(_params, _session, socket) do
  {:ok, ctx} = QuickBEAM.Context.start_link(
    pool: MyApp.JSPool,
    handlers: %{"db.query" => &MyApp.query/1}
  )
  {:ok, assign(socket, js: ctx)}
end

def handle_event("click", params, socket) do
  {:ok, html} = QuickBEAM.Context.call(socket.assigns.js, "handleClick", [params])
  {:noreply, push_event(socket, "update", %{html: html})}
end

start_link/1 links the context to the calling process, so it automatically terminates (and cleans up its JS context) when the LiveView process exits. No explicit terminate callback needed.