@wabot-dev/framework 0.2.0-beta.1 → 0.2.0-beta.10

package/dist/src/index.d.ts

@@ -23,11 +23,13 @@ declare class Storable<D extends IStorableData> {
 
 declare class Auth<D extends IStorableData> {
     private authInfo;
+    private overrided;
     require(): D;
     assign(authInfo: D): void;
     override(authInfo: D): void;
     clear(): void;
     isAssigned(): boolean;
+    wasOverrided(): boolean;
 }
 
 interface IEntityData extends IStorableData {
@@ -129,47 +131,6 @@ declare class Logger {
     private log;
 }
 
-declare class Mapper {
-    map<T>(data: any, ctor: IConstructor<T>): T;
-}
-
-interface PasswordHashOptions {
-    password: string;
-    saltLength?: number;
-    keyLength?: number;
-}
-declare class Password {
-    static hash(options: PasswordHashOptions): string;
-    static isValid(req: {
-        password: string;
-        hash: string;
-    }): boolean;
-    static generate(length: number): string;
-}
-
-declare class Random {
-    static integer(options: {
-        min: number;
-        max: number;
-    }): number;
-    static slug(name: string, options: {
-        randomLength: number;
-    }): string;
-    static alphaNumeric(length: number): string;
-    static alphaNumericLowerCase(length: number): string;
-    static numberCode(length: number): string;
-}
-
-interface ICrudRepository<T> {
-    find(id: string): Promise<T | null>;
-    findOrThrow(id: string): Promise<T>;
-    findByIds(ids: string[]): Promise<T[]>;
-    findAll(id: string): Promise<T[]>;
-    create(item: T): Promise<void>;
-    update(item: T): Promise<void>;
-    delete(item: T): Promise<void>;
-}
-
 declare function isModel(model: IConstructor<any>): (target: object, propertyKey: string | symbol) => void;
 
 declare function isOptional(): (target: object, propertyKey: string | symbol) => void;
@@ -252,7 +213,10 @@ declare class ValidationMetadataStore {
 
 declare function validateModel<V>(value: any, info: IModelValidatorsInfo<V>): IModelValidationResult<V>;
 
-declare function validate<V>(value: any, modelConstructor: IConstructor<V>): IModelValidationResult<V>;
+type IValidateInputShape<T> = T extends Date ? Date : T extends Array<infer U> ? Array<IValidateInputShape<U>> : T extends object ? {
+    [K in keyof T]: IValidateInputShape<T[K]>;
+} : T;
+declare function validateAndTransform<V>(value: IValidateInputShape<V>, modelConstructor: IConstructor<V>): IModelValidationResult<V>;
 
 declare function modelInfo<V>(modelConstructor: IConstructor<V>): IModelValidatorsInfo<V>;
 
@@ -301,6 +265,47 @@ interface IValidateMinOptions {
 }
 declare function validateMin(value: any, options: IValidateMinOptions): IValidationResult<any>;
 
+declare class Mapper {
+    map<T>(data: IValidateInputShape<T>, ctor: IConstructor<T>): T;
+}
+
+interface PasswordHashOptions {
+    password: string;
+    saltLength?: number;
+    keyLength?: number;
+}
+declare class Password {
+    static hash(options: PasswordHashOptions): string;
+    static isValid(req: {
+        password: string;
+        hash: string;
+    }): boolean;
+    static generate(length: number): string;
+}
+
+declare class Random {
+    static integer(options: {
+        min: number;
+        max: number;
+    }): number;
+    static slug(name: string, options: {
+        randomLength: number;
+    }): string;
+    static alphaNumeric(length: number): string;
+    static alphaNumericLowerCase(length: number): string;
+    static numberCode(length: number): string;
+}
+
+interface ICrudRepository<T> {
+    find(id: string): Promise<T | null>;
+    findOrThrow(id: string): Promise<T>;
+    findByIds(ids: string[]): Promise<T[]>;
+    findAll(id: string): Promise<T[]>;
+    create(item: T): Promise<void>;
+    update(item: T): Promise<void>;
+    delete(item: T): Promise<void>;
+}
+
 interface ICommandConfig {
     name?: string;
 }
@@ -921,17 +926,11 @@ declare class SocketServerProvider {
     private createSocketServer;
 }
 
-interface IConnectionMiddleware {
+interface IHandshakeMiddleware {
     handle(socket: Socket, container: DependencyContainer$1): Promise<void>;
 }
 
-declare function connectionMiddleware(middlewareConstructor: IConstructor<IConnectionMiddleware>): (target: object, propertyKey: string | symbol) => void;
-
-interface ISocketConnectionConfig {
-    namespace: string;
-}
-
-declare function socketConnection(config?: string | ISocketConnectionConfig): (target: object, propertyKey: string | symbol) => void;
+declare function handshakeMiddlewares(middlewares: IConstructor<IHandshakeMiddleware>[]): (target: IConstructor<any>) => void;
 
 interface ISocketControllerConfig {
     namespace: string;
@@ -940,23 +939,14 @@ interface ISocketControllerConfig {
 declare function socketController(config?: string | ISocketControllerConfig): (target: IConstructor<any>) => void;
 
 interface ISocketEventConfig {
-    namespace?: string;
     event: string;
 }
 
-declare function socketEvent(config: string | ISocketEventConfig): (target: object, propertyKey: string | symbol) => void;
+declare function onSocketEvent(config: string | ISocketEventConfig): (target: object, propertyKey: string | symbol) => void;
 
-interface IConnectionMiddlewareMetadata {
+interface IHandshakeMiddlewareMetadata {
     controllerConstructor: IConstructor<any>;
-    functionName: string;
-    middlewareConstructor: IConstructor<IConnectionMiddleware>;
-}
-
-interface ISocketConnectionMetadata {
-    config?: ISocketConnectionConfig;
-    controllerConstructor: IConstructor<any>;
-    functionName: string;
-    paramsTypes: any[];
+    middlewareConstructor: IConstructor<IHandshakeMiddleware>;
 }
 
 interface ISocketControllerMetadata {
@@ -973,22 +963,16 @@ interface ISocketEventMetadata {
 
 declare class SocketControllerMetadataStore {
     private socketControllers;
-    private socketConnections;
     private socketEvents;
-    private connectionMiddlewares;
+    private handshakeMiddlewares;
     saveControllerMetadata(controllerMetadata: ISocketControllerMetadata): void;
-    saveSocketConnectionMetadata(socketConnectionMetadata: ISocketConnectionMetadata): void;
     saveSocketEventMetadata(socketEventMetadata: ISocketEventMetadata): void;
-    saveConnectionMiddlewareMetadata(middlewareMetadata: IConnectionMiddlewareMetadata): void;
-    getControllerSockerConnectionsInfo(controllerConstructor: IConstructor<any>): {
-        events: ISocketEventMetadata[];
-        connectionMiddlewares: IConnectionMiddlewareMetadata[];
+    saveHandshakeMiddlewareMetadata(handshakeMetadata: IHandshakeMiddlewareMetadata): void;
+    getSocketControllerInfo(controllerConstructor: IConstructor<any>): {
         controller: ISocketControllerMetadata;
-        config?: ISocketConnectionConfig;
-        controllerConstructor: IConstructor<any>;
-        functionName: string;
-        paramsTypes: any[];
-    }[];
+        events: Map<string, ISocketEventMetadata>;
+        handShakeMiddlewares: IHandshakeMiddlewareMetadata[] | undefined;
+    };
 }
 
 declare function runSocketControllers(controllers: IConstructor<any>[]): void;
@@ -997,7 +981,7 @@ declare class PgJobRepository extends PgCrudRepository<Job> implements IJobRepos
     constructor(pool: Pool);
 }
 
-declare function apiKeyConnectionGuard(): (target: object, propertyKey: string | symbol) => void;
+declare function apiKeyHandshakeGuard(): (target: IConstructor<any>) => void;
 
 declare function apiKeyGuard(): (target: object, propertyKey: string | symbol) => void;
 
@@ -1012,6 +996,7 @@ declare class ApiKey<A extends IStorableData> extends Entity<IApiKeyData<A>> {
     static hashSecret(secret: string): string;
     get authInfo(): A;
     get metadata(): Record<string, string>;
+    get name(): string;
     setAuthInfo(authInfo: A): void;
     generateSecret(): string;
     isValidSecret(secret: string): boolean;
@@ -1024,7 +1009,8 @@ interface IApiKeyRepository<A extends IStorableData> {
     findByMetadata(metadata: Record<string, string>): Promise<ApiKey<A>[]>;
     create(item: ApiKey<A>): Promise<void>;
     generate(req: IGenerateApiKeyReq<A>): Promise<IGenerateApiKeyRes<A>>;
-    findAuthInfoBySecret(secret: string): Promise<A | null>;
+    findBySecret(secret: string): Promise<ApiKey<A> | null>;
+    findAndValidate(secret: string): Promise<A>;
 }
 interface IGenerateApiKeyReq<A extends IStorableData> extends IStorableData {
     name: string;
@@ -1037,15 +1023,16 @@ interface IGenerateApiKeyRes<A extends IStorableData> {
 }
 
 declare class ApiKeyRepository<A extends IStorableData> implements IApiKeyRepository<A> {
-    findAuthInfoBySecret(secret: string): Promise<A>;
-    findByMetadata(metadata: Record<string, string>): Promise<ApiKey<A>[]>;
     find(id: string): Promise<ApiKey<A> | null>;
     findOrThrow(id: string): Promise<ApiKey<A>>;
+    findByMetadata(metadata: Record<string, string>): Promise<ApiKey<A>[]>;
     create(item: ApiKey<A>): Promise<void>;
     generate(req: IGenerateApiKeyReq<A>): Promise<IGenerateApiKeyRes<A>>;
+    findBySecret(secret: string): Promise<ApiKey<A> | null>;
+    findAndValidate(secret: string): Promise<A>;
 }
 
-declare class ApiKeyConnectionGuardMiddleware implements IConnectionMiddleware {
+declare class ApiKeyHandshakeGuardMiddleware implements IHandshakeMiddleware {
     private apiKeyRepository;
     private auth;
     constructor(apiKeyRepository: ApiKeyRepository<any>, auth: Auth<any>);
@@ -1061,55 +1048,58 @@ declare class ApiKeyGuardMiddleware implements IMiddleware {
 
 declare class PgApiKeyRepository<A extends IStorableData> extends PgCrudRepository<ApiKey<A>> implements IApiKeyRepository<A> {
     constructor(pool: Pool);
-    findAuthInfoBySecret(secret: string): Promise<A | null>;
+    findAndValidate(secret: string): Promise<A>;
+    findBySecret(secret: string): Promise<ApiKey<A> | null>;
     findByMetadata(metadata: Record<string, string>): Promise<ApiKey<A>[]>;
     generate(req: IGenerateApiKeyReq<A>): Promise<IGenerateApiKeyRes<A>>;
 }
 
 interface IRemoteApiKeyFetcher<A extends IStorableData> {
-    fetchById: (id: string) => Promise<ApiKey<A> | null>;
-    fetchBySecret: (secret: string) => Promise<ApiKey<A> | null>;
+    fetchAuthInfoBySecret: (secret: string) => Promise<A | null>;
 }
 declare class RemoteApiKeyRepository<A extends IStorableData> implements IApiKeyRepository<A> {
     private fetcher;
     private cacheSeconds;
-    private cacheById;
     private cacheBySecret;
     constructor(fetcher: IRemoteApiKeyFetcher<A>, cacheSeconds: number);
+    findAndValidate(secret: string): Promise<A>;
     find(id: string): Promise<ApiKey<A> | null>;
     findOrThrow(id: string): Promise<ApiKey<A>>;
-    findAuthInfoBySecret(secret: string): Promise<A>;
+    findBySecret(secret: string): Promise<ApiKey<A> | null>;
     findByMetadata(metadata: Record<string, string>): Promise<ApiKey<A>[]>;
     create(item: ApiKey<A>): Promise<void>;
     generate(req: IGenerateApiKeyReq<A>): Promise<IGenerateApiKeyRes<A>>;
 }
 
-declare function jwtConnectionGuard(): (target: object, propertyKey: string | symbol) => void;
+declare function jwtHandshakeGuard(): (target: IConstructor<any>) => void;
 
 declare function jwtGuard(): (target: object, propertyKey: string | symbol) => void;
 
 interface IJwtRefreshTokenData<A extends IStorableData> extends IEntityData {
+    secretHash?: string;
+    metadata?: Record<string, string>;
     authInfo: A;
-    passwordHash?: string;
     expirationTime: number;
+    revokedAt?: number;
 }
 declare class JwtRefreshToken<A extends IStorableData> extends Entity<IJwtRefreshTokenData<A>> {
+    static PREFIX: string;
+    static hashSecret(secret: string): string;
     get authInfo(): A;
+    get metadata(): Record<string, string>;
     get expirationTime(): Date;
-    generatePassword(): string;
-    isValidPassword(password: string): boolean;
-    validatePassword(password: string): void;
-    static inflate(secret: string): {
-        id: string;
-        pass: string;
-    };
-    static deflate(data: {
-        id: string;
-        pass: string;
-    }): string;
+    isExpired(): boolean;
+    revoke(): void;
+    isRevoked(): boolean;
+    generateSecret(): string;
+    isValidSecret(secret: string): boolean;
+    isValidToken(secret: string): boolean;
+    validateToken(secret: string): void;
 }
 
 interface IJwtRefreshTokenRepository<D extends IStorableData> extends ICrudRepository<JwtRefreshToken<D>> {
+    findAndValidate(secret: string): Promise<D>;
+    findByMetadata(metadata: Record<string, string>): Promise<JwtRefreshToken<D>[]>;
 }
 
 declare class JwtTokenDto {
@@ -1139,6 +1129,8 @@ declare class JwtSigner {
 }
 
 declare class JwtRefreshTokenRepository<D extends IStorableData> implements IJwtRefreshTokenRepository<D> {
+    findByMetadata(metadata: Record<string, string>): Promise<JwtRefreshToken<D>[]>;
+    findAndValidate(secret: string): Promise<D>;
     find(id: string): Promise<JwtRefreshToken<D> | null>;
     findOrThrow(id: string): Promise<JwtRefreshToken<D>>;
     findByIds(ids: string[]): Promise<JwtRefreshToken<D>[]>;
@@ -1154,11 +1146,11 @@ declare class Jwt {
     private jwtRefreshTokenRepository;
     private config;
     constructor(auth: Auth<any>, jwtSigner: JwtSigner, jwtRefreshTokenRepository: JwtRefreshTokenRepository<any>, config: JwtConfig);
-    createToken(): Promise<JwtAccessAndRefreshTokenDto>;
-    refreshToken(refreshSecret: string): Promise<JwtTokenDto>;
+    createToken(metadata?: Record<string, string>): Promise<JwtAccessAndRefreshTokenDto>;
+    findRefreshTokenAuthInfo(secret: string): Promise<any>;
 }
 
-declare class JwtConnectionGuardMiddleware implements IConnectionMiddleware {
+declare class JwtHandshakeGuardMiddleware implements IHandshakeMiddleware {
     private config;
     private auth;
     constructor(config: JwtConfig, auth: Auth<any>);
@@ -1174,6 +1166,9 @@ declare class JwtGuardMiddleware implements IMiddleware {
 
 declare class PgJwtRefreshTokenRepository<D extends IStorableData> extends PgCrudRepository<JwtRefreshToken<D>> implements IJwtRefreshTokenRepository<D> {
     constructor(pool: Pool);
+    findAndValidate(secret: string): Promise<D>;
+    findBySecret(secret: string): Promise<JwtRefreshToken<D> | null>;
+    findByMetadata(metadata: Record<string, string>): Promise<JwtRefreshToken<D>[]>;
 }
 
 declare class AnthropicChatAdapter implements IChatAdapter {
@@ -1279,28 +1274,34 @@ declare function writeJsonToFile<T>(filename: string, data: T): void;
 declare function readJsonFromFile<T>(filename: string): T | null;
 
 interface ISocketChannelConfig {
-    channel: string;
+    namespace: string;
+    handshakeMidlewares?: IConstructor<IHandshakeMiddleware>[];
 }
 
 declare class SocketChannelConfig implements ISocketChannelConfig {
-    channel: string;
-    constructor(channel: string);
+    namespace: string;
+    handshakeMidlewares?: IConstructor<IHandshakeMiddleware>[] | undefined;
+    constructor(namespace: string, handshakeMidlewares?: IConstructor<IHandshakeMiddleware>[] | undefined);
 }
 
 declare function socket(config: SocketChannelConfig): (target: object, propertyKey: string | symbol) => void;
 
 interface ISocketChannelReceivedMessage {
     chatId: string;
-    userId: string;
+    senderName: string;
+    text: string;
+}
+declare class SocketChannelReceivedMessage implements ISocketChannelReceivedMessage {
+    chatId: string;
     senderName: string;
     text: string;
 }
 declare class SocketChannel implements IChatChannel {
     private config;
-    private socketServerProvider;
     private callBack;
-    private server;
-    constructor(config: SocketChannelConfig, socketServerProvider: SocketServerProvider);
+    private controller;
+    constructor(config: SocketChannelConfig);
+    private configController;
     listen(callback: (message: IChannelMessage) => void): void;
     connect(): void;
 }
@@ -1622,4 +1623,4 @@ declare function HtmlModule(options: IHtmlModuleOptions): {
     new (): {};
 };
 
-export { AnthropicChatAdapter, ApiKey, ApiKeyConnectionGuardMiddleware, ApiKeyGuardMiddleware, ApiKeyRepository, Async, Auth, Chat, ChatAdapter, ChatBot, ChatBotMetadataStore, ChatItem, ChatMemory, ChatRepository, ChatResolver, CmdChannel, Command, CommandMetadataStore, Container, ControllerMetadataStore, CustomError, DeepSeekChatAdapter, EXPRESS_REQ, EXPRESS_RES, Entity, Env, EnvWhatsAppRepository, ExpressProvider, GoogleChatAdapter, HtmlModule, HttpServerProvider, type IApiKeyData, type IApiKeyRepository, type IArrayValidationError, type IArrayValidationResult, type IBotMessageItem, type IChannelMessage, type IChannelMetadata, type IChatAdapter, type IChatAdapterNextItemReq, type IChatAdapterNextItemRes, type IChatBot, type IChatBotMetadata, type IChatChannel, type IChatConnection, type IChatControllerMetadata, type IChatData, type IChatItem, type IChatItemData, type IChatItemType, type IChatMemory, type IChatMessage, type IChatRepository, type IChatType, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConnectionMiddleware, type IConnectionMiddlewareMetadata, type IConstructor, type ICrudRepository, type ICustomErrorData, type IEndPointConfig, type IEndPointMetadata, type IEntityData, type IEnvType, type IFunctionCall, type IFunctionCallItem, type IGenerateApiKeyReq, type IGenerateApiKeyRes, type IGetWhatsAppTemplateRequest, type IHtmlModuleOptions, type IHumanMessageItem, type IJobData, type IJobEvent, type IJobEventListener, type IJobRepository, type IJwtRefreshTokenData, type IJwtRefreshTokenRepository, type ILanguageModelUsage, type IListenWhatsAppMessageRequest, type IMessageContext, type IMiddleware, type IMiddlewareMetadata, type IMindset, type IMindsetDecoration, type IMindsetFunctionConfig, type IMindsetFunctionDecoration, type IMindsetFunctionMetadata, type IMindsetFunctionParamMetadata, type IMindsetIdentity, type IMindsetLlm, type IMindsetMetadata, type IMindsetModuleConfig, type IMindsetModuleDecoration, type IMindsetModuleMetadata, type IMindsetTool, type IMindsetToolParameter, type IModelValidationError, type IModelValidationResult, type IModelValidatorsInfo, type IMoneyData, type IParamConfig, type IParamDecoration, type IPersistentData, type IPgRepositoryConfig, type IPrimitive, type IPropertyValidatorInfo, type IReceivedMessage, type IRemoteApiKeyFetcher, type IRestControllerConfig, type IRestControllerMetadata, type ISendWhatsAppRequest, type ISendWhatsAppTemplateRequest, type ISocketChannelConfig, type ISocketChannelReceivedMessage, type ISocketConnectionConfig, type ISocketConnectionMetadata, type ISocketControllerConfig, type ISocketControllerMetadata, type ISocketEventConfig, type ISocketEventMetadata, type IStorableData, type ITelegramChannelConfig, type IValidateArrayOptions, type IValidateArrayOptionsWithItemsValidators, type IValidateIsInOptions, type IValidateMaxOptions, type IValidateMinOptions, type IValidationError, type IValidationResult, type IValidator, type IValidatorMetadata, type IWhatsAppBusinessAccount, type IWhatsAppBusinessNumber, type IWhatsAppCloudContact, type IWhatsAppCloudMessage, type IWhatsAppCloudMessageMetadata, type IWhatsAppCloudTemplate, type IWhatsAppCloudTemplateComponent, type IWhatsAppCloudTemplateMessage, type IWhatsAppCloudTemplateParameter, type IWhatsAppCloudTemplateResponse, type IWhatsAppCloudWebhookPayload, type IWhatsAppData, type IWhatsAppMessageListener, type IWhatsAppProxyListenMessageEventData, type IWhatsAppProxyListenMessageEventReq, type IWhatsAppProxyMessage, type IWhatsAppProxyMessageContent, type IWhatsAppProxyMessageEventReq, type IWhatsAppProxySendMessageEventReq, type IWhatsAppRepository, type IWhatsAppSenderOptions, type IWhatsappChannelConfig, type IchatControllerConfig, Job, JobRepository, JobRunner, JobsEventsHub, Jwt, JwtAccessAndRefreshTokenDto, JwtConfig, JwtConnectionGuardMiddleware, JwtGuardMiddleware, JwtRefreshToken, JwtRefreshTokenRepository, JwtSigner, JwtTokenDto, Lifecycle, Logger, MINDSET_DECORATION_MINDSET, MINDSET_FUNCTION_DECORATION_FUNCTION, MINDSET_MODULE_DECORATION_MODULE, Mapper, Mindset, MindsetMetadataStore, MindsetOperator, Money, MoneyDto, OpenaiChatAdapter, PARAM_DECORATION_IS_OPTIONAL, PARAM_DECORATION_PARAM, Password, type PasswordHashOptions, Persistent, PgApiKeyRepository, PgChatMemory, PgChatRepository, PgCrudRepository, PgJobRepository, PgJwtRefreshTokenRepository, PgRepositoryBase, PgWhatsAppRepository, RamChatMemory, RamChatRepository, Random, RemoteApiKeyRepository, RestControllerMetadataStore, SocketChannel, SocketChannelConfig, SocketControllerMetadataStore, SocketServerProvider, Storable, TelegramChannel, TelegramChannelConfig, ValidationMetadataStore, WHATSAPP_MESSAGE_EVENT, WHATSAPP_PROXY_LISTEN_MESSAGE_EVENT, WHATSAPP_PROXY_SEND_MESSAGE_EVENT, WabotChatAdapter, WhatsApp, WhatsAppChannel, WhatsAppReceiver, WhatsAppReceiverByCloudApi, WhatsAppReceiverByWabotProxy, WhatsAppRepository, WhatsAppSender, WhatsAppSenderByCloudApi, WhatsAppSenderByWabotProxy, WhatsAppWabotProxyConnection, WhatsappChannelConfig, apiKeyConnectionGuard, apiKeyGuard, chatBot, chatController, chatItemTypeOptions, cmd, command, commandHandler, connectionMiddleware, container, inject, injectable, isArray, isBoolean, isDate, isIn, isModel, isNotEmpty, isNumber, isOptional, isPresent, isString, jwtConnectionGuard, jwtGuard, max, middleware, min, mindset, mindsetFunction, mindsetModule, modelInfo, onDelete, onGet, onPost, onPut, param, readJsonFromFile, restController, runAsyncCommandHandlers, runChatControllers, runRestControllers, runSocketControllers, scoped, singleton, socket, socketConnection, socketController, socketEvent, telegram, validate, validateArray, validateIsBoolean, validateIsDate, validateIsIn, validateIsNotEmpty, validateIsNumber, validateIsPresent, validateIsString, validateMax, validateMin, validateModel, whatsApp, writeJsonToFile };
+export { AnthropicChatAdapter, ApiKey, ApiKeyGuardMiddleware, ApiKeyHandshakeGuardMiddleware, ApiKeyRepository, Async, Auth, Chat, ChatAdapter, ChatBot, ChatBotMetadataStore, ChatItem, ChatMemory, ChatRepository, ChatResolver, CmdChannel, Command, CommandMetadataStore, Container, ControllerMetadataStore, CustomError, DeepSeekChatAdapter, EXPRESS_REQ, EXPRESS_RES, Entity, Env, EnvWhatsAppRepository, ExpressProvider, GoogleChatAdapter, HtmlModule, HttpServerProvider, type IApiKeyData, type IApiKeyRepository, type IArrayValidationError, type IArrayValidationResult, type IBotMessageItem, type IChannelMessage, type IChannelMetadata, type IChatAdapter, type IChatAdapterNextItemReq, type IChatAdapterNextItemRes, type IChatBot, type IChatBotMetadata, type IChatChannel, type IChatConnection, type IChatControllerMetadata, type IChatData, type IChatItem, type IChatItemData, type IChatItemType, type IChatMemory, type IChatMessage, type IChatRepository, type IChatType, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConstructor, type ICrudRepository, type ICustomErrorData, type IEndPointConfig, type IEndPointMetadata, type IEntityData, type IEnvType, type IFunctionCall, type IFunctionCallItem, type IGenerateApiKeyReq, type IGenerateApiKeyRes, type IGetWhatsAppTemplateRequest, type IHandshakeMiddleware, type IHandshakeMiddlewareMetadata, type IHtmlModuleOptions, type IHumanMessageItem, type IJobData, type IJobEvent, type IJobEventListener, type IJobRepository, type IJwtRefreshTokenData, type IJwtRefreshTokenRepository, type ILanguageModelUsage, type IListenWhatsAppMessageRequest, type IMessageContext, type IMiddleware, type IMiddlewareMetadata, type IMindset, type IMindsetDecoration, type IMindsetFunctionConfig, type IMindsetFunctionDecoration, type IMindsetFunctionMetadata, type IMindsetFunctionParamMetadata, type IMindsetIdentity, type IMindsetLlm, type IMindsetMetadata, type IMindsetModuleConfig, type IMindsetModuleDecoration, type IMindsetModuleMetadata, type IMindsetTool, type IMindsetToolParameter, type IModelValidationError, type IModelValidationResult, type IModelValidatorsInfo, type IMoneyData, type IParamConfig, type IParamDecoration, type IPersistentData, type IPgRepositoryConfig, type IPrimitive, type IPropertyValidatorInfo, type IReceivedMessage, type IRemoteApiKeyFetcher, type IRestControllerConfig, type IRestControllerMetadata, type ISendWhatsAppRequest, type ISendWhatsAppTemplateRequest, type ISocketChannelConfig, type ISocketChannelReceivedMessage, type ISocketControllerConfig, type ISocketControllerMetadata, type ISocketEventConfig, type ISocketEventMetadata, type IStorableData, type ITelegramChannelConfig, type IValidateArrayOptions, type IValidateArrayOptionsWithItemsValidators, type IValidateInputShape, type IValidateIsInOptions, type IValidateMaxOptions, type IValidateMinOptions, type IValidationError, type IValidationResult, type IValidator, type IValidatorMetadata, type IWhatsAppBusinessAccount, type IWhatsAppBusinessNumber, type IWhatsAppCloudContact, type IWhatsAppCloudMessage, type IWhatsAppCloudMessageMetadata, type IWhatsAppCloudTemplate, type IWhatsAppCloudTemplateComponent, type IWhatsAppCloudTemplateMessage, type IWhatsAppCloudTemplateParameter, type IWhatsAppCloudTemplateResponse, type IWhatsAppCloudWebhookPayload, type IWhatsAppData, type IWhatsAppMessageListener, type IWhatsAppProxyListenMessageEventData, type IWhatsAppProxyListenMessageEventReq, type IWhatsAppProxyMessage, type IWhatsAppProxyMessageContent, type IWhatsAppProxyMessageEventReq, type IWhatsAppProxySendMessageEventReq, type IWhatsAppRepository, type IWhatsAppSenderOptions, type IWhatsappChannelConfig, type IchatControllerConfig, Job, JobRepository, JobRunner, JobsEventsHub, Jwt, JwtAccessAndRefreshTokenDto, JwtConfig, JwtGuardMiddleware, JwtHandshakeGuardMiddleware, JwtRefreshToken, JwtRefreshTokenRepository, JwtSigner, JwtTokenDto, Lifecycle, Logger, MINDSET_DECORATION_MINDSET, MINDSET_FUNCTION_DECORATION_FUNCTION, MINDSET_MODULE_DECORATION_MODULE, Mapper, Mindset, MindsetMetadataStore, MindsetOperator, Money, MoneyDto, OpenaiChatAdapter, PARAM_DECORATION_IS_OPTIONAL, PARAM_DECORATION_PARAM, Password, type PasswordHashOptions, Persistent, PgApiKeyRepository, PgChatMemory, PgChatRepository, PgCrudRepository, PgJobRepository, PgJwtRefreshTokenRepository, PgRepositoryBase, PgWhatsAppRepository, RamChatMemory, RamChatRepository, Random, RemoteApiKeyRepository, RestControllerMetadataStore, SocketChannel, SocketChannelConfig, SocketChannelReceivedMessage, SocketControllerMetadataStore, SocketServerProvider, Storable, TelegramChannel, TelegramChannelConfig, ValidationMetadataStore, WHATSAPP_MESSAGE_EVENT, WHATSAPP_PROXY_LISTEN_MESSAGE_EVENT, WHATSAPP_PROXY_SEND_MESSAGE_EVENT, WabotChatAdapter, WhatsApp, WhatsAppChannel, WhatsAppReceiver, WhatsAppReceiverByCloudApi, WhatsAppReceiverByWabotProxy, WhatsAppRepository, WhatsAppSender, WhatsAppSenderByCloudApi, WhatsAppSenderByWabotProxy, WhatsAppWabotProxyConnection, WhatsappChannelConfig, apiKeyGuard, apiKeyHandshakeGuard, chatBot, chatController, chatItemTypeOptions, cmd, command, commandHandler, container, handshakeMiddlewares, inject, injectable, isArray, isBoolean, isDate, isIn, isModel, isNotEmpty, isNumber, isOptional, isPresent, isString, jwtGuard, jwtHandshakeGuard, max, middleware, min, mindset, mindsetFunction, mindsetModule, modelInfo, onDelete, onGet, onPost, onPut, onSocketEvent, param, readJsonFromFile, restController, runAsyncCommandHandlers, runChatControllers, runRestControllers, runSocketControllers, scoped, singleton, socket, socketController, telegram, validateAndTransform, validateArray, validateIsBoolean, validateIsDate, validateIsIn, validateIsNotEmpty, validateIsNumber, validateIsPresent, validateIsString, validateMax, validateMin, validateModel, whatsApp, writeJsonToFile };

package/dist/src/index.js

@@ -14,7 +14,7 @@ export { isArray } from './core/validation/metadata/@isArray.js';
 export { ValidationMetadataStore } from './core/validation/metadata/ValidationMetadataStore.js';
 export { validateModel } from './core/validation/core/validateModel.js';
 export { validateArray } from './core/validation/core/validateArray.js';
-export { validate } from './core/validation/validate.js';
+export { validateAndTransform } from './core/validation/validateAndTransform.js';
 export { modelInfo } from './core/validation/modelInfo.js';
 export { isBoolean } from './core/validation/validators/is-boolean/@isBoolean.js';
 export { validateIsBoolean } from './core/validation/validators/is-boolean/validateIsBoolean.js';
@@ -84,27 +84,26 @@ export { RestControllerMetadataStore } from './feature/rest-controller/metadata/
 export { runRestControllers } from './feature/rest-controller/runRestControllers.js';
 export { EXPRESS_REQ, EXPRESS_RES } from './feature/rest-controller/injection-tokens.js';
 export { SocketServerProvider } from './feature/socket/SocketServerProvider.js';
-export { connectionMiddleware } from './feature/socket-controller/metadata/@connectionMiddleware.js';
-export { socketConnection } from './feature/socket-controller/metadata/@socketConnection.js';
+export { handshakeMiddlewares } from './feature/socket-controller/metadata/@handshakeMiddlewares.js';
 export { socketController } from './feature/socket-controller/metadata/@socketController.js';
-export { socketEvent } from './feature/socket-controller/metadata/@socketEvent.js';
+export { onSocketEvent } from './feature/socket-controller/metadata/@onSocketEvent.js';
 export { SocketControllerMetadataStore } from './feature/socket-controller/metadata/SocketControllerMetadataStore.js';
 export { runSocketControllers } from './feature/socket-controller/runSocketControllers.js';
 export { PgJobRepository } from './addon/async/pg/PgJobRepository.js';
-export { apiKeyConnectionGuard } from './addon/auth/api-key/@apiKeyConnectionGuard.js';
+export { apiKeyHandshakeGuard } from './addon/auth/api-key/@apiKeyHandshakeGuard.js';
 export { apiKeyGuard } from './addon/auth/api-key/@apiKeyGuard.js';
 export { ApiKey } from './addon/auth/api-key/ApiKey.js';
-export { ApiKeyConnectionGuardMiddleware } from './addon/auth/api-key/ApiKeyConnectionGuardMiddleware.js';
+export { ApiKeyHandshakeGuardMiddleware } from './addon/auth/api-key/ApiKeyHandshakeGuardMiddleware.js';
 export { ApiKeyGuardMiddleware } from './addon/auth/api-key/ApiKeyGuardMiddleware.js';
 export { ApiKeyRepository } from './addon/auth/api-key/ApiKeyRepository.js';
 export { PgApiKeyRepository } from './addon/auth/api-key/PgApiKeyRepository.js';
 export { RemoteApiKeyRepository } from './addon/auth/api-key/RemoteApiKeyRepository.js';
-export { jwtConnectionGuard } from './addon/auth/jwt/@jwtConnectionGuard.js';
+export { jwtHandshakeGuard } from './addon/auth/jwt/@jwtHandshakeGuard.js';
 export { jwtGuard } from './addon/auth/jwt/@jwtGuard.js';
 export { Jwt } from './addon/auth/jwt/Jwt.js';
 export { JwtAccessAndRefreshTokenDto } from './addon/auth/jwt/JwtAccessAndRefreshTokenDto.js';
 export { JwtConfig } from './addon/auth/jwt/JwtConfig.js';
-export { JwtConnectionGuardMiddleware } from './addon/auth/jwt/JwtConnectionGuardMiddleware.js';
+export { JwtHandshakeGuardMiddleware } from './addon/auth/jwt/JwtHandshakeGuardMiddleware.js';
 export { JwtGuardMiddleware } from './addon/auth/jwt/JwtGuardMiddleware.js';
 export { JwtRefreshToken } from './addon/auth/jwt/JwtRefreshToken.js';
 export { JwtRefreshTokenRepository } from './addon/auth/jwt/JwtRefreshTokenRepository.js';
@@ -123,7 +122,7 @@ export { WabotChatAdapter } from './addon/chat-bot/wabot/WabotChatAdapter.js';
 export { cmd } from './addon/chat-controller/cmd/@cmd.js';
 export { CmdChannel, readJsonFromFile, writeJsonToFile } from './addon/chat-controller/cmd/CmdChannel.js';
 export { socket } from './addon/chat-controller/socket/@socket.js';
-export { SocketChannel } from './addon/chat-controller/socket/SocketChannel.js';
+export { SocketChannel, SocketChannelReceivedMessage } from './addon/chat-controller/socket/SocketChannel.js';
 export { SocketChannelConfig } from './addon/chat-controller/socket/SocketChannelConfig.js';
 export { telegram } from './addon/chat-controller/telegram/@telegram.js';
 export { TelegramChannelConfig } from './addon/chat-controller/telegram/TelegramChannelConfig.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wabot-dev/framework",
-  "version": "0.2.0-beta.1",
+  "version": "0.2.0-beta.10",
   "description": "Framework for IA Chat Bots",
   "type": "module",
   "main": "dist/src/index.js",
@@ -24,10 +24,6 @@
     "@rollup/plugin-json": "6.1.0",
     "@rollup/plugin-node-resolve": "16.0.1",
     "@rollup/plugin-typescript": "12.1.2",
-    "@types/big.js": "^6.2.2",
-    "@types/html-to-text": "^9.0.4",
-    "@types/node": "22.14.1",
-    "@types/react": "^19.1.2",
     "@yucacodes/ts": "^0.0.4",
     "prettier": "^3.5.3",
     "resend": "^4.4.1",
@@ -38,10 +34,13 @@
   "peerDependencies": {
     "@anthropic-ai/sdk": "^0.60.0",
     "@google/genai": "^1.16.0",
+    "@types/big.js": "^6.2.2",
     "@types/debug": "^4.1.12",
     "@types/express": "^5.0.1",
     "@types/jsonwebtoken": "^9.0.10",
     "@types/pg": "^8.11.14",
+    "@types/html-to-text": "^9.0.4",
+    "@types/node": "22.14.1",
     "@yucacodes/ts": "^0.0.4",
     "big.js": "^7.0.1",
     "body-parser": "^2.2.0",

package/dist/src/addon/auth/api-key/@apiKeyConnectionGuard.js

@@ -1,16 +0,0 @@
-import { connectionMiddleware } from '../../../feature/socket-controller/metadata/@connectionMiddleware.js';
-import '../../../core/injection/index.js';
-import '../../../feature/socket-controller/metadata/SocketControllerMetadataStore.js';
-import 'path';
-import 'debug';
-import '../../../feature/socket/SocketServerProvider.js';
-import '../../../core/validation/metadata/ValidationMetadataStore.js';
-import { ApiKeyConnectionGuardMiddleware } from './ApiKeyConnectionGuardMiddleware.js';
-
-function apiKeyConnectionGuard() {
-    return function (target, propertyKey) {
-        connectionMiddleware(ApiKeyConnectionGuardMiddleware)(target, propertyKey);
-    };
-}
-
-export { apiKeyConnectionGuard };

package/dist/src/addon/auth/jwt/@jwtConnectionGuard.js

@@ -1,16 +0,0 @@
-import { connectionMiddleware } from '../../../feature/socket-controller/metadata/@connectionMiddleware.js';
-import '../../../core/injection/index.js';
-import '../../../feature/socket-controller/metadata/SocketControllerMetadataStore.js';
-import 'path';
-import 'debug';
-import '../../../feature/socket/SocketServerProvider.js';
-import '../../../core/validation/metadata/ValidationMetadataStore.js';
-import { JwtConnectionGuardMiddleware } from './JwtConnectionGuardMiddleware.js';
-
-function jwtConnectionGuard() {
-    return function (target, propertyKey) {
-        connectionMiddleware(JwtConnectionGuardMiddleware)(target, propertyKey);
-    };
-}
-
-export { jwtConnectionGuard };

package/dist/src/feature/socket-controller/metadata/@connectionMiddleware.js

@@ -1,16 +0,0 @@
-import { SocketControllerMetadataStore } from './SocketControllerMetadataStore.js';
-import { container } from '../../../core/injection/index.js';
-
-function connectionMiddleware(middlewareConstructor) {
-    return function (target, propertyKey) {
-        const functionName = propertyKey.toString();
-        const store = container.resolve(SocketControllerMetadataStore);
-        store.saveConnectionMiddlewareMetadata({
-            controllerConstructor: target.constructor,
-            functionName,
-            middlewareConstructor: middlewareConstructor,
-        });
-    };
-}
-
-export { connectionMiddleware };

package/dist/src/feature/socket-controller/metadata/@socketConnection.js

@@ -1,18 +0,0 @@
-import { container } from '../../../core/injection/index.js';
-import { SocketControllerMetadataStore } from './SocketControllerMetadataStore.js';
-
-function socketConnection(config) {
-    return function (target, propertyKey) {
-        const functionName = propertyKey.toString();
-        const paramsTypes = Reflect.getMetadata('design:paramtypes', target, functionName);
-        const store = container.resolve(SocketControllerMetadataStore);
-        store.saveSocketConnectionMetadata({
-            controllerConstructor: target.constructor,
-            config: typeof config === 'string' ? { namespace: config } : config,
-            functionName,
-            paramsTypes,
-        });
-    };
-}
-
-export { socketConnection };