@atlaskit/media-viewer 49.2.7 → 49.4.0

package/dist/esm/analytics/events/operational/download.js

@@ -0,0 +1,53 @@
+import { getFileAttributes } from '../..';
+import { getPrimaryErrorReason, getSecondaryErrorReason, getErrorDetail, getRequestMetadata } from '../../../errors';
+export var createDownloadSucceededEventPayload = function createDownloadSucceededEventPayload(fileState, traceContext) {
+  var _getFileAttributes = getFileAttributes(fileState),
+    fileId = _getFileAttributes.fileId,
+    fileMediatype = _getFileAttributes.fileMediatype,
+    fileMimetype = _getFileAttributes.fileMimetype,
+    fileSize = _getFileAttributes.fileSize;
+  return {
+    eventType: 'operational',
+    actionSubject: 'mediaFile',
+    action: 'downloadSucceeded',
+    attributes: {
+      status: 'success',
+      fileMediatype: fileMediatype,
+      fileMimetype: fileMimetype,
+      fileAttributes: {
+        fileId: fileId,
+        fileMediatype: fileMediatype,
+        fileMimetype: fileMimetype,
+        fileSize: fileSize
+      },
+      traceContext: traceContext
+    }
+  };
+};
+export var createDownloadFailedEventPayload = function createDownloadFailedEventPayload(fileId, error, fileState, traceContext) {
+  var _getFileAttributes2 = getFileAttributes(fileState),
+    fileMediatype = _getFileAttributes2.fileMediatype,
+    fileMimetype = _getFileAttributes2.fileMimetype,
+    fileSize = _getFileAttributes2.fileSize;
+  return {
+    eventType: 'operational',
+    actionSubject: 'mediaFile',
+    action: 'downloadFailed',
+    attributes: {
+      status: 'fail',
+      failReason: getPrimaryErrorReason(error),
+      error: getSecondaryErrorReason(error),
+      errorDetail: getErrorDetail(error),
+      request: getRequestMetadata(error),
+      fileMimetype: fileMimetype,
+      fileMediatype: fileMediatype,
+      fileAttributes: {
+        fileId: fileId,
+        fileMediatype: fileMediatype,
+        fileMimetype: fileMimetype,
+        fileSize: fileSize
+      },
+      traceContext: traceContext
+    }
+  };
+};

package/dist/esm/analytics/index.js

@@ -1,7 +1,7 @@
 import { ANALYTICS_MEDIA_CHANNEL, sanitiseAnalyticsPayload } from '@atlaskit/media-common/analytics';
 var componentName = 'mediaViewer';
 var packageName = "@atlaskit/media-viewer";
-var packageVersion = "49.2.7";
+var packageVersion = "49.4.0";
 export { packageName, packageVersion, componentName, componentName as component };
 export function getFileAttributes(fileState) {
   if (!fileState) {

package/dist/esm/analytics/ufoExperiences.js

@@ -5,7 +5,7 @@ import { UFOExperience, ExperiencePerformanceTypes, ExperienceTypes } from '@atl
 import { getMediaEnvironment, getMediaRegion } from '@atlaskit/media-client';
 import { getFeatureFlagKeysAllProducts } from '@atlaskit/media-common';
 var packageName = "@atlaskit/media-viewer";
-var packageVersion = "49.2.7";
+var packageVersion = "49.4.0";
 var ufoExperience;
 var getExperience = function getExperience() {
   if (!ufoExperience) {

package/dist/esm/components/media-viewer.js

@@ -37,7 +37,8 @@ export var MediaViewerBase = function MediaViewerBase(_ref) {
     collectionName = _ref.collectionName,
     items = _ref.items,
     extensions = _ref.extensions,
-    contextId = _ref.contextId;
+    contextId = _ref.contextId,
+    viewerOptions = _ref.viewerOptions;
   var _useMemo = useMemo(function () {
       return normaliseItems(items, selectedItem, collectionName);
     }, [items, selectedItem, collectionName]),
@@ -70,7 +71,8 @@ export var MediaViewerBase = function MediaViewerBase(_ref) {
     items: normalisedItems,
     featureFlags: featureFlags,
     extensions: extensions,
-    contextId: contextId
+    contextId: contextId,
+    viewerOptions: viewerOptions
   });
 };
 

package/dist/esm/download.js

@@ -1,60 +1,91 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _extends from "@babel/runtime/helpers/extends";
 import _objectWithoutProperties from "@babel/runtime/helpers/objectWithoutProperties";
 var _excluded = ["analyticspayload", "onClick"];
+import _regeneratorRuntime from "@babel/runtime/regenerator";
+import { useAnalyticsEvents } from '@atlaskit/analytics-next';
 import DownloadIcon from '@atlaskit/icon/core/migration/download';
 import { isErrorFileState, isExternalImageIdentifier } from '@atlaskit/media-client';
 import { MediaButton, messages } from '@atlaskit/media-ui';
 import React, { useCallback } from 'react';
 import { FormattedMessage } from 'react-intl-next';
-import { ANALYTICS_MEDIA_CHANNEL } from '@atlaskit/media-common';
 import { createDownloadButtonClickedEvent } from './analytics/events/ui/downloadButtonClicked';
+import { createDownloadFailedEventPayload, createDownloadSucceededEventPayload } from './analytics/events/operational/download';
+import { fireAnalytics } from './analytics';
 import { createFailedPreviewDownloadButtonClickedEvent } from './analytics/events/ui/failedPreviewDownloadButtonClicked';
 import { DownloadButtonWrapper } from './styleWrappers';
+import { MediaViewerError } from './errors';
 var downloadIcon = /*#__PURE__*/React.createElement(DownloadIcon, {
   color: "currentColor",
   spacing: "spacious",
   label: "Download"
 });
 function noop() {}
-export function DownloadButton(_ref) {
+function DownloadButton(_ref) {
   var analyticspayload = _ref.analyticspayload,
     _ref$onClick = _ref.onClick,
     providedOnClick = _ref$onClick === void 0 ? noop : _ref$onClick,
     rest = _objectWithoutProperties(_ref, _excluded);
+  var _useAnalyticsEvents = useAnalyticsEvents(),
+    createAnalyticsEvent = _useAnalyticsEvents.createAnalyticsEvent;
   var onClick = useCallback(function (event, analyticsEvent) {
-    var clone = analyticsEvent.clone();
-    if (clone) {
-      clone.update(analyticspayload);
-      clone.fire(ANALYTICS_MEDIA_CHANNEL);
-    }
+    fireAnalytics(analyticspayload, createAnalyticsEvent);
     providedOnClick(event, analyticsEvent);
-  }, [analyticspayload, providedOnClick]);
+  }, [analyticspayload, providedOnClick, createAnalyticsEvent]);
   return /*#__PURE__*/React.createElement(MediaButton, _extends({}, rest, {
     onClick: onClick
   }));
 }
-export var createItemDownloader = function createItemDownloader(file, mediaClient, collectionName) {
-  return function () {
-    var id = file.id;
-    var name = !isErrorFileState(file) ? file.name : undefined;
-    return mediaClient.file.downloadBinary(id, name, collectionName);
-  };
+var createItemDownloader = function createItemDownloader(file, mediaClient, options) {
+  return /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
+    var collectionName, traceContext, createAnalyticsEvent, id, name;
+    return _regeneratorRuntime.wrap(function _callee$(_context) {
+      while (1) switch (_context.prev = _context.next) {
+        case 0:
+          collectionName = options.collectionName, traceContext = options.traceContext, createAnalyticsEvent = options.createAnalyticsEvent;
+          id = file.id;
+          name = !isErrorFileState(file) ? file.name : undefined;
+          mediaClient.file.downloadBinary(id, name, collectionName, traceContext).then(function () {
+            fireAnalytics(createDownloadSucceededEventPayload(file, traceContext), createAnalyticsEvent);
+          }).catch(function (e) {
+            fireAnalytics(createDownloadFailedEventPayload(file.id, new MediaViewerError('download', e), file, traceContext), createAnalyticsEvent);
+          });
+        case 4:
+        case "end":
+          return _context.stop();
+      }
+    }, _callee);
+  }));
 };
-export var ErrorViewDownloadButton = function ErrorViewDownloadButton(props) {
-  var fileState = props.fileState,
-    error = props.error;
+export var ErrorViewDownloadButton = function ErrorViewDownloadButton(_ref3) {
+  var fileState = _ref3.fileState,
+    mediaClient = _ref3.mediaClient,
+    error = _ref3.error,
+    traceContext = _ref3.traceContext,
+    collectionName = _ref3.collectionName;
   var downloadEvent = createFailedPreviewDownloadButtonClickedEvent(fileState, error);
-  return /*#__PURE__*/React.createElement(DownloadButtonWrapper, null, /*#__PURE__*/React.createElement(DownloadButton, {
-    testId: "media-viewer-download-button",
+  var _useAnalyticsEvents2 = useAnalyticsEvents(),
+    createAnalyticsEvent = _useAnalyticsEvents2.createAnalyticsEvent;
+  return /*#__PURE__*/React.createElement(DownloadButtonWrapper, null, /*#__PURE__*/React.createElement(DownloadButton
+  // testId="media-viewer-failed-preview-download-button"
+  , {
+    testId: "media-viewer-error-download-button",
     analyticspayload: downloadEvent,
     appearance: "primary",
-    onClick: createItemDownloader(props.fileState, props.mediaClient, props.collectionName)
+    onClick: createItemDownloader(fileState, mediaClient, {
+      collectionName: collectionName,
+      traceContext: traceContext,
+      createAnalyticsEvent: createAnalyticsEvent
+    })
   }, /*#__PURE__*/React.createElement(FormattedMessage, messages.download)));
 };
-export var ToolbarDownloadButton = function ToolbarDownloadButton(props) {
-  var state = props.state,
-    mediaClient = props.mediaClient,
-    identifier = props.identifier;
+export var ToolbarDownloadButton = function ToolbarDownloadButton(_ref4) {
+  var state = _ref4.state,
+    mediaClient = _ref4.mediaClient,
+    identifier = _ref4.identifier,
+    traceContext = _ref4.traceContext;
+  var _useAnalyticsEvents3 = useAnalyticsEvents(),
+    createAnalyticsEvent = _useAnalyticsEvents3.createAnalyticsEvent;
   var downloadEvent = createDownloadButtonClickedEvent(state);
 
   // TODO [MS-1731]: make it work for external files as well
@@ -64,7 +95,11 @@ export var ToolbarDownloadButton = function ToolbarDownloadButton(props) {
   return /*#__PURE__*/React.createElement(DownloadButton, {
     testId: "media-viewer-download-button",
     analyticspayload: downloadEvent,
-    onClick: createItemDownloader(state, mediaClient, identifier.collectionName),
+    onClick: createItemDownloader(state, mediaClient, {
+      collectionName: identifier.collectionName,
+      createAnalyticsEvent: createAnalyticsEvent,
+      traceContext: traceContext
+    }),
     iconBefore: downloadIcon
   });
 };

package/dist/esm/header.js

@@ -18,7 +18,8 @@ export var Header = function Header(_ref) {
     isSidebarVisible = _ref.isSidebarVisible,
     onSidebarButtonClick = _ref.onSidebarButtonClick,
     identifier = _ref.identifier,
-    onSetArchiveSideBarVisible = _ref.onSetArchiveSideBarVisible;
+    onSetArchiveSideBarVisible = _ref.onSetArchiveSideBarVisible,
+    traceContext = _ref.traceContext;
   // States
   var _useState = useState(Outcome.pending()),
     _useState2 = _slicedToArray(_useState, 2),
@@ -143,7 +144,8 @@ export var Header = function Header(_ref) {
       return /*#__PURE__*/React.createElement(ToolbarDownloadButton, {
         state: item,
         identifier: identifier,
-        mediaClient: mediaClient
+        mediaClient: mediaClient,
+        traceContext: traceContext
       });
     }
   })));

package/dist/esm/item-viewer.js

@@ -3,6 +3,7 @@ import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import React, { useCallback, useEffect, useState, useRef } from 'react';
 import Loadable from 'react-loadable';
 import { isExternalImageIdentifier, isFileIdentifier } from '@atlaskit/media-client';
+import { Text } from '@atlaskit/primitives';
 import { FormattedMessage } from 'react-intl-next';
 import { messages } from '@atlaskit/media-ui';
 import { isCodeViewerItem } from '@atlaskit/media-ui/codeViewer';
@@ -18,8 +19,8 @@ import { createLoadSucceededEvent } from './analytics/events/operational/loadSuc
 import { fireAnalytics, getFileAttributes } from './analytics';
 import { InteractiveImg } from './viewers/image/interactive-img';
 import ArchiveViewerLoader from './viewers/archiveSidebar/archiveViewerLoader';
-import { getRandomHex } from '@atlaskit/media-common';
 import { startMediaFileUfoExperience, succeedMediaFileUfoExperience } from './analytics/ufoExperiences';
+import { CustomViewer } from './viewers/customViewer/customViewer';
 var ImageViewer = Loadable({
   loader: function loader() {
     return import( /* webpackChunkName: "@atlaskit-internal_imageViewer" */'./viewers/image').then(function (mod) {
@@ -97,15 +98,14 @@ export var ItemViewerBase = function ItemViewerBase(_ref) {
     onClose = _ref.onClose,
     previewCount = _ref.previewCount,
     contextId = _ref.contextId,
-    createAnalyticsEvent = _ref.createAnalyticsEvent;
+    createAnalyticsEvent = _ref.createAnalyticsEvent,
+    viewerOptions = _ref.viewerOptions,
+    traceContext = _ref.traceContext;
   // States and Refs
   var _useState = useState(Outcome.pending()),
     _useState2 = _slicedToArray(_useState, 2),
     item = _useState2[0],
     setItem = _useState2[1];
-  var traceContext = useRef({
-    traceId: getRandomHex(8)
-  });
   var fileStateFlagsRef = useRef({
     wasStatusUploading: false,
     wasStatusProcessing: false
@@ -126,9 +126,10 @@ export var ItemViewerBase = function ItemViewerBase(_ref) {
       fileState: fileState,
       mediaClient: mediaClient,
       error: error,
-      collectionName: collectionName
+      collectionName: collectionName,
+      traceContext: traceContext
     });
-  }, [mediaClient, identifier]);
+  }, [mediaClient, identifier, traceContext]);
 
   // Did mount
 
@@ -136,9 +137,9 @@ export var ItemViewerBase = function ItemViewerBase(_ref) {
     if (isExternalImageIdentifier(identifier)) {
       return;
     }
-    fireAnalytics(createCommencedEvent(identifier === null || identifier === void 0 ? void 0 : identifier.id, traceContext.current), createAnalyticsEventRef.current);
+    fireAnalytics(createCommencedEvent(identifier === null || identifier === void 0 ? void 0 : identifier.id, traceContext), createAnalyticsEventRef.current);
     startMediaFileUfoExperience();
-  }, [identifier]);
+  }, [identifier, traceContext]);
   useEffect(function () {
     if (isExternalImageIdentifier(identifier)) {
       // external images do not need to talk to our backend,
@@ -170,26 +171,41 @@ export var ItemViewerBase = function ItemViewerBase(_ref) {
     item.whenSuccessful(function (fileItem) {
       if (isFileStateItem(fileItem)) {
         var fileAttributes = getFileAttributes(fileItem);
-        fireAnalytics(createLoadSucceededEvent(fileAttributes, traceContext.current), createAnalyticsEventRef.current);
+        fireAnalytics(createLoadSucceededEvent(fileAttributes, traceContext), createAnalyticsEventRef.current);
         succeedMediaFileUfoExperience({
           fileAttributes: fileAttributes,
           fileStateFlags: fileStateFlagsRef.current
         });
       }
     });
-  }, [item]);
+  }, [item, traceContext]);
   var onLoadFail = useCallback(function (mediaViewerError) {
     setItem(Outcome.failed(mediaViewerError, fileState));
   }, [fileState]);
   var renderItem = function renderItem(fileItem) {
+    var _viewerOptions$custom;
     var collectionName = isFileIdentifier(identifier) ? identifier.collectionName : undefined;
     var viewerProps = {
       mediaClient: mediaClient,
       item: fileItem,
       collectionName: collectionName,
       onClose: onClose,
-      previewCount: previewCount
+      previewCount: previewCount,
+      viewerOptions: viewerOptions,
+      traceContext: traceContext
     };
+    var customRenderer = viewerOptions === null || viewerOptions === void 0 || (_viewerOptions$custom = viewerOptions.customRenderers) === null || _viewerOptions$custom === void 0 ? void 0 : _viewerOptions$custom.find(function (renderer) {
+      return renderer.shouldUseCustomRenderer({
+        fileItem: fileItem
+      });
+    });
+    if (customRenderer) {
+      return /*#__PURE__*/React.createElement(CustomViewer, _extends({
+        customRendererConfig: customRenderer,
+        onError: onLoadFail,
+        onSuccess: onSuccess
+      }, viewerProps));
+    }
 
     // TODO: fix all of the item errors
 
@@ -210,7 +226,7 @@ export var ItemViewerBase = function ItemViewerBase(_ref) {
         onLoad: onSuccess,
         onError: onLoadFail,
         onClose: onClose,
-        traceContext: traceContext.current
+        traceContext: traceContext
       });
     }
     var mediaType = fileItem.mediaType;
@@ -219,8 +235,7 @@ export var ItemViewerBase = function ItemViewerBase(_ref) {
         return /*#__PURE__*/React.createElement(ImageViewer, _extends({
           onLoad: onSuccess,
           onError: onLoadFail,
-          contextId: contextId,
-          traceContext: traceContext.current
+          contextId: contextId
         }, viewerProps));
       case 'audio':
         return /*#__PURE__*/React.createElement(AudioViewer, _extends({
@@ -265,8 +280,8 @@ export var ItemViewerBase = function ItemViewerBase(_ref) {
         error: error,
         fileState: _fileState,
         fileStateFlags: fileStateFlagsRef.current,
-        traceContext: traceContext.current
-      }, /*#__PURE__*/React.createElement("p", null, /*#__PURE__*/React.createElement(FormattedMessage, messages.try_downloading_file)), renderDownloadButton(_fileState, error));
+        traceContext: traceContext
+      }, /*#__PURE__*/React.createElement(Text, null, /*#__PURE__*/React.createElement(FormattedMessage, messages.try_downloading_file)), renderDownloadButton(_fileState, error));
     } else {
       return /*#__PURE__*/React.createElement(ErrorMessage, {
         fileId: isFileIdentifier(identifier) ? identifier.id : 'undefined',

package/dist/esm/list.js

@@ -1,9 +1,10 @@
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
-import React, { useState } from 'react';
+import React, { useState, useRef } from 'react';
 import { hideControlsClassName } from '@atlaskit/media-ui';
 import { ItemViewer } from './item-viewer';
 import { HeaderWrapper, ListWrapper } from './styleWrappers';
 import { Navigation } from './navigation';
+import { getRandomHex } from '@atlaskit/media-common';
 import Header from './header';
 export var List = function List(_ref) {
   var defaultSelectedItem = _ref.defaultSelectedItem,
@@ -15,7 +16,8 @@ export var List = function List(_ref) {
     featureFlags = _ref.featureFlags,
     isSidebarVisible = _ref.isSidebarVisible,
     onNavigationChange = _ref.onNavigationChange,
-    items = _ref.items;
+    items = _ref.items,
+    viewerOptions = _ref.viewerOptions;
   var _useState = useState(defaultSelectedItem),
     _useState2 = _slicedToArray(_useState, 2),
     selectedItem = _useState2[0],
@@ -28,6 +30,9 @@ export var List = function List(_ref) {
     _useState6 = _slicedToArray(_useState5, 2),
     isArchiveSideBarVisible = _useState6[0],
     setIsArchiveSideBarVisible = _useState6[1];
+  var traceContext = useRef({
+    traceId: getRandomHex(8)
+  });
   return /*#__PURE__*/React.createElement(ListWrapper, null, /*#__PURE__*/React.createElement(HeaderWrapper
   // eslint-disable-next-line @atlaskit/ui-styling-standard/no-classname-prop -- Ignored via go/DSP-18766
   , {
@@ -41,14 +46,17 @@ export var List = function List(_ref) {
     isSidebarVisible: isSidebarVisible,
     isArchiveSideBarVisible: isArchiveSideBarVisible,
     featureFlags: featureFlags,
-    onSetArchiveSideBarVisible: setIsArchiveSideBarVisible
+    onSetArchiveSideBarVisible: setIsArchiveSideBarVisible,
+    traceContext: traceContext.current
   })), /*#__PURE__*/React.createElement(ItemViewer, {
     identifier: selectedItem,
     showControls: showControls,
     onClose: onClose,
     previewCount: previewCount,
     contextId: contextId,
-    featureFlags: featureFlags
+    featureFlags: featureFlags,
+    viewerOptions: viewerOptions,
+    traceContext: traceContext.current
   }), /*#__PURE__*/React.createElement(Navigation, {
     items: items,
     selectedItem: selectedItem,

package/dist/esm/media-viewer.js

@@ -22,7 +22,8 @@ var MediaViewerComponent = function MediaViewerComponent(_ref) {
     innerRef = _ref.innerRef,
     _onClose = _ref.onClose,
     selectedItem = _ref.selectedItem,
-    intl = _ref.intl;
+    intl = _ref.intl,
+    viewerOptions = _ref.viewerOptions;
   var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
     isSidebarVisible = _useState2[0],
@@ -85,7 +86,8 @@ var MediaViewerComponent = function MediaViewerComponent(_ref) {
     },
     isSidebarVisible: isSidebarVisible,
     contextId: contextId,
-    featureFlags: featureFlags
+    featureFlags: featureFlags,
+    viewerOptions: viewerOptions
   })), renderSidebar()));
   return intl ? content : /*#__PURE__*/React.createElement(IntlProvider, {
     locale: "en"

package/dist/esm/viewerOptions.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/viewers/archiveSidebar/archive.js

@@ -17,6 +17,7 @@ import { unzip, HTTPRangeReader } from 'unzipit';
 import { FormattedMessage } from 'react-intl-next';
 import { CustomMediaPlayer, messages } from '@atlaskit/media-ui';
 import { getLanguageType, isCodeViewerItem } from '@atlaskit/media-ui/codeViewer';
+import { Text } from '@atlaskit/primitives';
 import { Outcome } from '../../domain';
 import { CustomVideoPlayerWrapper, AudioPlayer, CustomAudioPlayerWrapper, DefaultCoverWrapper, ListWrapper } from '../../styleWrappers';
 import AudioIcon from '@atlaskit/icon/core/migration/audio--media-services-audio';
@@ -92,7 +93,8 @@ export var ArchiveViewerBase = /*#__PURE__*/function (_BaseViewer) {
             case 0:
               _this.setState({
                 content: Outcome.successful(_objectSpread(_objectSpread({}, _this.state.content.data), {}, {
-                  selectedArchiveEntry: undefined
+                  selectedArchiveEntry: undefined,
+                  hasLoadedEntries: false // displays a nice loading spinner for the content viewer
                 }))
               });
               src = '';
@@ -106,7 +108,7 @@ export var ArchiveViewerBase = /*#__PURE__*/function (_BaseViewer) {
               _context2.next = 8;
               return rejectAfter(function () {
                 return selectedArchiveEntry.blob();
-              });
+              }, 10000);
             case 8:
               blob = _context2.sent;
               src = URL.createObjectURL(blob);
@@ -136,7 +138,8 @@ export var ArchiveViewerBase = /*#__PURE__*/function (_BaseViewer) {
                   isDirectory: selectedArchiveEntry.isDirectory,
                   error: undefined,
                   codeViewerSrc: codeViewerSrc,
-                  isCodeMimeType: isCodeMimeType
+                  isCodeMimeType: isCodeMimeType,
+                  hasLoadedEntries: true
                 }))
               });
             case 20:
@@ -238,7 +241,9 @@ export var ArchiveViewerBase = /*#__PURE__*/function (_BaseViewer) {
   }, {
     key: "renderArchiveItemViewer",
     value: function renderArchiveItemViewer(content) {
-      var item = this.props.item;
+      var _this$props2 = this.props,
+        item = _this$props2.item,
+        viewerOptions = _this$props2.viewerOptions;
       var src = content.src,
         name = content.name,
         isDirectory = content.isDirectory,
@@ -250,9 +255,48 @@ export var ArchiveViewerBase = /*#__PURE__*/function (_BaseViewer) {
         return this.renderPreviewError(error, selectedArchiveEntry);
       }
       if (!isDirectory && selectedArchiveEntry) {
+        var _viewerOptions$custom;
         if (!name || !src) {
           return this.renderPreviewError(new ArchiveViewerError('archiveviewer-missing-name-src'), selectedArchiveEntry);
         }
+        var customRenderer = viewerOptions === null || viewerOptions === void 0 || (_viewerOptions$custom = viewerOptions.customRenderers) === null || _viewerOptions$custom === void 0 ? void 0 : _viewerOptions$custom.find(function (renderer) {
+          return renderer.shouldUseCustomRenderer({
+            fileItem: item,
+            archiveFileItem: {
+              name: name
+            }
+          });
+        });
+        if (customRenderer) {
+          return /*#__PURE__*/React.createElement(ArchiveItemViewerWrapper, null, customRenderer.renderContent({
+            fileItem: item,
+            archiveFileItem: {
+              name: name
+            },
+            getBinaryContent: function () {
+              var _getBinaryContent = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee4() {
+                return _regeneratorRuntime.wrap(function _callee4$(_context4) {
+                  while (1) switch (_context4.prev = _context4.next) {
+                    case 0:
+                      _context4.next = 2;
+                      return fetch(src);
+                    case 2:
+                      return _context4.abrupt("return", _context4.sent.blob());
+                    case 3:
+                    case "end":
+                      return _context4.stop();
+                  }
+                }, _callee4);
+              }));
+              function getBinaryContent() {
+                return _getBinaryContent.apply(this, arguments);
+              }
+              return getBinaryContent;
+            }(),
+            onLoad: this.onViewerLoad(selectedArchiveEntry),
+            onError: this.onViewerError('archiveviewer-customrenderer-onerror', selectedArchiveEntry)
+          }));
+        }
         var mediaType = getMediaTypeFromFilename(name);
         if (isCodeMimeType) {
           // Same code viewer logic as in Item-Viewer.tsx
@@ -324,16 +368,16 @@ export var ArchiveViewerBase = /*#__PURE__*/function (_BaseViewer) {
   }, {
     key: "renderPreviewError",
     value: function renderPreviewError(error, entry) {
-      var _this$props2 = this.props,
-        item = _this$props2.item,
-        createAnalyticsEvent = _this$props2.createAnalyticsEvent;
+      var _this$props3 = this.props,
+        item = _this$props3.item,
+        createAnalyticsEvent = _this$props3.createAnalyticsEvent;
       fireAnalytics(createZipEntryLoadFailedEvent(item, error, entry), createAnalyticsEvent);
       return /*#__PURE__*/React.createElement(ListWrapper, null, /*#__PURE__*/React.createElement(ErrorMessage, {
         fileId: item.id,
         fileState: item,
         error: error,
         supressAnalytics: true
-      }, /*#__PURE__*/React.createElement("p", null, /*#__PURE__*/React.createElement(FormattedMessage, messages.try_downloading_file))));
+      }, /*#__PURE__*/React.createElement(Text, null, /*#__PURE__*/React.createElement(FormattedMessage, messages.try_downloading_file))));
     }
   }]);
   return ArchiveViewerBase;

package/dist/esm/viewers/base-viewer.js

@@ -113,12 +113,14 @@ export var BaseViewer = /*#__PURE__*/function (_React$Component) {
       var _this$props = this.props,
         item = _this$props.item,
         mediaClient = _this$props.mediaClient,
-        collectionName = _this$props.collectionName;
+        collectionName = _this$props.collectionName,
+        traceContext = _this$props.traceContext;
       return /*#__PURE__*/React.createElement(ErrorViewDownloadButton, {
         fileState: item,
         mediaClient: mediaClient,
         error: error,
-        collectionName: collectionName
+        collectionName: collectionName,
+        traceContext: traceContext
       });
     }
   }, {

package/dist/esm/viewers/customViewer/customViewer.js

@@ -0,0 +1,46 @@
+import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
+import { MediaViewerError } from '../../errors';
+import { useCallback, useEffect, useState } from 'react';
+import React from 'react';
+import { Spinner } from '../../loading';
+export var CustomViewer = function CustomViewer(_ref) {
+  var mediaClient = _ref.mediaClient,
+    item = _ref.item,
+    customRendererConfig = _ref.customRendererConfig,
+    onSuccess = _ref.onSuccess,
+    onError = _ref.onError;
+  var _useState = useState(),
+    _useState2 = _slicedToArray(_useState, 2),
+    getBinaryContent = _useState2[0],
+    setGetBinaryContent = _useState2[1];
+  useEffect(function () {
+    setGetBinaryContent(undefined);
+    var abortController = new AbortController();
+    // This sets the 'getBinaryContent' to an async function that fetches the binary content of the file
+    // The 'getBinaryContent' function has to be updated when the item changes
+    // This approach handles aborting in-progress request outside of the custom-renderer concern
+    if (item.status === 'processed' || item.status === 'failed-processing') {
+      setGetBinaryContent(function () {
+        return function () {
+          return mediaClient.mediaStore.getFileBinary(item.id, undefined, abortController);
+        };
+      });
+    }
+    return function () {
+      return abortController.abort();
+    };
+  }, [item, mediaClient]);
+  var onLoadFailed = useCallback(function (error) {
+    var mediaError = new MediaViewerError('custom-viewer-error', error);
+    onError(mediaError, item);
+  }, [item, onError]);
+  if (!getBinaryContent) {
+    return /*#__PURE__*/React.createElement(Spinner, null);
+  }
+  return /*#__PURE__*/React.createElement(React.Fragment, null, customRendererConfig.renderContent({
+    fileItem: item,
+    getBinaryContent: getBinaryContent,
+    onLoad: onSuccess,
+    onError: onLoadFailed
+  }));
+};

package/dist/types/analytics/events/index.d.ts

@@ -1,5 +1,6 @@
 import { type CommencedEventPayload } from './operational/commenced';
 import { type LoadFailedEventPayload } from './operational/loadFailed';
+import { type DownloadFailedEventPayload, type DownloadSucceededEventPayload } from './operational/download';
 import { type LoadSucceededEventPayload } from './operational/loadSucceeded';
 import { type PreviewUnsupportedEventPayload } from './operational/previewUnsupported';
 import { type ZipEntryLoadFailedEventPayload } from './operational/zipEntryLoadFailed';
@@ -13,4 +14,4 @@ import { type FailedPreviewDownloadButtonClickedEventPayload } from './ui/failed
 import { type NavigatedEventPayload } from './ui/navigated';
 import { type ZoomInButtonClickEventPayload } from './ui/zoomInButtonClicked';
 import { type ZoomOutButtonClickEventPayload } from './ui/zoomOutButtonClicked';
-export type MediaViewerEventPayload = CommencedEventPayload | LoadFailedEventPayload | LoadSucceededEventPayload | PreviewUnsupportedEventPayload | ZipEntryLoadFailedEventPayload | ZipEntryLoadSucceededEventPayload | ModalEventPayload | PdfPasswordInputScreenEventPayload | PasswordPdfScreenEventPayload | ClosedEventPayload | DownloadButtonClickedEventPayload | FailedPreviewDownloadButtonClickedEventPayload | NavigatedEventPayload | ZoomInButtonClickEventPayload | ZoomOutButtonClickEventPayload;
+export type MediaViewerEventPayload = CommencedEventPayload | LoadFailedEventPayload | LoadSucceededEventPayload | PreviewUnsupportedEventPayload | ZipEntryLoadFailedEventPayload | ZipEntryLoadSucceededEventPayload | ModalEventPayload | PdfPasswordInputScreenEventPayload | PasswordPdfScreenEventPayload | ClosedEventPayload | DownloadButtonClickedEventPayload | FailedPreviewDownloadButtonClickedEventPayload | NavigatedEventPayload | ZoomInButtonClickEventPayload | ZoomOutButtonClickEventPayload | DownloadFailedEventPayload | DownloadSucceededEventPayload;

package/dist/types/analytics/events/operational/_mediaFile.d.ts

@@ -1,3 +1,3 @@
 import { type OperationalEventPayload, type OperationalAttributes } from '@atlaskit/media-common';
 /** common definition used by other mediaFile events */
-export type MediaFileEventPayload<Attributes extends OperationalAttributes, Action extends 'commenced' | 'loadSucceeded' | 'loadFailed' | 'previewUnsupported' | 'zipEntryLoadSucceeded' | 'zipEntryLoadFailed'> = OperationalEventPayload<Attributes, Action, 'mediaFile'>;
+export type MediaFileEventPayload<Attributes extends OperationalAttributes, Action extends 'commenced' | 'loadSucceeded' | 'loadFailed' | 'previewUnsupported' | 'zipEntryLoadSucceeded' | 'zipEntryLoadFailed' | 'downloadSucceeded' | 'downloadFailed'> = OperationalEventPayload<Attributes, Action, 'mediaFile'>;