implement getPageSubscription

packages/messaging-api-messenger/README.md

@@ -3478,7 +3478,7 @@ Default Fields:
 
 ## `getSubscriptions`
 
-Get the current Webhook subscriptions setted up on your app.
+Get the current Webhook subscriptions set up on your app.
 
 | Param        | Type     | Description       |
 | ------------ | -------- | ----------------- |
@@ -3500,6 +3500,30 @@ client.getSubscriptions({
 });
 ```
 
+## `getPageSubscription`
+
+Get the current page subscriptions set up on your app.
+
+| Param        | Type     | Description       |
+| ------------ | -------- | ----------------- |
+| access_token | `String` | App access token. |
+
+Example:
+
+```js
+client.getPageSubscription({
+  access_token: APP_ACCESS_TOKEN,
+});
+```
+
+Or provide app id and app secret instead of app access token:
+
+```js
+client.getPageSubscription({
+  access_token: `${APP_ID}|${APP_SECRET}`,
+});
+```
+
 <br />
 
 ## `getPageInfo`

packages/messaging-api-messenger/src/MessengerClient.js

@@ -343,10 +343,10 @@ export default class MessengerClient {
     );
 
     const appId = app_id || this._appId;
-    invariant(appId, 'App ID is required to create subscription');
+    invariant(appId, 'App ID is required to get subscriptions');
     invariant(
       this._appSecret || appAccessToken,
-      'App Secret or App Token is required to create subscription'
+      'App Secret or App Token is required to get subscriptions'
     );
 
     const accessToken =
@@ -357,6 +357,44 @@ export default class MessengerClient {
       .then(res => res.data.data, handleError);
   }
 
+  /**
+   * Extract page subscription from subscriptions
+   *
+   * https://developers.facebook.com/docs/graph-api/reference/app/subscriptions
+   */
+  getPageSubscription({
+    app_id,
+    access_token: appAccessToken,
+  }: {
+    app_id?: string,
+    access_token?: string,
+  } = {}): Promise<MessengerSubscription> {
+    warning(
+      !app_id,
+      'Provide App ID in the function is deprecated. Provide it in `MessengerClient.connect({ appId, ... })` instead'
+    );
+
+    const appId = app_id || this._appId;
+    invariant(appId, 'App ID is required to get subscription');
+    invariant(
+      this._appSecret || appAccessToken,
+      'App Secret or App Token is required to get subscription'
+    );
+
+    const accessToken =
+      appAccessToken || `${appId}|${((this._appSecret: any): string)}`;
+
+    return this.getSubscriptions({
+      app_id: appId,
+      access_token: accessToken,
+    }).then(
+      subscriptions =>
+        subscriptions.filter(
+          subscription => subscription.object === 'page'
+        )[0] || null
+    );
+  }
+
   /**
    *  Messaging Feature Review API
    *

packages/messaging-api-messenger/src/__tests__/MessengerClient.spec.js

@@ -148,7 +148,7 @@ describe('subscription', () => {
   });
 
   describe('#getSubscriptions', () => {
-    it('should set other optional parameters', async () => {
+    it('should get current subscriptions', async () => {
       const { client, mock } = createMock();
       const reply = {
         data: [
@@ -186,6 +186,55 @@ describe('subscription', () => {
       ]);
     });
   });
+
+  describe('#getPageSubscription', () => {
+    it('should get current page subscription', async () => {
+      const { client, mock } = createMock();
+      const reply = {
+        data: [
+          {
+            object: 'page',
+            callback_url: 'https://mycallback.com',
+            active: true,
+            fields: [
+              {
+                name: 'messages',
+                version: 'v2.12',
+              },
+            ],
+          },
+          {
+            object: 'user',
+            callback_url: 'https://mycallback.com',
+            active: true,
+            fields: [
+              {
+                name: 'feed',
+                version: 'v2.12',
+              },
+            ],
+          },
+        ],
+      };
+
+      mock
+        .onGet(`/${APP_ID}/subscriptions?access_token=${APP_ID}|${APP_SECRET}`)
+        .reply(200, reply);
+
+      const res = await client.getPageSubscription();
+      expect(res).toEqual({
+        object: 'page',
+        callback_url: 'https://mycallback.com',
+        active: true,
+        fields: [
+          {
+            name: 'messages',
+            version: 'v2.12',
+          },
+        ],
+      });
+    });
+  });
 });
 
 describe('#getMessagingFeatureReview', () => {