Merge pull request #4 from bcgov/3236-loadFromPortal-endpoint

ADO-3236 - Add loadFromPortal endpoint

Author: spencercrose

server/api/controllers/communications.controller.ts

@@ -152,6 +152,41 @@ export class CommunicationsController {
     }
   }
 
+  async loadPortalForm(req: Request, res: Response): Promise<void> {
+    try {
+      const requestData = req.body;
+
+      const authHeader = req.headers.authorization;
+      const token = authHeader?.startsWith('Bearer ')
+        ? authHeader.substring(7)
+        : authHeader;
+
+      const originalServer = req.headers['x-original-server'] as string;
+
+      // TODO: Implement authentication/authorization when available
+
+      const result = await ICMService.loadPortalForm(
+        requestData,
+        token,
+        originalServer
+      );
+
+      if (result.success) {
+        res.status(200).json(result.data);
+      } else {
+        res.status(result.status || 500).json({ error: result.error });
+      }
+    } catch (error) {
+      let errorMessage = 'Internal server error';
+      if (error instanceof Error && error.message) {
+        errorMessage = error.message;
+      }
+      res.status(500).json({
+        error: errorMessage,
+      });
+    }
+  }
+
   generatePDFFromJson(req: Request, res: Response): void {
     res.json({ endpoint: 'generatePDFFromJson', payload: req.body });
   }

server/api/controllers/router.ts

@@ -39,6 +39,9 @@ router.post('/generatePDFFromJson', (req, res) =>
 router.post('/generateNewTemplate', (req, res) =>
   CommunicationsController.generateNewTemplate(req, res)
 );
+router.post('/loadPortalForm', (req, res) =>
+  CommunicationsController.loadPortalForm(req, res)
+);
 
 // Kiln Renderer Routes
 router.get('/view', (req, res) => RendererController.viewForm(req, res));

server/api/services/icm.client.ts

@@ -251,4 +251,40 @@ export class ICMClient {
       return this.handleBlobError(error, 'pdfRender');
     }
   }
+
+  async loadPortalForm(
+    payload: any,
+    originalServer?: string
+  ): Promise<ICMJsonResponse> {
+    try {
+      const url = process.env.COMM_API_LOAD_PORTAL_FORM_ENDPOINT_URL;
+
+      if (!url) {
+        throw new Error(
+          'COMM_API_LOAD_PORTAL_FORM_ENDPOINT_URL environment variable is required'
+        );
+      }
+
+      const timeout = process.env.COMM_API_TIMEOUT
+        ? parseInt(process.env.COMM_API_TIMEOUT, 10)
+        : 30000;
+
+      const headers: Record<string, string> = {
+        'Content-Type': 'application/json',
+      };
+
+      if (originalServer) {
+        headers['X-Original-Server'] = originalServer;
+      }
+
+      const response = await axios.post(url, payload, {
+        headers,
+        timeout,
+      });
+
+      return this.createJsonResponse(response);
+    } catch (error) {
+      return this.handleJsonError(error, 'loadPortalForm');
+    }
+  }
 }

server/api/services/icm.service.ts

@@ -91,6 +91,17 @@ interface PdfRenderResult {
   status?: number;
 }
 
+interface LoadPortalFormRequest {
+  [key: string]: any;
+}
+
+interface LoadPortalFormResult {
+  success: boolean;
+  data?: any;
+  error?: string;
+  status?: number;
+}
+
 export class ICMService {
   private icmClient: ICMClient;
 
@@ -367,6 +378,38 @@ export class ICMService {
       ) as PdfRenderResult;
     }
   }
+
+  async loadPortalForm(
+    data: LoadPortalFormRequest,
+    token?: string,
+    originalServer?: string
+  ): Promise<LoadPortalFormResult> {
+    try {
+      if (!data || Object.keys(data).length === 0) {
+        return {
+          success: false,
+          error: 'Request data is required',
+          status: 400,
+        };
+      }
+
+      const payload = {
+        ...data,
+        ...(token && { token }),
+      };
+
+      const response = await this.icmClient.loadPortalForm(
+        payload,
+        originalServer
+      );
+      return this.handleResponse(
+        response,
+        'Error loading portal form. Please try again.'
+      );
+    } catch (error) {
+      return this.handleError(error, 'Failed to load portal form');
+    }
+  }
 }
 
 export default new ICMService();

server/common/api.yml

@@ -259,6 +259,28 @@ paths:
         200:
           description: Template generated successfully
 
+  /loadPortalForm:
+    post:
+      tags:
+        - Communications Layer
+        - ICM User Interface
+      description: Load a portal form
+      parameters:
+        - in: body
+          name: formData
+          required: true
+          schema:
+            type: object
+      responses:
+        200:
+          description: Portal form loaded successfully
+        400:
+          description: Bad request - invalid data
+        404:
+          description: Portal form not found
+        500:
+          description: Internal server error
+
   /examples:
     get:
       tags: