@kingsworld/plugin-cron 1.5.2 → 2.0.0-next.179a2eb

package/dist/cjs/lib/structures/CronTaskStore.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
 var pieces = require('@sapphire/pieces');
-var CronTask_cjs = require('./CronTask.cjs');
 var cron = require('cron');
+var CronTask_cjs = require('./CronTask.cjs');
 
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
@@ -10,28 +10,33 @@ var _CronTaskStore = class _CronTaskStore extends pieces.Store {
   constructor() {
     super(CronTask_cjs.CronTask, { name: "cron-tasks" });
   }
+  /**
+   * Loops over all tasks and starts those that are enabled.
+   * This gets called automatically when the Client is ready.
+   * @returns CronTaskStore
+   */
   startAll() {
     for (const task of this.values()) {
       if (!task.enabled) continue;
       task.job.start();
     }
-    pieces.Store.logger?.(
-      `[STORE => ${this.name}] [START] Started all cronjob tasks.`
-    );
+    pieces.Store.logger?.(`[STORE => ${this.name}] [START] Started all cronjob tasks.`);
     return this;
   }
+  /**
+   * Loops over all tasks and stops those that are running.
+   * @returns CronTaskStore
+   */
   stopAll() {
     for (const task of this.values()) {
       if (!task.job.running) continue;
       task.job.stop();
     }
-    pieces.Store.logger?.(
-      `[STORE => ${this.name}] [STOP] Stopped all cronjob tasks.`
-    );
+    pieces.Store.logger?.(`[STORE => ${this.name}] [STOP] Stopped all cronjob tasks.`);
     return this;
   }
   set(key, value) {
-    const options = value.options;
+    const { options } = value;
     const { sentry, defaultTimezone } = this.container.cron;
     const cronJob = sentry ? sentry.cron.instrumentCron(cron.CronJob, key) : cron.CronJob;
     try {
@@ -43,11 +48,8 @@ var _CronTaskStore = class _CronTaskStore extends pieces.Store {
         timeZone: options.timeZone ?? defaultTimezone
       });
     } catch (error) {
-      value.error(
-        "Encountered an error while creating the cron job",
-        error
-      );
-      value.unload();
+      value.error("Encountered an error while creating the cron job", error);
+      void value.unload();
     }
     return super.set(key, value);
   }
@@ -58,6 +60,10 @@ var _CronTaskStore = class _CronTaskStore extends pieces.Store {
     }
     return super.delete(key);
   }
+  /**
+   * Stops all running cron jobs and clears the store.
+   * @returns void
+   */
   clear() {
     this.stopAll();
     return super.clear();

package/dist/cjs/lib/structures/CronTaskStore.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/CronTaskStore.ts"],"names":["Store","CronTask","CronJob"],"mappings":";;;;;;;;AAIO,IAAM,cAAA,GAAN,MAAM,cAAA,SAAsBA,YAA8B,CAAA;AAAA,EAC7D,WAAc,GAAA;AACV,IAAA,KAAA,CAAMC,qBAAU,EAAA,EAAE,IAAM,EAAA,YAAA,EAAc,CAAA,CAAA;AAAA,GAC1C;AAAA,EAEA,QAAW,GAAA;AACP,IAAW,KAAA,MAAA,IAAA,IAAQ,IAAK,CAAA,MAAA,EAAU,EAAA;AAC9B,MAAI,IAAA,CAAC,KAAK,OAAS,EAAA,SAAA;AACnB,MAAA,IAAA,CAAK,IAAI,KAAM,EAAA,CAAA;AAAA,KACnB;AAEA,IAAMD,YAAA,CAAA,MAAA;AAAA,MACF,CAAA,UAAA,EAAa,KAAK,IAAI,CAAA,oCAAA,CAAA;AAAA,KAC1B,CAAA;AACA,IAAO,OAAA,IAAA,CAAA;AAAA,GACX;AAAA,EAEA,OAAU,GAAA;AACN,IAAW,KAAA,MAAA,IAAA,IAAQ,IAAK,CAAA,MAAA,EAAU,EAAA;AAC9B,MAAI,IAAA,CAAC,IAAK,CAAA,GAAA,CAAI,OAAS,EAAA,SAAA;AACvB,MAAA,IAAA,CAAK,IAAI,IAAK,EAAA,CAAA;AAAA,KAClB;AAEA,IAAMA,YAAA,CAAA,MAAA;AAAA,MACF,CAAA,UAAA,EAAa,KAAK,IAAI,CAAA,mCAAA,CAAA;AAAA,KAC1B,CAAA;AACA,IAAO,OAAA,IAAA,CAAA;AAAA,GACX;AAAA,EAES,GAAA,CAAI,KAAa,KAAuB,EAAA;AAC7C,IAAA,MAAM,UAAU,KAAM,CAAA,OAAA,CAAA;AAEtB,IAAA,MAAM,EAAE,MAAA,EAAQ,eAAgB,EAAA,GAAI,KAAK,SAAU,CAAA,IAAA,CAAA;AACnD,IAAA,MAAM,UAAU,MACV,GAAA,MAAA,CAAO,KAAK,cAAe,CAAAE,YAAA,EAAS,GAAG,CACvC,GAAAA,YAAA,CAAA;AAEN,IAAI,IAAA;AACA,MAAM,KAAA,CAAA,GAAA,GAAM,QAAQ,IAAK,CAAA;AAAA,QACrB,GAAG,OAAA;AAAA,QACH,MAAA,+BAAc,KAAK,KAAA,CAAM,IAAI,IAAK,CAAA,KAAK,GAA/B,EAAA,QAAA,CAAA;AAAA,QACR,KAAO,EAAA,KAAA;AAAA,QACP,OAAS,EAAA,KAAA;AAAA,QACT,QAAA,EAAU,QAAQ,QAAY,IAAA,eAAA;AAAA,OACjC,CAAA,CAAA;AAAA,aACI,KAAO,EAAA;AACZ,MAAM,KAAA,CAAA,KAAA;AAAA,QACF,kDAAA;AAAA,QACA,KAAA;AAAA,OACJ,CAAA;AACA,MAAA,KAAA,CAAM,MAAO,EAAA,CAAA;AAAA,KACjB;AAEA,IAAO,OAAA,KAAA,CAAM,GAAI,CAAA,GAAA,EAAK,KAAK,CAAA,CAAA;AAAA,GAC/B;AAAA,EAES,OAAO,GAAa,EAAA;AACzB,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AACzB,IAAI,IAAA,IAAA,EAAM,IAAI,OAAS,EAAA;AACnB,MAAA,IAAA,CAAK,IAAI,IAAK,EAAA,CAAA;AAAA,KAClB;AAEA,IAAO,OAAA,KAAA,CAAM,OAAO,GAAG,CAAA,CAAA;AAAA,GAC3B;AAAA,EAES,KAAQ,GAAA;AACb,IAAA,IAAA,CAAK,OAAQ,EAAA,CAAA;AACb,IAAA,OAAO,MAAM,KAAM,EAAA,CAAA;AAAA,GACvB;AACJ,CAAA,CAAA;AArEiE,MAAA,CAAA,cAAA,EAAA,eAAA,CAAA,CAAA;AAA1D,IAAM,aAAN,GAAA","file":"CronTaskStore.cjs","sourcesContent":["import { Store } from \"@sapphire/pieces\";\nimport { CronTask } from \"./CronTask\";\nimport { CronJob } from \"cron\";\n\nexport class CronTaskStore extends Store<CronTask, \"cron-tasks\"> {\n    constructor() {\n        super(CronTask, { name: \"cron-tasks\" });\n    }\n\n    startAll() {\n        for (const task of this.values()) {\n            if (!task.enabled) continue;\n            task.job.start();\n        }\n\n        Store.logger?.(\n            `[STORE => ${this.name}] [START] Started all cronjob tasks.`,\n        );\n        return this;\n    }\n\n    stopAll() {\n        for (const task of this.values()) {\n            if (!task.job.running) continue;\n            task.job.stop();\n        }\n\n        Store.logger?.(\n            `[STORE => ${this.name}] [STOP] Stopped all cronjob tasks.`,\n        );\n        return this;\n    }\n\n    override set(key: string, value: CronTask): this {\n        const options = value.options;\n\n        const { sentry, defaultTimezone } = this.container.cron;\n        const cronJob = sentry\n            ? sentry.cron.instrumentCron(CronJob, key)\n            : CronJob;\n\n        try {\n            value.job = cronJob.from({\n                ...options,\n                onTick: () => void value.run.bind(value)(),\n                start: false,\n                context: value,\n                timeZone: options.timeZone ?? defaultTimezone,\n            });\n        } catch (error) {\n            value.error(\n                \"Encountered an error while creating the cron job\",\n                error,\n            );\n            value.unload();\n        }\n\n        return super.set(key, value);\n    }\n\n    override delete(key: string) {\n        const task = this.get(key);\n        if (task?.job.running) {\n            task.job.stop();\n        }\n\n        return super.delete(key);\n    }\n\n    override clear() {\n        this.stopAll();\n        return super.clear();\n    }\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/structures/CronTaskStore.ts"],"names":["Store","CronTask","CronJob"],"mappings":";;;;;;;;AAIO,IAAM,cAAA,GAAN,MAAM,cAAA,SAAsBA,YAA8B,CAAA;AAAA,EACzD,WAAc,GAAA;AACpB,IAAA,KAAA,CAAMC,qBAAU,EAAA,EAAE,IAAM,EAAA,YAAA,EAAc,CAAA,CAAA;AAAA,GACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,QAAW,GAAA;AACjB,IAAW,KAAA,MAAA,IAAA,IAAQ,IAAK,CAAA,MAAA,EAAU,EAAA;AACjC,MAAI,IAAA,CAAC,KAAK,OAAS,EAAA,SAAA;AACnB,MAAA,IAAA,CAAK,IAAI,KAAM,EAAA,CAAA;AAAA,KAChB;AAEA,IAAAD,YAAA,CAAM,MAAS,GAAA,CAAA,UAAA,EAAa,IAAK,CAAA,IAAI,CAAsC,oCAAA,CAAA,CAAA,CAAA;AAC3E,IAAO,OAAA,IAAA,CAAA;AAAA,GACR;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,OAAU,GAAA;AAChB,IAAW,KAAA,MAAA,IAAA,IAAQ,IAAK,CAAA,MAAA,EAAU,EAAA;AACjC,MAAI,IAAA,CAAC,IAAK,CAAA,GAAA,CAAI,OAAS,EAAA,SAAA;AACvB,MAAA,IAAA,CAAK,IAAI,IAAK,EAAA,CAAA;AAAA,KACf;AAEA,IAAAA,YAAA,CAAM,MAAS,GAAA,CAAA,UAAA,EAAa,IAAK,CAAA,IAAI,CAAqC,mCAAA,CAAA,CAAA,CAAA;AAC1E,IAAO,OAAA,IAAA,CAAA;AAAA,GACR;AAAA,EAEgB,GAAA,CAAI,KAAa,KAAuB,EAAA;AACvD,IAAM,MAAA,EAAE,SAAY,GAAA,KAAA,CAAA;AAEpB,IAAA,MAAM,EAAE,MAAA,EAAQ,eAAgB,EAAA,GAAI,KAAK,SAAU,CAAA,IAAA,CAAA;AACnD,IAAA,MAAM,UAAU,MAAS,GAAA,MAAA,CAAO,KAAK,cAAe,CAAAE,YAAA,EAAS,GAAG,CAAI,GAAAA,YAAA,CAAA;AAEpE,IAAI,IAAA;AACH,MAAM,KAAA,CAAA,GAAA,GAAM,QAAQ,IAAK,CAAA;AAAA,QACxB,GAAG,OAAA;AAAA,QACH,MAAA,+BAAc,KAAK,KAAA,CAAM,IAAI,IAAK,CAAA,KAAK,GAA/B,EAAA,QAAA,CAAA;AAAA,QACR,KAAO,EAAA,KAAA;AAAA,QACP,OAAS,EAAA,KAAA;AAAA,QACT,QAAA,EAAU,QAAQ,QAAY,IAAA,eAAA;AAAA,OAC9B,CAAA,CAAA;AAAA,aACO,KAAO,EAAA;AACf,MAAM,KAAA,CAAA,KAAA,CAAM,oDAAoD,KAAK,CAAA,CAAA;AACrE,MAAA,KAAK,MAAM,MAAO,EAAA,CAAA;AAAA,KACnB;AAEA,IAAO,OAAA,KAAA,CAAM,GAAI,CAAA,GAAA,EAAK,KAAK,CAAA,CAAA;AAAA,GAC5B;AAAA,EAEgB,OAAO,GAAa,EAAA;AACnC,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AACzB,IAAI,IAAA,IAAA,EAAM,IAAI,OAAS,EAAA;AACtB,MAAA,IAAA,CAAK,IAAI,IAAK,EAAA,CAAA;AAAA,KACf;AAEA,IAAO,OAAA,KAAA,CAAM,OAAO,GAAG,CAAA,CAAA;AAAA,GACxB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMgB,KAAQ,GAAA;AACvB,IAAA,IAAA,CAAK,OAAQ,EAAA,CAAA;AACb,IAAA,OAAO,MAAM,KAAM,EAAA,CAAA;AAAA,GACpB;AACD,CAAA,CAAA;AAzEiE,MAAA,CAAA,cAAA,EAAA,eAAA,CAAA,CAAA;AAA1D,IAAM,aAAN,GAAA","file":"CronTaskStore.cjs","sourcesContent":["import { Store } from '@sapphire/pieces';\nimport { CronJob } from 'cron';\nimport { CronTask } from './CronTask';\n\nexport class CronTaskStore extends Store<CronTask, 'cron-tasks'> {\n\tpublic constructor() {\n\t\tsuper(CronTask, { name: 'cron-tasks' });\n\t}\n\n\t/**\n\t * Loops over all tasks and starts those that are enabled.\n\t * This gets called automatically when the Client is ready.\n\t * @returns CronTaskStore\n\t */\n\tpublic startAll() {\n\t\tfor (const task of this.values()) {\n\t\t\tif (!task.enabled) continue;\n\t\t\ttask.job.start();\n\t\t}\n\n\t\tStore.logger?.(`[STORE => ${this.name}] [START] Started all cronjob tasks.`);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Loops over all tasks and stops those that are running.\n\t * @returns CronTaskStore\n\t */\n\tpublic stopAll() {\n\t\tfor (const task of this.values()) {\n\t\t\tif (!task.job.running) continue;\n\t\t\ttask.job.stop();\n\t\t}\n\n\t\tStore.logger?.(`[STORE => ${this.name}] [STOP] Stopped all cronjob tasks.`);\n\t\treturn this;\n\t}\n\n\tpublic override set(key: string, value: CronTask): this {\n\t\tconst { options } = value;\n\n\t\tconst { sentry, defaultTimezone } = this.container.cron;\n\t\tconst cronJob = sentry ? sentry.cron.instrumentCron(CronJob, key) : CronJob;\n\n\t\ttry {\n\t\t\tvalue.job = cronJob.from({\n\t\t\t\t...options,\n\t\t\t\tonTick: () => void value.run.bind(value)(),\n\t\t\t\tstart: false,\n\t\t\t\tcontext: value,\n\t\t\t\ttimeZone: options.timeZone ?? defaultTimezone\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tvalue.error('Encountered an error while creating the cron job', error);\n\t\t\tvoid value.unload();\n\t\t}\n\n\t\treturn super.set(key, value);\n\t}\n\n\tpublic override delete(key: string) {\n\t\tconst task = this.get(key);\n\t\tif (task?.job.running) {\n\t\t\ttask.job.stop();\n\t\t}\n\n\t\treturn super.delete(key);\n\t}\n\n\t/**\n\t * Stops all running cron jobs and clears the store.\n\t * @returns void\n\t */\n\tpublic override clear() {\n\t\tthis.stopAll();\n\t\treturn super.clear();\n\t}\n}\n"]}

package/dist/cjs/register.cjs

@@ -22,22 +22,10 @@ var _CronTaskPlugin = class _CronTaskPlugin extends framework.Plugin {
 };
 __name(_CronTaskPlugin, "CronTaskPlugin");
 var CronTaskPlugin = _CronTaskPlugin;
-framework.SapphireClient.plugins.registerPreGenericsInitializationHook(
-  CronTaskPlugin[framework.preGenericsInitialization],
-  "Cron-Task-PreGenericsInitialization"
-);
-framework.SapphireClient.plugins.registerPostInitializationHook(
-  CronTaskPlugin[framework.postInitialization],
-  "Cron-Task-PostInitialization"
-);
-framework.SapphireClient.plugins.registerPreLoginHook(
-  CronTaskPlugin[framework.preLogin],
-  "Cron-Task-PreLogin"
-);
-framework.SapphireClient.plugins.registerPostLoginHook(
-  CronTaskPlugin[framework.postLogin],
-  "Cron-Task-PostLogin"
-);
+framework.SapphireClient.plugins.registerPreGenericsInitializationHook(CronTaskPlugin[framework.preGenericsInitialization], "Cron-Task-PreGenericsInitialization");
+framework.SapphireClient.plugins.registerPostInitializationHook(CronTaskPlugin[framework.postInitialization], "Cron-Task-PostInitialization");
+framework.SapphireClient.plugins.registerPreLoginHook(CronTaskPlugin[framework.preLogin], "Cron-Task-PreLogin");
+framework.SapphireClient.plugins.registerPostLoginHook(CronTaskPlugin[framework.postLogin], "Cron-Task-PostLogin");
 
 exports.CronTaskPlugin = CronTaskPlugin;
 //# sourceMappingURL=register.cjs.map

package/dist/cjs/register.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/register.ts"],"names":["Plugin","preGenericsInitialization","container","CronTaskHandler","postInitialization","CronTaskStore","preLogin","postLogin","SapphireClient"],"mappings":";;;;;;;AAcO,IAAM,eAAA,GAAN,MAAM,eAAA,SAAuBA,gBAAO,CAAA;AAAA,EACvC,QAAQC,mCAAyB,CAAA,CAE7B,OACF,EAAA;AACE,IAAAC,mBAAA,CAAU,IAAO,GAAA,IAAIC,yBAAgB,CAAA,OAAA,CAAQ,IAAI,CAAA,CAAA;AAAA,GACrD;AAAA,EAEA,QAAQC,4BAAkB,CAAwB,GAAA;AAC9C,IAAA,IAAA,CAAK,MAAO,CAAA,QAAA,CAAS,IAAIC,uBAAA,EAAe,CAAA,CAAA;AAAA,GAC5C;AAAA,EAEA,cAAcC,kBAAQ,CAAwB,GAAA;AAC1C,IAAI,IAAAJ,mBAAA,CAAU,KAAK,aAAe,EAAA,OAAA;AAClC,IAAAA,mBAAA,CAAU,IAAK,CAAA,MAAA,GAAS,MAAM,OAAO,cAAc,CAC9C,CAAA,IAAA,CAAK,CAAC,GAAA,KAAQ,GAAI,CAAA,OAAO,CACzB,CAAA,KAAA,CAAM,MAAM,KAAS,CAAA,CAAA,CAAA;AAAA,GAC9B;AAAA,EAEA,QAAQK,mBAAS,CAAwB,GAAA;AACrC,IAAAL,mBAAA,CAAU,KAAK,QAAS,EAAA,CAAA;AAAA,GAC5B;AACJ,CAAA,CAAA;AAtB2C,MAAA,CAAA,eAAA,EAAA,gBAAA,CAAA,CAAA;AAApC,IAAM,cAAN,GAAA,gBAAA;AAwBPM,wBAAA,CAAe,OAAQ,CAAA,qCAAA;AAAA,EACnB,eAAeP,mCAAyB,CAAA;AAAA,EACxC,qCAAA;AACJ,CAAA,CAAA;AAEAO,wBAAA,CAAe,OAAQ,CAAA,8BAAA;AAAA,EACnB,eAAeJ,4BAAkB,CAAA;AAAA,EACjC,8BAAA;AACJ,CAAA,CAAA;AAEAI,wBAAA,CAAe,OAAQ,CAAA,oBAAA;AAAA,EACnB,eAAeF,kBAAQ,CAAA;AAAA,EACvB,oBAAA;AACJ,CAAA,CAAA;AAEAE,wBAAA,CAAe,OAAQ,CAAA,qBAAA;AAAA,EACnB,eAAeD,mBAAS,CAAA;AAAA,EACxB,qBAAA;AACJ,CAAA","file":"register.cjs","sourcesContent":["import \"./index\";\n\nimport {\n    container,\n    Plugin,\n    postInitialization,\n    postLogin,\n    preGenericsInitialization,\n    preLogin,\n    SapphireClient,\n} from \"@sapphire/framework\";\nimport type { ClientOptions } from \"discord.js\";\nimport { CronTaskHandler, CronTaskStore } from \"./index\";\n\nexport class CronTaskPlugin extends Plugin {\n    static [preGenericsInitialization](\n        this: SapphireClient,\n        options: ClientOptions,\n    ) {\n        container.cron = new CronTaskHandler(options.cron);\n    }\n\n    static [postInitialization](this: SapphireClient) {\n        this.stores.register(new CronTaskStore());\n    }\n\n    static async [preLogin](this: SapphireClient) {\n        if (container.cron.disableSentry) return;\n        container.cron.sentry = await import(\"@sentry/node\")\n            .then((mod) => mod.default)\n            .catch(() => undefined);\n    }\n\n    static [postLogin](this: SapphireClient) {\n        container.cron.startAll();\n    }\n}\n\nSapphireClient.plugins.registerPreGenericsInitializationHook(\n    CronTaskPlugin[preGenericsInitialization],\n    \"Cron-Task-PreGenericsInitialization\",\n);\n\nSapphireClient.plugins.registerPostInitializationHook(\n    CronTaskPlugin[postInitialization],\n    \"Cron-Task-PostInitialization\",\n);\n\nSapphireClient.plugins.registerPreLoginHook(\n    CronTaskPlugin[preLogin],\n    \"Cron-Task-PreLogin\",\n);\n\nSapphireClient.plugins.registerPostLoginHook(\n    CronTaskPlugin[postLogin],\n    \"Cron-Task-PostLogin\",\n);\n"]}
+{"version":3,"sources":["../../src/register.ts"],"names":["Plugin","preGenericsInitialization","container","CronTaskHandler","postInitialization","CronTaskStore","preLogin","postLogin","SapphireClient"],"mappings":";;;;;;;AAMO,IAAM,eAAA,GAAN,MAAM,eAAA,SAAuBA,gBAAO,CAAA;AAAA,EAC1C,QAAeC,mCAAyB,CAAA,CAAwB,OAAwB,EAAA;AACvF,IAAAC,mBAAA,CAAU,IAAO,GAAA,IAAIC,yBAAgB,CAAA,OAAA,CAAQ,IAAI,CAAA,CAAA;AAAA,GAClD;AAAA,EAEA,QAAeC,4BAAkB,CAAwB,GAAA;AACxD,IAAA,IAAA,CAAK,MAAO,CAAA,QAAA,CAAS,IAAIC,uBAAA,EAAe,CAAA,CAAA;AAAA,GACzC;AAAA,EAEA,cAAqBC,kBAAQ,CAAwB,GAAA;AACpD,IAAI,IAAAJ,mBAAA,CAAU,KAAK,aAAe,EAAA,OAAA;AAClC,IAAAA,mBAAA,CAAU,IAAK,CAAA,MAAA,GAAS,MAAM,OAAO,cAAc,CAAE,CAAA,IAAA,CAAK,CAAC,GAAA,KAAQ,GAAI,CAAA,OAAO,CAAE,CAAA,KAAA,CAAM,MAAM,KAAS,CAAA,CAAA,CAAA;AAAA,GACtG;AAAA,EAEA,QAAeK,mBAAS,CAAwB,GAAA;AAC/C,IAAAL,mBAAA,CAAU,KAAK,QAAS,EAAA,CAAA;AAAA,GACzB;AACD,CAAA,CAAA;AAjB2C,MAAA,CAAA,eAAA,EAAA,gBAAA,CAAA,CAAA;AAApC,IAAM,cAAN,GAAA,gBAAA;AAmBPM,wBAAA,CAAe,OAAQ,CAAA,qCAAA,CAAsC,cAAe,CAAAP,mCAAyB,GAAG,qCAAqC,CAAA,CAAA;AAE7IO,wBAAA,CAAe,OAAQ,CAAA,8BAAA,CAA+B,cAAe,CAAAJ,4BAAkB,GAAG,8BAA8B,CAAA,CAAA;AAExHI,wBAAA,CAAe,OAAQ,CAAA,oBAAA,CAAqB,cAAe,CAAAF,kBAAQ,GAAG,oBAAoB,CAAA,CAAA;AAE1FE,wBAAA,CAAe,OAAQ,CAAA,qBAAA,CAAsB,cAAe,CAAAD,mBAAS,GAAG,qBAAqB,CAAA","file":"register.cjs","sourcesContent":["import './index';\n\nimport { container, Plugin, postInitialization, postLogin, preGenericsInitialization, preLogin, SapphireClient } from '@sapphire/framework';\nimport type { ClientOptions } from 'discord.js';\nimport { CronTaskHandler, CronTaskStore } from './index';\n\nexport class CronTaskPlugin extends Plugin {\n\tpublic static [preGenericsInitialization](this: SapphireClient, options: ClientOptions) {\n\t\tcontainer.cron = new CronTaskHandler(options.cron);\n\t}\n\n\tpublic static [postInitialization](this: SapphireClient) {\n\t\tthis.stores.register(new CronTaskStore());\n\t}\n\n\tpublic static async [preLogin](this: SapphireClient) {\n\t\tif (container.cron.disableSentry) return;\n\t\tcontainer.cron.sentry = await import('@sentry/node').then((mod) => mod.default).catch(() => undefined);\n\t}\n\n\tpublic static [postLogin](this: SapphireClient) {\n\t\tcontainer.cron.startAll();\n\t}\n}\n\nSapphireClient.plugins.registerPreGenericsInitializationHook(CronTaskPlugin[preGenericsInitialization], 'Cron-Task-PreGenericsInitialization');\n\nSapphireClient.plugins.registerPostInitializationHook(CronTaskPlugin[postInitialization], 'Cron-Task-PostInitialization');\n\nSapphireClient.plugins.registerPreLoginHook(CronTaskPlugin[preLogin], 'Cron-Task-PreLogin');\n\nSapphireClient.plugins.registerPostLoginHook(CronTaskPlugin[postLogin], 'Cron-Task-PostLogin');\n"]}

package/dist/esm/index.d.mts

@@ -1,71 +1,169 @@
 import { Piece, Store } from '@sapphire/pieces';
-import { CronJobParams, CronJob } from 'cron';
 import { Awaitable } from '@sapphire/framework';
+import { CronJobParams, CronJob } from 'cron';
 import Sentry from '@sentry/node';
 
 interface CronTaskHandlerOptions {
     /**
      * The default timezone to use for all cron tasks.
      * You can override this per task, using the timeZone option.
+     * @see https://github.com/moment/luxon/blob/master/docs/zones.md#specifying-a-zone
      * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
-     * @default "UTC"
+     * @default 'UTC'
      */
-    defaultTimezone?: string;
+    defaultTimezone: string;
     /**
      * The ability to opt-out of instrumenting cron jobs with Sentry.
      * If you don't use Sentry, you can ignore this option.
      * @see https://docs.sentry.io/product/crons/
-     * @default undefined // technically false
+     * @default false
      */
-    disableSentry?: boolean;
+    disableSentry: boolean;
 }
-type CronJobOptions = Omit<CronJobParams<null, CronTask>, "onTick" | "onComplete" | "start" | "context" | "utcOffset">;
+type CronJobOptions = Omit<CronJobParams<null, CronTask>, 'onTick' | 'onComplete' | 'start' | 'context' | 'utcOffset'>;
 
-declare abstract class CronTask<Options extends CronTask.Options = CronTask.Options> extends Piece<Options, "cron-tasks"> {
+/**
+ * @example
+ *
+ * ```typescript
+ * // ping.ts
+ * import { CronTask } from '@kingsworld/plugin-cron';
+ *
+ * export class PingPong extends CronTask {
+ * 	public constructor(context: CronTask.LoaderContext, options: CronTask.Options) {
+ * 		super(context, {
+ * 			...options,
+ * 			cronTime: '* * * * *'
+ * 		});
+ * 	}
+ *
+ * 	public run() {
+ * 		this.info('Ping Pong! 🏓'); // CronTask[ping] Ping Pong! 🏓
+ * 	}
+ * }
+ * ```
+ */
+declare abstract class CronTask<Options extends CronTask.Options = CronTask.Options> extends Piece<Options, 'cron-tasks'> {
     job: CronJob<null, CronTask>;
     constructor(context: CronTask.LoaderContext, options: Options);
     abstract run(): Awaitable<unknown>;
+    /**
+     * A helper function to log messages with the `CronTask[${name}]` prefix.
+     * @param message The message to include after the prefix
+     * @param other Extra parameters to pass to the logger
+     * @example
+     * this.info('Hello world!'); // CronTask[my-task] Hello world!
+     */
     info(message: string, ...other: unknown[]): void;
+    /**
+     * A helper function to log messages with the `CronTask[${name}]` prefix.
+     * @param message The message to include after the prefix
+     * @param other Extra parameters to pass to the logger
+     * @example
+     * this.error('Something went wrong!'); // CronTask[my-task] Something went wrong!
+     */
     error(message: string, ...other: unknown[]): void;
+    /**
+     * A helper function to log messages with the `CronTask[${name}]` prefix.
+     * @param message The message to include after the prefix
+     * @param other Extra parameters to pass to the logger
+     * @example
+     * this.warn('Something is not right!'); // CronTask[my-task] Something is not right!
+     */
     warn(message: string, ...other: unknown[]): void;
+    /**
+     * A helper function to log messages with the `CronTask[${name}]` prefix.
+     * @param message The message to include after the prefix
+     * @param other Extra parameters to pass to the logger
+     * @example
+     * this.debug('Something is happening!'); // CronTask[my-task] Something is happening!
+     */
     debug(message: string, ...other: unknown[]): void;
+    /**
+     * A helper function to log messages with the `CronTask[${name}]` prefix.
+     * @param message The message to include after the prefix
+     * @param other Extra parameters to pass to the logger
+     * @example
+     * this.trace('Loaded the file.'); // CronTask[my-task] Loaded the file.
+     */
     trace(message: string, ...other: unknown[]): void;
 }
 declare namespace CronTask {
     type Options = Piece.Options & CronJobOptions;
     /** @deprecated Use {@linkcode LoaderContext} instead. */
     type Context = LoaderContext;
-    type LoaderContext = Piece.LoaderContext<"cron-tasks">;
+    type LoaderContext = Piece.LoaderContext<'cron-tasks'>;
 }
 
-declare class CronTaskStore extends Store<CronTask, "cron-tasks"> {
+declare class CronTaskStore extends Store<CronTask, 'cron-tasks'> {
     constructor();
+    /**
+     * Loops over all tasks and starts those that are enabled.
+     * This gets called automatically when the Client is ready.
+     * @returns CronTaskStore
+     */
     startAll(): this;
+    /**
+     * Loops over all tasks and stops those that are running.
+     * @returns CronTaskStore
+     */
     stopAll(): this;
     set(key: string, value: CronTask): this;
     delete(key: string): boolean;
+    /**
+     * Stops all running cron jobs and clears the store.
+     * @returns void
+     */
     clear(): void;
 }
 
 declare class CronTaskHandler {
-    defaultTimezone?: CronTaskHandlerOptions["defaultTimezone"];
-    disableSentry?: boolean;
+    /**
+     * The default timezone to use for all cron tasks.
+     * You can override this per task, using the timeZone option.
+     * @see https://github.com/moment/luxon/blob/master/docs/zones.md#specifying-a-zone
+     * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     * @default 'UTC'
+     */
+    defaultTimezone: CronTaskHandlerOptions['defaultTimezone'];
+    /**
+     * The ability to opt-out of instrumenting cron jobs with Sentry.
+     * If you don't use Sentry, you can ignore this option.
+     * @see https://docs.sentry.io/product/crons/
+     * @default false
+     */
+    disableSentry: boolean;
+    /**
+     * The Sentry instance to use for instrumenting cron jobs.
+     * This is only available when [`@sentry/node`](https://www.npmjs.com/package/@sentry/node)
+     * is installed and the {@linkcode disableSentry} option is set to false.
+     */
     sentry?: typeof Sentry;
     constructor(options?: CronTaskHandlerOptions);
+    /**
+     * Start all enabled cron jobs.
+     * This gets called automatically when the Client is ready.
+     */
     startAll(): void;
+    /**
+     * Stop all running cron jobs.
+     */
     stopAll(): void;
+    /**
+     * Get the cron task store.
+     */
     private get store();
 }
 
-declare module "@sapphire/pieces" {
+declare module '@sapphire/pieces' {
     interface Container {
         cron: CronTaskHandler;
     }
     interface StoreRegistryEntries {
-        "cron-tasks": CronTaskStore;
+        'cron-tasks': CronTaskStore;
     }
 }
-declare module "discord.js" {
+declare module 'discord.js' {
     interface ClientOptions {
         cron?: CronTaskHandlerOptions;
     }

package/dist/esm/index.mjs

@@ -4,7 +4,7 @@ export * from './lib/structures/CronTask.mjs';
 export * from './lib/structures/CronTaskStore.mjs';
 export * from './lib/types/CronTaskTypes.mjs';
 
-var version = "1.5.1";
+var version = "2.0.0-next.179a2eb";
 
 export { version };
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;AA+BO,IAAM,OAAkB,GAAA","file":"index.mjs","sourcesContent":["import type { CronTaskStore } from \"./lib/structures/CronTaskStore\";\nimport type { CronTaskHandler } from \"./lib/CronTaskHandler\";\nimport type { CronTaskHandlerOptions } from \"./lib/types/CronTaskTypes\";\n\nexport * from \"./lib/CronTaskHandler\";\nexport * from \"./lib/structures/CronTask\";\nexport * from \"./lib/structures/CronTaskStore\";\nexport * from \"./lib/types/CronTaskTypes\";\n\ndeclare module \"@sapphire/pieces\" {\n    interface Container {\n        cron: CronTaskHandler;\n    }\n\n    interface StoreRegistryEntries {\n        \"cron-tasks\": CronTaskStore;\n    }\n}\n\ndeclare module \"discord.js\" {\n    export interface ClientOptions {\n        cron?: CronTaskHandlerOptions;\n    }\n}\n\n/**\n * The [@kingsworld/plugin-cron](https://github.com/Kings-World/sapphire-plugins/tree/main/packages/cron) version that you are currently using.\n * An example use of this is showing it of in a bot information command.\n *\n * Note to Sapphire developers: This needs to explicitly be `string` so it is not typed as the string that gets replaced by esbuild\n */\nexport const version: string = \"1.5.1\";\n"]}
+{"version":3,"sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;AA+BO,IAAM,OAAkB,GAAA","file":"index.mjs","sourcesContent":["import type { CronTaskStore } from './lib/structures/CronTaskStore';\nimport type { CronTaskHandler } from './lib/CronTaskHandler';\nimport type { CronTaskHandlerOptions } from './lib/types/CronTaskTypes';\n\nexport * from './lib/CronTaskHandler';\nexport * from './lib/structures/CronTask';\nexport * from './lib/structures/CronTaskStore';\nexport * from './lib/types/CronTaskTypes';\n\ndeclare module '@sapphire/pieces' {\n\tinterface Container {\n\t\tcron: CronTaskHandler;\n\t}\n\n\tinterface StoreRegistryEntries {\n\t\t'cron-tasks': CronTaskStore;\n\t}\n}\n\ndeclare module 'discord.js' {\n\texport interface ClientOptions {\n\t\tcron?: CronTaskHandlerOptions;\n\t}\n}\n\n/**\n * The [@kingsworld/plugin-cron](https://github.com/Kings-World/sapphire-plugins/tree/main/packages/cron) version that you are currently using.\n * An example use of this is showing it of in a bot information command.\n *\n * Note to Sapphire developers: This needs to explicitly be `string` so it is not typed as the string that gets replaced by esbuild\n */\nexport const version: string = '2.0.0-next.179a2eb';\n"]}

package/dist/esm/lib/CronTaskHandler.mjs

@@ -3,18 +3,46 @@ import { container } from '@sapphire/framework';
 
 var _CronTaskHandler = class _CronTaskHandler {
   constructor(options) {
+    /**
+     * The default timezone to use for all cron tasks.
+     * You can override this per task, using the timeZone option.
+     * @see https://github.com/moment/luxon/blob/master/docs/zones.md#specifying-a-zone
+     * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
+     * @default 'UTC'
+     */
     __publicField(this, "defaultTimezone");
+    /**
+     * The ability to opt-out of instrumenting cron jobs with Sentry.
+     * If you don't use Sentry, you can ignore this option.
+     * @see https://docs.sentry.io/product/crons/
+     * @default false
+     */
     __publicField(this, "disableSentry");
+    /**
+     * The Sentry instance to use for instrumenting cron jobs.
+     * This is only available when [`@sentry/node`](https://www.npmjs.com/package/@sentry/node)
+     * is installed and the {@linkcode disableSentry} option is set to false.
+     */
     __publicField(this, "sentry");
-    this.defaultTimezone = options?.defaultTimezone;
-    this.disableSentry = options?.disableSentry;
+    this.defaultTimezone = options?.defaultTimezone ?? "UTC";
+    this.disableSentry = options?.disableSentry ?? false;
   }
+  /**
+   * Start all enabled cron jobs.
+   * This gets called automatically when the Client is ready.
+   */
   startAll() {
     this.store.startAll();
   }
+  /**
+   * Stop all running cron jobs.
+   */
   stopAll() {
     this.store.stopAll();
   }
+  /**
+   * Get the cron task store.
+   */
   get store() {
     return container.stores.get("cron-tasks");
   }

package/dist/esm/lib/CronTaskHandler.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/CronTaskHandler.ts"],"names":[],"mappings":";;;AAIO,IAAM,gBAAA,GAAN,MAAM,gBAAgB,CAAA;AAAA,EAKzB,YAAY,OAAkC,EAAA;AAJ9C,IAAA,aAAA,CAAA,IAAA,EAAA,iBAAA,CAAA,CAAA;AACA,IAAA,aAAA,CAAA,IAAA,EAAA,eAAA,CAAA,CAAA;AACA,IAAA,aAAA,CAAA,IAAA,EAAA,QAAA,CAAA,CAAA;AAGI,IAAA,IAAA,CAAK,kBAAkB,OAAS,EAAA,eAAA,CAAA;AAChC,IAAA,IAAA,CAAK,gBAAgB,OAAS,EAAA,aAAA,CAAA;AAAA,GAClC;AAAA,EAEA,QAAW,GAAA;AACP,IAAA,IAAA,CAAK,MAAM,QAAS,EAAA,CAAA;AAAA,GACxB;AAAA,EAEA,OAAU,GAAA;AACN,IAAA,IAAA,CAAK,MAAM,OAAQ,EAAA,CAAA;AAAA,GACvB;AAAA,EAEA,IAAY,KAAQ,GAAA;AAChB,IAAO,OAAA,SAAA,CAAU,MAAO,CAAA,GAAA,CAAI,YAAY,CAAA,CAAA;AAAA,GAC5C;AACJ,CAAA,CAAA;AArB6B,MAAA,CAAA,gBAAA,EAAA,iBAAA,CAAA,CAAA;AAAtB,IAAM,eAAN,GAAA","file":"CronTaskHandler.mjs","sourcesContent":["import { container } from \"@sapphire/framework\";\nimport type { CronTaskHandlerOptions } from \"./types/CronTaskTypes\";\nimport type Sentry from \"@sentry/node\";\n\nexport class CronTaskHandler {\n    defaultTimezone?: CronTaskHandlerOptions[\"defaultTimezone\"];\n    disableSentry?: boolean;\n    sentry?: typeof Sentry;\n\n    constructor(options?: CronTaskHandlerOptions) {\n        this.defaultTimezone = options?.defaultTimezone;\n        this.disableSentry = options?.disableSentry;\n    }\n\n    startAll() {\n        this.store.startAll();\n    }\n\n    stopAll() {\n        this.store.stopAll();\n    }\n\n    private get store() {\n        return container.stores.get(\"cron-tasks\");\n    }\n}\n"]}
+{"version":3,"sources":["../../../src/lib/CronTaskHandler.ts"],"names":[],"mappings":";;;AAIO,IAAM,gBAAA,GAAN,MAAM,gBAAgB,CAAA;AAAA,EAyBrB,YAAY,OAAkC,EAAA;AAjBrD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAO,aAAA,CAAA,IAAA,EAAA,iBAAA,CAAA,CAAA;AAQP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAO,aAAA,CAAA,IAAA,EAAA,eAAA,CAAA,CAAA;AAOP;AAAA;AAAA;AAAA;AAAA;AAAA,IAAO,aAAA,CAAA,IAAA,EAAA,QAAA,CAAA,CAAA;AAGN,IAAK,IAAA,CAAA,eAAA,GAAkB,SAAS,eAAmB,IAAA,KAAA,CAAA;AACnD,IAAK,IAAA,CAAA,aAAA,GAAgB,SAAS,aAAiB,IAAA,KAAA,CAAA;AAAA,GAChD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,QAAW,GAAA;AACjB,IAAA,IAAA,CAAK,MAAM,QAAS,EAAA,CAAA;AAAA,GACrB;AAAA;AAAA;AAAA;AAAA,EAKO,OAAU,GAAA;AAChB,IAAA,IAAA,CAAK,MAAM,OAAQ,EAAA,CAAA;AAAA,GACpB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAY,KAAQ,GAAA;AACnB,IAAO,OAAA,SAAA,CAAU,MAAO,CAAA,GAAA,CAAI,YAAY,CAAA,CAAA;AAAA,GACzC;AACD,CAAA,CAAA;AAnD6B,MAAA,CAAA,gBAAA,EAAA,iBAAA,CAAA,CAAA;AAAtB,IAAM,eAAN,GAAA","file":"CronTaskHandler.mjs","sourcesContent":["import { container } from '@sapphire/framework';\nimport type Sentry from '@sentry/node';\nimport type { CronTaskHandlerOptions } from './types/CronTaskTypes';\n\nexport class CronTaskHandler {\n\t/**\n\t * The default timezone to use for all cron tasks.\n\t * You can override this per task, using the timeZone option.\n\t * @see https://github.com/moment/luxon/blob/master/docs/zones.md#specifying-a-zone\n\t * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones\n\t * @default 'UTC'\n\t */\n\tpublic defaultTimezone: CronTaskHandlerOptions['defaultTimezone'];\n\n\t/**\n\t * The ability to opt-out of instrumenting cron jobs with Sentry.\n\t * If you don't use Sentry, you can ignore this option.\n\t * @see https://docs.sentry.io/product/crons/\n\t * @default false\n\t */\n\tpublic disableSentry: boolean;\n\n\t/**\n\t * The Sentry instance to use for instrumenting cron jobs.\n\t * This is only available when [`@sentry/node`](https://www.npmjs.com/package/@sentry/node)\n\t * is installed and the {@linkcode disableSentry} option is set to false.\n\t */\n\tpublic sentry?: typeof Sentry;\n\n\tpublic constructor(options?: CronTaskHandlerOptions) {\n\t\tthis.defaultTimezone = options?.defaultTimezone ?? 'UTC';\n\t\tthis.disableSentry = options?.disableSentry ?? false;\n\t}\n\n\t/**\n\t * Start all enabled cron jobs.\n\t * This gets called automatically when the Client is ready.\n\t */\n\tpublic startAll() {\n\t\tthis.store.startAll();\n\t}\n\n\t/**\n\t * Stop all running cron jobs.\n\t */\n\tpublic stopAll() {\n\t\tthis.store.stopAll();\n\t}\n\n\t/**\n\t * Get the cron task store.\n\t */\n\tprivate get store() {\n\t\treturn container.stores.get('cron-tasks');\n\t}\n}\n"]}

package/dist/esm/lib/structures/CronTask.mjs

@@ -5,35 +5,55 @@ var _CronTask = class _CronTask extends Piece {
   constructor(context, options) {
     super(context, options);
   }
+  /**
+   * A helper function to log messages with the `CronTask[${name}]` prefix.
+   * @param message The message to include after the prefix
+   * @param other Extra parameters to pass to the logger
+   * @example
+   * this.info('Hello world!'); // CronTask[my-task] Hello world!
+   */
   info(message, ...other) {
-    this.container.logger.info(
-      `CronTask[${this.name}] ${message}`,
-      ...other
-    );
+    this.container.logger.info(`CronTask[${this.name}] ${message}`, ...other);
   }
+  /**
+   * A helper function to log messages with the `CronTask[${name}]` prefix.
+   * @param message The message to include after the prefix
+   * @param other Extra parameters to pass to the logger
+   * @example
+   * this.error('Something went wrong!'); // CronTask[my-task] Something went wrong!
+   */
   error(message, ...other) {
-    this.container.logger.error(
-      `CronTask[${this.name}] ${message}`,
-      ...other
-    );
+    this.container.logger.error(`CronTask[${this.name}] ${message}`, ...other);
   }
+  /**
+   * A helper function to log messages with the `CronTask[${name}]` prefix.
+   * @param message The message to include after the prefix
+   * @param other Extra parameters to pass to the logger
+   * @example
+   * this.warn('Something is not right!'); // CronTask[my-task] Something is not right!
+   */
   warn(message, ...other) {
-    this.container.logger.warn(
-      `CronTask[${this.name}] ${message}`,
-      ...other
-    );
+    this.container.logger.warn(`CronTask[${this.name}] ${message}`, ...other);
   }
+  /**
+   * A helper function to log messages with the `CronTask[${name}]` prefix.
+   * @param message The message to include after the prefix
+   * @param other Extra parameters to pass to the logger
+   * @example
+   * this.debug('Something is happening!'); // CronTask[my-task] Something is happening!
+   */
   debug(message, ...other) {
-    this.container.logger.debug(
-      `CronTask[${this.name}] ${message}`,
-      ...other
-    );
+    this.container.logger.debug(`CronTask[${this.name}] ${message}`, ...other);
   }
+  /**
+   * A helper function to log messages with the `CronTask[${name}]` prefix.
+   * @param message The message to include after the prefix
+   * @param other Extra parameters to pass to the logger
+   * @example
+   * this.trace('Loaded the file.'); // CronTask[my-task] Loaded the file.
+   */
   trace(message, ...other) {
-    this.container.logger.trace(
-      `CronTask[${this.name}] ${message}`,
-      ...other
-    );
+    this.container.logger.trace(`CronTask[${this.name}] ${message}`, ...other);
   }
 };
 __name(_CronTask, "CronTask");

package/dist/esm/lib/structures/CronTask.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/CronTask.ts"],"names":[],"mappings":";;;AAKO,IAAe,SAAA,GAAf,MAAe,SAAA,SAEZ,KAA6B,CAAA;AAAA,EAGnC,WAAA,CAAY,SAAiC,OAAkB,EAAA;AAC3D,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA,CAAA;AAAA,GAC1B;AAAA,EAIA,IAAA,CAAK,YAAoB,KAAkB,EAAA;AACvC,IAAA,IAAA,CAAK,UAAU,MAAO,CAAA,IAAA;AAAA,MAClB,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAA,EAAA,EAAK,OAAO,CAAA,CAAA;AAAA,MACjC,GAAG,KAAA;AAAA,KACP,CAAA;AAAA,GACJ;AAAA,EAEA,KAAA,CAAM,YAAoB,KAAkB,EAAA;AACxC,IAAA,IAAA,CAAK,UAAU,MAAO,CAAA,KAAA;AAAA,MAClB,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAA,EAAA,EAAK,OAAO,CAAA,CAAA;AAAA,MACjC,GAAG,KAAA;AAAA,KACP,CAAA;AAAA,GACJ;AAAA,EAEA,IAAA,CAAK,YAAoB,KAAkB,EAAA;AACvC,IAAA,IAAA,CAAK,UAAU,MAAO,CAAA,IAAA;AAAA,MAClB,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAA,EAAA,EAAK,OAAO,CAAA,CAAA;AAAA,MACjC,GAAG,KAAA;AAAA,KACP,CAAA;AAAA,GACJ;AAAA,EAEA,KAAA,CAAM,YAAoB,KAAkB,EAAA;AACxC,IAAA,IAAA,CAAK,UAAU,MAAO,CAAA,KAAA;AAAA,MAClB,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAA,EAAA,EAAK,OAAO,CAAA,CAAA;AAAA,MACjC,GAAG,KAAA;AAAA,KACP,CAAA;AAAA,GACJ;AAAA,EAEA,KAAA,CAAM,YAAoB,KAAkB,EAAA;AACxC,IAAA,IAAA,CAAK,UAAU,MAAO,CAAA,KAAA;AAAA,MAClB,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAA,EAAA,EAAK,OAAO,CAAA,CAAA;AAAA,MACjC,GAAG,KAAA;AAAA,KACP,CAAA;AAAA,GACJ;AACJ,CAAA,CAAA;AA3CuC,MAAA,CAAA,SAAA,EAAA,UAAA,CAAA,CAAA;AAFhC,IAAe,QAAf,GAAA","file":"CronTask.mjs","sourcesContent":["import { Piece } from \"@sapphire/pieces\";\nimport type { CronJob } from \"cron\";\nimport type { CronJobOptions } from \"../types/CronTaskTypes\";\nimport type { Awaitable } from \"@sapphire/framework\";\n\nexport abstract class CronTask<\n    Options extends CronTask.Options = CronTask.Options,\n> extends Piece<Options, \"cron-tasks\"> {\n    declare job: CronJob<null, CronTask>;\n\n    constructor(context: CronTask.LoaderContext, options: Options) {\n        super(context, options);\n    }\n\n    abstract run(): Awaitable<unknown>;\n\n    info(message: string, ...other: unknown[]) {\n        this.container.logger.info(\n            `CronTask[${this.name}] ${message}`,\n            ...other,\n        );\n    }\n\n    error(message: string, ...other: unknown[]) {\n        this.container.logger.error(\n            `CronTask[${this.name}] ${message}`,\n            ...other,\n        );\n    }\n\n    warn(message: string, ...other: unknown[]) {\n        this.container.logger.warn(\n            `CronTask[${this.name}] ${message}`,\n            ...other,\n        );\n    }\n\n    debug(message: string, ...other: unknown[]) {\n        this.container.logger.debug(\n            `CronTask[${this.name}] ${message}`,\n            ...other,\n        );\n    }\n\n    trace(message: string, ...other: unknown[]) {\n        this.container.logger.trace(\n            `CronTask[${this.name}] ${message}`,\n            ...other,\n        );\n    }\n}\n\nexport namespace CronTask {\n    export type Options = Piece.Options & CronJobOptions;\n    /** @deprecated Use {@linkcode LoaderContext} instead. */\n    export type Context = LoaderContext;\n    export type LoaderContext = Piece.LoaderContext<\"cron-tasks\">;\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/structures/CronTask.ts"],"names":[],"mappings":";;;AA0BO,IAAe,SAAA,GAAf,MAAe,SAAA,SAAsE,KAA6B,CAAA;AAAA,EAGjH,WAAA,CAAY,SAAiC,OAAkB,EAAA;AACrE,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA,CAAA;AAAA,GACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWO,IAAA,CAAK,YAAoB,KAAkB,EAAA;AACjD,IAAK,IAAA,CAAA,SAAA,CAAU,MAAO,CAAA,IAAA,CAAK,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAK,EAAA,EAAA,OAAO,CAAI,CAAA,EAAA,GAAG,KAAK,CAAA,CAAA;AAAA,GACzE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASO,KAAA,CAAM,YAAoB,KAAkB,EAAA;AAClD,IAAK,IAAA,CAAA,SAAA,CAAU,MAAO,CAAA,KAAA,CAAM,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAK,EAAA,EAAA,OAAO,CAAI,CAAA,EAAA,GAAG,KAAK,CAAA,CAAA;AAAA,GAC1E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASO,IAAA,CAAK,YAAoB,KAAkB,EAAA;AACjD,IAAK,IAAA,CAAA,SAAA,CAAU,MAAO,CAAA,IAAA,CAAK,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAK,EAAA,EAAA,OAAO,CAAI,CAAA,EAAA,GAAG,KAAK,CAAA,CAAA;AAAA,GACzE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASO,KAAA,CAAM,YAAoB,KAAkB,EAAA;AAClD,IAAK,IAAA,CAAA,SAAA,CAAU,MAAO,CAAA,KAAA,CAAM,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAK,EAAA,EAAA,OAAO,CAAI,CAAA,EAAA,GAAG,KAAK,CAAA,CAAA;AAAA,GAC1E;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASO,KAAA,CAAM,YAAoB,KAAkB,EAAA;AAClD,IAAK,IAAA,CAAA,SAAA,CAAU,MAAO,CAAA,KAAA,CAAM,CAAY,SAAA,EAAA,IAAA,CAAK,IAAI,CAAK,EAAA,EAAA,OAAO,CAAI,CAAA,EAAA,GAAG,KAAK,CAAA,CAAA;AAAA,GAC1E;AACD,CAAA,CAAA;AA/DyH,MAAA,CAAA,SAAA,EAAA,UAAA,CAAA,CAAA;AAAlH,IAAe,QAAf,GAAA","file":"CronTask.mjs","sourcesContent":["import type { Awaitable } from '@sapphire/framework';\nimport { Piece } from '@sapphire/pieces';\nimport type { CronJob } from 'cron';\nimport type { CronJobOptions } from '../types/CronTaskTypes';\n\n/**\n * @example\n *\n * ```typescript\n * // ping.ts\n * import { CronTask } from '@kingsworld/plugin-cron';\n *\n * export class PingPong extends CronTask {\n * \tpublic constructor(context: CronTask.LoaderContext, options: CronTask.Options) {\n * \t\tsuper(context, {\n * \t\t\t...options,\n * \t\t\tcronTime: '* * * * *'\n * \t\t});\n * \t}\n *\n * \tpublic run() {\n * \t\tthis.info('Ping Pong! 🏓'); // CronTask[ping] Ping Pong! 🏓\n * \t}\n * }\n * ```\n */\nexport abstract class CronTask<Options extends CronTask.Options = CronTask.Options> extends Piece<Options, 'cron-tasks'> {\n\tpublic declare job: CronJob<null, CronTask>;\n\n\tpublic constructor(context: CronTask.LoaderContext, options: Options) {\n\t\tsuper(context, options);\n\t}\n\n\tpublic abstract run(): Awaitable<unknown>;\n\n\t/**\n\t * A helper function to log messages with the `CronTask[${name}]` prefix.\n\t * @param message The message to include after the prefix\n\t * @param other Extra parameters to pass to the logger\n\t * @example\n\t * this.info('Hello world!'); // CronTask[my-task] Hello world!\n\t */\n\tpublic info(message: string, ...other: unknown[]) {\n\t\tthis.container.logger.info(`CronTask[${this.name}] ${message}`, ...other);\n\t}\n\n\t/**\n\t * A helper function to log messages with the `CronTask[${name}]` prefix.\n\t * @param message The message to include after the prefix\n\t * @param other Extra parameters to pass to the logger\n\t * @example\n\t * this.error('Something went wrong!'); // CronTask[my-task] Something went wrong!\n\t */\n\tpublic error(message: string, ...other: unknown[]) {\n\t\tthis.container.logger.error(`CronTask[${this.name}] ${message}`, ...other);\n\t}\n\n\t/**\n\t * A helper function to log messages with the `CronTask[${name}]` prefix.\n\t * @param message The message to include after the prefix\n\t * @param other Extra parameters to pass to the logger\n\t * @example\n\t * this.warn('Something is not right!'); // CronTask[my-task] Something is not right!\n\t */\n\tpublic warn(message: string, ...other: unknown[]) {\n\t\tthis.container.logger.warn(`CronTask[${this.name}] ${message}`, ...other);\n\t}\n\n\t/**\n\t * A helper function to log messages with the `CronTask[${name}]` prefix.\n\t * @param message The message to include after the prefix\n\t * @param other Extra parameters to pass to the logger\n\t * @example\n\t * this.debug('Something is happening!'); // CronTask[my-task] Something is happening!\n\t */\n\tpublic debug(message: string, ...other: unknown[]) {\n\t\tthis.container.logger.debug(`CronTask[${this.name}] ${message}`, ...other);\n\t}\n\n\t/**\n\t * A helper function to log messages with the `CronTask[${name}]` prefix.\n\t * @param message The message to include after the prefix\n\t * @param other Extra parameters to pass to the logger\n\t * @example\n\t * this.trace('Loaded the file.'); // CronTask[my-task] Loaded the file.\n\t */\n\tpublic trace(message: string, ...other: unknown[]) {\n\t\tthis.container.logger.trace(`CronTask[${this.name}] ${message}`, ...other);\n\t}\n}\n\nexport namespace CronTask {\n\texport type Options = Piece.Options & CronJobOptions;\n\t/** @deprecated Use {@linkcode LoaderContext} instead. */\n\texport type Context = LoaderContext;\n\texport type LoaderContext = Piece.LoaderContext<'cron-tasks'>;\n}\n"]}

package/dist/esm/lib/structures/CronTaskStore.mjs

@@ -1,34 +1,39 @@
 import { __name } from '../../chunk-2JTKI4GS.mjs';
 import { Store } from '@sapphire/pieces';
-import { CronTask } from './CronTask.mjs';
 import { CronJob } from 'cron';
+import { CronTask } from './CronTask.mjs';
 
 var _CronTaskStore = class _CronTaskStore extends Store {
   constructor() {
     super(CronTask, { name: "cron-tasks" });
   }
+  /**
+   * Loops over all tasks and starts those that are enabled.
+   * This gets called automatically when the Client is ready.
+   * @returns CronTaskStore
+   */
   startAll() {
     for (const task of this.values()) {
       if (!task.enabled) continue;
       task.job.start();
     }
-    Store.logger?.(
-      `[STORE => ${this.name}] [START] Started all cronjob tasks.`
-    );
+    Store.logger?.(`[STORE => ${this.name}] [START] Started all cronjob tasks.`);
     return this;
   }
+  /**
+   * Loops over all tasks and stops those that are running.
+   * @returns CronTaskStore
+   */
   stopAll() {
     for (const task of this.values()) {
       if (!task.job.running) continue;
       task.job.stop();
     }
-    Store.logger?.(
-      `[STORE => ${this.name}] [STOP] Stopped all cronjob tasks.`
-    );
+    Store.logger?.(`[STORE => ${this.name}] [STOP] Stopped all cronjob tasks.`);
     return this;
   }
   set(key, value) {
-    const options = value.options;
+    const { options } = value;
     const { sentry, defaultTimezone } = this.container.cron;
     const cronJob = sentry ? sentry.cron.instrumentCron(CronJob, key) : CronJob;
     try {
@@ -40,11 +45,8 @@ var _CronTaskStore = class _CronTaskStore extends Store {
         timeZone: options.timeZone ?? defaultTimezone
       });
     } catch (error) {
-      value.error(
-        "Encountered an error while creating the cron job",
-        error
-      );
-      value.unload();
+      value.error("Encountered an error while creating the cron job", error);
+      void value.unload();
     }
     return super.set(key, value);
   }
@@ -55,6 +57,10 @@ var _CronTaskStore = class _CronTaskStore extends Store {
     }
     return super.delete(key);
   }
+  /**
+   * Stops all running cron jobs and clears the store.
+   * @returns void
+   */
   clear() {
     this.stopAll();
     return super.clear();

package/dist/esm/lib/structures/CronTaskStore.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/CronTaskStore.ts"],"names":[],"mappings":";;;;;AAIO,IAAM,cAAA,GAAN,MAAM,cAAA,SAAsB,KAA8B,CAAA;AAAA,EAC7D,WAAc,GAAA;AACV,IAAA,KAAA,CAAM,QAAU,EAAA,EAAE,IAAM,EAAA,YAAA,EAAc,CAAA,CAAA;AAAA,GAC1C;AAAA,EAEA,QAAW,GAAA;AACP,IAAW,KAAA,MAAA,IAAA,IAAQ,IAAK,CAAA,MAAA,EAAU,EAAA;AAC9B,MAAI,IAAA,CAAC,KAAK,OAAS,EAAA,SAAA;AACnB,MAAA,IAAA,CAAK,IAAI,KAAM,EAAA,CAAA;AAAA,KACnB;AAEA,IAAM,KAAA,CAAA,MAAA;AAAA,MACF,CAAA,UAAA,EAAa,KAAK,IAAI,CAAA,oCAAA,CAAA;AAAA,KAC1B,CAAA;AACA,IAAO,OAAA,IAAA,CAAA;AAAA,GACX;AAAA,EAEA,OAAU,GAAA;AACN,IAAW,KAAA,MAAA,IAAA,IAAQ,IAAK,CAAA,MAAA,EAAU,EAAA;AAC9B,MAAI,IAAA,CAAC,IAAK,CAAA,GAAA,CAAI,OAAS,EAAA,SAAA;AACvB,MAAA,IAAA,CAAK,IAAI,IAAK,EAAA,CAAA;AAAA,KAClB;AAEA,IAAM,KAAA,CAAA,MAAA;AAAA,MACF,CAAA,UAAA,EAAa,KAAK,IAAI,CAAA,mCAAA,CAAA;AAAA,KAC1B,CAAA;AACA,IAAO,OAAA,IAAA,CAAA;AAAA,GACX;AAAA,EAES,GAAA,CAAI,KAAa,KAAuB,EAAA;AAC7C,IAAA,MAAM,UAAU,KAAM,CAAA,OAAA,CAAA;AAEtB,IAAA,MAAM,EAAE,MAAA,EAAQ,eAAgB,EAAA,GAAI,KAAK,SAAU,CAAA,IAAA,CAAA;AACnD,IAAA,MAAM,UAAU,MACV,GAAA,MAAA,CAAO,KAAK,cAAe,CAAA,OAAA,EAAS,GAAG,CACvC,GAAA,OAAA,CAAA;AAEN,IAAI,IAAA;AACA,MAAM,KAAA,CAAA,GAAA,GAAM,QAAQ,IAAK,CAAA;AAAA,QACrB,GAAG,OAAA;AAAA,QACH,MAAA,+BAAc,KAAK,KAAA,CAAM,IAAI,IAAK,CAAA,KAAK,GAA/B,EAAA,QAAA,CAAA;AAAA,QACR,KAAO,EAAA,KAAA;AAAA,QACP,OAAS,EAAA,KAAA;AAAA,QACT,QAAA,EAAU,QAAQ,QAAY,IAAA,eAAA;AAAA,OACjC,CAAA,CAAA;AAAA,aACI,KAAO,EAAA;AACZ,MAAM,KAAA,CAAA,KAAA;AAAA,QACF,kDAAA;AAAA,QACA,KAAA;AAAA,OACJ,CAAA;AACA,MAAA,KAAA,CAAM,MAAO,EAAA,CAAA;AAAA,KACjB;AAEA,IAAO,OAAA,KAAA,CAAM,GAAI,CAAA,GAAA,EAAK,KAAK,CAAA,CAAA;AAAA,GAC/B;AAAA,EAES,OAAO,GAAa,EAAA;AACzB,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AACzB,IAAI,IAAA,IAAA,EAAM,IAAI,OAAS,EAAA;AACnB,MAAA,IAAA,CAAK,IAAI,IAAK,EAAA,CAAA;AAAA,KAClB;AAEA,IAAO,OAAA,KAAA,CAAM,OAAO,GAAG,CAAA,CAAA;AAAA,GAC3B;AAAA,EAES,KAAQ,GAAA;AACb,IAAA,IAAA,CAAK,OAAQ,EAAA,CAAA;AACb,IAAA,OAAO,MAAM,KAAM,EAAA,CAAA;AAAA,GACvB;AACJ,CAAA,CAAA;AArEiE,MAAA,CAAA,cAAA,EAAA,eAAA,CAAA,CAAA;AAA1D,IAAM,aAAN,GAAA","file":"CronTaskStore.mjs","sourcesContent":["import { Store } from \"@sapphire/pieces\";\nimport { CronTask } from \"./CronTask\";\nimport { CronJob } from \"cron\";\n\nexport class CronTaskStore extends Store<CronTask, \"cron-tasks\"> {\n    constructor() {\n        super(CronTask, { name: \"cron-tasks\" });\n    }\n\n    startAll() {\n        for (const task of this.values()) {\n            if (!task.enabled) continue;\n            task.job.start();\n        }\n\n        Store.logger?.(\n            `[STORE => ${this.name}] [START] Started all cronjob tasks.`,\n        );\n        return this;\n    }\n\n    stopAll() {\n        for (const task of this.values()) {\n            if (!task.job.running) continue;\n            task.job.stop();\n        }\n\n        Store.logger?.(\n            `[STORE => ${this.name}] [STOP] Stopped all cronjob tasks.`,\n        );\n        return this;\n    }\n\n    override set(key: string, value: CronTask): this {\n        const options = value.options;\n\n        const { sentry, defaultTimezone } = this.container.cron;\n        const cronJob = sentry\n            ? sentry.cron.instrumentCron(CronJob, key)\n            : CronJob;\n\n        try {\n            value.job = cronJob.from({\n                ...options,\n                onTick: () => void value.run.bind(value)(),\n                start: false,\n                context: value,\n                timeZone: options.timeZone ?? defaultTimezone,\n            });\n        } catch (error) {\n            value.error(\n                \"Encountered an error while creating the cron job\",\n                error,\n            );\n            value.unload();\n        }\n\n        return super.set(key, value);\n    }\n\n    override delete(key: string) {\n        const task = this.get(key);\n        if (task?.job.running) {\n            task.job.stop();\n        }\n\n        return super.delete(key);\n    }\n\n    override clear() {\n        this.stopAll();\n        return super.clear();\n    }\n}\n"]}
+{"version":3,"sources":["../../../../src/lib/structures/CronTaskStore.ts"],"names":[],"mappings":";;;;;AAIO,IAAM,cAAA,GAAN,MAAM,cAAA,SAAsB,KAA8B,CAAA;AAAA,EACzD,WAAc,GAAA;AACpB,IAAA,KAAA,CAAM,QAAU,EAAA,EAAE,IAAM,EAAA,YAAA,EAAc,CAAA,CAAA;AAAA,GACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOO,QAAW,GAAA;AACjB,IAAW,KAAA,MAAA,IAAA,IAAQ,IAAK,CAAA,MAAA,EAAU,EAAA;AACjC,MAAI,IAAA,CAAC,KAAK,OAAS,EAAA,SAAA;AACnB,MAAA,IAAA,CAAK,IAAI,KAAM,EAAA,CAAA;AAAA,KAChB;AAEA,IAAA,KAAA,CAAM,MAAS,GAAA,CAAA,UAAA,EAAa,IAAK,CAAA,IAAI,CAAsC,oCAAA,CAAA,CAAA,CAAA;AAC3E,IAAO,OAAA,IAAA,CAAA;AAAA,GACR;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,OAAU,GAAA;AAChB,IAAW,KAAA,MAAA,IAAA,IAAQ,IAAK,CAAA,MAAA,EAAU,EAAA;AACjC,MAAI,IAAA,CAAC,IAAK,CAAA,GAAA,CAAI,OAAS,EAAA,SAAA;AACvB,MAAA,IAAA,CAAK,IAAI,IAAK,EAAA,CAAA;AAAA,KACf;AAEA,IAAA,KAAA,CAAM,MAAS,GAAA,CAAA,UAAA,EAAa,IAAK,CAAA,IAAI,CAAqC,mCAAA,CAAA,CAAA,CAAA;AAC1E,IAAO,OAAA,IAAA,CAAA;AAAA,GACR;AAAA,EAEgB,GAAA,CAAI,KAAa,KAAuB,EAAA;AACvD,IAAM,MAAA,EAAE,SAAY,GAAA,KAAA,CAAA;AAEpB,IAAA,MAAM,EAAE,MAAA,EAAQ,eAAgB,EAAA,GAAI,KAAK,SAAU,CAAA,IAAA,CAAA;AACnD,IAAA,MAAM,UAAU,MAAS,GAAA,MAAA,CAAO,KAAK,cAAe,CAAA,OAAA,EAAS,GAAG,CAAI,GAAA,OAAA,CAAA;AAEpE,IAAI,IAAA;AACH,MAAM,KAAA,CAAA,GAAA,GAAM,QAAQ,IAAK,CAAA;AAAA,QACxB,GAAG,OAAA;AAAA,QACH,MAAA,+BAAc,KAAK,KAAA,CAAM,IAAI,IAAK,CAAA,KAAK,GAA/B,EAAA,QAAA,CAAA;AAAA,QACR,KAAO,EAAA,KAAA;AAAA,QACP,OAAS,EAAA,KAAA;AAAA,QACT,QAAA,EAAU,QAAQ,QAAY,IAAA,eAAA;AAAA,OAC9B,CAAA,CAAA;AAAA,aACO,KAAO,EAAA;AACf,MAAM,KAAA,CAAA,KAAA,CAAM,oDAAoD,KAAK,CAAA,CAAA;AACrE,MAAA,KAAK,MAAM,MAAO,EAAA,CAAA;AAAA,KACnB;AAEA,IAAO,OAAA,KAAA,CAAM,GAAI,CAAA,GAAA,EAAK,KAAK,CAAA,CAAA;AAAA,GAC5B;AAAA,EAEgB,OAAO,GAAa,EAAA;AACnC,IAAM,MAAA,IAAA,GAAO,IAAK,CAAA,GAAA,CAAI,GAAG,CAAA,CAAA;AACzB,IAAI,IAAA,IAAA,EAAM,IAAI,OAAS,EAAA;AACtB,MAAA,IAAA,CAAK,IAAI,IAAK,EAAA,CAAA;AAAA,KACf;AAEA,IAAO,OAAA,KAAA,CAAM,OAAO,GAAG,CAAA,CAAA;AAAA,GACxB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMgB,KAAQ,GAAA;AACvB,IAAA,IAAA,CAAK,OAAQ,EAAA,CAAA;AACb,IAAA,OAAO,MAAM,KAAM,EAAA,CAAA;AAAA,GACpB;AACD,CAAA,CAAA;AAzEiE,MAAA,CAAA,cAAA,EAAA,eAAA,CAAA,CAAA;AAA1D,IAAM,aAAN,GAAA","file":"CronTaskStore.mjs","sourcesContent":["import { Store } from '@sapphire/pieces';\nimport { CronJob } from 'cron';\nimport { CronTask } from './CronTask';\n\nexport class CronTaskStore extends Store<CronTask, 'cron-tasks'> {\n\tpublic constructor() {\n\t\tsuper(CronTask, { name: 'cron-tasks' });\n\t}\n\n\t/**\n\t * Loops over all tasks and starts those that are enabled.\n\t * This gets called automatically when the Client is ready.\n\t * @returns CronTaskStore\n\t */\n\tpublic startAll() {\n\t\tfor (const task of this.values()) {\n\t\t\tif (!task.enabled) continue;\n\t\t\ttask.job.start();\n\t\t}\n\n\t\tStore.logger?.(`[STORE => ${this.name}] [START] Started all cronjob tasks.`);\n\t\treturn this;\n\t}\n\n\t/**\n\t * Loops over all tasks and stops those that are running.\n\t * @returns CronTaskStore\n\t */\n\tpublic stopAll() {\n\t\tfor (const task of this.values()) {\n\t\t\tif (!task.job.running) continue;\n\t\t\ttask.job.stop();\n\t\t}\n\n\t\tStore.logger?.(`[STORE => ${this.name}] [STOP] Stopped all cronjob tasks.`);\n\t\treturn this;\n\t}\n\n\tpublic override set(key: string, value: CronTask): this {\n\t\tconst { options } = value;\n\n\t\tconst { sentry, defaultTimezone } = this.container.cron;\n\t\tconst cronJob = sentry ? sentry.cron.instrumentCron(CronJob, key) : CronJob;\n\n\t\ttry {\n\t\t\tvalue.job = cronJob.from({\n\t\t\t\t...options,\n\t\t\t\tonTick: () => void value.run.bind(value)(),\n\t\t\t\tstart: false,\n\t\t\t\tcontext: value,\n\t\t\t\ttimeZone: options.timeZone ?? defaultTimezone\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tvalue.error('Encountered an error while creating the cron job', error);\n\t\t\tvoid value.unload();\n\t\t}\n\n\t\treturn super.set(key, value);\n\t}\n\n\tpublic override delete(key: string) {\n\t\tconst task = this.get(key);\n\t\tif (task?.job.running) {\n\t\t\ttask.job.stop();\n\t\t}\n\n\t\treturn super.delete(key);\n\t}\n\n\t/**\n\t * Stops all running cron jobs and clears the store.\n\t * @returns void\n\t */\n\tpublic override clear() {\n\t\tthis.stopAll();\n\t\treturn super.clear();\n\t}\n}\n"]}