@finspringinnovations/fdsdk 0.0.1

package/src/api/customerApi.ts

@@ -0,0 +1,291 @@
+import { baseApi } from './baseApi';
+import { getUserInfoForAPI } from '../config/appDataConfig';
+
+// Request/response types
+export interface GetCustomerApplicationsRequest {
+    userReferenceId: string;
+}
+
+export interface GetCustomerApplicationDetailsRequest {
+    applicationId: string;
+    customerId: string;
+    providerId?: string;
+    workflowInstanceId?: string;
+    userreferenceid?: string;
+    applicationid?: string;
+    entityid?: string;
+}
+
+export interface CustomerNomineeRequest {
+    customerId: string;
+    intentToNominate: boolean;
+    fullName: string;
+    nomineePrefix: string;
+    relation: string;
+    customRelation?: string;
+    dob: string;
+    nomineeNameOnCertificate: boolean;
+    providerId?: string;
+    workflowInstanceId?: string;
+    userreferenceid?: string;
+    applicationid?: string;
+}
+
+export interface CustomerOccupationRequest {
+    occupation: string;
+    natureOfBusiness: string;
+    customOccupation: string;
+    annualIncome: string;
+    sourceOfFund: string;
+    politicallyExposedPerson: boolean;
+    providerId?: string;
+    workflowInstanceId?: string;
+    userreferenceid?: string;
+    applicationid?: string;
+}
+
+export interface GetCustomerWebhookApplicationsRequest {
+    userReferenceId: string;
+    wfStatus?: string;
+}
+
+// If actual response models are known, replace 'any' with proper interfaces
+export type GetCustomerApplicationsResponse = any;
+export type GetCustomerApplicationDetailsResponse = any;
+export type GetCustomerWebhookApplicationsResponse = any;
+export type CustomerNomineeResponse = any;
+export type CustomerOccupationResponse = any;
+
+export const customerApi = baseApi.injectEndpoints({
+    endpoints: (builder) => ({
+        // --- Replace the existing getCustomerApplications block with the following ---
+
+        getCustomerApplications: builder.mutation<
+            GetCustomerApplicationsResponse,
+            GetCustomerApplicationsRequest
+        >({
+            query: (body) => {
+                const raw = (body as any) || {};
+                const userReferenceId =
+                    raw.userReferenceId ??
+                    raw.id ??
+                    (() => {
+                        try {
+                            return getUserInfoForAPI().userReferenceId;
+                        } catch {
+                            return undefined;
+                        }
+                    })();
+
+                const { userReferenceId: _omit, id: _omitId, ...requestBody } = raw;
+
+                if (userReferenceId) {
+                    (requestBody as any).userReferenceId = userReferenceId;
+                }
+
+                return {
+                    url: 'customer/applications',
+                    method: 'GET',
+                    params: requestBody,
+                    headers: {
+                        userreferenceid: userReferenceId || '{{userreferenceid}}',
+                    },
+                };
+            },
+
+            /**
+             * transformResponse:
+             * - Accepts backend response in multiple shapes (array, { data: [] }, { applications: [] })
+             * - Cleans each application to contain ONLY allowedKeys
+             * - Returns the response in the same outer shape it was received in,
+             *   but with the inner list replaced by the cleaned list.
+             */
+            transformResponse: (response: any) => {
+                const allowedKeys = [
+                    "application_id",
+                    "investment_amount",
+                    "interest_rate",
+                    "maturity_date",
+                    "maturity_amount",
+                    "interest_payout_term",
+                    "tenure_in_months",
+                    "transaction_id",
+                    "fd_provider_id",
+                    "fd_provider_name",
+                    "transaction_status",
+                    "transaction_description",
+                    "wf_status",
+                    "created_date",
+                    "certificate_status",
+                    "application_id",
+                    "workflow_instance_id",  // ← ADD THIS
+                    "entity_id",              // ← ADD THIS
+                    "customer_id",            // ← ADD THIS
+                    "current_task",
+                    "current_state",
+                    "fd_id",
+                ];
+
+                const cleanItem = (item: any) => {
+                    const cleaned: any = {};
+                    // copy only allowed keys
+                    allowedKeys.forEach((k) => {
+                        // keep original value (may be undefined) to keep consistent shape
+                        if (item && Object.prototype.hasOwnProperty.call(item, k)) {
+                            cleaned[k] = item[k];
+                        } else {
+                            // if backend sometimes returns camelCase (just in case), map common variants
+                            // try camelCase fallback
+                            const camel = k.replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+                            if (item && Object.prototype.hasOwnProperty.call(item, camel)) {
+                                cleaned[k] = item[camel];
+                            } else {
+                                // leave undefined (not adding extra fields)
+                            }
+                        }
+                    });
+                    return cleaned;
+                };
+
+                // Helper to extract array from several possible shapes
+                const extractArray = (resp: any): any[] => {
+                    if (Array.isArray(resp)) return resp;
+                    if (resp?.data && Array.isArray(resp.data)) return resp.data;
+                    if (resp?.applications && Array.isArray(resp.applications)) return resp.applications;
+                    // If response is an object but not containing arrays, return empty array
+                    return [];
+                };
+
+                const cleanedList = extractArray(response).map((it: any) => cleanItem(it));
+
+                // Return shape preservation:
+                if (Array.isArray(response)) {
+                    // backend returned an array -> return cleaned array
+                    return cleanedList;
+                }
+
+                if (response && response.data && Array.isArray(response.data)) {
+                    // preserve other top-level props but replace data
+                    return { ...response, data: cleanedList };
+                }
+
+                if (response && response.applications && Array.isArray(response.applications)) {
+                    return { ...response, applications: cleanedList };
+                }
+
+                // Fallback: return object with data = cleanedList (safe shape)
+                return { ...(response || {}), data: cleanedList };
+            },
+        }),
+
+
+        getCustomerApplicationDetails: builder.mutation<
+            GetCustomerApplicationDetailsResponse,
+            GetCustomerApplicationDetailsRequest
+        >({
+            query: (body) => {
+                const { providerId, workflowInstanceId, userreferenceid, applicationid, entityid, ...requestBody } = (body as any) || {};
+                const headers: Record<string, string> = {};
+                if (providerId) headers.provider = providerId;
+                if (workflowInstanceId) headers.workflowInstanceId = workflowInstanceId;
+                if (userreferenceid) headers.userreferenceid = userreferenceid;
+                if (applicationid) headers.applicationid = applicationid;
+                if (entityid) headers.entityid = entityid;
+
+                // Ensure entityid is present in request body as well (as requested)
+                const finalParams: any = { ...requestBody };
+                if (entityid) finalParams.entityid = entityid;
+
+                return {
+                    url: 'customer/application/details',
+                    method: 'GET',
+                    params: finalParams,
+                    headers,
+                };
+            },
+        }),
+
+        customerNominee: builder.mutation<
+            CustomerNomineeResponse,
+            CustomerNomineeRequest
+        >({
+            query: (body) => {
+                const { providerId, workflowInstanceId, userreferenceid, applicationid, ...requestBody } = body;
+                return {
+                    url: 'customer/nominee',
+                    method: 'POST',
+                    body: requestBody,
+                    headers: {
+                        provider: providerId || '{{shriramprovider}}',
+                        workflowInstanceId: workflowInstanceId || '{{workflowInstanceId}}',
+                        userreferenceid: userreferenceid || '{{userreferenceid}}',
+                        applicationid: applicationid || '{{applicationid}}',
+                    },
+                };
+            },
+        }),
+
+        customerOccupation: builder.mutation<
+            CustomerOccupationResponse,
+            CustomerOccupationRequest
+        >({
+            query: (body) => {
+                const { providerId, workflowInstanceId, userreferenceid, applicationid, ...requestBody } = body;
+                return {
+                    url: 'customer/occupation',
+                    method: 'POST',
+                    body: requestBody,
+                    headers: {
+                        provider: providerId || '{{shriramprovider}}',
+                        workflowInstanceId: workflowInstanceId || '{{workflowInstanceId}}',
+                        userreferenceid: userreferenceid || '{{userreferenceid}}',
+                        applicationid: applicationid || '{{applicationid}}',
+                    },
+                };
+            },
+        }),
+
+        getCustomerWebhookApplications: builder.mutation<
+            GetCustomerWebhookApplicationsResponse,
+            GetCustomerWebhookApplicationsRequest
+        >({
+            query: (body) => {
+                const raw = (body as any) || {};
+                const userReferenceId =
+                    raw.userReferenceId ??
+                    raw.id ??
+                    (() => {
+                        try {
+                            return getUserInfoForAPI().userReferenceId;
+                        } catch {
+                            return undefined;
+                        }
+                    })();
+
+                const wfStatus = raw.wfStatus || 'Completed';
+
+                return {
+                    url: 'customer/webhook/applications',
+                    method: 'GET',
+                    params: {
+                        userReferenceId,
+                        wfStatus,
+                    },
+                    headers: {
+                        userreferenceid: userReferenceId || '{{userreferenceid}}',
+                    },
+                };
+            },
+        }),
+    }),
+});
+
+export const {
+    useGetCustomerApplicationsMutation,
+    useGetCustomerApplicationDetailsMutation,
+    useGetCustomerWebhookApplicationsMutation,
+    useCustomerNomineeMutation,
+    useCustomerOccupationMutation,
+} = customerApi;
+
+

package/src/api/fdApi.ts

@@ -0,0 +1,150 @@
+import { baseApi } from './baseApi';
+
+export interface FDBankAccountRequest {
+    accountType: string;
+    accountNumber: string;
+    ifscCode: string;
+    bankName: string;
+    branchName: string;
+    customerId: string;
+    providerId?: string;
+    workflowInstanceId?: string;
+    userreferenceid?: string;
+    applicationid?: string;
+    entityid?: string;
+}
+
+export type FDBankAccountResponse = any;
+
+export interface FDBankDetailsRequest {
+    ifscCode: string;
+    providerId?: string;
+}
+
+export interface FDBankDetailsResponse {
+    status: string;
+    statusCode: number;
+    message: string;
+    data: Array<{
+        BankBranch: string;
+        BnkDescr: string;
+        BnkShrtDescr: string;
+        Code: string;
+        IfscCode: string;
+        intCustbnk_pk: string;
+    }>;
+    // Legacy fields for backward compatibility
+    bankName?: string;
+    branchName?: string;
+    ifscCode?: string;
+    address?: string;
+    city?: string;
+    state?: string;
+    pincode?: string;
+}
+
+export const fdApi = baseApi.injectEndpoints({
+    endpoints: (builder) => ({
+        createFD: builder.mutation<any, any>({
+            query: (body) => {
+                const { providerId, workflowInstanceId, userreferenceid, entityid, ...requestBody } = body;
+                return {
+                    url: 'fd/create',
+                    method: 'POST',
+                    body: requestBody, // applicationId stays in body, entityid is removed
+                    headers: {
+                        provider: providerId || '{{shriramprovider}}',
+                        workflowInstanceId: workflowInstanceId || '{{workflowInstanceId}}',
+                        userreferenceid: userreferenceid || '{{userreferenceid}}',
+                        // entityid removed from headers as it's not allowed
+                    },
+                };
+            },
+        }),
+
+        fdBankAccount: builder.mutation<FDBankAccountResponse, FDBankAccountRequest>({
+            query: (body) => {
+                const { providerId, workflowInstanceId, userreferenceid, applicationid, entityid, ...requestBody } = body;
+                return {
+                    url: 'fd/bank/account',
+                    method: 'POST',
+                    body: requestBody,
+                    headers: {
+                        provider: providerId || '{{shriramprovider}}',
+                        workflowInstanceId: workflowInstanceId || '{{workflowInstanceId}}',
+                        userreferenceid: userreferenceid || '{{userreferenceid}}',
+                        applicationid: applicationid || '{{applicationid}}',
+                        entityid: entityid || '{{entityid}}',
+                    },
+                };
+            },
+        }),
+
+        fdBankDetails: builder.query<FDBankDetailsResponse, FDBankDetailsRequest>({
+            query: (params) => {
+                const { providerId, ifscCode } = params;
+                return {
+                    url: `fd/masterdata/bank-details?ifscCode=${ifscCode}`,
+                    method: 'GET',
+                    headers: {
+                        provider: providerId || '{{shriramprovider}}',
+                    },
+                };
+            },
+        }),
+
+        paymentReverseFeed: builder.mutation<any, any>({
+            query: (body) => {
+                const { providerId, workflowInstanceId, userreferenceid, applicationid, entityid, ...requestBody } = body;
+                return {
+                    url: 'fd/payment/reversefeed',
+                    method: 'POST',
+                    body: requestBody,
+                    headers: {
+                        provider: providerId || '{{shriramprovider}}',
+                        workflowInstanceId: workflowInstanceId || '{{workflowInstanceId}}',
+                        userreferenceid: userreferenceid || '{{userreferenceid}}',
+                        applicationid: applicationid || '{{applicationid}}',
+                        entityid: entityid || '{{entityid}}',
+                    },
+                };
+            },
+        }),
+
+        // Retry payment - same header params, transactionId in body
+        paymentRetry: builder.mutation<any, any>({
+            query: (body) => {
+                const { providerId, workflowInstanceId, userreferenceid, applicationid, entityid, ...requestBody } = body;
+                return {
+                    url: 'fd/payment/retry',
+                    method: 'POST',
+                    body: requestBody, // expects { transactionId }
+                    headers: {
+                        provider: providerId || '{{shriramprovider}}',
+                        workflowInstanceId: workflowInstanceId || '{{workflowInstanceId}}',
+                        userreferenceid: userreferenceid || '{{userreferenceid}}',
+                        applicationid: applicationid || '{{applicationid}}',
+                        entityid: entityid || '{{entityid}}',
+                    },
+                };
+            },
+        }),
+
+        fdBankDetailsSearch: builder.mutation<FDBankDetailsResponse, FDBankDetailsRequest>({
+            query: (params) => {
+                const { providerId, ifscCode } = params;
+                return {
+                    url: `fd/masterdata/bank-details?ifscCode=${ifscCode}`,
+                    method: 'GET',
+                    headers: {
+                        provider: providerId || '{{shriramprovider}}',
+                    },
+                };
+            },
+        }),
+    }),
+});
+
+export const { useCreateFDMutation, useFdBankAccountMutation,
+    useFdBankDetailsQuery, useFdBankDetailsSearchMutation,
+    usePaymentReverseFeedMutation, usePaymentRetryMutation } = fdApi;

package/src/api/fdCalculatorApi.ts

@@ -0,0 +1,41 @@
+// FD Calculator API
+import { baseApi } from './baseApi';
+
+export interface FdCalculatorRequest {
+    principalAmount: number;
+    tenureInMonths: number;
+    dob: string;
+    isWomenDepositor?: boolean;
+    investmentType: string;
+    providerId?: string;
+    interestPayout?: string;
+}
+
+export interface FdCalculatorResponse {
+    status: string;
+    statusCode: number;
+    message: string;
+    data: any;
+}
+
+export const fdCalculatorApi = baseApi.injectEndpoints({
+    endpoints: (builder) => ({
+        calculateFD: builder.mutation<FdCalculatorResponse, FdCalculatorRequest>({
+            query: (body) => {
+                const { providerId, ...requestParams } = body;
+                const headers: Record<string, string> = {};
+                if (providerId) headers.provider = providerId;
+
+                const request = {
+                    url: 'interest-rates/calculate',
+                    method: 'GET' as const,
+                    params: requestParams,
+                    headers,
+                } as const;
+                return request;
+            },
+        }),
+    }),
+});
+
+export const { useCalculateFDMutation } = fdCalculatorApi;

package/src/api/index.ts

@@ -0,0 +1,29 @@
+// Main API exports
+export { baseApi } from './baseApi';
+export * from './interestRateApi';
+export * from './customerApi';
+export * from './workflowApi';
+export * from './fdCalculatorApi';
+export * from './kycApi';
+export * from './masterDataApi';
+export * from './onboardingApi';
+
+// Re-export all hooks for convenience
+export {
+    useGetInterestRatesMutation,
+} from './interestRateApi';
+
+export {
+    useGetCustomerApplicationsMutation,
+    useGetCustomerApplicationDetailsMutation,
+} from './customerApi';
+
+export {
+    useTerminateWorkflowMutation,
+    useUpdateTaskMutation,
+    useUpdateStateMutation,
+} from './workflowApi';
+
+export { useCalculateFDMutation } from './fdCalculatorApi';
+export { usePanRapidNoMutation, useEkycSendOtpMutation, useAadhaarVerifyOtpMutation } from './kycApi';
+export { useStartOnboardingMutation } from './onboardingApi';

package/src/api/interestRateApi.ts

@@ -0,0 +1,143 @@
+import { baseApi, toggleEncryption, isEncryptionEnabled, getCurrentApiConfig } from './baseApi';
+import { getUserDemographics, isSDKInitialized } from '../config/appDataConfig';
+
+// Interest Rate related interfaces
+export interface InterestRate {
+    effectiveYield: number;
+    maturityValue: number;
+    perdMonth: number; // tenure in months
+    rate: number;
+    providerId: string;
+    providerName: string;
+}
+
+export interface InterestRateRequest {
+    // New parameters for depositor information
+    isWomenDepositor?: boolean;
+    investmentType?: string;
+    dob?: string; // Date of birth
+}
+
+export interface InterestRateApiResponse {
+    status: string;
+    statusCode: number;
+    message: string;
+    data: {
+        fdrScheme: InterestRate[];
+        sdrScheme: InterestRate[];
+    };
+}
+
+export interface InterestCalculation {
+    principal: number;
+    rate: number;
+    tenure: number;
+    interest: number;
+    maturityAmount: number;
+    effectiveDate: string;
+    maturityDate: string;
+}
+
+// Interest Rate API endpoints
+export const interestRateApi = baseApi.injectEndpoints({
+    endpoints: (builder) => ({
+        // Get all available interest rates
+        getInterestRates: builder.mutation<InterestRateApiResponse, Partial<InterestRateRequest>>({
+            query: (params = {}) => {
+                // Get user demographics from app data if SDK is initialized
+                let requestBody: any = {
+                    investmentType: params.investmentType || 'SDR',
+                };
+
+                if (isSDKInitialized()) {
+                    try {
+                        const userDemographics = getUserDemographics();
+                        requestBody = {
+                            isWomenDepositor: userDemographics.isWomenDepositor,
+                            investmentType: params.investmentType || 'SDR',
+                            dob: userDemographics.dob,
+                        };
+
+                    } catch (error) {
+                        requestBody = {
+                            isWomenDepositor: params.isWomenDepositor || false,
+                            investmentType: params.investmentType || 'SDR',
+                            dob: params.dob || '1990-01-01',
+                        };
+                    }
+                } else {
+                    // Fallback to provided params or defaults
+                    requestBody = {
+                        isWomenDepositor: params.isWomenDepositor || false,
+                        investmentType: params.investmentType || 'SDR',
+                        dob: params.dob || '1990-01-01',
+                    };
+                }
+
+                return {
+                    url: 'interest-rates',
+                    method: 'GET',
+                    params: requestBody,
+                };
+            },
+            invalidatesTags: ['InterestRate'],
+        }),
+
+
+        // Toggle encryption for API requests
+        toggleEncryption: builder.mutation<{ enabled: boolean; message: string }, boolean | undefined>({
+            queryFn: async (enable) => {
+                try {
+                    const result = toggleEncryption(enable);
+                    return {
+                        data: {
+                            enabled: result,
+                            message: `Encryption ${result ? 'enabled' : 'disabled'} successfully`
+                        }
+                    };
+                } catch (error) {
+                    return {
+                        error: {
+                            status: 400,
+                            data: { message: 'Failed to toggle encryption' }
+                        }
+                    };
+                }
+            },
+        }),
+
+        // Get current encryption status
+        getEncryptionStatus: builder.query<{ enabled: boolean; config: any }, void>({
+            queryFn: async () => {
+                try {
+                    const enabled = isEncryptionEnabled();
+                    const config = getCurrentApiConfig();
+                    return {
+                        data: {
+                            enabled,
+                            config: {
+                                allowEncryptionToggle: config.allowEncryptionToggle,
+                                baseUrl: config.baseUrl,
+                                environment: config.headers['X-Environment']
+                            }
+                        }
+                    };
+                } catch (error) {
+                    return {
+                        error: {
+                            status: 500,
+                            data: { message: 'Failed to get encryption status' }
+                        }
+                    };
+                }
+            },
+        }),
+    }),
+});
+
+// Export hooks for use in components
+export const {
+    useGetInterestRatesMutation,
+    useToggleEncryptionMutation,
+    useGetEncryptionStatusQuery,
+} = interestRateApi;