@hyperframes/engine 0.9.25 → 0.9.27

package/dist/services/aacEncode.js

@@ -3,11 +3,12 @@
  * so long audio is encoded as frame-aligned segments in parallel and their frames joined.
  */
 import { execFile } from "node:child_process";
-import { mkdtempSync, readFileSync, writeFileSync } from "node:fs";
+import { readFileSync, writeFileSync } from "node:fs";
 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";
+import { createStagingDir } from "@hyperframes/core/atomic-file";
 const SAMPLE_RATE = 48_000;
 const FRAME_SAMPLES = 1024;
 const MIN_SEGMENT_SECONDS = 60;
@@ -78,7 +79,7 @@ export async function encodeAac(input, outputPath, totalDuration, { signal, time
     if (!(await supportsSettsDuration())) {
         return encodeInOnePass(input, outputPath, { signal, timeout, filter });
     }
-    const dir = mkdtempSync(join(dirname(outputPath), ".aac-segments-"));
+    const dir = createStagingDir(dirname(outputPath), ".aac-segments-");
     try {
         const segments = planSegments(totalDuration, count).map((segment, k) => ({
             ...segment,

package/dist/services/audioMixer.js

@@ -1,6 +1,6 @@
 // fallow-ignore-file complexity code-duplication
 import { isSelfOrAncestorHidden, memberGroupKey, isMemberGroupHidden } from "./mediaHidden.js";
-import { closeSync, existsSync, mkdirSync, mkdtempSync, openSync, rmSync, writeFileSync } from "fs";
+import { closeSync, existsSync, mkdirSync, openSync, rmSync, writeFileSync } from "fs";
 import { renameWithRetry } from "@hyperframes/core/rename-retry";
 import { removeScratch } from "@hyperframes/core/remove-scratch";
 import { join, dirname, isAbsolute, relative } from "path";
@@ -28,6 +28,7 @@ import { chainTailSeconds } from "@hyperframes/core/audio-fx-tail";
 import { isAudibleVideoElement, MEDIA_RENDER_ID_ATTR, normalizePlaybackRate, normalizeRateSpec, parseStrictFiniteTimingNumber, readElementRateSpec, readMediaStart, sourceTimeAt, timeAtSourceTime, } from "@hyperframes/core";
 import { readMasterFxChain, resolveAudioGroups } from "@hyperframes/core/audio-groups";
 import { applyAudioFxChain, AudioFxRenderError } from "./audioFxRender.js";
+import { createStagingDir } from "@hyperframes/core/atomic-file";
 /** An MP4-family container records AAC priming as an edit list; a raw .aac plays ~21 ms late.
  * The video mux, the distributed plan and the PNG-sequence sidecar all read this one name. */
 export const MIXED_AUDIO_FILENAME = "audio.m4a";
@@ -539,7 +540,7 @@ async function extractAudioSegment(srcPath, outputPath, stage, mediaStart, durat
         });
     const loopDuration = (metadata?.durationSeconds ?? 0) - mediaStart;
     if (options?.loop && loopDuration > 0 && sourceDuration > loopDuration) {
-        const cycleDir = mkdtempSync(join(outputDir, ".audio-loop-"));
+        const cycleDir = createStagingDir(outputDir, ".audio-loop-");
         const cyclePath = join(cycleDir, "cycle.wav");
         try {
             const cycle = await extractAudioSegment(srcPath, cyclePath, stage, mediaStart, loopDuration, 1, signal, config, audioSidecarUrl, { padToDuration: true });
@@ -746,7 +747,7 @@ async function mixAudioTracksFlat(tracks, outputPath, totalDuration, signal, con
     const runMix = async (ignoreAutomation, useNormalize) => {
         const inputs = [];
         tracks.forEach((track) => inputs.push("-i", track.srcPath));
-        const scriptDir = mkdtempSync(join(outputDir, ".filter-complex-"));
+        const scriptDir = createStagingDir(outputDir, ".filter-complex-");
         const scriptPath = join(scriptDir, "graph.txt");
         const fd = openSync(scriptPath, "wx", 0o600);
         try {
@@ -898,7 +899,7 @@ async function mixGroupMembersFlat(memberTracks, outputPath, totalDuration, sign
                 // global track count.
                 `${mixInputs}amix=inputs=${memberTracks.length}:duration=longest:dropout_transition=0[mixed];[mixed]volume=${formatFilterNumber(memberTracks.length)}[out]`;
         const filterComplex = [...inputFilters, mixFilter].join(";");
-        const scriptDir = mkdtempSync(join(outputDir, ".group-filter-complex-"));
+        const scriptDir = createStagingDir(outputDir, ".group-filter-complex-");
         const scriptPath = join(scriptDir, "graph.txt");
         const fd = openSync(scriptPath, "wx", 0o600);
         try {
@@ -1013,7 +1014,7 @@ async function mixGroupMembers(memberTracks, outputPath, totalDuration, signal,
         return mixGroupMembersFlat(memberTracks, outputPath, totalDuration, signal, config);
     }
     mkdirSync(dirname(outputPath), { recursive: true });
-    const scratchDir = mkdtempSync(join(dirname(outputPath), ".mix-batches-"));
+    const scratchDir = createStagingDir(dirname(outputPath), ".mix-batches-");
     try {
         const summed = await sumInSlices(memberTracks, scratchDir, totalDuration, signal, config);
         if (!summed.success)
@@ -1030,7 +1031,7 @@ async function mixAudioTracks(tracks, outputPath, totalDuration, signal, config)
         return mixAudioTracksFlat(tracks, outputPath, totalDuration, signal, config);
     }
     mkdirSync(dirname(outputPath), { recursive: true });
-    const scratchDir = mkdtempSync(join(dirname(outputPath), ".mix-batches-"));
+    const scratchDir = createStagingDir(dirname(outputPath), ".mix-batches-");
     try {
         const summed = await sumInSlices(tracks, scratchDir, totalDuration, signal, config);
         if (!summed.success) {

package/dist/services/audioVolumeEnvelope.js

@@ -14,11 +14,12 @@
  * `extractAudioSegment`). Anything else is rejected so
  * the caller can fall back to the expression path rather than corrupting audio.
  */
-import { mkdtempSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { readFileSync, rmSync, writeFileSync } from "fs";
 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";
+import { createStagingDir } from "@hyperframes/core/atomic-file";
 const PCM_FORMAT = 1; // WAVE_FORMAT_PCM
 const FLOAT_FORMAT = 3; // WAVE_FORMAT_IEEE_FLOAT
 /** The `fmt ` chunk, or null for a format this cannot safely edit in place. */
@@ -129,7 +130,7 @@ export function applyVolumeEnvelopeToWav(wavPath, keyframes, trackStart, baseVol
         scaleSamples(buffer, layout, gainAt);
         // A private sibling directory owns the staging file; the same-filesystem
         // rename keeps a failed write from truncating the original WAV.
-        stagingDir = mkdtempSync(join(dirname(wavPath), ".hf-volume-"));
+        stagingDir = createStagingDir(dirname(wavPath), ".hf-volume-");
         const tempPath = join(stagingDir, "audio.wav");
         writeFileSync(tempPath, buffer, { flag: "wx" });
         renameWithRetry(tempPath, wavPath);

package/dist/services/chunkEncoder.js

@@ -6,7 +6,7 @@
  * Supports CPU (libx264) and GPU encoding.
  */
 import { frameSequencePath } from "./extractedFrameIndex.js";
-import { closeSync, copyFileSync, existsSync, ftruncateSync, mkdirSync, mkdtempSync, openSync, readFileSync, readdirSync, statSync, writeFileSync, writeSync, } from "fs";
+import { closeSync, copyFileSync, existsSync, ftruncateSync, mkdirSync, openSync, readFileSync, readdirSync, statSync, writeFileSync, writeSync, } from "fs";
 import { join, dirname, extname, resolve } from "path";
 import { DEFAULT_CONFIG } from "../config.js";
 import { getCachedGpuEncoder, getCachedNvencPresets, getGpuEncoderName, buildVideoToolboxRateControlArgs, mapPresetForGpuEncoder, } from "../utils/gpuEncoder.js";
@@ -19,6 +19,7 @@ import { fpsToFfmpegArg, fpsToNumber } from "@hyperframes/core";
 import { appendVp9CpuUsedArg } from "./vp9Options.js";
 import { appendSoftwareEncoderThreadsArg } from "./softwareEncoderThreads.js";
 import { appendRenderProvenanceArgs } from "../utils/renderProvenance.js";
+import { createStagingDir } from "@hyperframes/core/atomic-file";
 export const ENCODER_PRESETS = {
     draft: { preset: "ultrafast", quality: 28, codec: "h264" },
     standard: { preset: "medium", quality: 18, codec: "h264" },
@@ -553,7 +554,7 @@ export async function encodeFramesChunkedConcat(framesDir, framePattern, outputP
     mkdirSync(dirname(outputPath), { recursive: true });
     // Keep intermediates under the caller-owned output directory for its existing
     // cleanup/debug policy, but never reuse another invocation's chunk files.
-    const chunkDir = mkdtempSync(join(dirname(outputPath), "chunk-encode-"));
+    const chunkDir = createStagingDir(dirname(outputPath), "chunk-encode-");
     const chunkPaths = [];
     for (let i = 0; i < chunkCount; i++) {
         if (signal?.aborted) {

package/dist/utils/urlDownloader.js

@@ -1,4 +1,4 @@
-import { closeSync, createReadStream, createWriteStream, existsSync, fsyncSync, linkSync, mkdtempSync, mkdirSync, lstatSync, openSync, readdirSync, rmdirSync, rmSync, statSync, unlinkSync, } from "fs";
+import { closeSync, createReadStream, createWriteStream, existsSync, fsyncSync, linkSync, mkdirSync, lstatSync, openSync, readdirSync, rmdirSync, rmSync, statSync, unlinkSync, } from "fs";
 import { createHash, randomUUID } from "crypto";
 import dns from "node:dns";
 import { fetchGoesThroughEnvProxy } from "@hyperframes/core/env-proxy";
@@ -6,6 +6,7 @@ import { isBlockedNetworkHost } from "./networkPolicy.js";
 import { dirname, extname, join } from "path";
 import { Readable, Transform } from "stream";
 import { pipeline } from "stream/promises";
+import { createStagingDir } from "@hyperframes/core/atomic-file";
 const inFlightDownloads = new Map();
 const signalScopes = new WeakMap();
 let nextSignalScope = 1;
@@ -763,7 +764,7 @@ function emitDownloadTelemetry(options, event) {
 async function runDownloadAttempt(url, localPath, timeoutMs, attempt, options, signal) {
     // A private, unguessable directory prevents symlink planting and keeps the
     // partial on the destination filesystem so the final rename stays atomic.
-    const attemptDir = mkdtempSync(join(dirname(localPath), ".hf-download-"));
+    const attemptDir = createStagingDir(dirname(localPath), ".hf-download-");
     const partialPath = join(attemptDir, "payload");
     const controller = new AbortController();
     let timedOut = false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.9.25",
+  "version": "0.9.27",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -61,8 +61,8 @@
     "puppeteer": "~25.11.0",
     "puppeteer-core": "^25.11.0",
     "undici": "7.25.0",
-    "@hyperframes/core": "^0.9.25",
-    "@hyperframes/parsers": "^0.9.25"
+    "@hyperframes/core": "^0.9.27",
+    "@hyperframes/parsers": "^0.9.27"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",