feat: 764 - Intégration S3 step 2

Author: achorein

.talismanrc

@@ -65,6 +65,8 @@ fileignoreconfig:
   checksum: ab7a0f54777521ceb0cf4f2f253cc6f804e24ad7e27015eb9d66961366510a12
 - filename: packages/backend/src/__tests__/usagers/authentification.test.ts
   checksum: c15d2aeea878e0da568caa3a14d4dc58287fad8ee1cd6d026626c38870e8bc47
+- filename: packages/backend/src/__tests__/usagers/documents.test.ts
+  checksum: d5d23d8aa40adf45f04cb47587350ba4c52423bb669307779f9be0254e77b695
 - filename: packages/backend/src/config.js
   checksum: 5e974a98e40b4f10974b9e57127b8b71e4abef208494d69218b17b3721453ada
 - filename: packages/backend/src/controllers/__tests__/bo-user/accept-cgu.test.js
@@ -117,6 +119,8 @@ fileignoreconfig:
   checksum: 84d16fbf7cf0433f833c790f360cda6c8d23c30fe580eec4a0e3851a2d0311b0
 - filename: packages/backend/src/services/Document.js
   checksum: 1fbeae31395935da7b8daef1d3872151b793d433d1cde968d0607b4628ba50a8
+- filename: packages/backend/src/services/Document.ts
+  checksum: de553578fc64b0d0cb39d80f3e095574aa67f72fafbb57c79a8121db6eba5f15
 - filename: packages/backend/src/services/Insee.js
   checksum: 8c067dbdd0a587b46905003d34a13df176fe03192253e881287c21577311f564
 - filename: packages/backend/src/services/Organisme.js

packages/backend/jest.setup.js

@@ -5,9 +5,12 @@
 //
 // This stays test-only (jest setup) to avoid impacting runtime behavior.
 const buffer = require("buffer");
+
 if (!buffer.SlowBuffer) {
   buffer.SlowBuffer = buffer.Buffer;
 }
 
 process.env.PG_VAO_CIPHER_DATA =
   "e14de305fbac8f2ed5ab96ce9659265625db31d01ea9d5b7a20b5f985612a054";
+
+// process.env.DEBUG = "*debug*";

packages/backend/package.json

@@ -51,8 +51,10 @@
     "@types/express": "^4.17.21",
     "@types/jest": "^29.5.12",
     "@types/jsonwebtoken": "^9.0.10",
+    "@types/multer": "^1.4.12",
     "@types/node": "^20.14.12",
     "@types/pg": "^8.15.5",
+    "@types/supertest": "^6.0.2",
     "eslint": "^8.57.1",
     "eslint-plugin-import": "^2.29.1",
     "eslint-plugin-prettier": "^5.1.3",
@@ -67,4 +69,4 @@
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.46.3"
   }
-}
+}

packages/backend/src/__tests__/admin/documents.test.ts

@@ -0,0 +1,82 @@
+import request from "supertest";
+
+import app from "../../app";
+import * as DocumentService from "../../services/Document";
+import {
+  createTestContainer,
+  removeTestContainer,
+} from "../helper/testContainer";
+
+const authUser = { id: 1, role: "admin" };
+
+jest.mock("../../middlewares/bo-check-JWT", () => {
+  return (req: any, _res: any, next: any) => {
+    req.decoded = authUser;
+    next();
+  };
+});
+
+jest.mock("../../services/Document", () => ({
+  getFile: jest.fn(),
+}));
+
+beforeAll(async () => {
+  await createTestContainer();
+});
+
+afterAll(async () => {
+  await removeTestContainer();
+});
+
+beforeEach(() => {
+  jest.clearAllMocks();
+});
+
+describe("GET /documents/admin/:uuid", () => {
+  it("devrait retourner 404 si le fichier n'existe pas", async () => {
+    (DocumentService.getFile as jest.Mock).mockResolvedValue(null);
+
+    const response = await request(app).get(
+      "/documents/admin/550e8400-e29b-41d4-a716-446655440000",
+    );
+
+    expect(response.status).toBe(404);
+    expect(DocumentService.getFile).toHaveBeenCalledWith(
+      "550e8400-e29b-41d4-a716-446655440000",
+    );
+  });
+
+  it("devrait retourner le fichier avec les bons headers", async () => {
+    const fileContent = Buffer.from("contenu admin du fichier");
+    (DocumentService.getFile as jest.Mock).mockResolvedValue({
+      category: "declaration",
+      file: fileContent,
+      filename: "document-admin.pdf",
+      mimeType: "application/pdf",
+      userId: String(authUser.id),
+      uuid: "550e8400-e29b-41d4-a716-446655440000",
+    });
+
+    const response = await request(app).get(
+      "/documents/admin/550e8400-e29b-41d4-a716-446655440000",
+    );
+
+    expect(response.status).toBe(200);
+    expect(response.headers["content-disposition"]).toBe(
+      "attachment; filename=document-admin.pdf",
+    );
+    expect(response.headers["content-type"]).toContain("text/plain");
+    expect(response.text).toBe("contenu admin du fichier");
+  });
+
+  it("devrait propager l'erreur si getFile échoue", async () => {
+    const error = new Error("Erreur S3");
+    (DocumentService.getFile as jest.Mock).mockRejectedValue(error);
+
+    const response = await request(app).get(
+      "/documents/admin/550e8400-e29b-41d4-a716-446655440000",
+    );
+
+    expect(response.status).toBe(500);
+  });
+});