@hyperframes/studio-server 0.8.76 → 0.8.78

package/dist/{chunk-5PGWTBCL.js → chunk-X3T65KC2.js}

@@ -12,6 +12,7 @@ import {
 
 // src/helpers/mediaProxyPreview.ts
 import { resolve } from "path";
+import { insertBeforeCloseTag } from "@hyperframes/core/compiler/html-document";
 function isAutoProxyEnabled(adapter) {
   return adapter.autoProxy !== false;
 }
@@ -22,12 +23,6 @@ function proxyEtagSalt(raw) {
   if (raw === void 0) return "";
   return `:proxy:${raw}:${PROXY_PARAMS_VERSION}`;
 }
-function injectScriptTagIntoHead(html, scriptTag) {
-  if (html.includes("</head>")) return html.replace("</head>", `${scriptTag}
-</head>`);
-  return `${scriptTag}
-${html}`;
-}
 async function injectMediaCodecMapIntoHtml(html, projectDir, htmlSources, probeCache) {
   let map;
   try {
@@ -52,7 +47,9 @@ async function injectMediaCodecMapIntoHtml(html, projectDir, htmlSources, probeC
   }
   const json = JSON.stringify(map).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
   const tag = `<script data-hf-media-codec-map>window.__HF_MEDIA_CODEC_MAP__=${json};</script>`;
-  return injectScriptTagIntoHead(html, tag);
+  return insertBeforeCloseTag(html, "head", `${tag}
+`) ?? `${tag}
+${html}`;
 }
 async function injectMediaCodecMap(html, adapter, projectDir, compSrcPath, probeCache) {
   if (!isAutoProxyEnabled(adapter)) return html;
@@ -66,4 +63,4 @@ export {
   injectMediaCodecMapIntoHtml,
   injectMediaCodecMap
 };
-//# sourceMappingURL=chunk-5PGWTBCL.js.map
+//# sourceMappingURL=chunk-X3T65KC2.js.map

package/dist/chunk-X3T65KC2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/helpers/mediaProxyPreview.ts"],"sourcesContent":["import { resolve } from \"node:path\";\nimport { insertBeforeCloseTag } from \"@hyperframes/core/compiler/html-document\";\nimport type { StudioApiAdapter } from \"../types.js\";\nimport {\n  createMediaCodecProbeCache,\n  proxyVariantFor,\n  recordProxyPrewarm,\n  scanProjectMediaCodecMap,\n  shouldPrewarmProxy,\n  type HtmlSourceLike,\n  type MediaCodecMap,\n  type MediaCodecProbeCache,\n} from \"./mediaCodecMap.js\";\nimport { resolveProxy, PROXY_PARAMS_VERSION } from \"./proxyTranscoder.js\";\n\n/**\n * Transparent-media-proxy wiring shared by `routes/preview.ts`\n * (docs/plans/2026-07-14-002-feat-transparent-media-proxies-plan.md, unit U3).\n * Split out of the route module to keep it under the repo's 600-line file cap.\n */\n\n/**\n * Preview-route-local adapter surface for the auto-proxy feature. Both\n * fields are optional so any existing `StudioApiAdapter` value remains\n * structurally assignable without editing the shared interface:\n * `autoProxy` defaults to true (on) when omitted — a later unit wires the\n * CLI `--no-proxy` flag / `hyperframes.json` setting through it;\n * `mediaCodecProbeCache` lets a host share one probe cache across\n * preview/play/static-server surfaces instead of each constructing its own.\n */\nexport type PreviewApiAdapter = StudioApiAdapter & {\n  autoProxy?: boolean;\n  mediaCodecProbeCache?: MediaCodecProbeCache;\n  /** Keeps built preview documents across restarts, keyed by project id and preview ETag. */\n  previewDocuments?: PreviewDocumentStore;\n};\n\nexport interface PreviewDocumentStore {\n  read(key: string): string | null;\n  write(key: string, html: string): void;\n}\n\nexport function isAutoProxyEnabled(adapter: PreviewApiAdapter): boolean {\n  return adapter.autoProxy !== false;\n}\n\n/** One probe cache per server instance — construct once in `registerPreviewRoutes`\n * and reuse across every request so the mtime-cache benefit in\n * `scanProjectMediaCodecMap` actually applies. A host that wants to share the\n * cache across other surfaces (play, static project server) can pass its own\n * via `adapter.mediaCodecProbeCache`. */\nexport function resolvePreviewMediaCodecProbeCache(\n  adapter: PreviewApiAdapter,\n): MediaCodecProbeCache {\n  return adapter.mediaCodecProbeCache ?? createMediaCodecProbeCache();\n}\n\n/**\n * ETag salt for `?hf-proxy=` asset requests, mirroring `variablesEtagSalt` in\n * preview.ts: salted by the raw param value plus the transcoder's params\n * version, so a future proxy-recipe change (which bumps `PROXY_PARAMS_VERSION`)\n * or a different proxy variant invalidates cached 304s without needing to\n * touch the proxy file itself.\n */\nexport function proxyEtagSalt(raw: string | undefined): string {\n  if (raw === undefined) return \"\";\n  return `:proxy:${raw}:${PROXY_PARAMS_VERSION}`;\n}\n\n/**\n * Injects `window.__HF_MEDIA_CODEC_MAP__` (the U1 codec-facts scan) into\n * served composition HTML, and fire-and-forget pre-warms `resolveProxy` for\n * every entry whose codec no browser decodes, so an element's proactive swap\n * usually hits a warm cache (KTD: protects the per-origin connection budget\n * under held responses). Conditionally hostile codecs are injected but NOT\n * pre-warmed: the requesting browser usually plays them, and the transcode\n * runs concurrently with its first layout. No second concurrency limiter here\n * — the transcoder's own global bound throttles both pre-warm and\n * element-triggered calls. Pre-warm failures are swallowed; an actual\n * `?hf-proxy=` request surfaces them as a 502 and transcodes lazily.\n * Alpha-bearing entries pre-warm their VP8/WebM variant.\n *\n * The single shared implementation for every auto-proxy surface — the studio\n * preview route (via `injectMediaCodecMap` below) and the CLI's composition /\n * static project servers (via the `./media-proxy-preview` subpath export).\n * Empty maps leave HTML untouched, preserving the normal no-hostile-media\n * preview path. On-demand proxy requests enforce the same eligibility gate.\n */\nexport async function injectMediaCodecMapIntoHtml(\n  html: string,\n  projectDir: string,\n  htmlSources: HtmlSourceLike[],\n  probeCache?: MediaCodecProbeCache,\n): Promise<string> {\n  let map: MediaCodecMap;\n  try {\n    map = await scanProjectMediaCodecMap(\n      projectDir,\n      htmlSources,\n      probeCache ? { cache: probeCache } : {},\n    );\n  } catch {\n    // Best-effort: a scan failure must never block serving the page.\n    return html;\n  }\n  if (Object.keys(map).length === 0) return html;\n  for (const [rootRelativePathname, facts] of Object.entries(map)) {\n    if (!shouldPrewarmProxy(facts)) continue;\n    recordProxyPrewarm();\n    resolveProxy(\n      projectDir,\n      resolve(projectDir, rootRelativePathname.replace(/^\\/+/, \"\")),\n      proxyVariantFor(facts),\n    ).catch(() => {\n      // Swallowed: the pre-warm is best-effort. A real `?hf-proxy=` request\n      // for this asset re-attempts the transcode and reports failure (502).\n    });\n  }\n  // <-escape prevents a src path containing \"</script>\" from breaking out of\n  // the injected tag, mirroring injectPreviewVariables in helpers/previewVariables.ts.\n  const json = JSON.stringify(map)\n    .replace(/</g, \"\\\\u003c\")\n    .replace(/\\u2028/g, \"\\\\u2028\")\n    .replace(/\\u2029/g, \"\\\\u2029\");\n  const tag = `<script data-hf-media-codec-map>window.__HF_MEDIA_CODEC_MAP__=${json};</script>`;\n  return insertBeforeCloseTag(html, \"head\", `${tag}\\n`) ?? `${tag}\\n${html}`;\n}\n\n/**\n * Adapter-aware wrapper used by the studio preview routes: skipped entirely\n * (no scan, no injection) when auto-proxy is off for this adapter.\n */\nexport async function injectMediaCodecMap(\n  html: string,\n  adapter: PreviewApiAdapter,\n  projectDir: string,\n  compSrcPath: string,\n  probeCache: MediaCodecProbeCache,\n): Promise<string> {\n  if (!isAutoProxyEnabled(adapter)) return html;\n  return injectMediaCodecMapIntoHtml(html, projectDir, [{ html, compSrcPath }], probeCache);\n}\n"],"mappings":";;;;;;;;;;;;;AAAA,SAAS,eAAe;AACxB,SAAS,4BAA4B;AAyC9B,SAAS,mBAAmB,SAAqC;AACtE,SAAO,QAAQ,cAAc;AAC/B;AAOO,SAAS,mCACd,SACsB;AACtB,SAAO,QAAQ,wBAAwB,2BAA2B;AACpE;AASO,SAAS,cAAc,KAAiC;AAC7D,MAAI,QAAQ,OAAW,QAAO;AAC9B,SAAO,UAAU,GAAG,IAAI,oBAAoB;AAC9C;AAqBA,eAAsB,4BACpB,MACA,YACA,aACA,YACiB;AACjB,MAAI;AACJ,MAAI;AACF,UAAM,MAAM;AAAA,MACV;AAAA,MACA;AAAA,MACA,aAAa,EAAE,OAAO,WAAW,IAAI,CAAC;AAAA,IACxC;AAAA,EACF,QAAQ;AAEN,WAAO;AAAA,EACT;AACA,MAAI,OAAO,KAAK,GAAG,EAAE,WAAW,EAAG,QAAO;AAC1C,aAAW,CAAC,sBAAsB,KAAK,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC/D,QAAI,CAAC,mBAAmB,KAAK,EAAG;AAChC,uBAAmB;AACnB;AAAA,MACE;AAAA,MACA,QAAQ,YAAY,qBAAqB,QAAQ,QAAQ,EAAE,CAAC;AAAA,MAC5D,gBAAgB,KAAK;AAAA,IACvB,EAAE,MAAM,MAAM;AAAA,IAGd,CAAC;AAAA,EACH;AAGA,QAAM,OAAO,KAAK,UAAU,GAAG,EAC5B,QAAQ,MAAM,SAAS,EACvB,QAAQ,WAAW,SAAS,EAC5B,QAAQ,WAAW,SAAS;AAC/B,QAAM,MAAM,iEAAiE,IAAI;AACjF,SAAO,qBAAqB,MAAM,QAAQ,GAAG,GAAG;AAAA,CAAI,KAAK,GAAG,GAAG;AAAA,EAAK,IAAI;AAC1E;AAMA,eAAsB,oBACpB,MACA,SACA,YACA,aACA,YACiB;AACjB,MAAI,CAAC,mBAAmB,OAAO,EAAG,QAAO;AACzC,SAAO,4BAA4B,MAAM,YAAY,CAAC,EAAE,MAAM,YAAY,CAAC,GAAG,UAAU;AAC1F;","names":[]}

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,4 +1,4 @@
-export { g as PreviewApiAdapter, P as PreviewDocumentStore, n as injectMediaCodecMap, p as injectMediaCodecMapIntoHtml, q as isAutoProxyEnabled, r as proxyEtagSalt, s as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-DZD3iu_2.js';
+export { h as PreviewApiAdapter, P as PreviewDocumentStore, p as injectMediaCodecMap, q as injectMediaCodecMapIntoHtml, r as isAutoProxyEnabled, s as proxyEtagSalt, t as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-BmJ8AmLd.js';
 import './mediaCodecMap.js';
 import '@hyperframes/core';
 import '@hyperframes/parsers';

package/dist/helpers/mediaProxyPreview.js

@@ -4,7 +4,7 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-5PGWTBCL.js";
+} from "../chunk-X3T65KC2.js";
 import "../chunk-45POWYFS.js";
 import "../chunk-4MNTZVVZ.js";
 export {

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-DZD3iu_2.js';
-export { D as DEFAULT_HISTORY_ROOT, a as HISTORY_START, H as HistoryEntry, b as HistoryFileChange, c as HistoryListItem, d as HistoryResult, e as HistoryWho, f as HistoryWindow, L as LintResult, g as PreviewApiAdapter, h as ProjectHistory, i as ProjectHistoryOptions, R as RenderJobState, j as ResolvedProject, k as StudioSelectionResponse, l as StudioSelectionSnapshot, m as StudioSelectionTextField, o as openProjectHistory } from './mediaProxyPreview-DZD3iu_2.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-BmJ8AmLd.js';
+export { C as ClosedWindow, D as DEFAULT_HISTORY_ROOT, a as HISTORY_START, H as HistoryEntry, b as HistoryFileChange, c as HistoryListItem, d as HistoryResult, e as HistoryWho, f as HistoryWindow, L as LintResult, g as MAX_WINDOW_IDLE_MS, h as PreviewApiAdapter, i as ProjectHistory, j as ProjectHistoryOptions, R as RenderJobState, k as ResolvedProject, l as StudioSelectionResponse, m as StudioSelectionSnapshot, n as StudioSelectionTextField, o as openProjectHistory } from './mediaProxyPreview-BmJ8AmLd.js';
 import { SourceMutationTarget } from './helpers/sourceMutation.js';
 export { PatchOperation, dedupeClonedCompositionId, findTargetElement, parseSourceDocument, patchElementInHtml, removeElementFromHtml, splitElementInHtml } from './helpers/sourceMutation.js';
 export { ScreenshotClip, getElementScreenshotClip } from './helpers/screenshotClip.js';
@@ -52,7 +52,13 @@ declare function createProjectSignature(projectDir: string, excluding?: Readonly
  */
 declare function compositionsAffectedBy(projectDir: string, changedPath: string): string[] | null;
 
-/** Recursively walk a directory and return relative file paths. */
+declare class HistoryBusyError extends Error {
+    readonly pid: number;
+    constructor(pid: number);
+}
+
+/** Recursively walk a directory and return relative file paths. A subfolder that is unreadable
+ * or removed mid-walk is skipped; any other failure, or an unreadable `dir` itself, throws. */
 declare function walkDir(dir: string, prefix?: string): string[];
 
 /** Pins hf-ids into every composition in the project. A host runs it once before it serves or
@@ -199,4 +205,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, MIME_TYPES, MediaProcessingJobState, PREVIEW_BUNDLE_OPTIONS, SourceMutationTarget, StudioApiAdapter, type ThumbnailOutputDimensions, affectsProjectSignature, applyFileMutations, buildSubCompositionHtml, compositionsAffectedBy, consumeFileWriteReceipt, createBackgroundRemovalJob, createPreviewDocumentStore, createProjectSignature, createStudioApi, duplicateElementInHtml, fileContentVersion, getMimeType, identifyFileWrite, requestSubPath, settledFileTag, stampProjectHfIds, thumbnailDeviceScaleFactor, walkDir };
+export { type AppliedFileMutation, type BackgroundRemovalRender, DELETED_VERSION, type DuplicateElementResult, type FileMutationInput, type FileWriteReceipt, HistoryBusyError, MIME_TYPES, MediaProcessingJobState, PREVIEW_BUNDLE_OPTIONS, SourceMutationTarget, StudioApiAdapter, type ThumbnailOutputDimensions, affectsProjectSignature, applyFileMutations, buildSubCompositionHtml, compositionsAffectedBy, consumeFileWriteReceipt, createBackgroundRemovalJob, createPreviewDocumentStore, createProjectSignature, createStudioApi, duplicateElementInHtml, fileContentVersion, getMimeType, identifyFileWrite, requestSubPath, settledFileTag, stampProjectHfIds, thumbnailDeviceScaleFactor, walkDir };