@hyperframes/studio-server 0.8.80 → 0.8.82

package/dist/helpers/sourceMutation.js

@@ -9,7 +9,7 @@ import {
   splitElementInHtml,
   unwrapElementsFromHtml,
   wrapElementsInHtml
-} from "../chunk-P5EJPIH3.js";
+} from "../chunk-W6TFBTP2.js";
 export {
   dedupeClonedCompositionId,
   findTargetElement,

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-B7ckRI-l.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-B7ckRI-l.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';
@@ -59,6 +59,10 @@ declare class HistoryBusyError extends Error {
     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): {
@@ -69,6 +73,25 @@ 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 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[];
@@ -218,4 +241,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, 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 PrunedHistory, SourceMutationTarget, StudioApiAdapter, type ThumbnailOutputDimensions, affectsPreview, affectsProjectSignature, applyFileMutations, buildSubCompositionHtml, compositionsAffectedBy, consumeFileWriteReceipt, createBackgroundRemovalJob, createPreviewDocumentStore, createProjectSignature, createStudioApi, duplicateElementInHtml, fileContentVersion, getMimeType, historyCache, identifyFileWrite, pruneGoneProjectHistories, requestSubPath, settledFileTag, stampProjectHfIds, thumbnailDeviceScaleFactor, walkDir };