// Copyright (c) 2015-present Mattermost, Inc. All Rights Reserved. // See LICENSE.txt for license information. import React, {useCallback, useEffect, useMemo, useReducer, useRef, useState} from 'react'; import {useIntl} from 'react-intl'; import {Keyboard, ScrollView, View} from 'react-native'; import {SafeAreaView} from 'react-native-safe-area-context'; import {handleGotoLocation} from '@actions/remote/command'; import Button from '@components/button'; import CompassIcon from '@components/compass_icon'; import Markdown from '@components/markdown'; import {Screens} from '@constants'; import {AppCallResponseTypes} from '@constants/apps'; import {useServerUrl} from '@context/server'; import {useTheme} from '@context/theme'; import useDidUpdate from '@hooks/did_update'; import useNavButtonPressed from '@hooks/navigation_button_pressed'; import SecurityManager from '@managers/security_manager'; import {filterEmptyOptions} from '@utils/apps'; import {mapAppFieldTypeToDialogType, getDataSourceForAppFieldType} from '@utils/dialog_utils'; import {checkDialogElementForError, checkIfErrorsMatchElements} from '@utils/integrations'; import {logWarning} from '@utils/log'; import {changeOpacity, makeStyleSheetFromTheme} from '@utils/theme'; import {secureGetFromRecord} from '@utils/types'; import DialogIntroductionText from '../interactive_dialog/dialog_introduction_text'; import {buildNavigationButton, dismissModal, setButtons} from '../navigation'; import AppsFormField from './apps_form_field'; import type {AvailableScreens} from '@typings/screens/navigation'; import type {ImageResource} from 'react-native-navigation'; const getStyleFromTheme = makeStyleSheetFromTheme((theme: Theme) => { return { container: { backgroundColor: changeOpacity(theme.centerChannelColor, 0.03), height: '100%', }, errorContainer: { marginTop: 15, marginLeft: 15, fontSize: 14, fontWeight: 'bold', }, scrollView: { marginBottom: 20, marginTop: 10, }, errorLabel: { fontSize: 12, textAlign: 'left', color: (theme.errorTextColor || '#DA4A4A'), }, buttonContainer: { paddingTop: 20, paddingLeft: 50, paddingRight: 50, }, buttonsWrapper: { marginHorizontal: 5, }, }; }); function fieldsAsElements(fields?: AppField[]): DialogElement[] { return fields?.filter((f) => Boolean(f.name)).map((f) => { return { name: f.name, type: mapAppFieldTypeToDialogType(f.type || 'text'), subtype: f.subtype, optional: !f.is_required, min_length: f.min_length, max_length: f.max_length, data_source: getDataSourceForAppFieldType(f.type || 'text'), options: f.options?.map((option) => ({ text: option.label || '', value: option.value || '', })), } as DialogElement; }) || []; } const close = () => { Keyboard.dismiss(); dismissModal(); }; const makeCloseButton = (icon: ImageResource) => { return buildNavigationButton(CLOSE_BUTTON_ID, 'close.more_direct_messages.button', icon); }; export type Props = { form: AppForm; componentId: AvailableScreens; refreshOnSelect: (field: AppField, values: AppFormValues, value: AppFormValue) => Promise>; submit: (values: AppFormValues) => Promise>; performLookupCall: (field: AppField, values: AppFormValues, value: AppFormValue) => Promise>; } type Errors = {[name: string]: string} const emptyErrorsState: Errors = {}; type ValuesAction = {name: string; value: AppFormValue} | {elements?: AppField[]} function valuesReducer(state: AppFormValues, action: ValuesAction) { if (!('name' in action)) { return initValues(action.elements); } if (state[action.name] === action.value) { return state; } return {...state, [action.name]: action.value}; } function initValues(fields?: AppField[]) { const values: AppFormValues = {}; fields?.forEach((field) => { if (!field.name) { return; } if (field.type === 'bool') { // For boolean fields, use explicit value or default to false values[field.name] = field.value === true || String(field.value).toLowerCase() === 'true'; } else if (field.value !== undefined && field.value !== null) { // Use provided value for non-boolean fields values[field.name] = field.value; } else { // Initialize empty fields with empty string values[field.name] = ''; } }); return values; } const CLOSE_BUTTON_ID = 'close-app-form'; const SUBMIT_BUTTON_ID = 'submit-app-form'; function AppsFormComponent({ form, componentId, refreshOnSelect, submit, performLookupCall, }: Props) { const scrollView = useRef(null); const isMountedRef = useRef(true); const [submitting, setSubmitting] = useState(false); const intl = useIntl(); const serverUrl = useServerUrl(); const [error, setError] = useState(''); const [errors, setErrors] = useState(emptyErrorsState); const [values, dispatchValues] = useReducer(valuesReducer, form.fields, initValues); const theme = useTheme(); const style = getStyleFromTheme(theme); useDidUpdate(() => { dispatchValues({elements: form.fields}); }, [form]); const submitButtons = useMemo(() => { return form.fields && form.fields.find((f) => f.name === form.submit_buttons); }, [form]); const rightButton = useMemo(() => { if (submitButtons) { return undefined; } return { ...buildNavigationButton( SUBMIT_BUTTON_ID, 'interactive_dialog.submit.button', undefined, intl.formatMessage({id: 'interactive_dialog.submit', defaultMessage: 'Submit'}), ), enabled: !submitting, showAsAction: 'always' as const, color: theme.sidebarHeaderTextColor, }; }, [theme.sidebarHeaderTextColor, submitButtons, submitting, intl]); const rightButtons = useMemo(() => (rightButton ? [rightButton] : []), [rightButton]); const leftButton = useMemo(() => { const icon = CompassIcon.getImageSourceSync('close', 24, theme.sidebarHeaderTextColor); return makeCloseButton(icon); }, [theme.sidebarHeaderTextColor]); const leftButtons = useMemo(() => [leftButton], [leftButton]); useEffect(() => { setButtons(componentId, { rightButtons, }); }, [componentId, rightButtons]); useEffect(() => { setButtons(componentId, { leftButtons, }); }, [componentId, leftButtons]); const updateErrors = useCallback((elements: DialogElement[], fieldErrors?: {[x: string]: string}, formError?: string): boolean => { let hasErrors = false; let hasHeaderError = false; if (formError) { hasErrors = true; hasHeaderError = true; setError(formError); } else { setError(''); } if (fieldErrors && Object.keys(fieldErrors).length > 0) { hasErrors = true; if (checkIfErrorsMatchElements(fieldErrors, elements)) { setErrors(fieldErrors); } else if (!hasHeaderError) { hasHeaderError = true; // Don't expose field names or error details to prevent form structure enumeration setError(intl.formatMessage({ id: 'apps.error.responses.unknown_field_error', defaultMessage: 'An error occurred with a form field. Please contact the app developer.', })); } } if (hasErrors) { if (hasHeaderError && scrollView.current) { scrollView.current.scrollTo({x: 0, y: 0}); } } return hasErrors; }, [intl]); const onChange = useCallback((name: string, value: AppFormValue) => { const field = form.fields?.find((f) => f.name === name); if (!field) { return; } const newValues = {...values, [name]: value}; if (field.refresh) { refreshOnSelect(field, newValues, value).then((res) => { // Check if component is still mounted before updating state if (!isMountedRef.current) { return; } if (res.error) { const errorResponse = res.error; const errorMsg = errorResponse.text; const newErrors = errorResponse.data?.errors; const elements = fieldsAsElements(form.fields); updateErrors(elements, newErrors, errorMsg); return; } const callResponse = res.data!; switch (callResponse.type) { case AppCallResponseTypes.FORM: return; case AppCallResponseTypes.OK: case AppCallResponseTypes.NAVIGATE: updateErrors([], undefined, intl.formatMessage({ id: 'apps.error.responses.unexpected_type', defaultMessage: 'App response type was not expected. Response type: {type}', }, { type: callResponse.type, })); return; default: updateErrors([], undefined, intl.formatMessage({ id: 'apps.error.responses.unknown_type', defaultMessage: 'App response type not supported. Response type: {type}.', }, { type: callResponse.type, })); } }).catch((err) => { // Handle promise rejection gracefully if (isMountedRef.current) { logWarning('RefreshOnSelect failed:', err); } }); } dispatchValues({name, value}); }, [form, values, refreshOnSelect, updateErrors, intl]); // Memoize elements conversion for performance const elements = useMemo(() => fieldsAsElements(form.fields), [form.fields]); // Memoize filtered fields to avoid recalculation on every render const visibleFields = useMemo(() => form.fields?.filter((f) => f.name !== form.submit_buttons) || [], [form.fields, form.submit_buttons], ); const handleSubmit = useCallback(async (button?: string) => { if (submitting) { return; } const fieldErrors: {[name: string]: string} = {}; let hasErrors = false; elements?.forEach((element) => { const newError = checkDialogElementForError( element, element.name === form.submit_buttons ? button : secureGetFromRecord(values, element.name), ); if (newError) { hasErrors = true; fieldErrors[element.name] = intl.formatMessage({id: newError.id, defaultMessage: newError.defaultMessage}, newError.values); } }); if (hasErrors) { setErrors(fieldErrors); return; } const submission = {...values}; if (button && form.submit_buttons) { submission[form.submit_buttons] = button; } setSubmitting(true); const res = await submit(submission); // Check if component is still mounted before updating state if (!isMountedRef.current) { return; } if (res.error) { const errorResponse = res.error; const errorMessage = errorResponse.text; hasErrors = updateErrors(elements, errorResponse.data?.errors, errorMessage); if (!hasErrors) { close(); return; } setSubmitting(false); return; } setError(''); setErrors(emptyErrorsState); const callResponse = res.data!; switch (callResponse.type) { case AppCallResponseTypes.OK: close(); return; case AppCallResponseTypes.NAVIGATE: close(); handleGotoLocation(serverUrl, intl, callResponse.navigate_to_url!); return; case AppCallResponseTypes.FORM: setSubmitting(false); return; default: updateErrors([], undefined, intl.formatMessage({ id: 'apps.error.responses.unknown_type', defaultMessage: 'App response type not supported. Response type: {type}.', }, { type: callResponse.type, })); setSubmitting(false); } }, [elements, form, values, submit, submitting, updateErrors, serverUrl, intl]); const performLookup = useCallback(async (name: string, userInput: string): Promise => { const field = form.fields?.find((f) => f.name === name); if (!field?.name) { return []; } const res = await performLookupCall(field, values, userInput); // Check if component is still mounted before updating state if (!isMountedRef.current) { return []; } if (res.error) { const errorResponse = res.error; const errMsg = errorResponse.text || intl.formatMessage({ id: 'apps.error.unknown', defaultMessage: 'Unknown error occurred.', }); setErrors({[field.name]: errMsg}); return []; } const callResp = res.data!; switch (callResp.type) { case AppCallResponseTypes.OK: { let items = callResp.data?.items || []; items = items.filter(filterEmptyOptions); return items; } case AppCallResponseTypes.FORM: case AppCallResponseTypes.NAVIGATE: { const errMsg = intl.formatMessage({ id: 'apps.error.responses.unexpected_type', defaultMessage: 'App response type was not expected. Response type: {type}', }, { type: callResp.type, }, ); setErrors({[field.name]: errMsg}); return []; } default: { const errMsg = intl.formatMessage({ id: 'apps.error.responses.unknown_type', defaultMessage: 'App response type not supported. Response type: {type}.', }, { type: callResp.type, }, ); setErrors({[field.name]: errMsg}); return []; } } }, [form, values, performLookupCall, intl]); useNavButtonPressed(CLOSE_BUTTON_ID, componentId, close, [close]); useNavButtonPressed(SUBMIT_BUTTON_ID, componentId, handleSubmit, [handleSubmit]); // Cleanup on unmount to prevent memory leaks useEffect(() => { return () => { isMountedRef.current = false; }; }, []); return ( {error && ( )} {form.header && } {visibleFields.map((field) => { if (!field.name) { return null; } const value = secureGetFromRecord(values, field.name); return ( ); })} {submitButtons?.options?.map((o) => (