@wabot-dev/framework 0.9.2 → 0.9.5

package/dist/src/index.d.ts

@@ -417,7 +417,18 @@ declare class Random {
     static numberCode(length: number): string;
 }
 
-interface ICrudRepository<T> {
+interface ICrudRepository<T extends Entity<IEntityData>> {
+    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 class CrudRepository<T extends Entity<IEntityData>, Ext = never> implements ICrudRepository<T> {
+    protected readonly extension: Ext;
     find(id: string): Promise<T | null>;
     findOrThrow(id: string): Promise<T>;
     findByIds(ids: string[]): Promise<T[]>;
@@ -1283,6 +1294,10 @@ declare class PgRepositoryBase<P extends Entity<IEntityData>> {
     protected ensureColumns(client: PoolClient): Promise<void>;
 }
 
+declare const PG_ADAPTER_ID: unique symbol;
+type ExtensionOf$1<R> = R extends CrudRepository<any, infer Ext> ? Ext : never;
+declare function pgExtension<R extends CrudRepository<any, any>>(repositoryClass: IConstructor<R>): <E extends PgRepositoryBase<any> & ExtensionOf$1<R>>(target: IConstructor<E>) => void;
+
 declare class PgCrudRepository<P extends Entity<IEntityData>> extends PgRepositoryBase<P> implements ICrudRepository<P> {
     protected readonly config: IPgRepositoryConfig<P>;
     constructor(pool: Pool, config: IPgRepositoryConfig<P>);
@@ -1295,6 +1310,116 @@ declare class PgCrudRepository<P extends Entity<IEntityData>> extends PgReposito
     delete(item: P): Promise<void>;
 }
 
+interface IRepositoryConfig<P extends Entity<IEntityData>> {
+    table: string;
+    constructor: IConstructor<P>;
+    schema?: string;
+}
+
+type QueryPrefix = 'find' | 'findOne' | 'count' | 'exists' | 'delete';
+type QueryOperator = 'Equals' | 'Not' | 'Like' | 'NotLike' | 'In' | 'NotIn' | 'Gt' | 'Gte' | 'Lt' | 'Lte' | 'IsNull' | 'IsNotNull';
+type QueryConnector = 'And' | 'Or';
+interface IQueryCondition {
+    field: string;
+    operator: QueryOperator;
+    connector?: QueryConnector;
+}
+interface IQueryOrderBy {
+    field: string;
+    direction: 'ASC' | 'DESC';
+}
+interface IQueryAst {
+    prefix: QueryPrefix;
+    conditions: IQueryCondition[];
+    orderBy: IQueryOrderBy[];
+    limit?: number;
+}
+
+interface IRepositoryRuntime<P extends Entity<IEntityData>> {
+    find(id: string): Promise<P | null>;
+    findOrThrow(id: string): Promise<P>;
+    findByIds(ids: string[]): Promise<P[]>;
+    findAll(): Promise<P[]>;
+    create(item: P): Promise<void>;
+    update(item: P): Promise<void>;
+    delete(item: P): Promise<void>;
+    runQuery(ast: IQueryAst, args: unknown[]): Promise<P[]>;
+    runCount(ast: IQueryAst, args: unknown[]): Promise<number>;
+    runExists(ast: IQueryAst, args: unknown[]): Promise<boolean>;
+    runDelete(ast: IQueryAst, args: unknown[]): Promise<void>;
+}
+
+interface IRepositoryAdapter {
+    readonly id: symbol;
+    build<P extends Entity<IEntityData>>(config: IRepositoryConfig<P>): IRepositoryRuntime<P>;
+    buildExtension?<E>(config: IRepositoryConfig<any>, ExtensionCtor: IConstructor<E>): E;
+}
+
+declare class MemoryRepositoryExtension<P extends Entity<IEntityData>> {
+    protected readonly items: Map<string, P>;
+    protected readonly config: IRepositoryConfig<P>;
+    constructor(items: Map<string, P>, config: IRepositoryConfig<P>);
+    protected clone(item: P): P;
+}
+declare const MEMORY_ADAPTER_ID: unique symbol;
+declare class MemoryRepositoryAdapter implements IRepositoryAdapter {
+    readonly id: symbol;
+    private stores;
+    private getStore;
+    build<P extends Entity<IEntityData>>(config: IRepositoryConfig<P>): IRepositoryRuntime<P>;
+    buildExtension<E>(config: IRepositoryConfig<any>, ExtensionCtor: IConstructor<E>): E;
+}
+
+type ExtensionOf<R> = R extends CrudRepository<any, infer Ext> ? Ext : never;
+declare function memoryExtension<R extends CrudRepository<any, any>>(repositoryClass: IConstructor<R>): <E extends MemoryRepositoryExtension<any> & ExtensionOf<R>>(target: IConstructor<E>) => void;
+
+declare function query(): (target: object, propertyKey: string | symbol, descriptor?: PropertyDescriptor) => void;
+
+declare function queryExtension(): (target: object, propertyKey: string | symbol, descriptor?: PropertyDescriptor) => void;
+
+declare function repository<P extends Entity<IEntityData>>(config: IRepositoryConfig<P>): (target: IConstructor<any>) => void;
+
+declare function evaluateQueryAst<P extends Entity<IEntityData>>(items: Iterable<P>, ast: IQueryAst, args: unknown[]): P[];
+
+declare function parseQueryMethodName(name: string): IQueryAst;
+
+declare class RepositoryAdapterRegistry {
+    private adapter;
+    setDefault(adapter: IRepositoryAdapter): void;
+    getDefault(): IRepositoryAdapter;
+    hasDefault(): boolean;
+    clear(): void;
+}
+
+interface IQueryMethodMetadata {
+    repositoryConstructor: IConstructor<any>;
+    functionName: string;
+}
+declare class RepositoryMetadataStore {
+    private queryMethods;
+    private extensionMethods;
+    private repositoryConfigs;
+    private extensions;
+    saveQueryMethodMetadata(metadata: IQueryMethodMetadata): void;
+    saveExtensionMethodMetadata(metadata: IQueryMethodMetadata): void;
+    saveRepositoryConfig<P extends Entity<IEntityData>>(ctor: IConstructor<any>, config: IRepositoryConfig<P>): void;
+    getRepositoryConfig(ctor: IConstructor<any>): IRepositoryConfig<any> | undefined;
+    getQueryMethods(ctor: IConstructor<any>): IQueryMethodMetadata[];
+    getExtensionMethods(ctor: IConstructor<any>): IQueryMethodMetadata[];
+    private collectMethodsFromHierarchy;
+    saveExtension(repositoryConstructor: IConstructor<any>, adapterId: symbol, extensionConstructor: IConstructor<any>): void;
+    getExtension(ctor: IConstructor<any>, adapterId: symbol): IConstructor<any> | undefined;
+    validateExtensionsRegistered(adapterId: symbol): void;
+}
+
+declare class PgJsonRepositoryAdapter implements IRepositoryAdapter {
+    private readonly pool;
+    readonly id: symbol;
+    constructor(pool: Pool);
+    build<P extends Entity<IEntityData>>(config: IRepositoryConfig<P>): IRepositoryRuntime<P>;
+    buildExtension<E>(config: IRepositoryConfig<any>, ExtensionCtor: IConstructor<E>): E;
+}
+
 declare class PgLocker implements ILocker {
     private readonly pool;
     constructor(pool: Pool);
@@ -1320,46 +1445,6 @@ declare const pgStorage: AsyncLocalStorage<ClientMap>;
  */
 declare function getClientMap(): ClientMap;
 
-declare function pgJsonRepository<P extends Entity<IEntityData>>(config: IPgRepositoryConfig<P>): (target: IConstructor<any>) => void;
-
-declare function query(): (target: object, propertyKey: string | symbol) => void;
-
-declare class PgJsonRepository<P extends Entity<IEntityData>> extends PgCrudRepository<P> {
-    constructor(pool: Pool);
-}
-
-interface IQueryMethodMetadata {
-    repositoryConstructor: IConstructor<any>;
-    functionName: string;
-}
-declare class PgRepositoryMetadataStore {
-    private queryMethods;
-    private repositoryConfigs;
-    saveQueryMethodMetadata(metadata: IQueryMethodMetadata): void;
-    saveRepositoryConfig<P extends Entity<IEntityData>>(ctor: IConstructor<any>, config: IPgRepositoryConfig<P>): void;
-    getRepositoryConfig(ctor: IConstructor<any>): IPgRepositoryConfig<any> | undefined;
-    getQueryMethods(ctor: IConstructor<any>): IQueryMethodMetadata[];
-}
-
-type QueryPrefix = 'find' | 'findOne' | 'count' | 'exists' | 'delete';
-type QueryOperator = 'Equals' | 'Not' | 'Like' | 'NotLike' | 'In' | 'NotIn' | 'Gt' | 'Gte' | 'Lt' | 'Lte' | 'IsNull' | 'IsNotNull';
-type QueryConnector = 'And' | 'Or';
-interface IQueryCondition {
-    field: string;
-    operator: QueryOperator;
-    connector?: QueryConnector;
-}
-interface IQueryOrderBy {
-    field: string;
-    direction: 'ASC' | 'DESC';
-}
-interface IQueryAst {
-    prefix: QueryPrefix;
-    conditions: IQueryCondition[];
-    orderBy: IQueryOrderBy[];
-    limit?: number;
-}
-
 interface IBuiltQuery {
     sql: string;
     argCount: number;
@@ -1367,8 +1452,6 @@ interface IBuiltQuery {
 }
 declare function buildQuerySql(ast: IQueryAst, table: string, columns: string): IBuiltQuery;
 
-declare function parseQueryMethodName(name: string): IQueryAst;
-
 /**
  * Runs a function with a shared Postgres client for the given pool.
  * Reuses the client if already present in the async context.
@@ -1872,6 +1955,34 @@ declare class WabotChatAdapter implements IChatAdapter {
 
 declare function cmd(): (target: object, propertyKey: string | symbol) => void;
 
+declare class CmdChannelConfig {
+    readonly route: string;
+    constructor(route: string);
+}
+
+interface ICmdChannelHandlers {
+    onMessage: (text: string, reply: (response: {
+        senderName?: string;
+        text: string;
+    }) => void) => Promise<void> | void;
+}
+declare class CmdChannelServer {
+    private server;
+    private channels;
+    private client;
+    private buffer;
+    private activeRoute;
+    register(route: string, handlers: ICmdChannelHandlers): void;
+    unregister(route: string): void;
+    private ensureStarted;
+    private shutdown;
+    private handleConnection;
+    private handleData;
+    private handleMessage;
+    private sendToClient;
+    private send;
+}
+
 declare const cmdChannelName: "CmdChannel";
 
 interface ICmdReceivedMessage extends IReceivedMessage {
@@ -1885,18 +1996,55 @@ interface ICmdChannelMessage extends ICmdReceivedMessage {
 
 declare class CmdChannel implements IChatChannel {
     private auth;
-    private chatId;
-    private rl;
+    private server;
+    private config;
     static channelName: "CmdChannel";
+    private chatId;
     private callBack;
-    constructor(auth: Auth<any>);
+    constructor(auth: Auth<any>, server: CmdChannelServer, config: CmdChannelConfig);
     listen(callback: (message: ICmdChannelMessage) => Promise<void>): void;
     disconnect(): void;
     connect(): void;
+    private routeSlug;
+    private chatIdPath;
+    private authInfoPath;
+    private ensureChatId;
+    private ensureAuthLoaded;
 }
 declare function writeJsonToFile<T>(filename: string, data: T): void;
 declare function readJsonFromFile<T>(filename: string): T | null;
 
+declare function cmdChannelSocketPath(): string;
+
+interface ICmdChannelEntry {
+    route: string;
+}
+type CmdClientMessage = {
+    type: 'hello';
+} | {
+    type: 'select';
+    route: string;
+} | {
+    type: 'message';
+    text: string;
+};
+type CmdServerMessage = {
+    type: 'channels';
+    list: ICmdChannelEntry[];
+} | {
+    type: 'selected';
+    route: string;
+} | {
+    type: 'reply';
+    senderName?: string;
+    text: string;
+} | {
+    type: 'error';
+    message: string;
+};
+
+declare function runCmdClient(): void;
+
 interface ISocketChannelConfig {
     namespace: string | ConfigReference<string>;
     handshakeMidlewares?: IConstructor<IHandshakeMiddleware>[];
@@ -2307,4 +2455,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, 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 };
+export { AnthropicChatAdapter, ApiKey, ApiKeyGuardMiddleware, ApiKeyHandshakeGuardMiddleware, ApiKeyRepository, Async, AsyncMetadataStore, Auth, Chat, ChatAdapter, ChatAdapterMetadataStore, ChatAdapterRegistry, ChatBot, ChatBotMetadataStore, ChatItem, ChatMemory, ChatOperator, ChatRepository, ChatResolver, type ClientMap, CmdChannel, CmdChannelConfig, CmdChannelServer, type CmdClientMessage, type CmdServerMessage, type ConfigReference, type ConfigReferenceType, ConfigResolver, Container, ControllerMetadataStore, CronJob, CronJobRepository, CrudRepository, 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 ICmdChannelEntry, type ICmdChannelHandlers, 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 IRepositoryAdapter, type IRepositoryConfig, type IRepositoryRuntime, 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, MEMORY_ADAPTER_ID, Mapper, MemoryRepositoryAdapter, MemoryRepositoryExtension, Mindset, MindsetMetadataStore, MindsetOperator, Money, MoneyDto, OpenRouterChatAdapter, OpenaiChatAdapter, PG_ADAPTER_ID, Password, type PasswordHashOptions, Persistent, PgApiKeyRepository, PgChatMemory, PgChatRepository, PgCronJobRepository, PgCrudRepository, PgJobRepository, PgJsonRepositoryAdapter, PgJwtRefreshTokenRepository, PgLockKey, PgLocker, PgRepositoryBase, PgRepositoryBase as PgRepositoryExtension, PgTransactionAdapter, ProjectRunner, type QueryConnector, type QueryOperator, type QueryPrefix, Random, RemoteApiKeyRepository, RepositoryAdapterRegistry, RepositoryMetadataStore, 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, cmdChannelSocketPath, command, commandHandler, container, cronHandler, description, errorToPlainObject, evaluateQueryAst, extractChatMessageText, extractNumberFromWasenderMessageKey, getClientMap, getPgClient, handshakeMiddlewares, inject, injectable, isArray, isBoolean, isChatMessageEmpty, isDate, isIn, isModel, isNotEmpty, isNumber, isOptional, isPresent, isRecord, isRetryableError, isString, jwtGuard, jwtHandshakeGuard, max, memoryExtension, middleware, min, mindset, mindsetModule, modelInfo, num, numArr, obj, onDelete, onGet, onPost, onPut, onSocketEvent, parseQueryMethodName, pgExtension, pgStorage, query, queryExtension, readJsonFromFile, repository, resolveConfigReferences, restController, run, runChatAdapters, runChatControllers, runCmdClient, 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 };

package/dist/src/index.js

@@ -10,6 +10,7 @@ export { Logger } from './core/logger/Logger.js';
 export { Mapper } from './core/mapper/Mapper.js';
 export { Password } from './core/password/Password.js';
 export { Random } from './core/random/Random.js';
+export { CrudRepository } from './core/repository/CrudRepository.js';
 export { Storable } from './core/storable/Storable.js';
 export { isModel } from './core/validation/metadata/@isModel.js';
 export { isOptional } from './core/validation/metadata/@isOptional.js';
@@ -89,19 +90,25 @@ export { Mindset } from './feature/mindset/IMindset.js';
 export { MindsetOperator } from './feature/mindset/MindsetOperator.js';
 export { Money } from './feature/money/Money.js';
 export { MoneyDto } from './feature/money/MoneyDto.js';
+export { PG_ADAPTER_ID, pgExtension } from './feature/pg/@pgExtension.js';
 export { PgCrudRepository } from './feature/pg/PgCrudRepository.js';
+export { PgJsonRepositoryAdapter } from './feature/pg/PgJsonRepositoryAdapter.js';
 export { PgLocker } from './feature/pg/PgLocker.js';
 export { PgLockKey } from './feature/pg/PgLockKey.js';
-export { PgRepositoryBase } from './feature/pg/PgRepositoryBase.js';
+export { PgRepositoryBase, PgRepositoryBase as PgRepositoryExtension } from './feature/pg/PgRepositoryBase.js';
 export { getClientMap, pgStorage } from './feature/pg/pgStorage.js';
-export { pgJsonRepository } from './feature/pg/query/@pgJsonRepository.js';
-export { query } from './feature/pg/query/@query.js';
-export { PgJsonRepository } from './feature/pg/query/PgJsonRepository.js';
-export { PgRepositoryMetadataStore } from './feature/pg/query/PgRepositoryMetadataStore.js';
-export { buildQuerySql } from './feature/pg/query/buildQuerySql.js';
-export { parseQueryMethodName } from './feature/pg/query/parseQueryMethodName.js';
+export { buildQuerySql } from './feature/pg/buildQuerySql.js';
 export { getPgClient, withPgClient } from './feature/pg/withPgClient.js';
 export { withPgTransaction } from './feature/pg/withPgTransaction.js';
+export { memoryExtension } from './feature/repository/@memoryExtension.js';
+export { query } from './feature/repository/@query.js';
+export { queryExtension } from './feature/repository/@queryExtension.js';
+export { repository } from './feature/repository/@repository.js';
+export { evaluateQueryAst } from './feature/repository/evaluateQueryAst.js';
+export { MEMORY_ADAPTER_ID, MemoryRepositoryAdapter, MemoryRepositoryExtension } from './feature/repository/MemoryRepositoryAdapter.js';
+export { parseQueryMethodName } from './feature/repository/parseQueryMethodName.js';
+export { RepositoryAdapterRegistry } from './feature/repository/RepositoryAdapterRegistry.js';
+export { RepositoryMetadataStore } from './feature/repository/RepositoryMetadataStore.js';
 export { onGet } from './feature/rest-controller/metadata/@onGet.js';
 export { middleware } from './feature/rest-controller/metadata/@middleware.js';
 export { onPost } from './feature/rest-controller/metadata/@onPost.js';
@@ -156,7 +163,11 @@ export { InMemoryChatRepository } from './addon/chat-bot/in-memory/InMemoryChatR
 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 { CmdChannelConfig } from './addon/chat-controller/cmd/CmdChannelConfig.js';
+export { CmdChannelServer } from './addon/chat-controller/cmd/CmdChannelServer.js';
 export { cmdChannelName } from './addon/chat-controller/cmd/cmdChannelName.js';
+export { cmdChannelSocketPath } from './addon/chat-controller/cmd/cmdChannelSocketPath.js';
+export { runCmdClient } from './addon/chat-controller/cmd/runCmdClient.js';
 export { socket } from './addon/chat-controller/socket/@socket.js';
 export { SocketChannel, SocketChannelMessageFile, SocketChannelReceivedMessage } from './addon/chat-controller/socket/SocketChannel.js';
 export { SocketChannelConfig } from './addon/chat-controller/socket/SocketChannelConfig.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wabot-dev/framework",
-  "version": "0.9.2",
+  "version": "0.9.5",
   "description": "Framework for IA Chat Bots",
   "type": "module",
   "main": "dist/src/index.js",
@@ -49,7 +49,9 @@
     "fmt": "prettier --write .",
     "fmt:check": "prettier --check .",
     "types:check": "tsc --noEmit",
-    "elia:dev": "node --import @yucacodes/ts --import ./env.mjs  ./test/elia/run.ts"
+    "elia:dev": "node --import @yucacodes/ts --import ./env.mjs  ./test/elia/run.ts",
+    "elia:watch": "node --watch --import @yucacodes/ts --import ./env.mjs  ./test/elia/run.ts",
+    "cmd:channel": "node --import @yucacodes/ts ./test/cmd.ts"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "5.1.1",

package/dist/src/feature/pg/query/@pgJsonRepository.js

@@ -1,73 +0,0 @@
-import { container, singleton } from '../../../core/injection/index.js';
-import { withPgClient } from '../withPgClient.js';
-import { buildQuerySql } from './buildQuerySql.js';
-import { parseQueryMethodName } from './parseQueryMethodName.js';
-import { PgJsonRepository } from './PgJsonRepository.js';
-import { PgRepositoryMetadataStore } from './PgRepositoryMetadataStore.js';
-
-const QUERY_CACHE_KEY = Symbol('wabot:pgQueryCache');
-function makeQueryImpl(methodName, ast) {
-    return async function (...args) {
-        let cache = this[QUERY_CACHE_KEY];
-        if (!cache) {
-            cache = new Map();
-            Object.defineProperty(this, QUERY_CACHE_KEY, { value: cache, enumerable: false });
-        }
-        let built = cache.get(methodName);
-        if (!built) {
-            built = buildQuerySql(ast, this.table, this.columns);
-            cache.set(methodName, built);
-        }
-        const params = built.buildParams(args);
-        switch (ast.prefix) {
-            case 'find': {
-                return await this.query(built.sql, params);
-            }
-            case 'findOne': {
-                const items = await this.query(built.sql, params);
-                return items[0] ?? null;
-            }
-            case 'count': {
-                return await withPgClient(this.pool, async (client) => {
-                    await this.ensureTable(client);
-                    const result = await client.query(built.sql, params);
-                    return result.rows[0]?.count ?? 0;
-                });
-            }
-            case 'exists': {
-                return await withPgClient(this.pool, async (client) => {
-                    await this.ensureTable(client);
-                    const result = await client.query(built.sql, params);
-                    return Boolean(result.rows[0]?.exists);
-                });
-            }
-            case 'delete': {
-                await this.exec(built.sql, params);
-                return;
-            }
-        }
-    };
-}
-function pgJsonRepository(config) {
-    return function (target) {
-        if (target !== PgJsonRepository && !(target.prototype instanceof PgJsonRepository)) {
-            throw new Error(`@pgJsonRepository: ${target.name} must extend PgJsonRepository`);
-        }
-        const store = container.resolve(PgRepositoryMetadataStore);
-        store.saveRepositoryConfig(target, config);
-        const queryMethods = store.getQueryMethods(target);
-        for (const meta of queryMethods) {
-            if (Object.prototype.hasOwnProperty.call(target.prototype, meta.functionName)) {
-                const existing = target.prototype[meta.functionName];
-                if (typeof existing === 'function') {
-                    continue;
-                }
-            }
-            const ast = parseQueryMethodName(meta.functionName);
-            target.prototype[meta.functionName] = makeQueryImpl(meta.functionName, ast);
-        }
-        singleton()(target);
-    };
-}
-
-export { pgJsonRepository };

package/dist/src/feature/pg/query/@query.js

@@ -1,14 +0,0 @@
-import { container } from '../../../core/injection/index.js';
-import { PgRepositoryMetadataStore } from './PgRepositoryMetadataStore.js';
-
-function query() {
-    return function (target, propertyKey) {
-        const store = container.resolve(PgRepositoryMetadataStore);
-        store.saveQueryMethodMetadata({
-            repositoryConstructor: target.constructor,
-            functionName: propertyKey.toString(),
-        });
-    };
-}
-
-export { query };

package/dist/src/feature/pg/query/PgJsonRepository.js

@@ -1,23 +0,0 @@
-import { __decorate, __metadata } from 'tslib';
-import { Pool } from 'pg';
-import { injectable, container } from '../../../core/injection/index.js';
-import { PgCrudRepository } from '../PgCrudRepository.js';
-import { PgRepositoryMetadataStore } from './PgRepositoryMetadataStore.js';
-
-let PgJsonRepository = class PgJsonRepository extends PgCrudRepository {
-    constructor(pool) {
-        const ctor = new.target;
-        const store = container.resolve(PgRepositoryMetadataStore);
-        const config = store.getRepositoryConfig(ctor);
-        if (!config) {
-            throw new Error(`${ctor.name} must be decorated with @pgJsonRepository`);
-        }
-        super(pool, config);
-    }
-};
-PgJsonRepository = __decorate([
-    injectable(),
-    __metadata("design:paramtypes", [Pool])
-], PgJsonRepository);
-
-export { PgJsonRepository };

package/dist/src/feature/pg/query/PgRepositoryMetadataStore.js

@@ -1,44 +0,0 @@
-import { __decorate } from 'tslib';
-import { singleton } from '../../../core/injection/index.js';
-
-let PgRepositoryMetadataStore = class PgRepositoryMetadataStore {
-    queryMethods = new Map();
-    repositoryConfigs = new Map();
-    saveQueryMethodMetadata(metadata) {
-        let perClass = this.queryMethods.get(metadata.repositoryConstructor);
-        if (!perClass) {
-            perClass = new Map();
-            this.queryMethods.set(metadata.repositoryConstructor, perClass);
-        }
-        perClass.set(metadata.functionName, metadata);
-    }
-    saveRepositoryConfig(ctor, config) {
-        this.repositoryConfigs.set(ctor, config);
-    }
-    getRepositoryConfig(ctor) {
-        return this.repositoryConfigs.get(ctor);
-    }
-    getQueryMethods(ctor) {
-        const collected = new Map();
-        const hierarchy = [];
-        let proto = ctor.prototype;
-        while (proto && proto.constructor !== Object) {
-            hierarchy.unshift(proto.constructor);
-            proto = Object.getPrototypeOf(proto);
-        }
-        for (const cls of hierarchy) {
-            const perClass = this.queryMethods.get(cls);
-            if (perClass) {
-                for (const [name, meta] of perClass) {
-                    collected.set(name, meta);
-                }
-            }
-        }
-        return [...collected.values()];
-    }
-};
-PgRepositoryMetadataStore = __decorate([
-    singleton()
-], PgRepositoryMetadataStore);
-
-export { PgRepositoryMetadataStore };