El bloque dev
El bloque dev controla el watcher de desarrollo local que reinicia el proceso de tu bot cuando cambian los archivos fuente. Todos los campos son opcionales. El entrypoint predeterminado es src/main.ts y el debounce predeterminado es de 300 milisegundos; la mayoría de proyectos solo necesitan ajustar debounce para evitar tormentas de reinicios durante guardados rápidos.
import { defineConfig } from '@spraxium/core';
export default defineConfig({
dev: {
entrypoint: 'src/main.ts',
debounce: 500,
include: ['locales'],
exclude: ['.spraxium/**', 'dist/**'],
},
});| Campo | Tipo | Predeterminado | Finalidad |
|---|---|---|---|
| entrypoint | string | src/main.ts | Archivo que ejecuta el watcher al reiniciar el proceso. |
| include | string[] | [] | Directorios adicionales que disparan reinicios al cambiar. |
| exclude | string[] | [] | Patrones glob que se ignoran durante el file watching. |
| debounce | number | 300 | Milisegundos a esperar tras un cambio antes de disparar un reinicio. |
Excluye directorios generados
Agrega siempre .spraxium/** y dist/** a la lista exclude. Estos directorios cambian durante operaciones de build, y observarlos causa bucles infinitos de reinicio que desestabilizan el proceso del watcher.
Nombres de archivo de configuración admitidos
El framework busca tu archivo de configuración usando el siguiente orden de prioridad. En modo producción, primero se comprueba la salida compilada; en todos los demás modos, el código fuente TypeScript tiene prioridad.
| Prioridad | Ruta | Modo |
|---|---|---|
| 1 | .spraxium/dist/spraxium.config.js | Solo producción |
| 2 | dist/spraxium.config.js | Solo producción |
| 3 | spraxium.config.ts | Todos los modos |
| 4 | spraxium.config.js | Todos los modos |
| 5 | spraxium.config.mjs | Todos los modos |
Resolución del entorno
NODE_ENV se lee una sola vez durante el inicio y se mapea a un objeto ConfigEnv. Este valor nunca cambia después de cargar la configuración, por lo que toda bifurcación basada en entorno debe ocurrir dentro de tu callback de defineConfig.
| NODE_ENV | Modo | Flags activas |
|---|---|---|
| production | production | isProd = true |
| neutral, staging, test | neutral | isNeutral = true |
| Cualquier otro valor | development | isDev = true |