@checkstack/queue-api 0.0.5 → 0.1.0

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # @checkstack/queue-api
 
+## 0.1.0
+
+### Minor Changes
+
+- 180be38: # Queue Lag Warning
+
+  Added a queue lag warning system that displays alerts when pending jobs exceed configurable thresholds.
+
+  ## Features
+
+  - **Backend Stats API**: New `getStats`, `getLagStatus`, and `updateLagThresholds` RPC endpoints
+  - **Signal-based Updates**: `QUEUE_LAG_CHANGED` signal for real-time frontend updates
+  - **Aggregated Stats**: `QueueManager.getAggregatedStats()` sums stats across all queues
+  - **Configurable Thresholds**: Warning (default 100) and Critical (default 500) thresholds stored in config
+  - **Dashboard Integration**: Queue lag alert displayed on main Dashboard (access-gated)
+  - **Queue Settings Page**: Lag alert and Performance Tuning guidance card with concurrency tips
+
+  ## UI Changes
+
+  - Queue lag alert banner appears on Dashboard and Queue Settings when pending jobs exceed thresholds
+  - New "Performance Tuning" card with concurrency settings guidance and bottleneck indicators
+
+### Patch Changes
+
+- Updated dependencies [7a23261]
+  - @checkstack/backend-api@0.3.2
+
+## 0.0.6
+
+### Patch Changes
+
+- 9a27800: Fix recurring jobs resilience and add logger support
+
+  **Rescheduling Fix:**
+  Previously, recurring job rescheduling logic was inside the `try` block of `processJob()`. When a job handler threw an exception and `maxRetries` was exhausted (or 0), the recurring job would never be rescheduled, permanently breaking the scheduling chain.
+
+  This fix moves the rescheduling logic to the `finally` block, ensuring recurring jobs are always rescheduled after execution, regardless of success or failure.
+
+  **Heartbeat Mechanism:**
+  Added a periodic heartbeat (default: 5 seconds) that checks for ready jobs and triggers processing. This ensures jobs are processed even if `setTimeout` callbacks fail to fire (e.g., after system sleep/wake cycles). Configurable via `heartbeatIntervalMs` option; set to 0 to disable.
+
+  **Logger Service Integration:**
+
+  - Added optional `logger` parameter to `QueuePlugin.createQueue()` interface
+  - `InMemoryQueue` now uses the provided logger instead of raw `console.error`
+  - Consistent with the rest of the codebase's logging patterns
+  - @checkstack/backend-api@0.3.1
+
 ## 0.0.5
 
 ### Patch Changes

package/package.json

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

package/src/queue-plugin.ts

@@ -1,6 +1,6 @@
 import { z } from "zod";
-import type { Queue } from "./queue";
-import type { Migration } from "@checkstack/backend-api";
+import type { Queue, QueueStats } from "./queue";
+import type { Migration, Logger } from "@checkstack/backend-api";
 
 export interface QueuePlugin<Config = unknown> {
   id: string;
@@ -16,7 +16,7 @@ export interface QueuePlugin<Config = unknown> {
   /** Optional migrations for backward compatibility */
   migrations?: Migration<unknown, unknown>[];
 
-  createQueue<T>(name: string, config: Config): Queue<T>;
+  createQueue<T>(name: string, config: Config, logger: Logger): Queue<T>;
 }
 
 export interface QueuePluginRegistry {
@@ -84,6 +84,12 @@ export interface QueueManager {
    */
   getInFlightJobCount(): Promise<number>;
 
+  /**
+   * Get aggregated statistics across all queues.
+   * Used for monitoring and lag detection.
+   */
+  getAggregatedStats(): Promise<QueueStats>;
+
   /**
    * List all recurring jobs across all queues.
    * Used for migration preview.