@type correlation_ref() :: {:ref, String.t()}

@type join_type() :: :left | :inner | :right | :full

@type json_table_column() :: %{
  :name => String.t(),
  optional(:path) => String.t(),
  optional(:type) => atom(),
  optional(:for_ordinality) => boolean()
}

@type subquery_builder() :: (Selecto.t() -> Selecto.t())

@type t() :: %Selecto.Advanced.LateralJoin.Spec{
  alias: String.t(),
  correlation_refs: [correlation_ref()],
  id: String.t(),
  join_type: join_type(),
  subquery_builder: subquery_builder() | nil,
  table_function: table_function() | nil,
  validated: boolean()
}

@type table_function() ::
  {:unnest, String.t()}
  | {:function, atom(), [term()]}
  | {:udf_table, atom() | String.t(), [term()]}
  | {:json_each, String.t(), String.t() | nil}
  | {:json_tree, String.t(), String.t() | nil}
  | {:json_table, String.t(), String.t(), [json_table_column()]}