discovery-media-player 0.1.3 → 0.1.4

package/README.md

@@ -87,6 +87,9 @@ forking it. A fix lands once and reaches every instance on its next deploy.
 - **Node / Express / Next.js** — same handler, mounted on a route
 - **Standalone** — `npm start`, or the Docker image
 
+It reads `req.query` when the platform provides it (serverless, Express) and falls back to parsing
+`req.url` when it does not — so a bare `http.createServer` works too, without a shim.
+
 See [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) for the boundary, and
 [`docs/API.md`](docs/API.md) for the surface an integrator implements.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discovery-media-player",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "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/__tests__/plateforme.test.js

@@ -0,0 +1,82 @@
+// LE GESTIONNAIRE NE DOIT DÉPENDRE D'AUCUNE PLATEFORME.
+//
+// Le README promet « Vercel, Next.js, Express, ou le serveur HTTP de Node — le même gestionnaire ».
+// C'était vrai à une convention près, jamais écrite : il lisait `req.query`, que les plateformes
+// serverless et Express remplissent, mais qu'un serveur HTTP nu laisse indéfini.
+//
+// ⚠️ ET LE SYMPTÔME ÉTAIT LE PIRE POSSIBLE. Sans paramètres, la requête cherchait un partage nommé
+// « rien » et rendait « Ce lien n'est plus valide ou a été révoqué ». Un intégrateur voyait un
+// REFUS là où il lui manquait un branchement — l'inversion exacte qu'on passe notre temps à
+// corriger. Signalé par un hôte qui montait le player sur http.createServer : chez lui, ça aurait
+// marché en production par chance, pas par construction.
+
+const player = require("../handler.js");
+
+function contexteMinimal() {
+  return {
+    plugins: {}, has: () => false,
+    storage: { isAllowedUrl: () => false, async fetchFile() { return null; }, async put() {} },
+    db: { async request() { return []; }, async selectAll() { return []; } },
+    mail: { async send() {} },
+    identity: { async verifyToken() { return null; }, roleOf: () => "", isAdmin: () => false, async canManageShares() { return false; } },
+    limits: { async allow() { return true; } },
+    branding: { async logo() { return ""; }, name: "", poweredBy: "", loaderName: "", async forKey() { return null; }, title: (b) => b },
+    errors: { async capture() {} },
+    legal: { sourceUrl: "", legalUrl: "", privacyUrl: "", trackingNotice: "" },
+    config: { supabaseUrl: "", supabasePublishableKey: "", mapsKey: "", extraFrameAncestors: [] },
+  };
+}
+
+async function appel(req) {
+  player.init(contexteMinimal());
+  const res = {
+    statusCode: 0, headers: {}, body: "",
+    setHeader(k, v) { this.headers[k.toLowerCase()] = v; },
+    end(b) { this.body = String(b == null ? "" : b); },
+  };
+  await player.handler({ method: "GET", headers: {}, socket: {}, ...req }, res);
+  return res;
+}
+
+describe("d'où viennent les paramètres", () => {
+  // La convention serverless : la plateforme a déjà analysé l'URL.
+  it("utilise req.query quand la plateforme le fournit", async () => {
+    const res = await appel({ query: { contract: "1" } });
+    expect(res.statusCode).toBe(200);
+    expect(JSON.parse(res.body).contract).toBe(1);
+  });
+
+  // ⚠️ Le cas qui produisait « lien révoqué ». Un serveur HTTP nu ne remplit pas req.query.
+  it("les retrouve dans req.url quand elle ne le fournit pas", async () => {
+    const res = await appel({ url: "/api/doc?contract=1" });
+    expect(res.statusCode).toBe(200);
+    expect(JSON.parse(res.body).contract).toBe(1);
+  });
+
+  it("ne se laisse pas troubler par une URL absurde", async () => {
+    const res = await appel({ url: "pas une url du tout" });
+    expect(res.statusCode).toBe(400);
+  });
+});
+
+describe("quand rien n'est demandé", () => {
+  // ⚠️ LE POINT. Ni slug, ni présentation, ni aperçu : il n'y a rien à afficher, et ce n'est PAS
+  // un refus. Rendre la page de révocation envoyait l'intégrateur chercher un lien mort.
+  it("le dit, au lieu d'afficher « lien révoqué »", async () => {
+    const res = await appel({ query: {} });
+    expect(res.statusCode).toBe(400);
+    expect(res.body).toContain("Aucun document demandé");
+    expect(res.body).not.toContain("révoqué");
+  });
+
+  it("oriente vers la cause réelle : les paramètres de requête", async () => {
+    expect((await appel({ query: {} })).body).toMatch(/paramètres de requête/);
+  });
+
+  // Un slug inconnu, LUI, est bien un refus : la distinction doit rester nette dans les deux sens.
+  it("un slug inconnu reste un refus, pas une erreur de branchement", async () => {
+    const res = await appel({ query: { slug: "Inconnu-1234" } });
+    expect(res.statusCode).toBe(404);
+    expect(res.body).toContain("révoqué");
+  });
+});

package/server/handler.js

@@ -2113,9 +2113,34 @@ async function readJsonBody(req) {
   });
 }
 
+/**
+ * Paramètres de la requête, quelle que soit la plateforme.
+ *
+ * Le gestionnaire lit `req.query` — la convention des plateformes serverless (Vercel, Next.js) et
+ * d'Express. Un serveur HTTP nu ne la remplit pas : `req.query` est alors `undefined`, et TOUT
+ * paramètre disparaît.
+ *
+ * ⚠️ CE QUE ÇA DONNAIT, ET POURQUOI C'ÉTAIT LE PIRE DES SYMPTÔMES. Sans paramètres, la requête
+ * partait chercher un partage nommé « rien », n'en trouvait pas, et affichait « Ce lien n'est plus
+ * valide ou a été révoqué ». Un intégrateur voyait donc un REFUS là où il n'avait simplement pas
+ * branché la plateforme. C'est exactement l'inversion qu'on passe notre temps à corriger : une
+ * erreur de câblage ne doit jamais ressembler à une décision.
+ *
+ * Signalé par un hôte qui montait le player sur `http.createServer` : chez lui ça aurait marché en
+ * production (Vercel remplit `req.query`) — par chance, pas par construction.
+ */
+function parametres(req) {
+  if (req.query && typeof req.query === "object") return req.query;
+  try {
+    return Object.fromEntries(new URL(req.url || "/", "http://interne").searchParams);
+  } catch {
+    return {};
+  }
+}
+
 async function handler(req, res) {
   try {
-    const q = req.query || {};
+    const q = parametres(req);
     const slug = String(q.slug || "").trim();
 
     if (req.method === "POST") {
@@ -2496,6 +2521,17 @@ async function handler(req, res) {
       return;
     }
 
+    // AUCUN DOCUMENT DEMANDÉ. Ni slug, ni présentation, ni aperçu, ni carte d'identité — il n'y a
+    // rien à afficher, et ce n'est pas un refus. Le dire franchement évite qu'un intégrateur
+    // cherche un lien révoqué là où il lui manque un paramètre.
+    if (req.method === "GET" && !slug && !q.present && !q.preview && !q.contract) {
+      res.statusCode = 400;
+      res.setHeader("Content-Type", "text/plain; charset=utf-8");
+      res.end("Aucun document demandé. Attendu : ?slug=… , ?present=… , ?preview=1 ou ?contract=1.\n" +
+              "Si vous intégrez le player, vérifiez que la plateforme fournit les paramètres de requête.");
+      return;
+    }
+
     // ── CARTE D'IDENTITÉ (`?contract=1`) ─────────────────────────────────────────────────────
     // La règle 4 du contrat demande à l'hôte d'épingler la version qu'il vise et de le VÉRIFIER.
     // Sans point d'interrogation, cette règle était une intention : un hôte ne pouvait pas écrire