firestore-dart-generator 1.0.3 → 1.0.4

package/README.md

@@ -586,5 +586,5 @@ MIT
 
 ## Support
 
-If you encounter any issues or have questions, please [open an issue](https://github.com/your-username/firestore-dart-generator/issues) on GitHub.
+If you encounter any issues or have questions, please [open an issue](https://github.com/MarcosTort/firestore-code-generator/issues) on GitHub.
 

package/dist/generators/base-generator.d.ts

@@ -0,0 +1,44 @@
+import { SchemaInfo, UniversalType } from '../types';
+/**
+ * Abstract base class for language-specific code generators.
+ * Each language generator extends this class and implements language-specific logic.
+ */
+export declare abstract class BaseGenerator {
+    protected template: HandlebarsTemplateDelegate | null;
+    constructor();
+    /**
+     * Register Handlebars helpers common to all generators
+     */
+    protected registerHelpers(): void;
+    /**
+     * Get the target programming language name
+     */
+    protected abstract getLanguage(): string;
+    /**
+     * Get the file extension for generated files (e.g., '.dart', '.ts', '.kt')
+     */
+    abstract getFileExtension(): string;
+    /**
+     * Map a universal type to the target language's type
+     * @param universalType The language-agnostic type
+     * @returns The language-specific type string
+     */
+    abstract mapType(universalType: UniversalType): string;
+    /**
+     * Generate code from schema
+     */
+    abstract generateModel(schema: SchemaInfo): string;
+    /**
+     * Load the Handlebars template for this generator
+     */
+    protected loadTemplate(templateName?: string): void;
+    /**
+     * Convert PascalCase to snake_case
+     */
+    protected toSnakeCase(str: string): string;
+    /**
+     * Write generated code to file
+     */
+    writeModelToFile(schema: SchemaInfo, outputDir: string): Promise<string>;
+}
+//# sourceMappingURL=base-generator.d.ts.map

package/dist/generators/base-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-generator.d.ts","sourceRoot":"","sources":["../../src/generators/base-generator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAErD;;;GAGG;AACH,8BAAsB,aAAa;IAC/B,SAAS,CAAC,QAAQ,EAAE,0BAA0B,GAAG,IAAI,CAAQ;;IAM7D;;OAEG;IACH,SAAS,CAAC,eAAe,IAAI,IAAI;IAOjC;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,IAAI,MAAM;IAExC;;OAEG;IACH,QAAQ,CAAC,gBAAgB,IAAI,MAAM;IAEnC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM;IAEtD;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAElD;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,YAAY,GAAE,MAAoB,GAAG,IAAI;IAoBhE;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAQ1C;;OAEG;IACG,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAiBjF"}

package/dist/generators/base-generator.js

@@ -0,0 +1,103 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseGenerator = void 0;
+const fs = __importStar(require("fs"));
+const handlebars_1 = __importDefault(require("handlebars"));
+const path = __importStar(require("path"));
+/**
+ * Abstract base class for language-specific code generators.
+ * Each language generator extends this class and implements language-specific logic.
+ */
+class BaseGenerator {
+    constructor() {
+        this.template = null;
+        this.registerHelpers();
+    }
+    /**
+     * Register Handlebars helpers common to all generators
+     */
+    registerHelpers() {
+        // Helper to check equality
+        handlebars_1.default.registerHelper('eq', (a, b) => {
+            return a === b;
+        });
+    }
+    /**
+     * Load the Handlebars template for this generator
+     */
+    loadTemplate(templateName = 'model.hbs') {
+        if (this.template) {
+            return;
+        }
+        const templatePath = path.join(__dirname, '../templates', this.getLanguage(), templateName);
+        if (!fs.existsSync(templatePath)) {
+            throw new Error(`Template file not found: ${templatePath}`);
+        }
+        const templateSource = fs.readFileSync(templatePath, 'utf8');
+        this.template = handlebars_1.default.compile(templateSource);
+    }
+    /**
+     * Convert PascalCase to snake_case
+     */
+    toSnakeCase(str) {
+        return str
+            .replace(/([a-z])([A-Z])/g, '$1_$2')
+            .replace(/([0-9])([A-Z])/g, '$1_$2')
+            .replace(/([A-Z])([A-Z][a-z])/g, '$1_$2')
+            .toLowerCase();
+    }
+    /**
+     * Write generated code to file
+     */
+    async writeModelToFile(schema, outputDir) {
+        const code = this.generateModel(schema);
+        // Ensure output directory exists
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        // Convert class name to appropriate filename
+        const fileName = this.toSnakeCase(schema.className) + this.getFileExtension();
+        const filePath = path.join(outputDir, fileName);
+        // Write file
+        fs.writeFileSync(filePath, code, 'utf8');
+        return filePath;
+    }
+}
+exports.BaseGenerator = BaseGenerator;
+//# sourceMappingURL=base-generator.js.map

package/dist/generators/base-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-generator.js","sourceRoot":"","sources":["../../src/generators/base-generator.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAyB;AACzB,4DAAoC;AACpC,2CAA6B;AAG7B;;;GAGG;AACH,MAAsB,aAAa;IAG/B;QAFU,aAAQ,GAAsC,IAAI,CAAC;QAGzD,IAAI,CAAC,eAAe,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACO,eAAe;QACrB,2BAA2B;QAC3B,oBAAU,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAM,EAAE,CAAM,EAAE,EAAE;YAC/C,OAAO,CAAC,KAAK,CAAC,CAAC;QACnB,CAAC,CAAC,CAAC;IACP,CAAC;IAwBD;;OAEG;IACO,YAAY,CAAC,eAAuB,WAAW;QACrD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAChB,OAAO;QACX,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAC1B,SAAS,EACT,cAAc,EACd,IAAI,CAAC,WAAW,EAAE,EAClB,YAAY,CACf,CAAC;QAEF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,4BAA4B,YAAY,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,cAAc,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,GAAG,oBAAU,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACO,WAAW,CAAC,GAAW;QAC7B,OAAO,GAAG;aACL,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;aACnC,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;aACnC,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC;aACxC,WAAW,EAAE,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAAkB,EAAE,SAAiB;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAExC,iCAAiC;QACjC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAEhD,aAAa;QACb,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAEzC,OAAO,QAAQ,CAAC;IACpB,CAAC;CACJ;AA7FD,sCA6FC"}

package/dist/templates/dart/model.hbs

@@ -0,0 +1,39 @@
+/// A model representing a {{collectionName}} document from Firestore.
+class {{className}} extends Equatable {
+  /// Creates a new [{{className}}] instance.
+  const {{className}}({{#if fields.length}}{
+{{#each fields}}
+    {{#unless isOptional}}required {{/unless}}this.{{name}},
+{{/each}}
+  }{{/if}});
+
+  /// Creates a [{{className}}] from a JSON map.
+  factory {{className}}.fromJson(Map<String, dynamic> json) {
+    return {{className}}({{#if fields.length}}
+    {{#each fields}}
+    {{name}}: {{#if (eq type "DateTime")}}{{#if isNullable}}json['{{name}}'] != null ? DateTime.parse(json['{{name}}'] as String) : null{{else}}DateTime.parse(json['{{name}}'] as String){{/if}}{{else}}{{#if nestedSchema}}{{#if isNullable}}json['{{name}}'] != null ? {{type}}.fromJson(json['{{name}}'] as Map<String, dynamic>) : null{{else}}{{type}}.fromJson(json['{{name}}'] as Map<String, dynamic>){{/if}}{{else if listItemSchema}}{{#if isNullable}}json['{{name}}'] != null ? (json['{{name}}'] as List<dynamic>).map((e) => {{listItemSchema.className}}.fromJson(e as Map<String, dynamic>)).toList() : null{{else}}(json['{{name}}'] as List<dynamic>).map((e) => {{listItemSchema.className}}.fromJson(e as Map<String, dynamic>)).toList(){{/if}}{{else}}{{#if isNullable}}json['{{name}}'] as {{{type}}}?{{else}}json['{{name}}'] as {{{type}}}{{/if}}{{/if}}{{/if}},
+      {{/each}}{{/if}}
+    );
+  }
+
+{{#each fields}}
+  /// The {{name}} field.
+  final {{{type}}}{{#if isNullable}}?{{/if}} {{name}};
+
+{{/each}}
+  @override
+  List<Object?> get props => [
+{{#each fields}}
+    {{name}},
+{{/each}}
+];
+
+  /// Converts this [{{className}}] to a JSON map.
+  Map<String, dynamic> toJson() {
+    return {
+    {{#each fields}}
+      {{#if isOptional}}if ({{name}} != null) {{/if}}'{{name}}': {{#if (eq type "DateTime")}}{{name}}{{#if isNullable}}?{{/if}}.toIso8601String(){{else if nestedSchema}}{{name}}{{#if isNullable}}?{{/if}}.toJson(){{else if listItemSchema}}{{name}}{{#if isNullable}}?{{/if}}.map((e) => e.toJson()).toList(){{else}}{{name}}{{/if}},
+      {{/each}}
+    };
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "firestore-dart-generator",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Generate Dart models from Firestore collections by analyzing real document schemas",
   "main": "dist/index.js",
   "bin": {
@@ -33,11 +33,11 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/TU_USUARIO/firestore-dart-generator.git"
+    "url": "git+https://github.com/MarcosTort/firestore-code-generator.git"
   },
-  "homepage": "https://github.com/TU_USUARIO/firestore-dart-generator#readme",
+  "homepage": "https://github.com/MarcosTort/firestore-code-generator#readme",
   "bugs": {
-    "url": "https://github.com/TU_USUARIO/firestore-dart-generator/issues"
+    "url": "https://github.com/MarcosTort/firestore-code-generator/issues"
   },
   "dependencies": {
     "chalk": "^4.1.2",
@@ -58,4 +58,4 @@
     "ts-node": "^10.9.2",
     "typescript": "^5.3.3"
   }
-}
+}

package/CONFIG_FILE_GUIDE.md

@@ -1,445 +0,0 @@
-# 📄 Guía de Archivo de Configuración
-
-## ✅ IMPLEMENTACIÓN COMPLETA
-
-El CLI ahora soporta un archivo de configuración YAML que hace el uso mucho más conveniente.
-
----
-
-## 🚀 Uso Rápido
-
-### 1. Crear archivo de configuración
-
-```bash
-# Copiar el ejemplo
-cp firestore-dart-gen.example.yaml firestore-dart-gen.yaml
-
-# Editar con tus valores
-nano firestore-dart-gen.yaml
-```
-
-### 2. Configurar
-
-```yaml
-# firestore-dart-gen.yaml
-firebase:
-  serviceAccount: ./firebase_service_account.json
-
-collections:
-  - users
-  - products
-
-output:
-  directory: ./lib/src/models
-  sampleSize: 20
-```
-
-### 3. Ejecutar
-
-```bash
-# Simplemente ejecuta sin argumentos
-firestore-dart-gen
-
-# El CLI:
-# ✓ Carga credenciales del YAML
-# ✓ Pre-selecciona users y products
-# ✓ Usa ./lib/src/models como directorio por defecto
-# ✓ Usa 20 como sample size por defecto
-```
-
----
-
-## 📋 Estructura del Archivo
-
-### Completo (todos los campos opcionales)
-
-```yaml
-# Firebase Configuration
-firebase:
-  # Path al service account (requerido si no usas CLI args)
-  serviceAccount: ./firebase_service_account.json
-  
-  # Project ID (opcional, se puede obtener del service account)
-  projectId: my-project-id
-
-# Collections que aparecerán pre-seleccionadas (opcional)
-collections:
-  - users
-  - products
-  - orders
-  - reviews
-  - settings
-
-# Configuración de output (opcional)
-output:
-  # Directorio donde se generarán los modelos
-  directory: ./lib/src/models
-  
-  # Cantidad de documentos a samplear por colección
-  sampleSize: 20
-```
-
-### Mínimo (solo credenciales)
-
-```yaml
-firebase:
-  serviceAccount: ./firebase_service_account.json
-```
-
-### Solo pre-selección (sin credenciales)
-
-```yaml
-collections:
-  - users
-  - products
-
-output:
-  directory: ./lib/src/models
-```
-
-Luego ejecutar:
-```bash
-firestore-dart-gen --service-account credentials.json
-```
-
----
-
-## 🎯 Comportamiento
-
-### Sin Archivo de Config
-
-```bash
-firestore-dart-gen --service-account credentials.json
-```
-
-**Resultado:**
-- Todas las colecciones SIN pre-seleccionar
-- Default output: `./lib/src/models`
-- Default sample size: `20`
-
-### Con Archivo de Config
-
-```bash
-# firestore-dart-gen.yaml existe
-firestore-dart-gen
-```
-
-**Resultado:**
-- Colecciones del YAML aparecen **✓ PRE-SELECCIONADAS**
-- Output directory del YAML como default
-- Sample size del YAML como default
-- Usuario puede cambiar cualquier valor en los prompts
-
-### Con Config + CLI Args
-
-```bash
-# firestore-dart-gen.yaml existe
-firestore-dart-gen --service-account other.json
-```
-
-**Resultado:**
-- Usa `other.json` (CLI arg gana sobre YAML)
-- Pre-selecciona colecciones del YAML
-- Usa outputs del YAML
-
----
-
-## 🔐 Prioridad de Configuración
-
-```
-┌─────────────────────────────────────────────┐
-│  1. CLI Arguments (highest priority)        │
-│     --service-account                       │
-│     --project-id                            │
-│     --config                                │
-├─────────────────────────────────────────────┤
-│  2. Config File                             │
-│     firestore-dart-gen.yaml                 │
-├─────────────────────────────────────────────┤
-│  3. Environment Variables (lowest priority) │
-│     GOOGLE_APPLICATION_CREDENTIALS          │
-│     FIREBASE_PROJECT_ID                     │
-└─────────────────────────────────────────────┘
-```
-
-**Ejemplo práctico:**
-
-```yaml
-# firestore-dart-gen.yaml
-firebase:
-  serviceAccount: ./dev-credentials.json  # Priority 2
-
-# .env
-GOOGLE_APPLICATION_CREDENTIALS=./prod-credentials.json  # Priority 3
-```
-
-```bash
-# Usa dev-credentials.json (del YAML, priority 2)
-firestore-dart-gen
-
-# Usa prod-credentials.json (CLI arg, priority 1)
-firestore-dart-gen --service-account ./prod-credentials.json
-```
-
----
-
-## 📁 Ubicación del Archivo
-
-El CLI busca el archivo de config en este orden:
-
-1. Path especificado con `--config`
-2. `firestore-dart-gen.yaml` (en directorio actual)
-3. `firestore-dart-gen.yml`
-4. `.firestore-dart-gen.yaml` (hidden)
-5. `.firestore-dart-gen.yml` (hidden)
-
-**Recomendación:** Usa `firestore-dart-gen.yaml` en la raíz de tu proyecto Flutter.
-
----
-
-## 🎨 Ejemplo de Sesión Interactiva
-
-### Con archivo de config:
-
-```bash
-$ firestore-dart-gen
-
-🔥 Firestore Dart Generator - Interactive Mode
-
-📄 Found config file: firestore-dart-gen.yaml
-
-✓ Connected to Firebase Project: my-awesome-app
-
-🔍 Discovering collections...
-
-Found 7 collection(s)
-
-Pre-selected from config: users, products
-
-? Select collections to generate models for: (Use ↑↓, Space, Enter)
-❯◉ users         ← Pre-seleccionado ✓
- ◉ products      ← Pre-seleccionado ✓
- ◯ orders
- ◯ reviews
- ◯ settings
- ◯ notifications
- ◯ analytics
-
-🌳 Checking for subcollections...
-
-  Analyzing users...
-  Found 2 subcollection(s): profiles, settings
-  Include subcollections for users? (Y/n) y
-
-? Output directory: ./lib/src/models  ← Default del config
-? Sample size: 20  ← Default del config
-
-📋 Generation Summary:
-────────────────────────────────────────────────
-  Firebase Project: my-awesome-app
-  Collections: users, products
-  Subcollections:
-    └─ users: profiles, settings
-  Output: ./lib/src/models
-  Sample Size: 20 documents per collection
-────────────────────────────────────────────────
-
-? Generate? (Y/n) y
-
-✨ Success! Generated 4 model(s)
-```
-
----
-
-## 💡 Casos de Uso
-
-### Desarrollo Local
-
-```yaml
-# firestore-dart-gen.yaml
-firebase:
-  serviceAccount: ./dev-credentials.json
-  projectId: my-app-dev
-
-collections:
-  - users
-  - products
-
-output:
-  directory: ./lib/src/models
-  sampleSize: 10  # Menos documentos para desarrollo
-```
-
-### Producción / CI/CD
-
-```yaml
-# firestore-dart-gen.yaml (commitear en repo)
-collections:
-  - users
-  - products
-  - orders
-
-output:
-  directory: ./lib/src/models
-  sampleSize: 50  # Más documentos para mejor análisis
-
-# NO incluir firebase.serviceAccount aquí!
-# Usar variable de entorno o CLI arg en CI
-```
-
-En CI:
-```bash
-firestore-dart-gen --service-account $SERVICE_ACCOUNT_PATH
-```
-
-### Equipos
-
-```yaml
-# firestore-dart-gen.yaml (compartir en repo)
-# NO incluir credenciales
-
-collections:
-  - users
-  - products
-  - orders
-  - reviews
-  - notifications
-
-output:
-  directory: ./packages/core/lib/models
-  sampleSize: 20
-```
-
-Cada desarrollador crea su propio `.env`:
-```bash
-GOOGLE_APPLICATION_CREDENTIALS=./mi-credentials.json
-```
-
----
-
-## ⚠️ Seguridad
-
-### ✅ Buenas Prácticas
-
-```yaml
-# firestore-dart-gen.yaml (SAFE para commitear)
-collections:
-  - users
-  - products
-
-output:
-  directory: ./lib/src/models
-```
-
-```bash
-# .gitignore
-firestore-dart-gen.yaml  # Si incluye credenciales
-*service-account.json
-```
-
-### ❌ NO Hacer
-
-```yaml
-# ❌ NO commitear credenciales en el YAML
-firebase:
-  serviceAccount: ./super-secret-credentials.json  # PELIGRO!
-```
-
-**Solución:** Usa variables de entorno o CLI args para credenciales sensibles.
-
----
-
-## 🔧 Troubleshooting
-
-### "Could not load config file"
-
-```bash
-# Verifica que el YAML es válido
-cat firestore-dart-gen.yaml
-
-# Verifica la sintaxis YAML
-npm install -g js-yaml
-js-yaml firestore-dart-gen.yaml
-```
-
-### "Service account file not found"
-
-```bash
-# Verifica el path en el config
-cat firestore-dart-gen.yaml
-
-# Verifica que el archivo existe
-ls -la firebase_service_account.json
-
-# Usa path absoluto si es necesario
-firebase:
-  serviceAccount: /Users/you/projects/credentials.json
-```
-
-### Config no se carga
-
-```bash
-# Verifica que estás en el directorio correcto
-pwd
-ls firestore-dart-gen.yaml
-
-# O especifica el path explícitamente
-firestore-dart-gen --config ./path/to/config.yaml
-```
-
----
-
-## 📊 Archivos Creados
-
-### Nuevos Archivos
-- ✅ `src/config-file-loader.ts` (108 líneas) - Loader de configuración
-- ✅ `firestore-dart-gen.example.yaml` (27 líneas) - Ejemplo de configuración
-- ✅ `CONFIG_FILE_GUIDE.md` (este archivo) - Guía completa
-
-### Archivos Modificados
-- ✅ `src/interactive-cli.ts` - Integra configuración YAML
-- ✅ `src/index.ts` - Agrega opción --config
-- ✅ `src/types.ts` - Define CLIConfig interface
-- ✅ `.gitignore` - Ignora archivos de config
-- ✅ `README.md` - Documenta configuración
-
----
-
-## ✨ Beneficios
-
-### Para Desarrolladores
-✅ No escribir credenciales cada vez
-✅ Pre-selección automática de colecciones frecuentes
-✅ Configuración compartible entre equipo
-✅ Valores por defecto personalizables
-
-### Para Equipos
-✅ Configuración estándar compartida en repo
-✅ Credenciales manejadas externamente
-✅ Consistencia en outputs
-✅ Fácil onboarding de nuevos miembros
-
-### Para CI/CD
-✅ Config en repo, credenciales en secrets
-✅ Override con CLI args
-✅ Configuración versionada
-✅ Reproducible
-
----
-
-## 🎉 Estado
-
-**✅ COMPLETAMENTE IMPLEMENTADO Y FUNCIONAL**
-
-- Build exitoso ✓
-- Tests pasando (23/23) ✓
-- CLI funcionando ✓
-- Documentación completa ✓
-
-**Listo para usar!** 🚀
-
----
-
-*Creado: Diciembre 17, 2024*
-*Versión: 1.1.0*
-

package/IMPLEMENTATION_SUMMARY.md

@@ -1,305 +0,0 @@
-# 🎉 Resumen de Implementación - Config File Support
-
-## ✅ COMPLETADO EXITOSAMENTE
-
-El soporte para archivo de configuración YAML ha sido completamente implementado y está listo para usar.
-
----
-
-## 📊 Resultados
-
-```
-╔═══════════════════════════════════════════════════════════╗
-║  ✅ Build:        EXITOSO                                 ║
-║  ✅ Tests:        23/23 pasando                           ║
-║  ✅ Compilación:  Sin errores                             ║
-║  ✅ TODOs:        8/8 completados                         ║
-╚═══════════════════════════════════════════════════════════╝
-```
-
----
-
-## 📁 Archivos Nuevos (3)
-
-1. **`src/config-file-loader.ts`** (108 líneas)
-   - Clase ConfigFileLoader
-   - Métodos de carga y validación
-   - Resolución de prioridades
-   - Soporte para múltiples nombres de archivo
-
-2. **`firestore-dart-gen.example.yaml`** (27 líneas)
-   - Archivo de ejemplo comentado
-   - Documenta todas las opciones
-   - Listo para copiar y personalizar
-
-3. **`CONFIG_FILE_GUIDE.md`** (350+ líneas)
-   - Guía completa de uso
-   - Ejemplos de configuración
-   - Troubleshooting
-   - Casos de uso
-
----
-
-## 📝 Archivos Modificados (6)
-
-1. **`src/interactive-cli.ts`**
-   - Importa ConfigFileLoader
-   - Carga config al inicio
-   - Pre-selecciona colecciones del config
-   - Usa defaults del config
-
-2. **`src/index.ts`**
-   - Agrega opción `--config <path>`
-   - Pasa configPath a runInteractiveCLI
-
-3. **`src/types.ts`**
-   - Define CLIConfig interface
-   - Tipos para firebase, collections, output
-
-4. **`.gitignore`**
-   - Ignora archivos de configuración
-   - Previene commit de credenciales
-
-5. **`README.md`**
-   - Nueva sección "Configuration File"
-   - Ejemplos de uso
-   - Prioridad de configuración
-   - Beneficios documentados
-
-6. **`package.json`**
-   - Ya contenía las dependencias necesarias
-
----
-
-## 🎯 Funcionalidades Implementadas
-
-### ✅ Carga Automática de Config
-- [x] Busca `firestore-dart-gen.yaml` automáticamente
-- [x] Soporta variantes (.yml, hidden files)
-- [x] Opción --config para especificar path custom
-- [x] Funciona sin config file (opcional)
-
-### ✅ Resolución de Credenciales
-- [x] Prioridad: CLI args > Config > Env
-- [x] Service account desde YAML
-- [x] Project ID desde YAML
-- [x] Fallback a variables de entorno
-
-### ✅ Pre-selección de Colecciones
-- [x] Colecciones del YAML aparecen checked ✓
-- [x] Usuario puede agregar/quitar más
-- [x] Validación de al menos 1 seleccionada
-- [x] Indicador visual de pre-selección
-
-### ✅ Defaults Configurables
-- [x] Output directory desde config
-- [x] Sample size desde config
-- [x] Usuario puede cambiarlos en prompts
-- [x] Fallback a valores sensatos
-
-### ✅ Validación y Errores
-- [x] Valida estructura del YAML
-- [x] Verifica que service account existe
-- [x] Valida que collections sea array
-- [x] Valida sample size > 0
-- [x] Mensajes de error claros
-
----
-
-## 🎨 Ejemplo de Uso Completo
-
-### 1. Crear Config
-
-```bash
-cp firestore-dart-gen.example.yaml firestore-dart-gen.yaml
-```
-
-Editar:
-```yaml
-firebase:
-  serviceAccount: ./firebase_service_account.json
-
-collections:
-  - users
-  - products
-
-output:
-  directory: ./lib/src/models
-  sampleSize: 20
-```
-
-### 2. Ejecutar
-
-```bash
-firestore-dart-gen
-```
-
-### 3. Experiencia
-
-```
-🔥 Firestore Dart Generator - Interactive Mode
-
-📄 Found config file: firestore-dart-gen.yaml
-
-✓ Connected to Firebase Project: my-app
-
-Found 7 collection(s)
-
-Pre-selected from config: users, products
-
-? Select collections: (↑↓ Space Enter)
-❯◉ users         ← ✓
- ◉ products      ← ✓
- ◯ orders
- ◯ reviews
-
-? Output directory: ./lib/src/models
-? Sample size: 20
-
-? Generate? Yes
-
-✨ Success! Generated 2 model(s)
-```
-
----
-
-## 🔐 Prioridad de Configuración
-
-```
-┌──────────────────────────────┐
-│  1. CLI Arguments            │  ← Highest Priority
-│     --service-account        │
-│     --project-id             │
-│     --config                 │
-├──────────────────────────────┤
-│  2. Config File              │
-│     firestore-dart-gen.yaml  │
-├──────────────────────────────┤
-│  3. Environment Variables    │  ← Lowest Priority
-│     .env                     │
-└──────────────────────────────┘
-```
-
-**Ejemplo:**
-
-```yaml
-# firestore-dart-gen.yaml
-firebase:
-  serviceAccount: ./dev.json
-```
-
-```bash
-# Usa dev.json del YAML
-firestore-dart-gen
-
-# Usa prod.json del CLI arg (gana)
-firestore-dart-gen --service-account prod.json
-```
-
----
-
-## 📚 Documentación Creada
-
-- ✅ **README.md**: Sección "Configuration File (Optional)"
-- ✅ **CONFIG_FILE_GUIDE.md**: Guía completa (este archivo)
-- ✅ **firestore-dart-gen.example.yaml**: Archivo ejemplo
-- ✅ **cli.plan.md**: Plan de implementación
-
----
-
-## 🧪 Testing
-
-```bash
-npm test
-```
-
-**Resultado:**
-```
-✅ Test Suites: 2 passed, 2 total
-✅ Tests: 23 passed, 23 total
-✅ Time: ~2s
-```
-
-La lógica core no cambió, por lo que todos los tests siguen pasando.
-
----
-
-## 🚀 Próximos Pasos
-
-### Para Usar
-
-```bash
-# 1. Crear config
-cp firestore-dart-gen.example.yaml firestore-dart-gen.yaml
-
-# 2. Editar con tus valores
-nano firestore-dart-gen.yaml
-
-# 3. Ejecutar
-firestore-dart-gen
-```
-
-### Para Publicar
-
-El paquete está listo para publicar en npm con esta nueva funcionalidad.
-
-Ver: [`PUBLICACION_NPM.md`](PUBLICACION_NPM.md)
-
----
-
-## ✨ Mejoras Logradas
-
-### Antes
-```bash
-# Escribir todo cada vez
-firestore-dart-gen batch \
-  --service-account firebase_service_account.json \
-  --config collections.yaml
-```
-
-### Ahora
-```bash
-# Una sola vez: configurar YAML
-# Luego simplemente:
-firestore-dart-gen
-
-# Pre-selecciona tus colecciones favoritas ✓
-# Usa tus defaults ✓
-# Menos typing ✓
-```
-
----
-
-## 📊 Estadísticas
-
-- **Archivos nuevos:** 3
-- **Archivos modificados:** 6
-- **Líneas de código:** ~450 nuevas
-- **Tests pasando:** 23/23
-- **Build time:** ~2s
-- **Tiempo de implementación:** Completo
-
----
-
-## 🎉 Conclusión
-
-**✅ IMPLEMENTACIÓN 100% COMPLETA**
-
-El archivo de configuración YAML está completamente integrado en el CLI interactivo:
-
-✅ Carga automática
-✅ Pre-selección de colecciones
-✅ Defaults configurables
-✅ Prioridad flexible
-✅ Documentación completa
-✅ Tests pasando
-✅ Build exitoso
-
-**Estado: LISTO PARA PRODUCCIÓN** 🚀
-
----
-
-*Implementado: Diciembre 17, 2024*
-*Tests: 23/23 passing ✓*
-*Build: Successful ✓*
-

package/QUICK_START.md

@@ -1,241 +0,0 @@
-# 🚀 Inicio Rápido - Firestore Dart Generator
-
-## Opción 1: Con Archivo de Configuración (Recomendado)
-
-### Paso 1: Crear configuración
-```bash
-cp firestore-dart-gen.example.yaml firestore-dart-gen.yaml
-```
-
-### Paso 2: Editar configuración
-```yaml
-# firestore-dart-gen.yaml
-firebase:
-  serviceAccount: ./firebase_service_account.json
-
-collections:
-  - users      # Pre-seleccionados
-  - products   # Pre-seleccionados
-
-output:
-  directory: ./lib/src/models
-  sampleSize: 20
-```
-
-### Paso 3: Ejecutar
-```bash
-npm run dev
-```
-
-**Resultado:**
-- ✅ Carga credenciales automáticamente
-- ✅ users y products aparecen pre-seleccionados
-- ✅ Puedes agregar/quitar más colecciones
-- ✅ Defaults ya configurados
-
----
-
-## Opción 2: Sin Archivo de Configuración
-
-### Ejecutar directamente
-```bash
-npm run dev -- --service-account firebase_service_account.json
-```
-
-**Resultado:**
-- Te pedirá seleccionar colecciones
-- Te pedirá configurar output
-- Todo manual, más flexible
-
----
-
-## 📋 Flujo Interactivo
-
-```
-🔥 Firestore Dart Generator - Interactive Mode
-
-📄 Found config file: firestore-dart-gen.yaml
-
-✓ Connected to Firebase Project: mi-proyecto
-
-Found 5 collection(s)
-
-Pre-selected from config: users, products
-
-? Select collections: (↑↓ Space Enter)
-❯◉ users         ← Pre-seleccionado
- ◉ products      ← Pre-seleccionado
- ◯ orders
- ◯ reviews
- ◯ settings
-
-🌳 Checking for subcollections...
-
-  Analyzing users...
-  Found 2 subcollection(s): profiles, settings
-  Include subcollections for users? (Y/n) y
-
-? Output directory: ./lib/src/models
-? Sample size: 20
-
-📋 Generation Summary:
-────────────────────────────────────────────
-  Firebase Project: mi-proyecto
-  Collections: users, products
-  Subcollections:
-    └─ users: profiles, settings
-  Output: ./lib/src/models
-  Sample Size: 20 documents per collection
-────────────────────────────────────────────
-
-? Generate Dart models with these settings? (Y/n) y
-
-🚀 Starting generation...
-
-📦 Processing collection: users
-Analyzing schema for users...
-✓ Detected 10 fields
-✓ Generated UserDTO model
-  with 2 nested class(es)
-✓ Written to: lib/src/models/user_dto.dart
-
-📦 Processing subcollection: users/profiles
-...
-
-✨ Success! Generated 4 model(s)
-
-Generated files:
-  ✓ lib/src/models/user_dto.dart
-  ✓ lib/src/models/profile_dto.dart
-  ✓ lib/src/models/setting_dto.dart
-  ✓ lib/src/models/product_dto.dart
-
-📚 Next steps:
-  1. Review the generated files
-  2. Import the models in your Dart code
-  3. Add 'equatable' to your pubspec.yaml
-```
-
----
-
-## ⚙️ Configuración Avanzada
-
-### Pre-seleccionar colecciones específicas
-
-```yaml
-collections:
-  - users
-  - products
-  - orders
-  - reviews
-```
-
-Al ejecutar el CLI, estas 4 aparecerán **pre-seleccionadas con ✓**.
-
-### Cambiar directorio de salida
-
-```yaml
-output:
-  directory: ./packages/core/lib/models
-  sampleSize: 50
-```
-
-### Override con CLI args
-
-```bash
-# Usa prod.json en lugar del del config
-firestore-dart-gen --service-account prod.json
-
-# Usa config custom
-firestore-dart-gen --config my-config.yaml
-```
-
----
-
-## 🎯 Casos de Uso
-
-### Desarrollo diario
-```yaml
-# firestore-dart-gen.yaml
-firebase:
-  serviceAccount: ./dev-credentials.json
-
-collections:
-  - users
-  - products
-
-output:
-  directory: ./lib/src/models
-  sampleSize: 10  # Rápido para desarrollo
-```
-
-```bash
-firestore-dart-gen  # ¡Eso es todo!
-```
-
-### Diferentes ambientes
-
-```bash
-# Desarrollo
-firestore-dart-gen --service-account dev.json
-
-# Staging
-firestore-dart-gen --service-account staging.json
-
-# Producción
-firestore-dart-gen --service-account prod.json
-```
-
-Las colecciones pre-seleccionadas permanecen, solo cambias credenciales.
-
----
-
-## 🔧 Comandos Útiles
-
-```bash
-# Desarrollo con config
-npm run dev
-
-# Desarrollo con service account específico
-npm run dev -- --service-account credentials.json
-
-# Con config custom
-npm run dev -- --config other-config.yaml
-
-# Ver help
-npm run dev -- --help
-
-# Build y ejecutar producción
-npm run build
-npm start
-
-# Ejecutar tests
-npm test
-```
-
----
-
-## 📚 Más Información
-
-- **Guía Completa**: [`CONFIG_FILE_GUIDE.md`](CONFIG_FILE_GUIDE.md)
-- **Archivo Ejemplo**: [`firestore-dart-gen.example.yaml`](firestore-dart-gen.example.yaml)
-- **README Principal**: [`README.md`](README.md)
-- **Testing**: [`TESTING.md`](TESTING.md)
-- **Publicación**: [`PUBLICACION_NPM.md`](PUBLICACION_NPM.md)
-
----
-
-## ✅ Checklist para Empezar
-
-- [ ] Crear `firestore-dart-gen.yaml` desde el ejemplo
-- [ ] Configurar path de service account
-- [ ] Listar colecciones que usas frecuentemente
-- [ ] Ejecutar `npm run dev`
-- [ ] Seleccionar colecciones (pre-seleccionadas por ti)
-- [ ] Revisar modelos generados
-- [ ] ¡Listo para usar en tu app Flutter!
-
----
-
-🎉 **¡Disfruta del nuevo sistema de configuración!**
-