@finspringinnovations/fdsdk 0.0.1

package/src/navigation/helpers.ts

@@ -0,0 +1,85 @@
+import { createRef } from 'react';
+import { CommonActions, StackActions } from '@react-navigation/native';
+import type { RootStackParamList } from './types';
+
+// Navigation ref to access navigation outside of components
+export const navigationRef = createRef<any>();
+
+// Helper to navigate outside of React components
+export function navigate<T extends keyof RootStackParamList>(
+    name: T,
+    params?: RootStackParamList[T]
+) {
+    if (navigationRef.current?.isReady()) {
+        navigationRef.current.navigate(name, params);
+    }
+}
+
+// Helper to go back
+export function goBack() {
+    if (navigationRef.current?.isReady() && navigationRef.current?.canGoBack()) {
+        navigationRef.current.goBack();
+    }
+}
+
+// Helper to reset navigation stack
+export function resetNavigation(routeName: keyof RootStackParamList, params?: any) {
+    if (navigationRef.current?.isReady()) {
+        navigationRef.current.dispatch(
+            CommonActions.reset({
+                index: 0,
+                routes: [{ name: routeName, params }],
+            })
+        );
+    }
+}
+
+// Helper to replace current screen
+export function replace<T extends keyof RootStackParamList>(
+    name: T,
+    params?: RootStackParamList[T]
+) {
+    if (navigationRef.current?.isReady()) {
+        navigationRef.current.dispatch(StackActions.replace(name, params));
+    }
+}
+
+// Helper to push a new screen onto the stack
+export function push<T extends keyof RootStackParamList>(
+    name: T,
+    params?: RootStackParamList[T]
+) {
+    if (navigationRef.current?.isReady()) {
+        navigationRef.current.dispatch(StackActions.push(name, params));
+    }
+}
+
+// Helper to pop screens from the stack
+export function pop(count: number = 1) {
+    if (navigationRef.current?.isReady()) {
+        navigationRef.current.dispatch(StackActions.pop(count));
+    }
+}
+
+// Helper to get current route name
+export function getCurrentRouteName() {
+    if (navigationRef.current?.isReady()) {
+        return navigationRef.current.getCurrentRoute()?.name;
+    }
+    return null;
+}
+
+// Helper to check if can go back
+export function canGoBack() {
+    if (navigationRef.current?.isReady()) {
+        return navigationRef.current.canGoBack();
+    }
+    return false;
+}
+
+// Helper for SDK exit functionality
+export function exitSDK() {
+    // This can be customized based on how the SDK is integrated
+    // For now, we'll reset to the home screen
+    resetNavigation('Home');
+}

package/src/navigation/index.tsx

@@ -0,0 +1,81 @@
+import React from 'react';
+import { NavigationContainer } from '@react-navigation/native';
+import RootNavigator from './RootNavigator';
+import SimpleNavigator from './SimpleNavigator';
+import type { SimpleNavigationConfig } from './SimpleNavigator';
+import type { SDKNavigationConfig } from './types';
+import { ThemeProvider } from '../theme/ThemeContext';
+import { ApiProvider } from '../providers/ApiProvider';
+import { MasterDataProvider } from '../providers/MasterDataProvider';
+import { navigationRef } from './helpers';
+import type { ThemeName, Theme } from '../theme';
+
+interface SDKNavigationContainerProps {
+    config?: SDKNavigationConfig;
+    onExit?: (fdDetails?: any) => void;
+    children?: React.ReactNode;
+    theme?: ThemeName | Theme;
+    useReactNavigation?: boolean; // Flag to use React Navigation vs Simple Navigator
+}
+
+// Main navigation container for the SDK
+export const SDKNavigationContainer: React.FC<SDKNavigationContainerProps> = ({
+    config,
+    onExit,
+    children,
+    theme,
+    useReactNavigation = true, // Default to React Navigation
+}) => {
+    // Choose navigator based on flag
+    const navigator = useReactNavigation
+        ? <RootNavigator config={config} onExit={onExit} />
+        : <SimpleNavigator config={config as SimpleNavigationConfig} onExit={onExit} />;
+
+    const content = children || (
+        useReactNavigation ? (
+            <NavigationContainer ref={navigationRef}>
+                {navigator}
+            </NavigationContainer>
+        ) : (
+            navigator
+        )
+    );
+
+    if (theme) {
+        const themeProps = typeof theme === 'string'
+            ? { initialTheme: theme }
+            : { theme };
+
+        return (
+            <ApiProvider>
+                <MasterDataProvider>
+                    <ThemeProvider {...themeProps}>
+                        {content}
+                    </ThemeProvider>
+                </MasterDataProvider>
+            </ApiProvider>
+        );
+    }
+
+    // Default theme provider with API provider
+    return (
+        <ApiProvider>
+            <MasterDataProvider>
+                <ThemeProvider>
+                    {content}
+                </ThemeProvider>
+            </MasterDataProvider>
+        </ApiProvider>
+    );
+};
+
+// Default export for easy import
+export default SDKNavigationContainer;
+
+// React Navigation version - always uses React Navigation Stack Navigator
+export const ShriramSDKNavigator: React.FC<Omit<SDKNavigationContainerProps, 'useReactNavigation'>> = (props) => (
+    <SDKNavigationContainer {...props} useReactNavigation={true} />
+);
+
+// Named exports for different aliases
+export { SimpleNavigator };

package/src/navigation/types.ts

@@ -0,0 +1,124 @@
+import type { NavigatorScreenParams } from '@react-navigation/native';
+
+// Define the param list for the main stack navigator
+export type RootStackParamList = {
+    Home: undefined;
+    FDList: undefined;
+    FDCalculator: {
+        fdData?: {
+            id: string;
+            name: string;
+            accountNumber: string;
+            roi: string;
+            tenure: string;
+            amount: number;
+            maturityDate: string;
+            status: 'active' | 'matured' | 'pending';
+            creditRating: string;
+        };
+    };
+    AadhaarVerification: {
+        fdData?: {
+            id: string;
+            name: string;
+            accountNumber: string;
+            roi: string;
+            tenure: string;
+            amount: number;
+            maturityDate: string;
+            status: 'active' | 'matured' | 'pending';
+            creditRating: string;
+        };
+    };
+    ReviewKYC: {
+        fdData?: {
+            id: string;
+            name: string;
+            accountNumber: string;
+            roi: string;
+            tenure: string;
+            amount: number;
+            maturityDate: string;
+            status: 'active' | 'matured' | 'pending';
+            creditRating: string;
+        };
+        kycData?: any;
+    };
+    BookFD: {
+        fdData?: {
+            id: string;
+            name: string;
+            accountNumber: string;
+            roi: string;
+            tenure: string;
+            amount: number;
+            maturityDate: string;
+            status: 'active' | 'matured' | 'pending';
+            creditRating: string;
+        };
+    };
+    Employee: undefined;
+    NomineeDetail: undefined;
+    BankDetail: undefined;
+    AddBankAccount: {
+        selectedIFSC?: {
+            bankName: string;
+            branchName: string;
+            ifscCode: string;
+        };
+    };
+    FindIFSC: {
+        initialSearchTerm?: string;
+    };
+    PayNow: {
+        fdData?: {
+            companyName: string;
+            amount: number;
+            fdRate: string;
+            tenure: string;
+            interestPayout: string;
+        };
+    };
+    Payment: undefined;
+    PaymentStatus: {
+        status?: 'success' | 'failed' | 'pending';
+        transactionId?: string;
+        fdData?: {
+            companyName: string;
+            amount: number;
+            fdRate: string;
+            tenure: string;
+            interestPayout: string;
+        };
+        paymentData?: any;
+    };
+};
+
+// Navigation prop types for screens
+export type NavigationProps = {
+    navigation: any;
+    route: any;
+};
+
+// Screen component props that include navigation
+export type ScreenProps<T extends keyof RootStackParamList> = {
+    navigation: any;
+    route: {
+        params: RootStackParamList[T];
+    };
+};
+
+// SDK Configuration for navigation
+export interface SDKNavigationConfig {
+    initialRouteName?: keyof RootStackParamList;
+    onExit?: (fdDetails?: any) => void;
+    customScreenOptions?: object;
+}
+
+// Navigation context type
+export interface NavigationContextType {
+    navigate: (screen: keyof RootStackParamList, params?: any) => void;
+    goBack: () => void;
+    reset: (routeName: keyof RootStackParamList) => void;
+    exit: () => void;
+}

package/src/navigation/workflowNavigator.ts

@@ -0,0 +1,131 @@
+import { navigate } from './helpers';
+import type { InvestmentData, CustomerData, AppData, FDData } from '../types/dataTypes';
+import type { WorkflowStateSriram } from '../types/workflowTypes';
+import { WORKFLOW_STATES } from '../config/workflowConstants';
+
+/**
+ * Centralized navigation for FD workflow based on Flutter implementation
+ */
+export async function handleWorkflowNavigation({
+    workflowState,
+    investmentData,
+    customerData,
+    appData,
+    fdData,
+    completedApplications = [],
+    transactionId,
+}: {
+    workflowState: WorkflowStateSriram;
+    investmentData?: InvestmentData;
+    customerData?: CustomerData;
+    appData?: AppData;
+    fdData?: FDData;
+    completedApplications?: any[];
+    transactionId?: string;
+}) {
+
+    switch (workflowState) {
+        case WORKFLOW_STATES.START:
+        case WORKFLOW_STATES.INITIATION:
+            // No navigation required
+            break;
+
+        case WORKFLOW_STATES.CREATE_FD:
+            // Navigate to FD overview first, then to occupation
+            navigate('PayNow', {
+                fdData: fdData ? {
+                    companyName: fdData.name,
+                    amount: fdData.amount,
+                    fdRate: fdData.roi,
+                    tenure: fdData.tenure,
+                    interestPayout: 'Yearly' // Default value
+                } : undefined
+            } as any);
+            // The flow will continue to occupation after FD selection
+            break;
+
+        case WORKFLOW_STATES.OCCUPATION:
+            navigate('Employee');
+            break;
+
+        case WORKFLOW_STATES.NOMINEE:
+            navigate('NomineeDetail');
+            break;
+
+        case WORKFLOW_STATES.BANK_DETAILS:
+            navigate('BankDetail');
+            break;
+
+        case WORKFLOW_STATES.KYC:
+            navigate('ReviewKYC');
+            break;
+
+        case WORKFLOW_STATES.PAYMENT:
+            // Handle payment status check and navigation
+            if (transactionId) {
+                // Navigate to payment screen with transaction ID
+                navigate('Payment');
+            } else {
+                navigate('PayNow', {
+                    fdData: fdData ? {
+                        companyName: fdData.name,
+                        amount: fdData.amount,
+                        fdRate: fdData.roi,
+                        tenure: fdData.tenure,
+                        interestPayout: '' // Default value
+                    } : undefined
+                } as any);
+            }
+            break;
+
+        case WORKFLOW_STATES.END:
+            navigate('PaymentStatus', {
+                transactionId,
+                fdData: fdData ? {
+                    companyName: fdData.name,
+                    amount: fdData.amount,
+                    fdRate: fdData.roi,
+                    tenure: fdData.tenure,
+                    interestPayout: '' // Default value
+                } : undefined
+            });
+            break;
+
+        default:
+    }
+}
+
+/**
+ * Handle FD selection from FDList and start the workflow
+ */
+export function handleFDSelection(fdData: FDData, investmentData?: InvestmentData) {
+
+    // Store FD data in Redux (this should be done in FDList component)
+    // Then navigate to occupation screen
+    handleWorkflowNavigation({
+        workflowState: WORKFLOW_STATES.OCCUPATION,
+        investmentData,
+        fdData,
+    });
+}
+
+/**
+ * Navigate through the complete FD creation flow
+ */
+export function navigateFDCreationFlow(fdData: FDData, investmentData?: InvestmentData) {
+
+    // This represents the complete flow from FD selection to payment
+    const flow = [
+        WORKFLOW_STATES.OCCUPATION,    // Employee screen
+        WORKFLOW_STATES.NOMINEE,       // NomineeDetail screen  
+        WORKFLOW_STATES.BANK_DETAILS,  // BankDetail screen
+        WORKFLOW_STATES.PAYMENT,       // PayNow screen
+    ];
+
+    // Start with occupation
+    handleWorkflowNavigation({
+        workflowState: WORKFLOW_STATES.OCCUPATION,
+        investmentData,
+        fdData,
+    });
+}

package/src/providers/ApiProvider.tsx

@@ -0,0 +1,43 @@
+import React from 'react';
+import { Provider } from 'react-redux';
+import { store } from '../store';
+import { getSDKStoreRef, setSDKStoreRef } from '../api/baseApi';
+
+interface ApiProviderProps {
+    children: React.ReactNode;
+    apiBaseUrl?: string;
+}
+
+export const ApiProvider: React.FC<ApiProviderProps> = ({
+    children,
+    apiBaseUrl
+}) => {
+    // ✅ CRITICAL: Ensure SDK store reference is set before rendering
+    // This ensures the interceptor always uses SDK's store state
+    React.useEffect(() => {
+        if (!getSDKStoreRef()) {
+            setSDKStoreRef(store);
+            if (__DEV__) {
+                console.log('✅ [ApiProvider] SDK store reference set');
+            }
+        }
+    }, []);
+
+    // Safety check: Ensure store is valid
+    if (!store) {
+        if (__DEV__) {
+            console.error('❌ [ApiProvider] SDK store is undefined!');
+        }
+        return null;
+    }
+
+    // If a custom API base URL is provided, we could update the store configuration
+    // For now, we'll use the default configuration
+    return (
+        <Provider store={store}>
+            {children}
+        </Provider>
+    );
+};
+
+export default ApiProvider;

package/src/providers/MasterDataProvider.tsx

@@ -0,0 +1,30 @@
+import React, { createContext, useContext } from 'react';
+
+interface MasterDataState {
+    masterData?: any;
+    setMasterData: (data: any) => void;
+}
+
+const MasterDataContext = createContext<MasterDataState | undefined>(undefined);
+
+export const MasterDataProvider: React.FC<{ children: React.ReactNode }> = ({ children }) => {
+    const [masterData, setMasterData] = React.useState<any | undefined>(undefined);
+
+    const value = React.useMemo(() => ({ masterData, setMasterData }), [masterData]);
+
+    return (
+        <MasterDataContext.Provider value={value}>{children}</MasterDataContext.Provider>
+    );
+};
+
+export const useMasterData = (): MasterDataState => {
+    const ctx = useContext(MasterDataContext);
+    if (!ctx) {
+        // Provide a safe fallback to avoid crashes if provider is missing
+        const noop = () => { };
+        return { masterData: undefined, setMasterData: noop } as MasterDataState;
+    }
+    return ctx;
+};
+
+