@goscribe/server 1.3.4 → 1.5.0

package/dist/lib/email.js

@@ -1,20 +1,34 @@
-import nodemailer from 'nodemailer';
+import { Resend } from 'resend';
 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 resend = env.RESEND_API_KEY ? new Resend(env.RESEND_API_KEY) : null;
 const FROM_EMAIL = env.EMAIL_FROM;
 const APP_URL = env.FRONTEND_URL;
+async function sendEmail(options) {
+    try {
+        if (!resend) {
+            logger.warn(`${options.missingConfigLog} Logging instead:`);
+            logger.info(options.devLogDetail);
+            return true;
+        }
+        const { data, error } = await resend.emails.send({
+            from: FROM_EMAIL,
+            to: options.to,
+            subject: options.subject,
+            html: options.html,
+        });
+        if (error) {
+            logger.error('Email send error:', error);
+            return false;
+        }
+        logger.info(options.successLog + (data?.id ? ` (id: ${data.id})` : ''));
+        return true;
+    }
+    catch (err) {
+        logger.error('Email send error:', err);
+        return false;
+    }
+}
 export async function sendVerificationEmail(email, token, name) {
     const verifyUrl = `${APP_URL}/verify-email?token=${token}`;
     const greeting = name ? `, ${name}` : '';
@@ -31,25 +45,14 @@ export async function sendVerificationEmail(email, token, name) {
       </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;
-    }
+    return sendEmail({
+        to: email,
+        subject: 'Verify your email - Scribe',
+        html,
+        successLog: `Verification email sent to ${email}`,
+        missingConfigLog: 'Email service not configured (RESEND_API_KEY missing).',
+        devLogDetail: `Verification Email to ${email}: ${verifyUrl}`,
+    });
 }
 export async function sendInvitationEmail(invitation) {
     const inviteUrl = `${APP_URL}/accept-invite?token=${invitation.token}`;
@@ -68,25 +71,14 @@ export async function sendInvitationEmail(invitation) {
       </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;
-    }
+    return sendEmail({
+        to: invitation.email,
+        subject: `Invitation to join ${invitation.workspaceTitle} on Scribe`,
+        html,
+        successLog: `Invitation email sent to ${invitation.email}`,
+        missingConfigLog: 'Email service not configured (RESEND_API_KEY missing).',
+        devLogDetail: `Invitation Link for ${invitation.email}: ${inviteUrl}`,
+    });
 }
 export async function sendAccountDeletionScheduledEmail(email, token) {
     const restoreUrl = `${APP_URL}/restore-account?token=${token}`;
@@ -105,25 +97,14 @@ export async function sendAccountDeletionScheduledEmail(email, token) {
       </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;
-    }
+    return sendEmail({
+        to: email,
+        subject: 'Account Deletion Scheduled - Scribe',
+        html,
+        successLog: `Account deletion scheduled email sent to ${email}`,
+        missingConfigLog: 'Email service not configured (RESEND_API_KEY missing).',
+        devLogDetail: `Account Deletion Scheduled Email to ${email}: ${restoreUrl}`,
+    });
 }
 export async function sendPasswordResetEmail(email, token, name) {
     const resetUrl = `${APP_URL}/reset-password?token=${encodeURIComponent(token)}`;
@@ -140,25 +121,14 @@ export async function sendPasswordResetEmail(email, token, name) {
       </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;
-    }
+    return sendEmail({
+        to: email,
+        subject: 'Reset your password - Scribe',
+        html,
+        successLog: `Password reset email sent to ${email}`,
+        missingConfigLog: 'Email service not configured (RESEND_API_KEY missing).',
+        devLogDetail: `Password reset for ${email}: ${resetUrl}`,
+    });
 }
 export async function sendAccountRestoredEmail(email) {
     const loginUrl = `${APP_URL}/login`;
@@ -171,23 +141,12 @@ export async function sendAccountRestoredEmail(email) {
       <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;
-    }
+    return sendEmail({
+        to: email,
+        subject: 'Account Restored - Scribe',
+        html,
+        successLog: `Account restored email sent to ${email}`,
+        missingConfigLog: 'Email service not configured (RESEND_API_KEY missing).',
+        devLogDetail: `Account Restored Email to ${email}: ${loginUrl}`,
+    });
 }

package/dist/lib/embeddings.d.ts

@@ -0,0 +1,2 @@
+export { DEFAULT_EMBEDDING_DIM, DEFAULT_EMBEDDING_MODEL, embedQuery, embedTexts, toVectorLiteral, } from './ai/embedding-client.js';
+export type { EmbedOptions } from './ai/embedding-client.js';

package/dist/lib/embeddings.js

@@ -0,0 +1 @@
+export { DEFAULT_EMBEDDING_DIM, DEFAULT_EMBEDDING_MODEL, embedQuery, embedTexts, toVectorLiteral, } from './ai/embedding-client.js';

package/dist/lib/ensure-curated-kb-catalog.d.ts

@@ -0,0 +1,6 @@
+import type { PrismaClient } from '@prisma/client';
+/**
+ * Ensures the curated AP/IB catalog exists. Idempotent — safe to call on every
+ * server boot. Matches existing KBs by slug stored in `meta.slug`.
+ */
+export declare function ensureCuratedKbCatalog(db: PrismaClient): Promise<void>;

package/dist/lib/ensure-curated-kb-catalog.js

@@ -0,0 +1,53 @@
+import { CURATED_KB_SEEDS } from '../lib/curated-kb-seed.js';
+import { logger } from '../lib/logger.js';
+/**
+ * Ensures the curated AP/IB catalog exists. Idempotent — safe to call on every
+ * server boot. Matches existing KBs by slug stored in `meta.slug`.
+ */
+export async function ensureCuratedKbCatalog(db) {
+    let created = 0;
+    for (const seed of CURATED_KB_SEEDS) {
+        const existing = (await db.knowledgeBase.findFirst({
+            where: {
+                meta: { path: ['slug'], equals: seed.slug },
+            },
+        })) ??
+            (await db.knowledgeBase.findFirst({
+                where: {
+                    name: { equals: seed.name, mode: 'insensitive' },
+                },
+            }));
+        if (existing) {
+            await db.knowledgeBase.update({
+                where: { id: existing.id },
+                data: {
+                    name: seed.name,
+                    description: seed.description,
+                    isCurated: true,
+                    meta: {
+                        slug: seed.slug,
+                        category: seed.category,
+                        subject: seed.subject,
+                    },
+                },
+            });
+            continue;
+        }
+        await db.knowledgeBase.create({
+            data: {
+                name: seed.name,
+                description: seed.description,
+                isCurated: true,
+                meta: {
+                    slug: seed.slug,
+                    category: seed.category,
+                    subject: seed.subject,
+                },
+            },
+        });
+        created += 1;
+    }
+    if (created > 0) {
+        logger.info(`Seeded ${created} curated knowledge base(s)`, 'KB');
+    }
+}

package/dist/lib/env.d.ts

@@ -6,9 +6,6 @@ export declare const env: {
     PORT: number;
     NODE_ENV: "production" | "development" | "test";
     FRONTEND_URL: string;
-    SMTP_HOST: string;
-    SMTP_PORT: number;
-    SMTP_SECURE: boolean;
     EMAIL_FROM: string;
     STRIPE_SUCCESS_URL: string;
     STRIPE_CANCEL_URL: string;
@@ -23,8 +20,7 @@ export declare const env: {
     PUSHER_SECRET?: string | undefined;
     PUSHER_CLUSTER?: string | undefined;
     INFERENCE_API_URL?: string | undefined;
-    SMTP_USER?: string | undefined;
-    SMTP_PASSWORD?: string | undefined;
+    RESEND_API_KEY?: string | undefined;
     STRIPE_SECRET_KEY?: string | undefined;
     STRIPE_PRICE_SUB_BASIC?: string | undefined;
     STRIPE_PRICE_SUB_PRO?: string | undefined;

package/dist/lib/env.js

@@ -27,12 +27,8 @@ const envSchema = z.object({
     INFERENCE_API_URL: z.string().url().optional(),
     // CORS
     FRONTEND_URL: z.string().url().default('http://localhost:3000'),
-    // Email
-    SMTP_HOST: z.string(),
-    SMTP_PORT: z.string().regex(/^\d+$/).default('587').transform(Number),
-    SMTP_USER: z.string().optional(),
-    SMTP_PASSWORD: z.string().optional(),
-    SMTP_SECURE: z.enum(['true', 'false']).default('false').transform((v) => v === 'true'),
+    // Email (Resend)
+    RESEND_API_KEY: z.string().optional(),
     EMAIL_FROM: z.string().default('Scribe <hello@scribe.study>'),
     // Stripe
     STRIPE_SECRET_KEY: z.string().startsWith('sk_').optional(),
@@ -47,7 +43,6 @@ const envSchema = z.object({
  * Parsed and validated environment variables
  */
 export const env = envSchema.parse(process.env);
-// console.log('DEBUG: SMTP_HOST loaded:', env.SMTP_HOST ? 'Yes' : 'No');
 /**
  * Check if running in production
  */

package/dist/lib/inference.d.ts

@@ -1,8 +1 @@
-import OpenAI from 'openai';
-declare function inference(messages: {
-    role: 'system' | 'user' | 'assistant';
-    content: string;
-}[]): Promise<OpenAI.Chat.Completions.ChatCompletion & {
-    _request_id?: string | null;
-}>;
-export default inference;
+export { complete as default, complete, completeText } from './ai/llm-client.js';

package/dist/lib/inference.js

@@ -1,19 +1 @@
-import OpenAI from 'openai';
-const openai = new OpenAI({
-    apiKey: process.env.INFERENCE_API_KEY,
-    baseURL: process.env.INFERENCE_BASE_URL,
-});
-async function inference(messages) {
-    try {
-        const response = await openai.chat.completions.create({
-            model: "command-a-03-2025",
-            messages: messages,
-        });
-        return response;
-    }
-    catch (error) {
-        // Inference error logged at call site
-        throw error;
-    }
-}
-export default inference;
+export { complete as default, complete, completeText } from './ai/llm-client.js';

package/dist/lib/kb-meta.d.ts

@@ -0,0 +1,8 @@
+export type KbMetaRecord = {
+    slug?: string;
+    category?: string;
+    subject?: string;
+    kind?: string;
+};
+/** Build catalog meta for new KBs so clients can assign icons and banner colors. */
+export declare function buildKbMetaFromName(name: string, existing?: KbMetaRecord | null): KbMetaRecord;

package/dist/lib/kb-meta.js

@@ -0,0 +1,77 @@
+import { CURATED_KB_SEEDS } from './curated-kb-seed.js';
+const CURATED_BY_NAME = new Map(CURATED_KB_SEEDS.map((seed) => [seed.name.trim().toLowerCase(), seed]));
+function inferSubject(name) {
+    const lower = name.toLowerCase();
+    if (lower.includes('biology') || /\bbio\b/.test(lower))
+        return 'biology';
+    if (lower.includes('chemistry') || /\bchem\b/.test(lower))
+        return 'chemistry';
+    if (lower.includes('physics'))
+        return 'physics';
+    if (lower.includes('calculus'))
+        return 'calculus';
+    if (lower.includes('statistics') || lower.includes('stats'))
+        return 'math';
+    if (lower.includes('math') || lower.includes('algebra') || lower.includes('geometry')) {
+        return 'math';
+    }
+    if (lower.includes('literature') || lower.includes('literary'))
+        return 'literature';
+    if (lower.includes('english') || lower.includes('writing') || lower.includes('rhetoric')) {
+        return 'english';
+    }
+    if (lower.includes('history') || lower.includes('historical'))
+        return 'history';
+    if (lower.includes('psychology') || lower.includes('psych'))
+        return 'psychology';
+    if (lower.includes('economics') || lower.includes('econ'))
+        return 'economics';
+    if (lower.includes('environmental') || lower.includes('ecology'))
+        return 'environmental';
+    if (lower.includes('computer') || lower.includes('programming') || lower.includes('cs ')) {
+        return 'science';
+    }
+    if (lower.includes('government') || lower.includes('politics'))
+        return 'history';
+    return undefined;
+}
+function inferCategory(name, category) {
+    if (category === 'AP' || category === 'IB')
+        return category;
+    const lower = name.toLowerCase();
+    if (lower.startsWith('ap ') || lower.includes(' ap ') || lower.includes('advanced placement')) {
+        return 'AP';
+    }
+    if (lower.startsWith('ib ') || lower.includes(' ib ') || lower.includes('baccalaureate')) {
+        return 'IB';
+    }
+    return 'General';
+}
+function slugify(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 80);
+}
+/** Build catalog meta for new KBs so clients can assign icons and banner colors. */
+export function buildKbMetaFromName(name, existing) {
+    const trimmed = name.trim();
+    const curated = CURATED_BY_NAME.get(trimmed.toLowerCase());
+    if (curated) {
+        return {
+            slug: curated.slug,
+            category: curated.category,
+            subject: curated.subject,
+        };
+    }
+    const subject = existing?.subject ?? inferSubject(trimmed);
+    const category = inferCategory(trimmed, existing?.category);
+    const slug = existing?.slug ?? (subject ? `${slugify(trimmed)}-${subject}` : slugify(trimmed));
+    return {
+        slug: slug || undefined,
+        category: category === 'General' ? undefined : category,
+        subject,
+        ...(existing?.kind ? { kind: existing.kind } : {}),
+    };
+}

package/dist/lib/note-text.d.ts

@@ -0,0 +1 @@
+export declare function extractNoteText(blocks: unknown, title?: string): string;

package/dist/lib/note-text.js

@@ -0,0 +1,47 @@
+function inlineText(content) {
+    if (!Array.isArray(content))
+        return '';
+    return content
+        .map((item) => {
+        if (!item || typeof item !== 'object')
+            return '';
+        const node = item;
+        if (node.type === 'text')
+            return node.text ?? '';
+        if (Array.isArray(node.content))
+            return inlineText(node.content);
+        return '';
+    })
+        .join('');
+}
+function blockText(block) {
+    const text = inlineText(block.content);
+    if (text)
+        return text;
+    if (block.type === 'image' || block.type === 'file' || block.type === 'audio') {
+        return block.props?.caption || block.props?.name || '';
+    }
+    return '';
+}
+function flattenBlocks(blocks) {
+    const out = [];
+    for (const block of blocks) {
+        out.push(block);
+        if (Array.isArray(block.children) && block.children.length > 0) {
+            out.push(...flattenBlocks(block.children));
+        }
+    }
+    return out;
+}
+export function extractNoteText(blocks, title) {
+    const parts = [];
+    if (title && title !== 'Untitled')
+        parts.push(title);
+    if (Array.isArray(blocks)) {
+        const texts = flattenBlocks(blocks)
+            .map(blockText)
+            .filter(Boolean);
+        parts.push(...texts);
+    }
+    return parts.join('\n\n').trim();
+}

package/dist/lib/notification-service.test.js

@@ -1,5 +1,4 @@
-import test from 'node:test';
-import assert from 'node:assert/strict';
+import { describe, it, expect } from 'vitest';
 import PusherService from './pusher.js';
 import { NotificationType, createNotification } from './notification-service.js';
 function createFakeDb() {
@@ -48,40 +47,42 @@ function createFakeDb() {
     };
     return { db, store };
 }
-test('createNotification deduplicates by sourceId', async () => {
-    const { db, store } = createFakeDb();
-    const originalEmit = PusherService.emitNotificationNew;
-    PusherService.emitNotificationNew = async () => { };
-    await createNotification(db, {
-        userId: 'u1',
-        type: NotificationType.PAYMENT_SUCCEEDED,
-        title: 'Payment successful',
-        body: 'Paid',
-        sourceId: 'source-1',
+describe('createNotification', () => {
+    it('deduplicates by sourceId', async () => {
+        const { db, store } = createFakeDb();
+        const originalEmit = PusherService.emitNotificationNew;
+        PusherService.emitNotificationNew = async () => { };
+        await createNotification(db, {
+            userId: 'u1',
+            type: NotificationType.PAYMENT_SUCCEEDED,
+            title: 'Payment successful',
+            body: 'Paid',
+            sourceId: 'source-1',
+        });
+        await createNotification(db, {
+            userId: 'u1',
+            type: NotificationType.PAYMENT_SUCCEEDED,
+            title: 'Payment successful',
+            body: 'Paid',
+            sourceId: 'source-1',
+        });
+        expect(store.length).toBe(1);
+        PusherService.emitNotificationNew = originalEmit;
     });
-    await createNotification(db, {
-        userId: 'u1',
-        type: NotificationType.PAYMENT_SUCCEEDED,
-        title: 'Payment successful',
-        body: 'Paid',
-        sourceId: 'source-1',
+    it('emits unread count payload', async () => {
+        const { db } = createFakeDb();
+        const originalEmit = PusherService.emitNotificationNew;
+        let capturedUnread = -1;
+        PusherService.emitNotificationNew = async (_userId, payload) => {
+            capturedUnread = payload.unreadCount;
+        };
+        await createNotification(db, {
+            userId: 'u1',
+            type: NotificationType.GENERAL,
+            title: 'Hello',
+            body: 'World',
+        });
+        expect(capturedUnread).toBe(1);
+        PusherService.emitNotificationNew = originalEmit;
     });
-    assert.equal(store.length, 1);
-    PusherService.emitNotificationNew = originalEmit;
-});
-test('createNotification emits unread count payload', async () => {
-    const { db } = createFakeDb();
-    const originalEmit = PusherService.emitNotificationNew;
-    let capturedUnread = -1;
-    PusherService.emitNotificationNew = async (_userId, payload) => {
-        capturedUnread = payload.unreadCount;
-    };
-    await createNotification(db, {
-        userId: 'u1',
-        type: NotificationType.GENERAL,
-        title: 'Hello',
-        body: 'World',
-    });
-    assert.equal(capturedUnread, 1);
-    PusherService.emitNotificationNew = originalEmit;
 });

package/dist/lib/pdf.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Thin wrapper around `pdf-parse` that returns plain text + page count.
+ *
+ * pdf-parse is loaded lazily and via a deep import to avoid the package's
+ * top-level "test" code that runs when the module index is loaded directly.
+ */
+export interface ExtractedPdf {
+    text: string;
+    numPages: number;
+}
+export declare function extractPdfText(buffer: Buffer): Promise<ExtractedPdf>;

package/dist/lib/pdf.js

@@ -0,0 +1,11 @@
+export async function extractPdfText(buffer) {
+    // Deep import skips pdf-parse's top-level demo block (`if (!module.parent)`).
+    // @ts-ignore - no types ship for the deep file
+    const mod = await import('pdf-parse/lib/pdf-parse.js');
+    const pdfParse = mod.default ?? mod;
+    const data = await pdfParse(buffer);
+    return {
+        text: data.text ?? '',
+        numPages: data.numpages ?? 0,
+    };
+}

package/dist/lib/usage_service.d.ts

@@ -23,4 +23,5 @@ export declare function getUserPlanLimits(userId: string): Promise<{
     maxStudyGuides: number;
     createdAt: Date;
     updatedAt: Date;
-} | null>;
+    isFallbackPlan: boolean;
+}>;