@atlaskit/media-common 2.19.1 → 3.0.0

package/dist/esm/index.js

@@ -1,11 +1,13 @@
-export { downloadUrl } from './downloadUrl'; // Warning! You can't add new media types!
+export { downloadUrl } from './downloadUrl';
+// Warning! You can't add new media types!
 // See packages/media/media-core/src/__tests__/cache-backward-compatibility.spec.ts
 
 // Media Feature Flags
 export { getMediaFeatureFlag, defaultMediaFeatureFlags, areEqualFeatureFlags, useMemoizeFeatureFlags, filterFeatureFlagNames, filterFeatureFlagKeysAllProducts } from './mediaFeatureFlags';
 // Analytics context
-export { withMediaAnalyticsContext } from './analytics/withMediaAnalyticsContext'; // Analytics constants
+export { withMediaAnalyticsContext } from './analytics/withMediaAnalyticsContext';
 
+// Analytics constants
 export { ANALYTICS_MEDIA_CHANNEL } from './analytics/constants';
-export { getMediaTypeFromMimeType, isImageMimeTypeSupportedByBrowser, isDocumentMimeTypeSupportedByBrowser, isMimeTypeSupportedByBrowser, isImageMimeTypeSupportedByServer, isDocumentMimeTypeSupportedByServer, isAudioMimeTypeSupportedByServer, isVideoMimeTypeSupportedByServer, isUnknownMimeTypeSupportedByServer, isMimeTypeSupportedByServer } from './mediaTypeUtils';
+export { getMediaTypeFromMimeType, isImageMimeTypeSupportedByBrowser, isDocumentMimeTypeSupportedByBrowser, isVideoMimeTypeSupportedByBrowser, isMimeTypeSupportedByBrowser, isImageMimeTypeSupportedByServer, isDocumentMimeTypeSupportedByServer, isAudioMimeTypeSupportedByServer, isVideoMimeTypeSupportedByServer, isUnknownMimeTypeSupportedByServer, isMimeTypeSupportedByServer } from './mediaTypeUtils';
 export { isUndefined, pick, omitBy, debounce, matches, getRandomHex } from './utils/helpers';

package/dist/esm/mediaFeatureFlag-local.js

@@ -2,8 +2,8 @@
 export var getLocalMediaFeatureFlag = function getLocalMediaFeatureFlag(key) {
   try {
     return typeof window !== 'undefined' && window.localStorage ? window.localStorage.getItem(key) : null;
-  } catch (e) {// do nothing, return null by default
+  } catch (e) {
+    // do nothing, return null by default
   }
-
   return null;
 };

package/dist/esm/mediaFeatureFlags/mediaFeatureFlags.js

@@ -7,11 +7,9 @@ export var areEqualFeatureFlags = function areEqualFeatureFlags(ffA, ffB) {
   if (!ffA && !ffB) {
     return true;
   }
-
   if (!ffA || !ffB) {
     return false;
   }
-
   var results = {
     newCardExperience: ffA.newCardExperience === ffB.newCardExperience,
     captions: ffA.captions === ffB.captions,
@@ -19,8 +17,6 @@ export var areEqualFeatureFlags = function areEqualFeatureFlags(ffA, ffB) {
     folderUploads: ffA.folderUploads === ffB.folderUploads,
     observedWidth: ffA.observedWidth === ffB.observedWidth,
     timestampOnVideo: ffA.timestampOnVideo === ffB.timestampOnVideo,
-    // @ts-ignore
-    mediaUploadApiV2: ffA.mediaUploadApiV2 === ffB.mediaUploadApiV2,
     memoryCacheLogging: ffA.memoryCacheLogging === ffB.memoryCacheLogging,
     fetchFileStateAfterUpload: ffA.fetchFileStateAfterUpload === ffB.fetchFileStateAfterUpload
   };
@@ -32,34 +28,32 @@ export var filterFeatureFlagNames = function filterFeatureFlagNames(flags) {
   var pairs = Object.entries(flags);
   return pairs.filter(function (_ref) {
     var _ref2 = _slicedToArray(_ref, 2),
-        _key = _ref2[0],
-        value = _ref2[1];
-
+      _key = _ref2[0],
+      value = _ref2[1];
     return !!value;
   }).map(function (_ref3) {
     var _ref4 = _slicedToArray(_ref3, 1),
-        key = _ref4[0];
-
+      key = _ref4[0];
     return key;
   });
 };
+
 /**
  * Takes a record of {Media Feature Flag Names → boolean} and a supported product name.
  * Returns the corresponding product’s Launch Darkly Keys for each of the flags set as true in the input record.
  * */
-
 export var mapAndFilterFeatureFlagNames = function mapAndFilterFeatureFlagNames(flags, product) {
   var mediaFeatureFlags = filterFeatureFlagNames(flags);
   return mediaFeatureFlags.map(function (key) {
     return getProductKeys()[product][key];
   });
-}; // TODO(MEX-1547): This is temporary solution to just return the launch darkly feature flags for all products.
+};
 
+// TODO(MEX-1547): This is temporary solution to just return the launch darkly feature flags for all products.
 /**
  * Takes a record of {Media Feature Flag Names → boolean}.
  * Returns the Launch Darkly Keys from all products for each of the flags set as true in the input record.
  * */
-
 export var filterFeatureFlagKeysAllProducts = function filterFeatureFlagKeysAllProducts(flags) {
   var filteredFlags = filterFeatureFlagNames(flags);
   var ldFeatureFlags = [];
@@ -71,8 +65,19 @@ export var filterFeatureFlagKeysAllProducts = function filterFeatureFlagKeysAllP
   return ldFeatureFlags.filter(function (flag) {
     return flag !== '';
   });
-}; // default values defined here, not necessary for components to know directly as they should use the function below
+};
 
+/**
+ * defaultMediaFeatureFlags set default values used by the getter function getMediaFeatureFlag
+ *
+ * *************************************
+ * ************* IMPORTANT *************
+ * *************************************
+ * Only in exceptional cases a FF should be 'true' by default.
+ * Making a flag default to 'true' can lead to confusing and unexpected scenarios.
+ * If you must set a flag default = true, whenever you remove that flag
+ * that change should be released as a MAJOR, because it's a breaking change.
+ */
 export var defaultMediaFeatureFlags = {
   newCardExperience: false,
   captions: false,
@@ -82,11 +87,10 @@ export var defaultMediaFeatureFlags = {
   folderUploads: false,
   observedWidth: false,
   timestampOnVideo: false,
-  // @ts-ignore
-  mediaUploadApiV2: true,
   memoryCacheLogging: false,
   fetchFileStateAfterUpload: false
 };
+
 /**
  * Public accessor from components to fallback to defaults if flags not passed,
  * otherwise whatever product has set will be returned.
@@ -97,28 +101,22 @@ export var defaultMediaFeatureFlags = {
  *
  * (you will see a warning in console if override used)
  * */
-
 export function getMediaFeatureFlag(flagName, featureFlags) {
   var devOverride = getLocalMediaFeatureFlag(flagName);
-
   if (devOverride !== null) {
     try {
       return JSON.parse(devOverride);
     } catch (e) {}
   }
-
   if (featureFlags) {
     return flagName in featureFlags ? featureFlags[flagName] : defaultMediaFeatureFlags[flagName];
   }
-
   return defaultMediaFeatureFlags[flagName];
 }
 export var useMemoizeFeatureFlags = function useMemoizeFeatureFlags(featureFlags) {
   var ref = useRef();
-
   if (!areEqualFeatureFlags(featureFlags, ref.current)) {
     ref.current = featureFlags;
   }
-
   return ref.current;
 };

package/dist/esm/mediaFeatureFlags/productKeys.js

@@ -7,8 +7,6 @@ var productKeys = {
     //TODO fill the value after https://product-fabric.atlassian.net/browse/MEX-1593
     observedWidth: '',
     timestampOnVideo: 'confluence.frontend.media.timestamp.on.video',
-    // @ts-ignore
-    mediaUploadApiV2: 'confluence.enable.media.upload.api.v2',
     memoryCacheLogging: 'confluence-frontend-media-card-memory-cache-logging',
     fetchFileStateAfterUpload: 'confluence-frontend-media-client-fetch-file-state-after-upload'
   },
@@ -21,8 +19,6 @@ var productKeys = {
     //TODO fill the value after https://product-fabric.atlassian.net/browse/MEX-1593
     observedWidth: '',
     timestampOnVideo: 'issue.details.media-cards-timestamp-on-video',
-    // @ts-ignore
-    mediaUploadApiV2: 'issue.details.enable-media-upload-api-version-2',
     memoryCacheLogging: 'jira-frontend-media-card-memory-cache-logging',
     fetchFileStateAfterUpload: 'jira-frontend-media-client-fetch-file-state-after-upload'
   }

package/dist/esm/mediaFeatureFlags/types.js

@@ -1,3 +1,5 @@
 // Media feature flags - type and defaults defined here in one source of truth
+
 // With this type we ensure the object will contain all the flags
+
 export var supportedProducts = ['confluence', 'jira'];

package/dist/esm/mediaTypeUtils/index.js

@@ -7,22 +7,17 @@ export var getMediaTypeFromMimeType = function getMediaTypeFromMimeType(mimeType
   if (isArchive(mimeType)) {
     return 'archive';
   }
-
   if (isImageMimeTypeSupportedByBrowser(mimeType) || isImageMimeTypeSupportedByServer(mimeType)) {
     return 'image';
   }
-
   if (isDocumentMimeTypeSupportedByBrowser(mimeType) || isDocumentMimeTypeSupportedByServer(mimeType)) {
     return 'doc';
   }
-
   if (isAudioMimeTypeSupportedByBrowser(mimeType) || isAudioMimeTypeSupportedByServer(mimeType)) {
     return 'audio';
   }
-
   if (isVideoMimeTypeSupportedByBrowser(mimeType) || isVideoMimeTypeSupportedByServer(mimeType)) {
     return 'video';
   }
-
   return 'unknown';
 };

package/dist/esm/mediaTypeUtils/isMimeTypeSupportedByBrowser.js

@@ -1,6 +1,7 @@
 // Based on https://developer.mozilla.org/en-US/docs/Web/Media/Formats/Image_types
 export var isImageMimeTypeSupportedByBrowser = function isImageMimeTypeSupportedByBrowser(mimeType) {
-  return ['image/apng', 'image/bmp', 'image/gif', 'image/x-icon', 'image/jpeg', 'image/png', 'image/webp' //'image/svg+xml', // Removed because of https://product-fabric.atlassian.net/browse/BMPT-625
+  return ['image/apng', 'image/bmp', 'image/gif', 'image/x-icon', 'image/jpeg', 'image/png', 'image/webp'
+  //'image/svg+xml', // Removed because of https://product-fabric.atlassian.net/browse/BMPT-625
   ].indexOf(mimeType.toLowerCase()) > -1;
 };
 export var isDocumentMimeTypeSupportedByBrowser = function isDocumentMimeTypeSupportedByBrowser(mimeType) {
@@ -9,6 +10,7 @@ export var isDocumentMimeTypeSupportedByBrowser = function isDocumentMimeTypeSup
 export var isAudioMimeTypeSupportedByBrowser = function isAudioMimeTypeSupportedByBrowser(mimeType) {
   return ['audio/aac', 'audio/flac', 'audio/mp4', 'audio/mpeg', 'audio/ogg', 'audio/x-ogg', 'audio/wav', 'audio/x-wav'].indexOf(mimeType.toLowerCase()) > -1;
 };
+
 /**
  * For backward compatilbity, we assume MP4/MOV is natively supported.
  * TODO: Improve detection of supported video formats by the browser.
@@ -18,7 +20,6 @@ export var isAudioMimeTypeSupportedByBrowser = function isAudioMimeTypeSupported
  * - https://product-fabric.atlassian.net/browse/EDM-634
  * - https://product-fabric.atlassian.net/browse/EDM-426
  */
-
 export var isVideoMimeTypeSupportedByBrowser = function isVideoMimeTypeSupportedByBrowser(mimeType) {
   return ['video/mp4', 'video/quicktime'].indexOf(mimeType.toLowerCase()) > -1;
 };

package/dist/esm/mediaTypeUtils/isMimeTypeSupportedByServer.js

@@ -3,18 +3,30 @@ export var isImageMimeTypeSupportedByServer = function isImageMimeTypeSupportedB
   return ['image/bmp', 'image/x-windows-bmp', 'application/dicom', 'image/gif', 'image/jpeg', 'image/jpg', 'image/jp_', 'application/jpg', 'application/x-jpg', 'image/png', 'application/png', 'application/x-png', 'application/vnd.adobe.photoshop', 'image/vnd.adobe.photoshop', 'image/photoshop', 'image/x-photoshop', 'image/psd', 'application/photoshop', 'application/psd', 'zz-application/zz-winassoc-psd', 'image/tiff', 'image/x-tif', 'image/x-tiff', 'application/tif', 'application/x-tif', 'application/tiff', 'application/x-tiff', 'image/svg+xml', 'image/heif', 'image/heif-sequence', 'image/heic', 'image/heic-sequence'].indexOf(mimeType.toLowerCase()) > -1;
 };
 export var isDocumentMimeTypeSupportedByServer = function isDocumentMimeTypeSupportedByServer(mimeType) {
-  return [// Adobe PDF
-  'application/pdf', 'application/x-pdf', 'application/acrobat', 'applications/vnd.pdf', 'text/pdf', 'text/x-pdf', // Adobe Illustrator
-  'application/vnd.adobe.illustrator', // Microsoft Office
-  'application/vnd.ms-office', // Microsoft Word
-  'application/msword', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'application/vnd.openxmlformats-officedocument.wordprocessingml.template', 'application/vnd.ms-word.document.macroenabled.12', 'application/vnd.ms-word.template.macroenabled.12', // Microsoft Excel
-  'application/vnd.ms-excel', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 'application/vnd.openxmlformats-officedocument.spreadsheetml.template', 'application/vnd.ms-excel.sheet.macroenabled.12', 'application/vnd.ms-excel.template.macroenabled.12', 'application/vnd.ms-excel.addin.macroenabled.12', 'application/vnd.ms-excel.sheet.macroenabled', 'application/vnd.ms-excel.template.macroenabled', 'application/vnd.ms-excel.addin.macroenabled', // Microsoft Powerpoint
-  'application/vnd.ms-powerpoint', 'application/vnd.openxmlformats-officedocument.presentationml.presentation', 'application/vnd.openxmlformats-officedocument.presentationml.template', 'application/vnd.openxmlformats-officedocument.presentationml.slideshow', 'application/vnd.ms-powerpoint.presentation.macroenabled.12', 'application/vnd.ms-powerpoint.template.macroenabled.12', 'application/vnd.ms-powerpoint.slideshow.macroenabled.12', // OpenOffice
-  'application/vnd.sun.xml.writer', 'application/vnd.sun.xml.writer.template', // OpenDocument
-  'application/vnd.sun.xml.draw', 'application/vnd.sun.xml.draw.template', 'application/vnd.oasis.opendocument.graphics', 'application/vnd.oasis.opendocument.presentation', 'application/x-vnd.oasis.opendocument.presentation', 'application/vnd.sun.xml.calc', 'application/vnd.sun.xml.calc.template', 'application/vnd.oasis.opendocument.spreadsheet', 'application/x-vnd.oasis.opendocument.spreadsheet', 'application/vnd.oasis.opendocument.spreadsheet-template', 'application/vnd.oasis.opendocument.text', 'application/vnd.oasis.opendocument.text-template', 'application/vnd.oasis.opendocument.text-master', 'application/x-vnd.oasis.opendocument.text', 'application/x-vnd.oasis.opendocument.text-template', 'application/x-vnd.oasis.opendocument.text-master', // WordPerfect
-  'application/vnd.wordperfect', // Text files
-  'text/csv', 'text/x-diff', 'text/x-perl', 'text/x-python', 'text/x-ruby', 'text/rtf', 'text/richtext', 'text/plain', 'application/txt', // Rich text
-  'application/rtf', 'application/x-rtf', // PostScript
+  return [
+  // Adobe PDF
+  'application/pdf', 'application/x-pdf', 'application/acrobat', 'applications/vnd.pdf', 'text/pdf', 'text/x-pdf',
+  // Adobe Illustrator
+  'application/vnd.adobe.illustrator',
+  // Microsoft Office
+  'application/vnd.ms-office',
+  // Microsoft Word
+  'application/msword', 'application/vnd.openxmlformats-officedocument.wordprocessingml.document', 'application/vnd.openxmlformats-officedocument.wordprocessingml.template', 'application/vnd.ms-word.document.macroenabled.12', 'application/vnd.ms-word.template.macroenabled.12',
+  // Microsoft Excel
+  'application/vnd.ms-excel', 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet', 'application/vnd.openxmlformats-officedocument.spreadsheetml.template', 'application/vnd.ms-excel.sheet.macroenabled.12', 'application/vnd.ms-excel.template.macroenabled.12', 'application/vnd.ms-excel.addin.macroenabled.12', 'application/vnd.ms-excel.sheet.macroenabled', 'application/vnd.ms-excel.template.macroenabled', 'application/vnd.ms-excel.addin.macroenabled',
+  // Microsoft Powerpoint
+  'application/vnd.ms-powerpoint', 'application/vnd.openxmlformats-officedocument.presentationml.presentation', 'application/vnd.openxmlformats-officedocument.presentationml.template', 'application/vnd.openxmlformats-officedocument.presentationml.slideshow', 'application/vnd.ms-powerpoint.presentation.macroenabled.12', 'application/vnd.ms-powerpoint.template.macroenabled.12', 'application/vnd.ms-powerpoint.slideshow.macroenabled.12',
+  // OpenOffice
+  'application/vnd.sun.xml.writer', 'application/vnd.sun.xml.writer.template',
+  // OpenDocument
+  'application/vnd.sun.xml.draw', 'application/vnd.sun.xml.draw.template', 'application/vnd.oasis.opendocument.graphics', 'application/vnd.oasis.opendocument.presentation', 'application/x-vnd.oasis.opendocument.presentation', 'application/vnd.sun.xml.calc', 'application/vnd.sun.xml.calc.template', 'application/vnd.oasis.opendocument.spreadsheet', 'application/x-vnd.oasis.opendocument.spreadsheet', 'application/vnd.oasis.opendocument.spreadsheet-template', 'application/vnd.oasis.opendocument.text', 'application/vnd.oasis.opendocument.text-template', 'application/vnd.oasis.opendocument.text-master', 'application/x-vnd.oasis.opendocument.text', 'application/x-vnd.oasis.opendocument.text-template', 'application/x-vnd.oasis.opendocument.text-master',
+  // WordPerfect
+  'application/vnd.wordperfect',
+  // Text files
+  'text/csv', 'text/x-diff', 'text/x-perl', 'text/x-python', 'text/x-ruby', 'text/rtf', 'text/richtext', 'text/plain', 'application/txt',
+  // Rich text
+  'application/rtf', 'application/x-rtf',
+  // PostScript
   'application/postscript'].indexOf(mimeType.toLowerCase()) > -1;
 };
 export var isAudioMimeTypeSupportedByServer = function isAudioMimeTypeSupportedByServer(mimeType) {
@@ -22,9 +34,10 @@ export var isAudioMimeTypeSupportedByServer = function isAudioMimeTypeSupportedB
 };
 export var isVideoMimeTypeSupportedByServer = function isVideoMimeTypeSupportedByServer(mimeType) {
   return ['video/3gpp', 'video/3gpp2', 'video/x-ms-asf', 'video/avi', 'video/msvideo', 'video/x-msvideo', 'video/x-dv', 'video/x-flv', 'video/m2ts', 'video/x-m4v', 'video/x-matroska', 'video/quicktime', 'video/mp4', 'video/mpeg', 'video/ogg', 'video/x-ogg', 'video/webm', 'video/x-ms-wmv'].indexOf(mimeType.toLowerCase()) > -1;
-}; // BMPT-620: The backend momentarily returns this mimeType for cloud files imported via dt-api-mediapicker
-// Once these cloud files are processed they are receiving a more relevant mimeType
+};
 
+// BMPT-620: The backend momentarily returns this mimeType for cloud files imported via dt-api-mediapicker
+// Once these cloud files are processed they are receiving a more relevant mimeType
 export var isUnknownMimeTypeSupportedByServer = function isUnknownMimeTypeSupportedByServer(mimeType) {
   return ['binary/octet-stream'].indexOf(mimeType.toLowerCase()) > -1;
 };

package/dist/esm/utils/helpers.js

@@ -5,24 +5,20 @@ export var isUndefined = function isUndefined(value) {
 };
 export var pick = function pick(obj) {
   var keys = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : [];
-
   if (obj === undefined) {
     return {};
   }
-
   return Object.fromEntries(Object.entries(obj).filter(function (_ref) {
     var _ref2 = _slicedToArray(_ref, 1),
-        k = _ref2[0];
-
+      k = _ref2[0];
     return keys.includes(k);
   }));
 };
 export var omitBy = function omitBy(obj, predicate) {
   return Object.fromEntries(Object.entries(obj).filter(function (_ref3) {
     var _ref4 = _slicedToArray(_ref3, 2),
-        k = _ref4[0],
-        v = _ref4[1];
-
+      k = _ref4[0],
+      v = _ref4[1];
     return !predicate(v);
   }));
 };
@@ -32,7 +28,6 @@ export var debounce = function debounce(func, wait) {
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
     }
-
     clearTimeout(timeout);
     timeout = setTimeout(function () {
       return func.apply(void 0, args);
@@ -42,28 +37,22 @@ export var debounce = function debounce(func, wait) {
 export var matches = function matches(srcObj) {
   return function (obj) {
     var key;
-
     for (key in srcObj) {
       if (obj[key] === undefined || obj[key] !== srcObj[key]) {
         return false;
       }
     }
-
     return true;
   };
 };
-
 function getRandomHexValues(byte) {
   return _toConsumableArray(Array(byte * 2)).map(function () {
     return Math.floor(Math.random() * 16).toString(16);
   }).join('');
 }
-
 export function getRandomHex(byte) {
   var _window;
-
   var randomHex;
-
   if ((_window = window) !== null && _window !== void 0 && _window.crypto) {
     try {
       randomHex = Array.from(window.crypto.getRandomValues(new Uint8Array(byte))).map(function (b) {
@@ -75,6 +64,5 @@ export function getRandomHex(byte) {
   } else {
     randomHex = getRandomHexValues(byte);
   }
-
   return randomHex;
 }

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/media-common",
-	"version": "2.19.1",
+	"version": "3.0.0",
 	"sideEffects": false
 }

package/dist/types/index.d.ts

@@ -10,7 +10,7 @@ export interface NumericalCardDimensions {
 export type { PackageAttributes, WithFileAttributes, WithPerformanceAttributes, WithTraceContext, FileAttributes, PerformanceAttributes, SuccessAttributes, FailureAttributes, OperationalAttributes, OperationalEventPayload, UIAttributes, UIEventPayload, ScreenAttributes, ScreenEventPayload, TrackAttributes, TrackEventPayload, ContextPublicAttributes, ContextStaticProps, } from './analytics/types';
 export { withMediaAnalyticsContext } from './analytics/withMediaAnalyticsContext';
 export { ANALYTICS_MEDIA_CHANNEL } from './analytics/constants';
-export { getMediaTypeFromMimeType, isImageMimeTypeSupportedByBrowser, isDocumentMimeTypeSupportedByBrowser, isMimeTypeSupportedByBrowser, isImageMimeTypeSupportedByServer, isDocumentMimeTypeSupportedByServer, isAudioMimeTypeSupportedByServer, isVideoMimeTypeSupportedByServer, isUnknownMimeTypeSupportedByServer, isMimeTypeSupportedByServer, } from './mediaTypeUtils';
+export { getMediaTypeFromMimeType, isImageMimeTypeSupportedByBrowser, isDocumentMimeTypeSupportedByBrowser, isVideoMimeTypeSupportedByBrowser, isMimeTypeSupportedByBrowser, isImageMimeTypeSupportedByServer, isDocumentMimeTypeSupportedByServer, isAudioMimeTypeSupportedByServer, isVideoMimeTypeSupportedByServer, isUnknownMimeTypeSupportedByServer, isMimeTypeSupportedByServer, } from './mediaTypeUtils';
 export declare type SSR = 'client' | 'server';
 export { isUndefined, pick, omitBy, debounce, matches, getRandomHex, } from './utils/helpers';
 export declare type MediaTraceContext = {

package/dist/types/mediaFeatureFlags/mediaFeatureFlags.d.ts

@@ -11,6 +11,17 @@ export declare const mapAndFilterFeatureFlagNames: (flags: RequiredMediaFeatureF
  * Returns the Launch Darkly Keys from all products for each of the flags set as true in the input record.
  * */
 export declare const filterFeatureFlagKeysAllProducts: (flags: RequiredMediaFeatureFlags) => Array<string>;
+/**
+ * defaultMediaFeatureFlags set default values used by the getter function getMediaFeatureFlag
+ *
+ * *************************************
+ * ************* IMPORTANT *************
+ * *************************************
+ * Only in exceptional cases a FF should be 'true' by default.
+ * Making a flag default to 'true' can lead to confusing and unexpected scenarios.
+ * If you must set a flag default = true, whenever you remove that flag
+ * that change should be released as a MAJOR, because it's a breaking change.
+ */
 export declare const defaultMediaFeatureFlags: Required<MediaFeatureFlags>;
 /**
  * Public accessor from components to fallback to defaults if flags not passed,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@atlaskit/media-common",
-  "version": "2.19.1",
+  "version": "3.0.0",
   "description": "Includes common utilities used by other media packages",
   "publishConfig": {
     "registry": "https://registry.npmjs.org/"
@@ -34,7 +34,7 @@
   "dependencies": {
     "@atlaskit/analytics-gas-types": "^5.0.5",
     "@atlaskit/analytics-namespaced-context": "^6.6.0",
-    "@atlaskit/analytics-next": "^8.1.1",
+    "@atlaskit/analytics-next": "^9.0.0",
     "@atlaskit/section-message": "^6.3.0",
     "@babel/runtime": "^7.0.0"
   },

package/report.api.md

@@ -50,7 +50,7 @@ export const debounce: (
   wait: number,
 ) => (...args: any[]) => void;
 
-// @public (undocumented)
+// @public
 export const defaultMediaFeatureFlags: Required<MediaFeatureFlags>;
 
 // @public (undocumented)
@@ -142,6 +142,9 @@ export const isUndefined: (value: any) => boolean;
 // @public (undocumented)
 export const isUnknownMimeTypeSupportedByServer: (mimeType: string) => boolean;
 
+// @public
+export const isVideoMimeTypeSupportedByBrowser: (mimeType: string) => boolean;
+
 // @public (undocumented)
 export const isVideoMimeTypeSupportedByServer: (mimeType: string) => boolean;