Add challenge endpoint

Author: Moumouls

src/ParseUser.js

@@ -782,6 +782,32 @@ class ParseUser extends ParseObject {
     return user.linkWith(provider, options, saveOpts);
   }
 
+  /**
+   * Ask Parse server for an auth challenge (ex: WebAuthn login/signup)
+   *
+   * @param data
+   * @static
+   * @returns {Promise}
+   */
+  static challenge(data: {
+    authData?: AuthData,
+    username?: string,
+    password?: string,
+    challengeData: any,
+  }): Promise<{ challengeData: any }> {
+    if (!data.challengeData) {
+      return Promise.reject(
+        new ParseError(ParseError.OTHER_CAUSE, 'challengeData is required for the challenge.')
+      );
+    }
+    if (data.username && !data.password) {
+      return Promise.reject(
+        new ParseError(ParseError.OTHER_CAUSE, 'Running challenge via username require password.')
+      );
+    }
+    return CoreManager.getUserController().challenge(data);
+  }
+
   /**
    * Logs out the currently logged in user session. This will remove the
    * session from disk, log out of linked services, and future calls to
@@ -1153,6 +1179,10 @@ const DefaultController = {
     });
   },
 
+  challenge(data: any): Promise<{ challengeData: any }> {
+    return CoreManager.getRESTController().request('POST', 'challenge', data);
+  },
+
   become(user: ParseUser, options: RequestOptions): Promise<ParseUser> {
     const RESTController = CoreManager.getRESTController();
     return RESTController.request('GET', 'users/me', {}, options).then(response => {

src/__tests__/ParseUser-test.js

@@ -1881,4 +1881,49 @@ describe('ParseUser', () => {
     const user = new CustomUser();
     expect(user.test).toBe(true);
   });
+
+  it('should return challenge', async () => {
+    ParseUser.enableUnsafeCurrentUser();
+    ParseUser._clearCache();
+    CoreManager.setRESTController({
+      request(method, path, body) {
+        expect(method).toBe('POST');
+        expect(path).toBe('challenge');
+        expect(body.username).toBe('username');
+        expect(body.password).toBe('password');
+        expect(body.challengeData).toEqual({ test: { data: true } });
+
+        return Promise.resolve(
+          {
+            challengeData: { test: { token: true } },
+          },
+          200
+        );
+      },
+      ajax() {},
+    });
+
+    try {
+      await ParseUser.challenge({
+        username: 'username',
+        challengeData: { test: { data: true } },
+      });
+    } catch (e) {
+      expect(e.message).toContain('Running challenge via username require password.');
+    }
+
+    try {
+      await ParseUser.challenge({});
+    } catch (e) {
+      expect(e.message).toContain('challengeData is required for the challenge.');
+    }
+
+    const res = await ParseUser.challenge({
+      username: 'username',
+      password: 'password',
+      challengeData: { test: { data: true } },
+    });
+
+    expect(res.challengeData).toEqual({ test: { token: true } });
+  });
 });