@wabot-dev/framework 0.9.13 → 0.9.15

package/README.md

@@ -38,6 +38,71 @@ visita nuestra documentación 📘 **[Ver guía completa de inicio →](https://
 
 ---
 
+## 📦 Building for production
+
+En modo dev, el framework descubre módulos escaneando el disco. Para producción, el framework incluye un script que empaqueta tu proyecto en un único `dist/entry.js` autocontenido usando `tsup`.
+
+### 1. Instala `tsup` como dev dependency del consumidor
+
+```bash
+npm i -D tsup
+```
+
+### 2. Cambia `_run_.ts` para exportar la config
+
+En vez de invocar `run()` directamente, exporta `config` para que tanto dev como build la puedan usar:
+
+```ts
+// src/_run_.ts
+import { run, IProjectRunnerConfig } from '@wabot-dev/framework'
+
+export const config: IProjectRunnerConfig = {
+  directories: ['src'],
+}
+
+// Solo en dev: arrancar inmediatamente.
+if (process.env.WABOT_BUNDLED !== '1') {
+  run(config)
+}
+```
+
+### 3. Configura el build (opcional)
+
+Crea `wabot.build.json` en la raíz del proyecto o agrega un campo `wabot` al `package.json`:
+
+```json
+{
+  "entry": "./src/_run_.ts",
+  "directories": ["src"],
+  "exclude": ["_run_.ts", "_cmd_.ts"],
+  "outDir": "./dist",
+  "sourcemap": true,
+  "minify": false,
+  "external": ["pg"]
+}
+```
+
+### 4. Agrega los scripts
+
+```json
+"scripts": {
+  "dev": "node --import @yucacodes/ts ./src/_run_.ts",
+  "build": "node ./node_modules/@wabot-dev/framework/dist/build/build.js",
+  "start": "WABOT_BUNDLED=1 node ./dist/entry.js"
+}
+```
+
+El script de build:
+
+1. Escanea las `directories` configuradas (saltando tests y `_run_.ts`/`_cmd_.ts`).
+2. Genera un manifiesto temporal en `.wabot/` con imports estáticos a cada módulo.
+3. Empaqueta todo con `tsup` (ESM, single-file) en `dist/entry.js`.
+4. Arranca el runtime en modo `preloaded: true`, así que **no hay `readdir` ni imports dinámicos por template literal** en el bundle final.
+
+Los addons opcionales (`pg`, SDKs de IA) se mantienen como `peerDependencies` y solo entran al bundle si tu proyecto los usa.
+
+---
+
 ## 💬 Plataformas Soportadas
 
 Wabot se integra nativamente con las principales plataformas de mensajería:

package/dist/build/build.js

@@ -0,0 +1,200 @@
+import { realpathSync, existsSync } from 'node:fs';
+import { readdir, mkdir, writeFile, rm, readFile } from 'node:fs/promises';
+import { resolve, join, relative, sep, isAbsolute } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const TEST_FILE_PATTERNS = /\.(test|spec|unit|integration|e2e|multiprocess)\.(ts|js)$/;
+const DEFAULT_DIRECTORIES = ['src'];
+const DEFAULT_EXCLUDE = ['_run_.ts', '_cmd_.ts'];
+async function scanProjectFiles(opts = {}) {
+    const directories = opts.directories ?? DEFAULT_DIRECTORIES;
+    const exclude = [...DEFAULT_EXCLUDE, ...(opts.exclude ?? [])];
+    const seen = new Set();
+    const roots = directories
+        .map((d) => resolve(d))
+        .filter((d) => {
+        if (seen.has(d))
+            return false;
+        seen.add(d);
+        return true;
+    });
+    const excludedNames = new Set();
+    const excludedPathsByRoot = new Map();
+    for (const entry of exclude) {
+        if (entry.includes('/') || entry.includes('\\')) {
+            for (const root of roots) {
+                let paths = excludedPathsByRoot.get(root);
+                if (!paths) {
+                    paths = new Set();
+                    excludedPathsByRoot.set(root, paths);
+                }
+                paths.add(resolve(root, entry));
+            }
+        }
+        else {
+            excludedNames.add(entry);
+        }
+    }
+    const results = await Promise.all(roots.map((dir) => {
+        const excludedPaths = excludedPathsByRoot.get(dir) ?? new Set();
+        return scanDir(dir, excludedNames, excludedPaths).catch(() => []);
+    }));
+    return results.flat();
+}
+async function scanDir(dir, excludedNames, excludedPaths) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const subResults = await Promise.all(entries.map(async (entry) => {
+        const name = entry.name;
+        const fullPath = join(dir, name);
+        if (excludedNames.has(name))
+            return [];
+        if (excludedPaths.has(fullPath))
+            return [];
+        if (entry.isDirectory()) {
+            if (name.startsWith('__'))
+                return [];
+            return scanDir(fullPath, excludedNames, excludedPaths);
+        }
+        if (!entry.isFile())
+            return [];
+        if (!(name.endsWith('.ts') || name.endsWith('.js')))
+            return [];
+        if (name.endsWith('.d.ts'))
+            return [];
+        if (TEST_FILE_PATTERNS.test(fullPath))
+            return [];
+        return [fullPath];
+    }));
+    return subResults.flat();
+}
+
+const MANIFEST_BANNER = '// auto-generated by @wabot-dev/framework build, do not edit';
+/**
+ * Convert an absolute source path into an ESM import specifier relative to
+ * the manifest directory. Uses forward slashes on every OS and rewrites
+ * `.ts`/`.tsx` to `.js` so the bundler can resolve it statically.
+ */
+function toManifestImport(absFile, manifestDir) {
+    let rel = relative(manifestDir, absFile);
+    if (sep !== '/')
+        rel = rel.split(sep).join('/');
+    if (!rel.startsWith('./') && !rel.startsWith('../'))
+        rel = './' + rel;
+    return rel.replace(/\.tsx?$/, '.js').replace(/\.jsx$/, '.js');
+}
+function generateManifest(absFiles, manifestDir) {
+    const imports = [...absFiles]
+        .sort()
+        .map((f) => `import '${toManifestImport(f, manifestDir)}'`);
+    return `${MANIFEST_BANNER}\n${imports.join('\n')}\n`;
+}
+function generateEntry(manifestDir, consumerEntry, frameworkPackageName) {
+    const lines = [MANIFEST_BANNER, "import './manifest.js'"];
+    if (consumerEntry) {
+        const spec = toManifestImport(consumerEntry, manifestDir);
+        lines.push(`import * as __wabot_user_entry from '${spec}'`);
+        lines.push(`import { run as __wabot_run } from '${frameworkPackageName}'`);
+        lines.push('const __wabot_cfg = ((__wabot_user_entry as any).config ?? (__wabot_user_entry as any).default ?? {})');
+        lines.push('await __wabot_run({ ...__wabot_cfg, preloaded: true })');
+    }
+    else {
+        lines.push(`import { run as __wabot_run } from '${frameworkPackageName}'`);
+        lines.push('await __wabot_run({ preloaded: true })');
+    }
+    return lines.join('\n') + '\n';
+}
+
+const FRAMEWORK_PACKAGE = '@wabot-dev/framework';
+const MANIFEST_DIRNAME = '.wabot';
+async function readJsonIfExists(path) {
+    if (!existsSync(path))
+        return null;
+    const raw = await readFile(path, 'utf-8');
+    return JSON.parse(raw);
+}
+async function loadBuildConfig(cwd) {
+    const fromFile = await readJsonIfExists(resolve(cwd, 'wabot.build.json'));
+    if (fromFile)
+        return fromFile;
+    const pkg = await readJsonIfExists(resolve(cwd, 'package.json'));
+    return pkg?.wabot ?? {};
+}
+function absolutize(cwd, p) {
+    return isAbsolute(p) ? p : resolve(cwd, p);
+}
+async function runBuild(options = {}) {
+    const cwd = options.cwd ?? process.cwd();
+    const config = await loadBuildConfig(cwd);
+    const entry = config.entry ? absolutize(cwd, config.entry) : absolutize(cwd, './src/_run_.ts');
+    const directories = config.directories ?? ['src'];
+    const exclude = config.exclude ?? [];
+    const outDir = absolutize(cwd, config.outDir ?? './dist');
+    const sourcemap = config.sourcemap ?? true;
+    const minify = config.minify ?? false;
+    const manifestDir = resolve(cwd, MANIFEST_DIRNAME);
+    await mkdir(manifestDir, { recursive: true });
+    const prevCwd = process.cwd();
+    let discovered;
+    try {
+        process.chdir(cwd);
+        discovered = await scanProjectFiles({ directories, exclude });
+    }
+    finally {
+        process.chdir(prevCwd);
+    }
+    const entryResolved = existsSync(entry) ? entry : null;
+    const filesForManifest = discovered.filter((f) => f !== entry);
+    const manifestSrc = generateManifest(filesForManifest, manifestDir);
+    const entrySrc = generateEntry(manifestDir, entryResolved, FRAMEWORK_PACKAGE);
+    await writeFile(resolve(manifestDir, 'manifest.ts'), manifestSrc, 'utf-8');
+    await writeFile(resolve(manifestDir, 'entry.ts'), entrySrc, 'utf-8');
+    let tsup;
+    try {
+        tsup = await import('tsup');
+    }
+    catch {
+        throw new Error(`tsup is not installed in the consumer project. Install it as a dev dependency: npm i -D tsup`);
+    }
+    try {
+        await tsup.build({
+            entry: [resolve(manifestDir, 'entry.ts')],
+            format: ['esm'],
+            outDir,
+            clean: true,
+            sourcemap,
+            minify,
+            splitting: false,
+            bundle: true,
+            target: 'node20',
+            tsconfig: existsSync(resolve(cwd, 'tsconfig.json'))
+                ? resolve(cwd, 'tsconfig.json')
+                : undefined,
+            external: config.external ?? ['pg'],
+        });
+    }
+    finally {
+        if (!options.keep) {
+            await rm(manifestDir, { recursive: true, force: true });
+        }
+    }
+}
+function isMainModule() {
+    const argvEntry = process.argv[1];
+    if (!argvEntry)
+        return false;
+    try {
+        return realpathSync(argvEntry) === realpathSync(fileURLToPath(import.meta.url));
+    }
+    catch {
+        return false;
+    }
+}
+if (isMainModule()) {
+    const keep = process.argv.includes('--keep');
+    runBuild({ keep }).catch((err) => {
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    });
+}
+
+export { loadBuildConfig, runBuild };

package/dist/src/feature/project-runner/ProjectRunner.js

@@ -1,5 +1,3 @@
-import { readdir } from 'node:fs/promises';
-import { resolve, join } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { container } from '../../core/injection/index.js';
 import { Logger } from '../../core/logger/Logger.js';
@@ -33,53 +31,57 @@ import { runSocketControllers } from '../socket-controller/runSocketControllers.
 import { MemoryRepositoryAdapter } from '../repository/MemoryRepositoryAdapter.js';
 import { RepositoryMetadataStore } from '../repository/RepositoryMetadataStore.js';
 import { RepositoryAdapterRegistry } from '../repository/RepositoryAdapterRegistry.js';
+import { scanProjectFiles } from './scanner.js';
 
 const logger = new Logger('wabot:project-runner');
-const TEST_FILE_PATTERNS = /\.(test|spec|unit|integration|e2e|multiprocess)\.(ts|js)$/;
-const DEFAULT_EXCLUDE = ['_run_.ts', '_cmd_.ts'];
-const MODULE_EXT = import.meta.url.endsWith('.ts') ? '.ts' : '.js';
-const DEFAULT_CHAT_ADAPTERS = [
-    {
-        path: `../../addon/chat-bot/openia/OpenaiChatAdapter${MODULE_EXT}`,
-        name: 'OpenaiChatAdapter',
+const DEFAULT_ADAPTER_LOADERS = {
+    openai: {
         apiKeyEnv: 'OPENAI_API_KEY',
+        load: async () => (await import('../../addon/chat-bot/openia/OpenaiChatAdapter.js')).OpenaiChatAdapter,
     },
-    {
-        path: `../../addon/chat-bot/openrouter/OpenRouterChatAdapter${MODULE_EXT}`,
-        name: 'OpenRouterChatAdapter',
+    openrouter: {
         apiKeyEnv: 'OPENROUTER_API_KEY',
+        load: async () => (await import('../../addon/chat-bot/openrouter/OpenRouterChatAdapter.js'))
+            .OpenRouterChatAdapter,
     },
-    {
-        path: `../../addon/chat-bot/anthropic/AnthropicChatAdapter${MODULE_EXT}`,
-        name: 'AnthropicChatAdapter',
+    anthropic: {
         apiKeyEnv: 'ANTHROPIC_API_KEY',
+        load: async () => (await import('../../addon/chat-bot/anthropic/AnthropicChatAdapter.js'))
+            .AnthropicChatAdapter,
     },
-    {
-        path: `../../addon/chat-bot/google/GoogleChatAdapter${MODULE_EXT}`,
-        name: 'GoogleChatAdapter',
+    google: {
         apiKeyEnv: 'GOOGLE_API_KEY',
+        load: async () => (await import('../../addon/chat-bot/google/GoogleChatAdapter.js')).GoogleChatAdapter,
     },
-];
+};
 class ProjectRunner {
     directories;
     exclude;
     chatAdapters;
     connectionString;
     isPg;
+    preloaded;
     pool = null;
     constructor(config = {}) {
         this.directories = config.directories ?? ['src'];
-        this.exclude = [...DEFAULT_EXCLUDE, ...(config.exclude ?? [])];
+        this.exclude = config.exclude ?? [];
         this.chatAdapters = config.chatAdapters;
         this.connectionString = this.resolveConnectionString(config.connectionString);
         this.isPg = this.connectionString != null && isPostgresUrl(this.connectionString);
+        this.preloaded = config.preloaded === true;
     }
     async run() {
-        const [, files] = await Promise.all([
-            this.isPg ? this.initPool() : Promise.resolve(),
-            this.scanDirectories(),
-        ]);
-        await this.importFiles(files);
+        if (this.preloaded) {
+            if (this.isPg)
+                await this.initPool();
+        }
+        else {
+            const [, files] = await Promise.all([
+                this.isPg ? this.initPool() : Promise.resolve(),
+                scanProjectFiles({ directories: this.directories, exclude: this.exclude }),
+            ]);
+            await this.importFiles(files);
+        }
         const components = this.discoverComponents();
         await this.registerAdapters(components);
         await this.startComponents(components);
@@ -96,42 +98,6 @@ class ProjectRunner {
         this.pool = new Pool({ connectionString: this.connectionString });
         container.registerInstance(Pool, this.pool);
     }
-    async scanDirectories() {
-        const seen = new Set();
-        const roots = this.directories
-            .map((d) => resolve(d))
-            .filter((d) => {
-            if (seen.has(d))
-                return false;
-            seen.add(d);
-            return true;
-        });
-        const excludedNames = new Set();
-        const excludedPathsByRoot = new Map();
-        for (const entry of this.exclude) {
-            if (entry.includes('/') || entry.includes('\\')) {
-                for (const root of roots) {
-                    let paths = excludedPathsByRoot.get(root);
-                    if (!paths) {
-                        paths = new Set();
-                        excludedPathsByRoot.set(root, paths);
-                    }
-                    paths.add(resolve(root, entry));
-                }
-            }
-            else {
-                excludedNames.add(entry);
-            }
-        }
-        const results = await Promise.all(roots.map((dir) => {
-            const excludedPaths = excludedPathsByRoot.get(dir) ?? new Set();
-            return scanDir(dir, excludedNames, excludedPaths).catch((err) => {
-                logger.warn(`Could not read directory ${dir}: ${err.message}`);
-                return [];
-            });
-        }));
-        return results.flat();
-    }
     async importFiles(files) {
         if (files.length === 0) {
             logger.info('No files to import');
@@ -278,15 +244,16 @@ class ProjectRunner {
         }
     }
     async resolveDefaultChatAdapters() {
-        const results = await Promise.all(DEFAULT_CHAT_ADAPTERS.map(async ({ path, name, apiKeyEnv }) => {
+        const keys = Object.keys(DEFAULT_ADAPTER_LOADERS);
+        const results = await Promise.all(keys.map(async (key) => {
+            const { apiKeyEnv, load } = DEFAULT_ADAPTER_LOADERS[key];
             if (!process.env[apiKeyEnv])
                 return null;
             try {
-                const mod = await import(path);
-                const adapter = mod[name];
+                const adapter = await load();
                 if (!adapter)
                     return null;
-                logger.info(`Using ${name}`);
+                logger.info(`Using ${adapter.name}`);
                 return adapter;
             }
             catch {
@@ -302,31 +269,5 @@ function run(config) {
 function isPostgresUrl(cs) {
     return cs.startsWith('postgres://') || cs.startsWith('postgresql://');
 }
-async function scanDir(dir, excludedNames, excludedPaths) {
-    const entries = await readdir(dir, { withFileTypes: true });
-    const subResults = await Promise.all(entries.map(async (entry) => {
-        const name = entry.name;
-        const fullPath = join(dir, name);
-        if (excludedNames.has(name))
-            return [];
-        if (excludedPaths.has(fullPath))
-            return [];
-        if (entry.isDirectory()) {
-            if (name.startsWith('__'))
-                return [];
-            return scanDir(fullPath, excludedNames, excludedPaths);
-        }
-        if (!entry.isFile())
-            return [];
-        if (!(name.endsWith('.ts') || name.endsWith('.js')))
-            return [];
-        if (name.endsWith('.d.ts'))
-            return [];
-        if (TEST_FILE_PATTERNS.test(fullPath))
-            return [];
-        return [fullPath];
-    }));
-    return subResults.flat();
-}
 
 export { ProjectRunner, run };

package/dist/src/feature/project-runner/scanner.js

@@ -0,0 +1,69 @@
+import { readdir } from 'node:fs/promises';
+import { resolve, join } from 'node:path';
+
+const TEST_FILE_PATTERNS = /\.(test|spec|unit|integration|e2e|multiprocess)\.(ts|js)$/;
+const DEFAULT_DIRECTORIES = ['src'];
+const DEFAULT_EXCLUDE = ['_run_.ts', '_cmd_.ts'];
+async function scanProjectFiles(opts = {}) {
+    const directories = opts.directories ?? DEFAULT_DIRECTORIES;
+    const exclude = [...DEFAULT_EXCLUDE, ...(opts.exclude ?? [])];
+    const seen = new Set();
+    const roots = directories
+        .map((d) => resolve(d))
+        .filter((d) => {
+        if (seen.has(d))
+            return false;
+        seen.add(d);
+        return true;
+    });
+    const excludedNames = new Set();
+    const excludedPathsByRoot = new Map();
+    for (const entry of exclude) {
+        if (entry.includes('/') || entry.includes('\\')) {
+            for (const root of roots) {
+                let paths = excludedPathsByRoot.get(root);
+                if (!paths) {
+                    paths = new Set();
+                    excludedPathsByRoot.set(root, paths);
+                }
+                paths.add(resolve(root, entry));
+            }
+        }
+        else {
+            excludedNames.add(entry);
+        }
+    }
+    const results = await Promise.all(roots.map((dir) => {
+        const excludedPaths = excludedPathsByRoot.get(dir) ?? new Set();
+        return scanDir(dir, excludedNames, excludedPaths).catch(() => []);
+    }));
+    return results.flat();
+}
+async function scanDir(dir, excludedNames, excludedPaths) {
+    const entries = await readdir(dir, { withFileTypes: true });
+    const subResults = await Promise.all(entries.map(async (entry) => {
+        const name = entry.name;
+        const fullPath = join(dir, name);
+        if (excludedNames.has(name))
+            return [];
+        if (excludedPaths.has(fullPath))
+            return [];
+        if (entry.isDirectory()) {
+            if (name.startsWith('__'))
+                return [];
+            return scanDir(fullPath, excludedNames, excludedPaths);
+        }
+        if (!entry.isFile())
+            return [];
+        if (!(name.endsWith('.ts') || name.endsWith('.js')))
+            return [];
+        if (name.endsWith('.d.ts'))
+            return [];
+        if (TEST_FILE_PATTERNS.test(fullPath))
+            return [];
+        return [fullPath];
+    }));
+    return subResults.flat();
+}
+
+export { scanProjectFiles };

package/dist/src/index.d.ts

@@ -1128,6 +1128,16 @@ interface IProjectRunnerConfig {
     exclude?: string[];
     connectionString?: string;
     chatAdapters?: IConstructor<IChatAdapter>[];
+    /**
+     * When true, skip filesystem discovery (no readdir, no dynamic import of
+     * source files) and start directly from the metadata that was registered
+     * during the host module's import-time side effects.
+     *
+     * The caller is responsible for having imported every module that registers
+     * controllers, handlers, adapters, etc. before invoking run(). This is the
+     * mode used by the bundled output produced by src/build/build.ts.
+     */
+    preloaded?: boolean;
 }
 declare class ProjectRunner {
     private directories;
@@ -1135,12 +1145,12 @@ declare class ProjectRunner {
     private chatAdapters;
     private connectionString;
     private isPg;
+    private preloaded;
     private pool;
     constructor(config?: IProjectRunnerConfig);
     run(): Promise<void>;
     private resolveConnectionString;
     private initPool;
-    private scanDirectories;
     private importFiles;
     private discoverComponents;
     private registerAdapters;
@@ -1151,6 +1161,12 @@ declare class ProjectRunner {
 }
 declare function run(config?: IProjectRunnerConfig): Promise<void>;
 
+interface IScanProjectFilesOptions {
+    directories?: string[];
+    exclude?: string[];
+}
+declare function scanProjectFiles(opts?: IScanProjectFilesOptions): Promise<string[]>;
+
 interface IchatControllerConfig {
 }
 
@@ -2469,4 +2485,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, 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 };
+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 IScanProjectFilesOptions, 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, scanProjectFiles, 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

@@ -58,6 +58,7 @@ export { runCommandHandlers, stopCommandHandlers } from './feature/async/runComm
 export { runCronHandlers, stopCronHandlers } from './feature/async/runCronHandlers.js';
 export { TransactionMetadataStore } from './feature/async/TransactionMetadataStore.js';
 export { ProjectRunner, run } from './feature/project-runner/ProjectRunner.js';
+export { scanProjectFiles } from './feature/project-runner/scanner.js';
 export { Chat } from './feature/chat-bot/Chat.js';
 export { ChatAdapter } from './feature/chat-bot/ChatAdapter.js';
 export { ChatAdapterRegistry } from './feature/chat-bot/ChatAdapterRegistry.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wabot-dev/framework",
-  "version": "0.9.13",
+  "version": "0.9.15",
   "description": "Framework for IA Chat Bots",
   "type": "module",
   "main": "dist/src/index.js",
@@ -39,6 +39,7 @@
   ],
   "files": [
     "dist/src",
+    "dist/build",
     "LICENSE.md"
   ],
   "scripts": {
@@ -49,9 +50,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:watch": "node --watch --import @yucacodes/ts --import ./env.mjs  ./test/elia/run.ts",
-    "cmd:channel": "node --import @yucacodes/ts ./test/cmd.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",
+    "elia:cmd:channel": "node --import @yucacodes/ts ./test/elia/_cmd_.ts"
   },
   "devDependencies": {
     "@rollup/plugin-alias": "5.1.1",