@atlaskit/media-client 28.1.0 → 28.3.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @atlaskit/media-client
 
+## 28.3.0
+
+### Minor Changes
+
+- [#163838](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/pull-requests/163838)
+  [`c3fcf9a7c2028`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/c3fcf9a7c2028) -
+  Media Client File Download throws Request errors due to failed connection (Not streaming errors)
+
+## 28.2.0
+
+### Minor Changes
+
+- [`6099ac032dd30`](https://stash.atlassian.com/projects/CONFCLOUD/repos/confluence-frontend/commits/6099ac032dd30) -
+  Added viewerOptions to override file preview renderer in media components
+
 ## 28.1.0
 
 ### Minor Changes

package/dist/cjs/client/file-fetcher/index.js

@@ -474,6 +474,7 @@ var FileFetcherImpl = exports.FileFetcherImpl = /*#__PURE__*/function () {
       var _downloadBinary = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee5(id) {
         var name,
           collectionName,
+          traceContext,
           url,
           _args5 = arguments;
         return _regenerator.default.wrap(function _callee5$(_context5) {
@@ -481,9 +482,10 @@ var FileFetcherImpl = exports.FileFetcherImpl = /*#__PURE__*/function () {
             case 0:
               name = _args5.length > 1 && _args5[1] !== undefined ? _args5[1] : 'download';
               collectionName = _args5.length > 2 ? _args5[2] : undefined;
-              _context5.next = 4;
+              traceContext = _args5.length > 3 ? _args5[3] : undefined;
+              _context5.next = 5;
               return this.mediaApi.getFileBinaryURL(id, collectionName);
-            case 4:
+            case 5:
               url = _context5.sent;
               (0, _downloadUrl.downloadUrl)(url, {
                 name: name
@@ -493,7 +495,12 @@ var FileFetcherImpl = exports.FileFetcherImpl = /*#__PURE__*/function () {
                 isUserCollection: collectionName === _constants.RECENTS_COLLECTION,
                 viewingLevel: 'download'
               });
-            case 7:
+              // Test the download after initiated the Browser process to catch any potential errors.
+              _context5.next = 10;
+              return this.mediaApi.testUrl(url, {
+                traceContext: traceContext
+              });
+            case 10:
             case "end":
               return _context5.stop();
           }

package/dist/cjs/client/media-store/MediaStore.js

@@ -11,7 +11,6 @@ var _classCallCheck2 = _interopRequireDefault(require("@babel/runtime/helpers/cl
 var _createClass2 = _interopRequireDefault(require("@babel/runtime/helpers/createClass"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _mediaCore = require("@atlaskit/media-core");
-var _mediaCommon = require("@atlaskit/media-common");
 var _constants = require("../../constants");
 var _artifacts = require("../../models/artifacts");
 var _request3 = require("../../utils/request");
@@ -308,7 +307,7 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
   }, {
     key: "getFileBinary",
     value: function () {
-      var _getFileBinary = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee5(id, collectionName) {
+      var _getFileBinary = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee5(id, collectionName, abortController) {
         var maxAge,
           headers,
           binaryEndpoint,
@@ -318,7 +317,7 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
         return _regenerator.default.wrap(function _callee5$(_context5) {
           while (1) switch (_context5.prev = _context5.next) {
             case 0:
-              maxAge = _args5.length > 2 && _args5[2] !== undefined ? _args5[2] : _constants.FILE_CACHE_MAX_AGE;
+              maxAge = _args5.length > 3 && _args5[3] !== undefined ? _args5[3] : _constants.FILE_CACHE_MAX_AGE;
               headers = {};
               binaryEndpoint = cdnFeatureFlag('binary');
               metadata = {
@@ -335,14 +334,14 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
                   'max-age': "".concat(maxAge)
                 }
               });
-              return _context5.abrupt("return", this.request("/file/".concat(id, "/").concat(binaryEndpoint), options, undefined, true).then((0, _helpers.createMapResponseToBlob)(metadata)));
+              return _context5.abrupt("return", this.request("/file/".concat(id, "/").concat(binaryEndpoint), options, abortController, true).then((0, _helpers.createMapResponseToBlob)(metadata)));
             case 6:
             case "end":
               return _context5.stop();
           }
         }, _callee5, this);
       }));
-      function getFileBinary(_x14, _x15) {
+      function getFileBinary(_x14, _x15, _x16) {
         return _getFileBinary.apply(this, arguments);
       }
       return getFileBinary;
@@ -382,7 +381,7 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
           }
         }, _callee6, this);
       }));
-      function getFileBinaryURL(_x16, _x17) {
+      function getFileBinaryURL(_x17, _x18) {
         return _getFileBinaryURL.apply(this, arguments);
       }
       return getFileBinaryURL;
@@ -422,7 +421,7 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
           }
         }, _callee7, this);
       }));
-      function getArtifactURL(_x18, _x19, _x20) {
+      function getArtifactURL(_x19, _x20, _x21) {
         return _getArtifactURL.apply(this, arguments);
       }
       return getArtifactURL;
@@ -462,7 +461,7 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
           }
         }, _callee8, this);
       }));
-      function getImage(_x21, _x22, _x23, _x24, _x25) {
+      function getImage(_x22, _x23, _x24, _x25, _x26) {
         return _getImage.apply(this, arguments);
       }
       return getImage;
@@ -503,7 +502,7 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
           }
         }, _callee9, this);
       }));
-      function getItems(_x26, _x27, _x28) {
+      function getItems(_x27, _x28, _x29) {
         return _getItems.apply(this, arguments);
       }
       return getItems;
@@ -534,7 +533,7 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
           }
         }, _callee10, this);
       }));
-      function getImageMetadata(_x29, _x30, _x31) {
+      function getImageMetadata(_x30, _x31, _x32) {
         return _getImageMetadata.apply(this, arguments);
       }
       return getImageMetadata;
@@ -567,7 +566,7 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
           }
         }, _callee11, this);
       }));
-      function appendChunksToUpload(_x32, _x33, _x34, _x35) {
+      function appendChunksToUpload(_x33, _x34, _x35, _x36) {
         return _appendChunksToUpload.apply(this, arguments);
       }
       return appendChunksToUpload;
@@ -612,6 +611,7 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
           auth,
           clientId,
           extendedTraceContext,
+          extendedParams,
           url,
           response,
           _args12 = arguments;
@@ -631,42 +631,74 @@ var MediaStore = exports.MediaStore = /*#__PURE__*/function () {
             case 6:
               auth = _context12.sent;
               clientId = (0, _mediaCore.isClientBasedAuth)(auth) ? auth.clientId : undefined;
-              extendedTraceContext = traceContext ? _objectSpread(_objectSpread({}, traceContext), {}, {
-                spanId: (traceContext === null || traceContext === void 0 ? void 0 : traceContext.spanId) || (0, _mediaCommon.getRandomHex)(8)
-              }) : undefined;
+              extendedTraceContext = (0, _helpers.extendTraceContext)(traceContext);
+              extendedParams = addMediaClientParam ? _objectSpread(_objectSpread({}, params), {}, {
+                clientId: clientId
+              }) : params;
               url = "".concat(auth.baseUrl).concat(path);
               if (useMediaCdn) {
                 url = (0, _mediaCdn.mapToMediaCdnUrl)(url, auth.token);
               }
-              _context12.next = 13;
+              _context12.next = 14;
               return (0, _request3.request)(url, {
                 method: method,
                 endpoint: endpoint,
                 auth: auth,
-                params: addMediaClientParam ? _objectSpread(_objectSpread({}, params), {}, {
-                  clientId: clientId
-                }) : params,
+                params: extendedParams,
                 headers: headers,
                 body: body,
                 clientOptions: clientOptions,
                 traceContext: extendedTraceContext
               }, controller);
-            case 13:
+            case 14:
               response = _context12.sent;
               setKeyValueInSessionStorage(MEDIA_API_REGION, response.headers.get('x-media-region'));
               setKeyValueInSessionStorage(MEDIA_API_ENVIRONMENT, response.headers.get('x-media-env'));
               return _context12.abrupt("return", response);
-            case 17:
+            case 18:
             case "end":
               return _context12.stop();
           }
         }, _callee12, this);
       }));
-      function request(_x36) {
+      function request(_x37) {
         return _request2.apply(this, arguments);
       }
       return request;
     }()
+  }, {
+    key: "testUrl",
+    value: function () {
+      var _testUrl = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee13(url) {
+        var options,
+          traceContext,
+          _args13 = arguments;
+        return _regenerator.default.wrap(function _callee13$(_context13) {
+          while (1) switch (_context13.prev = _context13.next) {
+            case 0:
+              options = _args13.length > 1 && _args13[1] !== undefined ? _args13[1] : {};
+              traceContext = options.traceContext;
+              _context13.next = 4;
+              return (0, _request3.request)(url, {
+                method: 'HEAD',
+                traceContext: (0, _helpers.extendTraceContext)(traceContext),
+                clientOptions: {
+                  retryOptions: {
+                    maxAttempts: 1
+                  }
+                }
+              });
+            case 4:
+            case "end":
+              return _context13.stop();
+          }
+        }, _callee13);
+      }));
+      function testUrl(_x38) {
+        return _testUrl.apply(this, arguments);
+      }
+      return testUrl;
+    }()
   }, {
     key: "chunkHashAlgorithm",
     get: function get() {

package/dist/cjs/utils/request/helpers.js

@@ -13,6 +13,7 @@ exports.createRequestErrorFromResponse = createRequestErrorFromResponse;
 exports.createRequestErrorReason = createRequestErrorReason;
 exports.createUrl = createUrl;
 exports.extendHeaders = extendHeaders;
+exports.extendTraceContext = void 0;
 exports.extractMediaHeaders = extractMediaHeaders;
 exports.fetchRetry = fetchRetry;
 exports.isAbortedRequestError = isAbortedRequestError;
@@ -26,6 +27,7 @@ var _toConsumableArray2 = _interopRequireDefault(require("@babel/runtime/helpers
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 var _mediaCore = require("@atlaskit/media-core");
+var _mediaCommon = require("@atlaskit/media-common");
 var _authQueryParameters = require("../../models/auth-query-parameters");
 var _errors = require("./errors");
 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; }
@@ -46,6 +48,11 @@ function isFetchNetworkError(err) {
 function isRateLimitedError(error) {
   return !!error && (0, _errors.isRequestError)(error) && error.attributes.statusCode === 429 || !!error && !!error.message && error.message.includes('429');
 }
+var extendTraceContext = exports.extendTraceContext = function extendTraceContext(traceContext) {
+  return traceContext ? _objectSpread(_objectSpread({}, traceContext), {}, {
+    spanId: (traceContext === null || traceContext === void 0 ? void 0 : traceContext.spanId) || (0, _mediaCommon.getRandomHex)(8)
+  }) : undefined;
+};
 var ZipkinHeaderKeys = exports.ZipkinHeaderKeys = {
   traceId: 'x-b3-traceid',
   spanId: 'x-b3-spanid',

package/dist/es2019/client/file-fetcher/index.js

@@ -362,7 +362,7 @@ export class FileFetcherImpl {
     setTimeout(onProgress, 0, 0);
     return fromObservable(subject);
   }
-  async downloadBinary(id, name = 'download', collectionName) {
+  async downloadBinary(id, name = 'download', collectionName, traceContext) {
     const url = await this.mediaApi.getFileBinaryURL(id, collectionName);
     downloadUrl(url, {
       name
@@ -372,6 +372,10 @@ export class FileFetcherImpl {
       isUserCollection: collectionName === RECENTS_COLLECTION,
       viewingLevel: 'download'
     });
+    // Test the download after initiated the Browser process to catch any potential errors.
+    await this.mediaApi.testUrl(url, {
+      traceContext
+    });
   }
   async copyFile(source, destination, options = {}, traceContext) {
     const {

package/dist/es2019/client/media-store/MediaStore.js

@@ -1,10 +1,9 @@
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
 import { isClientBasedAuth } from '@atlaskit/media-core';
-import { getRandomHex } from '@atlaskit/media-common';
 import { FILE_CACHE_MAX_AGE, MAX_RESOLUTION } from '../../constants';
 import { getArtifactUrl } from '../../models/artifacts';
 import { request } from '../../utils/request';
-import { createUrl, createMapResponseToJson, createMapResponseToBlob } from '../../utils/request/helpers';
+import { createUrl, createMapResponseToJson, createMapResponseToBlob, extendTraceContext } from '../../utils/request/helpers';
 import { mapToMediaCdnUrl } from '../../utils/mediaCdn';
 import { resolveAuth, resolveInitialAuth } from './resolveAuth';
 import { ChunkHashAlgorithm } from '@atlaskit/media-core';
@@ -200,7 +199,7 @@ export class MediaStore {
     const imageEndpoint = cdnFeatureFlag('image');
     return mapToMediaCdnUrl(createUrl(`${auth.baseUrl}/file/${id}/${imageEndpoint}`, options), auth.token);
   }
-  async getFileBinary(id, collectionName, maxAge = FILE_CACHE_MAX_AGE) {
+  async getFileBinary(id, collectionName, abortController, maxAge = FILE_CACHE_MAX_AGE) {
     const headers = {};
     const binaryEndpoint = cdnFeatureFlag('binary');
     const metadata = {
@@ -218,7 +217,7 @@ export class MediaStore {
         'max-age': `${maxAge}`
       }
     };
-    return this.request(`/file/${id}/${binaryEndpoint}`, options, undefined, true).then(createMapResponseToBlob(metadata));
+    return this.request(`/file/${id}/${binaryEndpoint}`, options, abortController, true).then(createMapResponseToBlob(metadata));
   }
   async getFileBinaryURL(id, collectionName, maxAge = FILE_CACHE_MAX_AGE) {
     const auth = await this.resolveAuth({
@@ -368,10 +367,11 @@ export class MediaStore {
     } = options;
     const auth = await this.resolveAuth(authContext);
     const clientId = isClientBasedAuth(auth) ? auth.clientId : undefined;
-    const extendedTraceContext = traceContext ? {
-      ...traceContext,
-      spanId: (traceContext === null || traceContext === void 0 ? void 0 : traceContext.spanId) || getRandomHex(8)
-    } : undefined;
+    const extendedTraceContext = extendTraceContext(traceContext);
+    const extendedParams = addMediaClientParam ? {
+      ...params,
+      clientId
+    } : params;
     let url = `${auth.baseUrl}${path}`;
     if (useMediaCdn) {
       url = mapToMediaCdnUrl(url, auth.token);
@@ -380,10 +380,7 @@ export class MediaStore {
       method,
       endpoint,
       auth,
-      params: addMediaClientParam ? {
-        ...params,
-        clientId
-      } : params,
+      params: extendedParams,
       headers,
       body,
       clientOptions,
@@ -393,6 +390,20 @@ export class MediaStore {
     setKeyValueInSessionStorage(MEDIA_API_ENVIRONMENT, response.headers.get('x-media-env'));
     return response;
   }
+  async testUrl(url, options = {}) {
+    const {
+      traceContext
+    } = options;
+    await request(url, {
+      method: 'HEAD',
+      traceContext: extendTraceContext(traceContext),
+      clientOptions: {
+        retryOptions: {
+          maxAttempts: 1
+        }
+      }
+    });
+  }
   get chunkHashAlgorithm() {
     return this._chunkHashAlgorithm;
   }

package/dist/es2019/utils/request/helpers.js

@@ -1,4 +1,5 @@
 import { isClientBasedAuth } from '@atlaskit/media-core';
+import { getRandomHex } from '@atlaskit/media-common';
 import { mapAuthToQueryParameters } from '../../models/auth-query-parameters';
 import { RequestError, isRequestError } from './errors';
 export function waitPromise(timeout) {
@@ -15,6 +16,10 @@ export function isFetchNetworkError(err) {
 export function isRateLimitedError(error) {
   return !!error && isRequestError(error) && error.attributes.statusCode === 429 || !!error && !!error.message && error.message.includes('429');
 }
+export const extendTraceContext = traceContext => traceContext ? {
+  ...traceContext,
+  spanId: (traceContext === null || traceContext === void 0 ? void 0 : traceContext.spanId) || getRandomHex(8)
+} : undefined;
 export const ZipkinHeaderKeys = {
   traceId: 'x-b3-traceid',
   spanId: 'x-b3-spanid',

package/dist/esm/client/file-fetcher/index.js

@@ -456,6 +456,7 @@ export var FileFetcherImpl = /*#__PURE__*/function () {
       var _downloadBinary = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee5(id) {
         var name,
           collectionName,
+          traceContext,
           url,
           _args5 = arguments;
         return _regeneratorRuntime.wrap(function _callee5$(_context5) {
@@ -463,9 +464,10 @@ export var FileFetcherImpl = /*#__PURE__*/function () {
             case 0:
               name = _args5.length > 1 && _args5[1] !== undefined ? _args5[1] : 'download';
               collectionName = _args5.length > 2 ? _args5[2] : undefined;
-              _context5.next = 4;
+              traceContext = _args5.length > 3 ? _args5[3] : undefined;
+              _context5.next = 5;
               return this.mediaApi.getFileBinaryURL(id, collectionName);
-            case 4:
+            case 5:
               url = _context5.sent;
               downloadUrl(url, {
                 name: name
@@ -475,7 +477,12 @@ export var FileFetcherImpl = /*#__PURE__*/function () {
                 isUserCollection: collectionName === RECENTS_COLLECTION,
                 viewingLevel: 'download'
               });
-            case 7:
+              // Test the download after initiated the Browser process to catch any potential errors.
+              _context5.next = 10;
+              return this.mediaApi.testUrl(url, {
+                traceContext: traceContext
+              });
+            case 10:
             case "end":
               return _context5.stop();
           }

package/dist/esm/client/media-store/MediaStore.js

@@ -6,11 +6,10 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
 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) { _defineProperty(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; }
 import { isClientBasedAuth } from '@atlaskit/media-core';
-import { getRandomHex } from '@atlaskit/media-common';
 import { FILE_CACHE_MAX_AGE, MAX_RESOLUTION } from '../../constants';
 import { getArtifactUrl } from '../../models/artifacts';
 import { request as _request } from '../../utils/request';
-import { createUrl, createMapResponseToJson, createMapResponseToBlob } from '../../utils/request/helpers';
+import { createUrl, createMapResponseToJson, createMapResponseToBlob, extendTraceContext } from '../../utils/request/helpers';
 import { mapToMediaCdnUrl } from '../../utils/mediaCdn';
 import { resolveAuth, resolveInitialAuth } from './resolveAuth';
 import { ChunkHashAlgorithm } from '@atlaskit/media-core';
@@ -302,7 +301,7 @@ export var MediaStore = /*#__PURE__*/function () {
   }, {
     key: "getFileBinary",
     value: function () {
-      var _getFileBinary = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee5(id, collectionName) {
+      var _getFileBinary = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee5(id, collectionName, abortController) {
         var maxAge,
           headers,
           binaryEndpoint,
@@ -312,7 +311,7 @@ export var MediaStore = /*#__PURE__*/function () {
         return _regeneratorRuntime.wrap(function _callee5$(_context5) {
           while (1) switch (_context5.prev = _context5.next) {
             case 0:
-              maxAge = _args5.length > 2 && _args5[2] !== undefined ? _args5[2] : FILE_CACHE_MAX_AGE;
+              maxAge = _args5.length > 3 && _args5[3] !== undefined ? _args5[3] : FILE_CACHE_MAX_AGE;
               headers = {};
               binaryEndpoint = cdnFeatureFlag('binary');
               metadata = {
@@ -329,14 +328,14 @@ export var MediaStore = /*#__PURE__*/function () {
                   'max-age': "".concat(maxAge)
                 }
               });
-              return _context5.abrupt("return", this.request("/file/".concat(id, "/").concat(binaryEndpoint), options, undefined, true).then(createMapResponseToBlob(metadata)));
+              return _context5.abrupt("return", this.request("/file/".concat(id, "/").concat(binaryEndpoint), options, abortController, true).then(createMapResponseToBlob(metadata)));
             case 6:
             case "end":
               return _context5.stop();
           }
         }, _callee5, this);
       }));
-      function getFileBinary(_x14, _x15) {
+      function getFileBinary(_x14, _x15, _x16) {
         return _getFileBinary.apply(this, arguments);
       }
       return getFileBinary;
@@ -376,7 +375,7 @@ export var MediaStore = /*#__PURE__*/function () {
           }
         }, _callee6, this);
       }));
-      function getFileBinaryURL(_x16, _x17) {
+      function getFileBinaryURL(_x17, _x18) {
         return _getFileBinaryURL.apply(this, arguments);
       }
       return getFileBinaryURL;
@@ -416,7 +415,7 @@ export var MediaStore = /*#__PURE__*/function () {
           }
         }, _callee7, this);
       }));
-      function getArtifactURL(_x18, _x19, _x20) {
+      function getArtifactURL(_x19, _x20, _x21) {
         return _getArtifactURL.apply(this, arguments);
       }
       return getArtifactURL;
@@ -456,7 +455,7 @@ export var MediaStore = /*#__PURE__*/function () {
           }
         }, _callee8, this);
       }));
-      function getImage(_x21, _x22, _x23, _x24, _x25) {
+      function getImage(_x22, _x23, _x24, _x25, _x26) {
         return _getImage.apply(this, arguments);
       }
       return getImage;
@@ -497,7 +496,7 @@ export var MediaStore = /*#__PURE__*/function () {
           }
         }, _callee9, this);
       }));
-      function getItems(_x26, _x27, _x28) {
+      function getItems(_x27, _x28, _x29) {
         return _getItems.apply(this, arguments);
       }
       return getItems;
@@ -528,7 +527,7 @@ export var MediaStore = /*#__PURE__*/function () {
           }
         }, _callee10, this);
       }));
-      function getImageMetadata(_x29, _x30, _x31) {
+      function getImageMetadata(_x30, _x31, _x32) {
         return _getImageMetadata.apply(this, arguments);
       }
       return getImageMetadata;
@@ -561,7 +560,7 @@ export var MediaStore = /*#__PURE__*/function () {
           }
         }, _callee11, this);
       }));
-      function appendChunksToUpload(_x32, _x33, _x34, _x35) {
+      function appendChunksToUpload(_x33, _x34, _x35, _x36) {
         return _appendChunksToUpload.apply(this, arguments);
       }
       return appendChunksToUpload;
@@ -606,6 +605,7 @@ export var MediaStore = /*#__PURE__*/function () {
           auth,
           clientId,
           extendedTraceContext,
+          extendedParams,
           url,
           response,
           _args12 = arguments;
@@ -625,42 +625,74 @@ export var MediaStore = /*#__PURE__*/function () {
             case 6:
               auth = _context12.sent;
               clientId = isClientBasedAuth(auth) ? auth.clientId : undefined;
-              extendedTraceContext = traceContext ? _objectSpread(_objectSpread({}, traceContext), {}, {
-                spanId: (traceContext === null || traceContext === void 0 ? void 0 : traceContext.spanId) || getRandomHex(8)
-              }) : undefined;
+              extendedTraceContext = extendTraceContext(traceContext);
+              extendedParams = addMediaClientParam ? _objectSpread(_objectSpread({}, params), {}, {
+                clientId: clientId
+              }) : params;
               url = "".concat(auth.baseUrl).concat(path);
               if (useMediaCdn) {
                 url = mapToMediaCdnUrl(url, auth.token);
               }
-              _context12.next = 13;
+              _context12.next = 14;
               return _request(url, {
                 method: method,
                 endpoint: endpoint,
                 auth: auth,
-                params: addMediaClientParam ? _objectSpread(_objectSpread({}, params), {}, {
-                  clientId: clientId
-                }) : params,
+                params: extendedParams,
                 headers: headers,
                 body: body,
                 clientOptions: clientOptions,
                 traceContext: extendedTraceContext
               }, controller);
-            case 13:
+            case 14:
               response = _context12.sent;
               setKeyValueInSessionStorage(MEDIA_API_REGION, response.headers.get('x-media-region'));
               setKeyValueInSessionStorage(MEDIA_API_ENVIRONMENT, response.headers.get('x-media-env'));
               return _context12.abrupt("return", response);
-            case 17:
+            case 18:
             case "end":
               return _context12.stop();
           }
         }, _callee12, this);
       }));
-      function request(_x36) {
+      function request(_x37) {
         return _request2.apply(this, arguments);
       }
       return request;
     }()
+  }, {
+    key: "testUrl",
+    value: function () {
+      var _testUrl = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee13(url) {
+        var options,
+          traceContext,
+          _args13 = arguments;
+        return _regeneratorRuntime.wrap(function _callee13$(_context13) {
+          while (1) switch (_context13.prev = _context13.next) {
+            case 0:
+              options = _args13.length > 1 && _args13[1] !== undefined ? _args13[1] : {};
+              traceContext = options.traceContext;
+              _context13.next = 4;
+              return _request(url, {
+                method: 'HEAD',
+                traceContext: extendTraceContext(traceContext),
+                clientOptions: {
+                  retryOptions: {
+                    maxAttempts: 1
+                  }
+                }
+              });
+            case 4:
+            case "end":
+              return _context13.stop();
+          }
+        }, _callee13);
+      }));
+      function testUrl(_x38) {
+        return _testUrl.apply(this, arguments);
+      }
+      return testUrl;
+    }()
   }, {
     key: "chunkHashAlgorithm",
     get: function get() {

package/dist/esm/utils/request/helpers.js

@@ -6,6 +6,7 @@ import _regeneratorRuntime from "@babel/runtime/regenerator";
 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) { _defineProperty(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; }
 import { isClientBasedAuth } from '@atlaskit/media-core';
+import { getRandomHex } from '@atlaskit/media-common';
 import { mapAuthToQueryParameters } from '../../models/auth-query-parameters';
 import { RequestError, isRequestError } from './errors';
 export function waitPromise(timeout) {
@@ -24,6 +25,11 @@ export function isFetchNetworkError(err) {
 export function isRateLimitedError(error) {
   return !!error && isRequestError(error) && error.attributes.statusCode === 429 || !!error && !!error.message && error.message.includes('429');
 }
+export var extendTraceContext = function extendTraceContext(traceContext) {
+  return traceContext ? _objectSpread(_objectSpread({}, traceContext), {}, {
+    spanId: (traceContext === null || traceContext === void 0 ? void 0 : traceContext.spanId) || getRandomHex(8)
+  }) : undefined;
+};
 export var ZipkinHeaderKeys = {
   traceId: 'x-b3-traceid',
   spanId: 'x-b3-spanid',

package/dist/types/client/file-fetcher/index.d.ts

@@ -35,7 +35,7 @@ export interface FileFetcher {
     touchFiles(descriptors: TouchFileDescriptor[], collection?: string, traceContext?: MediaTraceContext): Promise<TouchedFiles>;
     upload(file: UploadableFile, controller?: UploadController, uploadableFileUpfrontIds?: UploadableFileUpfrontIds, traceContext?: MediaTraceContext): MediaSubscribable;
     uploadExternal(url: string, collection?: string, traceContext?: MediaTraceContext): Promise<ExternalUploadPayload>;
-    downloadBinary(id: string, name?: string, collectionName?: string): Promise<void>;
+    downloadBinary(id: string, name?: string, collectionName?: string, traceContext?: MediaTraceContext): Promise<void>;
     getCurrentState(id: string, options?: GetFileOptions): Promise<FileState>;
     copyFile(source: CopySourceFile, destination: CopyDestination, options?: CopyFileOptions, traceContext?: MediaTraceContext): Promise<MediaFile>;
     getFileBinaryURL(id: string, collectionName?: string, maxAge?: number): Promise<string>;
@@ -57,6 +57,6 @@ export declare class FileFetcherImpl implements FileFetcher {
     uploadExternal(url: string, collection?: string, traceContext?: MediaTraceContext): Promise<ExternalUploadPayload>;
     private getUploadingFileStateBase;
     upload(file: UploadableFile, controller?: UploadController, uploadableFileUpfrontIds?: UploadableFileUpfrontIds, traceContext?: MediaTraceContext): MediaSubscribable;
-    downloadBinary(id: string, name?: string, collectionName?: string): Promise<void>;
+    downloadBinary(id: string, name?: string, collectionName?: string, traceContext?: MediaTraceContext): Promise<void>;
     copyFile(source: CopySourceFile, destination: CopyDestination, options?: CopyFileOptions, traceContext?: MediaTraceContext): Promise<MediaFile>;
 }

package/dist/types/client/media-store/MediaStore.d.ts

@@ -18,7 +18,7 @@ export declare class MediaStore implements MediaApi {
     getFileImageURL(id: string, params?: MediaStoreGetFileImageParams): Promise<string>;
     getFileImageURLSync(id: string, params?: MediaStoreGetFileImageParams): string;
     private createFileImageURL;
-    getFileBinary(id: string, collectionName?: string, maxAge?: number): Promise<Blob>;
+    getFileBinary(id: string, collectionName?: string, abortController?: AbortController, maxAge?: number): Promise<Blob>;
     getFileBinaryURL(id: string, collectionName?: string, maxAge?: number): Promise<string>;
     getArtifactURL(artifacts: MediaFileArtifacts, artifactName: keyof MediaFileArtifacts, collectionName?: string): Promise<string>;
     getImage(id: string, params?: MediaStoreGetFileImageParams, controller?: AbortController, fetchMaxRes?: boolean, traceContext?: MediaTraceContext): Promise<Blob>;
@@ -29,6 +29,9 @@ export declare class MediaStore implements MediaApi {
     appendChunksToUpload(uploadId: string, body: AppendChunksToUploadRequestBody, collectionName?: string, traceContext?: MediaTraceContext): Promise<void>;
     copyFileWithToken(body: MediaStoreCopyFileWithTokenBody, params: MediaStoreCopyFileWithTokenParams, traceContext?: MediaTraceContext): Promise<MediaStoreResponse<MediaFile>>;
     request(path: string, options?: MediaStoreRequestOptions, controller?: AbortController, useMediaCdn?: boolean): Promise<Response>;
+    testUrl(url: string, options?: {
+        traceContext?: MediaTraceContext;
+    }): Promise<void>;
     resolveAuth: (authContext?: AuthContext) => Promise<Auth>;
     resolveInitialAuth: () => Auth;
     get chunkHashAlgorithm(): ChunkHashAlgorithm;

package/dist/types/client/media-store/types.d.ts

@@ -156,7 +156,7 @@ export interface MediaApi {
     getFile: (fileId: string, params: MediaStoreGetFileParams, traceContext?: MediaTraceContext) => Promise<MediaStoreResponse<MediaFile>>;
     getFileImageURL: (id: string, params?: MediaStoreGetFileImageParams) => Promise<string>;
     getFileImageURLSync: (id: string, params?: MediaStoreGetFileImageParams) => string;
-    getFileBinary: (id: string, collectionName?: string) => Promise<Blob>;
+    getFileBinary: (id: string, collectionName?: string, abortController?: AbortController) => Promise<Blob>;
     getFileBinaryURL: (id: string, collectionName?: string) => Promise<string>;
     getArtifactURL: (artifacts: MediaFileArtifacts, artifactName: keyof MediaFileArtifacts, collectionName?: string) => Promise<string>;
     getImage: (id: string, params?: MediaStoreGetFileImageParams, controller?: AbortController, fetchMaxRes?: boolean, traceContext?: MediaTraceContext) => Promise<Blob>;
@@ -167,6 +167,9 @@ export interface MediaApi {
     appendChunksToUpload: (uploadId: string, body: AppendChunksToUploadRequestBody, collectionName?: string, traceContext?: MediaTraceContext) => Promise<void>;
     copyFileWithToken: (body: MediaStoreCopyFileWithTokenBody, params: MediaStoreCopyFileWithTokenParams, traceContext?: MediaTraceContext) => Promise<MediaStoreResponse<MediaFile>>;
     request: (path: string, options: MediaStoreRequestOptions, controller?: AbortController) => Promise<Response>;
+    testUrl: (url: string, options?: {
+        traceContext?: MediaTraceContext;
+    }) => Promise<void>;
     resolveAuth: (authContext?: AuthContext) => Promise<Auth>;
     resolveInitialAuth: () => Auth;
 }

package/dist/types/utils/request/helpers.d.ts

@@ -6,6 +6,7 @@ export declare function waitPromise(timeout: number): Promise<void>;
 export declare function isAbortedRequestError(err: any): boolean;
 export declare function isFetchNetworkError(err: any): err is TypeError;
 export declare function isRateLimitedError(error: Error | undefined): boolean;
+export declare const extendTraceContext: (traceContext?: MediaTraceContext) => Required<MediaTraceContext> | undefined;
 export declare const ZipkinHeaderKeys: {
     traceId: string;
     spanId: string;

package/dist/types/utils/request/types.d.ts

@@ -1,6 +1,6 @@
 import { type Auth } from '@atlaskit/media-core';
 import type { MediaTraceContext } from '@atlaskit/media-common';
-export type RequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+export type RequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD';
 export type RequestParams = {
     [key: string]: any;
 };

package/dist/types-ts4.5/client/file-fetcher/index.d.ts

@@ -35,7 +35,7 @@ export interface FileFetcher {
     touchFiles(descriptors: TouchFileDescriptor[], collection?: string, traceContext?: MediaTraceContext): Promise<TouchedFiles>;
     upload(file: UploadableFile, controller?: UploadController, uploadableFileUpfrontIds?: UploadableFileUpfrontIds, traceContext?: MediaTraceContext): MediaSubscribable;
     uploadExternal(url: string, collection?: string, traceContext?: MediaTraceContext): Promise<ExternalUploadPayload>;
-    downloadBinary(id: string, name?: string, collectionName?: string): Promise<void>;
+    downloadBinary(id: string, name?: string, collectionName?: string, traceContext?: MediaTraceContext): Promise<void>;
     getCurrentState(id: string, options?: GetFileOptions): Promise<FileState>;
     copyFile(source: CopySourceFile, destination: CopyDestination, options?: CopyFileOptions, traceContext?: MediaTraceContext): Promise<MediaFile>;
     getFileBinaryURL(id: string, collectionName?: string, maxAge?: number): Promise<string>;
@@ -57,6 +57,6 @@ export declare class FileFetcherImpl implements FileFetcher {
     uploadExternal(url: string, collection?: string, traceContext?: MediaTraceContext): Promise<ExternalUploadPayload>;
     private getUploadingFileStateBase;
     upload(file: UploadableFile, controller?: UploadController, uploadableFileUpfrontIds?: UploadableFileUpfrontIds, traceContext?: MediaTraceContext): MediaSubscribable;
-    downloadBinary(id: string, name?: string, collectionName?: string): Promise<void>;
+    downloadBinary(id: string, name?: string, collectionName?: string, traceContext?: MediaTraceContext): Promise<void>;
     copyFile(source: CopySourceFile, destination: CopyDestination, options?: CopyFileOptions, traceContext?: MediaTraceContext): Promise<MediaFile>;
 }

package/dist/types-ts4.5/client/media-store/MediaStore.d.ts

@@ -18,7 +18,7 @@ export declare class MediaStore implements MediaApi {
     getFileImageURL(id: string, params?: MediaStoreGetFileImageParams): Promise<string>;
     getFileImageURLSync(id: string, params?: MediaStoreGetFileImageParams): string;
     private createFileImageURL;
-    getFileBinary(id: string, collectionName?: string, maxAge?: number): Promise<Blob>;
+    getFileBinary(id: string, collectionName?: string, abortController?: AbortController, maxAge?: number): Promise<Blob>;
     getFileBinaryURL(id: string, collectionName?: string, maxAge?: number): Promise<string>;
     getArtifactURL(artifacts: MediaFileArtifacts, artifactName: keyof MediaFileArtifacts, collectionName?: string): Promise<string>;
     getImage(id: string, params?: MediaStoreGetFileImageParams, controller?: AbortController, fetchMaxRes?: boolean, traceContext?: MediaTraceContext): Promise<Blob>;
@@ -29,6 +29,9 @@ export declare class MediaStore implements MediaApi {
     appendChunksToUpload(uploadId: string, body: AppendChunksToUploadRequestBody, collectionName?: string, traceContext?: MediaTraceContext): Promise<void>;
     copyFileWithToken(body: MediaStoreCopyFileWithTokenBody, params: MediaStoreCopyFileWithTokenParams, traceContext?: MediaTraceContext): Promise<MediaStoreResponse<MediaFile>>;
     request(path: string, options?: MediaStoreRequestOptions, controller?: AbortController, useMediaCdn?: boolean): Promise<Response>;
+    testUrl(url: string, options?: {
+        traceContext?: MediaTraceContext;
+    }): Promise<void>;
     resolveAuth: (authContext?: AuthContext) => Promise<Auth>;
     resolveInitialAuth: () => Auth;
     get chunkHashAlgorithm(): ChunkHashAlgorithm;

package/dist/types-ts4.5/client/media-store/types.d.ts

@@ -156,7 +156,7 @@ export interface MediaApi {
     getFile: (fileId: string, params: MediaStoreGetFileParams, traceContext?: MediaTraceContext) => Promise<MediaStoreResponse<MediaFile>>;
     getFileImageURL: (id: string, params?: MediaStoreGetFileImageParams) => Promise<string>;
     getFileImageURLSync: (id: string, params?: MediaStoreGetFileImageParams) => string;
-    getFileBinary: (id: string, collectionName?: string) => Promise<Blob>;
+    getFileBinary: (id: string, collectionName?: string, abortController?: AbortController) => Promise<Blob>;
     getFileBinaryURL: (id: string, collectionName?: string) => Promise<string>;
     getArtifactURL: (artifacts: MediaFileArtifacts, artifactName: keyof MediaFileArtifacts, collectionName?: string) => Promise<string>;
     getImage: (id: string, params?: MediaStoreGetFileImageParams, controller?: AbortController, fetchMaxRes?: boolean, traceContext?: MediaTraceContext) => Promise<Blob>;
@@ -167,6 +167,9 @@ export interface MediaApi {
     appendChunksToUpload: (uploadId: string, body: AppendChunksToUploadRequestBody, collectionName?: string, traceContext?: MediaTraceContext) => Promise<void>;
     copyFileWithToken: (body: MediaStoreCopyFileWithTokenBody, params: MediaStoreCopyFileWithTokenParams, traceContext?: MediaTraceContext) => Promise<MediaStoreResponse<MediaFile>>;
     request: (path: string, options: MediaStoreRequestOptions, controller?: AbortController) => Promise<Response>;
+    testUrl: (url: string, options?: {
+        traceContext?: MediaTraceContext;
+    }) => Promise<void>;
     resolveAuth: (authContext?: AuthContext) => Promise<Auth>;
     resolveInitialAuth: () => Auth;
 }

package/dist/types-ts4.5/utils/request/helpers.d.ts

@@ -6,6 +6,7 @@ export declare function waitPromise(timeout: number): Promise<void>;
 export declare function isAbortedRequestError(err: any): boolean;
 export declare function isFetchNetworkError(err: any): err is TypeError;
 export declare function isRateLimitedError(error: Error | undefined): boolean;
+export declare const extendTraceContext: (traceContext?: MediaTraceContext) => Required<MediaTraceContext> | undefined;
 export declare const ZipkinHeaderKeys: {
     traceId: string;
     spanId: string;

package/dist/types-ts4.5/utils/request/types.d.ts

@@ -1,6 +1,6 @@
 import { type Auth } from '@atlaskit/media-core';
 import type { MediaTraceContext } from '@atlaskit/media-common';
-export type RequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE';
+export type RequestMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD';
 export type RequestParams = {
     [key: string]: any;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/media-client",
-	"version": "28.1.0",
+	"version": "28.3.0",
 	"description": "Media API Web Client Library",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"