Solución de problemas

Este error significa que la CLI de i1n no está instalada globalmente o no se encuentra en su PATH. Ejecute npm install -g i1n para instalarla. Si utiliza un gestor de versiones (nvm, fnm), asegúrese de que el directorio bin global esté incluido en su PATH.

En macOS/Linux, puede verificar la ruta de instalación con which i1n. Si utiliza bun, ejecute bun install -g i1n en su lugar.

Esto ocurre cuando la clave de API en i1n.config.json falta, ha caducado o no es válida. Genere una nueva clave desde la configuración de su organización en dashboard.i1n.ai y ejecute i1n init para reconfigurar.

Asegúrese de estar utilizando la clave de API correcta para la organización propietaria del proyecto. Cada organización tiene sus propias claves; una clave de una organización no puede acceder a los proyectos de otra.

Si i1n push informa cero claves o salta archivos, verifique que su directorio de locales y el formato de archivo coincidan con la configuración en i1n.config.json. Ejecute i1n init para reconfigurar si es necesario.

Las causas comunes incluyen patrones glob incorrectos, formatos de archivo no coincidentes (por ejemplo, JSON plano cuando se configuró JSON anidado) o archivos de traducción vacíos.

Esto generalmente significa que el proyecto no tiene traducciones en el servidor. Ejecute i1n push primero para cargar sus claves de origen y, luego, i1n pull para descargar las traducciones.

Si ha enviado claves pero pull devuelve archivos vacíos, verifique que los idiomas de destino se hayan agregado a su proyecto usando i1n add-language o a través del panel de control.

Si su IDE muestra errores después de realizar el pull, asegúrese de que i1n.d.ts esté incluido en su compilación de TypeScript. La CLI actualiza automáticamente tsconfig.json, pero las configuraciones manuales podrían requerir ajustes.

Nunca modifique i1n.d.ts directamente, ya que se regenera en cada i1n pull. Si el archivo parece estar dañado, elimínelo y ejecute i1n pull nuevamente.