@yellowpanther/shared 1.2.6 → 1.2.9

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,
-};
+};

package/src/queue/pagePublishQueue.js

@@ -2,18 +2,18 @@
 // One-off *publish* scheduler for page items (BullMQ).
 // Strong upsert: purge any prior job for the same page 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 pagePublishQueue = new Queue('pagePublishQueue', {
+const pagePublishQueue = new Queue("pagePublishQueue", {
   connection: redisClient,
   defaultJobOptions: {
     attempts: 5,
-    backoff: { type: 'exponential', delay: 2000 },
+    backoff: { type: "exponential", delay: 2000 },
     removeOnComplete: 500,
     removeOnFail: 500,
   },
@@ -21,11 +21,19 @@ const pagePublishQueue = new Queue('pagePublishQueue', {
 
 // ── ID helpers ─────────────────────────────────────────────────────────────────
 
+/** Replace invalid chars for BullMQ IDs */
+function sanitizeId(str) {
+  return str.replace(/[:.]/g, "-");
+}
+
+/** Stable id (latest schedule) */
 function stableJobId(page_id) {
-  return `page:publish:${page_id}`;
+  return sanitizeId(`page:publish:${page_id}`);
 }
+
+/** Versioned id (keeps history distinct) */
 function versionedJobId(page_id, runAtIso) {
-  return `page:publish:${page_id}:${runAtIso}`;
+  return sanitizeId(`page:publish:${page_id}:${runAtIso}`);
 }
 
 // ── Time helpers ───────────────────────────────────────────────────────────────
@@ -33,19 +41,21 @@ function versionedJobId(page_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 findPendingPageJobs(page_id) {
-  const states = ['delayed', 'waiting', 'waiting-children', 'active'];
+  const states = ["delayed", "waiting", "waiting-children", "active"];
   const jobs = await pagePublishQueue.getJobs(states);
   return jobs.filter(
-    (j) => j?.name === 'page:publish' && j?.data?.page_id === String(page_id)
+    (j) => j?.name === "page:publish" && j?.data?.page_id === String(page_id)
   );
 }
 
@@ -72,7 +82,10 @@ async function purgeExistingForPage(page_id) {
       await j.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[pagePublishQueue] failed to remove pending job ${j.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[pagePublishQueue] failed to remove pending job ${j.id}: ${e.message}`
+        );
     }
   }
 
@@ -83,12 +96,15 @@ async function purgeExistingForPage(page_id) {
       await last.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[pagePublishQueue] failed to remove stable job ${last.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[pagePublishQueue] failed to remove stable job ${last.id}: ${e.message}`
+        );
     }
   }
 
   if (DEBUG) {
-    console.info('[pagePublishQueue] purgeExistingForPage', {
+    console.info("[pagePublishQueue] purgeExistingForPage", {
       page_id: String(page_id),
       removed,
     });
@@ -109,9 +125,14 @@ async function purgeExistingForPage(page_id) {
  * @param {object} [params.extra]
  * @param {boolean} [params.useStableId=false] - if true, uses stable jobId
  */
-async function addPagePublishJob({ page_id, runAtUtc, extra = {}, useStableId = false }) {
+async function addPagePublishJob({
+  page_id,
+  runAtUtc,
+  extra = {},
+  useStableId = false,
+}) {
   if (!page_id || !runAtUtc) {
-    throw new Error('addPagePublishJob: page_id and runAtUtc are required');
+    throw new Error("addPagePublishJob: page_id and runAtUtc are required");
   }
 
   const runAt = normalizeToUtcDate(runAtUtc);
@@ -126,16 +147,18 @@ async function addPagePublishJob({ page_id, runAtUtc, extra = {}, useStableId =
   await purgeExistingForPage(page_id);
 
   // Choose jobId strategy
-  const jobId = useStableId ? stableJobId(page_id) : versionedJobId(page_id, runAtIso);
+  const jobId = useStableId
+    ? stableJobId(page_id)
+    : versionedJobId(page_id, runAtIso);
 
   const job = await pagePublishQueue.add(
-    'page:publish',
+    "page:publish",
     { page_id: String(page_id), runAtUtc: runAtIso, extra },
     { jobId, delay: delayMs }
   );
 
   if (DEBUG) {
-    console.info('[pagePublishQueue] upsert', {
+    console.info("[pagePublishQueue] upsert", {
       page_id: String(page_id),
       jobId,
       runAtIso,
@@ -161,4 +184,4 @@ module.exports = {
   stableJobId,
   versionedJobId,
   normalizeToUtcDate,
-};
+};

package/src/queue/predictionPublishQueue.js

@@ -2,18 +2,18 @@
 // One-off *publish* scheduler for prediction items (BullMQ).
 // Strong upsert: purge any prior job for the same prediction 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 predictionPublishQueue = new Queue('predictionPublishQueue', {
+const predictionPublishQueue = new Queue("predictionPublishQueue", {
   connection: redisClient,
   defaultJobOptions: {
     attempts: 5,
-    backoff: { type: 'exponential', delay: 2000 },
+    backoff: { type: "exponential", delay: 2000 },
     removeOnComplete: 500,
     removeOnFail: 500,
   },
@@ -21,11 +21,19 @@ const predictionPublishQueue = new Queue('predictionPublishQueue', {
 
 // ── ID helpers ─────────────────────────────────────────────────────────────────
 
+/** Replace invalid chars for BullMQ IDs */
+function sanitizeId(str) {
+  return str.replace(/[:.]/g, "-");
+}
+
+/** Stable id (latest schedule) */
 function stableJobId(prediction_id) {
-  return `prediction:publish:${prediction_id}`;
+  return sanitizeId(`prediction:publish:${prediction_id}`);
 }
+
+/** Versioned id (keeps history distinct) */
 function versionedJobId(prediction_id, runAtIso) {
-  return `prediction:publish:${prediction_id}:${runAtIso}`;
+  return sanitizeId(`prediction:publish:${prediction_id}:${runAtIso}`);
 }
 
 // ── Time helpers ───────────────────────────────────────────────────────────────
@@ -33,19 +41,21 @@ function versionedJobId(prediction_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 findPendingPredictionJobs(prediction_id) {
-  const states = ['delayed', 'waiting', 'waiting-children', 'active'];
+  const states = ["delayed", "waiting", "waiting-children", "active"];
   const jobs = await predictionPublishQueue.getJobs(states);
   return jobs.filter(
-    (j) => j?.name === 'prediction:publish' && j?.data?.prediction_id === String(prediction_id)
+    (j) =>
+      j?.name === "prediction:publish" &&
+      j?.data?.prediction_id === String(prediction_id)
   );
 }
 
@@ -72,7 +84,10 @@ async function purgeExistingForPrediction(prediction_id) {
       await j.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[predictionPublishQueue] failed to remove pending job ${j.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[predictionPublishQueue] failed to remove pending job ${j.id}: ${e.message}`
+        );
     }
   }
 
@@ -83,12 +98,15 @@ async function purgeExistingForPrediction(prediction_id) {
       await last.remove();
       removed++;
     } catch (e) {
-      if (DEBUG) console.warn(`[predictionPublishQueue] failed to remove stable job ${last.id}: ${e.message}`);
+      if (DEBUG)
+        console.warn(
+          `[predictionPublishQueue] failed to remove stable job ${last.id}: ${e.message}`
+        );
     }
   }
 
   if (DEBUG) {
-    console.info('[predictionPublishQueue] purgeExistingForPrediction', {
+    console.info("[predictionPublishQueue] purgeExistingForPrediction", {
       prediction_id: String(prediction_id),
       removed,
     });
@@ -109,9 +127,16 @@ async function purgeExistingForPrediction(prediction_id) {
  * @param {object} [params.extra]
  * @param {boolean} [params.useStableId=false] - if true, uses stable jobId
  */
-async function addPredictionPublishJob({ prediction_id, runAtUtc, extra = {}, useStableId = false }) {
+async function addPredictionPublishJob({
+  prediction_id,
+  runAtUtc,
+  extra = {},
+  useStableId = false,
+}) {
   if (!prediction_id || !runAtUtc) {
-    throw new Error('addPredictionPublishJob: prediction_id and runAtUtc are required');
+    throw new Error(
+      "addPredictionPublishJob: prediction_id and runAtUtc are required"
+    );
   }
 
   const runAt = normalizeToUtcDate(runAtUtc);
@@ -126,16 +151,18 @@ async function addPredictionPublishJob({ prediction_id, runAtUtc, extra = {}, us
   await purgeExistingForPrediction(prediction_id);
 
   // Choose jobId strategy
-  const jobId = useStableId ? stableJobId(prediction_id) : versionedJobId(prediction_id, runAtIso);
+  const jobId = useStableId
+    ? stableJobId(prediction_id)
+    : versionedJobId(prediction_id, runAtIso);
 
   const job = await predictionPublishQueue.add(
-    'prediction:publish',
+    "prediction:publish",
     { prediction_id: String(prediction_id), runAtUtc: runAtIso, extra },
     { jobId, delay: delayMs }
   );
 
   if (DEBUG) {
-    console.info('[predictionPublishQueue] upsert', {
+    console.info("[predictionPublishQueue] upsert", {
       prediction_id: String(prediction_id),
       jobId,
       runAtIso,
@@ -161,4 +188,4 @@ module.exports = {
   stableJobId,
   versionedJobId,
   normalizeToUtcDate,
-};
+};