@atlaskit/media-card 81.9.5 → 81.10.0

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @atlaskit/media-card
 
+## 81.10.0
+
+### Minor Changes
+
+- [`be8a71519cbc2`](https://bitbucket.org/atlassian/atlassian-frontend-monorepo/commits/be8a71519cbc2) -
+  Add support for seeding media card file state from SSR media node metadata, behind the
+  `platform_media_ssr_data_seed` feature gate.
+
+  `@atlaskit/media-client` gains a Relay-free `mapSsrMediaItemToFileState`. Malformed, partial, or
+  non-array input yields `undefined` rather than throwing.
+
+  `@atlaskit/media-card` accepts an optional `ssrMediaItem` prop. When `ssrFileState` is absent and
+  the gate is on, the card converts `ssrMediaItem` to FileState via `mapSsrMediaItemToFileState` and
+  seeds `useFileState`. `ssrFileState` still wins when both are provided (Relay / media-card-relay).
+
+  `@atlaskit/renderer` extends `MediaSSR` with `ssrMediaItems` — the host's SSR media payload,
+  passed through untouched. The renderer finds the matching item by id and forwards it as
+  `ssrMediaItem` to Card. Hosts need no knowledge of `FileState` or of media internals. The field is
+  optional and additive: hosts that do not supply it, and media ids without an entry, keep the
+  current fetch behaviour.
+
+  `@atlaskit/media-card-relay`'s `MediaCardRelay` / `MediaInlineCardRelay` now call the shared
+  `mapSsrMediaItemToFileState` mapper directly (the Relay fragment data is structurally assignable
+  to `SsrMediaItem`, so no cast or wrapper is needed). Its public API and behaviour are unchanged.
+
+  `@atlaskit/media-file-preview` now forwards an SSR-seeded pre-signed `previewCdnUrl` to the new
+  optional `MediaClient.getImageUrlSync(id, params, seededCdnUrl)` argument when
+  `platform_media_ssr_data_seed` is enabled and CDN delivery is in use. `@atlaskit/media-client`
+  preserves the signed CDN asset URL and inserts supported image parameters before the `wm-ari` /
+  `wm-v` watermark anchor, avoiding query-string rebuilding or re-encoding that can invalidate
+  CloudFront signatures. Path-based routing, isolated cloud, GCP, and callers without a seeded URL
+  retain the existing URL-generation behaviour.
+
+### Patch Changes
+
+- Updated dependencies
+
+## 81.9.6
+
+### Patch Changes
+
+- Updated dependencies
+
 ## 81.9.5
 
 ### Patch Changes

package/dist/cjs/card/card.js

@@ -20,7 +20,7 @@ var _label = _interopRequireDefault(require("@atlaskit/react-ufo/label"));
 var _excluded = ["identifier"];
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function _interopRequireWildcard(e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != _typeof(e) && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (var _t in e) "default" !== _t && {}.hasOwnProperty.call(e, _t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, _t)) && (i.get || i.set) ? o(f, _t, i) : f[_t] = e[_t]); return f; })(e, t); }
 var packageName = "@atlaskit/media-card";
-var packageVersion = "81.9.4";
+var packageVersion = "81.9.6";
 var CardBase = exports.CardBase = function CardBase(_ref) {
   var identifier = _ref.identifier,
     otherProps = (0, _objectWithoutProperties2.default)(_ref, _excluded);

package/dist/cjs/card/fileCard.js

@@ -15,6 +15,7 @@ var _useAnalyticsEvents2 = require("@atlaskit/analytics-next/useAnalyticsEvents"
 var _mediaClient = require("@atlaskit/media-client");
 var _useFileState2 = require("@atlaskit/media-client-react/use-file-state");
 var _useMediaClient = require("@atlaskit/media-client-react/use-media-client");
+var _ssrMediaItem = require("@atlaskit/media-client/ssr-media-item");
 var _mediaCommon = require("@atlaskit/media-common");
 var _mediaViewer = require("@atlaskit/media-viewer");
 var _react = _interopRequireWildcard(require("react"));
@@ -102,6 +103,7 @@ var FileCard = exports.FileCard = function FileCard(_ref) {
     includeHashForDuplicateFiles = _ref.includeHashForDuplicateFiles,
     ssrItemDetails = _ref.ssrItemDetails,
     ssrFileState = _ref.ssrFileState,
+    ssrMediaItem = _ref.ssrMediaItem,
     onError = _ref.onError,
     mediaViewerExtensions = _ref.mediaViewerExtensions,
     fallbackMediaNameFetcher = _ref.fallbackMediaNameFetcher;
@@ -147,7 +149,10 @@ var FileCard = exports.FileCard = function FileCard(_ref) {
   // Note: mapMediaItemToFileState maps the fragment's processingStatus faithfully (including
   // processing/pending). The decision to skip polling is delegated to useFileState —
   // it skips subscription only when status === 'processed'. Do not add status guards here.
-  var initialFileState = (0, _fg.fg)('platform_media_ssr_data_seed') ? ssrFileState : undefined;
+  // ssrFileState (Relay / explicit seed) wins over converting ssrMediaItem.
+  var initialFileState = (0, _react.useMemo)(function () {
+    return (0, _fg.fg)('platform_media_ssr_data_seed') ? ssrFileState !== null && ssrFileState !== void 0 ? ssrFileState : (0, _ssrMediaItem.mapSsrMediaItemToFileState)(ssrMediaItem) : undefined;
+  }, [ssrFileState, ssrMediaItem]);
   var _useFileState = (0, _useFileState2.useFileState)(identifier.id, {
       skipRemote: !isCardVisible,
       collectionName: identifier.collectionName,

package/dist/cjs/card/media-card-analytics-error-boundary.js

@@ -87,7 +87,7 @@ var WrappedMediaCardAnalyticsErrorBoundary = /*#__PURE__*/function (_React$Compo
 }(_react.default.Component);
 (0, _defineProperty2.default)(WrappedMediaCardAnalyticsErrorBoundary, "displayName", 'MediaCardAnalyticsErrorBoundary');
 var packageName = "@atlaskit/media-card";
-var packageVersion = "81.9.4";
+var packageVersion = "81.9.6";
 
 // @ts-ignore: [PIT-1685] Fails in post-office due to backwards incompatibility issue with React 18
 var MediaCardAnalyticsErrorBoundary = (0, _mediaCommon.withMediaAnalyticsContext)({

package/dist/cjs/inline/loader.js

@@ -116,7 +116,7 @@ var MediaInlineCardLoader = exports.default = /*#__PURE__*/function (_React$Pure
         ErrorBoundary = _this$state.ErrorBoundary;
       var analyticsContext = {
         packageVersion: "@atlaskit/media-card",
-        packageName: "81.9.4",
+        packageName: "81.9.6",
         componentName: 'mediaInlineCard',
         component: 'mediaInlineCard'
       };

package/dist/cjs/inline/mediaInlineCard.js

@@ -9,6 +9,7 @@ exports.MediaInlineCardInternal = exports.MediaInlineCard = void 0;
 var _slicedToArray2 = _interopRequireDefault(require("@babel/runtime/helpers/slicedToArray"));
 var _useAnalyticsEvents2 = require("@atlaskit/analytics-next/useAnalyticsEvents");
 var _mediaClient = require("@atlaskit/media-client");
+var _ssrMediaItem = require("@atlaskit/media-client/ssr-media-item");
 var _ErroredView = require("@atlaskit/media-ui/ErroredView");
 var _LoadedView = require("@atlaskit/media-ui/LoadedView");
 var _LoadingView = require("@atlaskit/media-ui/LoadingView");
@@ -40,8 +41,12 @@ var MediaInlineCardInternal = exports.MediaInlineCardInternal = function MediaIn
     intl = _ref.intl,
     viewerOptions = _ref.viewerOptions,
     fallbackMediaNameFetcher = _ref.fallbackMediaNameFetcher,
-    ssrFileState = _ref.ssrFileState;
-  var initialFileState = (0, _fg.fg)('platform_media_ssr_data_seed') ? ssrFileState : undefined;
+    ssrFileState = _ref.ssrFileState,
+    ssrMediaItem = _ref.ssrMediaItem;
+  // ssrFileState (Relay / explicit seed) wins over converting ssrMediaItem.
+  var initialFileState = (0, _react.useMemo)(function () {
+    return (0, _fg.fg)('platform_media_ssr_data_seed') ? ssrFileState !== null && ssrFileState !== void 0 ? ssrFileState : (0, _ssrMediaItem.mapSsrMediaItemToFileState)(ssrMediaItem) : undefined;
+  }, [ssrFileState, ssrMediaItem]);
   // Capture as a ref so it's a stable one-time SSR seed that doesn't affect
   // the useEffect dependency array (including it would cause repeated
   // unsubscribe/resubscribe cycles whenever ssrFileState changes reference).

package/dist/cjs/utils/ufoExperiences.js

@@ -22,7 +22,7 @@ var _globalScope = require("./globalScope/globalScope");
 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-card";
-var packageVersion = "81.9.4";
+var packageVersion = "81.9.6";
 var SAMPLE_RATE = 0.05;
 
 /**

package/dist/es2019/card/card.js

@@ -9,7 +9,7 @@ import { startResourceObserver, setAnalyticsContext } from '../utils/mediaPerfor
 import { useAnalyticsEvents } from '@atlaskit/analytics-next/useAnalyticsEvents';
 import UFOLabel from '@atlaskit/react-ufo/label';
 const packageName = "@atlaskit/media-card";
-const packageVersion = "81.9.4";
+const packageVersion = "81.9.6";
 export const CardBase = ({
   identifier,
   ...otherProps

package/dist/es2019/card/fileCard.js

@@ -2,6 +2,7 @@ import { useAnalyticsEvents } from '@atlaskit/analytics-next/useAnalyticsEvents'
 import { globalMediaEventEmitter, RECENTS_COLLECTION, imageResizeModeToFileImageMode, isProcessedFileState, isErrorFileState, toCommonMediaClientError } from '@atlaskit/media-client';
 import { useFileState } from '@atlaskit/media-client-react/use-file-state';
 import { useMediaClient } from '@atlaskit/media-client-react/use-media-client';
+import { mapSsrMediaItemToFileState } from '@atlaskit/media-client/ssr-media-item';
 import { isMimeTypeSupportedByBrowser, isVideoMimeTypeSupportedByBrowser, getRandomTelemetryId } from '@atlaskit/media-common';
 import { MediaViewer } from '@atlaskit/media-viewer';
 import React, { Suspense, useEffect, useMemo, useRef, useState, useCallback } from 'react';
@@ -83,6 +84,7 @@ export const FileCard = ({
   includeHashForDuplicateFiles,
   ssrItemDetails,
   ssrFileState,
+  ssrMediaItem,
   onError,
   mediaViewerExtensions,
   fallbackMediaNameFetcher
@@ -119,7 +121,8 @@ export const FileCard = ({
   // Note: mapMediaItemToFileState maps the fragment's processingStatus faithfully (including
   // processing/pending). The decision to skip polling is delegated to useFileState —
   // it skips subscription only when status === 'processed'. Do not add status guards here.
-  const initialFileState = fg('platform_media_ssr_data_seed') ? ssrFileState : undefined;
+  // ssrFileState (Relay / explicit seed) wins over converting ssrMediaItem.
+  const initialFileState = useMemo(() => fg('platform_media_ssr_data_seed') ? ssrFileState !== null && ssrFileState !== void 0 ? ssrFileState : mapSsrMediaItemToFileState(ssrMediaItem) : undefined, [ssrFileState, ssrMediaItem]);
   const {
     fileState
   } = useFileState(identifier.id, {

package/dist/es2019/card/media-card-analytics-error-boundary.js

@@ -66,7 +66,7 @@ class WrappedMediaCardAnalyticsErrorBoundary extends React.Component {
 }
 _defineProperty(WrappedMediaCardAnalyticsErrorBoundary, "displayName", 'MediaCardAnalyticsErrorBoundary');
 const packageName = "@atlaskit/media-card";
-const packageVersion = "81.9.4";
+const packageVersion = "81.9.6";
 
 // @ts-ignore: [PIT-1685] Fails in post-office due to backwards incompatibility issue with React 18
 const MediaCardAnalyticsErrorBoundary = withMediaAnalyticsContext({

package/dist/es2019/inline/loader.js

@@ -37,7 +37,7 @@ export default class MediaInlineCardLoader extends React.PureComponent {
     } = this.state;
     const analyticsContext = {
       packageVersion: "@atlaskit/media-card",
-      packageName: "81.9.4",
+      packageName: "81.9.6",
       componentName: 'mediaInlineCard',
       component: 'mediaInlineCard'
     };

package/dist/es2019/inline/mediaInlineCard.js

@@ -1,5 +1,6 @@
 import { useAnalyticsEvents } from '@atlaskit/analytics-next/useAnalyticsEvents';
 import { FileFetcherError, toCommonMediaClientError } from '@atlaskit/media-client';
+import { mapSsrMediaItemToFileState } from '@atlaskit/media-client/ssr-media-item';
 import { MediaInlineCardErroredView } from '@atlaskit/media-ui/ErroredView';
 import { MediaInlineCardLoadedView } from '@atlaskit/media-ui/LoadedView';
 import { MediaInlineCardLoadingView } from '@atlaskit/media-ui/LoadingView';
@@ -9,7 +10,7 @@ import { MimeTypeIcon } from '@atlaskit/media-ui/mime-type-icon';
 import { MediaViewer } from '@atlaskit/media-viewer';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import Tooltip from '@atlaskit/tooltip/Tooltip';
-import React, { useEffect, useRef, useState } from 'react';
+import React, { useEffect, useMemo, useRef, useState } from 'react';
 import ReactDOM from 'react-dom';
 import { createIntl, injectIntl, IntlProvider } from 'react-intl';
 import { MediaCardError } from '../errors';
@@ -30,9 +31,11 @@ export const MediaInlineCardInternal = ({
   intl,
   viewerOptions,
   fallbackMediaNameFetcher,
-  ssrFileState
+  ssrFileState,
+  ssrMediaItem
 }) => {
-  const initialFileState = fg('platform_media_ssr_data_seed') ? ssrFileState : undefined;
+  // ssrFileState (Relay / explicit seed) wins over converting ssrMediaItem.
+  const initialFileState = useMemo(() => fg('platform_media_ssr_data_seed') ? ssrFileState !== null && ssrFileState !== void 0 ? ssrFileState : mapSsrMediaItemToFileState(ssrMediaItem) : undefined, [ssrFileState, ssrMediaItem]);
   // Capture as a ref so it's a stable one-time SSR seed that doesn't affect
   // the useEffect dependency array (including it would cause repeated
   // unsubscribe/resubscribe cycles whenever ssrFileState changes reference).

package/dist/es2019/utils/ufoExperiences.js

@@ -11,7 +11,7 @@ import { getMediaEnvironment, getMediaRegion } from '@atlaskit/media-client';
 import { getActiveInteraction } from '@atlaskit/react-ufo/interaction-metrics';
 import { getMediaGlobalScope } from './globalScope/globalScope';
 const packageName = "@atlaskit/media-card";
-const packageVersion = "81.9.4";
+const packageVersion = "81.9.6";
 const SAMPLE_RATE = 0.05;
 
 /**

package/dist/esm/card/card.js

@@ -11,7 +11,7 @@ import { startResourceObserver, setAnalyticsContext } from '../utils/mediaPerfor
 import { useAnalyticsEvents } from '@atlaskit/analytics-next/useAnalyticsEvents';
 import UFOLabel from '@atlaskit/react-ufo/label';
 var packageName = "@atlaskit/media-card";
-var packageVersion = "81.9.4";
+var packageVersion = "81.9.6";
 export var CardBase = function CardBase(_ref) {
   var identifier = _ref.identifier,
     otherProps = _objectWithoutProperties(_ref, _excluded);

package/dist/esm/card/fileCard.js

@@ -9,6 +9,7 @@ import { useAnalyticsEvents } from '@atlaskit/analytics-next/useAnalyticsEvents'
 import { globalMediaEventEmitter, RECENTS_COLLECTION, imageResizeModeToFileImageMode, isProcessedFileState, isErrorFileState, toCommonMediaClientError } from '@atlaskit/media-client';
 import { useFileState } from '@atlaskit/media-client-react/use-file-state';
 import { useMediaClient } from '@atlaskit/media-client-react/use-media-client';
+import { mapSsrMediaItemToFileState } from '@atlaskit/media-client/ssr-media-item';
 import { isMimeTypeSupportedByBrowser, isVideoMimeTypeSupportedByBrowser, getRandomTelemetryId } from '@atlaskit/media-common';
 import { MediaViewer } from '@atlaskit/media-viewer';
 import React, { Suspense, useEffect, useMemo, useRef, useState, useCallback } from 'react';
@@ -94,6 +95,7 @@ export var FileCard = function FileCard(_ref) {
     includeHashForDuplicateFiles = _ref.includeHashForDuplicateFiles,
     ssrItemDetails = _ref.ssrItemDetails,
     ssrFileState = _ref.ssrFileState,
+    ssrMediaItem = _ref.ssrMediaItem,
     onError = _ref.onError,
     mediaViewerExtensions = _ref.mediaViewerExtensions,
     fallbackMediaNameFetcher = _ref.fallbackMediaNameFetcher;
@@ -139,7 +141,10 @@ export var FileCard = function FileCard(_ref) {
   // Note: mapMediaItemToFileState maps the fragment's processingStatus faithfully (including
   // processing/pending). The decision to skip polling is delegated to useFileState —
   // it skips subscription only when status === 'processed'. Do not add status guards here.
-  var initialFileState = fg('platform_media_ssr_data_seed') ? ssrFileState : undefined;
+  // ssrFileState (Relay / explicit seed) wins over converting ssrMediaItem.
+  var initialFileState = useMemo(function () {
+    return fg('platform_media_ssr_data_seed') ? ssrFileState !== null && ssrFileState !== void 0 ? ssrFileState : mapSsrMediaItemToFileState(ssrMediaItem) : undefined;
+  }, [ssrFileState, ssrMediaItem]);
   var _useFileState = useFileState(identifier.id, {
       skipRemote: !isCardVisible,
       collectionName: identifier.collectionName,

package/dist/esm/card/media-card-analytics-error-boundary.js

@@ -80,7 +80,7 @@ var WrappedMediaCardAnalyticsErrorBoundary = /*#__PURE__*/function (_React$Compo
 }(React.Component);
 _defineProperty(WrappedMediaCardAnalyticsErrorBoundary, "displayName", 'MediaCardAnalyticsErrorBoundary');
 var packageName = "@atlaskit/media-card";
-var packageVersion = "81.9.4";
+var packageVersion = "81.9.6";
 
 // @ts-ignore: [PIT-1685] Fails in post-office due to backwards incompatibility issue with React 18
 var MediaCardAnalyticsErrorBoundary = withMediaAnalyticsContext({

package/dist/esm/inline/loader.js

@@ -101,7 +101,7 @@ var MediaInlineCardLoader = /*#__PURE__*/function (_React$PureComponent) {
         ErrorBoundary = _this$state.ErrorBoundary;
       var analyticsContext = {
         packageVersion: "@atlaskit/media-card",
-        packageName: "81.9.4",
+        packageName: "81.9.6",
         componentName: 'mediaInlineCard',
         component: 'mediaInlineCard'
       };

package/dist/esm/inline/mediaInlineCard.js

@@ -1,6 +1,7 @@
 import _slicedToArray from "@babel/runtime/helpers/slicedToArray";
 import { useAnalyticsEvents } from '@atlaskit/analytics-next/useAnalyticsEvents';
 import { FileFetcherError, toCommonMediaClientError } from '@atlaskit/media-client';
+import { mapSsrMediaItemToFileState } from '@atlaskit/media-client/ssr-media-item';
 import { MediaInlineCardErroredView } from '@atlaskit/media-ui/ErroredView';
 import { MediaInlineCardLoadedView } from '@atlaskit/media-ui/LoadedView';
 import { MediaInlineCardLoadingView } from '@atlaskit/media-ui/LoadingView';
@@ -10,7 +11,7 @@ import { MimeTypeIcon } from '@atlaskit/media-ui/mime-type-icon';
 import { MediaViewer } from '@atlaskit/media-viewer';
 import { fg } from '@atlaskit/platform-feature-flags/fg';
 import Tooltip from '@atlaskit/tooltip/Tooltip';
-import React, { useEffect, useRef, useState } from 'react';
+import React, { useEffect, useMemo, useRef, useState } from 'react';
 import ReactDOM from 'react-dom';
 import { createIntl, injectIntl, IntlProvider } from 'react-intl';
 import { MediaCardError } from '../errors';
@@ -31,8 +32,12 @@ export var MediaInlineCardInternal = function MediaInlineCardInternal(_ref) {
     intl = _ref.intl,
     viewerOptions = _ref.viewerOptions,
     fallbackMediaNameFetcher = _ref.fallbackMediaNameFetcher,
-    ssrFileState = _ref.ssrFileState;
-  var initialFileState = fg('platform_media_ssr_data_seed') ? ssrFileState : undefined;
+    ssrFileState = _ref.ssrFileState,
+    ssrMediaItem = _ref.ssrMediaItem;
+  // ssrFileState (Relay / explicit seed) wins over converting ssrMediaItem.
+  var initialFileState = useMemo(function () {
+    return fg('platform_media_ssr_data_seed') ? ssrFileState !== null && ssrFileState !== void 0 ? ssrFileState : mapSsrMediaItemToFileState(ssrMediaItem) : undefined;
+  }, [ssrFileState, ssrMediaItem]);
   // Capture as a ref so it's a stable one-time SSR seed that doesn't affect
   // the useEffect dependency array (including it would cause repeated
   // unsubscribe/resubscribe cycles whenever ssrFileState changes reference).

package/dist/esm/utils/ufoExperiences.js

@@ -15,7 +15,7 @@ import { getMediaEnvironment, getMediaRegion } from '@atlaskit/media-client';
 import { getActiveInteraction } from '@atlaskit/react-ufo/interaction-metrics';
 import { getMediaGlobalScope } from './globalScope/globalScope';
 var packageName = "@atlaskit/media-card";
-var packageVersion = "81.9.4";
+var packageVersion = "81.9.6";
 var SAMPLE_RATE = 0.05;
 
 /**

package/dist/types/card/fileCard.d.ts

@@ -1,4 +1,5 @@
 import { type FileIdentifier, type FileState, type Identifier, type ImageResizeMode } from '@atlaskit/media-client';
+import { type SsrMediaItem } from '@atlaskit/media-client/ssr-media-item';
 import { type MediaFeatureFlags, type NumericalCardDimensions, type SSR } from '@atlaskit/media-common';
 import { type ViewerOptionsProps, type MediaViewerExtensions } from '@atlaskit/media-viewer';
 import React from 'react';
@@ -75,6 +76,12 @@ export interface FileCardProps extends CardEventProps {
      * @see https://product-fabric.atlassian.net/browse/BMPT-7914
      */
     readonly ssrFileState?: FileState;
+    /**
+     * Raw SSR media item from a host payload (e.g. Confluence recorded media nodes).
+     * Used when `ssrFileState` is not provided. Converted to FileState internally
+     * when `fg('platform_media_ssr_data_seed')` is on.
+     */
+    readonly ssrMediaItem?: SsrMediaItem;
     /** General Error handling include status errors and display errors*/
     readonly onError?: (reason: MediaFilePreviewErrorPrimaryReason | MediaCardErrorPrimaryReason) => void;
     /** Extensions for the media viewer (e.g. comment button in header). */
@@ -86,4 +93,4 @@ export interface FileCardProps extends CardEventProps {
      */
     readonly fallbackMediaNameFetcher?: (id: string) => Promise<string>;
 }
-export declare const FileCard: ({ appearance, resizeMode, isLazy, disableOverlay, featureFlags, identifier, ssr, dimensions, originalDimensions, contextId, alt, actions, shouldEnableDownloadButton, useInlinePlayer, shouldOpenMediaViewer, onFullscreenChange, selectable, selected, testId, titleBoxBgColor, titleBoxIcon, backgroundColor, isAIGenerating, isCWR, onPreviewRender, shouldHideTooltip, mediaViewerItems, onClick, onMouseEnter, onFocus, videoControlsWrapperRef, viewerOptions, includeHashForDuplicateFiles, ssrItemDetails, ssrFileState, onError, mediaViewerExtensions, fallbackMediaNameFetcher, }: FileCardProps) => React.JSX.Element;
+export declare const FileCard: ({ appearance, resizeMode, isLazy, disableOverlay, featureFlags, identifier, ssr, dimensions, originalDimensions, contextId, alt, actions, shouldEnableDownloadButton, useInlinePlayer, shouldOpenMediaViewer, onFullscreenChange, selectable, selected, testId, titleBoxBgColor, titleBoxIcon, backgroundColor, isAIGenerating, isCWR, onPreviewRender, shouldHideTooltip, mediaViewerItems, onClick, onMouseEnter, onFocus, videoControlsWrapperRef, viewerOptions, includeHashForDuplicateFiles, ssrItemDetails, ssrFileState, ssrMediaItem, onError, mediaViewerExtensions, fallbackMediaNameFetcher, }: FileCardProps) => React.JSX.Element;

package/dist/types/inline/mediaInlineCard.d.ts

@@ -1,4 +1,5 @@
 import { type FileIdentifier, type FileState, type Identifier, type MediaClient } from '@atlaskit/media-client';
+import { type SsrMediaItem } from '@atlaskit/media-client/ssr-media-item';
 import { type ViewerOptionsProps } from '@atlaskit/media-viewer';
 import React, { type FC } from 'react';
 import { type WrappedComponentProps } from 'react-intl';
@@ -26,6 +27,12 @@ export interface MediaInlineCardProps {
      * @see https://product-fabric.atlassian.net/browse/BMPT-7914
      */
     readonly ssrFileState?: FileState;
+    /**
+     * Raw SSR media item from a host payload (e.g. Confluence recorded media nodes).
+     * Used when `ssrFileState` is not provided. Converted to FileState internally
+     * when `fg('platform_media_ssr_data_seed')` is on.
+     */
+    readonly ssrMediaItem?: SsrMediaItem;
 }
 export declare const MediaInlineCardInternal: FC<MediaInlineCardProps & WrappedComponentProps>;
 export declare const MediaInlineCard: React.FC<MediaInlineCardProps>;

package/dist/types/types.d.ts

@@ -4,6 +4,7 @@
 import { type FocusEvent, type MouseEvent } from 'react';
 import { type FileDetails, type MediaClient, type Identifier, type ImageResizeMode, type FileState } from '@atlaskit/media-client';
 import type { MediaSettings } from '@atlaskit/media-client-react/media-parsed-settings';
+import type { SsrMediaItem } from '@atlaskit/media-client/ssr-media-item';
 import type UIAnalyticsEvent from '@atlaskit/analytics-next/UIAnalyticsEvent';
 import { type MediaFeatureFlags, type NumericalCardDimensions, type SSR } from '@atlaskit/media-common';
 import { type CardAction } from './card/actions';
@@ -126,6 +127,12 @@ export interface CardProps extends SharedCardProps, CardEventProps {
      * @see https://product-fabric.atlassian.net/browse/BMPT-7914
      */
     readonly ssrFileState?: FileState;
+    /**
+     * Raw SSR media item from a host payload (e.g. Confluence recorded media nodes).
+     * Used when `ssrFileState` is not provided. Converted to FileState internally
+     * when `fg('platform_media_ssr_data_seed')` is on.
+     */
+    readonly ssrMediaItem?: SsrMediaItem;
     /** General Error handling include status errors and display errors*/
     readonly onError?: (reason: MediaFilePreviewErrorPrimaryReason | MediaCardErrorPrimaryReason) => void;
     /** Extensions for the media viewer (e.g. comment button in header). */

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlaskit/media-card",
-	"version": "81.9.5",
+	"version": "81.10.0",
 	"description": "Includes all media card related components, CardView, CardViewSmall, Card...",
 	"publishConfig": {
 		"registry": "https://registry.npmjs.org/"
@@ -36,7 +36,7 @@
 		"@atlaskit/icon": "^37.6.0",
 		"@atlaskit/interaction-context": "^4.1.0",
 		"@atlaskit/link": "^5.1.0",
-		"@atlaskit/media-client": "^37.6.0",
+		"@atlaskit/media-client": "^37.7.0",
 		"@atlaskit/media-client-react": "^6.4.0",
 		"@atlaskit/media-common": "^14.6.0",
 		"@atlaskit/media-file-preview": "^1.3.0",
@@ -52,7 +52,7 @@
 		"@atlaskit/section-message": "^10.2.0",
 		"@atlaskit/spinner": "^20.4.0",
 		"@atlaskit/theme": "^28.2.0",
-		"@atlaskit/tmp-editor-statsig": "^173.0.0",
+		"@atlaskit/tmp-editor-statsig": "^174.0.0",
 		"@atlaskit/tokens": "^16.11.0",
 		"@atlaskit/tooltip": "^24.3.0",
 		"@atlaskit/ufo": "^1.2.0",