@spec clamp_dates(Plausible.Site.t(), Date.t(), Date.t()) ::
  {:ok, Date.t(), Date.t()} | {:error, :no_time_window}

@spec clamp_dates([Date.Range.t()], Date.t(), Date.t(), Date.t()) ::
  {:ok, Date.t(), Date.t()} | {:error, :no_time_window}

@spec delete_imports_for_site(Plausible.Site.t()) :: :ok

@spec get_cutoff_date(Plausible.Site.t()) :: Date.t()

@spec get_import(Plausible.Site.t(), non_neg_integer()) ::
  Plausible.Imported.SiteImport.t() | nil

@spec get_imports_date_range(Plausible.Site.t()) :: %{
  start_date: Date.t() | nil,
  end_date: Date.t() | nil
}

@spec get_legacy_import(Plausible.Site.t()) :: Plausible.Imported.SiteImport.t() | nil

@spec get_occupied_date_ranges(Plausible.Site.t()) :: [Date.Range.t()]

@spec goals_with_path() :: [String.t()]

@spec goals_with_url() :: [String.t()]

@spec imported_custom_props() :: [String.t()]

@spec list_all_imports(Plausible.Site.t(), atom()) :: [
  Plausible.Imported.SiteImport.t()
]

@spec list_complete_import_ids(Plausible.Site.t()) :: [non_neg_integer()]

@spec load_import_data(Plausible.Site.t()) :: Plausible.Site.t()

@spec max_complete_imports() :: non_neg_integer()

@spec other_imports_in_progress?(Plausible.Imported.SiteImport.t()) :: boolean()

@spec schemas() :: [module()]

@spec tables() :: [String.t()]