Merge remote-tracking branch 'origin' into 1630-cards-wallet-backend-…

…terminate-card

packages/wallet/backend/src/app.ts

@@ -313,6 +313,8 @@ export class App {
       cardController.getCardsByCustomer
     )
     router.get('/cards/:cardId/details', isAuth, cardController.getCardDetails)
+    router.put('/cards/:cardId/lock', isAuth, cardController.lock)
+    router.put('/cards/:cardId/unlock', isAuth, cardController.unlock)
     router.put(
       '/cards/:cardId/block',
       isAuth,

packages/wallet/backend/src/card/controller.ts

@@ -5,18 +5,24 @@ import { toSuccessResponse } from '@shared/backend'
 import {
   ICardDetailsRequest,
   ICardDetailsResponse,
-  ICardResponse
+  ICardLockRequest,
+  ICardResponse,
+  ICardUnlockRequest
 } from './types'
 import { validate } from '@/shared/validate'
 import {
   getCardsByCustomerSchema,
   getCardDetailsSchema,
+  lockCardSchema,
+  unlockCardSchema,
   permanentlyBlockCardSchema
 } from './validation'
 
 export interface ICardController {
   getCardsByCustomer: Controller<ICardDetailsResponse[]>
   getCardDetails: Controller<ICardResponse>
+  lock: Controller<ICardResponse>
+  unlock: Controller<ICardResponse>
 }
 
 export class CardController implements ICardController {
@@ -60,6 +66,39 @@ export class CardController implements ICardController {
     }
   }
 
+  public lock = async (req: Request, res: Response, next: NextFunction) => {
+    try {
+      const { params, query, body } = await validate(lockCardSchema, req)
+      const { cardId } = params
+      const { reasonCode } = query
+      const requestBody: ICardLockRequest = body
+
+      const result = await this.cardService.lock(
+        cardId,
+        reasonCode,
+        requestBody
+      )
+
+      res.status(200).json(toSuccessResponse(result))
+    } catch (error) {
+      next(error)
+    }
+  }
+
+  public unlock = async (req: Request, res: Response, next: NextFunction) => {
+    try {
+      const { params, body } = await validate(unlockCardSchema, req)
+      const { cardId } = params
+      const requestBody: ICardUnlockRequest = body
+
+      const result = await this.cardService.unlock(cardId, requestBody)
+
+      res.status(200).json(toSuccessResponse(result))
+    } catch (error) {
+      next(error)
+    }
+  }
+
   public permanentlyBlockCard = async (
     req: Request,
     res: Response,

packages/wallet/backend/src/card/service.ts

@@ -3,8 +3,11 @@ import { GateHubClient } from '../gatehub/client'
 import {
   ICardDetailsRequest,
   ICardDetailsResponse,
-  ICardResponse
+  ICardLockRequest,
+  ICardResponse,
+  ICardUnlockRequest
 } from './types'
+import { LockReasonCode } from '@wallet/shared/src'
 import { NotFound } from '@shared/backend'
 import { BlockReasonCode } from '@wallet/shared/src'
 
@@ -35,6 +38,21 @@ export class CardService {
     return this.gateHubClient.getCardDetails(requestBody)
   }
 
+  async lock(
+    cardId: string,
+    reasonCode: LockReasonCode,
+    requestBody: ICardLockRequest
+  ): Promise<ICardResponse> {
+    return this.gateHubClient.lockCard(cardId, reasonCode, requestBody)
+  }
+
+  async unlock(
+    cardId: string,
+    requestBody: ICardUnlockRequest
+  ): Promise<ICardResponse> {
+    return this.gateHubClient.unlockCard(cardId, requestBody)
+  }
+
   async permanentlyBlockCard(
     userId: string,
     cardId: string,

packages/wallet/backend/src/card/types.ts

@@ -94,3 +94,11 @@ export interface ICardProductResponse {
   name: string
   cost: string
 }
+
+export interface ICardLockRequest {
+  note: string
+}
+
+export interface ICardUnlockRequest {
+  note: string
+}

packages/wallet/backend/src/card/validation.ts

@@ -15,6 +15,34 @@ export const getCardDetailsSchema = z.object({
   })
 })
 
+export const lockCardSchema = z.object({
+  params: z.object({
+    cardId: z.string()
+  }),
+  query: z.object({
+    reasonCode: z.enum([
+      'ClientRequestedLock',
+      'LostCard',
+      'StolenCard',
+      'IssuerRequestGeneral',
+      'IssuerRequestFraud',
+      'IssuerRequestLegal'
+    ])
+  }),
+  body: z.object({
+    note: z.string()
+  })
+})
+
+export const unlockCardSchema = z.object({
+  params: z.object({
+    cardId: z.string()
+  }),
+  body: z.object({
+    note: z.string()
+  })
+})
+
 export const permanentlyBlockCardSchema = z.object({
   params: z.object({
     cardId: z.string()

packages/wallet/backend/src/gatehub/client.ts

@@ -30,7 +30,7 @@ import {
 } from '@/gatehub/consts'
 import axios, { AxiosError } from 'axios'
 import { Logger } from 'winston'
-import { IFRAME_TYPE } from '@wallet/shared/src'
+import { IFRAME_TYPE, LockReasonCode } from '@wallet/shared/src'
 import { BadRequest } from '@shared/backend'
 import {
   ICardDetailsResponse,
@@ -39,7 +39,9 @@ import {
   ICreateCustomerRequest,
   ICreateCustomerResponse,
   ICardProductResponse,
-  ICardDetailsRequest
+  ICardDetailsRequest,
+  ICardLockRequest,
+  ICardUnlockRequest
 } from '@/card/types'
 import { BlockReasonCode } from '@wallet/shared/src'
 
@@ -372,6 +374,40 @@ export class GateHubClient {
     return cardDetailsResponse
   }
 
+  async lockCard(
+    cardId: string,
+    reasonCode: LockReasonCode,
+    requestBody: ICardLockRequest
+  ): Promise<ICardResponse> {
+    let url = `${this.apiUrl}/v1/cards/${cardId}/lock`
+    url += `?reasonCode=${encodeURIComponent(reasonCode)}`
+
+    return this.request<ICardResponse>(
+      'PUT',
+      url,
+      JSON.stringify(requestBody),
+      {
+        cardAppId: this.env.GATEHUB_CARD_APP_ID
+      }
+    )
+  }
+
+  async unlockCard(
+    cardId: string,
+    requestBody: ICardUnlockRequest
+  ): Promise<ICardResponse> {
+    const url = `${this.apiUrl}/v1/cards/${cardId}/unlock`
+
+    return this.request<ICardResponse>(
+      'PUT',
+      url,
+      JSON.stringify(requestBody),
+      {
+        cardAppId: this.env.GATEHUB_CARD_APP_ID
+      }
+    )
+  }
+
   async permanentlyBlockCard(
     cardId: string,
     reasonCode: BlockReasonCode