Prefer Archivematica access copies over older ones

[meisekimiu]

Prefer archivematica access copies over older converted access copies in the file viewer. This is accomplished with a centralized helper function that picks the proper access copy in our specific priority order. This function is then used in various file viewer components.

This also includes the change to the download options, since it depends on the new FileVO type definitions.

Resolves PER-9873 + PER-9902.

Steps to test:

1. If the environment you're testing on includes archivematica-generated access copies, then you can actually test this functionality. Make sure to verify new access copies are downloadable as well.
2. If not, verify that unit tests pass and that file viewing for all types (image, document, audio, video, are there others?) is otherwise not affected. Verify that downloading them still functions as well.

[codecov]

Codecov Report

Attention: Patch coverage is 82.75862% with 5 lines in your changes missing coverage. Please review.

Project coverage is 42.71%. Comparing base (3b1f4d5) to head (284ae00).
Report is 7 commits behind head on main.

Files with missing lines	Patch %	Lines
src/app/shared/components/video/video.component.ts	71.42%	1 Missing and 1 partial ⚠️
...nents/download-button/download-button.component.ts	0.00%	1 Missing ⚠️
...file-list-controls/file-list-controls.component.ts	0.00%	1 Missing ⚠️
src/app/shared/components/audio/audio.component.ts	0.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #488      +/-   ##
==========================================
+ Coverage   42.53%   42.71%   +0.17%     
==========================================
  Files         357      359       +2     
  Lines       10984    10974      -10     
  Branches     1795     1793       -2     
==========================================
+ Hits         4672     4687      +15     
+ Misses       6151     6130      -21     
+ Partials      161      157       -4     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

---

🚨 Try these New Features:

• Flaky Tests Detection - Detect and resolve failed and flaky tests
• JS Bundle Analysis - Avoid shipping oversized bundles

[liam-lloyd]

In testing this, it looks like the Archivematica access copy is available via the download button in the record info panel on the right of the screen, but not via the download button at the top of the file list.

[meisekimiu]

In testing this, it looks like the Archivematica access copy is available via the download button in the record info panel on the right of the screen, but not via the download button at the top of the file list.

I believe this should be fixed now

[meisekimiu]

I decided to refactor the "cursed" pattern I was using earlier since it ended up being used in two places now. This should make those calls easier to read while allowing us to continue to use this same prioritization behavior in each case, and hopefully future cases if they arise.

[k8lyn6]

@yeslikesolo to test this, please check all formats listed as accepted file types in this KB article to make sure they are 1. viewable (in both the preview info tab and full screen!) and 2. downloadable (from the button at the top and the button in the info tab). If you need test files, you can find some here.

[meisekimiu]

To clarify a bit, you probably only need to test the various general types of files ("Photo, Audio, Video, Document" etc) and not each specific format (though different kinds of documents might be helpful since they go through multiple processing steps)