streamer-node 1.0.30 → 1.0.37

package/dist/src/infrastructure/utils/paths.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Filesystem path helpers shared across infrastructure services.
+ *
+ * ── IN SIMPLE WORDS ──
+ * Small, boring helpers for turning untrusted names into safe folder names and
+ * for making sure a folder exists. Several services need the exact same two
+ * operations, so they live here instead of being copy-pasted.
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * `safeSegment` is the single guard that stops an externally-supplied id (e.g.
+ * a courtId from an SSE payload) from escaping its intended parent directory
+ * via `../` or breaking a path with hostile characters. Keep the allow-list
+ * conservative — widening it re-opens path-traversal.
+ *
+ * ── DO NOT ──
+ * - Do NOT loosen the `safeSegment` regex to allow `.` or `/` — that defeats
+ *   the traversal guard.
+ */
+/**
+ * Reduce an arbitrary string to a single, safe filesystem path segment:
+ * anything outside [A-Za-z0-9_-] becomes "_". Prevents path traversal and
+ * invalid characters when an untrusted id is used as a directory name.
+ */
+export declare function safeSegment(value: string): string;
+/** Create a directory (and parents) if missing. No-op when it already exists. */
+export declare function ensureDirSync(dir: string): void;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/infrastructure/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/utils/paths.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAE/C"}

package/dist/src/infrastructure/utils/paths.js

@@ -0,0 +1,69 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeSegment = safeSegment;
+exports.ensureDirSync = ensureDirSync;
+const fs = __importStar(require("fs"));
+/**
+ * Filesystem path helpers shared across infrastructure services.
+ *
+ * ── IN SIMPLE WORDS ──
+ * Small, boring helpers for turning untrusted names into safe folder names and
+ * for making sure a folder exists. Several services need the exact same two
+ * operations, so they live here instead of being copy-pasted.
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * `safeSegment` is the single guard that stops an externally-supplied id (e.g.
+ * a courtId from an SSE payload) from escaping its intended parent directory
+ * via `../` or breaking a path with hostile characters. Keep the allow-list
+ * conservative — widening it re-opens path-traversal.
+ *
+ * ── DO NOT ──
+ * - Do NOT loosen the `safeSegment` regex to allow `.` or `/` — that defeats
+ *   the traversal guard.
+ */
+/**
+ * Reduce an arbitrary string to a single, safe filesystem path segment:
+ * anything outside [A-Za-z0-9_-] becomes "_". Prevents path traversal and
+ * invalid characters when an untrusted id is used as a directory name.
+ */
+function safeSegment(value) {
+    return value.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+/** Create a directory (and parents) if missing. No-op when it already exists. */
+function ensureDirSync(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/infrastructure/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../../src/infrastructure/utils/paths.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA0BA,kCAEC;AAGD,sCAEC;AAjCD,uCAAyB;AAEzB;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,SAAgB,WAAW,CAAC,KAAa;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AAC/C,CAAC;AAED,iFAAiF;AACjF,SAAgB,aAAa,CAAC,GAAW;IACvC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/infrastructure/utils/spawnToFile.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Run a one-shot process whose output is a single file, safely.
+ *
+ * ── IN SIMPLE WORDS ──
+ * Runs a command (e.g. ffmpeg) that produces one output file, writing to a
+ * temp file first and renaming it into place only on success — so a crash,
+ * timeout, or non-zero exit never leaves a half-written/corrupt file at the
+ * real path.
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * - The temp name PRESERVES dest's extension (`x.tmp.mp4`, not `x.mp4.tmp`)
+ *   because ffmpeg picks the output muxer from the extension.
+ * - The caller passes all args EXCEPT the final output path; this appends the
+ *   temp path as the last arg.
+ *
+ * ── DO NOT ──
+ * - Do NOT pass the output path in `args` — it's appended here.
+ */
+export declare function spawnToFile(command: string, args: string[], dest: string, timeoutMs: number): Promise<void>;
+//# sourceMappingURL=spawnToFile.d.ts.map

package/dist/src/infrastructure/utils/spawnToFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnToFile.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/utils/spawnToFile.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAyCf"}

package/dist/src/infrastructure/utils/spawnToFile.js

@@ -0,0 +1,98 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.spawnToFile = spawnToFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+/**
+ * Run a one-shot process whose output is a single file, safely.
+ *
+ * ── IN SIMPLE WORDS ──
+ * Runs a command (e.g. ffmpeg) that produces one output file, writing to a
+ * temp file first and renaming it into place only on success — so a crash,
+ * timeout, or non-zero exit never leaves a half-written/corrupt file at the
+ * real path.
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * - The temp name PRESERVES dest's extension (`x.tmp.mp4`, not `x.mp4.tmp`)
+ *   because ffmpeg picks the output muxer from the extension.
+ * - The caller passes all args EXCEPT the final output path; this appends the
+ *   temp path as the last arg.
+ *
+ * ── DO NOT ──
+ * - Do NOT pass the output path in `args` — it's appended here.
+ */
+function spawnToFile(command, args, dest, timeoutMs) {
+    const ext = path.extname(dest);
+    const tmp = ext ? `${dest.slice(0, -ext.length)}.tmp${ext}` : `${dest}.tmp`;
+    return new Promise((resolve, reject) => {
+        const proc = (0, child_process_1.spawn)(command, [...args, tmp], {
+            stdio: ["ignore", "ignore", "pipe"],
+        });
+        let stderr = "";
+        proc.stderr?.on("data", (d) => {
+            stderr += d.toString();
+        });
+        const timeout = setTimeout(() => {
+            proc.kill("SIGKILL");
+            fs.unlink(tmp, () => { });
+            reject(new Error(`${command} timed out`));
+        }, timeoutMs);
+        proc.on("exit", (code) => {
+            clearTimeout(timeout);
+            if (code === 0 && fs.existsSync(tmp)) {
+                try {
+                    fs.renameSync(tmp, dest);
+                    resolve();
+                }
+                catch (err) {
+                    fs.unlink(tmp, () => { });
+                    reject(err);
+                }
+            }
+            else {
+                fs.unlink(tmp, () => { });
+                reject(new Error(`${command} failed (code ${code}): ${stderr.slice(-200)}`));
+            }
+        });
+        proc.on("error", (err) => {
+            clearTimeout(timeout);
+            fs.unlink(tmp, () => { });
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=spawnToFile.js.map

package/dist/src/infrastructure/utils/spawnToFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawnToFile.js","sourceRoot":"","sources":["../../../../src/infrastructure/utils/spawnToFile.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsBA,kCA8CC;AApED,uCAAyB;AACzB,2CAA6B;AAC7B,iDAAsC;AAEtC;;;;;;;;;;;;;;;;;GAiBG;AACH,SAAgB,WAAW,CACzB,OAAe,EACf,IAAc,EACd,IAAY,EACZ,SAAiB;IAEjB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC;IAC5E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,IAAA,qBAAK,EAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,CAAC,EAAE;YAC1C,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC;SACpC,CAAC,CAAC;QAEH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE;YAC5B,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;QACzB,CAAC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACzB,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,YAAY,CAAC,CAAC,CAAC;QAC5C,CAAC,EAAE,SAAS,CAAC,CAAC;QAEd,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACvB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC;oBACH,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;oBACzB,OAAO,EAAE,CAAC;gBACZ,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACzB,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACzB,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,OAAO,iBAAiB,IAAI,MAAM,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACvB,YAAY,CAAC,OAAO,CAAC,CAAC;YACtB,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/src/main.js

@@ -34,11 +34,15 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
 const packageJson = __importStar(require("../package.json"));
 const Config_1 = require("./infrastructure/config/Config");
 const FileSystemStreamRepository_1 = require("./infrastructure/repositories/FileSystemStreamRepository");
 const NodeFFmpegService_1 = require("./infrastructure/services/NodeFFmpegService");
 const NodeSSEService_1 = require("./infrastructure/services/NodeSSEService");
+const AdDownloaderService_1 = require("./infrastructure/services/AdDownloaderService");
+const AdRotator_1 = require("./infrastructure/services/AdRotator");
 const StartStreamUseCase_1 = require("./application/use-cases/StartStreamUseCase");
 const StopStreamUseCase_1 = require("./application/use-cases/StopStreamUseCase");
 const StreamManagerService_1 = require("./application/services/StreamManagerService");
@@ -46,13 +50,102 @@ const HttpClient_1 = require("./application/services/HttpClient");
 const RemoteLogger_1 = require("./infrastructure/logging/RemoteLogger");
 const SupabaseService_1 = require("./infrastructure/services/SupabaseService");
 const SupabaseListener_1 = require("./infrastructure/listeners/SupabaseListener");
+const SerialHighlightListener_1 = require("./infrastructure/services/SerialHighlightListener");
+const HighlightBufferRegistry_1 = require("./infrastructure/services/HighlightBufferRegistry");
+const HighlightExtractorService_1 = require("./infrastructure/services/HighlightExtractorService");
+const HighlightRendererService_1 = require("./infrastructure/services/HighlightRendererService");
+const NullBallReframer_1 = require("./infrastructure/services/NullBallReframer");
+const PythonBallReframer_1 = require("./infrastructure/services/PythonBallReframer");
+const YouTubeUploadService_1 = require("./infrastructure/services/YouTubeUploadService");
+const CaptureHighlightUseCase_1 = require("./application/use-cases/CaptureHighlightUseCase");
 class Application {
     constructor() {
+        this.adRotationRegistry = new AdRotator_1.AdRotationRegistry();
+        this.highlightBufferRegistry = new HighlightBufferRegistry_1.HighlightBufferRegistry();
         this.logger = new RemoteLogger_1.RemoteLogger({
             ...Config_1.Config.getInstance().get().remoteLogging,
             baseUrl: Config_1.Config.getInstance().get().server.baseUrl,
+            streamingApiKey: Config_1.Config.getInstance().get().server.streamingApiKey,
         }, "debug");
         this.httpClient = new HttpClient_1.HttpClient();
+        /** Last state forwarded per court, to suppress redundant identical writes. */
+        this.lastScoreByCourt = new Map();
+        /** Courts the backend has rejected, so we stop retrying them every packet. */
+        this.rejectedScoreCourts = new Set();
+    }
+    /**
+     * Forward score packets from the court hardware to the backend, which writes
+     * them to Supabase — the single source of truth the scorecard overlay already
+     * reads. The streamer is a bridge here, not a second source.
+     *
+     * ── WHY THE DEDUPE AND THE REJECT-SET ──
+     * At a multi-court venue this ESP32 also relays the NEIGHBOURING court's
+     * traffic (shared mesh credentials; the firmware does no filtering). We can't
+     * filter locally — we don't know which courts belong to this ground — so the
+     * backend validates it. But an un-suppressed reject would then POST and 400
+     * on every packet from that court, forever. First rejection is logged, then
+     * that court is dropped silently.
+     *
+     * ── DO NOT ──
+     * - Do NOT throw from here. A scoring failure must never disturb the live
+     *   stream; every path swallows and logs.
+     */
+    wireScoreForwarding(groundId) {
+        if (!this.highlightSignalSource)
+            return;
+        this.logger.info("ESP32 score forwarding enabled", { groundId });
+        this.highlightSignalSource.onScore(async (score) => {
+            try {
+                if (this.rejectedScoreCourts.has(score.courtId))
+                    return;
+                // Absolute state — identical repeats carry no information.
+                const fingerprint = JSON.stringify([
+                    score.mode,
+                    score.scoreA,
+                    score.scoreB,
+                    score.gamesA,
+                    score.gamesB,
+                ]);
+                if (this.lastScoreByCourt.get(score.courtId) === fingerprint)
+                    return;
+                // Firmware mode -> the backend's enum. Unknown/absent is omitted so the
+                // existing row keeps its mode rather than being forced to a guess.
+                const mode = score.mode === "AMER"
+                    ? "americano"
+                    : score.mode === "TENNIS"
+                        ? "standard"
+                        : undefined;
+                const res = await this.httpClient.postScoreboard(groundId, score.courtId, {
+                    mode,
+                    // A -> red (left/top), B -> blue (right/bottom), matching the overlay.
+                    redScore: score.scoreA,
+                    blueScore: score.scoreB,
+                    redGames: score.gamesA,
+                    blueGames: score.gamesB,
+                });
+                if (res.ok) {
+                    this.lastScoreByCourt.set(score.courtId, fingerprint);
+                    return;
+                }
+                // 400/404 = this court isn't ours (mesh bleed from another ground).
+                // Expected at shared venues; log once, then ignore that court.
+                if (res.status === 400 || res.status === 404) {
+                    this.rejectedScoreCourts.add(score.courtId);
+                    this.logger.info("Ignoring score for a court the backend does not recognise for this ground", { courtId: score.courtId, status: res.status });
+                    return;
+                }
+                this.logger.warn("Score forward failed", {
+                    courtId: score.courtId,
+                    status: res.status,
+                });
+            }
+            catch (error) {
+                this.logger.warn("Score forward errored", {
+                    courtId: score.courtId,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        });
     }
     async start() {
         try {
@@ -65,9 +158,135 @@ class Application {
             const streamRepository = new FileSystemStreamRepository_1.FileSystemStreamRepository(config.get().stream.persistentStateDir, this.logger);
             const ffmpegService = new NodeFFmpegService_1.NodeFFmpegService(this.logger, config);
             const sseService = new NodeSSEService_1.NodeSSEService(this.logger);
+            const adDownloader = new AdDownloaderService_1.AdDownloaderService(this.logger);
+            // Highlight hardware detector. Started once at boot (tied to the physical
+            // USB device, not any one stream). Its isDevicePresent() drives automatic
+            // per-box enablement of the highlight buffer inside StartStreamUseCase —
+            // a box with no ESP32 attached simply never records highlights.
+            // Highlight capture subsystem — wired up ONLY when enabled, so a box with
+            // highlights off has ZERO new runtime behavior (no serial port opened, no
+            // capture pipeline, no logs). When on, enablement is still gated further
+            // by ESP32 presence inside StartStreamUseCase.
+            const highlightConfig = config.get().highlight;
+            const esp32Config = config.get().esp32;
+            // ONE device, ONE reader. The ESP32 carries both the highlight button and
+            // the score packets, and a serial port can only be held by one consumer —
+            // so the listener is opened when EITHER feature is on, and each subscribes
+            // to the events it cares about. With both off, nothing is opened at all
+            // and the box has zero new runtime behaviour.
+            if (highlightConfig.enabled || esp32Config.scoreForwardingEnabled) {
+                this.highlightSignalSource = new SerialHighlightListener_1.SerialHighlightListener(highlightConfig.serialPortPath, highlightConfig.serialBaudRate, this.logger, highlightConfig.forcePresent, highlightConfig.triggerFile);
+                this.highlightSignalSource.start();
+                if (esp32Config.scoreForwardingEnabled) {
+                    this.wireScoreForwarding(config.get().groundInfo.groundId);
+                }
+            }
+            if (highlightConfig.enabled && this.highlightSignalSource) {
+                // Capture pipeline: signal → cut window → (reframe) → overlay logos.
+                const highlightExtractor = new HighlightExtractorService_1.HighlightExtractorService(highlightConfig.outputDir, this.logger);
+                // Ball-tracking reframer: real Python/OpenCV impl only when enabled,
+                // else a no-op (full-frame). Off by default until tuned on real footage.
+                const ballReframer = highlightConfig.ballTracking.enabled
+                    ? new PythonBallReframer_1.PythonBallReframer(highlightConfig.reelAspect, this.logger)
+                    : new NullBallReframer_1.NullBallReframer();
+                const highlightRenderer = new HighlightRendererService_1.HighlightRendererService(path.resolve("./public/ds.png"), path.resolve(config.get().images.clientPath), this.logger);
+                const captureHighlightUseCase = new CaptureHighlightUseCase_1.CaptureHighlightUseCase(this.highlightBufferRegistry, highlightExtractor, ballReframer, highlightRenderer, this.logger);
+                // Optional YouTube upload of the finished reel. Only built when enabled
+                // AND a streaming key is configured; otherwise reels stay on disk only.
+                const serverCfg = config.get().server;
+                const highlightUploader = highlightConfig.uploadEnabled && serverCfg.streamingApiKey
+                    ? new YouTubeUploadService_1.YouTubeUploadService(serverCfg.baseUrl, config.get().groundInfo.groundId, serverCfg.streamingApiKey, this.logger)
+                    : null;
+                // Route a highlight to the court the press actually came from.
+                //
+                // COURT FILTERING IS LOAD-BEARING, not a nicety: every unit ships with
+                // the same mesh credentials, so at a venue with two courts in WiFi
+                // range this box's ESP32 relays the neighbouring court's button presses
+                // verbatim. Taking `running[0]` unconditionally would cut a clip from
+                // the wrong court's stream with nothing in the logs to explain it.
+                // A signal with no courtId is a debug trigger (force/trigger-file) and
+                // falls back to the single running stream.
+                this.highlightSignalSource.onHighlight(async ({ receivedAtMs, courtId }) => {
+                    try {
+                        const running = await streamRepository.findRunning();
+                        if (running.length === 0) {
+                            this.logger.warn("Highlight signal ignored: no running stream", {
+                                courtId,
+                            });
+                            return;
+                        }
+                        const court = courtId
+                            ? running.find((s) => s.courtId === courtId)
+                            : running[0];
+                        if (!court) {
+                            // Almost always a neighbouring court's press bleeding over the
+                            // shared mesh — expected at multi-court venues, not an error.
+                            this.logger.info("Highlight signal ignored: press is for another court", { pressCourtId: courtId, running: running.map((s) => s.courtId) });
+                            return;
+                        }
+                        const result = await captureHighlightUseCase.execute({
+                            courtId: court.courtId,
+                            receivedAtMs,
+                        });
+                        // Upload is a best-effort, additive step: it runs only on a
+                        // successful capture and its failure never affects the on-disk reel
+                        // (the uploader is fully fail-soft). streamKey is required by the
+                        // backend to resolve the video's privacy.
+                        if (result && highlightUploader) {
+                            const videoId = await highlightUploader.upload({
+                                filePath: result.finalPath,
+                                courtId: court.courtId,
+                                streamKey: court.streamKey,
+                                title: `DropShot highlight — ${court.courtId}`,
+                                preferShort: true,
+                            });
+                            // Reclaim the disk once YouTube has CONFIRMED the video. Gated on
+                            // a real videoId, never on "we tried": a failed upload keeps the
+                            // file so the reel still exists somewhere. Unlink failure is
+                            // logged and ignored — it must not fail the capture.
+                            if (videoId && highlightConfig.deleteAfterUpload) {
+                                fs.unlink(result.finalPath, (err) => {
+                                    if (err) {
+                                        this.logger.warn("Could not delete reel after upload", {
+                                            courtId: court.courtId,
+                                            filePath: result.finalPath,
+                                            error: err.message,
+                                        });
+                                    }
+                                    else {
+                                        this.logger.info("Local reel deleted after upload", {
+                                            courtId: court.courtId,
+                                            filePath: result.finalPath,
+                                            videoId,
+                                        });
+                                    }
+                                });
+                            }
+                        }
+                        else if (result) {
+                            // Say WHY there was no upload. Without this the capture simply
+                            // ends and a disabled uploader is indistinguishable from a broken
+                            // one — you cannot tell from the logs that anything was meant to
+                            // happen at all.
+                            this.logger.info("Reel upload skipped (not configured)", {
+                                courtId: court.courtId,
+                                finalPath: result.finalPath,
+                                reason: !highlightConfig.uploadEnabled
+                                    ? "HIGHLIGHT_UPLOAD_ENABLED is not true"
+                                    : "STREAMING_API_KEY is not set",
+                            });
+                        }
+                    }
+                    catch (error) {
+                        this.logger.error("Highlight capture handler failed", {
+                            error: error instanceof Error ? error.message : String(error),
+                        });
+                    }
+                });
+            }
             // Initialize use cases
-            const startStreamUseCase = new StartStreamUseCase_1.StartStreamUseCase(streamRepository, ffmpegService, this.logger, this.httpClient);
-            const stopStreamUseCase = new StopStreamUseCase_1.StopStreamUseCase(streamRepository, ffmpegService, this.logger);
+            const startStreamUseCase = new StartStreamUseCase_1.StartStreamUseCase(streamRepository, ffmpegService, this.logger, this.httpClient, adDownloader, this.adRotationRegistry, this.highlightBufferRegistry, this.highlightSignalSource);
+            const stopStreamUseCase = new StopStreamUseCase_1.StopStreamUseCase(streamRepository, ffmpegService, this.logger, this.adRotationRegistry, this.highlightBufferRegistry);
             // Initialize Supabase Listener (if enabled)
             const supabaseConfig = config.get().supabase;
             let supabaseListener;
@@ -99,12 +318,19 @@ class Application {
         const shutdown = async (signal) => {
             this.logger.info(`Received ${signal}, shutting down gracefully`);
             try {
+                // Stop all ad rotation timers before tearing down streams.
+                this.adRotationRegistry.stopAll();
+                // Stop all highlight buffer retention sweeps.
+                this.highlightBufferRegistry.stopAll();
                 if (this.streamManager) {
                     await this.streamManager.stop();
                 }
                 if (this.supabaseListener) { // Keep this just in case, though StreamManager handles unsub
                     await this.supabaseListener.stop();
                 }
+                if (this.highlightSignalSource) {
+                    this.highlightSignalSource.stop();
+                }
                 this.logger.info("Application shutdown completed");
                 process.exit(0);
             }

package/dist/src/main.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "streamer-node",
-  "version": "1.0.30",
+  "version": "1.0.37",
   "description": "A lightweight TypeScript streaming system with Clean Architecture",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -13,7 +13,7 @@
     "LICENSE"
   ],
   "scripts": {
-    "build": "npx tsc && mkdir -p public && cp -r public dist/",
+    "build": "npx tsc && mkdir -p public && cp -r public dist/ && cp -r scripts dist/",
     "start": "node dist/src/main.js",
     "dev": "npm run build && npm start",
     "monitor": "bash -c 'npm run dev 2>&1 | tee >(grep -E \"ERROR|WARN|INFO\" > node.logs) >(grep \"DEBUG\" | grep -v \"frame=\" > ffmpeg.logs)'",
@@ -49,6 +49,10 @@
     "dotenv": "^16.3.1",
     "pngjs": "^7.0.0"
   },
+  "optionalDependencies": {
+    "@serialport/parser-readline": "^12.0.0",
+    "serialport": "^12.0.0"
+  },
   "devDependencies": {
     "@types/node": "^20.0.0",
     "@types/pngjs": "^6.0.5",