@commandkit/tasks 0.0.0-dev.20250725125550 → 0.0.0-dev.20250726103524

package/README.md

@@ -25,15 +25,21 @@ import { tasks } from '@commandkit/tasks';
 
 export default {
   plugins: [
-    tasks({
-      tasksPath: 'app/tasks', // optional, defaults to 'app/tasks'
-      enableHMR: true, // optional, defaults to true in development
-    }),
+    tasks(),
   ],
 };
 ```
 
-### 2. Create static tasks
+### 2. Set up a driver
+
+```ts
+import { setDriver } from '@commandkit/tasks';
+import { SQLiteDriver } from '@commandkit/tasks/sqlite';
+
+setDriver(new SQLiteDriver('./tasks.db'));
+```
+
+### 3. Create static tasks
 
 Create a file in `src/app/tasks/`:
 
@@ -42,95 +48,86 @@ import { task } from '@commandkit/tasks';
 
 export const refreshExchangeRate = task({
   name: 'refresh-exchange-rate',
-  schedule: '0 0 * * *', // cron expression - daily at midnight
+  schedule: { type: 'cron', value: '0 0 * * *' }, // daily at midnight
   async execute(ctx) {
     // Fetch latest exchange rates
     const rates = await fetchExchangeRates();
     await updateDatabase(rates);
   },
 });
-
-export const cleanupOldData = task({
-  name: 'cleanup-old-data',
-  schedule: () => new Date(Date.now() + 24 * 60 * 60 * 1000), // tomorrow
-  async prepare(ctx) {
-    // Only run if there's old data to clean
-    return await hasOldData();
-  },
-  async execute(ctx) {
-    await cleanupOldRecords();
-  },
-});
 ```
 
-### 3. Create dynamic tasks from commands
+### 4. Create dynamic tasks from commands
 
 ```ts
+import type { CommandData, ChatInputCommand } from 'commandkit';
+import { ApplicationCommandOptionType } from 'discord.js';
+import ms from 'ms';
 import { createTask } from '@commandkit/tasks';
 
-export default {
+export const command: CommandData = {
   name: 'remind-me',
   description: 'Set a reminder',
-  async run(ctx) {
-    const time = ctx.interaction.options.getString('time');
-    const reason = ctx.interaction.options.getString('reason');
-    
-    await createTask({
-      name: 'reminder',
-      schedule: new Date(Date.now() + ms(time)),
-      data: {
-        userId: ctx.interaction.user.id,
-        reason,
-      },
-    });
-    
-    await ctx.interaction.reply('Reminder set!');
-  },
+  options: [
+    {
+      name: 'time',
+      description: 'The time to remind after. Eg: 6h, 10m, 1d',
+      type: ApplicationCommandOptionType.String,
+      required: true,
+    },
+    {
+      name: 'message',
+      description: 'The message to remind about.',
+      type: ApplicationCommandOptionType.String,
+      required: true,
+    },
+  ],
+};
+
+export const chatInput: ChatInputCommand = async (ctx) => {
+  const time = ctx.options.getString('time', true);
+  const message = ctx.options.getString('message', true);
+  const timeMs = Date.now() + ms(time as `${number}`);
+
+  await createTask({
+    name: 'reminder',
+    data: {
+      userId: ctx.interaction.user.id,
+      message,
+      channelId: ctx.interaction.channelId,
+      setAt: Date.now(),
+    },
+    schedule: {
+      type: 'date',
+      value: timeMs,
+    },
+  });
+
+  await ctx.interaction.reply(
+    `I will remind you <t:${Math.floor(timeMs / 1000)}:R> for \`${message}\``,
+  );
 };
 ```
 
 ## API Reference
 
-### Plugin Options
-
-```ts
-interface TasksPluginOptions {
-  tasksPath?: string; // Path to tasks directory, defaults to 'app/tasks'
-  enableHMR?: boolean; // Enable HMR for tasks, defaults to true in development
-}
-```
-
 ### Task Definition
 
 ```ts
 interface TaskDefinition {
   name: string;
-  schedule?: ScheduleType;
-  prepare?: (ctx: TaskContext) => Promise<boolean> | boolean;
-  execute: (ctx: TaskContext) => Promise<void> | void;
+  schedule?: TaskSchedule;
+  prepare?: (ctx: TaskContext) => Promise<boolean>;
+  execute: (ctx: TaskContext) => Promise<void>;
 }
 ```
 
 ### Schedule Types
 
 ```ts
-type ScheduleType = 
-  | Date 
-  | number // unix timestamp
-  | string // cron expression or date string
-  | (() => Date | number | string); // dynamic schedule
-```
-
-**Cron Expressions**: The plugin supports standard cron expressions (e.g., `'0 0 * * *'` for daily at midnight). Cron parsing is handled by `cron-parser` for in-memory and SQLite drivers, while BullMQ uses its built-in cron support.
-
-### Task Context
-
-```ts
-interface TaskContext {
-  task: TaskData;
-  commandkit: CommandKit;
-  client: Client;
-}
+type TaskSchedule = 
+  | { type: 'cron'; value: string; timezone?: string }
+  | { type: 'date'; value: Date | number; timezone?: string };
 ```
 
 ### Functions
@@ -139,163 +136,44 @@ interface TaskContext {
 
 Creates a task definition.
 
-```ts
-import { task } from '@commandkit/tasks';
-
-export const myTask = task({
-  name: 'my-task',
-  schedule: '0 0 * * *',
-  async execute(ctx) {
-    // Task logic here
-  },
-});
-```
-
-#### `createTask(options: CreateTaskOptions)`
+#### `createTask(task: TaskData)`
 
 Creates a dynamic task.
 
-```ts
-import { createTask } from '@commandkit/tasks';
-
-await createTask({
-  name: 'reminder',
-  schedule: new Date(Date.now() + 60000), // 1 minute from now
-  data: { userId: '123', message: 'Hello!' },
-});
-```
-
-#### `executeTask(taskOrName: TaskDefinition | string)`
-
-Executes a task immediately.
-
-```ts
-import { executeTask } from '@commandkit/tasks';
-
-await executeTask('my-task');
-// or
-await executeTask(myTask);
-```
-
-#### `cancelTask(taskOrName: TaskDefinition | string)`
-
-Cancels a scheduled task.
-
-```ts
-import { cancelTask } from '@commandkit/tasks';
-
-await cancelTask('my-task');
-```
-
-#### `pauseTask(taskOrName: TaskDefinition | string)`
-
-Pauses a task.
-
-```ts
-import { pauseTask } from '@commandkit/tasks';
-
-await pauseTask('my-task');
-```
-
-#### `resumeTask(taskOrName: TaskDefinition | string)`
-
-Resumes a paused task.
-
-```ts
-import { resumeTask } from '@commandkit/tasks';
-
-await resumeTask('my-task');
-```
+#### `deleteTask(identifier: string)`
 
-## Persistence Drivers
+Deletes a scheduled task.
 
-The drivers handle all scheduling and timing internally. When a task is due for execution, the driver calls the plugin's execution handler.
-
-### In-Memory Driver (Default)
-
-```ts
-import { driver } from '@commandkit/tasks';
-import { InMemoryDriver } from '@commandkit/tasks/drivers';
-
-driver.use(new InMemoryDriver());
-```
+## Drivers
 
 ### SQLite Driver
 
+Persistent job queue with recovery on restart.
+
 ```ts
-import { driver } from '@commandkit/tasks';
-import { SQLiteDriver } from '@commandkit/tasks/drivers';
+import { SQLiteDriver } from '@commandkit/tasks/sqlite';
 
-driver.use(new SQLiteDriver('./tasks.db'));
+setDriver(new SQLiteDriver('./tasks.db'));
 ```
 
-**Note**: Requires `sqlite3`, `sqlite`, and `cron-parser` packages to be installed.
+**Features:**
+- Jobs recoverable on restart
+- Persistent job data
+- Cron expression support via cron-parser
 
 ### BullMQ Driver
 
+Distributed task scheduling with Redis.
+
 ```ts
-import { driver } from '@commandkit/tasks';
-import { BullMQDriver } from '@commandkit/tasks/drivers';
+import { BullMQDriver } from '@commandkit/tasks/bullmq';
 
-driver.use(new BullMQDriver({
+setDriver(new BullMQDriver({
   host: 'localhost',
   port: 6379,
 }));
 ```
 
-**Note**: Requires `bullmq` package to be installed. BullMQ has built-in cron support, so no additional cron parsing is needed.
-
-## Examples
-
-### Scheduled Database Backup
-
-```ts
-import { task } from '@commandkit/tasks';
-
-export const databaseBackup = task({
-  name: 'database-backup',
-  schedule: '0 2 * * *', // Daily at 2 AM
-  async execute(ctx) {
-    const backup = await createBackup();
-    await uploadToCloud(backup);
-    await ctx.client.channels.cache.get('backup-log')?.send('Backup completed!');
-  },
-});
-```
-
-### User Reminder System
-
-```ts
-import { task } from '@commandkit/tasks';
-
-export const reminder = task({
-  name: 'reminder',
-  async execute(ctx) {
-    const { userId, message } = ctx.task.data;
-    const user = await ctx.client.users.fetch(userId);
-    await user.send(`Reminder: ${message}`);
-  },
-});
-```
-
-### Conditional Task
-
-```ts
-import { task } from '@commandkit/tasks';
-
-export const maintenanceCheck = task({
-  name: 'maintenance-check',
-  schedule: '0 */6 * * *', // Every 6 hours
-  async prepare(ctx) {
-    // Only run if maintenance mode is not enabled
-    return !ctx.commandkit.store.get('maintenance-mode');
-  },
-  async execute(ctx) {
-    await performMaintenanceChecks();
-  },
-});
-```
-
 ## License
 
 MIT

package/dist/driver-manager.d.ts

@@ -10,10 +10,9 @@ import { TaskData } from './types';
  * @example
  * ```ts
  * import { TaskDriverManager } from '@commandkit/tasks';
- * import { HyperCronDriver } from '@commandkit/tasks/hypercron';
  *
  * const manager = new TaskDriverManager();
- * manager.setDriver(new HyperCronDriver());
+ * // Set your preferred driver here
  *
  * // Now you can create and manage tasks
  * const taskId = await manager.createTask({
@@ -83,9 +82,9 @@ export declare const taskDriverManager: TaskDriverManager;
  * @example
  * ```ts
  * import { setDriver } from '@commandkit/tasks';
- * import { HyperCronDriver } from '@commandkit/tasks/hypercron';
+ * import { SQLiteDriver } from '@commandkit/tasks/sqlite';
  *
- * setDriver(new HyperCronDriver());
+ * setDriver(new SQLiteDriver('./tasks.db'));
  * ```
  */
 export declare function setDriver(driver: TaskDriver): void;

package/dist/driver-manager.js

@@ -14,10 +14,9 @@ exports.deleteTask = deleteTask;
  * @example
  * ```ts
  * import { TaskDriverManager } from '@commandkit/tasks';
- * import { HyperCronDriver } from '@commandkit/tasks/hypercron';
  *
  * const manager = new TaskDriverManager();
- * manager.setDriver(new HyperCronDriver());
+ * // Set your preferred driver here
  *
  * // Now you can create and manage tasks
  * const taskId = await manager.createTask({
@@ -104,9 +103,9 @@ exports.taskDriverManager = new TaskDriverManager();
  * @example
  * ```ts
  * import { setDriver } from '@commandkit/tasks';
- * import { HyperCronDriver } from '@commandkit/tasks/hypercron';
+ * import { SQLiteDriver } from '@commandkit/tasks/sqlite';
  *
- * setDriver(new HyperCronDriver());
+ * setDriver(new SQLiteDriver('./tasks.db'));
  * ```
  */
 function setDriver(driver) {
@@ -151,4 +150,4 @@ function createTask(task) {
 function deleteTask(identifier) {
     return exports.taskDriverManager.deleteTask(identifier);
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZHJpdmVyLW1hbmFnZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZHJpdmVyLW1hbmFnZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBK0dBLDhCQUVDO0FBcUJELGdDQUVDO0FBZ0JELGdDQUVDO0FBdkpEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBc0JHO0FBQ0gsTUFBYSxpQkFBaUI7SUFBOUI7UUFDVSxXQUFNLEdBQXNCLElBQUksQ0FBQztJQTJEM0MsQ0FBQztJQXpEQzs7Ozs7OztPQU9HO0lBQ0ksU0FBUyxDQUFDLE1BQWtCO1FBQ2pDLElBQUksQ0FBQyxNQUFNLEdBQUcsTUFBTSxDQUFDO0lBQ3ZCLENBQUM7SUFFRDs7Ozs7Ozs7O09BU0c7SUFDSSxLQUFLLENBQUMsVUFBVSxDQUFDLElBQWM7UUFDcEMsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyw4QkFBOEIsQ0FBQyxDQUFDO1FBRWxFLE9BQU8sTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUN4QyxDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSSxLQUFLLENBQUMsVUFBVSxDQUFDLFVBQWtCO1FBQ3hDLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTTtZQUFFLE1BQU0sSUFBSSxLQUFLLENBQUMsOEJBQThCLENBQUMsQ0FBQztRQUVsRSxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBQ3ZDLENBQUM7SUFFRDs7Ozs7Ozs7T0FRRztJQUNJLEtBQUssQ0FBQyxhQUFhLENBQUMsTUFBa0I7UUFDM0MsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyw4QkFBOEIsQ0FBQyxDQUFDO1FBRWxFLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDMUMsQ0FBQztDQUNGO0FBNURELDhDQTREQztBQUVEOzs7OztHQUtHO0FBQ1UsUUFBQSxpQkFBaUIsR0FBRyxJQUFJLGlCQUFpQixFQUFFLENBQUM7QUFFekQ7Ozs7Ozs7Ozs7Ozs7O0dBY0c7QUFDSCxTQUFnQixTQUFTLENBQUMsTUFBa0I7SUFDMUMseUJBQWlCLENBQUMsU0FBUyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0FBQ3RDLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBa0JHO0FBQ0gsU0FBZ0IsVUFBVSxDQUFDLElBQWM7SUFDdkMsT0FBTyx5QkFBaUIsQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLENBQUM7QUFDNUMsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7O0dBYUc7QUFDSCxTQUFnQixVQUFVLENBQUMsVUFBa0I7SUFDM0MsT0FBTyx5QkFBaUIsQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLENBQUM7QUFDbEQsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZHJpdmVyLW1hbmFnZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvZHJpdmVyLW1hbmFnZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBOEdBLDhCQUVDO0FBcUJELGdDQUVDO0FBZ0JELGdDQUVDO0FBdEpEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FxQkc7QUFDSCxNQUFhLGlCQUFpQjtJQUE5QjtRQUNVLFdBQU0sR0FBc0IsSUFBSSxDQUFDO0lBMkQzQyxDQUFDO0lBekRDOzs7Ozs7O09BT0c7SUFDSSxTQUFTLENBQUMsTUFBa0I7UUFDakMsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7SUFDdkIsQ0FBQztJQUVEOzs7Ozs7Ozs7T0FTRztJQUNJLEtBQUssQ0FBQyxVQUFVLENBQUMsSUFBYztRQUNwQyxJQUFJLENBQUMsSUFBSSxDQUFDLE1BQU07WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLDhCQUE4QixDQUFDLENBQUM7UUFFbEUsT0FBTyxNQUFNLElBQUksQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ3hDLENBQUM7SUFFRDs7Ozs7Ozs7T0FRRztJQUNJLEtBQUssQ0FBQyxVQUFVLENBQUMsVUFBa0I7UUFDeEMsSUFBSSxDQUFDLElBQUksQ0FBQyxNQUFNO1lBQUUsTUFBTSxJQUFJLEtBQUssQ0FBQyw4QkFBOEIsQ0FBQyxDQUFDO1FBRWxFLE1BQU0sSUFBSSxDQUFDLE1BQU0sQ0FBQyxNQUFNLENBQUMsVUFBVSxDQUFDLENBQUM7SUFDdkMsQ0FBQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksS0FBSyxDQUFDLGFBQWEsQ0FBQyxNQUFrQjtRQUMzQyxJQUFJLENBQUMsSUFBSSxDQUFDLE1BQU07WUFBRSxNQUFNLElBQUksS0FBSyxDQUFDLDhCQUE4QixDQUFDLENBQUM7UUFFbEUsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUMxQyxDQUFDO0NBQ0Y7QUE1REQsOENBNERDO0FBRUQ7Ozs7O0dBS0c7QUFDVSxRQUFBLGlCQUFpQixHQUFHLElBQUksaUJBQWlCLEVBQUUsQ0FBQztBQUV6RDs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUNILFNBQWdCLFNBQVMsQ0FBQyxNQUFrQjtJQUMxQyx5QkFBaUIsQ0FBQyxTQUFTLENBQUMsTUFBTSxDQUFDLENBQUM7QUFDdEMsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FrQkc7QUFDSCxTQUFnQixVQUFVLENBQUMsSUFBYztJQUN2QyxPQUFPLHlCQUFpQixDQUFDLFVBQVUsQ0FBQyxJQUFJLENBQUMsQ0FBQztBQUM1QyxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7R0FhRztBQUNILFNBQWdCLFVBQVUsQ0FBQyxVQUFrQjtJQUMzQyxPQUFPLHlCQUFpQixDQUFDLFVBQVUsQ0FBQyxVQUFVLENBQUMsQ0FBQztBQUNsRCxDQUFDIn0=

package/dist/drivers/bullmq.js

@@ -69,18 +69,18 @@ class BullMQDriver {
         const jobId = crypto.randomUUID();
         const job = await this.queue.add(task.name, task.data, {
             jobId,
-            ...(task.schedule.type === 'cron'
+            ...(typeof task.schedule === 'string'
                 ? {
                     repeat: {
-                        pattern: task.schedule.value,
-                        tz: task.schedule.timezone,
+                        pattern: task.schedule,
+                        tz: task.timezone,
                         immediately: !!task.immediate,
                     },
                 }
                 : {
-                    delay: (task.schedule.value instanceof Date
-                        ? task.schedule.value.getTime()
-                        : task.schedule.value) - Date.now(),
+                    delay: (task.schedule instanceof Date
+                        ? task.schedule.getTime()
+                        : task.schedule) - Date.now(),
                 }),
         });
         return job.id ?? jobId;
@@ -107,4 +107,4 @@ class BullMQDriver {
     }
 }
 exports.BullMQDriver = BullMQDriver;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVsbG1xLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2RyaXZlcnMvYnVsbG1xLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLG1DQUEwRDtBQUcxRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQ0c7QUFDSCxNQUFhLFlBQVk7SUFTdkI7Ozs7O09BS0c7SUFDSCxZQUNFLFVBQTZCLEVBQ1osWUFBb0Isa0JBQWtCO1FBQXRDLGNBQVMsR0FBVCxTQUFTLENBQTZCO1FBaEJqRCxXQUFNLEdBQXNCLElBQUksQ0FBQztRQWtCdkMsSUFBSSxDQUFDLEtBQUssR0FBRyxJQUFJLGNBQUssQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLEVBQUUsVUFBVSxFQUFFLENBQUMsQ0FBQztRQUN2RCxJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksZUFBTSxDQUN0QixJQUFJLENBQUMsU0FBUyxFQUNkLEtBQUssRUFBRSxHQUFHLEVBQUUsRUFBRTtZQUNaLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTTtnQkFBRSxNQUFNLElBQUksS0FBSyxDQUFDLDhCQUE4QixDQUFDLENBQUM7WUFFbEUsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDO2dCQUNoQixJQUFJLEVBQUUsR0FBRyxDQUFDLElBQUk7Z0JBQ2QsSUFBSSxFQUFFLEdBQUcsQ0FBQyxJQUFJO2dCQUNkLFNBQVMsRUFBRSxHQUFHLENBQUMsU0FBUzthQUN6QixDQUFDLENBQUM7UUFDTCxDQUFDLEVBQ0QsRUFBRSxVQUFVLEVBQUUsQ0FDZixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksS0FBSyxDQUFDLE1BQU0sQ0FBQyxJQUFjO1FBQ2hDLE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyxVQUFVLEVBQUUsQ0FBQztRQUNsQyxNQUFNLEdBQUcsR0FBRyxNQUFNLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRTtZQUNyRCxLQUFLO1lBQ0wsR0FBRyxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsSUFBSSxLQUFLLE1BQU07Z0JBQy9CLENBQUMsQ0FBQztvQkFDRSxNQUFNLEVBQUU7d0JBQ04sT0FBTyxFQUFFLElBQUksQ0FBQyxRQUFRLENBQUMsS0FBSzt3QkFDNUIsRUFBRSxFQUFFLElBQUksQ0FBQyxRQUFRLENBQUMsUUFBUTt3QkFDMUIsV0FBVyxFQUFFLENBQUMsQ0FBQyxJQUFJLENBQUMsU0FBUztxQkFDOUI7aUJBQ0Y7Z0JBQ0gsQ0FBQyxDQUFDO29CQUNFLEtBQUssRUFDSCxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsS0FBSyxZQUFZLElBQUk7d0JBQ2xDLENBQUMsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxPQUFPLEVBQUU7d0JBQy9CLENBQUMsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLEtBQUssQ0FBQyxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUU7aUJBQ3hDLENBQUM7U0FDUCxDQUFDLENBQUM7UUFFSCxPQUFPLEdBQUcsQ0FBQyxFQUFFLElBQUksS0FBSyxDQUFDO0lBQ3pCLENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSSxLQUFLLENBQUMsTUFBTSxDQUFDLFVBQWtCO1FBQ3BDLE1BQU0sSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsVUFBVSxFQUFFLEVBQUUsY0FBYyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7SUFDaEUsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNJLEtBQUssQ0FBQyxhQUFhLENBQUMsTUFBa0I7UUFDM0MsSUFBSSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUM7SUFDdkIsQ0FBQztDQUNGO0FBeEZELG9DQXdGQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYnVsbG1xLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2RyaXZlcnMvYnVsbG1xLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUNBLG1DQUEwRDtBQUcxRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FnQ0c7QUFDSCxNQUFhLFlBQVk7SUFTdkI7Ozs7O09BS0c7SUFDSCxZQUNFLFVBQTZCLEVBQ1osWUFBb0Isa0JBQWtCO1FBQXRDLGNBQVMsR0FBVCxTQUFTLENBQTZCO1FBaEJqRCxXQUFNLEdBQXNCLElBQUksQ0FBQztRQWtCdkMsSUFBSSxDQUFDLEtBQUssR0FBRyxJQUFJLGNBQUssQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLEVBQUUsVUFBVSxFQUFFLENBQUMsQ0FBQztRQUN2RCxJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksZUFBTSxDQUN0QixJQUFJLENBQUMsU0FBUyxFQUNkLEtBQUssRUFBRSxHQUFHLEVBQUUsRUFBRTtZQUNaLElBQUksQ0FBQyxJQUFJLENBQUMsTUFBTTtnQkFBRSxNQUFNLElBQUksS0FBSyxDQUFDLDhCQUE4QixDQUFDLENBQUM7WUFFbEUsTUFBTSxJQUFJLENBQUMsTUFBTSxDQUFDO2dCQUNoQixJQUFJLEVBQUUsR0FBRyxDQUFDLElBQUk7Z0JBQ2QsSUFBSSxFQUFFLEdBQUcsQ0FBQyxJQUFJO2dCQUNkLFNBQVMsRUFBRSxHQUFHLENBQUMsU0FBUzthQUN6QixDQUFDLENBQUM7UUFDTCxDQUFDLEVBQ0QsRUFBRSxVQUFVLEVBQUUsQ0FDZixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksS0FBSyxDQUFDLE1BQU0sQ0FBQyxJQUFjO1FBQ2hDLE1BQU0sS0FBSyxHQUFHLE1BQU0sQ0FBQyxVQUFVLEVBQUUsQ0FBQztRQUNsQyxNQUFNLEdBQUcsR0FBRyxNQUFNLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxJQUFJLEVBQUUsSUFBSSxDQUFDLElBQUksRUFBRTtZQUNyRCxLQUFLO1lBQ0wsR0FBRyxDQUFDLE9BQU8sSUFBSSxDQUFDLFFBQVEsS0FBSyxRQUFRO2dCQUNuQyxDQUFDLENBQUM7b0JBQ0UsTUFBTSxFQUFFO3dCQUNOLE9BQU8sRUFBRSxJQUFJLENBQUMsUUFBUTt3QkFDdEIsRUFBRSxFQUFFLElBQUksQ0FBQyxRQUFRO3dCQUNqQixXQUFXLEVBQUUsQ0FBQyxDQUFDLElBQUksQ0FBQyxTQUFTO3FCQUM5QjtpQkFDRjtnQkFDSCxDQUFDLENBQUM7b0JBQ0UsS0FBSyxFQUNILENBQUMsSUFBSSxDQUFDLFFBQVEsWUFBWSxJQUFJO3dCQUM1QixDQUFDLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxPQUFPLEVBQUU7d0JBQ3pCLENBQUMsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRTtpQkFDbEMsQ0FBQztTQUNQLENBQUMsQ0FBQztRQUVILE9BQU8sR0FBRyxDQUFDLEVBQUUsSUFBSSxLQUFLLENBQUM7SUFDekIsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNJLEtBQUssQ0FBQyxNQUFNLENBQUMsVUFBa0I7UUFDcEMsTUFBTSxJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxVQUFVLEVBQUUsRUFBRSxjQUFjLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztJQUNoRSxDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0ksS0FBSyxDQUFDLGFBQWEsQ0FBQyxNQUFrQjtRQUMzQyxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUN2QixDQUFDO0NBQ0Y7QUF4RkQsb0NBd0ZDIn0=

package/dist/drivers/sqlite.d.ts

@@ -0,0 +1,63 @@
+import { TaskDriver, TaskRunner } from '../driver';
+import { TaskData } from '../types';
+/**
+ * SQLite-based persistent job queue manager for CommandKit tasks.
+ *
+ * - Jobs are recoverable on restart (pending jobs from the past are run on startup)
+ * - Job data is persisted in SQLite
+ * - Supports both cron and date-based schedules (uses cron-parser for cron)
+ *
+ * @example
+ * import { SQLiteDriver } from '@commandkit/tasks/sqlite';
+ * import { setDriver } from '@commandkit/tasks';
+ *
+ * const driver = new SQLiteDriver('./tasks.db');
+ * setDriver(driver);
+ */
+export declare class SQLiteDriver implements TaskDriver {
+    private runner;
+    private db;
+    private interval;
+    /**
+     * Create a new SQLiteDriver instance.
+     * @param dbPath Path to the SQLite database file (default: './commandkit-tasks.db'). Use `:memory:` for an in-memory database.
+     */
+    constructor(dbPath?: string);
+    /**
+     * Destroy the SQLite driver and stop the polling loop.
+     */
+    destroy(): void;
+    /**
+     * Initialize the jobs table and start the polling loop.
+     */
+    private init;
+    /**
+     * Schedule a new job.
+     * @param task TaskData to schedule
+     * @returns The job ID as a string
+     */
+    create(task: TaskData): Promise<string>;
+    /**
+     * Delete a scheduled job by its ID.
+     * @param identifier Job ID
+     */
+    delete(identifier: string): Promise<void>;
+    /**
+     * Set the task runner function to be called when a job is due.
+     * @param runner TaskRunner function
+     */
+    setTaskRunner(runner: TaskRunner): Promise<void>;
+    /**
+     * Poll the database for due jobs and execute them.
+     * Handles recovery of missed jobs on restart.
+     */
+    private startPolling;
+    /**
+     * Poll for jobs that are due and execute them.
+     */
+    private pollJobs;
+    /**
+     * Execute a job and reschedule or remove as needed.
+     */
+    private executeJob;
+}

package/dist/drivers/sqlite.js

@@ -0,0 +1,179 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SQLiteDriver = void 0;
+const node_sqlite_1 = require("node:sqlite");
+const cron_parser_1 = __importDefault(require("cron-parser"));
+/**
+ * SQLite-based persistent job queue manager for CommandKit tasks.
+ *
+ * - Jobs are recoverable on restart (pending jobs from the past are run on startup)
+ * - Job data is persisted in SQLite
+ * - Supports both cron and date-based schedules (uses cron-parser for cron)
+ *
+ * @example
+ * import { SQLiteDriver } from '@commandkit/tasks/sqlite';
+ * import { setDriver } from '@commandkit/tasks';
+ *
+ * const driver = new SQLiteDriver('./tasks.db');
+ * setDriver(driver);
+ */
+class SQLiteDriver {
+    /**
+     * Create a new SQLiteDriver instance.
+     * @param dbPath Path to the SQLite database file (default: './commandkit-tasks.db'). Use `:memory:` for an in-memory database.
+     */
+    constructor(dbPath = './commandkit-tasks.db') {
+        this.runner = null;
+        this.interval = null;
+        this.db = new node_sqlite_1.DatabaseSync(dbPath, { open: true });
+        this.init();
+    }
+    /**
+     * Destroy the SQLite driver and stop the polling loop.
+     */
+    destroy() {
+        this.db.close();
+        this.interval && clearInterval(this.interval);
+    }
+    /**
+     * Initialize the jobs table and start the polling loop.
+     */
+    init() {
+        this.db.exec(`CREATE TABLE IF NOT EXISTS jobs (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      name TEXT NOT NULL,
+      data TEXT,
+      schedule_type TEXT NOT NULL,
+      schedule_value TEXT NOT NULL,
+      timezone TEXT,
+      next_run INTEGER,
+      status TEXT NOT NULL DEFAULT 'pending',
+      created_at INTEGER NOT NULL,
+      last_run INTEGER
+    )`);
+        this.startPolling();
+    }
+    /**
+     * Schedule a new job.
+     * @param task TaskData to schedule
+     * @returns The job ID as a string
+     */
+    async create(task) {
+        const { name, data, schedule, timezone } = task;
+        let nextRun;
+        let scheduleType;
+        let scheduleValue;
+        if (typeof schedule === 'string') {
+            scheduleType = 'cron';
+            scheduleValue = schedule;
+            const interval = cron_parser_1.default.parseExpression(schedule, {
+                tz: timezone,
+            });
+            nextRun = interval.next().getTime();
+        }
+        else {
+            scheduleType = 'date';
+            scheduleValue = String(schedule);
+            nextRun = typeof schedule === 'number' ? schedule : schedule.getTime();
+        }
+        const stmt = this.db.prepare(`INSERT INTO jobs (name, data, schedule_type, schedule_value, timezone, next_run, status, created_at) VALUES (?, ?, ?, ?, ?, ?, 'pending', ?)`);
+        const result = stmt.run(name, JSON.stringify(data ?? {}), scheduleType, scheduleValue, timezone ?? null, nextRun, Date.now());
+        if (task.immediate) {
+            await this.runner?.({
+                name,
+                data,
+                timestamp: Date.now(),
+            });
+        }
+        return result.lastInsertRowid.toString();
+    }
+    /**
+     * Delete a scheduled job by its ID.
+     * @param identifier Job ID
+     */
+    async delete(identifier) {
+        const stmt = this.db.prepare(`DELETE FROM jobs WHERE id = ?`);
+        stmt.run(identifier);
+    }
+    /**
+     * Set the task runner function to be called when a job is due.
+     * @param runner TaskRunner function
+     */
+    async setTaskRunner(runner) {
+        this.runner = runner;
+    }
+    /**
+     * Poll the database for due jobs and execute them.
+     * Handles recovery of missed jobs on restart.
+     */
+    startPolling() {
+        if (this.interval)
+            clearInterval(this.interval);
+        this.interval = setInterval(() => this.pollJobs(), 1000);
+        // Run immediately on startup
+        this.pollJobs();
+    }
+    /**
+     * Poll for jobs that are due and execute them.
+     */
+    pollJobs() {
+        if (!this.runner)
+            return;
+        const now = Date.now();
+        const stmt = this.db.prepare(`SELECT * FROM jobs WHERE status = 'pending' AND next_run <= ?`);
+        const rows = stmt.all(now);
+        for (const job of rows) {
+            this.executeJob(job);
+        }
+    }
+    /**
+     * Execute a job and reschedule or remove as needed.
+     */
+    async executeJob(job) {
+        if (!this.runner)
+            return;
+        const data = JSON.parse(job.data ?? '{}');
+        await this.runner({
+            name: job.name,
+            data,
+            timestamp: Date.now(),
+        });
+        const now = Date.now();
+        if (job.schedule_type === 'cron') {
+            let nextRun = null;
+            try {
+                const interval = cron_parser_1.default.parseExpression(job.schedule_value, {
+                    tz: job.timezone || undefined,
+                });
+                // Find the next run after now
+                while (true) {
+                    const candidate = interval.next().getTime();
+                    if (candidate > now) {
+                        nextRun = candidate;
+                        break;
+                    }
+                }
+            }
+            catch {
+                nextRun = null;
+            }
+            if (nextRun) {
+                const stmt = this.db.prepare(`UPDATE jobs SET next_run = ?, last_run = ? WHERE id = ?`);
+                stmt.run(nextRun, now, job.id);
+            }
+            else {
+                const stmt = this.db.prepare(`UPDATE jobs SET status = 'completed', last_run = ? WHERE id = ?`);
+                stmt.run(now, job.id);
+            }
+        }
+        else {
+            const stmt = this.db.prepare(`UPDATE jobs SET status = 'completed', last_run = ? WHERE id = ?`);
+            stmt.run(now, job.id);
+        }
+    }
+}
+exports.SQLiteDriver = SQLiteDriver;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3FsaXRlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2RyaXZlcnMvc3FsaXRlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7OztBQUVBLDZDQUEyQztBQUMzQyw4REFBcUM7QUFFckM7Ozs7Ozs7Ozs7Ozs7R0FhRztBQUNILE1BQWEsWUFBWTtJQUt2Qjs7O09BR0c7SUFDSCxZQUFZLE1BQU0sR0FBRyx1QkFBdUI7UUFScEMsV0FBTSxHQUFzQixJQUFJLENBQUM7UUFFakMsYUFBUSxHQUEwQixJQUFJLENBQUM7UUFPN0MsSUFBSSxDQUFDLEVBQUUsR0FBRyxJQUFJLDBCQUFZLENBQUMsTUFBTSxFQUFFLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7UUFDbkQsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDO0lBQ2QsQ0FBQztJQUVEOztPQUVHO0lBQ0ksT0FBTztRQUNaLElBQUksQ0FBQyxFQUFFLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDaEIsSUFBSSxDQUFDLFFBQVEsSUFBSSxhQUFhLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQ2hELENBQUM7SUFFRDs7T0FFRztJQUNLLElBQUk7UUFDVixJQUFJLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQzs7Ozs7Ozs7Ozs7TUFXWCxDQUFDLENBQUM7UUFDSixJQUFJLENBQUMsWUFBWSxFQUFFLENBQUM7SUFDdEIsQ0FBQztJQUVEOzs7O09BSUc7SUFDSCxLQUFLLENBQUMsTUFBTSxDQUFDLElBQWM7UUFDekIsTUFBTSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsUUFBUSxFQUFFLFFBQVEsRUFBRSxHQUFHLElBQUksQ0FBQztRQUNoRCxJQUFJLE9BQWUsQ0FBQztRQUNwQixJQUFJLFlBQW9CLENBQUM7UUFDekIsSUFBSSxhQUFxQixDQUFDO1FBRTFCLElBQUksT0FBTyxRQUFRLEtBQUssUUFBUSxFQUFFLENBQUM7WUFDakMsWUFBWSxHQUFHLE1BQU0s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

package/dist/task.d.ts

@@ -60,6 +60,11 @@ export declare class Task<T extends Record<string, any> = Record<string, any>> {
      * @returns true if the task has a date schedule
      */
     isDate(): boolean;
+    /**
+     * The timezone for the task schedule.
+     * Returns undefined if no timezone is defined.
+     */
+    get timezone(): string | undefined;
     /**
      * Determines if the task is ready to be executed.
      *

package/dist/task.js

@@ -63,7 +63,7 @@ class Task {
      * @returns true if the task has a cron schedule
      */
     isCron() {
-        return this.schedule?.type === 'cron';
+        return typeof this.schedule === 'string';
     }
     /**
      * Checks if this task uses date-based scheduling.
@@ -71,7 +71,16 @@ class Task {
      * @returns true if the task has a date schedule
      */
     isDate() {
-        return this.schedule?.type === 'date';
+        if (this.schedule == null)
+            return false;
+        return this.schedule instanceof Date || typeof this.schedule === 'number';
+    }
+    /**
+     * The timezone for the task schedule.
+     * Returns undefined if no timezone is defined.
+     */
+    get timezone() {
+        return this.data.timezone ?? undefined;
     }
     /**
      * Determines if the task is ready to be executed.
@@ -126,4 +135,4 @@ exports.Task = Task;
 function task(data) {
     return new Task(data);
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFzay5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy90YXNrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQWlJQSxvQkFJQztBQWxJRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXlCRztBQUNILE1BQWEsSUFBSTtJQUNmOzs7O09BSUc7SUFDSCxZQUEyQixJQUF1QjtRQUF2QixTQUFJLEdBQUosSUFBSSxDQUFtQjtJQUFHLENBQUM7SUFFdEQ7OztPQUdHO0lBQ0gsSUFBVyxTQUFTO1FBQ2xCLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLElBQUksS0FBSyxDQUFDO0lBQ3RDLENBQUM7SUFFRDs7T0FFRztJQUNILElBQVcsSUFBSTtRQUNiLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUM7SUFDeEIsQ0FBQztJQUVEOzs7T0FHRztJQUNILElBQVcsUUFBUTtRQUNqQixPQUFPLElBQUksQ0FBQyxJQUFJLENBQUMsUUFBUSxJQUFJLElBQUksQ0FBQztJQUNwQyxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNJLE1BQU07UUFDWCxPQUFPLElBQUksQ0FBQyxRQUFRLEVBQUUsSUFBSSxLQUFLLE1BQU0sQ0FBQztJQUN4QyxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNJLE1BQU07UUFDWCxPQUFPLElBQUksQ0FBQyxRQUFRLEVBQUUsSUFBSSxLQUFLLE1BQU0sQ0FBQztJQUN4QyxDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSSxLQUFLLENBQUMsT0FBTyxDQUFDLEdBQW1CO1FBQ3RDLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQyxHQUFHLENBQUMsSUFBSSxJQUFJLENBQUM7SUFDMUMsQ0FBQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksS0FBSyxDQUFDLE9BQU8sQ0FBQyxHQUFtQjtRQUN0QyxNQUFNLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQy9CLENBQUM7Q0FDRjtBQTFFRCxvQkEwRUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F1Qkc7QUFDSCxTQUFnQixJQUFJLENBQ2xCLElBQXVCO0lBRXZCLE9BQU8sSUFBSSxJQUFJLENBQUksSUFBSSxDQUFDLENBQUM7QUFDM0IsQ0FBQyJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFzay5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uL3NyYy90YXNrLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQTBJQSxvQkFJQztBQTNJRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXlCRztBQUNILE1BQWEsSUFBSTtJQUNmOzs7O09BSUc7SUFDSCxZQUEyQixJQUF1QjtRQUF2QixTQUFJLEdBQUosSUFBSSxDQUFtQjtJQUFHLENBQUM7SUFFdEQ7OztPQUdHO0lBQ0gsSUFBVyxTQUFTO1FBQ2xCLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxTQUFTLElBQUksS0FBSyxDQUFDO0lBQ3RDLENBQUM7SUFFRDs7T0FFRztJQUNILElBQVcsSUFBSTtRQUNiLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUM7SUFDeEIsQ0FBQztJQUVEOzs7T0FHRztJQUNILElBQVcsUUFBUTtRQUNqQixPQUFPLElBQUksQ0FBQyxJQUFJLENBQUMsUUFBUSxJQUFJLElBQUksQ0FBQztJQUNwQyxDQUFDO0lBRUQ7Ozs7T0FJRztJQUNJLE1BQU07UUFDWCxPQUFPLE9BQU8sSUFBSSxDQUFDLFFBQVEsS0FBSyxRQUFRLENBQUM7SUFDM0MsQ0FBQztJQUVEOzs7O09BSUc7SUFDSSxNQUFNO1FBQ1gsSUFBSSxJQUFJLENBQUMsUUFBUSxJQUFJLElBQUk7WUFBRSxPQUFPLEtBQUssQ0FBQztRQUN4QyxPQUFPLElBQUksQ0FBQyxRQUFRLFlBQVksSUFBSSxJQUFJLE9BQU8sSUFBSSxDQUFDLFFBQVEsS0FBSyxRQUFRLENBQUM7SUFDNUUsQ0FBQztJQUVEOzs7T0FHRztJQUNILElBQVcsUUFBUTtRQUNqQixPQUFPLElBQUksQ0FBQyxJQUFJLENBQUMsUUFBUSxJQUFJLFNBQVMsQ0FBQztJQUN6QyxDQUFDO0lBRUQ7Ozs7Ozs7O09BUUc7SUFDSSxLQUFLLENBQUMsT0FBTyxDQUFDLEdBQW1CO1FBQ3RDLE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQyxHQUFHLENBQUMsSUFBSSxJQUFJLENBQUM7SUFDMUMsQ0FBQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksS0FBSyxDQUFDLE9BQU8sQ0FBQyxHQUFtQjtRQUN0QyxNQUFNLElBQUksQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQy9CLENBQUM7Q0FDRjtBQW5GRCxvQkFtRkM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0F1Qkc7QUFDSCxTQUFnQixJQUFJLENBQ2xCLElBQXVCO0lBRXZCLE9BQU8sSUFBSSxJQUFJLENBQUksSUFBSSxDQUFDLENBQUM7QUFDM0IsQ0FBQyJ9

package/dist/types.d.ts

@@ -5,21 +5,7 @@ import { TaskContext } from './context';
  * Tasks can be scheduled using either cron expressions or specific dates/timestamps.
  * The timezone is optional and defaults to the system timezone.
  */
-export type TaskSchedule = {
-    /** Schedule type using cron expressions */
-    type: 'cron';
-    /** Optional timezone for the cron schedule (e.g., 'UTC', 'America/New_York') */
-    timezone?: string;
-    /** Cron expression (e.g., '0 0 * * *' for daily at midnight) */
-    value: string;
-} | {
-    /** Schedule type using a specific date or timestamp */
-    type: 'date';
-    /** Optional timezone for the date schedule */
-    timezone?: string;
-    /** Date object or Unix timestamp in milliseconds */
-    value: Date | number;
-};
+export type TaskSchedule = string | Date | number;
 /**
  * Defines a task with its execution logic and scheduling.
  *
@@ -31,6 +17,8 @@ export interface TaskDefinition<T extends Record<string, any> = Record<string, a
     name: string;
     /** Optional schedule configuration for recurring or delayed execution */
     schedule?: TaskSchedule;
+    /** Optional timezone for the schedule */
+    timezone?: string;
     /** Whether the task should run immediately when created (only for cron tasks) */
     immediate?: boolean;
     /**
@@ -56,6 +44,8 @@ export interface TaskData<T extends Record<string, any> = Record<string, any>> {
     data: T;
     /** Schedule configuration for when the task should run */
     schedule: TaskSchedule;
+    /** Optional timezone for the schedule */
+    timezone?: string;
     /** Whether the task should run immediately when created */
     immediate?: boolean;
 }
@@ -71,7 +61,7 @@ export type PartialTaskData<T extends Record<string, any> = Record<string, any>>
  * This includes the task metadata and execution timestamp, but excludes
  * scheduling information since the task is already being executed.
  */
-export type TaskExecutionData = Omit<TaskData, 'schedule' | 'immediate'> & {
+export type TaskExecutionData = Omit<TaskData, 'schedule' | 'immediate' | 'timezone'> & {
     /** Unix timestamp when the task execution started */
     timestamp: number;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commandkit/tasks",
-  "version": "0.0.0-dev.20250725125550",
+  "version": "0.0.0-dev.20250726103524",
   "description": "Task management plugin for CommandKit",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -15,10 +15,10 @@
       "import": "./dist/drivers/bullmq.js",
       "require": "./dist/drivers/bullmq.js"
     },
-    "./hypercron": {
-      "types": "./dist/drivers/hypercron.d.ts",
-      "import": "./dist/drivers/hypercron.js",
-      "require": "./dist/drivers/hypercron.js"
+    "./sqlite": {
+      "types": "./dist/drivers/sqlite.d.ts",
+      "import": "./dist/drivers/sqlite.js",
+      "require": "./dist/drivers/sqlite.js"
     }
   },
   "files": [
@@ -44,10 +44,9 @@
   "homepage": "https://github.com/underctrl-io/commandkit#readme",
   "devDependencies": {
     "bullmq": "^5.56.5",
-    "hypercron": "^0.1.0",
     "typescript": "^5.8.3",
-    "tsconfig": "0.0.0-dev.20250725125550",
-    "commandkit": "1.0.0-dev.20250725125550"
+    "tsconfig": "0.0.0-dev.20250726103524",
+    "commandkit": "1.0.0-dev.20250726103524"
   },
   "dependencies": {
     "cron-parser": "^4.9.0"

package/dist/drivers/hypercron.d.ts

@@ -1,69 +0,0 @@
-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

@@ -1,90 +0,0 @@
-"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=