@torrent-tv/proxy 2.89.16 → 2.89.18

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (299) hide show
  1. package/README.md +14 -3
  2. package/package.json +10 -2
  3. package/routes/api/client-logs/post.js +9 -2
  4. package/server.js +0 -11
  5. package/.claude/commands/opsx/apply.md +0 -155
  6. package/.claude/commands/opsx/archive.md +0 -160
  7. package/.claude/commands/opsx/explore.md +0 -174
  8. package/.claude/commands/opsx/propose.md +0 -109
  9. package/.claude/commands/opsx/sync.md +0 -143
  10. package/.claude/skills/openspec-apply-change/SKILL.md +0 -159
  11. package/.claude/skills/openspec-archive-change/SKILL.md +0 -117
  12. package/.claude/skills/openspec-explore/SKILL.md +0 -289
  13. package/.claude/skills/openspec-propose/SKILL.md +0 -113
  14. package/.claude/skills/openspec-sync-specs/SKILL.md +0 -147
  15. package/.dockerignore +0 -5
  16. package/AGENTS.md +0 -363
  17. package/CHANGELOG.md +0 -2373
  18. package/Dockerfile +0 -30
  19. package/biome.json +0 -412
  20. package/corpus.tmp.json +0 -1
  21. package/docs/browser-proxy-contract.md +0 -155
  22. package/docs/container-architecture.md +0 -273
  23. package/docs/download-architecture.md +0 -261
  24. package/docs/encode-architecture.md +0 -765
  25. package/docs/encode-run-state.md +0 -96
  26. package/docs/logs.md +0 -138
  27. package/docs/playback-start-forecast.md +0 -113
  28. package/docs/socks5-egress-research.md +0 -114
  29. package/docs/storage-architecture.md +0 -273
  30. package/knip.json +0 -14
  31. package/main2.cpuprofile +0 -1
  32. package/openspec/changes/adaptive-bitrate/.openspec.yaml +0 -0
  33. package/openspec/changes/adaptive-bitrate/design.md +0 -92
  34. package/openspec/changes/adaptive-bitrate/proposal.md +0 -56
  35. package/openspec/changes/adaptive-bitrate/specs/adaptive-bitrate/spec.md +0 -51
  36. package/openspec/changes/adaptive-bitrate/tasks.md +0 -40
  37. package/openspec/changes/binary-distribution/.openspec.yaml +0 -2
  38. package/openspec/changes/binary-distribution/proposal.md +0 -53
  39. package/openspec/changes/chunked-request-bodies/design.md +0 -81
  40. package/openspec/changes/chunked-request-bodies/proposal.md +0 -53
  41. package/openspec/changes/chunked-request-bodies/specs/chunked-request-bodies/spec.md +0 -30
  42. package/openspec/changes/chunked-request-bodies/tasks.md +0 -40
  43. package/openspec/changes/cold-start/design.md +0 -98
  44. package/openspec/changes/cold-start/proposal.md +0 -62
  45. package/openspec/changes/cold-start/specs/cold-start/spec.md +0 -47
  46. package/openspec/changes/cold-start/tasks.md +0 -48
  47. package/openspec/changes/disk-cap/.openspec.yaml +0 -2
  48. package/openspec/changes/disk-cap/proposal.md +0 -37
  49. package/openspec/changes/disk-cap/specs/disk-cap/spec.md +0 -25
  50. package/openspec/changes/disk-cap/tasks.md +0 -19
  51. package/openspec/changes/proxy-observability/.openspec.yaml +0 -2
  52. package/openspec/changes/proxy-observability/design.md +0 -38
  53. package/openspec/changes/proxy-observability/proposal.md +0 -49
  54. package/openspec/changes/proxy-observability/specs/observability/spec.md +0 -33
  55. package/openspec/changes/proxy-observability/tasks.md +0 -21
  56. package/openspec/changes/seek-debounce/.openspec.yaml +0 -0
  57. package/openspec/changes/seek-debounce/design.md +0 -118
  58. package/openspec/changes/seek-debounce/proposal.md +0 -59
  59. package/openspec/changes/seek-debounce/specs/seek-debounce/spec.md +0 -41
  60. package/openspec/changes/seek-debounce/tasks.md +0 -33
  61. package/openspec/changes/subtitle-language/.openspec.yaml +0 -2
  62. package/openspec/changes/subtitle-language/proposal.md +0 -50
  63. package/openspec/changes/subtitle-language/specs/subtitle-language/spec.md +0 -34
  64. package/openspec/changes/subtitle-language/tasks.md +0 -26
  65. package/openspec/changes/track-selection/.openspec.yaml +0 -2
  66. package/openspec/changes/track-selection/design.md +0 -47
  67. package/openspec/changes/track-selection/proposal.md +0 -45
  68. package/openspec/changes/track-selection/specs/track-selection/spec.md +0 -41
  69. package/openspec/changes/track-selection/tasks.md +0 -20
  70. package/openspec/changes/transcode-quality/.openspec.yaml +0 -2
  71. package/openspec/changes/transcode-quality/proposal.md +0 -51
  72. package/openspec/changes/transcode-quality/specs/transcode-quality/spec.md +0 -139
  73. package/openspec/changes/transcode-quality/tasks.md +0 -63
  74. package/openspec/config.yaml +0 -38
  75. package/public/.well-known/appspecific/com.chrome.devtools.json +0 -1
  76. package/research/delivery-wedge-stand-ladder-2026-09-13.md +0 -329
  77. package/research/double-spawn-2026-09-10.md +0 -171
  78. package/research/handover-2026-09-13.md +0 -209
  79. package/research/handover-reader-claims-removal-2026-09-12.md +0 -166
  80. package/research/piece-withdrawn-but-still-claimed-2026-09-12.md +0 -175
  81. package/research/preset-benchmark-size-scaling-2026-08-22.md +0 -55
  82. package/research/priority-map-is-the-truth-2026-09-12.md +0 -225
  83. package/research/valgrind-replica-2026-08-27/logs.tar.gz +0 -0
  84. package/scripts/build-audio-samples.mjs +0 -31
  85. package/scripts/render-run-graph.js +0 -173
  86. package/test/asset-paths.test.js +0 -28
  87. package/test/audio-buffer-continuity.test.js +0 -77
  88. package/test/audio-calibration.test.js +0 -23
  89. package/test/audio-inventory.test.js +0 -212
  90. package/test/audio-track-bitrate.test.js +0 -40
  91. package/test/audio-warm-recorded.test.js +0 -63
  92. package/test/auto-quality-step.test.js +0 -762
  93. package/test/available-share.test.js +0 -76
  94. package/test/background-fill.test.js +0 -190
  95. package/test/client-log-file.test.js +0 -126
  96. package/test/coalesce.test.js +0 -39
  97. package/test/completed-files.test.js +0 -115
  98. package/test/concurrent-cost.test.js +0 -148
  99. package/test/container-media-info.test.js +0 -228
  100. package/test/contention.test.js +0 -76
  101. package/test/core-dumps.test.js +0 -57
  102. package/test/coverage-follows-the-disk.test.js +0 -233
  103. package/test/coverage-map.test.js +0 -195
  104. package/test/cue-push-carries-what-the-walk-found.test.js +0 -58
  105. package/test/cut-times-timeline.test.js +0 -65
  106. package/test/cuts-follow-published-grid.test.js +0 -109
  107. package/test/data-channel-frame.test.js +0 -63
  108. package/test/data-channel-viewer-lifecycle.test.js +0 -193
  109. package/test/dead-torrent-handle.test.js +0 -52
  110. package/test/declared-rates.test.js +0 -116
  111. package/test/declared-tracks.test.js +0 -43
  112. package/test/decode-cost-fit.test.js +0 -202
  113. package/test/decode-cost.test.js +0 -475
  114. package/test/delivery-probe-field.test.js +0 -173
  115. package/test/delivery-probe.test.js +0 -382
  116. package/test/demand-register.test.js +0 -206
  117. package/test/dht-bootstrap.test.js +0 -72
  118. package/test/drain-threat.test.js +0 -65
  119. package/test/duplicate-add.test.js +0 -48
  120. package/test/encode-admission.test.js +0 -170
  121. package/test/encode-cost.test.js +0 -275
  122. package/test/encode-exit.test.js +0 -111
  123. package/test/encode-orchestrator.test.js +0 -426
  124. package/test/encode-plan-viewers.test.js +0 -725
  125. package/test/encode-plan.test.js +0 -545
  126. package/test/encode-run-state.test.js +0 -314
  127. package/test/encode-run.test.js +0 -248
  128. package/test/encode-slope.test.js +0 -46
  129. package/test/encoded-output.test.js +0 -39
  130. package/test/encoder-kinds.test.js +0 -122
  131. package/test/encoder-readings.test.js +0 -68
  132. package/test/episode-naming.test.js +0 -131
  133. package/test/every-claimant-is-told-its-share.test.js +0 -152
  134. package/test/failed-encoder-still-serves-what-exists.test.js +0 -354
  135. package/test/failed-start-breaker.test.js +0 -202
  136. package/test/fastest-wires.test.js +0 -143
  137. package/test/ffmpeg-stream-counts.test.js +0 -101
  138. package/test/file-edges.test.js +0 -191
  139. package/test/files-in-use.test.js +0 -34
  140. package/test/fixtures/audio-frame-boundary.json +0 -1
  141. package/test/fixtures/refused-audio-20261002.json +0 -10
  142. package/test/fmp4-presentation-clock.test.js +0 -148
  143. package/test/fmp4-self-contained.test.js +0 -80
  144. package/test/fmp4-timestamps.test.js +0 -140
  145. package/test/fmp4-track-completeness.test.js +0 -41
  146. package/test/format-keyed-outputs.test.js +0 -78
  147. package/test/health-metrics.test.js +0 -36
  148. package/test/held-read-ownership.test.js +0 -77
  149. package/test/held-request-width.test.js +0 -157
  150. package/test/helpers/encode-run.js +0 -248
  151. package/test/helpers/held-file.js +0 -77
  152. package/test/helpers/manager.js +0 -62
  153. package/test/helpers/matroska-file.js +0 -296
  154. package/test/helpers/output-spec.js +0 -63
  155. package/test/host-load.test.js +0 -68
  156. package/test/index-accuracy-is-about-the-file.test.js +0 -128
  157. package/test/init-compat.test.js +0 -219
  158. package/test/input-lost-quiets-the-plan.test.js +0 -261
  159. package/test/input-unavailable.test.js +0 -48
  160. package/test/installation-id.test.js +0 -39
  161. package/test/keeping-period.test.js +0 -83
  162. package/test/keyframe-index-accuracy.test.js +0 -188
  163. package/test/keyframe-table-budget.test.js +0 -123
  164. package/test/keyframes-belong-to-the-file.test.js +0 -249
  165. package/test/learned-median.test.js +0 -37
  166. package/test/letting-go-asks-who-is-watching.test.js +0 -191
  167. package/test/limit-row-by-area.test.js +0 -60
  168. package/test/link-budget.test.js +0 -111
  169. package/test/link-probe.test.js +0 -56
  170. package/test/local-encoding-data.test.js +0 -273
  171. package/test/logger-repeats.test.js +0 -134
  172. package/test/look-ahead-coverage.test.js +0 -56
  173. package/test/manager-surface.test.js +0 -291
  174. package/test/matroska-blocks.test.js +0 -0
  175. package/test/matroska-cluster-discovery.test.js +0 -323
  176. package/test/matroska-cues-track.test.js +0 -192
  177. package/test/media-time.test.js +0 -62
  178. package/test/memory-budget.test.js +0 -390
  179. package/test/move-cost.test.js +0 -216
  180. package/test/mp4-composition-times.test.js +0 -0
  181. package/test/mp4-subtitles.test.js +0 -173
  182. package/test/one-authority.test.js +0 -285
  183. package/test/one-budget.test.js +0 -149
  184. package/test/one-output-one-session.test.js +0 -273
  185. package/test/one-resource-divided.test.js +0 -185
  186. package/test/one-serving-output-per-height.test.js +0 -458
  187. package/test/orchestrator-wired.test.js +0 -207
  188. package/test/output-catalog.test.js +0 -39
  189. package/test/output-shape.test.js +0 -21
  190. package/test/output-spec.test.js +0 -251
  191. package/test/output-speed.test.js +0 -92
  192. package/test/outputs-being-prepared.test.js +0 -40
  193. package/test/packet-witness-ring.test.js +0 -236
  194. package/test/packet-witness.test.js +0 -148
  195. package/test/piece-completeness.test.js +0 -78
  196. package/test/piece-disk-store.test.js +0 -401
  197. package/test/piece-from-whole-file.test.js +0 -129
  198. package/test/piece-lru.test.js +0 -319
  199. package/test/piece-reader.test.js +0 -162
  200. package/test/piece-selection-offset.test.js +0 -85
  201. package/test/piece-store-eviction.test.js +0 -595
  202. package/test/piece-store-never-refuses.test.js +0 -153
  203. package/test/piece-store-reservations.test.js +0 -403
  204. package/test/piece-store-slow-disk.test.js +0 -159
  205. package/test/piece-tail.test.js +0 -97
  206. package/test/plan-host-timings.test.js +0 -68
  207. package/test/plan-is-steady.test.js +0 -225
  208. package/test/playback-readiness.test.js +0 -518
  209. package/test/playback-start-regressions.test.js +0 -101
  210. package/test/priority-map-download.test.js +0 -174
  211. package/test/priority-map-emptied.test.js +0 -204
  212. package/test/priority-map-per-output.test.js +0 -215
  213. package/test/priority-map.test.js +0 -163
  214. package/test/probe-wedge-certainty.test.js +0 -60
  215. package/test/produced-copy-choice.test.js +0 -213
  216. package/test/published-timeline.test.js +0 -83
  217. package/test/quality-offer.test.js +0 -160
  218. package/test/quality-variants.test.js +0 -1274
  219. package/test/rate-control-in-the-output.test.js +0 -181
  220. package/test/read-survives-withdrawal.test.js +0 -164
  221. package/test/read-window.test.js +0 -365
  222. package/test/reads-not-yet-arrived.test.js +0 -218
  223. package/test/resume-warm.test.js +0 -39
  224. package/test/run-graph-drift.test.js +0 -37
  225. package/test/run-inputs.test.js +0 -80
  226. package/test/run-intervals.test.js +0 -100
  227. package/test/run-position-follows-published-grid.test.js +0 -89
  228. package/test/run-progress.test.js +0 -64
  229. package/test/same-height-switch.test.js +0 -663
  230. package/test/seek-frees-the-viewers-requests.test.js +0 -217
  231. package/test/seek-landing.test.js +0 -109
  232. package/test/seek-target-not-superseded.test.js +0 -195
  233. package/test/segment-closed-on-both-branches.test.js +0 -114
  234. package/test/segment-cut-times.test.js +0 -63
  235. package/test/segment-demand.test.js +0 -80
  236. package/test/segment-hold-supersede.test.js +0 -91
  237. package/test/segment-judged-by-its-own-header.test.js +0 -222
  238. package/test/segment-serve-wiring.test.js +0 -481
  239. package/test/segment-store-eviction.test.js +0 -247
  240. package/test/segment-store.test.js +0 -352
  241. package/test/segment-true-start.test.js +0 -86
  242. package/test/segments-are-shared.test.js +0 -176
  243. package/test/send-chunk-bytes.test.js +0 -86
  244. package/test/serving-existing-output.test.js +0 -111
  245. package/test/serving-output.test.js +0 -102
  246. package/test/shared-piece-store.test.js +0 -310
  247. package/test/sidecar-naming.test.js +0 -142
  248. package/test/soundtrack-rate-bound.test.js +0 -289
  249. package/test/source-file.test.js +0 -133
  250. package/test/source-files-route.test.js +0 -113
  251. package/test/source-registry.test.js +0 -18
  252. package/test/split-a-stretch.test.js +0 -139
  253. package/test/stale-request-after-seek.test.js +0 -158
  254. package/test/startup-readings.test.js +0 -124
  255. package/test/stream-route.test.js +0 -237
  256. package/test/subtitle-cue-framing.test.js +0 -200
  257. package/test/subtitle-cue-source.test.js +0 -102
  258. package/test/subtitle-cue-walk.test.js +0 -385
  259. package/test/subtitle-cursor.test.js +0 -63
  260. package/test/subtitle-defaults.test.js +0 -118
  261. package/test/subtitle-language.test.js +0 -252
  262. package/test/subtitle-metadata.test.js +0 -15
  263. package/test/subtitle-plan-waits.test.js +0 -125
  264. package/test/subtitle-track-numbering.test.js +0 -391
  265. package/test/supply-margin.test.js +0 -190
  266. package/test/swarm-follows-readers.test.js +0 -174
  267. package/test/swarm-reach.test.js +0 -130
  268. package/test/swarm-selection.test.js +0 -220
  269. package/test/tail-duplication.test.js +0 -167
  270. package/test/the-channel-has-both-ends.test.js +0 -91
  271. package/test/the-torrent-thread-serves-bytes.test.js +0 -107
  272. package/test/thread-pool.test.js +0 -53
  273. package/test/timeline.test.js +0 -84
  274. package/test/torrent-contents.test.js +0 -235
  275. package/test/torrent-cost.test.js +0 -71
  276. package/test/torrent-files.test.js +0 -221
  277. package/test/torrent-naming.test.js +0 -255
  278. package/test/tracks-begin-together.test.js +0 -209
  279. package/test/tunnel-renewal.test.js +0 -167
  280. package/test/two-viewers-one-picture.test.js +0 -508
  281. package/test/upload-hurry.test.js +0 -186
  282. package/test/usrsctp-state.test.js +0 -131
  283. package/test/video-facts.test.js +0 -102
  284. package/test/viewer-assignments.test.js +0 -143
  285. package/test/viewer-outputs.test.js +0 -285
  286. package/test/viewer-presence.test.js +0 -116
  287. package/test/viewer-requests-admission.test.js +0 -92
  288. package/test/viewer-starts-on-map.test.js +0 -27
  289. package/test/viewer-states.test.js +0 -192
  290. package/test/viewer-subtitle-subscription.test.js +0 -96
  291. package/test/viewer.test.js +0 -139
  292. package/test/viewing-generations.test.js +0 -390
  293. package/test/visible-rung.test.js +0 -37
  294. package/test/wait-ledger.test.js +0 -100
  295. package/test/webrtc-shim.test.js +0 -149
  296. package/test/wedge-certainty.test.js +0 -131
  297. package/test/whole-file-held-read.test.js +0 -30
  298. package/test/withdraw-piece-claim.test.js +0 -212
  299. package/test/worker-channel.test.js +0 -158
@@ -1,310 +0,0 @@
1
- /**
2
- * @file Pieces in shared memory, spilling to disk.
3
- *
4
- * The cases worth having are the ones that describe past failures: a buffer
5
- * handed out must not be invalidated by later activity (2.9.71 transferred
6
- * memory it did not own), and a piece being read must not be evicted (2.9.71
7
- * again, at the torrent level).
8
- */
9
-
10
- import test from "node:test";
11
- import assert from "node:assert/strict";
12
- import fs from "node:fs/promises";
13
- import os from "node:os";
14
- import path from "node:path";
15
- import { SharedPieceStore } from "../services/storage/piece-store/shared-piece-store.js";
16
-
17
- const CHUNK = 64 * 1024;
18
-
19
- /**
20
- * @param {object} [options]
21
- * @returns {Promise<{ store: SharedPieceStore, directory: string }>}
22
- */
23
- async function makeStore({ pieces = 4, totalPieces = 16 } = {}) {
24
- const directory = await fs.mkdtemp(path.join(os.tmpdir(), "piece-store-"));
25
- const store = new SharedPieceStore(CHUNK, {
26
- length: CHUNK * totalPieces,
27
- memoryBytes: CHUNK * pieces,
28
- path: directory,
29
- name: "test"
30
- });
31
- return { store, directory };
32
- }
33
-
34
- /**
35
- * @param {number} index
36
- * @param {number} [length]
37
- * @returns {Buffer}
38
- */
39
- function piece(index, length = CHUNK) {
40
- const bytes = Buffer.allocUnsafeSlow(length);
41
- bytes.fill(index % 256);
42
- bytes.writeUInt32BE(index, 0);
43
- return bytes;
44
- }
45
-
46
- /** Promise-shaped wrappers, so the tests read as the sequence they describe. */
47
- const put = (store, index, bytes) =>
48
- new Promise((resolve, reject) => store.put(index, bytes, (error) => (error ? reject(error) : resolve())));
49
- const get = (store, index, options) =>
50
- new Promise((resolve, reject) =>
51
- store.get(index, options, (error, bytes) => (error ? reject(error) : resolve(bytes)))
52
- );
53
-
54
- test("a stored piece comes back byte for byte", async () => {
55
- const { store, directory } = await makeStore();
56
- try {
57
- await put(store, 0, piece(0));
58
- const read = await get(store, 0);
59
- assert.deepEqual(read, piece(0));
60
- } finally {
61
- await new Promise((resolve) => store.destroy(resolve));
62
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
63
- }
64
- });
65
-
66
- test("pieces past the memory budget spill to disk and read back intact", async () => {
67
- const { store, directory } = await makeStore({ pieces: 4, totalPieces: 16 });
68
- try {
69
- for (let index = 0; index < 10; index += 1) {
70
- await put(store, index, piece(index));
71
- }
72
-
73
- assert.equal(store.residentCount, 4, "more pieces stayed resident than the budget allows");
74
- assert.ok(store.spilledCount >= 6, "pieces over budget were not written out");
75
-
76
- // The earliest pieces can only come from disk now.
77
- for (const index of [0, 1, 2, 5]) {
78
- assert.deepEqual(await get(store, index), piece(index), `piece ${index} came back wrong`);
79
- }
80
- } finally {
81
- await new Promise((resolve) => store.destroy(resolve));
82
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
83
- }
84
- });
85
-
86
- test("the short last piece keeps its own length", async () => {
87
- const directory = await fs.mkdtemp(path.join(os.tmpdir(), "piece-store-"));
88
- const store = new SharedPieceStore(CHUNK, {
89
- length: CHUNK * 3 + 1234,
90
- memoryBytes: CHUNK * 4,
91
- path: directory,
92
- name: "tail"
93
- });
94
- try {
95
- const tail = piece(3, 1234);
96
- await put(store, 3, tail);
97
- const read = await get(store, 3);
98
- assert.equal(read.length, 1234);
99
- assert.deepEqual(read, tail);
100
- } finally {
101
- await new Promise((resolve) => store.destroy(resolve));
102
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
103
- }
104
- });
105
-
106
- test("a buffer handed out survives later writes to the same slot", async () => {
107
- // This is the shape of the shipped defect: the caller keeps what it was
108
- // given while the store carries on working.
109
- const { store, directory } = await makeStore({ pieces: 2, totalPieces: 8 });
110
- try {
111
- await put(store, 0, piece(0));
112
- const held = await get(store, 0);
113
-
114
- for (let index = 1; index < 6; index += 1) {
115
- await put(store, index, piece(index));
116
- }
117
-
118
- assert.deepEqual(held, piece(0), "the buffer changed under its holder");
119
- } finally {
120
- await new Promise((resolve) => store.destroy(resolve));
121
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
122
- }
123
- });
124
-
125
- test("a pinned piece is not evicted to make room", async () => {
126
- const { store, directory } = await makeStore({ pieces: 2, totalPieces: 8 });
127
- try {
128
- await put(store, 0, piece(0));
129
- await put(store, 1, piece(1));
130
-
131
- store.pin(0);
132
- await put(store, 2, piece(2));
133
-
134
- const located = store.locate(0);
135
- assert.ok(located, "the pinned piece was evicted while held");
136
- const view = Buffer.from(located.buffer, located.offset, located.length);
137
- assert.deepEqual(view, piece(0), "the pinned piece was overwritten in place");
138
-
139
- store.unpin(0);
140
- } finally {
141
- await new Promise((resolve) => store.destroy(resolve));
142
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
143
- }
144
- });
145
-
146
- test("refuses to make room when every resident piece is being read", async () => {
147
- const { store, directory } = await makeStore({ pieces: 2, totalPieces: 8 });
148
- try {
149
- await put(store, 0, piece(0));
150
- await put(store, 1, piece(1));
151
- store.pin(0);
152
- store.pin(1);
153
-
154
- // The pinned pieces stay where they are, and the arrival is kept anyway —
155
- // on the disk, which is what it has. Refusing it was how a store short of
156
- // memory ended a torrent: the refusal travelled out through the torrent
157
- // client's own write callback and the client destroyed the torrent
158
- // (field 2026-09-11).
159
- await put(store, 2, piece(2));
160
- assert.ok(store.locate(0), "the pinned piece was taken from under its reader");
161
- assert.ok(store.locate(1), "the pinned piece was taken from under its reader");
162
- assert.equal(store.locate(2), null, "and the arrival did not displace either of them");
163
- assert.ok((await get(store, 2)).equals(piece(2)), "the arrival is kept, and reads back");
164
- } finally {
165
- store.unpin(0);
166
- store.unpin(1);
167
- await new Promise((resolve) => store.destroy(resolve));
168
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
169
- }
170
- });
171
-
172
- test("a piece revived from disk is readable by offset again", async () => {
173
- const { store, directory } = await makeStore({ pieces: 2, totalPieces: 8 });
174
- try {
175
- await put(store, 0, piece(0));
176
- await put(store, 1, piece(1));
177
- await put(store, 2, piece(2)); // pushes piece 0 out to disk
178
- assert.equal(store.locate(0), null, "piece 0 should have left memory");
179
-
180
- await store.reside(0); // brings it back, which is what a playback read does
181
- const located = store.locate(0);
182
- assert.ok(located, "piece 0 was not brought back into memory");
183
- const view = Buffer.from(located.buffer, located.offset, located.length);
184
- assert.deepEqual(view, piece(0));
185
- } finally {
186
- await new Promise((resolve) => store.destroy(resolve));
187
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
188
- }
189
- });
190
-
191
- test("a range within a piece is served correctly from memory and from disk", async () => {
192
- const { store, directory } = await makeStore({ pieces: 2, totalPieces: 8 });
193
- try {
194
- const source = piece(4);
195
- await put(store, 4, source);
196
-
197
- assert.deepEqual(
198
- await get(store, 4, { offset: 100, length: 256 }),
199
- source.subarray(100, 356),
200
- "range from memory is wrong"
201
- );
202
-
203
- await put(store, 5, piece(5));
204
- await put(store, 6, piece(6)); // piece 4 spills
205
-
206
- assert.deepEqual(
207
- await get(store, 4, { offset: 100, length: 256 }),
208
- source.subarray(100, 356),
209
- "range after revival is wrong"
210
- );
211
- } finally {
212
- await new Promise((resolve) => store.destroy(resolve));
213
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
214
- }
215
- });
216
-
217
- test("takes memory as it needs it, not the whole budget up front", async () => {
218
- // The budget is per torrent, so a torrent that is merely open — or one being
219
- // probed for its codecs — must not charge the host for the ceiling.
220
- const { store, directory } = await makeStore({ pieces: 16, totalPieces: 64 });
221
- try {
222
- assert.equal(store.capacity, 16);
223
- const initial = store.stats().committedBytes;
224
- assert.ok(initial === 0, `claimed ${initial} bytes before holding anything`);
225
-
226
- for (let index = 0; index < 5; index += 1) {
227
- await put(store, index, piece(index));
228
- }
229
-
230
- assert.equal(store.residentCount, 5);
231
- assert.equal(store.stats().committedBytes, CHUNK * 5, "committed should equal resident");
232
- assert.equal(store.stats().residentBytes, CHUNK * 5);
233
-
234
- // Per-piece buffers must not disturb early pieces.
235
- assert.deepEqual(await get(store, 0), piece(0), "an early piece was disturbed");
236
- } finally {
237
- await new Promise((resolve) => store.destroy(resolve));
238
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
239
- }
240
- });
241
-
242
- test("counts where reads were served from, so the budget can be judged", async () => {
243
- const { store, directory } = await makeStore({ pieces: 2, totalPieces: 8 });
244
- try {
245
- await put(store, 0, piece(0));
246
- await get(store, 0); // memory
247
- await get(store, 0); // memory
248
-
249
- await put(store, 1, piece(1));
250
- await put(store, 2, piece(2)); // piece 0 spills
251
- await get(store, 0); // disk
252
-
253
- const stats = store.stats();
254
- assert.equal(stats.fromMemory, 2, "memory reads miscounted");
255
- assert.equal(stats.fromDisk, 1, "disk reads miscounted");
256
- // One: piece 0 goes out to make room for piece 2. The read that follows is
257
- // the torrent client's, and since 2026-09-11 it is answered from the disk
258
- // copy without taking a block — so nothing has to be written out for it and
259
- // nothing is revived. A read for PLAYBACK still populates memory, and pays
260
- // for it with a spill; that is the next assertion.
261
- assert.equal(stats.spills, 1, "spills miscounted");
262
- assert.equal(stats.revivals, 0, "the client's own read does not revive");
263
-
264
- await store.reside(0);
265
- const afterPlayback = store.stats();
266
- assert.equal(afterPlayback.revivals, 1, "a read for playback revives");
267
- assert.equal(afterPlayback.spills, 2, "and pays for its block with a spill");
268
- assert.equal(stats.blockedByPins, 0);
269
- assert.equal(stats.capacity, 2);
270
- } finally {
271
- await new Promise((resolve) => store.destroy(resolve));
272
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
273
- }
274
- });
275
-
276
- test("counts a refusal caused by pinned pieces", async () => {
277
- const { store, directory } = await makeStore({ pieces: 2, totalPieces: 8 });
278
- try {
279
- await put(store, 0, piece(0));
280
- await put(store, 1, piece(1));
281
- store.pin(0);
282
- store.pin(1);
283
- await put(store, 2, piece(2));
284
-
285
- const stats = store.stats();
286
- assert.equal(stats.blockedByPins, 1, "the store not being able to give a block went unrecorded");
287
- assert.equal(stats.admittedWithoutSlot, 1, "and what it did instead went unrecorded");
288
- } finally {
289
- store.unpin(0);
290
- store.unpin(1);
291
- await new Promise((resolve) => store.destroy(resolve));
292
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
293
- }
294
- });
295
-
296
- test("destroy removes the spill file", async () => {
297
- const { store, directory } = await makeStore({ pieces: 2, totalPieces: 8 });
298
- await put(store, 0, piece(0));
299
- await put(store, 1, piece(1));
300
- await put(store, 2, piece(2)); // forces a spill
301
-
302
- const before = await fs.readdir(directory);
303
- assert.ok(before.length > 0, "nothing was written to spill");
304
-
305
- await new Promise((resolve) => store.destroy(resolve));
306
- const after = await fs.readdir(directory);
307
- assert.equal(after.length, 0, "the spill file outlived the store");
308
-
309
- await fs.rm(directory, { recursive: true, force: true, maxRetries: 10, retryDelay: 20 });
310
- });
@@ -1,142 +0,0 @@
1
- /**
2
- * @file What a torrent's own names say about a track shipped as its own file.
3
- *
4
- * The rule worth pinning is the releaser one, because getting it wrong invents
5
- * an author. In the field case — `[HorribleSubs] Drifters - 02 [1080p].mka` in
6
- * `Rus Sound/`, beside `[HorribleSubs] Drifters - 02 [1080p].mkv` — the dub
7
- * carries the picture's own brackets and nothing else, so there is nothing
8
- * truthful to say about who made it. The subtitles of the same release sit in
9
- * `Sub/[Stan WarHammer & Nesitach]/`, a bracket the picture does not carry, and
10
- * that one IS their author.
11
- */
12
-
13
- import test from "node:test";
14
- import assert from "node:assert/strict";
15
- import {
16
- languageFromFolderNames,
17
- releaserFrom,
18
- sidecarNaming
19
- } from "../services/torrent/naming.js";
20
- /**
21
- * Read a whole path, the way the pairing does. `code` is `"und"` where nothing
22
- * was read, and `group` is what the browser calls the releaser.
23
- *
24
- * @param {string} relativePath
25
- * @param {string} [videoName]
26
- * @returns {{ code: string, group: string | null }}
27
- */
28
- function readPath(relativePath, videoName = "") {
29
- const parts = String(relativePath).split("/");
30
- const naming = sidecarNaming({
31
- folders: parts.slice(0, -1),
32
- fileName: parts[parts.length - 1],
33
- videoName
34
- });
35
- return { ...naming, code: naming.code ?? "und", group: naming.releaser };
36
- }
37
-
38
-
39
- const VIDEO_NAME = "[HorribleSubs] Drifters - 02 [1080p].mkv";
40
-
41
- test("a folder naming a language is read, whole segment or word", () => {
42
- assert.equal(languageFromFolderNames(["ENG"])?.code, "en");
43
- assert.equal(languageFromFolderNames(["Rus Sound"])?.code, "ru");
44
- assert.equal(languageFromFolderNames(["Sub", "Russian"])?.code, "ru");
45
- assert.equal(languageFromFolderNames([])?.code, undefined);
46
- });
47
-
48
- test("the innermost folder answers first", () => {
49
- assert.equal(languageFromFolderNames(["Russian", "English Dub"])?.code, "en");
50
- });
51
-
52
- test("a two-letter word inside a longer folder name is not taken for a language", () => {
53
- // "No" is Norwegian as a whole segment, but a word in `No Subs` is a word.
54
- assert.equal(languageFromFolderNames(["No Subs"]), null);
55
- assert.equal(languageFromFolderNames(["no"])?.code, "no");
56
- });
57
-
58
- test("a bracket the picture also carries is not the sidecar's author", () => {
59
- assert.equal(
60
- releaserFrom({
61
- folders: ["Rus Sound"],
62
- fileName: "[HorribleSubs] Drifters - 02 [1080p].mka",
63
- videoName: VIDEO_NAME
64
- }),
65
- null
66
- );
67
- });
68
-
69
- test("a bracket only the sidecar carries is its author", () => {
70
- assert.equal(
71
- releaserFrom({
72
- folders: ["Sub", "[Stan WarHammer & Nesitach]"],
73
- fileName: "[HorribleSubs] Drifters - 02 [1080p].ass",
74
- videoName: VIDEO_NAME
75
- }),
76
- "Stan WarHammer & Nesitach"
77
- );
78
- });
79
-
80
- test("a bracket describing the encode is never an author", () => {
81
- for (const token of ["1080p", "x264", "HEVC", "WEB-DL", "AAC", "5.1", "10bit", "78EFD746", "RUS"]) {
82
- assert.equal(
83
- releaserFrom({ folders: [], fileName: `Film [${token}].mka`, videoName: "Other.mkv" }),
84
- null,
85
- `[${token}] should not be read as a releaser`
86
- );
87
- }
88
- });
89
-
90
- test("the innermost folder is preferred to the file name", () => {
91
- assert.equal(
92
- releaserFrom({ folders: ["[TeamA]"], fileName: "[TeamB] ep.ass", videoName: "ep.mkv" }),
93
- "TeamA"
94
- );
95
- });
96
-
97
- test("language and author together, for the field case", () => {
98
- assert.deepEqual(
99
- sidecarNaming({
100
- folders: ["Rus Sound"],
101
- fileName: "[HorribleSubs] Drifters - 02 [1080p].mka",
102
- videoName: VIDEO_NAME
103
- }),
104
- { code: "ru", name: "Russian", releaser: null, isForced: false, isHearingImpaired: false, isDefault: false }
105
- );
106
- assert.deepEqual(
107
- sidecarNaming({
108
- folders: ["Sub", "[Stan WarHammer & Nesitach]"],
109
- fileName: "[HorribleSubs] Drifters - 02 [1080p].ass",
110
- videoName: VIDEO_NAME
111
- }),
112
- {
113
- code: null,
114
- name: null,
115
- releaser: "Stan WarHammer & Nesitach",
116
- isForced: false,
117
- isHearingImpaired: false,
118
- isDefault: false
119
- }
120
- );
121
- });
122
-
123
- test("a subtitle file takes its author from the folder the release put it in", () => {
124
- const info = readPath("Sub/[Stan WarHammer & Nesitach]/[HorribleSubs] Drifters - 02 [1080p].ass", VIDEO_NAME);
125
- assert.equal(info.group, "Stan WarHammer & Nesitach");
126
- });
127
-
128
- test("the picture's own release group is never reported as the translator", () => {
129
- const info = readPath("Sub/[HorribleSubs] Drifters - 02 [1080p].ass", VIDEO_NAME);
130
- assert.equal(info.group, null);
131
- });
132
-
133
- test("the language of a subtitle folder is read where the whole segment is not a language", () => {
134
- const info = readPath("Rus Sub/ep.srt", "ep.mkv");
135
- assert.equal(info.code, "ru");
136
- });
137
-
138
- test("what the rules answer with nothing to go on", () => {
139
- const info = readPath("ep.srt");
140
- assert.equal(info.code, "und");
141
- assert.equal(info.group, null);
142
- });