Solución de problemas

Este error significa que la CLI de i1n no está instalada globalmente o no se encuentra en tu PATH. Ejecuta npm install -g i1n para instalarla. Si usas un gestor de versiones (nvm, fnm), asegúrate de que el directorio global de binarios esté en tu PATH.

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

Esto ocurre cuando la clave de API en i1n.config.json falta, ha expirado o es inválida. Genera una nueva clave desde la configuración de tu organización en dashboard.i1n.ai y ejecuta i1n init para reconfigurar.

Asegúrate de estar utilizando la clave 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 omite archivos, verifica que tu directorio de locales y el formato de archivo coincidan con la configuración en i1n.config.json. Ejecuta 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 configura JSON anidado) o archivos de traducción vacíos.

Esto generalmente significa que el proyecto no tiene traducciones en el servidor. Ejecuta `i1n push` primero para subir tus claves de origen, luego `i1n pull` para descargar las traducciones.

Si has subido claves pero `pull` devuelve archivos vacíos, verifica que los idiomas de destino se hayan agregado a tu proyecto usando `i1n add-language` o a través del panel de control.

Si su IDE muestra errores después de hacer un 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 pueden requerir ajustes.

Nunca modifique i1n.d.ts directamente — se regenera en cada pull de i1n. Si el archivo parece corrupto, elimínelo y ejecute i1n pull nuevamente.