feat: Add rescue guide download feature

Author: aoda-zhang

apps/backend/document-service/package.json

@@ -1,25 +1,23 @@
 {
-  "name": "document-service",
-  "main": "build/main.js",
+  "private": "true",
+  "name": "@pawhaven/document-service",
   "version": "1.0.0",
   "scripts": {
-    "start:dev": "cross-env NODE_ENV=dev nest start --watch",
-    "stary:uat": "cross-env NODE_ENV=uat nest start --watch",
-    "build": "rm -rf build && nest build"
+    "postinstall": "pnpm run prisma:generate-mongodb",
+    "dev": "nest start --watch",
+    "build": "nest build",
+    "install:core-service": "pnpm --filter=@pawhaven/document-service... install",
+    "turbo:build": "turbo run build --filter=@pawhaven/document-service --env-mode=loose",
+    "start": "node dist/main.js",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
     "@nestjs-modules/mailer": "^2.0.2",
     "@nestjs/axios": "^4.0.1",
     "@nestjs/common": "^11.1.6",
     "@nestjs/config": "^4.0.2",
     "@nestjs/core": "^11.1.6",
-    "@nestjs/jwt": "^11.0.1",
-    "@nestjs/microservices": "^11.1.6",
-    "@nestjs/mongoose": "^11.0.3",
     "@nestjs/platform-express": "^11.1.6",
-    "@nestjs/serve-static": "^5.0.4",
-    "@nestjs/swagger": "^11.2.0",
-    "@nestjs/terminus": "^11.0.0",
     "@nestjs/throttler": "^6.4.0",
     "@react-email/components": "^0.5.6",
     "@types/express": "^5.0.3",
@@ -31,14 +29,11 @@
     "class-validator": "^0.14.2",
     "cookie-parser": "^1.4.7",
     "cross-env": "^10.1.0",
-    "crypto-js": "^4.2.0",
     "csurf": "^1.11.0",
     "dayjs": "^1.11.18",
     "dotenv": "^17.2.3",
-    "helmet": "^8.1.0",
     "i18n": "^0.15.2",
     "js-yaml": "^4.1.0",
-    "mongoose": "^8.19.1",
     "nodemailer": "^7.0.11",
     "puppeteer": "^24.24.0",
     "react": "^19.2.0",
@@ -53,15 +48,12 @@
     "@pawhaven/eslint-config": "workspace:*",
     "@nestjs/cli": "^11.0.10",
     "@nestjs/schematics": "^11.0.9",
-    "@nestjs/testing": "^11.1.6",
     "@types/i18n": "^0.13.12",
-    "@types/jest": "^30.0.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^24.7.1",
     "@types/nodemailer": "^6.4.20",
     "@types/passport-local": "^1.0.38",
     "@types/styled-components": "^5.1.34",
-    "@types/supertest": "^6.0.3",
     "source-map-support": "^0.5.21",
     "supertest": "^7.1.4",
     "ts-loader": "^9.5.4",

apps/backend/document-service/tsconfig.json

@@ -1,12 +1,7 @@
 {
   "extends": "@pawhaven/tsconfig/node",
   "compilerOptions": {
-    "jsx": "react-jsx",
-    "outDir": "build",
-    "paths": {
-      "@shared/*": ["../../../packages/backend-core/*"],
-      "@modules/*": ["./src/modules/*"]
-    }
+    "outDir": "dist"
   },
   "include": ["src"]
 }

apps/frontend/portal/src/features/RescueGuide/apis/request.ts

@@ -0,0 +1,5 @@
+import { apiClient } from '@/utils/apiClient';
+
+export const getRescueGuideDocs = () => {
+  return apiClient.download('/document/rescue/guide');
+};

apps/frontend/portal/src/features/RescueGuide/index.tsx

@@ -1,7 +1,10 @@
-import { Box, Container, Typography } from '@mui/material';
+import { Alert, Box, Container, Typography } from '@mui/material';
+import { FileDownloadButton } from '@pawhaven/frontend-core';
+import { showToast } from '@pawhaven/ui';
 import { ArrowDownToLine } from 'lucide-react';
 import { useTranslation } from 'react-i18next';
 
+import { getRescueGuideDocs } from './apis/request';
 import { StepCard } from './components/StepCard';
 
 export const RescueGuide = () => {
@@ -38,10 +41,20 @@ export const RescueGuide = () => {
         </Box>
 
         <p className="flex justify-center m-6">
-          <button className="flex items-center text-2xl bold cursor-pointer p-4 bg-surface rounded-2xl">
+          <FileDownloadButton
+            fileFetchRequest={getRescueGuideDocs}
+            onError={() => {
+              showToast({
+                type: 'error',
+                message: t('rescueGuide.download_failed'),
+              });
+            }}
+            fileType="PDF"
+            contentClassName="flex items-center text-2xl bold cursor-pointer p-4 rounded-2xl"
+          >
             <ArrowDownToLine />
             <span>{t('rescueGuide.download_guide')}</span>
-          </button>
+          </FileDownloadButton>
         </p>
       </Container>
     </div>

packages/frontend-core/src/api/index.ts

@@ -11,6 +11,7 @@ import { getLocale } from '../utils/locale/getLocale';
 import { getUTCTimestamp } from './encrypt';
 import { normalizeHttpError } from './errorHandle';
 import type { ApiClientOptions } from './types';
+import { RequestMode } from './types';
 
 /**
  * Configuration options for creating an API client instance.
@@ -20,7 +21,14 @@ import type { ApiClientOptions } from './types';
  * Factory function to create a reusable API client with common interceptors and headers.
  */
 export const createApiClient = (options: ApiClientOptions) => {
-  const { baseURL, timeout = 20000, withCredentials = true } = options;
+  const {
+    baseURL = '/api',
+    timeout = 20000,
+    withCredentials = true,
+    requestMode = RequestMode.http,
+  } = options as ApiClientOptions & {
+    requestMode?: keyof typeof RequestMode;
+  };
 
   const Http: AxiosInstance = axios.create({
     baseURL,
@@ -31,10 +39,14 @@ export const createApiClient = (options: ApiClientOptions) => {
   const getHttpHeaders = () => {
     const timestamp = `${getUTCTimestamp()}`;
     const headers: Record<string, any> = {
-      Accept: 'application/json',
       'X-timestamp': timestamp,
       'X-locale': getLocale(),
     };
+
+    if (requestMode === RequestMode.http) {
+      headers.Accept = 'application/json';
+    }
+
     return headers;
   };
 
@@ -52,13 +64,18 @@ export const createApiClient = (options: ApiClientOptions) => {
   // ✅ Response interceptor
   Http.interceptors.response.use(
     (response: AxiosResponse<any>) => {
+      if (requestMode === RequestMode.resource) {
+        return response;
+      }
+
       if (
         response?.data?.status >= 200 &&
         response?.data?.status < 400 &&
         response?.data?.isSuccess
       ) {
         return response.data.data;
       }
+
       return Promise.reject(normalizeHttpError(response.data));
     },
     (error) => {
@@ -95,5 +112,12 @@ export const createApiClient = (options: ApiClientOptions) => {
     ): Promise<T> {
       return Http.put(url, data, { ...config });
     },
+    download(url: string, config?: AxiosRequestConfig): Promise<Blob> {
+      return Http.get(url, {
+        responseType: 'blob',
+        transformResponse: (r) => r,
+        ...config,
+      }).then((res: AxiosResponse<Blob>) => res.data);
+    },
   };
 };

packages/frontend-core/src/api/types.ts

@@ -13,12 +13,18 @@ export const httpRequestErrors = {
   NETWORK: 'NETWORK',
 } as const;
 
+export const RequestMode = {
+  http: 'http',
+  resource: 'resource',
+} as const;
+
 export interface ApiClientOptions {
-  baseURL: string; // The base URL for API requests
+  baseURL?: string; // The base URL for API requests
   timeout?: number; // Optional request timeout
   enableSign?: boolean; // Whether to use signature validation
-  prefix: string; // endpoint prefix
+  prefix?: string; // endpoint prefix
   withCredentials?: boolean; // Is send cookies to backend automatically
+  requestMode?: keyof typeof RequestMode;
 }
 
 export type HttpRequestErrorType =
@@ -39,6 +45,7 @@ export interface ApiResponseType {
   status: number;
   code: string;
 }
+
 export enum extraRequestHeader {
   'access-token' = 'access-token',
   refreshToken = 'refreshToken',

packages/frontend-core/src/components/FileDownloadButton/index.tsx

@@ -0,0 +1,77 @@
+import Button from '@mui/material/Button';
+import CircularProgress from '@mui/material/CircularProgress';
+import type { ReactNode } from 'react';
+import { useCallback, useState } from 'react';
+
+export interface FileDownloadButtonProps {
+  fileFetchRequest: () => Promise<Blob>;
+  fileName?: string;
+  fileType: string;
+  label?: string | ReactNode;
+  disabled?: boolean;
+  onSuccess?: (blob: Blob, fileType: string) => void;
+  onError?: (error: unknown, fileType: string) => void;
+  children?: ReactNode;
+  buttonClassName?: string;
+  contentClassName?: string;
+}
+
+/**
+ * FileDownloadButton
+ *
+ * Reusable button for downloading arbitrary files with loading state.
+ * Explicit file type is required to make download intent clear to callers.
+ */
+export const FileDownloadButton = ({
+  fileFetchRequest,
+  fileName,
+  fileType,
+  label,
+  disabled = false,
+  onSuccess,
+  onError,
+  children,
+  buttonClassName,
+  contentClassName,
+}: FileDownloadButtonProps) => {
+  const [isDownloading, setIsDownloading] = useState(false);
+
+  const handleDownload = useCallback(async () => {
+    if (!fileFetchRequest) return;
+
+    try {
+      setIsDownloading(true);
+
+      const blob = await fileFetchRequest();
+
+      const objectUrl = window.URL.createObjectURL(blob);
+
+      const anchor = document.createElement('a');
+      anchor.href = objectUrl;
+      if (fileName) {
+        anchor.download = fileName;
+      }
+      anchor.click();
+      window.URL.revokeObjectURL(objectUrl);
+      onSuccess?.(blob, fileType);
+    } catch (error) {
+      onError?.(error, fileType);
+      // In real projects, replace this with centralized error reporting (e.g. Sentry)
+      console.error('[FileDownloadButton] Download failed:', error);
+    } finally {
+      setIsDownloading(false);
+    }
+  }, [fileFetchRequest, fileName, fileType, onSuccess, onError]);
+
+  return (
+    <Button
+      variant="contained"
+      onClick={handleDownload}
+      disabled={disabled || isDownloading}
+      startIcon={isDownloading ? <CircularProgress size={16} /> : null}
+      className={buttonClassName}
+    >
+      <span className={contentClassName}>{children ?? label}</span>
+    </Button>
+  );
+};

packages/frontend-core/src/components/index.ts

@@ -1 +1,2 @@
 export { I18nSwitch } from './I18nSwitch';
+export { FileDownloadButton } from './FileDownloadButton';

packages/i18n/locales/de-DE.json

@@ -158,7 +158,8 @@
         "desc": "Teile deine Rettungsgeschichte auf PawHaven, damit mehr Menschen helfen können."
       }
     ],
-    "download_guide": "Laden Sie die Details des Rettungsleitfadens herunter"
+    "download_guide": "Laden Sie die Details des Rettungsleitfadens herunter",
+    "download_failed": "Download fehlgeschlagen. Bitte versuchen Sie es erneut."
   },
   "errorMessage": {
     "TOKEN_EXPIRED": "Ihre Sitzung ist abgelaufen. Bitte melden Sie sich erneut an.",

packages/i18n/locales/en-US.json

@@ -158,7 +158,8 @@
         "desc": "Record and share your rescue story on PawHaven to help connect more volunteers."
       }
     ],
-    "download_guide": "Download the details of the rescue guide"
+    "download_guide": "Download the details of the rescue guide",
+    "download_failed": "Download failed. Please try again."
   },
   "errorMessage": {
     "TOKEN_EXPIRED": "Your session has expired. Please log in again.",