@hyperframes/studio-server 0.8.209 → 0.8.211

package/dist/{chunk-2B5SR4RJ.js → chunk-KPCW4DQM.js}

@@ -407,9 +407,8 @@ var ProxyDroppedError = class extends ProxyTranscodeError {
 var activeTranscodes = 0;
 var waitQueue = [];
 function enqueue(job) {
-  const firstNormal = job.priority ? waitQueue.findIndex((queued) => !queued.priority) : -1;
-  if (firstNormal === -1) waitQueue.push(job);
-  else waitQueue.splice(firstNormal, 0, job);
+  if (job.priority) waitQueue.unshift(job);
+  else waitQueue.push(job);
 }
 function dequeue(job) {
   const index = waitQueue.indexOf(job);
@@ -445,7 +444,6 @@ function releaseSlot() {
   waitQueue.shift()?.queued?.start();
 }
 function prioritize(job) {
-  if (job.priority) return;
   job.priority = true;
   if (!job.queued) return;
   dequeue(job);

package/dist/{chunk-BWZMWYB2.js → chunk-UMPRW7BV.js}

@@ -19,7 +19,7 @@ import {
   rmSync as rmSync3
 } from "fs";
 import { homedir } from "os";
-import { dirname as dirname5, isAbsolute as isAbsolute5, join as join8, relative as relative5, resolve as resolve7, sep as sep5 } from "path";
+import { dirname as dirname5, isAbsolute as isAbsolute5, join as join8, relative as relative5, resolve as resolve8, sep as sep5 } from "path";
 import { replaceFileAtomically as replaceFileAtomically6 } from "@hyperframes/core/atomic-file";
 
 // src/helpers/fileVersion.ts
@@ -534,11 +534,44 @@ function createProjectSignature(projectDir, excluding = /* @__PURE__ */ new Set(
 // src/history/blobStore.ts
 import { createHash as createHash3, randomUUID as randomUUID3 } from "crypto";
 import { constants, createReadStream, createWriteStream } from "fs";
-import { copyFile, mkdir, readdir, readFile, rm, stat } from "fs/promises";
+import { copyFile, mkdir, open, readdir, readFile, rm, stat } from "fs/promises";
 import { dirname, join as join2 } from "path";
 import { pipeline } from "stream/promises";
 import { atomicTempPath } from "@hyperframes/core/atomic-file";
-import { renameWithRetry, renameWithRetryAsync } from "@hyperframes/core/rename-retry";
+import {
+  isWindowsHold,
+  renameWithRetry,
+  renameWithRetryAsync
+} from "@hyperframes/core/rename-retry";
+
+// src/helpers/servedFiles.ts
+import { resolve as resolve3 } from "path";
+var serving = /* @__PURE__ */ new Map();
+var keyOf = (path) => process.platform === "win32" ? resolve3(path).toLowerCase() : resolve3(path);
+function serveWhileOpen(path, stream) {
+  const key = keyOf(path);
+  const reads = serving.get(key) ?? /* @__PURE__ */ new Set();
+  serving.set(key, reads.add(stream));
+  stream.once("close", () => {
+    reads.delete(stream);
+    if (reads.size === 0 && serving.get(key) === reads) serving.delete(key);
+  });
+  return stream;
+}
+async function stopServingAndClose(path) {
+  const reads = [...serving.get(keyOf(path)) ?? []];
+  await Promise.all(
+    reads.map(
+      (stream) => new Promise((done) => {
+        if (stream.closed) return done();
+        stream.once("close", () => done());
+        stream.destroy();
+      })
+    )
+  );
+}
+
+// src/history/blobStore.ts
 var BLOB_HASH = /^[0-9a-f]{64}$/;
 function blobPath(dir, hash) {
   if (!BLOB_HASH.test(hash)) throw new Error("That is not a history blob.");
@@ -558,18 +591,45 @@ async function cloneOrStream(from, to) {
     await pipeline(createReadStream(from), createWriteStream(to, { mode }));
   }
 }
-async function cloneOrCopy(from, to, beforeReplace) {
+var inPlaceListeners = /* @__PURE__ */ new Set();
+function onRestoredInPlace(listener) {
+  inPlaceListeners.add(listener);
+  return () => inPlaceListeners.delete(listener);
+}
+async function cloneOrCopy(from, to, hash, beforeReplace) {
   await mkdir(dirname(to), { recursive: true });
   const temp = atomicTempPath(to);
   try {
     await copyFile(from, temp, constants.COPYFILE_FICLONE);
+    await stopServingAndClose(to);
     beforeReplace?.();
-    renameWithRetry(temp, to);
-  } catch (error) {
+    try {
+      renameWithRetry(temp, to);
+    } catch (error) {
+      if (!isWindowsHold(error)) throw error;
+      await writeInPlace(temp, to, hash);
+    }
+  } finally {
     await rm(temp, { force: true });
-    throw error;
   }
 }
+async function writeInPlace(temp, to, hash) {
+  let outcome = "failed";
+  try {
+    await copyFile(temp, to);
+    const handle = await open(to, "r+");
+    try {
+      await handle.sync();
+    } finally {
+      await handle.close();
+    }
+    outcome = await hashFile(to) === hash ? "restored" : "mismatch";
+  } finally {
+    for (const listener of inPlaceListeners) listener(to, outcome);
+  }
+  if (outcome === "mismatch")
+    throw new Error("The file was written in place, but it does not match the copy history kept.");
+}
 var listDir = (path) => readdir(path, { withFileTypes: true }).catch((error) => {
   if (error.code === "ENOENT") return [];
   throw error;
@@ -628,7 +688,7 @@ async function openBlobStore(dir) {
     reference: (absPath) => hashFile(absPath),
     has: (hash) => sizes.has(hash) || asideSizes.has(hash),
     read: (hash) => readFile(pathOf(hash)),
-    writeTo: async (hash, absPath, beforeReplace) => cloneOrCopy(pathOf(hash), absPath, beforeReplace),
+    writeTo: async (hash, absPath, beforeReplace) => cloneOrCopy(pathOf(hash), absPath, hash, beforeReplace),
     async release(held) {
       for (const [hash, path] of held) {
         holds.get(hash)?.delete(path);
@@ -717,7 +777,7 @@ import { dirname as dirname2, join as join4 } from "path";
 // src/history/historyId.ts
 import { randomUUID as randomUUID4 } from "crypto";
 import { existsSync, mkdirSync as mkdirSync2, readFileSync as readFileSync4, statSync as statSync2, writeFileSync as writeFileSync2 } from "fs";
-import { basename, join as join3, resolve as resolve3 } from "path";
+import { basename, join as join3, resolve as resolve4 } from "path";
 import { replaceFileAtomically as replaceFileAtomically3 } from "@hyperframes/core/atomic-file";
 var ID_PATH = join3(".hyperframes", "history-id");
 var ID_SHAPE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;
@@ -756,7 +816,7 @@ function isCopyOf0878Folder(recordedDir, id, folder) {
   return !!there && !sameFolder(there, folder) && readId(recordedDir) === id;
 }
 function projectHistoryId(projectDir, historyRoot) {
-  const dir = resolve3(projectDir);
+  const dir = resolve4(projectDir);
   const folder = statSync2(dir);
   let id = readId(dir);
   if (!id && existsSync(join3(dir, ID_PATH)))
@@ -933,7 +993,7 @@ function pruneGoneProjectHistoriesDaily(historyRoot, now, { onError, budgetMs }
 // src/history/videoState.ts
 import { createHash as createHash5, randomUUID as randomUUID6 } from "crypto";
 import { createReadStream as createReadStream2, existsSync as existsSync2, readFileSync as readFileSync8, renameSync as renameSync2, statSync as statSync4 } from "fs";
-import { isAbsolute as isAbsolute4, join as join7, resolve as resolve6 } from "path";
+import { isAbsolute as isAbsolute4, join as join7, resolve as resolve7 } from "path";
 import { replaceFileAtomically as replaceFileAtomically4 } from "@hyperframes/core/atomic-file";
 
 // src/history/artifactCleanup.ts
@@ -947,7 +1007,7 @@ import {
   readFileSync as readFileSync6,
   unlinkSync
 } from "fs";
-import { isAbsolute as isAbsolute3, join as join5, relative as relative3, resolve as resolve4, sep as sep3 } from "path";
+import { isAbsolute as isAbsolute3, join as join5, relative as relative3, resolve as resolve5, sep as sep3 } from "path";
 var kinds = ["checks", "snapshots"];
 var records = (state, kind) => [
   ...Object.values(state[kind].revisions).flat(),
@@ -955,7 +1015,7 @@ var records = (state, kind) => [
 ];
 var protectedRevisions = (state) => /* @__PURE__ */ new Set([state.currentRevision, ...state.renders?.retainedRevisions ?? []]);
 function managedPath(projectDir, path, kind) {
-  const canonicalProject = realFilePath(resolve4(projectDir));
+  const canonicalProject = realFilePath(resolve5(projectDir));
   const canonicalPath = realFilePath(path);
   const root = join5(canonicalProject, ".hyperframes", "artifacts", kind);
   const rel = relative3(root, canonicalPath);
@@ -1067,15 +1127,15 @@ import {
   writeSync,
   writeFileSync as writeFileSync4
 } from "fs";
-import { dirname as dirname3, join as join6, relative as relative4, resolve as resolve5, sep as sep4 } from "path";
+import { dirname as dirname3, join as join6, relative as relative4, resolve as resolve6, sep as sep4 } from "path";
 var SNAPSHOT_RUNS_TO_KEEP = 10;
 var SNAPSHOT_GRACE_MS = 24 * 60 * 60 * 1e3;
 var OWNER = ".capture-owner.json";
 var ownedMarkers = /* @__PURE__ */ new Map();
 var UUID = /^[\da-f]{8}-[\da-f]{4}-[\da-f]{4}-[\da-f]{4}-[\da-f]{12}$/i;
-var rootOf = (project) => join6(resolve5(project), ".hyperframes", "artifacts", "snapshots");
+var rootOf = (project) => join6(resolve6(project), ".hyperframes", "artifacts", "snapshots");
 function ordinaryPath(project, path) {
-  const root = resolve5(project);
+  const root = resolve6(project);
   const rel = relative4(root, path);
   if (rel === ".." || rel.startsWith(`..${sep4}`)) return false;
   let current = root;
@@ -1090,7 +1150,7 @@ function ordinaryPath(project, path) {
   return true;
 }
 function createSnapshotParents(project, path) {
-  let parent = resolve5(project);
+  let parent = resolve6(project);
   for (const part of relative4(parent, path).split(sep4).filter(Boolean)) {
     parent = join6(parent, part);
     try {
@@ -1186,7 +1246,7 @@ function recordsOf(state) {
 }
 function containingRun(root, path) {
   if (!path) return null;
-  const name = relative4(root, resolve5(path)).split(sep4)[0];
+  const name = relative4(root, resolve6(path)).split(sep4)[0];
   return name && UUID.test(name) ? join6(root, name) : null;
 }
 function keepContainingRun(keep, root, path) {
@@ -1287,7 +1347,7 @@ function retainSnapshotOutput(project, path) {
   const root = rootOf(project);
   const run = containingRun(root, path);
   if (!run) return;
-  createSnapshotParents(project, resolve5(path));
+  createSnapshotParents(project, resolve6(path));
   try {
     writeFileSync4(
       join6(run, ".user-output"),
@@ -1343,7 +1403,7 @@ async function updateState(dir, update) {
   }
 }
 async function writeHistoryState(projectDir, historyId, historyDirectory, entries, currentFiles, committedFiles) {
-  const blob = (hash) => hash === null ? null : resolve6(historyDirectory, "blobs", hash.slice(0, 2), hash);
+  const blob = (hash) => hash === null ? null : resolve7(historyDirectory, "blobs", hash.slice(0, 2), hash);
   await updateState(projectDir, (state) => {
     if (state.historyId && state.historyId !== historyId) {
       state.checks = collection();
@@ -1474,7 +1534,7 @@ function listsOf(artifacts) {
   return [...Object.values(artifacts.revisions), artifacts.unversioned];
 }
 async function forgetRecordedArtifacts(projectDir, paths) {
-  const gone = new Set(paths.map((path) => resolve6(path)));
+  const gone = new Set(paths.map((path) => resolve7(path)));
   if (gone.size === 0) return;
   await updateState(projectDir, (state) => {
     for (const artifacts of [state.checks, state.snapshots]) {
@@ -1482,7 +1542,7 @@ async function forgetRecordedArtifacts(projectDir, paths) {
         for (let i = list.length - 1; i >= 0; i--) {
           const record = list[i];
           const path = record.image ?? record.report;
-          if (path && gone.has(resolve6(path))) list.splice(i, 1);
+          if (path && gone.has(resolve7(path))) list.splice(i, 1);
         }
       }
       if (artifacts.latest && !listsOf(artifacts).some(
@@ -1494,7 +1554,7 @@ async function forgetRecordedArtifacts(projectDir, paths) {
   });
 }
 function artifactDirectory(projectDir, kind) {
-  const path = join7(resolve6(projectDir), ".hyperframes", "artifacts", kind, randomUUID6());
+  const path = join7(resolve7(projectDir), ".hyperframes", "artifacts", kind, randomUUID6());
   if (kind === "snapshots") ownSnapshotRun(projectDir, path);
   return path;
 }
@@ -1510,7 +1570,7 @@ async function recordRenderSuccess(projectDir, output, status = "completed", cap
   const record = {
     id: randomUUID6(),
     completedAt: Date.now(),
-    output: resolve6(output),
+    output: resolve7(output),
     status
   };
   const unchanged = Boolean(capture && after?.fingerprint === capture.fingerprint);
@@ -1777,7 +1837,7 @@ var Engine = class {
     this.options = options;
     this.projectId = projectId;
     this.blobs = blobs;
-    this.dir = resolve7(options.projectDir);
+    this.dir = resolve8(options.projectDir);
     this.home = join8(options.historyRoot, projectId);
     this.foldsCase = ignoresCase(this.dir);
     const folder = statSync5(this.dir, { throwIfNoEntry: false });
@@ -2086,7 +2146,7 @@ var Engine = class {
     return known.hash !== hash || known.stat !== stat4;
   }
   async record(path, before, after, at) {
-    const endedBeforeThisWrite = this.windows.filter((open) => !takesWrite(open, at));
+    const endedBeforeThisWrite = this.windows.filter((open2) => !takesWrite(open2, at));
     if (endedBeforeThisWrite.length) await this.commitOutside();
     for (const window2 of endedBeforeThisWrite) await this.endWindow(window2);
     const window = this.windows.at(-1);
@@ -2128,7 +2188,7 @@ var Engine = class {
       if (window.changes.size) await this.commitCut(window, [...window.changes.keys()]);
   }
   pendingElsewhere() {
-    return Boolean(this.outside?.changes.size) || this.windows.some((open) => open.changes.size > 0);
+    return Boolean(this.outside?.changes.size) || this.windows.some((open2) => open2.changes.size > 0);
   }
   /** The held claim `taken` continues: same key, each file from its own last change, no held file changed since. */
   heldFor(key, taken) {
@@ -2142,7 +2202,7 @@ var Engine = class {
     return group && taken.every((change) => after(change.path, change.before) === change.before) && [...group.changes.values()].every(untouched) ? group : null;
   }
   logPath(path) {
-    return relative5(this.dir, resolve7(this.dir, path)).split(sep5).join("/");
+    return relative5(this.dir, resolve8(this.dir, path)).split(sep5).join("/");
   }
   /** Takes `paths`' uncommitted changes from others, cut at what `who` overwrote. */
   async takeClaimed(who, paths, overwrote) {
@@ -2153,7 +2213,7 @@ var Engine = class {
         hashOfVersion(version)
       ])
     );
-    const others = this.windows.filter((open) => !sameWho(open.who, who));
+    const others = this.windows.filter((open2) => !sameWho(open2.who, who));
     const groups = this.outside ? [this.outside, ...others] : others;
     const hits = groups.flatMap(
       (group) => [...group.changes.values()].filter((change) => wanted.has(change.path)).map((change) => ({ group, change }))
@@ -2303,7 +2363,7 @@ var Engine = class {
   }
   /** A watcher saw a write: one sweep per burst takes it in (a deleted folder is reported by its name alone). */
   noteChange(path) {
-    const absolute = resolve7(this.dir, path);
+    const absolute = resolve8(this.dir, path);
     if (this.notedTimer || !affectsProjectSignature(this.dir, absolute)) return;
     if (!isHistoryPath(relative5(this.dir, absolute).split(sep5).join("/"))) return;
     this.notedTimer = setTimeout(() => {
@@ -2323,12 +2383,12 @@ var Engine = class {
       const at = this.now();
       if (exclusive) {
         const blocking = this.windows.find(
-          (open) => !sameWho(open.who, who) && takesWrite(open, at)
+          (open2) => !sameWho(open2.who, who) && takesWrite(open2, at)
         );
         if (blocking)
           throw new Error(`${blocking.who.name}'s turn is open; it has to end before yours begins`);
-        for (const open of [...this.windows])
-          if (!takesWrite(open, at) || sameWho(open.who, who)) await this.endWindow(open);
+        for (const open2 of [...this.windows])
+          if (!takesWrite(open2, at) || sameWho(open2.who, who)) await this.endWindow(open2);
       }
       const window = { ...this.newGroup(who, label), idleMs };
       this.windows.push(window);
@@ -2365,7 +2425,7 @@ var Engine = class {
     if (!this.windows.includes(window)) return window.entry ?? null;
     clearTimeout(window.idleTimer);
     await this.commitClaim();
-    this.windows = this.windows.filter((open) => open !== window);
+    this.windows = this.windows.filter((open2) => open2 !== window);
     window.entry = await this.commit(window) ?? window.entry ?? null;
     return window.entry;
   }
@@ -2424,7 +2484,7 @@ var Engine = class {
       );
       await this.sweep();
     } finally {
-      this.windows = this.windows.filter((open) => open !== group);
+      this.windows = this.windows.filter((open2) => open2 !== group);
     }
     return this.commit(group, extra);
   }
@@ -2491,7 +2551,7 @@ var Engine = class {
     );
     if (pending) return direction === "back" ? this.pendingEntry(pending) : void 0;
     const everyone = this.options.undoScope === "everyone";
-    const ofOpenTurn = (entry) => this.windows.some((open) => open.parts?.has(entry.id));
+    const ofOpenTurn = (entry) => this.windows.some((open2) => open2.parts?.has(entry.id));
     return stepTarget(
       this.log.entries,
       direction,
@@ -2590,7 +2650,7 @@ var Engine = class {
       checkout: (entryId, side, emptyDir) => this.queue(async () => {
         this.entry(entryId);
         if (!existsSync3(this.dir)) throw new Error(`The project folder is gone: ${this.dir}`);
-        const dest = resolve7(emptyDir);
+        const dest = resolve8(emptyDir);
         if (isWithin(this.dir, dest))
           throw new Error(`Checkout writes outside the project only: ${dest}`);
         if ((await readdir3(dest).catch(missingIsEmpty)).length > 0)
@@ -2641,7 +2701,7 @@ var Engine = class {
   }
 };
 function isWithin(dir, path) {
-  let probe = resolve7(path);
+  let probe = resolve8(path);
   while (!existsSync3(probe) && dirname5(probe) !== probe) probe = dirname5(probe);
   const rel = relative5(realpathSync.native(dir), realpathSync.native(probe));
   return rel === "" || rel !== ".." && !rel.startsWith(`..${sep5}`) && !isAbsolute5(rel);
@@ -2694,7 +2754,7 @@ async function openProjectHistory(options) {
   }
 }
 function readProjectHistory(options) {
-  const dir = resolve7(options.projectDir);
+  const dir = resolve8(options.projectDir);
   const id = readId(dir);
   const home = id && isRecordedFolder(join8(options.historyRoot, id), statSync5(dir)) ? join8(options.historyRoot, id) : null;
   const read = home && readLog(logFileIn(home), () => {
@@ -2771,14 +2831,14 @@ async function reclaimUncopiedBlobs(historyRoot, { dryRun = false, onError } = {
 }
 
 // src/history/historyCache.ts
-function historyCache(open) {
+function historyCache(open2) {
   const histories = /* @__PURE__ */ new Map();
   const get = async (projectDir) => {
     let cached = histories.get(projectDir);
-    if (!cached) histories.set(projectDir, cached = open(projectDir));
+    if (!cached) histories.set(projectDir, cached = open2(projectDir));
     const opened = await cached;
     if (!opened?.replacedAtPath()) return opened;
-    const reopen = () => open(projectDir);
+    const reopen = () => open2(projectDir);
     if (histories.get(projectDir) === cached)
       histories.set(projectDir, opened.close().then(reopen, reopen));
     return get(projectDir);
@@ -2810,6 +2870,8 @@ export {
   clearFileWriteReceipt,
   identifyFileWrite,
   consumeFileWriteReceipt,
+  serveWhileOpen,
+  onRestoredInPlace,
   HistoryIdError,
   listProjectHistories,
   pruneGoneProjectHistories,

package/dist/{chunk-C3KTZ7G3.js → chunk-YOCRTHW3.js}

@@ -1,7 +1,7 @@
 import {
   PROXY_PARAMS_VERSION,
   resolveProxy
-} from "./chunk-2B5SR4RJ.js";
+} from "./chunk-KPCW4DQM.js";
 import {
   createMediaCodecProbeCache,
   proxyVariantFor,

package/dist/helpers/mediaProxyPreview.js

@@ -4,8 +4,8 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-C3KTZ7G3.js";
-import "../chunk-2B5SR4RJ.js";
+} from "../chunk-YOCRTHW3.js";
+import "../chunk-KPCW4DQM.js";
 import "../chunk-FUTDRYQK.js";
 import "../chunk-X73QTST2.js";
 import "../chunk-QF7MFJJU.js";

package/dist/helpers/proxyTranscoder.js

@@ -20,7 +20,7 @@ import {
   retryProxyCopy,
   sourceFolderKind,
   waitForProxy
-} from "../chunk-2B5SR4RJ.js";
+} from "../chunk-KPCW4DQM.js";
 import "../chunk-FUTDRYQK.js";
 import "../chunk-X73QTST2.js";
 import "../chunk-QF7MFJJU.js";

package/dist/history/index.d.ts

@@ -17,6 +17,10 @@ declare class HistoryBusyError extends Error {
     constructor(pid: number, url?: string | undefined);
 }
 
+type InPlaceOutcome = "restored" | "mismatch" | "failed";
+type InPlaceListener = (absPath: string, outcome: InPlaceOutcome) => void;
+declare function onRestoredInPlace(listener: InPlaceListener): () => void;
+
 declare class HistoryIdError extends Error {
     constructor(message: string);
 }
@@ -148,4 +152,4 @@ declare function registerRenderOutput(projectDir: string, output: string): Promi
 /** Explicit outputs remain user evidence even when reusing a managed UUID folder. */
 declare function retainSnapshotOutput(project: string, path: string): void;
 
-export { type ArtifactCapture, type ArtifactInput, type ArtifactRecord, HistoryBusyError, HistoryIdError, HistoryTarget, HistoryWho, ProjectHistory, type ProjectHistoryRecord, type PrunedHistory, type ReclaimedHistory, type RenderRecord, type VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, listProjectHistories, pruneGoneProjectHistories, reclaimUncopiedBlobs, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput, retainSnapshotOutput };
+export { type ArtifactCapture, type ArtifactInput, type ArtifactRecord, HistoryBusyError, HistoryIdError, HistoryTarget, HistoryWho, type InPlaceOutcome, ProjectHistory, type ProjectHistoryRecord, type PrunedHistory, type ReclaimedHistory, type RenderRecord, type VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, listProjectHistories, onRestoredInPlace, pruneGoneProjectHistories, reclaimUncopiedBlobs, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput, retainSnapshotOutput };

package/dist/history/index.js

@@ -13,6 +13,7 @@ import {
   forgetRecordedArtifacts,
   historyCache,
   listProjectHistories,
+  onRestoredInPlace,
   openProjectHistory,
   pruneGoneProjectHistories,
   readProjectHistory,
@@ -22,7 +23,7 @@ import {
   recordRenderSuccess,
   registerRenderOutput,
   retainSnapshotOutput
-} from "../chunk-BWZMWYB2.js";
+} from "../chunk-UMPRW7BV.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
@@ -41,6 +42,7 @@ export {
   forgetRecordedArtifacts,
   historyCache,
   listProjectHistories,
+  onRestoredInPlace,
   openProjectHistory,
   pruneGoneProjectHistories,
   readProjectHistory,

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { Hono } from 'hono';
 import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-DIEtpLJo.js';
 export { L as LintResult, a as PreviewApiAdapter, R as RenderJobState, b as ResolvedProject, c as StudioSelectionResponse, d as StudioSelectionSnapshot, e as StudioSelectionTextField } from './mediaProxyPreview-DIEtpLJo.js';
 export { C as ClosedWindow, D as DEFAULT_HISTORY_ROOT, S as HISTORY_START, H as HistoryClosedError, a as HistoryEntry, b as HistoryEntrySide, c as HistoryFileChange, d as HistoryListItem, e as HistoryRefusedError, f as HistoryResult, g as HistoryTarget, h as HistoryWho, i as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, j as ProjectHistoryOptions, k as ProjectHistoryView, U as UNDO_MODES, l as UndoMode, o as openProjectHistory, r as readProjectHistory } from './projectHistory-C18HDvac.js';
-export { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, ProjectHistoryRecord, PrunedHistory, ReclaimedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, listProjectHistories, pruneGoneProjectHistories, reclaimUncopiedBlobs, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput, retainSnapshotOutput } from './history/index.js';
+export { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, InPlaceOutcome, ProjectHistoryRecord, PrunedHistory, ReclaimedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, listProjectHistories, onRestoredInPlace, pruneGoneProjectHistories, reclaimUncopiedBlobs, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput, retainSnapshotOutput } from './history/index.js';
 export { CACHE_DIR_NAME as PROXY_CACHE_DIR_NAME } from './helpers/proxyTranscoder.js';
 export { walkDir } from './helpers/safePath.js';
 export { stampProjectHfIds } from './helpers/hfIdPersist.js';

package/dist/index.js

@@ -49,6 +49,7 @@ import {
   historyCache,
   identifyFileWrite,
   listProjectHistories,
+  onRestoredInPlace,
   openProjectHistory,
   pruneGoneProjectHistories,
   readProjectHistory,
@@ -61,8 +62,9 @@ import {
   resolveProjectAndSignature,
   resolveProjectSignature,
   retainSnapshotOutput,
+  serveWhileOpen,
   settledFileTag
-} from "./chunk-BWZMWYB2.js";
+} from "./chunk-UMPRW7BV.js";
 import {
   clearElementScreenshotIsolation,
   getElementScreenshotClip
@@ -82,7 +84,7 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "./chunk-C3KTZ7G3.js";
+} from "./chunk-YOCRTHW3.js";
 import {
   CACHE_DIR_NAME,
   PROXY_PENDING_RETRY_AFTER_SECONDS,
@@ -95,7 +97,7 @@ import {
   resolveProxy,
   retryProxyCopy,
   waitForProxy
-} from "./chunk-2B5SR4RJ.js";
+} from "./chunk-KPCW4DQM.js";
 import {
   PROXY_VARIANT_CONFIG,
   decideMediaProxyEligibility,
@@ -3930,6 +3932,7 @@ import {
 import {
   PREVIEW_PROXY_BOX_PARAM,
   PREVIEW_PROXY_LIGHT_PARAM,
+  PREVIEW_PROXY_PRIORITY_HEADER,
   PREVIEW_PROXY_PROGRESS_HEADER,
   PREVIEW_PROXY_RETRY_PARAM,
   parsePreviewProxyBox
@@ -4632,7 +4635,11 @@ ${etag}`;
         if (c.req.query(PREVIEW_PROXY_RETRY_PARAM) !== void 0) {
           retryProxyCopy(project.dir, file, proxyVariant, proxyBox);
         }
-        servedPath = await waitForProxy(resolveProxy(project.dir, file, proxyVariant, proxyBox), 0);
+        const priority = c.req.header(PREVIEW_PROXY_PRIORITY_HEADER) === "1";
+        servedPath = await waitForProxy(
+          resolveProxy(project.dir, file, proxyVariant, proxyBox, { priority }),
+          0
+        );
       } catch (err) {
         if (err instanceof ProxyWaitTimeoutError) {
           const progress = proxyCopyProgress(project.dir, file, proxyVariant, proxyBox);
@@ -4659,7 +4666,7 @@ ${etag}`;
       // Node's web stream type and the DOM one do not overlap for tsc on
       // every platform's lib set; the double cast is the documented bridge.
       Readable.toWeb(
-        createReadStream(servedPath, { start, end })
+        serveWhileOpen(servedPath, createReadStream(servedPath, { start, end }))
       )
     );
     const rangeHeader = c.req.header("Range");
@@ -7007,6 +7014,7 @@ export {
   identifyFileWrite,
   isSafePath,
   listProjectHistories,
+  onRestoredInPlace,
   openProjectHistory,
   parseSourceDocument,
   patchElementInHtml,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.8.209",
+  "version": "0.8.211",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -84,8 +84,8 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.2",
-    "@hyperframes/core": "0.8.209",
-    "@hyperframes/parsers": "0.8.209"
+    "@hyperframes/core": "0.8.211",
+    "@hyperframes/parsers": "0.8.211"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",