@goscribe/server 1.3.0 → 1.3.1

package/dist/lib/ai-session.d.ts

@@ -25,8 +25,13 @@ export declare class AISessionService {
     initSession(workspaceId: string, user: string): Promise<AISession>;
     processFile(sessionId: string, user: string, fileUrl: string, fileType: 'image' | 'pdf', maxPages?: number): Promise<ProcessFileResult>;
     generateStudyGuide(sessionId: string, user: string): Promise<string>;
-    generateFlashcardQuestions(sessionId: string, user: string, numQuestions: number, difficulty: 'easy' | 'medium' | 'hard'): Promise<string>;
-    generateWorksheetQuestions(sessionId: string, user: string, numQuestions: number, difficulty: 'EASY' | 'MEDIUM' | 'HARD'): Promise<string>;
+    generateFlashcardQuestions(sessionId: string, user: string, numQuestions: number, difficulty: 'easy' | 'medium' | 'hard', prompt?: string): Promise<string>;
+    generateWorksheetQuestions(sessionId: string, user: string, numQuestions: number, difficulty: 'EASY' | 'MEDIUM' | 'HARD', options?: {
+        mode?: 'practice' | 'quiz';
+        mcqRatio?: number;
+        questionTypes?: string[];
+        prompt?: string;
+    }): Promise<string>;
     checkWorksheetQuestions(sessionId: string, user: string, question: string, answer: string, mark_scheme: MarkScheme): Promise<UserMarkScheme>;
     generatePodcastStructure(sessionId: string, user: string, title: string, description: string, prompt: string, speakers: Array<{
         id: string;
@@ -39,6 +44,14 @@ export declare class AISessionService {
         name?: string;
     }>, voiceId?: string): Promise<any>;
     generatePodcastImage(sessionId: string, user: string, summary: string): Promise<string>;
+    segmentStudyGuide(sessionId: string, user: string, studyGuide: string): Promise<{
+        hint: string;
+        content: string;
+    }[]>;
+    validateSegmentSummary(sessionId: string, user: string, segmentContent: string, studentResponse: string, studyGuide: string): Promise<{
+        valid: boolean;
+        feedback: string;
+    }>;
     getSession(sessionId: string): AISession | undefined;
     getSessionsByUserAndWorkspace(userId: string, workspaceId: string): AISession[];
     deleteSession(sessionId: string): boolean;

package/dist/lib/ai-session.js

@@ -1,12 +1,13 @@
 import { TRPCError } from '@trpc/server';
 import { logger } from './logger.js';
+import { withRetry } from './retry.js';
 // External AI service configuration
 // const AI_SERVICE_URL = 'https://7gzvf7uib04yp9-61016.proxy.runpod.net/upload';
 // const AI_RESPONSE_URL = 'https://7gzvf7uib04yp9-61016.proxy.runpod.net/last_response';
 const AI_SERVICE_URL = process.env.INFERENCE_API_URL + '/upload';
 const AI_RESPONSE_URL = process.env.INFERENCE_API_URL + '/last_response';
-console.log('AI_SERVICE_URL', AI_SERVICE_URL);
-console.log('AI_RESPONSE_URL', AI_RESPONSE_URL);
+logger.info(`AI_SERVICE_URL: ${AI_SERVICE_URL}`);
+logger.info(`AI_RESPONSE_URL: ${AI_RESPONSE_URL}`);
 // Mock mode flag - when true, returns fake responses instead of calling AI service
 const MOCK_MODE = process.env.DONT_TEST_INFERENCE === 'true';
 const IMITATE_WAIT_TIME_MS = MOCK_MODE ? 1000 * 10 : 0;
@@ -20,7 +21,7 @@ export class AISessionService {
         await new Promise(resolve => setTimeout(resolve, IMITATE_WAIT_TIME_MS));
         // Mock mode - return fake session
         if (MOCK_MODE) {
-            console.log(`🎭 MOCK MODE: Initializing AI session for workspace ${workspaceId}`);
+            logger.info(`MOCK MODE: Initializing AI session for workspace ${workspaceId}`);
             const session = {
                 id: sessionId,
                 workspaceId,
@@ -41,19 +42,19 @@ export class AISessionService {
         let lastError = null;
         for (let attempt = 1; attempt <= maxRetries; attempt++) {
             try {
-                console.log(`🤖 AI Session init attempt ${attempt}/${maxRetries} for workspace ${workspaceId}`);
+                logger.info(`AI Session init attempt ${attempt}/${maxRetries} for workspace ${workspaceId}`);
                 const response = await fetch(AI_SERVICE_URL, {
                     method: 'POST',
                     body: formData,
                 });
-                console.log(`📡 AI Service response status: ${response.status} ${response.statusText}`);
+                logger.info(`AI Service response status: ${response.status} ${response.statusText}`);
                 if (!response.ok) {
                     const errorText = await response.text();
-                    console.error(`❌ AI Service error response:`, errorText);
+                    logger.error(`AI Service error response: ${errorText}`);
                     throw new Error(`AI service error: ${response.status} ${response.statusText} - ${errorText}`);
                 }
                 const result = await response.json();
-                console.log(`📋 AI Service result:`, result);
+                logger.debug(`AI Service result: ${JSON.stringify(result)}`);
                 // If we get a response with a message, consider it successful
                 if (!result.message) {
                     throw new Error(`AI service error: No response message`);
@@ -67,20 +68,20 @@ export class AISessionService {
                     updatedAt: new Date(),
                 };
                 this.sessions.set(sessionId, session);
-                console.log(`✅ AI Session initialized successfully on attempt ${attempt}`);
+                logger.info(`AI Session initialized successfully on attempt ${attempt}`);
                 return session;
             }
             catch (error) {
                 lastError = error instanceof Error ? error : new Error('Unknown error');
-                console.error(`❌ AI Session init attempt ${attempt} failed:`, lastError.message);
+                logger.error(`AI Session init attempt ${attempt} failed: ${lastError.message}`);
                 if (attempt < maxRetries) {
                     const delay = Math.pow(2, attempt) * 1000; // Exponential backoff: 2s, 4s, 8s
-                    console.log(`⏳ Retrying in ${delay}ms...`);
+                    logger.info(`Retrying in ${delay}ms...`);
                     await new Promise(resolve => setTimeout(resolve, delay));
                 }
             }
         }
-        console.error(`💥 All ${maxRetries} attempts failed. Last error:`, lastError?.message);
+        logger.error(`All ${maxRetries} attempts failed. Last error: ${lastError?.message}`);
         throw new TRPCError({
             code: 'INTERNAL_SERVER_ERROR',
             message: `Failed to initialize AI session after ${maxRetries} attempts: ${lastError?.message || 'Unknown error'}`,
@@ -112,7 +113,7 @@ export class AISessionService {
         if (maxPages) {
             formData.append('maxPages', maxPages.toString());
         }
-        console.log('formData', formData);
+        logger.debug('Processing file with formData');
         // Retry logic for file processing
         const maxRetries = 3;
         let lastError = null;
@@ -125,7 +126,7 @@ export class AISessionService {
                 const response = await fetch(AI_SERVICE_URL, {
                     method: 'POST',
                     body: formData,
-                    // signal: controller.signal,
+                    signal: controller.signal,
                 });
                 clearTimeout(timeoutId);
                 if (!response.ok) {
@@ -165,7 +166,7 @@ export class AISessionService {
         await new Promise(resolve => setTimeout(resolve, IMITATE_WAIT_TIME_MS));
         // Mock mode - return fake study guide
         if (MOCK_MODE) {
-            console.log(`🎭 MOCK MODE: Generating study guide for session ${sessionId}`);
+            logger.info(`MOCK MODE: Generating study guide for session ${sessionId}`);
             return `# Mock Study Guide
 
 ## Overview
@@ -186,30 +187,27 @@ This mock study guide demonstrates the structure and format that would be genera
 
 *Note: This is a mock response generated when DONT_TEST_INFERENCE=true*`;
         }
-        const formData = new FormData();
-        formData.append('command', 'generate_study_guide');
-        formData.append('session', sessionId);
-        formData.append('user', user);
-        try {
+        return withRetry(async () => {
+            const formData = new FormData();
+            formData.append('command', 'generate_study_guide');
+            formData.append('session', sessionId);
+            formData.append('user', user);
             const response = await fetch(AI_SERVICE_URL, {
                 method: 'POST',
                 body: formData,
             });
             if (!response.ok) {
-                throw new Error(`AI service error: ${response.status} ${response.statusText}`);
+                const errorBody = await response.text().catch(() => '');
+                throw new Error(`AI service error: ${response.status} ${response.statusText} - ${errorBody}`);
             }
             const result = await response.json();
+            if (!result.markdown) {
+                throw new Error('AI service returned empty study guide');
+            }
             return result.markdown;
-        }
-        catch (error) {
-            throw new TRPCError({
-                code: 'INTERNAL_SERVER_ERROR',
-                message: `Failed to generate study guide: ${error instanceof Error ? error.message : 'Unknown error'}`,
-            });
-        }
+        }, { maxRetries: 3, timeoutMs: 300000, label: 'generateStudyGuide' });
     }
-    // Generate flashcard questions
-    async generateFlashcardQuestions(sessionId, user, numQuestions, difficulty) {
+    async generateFlashcardQuestions(sessionId, user, numQuestions, difficulty, prompt) {
         await new Promise(resolve => setTimeout(resolve, IMITATE_WAIT_TIME_MS));
         // Mock mode - return fake flashcard questions
         if (MOCK_MODE) {
@@ -222,13 +220,16 @@ This mock study guide demonstrates the structure and format that would be genera
                 category: `Mock Category ${(i % 3) + 1}`
             })));
         }
-        const formData = new FormData();
-        formData.append('command', 'generate_flashcard_questions');
-        formData.append('session', sessionId);
-        formData.append('user', user);
-        formData.append('num_questions', numQuestions.toString());
-        formData.append('difficulty', difficulty);
-        try {
+        return withRetry(async () => {
+            const formData = new FormData();
+            formData.append('command', 'generate_flashcard_questions');
+            formData.append('session', sessionId);
+            formData.append('user', user);
+            formData.append('num_questions', numQuestions.toString());
+            formData.append('difficulty', difficulty);
+            if (prompt) {
+                formData.append('prompt', prompt);
+            }
             const response = await fetch(AI_SERVICE_URL, {
                 method: 'POST',
                 body: formData,
@@ -237,52 +238,59 @@ This mock study guide demonstrates the structure and format that would be genera
                 throw new Error(`AI service error: ${response.status} ${response.statusText}`);
             }
             const result = await response.json();
-            console.log(JSON.parse(result.flashcards));
             return JSON.parse(result.flashcards).flashcards;
-        }
-        catch (error) {
-            throw new TRPCError({
-                code: 'INTERNAL_SERVER_ERROR',
-                message: `Failed to generate flashcard questions: ${error instanceof Error ? error.message : 'Unknown error'}`,
-            });
-        }
+        }, { maxRetries: 3, timeoutMs: 300000, label: 'generateFlashcardQuestions' });
     }
     // Generate worksheet questions
-    async generateWorksheetQuestions(sessionId, user, numQuestions, difficulty) {
+    async generateWorksheetQuestions(sessionId, user, numQuestions, difficulty, options) {
         await new Promise(resolve => setTimeout(resolve, IMITATE_WAIT_TIME_MS));
         // Mock mode - return fake worksheet questions
         if (MOCK_MODE) {
             logger.info(`🎭 MOCK MODE: Generating ${numQuestions} ${difficulty} worksheet questions for session ${sessionId}`);
+            const mode = options?.mode ?? 'practice';
+            const isQuiz = mode === 'quiz';
             return JSON.stringify({
-                worksheet: {
-                    title: `Mock Worksheet - ${difficulty} Level`,
-                    questions: Array.from({ length: numQuestions }, (_, i) => ({
-                        id: `mock-worksheet-q${i + 1}`,
-                        question: `Mock worksheet question ${i + 1}: Based on the uploaded material, explain the key concept and provide examples.`,
-                        type: i % 2 === 0 ? 'short_answer' : 'essay',
-                        difficulty: difficulty,
-                        estimatedTime: difficulty === 'EASY' ? '2-3 minutes' : difficulty === 'MEDIUM' ? '5-7 minutes' : '10-15 minutes',
-                        points: difficulty === 'EASY' ? 5 : difficulty === 'MEDIUM' ? 10 : 15
-                    })),
-                    instructions: "This is a mock worksheet generated for testing purposes. Answer all questions based on the uploaded materials.",
-                    totalPoints: numQuestions * (difficulty === 'EASY' ? 5 : difficulty === 'MEDIUM' ? 10 : 15),
-                    estimatedTime: `${numQuestions * (difficulty === 'EASY' ? 3 : difficulty === 'MEDIUM' ? 6 : 12)} minutes`
-                },
-                metadata: {
-                    totalQuestions: numQuestions,
-                    difficulty: difficulty,
-                    generatedAt: new Date().toISOString(),
-                    isMock: true
-                }
+                title: isQuiz ? `Mock Quiz - ${difficulty}` : `Mock Worksheet - ${difficulty} Level`,
+                description: 'Mock generated content',
+                difficulty,
+                estimatedTime: `${numQuestions * 2} min`,
+                problems: Array.from({ length: numQuestions }, (_, i) => {
+                    if (isQuiz) {
+                        return {
+                            question: `Mock MCQ ${i + 1}: What is 2+2?`,
+                            answer: '1',
+                            type: 'MULTIPLE_CHOICE',
+                            options: ['3', '4', '5', '6'],
+                            mark_scheme: { points: [{ point: 1, requirements: 'Select correct option' }], totalPoints: 1 },
+                        };
+                    }
+                    return {
+                        question: `Mock question ${i + 1}: Explain a concept.`,
+                        answer: 'Mock answer',
+                        type: 'TEXT',
+                        options: [],
+                        mark_scheme: { points: [{ point: 1, requirements: 'Clear explanation' }], totalPoints: 1 },
+                    };
+                }),
             });
         }
-        const formData = new FormData();
-        formData.append('command', 'generate_worksheet_questions');
-        formData.append('session', sessionId);
-        formData.append('user', user);
-        formData.append('num_questions', numQuestions.toString());
-        formData.append('difficulty', difficulty);
-        try {
+        return withRetry(async () => {
+            const formData = new FormData();
+            formData.append('command', 'generate_worksheet_questions');
+            formData.append('session', sessionId);
+            formData.append('user', user);
+            formData.append('num_questions', numQuestions.toString());
+            formData.append('difficulty', difficulty);
+            formData.append('mode', options?.mode ?? 'practice');
+            if (options?.mcqRatio !== undefined) {
+                formData.append('mcq_ratio', String(options.mcqRatio));
+            }
+            if (options?.questionTypes?.length) {
+                formData.append('question_types', JSON.stringify(options.questionTypes));
+            }
+            if (options?.prompt) {
+                formData.append('worksheet_prompt', options.prompt);
+            }
             const response = await fetch(AI_SERVICE_URL, {
                 method: 'POST',
                 body: formData,
@@ -291,15 +299,8 @@ This mock study guide demonstrates the structure and format that would be genera
                 throw new Error(`AI service error: ${response.status} ${response.statusText}`);
             }
             const result = await response.json();
-            console.log(JSON.parse(result.worksheet));
             return result.worksheet;
-        }
-        catch (error) {
-            throw new TRPCError({
-                code: 'INTERNAL_SERVER_ERROR',
-                message: `Failed to generate worksheet questions: ${error instanceof Error ? error.message : 'Unknown error'}`,
-            });
-        }
+        }, { maxRetries: 3, timeoutMs: 300000, label: 'generateWorksheetQuestions' });
     }
     async checkWorksheetQuestions(sessionId, user, question, answer, mark_scheme) {
         const formData = new FormData();
@@ -317,7 +318,7 @@ This mock study guide demonstrates the structure and format that would be genera
             throw new Error(`AI service error: ${response.status} ${response.statusText}`);
         }
         const result = await response.json();
-        console.log(result.marking);
+        logger.debug(`Worksheet marking result received`);
         return JSON.parse(result.marking);
     }
     // Generate podcast structure
@@ -460,6 +461,67 @@ This mock study guide demonstrates the structure and format that would be genera
             });
         }
     }
+    async segmentStudyGuide(sessionId, user, studyGuide) {
+        // def generate_study_guide_segmentation(request):
+        // user = request.form.get("user")
+        // session = request.form.get("session")
+        // study_guide = request.form.get("study_guide")
+        // if not user or not session:
+        //     return {"error": "Session not initialized."}, 400
+        // if not study_guide:
+        //     print("Study guide not provided.")
+        //     return {"error": "Study guide not provided."}, 400
+        // messages = generate_segmentation(study_guide)
+        // return {"segmentation": messages}, 200  
+        const formData = new FormData();
+        formData.append('command', 'generate_study_guide_segmentation');
+        formData.append('session', sessionId);
+        formData.append('user', user);
+        formData.append('study_guide', studyGuide);
+        try {
+            const response = await fetch(AI_SERVICE_URL, {
+                method: 'POST',
+                body: formData,
+            });
+            if (!response.ok) {
+                throw new Error(`AI service error: ${response.status} ${response.statusText}`);
+            }
+            const result = await response.json();
+            return result.segmentation;
+        }
+        catch (error) {
+            throw new TRPCError({
+                code: 'INTERNAL_SERVER_ERROR',
+                message: `Failed to segment study guide: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            });
+        }
+    }
+    async validateSegmentSummary(sessionId, user, segmentContent, studentResponse, studyGuide) {
+        const formData = new FormData();
+        formData.append('command', 'validate_segment_summary');
+        formData.append('session', sessionId);
+        formData.append('user', user);
+        formData.append('segment_content', segmentContent);
+        formData.append('student_response', studentResponse);
+        formData.append('study_guide', studyGuide);
+        try {
+            const response = await fetch(AI_SERVICE_URL, {
+                method: 'POST',
+                body: formData,
+            });
+            if (!response.ok) {
+                throw new Error(`AI service error: ${response.status} ${response.statusText}`);
+            }
+            const result = await response.json();
+            return result.feedback;
+        }
+        catch (error) {
+            throw new TRPCError({
+                code: 'INTERNAL_SERVER_ERROR',
+                message: `Failed to validate segment summary: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            });
+        }
+    }
     // Get session by ID
     getSession(sessionId) {
         return this.sessions.get(sessionId);
@@ -477,20 +539,20 @@ This mock study guide demonstrates the structure and format that would be genera
         await new Promise(resolve => setTimeout(resolve, IMITATE_WAIT_TIME_MS));
         // Mock mode - always return healthy
         if (MOCK_MODE) {
-            console.log('🎭 MOCK MODE: AI service health check - returning healthy');
+            logger.info('MOCK MODE: AI service health check - returning healthy');
             return true;
         }
         try {
-            console.log('🏥 Checking AI service health...');
+            logger.info('Checking AI service health...');
             const response = await fetch(AI_SERVICE_URL, {
                 method: 'POST',
                 body: new FormData(), // Empty form data
             });
-            console.log(`🏥 AI Service health check status: ${response.status}`);
+            logger.info(`AI Service health check status: ${response.status}`);
             return response.ok;
         }
         catch (error) {
-            console.error('🏥 AI Service health check failed:', error);
+            logger.error('AI Service health check failed:', error);
             return false;
         }
     }

package/dist/lib/constants.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared constants for artifact types.
+ * Mirrors the Prisma ArtifactType enum to avoid direct type imports
+ * in contexts where Prisma client types may not be available.
+ */
+export declare const ArtifactType: {
+    readonly STUDY_GUIDE: "STUDY_GUIDE";
+    readonly FLASHCARD_SET: "FLASHCARD_SET";
+    readonly WORKSHEET: "WORKSHEET";
+    readonly MEETING_SUMMARY: "MEETING_SUMMARY";
+    readonly PODCAST_EPISODE: "PODCAST_EPISODE";
+};
+export type ArtifactTypeValue = (typeof ArtifactType)[keyof typeof ArtifactType];

package/dist/lib/constants.js

@@ -0,0 +1,12 @@
+/**
+ * Shared constants for artifact types.
+ * Mirrors the Prisma ArtifactType enum to avoid direct type imports
+ * in contexts where Prisma client types may not be available.
+ */
+export const ArtifactType = {
+    STUDY_GUIDE: 'STUDY_GUIDE',
+    FLASHCARD_SET: 'FLASHCARD_SET',
+    WORKSHEET: 'WORKSHEET',
+    MEETING_SUMMARY: 'MEETING_SUMMARY',
+    PODCAST_EPISODE: 'PODCAST_EPISODE',
+};

package/dist/lib/email.d.ts

@@ -0,0 +1,11 @@
+export declare function sendVerificationEmail(email: string, token: string, name?: string | null): Promise<boolean>;
+export declare function sendInvitationEmail(invitation: {
+    email: string;
+    token: string;
+    role: string;
+    workspaceTitle: string;
+    invitedByName: string;
+}): Promise<boolean>;
+export declare function sendAccountDeletionScheduledEmail(email: string, token: string): Promise<boolean>;
+export declare function sendPasswordResetEmail(email: string, token: string, name?: string | null): Promise<boolean>;
+export declare function sendAccountRestoredEmail(email: string): Promise<boolean>;

package/dist/lib/email.js

@@ -0,0 +1,193 @@
+import nodemailer from 'nodemailer';
+import { logger } from './logger.js';
+import { env } from './env.js';
+// Commented out Resend flow as requested
+// import { Resend } from 'resend';
+// const resend = env.RESEND_API_KEY ? new Resend(env.RESEND_API_KEY) : null;
+const transporter = nodemailer.createTransport({
+    host: env.SMTP_HOST,
+    port: env.SMTP_PORT,
+    secure: env.SMTP_SECURE,
+    auth: {
+        user: env.SMTP_USER,
+        pass: env.SMTP_PASSWORD,
+    },
+});
+const FROM_EMAIL = env.EMAIL_FROM;
+const APP_URL = env.FRONTEND_URL;
+export async function sendVerificationEmail(email, token, name) {
+    const verifyUrl = `${APP_URL}/verify-email?token=${token}`;
+    const greeting = name ? `, ${name}` : '';
+    const html = `
+    <div style="font-family:system-ui,sans-serif;max-width:480px;margin:0 auto;padding:40px 20px;">
+      <h2 style="font-size:20px;font-weight:600;margin-bottom:8px;">Welcome to Scribe${greeting}!</h2>
+      <p style="color:#6b7280;font-size:14px;line-height:1.6;margin-bottom:24px;">
+        Please verify your email address to get the most out of your account.
+      </p>
+      <a href="${verifyUrl}" style="display:inline-block;background-color:#7c3aed;color:#fff;text-decoration:none;padding:10px 24px;border-radius:6px;font-size:14px;font-weight:500;">Verify Email</a>
+      <p style="color:#9ca3af;font-size:12px;margin-top:32px;line-height:1.5;">
+        If you did not create an account on Scribe, you can safely ignore this email.
+        This link expires in 24 hours.
+      </p>
+    </div>
+  `;
+    try {
+        if (!env.SMTP_HOST) {
+            logger.warn('Email service not configured (SMTP_HOST missing). Logging email content instead:');
+            logger.info(`Verification Email to ${email}: ${verifyUrl}`);
+            return true;
+        }
+        await transporter.sendMail({
+            from: FROM_EMAIL,
+            to: email,
+            subject: 'Verify your email - Scribe',
+            html,
+        });
+        logger.info(`Verification email sent to ${email}`);
+        return true;
+    }
+    catch (err) {
+        logger.error('Email send error:', err);
+        return false;
+    }
+}
+export async function sendInvitationEmail(invitation) {
+    const inviteUrl = `${APP_URL}/accept-invite?token=${invitation.token}`;
+    const html = `
+    <div style="font-family:system-ui,sans-serif;max-width:480px;margin:0 auto;padding:40px 20px;">
+      <h2 style="font-size:20px;font-weight:600;margin-bottom:8px;">Workspace Invitation</h2>
+      <p style="color:#374151;font-size:14px;line-height:1.6;margin-bottom:16px;">
+        <strong>${invitation.invitedByName}</strong> has invited you to join the <strong>${invitation.workspaceTitle}</strong> workspace as a <strong>${invitation.role}</strong>.
+      </p>
+      <p style="color:#6b7280;font-size:14px;line-height:1.6;margin-bottom:24px;">
+        Click the button below to accept the invitation and start collaborating.
+      </p>
+      <a href="${inviteUrl}" style="display:inline-block;background-color:#7c3aed;color:#fff;text-decoration:none;padding:10px 24px;border-radius:6px;font-size:14px;font-weight:500;">Accept Invitation</a>
+      <p style="color:#9ca3af;font-size:12px;margin-top:32px;line-height:1.5;">
+        This invitation was sent to ${invitation.email}. If you weren't expecting this invitation, you can safely ignore this email.
+      </p>
+    </div>
+  `;
+    try {
+        if (!env.SMTP_HOST) {
+            logger.warn('Email service not configured (SMTP_HOST missing). Logging invitation link instead:');
+            logger.info(`Invitation Link for ${invitation.email}: ${inviteUrl}`);
+            return true;
+        }
+        await transporter.sendMail({
+            from: FROM_EMAIL,
+            to: invitation.email,
+            subject: `Invitation to join ${invitation.workspaceTitle} on Scribe`,
+            html,
+        });
+        logger.info(`Invitation email sent to ${invitation.email}`);
+        return true;
+    }
+    catch (err) {
+        logger.error('Email send error:', err);
+        return false;
+    }
+}
+export async function sendAccountDeletionScheduledEmail(email, token) {
+    const restoreUrl = `${APP_URL}/restore-account?token=${token}`;
+    const html = `
+    <div style="font-family:system-ui,sans-serif;max-width:480px;margin:0 auto;padding:40px 20px;">
+      <h2 style="font-size:20px;font-weight:600;margin-bottom:8px;color:#dc2626;">Account Deletion Scheduled</h2>
+      <p style="color:#374151;font-size:14px;line-height:1.6;margin-bottom:16px;">
+        Your account is scheduled for permanent deletion in 30 days.
+      </p>
+      <p style="color:#6b7280;font-size:14px;line-height:1.6;margin-bottom:24px;">
+        If you change your mind, you can restore your account by clicking the button below. This link will remain active during the 30-day grace period.
+      </p>
+      <a href="${restoreUrl}" style="display:inline-block;background-color:#7c3aed;color:#fff;text-decoration:none;padding:10px 24px;border-radius:6px;font-size:14px;font-weight:500;">Restore Account</a>
+      <p style="color:#9ca3af;font-size:12px;margin-top:32px;line-height:1.5;">
+        If you meant to delete your account, you can safely ignore this email.
+      </p>
+    </div>
+  `;
+    try {
+        if (!env.SMTP_HOST) {
+            logger.warn('Email service not configured (SMTP_HOST missing). Logging email content instead:');
+            logger.info(`Account Deletion Scheduled Email to ${email}: ${restoreUrl}`);
+            return true;
+        }
+        await transporter.sendMail({
+            from: FROM_EMAIL,
+            to: email,
+            subject: 'Account Deletion Scheduled - Scribe',
+            html,
+        });
+        logger.info(`Account deletion scheduled email sent to ${email}`);
+        return true;
+    }
+    catch (err) {
+        logger.error('Email send error:', err);
+        return false;
+    }
+}
+export async function sendPasswordResetEmail(email, token, name) {
+    const resetUrl = `${APP_URL}/reset-password?token=${encodeURIComponent(token)}`;
+    const greeting = name ? `, ${name}` : '';
+    const html = `
+    <div style="font-family:system-ui,sans-serif;max-width:480px;margin:0 auto;padding:40px 20px;">
+      <h2 style="font-size:20px;font-weight:600;margin-bottom:8px;">Reset your password${greeting}</h2>
+      <p style="color:#6b7280;font-size:14px;line-height:1.6;margin-bottom:24px;">
+        We received a request to reset your Scribe password. Click the button below to choose a new password.
+      </p>
+      <a href="${resetUrl}" style="display:inline-block;background-color:#7c3aed;color:#fff;text-decoration:none;padding:10px 24px;border-radius:6px;font-size:14px;font-weight:500;">Reset password</a>
+      <p style="color:#9ca3af;font-size:12px;margin-top:32px;line-height:1.5;">
+        If you did not request this, you can ignore this email. This link expires in 1 hour.
+      </p>
+    </div>
+  `;
+    try {
+        if (!env.SMTP_HOST) {
+            logger.warn('Email service not configured (SMTP_HOST missing). Logging reset link instead:');
+            logger.info(`Password reset for ${email}: ${resetUrl}`);
+            return true;
+        }
+        await transporter.sendMail({
+            from: FROM_EMAIL,
+            to: email,
+            subject: 'Reset your password - Scribe',
+            html,
+        });
+        logger.info(`Password reset email sent to ${email}`);
+        return true;
+    }
+    catch (err) {
+        logger.error('Email send error:', err);
+        return false;
+    }
+}
+export async function sendAccountRestoredEmail(email) {
+    const loginUrl = `${APP_URL}/login`;
+    const html = `
+    <div style="font-family:system-ui,sans-serif;max-width:480px;margin:0 auto;padding:40px 20px;">
+      <h2 style="font-size:20px;font-weight:600;margin-bottom:8px;color:#16a34a;">Account Restored Successfully</h2>
+      <p style="color:#374151;font-size:14px;line-height:1.6;margin-bottom:16px;">
+        Your account has been successfully restored. Your data is safe and your account deletion process has been cancelled.
+      </p>
+      <a href="${loginUrl}" style="display:inline-block;background-color:#7c3aed;color:#fff;text-decoration:none;padding:10px 24px;border-radius:6px;font-size:14px;font-weight:500;">Log In</a>
+    </div>
+  `;
+    try {
+        if (!env.SMTP_HOST) {
+            logger.warn('Email service not configured (SMTP_HOST missing). Logging email content instead:');
+            logger.info(`Account Restored Email to ${email}`);
+            return true;
+        }
+        await transporter.sendMail({
+            from: FROM_EMAIL,
+            to: email,
+            subject: 'Account Restored - Scribe',
+            html,
+        });
+        logger.info(`Account restored email sent to ${email}`);
+        return true;
+    }
+    catch (err) {
+        logger.error('Email send error:', err);
+        return false;
+    }
+}