OV-377: Create preview page and flow

backend/src/bundles/public-video/enums/enums.ts

@@ -0,0 +1 @@
+export { VideosApiPath, VideoValidationMessage } from 'shared';

backend/src/bundles/public-video/enums/public-videos-api-path.enum.ts

@@ -0,0 +1,5 @@
+const PublicVideosApiPath = {
+    ROOT: '/',
+} as const;
+
+export { PublicVideosApiPath };

backend/src/bundles/public-video/public-video.controller.ts

@@ -0,0 +1,43 @@
+import { type PublicVideoService } from '~/bundles/public-video/public-video.service.js';
+import {
+    type ApiHandlerOptions,
+    type ApiHandlerResponse,
+    BaseController,
+} from '~/common/controller/controller.js';
+import { ApiPath } from '~/common/enums/enums.js';
+import { HTTPCode, HTTPMethod } from '~/common/http/http.js';
+import { type Logger } from '~/common/logger/logger.js';
+
+import { PublicVideosApiPath } from './enums/public-videos-api-path.enum.js';
+
+class PublicVideoController extends BaseController {
+    private publicVideoService: PublicVideoService;
+
+    public constructor(logger: Logger, publicVideoService: PublicVideoService) {
+        super(logger, ApiPath.PUBLIC_VIDEO);
+
+        this.publicVideoService = publicVideoService;
+
+        this.addRoute({
+            path: PublicVideosApiPath.ROOT,
+            method: HTTPMethod.GET,
+            handler: (options) => this.findUrlByToken(options),
+        });
+    }
+
+    private async findUrlByToken(
+        options: ApiHandlerOptions,
+    ): Promise<ApiHandlerResponse> {
+        const headers = options.headers as Record<string, { value: string }>;
+        const videoTokenHeader = headers['video_token']?.toString() ?? '';
+
+        return {
+            status: HTTPCode.OK,
+            payload: await this.publicVideoService.findUrlByToken(
+                videoTokenHeader ?? '',
+            ),
+        };
+    }
+}
+
+export { PublicVideoController };

backend/src/bundles/public-video/public-video.service.ts

@@ -0,0 +1,41 @@
+import { type VideoRepository } from '~/bundles/videos/video.repository.js';
+import { HTTPCode, HttpError } from '~/common/http/http.js';
+import { tokenService } from '~/common/services/services.js';
+
+import { VideoValidationMessage } from './enums/enums.js';
+
+class PublicVideoService {
+    private videoRepository: VideoRepository;
+    public constructor(videoRepository: VideoRepository) {
+        this.videoRepository = videoRepository;
+    }
+
+    public async findUrlByToken(token: string): Promise<string> {
+        const id = await tokenService.getVideoIdFromToken(token);
+
+        if (!id) {
+            this.throwVideoNotFoundError();
+        }
+
+        const video = await this.videoRepository.findById(id);
+
+        if (!video) {
+            this.throwVideoNotFoundError();
+        }
+
+        const url = video.toObject().url;
+        if (!url) {
+            this.throwVideoNotFoundError();
+        }
+        return url;
+    }
+
+    private throwVideoNotFoundError(): never {
+        throw new HttpError({
+            message: VideoValidationMessage.VIDEO_DOESNT_EXIST,
+            status: HTTPCode.NOT_FOUND,
+        });
+    }
+}
+
+export { PublicVideoService };

backend/src/bundles/public-video/public-videos.ts

@@ -0,0 +1,12 @@
+import { VideoModel } from '~/bundles/videos/video.model.js';
+import { VideoRepository } from '~/bundles/videos/video.repository.js';
+import { logger } from '~/common/logger/logger.js';
+
+import { PublicVideoController } from './public-video.controller.js';
+import { PublicVideoService } from './public-video.service.js';
+
+const videoRepository = new VideoRepository(VideoModel);
+const videoService = new PublicVideoService(videoRepository);
+const publicVideoController = new PublicVideoController(logger, videoService);
+
+export { publicVideoController };

backend/src/bundles/videos/video.controller.ts

@@ -109,6 +109,17 @@ class VideoController extends BaseController {
                     }>,
                 ),
         });
+        this.addRoute({
+            path: `${VideosApiPath.ID}/share`,
+            method: HTTPMethod.GET,
+            handler: (options) => {
+                return this.createVideoIdJWT(
+                    options as ApiHandlerOptions<{
+                        params: VideoGetOneRequestDto;
+                    }>,
+                );
+            },
+        });
     }
 
     /**
@@ -186,6 +197,43 @@ class VideoController extends BaseController {
         };
     }
 
+    /**
+     * @swagger
+     * /videos/{id}/share:
+     *    get:
+     *      parameters:
+     *        - in: path
+     *          name: id
+     *          required: true
+     *          schema:
+     *            type: string
+     *            format: uuid
+     *          description: The video id
+     *      description: Create a JWT for the video id
+     *      security:
+     *       - bearerAuth: []
+     *      responses:
+     *        200:
+     *          description: Successful operation
+     *          content:
+     *            application/json:
+     *              schema:
+     *                type: object
+     *                properties:
+     *                  token:
+     *                    type: string
+     */
+    private async createVideoIdJWT(
+        options: ApiHandlerOptions<{
+            params: VideoGetOneRequestDto;
+        }>,
+    ): Promise<ApiHandlerResponse> {
+        return {
+            status: HTTPCode.OK,
+            payload: await this.videoService.getVideoIdToken(options.params.id),
+        };
+    }
+
     /**
      * @swagger
      * /videos/:

backend/src/bundles/videos/video.service.ts

@@ -2,6 +2,7 @@ import { VideoEntity } from '~/bundles/videos/video.entity.js';
 import { type VideoRepository } from '~/bundles/videos/video.repository.js';
 import { HTTPCode, HttpError } from '~/common/http/http.js';
 import { type FileService } from '~/common/services/file/file.service.js';
+import { tokenService } from '~/common/services/services.js';
 import { type Service } from '~/common/types/types.js';
 
 import { VideoValidationMessage } from './enums/enums.js';
@@ -15,7 +16,6 @@ import {
 class VideoService implements Service {
     private videoRepository: VideoRepository;
     private fileService: FileService;
-
     public constructor(
         videoRepository: VideoRepository,
         fileService: FileService,
@@ -100,6 +100,10 @@ class VideoService implements Service {
 
         return isVideoDeleted;
     }
+
+    public async getVideoIdToken(id: string): Promise<string> {
+        return await tokenService.createVideoIdToken(id);
+    }
 }
 
 export { VideoService };

backend/src/common/constants/white-routes.constants.ts

@@ -11,6 +11,10 @@ const WHITE_ROUTES = [
         path: `/api/v1${ApiPath.AUTH}${AuthApiPath.SIGN_UP}`,
         method: HTTPMethod.POST,
     },
+    {
+        path: `/api/v1${ApiPath.PUBLIC_VIDEO}/`,
+        method: HTTPMethod.GET,
+    },
     {
         path: /\/v1\/documentation\/.*/,
         method: HTTPMethod.GET,

backend/src/common/controller/base-controller.package.ts

@@ -49,14 +49,15 @@ class BaseController implements Controller {
     private mapRequest(
         request: Parameters<ServerAppRouteParameters['handler']>[0],
     ): ApiHandlerOptions {
-        const { body, query, params, session, user } = request;
+        const { body, query, params, session, user, headers } = request;
 
         return {
             body,
             query,
             params,
             session,
             user,
+            headers,
         };
     }
 }

backend/src/common/controller/types/api-handler-options.type.ts

@@ -4,6 +4,7 @@ type DefaultApiHandlerOptions = {
     params?: unknown;
     session?: unknown;
     user?: unknown;
+    headers?: unknown;
 };
 
 type ApiHandlerOptions<
@@ -14,6 +15,7 @@ type ApiHandlerOptions<
     params: T['params'];
     session: T['session'];
     user: T['user'];
+    headers: T['headers'];
 };
 
 export { type ApiHandlerOptions };

backend/src/common/server-application/server-application.ts

@@ -3,6 +3,7 @@ import { avatarVideoController } from '~/bundles/avatar-videos/avatar-videos.js'
 import { avatarController } from '~/bundles/avatars/avatars.js';
 import { chatController } from '~/bundles/chat/chat.js';
 import { notificationController } from '~/bundles/notifications/notifications.js';
+import { publicVideoController } from '~/bundles/public-video/public-videos.js';
 import { speechController } from '~/bundles/speech/speech.js';
 import { userController } from '~/bundles/users/users.js';
 import { videoController } from '~/bundles/videos/videos.js';
@@ -24,6 +25,7 @@ const apiV1 = new BaseServerAppApi(
     ...chatController.routes,
     ...speechController.routes,
     ...avatarVideoController.routes,
+    ...publicVideoController.routes,
 );
 
 const serverApp = new BaseServerApp({

backend/src/common/services/token/token.services.ts

@@ -17,6 +17,13 @@ class TokenService {
             .sign(this.secretKey);
     }
 
+    public async createVideoIdToken(videoId: string): Promise<string> {
+        const jwt = await new SignJWT({ videoId })
+            .setProtectedHeader({ alg: 'HS256' })
+            .sign(this.secretKey);
+        return jwt.replaceAll('.', '~');
+    }
+
     public async verifyToken(token: string): Promise<TokenPayload | null> {
         try {
             const { payload } = await jwtVerify(token, this.secretKey);
@@ -30,6 +37,11 @@ class TokenService {
         const payload = await this.verifyToken(token);
         return (payload?.['userId'] as string) || null;
     }
+
+    public async getVideoIdFromToken(token: string): Promise<string | null> {
+        const payload = await this.verifyToken(token);
+        return (payload?.['videoId'] as string) || null;
+    }
 }
 
 export { TokenService };

frontend/src/bundles/common/api/api.ts

@@ -2,6 +2,7 @@ import { config } from '~/framework/config/config.js';
 import { http } from '~/framework/http/http.js';
 import { storage } from '~/framework/storage/storage.js';
 
+import { PublicVideosApi } from './public-video-api/public-videos-api.js';
 import { VideosApi } from './video-api/videos-api.js';
 
 const videosApi = new VideosApi({
@@ -10,4 +11,10 @@ const videosApi = new VideosApi({
     http,
 });
 
-export { videosApi };
+const publicVideosApi = new PublicVideosApi({
+    baseUrl: config.ENV.API.ORIGIN_URL,
+    storage,
+    http,
+});
+
+export { publicVideosApi, videosApi };

frontend/src/bundles/common/api/public-video-api/enums/enums.ts

@@ -0,0 +1 @@
+export { VideosApiPath } from 'shared';

frontend/src/bundles/common/api/public-video-api/public-videos-api.ts

@@ -0,0 +1,44 @@
+import { ApiPath, ContentType } from '~/bundles/common/enums/enums.js';
+import { type Http, HTTPMethod } from '~/framework/http/http.js';
+import { BaseHttpApi } from '~/framework/http-api/http-api.js';
+import { type Storage } from '~/framework/storage/storage.js';
+
+import { VideosApiPath } from './enums/enums.js';
+
+type Constructor = {
+    baseUrl: string;
+    http: Http;
+    storage: Storage;
+};
+
+class PublicVideosApi extends BaseHttpApi {
+    public constructor({ baseUrl, http, storage }: Constructor) {
+        super({ path: ApiPath.PUBLIC_VIDEO, baseUrl, http, storage });
+    }
+
+    public async getVideoUrlFromJWT(jwt: string): Promise<string> {
+        const headers = new Headers();
+        headers.append('video_token', jwt.replaceAll('~', '.'));
+
+        const options = {
+            method: HTTPMethod.GET,
+            contentType: ContentType.JSON,
+            hasAuth: true,
+            customHeaders: headers,
+        };
+
+        const response = await this.load(
+            this.getFullEndpoint(`${VideosApiPath.ROOT}`, {}),
+            options,
+        );
+
+        if (!response.ok) {
+            throw new Error(
+                `Failed to get video ID JWT: ${response.statusText}`,
+            );
+        }
+        return await response.text();
+    }
+}
+
+export { PublicVideosApi };

frontend/src/bundles/common/api/video-api/videos-api.ts

@@ -68,6 +68,22 @@ class VideosApi extends BaseHttpApi {
         return await response.json<VideoGetAllItemResponseDto>();
     }
 
+    public async getVideo(
+        payload: UpdateVideoRequestDto,
+        id: string,
+    ): Promise<VideoGetAllItemResponseDto> {
+        const response = await this.load(
+            this.getFullEndpoint(VideosApiPath.ID, { id }),
+            {
+                method: HTTPMethod.GET,
+                contentType: ContentType.JSON,
+                hasAuth: true,
+            },
+        );
+
+        return await response.json<VideoGetAllItemResponseDto>();
+    }
+
     public async deleteVideo(id: string): Promise<void> {
         const response = await this.load(
             this.getFullEndpoint(`${VideosApiPath.ROOT}${id}`, {}),
@@ -81,6 +97,24 @@ class VideosApi extends BaseHttpApi {
 
         await response.json<boolean>();
     }
+
+    public async getVideoIdJWT(id: string): Promise<string> {
+        const response = await this.load(
+            this.getFullEndpoint(`${VideosApiPath.ROOT}${id}/share`, {}),
+            {
+                method: HTTPMethod.GET,
+                contentType: ContentType.JSON,
+                hasAuth: true,
+            },
+        );
+
+        if (!response.ok) {
+            throw new Error(
+                `Failed to get video ID JWT: ${response.statusText}`,
+            );
+        }
+        return await response.text();
+    }
 }
 
 export { VideosApi };