import { useEffect } from 'react'; import { RaRecord } from '../types'; import { useCanAccess, UseCanAccessOptions, UseCanAccessResult, } from './useCanAccess'; import { useBasename, useNavigate } from '../routing'; /** * A hook that calls the authProvider.canAccess() method for a provided resource and action (and optionally a record). * It redirects to the /access-denied page if the user doesn't have the required permissions. * It redirects to the /authentication-error page if the authProvider.canAccess throws an error. * * The return value updates according to the request state: * * - start: { isPending: true } * - success: { isPending: false } * - error: { error: [error from provider], isPending: false } * * Useful to enable or disable features based on users permissions. * * @param {Object} params Any params you want to pass to the authProvider * @param {string} params.resource The resource to check access for * @param {string} params.action The action to check access for * @param {Object} params.record Optional. The record to check access for * * @returns Return the react-query result. * * @example * import { useRequireAccess } from 'react-admin'; * * const PostDetail = () => { * const { isPending } = useRequireAccess({ * resource: 'posts', * action: 'read', * }); * if (isPending) { * return null; * } * * return ; * }; */ export const useRequireAccess = < RecordType extends RaRecord | Omit = RaRecord, ErrorType extends Error = Error, >( params: UseRequireAccessOptions ) => { const { canAccess, data, error, ...rest } = useCanAccess(params); const navigate = useNavigate(); const basename = useBasename(); useEffect(() => { if (rest.isPending) return; if (canAccess === false) { navigate(`${basename}/access-denied`); } }, [basename, canAccess, navigate, rest.isPending]); useEffect(() => { if (error) { navigate(`${basename}/authentication-error`); } }, [basename, navigate, error]); return rest; }; export type UseRequireAccessOptions< RecordType extends RaRecord | Omit = RaRecord, ErrorType extends Error = Error, > = UseCanAccessOptions; export type UseRequireAccessResult = Omit< UseCanAccessResult, 'canAccess' | 'data' >;