discovery-media-player 0.1.131 → 0.1.133

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discovery-media-player",
-  "version": "0.1.131",
+  "version": "0.1.133",
   "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/retention.js

@@ -124,6 +124,30 @@ async function retirerFichier(chemin, opts) {
 // au RESTE du plafond (`min(taille, plafond - examinees)`) pour ne jamais le dépasser. Et on
 // compte les lignes RENDUES par le DELETE (`return=representation&select=id`), pas les ids
 // présélectionnés : deux exécutions concurrentes n'annoncent pas deux fois la même suppression.
+/**
+ * « Cette table n'existe pas ici » — et RIEN d'autre.
+ *
+ * ⚠️ UNE CIBLE DE PURGE PEUT LÉGITIMEMENT MANQUER, LE CONTRAT LE DIT. `docs/HOST-CONTRACT.md` :
+ * les migrations de débit « ne sont délibérément pas » dans le périmètre de la carte, parce
+ * qu'« un hôte peut fournir sa propre capacité `limits`, et sur un tel hôte leur absence est
+ * NORMALE, pas un défaut ». Le balayage, lui, purgeait `player_rate_limits` sans condition — donc
+ * sur cet hôte-là il levait à la cinquième cible sur huit, et les liens révoqués comme les
+ * présentations n'étaient JAMAIS atteints. Enveloppé dans un `catch` qui le classe bénin, il
+ * restait armé, silencieux, et partiellement inopérant : le pire des trois états.
+ *
+ * ⚠️ AUSSI ÉTROIT QUE `signatureAbsente`, ET POUR LA MÊME RAISON. On accepte le code PostgREST de la
+ * table introuvable, ou son message — et rien d'autre. Un 404 seul ne suffit pas : il peut venir
+ * d'ailleurs, et avaler une vraie panne ferait de ce correctif une purge qui ne purge plus sans le
+ * dire, c'est-à-dire exactement ce qu'il corrige.
+ */
+function tableAbsente(erreur) {
+  if (!erreur) return false;
+  const code = erreur.details && (erreur.details.code || (erreur.details.error && erreur.details.error.code));
+  if (code === "PGRST205") return true;
+  const texte = String(erreur.message || "");
+  return texte.includes("PGRST205") || /Could not find the table/i.test(texte);
+}
+
 async function purgerParLots(table, filtre, colId, { dryRun = false, taille = LOT, plafond = PLAFOND } = {}, plafondForce) {
   if (plafondForce !== undefined) plafond = plafondForce;
   let examinees = 0, supprimees = 0, tronque = false, curseur = null;
@@ -200,7 +224,15 @@ async function purgerRetention(now, optsBrutes = {}) {
   rapport.commercial_doc_sessions = await purgerParLots("commercial_doc_sessions", `last_at=lt.${enc(bJournaux)}`, "session_id", opts);
   rapport.commercial_doc_internal_sessions = await purgerParLots("commercial_doc_internal_sessions", `last_at=lt.${enc(bJournaux)}`, "session_id", opts);
   rapport.doc_bot_sessions = await purgerParLots("doc_bot_sessions", `last_at=lt.${enc(bJournaux)}`, "id", opts);
-  rapport.player_rate_limits = await purgerParLots("player_rate_limits", `expires_at=lt.${enc(new Date(now).toISOString())}`, "key", opts);
+  // ⚠️ LA SEULE CIBLE QUE LE CONTRAT REND OPTIONNELLE — et le balayage la traitait comme les autres.
+  // Son absence est normale sur un hôte qui fournit sa propre capacité `limits` ; elle ne doit donc
+  // pas interrompre les trois cibles qui suivent. Sautée, ET DITE : un rapport qui omettrait la
+  // ligne se lirait comme « rien à supprimer », ce qui est une autre affirmation.
+  rapport.player_rate_limits = await purgerParLots("player_rate_limits", `expires_at=lt.${enc(new Date(now).toISOString())}`, "key", opts)
+    .catch((e) => {
+      if (!tableAbsente(e)) throw e;
+      return { examinees: 0, supprimees: 0, tronque: false, sautee: "table absente — l'hôte fournit ses propres compteurs de débit" };
+    });
 
   // Liens révoqués : seulement là où la révocation est DATÉE (0013).
   const dateDispo = await require("./schema").attendue("revocationDatee");

package/server/routes-agent.js

@@ -12,6 +12,16 @@ const init = (ctx) => { PLAYER = ctx; docbot = ctx.plugins.bot; };
 // chute au bout rend `false` et le dispatch continue. Aucune liste d'actions n'est dupliquée
 // entre ici et handler (un correctif à deux exemplaires finit par diverger) — et aucun appui
 // sur res.writableEnded, absent des `res` postiches des bancs comme de certains hôtes.
+
+/**
+ * Les actions qui AGISSENT SUR UNE SESSION EXISTANTE — c'est-à-dire toutes celles du bloc assistant
+ * sauf `bot-start`, qui la crée. La liste vit ici plutôt que dans chaque branche pour que le banc
+ * puisse la CONFRONTER à l'aiguillage : une action ajoutée à l'un et pas à l'autre fait rougir.
+ */
+const ACTIONS_LIEES_A_UNE_SESSION = new Set([
+  "bot-say", "bot-history", "bot-nudge", "bot-book", "bot-contact", "bot-rate", "bot-script",
+]);
+
 async function traiter(req, res, body, _slug) {
       if (body.action === "bot-tts") {
         const jp = (status, obj) => { res.statusCode = status; res.setHeader("Content-Type", "application/json"); res.end(JSON.stringify(obj)); };
@@ -101,11 +111,38 @@ async function traiter(req, res, body, _slug) {
           if (!allowed) return jp(429, { ok: false, error: "rate" });
           const share = await getShareBySlug(String(body.slug || ""));
           if (!share || !share.bot_enabled) return jp(404, { ok: false, error: "bot" });
+          // ⚠️ UNE SESSION EST LIÉE À SON DOCUMENT — VÉRIFIÉ ICI, POUR TOUTES LES ACTIONS À LA FOIS.
+          //
+          // Cette vérification vivait DANS chaque action, et trois seulement sur sept la faisaient :
+          // `bot-rate`, `bot-script` et `bot-history` (celle-ci ajoutée après coup, en 0.1.131).
+          // `bot-say`, `bot-nudge`, `bot-book` et `bot-contact` prenaient le même `sessionId` venu du
+          // client sans jamais le rattacher au document demandé.
+          //
+          // ⚠️ CE QUE ÇA OUVRAIT EST PIRE QUE CE QU'ON VENAIT DE FERMER. `bot-history` LISAIT la
+          // conversation d'un autre document ; `bot-say` y ÉCRIT et se fait répondre, `bot-contact`
+          // attache un nom, un e-mail et un téléphone à la session d'un autre client. Une porte en
+          // lecture et quatre en écriture, dans le même bloc.
+          //
+          // ⚠️ ET LA LEÇON N'EST PAS « IL EN MANQUAIT QUATRE ». Écrite sept fois, cette garde serait
+          // oubliée une huitième au prochain ajout — le défaut n'est pas la ligne absente, c'est que
+          // sa présence dépende de la mémoire de celui qui écrit l'action. Elle est donc hissée : une
+          // action qui porte une session la prouve, sans que son auteur ait à y penser.
+          //
+          // Le relevé qui a mené ici vient d'un exploitant : « une vérification que plusieurs actions
+          // font chacune pour son compte — il faut compter les ACTIONS, pas les implémentations ».
+          // La duplication était homogène, donc invisible à un balayage des variantes ; c'est la
+          // COUVERTURE qui divergeait, et rien ne la mesurait. `gardesAgent.test.js` la mesure
+          // désormais, en lisant la liste d'actions dans ce fichier même.
+          //
+          // ⚠️ `bot-start` EST EXCLUE, ET C'EST LA SEULE. Elle CRÉE la session : exiger qu'elle en
+          // prouve une fermerait l'assistant à tout le monde.
+          if (ACTIONS_LIEES_A_UNE_SESSION.has(body.action)) {
+            const liee = await docbot.getSession(String(body.sessionId || ""));
+            if (!liee || liee.share_slug !== share.slug) return jp(400, { ok: false, error: "session" });
+          }
           const pages = Math.max(0, Math.min(500, Number(body.pages) || 0));
           const mobile = body.mobile === 1 || body.mobile === true; // téléphone → messages courts + autoplay steps
           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" });
             // ⚠️ 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));
@@ -155,8 +192,6 @@ async function traiter(req, res, body, _slug) {
             //
             // Les deux voisines avaient la garde ET leur banc ; celle-ci n'avait ni l'une ni
             // l'autre, et la relecture qui a ajouté les bancs a couvert deux actions sur trois.
-            const sess = await docbot.getSession(String(body.sessionId || ""));
-            if (!sess || sess.share_slug !== share.slug) return jp(400, { ok: false, error: "session" });
             return jp(200, { ok: true, messages: await docbot.listMessages(String(body.sessionId || "")) });
           }
           // ⚠️ Même piège : un objet littéral répond à `constructor`. Sans `Object.hasOwn`, une
@@ -168,8 +203,6 @@ async function traiter(req, res, body, _slug) {
           // Bascule de langue EN COURS de présentation : renvoie le script (traduit ou FR) — le client
           // remplace sa liste d'étapes et rejoue le message courant dans la nouvelle langue.
           if (body.action === "bot-script") {
-            const sess = await docbot.getSession(String(body.sessionId || ""));
-            if (!sess || sess.share_slug !== share.slug) return jp(400, { ok: false, error: "session" });
             const sp = docbot.applyPron(await docbot.scriptedPayload(share.doc_id, blang, String(body.sessionId)), await docbot.getProfile(share.bot_profile_id));
             if (!sp) return jp(400, { ok: false, error: "script" });
             return jp(200, { ok: true, steps: sp.steps, voiceScript: sp.voice, message: sp.hook, closing: sp.closing, messageSay: sp.hookSay, closingSay: sp.closingSay });