@yellowpanther/shared 1.2.6 → 1.2.7

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

package/src/queue/productPublishQueue.js

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

package/src/queue/quizPublishQueue.js

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