feat(content-preview): forward monitoring dimensions (#4542)

* feat(content-preview): forward monitoring dimensions to Preview

Accept accessPattern, previewMode, sharedLinkAuth as props on
ContentPreview and pass them through to the underlying Preview library
so emitted metric/error events are tagged for the monitoring dashboard.

PREVIEW-225

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(content-preview): forward preload/prefetch status to Preview

Accepts two new optional props on ContentPreview — prefetchStatus
and preloadStatus — and threads them into previewOptions so
box-content-preview can tag emitted load/error/outcome events.

PREVIEW-225

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* revert(content-preview): stop forwarding preload/prefetch status

box-content-preview now derives both signals internally. The wrapper
no longer accepts these props.

PREVIEW-225

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* feat(content-preview): forward preloadStatus to Preview

Wrapper accepts preloadStatus prop and threads it into previewOptions
so box-content-preview can tag emitted load/error/outcome events.

PREVIEW-225

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* style(content-preview): sort new Props alphabetically

Addresses PR comment: merge the 4 new monitoring-dimension props into
alphabetical order with the existing Props type members.

PREVIEW-225

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Author: ahorowitz123

src/elements/content-preview/ContentPreview.js

@@ -85,6 +85,7 @@ type StartAt = {
 };
 
 type Props = {
+    accessPattern?: 'file_list' | 'direct_link' | 'shared_link',
     advancedContentInsights: {
         isActive: boolean,
         ownerEId: number,
@@ -126,13 +127,16 @@ type Props = {
     onLoad: Function,
     onNavigate: Function,
     onVersionChange: VersionChangeCallback,
+    preloadStatus?: 'hit' | 'miss',
     previewExperiences?: {
         [name: string]: TargetingApi,
     },
     previewLibraryVersion: string,
+    previewMode?: 'default' | 'shared_file' | 'shared_folder' | 'editable_shared_file' | 'inline_feed',
     requestInterceptor?: Function,
     responseInterceptor?: Function,
     sharedLink?: string,
+    sharedLinkAuth?: 'logged_in' | 'logged_out' | 'na',
     sharedLinkPassword?: string,
     showAnnotations?: boolean,
     showAnnotationsControls?: boolean,
@@ -899,6 +903,7 @@ class ContentPreview extends React.PureComponent<Props, State> {
      */
     loadPreview = async (): Promise<void> => {
         const {
+            accessPattern,
             advancedContentInsights, // will be removed once preview package will be updated to utilize feature flip for ACI
             annotatorState: { activeAnnotationId } = {},
             renderCustomPreview,
@@ -909,7 +914,10 @@ class ContentPreview extends React.PureComponent<Props, State> {
             onAnnotatorEvent,
             onAnnotator,
             onContentInsightsEventReport,
+            preloadStatus,
             previewExperiences,
+            previewMode,
+            sharedLinkAuth,
             showAnnotationsControls,
             token: tokenOrTokenFunction,
             ...rest
@@ -951,6 +959,7 @@ class ContentPreview extends React.PureComponent<Props, State> {
         }
 
         const previewOptions = {
+            accessPattern,
             advancedContentInsights, // will be removed once preview package will be updated to utilize feature flip for ACI
             container: `#${this.id} .bcpr-content`,
             enableBoundingBoxHighlights,
@@ -960,6 +969,9 @@ class ContentPreview extends React.PureComponent<Props, State> {
             header: 'none',
             headerElement: `#${this.id} .bcpr-PreviewHeader`,
             experiences: previewExperiences,
+            preloadStatus,
+            previewMode,
+            sharedLinkAuth,
             showAnnotations: this.canViewAnnotations(),
             showAnnotationsControls,
             showDownload: this.canDownload(),

src/elements/content-preview/__tests__/ContentPreview.test.js

@@ -385,6 +385,41 @@ describe('elements/content-preview/ContentPreview', () => {
             );
         });
 
+        test('should forward host-supplied monitoring dimensions to preview options', async () => {
+            const wrapper = getWrapper({
+                ...props,
+                accessPattern: 'file_list',
+                preloadStatus: 'hit',
+                previewMode: 'default',
+                sharedLinkAuth: 'na',
+            });
+            wrapper.setState({ file });
+            const instance = wrapper.instance();
+            await instance.loadPreview();
+            expect(instance.preview.show).toHaveBeenCalledWith(
+                file.id,
+                expect.any(Function),
+                expect.objectContaining({
+                    accessPattern: 'file_list',
+                    preloadStatus: 'hit',
+                    previewMode: 'default',
+                    sharedLinkAuth: 'na',
+                }),
+            );
+        });
+
+        test('should pass monitoring dimensions as undefined when host omits them', async () => {
+            const wrapper = getWrapper(props);
+            wrapper.setState({ file });
+            const instance = wrapper.instance();
+            await instance.loadPreview();
+            const options = instance.preview.show.mock.calls[0][2];
+            expect(options.accessPattern).toBeUndefined();
+            expect(options.preloadStatus).toBeUndefined();
+            expect(options.previewMode).toBeUndefined();
+            expect(options.sharedLinkAuth).toBeUndefined();
+        });
+
         test('should call preview show with file version params if provided', async () => {
             const wrapper = getWrapper(props);
             wrapper.setState({