sidechat.js 2.6.5 → 2.7.0

package/src/classes/SidechatAPIClient.js

@@ -67,6 +67,16 @@ class SidechatAPIClient {
     this.apiRoot = url;
   };
 
+  /**
+   * Set an identifier for this device, which will be sent with every request in the `X-Device-ID` header.  Should be stable across sessions on the same device.
+   * @method
+   * @param {String} deviceIdentifier - stable identifier for this device
+   * @since 2.7.0
+   */
+  setDeviceIdentifier = (deviceIdentifier) => {
+    this.defaultHeaders["X-Device-ID"] = deviceIdentifier;
+  };
+
   /**
    * Run an arbitrary API request using the current client's authentication
    * @method
@@ -82,7 +92,7 @@ class SidechatAPIClient {
     method = "GET",
     body = undefined,
     headers = {},
-    stripHeaders = false
+    stripHeaders = false,
   ) => {
     let requestHeaders = this.defaultHeaders;
     if (stripHeaders) {
@@ -97,19 +107,32 @@ class SidechatAPIClient {
   };
 
   /**
-   * Initiate the login process with a phone number.  Should be followed up with verifySMSCode().
+   * Initiate the login process with a phone number.  Should be followed up with verifySMSCode().  If the response has an `error_code` of `"captcha_required"`, the server wants a captcha solved before it will send a code, and the request should be repeated with a captcha response.  I haven't been able to recreate this yet, so I honestly don't know what captcha provider they want.
    * @method
    * @since 1.0.0
    * @param {Number} phoneNumber - US phone number (WITHOUT +1) to send verification code to
+   * @param {Boolean} [useFallback] - send the code through the backup SMS route, which the official app offers when a code doesn't arrive
+   * @param {String} [captchaMethod] - type of captcha being answered
+   * @param {String} [captchaResponse] - solved captcha token
    */
-  loginViaSMS = async (phoneNumber) => {
+  loginViaSMS = async (
+    phoneNumber,
+    useFallback = false,
+    captchaMethod = undefined,
+    captchaResponse = undefined,
+  ) => {
     try {
-      const res = await fetch(`${this.apiRoot}/v1/login_register`, {
+      const endpoint = useFallback
+        ? "/v1/login_register_sms_fallback"
+        : "/v1/login_register";
+      const res = await fetch(`${this.apiRoot}${endpoint}`, {
         method: "POST",
         headers: this.defaultHeaders,
         body: JSON.stringify({
           phone_number: `+1${phoneNumber}`,
           version: 3,
+          captcha_method: captchaMethod,
+          captcha_response: captchaResponse,
         }),
       });
       const json = await res.json();
@@ -154,8 +177,15 @@ class SidechatAPIClient {
    * @since 1.0.0
    * @param {Number} age - user's age in years
    * @param {String} registrationID  - the registration ID generated by verifySMSCode()
+   * @param {String} [timeZone] - time zone of the user (e.g. "America/Chicago").  Falls back to the system time zone.
+   * @param {String} [inviteLinkURL] - group invite link that the user signed up through
    */
-  setAge = async (age, registrationID) => {
+  setAge = async (
+    age,
+    registrationID,
+    timeZone = Intl.DateTimeFormat().resolvedOptions().timeZone,
+    inviteLinkURL = undefined,
+  ) => {
     if (age < 13) {
       throw new SidechatAPIError("You're too young to use Offsides.");
     }
@@ -166,6 +196,9 @@ class SidechatAPIClient {
         body: JSON.stringify({
           age: Number(age),
           registration_id: registrationID,
+          time_zone: timeZone,
+          invite_link_url: inviteLinkURL,
+          device_id: this.defaultHeaders["X-Device-ID"],
         }),
       });
       const json = await res.json();
@@ -248,8 +281,9 @@ class SidechatAPIClient {
    * @method
    * @since 1.0.0
    * @param {String} deviceId - the device ID to set
+   * @param {"com.flowerave.sidechat"|"com.flowerave.yikyak"} [bundleID] - bundle ID of the app the push token belongs to
    */
-  setDeviceID = async (deviceID) => {
+  setDeviceID = async (deviceID, bundleID = "com.flowerave.sidechat") => {
     if (!this.userToken) {
       throw new SidechatAPIError("User is not authenticated.");
     }
@@ -262,7 +296,7 @@ class SidechatAPIClient {
         },
         body: JSON.stringify({
           build_type: "release",
-          bundle_id: "com.flowerave.sidechat",
+          bundle_id: bundleID,
           device_token: deviceID,
         }),
       });
@@ -305,7 +339,7 @@ class SidechatAPIClient {
             ...this.defaultHeaders,
             Authorization: `Bearer ${this.userToken}`,
           },
-        }
+        },
       );
       const json = await res.json();
       return json;
@@ -322,23 +356,27 @@ class SidechatAPIClient {
    * @param {String} groupID - group ID
    * @param {"hot"|"recent"|"top"} category - category to filter posts
    * @param {types.SidechatCursorString} [cursor] - cursor string
+   * @param {"day"|"week"|"month"|"year"|"all_time"} [period] - time period to pull top posts from (only if category is "top")
    * @returns {Promise<types.SidechatPostsAndCursor>} List of posts and cursor
    */
-  getGroupPosts = async (groupID, category = "hot", cursor) => {
+  getGroupPosts = async (groupID, category = "hot", cursor, period) => {
     if (!this.userToken) {
       throw new SidechatAPIError("User is not authenticated.");
     }
     try {
       const res = await fetch(
-        `${this.apiRoot}/v1/posts?${cursor ? "cursor=" + encodeURIComponent(cursor) + "&" : ""
-        }group_id=${groupID}&type=${category}`,
+        `${this.apiRoot}/v1/posts?${
+          cursor ? "cursor=" + encodeURIComponent(cursor) + "&" : ""
+        }${
+          period ? "period=" + period + "&" : ""
+        }group_id=${groupID}&type=${category}&cacheBust=${Date.now()}`,
         {
           method: "GET",
           headers: {
             ...this.defaultHeaders,
             Authorization: `Bearer ${this.userToken}`,
           },
-        }
+        },
       );
       const json = await res.json();
       return json;
@@ -393,14 +431,14 @@ class SidechatAPIClient {
     }
     try {
       const res = await fetch(
-        `${this.apiRoot}/v1/posts/get?include_deleted=${includeDeleted}&post_id=${postID}`,
+        `${this.apiRoot}/v1/posts/get?include_deleted=${includeDeleted}&post_id=${postID}&cacheBust=${Date.now()}`,
         {
           method: "GET",
           headers: {
             ...this.defaultHeaders,
             Authorization: `Bearer ${this.userToken}`,
           },
-        }
+        },
       );
       const json = await res.json();
       return json.post;
@@ -427,7 +465,7 @@ class SidechatAPIClient {
       contentType = "my_comments";
     }
     try {
-      const res = await fetch(`${this.apiRoot}/v1/posts&type=${contentType}`, {
+      const res = await fetch(`${this.apiRoot}/v1/posts?type=${contentType}`, {
         method: "GET",
         headers: {
           ...this.defaultHeaders,
@@ -455,14 +493,14 @@ class SidechatAPIClient {
     }
     try {
       const res = await fetch(
-        `${this.apiRoot}/v1/posts/comments/?post_id=${postID}`,
+        `${this.apiRoot}/v1/posts/comments/?post_id=${postID}&cacheBust=${Date.now()}`,
         {
           method: "GET",
           headers: {
             ...this.defaultHeaders,
             Authorization: `Bearer ${this.userToken}`,
           },
-        }
+        },
       );
       const json = await res.json();
       // Function to preprocess the comments and organize them into a nested structure
@@ -558,13 +596,16 @@ class SidechatAPIClient {
       throw new SidechatAPIError("User is not authenticated.");
     }
     try {
-      const res = await fetch(`${this.apiRoot}/v1/groups/explore/search?term=${encodeURIComponent(query)}`, {
-        method: "GET",
-        headers: {
-          ...this.defaultHeaders,
-          Authorization: `Bearer ${this.userToken}`,
+      const res = await fetch(
+        `${this.apiRoot}/v1/groups/explore/search?term=${encodeURIComponent(query)}`,
+        {
+          method: "GET",
+          headers: {
+            ...this.defaultHeaders,
+            Authorization: `Bearer ${this.userToken}`,
+          },
         },
-      });
+      );
       const json = await res.json();
       return await json.results;
     } catch (err) {
@@ -664,8 +705,9 @@ class SidechatAPIClient {
       throw new SidechatAPIError("User is not authenticated.");
     }
     try {
+      // Joining moved to the v2 endpoint, which takes a list of IDs.  Leave still sends group_id by itself, no list.
       const res = await fetch(
-        `${this.apiRoot}/v1/groups/${isMember ? "join" : "leave"}`,
+        `${this.apiRoot}${isMember ? "/v2/groups/join" : "/v1/groups/leave"}`,
         {
           method: "POST",
           headers: {
@@ -673,9 +715,10 @@ class SidechatAPIClient {
             Authorization: `Bearer ${this.userToken}`,
           },
           body: JSON.stringify({
-            group_id: groupID,
+            group_id: isMember ? undefined : groupID,
+            group_ids: [groupID],
           }),
-        }
+        },
       );
       const json = await res.json();
       return await json;
@@ -707,7 +750,7 @@ class SidechatAPIClient {
     topLevelReplyID,
     assetList = [],
     disableDMs = false,
-    anonymous = false
+    anonymous = false,
   ) => {
     if (!this.userToken) {
       throw new SidechatAPIError("User is not authenticated.");
@@ -732,15 +775,17 @@ class SidechatAPIClient {
         }),
       });
       const json = await res.json();
+      if (!res.ok) throw new SidechatAPIError(json.message);
       return await json.comment;
     } catch (err) {
       console.error(err);
+      if (err instanceof SidechatAPIError && err.message) throw err;
       throw new SidechatAPIError(`Failed to post comment.`);
     }
   };
 
   /**
-   * Creates a new post in the specified group
+   * Creates a new post in the specified group.  Users can only make two posts a minute; if a post is rejected, the thrown error contains the reason from the server.
    * @method
    * @since 2.2.0
    * @param {String} text - text content of comment
@@ -750,6 +795,7 @@ class SidechatAPIClient {
    * @param {Boolean} [disableComments] - whether or not comments should be disabled on post
    * @param {Boolean} [anonymous] - whether or not to hide user's name and icon on post
    * @param {Array<String>} [pollOptions] - List of poll options.  If provided, a poll will be created with these options.
+   * @param {Array<String>} [attachmentIDs] - IDs of link attachments created with createLinkAttachment()
    * @returns {Promise<types.SidechatPostOrComment>} the created post
    */
   createPost = async (
@@ -760,7 +806,8 @@ class SidechatAPIClient {
     disableComments = false,
     anonymous = false,
     repostId = undefined,
-    pollOptions = undefined
+    pollOptions = undefined,
+    attachmentIDs = [],
   ) => {
     if (!this.userToken) {
       throw new SidechatAPIError("User is not authenticated.");
@@ -772,17 +819,17 @@ class SidechatAPIClient {
         assets: assetList,
         group_ids: [groupID],
         text: text,
-        attachments: [],
+        attachments: attachmentIDs,
         dms_disabled: disableDMs,
         comments_disabled: disableComments,
         using_identity: !anonymous,
-        quote_post_id: repostId
+        quote_post_id: repostId,
       };
       // If pollOptions is provided and is a non-empty array, add poll_request
       if (Array.isArray(pollOptions) && pollOptions.length > 0) {
         body.poll_request = {
           allows_view_results: true,
-          choices: pollOptions
+          choices: pollOptions,
         };
       }
       const res = await fetch(`${this.apiRoot}/v1/posts`, {
@@ -794,9 +841,11 @@ class SidechatAPIClient {
         body: JSON.stringify(body),
       });
       const json = await res.json();
+      if (!res.ok) throw new SidechatAPIError(json.message);
       return await json.posts[0];
     } catch (err) {
       console.error(err);
+      if (err instanceof SidechatAPIError && err.message) throw err;
       throw new SidechatAPIError(`Failed to make post.`);
     }
   };
@@ -872,16 +921,19 @@ class SidechatAPIClient {
       throw new SidechatAPIError("User is not authenticated.");
     }
     try {
-      const res = await fetch(`${this.apiRoot}/v1/polls/view_results`, {
-        method: "POST",
-        headers: {
-          ...this.defaultHeaders,
-          Authorization: `Bearer ${this.userToken}`,
+      const res = await fetch(
+        `${this.apiRoot}/v1/polls/view_results?cacheBust=${Date.now()}`,
+        {
+          method: "POST",
+          headers: {
+            ...this.defaultHeaders,
+            Authorization: `Bearer ${this.userToken}`,
+          },
+          body: JSON.stringify({
+            poll_id: pollId,
+          }),
         },
-        body: JSON.stringify({
-          poll_id: pollId,
-        }),
-      });
+      );
       const json = await res.json();
       return await json;
     } catch (err) {
@@ -891,22 +943,27 @@ class SidechatAPIClient {
   };
 
   /**
-   * Uploads an asset to AWS S3 for use in posts and comments.  Currently photos only
+   * Uploads an asset to AWS S3 for use in posts and comments.  Supports images and videos (videos must be under 50MB and are processed after upload)
    * @method
    * @param {String} uri - URI of the asset to upload
-   * @param {String} mimeType - mimetype of the asset (e.g. "image/png")
+   * @param {String} mimeType - mimetype of the asset (e.g. "image/png" or "video/mp4")
    * @param {String} [name] - filename of the asset
+   * @param {"post"|"post_vod_source"|"chat"|"chat_icon"|"group_icon"|"profile_picture_icon"} [context] - where the asset will be used.  Videos default to "post_vod_source", which is required for them to be processed into a playable stream.
    * @returns {Promise<String>} URL of the uploaded asset
    * @since 2.5.1
    */
-  uploadAsset = async (uri, mimeType, name = "") => {
+  uploadAsset = async (uri, mimeType, name = "", context = undefined) => {
     if (!this.userToken) {
       throw new SidechatAPIError("User is not authenticated.");
     }
 
     let imageType = mimeType.split("/")[1];
-    if (!["png", "jpeg", "gif"].includes(imageType)) {
-      throw new SidechatAPIError("Unsupported image format.");
+    if (imageType == "quicktime") imageType = "mov";
+    if (!["png", "jpeg", "gif", "webp", "mp4", "mov"].includes(imageType)) {
+      throw new SidechatAPIError("Unsupported file format.");
+    }
+    if (!context && ["mp4", "mov"].includes(imageType)) {
+      context = "post_vod_source";
     }
 
     const data = new FormData();
@@ -916,7 +973,11 @@ class SidechatAPIClient {
       uri: uri,
     });
 
-    const urlReq = await this.sendRequest(`/v1/assets/upload_url?content_type=${imageType}`);
+    const urlReq = await this.sendRequest(
+      `/v1/assets/upload_url?content_type=${imageType}${
+        context ? "&context=" + context : ""
+      }`,
+    );
     const urlJson = await urlReq.json();
 
     try {
@@ -931,7 +992,7 @@ class SidechatAPIClient {
         return `${this.apiRoot}/v1/assets/library/${urlJson.asset_id}`;
       } else {
         throw new SidechatAPIError(
-          `Couldn't upload image - error ${uploadReq.status}`
+          `Couldn't upload image - error ${uploadReq.status}`,
         );
       }
     } catch (e) {
@@ -997,7 +1058,7 @@ class SidechatAPIClient {
           Authorization: `Bearer ${this.userToken}`,
         },
         body: JSON.stringify({
-          bio: bio
+          bio: bio,
         }),
       });
       const json = await res.json();
@@ -1028,7 +1089,7 @@ class SidechatAPIClient {
             ...this.defaultHeaders,
             Authorization: `Bearer ${this.userToken}`,
           },
-        }
+        },
       );
       if (res?.status == 200 || res?.status == 204) {
         return true;
@@ -1083,13 +1144,16 @@ class SidechatAPIClient {
       throw new SidechatAPIError("User is not authenticated.");
     }
     try {
-      const res = await fetch(`${this.apiRoot}/v1/groups/username?username=${username}`, {
-        method: "GET",
-        headers: {
-          ...this.defaultHeaders,
-          Authorization: `Bearer ${this.userToken}`,
-        }
-      });
+      const res = await fetch(
+        `${this.apiRoot}/v1/groups/username?username=${username}&cacheBust=${Date.now()}`,
+        {
+          method: "GET",
+          headers: {
+            ...this.defaultHeaders,
+            Authorization: `Bearer ${this.userToken}`,
+          },
+        },
+      );
       const json = await res.json();
       return await json.group;
     } catch (err) {
@@ -1110,13 +1174,16 @@ class SidechatAPIClient {
       throw new SidechatAPIError("User is not authenticated.");
     }
     try {
-      const res = await fetch(`${this.apiRoot}/v1/users/posts?username=${username}`, {
-        method: "GET",
-        headers: {
-          ...this.defaultHeaders,
-          Authorization: `Bearer ${this.userToken}`,
-        }
-      });
+      const res = await fetch(
+        `${this.apiRoot}/v1/users/posts?username=${username}`,
+        {
+          method: "GET",
+          headers: {
+            ...this.defaultHeaders,
+            Authorization: `Bearer ${this.userToken}`,
+          },
+        },
+      );
       const json = await res.json();
       return await json.posts;
     } catch (err) {
@@ -1164,13 +1231,16 @@ class SidechatAPIClient {
       throw new SidechatAPIError("User is not authenticated.");
     }
     try {
-      const res = await fetch(`${this.apiRoot}/v1/chats/explore`, {
-        method: "GET",
-        headers: {
-          ...this.defaultHeaders,
-          Authorization: `Bearer ${this.userToken}`,
+      const res = await fetch(
+        `${this.apiRoot}/v1/chats/explore?cacheBust=${Date.now()}`,
+        {
+          method: "GET",
+          headers: {
+            ...this.defaultHeaders,
+            Authorization: `Bearer ${this.userToken}`,
+          },
         },
-      });
+      );
       const json = await res.json();
       return await json.chats;
     } catch (err) {
@@ -1194,7 +1264,7 @@ class SidechatAPIClient {
     displayName,
     emoji,
     primaryColor,
-    secondaryColor
+    secondaryColor,
   ) => {
     if (!this.userToken) {
       throw new SidechatAPIError("User is not authenticated.");
@@ -1227,21 +1297,27 @@ class SidechatAPIClient {
   /**
    * Gets a list of the user's direct messages
    * @method
+   * @param {types.SidechatCursorString} [cursor] - cursor string
    * @returns {Promise<types.SidechatDirectThread[]>}
    * @since 2.4.4
    */
-  getDMs = async () => {
+  getDMs = async (cursor) => {
     if (!this.userToken) {
       throw new SidechatAPIError("User is not authenticated.");
     }
     try {
-      const res = await fetch(`${this.apiRoot}/v1/chats`, {
-        method: "GET",
-        headers: {
-          ...this.defaultHeaders,
-          Authorization: `Bearer ${this.userToken}`,
+      const res = await fetch(
+        `${this.apiRoot}/v1/chats${
+          cursor ? "?cursor=" + encodeURIComponent(cursor) : ""
+        }`,
+        {
+          method: "GET",
+          headers: {
+            ...this.defaultHeaders,
+            Authorization: `Bearer ${this.userToken}`,
+          },
         },
-      });
+      );
       const json = await res.json();
       const list = await json.chats;
       let r = [];
@@ -1275,7 +1351,7 @@ class SidechatAPIClient {
             ...this.defaultHeaders,
             Authorization: `Bearer ${this.userToken}`,
           },
-        }
+        },
       );
       const json = await res.json();
       return await json.chat;
@@ -1337,7 +1413,7 @@ class SidechatAPIClient {
     clientID,
     postID,
     anonymous = false,
-    postContext = "feed"
+    postContext = "feed",
   ) => {
     if (!this.userToken) {
       throw new SidechatAPIError("User is not authenticated.");
@@ -1370,6 +1446,7 @@ class SidechatAPIClient {
    * @method
    * @param {String} postID - alphanumeric ID of post to hide
    * @since 2.6.2
+   * @deprecated since 2.7.0.  Please use `blockUser` instead!
    */
   hidePostsFromUser = async (postID) => {
     if (!this.userToken) {
@@ -1385,7 +1462,7 @@ class SidechatAPIClient {
         body: JSON.stringify({
           post_id: postID,
           post_context: "feed",
-          report: false
+          report: false,
         }),
       });
       const json = await res.json();
@@ -1400,6 +1477,7 @@ class SidechatAPIClient {
    * Unhides all posts from all users
    * @method
    * @since 2.6.2
+   * @deprecated since 2.7.0.  No longer used by the official app and may stop working.
    */
   unhidePostsFromAllUsers = async () => {
     if (!this.userToken) {
@@ -1421,6 +1499,396 @@ class SidechatAPIClient {
       throw new SidechatAPIError(`Failed to unhide post.`);
     }
   };
+
+  /**
+   * Fetches the home feed, which mixes posts from all of the user's groups
+   * @method
+   * @param {"for_you"|"hot"|"recent"} [type] - how the feed should be sorted
+   * @param {String} [schoolGroupID] - alphanumeric ID of the user's school group
+   * @param {types.SidechatCursorString} [cursor] - cursor string
+   * @returns {Promise<types.SidechatFeed>} feed items and cursor
+   * @since 2.7.0
+   */
+  getHomeFeed = async (type = "for_you", schoolGroupID, cursor) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const params = new URLSearchParams({ type: type });
+      if (schoolGroupID) params.set("school_group_id", schoolGroupID);
+      if (cursor) params.set("cursor", cursor);
+      const res = await this.sendRequest(`/v1/posts/home?${params}`);
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to get home feed.`);
+    }
+  };
+
+  /**
+   * Follows or unfollows a post.  Followed posts send activity notifications when they get new comments.
+   * @method
+   * @param {String} postID - alphanumeric ID of post
+   * @param {Boolean} following - whether or not the user should follow the post
+   * @returns {Promise<{post: types.SidechatPostOrComment}>} the updated post
+   * @since 2.7.0
+   */
+  setPostFollowing = async (postID, following) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        `/v1/posts/${following ? "follow" : "unfollow"}`,
+        "POST",
+        JSON.stringify({ post_id: postID }),
+      );
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to change post follow status.`);
+    }
+  };
+
+  /**
+   * Reports a post or comment to the group's moderators
+   * @method
+   * @param {String} postID - alphanumeric ID of post or comment to report
+   * @param {types.SidechatReportReason} reason - why the content is being reported
+   * @param {String} [note] - explanation to send along with the report
+   * @since 2.7.0
+   */
+  flagPost = async (postID, reason, note = undefined) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        "/v1/posts/flag",
+        "POST",
+        JSON.stringify({ post_id: postID, reason: reason, note: note }),
+      );
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to report post.`);
+    }
+  };
+
+  /**
+   * Blocks the author of a post or comment, hiding all of their content from the user.  Replaces `hidePostsFromUser`.
+   * @method
+   * @param {String} postID - alphanumeric ID of a post or comment by the user to block
+   * @param {Boolean} [report] - whether or not to also report the content
+   * @param {"feed"|"chat"} [postContext] - where the content was seen
+   * @since 2.7.0
+   */
+  blockUser = async (postID, report = false, postContext = "feed") => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        "/v1/posts/block_user",
+        "POST",
+        JSON.stringify({
+          post_id: postID,
+          post_context: postContext,
+          report: report,
+        }),
+      );
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to block user.`);
+    }
+  };
+
+  /**
+   * Creates a link attachment that can be added to a post with createPost().  YouTube links are recognized and shown as embedded videos.
+   * @method
+   * @param {String} url - URL to attach
+   * @returns {Promise<types.SidechatAttachment>} the created attachment
+   * @since 2.7.0
+   */
+  createLinkAttachment = async (url) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        "/v1/attachments/upload_link",
+        "POST",
+        JSON.stringify({ link_url: url }),
+      );
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to create link attachment.`);
+    }
+  };
+
+  /**
+   * Gets the user's activity feed (notifications for comments, votes, followers, etc.)
+   * @method
+   * @param {types.SidechatCursorString} [cursor] - cursor string
+   * @returns {Promise<types.SidechatActivityList>} activity items and cursor
+   * @since 2.7.0
+   */
+  getActivity = async (cursor) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        `/v1/activity${cursor ? "?cursor=" + encodeURIComponent(cursor) : ""}`,
+      );
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to get activity.`);
+    }
+  };
+
+  /**
+   * Gets the groups the user is a member of
+   * @method
+   * @returns {Promise<types.SidechatGroup[]>}
+   * @since 2.7.0
+   */
+  getGroups = async () => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest("/v1/groups");
+      const json = await res.json();
+      return json.groups;
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to get groups.`);
+    }
+  };
+
+  /**
+   * Gets groups suggested for the user to join
+   * @method
+   * @param {Number} [limit] - maximum number of groups to return
+   * @returns {Promise<types.SidechatGroup[]>}
+   * @since 2.7.0
+   */
+  getSuggestedGroups = async (limit = 10) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        `/v1/groups/suggestions?limit=${limit}`,
+      );
+      const json = await res.json();
+      return json.groups;
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to get suggested groups.`);
+    }
+  };
+
+  /**
+   * Gets a shareable invite link for a group.  School groups don't have invite links and will throw an error.
+   * @method
+   * @param {String} groupID - alphanumeric ID of group
+   * @returns {Promise<String>} invite link URL
+   * @since 2.7.0
+   */
+  getGroupInviteLink = async (groupID) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        `/v1/groups/invite_link?group_id=${groupID}`,
+      );
+      const json = await res.json();
+      return json.link;
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to get invite link.`);
+    }
+  };
+
+  /**
+   * Gets the yakarma leaderboard for a group, along with the user's own karma
+   * @method
+   * @param {String} groupID - alphanumeric ID of group
+   * @returns {Promise<types.SidechatLeaderboard>}
+   * @since 2.7.0
+   */
+  getLeaderboard = async (groupID) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(`/v1/leaderboard?group_id=${groupID}`);
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to get leaderboard.`);
+    }
+  };
+
+  /**
+   * Gets the existing direct message thread for a post or comment.  Returns undefined if the user hasn't started one.
+   * @method
+   * @param {String} postID - alphanumeric ID of post or comment
+   * @returns {Promise<types.SidechatDirectThread>}
+   * @since 2.7.0
+   */
+  getDMForPost = async (postID) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(`/v1/chats/by_post?post_id=${postID}`);
+      const json = await res.json();
+      return json.chat;
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to get DM thread for post.`);
+    }
+  };
+
+  /**
+   * Reports a direct message thread
+   * @method
+   * @param {String} chatID - alphanumeric ID of the thread to report
+   * @param {types.SidechatReportReason} reason - why the thread is being reported
+   * @since 2.7.0
+   */
+  reportDM = async (chatID, reason) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        "/v1/chats/report",
+        "POST",
+        JSON.stringify({ chat_id: chatID, reason: reason }),
+      );
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to report DM.`);
+    }
+  };
+
+  /**
+   * Sets which push notifications the user receives
+   * @method
+   * @param {types.SidechatNotificationPreferences} preferences - notification types to enable or disable
+   * @since 2.7.0
+   */
+  setNotificationPreferences = async (preferences) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        "/v1/users/set_notification_preferences",
+        "POST",
+        JSON.stringify({ notification_preferences: preferences }),
+      );
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to set notification preferences.`);
+    }
+  };
+
+  /**
+   * Verifies the user's school email by signing in with Google or Microsoft instead of clicking an emailed link.  Returns the same object as checkEmailVerification().  This was discovered from me decompiling the new Android app, I haven't tested this but based on the implementation it should work fine and might resolve the problem that a lot of people have with their accounts not being associated with their school automatically.
+   * @method
+   * @param {String} authToken - token from the Google or Microsoft sign-in
+   * @param {"google"|"microsoft"} authType - provider the token came from
+   * @param {Boolean} [isIncomingFreshman] - whether or not the user is an incoming freshman
+   * @since 2.7.0
+   * @tutorial Email Registration
+   */
+  verifyEmailWithThirdParty = async (
+    authToken,
+    authType,
+    isIncomingFreshman = false,
+  ) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        "/v1/users/third_party_email_verified",
+        "POST",
+        JSON.stringify({
+          auth: authToken,
+          auth_type: authType,
+          is_incoming_freshman: isIncomingFreshman,
+        }),
+      );
+      const json = await res.json();
+      if (json.verified_email_updates_response) {
+        return json.verified_email_updates_response;
+      } else {
+        throw new SidechatAPIError(json?.message || "Email is not verified.");
+      }
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError("Failed to verify email.");
+    }
+  };
+
+  /**
+   * Authorizes a realtime (Pusher) connection to subscribe to a private channel, such as `private-chat-<chatID>` for live direct messages.  Pass the result to your Pusher client's channel authorizer.  This hasn't been tested, and is mostly theoretical.
+   * @method
+   * @param {String} socketID - socket ID assigned by Pusher
+   * @param {String} channelName - name of the private channel to subscribe to
+   * @returns {Promise<{auth: String}>} signed channel authorization
+   * @since 2.7.0
+   */
+  authorizeRealtimeChannel = async (socketID, channelName) => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        "/pusher/auth",
+        "POST",
+        JSON.stringify({ socket_id: socketID, channel_name: channelName }),
+      );
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to authorize realtime channel.`);
+    }
+  };
+
+  /**
+   * Permanently deletes the current user's account.  This cannot be undone!
+   * @method
+   * @since 2.7.0
+   */
+  deleteAccount = async () => {
+    if (!this.userToken) {
+      throw new SidechatAPIError("User is not authenticated.");
+    }
+    try {
+      const res = await this.sendRequest(
+        "/v1/users/delete",
+        "POST",
+        JSON.stringify({}),
+      );
+      return await res.json();
+    } catch (err) {
+      console.error(err);
+      throw new SidechatAPIError(`Failed to delete account.`);
+    }
+  };
 }
 
 export default SidechatAPIClient;