@finspringinnovations/fixeddepositsdk 1.0.0

package/src/navigation/SimpleNavigator.tsx

@@ -0,0 +1,123 @@
+import React, { useState } from 'react';
+//import Home from '../screens/Home';
+import FDList from '../screens/FDList';
+//import BookFD from '../screens/BookFD';
+import FDCalculator from '../screens/FDCalculator';
+//import type { FDBookingData } from '../screens/BookFD';
+
+export type SimpleNavigationRoute = 'Home' | 'FDList' | 'BookFD' | 'FDCalculator';
+
+export interface SimpleNavigationConfig {
+    initialRouteName?: SimpleNavigationRoute;
+}
+
+interface SimpleNavigatorProps {
+    config?: SimpleNavigationConfig;
+    onExit?: () => void;
+}
+
+const SimpleNavigator: React.FC<SimpleNavigatorProps> = ({ config, onExit }) => {
+    const [currentRoute, setCurrentRoute] = useState<SimpleNavigationRoute>(
+        config?.initialRouteName || 'FDList'
+    );
+    const [routeParams, setRouteParams] = useState<any>(null);
+
+    const navigate = (routeName: SimpleNavigationRoute, params?: any) => {
+        setCurrentRoute(routeName);
+        setRouteParams(params);
+    };
+
+    const goBack = () => {
+        // Simple back navigation logic
+        switch (currentRoute) {
+            case 'FDList':
+                // FDList is now the first screen, so exit SDK
+                if (onExit) {
+                    onExit();
+                }
+                break;
+            case 'BookFD':
+            case 'FDCalculator':
+                setCurrentRoute('FDList');
+                setRouteParams(null);
+                break;
+            case 'Home':
+                // If somehow on Home, go back to FDList
+                setCurrentRoute('FDList');
+                setRouteParams(null);
+                break;
+            default:
+                if (onExit) {
+                    onExit();
+                }
+                break;
+        }
+    };
+
+    // const handleBookingComplete = (data: FDBookingData) => {
+    //     goBack(); // Go back to FD List after booking
+    // };
+
+    const renderCurrentScreen = () => {
+        switch (currentRoute) {
+            // case 'Home':
+            //     return (
+            //         <Home
+            //             onNavigateToBookFD={() => navigate('BookFD')}
+            //             onNavigateToFDList={() => navigate('FDList')}
+            //         />
+            //     );
+            case 'FDList':
+                return (
+                    <FDList
+                        onGoBack={goBack}
+                        onSelectFD={(fdId: string) => { /* FD selected */ }}
+                        onNavigateToFDCalculator={(fdData: any) => navigate('FDCalculator', { fdData })}
+                        onNavigateToExternalSDK={
+                            // SimpleNavigator is intended for demo/basic flows, so we don't support external SDKs here.
+                            // The full RootNavigator should be used when integrating with Shriram/Mahindra SDK flows.
+                            () => {
+                                console.warn(
+                                    'External SDK navigation not supported in SimpleNavigator. Use SDKNavigationContainer / RootNavigator instead.'
+                                );
+                            }
+                        }
+                    />
+                );
+            // case 'BookFD':
+            //     return (
+            //         <BookFD
+            //             onGoBack={goBack}
+            //             onBookingComplete={handleBookingComplete}
+            //             fdData={routeParams?.fdData}
+            //         />
+            //     );
+            case 'FDCalculator':
+                return (
+                    <FDCalculator
+                        onGoBack={goBack}
+                        fdData={routeParams?.fdData}
+                    />
+                );
+            default:
+                return (
+                    <FDList
+                        onGoBack={goBack}
+                        onSelectFD={(fdId: string) => { /* FD selected */ }}
+                        onNavigateToFDCalculator={(fdData: any) => navigate('FDCalculator', { fdData })}
+                        onNavigateToExternalSDK={
+                            () => {
+                                console.warn(
+                                    'External SDK navigation not supported in SimpleNavigator. Use SDKNavigationContainer / RootNavigator instead.'
+                                );
+                            }
+                        }
+                    />
+                );
+        }
+    };
+
+    return renderCurrentScreen();
+};
+
+export default SimpleNavigator;

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,84 @@
+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;
+    onPanRequired?: () => void;
+    children?: React.ReactNode;
+    /** Theme applied to fdsdk and passed through to Shriram and Mahindra when they are shown. */
+    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,
+    onPanRequired,
+    children,
+    theme,
+    useReactNavigation = true, // Default to React Navigation
+}) => {
+    // Choose navigator based on flag
+    const navigator = useReactNavigation
+        ? <RootNavigator config={config} onExit={onExit} onPanRequired={onPanRequired} />
+        : <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 FDSDKNavigator: 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,146 @@
+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: {
+        paymentUrl?: string;
+        transactionId?: string;
+        applicationId?: string;
+        workflowInstanceId?: string;
+        entityId?: string;
+        providerId?: string;
+    } | undefined;
+    PaymentStatus: {
+        status?: 'success' | 'failed' | 'pending';
+        transactionId?: string;
+        fdData?: {
+            companyName: string;
+            amount: number;
+            fdRate: string;
+            tenure: string;
+            interestPayout: string;
+        };
+        paymentData?: any;
+    };
+    ExternalSDK: {
+        sdkType: 'shriram' | 'mahindra';
+        fdData?: any;
+        providerId?: string;
+        fdListSelectedData?: any;
+        completeFDData?: boolean;
+        masterData?: any;
+        onboardingIds?: any;
+        initialRouteName?: string;
+        /** When opening Shriram with initialRouteName 'PaymentStatus', pass status/transactionId/fdData here */
+        initialPaymentStatusParams?: { status?: 'success' | 'failed' | 'pending'; transactionId?: string; fdData?: any };
+        shriramSDKGlobalData?: any;
+        mahindraSDKGlobalData?: any;
+        forceFetchCustomerDetails?: boolean;
+    };
+};
+
+// 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,23 @@
+import React from 'react';
+import { Provider } from 'react-redux';
+import { store } from '../store';
+
+interface ApiProviderProps {
+    children: React.ReactNode;
+    apiBaseUrl?: string;
+}
+
+export const ApiProvider: React.FC<ApiProviderProps> = ({
+    children,
+    apiBaseUrl
+}) => {
+    // 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;
+};
+
+