firestore-dart-generator 1.0.0-beta.1 → 1.0.1

package/INSTALACION.md

@@ -0,0 +1,392 @@
+# 📦 Guía de Instalación - Firestore Dart Generator
+
+## 🚀 Instalación Global (Recomendado)
+
+### Primera Instalación
+
+```bash
+npm install -g firestore-dart-generator
+```
+
+### Verificar Instalación
+
+```bash
+firestore-dart-gen --version
+# Debería mostrar: 1.0.0
+```
+
+### Usar el CLI
+
+```bash
+# Con archivo de configuración
+firestore-dart-gen
+
+# O con argumentos
+firestore-dart-gen --service-account firebase_service_account.json
+```
+
+---
+
+## 🔄 Actualizar a la Última Versión
+
+### Si ya tienes instalado
+
+```bash
+# Actualizar a la última versión
+npm update -g firestore-dart-generator
+
+# O reinstalar
+npm install -g firestore-dart-generator@latest
+```
+
+### Verificar versión instalada
+
+```bash
+# Ver versión actual
+firestore-dart-gen --version
+
+# Ver versión disponible en npm
+npm view firestore-dart-generator version
+
+# Ver todas las versiones disponibles
+npm view firestore-dart-generator versions
+```
+
+---
+
+## 📋 Instalación Local (En un Proyecto)
+
+### Como Dependencia de Desarrollo
+
+```bash
+# En tu proyecto Flutter/Dart
+npm install --save-dev firestore-dart-generator
+```
+
+### Usar con npx (Sin Instalación)
+
+```bash
+# Ejecutar sin instalar globalmente
+npx firestore-dart-generator --service-account credentials.json
+
+# O con config
+npx firestore-dart-generator
+```
+
+**Ventaja:** Siempre usa la última versión disponible.
+
+---
+
+## 🎯 Instalar Versión Específica
+
+### Versión Exacta
+
+```bash
+npm install -g firestore-dart-generator@1.0.0
+```
+
+### Versión Beta/Pre-release
+
+```bash
+npm install -g firestore-dart-generator@beta
+```
+
+### Última Versión
+
+```bash
+npm install -g firestore-dart-generator@latest
+```
+
+---
+
+## 🔍 Verificar Instalación Completa
+
+### 1. Verificar que está instalado
+
+```bash
+which firestore-dart-gen
+# Debería mostrar: /usr/local/bin/firestore-dart-gen
+# (o similar según tu sistema)
+```
+
+### 2. Verificar versión
+
+```bash
+firestore-dart-gen --version
+```
+
+### 3. Ver ayuda
+
+```bash
+firestore-dart-gen --help
+```
+
+### 4. Probar ejecución
+
+```bash
+# Debería mostrar el modo interactivo
+firestore-dart-gen --service-account tu-credentials.json
+```
+
+---
+
+## 🐛 Troubleshooting
+
+### "Command not found"
+
+**Problema:** El comando no está en tu PATH.
+
+**Solución:**
+
+```bash
+# Ver dónde npm instala paquetes globales
+npm config get prefix
+
+# Agregar al PATH (macOS/Linux)
+export PATH=$(npm config get prefix)/bin:$PATH
+
+# O reinstalar
+npm install -g firestore-dart-generator
+```
+
+### Versión Antigua
+
+**Problema:** Tienes una versión antigua instalada.
+
+**Solución:**
+
+```bash
+# Desinstalar y reinstalar
+npm uninstall -g firestore-dart-generator
+npm install -g firestore-dart-generator@latest
+```
+
+### Permisos (macOS/Linux)
+
+**Problema:** Error de permisos al instalar globalmente.
+
+**Solución:**
+
+```bash
+# Opción 1: Usar sudo (no recomendado)
+sudo npm install -g firestore-dart-generator
+
+# Opción 2: Configurar npm para no usar sudo (recomendado)
+mkdir ~/.npm-global
+npm config set prefix '~/.npm-global'
+export PATH=~/.npm-global/bin:$PATH
+npm install -g firestore-dart-generator
+```
+
+### Cache de npm
+
+**Problema:** npm usa versión en cache.
+
+**Solución:**
+
+```bash
+# Limpiar cache
+npm cache clean --force
+
+# Reinstalar
+npm install -g firestore-dart-generator@latest
+```
+
+---
+
+## 📊 Comparar Versiones
+
+### Ver qué versión tienes vs. qué hay disponible
+
+```bash
+# Versión instalada localmente
+firestore-dart-gen --version
+
+# Última versión en npm
+npm view firestore-dart-generator version
+
+# Todas las versiones publicadas
+npm view firestore-dart-generator versions --json
+```
+
+### Ejemplo de Output
+
+```bash
+$ firestore-dart-gen --version
+1.0.0
+
+$ npm view firestore-dart-generator version
+1.0.0
+
+# Si hay una nueva versión disponible:
+$ npm view firestore-dart-generator version
+1.1.0  # ← Nueva versión disponible
+
+# Actualizar
+$ npm update -g firestore-dart-generator
+```
+
+---
+
+## 🔄 Workflow de Actualización
+
+### Para Usuarios
+
+```bash
+# 1. Verificar versión actual
+firestore-dart-gen --version
+
+# 2. Ver versión disponible
+npm view firestore-dart-generator version
+
+# 3. Si hay actualización, actualizar
+npm update -g firestore-dart-generator
+
+# 4. Verificar nueva versión
+firestore-dart-gen --version
+```
+
+### Para Desarrolladores del Paquete
+
+```bash
+# 1. Actualizar versión en package.json
+npm version patch  # 1.0.0 -> 1.0.1
+# o
+npm version minor  # 1.0.0 -> 1.1.0
+# o
+npm version major  # 1.0.0 -> 2.0.0
+
+# 2. Build
+npm run build
+
+# 3. Publicar
+npm publish
+
+# 4. Verificar publicación
+npm view firestore-dart-generator version
+```
+
+---
+
+## 📦 Instalación en Diferentes Sistemas
+
+### macOS
+
+```bash
+# Con Homebrew (si tienes fórmula)
+brew install firestore-dart-generator
+
+# O con npm
+npm install -g firestore-dart-generator
+```
+
+### Linux
+
+```bash
+# Con npm
+npm install -g firestore-dart-generator
+
+# O con npx (sin instalar)
+npx firestore-dart-generator
+```
+
+### Windows
+
+```powershell
+# Con npm
+npm install -g firestore-dart-generator
+
+# Verificar instalación
+firestore-dart-gen --version
+```
+
+---
+
+## ✅ Checklist Post-Instalación
+
+Después de instalar, verifica:
+
+- [ ] `firestore-dart-gen --version` funciona
+- [ ] `firestore-dart-gen --help` muestra ayuda
+- [ ] Puedes ejecutar el CLI con tu service account
+- [ ] El modo interactivo funciona
+- [ ] Puedes crear y usar `firestore-dart-gen.yaml`
+
+---
+
+## 🎯 Próximos Pasos Después de Instalar
+
+### 1. Crear archivo de configuración
+
+```bash
+# En tu proyecto Flutter
+cd mi-proyecto-flutter
+
+# Crear config
+cat > firestore-dart-gen.yaml << EOF
+firebase:
+  serviceAccount: ./firebase_service_account.json
+
+collections:
+  - users
+  - products
+
+output:
+  directory: ./lib/src/models
+  sampleSize: 20
+EOF
+```
+
+### 2. Ejecutar
+
+```bash
+firestore-dart-gen
+```
+
+### 3. Usar modelos generados
+
+```dart
+// En tu código Dart
+import 'package:mi_proyecto/models/user_dto.dart';
+
+final user = UserDTO.fromJson(firestoreDoc.data()!);
+```
+
+---
+
+## 📚 Recursos
+
+- **npm Package**: https://www.npmjs.com/package/firestore-dart-generator
+- **GitHub**: https://github.com/TU_USUARIO/firestore-dart-generator
+- **Documentación**: Ver `README.md`
+- **Guía Config**: Ver `CONFIG_FILE_GUIDE.md`
+
+---
+
+## 💡 Tips
+
+### Usar npx para Probar Sin Instalar
+
+```bash
+# Probar última versión sin instalar
+npx firestore-dart-generator@latest --help
+```
+
+### Mantener Actualizado
+
+```bash
+# Agregar a tu script de setup
+npm install -g firestore-dart-generator@latest
+```
+
+### Ver Changelog
+
+```bash
+# Ver cambios de la versión
+npm view firestore-dart-generator
+```
+
+---
+
+¡Listo para usar! 🚀
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firestore-dart-generator",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.1",
   "description": "Generate Dart models from Firestore collections by analyzing real document schemas",
   "main": "dist/index.js",
   "bin": {