@kingsworld/plugin-cron 3.0.1-next.e1b3c15 → 3.0.1

package/CHANGELOG.md

@@ -2,51 +2,85 @@
 
 All notable changes to this project will be documented in this file.
 
-# [@kingsworld/plugin-cron@3.0.0](https://github.com/Kings-World/sapphire-plugins/tree/@kingsworld/plugin-cron@3.0.0) - (2024-09-12)
+# [@kingsworld/plugin-cron@3.0.1](https://github.com/Kings-World/sapphire-plugins/compare/@kingsworld/plugin-cron@2.1.1...@kingsworld/plugin-cron@3.0.1) - (2025-04-07)
 
 ## 🏠 Refactor
 
-- Set option defaults and add more js docs ([179a2eb](https://github.com/Kings-World/sapphire-plugins/commit/179a2ebac74a3b2ded82500b8c8c6425f8af1e0f)) ([#35](https://github.com/Kings-World/sapphire-plugins/pull/35) by @SerenModz21)
-- Improve the repo ([3546f66](https://github.com/Kings-World/sapphire-plugins/commit/3546f669d767764b622310dbf679ca8c86abfea6)) ([#26](https://github.com/Kings-World/sapphire-plugins/pull/26) by @Swiizyy)
-- Switch to sapphire v5 changes ([3fcbf9e](https://github.com/Kings-World/sapphire-plugins/commit/3fcbf9ef0f541c4155875c38b406f5a1872f9de6))
+- **cron:** Replace the cron package with croner ([efd4ebb](https://github.com/Kings-World/sapphire-plugins/commit/efd4ebbd2e38f106bc322ffb962c5dcccb503c63)) ([#102](https://github.com/Kings-World/sapphire-plugins/pull/102) by @SerenModz21)
   - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
-- Update to sapphire v5 ([61e68a9](https://github.com/Kings-World/sapphire-plugins/commit/61e68a983eeb2d3c5334217930114a9cf08dafe7))
-- Switch to a monorepo ([7646fbb](https://github.com/Kings-World/sapphire-plugins/commit/7646fbb4ace71e7d3e939a29b89c72d213da36ce))
-  - 💥 **BREAKING CHANGE:** move to a monorepo
 
-## 🐛 Bug Fixes
+* refactor: replace cron with croner
+  - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
 
-- **cron:** Correct the cliff jumper org ([b7ee600](https://github.com/Kings-World/sapphire-plugins/commit/b7ee6007cca0d372edc27997268ec45db14304ac))
-- Use luxon's system default instead of utc ([b56bf6b](https://github.com/Kings-World/sapphire-plugins/commit/b56bf6b9889ddf3c46f069fdf93043f074a16462)) ([#38](https://github.com/Kings-World/sapphire-plugins/pull/38) by @SerenModz21)
-- Use the default export and actually register the hook ([5e271bf](https://github.com/Kings-World/sapphire-plugins/commit/5e271bfceb335be3e709831c9fad46c05f75b309))
-- Ensure cts file extensions in dist/cjs ([907123a](https://github.com/Kings-World/sapphire-plugins/commit/907123a017210d3acca81f3373cbe5a3c102261f))
-- Move readme ([e1c1f2d](https://github.com/Kings-World/sapphire-plugins/commit/e1c1f2d2b0a087489364db49b783de243af63244))
+* refactor: replace cron with croner
+  - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
 
-## 📝 Documentation
+* style: rename cron to cronTasks
+  - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
 
-- **cron:** Add public keyword for consistency ([7e098d9](https://github.com/Kings-World/sapphire-plugins/commit/7e098d99437ad4b671c4e559f3532ce33a51d5ee))
-- **cron:** Fix plugin name ([bea107d](https://github.com/Kings-World/sapphire-plugins/commit/bea107d72fdb86f42845bfa51cd02e8c6c8690a3))
-- **cron:** Improve readme ([ede60d2](https://github.com/Kings-World/sapphire-plugins/commit/ede60d209d13af296507407675543ad7c05c4410)) ([#27](https://github.com/Kings-World/sapphire-plugins/pull/27) by @Swiizyy)
-- Improve the readme ([784b306](https://github.com/Kings-World/sapphire-plugins/commit/784b306295c815bfc824b0143dd8b3f98a705afc))
-- Fix package misspelling in readme ([6106d42](https://github.com/Kings-World/sapphire-plugins/commit/6106d42f6c98f28e9abdec70628d128cbcffc5d1))
-- Update context type in readme ([be0102e](https://github.com/Kings-World/sapphire-plugins/commit/be0102e816d7c711d0d531cd96eb0f9b64bab794))
-- Fix the in spelling ([3f71cf9](https://github.com/Kings-World/sapphire-plugins/commit/3f71cf92f6c0b2c2d00fbe20ac35d362d9b84bb9))
-- Fix plugin spelling ([6b395bd](https://github.com/Kings-World/sapphire-plugins/commit/6b395bd82affef3ae0be9aeb2653cc5b31ca339d))
-- Fix incorrect word ([0149312](https://github.com/Kings-World/sapphire-plugins/commit/0149312285fd839ccbecd3f1f7ecfb39699ea97a))
-- Finish contributing section and update repo name ([7b73668](https://github.com/Kings-World/sapphire-plugins/commit/7b7366865a376cf2e070359342505606e531b737))
+* docs: update documentation
+  - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
+
+* refactor: use this.stores instead of container.stores
+  - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
+
+* feat: add protect and catch methods for additional logic
+  - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
+
+* refactor: normalize pattern for sentry and prevent dates or iso string from being monitored
+  - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
+
+* refactor: update version
+
+i accidentally publish 3.0.0 by accident when i was new to using cliff-jumper
+
+therefore, i have to skip that and go straight to 3.0.1
+  - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
+
+---------
+  - 💥 **BREAKING CHANGE:** The `cronTime` option has been replaced with `pattern`.
+  - 💥 **BREAKING CHANGE:** The `timeZone` option has been replaced with `timezone`.
+  - 💥 **BREAKING CHANGE:** The `cron` package has been replaced with `croner`.
+  - 💥 **BREAKING CHANGE:** `container.cron.startAll()` and `container.cron.stopAll()` have been removed. Instead, you should pause and resume using the plugin's store.
+  - 💥 **BREAKING CHANGE:** References to the word `cron` have been replaced with `cronTasks` for consistency. For example, `container.cron` is now `container.cronTasks` and `ClientOptions.cron` is now `ClientOptions.cronTasks`.
+  - 💥 **Signed-off-by:** Seren_Modz 21 <seren@kings-world.net>
+- Add the override keyword to the plugin methods ([a581de3](https://github.com/Kings-World/sapphire-plugins/commit/a581de3ae477d1f5fcff5e8376fb7c60fdae7daa))
+
+# [@kingsworld/plugin-cron@2.1.1](https://github.com/Kings-World/sapphire-plugins/compare/@kingsworld/plugin-cron@2.1.0...@kingsworld/plugin-cron@2.1.1) - (2025-04-05)
+
+## 🐛 Bug Fixes
+
+- **deps:** Update all non-major dependencies ([83f972e](https://github.com/Kings-World/sapphire-plugins/commit/83f972eda0f3db62cfab8916e5c444abc0247e10)) ([#97](https://github.com/Kings-World/sapphire-plugins/pull/97) by @renovate[bot])
+- **deps:** Update dependency cron to v4 ([1550eff](https://github.com/Kings-World/sapphire-plugins/commit/1550eff0705e5430281291aeb0fe18a830186915)) ([#91](https://github.com/Kings-World/sapphire-plugins/pull/91) by @renovate[bot])
+- **deps:** Update all non-major dependencies ([d5bd44f](https://github.com/Kings-World/sapphire-plugins/commit/d5bd44fbbe46d8aaa92b6157dccb9536debc66a0)) ([#80](https://github.com/Kings-World/sapphire-plugins/pull/80) by @renovate[bot])
+- **deps:** Update all non-major dependencies ([fab1c9f](https://github.com/Kings-World/sapphire-plugins/commit/fab1c9f661175bc9c2fdfc7d9ab3af59d16acc6f)) ([#79](https://github.com/Kings-World/sapphire-plugins/pull/79) by @renovate[bot])
+- **deps:** Update all non-major dependencies ([e44b9ef](https://github.com/Kings-World/sapphire-plugins/commit/e44b9efa5b164699dd4393188c38e6f3fdadcc3e)) ([#75](https://github.com/Kings-World/sapphire-plugins/pull/75) by @renovate[bot])
+
+# [@kingsworld/plugin-cron@2.1.0](https://github.com/Kings-World/sapphire-plugins/compare/@kingsworld/plugin-cron@2.0.3...@kingsworld/plugin-cron@2.1.0) - (2024-10-03)
 
 ## 🚀 Features
 
-- Allow disabling sentry instrumention and import automatically ([935821f](https://github.com/Kings-World/sapphire-plugins/commit/935821f4ed990ef97c3beb58901dbe96281da020))
-- Add optional support for sentry's cron & add jsdoc ([555b5ae](https://github.com/Kings-World/sapphire-plugins/commit/555b5ae47535b06f5730dacdf041d38b01deda52))
-- Update dependencies and release 1.1.0 ([b1aead8](https://github.com/Kings-World/sapphire-plugins/commit/b1aead83ba6ebd781c4bde554a8a3a459f6415c9))
+- Format luxon timezones to their tz identifier ([47cb7ef](https://github.com/Kings-World/sapphire-plugins/commit/47cb7ef6970ae6255fe068f2f5cec1ace1ed8109)) ([#49](https://github.com/Kings-World/sapphire-plugins/pull/49) by @SerenModz21)
 
-## 🪞 Styling
+# [@kingsworld/plugin-cron@2.0.3](https://github.com/Kings-World/sapphire-plugins/compare/@kingsworld/plugin-cron@2.0.2...@kingsworld/plugin-cron@2.0.3) - (2024-09-27)
 
-- Format readme ([7b1c49f](https://github.com/Kings-World/sapphire-plugins/commit/7b1c49fbfaa85f45264f3028da663fcfb87ef826))
-- Format everything ([e7ba3e2](https://github.com/Kings-World/sapphire-plugins/commit/e7ba3e2810e80382c4bf4e95e8fdc3d3868aab95))
+## 🐛 Bug Fixes
+
+- **cron:** Correctly handle the sentry import ([c596f64](https://github.com/Kings-World/sapphire-plugins/commit/c596f64b2ae233ad2be5e02d3c68aa30329c88ce)) ([#47](https://github.com/Kings-World/sapphire-plugins/pull/47) by @SerenModz21)
 
-# [@Kings-World/plugin-cron@2.0.0](https://github.com/Kings-World/sapphire-plugins/tree/@Kings-World/plugin-cron@2.0.0) - (2024-09-12)
+# [@kingsworld/plugin-cron@2.0.2](https://github.com/Kings-World/sapphire-plugins/compare/@kingsworld/plugin-cron@2.0.1...@kingsworld/plugin-cron@2.0.2) - (2024-09-15)
+
+## 🐛 Bug Fixes
+
+- The ClientOptions#cron also needs to be partial ([f31d23a](https://github.com/Kings-World/sapphire-plugins/commit/f31d23a39187b2fc901c9d83723efafcd6942b4d)) ([#44](https://github.com/Kings-World/sapphire-plugins/pull/44) by @SerenModz21)
+
+# [@kingsworld/plugin-cron@2.0.1](https://github.com/Kings-World/sapphire-plugins/compare/@kingsworld/plugin-cron@2.0.0...@kingsworld/plugin-cron@2.0.1) - (2024-09-15)
+
+## 🐛 Bug Fixes
+
+- Use the partial helper to make options optional ([fa10a8a](https://github.com/Kings-World/sapphire-plugins/commit/fa10a8a072354362a5816323b5c66ff6ace97b9d)) ([#43](https://github.com/Kings-World/sapphire-plugins/pull/43) by @SerenModz21)
+
+# [@kingsworld/plugin-cron@2.0.0](https://github.com/Kings-World/sapphire-plugins/tree/@kingsworld/plugin-cron@2.0.0) - (2024-09-12)
 
 ## 🏠 Refactor
 
@@ -60,6 +94,7 @@ All notable changes to this project will be documented in this file.
 
 ## 🐛 Bug Fixes
 
+- **cron:** Correct the cliff jumper org ([b7ee600](https://github.com/Kings-World/sapphire-plugins/commit/b7ee6007cca0d372edc27997268ec45db14304ac))
 - Use luxon's system default instead of utc ([b56bf6b](https://github.com/Kings-World/sapphire-plugins/commit/b56bf6b9889ddf3c46f069fdf93043f074a16462)) ([#38](https://github.com/Kings-World/sapphire-plugins/pull/38) by @SerenModz21)
 - Use the default export and actually register the hook ([5e271bf](https://github.com/Kings-World/sapphire-plugins/commit/5e271bfceb335be3e709831c9fad46c05f75b309))
 - Ensure cts file extensions in dist/cjs ([907123a](https://github.com/Kings-World/sapphire-plugins/commit/907123a017210d3acca81f3373cbe5a3c102261f))

package/README.md

@@ -2,7 +2,7 @@
 
 # @kingsworld/plugin-cron
 
-**Plugin for <a href="https://github.com/sapphiredev/framework">@sapphire/framework</a> to add support for cron tasks using <a href="https://github.com/kelektiv/node-cron">cron</a>.**
+**Plugin for <a href="https://github.com/sapphiredev/framework">@sapphire/framework</a> to add support for cron tasks using <a href="https://github.com/Hexagon/croner">croner</a>.**
 
 [![GitHub](https://img.shields.io/github/license/Kings-World/sapphire-plugins)](https://github.com/Kings-World/sapphire-plugins/blob/main/LICENSE.md)
 [![npm bundle size](https://pkg-size.dev/badge/bundle/83411)](https://pkg-size.dev/@kingsworld/plugin-cron)
@@ -16,14 +16,14 @@ This plugin adds support for cron tasks to the Sapphire framework. It uses the [
 
 ## Features
 
--   Full TypeScript support
--   Includes ESM entrypoint
+- Full TypeScript support
+- Includes ESM entrypoint
 
 ## Installation
 
 `@kingsworld/plugin-cron` depends on the following packages. Be sure to install these along with this package!
 
--   [`@sapphire/framework`](https://www.npmjs.com/package/@sapphire/framework)
+- [`@sapphire/framework`](https://www.npmjs.com/package/@sapphire/framework)
 
 You can use the following command to install this package along with `cron`, or replace `npm install` with your package manager of choice.
 
@@ -46,7 +46,7 @@ Then, you can configure the plugin in the configuration options in your Sapphire
 ```ts
 const options = {
 	...otherClientOptionsGoHere,
-	cron: {
+	cronTasks: {
 		/**
 		 * Whether to disable Sentry cron monitoring
 		 * @default false
@@ -54,39 +54,47 @@ const options = {
 		disableSentry: false,
 		/**
 		 * The timezone to use for the cron tasks
-		 * @default 'system'
+		 * @default undefined
 		 */
 		defaultTimezone: 'Europe/London'
 	}
 };
 ```
 
--   The `disableSentry` option is used to disable Sentry's cron monitoring. By default, it is set to `false`, which means Sentry cron monitoring is enabled if the `@sentry/node` package is installed and configured. This makes using Sentry an opt-in feature - you first opt in by installing `@sentry/node`. The `disableSentry` option then allows you to opt out in specific situations. You can set this to `true` to disable cron monitoring, which can be useful during development or if you haven't provided a Sentry DSN. If you don't use Sentry at all (i.e., `@sentry/node` is not installed), this option has no effect and can be safely ignored.
+- The `disableSentry` option is used to disable Sentry's cron monitoring. By default, it is set to `false`, which means Sentry cron monitoring is enabled if the `@sentry/node` package is installed and configured. This makes using Sentry an opt-in feature - you first opt in by installing `@sentry/node`. The `disableSentry` option then allows you to opt out in specific situations. You can set this to `true` to disable cron monitoring, which can be useful during development or if you haven't provided a Sentry DSN. If you don't use Sentry at all (i.e., `@sentry/node` is not installed), this option has no effect and can be safely ignored.
 
-In order to use the cron tasks anywhere other than a piece (commands, arguments, preconditions, etc.), you must first import the `container` property of `@sapphire/framework`. For pieces, you can simply use `this.container.cron` to access this plugin's methods.
+In order to use the cron tasks anywhere other than a piece (commands, arguments, preconditions, etc.), you must first import the `container` property of `@sapphire/framework`. From there, you can access the store.
 
-This is a simple example of how to start a task from a service.
+This is a simple example of how to pause and resume a task from a service.
 
 ```typescript
 import { container } from '@sapphire/framework';
 
 export class MyAwesomeService {
 	public createAwesomeTask() {
-		const task = container.cron.store.get('my-awesome-task');
+		const task = container.stores.get('cron-tasks').get('my-awesome-task');
 
-		task.job.start();
+		// To pause the task:
+		task.job.pause();
+
+		// To resume the task:
+		task.job.resume();
 	}
 }
 ```
 
-This is a simple example of how to start all tasks from a service.
+This is a simple example of how to pause or resume all tasks from a service.
 
 ```typescript
 import { container } from '@sapphire/framework';
 
 export class MyAwesomeService {
 	public createAwesomeTask() {
-		container.cron.startAll();
+		// To pause all tasks:
+		container.stores.get('cron-tasks').pauseAll();
+
+		// To resume all tasks:
+		container.stores.get('cron-tasks').resumeAll();
 	}
 }
 ```
@@ -106,7 +114,7 @@ export class PingPong extends CronTask {
 	public constructor(context: CronTask.LoaderContext, options: CronTask.Options) {
 		super(context, {
 			...options,
-			cronTime: '* * * * *'
+			pattern: '* * * * *'
 		});
 	}
 
@@ -129,7 +137,7 @@ export class PingPong extends CronTask {
 	public constructor(context: CronTask.LoaderContext, options: CronTask.Options) {
 		super(context, {
 			...options,
-			cronTime: '* * * * *'
+			pattern: '* * * * *'
 		});
 	}
 

package/dist/cjs/index.cjs

@@ -6,7 +6,7 @@ var CronTaskStore_cjs = require('./lib/structures/CronTaskStore.cjs');
 var CronTaskTypes_cjs = require('./lib/types/CronTaskTypes.cjs');
 
 // src/index.ts
-var version = "3.0.1-next.e1b3c15";
+var version = "3.0.1";
 
 exports.version = version;
 Object.keys(CronTaskHandler_cjs).forEach(function (k) {

package/dist/cjs/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;AA+BO,IAAM,OAAkB,GAAA","file":"index.cjs","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 = '3.0.1-next.e1b3c15';\n"]}
+{"version":3,"sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;AA+BO,IAAM,OAAkB,GAAA","file":"index.cjs","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\tcronTasks: 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\tcronTasks?: Partial<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 = '3.0.1';\n"]}

package/dist/cjs/index.d.cts

@@ -1,16 +1,14 @@
 import { Piece, Store } from '@sapphire/pieces';
 import { Awaitable } from '@sapphire/framework';
-import { CronJobParams, CronJob } from 'cron';
+import { CronOptions, Cron } from 'croner';
 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
-     * @default 'system'
+     * The default IANA timezone to use for all cron jobs.
+     * You can override this per task, using the timezone option.
      */
-    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.
@@ -19,7 +17,15 @@ interface CronTaskHandlerOptions {
      */
     disableSentry: boolean;
 }
-type CronJobOptions = Omit<CronJobParams<null, CronTask>, 'onTick' | 'onComplete' | 'start' | 'context' | 'utcOffset'>;
+interface CronJobOptions extends Pick<CronOptions, 'maxRuns' | 'unref' | 'timezone'> {
+    pattern: string | Date;
+    /**
+     * If true, prevents the job from running if the previous execution is still in progress.
+     * If the task has a protect method, it will be called if the job is blocked.
+     * @default false
+     */
+    protect?: boolean;
+}
 
 /**
  * @example
@@ -32,7 +38,7 @@ type CronJobOptions = Omit<CronJobParams<null, CronTask>, 'onTick' | 'onComplete
  * 	public constructor(context: CronTask.LoaderContext, options: CronTask.Options) {
  * 		super(context, {
  * 			...options,
- * 			cronTime: '* * * * *'
+ * 			pattern: '* * * * *'
  * 		});
  * 	}
  *
@@ -43,9 +49,11 @@ type CronJobOptions = Omit<CronJobParams<null, CronTask>, 'onTick' | 'onComplete
  * ```
  */
 declare abstract class CronTask<Options extends CronTask.Options = CronTask.Options> extends Piece<Options, 'cron-tasks'> {
-    job: CronJob<null, CronTask>;
+    job: Cron;
     constructor(context: CronTask.LoaderContext, options: Options);
     abstract run(): Awaitable<unknown>;
+    abstract protect?(job: Cron): Awaitable<unknown>;
+    abstract catch?(error: unknown, job: Cron): Awaitable<unknown>;
     /**
      * A helper function to log messages with the `CronTask[${name}]` prefix.
      * @param message The message to include after the prefix
@@ -97,33 +105,60 @@ declare namespace CronTask {
 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.
+     * Loops over all tasks and pauses those that are running.
+     *
+     * @remarks
+     * This method will only pause tasks that:
+     * - Are enabled
+     * - Are currently running
+     * - Have not been permanently stopped
+     *
      * @returns CronTaskStore
      */
-    startAll(): this;
+    pauseAll(): this;
+    /**
+     * Loops over all tasks and resumes those that are paused.
+     *
+     * @remarks
+     * This method will only resume tasks that:
+     * - Are enabled
+     * - Are not currently running
+     * - Have not been permanently stopped
+     *
+     * @returns CronTaskStore
+     */
+    resumeAll(): this;
     /**
      * Loops over all tasks and stops those that are running.
+     *
+     * @remarks
+     * This method will only stop tasks that:
+     * - Are enabled
+     * - Have not been permanently stopped
+     *
+     * ⚠️ Stopping jobs is **permanent** and cannot be resumed afterwards!
+     *
      * @returns CronTaskStore
      */
     stopAll(): this;
     set(key: string, value: CronTask): this;
+    /**
+     * Deletes a task from the store and stops it if it's running.
+     */
     delete(key: string): boolean;
     /**
      * Stops all running cron jobs and clears the store.
-     * @returns void
      */
     clear(): void;
 }
 
 declare class CronTaskHandler {
     /**
-     * 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
-     * @default 'system'
+     * The default IANA/TZ timezone to use for all cron jobs.
+     * You can override this per task, using the timezone option.
+     * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
      */
-    defaultTimezone: CronTaskHandlerOptions['defaultTimezone'];
+    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.
@@ -137,25 +172,12 @@ declare class CronTaskHandler {
      * 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();
+    constructor(options?: Partial<CronTaskHandlerOptions>);
 }
 
 declare module '@sapphire/pieces' {
     interface Container {
-        cron: CronTaskHandler;
+        cronTasks: CronTaskHandler;
     }
     interface StoreRegistryEntries {
         'cron-tasks': CronTaskStore;
@@ -163,7 +185,7 @@ declare module '@sapphire/pieces' {
 }
 declare module 'discord.js' {
     interface ClientOptions {
-        cron?: CronTaskHandlerOptions;
+        cronTasks?: Partial<CronTaskHandlerOptions>;
     }
 }
 /**
@@ -174,4 +196,5 @@ declare module 'discord.js' {
  */
 declare const version: string;
 
-export { type CronJobOptions, CronTask, CronTaskHandler, type CronTaskHandlerOptions, CronTaskStore, version };
+export { CronTask, CronTaskHandler, CronTaskStore, version };
+export type { CronJobOptions, CronTaskHandlerOptions };

package/dist/cjs/lib/CronTaskHandler.cjs

@@ -1,18 +1,17 @@
 'use strict';
 
-var framework = require('@sapphire/framework');
-
 var __defProp = Object.defineProperty;
 var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/lib/CronTaskHandler.ts
 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
-     * @default 'system'
+     * The default IANA/TZ timezone to use for all cron jobs.
+     * You can override this per task, using the timezone option.
+     * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
      */
     __publicField(this, "defaultTimezone");
     /**
@@ -28,28 +27,9 @@ var _CronTaskHandler = class _CronTaskHandler {
      * is installed and the {@linkcode disableSentry} option is set to false.
      */
     __publicField(this, "sentry");
-    this.defaultTimezone = options?.defaultTimezone ?? "system";
+    this.defaultTimezone = options?.defaultTimezone;
     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 framework.container.stores.get("cron-tasks");
-  }
 };
 __name(_CronTaskHandler, "CronTaskHandler");
 var CronTaskHandler = _CronTaskHandler;

package/dist/cjs/lib/CronTaskHandler.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/lib/CronTaskHandler.ts"],"names":["container"],"mappings":";;;;;;;;AAIO,IAAM,gBAAA,GAAN,MAAM,gBAAgB,CAAA;AAAA,EAwBrB,YAAY,OAAkC,EAAA;AAjBrD;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,QAAA,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,OAAAA,mBAAA,CAAU,MAAO,CAAA,GAAA,CAAI,YAAY,CAAA,CAAA;AAAA,GACzC;AACD,CAAA,CAAA;AAlD6B,MAAA,CAAA,gBAAA,EAAA,iBAAA,CAAA,CAAA;AAAtB,IAAM,eAAN,GAAA","file":"CronTaskHandler.cjs","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 * @default 'system'\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 ?? 'system';\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"]}
+{"version":3,"sources":["../../../src/lib/CronTaskHandler.ts"],"names":[],"mappings":";;;;;;;;AAGO,IAAM,gBAAA,GAAN,MAAM,gBAAgB,CAAA;AAAA,EAuBrB,YAAY,OAA2C,EAAA;AAjB9D;AAAA;AAAA;AAAA;AAAA;AAAA,IAAO,aAAA,CAAA,IAAA,EAAA,iBAAA,CAAA;AAQP;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAO,aAAA,CAAA,IAAA,EAAA,eAAA,CAAA;AAOP;AAAA;AAAA;AAAA;AAAA;AAAA,IAAO,aAAA,CAAA,IAAA,EAAA,QAAA,CAAA;AAGN,IAAA,IAAA,CAAK,kBAAkB,OAAS,EAAA,eAAA;AAChC,IAAK,IAAA,CAAA,aAAA,GAAgB,SAAS,aAAiB,IAAA,KAAA;AAAA;AAEjD,CAAA;AA3B6B,MAAA,CAAA,gBAAA,EAAA,iBAAA,CAAA;AAAtB,IAAM,eAAN,GAAA","file":"CronTaskHandler.cjs","sourcesContent":["import type Sentry from '@sentry/node';\nimport type { CronTaskHandlerOptions } from './types/CronTaskTypes';\n\nexport class CronTaskHandler {\n\t/**\n\t * The default IANA/TZ timezone to use for all cron jobs.\n\t * You can override this per task, using the timezone option.\n\t * @see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones\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?: Partial<CronTaskHandlerOptions>) {\n\t\tthis.defaultTimezone = options?.defaultTimezone;\n\t\tthis.disableSentry = options?.disableSentry ?? false;\n\t}\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"sources":["../../../../src/lib/structures/CronTask.ts"],"names":["Piece"],"mappings":";;;;;;AA0BO,IAAe,SAAA,GAAf,MAAe,SAAA,SAAsEA,YAA6B,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.cjs","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"]}
+{"version":3,"sources":["../../../../src/lib/structures/CronTask.ts"],"names":["Piece"],"mappings":";;;;;;AA0BO,IAAe,SAAA,GAAf,MAAe,SAAA,SAAsEA,YAA6B,CAAA;AAAA,EAGjH,WAAA,CAAY,SAAiC,OAAkB,EAAA;AACrE,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AAAA;AACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeO,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;AAAA;AACzE;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;AAAA;AAC1E;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;AAAA;AACzE;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;AAAA;AAC1E;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;AAAA;AAE3E,CAAA;AAnEyH,MAAA,CAAA,SAAA,EAAA,UAAA,CAAA;AAAlH,IAAe,QAAf,GAAA","file":"CronTask.cjs","sourcesContent":["import type { Awaitable } from '@sapphire/framework';\nimport { Piece } from '@sapphire/pieces';\nimport type { Cron } from 'croner';\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\tpattern: '* * * * *'\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\tdeclare public job: Cron;\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\tpublic abstract protect?(job: Cron): Awaitable<unknown>;\n\n\tpublic abstract catch?(error: unknown, job: Cron): 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"]}