Puedes consultar la página de ayuda de instalación de Catalyst CLI para obtener ayuda con la instalación del Catalyst CLI.

Una vez que hayas instalado Catalyst CLI usando el comando npm, puedes trabajar con el CLI desde tu terminal. Los comandos de Catalyst comienzan con la palabra clave catalyst. Puedes consultar la documentación del CLI para obtener ayuda detallada con todos los comandos del CLI.

Cuando una versión más reciente del Catalyst CLI esté disponible, tu terminal mostrará un mensaje alertándote después de ejecutar un comando del CLI exitosamente.

Para actualizar tu CLI, ejecuta el siguiente comando:

Alternativamente, puedes visitar el sitio web de NPM para verificar si estás usando la última versión.

Si se detectan problemas o comportamientos anormales en el CLI, Catalyst creará automáticamente un archivo catalyst-debug.log en el directorio desde el que se ejecutó el comando. Luego puedes contactar al equipo de Catalyst a través de nuestra dirección de correo de soporte: support@zohocatalyst.com.

Proporciona una breve descripción del problema y adjunta el archivo catalyst-debug.log en el correo. El equipo de Catalyst te contactará en menos de 24 horas con una solución para el problema.

Puedes encontrar este error si el Catalyst CLI no está correctamente instalado en tu sistema local. Puedes intentar los siguientes pasos para corregir este error:

1. Necesitarás verificar si instalaste la última versión estable de Node, y si es mayor que v12, ejecutando el comando node -v en tu terminal.

2. También debes verificar si la versión de NPM es mayor que v12 ejecutando el comando npm -v en tu terminal.

3. Desinstala y reinstala el Catalyst CLI con el comando sudo en MacOS o en el símbolo del sistema de Windows en modo administrador.

El Catalyst CLI solo admite Node.js v12 o posterior. Si encuentras este error, podría significar que tienes una versión inferior de Node.js instalada en tu sistema.

Puedes actualizar la versión de Node.js para resolver este error descargando Node.js v12 o superior para tu plataforma desde su sitio web oficial, o usar un gestor de versiones de Node como NVM para instalar Node.js y NPM. NPM viene incluido con Node.js cuando lo instalas. Para verificar si Node.js se ha actualizado correctamente, ejecuta el siguiente comando en tu terminal para comprobar la versión:

Encontrarás este error si la autorización TLS estricta ha sido habilitada en tu sistema. Puedes resolver este error ejecutando el siguiente comando en tu terminal:

Ahora puedes reintentar ejecutar el comando de Catalyst. Si el problema aún no se resuelve, contacta al soporte de Catalyst en support@zohocatalyst.com para obtener asistencia adicional.

El CLI solo compila las clases Java en tiempo de ejecución. Por lo tanto, si la versión del entorno Java y el javac que estás usando son diferentes, encontrarás este error.

Puedes verificar la versión de Java ejecutando el siguiente comando en tu terminal:

De manera similar, puedes verificar la versión de javac ejecutando el comando en tu terminal:

Si tienes más consultas, puedes contactar al soporte de Catalyst en support@zohocatalyst.com

Este problema ocurrirá cuando intentes inicializar tu proyecto en una carpeta que ya contiene un proyecto de Catalyst de una cuenta diferente. Este problema también ocurrirá cuando intentes inicializar un proyecto en una carpeta nueva en una ubicación donde otro proyecto fue previamente inicializado desde una cuenta diferente.

Por ejemplo: Supón que inicializas un proyecto en esta ubicación: C/windows/system32/catalyst/aliencity

Si las raíces de las carpetas llamadas catalyst, system32 o windows ya tienen un proyecto de Catalyst inicializado en ellas, encontrarás este error. Sin embargo, puedes tener proyectos en estos directorios dentro de sus propias carpetas.

Para resolver este problema, elimina todos los archivos relacionados con Catalyst, incluyendo el archivo oculto llamado .catalystrc de la carpeta actual así como de las demás carpetas en la ruta, y luego ejecuta el comando catalyst init nuevamente.

Si encuentras este error al ejecutar catalyst serve, puedes resolverlo de las siguientes maneras:

• Asegúrate de estar en la ruta de carpeta correcta cuando sirves los targets.
• Asegúrate de que tu directorio de proyecto no esté vacío y contenga al menos un recurso que pueda servirse. Catalyst puede servir endpoints de funciones de tipo Basic I/O y Advanced I/O, recursos de Client y AppSail. También puedes obtener el último código de tus recursos desde la consola de Catalyst a tu sistema local a través del comando catalyst pull, antes de servirlo.

Catalyst servirá tus funciones en el modo watch de forma predeterminada para garantizar que puedas realizar fácilmente el reemplazo de código en caliente. Puedes ejecutar el comando del CLI catalyst serve –no-watch para cambiar a un modo sin observación.

Este error ocurrirá cuando realices operaciones con archivos usando el comando catalyst serve. Para resolver este problema, usa la opción –no-watch con catalyst serve para la depuración local al realizar cualquier operación relacionada con archivos. El comando –no-watch desactiva el reemplazo de módulos en caliente.

Catalyst solo admite actualmente las versiones Java 8, Java 11, Java 17, Java 21 y Java 25. Por lo tanto, debes asegurarte de que las versiones de java y javac instaladas sean 1.8.x, 11.0.x, 17.0.x, 21.0.x o 25.0.x antes de depurar una función Java en el CLI.

Puedes ejecutar tu función cron localmente usando el comando catalyst shell en el CLI. Puedes pasar una variable JSON como entrada a la función cron. La función cron contendrá la variable context con todos los detalles de la función, incluso durante la depuración local.

Puedes ejecutar tu función de evento localmente usando el comando catalyst shell en el Catalyst CLI. Puedes generar un payload de ejemplo para tu función de evento y probarla ejecutando el comando catalyst event:generate {component} {action}.

Por ejemplo: catalyst event:generate DataStore insert. Esto generará un payload de ejemplo para una operación de inserción en Data Store. Luego puedes pasar el payload generado como entrada a tu función de evento en el CLI.

Encontrarás este error si hay más de 500 archivos presentes en tu carpeta de cliente. El número máximo de archivos permitidos en el cliente web de Catalyst es 500.