framepayments-react-native 3.0.0 → 4.0.0

package/lib/ui/screens/onboarding/onboardingReducer.d.ts

@@ -0,0 +1,201 @@
+import type { PaymentMethod as FramePaymentMethod } from 'framepayments/dist/types/payment_methods';
+import type { OnboardingCapability } from '../../../types';
+export type OnboardingStep = 'verification_welcome' | 'personal_information' | 'confirm_payment_method' | 'confirm_bank_account' | 'upload_documents' | 'verification_submitted';
+export type PersonalInfoSubStep = 'phone_auth' | 'verify_phone' | 'customer_information' | 'geolocation';
+export type ConfirmPaymentMethodSubStep = 'select' | 'add' | 'secure_3ds';
+export type ConfirmBankAccountSubStep = 'select' | 'add';
+export type UploadDocumentsSubStep = 'list' | 'capture_front' | 'review_front' | 'capture_back' | 'review_back' | 'capture_selfie' | 'review_selfie';
+export type OnboardingSubStep = PersonalInfoSubStep | ConfirmPaymentMethodSubStep | ConfirmBankAccountSubStep | UploadDocumentsSubStep;
+export type VerifyPhoneUi = 'loading_prove' | 'otp_for_prove' | 'otp_frame_api';
+export type IdDocumentType = 'drivers_license' | 'passport' | 'state_id' | 'military_id';
+export type AchAccountType = 'checking' | 'savings';
+export interface OnboardingAddress {
+    line1: string;
+    line2: string;
+    city: string;
+    state: string;
+    country: string;
+    postalCode: string;
+}
+export interface OnboardingAch {
+    routingNumber: string;
+    accountNumber: string;
+    accountType: AchAccountType;
+}
+export interface CapturedPhoto {
+    uri: string;
+    type: string;
+    name: string;
+}
+export interface OnboardingDocs {
+    idType: IdDocumentType | null;
+    front: CapturedPhoto | null;
+    back: CapturedPhoto | null;
+    selfie: CapturedPhoto | null;
+}
+export interface PhoneCountry {
+    alpha2: string;
+    callingCode: string;
+}
+export interface OnboardingState {
+    requiredCapabilities: ReadonlyArray<OnboardingCapability>;
+    flow: ReadonlyArray<OnboardingStep>;
+    currentStep: OnboardingStep;
+    subStep: OnboardingSubStep | null;
+    accountId: string | null;
+    accountLoaded: boolean;
+    termsOfServiceToken: string | null;
+    existingAccountHasTOS: boolean;
+    phoneCountry: PhoneCountry;
+    phoneNumber: string;
+    dobMonth: string;
+    dobDay: string;
+    dobYear: string;
+    pendingVerificationId: string | null;
+    pendingProveAuthToken: string | null;
+    verifyPhoneUi: VerifyPhoneUi | null;
+    otpCode: string;
+    customerFirstName: string;
+    customerLastName: string;
+    customerEmail: string;
+    ssnLast4: string;
+    address: OnboardingAddress;
+    savedPaymentMethods: ReadonlyArray<FramePaymentMethod>;
+    selectedPaymentMethodId: string | null;
+    addressVerificationOnly: boolean;
+    cardComplete: boolean;
+    threeDsVerificationId: string | null;
+    savedPayoutMethods: ReadonlyArray<FramePaymentMethod>;
+    selectedPayoutMethodId: string | null;
+    ach: OnboardingAch;
+    achManualMode: boolean;
+    customerIdentityId: string | null;
+    docs: OnboardingDocs;
+    isPerformingAction: boolean;
+    fieldErrors: Readonly<Record<string, string>>;
+}
+export type OnboardingAction = {
+    type: 'SET_FLOW';
+    flow: ReadonlyArray<OnboardingStep>;
+    currentStep: OnboardingStep;
+    subStep: OnboardingSubStep | null;
+} | {
+    type: 'GO_TO_STEP';
+    step: OnboardingStep;
+    subStep: OnboardingSubStep | null;
+} | {
+    type: 'SET_SUB_STEP';
+    subStep: OnboardingSubStep | null;
+} | {
+    type: 'SET_REQUIRED_CAPABILITIES';
+    capabilities: ReadonlyArray<OnboardingCapability>;
+} | {
+    type: 'SET_ACCOUNT_ID';
+    id: string | null;
+} | {
+    type: 'SET_ACCOUNT_LOADED';
+    loaded: boolean;
+} | {
+    type: 'SET_TERMS_OF_SERVICE_TOKEN';
+    token: string | null;
+} | {
+    type: 'SET_EXISTING_ACCOUNT_HAS_TOS';
+    value: boolean;
+} | {
+    type: 'PREFILL';
+    values: Partial<OnboardingState>;
+} | {
+    type: 'SET_PHONE_COUNTRY';
+    country: PhoneCountry;
+} | {
+    type: 'SET_PHONE_NUMBER';
+    value: string;
+} | {
+    type: 'SET_DOB';
+    month: string;
+    day: string;
+    year: string;
+} | {
+    type: 'SET_VERIFY_PHONE';
+    verificationId: string | null;
+    proveAuthToken: string | null;
+    ui: VerifyPhoneUi | null;
+} | {
+    type: 'SET_VERIFY_PHONE_UI';
+    ui: VerifyPhoneUi | null;
+} | {
+    type: 'SET_OTP_CODE';
+    value: string;
+} | {
+    type: 'SET_CUSTOMER_FIRST_NAME';
+    value: string;
+} | {
+    type: 'SET_CUSTOMER_LAST_NAME';
+    value: string;
+} | {
+    type: 'SET_CUSTOMER_EMAIL';
+    value: string;
+} | {
+    type: 'SET_SSN_LAST4';
+    value: string;
+} | {
+    type: 'SET_ADDRESS_FIELD';
+    field: keyof OnboardingAddress;
+    value: string;
+} | {
+    type: 'SET_SAVED_PAYMENT_METHODS';
+    methods: ReadonlyArray<FramePaymentMethod>;
+} | {
+    type: 'APPEND_SAVED_PAYMENT_METHOD';
+    method: FramePaymentMethod;
+} | {
+    type: 'SELECT_PAYMENT_METHOD';
+    id: string | null;
+} | {
+    type: 'SET_ADDRESS_VERIFICATION_ONLY';
+    value: boolean;
+} | {
+    type: 'SET_CARD_COMPLETE';
+    value: boolean;
+} | {
+    type: 'SET_THREE_DS_VERIFICATION_ID';
+    id: string | null;
+} | {
+    type: 'SET_SAVED_PAYOUT_METHODS';
+    methods: ReadonlyArray<FramePaymentMethod>;
+} | {
+    type: 'SELECT_PAYOUT_METHOD';
+    id: string | null;
+} | {
+    type: 'SET_ACH_FIELD';
+    field: keyof OnboardingAch;
+    value: string;
+} | {
+    type: 'SET_ACH_ACCOUNT_TYPE';
+    value: AchAccountType;
+} | {
+    type: 'SET_ACH_MANUAL_MODE';
+    value: boolean;
+} | {
+    type: 'SET_CUSTOMER_IDENTITY_ID';
+    id: string | null;
+} | {
+    type: 'SET_DOC_ID_TYPE';
+    value: IdDocumentType | null;
+} | {
+    type: 'SET_DOC_PHOTO';
+    side: 'front' | 'back' | 'selfie';
+    photo: CapturedPhoto | null;
+} | {
+    type: 'SET_PERFORMING_ACTION';
+    value: boolean;
+} | {
+    type: 'SET_FIELD_ERRORS';
+    errors: Record<string, string>;
+} | {
+    type: 'CLEAR_FIELD_ERROR';
+    field: string;
+};
+export declare function initialOnboardingState(requiredCapabilities: ReadonlyArray<OnboardingCapability>, accountId: string | null): OnboardingState;
+export declare function onboardingReducer(state: OnboardingState, action: OnboardingAction): OnboardingState;
+//# sourceMappingURL=onboardingReducer.d.ts.map

package/lib/ui/screens/onboarding/onboardingReducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboardingReducer.d.ts","sourceRoot":"","sources":["../../../../src/ui/screens/onboarding/onboardingReducer.ts"],"names":[],"mappings":"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"}

package/lib/ui/screens/onboarding/onboardingReducer.js

@@ -0,0 +1,232 @@
+const DEFAULT_PHONE_COUNTRY = { alpha2: 'US', callingCode: '1' };
+const DEFAULT_ADDRESS = {
+    line1: '',
+    line2: '',
+    city: '',
+    state: '',
+    country: 'US',
+    postalCode: '',
+};
+const DEFAULT_ACH = {
+    routingNumber: '',
+    accountNumber: '',
+    accountType: 'checking',
+};
+const DEFAULT_DOCS = {
+    idType: null,
+    front: null,
+    back: null,
+    selfie: null,
+};
+export function initialOnboardingState(requiredCapabilities, accountId) {
+    return {
+        requiredCapabilities,
+        flow: [],
+        currentStep: 'verification_welcome',
+        subStep: null,
+        accountId,
+        accountLoaded: false,
+        termsOfServiceToken: null,
+        existingAccountHasTOS: false,
+        phoneCountry: DEFAULT_PHONE_COUNTRY,
+        phoneNumber: '',
+        dobMonth: '',
+        dobDay: '',
+        dobYear: '',
+        pendingVerificationId: null,
+        pendingProveAuthToken: null,
+        verifyPhoneUi: null,
+        otpCode: '',
+        customerFirstName: '',
+        customerLastName: '',
+        customerEmail: '',
+        ssnLast4: '',
+        address: { ...DEFAULT_ADDRESS },
+        savedPaymentMethods: [],
+        selectedPaymentMethodId: null,
+        addressVerificationOnly: false,
+        cardComplete: false,
+        threeDsVerificationId: null,
+        savedPayoutMethods: [],
+        selectedPayoutMethodId: null,
+        ach: { ...DEFAULT_ACH },
+        achManualMode: false,
+        customerIdentityId: null,
+        docs: { ...DEFAULT_DOCS },
+        isPerformingAction: false,
+        fieldErrors: {},
+    };
+}
+function clearError(errors, field) {
+    if (!(field in errors))
+        return errors;
+    const next = { ...errors };
+    delete next[field];
+    return next;
+}
+export function onboardingReducer(state, action) {
+    switch (action.type) {
+        case 'SET_FLOW':
+            return { ...state, flow: action.flow, currentStep: action.currentStep, subStep: action.subStep };
+        case 'GO_TO_STEP':
+            return { ...state, currentStep: action.step, subStep: action.subStep };
+        case 'SET_SUB_STEP':
+            return { ...state, subStep: action.subStep };
+        case 'SET_REQUIRED_CAPABILITIES':
+            return { ...state, requiredCapabilities: action.capabilities };
+        case 'SET_ACCOUNT_ID':
+            return { ...state, accountId: action.id };
+        case 'SET_ACCOUNT_LOADED':
+            return { ...state, accountLoaded: action.loaded };
+        case 'SET_TERMS_OF_SERVICE_TOKEN':
+            return { ...state, termsOfServiceToken: action.token };
+        case 'SET_EXISTING_ACCOUNT_HAS_TOS':
+            return { ...state, existingAccountHasTOS: action.value };
+        case 'PREFILL':
+            // Only writes fields the user has not touched. Empty-string fields and
+            // null cross-step ids are considered untouched; anything else stays.
+            return mergePrefill(state, action.values);
+        case 'SET_PHONE_COUNTRY':
+            // Strip a leading '+' from callingCode so the view model's E.164
+            // assembly (`+${callingCode}${digits}`) is idempotent regardless of
+            // whether callers hand us '+1' (libphonenumber-js style) or '1'.
+            return {
+                ...state,
+                phoneCountry: {
+                    alpha2: action.country.alpha2,
+                    callingCode: action.country.callingCode.replace(/^\+/, ''),
+                },
+            };
+        case 'SET_PHONE_NUMBER':
+            return { ...state, phoneNumber: action.value, fieldErrors: clearError(state.fieldErrors, 'phoneNumber') };
+        case 'SET_DOB':
+            return {
+                ...state,
+                dobMonth: action.month,
+                dobDay: action.day,
+                dobYear: action.year,
+                fieldErrors: clearError(state.fieldErrors, 'dob'),
+            };
+        case 'SET_VERIFY_PHONE':
+            return {
+                ...state,
+                pendingVerificationId: action.verificationId,
+                pendingProveAuthToken: action.proveAuthToken,
+                verifyPhoneUi: action.ui,
+                otpCode: '',
+            };
+        case 'SET_VERIFY_PHONE_UI':
+            return { ...state, verifyPhoneUi: action.ui };
+        case 'SET_OTP_CODE':
+            return { ...state, otpCode: action.value, fieldErrors: clearError(state.fieldErrors, 'otpCode') };
+        case 'SET_CUSTOMER_FIRST_NAME':
+            return {
+                ...state,
+                customerFirstName: action.value,
+                fieldErrors: clearError(state.fieldErrors, 'customerFirstName'),
+            };
+        case 'SET_CUSTOMER_LAST_NAME':
+            return {
+                ...state,
+                customerLastName: action.value,
+                fieldErrors: clearError(state.fieldErrors, 'customerLastName'),
+            };
+        case 'SET_CUSTOMER_EMAIL':
+            return {
+                ...state,
+                customerEmail: action.value,
+                fieldErrors: clearError(state.fieldErrors, 'customerEmail'),
+            };
+        case 'SET_SSN_LAST4':
+            return { ...state, ssnLast4: action.value, fieldErrors: clearError(state.fieldErrors, 'ssnLast4') };
+        case 'SET_ADDRESS_FIELD': {
+            const nextAddress = { ...state.address, [action.field]: action.value };
+            return {
+                ...state,
+                address: nextAddress,
+                fieldErrors: clearError(state.fieldErrors, `address.${action.field}`),
+            };
+        }
+        case 'SET_SAVED_PAYMENT_METHODS':
+            return { ...state, savedPaymentMethods: action.methods };
+        case 'APPEND_SAVED_PAYMENT_METHOD':
+            return {
+                ...state,
+                savedPaymentMethods: [...state.savedPaymentMethods, action.method],
+            };
+        case 'SELECT_PAYMENT_METHOD':
+            return { ...state, selectedPaymentMethodId: action.id };
+        case 'SET_ADDRESS_VERIFICATION_ONLY':
+            return { ...state, addressVerificationOnly: action.value };
+        case 'SET_CARD_COMPLETE':
+            return { ...state, cardComplete: action.value };
+        case 'SET_THREE_DS_VERIFICATION_ID':
+            return { ...state, threeDsVerificationId: action.id };
+        case 'SET_SAVED_PAYOUT_METHODS':
+            return { ...state, savedPayoutMethods: action.methods };
+        case 'SELECT_PAYOUT_METHOD':
+            return { ...state, selectedPayoutMethodId: action.id };
+        case 'SET_ACH_FIELD': {
+            const nextAch = { ...state.ach, [action.field]: action.value };
+            return { ...state, ach: nextAch, fieldErrors: clearError(state.fieldErrors, `ach.${action.field}`) };
+        }
+        case 'SET_ACH_ACCOUNT_TYPE':
+            return { ...state, ach: { ...state.ach, accountType: action.value } };
+        case 'SET_ACH_MANUAL_MODE':
+            return { ...state, achManualMode: action.value };
+        case 'SET_CUSTOMER_IDENTITY_ID':
+            return { ...state, customerIdentityId: action.id };
+        case 'SET_DOC_ID_TYPE':
+            return { ...state, docs: { ...state.docs, idType: action.value } };
+        case 'SET_DOC_PHOTO':
+            return { ...state, docs: { ...state.docs, [action.side]: action.photo } };
+        case 'SET_PERFORMING_ACTION':
+            return { ...state, isPerformingAction: action.value };
+        case 'SET_FIELD_ERRORS':
+            return { ...state, fieldErrors: action.errors };
+        case 'CLEAR_FIELD_ERROR':
+            return { ...state, fieldErrors: clearError(state.fieldErrors, action.field) };
+    }
+}
+// Merge prefilled values into state. Only writes fields that are still "empty"
+// from the user's perspective. Strings: empty-string is replaceable. Null
+// scalars: replaceable. Objects (address): each scalar field handled by the
+// same rule recursively.
+function mergePrefill(state, values) {
+    const next = { ...state };
+    for (const key of Object.keys(values)) {
+        const incoming = values[key];
+        if (incoming === undefined)
+            continue;
+        if (key === 'address' && typeof incoming === 'object' && incoming !== null) {
+            next.address = mergeAddressPrefill(state.address, incoming);
+            continue;
+        }
+        const current = state[key];
+        if (typeof current === 'string' && current === '') {
+            // @ts-expect-error — narrow the union; runtime check ensures shape match
+            next[key] = incoming;
+        }
+        else if (current === null) {
+            // @ts-expect-error — same
+            next[key] = incoming;
+        }
+        else if (typeof current === 'boolean' && current === false && typeof incoming === 'boolean') {
+            // booleans only flipped if currently false (default) — preserves explicit toggles
+            // @ts-expect-error — same
+            next[key] = incoming;
+        }
+        // arrays, objects (non-address), non-empty strings, true booleans → keep user value
+    }
+    return next;
+}
+function mergeAddressPrefill(current, incoming) {
+    return {
+        line1: current.line1 === '' && incoming.line1 ? incoming.line1 : current.line1,
+        line2: current.line2 === '' && incoming.line2 ? incoming.line2 : current.line2,
+        city: current.city === '' && incoming.city ? incoming.city : current.city,
+        state: current.state === '' && incoming.state ? incoming.state : current.state,
+        country: current.country === 'US' && incoming.country ? incoming.country : current.country,
+        postalCode: current.postalCode === '' && incoming.postalCode ? incoming.postalCode : current.postalCode,
+    };
+}

package/lib/ui/screens/onboarding/onboardingSelectors.d.ts

@@ -0,0 +1,25 @@
+import type { OnboardingCapability } from '../../../types';
+import type { OnboardingAch, OnboardingAddress, OnboardingState, OnboardingStep, OnboardingSubStep } from './onboardingReducer';
+export declare function computeFlow(capabilities: ReadonlyArray<OnboardingCapability>): ReadonlyArray<OnboardingStep>;
+export interface FlowEntry {
+    step: OnboardingStep;
+    subStep: OnboardingSubStep | null;
+}
+export declare function entrySubStep(step: OnboardingStep, capabilities: ReadonlyArray<OnboardingCapability>): OnboardingSubStep | null;
+export declare function nextStep(state: OnboardingState): OnboardingStep | null;
+export declare function previousStep(state: OnboardingState): OnboardingStep | null;
+export declare function validatePhoneAuth(state: OnboardingState): Record<string, string>;
+export declare function requiresDobInPhoneAuth(capabilities: ReadonlyArray<OnboardingCapability>): boolean;
+export declare function requiresTosInPhoneAuth(capabilities: ReadonlyArray<OnboardingCapability>): boolean;
+export declare function validateOtp(state: OnboardingState): Record<string, string>;
+export declare function validateCustomerInformation(state: OnboardingState): Record<string, string>;
+export declare function validateAddress(address: OnboardingAddress, required: boolean): Record<string, string>;
+export declare function validateAch(ach: OnboardingAch, address: OnboardingAddress): Record<string, string>;
+export declare function isCustomerInformationValid(state: OnboardingState): boolean;
+export declare function isPhoneAuthValid(state: OnboardingState): boolean;
+export declare function isOtpValid(state: OnboardingState): boolean;
+export declare function isAchValid(state: OnboardingState): boolean;
+export declare function isCardSubmittable(state: OnboardingState): boolean;
+export declare function areDocsComplete(state: OnboardingState): boolean;
+export declare function isCapabilitySatisfied(capability: OnboardingCapability, state: OnboardingState): boolean;
+//# sourceMappingURL=onboardingSelectors.d.ts.map

package/lib/ui/screens/onboarding/onboardingSelectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboardingSelectors.d.ts","sourceRoot":"","sources":["../../../../src/ui/screens/onboarding/onboardingSelectors.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,iBAAiB,EAElB,MAAM,qBAAqB,CAAC;AAiC7B,wBAAgB,WAAW,CACzB,YAAY,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAChD,aAAa,CAAC,cAAc,CAAC,CAoB/B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACnC;AAGD,wBAAgB,YAAY,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,iBAAiB,GAAG,IAAI,CAe9H;AAoBD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,GAAG,IAAI,CAItE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,cAAc,GAAG,IAAI,CAI1E;AAOD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiBhF;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAEjG;AAED,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,aAAa,CAAC,oBAAoB,CAAC,GAAG,OAAO,CAEjG;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO1E;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyB1F;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4BrG;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgBlG;AAMD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE1E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEhE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE1D;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE1D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAOjE;AAID,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAM/D;AAID,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,oBAAoB,EAChC,KAAK,EAAE,eAAe,GACrB,OAAO,CAeT"}