@hyperframes/studio-server 0.8.77 → 0.8.79

package/dist/{mediaProxyPreview-CIayJ4Y4.d.ts → mediaProxyPreview-rAYw-Jeh.d.ts}

@@ -15,6 +15,7 @@ interface HistoryFileChange {
     before: string | null;
     after: string | null;
 }
+type HistoryEntrySide = "before" | "after";
 interface HistoryEntry {
     id: string;
     who: HistoryWho;
@@ -47,6 +48,8 @@ interface ProjectHistoryOptions {
     onError?: (error: unknown) => void;
     /** How long an open waits for another process to close the same history (default 5 s). */
     ownerWaitMs?: number;
+    /** A CLI turn's window from an earlier open: writes since, within its idle limit, become the entry with its id. */
+    closedWindow?: ClosedWindow;
 }
 interface ClaimOptions {
     coalesceKey?: string;
@@ -57,6 +60,17 @@ interface ClaimOptions {
 interface Writing {
     writeToken?: string;
 }
+interface ClosedWindow {
+    id: string;
+    who: HistoryWho;
+    label: string;
+    startedAt: number;
+    lastWriteAt: number;
+    idleMs: number;
+}
+declare const MAX_WINDOW_IDLE_MS: number;
+declare const UNDO_MODES: readonly ["just-this", "back-to-before", "keep-later-edits"];
+type UndoMode = (typeof UNDO_MODES)[number];
 interface HistoryListItem extends HistoryEntry {
     pinned: boolean;
     undone: boolean;
@@ -73,21 +87,22 @@ type HistoryResult = {
 };
 interface HistoryWindow {
     readonly id: string;
+    readonly startedAt: number;
     /** Records everything written since the window opened as one entry (null when nothing changed); after the window
      * ended by itself or by flush, returns the entry it became. */
     close(): Promise<HistoryEntry | null>;
 }
 interface ProjectHistory {
     readonly projectId: string;
-    /** Writes until close() are one entry with the window's id; a claim cutting a file out commits that file's part
-     * first (fresh id), returned by close() if nothing else remained. Idle windows end; overlaps go to the newest. */
+    /** Writes until close() are one entry with the window's id; another writer or an operation meanwhile commits the
+     * part so far first (fresh id), returned by close() if nothing else remained. Overlaps go to the newest. */
     beginWindow(who: HistoryWho, label: string, options?: {
         idleMs?: number;
     }): Promise<HistoryWindow>;
     /**
      * For a writer that records after writing (Studio): moves the uncommitted changes to `paths` into one entry of
      * `who`'s, each cut at the `overwrote` version so earlier parts stay their writer's. Same-key claims merge until
-     * another key, `idleMs` idle, or any operation. Null when nothing was claimed or a drag nets to nothing.
+     * another key, idle, an operation, a window, or another write. Null when nothing was claimed or a drag nets to 0.
      */
     claim(who: HistoryWho, label: string, paths: readonly string[], options?: ClaimOptions): Promise<{
         id: string;
@@ -95,26 +110,33 @@ interface ProjectHistory {
     /** A watcher saw `path` change (project-relative or absolute). */
     noteChange(path: string): void;
     list(): HistoryListItem[];
-    /** Cmd+Z (back) and Cmd+Shift+Z (forward), whoever made the change; `writeToken` labels the writes' echo. */
+    /** Cmd+Z (back) and Cmd+Shift+Z (forward) over `who`'s own and outside changes; `writeToken` labels the echo. */
     step(direction: "back" | "forward", who: HistoryWho, options?: Writing): Promise<HistoryResult>;
-    /** The entry the next step reverts, as of the last scan (a step scans first). */
-    next(direction: "back" | "forward"): HistoryEntry | undefined;
-    /** A conflict (a file changed since) returns the choice; pass `mode` to take one. */
+    /** The entry `who`'s next step reverts, pending changes included, as of the last scan (a step scans first). */
+    next(direction: "back" | "forward", who: HistoryWho): HistoryEntry | undefined;
+    /** A file changed since returns a conflict; `mode` takes a choice (keep-later-edits: null when none is left). */
     undo(id: string, options: {
         who: HistoryWho;
-        mode?: "just-this" | "back-to-before";
+        mode?: UndoMode;
     } & Writing): Promise<HistoryResult>;
     /** Makes the files equal what they were right after `point` (an entry id, or START). */
     restore(point: string, who: HistoryWho, options?: Writing): Promise<HistoryEntry | null>;
     /** The files at `point` without writing anything: path to hash, read through readBlob. */
     peek(point: string): Record<string, string> | null;
+    checkout(entryId: string, side: HistoryEntrySide, emptyDir: string): Promise<void>;
     readBlob(hash: string): Promise<Buffer>;
     pin(id: string, pinned: boolean): void;
     onEntry(listener: (entry: HistoryEntry) => void): () => void;
     /** Takes in every pending write and commits every open window and the outside group. */
     flush(): Promise<void>;
+    /** True once another project stands at the folder's path: open that one's history instead. */
+    replacedAtPath(): boolean;
     close(): Promise<void>;
 }
+/** A call on a history that was closed, or whose folder is now another project. */
+declare class HistoryClosedError extends Error {
+    constructor(message: string);
+}
 /** Opens a project's history: every write to its files becomes an entry that can be undone or restored. */
 declare function openProjectHistory(options: ProjectHistoryOptions): Promise<ProjectHistory>;
 
@@ -409,4 +431,4 @@ declare function injectMediaCodecMapIntoHtml(html: string, projectDir: string, h
  */
 declare function injectMediaCodecMap(html: string, adapter: PreviewApiAdapter, projectDir: string, compSrcPath: string, probeCache: MediaCodecProbeCache): Promise<string>;
 
-export { DEFAULT_HISTORY_ROOT as D, type HistoryEntry as H, type LintResult as L, type MediaProcessingJobState as M, type PreviewDocumentStore as P, type RenderJobState as R, type StudioApiAdapter as S, START as a, type HistoryFileChange as b, type HistoryListItem as c, type HistoryResult as d, type HistoryWho as e, type HistoryWindow as f, type PreviewApiAdapter as g, type ProjectHistory as h, type ProjectHistoryOptions as i, type ResolvedProject as j, type StudioSelectionResponse as k, type StudioSelectionSnapshot as l, type StudioSelectionTextField as m, injectMediaCodecMap as n, openProjectHistory as o, injectMediaCodecMapIntoHtml as p, isAutoProxyEnabled as q, proxyEtagSalt as r, resolvePreviewMediaCodecProbeCache as s };
+export { type ClosedWindow as C, DEFAULT_HISTORY_ROOT as D, HistoryClosedError as H, type LintResult as L, type MediaProcessingJobState as M, type ProjectHistory as P, type RenderJobState as R, type StudioApiAdapter as S, UNDO_MODES as U, type PreviewDocumentStore as a, START as b, type HistoryEntry as c, type HistoryEntrySide as d, type HistoryFileChange as e, type HistoryListItem as f, type HistoryResult as g, type HistoryWho as h, type HistoryWindow as i, MAX_WINDOW_IDLE_MS as j, type PreviewApiAdapter as k, type ProjectHistoryOptions as l, type ResolvedProject as m, type StudioSelectionResponse as n, type StudioSelectionSnapshot as o, type StudioSelectionTextField as p, type UndoMode as q, openProjectHistory as r, injectMediaCodecMap as s, injectMediaCodecMapIntoHtml as t, isAutoProxyEnabled as u, proxyEtagSalt as v, resolvePreviewMediaCodecProbeCache as w };

package/package.json

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