@studious-lms/server 1.12.0 → 1.14.0

package/dist/workers/connection.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="afa7018f-10b5-59d0-b3b7-2c3033bd6329")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="08dc2ad3-ba37-554f-adf7-8f94aa613618")}catch(e){}}();
 import IORedis from 'ioredis';
 import { env } from '../lib/config/env.js';
 import { logger } from '../utils/logger.js';
@@ -29,5 +29,23 @@ function buildBullConnection() {
     return connection;
 }
 export const bullConnection = buildBullConnection();
+/**
+ * Key prefix applied to every BullMQ Queue and Worker.
+ *
+ * Without this, BullMQ defaults to the `bull` namespace, so ANY process
+ * pointed at the same Redis instance shares the same queues. That is a
+ * problem when a single Redis (e.g. a shared Upstash instance) is used across
+ * environments while each environment has its own database: a worker can pick
+ * up a job enqueued elsewhere, fail to find its `RunJob` row, and crash-loop
+ * with "No record was found for an update".
+ *
+ * Namespacing by environment keeps each environment's jobs isolated. Override
+ * with `BULL_PREFIX` when you need finer-grained separation (e.g. per
+ * developer sharing one Redis).
+ */
+export function getBullPrefix() {
+    const explicit = env.BULL_PREFIX?.trim();
+    return explicit && explicit.length > 0 ? explicit : `bull:${env.NODE_ENV}`;
+}
 //# sourceMappingURL=connection.js.map
-//# debugId=afa7018f-10b5-59d0-b3b7-2c3033bd6329
+//# debugId=08dc2ad3-ba37-554f-adf7-8f94aa613618

package/dist/workers/connection.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.js","sources":["workers/connection.ts"],"sourceRoot":"/","sourcesContent":["import IORedis from 'ioredis';\nimport { env } from '../lib/config/env.js';\nimport { logger } from '../utils/logger.js';\n\n/**\n * BullMQ-specific Redis connection.\n *\n * Kept separate from `src/lib/redis.ts` (which is used for caching and\n * rate-limiting) because BullMQ requires `maxRetriesPerRequest: null` and\n * `enableReadyCheck: false` on its connection. Mixing those settings with\n * general Redis usage causes unwanted behaviour on transient errors.\n */\nfunction buildBullConnection(): IORedis {\n  if (!env.REDIS_URL) {\n    throw new Error(\n      'REDIS_URL is required for BullMQ. Set it in .env / .env.production / your hosting env.',\n    );\n  }\n\n  const connection = new IORedis(env.REDIS_URL, {\n    maxRetriesPerRequest: null,\n    enableReadyCheck: false,\n    lazyConnect: false,\n  });\n\n  connection.on('error', (err) => {\n    logger.error('BullMQ Redis connection error', { error: err.message });\n  });\n\n  connection.on('connect', () => {\n    logger.info('BullMQ Redis connected');\n  });\n\n  return connection;\n}\n\nexport const bullConnection = buildBullConnection();\n"],"names":[],"mappings":";;AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;GAOG;AACH,SAAS,mBAAmB;IAC1B,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE;QAC5C,oBAAoB,EAAE,IAAI;QAC1B,gBAAgB,EAAE,KAAK;QACvB,WAAW,EAAE,KAAK;KACnB,CAAC,CAAC;IAEH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC7B,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,EAAE,CAAC","debug_id":"afa7018f-10b5-59d0-b3b7-2c3033bd6329"}
+{"version":3,"file":"connection.js","sources":["workers/connection.ts"],"sourceRoot":"/","sourcesContent":["import IORedis from 'ioredis';\nimport { env } from '../lib/config/env.js';\nimport { logger } from '../utils/logger.js';\n\n/**\n * BullMQ-specific Redis connection.\n *\n * Kept separate from `src/lib/redis.ts` (which is used for caching and\n * rate-limiting) because BullMQ requires `maxRetriesPerRequest: null` and\n * `enableReadyCheck: false` on its connection. Mixing those settings with\n * general Redis usage causes unwanted behaviour on transient errors.\n */\nfunction buildBullConnection(): IORedis {\n  if (!env.REDIS_URL) {\n    throw new Error(\n      'REDIS_URL is required for BullMQ. Set it in .env / .env.production / your hosting env.',\n    );\n  }\n\n  const connection = new IORedis(env.REDIS_URL, {\n    maxRetriesPerRequest: null,\n    enableReadyCheck: false,\n    lazyConnect: false,\n  });\n\n  connection.on('error', (err) => {\n    logger.error('BullMQ Redis connection error', { error: err.message });\n  });\n\n  connection.on('connect', () => {\n    logger.info('BullMQ Redis connected');\n  });\n\n  return connection;\n}\n\nexport const bullConnection = buildBullConnection();\n\n/**\n * Key prefix applied to every BullMQ Queue and Worker.\n *\n * Without this, BullMQ defaults to the `bull` namespace, so ANY process\n * pointed at the same Redis instance shares the same queues. That is a\n * problem when a single Redis (e.g. a shared Upstash instance) is used across\n * environments while each environment has its own database: a worker can pick\n * up a job enqueued elsewhere, fail to find its `RunJob` row, and crash-loop\n * with \"No record was found for an update\".\n *\n * Namespacing by environment keeps each environment's jobs isolated. Override\n * with `BULL_PREFIX` when you need finer-grained separation (e.g. per\n * developer sharing one Redis).\n */\nexport function getBullPrefix(): string {\n  const explicit = env.BULL_PREFIX?.trim();\n  return explicit && explicit.length > 0 ? explicit : `bull:${env.NODE_ENV}`;\n}\n"],"names":[],"mappings":";;AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;;;;;GAOG;AACH,SAAS,mBAAmB;IAC1B,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACnB,MAAM,IAAI,KAAK,CACb,wFAAwF,CACzF,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE;QAC5C,oBAAoB,EAAE,IAAI;QAC1B,gBAAgB,EAAE,KAAK;QACvB,WAAW,EAAE,KAAK;KACnB,CAAC,CAAC;IAEH,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC7B,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC;IAEH,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;QAC5B,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,EAAE,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACzC,OAAO,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,QAAQ,EAAE,CAAC;AAC7E,CAAC","debug_id":"08dc2ad3-ba37-554f-adf7-8f94aa613618"}

package/dist/workers/index.js

@@ -7,7 +7,7 @@
  * HTTP server — that would spin up workers in your serverless functions.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="07a4db46-6b47-5518-8343-2659c25cad54")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8f679c75-a951-503c-a902-a7f55e8401ab")}catch(e){}}();
 import '../instrument.js';
 import { prisma } from '../lib/prisma.js';
 import { logger } from '../utils/logger.js';
@@ -17,12 +17,14 @@ import { aiNewtonChatWorker } from './processors/aiNewtonChat.js';
 import { gradeWorksheetWorker } from './processors/gradeWorksheet.js';
 import { pdfToWorksheetWorker } from './processors/pdfToWorksheet.js';
 import { studentProgressChatWorker } from './processors/studentProgressChat.js';
+import { embedContentWorker } from './processors/embedContent.js';
 const workers = [
     pdfToWorksheetWorker,
     gradeWorksheetWorker,
     aiLabChatWorker,
     aiNewtonChatWorker,
     studentProgressChatWorker,
+    embedContentWorker,
 ];
 logger.info('Workers ready', {
     pid: process.pid,
@@ -60,4 +62,4 @@ process.on('unhandledRejection', (reason) => {
     process.exit(1);
 });
 //# sourceMappingURL=index.js.map
-//# debugId=07a4db46-6b47-5518-8343-2659c25cad54
+//# debugId=8f679c75-a951-503c-a902-a7f55e8401ab

package/dist/workers/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["workers/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Worker process entrypoint.\n *\n * Run separately from the HTTP server (e.g. `node dist/workers/index.js` on\n * Render/Railway/Fly). Importing this file boots every BullMQ Worker\n * declared under `src/workers/processors/*`. Do NOT import this from the\n * HTTP server — that would spin up workers in your serverless functions.\n */\nimport '../instrument.js';\n\nimport { Worker } from 'bullmq';\nimport { prisma } from '../lib/prisma.js';\nimport { logger } from '../utils/logger.js';\nimport { bullConnection } from './connection.js';\nimport { aiLabChatWorker } from './processors/aiLabChat.js';\nimport { aiNewtonChatWorker } from './processors/aiNewtonChat.js';\nimport { gradeWorksheetWorker } from './processors/gradeWorksheet.js';\nimport { pdfToWorksheetWorker } from './processors/pdfToWorksheet.js';\nimport { studentProgressChatWorker } from './processors/studentProgressChat.js';\n\nconst workers: Worker<any>[] = [\n  pdfToWorksheetWorker,\n  gradeWorksheetWorker,\n  aiLabChatWorker,\n  aiNewtonChatWorker,\n  studentProgressChatWorker,\n];\n\nlogger.info('Workers ready', {\n  pid: process.pid,\n  queues: workers.map((w) => w.name),\n});\n\nlet shuttingDown = false;\n\nasync function shutdown(signal: string): Promise<void> {\n  if (shuttingDown) return;\n  shuttingDown = true;\n\n  logger.info(`Received ${signal}, draining workers...`);\n\n  // `worker.close()` waits for in-flight jobs to finish (up to the worker's\n  // settings) before resolving. Run them in parallel.\n  await Promise.allSettled(workers.map((w) => w.close()));\n\n  await Promise.allSettled([\n    bullConnection.quit(),\n    prisma.$disconnect(),\n  ]);\n\n  logger.info('Workers shut down cleanly');\n  process.exit(0);\n}\n\nprocess.on('SIGTERM', () => void shutdown('SIGTERM'));\nprocess.on('SIGINT', () => void shutdown('SIGINT'));\n\nprocess.on('uncaughtException', (error) => {\n  logger.error('Uncaught exception in worker process', {\n    error: error.message,\n    stack: error.stack,\n  });\n  process.exit(1);\n});\n\nprocess.on('unhandledRejection', (reason) => {\n  logger.error('Unhandled rejection in worker process', {\n    reason: reason instanceof Error ? reason.message : String(reason),\n  });\n  process.exit(1);\n});\n"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;;AACH,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,MAAM,OAAO,GAAkB;IAC7B,oBAAoB;IACpB,oBAAoB;IACpB,eAAe;IACf,kBAAkB;IAClB,yBAAyB;CAC1B,CAAC;AAEF,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;IAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,KAAK,UAAU,QAAQ,CAAC,MAAc;IACpC,IAAI,YAAY;QAAE,OAAO;IACzB,YAAY,GAAG,IAAI,CAAC;IAEpB,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,uBAAuB,CAAC,CAAC;IAEvD,0EAA0E;IAC1E,oDAAoD;IACpD,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAExD,MAAM,OAAO,CAAC,UAAU,CAAC;QACvB,cAAc,CAAC,IAAI,EAAE;QACrB,MAAM,CAAC,WAAW,EAAE;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACtD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEpD,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;QACnD,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE;QACpD,MAAM,EAAE,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;KAClE,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","debug_id":"07a4db46-6b47-5518-8343-2659c25cad54"}
+{"version":3,"file":"index.js","sources":["workers/index.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Worker process entrypoint.\n *\n * Run separately from the HTTP server (e.g. `node dist/workers/index.js` on\n * Render/Railway/Fly). Importing this file boots every BullMQ Worker\n * declared under `src/workers/processors/*`. Do NOT import this from the\n * HTTP server — that would spin up workers in your serverless functions.\n */\nimport '../instrument.js';\n\nimport { Worker } from 'bullmq';\nimport { prisma } from '../lib/prisma.js';\nimport { logger } from '../utils/logger.js';\nimport { bullConnection } from './connection.js';\nimport { aiLabChatWorker } from './processors/aiLabChat.js';\nimport { aiNewtonChatWorker } from './processors/aiNewtonChat.js';\nimport { gradeWorksheetWorker } from './processors/gradeWorksheet.js';\nimport { pdfToWorksheetWorker } from './processors/pdfToWorksheet.js';\nimport { studentProgressChatWorker } from './processors/studentProgressChat.js';\nimport { embedContentWorker } from './processors/embedContent.js';\n\nconst workers: Worker<any>[] = [\n  pdfToWorksheetWorker,\n  gradeWorksheetWorker,\n  aiLabChatWorker,\n  aiNewtonChatWorker,\n  studentProgressChatWorker,\n  embedContentWorker,\n];\n\nlogger.info('Workers ready', {\n  pid: process.pid,\n  queues: workers.map((w) => w.name),\n});\n\nlet shuttingDown = false;\n\nasync function shutdown(signal: string): Promise<void> {\n  if (shuttingDown) return;\n  shuttingDown = true;\n\n  logger.info(`Received ${signal}, draining workers...`);\n\n  // `worker.close()` waits for in-flight jobs to finish (up to the worker's\n  // settings) before resolving. Run them in parallel.\n  await Promise.allSettled(workers.map((w) => w.close()));\n\n  await Promise.allSettled([\n    bullConnection.quit(),\n    prisma.$disconnect(),\n  ]);\n\n  logger.info('Workers shut down cleanly');\n  process.exit(0);\n}\n\nprocess.on('SIGTERM', () => void shutdown('SIGTERM'));\nprocess.on('SIGINT', () => void shutdown('SIGINT'));\n\nprocess.on('uncaughtException', (error) => {\n  logger.error('Uncaught exception in worker process', {\n    error: error.message,\n    stack: error.stack,\n  });\n  process.exit(1);\n});\n\nprocess.on('unhandledRejection', (reason) => {\n  logger.error('Unhandled rejection in worker process', {\n    reason: reason instanceof Error ? reason.message : String(reason),\n  });\n  process.exit(1);\n});\n"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;;AACH,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AACtE,OAAO,EAAE,yBAAyB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAElE,MAAM,OAAO,GAAkB;IAC7B,oBAAoB;IACpB,oBAAoB;IACpB,eAAe;IACf,kBAAkB;IAClB,yBAAyB;IACzB,kBAAkB;CACnB,CAAC;AAEF,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;IAC3B,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;CACnC,CAAC,CAAC;AAEH,IAAI,YAAY,GAAG,KAAK,CAAC;AAEzB,KAAK,UAAU,QAAQ,CAAC,MAAc;IACpC,IAAI,YAAY;QAAE,OAAO;IACzB,YAAY,GAAG,IAAI,CAAC;IAEpB,MAAM,CAAC,IAAI,CAAC,YAAY,MAAM,uBAAuB,CAAC,CAAC;IAEvD,0EAA0E;IAC1E,oDAAoD;IACpD,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAExD,MAAM,OAAO,CAAC,UAAU,CAAC;QACvB,cAAc,CAAC,IAAI,EAAE;QACrB,MAAM,CAAC,WAAW,EAAE;KACrB,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACtD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEpD,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,EAAE;IACxC,MAAM,CAAC,KAAK,CAAC,sCAAsC,EAAE;QACnD,KAAK,EAAE,KAAK,CAAC,OAAO;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE;IAC1C,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE;QACpD,MAAM,EAAE,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;KAClE,CAAC,CAAC;IACH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC","debug_id":"8f679c75-a951-503c-a902-a7f55e8401ab"}

package/dist/workers/processors/createRunJobWorker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createRunJobWorker.d.ts","sourceRoot":"/","sources":["workers/processors/createRunJobWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAY,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIzD,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,UAAU;IAC7D,IAAI,EAAE,CAAC,CAAC;IACR,kFAAkF;IAClF,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAClD;;;OAGG;IACH,GAAG,EAAE,CACH,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED,KAAK,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,UAAU,EAAE,EACvD,IAAI,EACJ,aAAa,EACb,GAAG,GACJ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CA4GtD"}
+{"version":3,"file":"createRunJobWorker.d.ts","sourceRoot":"/","sources":["workers/processors/createRunJobWorker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,MAAM,EAAY,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,EAAE,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAIzD,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB,CAAC,CAAC,SAAS,UAAU;IAC7D,IAAI,EAAE,CAAC,CAAC;IACR,kFAAkF;IAClF,aAAa,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAClD;;;OAGG;IACH,GAAG,EAAE,CACH,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,GAAG,EAAE,aAAa,KACf,OAAO,CAAC,MAAM,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;CAC5C;AAED,KAAK,UAAU,CAAC,CAAC,SAAS,UAAU,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5E,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,UAAU,EAAE,EACvD,IAAI,EACJ,aAAa,EACb,GAAG,GACJ,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAsItD"}

package/dist/workers/processors/createRunJobWorker.js

@@ -16,10 +16,10 @@
  * `userId` / `classId` from the original `enqueueRunJob` call.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="55ff9081-193c-5053-9606-34eeebf74f10")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="411f71f1-9246-5cac-bbd7-d82a51d25576")}catch(e){}}();
 import { Worker } from 'bullmq';
 import { Prisma } from '@prisma/client';
-import { bullConnection } from '../connection.js';
+import { bullConnection, getBullPrefix } from '../connection.js';
 import { prisma } from '../../lib/prisma.js';
 import { logger } from '../../utils/logger.js';
 import { QUEUE_NAMES } from '../queues.js';
@@ -34,7 +34,20 @@ export function createRunJobWorker({ type, workerOptions, run, }) {
             where: { id: runJobId },
             select: { status: true, result: true, userId: true, classId: true },
         });
-        if (existing?.status === 'SUCCEEDED') {
+        if (!existing) {
+            // Orphaned job: the RunJob row this job points at does not exist in
+            // THIS database. Typically caused by a Redis instance shared across
+            // environments/databases (the `prefix` namespacing in this file's
+            // Worker options is the primary guard against that), or by a DB reset
+            // that left jobs behind in Redis. Discard instead of throwing on the
+            // `update` below and burning all retry attempts.
+            logger.warn(`${name} RunJob not found; discarding orphaned job`, {
+                runJobId,
+                bullJobId: job.id,
+            });
+            return null;
+        }
+        if (existing.status === 'SUCCEEDED') {
             logger.info(`${name} RunJob already succeeded; skipping re-run`, {
                 runJobId,
                 bullJobId: job.id,
@@ -45,7 +58,7 @@ export function createRunJobWorker({ type, workerOptions, run, }) {
             where: { id: runJobId },
             data: {
                 status: 'RUNNING',
-                startedAt: existing?.status === 'RUNNING' ? undefined : new Date(),
+                startedAt: existing.status === 'RUNNING' ? undefined : new Date(),
                 attempts: { increment: 1 },
             },
         });
@@ -53,8 +66,8 @@ export function createRunJobWorker({ type, workerOptions, run, }) {
             runJobId,
             bullJobId: job.id,
             attempt: job.attemptsMade + 1,
-            userId: existing?.userId ?? null,
-            classId: existing?.classId ?? null,
+            userId: existing.userId ?? null,
+            classId: existing.classId ?? null,
         });
         await prisma.runJob.update({
             where: { id: runJobId },
@@ -66,7 +79,7 @@ export function createRunJobWorker({ type, workerOptions, run, }) {
             },
         });
         return result;
-    }, { connection: bullConnection, ...workerOptions });
+    }, { connection: bullConnection, prefix: getBullPrefix(), ...workerOptions });
     worker.on('error', (err) => {
         logger.error(`${name} worker error`, {
             error: err.message,
@@ -98,6 +111,16 @@ export function createRunJobWorker({ type, workerOptions, run, }) {
             },
         })
             .catch((updateError) => {
+            // P2025 = record not found. The RunJob row is gone (orphaned job from a
+            // shared/reset Redis), so there's nothing to flag as FAILED — log
+            // quietly instead of as an error to avoid noise.
+            if (updateError instanceof Prisma.PrismaClientKnownRequestError &&
+                updateError.code === 'P2025') {
+                logger.warn(`${name} failure not recorded; RunJob no longer exists`, {
+                    runJobId,
+                });
+                return;
+            }
             logger.error(`Failed to record ${name} failure on RunJob`, {
                 runJobId,
                 error: updateError instanceof Error
@@ -115,4 +138,4 @@ export function createRunJobWorker({ type, workerOptions, run, }) {
     return worker;
 }
 //# sourceMappingURL=createRunJobWorker.js.map
-//# debugId=55ff9081-193c-5053-9606-34eeebf74f10
+//# debugId=411f71f1-9246-5cac-bbd7-d82a51d25576

package/dist/workers/processors/createRunJobWorker.js.map

@@ -1 +1 @@
-{"version":3,"file":"createRunJobWorker.js","sources":["workers/processors/createRunJobWorker.ts"],"sourceRoot":"/","sourcesContent":["/**\n * `createRunJobWorker` — shared factory for every BullMQ processor in this app.\n *\n * Wraps the boilerplate that every RunJob-backed worker needs:\n *   - Idempotent skip if the RunJob already SUCCEEDED (recovery after a crash\n *     that lost the BullMQ ack).\n *   - Status transitions: PENDING/RUNNING → RUNNING (with attempts++) → SUCCEEDED.\n *   - Failure handling: record latest error every attempt, flip to FAILED only\n *     on the final retry.\n *   - Standardised structured logging on `error` / `failed` / `completed`.\n *\n * A processor implementation only has to provide its `RunJobType`, optional\n * BullMQ options (concurrency, limiter, etc.), and a `run` callback that does\n * the actual work. The callback receives the typed `JobInputs[type]` payload\n * and a context object with `runJobId`, `bullJobId`, `attempt`, plus the\n * `userId` / `classId` from the original `enqueueRunJob` call.\n */\nimport { Worker, type Job, type WorkerOptions } from 'bullmq';\nimport { Prisma, type RunJobType } from '@prisma/client';\nimport { bullConnection } from '../connection.js';\nimport { prisma } from '../../lib/prisma.js';\nimport { logger } from '../../utils/logger.js';\nimport { QUEUE_NAMES, type JobInputs } from '../queues.js';\n\nexport interface RunJobContext {\n  runJobId: string;\n  bullJobId: string | undefined;\n  /** 1-indexed attempt number of the current run. */\n  attempt: number;\n  /** From `EnqueueOptions.userId` on the producer side. */\n  userId: string | null;\n  /** From `EnqueueOptions.classId` on the producer side. */\n  classId: string | null;\n}\n\nexport interface CreateRunJobWorkerOptions<T extends RunJobType> {\n  type: T;\n  /** BullMQ `WorkerOptions` minus `connection`, which is supplied by the helper. */\n  workerOptions?: Omit<WorkerOptions, 'connection'>;\n  /**\n   * The actual work. Return any JSON-serialisable value (or `null`) — it gets\n   * persisted to `RunJob.result` for the client to read back.\n   */\n  run: (\n    input: JobInputs[T],\n    ctx: RunJobContext,\n  ) => Promise<Prisma.InputJsonValue | null>;\n}\n\ntype WorkerData<T extends RunJobType> = JobInputs[T] & { runJobId: string };\n\nexport function createRunJobWorker<T extends RunJobType>({\n  type,\n  workerOptions,\n  run,\n}: CreateRunJobWorkerOptions<T>): Worker<WorkerData<T>> {\n  const name = QUEUE_NAMES[type];\n\n  const worker = new Worker<WorkerData<T>>(\n    name,\n    async (job: Job<WorkerData<T>>) => {\n      const { runJobId, ...rest } = job.data;\n      // The destructured rest is `Omit<JobInputs[T] & { runJobId }, 'runJobId'>`,\n      // which TS can't simplify back to `JobInputs[T]` while `T` is generic.\n      const input = rest as unknown as JobInputs[T];\n\n      const existing = await prisma.runJob.findUnique({\n        where: { id: runJobId },\n        select: { status: true, result: true, userId: true, classId: true },\n      });\n\n      if (existing?.status === 'SUCCEEDED') {\n        logger.info(`${name} RunJob already succeeded; skipping re-run`, {\n          runJobId,\n          bullJobId: job.id,\n        });\n        return existing.result;\n      }\n\n      await prisma.runJob.update({\n        where: { id: runJobId },\n        data: {\n          status: 'RUNNING',\n          startedAt: existing?.status === 'RUNNING' ? undefined : new Date(),\n          attempts: { increment: 1 },\n        },\n      });\n\n      const result = await run(input, {\n        runJobId,\n        bullJobId: job.id,\n        attempt: job.attemptsMade + 1,\n        userId: existing?.userId ?? null,\n        classId: existing?.classId ?? null,\n      });\n\n      await prisma.runJob.update({\n        where: { id: runJobId },\n        data: {\n          status: 'SUCCEEDED',\n          finishedAt: new Date(),\n          error: null,\n          result: result === null ? Prisma.JsonNull : result,\n        },\n      });\n\n      return result;\n    },\n    { connection: bullConnection, ...workerOptions },\n  );\n\n  worker.on('error', (err) => {\n    logger.error(`${name} worker error`, {\n      error: err.message,\n      stack: err.stack,\n    });\n  });\n\n  worker.on('failed', async (job, err) => {\n    if (!job) return;\n\n    const runJobId = job.data?.runJobId;\n    const isFinalAttempt = job.attemptsMade >= (job.opts.attempts ?? 1);\n\n    logger.error(`${name} job failed`, {\n      bullJobId: job.id,\n      runJobId,\n      attempt: job.attemptsMade,\n      finalAttempt: isFinalAttempt,\n      error: err.message,\n    });\n\n    if (!runJobId) return;\n\n    await prisma.runJob\n      .update({\n        where: { id: runJobId },\n        data: {\n          error: err.message,\n          ...(isFinalAttempt\n            ? { status: 'FAILED', finishedAt: new Date() }\n            : {}),\n        },\n      })\n      .catch((updateError) => {\n        logger.error(`Failed to record ${name} failure on RunJob`, {\n          runJobId,\n          error:\n            updateError instanceof Error\n              ? updateError.message\n              : String(updateError),\n        });\n      });\n  });\n\n  worker.on('completed', (job) => {\n    logger.info(`${name} job completed`, {\n      bullJobId: job.id,\n      runJobId: job.data?.runJobId,\n    });\n  });\n\n  return worker;\n}\n"],"names":[],"mappings":"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","debug_id":"55ff9081-193c-5053-9606-34eeebf74f10"}
+{"version":3,"file":"createRunJobWorker.js","sources":["workers/processors/createRunJobWorker.ts"],"sourceRoot":"/","sourcesContent":["/**\n * `createRunJobWorker` — shared factory for every BullMQ processor in this app.\n *\n * Wraps the boilerplate that every RunJob-backed worker needs:\n *   - Idempotent skip if the RunJob already SUCCEEDED (recovery after a crash\n *     that lost the BullMQ ack).\n *   - Status transitions: PENDING/RUNNING → RUNNING (with attempts++) → SUCCEEDED.\n *   - Failure handling: record latest error every attempt, flip to FAILED only\n *     on the final retry.\n *   - Standardised structured logging on `error` / `failed` / `completed`.\n *\n * A processor implementation only has to provide its `RunJobType`, optional\n * BullMQ options (concurrency, limiter, etc.), and a `run` callback that does\n * the actual work. The callback receives the typed `JobInputs[type]` payload\n * and a context object with `runJobId`, `bullJobId`, `attempt`, plus the\n * `userId` / `classId` from the original `enqueueRunJob` call.\n */\nimport { Worker, type Job, type WorkerOptions } from 'bullmq';\nimport { Prisma, type RunJobType } from '@prisma/client';\nimport { bullConnection, getBullPrefix } from '../connection.js';\nimport { prisma } from '../../lib/prisma.js';\nimport { logger } from '../../utils/logger.js';\nimport { QUEUE_NAMES, type JobInputs } from '../queues.js';\n\nexport interface RunJobContext {\n  runJobId: string;\n  bullJobId: string | undefined;\n  /** 1-indexed attempt number of the current run. */\n  attempt: number;\n  /** From `EnqueueOptions.userId` on the producer side. */\n  userId: string | null;\n  /** From `EnqueueOptions.classId` on the producer side. */\n  classId: string | null;\n}\n\nexport interface CreateRunJobWorkerOptions<T extends RunJobType> {\n  type: T;\n  /** BullMQ `WorkerOptions` minus `connection`, which is supplied by the helper. */\n  workerOptions?: Omit<WorkerOptions, 'connection'>;\n  /**\n   * The actual work. Return any JSON-serialisable value (or `null`) — it gets\n   * persisted to `RunJob.result` for the client to read back.\n   */\n  run: (\n    input: JobInputs[T],\n    ctx: RunJobContext,\n  ) => Promise<Prisma.InputJsonValue | null>;\n}\n\ntype WorkerData<T extends RunJobType> = JobInputs[T] & { runJobId: string };\n\nexport function createRunJobWorker<T extends RunJobType>({\n  type,\n  workerOptions,\n  run,\n}: CreateRunJobWorkerOptions<T>): Worker<WorkerData<T>> {\n  const name = QUEUE_NAMES[type];\n\n  const worker = new Worker<WorkerData<T>>(\n    name,\n    async (job: Job<WorkerData<T>>) => {\n      const { runJobId, ...rest } = job.data;\n      // The destructured rest is `Omit<JobInputs[T] & { runJobId }, 'runJobId'>`,\n      // which TS can't simplify back to `JobInputs[T]` while `T` is generic.\n      const input = rest as unknown as JobInputs[T];\n\n      const existing = await prisma.runJob.findUnique({\n        where: { id: runJobId },\n        select: { status: true, result: true, userId: true, classId: true },\n      });\n\n      if (!existing) {\n        // Orphaned job: the RunJob row this job points at does not exist in\n        // THIS database. Typically caused by a Redis instance shared across\n        // environments/databases (the `prefix` namespacing in this file's\n        // Worker options is the primary guard against that), or by a DB reset\n        // that left jobs behind in Redis. Discard instead of throwing on the\n        // `update` below and burning all retry attempts.\n        logger.warn(`${name} RunJob not found; discarding orphaned job`, {\n          runJobId,\n          bullJobId: job.id,\n        });\n        return null;\n      }\n\n      if (existing.status === 'SUCCEEDED') {\n        logger.info(`${name} RunJob already succeeded; skipping re-run`, {\n          runJobId,\n          bullJobId: job.id,\n        });\n        return existing.result;\n      }\n\n      await prisma.runJob.update({\n        where: { id: runJobId },\n        data: {\n          status: 'RUNNING',\n          startedAt: existing.status === 'RUNNING' ? undefined : new Date(),\n          attempts: { increment: 1 },\n        },\n      });\n\n      const result = await run(input, {\n        runJobId,\n        bullJobId: job.id,\n        attempt: job.attemptsMade + 1,\n        userId: existing.userId ?? null,\n        classId: existing.classId ?? null,\n      });\n\n      await prisma.runJob.update({\n        where: { id: runJobId },\n        data: {\n          status: 'SUCCEEDED',\n          finishedAt: new Date(),\n          error: null,\n          result: result === null ? Prisma.JsonNull : result,\n        },\n      });\n\n      return result;\n    },\n    { connection: bullConnection, prefix: getBullPrefix(), ...workerOptions },\n  );\n\n  worker.on('error', (err) => {\n    logger.error(`${name} worker error`, {\n      error: err.message,\n      stack: err.stack,\n    });\n  });\n\n  worker.on('failed', async (job, err) => {\n    if (!job) return;\n\n    const runJobId = job.data?.runJobId;\n    const isFinalAttempt = job.attemptsMade >= (job.opts.attempts ?? 1);\n\n    logger.error(`${name} job failed`, {\n      bullJobId: job.id,\n      runJobId,\n      attempt: job.attemptsMade,\n      finalAttempt: isFinalAttempt,\n      error: err.message,\n    });\n\n    if (!runJobId) return;\n\n    await prisma.runJob\n      .update({\n        where: { id: runJobId },\n        data: {\n          error: err.message,\n          ...(isFinalAttempt\n            ? { status: 'FAILED', finishedAt: new Date() }\n            : {}),\n        },\n      })\n      .catch((updateError) => {\n        // P2025 = record not found. The RunJob row is gone (orphaned job from a\n        // shared/reset Redis), so there's nothing to flag as FAILED — log\n        // quietly instead of as an error to avoid noise.\n        if (\n          updateError instanceof Prisma.PrismaClientKnownRequestError &&\n          updateError.code === 'P2025'\n        ) {\n          logger.warn(`${name} failure not recorded; RunJob no longer exists`, {\n            runJobId,\n          });\n          return;\n        }\n        logger.error(`Failed to record ${name} failure on RunJob`, {\n          runJobId,\n          error:\n            updateError instanceof Error\n              ? updateError.message\n              : String(updateError),\n        });\n      });\n  });\n\n  worker.on('completed', (job) => {\n    logger.info(`${name} job completed`, {\n      bullJobId: job.id,\n      runJobId: job.data?.runJobId,\n    });\n  });\n\n  return worker;\n}\n"],"names":[],"mappings":"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","debug_id":"411f71f1-9246-5cac-bbd7-d82a51d25576"}

package/dist/workers/processors/embedContent.d.ts

@@ -0,0 +1,8 @@
+export declare const embedContentWorker: import("bullmq").Worker<{
+    classId: string;
+    sourceType: string;
+    sourceId: string;
+} & {
+    runJobId: string;
+}, any, string>;
+//# sourceMappingURL=embedContent.d.ts.map

package/dist/workers/processors/embedContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedContent.d.ts","sourceRoot":"/","sources":["workers/processors/embedContent.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,kBAAkB;;;;;;eA0E7B,CAAC"}

package/dist/workers/processors/embedContent.js

@@ -0,0 +1,76 @@
+/**
+ * Background worker for embedding content into pgvector.
+ * Handles indexing of files, assignments, worksheets, and announcements.
+ */
+
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="116d23dd-eaa9-5dfb-9c03-00562d2b8b6d")}catch(e){}}();
+import { createRunJobWorker } from './createRunJobWorker.js';
+import { indexAssignment, indexWorksheet, indexAnnouncement, indexContent, } from '../../services/embedding.js';
+import { prisma } from '../../lib/prisma.js';
+import { logger } from '../../utils/logger.js';
+export const embedContentWorker = createRunJobWorker({
+    type: 'EMBED_CONTENT',
+    workerOptions: {
+        concurrency: 3,
+        limiter: { max: 10, duration: 60000 },
+    },
+    run: async ({ classId, sourceType, sourceId }) => {
+        const typedSourceType = sourceType;
+        switch (typedSourceType) {
+            case 'ASSIGNMENT':
+                await indexAssignment(classId, sourceId);
+                break;
+            case 'WORKSHEET':
+                await indexWorksheet(classId, sourceId);
+                break;
+            case 'ANNOUNCEMENT':
+                await indexAnnouncement(classId, sourceId);
+                break;
+            case 'FILE': {
+                // For files, fetch the file metadata and content
+                const file = await prisma.file.findUnique({
+                    where: { id: sourceId },
+                    select: { name: true, path: true, type: true },
+                });
+                if (!file) {
+                    logger.warn('File not found for embedding', { sourceId });
+                    return { skipped: true, reason: 'file_not_found' };
+                }
+                // For now, index the filename and any text-based content.
+                // PDF extraction would be added here with pdf-parse.
+                const text = `File: ${file.name}\nType: ${file.type}\nPath: ${file.path}`;
+                await indexContent({
+                    classId,
+                    sourceType: 'FILE',
+                    sourceId,
+                    text,
+                    metadata: { name: file.name, type: file.type },
+                });
+                break;
+            }
+            case 'SECTION': {
+                const section = await prisma.section.findUnique({
+                    where: { id: sourceId },
+                    select: { name: true },
+                });
+                if (!section) {
+                    return { skipped: true, reason: 'section_not_found' };
+                }
+                await indexContent({
+                    classId,
+                    sourceType: 'SECTION',
+                    sourceId,
+                    text: `Section: ${section.name}`,
+                    metadata: { name: section.name },
+                });
+                break;
+            }
+            default:
+                logger.warn('Unknown embedding source type', { sourceType, sourceId });
+                return { skipped: true, reason: 'unknown_source_type' };
+        }
+        return { indexed: true, sourceType, sourceId };
+    },
+});
+//# sourceMappingURL=embedContent.js.map
+//# debugId=116d23dd-eaa9-5dfb-9c03-00562d2b8b6d

package/dist/workers/processors/embedContent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedContent.js","sources":["workers/processors/embedContent.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Background worker for embedding content into pgvector.\n * Handles indexing of files, assignments, worksheets, and announcements.\n */\nimport { createRunJobWorker } from './createRunJobWorker.js';\nimport {\n  indexAssignment,\n  indexWorksheet,\n  indexAnnouncement,\n  indexContent,\n} from '../../services/embedding.js';\nimport { prisma } from '../../lib/prisma.js';\nimport { logger } from '../../utils/logger.js';\nimport type { EmbeddingSourceType } from '@prisma/client';\n\nexport const embedContentWorker = createRunJobWorker({\n  type: 'EMBED_CONTENT',\n  workerOptions: {\n    concurrency: 3,\n    limiter: { max: 10, duration: 60_000 },\n  },\n  run: async ({ classId, sourceType, sourceId }) => {\n    const typedSourceType = sourceType as EmbeddingSourceType;\n\n    switch (typedSourceType) {\n      case 'ASSIGNMENT':\n        await indexAssignment(classId, sourceId);\n        break;\n\n      case 'WORKSHEET':\n        await indexWorksheet(classId, sourceId);\n        break;\n\n      case 'ANNOUNCEMENT':\n        await indexAnnouncement(classId, sourceId);\n        break;\n\n      case 'FILE': {\n        // For files, fetch the file metadata and content\n        const file = await prisma.file.findUnique({\n          where: { id: sourceId },\n          select: { name: true, path: true, type: true },\n        });\n\n        if (!file) {\n          logger.warn('File not found for embedding', { sourceId });\n          return { skipped: true, reason: 'file_not_found' };\n        }\n\n        // For now, index the filename and any text-based content.\n        // PDF extraction would be added here with pdf-parse.\n        const text = `File: ${file.name}\\nType: ${file.type}\\nPath: ${file.path}`;\n        await indexContent({\n          classId,\n          sourceType: 'FILE',\n          sourceId,\n          text,\n          metadata: { name: file.name, type: file.type },\n        });\n        break;\n      }\n\n      case 'SECTION': {\n        const section = await prisma.section.findUnique({\n          where: { id: sourceId },\n          select: { name: true },\n        });\n\n        if (!section) {\n          return { skipped: true, reason: 'section_not_found' };\n        }\n\n        await indexContent({\n          classId,\n          sourceType: 'SECTION',\n          sourceId,\n          text: `Section: ${section.name}`,\n          metadata: { name: section.name },\n        });\n        break;\n      }\n\n      default:\n        logger.warn('Unknown embedding source type', { sourceType, sourceId });\n        return { skipped: true, reason: 'unknown_source_type' };\n    }\n\n    return { indexed: true, sourceType, sourceId };\n  },\n});\n"],"names":[],"mappings":"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","debug_id":"116d23dd-eaa9-5dfb-9c03-00562d2b8b6d"}

package/dist/workers/queues.d.ts

@@ -52,6 +52,12 @@ export type JobInputs = {
         studentId: string;
         message: string;
     };
+    /** Embed content into pgvector for RAG search. */
+    EMBED_CONTENT: {
+        classId: string;
+        sourceType: string;
+        sourceId: string;
+    };
 };
 export declare const QUEUE_NAMES: Record<RunJobType, string>;
 export interface EnqueueOptions {

package/dist/workers/queues.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"queues.d.ts","sourceRoot":"/","sources":["workers/queues.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAYzD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB;;;;;OAKG;IACH,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,eAAe,EAAE;QAAE,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD;;;;;OAKG;IACH,WAAW,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D;;OAEG;IACH,cAAc,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,qBAAqB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAChF,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAMlD,CAAC;AAoBF,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qEAAqE;IACrE,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,UAAU,EACtD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA2DxB;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpD"}
+{"version":3,"file":"queues.d.ts","sourceRoot":"/","sources":["workers/queues.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAYzD;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB;;;;;OAKG;IACH,gBAAgB,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,eAAe,EAAE;QAAE,mBAAmB,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD;;;;;OAKG;IACH,WAAW,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D;;OAEG;IACH,cAAc,EAAE;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,qBAAqB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,kDAAkD;IAClD,aAAa,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1E,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAOlD,CAAC;AAqBF,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qEAAqE;IACrE,UAAU,CAAC,EAAE,WAAW,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CAAC,CAAC,SAAS,UAAU,EACtD,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA2DxB;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAGpD"}

package/dist/workers/queues.js

@@ -7,9 +7,9 @@
  * which is the entrypoint of the separate long-running worker process.
  */
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="feefd10a-9381-5c30-a525-0ffe36e2e323")}catch(e){}}();
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="8b504f67-acd8-5793-a500-d561724f9c85")}catch(e){}}();
 import { Queue } from 'bullmq';
-import { bullConnection } from './connection.js';
+import { bullConnection, getBullPrefix } from './connection.js';
 import { prisma } from '../lib/prisma.js';
 import { logger } from '../utils/logger.js';
 const DEFAULT_JOB_OPTIONS = {
@@ -24,6 +24,7 @@ export const QUEUE_NAMES = {
     AI_LAB_CHAT: 'aiLabChat',
     AI_NEWTON_CHAT: 'aiNewtonChat',
     STUDENT_PROGRESS_CHAT: 'studentProgressChat',
+    EMBED_CONTENT: 'embedContent',
 };
 /**
  * One Queue instance per type. Created lazily so that importing this module
@@ -35,6 +36,7 @@ function getQueue(type) {
     if (!queue) {
         queue = new Queue(QUEUE_NAMES[type], {
             connection: bullConnection,
+            prefix: getBullPrefix(),
             defaultJobOptions: DEFAULT_JOB_OPTIONS,
         });
         queueCache.set(type, queue);
@@ -116,4 +118,4 @@ export async function closeAllQueues() {
     queueCache.clear();
 }
 //# sourceMappingURL=queues.js.map
-//# debugId=feefd10a-9381-5c30-a525-0ffe36e2e323
+//# debugId=8b504f67-acd8-5793-a500-d561724f9c85

package/dist/workers/queues.js.map

@@ -1 +1 @@
-{"version":3,"file":"queues.js","sources":["workers/queues.ts"],"sourceRoot":"/","sourcesContent":["/**\n * BullMQ queue producers and the `enqueueRunJob` helper.\n *\n * Producer side only — safe to import from HTTP routes / services running on\n * Vercel. Importing this file does NOT start any workers; workers live in\n * `src/workers/processors/*` and are wired up by `src/workers/index.ts`,\n * which is the entrypoint of the separate long-running worker process.\n */\nimport { Queue, type JobsOptions } from 'bullmq';\nimport { Prisma, type RunJobType } from '@prisma/client';\nimport { bullConnection } from './connection.js';\nimport { prisma } from '../lib/prisma.js';\nimport { logger } from '../utils/logger.js';\n\nconst DEFAULT_JOB_OPTIONS: JobsOptions = {\n  attempts: 3,\n  backoff: { type: 'exponential', delay: 5_000 },\n  removeOnComplete: { age: 60 * 60 }, // keep completed jobs in Redis for 1h, then drop\n  removeOnFail: { age: 24 * 60 * 60 }, // keep failed jobs for 24h for inspection\n};\n\n/**\n * Map RunJobType → (queue name, input payload shape).\n *\n * Add a new entry here whenever you introduce a new background job type.\n * The queue name string must match what the corresponding processor passes\n * to `new Worker(<name>, ...)`.\n */\nexport type JobInputs = {\n  /**\n   * `worksheetId` is the placeholder Worksheet row created synchronously by\n   * the producer (so the client has an id to navigate to). The pipeline fills\n   * that row in asynchronously and broadcasts progress on the per-worksheet\n   * job channel.\n   */\n  PDF_TO_WORKSHEET: { gcsUrl: string; classId: string; worksheetId: string };\n  GRADE_WORKSHEET: { worksheetResponseId: string };\n  /**\n   * `aiMessageId` is the placeholder AI Message row created synchronously by\n   * the producer before enqueue (so the client renders a PENDING bubble in\n   * the timeline). The pipeline fills in the content and flips the row to\n   * COMPLETED / FAILED. Used for both intros and replies — single shape.\n   */\n  AI_LAB_CHAT: { conversationId: string; aiMessageId: string };\n  /**\n   * `aiMessageId` placeholder pattern, same as AI_LAB_CHAT — see above.\n   */\n  AI_NEWTON_CHAT: { conversationId: string; aiMessageId: string };\n  STUDENT_PROGRESS_CHAT: { classId: string; studentId: string; message: string };\n};\n\nexport const QUEUE_NAMES: Record<RunJobType, string> = {\n  PDF_TO_WORKSHEET: 'pdfToWorksheet',\n  GRADE_WORKSHEET: 'gradeWorksheet',\n  AI_LAB_CHAT: 'aiLabChat',\n  AI_NEWTON_CHAT: 'aiNewtonChat',\n  STUDENT_PROGRESS_CHAT: 'studentProgressChat',\n};\n\n/**\n * One Queue instance per type. Created lazily so that importing this module\n * does not eagerly open queues you may never use in a given runtime.\n */\nconst queueCache = new Map<RunJobType, Queue>();\n\nfunction getQueue(type: RunJobType): Queue {\n  let queue = queueCache.get(type);\n  if (!queue) {\n    queue = new Queue(QUEUE_NAMES[type], {\n      connection: bullConnection,\n      defaultJobOptions: DEFAULT_JOB_OPTIONS,\n    });\n    queueCache.set(type, queue);\n  }\n  return queue;\n}\n\nexport interface EnqueueOptions {\n  classId?: string | null;\n  userId?: string | null;\n  /** Override BullMQ job options (attempts, delay, priority, etc.). */\n  jobOptions?: JobsOptions;\n}\n\nexport interface EnqueueResult {\n  runJobId: string;\n  bullJobId: string | null;\n}\n\n/**\n * Create a `RunJob` audit row, enqueue the BullMQ job, and link the two.\n *\n * Returns immediately — the actual work happens on the worker process. The\n * caller can return `runJobId` to the client and have them poll `getRunJob`\n * (or subscribe over Pusher) to track progress.\n *\n * IMPORTANT: do not call this inside a Prisma `$transaction`. If the outer\n * transaction rolls back after the BullMQ job is added, the worker will pick\n * up an orphaned job pointing at a non-existent RunJob row. Enqueue *after*\n * the transaction commits.\n */\nexport async function enqueueRunJob<T extends RunJobType>(\n  type: T,\n  input: JobInputs[T],\n  options: EnqueueOptions = {},\n): Promise<EnqueueResult> {\n  const runJob = await prisma.runJob.create({\n    data: {\n      type,\n      status: 'PENDING',\n      classId: options.classId ?? null,\n      userId: options.userId ?? null,\n      input: input as unknown as Prisma.InputJsonValue,\n    },\n  });\n\n  try {\n    const queue = getQueue(type);\n    const job = await queue.add(\n      QUEUE_NAMES[type],\n      { runJobId: runJob.id, ...input },\n      options.jobOptions,\n    );\n\n    try {\n      await prisma.runJob.update({\n        where: { id: runJob.id },\n        data: { bullJobId: job.id ?? null },\n      });\n    } catch (linkError) {\n      logger.error('RunJob enqueued but bullJobId linkage failed', {\n        runJobId: runJob.id,\n        bullJobId: job.id ?? null,\n        type,\n        error: linkError instanceof Error ? linkError.message : String(linkError),\n      });\n    }\n\n    return { runJobId: runJob.id, bullJobId: job.id ?? null };\n  } catch (error) {\n    logger.error('Failed to enqueue RunJob; marking FAILED', {\n      runJobId: runJob.id,\n      type,\n      error: error instanceof Error ? error.message : String(error),\n    });\n\n    try {\n      await prisma.runJob.update({\n        where: { id: runJob.id },\n        data: {\n          status: 'FAILED',\n          error: error instanceof Error ? error.message : String(error),\n          finishedAt: new Date(),\n        },\n      });\n    } catch (updateError) {\n      logger.error('Failed to mark RunJob as FAILED after enqueue error', {\n        runJobId: runJob.id,\n        error: updateError instanceof Error ? updateError.message : String(updateError),\n      });\n    }\n\n    throw error;\n  }\n}\n\n/**\n * Close every cached queue. Call from the HTTP server's shutdown handler so\n * the producer side disconnects from Redis cleanly.\n */\nexport async function closeAllQueues(): Promise<void> {\n  await Promise.all(Array.from(queueCache.values()).map((q) => q.close()));\n  queueCache.clear();\n}\n"],"names":[],"mappings":"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","debug_id":"feefd10a-9381-5c30-a525-0ffe36e2e323"}
+{"version":3,"file":"queues.js","sources":["workers/queues.ts"],"sourceRoot":"/","sourcesContent":["/**\n * BullMQ queue producers and the `enqueueRunJob` helper.\n *\n * Producer side only — safe to import from HTTP routes / services running on\n * Vercel. Importing this file does NOT start any workers; workers live in\n * `src/workers/processors/*` and are wired up by `src/workers/index.ts`,\n * which is the entrypoint of the separate long-running worker process.\n */\nimport { Queue, type JobsOptions } from 'bullmq';\nimport { Prisma, type RunJobType } from '@prisma/client';\nimport { bullConnection, getBullPrefix } from './connection.js';\nimport { prisma } from '../lib/prisma.js';\nimport { logger } from '../utils/logger.js';\n\nconst DEFAULT_JOB_OPTIONS: JobsOptions = {\n  attempts: 3,\n  backoff: { type: 'exponential', delay: 5_000 },\n  removeOnComplete: { age: 60 * 60 }, // keep completed jobs in Redis for 1h, then drop\n  removeOnFail: { age: 24 * 60 * 60 }, // keep failed jobs for 24h for inspection\n};\n\n/**\n * Map RunJobType → (queue name, input payload shape).\n *\n * Add a new entry here whenever you introduce a new background job type.\n * The queue name string must match what the corresponding processor passes\n * to `new Worker(<name>, ...)`.\n */\nexport type JobInputs = {\n  /**\n   * `worksheetId` is the placeholder Worksheet row created synchronously by\n   * the producer (so the client has an id to navigate to). The pipeline fills\n   * that row in asynchronously and broadcasts progress on the per-worksheet\n   * job channel.\n   */\n  PDF_TO_WORKSHEET: { gcsUrl: string; classId: string; worksheetId: string };\n  GRADE_WORKSHEET: { worksheetResponseId: string };\n  /**\n   * `aiMessageId` is the placeholder AI Message row created synchronously by\n   * the producer before enqueue (so the client renders a PENDING bubble in\n   * the timeline). The pipeline fills in the content and flips the row to\n   * COMPLETED / FAILED. Used for both intros and replies — single shape.\n   */\n  AI_LAB_CHAT: { conversationId: string; aiMessageId: string };\n  /**\n   * `aiMessageId` placeholder pattern, same as AI_LAB_CHAT — see above.\n   */\n  AI_NEWTON_CHAT: { conversationId: string; aiMessageId: string };\n  STUDENT_PROGRESS_CHAT: { classId: string; studentId: string; message: string };\n  /** Embed content into pgvector for RAG search. */\n  EMBED_CONTENT: { classId: string; sourceType: string; sourceId: string };\n};\n\nexport const QUEUE_NAMES: Record<RunJobType, string> = {\n  PDF_TO_WORKSHEET: 'pdfToWorksheet',\n  GRADE_WORKSHEET: 'gradeWorksheet',\n  AI_LAB_CHAT: 'aiLabChat',\n  AI_NEWTON_CHAT: 'aiNewtonChat',\n  STUDENT_PROGRESS_CHAT: 'studentProgressChat',\n  EMBED_CONTENT: 'embedContent',\n};\n\n/**\n * One Queue instance per type. Created lazily so that importing this module\n * does not eagerly open queues you may never use in a given runtime.\n */\nconst queueCache = new Map<RunJobType, Queue>();\n\nfunction getQueue(type: RunJobType): Queue {\n  let queue = queueCache.get(type);\n  if (!queue) {\n    queue = new Queue(QUEUE_NAMES[type], {\n      connection: bullConnection,\n      prefix: getBullPrefix(),\n      defaultJobOptions: DEFAULT_JOB_OPTIONS,\n    });\n    queueCache.set(type, queue);\n  }\n  return queue;\n}\n\nexport interface EnqueueOptions {\n  classId?: string | null;\n  userId?: string | null;\n  /** Override BullMQ job options (attempts, delay, priority, etc.). */\n  jobOptions?: JobsOptions;\n}\n\nexport interface EnqueueResult {\n  runJobId: string;\n  bullJobId: string | null;\n}\n\n/**\n * Create a `RunJob` audit row, enqueue the BullMQ job, and link the two.\n *\n * Returns immediately — the actual work happens on the worker process. The\n * caller can return `runJobId` to the client and have them poll `getRunJob`\n * (or subscribe over Pusher) to track progress.\n *\n * IMPORTANT: do not call this inside a Prisma `$transaction`. If the outer\n * transaction rolls back after the BullMQ job is added, the worker will pick\n * up an orphaned job pointing at a non-existent RunJob row. Enqueue *after*\n * the transaction commits.\n */\nexport async function enqueueRunJob<T extends RunJobType>(\n  type: T,\n  input: JobInputs[T],\n  options: EnqueueOptions = {},\n): Promise<EnqueueResult> {\n  const runJob = await prisma.runJob.create({\n    data: {\n      type,\n      status: 'PENDING',\n      classId: options.classId ?? null,\n      userId: options.userId ?? null,\n      input: input as unknown as Prisma.InputJsonValue,\n    },\n  });\n\n  try {\n    const queue = getQueue(type);\n    const job = await queue.add(\n      QUEUE_NAMES[type],\n      { runJobId: runJob.id, ...input },\n      options.jobOptions,\n    );\n\n    try {\n      await prisma.runJob.update({\n        where: { id: runJob.id },\n        data: { bullJobId: job.id ?? null },\n      });\n    } catch (linkError) {\n      logger.error('RunJob enqueued but bullJobId linkage failed', {\n        runJobId: runJob.id,\n        bullJobId: job.id ?? null,\n        type,\n        error: linkError instanceof Error ? linkError.message : String(linkError),\n      });\n    }\n\n    return { runJobId: runJob.id, bullJobId: job.id ?? null };\n  } catch (error) {\n    logger.error('Failed to enqueue RunJob; marking FAILED', {\n      runJobId: runJob.id,\n      type,\n      error: error instanceof Error ? error.message : String(error),\n    });\n\n    try {\n      await prisma.runJob.update({\n        where: { id: runJob.id },\n        data: {\n          status: 'FAILED',\n          error: error instanceof Error ? error.message : String(error),\n          finishedAt: new Date(),\n        },\n      });\n    } catch (updateError) {\n      logger.error('Failed to mark RunJob as FAILED after enqueue error', {\n        runJobId: runJob.id,\n        error: updateError instanceof Error ? updateError.message : String(updateError),\n      });\n    }\n\n    throw error;\n  }\n}\n\n/**\n * Close every cached queue. Call from the HTTP server's shutdown handler so\n * the producer side disconnects from Redis cleanly.\n */\nexport async function closeAllQueues(): Promise<void> {\n  await Promise.all(Array.from(queueCache.values()).map((q) => q.close()));\n  queueCache.clear();\n}\n"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;;AACH,OAAO,EAAE,KAAK,EAAoB,MAAM,QAAQ,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C,MAAM,mBAAmB,GAAgB;IACvC,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,IAAK,EAAE;IAC9C,gBAAgB,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,iDAAiD;IACrF,YAAY,EAAE,EAAE,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,0CAA0C;CAChF,CAAC;AAkCF,MAAM,CAAC,MAAM,WAAW,GAA+B;IACrD,gBAAgB,EAAE,gBAAgB;IAClC,eAAe,EAAE,gBAAgB;IACjC,WAAW,EAAE,WAAW;IACxB,cAAc,EAAE,cAAc;IAC9B,qBAAqB,EAAE,qBAAqB;IAC5C,aAAa,EAAE,cAAc;CAC9B,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;AAEhD,SAAS,QAAQ,CAAC,IAAgB;IAChC,IAAI,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,KAAK,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE;YACnC,UAAU,EAAE,cAAc;YAC1B,MAAM,EAAE,aAAa,EAAE;YACvB,iBAAiB,EAAE,mBAAmB;SACvC,CAAC,CAAC;QACH,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAcD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAO,EACP,KAAmB,EACnB,UAA0B,EAAE;IAE5B,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QACxC,IAAI,EAAE;YACJ,IAAI;YACJ,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;YAChC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;YAC9B,KAAK,EAAE,KAAyC;SACjD;KACF,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CACzB,WAAW,CAAC,IAAI,CAAC,EACjB,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,GAAG,KAAK,EAAE,EACjC,OAAO,CAAC,UAAU,CACnB,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;gBACzB,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;gBACxB,IAAI,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,IAAI,IAAI,EAAE;aACpC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,SAAS,EAAE,CAAC;YACnB,MAAM,CAAC,KAAK,CAAC,8CAA8C,EAAE;gBAC3D,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,SAAS,EAAE,GAAG,CAAC,EAAE,IAAI,IAAI;gBACzB,IAAI;gBACJ,KAAK,EAAE,SAAS,YAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;aAC1E,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;IAC5D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,0CAA0C,EAAE;YACvD,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,IAAI;YACJ,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;gBACzB,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE;gBACxB,IAAI,EAAE;oBACJ,MAAM,EAAE,QAAQ;oBAChB,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;oBAC7D,UAAU,EAAE,IAAI,IAAI,EAAE;iBACvB;aACF,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,WAAW,EAAE,CAAC;YACrB,MAAM,CAAC,KAAK,CAAC,qDAAqD,EAAE;gBAClE,QAAQ,EAAE,MAAM,CAAC,EAAE;gBACnB,KAAK,EAAE,WAAW,YAAY,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC;aAChF,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IACzE,UAAU,CAAC,KAAK,EAAE,CAAC;AACrB,CAAC","debug_id":"8b504f67-acd8-5793-a500-d561724f9c85"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studious-lms/server",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "Backend server for Studious application",
   "main": "dist/exportType.js",
   "types": "dist/exportType.d.ts",
@@ -29,6 +29,7 @@
     "sentry:sourcemaps": "sentry-cli sourcemaps inject ./dist && sentry-cli sourcemaps upload --org \"${SENTRY_ORG:-studious-lms}\" --project \"${SENTRY_PROJECT:-server}\" ./dist"
   },
   "dependencies": {
+    "@ai-sdk/openai": "^3.0.68",
     "@google-cloud/storage": "^5.18.3",
     "@pdf-lib/fontkit": "^1.1.1",
     "@prisma/client": "^6.7.0",
@@ -36,6 +37,7 @@
     "@sentry/node": "^10.26.0",
     "@trpc/server": "^11.4.3",
     "@unkey/ratelimit": "^2.1.3",
+    "ai": "^6.0.197",
     "bcryptjs": "^3.0.2",
     "bullmq": "^5.76.6",
     "compression": "^1.8.1",
@@ -49,6 +51,7 @@
     "nodemailer": "^8.0.7",
     "openai": "^5.23.0",
     "pdf-lib": "^1.17.1",
+    "pdf-parse": "^2.4.5",
     "prisma": "^6.7.0",
     "pusher": "^5.2.0",
     "sharp": "^0.34.2",
@@ -63,6 +66,7 @@
     "@types/express": "^4.17.21",
     "@types/node": "^20.11.24",
     "@types/nodemailer": "^6.4.17",
+    "@types/pdf-parse": "^1.1.5",
     "@types/supertest": "^6.0.3",
     "@types/uuid": "^10.0.0",
     "@vitest/coverage-v8": "^3.2.4",