feat(cards): implement add platform link to cards flow

Author: Harxhit

apps/backend/src/routes/cards.ts

@@ -1,6 +1,6 @@
 import * as cardService from '../services/cardService'
 import { handleDbError } from '../utils/error.util.js';
-import { createCardSchema ,updateCardSchema} from '../validations/card.validation';
+import { createCardSchema ,updateCardSchema, addPlatformLinkSchema} from '../validations/card.validation';
 
 import type { CardResponse } from '../services/cardService';
 import type { Card } from '@devcard/shared';
@@ -89,7 +89,6 @@ export async function cardRoutes(app: FastifyInstance): Promise<void> {
   });
 
   // ─── Update Card ───
-
   app.put('/:id', async (request: FastifyRequest<{ Params: CardParams; Body: UpdateCardBody }>, reply: FastifyReply): Promise<CardResponse> => {
     const userId = (request.user as { id: string }).id;
     const { id } = request.params;
@@ -143,4 +142,44 @@ export async function cardRoutes(app: FastifyInstance): Promise<void> {
       return handleDbError(error, request, reply)
     }
   });
+
+  //Add platform-link
+  app.put('/:id/platform-link', async(request: FastifyRequest<{Params:{id: string}, Body: {platformLinkId: string}}>, reply: FastifyReply) => {
+    const cardId = request.params.id; 
+    const userId = request.user.id; 
+    const parsed = addPlatformLinkSchema.safeParse(request.body); 
+
+    if (!parsed.success) {
+      return reply.status(400).send({ error: 'Validation failed', details: parsed.error.flatten() });
+    }
+    
+    try {
+
+      const platformLinkId = parsed.data.platformLinkId
+      await cardService.addPlatFormLinks(app, userId, cardId, platformLinkId)
+      
+      return reply.status(200).send('Platform link added successfully')
+      
+    } catch (error: any) {
+      if (error?.code === 'CARD_NOT_FOUND') {
+        return reply.status(404).send({
+          error: error.message,
+        });
+      }
+
+      if (error?.code === 'PLATFORM_LINK_NOT_FOUND') {
+        return reply.status(403).send({
+          error: error.message,
+        });
+      }
+
+      if (error?.code === 'LINK_ALREADY_EXISTS') {
+        return reply.status(409).send({
+          error: error.message,
+        });
+      }
+      app.log.error(error)
+      handleDbError(error, request, reply)
+    }
+  })
 }

apps/backend/src/services/cardService.ts

@@ -2,13 +2,14 @@ import { CardVisibility, type Prisma } from '@prisma/client';
 
 import { generateUniqueSlug } from '../utils/slug';
 
-import type { FastifyInstance } from 'fastify';
 import type { CreateCardBody } from '../routes/cards';
+import type { FastifyInstance } from 'fastify';
 
 type CardLinkResponse = { platformLink: unknown };
 type RawCard = { id: string; title: string; isDefault: boolean; cardLinks: CardLinkResponse[] };
 export type CardResponse = { id: string; title: string; isDefault: boolean; links: unknown[] };
 
+
 function mapCard(card: RawCard): CardResponse {
   return {
     id: card.id,
@@ -18,6 +19,7 @@ function mapCard(card: RawCard): CardResponse {
   };
 }
 
+//List card service
 export async function listCards(app: FastifyInstance, userId: string): Promise<CardResponse[]> {
   const cards = (await app.prisma.card.findMany({
     where: { userId },
@@ -29,6 +31,7 @@ export async function listCards(app: FastifyInstance, userId: string): Promise<C
   return cards.map(mapCard);
 }
 
+//Creates card service
 export async function createCard(app: FastifyInstance, userId: string, body: CreateCardBody): Promise<CardResponse> {
   const {title , description , linkIds , visibility} = body
 
@@ -97,6 +100,7 @@ export async function createCard(app: FastifyInstance, userId: string, body: Cre
   throw new Error('Failed to create card after retrying serialization conflicts');
 }
 
+//Update card service
 export async function updateCard(
   app: FastifyInstance,
   userId: string,
@@ -147,6 +151,7 @@ export async function updateCard(
   return mapCard(updated);
 }
 
+//Delete card service
 export async function deleteCard(app: FastifyInstance, userId: string, id: string): Promise<null> {
   return await app.prisma.$transaction(async (tx: Prisma.TransactionClient) => {
     const existing = await tx.card.findFirst({ where: { id, userId } });
@@ -175,6 +180,7 @@ export async function deleteCard(app: FastifyInstance, userId: string, id: strin
   });
 }
 
+//Set default card service
 export async function setDefaultCard(app: FastifyInstance, userId: string, id: string): Promise<{ message: string } | null> {
   const existing = await app.prisma.card.findFirst({ where: { id, userId } });
   if (!existing) {
@@ -188,3 +194,58 @@ export async function setDefaultCard(app: FastifyInstance, userId: string, id: s
 
   return { message: 'Default card updated' };
 }
+
+//Adds platfrom link
+export async function addPlatFormLinks(app: FastifyInstance, userId: string, id:string, platformLinkId: string){
+    const ownedCard = await app.prisma.card.findFirst({
+      where: {
+        id, 
+        userId
+      }
+    })
+
+    if (!ownedCard) {
+      throw Object.assign(
+        new Error('Card not found or you do not have permission to modify it'),
+        { code: 'CARD_NOT_FOUND' }
+      );
+    }
+    const [existingLink, platformLink] = await Promise.all([
+      app.prisma.cardLink.findUnique({
+        where: {
+          cardId_platformLinkId: {
+            cardId: id,
+            platformLinkId,
+          },
+        },
+      }),
+
+      app.prisma.platformLink.findFirst({
+        where: {
+          id: platformLinkId,
+          userId,
+        },
+      }),
+    ]);
+
+    if (!platformLink) {
+      throw Object.assign(
+        new Error('Platform link not found or does not belong to your account'),
+        { code: 'PLATFORM_LINK_NOT_FOUND' }
+      );
+    }
+
+    if (existingLink) {
+      throw Object.assign(
+        new Error('This platform link has already been added to the card'),
+        { code: 'LINK_ALREADY_EXISTS' }
+      );
+    }
+
+    await app.prisma.cardLink.create({
+      data: {
+        cardId: id, 
+        platformLinkId
+      }
+    })
+}

apps/backend/src/validations/card.validation.ts

@@ -23,3 +23,9 @@ export const updateCardSchema = z.object({
   title: z.string().min(1).max(100).optional(),
   linkIds: z.array(z.string().uuid()).optional(),
 });
+
+export const addPlatformLinkSchema = z.object({
+  platformLinkId: z.string().uuid({
+    message: 'Invalid platform link ID',
+  }),
+});