@hyperframes/engine 0.8.208 → 0.8.209

package/dist/index.d.ts

@@ -73,8 +73,8 @@ export { aacSegmentCount, encodeAac } from "./services/aacEncode.js";
 export { ManagedChildProcess, type ManagedChildProcessOptions, type ManagedChildProcessOutcome, type ManagedProcessTerminationReason, } from "./utils/managedChildProcess.js";
 export { assertConfiguredFfmpegBinariesExist, getFfmpegBinary, getFfprobeBinary, FFMPEG_PATH_ENV, FFPROBE_PATH_ENV, } from "./utils/ffmpegBinaries.js";
 export { trackChildProcess, killTrackedProcesses } from "./utils/processTracker.js";
-export { renameWithRetry, renameWithRetryAsync } from "./utils/renameWithRetry.js";
-export { removeScratch, collectScratchLeftovers } from "./utils/removeScratch.js";
+export { renameWithRetry, renameWithRetryAsync } from "@hyperframes/core/rename-retry";
+export { removeScratch, collectScratchLeftovers } from "@hyperframes/core/remove-scratch";
 export { psnrDb, resolveDeVerifyMinDb } from "./utils/psnr.js";
 export { decodePng, decodePngToRgb48le, blitRgba8OverRgb48le, blitRgb48leRegion, blitRgb48leAffine, parseTransformMatrix, roundedRectAlpha, resampleRgb48leObjectFit, normalizeObjectFit, type ObjectFit, } from "./utils/alphaBlit.js";
 export { groupIntoLayers, type CompositeLayer } from "./utils/layerCompositor.js";
@@ -87,3 +87,4 @@ export { isHdrColorSpace, detectTransfer, getHdrEncoderColorParams, analyzeCompo
 export type { VideoColorSpace } from "./utils/ffprobe.js";
 export { renderProvenanceArgs, appendRenderProvenanceArgs, readRenderProvenance, PROVENANCE_RENDERER_TAG, PROVENANCE_VERSION_TAG, PROVENANCE_RENDERER_NAME, PROVENANCE_VERSION, type RenderProvenance, } from "./utils/renderProvenance.js";
 export { DrawElementCaptureError, isDrawElementCaptureError, } from "./services/drawElementCaptureError.js";
+export { inAgentSandbox, isOneProcessOverPipe, machServiceDenied, oneProcessOverPipe, pipeLaunchClosedOnMac, sandboxDeniedRemediation, } from "./services/sandboxLaunch.js";

package/dist/index.js

@@ -77,8 +77,8 @@ export { aacSegmentCount, encodeAac } from "./services/aacEncode.js";
 export { ManagedChildProcess, } from "./utils/managedChildProcess.js";
 export { assertConfiguredFfmpegBinariesExist, getFfmpegBinary, getFfprobeBinary, FFMPEG_PATH_ENV, FFPROBE_PATH_ENV, } from "./utils/ffmpegBinaries.js";
 export { trackChildProcess, killTrackedProcesses } from "./utils/processTracker.js";
-export { renameWithRetry, renameWithRetryAsync } from "./utils/renameWithRetry.js";
-export { removeScratch, collectScratchLeftovers } from "./utils/removeScratch.js";
+export { renameWithRetry, renameWithRetryAsync } from "@hyperframes/core/rename-retry";
+export { removeScratch, collectScratchLeftovers } from "@hyperframes/core/remove-scratch";
 // drawElement self-verify comparison — shared by the streaming drain
 // (producer) and the parallel disk-path verify (parallelCoordinator).
 export { psnrDb, resolveDeVerifyMinDb } from "./utils/psnr.js";
@@ -93,3 +93,4 @@ export { hideVideoElements, showVideoElements, queryVideoElementBounds, queryEle
 export { isHdrColorSpace, detectTransfer, getHdrEncoderColorParams, analyzeCompositionHdr, findHdrAutoPromotion, formatHdrAutoPromotionWarning, sanitizeHdrAutoPromotionAsset, DEFAULT_HDR10_MASTERING, HDR_AUTO_PROMOTION_PIPELINE, } from "./utils/hdr.js";
 export { renderProvenanceArgs, appendRenderProvenanceArgs, readRenderProvenance, PROVENANCE_RENDERER_TAG, PROVENANCE_VERSION_TAG, PROVENANCE_RENDERER_NAME, PROVENANCE_VERSION, } from "./utils/renderProvenance.js";
 export { DrawElementCaptureError, isDrawElementCaptureError, } from "./services/drawElementCaptureError.js";
+export { inAgentSandbox, isOneProcessOverPipe, machServiceDenied, oneProcessOverPipe, pipeLaunchClosedOnMac, sandboxDeniedRemediation, } from "./services/sandboxLaunch.js";

package/dist/services/aacEncode.js

@@ -4,7 +4,7 @@
  */
 import { execFile } from "node:child_process";
 import { mkdtempSync, readFileSync, writeFileSync } from "node:fs";
-import { removeScratch } from "../utils/removeScratch.js";
+import { removeScratch } from "@hyperframes/core/remove-scratch";
 import { dirname, join } from "node:path";
 import { getFfmpegBinary } from "../utils/ffmpegBinaries.js";
 import { runFfmpeg } from "../utils/runFfmpeg.js";

package/dist/services/audioFxRender.js

@@ -18,8 +18,8 @@ import { pathToFileURL } from "node:url";
 import { getAudioFxRuntimeScript } from "@hyperframes/core/audio-fx-runtime";
 import { enabledAudioFxNodes } from "@hyperframes/core/audio-fx";
 import { serializeAutomation } from "@hyperframes/core/audio-automation";
-import { removeScratch } from "../utils/removeScratch.js";
-import { acquireBrowser } from "./browserManager.js";
+import { removeScratch } from "@hyperframes/core/remove-scratch";
+import { acquireBrowser, buildChromeArgs } from "./browserManager.js";
 import { createEnvelopeWalker } from "./audioVolumeEnvelope.js";
 import { riffChunks, wavFormatTag } from "./wavChunks.js";
 import { windowPrerollSeconds } from "./audioFxWarmup.js";
@@ -439,6 +439,9 @@ export async function applyAudioFxChain(inputWav, chain, outputWav, options) {
         }
     });
 }
+/** Audio processing needs no GPU, so software mode; every other launch detail is the shared one. */
+let fxBrowserArgs;
+const fxChromeArgs = () => (fxBrowserArgs ??= buildChromeArgs({ width: 1280, height: 720, captureMode: "screenshot" }, { browserGpuMode: "software" }));
 /** Run `body` with a leased browser and a way to open pages on the runtime; both are released in the same try that takes them. */
 async function withFxBrowser(options, body) {
     const hostDir = mkdtempSync(join(tmpdir(), "hf-fx-host-"));
@@ -451,7 +454,7 @@ async function withFxBrowser(options, body) {
         if (options.signal?.aborted) {
             throw new AudioFxRenderError(`Audio FX cancelled for track ${options.trackId}`);
         }
-        lease = await acquireBrowser(["--no-sandbox", "--autoplay-policy=no-user-gesture-required"]);
+        lease = await acquireBrowser(fxChromeArgs());
         const { browser } = lease;
         return await body(() => openFxPage(browser, hostDir));
     }

package/dist/services/audioMixer.js

@@ -1,8 +1,8 @@
 // fallow-ignore-file complexity code-duplication
 import { isSelfOrAncestorHidden, memberGroupKey, isMemberGroupHidden } from "./mediaHidden.js";
 import { closeSync, existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "fs";
-import { renameWithRetry } from "../utils/renameWithRetry.js";
-import { removeScratch } from "../utils/removeScratch.js";
+import { renameWithRetry } from "@hyperframes/core/rename-retry";
+import { removeScratch } from "@hyperframes/core/remove-scratch";
 import { join, dirname, isAbsolute, relative } from "path";
 import { parseHTML } from "linkedom";
 import { extractAudioMetadata } from "../utils/ffprobe.js";
@@ -78,11 +78,11 @@ function buildAtempoFilter(playbackRate) {
 const RAMP_SLICE_SECONDS = 0.25;
 const MAX_RAMP_SLICES = 240;
 /** Bake a rate lane as consecutive source slices, each stretched by its mean `sourceTimeAt` rate, keeping pitch. */
-function buildRampFilterComplex(lane, duration, headFilter, tailFilter) {
+function buildRampFilterComplex(lane, duration, headFilter, tailFilter, input) {
     const slices = Math.min(MAX_RAMP_SLICES, Math.max(1, Math.ceil(duration / RAMP_SLICE_SECONDS)));
     const step = duration / slices;
     const split = Array.from({ length: slices }, (_, i) => `[s${i}]`).join("");
-    const parts = [`[0:a]${headFilter ? `${headFilter},` : ""}asplit=${slices}${split}`];
+    const parts = [`[${input}]${headFilter ? `${headFilter},` : ""}asplit=${slices}${split}`];
     for (let i = 0; i < slices; i += 1) {
         const from = sourceTimeAt(lane, i * step);
         const to = sourceTimeAt(lane, (i + 1) * step);
@@ -103,17 +103,17 @@ function buildRampFilterComplex(lane, duration, headFilter, tailFilter) {
         parts.push(`[cat]${tailFilter}[out]`);
     return parts.join(";");
 }
-function preparedAudioOutputArgs(metadata, playbackRate, duration, headFilter) {
+function preparedAudioOutputArgs(metadata, playbackRate, duration, headFilter, stream) {
     const channelFilter = metadata?.channels === 1 ? STEREO_CHANNEL_FILTER : null;
     const outputArgs = channelFilter ? [] : ["-ac", "2"];
     if (typeof playbackRate === "object") {
-        const graph = buildRampFilterComplex(playbackRate, duration, headFilter, channelFilter);
+        const graph = buildRampFilterComplex(playbackRate, duration, headFilter, channelFilter, stream ?? "0:a");
         return ["-filter_complex", graph, "-map", "[out]", ...outputArgs];
     }
     const filters = [headFilter, channelFilter, buildAtempoFilter(playbackRate)].filter(Boolean);
     if (filters.length > 0)
         outputArgs.push("-af", filters.join(","));
-    return outputArgs;
+    return [...(stream ? ["-map", stream] : []), ...outputArgs];
 }
 function escapeExpressionCommas(expression) {
     return expression.replace(/\\/g, "\\\\").replace(/,/g, "\\,");
@@ -545,7 +545,7 @@ async function extractAudioSegment(srcPath, outputPath, stage, mediaStart, durat
             const cycle = await extractAudioSegment(srcPath, cyclePath, stage, mediaStart, loopDuration, 1, signal, config, audioSidecarUrl, { padToDuration: true });
             if (!cycle.success)
                 return { ...cycle, outputPath };
-            const outputArgs = preparedAudioOutputArgs(metadata, normalizedPlaybackRate, duration, null);
+            const outputArgs = preparedAudioOutputArgs(metadata, normalizedPlaybackRate, duration, null, null);
             const result = await runFfmpeg([
                 "-stream_loop",
                 "-1",
@@ -591,7 +591,7 @@ async function extractAudioSegment(srcPath, outputPath, stage, mediaStart, durat
         ...(options?.padToDuration ? ["apad"] : []),
     ]
         .filter(Boolean)
-        .join(",") || null);
+        .join(",") || null, metadata ? `0:a:${metadata.audioStream}` : null);
     const readFrom = fromSidecar ? audioSidecarUrl : srcPath;
     const args = [
         ...(readsUrl ? FAIL_ON_READ_ERROR_INSTEAD_OF_ENDING_THERE : []),

package/dist/services/audioVolumeEnvelope.js

@@ -15,7 +15,7 @@
  * the caller can fall back to the expression path rather than corrupting audio.
  */
 import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "fs";
-import { renameWithRetry } from "../utils/renameWithRetry.js";
+import { renameWithRetry } from "@hyperframes/core/rename-retry";
 import { dirname, join } from "path";
 import { normaliseEnvelope } from "@hyperframes/core/media-volume-envelope";
 import { riffChunks, wavFormatTag } from "./wavChunks.js";

package/dist/services/browserManager.js

@@ -7,6 +7,7 @@
  */
 import { explainChromeLaunchFailure } from "./chromeStartup.js";
 import { withHyperframesBrowserMarker } from "@hyperframes/core/browser-marker";
+import { inAgentSandbox, machServiceDenied, oneProcessOverPipe, pipeLaunchClosedOnMac, sandboxDeniedRemediation, } from "./sandboxLaunch.js";
 import { scanHtmlOpeningTags } from "@hyperframes/parsers/html-attribute-spans";
 import { execSync } from "child_process";
 import { existsSync, readdirSync, statSync } from "fs";
@@ -666,14 +667,27 @@ export async function acquireBrowser(chromeArgs, config) {
     const enablePool = config?.enableBrowserPool ?? DEFAULT_CONFIG.enableBrowserPool;
     return browserLeasePool.acquire(createBrowserLaunchFingerprint(chromeArgs, config), enablePool);
 }
+/** An agent's macOS seatbelt allows one launch shape only: Chrome in one process over a pipe. */
+async function launchInsideSandbox(ppt, options) {
+    const sandboxed = inAgentSandbox();
+    try {
+        return await ppt.launch(sandboxed ? oneProcessOverPipe(options) : options);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "";
+        const refused = machServiceDenied(message) || pipeLaunchClosedOnMac(error);
+        if (process.platform !== "darwin" || sandboxed || !refused)
+            throw error;
+        return ppt.launch(oneProcessOverPipe(options));
+    }
+}
 // fallow-ignore-next-line complexity
 async function launchBrowser(fingerprint) {
     const ppt = await getPuppeteer();
     const env = launchEnv(fingerprint);
     let captureMode = fingerprint.requestedCaptureMode;
     let browser;
-    const launch = (args) => ppt
-        .launch({
+    const launch = (args) => launchInsideSandbox(ppt, {
         ...ownedLaunchOptions(),
         headless: true,
         args: withHyperframesBrowserMarker(args),
@@ -682,8 +696,11 @@ async function launchBrowser(fingerprint) {
         env,
         timeout: fingerprint.browserTimeoutMs,
         protocolTimeout: fingerprint.protocolTimeoutMs,
-    })
-        .catch(async (error) => {
+    }).catch(async (error) => {
+        const remediation = process.platform === "darwin" &&
+            sandboxDeniedRemediation(error instanceof Error ? error.message : "");
+        if (remediation)
+            throw new Error(remediation, { cause: error });
         const defaults = await ppt.defaultArgs({
             headless: true,
             args: withHyperframesBrowserMarker(args),

package/dist/services/extractionCache.js

@@ -33,7 +33,7 @@
  */
 import { createHash, randomUUID } from "node:crypto";
 import { createReadStream, existsSync, lstatSync, mkdirSync, readdirSync, rmSync, statSync, utimesSync, writeFileSync, } from "node:fs";
-import { renameWithRetry } from "../utils/renameWithRetry.js";
+import { renameWithRetry } from "@hyperframes/core/rename-retry";
 import { join } from "node:path";
 import { FRAME_FILENAME_PREFIX, framePathsFromDirectory } from "./extractedFrameIndex.js";
 /** Filename prefix for extracted frames. Shared with the extractor. */

package/dist/services/parallelCoordinator.js

@@ -7,7 +7,7 @@
 import { cpus, freemem } from "os";
 import { existsSync, mkdirSync, readdirSync } from "fs";
 import { copyFile, readFile } from "fs/promises";
-import { renameWithRetryAsync } from "../utils/renameWithRetry.js";
+import { renameWithRetryAsync } from "@hyperframes/core/rename-retry";
 import { join } from "path";
 import { getHeapStatistics } from "v8";
 import { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBufferPipelined, captureFrameToBuffer, getCapturePerfSummary, DrawElementVerificationError, } from "./frameCapture.js";

package/dist/services/sandboxLaunch.d.ts

@@ -0,0 +1,10 @@
+import type { LaunchOptions } from "puppeteer-core";
+export declare function machServiceDenied(errorMessage: string): boolean;
+export declare function pipeLaunchClosedOnMac(error: unknown, platform?: NodeJS.Platform): boolean;
+/** Codex runs agent commands in a macOS seatbelt, which names itself in the environment. */
+export declare function inAgentSandbox(env?: NodeJS.ProcessEnv, platform?: NodeJS.Platform): boolean;
+/** The one launch a seatbelt allows: no child process registers a mach port, nothing listens, no GPU composites. */
+export declare function oneProcessOverPipe(options: LaunchOptions): LaunchOptions;
+export declare function isOneProcessOverPipe(options: LaunchOptions): boolean;
+/** A process sandbox (an agent's macOS seatbelt) refused Chrome its mach service, so no browser starts here. */
+export declare function sandboxDeniedRemediation(errorMessage: string): string | undefined;

package/dist/services/sandboxLaunch.js

@@ -0,0 +1,31 @@
+const MACH_SERVICE_DENIED = /bootstrap_check_in\b[^\n]*Permission denied/;
+const SINGLE_PROCESS = "--single-process";
+const CPU_COMPOSITING = "--disable-gpu-compositing";
+export function machServiceDenied(errorMessage) {
+    return MACH_SERVICE_DENIED.test(errorMessage);
+}
+export function pipeLaunchClosedOnMac(error, platform = process.platform) {
+    return platform === "darwin" && error instanceof Error && error.name === "TargetCloseError";
+}
+/** Codex runs agent commands in a macOS seatbelt, which names itself in the environment. */
+export function inAgentSandbox(env = process.env, platform = process.platform) {
+    return platform === "darwin" && env.CODEX_SANDBOX === "seatbelt";
+}
+/** The one launch a seatbelt allows: no child process registers a mach port, nothing listens, no GPU composites. */
+export function oneProcessOverPipe(options) {
+    const args = options.args ?? [];
+    const missing = [SINGLE_PROCESS, CPU_COMPOSITING].filter((flag) => !args.includes(flag));
+    return { ...options, pipe: true, args: [...args, ...missing] };
+}
+export function isOneProcessOverPipe(options) {
+    return options.pipe === true && (options.args ?? []).includes(SINGLE_PROCESS);
+}
+/** A process sandbox (an agent's macOS seatbelt) refused Chrome its mach service, so no browser starts here. */
+export function sandboxDeniedRemediation(errorMessage) {
+    if (!machServiceDenied(errorMessage))
+        return undefined;
+    return [
+        "The browser can't start inside this sandbox: macOS refused Chrome's mach service (bootstrap_check_in: Permission denied).",
+        "Rerun this command with escalation, outside the sandbox.",
+    ].join("\n");
+}

package/dist/utils/ffprobe.d.ts

@@ -61,6 +61,8 @@ export interface AudioMetadata {
     latestStreamLeadSeconds?: number;
     audioStreamLeadSeconds?: number;
     audioStreamCount?: number;
+    /** The track read for these facts and for the mix, by its place among the audio streams (decodableAudioStream). */
+    audioStream: number;
 }
 interface FFProbeStream {
     codec_type: string;

package/dist/utils/ffprobe.js

@@ -8,6 +8,7 @@ import { basename, join } from "path";
 import { redactTelemetryString } from "@hyperframes/core";
 import { alphaDecoderFor, pixelFormatHasAlpha, videoStreamHasAlpha, } from "@hyperframes/parsers/media-alpha";
 import { urlInputArgs } from "./urlInput.js";
+import { decodableAudioStream } from "@hyperframes/parsers/media-streams";
 import { runFfmpeg } from "./runFfmpeg.js";
 import { FFPROBE_PATH_ENV, getFfprobeBinary } from "./ffmpegBinaries.js";
 import { ManagedChildProcess } from "./managedChildProcess.js";
@@ -445,7 +446,7 @@ export async function probeMediaProfile(filePath, options) {
         }
         return {
             hasVideoStream: videoStreams.length > 0,
-            hasAudioStream: output.streams.some((stream) => stream.codec_type === "audio"),
+            hasAudioStream: decodableAudioStream(output.streams) !== null,
             visualKind: isStillImage ? "still" : hasMovingVideoStream ? "moving" : "none",
         };
     }
@@ -790,7 +791,7 @@ export async function extractMediaMetadata(filePath) {
             height: videoStream.height || stillImage()?.height || 0,
             fps,
             videoCodec: videoStream.codec_name || "unknown",
-            hasAudio: output?.streams.some((s) => s.codec_type === "audio") ?? false,
+            hasAudio: decodableAudioStream(output?.streams ?? []) !== null,
             isVFR,
             hasAlpha,
             ...(alphaPlaneDecoded === undefined ? {} : { alphaPlaneDecoded }),
@@ -956,8 +957,10 @@ export async function extractAudioMetadata(filePath, options) {
 }
 async function probeAudioMetadata(filePath, signal) {
     const output = await probeMediaOutput(filePath, signal);
-    const audioStream = output.streams.find((s) => s.codec_type === "audio");
-    if (!audioStream)
+    const audioStreams = output.streams.filter((s) => s.codec_type === "audio");
+    const audioStreamIndex = decodableAudioStream(output.streams);
+    const audioStream = audioStreamIndex === null ? undefined : audioStreams[audioStreamIndex];
+    if (audioStreamIndex === null || !audioStream)
         throw new Error("[FFmpeg] No audio stream found");
     let durationSeconds = output.format.duration ? parseFloat(output.format.duration) : 0;
     const streamDuration = audioStream.duration ? parseFloat(audioStream.duration) : undefined;
@@ -966,7 +969,7 @@ async function probeAudioMetadata(filePath, signal) {
     // Container summaries can undercount intact audio, so the decoded last frame wins.
     // The probe returns null instead of throwing: a throw here drops the audio element.
     if (sampleRate > 0) {
-        const decoded = await probeDecodedAudioDuration(filePath, sampleRate, audioStartSeconds(audioStream, output.format), durationSeconds, signal);
+        const decoded = await probeDecodedAudioDuration(filePath, audioStreamIndex, sampleRate, audioStartSeconds(audioStream, output.format), durationSeconds, signal);
         if (decoded !== null) {
             durationSeconds = reconcileAudioDuration(durationSeconds, decoded, output.format);
         }
@@ -980,7 +983,8 @@ async function probeAudioMetadata(filePath, signal) {
         bitrate: output.format.bit_rate ? parseInt(output.format.bit_rate) : undefined,
         latestStreamLeadSeconds: latestStreamLeadSeconds(output),
         audioStreamLeadSeconds: streamLeadSeconds(output, audioStream),
-        audioStreamCount: output.streams.filter((s) => s.codec_type === "audio").length,
+        audioStreamCount: audioStreams.length,
+        audioStream: audioStreamIndex,
     };
 }
 /** Chrome's media time 0 is the earliest of these; a stream starting later plays that much in. */
@@ -1018,11 +1022,11 @@ function reconcileAudioDuration(containerSeconds, decodedSeconds, format) {
  * True audio duration from the last decoded frame (timestamp + nb_samples - stream start): tail
  * first, then the whole file if a bad seek finds nothing. Null, never a throw, except on abort.
  */
-async function probeDecodedAudioDuration(filePath, sampleRate, startSeconds, containerDurationSeconds, signal) {
+async function probeDecodedAudioDuration(filePath, audioStream, sampleRate, startSeconds, containerDurationSeconds, signal) {
     const probe = async (readInterval) => {
         const args = [
             "-select_streams",
-            "a:0",
+            `a:${audioStream}`,
             "-show_entries",
             "frame=best_effort_timestamp_time,nb_samples",
             "-of",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.8.208",
+  "version": "0.8.209",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -54,8 +54,8 @@
     "linkedom": "^0.18.12",
     "puppeteer": "^25.8.0",
     "puppeteer-core": "^25.8.0",
-    "@hyperframes/core": "^0.8.208",
-    "@hyperframes/parsers": "^0.8.208"
+    "@hyperframes/parsers": "^0.8.209",
+    "@hyperframes/core": "^0.8.209"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",

package/dist/utils/removeScratch.d.ts

@@ -1,5 +0,0 @@
-/** Removes a scratch folder or file the mix is already done with. A refusal (Windows temp folders that deny
- * delete) leaves it for the render's own cleanup and never fails the audio it served. */
-export declare function removeScratch(path: string): void;
-/** Runs `run`; whatever removeScratch left behind inside it (this run's only) goes to `report` once it ends. */
-export declare function collectScratchLeftovers<T>(run: () => Promise<T>, report: (left: string[]) => void): Promise<T>;

package/dist/utils/removeScratch.js

@@ -1,23 +0,0 @@
-import { AsyncLocalStorage } from "node:async_hooks";
-import { rmSync } from "node:fs";
-const collecting = new AsyncLocalStorage();
-/** Removes a scratch folder or file the mix is already done with. A refusal (Windows temp folders that deny
- * delete) leaves it for the render's own cleanup and never fails the audio it served. */
-export function removeScratch(path) {
-    try {
-        rmSync(path, { recursive: true, force: true });
-    }
-    catch {
-        collecting.getStore()?.push(path);
-    }
-}
-/** Runs `run`; whatever removeScratch left behind inside it (this run's only) goes to `report` once it ends. */
-export async function collectScratchLeftovers(run, report) {
-    const left = [];
-    try {
-        return await collecting.run(left, run);
-    }
-    finally {
-        report(left);
-    }
-}

package/dist/utils/renameWithRetry.d.ts

@@ -1,16 +0,0 @@
-interface Options {
-    platform?: NodeJS.Platform;
-    /** Copy the bytes when Windows keeps refusing (a TEMP that denies delete). Not atomic: scratch files only. */
-    copyFallback?: boolean;
-}
-/** `renameSync` that rides out Windows' transient file locks; other platforms and errors throw at once. */
-export declare function renameWithRetry(from: string, to: string, options?: Options & {
-    rename?: (from: string, to: string) => void;
-    copy?: (from: string, to: string) => void;
-}): void;
-/** Async twin of {@link renameWithRetry}. */
-export declare function renameWithRetryAsync(from: string, to: string, options?: Options & {
-    rename?: (from: string, to: string) => Promise<void>;
-    copy?: (from: string, to: string) => Promise<void>;
-}): Promise<void>;
-export {};

package/dist/utils/renameWithRetry.js

@@ -1,81 +0,0 @@
-import { copyFileSync, renameSync } from "node:fs";
-import { copyFile, rename } from "node:fs/promises";
-import { removeScratch } from "./removeScratch.js";
-// Windows reports EPERM/EACCES/EBUSY while antivirus or a just-exited process still holds the
-// file; the hold clears within milliseconds. Total wait before giving up: about 1.3 s.
-const RETRYABLE = new Set(["EPERM", "EACCES", "EBUSY"]);
-const BACKOFF_MS = [10, 20, 40, 80, 160, 320, 640];
-function isRetryable(error, platform) {
-    if (platform !== "win32")
-        return false;
-    return RETRYABLE.has(error?.code ?? "");
-}
-/** What a refused rename does next: wait and try again, fall back to a copy, or give up with the error. */
-function nextStep(error, attempt, options, platform) {
-    if (!isRetryable(error, platform))
-        return "throw";
-    if (attempt < BACKOFF_MS.length)
-        return "wait";
-    return options.copyFallback ? "copy" : "throw";
-}
-function sleepSync(ms) {
-    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
-}
-/** `renameSync` that rides out Windows' transient file locks; other platforms and errors throw at once. */
-export function renameWithRetry(from, to, options = {}) {
-    const doRename = options.rename ?? renameSync;
-    const doCopy = options.copy ?? copyFileSync;
-    const platform = options.platform ?? process.platform;
-    for (let attempt = 0;; attempt++) {
-        try {
-            doRename(from, to);
-            return;
-        }
-        catch (error) {
-            const step = nextStep(error, attempt, options, platform);
-            if (step === "throw")
-                throw error;
-            if (step === "wait") {
-                sleepSync(BACKOFF_MS[attempt]);
-                continue;
-            }
-            try {
-                doCopy(from, to);
-            }
-            catch {
-                throw error;
-            }
-            removeScratch(from);
-            return;
-        }
-    }
-}
-/** Async twin of {@link renameWithRetry}. */
-export async function renameWithRetryAsync(from, to, options = {}) {
-    const doRename = options.rename ?? rename;
-    const doCopy = options.copy ?? copyFile;
-    const platform = options.platform ?? process.platform;
-    for (let attempt = 0;; attempt++) {
-        try {
-            await doRename(from, to);
-            return;
-        }
-        catch (error) {
-            const step = nextStep(error, attempt, options, platform);
-            if (step === "throw")
-                throw error;
-            if (step === "wait") {
-                await new Promise((resolve) => setTimeout(resolve, BACKOFF_MS[attempt]));
-                continue;
-            }
-            try {
-                await doCopy(from, to);
-            }
-            catch {
-                throw error;
-            }
-            removeScratch(from);
-            return;
-        }
-    }
-}