@commandkit/tasks 0.0.0-dev.20250724145623

package/dist/driver-manager.js

@@ -0,0 +1,154 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskDriverManager = exports.TaskDriverManager = void 0;
+exports.setDriver = setDriver;
+exports.createTask = createTask;
+exports.deleteTask = deleteTask;
+/**
+ * Manages the active task driver and provides a unified interface for task operations.
+ *
+ * This class acts as a facade for the underlying task driver, providing methods
+ * to create, delete, and manage tasks. It ensures that a driver is set before
+ * any operations are performed.
+ *
+ * @example
+ * ```ts
+ * import { TaskDriverManager } from '@commandkit/tasks';
+ * import { HyperCronDriver } from '@commandkit/tasks/hypercron';
+ *
+ * const manager = new TaskDriverManager();
+ * manager.setDriver(new HyperCronDriver());
+ *
+ * // Now you can create and manage tasks
+ * const taskId = await manager.createTask({
+ *   name: 'my-task',
+ *   data: { userId: '123' },
+ *   schedule: { type: 'date', value: Date.now() + 60000 },
+ * });
+ * ```
+ */
+class TaskDriverManager {
+    constructor() {
+        this.driver = null;
+    }
+    /**
+     * Sets the active task driver.
+     *
+     * This method must be called before any task operations can be performed.
+     * The driver handles all scheduling, persistence, and execution timing.
+     *
+     * @param driver - The task driver to use for all operations
+     */
+    setDriver(driver) {
+        this.driver = driver;
+    }
+    /**
+     * Creates a new scheduled task.
+     *
+     * This method delegates to the active driver to schedule the task according
+     * to its configuration. The task will be executed when its schedule is due.
+     *
+     * @param task - The task data containing name, schedule, and custom data
+     * @returns A unique identifier for the created task
+     * @throws {Error} If no driver has been set
+     */
+    async createTask(task) {
+        if (!this.driver)
+            throw new Error('Task driver has not been set');
+        return await this.driver.create(task);
+    }
+    /**
+     * Deletes a scheduled task by its identifier.
+     *
+     * This method delegates to the active driver to remove the task from the
+     * scheduling system and cancel any pending executions.
+     *
+     * @param identifier - The unique identifier of the task to delete
+     * @throws {Error} If no driver has been set
+     */
+    async deleteTask(identifier) {
+        if (!this.driver)
+            throw new Error('Task driver has not been set');
+        await this.driver.delete(identifier);
+    }
+    /**
+     * Sets the task execution runner function.
+     *
+     * This method delegates to the active driver to set up the execution handler
+     * that will be called when tasks are due to run.
+     *
+     * @param runner - The function to call when a task should be executed
+     * @throws {Error} If no driver has been set
+     */
+    async setTaskRunner(runner) {
+        if (!this.driver)
+            throw new Error('Task driver has not been set');
+        await this.driver.setTaskRunner(runner);
+    }
+}
+exports.TaskDriverManager = TaskDriverManager;
+/**
+ * Global task driver manager instance.
+ *
+ * This is the default instance used by the tasks plugin for managing task operations.
+ * You can use this instance directly or create your own TaskDriverManager instance.
+ */
+exports.taskDriverManager = new TaskDriverManager();
+/**
+ * Sets the global task driver.
+ *
+ * This is a convenience function that sets the driver on the global task driver manager.
+ *
+ * @param driver - The task driver to use for all operations
+ *
+ * @example
+ * ```ts
+ * import { setDriver } from '@commandkit/tasks';
+ * import { HyperCronDriver } from '@commandkit/tasks/hypercron';
+ *
+ * setDriver(new HyperCronDriver());
+ * ```
+ */
+function setDriver(driver) {
+    exports.taskDriverManager.setDriver(driver);
+}
+/**
+ * Creates a new scheduled task using the global driver manager.
+ *
+ * This is a convenience function that creates a task using the global task driver manager.
+ *
+ * @param task - The task data containing name, schedule, and custom data
+ * @returns A unique identifier for the created task
+ *
+ * @example
+ * ```ts
+ * import { createTask } from '@commandkit/tasks';
+ *
+ * const taskId = await createTask({
+ *   name: 'reminder',
+ *   data: { userId: '123', message: 'Hello!' },
+ *   schedule: { type: 'date', value: Date.now() + 60000 },
+ * });
+ * ```
+ */
+function createTask(task) {
+    return exports.taskDriverManager.createTask(task);
+}
+/**
+ * Deletes a scheduled task using the global driver manager.
+ *
+ * This is a convenience function that deletes a task using the global task driver manager.
+ *
+ * @param identifier - The unique identifier of the task to delete
+ *
+ * @example
+ * ```ts
+ * import { deleteTask } from '@commandkit/tasks';
+ *
+ * await deleteTask('task-123');
+ * ```
+ */
+function deleteTask(identifier) {
+    return exports.taskDriverManager.deleteTask(identifier);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZHJpdmVyLW1hbmFnZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZHJpdmVyLW1hbmFnZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBK0dBLDhCQUVDO0FBcUJELGdDQUVDO0FBZ0JELGdDQUVDO0FBdkpEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBc0JHO0FBQ0gsTUFBYSxpQkFBaUI7SUFBOUI7UUFDVSxXQUFNLEdBQXNCLElBQUksQ0FBQztJQTJEM0MsQ0FBQztJQXpEQzs7Ozs7OztPQU9HO0lBQ0ksU0FBUyxDQUFDLE1BQWtCO1FBQ2pDLElBQUksQ0FBQyxNQUFNLEdBQUcsTUFBTSxDQUFDO0lBQ3ZCLENBQUM7SUFFRDs7Ozs7Ozs7O09BU0c7SUFDSSxLQUFLLENBQUMsVUFBVSxDQUFDLElBQWM7UUFDcEMsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyw4QkFBOEIsQ0FBQyxDQUFDO1FBRWxFLE9BQU8sTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN4QyxDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSSxLQUFLLENBQUMsVUFBVSxDQUFDLFVBQWtCO1FBQ3hDLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTTtZQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsOEJBQThCLENBQUMsQ0FBQztRQUVsRSxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBQ3ZDLENBQUM7SUFFRDs7Ozs7Ozs7T0FRRztJQUNJLEtBQUssQ0FBQyxhQUFhLENBQUMsTUFBa0I7UUFDM0MsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyw4QkFBOEIsQ0FBQyxDQUFDO1FBRWxFLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDMUMsQ0FBQztDQUNGO0FBNURELDhDQTREQztBQUVEOzs7OztHQUtHO0FBQ1UsUUFBQSxpQkFBaUIsR0FBRyxJQUFJLGlCQUFpQixFQUFFLENBQUM7QUFFekQ7Ozs7Ozs7Ozs7Ozs7O0dBY0c7QUFDSCxTQUFnQixTQUFTLENBQUMsTUFBa0I7SUFDMUMseUJBQWlCLENBQUMsU0FBUyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQ3RDLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBa0JHO0FBQ0gsU0FBZ0IsVUFBVSxDQUFDLElBQWM7SUFDdkMsT0FBTyx5QkFBaUIsQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDNUMsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxTQUFnQixVQUFVLENBQUMsVUFBa0I7SUFDM0MsT0FBTyx5QkFBaUIsQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLENBQUM7QUFDbEQsQ0FBQyJ9

package/dist/driver.d.ts

@@ -0,0 +1,74 @@
+import { TaskData, TaskExecutionData } from './types';
+/**
+ * Interface for task persistence and scheduling drivers.
+ *
+ * Drivers handle the actual scheduling, persistence, and execution timing of tasks.
+ * Different drivers can provide different persistence mechanisms (in-memory, database, etc.)
+ * and scheduling capabilities.
+ *
+ * @example
+ * ```ts
+ * import { TaskDriver } from '@commandkit/tasks';
+ *
+ * class CustomDriver implements TaskDriver {
+ *   async create(task: TaskData): Promise<string> {
+ *     // Schedule the task in your system
+ *     const id = await this.scheduler.schedule(task);
+ *     return id;
+ *   }
+ *
+ *   async delete(task: string): Promise<void> {
+ *     // Remove the task from your system
+ *     await this.scheduler.cancel(task);
+ *   }
+ *
+ *   async setTaskRunner(runner: TaskRunner): Promise<void> {
+ *     // Set up the execution handler
+ *     this.runner = runner;
+ *   }
+ * }
+ * ```
+ */
+export interface TaskDriver {
+    /**
+     * Creates a new scheduled task.
+     *
+     * This method should schedule the task according to its schedule configuration
+     * and return a unique identifier that can be used to delete the task later.
+     * Multiple tasks may be created with the same name.
+     *
+     * @param task - The task data containing name, schedule, and custom data
+     * @returns A unique identifier for the created task
+     */
+    create(task: TaskData): Promise<string>;
+    /**
+     * Deletes a scheduled task by its identifier.
+     *
+     * This method should remove the task from the scheduling system and cancel
+     * any pending executions. If the task doesn't exist, this method should
+     * complete successfully without throwing an error.
+     *
+     * @param task - The unique identifier of the task to delete
+     */
+    delete(task: string): Promise<void>;
+    /**
+     * Sets the task execution runner function.
+     *
+     * This method should store the provided runner function and call it whenever
+     * a task is due for execution. The runner function receives the task execution
+     * data and should handle any errors that occur during execution.
+     *
+     * @param runner - The function to call when a task should be executed
+     */
+    setTaskRunner(runner: TaskRunner): Promise<void>;
+}
+/**
+ * Function type for executing tasks.
+ *
+ * This function is called by the driver when a task is scheduled to run.
+ * It receives the task execution data and should handle the actual execution
+ * of the task logic.
+ *
+ * @param task - The task execution data containing name, custom data, and timestamp
+ */
+export type TaskRunner = (task: TaskExecutionData) => Promise<void>;

package/dist/driver.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZHJpdmVyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2RyaXZlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist/drivers/bullmq.d.ts

@@ -0,0 +1,77 @@
+import { TaskDriver, TaskRunner } from '../driver';
+import { ConnectionOptions, Queue, Worker } from 'bullmq';
+import { TaskData } from '../types';
+/**
+ * BullMQ-based task driver for distributed task scheduling.
+ *
+ * This driver uses BullMQ to provide robust, distributed task scheduling with Redis
+ * as the backend. It supports both cron expressions and date-based scheduling, with
+ * built-in retry mechanisms and job persistence.
+ *
+ * **Requirements**: Requires the `bullmq` package to be installed.
+ *
+ * @example
+ * ```ts
+ * import { BullMQDriver } from '@commandkit/tasks/bullmq';
+ * import { setDriver } from '@commandkit/tasks';
+ *
+ * const driver = new BullMQDriver({
+ *   host: 'localhost',
+ *   port: 6379,
+ * }, 'my-tasks-queue');
+ *
+ * setDriver(driver);
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With custom Redis connection options
+ * const driver = new BullMQDriver({
+ *   host: 'redis.example.com',
+ *   port: 6379,
+ *   password: 'your-password',
+ *   tls: true,
+ * });
+ * ```
+ */
+export declare class BullMQDriver implements TaskDriver {
+    private readonly queueName;
+    private runner;
+    /** The BullMQ queue instance for managing tasks */
+    readonly queue: Queue;
+    /** The BullMQ worker instance for processing tasks */
+    readonly worker: Worker;
+    /**
+     * Creates a new BullMQ driver instance.
+     *
+     * @param connection - Redis connection options for BullMQ
+     * @param queueName - Optional queue name, defaults to 'commandkit-tasks'
+     */
+    constructor(connection: ConnectionOptions, queueName?: string);
+    /**
+     * Creates a new scheduled task in BullMQ.
+     *
+     * For cron tasks, this creates a repeating job with the specified cron pattern.
+     * For date tasks, this creates a delayed job that executes at the specified time.
+     *
+     * @param task - The task data containing name, schedule, and custom data
+     * @returns A unique job identifier
+     */
+    create(task: TaskData): Promise<string>;
+    /**
+     * Deletes a scheduled task from BullMQ.
+     *
+     * This removes the job and all its children (for repeating jobs) from the queue.
+     *
+     * @param identifier - The job identifier to delete
+     */
+    delete(identifier: string): Promise<void>;
+    /**
+     * Sets the task execution runner function.
+     *
+     * This function will be called by the BullMQ worker when a job is due for execution.
+     *
+     * @param runner - The function to call when a task should be executed
+     */
+    setTaskRunner(runner: TaskRunner): Promise<void>;
+}

package/dist/drivers/bullmq.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BullMQDriver = void 0;
+const bullmq_1 = require("bullmq");
+/**
+ * BullMQ-based task driver for distributed task scheduling.
+ *
+ * This driver uses BullMQ to provide robust, distributed task scheduling with Redis
+ * as the backend. It supports both cron expressions and date-based scheduling, with
+ * built-in retry mechanisms and job persistence.
+ *
+ * **Requirements**: Requires the `bullmq` package to be installed.
+ *
+ * @example
+ * ```ts
+ * import { BullMQDriver } from '@commandkit/tasks/bullmq';
+ * import { setDriver } from '@commandkit/tasks';
+ *
+ * const driver = new BullMQDriver({
+ *   host: 'localhost',
+ *   port: 6379,
+ * }, 'my-tasks-queue');
+ *
+ * setDriver(driver);
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With custom Redis connection options
+ * const driver = new BullMQDriver({
+ *   host: 'redis.example.com',
+ *   port: 6379,
+ *   password: 'your-password',
+ *   tls: true,
+ * });
+ * ```
+ */
+class BullMQDriver {
+    /**
+     * Creates a new BullMQ driver instance.
+     *
+     * @param connection - Redis connection options for BullMQ
+     * @param queueName - Optional queue name, defaults to 'commandkit-tasks'
+     */
+    constructor(connection, queueName = 'commandkit-tasks') {
+        this.queueName = queueName;
+        this.runner = null;
+        this.queue = new bullmq_1.Queue(this.queueName, { connection });
+        this.worker = new bullmq_1.Worker(this.queueName, async (job) => {
+            if (!this.runner)
+                throw new Error('Task runner has not been set');
+            await this.runner({
+                name: job.name,
+                data: job.data,
+                timestamp: job.timestamp,
+            });
+        }, { connection });
+    }
+    /**
+     * Creates a new scheduled task in BullMQ.
+     *
+     * For cron tasks, this creates a repeating job with the specified cron pattern.
+     * For date tasks, this creates a delayed job that executes at the specified time.
+     *
+     * @param task - The task data containing name, schedule, and custom data
+     * @returns A unique job identifier
+     */
+    async create(task) {
+        const jobId = crypto.randomUUID();
+        const job = await this.queue.add(task.name, task.data, {
+            jobId,
+            ...(task.schedule.type === 'cron'
+                ? {
+                    repeat: {
+                        pattern: task.schedule.value,
+                        tz: task.schedule.timezone,
+                        immediately: !!task.immediate,
+                    },
+                }
+                : {
+                    delay: (task.schedule.value instanceof Date
+                        ? task.schedule.value.getTime()
+                        : task.schedule.value) - Date.now(),
+                }),
+        });
+        return job.id ?? jobId;
+    }
+    /**
+     * Deletes a scheduled task from BullMQ.
+     *
+     * This removes the job and all its children (for repeating jobs) from the queue.
+     *
+     * @param identifier - The job identifier to delete
+     */
+    async delete(identifier) {
+        await this.queue.remove(identifier, { removeChildren: true });
+    }
+    /**
+     * Sets the task execution runner function.
+     *
+     * This function will be called by the BullMQ worker when a job is due for execution.
+     *
+     * @param runner - The function to call when a task should be executed
+     */
+    async setTaskRunner(runner) {
+        this.runner = runner;
+    }
+}
+exports.BullMQDriver = BullMQDriver;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVsbG1xLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2RyaXZlcnMvYnVsbG1xLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLG1DQUEwRDtBQUcxRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQ0c7QUFDSCxNQUFhLFlBQVk7SUFTdkI7Ozs7O09BS0c7SUFDSCxZQUNFLFVBQTZCLEVBQ1osWUFBb0Isa0JBQWtCO1FBQXRDLGNBQVMsR0FBVCxTQUFTLENBQTZCO1FBaEJqRCxXQUFNLEdBQXNCLElBQUksQ0FBQztRQWtCdkMsSUFBSSxDQUFDLEtBQUssR0FBRyxJQUFJLGNBQUssQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLEVBQUUsVUFBVSxFQUFFLENBQUMsQ0FBQztRQUN2RCxJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksZUFBTSxDQUN0QixJQUFJLENBQUMsU0FBUyxFQUNkLEtBQUssRUFBRSxHQUFHLEVBQUUsRUFBRTtZQUNaLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTTtnQkFBRSxNQUFNLElBQUksS0FBSyxDQUFDLDhCQUE4QixDQUFDLENBQUM7WUFFbEUsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDO2dCQUNoQixJQUFJLEVBQUUsR0FBRyxDQUFDLElBQUk7Z0JBQ2QsSUFBSSxFQUFFLEdBQUcsQ0FBQyxJQUFJO2dCQUNkLFNBQVMsRUFBRSxHQUFHLENBQUMsU0FBUzthQUN6QixDQUFDLENBQUM7UUFDTCxDQUFDLEVBQ0QsRUFBRSxVQUFVLEVBQUUsQ0FDZixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksS0FBSyxDQUFDLE1BQU0sQ0FBQyxJQUFjO1FBQ2hDLE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyxVQUFVLEVBQUUsQ0FBQztRQUNsQyxNQUFNLEdBQUcsR0FBRyxNQUFNLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRTtZQUNyRCxLQUFLO1lBQ0wsR0FBRyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsSUFBSSxLQUFLLE1BQU07Z0JBQy9CLENBQUMsQ0FBQztvQkFDRSxNQUFNLEVBQUU7d0JBQ04sT0FBTyxFQUFFLElBQUksQ0FBQyxRQUFRLENBQUMsS0FBSzt3QkFDNUIsRUFBRSxFQUFFLElBQUksQ0FBQyxRQUFRLENBQUMsUUFBUTt3QkFDMUIsV0FBVyxFQUFFLENBQUMsQ0FBQyxJQUFJLENBQUMsU0FBUztxQkFDOUI7aUJBQ0Y7Z0JBQ0gsQ0FBQyxDQUFDO29CQUNFLEtBQUssRUFDSCxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsS0FBSyxZQUFZLElBQUk7d0JBQ2xDLENBQUMsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxPQUFPLEVBQUU7d0JBQy9CLENBQUMsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUU7aUJBQ3hDLENBQUM7U0FDUCxDQUFDLENBQUM7UUFFSCxPQUFPLEdBQUcsQ0FBQyxFQUFFLElBQUksS0FBSyxDQUFDO0lBQ3pCLENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSSxLQUFLLENBQUMsTUFBTSxDQUFDLFVBQWtCO1FBQ3BDLE1BQU0sSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsVUFBVSxFQUFFLEVBQUUsY0FBYyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7SUFDaEUsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNJLEtBQUssQ0FBQyxhQUFhLENBQUMsTUFBa0I7UUFDM0MsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7SUFDdkIsQ0FBQztDQUNGO0FBeEZELG9DQXdGQyJ9

package/dist/drivers/hypercron.d.ts

@@ -0,0 +1,69 @@
+import { TaskDriver, TaskRunner } from '../driver';
+import { TaskData } from '../types';
+/**
+ * HyperCron-based task driver for lightweight task scheduling.
+ *
+ * This driver uses HyperCron to provide simple, in-memory task scheduling.
+ * It's ideal for single-instance applications or development environments
+ * where you don't need distributed task scheduling.
+ *
+ * **Requirements**: Requires the `hypercron` package to be installed.
+ *
+ * @example
+ * ```ts
+ * import { HyperCronDriver } from '@commandkit/tasks/hypercron';
+ * import { setDriver } from '@commandkit/tasks';
+ *
+ * const driver = new HyperCronDriver();
+ * setDriver(driver);
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With custom cron service
+ * import { cronService } from 'hypercron';
+ *
+ * const customService = cronService.create({
+ *   // Custom configuration
+ * });
+ *
+ * const driver = new HyperCronDriver(customService);
+ * setDriver(driver);
+ * ```
+ */
+export declare class HyperCronDriver implements TaskDriver {
+    private readonly service;
+    private runner;
+    /**
+     * Creates a new HyperCron driver instance.
+     *
+     * @param service - Optional custom cron service instance, defaults to the global cronService
+     */
+    constructor(service?: import("hypercron").CronService);
+    /**
+     * Creates a new scheduled task in HyperCron.
+     *
+     * This schedules the task using the HyperCron service and starts the service
+     * if it's not already running.
+     *
+     * @param task - The task data containing name, schedule, and custom data
+     * @returns A unique schedule identifier
+     */
+    create(task: TaskData): Promise<string>;
+    /**
+     * Deletes a scheduled task from HyperCron.
+     *
+     * This cancels the scheduled task and removes it from the cron service.
+     *
+     * @param identifier - The schedule identifier to delete
+     */
+    delete(identifier: string): Promise<void>;
+    /**
+     * Sets the task execution runner function.
+     *
+     * This function will be called by the HyperCron service when a task is due for execution.
+     *
+     * @param runner - The function to call when a task should be executed
+     */
+    setTaskRunner(runner: TaskRunner): Promise<void>;
+}

package/dist/drivers/hypercron.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HyperCronDriver = void 0;
+const hypercron_1 = require("hypercron");
+/**
+ * HyperCron-based task driver for lightweight task scheduling.
+ *
+ * This driver uses HyperCron to provide simple, in-memory task scheduling.
+ * It's ideal for single-instance applications or development environments
+ * where you don't need distributed task scheduling.
+ *
+ * **Requirements**: Requires the `hypercron` package to be installed.
+ *
+ * @example
+ * ```ts
+ * import { HyperCronDriver } from '@commandkit/tasks/hypercron';
+ * import { setDriver } from '@commandkit/tasks';
+ *
+ * const driver = new HyperCronDriver();
+ * setDriver(driver);
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With custom cron service
+ * import { cronService } from 'hypercron';
+ *
+ * const customService = cronService.create({
+ *   // Custom configuration
+ * });
+ *
+ * const driver = new HyperCronDriver(customService);
+ * setDriver(driver);
+ * ```
+ */
+class HyperCronDriver {
+    /**
+     * Creates a new HyperCron driver instance.
+     *
+     * @param service - Optional custom cron service instance, defaults to the global cronService
+     */
+    constructor(service = hypercron_1.cronService) {
+        this.service = service;
+        this.runner = null;
+    }
+    /**
+     * Creates a new scheduled task in HyperCron.
+     *
+     * This schedules the task using the HyperCron service and starts the service
+     * if it's not already running.
+     *
+     * @param task - The task data containing name, schedule, and custom data
+     * @returns A unique schedule identifier
+     */
+    async create(task) {
+        const id = await this.service.schedule(task.schedule.value, task.name, async () => {
+            if (!this.runner)
+                throw new Error('Task runner has not been set');
+            await this.runner({
+                name: task.name,
+                data: task.data,
+                timestamp: Date.now(),
+            });
+        });
+        await this.service.start();
+        return id;
+    }
+    /**
+     * Deletes a scheduled task from HyperCron.
+     *
+     * This cancels the scheduled task and removes it from the cron service.
+     *
+     * @param identifier - The schedule identifier to delete
+     */
+    async delete(identifier) {
+        await this.service.cancel(identifier);
+    }
+    /**
+     * Sets the task execution runner function.
+     *
+     * This function will be called by the HyperCron service when a task is due for execution.
+     *
+     * @param runner - The function to call when a task should be executed
+     */
+    async setTaskRunner(runner) {
+        this.runner = runner;
+    }
+}
+exports.HyperCronDriver = HyperCronDriver;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaHlwZXJjcm9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2RyaXZlcnMvaHlwZXJjcm9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUFBLHlDQUF3QztBQUl4Qzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBOEJHO0FBQ0gsTUFBYSxlQUFlO0lBRzFCOzs7O09BSUc7SUFDSCxZQUFvQyxVQUFVLHVCQUFXO1FBQXJCLFlBQU8sR0FBUCxPQUFPLENBQWM7UUFQakQsV0FBTSxHQUFzQixJQUFJLENBQUM7SUFPbUIsQ0FBQztJQUU3RDs7Ozs7Ozs7T0FRRztJQUNJLEtBQUssQ0FBQyxNQUFNLENBQUMsSUFBYztRQUNoQyxNQUFNLEVBQUUsR0FBRyxNQUFNLElBQUksQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUNwQyxJQUFJLENBQUMsUUFBUSxDQUFDLEtBQUssRUFDbkIsSUFBSSxDQUFDLElBQUksRUFDVCxLQUFLLElBQUksRUFBRTtZQUNULElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTTtnQkFBRSxNQUFNLElBQUksS0FBSyxDQUFDLDhCQUE4QixDQUFDLENBQUM7WUFFbEUsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDO2dCQUNoQixJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUk7Z0JBQ2YsSUFBSSxFQUFFLElBQUksQ0FBQyxJQUFJO2dCQUNmLFNBQVMsRUFBRSxJQUFJLENBQUMsR0FBRyxFQUFFO2FBQ3RCLENBQUMsQ0FBQztRQUNMLENBQUMsQ0FDRixDQUFDO1FBRUYsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLEtBQUssRUFBRSxDQUFDO1FBRTNCLE9BQU8sRUFBRSxDQUFDO0lBQ1osQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNJLEtBQUssQ0FBQyxNQUFNLENBQUMsVUFBa0I7UUFDcEMsTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUN4QyxDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0ksS0FBSyxDQUFDLGFBQWEsQ0FBQyxNQUFrQjtRQUMzQyxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUN2QixDQUFDO0NBQ0Y7QUE1REQsMENBNERDIn0=

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { TasksPlugin, TasksPluginOptions } from './plugin';
+/**
+ * Creates a tasks plugin instance for CommandKit.
+ *
+ * This plugin provides task management capabilities including:
+ * - Static task definitions with cron and date-based scheduling
+ * - Dynamic task creation and management
+ * - Hot module replacement (HMR) support for development
+ * - Multiple persistence drivers (in-memory, SQLite, BullMQ)
+ *
+ * @example
+ * ```ts
+ * import { tasks } from '@commandkit/tasks';
+ *
+ * export default {
+ *   plugins: [
+ *     tasks({
+ *       tasksPath: 'app/tasks',
+ *       enableHMR: true,
+ *     }),
+ *   ],
+ * };
+ * ```
+ *
+ * @param options - Configuration options for the tasks plugin
+ * @returns A configured tasks plugin instance
+ */
+export declare function tasks(options?: TasksPluginOptions): TasksPlugin;
+export * from './plugin';
+export * from './task';
+export * from './types';
+export * from './driver';
+export * from './driver-manager';
+export * from './context';

package/dist/index.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tasks = tasks;
+const plugin_1 = require("./plugin");
+/**
+ * Creates a tasks plugin instance for CommandKit.
+ *
+ * This plugin provides task management capabilities including:
+ * - Static task definitions with cron and date-based scheduling
+ * - Dynamic task creation and management
+ * - Hot module replacement (HMR) support for development
+ * - Multiple persistence drivers (in-memory, SQLite, BullMQ)
+ *
+ * @example
+ * ```ts
+ * import { tasks } from '@commandkit/tasks';
+ *
+ * export default {
+ *   plugins: [
+ *     tasks({
+ *       tasksPath: 'app/tasks',
+ *       enableHMR: true,
+ *     }),
+ *   ],
+ * };
+ * ```
+ *
+ * @param options - Configuration options for the tasks plugin
+ * @returns A configured tasks plugin instance
+ */
+function tasks(options) {
+    return new plugin_1.TasksPlugin(options ?? {});
+}
+__exportStar(require("./plugin"), exports);
+__exportStar(require("./task"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./driver"), exports);
+__exportStar(require("./driver-manager"), exports);
+__exportStar(require("./context"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7OztBQTRCQSxzQkFFQztBQTlCRCxxQ0FBMkQ7QUFFM0Q7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F5Qkc7QUFDSCxTQUFnQixLQUFLLENBQUMsT0FBNEI7SUFDaEQsT0FBTyxJQUFJLG9CQUFXLENBQUMsT0FBTyxJQUFJLEVBQUUsQ0FBQyxDQUFDO0FBQ3hDLENBQUM7QUFFRCwyQ0FBeUI7QUFDekIseUNBQXVCO0FBQ3ZCLDBDQUF3QjtBQUN4QiwyQ0FBeUI7QUFDekIsbURBQWlDO0FBQ2pDLDRDQUEwQiJ9