@hyperframes/studio-server 0.8.81 → 0.8.83

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, P as ProjectHistory, a as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-BOp3Wa9v.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-BOp3Wa9v.js';
+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 { SourceMutationTarget } from './helpers/sourceMutation.js';
 export { PatchOperation, dedupeClonedCompositionId, findTargetElement, parseSourceDocument, patchElementInHtml, removeElementFromHtml, splitElementInHtml } from './helpers/sourceMutation.js';
 export { ScreenshotClip, getElementScreenshotClip } from './helpers/screenshotClip.js';
@@ -73,6 +73,32 @@ declare function historyCache(open: (projectDir: string) => Opened): {
     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[];
@@ -118,9 +144,9 @@ declare const PREVIEW_BUNDLE_OPTIONS: {
     readonly sceneParts: true;
 };
 
-/** One built preview document on disk. `salt` names the server build, so new code never reads
- * a document an older build wrote. A failed read or write only costs a rebuild. */
-declare function createPreviewDocumentStore(dir: string, salt: string): PreviewDocumentStore;
+/** One built preview document under the project's `.hyperframes/preview`. `salt` names the server build, so new
+ * code never reads a document an older build wrote. A failed read or write only costs a rebuild. */
+declare function createPreviewDocumentStore(projectDir: string, salt: string): PreviewDocumentStore;
 
 declare const MIME_TYPES: Record<string, string>;
 declare function getMimeType(path: string): string;
@@ -222,4 +248,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, SourceMutationTarget, StudioApiAdapter, type ThumbnailOutputDimensions, affectsPreview, affectsProjectSignature, applyFileMutations, buildSubCompositionHtml, compositionsAffectedBy, consumeFileWriteReceipt, createBackgroundRemovalJob, createPreviewDocumentStore, createProjectSignature, createStudioApi, duplicateElementInHtml, fileContentVersion, getMimeType, historyCache, identifyFileWrite, requestSubPath, settledFileTag, stampProjectHfIds, thumbnailDeviceScaleFactor, walkDir };
+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 };