feat(feeds): add force run (#1243)

* feat(feeds): add force run

* fix: simplify ForceRun

* add confirmation modal

* handle errors by using the test func

* require user input to run

* make sure to reschedule next job after forcerun

* refactor modal centering with grid

* refactor: Simplify startJob and forceRun logic

- Refactor `startJob` to accept a `runImmediately` flag. This flag controls whether the job should be run immediately or scheduled for later. This change simplifies the `ForceRun` function by allowing it to call `startJob` with `runImmediately` set to `true`.

- Remove redundant checks in `ForceRun` related to feed type. These checks are handled in `startJob`.

BREAKING CHANGE: The `startJob` function now requires a second argument, `runImmediately`. This change affects all calls to `startJob`.

* fix(web) Invalidate queries after forceRun

* refactor(feeds): init and test run

---------

Co-authored-by: ze0s <43699394+zze0s@users.noreply.github.com>

web/src/screens/settings/Feed.tsx

@@ -12,6 +12,7 @@ import {
   DocumentTextIcon,
   EllipsisHorizontalIcon,
   PencilSquareIcon,
+  ForwardIcon,
   TrashIcon
 } from "@heroicons/react/24/outline";
 
@@ -19,7 +20,7 @@ import { APIClient } from "@api/APIClient";
 import { useToggle } from "@hooks/hooks";
 import { baseUrl, classNames, IsEmptyDate, simplifyDate } from "@utils";
 import Toast from "@components/notifications/Toast";
-import { DeleteModal } from "@components/modals";
+import { DeleteModal, ForceRunModal } from "@components/modals";
 import { FeedUpdateForm } from "@forms/settings/FeedForms";
 import { EmptySimple } from "@components/emptystates";
 import { ImplementationBadges } from "./Indexer";
@@ -230,6 +231,7 @@ const FeedItemDropdown = ({
 
   const [deleteModalIsOpen, toggleDeleteModal] = useToggle(false);
   const [deleteCacheModalIsOpen, toggleDeleteCacheModal] = useToggle(false);
+  const [forceRunModalIsOpen, toggleForceRunModal] = useToggle(false);
 
   const deleteMutation = useMutation({
     mutationFn: (id: number) => APIClient.feeds.delete(id),
@@ -248,6 +250,22 @@ const FeedItemDropdown = ({
     }
   });
 
+  const forceRunMutation = useMutation({
+    mutationFn: (id: number) => APIClient.feeds.forceRun(id),
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: feedKeys.lists() });
+      toast.custom((t) => <Toast type="success" body={`Feed ${feed?.name} was force run successfully.`} t={t} />);
+      toggleForceRunModal(); 
+    },
+    onError: (error: any) => {
+      toast.custom((t) => <Toast type="error" body={`Failed to force run ${feed?.name}. Error: ${error.message}`} t={t} />, {
+        duration: 10000
+      });    
+      toggleForceRunModal(); 
+    }
+  });
+
+
   return (
     <Menu as="div">
       <DeleteModal
@@ -273,6 +291,18 @@ const FeedItemDropdown = ({
         title={`Remove feed cache: ${feed.name}`}
         text="Are you sure you want to remove the feed cache? This action cannot be undone."
       />
+      <ForceRunModal
+        isOpen={forceRunModalIsOpen}
+        isLoading={forceRunMutation.isLoading}
+        toggle={toggleForceRunModal}
+        buttonRef={cancelModalButtonRef}
+        forceRunAction={() => {
+          forceRunMutation.mutate(feed.id);
+          toggleForceRunModal();
+        }}
+        title={`Force run feed: ${feed.name}`}
+        text={`Are you sure you want to force run the ${feed.name} feed? Respecting RSS interval rules is crucial to avoid potential IP bans.`}
+      />
       <Menu.Button className="px-4 py-2">
         <EllipsisHorizontalIcon
           className="w-5 h-5 text-gray-700 hover:text-gray-900 dark:text-gray-100 dark:hover:text-gray-400"
@@ -334,6 +364,26 @@ const FeedItemDropdown = ({
             </Menu.Item>
           </div>
           <div className="px-1 py-1">
+            <Menu.Item>
+              {({ active }) => (
+                <button
+                  onClick={() => toggleForceRunModal()}
+                  className={classNames(
+                    active ? "bg-blue-600 text-white" : "text-gray-900 dark:text-gray-300",
+                    "font-medium group flex rounded-md items-center w-full px-2 py-2 text-sm"
+                  )}
+                >
+                  <ForwardIcon
+                    className={classNames(
+                      active ? "text-white" : "text-blue-500",
+                      "w-5 h-5 mr-2"
+                    )}
+                    aria-hidden="true"
+                  />
+            Force run
+                </button>
+              )}
+            </Menu.Item>
             <Menu.Item>
               <ExternalLink
                 href={`${baseUrl()}api/feeds/${feed.id}/latest`}