@open3cl/engine 1.8.5 → 1.8.7

package/2021_04_13_qualite_isolation.js

@@ -115,6 +115,13 @@ export default function calc_qualite_isolation(enveloppe, dp) {
     0
   );
 
+  /**
+   * Ubat = coefficient de transmission surfacique moyen de l'enveloppe (W/m².K).
+   * Il ne prend en compte QUE les déperditions par les parois et les ponts thermiques :
+   * les déperditions par renouvellement d'air (DR) sont volontairement exclues
+   * (cf. issue #45).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe 8 (indicateurs de qualité d'isolation)
+   */
   const deperdition =
     dp.deperdition_mur +
     dp.deperdition_plancher_bas +

package/2021_04_13_qualite_isolation.spec.js

@@ -4,9 +4,8 @@ import { describe, expect, test } from 'vitest';
  * Module purement calculatoire (aucune dépendance externe) : on teste
  * directement les seuils de qualité et l'agrégation des déperditions.
  */
-const { default: calc_qualite_isolation, qualite_isol } = await import(
-  './2021_04_13_qualite_isolation.js'
-);
+const { default: calc_qualite_isolation, qualite_isol } =
+  await import('./2021_04_13_qualite_isolation.js');
 
 /**
  * Qualité de l'isolation
@@ -121,6 +120,39 @@ describe('calc_qualite_isolation - agrégation et classement', () => {
     expect(ret.qualite_isol_plancher_haut_comble_amenage).toBe(2); // U = 0.2
   });
 
+  /**
+   * Ubat est un coefficient de transmission surfacique moyen : il exclut les
+   * déperditions par renouvellement d'air (DR).
+   * @see : Methode_de_calcul_3CL_DPE_2021-338.pdf - annexe 8 / issue #45
+   */
+  test("les déperditions par renouvellement d'air (DR) ne sont pas prises en compte dans ubat", () => {
+    const env = enveloppe({
+      murs: [mur({ surface: 100, umur: 0.5 })],
+      pb: [plancherBas({ surface: 50, upb: 0.4 })],
+      ph: [plancherHaut({ surface: 30, uph: 0.2 })],
+      bv: [baie({ surface: 20, u: 2 })],
+      portes: [porte({ surface: 5, u: 2 })]
+    });
+    const dpSansDr = {
+      deperdition_mur: 50,
+      deperdition_plancher_bas: 20,
+      deperdition_plancher_haut: 6,
+      deperdition_baie_vitree: 40,
+      deperdition_porte: 10,
+      deperdition_pont_thermique: 10
+    };
+    const dpAvecDr = { ...dpSansDr, deperdition_renouvellement_air: 60 };
+
+    const sansDr = calc_qualite_isolation(env, dpSansDr);
+    const avecDr = calc_qualite_isolation(env, dpAvecDr);
+
+    // ubat = 136 / 205 dans les deux cas ; en incluant DR il vaudrait (136 + 60) / 205 ≈ 0.956
+    expect(avecDr.ubat).toBeCloseTo(136 / 205, 9);
+    expect(avecDr.ubat).toBe(sansDr.ubat);
+    // la classe d'isolation de l'enveloppe reste « moyenne » (3) et ne bascule pas en 4
+    expect(avecDr.qualite_isol_enveloppe).toBe(3);
+  });
+
   test('les locaux non déperditifs (adjacence 22) sont exclus des murs et planchers bas', () => {
     const env = enveloppe({
       murs: [mur({ surface: 100, umur: 0.5 }), mur({ adjacence: '22', surface: 999, umur: 9 })],

package/README.md

@@ -370,28 +370,28 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <!-- CORPUS:START -->
 
-> **Version `1.8.1`** · à publier · branche `main` · généré le 2026-10-01
+> **Version `1.8.5`** · à publier · branche `main` · généré le 2026-10-01
 > Seuil de tolérance **5%**
 
 <table>
 <tr>
 <td align="center"><strong>9</strong><br/><sub>corpus</sub></td>
 <td align="center"><strong>89 990</strong><br/><sub>DPE analysés</sub></td>
-<td align="center"><strong>59 630</strong><br/><sub>DPE conformes</sub></td>
-<td align="center"><strong>66,26 %</strong><br/><sub>réussite globale</sub></td>
+<td align="center"><strong>59 740</strong><br/><sub>DPE conformes</sub></td>
+<td align="center"><strong>66,39 %</strong><br/><sub>réussite globale</sub></td>
 </tr>
 </table>
 
 |     | Corpus                                                                                                                  |    Réussite |                        |  DPE conformes |
 | :-: | :---------------------------------------------------------------------------------------------------------------------- | ----------: | :--------------------- | -------------: |
-| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,11 %** | `█████████░░░░░░░░░░░` | 4 611 / 10 000 |
-| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **91,69 %** | `██████████████████░░` | 9 169 / 10 000 |
-| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **88,19 %** | `██████████████████░░` |  8 812 / 9 992 |
-| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,02 %** | `██████████████████░░` | 8 802 / 10 000 |
-| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **74,08 %** | `███████████████░░░░░` |  7 407 / 9 999 |
-| 🟡  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **69,67 %** | `██████████████░░░░░░` | 6 967 / 10 000 |
-| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **62,42 %** | `████████████░░░░░░░░` |  6 241 / 9 999 |
-| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **48,82 %** | `██████████░░░░░░░░░░` | 4 882 / 10 000 |
+| 🔴  | **Généraliste**<br/><sub>`corpus_dpe.csv`</sub>                                                                         | **46,23 %** | `█████████░░░░░░░░░░░` | 4 623 / 10 000 |
+| 🟢  | **Appartement · chauffage individuel (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_individuel_2025.csv`</sub> | **91,76 %** | `██████████████████░░` | 9 176 / 10 000 |
+| 🟢  | **Logement individuel (2025)**<br/><sub>`dpe_logement_individuel_2025.csv`</sub>                                        | **88,40 %** | `██████████████████░░` |  8 833 / 9 992 |
+| 🟢  | **Maison individuelle (2025)**<br/><sub>`dpe_maison_individuelle_2025.csv`</sub>                                        | **88,38 %** | `██████████████████░░` | 8 838 / 10 000 |
+| 🟡  | **Immeuble · chauffage individuel**<br/><sub>`dpe_immeuble_chauffage_individuel.csv`</sub>                              | **74,11 %** | `███████████████░░░░░` |  7 410 / 9 999 |
+| 🟡  | **Appartement · chauffage collectif (2025)**<br/><sub>`dpe_appartement_individuel_chauffage_collectif_2025.csv`</sub>   | **69,74 %** | `██████████████░░░░░░` | 6 974 / 10 000 |
+| 🟡  | **Immeuble · chauffage collectif**<br/><sub>`dpe_immeuble_chauffage_collectif.csv`</sub>                                | **62,44 %** | `████████████░░░░░░░░` |  6 243 / 9 999 |
+| 🔴  | **Immeuble · chauffage mixte**<br/><sub>`dpe_immeuble_chauffage_mixte.csv`</sub>                                        | **49,04 %** | `██████████░░░░░░░░░░` | 4 904 / 10 000 |
 | 🔴  | **Individuel généré depuis l'immeuble (2026)**<br/><sub>`dpe_individuel_a_partir_dpe_immeuble_2026.csv`</sub>           | **27,39 %** | `█████░░░░░░░░░░░░░░░` | 2 739 / 10 000 |
 
 <sub>🟢 ≥ 85 % · 🟡 ≥ 60 % · 🔴 < 60 %</sub>
@@ -403,24 +403,24 @@ Ces résultats sont **générés automatiquement** à la fin de `npm run test:co
 
 <table>
 <tr>
-<td align="center"><strong>4,88 ms</strong><br/><sub>moyenne</sub></td>
-<td align="center"><strong>4,26 ms</strong><br/><sub>médiane</sub></td>
-<td align="center"><strong>0,11 ms</strong><br/><sub>min</sub></td>
-<td align="center"><strong>891,4 ms</strong><br/><sub>max</sub></td>
+<td align="center"><strong>4,99 ms</strong><br/><sub>moyenne</sub></td>
+<td align="center"><strong>4,34 ms</strong><br/><sub>médiane</sub></td>
+<td align="center"><strong>0,12 ms</strong><br/><sub>min</sub></td>
+<td align="center"><strong>795,0 ms</strong><br/><sub>max</sub></td>
 </tr>
 </table>
 
 | Corpus                                         | Moyenne | Médiane |     Min |      Max |     p95 |     p99 |
 | :--------------------------------------------- | ------: | ------: | ------: | -------: | ------: | ------: |
-| **Généraliste**                                | 3,65 ms | 3,28 ms | 0,21 ms |  29,7 ms | 6,67 ms | 8,87 ms |
-| **Appartement · chauffage individuel (2025)**  | 3,54 ms | 3,23 ms | 1,09 ms |  24,6 ms | 6,11 ms | 8,02 ms |
-| **Logement individuel (2025)**                 | 4,89 ms | 4,37 ms | 1,41 ms |  39,4 ms | 9,35 ms | 12,7 ms |
-| **Maison individuelle (2025)**                 | 5,30 ms | 4,73 ms | 1,69 ms |  39,6 ms | 9,54 ms | 13,0 ms |
-| **Immeuble · chauffage individuel**            | 5,64 ms | 4,78 ms | 0,11 ms |  76,2 ms | 11,4 ms | 17,8 ms |
-| **Appartement · chauffage collectif (2025)**   | 3,92 ms | 3,56 ms | 1,18 ms |  32,4 ms | 6,59 ms | 9,44 ms |
-| **Immeuble · chauffage collectif**             | 5,56 ms | 4,75 ms | 0,13 ms | 140,4 ms | 10,7 ms | 18,7 ms |
-| **Immeuble · chauffage mixte**                 | 5,41 ms | 4,41 ms | 0,19 ms | 891,4 ms | 11,0 ms | 18,0 ms |
-| **Individuel généré depuis l'immeuble (2026)** | 6,04 ms | 5,26 ms | 1,65 ms |  64,0 ms | 11,5 ms | 17,8 ms |
+| **Généraliste**                                | 4,35 ms | 3,85 ms | 0,20 ms |  33,1 ms | 8,16 ms | 12,1 ms |
+| **Appartement · chauffage individuel (2025)**  | 3,41 ms | 3,06 ms | 1,22 ms |  28,0 ms | 6,11 ms | 8,14 ms |
+| **Logement individuel (2025)**                 | 4,94 ms | 4,40 ms | 1,34 ms |  39,1 ms | 9,35 ms | 13,0 ms |
+| **Maison individuelle (2025)**                 | 5,73 ms | 5,16 ms | 1,68 ms |  46,0 ms | 10,3 ms | 14,4 ms |
+| **Immeuble · chauffage individuel**            | 6,80 ms | 5,84 ms | 0,17 ms | 103,2 ms | 13,6 ms | 21,9 ms |
+| **Appartement · chauffage collectif (2025)**   | 3,94 ms | 3,59 ms | 1,28 ms |  32,1 ms | 6,56 ms | 8,87 ms |
+| **Immeuble · chauffage collectif**             | 5,42 ms | 4,60 ms | 0,12 ms | 107,9 ms | 10,3 ms | 17,0 ms |
+| **Immeuble · chauffage mixte**                 | 5,14 ms | 4,17 ms | 0,19 ms | 795,0 ms | 10,7 ms | 17,3 ms |
+| **Individuel généré depuis l'immeuble (2026)** | 5,14 ms | 4,41 ms | 1,54 ms |  44,0 ms | 9,66 ms | 14,5 ms |
 
 <sub>La moyenne est tirée vers le haut par les DPE collectifs, dont le coût atteint plusieurs
 dizaines de fois la médiane : c’est la médiane qui décrit le cas courant, et p95/p99 le cas

package/core/file/infrastructure/adapter/file.store.js

@@ -10,7 +10,11 @@ export class FileStore {
    * @return {Promise<any>}
    */
   async downloadXlsxFileAndConvertToJson(url) {
-    return fetch(url)
+    const parsedUrl = new URL(url);
+    if (!['http:', 'https:'].includes(parsedUrl.protocol)) {
+      throw new Error(`Unsupported protocol for url: ${url}`);
+    }
+    return fetch(parsedUrl)
       .then((res) => res.arrayBuffer())
       .then((buffer) =>
         this.#excelWorkBookToJson(XLSX.read(buffer, { type: 'string', raw: false }))

package/core/file/infrastructure/adapter/file.store.spec.js

@@ -39,6 +39,7 @@ describe('FileStore', () => {
     vi.mocked(XLSX.utils.sheet_to_json).mockReset();
     vi.mocked(XLSX.utils.encode_col).mockClear();
     vi.mocked(XLSX.utils.encode_row).mockClear();
+    vi.mocked(global.fetch).mockClear();
 
     // Comportements par défaut « nominaux ».
     vi.mocked(readFile).mockImplementation((path, cb) => cb(null, Buffer.from(new ArrayBuffer(1))));
@@ -57,13 +58,44 @@ describe('FileStore', () => {
       const output = await fileStore.downloadXlsxFileAndConvertToJson('http://localhost:8080');
 
       expect(output).toEqual({ Sheet1: [] });
-      // Le buffer téléchargé est lu par XLSX avec les bonnes options.
-      expect(fetch).toHaveBeenCalledWith('http://localhost:8080');
+      // La protection CWE-918 construit une véritable instance `URL` (validée) avant l'appel à
+      // `fetch` : on vérifie le type et le `href` réel plutôt qu'une égalité de chaîne, car
+      // `new URL()` normalise l'URL (ajout du `/` final).
+      expect(fetch).toHaveBeenCalledTimes(1);
+      const [urlArgument] = vi.mocked(fetch).mock.calls[0];
+      expect(urlArgument).toBeInstanceOf(URL);
+      expect(urlArgument.href).toBe('http://localhost:8080/');
       expect(XLSX.read).toHaveBeenCalledWith(expect.anything(), {
         type: 'string',
         raw: false
       });
     });
+
+    describe('validation du protocole (CWE-918)', () => {
+      test.each(['http://localhost:8080', 'https://localhost:8080'])(
+        'accepte les URLs avec le protocole %s',
+        async (url) => {
+          const fileStore = new FileStore();
+
+          await expect(fileStore.downloadXlsxFileAndConvertToJson(url)).resolves.toEqual({
+            Sheet1: []
+          });
+
+          expect(fetch).toHaveBeenCalledTimes(1);
+        }
+      );
+
+      test("rejette une URL avec un protocole non http/https (ex. file://) et n'appelle pas fetch", async () => {
+        const fileStore = new FileStore();
+        const url = 'file:///etc/passwd';
+
+        await expect(fileStore.downloadXlsxFileAndConvertToJson(url)).rejects.toThrow(
+          `Unsupported protocol for url: ${url}`
+        );
+
+        expect(fetch).not.toHaveBeenCalled();
+      });
+    });
   });
 
   describe('readLocalOdsFileAndConvertToJson', () => {

package/engine.js

@@ -33,7 +33,7 @@ import getFicheTechnique from './ficheTechnique.js';
 import { ProductionENR } from './16.2_production_enr.js';
 import DpeSanitizerService from './dpe-sanitizer.service.js';
 
-const LIB_VERSION = '1.8.5';
+const LIB_VERSION = '1.8.7';
 
 const dpeSanitizerService = new DpeSanitizerService();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open3cl/engine",
-  "version": "1.8.5",
+  "version": "1.8.7",
   "description": "Open Source 3CL-DPE engine",
   "main": "index.js",
   "directories": {