@yellowpanther/shared 1.2.5 → 1.2.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yellowpanther/shared",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "publishConfig": {
     "access": "public"
   },
@@ -40,6 +40,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "dotenv": "^17.2.2"
+    "dotenv": "^17.2.2",
+    "joi": "^18.0.1"
   }
 }

package/src/queue/articlePublishQueue.js

@@ -2,18 +2,18 @@
 // One-off *publish* scheduler for article items (BullMQ).
 // Strong upsert: purge any prior job for the same article before adding a new delayed job.
 
-const { Queue } = require('bullmq');
-const redisClient = require('../redis/redisClient');
+const { Queue } = require("bullmq");
+const redisClient = require("../redis/redisClient");
 // const logger = require('../logger'); // uncomment if you have a shared logger
 
-const DEBUG = String(process.env.DEBUG_LOGGER || '').trim() === '1';
+const DEBUG = String(process.env.DEBUG_LOGGER || "").trim() === "1";
 const DRIFT_MS = Math.max(0, Number(process.env.SCHEDULE_DRIFT_MS || 250));
 
-const articlePublishQueue = new Queue('articlePublishQueue', {
+const articlePublishQueue = new Queue("articlePublishQueue", {
   connection: redisClient,
   defaultJobOptions: {
     attempts: 5,
-    backoff: { type: 'exponential', delay: 2000 },
+    backoff: { type: "exponential", delay: 2000 },
     removeOnComplete: 500,
     removeOnFail: 500,
   },
@@ -21,11 +21,19 @@ const articlePublishQueue = new Queue('articlePublishQueue', {
 
 // --- ID helpers --------------------------------------------------------------
 
+/** Replace invalid chars for BullMQ IDs */
+function sanitizeId(str) {
+  return str.replace(/[:.]/g, "-");
+}
+
+/** Stable id (latest schedule) */
 function stableJobId(article_id) {
-  return `article:publish:${article_id}`;
+  return sanitizeId(`article:publish:${article_id}`);
 }
+
+/** Versioned id (keeps history distinct) */
 function versionedJobId(article_id, runAtIso) {
-  return `article:publish:${article_id}:${runAtIso}`;
+  return sanitizeId(`article:publish:${article_id}:${runAtIso}`);
 }
 
 // --- Time helpers ------------------------------------------------------------
@@ -33,19 +41,21 @@ function versionedJobId(article_id, runAtIso) {
 /** Parse anything into a UTC Date. Strings without timezone are treated as UTC. */
 function normalizeToUtcDate(input) {
   if (input instanceof Date) return new Date(input.getTime());
-  if (typeof input === 'number') return new Date(input); // epoch ms
+  if (typeof input === "number") return new Date(input); // epoch ms
 
-  if (typeof input === 'string') {
+  if (typeof input === "string") {
     // Has timezone (Z or ±hh:mm)
     if (/[zZ]|[+\-]\d{2}:\d{2}$/.test(input)) {
       const d = new Date(input);
-      if (Number.isNaN(d.getTime())) throw new Error(`Invalid ISO datetime: ${input}`);
+      if (Number.isNaN(d.getTime()))
+        throw new Error(`Invalid ISO datetime: ${input}`);
       return d;
     }
     // No timezone => treat as UTC
-    const s = input.trim().replace(' ', 'T');
+    const s = input.trim().replace(" ", "T");
     const d = new Date(`${s}Z`);
-    if (Number.isNaN(d.getTime())) throw new Error(`Invalid datetime (no tz): ${input}`);
+    if (Number.isNaN(d.getTime()))
+      throw new Error(`Invalid datetime (no tz): ${input}`);
     return d;
   }
 
@@ -55,10 +65,12 @@ function normalizeToUtcDate(input) {
 // --- Purge helpers -----------------------------------------------------------
 
 async function findPendingArticleJobs(article_id) {
-  const states = ['delayed', 'waiting', 'waiting-children', 'active'];
+  const states = ["delayed", "waiting", "waiting-children", "active"];
   const jobs = await articlePublishQueue.getJobs(states);
   return jobs.filter(
-    (j) => j?.name === 'article:publish' && j?.data?.article_id === String(article_id)
+    (j) =>
+      j?.name === "article:publish" &&
+      j?.data?.article_id === String(article_id)
   );
 }
 
@@ -72,7 +84,10 @@ async function purgeExistingForArticle(article_id) {
       await j.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[articlePublishQueue] failed to remove pending job ${j.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[articlePublishQueue] failed to remove pending job ${j.id}: ${e.message}`
+        );
     }
   }
 
@@ -83,12 +98,15 @@ async function purgeExistingForArticle(article_id) {
       await last.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[articlePublishQueue] failed to remove stable job ${last.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[articlePublishQueue] failed to remove stable job ${last.id}: ${e.message}`
+        );
     }
   }
 
   if (DEBUG) {
-    console.info('[articlePublishQueue] purgeExistingForArticle', {
+    console.info("[articlePublishQueue] purgeExistingForArticle", {
       article_id: String(article_id),
       removed,
     });
@@ -109,9 +127,16 @@ async function purgeExistingForArticle(article_id) {
  * @param {object} [params.extra]
  * @param {boolean} [params.useStableId=false] - if true, uses stable jobId
  */
-async function addArticlePublishJob({ article_id, runAtUtc, extra = {}, useStableId = false }) {
+async function addArticlePublishJob({
+  article_id,
+  runAtUtc,
+  extra = {},
+  useStableId = false,
+}) {
   if (!article_id || !runAtUtc) {
-    throw new Error('addArticlePublishJob: article_id and runAtUtc are required');
+    throw new Error(
+      "addArticlePublishJob: article_id and runAtUtc are required"
+    );
   }
 
   const runAt = normalizeToUtcDate(runAtUtc);
@@ -126,16 +151,18 @@ async function addArticlePublishJob({ article_id, runAtUtc, extra = {}, useStabl
   await purgeExistingForArticle(article_id);
 
   // Choose jobId strategy
-  const jobId = useStableId ? stableJobId(article_id) : versionedJobId(article_id, runAtIso);
+  const jobId = useStableId
+    ? stableJobId(article_id)
+    : versionedJobId(article_id, runAtIso);
 
   const job = await articlePublishQueue.add(
-    'article:publish',
+    "article:publish",
     { article_id: String(article_id), runAtUtc: runAtIso, extra },
     { jobId, delay: delayMs }
   );
 
   if (DEBUG) {
-    console.info('[articlePublishQueue] upsert', {
+    console.info("[articlePublishQueue] upsert", {
       article_id: String(article_id),
       jobId,
       runAtIso,
@@ -161,4 +188,4 @@ module.exports = {
   stableJobId,
   versionedJobId,
   normalizeToUtcDate,
-};
+};

package/src/queue/imageAlbumPublishQueue.js

@@ -2,18 +2,18 @@
 // One-off *publish* scheduler for image album items (BullMQ).
 // Strong upsert: purge any prior job for the same album before adding a new delayed job.
 
-const { Queue } = require('bullmq');
-const redisClient = require('../redis/redisClient');
+const { Queue } = require("bullmq");
+const redisClient = require("../redis/redisClient");
 // const logger = require('../logger'); // uncomment if you have a shared logger
 
-const DEBUG    = String(process.env.DEBUG_LOGGER || '').trim() === '1';
+const DEBUG = String(process.env.DEBUG_LOGGER || "").trim() === "1";
 const DRIFT_MS = Math.max(0, Number(process.env.SCHEDULE_DRIFT_MS || 250));
 
-const imageAlbumPublishQueue = new Queue('imageAlbumPublishQueue', {
+const imageAlbumPublishQueue = new Queue("imageAlbumPublishQueue", {
   connection: redisClient,
   defaultJobOptions: {
     attempts: 5,
-    backoff: { type: 'exponential', delay: 2000 },
+    backoff: { type: "exponential", delay: 2000 },
     removeOnComplete: 500,
     removeOnFail: 500,
   },
@@ -21,11 +21,19 @@ const imageAlbumPublishQueue = new Queue('imageAlbumPublishQueue', {
 
 // ── ID helpers ────────────────────────────────────────────────────────────────
 
+/** Replace invalid chars for BullMQ IDs */
+function sanitizeId(str) {
+  return str.replace(/[:.]/g, "-");
+}
+
+/** Stable id (latest schedule) */
 function stableJobId(album_id) {
-  return `imageAlbum:publish:${album_id}`;
+  return sanitizeId(`imageAlbum:publish:${album_id}`);
 }
+
+/** Versioned id (keeps history distinct) */
 function versionedJobId(album_id, runAtIso) {
-  return `imageAlbum:publish:${album_id}:${runAtIso}`;
+  return sanitizeId(`imageAlbum:publish:${album_id}:${runAtIso}`);
 }
 
 // ── Time helpers ──────────────────────────────────────────────────────────────
@@ -33,19 +41,21 @@ function versionedJobId(album_id, runAtIso) {
 /** Parse anything into a UTC Date. Strings without timezone are treated as UTC. */
 function normalizeToUtcDate(input) {
   if (input instanceof Date) return new Date(input.getTime());
-  if (typeof input === 'number') return new Date(input); // epoch ms
+  if (typeof input === "number") return new Date(input); // epoch ms
 
-  if (typeof input === 'string') {
+  if (typeof input === "string") {
     // Has timezone (Z or ±hh:mm)
     if (/[zZ]|[+\-]\d{2}:\d{2}$/.test(input)) {
       const d = new Date(input);
-      if (Number.isNaN(d.getTime())) throw new Error(`Invalid ISO datetime: ${input}`);
+      if (Number.isNaN(d.getTime()))
+        throw new Error(`Invalid ISO datetime: ${input}`);
       return d;
     }
     // No timezone => treat as UTC
-    const s = input.trim().replace(' ', 'T');
+    const s = input.trim().replace(" ", "T");
     const d = new Date(`${s}Z`);
-    if (Number.isNaN(d.getTime())) throw new Error(`Invalid datetime (no tz): ${input}`);
+    if (Number.isNaN(d.getTime()))
+      throw new Error(`Invalid datetime (no tz): ${input}`);
     return d;
   }
 
@@ -55,10 +65,11 @@ function normalizeToUtcDate(input) {
 // ── Purge helpers ────────────────────────────────────────────────────────────
 
 async function findPendingAlbumJobs(album_id) {
-  const states = ['delayed', 'waiting', 'waiting-children', 'active'];
+  const states = ["delayed", "waiting", "waiting-children", "active"];
   const jobs = await imageAlbumPublishQueue.getJobs(states);
   return jobs.filter(
-    (j) => j?.name === 'imageAlbum:publish' && j?.data?.album_id === String(album_id)
+    (j) =>
+      j?.name === "imageAlbum:publish" && j?.data?.album_id === String(album_id)
   );
 }
 
@@ -72,7 +83,10 @@ async function purgeExistingForAlbum(album_id) {
       await j.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[imageAlbumPublishQueue] failed to remove pending job ${j.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[imageAlbumPublishQueue] failed to remove pending job ${j.id}: ${e.message}`
+        );
     }
   }
 
@@ -83,12 +97,15 @@ async function purgeExistingForAlbum(album_id) {
       await last.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[imageAlbumPublishQueue] failed to remove stable job ${last.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[imageAlbumPublishQueue] failed to remove stable job ${last.id}: ${e.message}`
+        );
     }
   }
 
   if (DEBUG) {
-    console.info('[imageAlbumPublishQueue] purgeExistingForAlbum', {
+    console.info("[imageAlbumPublishQueue] purgeExistingForAlbum", {
       album_id: String(album_id),
       removed,
     });
@@ -109,9 +126,16 @@ async function purgeExistingForAlbum(album_id) {
  * @param {object} [params.extra]
  * @param {boolean} [params.useStableId=false] - if true, uses stable jobId
  */
-async function addImageAlbumPublishJob({ album_id, runAtUtc, extra = {}, useStableId = false }) {
+async function addImageAlbumPublishJob({
+  album_id,
+  runAtUtc,
+  extra = {},
+  useStableId = false,
+}) {
   if (!album_id || !runAtUtc) {
-    throw new Error('addImageAlbumPublishJob: album_id and runAtUtc are required');
+    throw new Error(
+      "addImageAlbumPublishJob: album_id and runAtUtc are required"
+    );
   }
 
   const runAt = normalizeToUtcDate(runAtUtc);
@@ -126,16 +150,18 @@ async function addImageAlbumPublishJob({ album_id, runAtUtc, extra = {}, useStab
   await purgeExistingForAlbum(album_id);
 
   // Choose jobId strategy
-  const jobId = useStableId ? stableJobId(album_id) : versionedJobId(album_id, runAtIso);
+  const jobId = useStableId
+    ? stableJobId(album_id)
+    : versionedJobId(album_id, runAtIso);
 
   const job = await imageAlbumPublishQueue.add(
-    'imageAlbum:publish',
+    "imageAlbum:publish",
     { album_id: String(album_id), runAtUtc: runAtIso, extra },
     { jobId, delay: delayMs }
   );
 
   if (DEBUG) {
-    console.info('[imageAlbumPublishQueue] upsert', {
+    console.info("[imageAlbumPublishQueue] upsert", {
       album_id: String(album_id),
       jobId,
       runAtIso,
@@ -161,4 +187,4 @@ module.exports = {
   stableJobId,
   versionedJobId,
   normalizeToUtcDate,
-};
+};

package/src/queue/imagePublishQueue.js

@@ -2,18 +2,18 @@
 // One-off *publish* scheduler for image items (BullMQ).
 // Strong upsert: purge any prior job for the same image before adding a new delayed job.
 
-const { Queue } = require('bullmq');
-const redisClient = require('../redis/redisClient');
+const { Queue } = require("bullmq");
+const redisClient = require("../redis/redisClient");
 // const logger = require('../logger'); // uncomment if you have a shared logger
 
-const DEBUG    = String(process.env.DEBUG_LOGGER || '').trim() === '1';
+const DEBUG = String(process.env.DEBUG_LOGGER || "").trim() === "1";
 const DRIFT_MS = Math.max(0, Number(process.env.SCHEDULE_DRIFT_MS || 250));
 
-const imagePublishQueue = new Queue('imagePublishQueue', {
+const imagePublishQueue = new Queue("imagePublishQueue", {
   connection: redisClient,
   defaultJobOptions: {
     attempts: 5,
-    backoff: { type: 'exponential', delay: 2000 },
+    backoff: { type: "exponential", delay: 2000 },
     removeOnComplete: 500,
     removeOnFail: 500,
   },
@@ -21,11 +21,19 @@ const imagePublishQueue = new Queue('imagePublishQueue', {
 
 // ── ID helpers ─────────────────────────────────────────────────────────────────
 
+/** Replace invalid chars for BullMQ IDs */
+function sanitizeId(str) {
+  return str.replace(/[:.]/g, "-");
+}
+
+/** Stable id (latest schedule) */
 function stableJobId(image_id) {
-  return `image:publish:${image_id}`;
+  return sanitizeId(`image:publish:${image_id}`);
 }
+
+/** Versioned id (keeps history distinct) */
 function versionedJobId(image_id, runAtIso) {
-  return `image:publish:${image_id}:${runAtIso}`;
+  return sanitizeId(`image:publish:${image_id}:${runAtIso}`);
 }
 
 // ── Time helpers ───────────────────────────────────────────────────────────────
@@ -33,19 +41,21 @@ function versionedJobId(image_id, runAtIso) {
 /** Parse anything into a UTC Date. Strings without timezone are treated as UTC. */
 function normalizeToUtcDate(input) {
   if (input instanceof Date) return new Date(input.getTime());
-  if (typeof input === 'number') return new Date(input); // epoch ms
+  if (typeof input === "number") return new Date(input); // epoch ms
 
-  if (typeof input === 'string') {
+  if (typeof input === "string") {
     // Has timezone (Z or ±hh:mm)
     if (/[zZ]|[+\-]\d{2}:\d{2}$/.test(input)) {
       const d = new Date(input);
-      if (Number.isNaN(d.getTime())) throw new Error(`Invalid ISO datetime: ${input}`);
+      if (Number.isNaN(d.getTime()))
+        throw new Error(`Invalid ISO datetime: ${input}`);
       return d;
     }
     // No timezone => treat as UTC
-    const s = input.trim().replace(' ', 'T');
+    const s = input.trim().replace(" ", "T");
     const d = new Date(`${s}Z`);
-    if (Number.isNaN(d.getTime())) throw new Error(`Invalid datetime (no tz): ${input}`);
+    if (Number.isNaN(d.getTime()))
+      throw new Error(`Invalid datetime (no tz): ${input}`);
     return d;
   }
 
@@ -55,10 +65,10 @@ function normalizeToUtcDate(input) {
 // ── Purge helpers ─────────────────────────────────────────────────────────────
 
 async function findPendingImageJobs(image_id) {
-  const states = ['delayed', 'waiting', 'waiting-children', 'active'];
+  const states = ["delayed", "waiting", "waiting-children", "active"];
   const jobs = await imagePublishQueue.getJobs(states);
   return jobs.filter(
-    (j) => j?.name === 'image:publish' && j?.data?.image_id === String(image_id)
+    (j) => j?.name === "image:publish" && j?.data?.image_id === String(image_id)
   );
 }
 
@@ -72,7 +82,10 @@ async function purgeExistingForImage(image_id) {
       await j.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[imagePublishQueue] failed to remove pending job ${j.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[imagePublishQueue] failed to remove pending job ${j.id}: ${e.message}`
+        );
     }
   }
 
@@ -83,12 +96,15 @@ async function purgeExistingForImage(image_id) {
       await last.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[imagePublishQueue] failed to remove stable job ${last.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[imagePublishQueue] failed to remove stable job ${last.id}: ${e.message}`
+        );
     }
   }
 
   if (DEBUG) {
-    console.info('[imagePublishQueue] purgeExistingForImage', {
+    console.info("[imagePublishQueue] purgeExistingForImage", {
       image_id: String(image_id),
       removed,
     });
@@ -109,9 +125,14 @@ async function purgeExistingForImage(image_id) {
  * @param {object} [params.extra]
  * @param {boolean} [params.useStableId=false] - if true, uses stable jobId
  */
-async function addImagePublishJob({ image_id, runAtUtc, extra = {}, useStableId = false }) {
+async function addImagePublishJob({
+  image_id,
+  runAtUtc,
+  extra = {},
+  useStableId = false,
+}) {
   if (!image_id || !runAtUtc) {
-    throw new Error('addImagePublishJob: image_id and runAtUtc are required');
+    throw new Error("addImagePublishJob: image_id and runAtUtc are required");
   }
 
   const runAt = normalizeToUtcDate(runAtUtc);
@@ -126,16 +147,18 @@ async function addImagePublishJob({ image_id, runAtUtc, extra = {}, useStableId
   await purgeExistingForImage(image_id);
 
   // Choose jobId strategy
-  const jobId = useStableId ? stableJobId(image_id) : versionedJobId(image_id, runAtIso);
+  const jobId = useStableId
+    ? stableJobId(image_id)
+    : versionedJobId(image_id, runAtIso);
 
   const job = await imagePublishQueue.add(
-    'image:publish',
+    "image:publish",
     { image_id: String(image_id), runAtUtc: runAtIso, extra },
     { jobId, delay: delayMs }
   );
 
   if (DEBUG) {
-    console.info('[imagePublishQueue] upsert', {
+    console.info("[imagePublishQueue] upsert", {
       image_id: String(image_id),
       jobId,
       runAtIso,
@@ -161,4 +184,4 @@ module.exports = {
   stableJobId,
   versionedJobId,
   normalizeToUtcDate,
-};
+};

package/src/queue/newsPublishQueue.js

@@ -2,18 +2,18 @@
 // One-off *publish* scheduler for news items (BullMQ).
 // Strong upsert: purge any prior job for the same news before adding a new delayed job.
 
-const { Queue } = require('bullmq');
-const redisClient = require('../redis/redisClient');
+const { Queue } = require("bullmq");
+const redisClient = require("../redis/redisClient");
 // const logger = require('../logger'); // optional
 
-const DEBUG    = String(process.env.DEBUG_LOGGER || '').trim() === '1';
+const DEBUG = String(process.env.DEBUG_LOGGER || "").trim() === "1";
 const DRIFT_MS = Math.max(0, Number(process.env.SCHEDULE_DRIFT_MS || 250));
 
-const newsPublishQueue = new Queue('newsPublishQueue', {
+const newsPublishQueue = new Queue("newsPublishQueue", {
   connection: redisClient,
   defaultJobOptions: {
     attempts: 5,
-    backoff: { type: 'exponential', delay: 2000 },
+    backoff: { type: "exponential", delay: 2000 },
     removeOnComplete: 500,
     removeOnFail: 500,
   },
@@ -21,11 +21,19 @@ const newsPublishQueue = new Queue('newsPublishQueue', {
 
 // ── ID helpers ────────────────────────────────────────────────────────────────
 
+/** Replace invalid chars for BullMQ IDs */
+function sanitizeId(str) {
+  return str.replace(/[:.]/g, "-");
+}
+
+/** Stable id (latest schedule) */
 function stableJobId(news_id) {
-  return `news:publish:${news_id}`;
+  return sanitizeId(`news:publish:${news_id}`);
 }
+
+/** Versioned id (keeps history distinct) */
 function versionedJobId(news_id, runAtIso) {
-  return `news:publish:${news_id}:${runAtIso}`;
+  return sanitizeId(`news:publish:${news_id}:${runAtIso}`);
 }
 
 // ── Time helpers ──────────────────────────────────────────────────────────────
@@ -33,19 +41,21 @@ function versionedJobId(news_id, runAtIso) {
 /** Parse anything into a UTC Date. Strings without timezone are treated as UTC. */
 function normalizeToUtcDate(input) {
   if (input instanceof Date) return new Date(input.getTime());
-  if (typeof input === 'number') return new Date(input); // epoch ms
+  if (typeof input === "number") return new Date(input); // epoch ms
 
-  if (typeof input === 'string') {
+  if (typeof input === "string") {
     // Has timezone (Z or ±hh:mm)
     if (/[zZ]|[+\-]\d{2}:\d{2}$/.test(input)) {
       const d = new Date(input);
-      if (Number.isNaN(d.getTime())) throw new Error(`Invalid ISO datetime: ${input}`);
+      if (Number.isNaN(d.getTime()))
+        throw new Error(`Invalid ISO datetime: ${input}`);
       return d;
     }
     // No timezone => treat as UTC
-    const s = input.trim().replace(' ', 'T');
+    const s = input.trim().replace(" ", "T");
     const d = new Date(`${s}Z`);
-    if (Number.isNaN(d.getTime())) throw new Error(`Invalid datetime (no tz): ${input}`);
+    if (Number.isNaN(d.getTime()))
+      throw new Error(`Invalid datetime (no tz): ${input}`);
     return d;
   }
 
@@ -55,10 +65,10 @@ function normalizeToUtcDate(input) {
 // ── Purge helpers ────────────────────────────────────────────────────────────
 
 async function findPendingNewsJobs(news_id) {
-  const states = ['delayed', 'waiting', 'waiting-children', 'active'];
+  const states = ["delayed", "waiting", "waiting-children", "active"];
   const jobs = await newsPublishQueue.getJobs(states);
   return jobs.filter(
-    (j) => j?.name === 'news:publish' && j?.data?.news_id === String(news_id)
+    (j) => j?.name === "news:publish" && j?.data?.news_id === String(news_id)
   );
 }
 
@@ -72,7 +82,10 @@ async function purgeExistingForNews(news_id) {
       await j.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[newsPublishQueue] failed to remove pending job ${j.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[newsPublishQueue] failed to remove pending job ${j.id}: ${e.message}`
+        );
     }
   }
 
@@ -83,12 +96,15 @@ async function purgeExistingForNews(news_id) {
       await last.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[newsPublishQueue] failed to remove stable job ${last.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[newsPublishQueue] failed to remove stable job ${last.id}: ${e.message}`
+        );
     }
   }
 
   if (DEBUG) {
-    console.info('[newsPublishQueue] purgeExistingForNews', {
+    console.info("[newsPublishQueue] purgeExistingForNews", {
       news_id: String(news_id),
       removed,
     });
@@ -109,9 +125,14 @@ async function purgeExistingForNews(news_id) {
  * @param {object} [params.extra]
  * @param {boolean} [params.useStableId=false] - if true, uses stable jobId
  */
-async function addNewsPublishJob({ news_id, runAtUtc, extra = {}, useStableId = false }) {
+async function addNewsPublishJob({
+  news_id,
+  runAtUtc,
+  extra = {},
+  useStableId = false,
+}) {
   if (!news_id || !runAtUtc) {
-    throw new Error('addNewsPublishJob: news_id and runAtUtc are required');
+    throw new Error("addNewsPublishJob: news_id and runAtUtc are required");
   }
 
   const runAt = normalizeToUtcDate(runAtUtc);
@@ -126,16 +147,18 @@ async function addNewsPublishJob({ news_id, runAtUtc, extra = {}, useStableId =
   await purgeExistingForNews(news_id);
 
   // Choose jobId strategy
-  const jobId = useStableId ? stableJobId(news_id) : versionedJobId(news_id, runAtIso);
+  const jobId = useStableId
+    ? stableJobId(news_id)
+    : versionedJobId(news_id, runAtIso);
 
   const job = await newsPublishQueue.add(
-    'news:publish',
+    "news:publish",
     { news_id: String(news_id), runAtUtc: runAtIso, extra },
     { jobId, delay: delayMs }
   );
 
   if (DEBUG) {
-    console.info('[newsPublishQueue] upsert', {
+    console.info("[newsPublishQueue] upsert", {
       news_id: String(news_id),
       jobId,
       runAtIso,
@@ -161,4 +184,4 @@ module.exports = {
   stableJobId,
   versionedJobId,
   normalizeToUtcDate,
-};
+};