@hyperframes/studio-server 0.8.220 → 0.8.222

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

@@ -7,7 +7,7 @@ import {
 
 // src/history/projectHistory.ts
 import { randomUUID as randomUUID7 } from "crypto";
-import { mkdir as mkdir2, readdir as readdir3, rm as rm3, rmdir, stat as stat2, writeFile } from "fs/promises";
+import { mkdir as mkdir2, readdir as readdir4, rm as rm3, rmdir, stat as stat2, writeFile } from "fs/promises";
 import {
   existsSync as existsSync3,
   lstatSync as lstatSync4,
@@ -358,6 +358,7 @@ async function registerRenderOutput(projectDir, output) {
 // src/helpers/projectSignature.ts
 import { createHash as createHash2 } from "crypto";
 import { lstatSync, readFileSync as readFileSync3, readdirSync } from "fs";
+import { lstat, readFile, readdir } from "fs/promises";
 import { extname, isAbsolute as isAbsolute2, relative as relative2, resolve as resolve2, sep as sep2 } from "path";
 import { isAtomicTempPath } from "@hyperframes/core/atomic-file";
 import { isProjectIgnoredDir } from "@hyperframes/core/project-folders";
@@ -408,6 +409,15 @@ function signatureEntryStat(projectDir, entry, file, outputs) {
     return null;
   }
 }
+function signatureFileOf(file, stat4) {
+  return {
+    file,
+    mtimeMs: stat4.mtimeMs,
+    ctimeMs: stat4.ctimeMs,
+    size: stat4.size,
+    textContentEligible: isTextContentEligible(file, stat4.size)
+  };
+}
 function collectProjectSignatureFiles(projectDir, dir, files, outputs = readRenderOutputsOrNone(projectDir)) {
   let entries;
   try {
@@ -422,13 +432,7 @@ function collectProjectSignatureFiles(projectDir, dir, files, outputs = readRend
     if (stat4.isDirectory()) {
       collectProjectSignatureFiles(projectDir, file, files, outputs);
     } else if (stat4.isFile()) {
-      files.push({
-        file,
-        mtimeMs: stat4.mtimeMs,
-        ctimeMs: stat4.ctimeMs,
-        size: stat4.size,
-        textContentEligible: isTextContentEligible(file, stat4.size)
-      });
+      files.push(signatureFileOf(file, stat4));
     }
   }
 }
@@ -444,16 +448,40 @@ function collectProjectSignatureManifestFiles(projectDir, files) {
       continue;
     }
     if (stat4.isSymbolicLink() || !stat4.isFile()) continue;
-    files.push({
-      file,
-      mtimeMs: stat4.mtimeMs,
-      ctimeMs: stat4.ctimeMs,
-      size: stat4.size,
-      textContentEligible: isTextContentEligible(file, stat4.size)
-    });
+    files.push(signatureFileOf(file, stat4));
     seen.add(file);
   }
 }
+async function signatureEntryStatAsync(projectDir, entry, file, outputs) {
+  if (isSkippedEntry(entry) || !isPathWithin(projectDir, file)) return null;
+  if (isRenderOutput(projectDir, file, outputs)) return null;
+  try {
+    const stat4 = await lstat(file);
+    return stat4.isSymbolicLink() ? null : stat4;
+  } catch {
+    return null;
+  }
+}
+async function collectProjectSignatureFilesAsync(projectDir, dir, files, outputs) {
+  let entries;
+  try {
+    entries = (await readdir(dir)).sort();
+  } catch {
+    return;
+  }
+  const paths = entries.map((entry) => resolve2(dir, entry));
+  const stats = await Promise.all(
+    entries.map((entry, i) => signatureEntryStatAsync(projectDir, entry, paths[i], outputs))
+  );
+  for (const [i, stat4] of stats.entries()) {
+    if (!stat4) continue;
+    if (stat4.isDirectory()) {
+      await collectProjectSignatureFilesAsync(projectDir, paths[i], files, outputs);
+    } else if (stat4.isFile()) {
+      files.push(signatureFileOf(paths[i], stat4));
+    }
+  }
+}
 function createProjectFingerprint(projectDir, files) {
   const hash = createHash2("sha256");
   for (const entry of files) {
@@ -476,6 +504,17 @@ function collectProjectFiles(normalizedProjectDir) {
   collectProjectSignatureManifestFiles(normalizedProjectDir, collected);
   return collected;
 }
+async function collectProjectFilesAsync(normalizedProjectDir) {
+  const collected = [];
+  await collectProjectSignatureFilesAsync(
+    normalizedProjectDir,
+    normalizedProjectDir,
+    collected,
+    readRenderOutputsOrNone(normalizedProjectDir)
+  );
+  collectProjectSignatureManifestFiles(normalizedProjectDir, collected);
+  return collected;
+}
 function listProjectFiles(projectDir) {
   const normalizedProjectDir = resolve2(projectDir);
   return collectProjectFiles(normalizedProjectDir).map((entry) => ({
@@ -493,48 +532,79 @@ async function resolveProjectAndSignature(adapter, projectId) {
   if (!project) return null;
   return { project, signature: resolveProjectSignature(adapter, project.dir) };
 }
-function createProjectSignature(projectDir, excluding = /* @__PURE__ */ new Set()) {
-  const normalizedProjectDir = resolve2(projectDir);
-  const signedAt = Date.now();
-  const collected = collectProjectFiles(normalizedProjectDir);
+function planSignature(dir, collected, excluding, signedAt) {
   const files = collected.filter(
-    (entry) => !excluding.has(relative2(normalizedProjectDir, entry.file).split(sep2).join("/"))
+    (entry) => !excluding.has(relative2(dir, entry.file).split(sep2).join("/"))
   );
   files.sort((a, b) => a.file.localeCompare(b.file));
-  const fingerprint = createProjectFingerprint(normalizedProjectDir, files);
-  const cacheKey = excluding.size ? `${normalizedProjectDir}\0${createHash2("sha256").update([...excluding].sort().join("\0")).digest("hex")}` : normalizedProjectDir;
-  const cached = projectSignatureCache.get(cacheKey);
-  if (cached?.fingerprint === fingerprint) return cached.signature;
+  const cacheKey = excluding.size ? `${dir}\0${createHash2("sha256").update([...excluding].sort().join("\0")).digest("hex")}` : dir;
+  return { dir, files, cacheKey, fingerprint: createProjectFingerprint(dir, files), signedAt };
+}
+function hashSignatureEntry(hash, dir, entry, content) {
+  hash.update(relative2(dir, entry.file));
+  hash.update("\0");
+  hash.update(String(entry.size));
+  hash.update("\0");
+  hash.update(content ?? String(entry.mtimeMs));
+  hash.update("\0");
+}
+function finishSignature(plan, hash) {
+  const signature = hash.digest("hex").slice(0, 24);
+  const settledATickBeforeSigning = plan.files.every(
+    (entry) => Math.max(entry.mtimeMs, entry.ctimeMs) < plan.signedAt - COARSEST_FILE_TIME_TICK_MS
+  );
+  if (settledATickBeforeSigning) {
+    projectSignatureCache.set(plan.cacheKey, { fingerprint: plan.fingerprint, signature });
+  }
+  return signature;
+}
+var cachedSignature = (plan) => {
+  const cached = projectSignatureCache.get(plan.cacheKey);
+  return cached?.fingerprint === plan.fingerprint ? cached.signature : void 0;
+};
+function createProjectSignature(projectDir, excluding = /* @__PURE__ */ new Set()) {
+  const dir = resolve2(projectDir);
+  const plan = planSignature(dir, collectProjectFiles(dir), excluding, Date.now());
+  const cached = cachedSignature(plan);
+  if (cached !== void 0) return cached;
   const hash = createHash2("sha256");
-  for (const entry of files) {
-    const relativePath = relative2(normalizedProjectDir, entry.file);
-    hash.update(relativePath);
-    hash.update("\0");
-    hash.update(String(entry.size));
-    hash.update("\0");
+  for (const entry of plan.files) {
+    let content = null;
     if (entry.textContentEligible) {
       try {
-        hash.update(readFileSync3(entry.file));
+        content = readFileSync3(entry.file);
       } catch {
-        hash.update(String(entry.mtimeMs));
+        content = null;
       }
-    } else {
-      hash.update(String(entry.mtimeMs));
     }
-    hash.update("\0");
+    hashSignatureEntry(hash, dir, entry, content);
   }
-  const signature = hash.digest("hex").slice(0, 24);
-  const settledATickBeforeSigning = files.every(
-    (entry) => Math.max(entry.mtimeMs, entry.ctimeMs) < signedAt - COARSEST_FILE_TIME_TICK_MS
-  );
-  if (settledATickBeforeSigning) projectSignatureCache.set(cacheKey, { fingerprint, signature });
-  return signature;
+  return finishSignature(plan, hash);
+}
+var SIGNATURE_READ_BATCH = 32;
+async function createProjectSignatureAsync(projectDir, excluding = /* @__PURE__ */ new Set()) {
+  const dir = resolve2(projectDir);
+  const signedAt = Date.now();
+  const plan = planSignature(dir, await collectProjectFilesAsync(dir), excluding, signedAt);
+  const cached = cachedSignature(plan);
+  if (cached !== void 0) return cached;
+  const hash = createHash2("sha256");
+  for (let at = 0; at < plan.files.length; at += SIGNATURE_READ_BATCH) {
+    const batch = plan.files.slice(at, at + SIGNATURE_READ_BATCH);
+    const contents = await Promise.all(
+      batch.map(
+        (entry) => entry.textContentEligible ? readFile(entry.file).catch(() => null) : null
+      )
+    );
+    for (const [i, entry] of batch.entries()) hashSignatureEntry(hash, dir, entry, contents[i]);
+  }
+  return finishSignature(plan, hash);
 }
 
 // src/history/blobStore.ts
 import { createHash as createHash3, randomUUID as randomUUID3 } from "crypto";
 import { constants, createReadStream, createWriteStream } from "fs";
-import { copyFile, mkdir, open, readdir, readFile, rm, stat } from "fs/promises";
+import { copyFile, mkdir, open, readdir as readdir2, readFile as readFile2, rm, stat } from "fs/promises";
 import { dirname, join as join2 } from "path";
 import { pipeline } from "stream/promises";
 import { atomicTempPath } from "@hyperframes/core/atomic-file";
@@ -577,7 +647,7 @@ function blobPath(dir, hash) {
   if (!BLOB_HASH.test(hash)) throw new Error("That is not a history blob.");
   return join2(dir, hash.slice(0, 2), hash);
 }
-var readBlob = (dir, hash) => readFile(blobPath(dir, hash));
+var readBlob = (dir, hash) => readFile2(blobPath(dir, hash));
 async function hashFile(path) {
   const hash = createHash3("sha256");
   for await (const chunk of createReadStream(path)) hash.update(chunk);
@@ -630,7 +700,7 @@ async function writeInPlace(temp, to, hash) {
   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) => {
+var listDir = (path) => readdir2(path, { withFileTypes: true }).catch((error) => {
   if (error.code === "ENOENT") return [];
   throw error;
 });
@@ -687,7 +757,7 @@ async function openBlobStore(dir) {
     },
     reference: (absPath) => hashFile(absPath),
     has: (hash) => sizes.has(hash) || asideSizes.has(hash),
-    read: (hash) => readFile(pathOf(hash)),
+    read: (hash) => readFile2(pathOf(hash)),
     writeTo: async (hash, absPath, beforeReplace) => cloneOrCopy(pathOf(hash), absPath, hash, beforeReplace),
     async release(held) {
       for (const [hash, path] of held) {
@@ -751,7 +821,8 @@ var MEDIA_EXTENSIONS = /* @__PURE__ */ new Set([
   ".opus"
 ]);
 var COPY_NOTHING_ABOVE_BYTES = 64 * 1024 ** 2;
-var isUncopied = (path, size) => size > COPY_NOTHING_ABOVE_BYTES || MEDIA_EXTENSIONS.has(extname2(path).toLowerCase());
+var isUncopiedMedia = (path) => MEDIA_EXTENSIONS.has(extname2(path).toLowerCase());
+var isUncopied = (path, size) => size > COPY_NOTHING_ABOVE_BYTES || isUncopiedMedia(path);
 function uncopiedOnlyHashes(log, sizeOf) {
   const copied = /* @__PURE__ */ new Set();
   const uncopied = /* @__PURE__ */ new Set();
@@ -770,7 +841,7 @@ function uncopiedOnlyHashes(log, sizeOf) {
 // src/history/pruneHistories.ts
 import { randomUUID as randomUUID5 } from "crypto";
 import { readdirSync as readdirSync2, readFileSync as readFileSync5, renameSync, statSync as statSync3, writeFileSync as writeFileSync3 } from "fs";
-import { lstat, readdir as readdir2, rm as rm2 } from "fs/promises";
+import { lstat as lstat2, readdir as readdir3, rm as rm2 } from "fs/promises";
 import { tmpdir } from "os";
 import { dirname as dirname2, join as join4 } from "path";
 
@@ -966,9 +1037,9 @@ function lastUsed(home) {
 }
 async function bytesIn(dir) {
   let total = 0;
-  for (const entry of await readdir2(dir, { withFileTypes: true })) {
+  for (const entry of await readdir3(dir, { withFileTypes: true })) {
     const path = join4(dir, entry.name);
-    total += entry.isDirectory() ? await bytesIn(path) : (await lstat(path)).size;
+    total += entry.isDirectory() ? await bytesIn(path) : (await lstat2(path)).size;
   }
   return total;
 }
@@ -1781,7 +1852,7 @@ var isMissingFolder = (error) => ["ENOENT", "ENOTDIR"].includes(error.code ?? ""
 async function removeEmptyFolders(dir) {
   let entries;
   try {
-    entries = await readdir3(dir, { withFileTypes: true });
+    entries = await readdir4(dir, { withFileTypes: true });
   } catch (error) {
     if (isMissingFolder(error)) return;
     throw error;
@@ -2653,7 +2724,7 @@ var Engine = class {
         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)
+        if ((await readdir4(dest).catch(missingIsEmpty)).length > 0)
           throw new Error(`Checkout writes into an empty folder only: ${dest}`);
         const files = manifestAround(this.log, entryId, side);
         for (const [path, hash] of files)
@@ -2662,7 +2733,7 @@ var Engine = class {
         try {
           for (const [path, hash] of files) await this.blobs.writeTo(hash, join8(dest, path));
         } catch (error) {
-          for (const name of await readdir3(dest).catch(() => []))
+          for (const name of await readdir4(dest).catch(() => []))
             await rm3(join8(dest, name), { recursive: true, force: true });
           throw error;
         }
@@ -2862,6 +2933,7 @@ export {
   resolveProjectSignature,
   resolveProjectAndSignature,
   createProjectSignature,
+  createProjectSignatureAsync,
   fileContentVersion,
   DELETED_VERSION,
   settledFileTag,
@@ -2872,6 +2944,7 @@ export {
   consumeFileWriteReceipt,
   serveWhileOpen,
   onRestoredInPlace,
+  isUncopiedMedia,
   HistoryIdError,
   listProjectHistories,
   pruneGoneProjectHistories,

package/dist/{chunk-OF4B2ILS.js → chunk-V6K3WWWU.js}

@@ -13,7 +13,11 @@ import {
   mintHfId,
   walkCompositionDescendants
 } from "@hyperframes/parsers/hf-ids";
-import { readClipTiming, writeClipTiming } from "@hyperframes/core/composition-contract";
+import {
+  readClipTiming,
+  SPLIT_BOUNDARY_EPSILON_S,
+  writeClipTiming
+} from "@hyperframes/core/composition-contract";
 import { relinkSplitHalves } from "@hyperframes/core/media-link";
 
 // src/helpers/sourceStyleMutation.ts
@@ -334,7 +338,7 @@ function splitElementInHtml(source, target, splitTime, newId, fallbackTiming) {
     start = fallbackTiming.start;
     duration = fallbackTiming.duration;
   }
-  if (duration <= 0 || splitTime <= start || splitTime >= start + duration) {
+  if (duration <= 0 || splitTime < start + SPLIT_BOUNDARY_EPSILON_S || splitTime > start + duration - SPLIT_BOUNDARY_EPSILON_S) {
     return { html: source, matched: false, newId: null };
   }
   newId = nextUniqueId(document, newId);

package/dist/helpers/sourceMutation.js

@@ -13,7 +13,7 @@ import {
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "../chunk-OF4B2ILS.js";
+} from "../chunk-V6K3WWWU.js";
 export {
   dedupeClonedCompositionId,
   findTargetElement,

package/dist/history/index.d.ts

@@ -11,6 +11,8 @@ declare function reclaimUncopiedBlobs(historyRoot: string, { dryRun, onError }?:
     onError?: (error: unknown) => void;
 }): Promise<ReclaimedHistory[]>;
 
+declare const isUncopiedMedia: (path: string) => boolean;
+
 declare class HistoryBusyError extends Error {
     readonly pid: number;
     readonly url?: string | undefined;
@@ -152,4 +154,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, 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 };
+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, isUncopiedMedia, listProjectHistories, onRestoredInPlace, pruneGoneProjectHistories, reclaimUncopiedBlobs, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput, retainSnapshotOutput };

package/dist/history/index.js

@@ -12,6 +12,7 @@ import {
   finishSnapshotRun,
   forgetRecordedArtifacts,
   historyCache,
+  isUncopiedMedia,
   listProjectHistories,
   onRestoredInPlace,
   openProjectHistory,
@@ -23,7 +24,7 @@ import {
   recordRenderSuccess,
   registerRenderOutput,
   retainSnapshotOutput
-} from "../chunk-UMPRW7BV.js";
+} from "../chunk-CZ2QLV2C.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
@@ -41,6 +42,7 @@ export {
   finishSnapshotRun,
   forgetRecordedArtifacts,
   historyCache,
+  isUncopiedMedia,
   listProjectHistories,
   onRestoredInPlace,
   openProjectHistory,

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-BnQDzKj1.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-BnQDzKj1.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, 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 { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, InPlaceOutcome, ProjectHistoryRecord, PrunedHistory, ReclaimedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, isUncopiedMedia, 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';
@@ -54,6 +54,8 @@ declare function affectsProjectSignature(projectDir: string, changedPath: string
  * `excluding` (project-relative paths) leaves those files out.
  */
 declare function createProjectSignature(projectDir: string, excluding?: ReadonlySet<string>): string;
+/** `createProjectSignature` without blocking the event loop: the same signature, with the walk and reads awaited. */
+declare function createProjectSignatureAsync(projectDir: string, excluding?: ReadonlySet<string>): Promise<string>;
 
 /**
  * Compositions whose rendered frames a write at `changedPath` can change, or `null` for all
@@ -230,4 +232,4 @@ type BackgroundRemovalRender = (options: {
 }>;
 declare function createBackgroundRemovalJob(opts: BackgroundRemovalJobOptions, render: BackgroundRemovalRender): MediaProcessingJobState;
 
-export { type AppliedFileMutation, type BackgroundRemovalRender, DELETED_VERSION, type DuplicateElementResult, type FileMutationInput, type FileWriteReceipt, MAX_UPLOAD_BYTES, MIME_TYPES, MediaProcessingJobState, PREVIEW_BUNDLE_OPTIONS, STUDIO_SIGNATURE_MANIFEST_PATHS, SourceMutationTarget, StudioApiAdapter, type ThumbnailOutputDimensions, affectsPreview, affectsProjectSignature, applyFileMutations, buildSubCompositionHtml, cleanupProxyCache, compositionsAffectedBy, consumeFileWriteReceipt, createBackgroundRemovalJob, createPreviewDocumentStore, createProjectSignature, createStudioApi, duplicateElementInHtml, fileContentVersion, getMimeType, identifyFileWrite, requestSubPath, settledFileTag, thumbnailDeviceScaleFactor };
+export { type AppliedFileMutation, type BackgroundRemovalRender, DELETED_VERSION, type DuplicateElementResult, type FileMutationInput, type FileWriteReceipt, MAX_UPLOAD_BYTES, MIME_TYPES, MediaProcessingJobState, PREVIEW_BUNDLE_OPTIONS, STUDIO_SIGNATURE_MANIFEST_PATHS, SourceMutationTarget, StudioApiAdapter, type ThumbnailOutputDimensions, affectsPreview, affectsProjectSignature, applyFileMutations, buildSubCompositionHtml, cleanupProxyCache, compositionsAffectedBy, consumeFileWriteReceipt, createBackgroundRemovalJob, createPreviewDocumentStore, createProjectSignature, createProjectSignatureAsync, createStudioApi, duplicateElementInHtml, fileContentVersion, getMimeType, identifyFileWrite, requestSubPath, settledFileTag, thumbnailDeviceScaleFactor };

package/dist/index.js

@@ -17,7 +17,7 @@ import {
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "./chunk-OF4B2ILS.js";
+} from "./chunk-V6K3WWWU.js";
 import {
   isCompositionSource,
   stampProjectHfIds
@@ -42,12 +42,14 @@ import {
   clearFileWriteReceipt,
   consumeFileWriteReceipt,
   createProjectSignature,
+  createProjectSignatureAsync,
   createWriteToken,
   fileContentVersion,
   finishSnapshotRun,
   forgetRecordedArtifacts,
   historyCache,
   identifyFileWrite,
+  isUncopiedMedia,
   listProjectHistories,
   onRestoredInPlace,
   openProjectHistory,
@@ -64,7 +66,7 @@ import {
   retainSnapshotOutput,
   serveWhileOpen,
   settledFileTag
-} from "./chunk-UMPRW7BV.js";
+} from "./chunk-CZ2QLV2C.js";
 import {
   clearElementScreenshotIsolation,
   getElementScreenshotClip
@@ -351,7 +353,7 @@ function withRootPathsRelative(html, base) {
 function rewriteRelativePaths(root, compPath, projectDir) {
   const assetExists = (path) => existsSync(join2(projectDir, path));
   rewriteAssetPaths(
-    root.querySelectorAll("[src], [href]"),
+    root.querySelectorAll("[src], [href], [srcset]"),
     compPath,
     (el, attr) => el.getAttribute(attr),
     (el, attr, value) => el.setAttribute(attr, value),
@@ -1020,11 +1022,9 @@ function validateUploadedMediaBuffer(fileName, buffer, runner = defaultRunner) {
 // src/helpers/backupJournal.ts
 import { readdirSync, readFileSync as readFileSync3, unlinkSync, writeFileSync as writeFileSync3 } from "fs";
 import { Buffer as Buffer2 } from "buffer";
+import { createHash as createHash2 } from "crypto";
 import { join as join5, relative as relative2 } from "path";
 var DEFAULT_KEEP_PER_FILE = 10;
-function backupKeyForPath(path) {
-  return Buffer2.from(path, "utf-8").toString("base64url");
-}
 function timestampPrefix() {
   return (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
 }
@@ -1041,10 +1041,11 @@ function snapshotBeforeWrite(projectDir, absPath, options = {}) {
     const relativePath = relative2(projectDir, absPath);
     const backupDir = join5(projectDir, ".hyperframes", "backup");
     mkdirWithinProject(projectDir, backupDir);
-    const backupKey = backupKeyForPath(relativePath);
+    const pathKey2 = Buffer2.from(relativePath, "utf-8").toString("base64url");
+    const backupKey = pathKey2.length <= 200 ? pathKey2 : `sha256~${createHash2("sha256").update(relativePath).digest("hex")}`;
     const backupPath = nextBackupPath(backupDir, backupKey);
     writeFileSync3(backupPath, content);
-    pruneBackups(backupDir, backupKey, options.keepPerFile ?? DEFAULT_KEEP_PER_FILE);
+    pruneBackups(backupDir, [pathKey2, backupKey], options.keepPerFile ?? DEFAULT_KEEP_PER_FILE);
     return { backupPath };
   } catch (error) {
     if (isProjectRootMissing(error)) throw error;
@@ -1071,11 +1072,10 @@ function nextBackupPath(backupDir, backupKey) {
     counter += 1;
   }
 }
-function pruneBackups(backupDir, backupKey, keepPerFile) {
+function pruneBackups(backupDir, backupKeys, keepPerFile) {
   const keep = Math.max(1, Math.floor(keepPerFile));
-  const suffix = `-${backupKey}`;
-  const numberedSuffix = new RegExp(`-${backupKey}-\\d+$`);
-  const matches = readdirSync(backupDir).filter((name) => name.endsWith(suffix) || numberedSuffix.test(name)).map((name) => join5(backupDir, name)).sort((a, b) => {
+  const suffix = new RegExp(`-(?:${backupKeys.join("|")})(?:-\\d+)?$`);
+  const matches = readdirSync(backupDir).filter((name) => suffix.test(name)).map((name) => join5(backupDir, name)).sort((a, b) => {
     return b.localeCompare(a);
   });
   for (const file of matches.slice(keep)) {
@@ -3915,7 +3915,7 @@ import { createReadStream, existsSync as existsSync5, readFileSync as readFileSy
 import { stripSdrPngColourTags } from "@hyperframes/core/compiler/png-colour-tags";
 import { Readable } from "stream";
 import { join as join8, resolve as resolve4 } from "path";
-import { createHash as createHash2 } from "crypto";
+import { createHash as createHash3 } from "crypto";
 import {
   AFTER_FONTS_SCRIPT_TYPE,
   addScenePartsManifest,
@@ -4315,7 +4315,7 @@ function parsePreviewVariablesParam(raw) {
 }
 function variablesEtagSalt(raw) {
   if (!raw) return "";
-  return `:vars:${createHash2("sha1").update(raw).digest("hex").slice(0, 12)}`;
+  return `:vars:${createHash3("sha1").update(raw).digest("hex").slice(0, 12)}`;
 }
 function previewVariablesFromRequest(rawVariables) {
   const parse2 = parsePreviewVariablesParam(rawVariables);
@@ -4412,7 +4412,7 @@ function resolvePreviewGsapBaseUrl(adapter) {
 }
 function registerPreviewRoutes(api, adapter) {
   const gsapBaseUrl = resolvePreviewGsapBaseUrl(adapter);
-  const gsapEtagSalt = `:gsap:${createHash2("sha1").update(gsapBaseUrl).digest("hex").slice(0, 12)}`;
+  const gsapEtagSalt = `:gsap:${createHash3("sha1").update(gsapBaseUrl).digest("hex").slice(0, 12)}`;
   const previewCacheHeaders = (etag) => ({
     "Cache-Control": "private, no-cache",
     ETag: etag
@@ -4547,7 +4547,7 @@ ${etag}`;
     if (!compFile || !existsSync5(compFile) || !statSync4(compFile).isFile()) {
       return c.text("not found", 404);
     }
-    const compPathHash = createHash2("sha1").update(compPath).digest("hex");
+    const compPathHash = createHash3("sha1").update(compPath).digest("hex");
     const capture = c.req.query(PREVIEW_CAPTURE_PARAM) !== void 0;
     const etag = `"comp:v2:${compPathHash}:${signature}${gsapEtagSalt}${variablesEtagSalt(vars.raw)}${capture ? ":capture" : ""}"`;
     const ifNoneMatch = c.req.header("If-None-Match");
@@ -5052,7 +5052,7 @@ function registerRenderRoutes(api, adapter) {
 // src/routes/imageThumbnail.ts
 import { HTTPException } from "hono/http-exception";
 import { open, stat } from "fs/promises";
-import { createHash as createHash3 } from "crypto";
+import { createHash as createHash4 } from "crypto";
 
 // src/routes/thumbnailGenerationCoordinator.ts
 var ThumbnailGenerationCoordinator = class {
@@ -5230,7 +5230,7 @@ function registerImageThumbnailRoutes(api, adapter) {
   api.get("/projects/:id/image-thumbnail/*", async (c) => {
     try {
       const { path, info } = await resolveSource(adapter, c.req.param("id"), c.req.url);
-      const key = createHash3("sha256").update(JSON.stringify([path, info.dev, info.ino, info.size, info.mtimeMs, info.ctimeMs])).digest("hex");
+      const key = createHash4("sha256").update(JSON.stringify([path, info.dev, info.ino, info.size, info.mtimeMs, info.ctimeMs])).digest("hex");
       const etag = `"${key}"`;
       c.header("ETag", etag);
       c.header("Cache-Control", "private, no-cache");
@@ -5270,7 +5270,7 @@ import {
   writeFileSync as writeFileSync4
 } from "fs";
 import { join as join11 } from "path";
-import { createHash as createHash4, randomUUID as randomUUID2 } from "crypto";
+import { createHash as createHash5, randomUUID as randomUUID2 } from "crypto";
 var THUMBNAIL_CACHE_VERSION = "v5";
 var THUMBNAIL_MAX_OUTPUT_WIDTH = 240;
 var THUMBNAIL_MAX_OUTPUT_HEIGHT = 135;
@@ -5344,7 +5344,7 @@ function readFileOnce(file) {
 function manifestKey(file) {
   const manifest = readFileOnce(file);
   if (typeof manifest === "string") return { key: "", mtimeMs: -Infinity };
-  const hash = createHash4("sha1").update(manifest.data).digest("hex").slice(0, 16);
+  const hash = createHash5("sha1").update(manifest.data).digest("hex").slice(0, 16);
   return { key: `_${hash}`, mtimeMs: Math.round(manifest.mtimeMs) };
 }
 function registerThumbnailRoutes(api, adapter) {
@@ -5381,7 +5381,7 @@ function registerThumbnailRoutes(api, adapter) {
     let sourceKey = "";
     if (source !== "missing") {
       const html = source.data.toString("utf-8");
-      sourceKey = `_${createHash4("sha1").update(html).digest("hex").slice(0, 16)}`;
+      sourceKey = `_${createHash5("sha1").update(html).digest("hex").slice(0, 16)}`;
       sourceMtime = Math.round(source.mtimeMs);
       if (!vpWidth) {
         const wMatch = html.match(/data-width=["'](\d+)["']/);
@@ -5397,9 +5397,9 @@ function registerThumbnailRoutes(api, adapter) {
     const previewPath = compPath === "index.html" ? `${projectUrl}/preview` : `${projectUrl}/preview/comp/${compPath.split("/").map(encodeURIComponent).join("/")}`;
     const previewUrl = `${previewPath}?${PREVIEW_CAPTURE_PARAM}=1`;
     const cacheDir = join11(project.dir, ".thumbnails");
-    const selectorKey = selector ? `_${createHash4("sha1").update(selector).digest("hex").slice(0, 16)}_${selectorIndex ?? 0}` : "";
+    const selectorKey = selector ? `_${createHash5("sha1").update(selector).digest("hex").slice(0, 16)}_${selectorIndex ?? 0}` : "";
     const urlVersionKey = urlVersion ? `_${urlVersion.replace(/[^a-zA-Z0-9_-]+/g, "_").slice(0, 32)}` : "";
-    const inputSignatureKey = `_${createHash4("sha1").update(inputSignature).digest("hex").slice(0, 16)}`;
+    const inputSignatureKey = `_${createHash5("sha1").update(inputSignature).digest("hex").slice(0, 16)}`;
     const outputScale = outputMode === "source" ? 1 : Math.min(1, THUMBNAIL_MAX_OUTPUT_WIDTH / compW, THUMBNAIL_MAX_OUTPUT_HEIGHT / compH);
     const outputWidth = Math.max(1, Math.round(compW * outputScale));
     const outputHeight = Math.max(1, Math.round(compH * outputScale));
@@ -5523,7 +5523,7 @@ import {
 } from "@hyperframes/core/atomic-file";
 
 // src/helpers/freezeFrame.ts
-import { createHash as createHash5, randomBytes } from "crypto";
+import { createHash as createHash6, randomBytes } from "crypto";
 import { ensureHfIds as ensureHfIds3 } from "@hyperframes/parsers/hf-ids";
 import { readMediaOffsetSeconds } from "@hyperframes/parsers/media-duration";
 import { resolveRateSpec, sourceTimeAt } from "@hyperframes/core/speed-ramp";
@@ -5565,7 +5565,7 @@ function freezeExtractArgs(src, mediaTime, output) {
 var randomStillToken = () => randomBytes(4).toString("hex");
 function freezeStillFileName(clipId, playhead, token = randomStillToken()) {
   const stem = clipId.replace(/[^A-Za-z0-9_-]/g, "_").slice(0, 48) || "clip";
-  const idHash = createHash5("sha256").update(clipId).digest("hex").slice(0, 10);
+  const idHash = createHash6("sha256").update(clipId).digest("hex").slice(0, 10);
   return `${stem}-${idHash}-${Math.round(playhead * 1e3)}-${token}.png`;
 }
 function readFreezeSource(html, target, playhead) {
@@ -6870,13 +6870,13 @@ function numericAttribute(element, name) {
 }
 
 // src/helpers/previewDocumentStore.ts
-import { createHash as createHash6 } from "crypto";
+import { createHash as createHash7 } from "crypto";
 import { readFileSync as readFileSync14, readdirSync as readdirSync5, rmSync as rmSync6 } from "fs";
 import { join as join17 } from "path";
 import { replaceFileAtomically as replaceFileAtomically4 } from "@hyperframes/core/atomic-file";
 function createPreviewDocumentStore(projectDir, salt) {
   const dir = join17(projectDir, ".hyperframes", "preview");
-  const fileFor = (key) => join17(dir, `${createHash6("sha256").update(`${salt}
+  const fileFor = (key) => join17(dir, `${createHash7("sha256").update(`${salt}
 ${key}`).digest("hex").slice(0, 32)}.html`);
   return {
     read(key) {
@@ -6997,6 +6997,7 @@ export {
   createBackgroundRemovalJob,
   createPreviewDocumentStore,
   createProjectSignature,
+  createProjectSignatureAsync,
   createStudioApi,
   createStudioManualEditsRenderBodyScript,
   createStudioMotionRenderBodyScript,
@@ -7013,6 +7014,7 @@ export {
   historyCache,
   identifyFileWrite,
   isSafePath,
+  isUncopiedMedia,
   listProjectHistories,
   onRestoredInPlace,
   openProjectHistory,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.8.220",
+  "version": "0.8.222",
   "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.220",
-    "@hyperframes/parsers": "0.8.220"
+    "@hyperframes/parsers": "0.8.222",
+    "@hyperframes/core": "0.8.222"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",