@methodfi/opal-react-native

React Native SDK for integrating Method Opal into your mobile applications.

Installation

npm install @methodfi/opal-react-native
# or
yarn add @methodfi/opal-react-native

Quick Start

1. Provider Setup

Wrap your app with the OpalProvider:

import { OpalProvider } from '@methodfi/opal-react-native';

export default function App() {
  return (
    <OpalProvider>
      <YourAppContent />
    </OpalProvider>
  );
}

2. Hook Usage

Use the useOpal hook in your components:

import { useOpal, OpalEventType } from '@methodfi/opal-react-native';

function Screen() {
  const { open } = useOpal({
    env: 'dev',
    onOpen: () => {},
    onExit: () => {},
    onEvent: event => {
      switch (event.type) {
        case OpalEventType.SESSION_STARTED:
          // ...
          break;
        case OpalEventType.SESSION_COMPLETED:
          // ...
          break;
        case OpalEventType.SESSION_ERRORED:
          // ...
          break;
        case OpalEventType.SESSION_EXITED:
          // ...
          break;
      }
    },
  });

  const onLaunchOpal = async () => {
    // Resulting token from POST /opal/token (otkn_*)
    const token = await getOpalToken();
    open({ token });
  };

  return <Button title="Launch Opal" onPress={onLaunchOpal} />;
}