@vritti/api-sdk 0.2.3 → 0.2.5

package/dist/index.d.cts

@@ -5,26 +5,13 @@ import { Reflector } from '@nestjs/core';
 import { JwtService, JwtModuleOptions, JwtSignOptions } from '@nestjs/jwt';
 import { FastifyRequest, FastifyReply } from 'fastify';
 import { NodePgDatabase } from 'drizzle-orm/node-postgres';
+import * as drizzle_orm from 'drizzle-orm';
 import { Column, SQL, InferInsertModel, InferSelectModel } from 'drizzle-orm';
+import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
 import { PgTable } from 'drizzle-orm/pg-core';
 import { Observable } from 'rxjs';
 import { AsyncLocalStorage } from 'node:async_hooks';
 
-interface TenantInfo {
-    id: string;
-    subdomain: string;
-    type: 'SHARED' | 'DEDICATED';
-    status: string;
-    schemaName?: string;
-    databaseName?: string;
-    databaseHost?: string;
-    databasePort?: number;
-    databaseUsername?: string;
-    databasePassword?: string;
-    databaseSslMode?: string;
-    connectionPoolSize?: number;
-}
-
 declare module 'fastify' {
     interface FastifyRequest {
         sessionInfo?: {
@@ -32,7 +19,6 @@ declare module 'fastify' {
             sessionId: string;
             sessionType: string;
         };
-        tenant?: TenantInfo;
         cookies?: Record<string, string>;
     }
 }
@@ -45,16 +31,16 @@ declare const AccessToken: (...dataOrPipes: unknown[]) => ParameterDecorator;
 
 declare const CookieDomain: (...dataOrPipes: unknown[]) => ParameterDecorator;
 
-declare const Onboarding: () => _nestjs_common.CustomDecorator<string>;
-
 declare const Public: () => _nestjs_common.CustomDecorator<string>;
 
 declare const RefreshCookieOptions: (...dataOrPipes: unknown[]) => ParameterDecorator;
 
 declare const RefreshTokenCookie: (...dataOrPipes: unknown[]) => ParameterDecorator;
 
-declare const RESET_KEY = "isReset";
-declare const Reset: () => _nestjs_common.CustomDecorator<string>;
+declare const REQUIRE_SESSION_KEY = "requiredSessionTypes";
+declare const RequireSession: (...types: string[]) => _nestjs_common.CustomDecorator<string>;
+
+declare const Subdomain: (...dataOrPipes: unknown[]) => ParameterDecorator;
 
 interface SessionInfo {
     userId: string;
@@ -202,6 +188,7 @@ interface GuardConfig {
     tenantHeaderName: string;
     authHeaderName: string;
     tokenPrefix: string;
+    defaultSessionTypes: string[];
 }
 interface ApiSdkConfig {
     cookie?: Partial<CookieConfig>;
@@ -246,9 +233,7 @@ interface DatabaseModuleOptions {
     primaryDb: PrimaryDbConfig;
     drizzleSchema: RegisteredSchema;
     drizzleRelations?: Record<string, any>;
-    connectionCacheTTL?: number;
     maxConnections?: number;
-    encryptionKey?: string;
 }
 
 declare class DatabaseModule {
@@ -256,14 +241,56 @@ declare class DatabaseModule {
         useFactory: (...args: unknown[]) => Promise<DatabaseModuleOptions> | DatabaseModuleOptions;
         inject?: InjectionToken[];
     }): DynamicModule;
-    static forMicroservice(options: {
-        useFactory: (...args: unknown[]) => Promise<DatabaseModuleOptions> | DatabaseModuleOptions;
-        inject?: InjectionToken[];
-    }): DynamicModule;
-    private static createDynamicModule;
 }
 
-declare const Tenant: (...dataOrPipes: unknown[]) => ParameterDecorator;
+interface UploadedFileResult {
+    buffer: Buffer;
+    filename: string;
+    mimetype: string;
+}
+/**
+ * Extracts a single uploaded file from a Fastify multipart request.
+ *
+ * Requires `@fastify/multipart` to be registered on the Fastify instance.
+ * Throws `BadRequestException` if no file is present in the request.
+ *
+ * @example
+ * ```typescript
+ * @Post('upload')
+ * @ApiConsumes('multipart/form-data')
+ * async upload(@UploadedFile() file: UploadedFileResult) {
+ *   // file.buffer, file.filename, file.mimetype
+ * }
+ * ```
+ */
+declare const UploadedFile: (...dataOrPipes: unknown[]) => ParameterDecorator;
+
+declare class CreateResponseDto<T> {
+    success: boolean;
+    message: string;
+    data: T;
+}
+
+declare class ValidatedRowDto {
+    index: number;
+    data: Record<string, string>;
+    valid: boolean;
+    errors: string[];
+}
+declare class ImportSummaryDto {
+    total: number;
+    valid: number;
+    invalid: number;
+}
+declare class ImportResponseDto {
+    success: boolean;
+    message: string;
+    created?: number;
+    updated?: number;
+    skipped?: number;
+    rows?: ValidatedRowDto[];
+    summary?: ImportSummaryDto;
+}
 
 declare class SelectOptionsQueryDto {
     search?: string;
@@ -345,20 +372,11 @@ declare class PrimaryDatabaseService implements OnModuleInit, OnModuleDestroy {
     private readonly logger;
     private pool;
     private db;
-    private readonly tenantConfigCache;
-    private readonly cacheTTL;
     constructor(options: DatabaseModuleOptions);
     onModuleInit(): Promise<void>;
     private initializeDrizzleClient;
-    private buildPrimaryDbUrl;
-    private maskPassword;
-    getTenantInfo(tenantIdentifier: string): Promise<TenantInfo | null>;
-    private cacheInfo;
-    clearTenantCache(tenantIdentifier: string): void;
-    clearAllCaches(): void;
     get drizzleClient(): TypedDrizzleClient;
     get schema(): typeof this$1.options.drizzleSchema;
-    private decrypt;
     onModuleDestroy(): Promise<void>;
 }
 
@@ -401,6 +419,7 @@ interface FindForSelectConfig {
     groupIdKey?: string;
     joins?: FindForSelectJoin[];
     conditions?: SQL[];
+    distinct?: boolean;
 }
 
 type RelationsWhereFilter = Record<string, unknown>;
@@ -427,7 +446,7 @@ declare abstract class PrimaryBaseRepository<TTable extends PgTable, TInsert = I
     protected get db(): TypedDrizzleClient;
     protected get model(): TypedRelationalQueryBuilder<TSelect>;
     constructor(database: PrimaryDatabaseService, table: TTable);
-    create(data: TInsert): Promise<TSelect>;
+    create(data: TInsert, tx?: TypedDrizzleClient): Promise<TSelect>;
     findById(id: string): Promise<TSelect | undefined>;
     findOne(where: RelationsWhereFilter): Promise<TSelect | undefined>;
     findMany(options?: {
@@ -445,87 +464,28 @@ declare abstract class PrimaryBaseRepository<TTable extends PgTable, TInsert = I
         offset?: number;
         leftJoin?: {
             table: PgTable;
-            on: SQL;
+            on: SQL | undefined;
         };
+        leftJoins?: {
+            table: PgTable;
+            on: SQL | undefined;
+        }[];
+        groupBy?: (Column | SQL)[];
     }): Promise<{
         result: TResult[];
         count: number;
     }>;
-    update(id: string, data: Partial<TInsert>): Promise<TSelect>;
-    updateMany(where: SQL, data: Partial<TInsert>): Promise<{
-        count: number;
-    }>;
-    delete(id: string): Promise<TSelect>;
-    deleteMany(where: SQL): Promise<{
-        count: number;
-    }>;
-    count(where?: SQL): Promise<number>;
-    exists(where: SQL): Promise<boolean>;
-    findForSelect(config: FindForSelectConfig): Promise<SelectQueryResult>;
-}
-
-declare class TenantContextService {
-    private tenantInfo;
-    setTenant(tenantInfo: TenantInfo): void;
-    getTenant(): TenantInfo;
-    hasTenant(): boolean;
-    clearTenant(): void;
-    getTenantIdSafe(): string | null;
-    getTenantSubdomainSafe(): string | null;
-}
-
-declare class TenantDatabaseService implements OnModuleDestroy {
-    private readonly options;
-    private readonly tenantContext;
-    private readonly logger;
-    private readonly clients;
-    private readonly clientLastUsed;
-    private cleanupInterval?;
-    constructor(options: DatabaseModuleOptions, tenantContext: TenantContextService);
-    get drizzleClient(): TypedDrizzleClient;
-    get schema(): Record<string, unknown>;
-    private getDbClient;
-    private createDbClientSync;
-    private buildTenantDbUrl;
-    private buildCacheKey;
-    private startConnectionCleaner;
-    private cleanupIdleConnections;
-    getPoolStats(): {
-        activeConnections: number;
-        tenants: string[];
-    };
-    private maskPassword;
-    onModuleDestroy(): Promise<void>;
-}
-
-type ExtractTableName<TTable extends PgTable> = TTable['_']['name'];
-declare abstract class TenantBaseRepository<TTable extends PgTable, TInsert = InferInsertModel<TTable>, TSelect = InferSelectModel<TTable>> {
-    protected readonly database: TenantDatabaseService;
-    protected readonly table: TTable;
-    protected readonly logger: Logger;
-    private readonly tableName;
-    protected get db(): TypedDrizzleClient;
-    protected get model(): TypedDrizzleClient['query'][ExtractTableName<TTable> & keyof TypedDrizzleClient['query']];
-    constructor(database: TenantDatabaseService, table: TTable);
-    create(data: TInsert): Promise<TSelect>;
-    findById(id: string): Promise<TSelect | null>;
-    findOne(where: SQL): Promise<TSelect | null>;
-    findMany(options?: {
-        where?: SQL;
-        orderBy?: SQL;
-        limit?: number;
-        offset?: number;
-    }): Promise<TSelect[]>;
-    update(id: string, data: Partial<TInsert>): Promise<TSelect>;
-    updateMany(where: SQL, data: Partial<TInsert>): Promise<{
+    update(id: string, data: Partial<TInsert>, tx?: TypedDrizzleClient): Promise<TSelect>;
+    updateMany(where: SQL, data: Partial<TInsert>, tx?: TypedDrizzleClient): Promise<{
         count: number;
     }>;
-    delete(id: string): Promise<TSelect>;
-    deleteMany(where: SQL): Promise<{
+    delete(id: string, tx?: TypedDrizzleClient): Promise<TSelect>;
+    deleteMany(where: SQL, tx?: TypedDrizzleClient): Promise<{
         count: number;
     }>;
     count(where?: SQL): Promise<number>;
     exists(where: SQL): Promise<boolean>;
+    transaction<T>(callback: (tx: TypedDrizzleClient) => Promise<T>): Promise<T>;
     findForSelect(config: FindForSelectConfig): Promise<SelectQueryResult>;
 }
 
@@ -543,6 +503,11 @@ declare class EmailService {
     sendPasswordResetEmail(email: string, otp: string, expiresAt: Date, displayName?: string): Promise<void>;
     sendEmailChangeNotification(oldEmail: string, newEmail: string, revertToken: string, revertExpiresAt: Date, displayName?: string): Promise<void>;
     sendEmailRevertConfirmation(email: string, displayName?: string): Promise<void>;
+    sendInviteEmail(params: {
+        to: string;
+        name: string;
+        inviteUrl: string;
+    }): Promise<void>;
     verifyConnection(): Promise<boolean>;
     private sendEmail;
 }
@@ -649,6 +614,7 @@ declare function getHttpStatusTitle(status: number): string;
 declare class HttpExceptionFilter implements ExceptionFilter {
     private readonly logger;
     catch(exception: unknown, host: ArgumentsHost): void;
+    private isHttpException;
     private isAxiosError;
 }
 
@@ -772,4 +738,118 @@ declare function normalizePhoneNumber(phone: string): string;
 
 declare function parseExpiryToMs(expiry: string): number;
 
-export { AccessToken, type AccessTokenPayload, type ApiErrorResponse, type ApiSdkConfig, AuthConfigModule, BadGatewayException, BadRequestException, CACHE_PROVIDER, CacheModule, CacheService, type ColumnPinning, ConflictException, type CookieConfig, CookieDomain, type CookieSerializeOptions, type CorrelationContext, CorrelationIdMiddleware, DEFAULT_CORRELATION_HEADER, DatabaseModule, type DatabaseModuleOptions, type DensityType, EmailModule, EmailService, type FieldDefinition, type FieldError, type FieldMap, type FilterCondition, type FilterOperator, FilterProcessor, type FindForSelectConfig, type FindForSelectJoin, ForbiddenException, GoneException, type GuardConfig, HttpExceptionFilter, HttpLoggerInterceptor, type HttpLoggerOptions, HttpProblemException, type ICacheProvider, InternalServerErrorException, JwtAuthService, type JwtConfig, LOGGER_MODULE_OPTIONS, type LogFormat, type LogLevel, type LogMetadata, LoggerModule, type LoggerModuleAsyncOptions, type LoggerModuleOptions, type LoggerOptionsFactory, LoggerService, MethodNotAllowedException, NotAcceptableException, NotFoundException, NotImplementedException, Onboarding, PayloadTooLargeException, PrimaryBaseRepository, PrimaryDatabaseService, type PrimaryDbConfig, type ProblemDetails, type ProblemOptions, Public, RESET_KEY, RedisCacheProvider, RefreshCookieOptions, RefreshTokenCookie, type RefreshTokenPayload, type RegisteredSchema, RequestTimeoutException, Reset, RootModule, SKIP_CSRF_KEY, SelectOptionsQueryDto, type SelectQueryGroup, type SelectQueryOption, type SelectQueryResult, ServiceUnavailableException, SessionData, type SessionInfo, SkipCsrf, type SortCondition, SuccessResponseDto, TableResponseDto, type TableViewState, Tenant, TenantBaseRepository, TenantContextService, TenantDatabaseService, type TenantInfo, type TokenExpiry, TokenType, TooManyRequestsException, type TypedDrizzleClient, UnauthorizedException, UnprocessableEntityException, UnsupportedMediaTypeException, UserId, ValidationException, VrittiAuthGuard, addCorrelationIdToResponse, configureApiSdk, correlationStorage, defineConfig, extractCountryFromPhone, generateCorrelationId, getConfig, getCorrelationContext, getHttpStatusTitle, getJwtExpiry, getRefreshCookieOptions, getRefreshCookieOptionsForHost, getTokenExpiry, hashToken, jwtConfigFactory, normalizePhoneNumber, parseExpiryToMs, resetConfig, runWithCorrelationContext, updateCorrelationContext, verifyTokenHash };
+declare const DATA_TABLE_VIEWS_TABLE: unique symbol;
+
+interface DataTableModuleOptions {
+    tableViews: PgTable;
+}
+declare class DataTableModule {
+    static forRoot(options: DataTableModuleOptions): DynamicModule;
+}
+
+declare function dataTableViewsColumns(): {
+    id: drizzle_orm.HasDefault<drizzle_orm.IsPrimaryKey<drizzle_orm_pg_core.PgUUIDBuilder>>;
+    userId: drizzle_orm.NotNull<drizzle_orm_pg_core.PgUUIDBuilder>;
+    tableSlug: drizzle_orm.NotNull<drizzle_orm_pg_core.PgVarcharBuilder<[string, ...string[]]>>;
+    name: drizzle_orm.NotNull<drizzle_orm_pg_core.PgVarcharBuilder<[string, ...string[]]>>;
+    state: drizzle_orm.$Type<drizzle_orm.NotNull<drizzle_orm_pg_core.PgJsonbBuilder>, TableViewState>;
+    isShared: drizzle_orm.HasDefault<drizzle_orm.NotNull<drizzle_orm_pg_core.PgBooleanBuilder>>;
+    createdAt: drizzle_orm.HasDefault<drizzle_orm.NotNull<drizzle_orm_pg_core.PgTimestampBuilder>>;
+    updatedAt: drizzle_orm.HasDefault<drizzle_orm_pg_core.PgTimestampBuilder>;
+};
+declare function dataTableViewsIndexes(table: any): drizzle_orm_pg_core.IndexBuilder[];
+interface DataTableViewRecord {
+    id: string;
+    userId: string;
+    tableSlug: string;
+    name: string;
+    state: TableViewState;
+    isShared: boolean;
+    createdAt: Date;
+    updatedAt: Date | null | undefined;
+}
+interface NewDataTableViewRecord {
+    userId: string;
+    tableSlug: string;
+    name: string;
+    state: TableViewState;
+    isShared?: boolean;
+}
+
+declare class DataTableViewDto {
+    id: string;
+    name: string | null;
+    tableSlug: string;
+    state: TableViewState;
+    isShared: boolean;
+    isOwn: boolean;
+    createdAt: Date;
+    updatedAt: Date | null;
+    static from(view: DataTableViewRecord, userId: string): DataTableViewDto;
+}
+
+declare class CreateDataTableViewDto {
+    name: string;
+    tableSlug: string;
+    state: TableViewState;
+    isShared?: boolean;
+}
+
+declare class UpdateDataTableViewDto {
+    state: TableViewState;
+}
+
+declare class DataTableViewsRepository extends PrimaryBaseRepository<PgTable, NewDataTableViewRecord, DataTableViewRecord> {
+    constructor(database: PrimaryDatabaseService, table: PgTable);
+    findPersonalViewsBySlug(userId: string, tableSlug: string): Promise<DataTableViewRecord[]>;
+    findSharedViewsBySlug(tableSlug: string): Promise<DataTableViewRecord[]>;
+}
+
+declare class DataTableViewsService {
+    private readonly dataTableViewsRepository;
+    private readonly cacheService;
+    private readonly configService;
+    private readonly logger;
+    constructor(dataTableViewsRepository: DataTableViewsRepository, cacheService: CacheService, configService: ConfigService);
+    private personalViewsKey;
+    private sharedViewsKey;
+    private get viewsTtl();
+    private getOrCachePersonalViews;
+    private getOrCacheSharedViews;
+    private invalidateViewsCache;
+    findViews(userId: string, tableSlug: string): Promise<DataTableViewDto[]>;
+    createView(userId: string, dto: CreateDataTableViewDto): Promise<DataTableViewDto>;
+    updateView(userId: string, id: string, dto: UpdateDataTableViewDto): Promise<DataTableViewDto>;
+    toggleShareView(userId: string, id: string, isShared: boolean): Promise<DataTableViewDto>;
+    renameView(userId: string, id: string, name: string): Promise<DataTableViewDto>;
+    deleteView(userId: string, id: string): Promise<DataTableViewDto>;
+}
+
+declare class UpsertDataTableStateDto {
+    tableSlug: string;
+    state: TableViewState;
+    activeViewId?: string | null;
+}
+
+declare class DataTableStateService {
+    private readonly cacheService;
+    private readonly configService;
+    private readonly logger;
+    constructor(cacheService: CacheService, configService: ConfigService);
+    private get stateTtl();
+    upsertCurrentState(userId: string, dto: UpsertDataTableStateDto): Promise<void>;
+    getCurrentState(userId: string, tableSlug: string): Promise<{
+        state: TableViewState;
+        activeViewId: string | null;
+    }>;
+}
+
+declare class RenameDataTableViewDto {
+    name: string;
+}
+
+declare class ToggleShareDataTableViewDto {
+    isShared: boolean;
+}
+
+export { AccessToken, type AccessTokenPayload, type ApiErrorResponse, type ApiSdkConfig, AuthConfigModule, BadGatewayException, BadRequestException, CACHE_PROVIDER, CacheModule, CacheService, type ColumnPinning, ConflictException, type CookieConfig, CookieDomain, type CookieSerializeOptions, type CorrelationContext, CorrelationIdMiddleware, CreateDataTableViewDto, CreateResponseDto, DATA_TABLE_VIEWS_TABLE, DEFAULT_CORRELATION_HEADER, DataTableModule, type DataTableModuleOptions, DataTableStateService, DataTableViewDto, type DataTableViewRecord, DataTableViewsService, DatabaseModule, type DatabaseModuleOptions, type DensityType, EmailModule, EmailService, type FieldDefinition, type FieldError, type FieldMap, type FilterCondition, type FilterOperator, FilterProcessor, type FindForSelectConfig, type FindForSelectJoin, ForbiddenException, GoneException, type GuardConfig, HttpExceptionFilter, HttpLoggerInterceptor, type HttpLoggerOptions, HttpProblemException, type ICacheProvider, ImportResponseDto, ImportSummaryDto, InternalServerErrorException, JwtAuthService, type JwtConfig, LOGGER_MODULE_OPTIONS, type LogFormat, type LogLevel, type LogMetadata, LoggerModule, type LoggerModuleAsyncOptions, type LoggerModuleOptions, type LoggerOptionsFactory, LoggerService, MethodNotAllowedException, type NewDataTableViewRecord, NotAcceptableException, NotFoundException, NotImplementedException, PayloadTooLargeException, PrimaryBaseRepository, PrimaryDatabaseService, type PrimaryDbConfig, type ProblemDetails, type ProblemOptions, Public, REQUIRE_SESSION_KEY, RedisCacheProvider, RefreshCookieOptions, RefreshTokenCookie, type RefreshTokenPayload, type RegisteredSchema, RenameDataTableViewDto, RequestTimeoutException, RequireSession, RootModule, SKIP_CSRF_KEY, type SearchState, SelectOptionsQueryDto, type SelectQueryGroup, type SelectQueryOption, type SelectQueryResult, ServiceUnavailableException, SessionData, type SessionInfo, SkipCsrf, type SortCondition, Subdomain, SuccessResponseDto, TableResponseDto, type TableViewState, ToggleShareDataTableViewDto, type TokenExpiry, TokenType, TooManyRequestsException, type TypedDrizzleClient, UnauthorizedException, UnprocessableEntityException, UnsupportedMediaTypeException, UpdateDataTableViewDto, UploadedFile, type UploadedFileResult, UpsertDataTableStateDto, UserId, ValidatedRowDto, ValidationException, VrittiAuthGuard, addCorrelationIdToResponse, configureApiSdk, correlationStorage, dataTableViewsColumns, dataTableViewsIndexes, defineConfig, extractCountryFromPhone, generateCorrelationId, getConfig, getCorrelationContext, getHttpStatusTitle, getJwtExpiry, getRefreshCookieOptions, getRefreshCookieOptionsForHost, getTokenExpiry, hashToken, jwtConfigFactory, normalizePhoneNumber, parseExpiryToMs, resetConfig, runWithCorrelationContext, updateCorrelationContext, verifyTokenHash };