@vestcards/server-types 0.1.0

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

@@ -0,0 +1,26 @@
+export declare class AppError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    constructor(statusCode: number, code: string, message: string);
+}
+export declare class BadRequestError extends AppError {
+    constructor(message?: string);
+}
+export declare class UnauthorizedError extends AppError {
+    constructor(message?: string);
+}
+export declare class ForbiddenError extends AppError {
+    constructor(message?: string);
+}
+export declare class NotFoundError extends AppError {
+    constructor(message?: string);
+}
+export declare class ConflictError extends AppError {
+    constructor(message?: string);
+}
+export declare class TooManyRequestsError extends AppError {
+    constructor(message?: string);
+}
+export declare class InternalServerError extends AppError {
+    constructor(message?: string);
+}

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

@@ -0,0 +1,373 @@
+import type { Subject } from '@vestcards/shared';
+import { type InferColumnsDataTypes } from 'drizzle-orm';
+export declare const sessionCardSelect: {
+    card: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: string;
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: true;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        question: import("drizzle-orm/pg-core").PgColumn<{
+            name: "question";
+            tableName: "card";
+            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;
+        }, {}, {}>;
+        answer: import("drizzle-orm/pg-core").PgColumn<{
+            name: "answer";
+            tableName: "card";
+            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;
+        }, {}, {}>;
+    };
+    image: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: string;
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: true;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        side: import("drizzle-orm/pg-core").PgColumn<{
+            name: "side";
+            tableName: "card_media";
+            dataType: "string";
+            columnType: "PgText";
+            data: "front" | "back";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["front", "back"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        url: import("drizzle-orm/pg-core").PgColumn<{
+            name: "url";
+            tableName: "card_media";
+            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;
+        }, {}, {}>;
+    };
+    subject: import("drizzle-orm/pg-core").PgColumn<{
+        name: "subject";
+        tableName: "topic";
+        dataType: "string";
+        columnType: "PgText";
+        data: "matemática" | "geografia" | "física" | "biologia" | "história" | "literatura" | "gramática" | "sociologia" | "química" | "filosofia" | "redação" | "artes" | "inglês";
+        driverParam: string;
+        notNull: true;
+        hasDefault: false;
+        isPrimaryKey: false;
+        isAutoincrement: false;
+        hasRuntimeDefault: false;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {
+        $type: "matemática" | "geografia" | "física" | "biologia" | "história" | "literatura" | "gramática" | "sociologia" | "química" | "filosofia" | "redação" | "artes" | "inglês";
+    }>;
+    topicName: import("drizzle-orm/pg-core").PgColumn<{
+        name: "name";
+        tableName: "topic";
+        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;
+    }, {}, {}>;
+    userDeckStudyId: import("drizzle-orm/pg-core").PgColumn<{
+        name: "id";
+        tableName: string;
+        dataType: "string";
+        columnType: "PgText";
+        data: string;
+        driverParam: string;
+        notNull: true;
+        hasDefault: true;
+        isPrimaryKey: true;
+        isAutoincrement: false;
+        hasRuntimeDefault: true;
+        enumValues: [string, ...string[]];
+        baseColumn: never;
+        identity: undefined;
+        generated: undefined;
+    }, {}, {}>;
+    cardReview: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "card_review";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: true;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        due: import("drizzle-orm/pg-core").PgColumn<{
+            name: "due";
+            tableName: "card_review";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        stability: import("drizzle-orm/pg-core").PgColumn<{
+            name: "stability";
+            tableName: "card_review";
+            dataType: "number";
+            columnType: "PgReal";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        difficulty: import("drizzle-orm/pg-core").PgColumn<{
+            name: "difficulty";
+            tableName: "card_review";
+            dataType: "number";
+            columnType: "PgReal";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        elapsed_days: import("drizzle-orm/pg-core").PgColumn<{
+            name: "elapsed_days";
+            tableName: "card_review";
+            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;
+        }, {}, {}>;
+        scheduled_days: import("drizzle-orm/pg-core").PgColumn<{
+            name: "scheduled_days";
+            tableName: "card_review";
+            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;
+        }, {}, {}>;
+        reps: import("drizzle-orm/pg-core").PgColumn<{
+            name: "reps";
+            tableName: "card_review";
+            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;
+        }, {}, {}>;
+        lapses: import("drizzle-orm/pg-core").PgColumn<{
+            name: "lapses";
+            tableName: "card_review";
+            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;
+        }, {}, {}>;
+        state: import("drizzle-orm/pg-core").PgColumn<{
+            name: "state";
+            tableName: "card_review";
+            dataType: "string";
+            columnType: "PgText";
+            data: "New" | "Learning" | "Review" | "Relearning";
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: ["New", "Learning", "Review", "Relearning"];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        last_review: import("drizzle-orm/pg-core").PgColumn<{
+            name: "last_review";
+            tableName: "card_review";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            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: "card_review";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+};
+export type SessionCardSelect = {
+    card: {
+        id: string;
+        question: string;
+        answer: string | null;
+    };
+    image: {
+        id: string;
+        side: 'front' | 'back' | null;
+        url: string | null;
+    } | null;
+    subject: Subject;
+    topicName: string;
+    userDeckStudyId: string;
+    cardReview: InferColumnsDataTypes<typeof sessionCardSelect.cardReview> | null;
+};
+export declare const statsSelect: {
+    new: import("drizzle-orm").SQL<number>;
+    learning: import("drizzle-orm").SQL<number>;
+    review: import("drizzle-orm").SQL<number>;
+};

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

@@ -0,0 +1 @@
+export declare function generateId(): string;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type { App } from './apps/server/src/app';
+export type { Auth } from './apps/server/src/modules/auth/lib';

package/dist/packages/email-core/src/emailProvider.d.ts

@@ -0,0 +1,24 @@
+import { type CreateBatchOptions, type CreateBatchRequestOptions, type CreateEmailOptions, type CreateEmailRequestOptions, Resend } from 'resend';
+import { type EmailTemplate, type EmailTemplateValues } from './templates';
+export declare enum EmailAddress {
+    TRANSACTIONAL = "noreply",
+    MARKETING = "marketing",
+    HEITOR = "heitor"
+}
+export declare enum EmailAudience {
+    ALL = "d94ccf6a-1e25-44f1-8924-3148a7c63db0"
+}
+export declare class EmailProvider {
+    private static instance;
+    transporter?: Resend;
+    private constructor();
+    static getInstance(): EmailProvider;
+    createContact({ email, firstName, lastName }: {
+        email: string;
+        firstName: string;
+        lastName: string;
+    }, audienceId: string): Promise<void>;
+    sendEmailBatch(payload: CreateBatchOptions, options?: CreateBatchRequestOptions): Promise<void>;
+    sendEmail(payload: CreateEmailOptions, options?: CreateEmailRequestOptions): Promise<void>;
+    sendEmailWithTemplate<T extends EmailTemplate>(templateName: T, payload: Omit<CreateEmailOptions, 'html' | 'subject'>, values: EmailTemplateValues<T>, options?: CreateEmailRequestOptions): Promise<void>;
+}

package/dist/packages/email-core/src/emailTemplateBuilder.d.ts

@@ -0,0 +1,4 @@
+export declare const emailTemplateBuilder: (subject: string, template: string) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,7 @@
+export interface EmailAccountDeletionValues {
+    userName: string;
+}
+export declare const EMAILAccountDeletion: ({ userName }: EmailAccountDeletionValues) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,10 @@
+export interface EmailAdminPurchaseAlertValues {
+    customerEmail: string;
+    planName: string;
+    amount: string;
+    paymentMethod: string;
+}
+export declare const EMAILAdminPurchaseAlert: ({ customerEmail, planName, amount, paymentMethod }: EmailAdminPurchaseAlertValues) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,8 @@
+export interface EmailCardDemandValues {
+    userName: string;
+    deckTitle: string;
+}
+export declare const EMAILCardDemand: ({ userName, deckTitle }: EmailCardDemandValues) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,9 @@
+export interface EmailCardDemandActionValues {
+    userName: string;
+    deckTitle: string;
+    action: 'accept' | 'reject' | 'delete';
+}
+export declare const EMAILCardDemandAction: ({ userName, deckTitle, action }: EmailCardDemandActionValues) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,7 @@
+export interface EmailConfirmAccountValues {
+    url: string;
+}
+export declare const EMAILConfirmAccount: ({ url }: EmailConfirmAccountValues) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +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";

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

@@ -0,0 +1,7 @@
+export interface EmailForgotPasswordValues {
+    url: string;
+}
+export declare const EMAILForgotPassword: ({ url }: EmailForgotPasswordValues) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,28 @@
+import { type EmailAccountDeletionValues } from './accountDeletion';
+import { type EmailAdminPurchaseAlertValues } from './adminPurchaseAlert';
+import { type EmailCardDemandValues } from './cardDemand';
+import { type EmailCardDemandActionValues } from './cardDemandAction';
+import { type EmailConfirmAccountValues } from './emailVerification';
+import { type EmailForgotPasswordValues } from './forgotPassword';
+import { type EmailPurchaseConfirmationValues } from './purchaseConfirmation';
+import { type EmailPrePaymentDetailsValues } from './purchasePrePayment';
+import { type EmailPurchaseRefundValues } from './purchaseRefund';
+type EmailTemplateType = {
+    subject: string;
+    html: string;
+};
+export interface EmailTemplateFunctions {
+    ConfirmAccount: (data: EmailConfirmAccountValues) => EmailTemplateType;
+    ForgotPassword: (data: EmailForgotPasswordValues) => EmailTemplateType;
+    PrePaymentDetails: (data: EmailPrePaymentDetailsValues) => EmailTemplateType;
+    PurchaseRefund: (data: EmailPurchaseRefundValues) => EmailTemplateType;
+    PurchaseConfirmation: (data: EmailPurchaseConfirmationValues) => EmailTemplateType;
+    AdminPurchaseAlert: (data: EmailAdminPurchaseAlertValues) => EmailTemplateType;
+    AccountDeletion: (data: EmailAccountDeletionValues) => EmailTemplateType;
+    CardDemand: (data: EmailCardDemandValues) => EmailTemplateType;
+    CardDemandAction: (data: EmailCardDemandActionValues) => EmailTemplateType;
+}
+export type EmailTemplate = keyof EmailTemplateFunctions;
+export type EmailTemplateValues<T extends EmailTemplate> = Parameters<EmailTemplateFunctions[T]>[0];
+export declare function emailTemplatePicker<T extends EmailTemplate>(templateName: T): EmailTemplateFunctions[T];
+export {};

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

@@ -0,0 +1,9 @@
+export interface EmailPurchaseConfirmationValues {
+    planName: string;
+    amount: string;
+    paymentMethod: string;
+}
+export declare const EMAILPurchaseConfirmation: ({ planName, amount, paymentMethod }: EmailPurchaseConfirmationValues) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,9 @@
+export interface EmailPrePaymentDetailsValues {
+    planName: string;
+    amount: string;
+    paymentMethod: string;
+}
+export declare const EMAILPrePaymentDetails: ({ planName, amount, paymentMethod }: EmailPrePaymentDetailsValues) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,7 @@
+export interface EmailPurchaseRefundValues {
+    planName: string;
+}
+export declare const EMAILPurchaseRefund: ({ planName }: EmailPurchaseRefundValues) => {
+    subject: string;
+    html: string;
+};

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

@@ -0,0 +1,2 @@
+export declare const DEFAULT_LOCALE: import("date-fns").Locale;
+export declare const DEFAULT_TZ: "America/Sao_Paulo";

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

@@ -0,0 +1,8 @@
+/** biome-ignore-all lint/style/noRestrictedImports: date-fns imports are allowed in @vestcards/shared only. All other packages must import from @vestcards/shared/date. */
+import { formatDistance as formatDistanceFns, formatDistanceToNow as formatDistanceToNowFns, format as formatFns, formatRelative as formatRelativeFns } from 'date-fns';
+import type { DateValue } from './types';
+export * from 'date-fns';
+export declare function formatDistance(date: DateValue, baseDate?: DateValue, options?: Parameters<typeof formatDistanceFns>[2]): string;
+export declare function formatDistanceToNow(date: DateValue, options?: Parameters<typeof formatDistanceToNowFns>[1]): string;
+export declare function format(date: DateValue, pattern: string, options?: Parameters<typeof formatFns>[2]): string;
+export declare function formatRelative(date: DateValue, baseDate?: DateValue, options?: Parameters<typeof formatRelativeFns>[2]): string;

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

@@ -0,0 +1,9 @@
+import type { DateValue } from './types';
+/**
+ * Format a date in a specific timezone using pre-defined or custom pattern.
+ *
+ * Example:
+ *   formatDateTZ('2025-11-12T12:00:00Z', "HH:mm zzzz", 'America/Sao_Paulo');
+ *   → "09:00 GMT-03:00"
+ */
+export declare function formatDateTZ(date: DateValue, pattern: string, timezone?: string): string;

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

@@ -0,0 +1,2 @@
+import type { DateValue } from './types';
+export declare function toDate(value: DateValue): Date;

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

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview
+ * Public API for date utilities.
+ * Combines timezone-aware formatting helpers with curated re-exports from date-fns.
+ */
+/** biome-ignore-all lint/performance/noBarrelFile: Main entry point for the date folder */
+/** biome-ignore-all lint/performance/noReExportAll: All exports are re-exported from the automatic generated files */
+/** biome-ignore-all lint/style/noRestrictedImports: date-fns imports are allowed in @vestcards/shared only. All other packages must import from @vestcards/shared/date. */
+export * from './constants';
+export * from './fns';
+export * from './format';
+export { toDate } from './helpers';
+export * from './relative';
+export * from './types';

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

@@ -0,0 +1,19 @@
+/** biome-ignore-all lint/style/noRestrictedImports: date-fns imports are allowed in @vestcards/shared only. All other packages must import from @vestcards/shared/date. */
+import { formatDistanceToNow } from 'date-fns';
+import type { DateValue } from './types';
+/**
+ * Formats a date relative to a base date (default: now), with custom separator and timezone.
+ * Example outputs:
+ *   - "Hoje às 10:00"
+ *   - "Ontem às 17:00"
+ *   - "11/11/2025 às 09:00"
+ */
+export declare function formatRelativeDate(date: DateValue, baseDate?: DateValue, separator?: string, timezone?: string): string;
+/**
+ * Formats a date relative to now, with custom separator and timezone.
+ * Example outputs:
+ *   - "Hoje às 10:00"
+ *   - "Ontem às 17:00"
+ *   - "11/11/2025 às 09:00"
+ */
+export declare function formatRelativeDateToNow(date: DateValue, options?: Parameters<typeof formatDistanceToNow>[1]): string;

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

@@ -0,0 +1 @@
+export type DateValue = Date | string | number;

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

@@ -0,0 +1,5 @@
+export * from './types/deck';
+export * from './types/study';
+export * from './types/subject';
+export * from './types/topic';
+export * from './types/user';