@spare-technologies/spare-link 0.1.0-beta.1 → 1.0.1

package/lib/commonjs/ui/hosted/hosted-payment-page.js

@@ -0,0 +1,177 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.HostedPaymentPage = HostedPaymentPage;
+var _react = require("react");
+var _reactNative = require("react-native");
+var _hostedFlowState = require("../../core/services/hosted-flow-state.js");
+var _useHostedFlowState = require("../hooks/use-hosted-flow-state.js");
+var _pageUnavailableScreen = require("../screens/page-unavailable-screen.js");
+var _redirectHandoffScreen = require("../screens/redirect-handoff-screen.js");
+var _resultScreen = require("../screens/result-screen.js");
+var _resumeProcessingScreen = require("../screens/resume-processing-screen.js");
+var _index = require("../theme/index.js");
+var _hostedPaymentWebview = require("./hosted-payment-webview.js");
+var _jsxRuntime = require("react/jsx-runtime");
+/** How long a resolved outcome stays on screen before the flow hands back. */const RESULT_DWELL_MS = 1200;
+/**
+ * The screen a payer sees for the whole flow.
+ *
+ * Most of it is the hosted page. The native screens cover the moments the page
+ * cannot: while it loads, while the payer is away at their bank, and once there is
+ * an outcome to report.
+ */
+function HostedPaymentPage(props) {
+  const {
+    controller,
+    baseUrl,
+    onResolved
+  } = props;
+  const state = (0, _useHostedFlowState.useHostedFlowState)(controller);
+
+  /**
+   * When the payer left for the bank.
+   *
+   * Held here rather than in the waiting screen because returning from the browser
+   * can remount it, and a fresh component would otherwise restart the wait from
+   * zero and never offer the payer a way out.
+   */
+  const awaitingSinceMs = (0, _react.useRef)(undefined);
+  if (state.phase === 'awaitingCallback' && awaitingSinceMs.current === undefined) {
+    awaitingSinceMs.current = Date.now();
+  }
+
+  // Only a page that was *never reached* gets the recovery treatment: the payer
+  // already read why and chose to leave, so there is nothing to report back and no
+  // reason to show a result screen on the way out.
+  //
+  // A page that failed after it was working (`page_lost`) is a different case. It
+  // is terminal, so a retry there would render a button that does nothing, and the
+  // payer has not read anything yet — they get the result screen.
+  const wasNeverReached = state.errorCode === 'page_unavailable';
+
+  // Leaves the outcome on screen briefly, then hands it to the caller. Resolving in
+  // the same frame the outcome arrives would flash the result past a payer who has
+  // been waiting on it.
+  const resolved = (0, _hostedFlowState.isTerminalPhase)(state.phase);
+  (0, _react.useEffect)(() => {
+    if (!resolved) return;
+    const timer = setTimeout(onResolved, wasNeverReached ? 0 : RESULT_DWELL_MS);
+    return () => clearTimeout(timer);
+  }, [resolved, onResolved, wasNeverReached]);
+  const handleBridgeMessage = (0, _react.useCallback)(message => {
+    void controller.handleBridgeMessage(message);
+  }, [controller]);
+  const handleLoadFailure = (0, _react.useCallback)(() => {
+    controller.failToLoad();
+  }, [controller]);
+  const handlePageMounted = (0, _react.useCallback)(() => {
+    controller.reportPageMounted();
+  }, [controller]);
+  const handleRetry = (0, _react.useCallback)(() => {
+    controller.retry();
+  }, [controller]);
+  const handleGiveUp = (0, _react.useCallback)(() => {
+    controller.giveUp();
+  }, [controller]);
+  switch (state.phase) {
+    case 'loading':
+    case 'hosted':
+      return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+        style: styles.fill,
+        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+          style: styles.fill
+          // While covered the page is not just invisible but unreachable: left
+          // in the tree, a screen reader could act on content nobody can see.
+          ,
+          accessibilityElementsHidden: state.phase === 'loading',
+          importantForAccessibility: state.phase === 'loading' ? 'no-hide-descendants' : 'auto',
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_hostedPaymentWebview.HostedPaymentWebView
+          // Keyed on the attempt so a retry mounts a fresh webview. Reusing the
+          // instance that failed would show the payer the same dead frame.
+          , {
+            baseUrl: baseUrl,
+            reference: controller.reference,
+            onBridgeMessage: handleBridgeMessage,
+            onLoadFailure: handleLoadFailure,
+            onMounted: handlePageMounted
+          }, state.attempt)
+        }), state.phase === 'loading' ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+          style: styles.loadingCover,
+          testID: "hosted-payment-loading",
+          children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.ActivityIndicator, {
+            size: "large",
+            color: _index.Colors.spareBlue,
+            testID: "hosted-payment-loading-spinner"
+          }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+            style: [_index.Typography.bodyMuted, styles.loadingLabel],
+            children: state.attempt > 1 ? 'Trying again…' : 'Loading your payment…'
+          })]
+        }) : null]
+      });
+    case 'unreachable':
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_pageUnavailableScreen.PageUnavailableScreen, {
+        onRetry: handleRetry,
+        onCancel: handleGiveUp
+      });
+    case 'redirecting':
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_redirectHandoffScreen.RedirectHandoffScreen, {});
+    case 'awaitingCallback':
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_resumeProcessingScreen.ResumeProcessingScreen, {
+        ...(awaitingSinceMs.current !== undefined ? {
+          awaitingCallbackStartedAtMs: awaitingSinceMs.current
+        } : {}),
+        // The bank may never send the payer back. This is their way out of a
+        // screen that would otherwise wait forever. It reports the flow as
+        // unresolved rather than cancelled, because a payer who authorized and
+        // then lost the return has still paid.
+        onCancel: () => controller.abandon()
+      });
+    case 'succeeded':
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_resultScreen.ResultScreen, {
+        title: "Payment complete",
+        isSuccess: true,
+        onDone: onResolved
+      });
+    case 'failed':
+      return wasNeverReached ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_pageUnavailableScreen.PageUnavailableScreen, {
+        onRetry: handleRetry,
+        onCancel: handleGiveUp
+      }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_resultScreen.ResultScreen, {
+        title: "Payment failed",
+        isSuccess: false,
+        onDone: onResolved
+      });
+    case 'cancelled':
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_resultScreen.ResultScreen, {
+        title: "Payment cancelled",
+        isSuccess: false,
+        onDone: onResolved
+      });
+    case 'abandoned':
+      return /*#__PURE__*/(0, _jsxRuntime.jsx)(_resultScreen.ResultScreen, {
+        title: "Payment not completed",
+        isSuccess: false,
+        onDone: onResolved
+      });
+  }
+}
+const styles = _reactNative.StyleSheet.create({
+  fill: {
+    flex: 1,
+    backgroundColor: _index.Colors.surfacePage
+  },
+  loadingCover: {
+    ..._reactNative.StyleSheet.absoluteFillObject,
+    alignItems: 'center',
+    justifyContent: 'center',
+    gap: _index.Spacing.lg,
+    backgroundColor: _index.Colors.surfacePage
+  },
+  loadingLabel: {
+    textAlign: 'center'
+  }
+});
+//# sourceMappingURL=hosted-payment-page.js.map

package/lib/commonjs/ui/hosted/hosted-payment-page.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_reactNative","_hostedFlowState","_useHostedFlowState","_pageUnavailableScreen","_redirectHandoffScreen","_resultScreen","_resumeProcessingScreen","_index","_hostedPaymentWebview","_jsxRuntime","RESULT_DWELL_MS","HostedPaymentPage","props","controller","baseUrl","onResolved","state","useHostedFlowState","awaitingSinceMs","useRef","undefined","phase","current","Date","now","wasNeverReached","errorCode","resolved","isTerminalPhase","useEffect","timer","setTimeout","clearTimeout","handleBridgeMessage","useCallback","message","handleLoadFailure","failToLoad","handlePageMounted","reportPageMounted","handleRetry","retry","handleGiveUp","giveUp","jsxs","View","style","styles","fill","children","jsx","accessibilityElementsHidden","importantForAccessibility","HostedPaymentWebView","reference","onBridgeMessage","onLoadFailure","onMounted","attempt","loadingCover","testID","ActivityIndicator","size","color","Colors","spareBlue","Text","Typography","bodyMuted","loadingLabel","PageUnavailableScreen","onRetry","onCancel","RedirectHandoffScreen","ResumeProcessingScreen","awaitingCallbackStartedAtMs","abandon","ResultScreen","title","isSuccess","onDone","StyleSheet","create","flex","backgroundColor","surfacePage","absoluteFillObject","alignItems","justifyContent","gap","Spacing","lg","textAlign"],"sourceRoot":"../../../../src","sources":["ui/hosted/hosted-payment-page.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/ui/hosted/hosted-payment-webview.js

@@ -0,0 +1,168 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.HostedPaymentWebView = HostedPaymentWebView;
+exports.shouldAllowHostedNavigation = shouldAllowHostedNavigation;
+var _react = require("react");
+var _reactNative = require("react-native");
+var _reactNativeWebview = require("react-native-webview");
+var _hostedUrl = require("../../internal/hosted/hosted-url.js");
+var _logger = require("../../internal/logger.js");
+var _urlParts = require("../../internal/url-parts.js");
+var _index = require("../theme/index.js");
+var _jsxRuntime = require("react/jsx-runtime");
+const log = (0, _logger.createLogger)('HostedPaymentWebView');
+
+/**
+ * Reduces a URL to scheme and host for logging.
+ *
+ * The path carries the payment request reference, which is the flow's only
+ * credential and stays out of the log. Scheme and host are what distinguish a
+ * misconfigured environment from a service that is down.
+ */
+function safeOrigin(url) {
+  const parts = (0, _urlParts.parseUrlParts)(url);
+  return parts ? `${parts.scheme}://${parts.host}` : '[unparseable URL]';
+}
+
+/**
+ * Whether a navigation the WebView is about to make should be allowed.
+ *
+ * Only the hosted origin may load in-frame. Bank authentication deliberately
+ * happens in a real browser, so a bank URL arriving here means the page's handoff
+ * did not reach us — following it would put the payer on a bank page with no
+ * address bar, which is the signal they rely on to tell a real one from a copy.
+ * Kept as a plain function because the WebView does not render under Jest, and
+ * this is the part worth testing.
+ */
+function shouldAllowHostedNavigation(args) {
+  return (0, _hostedUrl.isHostedOriginUrl)(args);
+}
+/**
+ * Hosts the hosted payment page.
+ *
+ * The page owns bank selection, the payee check and the consent screen, so this
+ * component carries no payment logic of its own: it loads one URL, forwards what
+ * the page reports, and refuses to navigate anywhere else.
+ */
+function HostedPaymentWebView(props) {
+  const {
+    baseUrl,
+    reference,
+    onBridgeMessage,
+    onLoadFailure,
+    onMounted
+  } = props;
+  const uri = (0, _hostedUrl.buildHostedPaymentUrl)({
+    baseUrl,
+    reference
+  });
+
+  // This reports that *this* webview exists, and a retry mounts a fresh instance
+  // which reports itself anew. Re-running on a new callback identity would
+  // restart the page's clock without a new page having been asked for.
+  // biome-ignore lint/correctness/useExhaustiveDependencies: mount-only by design
+  (0, _react.useEffect)(() => {
+    onMounted?.();
+  }, []);
+  const handleMessage = (0, _react.useCallback)(event => {
+    onBridgeMessage(event.nativeEvent.data);
+  }, [onBridgeMessage]);
+
+  // Every navigation is routed through here rather than through `originWhitelist`.
+  // A URL that fails the whitelist is handed to `Linking.openURL` by
+  // react-native-webview with no scheme check of its own and without consulting
+  // this callback, which would let the page reach `intent://` or any registered
+  // scheme on the device. Whitelisting everything keeps that branch unreachable
+  // and leaves the decision here, where an off-origin navigation is refused
+  // outright and the bank arrives over the bridge instead.
+  const handleShouldStartLoad = (0, _react.useCallback)(({
+    url
+  }) => shouldAllowHostedNavigation({
+    baseUrl,
+    url
+  }), [baseUrl]);
+  return (
+    /*#__PURE__*/
+    // The page is a full-bleed document that knows nothing about this device's
+    // notch or home indicator. `SpareLinkHost` holds the inset out for the whole
+    // modal, so this fills what it is given.
+    (0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: styles.container,
+      testID: "hosted-payment-webview",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeWebview.WebView, {
+        source: {
+          uri
+        },
+        onMessage: handleMessage,
+        originWhitelist: ALLOW_ALL_ORIGINS,
+        onShouldStartLoadWithRequest: handleShouldStartLoad
+        // react-native-webview reports only main-frame failures: `onHttpError` is
+        // guarded by `isForMainFrame`, and it overrides the main-frame-only
+        // `onReceivedError` overload. So a 404 on a favicon the WebView asked for
+        // on its own cannot fail the payment.
+        //
+        // What went wrong is logged before it is collapsed into
+        // `page_unavailable`, which on its own cannot tell a service that is down
+        // from a host that was never reachable.
+        ,
+        onError: ({
+          nativeEvent
+        }) => {
+          log.severe(`could not load the payment page from ${safeOrigin(uri)} ` + `(${nativeEvent.description ?? `code ${nativeEvent.code}`})`);
+          onLoadFailure?.();
+        },
+        onHttpError: ({
+          nativeEvent
+        }) => {
+          log.severe(`the payment page at ${safeOrigin(uri)} answered ` + `HTTP ${nativeEvent.statusCode}`);
+          onLoadFailure?.();
+        }
+        // A webview whose process dies reports neither of the callbacks above: the
+        // frame simply goes blank and stays blank. iOS terminates the content
+        // process under memory pressure and Android's renderer can be reclaimed
+        // outright, so both are treated as the page having failed to load.
+        ,
+        onContentProcessDidTerminate: () => {
+          log.severe('the payment page process was terminated by the system (iOS)');
+          onLoadFailure?.();
+        },
+        onRenderProcessGone: ({
+          nativeEvent
+        }) => {
+          log.severe(`the payment page renderer was lost (Android, crashed=${nativeEvent.didCrash})`);
+          onLoadFailure?.();
+        },
+        style: styles.webview,
+        javaScriptEnabled: true,
+        domStorageEnabled: true
+        // The page holds a payment in progress and nothing else should share its
+        // storage, on this device or between payers on it.
+        ,
+        incognito: true
+        // The bank is handed to the OS browser over the bridge, so nothing here
+        // needs popups.
+        ,
+        setSupportMultipleWindows: false,
+        allowFileAccess: false,
+        allowUniversalAccessFromFileURLs: false,
+        allowFileAccessFromFileURLs: false,
+        testID: "hosted-payment-webview-instance"
+      })
+    })
+  );
+}
+const ALLOW_ALL_ORIGINS = ['*'];
+const styles = _reactNative.StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: _index.Colors.surfacePage
+  },
+  webview: {
+    flex: 1,
+    backgroundColor: _index.Colors.surfacePage
+  }
+});
+//# sourceMappingURL=hosted-payment-webview.js.map

package/lib/commonjs/ui/hosted/hosted-payment-webview.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_react","require","_reactNative","_reactNativeWebview","_hostedUrl","_logger","_urlParts","_index","_jsxRuntime","log","createLogger","safeOrigin","url","parts","parseUrlParts","scheme","host","shouldAllowHostedNavigation","args","isHostedOriginUrl","HostedPaymentWebView","props","baseUrl","reference","onBridgeMessage","onLoadFailure","onMounted","uri","buildHostedPaymentUrl","useEffect","handleMessage","useCallback","event","nativeEvent","data","handleShouldStartLoad","jsx","View","style","styles","container","testID","children","WebView","source","onMessage","originWhitelist","ALLOW_ALL_ORIGINS","onShouldStartLoadWithRequest","onError","severe","description","code","onHttpError","statusCode","onContentProcessDidTerminate","onRenderProcessGone","didCrash","webview","javaScriptEnabled","domStorageEnabled","incognito","setSupportMultipleWindows","allowFileAccess","allowUniversalAccessFromFileURLs","allowFileAccessFromFileURLs","StyleSheet","create","flex","backgroundColor","Colors","surfacePage"],"sourceRoot":"../../../../src","sources":["ui/hosted/hosted-payment-webview.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/ui/screens/index.js

@@ -3,22 +3,10 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-Object.defineProperty(exports, "BankSelectionScreen", {
+Object.defineProperty(exports, "PageUnavailableScreen", {
   enumerable: true,
   get: function () {
-    return _bankSelectionScreen.BankSelectionScreen;
-  }
-});
-Object.defineProperty(exports, "ConsentDetailsScreen", {
-  enumerable: true,
-  get: function () {
-    return _consentDetailsScreen.ConsentDetailsScreen;
-  }
-});
-Object.defineProperty(exports, "MandateSetupSuccessScreen", {
-  enumerable: true,
-  get: function () {
-    return _mandateSetupSuccessScreen.MandateSetupSuccessScreen;
+    return _pageUnavailableScreen.PageUnavailableScreen;
   }
 });
 Object.defineProperty(exports, "RedirectHandoffScreen", {
@@ -39,10 +27,8 @@ Object.defineProperty(exports, "ResumeProcessingScreen", {
     return _resumeProcessingScreen.ResumeProcessingScreen;
   }
 });
-var _bankSelectionScreen = require("./bank-selection-screen.js");
-var _consentDetailsScreen = require("./consent-details-screen.js");
+var _pageUnavailableScreen = require("./page-unavailable-screen.js");
 var _redirectHandoffScreen = require("./redirect-handoff-screen.js");
 var _resumeProcessingScreen = require("./resume-processing-screen.js");
 var _resultScreen = require("./result-screen.js");
-var _mandateSetupSuccessScreen = require("./mandate-setup-success-screen.js");
 //# sourceMappingURL=index.js.map

package/lib/commonjs/ui/screens/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_bankSelectionScreen","require","_consentDetailsScreen","_redirectHandoffScreen","_resumeProcessingScreen","_resultScreen","_mandateSetupSuccessScreen"],"sourceRoot":"../../../../src","sources":["ui/screens/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,oBAAA,GAAAC,OAAA;AACA,IAAAC,qBAAA,GAAAD,OAAA;AACA,IAAAE,sBAAA,GAAAF,OAAA;AACA,IAAAG,uBAAA,GAAAH,OAAA;AAIA,IAAAI,aAAA,GAAAJ,OAAA;AACA,IAAAK,0BAAA,GAAAL,OAAA","ignoreList":[]}
+{"version":3,"names":["_pageUnavailableScreen","require","_redirectHandoffScreen","_resumeProcessingScreen","_resultScreen"],"sourceRoot":"../../../../src","sources":["ui/screens/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,sBAAA,GAAAC,OAAA;AAIA,IAAAC,sBAAA,GAAAD,OAAA;AACA,IAAAE,uBAAA,GAAAF,OAAA;AAIA,IAAAG,aAAA,GAAAH,OAAA","ignoreList":[]}

package/lib/commonjs/ui/screens/page-unavailable-screen.js

@@ -0,0 +1,101 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PageUnavailableScreen = PageUnavailableScreen;
+var _vectorIcons = require("@expo/vector-icons");
+var _reactNative = require("react-native");
+var _index = require("../theme/index.js");
+var _jsxRuntime = require("react/jsx-runtime");
+/**
+ * Shown when the payment page could not be loaded, or loaded and never became
+ * interactive.
+ *
+ * It deliberately does not say the payment failed. Nothing has been attempted at
+ * this point — no consent, no bank, no money — and telling a payer their payment
+ * failed when the app could not open the page is the one thing they must not be
+ * told. It says what is true, says nothing has been taken, and offers the page
+ * again, because an unreachable service is usually unreachable briefly.
+ */
+function PageUnavailableScreen(props) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    style: styles.container,
+    testID: "page-unavailable-screen",
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+      style: styles.iconBubble,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_vectorIcons.Ionicons, {
+        name: "cloud-offline-outline",
+        size: 36,
+        color: _index.Colors.textMuted
+      })
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: _index.Typography.title,
+      testID: "page-unavailable-message",
+      children: "We couldn't reach the payment service"
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: [_index.Typography.bodyMuted, styles.centered],
+      children: "No payment has been taken. Check your connection and try again."
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+      onPress: props.onRetry,
+      accessibilityRole: "button",
+      testID: "page-unavailable-retry-btn",
+      style: [styles.button, styles.retryButton],
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: [_index.Typography.button, styles.retryLabel],
+        children: "Try again"
+      })
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+      onPress: props.onCancel,
+      accessibilityRole: "button",
+      testID: "page-unavailable-cancel-btn",
+      style: [styles.button, styles.cancelButton],
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: [_index.Typography.button, styles.cancelLabel],
+        children: "Cancel"
+      })
+    })]
+  });
+}
+const styles = _reactNative.StyleSheet.create({
+  container: {
+    flex: 1,
+    alignItems: 'center',
+    justifyContent: 'center',
+    padding: _index.Spacing.xl,
+    gap: _index.Spacing.lg,
+    backgroundColor: _index.Colors.surfacePage
+  },
+  iconBubble: {
+    width: 72,
+    height: 72,
+    borderRadius: 36,
+    alignItems: 'center',
+    justifyContent: 'center',
+    backgroundColor: _index.Colors.surfaceMuted
+  },
+  centered: {
+    textAlign: 'center'
+  },
+  button: {
+    paddingHorizontal: _index.Spacing.xl,
+    paddingVertical: _index.Spacing.md,
+    borderRadius: 12,
+    minWidth: 160,
+    alignItems: 'center'
+  },
+  retryButton: {
+    marginTop: _index.Spacing.md,
+    backgroundColor: _index.Colors.spareBlue
+  },
+  retryLabel: {
+    color: '#FFFFFF'
+  },
+  cancelButton: {
+    backgroundColor: _index.Colors.surfaceMuted
+  },
+  cancelLabel: {
+    color: _index.Colors.textPrimary
+  }
+});
+//# sourceMappingURL=page-unavailable-screen.js.map

package/lib/commonjs/ui/screens/page-unavailable-screen.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_vectorIcons","require","_reactNative","_index","_jsxRuntime","PageUnavailableScreen","props","jsxs","View","style","styles","container","testID","children","jsx","iconBubble","Ionicons","name","size","color","Colors","textMuted","Text","Typography","title","bodyMuted","centered","Pressable","onPress","onRetry","accessibilityRole","button","retryButton","retryLabel","onCancel","cancelButton","cancelLabel","StyleSheet","create","flex","alignItems","justifyContent","padding","Spacing","xl","gap","lg","backgroundColor","surfacePage","width","height","borderRadius","surfaceMuted","textAlign","paddingHorizontal","paddingVertical","md","minWidth","marginTop","spareBlue","textPrimary"],"sourceRoot":"../../../../src","sources":["ui/screens/page-unavailable-screen.tsx"],"mappings":"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","ignoreList":[]}