@wabot-dev/framework 0.9.0 → 0.9.2

package/dist/src/index.d.ts

@@ -11,7 +11,6 @@ import { Pool, PoolClient } from 'pg';
 import { AsyncLocalStorage } from 'node:async_hooks';
 import { Server as Server$1, Socket } from 'socket.io';
 import { Algorithm } from 'jsonwebtoken';
-import { Socket as Socket$1 } from 'socket.io-client';
 import { Wasender } from 'wasenderapi';
 
 type IStorablePrimitive = null | number | string | boolean | undefined;
@@ -32,21 +31,27 @@ declare class Auth<D> {
 }
 
 type ConfigReferenceType = 'string' | 'number' | 'boolean' | 'object' | 'string-array' | 'number-array' | 'boolean-array';
-interface ConfigReference {
+interface ConfigReference<TResolved = unknown> {
     type: ConfigReferenceType;
     path: string;
     default?: string;
     __isConfigReference: true;
+    __resolvedType?: TResolved;
 }
 
-declare function str(strings: TemplateStringsArray): ConfigReference;
-declare function num(strings: TemplateStringsArray): ConfigReference;
-declare function bool(strings: TemplateStringsArray): ConfigReference;
-declare function obj(strings: TemplateStringsArray): ConfigReference;
-declare function strArr(strings: TemplateStringsArray): ConfigReference;
-declare function numArr(strings: TemplateStringsArray): ConfigReference;
-declare function boolArr(strings: TemplateStringsArray): ConfigReference;
+declare function str(strings: TemplateStringsArray): ConfigReference<string>;
+declare function num(strings: TemplateStringsArray): ConfigReference<number>;
+declare function bool(strings: TemplateStringsArray): ConfigReference<boolean>;
+declare function obj<T = unknown>(strings: TemplateStringsArray): ConfigReference<T>;
+declare function strArr(strings: TemplateStringsArray): ConfigReference<string[]>;
+declare function numArr(strings: TemplateStringsArray): ConfigReference<number[]>;
+declare function boolArr(strings: TemplateStringsArray): ConfigReference<boolean[]>;
 
+type ResolveConfigValue<V> = V extends ConfigReference<infer R> ? R : V;
+type ResolvedConfig<T> = {
+    [K in keyof T]: ResolveConfigValue<T[K]>;
+};
+declare function resolveConfigReferences<T extends Record<string, any>>(config: T): ResolvedConfig<T>;
 declare class ConfigResolver {
     static resolve(reference: ConfigReference): unknown;
     private static loadFromEnv;
@@ -55,8 +60,6 @@ declare class ConfigResolver {
     private static parseArrayItems;
 }
 
-declare function resolveConfigReferences<T extends Record<string, any>>(config: T): T;
-
 interface ILockKey {
     run<T>(fn: () => Promise<T>): Promise<T>;
     tryRun<T>(fn: () => Promise<T>): Promise<T | undefined>;
@@ -465,7 +468,9 @@ interface ICronConfig {
     cron: string;
     disabled?: boolean;
 }
-declare function cron(config: ICronConfig): (target: IConstructor<ICronHandler>) => void;
+declare function cronHandler(config: ICronConfig): (target: IConstructor<ICronHandler>) => void;
+
+declare function transaction(dbNames?: readonly string[]): <This, A extends unknown[], R>(_target: object, _propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<(this: This, ...args: A) => Promise<R>>) => TypedPropertyDescriptor<(this: This, ...args: A) => Promise<R>>;
 
 interface ICronJobScheduleConfig {
     name: string;
@@ -494,6 +499,8 @@ declare class AsyncMetadataStore {
     requireCommandNameForHandler(handlerConstructor: IConstructor<ICommandHandler<any>>): string;
     getCommandName(command: IConstructor<any>): string | null;
     getCommandForCommandName(commandName: string): IConstructor<any> | null;
+    getAllCommandHandlers(): IConstructor<ICommandHandler<any>>[];
+    getAllCronHandlers(): IConstructor<ICronHandler>[];
 }
 
 interface IJobData extends IEntityData {
@@ -661,12 +668,24 @@ declare class CronJobRepository implements ICronJobRepository {
     findOrThrow(id: string): Promise<CronJob>;
 }
 
+interface ITransactionAdapter {
+    run<T>(fn: () => Promise<T>): Promise<T>;
+}
+
 declare function runCommandHandlers(handlers: IConstructor<ICommandHandler<any>>[]): void;
 declare function stopCommandHandlers(handlers: IConstructor<ICommandHandler<any>>[]): void;
 
 declare function runCronHandlers(handlers: IConstructor<ICronHandler>[]): void;
 declare function stopCronHandlers(handlers: IConstructor<ICronHandler>[]): void;
 
+declare class TransactionMetadataStore {
+    private adapters;
+    registerAdapter(dbName: string, adapter: ITransactionAdapter): void;
+    requireAdapter(dbName: string): ITransactionAdapter;
+    requireAdapters(dbNames: readonly string[]): ITransactionAdapter[];
+    getAllAdapters(): ITransactionAdapter[];
+}
+
 interface IChatConnection {
     chatType: 'GROUP' | 'PRIVATE';
     channelName: string;
@@ -1093,6 +1112,32 @@ declare function runChatAdapters(adapters: IConstructor<IChatAdapter>[]): void;
 
 declare function safeJsonParse<T = unknown>(json: string | undefined | null, context?: string): T;
 
+interface IProjectRunnerConfig {
+    directories?: string[];
+    connectionString?: string;
+    chatAdapters?: IConstructor<IChatAdapter>[];
+}
+declare class ProjectRunner {
+    private directories;
+    private chatAdapters;
+    private connectionString;
+    private isPg;
+    private pool;
+    constructor(config?: IProjectRunnerConfig);
+    run(): Promise<void>;
+    private resolveConnectionString;
+    private initPool;
+    private scanDirectories;
+    private importFiles;
+    private discoverComponents;
+    private registerAdapters;
+    private registerMemoryAdapters;
+    private registerPostgresAdapters;
+    private startComponents;
+    private resolveDefaultChatAdapters;
+}
+declare function run(config?: IProjectRunnerConfig): Promise<void>;
+
 interface IchatControllerConfig {
 }
 
@@ -1130,6 +1175,7 @@ declare class ControllerMetadataStore {
     private chatControllers;
     saveChannelMetadata(channelMetadata: IChannelMetadata): void;
     saveChatControllerMetadata(controllerMetadata: IChatControllerMetadata): void;
+    getAllChatControllerConstructors(): Function[];
     getChatControllerMetadata(controllerConstructor: Function): {
         config: IChatControllerMetadata;
         channels: IChannelMetadata[];
@@ -1388,6 +1434,7 @@ declare class RestControllerMetadataStore {
     saveControllerMetadata(controllerMetadata: IRestControllerMetadata): void;
     saveEndPointMetadata(endPointMetadata: IEndPointMetadata): void;
     saveMiddlewareMetadata(middlewareMetadata: IMiddlewareMetadata): void;
+    getAllRestControllerConstructors(): IConstructor<any>[];
     getControllerEndPointsInfo(controllerConstructor: IConstructor<any>): {
         controllerConstructor: IConstructor<any>;
         middlewares: IMiddlewareMetadata[];
@@ -1466,6 +1513,7 @@ declare class SocketControllerMetadataStore {
     saveControllerMetadata(controllerMetadata: ISocketControllerMetadata): void;
     saveSocketEventMetadata(socketEventMetadata: ISocketEventMetadata): void;
     saveHandshakeMiddlewareMetadata(handshakeMetadata: IHandshakeMiddlewareMetadata): void;
+    getAllSocketControllerConstructors(): IConstructor<any>[];
     getSocketControllerInfo(controllerConstructor: IConstructor<any>): {
         controller: ISocketControllerMetadata;
         events: Map<string, ISocketEventMetadata>;
@@ -1475,6 +1523,12 @@ declare class SocketControllerMetadataStore {
 
 declare function runSocketControllers(controllers: IConstructor<any>[]): void;
 
+declare class PgCronJobRepository extends PgCrudRepository<CronJob> implements ICronJobRepository {
+    constructor(pool: Pool);
+    findDue(date?: Date): Promise<CronJob[]>;
+    findByName(name: string): Promise<CronJob | null>;
+}
+
 declare class PgJobRepository extends PgCrudRepository<Job> implements IJobRepository {
     constructor(pool: Pool);
     findPendingForRunFrom(date: Date, limit: number): Promise<Job[]>;
@@ -1482,9 +1536,32 @@ declare class PgJobRepository extends PgCrudRepository<Job> implements IJobRepos
     countRunningByCommand(commandName: string): Promise<number>;
 }
 
-declare class PgCronJobRepository extends PgCrudRepository<CronJob> implements ICronJobRepository {
+declare class PgTransactionAdapter implements ITransactionAdapter {
+    private pool;
     constructor(pool: Pool);
+    run<T>(fn: () => Promise<T>): Promise<T>;
+}
+
+declare class InMemoryJobRepository implements IJobRepository {
+    private items;
+    find(id: string): Promise<Job | null>;
+    findOrThrow(id: string): Promise<Job>;
+    findByIds(ids: string[]): Promise<Job[]>;
+    findAll(): Promise<Job[]>;
+    create(item: Job): Promise<void>;
+    update(item: Job): Promise<void>;
+    delete(item: Job): Promise<void>;
+    findPendingForRunFrom(date: Date, limit: number): Promise<Job[]>;
+    findRunningJobs(): Promise<Job[]>;
+    countRunningByCommand(commandName: string): Promise<number>;
+}
+
+declare class InMemoryCronJobRepository implements ICronJobRepository {
+    private items;
+    create(cronJob: CronJob): Promise<void>;
     findDue(date?: Date): Promise<CronJob[]>;
+    findOrThrow(id: string): Promise<CronJob>;
+    update(cronJob: CronJob): Promise<void>;
     findByName(name: string): Promise<CronJob | null>;
 }
 
@@ -1767,14 +1844,14 @@ declare class PgChatMemory extends PgCrudRepository<ChatItem> implements IChatMe
     findLastItems(count: number): Promise<ChatItem[]>;
 }
 
-declare class RamChatMemory implements IChatMemory {
+declare class InMemoryChatMemory implements IChatMemory {
     private memory;
     findLastItems(count: number): Promise<ChatItem[]>;
     create(item: ChatItem): Promise<void>;
     clearMemory(): Promise<void>;
 }
 
-declare class RamChatRepository implements IChatRepository {
+declare class InMemoryChatRepository implements IChatRepository {
     private items;
     private memories;
     update(chat: Chat): Promise<void>;
@@ -1821,17 +1898,11 @@ declare function writeJsonToFile<T>(filename: string, data: T): void;
 declare function readJsonFromFile<T>(filename: string): T | null;
 
 interface ISocketChannelConfig {
-    namespace: string;
+    namespace: string | ConfigReference<string>;
     handshakeMidlewares?: IConstructor<IHandshakeMiddleware>[];
 }
 
-declare class SocketChannelConfig implements ISocketChannelConfig {
-    namespace: string;
-    handshakeMidlewares?: IConstructor<IHandshakeMiddleware>[] | undefined;
-    constructor(namespace: string, handshakeMidlewares?: IConstructor<IHandshakeMiddleware>[] | undefined);
-}
-
-declare function socket(config: SocketChannelConfig): (target: object, propertyKey: string | symbol) => void;
+declare function socket(config: ISocketChannelConfig): (target: object, propertyKey: string | symbol) => void;
 
 declare const socketChannelName: "SocketChannel";
 
@@ -1844,6 +1915,15 @@ interface ISocketChannelMessage extends ISocketReceivedMessage {
     injectInstances?: [any, any][];
 }
 
+declare class SocketChannelConfig {
+    namespace: string;
+    handshakeMidlewares?: IConstructor<IHandshakeMiddleware>[];
+    constructor(config: {
+        namespace: string;
+        handshakeMidlewares?: IConstructor<IHandshakeMiddleware>[];
+    });
+}
+
 declare class SocketChannelMessageFile {
     id: string;
     mimeType: string;
@@ -1910,99 +1990,6 @@ declare class TelegramChannel implements IChatChannel {
     disconnect(): void;
 }
 
-interface IWhatsappChannelConfig {
-    number: string;
-    proxy?: string;
-}
-declare class WhatsappChannelConfig implements IWhatsappChannelConfig {
-    number: string;
-    constructor(number: string);
-}
-
-declare function whatsApp(config: string | IWhatsappChannelConfig): (target: object, propertyKey: string | symbol) => void;
-
-interface IWhatsAppBusinessNumber {
-    id: string;
-    number: string;
-}
-interface IWhatsAppBusinessAccount {
-    id: string;
-}
-interface IWhatsAppData extends IEntityData {
-    slug: string;
-    verifyToken: string;
-    appSecret: string;
-    accessToken: string;
-    businessAccount: IWhatsAppBusinessAccount;
-    businessNumbers: IWhatsAppBusinessNumber[];
-}
-declare class WhatsApp extends Entity<IWhatsAppData> {
-    getVerifyToken(): string;
-    getSlug(): string;
-    getBusinessAccount(): IWhatsAppBusinessAccount;
-    getAppSecret(): string;
-    getBusinessNumbers(): {
-        id: string;
-        number: string;
-    }[];
-    getAccessToken(): string;
-    hasBusinessNumber(number: string): boolean;
-    getBussinessNumber(number: string): IWhatsAppBusinessNumber | null;
-}
-
-interface IWhatsAppRepository {
-    findBySlug(slug: string): Promise<WhatsApp | null>;
-    findByBusinessNumber(number: string): Promise<WhatsApp | null>;
-}
-
-declare class EnvWhatsAppRepository implements IWhatsAppRepository {
-    private env;
-    constructor(env: Env);
-    findBySlug(slug: string): Promise<WhatsApp | null>;
-    findByBusinessNumber(number: string): Promise<WhatsApp | null>;
-    private getFromEnvVars;
-}
-
-declare class PgWhatsAppRepository extends PgCrudRepository<WhatsApp> implements IWhatsAppRepository {
-    constructor(pool: Pool);
-    findBySlug(slug: string): Promise<WhatsApp | null>;
-    findByBusinessNumber(number: string): Promise<WhatsApp | null>;
-}
-
-type IWhatsAppMessageListener = (message: Omit<IChannelMessage, 'reply'>) => Promise<void>;
-interface IListenWhatsAppMessageRequest {
-    to: string;
-    listener: IWhatsAppMessageListener;
-}
-declare class WhatsAppReceiver {
-    connect(): Promise<void>;
-    disconnect(): void;
-    listenMessage(request: IListenWhatsAppMessageRequest): void;
-}
-
-type IWhatsAppCloudTemplateParameter = {
-    type: 'text';
-    text: string;
-    parameter_name?: string;
-} | {
-    type: 'currency';
-    currency: {
-        fallback_value: string;
-        code: string;
-        amount_1000: number;
-    };
-} | {
-    type: 'date_time';
-    date_time: {
-        fallback_value: string;
-    };
-};
-interface IWhatsAppCloudTemplateMessage {
-    templateName: string;
-    languageCode: string;
-    parameters: IWhatsAppCloudTemplateParameter[];
-}
-
 interface IWhatsAppCloudTemplateResponse {
     data: IWhatsAppCloudTemplate[];
     paging: IWhatsAppCloudApiPaging;
@@ -2029,66 +2016,6 @@ interface IWhatsAppCloudApiCursors {
     after: string;
 }
 
-declare class WhatsAppRepository implements IWhatsAppRepository {
-    findBySlug(slug: string): Promise<WhatsApp | null>;
-    findByBusinessNumber(number: string): Promise<WhatsApp | null>;
-}
-
-interface ISendWhatsAppRequest {
-    from: string;
-    to: string;
-    message: IChatMessage;
-}
-interface ISendWhatsAppTemplateRequest {
-    from: string;
-    to: string;
-    templateMessage: IWhatsAppCloudTemplateMessage;
-    senderName: string;
-}
-interface IGetWhatsAppTemplateRequest {
-    from: string;
-    templateName: string;
-    languageCode: string;
-}
-interface IWhatsAppSenderOptions {
-    writeChatMemory?: boolean;
-}
-declare class WhatsAppSender {
-    protected chatRepository: ChatRepository;
-    protected chatResolver: ChatResolver;
-    protected whatsAppRepository: WhatsAppRepository;
-    constructor(chatRepository: ChatRepository, chatResolver: ChatResolver, whatsAppRepository: WhatsAppRepository);
-    sendWhatsApp(request: ISendWhatsAppRequest, options?: IWhatsAppSenderOptions): Promise<void>;
-    sendWhatsAppTemplate(request: ISendWhatsAppTemplateRequest, options?: IWhatsAppSenderOptions): Promise<void>;
-    protected getWhatsAppTemplate(request: IGetWhatsAppTemplateRequest): Promise<IWhatsAppCloudTemplate | null>;
-    protected mapTemplateToChatMessage(request: ISendWhatsAppTemplateRequest): Promise<IChatMessage>;
-    protected writePrivateChatMemory(message: IChatMessage, to: string): Promise<void>;
-    protected replaceTemplateParameters(template: string, data: IWhatsAppCloudTemplateParameter[]): string;
-}
-
-declare const whatsAppChannelName: "WhatsAppChannel";
-
-interface IWhatsAppReceivedMessage extends IReceivedMessage {
-    channel: typeof whatsAppChannelName;
-}
-
-interface IWhatsAppChannelMessage extends IWhatsAppReceivedMessage {
-    chatConnection: IChatConnection;
-    injectInstances?: [any, any][];
-}
-
-declare class WhatsAppChannel implements IChatChannel {
-    private config;
-    private sender;
-    private receiver;
-    static channelName: "WhatsAppChannel";
-    private logger;
-    constructor(config: WhatsappChannelConfig, sender: WhatsAppSender, receiver: WhatsAppReceiver);
-    listen(callback: (message: IWhatsAppChannelMessage) => Promise<void>): void;
-    connect(): void;
-    disconnect(): void;
-}
-
 interface IWhatsAppCloudWebhookPayload {
     object: 'whatsapp_business_account';
     entry: IWhatsAppCloudEntry[];
@@ -2141,95 +2068,84 @@ interface IWhatsAppCloudAudioMessage extends IWhatsAppCloudBaseMessage {
     };
 }
 
-declare class WhatsAppReceiverByCloudApi extends WhatsAppReceiver {
+type IWhatsAppMessageListener = (message: Omit<IChannelMessage, 'reply'>) => Promise<void>;
+interface IListenWhatsAppMessageRequest {
+    to: string;
+    listener: IWhatsAppMessageListener;
+}
+declare class WhatsAppApiReceiver {
+    connect(): Promise<void>;
+    disconnect(): void;
+    listenMessage(request: IListenWhatsAppMessageRequest): void;
+}
+
+declare class WhatsAppReceiverByCloudApi extends WhatsAppApiReceiver {
     private expressProvider;
-    private whatsAppRepository;
     private listeners;
     private expressApp;
     private logger;
     private webhookPath;
-    constructor(expressProvider: ExpressProvider, whatsAppRepository: WhatsAppRepository);
+    constructor(expressProvider: ExpressProvider);
     connect(): Promise<void>;
     listenMessage(request: IListenWhatsAppMessageRequest): void;
     protected handlePayload(payload: IWhatsAppCloudWebhookPayload): Promise<void>;
     private emmitMessage;
 }
 
-declare class WhatsAppSenderByCloudApi extends WhatsAppSender {
-    private logger;
-    constructor(chatRepository: ChatRepository, chatResolver: ChatResolver, whatsAppRepository: WhatsAppRepository);
-    sendWhatsApp(request: ISendWhatsAppRequest, options?: IWhatsAppSenderOptions): Promise<void>;
-    sendWhatsAppTemplate(request: ISendWhatsAppTemplateRequest, options?: IWhatsAppSenderOptions): Promise<void>;
-    protected getWhatsAppTemplate(request: IGetWhatsAppTemplateRequest): Promise<IWhatsAppCloudTemplate | null>;
-}
-
-interface IWhatsAppProxyMessageContent {
+type IWhatsAppTemplateParameter = {
+    type: 'text';
     text: string;
+    parameter_name?: string;
+} | {
+    type: 'currency';
+    currency: {
+        fallback_value: string;
+        code: string;
+        amount_1000: number;
+    };
+} | {
+    type: 'date_time';
+    date_time: {
+        fallback_value: string;
+    };
+};
+interface IWhatsAppTemplateData {
+    templateName: string;
+    languageCode: string;
+    parameters: IWhatsAppTemplateParameter[];
 }
-
-interface IWhatsAppProxyMessage {
+interface ISendWhatsAppMessageReq {
     from: string;
     to: string;
-    senderName?: string;
-    content: IWhatsAppProxyMessageContent;
-}
-
-declare const WHATSAPP_PROXY_SEND_MESSAGE_EVENT: "sendMessage";
-interface IWhatsAppProxySendMessageEventReq {
-    event: typeof WHATSAPP_PROXY_SEND_MESSAGE_EVENT;
-    data: IWhatsAppProxyMessage;
-}
-declare const WHATSAPP_PROXY_LISTEN_MESSAGE_EVENT: "listenMessage";
-interface IWhatsAppProxyListenMessageEventReq {
-    event: typeof WHATSAPP_PROXY_LISTEN_MESSAGE_EVENT;
-    data: IWhatsAppProxyListenMessageEventData;
+    message: IChatMessage;
 }
-interface IWhatsAppProxyListenMessageEventData {
-    from?: string[];
+interface ISendWhatsAppTemplateReq {
+    from: string;
     to: string;
+    templateData: IWhatsAppTemplateData;
+    senderName: string;
 }
-declare const WHATSAPP_MESSAGE_EVENT: "message";
-interface IWhatsAppProxyMessageEventReq {
-    event: typeof WHATSAPP_MESSAGE_EVENT;
-    data: IWhatsAppProxyMessage;
-}
-
-declare class WhatsAppWabotProxyConnection {
-    private baseUrl;
-    private socket;
-    private apiKey;
-    private logger;
-    constructor(env: Env);
-    getSocket(): Promise<Socket$1>;
-}
-
-declare class WhatsAppReceiverByWabotProxy extends WhatsAppReceiver {
-    private connection;
-    private loger;
-    constructor(connection: WhatsAppWabotProxyConnection);
-    connect(): Promise<void>;
-    listenMessage(request: IListenWhatsAppMessageRequest): void;
+interface IWhatsAppSender {
+    sendMessage(request: ISendWhatsAppMessageReq): Promise<void>;
+    sendTemplate(request: ISendWhatsAppTemplateReq): Promise<void>;
 }
 
-declare class WhatsAppSenderByWabotProxy extends WhatsAppSender {
-    private wabotDevConnection;
-    private logger;
-    constructor(wabotDevConnection: WhatsAppWabotProxyConnection, chatRepository: ChatRepository, chatResolver: ChatResolver, whatsAppRepository: WhatsAppRepository);
-    sendWhatsApp(request: ISendWhatsAppRequest, options?: IWhatsAppSenderOptions): Promise<void>;
+declare class WhatsAppApiSender implements IWhatsAppSender {
+    private accessToken;
+    private businessNumberId;
+    constructor(accessToken: string, businessNumberId: string);
+    sendMessage(request: ISendWhatsAppMessageReq): Promise<void>;
+    sendTemplate(request: ISendWhatsAppTemplateReq): Promise<void>;
 }
 
-interface IWhatsAppByWasenderChannelConfig {
-    apiKey?: string;
-    webhookSecret?: string;
-    phoneNumber?: string;
+interface IWasenderChannelConfig {
+    apiKey?: string | ConfigReference<string>;
+    webhookSecret?: string | ConfigReference<string>;
+    phoneNumber?: string | ConfigReference<string>;
     webhookPath?: string;
-    retryOptions?: {
-        enabled: boolean;
-        maxRetries: number;
-    };
 }
 
-declare function whatsAppByWasender(config?: IWhatsAppByWasenderChannelConfig): (target: object, propertyKey: string | symbol) => void;
+declare function wasender(config?: IWasenderChannelConfig): (target: object, propertyKey: string | symbol) => void;
 
 type IWasenderEvent = IWasenderMessageReceivedEvent | IWasenderQrUpdatedEvent;
 interface IWasenderQrUpdatedEvent {
@@ -2276,7 +2192,7 @@ interface IWasenderDeviceListMetadata {
     recipientTimestamp: string;
 }
 
-declare class WhatsAppByWasenderChannelConfig implements IWhatsAppByWasenderChannelConfig {
+declare class WasenderChannelConfig {
     readonly apiKey?: string;
     readonly webhookSecret?: string;
     readonly phoneNumber?: string;
@@ -2285,40 +2201,45 @@ declare class WhatsAppByWasenderChannelConfig implements IWhatsAppByWasenderChan
         enabled: boolean;
         maxRetries: number;
     };
-    constructor(config: IWhatsAppByWasenderChannelConfig);
+    constructor(config: {
+        apiKey?: string;
+        webhookSecret?: string;
+        phoneNumber?: string;
+        webhookPath?: string;
+    });
 }
 
-interface IWhatsAppByWasenderChatMessage extends IChatMessage {
+interface IWasenderChatMessage extends IChatMessage {
     metadata: {
         whatsAppNumber: string;
     };
 }
 
-declare const whatsAppByWasenderChannelName: "WhatsAppByWasenderChannel";
+declare const wasenderChannelName: "WhatsAppByWasenderChannel";
 
-interface IWhatsAppByWasenderReceivedMessage extends IReceivedMessage {
-    channel: typeof whatsAppByWasenderChannelName;
-    message: IWhatsAppByWasenderChatMessage;
+interface IWasenderReceivedMessage extends IReceivedMessage {
+    channel: typeof wasenderChannelName;
+    message: IWasenderChatMessage;
 }
 
-interface IWhatsAppByWasenderChannelMessage extends IWhatsAppByWasenderReceivedMessage {
+interface IWasenderChannelMessage extends IWasenderReceivedMessage {
     chatConnection: IChatConnection;
     injectInstances?: [any, any][];
 }
 
-declare class WhatsAppByWasenderChannel implements IChatChannel {
+declare class WasenderChannel implements IChatChannel {
     private logger;
     private sender;
     private receiver;
     private phoneNumber;
     static channelName: "WhatsAppByWasenderChannel";
-    constructor(config: WhatsAppByWasenderChannelConfig, env: Env);
-    listen(callback: (message: IWhatsAppByWasenderChannelMessage) => Promise<void>): void;
+    constructor(config: WasenderChannelConfig, env: Env);
+    listen(callback: (message: IWasenderChannelMessage) => Promise<void>): void;
     connect(): void;
     disconnect(): void;
 }
 
-type IWasenderChannelMessageListener = (message: IWhatsAppByWasenderChatMessage, from: string) => Promise<void>;
+type IWasenderChannelMessageListener = (message: IWasenderChatMessage, from: string) => Promise<void>;
 declare class WasenderWebhookController {
     private wasender;
     private listener;
@@ -2330,7 +2251,7 @@ declare class WasenderWebhookController {
     private getRawBody;
 }
 
-declare class WhatsAppReceiverByWasender {
+declare class WasenderReceiver {
     private config;
     private wasender;
     private listener;
@@ -2348,23 +2269,36 @@ declare class WhatsAppReceiverByWasender {
     disconnect(): void;
 }
 
-interface ISendByWasenderRequest {
-    from: string;
-    to: string;
-    message: IChatMessage;
-}
-declare class WhatsAppSenderByWasender {
+declare class WasenderSender implements IWhatsAppSender {
     private wasender;
     private logger;
     constructor(apiKey: string, retryOptions?: {
         enabled: boolean;
         maxRetries: number;
     });
-    send(request: ISendByWasenderRequest): Promise<void>;
+    sendMessage(request: ISendWhatsAppMessageReq): Promise<void>;
+    sendTemplate(request: ISendWhatsAppTemplateReq): Promise<void>;
 }
 
 declare function extractNumberFromWasenderMessageKey(key: IWasenderMessageKey): string;
 
+declare class WhatsAppSender implements IWhatsAppSender {
+    sendMessage(request: ISendWhatsAppMessageReq): Promise<void>;
+    sendTemplate(request: ISendWhatsAppTemplateReq): Promise<void>;
+}
+
+declare class InMemoryLockKey implements ILockKey {
+    private readonly key;
+    private static locks;
+    constructor(key: string | number);
+    run<T>(fn: () => Promise<T>): Promise<T>;
+    tryRun<T>(fn: () => Promise<T>): Promise<T | undefined>;
+}
+
+declare class InMemoryLocker implements ILocker {
+    withKey(key: string | number | ILockerKey): ILockKey;
+}
+
 interface IHtmlModuleOptions {
     url: string;
     title: string;
@@ -2373,4 +2307,4 @@ declare function HtmlModule(options: IHtmlModuleOptions): {
     new (): {};
 };
 
-export { AnthropicChatAdapter, ApiKey, ApiKeyGuardMiddleware, ApiKeyHandshakeGuardMiddleware, ApiKeyRepository, Async, AsyncMetadataStore, Auth, Chat, ChatAdapter, ChatAdapterMetadataStore, ChatAdapterRegistry, ChatBot, ChatBotMetadataStore, ChatItem, ChatMemory, ChatOperator, ChatRepository, ChatResolver, type ClientMap, CmdChannel, type ConfigReference, type ConfigReferenceType, ConfigResolver, Container, ControllerMetadataStore, CronJob, CronJobRepository, CustomError, DeepSeekChatAdapter, DescriptionMetadataStore, EXPRESS_REQ, EXPRESS_RES, Entity, Env, EnvWhatsAppRepository, type ErrorSeverity, ExpressProvider, GoogleChatAdapter, type GoogleChatAdapterV2Options, HtmlModule, HttpServerProvider, type IApiKeyData, type IApiKeyRepository, type IArrayValidationError, type IArrayValidationResult, type IBotMessageItem, type IBuiltQuery, type IChannelMessage, type IChannelMetadata, type IChatAdapter, type IChatAdapterDecoratorConfig, type IChatAdapterMetadata, type IChatAdapterNextItemsReq, type IChatAdapterNextItemsRes, type IChatAssociation, type IChatBot, type IChatBotMetadata, type IChatChannel, type IChatConnection, type IChatControllerMetadata, type IChatData, type IChatItem, type IChatItemData, type IChatItemType, type IChatMemory, type IChatMessage, type IChatMessageDocument, type IChatMessageFile, type IChatMessageImage, type IChatMessagesPrivateFile, type IChatMessagesPublicFile, type IChatRepository, type IChatType, type ICmdChannelMessage, type ICmdReceivedMessage, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConstructor, type ICronConfig, type ICronJobData, type ICrudRepository, type ICustomErrorData, type IDescriptionMetadata, type IEndPointConfig, type IEndPointMetadata, type IEntityData, type IEnvType, type IErrorHandlersConfig, type IErrorMonitor, type IErrorMonitorContext, type IExtractChatMessageTextOptions, type IFunctionCall, type IFunctionCallItem, type IGenerateApiKeyReq, type IGenerateApiKeyRes, type IGetWhatsAppTemplateRequest, type IHandshakeMiddleware, type IHandshakeMiddlewareMetadata, type IHtmlModuleOptions, type IHumanMessageItem, type IJobData, type IJobRepository, type IJwtRefreshTokenData, type IJwtRefreshTokenRepository, type ILanguageModelUsage, type IListenWhatsAppMessageRequest, type ILockKey, type ILocker, type ILockerKey, type IMessageContext, type IMiddleware, type IMiddlewareMetadata, type IMindset, type IMindsetConfig, type IMindsetIdentity, type IMindsetLlm, type IMindsetMetadata, type IMindsetModelKind, type IMindsetModelRef, type IMindsetModels, type IMindsetModuleConfig, type IMindsetModuleMetadata, type IMindsetTool, type IMindsetToolParameter, type IModelValidationError, type IModelValidationResult, type IModelValidatorsInfo, type IMoneyData, type IPersistentData, type IPgRepositoryConfig, type IPropertyValidatorInfo, type IQueryAst, type IQueryCondition, type IQueryMethodMetadata, type IQueryOrderBy, type IReceivedMessage, type IRemoteApiKeyFetcher, type IRestControllerConfig, type IRestControllerMetadata, type IScheduleAt, type IScheduleDelay, type ISendByWasenderRequest, type ISendWhatsAppRequest, type ISendWhatsAppTemplateRequest, type ISocketChannelConfig, type ISocketChannelMessage, type ISocketChannelReceivedMessage, type ISocketControllerConfig, type ISocketControllerMetadata, type ISocketEventConfig, type ISocketEventMetadata, type ISocketReceivedMessage, type IStorableData, type ITelegramChannelConfig, type ITelegramChannelMessage, type ITelegramReceivedMessage, type IValidateArrayOptions, type IValidateArrayOptionsWithItemsValidators, type IValidateInputShape, type IValidateIsInOptions, type IValidateIsRecordOptions, type IValidateMaxOptions, type IValidateMinOptions, type IValidationError, type IValidationResult, type IValidator, type IValidatorMetadata, type IWasenderChannelMessageListener, type IWasenderDeviceListMetadata, type IWasenderEvent, type IWasenderMessageContent, type IWasenderMessageContextInfo, type IWasenderMessageKey, type IWasenderMessageReceivedData, type IWasenderMessageReceivedEvent, type IWasenderQrUpdatedEvent, type IWhatsAppBusinessAccount, type IWhatsAppBusinessNumber, type IWhatsAppByWasenderChannelConfig, type IWhatsAppByWasenderReceivedMessage, type IWhatsAppChannelMessage, 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 IWhatsAppReceivedMessage, type IWhatsAppRepository, type IWhatsAppSenderOptions, type IWhatsappChannelConfig, type IchatControllerConfig, Job, JobRepository, JobRunner, Jwt, JwtAccessAndRefreshTokenDto, JwtConfig, JwtGuardMiddleware, JwtHandshakeGuardMiddleware, JwtRefreshToken, JwtRefreshTokenRepository, JwtSigner, JwtTokenDto, Lifecycle, Locker, Logger, Mapper, Mindset, MindsetMetadataStore, MindsetOperator, Money, MoneyDto, OpenRouterChatAdapter, OpenaiChatAdapter, Password, type PasswordHashOptions, Persistent, PgApiKeyRepository, PgChatMemory, PgChatRepository, PgCronJobRepository, PgCrudRepository, PgJobRepository, PgJsonRepository, PgJwtRefreshTokenRepository, PgLockKey, PgLocker, PgRepositoryBase, PgRepositoryMetadataStore, PgWhatsAppRepository, type QueryConnector, type QueryOperator, type QueryPrefix, RamChatMemory, RamChatRepository, Random, RemoteApiKeyRepository, RestControllerMetadataStore, RestRequest, SocketChannel, SocketChannelConfig, SocketChannelMessageFile, SocketChannelReceivedMessage, SocketControllerMetadataStore, SocketServerConfig, SocketServerProvider, Storable, TelegramChannel, TelegramChannelConfig, UnionChatAdapter, ValidationMetadataStore, WHATSAPP_MESSAGE_EVENT, WHATSAPP_PROXY_LISTEN_MESSAGE_EVENT, WHATSAPP_PROXY_SEND_MESSAGE_EVENT, WabotChatAdapter, WasenderWebhookController, WhatsApp, WhatsAppByWasenderChannel, WhatsAppByWasenderChannelConfig, WhatsAppChannel, WhatsAppReceiver, WhatsAppReceiverByCloudApi, WhatsAppReceiverByWabotProxy, WhatsAppReceiverByWasender, WhatsAppRepository, WhatsAppSender, WhatsAppSenderByCloudApi, WhatsAppSenderByWabotProxy, WhatsAppSenderByWasender, WhatsAppWabotProxyConnection, WhatsappChannelConfig, apiKeyGuard, apiKeyHandshakeGuard, bool, boolArr, buildQuerySql, chatAdapter, chatBot, chatController, chatItemTypeOptions, cmd, cmdChannelName, command, commandHandler, container, cron, description, errorToPlainObject, extractChatMessageText, extractNumberFromWasenderMessageKey, getClientMap, getPgClient, handshakeMiddlewares, inject, injectable, isArray, isBoolean, isChatMessageEmpty, isDate, isIn, isModel, isNotEmpty, isNumber, isOptional, isPresent, isRecord, isRetryableError, isString, jwtGuard, jwtHandshakeGuard, max, middleware, min, mindset, mindsetModule, modelInfo, num, numArr, obj, onDelete, onGet, onPost, onPut, onSocketEvent, parseQueryMethodName, pgJsonRepository, pgStorage, query, readJsonFromFile, resolveConfigReferences, restController, runChatAdapters, runChatControllers, runCommandHandlers, runCronHandlers, runRestControllers, runSocketControllers, safeJsonParse, scoped, setupErrorHandlers, singleton, socket, socketChannelName, socketController, stopCommandHandlers, stopCronHandlers, str, strArr, telegram, telegramChannelName, validateAndTransform, validateArray, validateIsBoolean, validateIsDate, validateIsIn, validateIsNotEmpty, validateIsNumber, validateIsPresent, validateIsRecord, validateIsString, validateMax, validateMin, validateModel, whatsApp, whatsAppByWasender, whatsAppByWasenderChannelName, whatsAppChannelName, withPgClient, withPgTransaction, writeJsonToFile };
+export { AnthropicChatAdapter, ApiKey, ApiKeyGuardMiddleware, ApiKeyHandshakeGuardMiddleware, ApiKeyRepository, Async, AsyncMetadataStore, Auth, Chat, ChatAdapter, ChatAdapterMetadataStore, ChatAdapterRegistry, ChatBot, ChatBotMetadataStore, ChatItem, ChatMemory, ChatOperator, ChatRepository, ChatResolver, type ClientMap, CmdChannel, type ConfigReference, type ConfigReferenceType, ConfigResolver, Container, ControllerMetadataStore, CronJob, CronJobRepository, CustomError, DeepSeekChatAdapter, DescriptionMetadataStore, EXPRESS_REQ, EXPRESS_RES, Entity, Env, type ErrorSeverity, ExpressProvider, GoogleChatAdapter, type GoogleChatAdapterV2Options, HtmlModule, HttpServerProvider, type IApiKeyData, type IApiKeyRepository, type IArrayValidationError, type IArrayValidationResult, type IBotMessageItem, type IBuiltQuery, type IChannelMessage, type IChannelMetadata, type IChatAdapter, type IChatAdapterDecoratorConfig, type IChatAdapterMetadata, type IChatAdapterNextItemsReq, type IChatAdapterNextItemsRes, type IChatAssociation, type IChatBot, type IChatBotMetadata, type IChatChannel, type IChatConnection, type IChatControllerMetadata, type IChatData, type IChatItem, type IChatItemData, type IChatItemType, type IChatMemory, type IChatMessage, type IChatMessageDocument, type IChatMessageFile, type IChatMessageImage, type IChatMessagesPrivateFile, type IChatMessagesPublicFile, type IChatRepository, type IChatType, type ICmdChannelMessage, type ICmdReceivedMessage, type ICommandConfig, type ICommandHandler, type ICommandHandlerConfig, type IConstructor, type ICronConfig, type ICronHandler, type ICronJobData, type ICronJobRepository, type ICrudRepository, type ICustomErrorData, type IDescriptionMetadata, type IEndPointConfig, type IEndPointMetadata, type IEntityData, type IEnvType, type IErrorHandlersConfig, type IErrorMonitor, type IErrorMonitorContext, type IExtractChatMessageTextOptions, type IFunctionCall, type IFunctionCallItem, type IGenerateApiKeyReq, type IGenerateApiKeyRes, type IHandshakeMiddleware, type IHandshakeMiddlewareMetadata, type IHtmlModuleOptions, type IHumanMessageItem, type IJobData, type IJobRepository, type IJwtRefreshTokenData, type IJwtRefreshTokenRepository, type ILanguageModelUsage, type ILockKey, type ILocker, type ILockerKey, type IMessageContext, type IMiddleware, type IMiddlewareMetadata, type IMindset, type IMindsetConfig, type IMindsetIdentity, type IMindsetLlm, type IMindsetMetadata, type IMindsetModelKind, type IMindsetModelRef, type IMindsetModels, type IMindsetModuleConfig, type IMindsetModuleMetadata, type IMindsetTool, type IMindsetToolParameter, type IModelValidationError, type IModelValidationResult, type IModelValidatorsInfo, type IMoneyData, type IPersistentData, type IPgRepositoryConfig, type IProjectRunnerConfig, type IPropertyValidatorInfo, type IQueryAst, type IQueryCondition, type IQueryMethodMetadata, type IQueryOrderBy, type IReceivedMessage, type IRemoteApiKeyFetcher, type IRestControllerConfig, type IRestControllerMetadata, type IScheduleAt, type IScheduleDelay, type ISendWhatsAppMessageReq, type ISendWhatsAppTemplateReq, type ISocketChannelConfig, type ISocketChannelMessage, type ISocketChannelReceivedMessage, type ISocketControllerConfig, type ISocketControllerMetadata, type ISocketEventConfig, type ISocketEventMetadata, type ISocketReceivedMessage, type IStorableData, type ITelegramChannelConfig, type ITelegramChannelMessage, type ITelegramReceivedMessage, type ITransactionAdapter, type IValidateArrayOptions, type IValidateArrayOptionsWithItemsValidators, type IValidateInputShape, type IValidateIsInOptions, type IValidateIsRecordOptions, type IValidateMaxOptions, type IValidateMinOptions, type IValidationError, type IValidationResult, type IValidator, type IValidatorMetadata, type IWasenderChannelConfig, type IWasenderChannelMessageListener, type IWasenderDeviceListMetadata, type IWasenderEvent, type IWasenderMessageContent, type IWasenderMessageContextInfo, type IWasenderMessageKey, type IWasenderMessageReceivedData, type IWasenderMessageReceivedEvent, type IWasenderQrUpdatedEvent, type IWasenderReceivedMessage, type IWhatsAppCloudContact, type IWhatsAppCloudMessage, type IWhatsAppCloudMessageMetadata, type IWhatsAppCloudTemplate, type IWhatsAppCloudTemplateComponent, type IWhatsAppCloudTemplateResponse, type IWhatsAppCloudWebhookPayload, type IWhatsAppSender, type IWhatsAppTemplateData, type IWhatsAppTemplateParameter, type IchatControllerConfig, InMemoryChatMemory, InMemoryChatRepository, InMemoryCronJobRepository, InMemoryJobRepository, InMemoryLockKey, InMemoryLocker, Job, JobRepository, JobRunner, Jwt, JwtAccessAndRefreshTokenDto, JwtConfig, JwtGuardMiddleware, JwtHandshakeGuardMiddleware, JwtRefreshToken, JwtRefreshTokenRepository, JwtSigner, JwtTokenDto, Lifecycle, Locker, Logger, Mapper, Mindset, MindsetMetadataStore, MindsetOperator, Money, MoneyDto, OpenRouterChatAdapter, OpenaiChatAdapter, Password, type PasswordHashOptions, Persistent, PgApiKeyRepository, PgChatMemory, PgChatRepository, PgCronJobRepository, PgCrudRepository, PgJobRepository, PgJsonRepository, PgJwtRefreshTokenRepository, PgLockKey, PgLocker, PgRepositoryBase, PgRepositoryMetadataStore, PgTransactionAdapter, ProjectRunner, type QueryConnector, type QueryOperator, type QueryPrefix, Random, RemoteApiKeyRepository, type ResolvedConfig, RestControllerMetadataStore, RestRequest, SocketChannel, SocketChannelConfig, SocketChannelMessageFile, SocketChannelReceivedMessage, SocketControllerMetadataStore, SocketServerConfig, SocketServerProvider, Storable, TelegramChannel, TelegramChannelConfig, TransactionMetadataStore, UnionChatAdapter, ValidationMetadataStore, WabotChatAdapter, WasenderChannel, WasenderChannelConfig, WasenderReceiver, WasenderSender, WasenderWebhookController, WhatsAppApiSender, WhatsAppReceiverByCloudApi, WhatsAppSender, apiKeyGuard, apiKeyHandshakeGuard, bool, boolArr, buildQuerySql, chatAdapter, chatBot, chatController, chatItemTypeOptions, cmd, cmdChannelName, command, commandHandler, container, cronHandler, description, errorToPlainObject, extractChatMessageText, extractNumberFromWasenderMessageKey, getClientMap, getPgClient, handshakeMiddlewares, inject, injectable, isArray, isBoolean, isChatMessageEmpty, isDate, isIn, isModel, isNotEmpty, isNumber, isOptional, isPresent, isRecord, isRetryableError, isString, jwtGuard, jwtHandshakeGuard, max, middleware, min, mindset, mindsetModule, modelInfo, num, numArr, obj, onDelete, onGet, onPost, onPut, onSocketEvent, parseQueryMethodName, pgJsonRepository, pgStorage, query, readJsonFromFile, resolveConfigReferences, restController, run, runChatAdapters, runChatControllers, runCommandHandlers, runCronHandlers, runRestControllers, runSocketControllers, safeJsonParse, scoped, setupErrorHandlers, singleton, socket, socketChannelName, socketController, stopCommandHandlers, stopCronHandlers, str, strArr, telegram, telegramChannelName, transaction, validateAndTransform, validateArray, validateIsBoolean, validateIsDate, validateIsIn, validateIsNotEmpty, validateIsNumber, validateIsPresent, validateIsRecord, validateIsString, validateMax, validateMin, validateModel, wasender, wasenderChannelName, withPgClient, withPgTransaction, writeJsonToFile };