@symbiote-native/web-browser 0.0.1

package/build-ngc/core/web-browser.js

@@ -0,0 +1,257 @@
+// Hand-ported from .vendors/expo/packages/expo-web-browser/src/WebBrowser.ts (sdk-57). Two
+// deliberate departures from upstream, both because SymbioteNative has no web target:
+// `maybeCompleteAuthSession` is not ported (it exists only to close a `window.open` popup; on a
+// native platform it can do nothing but return `{ type: 'failed' }`), and the web-only open
+// options are gone from IWebBrowserOpenOptions.
+import { Platform, UnavailabilityError } from 'expo-modules-core';
+import { AppState, Linking, processColor } from 'react-native';
+import { expoWebBrowser } from './native-module';
+import { WebBrowserResultType, } from './types';
+const NATIVE_MODULE_NAME = 'expo-web-browser';
+const EMPTY_CUSTOM_TABS_PACKAGES = {
+    defaultBrowserPackage: undefined,
+    preferredBrowserPackage: undefined,
+    browserPackages: [],
+    servicePackages: [],
+};
+/**
+ * The packages that support Custom Tabs, the Custom Tabs service, and the user's chosen and
+ * preferred browser. Only as reliable as `PackageManager.getResolvingActivities` underneath — a
+ * browser can be missing from `browserPackages` once another one is set as default.
+ *
+ * @platform android
+ */
+export async function getCustomTabsSupportingBrowsersAsync() {
+    // iOS registers its no-op stub as `getCustomTabsSupportingBrowsers`, without the `Async`
+    // suffix, so this guard — kept in upstream's order deliberately — fires there before the
+    // non-Android early return below can be reached.
+    if (!expoWebBrowser.getCustomTabsSupportingBrowsersAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'getCustomTabsSupportingBrowsersAsync');
+    }
+    if (Platform.OS !== 'android') {
+        return EMPTY_CUSTOM_TABS_PACKAGES;
+    }
+    return expoWebBrowser.getCustomTabsSupportingBrowsersAsync();
+}
+/**
+ * Calls `warmUp` on the [`CustomTabsClient`](https://developer.android.com/reference/androidx/browser/customtabs/CustomTabsClient#warmup(long))
+ * for the given package.
+ *
+ * @param browserPackage Browser to warm up. Defaults to the preferred one.
+ * @platform android
+ */
+export async function warmUpAsync(browserPackage) {
+    if (!expoWebBrowser.warmUpAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'warmUpAsync');
+    }
+    if (Platform.OS !== 'android') {
+        return {};
+    }
+    return expoWebBrowser.warmUpAsync(browserPackage);
+}
+/**
+ * Starts a [`CustomTabsSession`](https://developer.android.com/reference/androidx/browser/customtabs/CustomTabsSession#mayLaunchUrl(android.net.Uri,android.os.Bundle,java.util.List%3Candroid.os.Bundle%3E))
+ * if needed and calls its `mayLaunchUrl`, so the browser can prefetch the page.
+ *
+ * @param url The page most likely to be opened first.
+ * @param browserPackage Browser to inform. Defaults to the preferred one.
+ * @platform android
+ */
+export async function mayInitWithUrlAsync(url, browserPackage) {
+    if (!expoWebBrowser.mayInitWithUrlAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'mayInitWithUrlAsync');
+    }
+    if (Platform.OS !== 'android') {
+        return {};
+    }
+    return expoWebBrowser.mayInitWithUrlAsync(url, browserPackage);
+}
+/**
+ * Drops every binding `warmUpAsync` and `mayInitWithUrlAsync` created. Call it once the bindings
+ * are no longer needed to avoid leaking them — though they are also released when the app is
+ * destroyed, which is often good enough.
+ *
+ * @param browserPackage Browser to cool down. Defaults to the preferred one.
+ * @returns The cooled service, or an empty object when there was no connection to dismiss.
+ * @platform android
+ */
+export async function coolDownAsync(browserPackage) {
+    if (!expoWebBrowser.coolDownAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'coolDownAsync');
+    }
+    if (Platform.OS !== 'android') {
+        return {};
+    }
+    return expoWebBrowser.coolDownAsync(browserPackage);
+}
+/**
+ * Opens the url in a modal [`SFSafariViewController`](https://developer.apple.com/documentation/safariservices/sfsafariviewcontroller)
+ * on iOS and a [Custom Tab](https://developer.chrome.com/docs/android/custom-tabs) on Android. The
+ * modal Safari does not share cookies with the system Safari — for a login flow that needs them,
+ * use `openAuthSessionAsync`.
+ *
+ * @returns Android resolves with `{ type: 'opened' }` as soon as the tab launches, without waiting
+ * for the user to close it. iOS resolves with `{ type: 'cancel' }` when the user dismissed the
+ * browser and `{ type: 'dismiss' }` when `dismissBrowser` closed it.
+ */
+export async function openBrowserAsync(url, browserParams = {}) {
+    if (!expoWebBrowser.openBrowserAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'openBrowserAsync');
+    }
+    return expoWebBrowser.openBrowserAsync(url, processOptions(browserParams));
+}
+/**
+ * Dismisses the presented browser. Throws where dismissing isn't available — Android's Custom Tabs
+ * offer no way to close a tab programmatically, so there the user has to press the tab's own close
+ * button.
+ *
+ * @platform ios
+ */
+export function dismissBrowser() {
+    if (!expoWebBrowser.dismissBrowser) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'dismissBrowser');
+    }
+    return expoWebBrowser.dismissBrowser();
+}
+/**
+ * Opens a login page and resolves once the authentication provider redirects back to the app.
+ *
+ * On iOS this is `ASWebAuthenticationSession`, which asks the user whether the app may
+ * authenticate with the given url; the redirect URI registered with the authentication server has
+ * to use the app's own scheme (`demo://…`, not `https://…`). Adding a `Linking` listener of your
+ * own is unnecessary there and can have side effects.
+ *
+ * Android has no equivalent native API, so it is polyfilled: a Custom Tab plus `AppState` and
+ * `Linking`, racing "the deep link came back" against "the app returned to the foreground". Only
+ * one such session can be open at a time.
+ *
+ * @param url The login page to open.
+ * @param redirectUrl The url that deep-links back into the app. Without it the session can only
+ * end by the user closing the browser.
+ * @returns `{ type: 'success', url }` with the redirect url on a completed login,
+ * `{ type: 'cancel' }` when the user declined or closed the browser, and `{ type: 'dismiss' }` when
+ * `dismissBrowser` closed it.
+ */
+export async function openAuthSessionAsync(url, redirectUrl, options = {}) {
+    if (!isAuthSessionNativelySupported()) {
+        return openAuthSessionPolyfillAsync(url, redirectUrl, options);
+    }
+    if (!expoWebBrowser.openAuthSessionAsync) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'openAuthSessionAsync');
+    }
+    return expoWebBrowser.openAuthSessionAsync(url, redirectUrl, processOptions(options));
+}
+/**
+ * Dismisses the current authentication session. Falls back to dismissing the plain browser where
+ * there is no native auth session, which on Android throws for the same reason `dismissBrowser`
+ * does.
+ *
+ * @platform ios
+ */
+export function dismissAuthSession() {
+    if (isAuthSessionNativelySupported()) {
+        if (!expoWebBrowser.dismissAuthSession) {
+            throw new UnavailabilityError(NATIVE_MODULE_NAME, 'dismissAuthSession');
+        }
+        expoWebBrowser.dismissAuthSession();
+        return;
+    }
+    if (!expoWebBrowser.dismissBrowser) {
+        throw new UnavailabilityError(NATIVE_MODULE_NAME, 'dismissBrowser');
+    }
+    void expoWebBrowser.dismissBrowser();
+}
+function processOptions(options) {
+    return {
+        ...options,
+        controlsColor: processColor(options.controlsColor),
+        toolbarColor: processColor(options.toolbarColor),
+        secondaryToolbarColor: processColor(options.secondaryToolbarColor),
+    };
+}
+/* Android polyfill for the ASWebAuthenticationSession flow */
+function isAuthSessionNativelySupported() {
+    return Platform.OS !== 'android';
+}
+let redirectSubscription = null;
+// `openBrowserAsync` on Android resolves the moment the Custom Tab launches, not when the user
+// closes it, so the polyfill has to watch AppState instead. This holds the `resolve` of the
+// promise that waits for the app to come back to the foreground.
+let onWebBrowserCloseAndroid = null;
+// A null initial `AppState.currentState` means the first `change` event is the bridge reporting
+// the state it captured, not a real transition — that one has to be ignored, or the session would
+// end the instant it started. See https://reactnative.dev/docs/appstate#basic-usage.
+let isAppStateAvailable = AppState.currentState !== null;
+function onAppStateChangeAndroid(state) {
+    if (!isAppStateAvailable) {
+        isAppStateAvailable = true;
+        return;
+    }
+    if (state === 'active' && onWebBrowserCloseAndroid) {
+        onWebBrowserCloseAndroid();
+    }
+}
+async function openBrowserAndWaitAndroidAsync(startUrl, browserParams = {}) {
+    const appStateChangedToActive = new Promise(resolve => {
+        onWebBrowserCloseAndroid = resolve;
+    });
+    const stateChangeSubscription = AppState.addEventListener('change', onAppStateChangeAndroid);
+    let launched;
+    try {
+        launched = await openBrowserAsync(startUrl, browserParams);
+    }
+    catch (error) {
+        stateChangeSubscription.remove();
+        onWebBrowserCloseAndroid = null;
+        throw error;
+    }
+    let result = { type: WebBrowserResultType.CANCEL };
+    if (launched.type === WebBrowserResultType.OPENED) {
+        await appStateChangedToActive;
+        result = { type: WebBrowserResultType.DISMISS };
+    }
+    stateChangeSubscription.remove();
+    onWebBrowserCloseAndroid = null;
+    return result;
+}
+async function openAuthSessionPolyfillAsync(startUrl, returnUrl, browserParams = {}) {
+    if (redirectSubscription) {
+        throw new Error("The WebBrowser's auth session is in an invalid state with a redirect handler set when it should not be");
+    }
+    if (onWebBrowserCloseAndroid) {
+        throw new Error('WebBrowser is already open, only one can be open at a time');
+    }
+    try {
+        return await Promise.race([
+            openBrowserAndWaitAndroidAsync(startUrl, browserParams),
+            waitForRedirectAsync(returnUrl),
+        ]);
+    }
+    finally {
+        // Only reachable on a platform that can dismiss a browser at all — Android users have to
+        // close the Custom Tab themselves.
+        if (expoWebBrowser.dismissBrowser) {
+            void expoWebBrowser.dismissBrowser();
+        }
+        stopWaitingForRedirect();
+    }
+}
+function stopWaitingForRedirect() {
+    if (!redirectSubscription) {
+        throw new Error('The WebBrowser auth session is in an invalid state with no redirect handler when one should be set');
+    }
+    redirectSubscription.remove();
+    redirectSubscription = null;
+}
+function waitForRedirectAsync(returnUrl) {
+    // Deliberately never resolves when `returnUrl` is nullish: the browser promise it is raced
+    // against is then the only thing that can settle the session.
+    return new Promise(resolve => {
+        redirectSubscription = Linking.addEventListener('url', (event) => {
+            if (returnUrl && event.url.startsWith(returnUrl)) {
+                resolve({ url: event.url, type: 'success' });
+            }
+        });
+    });
+}
+//# sourceMappingURL=web-browser.js.map

package/build-ngc/core/web-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-browser.js","sourceRoot":"","sources":["../../src/core/web-browser.ts"],"names":[],"mappings":"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"}

package/native-link.json

@@ -0,0 +1,12 @@
+{
+  "android": {
+    "gradleProjectName": "expo-web-browser",
+    "modules": [
+      {
+        "importPath": "expo.modules.webbrowser.WebBrowserModule",
+        "className": "WebBrowserModule",
+        "nativeName": "ExpoWebBrowser"
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,107 @@
+{
+  "name": "@symbiote-native/web-browser",
+  "version": "0.0.1",
+  "description": "expo-web-browser wrapped for SymbioteNative — one framework-agnostic core, built once and reachable from the React, Vue, and Angular adapters. In-app browser (SFSafariViewController / Android Custom Tabs) and the OAuth auth-session flow.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/OneEyed1366/symbiote-native.git",
+    "directory": "packages/web-browser"
+  },
+  "homepage": "https://github.com/OneEyed1366/symbiote-native/tree/master/packages/web-browser#readme",
+  "bugs": {
+    "url": "https://github.com/OneEyed1366/symbiote-native/issues"
+  },
+  "author": "Andrey Prokopenko <psevdoproger@gmail.com>",
+  "type": "module",
+  "main": "./build/core/index.js",
+  "module": "./build/core/index.js",
+  "types": "./build/core/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/core/index.d.ts",
+      "default": "./build/core/index.js"
+    },
+    "./vue": {
+      "types": "./build/vue/index.d.ts",
+      "default": "./build/vue/index.js"
+    },
+    "./react": {
+      "types": "./build/react/index.d.ts",
+      "default": "./build/react/index.js"
+    },
+    "./angular": {
+      "types": "./build-ngc/angular/index.d.ts",
+      "react-native": "./build-ngc/angular/index.js",
+      "default": "./src/angular/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "build",
+    "build-ngc",
+    "native-link.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "expo-web-browser": "57.0.2",
+    "expo-modules-core": "57.0.5"
+  },
+  "peerDependencies": {
+    "@symbiote-native/engine": ">=0.1.7",
+    "@angular/core": ">=20",
+    "@vue/runtime-core": "^3.5.13",
+    "react": ">=19.0.0",
+    "react-native": ">=0.86",
+    "vue": ">=3.5.0",
+    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/react": "0.2.8",
+    "@symbiote-native/vue": "0.3.8"
+  },
+  "peerDependenciesMeta": {
+    "@symbiote-native/angular": {
+      "optional": true
+    },
+    "@symbiote-native/react": {
+      "optional": true
+    },
+    "@symbiote-native/vue": {
+      "optional": true
+    },
+    "@angular/core": {
+      "optional": true
+    },
+    "@vue/runtime-core": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@angular/compiler": "^22",
+    "@angular/compiler-cli": "^22",
+    "@angular/core": "^22",
+    "@types/node": "^26.0.0",
+    "@types/react": "^19.2.0",
+    "@vue/runtime-core": "^3.5.13",
+    "react": "19.2.3",
+    "typescript": "~6.0.0",
+    "@symbiote-native/test-utils": "0.1.6",
+    "@symbiote-native/angular": "0.6.1",
+    "@symbiote-native/vue": "0.3.8",
+    "@symbiote-native/engine": "0.1.7",
+    "@symbiote-native/react": "0.2.8"
+  },
+  "scripts": {
+    "typecheck": "tsc --build",
+    "clean": "rm -rf build-ngc",
+    "ng:build": "pnpm run clean && ngc -p tsconfig.angular.json",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\""
+  }
+}

package/src/angular/index.ts

@@ -0,0 +1,4 @@
+// @symbiote-native/web-browser/angular: the Angular entry over the framework-agnostic core.
+// Nothing here holds per-instance state or hands back a subscription, so there is no lifecycle for
+// an injectable service to own — see the React entry for the full reasoning.
+export * from '../core';

package/src/core/index.ts

@@ -0,0 +1,25 @@
+export {
+  getCustomTabsSupportingBrowsersAsync,
+  warmUpAsync,
+  mayInitWithUrlAsync,
+  coolDownAsync,
+  openBrowserAsync,
+  dismissBrowser,
+  openAuthSessionAsync,
+  dismissAuthSession,
+} from './web-browser';
+export { WebBrowserResultType, WebBrowserPresentationStyle } from './types';
+export type {
+  IAuthSessionOpenOptions,
+  IRedirectEvent,
+  IServiceActionResult,
+  IWebBrowserAuthSessionResult,
+  IWebBrowserCoolDownResult,
+  IWebBrowserCustomTabsResults,
+  IWebBrowserDismissResult,
+  IWebBrowserMayInitWithUrlResult,
+  IWebBrowserOpenOptions,
+  IWebBrowserRedirectResult,
+  IWebBrowserResult,
+  IWebBrowserWarmUpResult,
+} from './types';

package/src/core/native-module.ts

@@ -0,0 +1,43 @@
+import { requireNativeModule } from 'expo-modules-core';
+import type {
+  IProcessedOpenOptions,
+  IWebBrowserAuthSessionResult,
+  IWebBrowserCoolDownResult,
+  IWebBrowserCustomTabsResults,
+  IWebBrowserDismissResult,
+  IWebBrowserMayInitWithUrlResult,
+  IWebBrowserResult,
+  IWebBrowserWarmUpResult,
+} from './types';
+
+const EXPO_WEB_BROWSER_MODULE_NAME = 'ExpoWebBrowser';
+
+// Every member is optional — the two platforms register genuinely different sets, so each call
+// site checks for presence and throws an UnavailabilityError itself rather than assuming the
+// whole surface exists:
+//   iOS   — openBrowserAsync, dismissBrowser, openAuthSessionAsync, dismissAuthSession, plus
+//           no-op warmUpAsync/coolDownAsync/mayInitWithUrlAsync stubs.
+//   Android — openBrowserAsync, warmUpAsync, coolDownAsync, mayInitWithUrlAsync,
+//           getCustomTabsSupportingBrowsersAsync. There is no way to dismiss a Custom Tab and no
+//           native auth session; the user has to press the tab's own close button.
+export type INativeWebBrowserModule = {
+  openBrowserAsync?(url: string, options: IProcessedOpenOptions): Promise<IWebBrowserResult>;
+  dismissBrowser?(): Promise<IWebBrowserDismissResult>;
+  openAuthSessionAsync?(
+    url: string,
+    redirectUrl: string | null | undefined,
+    options: IProcessedOpenOptions,
+  ): Promise<IWebBrowserAuthSessionResult>;
+  dismissAuthSession?(): void;
+  warmUpAsync?(browserPackage?: string): Promise<IWebBrowserWarmUpResult>;
+  coolDownAsync?(browserPackage?: string): Promise<IWebBrowserCoolDownResult>;
+  mayInitWithUrlAsync?(
+    url: string,
+    browserPackage?: string,
+  ): Promise<IWebBrowserMayInitWithUrlResult>;
+  getCustomTabsSupportingBrowsersAsync?(): Promise<IWebBrowserCustomTabsResults>;
+};
+
+export const expoWebBrowser = requireNativeModule<INativeWebBrowserModule>(
+  EXPO_WEB_BROWSER_MODULE_NAME,
+);

package/src/core/types.ts

@@ -0,0 +1,208 @@
+import type { ProcessedColorValue } from 'react-native';
+
+/** Payload of the deep-link event the Android auth-session polyfill listens for. */
+export type IRedirectEvent = {
+  url: string;
+};
+
+/**
+ * Options for [`openBrowserAsync`](#openbrowserasync).
+ *
+ * Upstream's two `@platform web` fields (`windowName`, `windowFeatures`) are not part of this
+ * type — SymbioteNative has no web target, so they could never be read.
+ */
+export type IWebBrowserOpenOptions = {
+  /** Color of the toolbar. Accepts any React Native color format. */
+  toolbarColor?: string;
+  /**
+   * Package name of the browser that should handle the Custom Tab. Pick one from
+   * `getCustomTabsSupportingBrowsersAsync`.
+   * @platform android
+   */
+  browserPackage?: string;
+  /** Whether the toolbar hides as the user scrolls the page. */
+  enableBarCollapsing?: boolean;
+  /**
+   * Color of the secondary toolbar. Accepts any React Native color format.
+   * @platform android
+   */
+  secondaryToolbarColor?: string;
+  /**
+   * Whether the toolbar shows the website's title.
+   * @platform android
+   */
+  showTitle?: boolean;
+  /**
+   * Whether a default share item is added to the browser's menu.
+   * @platform android
+   */
+  enableDefaultShareMenuItem?: boolean;
+  /**
+   * Whether the browsed website appears as its own entry in the recents/multitasking view.
+   * Requires `createTask` to stay `true`.
+   * @default false
+   * @platform android
+   */
+  showInRecents?: boolean;
+  /**
+   * Whether the browser opens in its own task rather than the app's.
+   * @default true
+   * @platform android
+   */
+  createTask?: boolean;
+  /**
+   * Whether to launch the browser through a transparent proxy activity with a different task
+   * affinity, which keeps the browser alive while the app is backgrounded. Only read when
+   * `createTask` is `true`, and forces `showInRecents` on. Set `false` for the legacy direct
+   * launch.
+   * @default true
+   * @platform android
+   */
+  useProxyActivity?: boolean;
+  /**
+   * Tint color for the controls in `SFSafariViewController`. Accepts any React Native color
+   * format.
+   * @platform ios
+   */
+  controlsColor?: string;
+  /**
+   * Style of the dismiss button.
+   * @platform ios
+   */
+  dismissButtonStyle?: 'done' | 'close' | 'cancel';
+  /**
+   * Whether Safari should enter Reader mode when the page supports it.
+   * @platform ios
+   */
+  readerMode?: boolean;
+  /**
+   * [Presentation style](https://developer.apple.com/documentation/uikit/uiviewcontroller/1621355-modalpresentationstyle)
+   * of the browser window.
+   * @default WebBrowserPresentationStyle.OVER_FULL_SCREEN
+   * @platform ios
+   */
+  presentationStyle?: WebBrowserPresentationStyle;
+};
+
+/**
+ * Options for [`openAuthSessionAsync`](#openauthsessionasync). Android has no native auth-session
+ * API, so there the inherited `IWebBrowserOpenOptions` fields are passed to the Custom Tab the
+ * polyfill opens; on iOS `ASWebAuthenticationSession` ignores them and reads only the two fields
+ * below.
+ */
+export type IAuthSessionOpenOptions = IWebBrowserOpenOptions & {
+  /**
+   * Ask the browser for a private authentication session, so it shares no cookies or browsing
+   * data with the user's normal session. Whether the request is honored is up to the user's
+   * default browser.
+   * @default false
+   * @platform ios
+   */
+  preferEphemeralSession?: boolean;
+  /**
+   * Use HTTPS universal-link callbacks instead of custom-URL-scheme callbacks. Needs the
+   * Associated Domains entitlement configured for the redirect URL's host, and iOS 17.4+. Left
+   * `false`, the legacy `callbackURLScheme` API is used, which needs no entitlement.
+   * @default false
+   * @platform ios
+   */
+  preferUniversalLinks?: boolean;
+};
+
+/**
+ * The open options after the three color fields have been run through `processColor`. This is the
+ * shape the native module actually receives — a color reaches native as a platform integer, never
+ * as the CSS string the caller wrote.
+ */
+export type IProcessedOpenOptions = Omit<
+  IAuthSessionOpenOptions,
+  'toolbarColor' | 'secondaryToolbarColor' | 'controlsColor'
+> & {
+  toolbarColor?: ProcessedColorValue | null;
+  secondaryToolbarColor?: ProcessedColorValue | null;
+  controlsColor?: ProcessedColorValue | null;
+};
+
+export type IWebBrowserCustomTabsResults = {
+  /**
+   * The browser the user picked as their device default, or `undefined` when there is none — which
+   * usually means the user will be prompted to choose.
+   */
+  defaultBrowserPackage?: string;
+  /**
+   * The browser `CustomTabsClient` prefers for Custom Tabs. Favors the user's default as long as
+   * it appears in both `browserPackages` and `servicePackages`; only such browsers fully support
+   * Custom Tabs. `undefined` when no installed browser qualifies.
+   */
+  preferredBrowserPackage?: string;
+  /**
+   * Every package `PackageManager` recognizes as able to handle Custom Tabs. Empty when the device
+   * has no supporting browser.
+   */
+  browserPackages: string[];
+  /**
+   * Every package `PackageManager` recognizes as able to handle the Custom Tabs *Service* — the
+   * one `warmUpAsync`, `mayInitWithUrlAsync` and `coolDownAsync` talk to.
+   */
+  servicePackages: string[];
+};
+
+/** How a browser session ended. */
+export enum WebBrowserResultType {
+  /** The user dismissed the browser themselves. @platform ios */
+  CANCEL = 'cancel',
+  /** The browser was closed by a `dismissBrowser` call. @platform ios */
+  DISMISS = 'dismiss',
+  /** The browser was launched. Android resolves here without waiting for it to close. @platform android */
+  OPENED = 'opened',
+  /** Another browser session is already in progress. */
+  LOCKED = 'locked',
+}
+
+/**
+ * A browser presentation style, mapped directly onto
+ * [`UIModalPresentationStyle`](https://developer.apple.com/documentation/uikit/uiviewcontroller/1621355-modalpresentationstyle).
+ *
+ * @platform ios
+ */
+export enum WebBrowserPresentationStyle {
+  /** The browser covers the screen. */
+  FULL_SCREEN = 'fullScreen',
+  /** The browser partially covers the underlying content. */
+  PAGE_SHEET = 'pageSheet',
+  /** The browser is centered on the screen. */
+  FORM_SHEET = 'formSheet',
+  /** The browser is displayed over the app's content. */
+  CURRENT_CONTEXT = 'currentContext',
+  /** The browser view covers the screen. */
+  OVER_FULL_SCREEN = 'overFullScreen',
+  /** The browser is displayed over the app's content. */
+  OVER_CURRENT_CONTEXT = 'overCurrentContext',
+  /** The browser is displayed in a popover view. */
+  POPOVER = 'popover',
+  /** The system picks the style. Older iOS versions fall back to `FULL_SCREEN`. */
+  AUTOMATIC = 'automatic',
+}
+
+export type IWebBrowserResult = {
+  type: WebBrowserResultType;
+};
+
+/** What `dismissBrowser` resolves with once the presented browser has been torn down. */
+export type IWebBrowserDismissResult = {
+  type: WebBrowserResultType.DISMISS;
+};
+
+export type IWebBrowserRedirectResult = {
+  type: 'success';
+  url: string;
+};
+
+export type IServiceActionResult = {
+  servicePackage?: string;
+};
+
+export type IWebBrowserAuthSessionResult = IWebBrowserRedirectResult | IWebBrowserResult;
+export type IWebBrowserMayInitWithUrlResult = IServiceActionResult;
+export type IWebBrowserWarmUpResult = IServiceActionResult;
+export type IWebBrowserCoolDownResult = IServiceActionResult;