@farmslot/recipe-runner 0.28.5 → 0.30.0

package/dist/core/recording-limits.js

@@ -0,0 +1,74 @@
+import { readdir, stat } from 'node:fs/promises';
+import path from 'node:path';
+import { DEFAULT_RECORDED_EVIDENCE_POLICY } from '@farmslot/protocol';
+/** Own exactly one backend stop, retaining usable media when a configured limit ends capture early. */
+export function boundRecording(active, outputPath, policy) {
+    const duration = policy.maxDurationMs ?? DEFAULT_RECORDED_EVIDENCE_POLICY.maxDurationMs;
+    const bytes = policy.maxBytes ?? DEFAULT_RECORDED_EVIDENCE_POLICY.maxBytes;
+    let stopped;
+    let limitation;
+    let checking = false;
+    const stop = () => {
+        if (stopped)
+            return stopped;
+        clearTimeout(deadline);
+        clearInterval(poll);
+        stopped = active.stop().then((result) => {
+            if (!limitation || result.interruption)
+                return result;
+            return {
+                ...result,
+                interruption: {
+                    frames: result.segments.reduce((count, segment) => count + (segment.timing?.framesMs.length ?? 0), 0),
+                    mediaTimeMs: result.segments.at(-1)?.timing?.framesMs.at(-1) ?? 0,
+                    cause: limitation,
+                },
+            };
+        });
+        // Early stop completion is awaited by the engine's final stop; retain rejection until then.
+        void stopped.catch((error) => {
+            limitation ??= `Capture finalization failed: ${error instanceof Error ? error.message : String(error)}`;
+        });
+        return stopped;
+    };
+    const deadline = setTimeout(() => {
+        limitation = `Recording duration limit reached (${duration} ms).`;
+        void stop();
+    }, duration);
+    deadline.unref();
+    const poll = setInterval(async () => {
+        if (checking || stopped)
+            return;
+        checking = true;
+        try {
+            const directory = path.dirname(outputPath);
+            const files = (await readdir(directory)).filter((file) => file.endsWith('.mp4'));
+            const sizes = await Promise.all(files.map(async (file) => (await stat(path.join(directory, file))).size));
+            if (sizes.reduce((total, size) => total + size, 0) >= bytes) {
+                limitation = `Recording byte limit reached (${bytes} bytes).`;
+                void stop();
+            }
+        }
+        catch (error) {
+            limitation = `Recording budget could not be measured: ${error instanceof Error ? error.message : String(error)}`;
+            void stop();
+        }
+        finally {
+            checking = false;
+        }
+    }, 250);
+    poll.unref();
+    return {
+        stop,
+        ...(active.snapshot
+            ? {
+                snapshot: async (file) => {
+                    if (stopped)
+                        throw new Error(limitation ?? 'Recording is finalizing.');
+                    return active.snapshot(file);
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=recording-limits.js.map

package/dist/core/recording-limits.js.map

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

package/dist/core/recording-segments.d.ts

@@ -0,0 +1,4 @@
+import type { ActiveVideoRecording, VideoRecorder, VideoRecorderStartRequest } from './types.js';
+/** Backends with continuous segments handle their own boundaries; native restarts retain the gap. */
+export declare function startSegmentedRecording(recorder: VideoRecorder, request: VideoRecorderStartRequest): Promise<ActiveVideoRecording>;
+//# sourceMappingURL=recording-segments.d.ts.map

package/dist/core/recording-segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recording-segments.d.ts","sourceRoot":"","sources":["../../src/core/recording-segments.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,yBAAyB,EAG1B,MAAM,YAAY,CAAC;AAEpB,qGAAqG;AACrG,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,oBAAoB,CAAC,CAyF/B"}

package/dist/core/recording-segments.js

@@ -0,0 +1,101 @@
+import { stat } from 'node:fs/promises';
+/** Backends with continuous segments handle their own boundaries; native restarts retain the gap. */
+export async function startSegmentedRecording(recorder, request) {
+    if (recorder.continuousSegments)
+        return recorder.start(request);
+    let active = await recorder.start(request);
+    let output = request.outputPath;
+    let startedAt = Date.now();
+    let ended = false;
+    let failure;
+    let interruption;
+    const segments = [];
+    let boundary;
+    let stopped;
+    const collect = (result) => {
+        for (const [index, segment] of result.segments.entries())
+            segments.push({ ...segment, ...(segments.length && index === 0 ? { gapBefore: true } : {}) });
+        interruption ??= result.interruption;
+    };
+    const rotate = async () => {
+        collect(await active.stop());
+        if (interruption) {
+            ended = true;
+            return;
+        }
+        output = request.outputPath.replace(/\.mp4$/u, `-segment-${segments.length}.mp4`);
+        active = await recorder.start({ ...request, outputPath: output });
+        startedAt = Date.now();
+    };
+    const poll = setInterval(() => {
+        if (ended || boundary || failure)
+            return;
+        boundary = (async () => {
+            let size = 0;
+            try {
+                size = (await stat(output)).size;
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+            if (size >= 100 * 1024 * 1024 || Date.now() - startedAt >= 10 * 60 * 1000)
+                await rotate();
+        })()
+            .catch((error) => {
+            failure = error;
+            ended = true;
+        })
+            .finally(() => {
+            boundary = undefined;
+        });
+    }, 250);
+    poll.unref();
+    return {
+        ...(active.snapshot
+            ? {
+                snapshot: async (file) => {
+                    if (ended || failure)
+                        throw failure ?? new Error('Recording has stopped.');
+                    if (boundary)
+                        await boundary;
+                    if (ended || failure)
+                        throw failure ?? new Error('Recording has stopped.');
+                    const result = await active.snapshot(file);
+                    return { ...result, segmentIndex: segments.length };
+                },
+            }
+            : {}),
+        stop() {
+            if (stopped)
+                return stopped;
+            clearInterval(poll);
+            stopped = (async () => {
+                if (boundary)
+                    await boundary;
+                if (!ended) {
+                    ended = true;
+                    collect(await active.stop());
+                }
+                if (failure && !segments.length)
+                    throw failure;
+                return {
+                    segments,
+                    ...(interruption
+                        ? { interruption }
+                        : failure
+                            ? {
+                                interruption: {
+                                    frames: segments.reduce((count, segment) => count + (segment.timing?.framesMs.length ?? 0), 0),
+                                    mediaTimeMs: segments.at(-1)?.timing?.framesMs.at(-1) ?? 0,
+                                    cause: failure instanceof Error ? failure.message : String(failure),
+                                },
+                            }
+                            : {}),
+                };
+            })();
+            return stopped;
+        },
+    };
+}
+//# sourceMappingURL=recording-segments.js.map

package/dist/core/recording-segments.js.map

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

package/dist/core/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AAwEA,OAAO,KAAK,EACV,aAAa,EAEb,yBAAyB,EAMzB,YAAY,EAOb,MAAM,YAAY,CAAC;AA0BpB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAGzE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,YAAY,CAiCnF"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/core/runner.ts"],"names":[],"mappings":"AA0FA,OAAO,KAAK,EACV,aAAa,EAEb,yBAAyB,EAMzB,YAAY,EASb,MAAM,YAAY,CAAC;AA6BpB,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,CAGzE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,YAAY,CAiCnF"}