discovery-media-player 0.1.129 → 0.1.130

package/docs/README.md

@@ -17,6 +17,7 @@ no document assumes you have read the others.
 |---|---|
 | [`CONFIGURATION.md`](CONFIGURATION.md) | Every environment variable. An instance is described entirely by its environment — there is no configuration file, on purpose. |
 | [`MIGRATIONS.md`](MIGRATIONS.md) | What happens to a database **already in service** when the player expects a newer schema. (French.) |
+| [`VERIFYING-RELEASES.md`](VERIFYING-RELEASES.md) | how to check, yourself, that the package or image you pulled is the one this repository built — the commands, the expected output, and which signing identity to expect. |
 | [`RETENTION.md`](RETENTION.md) | The declared perimeter of data retention: every personal-data column has a written policy, and CI enforces that the list is complete. Also an export of the package: `require.resolve("discovery-media-player/retention")`. |
 
 ## You are contributing, or publishing a version
@@ -26,6 +27,9 @@ no document assumes you have read the others.
 | [`../CONTRIBUTING.md`](../CONTRIBUTING.md) | how to run the benches, what review looks for, and the one rule: a behaviour worth keeping is worth a test that fails without it. |
 | [`../AGENTS.md`](../AGENTS.md) | the conventions that are not obvious from the file tree — which ones a guard enforces, and which ones only review does. |
 | [`RELEASING.md`](RELEASING.md) | the release train, freezing the candidate SHA, the read-only preflight to run **before** the tag, and what to do when a tag lands on the wrong commit. |
+| [`DEPENDENCIES.md`](DEPENDENCIES.md) | what the project depends on and why so little of it: the bar a new dependency has to clear, how updates arrive, the two upgrades deliberately held back, and the vulnerability thresholds a change has to clear to merge. |
+| [`SECURITY-PRACTICES.md`](SECURITY-PRACTICES.md) | the two standing policies: how secrets are handled (there are no long-lived ones, on purpose) and what happens when a security tool reports something. |
+| [`../MAINTAINERS.md`](../MAINTAINERS.md) | who can merge, who can publish, who reads a vulnerability report — and what one maintainer means for the answer. |
 
 ## You are evaluating the project
 
@@ -35,6 +39,7 @@ tracked version by version in the [CHANGELOG](../CHANGELOG.md).
 
 | Document | What it is |
 |---|---|
+| [`THREAT-MODEL.md`](THREAT-MODEL.md) | what an attacker would go after, what stands in the way, and — the part most threat models omit — what is deliberately left standing. |
 | [`AUDIT-2026-08-14-RAPPORT.md`](AUDIT-2026-08-14-RAPPORT.md) | First external audit, on `0.1.17`. Historical. (French.) |
 | [`AUDIT-2026-08-14-SUIVI.md`](AUDIT-2026-08-14-SUIVI.md) | The follow-up ledger: done, decided-but-not-done, and rejected-with-reason. Historical. (French.) |
 | [`AUDIT-2026-08-15-SECONDE-PASSE.md`](AUDIT-2026-08-15-SECONDE-PASSE.md) | Second pass, on `0.1.26` — including what the first follow-up had marked too optimistically. Historical. (French.) |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discovery-media-player",
-  "version": "0.1.129",
+  "version": "0.1.130",
   "description": "Self-hosted document viewer: per-recipient tracked links, reading analytics, live presentation. The core knows nothing about the application hosting it — everything it borrows arrives through an injected context.",
   "keywords": [
     "pdf-viewer",

package/server/presentations.js

@@ -828,7 +828,10 @@ function signatureAbsente(erreur) {
   if (!erreur) return false;
   const code = erreur.details && (erreur.details.code || (erreur.details.error && erreur.details.error.code));
   if (code === "PGRST202") return true;
-  const texte = String((erreur && erreur.message) || "");
+  // ⚠️ PAS DE `erreur &&` ICI : la garde de la première ligne l'a déjà tranché. Le garder ne
+  // protégeait de rien et APPRENAIT AU LECTEUR QUE `erreur` PEUT ÊTRE NULLE À CET ENDROIT — ce qui
+  // est faux. Un test qui ne peut pas échouer ne coûte pas un cycle, il coûte une lecture.
+  const texte = String(erreur.message || "");
   return texte.includes("PGRST202") || /Could not find the function/i.test(texte);
 }
 
@@ -1138,12 +1141,17 @@ async function recordAttendance(slug, participant, { presentation = null, ipHash
     presentateurEcrit = presentateurEcrit
       || (controlHash != null && relu.control_hash != null && controlHash === relu.control_hash);
   }
-  let cur = null;
+  // ⚠️ ON RELIT À CHAQUE TOUR — ET C'EST DÉJÀ CE QUI SE PASSAIT. La lecture était gardée par un
+  // `if (cur === null)` qui ne pouvait JAMAIS être faux : les deux seuls chemins qui rebouclent
+  // (un 409 à la création, une écriture battue en vol) remettaient `cur` à null juste avant. La
+  // condition décrivait une intention — « ne relis que si tu n'as pas d'état frais » — que le code
+  // ne pouvait pas contredire. Signalée par le scan (#78), et il a raison : une branche morte
+  // laisse croire qu'il existe un cas où l'on repart avec un état déjà lu. Il n'y en a pas, et il
+  // ne DOIT pas y en avoir : rejouer sur un état périmé est précisément ce que la serrure
+  // `last_seen` interdit.
   for (let essai = 0; essai < 4; essai += 1) {
-    if (cur === null) {
-      const rows = await PLAYER.db.request(`doc_presentation_attendees?slug=eq.${enc(slug)}&attendee_key=eq.${enc(String(key))}&select=*&limit=1`);
-      cur = (Array.isArray(rows) && rows[0]) || false;
-    }
+    const rows = await PLAYER.db.request(`doc_presentation_attendees?slug=eq.${enc(slug)}&attendee_key=eq.${enc(String(key))}&select=*&limit=1`);
+    let cur = (Array.isArray(rows) && rows[0]) || false;
     if (!cur) {
       const now = Date.now();
       const row = { slug: String(slug), attendee_key: String(key).slice(0, 200), name: (name || "").slice(0, 120) || null, email: lc(email) || null, avatar: (avatar || "").slice(0, 600) || null, is_member: !!isMember, is_presenter: presentateurEcrit, first_seen: new Date(now).toISOString(), last_seen: new Date(now).toISOString(), total_ms: 0, pages: [pageEcrite] };
@@ -1159,8 +1167,7 @@ async function recordAttendance(slug, participant, { presentation = null, ipHash
         // Journalisé comme bénin : deux onglets qui arrivent ensemble sont une information, pas
         // une panne — et la garde des écritures muettes exige que tout rattrapage parle.
         try { PLAYER.errors.capture(new Error("présence déjà ouverte (second onglet) : " + String(slug)), { route: "present-attend", benin: true }); } catch { /* jamais bloquant */ }
-        cur = null;
-        continue;
+        continue;   // le tour suivant relit : la ligne que l'autre onglet vient de créer
       }
     }
     // ⚠️ UN `last_seen` ACCEPTÉ EST STRICTEMENT CROISSANT — sans ça, la serrure est aveugle dans
@@ -1184,7 +1191,7 @@ async function recordAttendance(slug, participant, { presentation = null, ipHash
         is_member: !!isMember, is_presenter: presentateurEcrit },
     );
     if (ecrit) return { ok: true };
-    cur = null;   // battu en vol : on relira l'état frais au tour suivant
+    // battu en vol : le tour suivant relit l'état frais — c'est la lecture en tête de boucle
   }
   // Quatre tours perdus : un battement de présence se reperd sans conséquence — le suivant arrive
   // dans quelques secondes. Refuser net plutôt qu'écraser ce que les gagnants viennent d'écrire.

package/server/routes-agent.js

@@ -106,8 +106,35 @@ async function traiter(req, res, body, _slug) {
           if (body.action === "bot-rate") { // satisfaction (1-5 étoiles) posée depuis le bloc central du viewer
             const sess = await docbot.getSession(String(body.sessionId || ""));
             if (!sess || sess.share_slug !== share.slug) return jp(400, { ok: false, error: "session" });
-            const note = Math.max(1, Math.min(5, Number(body.rating) || 0));
-            if (!note) return jp(400, { ok: false, error: "rating" });
+            // ⚠️ CE REFUS ÉTAIT INATTEIGNABLE, ET C'EST LA MESURE QUI EN PAYAIT LE PRIX.
+            //
+            //     const note = Math.max(1, Math.min(5, Number(body.rating) || 0));
+            //     if (!note) return jp(400, { ok: false, error: "rating" });
+            //
+            // `Math.max(1, …)` posait un PLANCHER à 1 : `note` valait toujours au moins 1, donc
+            // `!note` n'était jamais vrai et la ligne suivante ne s'exécutait jamais. Une notation
+            // SANS note — champ absent, `null`, `"abc"`, un double envoi du client — n'était pas
+            // refusée : elle enregistrait **1 étoile**, la pire du barème. La satisfaction mesurée
+            // baissait donc d'elle-même à chaque appel malformé, et rien dans le chiffre ne
+            // permettait de le voir.
+            //
+            // C'est la règle que ce dépôt applique déjà au temps de lecture, une couche plus haut :
+            // « une métrique qui dit le contraire est la première que les gens cessent de croire ».
+            // Une note absente n'est pas une mauvaise note, c'est une absence — et elle se refuse.
+            //
+            // ⚠️ TROUVÉ EN CHERCHANT À EXERCER LA BRANCHE, pas en lisant le code. Le refus était
+            // écrit, donc il avait l'air tenu ; il a fallu écrire le test qui l'atteint pour
+            // constater qu'aucune entrée n'y arrivait.
+            //
+            // ⚠️ `Math.round` PARCE QUE LA COLONNE EST `smallint`. `3.7` traversait la garde intact
+            // et partait tel quel vers PostgREST : l'arrondi se décidait en aval, hors de vue. Le
+            // plafond à 5 reste, lui — un clic sur une sixième étoile est un défaut d'interface,
+            // pas une tentative, et le ramener à 5 est ce que l'appelant voulait dire.
+            //
+            // `!(note >= 1)` plutôt que `!note` : la forme rend faux pour `NaN` sans s'en remettre
+            // au `|| 0` qui le précède, donc elle survit à un changement de la ligne d'au-dessus.
+            const note = Math.min(5, Math.round(Number(body.rating) || 0));
+            if (!(note >= 1)) return jp(400, { ok: false, error: "rating" });
             const cmt = String(body.comment || "").trim().slice(0, 500); // mot facultatif (2e temps du bloc)
             await PLAYER.db.request("doc_bot_sessions?id=eq." + encodeURIComponent(String(body.sessionId)), { method: "PATCH", headers: { Prefer: "return=minimal" }, body: cmt ? { rating: note, rating_comment: cmt } : { rating: note } });
             return jp(200, { ok: true });