@atlaskit/smart-card 20.0.6 → 20.1.0

package/dist/es2019/state/actions/index.js

@@ -1,10 +1,9 @@
 import { useMemo, useCallback } from 'react';
 import { auth } from '@atlaskit/outbound-auth-flow-client';
-import { APIError } from '@atlaskit/linking-common';
 import { useSmartLinkContext } from '@atlaskit/link-provider';
-import { ACTION_PENDING, ACTION_RESOLVED, ACTION_ERROR, ACTION_ERROR_FALLBACK, ACTION_RELOADING, cardAction } from '@atlaskit/linking-common';
+import { ACTION_PENDING, ACTION_RESOLVED, ACTION_ERROR, ACTION_ERROR_FALLBACK, ACTION_RELOADING, ACTION_UPDATE_METADATA_STATUS, cardAction, APIError } from '@atlaskit/linking-common';
 import { getDefinitionId, getByDefinitionId, getServices, getStatus, getExtensionKey } from '../helpers';
-import { ERROR_MESSAGE_OAUTH, ERROR_MESSAGE_FATAL } from './constants';
+import { ERROR_MESSAGE_OAUTH, ERROR_MESSAGE_FATAL, ERROR_MESSAGE_METADATA } from './constants';
 import * as measure from '../../utils/performance';
 import { getUnauthorizedJsonLd } from '../../utils/jsonld';
 import { addMetadataToExperience } from '../analytics';
@@ -20,14 +19,26 @@ export const useSmartCardActions = (id, url, analytics) => {
   } = store;
   const {
     details,
-    status
+    status,
+    metadataStatus
   } = getState()[url] || {
     status: 'pending',
     details: undefined
   };
   const hasAuthFlowSupported = config.authFlow !== 'disabled';
   const hasData = !!(details && details.data);
-  const handleResolvedLinkError = useCallback((url, error, response) => {
+  const setMetadataStatus = useCallback(metadataStatus => {
+    dispatch(cardAction(ACTION_UPDATE_METADATA_STATUS, {
+      url
+    }, undefined, undefined, metadataStatus));
+  }, [dispatch, url]);
+  const handleResolvedLinkError = useCallback((url, error, response, isMetadataRequest) => {
+    // If metadata request then set metadata status, return and do not alter link status
+    if (isMetadataRequest) {
+      setMetadataStatus('errored');
+      return;
+    }
+
     if (error.kind === 'fatal') {
       // If there's no previous data in the store for this URL, then bail
       // out and let the editor handle fallbacks (returns to a blue link).
@@ -64,24 +75,32 @@ export const useSmartCardActions = (id, url, analytics) => {
         }, undefined, error));
       }
     }
-  }, [hasData, status, dispatch, details]);
-  const handleResolvedLinkResponse = useCallback((resourceUrl, response, isReloading = false) => {
+  }, [setMetadataStatus, hasData, status, dispatch, details]);
+  const handleResolvedLinkResponse = useCallback((resourceUrl, response, isReloading = false, isMetadataRequest) => {
     const hostname = new URL(resourceUrl).hostname;
     const nextStatus = response ? getStatus(response) : 'fatal'; // If we require authorization & do not have an authFlow available,
     // throw an error and render as a normal blue link.
 
     if ((nextStatus === 'unauthorized' || nextStatus === 'forbidden') && !hasAuthFlowSupported) {
-      handleResolvedLinkError(resourceUrl, new APIError('fallback', hostname, ERROR_MESSAGE_OAUTH), response);
+      handleResolvedLinkError(resourceUrl, new APIError('fallback', hostname, ERROR_MESSAGE_OAUTH), response, isMetadataRequest);
       return;
     } // Handle any other errors
 
 
     if (nextStatus === 'fatal') {
-      handleResolvedLinkError(resourceUrl, new APIError('fatal', hostname, ERROR_MESSAGE_FATAL));
+      handleResolvedLinkError(resourceUrl, new APIError('fatal', hostname, ERROR_MESSAGE_FATAL), undefined, isMetadataRequest);
       return;
-    } // Dispatch Analytics and resolved card action - including unauthorized states.
+    } // Handle errors of any other kind in the metadata request response
 
 
+    if (isMetadataRequest && nextStatus !== 'resolved') {
+      handleResolvedLinkError(resourceUrl, new APIError('error', hostname, ERROR_MESSAGE_METADATA), response, isMetadataRequest);
+      return;
+    } //if a link resolves normally, metadata will also always be resolved
+
+
+    setMetadataStatus('resolved'); // Dispatch Analytics and resolved card action - including unauthorized states.
+
     if (isReloading) {
       dispatch(cardAction(ACTION_RELOADING, {
         url: resourceUrl
@@ -89,15 +108,15 @@ export const useSmartCardActions = (id, url, analytics) => {
     } else {
       dispatch(cardAction(ACTION_RESOLVED, {
         url: resourceUrl
-      }, response));
+      }, response, undefined, undefined, isMetadataRequest));
     }
-  }, [dispatch, handleResolvedLinkError, hasAuthFlowSupported]);
-  const resolve = useCallback(async (resourceUrl = url, isReloading = false) => {
+  }, [dispatch, handleResolvedLinkError, hasAuthFlowSupported, setMetadataStatus]);
+  const resolve = useCallback(async (resourceUrl = url, isReloading = false, isMetadataRequest = false) => {
     // Request JSON-LD data for the card from ORS, iff it has extended
     // its cache lifespan OR there is no data for it currently. Once the data
     // has come back asynchronously, dispatch the resolved action for the card.
-    if (isReloading || !hasData) {
-      return connections.client.fetchData(resourceUrl).then(response => handleResolvedLinkResponse(resourceUrl, response, isReloading)).catch(error => handleResolvedLinkError(resourceUrl, error));
+    if (isReloading || !hasData || isMetadataRequest) {
+      return connections.client.fetchData(resourceUrl).then(response => handleResolvedLinkResponse(resourceUrl, response, isReloading, isMetadataRequest)).catch(error => handleResolvedLinkError(resourceUrl, error, undefined, isMetadataRequest));
     } else {
       addMetadataToExperience('smart-link-rendered', id, {
         cached: true
@@ -109,10 +128,11 @@ export const useSmartCardActions = (id, url, analytics) => {
       dispatch(cardAction(ACTION_PENDING, {
         url
       }));
+      setMetadataStatus('pending');
     }
 
     return resolve();
-  }, [url, resolve, details, dispatch]);
+  }, [details, resolve, dispatch, url, setMetadataStatus]);
   const reload = useCallback(() => {
     const definitionId = getDefinitionId(details);
 
@@ -122,6 +142,13 @@ export const useSmartCardActions = (id, url, analytics) => {
       resolve(url, true);
     }
   }, [url, details, getState, resolve]);
+  const loadMetadata = useCallback(() => {
+    //metadataStatus will be undefined for SSR links only
+    if (metadataStatus === undefined) {
+      setMetadataStatus('pending');
+      return resolve(url, false, true);
+    }
+  }, [metadataStatus, resolve, setMetadataStatus, url]);
   const authorize = useCallback(appearance => {
     const definitionId = getDefinitionId(details);
     const extensionKey = getExtensionKey(details);
@@ -187,6 +214,7 @@ export const useSmartCardActions = (id, url, analytics) => {
     register,
     reload,
     authorize,
-    invoke
-  }), [register, reload, authorize, invoke]);
+    invoke,
+    loadMetadata
+  }), [register, reload, authorize, invoke, loadMetadata]);
 };

package/dist/es2019/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/smart-card",
-	"version": "20.0.6",
+	"version": "20.1.0",
 	"sideEffects": false
 }

package/dist/es2019/view/BlockCard/index.js

@@ -30,6 +30,7 @@ export const BlockCard = ({
   renderers,
   isSelected,
   onResolve,
+  onError,
   testId,
   showActions,
   platform
@@ -70,6 +71,13 @@ export const BlockCard = ({
       }));
 
     case 'unauthorized':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       const unauthorizedViewProps = extractBlockProps(data, meta, extractorOpts);
       return /*#__PURE__*/React.createElement(BlockCardUnauthorisedView, _extends({}, unauthorizedViewProps, {
         isSelected: isSelected,
@@ -80,6 +88,13 @@ export const BlockCard = ({
       }));
 
     case 'forbidden':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       const forbiddenViewProps = extractBlockProps(data, meta, extractorOpts);
       const cardMetadata = (_details$meta = details === null || details === void 0 ? void 0 : details.meta) !== null && _details$meta !== void 0 ? _details$meta : getUnauthorizedJsonLd().meta;
       const requestAccessContext = extractRequestAccessContext({
@@ -96,6 +111,13 @@ export const BlockCard = ({
       }));
 
     case 'not_found':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       const notFoundViewProps = extractBlockProps(data, meta, extractorOpts);
       return /*#__PURE__*/React.createElement(BlockCardNotFoundView, _extends({}, notFoundViewProps, {
         isSelected: isSelected,
@@ -105,6 +127,13 @@ export const BlockCard = ({
 
     case 'fallback':
     case 'errored':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       if (authFlow && authFlow === 'disabled') {
         return /*#__PURE__*/React.createElement(CardLinkView, {
           link: url,

package/dist/es2019/view/CardWithUrl/component.js

@@ -20,6 +20,7 @@ export function CardWithUrlContent({
   appearance,
   dispatchAnalytics,
   onResolve,
+  onError,
   testId,
   showActions,
   inheritDimensions,
@@ -91,7 +92,7 @@ export function CardWithUrlContent({
     if (isFinalState(state.status)) {
       analytics.ui.renderSuccessEvent(appearance, state.status, id, definitionId, extensionKey);
     }
-  }, [appearance, state.details, state.status, url, definitionId, extensionKey, analytics.ui, id]);
+  }, [appearance, state.status, url, definitionId, extensionKey, analytics.ui, id]);
 
   if (isFlexibleUi) {
     let cardState = state;
@@ -115,7 +116,8 @@ export function CardWithUrlContent({
       ui: ui,
       url: url,
       testId: testId,
-      onResolve: onResolve
+      onResolve: onResolve,
+      onError: onError
     }, children);
   } // We have to keep this last to prevent hook order from being violated
 
@@ -135,6 +137,7 @@ export function CardWithUrlContent({
         handleFrameClick: handleClickWrapper,
         isSelected: isSelected,
         onResolve: onResolve,
+        onError: onError,
         testId: testId,
         inlinePreloaderStyle: inlinePreloaderStyle,
         showHoverPreview: showHoverPreview
@@ -154,6 +157,7 @@ export function CardWithUrlContent({
         handleAnalytics: dispatchAnalytics,
         isSelected: isSelected,
         onResolve: onResolve,
+        onError: onError,
         testId: testId,
         showActions: showActions,
         platform: platform
@@ -173,6 +177,7 @@ export function CardWithUrlContent({
         isFrameVisible: isFrameVisible,
         platform: platform,
         onResolve: onResolve,
+        onError: onError,
         testId: testId,
         inheritDimensions: inheritDimensions,
         showActions: showActions,

package/dist/es2019/view/CardWithUrl/loader.js

@@ -25,6 +25,7 @@ export function CardWithURLRenderer(props) {
     onClick,
     container,
     onResolve,
+    onError,
     testId,
     showActions,
     inheritDimensions,
@@ -85,6 +86,7 @@ export function CardWithURLRenderer(props) {
     dispatchAnalytics,
     container,
     onResolve,
+    onError,
     testId,
     showActions,
     inheritDimensions,

package/dist/es2019/view/EmbedCard/index.js

@@ -29,6 +29,7 @@ export const EmbedCard = /*#__PURE__*/React.forwardRef(({
   isFrameVisible,
   platform,
   onResolve,
+  onError,
   testId,
   inheritDimensions
 }, iframeRef) => {
@@ -91,6 +92,13 @@ export const EmbedCard = /*#__PURE__*/React.forwardRef(({
       }
 
     case 'unauthorized':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       const unauthorisedViewProps = extractEmbedProps(data, meta, platform);
       return /*#__PURE__*/React.createElement(EmbedCardUnauthorisedView, _extends({}, unauthorisedViewProps, {
         isSelected: isSelected,
@@ -100,6 +108,13 @@ export const EmbedCard = /*#__PURE__*/React.forwardRef(({
       }));
 
     case 'forbidden':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       const forbiddenViewProps = extractEmbedProps(data, meta, platform);
       const cardMetadata = (_details$meta = details === null || details === void 0 ? void 0 : details.meta) !== null && _details$meta !== void 0 ? _details$meta : getUnauthorizedJsonLd().meta;
       const requestAccessContext = extractRequestAccessContext({
@@ -116,6 +131,13 @@ export const EmbedCard = /*#__PURE__*/React.forwardRef(({
       }));
 
     case 'not_found':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       const notFoundViewProps = extractEmbedProps(data, meta, platform);
       return /*#__PURE__*/React.createElement(EmbedCardNotFoundView, _extends({}, notFoundViewProps, {
         isSelected: isSelected,
@@ -125,6 +147,13 @@ export const EmbedCard = /*#__PURE__*/React.forwardRef(({
 
     case 'fallback':
     case 'errored':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       return /*#__PURE__*/React.createElement(EmbedCardErroredView, {
         onRetry: handleErrorRetry,
         inheritDimensions: inheritDimensions,

package/dist/es2019/view/FlexibleCard/index.js

@@ -1,5 +1,6 @@
 import _extends from "@babel/runtime/helpers/extends";
 import React, { useEffect } from 'react';
+import { SmartLinkStatus } from '../../constants';
 import Container from './components/container';
 import { FlexibleUiContext } from '../../state/flexible-ui-context';
 import { getContextByStatus, getRetryOptions } from './utils';
@@ -14,12 +15,13 @@ const FlexibleCard = ({
   cardState,
   children,
   onAuthorize,
+  onError,
+  onResolve,
   renderers,
   ui,
   url,
   onClick,
-  testId,
-  onResolve
+  testId
 }) => {
   const {
     status: cardType,
@@ -28,13 +30,36 @@ const FlexibleCard = ({
   const status = cardType;
   const context = getContextByStatus(url, status, details, renderers);
   const retry = getRetryOptions(url, status, details, onAuthorize);
+  const {
+    title
+  } = context || {};
   useEffect(() => {
-    if (status === 'resolved' && onResolve) {
-      onResolve({
-        url
-      });
+    switch (status) {
+      case SmartLinkStatus.Resolved:
+        if (onResolve) {
+          onResolve({
+            title,
+            url
+          });
+        }
+
+        break;
+
+      case SmartLinkStatus.Errored:
+      case SmartLinkStatus.Fallback:
+      case SmartLinkStatus.Forbidden:
+      case SmartLinkStatus.NotFound:
+      case SmartLinkStatus.Unauthorized:
+        if (onError) {
+          onError({
+            status,
+            url
+          });
+        }
+
+        break;
     }
-  }, [onResolve, status, url]);
+  }, [onError, onResolve, status, title, url]);
   return /*#__PURE__*/React.createElement(FlexibleUiContext.Provider, {
     value: context
   }, /*#__PURE__*/React.createElement(Container, _extends({

package/dist/es2019/view/HoverCard/components/HoverCardContent.js

@@ -4,6 +4,7 @@ import React, { useCallback, useEffect, useMemo } from 'react';
 import { ActionName, SmartLinkPosition, SmartLinkSize } from '../../../constants';
 import extractPreview from '../../../extractors/flexible/extract-preview';
 import { extractMetadata } from '../../../extractors/hover/extractMetadata';
+import { useSmartCardActions } from '../../../state/actions';
 import { getExtensionKey } from '../../../state/helpers';
 import { isSpecialEvent } from '../../../utils';
 import FlexibleCard from '../../FlexibleCard';
@@ -41,6 +42,7 @@ export const toFooterActions = (cardActions, onActionClick) => cardActions.map(a
 }));
 
 const HoverCardContent = ({
+  id = '',
   analytics,
   cardActions = [],
   cardState,
@@ -51,6 +53,10 @@ const HoverCardContent = ({
 }) => {
   var _cardState$details;
 
+  const actions = useSmartCardActions(id, url, analytics);
+  useEffect(() => {
+    actions.loadMetadata();
+  }, [actions]);
   useEffect(() => {
     // Since hover preview only render on resolved status,
     // there is no need to check for statuses.

package/dist/es2019/view/InlineCard/index.js

@@ -20,6 +20,7 @@ export const InlineCard = ({
   isSelected,
   renderers,
   onResolve,
+  onError,
   testId,
   inlinePreloaderStyle,
   showHoverPreview
@@ -64,6 +65,13 @@ export const InlineCard = ({
       }));
 
     case 'unauthorized':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       const provider = extractProvider(cardDetails);
       return /*#__PURE__*/React.createElement(InlineCardUnauthorizedView, {
         icon: provider && provider.icon,
@@ -75,6 +83,13 @@ export const InlineCard = ({
       });
 
     case 'forbidden':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       const providerForbidden = extractProvider(cardDetails);
       const cardMetadata = (_details$meta = details === null || details === void 0 ? void 0 : details.meta) !== null && _details$meta !== void 0 ? _details$meta : getUnauthorizedJsonLd().meta;
       const requestAccessContext = extractRequestAccessContext({
@@ -94,6 +109,13 @@ export const InlineCard = ({
       });
 
     case 'not_found':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       const providerNotFound = extractProvider(cardDetails);
       return /*#__PURE__*/React.createElement(InlineCardErroredView, {
         url: url,
@@ -106,6 +128,13 @@ export const InlineCard = ({
 
     case 'fallback':
     case 'errored':
+      if (onError) {
+        onError({
+          url,
+          status
+        });
+      }
+
       return /*#__PURE__*/React.createElement(CardLinkView, {
         link: url,
         isSelected: isSelected,

package/dist/esm/state/actions/constants.js

@@ -2,4 +2,5 @@ export var ANALYTICS_RESOLVING = 'resolving';
 export var ANALYTICS_ERROR = 'errored';
 export var ANALYTICS_FALLBACK = 'fallback';
 export var ERROR_MESSAGE_OAUTH = 'Provider.authFlow is not set to OAuth2.';
-export var ERROR_MESSAGE_FATAL = 'Fatal error resolving URL';
+export var ERROR_MESSAGE_FATAL = 'Fatal error resolving URL';
+export var ERROR_MESSAGE_METADATA = 'Error resolving metadata.';

package/dist/esm/state/actions/index.js

@@ -2,11 +2,10 @@ import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _regeneratorRuntime from "@babel/runtime/regenerator";
 import { useMemo, useCallback } from 'react';
 import { auth } from '@atlaskit/outbound-auth-flow-client';
-import { APIError } from '@atlaskit/linking-common';
 import { useSmartLinkContext } from '@atlaskit/link-provider';
-import { ACTION_PENDING, ACTION_RESOLVED, ACTION_ERROR, ACTION_ERROR_FALLBACK, ACTION_RELOADING, cardAction } from '@atlaskit/linking-common';
+import { ACTION_PENDING, ACTION_RESOLVED, ACTION_ERROR, ACTION_ERROR_FALLBACK, ACTION_RELOADING, ACTION_UPDATE_METADATA_STATUS, cardAction, APIError } from '@atlaskit/linking-common';
 import { getDefinitionId, getByDefinitionId, getServices, getStatus, getExtensionKey } from '../helpers';
-import { ERROR_MESSAGE_OAUTH, ERROR_MESSAGE_FATAL } from './constants';
+import { ERROR_MESSAGE_OAUTH, ERROR_MESSAGE_FATAL, ERROR_MESSAGE_METADATA } from './constants';
 import * as measure from '../../utils/performance';
 import { getUnauthorizedJsonLd } from '../../utils/jsonld';
 import { addMetadataToExperience } from '../analytics';
@@ -24,11 +23,23 @@ export var useSmartCardActions = function useSmartCardActions(id, url, analytics
     details: undefined
   },
       details = _ref.details,
-      status = _ref.status;
+      status = _ref.status,
+      metadataStatus = _ref.metadataStatus;
 
   var hasAuthFlowSupported = config.authFlow !== 'disabled';
   var hasData = !!(details && details.data);
-  var handleResolvedLinkError = useCallback(function (url, error, response) {
+  var setMetadataStatus = useCallback(function (metadataStatus) {
+    dispatch(cardAction(ACTION_UPDATE_METADATA_STATUS, {
+      url: url
+    }, undefined, undefined, metadataStatus));
+  }, [dispatch, url]);
+  var handleResolvedLinkError = useCallback(function (url, error, response, isMetadataRequest) {
+    // If metadata request then set metadata status, return and do not alter link status
+    if (isMetadataRequest) {
+      setMetadataStatus('errored');
+      return;
+    }
+
     if (error.kind === 'fatal') {
       // If there's no previous data in the store for this URL, then bail
       // out and let the editor handle fallbacks (returns to a blue link).
@@ -65,25 +76,34 @@ export var useSmartCardActions = function useSmartCardActions(id, url, analytics
         }, undefined, error));
       }
     }
-  }, [hasData, status, dispatch, details]);
+  }, [setMetadataStatus, hasData, status, dispatch, details]);
   var handleResolvedLinkResponse = useCallback(function (resourceUrl, response) {
     var isReloading = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : false;
+    var isMetadataRequest = arguments.length > 3 ? arguments[3] : undefined;
     var hostname = new URL(resourceUrl).hostname;
     var nextStatus = response ? getStatus(response) : 'fatal'; // If we require authorization & do not have an authFlow available,
     // throw an error and render as a normal blue link.
 
     if ((nextStatus === 'unauthorized' || nextStatus === 'forbidden') && !hasAuthFlowSupported) {
-      handleResolvedLinkError(resourceUrl, new APIError('fallback', hostname, ERROR_MESSAGE_OAUTH), response);
+      handleResolvedLinkError(resourceUrl, new APIError('fallback', hostname, ERROR_MESSAGE_OAUTH), response, isMetadataRequest);
       return;
     } // Handle any other errors
 
 
     if (nextStatus === 'fatal') {
-      handleResolvedLinkError(resourceUrl, new APIError('fatal', hostname, ERROR_MESSAGE_FATAL));
+      handleResolvedLinkError(resourceUrl, new APIError('fatal', hostname, ERROR_MESSAGE_FATAL), undefined, isMetadataRequest);
+      return;
+    } // Handle errors of any other kind in the metadata request response
+
+
+    if (isMetadataRequest && nextStatus !== 'resolved') {
+      handleResolvedLinkError(resourceUrl, new APIError('error', hostname, ERROR_MESSAGE_METADATA), response, isMetadataRequest);
       return;
-    } // Dispatch Analytics and resolved card action - including unauthorized states.
+    } //if a link resolves normally, metadata will also always be resolved
 
 
+    setMetadataStatus('resolved'); // Dispatch Analytics and resolved card action - including unauthorized states.
+
     if (isReloading) {
       dispatch(cardAction(ACTION_RELOADING, {
         url: resourceUrl
@@ -91,12 +111,13 @@ export var useSmartCardActions = function useSmartCardActions(id, url, analytics
     } else {
       dispatch(cardAction(ACTION_RESOLVED, {
         url: resourceUrl
-      }, response));
+      }, response, undefined, undefined, isMetadataRequest));
     }
-  }, [dispatch, handleResolvedLinkError, hasAuthFlowSupported]);
+  }, [dispatch, handleResolvedLinkError, hasAuthFlowSupported, setMetadataStatus]);
   var resolve = useCallback( /*#__PURE__*/_asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee() {
     var resourceUrl,
         isReloading,
+        isMetadataRequest,
         _args = arguments;
     return _regeneratorRuntime.wrap(function _callee$(_context) {
       while (1) {
@@ -104,24 +125,25 @@ export var useSmartCardActions = function useSmartCardActions(id, url, analytics
           case 0:
             resourceUrl = _args.length > 0 && _args[0] !== undefined ? _args[0] : url;
             isReloading = _args.length > 1 && _args[1] !== undefined ? _args[1] : false;
+            isMetadataRequest = _args.length > 2 && _args[2] !== undefined ? _args[2] : false;
 
-            if (!(isReloading || !hasData)) {
-              _context.next = 6;
+            if (!(isReloading || !hasData || isMetadataRequest)) {
+              _context.next = 7;
               break;
             }
 
             return _context.abrupt("return", connections.client.fetchData(resourceUrl).then(function (response) {
-              return handleResolvedLinkResponse(resourceUrl, response, isReloading);
+              return handleResolvedLinkResponse(resourceUrl, response, isReloading, isMetadataRequest);
             }).catch(function (error) {
-              return handleResolvedLinkError(resourceUrl, error);
+              return handleResolvedLinkError(resourceUrl, error, undefined, isMetadataRequest);
             }));
 
-          case 6:
+          case 7:
             addMetadataToExperience('smart-link-rendered', id, {
               cached: true
             });
 
-          case 7:
+          case 8:
           case "end":
             return _context.stop();
         }
@@ -133,10 +155,11 @@ export var useSmartCardActions = function useSmartCardActions(id, url, analytics
       dispatch(cardAction(ACTION_PENDING, {
         url: url
       }));
+      setMetadataStatus('pending');
     }
 
     return resolve();
-  }, [url, resolve, details, dispatch]);
+  }, [details, resolve, dispatch, url, setMetadataStatus]);
   var reload = useCallback(function () {
     var definitionId = getDefinitionId(details);
 
@@ -148,6 +171,13 @@ export var useSmartCardActions = function useSmartCardActions(id, url, analytics
       resolve(url, true);
     }
   }, [url, details, getState, resolve]);
+  var loadMetadata = useCallback(function () {
+    //metadataStatus will be undefined for SSR links only
+    if (metadataStatus === undefined) {
+      setMetadataStatus('pending');
+      return resolve(url, false, true);
+    }
+  }, [metadataStatus, resolve, setMetadataStatus, url]);
   var authorize = useCallback(function (appearance) {
     var definitionId = getDefinitionId(details);
     var extensionKey = getExtensionKey(details);
@@ -243,7 +273,8 @@ export var useSmartCardActions = function useSmartCardActions(id, url, analytics
       register: register,
       reload: reload,
       authorize: authorize,
-      invoke: invoke
+      invoke: invoke,
+      loadMetadata: loadMetadata
     };
-  }, [register, reload, authorize, invoke]);
+  }, [register, reload, authorize, invoke, loadMetadata]);
 };

package/dist/esm/version.json

@@ -1,5 +1,5 @@
 {
 	"name": "@atlaskit/smart-card",
-	"version": "20.0.6",
+	"version": "20.1.0",
 	"sideEffects": false
 }