@checkstack/queue-api 0.1.3 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,36 @@
 # @checkstack/queue-api
 
+## 0.2.1
+
+### Patch Changes
+
+- @checkstack/backend-api@0.5.1
+
+## 0.2.0
+
+### Minor Changes
+
+- 2c0822d: ### Queue System
+
+  - Added cron pattern support to `scheduleRecurring()` - accepts either `intervalSeconds` or `cronPattern`
+  - BullMQ backend uses native cron scheduling via `pattern` option
+  - InMemoryQueue implements wall-clock cron scheduling with `cron-parser`
+
+  ### Maintenance Backend
+
+  - Auto status transitions now use cron pattern `* * * * *` for precise second-0 scheduling
+  - User notifications are now sent for auto-started and auto-completed maintenances
+  - Refactored to call `addUpdate` RPC for status changes, centralizing hook/signal/notification logic
+
+  ### UI
+
+  - DateTimePicker now resets seconds and milliseconds to 0 when time is changed
+
+### Patch Changes
+
+- Updated dependencies [66a3963]
+  - @checkstack/backend-api@0.5.0
+
 ## 0.1.3
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/queue-api",
-  "version": "0.1.3",
+  "version": "0.2.1",
   "type": "module",
   "main": "src/index.ts",
   "dependencies": {

package/src/queue-plugin.ts

@@ -1,5 +1,5 @@
 import { z } from "zod";
-import type { Queue, QueueStats } from "./queue";
+import type { Queue, QueueStats, RecurringSchedule } from "./queue";
 import type { Migration, Logger } from "@checkstack/backend-api";
 
 export interface QueuePlugin<Config = unknown> {
@@ -37,12 +37,11 @@ export interface SwitchResult {
 /**
  * Info about a recurring job across all queues
  */
-export interface RecurringJobInfo {
+export type RecurringJobInfo = {
   queueName: string;
   jobId: string;
-  intervalSeconds: number;
   nextRunAt?: Date;
-}
+} & RecurringSchedule;
 
 /**
  * QueueManager handles queue creation, backend switching, and multi-instance coordination.

package/src/queue.ts

@@ -9,16 +9,22 @@ export interface QueueJob<T = unknown> {
   attempts?: number;
 }
 
+/**
+ * Schedule configuration: either interval-based or cron-based
+ */
+export type RecurringSchedule =
+  | { intervalSeconds: number; cronPattern?: never }
+  | { cronPattern: string; intervalSeconds?: never };
+
 /**
  * Details of a recurring job for migration purposes
  */
-export interface RecurringJobDetails<T = unknown> {
+export type RecurringJobDetails<T = unknown> = {
   jobId: string;
   data: T;
-  intervalSeconds: number;
   priority?: number;
   nextRunAt?: Date;
-}
+} & RecurringSchedule;
 
 export interface QueueConsumer<T = unknown> {
   (job: QueueJob<T>): Promise<void>;
@@ -62,7 +68,7 @@ export interface Queue<T = unknown> {
        * If provided and a job with this ID already exists, behavior depends on queue implementation
        */
       jobId?: string;
-    }
+    },
   ): Promise<string>;
 
   /**
@@ -73,7 +79,9 @@ export interface Queue<T = unknown> {
   consume(consumer: QueueConsumer<T>, options: ConsumeOptions): Promise<void>;
 
   /**
-   * Schedule a recurring job that executes at regular intervals.
+   * Schedule a recurring job that executes at regular intervals or on a cron schedule.
+   *
+   * Accepts EITHER `intervalSeconds` (fixed interval) OR `cronPattern` (cron expression).
    *
    * UPDATE SEMANTICS: Calling this method with an existing jobId will UPDATE
    * the recurring job configuration (interval, payload, priority, etc.).
@@ -94,13 +102,11 @@ export interface Queue<T = unknown> {
        * Calling scheduleRecurring with the same jobId updates the existing job.
        */
       jobId: string;
-      /** Interval in seconds between executions */
-      intervalSeconds: number;
       /** Optional delay before first execution (for delta-based scheduling) */
       startDelay?: number;
       /** Optional priority */
       priority?: number;
-    }
+    } & RecurringSchedule,
   ): Promise<string>;
 
   /**
@@ -122,7 +128,7 @@ export interface Queue<T = unknown> {
    * @returns Job details or undefined if not found
    */
   getRecurringJobDetails(
-    jobId: string
+    jobId: string,
   ): Promise<RecurringJobDetails<T> | undefined>;
 
   /**