### Install Soyio React Native SDK

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Instructions for installing the Soyio React Native SDK using npm or yarn. This is the initial step to integrate the SDK into your project.

```sh
npm install @soyio/soyio-rn-sdk
```

```sh
yarn add @soyio/soyio-rn-sdk
```

--------------------------------

### Install Soyio RN SDK Dependencies

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Command to install the necessary dependencies for the Soyio React Native SDK using npm.

```sh
npm install
```

--------------------------------

### Initialize Expo Modules for Bare React Native

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Command to install Expo modules in a bare React Native project. This enables the use of Expo's APIs and components without ejecting from the Expo managed workflow.

```bash
npx install-expo-modules
```

--------------------------------

### Disclosure Request On-the-Fly (React Native)

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Example of initiating a disclosure request on-the-fly using the `useSoyioAuth` hook in React Native. This method does not require prior setup and uses company and template IDs.

```jsx
import { useSoyioAuth } from "@soyio/soyio-rn-sdk";

export default function App() {
  const options = {
    companyId: "<company id>",                     // Starts with 'com_'
    uriScheme: "<company custom uri scheme>"
    userReference: "<company identifier of user>", // Optional
    customColor: "<custom color>",                 // Optional
    isSandbox: true,                               // Optional
  };

  // For initialize a disclosure request
  const disclosureParams = {
    templateId: "<template id>",          // Starts with 'dtpl_'
    userEmail: "<user email>",            // Optional
    forceError: '<error type>',           // Optional
  };

  const onEventChange = (event) => {
    console.log("Event:", event);
  };

  const { disclosure } = useSoyioAuth({ options, onEventChange });

  const initDisclosureRequest = () => {
    disclosure(disclosureParams);
  };

  return (
    <View>
      <Button title="Disclosure request" onPress={initDisclosureRequest} />
    </View>
  );
}
```

--------------------------------

### Soyio Auth Request Event Types

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Provides examples of the different event objects that can be returned by the `onEventChange` function during a Soyio authentication request, covering success, webview open, cancellation, and error scenarios.

```js
{
  type: "success",
  request: "disclosure" | "authRequest",
  verificationKind: "validation" | "authentication",
  userReference: "<company-user-reference>",
  identityId: "<soyio-identity-id-of-user>",
}
```

```js
{
  type: "open";
}
```

```js
{
  type: "cancel";
}
```

```js
{
  type: "error",
  request: "disclosure" | "authRequest",
  error: "UNEXPECTED_ERROR"
}
```

--------------------------------

### Disclosure Request with Pre-Created ID (React Native)

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Example of initiating a disclosure request using a pre-created disclosure request ID with the `useSoyioAuth` hook in React Native. This option allows for matching the user with pre-defined criteria.

```jsx
import { useSoyioAuth } from "@soyio/soyio-rn-sdk";

export default function App() {
  const options = {
    uriScheme: "<company custom uri scheme>"
    customColor: "<custom color>",                 // Optional
    isSandbox: false,                              // Optional
  };

  // For initialize a disclosure request
  const disclosureParams = {
    disclosureRequestId: "<disclosure request id>",  // Starts with 'dreq_'
    userEmail: "<user email>",                       // Optional
    forceError: '<error type>',                      // Optional
  };

  const onEventChange = (event) => {
    console.log("Event:", event);
  };

  const { disclosure } = useSoyioAuth({ options, onEventChange });

  const initDisclosureRequest = () => {
    disclosure(disclosureParams);
  };

  return (
    <View>
      <Button title="Disclosure request" onPress={initDisclosureRequest} />
    </View>
  );
}
```

--------------------------------

### Build and Pack Soyio RN SDK

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Steps to build the Soyio React Native SDK and create a package file for local development or testing in another project.

```sh
npm run build
npm pack
```

--------------------------------

### Create a New Release for Soyio RN SDK

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Commands to switch to the main branch and bump the package version for creating a new release of the Soyio React Native SDK.

```sh
git switch main
npm run bump! <major|minor|patch>
```

--------------------------------

### Initiate Auth Request with Soyio RN SDK

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Demonstrates how to use the `useSoyioAuth` hook from the Soyio React Native SDK to initiate an authentication request. It includes setting up options, defining authentication parameters, and handling event changes.

```jsx
import { useSoyioAuth } from "@soyio/soyio-rn-sdk";

export default function App() {
  const options = {
    uriScheme: "<company custom uri scheme>"
    customColor: "<custom color>",                 // Optional
    isSandbox: false,                              // Optional
  };

  const authRequestParams = {
    authRequestId: "<auth request id>" // Starts with 'authreq_'
  }

  const onEventChange = (event) => {
    console.log("Event:", event);
  };

  const { authentication } = useSoyioAuth({ options, onEventChange });

  const initAuthRequest = () => {
    authentication(authRequestParams);
  };

  return (
    <View>
      <Button title="Auth Request" onPress={initAuthRequest} />
    </View>
  );
}
```

--------------------------------

### Add Local Soyio RN SDK Package to React Native App

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Instructions on how to add a locally packed Soyio React Native SDK `.tgz` file as a dependency in a React Native project's `package.json`.

```json
{
  "dependencies": {
    ...
    "@soyio/soyio-rn-sdk": "file:./path/to/soyio-soyio-rn-sdk-x.x.x.tgz",
    ...
  }
}
```

--------------------------------

### Add Custom URI Scheme

Source: https://github.com/soyio-id/soyio-rn-sdk/blob/main/README.md

Adds a custom URI scheme to your project using npx. This scheme is used for redirecting within Android applications to ensure links open in the correct app.

```bash
npx uri-scheme add custom-uri-scheme
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.