feat(jobs): show current job frequency in edit modal (#3008)

* fix(jobs): reset job schedule edit modal values when closed * feat(jobs): show job's current frequency * fix(jobs): reset job schedule edit modal values when cancelled * chore: rebase * refactor(jobs): use reducer instead of several react states * fix(jobs): reset modal state when opening instead of closing the modal This prevents the modal state from glitching when saving/closing the modal * feat(jobs): parse job schedule cron string unavailable locale will fallback to english
2025-09-17 17:24:35 +02:00 · 2022-09-12 05:14:27 +04:00
parent 611ceeb5f4
commit 99fc9a2da0
6 changed files with 114 additions and 27 deletions
--- a/package.json
+++ b/package.json
@@ -47,6 +47,7 @@
    "cookie-parser": "1.4.6",
    "copy-to-clipboard": "3.3.2",
    "country-flag-icons": "1.5.5",
+    "cronstrue": "^2.11.0",
    "csurf": "1.11.0",
    "date-fns": "2.29.1",
    "email-templates": "9.0.0",
--- a/server/job/schedule.ts
+++ b/server/job/schedule.ts
@@ -14,6 +14,7 @@ interface ScheduledJob {
  name: string;
  type: 'process' | 'command';
  interval: 'short' | 'long' | 'fixed';
+  cronSchedule: string;
  running?: () => boolean;
  cancelFn?: () => void;
 }
@@ -29,6 +30,7 @@ export const startJobs = (): void => {
    name: 'Plex Recently Added Scan',
    type: 'process',
    interval: 'short',
+    cronSchedule: jobs['plex-recently-added-scan'].schedule,
    job: schedule.scheduleJob(jobs['plex-recently-added-scan'].schedule, () => {
      logger.info('Starting scheduled job: Plex Recently Added Scan', {
        label: 'Jobs',
@@ -45,6 +47,7 @@ export const startJobs = (): void => {
    name: 'Plex Full Library Scan',
    type: 'process',
    interval: 'long',
+    cronSchedule: jobs['plex-full-scan'].schedule,
    job: schedule.scheduleJob(jobs['plex-full-scan'].schedule, () => {
      logger.info('Starting scheduled job: Plex Full Library Scan', {
        label: 'Jobs',
@@ -61,6 +64,7 @@ export const startJobs = (): void => {
    name: 'Plex Watchlist Sync',
    type: 'process',
    interval: 'long',
+    cronSchedule: jobs['plex-watchlist-sync'].schedule,
    job: schedule.scheduleJob(jobs['plex-watchlist-sync'].schedule, () => {
      logger.info('Starting scheduled job: Plex Watchlist Sync', {
        label: 'Jobs',
@@ -75,6 +79,7 @@ export const startJobs = (): void => {
    name: 'Radarr Scan',
    type: 'process',
    interval: 'long',
+    cronSchedule: jobs['radarr-scan'].schedule,
    job: schedule.scheduleJob(jobs['radarr-scan'].schedule, () => {
      logger.info('Starting scheduled job: Radarr Scan', { label: 'Jobs' });
      radarrScanner.run();
@@ -89,6 +94,7 @@ export const startJobs = (): void => {
    name: 'Sonarr Scan',
    type: 'process',
    interval: 'long',
+    cronSchedule: jobs['sonarr-scan'].schedule,
    job: schedule.scheduleJob(jobs['sonarr-scan'].schedule, () => {
      logger.info('Starting scheduled job: Sonarr Scan', { label: 'Jobs' });
      sonarrScanner.run();
@@ -103,6 +109,7 @@ export const startJobs = (): void => {
    name: 'Download Sync',
    type: 'command',
    interval: 'fixed',
+    cronSchedule: jobs['download-sync'].schedule,
    job: schedule.scheduleJob(jobs['download-sync'].schedule, () => {
      logger.debug('Starting scheduled job: Download Sync', {
        label: 'Jobs',
@@ -117,6 +124,7 @@ export const startJobs = (): void => {
    name: 'Download Sync Reset',
    type: 'command',
    interval: 'long',
+    cronSchedule: jobs['download-sync-reset'].schedule,
    job: schedule.scheduleJob(jobs['download-sync-reset'].schedule, () => {
      logger.info('Starting scheduled job: Download Sync Reset', {
        label: 'Jobs',
--- a/server/routes/settings/index.ts
+++ b/server/routes/settings/index.ts
@@ -433,6 +433,7 @@ settingsRoutes.get('/jobs', (_req, res) => {
      name: job.name,
      type: job.type,
      interval: job.interval,
+      cronSchedule: job.cronSchedule,
      nextExecutionTime: job.job.nextInvocation(),
      running: job.running ? job.running() : false,
    }))
@@ -453,6 +454,7 @@ settingsRoutes.post<{ jobId: string }>('/jobs/:jobId/run', (req, res, next) => {
    name: scheduledJob.name,
    type: scheduledJob.type,
    interval: scheduledJob.interval,
+    cronSchedule: scheduledJob.cronSchedule,
    nextExecutionTime: scheduledJob.job.nextInvocation(),
    running: scheduledJob.running ? scheduledJob.running() : false,
  });
@@ -478,6 +480,7 @@ settingsRoutes.post<{ jobId: string }>(
      name: scheduledJob.name,
      type: scheduledJob.type,
      interval: scheduledJob.interval,
+      cronSchedule: scheduledJob.cronSchedule,
      nextExecutionTime: scheduledJob.job.nextInvocation(),
      running: scheduledJob.running ? scheduledJob.running() : false,
    });
@@ -502,11 +505,14 @@ settingsRoutes.post<{ jobId: string }>(
      settings.jobs[scheduledJob.id].schedule = req.body.schedule;
      settings.save();

+      scheduledJob.cronSchedule = req.body.schedule;
+
      return res.status(200).json({
        id: scheduledJob.id,
        name: scheduledJob.name,
        type: scheduledJob.type,
        interval: scheduledJob.interval,
+        cronSchedule: scheduledJob.cronSchedule,
        nextExecutionTime: scheduledJob.job.nextInvocation(),
        running: scheduledJob.running ? scheduledJob.running() : false,
      });
--- a/src/components/Settings/SettingsJobsCache/index.tsx
+++ b/src/components/Settings/SettingsJobsCache/index.tsx
@@ -5,6 +5,7 @@ import LoadingSpinner from '@app/components/Common/LoadingSpinner';
 import Modal from '@app/components/Common/Modal';
 import PageTitle from '@app/components/Common/PageTitle';
 import Table from '@app/components/Common/Table';
+import useLocale from '@app/hooks/useLocale';
 import globalMessages from '@app/i18n/globalMessages';
 import { formatBytes } from '@app/utils/numberHelpers';
 import { Transition } from '@headlessui/react';
@@ -13,7 +14,8 @@ import { PencilIcon } from '@heroicons/react/solid';
 import type { CacheItem } from '@server/interfaces/api/settingsInterfaces';
 import type { JobId } from '@server/lib/settings';
 import axios from 'axios';
-import { Fragment, useState } from 'react';
+import cronstrue from 'cronstrue/i18n';
+import { Fragment, useReducer, useState } from 'react';
 import type { MessageDescriptor } from 'react-intl';
 import { defineMessages, FormattedRelativeTime, useIntl } from 'react-intl';
 import { useToasts } from 'react-toast-notifications';
@@ -55,7 +57,8 @@ const messages: { [messageName: string]: MessageDescriptor } = defineMessages({
  editJobSchedule: 'Modify Job',
  jobScheduleEditSaved: 'Job edited successfully!',
  jobScheduleEditFailed: 'Something went wrong while saving the job.',
-  editJobSchedulePrompt: 'Frequency',
+  editJobScheduleCurrent: 'Current Frequency',
+  editJobSchedulePrompt: 'New Frequency',
  editJobScheduleSelectorHours:
    'Every {jobScheduleHours, plural, one {hour} other {{jobScheduleHours} hours}}',
  editJobScheduleSelectorMinutes:
@@ -67,12 +70,56 @@ interface Job {
  name: string;
  type: 'process' | 'command';
  interval: 'short' | 'long' | 'fixed';
+  cronSchedule: string;
  nextExecutionTime: string;
  running: boolean;
 }

+type JobModalState = {
+  isOpen?: boolean;
+  job?: Job;
+  scheduleHours: number;
+  scheduleMinutes: number;
+};
+
+type JobModalAction =
+  | { type: 'set'; hours?: number; minutes?: number }
+  | {
+      type: 'close';
+    }
+  | { type: 'open'; job?: Job };
+
+const jobModalReducer = (
+  state: JobModalState,
+  action: JobModalAction
+): JobModalState => {
+  switch (action.type) {
+    case 'close':
+      return {
+        ...state,
+        isOpen: false,
+      };
+
+    case 'open':
+      return {
+        isOpen: true,
+        job: action.job,
+        scheduleHours: 1,
+        scheduleMinutes: 5,
+      };
+
+    case 'set':
+      return {
+        ...state,
+        scheduleHours: action.hours ?? state.scheduleHours,
+        scheduleMinutes: action.minutes ?? state.scheduleMinutes,
+      };
+  }
+};
+
 const SettingsJobs = () => {
  const intl = useIntl();
+  const { locale } = useLocale();
  const { addToast } = useToasts();
  const {
    data,
@@ -88,15 +135,12 @@ const SettingsJobs = () => {
    }
  );

-  const [jobEditModal, setJobEditModal] = useState<{
-    isOpen: boolean;
-    job?: Job;
-  }>({
+  const [jobModalState, dispatch] = useReducer(jobModalReducer, {
    isOpen: false,
+    scheduleHours: 1,
+    scheduleMinutes: 5,
  });
  const [isSaving, setIsSaving] = useState(false);
-  const [jobScheduleMinutes, setJobScheduleMinutes] = useState(5);
-  const [jobScheduleHours, setJobScheduleHours] = useState(1);

  if (!data && !error) {
    return <LoadingSpinner />;
@@ -146,10 +190,10 @@ const SettingsJobs = () => {
    const jobScheduleCron = ['0', '0', '*', '*', '*', '*'];

    try {
-      if (jobEditModal.job?.interval === 'short') {
-        jobScheduleCron[1] = `*/${jobScheduleMinutes}`;
-      } else if (jobEditModal.job?.interval === 'long') {
-        jobScheduleCron[2] = `*/${jobScheduleHours}`;
+      if (jobModalState.job?.interval === 'short') {
+        jobScheduleCron[1] = `*/${jobModalState.scheduleMinutes}`;
+      } else if (jobModalState.job?.interval === 'long') {
+        jobScheduleCron[2] = `*/${jobModalState.scheduleHours}`;
      } else {
        // jobs with interval: fixed should not be editable
        throw new Error();
@@ -157,16 +201,18 @@ const SettingsJobs = () => {

      setIsSaving(true);
      await axios.post(
-        `/api/v1/settings/jobs/${jobEditModal.job?.id}/schedule`,
+        `/api/v1/settings/jobs/${jobModalState.job.id}/schedule`,
        {
          schedule: jobScheduleCron.join(' '),
        }
      );
+
      addToast(intl.formatMessage(messages.jobScheduleEditSaved), {
        appearance: 'success',
        autoDismiss: true,
      });
-      setJobEditModal({ isOpen: false });
+
+      dispatch({ type: 'close' });
      revalidate();
    } catch (e) {
      addToast(intl.formatMessage(messages.jobScheduleEditFailed), {
@@ -194,7 +240,7 @@ const SettingsJobs = () => {
        leave="opacity-100 transition duration-300"
        leaveFrom="opacity-100"
        leaveTo="opacity-0"
-        show={jobEditModal.isOpen}
+        show={jobModalState.isOpen}
      >
        <Modal
          title={intl.formatMessage(messages.editJobSchedule)}
@@ -203,24 +249,43 @@ const SettingsJobs = () => {
              ? intl.formatMessage(globalMessages.saving)
              : intl.formatMessage(globalMessages.save)
          }
-          onCancel={() => setJobEditModal({ isOpen: false })}
+          onCancel={() => dispatch({ type: 'close' })}
          okDisabled={isSaving}
          onOk={() => scheduleJob()}
        >
          <div className="section">
-            <form>
-              <div className="form-row pb-6">
+            <form className="mb-6">
+              <div className="form-row">
+                <label className="text-label">
+                  {intl.formatMessage(messages.editJobScheduleCurrent)}
+                </label>
+                <div className="form-input-area mt-2 mb-1">
+                  <div>
+                    {jobModalState.job &&
+                      cronstrue.toString(jobModalState.job.cronSchedule, {
+                        locale,
+                      })}
+                  </div>
+                  <div className="text-sm text-gray-500">
+                    {jobModalState.job?.cronSchedule}
+                  </div>
+                </div>
+              </div>
+              <div className="form-row">
                <label htmlFor="jobSchedule" className="text-label">
                  {intl.formatMessage(messages.editJobSchedulePrompt)}
                </label>
                <div className="form-input-area">
-                  {jobEditModal.job?.interval === 'short' ? (
+                  {jobModalState.job?.interval === 'short' ? (
                    <select
                      name="jobScheduleMinutes"
                      className="inline"
-                      value={jobScheduleMinutes}
+                      value={jobModalState.scheduleMinutes}
                      onChange={(e) =>
-                        setJobScheduleMinutes(Number(e.target.value))
+                        dispatch({
+                          type: 'set',
+                          minutes: Number(e.target.value),
+                        })
                      }
                    >
                      {[5, 10, 15, 20, 30, 60].map((v) => (
@@ -238,9 +303,12 @@ const SettingsJobs = () => {
                    <select
                      name="jobScheduleHours"
                      className="inline"
-                      value={jobScheduleHours}
+                      value={jobModalState.scheduleHours}
                      onChange={(e) =>
-                        setJobScheduleHours(Number(e.target.value))
+                        dispatch({
+                          type: 'set',
+                          hours: Number(e.target.value),
+                        })
                      }
                    >
                      {[1, 2, 3, 4, 6, 8, 12, 24, 48, 72].map((v) => (
@@ -319,9 +387,7 @@ const SettingsJobs = () => {
                    <Button
                      className="mr-2"
                      buttonType="warning"
-                      onClick={() =>
-                        setJobEditModal({ isOpen: true, job: job })
-                      }
+                      onClick={() => dispatch({ type: 'open', job })}
                    >
                      <PencilIcon />
                      <span>{intl.formatMessage(globalMessages.edit)}</span>
--- a/src/i18n/locale/en.json
+++ b/src/i18n/locale/en.json
@@ -639,7 +639,8 @@
  "components.Settings.SettingsJobsCache.download-sync": "Download Sync",
  "components.Settings.SettingsJobsCache.download-sync-reset": "Download Sync Reset",
  "components.Settings.SettingsJobsCache.editJobSchedule": "Modify Job",
-  "components.Settings.SettingsJobsCache.editJobSchedulePrompt": "Frequency",
+  "components.Settings.SettingsJobsCache.editJobScheduleCurrent": "Current Frequency",
+  "components.Settings.SettingsJobsCache.editJobSchedulePrompt": "New Frequency",
  "components.Settings.SettingsJobsCache.editJobScheduleSelectorHours": "Every {jobScheduleHours, plural, one {hour} other {{jobScheduleHours} hours}}",
  "components.Settings.SettingsJobsCache.editJobScheduleSelectorMinutes": "Every {jobScheduleMinutes, plural, one {minute} other {{jobScheduleMinutes} minutes}}",
  "components.Settings.SettingsJobsCache.flushcache": "Flush Cache",
--- a/yarn.lock
+++ b/yarn.lock
@@ -4847,6 +4847,11 @@ cron-parser@^3.5.0:
    is-nan "^1.3.2"
    luxon "^1.26.0"

+cronstrue@^2.11.0:
+  version "2.11.0"
+  resolved "https://registry.yarnpkg.com/cronstrue/-/cronstrue-2.11.0.tgz#18ff1b95a836b9b4e06854f796db2dc8fa98ce41"
+  integrity sha512-iIBCSis5yqtFYWtJAmNOiwDveFWWIn+8uV5UYuPHYu/Aeu5CSSJepSbaHMyfc+pPFgnsCcGzfPQEo7LSGmWbTg==
+
 cross-spawn@^7.0.0, cross-spawn@^7.0.2, cross-spawn@^7.0.3:
  version "7.0.3"
  resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-7.0.3.tgz#f73a85b9d5d41d045551c177e2882d4ac85728a6"