defmodule QuackDB.Cursor do
  @moduledoc """
  Cursor metadata used by `DBConnection` streaming.

  A cursor tracks the remote Quack result UUID plus column/type metadata needed
  to fetch and materialize subsequent result chunks.
  """

  defstruct [:ref, :result_uuid, :columns, :result_types, :connection_id]
end

defimpl Inspect, for: QuackDB.Cursor do
  import Inspect.Algebra

  def inspect(cursor, opts) do
    fields = [
      result_uuid: cursor.result_uuid,
      columns: cursor.columns,
      connection_id: QuackDB.Inspect.short_id(cursor.connection_id)
    ]

    concat(QuackDB.Inspect.container("QuackDB.Cursor", fields, opts))
  end
end