feat: add follow and unfollow

Author: sxzz

README.md

@@ -29,6 +29,8 @@
 - 用户关系
   - [x] 获取关注列表
   - [x] 获取被关注列表
+  - [x] 关注
+  - [x] 取消关注
 - 动态帖子
   - [x] 发送动态
   - [x] 获取动态详情

src/api/user-relation.ts

@@ -1,6 +1,10 @@
 import { request, toResponse } from '../request'
 import type { UserRelation } from '../types/api-responses'
-import type { PaginationOption } from '../types/options'
+import type {
+  PaginationOption,
+  UserFollowOption,
+  UserUnfollowOption,
+} from '../types/options'
 
 /**
  * 获取关注列表
@@ -39,3 +43,42 @@ export const getFollowerList = <T = UserRelation.GetFollowerListResponse>(
       },
     })
   )
+
+/**
+ * 关注用户
+ * @param username 用户名
+ * @param pageName 页面名称，可选
+ */
+export const follow = <T = UserRelation.FollowResponse>(
+  username: string,
+  { pageName = 11 }: UserFollowOption = {}
+) =>
+  toResponse<T>(
+    request.post('1.0/userRelation/follow', {
+      json: {
+        sourcePageName: pageName,
+        currentPageName: pageName,
+        username,
+      },
+    })
+  )
+
+/**
+ * 取消关注用户
+ * @param username 用户名
+ * @param option 选项，可选
+ */
+export const unfollow = <T = UserRelation.UnfollowResponse>(
+  username: string,
+  { pageName = 49, ref = 'PROFILE_MY_FOLLOWINGS' }: UserUnfollowOption = {}
+) =>
+  toResponse<T>(
+    request.post('1.0/userRelation/unfollow', {
+      json: {
+        currentPageName: pageName,
+        username,
+        ref,
+        sourcePageName: pageName,
+      },
+    })
+  )

src/client/user.ts

@@ -2,6 +2,7 @@ import { isSuccess, throwRequestFailureError } from './utils/response'
 import { fetchPaginated } from './utils/paginate'
 import { JikePostWithDetail } from './post'
 import { rawTypeToEnum } from './utils/post'
+import type { UserUnfollowOption } from '../types/options'
 import type { PostDetail, PostTypeRaw, User } from '../types/entity'
 import type { Users } from '../types/api-responses'
 import type { PaginatedFetcher, PaginatedOption } from './utils/paginate'
@@ -185,4 +186,25 @@ export class JikeUser<M extends boolean = boolean> {
       option
     )
   }
+
+  /**
+   * 关注用户
+   */
+  async follow() {
+    const result = await this.#client.apiClient.userRelation.follow(
+      await this.getUsername()
+    )
+    if (!isSuccess(result)) throwRequestFailureError(result, '关注用户')
+  }
+
+  /**
+   * 取消关注用户
+   */
+  async unfollow(option: UserUnfollowOption = {}) {
+    const result = await this.#client.apiClient.userRelation.unfollow(
+      await this.getUsername(),
+      option
+    )
+    if (!isSuccess(result)) throwRequestFailureError(result, '取消关注用户')
+  }
 }

src/types/api-responses.ts

@@ -1,4 +1,5 @@
 /* eslint-disable @typescript-eslint/no-namespace */
+import type { LiteralUnion } from '../utils/typings'
 import type {
   Comment,
   FollowingUpdate,
@@ -48,6 +49,14 @@ export namespace UserRelation {
       createdAt: string
     }
   }
+
+  export interface FollowResponse {
+    toast: LiteralUnion<'关注成功'>
+  }
+
+  export interface UnfollowResponse {
+    toast: LiteralUnion<'关注已取消'>
+  }
 }
 
 export namespace Users {

src/types/options.ts

@@ -101,3 +101,18 @@ export interface ListRecommendFeedOption
    */
   trigger?: string
 }
+
+/**
+ * @description 关注用户选项
+ */
+export interface UserFollowOption {
+  pageName?: number
+}
+
+/**
+ * @description 取消关注用户选项
+ */
+export interface UserUnfollowOption {
+  pageName?: number
+  ref?: string
+}