Add controller for document sharing

backend/src/documents/documents.controller.ts

@@ -1,4 +1,41 @@
-import { Controller } from "@nestjs/common";
+import { Controller, Get, Query } from "@nestjs/common";
+import { DocumentsService } from "./documents.service";
+import { Public } from "src/utils/decorators/auth.decorator";
+import {
+	ApiNotFoundResponse,
+	ApiOkResponse,
+	ApiOperation,
+	ApiQuery,
+	ApiTags,
+	ApiUnauthorizedResponse,
+} from "@nestjs/swagger";
+import { FindDocumentFromSharingTokenResponse } from "./types/find-document-from-sharing-token-response.type";
+import { HttpExceptionResponse } from "src/utils/types/http-exception-response.type";
 
+@ApiTags("Documents")
 @Controller("documents")
-export class DocumentsController {}
+export class DocumentsController {
+	constructor(private documentsService: DocumentsService) {}
+
+	@Public()
+	@Get("share")
+	@ApiOperation({
+		summary: "Retrieve a Shared Document using Sharing Token",
+		description: "If the user has the access permissions, return a shared document.",
+	})
+	@ApiQuery({ type: String, name: "token", description: "Sharing Token" })
+	@ApiOkResponse({ type: FindDocumentFromSharingTokenResponse })
+	@ApiNotFoundResponse({
+		type: HttpExceptionResponse,
+		description: "The document does not exist.",
+	})
+	@ApiUnauthorizedResponse({
+		type: HttpExceptionResponse,
+		description: "The sharing token is expired or invalid.",
+	})
+	async findDocumentFromSharingToken(
+		@Query("token") token: string
+	): Promise<FindDocumentFromSharingTokenResponse> {
+		return this.documentsService.findDocumentFromSharingToken(token);
+	}
+}

backend/src/documents/documents.service.ts

@@ -1,8 +1,10 @@
-import { Injectable, NotFoundException } from "@nestjs/common";
+import { Injectable, NotFoundException, UnauthorizedException } from "@nestjs/common";
 import { JwtService } from "@nestjs/jwt";
 import { Document } from "@prisma/client";
 import { PrismaService } from "src/db/prisma.service";
 import { SharingPayload } from "src/utils/types/sharing.type";
+import { FindDocumentFromSharingTokenResponse } from "./types/find-document-from-sharing-token-response.type";
+import { ShareRoleEnum } from "src/utils/constants/share-role";
 
 @Injectable()
 export class DocumentsService {
@@ -11,8 +13,18 @@ export class DocumentsService {
 		private jwtService: JwtService
 	) {}
 
-	async findDocumentFromSharingToken(sharingToken: string) {
-		const { documentId, role } = this.jwtService.verify<SharingPayload>(sharingToken);
+	async findDocumentFromSharingToken(
+		sharingToken: string
+	): Promise<FindDocumentFromSharingTokenResponse> {
+		let documentId: string, role: ShareRoleEnum;
+
+		try {
+			const payload = this.jwtService.verify<SharingPayload>(sharingToken);
+			documentId = payload.documentId;
+			role = payload.role;
+		} catch (e) {
+			throw new UnauthorizedException("Invalid sharing token");
+		}
 
 		let document: Document;
 

backend/src/workspace-documents/workspace-documents.service.ts

@@ -126,7 +126,7 @@ export class WorkspaceDocumentsService {
 				role,
 			},
 			{
-				expiresIn: Date.now() - expirationDate.getTime(),
+				expiresIn: expirationDate.getTime() - Date.now(),
 			}
 		);