chromium-tabs 0.1.0 → 0.2.0

package/dist/command-storage-backend-BLy7EP79.d.cts

@@ -0,0 +1,318 @@
+import { d as TabId, T as TabGroupId, a as TabGroupVisualData } from './types-CYa7ouKw.cjs';
+
+/**
+ * Session snapshot types. Ported from
+ * chromium-reference/components/sessions/core/session_types.h and
+ * serialized_navigation_entry.h.
+ *
+ * These are the plain-data structures produced by replaying a command log
+ * (restoreSessionFromCommands) and consumed by session restore. Chrome's
+ * SessionTab carries WebContents-specific state (user agent overrides,
+ * extension app ids, session storage ids); this port carries the library's
+ * generic `data` payload instead, plus the same extra-data escape hatch.
+ */
+
+/**
+ * Identifies a window (one TabStripModel) within a session. Chrome uses
+ * monotonic int32 SessionIDs (session_id.h); this port uses caller-supplied
+ * strings so ids stay stable across process restarts.
+ */
+type SessionWindowId = string;
+declare const DEFAULT_WINDOW_ID: SessionWindowId;
+/**
+ * One entry in a tab's navigation history. Trimmed from
+ * SerializedNavigationEntry (serialized_navigation_entry.h:88): we keep the
+ * fields a headless tab strip can act on. `state` is the analog of Chrome's
+ * encoded_page_state — an opaque app-defined blob (scroll position, form
+ * state, …) that must be JSON-serializable.
+ */
+interface SerializedNavigationEntry {
+    /**
+     * Position in the tab's navigation list. Like Chrome's
+     * SerializedNavigationEntry::index_, values may have gaps after pruning;
+     * order is what matters.
+     */
+    index: number;
+    url: string;
+    title?: string;
+    /** Opaque app state for this entry (encoded_page_state analog). */
+    state?: unknown;
+    /** Wall-clock ms when the entry was created/updated. */
+    timestamp?: number;
+}
+/** Mirrors SessionTab (session_types.h:34), adapted to this library. */
+interface SessionTab {
+    tabId: TabId;
+    windowId: SessionWindowId;
+    /**
+     * Visual position in the window. Mirrors tab_visual_index. May contain
+     * gaps (closed tabs leave holes); restore sorts by it.
+     */
+    visualIndex: number;
+    pinned: boolean;
+    groupId: TabGroupId | null;
+    /**
+     * Serialized tab data payload (the result of serializeTabData). This is
+     * where your url lives if you don't use navigation tracking. Analog of
+     * kCommandSetTabData's key/value map, generalized to one JSON value.
+     */
+    data: unknown;
+    /** Navigation history, sorted ascending by entry index. */
+    navigations: SerializedNavigationEntry[];
+    /**
+     * While rebuilding this is a navigation *index value*; after
+     * restoreSessionFromCommands completes it has been remapped to a position
+     * in `navigations` (AddTabsToWindows, session_service_commands.cc:404), or
+     * -1 when there are no navigations.
+     */
+    currentNavigationIndex: number;
+    /** Wall-clock ms the tab was last active, if recorded. */
+    lastActiveTime?: number;
+    /** App-defined string map (kCommandAddTabExtraData). */
+    extraData: Record<string, string>;
+}
+/** Mirrors SessionTabGroup (session_types.h:103). */
+interface SessionTabGroup {
+    groupId: TabGroupId;
+    visualData: TabGroupVisualData;
+}
+/** Mirrors SessionWindow (session_types.h:120), minus desktop geometry. */
+interface SessionWindow {
+    windowId: SessionWindowId;
+    /**
+     * While rebuilding this is the selected tab's *visual index*; after
+     * restoreSessionFromCommands completes it has been remapped to a position
+     * in `tabs` (UpdateSelectedTabIndex, session_service_commands.cc:265).
+     */
+    selectedTabIndex: number;
+    /** Tabs sorted by visual order (SortTabsBasedOnVisualOrderAndClear). */
+    tabs: SessionTab[];
+    /** Groups referenced by this window's tabs. */
+    tabGroups: SessionTabGroup[];
+    /** App-defined string map (kCommandAddWindowExtraData). */
+    extraData: Record<string, string>;
+}
+/** The result of reading back a persisted session. */
+interface SessionSnapshot {
+    /** Windows with at least one restorable tab, in stable windowId order. */
+    windows: SessionWindow[];
+    activeWindowId: SessionWindowId | null;
+    /**
+     * True when the log was truncated, corrupted, or contained an unknown
+     * command. Mirrors ReadCommandsResult::error_reading — whatever was
+     * readable is still returned (the rebuild is fault-tolerant).
+     */
+    errorReading: boolean;
+}
+/**
+ * The selected navigation entry of a restored tab, or null when the tab was
+ * persisted without navigation tracking. Convenience over
+ * normalized_navigation_index() (session_types.h:62).
+ */
+declare function currentNavigationEntry(tab: SessionTab): SerializedNavigationEntry | null;
+
+/**
+ * Session commands: the persisted mutation log and its rebuild algorithm.
+ * Ported from chromium-reference/components/sessions/core/session_service_commands.cc.
+ *
+ * Chrome appends fixed-size binary payloads (pickles) to an SNSS file; this
+ * port keeps the same command ids and semantics but encodes each command as a
+ * JSON-serializable object. Restoring a session means replaying the log into
+ * SessionTab/SessionWindow structures (RestoreSessionFromCommands, cc:1398).
+ */
+
+/**
+ * Command ids, numbered as in session_service_commands.cc:58-106. Ids that
+ * only make sense for a real browser (window bounds, user agent overrides,
+ * extension app ids, session storage, split tabs) are not ported; their
+ * numbers stay reserved so logs remain comparable to Chrome's.
+ */
+declare const SessionCommandId: {
+    readonly SET_TAB_WINDOW: 0;
+    readonly SET_TAB_INDEX_IN_WINDOW: 2;
+    readonly UPDATE_TAB_NAVIGATION: 6;
+    readonly SET_SELECTED_NAVIGATION_INDEX: 7;
+    readonly SET_SELECTED_TAB_IN_INDEX: 8;
+    readonly SET_PINNED_STATE: 12;
+    readonly TAB_CLOSED: 16;
+    readonly WINDOW_CLOSED: 17;
+    readonly SET_ACTIVE_WINDOW: 20;
+    readonly LAST_ACTIVE_TIME: 21;
+    readonly TAB_NAVIGATION_PATH_PRUNED: 24;
+    readonly SET_TAB_GROUP: 25;
+    readonly SET_TAB_GROUP_METADATA2: 27;
+    readonly SET_TAB_DATA: 30;
+    readonly ADD_TAB_EXTRA_DATA: 33;
+    readonly ADD_WINDOW_EXTRA_DATA: 34;
+};
+type SessionCommand = {
+    id: 0;
+    windowId: SessionWindowId;
+    tabId: TabId;
+} | {
+    id: 2;
+    tabId: TabId;
+    index: number;
+} | {
+    id: 6;
+    tabId: TabId;
+    navigation: SerializedNavigationEntry;
+} | {
+    id: 7;
+    tabId: TabId;
+    index: number;
+} | {
+    id: 8;
+    windowId: SessionWindowId;
+    index: number;
+} | {
+    id: 12;
+    tabId: TabId;
+    pinned: boolean;
+} | {
+    id: 16;
+    tabId: TabId;
+    closeTime: number;
+} | {
+    id: 17;
+    windowId: SessionWindowId;
+    closeTime: number;
+} | {
+    id: 20;
+    windowId: SessionWindowId;
+} | {
+    id: 21;
+    tabId: TabId;
+    lastActiveTime: number;
+} | {
+    id: 24;
+    tabId: TabId;
+    index: number;
+    count: number;
+} | {
+    id: 25;
+    tabId: TabId;
+    groupId: TabGroupId | null;
+} | {
+    id: 27;
+    groupId: TabGroupId;
+    visualData: TabGroupVisualData;
+} | {
+    id: 30;
+    tabId: TabId;
+    data: unknown;
+} | {
+    id: 33;
+    tabId: TabId;
+    key: string;
+    value: string;
+} | {
+    id: 34;
+    windowId: SessionWindowId;
+    key: string;
+    value: string;
+};
+declare function createSetTabWindowCommand(windowId: SessionWindowId, tabId: TabId): SessionCommand;
+declare function createSetTabIndexInWindowCommand(tabId: TabId, index: number): SessionCommand;
+declare function createUpdateTabNavigationCommand(tabId: TabId, navigation: SerializedNavigationEntry): SessionCommand;
+declare function createSetSelectedNavigationIndexCommand(tabId: TabId, index: number): SessionCommand;
+declare function createSetSelectedTabInWindowCommand(windowId: SessionWindowId, index: number): SessionCommand;
+declare function createPinnedStateCommand(tabId: TabId, pinned: boolean): SessionCommand;
+declare function createTabClosedCommand(tabId: TabId, closeTime?: number): SessionCommand;
+declare function createWindowClosedCommand(windowId: SessionWindowId, closeTime?: number): SessionCommand;
+declare function createSetActiveWindowCommand(windowId: SessionWindowId): SessionCommand;
+declare function createLastActiveTimeCommand(tabId: TabId, lastActiveTime: number): SessionCommand;
+declare function createTabNavigationPathPrunedCommand(tabId: TabId, index: number, count: number): SessionCommand;
+declare function createTabGroupCommand(tabId: TabId, groupId: TabGroupId | null): SessionCommand;
+declare function createTabGroupMetadataUpdateCommand(groupId: TabGroupId, visualData: TabGroupVisualData): SessionCommand;
+declare function createSetTabDataCommand(tabId: TabId, data: unknown): SessionCommand;
+declare function createAddTabExtraDataCommand(tabId: TabId, key: string, value: string): SessionCommand;
+declare function createAddWindowExtraDataCommand(windowId: SessionWindowId, key: string, value: string): SessionCommand;
+/**
+ * True for commands recording a close. Closing commands never trigger a
+ * rebuild — resetting right after a close could lose the state we want to
+ * restore. Mirrors IsClosingCommand (session_service_commands.cc:1374).
+ */
+declare function isClosingCommand(command: SessionCommand): boolean;
+/**
+ * Returns the position of the first navigation whose index is >= `index`,
+ * or navigations.length. Navigations are sorted ascending by index.
+ * Mirrors FindClosestNavigationWithIndex (session_service_commands.cc:339).
+ */
+declare function findClosestNavigationWithIndex(navigations: readonly SerializedNavigationEntry[], index: number): number;
+/**
+ * Removes `count` navigation entries starting at index value `index`,
+ * fixing up the selected index and renumbering survivors. Mirrors
+ * ProcessTabNavigationPathPrunedCommand (session_service_commands.cc:489).
+ */
+declare function processTabNavigationPathPruned(tab: Pick<SessionTab, 'navigations' | 'currentNavigationIndex'>, index: number, count: number): void;
+/**
+ * Replays a command log into restorable windows. Port of
+ * RestoreSessionFromCommands (session_service_commands.cc:1398):
+ *
+ *   1. CreateTabsAndWindows (cc:521) — apply each command to lazily-created
+ *      tab/window/group entries, stopping at the first malformed command.
+ *   2. AddTabsToWindows (cc:404) — attach tabs to their windows, dropping
+ *      tabs that never got a window; remap each tab's selected-navigation
+ *      *index value* to a position in its navigations array.
+ *   3. SortTabsBasedOnVisualOrderAndClear (cc:372) — order tabs by visual
+ *      index and drop windows with no tabs.
+ *   4. UpdateSelectedTabIndex (cc:265) — remap each window's selected-tab
+ *      *visual index* to a position in its tabs array.
+ *
+ * Deviation from Chrome: tabs without navigation entries are kept when they
+ * carry a data payload — this library's data-only persistence mode has no
+ * navigation list, but the tab is still fully restorable from `data`.
+ */
+declare function restoreSessionFromCommands(commands: readonly SessionCommand[]): SessionSnapshot;
+
+/**
+ * Storage backend interface. Ported from
+ * chromium-reference/components/sessions/core/command_storage_backend.h.
+ *
+ * Chrome's backend owns timestamped SNSS files under Sessions/ and tracks
+ * which one is the "last session" (the previous run) versus the "current
+ * session" (this run). This port reduces that to two slots — `current` and
+ * `last` — over any storage primitive. Implementations may be synchronous
+ * (web storage) or asynchronous (IndexedDB, files); CommandStorageManager
+ * awaits either.
+ */
+
+/** Mirrors CommandStorageBackend::ReadCommandsResult (h:81). */
+interface ReadCommandsResult {
+    commands: SessionCommand[];
+    /**
+     * True when the stored data was missing pieces, unparsable, or otherwise
+     * suspect. Whatever could be read is still in `commands`.
+     */
+    errorReading: boolean;
+}
+interface CommandStorageBackend {
+    /**
+     * Identifies this storage area for cross-realm singleton coordination —
+     * the analog of Chrome naming its ProcessSingleton after the user data
+     * directory (process_singleton.h:45). Backends that can be reached from
+     * several realms at once (web storage) must provide it; backends that
+     * cannot (in-memory) leave it undefined and the service acts as sole
+     * owner.
+     */
+    readonly profileLockName?: string;
+    /**
+     * Persists commands to the current session. With `truncate` the current
+     * session is replaced wholesale (the pending commands are a complete
+     * snapshot); otherwise they are appended. Mirrors
+     * CommandStorageBackend::AppendCommands (h:120).
+     */
+    appendCommands(commands: readonly SessionCommand[], truncate: boolean): void | Promise<void>;
+    /** Reads the previous session's log. Mirrors GetLastSessionCommands. */
+    readLastSessionCommands(): ReadCommandsResult | Promise<ReadCommandsResult>;
+    /**
+     * Promotes the current session to "last" and starts an empty current
+     * session. When no current session exists (the previous run died before
+     * its first save), the existing last session is left untouched so it can
+     * still be restored. Mirrors MoveCurrentSessionToLastSession (h:131).
+     */
+    moveCurrentSessionToLastSession(): void | Promise<void>;
+}
+
+export { processTabNavigationPathPruned as A, restoreSessionFromCommands as B, type CommandStorageBackend as C, DEFAULT_WINDOW_ID as D, type ReadCommandsResult as R, type SessionCommand as S, type SessionTab as a, type SessionWindow as b, type SessionWindowId as c, type SessionSnapshot as d, type SerializedNavigationEntry as e, SessionCommandId as f, type SessionTabGroup as g, createAddTabExtraDataCommand as h, createAddWindowExtraDataCommand as i, createLastActiveTimeCommand as j, createPinnedStateCommand as k, createSetActiveWindowCommand as l, createSetSelectedNavigationIndexCommand as m, createSetSelectedTabInWindowCommand as n, createSetTabDataCommand as o, createSetTabIndexInWindowCommand as p, createSetTabWindowCommand as q, createTabClosedCommand as r, createTabGroupCommand as s, createTabGroupMetadataUpdateCommand as t, createTabNavigationPathPrunedCommand as u, createUpdateTabNavigationCommand as v, createWindowClosedCommand as w, currentNavigationEntry as x, findClosestNavigationWithIndex as y, isClosingCommand as z };

package/dist/command-storage-backend-CDoXkRtc.d.ts

@@ -0,0 +1,318 @@
+import { d as TabId, T as TabGroupId, a as TabGroupVisualData } from './types-CYa7ouKw.js';
+
+/**
+ * Session snapshot types. Ported from
+ * chromium-reference/components/sessions/core/session_types.h and
+ * serialized_navigation_entry.h.
+ *
+ * These are the plain-data structures produced by replaying a command log
+ * (restoreSessionFromCommands) and consumed by session restore. Chrome's
+ * SessionTab carries WebContents-specific state (user agent overrides,
+ * extension app ids, session storage ids); this port carries the library's
+ * generic `data` payload instead, plus the same extra-data escape hatch.
+ */
+
+/**
+ * Identifies a window (one TabStripModel) within a session. Chrome uses
+ * monotonic int32 SessionIDs (session_id.h); this port uses caller-supplied
+ * strings so ids stay stable across process restarts.
+ */
+type SessionWindowId = string;
+declare const DEFAULT_WINDOW_ID: SessionWindowId;
+/**
+ * One entry in a tab's navigation history. Trimmed from
+ * SerializedNavigationEntry (serialized_navigation_entry.h:88): we keep the
+ * fields a headless tab strip can act on. `state` is the analog of Chrome's
+ * encoded_page_state — an opaque app-defined blob (scroll position, form
+ * state, …) that must be JSON-serializable.
+ */
+interface SerializedNavigationEntry {
+    /**
+     * Position in the tab's navigation list. Like Chrome's
+     * SerializedNavigationEntry::index_, values may have gaps after pruning;
+     * order is what matters.
+     */
+    index: number;
+    url: string;
+    title?: string;
+    /** Opaque app state for this entry (encoded_page_state analog). */
+    state?: unknown;
+    /** Wall-clock ms when the entry was created/updated. */
+    timestamp?: number;
+}
+/** Mirrors SessionTab (session_types.h:34), adapted to this library. */
+interface SessionTab {
+    tabId: TabId;
+    windowId: SessionWindowId;
+    /**
+     * Visual position in the window. Mirrors tab_visual_index. May contain
+     * gaps (closed tabs leave holes); restore sorts by it.
+     */
+    visualIndex: number;
+    pinned: boolean;
+    groupId: TabGroupId | null;
+    /**
+     * Serialized tab data payload (the result of serializeTabData). This is
+     * where your url lives if you don't use navigation tracking. Analog of
+     * kCommandSetTabData's key/value map, generalized to one JSON value.
+     */
+    data: unknown;
+    /** Navigation history, sorted ascending by entry index. */
+    navigations: SerializedNavigationEntry[];
+    /**
+     * While rebuilding this is a navigation *index value*; after
+     * restoreSessionFromCommands completes it has been remapped to a position
+     * in `navigations` (AddTabsToWindows, session_service_commands.cc:404), or
+     * -1 when there are no navigations.
+     */
+    currentNavigationIndex: number;
+    /** Wall-clock ms the tab was last active, if recorded. */
+    lastActiveTime?: number;
+    /** App-defined string map (kCommandAddTabExtraData). */
+    extraData: Record<string, string>;
+}
+/** Mirrors SessionTabGroup (session_types.h:103). */
+interface SessionTabGroup {
+    groupId: TabGroupId;
+    visualData: TabGroupVisualData;
+}
+/** Mirrors SessionWindow (session_types.h:120), minus desktop geometry. */
+interface SessionWindow {
+    windowId: SessionWindowId;
+    /**
+     * While rebuilding this is the selected tab's *visual index*; after
+     * restoreSessionFromCommands completes it has been remapped to a position
+     * in `tabs` (UpdateSelectedTabIndex, session_service_commands.cc:265).
+     */
+    selectedTabIndex: number;
+    /** Tabs sorted by visual order (SortTabsBasedOnVisualOrderAndClear). */
+    tabs: SessionTab[];
+    /** Groups referenced by this window's tabs. */
+    tabGroups: SessionTabGroup[];
+    /** App-defined string map (kCommandAddWindowExtraData). */
+    extraData: Record<string, string>;
+}
+/** The result of reading back a persisted session. */
+interface SessionSnapshot {
+    /** Windows with at least one restorable tab, in stable windowId order. */
+    windows: SessionWindow[];
+    activeWindowId: SessionWindowId | null;
+    /**
+     * True when the log was truncated, corrupted, or contained an unknown
+     * command. Mirrors ReadCommandsResult::error_reading — whatever was
+     * readable is still returned (the rebuild is fault-tolerant).
+     */
+    errorReading: boolean;
+}
+/**
+ * The selected navigation entry of a restored tab, or null when the tab was
+ * persisted without navigation tracking. Convenience over
+ * normalized_navigation_index() (session_types.h:62).
+ */
+declare function currentNavigationEntry(tab: SessionTab): SerializedNavigationEntry | null;
+
+/**
+ * Session commands: the persisted mutation log and its rebuild algorithm.
+ * Ported from chromium-reference/components/sessions/core/session_service_commands.cc.
+ *
+ * Chrome appends fixed-size binary payloads (pickles) to an SNSS file; this
+ * port keeps the same command ids and semantics but encodes each command as a
+ * JSON-serializable object. Restoring a session means replaying the log into
+ * SessionTab/SessionWindow structures (RestoreSessionFromCommands, cc:1398).
+ */
+
+/**
+ * Command ids, numbered as in session_service_commands.cc:58-106. Ids that
+ * only make sense for a real browser (window bounds, user agent overrides,
+ * extension app ids, session storage, split tabs) are not ported; their
+ * numbers stay reserved so logs remain comparable to Chrome's.
+ */
+declare const SessionCommandId: {
+    readonly SET_TAB_WINDOW: 0;
+    readonly SET_TAB_INDEX_IN_WINDOW: 2;
+    readonly UPDATE_TAB_NAVIGATION: 6;
+    readonly SET_SELECTED_NAVIGATION_INDEX: 7;
+    readonly SET_SELECTED_TAB_IN_INDEX: 8;
+    readonly SET_PINNED_STATE: 12;
+    readonly TAB_CLOSED: 16;
+    readonly WINDOW_CLOSED: 17;
+    readonly SET_ACTIVE_WINDOW: 20;
+    readonly LAST_ACTIVE_TIME: 21;
+    readonly TAB_NAVIGATION_PATH_PRUNED: 24;
+    readonly SET_TAB_GROUP: 25;
+    readonly SET_TAB_GROUP_METADATA2: 27;
+    readonly SET_TAB_DATA: 30;
+    readonly ADD_TAB_EXTRA_DATA: 33;
+    readonly ADD_WINDOW_EXTRA_DATA: 34;
+};
+type SessionCommand = {
+    id: 0;
+    windowId: SessionWindowId;
+    tabId: TabId;
+} | {
+    id: 2;
+    tabId: TabId;
+    index: number;
+} | {
+    id: 6;
+    tabId: TabId;
+    navigation: SerializedNavigationEntry;
+} | {
+    id: 7;
+    tabId: TabId;
+    index: number;
+} | {
+    id: 8;
+    windowId: SessionWindowId;
+    index: number;
+} | {
+    id: 12;
+    tabId: TabId;
+    pinned: boolean;
+} | {
+    id: 16;
+    tabId: TabId;
+    closeTime: number;
+} | {
+    id: 17;
+    windowId: SessionWindowId;
+    closeTime: number;
+} | {
+    id: 20;
+    windowId: SessionWindowId;
+} | {
+    id: 21;
+    tabId: TabId;
+    lastActiveTime: number;
+} | {
+    id: 24;
+    tabId: TabId;
+    index: number;
+    count: number;
+} | {
+    id: 25;
+    tabId: TabId;
+    groupId: TabGroupId | null;
+} | {
+    id: 27;
+    groupId: TabGroupId;
+    visualData: TabGroupVisualData;
+} | {
+    id: 30;
+    tabId: TabId;
+    data: unknown;
+} | {
+    id: 33;
+    tabId: TabId;
+    key: string;
+    value: string;
+} | {
+    id: 34;
+    windowId: SessionWindowId;
+    key: string;
+    value: string;
+};
+declare function createSetTabWindowCommand(windowId: SessionWindowId, tabId: TabId): SessionCommand;
+declare function createSetTabIndexInWindowCommand(tabId: TabId, index: number): SessionCommand;
+declare function createUpdateTabNavigationCommand(tabId: TabId, navigation: SerializedNavigationEntry): SessionCommand;
+declare function createSetSelectedNavigationIndexCommand(tabId: TabId, index: number): SessionCommand;
+declare function createSetSelectedTabInWindowCommand(windowId: SessionWindowId, index: number): SessionCommand;
+declare function createPinnedStateCommand(tabId: TabId, pinned: boolean): SessionCommand;
+declare function createTabClosedCommand(tabId: TabId, closeTime?: number): SessionCommand;
+declare function createWindowClosedCommand(windowId: SessionWindowId, closeTime?: number): SessionCommand;
+declare function createSetActiveWindowCommand(windowId: SessionWindowId): SessionCommand;
+declare function createLastActiveTimeCommand(tabId: TabId, lastActiveTime: number): SessionCommand;
+declare function createTabNavigationPathPrunedCommand(tabId: TabId, index: number, count: number): SessionCommand;
+declare function createTabGroupCommand(tabId: TabId, groupId: TabGroupId | null): SessionCommand;
+declare function createTabGroupMetadataUpdateCommand(groupId: TabGroupId, visualData: TabGroupVisualData): SessionCommand;
+declare function createSetTabDataCommand(tabId: TabId, data: unknown): SessionCommand;
+declare function createAddTabExtraDataCommand(tabId: TabId, key: string, value: string): SessionCommand;
+declare function createAddWindowExtraDataCommand(windowId: SessionWindowId, key: string, value: string): SessionCommand;
+/**
+ * True for commands recording a close. Closing commands never trigger a
+ * rebuild — resetting right after a close could lose the state we want to
+ * restore. Mirrors IsClosingCommand (session_service_commands.cc:1374).
+ */
+declare function isClosingCommand(command: SessionCommand): boolean;
+/**
+ * Returns the position of the first navigation whose index is >= `index`,
+ * or navigations.length. Navigations are sorted ascending by index.
+ * Mirrors FindClosestNavigationWithIndex (session_service_commands.cc:339).
+ */
+declare function findClosestNavigationWithIndex(navigations: readonly SerializedNavigationEntry[], index: number): number;
+/**
+ * Removes `count` navigation entries starting at index value `index`,
+ * fixing up the selected index and renumbering survivors. Mirrors
+ * ProcessTabNavigationPathPrunedCommand (session_service_commands.cc:489).
+ */
+declare function processTabNavigationPathPruned(tab: Pick<SessionTab, 'navigations' | 'currentNavigationIndex'>, index: number, count: number): void;
+/**
+ * Replays a command log into restorable windows. Port of
+ * RestoreSessionFromCommands (session_service_commands.cc:1398):
+ *
+ *   1. CreateTabsAndWindows (cc:521) — apply each command to lazily-created
+ *      tab/window/group entries, stopping at the first malformed command.
+ *   2. AddTabsToWindows (cc:404) — attach tabs to their windows, dropping
+ *      tabs that never got a window; remap each tab's selected-navigation
+ *      *index value* to a position in its navigations array.
+ *   3. SortTabsBasedOnVisualOrderAndClear (cc:372) — order tabs by visual
+ *      index and drop windows with no tabs.
+ *   4. UpdateSelectedTabIndex (cc:265) — remap each window's selected-tab
+ *      *visual index* to a position in its tabs array.
+ *
+ * Deviation from Chrome: tabs without navigation entries are kept when they
+ * carry a data payload — this library's data-only persistence mode has no
+ * navigation list, but the tab is still fully restorable from `data`.
+ */
+declare function restoreSessionFromCommands(commands: readonly SessionCommand[]): SessionSnapshot;
+
+/**
+ * Storage backend interface. Ported from
+ * chromium-reference/components/sessions/core/command_storage_backend.h.
+ *
+ * Chrome's backend owns timestamped SNSS files under Sessions/ and tracks
+ * which one is the "last session" (the previous run) versus the "current
+ * session" (this run). This port reduces that to two slots — `current` and
+ * `last` — over any storage primitive. Implementations may be synchronous
+ * (web storage) or asynchronous (IndexedDB, files); CommandStorageManager
+ * awaits either.
+ */
+
+/** Mirrors CommandStorageBackend::ReadCommandsResult (h:81). */
+interface ReadCommandsResult {
+    commands: SessionCommand[];
+    /**
+     * True when the stored data was missing pieces, unparsable, or otherwise
+     * suspect. Whatever could be read is still in `commands`.
+     */
+    errorReading: boolean;
+}
+interface CommandStorageBackend {
+    /**
+     * Identifies this storage area for cross-realm singleton coordination —
+     * the analog of Chrome naming its ProcessSingleton after the user data
+     * directory (process_singleton.h:45). Backends that can be reached from
+     * several realms at once (web storage) must provide it; backends that
+     * cannot (in-memory) leave it undefined and the service acts as sole
+     * owner.
+     */
+    readonly profileLockName?: string;
+    /**
+     * Persists commands to the current session. With `truncate` the current
+     * session is replaced wholesale (the pending commands are a complete
+     * snapshot); otherwise they are appended. Mirrors
+     * CommandStorageBackend::AppendCommands (h:120).
+     */
+    appendCommands(commands: readonly SessionCommand[], truncate: boolean): void | Promise<void>;
+    /** Reads the previous session's log. Mirrors GetLastSessionCommands. */
+    readLastSessionCommands(): ReadCommandsResult | Promise<ReadCommandsResult>;
+    /**
+     * Promotes the current session to "last" and starts an empty current
+     * session. When no current session exists (the previous run died before
+     * its first save), the existing last session is left untouched so it can
+     * still be restored. Mirrors MoveCurrentSessionToLastSession (h:131).
+     */
+    moveCurrentSessionToLastSession(): void | Promise<void>;
+}
+
+export { processTabNavigationPathPruned as A, restoreSessionFromCommands as B, type CommandStorageBackend as C, DEFAULT_WINDOW_ID as D, type ReadCommandsResult as R, type SessionCommand as S, type SessionTab as a, type SessionWindow as b, type SessionWindowId as c, type SessionSnapshot as d, type SerializedNavigationEntry as e, SessionCommandId as f, type SessionTabGroup as g, createAddTabExtraDataCommand as h, createAddWindowExtraDataCommand as i, createLastActiveTimeCommand as j, createPinnedStateCommand as k, createSetActiveWindowCommand as l, createSetSelectedNavigationIndexCommand as m, createSetSelectedTabInWindowCommand as n, createSetTabDataCommand as o, createSetTabIndexInWindowCommand as p, createSetTabWindowCommand as q, createTabClosedCommand as r, createTabGroupCommand as s, createTabGroupMetadataUpdateCommand as t, createTabNavigationPathPrunedCommand as u, createUpdateTabNavigationCommand as v, createWindowClosedCommand as w, currentNavigationEntry as x, findClosestNavigationWithIndex as y, isClosingCommand as z };