Class FilePersistence

src/telemetry/persistence.ts:48–93

}

export class FilePersistence implements Persistence {
  #dataFolder: string;

  constructor(dataFolderOverride?: string) {
    this.#dataFolder = dataFolderOverride ?? getDataFolder();
  }

  async loadState(): Promise<LocalState> {
    const filePath = path.join(this.#dataFolder, STATE_FILE_NAME);
    try {
      await fs.access(filePath);
    } catch {
      // File doesn't exist. Not an error because new users do not have the state file.
      return {
        lastActive: '',
      };
    }

    try {
      const content = await fs.readFile(filePath, 'utf-8');
      return JSON.parse(content) as LocalState;
    } catch (error) {
      logger?.(`Failed to read telemetry state from ${filePath}:`, error);
      void ClearcutLogger.get()?.logServerError({
        errorCode: ErrorCode.ERROR_CODE_PERSISTENCE_FILE_READ_FAILED,
      });
      return {
        lastActive: '',
      };
    }
  }

  async saveState(state: LocalState): Promise<void> {
    const filePath = path.join(this.#dataFolder, STATE_FILE_NAME);
    try {
      await fs.mkdir(this.#dataFolder, {recursive: true});
      await fs.writeFile(filePath, JSON.stringify(state, null, 2), 'utf-8');
    } catch (error) {
      // Ignore errors during state saving to avoid crashing the server
      logger?.(`Failed to save telemetry state to ${filePath}:`, error);
      void ClearcutLogger.get()?.logServerError({
        errorCode: ErrorCode.ERROR_CODE_PERSISTENCE_FILE_SAVE_FAILED,
      });
    }
  }
}