Put back in FacebookResponse methods and deprecate them instead of removing them

Update changelog

Author: nickdnk

CHANGELOG.md

@@ -15,11 +15,15 @@
         - `GraphExperience`
         - `GraphInsightsRangeValue`
         - `GraphMailingAddress`
+        - `GraphPaymentPricePoint`
+        - `GraphPaymentPricePoints`
+        - `GraphPermission`
         - `GraphPhoto`
         - `GraphPlace`
         - `GraphPlatformImageSource`
         - `GraphVideo`
         - `GraphVideoFormat`
+        - `GraphVideoUploadLimits`
     - Removed integration tests as Facebook's API does not support it anymore anyway.
     - Deleted the entire `docs` folder as it's too much work to maintain and was full of outdated examples. For
       documentation, see https://developers.facebook.com/docs/graph-api.
@@ -75,15 +79,15 @@
     - `GraphAchievement`:
         - Removed entirely. See https://developers.facebook.com/docs/graph-api/reference/user/achievements.
     - `FacebookResponse`:
-        - Removed these type-casting methods. Use `getGraphNode(<class>)` instead. This is similar to the changes made to
+        - Deprecated these type-casting methods. Use `getGraphNode(<class>)` instead. This is similar to the changes made to
           `GraphNodeFactory` for the same reason.
-            - `getGraphAchivement()`
             - `getGraphAlbum()`
             - `getGraphPage()`
             - `getGraphSessionInfo()`
             - `getGraphUser()`
             - `getGraphEvent()`
             - `getGraphGroup()`
+        - Removed `getGraphAchivement()`
 
 ## 7.x (UNOFFICIAL)
 

src/Facebook/FacebookResponse.php

@@ -24,11 +24,17 @@
 
 namespace Facebook;
 
+use Facebook\GraphNodes\GraphAlbum;
 use Facebook\GraphNodes\GraphEdge;
+use Facebook\GraphNodes\GraphEvent;
+use Facebook\GraphNodes\GraphGroup;
 use Facebook\GraphNodes\GraphNode;
 use Facebook\GraphNodes\GraphNodeFactory;
 use Facebook\Exceptions\FacebookResponseException;
 use Facebook\Exceptions\FacebookSDKException;
+use Facebook\GraphNodes\GraphPage;
+use Facebook\GraphNodes\GraphSessionInfo;
+use Facebook\GraphNodes\GraphUser;
 
 /**
  * Class FacebookResponse
@@ -247,6 +253,90 @@ public function getGraphNode(?string $subclassName = null): GraphNode
         return $factory->makeGraphNode($subclassName);
     }
 
+    /**
+     * Convenience method for creating a GraphAlbum collection.
+     * @throws FacebookSDKException
+     * @deprecated Use getGraphNode(GraphAlbum::class).
+     */
+    public function getGraphAlbum(): GraphAlbum
+    {
+        $factory = new GraphNodeFactory($this);
+
+        /** @var GraphAlbum $album */
+        $album = $factory->makeGraphNode(GraphAlbum::class);
+        return $album;
+    }
+
+    /**
+     * Convenience method for creating a GraphPage collection.
+     * @throws FacebookSDKException
+     * @deprecated Use getGraphNode(GraphPage::class)).
+     */
+    public function getGraphPage(): GraphPage
+    {
+        $factory = new GraphNodeFactory($this);
+
+        /** @var GraphPage $page */
+        $page = $factory->makeGraphNode(GraphPage::class);
+        return $page;
+    }
+
+    /**
+     * Convenience method for creating a GraphSessionInfo collection.
+     * @throws FacebookSDKException
+     * @deprecated Use getGraphNode(GraphSessionInfo::class).
+     */
+    public function getGraphSessionInfo(): GraphSessionInfo
+    {
+        $factory = new GraphNodeFactory($this);
+
+        /** @var GraphSessionInfo $session */
+        $session = $factory->makeGraphNode(GraphSessionInfo::class);
+        return $session;
+    }
+
+    /**
+     * Convenience method for creating a GraphUser collection.
+     * @throws FacebookSDKException
+     * @deprecated Use getGraphNode(GraphUser::class).
+     */
+    public function getGraphUser(): GraphUser
+    {
+        $factory = new GraphNodeFactory($this);
+
+        /** @var GraphUser $user */
+        $user = $factory->makeGraphNode(GraphUser::class);
+        return $user;
+    }
+
+    /**
+     * Convenience method for creating a GraphEvent collection.
+     * @throws FacebookSDKException
+     * @deprecated Use getGraphNode(GraphEvent::class).
+     */
+    public function getGraphEvent(): GraphEvent
+    {
+        $factory = new GraphNodeFactory($this);
+
+        /** @var GraphEvent $event */
+        $event = $factory->makeGraphNode(GraphEvent::class);
+        return $event;
+    }
+
+    /**
+     * Convenience method for creating a GraphGroup collection.
+     * @throws FacebookSDKException
+     * @deprecated Use getGraphNode(GraphGroup::class).
+     */
+    public function getGraphGroup(): GraphGroup
+    {
+        $factory = new GraphNodeFactory($this);
+
+        /** @var GraphGroup $group */
+        $group = $factory->makeGraphNode(GraphGroup::class);
+        return $group;
+    }
+
     /**
      * Instantiate a new GraphEdge from response.
      *