@cyanheads/seerr-mcp-server 0.1.0 → 0.1.2

package/dist/services/seerr/titles.js

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Title hydration for request-shaped output. Seerr's `MediaRequest`
+ * objects carry no title field — only `media.tmdbId` — so a readable request row
+ * costs one extra `GET /movie/{id}` or `GET /tv/{id}` per distinct title. This
+ * module owns that join and the three properties it needs:
+ *
+ *   - **De-duplication.** A 4K and a non-4K request for one film, or several
+ *     seasons of one show, share a `(mediaType, tmdbId)` and resolve once.
+ *   - **Bounded fan-out.** Lookups run through a fixed-size worker pool, never
+ *     one-shot `Promise.all` over an entire page. Each leg is single-attempt, so
+ *     the pool's width is also the real ceiling on upstream calls.
+ *   - **Degradation.** A lookup that throws, returns an empty title, or has no
+ *     `tmdbId` to look up yields no title and no error — the row keeps every
+ *     other field. Callers disclose the count; nothing here throws.
+ * @module services/seerr/titles
+ */
+/**
+ * Simultaneous detail lookups per hydration pass. Seerr is a single-node app
+ * proxying TMDB on a self-hosted LAN host, so a 100-row page must not open 100
+ * sockets against it; 6 matches the per-origin connection budget browsers have
+ * long used against one host, and drains a full page in ~17 sequential waves.
+ */
+const TITLE_LOOKUP_CONCURRENCY = 6;
+/**
+ * A title is cosmetic, so a leg that fails is absorbed — which makes the default
+ * retry budget actively harmful here: a transient-classified detail read would
+ * burn four upstream calls and seconds of backoff to produce the same absent
+ * title, occupying a worker and multiplying load on the single-node instance the
+ * pool exists to protect. One attempt, then degrade.
+ */
+const BEST_EFFORT = { maxRetries: 0 };
+/** Map key for a resolved title. */
+export function titleKeyOf(mediaType, tmdbId) {
+    return `${mediaType}:${tmdbId}`;
+}
+/**
+ * Resolve titles for a batch of `(mediaType, tmdbId)` pairs. Duplicates collapse
+ * before any fetch, so N rows sharing a title cost one call. Never throws — a
+ * failed leg is absorbed, leaving its key absent from `titles`.
+ */
+export async function resolveTitles(keys, seerr, ctx) {
+    const distinct = new Map();
+    for (const key of keys)
+        distinct.set(titleKeyOf(key.mediaType, key.tmdbId), key);
+    const entries = [...distinct];
+    const titles = new Map();
+    let cursor = 0;
+    /**
+     * Pull-based worker: each pulls the next index and runs to exhaustion, so a
+     * slow lookup delays only itself rather than stalling a fixed-size chunk.
+     */
+    const worker = async () => {
+        for (let entry = entries[cursor++]; entry !== undefined; entry = entries[cursor++]) {
+            const [key, { mediaType, tmdbId }] = entry;
+            const title = await fetchTitle(mediaType, tmdbId, seerr, ctx);
+            if (title)
+                titles.set(key, title);
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(TITLE_LOOKUP_CONCURRENCY, entries.length) }, worker));
+    return { titles, uniqueKeys: entries.length };
+}
+/**
+ * Attach a resolved title to a single projected request detail. Returns the
+ * detail untouched when there is no `tmdbId` to look up or the lookup fails —
+ * the shared path behind seerr_request_status and the request resource, both of
+ * which hydrate unconditionally (one request, one extra call).
+ */
+export async function hydrateRequestTitle(detail, seerr, ctx) {
+    if (typeof detail.tmdbId !== 'number')
+        return detail;
+    const title = await fetchTitle(detail.mediaType, detail.tmdbId, seerr, ctx);
+    return title ? { ...detail, title } : detail;
+}
+/**
+ * One detail fetch reduced to its title. `RawMovieDetail.title` / `RawTvDetail.name`
+ * are the same fields seerr_get_media reads. Upstream failures (including Seerr's
+ * 500-flavored not-found) resolve to `undefined` rather than throwing.
+ */
+async function fetchTitle(mediaType, tmdbId, seerr, ctx) {
+    try {
+        const title = mediaType === 'tv'
+            ? (await seerr.getTv(tmdbId, ctx, BEST_EFFORT)).name
+            : (await seerr.getMovie(tmdbId, ctx, BEST_EFFORT)).title;
+        return title?.trim() || undefined;
+    }
+    catch (error) {
+        ctx.log.debug('Seerr title lookup failed', {
+            mediaType,
+            tmdbId,
+            error: error instanceof Error ? error.message : String(error),
+        });
+        return;
+    }
+}
+//# sourceMappingURL=titles.js.map

package/dist/services/seerr/titles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"titles.js","sourceRoot":"","sources":["../../../src/services/seerr/titles.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cyanheads/seerr-mcp-server",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Search Jellyseerr/Overseerr, check availability, and create guarded media requests via MCP. STDIO or Streamable HTTP.",
   "mcpName": "io.github.cyanheads/seerr-mcp-server",
   "type": "module",
@@ -52,7 +52,7 @@
     "sonarr",
     "media-requests"
   ],
-  "author": "cyanheads <casey@caseyjhand.com> (https://github.com/cyanheads/seerr-mcp-server#readme)",
+  "author": "Casey Hand <casey@caseyjhand.com> (https://caseyjhand.com)",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cyanheads/seerr-mcp-server.git"
@@ -62,6 +62,7 @@
     "url": "https://github.com/cyanheads/seerr-mcp-server/issues"
   },
   "license": "Apache-2.0",
+  "packageManager": "bun@1.3.14",
   "engines": {
     "bun": ">=1.3.0",
     "node": ">=24.0.0"
@@ -70,17 +71,18 @@
     "access": "public"
   },
   "dependencies": {
-    "@cyanheads/mcp-ts-core": "^0.10.6",
+    "@cyanheads/mcp-ts-core": "^0.11.0",
     "pino-pretty": "^13.1.3",
     "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.5.0",
-    "@types/node": "25.9.3",
+    "@biomejs/biome": "2.5.6",
+    "@socketsecurity/bun-security-scanner": "^1.1.2",
+    "@types/node": "26.1.2",
     "depcheck": "^1.4.7",
-    "ignore": "^7.0.5",
-    "tsc-alias": "^1.8.17",
-    "typescript": "^6.0.3",
-    "vitest": "^4.1.8"
+    "ignore": "^7.0.6",
+    "tsc-alias": "^1.9.1",
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.10"
   }
 }

package/server.json

@@ -6,14 +6,14 @@
     "url": "https://github.com/cyanheads/seerr-mcp-server",
     "source": "github"
   },
-  "version": "0.1.0",
+  "version": "0.1.2",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/seerr-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.1.0",
+      "version": "0.1.2",
       "packageArguments": [
         {
           "type": "positional",
@@ -61,7 +61,7 @@
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "@cyanheads/seerr-mcp-server",
       "runtimeHint": "bun",
-      "version": "0.1.0",
+      "version": "0.1.2",
       "packageArguments": [
         {
           "type": "positional",