@vestcards/server-types 1.3.0 → 1.5.0

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

@@ -1,9 +1,9 @@
-export * from '../views/deck';
 export * from './auth';
 export * from './blog';
 export * from './data';
 export * from './deck';
 export * from './entity';
+export * from './exams';
 export * from './marketing';
 export * from './organization';
 export * from './payment';

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/db-core/src/tracing.d.ts

@@ -0,0 +1,2 @@
+import { Pool, type PoolConfig } from 'pg';
+export declare function createTracedPool(config: PoolConfig): Pool;

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/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const VESTCARDS_OWNER_ID = "vestcards";
+export declare const VESTCARDS_ORGANIZATION_ID = "vestcards";

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/index.d.ts

@@ -1,2 +1,3 @@
+export * from './constants';
 export * from './eden';
 export * from './types';

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/spaced-repetition/session-manager.d.ts

@@ -17,9 +17,12 @@ export interface SessionProgress {
  */
 export declare class FlashcardSessionManager {
     private recentlyReviewed;
+    private reviewHistory;
     private _reviewsCompleted;
     private _correctGrades;
     getProgress(): SessionProgress;
     nextCard(data: ISessionData): ISessionCard | undefined;
     onRate(cardId: string, rating: ReviewRating): SessionProgress;
+    undoRate(cardId: string, rating: ReviewRating): SessionProgress;
+    private rebuildStateFromHistory;
 }

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

@@ -18,16 +18,16 @@ declare const colors: {
         readonly 11: string;
         readonly 12: string;
         readonly a1: string;
+        readonly a3: string;
         readonly a2: string;
+        readonly a11: 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;
         readonly a9: string;
-        readonly a11: string;
         readonly a12: string;
         readonly DEFAULT: string;
         readonly hover: string;
@@ -49,16 +49,16 @@ declare const colors: {
         readonly 11: string;
         readonly 12: string;
         readonly a1: string;
+        readonly a3: string;
         readonly a2: string;
+        readonly a11: 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;
         readonly a9: string;
-        readonly a11: string;
         readonly a12: string;
         readonly DEFAULT: string;
         readonly hover: string;
@@ -80,16 +80,16 @@ declare const colors: {
         readonly 11: string;
         readonly 12: string;
         readonly a1: string;
+        readonly a3: string;
         readonly a2: string;
+        readonly a11: 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;
         readonly a9: string;
-        readonly a11: string;
         readonly a12: string;
         readonly DEFAULT: string;
         readonly hover: string;
@@ -111,16 +111,16 @@ declare const colors: {
         readonly 11: string;
         readonly 12: string;
         readonly a1: string;
+        readonly a3: string;
         readonly a2: string;
+        readonly a11: 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;
         readonly a9: string;
-        readonly a11: string;
         readonly a12: string;
         readonly DEFAULT: string;
         readonly hover: string;
@@ -142,16 +142,16 @@ declare const colors: {
         readonly 11: string;
         readonly 12: string;
         readonly a1: string;
+        readonly a3: string;
         readonly a2: string;
+        readonly a11: 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;
         readonly a9: string;
-        readonly a11: string;
         readonly a12: string;
         readonly DEFAULT: string;
         readonly hover: string;
@@ -173,16 +173,16 @@ declare const colors: {
         readonly 11: string;
         readonly 12: string;
         readonly a1: string;
+        readonly a3: string;
         readonly a2: string;
+        readonly a11: 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;
         readonly a9: string;
-        readonly a11: string;
         readonly a12: string;
         readonly DEFAULT: string;
         readonly hover: string;
@@ -204,16 +204,16 @@ declare const colors: {
         readonly 11: string;
         readonly 12: string;
         readonly a1: string;
+        readonly a3: string;
         readonly a2: string;
+        readonly a11: 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;
         readonly a9: string;
-        readonly a11: string;
         readonly a12: string;
         readonly DEFAULT: string;
         readonly hover: string;
@@ -235,16 +235,16 @@ declare const colors: {
         readonly 11: string;
         readonly 12: string;
         readonly a1: string;
+        readonly a3: string;
         readonly a2: string;
+        readonly a11: 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;
         readonly a9: string;
-        readonly a11: string;
         readonly a12: string;
         readonly DEFAULT: string;
         readonly hover: string;
@@ -266,16 +266,16 @@ declare const colors: {
         readonly 11: string;
         readonly 12: string;
         readonly a1: string;
+        readonly a3: string;
         readonly a2: string;
+        readonly a11: 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;
         readonly a9: string;
-        readonly a11: string;
         readonly a12: string;
         readonly DEFAULT: string;
         readonly hover: 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,11 +48,15 @@ export declare const PERMISSIONS: {
     };
     readonly VESTY: {
         readonly CHAT: "vesty:chat";
+        readonly INSIGHTS: "vesty:insights";
     };
     readonly STUDY: {
         readonly READ: "study:read";
         readonly WRITE: "study:write";
     };
+    readonly EXAM: {
+        readonly READ: "exam:read";
+    };
     readonly LIBRARY: {
         readonly READ: "library:read";
         readonly WRITE: "library:write";
@@ -98,8 +102,10 @@ 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 EXAM_READ: "exam:read";
     readonly LIBRARY_READ: "library:read";
     readonly LIBRARY_WRITE: "library:write";
     readonly LIBRARY_WRITE_PREMIUM: "library:write:premium";

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/config.d.ts

@@ -0,0 +1,12 @@
+export interface PostHogLogsConfig {
+    endpoint: string;
+    projectToken: string;
+    resourceAttributes: Record<string, string>;
+}
+export interface PostHogTracesConfig {
+    endpoint: string;
+    projectToken: string;
+    resourceAttributes: Record<string, string>;
+}
+export declare function getPostHogLogsConfig(env: NodeJS.ProcessEnv): PostHogLogsConfig | undefined;
+export declare function getPostHogTracesConfig(env: NodeJS.ProcessEnv): PostHogTracesConfig | undefined;

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

@@ -1,2 +1,6 @@
 import { logger } from './logger';
-export { logger };
+import { flushPostHogLogs, shutdownPostHogLogs } from './posthog';
+import type { TraceAttributes } from './tracing';
+import { finishPostHogTraceSpan, flushPostHogTraces, getActivePostHogTraceSpan, setPostHogTraceAttributes, shutdownPostHogTraces, startActivePostHogTraceSpan, startPostHogTraceSpan } from './tracing';
+export type { TraceAttributes };
+export { finishPostHogTraceSpan, flushPostHogLogs, flushPostHogTraces, getActivePostHogTraceSpan, logger, setPostHogTraceAttributes, shutdownPostHogLogs, shutdownPostHogTraces, startActivePostHogTraceSpan, startPostHogTraceSpan, };

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

@@ -0,0 +1,7 @@
+import type { LogAttributes } from '@opentelemetry/api-logs';
+export type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export type PinoBindings = Record<string, unknown>;
+export declare function parsePinoArgs(args: unknown[], bindings: PinoBindings): {
+    body: string;
+    attributes: LogAttributes;
+};

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

@@ -0,0 +1,16 @@
+import { getPostHogLogsConfig } from './config';
+import { type LogLevel, type PinoBindings, parsePinoArgs } from './pino';
+import { type FlushOptions } from './timeout';
+export declare class PostHogLogBridge {
+    private readonly logger;
+    private readonly provider;
+    constructor(env?: NodeJS.ProcessEnv);
+    emit(level: LogLevel, args: unknown[], bindings?: PinoBindings): void;
+    flush(options?: FlushOptions): Promise<void>;
+    shutdown(): Promise<void>;
+    private createProvider;
+}
+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 { getPostHogLogsConfig, parsePinoArgs };

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

@@ -0,0 +1,4 @@
+export interface FlushOptions {
+    timeoutMs?: number;
+}
+export declare function withTimeout(promise: Promise<void>, timeoutMs: number | undefined): Promise<void>;

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

@@ -0,0 +1,34 @@
+import { type AttributeValue, type Span } from '@opentelemetry/api';
+import { getPostHogTracesConfig } from './config';
+import { type FlushOptions } from './timeout';
+export type TraceAttributes = Record<string, AttributeValue>;
+type SpanKindName = 'internal' | 'server' | 'client' | 'producer' | 'consumer';
+interface StartTraceSpanOptions {
+    kind?: SpanKindName;
+}
+interface FinishTraceSpanOptions {
+    attributes?: TraceAttributes;
+    error?: unknown;
+    statusCode?: number | string;
+}
+export declare class PostHogTracer {
+    private readonly provider;
+    private readonly tracer;
+    constructor(env?: NodeJS.ProcessEnv);
+    startSpan(name: string, attributes?: TraceAttributes, options?: StartTraceSpanOptions): Span | undefined;
+    startActiveSpan<T>(name: string, attributes: TraceAttributes, options: StartTraceSpanOptions, callback: () => T): T;
+    getActiveSpan(): Span | undefined;
+    setAttributes(span: unknown, attributes: TraceAttributes): void;
+    finishSpan(span: unknown, options?: FinishTraceSpanOptions): void;
+    flush(options?: FlushOptions): Promise<void>;
+    shutdown(): Promise<void>;
+    private createProvider;
+}
+export declare function startPostHogTraceSpan(name: string, attributes?: TraceAttributes, options?: StartTraceSpanOptions): Span | undefined;
+export declare function startActivePostHogTraceSpan<T>(name: string, attributes: TraceAttributes, options: StartTraceSpanOptions, callback: () => T): T;
+export declare function getActivePostHogTraceSpan(): Span | undefined;
+export declare function setPostHogTraceAttributes(span: unknown, attributes: TraceAttributes): void;
+export declare function finishPostHogTraceSpan(span: unknown, options?: FinishTraceSpanOptions): void;
+export declare function flushPostHogTraces(options?: FlushOptions): Promise<void>;
+export declare function shutdownPostHogTraces(): Promise<void>;
+export { getPostHogTracesConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vestcards/server-types",
-  "version": "1.3.0",
+  "version": "1.5.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;
-    }>;
-}>;