feat: add tasks page (#692)

packages/api/src/root.ts

@@ -1,5 +1,6 @@
 import { appRouter as innerAppRouter } from "./router/app";
 import { boardRouter } from "./router/board";
+import { cronJobsRouter } from "./router/cron-jobs";
 import { dockerRouter } from "./router/docker/docker-router";
 import { groupRouter } from "./router/group";
 import { homeRouter } from "./router/home";
@@ -27,6 +28,7 @@ export const appRouter = createTRPCRouter({
   home: homeRouter,
   docker: dockerRouter,
   serverSettings: serverSettingsRouter,
+  cronJobs: cronJobsRouter,
 });
 
 // export type definition of API

packages/api/src/router/cron-jobs.ts

@@ -0,0 +1,34 @@
+import { observable } from "@trpc/server/observable";
+
+import { jobNameSchema, triggerCronJobAsync } from "@homarr/cron-job-runner";
+import type { TaskStatus } from "@homarr/cron-job-status";
+import { createCronJobStatusChannel } from "@homarr/cron-job-status";
+import { jobGroup } from "@homarr/cron-jobs";
+import { logger } from "@homarr/log";
+
+import { createTRPCRouter, publicProcedure } from "../trpc";
+
+export const cronJobsRouter = createTRPCRouter({
+  triggerJob: publicProcedure.input(jobNameSchema).mutation(async ({ input }) => {
+    await triggerCronJobAsync(input);
+  }),
+  getJobs: publicProcedure.query(() => {
+    const registry = jobGroup.getJobRegistry();
+    return [...registry.values()].map((job) => ({
+      name: job.name,
+      expression: job.cronExpression,
+    }));
+  }),
+  subscribeToStatusUpdates: publicProcedure.subscription(() => {
+    return observable<TaskStatus>((emit) => {
+      for (const job of jobGroup.getJobRegistry().values()) {
+        const channel = createCronJobStatusChannel(job.name);
+        channel.subscribe((data) => {
+          emit.next(data);
+        });
+      }
+
+      logger.info("A tRPC client has connected to the cron job status updates procedure");
+    });
+  }),
+});