@checkstack/queue-bullmq-backend 0.0.4 → 0.1.1

package/CHANGELOG.md

@@ -1,5 +1,108 @@
 # @checkstack/queue-bullmq-backend
 
+## 0.1.1
+
+### 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
+
+- Updated dependencies [9a27800]
+  - @checkstack/queue-api@0.0.6
+  - @checkstack/backend-api@0.3.1
+
+## 0.1.0
+
+### Minor Changes
+
+- 9faec1f: # Unified AccessRule Terminology Refactoring
+
+  This release completes a comprehensive terminology refactoring from "permission" to "accessRule" across the entire codebase, establishing a consistent and modern access control vocabulary.
+
+  ## Changes
+
+  ### Core Infrastructure (`@checkstack/common`)
+
+  - Introduced `AccessRule` interface as the primary access control type
+  - Added `accessPair()` helper for creating read/manage access rule pairs
+  - Added `access()` builder for individual access rules
+  - Replaced `Permission` type with `AccessRule` throughout
+
+  ### API Changes
+
+  - `env.registerPermissions()` → `env.registerAccessRules()`
+  - `meta.permissions` → `meta.access` in RPC contracts
+  - `usePermission()` → `useAccess()` in frontend hooks
+  - Route `permission:` field → `accessRule:` field
+
+  ### UI Changes
+
+  - "Roles & Permissions" tab → "Roles & Access Rules"
+  - "You don't have permission..." → "You don't have access..."
+  - All permission-related UI text updated
+
+  ### Documentation & Templates
+
+  - Updated 18 documentation files with AccessRule terminology
+  - Updated 7 scaffolding templates with `accessPair()` pattern
+  - All code examples use new AccessRule API
+
+  ## Migration Guide
+
+  ### Backend Plugins
+
+  ```diff
+  - import { permissionList } from "./permissions";
+  - env.registerPermissions(permissionList);
+  + import { accessRules } from "./access";
+  + env.registerAccessRules(accessRules);
+  ```
+
+  ### RPC Contracts
+
+  ```diff
+  - .meta({ userType: "user", permissions: [permissions.read.id] })
+  + .meta({ userType: "user", access: [access.read] })
+  ```
+
+  ### Frontend Hooks
+
+  ```diff
+  - const canRead = accessApi.usePermission(permissions.read.id);
+  + const canRead = accessApi.useAccess(access.read);
+  ```
+
+  ### Routes
+
+  ```diff
+  - permission: permissions.entityRead.id,
+  + accessRule: access.read,
+  ```
+
+### Patch Changes
+
+- Updated dependencies [9faec1f]
+- Updated dependencies [827b286]
+- Updated dependencies [f533141]
+- Updated dependencies [aa4a8ab]
+  - @checkstack/backend-api@0.3.0
+  - @checkstack/common@0.2.0
+  - @checkstack/queue-bullmq-common@0.1.0
+  - @checkstack/queue-api@0.0.5
+
 ## 0.0.4
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@checkstack/queue-bullmq-backend",
-  "version": "0.0.4",
+  "version": "0.1.1",
   "type": "module",
   "main": "src/index.ts",
   "scripts": {

package/src/index.ts

@@ -1,15 +1,12 @@
-import {
-  createBackendPlugin,
-  coreServices,
-} from "@checkstack/backend-api";
+import { createBackendPlugin, coreServices } from "@checkstack/backend-api";
 import { BullMQPlugin } from "./plugin";
-import { permissionList } from "@checkstack/queue-bullmq-common";
+import { queueBullmqAccessRules } from "@checkstack/queue-bullmq-common";
 import { pluginMetadata } from "./plugin-metadata";
 
 export default createBackendPlugin({
   metadata: pluginMetadata,
   register(env) {
-    env.registerPermissions(permissionList);
+    env.registerAccessRules(queueBullmqAccessRules);
 
     env.registerInit({
       deps: {

package/src/plugin.ts

@@ -1,5 +1,9 @@
 import { QueuePlugin, Queue } from "@checkstack/queue-api";
-import { configString, configNumber } from "@checkstack/backend-api";
+import {
+  configString,
+  configNumber,
+  type Logger,
+} from "@checkstack/backend-api";
 import { z } from "zod";
 import { BullMQQueue } from "./bullmq-queue";
 
@@ -30,7 +34,12 @@ export class BullMQPlugin implements QueuePlugin<BullMQConfig> {
   configVersion = 1;
   configSchema = configSchema;
 
-  createQueue<T>(name: string, config: BullMQConfig): Queue<T> {
+  createQueue<T>(
+    name: string,
+    config: BullMQConfig,
+    _logger: Logger
+  ): Queue<T> {
+    // Note: BullMQ has its own logging via Redis events
     return new BullMQQueue<T>(name, config);
   }
 }