@atlaskit/media-viewer 54.5.10 → 54.5.12

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @atlaskit/media-viewer
 
+## 54.5.12
+
+### Patch Changes
+
+- [`fc42b7257d341`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/fc42b7257d341) -
+  Attach native MediaError diagnostics to videoviewer-playback failures so the existing
+  error/errorDetail analytics fields report a real cause instead of unknown (observability-only, no
+  behaviour change).
+- Updated dependencies
+
+## 54.5.11
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 54.5.10
 
 ### Patch Changes

package/dist/cjs/analytics/index.js

@@ -10,7 +10,7 @@ exports.packageVersion = exports.packageName = void 0;
 var _analytics = require("@atlaskit/media-common/analytics");
 var componentName = exports.component = exports.componentName = 'mediaViewer';
 var packageName = exports.packageName = "@atlaskit/media-viewer";
-var packageVersion = exports.packageVersion = "54.5.9";
+var packageVersion = exports.packageVersion = "54.5.11";
 function getFileAttributes(fileState) {
   if (!fileState) {
     return {

package/dist/cjs/analytics/ufoExperiences.js

@@ -13,7 +13,7 @@ var _platformFeatureFlags = require("@atlaskit/platform-feature-flags");
 function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
 function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { (0, _defineProperty2.default)(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
 var packageName = "@atlaskit/media-viewer";
-var packageVersion = "54.5.9";
+var packageVersion = "54.5.11";
 var ufoExperience;
 var getExperience = function getExperience() {
   if (!ufoExperience) {

package/dist/cjs/errors.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.MediaViewerError = exports.ArchiveViewerError = void 0;
 exports.buildImgErrorDiagnostics = buildImgErrorDiagnostics;
+exports.buildVideoErrorDiagnostics = buildVideoErrorDiagnostics;
 exports.classifyFailedSrc = classifyFailedSrc;
 exports.getErrorDetail = getErrorDetail;
 exports.getPrimaryErrorReason = getPrimaryErrorReason;
@@ -155,4 +156,61 @@ function buildImgErrorDiagnostics(item, event) {
     return "".concat(key, "=").concat(value);
   }).join(', ');
   return new Error(detail);
+}
+
+/**
+ * Human-readable names for the four standard `MediaError.code` values, so the
+ * downstream analytics `error`/`errorDetail` report a meaningful cause instead of
+ * a bare numeric code.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/MediaError/code
+ */
+var MEDIA_ERROR_CODE_NAMES = {
+  1: 'MEDIA_ERR_ABORTED',
+  2: 'MEDIA_ERR_NETWORK',
+  3: 'MEDIA_ERR_DECODE',
+  4: 'MEDIA_ERR_SRC_NOT_SUPPORTED'
+};
+
+/**
+ * Builds a descriptive `secondaryError` for a `<video>` onerror so the downstream
+ * `loadFailed` analytics event reports a meaningful `error`/`errorDetail` instead of
+ * the opaque `unknown`/`unknown`. The returned Error's `message` captures playback
+ * diagnostics as a comma-separated `key=value` string (undefined fields are omitted):
+ * - the native `MediaError.code` and its readable name (e.g. `MEDIA_ERR_DECODE`)
+ * - the native `MediaError.message` (browser-provided detail, often empty)
+ * - the file MIME type and whether it is natively browser-playable
+ * - the file size in bytes (helps distinguish large-file/streaming failures)
+ *
+ * @example
+ * // message:
+ * "mediaErrorCode=3, mediaErrorName=MEDIA_ERR_DECODE, mimeType=video/quicktime, isBrowserPlayable=false, fileSize=734003200"
+ */
+function buildVideoErrorDiagnostics(item, mediaError) {
+  var mimeType = item && !(0, _mediaClient.isErrorFileState)(item) ? item.mimeType : undefined;
+  var isBrowserPlayable = mimeType ? (0, _isMimeTypeSupportedByBrowser.isVideoMimeTypeSupportedByBrowser)(mimeType) : undefined;
+  var fileSize = item && !(0, _mediaClient.isErrorFileState)(item) ? item.size : undefined;
+  var mediaErrorCode = mediaError === null || mediaError === void 0 ? void 0 : mediaError.code;
+  var mediaErrorName = mediaErrorCode !== undefined ? MEDIA_ERROR_CODE_NAMES[mediaErrorCode] : undefined;
+  // A native MediaError.message can be empty; only include it when present.
+  var mediaErrorMessage = (mediaError === null || mediaError === void 0 ? void 0 : mediaError.message) || undefined;
+  var diagnostics = {
+    mediaErrorCode: mediaErrorCode,
+    mediaErrorName: mediaErrorName,
+    mediaErrorMessage: mediaErrorMessage,
+    mimeType: mimeType,
+    isBrowserPlayable: isBrowserPlayable,
+    fileSize: fileSize
+  };
+  var detail = Object.entries(diagnostics).filter(function (_ref7) {
+    var _ref8 = (0, _slicedToArray2.default)(_ref7, 2),
+      value = _ref8[1];
+    return value !== undefined;
+  }).map(function (_ref9) {
+    var _ref0 = (0, _slicedToArray2.default)(_ref9, 2),
+      key = _ref0[0],
+      value = _ref0[1];
+    return "".concat(key, "=").concat(value);
+  }).join(', ');
+  return new Error(detail);
 }

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

@@ -201,7 +201,14 @@ var ArchiveViewerBase = exports.ArchiveViewerBase = /*#__PURE__*/function (_Base
     });
     (0, _defineProperty2.default)(_this, "onViewerError", function (primaryErrorReason, selectedArchiveEntry) {
       return function (error) {
-        return error && (0, _errors.isMediaViewerError)(error) ? _this.onError(new _errors.ArchiveViewerError(primaryErrorReason, error.secondaryError, selectedArchiveEntry)) : _this.onError(new _errors.ArchiveViewerError(primaryErrorReason, error, selectedArchiveEntry));
+        if (error instanceof Error && (0, _errors.isMediaViewerError)(error)) {
+          return _this.onError(new _errors.ArchiveViewerError(primaryErrorReason, error.secondaryError, selectedArchiveEntry));
+        }
+        // The video/audio CustomMediaPlayer surfaces a native `MediaError` (not a
+        // JS `Error`). Convert it into a descriptive diagnostics `Error` so the
+        // downstream analytics report a meaningful cause instead of `unknown`.
+        var secondaryError = error && !(error instanceof Error) ? (0, _errors.buildVideoErrorDiagnostics)(undefined, error) : error !== null && error !== void 0 ? error : undefined;
+        return _this.onError(new _errors.ArchiveViewerError(primaryErrorReason, secondaryError, selectedArchiveEntry));
       };
     });
     (0, _defineProperty2.default)(_this, "onSidebarLoaded", function () {

package/dist/cjs/viewers/video.js

@@ -54,9 +54,18 @@ var VideoViewer = exports.VideoViewer = /*#__PURE__*/function (_BaseViewer) {
         _this.init();
       }
     });
-    (0, _defineProperty2.default)(_this, "onError", function () {
-      var onError = _this.props.onError;
-      onError && onError(new _errors.MediaViewerError('videoviewer-playback'));
+    (0, _defineProperty2.default)(_this, "onError", function (mediaError) {
+      var _this$props2 = _this.props,
+        onError = _this$props2.onError,
+        item = _this$props2.item;
+      var secondaryError;
+      try {
+        secondaryError = (0, _errors.buildVideoErrorDiagnostics)(item, mediaError);
+      } catch (_unused) {
+        // Diagnostics are best-effort: never let them mask the underlying playback failure.
+        secondaryError = undefined;
+      }
+      onError && onError(new _errors.MediaViewerError('videoviewer-playback', secondaryError));
     });
     return _this;
   }
@@ -71,11 +80,11 @@ var VideoViewer = exports.VideoViewer = /*#__PURE__*/function (_BaseViewer) {
   }, {
     key: "renderSuccessful",
     value: function renderSuccessful(content) {
-      var _this$props2 = this.props,
-        item = _this$props2.item,
-        showControls = _this$props2.showControls,
-        previewCount = _this$props2.previewCount,
-        identifier = _this$props2.identifier;
+      var _this$props3 = this.props,
+        item = _this$props3.item,
+        showControls = _this$props3.showControls,
+        previewCount = _this$props3.previewCount,
+        identifier = _this$props3.identifier;
       var useCustomVideoPlayer = !(0, _isIE.isIE)();
       var isAutoPlay = previewCount === 0;
       var hdAvailable = isHDAvailable(item);
@@ -123,11 +132,11 @@ var VideoViewer = exports.VideoViewer = /*#__PURE__*/function (_BaseViewer) {
     key: "init",
     value: function () {
       var _init = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee() {
-        var _this$props3, mediaClient, item, collectionName, contentUrl, _t;
+        var _this$props4, mediaClient, item, collectionName, contentUrl, _t;
         return _regenerator.default.wrap(function (_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
-              _this$props3 = this.props, mediaClient = _this$props3.mediaClient, item = _this$props3.item, collectionName = _this$props3.collectionName;
+              _this$props4 = this.props, mediaClient = _this$props4.mediaClient, item = _this$props4.item, collectionName = _this$props4.collectionName;
               _context.prev = 1;
               if (!(item.status === 'processed')) {
                 _context.next = 4;

package/dist/es2019/analytics/index.js

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

package/dist/es2019/analytics/ufoExperiences.js

@@ -3,7 +3,7 @@ import { getMediaEnvironment, getMediaRegion } from '@atlaskit/media-client';
 import { getFeatureFlagKeysAllProducts } from '@atlaskit/media-common';
 import { fg } from '@atlaskit/platform-feature-flags';
 const packageName = "@atlaskit/media-viewer";
-const packageVersion = "54.5.9";
+const packageVersion = "54.5.11";
 let ufoExperience;
 const getExperience = () => {
   if (!ufoExperience) {

package/dist/es2019/errors.js

@@ -1,5 +1,5 @@
 import { isCommonMediaClientError, isErrorFileState } from '@atlaskit/media-client';
-import { isImageMimeTypeSupportedByBrowser } from '@atlaskit/media-common/isMimeTypeSupportedByBrowser';
+import { isImageMimeTypeSupportedByBrowser, isVideoMimeTypeSupportedByBrowser } from '@atlaskit/media-common/isMimeTypeSupportedByBrowser';
 export class MediaViewerError extends Error {
   constructor(primaryReason, secondaryError) {
     super(primaryReason);
@@ -116,4 +116,52 @@ export function buildImgErrorDiagnostics(item, event) {
   };
   const detail = Object.entries(diagnostics).filter(([, value]) => value !== undefined).map(([key, value]) => `${key}=${value}`).join(', ');
   return new Error(detail);
+}
+
+/**
+ * Human-readable names for the four standard `MediaError.code` values, so the
+ * downstream analytics `error`/`errorDetail` report a meaningful cause instead of
+ * a bare numeric code.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/MediaError/code
+ */
+const MEDIA_ERROR_CODE_NAMES = {
+  1: 'MEDIA_ERR_ABORTED',
+  2: 'MEDIA_ERR_NETWORK',
+  3: 'MEDIA_ERR_DECODE',
+  4: 'MEDIA_ERR_SRC_NOT_SUPPORTED'
+};
+
+/**
+ * Builds a descriptive `secondaryError` for a `<video>` onerror so the downstream
+ * `loadFailed` analytics event reports a meaningful `error`/`errorDetail` instead of
+ * the opaque `unknown`/`unknown`. The returned Error's `message` captures playback
+ * diagnostics as a comma-separated `key=value` string (undefined fields are omitted):
+ * - the native `MediaError.code` and its readable name (e.g. `MEDIA_ERR_DECODE`)
+ * - the native `MediaError.message` (browser-provided detail, often empty)
+ * - the file MIME type and whether it is natively browser-playable
+ * - the file size in bytes (helps distinguish large-file/streaming failures)
+ *
+ * @example
+ * // message:
+ * "mediaErrorCode=3, mediaErrorName=MEDIA_ERR_DECODE, mimeType=video/quicktime, isBrowserPlayable=false, fileSize=734003200"
+ */
+export function buildVideoErrorDiagnostics(item, mediaError) {
+  const mimeType = item && !isErrorFileState(item) ? item.mimeType : undefined;
+  const isBrowserPlayable = mimeType ? isVideoMimeTypeSupportedByBrowser(mimeType) : undefined;
+  const fileSize = item && !isErrorFileState(item) ? item.size : undefined;
+  const mediaErrorCode = mediaError === null || mediaError === void 0 ? void 0 : mediaError.code;
+  const mediaErrorName = mediaErrorCode !== undefined ? MEDIA_ERROR_CODE_NAMES[mediaErrorCode] : undefined;
+  // A native MediaError.message can be empty; only include it when present.
+  const mediaErrorMessage = (mediaError === null || mediaError === void 0 ? void 0 : mediaError.message) || undefined;
+  const diagnostics = {
+    mediaErrorCode,
+    mediaErrorName,
+    mediaErrorMessage,
+    mimeType,
+    isBrowserPlayable,
+    fileSize
+  };
+  const detail = Object.entries(diagnostics).filter(([, value]) => value !== undefined).map(([key, value]) => `${key}=${value}`).join(', ');
+  return new Error(detail);
 }

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

@@ -21,7 +21,7 @@ import { Spinner } from '../../loading';
 import { ENCRYPTED_ENTRY_ERROR_MESSAGE } from './consts';
 import { withAnalyticsEvents } from '@atlaskit/analytics-next';
 import { fireAnalytics } from '../../analytics';
-import { ArchiveViewerError, isMediaViewerError } from '../../errors';
+import { ArchiveViewerError, buildVideoErrorDiagnostics, isMediaViewerError } from '../../errors';
 import { createZipEntryLoadSucceededEvent } from '../../analytics/events/operational/zipEntryLoadSucceeded';
 import { createZipEntryLoadFailedEvent } from '../../analytics/events/operational/zipEntryLoadFailed';
 import { createPreviewUnsupportedEvent } from '../../analytics/events/operational/previewUnsupported';
@@ -129,7 +129,16 @@ export class ArchiveViewerBase extends BaseViewer {
     _defineProperty(this, "onViewerLoad", selectedArchiveEntry => () => {
       fireAnalytics(createZipEntryLoadSucceededEvent(this.props.item, selectedArchiveEntry), this.props.createAnalyticsEvent);
     });
-    _defineProperty(this, "onViewerError", (primaryErrorReason, selectedArchiveEntry) => error => error && isMediaViewerError(error) ? this.onError(new ArchiveViewerError(primaryErrorReason, error.secondaryError, selectedArchiveEntry)) : this.onError(new ArchiveViewerError(primaryErrorReason, error, selectedArchiveEntry)));
+    _defineProperty(this, "onViewerError", (primaryErrorReason, selectedArchiveEntry) => error => {
+      if (error instanceof Error && isMediaViewerError(error)) {
+        return this.onError(new ArchiveViewerError(primaryErrorReason, error.secondaryError, selectedArchiveEntry));
+      }
+      // The video/audio CustomMediaPlayer surfaces a native `MediaError` (not a
+      // JS `Error`). Convert it into a descriptive diagnostics `Error` so the
+      // downstream analytics report a meaningful cause instead of `unknown`.
+      const secondaryError = error && !(error instanceof Error) ? buildVideoErrorDiagnostics(undefined, error) : error !== null && error !== void 0 ? error : undefined;
+      return this.onError(new ArchiveViewerError(primaryErrorReason, secondaryError, selectedArchiveEntry));
+    });
     _defineProperty(this, "onSidebarLoaded", () => {
       this.setState({
         content: Outcome.successful({

package/dist/es2019/viewers/video.js

@@ -3,7 +3,7 @@ import React from 'react';
 import { getArtifactUrl, globalMediaEventEmitter, isFileIdentifier } from '@atlaskit/media-client';
 import { CustomMediaPlayer, MediaPlayer } from '@atlaskit/media-ui';
 import { Outcome } from '../domain';
-import { MediaViewerError } from '../errors';
+import { buildVideoErrorDiagnostics, MediaViewerError } from '../errors';
 import { Video, CustomVideoPlayerWrapper } from '../styleWrappers';
 import { isIE } from '../utils/isIE';
 import { BaseViewer } from './base-viewer';
@@ -34,11 +34,19 @@ export class VideoViewer extends BaseViewer {
         this.init();
       }
     });
-    _defineProperty(this, "onError", () => {
+    _defineProperty(this, "onError", mediaError => {
       const {
-        onError
+        onError,
+        item
       } = this.props;
-      onError && onError(new MediaViewerError('videoviewer-playback'));
+      let secondaryError;
+      try {
+        secondaryError = buildVideoErrorDiagnostics(item, mediaError);
+      } catch {
+        // Diagnostics are best-effort: never let them mask the underlying playback failure.
+        secondaryError = undefined;
+      }
+      onError && onError(new MediaViewerError('videoviewer-playback', secondaryError));
     });
   }
   get initialState() {

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 = "54.5.9";
+var packageVersion = "54.5.11";
 export { packageName, packageVersion, componentName, componentName as component };
 export function getFileAttributes(fileState) {
   if (!fileState) {

package/dist/esm/analytics/ufoExperiences.js

@@ -6,7 +6,7 @@ import { getMediaEnvironment, getMediaRegion } from '@atlaskit/media-client';
 import { getFeatureFlagKeysAllProducts } from '@atlaskit/media-common';
 import { fg } from '@atlaskit/platform-feature-flags';
 var packageName = "@atlaskit/media-viewer";
-var packageVersion = "54.5.9";
+var packageVersion = "54.5.11";
 var ufoExperience;
 var getExperience = function getExperience() {
   if (!ufoExperience) {

package/dist/esm/errors.js

@@ -8,7 +8,7 @@ import _wrapNativeSuper from "@babel/runtime/helpers/wrapNativeSuper";
 function _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
 function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
 import { isCommonMediaClientError, isErrorFileState } from '@atlaskit/media-client';
-import { isImageMimeTypeSupportedByBrowser } from '@atlaskit/media-common/isMimeTypeSupportedByBrowser';
+import { isImageMimeTypeSupportedByBrowser, isVideoMimeTypeSupportedByBrowser } from '@atlaskit/media-common/isMimeTypeSupportedByBrowser';
 export var MediaViewerError = /*#__PURE__*/function (_Error) {
   function MediaViewerError(primaryReason, secondaryError) {
     var _this;
@@ -140,4 +140,61 @@ export function buildImgErrorDiagnostics(item, event) {
     return "".concat(key, "=").concat(value);
   }).join(', ');
   return new Error(detail);
+}
+
+/**
+ * Human-readable names for the four standard `MediaError.code` values, so the
+ * downstream analytics `error`/`errorDetail` report a meaningful cause instead of
+ * a bare numeric code.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/MediaError/code
+ */
+var MEDIA_ERROR_CODE_NAMES = {
+  1: 'MEDIA_ERR_ABORTED',
+  2: 'MEDIA_ERR_NETWORK',
+  3: 'MEDIA_ERR_DECODE',
+  4: 'MEDIA_ERR_SRC_NOT_SUPPORTED'
+};
+
+/**
+ * Builds a descriptive `secondaryError` for a `<video>` onerror so the downstream
+ * `loadFailed` analytics event reports a meaningful `error`/`errorDetail` instead of
+ * the opaque `unknown`/`unknown`. The returned Error's `message` captures playback
+ * diagnostics as a comma-separated `key=value` string (undefined fields are omitted):
+ * - the native `MediaError.code` and its readable name (e.g. `MEDIA_ERR_DECODE`)
+ * - the native `MediaError.message` (browser-provided detail, often empty)
+ * - the file MIME type and whether it is natively browser-playable
+ * - the file size in bytes (helps distinguish large-file/streaming failures)
+ *
+ * @example
+ * // message:
+ * "mediaErrorCode=3, mediaErrorName=MEDIA_ERR_DECODE, mimeType=video/quicktime, isBrowserPlayable=false, fileSize=734003200"
+ */
+export function buildVideoErrorDiagnostics(item, mediaError) {
+  var mimeType = item && !isErrorFileState(item) ? item.mimeType : undefined;
+  var isBrowserPlayable = mimeType ? isVideoMimeTypeSupportedByBrowser(mimeType) : undefined;
+  var fileSize = item && !isErrorFileState(item) ? item.size : undefined;
+  var mediaErrorCode = mediaError === null || mediaError === void 0 ? void 0 : mediaError.code;
+  var mediaErrorName = mediaErrorCode !== undefined ? MEDIA_ERROR_CODE_NAMES[mediaErrorCode] : undefined;
+  // A native MediaError.message can be empty; only include it when present.
+  var mediaErrorMessage = (mediaError === null || mediaError === void 0 ? void 0 : mediaError.message) || undefined;
+  var diagnostics = {
+    mediaErrorCode: mediaErrorCode,
+    mediaErrorName: mediaErrorName,
+    mediaErrorMessage: mediaErrorMessage,
+    mimeType: mimeType,
+    isBrowserPlayable: isBrowserPlayable,
+    fileSize: fileSize
+  };
+  var detail = Object.entries(diagnostics).filter(function (_ref7) {
+    var _ref8 = _slicedToArray(_ref7, 2),
+      value = _ref8[1];
+    return value !== undefined;
+  }).map(function (_ref9) {
+    var _ref0 = _slicedToArray(_ref9, 2),
+      key = _ref0[0],
+      value = _ref0[1];
+    return "".concat(key, "=").concat(value);
+  }).join(', ');
+  return new Error(detail);
 }

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

@@ -32,7 +32,7 @@ import { Spinner } from '../../loading';
 import { ENCRYPTED_ENTRY_ERROR_MESSAGE } from './consts';
 import { withAnalyticsEvents } from '@atlaskit/analytics-next';
 import { fireAnalytics } from '../../analytics';
-import { ArchiveViewerError, isMediaViewerError } from '../../errors';
+import { ArchiveViewerError, buildVideoErrorDiagnostics, isMediaViewerError } from '../../errors';
 import { createZipEntryLoadSucceededEvent } from '../../analytics/events/operational/zipEntryLoadSucceeded';
 import { createZipEntryLoadFailedEvent } from '../../analytics/events/operational/zipEntryLoadFailed';
 import { createPreviewUnsupportedEvent } from '../../analytics/events/operational/previewUnsupported';
@@ -195,7 +195,14 @@ export var ArchiveViewerBase = /*#__PURE__*/function (_BaseViewer) {
     });
     _defineProperty(_this, "onViewerError", function (primaryErrorReason, selectedArchiveEntry) {
       return function (error) {
-        return error && isMediaViewerError(error) ? _this.onError(new ArchiveViewerError(primaryErrorReason, error.secondaryError, selectedArchiveEntry)) : _this.onError(new ArchiveViewerError(primaryErrorReason, error, selectedArchiveEntry));
+        if (error instanceof Error && isMediaViewerError(error)) {
+          return _this.onError(new ArchiveViewerError(primaryErrorReason, error.secondaryError, selectedArchiveEntry));
+        }
+        // The video/audio CustomMediaPlayer surfaces a native `MediaError` (not a
+        // JS `Error`). Convert it into a descriptive diagnostics `Error` so the
+        // downstream analytics report a meaningful cause instead of `unknown`.
+        var secondaryError = error && !(error instanceof Error) ? buildVideoErrorDiagnostics(undefined, error) : error !== null && error !== void 0 ? error : undefined;
+        return _this.onError(new ArchiveViewerError(primaryErrorReason, secondaryError, selectedArchiveEntry));
       };
     });
     _defineProperty(_this, "onSidebarLoaded", function () {

package/dist/esm/viewers/video.js

@@ -12,7 +12,7 @@ import React from 'react';
 import { getArtifactUrl, globalMediaEventEmitter, isFileIdentifier } from '@atlaskit/media-client';
 import { CustomMediaPlayer, MediaPlayer } from '@atlaskit/media-ui';
 import { Outcome } from '../domain';
-import { MediaViewerError } from '../errors';
+import { buildVideoErrorDiagnostics, MediaViewerError } from '../errors';
 import { Video, CustomVideoPlayerWrapper } from '../styleWrappers';
 import { isIE } from '../utils/isIE';
 import { BaseViewer } from './base-viewer';
@@ -47,9 +47,18 @@ export var VideoViewer = /*#__PURE__*/function (_BaseViewer) {
         _this.init();
       }
     });
-    _defineProperty(_this, "onError", function () {
-      var onError = _this.props.onError;
-      onError && onError(new MediaViewerError('videoviewer-playback'));
+    _defineProperty(_this, "onError", function (mediaError) {
+      var _this$props2 = _this.props,
+        onError = _this$props2.onError,
+        item = _this$props2.item;
+      var secondaryError;
+      try {
+        secondaryError = buildVideoErrorDiagnostics(item, mediaError);
+      } catch (_unused) {
+        // Diagnostics are best-effort: never let them mask the underlying playback failure.
+        secondaryError = undefined;
+      }
+      onError && onError(new MediaViewerError('videoviewer-playback', secondaryError));
     });
     return _this;
   }
@@ -64,11 +73,11 @@ export var VideoViewer = /*#__PURE__*/function (_BaseViewer) {
   }, {
     key: "renderSuccessful",
     value: function renderSuccessful(content) {
-      var _this$props2 = this.props,
-        item = _this$props2.item,
-        showControls = _this$props2.showControls,
-        previewCount = _this$props2.previewCount,
-        identifier = _this$props2.identifier;
+      var _this$props3 = this.props,
+        item = _this$props3.item,
+        showControls = _this$props3.showControls,
+        previewCount = _this$props3.previewCount,
+        identifier = _this$props3.identifier;
       var useCustomVideoPlayer = !isIE();
       var isAutoPlay = previewCount === 0;
       var hdAvailable = isHDAvailable(item);
@@ -116,11 +125,11 @@ export var VideoViewer = /*#__PURE__*/function (_BaseViewer) {
     key: "init",
     value: function () {
       var _init = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
-        var _this$props3, mediaClient, item, collectionName, contentUrl, _t;
+        var _this$props4, mediaClient, item, collectionName, contentUrl, _t;
         return _regeneratorRuntime.wrap(function (_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
-              _this$props3 = this.props, mediaClient = _this$props3.mediaClient, item = _this$props3.item, collectionName = _this$props3.collectionName;
+              _this$props4 = this.props, mediaClient = _this$props4.mediaClient, item = _this$props4.item, collectionName = _this$props4.collectionName;
               _context.prev = 1;
               if (!(item.status === 'processed')) {
                 _context.next = 4;

package/dist/types/errors.d.ts

@@ -42,4 +42,19 @@ export declare function classifyFailedSrc(currentSrc?: string): srcType;
  * "mimeType=image/png, isBrowserDecodable=true, naturalWidth=0, naturalHeight=0, failedSrcType=blob"
  */
 export declare function buildImgErrorDiagnostics(item: FileState | undefined, event?: SyntheticEvent<HTMLImageElement, Event>): Error;
+/**
+ * Builds a descriptive `secondaryError` for a `<video>` onerror so the downstream
+ * `loadFailed` analytics event reports a meaningful `error`/`errorDetail` instead of
+ * the opaque `unknown`/`unknown`. The returned Error's `message` captures playback
+ * diagnostics as a comma-separated `key=value` string (undefined fields are omitted):
+ * - the native `MediaError.code` and its readable name (e.g. `MEDIA_ERR_DECODE`)
+ * - the native `MediaError.message` (browser-provided detail, often empty)
+ * - the file MIME type and whether it is natively browser-playable
+ * - the file size in bytes (helps distinguish large-file/streaming failures)
+ *
+ * @example
+ * // message:
+ * "mediaErrorCode=3, mediaErrorName=MEDIA_ERR_DECODE, mimeType=video/quicktime, isBrowserPlayable=false, fileSize=734003200"
+ */
+export declare function buildVideoErrorDiagnostics(item: FileState | undefined, mediaError?: MediaError | null): Error;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/media-viewer",
-	"version": "54.5.10",
+	"version": "54.5.12",
 	"description": "MediaViewer is Atlassian's powerful solution for viewing files on the web. It's both powerful and extendable yet easy-to-integrate",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -54,7 +54,7 @@
 		"@atlaskit/spinner": "^20.1.0",
 		"@atlaskit/textfield": "^9.1.0",
 		"@atlaskit/theme": "^26.1.0",
-		"@atlaskit/tmp-editor-statsig": "^126.2.0",
+		"@atlaskit/tmp-editor-statsig": "^127.1.0",
 		"@atlaskit/tokens": "^16.0.0",
 		"@atlaskit/tooltip": "^23.1.0",
 		"@atlaskit/ufo": "^1.0.0",