streamer-node 1.0.30 → 1.0.37

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

@@ -0,0 +1,402 @@
+"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.YouTubeUploadService = void 0;
+const fs = __importStar(require("fs"));
+const child_process_1 = require("child_process");
+/**
+ * Uploads a finished highlight reel to YouTube via the DropShot backend's
+ * resumable upload-session flow.
+ *
+ * ── IN SIMPLE WORDS ──
+ * After a reel is built on disk, this: (1) asks our backend for a one-time
+ * Google upload URL, (2) sends the video file straight to Google in chunks
+ * (retrying/resuming if a chunk drops), then (3) tells our backend the result
+ * (the YouTube video id, or that it failed). Our backend never sees the video
+ * bytes — only Google does.
+ *
+ * ── BUSINESS RULES ──
+ * - The upload-session request needs the court's `streamKey`: the backend reads
+ *   the video's PRIVACY off the stream_records row matching that key, scoped to
+ *   the court. A wrong/absent key → the backend 404s (never a public default).
+ * - `isShort` is only claimed when the reel's real dimensions (probed here with
+ *   ffprobe) resolve to 9:16 or 1:1 — the only ratios the backend accepts for a
+ *   Short. Any other ratio (e.g. our 4:5 default) is uploaded as a regular
+ *   video, which has no ratio constraint. This avoids a guaranteed rejection.
+ * - Chunks are 5 MB (a multiple of 262144, as Google's resumable protocol
+ *   requires for every chunk except the last). On a 308 we trust Google's
+ *   `Range` header for how much it actually kept, over our own counter.
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * - FAIL-SOFT: any failure logs and returns null — a failed upload must never
+ *   throw into the capture pipeline or affect the live stream, and the reel is
+ *   already safely on local disk regardless.
+ * - The `sessionUri` is a SECRET (it's a pre-authorized write URL to Google).
+ *   It is never logged and never shipped to the logs endpoint — only used to
+ *   PUT bytes. Do not add it to any logger call.
+ *
+ * ── DO NOT ──
+ * - Do NOT send the x-streaming-api-key to Google (step 6 PUTs go direct to the
+ *   sessionUri with NO backend auth). Only steps 5 and 7 hit our backend.
+ * - Do NOT log sessionUri, tokens, or the stream key.
+ */
+const CHUNK_SIZE = 5 * 1024 * 1024; // 5 MB — multiple of 262144, Google-legal
+const SESSION_TIMEOUT_MS = 30000;
+const CHUNK_TIMEOUT_MS = 120000;
+const MAX_CHUNK_RETRIES = 5;
+class YouTubeUploadService {
+    constructor(baseUrl, groundId, streamingApiKey, logger) {
+        this.baseUrl = baseUrl;
+        this.groundId = groundId;
+        this.streamingApiKey = streamingApiKey;
+        this.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).
+     */
+    async upload(req) {
+        if (!this.streamingApiKey) {
+            this.logger.warn("Reel upload skipped: STREAMING_API_KEY not set", {
+                courtId: req.courtId,
+            });
+            return null;
+        }
+        if (!fs.existsSync(req.filePath)) {
+            this.logger.warn("Reel upload skipped: file missing", {
+                courtId: req.courtId,
+                filePath: req.filePath,
+            });
+            return null;
+        }
+        const fileSize = fs.statSync(req.filePath).size;
+        const dims = await this.probeDimensions(req.filePath);
+        const durationSeconds = await this.probeDurationSec(req.filePath);
+        // Only claim isShort when the reel truly is Short-legal (9:16 or 1:1) AND
+        // within the 60s cap; otherwise upload as a normal video.
+        const shortLegal = !!dims &&
+            !!durationSeconds &&
+            durationSeconds >= 1 &&
+            durationSeconds <= 60 &&
+            (this.isRatio(dims, 9, 16) || this.isRatio(dims, 1, 1));
+        const isShort = (req.preferShort ?? false) && shortLegal;
+        if ((req.preferShort ?? false) && !shortLegal) {
+            this.logger.info("Reel not Short-legal (need 9:16 or 1:1, ≤60s); uploading as regular video", { courtId: req.courtId, dims, durationSeconds });
+        }
+        // Logged BEFORE the session request: that call reaches the backend and can
+        // hang or be slow, and without this line the whole upload is invisible
+        // until it succeeds. "Started but never finished" must be diagnosable.
+        const uploadStartedAt = Date.now();
+        this.logger.info("Reel upload starting", {
+            courtId: req.courtId,
+            filePath: req.filePath,
+            fileSizeMb: +(fileSize / 1048576).toFixed(2),
+            isShort,
+            durationSeconds: durationSeconds ? Math.round(durationSeconds) : undefined,
+            dims: dims ? `${dims.width}x${dims.height}` : undefined,
+        });
+        let uploadId;
+        try {
+            const session = await this.createSession(req, fileSize, isShort, dims, durationSeconds);
+            uploadId = session.uploadId;
+            this.logger.info("Reel upload session created", {
+                courtId: req.courtId,
+                uploadId,
+                isShort,
+                fileSize,
+            });
+            const videoId = await this.putFile(req.filePath, fileSize, session.sessionUri, req.courtId, uploadId);
+            if (!videoId) {
+                await this.reportComplete(req.courtId, uploadId, {
+                    status: "failed",
+                    error: "resumable upload did not return a video id",
+                });
+                return null;
+            }
+            await this.reportComplete(req.courtId, uploadId, { videoId });
+            this.logger.info("Reel uploaded", {
+                courtId: req.courtId,
+                uploadId,
+                videoId,
+                url: `https://youtu.be/${videoId}`,
+                ...this.transferStats(fileSize, uploadStartedAt),
+            });
+            return videoId;
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            this.logger.warn("Reel upload failed", {
+                courtId: req.courtId,
+                uploadId,
+                error: msg,
+                elapsedSec: +((Date.now() - uploadStartedAt) / 1000).toFixed(1),
+            });
+            // Best-effort failure report so the backend records it (idempotent).
+            if (uploadId) {
+                await this.reportComplete(req.courtId, uploadId, {
+                    status: "failed",
+                    error: msg.slice(0, 300),
+                }).catch(() => { });
+            }
+            return null;
+        }
+    }
+    // Step 5 — authorize the resumable upload; returns { uploadId, sessionUri }.
+    async createSession(req, fileSize, isShort, dims, durationSeconds) {
+        const url = `${this.baseUrl}/api/v1/padel-grounds/${this.groundId}/courts/${req.courtId}/videos/upload-session`;
+        const body = {
+            title: req.title.slice(0, 90),
+            streamKey: req.streamKey,
+            fileSize,
+            fileType: "video/mp4",
+        };
+        if (req.description)
+            body.description = req.description.slice(0, 5000);
+        if (isShort && dims && durationSeconds) {
+            body.isShort = true;
+            body.durationSeconds = Math.round(durationSeconds);
+            body.width = dims.width;
+            body.height = dims.height;
+        }
+        const res = await this.fetchWithTimeout(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-streaming-api-key": this.streamingApiKey,
+            },
+            body: JSON.stringify(body),
+        }, SESSION_TIMEOUT_MS);
+        if (!res.ok) {
+            throw new Error(`upload-session ${res.status}: ${(await this.safeText(res)).slice(0, 200)}`);
+        }
+        const json = (await res.json());
+        if (!json.uploadId || !json.sessionUri) {
+            throw new Error("upload-session response missing uploadId/sessionUri");
+        }
+        return { uploadId: json.uploadId, sessionUri: json.sessionUri };
+    }
+    // Step 6 — PUT the file to Google in chunks, resuming per the Range header.
+    // Returns the video id from the final 200/201, or null.
+    async putFile(filePath, fileSize, sessionUri, courtId, uploadId) {
+        const totalChunks = Math.max(1, Math.ceil(fileSize / CHUNK_SIZE));
+        const startedAt = Date.now();
+        let chunkNo = 0;
+        let offset = 0;
+        while (offset < fileSize) {
+            const end = Math.min(offset + CHUNK_SIZE, fileSize);
+            const chunk = this.readChunk(filePath, offset, end - offset);
+            const contentRange = `bytes ${offset}-${end - 1}/${fileSize}`;
+            chunkNo++;
+            let attempt = 0;
+            // Retry a single chunk on transient failure; on a 308 advance to where
+            // Google says it actually is (authoritative over our own offset).
+            // eslint-disable-next-line no-constant-condition
+            while (true) {
+                const res = await this.fetchWithTimeout(sessionUri, {
+                    method: "PUT",
+                    headers: {
+                        "Content-Type": "video/mp4",
+                        "Content-Range": contentRange,
+                    },
+                    body: chunk,
+                }, CHUNK_TIMEOUT_MS);
+                if (res.status === 200 || res.status === 201) {
+                    const json = (await res.json().catch(() => ({})));
+                    this.logger.info("Reel upload transfer complete", {
+                        courtId,
+                        uploadId,
+                        chunks: chunkNo,
+                        ...this.transferStats(fileSize, startedAt),
+                    });
+                    return json.id ?? null;
+                }
+                if (res.status === 308) {
+                    const kept = this.parseRangeEnd(res.headers.get("range"));
+                    offset = kept !== null ? kept + 1 : end; // trust Google's Range
+                    // Per-chunk progress: without this the whole transfer is silent
+                    // between "session created" and "uploaded", so a stall is
+                    // indistinguishable from normal operation.
+                    this.logger.debug("Reel upload progress", {
+                        courtId,
+                        uploadId,
+                        chunk: `${chunkNo}/${totalChunks}`,
+                        sentMb: +(offset / 1048576).toFixed(2),
+                        totalMb: +(fileSize / 1048576).toFixed(2),
+                        percent: Math.round((offset / fileSize) * 100),
+                    });
+                    break; // proceed to next chunk
+                }
+                // Non-terminal error → retry this chunk a few times, else give up.
+                if (attempt >= MAX_CHUNK_RETRIES) {
+                    throw new Error(`chunk PUT failed at ${contentRange}: status ${res.status}`);
+                }
+                attempt++;
+                // Surface retries: a flaky link should be visible, not silent.
+                this.logger.warn("Reel upload chunk retry", {
+                    courtId,
+                    uploadId,
+                    chunk: `${chunkNo}/${totalChunks}`,
+                    status: res.status,
+                    attempt,
+                    maxAttempts: MAX_CHUNK_RETRIES,
+                });
+                await this.delay(1000 * Math.pow(2, attempt - 1));
+            }
+        }
+        // Loop exited without a 200/201 (e.g. last 308 reported full size) — the
+        // caller treats a null video id as a failure and reports it.
+        return null;
+    }
+    // Step 7 — report the outcome to the backend (idempotent, safe to repeat).
+    async reportComplete(courtId, uploadId, payload) {
+        const url = `${this.baseUrl}/api/v1/padel-grounds/${this.groundId}/courts/${courtId}/videos/upload-session/${uploadId}/complete`;
+        const res = await this.fetchWithTimeout(url, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-streaming-api-key": this.streamingApiKey,
+            },
+            body: JSON.stringify(payload),
+        }, SESSION_TIMEOUT_MS);
+        if (!res.ok) {
+            // Log but don't throw: the reel is done and (on success) already on
+            // YouTube; a failed completion report is a backend-side reconciliation
+            // concern, not a device failure.
+            this.logger.warn("Reel upload completion report failed", {
+                courtId,
+                uploadId,
+                status: res.status,
+            });
+        }
+    }
+    // ── helpers ──
+    // Returns a plain ArrayBuffer — an unambiguous fetch BodyInit across the DOM
+    // and undici typings (a Node Buffer/Uint8Array trips a TS generic mismatch,
+    // though it works at runtime).
+    readChunk(filePath, start, length) {
+        const fd = fs.openSync(filePath, "r");
+        try {
+            const buf = Buffer.alloc(length);
+            fs.readSync(fd, buf, 0, length, start);
+            // Copy out an exact-length slice so no extra pool bytes leak into the body.
+            return buf.buffer.slice(buf.byteOffset, buf.byteOffset + buf.byteLength);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+    }
+    // Google's 308 Range header looks like "bytes=0-524287"; return the end index.
+    parseRangeEnd(range) {
+        if (!range)
+            return null;
+        const m = range.match(/bytes=\d+-(\d+)/);
+        return m ? parseInt(m[1], 10) : null;
+    }
+    isRatio(dims, w, h) {
+        // Allow ~1% tolerance for rounding (e.g. 1080x1920).
+        const target = w / h;
+        const actual = dims.width / dims.height;
+        return Math.abs(actual - target) / target <= 0.01;
+    }
+    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));
+        });
+    }
+    probeDurationSec(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 ? dur : null);
+            });
+            proc.on("error", () => resolve(null));
+        });
+    }
+    async fetchWithTimeout(url, init, timeoutMs) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            return await fetch(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async safeText(res) {
+        try {
+            return await res.text();
+        }
+        catch {
+            return "";
+        }
+    }
+    /** Elapsed time + average throughput, so a slow link is visible in the logs. */
+    transferStats(bytes, startedAt) {
+        const elapsedSec = Math.max(0.001, (Date.now() - startedAt) / 1000);
+        return {
+            elapsedSec: +elapsedSec.toFixed(1),
+            mbps: +((bytes * 8) / 1e6 / elapsedSec).toFixed(2),
+        };
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+exports.YouTubeUploadService = YouTubeUploadService;
+//# sourceMappingURL=YouTubeUploadService.js.map

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

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

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

@@ -0,0 +1,47 @@
+/**
+ * Samples whole-machine CPU + memory (and this process's RSS) at an interval,
+ * so a caller can report the resource spike a piece of work caused.
+ *
+ * ── IN SIMPLE WORDS ──
+ * Start it, do some heavy work, stop it — it tells you how busy the box's CPU
+ * got, how much RAM was in use before vs at the peak, and the machine load.
+ * Used to record, in the logs, exactly what building a highlight reel costs
+ * the streamer box (extract + reframe + render are CPU-heavy).
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * - CPU% is derived from `os.cpus()` cumulative times (deltas between ticks),
+ *   the same source as /proc/stat — a whole-machine 0-100 figure independent of
+ *   core count. Peak matters more than average for spotting contention.
+ * - The interval timer is `unref()`d so it can NEVER keep the process alive; if
+ *   stop() is somehow missed, the timer won't hold the event loop open.
+ * - Zero dependencies and pure Node os/process — safe to run on every box.
+ *
+ * ── DO NOT ──
+ * - Do NOT treat the numbers as per-process attribution: CPU% is the whole box
+ *   (which is the point — it captures the live encoder + the reel subprocesses
+ *   together). The baseline→peak memory delta is what the reel work added.
+ */
+export interface ResourceSummary {
+    cores: number;
+    samples: number;
+    cpuBusyPctPeak: number;
+    cpuBusyPctAvg: number;
+    memUsedMbBaseline: number;
+    memUsedMbPeak: number;
+    memTotalMb: number;
+    nodeRssMbPeak: number;
+    load1: number;
+}
+export declare class ResourceSampler {
+    private timer;
+    private prev;
+    private readonly cpu;
+    private readonly memUsed;
+    private readonly rss;
+    start(intervalMs?: number): void;
+    stop(): ResourceSummary;
+    private cpuTimes;
+    private usedMb;
+    private tick;
+}
+//# sourceMappingURL=ResourceSampler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ResourceSampler.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/utils/ResourceSampler.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,IAAI,CAAgD;IAC5D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAgB;IAE7B,KAAK,CAAC,UAAU,SAAO,GAAG,IAAI;IAQ9B,IAAI,IAAI,eAAe;IAqB9B,OAAO,CAAC,QAAQ;IAWhB,OAAO,CAAC,MAAM;IAId,OAAO,CAAC,IAAI;CAcb"}

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

@@ -0,0 +1,102 @@
+"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.ResourceSampler = void 0;
+const os = __importStar(require("os"));
+class ResourceSampler {
+    constructor() {
+        this.timer = null;
+        this.prev = null;
+        this.cpu = [];
+        this.memUsed = [];
+        this.rss = [];
+    }
+    start(intervalMs = 1000) {
+        if (this.timer)
+            return;
+        this.prev = this.cpuTimes();
+        this.timer = setInterval(() => this.tick(), intervalMs);
+        // Never let sampling hold the process open.
+        this.timer.unref?.();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        const peak = (a) => (a.length ? Math.max(...a) : 0);
+        const avg = (a) => a.length ? Math.round(a.reduce((s, x) => s + x, 0) / a.length) : 0;
+        return {
+            cores: os.cpus().length,
+            samples: this.cpu.length,
+            cpuBusyPctPeak: peak(this.cpu),
+            cpuBusyPctAvg: avg(this.cpu),
+            memUsedMbBaseline: this.memUsed[0] ?? this.usedMb(),
+            memUsedMbPeak: peak(this.memUsed),
+            memTotalMb: Math.round(os.totalmem() / 1048576),
+            nodeRssMbPeak: peak(this.rss),
+            load1: Math.round((os.loadavg()[0] ?? 0) * 100) / 100,
+        };
+    }
+    cpuTimes() {
+        let idle = 0;
+        let total = 0;
+        for (const c of os.cpus()) {
+            const t = c.times;
+            idle += t.idle;
+            total += t.user + t.nice + t.sys + t.idle + t.irq;
+        }
+        return { idle, total };
+    }
+    usedMb() {
+        return Math.round((os.totalmem() - os.freemem()) / 1048576);
+    }
+    tick() {
+        const cur = this.cpuTimes();
+        if (this.prev) {
+            const didle = cur.idle - this.prev.idle;
+            const dtot = cur.total - this.prev.total;
+            if (dtot > 0) {
+                const busy = Math.round(100 * (1 - didle / dtot));
+                this.cpu.push(Math.max(0, Math.min(100, busy)));
+            }
+        }
+        this.prev = cur;
+        this.memUsed.push(this.usedMb());
+        this.rss.push(Math.round(process.memoryUsage().rss / 1048576));
+    }
+}
+exports.ResourceSampler = ResourceSampler;
+//# sourceMappingURL=ResourceSampler.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * Wrap a command so a heavy one-shot HIGHLIGHT job runs at low CPU priority.
+ *
+ * ── IN SIMPLE WORDS ──
+ * The reel jobs (extract / reframe / render) are CPU-hungry. On a weak box they
+ * can hog the processor and slow down the LIVE stream's ffmpeg enough that its
+ * progress clock stalls — and the stall detector then restarts the live stream.
+ * Running these jobs with `nice` tells the OS "let the live stream go first",
+ * so a reel job can never starve the broadcast.
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * - `nice -n 19` (lowest priority) is from coreutils — present on every Linux
+ *   box and macOS, so this needs nothing installed. If `nice` were somehow
+ *   missing the spawn just errors, and every highlight path is already
+ *   fail-soft (returns null → full-frame fallback), so the live stream is never
+ *   affected either way.
+ * - Deliberately NOT using `ionice`: it lives in util-linux and could be absent,
+ *   which would turn a perf tweak into a hard failure. The contention that
+ *   trips the stall detector is CPU, not disk, so `nice` is the right lever.
+ *
+ * ── DO NOT ──
+ * - Do NOT use this to wrap the LIVE stream ffmpeg — it must keep normal
+ *   priority; that's the whole point.
+ */
+export declare function withLowPriority(command: string, args: string[]): {
+    command: string;
+    args: string[];
+};
+//# sourceMappingURL=lowPriority.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lowPriority.d.ts","sourceRoot":"","sources":["../../../../src/infrastructure/utils/lowPriority.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,GACb;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAErC"}

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

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withLowPriority = withLowPriority;
+/**
+ * Wrap a command so a heavy one-shot HIGHLIGHT job runs at low CPU priority.
+ *
+ * ── IN SIMPLE WORDS ──
+ * The reel jobs (extract / reframe / render) are CPU-hungry. On a weak box they
+ * can hog the processor and slow down the LIVE stream's ffmpeg enough that its
+ * progress clock stalls — and the stall detector then restarts the live stream.
+ * Running these jobs with `nice` tells the OS "let the live stream go first",
+ * so a reel job can never starve the broadcast.
+ *
+ * ── WHY IT'S BUILT THIS WAY (change at your peril) ──
+ * - `nice -n 19` (lowest priority) is from coreutils — present on every Linux
+ *   box and macOS, so this needs nothing installed. If `nice` were somehow
+ *   missing the spawn just errors, and every highlight path is already
+ *   fail-soft (returns null → full-frame fallback), so the live stream is never
+ *   affected either way.
+ * - Deliberately NOT using `ionice`: it lives in util-linux and could be absent,
+ *   which would turn a perf tweak into a hard failure. The contention that
+ *   trips the stall detector is CPU, not disk, so `nice` is the right lever.
+ *
+ * ── DO NOT ──
+ * - Do NOT use this to wrap the LIVE stream ffmpeg — it must keep normal
+ *   priority; that's the whole point.
+ */
+function withLowPriority(command, args) {
+    return { command: "nice", args: ["-n", "19", command, ...args] };
+}
+//# sourceMappingURL=lowPriority.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lowPriority.js","sourceRoot":"","sources":["../../../../src/infrastructure/utils/lowPriority.ts"],"names":[],"mappings":";;AAwBA,0CAKC;AA7BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,SAAgB,eAAe,CAC7B,OAAe,EACf,IAAc;IAEd,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;AACnE,CAAC"}