@torrent-tv/proxy 2.88.4 → 2.88.5

package/routes/api/transcode-sessions/progress/get.js

@@ -1,27 +1,27 @@
-/**
- * Return the current encoding progress for an active HLS transcode session.
- *
- * GET /api/transcode-sessions/:sessionId/progress
- *
- * @param {import("fastify").FastifyRequest} req
- * @param {import("fastify").FastifyReply} reply
- * @param {{ viewerRequests: object }} deps
- * @returns {Promise<void>}
- */
-export async function handleApiTranscodeSessionsProgressGet(req, reply, { viewerRequests }) {
-  const sessionId = typeof req.params.sessionId === "string" ? req.params.sessionId : "";
-  if (!sessionId) {
-    return reply.code(400).send({ error: "sessionId is required." });
-  }
-
-  // Whose progress. One picture serves everyone watching it, and after a
-  // quality change the stream on screen is another session — a different one
-  // for each viewer who changed.
-  const consumerId = typeof req.query?.consumer === "string" ? req.query.consumer : "";
-  const progress = await viewerRequests.getSessionProgress(sessionId, consumerId);
-  if (!progress) {
-    return reply.code(404).send({ error: "Transcode session was not found." });
-  }
-
-  return reply.send(progress);
-}
+/**
+ * Return the current encoding progress for an active HLS transcode session.
+ *
+ * GET /api/transcode-sessions/:sessionId/progress
+ *
+ * @param {import("fastify").FastifyRequest} req
+ * @param {import("fastify").FastifyReply} reply
+ * @param {{ viewerRequests: object }} deps
+ * @returns {Promise<void>}
+ */
+export async function handleApiTranscodeSessionsProgressGet(req, reply, { viewerRequests }) {
+  const sessionId = typeof req.params.sessionId === "string" ? req.params.sessionId : "";
+  if (!sessionId) {
+    return reply.code(400).send({ error: "sessionId is required." });
+  }
+
+  // Whose progress. One picture serves everyone watching it, and after a
+  // quality change the stream on screen is another session — a different one
+  // for each viewer who changed.
+  const consumerId = typeof req.query?.consumer === "string" ? req.query.consumer : "";
+  const progress = await viewerRequests.getSessionProgress(sessionId, consumerId);
+  if (!progress) {
+    return reply.code(404).send({ error: "Transcode session was not found." });
+  }
+
+  return reply.send(progress);
+}

package/routes/api/transcode-sessions/release/post.js

@@ -1,41 +1,41 @@
-/**
- * Release a consumer from a transcode session.
- * When the last consumer is released the session is disposed automatically.
- *
- * POST /api/transcode-sessions/:sessionId/release
- *
- * @param {import("fastify").FastifyRequest} req
- * @param {import("fastify").FastifyReply} reply
- * @param {{ lifecycle: object }} deps
- * @returns {Promise<void>}
- */
-
-/**
- * Extract a plain object from the request body, guarding against
- * non-object payloads (arrays, primitives, null).
- *
- * @param {unknown} body
- * @returns {Record<string, unknown>}
- */
-function getPayload(body) {
-  if (body && typeof body === "object" && !Array.isArray(body)) {
-    return body;
-  }
-  return {};
-}
-
-export async function handleApiTranscodeSessionReleasePost(req, reply, { lifecycle }) {
-  const sessionId = typeof req.params.sessionId === "string" ? req.params.sessionId : "";
-  const payload = getPayload(req.body);
-  const consumerId = typeof payload.consumerId === "string" ? payload.consumerId.trim() : "";
-  const reason = typeof payload.reason === "string" ? payload.reason.trim() : "";
-  if (!sessionId || !consumerId) {
-    return reply.code(400).send({ error: "sessionId and consumerId are required." });
-  }
-
-  const released = await lifecycle.releaseSessionConsumer(sessionId, consumerId, reason);
-  if (!released) {
-    return reply.code(404).send({ error: "Transcode session was not found." });
-  }
-  return reply.send({ ok: true });
-}
+/**
+ * Release a consumer from a transcode session.
+ * When the last consumer is released the session is disposed automatically.
+ *
+ * POST /api/transcode-sessions/:sessionId/release
+ *
+ * @param {import("fastify").FastifyRequest} req
+ * @param {import("fastify").FastifyReply} reply
+ * @param {{ lifecycle: object }} deps
+ * @returns {Promise<void>}
+ */
+
+/**
+ * Extract a plain object from the request body, guarding against
+ * non-object payloads (arrays, primitives, null).
+ *
+ * @param {unknown} body
+ * @returns {Record<string, unknown>}
+ */
+function getPayload(body) {
+  if (body && typeof body === "object" && !Array.isArray(body)) {
+    return body;
+  }
+  return {};
+}
+
+export async function handleApiTranscodeSessionReleasePost(req, reply, { lifecycle }) {
+  const sessionId = typeof req.params.sessionId === "string" ? req.params.sessionId : "";
+  const payload = getPayload(req.body);
+  const consumerId = typeof payload.consumerId === "string" ? payload.consumerId.trim() : "";
+  const reason = typeof payload.reason === "string" ? payload.reason.trim() : "";
+  if (!sessionId || !consumerId) {
+    return reply.code(400).send({ error: "sessionId and consumerId are required." });
+  }
+
+  const released = await lifecycle.releaseSessionConsumer(sessionId, consumerId, reason);
+  if (!released) {
+    return reply.code(404).send({ error: "Transcode session was not found." });
+  }
+  return reply.send({ ok: true });
+}

package/routes/api/transcode-sessions/seek/post.js

@@ -1,63 +1,63 @@
-/**
- * @file POST /api/transcode-sessions/:sessionId/seek — the viewer's seek target.
- *
- * The browser reports WHERE THE VIEWER ACTUALLY SEEKED, explicitly, the moment
- * the scrub ends. This is the only authoritative source of that intent: the
- * position lives in the browser (`video.currentTime`) and nowhere else.
- *
- * Why this route exists at all: our synthetic VOD playlist advertises every
- * segment of the file, but segments only exist once ffmpeg has produced them.
- * A player is entitled by the HLS contract to fetch any advertised segment and
- * get it immediately, so when one 503s it legitimately probes elsewhere —
- * field log 2026-08-02 shows a correct target burst (#973..#985, the real seek)
- * followed by scattered probing across the whole file (#125, #173, #251, #326,
- * #478...). Inferring the target from that request stream made the encoder
- * restart at #519 — a probe, not the seek — and the viewer waited ten seconds
- * for a segment nobody wanted. Segment requests are data fetches, not commands;
- * the seek target now arrives here instead of being guessed from them.
- *
- * Mirrors how Jellyfin/Plex handle server-side seeking (an explicit start
- * position from the client), rather than heuristics over request patterns.
- */
-
-/**
- * @param {import("fastify").FastifyRequest} req
- * @param {import("fastify").FastifyReply} reply
- * @param {{ viewerRequests: object }} deps
- * @returns {Promise<void>}
- */
-export async function handleApiTranscodeSessionSeekPost(req, reply, { viewerRequests }) {
-  const sessionId = req.params?.sessionId;
-  const body = req.body && typeof req.body === "object" ? req.body : {};
-  const positionSeconds = Number(body.positionSeconds);
-
-  if (!Number.isFinite(positionSeconds) || positionSeconds < 0) {
-    reply.code(400);
-    return reply.send({ error: "positionSeconds must be a non-negative number." });
-  }
-
-  // Who moved. A session can be shared, and the seeking viewer's own position
-  // has to move with them or their next request is judged against where they
-  // were before the jump.
-  const consumerId = typeof body.consumerId === "string" ? body.consumerId.trim() : "";
-  if (!consumerId) {
-    reply.code(400);
-    return reply.send({ error: "consumerId is required." });
-  }
-  // Which viewing their requests now belong to. The page raises this before it
-  // sends anything and stamps every request with it, so a request that crosses
-  // this message is still read against the viewing it was made in. A page that
-  // states nothing leaves the generation where it is.
-  const generation = Number(body.generation);
-  const applied = viewerRequests.requestSeek(sessionId, positionSeconds, consumerId, generation);
-  if (!applied) {
-    // Unknown or disposed session — nothing to steer. Not an error worth
-    // surfacing to the viewer: the seek will be handled by whatever session
-    // replaces it.
-    reply.code(404);
-    return reply.send({ error: "No such transcode session." });
-  }
-
-  reply.code(204);
-  return reply.send();
-}
+/**
+ * @file POST /api/transcode-sessions/:sessionId/seek — the viewer's seek target.
+ *
+ * The browser reports WHERE THE VIEWER ACTUALLY SEEKED, explicitly, the moment
+ * the scrub ends. This is the only authoritative source of that intent: the
+ * position lives in the browser (`video.currentTime`) and nowhere else.
+ *
+ * Why this route exists at all: our synthetic VOD playlist advertises every
+ * segment of the file, but segments only exist once ffmpeg has produced them.
+ * A player is entitled by the HLS contract to fetch any advertised segment and
+ * get it immediately, so when one 503s it legitimately probes elsewhere —
+ * field log 2026-08-02 shows a correct target burst (#973..#985, the real seek)
+ * followed by scattered probing across the whole file (#125, #173, #251, #326,
+ * #478...). Inferring the target from that request stream made the encoder
+ * restart at #519 — a probe, not the seek — and the viewer waited ten seconds
+ * for a segment nobody wanted. Segment requests are data fetches, not commands;
+ * the seek target now arrives here instead of being guessed from them.
+ *
+ * Mirrors how Jellyfin/Plex handle server-side seeking (an explicit start
+ * position from the client), rather than heuristics over request patterns.
+ */
+
+/**
+ * @param {import("fastify").FastifyRequest} req
+ * @param {import("fastify").FastifyReply} reply
+ * @param {{ viewerRequests: object }} deps
+ * @returns {Promise<void>}
+ */
+export async function handleApiTranscodeSessionSeekPost(req, reply, { viewerRequests }) {
+  const sessionId = req.params?.sessionId;
+  const body = req.body && typeof req.body === "object" ? req.body : {};
+  const positionSeconds = Number(body.positionSeconds);
+
+  if (!Number.isFinite(positionSeconds) || positionSeconds < 0) {
+    reply.code(400);
+    return reply.send({ error: "positionSeconds must be a non-negative number." });
+  }
+
+  // Who moved. A session can be shared, and the seeking viewer's own position
+  // has to move with them or their next request is judged against where they
+  // were before the jump.
+  const consumerId = typeof body.consumerId === "string" ? body.consumerId.trim() : "";
+  if (!consumerId) {
+    reply.code(400);
+    return reply.send({ error: "consumerId is required." });
+  }
+  // Which viewing their requests now belong to. The page raises this before it
+  // sends anything and stamps every request with it, so a request that crosses
+  // this message is still read against the viewing it was made in. A page that
+  // states nothing leaves the generation where it is.
+  const generation = Number(body.generation);
+  const applied = viewerRequests.requestSeek(sessionId, positionSeconds, consumerId, generation);
+  if (!applied) {
+    // Unknown or disposed session — nothing to steer. Not an error worth
+    // surfacing to the viewer: the seek will be handled by whatever session
+    // replaces it.
+    reply.code(404);
+    return reply.send({ error: "No such transcode session." });
+  }
+
+  reply.code(204);
+  return reply.send();
+}

package/routes/health/get.js

@@ -1,13 +1,13 @@
-/**
- * Basic liveness check for load balancers and container orchestrators.
- *
- * GET /health
- *
- * @param {import("fastify").FastifyRequest} _req
- * @param {import("fastify").FastifyReply} reply
- * @param {{ version: string }} deps
- * @returns {Promise<void>}
- */
-export async function handleHealthGet(_req, reply, { version } = {}) {
-  return reply.send({ ok: true, version });
-}
+/**
+ * Basic liveness check for load balancers and container orchestrators.
+ *
+ * GET /health
+ *
+ * @param {import("fastify").FastifyRequest} _req
+ * @param {import("fastify").FastifyReply} reply
+ * @param {{ version: string }} deps
+ * @returns {Promise<void>}
+ */
+export async function handleHealthGet(_req, reply, { version } = {}) {
+  return reply.send({ ok: true, version });
+}

package/routes/healthz/get.js

@@ -1,13 +1,13 @@
-/**
- * Docker / Kubernetes readiness probe endpoint.
- *
- * GET /healthz
- *
- * @param {import("fastify").FastifyRequest} _req
- * @param {import("fastify").FastifyReply} reply
- * @param {{ version: string }} deps
- * @returns {Promise<void>}
- */
-export async function handleHealthzGet(_req, reply, { version } = {}) {
-  return reply.send({ ok: true, version });
-}
+/**
+ * Docker / Kubernetes readiness probe endpoint.
+ *
+ * GET /healthz
+ *
+ * @param {import("fastify").FastifyRequest} _req
+ * @param {import("fastify").FastifyReply} reply
+ * @param {{ version: string }} deps
+ * @returns {Promise<void>}
+ */
+export async function handleHealthzGet(_req, reply, { version } = {}) {
+  return reply.send({ ok: true, version });
+}