pg-boss 10.3.2 → 10.4.0

package/.claude/settings.local.json

@@ -0,0 +1,15 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(node:*)",
+      "Bash(for:*)",
+      "Bash(do mv \"$file\" \"$file%.js.ts\")",
+      "Bash(done)",
+      "Bash(find:*)",
+      "Bash(npm test:*)",
+      "mcp__ide__getDiagnostics"
+    ],
+    "deny": [],
+    "ask": []
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pg-boss",
-  "version": "10.3.2",
+  "version": "10.4.0",
   "description": "Queueing jobs in Postgres from Node.js like a boss",
   "main": "./src/index.js",
   "engines": {
@@ -8,12 +8,12 @@
   },
   "dependencies": {
     "cron-parser": "^4.9.0",
-    "pg": "^8.16.0",
+    "pg": "^8.16.3",
     "serialize-error": "^8.1.0"
   },
   "devDependencies": {
-    "@types/node": "^20.17.57",
-    "luxon": "^3.6.1",
+    "@types/node": "^20.19.13",
+    "luxon": "^3.7.2",
     "mocha": "^10.8.2",
     "nyc": "^17.1.0",
     "standard": "^17.1.2"

package/src/plans.js

@@ -506,7 +506,7 @@ function insertVersion (schema, version) {
 function fetchNextJob (schema) {
   return ({ includeMetadata, priority = true, ignoreStartAfter = false } = {}) => `
     WITH next as (
-      SELECT id
+      SELECT id, singleton_key, policy
       FROM ${schema}.job
       WHERE name = $1
         AND state < '${JOB_STATES.active}'
@@ -514,13 +514,28 @@ function fetchNextJob (schema) {
       ORDER BY ${priority ? 'priority desc, ' : ''}created_on, id
       LIMIT $2
       FOR UPDATE SKIP LOCKED
+    ), grouped as (
+      SELECT
+        n.id,
+        n.policy as grouped_policy,
+        row_number() OVER (
+          PARTITION BY CASE
+            WHEN $2 > 1 AND n.policy in ('${QUEUE_POLICIES.singleton}', '${QUEUE_POLICIES.stately}') THEN n.singleton_key -- gate singleton/stately by key per batch
+            ELSE n.id::text
+          END
+        ) as row_number
+      FROM next n
     )
     UPDATE ${schema}.job j SET
       state = '${JOB_STATES.active}',
       started_on = now(),
       retry_count = CASE WHEN started_on IS NOT NULL THEN retry_count + 1 ELSE retry_count END
-    FROM next
-    WHERE name = $1 AND j.id = next.id
+    FROM grouped
+    WHERE name = $1 AND j.id = grouped.id
+      AND (
+        (grouped.grouped_policy IN ('${QUEUE_POLICIES.singleton}', '${QUEUE_POLICIES.stately}') AND grouped.row_number = 1) -- only one per singleton key
+        OR COALESCE(grouped.grouped_policy, '') NOT IN ('${QUEUE_POLICIES.singleton}', '${QUEUE_POLICIES.stately}') -- other policies unaffected
+      )
     RETURNING j.${includeMetadata ? allJobColumns : baseJobColumns}
   `
 }

package/types.d.ts

@@ -25,7 +25,7 @@ declare namespace PgBoss {
     application_name?: string;
     database?: string;
     user?: string;
-    password?: string;
+    password?: string | (() => string) | (() => Promise<string>);
     host?: string;
     port?: number;
     schema?: string;
@@ -370,6 +370,8 @@ declare class PgBoss extends EventEmitter {
   schedule(name: string, cron: string, data?: object, options?: PgBoss.ScheduleOptions): Promise<void>;
   unschedule(name: string): Promise<void>;
   getSchedules(): Promise<PgBoss.Schedule[]>;
+
+  getDb(): PgBoss.Db;
 }
 
 export = PgBoss;