@hyperframes/studio-server 0.8.170 → 0.8.171

package/dist/{chunk-SZF3L5MT.js → chunk-GG4AS4RK.js}

@@ -107,15 +107,17 @@ import { replaceFileAtomically } from "@hyperframes/core/atomic-file";
 
 // src/history/ownerLock.ts
 import { randomUUID as randomUUID2 } from "crypto";
-import { linkSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { linkSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "fs";
 import { join } from "path";
 var HistoryBusyError = class extends Error {
-  constructor(pid) {
+  constructor(pid, url) {
     super(`This project's history is open in another process (pid ${pid}).`);
     this.pid = pid;
+    this.url = url;
     this.name = "HistoryBusyError";
   }
   pid;
+  url;
 };
 function alive(pid) {
   if (!Number.isInteger(pid) || pid <= 0) return false;
@@ -166,14 +168,32 @@ function evictDeadOwner(file) {
     releaseOwn(evictor);
   }
 }
-async function takeHistoryOwnership(home, waitMs) {
+function advertise(urlFile, url) {
+  if (!url) return rmSync(urlFile, { force: true });
+  const draft = `${urlFile}-${process.pid}-${randomUUID2()}.tmp`;
+  writeFileSync(draft, JSON.stringify({ pid: process.pid, url }));
+  renameSync(draft, urlFile);
+}
+function servedBy(file, urlFile, pid) {
+  try {
+    const said = JSON.parse(readFileSync(urlFile, "utf-8"));
+    const live = said.pid === pid && alive(pid) && ownerOf(file) === pid;
+    return live && typeof said.url === "string" ? said.url : void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function takeHistoryOwnership(home, waitMs, url) {
   const file = join(home, "owner.pid");
+  const urlFile = join(home, "owner-url.json");
   const deadline = Date.now() + waitMs;
   mkdirSync(home, { recursive: true });
   for (; ; ) {
     if (claim(file)) {
+      advertise(urlFile, url);
       let held = true;
       return () => {
+        if (held && servedBy(file, urlFile, process.pid)) rmSync(urlFile, { force: true });
         if (held) releaseOwn(file);
         held = false;
       };
@@ -181,7 +201,7 @@ async function takeHistoryOwnership(home, waitMs) {
     const pid = ownerOf(file);
     if (pid === null) continue;
     if (!alive(pid) && evictDeadOwner(file)) continue;
-    if (Date.now() >= deadline) throw new HistoryBusyError(pid);
+    if (Date.now() >= deadline) throw new HistoryBusyError(pid, servedBy(file, urlFile, pid));
     await new Promise((settle) => setTimeout(settle, 50));
   }
 }
@@ -411,7 +431,7 @@ function createProjectSignature(projectDir, excluding = /* @__PURE__ */ new Set(
 
 // src/history/blobStore.ts
 import { createHash as createHash3, randomUUID as randomUUID3 } from "crypto";
-import { constants, createReadStream, createWriteStream, renameSync } from "fs";
+import { constants, createReadStream, createWriteStream, renameSync as renameSync2 } from "fs";
 import { copyFile, mkdir, readdir, readFile, rename, rm, stat } from "fs/promises";
 import { dirname, join as join2 } from "path";
 import { pipeline } from "stream/promises";
@@ -441,7 +461,7 @@ async function cloneOrCopy(from, to, beforeReplace) {
   try {
     await copyFile(from, temp, constants.COPYFILE_FICLONE);
     beforeReplace?.();
-    renameSync(temp, to);
+    renameSync2(temp, to);
   } catch (error) {
     await rm(temp, { force: true });
     throw error;
@@ -493,7 +513,7 @@ async function openBlobStore(dir) {
 
 // src/history/pruneHistories.ts
 import { randomUUID as randomUUID5 } from "crypto";
-import { readdirSync as readdirSync2, readFileSync as readFileSync5, renameSync as renameSync2, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
+import { readdirSync as readdirSync2, readFileSync as readFileSync5, renameSync as renameSync3, statSync as statSync2, writeFileSync as writeFileSync3 } from "fs";
 import { lstat, readdir as readdir2, rm as rm2 } from "fs/promises";
 import { tmpdir } from "os";
 import { dirname as dirname2, join as join4 } from "path";
@@ -657,7 +677,7 @@ function recheckAndMoveAway(historyRoot, id, { now, dryRun, tempDir }) {
   if (projectDir === null) return null;
   if (dryRun) return { projectDir, trash: null };
   const trash = join4(historyRoot, `${PRUNED_PREFIX}${id}-${randomUUID5()}`);
-  renameSync2(home, trash);
+  renameSync3(home, trash);
   return { projectDir, trash };
 }
 function abandonedProject(home, id, now, tempDir) {
@@ -716,7 +736,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 renameSync3, statSync as statSync3 } from "fs";
+import { createReadStream as createReadStream2, existsSync as existsSync2, readFileSync as readFileSync8, renameSync as renameSync4, statSync as statSync3 } from "fs";
 import { isAbsolute as isAbsolute4, join as join7, resolve as resolve6 } from "path";
 import { replaceFileAtomically as replaceFileAtomically3 } from "@hyperframes/core/atomic-file";
 
@@ -1117,7 +1137,7 @@ async function updateState(dir, update) {
       state = readState(dir);
     } catch (error) {
       if (!(error instanceof SyntaxError)) throw error;
-      renameSync3(statePath(dir), `${statePath(dir)}.invalid-${randomUUID6()}`);
+      renameSync4(statePath(dir), `${statePath(dir)}.invalid-${randomUUID6()}`);
       state = emptyState();
     }
     update(state);
@@ -2406,7 +2426,8 @@ async function openProjectHistory(options) {
   const projectId = projectHistoryId(options.projectDir, options.historyRoot);
   const release = await takeHistoryOwnership(
     join8(options.historyRoot, projectId),
-    options.ownerWaitMs ?? 5e3
+    options.ownerWaitMs ?? 5e3,
+    options.ownerUrl
   );
   try {
     const blobs = await openBlobStore(join8(options.historyRoot, projectId, "blobs"));

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,6 +1,6 @@
 import '@hyperframes/core';
-export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-J8vlAvrx.js';
+export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-6bL5skob.js';
 import './mediaCodecMap.js';
 import '@hyperframes/parsers';
 import '@hyperframes/core/compiler';
-import '../projectHistory-C5dpCjPU.js';
+import '../projectHistory-ByC9sa3X.js';

package/dist/history/index.d.ts

@@ -1,9 +1,10 @@
-import { P as ProjectHistory, f as HistoryTarget, g as HistoryWho } from '../projectHistory-C5dpCjPU.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 HistoryResult, h as HistoryWindow, M as MAX_WINDOW_IDLE_MS, i as ProjectHistoryOptions, j as ProjectHistoryView, U as UNDO_MODES, k as UndoMode, o as openProjectHistory, r as readProjectHistory } from '../projectHistory-C5dpCjPU.js';
+import { P as ProjectHistory, f as HistoryTarget, g as HistoryWho } from '../projectHistory-ByC9sa3X.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 HistoryResult, h as HistoryWindow, M as MAX_WINDOW_IDLE_MS, i as ProjectHistoryOptions, j as ProjectHistoryView, U as UNDO_MODES, k as UndoMode, o as openProjectHistory, r as readProjectHistory } from '../projectHistory-ByC9sa3X.js';
 
 declare class HistoryBusyError extends Error {
     readonly pid: number;
-    constructor(pid: number);
+    readonly url?: string | undefined;
+    constructor(pid: number, url?: string | undefined);
 }
 
 declare class HistoryIdError extends Error {

package/dist/history/index.js

@@ -20,7 +20,7 @@ import {
   recordRenderSuccess,
   registerRenderOutput,
   retainSnapshotOutput
-} from "../chunk-SZF3L5MT.js";
+} from "../chunk-GG4AS4RK.js";
 import "../chunk-K56J3CL7.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-J8vlAvrx.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-J8vlAvrx.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 HistoryResult, f as HistoryTarget, g as HistoryWho, h as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, i as ProjectHistoryOptions, j as ProjectHistoryView, U as UNDO_MODES, k as UndoMode, o as openProjectHistory, r as readProjectHistory } from './projectHistory-C5dpCjPU.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-6bL5skob.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-6bL5skob.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 HistoryResult, f as HistoryTarget, g as HistoryWho, h as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, i as ProjectHistoryOptions, j as ProjectHistoryView, U as UNDO_MODES, k as UndoMode, o as openProjectHistory, r as readProjectHistory } from './projectHistory-ByC9sa3X.js';
 export { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, ProjectHistoryRecord, PrunedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, listProjectHistories, pruneGoneProjectHistories, 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';

package/dist/index.js

@@ -60,7 +60,7 @@ import {
   resolveProjectSignature,
   retainSnapshotOutput,
   settledFileTag
-} from "./chunk-SZF3L5MT.js";
+} from "./chunk-GG4AS4RK.js";
 import {
   clearElementScreenshotIsolation,
   getElementScreenshotClip
@@ -6409,6 +6409,33 @@ function nextStep(history, direction) {
   const paths = target.files.map((file) => file.path);
   return { id: target.id, label: target.label, endedAt: target.endedAt, paths };
 }
+var LOOPBACK = /* @__PURE__ */ new Set(["127.0.0.1", "localhost", "[::1]"]);
+var FORWARD_DEADLINE_MS = 5e3;
+function ownerRoute(c, error) {
+  if (!(error instanceof HistoryBusyError) || !error.url || !URL.canParse(error.url)) return null;
+  const owner = new URL(error.url);
+  if (owner.protocol !== "http:" || !LOOPBACK.has(owner.hostname)) return null;
+  const rest = c.req.path.replace(/^.*?\/projects\/[^/]+\/history/, "");
+  return `${owner.href.replace(/\/$/, "")}${rest}${new URL(c.req.url).search}`;
+}
+async function forward(c, target) {
+  const token = c.req.header("X-Hyperframes-Write-Token");
+  const reads = c.req.method === "GET" || c.req.method === "HEAD";
+  const reply = await fetch(target, {
+    method: c.req.method,
+    headers: {
+      "content-type": c.req.header("content-type") ?? "application/json",
+      ...token && { "X-Hyperframes-Write-Token": token }
+    },
+    ...!reads && { body: await c.req.arrayBuffer() },
+    signal: AbortSignal.timeout(FORWARD_DEADLINE_MS)
+  });
+  const type = reply.headers.get("content-type") ?? "application/json";
+  return new Response(await reply.arrayBuffer(), {
+    status: reply.status,
+    headers: { "content-type": type }
+  });
+}
 async function withHistory(adapter, c, task) {
   try {
     const history = await historyOf(adapter, c);
@@ -6416,7 +6443,9 @@ async function withHistory(adapter, c, task) {
     const result = await task(history, await bodyOf(c));
     return result instanceof Response ? result : c.json(result ?? null);
   } catch (error) {
-    return c.json({ error: error instanceof Error ? error.message : String(error) }, 409);
+    const target = ownerRoute(c, error);
+    const forwarded = target && await forward(c, target).catch(() => null);
+    return forwarded || c.json({ error: error instanceof Error ? error.message : String(error) }, 409);
   }
 }
 function registerHistoryRoutes(api, adapter) {

package/dist/{mediaProxyPreview-J8vlAvrx.d.ts → mediaProxyPreview-6bL5skob.d.ts}

@@ -2,7 +2,7 @@ import * as _hyperframes_core from '@hyperframes/core';
 import { RegistryItem, PreviewProxyBox } from '@hyperframes/core';
 import { CanvasResolution } from '@hyperframes/parsers';
 import { BundleOptions } from '@hyperframes/core/compiler';
-import { P as ProjectHistory } from './projectHistory-C5dpCjPU.js';
+import { P as ProjectHistory } from './projectHistory-ByC9sa3X.js';
 import { MediaCodecProbeCache, HtmlSourceLike } from './helpers/mediaCodecMap.js';
 
 /** Resolved info about a single project. */

package/dist/{projectHistory-C5dpCjPU.d.ts → projectHistory-ByC9sa3X.d.ts}

@@ -50,6 +50,7 @@ interface ProjectHistoryOptions {
     onError?: (error: unknown) => void;
     /** How long an open waits for another process to close the same history (default 5 s). */
     ownerWaitMs?: number;
+    ownerUrl?: string;
     /** A CLI turn's window from an earlier open: writes since, within its idle limit, become the entry with its id. */
     closedWindow?: ClosedWindow;
     closedWindowAfterOwnership?: () => ClosedWindow | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.8.170",
+  "version": "0.8.171",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -85,8 +85,8 @@
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.2",
     "sharp": "^0.35.0",
-    "@hyperframes/core": "0.8.170",
-    "@hyperframes/parsers": "0.8.170"
+    "@hyperframes/core": "0.8.171",
+    "@hyperframes/parsers": "0.8.171"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",