streamer-node 1.0.30 → 1.0.37

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

@@ -0,0 +1,238 @@
+"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.PythonBallReframer = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const lowPriority_1 = require("../utils/lowPriority");
+/**
+ * BallReframer backed by a one-shot Python/OpenCV script (scripts/reframe_ball.py).
+ *
+ * ── IN SIMPLE WORDS ──
+ * Hands the raw clip to a small Python program that watches the ball and writes
+ * a cropped, vertical version. If Python isn't installed, the script errors, or
+ * it takes too long, we just return null and the full-frame clip is used.
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * Same one-shot-subprocess pattern as the ffmpeg calls: spawn, wait with a
+ * timeout, read back the produced file. It is fail-soft by construction — a
+ * missing interpreter, a crash, a timeout, or a missing output file all resolve
+ * to null. A highlight must never be lost because tracking misbehaved.
+ *
+ * ── DO NOT ──
+ * - Do NOT let this throw; every error path returns null.
+ * - Do NOT enable in production before the CV script is tuned on real padel
+ *   footage — until then the crop quality is unproven (hence default OFF).
+ */
+class PythonBallReframer {
+    constructor(reelAspect, logger, scriptPath) {
+        this.reelAspect = reelAspect;
+        this.logger = logger;
+        // The reframe is the heaviest highlight stage (two-pass OpenCV). It runs at
+        // low CPU priority (see withLowPriority), so on a weak box it can take a
+        // while — give it a generous ceiling rather than killing a nearly-done pass.
+        // Detection is downscaled + frame-skipped (reframe_ball.py) to keep it well
+        // under this in practice.
+        this.timeoutMs = 240000;
+        // The app ships as an npm package run via `npx` — so the script must be
+        // found INSIDE the package (the build copies scripts/ into dist/), not from
+        // the CWD. Resolve relative to this compiled module (dist/scripts) first,
+        // then fall back to a repo-root checkout (dev / git deploy). __dirname here
+        // is <pkg>/dist/src/infrastructure/services, so ../../../scripts = dist/scripts.
+        const candidates = [
+            path.join(__dirname, "..", "..", "..", "scripts", "reframe_ball.py"),
+            path.resolve("scripts/reframe_ball.py"),
+        ];
+        this.scriptPath =
+            scriptPath ?? candidates.find((p) => fs.existsSync(p)) ?? candidates[0];
+    }
+    async reframe(clipPath, courtId) {
+        if (!fs.existsSync(this.scriptPath)) {
+            this.logger.warn("Ball reframer script missing; using full frame", {
+                courtId,
+                scriptPath: this.scriptPath,
+            });
+            return null;
+        }
+        // Nothing to crop → nothing to track. The reframer takes a window as WIDE
+        // as `aspect` allows out of a full-height source, so when the target is as
+        // wide as (or wider than) the source there is no horizontal room to pan and
+        // the pass would be a pure re-encode: ~40s of CPU on a streamer box for a
+        // frame-identical result. Skip it and let the caller use the raw clip.
+        //
+        // This is the normal case for the default 16:9 target on a 16:9 camera.
+        const srcDims = await this.probeDimensions(clipPath);
+        if (srcDims) {
+            const target = this.parseAspect(this.reelAspect);
+            const source = srcDims.width / srcDims.height;
+            if (target !== null && target >= source - 0.001) {
+                this.logger.info("Ball reframe skipped: target aspect is not narrower than the source, nothing to crop", { courtId, aspect: this.reelAspect, source: `${srcDims.width}x${srcDims.height}` });
+                return null; // caller falls back to the full-frame clip — the desired result
+            }
+        }
+        const dir = path.dirname(clipPath);
+        const base = path.basename(clipPath, path.extname(clipPath));
+        const out = path.join(dir, `reframed-${base}.mp4`);
+        try {
+            // --debug makes the script print a one-line detector summary to stderr
+            // (frames / hit_rate / motion); we log it so staging can SEE whether
+            // tracking actually locked onto players, not just that the script ran.
+            const stderr = await this.runPython([
+                this.scriptPath,
+                "--input", clipPath,
+                "--output", out,
+                "--aspect", this.reelAspect,
+                "--debug",
+            ]);
+            const summary = stderr
+                .split("\n")
+                .map((l) => l.trim())
+                .filter((l) => l.startsWith("reframe_ball:"))
+                .pop();
+            if (summary) {
+                this.logger.info("Ball reframe stats", { courtId, summary });
+            }
+            if (!fs.existsSync(out)) {
+                this.logger.warn("Ball reframer produced no output; using full frame", {
+                    courtId,
+                });
+                return null;
+            }
+            // Existence isn't enough — a 0-byte / corrupt file would then be trusted
+            // over the good raw clip. Require a probeable, non-zero-duration video.
+            if (!(await this.isPlayable(out))) {
+                this.logger.warn("Ball reframer output invalid; using full frame", {
+                    courtId,
+                    out,
+                });
+                fs.unlink(out, () => { }); // don't leave the bad file to be picked up
+                return null;
+            }
+            this.logger.info("Ball reframe complete", { courtId, out });
+            return out;
+        }
+        catch (error) {
+            this.logger.warn("Ball reframe failed; using full frame", {
+                courtId,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return null;
+        }
+    }
+    /** "16:9" -> 1.777…; null when unparseable (caller then just runs the pass). */
+    parseAspect(aspect) {
+        const m = aspect.match(/^\s*(\d+(?:\.\d+)?)\s*:\s*(\d+(?:\.\d+)?)\s*$/);
+        if (!m)
+            return null;
+        const w = parseFloat(m[1]);
+        const h = parseFloat(m[2]);
+        return h > 0 && w > 0 ? w / h : null;
+    }
+    // Width/height of `file`, or null on any probe failure (never throws).
+    probeDimensions(file) {
+        return new Promise((resolve) => {
+            const proc = (0, child_process_1.spawn)("ffprobe", [
+                "-v", "error",
+                "-select_streams", "v:0",
+                "-show_entries", "stream=width,height",
+                "-of", "csv=p=0",
+                file,
+            ]);
+            let out = "";
+            proc.stdout?.on("data", (d) => (out += d.toString()));
+            proc.on("exit", (code) => {
+                if (code !== 0)
+                    return resolve(null);
+                const m = out.trim().match(/(\d+)\s*,\s*(\d+)/);
+                resolve(m ? { width: parseInt(m[1], 10), height: parseInt(m[2], 10) } : null);
+            });
+            proc.on("error", () => resolve(null));
+        });
+    }
+    // True when ffprobe reports a positive duration for `file` (i.e. a real,
+    // non-empty video). Resolves false on any probe failure — never throws.
+    isPlayable(file) {
+        return new Promise((resolve) => {
+            const proc = (0, child_process_1.spawn)("ffprobe", [
+                "-v", "error",
+                "-show_entries", "format=duration",
+                "-of", "default=nw=1:nk=1",
+                file,
+            ]);
+            let out = "";
+            proc.stdout?.on("data", (d) => {
+                out += d.toString();
+            });
+            proc.on("exit", (code) => {
+                const dur = parseFloat(out.trim());
+                resolve(code === 0 && Number.isFinite(dur) && dur > 0);
+            });
+            proc.on("error", () => resolve(false));
+        });
+    }
+    // Resolves with the process's stderr (used for the --debug summary line);
+    // rejects on non-zero exit, spawn error, or timeout.
+    runPython(args) {
+        return new Promise((resolve, reject) => {
+            // Low CPU priority so the OpenCV passes can't starve the live ffmpeg.
+            const lp = (0, lowPriority_1.withLowPriority)("python3", args);
+            const proc = (0, child_process_1.spawn)(lp.command, lp.args, {
+                stdio: ["ignore", "ignore", "pipe"],
+            });
+            let stderr = "";
+            proc.stderr?.on("data", (d) => {
+                stderr += d.toString();
+            });
+            const timeout = setTimeout(() => {
+                proc.kill("SIGKILL");
+                reject(new Error("python reframe timed out"));
+            }, this.timeoutMs);
+            proc.on("exit", (code) => {
+                clearTimeout(timeout);
+                if (code === 0)
+                    resolve(stderr);
+                else
+                    reject(new Error(`python exited ${code}: ${stderr.slice(-200)}`));
+            });
+            proc.on("error", (err) => {
+                clearTimeout(timeout);
+                reject(err); // e.g. python3 not installed
+            });
+        });
+    }
+}
+exports.PythonBallReframer = PythonBallReframer;
+//# sourceMappingURL=PythonBallReframer.js.map

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

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

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

@@ -0,0 +1,45 @@
+import { EventEmitter } from "events";
+import { CourtScoreSignal, HighlightSignal, HighlightSignalSource } from "../../domain/services/HighlightSignalSource";
+import { Logger } from "../../application/interfaces/Logger";
+export declare class SerialHighlightListener extends EventEmitter implements HighlightSignalSource {
+    private readonly portPath;
+    private readonly baudRate;
+    private readonly logger;
+    private readonly forcePresent;
+    private readonly triggerFile;
+    private port;
+    private parser;
+    private lastTrafficAtMs;
+    private portOpenedAtMs;
+    private started;
+    private reconnectTimer;
+    private reconnectAttempts;
+    private triggerTimer;
+    private lastButtonSeq;
+    private serialLib;
+    private parserLib;
+    constructor(portPath: string, // "auto" or an explicit device path
+    baudRate: number, logger: Logger, forcePresent?: boolean, triggerFile?: string);
+    onHighlight(listener: (signal: HighlightSignal) => void): void;
+    onScore(listener: (signal: CourtScoreSignal) => void): void;
+    start(): void;
+    stop(): void;
+    private startTriggerFileWatch;
+    isDevicePresent(): boolean;
+    private openPort;
+    private handleLine;
+    /**
+     * 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.
+     */
+    private handleScore;
+    private resolvePortPath;
+    private handlePortDown;
+    private teardownPort;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=SerialHighlightListener.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SerialHighlightListener.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/services/SerialHighlightListener.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,qBAAqB,EACtB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAsE7D,qBAAa,uBACX,SAAQ,YACR,YAAW,qBAAqB;IAmB9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAIvB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAxB9B,OAAO,CAAC,IAAI,CAAmC;IAC/C,OAAO,CAAC,MAAM,CAAuC;IACrD,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,YAAY,CAA+B;IAEnD,OAAO,CAAC,aAAa,CAAqB;IAI1C,OAAO,CAAC,SAAS,CAA4C;IAC7D,OAAO,CAAC,SAAS,CAA6D;gBAG3D,QAAQ,EAAE,MAAM,EAAE,oCAAoC;IACtD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EAId,YAAY,GAAE,OAAe,EAC7B,WAAW,GAAE,MAAW;IAKpC,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,GAAG,IAAI;IAI9D,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,GAAG,IAAI;IAI3D,KAAK,IAAI,IAAI;IAoBb,IAAI,IAAI,IAAI;IAkBnB,OAAO,CAAC,qBAAqB;IAiBtB,eAAe,IAAI,OAAO;YAanB,QAAQ;IAwEtB,OAAO,CAAC,UAAU;IA8ElB;;;;;;;OAOG;IACH,OAAO,CAAC,WAAW;YAsBL,eAAe;IAwC7B,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,iBAAiB;CAiB1B"}