refactor: add cron job core package (#704)

* refactor: add cron job core package

* docs: add comments to cron validation types

* chore(deps): move node-cron dependencies from tasks app to cron-jobs-core package

* fix: runOnInit is not running on start and rather on job creation

* fix: format issues

* fix: build fails when using top level await in cjs

* chore: update turbo gen package json typescript version to 5.5.2

* fix: format issue

* fix: deepsource issues

* chore: update turbo gen package json eslint version to 9.5.0

* chore: fix frozen lockfile and format

packages/cron-jobs-core/src/group.ts

@@ -0,0 +1,64 @@
+import { objectEntries } from "@homarr/common";
+
+import type { JobCallback } from "./creator";
+import type { Logger } from "./logger";
+import { jobRegistry } from "./registry";
+
+type Jobs<TAllowedNames extends string> = {
+  [name in TAllowedNames]: ReturnType<JobCallback<TAllowedNames, name>>;
+};
+
+export interface CreateCronJobGroupCreatorOptions {
+  logger: Logger;
+}
+
+export const createJobGroupCreator = <TAllowedNames extends string = string>(
+  options: CreateCronJobGroupCreatorOptions,
+) => {
+  return <TJobs extends Jobs<TAllowedNames>>(jobs: TJobs) => {
+    options.logger.logDebug(`Creating job group with ${Object.keys(jobs).length} jobs.`);
+    for (const [key, job] of objectEntries(jobs)) {
+      if (typeof key !== "string" || typeof job.name !== "string") continue;
+
+      options.logger.logDebug(`Added job ${job.name} to the job registry.`);
+      jobRegistry.set(key, {
+        ...job,
+        name: job.name,
+      });
+    }
+
+    return {
+      startAsync: async (name: keyof TJobs) => {
+        const job = jobRegistry.get(name as string);
+        if (!job) return;
+
+        options.logger.logInfo(`Starting schedule cron job ${job.name}.`);
+        await job.onStartAsync();
+        job.scheduledTask.start();
+      },
+      startAllAsync: async () => {
+        for (const job of jobRegistry.values()) {
+          options.logger.logInfo(`Starting schedule of cron job ${job.name}.`);
+          await job.onStartAsync();
+          job.scheduledTask.start();
+        }
+      },
+      stop: (name: keyof TJobs) => {
+        const job = jobRegistry.get(name as string);
+        if (!job) return;
+
+        options.logger.logInfo(`Stopping schedule cron job ${job.name}.`);
+        job.scheduledTask.stop();
+      },
+      stopAll: () => {
+        for (const job of jobRegistry.values()) {
+          options.logger.logInfo(`Stopping schedule cron job ${job.name}.`);
+          job.scheduledTask.stop();
+        }
+      },
+      getJobRegistry() {
+        return jobRegistry as Map<TAllowedNames, ReturnType<JobCallback<TAllowedNames, TAllowedNames>>>;
+      },
+    };
+  };
+};