@cliangdev/conductor 0.22.0 → 0.24.0

package/dist/lib/poster-sheet.js

@@ -0,0 +1,57 @@
+/**
+ * Composes several poster JPEGs (one per CLIP placement) into a single small "key moments" sheet
+ * image with ffmpeg's hstack filter, so `preview_creative` has something to show for a CLIP
+ * creative — which has no server-rendered contact sheet the way a STILL creative's previewOnly
+ * render does (rendering one locally isn't possible either: CLIP has no browser-driven render path,
+ * see render_creative in tools/creatives.ts). Shares ffmpeg discovery with media-probe.ts rather
+ * than duplicating it.
+ */
+import { spawn } from 'node:child_process';
+import { readFile, unlink } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { resolveFfmpegPath } from './media-probe.js';
+const SHEET_HEIGHT = 360;
+/** One `scale=-2:360` per input, then an hstack chaining every scaled output left to right. A single
+ * input skips the stack (nothing to stack) and just scales. */
+export function buildSheetFilterComplex(count) {
+    if (count === 1)
+        return `[0:v]scale=-2:${SHEET_HEIGHT}[v]`;
+    const scales = Array.from({ length: count }, (_, i) => `[${i}:v]scale=-2:${SHEET_HEIGHT}[v${i}]`).join(';');
+    const stackInputs = Array.from({ length: count }, (_, i) => `[v${i}]`).join('');
+    return `${scales};${stackInputs}hstack=inputs=${count}[v]`;
+}
+/**
+ * Composes the given local poster JPEGs left to right into one JPEG sheet, each scaled to ~360px
+ * high. Throws on any ffmpeg failure (no binary, a bad/corrupt poster, etc.) — callers should catch
+ * this and fall back to showing a single poster on its own rather than nothing.
+ */
+export async function composePosterSheet(posterPaths) {
+    if (posterPaths.length === 0) {
+        throw new Error('composePosterSheet needs at least one poster image');
+    }
+    const ffmpegPath = await resolveFfmpegPath();
+    const outPath = join(tmpdir(), `conductor-sheet-${randomUUID()}.jpg`);
+    const inputs = posterPaths.flatMap((p) => ['-i', p]);
+    const args = ['-y', ...inputs, '-filter_complex', buildSheetFilterComplex(posterPaths.length), '-map', '[v]', '-q:v', '3', outPath];
+    await new Promise((resolve, reject) => {
+        const child = spawn(ffmpegPath, args, { stdio: ['ignore', 'ignore', 'pipe'] });
+        let stderr = '';
+        child.stderr.on('data', (d) => (stderr += d));
+        child.on('error', reject);
+        child.on('exit', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`ffmpeg sheet composition failed (exit ${code}): ${stderr.trim().slice(-2000) || 'no error output'}`));
+        });
+    });
+    try {
+        return await readFile(outPath);
+    }
+    finally {
+        await unlink(outPath).catch(() => { });
+    }
+}
+//# sourceMappingURL=poster-sheet.js.map

package/dist/lib/poster-sheet.js.map

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