@torrent-tv/proxy 2.87.9 → 2.87.11

package/services/storage/files/CompletedFiles.js

@@ -1,391 +1,391 @@
-/**
- * @file Files this proxy has downloaded whole, kept as files.
- *
- * A torrent is a way of GETTING bytes. Once every byte of a file is here, the
- * torrent has nothing left to do for it: the file is a file, and reading it is
- * an ordinary read of an ordinary file — no piece store, no memory ceiling, no
- * eviction, no revival from a spill, and nothing that can refuse a read for
- * want of memory.
- *
- * WHY THIS EXISTS AT ALL, in the words it was asked for (2026-09-11): as soon
- * as a torrent is fully downloaded, downloading stops, the torrent is deleted,
- * and the artefacts — what was downloaded — stay for as long as they are
- * wanted.
- *
- * WHERE THEY LIVE, and it is not beside the torrent's own store. Destroying a
- * torrent with `destroyStore` removes that directory whole, which is exactly
- * what the instruction above ends with — so a file kept inside it would be
- * deleted by the very act it is meant to survive.
- *
- * WHAT IS HERE IS ADOPTED AT STARTUP, for the same reason the piece store
- * adopts its own directory: a proxy that has restarted has these files and must
- * not fetch them again. A file whose size does not match what the torrent says
- * is not adopted — it was being written when the process died.
- */
-
-import fs from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-
-/**
- * Where whole files live.
- *
- * Beside the torrents' own directories and not inside them: destroying a
- * torrent with its store removes that directory whole, and these files exist to
- * survive exactly that.
- *
- * @returns {string}
- */
-export function completedFilesRoot() {
-  return path.join(os.tmpdir(), "torrent-tv-files");
-}
-
-/** How a removal is asked for; Windows needs the retries, POSIX ignores them. */
-const REMOVAL = { force: true, maxRetries: 10, retryDelay: 20 };
-
-/**
- * One directory of whole files, keyed by the torrent they came from.
- */
-export class CompletedFiles {
-  #root;
-
-  /** `${infoHash}/${fileIndex}` → what is held. @type {Map<string, { path: string, length: number, name: string }>} */
-  #held = new Map();
-
-  /** Assemblies in flight, so two passes cannot write one file at once. @type {Set<string>} */
-  #writing = new Set();
-
-  /**
-   * What this store may hold, handed to it by the owner of the disk.
-   *
-   * It had NO BOUND AT ALL until 2026-09-14 — a 2.8 GB film kept whole on a
-   * host whose disk is often a 32 GB card, with nothing to say when to stop.
-   * The torrent pool's own "disk cap" did not cover it either: that counted
-   * WebTorrent's downloaded bitfield, so a piece held purely in MEMORY told
-   * against a ceiling called disk, and the bytes here told against nothing.
-   *
-   * Null until the owner has divided anything, and null does not license
-   * growth: it is what a store that has not yet been told looks like, and the
-   * first revision is a minute away.
-   *
-   * @type {number | null}
-   */
-  #allowanceBytes = null;
-
-  /** When each held file was last asked for. @type {Map<string, number>} */
-  #lastRead = new Map();
-
-  /**
-   * @param {object} params
-   * @param {string} params.root - Where whole files live. Outside any torrent's
-   *   own store directory, which is removed with the torrent.
-   */
-  constructor({ root }) {
-    this.#root = root;
-  }
-
-  /** Where these files live, for logging. */
-  get root() {
-    return this.#root;
-  }
-
-  /** How many whole files are held. */
-  get size() {
-    return this.#held.size;
-  }
-
-  /** What they weigh. */
-  get bytes() {
-    let total = 0;
-    for (const file of this.#held.values()) {
-      total += file.length;
-    }
-    return total;
-  }
-
-  /**
-   * @param {string} infoHash
-   * @param {number} fileIndex
-   * @returns {string}
-   */
-  #keyOf(infoHash, fileIndex) {
-    return `${String(infoHash)}/${fileIndex}`;
-  }
-
-  /**
-   * The whole file for this torrent and index, or null.
-   *
-   * @param {string} infoHash
-   * @param {number} fileIndex
-   * @returns {{ path: string, length: number, name: string } | null}
-   */
-  find(infoHash, fileIndex) {
-    const key = this.#keyOf(infoHash, fileIndex);
-    const file = this.#held.get(key) ?? null;
-    if (file) {
-      // WHEN IT WAS LAST WANTED, which is the order it leaves in. A whole file
-      // nobody has asked for in the longest is the one whose loss costs least:
-      // it can be downloaded again, and a read of it falls back to the pieces.
-      this.#lastRead.set(key, Date.now());
-    }
-    return file;
-  }
-
-  /**
-   * Say how much disk these files may take between them.
-   *
-   * Over the share, the longest-unread whole file goes — never one being
-   * written, and never the one just asked for. Losing a whole file is not
-   * losing data: the torrent can fetch it again, and until it does the read
-   * falls back to the pieces, which is what `piece-from-whole-file` exists for.
-   *
-   * @param {number} bytes
-   * @returns {{ bytes: number, removed: number }} What is held after, and how
-   *   many files went.
-   */
-  async allow(bytes) {
-    this.#allowanceBytes = Number.isFinite(bytes) && bytes >= 0 ? bytes : null;
-    let removed = 0;
-    if (this.#allowanceBytes === null) {
-      return { bytes: this.bytes, removed };
-    }
-    while (this.bytes > this.#allowanceBytes) {
-      const victim = this.#longestUnread();
-      if (!victim) {
-        break;
-      }
-      await this.#remove(victim);
-      removed += 1;
-    }
-    return { bytes: this.bytes, removed };
-  }
-
-  /**
-   * Whether there is room for a file of this size.
-   *
-   * Asked BEFORE one is assembled, because assembling it and then removing it
-   * is the same bytes written for nothing.
-   *
-   * @param {number} length
-   * @returns {boolean}
-   */
-  hasRoomFor(length) {
-    if (this.#allowanceBytes === null) {
-      return true;
-    }
-    return this.bytes + Math.max(0, Number(length) || 0) <= this.#allowanceBytes;
-  }
-
-  /**
-   * The key of the whole file nobody has wanted for longest, or null.
-   *
-   * @returns {string | null}
-   */
-  #longestUnread() {
-    let oldest = null;
-    let oldestAt = Number.POSITIVE_INFINITY;
-    for (const key of this.#held.keys()) {
-      if (this.#writing.has(key)) {
-        continue;
-      }
-      const at = this.#lastRead.get(key) ?? 0;
-      if (at < oldestAt) {
-        oldest = key;
-        oldestAt = at;
-      }
-    }
-    return oldest;
-  }
-
-  /**
-   * Take one whole file off the disk.
-   *
-   * @param {string} key
-   * @returns {Promise<void>}
-   */
-  async #remove(key) {
-    const file = this.#held.get(key);
-    this.#held.delete(key);
-    this.#lastRead.delete(key);
-    if (!file) {
-      return;
-    }
-    await fs.rm(file.path, REMOVAL).catch(() => undefined);
-  }
-
-  /**
-   * Take up whole files a previous life of this proxy left here.
-   *
-   * @param {(infoHash: string, fileIndex: number) => number | null} lengthOf -
-   *   What the torrent says this file weighs, or null when it is not known. A
-   *   file of the wrong size was being written when the process died and is not
-   *   adopted.
-   * @returns {Promise<number>} How many were taken up.
-   */
-  async adopt(lengthOf) {
-    let adopted = 0;
-    let torrents = [];
-    try {
-      torrents = await fs.readdir(this.#root, { withFileTypes: true });
-    } catch {
-      return 0;
-    }
-    for (const entry of torrents) {
-      if (!entry.isDirectory()) {
-        continue;
-      }
-      const infoHash = entry.name;
-      let files = [];
-      try {
-        files = await fs.readdir(path.join(this.#root, infoHash), { withFileTypes: true });
-      } catch {
-        continue;
-      }
-      let manifest = {};
-      try {
-        manifest = JSON.parse(
-          await fs.readFile(path.join(this.#root, infoHash, "manifest.json"), "utf8")
-        );
-      } catch {
-        // No manifest, or an unreadable one: the bytes are still servable, and
-        // a file named by its number is better than a file thrown away.
-      }
-      for (const held of files) {
-        const fileIndex = Number.parseInt(held.name, 10);
-        if (!held.isFile() || !Number.isInteger(fileIndex) || fileIndex < 0) {
-          continue;
-        }
-        const where = path.join(this.#root, infoHash, held.name);
-        try {
-          const { size } = await fs.stat(where);
-          const expected = lengthOf(infoHash, fileIndex);
-          if (expected !== null && size !== expected) {
-            await fs.rm(where, REMOVAL);
-            continue;
-          }
-          this.#held.set(this.#keyOf(infoHash, fileIndex), {
-            path: where,
-            length: size,
-            name: String(manifest?.[String(fileIndex)]?.name ?? fileIndex)
-          });
-          adopted += 1;
-        } catch {
-          // Gone between the listing and the reading: not ours to worry about.
-        }
-      }
-    }
-    return adopted;
-  }
-
-  /**
-   * Write one whole file out of whatever the torrent can read it from.
-   *
-   * Written under a name nothing serves and renamed when it is closed, so a
-   * process killed halfway leaves no file that looks complete. The rename is
-   * the one moment at which the file becomes servable, which is also why
-   * nothing has to be locked against readers.
-   *
-   * @param {object} params
-   * @param {string} params.infoHash
-   * @param {number} params.fileIndex
-   * @param {number} params.length - What the torrent says the file weighs.
-   * @param {string} params.name - What the torrent calls it. Kept because the
-   *   torrent is what is about to be deleted, and a file with no name can only
-   *   be served as a number.
-   * @param {() => NodeJS.ReadableStream} params.open - The torrent's own read of
-   *   the whole file.
-   * @returns {Promise<{ path: string, length: number } | null>} Null when
-   *   another pass is already writing it, or when what was read does not weigh
-   *   what the torrent said.
-   */
-  async keep({ infoHash, fileIndex, length, name, open }) {
-    const key = this.#keyOf(infoHash, fileIndex);
-    const held = this.#held.get(key);
-    if (held) {
-      return held;
-    }
-    if (this.#writing.has(key)) {
-      return null;
-    }
-    if (!this.hasRoomFor(length)) {
-      // Assembling it and then removing it is the same bytes written for
-      // nothing. The pieces still serve the read; this file simply is not kept.
-      return null;
-    }
-    this.#writing.add(key);
-    const directory = path.join(this.#root, String(infoHash));
-    const where = path.join(directory, String(fileIndex));
-    const partial = `${where}.partial`;
-    try {
-      await fs.mkdir(directory, { recursive: true });
-      await fs.rm(partial, REMOVAL);
-      const source = open();
-      const handle = await fs.open(partial, "w");
-      let written = 0;
-      try {
-        for await (const chunk of source) {
-          await handle.write(chunk);
-          written += chunk.length;
-        }
-      } finally {
-        await handle.close();
-      }
-      if (written !== length) {
-        // The read ended early — the data went away mid-write, which over a
-        // torrent is ordinary. What must not happen is a short file under a
-        // name that says it is whole.
-        await fs.rm(partial, REMOVAL);
-        return null;
-      }
-      await fs.rename(partial, where);
-      const file = { path: where, length, name: String(name ?? fileIndex) };
-      this.#held.set(key, file);
-      await this.#writeManifest(infoHash);
-      return file;
-    } catch {
-      await fs.rm(partial, REMOVAL).catch(() => undefined);
-      return null;
-    } finally {
-      this.#writing.delete(key);
-    }
-  }
-
-  /**
-   * Write down what each file of one torrent is called and weighs.
-   *
-   * The torrent is what is about to be deleted, and it is the only thing that
-   * knows either. A number on disk is enough to serve the bytes and not enough
-   * to say what they are.
-   *
-   * @param {string} infoHash
-   * @returns {Promise<void>}
-   */
-  async #writeManifest(infoHash) {
-    const named = {};
-    for (const [key, file] of this.#held) {
-      if (key.startsWith(`${infoHash}/`)) {
-        named[key.slice(infoHash.length + 1)] = { length: file.length, name: file.name };
-      }
-    }
-    await fs
-      .writeFile(path.join(this.#root, String(infoHash), "manifest.json"), JSON.stringify(named))
-      .catch(() => undefined);
-  }
-
-  /**
-   * Forget and remove every whole file of one torrent.
-   *
-   * @param {string} infoHash
-   * @returns {Promise<void>}
-   */
-  async forget(infoHash) {
-    for (const key of [...this.#held.keys()]) {
-      if (key.startsWith(`${infoHash}/`)) {
-        this.#held.delete(key);
-      }
-    }
-    await fs.rm(path.join(this.#root, String(infoHash)), { ...REMOVAL, recursive: true }).catch(
-      () => undefined
-    );
-  }
-}
+/**
+ * @file Files this proxy has downloaded whole, kept as files.
+ *
+ * A torrent is a way of GETTING bytes. Once every byte of a file is here, the
+ * torrent has nothing left to do for it: the file is a file, and reading it is
+ * an ordinary read of an ordinary file — no piece store, no memory ceiling, no
+ * eviction, no revival from a spill, and nothing that can refuse a read for
+ * want of memory.
+ *
+ * WHY THIS EXISTS AT ALL, in the words it was asked for (2026-09-11): as soon
+ * as a torrent is fully downloaded, downloading stops, the torrent is deleted,
+ * and the artefacts — what was downloaded — stay for as long as they are
+ * wanted.
+ *
+ * WHERE THEY LIVE, and it is not beside the torrent's own store. Destroying a
+ * torrent with `destroyStore` removes that directory whole, which is exactly
+ * what the instruction above ends with — so a file kept inside it would be
+ * deleted by the very act it is meant to survive.
+ *
+ * WHAT IS HERE IS ADOPTED AT STARTUP, for the same reason the piece store
+ * adopts its own directory: a proxy that has restarted has these files and must
+ * not fetch them again. A file whose size does not match what the torrent says
+ * is not adopted — it was being written when the process died.
+ */
+
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+
+/**
+ * Where whole files live.
+ *
+ * Beside the torrents' own directories and not inside them: destroying a
+ * torrent with its store removes that directory whole, and these files exist to
+ * survive exactly that.
+ *
+ * @returns {string}
+ */
+export function completedFilesRoot() {
+  return path.join(os.tmpdir(), "torrent-tv-files");
+}
+
+/** How a removal is asked for; Windows needs the retries, POSIX ignores them. */
+const REMOVAL = { force: true, maxRetries: 10, retryDelay: 20 };
+
+/**
+ * One directory of whole files, keyed by the torrent they came from.
+ */
+export class CompletedFiles {
+  #root;
+
+  /** `${infoHash}/${fileIndex}` → what is held. @type {Map<string, { path: string, length: number, name: string }>} */
+  #held = new Map();
+
+  /** Assemblies in flight, so two passes cannot write one file at once. @type {Set<string>} */
+  #writing = new Set();
+
+  /**
+   * What this store may hold, handed to it by the owner of the disk.
+   *
+   * It had NO BOUND AT ALL until 2026-09-14 — a 2.8 GB film kept whole on a
+   * host whose disk is often a 32 GB card, with nothing to say when to stop.
+   * The torrent pool's own "disk cap" did not cover it either: that counted
+   * WebTorrent's downloaded bitfield, so a piece held purely in MEMORY told
+   * against a ceiling called disk, and the bytes here told against nothing.
+   *
+   * Null until the owner has divided anything, and null does not license
+   * growth: it is what a store that has not yet been told looks like, and the
+   * first revision is a minute away.
+   *
+   * @type {number | null}
+   */
+  #allowanceBytes = null;
+
+  /** When each held file was last asked for. @type {Map<string, number>} */
+  #lastRead = new Map();
+
+  /**
+   * @param {object} params
+   * @param {string} params.root - Where whole files live. Outside any torrent's
+   *   own store directory, which is removed with the torrent.
+   */
+  constructor({ root }) {
+    this.#root = root;
+  }
+
+  /** Where these files live, for logging. */
+  get root() {
+    return this.#root;
+  }
+
+  /** How many whole files are held. */
+  get size() {
+    return this.#held.size;
+  }
+
+  /** What they weigh. */
+  get bytes() {
+    let total = 0;
+    for (const file of this.#held.values()) {
+      total += file.length;
+    }
+    return total;
+  }
+
+  /**
+   * @param {string} infoHash
+   * @param {number} fileIndex
+   * @returns {string}
+   */
+  #keyOf(infoHash, fileIndex) {
+    return `${String(infoHash)}/${fileIndex}`;
+  }
+
+  /**
+   * The whole file for this torrent and index, or null.
+   *
+   * @param {string} infoHash
+   * @param {number} fileIndex
+   * @returns {{ path: string, length: number, name: string } | null}
+   */
+  find(infoHash, fileIndex) {
+    const key = this.#keyOf(infoHash, fileIndex);
+    const file = this.#held.get(key) ?? null;
+    if (file) {
+      // WHEN IT WAS LAST WANTED, which is the order it leaves in. A whole file
+      // nobody has asked for in the longest is the one whose loss costs least:
+      // it can be downloaded again, and a read of it falls back to the pieces.
+      this.#lastRead.set(key, Date.now());
+    }
+    return file;
+  }
+
+  /**
+   * Say how much disk these files may take between them.
+   *
+   * Over the share, the longest-unread whole file goes — never one being
+   * written, and never the one just asked for. Losing a whole file is not
+   * losing data: the torrent can fetch it again, and until it does the read
+   * falls back to the pieces, which is what `piece-from-whole-file` exists for.
+   *
+   * @param {number} bytes
+   * @returns {{ bytes: number, removed: number }} What is held after, and how
+   *   many files went.
+   */
+  async allow(bytes) {
+    this.#allowanceBytes = Number.isFinite(bytes) && bytes >= 0 ? bytes : null;
+    let removed = 0;
+    if (this.#allowanceBytes === null) {
+      return { bytes: this.bytes, removed };
+    }
+    while (this.bytes > this.#allowanceBytes) {
+      const victim = this.#longestUnread();
+      if (!victim) {
+        break;
+      }
+      await this.#remove(victim);
+      removed += 1;
+    }
+    return { bytes: this.bytes, removed };
+  }
+
+  /**
+   * Whether there is room for a file of this size.
+   *
+   * Asked BEFORE one is assembled, because assembling it and then removing it
+   * is the same bytes written for nothing.
+   *
+   * @param {number} length
+   * @returns {boolean}
+   */
+  hasRoomFor(length) {
+    if (this.#allowanceBytes === null) {
+      return true;
+    }
+    return this.bytes + Math.max(0, Number(length) || 0) <= this.#allowanceBytes;
+  }
+
+  /**
+   * The key of the whole file nobody has wanted for longest, or null.
+   *
+   * @returns {string | null}
+   */
+  #longestUnread() {
+    let oldest = null;
+    let oldestAt = Number.POSITIVE_INFINITY;
+    for (const key of this.#held.keys()) {
+      if (this.#writing.has(key)) {
+        continue;
+      }
+      const at = this.#lastRead.get(key) ?? 0;
+      if (at < oldestAt) {
+        oldest = key;
+        oldestAt = at;
+      }
+    }
+    return oldest;
+  }
+
+  /**
+   * Take one whole file off the disk.
+   *
+   * @param {string} key
+   * @returns {Promise<void>}
+   */
+  async #remove(key) {
+    const file = this.#held.get(key);
+    this.#held.delete(key);
+    this.#lastRead.delete(key);
+    if (!file) {
+      return;
+    }
+    await fs.rm(file.path, REMOVAL).catch(() => undefined);
+  }
+
+  /**
+   * Take up whole files a previous life of this proxy left here.
+   *
+   * @param {(infoHash: string, fileIndex: number) => number | null} lengthOf -
+   *   What the torrent says this file weighs, or null when it is not known. A
+   *   file of the wrong size was being written when the process died and is not
+   *   adopted.
+   * @returns {Promise<number>} How many were taken up.
+   */
+  async adopt(lengthOf) {
+    let adopted = 0;
+    let torrents = [];
+    try {
+      torrents = await fs.readdir(this.#root, { withFileTypes: true });
+    } catch {
+      return 0;
+    }
+    for (const entry of torrents) {
+      if (!entry.isDirectory()) {
+        continue;
+      }
+      const infoHash = entry.name;
+      let files = [];
+      try {
+        files = await fs.readdir(path.join(this.#root, infoHash), { withFileTypes: true });
+      } catch {
+        continue;
+      }
+      let manifest = {};
+      try {
+        manifest = JSON.parse(
+          await fs.readFile(path.join(this.#root, infoHash, "manifest.json"), "utf8")
+        );
+      } catch {
+        // No manifest, or an unreadable one: the bytes are still servable, and
+        // a file named by its number is better than a file thrown away.
+      }
+      for (const held of files) {
+        const fileIndex = Number.parseInt(held.name, 10);
+        if (!held.isFile() || !Number.isInteger(fileIndex) || fileIndex < 0) {
+          continue;
+        }
+        const where = path.join(this.#root, infoHash, held.name);
+        try {
+          const { size } = await fs.stat(where);
+          const expected = lengthOf(infoHash, fileIndex);
+          if (expected !== null && size !== expected) {
+            await fs.rm(where, REMOVAL);
+            continue;
+          }
+          this.#held.set(this.#keyOf(infoHash, fileIndex), {
+            path: where,
+            length: size,
+            name: String(manifest?.[String(fileIndex)]?.name ?? fileIndex)
+          });
+          adopted += 1;
+        } catch {
+          // Gone between the listing and the reading: not ours to worry about.
+        }
+      }
+    }
+    return adopted;
+  }
+
+  /**
+   * Write one whole file out of whatever the torrent can read it from.
+   *
+   * Written under a name nothing serves and renamed when it is closed, so a
+   * process killed halfway leaves no file that looks complete. The rename is
+   * the one moment at which the file becomes servable, which is also why
+   * nothing has to be locked against readers.
+   *
+   * @param {object} params
+   * @param {string} params.infoHash
+   * @param {number} params.fileIndex
+   * @param {number} params.length - What the torrent says the file weighs.
+   * @param {string} params.name - What the torrent calls it. Kept because the
+   *   torrent is what is about to be deleted, and a file with no name can only
+   *   be served as a number.
+   * @param {() => NodeJS.ReadableStream} params.open - The torrent's own read of
+   *   the whole file.
+   * @returns {Promise<{ path: string, length: number } | null>} Null when
+   *   another pass is already writing it, or when what was read does not weigh
+   *   what the torrent said.
+   */
+  async keep({ infoHash, fileIndex, length, name, open }) {
+    const key = this.#keyOf(infoHash, fileIndex);
+    const held = this.#held.get(key);
+    if (held) {
+      return held;
+    }
+    if (this.#writing.has(key)) {
+      return null;
+    }
+    if (!this.hasRoomFor(length)) {
+      // Assembling it and then removing it is the same bytes written for
+      // nothing. The pieces still serve the read; this file simply is not kept.
+      return null;
+    }
+    this.#writing.add(key);
+    const directory = path.join(this.#root, String(infoHash));
+    const where = path.join(directory, String(fileIndex));
+    const partial = `${where}.partial`;
+    try {
+      await fs.mkdir(directory, { recursive: true });
+      await fs.rm(partial, REMOVAL);
+      const source = open();
+      const handle = await fs.open(partial, "w");
+      let written = 0;
+      try {
+        for await (const chunk of source) {
+          await handle.write(chunk);
+          written += chunk.length;
+        }
+      } finally {
+        await handle.close();
+      }
+      if (written !== length) {
+        // The read ended early — the data went away mid-write, which over a
+        // torrent is ordinary. What must not happen is a short file under a
+        // name that says it is whole.
+        await fs.rm(partial, REMOVAL);
+        return null;
+      }
+      await fs.rename(partial, where);
+      const file = { path: where, length, name: String(name ?? fileIndex) };
+      this.#held.set(key, file);
+      await this.#writeManifest(infoHash);
+      return file;
+    } catch {
+      await fs.rm(partial, REMOVAL).catch(() => undefined);
+      return null;
+    } finally {
+      this.#writing.delete(key);
+    }
+  }
+
+  /**
+   * Write down what each file of one torrent is called and weighs.
+   *
+   * The torrent is what is about to be deleted, and it is the only thing that
+   * knows either. A number on disk is enough to serve the bytes and not enough
+   * to say what they are.
+   *
+   * @param {string} infoHash
+   * @returns {Promise<void>}
+   */
+  async #writeManifest(infoHash) {
+    const named = {};
+    for (const [key, file] of this.#held) {
+      if (key.startsWith(`${infoHash}/`)) {
+        named[key.slice(infoHash.length + 1)] = { length: file.length, name: file.name };
+      }
+    }
+    await fs
+      .writeFile(path.join(this.#root, String(infoHash), "manifest.json"), JSON.stringify(named))
+      .catch(() => undefined);
+  }
+
+  /**
+   * Forget and remove every whole file of one torrent.
+   *
+   * @param {string} infoHash
+   * @returns {Promise<void>}
+   */
+  async forget(infoHash) {
+    for (const key of [...this.#held.keys()]) {
+      if (key.startsWith(`${infoHash}/`)) {
+        this.#held.delete(key);
+      }
+    }
+    await fs.rm(path.join(this.#root, String(infoHash)), { ...REMOVAL, recursive: true }).catch(
+      () => undefined
+    );
+  }
+}