@vestcards/server-types 1.3.0 → 1.4.0

package/dist/apps/server/src/modules/vesty/utils.d.ts

@@ -0,0 +1,69 @@
+import type { ChatMiddleware, JSONSchema } from '@tanstack/ai';
+import type { Subject } from '@vestcards/shared';
+import type { VestyModel } from './model';
+export declare const VESTY_SYSTEM_PROMPT: (userName: string) => string;
+export declare const SUBJECT_DETECTION_SCHEMA: JSONSchema;
+export declare const SUBJECT_DETECTION_PROMPT: string;
+export declare const GeminiModelOptions: {
+    thinkingConfig: {
+        includeThoughts: boolean;
+        thinkingBudget: number;
+    };
+};
+export declare const GENERATE_DECK_SYSTEM_PROMPT: (topics: Array<{
+    id: string;
+    name: string;
+}>) => string;
+export declare const GENERATED_DECK_OUTPUT_SCHEMA: JSONSchema;
+type DeckTopic = {
+    id: string;
+    name: string;
+};
+type StructuredOutputAdapter = {
+    structuredOutput: (options: {
+        chatOptions: {
+            model: string;
+            messages: Array<{
+                role: 'user';
+                content: string;
+            }>;
+            systemPrompts: string[];
+            modelOptions: typeof GeminiModelOptions;
+        };
+        outputSchema: JSONSchema;
+    }) => Promise<{
+        data: unknown;
+    }>;
+};
+export declare function detectDeckSubject(adapter: StructuredOutputAdapter, input: Array<{
+    role: 'user';
+    content: string;
+}>): Promise<Subject | null>;
+export declare function fetchDeckTopics(subject: Subject | null): Promise<DeckTopic[]>;
+export declare function generateDeckFromPrompt(adapter: StructuredOutputAdapter, input: Array<{
+    role: 'user';
+    content: string;
+}>, topicList: DeckTopic[], subject: Subject | null): Promise<VestyModel.GeneratedDeck>;
+export declare function captureAiGeneration(userId: string, props: {
+    input: {
+        role: string;
+        content: string;
+    }[];
+    latency: number;
+    stream: boolean;
+    isError: false;
+} | {
+    input: {
+        role: string;
+        content: string;
+    }[];
+    latency: number;
+    stream: boolean;
+    isError: true;
+    error: string;
+}): void;
+export declare function createAnalyticsMiddleware(userId: string, inputMessages: {
+    role: 'user' | 'assistant';
+    content: string;
+}[]): ChatMiddleware;
+export {};

package/dist/apps/server/src/modules/vesty/vesty.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/apps/server/src/server.d.ts

@@ -1 +1,2 @@
+import './modules/cron';
 import './config/env';

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

@@ -1,4 +1,4 @@
-import { MembershipStatus } from '@vestcards/shared';
+import { type BillingType, type DeckStatus, MembershipStatus } from '@vestcards/shared';
 /**
  * Create a test topic
  */
@@ -22,10 +22,10 @@ export declare function createDeck(data: {
     ownerId: string;
     lastEditedBy?: string;
     free?: boolean;
-    status?: string;
+    status?: DeckStatus;
     keywords?: string[];
 }): Promise<{
-    status: import("@vestcards/shared").DeckStatus;
+    status: DeckStatus;
     id: string;
     createdAt: Date;
     updatedAt: Date;
@@ -82,7 +82,7 @@ export declare function createTestDeck(data: {
         answer: string | null;
         extend: unknown;
     }[];
-    status: import("@vestcards/shared").DeckStatus;
+    status: DeckStatus;
     id: string;
     createdAt: Date;
     updatedAt: Date;
@@ -166,11 +166,13 @@ export declare function deleteOfficialEntity(entityId: string): Promise<void>;
 export declare function createMembership(data: {
     entityId: string;
     status?: MembershipStatus;
+    billingType?: BillingType;
     startedAt?: Date;
     expiresAt?: Date;
+    createdAt?: Date;
 }): Promise<{
-    status: MembershipStatus;
     value: number;
+    status: MembershipStatus;
     id: string;
     entityId: string;
     createdAt: Date;
@@ -180,7 +182,7 @@ export declare function createMembership(data: {
     asaasPaymentId: string;
     asaasInstallmentId: string | null;
     installmentCount: number;
-    billingType: import("@vestcards/shared").BillingType;
+    billingType: BillingType;
     couponCode: string | null;
     idempotencyKey: string | null;
     startedAt: Date | null;

package/dist/apps/server/src/tests/preload/vesty-mock.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -1,4 +1,3 @@
 export { db } from './db';
 export * from './schema';
 export * from './utils';
-export * from './views/deck';

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

@@ -825,6 +825,23 @@ export declare const userSettings: import("drizzle-orm/pg-core").PgTableWithColu
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        timezone: import("drizzle-orm/pg-core").PgColumn<{
+            name: "timezone";
+            tableName: "user_settings";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         university: import("drizzle-orm/pg-core").PgColumn<{
             name: "university";
             tableName: "user_settings";
@@ -876,6 +893,23 @@ export declare const userSettings: import("drizzle-orm/pg-core").PgTableWithColu
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        newCardsPerDeckDailyLimit: import("drizzle-orm/pg-core").PgColumn<{
+            name: "new_cards_per_deck_daily_limit";
+            tableName: "user_settings";
+            dataType: "number";
+            columnType: "PgInteger";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            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: "user_settings";

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

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

package/dist/packages/db-core/src/schema/payment.d.ts

@@ -1,4 +1,4 @@
-import { type BillingType, MembershipStatus } from '@vestcards/shared';
+import { type BillingType, MembershipStatus, PlanType } from '@vestcards/shared';
 import type { InferInsertModel, InferSelectModel } from 'drizzle-orm';
 export declare const customMoneyType: {
     (): import("drizzle-orm/pg-core").PgCustomColumnBuilder<{
@@ -64,6 +64,42 @@ export declare const plan: import("drizzle-orm/pg-core").PgTableWithColumns<{
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        planType: import("drizzle-orm/pg-core").PgColumn<{
+            name: "plan_type";
+            tableName: "plan";
+            dataType: "string";
+            columnType: "PgText";
+            data: PlanType;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            $type: PlanType;
+        }>;
+        active: import("drizzle-orm/pg-core").PgColumn<{
+            name: "active";
+            tableName: "plan";
+            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;
+        }, {}, {}>;
         accessTimeInMonths: import("drizzle-orm/pg-core").PgColumn<{
             name: "access_time_in_months";
             tableName: "plan";

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

@@ -5,6 +5,7 @@ import { type EmailCardDemandActionValues } from './cardDemandAction';
 import { type EmailDeleteAccountRequestValues } from './deleteAccountRequest';
 import { type EmailConfirmAccountValues } from './emailVerification';
 import { type EmailForgotPasswordValues } from './forgotPassword';
+import { type EmailPaymentExpiryReminderValues } from './paymentExpiryReminder';
 import { type EmailPurchaseConfirmationValues } from './purchaseConfirmation';
 import { type EmailPrePaymentDetailsValues } from './purchasePrePayment';
 import { type EmailPurchaseRefundValues } from './purchaseRefund';
@@ -23,6 +24,7 @@ export interface EmailTemplateFunctions {
     DeleteAccountRequest: (data: EmailDeleteAccountRequestValues) => EmailTemplateType;
     CardDemand: (data: EmailCardDemandValues) => EmailTemplateType;
     CardDemandAction: (data: EmailCardDemandActionValues) => EmailTemplateType;
+    PaymentExpiryReminder: (data: EmailPaymentExpiryReminderValues) => EmailTemplateType;
 }
 export type EmailTemplate = keyof EmailTemplateFunctions;
 export type EmailTemplateValues<T extends EmailTemplate> = Parameters<EmailTemplateFunctions[T]>[0];

package/dist/packages/email-core/src/templates/paymentExpiryReminder.d.ts

@@ -0,0 +1,9 @@
+export interface EmailPaymentExpiryReminderValues {
+    name: string;
+    paymentMethod: string;
+    expiresAt: string;
+}
+export declare const EMAILPaymentExpiryReminder: ({ name, paymentMethod, expiresAt }: EmailPaymentExpiryReminderValues) => {
+    subject: string;
+    html: string;
+};

package/dist/packages/shared/src/date/index.d.ts

@@ -11,4 +11,5 @@ export * from './fns';
 export * from './format';
 export { toDate } from './helpers';
 export * from './relative';
+export * from './timezone';
 export * from './types';

package/dist/packages/shared/src/date/timezone.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Returns true if `tz` is a valid IANA timezone identifier recognised by the
+ * runtime's Intl API (e.g. "America/Sao_Paulo", "America/Manaus", "UTC").
+ */
+export declare function isValidIANATimezone(tz: string): boolean;
+/**
+ * Returns `tz` if it is a valid IANA timezone, otherwise falls back to
+ * `DEFAULT_TZ` ("America/Sao_Paulo"). Use this as a safety net when reading
+ * timezone values from the database to avoid crashing on corrupted data.
+ */
+export declare function safeTimezone(tz: string | null | undefined): string;
+/**
+ * Returns the ISO weekday index (Mon = 0 … Sun = 6) for `date` evaluated in
+ * `timezone`. Uses `toZonedTime` so the result is always consistent with the
+ * given timezone regardless of the server's local clock.
+ */
+export declare function getWeekdayIndex(date: Date, timezone: string): number;
+/**
+ * Returns the UTC `Date` for the start of `date`'s day in `timezone` (00:00:00.000 local → UTC).
+ */
+export declare function startOfDayInTz(date: Date, timezone: string): Date;
+/**
+ * Returns the UTC `Date` for the end of `date`'s day in `timezone` (23:59:59.999 local → UTC).
+ */
+export declare function endOfDayInTz(date: Date, timezone: string): Date;
+/**
+ * Returns the UTC `Date` that corresponds to Monday midnight (00:00:00) in `timezone`.
+ */
+export declare function getWeekStartUTC(now: Date, timezone: string): Date;

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

@@ -1,5 +1,20 @@
 export declare const FSRS_RETENTION = 0.9;
+export declare const FSRS_RETRIEVABILITY_DECAY = 0.1542;
+export declare const FSRS_RETENTION_FACTOR: number;
 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 LEARNING_SETTINGS_LIMITS: {
+    readonly learnDailyLimit: {
+        readonly recommended: 200;
+        readonly min: 100;
+        readonly max: 500;
+        readonly step: 50;
+    };
+    readonly newCardsPerDeckDailyLimit: {
+        readonly recommended: 10;
+        readonly min: 1;
+        readonly max: 50;
+        readonly step: 5;
+    };
+};
 export declare const THRESHOLD_CARDS_FOR_REFETCH = 10;
+export declare const isRecommendedLearningSettings: (learnDailyLimit: number | null, newCardsPerDeckDailyLimit: number | null) => boolean;

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

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

package/dist/packages/shared/src/spaced-repetition/retention.d.ts

@@ -0,0 +1,2 @@
+export declare function calculateRetrievability(elapsedDays: number, stability: number): number;
+export declare function calculateRetentionPercentage(elapsedDays: number, stability: number): number;

package/dist/packages/shared/src/theme/tokens/colors.d.ts

@@ -19,10 +19,10 @@ declare const colors: {
         readonly 12: string;
         readonly a1: string;
         readonly a2: string;
+        readonly a3: string;
         readonly a10: string;
-        readonly a4: string;
         readonly a5: string;
-        readonly a3: string;
+        readonly a4: string;
         readonly a6: string;
         readonly a7: string;
         readonly a8: string;
@@ -50,10 +50,10 @@ declare const colors: {
         readonly 12: string;
         readonly a1: string;
         readonly a2: string;
+        readonly a3: string;
         readonly a10: string;
-        readonly a4: string;
         readonly a5: string;
-        readonly a3: string;
+        readonly a4: string;
         readonly a6: string;
         readonly a7: string;
         readonly a8: string;
@@ -81,10 +81,10 @@ declare const colors: {
         readonly 12: string;
         readonly a1: string;
         readonly a2: string;
+        readonly a3: string;
         readonly a10: string;
-        readonly a4: string;
         readonly a5: string;
-        readonly a3: string;
+        readonly a4: string;
         readonly a6: string;
         readonly a7: string;
         readonly a8: string;
@@ -112,10 +112,10 @@ declare const colors: {
         readonly 12: string;
         readonly a1: string;
         readonly a2: string;
+        readonly a3: string;
         readonly a10: string;
-        readonly a4: string;
         readonly a5: string;
-        readonly a3: string;
+        readonly a4: string;
         readonly a6: string;
         readonly a7: string;
         readonly a8: string;
@@ -143,10 +143,10 @@ declare const colors: {
         readonly 12: string;
         readonly a1: string;
         readonly a2: string;
+        readonly a3: string;
         readonly a10: string;
-        readonly a4: string;
         readonly a5: string;
-        readonly a3: string;
+        readonly a4: string;
         readonly a6: string;
         readonly a7: string;
         readonly a8: string;
@@ -174,10 +174,10 @@ declare const colors: {
         readonly 12: string;
         readonly a1: string;
         readonly a2: string;
+        readonly a3: string;
         readonly a10: string;
-        readonly a4: string;
         readonly a5: string;
-        readonly a3: string;
+        readonly a4: string;
         readonly a6: string;
         readonly a7: string;
         readonly a8: string;
@@ -205,10 +205,10 @@ declare const colors: {
         readonly 12: string;
         readonly a1: string;
         readonly a2: string;
+        readonly a3: string;
         readonly a10: string;
-        readonly a4: string;
         readonly a5: string;
-        readonly a3: string;
+        readonly a4: string;
         readonly a6: string;
         readonly a7: string;
         readonly a8: string;
@@ -236,10 +236,10 @@ declare const colors: {
         readonly 12: string;
         readonly a1: string;
         readonly a2: string;
+        readonly a3: string;
         readonly a10: string;
-        readonly a4: string;
         readonly a5: string;
-        readonly a3: string;
+        readonly a4: string;
         readonly a6: string;
         readonly a7: string;
         readonly a8: string;
@@ -267,10 +267,10 @@ declare const colors: {
         readonly 12: string;
         readonly a1: string;
         readonly a2: string;
+        readonly a3: string;
         readonly a10: string;
-        readonly a4: string;
         readonly a5: string;
-        readonly a3: string;
+        readonly a4: string;
         readonly a6: string;
         readonly a7: string;
         readonly a8: string;

package/dist/packages/shared/src/types/index.d.ts

@@ -7,3 +7,4 @@ export * from './studyPlan';
 export * from './subject';
 export * from './topic';
 export * from './user';
+export * from './vesty';

package/dist/packages/shared/src/types/permissions.d.ts

@@ -48,6 +48,7 @@ export declare const PERMISSIONS: {
     };
     readonly VESTY: {
         readonly CHAT: "vesty:chat";
+        readonly INSIGHTS: "vesty:insights";
     };
     readonly STUDY: {
         readonly READ: "study:read";
@@ -98,6 +99,7 @@ export declare const Permission: {
     readonly BLOGPOST_UPDATE: "blogpost:update";
     readonly BLOGPOST_DELETE: "blogpost:delete";
     readonly VESTY_CHAT: "vesty:chat";
+    readonly VESTY_INSIGHTS: "vesty:insights";
     readonly STUDY_READ: "study:read";
     readonly STUDY_WRITE: "study:write";
     readonly LIBRARY_READ: "library:read";

package/dist/packages/shared/src/types/user.d.ts

@@ -4,6 +4,22 @@ export declare enum UserRole {
     User = "user"
 }
 export type UserScopeRole = (typeof UserRole)[keyof typeof UserRole];
+export interface IUserProfile {
+    id: string;
+    name: string;
+    surname: string;
+    email: string;
+    image: string | null;
+    role: UserScopeRole;
+    goal: string | null;
+    learnDailyLimit: number | null;
+    newCardsPerDeckDailyLimit: number | null;
+    universityId: number | null;
+    universityName: string | null;
+    courseId: number | null;
+    courseName: string | null;
+    authProviders: string[];
+}
 export declare enum OrganizationRole {
     Owner = "owner",
     Admin = "admin",
@@ -20,3 +36,7 @@ export declare enum MembershipStatus {
     Expired = "expired"
 }
 export type BillingType = 'PIX' | 'CREDIT_CARD' | 'BOLETO';
+export declare enum PlanType {
+    Fixed = "FIXED",
+    Seasonal = "SEASONAL"
+}

package/dist/packages/shared/src/types/vesty.d.ts

@@ -0,0 +1,7 @@
+import type { Subject } from './deck';
+export interface IVestyChatRelatedDeck {
+    id: string;
+    title: string;
+    subject: Subject;
+    topicName: string;
+}

package/dist/packages/utils/src/logger/index.d.ts

@@ -1,2 +1,3 @@
 import { logger } from './logger';
-export { logger };
+import { flushPostHogLogs, shutdownPostHogLogs } from './posthog';
+export { flushPostHogLogs, logger, shutdownPostHogLogs };

package/dist/packages/utils/src/logger/posthog.d.ts

@@ -0,0 +1,20 @@
+import { type LogAttributes } from '@opentelemetry/api-logs';
+type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+type PinoBindings = Record<string, unknown>;
+interface PostHogLogsConfig {
+    endpoint: string;
+    projectToken: string;
+    resourceAttributes: Record<string, string>;
+}
+interface FlushOptions {
+    timeoutMs?: number;
+}
+export declare function emitPostHogLog(level: LogLevel, args: unknown[], bindings?: PinoBindings): void;
+export declare function flushPostHogLogs(options?: FlushOptions): Promise<void>;
+export declare function shutdownPostHogLogs(): Promise<void>;
+export declare function getPostHogLogsConfig(env: NodeJS.ProcessEnv): PostHogLogsConfig | undefined;
+export declare function parsePinoArgs(args: unknown[], bindings: PinoBindings): {
+    body: string;
+    attributes: LogAttributes;
+};
+export {};

package/package.json

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

package/dist/apps/server/src/modules/study/constants.d.ts

@@ -1,5 +0,0 @@
-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/db-core/src/views/deck.d.ts

@@ -1,79 +0,0 @@
-export declare const userCurrentReviewStreak: import("drizzle-orm/pg-core").PgViewWithSelection<"user_current_review_streak", false, {
-    user_id: import("drizzle-orm/pg-core").PgColumn<{
-        name: "user_id";
-        tableName: "user_current_review_streak";
-        dataType: "string";
-        columnType: "PgText";
-        data: string;
-        driverParam: string;
-        notNull: true;
-        hasDefault: false;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: [string, ...string[]];
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-    }, {}, {}>;
-    current_streak: import("drizzle-orm/pg-core").PgColumn<{
-        name: "current_streak";
-        tableName: "user_current_review_streak";
-        dataType: "number";
-        columnType: "PgInteger";
-        data: number;
-        driverParam: string | number;
-        notNull: true;
-        hasDefault: false;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: undefined;
-        baseColumn: never;
-        identity: undefined;
-        generated: undefined;
-    }, {}, {}>;
-    week_activity: import("drizzle-orm/pg-core").PgColumn<{
-        name: "week_activity";
-        tableName: "user_current_review_streak";
-        dataType: "array";
-        columnType: "PgArray";
-        data: boolean[];
-        driverParam: string | boolean[];
-        notNull: true;
-        hasDefault: false;
-        isPrimaryKey: false;
-        isAutoincrement: false;
-        hasRuntimeDefault: false;
-        enumValues: undefined;
-        baseColumn: import("drizzle-orm").Column<{
-            name: "week_activity";
-            tableName: "user_current_review_streak";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            notNull: false;
-            hasDefault: false;
-            isPrimaryKey: false;
-            isAutoincrement: false;
-            hasRuntimeDefault: false;
-            enumValues: undefined;
-            baseColumn: never;
-            identity: undefined;
-            generated: undefined;
-        }, {}, {}>;
-        identity: undefined;
-        generated: undefined;
-    }, {}, {
-        baseBuilder: import("drizzle-orm/pg-core").PgColumnBuilder<{
-            name: "week_activity";
-            dataType: "boolean";
-            columnType: "PgBoolean";
-            data: boolean;
-            driverParam: boolean;
-            enumValues: undefined;
-        }, {}, {}, import("drizzle-orm").ColumnBuilderExtraConfig>;
-        size: undefined;
-    }>;
-}>;