feat: new endpoint for restoring soft deleted activity (#221)

🎫 Ticket: https://linear.app/stream/issue/XYZ-123

📑 Docs: https://github.com/GetStream/docs-content/pull/<id>

### 💡 Overview

### 📝 Implementation notes


<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

* **New Features**
* Added event handling for restored activities in the feed system,
enabling proper recognition and processing of restoration events.

* **Style**
* Code formatting and structure improvements applied for enhanced
consistency.

<sub>✏️ Tip: You can customize this high-level summary in your review
settings.</sub>

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Zita Szupera <szuperaz@gmail.com>

Author: dzoke

packages/feeds-client/src/feed/feed.ts

@@ -219,6 +219,7 @@ export class Feed extends FeedApi {
     'user.reactivated': Feed.noop,
     'user.updated': Feed.noop,
     'feeds.activity.feedback': handleActivityFeedback.bind(this),
+    'feeds.activity.restored': Feed.noop,
   };
 
   protected eventDispatcher: EventDispatcher<WSEvent['type'], WSEvent> =
@@ -872,7 +873,13 @@ export class Feed extends FeedApi {
     return response;
   }
 
-  async unfollow(feedOrFid: Feed | string, options?: Omit<Parameters<typeof this.client.unfollow>[0], 'source' | 'target'>) {
+  async unfollow(
+    feedOrFid: Feed | string,
+    options?: Omit<
+      Parameters<typeof this.client.unfollow>[0],
+      'source' | 'target'
+    >,
+  ) {
     const fid = typeof feedOrFid === 'string' ? feedOrFid : feedOrFid.feed;
 
     const response = await this.client.unfollow({

packages/feeds-client/src/gen/feeds/FeedsApi.ts

@@ -99,6 +99,8 @@ import type {
   RejectFollowRequest,
   RejectFollowResponse,
   Response,
+  RestoreActivityRequest,
+  RestoreActivityResponse,
   SharedLocationResponse,
   SharedLocationsResponse,
   SingleFollowResponse,
@@ -783,6 +785,30 @@ export class FeedsApi {
     return { ...response.body, metadata: response.metadata };
   }
 
+  async restoreActivity(
+    request: RestoreActivityRequest & { id: string },
+  ): Promise<StreamResponse<RestoreActivityResponse>> {
+    const pathParams = {
+      id: request?.id,
+    };
+    const body = {};
+
+    const response = await this.apiClient.sendRequest<
+      StreamResponse<RestoreActivityResponse>
+    >(
+      'PUT',
+      '/api/v2/feeds/activities/{id}/restore',
+      pathParams,
+      undefined,
+      body,
+      'application/json',
+    );
+
+    decoders.RestoreActivityResponse?.(response.body);
+
+    return { ...response.body, metadata: response.metadata };
+  }
+
   async queryBookmarkFolders(
     request?: QueryBookmarkFoldersRequest,
   ): Promise<StreamResponse<QueryBookmarkFoldersResponse>> {

packages/feeds-client/src/gen/model-decoders/decoders.ts

@@ -212,6 +212,17 @@ decoders.ActivityResponse = (input?: Record<string, any>) => {
   return decode(typeMappings, input);
 };
 
+decoders.ActivityRestoredEvent = (input?: Record<string, any>) => {
+  const typeMappings: TypeMapping = {
+    created_at: { type: 'DatetimeType', isSingle: true },
+
+    activity: { type: 'ActivityResponse', isSingle: true },
+
+    received_at: { type: 'DatetimeType', isSingle: true },
+  };
+  return decode(typeMappings, input);
+};
+
 decoders.ActivityUnpinnedEvent = (input?: Record<string, any>) => {
   const typeMappings: TypeMapping = {
     created_at: { type: 'DatetimeType', isSingle: true },
@@ -1785,6 +1796,13 @@ decoders.ReminderResponseData = (input?: Record<string, any>) => {
   return decode(typeMappings, input);
 };
 
+decoders.RestoreActivityResponse = (input?: Record<string, any>) => {
+  const typeMappings: TypeMapping = {
+    activity: { type: 'ActivityResponse', isSingle: true },
+  };
+  return decode(typeMappings, input);
+};
+
 decoders.ReviewQueueItemResponse = (input?: Record<string, any>) => {
   const typeMappings: TypeMapping = {
     created_at: { type: 'DatetimeType', isSingle: true },

packages/feeds-client/src/gen/model-decoders/event-decoder-mapping.ts

@@ -34,6 +34,9 @@ const eventDecoderMapping: Record<
   'feeds.activity.removed_from_feed': (data: Record<string, any>) =>
     decoders.ActivityRemovedFromFeedEvent(data),
 
+  'feeds.activity.restored': (data: Record<string, any>) =>
+    decoders.ActivityRestoredEvent(data),
+
   'feeds.activity.unpinned': (data: Record<string, any>) =>
     decoders.ActivityUnpinnedEvent(data),
 

packages/feeds-client/src/gen/models/index.ts

@@ -490,6 +490,24 @@ export interface ActivityResponse {
   poll?: PollResponseData;
 }
 
+export interface ActivityRestoredEvent {
+  created_at: Date;
+
+  fid: string;
+
+  activity: ActivityResponse;
+
+  custom: Record<string, any>;
+
+  type: string;
+
+  feed_visibility?: string;
+
+  received_at?: Date;
+
+  user?: UserResponseCommonFields;
+}
+
 export interface ActivitySelectorConfig {
   cutoff_time: Date;
 
@@ -5138,6 +5156,14 @@ export interface RestoreActionRequest {
   decision_reason?: string;
 }
 
+export interface RestoreActivityRequest {}
+
+export interface RestoreActivityResponse {
+  duration: string;
+
+  activity: ActivityResponse;
+}
+
 export interface ReviewQueueItemResponse {
   ai_text_severity: string;
 
@@ -6472,6 +6498,7 @@ export type WSClientEvent =
   | ({
       type: 'feeds.activity.removed_from_feed';
     } & ActivityRemovedFromFeedEvent)
+  | ({ type: 'feeds.activity.restored' } & ActivityRestoredEvent)
   | ({ type: 'feeds.activity.unpinned' } & ActivityUnpinnedEvent)
   | ({ type: 'feeds.activity.updated' } & ActivityUpdatedEvent)
   | ({ type: 'feeds.bookmark.added' } & BookmarkAddedEvent)
@@ -6522,6 +6549,7 @@ export type WSEvent =
   | ({
       type: 'feeds.activity.removed_from_feed';
     } & ActivityRemovedFromFeedEvent)
+  | ({ type: 'feeds.activity.restored' } & ActivityRestoredEvent)
   | ({ type: 'feeds.activity.unpinned' } & ActivityUnpinnedEvent)
   | ({ type: 'feeds.activity.updated' } & ActivityUpdatedEvent)
   | ({ type: 'feeds.bookmark.added' } & BookmarkAddedEvent)