@type json_relation() :: [String.t(), ...]

@type json_safe() :: %{
  root_table: json_relation(),
  root_table_id: non_neg_integer(),
  where: String.t(),
  selected_columns: [String.t(), ...] | nil,
  table_info: [json_table_list(), ...]
}

@type json_table_info() :: table_info() | json_relation()

@type json_table_list() :: [json_table_info(), ...]

@type replica() :: :full | :default

@type t() :: %Electric.Shapes.Shape{
  replica: replica(),
  root_table: Electric.relation(),
  root_table_id: Electric.relation_id(),
  selected_columns: [String.t(), ...] | nil,
  table_info: %{required(Electric.relation()) => table_info()},
  where: Electric.Replication.Eval.Expr.t() | nil
}

@type table_info() :: %{
  columns: [Electric.Postgres.Inspector.column_info(), ...],
  pk: [String.t(), ...]
}

@type table_with_where_clause() :: {Electric.relation(), String.t() | nil}