@hyperframes/studio-server 0.8.83 → 0.8.84

package/dist/helpers/hfIdPersist.d.ts

@@ -0,0 +1,23 @@
+declare const isCompositionSource: (html: string) => boolean;
+/** Pins hf-ids into every composition in the project. A host runs it once before it serves or
+ * watches the project: an id write during a session reaches Studio as an outside edit and reloads it.
+ * A file whose content hash matches the last run's (kept in `.hyperframes`) is not parsed again. */
+declare function stampProjectHfIds(projectDir: string): void;
+/**
+ * Read `filePath`, mint any missing `data-hf-id`s, write the stamped content
+ * back if new ids were added, and return the stamped content. Every open of the path is
+ * no-follow (POSIX) and the write renames a sibling temp file over it, so a symlink swapped
+ * in at the path is never read or written through (CodeQL js/file-system-race).
+ *
+ * Falls back to read-only stamping when the file isn't writable (read-only
+ * fs, sandbox) — serving stamped content without persisting is still correct;
+ * ids are content-keyed so the SDK mints the same ones from the same bytes.
+ *
+ * Returns null when the file is missing, unreadable, or not a regular file.
+ *
+ * A write that lands while ids are minted is kept: the file is replaced only if
+ * it still holds the bytes that were stamped, else it is left for the next open or save.
+ */
+declare function stampFileHfIds(filePath: string): string | null;
+
+export { isCompositionSource, stampFileHfIds, stampProjectHfIds };

package/dist/helpers/hfIdPersist.js

@@ -0,0 +1,13 @@
+import {
+  isCompositionSource,
+  stampFileHfIds,
+  stampProjectHfIds
+} from "../chunk-WUHW3MWG.js";
+import "../chunk-PMXUKOC3.js";
+import "../chunk-TTWLTYSQ.js";
+export {
+  isCompositionSource,
+  stampFileHfIds,
+  stampProjectHfIds
+};
+//# sourceMappingURL=hfIdPersist.js.map

package/dist/helpers/hfIdPersist.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/helpers/mediaCodecMap.js

@@ -13,7 +13,8 @@ import {
   resolveProxyVariantRequest,
   scanProjectMediaCodecMap,
   shouldPrewarmProxy
-} from "../chunk-WQ2WF2YJ.js";
+} from "../chunk-I3DRHG52.js";
+import "../chunk-TTWLTYSQ.js";
 export {
   BROWSER_HOSTILE_CODECS,
   PROXY_VARIANT_CONFIG,

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,5 +1,6 @@
-export { k as PreviewApiAdapter, a as PreviewDocumentStore, s as injectMediaCodecMap, t as injectMediaCodecMapIntoHtml, u as isAutoProxyEnabled, v as proxyEtagSalt, w as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-BMHd9G3N.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-CLu9FdIr.js';
 import './mediaCodecMap.js';
 import '@hyperframes/core';
 import '@hyperframes/parsers';
 import '@hyperframes/core/compiler';
+import '../projectHistory-Cm8Mdmmv.js';

package/dist/helpers/mediaProxyPreview.js

@@ -4,9 +4,10 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-HWBORC2U.js";
-import "../chunk-EL3UQI46.js";
-import "../chunk-WQ2WF2YJ.js";
+} from "../chunk-YUPEBATT.js";
+import "../chunk-2YEGCDJW.js";
+import "../chunk-I3DRHG52.js";
+import "../chunk-TTWLTYSQ.js";
 export {
   injectMediaCodecMap,
   injectMediaCodecMapIntoHtml,

package/dist/helpers/proxyTranscoder.d.ts

@@ -18,6 +18,7 @@ import { ProxyVariant } from './mediaCodecMap.js';
  */
 declare const PROXY_PARAMS_VERSION = "v5";
 declare const TRANSCODE_TIMEOUT_MS: number;
+declare const PROXY_PENDING_RETRY_AFTER_SECONDS = 2;
 declare const DEFAULT_PROXY_WAIT_TIMEOUT_MS: number;
 declare class ProxyTranscodeError extends Error {
     readonly exitCode: number | null;
@@ -48,6 +49,8 @@ declare function getProxyCachePath(projectDir: string, absoluteSourcePath: strin
 /** Test hook: forget remembered transcode failures (module state persists
  * across tests that don't reload the module). */
 declare function clearFailedTranscodesForTest(): void;
+/** Null while a copy for this project is being made; otherwise a mark that moves when any copy finishes. */
+declare function proxyActivityMark(projectDir: string): string | null;
 /**
  * Resolves the cached proxy variant for `absoluteSourcePath`, transcoding it at
  * most once per cache key. Concurrent calls for the same key (including a
@@ -58,4 +61,4 @@ declare function clearFailedTranscodesForTest(): void;
  */
 declare function resolveProxy(projectDir: string, absoluteSourcePath: string, variant?: ProxyVariant): Promise<string>;
 
-export { DEFAULT_PROXY_WAIT_TIMEOUT_MS, FfmpegMissingFilterError, PROXY_PARAMS_VERSION, ProxyCapacityError, ProxySourceOutsideProjectError, ProxyTranscodeError, ProxyWaitTimeoutError, TRANSCODE_TIMEOUT_MS, clearFailedTranscodesForTest, getProxyCachePath, resolveProxy, waitForProxy };
+export { DEFAULT_PROXY_WAIT_TIMEOUT_MS, FfmpegMissingFilterError, PROXY_PARAMS_VERSION, PROXY_PENDING_RETRY_AFTER_SECONDS, ProxyCapacityError, ProxySourceOutsideProjectError, ProxyTranscodeError, ProxyWaitTimeoutError, TRANSCODE_TIMEOUT_MS, clearFailedTranscodesForTest, getProxyCachePath, proxyActivityMark, resolveProxy, waitForProxy };

package/dist/helpers/proxyTranscoder.js

@@ -2,6 +2,7 @@ import {
   DEFAULT_PROXY_WAIT_TIMEOUT_MS,
   FfmpegMissingFilterError,
   PROXY_PARAMS_VERSION,
+  PROXY_PENDING_RETRY_AFTER_SECONDS,
   ProxyCapacityError,
   ProxySourceOutsideProjectError,
   ProxyTranscodeError,
@@ -9,14 +10,17 @@ import {
   TRANSCODE_TIMEOUT_MS,
   clearFailedTranscodesForTest,
   getProxyCachePath,
+  proxyActivityMark,
   resolveProxy,
   waitForProxy
-} from "../chunk-EL3UQI46.js";
-import "../chunk-WQ2WF2YJ.js";
+} from "../chunk-2YEGCDJW.js";
+import "../chunk-I3DRHG52.js";
+import "../chunk-TTWLTYSQ.js";
 export {
   DEFAULT_PROXY_WAIT_TIMEOUT_MS,
   FfmpegMissingFilterError,
   PROXY_PARAMS_VERSION,
+  PROXY_PENDING_RETRY_AFTER_SECONDS,
   ProxyCapacityError,
   ProxySourceOutsideProjectError,
   ProxyTranscodeError,
@@ -24,6 +28,7 @@ export {
   TRANSCODE_TIMEOUT_MS,
   clearFailedTranscodesForTest,
   getProxyCachePath,
+  proxyActivityMark,
   resolveProxy,
   waitForProxy
 };

package/dist/helpers/safePath.d.ts

@@ -0,0 +1,22 @@
+export { folderGone, isProjectRootMissing, isSafePath, mkdirWithinProject, realProjectRoot, realpath, resolveWithinProject } from '@hyperframes/core/safe-path';
+
+/** The real path; for a path not there (yet, or any more), the nearest existing folder's real path plus the rest. */
+declare function realFilePath(filePath: string): string;
+/**
+ * `resolveWithinProject` with every link inside the project resolved now, so a write to the result lands on the
+ * file checked here even if a link on the way is retargeted before the write.
+ */
+declare function pinWithinProject(base: string, relativePath: string): string | null;
+/**
+ * True when any directory segment of a relative path is a dot-directory or
+ * node_modules. Projects that vendor tooling assets under dot-directories
+ * (.hyperframes/, .cache/, …) ship example/preset HTML that must not surface
+ * as project compositions or studio lint targets (#1384). The file tree is
+ * deliberately not filtered — this only gates discovery.
+ */
+declare function isInHiddenOrVendorDir(relPath: string): boolean;
+/** 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[];
+
+export { isInHiddenOrVendorDir, pinWithinProject, realFilePath, walkDir };

package/dist/helpers/safePath.js

@@ -0,0 +1,27 @@
+import {
+  folderGone,
+  isInHiddenOrVendorDir,
+  isProjectRootMissing,
+  isSafePath,
+  mkdirWithinProject,
+  pinWithinProject,
+  realFilePath,
+  realProjectRoot,
+  realpath,
+  resolveWithinProject,
+  walkDir
+} from "../chunk-TTWLTYSQ.js";
+export {
+  folderGone,
+  isInHiddenOrVendorDir,
+  isProjectRootMissing,
+  isSafePath,
+  mkdirWithinProject,
+  pinWithinProject,
+  realFilePath,
+  realProjectRoot,
+  realpath,
+  resolveWithinProject,
+  walkDir
+};
+//# sourceMappingURL=safePath.js.map

package/dist/helpers/safePath.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/history/index.d.ts

@@ -0,0 +1,49 @@
+import { P as ProjectHistory } from '../projectHistory-Cm8Mdmmv.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 HistoryWho, g as HistoryWindow, M as MAX_WINDOW_IDLE_MS, h as ProjectHistoryOptions, U as UNDO_MODES, i as UndoMode, o as openProjectHistory } from '../projectHistory-Cm8Mdmmv.js';
+
+declare class HistoryBusyError extends Error {
+    readonly pid: number;
+    constructor(pid: number);
+}
+
+declare class HistoryIdError extends Error {
+    constructor(message: string);
+}
+
+type Opened = Promise<ProjectHistory | null>;
+/** A host's histories, one per project folder, opened on first use; a new project at the path gets its own. */
+declare function historyCache(open: (projectDir: string) => Opened): {
+    get: (projectDir: string) => Promise<ProjectHistory | null>;
+    /** The history if one was opened, without opening it. */
+    peek: (projectDir: string) => Opened | undefined;
+    forget: (projectDir: string) => boolean;
+    closeAll: () => Promise<(void | undefined)[]>;
+};
+
+interface PruneOptions {
+    now?: number;
+    /** Reports what would go, with the same checks, and removes nothing. */
+    dryRun?: boolean;
+    /** Projects under this folder are scratch: their history goes as soon as they do. */
+    tempDir?: string;
+    /** One history that could not be checked or removed; the rest are still pruned. */
+    onError?: (error: unknown) => void;
+    /** Starts no further history after this long; the rest wait for the next run. */
+    budgetMs?: number;
+}
+interface ProjectHistoryRecord {
+    id: string;
+    projectDir: string;
+    lastUsedMs: number;
+}
+/** Every history whose project is still in the folder it was recorded for; reads only. */
+declare function listProjectHistories(historyRoot: string): ProjectHistoryRecord[];
+interface PrunedHistory {
+    id: string;
+    projectDir: string;
+    bytes: number;
+}
+/** Removes the histories whose project is gone and that no live process holds. */
+declare function pruneGoneProjectHistories(historyRoot: string, options?: PruneOptions): Promise<PrunedHistory[]>;
+
+export { HistoryBusyError, HistoryIdError, ProjectHistory, type ProjectHistoryRecord, type PrunedHistory, historyCache, listProjectHistories, pruneGoneProjectHistories };

package/dist/history/index.js

@@ -0,0 +1,29 @@
+import {
+  DEFAULT_HISTORY_ROOT,
+  HistoryBusyError,
+  HistoryClosedError,
+  HistoryIdError,
+  MAX_WINDOW_IDLE_MS,
+  START,
+  UNDO_MODES,
+  historyCache,
+  listProjectHistories,
+  openProjectHistory,
+  pruneGoneProjectHistories
+} from "../chunk-IG4DRZI2.js";
+import "../chunk-PMXUKOC3.js";
+import "../chunk-TTWLTYSQ.js";
+export {
+  DEFAULT_HISTORY_ROOT,
+  START as HISTORY_START,
+  HistoryBusyError,
+  HistoryClosedError,
+  HistoryIdError,
+  MAX_WINDOW_IDLE_MS,
+  UNDO_MODES,
+  historyCache,
+  listProjectHistories,
+  openProjectHistory,
+  pruneGoneProjectHistories
+};
+//# sourceMappingURL=index.js.map

package/dist/history/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -1,12 +1,17 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, P as ProjectHistory, a as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-BMHd9G3N.js';
-export { C as ClosedWindow, D as DEFAULT_HISTORY_ROOT, b as HISTORY_START, H as HistoryClosedError, c as HistoryEntry, d as HistoryEntrySide, e as HistoryFileChange, f as HistoryListItem, g as HistoryResult, h as HistoryWho, i as HistoryWindow, L as LintResult, j as MAX_WINDOW_IDLE_MS, k as PreviewApiAdapter, l as ProjectHistoryOptions, R as RenderJobState, m as ResolvedProject, n as StudioSelectionResponse, o as StudioSelectionSnapshot, p as StudioSelectionTextField, U as UNDO_MODES, q as UndoMode, r as openProjectHistory } from './mediaProxyPreview-BMHd9G3N.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-CLu9FdIr.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-CLu9FdIr.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 HistoryWho, g as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, h as ProjectHistoryOptions, U as UNDO_MODES, i as UndoMode, o as openProjectHistory } from './projectHistory-Cm8Mdmmv.js';
+export { HistoryBusyError, HistoryIdError, ProjectHistoryRecord, PrunedHistory, historyCache, listProjectHistories, pruneGoneProjectHistories } from './history/index.js';
+export { walkDir } from './helpers/safePath.js';
+export { stampProjectHfIds } from './helpers/hfIdPersist.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';
 export { STUDIO_MANUAL_EDITS_PATH, StudioManualEditsRenderScriptOptions, createStudioManualEditsRenderBodyScript, createStudioPositionSeekReapplyScript } from './helpers/manualEditsRenderScript.js';
 export { STUDIO_MOTION_PATH, StudioMotionRenderScriptOptions, createStudioMotionRenderBodyScript } from './helpers/studioMotionRenderScript.js';
-export { isSafePath } from '@hyperframes/core';
+export { isSafePath } from '@hyperframes/core/safe-path';
+import '@hyperframes/core';
 import '@hyperframes/parsers';
 import '@hyperframes/core/compiler';
 import './helpers/mediaCodecMap.js';
@@ -54,60 +59,6 @@ declare function compositionsAffectedBy(projectDir: string, changedPath: string)
 
 declare function affectsPreview(projectDir: string, changedPath: string): boolean;
 
-declare class HistoryBusyError extends Error {
-    readonly pid: number;
-    constructor(pid: number);
-}
-
-declare class HistoryIdError extends Error {
-    constructor(message: string);
-}
-
-type Opened = Promise<ProjectHistory | null>;
-/** A host's histories, one per project folder, opened on first use; a new project at the path gets its own. */
-declare function historyCache(open: (projectDir: string) => Opened): {
-    get: (projectDir: string) => Promise<ProjectHistory | null>;
-    /** The history if one was opened, without opening it. */
-    peek: (projectDir: string) => Opened | undefined;
-    forget: (projectDir: string) => boolean;
-    closeAll: () => Promise<(void | undefined)[]>;
-};
-
-interface PruneOptions {
-    now?: number;
-    /** Reports what would go, with the same checks, and removes nothing. */
-    dryRun?: boolean;
-    /** Projects under this folder are scratch: their history goes as soon as they do. */
-    tempDir?: string;
-    /** One history that could not be checked or removed; the rest are still pruned. */
-    onError?: (error: unknown) => void;
-    /** Starts no further history after this long; the rest wait for the next run. */
-    budgetMs?: number;
-}
-interface ProjectHistoryRecord {
-    id: string;
-    projectDir: string;
-    lastUsedMs: number;
-}
-/** Every history whose project is still in the folder it was recorded for; reads only. */
-declare function listProjectHistories(historyRoot: string): ProjectHistoryRecord[];
-interface PrunedHistory {
-    id: string;
-    projectDir: string;
-    bytes: number;
-}
-/** Removes the histories whose project is gone and that no live process holds. */
-declare function pruneGoneProjectHistories(historyRoot: string, options?: PruneOptions): Promise<PrunedHistory[]>;
-
-/** 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
- * watches the project: an id write during a session reaches Studio as an outside edit and reloads it.
- * A file whose content hash matches the last run's (kept in `.hyperframes`) is not parsed again. */
-declare function stampProjectHfIds(projectDir: string): void;
-
 interface DuplicateElementResult {
     html: string;
     matched: boolean;
@@ -248,4 +199,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, HistoryBusyError, HistoryIdError, MIME_TYPES, MediaProcessingJobState, PREVIEW_BUNDLE_OPTIONS, ProjectHistory, type ProjectHistoryRecord, type PrunedHistory, SourceMutationTarget, StudioApiAdapter, type ThumbnailOutputDimensions, affectsPreview, affectsProjectSignature, applyFileMutations, buildSubCompositionHtml, compositionsAffectedBy, consumeFileWriteReceipt, createBackgroundRemovalJob, createPreviewDocumentStore, createProjectSignature, createStudioApi, duplicateElementInHtml, fileContentVersion, getMimeType, historyCache, identifyFileWrite, listProjectHistories, pruneGoneProjectHistories, requestSubPath, settledFileTag, stampProjectHfIds, thumbnailDeviceScaleFactor, walkDir };
+export { type AppliedFileMutation, type BackgroundRemovalRender, DELETED_VERSION, type DuplicateElementResult, type FileMutationInput, type FileWriteReceipt, MIME_TYPES, MediaProcessingJobState, PREVIEW_BUNDLE_OPTIONS, SourceMutationTarget, StudioApiAdapter, type ThumbnailOutputDimensions, affectsPreview, affectsProjectSignature, applyFileMutations, buildSubCompositionHtml, compositionsAffectedBy, consumeFileWriteReceipt, createBackgroundRemovalJob, createPreviewDocumentStore, createProjectSignature, createStudioApi, duplicateElementInHtml, fileContentVersion, getMimeType, identifyFileWrite, requestSubPath, settledFileTag, thumbnailDeviceScaleFactor };