add community and searchCommunities endpoints (#561)

Author: enszrlu

src/types/v2/community.v2.types.ts

@@ -0,0 +1,34 @@
+export interface CommunityV2 {
+  id: string;
+  name: string;
+  created_at: string;
+}
+
+export interface CommunityErrorV2 {
+    title: string;
+    type: string;
+    detail?: string;
+    status?: number;
+}
+
+export interface CommunityV2Result {
+  data: CommunityV2;
+  errors?: CommunityErrorV2[];
+}
+
+export interface CommunitiesV2Result {
+  data: CommunityV2[];
+  errors?: CommunityErrorV2[];
+  meta: {next_token?: string};
+}
+
+export interface CommunityByIDV2Params {
+  id: string;
+}
+
+export interface CommunitySearchV2Params {
+  query: string;
+  max_results?: number;
+  next_token?: string;
+  pagination_token?: string;
+} 

src/types/v2/index.ts

@@ -4,3 +4,4 @@ export * from './tweet.definition.v2';
 export * from './user.v2.types';
 export * from './spaces.v2.types';
 export * from './list.v2.types';
+export * from './community.v2.types';

src/v2/client.v2.read.ts

@@ -56,6 +56,10 @@ import {
   TweetV2HomeTimelineResult,
   TweetUsageV2Params,
   TweetV2UsageResult,
+  CommunityV2Result,
+  CommunitiesV2Result,
+  CommunityByIDV2Params,
+  CommunitySearchV2Params,
 } from '../types';
 import {
   TweetSearchAllV2Paginator,
@@ -875,4 +879,20 @@ export default class TwitterApiv2ReadOnly extends TwitterApiSubClient {
   public async usage(options: Partial<TweetUsageV2Params> = {}) {
     return this.get<TweetV2UsageResult>('usage/tweets', options);
   }
+
+  /**
+   * Returns a variety of information about a single Community specified by ID.
+   * https://docs.x.com/x-api/communities/communities-lookup-by-community-id
+   */
+  public community(communityId: string, options: Partial<CommunityByIDV2Params> = {}) {
+    return this.get<CommunityV2Result>('communities/:id', options, { params: { id: communityId } });
+  }
+
+  /**
+   * Search for Communities based on keywords.
+   * https://docs.x.com/x-api/communities/search-communities
+   */
+  public searchCommunities(query: string, options: Partial<CommunitySearchV2Params> = {}) {
+    return this.get<CommunitiesV2Result>('communities/search', { query, ...options });
+  }
 }