feat(api): add search topic

Author: sxzz

src/api/topics.ts

@@ -1,4 +1,5 @@
 import { request, toResponse } from '../request'
+import type { LiteralUnion } from '../utils'
 import type { Topics } from '../types/api-responses'
 import type { PaginationOption } from '../types/options'
 
@@ -40,3 +41,29 @@ export const getTabsSelectedFeed = <T = Topics.GetTabsSelectedFeedResponse>(
       },
     })
   )
+
+/**
+ * 搜索圈子
+ * @param keywords 关键词
+ * @param option 选项
+ */
+export const search = <T = Topics.SearchResponse>(
+  keywords: string,
+  option: PaginationOption<{ skip: number }> & {
+    /** 类型 */
+    type?: LiteralUnion<'ALL'>
+    /** 仅用户发帖时为 true */
+    onlyUserPostEnabled?: boolean
+  } = {}
+) =>
+  toResponse<T>(
+    request.post('1.0/users/topics/search', {
+      json: {
+        type: option.type ?? 'ALL',
+        keywords,
+        onlyUserPostEnabled: option.onlyUserPostEnabled,
+        limit: option.limit ?? 20,
+        loadMoreKey: option.loadMoreKey,
+      },
+    })
+  )

src/types/api-responses.ts

@@ -12,6 +12,7 @@ import type {
   SquareFeed,
   Story,
   TabIcons,
+  Topic,
   User,
 } from './entity'
 
@@ -228,4 +229,18 @@ export namespace Topics {
       offset: number
     }
   }
+
+  // 搜索圈子
+  export interface SearchResponse {
+    data: Topic[]
+    count: number
+    loadMoreKey?: {
+      skip: number
+    }
+    highlightWord: {
+      words: string[]
+      singleMaxHighlightTime: number
+      totalMaxHighlightTime: number
+    }
+  }
 }

tests/api/topics.test.ts

@@ -19,4 +19,10 @@ describe('topics should work', () => {
     expect(isSuccess(result)).toBe(true)
     expect(result.data.data.length).toBe(limit)
   })
+
+  it('search should work', async () => {
+    const result = await api.topics.search('好', { limit })
+    expect(isSuccess(result)).toBe(true)
+    expect(result.data.data.length).toBe(limit)
+  })
 })