@pikku/queue-pg-boss 0.12.4 → 0.12.6

package/CHANGELOG.md

@@ -1,3 +1,29 @@
+## 0.12.6
+
+### Patch Changes
+
+- 41ce2cb: Upgrade to TypeScript 6 and raise the minimum Node.js version to 22.
+
+  All packages now build against `typescript@^6.0.3` and declare `engines.node >= 22`. Internal tooling (`ts-json-schema-generator`, `zod-to-ts`) was bumped to TypeScript 6-compatible releases.
+
+- Updated dependencies [41ce2cb]
+  - @pikku/core@0.12.44
+
+## 0.12.5
+
+### Patch Changes
+
+- 05aba57: fix(scheduler): prune orphaned recurring-task schedules on start
+
+  When a scheduled task is removed from code, its pg-boss schedule row survived and
+  kept producing jobs into a queue with no registered worker — the jobs piled up as
+  'created' forever and could flood the queue (thousands of stuck jobs). `start()`
+  now drops any `pikku-recurring-scheduled-task_*` schedule and queue that is no
+  longer registered, so task removals self-heal on the next boot.
+
+- Updated dependencies [a8022e5]
+  - @pikku/core@0.12.43
+
 ## 0.12.4
 
 ### Patch Changes

package/dist/pg-boss-scheduler-service.js

@@ -1,6 +1,8 @@
 import { SchedulerService, parseDurationString } from '@pikku/core';
 import { pikkuState } from '@pikku/core/internal';
 import { runScheduledTask, getScheduledTasks } from '@pikku/core/scheduler';
+/** Prefix for pg-boss queues/schedules backing recurring scheduled tasks. */
+const RECURRING_TASK_PREFIX = 'pikku-recurring-scheduled-task_';
 /**
  * pg-boss scheduler service implementation
  * Uses pg-boss's schedule() API to store recurring jobs in PostgreSQL.
@@ -88,8 +90,10 @@ export class PgBossSchedulerService extends SchedulerService {
     async start() {
         const logger = pikkuState(null, 'package', 'singletonServices').logger;
         const scheduledTasks = getScheduledTasks();
+        const expectedCronNames = new Set();
         for (const [name, task] of scheduledTasks) {
-            const cronName = `pikku-recurring-scheduled-task_${name.replace(/[^a-zA-Z0-9_\-.]/g, '_')}`;
+            const cronName = `${RECURRING_TASK_PREFIX}${name.replace(/[^a-zA-Z0-9_\-.]/g, '_')}`;
+            expectedCronNames.add(cronName);
             await this.pgBoss.createQueue(cronName);
             await this.pgBoss.schedule(cronName, task.schedule, {
                 rpcName: name,
@@ -104,6 +108,25 @@ export class PgBossSchedulerService extends SchedulerService {
                 }
             });
         }
+        // Prune orphaned schedules. A task removed from code leaves its pg-boss
+        // schedule behind; with no worker registered it keeps producing jobs that
+        // pile up as 'created' forever (this is how a removed task flooded a queue
+        // with thousands of stuck jobs). Drop any recurring schedule + queue that's
+        // no longer registered so task removals self-heal on the next boot.
+        try {
+            const existing = await this.pgBoss.getSchedules();
+            for (const schedule of existing) {
+                if (schedule.name.startsWith(RECURRING_TASK_PREFIX) &&
+                    !expectedCronNames.has(schedule.name)) {
+                    await this.pgBoss.unschedule(schedule.name);
+                    await this.pgBoss.deleteQueue(schedule.name);
+                    logger.warn(`Pruned orphaned scheduled task queue: ${schedule.name}`);
+                }
+            }
+        }
+        catch (err) {
+            logger.warn(`Failed to prune orphaned scheduled tasks: ${err instanceof Error ? err.message : String(err)}`);
+        }
     }
     /**
      * Stop recurring scheduled tasks by unscheduling them from pg-boss.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pikku/queue-pg-boss",
-  "version": "0.12.4",
+  "version": "0.12.6",
   "author": "yasser.fadl@gmail.com",
   "license": "MIT",
   "module": "dist/index.js",
@@ -15,13 +15,13 @@
     "prepublishOnly": "yarn build"
   },
   "peerDependencies": {
-    "@pikku/core": "^0.12.38"
+    "@pikku/core": "^0.12.44"
   },
   "dependencies": {
     "pg-boss": "^12.14.0"
   },
   "devDependencies": {
-    "typescript": "^5.9"
+    "typescript": "^6.0.3"
   },
   "exports": {
     ".": "./dist/index.js"

package/src/pg-boss-scheduler-service.ts

@@ -17,6 +17,9 @@ interface ScheduledJobData {
   session?: CoreUserSession
 }
 
+/** Prefix for pg-boss queues/schedules backing recurring scheduled tasks. */
+const RECURRING_TASK_PREFIX = 'pikku-recurring-scheduled-task_'
+
 /**
  * pg-boss scheduler service implementation
  * Uses pg-boss's schedule() API to store recurring jobs in PostgreSQL.
@@ -131,8 +134,10 @@ export class PgBossSchedulerService extends SchedulerService {
     const logger = pikkuState(null, 'package', 'singletonServices')!.logger
     const scheduledTasks = getScheduledTasks()
 
+    const expectedCronNames = new Set<string>()
     for (const [name, task] of scheduledTasks) {
-      const cronName = `pikku-recurring-scheduled-task_${name.replace(/[^a-zA-Z0-9_\-.]/g, '_')}`
+      const cronName = `${RECURRING_TASK_PREFIX}${name.replace(/[^a-zA-Z0-9_\-.]/g, '_')}`
+      expectedCronNames.add(cronName)
       await this.pgBoss.createQueue(cronName)
       await this.pgBoss.schedule(cronName, task.schedule, {
         rpcName: name,
@@ -148,6 +153,29 @@ export class PgBossSchedulerService extends SchedulerService {
         }
       })
     }
+
+    // Prune orphaned schedules. A task removed from code leaves its pg-boss
+    // schedule behind; with no worker registered it keeps producing jobs that
+    // pile up as 'created' forever (this is how a removed task flooded a queue
+    // with thousands of stuck jobs). Drop any recurring schedule + queue that's
+    // no longer registered so task removals self-heal on the next boot.
+    try {
+      const existing = await this.pgBoss.getSchedules()
+      for (const schedule of existing) {
+        if (
+          schedule.name.startsWith(RECURRING_TASK_PREFIX) &&
+          !expectedCronNames.has(schedule.name)
+        ) {
+          await this.pgBoss.unschedule(schedule.name)
+          await this.pgBoss.deleteQueue(schedule.name)
+          logger.warn(`Pruned orphaned scheduled task queue: ${schedule.name}`)
+        }
+      }
+    } catch (err) {
+      logger.warn(
+        `Failed to prune orphaned scheduled tasks: ${err instanceof Error ? err.message : String(err)}`
+      )
+    }
   }
 
   /**

package/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["./src/index.ts","./src/pg-boss-queue-service.ts","./src/pg-boss-queue-worker.ts","./src/pg-boss-scheduler-service.ts","./src/pg-boss-service-factory.ts","./src/utils.ts"],"version":"5.9.3"}
+{"root":["./src/index.ts","./src/pg-boss-queue-service.ts","./src/pg-boss-queue-worker.ts","./src/pg-boss-scheduler-service.ts","./src/pg-boss-service-factory.ts","./src/utils.ts"],"version":"6.0.3"}