@studious-lms/server 1.4.2 → 1.4.3

package/dist/utils/inference.d.ts

@@ -2,9 +2,17 @@
  * Inference util – OpenAI client, inference() for structured output, sendAIMessage for chat.
  */
 import OpenAI from 'openai';
+import { Prisma } from '@prisma/client';
 import { ZodSchema } from 'zod';
 export declare const inferenceClient: OpenAI;
 export declare const openAIClient: OpenAI;
+export interface InferenceOptions {
+    reason?: string;
+    metadata?: Prisma.InputJsonValue;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
 export interface LabChatContext {
     subject: string;
     topic: string;
@@ -46,7 +54,7 @@ export declare function sendAIMessage(content: string, conversationId: string, o
     createdAt: Date;
     meta?: Record<string, any>;
 }>;
-export declare function inference<T>(content: string | OpenAI.Chat.Completions.ChatCompletionMessageParam[], format?: ZodSchema): Promise<T>;
+export declare function inference<T>(content: string | OpenAI.Chat.Completions.ChatCompletionMessageParam[], format?: ZodSchema, options?: InferenceOptions): Promise<T>;
 /**
  * Get available inference models (for admin/config purposes)
  */

package/dist/utils/inference.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inference.d.ts","sourceRoot":"/","sources":["utils/inference.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAM5B,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAKhC,eAAO,MAAM,eAAe,QAG1B,CAAC;AAEH,eAAO,MAAM,YAAY,QAAe,CAAC;AAGzC,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC3B,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,YAAY,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;CACE,GACL,OAAO,CAAC;IACT,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B,CAAC,CAwED;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,0BAA0B,EAAE,EACtE,MAAM,CAAC,EAAE,SAAS,GACjB,OAAO,CAAC,CAAC,CAAC,CA8DZ;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAW5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGvD"}
+{"version":3,"file":"inference.d.ts","sourceRoot":"/","sources":["utils/inference.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAM5B,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGhC,eAAO,MAAM,eAAe,QAG1B,CAAC;AAEH,eAAO,MAAM,YAAY,QAAe,CAAC;AASzC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoBD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAgHD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC3B,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,YAAY,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;CACE,GACL,OAAO,CAAC;IACT,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B,CAAC,CAoED;AAED,wBAAsB,SAAS,CAAC,CAAC,EAC/B,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,0BAA0B,EAAE,EACtE,MAAM,CAAC,EAAE,SAAS,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,CAAC,CAAC,CA+EZ;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAW5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/dist/utils/inference.js

@@ -2,27 +2,104 @@
  * Inference util – OpenAI client, inference() for structured output, sendAIMessage for chat.
  */
 
-!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]="29f2563b-5001-5af3-9bfe-191889a55b09")}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]="4274513f-5640-53ae-a6ca-567fff3e8bee")}catch(e){}}();
 import OpenAI from 'openai';
 import { logger } from './logger.js';
 import { prisma } from '../lib/prisma.js';
 import { chatChannel, pusher } from '../lib/pusher.js';
 import { ensureAIUserExists, getAIUserId } from './aiUser.js';
 import { env } from '../lib/config/env.js';
-import { zodTextFormat } from "openai/helpers/zod";
+import { zodTextFormat } from 'openai/helpers/zod';
 export const inferenceClient = new OpenAI({
     apiKey: env.INFERENCE_API_KEY,
     baseURL: env.INFERENCE_API_BASE_URL,
 });
 export const openAIClient = new OpenAI();
+const DEFAULT_INFERENCE_MODEL = 'gpt-5-nano';
+function normalizeInferenceInput(content) {
+    if (typeof content === 'string') {
+        return [{ role: 'user', content }];
+    }
+    return content.map((message) => ({
+        role: message.role,
+        content: typeof message.content === 'string' ? message.content : JSON.stringify(message.content),
+    }));
+}
+function getInferenceReason(options) {
+    return options?.reason?.trim() || 'unspecified';
+}
+function serializeInferenceError(error) {
+    if (error instanceof Error) {
+        return error.message;
+    }
+    if (typeof error === 'string') {
+        return error;
+    }
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return 'Unknown inference error';
+    }
+}
+async function logInferenceUsage({ model, operation, success, estimatedInputTokens, reason, metadata, usage, error, }) {
+    const context = {
+        reason,
+        model,
+        operation,
+        success,
+        estimatedInputTokens,
+        promptTokens: usage?.promptTokens,
+        completionTokens: usage?.completionTokens,
+        totalTokens: usage?.totalTokens,
+        metadata,
+        ...(error ? { error: serializeInferenceError(error) } : {}),
+    };
+    try {
+        await prisma.aiUsageLog.create({
+            data: {
+                reason,
+                model,
+                operation,
+                success,
+                estimatedInputTokens,
+                promptTokens: usage?.promptTokens,
+                completionTokens: usage?.completionTokens,
+                totalTokens: usage?.totalTokens,
+                ...(metadata !== undefined ? { metadata } : {}),
+                ...(error ? { error: serializeInferenceError(error) } : {}),
+            },
+        });
+    }
+    catch (loggingError) {
+        logger.error('Failed to persist AI usage log', {
+            ...context,
+            loggingError: serializeInferenceError(loggingError),
+        });
+        return;
+    }
+    logger.info('AI usage logged', context);
+}
+function getChatCompletionUsage(completion) {
+    return {
+        promptTokens: completion.usage?.prompt_tokens,
+        completionTokens: completion.usage?.completion_tokens,
+        totalTokens: completion.usage?.total_tokens,
+    };
+}
+function getResponseUsage(completion) {
+    return {
+        promptTokens: completion.usage?.input_tokens,
+        completionTokens: completion.usage?.output_tokens,
+        totalTokens: completion.usage?.total_tokens,
+    };
+}
 /**
  * Centralized function to send AI messages to conversations
  * Handles database storage and Pusher broadcasting
  */
 export async function sendAIMessage(content, conversationId, options = {}) {
-    // Ensure AI user exists
     await ensureAIUserExists();
-    // Create message in database
     const aiMessage = await prisma.message.create({
         data: {
             content,
@@ -46,16 +123,14 @@ export async function sendAIMessage(content, conversationId, options = {}) {
         conversationId,
         contentLength: content.length,
     });
-    // Prepare sender info
     const senderInfo = {
         id: getAIUserId(),
         username: 'Newton_AI',
         profile: {
-            displayName: "Newton AI",
+            displayName: 'Newton AI',
             profilePicture: options.customSender?.profilePicture || null,
         },
     };
-    // Broadcast via Pusher
     try {
         await pusher.trigger(chatChannel(conversationId), 'new-message', {
             id: aiMessage.id,
@@ -66,7 +141,7 @@ export async function sendAIMessage(content, conversationId, options = {}) {
             sender: senderInfo,
             mentionedUserIds: [],
             meta: aiMessage.meta,
-            attachments: aiMessage.attachments.map(attachment => ({
+            attachments: aiMessage.attachments.map((attachment) => ({
                 id: attachment.id,
                 attachmentId: attachment.id,
                 name: attachment.name,
@@ -88,59 +163,73 @@ export async function sendAIMessage(content, conversationId, options = {}) {
         meta: aiMessage.meta,
     };
 }
-export async function inference(content, format) {
+export async function inference(content, format, options) {
+    const input = normalizeInferenceInput(content);
+    const reason = getInferenceReason(options);
+    const model = options?.model ?? DEFAULT_INFERENCE_MODEL;
+    const estimatedInputTokens = input.reduce((total, message) => total + estimateTokenCount(message.content), 0);
+    const operation = format ? 'responses.parse' : 'chat.completions';
     try {
         if (!format) {
             const completion = await openAIClient.chat.completions.create({
-                model: 'gpt-5-nano',
-                messages: typeof content === 'string' ? [
-                    {
-                        role: 'user',
-                        content: content,
-                    },
-                ] : content,
+                model,
+                messages: input,
+                ...(options?.temperature !== undefined
+                    ? { temperature: options.temperature }
+                    : {}),
+                ...(options?.maxTokens !== undefined
+                    ? { max_tokens: options.maxTokens }
+                    : {}),
+            });
+            await logInferenceUsage({
+                model,
+                operation,
+                success: true,
+                estimatedInputTokens,
+                reason,
+                metadata: options?.metadata,
+                usage: getChatCompletionUsage(completion),
             });
             return completion.choices[0]?.message?.content;
         }
         const completion = await openAIClient.responses.parse({
-            model: 'gpt-5-nano',
-            input: typeof content === 'string' ? [
-                {
-                    role: 'user',
-                    content: content,
-                },
-            ] : content,
-            ...(format ? { text: {
-                    format: zodTextFormat(format, "newton_response_format"),
-                },
-            } : {}),
-        });
-        console.log({
-            model: 'gpt-5-nano',
-            input: typeof content === 'string' ? [
-                {
-                    role: 'user',
-                    content: content,
-                },
-            ] : content,
-            ...(format ? { text: {
-                    format: zodTextFormat(format, "newton_response_format"),
-                },
-            } : {}),
+            model,
+            input,
+            text: {
+                format: zodTextFormat(format, 'newton_response_format'),
+            },
         });
         if (!completion) {
             throw new Error('No response generated from inference API');
         }
-        // if (format) {
-        //   if (typeof completion.output === 'string') {
-        //     return JSON.parse(completion.output);
-        //   }
-        //   return JSON.parse(completion.output);
-        // }
+        await logInferenceUsage({
+            model,
+            operation,
+            success: true,
+            estimatedInputTokens,
+            reason,
+            metadata: options?.metadata,
+            usage: getResponseUsage(completion),
+        });
         return completion.output_parsed;
     }
     catch (error) {
-        logger.error('Failed to generate inference response', { error });
+        await logInferenceUsage({
+            model,
+            operation,
+            success: false,
+            estimatedInputTokens,
+            reason,
+            metadata: options?.metadata,
+            error,
+        });
+        logger.error('Failed to generate inference response', {
+            error,
+            reason,
+            model,
+            operation,
+            metadata: options?.metadata,
+        });
         throw error;
     }
 }
@@ -157,15 +246,14 @@ export async function getAvailableModels() {
     }
     catch (error) {
         logger.error('Failed to fetch inference models', { error });
-        return ['command-r-plus', 'command-r', 'command-light']; // Fallback Cohere models
+        return ['command-r-plus', 'command-r', 'command-light'];
     }
 }
 /**
  * Estimate token count for a message (rough approximation)
  */
 export function estimateTokenCount(text) {
-    // Rough approximation: 1 token ≈ 4 characters for English text
     return Math.ceil(text.length / 4);
 }
 //# sourceMappingURL=inference.js.map
-//# debugId=29f2563b-5001-5af3-9bfe-191889a55b09
+//# debugId=4274513f-5640-53ae-a6ca-567fff3e8bee

package/dist/utils/inference.js.map

@@ -1 +1 @@
-{"version":3,"file":"inference.js","sources":["utils/inference.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Inference util – OpenAI client, inference() for structured output, sendAIMessage for chat.\n */\nimport OpenAI from 'openai';\nimport { logger } from './logger.js';\nimport { prisma } from '../lib/prisma.js';\nimport { chatChannel, pusher } from '../lib/pusher.js';\nimport { ensureAIUserExists, getAIUserId } from './aiUser.js';\nimport { env } from '../lib/config/env.js';\nimport { ZodSchema } from 'zod';\nimport { zodTextFormat } from \"openai/helpers/zod\";\n\n\n\nexport const inferenceClient = new OpenAI({\n  apiKey: env.INFERENCE_API_KEY,\n  baseURL: env.INFERENCE_API_BASE_URL,\n});\n\nexport const openAIClient = new OpenAI();\n\n// Types for lab chat context\nexport interface LabChatContext {\n  subject: string;\n  topic: string;\n  difficulty: 'beginner' | 'intermediate' | 'advanced';\n  objectives: string[];\n  resources?: string[];\n  persona: string;\n  constraints: string[];\n  examples?: any[];\n  metadata?: Record<string, any>;\n}\n\nexport interface InferenceResponse {\n  content: string;\n  model: string;\n  tokensUsed: number;\n  finishReason: string;\n}\n\n/**\n * Centralized function to send AI messages to conversations\n * Handles database storage and Pusher broadcasting\n */\nexport async function sendAIMessage(\n  content: string,\n  conversationId: string,\n  options: {\n    subject?: string;\n    attachments?: {\n      connect: { id: string }[];\n    };\n    meta?: Record<string, any>;\n    customSender?: {\n      displayName: string;\n      profilePicture?: string | null;\n    };\n  } = {}\n): Promise<{\n  id: string;\n  content: string;\n  senderId: string;\n  conversationId: string;\n  createdAt: Date;\n  meta?: Record<string, any>;\n}> {\n  // Ensure AI user exists\n  await ensureAIUserExists();\n\n  // Create message in database\n  const aiMessage = await prisma.message.create({\n    data: {\n      content,\n      senderId: getAIUserId(),\n      conversationId,\n      ...(options.attachments && {\n        attachments: {\n          connect: options.attachments.connect,\n        },\n      }),\n      ...(options.meta && {\n        meta: options.meta,\n      }),\n    },\n    include: {\n      attachments: true,\n    },\n  });\n\n  logger.info('AI Message sent', {\n    messageId: aiMessage.id,\n    conversationId,\n    contentLength: content.length,\n  });\n\n  // Prepare sender info\n  const senderInfo = {\n    id: getAIUserId(),\n    username: 'Newton_AI',\n    profile: {\n      displayName: \"Newton AI\",\n      profilePicture: options.customSender?.profilePicture || null,\n    },\n  };\n\n  // Broadcast via Pusher\n  try {\n    await pusher.trigger(chatChannel(conversationId), 'new-message', {\n      id: aiMessage.id,\n      content: aiMessage.content,\n      senderId: getAIUserId(),\n      conversationId: aiMessage.conversationId,\n      createdAt: aiMessage.createdAt,\n      sender: senderInfo,\n      mentionedUserIds: [],\n      meta: aiMessage.meta,\n      attachments: aiMessage.attachments.map(attachment => ({\n        id: attachment.id,\n        attachmentId: attachment.id,\n        name: attachment.name,\n        type: attachment.type,\n        size: attachment.size,\n        path: attachment.path,\n      })),\n    });\n  } catch (error) {\n    logger.error('Failed to broadcast AI message:', { error, messageId: aiMessage.id });\n  }\n\n  return {\n    id: aiMessage.id,\n    content: aiMessage.content,\n    senderId: getAIUserId(),\n    conversationId: aiMessage.conversationId,\n    createdAt: aiMessage.createdAt,\n    meta: aiMessage.meta as Record<string, any>,\n  };\n}\n\nexport async function inference<T>(\n  content: string | OpenAI.Chat.Completions.ChatCompletionMessageParam[],\n  format?: ZodSchema\n): Promise<T> {\n  try {\n\n    if (!format) {\n      const completion = await openAIClient.chat.completions.create({\n        model: 'gpt-5-nano',\n        messages: typeof content === 'string' ? [\n          {\n            role: 'user',\n            content: content,\n          },\n        ] : content as Array<{ role: 'user' | 'assistant' | 'system'; content: string }>,\n      });\n\n      return completion.choices[0]?.message?.content as T;\n    }\n\n    const completion = await openAIClient.responses.parse({\n      model: 'gpt-5-nano',\n      input: typeof content === 'string' ? [\n        {\n          role: 'user',\n          content: content,\n        },\n      ] : content as Array<{ role: 'user' | 'assistant' | 'system'; content: string }>,\n      ...(format ? { text: {\n          format: zodTextFormat(format, \"newton_response_format\"),\n        },\n      } : {}),\n    });\n\n    console.log({\n      model: 'gpt-5-nano',\n      input: typeof content === 'string' ? [\n        {\n          role: 'user',\n          content: content,\n        },\n      ] : content as Array<{ role: 'user' | 'assistant' | 'system'; content: string }>,\n      ...(format ? { text: {\n          format: zodTextFormat(format, \"newton_response_format\"),\n        },\n      } : {}),\n    });\n\n\n    if (!completion) {\n      throw new Error('No response generated from inference API');\n    }\n\n    // if (format) {\n    //   if (typeof completion.output === 'string') {\n    //     return JSON.parse(completion.output);\n    //   }\n    //   return JSON.parse(completion.output);\n    // }\n\n    return completion.output_parsed;\n  } catch (error) {\n    logger.error('Failed to generate inference response', { error });\n    throw error;\n  }\n}\n\n/**\n * Get available inference models (for admin/config purposes)\n */\nexport async function getAvailableModels(): Promise<string[]> {\n  try {\n    const models = await inferenceClient.models.list();\n    return models.data\n      .filter(model => model.id.includes('command'))\n      .map(model => model.id)\n      .sort();\n  } catch (error) {\n    logger.error('Failed to fetch inference models', { error });\n    return ['command-r-plus', 'command-r', 'command-light']; // Fallback Cohere models\n  }\n}\n\n/**\n * Estimate token count for a message (rough approximation)\n */\nexport function estimateTokenCount(text: string): number {\n  // Rough approximation: 1 token ≈ 4 characters for English text\n  return Math.ceil(text.length / 4);\n}"],"names":[],"mappings":"AAAA;;GAEG;;;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC;AAE3C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAInD,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,MAAM,CAAC;IACxC,MAAM,EAAE,GAAG,CAAC,iBAAiB;IAC7B,OAAO,EAAE,GAAG,CAAC,sBAAsB;CACpC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,MAAM,EAAE,CAAC;AAsBzC;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,OAAe,EACf,cAAsB,EACtB,UAUI,EAAE;IASN,wBAAwB;IACxB,MAAM,kBAAkB,EAAE,CAAC;IAE3B,6BAA6B;IAC7B,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC5C,IAAI,EAAE;YACJ,OAAO;YACP,QAAQ,EAAE,WAAW,EAAE;YACvB,cAAc;YACd,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI;gBACzB,WAAW,EAAE;oBACX,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO;iBACrC;aACF,CAAC;YACF,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;aACnB,CAAC;SACH;QACD,OAAO,EAAE;YACP,WAAW,EAAE,IAAI;SAClB;KACF,CAAC,CAAC;IAEH,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE;QAC7B,SAAS,EAAE,SAAS,CAAC,EAAE;QACvB,cAAc;QACd,aAAa,EAAE,OAAO,CAAC,MAAM;KAC9B,CAAC,CAAC;IAEH,sBAAsB;IACtB,MAAM,UAAU,GAAG;QACjB,EAAE,EAAE,WAAW,EAAE;QACjB,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE;YACP,WAAW,EAAE,WAAW;YACxB,cAAc,EAAE,OAAO,CAAC,YAAY,EAAE,cAAc,IAAI,IAAI;SAC7D;KACF,CAAC;IAEF,uBAAuB;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,EAAE,aAAa,EAAE;YAC/D,EAAE,EAAE,SAAS,CAAC,EAAE;YAChB,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,QAAQ,EAAE,WAAW,EAAE;YACvB,cAAc,EAAE,SAAS,CAAC,cAAc;YACxC,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,MAAM,EAAE,UAAU;YAClB,gBAAgB,EAAE,EAAE;YACpB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;gBACpD,EAAE,EAAE,UAAU,CAAC,EAAE;gBACjB,YAAY,EAAE,UAAU,CAAC,EAAE;gBAC3B,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;gBACrB,IAAI,EAAE,UAAU,CAAC,IAAI;aACtB,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,OAAO;QACL,EAAE,EAAE,SAAS,CAAC,EAAE;QAChB,OAAO,EAAE,SAAS,CAAC,OAAO;QAC1B,QAAQ,EAAE,WAAW,EAAE;QACvB,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,IAAI,EAAE,SAAS,CAAC,IAA2B;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,OAAsE,EACtE,MAAkB;IAElB,IAAI,CAAC;QAEH,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;gBAC5D,KAAK,EAAE,YAAY;gBACnB,QAAQ,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC;oBACtC;wBACE,IAAI,EAAE,MAAM;wBACZ,OAAO,EAAE,OAAO;qBACjB;iBACF,CAAC,CAAC,CAAC,OAA4E;aACjF,CAAC,CAAC;YAEH,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAY,CAAC;QACtD,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC;YACpD,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACnC;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,OAAO;iBACjB;aACF,CAAC,CAAC,CAAC,OAA4E;YAChF,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;oBACjB,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,wBAAwB,CAAC;iBACxD;aACF,CAAC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC;YACV,KAAK,EAAE,YAAY;YACnB,KAAK,EAAE,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACnC;oBACE,IAAI,EAAE,MAAM;oBACZ,OAAO,EAAE,OAAO;iBACjB;aACF,CAAC,CAAC,CAAC,OAA4E;YAChF,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE;oBACjB,MAAM,EAAE,aAAa,CAAC,MAAM,EAAE,wBAAwB,CAAC;iBACxD;aACF,CAAC,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QAGH,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC9D,CAAC;QAED,gBAAgB;QAChB,iDAAiD;QACjD,4CAA4C;QAC5C,MAAM;QACN,0CAA0C;QAC1C,IAAI;QAEJ,OAAO,UAAU,CAAC,aAAa,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACjE,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,MAAM,CAAC,IAAI;aACf,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;aAC7C,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC;aACtB,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC5D,OAAO,CAAC,gBAAgB,EAAE,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,yBAAyB;IACpF,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,+DAA+D;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC","debug_id":"29f2563b-5001-5af3-9bfe-191889a55b09"}
+{"version":3,"file":"inference.js","sources":["utils/inference.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Inference util – OpenAI client, inference() for structured output, sendAIMessage for chat.\n */\nimport OpenAI from 'openai';\nimport { logger } from './logger.js';\nimport { prisma } from '../lib/prisma.js';\nimport { chatChannel, pusher } from '../lib/pusher.js';\nimport { ensureAIUserExists, getAIUserId } from './aiUser.js';\nimport { env } from '../lib/config/env.js';\nimport { Prisma } from '@prisma/client';\nimport { ZodSchema } from 'zod';\nimport { zodTextFormat } from 'openai/helpers/zod';\n\nexport const inferenceClient = new OpenAI({\n  apiKey: env.INFERENCE_API_KEY,\n  baseURL: env.INFERENCE_API_BASE_URL,\n});\n\nexport const openAIClient = new OpenAI();\n\nconst DEFAULT_INFERENCE_MODEL = 'gpt-5-nano';\n\ntype InferenceMessage = {\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n};\n\nexport interface InferenceOptions {\n  reason?: string;\n  metadata?: Prisma.InputJsonValue;\n  model?: string;\n  temperature?: number;\n  maxTokens?: number;\n}\n\ninterface InferenceUsage {\n  promptTokens?: number;\n  completionTokens?: number;\n  totalTokens?: number;\n}\n\ninterface InferenceAuditLog {\n  model: string;\n  operation: 'chat.completions' | 'responses.parse';\n  success: boolean;\n  estimatedInputTokens: number;\n  reason: string;\n  metadata?: Prisma.InputJsonValue;\n  usage?: InferenceUsage;\n  error?: unknown;\n}\n\n// Types for lab chat context\nexport interface LabChatContext {\n  subject: string;\n  topic: string;\n  difficulty: 'beginner' | 'intermediate' | 'advanced';\n  objectives: string[];\n  resources?: string[];\n  persona: string;\n  constraints: string[];\n  examples?: any[];\n  metadata?: Record<string, any>;\n}\n\nexport interface InferenceResponse {\n  content: string;\n  model: string;\n  tokensUsed: number;\n  finishReason: string;\n}\n\nfunction normalizeInferenceInput(\n  content: string | OpenAI.Chat.Completions.ChatCompletionMessageParam[],\n): InferenceMessage[] {\n  if (typeof content === 'string') {\n    return [{ role: 'user', content }];\n  }\n\n  return content.map((message) => ({\n    role: message.role as InferenceMessage['role'],\n    content: typeof message.content === 'string' ? message.content : JSON.stringify(message.content),\n  }));\n}\n\nfunction getInferenceReason(options?: InferenceOptions) {\n  return options?.reason?.trim() || 'unspecified';\n}\n\nfunction serializeInferenceError(error: unknown) {\n  if (error instanceof Error) {\n    return error.message;\n  }\n\n  if (typeof error === 'string') {\n    return error;\n  }\n\n  try {\n    return JSON.stringify(error);\n  } catch {\n    return 'Unknown inference error';\n  }\n}\n\nasync function logInferenceUsage({\n  model,\n  operation,\n  success,\n  estimatedInputTokens,\n  reason,\n  metadata,\n  usage,\n  error,\n}: InferenceAuditLog) {\n  const context = {\n    reason,\n    model,\n    operation,\n    success,\n    estimatedInputTokens,\n    promptTokens: usage?.promptTokens,\n    completionTokens: usage?.completionTokens,\n    totalTokens: usage?.totalTokens,\n    metadata,\n    ...(error ? { error: serializeInferenceError(error) } : {}),\n  };\n\n  try {\n    await prisma.aiUsageLog.create({\n      data: {\n        reason,\n        model,\n        operation,\n        success,\n        estimatedInputTokens,\n        promptTokens: usage?.promptTokens,\n        completionTokens: usage?.completionTokens,\n        totalTokens: usage?.totalTokens,\n        ...(metadata !== undefined ? { metadata } : {}),\n        ...(error ? { error: serializeInferenceError(error) } : {}),\n      },\n    });\n  } catch (loggingError) {\n    logger.error('Failed to persist AI usage log', {\n      ...context,\n      loggingError: serializeInferenceError(loggingError),\n    });\n    return;\n  }\n\n  logger.info('AI usage logged', context);\n}\n\nfunction getChatCompletionUsage(completion: {\n  usage?: {\n    prompt_tokens?: number;\n    completion_tokens?: number;\n    total_tokens?: number;\n  };\n}): InferenceUsage {\n  return {\n    promptTokens: completion.usage?.prompt_tokens,\n    completionTokens: completion.usage?.completion_tokens,\n    totalTokens: completion.usage?.total_tokens,\n  };\n}\n\nfunction getResponseUsage(completion: {\n  usage?: {\n    input_tokens?: number;\n    output_tokens?: number;\n    total_tokens?: number;\n  };\n}): InferenceUsage {\n  return {\n    promptTokens: completion.usage?.input_tokens,\n    completionTokens: completion.usage?.output_tokens,\n    totalTokens: completion.usage?.total_tokens,\n  };\n}\n\n/**\n * Centralized function to send AI messages to conversations\n * Handles database storage and Pusher broadcasting\n */\nexport async function sendAIMessage(\n  content: string,\n  conversationId: string,\n  options: {\n    subject?: string;\n    attachments?: {\n      connect: { id: string }[];\n    };\n    meta?: Record<string, any>;\n    customSender?: {\n      displayName: string;\n      profilePicture?: string | null;\n    };\n  } = {}\n): Promise<{\n  id: string;\n  content: string;\n  senderId: string;\n  conversationId: string;\n  createdAt: Date;\n  meta?: Record<string, any>;\n}> {\n  await ensureAIUserExists();\n\n  const aiMessage = await prisma.message.create({\n    data: {\n      content,\n      senderId: getAIUserId(),\n      conversationId,\n      ...(options.attachments && {\n        attachments: {\n          connect: options.attachments.connect,\n        },\n      }),\n      ...(options.meta && {\n        meta: options.meta,\n      }),\n    },\n    include: {\n      attachments: true,\n    },\n  });\n\n  logger.info('AI Message sent', {\n    messageId: aiMessage.id,\n    conversationId,\n    contentLength: content.length,\n  });\n\n  const senderInfo = {\n    id: getAIUserId(),\n    username: 'Newton_AI',\n    profile: {\n      displayName: 'Newton AI',\n      profilePicture: options.customSender?.profilePicture || null,\n    },\n  };\n\n  try {\n    await pusher.trigger(chatChannel(conversationId), 'new-message', {\n      id: aiMessage.id,\n      content: aiMessage.content,\n      senderId: getAIUserId(),\n      conversationId: aiMessage.conversationId,\n      createdAt: aiMessage.createdAt,\n      sender: senderInfo,\n      mentionedUserIds: [],\n      meta: aiMessage.meta,\n      attachments: aiMessage.attachments.map((attachment) => ({\n        id: attachment.id,\n        attachmentId: attachment.id,\n        name: attachment.name,\n        type: attachment.type,\n        size: attachment.size,\n        path: attachment.path,\n      })),\n    });\n  } catch (error) {\n    logger.error('Failed to broadcast AI message:', { error, messageId: aiMessage.id });\n  }\n\n  return {\n    id: aiMessage.id,\n    content: aiMessage.content,\n    senderId: getAIUserId(),\n    conversationId: aiMessage.conversationId,\n    createdAt: aiMessage.createdAt,\n    meta: aiMessage.meta as Record<string, any>,\n  };\n}\n\nexport async function inference<T>(\n  content: string | OpenAI.Chat.Completions.ChatCompletionMessageParam[],\n  format?: ZodSchema,\n  options?: InferenceOptions,\n): Promise<T> {\n  const input = normalizeInferenceInput(content);\n  const reason = getInferenceReason(options);\n  const model = options?.model ?? DEFAULT_INFERENCE_MODEL;\n  const estimatedInputTokens = input.reduce(\n    (total, message) => total + estimateTokenCount(message.content),\n    0,\n  );\n  const operation = format ? 'responses.parse' : 'chat.completions';\n\n  try {\n    if (!format) {\n      const completion = await openAIClient.chat.completions.create({\n        model,\n        messages: input,\n        ...(options?.temperature !== undefined\n          ? { temperature: options.temperature }\n          : {}),\n        ...(options?.maxTokens !== undefined\n          ? { max_tokens: options.maxTokens }\n          : {}),\n      });\n\n      await logInferenceUsage({\n        model,\n        operation,\n        success: true,\n        estimatedInputTokens,\n        reason,\n        metadata: options?.metadata,\n        usage: getChatCompletionUsage(completion),\n      });\n\n      return completion.choices[0]?.message?.content as T;\n    }\n\n    const completion = await openAIClient.responses.parse({\n      model,\n      input,\n      text: {\n        format: zodTextFormat(format, 'newton_response_format'),\n      },\n    });\n\n    if (!completion) {\n      throw new Error('No response generated from inference API');\n    }\n\n    await logInferenceUsage({\n      model,\n      operation,\n      success: true,\n      estimatedInputTokens,\n      reason,\n      metadata: options?.metadata,\n      usage: getResponseUsage(completion),\n    });\n\n    return completion.output_parsed as T;\n  } catch (error) {\n    await logInferenceUsage({\n      model,\n      operation,\n      success: false,\n      estimatedInputTokens,\n      reason,\n      metadata: options?.metadata,\n      error,\n    });\n\n    logger.error('Failed to generate inference response', {\n      error,\n      reason,\n      model,\n      operation,\n      metadata: options?.metadata,\n    });\n    throw error;\n  }\n}\n\n/**\n * Get available inference models (for admin/config purposes)\n */\nexport async function getAvailableModels(): Promise<string[]> {\n  try {\n    const models = await inferenceClient.models.list();\n    return models.data\n      .filter(model => model.id.includes('command'))\n      .map(model => model.id)\n      .sort();\n  } catch (error) {\n    logger.error('Failed to fetch inference models', { error });\n    return ['command-r-plus', 'command-r', 'command-light'];\n  }\n}\n\n/**\n * Estimate token count for a message (rough approximation)\n */\nexport function estimateTokenCount(text: string): number {\n  return Math.ceil(text.length / 4);\n}\n"],"names":[],"mappings":"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","debug_id":"4274513f-5640-53ae-a6ca-567fff3e8bee"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@studious-lms/server",
-  "version": "1.4.2",
+  "version": "1.4.3",
   "description": "Backend server for Studious application",
   "main": "dist/exportType.js",
   "types": "dist/exportType.d.ts",

package/prisma/migrations/20260415103500_add_session_type/migration.sql

@@ -0,0 +1,33 @@
+-- CreateEnum
+CREATE TYPE "SessionType" AS ENUM ('AUTH', 'EMAIL_VERIFICATION', 'PASSWORD_RESET', 'CLASS_INVITE');
+
+-- AlterTable
+ALTER TABLE "Session"
+  ADD COLUMN "type" "SessionType" NOT NULL DEFAULT 'AUTH';
+
+-- Backfill existing non-auth session records when they can be inferred safely.
+UPDATE "Session"
+SET "type" = 'CLASS_INVITE'
+WHERE "classId" IS NOT NULL;
+
+-- This Session.type backfill uses the expiresAt <= NOW() + INTERVAL '2 hours'
+-- heuristic to identify password reset tokens. It may misclassify rare short-lived
+-- AUTH sessions, but this one-time migration safely fails those sessions until users re-login.
+UPDATE "Session"
+SET "type" = 'PASSWORD_RESET'
+WHERE "userId" IS NOT NULL
+  AND "classId" IS NULL
+  AND "expiresAt" IS NOT NULL
+  AND "expiresAt" <= NOW() + INTERVAL '2 hours';
+
+UPDATE "Session"
+SET "type" = 'EMAIL_VERIFICATION'
+WHERE "userId" IS NOT NULL
+  AND "classId" IS NULL
+  AND "type" = 'AUTH'
+  AND EXISTS (
+    SELECT 1
+    FROM "User"
+    WHERE "User"."id" = "Session"."userId"
+      AND "User"."verified" = false
+  );

package/prisma/migrations/20260415133000_add_ai_usage_logs/migration.sql

@@ -0,0 +1,19 @@
+CREATE TABLE "AiUsageLog" (
+    "id" TEXT NOT NULL,
+    "reason" TEXT NOT NULL,
+    "provider" TEXT NOT NULL DEFAULT 'openai',
+    "model" TEXT NOT NULL,
+    "operation" TEXT NOT NULL,
+    "success" BOOLEAN NOT NULL DEFAULT true,
+    "promptTokens" INTEGER,
+    "completionTokens" INTEGER,
+    "totalTokens" INTEGER,
+    "estimatedInputTokens" INTEGER,
+    "metadata" JSONB DEFAULT '{}'::jsonb,
+    "error" TEXT,
+    "createdAt" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
+
+    CONSTRAINT "AiUsageLog_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "AiUsageLog_reason_createdAt_idx" ON "AiUsageLog"("reason", "createdAt");

package/prisma/schema.prisma

@@ -406,10 +406,18 @@ model Section {
   order Int?
 }
 
+enum SessionType {
+  AUTH
+  EMAIL_VERIFICATION
+  PASSWORD_RESET
+  CLASS_INVITE
+}
+
 model Session {
   id        String @id @default(uuid())
   createdAt DateTime? @default(now())
   expiresAt DateTime?
+  type      SessionType @default(AUTH)
   userId    String?
   user      User? @relation(fields: [userId], references: [id], onDelete: NoAction)
   classId   String?
@@ -528,6 +536,24 @@ model Message {
   meta Json? @default("{}")
 }
 
+model AiUsageLog {
+  id                  String   @id @default(uuid())
+  reason              String
+  provider            String   @default("openai")
+  model               String
+  operation           String
+  success             Boolean  @default(true)
+  promptTokens        Int?
+  completionTokens    Int?
+  totalTokens         Int?
+  estimatedInputTokens Int?
+  metadata            Json?    @default("{}")
+  error               String?
+  createdAt           DateTime @default(now())
+
+  @@index([reason, createdAt])
+}
+
 model Mention {
   id String @id @default(uuid())
   messageId String
@@ -635,4 +661,4 @@ model EarlyAccessRequest {
   email String
   createdAt DateTime @default(now())
   institutionSize String
-}
+}

package/scripts/test-pre-push.ts

@@ -7,8 +7,12 @@ dotenv.config({ path: resolve(process.cwd(), '.env.test') });
 
 logger.info("Syncing Prisma schema to test database...");
 
-execSync("npx prisma db push --force-reset --skip-generate", {
+if (process.env.DATABASE_URL?.includes("supabase")) {
+  logger.error("Supabase is not supported for test database, please don't clear the production database");
+  process.exit(1);
+}
+else execSync("npx prisma db push --force-reset --skip-generate", {
   stdio: 'inherit',
 });
 
-logger.info("Test database is ready!");
+logger.info("Test database run has completed");