streamer-node 1.0.31 → 1.0.37

package/dist/src/infrastructure/services/SerialHighlightListener.js

@@ -0,0 +1,440 @@
+"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.SerialHighlightListener = void 0;
+const events_1 = require("events");
+const fs = __importStar(require("fs"));
+/**
+ * Reads the ESP32's USB-serial output to detect whether the highlight hardware
+ * is attached and alive (presence detection). Presence drives automatic
+ * enablement of the highlight buffer — see HighlightSignalSource.
+ *
+ * ── IN SIMPLE WORDS ──
+ * The court ESP32 plugs into the box over USB and prints one JSON object per
+ * line — a heartbeat every 5s, score updates, logs, and a `button` packet when
+ * someone presses the physical highlight button. This class keeps the serial
+ * port open and notes the last time it heard a valid line. If we've heard the
+ * device recently, it's "present" and the box should record highlights; if the
+ * box has no ESP32, we never hear it and `isDevicePresent()` stays false.
+ *
+ * Protocol contract: docs/esp32/STREAMER_INTEGRATION.md (authoritative — the
+ * desk harness in lib/esp-serial-com is NOT the spec; it only pretty-prints
+ * three of the four types).
+ *
+ * ── BUSINESS RULES ──
+ * - Highlight capture is enabled per-box by HARDWARE PRESENCE (decision
+ *   2026-07-18): a box with the ESP32 attached records the buffer; one without
+ *   never does. `isDevicePresent()` is that signal.
+ * - Presence is proven by the ESP32's own heartbeat, emitted every 5s
+ *   unconditionally (needs no mesh, no court). Freshness window = 15s
+ *   (tolerate 3 missed beats).
+ * - A highlight is a `{"type":"button","event":"press"}` packet. It comes from
+ *   a SEPARATE ESP8266 to the scoreboard one, on its own power and mesh nodeId,
+ *   provisioned with the same courtId — that shared court ID is what correlates
+ *   a press with the court it happened on.
+ * - COURT FILTERING IS MANDATORY. All units share one set of mesh credentials,
+ *   so at a venue with two courts in WiFi range this ESP32 relays the other
+ *   court's traffic verbatim (the firmware does no filtering — by design; the
+ *   spec puts it on the streamer). The courtId rides on HighlightSignal and is
+ *   matched downstream before any clip is cut.
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * - Presence is CONTENT-based (a recognized packet seen recently), not merely
+ *   port-open-based: an open port proves nothing about what's on the other end,
+ *   so trusting it would let an unrelated serial gadget switch on the buffer.
+ *   Content-gating means a wrong/other device reads as absent (no false
+ *   positive) and we don't need the ESP32's USB vendor/product id (unconfirmed)
+ *   to identify it. The ONE bounded exception is a short post-open grace (see
+ *   OPEN_GRACE_MS) that bridges the gap before the first heartbeat on a fresh
+ *   boot; it expires quickly and then content-gating governs.
+ * - The native `serialport` module is loaded defensively (lazy require in a
+ *   try/catch). If it can't load on a given box, highlights just stay off
+ *   forever — the live streaming app must never fail to boot over this.
+ *
+ * ── DO NOT ──
+ * - Do NOT make `isDevicePresent()` throw or do I/O — it's on the stream-start
+ *   hot path. It is a couple of timestamp comparisons.
+ * - Do NOT treat port-open as *durable* presence (only the bounded grace).
+ * - Do NOT let a serial error/disconnect crash the process — port AND parser
+ *   errors are handled and route to a backoff reconnect (mirrors NodeSSEService).
+ */
+// The ESP32 heartbeats every 5s (esp32-leader.ino). Allow ~3 missed beats
+// before declaring the device gone, so a single dropped line doesn't flap.
+const PRESENCE_FRESHNESS_MS = 15000;
+// Bounded startup grace: a freshly-opened matched device counts as present for
+// just over one heartbeat interval, to bridge the window before the first
+// heartbeat on a cold boot. After this, only real traffic keeps it present.
+const OPEN_GRACE_MS = 7000;
+// Reconnect backoff bounds (mirror NodeSSEService.scheduleRetry).
+const RECONNECT_BASE_MS = 1000;
+const RECONNECT_MAX_MS = 30000;
+class SerialHighlightListener extends events_1.EventEmitter {
+    constructor(portPath, // "auto" or an explicit device path
+    baudRate, logger, 
+    // Debug/test only (default off): force presence true, and/or fire a
+    // highlight whenever `triggerFile` appears on disk — so the pipeline can be
+    // exercised on a box without the ESP32 button hardware.
+    forcePresent = false, triggerFile = "") {
+        super();
+        this.portPath = portPath;
+        this.baudRate = baudRate;
+        this.logger = logger;
+        this.forcePresent = forcePresent;
+        this.triggerFile = triggerFile;
+        this.port = null;
+        this.parser = null;
+        this.lastTrafficAtMs = 0;
+        this.portOpenedAtMs = 0;
+        this.started = false;
+        this.reconnectTimer = null;
+        this.reconnectAttempts = 0;
+        this.triggerTimer = null;
+        // Native serial libs, lazily required in start(). Null when unavailable, in
+        // which case the listener is inert and isDevicePresent() stays false.
+        this.serialLib = null;
+        this.parserLib = null;
+    }
+    onHighlight(listener) {
+        this.on("highlight", listener);
+    }
+    onScore(listener) {
+        this.on("score", listener);
+    }
+    start() {
+        if (this.started)
+            return;
+        this.started = true;
+        this.startTriggerFileWatch();
+        try {
+            this.serialLib = require("serialport");
+            this.parserLib = require("@serialport/parser-readline");
+        }
+        catch (error) {
+            this.logger.warn("serialport module unavailable; highlight hardware detection disabled", { error: error instanceof Error ? error.message : String(error) });
+            return;
+        }
+        void this.openPort();
+    }
+    stop() {
+        this.started = false;
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+        }
+        if (this.triggerTimer) {
+            clearInterval(this.triggerTimer);
+            this.triggerTimer = null;
+        }
+        this.teardownPort();
+        this.lastTrafficAtMs = 0;
+    }
+    // Debug/test: when a trigger file path is configured, fire a highlight
+    // whenever that file appears (then remove it). Lets staging exercise the
+    // capture pipeline via `touch <file>` without the ESP32 button. No-op unless
+    // HIGHLIGHT_TRIGGER_FILE is set.
+    startTriggerFileWatch() {
+        if (!this.triggerFile)
+            return;
+        this.logger.info("Highlight manual trigger file watch enabled", {
+            triggerFile: this.triggerFile,
+        });
+        this.triggerTimer = setInterval(() => {
+            try {
+                if (!fs.existsSync(this.triggerFile))
+                    return;
+                fs.unlinkSync(this.triggerFile);
+                this.logger.info("Highlight signal received (manual trigger file)");
+                this.emit("highlight", { receivedAtMs: Date.now() });
+            }
+            catch {
+                /* transient fs error; retry next tick */
+            }
+        }, 1000);
+    }
+    isDevicePresent() {
+        if (this.forcePresent)
+            return true; // debug/test override
+        const now = Date.now();
+        // Durable presence: recognized traffic within the freshness window.
+        if (now - this.lastTrafficAtMs <= PRESENCE_FRESHNESS_MS)
+            return true;
+        // Bounded startup grace: matched device just opened, first heartbeat not
+        // yet due. Expires into content-gating.
+        if (this.portOpenedAtMs && now - this.portOpenedAtMs <= OPEN_GRACE_MS) {
+            return true;
+        }
+        return false;
+    }
+    async openPort() {
+        if (!this.started || !this.serialLib || !this.parserLib)
+            return;
+        // Clear any lingering port/listeners before (re)opening so reconnects never
+        // accumulate orphaned SerialPort/parser objects and their listeners.
+        this.teardownPort();
+        let path = "";
+        try {
+            path = await this.resolvePortPath();
+        }
+        catch (error) {
+            this.scheduleReconnect(`serial discovery failed: ${error instanceof Error ? error.message : String(error)}`);
+            return;
+        }
+        if (!path) {
+            this.scheduleReconnect("no candidate serial device found");
+            return;
+        }
+        try {
+            const { SerialPort } = this.serialLib;
+            const { ReadlineParser } = this.parserLib;
+            const port = new SerialPort({
+                path,
+                baudRate: this.baudRate,
+                autoOpen: false,
+            });
+            port.open((err) => {
+                if (err) {
+                    this.scheduleReconnect(`open ${path} failed: ${err.message}`);
+                    return;
+                }
+                this.reconnectAttempts = 0;
+                this.portOpenedAtMs = Date.now(); // start the bounded presence grace
+                this.logger.info("Highlight serial port opened", { path });
+            });
+            // ESP32 uses println (\r\n); split on \n and trim the trailing \r.
+            const parser = port.pipe(new ReadlineParser({ delimiter: "\n" }));
+            parser.on("data", (line) => this.handleLine(String(line)));
+            // A parser-side stream error would otherwise be an unhandled 'error'
+            // event and crash the process — route it to the same reconnect path.
+            parser.on("error", (err) => {
+                this.logger.warn("Highlight serial parser error", {
+                    error: err.message,
+                });
+                this.handlePortDown();
+            });
+            port.on("error", (err) => {
+                this.logger.warn("Highlight serial port error", { error: err.message });
+                this.handlePortDown();
+            });
+            port.on("close", () => this.handlePortDown());
+            this.port = port;
+            this.parser = parser;
+        }
+        catch (error) {
+            this.scheduleReconnect(`serial open threw: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    handleLine(raw) {
+        // Trailing \r: the ESP32 uses Serial.println (CRLF) while we split on \n.
+        const line = raw.trim();
+        if (!line)
+            return;
+        // NOT every line is JSON. esp32-leader relays mesh messages it can't parse
+        // verbatim rather than dropping them, and boot-time chatter appears on the
+        // port too. A parse failure means "ignore this line" — never an error path,
+        // or the first line of ESP8266 boot noise takes the streamer down.
+        let msg;
+        try {
+            const parsed = JSON.parse(line);
+            if (!parsed || typeof parsed !== "object" || Array.isArray(parsed))
+                return;
+            msg = parsed;
+        }
+        catch {
+            return;
+        }
+        const type = msg.type;
+        if (typeof type !== "string")
+            return;
+        // PRESENCE: any line that parsed as JSON and carries a string `type` proves
+        // the USB link is alive. Deliberately NOT gated on courtId — the ESP32's own
+        // heartbeat is {"type":"heartbeat","source":"ESP32"} with no court (it is the
+        // local leader), so requiring one would leave presence false forever.
+        const now = Date.now();
+        const wasFresh = now - this.lastTrafficAtMs <= PRESENCE_FRESHNESS_MS;
+        this.lastTrafficAtMs = now;
+        this.reconnectAttempts = 0;
+        if (!wasFresh) {
+            this.logger.info("Highlight hardware detected (ESP32 serial traffic)", {
+                type,
+            });
+        }
+        // Switch on `type` and IGNORE unknown types — the protocol reserves the
+        // right to add more. Four exist today: score, button, heartbeat, log.
+        if (type === "score") {
+            this.handleScore(msg);
+            return;
+        }
+        if (type !== "button")
+            return;
+        const courtId = typeof msg.courtId === "string" ? msg.courtId : undefined;
+        const seq = typeof msg.seq === "number" ? msg.seq : undefined;
+        // Press edge only, debounced 50ms in firmware — one physical click is one
+        // message, so no debounce of our own is needed.
+        if (typeof msg.event === "string" && msg.event !== "press")
+            return;
+        // `seq` is monotonic per boot, +1 per press. A gap means the mesh broadcast
+        // was lost (best-effort, no retry); going backwards means the node rebooted.
+        // Log it as a delivery signal — do not try to recover missed presses.
+        if (seq !== undefined && this.lastButtonSeq !== undefined) {
+            if (seq > this.lastButtonSeq + 1) {
+                this.logger.warn("Highlight button presses lost in mesh transit", {
+                    courtId,
+                    expected: this.lastButtonSeq + 1,
+                    got: seq,
+                    missed: seq - this.lastButtonSeq - 1,
+                });
+            }
+            else if (seq < this.lastButtonSeq) {
+                this.logger.info("Highlight button node rebooted (seq reset)", {
+                    courtId,
+                    previous: this.lastButtonSeq,
+                    got: seq,
+                });
+            }
+        }
+        if (seq !== undefined)
+            this.lastButtonSeq = seq;
+        this.logger.info("Highlight signal received (button press)", {
+            courtId,
+            seq,
+        });
+        this.emit("highlight", { receivedAtMs: now, courtId });
+    }
+    /**
+     * A `score` packet: the board's current state, forwarded verbatim.
+     *
+     * Score packets are the one type that carries NO `source` field, so anything
+     * keying on `source` being present would drop them — switch on `type` only.
+     * Values are passed through untouched: interpreting "AD" or mapping the mode
+     * is the consumer's job, not the transport's.
+     */
+    handleScore(msg) {
+        const courtId = typeof msg.courtId === "string" ? msg.courtId : undefined;
+        // Without a court we cannot address the write, and at a multi-court venue we
+        // could not tell whose score it is — drop rather than guess.
+        if (!courtId)
+            return;
+        const scoreA = msg.scoreA;
+        const scoreB = msg.scoreB;
+        if (scoreA === undefined || scoreB === undefined)
+            return;
+        this.emit("score", {
+            courtId,
+            mode: typeof msg.mode === "string" ? msg.mode : undefined,
+            // Coerced with String() rather than assumed: the firmware sends strings,
+            // but a number here must not become "undefined" downstream.
+            scoreA: String(scoreA),
+            scoreB: String(scoreB),
+            gamesA: typeof msg.gamesA === "number" ? msg.gamesA : undefined,
+            gamesB: typeof msg.gamesB === "number" ? msg.gamesB : undefined,
+        });
+    }
+    async resolvePortPath() {
+        if (this.portPath && this.portPath !== "auto") {
+            return this.portPath;
+        }
+        // Auto-discovery: open ONLY an ESP32-looking device. Deliberately no "first
+        // available port" fallback — grabbing an arbitrary tty (e.g. a system debug
+        // console) could disturb unrelated hardware. If nothing matches, return ""
+        // so openPort() backs off and re-scans later (the ESP32 may be plugged in
+        // after boot).
+        //
+        // Match on MANUFACTURER, not product id: the boards ship with either a
+        // CP2102 (Silicon Labs) or a CH340 (wch.cn / QinHeng) bridge, so no single
+        // PID covers the fleet. Path matching alone is not enough — on a box that
+        // also has the ESP8266 debug cable or an Arduino FTDI attached, "first
+        // USB-ish tty" can open the wrong device and then sit there hearing
+        // nothing. Manufacturer is checked first for that reason.
+        const { SerialPort } = this.serialLib;
+        const ports = await SerialPort.list();
+        const isEsp32 = (p) => {
+            const mfr = p.manufacturer ?? "";
+            if (/silicon labs|wch\.cn|qinheng/i.test(mfr))
+                return true;
+            // Linux reports the bare USB vendor ID for the CH340 instead of a name.
+            if (p.vendorId?.toLowerCase() === "1a86")
+                return true;
+            return /usbserial|ttyusb|ttyacm|cu\.usb|tty\.usb/i.test(p.path);
+        };
+        // Prefer a manufacturer/vendor match over a bare path match.
+        const byIdentity = ports.find((p) => /silicon labs|wch\.cn|qinheng/i.test(p.manufacturer ?? "") ||
+            p.vendorId?.toLowerCase() === "1a86");
+        return (byIdentity ?? ports.find(isEsp32))?.path ?? "";
+    }
+    handlePortDown() {
+        this.teardownPort();
+        this.scheduleReconnect("serial port closed/errored");
+    }
+    // Remove listeners and close the current port/parser, resetting the grace.
+    // Idempotent and never throws.
+    teardownPort() {
+        if (this.parser) {
+            try {
+                this.parser.removeAllListeners();
+            }
+            catch {
+                /* ignore */
+            }
+            this.parser = null;
+        }
+        if (this.port) {
+            try {
+                this.port.removeAllListeners();
+                this.port.close(() => { });
+            }
+            catch {
+                /* already closing/closed */
+            }
+            this.port = null;
+        }
+        this.portOpenedAtMs = 0;
+    }
+    scheduleReconnect(reason) {
+        if (!this.started || this.reconnectTimer)
+            return;
+        this.reconnectAttempts = Math.min(this.reconnectAttempts + 1, 10);
+        const delay = Math.min(RECONNECT_BASE_MS * Math.pow(2, this.reconnectAttempts - 1), RECONNECT_MAX_MS);
+        this.logger.warn("Highlight serial reconnect scheduled", {
+            reason,
+            delayMs: delay,
+        });
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            void this.openPort();
+        }, delay);
+    }
+}
+exports.SerialHighlightListener = SerialHighlightListener;
+//# sourceMappingURL=SerialHighlightListener.js.map

package/dist/src/infrastructure/services/SerialHighlightListener.js.map

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

package/dist/src/infrastructure/services/YouTubeUploadService.d.ts

@@ -0,0 +1,36 @@
+import { Logger } from "../../application/interfaces/Logger";
+export interface ReelUploadRequest {
+    filePath: string;
+    courtId: string;
+    streamKey: string;
+    title: string;
+    description?: string;
+    preferShort?: boolean;
+}
+export declare class YouTubeUploadService {
+    private readonly baseUrl;
+    private readonly groundId;
+    private readonly streamingApiKey;
+    private readonly logger;
+    constructor(baseUrl: string, groundId: string, streamingApiKey: string, logger: Logger);
+    /**
+     * Upload `filePath` for `courtId`. Returns the YouTube video id on success,
+     * or null on any failure (logged). Reports the outcome to the backend either
+     * way (so a device-reported failure is recorded).
+     */
+    upload(req: ReelUploadRequest): Promise<string | null>;
+    private createSession;
+    private putFile;
+    private reportComplete;
+    private readChunk;
+    private parseRangeEnd;
+    private isRatio;
+    private probeDimensions;
+    private probeDurationSec;
+    private fetchWithTimeout;
+    private safeText;
+    /** Elapsed time + average throughput, so a slow link is visible in the logs. */
+    private transferStats;
+    private delay;
+}
+//# sourceMappingURL=YouTubeUploadService.d.ts.map

package/dist/src/infrastructure/services/YouTubeUploadService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"YouTubeUploadService.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/services/YouTubeUploadService.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AA4C7D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAHN,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM;IAGjC;;;;OAIG;IACU,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAuGrD,aAAa;YA8Cb,OAAO;YAsFP,cAAc;IAmC5B,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,OAAO;IAWf,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,gBAAgB;YAkBV,gBAAgB;YAchB,QAAQ;IAQtB,gFAAgF;IAChF,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,KAAK;CAGd"}