[RFR] Declare fetch side effects as function

[fzaninotto]

This is totally backwards compatible - delerative side effect objects are still interpreted by the Redux saga.

• Add useNotify, useRedirect, useRefresh, and useUnselectAll hooks
• Update useDataProvider to execute onSuccess and onFailure functions in the context of a hook
• Update List, Show, Edit and Create controllers to use hook side effects instead of object side effects (allows for custom side effects)
• Update DeleteButton to use hook side effects instead of object side effects
• Update documentation

Closes #3413.

This change does not reduce the code in controllers, but makes it more understandable. There are less moving parts, it's more idiomatic to modern React, and it bypasses some of the redux-saga logic.

It allows to customize side effects quite easily, e.g. to display a custom notification message in case of failed HTTP request.

const MyEdit = props => {
   const editControllerProps = useEditController(props);
   const [update, { loading: isSaving }] = useUpdate(
        props.resource,
        props.id,
        {}, // set by the caller
        editControllerProps.record
    );

    const save = useCallback(
        (data: Partial<Record>, redirectTo = 'list') =>
            update(
                null,
                { data },
                {
                    onSuccess: () => {
                        notify(/** custom notification */);
                        redirect(/** custom redirection */);
                    },
                    onFailure: error => {
                        notify(/** custom notification */);
                        redirect(/** custom redirection */);
                    },
                    undoable,
                }
            ),
        [basePath, notify, redirect, undoable, update]
    );
    return <ListView {...props} {...controllerProps} save={save} />
}

This also opens the path for a pure hook-based fetch side effect handling (not using the fetch saga anymore).

[fzaninotto]

Switching to RFR

[djhi]

Shouldn't we update the upgrade guide too ?

[djhi]

We pass props to both the toolbar and the button ?

[djhi]

the result ?

[djhi]

Suggested change

	The `onSuccess` function is called with the response from the `dataProvider` as argument. The `onError` function is called wit hthe error returned by the `dataProvider`.
	The `onSuccess` function is called with the response from the `dataProvider` as argument. The `onError` function is called with the error returned by the `dataProvider`.

[fzaninotto]

I don't think we need to add anything to the upgrade guide, as this adds only backward compatible changes. Any application running before that PR will continue to run after that PR.