equal-react-native-pfm-sdk 1.0.0

package/README.md

@@ -0,0 +1,271 @@
+# PFM Stack — React Native Integration
+
+The PFM Stack provides an embedded React Native SDK for integrating **Personal Finance Management** into your mobile application. End-users can aggregate their financial data through the **Account Aggregator** framework with a minimal-effort integration.
+
+---
+
+## Prerequisites
+
+| Requirement            | Minimum Version |
+|------------------------|-----------------|
+| React Native           | 0.68+           |
+| React                  | 17+             |
+| Node.js                | 16+             |
+| Android `minSdkVersion`| 21 (Android 5.0)|
+| iOS Deployment Target  | 13.0+           |
+
+---
+
+## Step 1: Initialization of SDK API
+
+Before the consumer can access PFM features, your **backend service** must initialize the SDK by calling the **SDK Init API**.
+
+The Init API returns an `access_token` (referred to as `token` in the SDK). This token is required to launch the PFM interface.
+
+> Refer to the [SDK Init API documentation](https://developer.moneyone.in/pfm/sdk-init-api) for complete backend integration steps.
+
+**Example Init API request body:**
+
+```json
+{
+  "reference_id": "unique_ref_id",
+  "exchange_application_id": "pfm.equal.tata_amc_uat",
+  "user_profile": {
+    "mobile_number": "9876543210",
+    "name": "User Name",
+    "dob": "18-01-1990",
+    "pan": "XXNPS9280W"
+  }
+}
+```
+
+The API response contains a `session_token` — pass this value as the `token` parameter when launching the SDK.
+
+---
+
+## Step 2: Add SDK as Dependency
+
+### Using npm
+
+```bash
+npm install equal-react-native-pfm-sdk
+```
+
+### Using yarn
+
+```bash
+yarn add equal-react-native-pfm-sdk
+```
+
+### Install peer dependency
+
+The SDK requires `react-native-webview`. If not already in your project:
+
+```bash
+npm install react-native-webview
+# or
+yarn add react-native-webview
+```
+
+### iOS — Install CocoaPods
+
+```bash
+cd ios && pod install && cd ..
+```
+
+---
+
+## Step 3: Launch PFM SDK
+
+### 3a. Android Configuration
+
+Add the following provider entry inside the `<application>` tag in your `android/app/src/main/AndroidManifest.xml`. This is required by the WebView component for file handling:
+
+```xml
+<application
+  ...>
+
+  <!-- Required for PFM SDK WebView file access -->
+  <provider
+    android:name="androidx.core.content.FileProvider"
+    android:authorities="${applicationId}.fileprovider"
+    android:exported="false"
+    android:grantUriPermissions="true">
+    <meta-data
+      android:name="android.support.FILE_PROVIDER_PATHS"
+      android:resource="@xml/file_paths" />
+  </provider>
+
+</application>
+```
+
+Ensure internet permission is declared (usually present by default):
+
+```xml
+<uses-permission android:name="android.permission.INTERNET" />
+```
+
+### 3b. iOS Configuration
+
+Add the following keys to your `ios/<YourApp>/Info.plist` to allow the WebView to load content and open external links:
+
+```xml
+<key>NSAppTransportSecurity</key>
+<dict>
+  <key>NSAllowsArbitraryLoads</key>
+  <true/>
+</dict>
+```
+
+### 3c. Usage Example
+
+```tsx
+import React, { useState } from 'react';
+import { Alert, Button, SafeAreaView, View } from 'react-native';
+import { PFMWebView, EventResponse } from 'equal-react-native-pfm-sdk';
+
+export default function App() {
+  const [showPFM, setShowPFM] = useState(false);
+
+  const handleClosed = (data: EventResponse) => {
+    console.log('PFM Closed:', data);
+    setShowPFM(false);
+    Alert.alert('PFM Closed', data.message);
+  };
+
+  const handleError = (data: EventResponse) => {
+    console.error('PFM Error:', data);
+    setShowPFM(false);
+    Alert.alert('PFM Error', data.message);
+  };
+
+  if (showPFM) {
+    return (
+      <PFMWebView
+        token="#token"       // Replace with token from SDK Init API
+        env="sandbox"        // "sandbox" | "production"
+        onClosed={handleClosed}
+        onError={handleError}
+      />
+    );
+  }
+
+  return (
+    <SafeAreaView style={{ flex: 1 }}>
+      <View style={{ flex: 1, justifyContent: 'center', padding: 24 }}>
+        <Button title="Launch PFM" onPress={() => setShowPFM(true)} />
+      </View>
+    </SafeAreaView>
+  );
+}
+```
+
+---
+
+## SDK Parameters
+
+| Parameter | Type       | Required | Default     | Description                                                                 |
+|-----------|------------|----------|-------------|-----------------------------------------------------------------------------|
+| `token`   | `string`   | Yes      | —           | Access token obtained from the SDK Init API response (`session_token`).     |
+| `env`     | `string`   | No       | `"sandbox"` | Environment selector. Use `"production"` for live; any other value routes to UAT. |
+| `onClosed`| `function` | Yes      | —           | Callback invoked when the user exits the PFM interface.                     |
+| `onError` | `function` | Yes      | —           | Callback invoked when the SDK encounters an error.                          |
+
+---
+
+## SDK Callback Methods
+
+### `onClosed`
+
+Triggered when the user explicitly closes or exits the PFM interface. The callback receives an `EventResponse` object:
+
+```ts
+interface EventResponse {
+  eventType: string;   // "PFM_SDK_CALLBACK"
+  status: string;      // "CLOSED"
+  message: string;     // Human-readable description
+  statusCode?: string; // Optional HTTP-style status code
+}
+```
+
+**Example:**
+
+```ts
+onClosed={(data) => {
+  console.log(data);
+  // {
+  //   eventType: "PFM_SDK_CALLBACK",
+  //   status: "CLOSED",
+  //   message: "User closed",
+  //   statusCode: "200"
+  // }
+}}
+```
+
+### `onError`
+
+Triggered when the PFM UI encounters an error during operation — for example, an expired token, a network failure, or a server-side issue. The callback receives the same `EventResponse` structure:
+
+```ts
+onError={(data) => {
+  console.error(data);
+  // {
+  //   eventType: "PFM_SDK_CALLBACK",
+  //   status: "ERROR",
+  //   message: "Token expired",
+  //   statusCode: "401"
+  // }
+}}
+```
+
+---
+
+## Environment URLs
+
+| `env` value                      | Resolved URL                        |
+|----------------------------------|-------------------------------------|
+| `"production"`                   | `https://pfm.equal.in/pfm`         |
+| Any other value (e.g. `"sandbox"`, `"pre-prod"`) | `https://uat.pfm.equal.in/pfm` |
+
+---
+
+## Project Structure
+
+```
+equal-react-native-pfm-sdk/
+├── src/
+│   ├── index.ts                    # Barrel export
+│   ├── PFMWebView.tsx              # Core WebView component
+│   ├── PFMSDKManager.ts            # URL construction logic
+│   ├── constants.ts                # Endpoints & config
+│   └── models/
+│       ├── PFMSDKConfig.ts         # SDK configuration interface
+│       └── EventResponse.ts        # Callback event payload
+├── __tests__/
+│   ├── setup.ts                    # Jest setup & mocks
+│   ├── models.test.ts              # Model unit tests
+│   ├── PFMSDKManager.test.ts       # URL logic tests
+│   └── PFMWebView.test.tsx         # Component integration tests
+├── example/
+│   └── App.tsx                     # Example integration
+├── package.json
+├── tsconfig.json
+├── jest.config.js
+└── README.md
+```
+
+---
+
+## Running Tests
+
+```bash
+npm test
+# or
+yarn test
+```
+
+---
+
+## Support
+
+For integration support, refer to the [Moneyone Developer Portal](https://developer.moneyone.in) or contact the Equal engineering team.

package/lib/PFMSDKManager.d.ts

@@ -0,0 +1,19 @@
+import { PFMSDKConfig } from './models/PFMSDKConfig';
+import { EventResponse } from './models/EventResponse';
+/**
+ * Resolves the correct PFM domain based on the environment value.
+ *
+ * - If `env` contains the substring "production" → production URL.
+ * - Otherwise → UAT URL.
+ */
+export declare function getEqualDomain(env: string): string;
+/**
+ * Builds the full gateway URL that the webview should load.
+ *
+ * @returns The URL string on success, or `null` if construction fails
+ *          (in which case `onError` is invoked).
+ *
+ * URL format: `https://<domain>/pfm?access_token=<token>`
+ */
+export declare function getGatewayURL(config: PFMSDKConfig, onError: (data: EventResponse) => void): string | null;
+//# sourceMappingURL=PFMSDKManager.d.ts.map

package/lib/PFMSDKManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PFMSDKManager.d.ts","sourceRoot":"","sources":["../src/PFMSDKManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAwB,MAAM,wBAAwB,CAAC;AAO7E;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,GACrC,MAAM,GAAG,IAAI,CAaf"}

package/lib/PFMSDKManager.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEqualDomain = getEqualDomain;
+exports.getGatewayURL = getGatewayURL;
+const PFMSDKConfig_1 = require("./models/PFMSDKConfig");
+const EventResponse_1 = require("./models/EventResponse");
+const constants_1 = require("./constants");
+/**
+ * Resolves the correct PFM domain based on the environment value.
+ *
+ * - If `env` contains the substring "production" → production URL.
+ * - Otherwise → UAT URL.
+ */
+function getEqualDomain(env) {
+    return env.includes('production') ? constants_1.PROD_PFM_APP_URL : constants_1.UAT_PFM_APP_URL;
+}
+/**
+ * Builds the full gateway URL that the webview should load.
+ *
+ * @returns The URL string on success, or `null` if construction fails
+ *          (in which case `onError` is invoked).
+ *
+ * URL format: `https://<domain>/pfm?access_token=<token>`
+ */
+function getGatewayURL(config, onError) {
+    try {
+        const resolved = (0, PFMSDKConfig_1.resolvePFMSDKConfig)(config);
+        const domain = getEqualDomain(resolved.env);
+        const url = new URL(constants_1.PFM_PATH, domain);
+        url.searchParams.set('access_token', resolved.token);
+        return url.toString();
+    }
+    catch (e) {
+        const message = 'Unable to load the PFM due to a technical error. Please try again.';
+        onError(EventResponse_1.EventResponseFactory.error(message));
+        return null;
+    }
+}
+//# sourceMappingURL=PFMSDKManager.js.map

package/lib/PFMSDKManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PFMSDKManager.js","sourceRoot":"","sources":["../src/PFMSDKManager.ts"],"names":[],"mappings":";;AAcA,wCAEC;AAUD,sCAgBC;AA1CD,wDAA0E;AAC1E,0DAA6E;AAC7E,2CAIqB;AAErB;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,GAAW;IACxC,OAAO,GAAG,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,4BAAgB,CAAC,CAAC,CAAC,2BAAe,CAAC;AACzE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,aAAa,CAC3B,MAAoB,EACpB,OAAsC;IAEtC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAA,kCAAmB,EAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,oBAAQ,EAAE,MAAM,CAAC,CAAC;QACtC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,cAAc,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;QACrD,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,OAAO,GACX,oEAAoE,CAAC;QACvE,OAAO,CAAC,oCAAoB,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/lib/PFMWebView.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import { EventResponse } from './models/EventResponse';
+export interface PFMWebViewProps {
+    /** Access token obtained from the SDK Init API. */
+    token: string;
+    /**
+     * Environment selector.
+     * - `"production"` → production endpoint
+     * - Any other value  → UAT endpoint
+     * @default "sandbox"
+     */
+    env?: string;
+    /** Fired when the user explicitly closes the PFM interface. */
+    onClosed: (data: EventResponse) => void;
+    /** Fired when the SDK encounters an error. */
+    onError: (data: EventResponse) => void;
+}
+export declare function PFMWebView({ token, env, onClosed, onError, }: PFMWebViewProps): React.JSX.Element;
+//# sourceMappingURL=PFMWebView.d.ts.map

package/lib/PFMWebView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PFMWebView.d.ts","sourceRoot":"","sources":["../src/PFMWebView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAuC,MAAM,OAAO,CAAC;AAc5D,OAAO,EAAE,aAAa,EAAwB,MAAM,wBAAwB,CAAC;AAY7E,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb,+DAA+D;IAC/D,QAAQ,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;IAExC,8CAA8C;IAC9C,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,IAAI,CAAC;CACxC;AA+CD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,GAAe,EACf,QAAQ,EACR,OAAO,GACR,EAAE,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAyGrC"}

package/lib/PFMWebView.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PFMWebView = PFMWebView;
+const react_1 = __importStar(require("react"));
+const react_native_1 = require("react-native");
+const react_native_webview_1 = require("react-native-webview");
+const EventResponse_1 = require("./models/EventResponse");
+const PFMSDKManager_1 = require("./PFMSDKManager");
+const constants_1 = require("./constants");
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                            */
+/* ------------------------------------------------------------------ */
+/**
+ * Returns `true` when the URL matches one of the known external patterns
+ * that should be opened in the device's default browser.
+ */
+function isExternalUrl(url) {
+    return constants_1.EXTERNAL_URL_PATTERNS.some((pattern) => url.includes(pattern));
+}
+/**
+ * Parses query-parameters from a `/pfm/close` URL and invokes the
+ * appropriate callback (onClosed or onError).
+ */
+function handleSdkEvent(url, onClosed, onError) {
+    try {
+        const parsed = new URL(url);
+        const message = parsed.searchParams.get('message') ?? '';
+        const status = parsed.searchParams.get('status') ?? '';
+        const statusCode = parsed.searchParams.get('status_code') ?? undefined;
+        if (status === 'ERROR') {
+            onError(EventResponse_1.EventResponseFactory.error(message, statusCode));
+        }
+        else if (url.includes('CLOSED')) {
+            onClosed(EventResponse_1.EventResponseFactory.closed(message, statusCode));
+        }
+        else {
+            // Fallback — treat any other /close as a normal close.
+            onClosed(EventResponse_1.EventResponseFactory.closed(message, statusCode));
+        }
+    }
+    catch (e) {
+        const errorMessage = e instanceof Error ? e.message : String(e);
+        onError(EventResponse_1.EventResponseFactory.error(errorMessage));
+    }
+}
+/* ------------------------------------------------------------------ */
+/*  Component                                                          */
+/* ------------------------------------------------------------------ */
+function PFMWebView({ token, env = 'sandbox', onClosed, onError, }) {
+    const webViewRef = (0, react_1.useRef)(null);
+    /* ---- Build the gateway URL once ---- */
+    const gatewayUrl = (0, react_1.useMemo)(() => {
+        const config = { token, env };
+        return (0, PFMSDKManager_1.getGatewayURL)(config, (err) => onError(err));
+    }, [token, env, onError]);
+    /* ---- Android hardware-back handling ---- */
+    const handleBackPress = (0, react_1.useCallback)(() => {
+        react_native_1.Alert.alert('Exit PFM', 'Are you sure you want to exit?', [
+            { text: 'No', style: 'cancel' },
+            {
+                text: 'Yes',
+                onPress: () => onClosed(EventResponse_1.EventResponseFactory.closed('User exited via back button')),
+            },
+        ], { cancelable: true });
+        return true;
+    }, [onClosed]);
+    react_1.default.useEffect(() => {
+        if (react_native_1.Platform.OS === 'android') {
+            const sub = react_native_1.BackHandler.addEventListener('hardwareBackPress', handleBackPress);
+            return () => sub.remove();
+        }
+        return undefined;
+    }, [handleBackPress]);
+    /* ---- Pre-navigation interception (matches Flutter shouldOverrideUrlLoading) ---- */
+    const handleShouldStartLoad = (0, react_1.useCallback)((event) => {
+        const { url } = event;
+        // External URLs → cancel navigation, open in system browser
+        if (isExternalUrl(url)) {
+            react_native_1.Linking.openURL(url).catch(() => { });
+            return false;
+        }
+        // /pfm/close → cancel navigation, fire callbacks
+        if (url.includes(constants_1.CLOSE_PATH)) {
+            handleSdkEvent(url, onClosed, onError);
+            return false;
+        }
+        // All other URLs → allow navigation
+        return true;
+    }, [onClosed, onError]);
+    /* ---- Error fallback ---- */
+    if (!gatewayUrl) {
+        return react_1.default.createElement(react_native_1.View, { style: styles.container });
+    }
+    /* ---- Render ---- */
+    return (react_1.default.createElement(react_native_1.SafeAreaView, { style: styles.container },
+        react_1.default.createElement(react_native_1.StatusBar, { barStyle: "dark-content" }),
+        react_1.default.createElement(react_native_webview_1.WebView, { ref: webViewRef, testID: "pfm-webview", source: { uri: gatewayUrl }, style: styles.webview, userAgent: constants_1.CUSTOM_USER_AGENT, javaScriptEnabled: true, javaScriptCanOpenWindowsAutomatically: true, domStorageEnabled: true, allowFileAccessFromFileURLs: true, allowUniversalAccessFromFileURLs: true, mediaPlaybackRequiresUserAction: false, allowsBackForwardNavigationGestures: false, scalesPageToFit: false, thirdPartyCookiesEnabled: true, sharedCookiesEnabled: true, cacheEnabled: true, mixedContentMode: "compatibility", setSupportMultipleWindows: false, originWhitelist: ['*'], onShouldStartLoadWithRequest: handleShouldStartLoad, onError: (syntheticEvent) => {
+                const { nativeEvent } = syntheticEvent;
+                onError(EventResponse_1.EventResponseFactory.error(nativeEvent.description ?? 'WebView failed to load'));
+            } })));
+}
+/* ------------------------------------------------------------------ */
+/*  Styles                                                             */
+/* ------------------------------------------------------------------ */
+const styles = react_native_1.StyleSheet.create({
+    container: {
+        flex: 1,
+        backgroundColor: '#FFFFFF',
+    },
+    webview: {
+        flex: 1,
+    },
+});
+//# sourceMappingURL=PFMWebView.js.map

package/lib/PFMWebView.js.map

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

package/lib/constants.d.ts

@@ -0,0 +1,19 @@
+/** Production PFM endpoint. */
+export declare const PROD_PFM_APP_URL = "https://pfm.equal.in";
+/** UAT / pre-prod PFM endpoint. */
+export declare const UAT_PFM_APP_URL = "https://uat.pfm.equal.in";
+/** PFM path appended to the base domain. */
+export declare const PFM_PATH = "/pfm";
+/** URL path fragment that signals an SDK close event. */
+export declare const CLOSE_PATH = "/pfm/close";
+/**
+ * External URLs that must be opened in the device's default browser
+ * rather than inside the embedded webview.
+ */
+export declare const EXTERNAL_URL_PATTERNS: string[];
+/**
+ * Custom user-agent string matching the Flutter SDK to ensure
+ * identical server-side behaviour.
+ */
+export declare const CUSTOM_USER_AGENT = "Firefox/5.0 (Linux; Android 11; Nokia 8.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.120 Mobile Safari/537.36";
+//# sourceMappingURL=constants.d.ts.map

package/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAEvD,mCAAmC;AACnC,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAE1D,4CAA4C;AAC5C,eAAO,MAAM,QAAQ,SAAS,CAAC;AAE/B,yDAAyD;AACzD,eAAO,MAAM,UAAU,eAAe,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,EAGzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,gIACiG,CAAC"}

package/lib/constants.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CUSTOM_USER_AGENT = exports.EXTERNAL_URL_PATTERNS = exports.CLOSE_PATH = exports.PFM_PATH = exports.UAT_PFM_APP_URL = exports.PROD_PFM_APP_URL = void 0;
+/** Production PFM endpoint. */
+exports.PROD_PFM_APP_URL = 'https://pfm.equal.in';
+/** UAT / pre-prod PFM endpoint. */
+exports.UAT_PFM_APP_URL = 'https://uat.pfm.equal.in';
+/** PFM path appended to the base domain. */
+exports.PFM_PATH = '/pfm';
+/** URL path fragment that signals an SDK close event. */
+exports.CLOSE_PATH = '/pfm/close';
+/**
+ * External URLs that must be opened in the device's default browser
+ * rather than inside the embedded webview.
+ */
+exports.EXTERNAL_URL_PATTERNS = [
+    'https://www.tatamutualfund.com/raise-query',
+    'https://aa-uat.onemoney.in/',
+];
+/**
+ * Custom user-agent string matching the Flutter SDK to ensure
+ * identical server-side behaviour.
+ */
+exports.CUSTOM_USER_AGENT = 'Firefox/5.0 (Linux; Android 11; Nokia 8.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.120 Mobile Safari/537.36';
+//# sourceMappingURL=constants.js.map

package/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAA,+BAA+B;AAClB,QAAA,gBAAgB,GAAG,sBAAsB,CAAC;AAEvD,mCAAmC;AACtB,QAAA,eAAe,GAAG,0BAA0B,CAAC;AAE1D,4CAA4C;AAC/B,QAAA,QAAQ,GAAG,MAAM,CAAC;AAE/B,yDAAyD;AAC5C,QAAA,UAAU,GAAG,YAAY,CAAC;AAEvC;;;GAGG;AACU,QAAA,qBAAqB,GAAa;IAC7C,4CAA4C;IAC5C,6BAA6B;CAC9B,CAAC;AAEF;;;GAGG;AACU,QAAA,iBAAiB,GAC5B,6HAA6H,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,8 @@
+export { PFMWebView } from './PFMWebView';
+export type { PFMWebViewProps } from './PFMWebView';
+export type { PFMSDKConfig } from './models/PFMSDKConfig';
+export { resolvePFMSDKConfig } from './models/PFMSDKConfig';
+export type { EventResponse } from './models/EventResponse';
+export { EventResponseFactory } from './models/EventResponse';
+export { getGatewayURL, getEqualDomain } from './PFMSDKManager';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAE5D,YAAY,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/lib/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEqualDomain = exports.getGatewayURL = exports.EventResponseFactory = exports.resolvePFMSDKConfig = exports.PFMWebView = void 0;
+var PFMWebView_1 = require("./PFMWebView");
+Object.defineProperty(exports, "PFMWebView", { enumerable: true, get: function () { return PFMWebView_1.PFMWebView; } });
+var PFMSDKConfig_1 = require("./models/PFMSDKConfig");
+Object.defineProperty(exports, "resolvePFMSDKConfig", { enumerable: true, get: function () { return PFMSDKConfig_1.resolvePFMSDKConfig; } });
+var EventResponse_1 = require("./models/EventResponse");
+Object.defineProperty(exports, "EventResponseFactory", { enumerable: true, get: function () { return EventResponse_1.EventResponseFactory; } });
+var PFMSDKManager_1 = require("./PFMSDKManager");
+Object.defineProperty(exports, "getGatewayURL", { enumerable: true, get: function () { return PFMSDKManager_1.getGatewayURL; } });
+Object.defineProperty(exports, "getEqualDomain", { enumerable: true, get: function () { return PFMSDKManager_1.getEqualDomain; } });
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AAInB,sDAA4D;AAAnD,mHAAA,mBAAmB,OAAA;AAG5B,wDAA8D;AAArD,qHAAA,oBAAoB,OAAA;AAE7B,iDAAgE;AAAvD,8GAAA,aAAa,OAAA;AAAE,+GAAA,cAAc,OAAA"}

package/lib/models/EventResponse.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Structured event payload returned through SDK callbacks.
+ */
+export interface EventResponse {
+    /** Discriminator for the event origin. */
+    eventType: string;
+    /** High-level outcome — e.g. "ERROR", "CLOSED". */
+    status: string;
+    /** Human-readable description of the event. */
+    message: string;
+    /** Optional status code echoed from the PFM backend. */
+    statusCode?: string;
+}
+/**
+ * Factory helpers for building well-typed EventResponse objects.
+ */
+export declare const EventResponseFactory: {
+    closed(message: string, statusCode?: string): EventResponse;
+    error(message: string, statusCode?: string): EventResponse;
+};
+//# sourceMappingURL=EventResponse.d.ts.map

package/lib/models/EventResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventResponse.d.ts","sourceRoot":"","sources":["../../src/models/EventResponse.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IAEf,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAEhB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB;oBACf,MAAM,eAAe,MAAM,GAAG,aAAa;mBAS5C,MAAM,eAAe,MAAM,GAAG,aAAa;CAQ3D,CAAC"}

package/lib/models/EventResponse.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventResponseFactory = void 0;
+/**
+ * Factory helpers for building well-typed EventResponse objects.
+ */
+exports.EventResponseFactory = {
+    closed(message, statusCode) {
+        return {
+            eventType: 'PFM_SDK_CALLBACK',
+            status: 'CLOSED',
+            message,
+            statusCode,
+        };
+    },
+    error(message, statusCode) {
+        return {
+            eventType: 'PFM_SDK_CALLBACK',
+            status: 'ERROR',
+            message,
+            statusCode,
+        };
+    },
+};
+//# sourceMappingURL=EventResponse.js.map

package/lib/models/EventResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventResponse.js","sourceRoot":"","sources":["../../src/models/EventResponse.ts"],"names":[],"mappings":";;;AAiBA;;GAEG;AACU,QAAA,oBAAoB,GAAG;IAClC,MAAM,CAAC,OAAe,EAAE,UAAmB;QACzC,OAAO;YACL,SAAS,EAAE,kBAAkB;YAC7B,MAAM,EAAE,QAAQ;YAChB,OAAO;YACP,UAAU;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,UAAmB;QACxC,OAAO;YACL,SAAS,EAAE,kBAAkB;YAC7B,MAAM,EAAE,OAAO;YACf,OAAO;YACP,UAAU;SACX,CAAC;IACJ,CAAC;CACF,CAAC"}

package/lib/models/PFMSDKConfig.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Configuration for the PFM SDK.
+ *
+ * @param token  - Access token obtained from the SDK Init API (required).
+ * @param env    - Target environment. Use "production" for live,
+ *                 any other value (e.g. "pre-prod", "sandbox") routes to UAT.
+ *                 Defaults to "sandbox".
+ */
+export interface PFMSDKConfig {
+    /** Access token returned by the SDK Init API. */
+    token: string;
+    /**
+     * Environment selector.
+     * - `"production"` → production endpoint
+     * - Any other value  → UAT endpoint
+     * @default "sandbox"
+     */
+    env?: string;
+}
+/**
+ * Build a PFMSDKConfig with defaults applied.
+ */
+export declare function resolvePFMSDKConfig(config: PFMSDKConfig): Required<PFMSDKConfig>;
+//# sourceMappingURL=PFMSDKConfig.d.ts.map

package/lib/models/PFMSDKConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PFMSDKConfig.d.ts","sourceRoot":"","sources":["../../src/models/PFMSDKConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY;IAC3B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,CAAC,YAAY,CAAC,CAKhF"}

package/lib/models/PFMSDKConfig.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePFMSDKConfig = resolvePFMSDKConfig;
+/**
+ * Build a PFMSDKConfig with defaults applied.
+ */
+function resolvePFMSDKConfig(config) {
+    return {
+        token: config.token,
+        env: config.env ?? 'sandbox',
+    };
+}
+//# sourceMappingURL=PFMSDKConfig.js.map

package/lib/models/PFMSDKConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PFMSDKConfig.js","sourceRoot":"","sources":["../../src/models/PFMSDKConfig.ts"],"names":[],"mappings":";;AAwBA,kDAKC;AARD;;GAEG;AACH,SAAgB,mBAAmB,CAAC,MAAoB;IACtD,OAAO;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,EAAE,MAAM,CAAC,GAAG,IAAI,SAAS;KAC7B,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "equal-react-native-pfm-sdk",
+  "version": "1.0.0",
+  "description": "Equal PFM React Native SDK",
+  "main": "src/index.ts",
+  "types": "lib/index.d.ts",
+  "react-native": "src/index.ts",
+  "files": [
+    "lib/",
+    "src/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "tsc",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "lint": "eslint src/ --ext .ts,.tsx",
+    "publish-npm": "npm publish --access public"
+  },
+  "keywords": [
+    "pfm",
+    "sdk",
+    "react-native",
+    "equal"
+  ],
+  "author": "One Equal PFM",
+  "license": "ISC",
+  "homepage": "https://www.npmjs.com/package/equal-react-native-pfm-sdk",
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-native": ">=0.68.0",
+    "react-native-webview": ">=11.0.0"
+  },
+  "devDependencies": {
+    "@testing-library/react-native": "^12.4.0",
+    "@types/jest": "^29.5.0",
+    "@types/react": "^18.2.0",
+    "@types/react-native": "^0.72.0",
+    "jest": "^29.7.0",
+    "react": "^18.2.0",
+    "react-native": "^0.73.0",
+    "react-native-webview": "^13.6.0",
+    "react-test-renderer": "^18.2.0",
+    "typescript": "^5.3.0",
+    "@testing-library/jest-native": "^5.4.0"
+  }
+}

package/src/PFMSDKManager.ts

@@ -0,0 +1,43 @@
+import { PFMSDKConfig, resolvePFMSDKConfig } from './models/PFMSDKConfig';
+import { EventResponse, EventResponseFactory } from './models/EventResponse';
+import {
+  PROD_PFM_APP_URL,
+  UAT_PFM_APP_URL,
+  PFM_PATH,
+} from './constants';
+
+/**
+ * Resolves the correct PFM domain based on the environment value.
+ *
+ * - If `env` contains the substring "production" → production URL.
+ * - Otherwise → UAT URL.
+ */
+export function getEqualDomain(env: string): string {
+  return env.includes('production') ? PROD_PFM_APP_URL : UAT_PFM_APP_URL;
+}
+
+/**
+ * Builds the full gateway URL that the webview should load.
+ *
+ * @returns The URL string on success, or `null` if construction fails
+ *          (in which case `onError` is invoked).
+ *
+ * URL format: `https://<domain>/pfm?access_token=<token>`
+ */
+export function getGatewayURL(
+  config: PFMSDKConfig,
+  onError: (data: EventResponse) => void,
+): string | null {
+  try {
+    const resolved = resolvePFMSDKConfig(config);
+    const domain = getEqualDomain(resolved.env);
+    const url = new URL(PFM_PATH, domain);
+    url.searchParams.set('access_token', resolved.token);
+    return url.toString();
+  } catch (e) {
+    const message =
+      'Unable to load the PFM due to a technical error. Please try again.';
+    onError(EventResponseFactory.error(message));
+    return null;
+  }
+}

package/src/PFMWebView.tsx

@@ -0,0 +1,215 @@
+import React, { useCallback, useMemo, useRef } from 'react';
+import {
+  Alert,
+  BackHandler,
+  Linking,
+  Platform,
+  SafeAreaView,
+  StatusBar,
+  StyleSheet,
+  View,
+} from 'react-native';
+import { WebView } from 'react-native-webview';
+
+import { PFMSDKConfig } from './models/PFMSDKConfig';
+import { EventResponse, EventResponseFactory } from './models/EventResponse';
+import { getGatewayURL } from './PFMSDKManager';
+import {
+  CLOSE_PATH,
+  CUSTOM_USER_AGENT,
+  EXTERNAL_URL_PATTERNS,
+} from './constants';
+
+/* ------------------------------------------------------------------ */
+/*  Public prop types                                                  */
+/* ------------------------------------------------------------------ */
+
+export interface PFMWebViewProps {
+  /** Access token obtained from the SDK Init API. */
+  token: string;
+
+  /**
+   * Environment selector.
+   * - `"production"` → production endpoint
+   * - Any other value  → UAT endpoint
+   * @default "sandbox"
+   */
+  env?: string;
+
+  /** Fired when the user explicitly closes the PFM interface. */
+  onClosed: (data: EventResponse) => void;
+
+  /** Fired when the SDK encounters an error. */
+  onError: (data: EventResponse) => void;
+}
+
+/* ------------------------------------------------------------------ */
+/*  Helpers                                                            */
+/* ------------------------------------------------------------------ */
+
+/**
+ * Returns `true` when the URL matches one of the known external patterns
+ * that should be opened in the device's default browser.
+ */
+function isExternalUrl(url: string): boolean {
+  return EXTERNAL_URL_PATTERNS.some((pattern) => url.includes(pattern));
+}
+
+/**
+ * Parses query-parameters from a `/pfm/close` URL and invokes the
+ * appropriate callback (onClosed or onError).
+ */
+function handleSdkEvent(
+  url: string,
+  onClosed: (data: EventResponse) => void,
+  onError: (data: EventResponse) => void,
+): void {
+  try {
+    const parsed = new URL(url);
+    const message = parsed.searchParams.get('message') ?? '';
+    const status = parsed.searchParams.get('status') ?? '';
+    const statusCode = parsed.searchParams.get('status_code') ?? undefined;
+
+    if (status === 'ERROR') {
+      onError(EventResponseFactory.error(message, statusCode));
+    } else if (url.includes('CLOSED')) {
+      onClosed(EventResponseFactory.closed(message, statusCode));
+    } else {
+      // Fallback — treat any other /close as a normal close.
+      onClosed(EventResponseFactory.closed(message, statusCode));
+    }
+  } catch (e) {
+    const errorMessage = e instanceof Error ? e.message : String(e);
+    onError(EventResponseFactory.error(errorMessage));
+  }
+}
+
+/* ------------------------------------------------------------------ */
+/*  Component                                                          */
+/* ------------------------------------------------------------------ */
+
+export function PFMWebView({
+  token,
+  env = 'sandbox',
+  onClosed,
+  onError,
+}: PFMWebViewProps): React.JSX.Element {
+  const webViewRef = useRef<WebView>(null);
+
+  /* ---- Build the gateway URL once ---- */
+  const gatewayUrl = useMemo(() => {
+    const config: PFMSDKConfig = { token, env };
+    return getGatewayURL(config, (err) => onError(err));
+  }, [token, env, onError]);
+
+  /* ---- Android hardware-back handling ---- */
+  const handleBackPress = useCallback(() => {
+    Alert.alert(
+      'Exit PFM',
+      'Are you sure you want to exit?',
+      [
+        { text: 'No', style: 'cancel' },
+        {
+          text: 'Yes',
+          onPress: () =>
+            onClosed(
+              EventResponseFactory.closed('User exited via back button'),
+            ),
+        },
+      ],
+      { cancelable: true },
+    );
+    return true;
+  }, [onClosed]);
+
+  React.useEffect(() => {
+    if (Platform.OS === 'android') {
+      const sub = BackHandler.addEventListener(
+        'hardwareBackPress',
+        handleBackPress,
+      );
+      return () => sub.remove();
+    }
+    return undefined;
+  }, [handleBackPress]);
+
+  /* ---- Pre-navigation interception (matches Flutter shouldOverrideUrlLoading) ---- */
+  const handleShouldStartLoad = useCallback(
+    (event: { url: string }): boolean => {
+      const { url } = event;
+
+      // External URLs → cancel navigation, open in system browser
+      if (isExternalUrl(url)) {
+        Linking.openURL(url).catch(() => {});
+        return false;
+      }
+
+      // /pfm/close → cancel navigation, fire callbacks
+      if (url.includes(CLOSE_PATH)) {
+        handleSdkEvent(url, onClosed, onError);
+        return false;
+      }
+
+      // All other URLs → allow navigation
+      return true;
+    },
+    [onClosed, onError],
+  );
+
+  /* ---- Error fallback ---- */
+  if (!gatewayUrl) {
+    return <View style={styles.container} />;
+  }
+
+  /* ---- Render ---- */
+  return (
+    <SafeAreaView style={styles.container}>
+      <StatusBar barStyle="dark-content" />
+
+      <WebView
+        ref={webViewRef}
+        testID="pfm-webview"
+        source={{ uri: gatewayUrl }}
+        style={styles.webview}
+        userAgent={CUSTOM_USER_AGENT}
+        javaScriptEnabled
+        javaScriptCanOpenWindowsAutomatically
+        domStorageEnabled
+        allowFileAccessFromFileURLs
+        allowUniversalAccessFromFileURLs
+        mediaPlaybackRequiresUserAction={false}
+        allowsBackForwardNavigationGestures={false}
+        scalesPageToFit={false}
+        thirdPartyCookiesEnabled={true}
+        sharedCookiesEnabled={true}
+        cacheEnabled={true}
+        mixedContentMode="compatibility"
+        setSupportMultipleWindows={false}
+        originWhitelist={['*']}
+        onShouldStartLoadWithRequest={handleShouldStartLoad}
+        onError={(syntheticEvent) => {
+          const { nativeEvent } = syntheticEvent;
+          onError(
+            EventResponseFactory.error(
+              nativeEvent.description ?? 'WebView failed to load',
+            ),
+          );
+        }}
+      />
+    </SafeAreaView>
+  );
+}
+
+/* ------------------------------------------------------------------ */
+/*  Styles                                                             */
+/* ------------------------------------------------------------------ */
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#FFFFFF',
+  },
+  webview: {
+    flex: 1,
+  },
+});

package/src/constants.ts

@@ -0,0 +1,27 @@
+/** Production PFM endpoint. */
+export const PROD_PFM_APP_URL = 'https://pfm.equal.in';
+
+/** UAT / pre-prod PFM endpoint. */
+export const UAT_PFM_APP_URL = 'https://uat.pfm.equal.in';
+
+/** PFM path appended to the base domain. */
+export const PFM_PATH = '/pfm';
+
+/** URL path fragment that signals an SDK close event. */
+export const CLOSE_PATH = '/pfm/close';
+
+/**
+ * External URLs that must be opened in the device's default browser
+ * rather than inside the embedded webview.
+ */
+export const EXTERNAL_URL_PATTERNS: string[] = [
+  'https://www.tatamutualfund.com/raise-query',
+  'https://aa-uat.onemoney.in/',
+];
+
+/**
+ * Custom user-agent string matching the Flutter SDK to ensure
+ * identical server-side behaviour.
+ */
+export const CUSTOM_USER_AGENT =
+  'Firefox/5.0 (Linux; Android 11; Nokia 8.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.120 Mobile Safari/537.36';

package/src/index.ts

@@ -0,0 +1,10 @@
+export { PFMWebView } from './PFMWebView';
+export type { PFMWebViewProps } from './PFMWebView';
+
+export type { PFMSDKConfig } from './models/PFMSDKConfig';
+export { resolvePFMSDKConfig } from './models/PFMSDKConfig';
+
+export type { EventResponse } from './models/EventResponse';
+export { EventResponseFactory } from './models/EventResponse';
+
+export { getGatewayURL, getEqualDomain } from './PFMSDKManager';

package/src/models/EventResponse.ts

@@ -0,0 +1,39 @@
+/**
+ * Structured event payload returned through SDK callbacks.
+ */
+export interface EventResponse {
+  /** Discriminator for the event origin. */
+  eventType: string;
+
+  /** High-level outcome — e.g. "ERROR", "CLOSED". */
+  status: string;
+
+  /** Human-readable description of the event. */
+  message: string;
+
+  /** Optional status code echoed from the PFM backend. */
+  statusCode?: string;
+}
+
+/**
+ * Factory helpers for building well-typed EventResponse objects.
+ */
+export const EventResponseFactory = {
+  closed(message: string, statusCode?: string): EventResponse {
+    return {
+      eventType: 'PFM_SDK_CALLBACK',
+      status: 'CLOSED',
+      message,
+      statusCode,
+    };
+  },
+
+  error(message: string, statusCode?: string): EventResponse {
+    return {
+      eventType: 'PFM_SDK_CALLBACK',
+      status: 'ERROR',
+      message,
+      statusCode,
+    };
+  },
+};

package/src/models/PFMSDKConfig.ts

@@ -0,0 +1,30 @@
+/**
+ * Configuration for the PFM SDK.
+ *
+ * @param token  - Access token obtained from the SDK Init API (required).
+ * @param env    - Target environment. Use "production" for live,
+ *                 any other value (e.g. "pre-prod", "sandbox") routes to UAT.
+ *                 Defaults to "sandbox".
+ */
+export interface PFMSDKConfig {
+  /** Access token returned by the SDK Init API. */
+  token: string;
+
+  /**
+   * Environment selector.
+   * - `"production"` → production endpoint
+   * - Any other value  → UAT endpoint
+   * @default "sandbox"
+   */
+  env?: string;
+}
+
+/**
+ * Build a PFMSDKConfig with defaults applied.
+ */
+export function resolvePFMSDKConfig(config: PFMSDKConfig): Required<PFMSDKConfig> {
+  return {
+    token: config.token,
+    env: config.env ?? 'sandbox',
+  };
+}