@vestcards/server-types 1.3.0 → 1.5.0

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

@@ -0,0 +1,35 @@
+export declare namespace VestyModel {
+    const chatBody: import("@sinclair/typebox").TObject<{
+        messages: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TObject<{
+            role: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TLiteral<"user">, import("@sinclair/typebox").TLiteral<"assistant">]>;
+            parts: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TAny>;
+        }>>;
+        data: import("@sinclair/typebox").TOptional<import("@sinclair/typebox").TRecord<import("@sinclair/typebox").TString, import("@sinclair/typebox").TAny>>;
+    }>;
+    type ChatBody = typeof chatBody.static;
+    const generateDeckBody: import("@sinclair/typebox").TObject<{
+        prompt: import("@sinclair/typebox").TString;
+    }>;
+    type GenerateDeckBody = typeof generateDeckBody.static;
+    type GeneratedDeck = {
+        title: string;
+        description: string;
+        subject: string | null;
+        topicId: string | null;
+        cards: Array<{
+            question: string;
+            answer: string;
+        }>;
+    };
+    type InsightsResult = {
+        insights: Array<{
+            title: string;
+            description: string;
+            tag: string;
+        }>;
+    };
+    function toModelMessages(messages: ChatBody['messages']): {
+        role: 'user' | 'assistant';
+        content: string;
+    }[];
+}

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

@@ -0,0 +1,40 @@
+/**
+ * Heuristically decides whether a Gemini provider error is transient and worth
+ * retrying (overload, rate limit, timeout) versus a permanent failure (bad
+ * request, schema mismatch) that a retry or different model won't fix.
+ */
+export declare function isRetryableGeminiError(error: unknown): boolean;
+type RetryConfig = {
+    attemptsPerModel: number;
+    baseDelayMs: number;
+    maxDelayMs: number;
+};
+export type FallbackOptions<TModel extends string = string> = Partial<RetryConfig> & {
+    /** Invoked before a backoff wait or a fallback to the next model. */
+    onRetry?: (info: {
+        model: TModel;
+        attempt: number;
+        error: unknown;
+        nextModel?: TModel;
+    }) => void;
+};
+/**
+ * Runs `run` against each model in order. Retries the same model with backoff
+ * on transient errors, then falls back to the next model, and finally rethrows
+ * the last error if every model is exhausted. Non-retryable errors short-circuit
+ * immediately. Returns the result together with the model that produced it.
+ */
+export declare function runWithModelFallback<TModel extends string, TResult>(models: readonly TModel[], run: (model: TModel) => Promise<TResult>, options?: FallbackOptions<TModel>): Promise<{
+    result: TResult;
+    model: TModel;
+}>;
+/**
+ * Streaming counterpart of {@link runWithModelFallback}. Wraps an
+ * `AsyncIterable` source and retries / falls back to the next model — but only
+ * while no chunk has been emitted yet, since a stream cannot be safely restarted
+ * once the client has started receiving content. A `503` overload surfaces at
+ * connection time (before the first chunk), which is exactly the case this
+ * covers.
+ */
+export declare function streamWithModelFallback<TModel extends string, TChunk>(models: readonly TModel[], createStream: (model: TModel) => AsyncIterable<TChunk>, options?: FallbackOptions<TModel>): AsyncIterable<TChunk>;
+export {};

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

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

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

@@ -0,0 +1,6 @@
+import { VestyModel } from './model';
+export declare abstract class VestyService {
+    static generateDeck(prompt: string, userId: string): Promise<VestyModel.GeneratedDeck>;
+    static generateInsights(userId: string): Promise<VestyModel.InsightsResult>;
+    static createChatStream(messages: VestyModel.ChatBody['messages'], userName: string, userId: string): Promise<Response>;
+}

package/dist/apps/server/src/modules/vesty/services/generate-deck.d.ts

@@ -0,0 +1,2 @@
+import type { VestyModel } from '../model';
+export declare function executeGenerateDeck(prompt: string, userId: string): Promise<VestyModel.GeneratedDeck>;

package/dist/apps/server/src/modules/vesty/services/insights.d.ts

@@ -0,0 +1,3 @@
+import type { VestyModel } from '../model';
+export declare const DEFAULT_INSIGHTS_QUANTITY = 5;
+export declare function executeGenerateInsights(userId: string, quantity: number): Promise<VestyModel.InsightsResult>;

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

@@ -0,0 +1,11 @@
+import z from 'zod';
+export declare const searchDecksTool: import("@tanstack/ai").ServerTool<z.ZodObject<{
+    query: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    relatedDecks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        subject: z.ZodString;
+        topicName: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>, "buscar_decks">;

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

@@ -0,0 +1,62 @@
+import type { ChatMiddleware, JSONSchema } from '@tanstack/ai';
+import { GeminiTextAdapter, type GeminiTextModel } from '@tanstack/ai-gemini';
+import type { Subject } from '@vestcards/shared';
+import type { VestyModel } from './model';
+export declare const VESTY_PRIMARY_MODEL: "gemini-3.1-pro-preview" | "gemini-3-pro-preview" | "gemini-3-flash-preview" | "gemini-3.1-flash-lite-preview" | "gemini-2.5-pro" | "gemini-2.5-flash" | "gemini-2.5-flash-preview-09-2025" | "gemini-2.5-flash-lite" | "gemini-2.5-flash-lite-preview-09-2025" | "gemini-2.0-flash" | "gemini-2.0-flash-lite";
+export declare const VESTY_FALLBACK_MODEL: "gemini-3.1-pro-preview" | "gemini-3-pro-preview" | "gemini-3-flash-preview" | "gemini-3.1-flash-lite-preview" | "gemini-2.5-pro" | "gemini-2.5-flash" | "gemini-2.5-flash-preview-09-2025" | "gemini-2.5-flash-lite" | "gemini-2.5-flash-lite-preview-09-2025" | "gemini-2.0-flash" | "gemini-2.0-flash-lite";
+export declare const VESTY_MODELS: readonly GeminiTextModel[];
+export declare function getGeminiAdapter(model: GeminiTextModel): GeminiTextAdapter<GeminiTextModel>;
+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;
+};
+export declare function detectDeckSubject(model: GeminiTextModel, input: Array<{
+    role: 'user';
+    content: string;
+}>): Promise<Subject | null>;
+export declare function fetchDeckTopics(subject: Subject | null): Promise<DeckTopic[]>;
+export declare function generateDeckFromPrompt(model: GeminiTextModel, input: Array<{
+    role: 'user';
+    content: string;
+}>, topicList: DeckTopic[], subject: Subject | null): Promise<VestyModel.GeneratedDeck>;
+export declare function captureAiGeneration(userId: string, props: {
+    traceId: string;
+    model: string;
+    input: {
+        role: string;
+        content: string;
+    }[];
+    latency: number;
+    stream: boolean;
+    isError: false;
+} | {
+    traceId: string;
+    model: string;
+    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;
+}[], traceId: string, model: 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/helpers/index.d.ts

@@ -1,3 +1,4 @@
 export * from './auth-helpers';
 export * from './fixtures';
 export * from './http-helpers';
+export * from './redis-mock';

package/dist/apps/server/src/tests/helpers/redis-mock.d.ts

@@ -0,0 +1,33 @@
+interface RedisSetOptions {
+    ex?: number;
+}
+interface RedisSetCall {
+    key: string;
+    value: unknown;
+    options?: RedisSetOptions;
+}
+declare class TestRedis {
+    private store;
+    private readError;
+    private writeError;
+    readonly getCalls: string[];
+    readonly setCalls: RedisSetCall[];
+    readonly delCalls: string[];
+    readonly client: {
+        get: (key: string) => Promise<unknown>;
+        set: (key: string, value: unknown, options?: RedisSetOptions) => Promise<string>;
+        del: (key: string) => Promise<number>;
+    };
+    seed(key: string, value: unknown): void;
+    read(key: string): unknown;
+    failReads(error?: Error): void;
+    failWrites(error?: Error): void;
+    clearFailures(): void;
+    clearCalls(): void;
+    reset(): void;
+    private get;
+    private set;
+    private del;
+}
+export declare const testRedis: TestRedis;
+export {};

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

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

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

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

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

@@ -1,4 +1,3 @@
-import { Pool } from 'pg';
 export declare const db: import("drizzle-orm/node-postgres").NodePgDatabase<Record<string, never>> & {
-    $client: Pool;
+    $client: import("pg").Pool;
 };

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

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

package/dist/packages/db-core/src/queries/decks.d.ts

@@ -0,0 +1,2 @@
+export declare const isOfficialDeckFilterQuery: () => import("drizzle-orm").SQL<unknown>;
+export declare const deckOwnerFilterQuery: (ownerId: string) => import("drizzle-orm").SQL<unknown>;

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

@@ -0,0 +1 @@
+export * from './decks';

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";