@hyperframes/studio-server 0.9.8 → 0.9.10

package/dist/{chunk-3GSVCYB4.js → chunk-Z6G2NBCQ.js}

@@ -523,13 +523,13 @@ function listProjectFiles(projectDir) {
     ctimeMs: entry.ctimeMs
   }));
 }
-function resolveProjectSignature(adapter, projectDir) {
-  return adapter.getProjectSignature?.(projectDir) ?? createProjectSignature(projectDir);
+async function resolveProjectSignature(adapter, projectDir) {
+  return await adapter.getProjectSignature?.(projectDir) ?? createProjectSignatureAsync(projectDir);
 }
 async function resolveProjectAndSignature(adapter, projectId) {
   const project = await adapter.resolveProject(projectId);
   if (!project) return null;
-  return { project, signature: resolveProjectSignature(adapter, project.dir) };
+  return { project, signature: await resolveProjectSignature(adapter, project.dir) };
 }
 function planSignature(dir, collected, excluding, signedAt) {
   const files = collected.filter(

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,5 +1,5 @@
 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-BnQDzKj1.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-Ds5TElPq.js';
 import './mediaCodecMap.js';
 import 'sharp';
 import '@hyperframes/parsers';

package/dist/history/index.js

@@ -24,7 +24,7 @@ import {
   recordRenderSuccess,
   registerRenderOutput,
   retainSnapshotOutput
-} from "../chunk-3GSVCYB4.js";
+} from "../chunk-Z6G2NBCQ.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 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';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-Ds5TElPq.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-Ds5TElPq.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, 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';

package/dist/index.js

@@ -71,7 +71,7 @@ import {
   retainSnapshotOutput,
   serveWhileOpen,
   settledFileTag
-} from "./chunk-3GSVCYB4.js";
+} from "./chunk-Z6G2NBCQ.js";
 import {
   clearElementScreenshotIsolation,
   getElementScreenshotClip
@@ -179,7 +179,7 @@ function registerProjectRoutes(api, adapter) {
   api.get("/projects/:id/signature", async (c) => {
     const project = await adapter.resolveProject(c.req.param("id"));
     if (!project) return c.json({ error: "not found" }, 404);
-    return c.json({ signature: resolveProjectSignature(adapter, project.dir) });
+    return c.json({ signature: await resolveProjectSignature(adapter, project.dir) });
   });
   api.get("/projects/:id", async (c) => {
     const project = await adapter.resolveProject(c.req.param("id"));
@@ -280,7 +280,7 @@ import {
   RUNTIME_BOOTSTRAP_ATTR,
   stripEmbeddedRuntimeScripts
 } from "@hyperframes/core/compiler";
-import { isFullHtmlDocument } from "@hyperframes/core/compiler/html-document";
+import { findStartTags as findStartTags2, isFullHtmlDocument } from "@hyperframes/core/compiler/html-document";
 import { gsapCdnDist } from "@hyperframes/core/gsap-cdn";
 
 // src/helpers/gsapCoreScript.ts
@@ -529,7 +529,7 @@ ${rewrittenContent}
 </html>`;
 }
 function hasBaseElement(html) {
-  return parseHTML(html).document.querySelector("base") !== null;
+  return findStartTags2(html, "base").length > 0;
 }
 
 // src/helpers/compositionInsertion.ts
@@ -801,7 +801,7 @@ function rootHashes(read) {
   const source = read(ROOT_COMPOSITION) ?? "";
   return { root: sha1(source), head: sha1(rootHeadContent(source)) };
 }
-function compositionInputSignature(projectDir, compPath, projectSignature) {
+async function compositionInputSignature(projectDir, compPath, projectSignature) {
   const key = `${projectDir}\0${compPath}`;
   const known = inputSignatures.get(key);
   if (known?.projectSignature === projectSignature) return known.inputSignature;
@@ -813,11 +813,12 @@ function compositionInputSignature(projectDir, compPath, projectSignature) {
   );
   let inputSignature;
   if (comp === ROOT_COMPOSITION) {
-    inputSignature = createProjectSignature(projectDir, excluded);
+    inputSignature = await createProjectSignatureAsync(projectDir, excluded);
   } else {
     const hashes = rootHashes(read);
     if (!rootMemos.has(projectDir)) rootMemos.set(projectDir, { ...hashes, affected: null });
-    inputSignature = `${createProjectSignature(projectDir, excluded.add(ROOT_COMPOSITION))}:${hashes.head}`;
+    const rest = await createProjectSignatureAsync(projectDir, excluded.add(ROOT_COMPOSITION));
+    inputSignature = `${rest}:${hashes.head}`;
   }
   inputSignatures.set(key, { projectSignature, inputSignature });
   return inputSignature;
@@ -3952,14 +3953,14 @@ import {
   normalizeGsapBaseUrl,
   normalizeGsapLocalRoot
 } from "@hyperframes/core/gsap-cdn";
-import { findStartTags as findStartTags4, injectTagsAtHeadStart as injectTagsAtHeadStart2 } from "@hyperframes/core/compiler/html-document";
+import { findStartTags as findStartTags5, injectTagsAtHeadStart as injectTagsAtHeadStart2 } from "@hyperframes/core/compiler/html-document";
 import { isWithinProjectRoot } from "@hyperframes/parsers/asset-resolution";
 
 // src/helpers/rootImportMap.ts
-import { findStartTags as findStartTags2, injectTagsAtHeadStart } from "@hyperframes/core/compiler/html-document";
+import { findStartTags as findStartTags3, injectTagsAtHeadStart } from "@hyperframes/core/compiler/html-document";
 var IMPORT_MAP_TYPE = /\btype\s*=\s*["']?importmap["']?(?=[\s/>])/i;
 function findImportMap(html) {
-  for (const at of findStartTags2(html, "script")) {
+  for (const at of findStartTags3(html, "script")) {
     const open2 = /^<script\b[^>]*>/i.exec(html.slice(at));
     if (!open2 || !IMPORT_MAP_TYPE.test(open2[0])) continue;
     const start = at + open2[0].length;
@@ -4129,7 +4130,7 @@ function injectPreviewVariables(html, values) {
 }
 
 // src/helpers/lazyPreviewImages.ts
-import { findStartTags as findStartTags3 } from "@hyperframes/core/compiler/html-document";
+import { findStartTags as findStartTags4 } from "@hyperframes/core/compiler/html-document";
 import { parseHTML as parseHTML6 } from "linkedom";
 import { STUDIO_PREVIEW_LAZY_ATTR } from "@hyperframes/core/studio-preview-mark";
 function startsAfterZero(el) {
@@ -4141,8 +4142,9 @@ function startsAfterZero(el) {
 var hasLoading = (img) => Array.from(img.attributes).some((attr) => attr.name.toLowerCase() === "loading");
 function lazyPreviewImages(html) {
   if (!/<!doctype|<html[\s>]/i.test(html)) return html;
+  const tags = findStartTags4(html, "img");
+  if (tags.length === 0) return html;
   const images = [...parseHTML6(html).document.querySelectorAll("img")];
-  const tags = findStartTags3(html, "img");
   if (tags.length !== images.length) return html;
   const parts = [];
   let from = 0;
@@ -4228,7 +4230,7 @@ function injectMotionPathPluginIfNeeded(html, baseUrl) {
 }
 function findGsapCoreScript(html) {
   const scripts = [...parseHTML7(html).document.querySelectorAll("script")];
-  const starts = findStartTags4(html, "script");
+  const starts = findStartTags5(html, "script");
   if (starts.length !== scripts.length) return null;
   const at = scripts.findIndex(
     (script) => isGsapCoreUrl(lowerCaseAttributes(script).get("src") ?? "")
@@ -4339,7 +4341,7 @@ addEventListener("error",function(e){seen.push(e.message||String(e));
 var name=e.error&&e.error.constructor&&e.error.constructor.name,path="";
 try{var url=e.filename&&new URL(e.filename,window.location.href);if(url&&url.origin===window.location.origin)path=url.pathname}catch(_){}
 kinds.push({name:known[name]===1?name:"other",origin:!path?"unknown":path===runtime?"runtime":path.indexOf("/api/projects/")===0?"project":"studio"})});})();</script>`;
-function injectStudioPreviewAugmentations(html, adapter, projectDir, activeCompositionPath, options) {
+function injectStudioPreviewAugmentations(html, adapter, signature, projectDir, activeCompositionPath, options) {
   const marked = options.capture ? injectTagsAtHeadStart2(
     html,
     `<meta name="${STUDIO_PREVIEW_MARK_META}" content="${STUDIO_PREVIEW_CAPTURE_MODE}">`
@@ -4353,7 +4355,7 @@ function injectStudioPreviewAugmentations(html, adapter, projectDir, activeCompo
         marked,
         `<meta name="${GSAP_BASE_URL_META}" content="${escapeGsapUrl(options.gsapBaseUrl)}">`
       ),
-      resolveProjectSignature(adapter, projectDir)
+      signature
     ),
     options.gsapBaseUrl
   );
@@ -4458,6 +4460,7 @@ function registerPreviewRoutes(api, adapter) {
       bundled = injectStudioPreviewAugmentations(
         ensureHfIds2(await transformPreviewHtml(bundled, adapter, project, mainCompositionPath)),
         adapter,
+        signature,
         project.dir,
         mainCompositionPath,
         { capture, gsapBaseUrl }
@@ -4471,7 +4474,7 @@ function registerPreviewRoutes(api, adapter) {
         mediaCodecProbeCache
       );
       bundled = addScenePartsManifest(bundled, [`meta[name="${PROJECT_SIGNATURE_META}"]`]);
-      if (createProjectSignature(project.dir) === signature) {
+      if (await createProjectSignatureAsync(project.dir) === signature) {
         rememberPreview(builtKey, bundled);
         if (!capture) adapter.previewDocuments?.write(builtKey, bundled);
       }
@@ -4486,6 +4489,7 @@ function registerPreviewRoutes(api, adapter) {
         let fallbackAugmented = injectStudioPreviewAugmentations(
           await transformPreviewHtml(fallbackHtml, adapter, project, fallback.compositionPath),
           adapter,
+          signature,
           project.dir,
           fallback.compositionPath,
           { capture, gsapBaseUrl }
@@ -4586,7 +4590,7 @@ ${etag}`;
     html = withRootImportMap(html, baseHref);
     recordPreviewReferences(project.dir, html);
     html = ensureHfIds2(await transformPreviewHtml(html, adapter, project, compPath));
-    html = injectStudioPreviewAugmentations(html, adapter, project.dir, compPath, {
+    html = injectStudioPreviewAugmentations(html, adapter, signature, project.dir, compPath, {
       capture,
       gsapBaseUrl
     });
@@ -4804,6 +4808,19 @@ import { dirname as dirname5, join as join10 } from "path";
 import { Readable as Readable2 } from "stream";
 import { VALID_CANVAS_RESOLUTIONS } from "@hyperframes/parsers";
 import { formatRenderOutputTimestamp, parseFps, fpsToNumber } from "@hyperframes/core";
+
+// src/helpers/finishedJobs.ts
+var firstSeenFinishedAt = /* @__PURE__ */ new WeakMap();
+function forgetJobsFinishedLongerThan(ttlMs, jobs, isFinished, now = Date.now()) {
+  for (const [id, job] of jobs) {
+    if (!isFinished(job)) continue;
+    const finishedAt = firstSeenFinishedAt.get(job) ?? now;
+    firstSeenFinishedAt.set(job, finishedAt);
+    if (now - finishedAt > ttlMs) jobs.delete(id);
+  }
+}
+
+// src/routes/render.ts
 var VALID_RESOLUTIONS = new Set(VALID_CANVAS_RESOLUTIONS);
 var RENDER_MIME = {
   ".mp4": "video/mp4",
@@ -4843,12 +4860,7 @@ function registerRenderRoutes(api, adapter) {
   let cleanupTimer = null;
   const cleanupEnabled = () => typeof process !== "undefined" && process.env.NODE_ENV !== "production" && !process.argv.includes("build");
   const cleanupFinishedJobs = () => {
-    const now = Date.now();
-    for (const [key, job] of renderJobs) {
-      if (job.status !== "rendering" && now - job.createdAt > TTL_MS) {
-        renderJobs.delete(key);
-      }
-    }
+    forgetJobsFinishedLongerThan(TTL_MS, renderJobs, (job) => job.status !== "rendering");
     if (renderJobs.size === 0 && cleanupTimer) {
       clearInterval(cleanupTimer);
       cleanupTimer = null;
@@ -4926,7 +4938,6 @@ function registerRenderRoutes(api, adapter) {
       telemetryOptOut: body.telemetryOptOut === true,
       ...pageMotionBlur === void 0 ? {} : { pageMotionBlur }
     });
-    jobState.createdAt = Date.now();
     renderJobs.set(jobId, jobState);
     ensureCleanupTimer();
     return c.json({ jobId, status: "rendering" });
@@ -5076,8 +5087,7 @@ function registerRenderRoutes(api, adapter) {
           id: file.id,
           status: file.status,
           progress: 100,
-          outputPath: file.path,
-          createdAt: file.createdAt
+          outputPath: file.path
         });
       }
     }
@@ -5396,7 +5406,7 @@ function registerThumbnailRoutes(api, adapter) {
     const htmlFile = resolveWithinProject(project.dir, compPath);
     const source = htmlFile ? readFileOnce(htmlFile) : "not-a-file";
     if (source === "not-a-file") return c.json({ error: "not found" }, 404);
-    const inputSignature = compositionInputSignature(project.dir, compPath, projectSignature);
+    const inputSignature = await compositionInputSignature(project.dir, compPath, projectSignature);
     const url = new URL(c.req.url, `http://${c.req.header("host") || "localhost"}`);
     const rawSeekTime = url.searchParams.get("t");
     const parsedSeekTime = rawSeekTime == null ? Number.NaN : parseFloat(rawSeekTime);
@@ -5479,8 +5489,8 @@ function registerThumbnailRoutes(api, adapter) {
           if (!generated) return null;
           const previewCopiesAtEnd = proxyActivityMark(project.dir);
           const afterGeneration = await resolveProjectAndSignature(adapter, project.id);
-          const inputsUnchanged = (signature) => compositionInputSignature(project.dir, compPath, signature) === inputSignature;
-          if (previewCopiesAtStart === null || previewCopiesAtEnd !== previewCopiesAtStart || afterGeneration?.project.dir !== project.dir || !inputsUnchanged(afterGeneration.signature) || !inputsUnchanged(createProjectSignature(project.dir))) {
+          const inputsUnchanged = async (signature) => await compositionInputSignature(project.dir, compPath, signature) === inputSignature;
+          if (previewCopiesAtStart === null || previewCopiesAtEnd !== previewCopiesAtStart || afterGeneration?.project.dir !== project.dir || !await inputsUnchanged(afterGeneration.signature) || !await inputsUnchanged(await createProjectSignatureAsync(project.dir))) {
             return generated;
           }
           mkdirWithinProject(project.dir, cacheDir);
@@ -6419,12 +6429,11 @@ function registerMediaRoutes(api, adapter, options = {}) {
   const TTL_MS = 3e5;
   const readMediaMetadata = options.probeMediaMetadata ?? probeMediaMetadata;
   function cleanupFinishedJobs() {
-    const now = Date.now();
-    for (const [id, job] of mediaJobs) {
-      if ((job.status === "complete" || job.status === "failed") && now - job.createdAt > TTL_MS) {
-        mediaJobs.delete(id);
-      }
-    }
+    forgetJobsFinishedLongerThan(
+      TTL_MS,
+      mediaJobs,
+      (job) => job.status === "complete" || job.status === "failed"
+    );
   }
   api.get("/projects/:id/media/metadata", async (c) => {
     const project = await adapter.resolveProject(c.req.param("id"));
@@ -6510,7 +6519,6 @@ function registerMediaRoutes(api, adapter, options = {}) {
         device: normalizeDevice(body.device),
         jobId
       });
-      state.createdAt = Date.now();
       mediaJobs.set(jobId, state);
       return c.json({
         jobId,

package/dist/{mediaProxyPreview-BnQDzKj1.d.ts → mediaProxyPreview-Ds5TElPq.d.ts}

@@ -118,7 +118,7 @@ interface StudioApiAdapter {
     /** Bundle a project directory into a single HTML string, forwarding `options` over the host's own. */
     bundle(projectDir: string, options?: Pick<BundleOptions, "stampHfIds" | "onRead">): Promise<string | null>;
     /** Optional: a cached `createProjectSignature(dir)`; preview caching checks builds against it. */
-    getProjectSignature?: (projectDir: string) => string;
+    getProjectSignature?: (projectDir: string) => string | Promise<string>;
     invalidateProjectSignature?: (projectDir: string) => void;
     loadSharp?: () => Promise<typeof sharp.default>;
     /** Lint a single HTML string. */

package/package.json

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