npm - @vestcards/server-types - Versions diffs - 1.2.0 → 1.3.0 - Mend

@vestcards/server-types 1.2.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (30) hide show

package/dist/apps/server/src/app.d.ts CHANGED Viewed

@@ -455,8 +455,8 @@ declare const app: Elysia<"", {
                             createdAt: Date;
                             updatedAt: Date;
                             userId: string;
-                            content: string;
                             cardId: string;
+                            content: string;
                         } | null;
                         422: {
                             type: "validation";
@@ -479,7 +479,36 @@ declare const app: Elysia<"", {
                 post: {
                     body: {
                         type: string;
+                        cardId: string;
                         content: string;
+                    };
+                    params: {};
+                    query: {};
+                    headers: {};
+                    response: {
+                        200: {
+                            success: boolean;
+                        };
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    v1: {
+        card: {
+            suspend: {
+                post: {
+                    body: {
                         cardId: string;
                     };
                     params: {};
@@ -503,6 +532,66 @@ declare const app: Elysia<"", {
             };
         };
     };
+} & {
+    v1: {
+        card: {
+            suspend: {
+                delete: {
+                    body: {};
+                    params: {};
+                    query: {
+                        cardId: string;
+                    };
+                    headers: {};
+                    response: {
+                        200: {
+                            success: boolean;
+                        };
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    v1: {
+        card: {
+            "user-state": {
+                get: {
+                    body: {};
+                    params: {};
+                    query: {
+                        deckId: string;
+                    };
+                    headers: {};
+                    response: {
+                        200: {
+                            cardId: string;
+                            suspended: boolean;
+                            toReview: boolean;
+                        }[];
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
 } & {
     v1: {
         decks: {
@@ -1165,6 +1254,68 @@ declare const app: Elysia<"", {
             };
         };
     };
+} & {
+    v1: {
+        user: {
+            account: {
+                "delete-request": {
+                    post: {
+                        body: {
+                            email: string;
+                        };
+                        params: {};
+                        query: {};
+                        headers: {};
+                        response: {
+                            200: {
+                                success: boolean;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    v1: {
+        user: {
+            account: {
+                "confirm-delete": {
+                    post: {
+                        body: {
+                            token: string;
+                        };
+                        params: {};
+                        query: {};
+                        headers: {};
+                        response: {
+                            200: {
+                                success: boolean;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
 } & {
     v1: {
         user: {

package/dist/apps/server/src/libs/mappers.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import type { CardReview, NewCardReview, NewReviewLog } from '@vestcards/db-core';
+import type { ICardReview, IReviewLog } from '@vestcards/shared';
+export declare function cardReviewToICardReview(row: CardReview): ICardReview;
+export declare function iCardReviewToNewCardReview(card: ICardReview): NewCardReview;
+export declare function iReviewLogToNewReviewLog(log: IReviewLog): NewReviewLog;

package/dist/apps/server/src/modules/auth/lib.d.ts CHANGED Viewed

@@ -1,8 +1,9 @@
 import { UserRole } from '@vestcards/shared';
 import { type BetterAuthOptions } from 'better-auth';
 export declare const auth: import("better-auth").Auth<{
-    plugins: [{
+    plugins: ({
         id: "open-api";
+        version: string;
         endpoints: {
             generateOpenAPISchema: import("better-call").StrictEndpoint<"/open-api/generate-schema", {
                 method: "GET";
@@ -52,8 +53,9 @@ export declare const auth: import("better-auth").Auth<{
             }, Response>;
         };
         options: NoInfer<import("better-auth/plugins").OpenAPIOptions>;
-    }, {
+    } | {
         id: "expo";
+        version: string;
         init: (ctx: import("better-auth").AuthContext) => {
             options: {
                 trustedOrigins: string[];
@@ -71,10 +73,10 @@ export declare const auth: import("better-auth").Auth<{
         endpoints: {
             expoAuthorizationProxy: import("better-call").StrictEndpoint<"/expo-authorization-proxy", {
                 method: "GET";
-                query: import("better-auth").ZodObject<{
-                    authorizationURL: import("better-auth").ZodString;
-                    oauthState: import("better-auth").ZodOptional<import("better-auth").ZodString>;
-                }, import("better-auth").$strip>;
+                query: import("zod").ZodObject<{
+                    authorizationURL: import("zod").ZodString;
+                    oauthState: import("zod").ZodOptional<import("zod").ZodString>;
+                }, import("zod/v4/core").$strip>;
                 metadata: {
                     readonly scope: "server";
                 };
@@ -94,8 +96,9 @@ export declare const auth: import("better-auth").Auth<{
             }>;
         };
         options: import("@better-auth/expo").ExpoOptions | undefined;
-    }, {
+    } | {
         id: "bearer";
+        version: string;
         hooks: {
             before: {
                 matcher(context: import("better-auth").HookEndpointContext): boolean;
@@ -111,8 +114,9 @@ export declare const auth: import("better-auth").Auth<{
             }[];
         };
         options: import("better-auth/plugins").BearerOptions | undefined;
-    }, {
+    } | {
         id: "custom-session";
+        version: string;
         hooks: {
             after: {
                 matcher: (ctx: import("better-auth").HookEndpointContext) => boolean;
@@ -147,10 +151,10 @@ export declare const auth: import("better-auth").Auth<{
         endpoints: {
             getSession: import("better-call").StrictEndpoint<"/get-session", {
                 method: "GET";
-                query: import("better-auth").ZodOptional<import("better-auth").ZodObject<{
-                    disableCookieCache: import("better-auth").ZodOptional<import("better-auth").ZodUnion<[import("better-auth").ZodBoolean, import("better-auth").ZodPipe<import("better-auth").ZodString, import("better-auth").ZodTransform<boolean, string>>]>>;
-                    disableRefresh: import("better-auth").ZodOptional<import("better-auth").ZodBoolean>;
-                }, import("better-auth").$strip>>;
+                query: import("zod").ZodOptional<import("zod").ZodObject<{
+                    disableCookieCache: import("zod").ZodOptional<import("zod").ZodUnion<[import("zod").ZodBoolean, import("zod").ZodPipe<import("zod").ZodString, import("zod").ZodTransform<boolean, string>>]>>;
+                    disableRefresh: import("zod").ZodOptional<import("zod").ZodBoolean>;
+                }, import("zod/v4/core").$strip>>;
                 metadata: {
                     CUSTOM_SESSION: boolean;
                     openapi: {
@@ -230,11 +234,11 @@ export declare const auth: import("better-auth").Auth<{
             };
         };
         options: import("better-auth/plugins").CustomSessionPluginOptions | undefined;
-    }];
+    })[];
     baseURL: string;
     basePath: string;
     database: (options: BetterAuthOptions) => import("better-auth").DBAdapter<BetterAuthOptions>;
-    secondaryStorage: import("better-auth").SecondaryStorage;
+    secondaryStorage: import("better-auth").SecondaryStorage | undefined;
     emailAndPassword: {
         enabled: true;
         autoSignIn: true;

package/dist/apps/server/src/modules/card/index.d.ts CHANGED Viewed

@@ -397,8 +397,8 @@ export declare const cardModule: Elysia<"/v1/card", {
                             createdAt: Date;
                             updatedAt: Date;
                             userId: string;
-                            content: string;
                             cardId: string;
+                            content: string;
                         } | null;
                         422: {
                             type: "validation";
@@ -421,7 +421,36 @@ export declare const cardModule: Elysia<"/v1/card", {
                 post: {
                     body: {
                         type: string;
+                        cardId: string;
                         content: string;
+                    };
+                    params: {};
+                    query: {};
+                    headers: {};
+                    response: {
+                        200: {
+                            success: boolean;
+                        };
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    v1: {
+        card: {
+            suspend: {
+                post: {
+                    body: {
                         cardId: string;
                     };
                     params: {};
@@ -445,6 +474,66 @@ export declare const cardModule: Elysia<"/v1/card", {
             };
         };
     };
+} & {
+    v1: {
+        card: {
+            suspend: {
+                delete: {
+                    body: {};
+                    params: {};
+                    query: {
+                        cardId: string;
+                    };
+                    headers: {};
+                    response: {
+                        200: {
+                            success: boolean;
+                        };
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    v1: {
+        card: {
+            "user-state": {
+                get: {
+                    body: {};
+                    params: {};
+                    query: {
+                        deckId: string;
+                    };
+                    headers: {};
+                    response: {
+                        200: {
+                            cardId: string;
+                            suspended: boolean;
+                            toReview: boolean;
+                        }[];
+                        422: {
+                            type: "validation";
+                            on: string;
+                            summary?: string;
+                            message?: string;
+                            found?: unknown;
+                            property?: string;
+                            expected?: string;
+                        };
+                    };
+                };
+            };
+        };
+    };
 }, {
     derive: {};
     resolve: {};

package/dist/apps/server/src/modules/card/model.d.ts CHANGED Viewed

@@ -1,4 +1,9 @@
 export declare namespace CardModel {
+    /**
+     * Whether a card counts as "to review" in the deck view.
+     * Uses end-of-day cutoff to match StudyService.getReviewCards behaviour.
+     */
+    function isCardToReview(state: string, suspended: boolean, due: Date | null, now?: Date): boolean;
     const reportBody: import("@sinclair/typebox").TObject<{
         cardId: import("@sinclair/typebox").TString;
         content: import("@sinclair/typebox").TString;
@@ -9,4 +14,16 @@ export declare namespace CardModel {
         cardId: import("@sinclair/typebox").TString;
     }>;
     type ReportQuery = typeof reportQuery.static;
+    const suspendBody: import("@sinclair/typebox").TObject<{
+        cardId: import("@sinclair/typebox").TString;
+    }>;
+    type SuspendBody = typeof suspendBody.static;
+    const suspendQuery: import("@sinclair/typebox").TObject<{
+        cardId: import("@sinclair/typebox").TString;
+    }>;
+    type SuspendQuery = typeof suspendQuery.static;
+    const userStateQuery: import("@sinclair/typebox").TObject<{
+        deckId: import("@sinclair/typebox").TString;
+    }>;
+    type UserStateQuery = typeof userStateQuery.static;
 }

package/dist/apps/server/src/modules/card/service.d.ts CHANGED Viewed

@@ -1,6 +1,13 @@
 import type { CardDemand } from '@vestcards/db-core';
-import type { CardModel } from './model';
+import { CardModel } from './model';
 export declare abstract class CardService {
     static getReport(userId: string, cardId: string): Promise<CardDemand | null>;
+    static suspendCard(userId: string, cardId: string): Promise<boolean>;
+    static unsuspendCard(userId: string, cardId: string): Promise<boolean>;
+    static getUserState(userId: string, deckId: string): Promise<{
+        cardId: string;
+        suspended: boolean;
+        toReview: boolean;
+    }[]>;
     static reportCard(userId: string, body: CardModel.ReportBody): Promise<void>;
 }

package/dist/apps/server/src/modules/study/service.d.ts CHANGED Viewed

@@ -9,11 +9,11 @@ export declare abstract class StudyService {
     static getReviewCards(userId: string, type: StudyType, id?: string, maxToFetch?: number): Promise<import("@vestcards/shared").ISessionCard[]>;
     static getNewCards(userId: string, allocatedNewForToday: number, type: StudyType, id?: string): Promise<import("@vestcards/shared").ISessionCard[]>;
     static getUserDeckStudy(userId: string, deckId: string): Promise<{
-        suspended: boolean;
         id: string;
-        createdAt: Date;
-        userId: string;
         deckId: string;
+        userId: string;
+        suspended: boolean;
+        createdAt: Date;
     }>;
     static getCardReview(userId: string, cardId: string): Promise<CardReview>;
     static gradeCard(userId: string, input: StudyModel.GradeCardBody): Promise<void>;

package/dist/apps/server/src/modules/user/errors.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+export declare class InvalidTokenError extends Error {
+    constructor();
+}

package/dist/apps/server/src/modules/user/index.d.ts CHANGED Viewed

@@ -457,6 +457,68 @@ export declare const userModule: Elysia<"/v1/user", {
             };
         };
     };
+} & {
+    v1: {
+        user: {
+            account: {
+                "delete-request": {
+                    post: {
+                        body: {
+                            email: string;
+                        };
+                        params: {};
+                        query: {};
+                        headers: {};
+                        response: {
+                            200: {
+                                success: boolean;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
+} & {
+    v1: {
+        user: {
+            account: {
+                "confirm-delete": {
+                    post: {
+                        body: {
+                            token: string;
+                        };
+                        params: {};
+                        query: {};
+                        headers: {};
+                        response: {
+                            200: {
+                                success: boolean;
+                            };
+                            422: {
+                                type: "validation";
+                                on: string;
+                                summary?: string;
+                                message?: string;
+                                found?: unknown;
+                                property?: string;
+                                expected?: string;
+                            };
+                        };
+                    };
+                };
+            };
+        };
+    };
 } & {
     v1: {
         user: {

package/dist/apps/server/src/modules/user/model.d.ts CHANGED Viewed

@@ -15,6 +15,12 @@ export declare namespace TopicModel {
     }
 }
 export declare namespace UserModel {
+    const deleteRequestBody: import("@sinclair/typebox").TObject<{
+        email: import("@sinclair/typebox").TString;
+    }>;
+    const confirmDeleteBody: import("@sinclair/typebox").TObject<{
+        token: import("@sinclair/typebox").TString;
+    }>;
     const updateSettingsBody: import("@sinclair/typebox").TObject<{
         learnDailyLimit: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TInteger>;
         university: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TInteger, import("@sinclair/typebox").TNull]>>;

package/dist/apps/server/src/modules/user/service.d.ts CHANGED Viewed

@@ -1,5 +1,6 @@
 import { MembershipStatus } from '@vestcards/shared';
 export declare abstract class UserService {
+    private static getUserById;
     static getLearnDailyLimit(userId: string): Promise<number>;
     static getProfile(userId: string): Promise<{
         id: string;
@@ -23,7 +24,10 @@ export declare abstract class UserService {
         course?: number;
         dayTimeReminder?: string;
     }): Promise<void>;
+    private static sendDeletionEmail;
     static deleteAccount(userId: string): Promise<void>;
+    static requestDeletion(email: string): Promise<void>;
+    static confirmDeletion(token: string): Promise<void>;
     static getMembership(userId: string): Promise<{
         status: MembershipStatus;
         expiresAt: Date | null;

package/dist/apps/server/src/tests/helpers/fixtures.d.ts CHANGED Viewed

@@ -125,6 +125,7 @@ export declare function createCardReview(data: {
     lapses?: number;
     last_review?: Date | null;
 }): Promise<{
+    suspended: boolean;
     id: string;
     createdAt: Date;
     cardId: string;

package/dist/apps/server/src/utils/api.d.ts CHANGED Viewed

@@ -27,5 +27,5 @@ export declare const paginateResults: <T, TOtherData = {}>(data: T[], { size, to
     size: number;
     total: number;
 }, aggregatedData?: TOtherData) => Paginated<T, TOtherData>;
-export { paginationModel, searchModel, sortModel };
 export type { Paginated, Pagination, Search, Sort };
+export { paginationModel, searchModel, sortModel };

package/dist/apps/server/src/utils/select.d.ts CHANGED Viewed

@@ -331,6 +331,23 @@ export declare const sessionCardSelect: {
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        suspended: import("drizzle-orm/pg-core").PgColumn<{
+            name: "suspended";
+            tableName: "card_review";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         createdAt: import("drizzle-orm/pg-core").PgColumn<{
             name: "created_at";
             tableName: "card_review";

package/dist/packages/db-core/src/schema/auth.d.ts CHANGED Viewed

@@ -336,6 +336,66 @@ export declare const session: import("drizzle-orm/pg-core").PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        entitlements: import("drizzle-orm/pg-core").PgColumn<{
+            name: "entitlements";
+            tableName: "session";
+            dataType: "array";
+            columnType: "PgArray";
+            data: string[];
+            driverParam: string | string[];
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: import("drizzle-orm").Column<{
+                name: "entitlements";
+                tableName: "session";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                driverParam: string;
+                notNull: false;
+                hasDefault: false;
+                isPrimaryKey: false;
+                isAutoincrement: false;
+                hasRuntimeDefault: false;
+                enumValues: [string, ...string[]];
+                baseColumn: never;
+                identity: undefined;
+                generated: undefined;
+            }, {}, {}>;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            baseBuilder: import("drizzle-orm/pg-core").PgColumnBuilder<{
+                name: "entitlements";
+                dataType: "string";
+                columnType: "PgText";
+                data: string;
+                enumValues: [string, ...string[]];
+                driverParam: string;
+            }, {}, {}, import("drizzle-orm").ColumnBuilderExtraConfig>;
+            size: undefined;
+        }>;
+        completedProfile: import("drizzle-orm/pg-core").PgColumn<{
+            name: "completed_profile";
+            tableName: "session";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
     };
     dialect: "pg";
 }>;

package/dist/packages/db-core/src/schema/deck.d.ts CHANGED Viewed

@@ -920,6 +920,23 @@ export declare const cardReviews: import("drizzle-orm/pg-core").PgTableWithColum
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        suspended: import("drizzle-orm/pg-core").PgColumn<{
+            name: "suspended";
+            tableName: "card_review";
+            dataType: "boolean";
+            columnType: "PgBoolean";
+            data: boolean;
+            driverParam: boolean;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         userDeckStudyId: import("drizzle-orm/pg-core").PgColumn<{
             name: "user_deck_study_id";
             tableName: "card_review";

package/dist/packages/db-core/src/schema/index.d.ts CHANGED Viewed

@@ -1,3 +1,4 @@
+export * from '../views/deck';
 export * from './auth';
 export * from './blog';
 export * from './data';

package/dist/packages/email-core/src/templates/deleteAccountRequest.d.ts ADDED Viewed

@@ -0,0 +1,8 @@
+export interface EmailDeleteAccountRequestValues {
+    userName: string;
+    confirmUrl: string;
+}
+export declare const EMAILDeleteAccountRequest: ({ userName, confirmUrl }: EmailDeleteAccountRequestValues) => {
+    subject: string;
+    html: string;
+};

package/dist/packages/email-core/src/templates/footer.d.ts CHANGED Viewed

	@@ -1 +1 @@
1	- export declare const EMAILFooter = "\n <div class=\"mt\">\n <img src=\"https://storage.googleapis.com/vestcards-public-bucket/logos/logoIconPrimary.png\" width=\"35\" height=\"25\" alt=\"Logo VestCards\" title=\"Logo VestCards\" style=\"display: block;\">\n <p class=\"text-gray\">\n <a href=\"https://vestcards.com.br\" style=\"color: gray !important;\">Vestcards</a>, 2025. Todos os direitos reservados.\n </p>\n </div>\n";
1	+ export declare const EMAILFooter: string;

package/dist/packages/email-core/src/templates/index.d.ts CHANGED Viewed

@@ -2,6 +2,7 @@ import { type EmailAccountDeletionValues } from './accountDeletion';
 import { type EmailAdminPurchaseAlertValues } from './adminPurchaseAlert';
 import { type EmailCardDemandValues } from './cardDemand';
 import { type EmailCardDemandActionValues } from './cardDemandAction';
+import { type EmailDeleteAccountRequestValues } from './deleteAccountRequest';
 import { type EmailConfirmAccountValues } from './emailVerification';
 import { type EmailForgotPasswordValues } from './forgotPassword';
 import { type EmailPurchaseConfirmationValues } from './purchaseConfirmation';
@@ -19,6 +20,7 @@ export interface EmailTemplateFunctions {
     PurchaseConfirmation: (data: EmailPurchaseConfirmationValues) => EmailTemplateType;
     AdminPurchaseAlert: (data: EmailAdminPurchaseAlertValues) => EmailTemplateType;
     AccountDeletion: (data: EmailAccountDeletionValues) => EmailTemplateType;
+    DeleteAccountRequest: (data: EmailDeleteAccountRequestValues) => EmailTemplateType;
     CardDemand: (data: EmailCardDemandValues) => EmailTemplateType;
     CardDemandAction: (data: EmailCardDemandActionValues) => EmailTemplateType;
 }

package/dist/packages/shared/src/spaced-repetition/config.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export declare const FSRS_RETENTION = 0.9;
+export declare const MAX_CARDS_TO_FETCH = 50;
+export declare const MAX_LEARN_PER_DAY = 200;
+export declare const MAX_NEW_PER_DECK_DAY = 10;
+export declare const THRESHOLD_CARDS_FOR_REFETCH = 10;

package/dist/packages/shared/src/spaced-repetition/fsrs.d.ts ADDED Viewed

@@ -0,0 +1,13 @@
+import { type Card as FSRSCard } from 'ts-fsrs';
+import { type ReviewRating } from '../types/fsrs';
+import type { ICardReview, IReviewLog } from '../types/study';
+export declare const gradeCard: (card: ICardReview, rating: ReviewRating, durationInSeconds: number) => {
+    nextCard: ICardReview;
+    reviewLog: IReviewLog;
+};
+/**
+ * Give a {@link ICardReview}, returns the review {@link Date} for each {@link ReviewRating}.
+ */
+export declare function getReviewDateForEachRating(card: ICardReview): Record<ReviewRating, Date>;
+export declare function mergeFsrsCard(fsrsCard: FSRSCard, card: ICardReview): ICardReview;
+export declare function newCardReview(userDeckStudyId: string, cardId: string): ICardReview;

package/dist/packages/shared/src/spaced-repetition/index.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+export * from './config';
+export * from './fsrs';
+export * from './session-manager';
+export * from './utils';

package/dist/packages/shared/src/spaced-repetition/session-manager.d.ts ADDED Viewed

@@ -0,0 +1,25 @@
+import type { ReviewRating } from '../types/fsrs';
+import type { ISessionCard, ISessionData } from '../types/study';
+export declare const RECENTLY_REVIEWED_SET_SIZE = 5;
+export declare const defaultSessionData: ISessionData;
+export interface SessionProgress {
+    reviewsCompleted: number;
+    correctGrades: number;
+}
+/**
+ * Encapsulates the stateful logic shared across platforms for a flashcard study session:
+ * - Recently-reviewed set (prevents immediate card repetition)
+ * - Progress counters (total reviews, correct grades)
+ * - Next card selection (delegates to getNextCardFromSession)
+ *
+ * Usage: hold an instance in a ref (React/RN), call nextCard() on each render
+ * and onRate() whenever the user grades a card.
+ */
+export declare class FlashcardSessionManager {
+    private recentlyReviewed;
+    private _reviewsCompleted;
+    private _correctGrades;
+    getProgress(): SessionProgress;
+    nextCard(data: ISessionData): ISessionCard | undefined;
+    onRate(cardId: string, rating: ReviewRating): SessionProgress;
+}

package/dist/packages/shared/src/spaced-repetition/utils.d.ts ADDED Viewed

@@ -0,0 +1,26 @@
+import type { ReviewRating } from '../types/fsrs';
+import type { ISessionCard, ISessionData } from '../types/study';
+export declare function getNextCardFromSession(data: ISessionData, recentlyReviewed?: Set<string>): ISessionCard | undefined;
+/**
+ * Remove a card from session data without grading it (e.g. suspend + skip).
+ * Properly decrements the matching stats bucket and total.
+ */
+export declare function skipCardFromSessionData(data: ISessionData, cardId: string): ISessionData;
+/**
+ * Computes the next session data after grading a card.
+ *
+ * Simulates the card grading and if the next review is within ~10 minutes,
+ * keeps the card in the session and updates the respective counter.
+ *
+ * If the card's state is `New`, then the card exists in `newCards`.
+ * If the card is any other state, then the card exists in `reviewCards`.
+ *
+ * @param grade The grade given to the card
+ * @param data The current session data
+ * @param cardId The id of the card that was graded
+ */
+export declare function removeCardFromSessionData(grade: ReviewRating, data: ISessionData, cardId: string): ISessionData;
+/**
+ * Gets the card from the session data.
+ */
+export declare function getSessionCard(sessionData: ISessionData, cardId: string): ISessionCard | undefined;

package/dist/packages/shared/src/theme/tokens/border.d.ts CHANGED Viewed

@@ -8,4 +8,4 @@ declare const borderRadius: {
     button: string;
     input: string;
 };
-export { borderWidth, borderRadius };
+export { borderRadius, borderWidth };

package/dist/packages/shared/src/types/deck.d.ts CHANGED Viewed

@@ -50,3 +50,13 @@ export interface IDeckDetail extends IDeck {
     ownerInfo: IOwnerInfo;
     cards: ICard[];
 }
+export interface ICardUserState {
+    cardId: string;
+    suspended: boolean;
+    toReview: boolean;
+}
+export interface ICardMedia {
+    id: string;
+    side: 'front' | 'back';
+    url: string;
+}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@vestcards/server-types",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "private": false,
   "types": "./dist/index.d.ts",
   "exports": {

package/dist/apps/server/src/modules/study/lib/fsrs.d.ts DELETED Viewed

@@ -1,12 +0,0 @@
-import { type CardReview, type NewCardReview, type NewReviewLog, type Rating } from '@vestcards/db-core';
-import { type Card as FSRSCard } from 'ts-fsrs';
-export declare const gradeCard: (card: CardReview, schemaRating: Rating, durationInSeconds: number) => {
-    nextCard: CardReview;
-    reviewLog: NewReviewLog;
-};
-/**
- * Give a {@link Card}, returns the review {@link Date} for each {@link Rating}.
- */
-export declare function getReviewDateForEachRating(card: CardReview | NewCardReview): Record<Rating, Date>;
-export declare function mergeFsrsCard(fsrsCard: FSRSCard, card: CardReview): CardReview;
-export declare function newCardReview(userDeckStudyId: string, cardId: string): NewCardReview;

/package/dist/apps/server/src/modules/study/{lib/constants.d.ts → constants.d.ts} RENAMED Viewed

File without changes