Files
orca/tests/e2e/helpers/persisted-profile-state.ts
OrcaWin 82412dab8b Persist profile state in SQLite with background writes (#22612)
Migrate profile state to SQLite and move writes and backups into a background worker. Acknowledge terminal, SSH and automation changes only after durable saves. Preserve JSON import, recovery, rollback and compatibility exports.

Validate migration, worker failures, maintenance, cross-profile moves and terminal lifetime races with unit, integration and end-to-end coverage.
2026-09-25 22:47:33 -07:00

61 lines
2.2 KiB
TypeScript

import { join } from 'node:path'
import { DEFAULT_LOCAL_ORCA_PROFILE_ID } from '../../../src/shared/orca-profiles'
import {
acquireProfileStateMaintenance,
acquireProfileStateRuntimeAdmission
} from '../../../src/main/persistence/profile-state/profile-state-access'
import { openProfileStateDatabaseReadOnly } from '../../../src/main/persistence/profile-state/profile-state-database'
import { readProfileStateParsedSnapshot } from '../../../src/main/persistence/profile-state/profile-state-documents'
import { parseProfileStateRoot } from '../../../src/main/persistence/profile-state/profile-state-document-validation'
import { ProfileStateSqliteAuthority } from '../../../src/main/persistence/profile-state/profile-state-sqlite-authority'
/** Read committed storage without consulting a retained migration JSON snapshot. */
export function readPersistedProfileState(
userDataDir: string,
profileId = DEFAULT_LOCAL_ORCA_PROFILE_ID
): Record<string, unknown> {
const admission = acquireProfileStateRuntimeAdmission(userDataDir)
try {
const opened = openProfileStateDatabaseReadOnly(
join(userDataDir, 'profiles', profileId, 'profile-state.db'),
profileId
)
try {
return readProfileStateParsedSnapshot(opened.db).state
} finally {
opened.db.close()
}
} finally {
admission.release()
}
}
/** Seed restart artifacts only while no runtime or other fixture writer owns the profile. */
export function mutateStoppedProfileState<T>(
userDataDir: string,
mutate: (state: Record<string, unknown>) => T,
profileId = DEFAULT_LOCAL_ORCA_PROFILE_ID
): T {
const maintenance = acquireProfileStateMaintenance(userDataDir)
const authority = new ProfileStateSqliteAuthority(
join(userDataDir, 'profiles', profileId, 'profile-state.db'),
profileId
)
try {
const serialized = authority.readSerializedState()
if (serialized === undefined) {
throw new Error('Expected an established profile before seeding restart state')
}
const state = parseProfileStateRoot(serialized)
const result = mutate(state)
authority.writeSerializedState(Buffer.from(JSON.stringify(state)))
return result
} finally {
try {
authority.close()
} finally {
maintenance.release()
}
}
}