discovery-media-player 0.1.0 → 0.1.1

package/bin/__tests__/serve.test.js

@@ -82,3 +82,49 @@ describe("le player répond sans plateforme", () => {
     expect(await ctx.identity.canManageShares(null, "create")).toBe(false);
   });
 });
+
+// LA PREMIÈRE MINUTE DE QUELQU'UN QUI DÉCOUVRE LE PROJET.
+//
+// Écrit après avoir regardé un premier utilisateur suivre le README : dossier vide, nom d'exemple
+// tapé tel quel, et un « Impossible d'afficher ce document » rouge — le même message qu'un fichier
+// absent, qu'un dossier vide et qu'un format non géré. Trois causes, une phrase, aucune piste.
+// La racine du serveur montre désormais ce qu'il y a à lire.
+describe("page d'accueil du mode dossier", () => {
+  const fs = require("node:fs");
+  const os = require("node:os");
+  const p = require("node:path");
+
+  it("liste ce qui est affichable, et rien d'autre", async () => {
+    const dir = fs.realpathSync(fs.mkdtempSync(p.join(os.tmpdir(), "player-home-")));
+    fs.writeFileSync(p.join(dir, "rapport.pdf"), "%PDF-1.4");
+    fs.writeFileSync(p.join(dir, "plan.png"), "x");
+    fs.writeFileSync(p.join(dir, "notes.docx"), "x");   // format non géré : ne pas le proposer
+    fs.writeFileSync(p.join(dir, ".cache"), "x");        // fichier caché
+    fs.mkdirSync(p.join(dir, "archives"));               // dossier
+
+    const { pageAccueil } = require("../serve.js");
+    const html = await pageAccueil(dir);
+    expect(html).toContain('href="/preview/rapport.pdf"');
+    expect(html).toContain('href="/preview/plan.png"');
+    expect(html).not.toContain("notes.docx");
+    expect(html).not.toContain(".cache");
+    expect(html).not.toContain("archives");
+  });
+
+  it("dit qu'il est vide plutôt que de laisser deviner", async () => {
+    const dir = fs.realpathSync(fs.mkdtempSync(p.join(os.tmpdir(), "player-vide-")));
+    const { pageAccueil } = require("../serve.js");
+    expect(await pageAccueil(dir)).toContain("Aucun document affichable");
+  });
+
+  // Un nom de fichier est écrit par quelqu'un d'autre — ici l'exploitant, mais la règle ne se
+  // relâche pas selon la confiance qu'on a dans la source.
+  it("échappe les noms de fichiers", async () => {
+    const dir = fs.realpathSync(fs.mkdtempSync(p.join(os.tmpdir(), "player-xss-")));
+    fs.writeFileSync(p.join(dir, '<img src=x onerror=alert(1)>.pdf'), "%PDF");
+    const { pageAccueil } = require("../serve.js");
+    const html = await pageAccueil(dir);
+    expect(html).not.toContain("<img src=x");
+    expect(html).toContain("&lt;img");
+  });
+});

package/bin/serve.js

@@ -14,6 +14,7 @@
 
 const http = require("node:http");
 const path = require("node:path");
+const fs = require("node:fs/promises");
 const { pathToFileURL } = require("node:url");
 const player = require("../server/handler");
 const { createStandaloneContext } = require("../context/standalone");
@@ -49,6 +50,58 @@ function versParametres(url) {
   return q;
 }
 
+const AFFICHABLES = new Set([".pdf", ".png", ".jpg", ".jpeg", ".gif", ".webp", ".avif", ".svg"]);
+
+/**
+ * Page d'accueil du mode dossier : ce qu'il y a à lire, et où le prendre.
+ *
+ * ⚠️ Écrite après avoir regardé quelqu'un essayer le projet pour la première fois. Il a suivi le
+ * README, ouvert `/preview/<nom>` avec le nom d'exemple, et reçu « Impossible d'afficher ce
+ * document » — le même message qu'un dossier vide, qu'un fichier absent et qu'un format non géré.
+ * Trois causes, une phrase, aucune piste. Le premier contact avec un projet ne se rejoue pas.
+ *
+ * N'existe qu'en mode dossier : c'est la racine que l'exploitant a lui-même désignée, il n'y a
+ * rien à divulguer qu'il ne connaisse déjà.
+ */
+async function pageAccueil(racine) {
+  let fichiers = [];
+  try {
+    fichiers = (await fs.readdir(racine, { withFileTypes: true }))
+      .filter((e) => e.isFile() && !e.name.startsWith(".") && AFFICHABLES.has(path.extname(e.name).toLowerCase()))
+      .map((e) => e.name).sort();
+  } catch { /* racine illisible : traitée comme vide, le message le dira */ }
+
+  const echapper = (t) => String(t).replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" }[c]));
+  const liste = fichiers.length
+    ? `<ul>${fichiers.map((n) => `<li><a href="/preview/${encodeURIComponent(n)}">${echapper(n)}</a></li>`).join("")}</ul>`
+    : `<p class=vide>Aucun document affichable dans <code>${echapper(racine)}</code>.<br>
+       Déposez-y un PDF ou une image, puis rechargez cette page.</p>`;
+
+  return `<!doctype html><html lang=fr><head><meta charset=utf-8>
+<meta name=viewport content="width=device-width,initial-scale=1"><title>Discovery Media Player</title>
+<style>
+  body{font:15px/1.6 -apple-system,system-ui,Segoe UI,Roboto,sans-serif;color:#1c1a17;background:#f5f3ef;
+    margin:0;display:flex;min-height:100vh;align-items:center;justify-content:center;padding:24px}
+  .c{width:100%;max-width:560px;background:#fff;border-radius:16px;padding:32px;box-shadow:0 18px 50px rgba(30,22,12,.10)}
+  h1{font-size:19px;margin:0 0 4px;letter-spacing:-.01em}
+  .s{color:#7c7266;font-size:13.5px;margin:0 0 22px}
+  ul{list-style:none;margin:0;padding:0}
+  li+li{border-top:1px solid #eee9e0}
+  a{display:block;padding:11px 12px;color:#1c1a17;text-decoration:none;border-radius:9px}
+  a:hover{background:#f5f2ec}
+  .vide{color:#7c7266;font-size:14px;background:#faf8f4;border:1px dashed #ddd4c6;border-radius:12px;padding:18px;margin:0}
+  code{font:12.5px ui-monospace,SFMono-Regular,Menlo,monospace;background:#f0ece4;padding:1px 5px;border-radius:5px}
+  .f{margin:22px 0 0;padding-top:16px;border-top:1px solid #eee9e0;color:#9a9184;font-size:12.5px}
+  .f a{display:inline;padding:0;color:#9a9184;text-decoration:underline}
+</style></head><body><div class=c>
+  <h1>Discovery Media Player</h1>
+  <p class=s>Mode dossier — les documents servis viennent de <code>${echapper(racine)}</code>.</p>
+  ${liste}
+  <p class=f>Liens tracés, statistiques et présentation en direct demandent une base :
+    voir <a href="https://github.com/Juli1artha/discovery-media-player#going-further">la documentation</a>.</p>
+</div></body></html>`;
+}
+
 const serveur = http.createServer(async (req, res) => {
   const url = new URL(req.url, `http://${req.headers.host || "localhost"}`);
 
@@ -60,6 +113,13 @@ const serveur = http.createServer(async (req, res) => {
     return;
   }
 
+  // Mode dossier : la racine du serveur montre ce qu'il y a à lire.
+  if ((url.pathname === "/" || url.pathname === "/preview" || url.pathname === "/preview/") && process.env.PLAYER_LOCAL_ROOT) {
+    res.writeHead(200, { "Content-Type": "text/html; charset=utf-8", "Cache-Control": "no-store" });
+    res.end(await pageAccueil(path.resolve(process.env.PLAYER_LOCAL_ROOT)));
+    return;
+  }
+
   const q = versParametres(url);
   const routeConnue =
     url.pathname === "/api/doc" || url.pathname === "/doc" || url.pathname === "/present" ||
@@ -112,4 +172,4 @@ if (require.main === module) serveur.listen(PORT, HOST, () => {
   console.log(`  état      : http://localhost:${PORT}/api/doc?contract=1`);
 });
 
-module.exports = { serveur, versParametres };
+module.exports = { serveur, versParametres, pageAccueil };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "discovery-media-player",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "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",
@@ -62,11 +62,11 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.4",
-    "esbuild": "0.21.5",
+    "esbuild": "^0.25.12",
     "eslint": "^9.39.4",
     "jsdom": "^25.0.1",
     "typescript": "^5.5.4",
     "typescript-eslint": "^8.46.4",
-    "vitest": "^2.1.9"
+    "vitest": "^3.2.7"
   }
 }