@goscribe/server 1.5.0 → 1.7.0

package/dist/src/routers/flashcards.d.ts

@@ -0,0 +1,336 @@
+export declare const flashcards: import("@trpc/server").TRPCBuiltRouter<{
+    ctx: import("../context.js").Context;
+    meta: object;
+    errorShape: {
+        data: {
+            zodError: string | null;
+            code: import("@trpc/server").TRPC_ERROR_CODE_KEY;
+            httpStatus: number;
+            path?: string;
+            stack?: string;
+        };
+        message: string;
+        code: import("@trpc/server").TRPC_ERROR_CODE_NUMBER;
+    };
+    transformer: true;
+}, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+    listSets: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            workspaceId: string;
+        };
+        output: ({
+            versions: {
+                id: string;
+                createdAt: Date;
+                data: import("@prisma/client/runtime/client").JsonValue | null;
+                createdById: string | null;
+                artifactId: string;
+                content: string;
+                version: number;
+            }[];
+        } & {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            title: string;
+            description: string | null;
+            createdById: string | null;
+            type: import("../lib/prisma.js").ArtifactType;
+            workspaceId: string;
+            difficulty: import("../../generated/prisma/enums.js").Difficulty | null;
+            estimatedTime: string | null;
+            isArchived: boolean;
+            generating: boolean;
+            generatingMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+            worksheetConfig: import("@prisma/client/runtime/client").JsonValue | null;
+            imageObjectKey: string | null;
+        })[];
+        meta: object;
+    }>;
+    listCards: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            workspaceId: string;
+        };
+        output: ({
+            progress: {
+                userId: string;
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                interval: number;
+                flashcardId: string;
+                timesStudied: number;
+                timesCorrect: number;
+                timesIncorrect: number;
+                timesIncorrectConsecutive: number;
+                easeFactor: number;
+                repetitions: number;
+                masteryLevel: number;
+                lastStudiedAt: Date | null;
+                nextReviewAt: Date | null;
+            }[];
+        } & {
+            id: string;
+            createdAt: Date;
+            tags: string[];
+            artifactId: string;
+            order: number;
+            front: string;
+            back: string;
+            acceptedAnswers: string[];
+        })[];
+        meta: object;
+    }>;
+    isGenerating: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            workspaceId: string;
+        };
+        output: boolean;
+        meta: object;
+    }>;
+    createCard: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            workspaceId: string;
+            front: string;
+            back: string;
+            acceptedAnswers?: string[] | undefined;
+            tags?: string[] | undefined;
+            order?: number | undefined;
+        };
+        output: {
+            id: string;
+            createdAt: Date;
+            tags: string[];
+            artifactId: string;
+            order: number;
+            front: string;
+            back: string;
+            acceptedAnswers: string[];
+        };
+        meta: object;
+    }>;
+    updateCard: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            cardId: string;
+            front?: string | undefined;
+            back?: string | undefined;
+            acceptedAnswers?: string[] | undefined;
+            tags?: string[] | undefined;
+            order?: number | undefined;
+        };
+        output: {
+            id: string;
+            createdAt: Date;
+            tags: string[];
+            artifactId: string;
+            order: number;
+            front: string;
+            back: string;
+            acceptedAnswers: string[];
+        };
+        meta: object;
+    }>;
+    gradeTypedAnswer: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            flashcardId: string;
+            userAnswer: string;
+        };
+        output: {
+            isCorrect: boolean;
+            confidence: number;
+            reason: string;
+            matchedAnswer: string | null;
+        };
+        meta: object;
+    }>;
+    deleteCard: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            cardId: string;
+        };
+        output: boolean;
+        meta: object;
+    }>;
+    deleteSet: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            setId: string;
+        };
+        output: boolean;
+        meta: object;
+    }>;
+    generateFromPrompt: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            workspaceId: string;
+            prompt: string;
+            numCards?: number | undefined;
+            difficulty?: "easy" | "medium" | "hard" | undefined;
+            title?: string | undefined;
+            tags?: string[] | undefined;
+        };
+        output: {
+            artifact: {
+                flashcards: {
+                    id: string;
+                    createdAt: Date;
+                    tags: string[];
+                    artifactId: string;
+                    order: number;
+                    front: string;
+                    back: string;
+                    acceptedAnswers: string[];
+                }[];
+            } & {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                title: string;
+                description: string | null;
+                createdById: string | null;
+                type: import("../lib/prisma.js").ArtifactType;
+                workspaceId: string;
+                difficulty: import("../../generated/prisma/enums.js").Difficulty | null;
+                estimatedTime: string | null;
+                isArchived: boolean;
+                generating: boolean;
+                generatingMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+                worksheetConfig: import("@prisma/client/runtime/client").JsonValue | null;
+                imageObjectKey: string | null;
+            };
+            createdCards: number;
+        };
+        meta: object;
+    }>;
+    recordStudyAttempt: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            flashcardId: string;
+            isCorrect: boolean;
+            confidence?: "easy" | "medium" | "hard" | undefined;
+            timeSpentMs?: number | undefined;
+        };
+        output: any;
+        meta: object;
+    }>;
+    getSetProgress: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            artifactId: string;
+        };
+        output: {
+            flashcardId: any;
+            front: any;
+            back: any;
+            progress: {
+                userId: string;
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                interval: number;
+                flashcardId: string;
+                timesStudied: number;
+                timesCorrect: number;
+                timesIncorrect: number;
+                timesIncorrectConsecutive: number;
+                easeFactor: number;
+                repetitions: number;
+                masteryLevel: number;
+                lastStudiedAt: Date | null;
+                nextReviewAt: Date | null;
+            } | null;
+        }[];
+        meta: object;
+    }>;
+    getDueFlashcards: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            workspaceId: string;
+        };
+        output: (({
+            artifact: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                title: string;
+                description: string | null;
+                createdById: string | null;
+                type: import("../lib/prisma.js").ArtifactType;
+                workspaceId: string;
+                difficulty: import("../../generated/prisma/enums.js").Difficulty | null;
+                estimatedTime: string | null;
+                isArchived: boolean;
+                generating: boolean;
+                generatingMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+                worksheetConfig: import("@prisma/client/runtime/client").JsonValue | null;
+                imageObjectKey: string | null;
+            };
+        } & {
+            id: string;
+            createdAt: Date;
+            tags: string[];
+            artifactId: string;
+            order: number;
+            front: string;
+            back: string;
+            acceptedAnswers: string[];
+        }) | {
+            artifact: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                title: string;
+                description: string | null;
+                createdById: string | null;
+                type: import("../lib/prisma.js").ArtifactType;
+                workspaceId: string;
+                difficulty: import("../../generated/prisma/enums.js").Difficulty | null;
+                estimatedTime: string | null;
+                isArchived: boolean;
+                generating: boolean;
+                generatingMetadata: import("@prisma/client/runtime/client").JsonValue | null;
+                worksheetConfig: import("@prisma/client/runtime/client").JsonValue | null;
+                imageObjectKey: string | null;
+            };
+            id: string;
+            createdAt: Date;
+            tags: string[];
+            artifactId: string;
+            order: number;
+            front: string;
+            back: string;
+            acceptedAnswers: string[];
+        })[];
+        meta: object;
+    }>;
+    getSetStatistics: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            artifactId: string;
+        };
+        output: {
+            totalCards: number;
+            studiedCards: number;
+            unstudiedCards: number;
+            masteredCards: number;
+            dueForReview: number;
+            averageMastery: number;
+            successRate: number;
+            totalAttempts: number;
+            totalCorrect: number;
+        };
+        meta: object;
+    }>;
+    resetProgress: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            flashcardId: string;
+        };
+        output: import("../../generated/prisma/internal/prismaNamespace.js").BatchPayload;
+        meta: object;
+    }>;
+    recordStudySession: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            attempts: {
+                flashcardId: string;
+                isCorrect: boolean;
+                confidence?: "easy" | "medium" | "hard" | undefined;
+                timeSpentMs?: number | undefined;
+            }[];
+        };
+        output: any[];
+        meta: object;
+    }>;
+}>>;

package/dist/src/routers/flashcards.js

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import { router, authedProcedure, limitedProcedure } from '../trpc.js';
+import { FlashcardService } from '../services/content/flashcard.service.js';
+import { createFlashcardProgressService } from '../services/content/flashcard-progress.service.js';
+export const flashcards = router({
+    listSets: authedProcedure
+        .input(z.object({ workspaceId: z.string() }))
+        .query(({ ctx, input }) => new FlashcardService(ctx.db).listSets(ctx.session.user.id, input.workspaceId)),
+    listCards: authedProcedure
+        .input(z.object({ workspaceId: z.string() }))
+        .query(({ ctx, input }) => new FlashcardService(ctx.db).listCards(ctx.session.user.id, input.workspaceId)),
+    isGenerating: authedProcedure
+        .input(z.object({ workspaceId: z.string() }))
+        .query(({ ctx, input }) => new FlashcardService(ctx.db).isGenerating(ctx.session.user.id, input.workspaceId)),
+    createCard: limitedProcedure
+        .input(z.object({
+        workspaceId: z.string(),
+        front: z.string().min(1),
+        back: z.string().min(1),
+        acceptedAnswers: z.array(z.string()).optional(),
+        tags: z.array(z.string()).optional(),
+        order: z.number().int().optional(),
+    }))
+        .mutation(({ ctx, input }) => new FlashcardService(ctx.db).createCard(ctx.session.user.id, input)),
+    updateCard: authedProcedure
+        .input(z.object({
+        cardId: z.string(),
+        front: z.string().optional(),
+        back: z.string().optional(),
+        acceptedAnswers: z.array(z.string()).optional(),
+        tags: z.array(z.string()).optional(),
+        order: z.number().int().optional(),
+    }))
+        .mutation(({ ctx, input }) => new FlashcardService(ctx.db).updateCard(ctx.session.user.id, input)),
+    gradeTypedAnswer: authedProcedure
+        .input(z.object({
+        flashcardId: z.string().cuid(),
+        userAnswer: z.string().min(1),
+    }))
+        .mutation(({ ctx, input }) => new FlashcardService(ctx.db).gradeTypedAnswer(ctx.session.user.id, input)),
+    deleteCard: authedProcedure
+        .input(z.object({ cardId: z.string() }))
+        .mutation(({ ctx, input }) => new FlashcardService(ctx.db).deleteCard(ctx.session.user.id, input.cardId)),
+    deleteSet: authedProcedure
+        .input(z.object({ setId: z.string().uuid() }))
+        .mutation(({ ctx, input }) => new FlashcardService(ctx.db).deleteSet(ctx.session.user.id, input.setId)),
+    generateFromPrompt: limitedProcedure
+        .input(z.object({
+        workspaceId: z.string(),
+        prompt: z.string().min(1),
+        numCards: z.number().int().min(1).max(50).default(10),
+        difficulty: z.enum(['easy', 'medium', 'hard']).default('medium'),
+        title: z.string().optional(),
+        tags: z.array(z.string()).optional(),
+    }))
+        .mutation(({ ctx, input }) => new FlashcardService(ctx.db).generateFromPrompt(ctx.session.user.id, input)),
+    recordStudyAttempt: authedProcedure
+        .input(z.object({
+        flashcardId: z.string().cuid(),
+        isCorrect: z.boolean(),
+        confidence: z.enum(['easy', 'medium', 'hard']).optional(),
+        timeSpentMs: z.number().optional(),
+    }))
+        .mutation(({ ctx, input }) => createFlashcardProgressService(ctx.db).recordStudyAttempt({
+        userId: ctx.userId,
+        ...input,
+    })),
+    getSetProgress: authedProcedure
+        .input(z.object({ artifactId: z.string().cuid() }))
+        .query(({ ctx, input }) => createFlashcardProgressService(ctx.db).getSetProgress(ctx.userId, input.artifactId)),
+    getDueFlashcards: authedProcedure
+        .input(z.object({ workspaceId: z.string() }))
+        .query(({ ctx, input }) => createFlashcardProgressService(ctx.db).getDueFlashcards(ctx.userId, input.workspaceId)),
+    getSetStatistics: authedProcedure
+        .input(z.object({ artifactId: z.string().cuid() }))
+        .query(({ ctx, input }) => createFlashcardProgressService(ctx.db).getSetStatistics(ctx.userId, input.artifactId)),
+    resetProgress: authedProcedure
+        .input(z.object({ flashcardId: z.string().cuid() }))
+        .mutation(({ ctx, input }) => createFlashcardProgressService(ctx.db).resetProgress(ctx.userId, input.flashcardId)),
+    recordStudySession: authedProcedure
+        .input(z.object({
+        attempts: z.array(z.object({
+            flashcardId: z.string().cuid(),
+            isCorrect: z.boolean(),
+            confidence: z.enum(['easy', 'medium', 'hard']).optional(),
+            timeSpentMs: z.number().optional(),
+        })),
+    }))
+        .mutation(({ ctx, input }) => createFlashcardProgressService(ctx.db).recordStudySession({
+        userId: ctx.userId,
+        ...input,
+    })),
+});