@memberjunction/video-studio-render-worker 0.0.1-seed.1 → 6.2.0-edge.8

package/dist/main.d.ts

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+import type { RenderBackend } from './backend.js';
+import { type RenderWorkerServer } from './server.js';
+/**
+ * Parsed runtime configuration derived from `RENDER_WORKER_ENV` environment variables.
+ */
+export interface RenderWorkerMainConfig {
+    Host: string;
+    Port: number;
+    Token?: string;
+    MaxBodyBytes: number;
+    Concurrency: number;
+    MaxTimeoutMs: number;
+    AllowRoot: boolean;
+}
+/**
+ * Options for `StartRenderWorkerFromEnv`.
+ */
+export interface StartRenderWorkerOptions {
+    /** Environment map (defaults to `process.env`). */
+    Env?: NodeJS.ProcessEnv;
+    /** Optional backend override (defaults to `new HyperFramesRenderBackend()`). */
+    Backend?: RenderBackend;
+    /** Optional effective UID override for unit testing root rejection. */
+    EffectiveUid?: number;
+    /** Optional stdout line writer (defaults to `(line) => process.stdout.write(line + '\n')`). */
+    WriteStdoutLine?: (line: string) => void;
+}
+/**
+ * Parses `RENDER_WORKER_ENV` environment variables into a validated `RenderWorkerMainConfig`.
+ */
+export declare function ParseRenderWorkerEnv(env?: NodeJS.ProcessEnv): RenderWorkerMainConfig;
+/**
+ * Validates that the worker is not running as root (`uid === 0`) unless `AllowRoot` is enabled.
+ */
+export declare function AssertNonRootUser(allowRoot: boolean, effectiveUid?: number): void;
+/**
+ * Redirects `console.log` and `console.info` to `process.stderr` so third-party libraries
+ * cannot pollute stdout after the `VIDEO_STUDIO_RENDER_WORKER_PORT=<port>` handshake line.
+ */
+export declare function RedirectConsoleStdoutToStderr(): void;
+/**
+ * Starts the HTTP render worker using `RENDER_WORKER_ENV`, writes
+ * `VIDEO_STUDIO_RENDER_WORKER_PORT=<port>` to stdout once listening, and returns the server handle.
+ */
+export declare function StartRenderWorkerFromEnv(options?: StartRenderWorkerOptions): Promise<RenderWorkerServer>;
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,OAAO,EAQH,KAAK,kBAAkB,EAC1B,MAAM,aAAa,CAAC;AAGrB;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACrC,mDAAmD;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,gFAAgF;IAChF,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,sBAAsB,CAyCjG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAYjF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,IAAI,CAMpD;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC1C,OAAO,GAAE,wBAA6B,GACvC,OAAO,CAAC,kBAAkB,CAAC,CA0B7B"}

package/dist/main.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+import * as fs from 'node:fs';
+import { pathToFileURL } from 'node:url';
+import { format as formatUtil } from 'node:util';
+import { RENDER_WORKER_ENV, RENDER_WORKER_PORT_PREFIX, } from '@memberjunction/video-studio-core';
+import { HyperFramesRenderBackend } from './hyperframes-backend.js';
+import { CreateRenderWorkerServer, DEFAULT_CONCURRENCY, DEFAULT_HOST, DEFAULT_MAX_BODY_BYTES, DEFAULT_MAX_BODY_MB, DEFAULT_MAX_TIMEOUT_MS, DEFAULT_PORT, } from './server.js';
+import { RunOneShot } from './one-shot.js';
+/**
+ * Parses `RENDER_WORKER_ENV` environment variables into a validated `RenderWorkerMainConfig`.
+ */
+export function ParseRenderWorkerEnv(env = process.env) {
+    const host = env[RENDER_WORKER_ENV.Host]?.trim() || DEFAULT_HOST;
+    const rawPort = env[RENDER_WORKER_ENV.Port]?.trim();
+    const port = rawPort !== undefined && rawPort !== '' ? Number.parseInt(rawPort, 10) : DEFAULT_PORT;
+    const token = env[RENDER_WORKER_ENV.Token]?.trim() || undefined;
+    const rawMaxBodyMb = env[RENDER_WORKER_ENV.MaxBodyMb]?.trim();
+    const maxBodyMb = rawMaxBodyMb !== undefined && rawMaxBodyMb !== ''
+        ? Number.parseFloat(rawMaxBodyMb)
+        : DEFAULT_MAX_BODY_MB;
+    const maxBodyBytes = Number.isFinite(maxBodyMb) && maxBodyMb > 0
+        ? Math.round(maxBodyMb * 1024 * 1024)
+        : DEFAULT_MAX_BODY_BYTES;
+    const rawConcurrency = env[RENDER_WORKER_ENV.Concurrency]?.trim();
+    const concurrency = rawConcurrency !== undefined && rawConcurrency !== ''
+        ? Math.max(1, Number.parseInt(rawConcurrency, 10) || DEFAULT_CONCURRENCY)
+        : DEFAULT_CONCURRENCY;
+    const rawTimeout = env[RENDER_WORKER_ENV.MaxTimeoutMs]?.trim();
+    const maxTimeoutMs = rawTimeout !== undefined && rawTimeout !== ''
+        ? Math.max(50, Number.parseInt(rawTimeout, 10) || DEFAULT_MAX_TIMEOUT_MS)
+        : DEFAULT_MAX_TIMEOUT_MS;
+    const rawAllowRoot = env[RENDER_WORKER_ENV.AllowRoot]?.trim().toLowerCase();
+    const allowRoot = rawAllowRoot === '1' || rawAllowRoot === 'true';
+    return {
+        Host: host,
+        Port: Number.isFinite(port) && port >= 0 ? port : DEFAULT_PORT,
+        Token: token,
+        MaxBodyBytes: maxBodyBytes,
+        Concurrency: concurrency,
+        MaxTimeoutMs: maxTimeoutMs,
+        AllowRoot: allowRoot,
+    };
+}
+/**
+ * Validates that the worker is not running as root (`uid === 0`) unless `AllowRoot` is enabled.
+ */
+export function AssertNonRootUser(allowRoot, effectiveUid) {
+    const uid = effectiveUid !== undefined
+        ? effectiveUid
+        : typeof process.getuid === 'function'
+            ? process.getuid()
+            : 10001;
+    if (uid === 0 && !allowRoot) {
+        throw new Error(`Refusing to start render worker as root (uid=0). Set ${RENDER_WORKER_ENV.AllowRoot}=1 only in trusted test environments.`);
+    }
+}
+/**
+ * Redirects `console.log` and `console.info` to `process.stderr` so third-party libraries
+ * cannot pollute stdout after the `VIDEO_STUDIO_RENDER_WORKER_PORT=<port>` handshake line.
+ */
+export function RedirectConsoleStdoutToStderr() {
+    const writeStderr = (...args) => {
+        process.stderr.write(`${formatUtil(...args)}\n`);
+    };
+    console.log = writeStderr;
+    console.info = writeStderr;
+}
+/**
+ * Starts the HTTP render worker using `RENDER_WORKER_ENV`, writes
+ * `VIDEO_STUDIO_RENDER_WORKER_PORT=<port>` to stdout once listening, and returns the server handle.
+ */
+export async function StartRenderWorkerFromEnv(options = {}) {
+    process.env.DO_NOT_TRACK = '1';
+    process.env.HYPERFRAMES_NO_TELEMETRY = '1';
+    const config = ParseRenderWorkerEnv(options.Env);
+    AssertNonRootUser(config.AllowRoot, options.EffectiveUid);
+    const backend = options.Backend ?? new HyperFramesRenderBackend();
+    const server = CreateRenderWorkerServer({
+        Backend: backend,
+        Host: config.Host,
+        Port: config.Port,
+        Token: config.Token,
+        BearerToken: config.Token,
+        MaxBodyBytes: config.MaxBodyBytes,
+        Concurrency: config.Concurrency,
+        MaxTimeoutMs: config.MaxTimeoutMs,
+    });
+    const boundPort = await server.Listen(config.Port, config.Host);
+    const writeLine = options.WriteStdoutLine ?? ((line) => void process.stdout.write(`${line}\n`));
+    writeLine(`${RENDER_WORKER_PORT_PREFIX}${boundPort}`);
+    RedirectConsoleStdoutToStderr();
+    return server;
+}
+function isStdinPipeOrSocket() {
+    try {
+        const stdinStat = fs.fstatSync(0);
+        return stdinStat.isFIFO() || stdinStat.isSocket();
+    }
+    catch {
+        return false;
+    }
+}
+async function runOneShotCliEntrypoint(argv) {
+    process.env.DO_NOT_TRACK = '1';
+    process.env.HYPERFRAMES_NO_TELEMETRY = '1';
+    const config = ParseRenderWorkerEnv(process.env);
+    AssertNonRootUser(config.AllowRoot);
+    RedirectConsoleStdoutToStderr();
+    const backend = new HyperFramesRenderBackend();
+    const abortController = new AbortController();
+    const isPipedStdin = isStdinPipeOrSocket();
+    let stdinClosedEarly = false;
+    const onSignal = () => {
+        abortController.abort();
+    };
+    process.once('SIGINT', onSignal);
+    process.once('SIGTERM', onSignal);
+    const onStdinClosed = () => {
+        stdinClosedEarly = true;
+        abortController.abort();
+    };
+    if (isPipedStdin) {
+        process.stdin.once('end', onStdinClosed);
+        process.stdin.once('close', onStdinClosed);
+        process.stdin.resume();
+    }
+    let exitCode = 1;
+    try {
+        exitCode = await RunOneShot(argv, backend, process.stdout, {
+            Stderr: process.stderr,
+            Stdin: isPipedStdin ? process.stdin : undefined,
+            Signal: abortController.signal,
+        });
+    }
+    finally {
+        if (isPipedStdin) {
+            process.stdin.removeListener('end', onStdinClosed);
+            process.stdin.removeListener('close', onStdinClosed);
+            process.stdin.pause();
+        }
+        await backend.Shutdown().catch(() => undefined);
+        if (stdinClosedEarly && process.pid > 1) {
+            // If our piped stdin closed while the job was still running (e.g. MJAPI died or
+            // docker exec -i was terminated), also signal PID 1 so a detached --rm container
+            // stops immediately instead of lingering.
+            try {
+                process.kill(1, 'SIGTERM');
+            }
+            catch {
+                // Best-effort when running inside a per-run container.
+            }
+        }
+    }
+    process.exit(exitCode);
+}
+async function runCliEntrypoint() {
+    try {
+        process.env.DO_NOT_TRACK = '1';
+        process.env.HYPERFRAMES_NO_TELEMETRY = '1';
+        if (process.argv[2] === 'run') {
+            await runOneShotCliEntrypoint(process.argv.slice(2));
+            return;
+        }
+        const backend = new HyperFramesRenderBackend();
+        const server = await StartRenderWorkerFromEnv({ Backend: backend });
+        let shuttingDown = false;
+        const shutdown = async () => {
+            if (shuttingDown) {
+                return;
+            }
+            shuttingDown = true;
+            await server.Close().catch(() => undefined);
+            await backend.Shutdown().catch(() => undefined);
+            process.exit(0);
+        };
+        process.once('SIGINT', () => void shutdown());
+        process.once('SIGTERM', () => void shutdown());
+        if (isStdinPipeOrSocket()) {
+            process.stdin.once('end', () => void shutdown());
+            process.stdin.once('close', () => void shutdown());
+            process.stdin.resume();
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`${message}\n`);
+        process.exit(1);
+    }
+}
+const isExecutedDirectly = typeof process.argv[1] === 'string' &&
+    import.meta.url === pathToFileURL(process.argv[1]).href;
+if (isExecutedDirectly) {
+    void runCliEntrypoint();
+}
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

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

package/dist/one-shot.d.ts

@@ -0,0 +1,37 @@
+import { type RenderBackend } from './backend.js';
+/** Supported operation names for `main.js run <op>`. */
+export declare const ONE_SHOT_OPERATIONS: readonly ["render", "stills", "contact-sheet", "check", "keyframes", "health"];
+/** Union of valid one-shot CLI operation names. */
+export type OneShotOperation = (typeof ONE_SHOT_OPERATIONS)[number];
+/** Usage message written to stderr when CLI arguments are invalid (exit code 2). */
+export declare const ONE_SHOT_USAGE = "Usage: main.js run <render|stills|contact-sheet|check|keyframes|health> --request <file> --out <dir>\n";
+/**
+ * Optional configuration for `RunOneShot`.
+ */
+export interface RunOneShotOptions {
+    /** Optional stderr writer for usage messages (defaults to `process.stderr`). */
+    Stderr?: {
+        write(chunk: string): unknown;
+    };
+    /**
+     * Optional readable stdin stream. When this pipe emits `end` or `close` while the
+     * operation is in flight, the job's `AbortSignal` is triggered immediately.
+     */
+    Stdin?: NodeJS.ReadableStream;
+    /** Optional external cancellation signal. */
+    Signal?: AbortSignal;
+    /** Optional temporary directory root forwarded to `Run*Job`. */
+    TempRoot?: string;
+}
+/**
+ * Executes a single render-worker operation from files on disk (`--request <file> --out <dir>`),
+ * streaming `RenderStreamEvent` `Progress` JSON lines to `stdout` for `render`, writing the
+ * operation output to `<out>/result.json` (plus `<out>/video.mp4` for `render`), or writing
+ * `<out>/error.json` (`RenderWorkerErrorBody`) on failure.
+ *
+ * @returns Exit code: `0` on success, `1` on job/runtime failure, `2` on invalid CLI arguments.
+ */
+export declare function RunOneShot(argv: readonly string[], backend: RenderBackend, stdout?: {
+    write(chunk: string): unknown;
+}, options?: RunOneShotOptions): Promise<number>;
+//# sourceMappingURL=one-shot.d.ts.map

package/dist/one-shot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"one-shot.d.ts","sourceRoot":"","sources":["../src/one-shot.ts"],"names":[],"mappings":"AAWA,OAAO,EAAqB,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAUrE,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,gFAOtB,CAAC;AAEX,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEpE,oFAAoF;AACpF,eAAO,MAAM,cAAc,2GACiF,CAAC;AAE7G;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B,gFAAgF;IAChF,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC3C;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IAC9B,6CAA6C;IAC7C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAQD;;;;;;;GAOG;AACH,wBAAsB,UAAU,CAC5B,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,GAAE;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAAmB,EAC1D,OAAO,GAAE,iBAAsB,GAChC,OAAO,CAAC,MAAM,CAAC,CAkJjB"}

package/dist/one-shot.js

@@ -0,0 +1,228 @@
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { RenderWorkerError } from './backend.js';
+import { GetWorkerHealth, RunCheckJob, RunContactSheetJob, RunKeyframesJob, RunRenderJob, RunStillsJob, } from './jobs.js';
+/** Supported operation names for `main.js run <op>`. */
+export const ONE_SHOT_OPERATIONS = [
+    'render',
+    'stills',
+    'contact-sheet',
+    'check',
+    'keyframes',
+    'health',
+];
+/** Usage message written to stderr when CLI arguments are invalid (exit code 2). */
+export const ONE_SHOT_USAGE = 'Usage: main.js run <render|stills|contact-sheet|check|keyframes|health> --request <file> --out <dir>\n';
+/**
+ * Executes a single render-worker operation from files on disk (`--request <file> --out <dir>`),
+ * streaming `RenderStreamEvent` `Progress` JSON lines to `stdout` for `render`, writing the
+ * operation output to `<out>/result.json` (plus `<out>/video.mp4` for `render`), or writing
+ * `<out>/error.json` (`RenderWorkerErrorBody`) on failure.
+ *
+ * @returns Exit code: `0` on success, `1` on job/runtime failure, `2` on invalid CLI arguments.
+ */
+export async function RunOneShot(argv, backend, stdout = process.stdout, options = {}) {
+    const stderr = options.Stderr ?? process.stderr;
+    const parsedArgs = parseOneShotArgs(argv);
+    if (!parsedArgs) {
+        stderr.write(ONE_SHOT_USAGE);
+        return 2;
+    }
+    const { Operation: op, RequestPath: requestPath, OutDir: outDir } = parsedArgs;
+    try {
+        await fs.mkdir(outDir, { recursive: true });
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        stderr.write(`Failed to create output directory "${outDir}": ${message}\n`);
+        return 1;
+    }
+    const controller = new AbortController();
+    const onExternalAbort = () => {
+        controller.abort(options.Signal?.reason);
+    };
+    if (options.Signal) {
+        if (options.Signal.aborted) {
+            controller.abort(options.Signal.reason);
+        }
+        else {
+            options.Signal.addEventListener('abort', onExternalAbort, { once: true });
+        }
+    }
+    const onStdinClosed = () => {
+        if (!controller.signal.aborted) {
+            controller.abort(new RenderWorkerError('Cancelled', 'One-shot worker stdin pipe closed.'));
+        }
+    };
+    if (options.Stdin) {
+        options.Stdin.once('end', onStdinClosed);
+        options.Stdin.once('close', onStdinClosed);
+        options.Stdin.resume();
+    }
+    try {
+        throwIfAborted(controller.signal);
+        if (op === 'health') {
+            if (requestPath !== undefined) {
+                await readRequestJson(requestPath);
+            }
+            throwIfAborted(controller.signal);
+            const health = await GetWorkerHealth(backend);
+            throwIfAborted(controller.signal);
+            await writeJsonFile(path.join(outDir, 'result.json'), health);
+            return 0;
+        }
+        const rawRequest = await readRequestJson(requestPath);
+        throwIfAborted(controller.signal);
+        switch (op) {
+            case 'render': {
+                const renderResult = await RunRenderJob(rawRequest, backend, (progress) => {
+                    const event = { Type: 'Progress', Progress: progress };
+                    stdout.write(`${JSON.stringify(event)}\n`);
+                }, controller.signal, { TempRoot: options.TempRoot });
+                const videoFilename = 'video.mp4';
+                await fs.writeFile(path.join(outDir, videoFilename), renderResult.Video);
+                const metadata = {
+                    Format: renderResult.Format,
+                    VideoID: videoFilename,
+                    VideoSizeBytes: renderResult.Video.byteLength,
+                    MimeType: renderResult.MimeType,
+                    Width: renderResult.Width,
+                    Height: renderResult.Height,
+                    Fps: renderResult.Fps,
+                    DurationSeconds: renderResult.DurationSeconds,
+                    FrameCount: renderResult.FrameCount,
+                    HasAudio: renderResult.HasAudio,
+                    RendererVersion: renderResult.RendererVersion,
+                    RenderDurationMs: renderResult.RenderDurationMs,
+                };
+                await writeJsonFile(path.join(outDir, 'result.json'), metadata);
+                return 0;
+            }
+            case 'stills': {
+                const stillsResult = await RunStillsJob(rawRequest, backend, controller.signal, { TempRoot: options.TempRoot });
+                await writeJsonFile(path.join(outDir, 'result.json'), stillsResult);
+                return 0;
+            }
+            case 'contact-sheet': {
+                const contactSheetResult = await RunContactSheetJob(rawRequest, backend, controller.signal, { TempRoot: options.TempRoot });
+                await writeJsonFile(path.join(outDir, 'result.json'), contactSheetResult);
+                return 0;
+            }
+            case 'check': {
+                const checkResult = await RunCheckJob(rawRequest, backend, controller.signal, { TempRoot: options.TempRoot });
+                await writeJsonFile(path.join(outDir, 'result.json'), checkResult);
+                return 0;
+            }
+            case 'keyframes': {
+                const keyframeResult = await RunKeyframesJob(rawRequest, backend, controller.signal, { TempRoot: options.TempRoot });
+                await writeJsonFile(path.join(outDir, 'result.json'), keyframeResult);
+                return 0;
+            }
+        }
+    }
+    catch (error) {
+        const workerError = toRenderWorkerError(error, controller.signal);
+        await writeJsonFile(path.join(outDir, 'error.json'), workerError.ToBody()).catch(() => undefined);
+        return 1;
+    }
+    finally {
+        if (options.Signal) {
+            options.Signal.removeEventListener('abort', onExternalAbort);
+        }
+        if (options.Stdin) {
+            options.Stdin.removeListener('end', onStdinClosed);
+            options.Stdin.removeListener('close', onStdinClosed);
+        }
+    }
+}
+function parseOneShotArgs(argv) {
+    const tokens = argv[0] === 'run' ? argv.slice(1) : argv;
+    if (tokens.length === 0) {
+        return null;
+    }
+    const opCandidate = tokens[0];
+    if (!isOneShotOperation(opCandidate)) {
+        return null;
+    }
+    let requestPath;
+    let outDir;
+    let i = 1;
+    while (i < tokens.length) {
+        const flag = tokens[i];
+        const value = tokens[i + 1];
+        if (flag === '--request') {
+            if (!value || value.startsWith('--') || requestPath !== undefined) {
+                return null;
+            }
+            requestPath = value;
+            i += 2;
+        }
+        else if (flag === '--out') {
+            if (!value || value.startsWith('--') || outDir !== undefined) {
+                return null;
+            }
+            outDir = value;
+            i += 2;
+        }
+        else {
+            return null;
+        }
+    }
+    if (!outDir || outDir.trim().length === 0) {
+        return null;
+    }
+    if (opCandidate !== 'health' && (!requestPath || requestPath.trim().length === 0)) {
+        return null;
+    }
+    return {
+        Operation: opCandidate,
+        RequestPath: requestPath,
+        OutDir: outDir,
+    };
+}
+function isOneShotOperation(value) {
+    return (value !== undefined &&
+        ONE_SHOT_OPERATIONS.includes(value));
+}
+async function readRequestJson(requestPath) {
+    let raw;
+    try {
+        raw = await fs.readFile(requestPath, 'utf8');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new RenderWorkerError('InvalidRequest', `Unable to read request file "${requestPath}": ${message}`);
+    }
+    try {
+        return JSON.parse(raw);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new RenderWorkerError('InvalidRequest', `Invalid JSON in request file "${requestPath}": ${message}`);
+    }
+}
+async function writeJsonFile(filePath, payload) {
+    await fs.writeFile(filePath, JSON.stringify(payload), 'utf8');
+}
+function throwIfAborted(signal) {
+    if (!signal.aborted) {
+        return;
+    }
+    if (signal.reason instanceof RenderWorkerError) {
+        throw signal.reason;
+    }
+    throw new RenderWorkerError('Cancelled', 'One-shot worker operation was cancelled.');
+}
+function toRenderWorkerError(error, signal) {
+    if (error instanceof RenderWorkerError) {
+        return error;
+    }
+    if (signal.aborted) {
+        if (signal.reason instanceof RenderWorkerError) {
+            return signal.reason;
+        }
+        return new RenderWorkerError('Cancelled', error instanceof Error ? error.message : 'One-shot worker operation was cancelled.');
+    }
+    return new RenderWorkerError('Internal', error instanceof Error ? error.message : String(error));
+}
+//# sourceMappingURL=one-shot.js.map

package/dist/one-shot.js.map

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

package/dist/preamble.d.ts

@@ -0,0 +1,69 @@
+import type { RenderProjectBundle, VideoFormat } from '@memberjunction/video-studio-core';
+/**
+ * Strict Content-Security-Policy injected into every staged HTML file (Decision 3).
+ *
+ * Blocks all external network egress (`connect-src 'none'`, `frame-src 'none'`, `worker-src 'none'`,
+ * `object-src 'none'`, `base-uri 'none'`, `form-action 'none'`) while allowing local bundle files
+ * (`'self'`), `data:` / `blob:` URIs, and inline composition scripts/styles.
+ */
+export declare const COMPOSITION_CSP: string;
+/**
+ * Options used to construct the injected `window.MJVideo` runtime preamble.
+ */
+export interface PreambleRuntimeOptions {
+    /** Bound data snapshot exposed at `window.MJVideo.Data`. */
+    DataSnapshot: Record<string, unknown>;
+    /** Integer seed exposed at `window.MJVideo.Seed`. */
+    Seed: number;
+    /** Target video aspect-ratio format. */
+    Format: VideoFormat;
+    /** Output frame width in pixels. */
+    Width: number;
+    /** Output frame height in pixels. */
+    Height: number;
+    /** Output frame rate in frames per second. */
+    Fps: number;
+    /** Optional composition duration in seconds. */
+    DurationSeconds?: number;
+}
+/**
+ * Default SIL OFL font families bundled in the RenderWorker package (`assets/fonts/`)
+ * under `MJ Sans` (`Inter-Regular.ttf`) and `MJ Mono` (`JetBrainsMono-Regular.ttf`) so
+ * HyperFrames' font compiler never maps them to Google Fonts and compositions render
+ * deterministically offline with `FontIsBundled: true` (VS-RND-5 Decision 4 / Round 1).
+ */
+export declare const BUNDLED_DEFAULT_FONTS: readonly ["MJ Sans", "MJ Mono"];
+/**
+ * Builds the `<meta http-equiv="Content-Security-Policy">` tag injected into every `.html` file.
+ */
+export declare function BuildCspMetaTag(): string;
+/**
+ * Builds the `<style data-mj-default-fonts>` tag registering the worker's bundled `MJ Sans`
+ * (`Inter-Regular.ttf`) and `MJ Mono` (`JetBrainsMono-Regular.ttf`) `@font-face` rules served from `/__mj_fonts/`.
+ */
+export declare function BuildDefaultFontsStyleTag(): string;
+/**
+ * Escapes a JSON string for safe embedding inside an HTML `<script>` element (`<`, `>`, U+2028, U+2029).
+ */
+export declare function EscapeJsonForInlineScript(value: unknown): string;
+/**
+ * Builds the inline JavaScript source that defines a frozen `window.MJVideo: MJVideoRuntime`,
+ * replaces `Math.random` with `MJVideo.Random`, and hooks HyperFrames' `window.__hf.seek`.
+ */
+export declare function BuildPreambleScript(options: PreambleRuntimeOptions): string;
+/**
+ * Injects the CSP `<meta>` tag, bundled default `@font-face` `<style>`, and the `window.MJVideo`
+ * inline `<script>` right after `<!doctype ...>` (or at byte 0 when no doctype is present).
+ * The preamble is collapsed onto a single line so line numbers in staged HTML remain unchanged.
+ */
+export declare function InjectPreambleIntoHtml(html: string, options: PreambleRuntimeOptions): string;
+/**
+ * Convenience helper constructing `PreambleRuntimeOptions` from a `RenderProjectBundle` plus frame geometry.
+ */
+export declare function BuildPreambleOptionsFromBundle(bundle: RenderProjectBundle, geometry?: {
+    Width?: number;
+    Height?: number;
+    Fps?: number;
+    DurationSeconds?: number;
+}): PreambleRuntimeOptions;
+//# sourceMappingURL=preamble.d.ts.map

package/dist/preamble.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preamble.d.ts","sourceRoot":"","sources":["../src/preamble.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAC;AAE1F;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,QAUhB,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,MAAM,EAAE,WAAW,CAAC;IACpB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,iCAAkC,CAAC;AAErE;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,IAAI,MAAM,CAOlD;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAOhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAuO3E;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAa5F;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC1C,MAAM,EAAE,mBAAmB,EAC3B,QAAQ,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACvF,sBAAsB,CAWxB"}