@codemoreira/esad 1.3.2 → 1.3.4

package/README.md

@@ -1,51 +1,48 @@
 # ESAD (Easy Super App Development) 🚀
 
-Zero-Config CLI and DevTools for React Native Module Federation.
+Zero-Config CLI and DevTools for React Native Module Federation + Expo.
 
-ESAD is a unified toolkit designed to abstract all the complexity from Super App development using **Re.Pack (Webpack)** and **React Native**.
+ESAD is a unified toolkit designed to abstract all the complexity from Super App development using **Re.Pack (Rspack)** and **Expo**.
 
 ---
 
-## 🏗️ Commands
+## 🏗️ CLI Commands
 
 ### 1. Initialize a Workspace
-Creates a main project folder with a Host (Expo-ready) and a global configuration.
 ```bash
 npx @codemoreira/esad init my-project
 ```
 
 ### 2. Create a Federated Module
-Scaffolds a new mini-app correctly named and configured to join the Super App.
 ```bash
-npx esad create-module module-rh
+npx esad create-module module-name
 ```
 
-### 3. Create a Service Registry / CDN
-Sets up the backend registry used for dynamic routing and file hosting.
+### 3. Create a Local CDN / Registry
 ```bash
 npx esad create-cdn
 ```
 
-### 4. Development Mode (Real-time HMR)
-Starts the local packager and **automatically** notifies the Registry to bypass the CDN, so your Host App sees your local changes instantly.
+### 4. Development & Native Automation
+Starts the Rspack server and **automatically patches** native files (Gradle, Entry Points) if necessary.
 ```bash
-npx esad dev --id module-rh --port 8081
+npx esad host dev  # Run the Host App
+npx esad dev --id module-name --port 9000  # Run a Module
 ```
 
 ### 5. Deployment
-Builds, zips, and uploads the module bundle to the configured CDN endpoint.
 ```bash
-npx esad deploy --id module-rh --version 1.0.0 --entry index.bundle
+npx esad deploy --id module-name --version 1.0.0
 ```
 
 ---
 
 ## 🛠️ Library Usage
 
-### 🎨 Bundler Plugin (`esad/plugin`)
-In your `rspack.config.mjs`, simplify everything:
+### 🎨 Bundler Plugin (`@codemoreira/esad/plugin`)
+Wrap your configuration to enable ESAD's smart resolution and redirection logic:
 ```javascript
-import { withESAD } from 'esad/plugin';
+import { withESAD } from '@codemoreira/esad/plugin';
 
 export default withESAD({
   type: 'module', // or 'host'
@@ -53,22 +50,26 @@ export default withESAD({
 });
 ```
 
-### ⚡ Global State Hook (`esad/client`)
-Share state across different modules and the Host instantly and reatively:
+### ⚡ Global State SDK (`@codemoreira/esad/client`)
+Share state across the Host and all Remote Modules reactively:
 ```javascript
-import { useESADState } from 'esad/client';
+import { useESADState } from '@codemoreira/esad/client';
 
-const [token, setToken] = useESADState('auth_token');
+const [user, setUser] = useESADState('user');
 ```
 
 ---
 
-## 🏠 Host App Features (by Default)
+## 🏠 Template Features (Host & Module)
 
-When you run `esad init`, the generated Host App comes pre-configured with:
+ESAD provides high-quality, boilerplate-free templates:
+- **🚀 Rspack + Re.Pack**: Blazing fast builds powered by Rspack.
+- **📱 Clean UI**: Modern, responsive designs built with **Vanilla StyleSheet** (No external CSS libraries required).
+- **🛤️ Dynamic Navigation**: Pre-configured Dashboard and Module Viewer with **Suspense** support.
+- **🔐 State-Driven Auth**: Built-in login and session management via the ESAD SDK.
+- **🔧 Automated Patching**: CLI-driven injection of Re.Pack extensions into Android and iOS native projects.
 
-- **🎨 NativeWind v4**: Utility-first styling ready to use with Tailwind CSS logic.
-- **🔐 Auth System**: Complete `AuthProvider` with persistent token storage using `expo-secure-store`.
-- **🛤️ Protected Routes**: Automatic redirection between `login` and `(protected)` groups based on auth state.
-- **📦 Module Loader**: A robust `lib/moduleLoader.ts` to fetch and initialize federated modules dynamically.
-- **📱 Premium UI**: A clean, modern starting point for your Super App dashboard.
+---
+
+## 🎨 Architecture & Workflow
+For technical diagrams and the modular deployment lifecycle, see [ESAD_ARCHITECTURE.md](./ESAD_ARCHITECTURE.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemoreira/esad",
-  "version": "1.3.2",
+  "version": "1.3.4",
   "description": "Easy Super App Development - Zero-Config CLI and DevTools for React Native Module Federation",
   "main": "src/plugin/index.js",
   "types": "./src/plugin/index.d.ts",

package/src/cli/commands/deploy.js

@@ -12,7 +12,7 @@ module.exports = async (options) => {
   // Enforce Workspace Root
   const configObj = getWorkspaceConfig();
   if (!configObj) {
-    console.error(chalk.red(`❌ Erro: Comando deve ser executado na raiz do projeto (esad.config.json não encontrado).`));
+    console.error(chalk.red(`❌ Error: Call this command from the project root (esad.config.json not found).`));
     process.exit(1);
   }
 
@@ -22,25 +22,25 @@ module.exports = async (options) => {
   if (options.id) {
     const targetDir = resolveProjectDir(options.id, configObj);
     if (!targetDir) {
-      console.error(chalk.red(`\n❌ Erro: Não foi encontrado o módulo: ${options.id}`));
+      console.error(chalk.red(`\n❌ Error: Module not found: ${options.id}`));
       listAvailableModules(configObj);
       process.exit(1);
     }
     cwd = targetDir;
     pkgPath = path.join(cwd, 'package.json');
-    console.log(chalk.green(`📂 Módulo detectado para Deploy: ${path.relative(workspaceRoot, cwd)}`));
+    console.log(chalk.green(`📂 Module detected for Deploy: ${path.relative(workspaceRoot, cwd)}`));
   } else {
     // Target host by default if in root
     const hostDir = path.join(workspaceRoot, `${projectName}-host`);
     if (fs.existsSync(hostDir)) {
       cwd = hostDir;
       pkgPath = path.join(cwd, 'package.json');
-      console.log(chalk.green(`📂 Host detectado para Deploy: ${path.relative(workspaceRoot, cwd)}`));
+      console.log(chalk.green(`📂 Host detected for Deploy: ${path.relative(workspaceRoot, cwd)}`));
     }
   }
 
   if (!fs.existsSync(pkgPath)) {
-    console.error(chalk.red(`❌ Erro: Arquivo package.json não encontrado em ${cwd}.`));
+    console.error(chalk.red(`❌ Error: package.json not found in ${cwd}.`));
     process.exit(1);
   }
 

package/src/cli/commands/dev.js

@@ -13,7 +13,7 @@ module.exports = async (options) => {
   // Enforce Workspace Root
   const configObj = getWorkspaceConfig();
   if (!configObj) {
-    console.error(chalk.red(`❌ Erro: Comando deve ser executado na raiz do projeto (esad.config.json não encontrado).`));
+    console.error(chalk.red(`❌ Error: Call this command from the project root (esad.config.json not found).`));
     process.exit(1);
   }
 
@@ -23,20 +23,20 @@ module.exports = async (options) => {
   if (options.id) {
     const targetDir = resolveProjectDir(options.id, configObj);
     if (!targetDir) {
-      console.error(chalk.red(`\n❌ Erro: Não foi encontrado o módulo: ${options.id}`));
+      console.error(chalk.red(`\n❌ Error: Module not found: ${options.id}`));
       listAvailableModules(configObj);
       process.exit(1);
     }
     cwd = targetDir;
     pkgPath = path.join(cwd, 'package.json');
-    console.log(chalk.green(`📂 Módulo detectado: ${path.relative(workspaceRoot, cwd)}`));
+    console.log(chalk.green(`📂 Module detected: ${path.relative(workspaceRoot, cwd)}`));
   } else {
     // Target host by default if in root
     const hostDir = path.join(workspaceRoot, `${projectName}-host`);
     if (fs.existsSync(hostDir)) {
       cwd = hostDir;
       pkgPath = path.join(cwd, 'package.json');
-      console.log(chalk.green(`📂 Host detectado: ${path.relative(workspaceRoot, cwd)}`));
+      console.log(chalk.green(`📂 Host detected: ${path.relative(workspaceRoot, cwd)}`));
     }
   }
 
@@ -69,7 +69,7 @@ module.exports = async (options) => {
         ...(isActive && { dev_url: `http://localhost:${port}/index.bundle` }) 
       };
       const res = await fetch(devApiUrl, { method: 'PUT', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify(body) });
-      if (res.ok) console.log(`📡 Registry Sync: Dev Override is ${isActive ? 'ON' : 'OFF'} para o modulo ${moduleId}`);
+      if (res.ok) console.log(`📡 Registry Sync: Dev Override is ${isActive ? 'ON' : 'OFF'} for module ${moduleId}`);
     } catch(e) { /* ignore */ }
   };
 
@@ -78,7 +78,7 @@ module.exports = async (options) => {
   const proc = spawn('npx', ['react-native', 'webpack-start', '--port', port], { cwd, stdio: 'inherit', shell: true });
 
   const shutdown = async () => {
-    console.log(`\n🛑 Parando ESAD Dev Server e revertendo o registro na CDN...`);
+    console.log(`\n🛑 Stopping ESAD Dev Server and reverting registry status...`);
     await setDevMode(false);
     proc.kill();
     process.exit(0);

package/src/cli/commands/host.js

@@ -14,6 +14,19 @@ const rl = readline.createInterface({
 
 const askQuestion = (query) => new Promise((resolve) => rl.question(query, resolve));
 
+/**
+ * Check if a port is in use
+ */
+const isPortInUse = (port) => new Promise((resolve) => {
+  const req = http.get(`http://localhost:${port}`, (res) => {
+    resolve(true); // Responded, so it's in use
+  });
+  req.on('error', () => {
+    resolve(false); // Refused, so it's free
+  });
+  req.end();
+});
+
 module.exports = async (subcommand) => {
   let cwd = process.cwd();
   let pkgPath = path.join(cwd, 'package.json');
@@ -59,60 +72,66 @@ module.exports = async (subcommand) => {
       return;
     }
 
-    // 4. Start Bundler in a New Window
-    console.log(`\n🛠️ Starting Rspack Bundler in a new window...`);
-    if (process.platform === 'win32') {
-      // Use CMD /C START /D <dir> to open a new window in the correct folder
-      spawn('cmd', ['/c', 'start', '/D', cwd, 'npx', 'react-native', 'webpack-start'], { 
-        detached: true, 
-        stdio: 'ignore',
-        shell: true 
-      }).unref();
-    } else {
-      // For MacOS or Linux
-      spawn('npx', ['react-native', 'webpack-start'], { 
-        cwd, 
-        detached: true, 
-        stdio: 'inherit', 
-        shell: true 
-      }).unref();
+    // 4. Check for Port 8081
+    const portBusy = await isPortInUse(8081);
+    let shouldStartBundler = true;
+
+    if (portBusy) {
+      console.log(`\n⚠️  Warning: Port 8081 is already in use by another process.`);
+      console.log(`💡 Skipping Bundler startup - assuming it's already running. Proceeding with Native Build only.\n`);
+      shouldStartBundler = false;
     }
 
-    // 5. Wait for Bundler (Port 8081)
-    console.log(`⏳ Waiting for Rspack Bundler to initialize on port 8081...`);
-    const waitForBundler = async () => {
-      for (let i = 0; i < 30; i++) {
-        try {
-          await new Promise((resolve, reject) => {
-            const req = http.get('http://localhost:8081', (res) => resolve(res));
-            req.on('error', reject);
-            req.end();
-          });
-          return true;
-        } catch (e) {
+    // 4. Start Bundler in a New Window (if needed)
+    if (shouldStartBundler && choice !== 'c') {
+      console.log(`\n🛠️ Starting Rspack Bundler in a new window...`);
+      if (process.platform === 'win32') {
+        spawn('cmd', ['/c', 'start', '/D', cwd, 'npx', 'react-native', 'webpack-start'], { 
+          detached: true, 
+          stdio: 'ignore',
+          shell: true 
+        }).unref();
+      } else {
+        spawn('npx', ['react-native', 'webpack-start'], { 
+          cwd, 
+          detached: true, 
+          stdio: 'inherit', 
+          shell: true 
+        }).unref();
+      }
+
+      // 5. Wait for Bundler (Port 8081)
+      console.log(`⏳ Waiting for Rspack Bundler to initialize on port 8081...`);
+      const waitForBundler = async () => {
+        for (let i = 0; i < 30; i++) {
+          if (await isPortInUse(8081)) return true;
           await new Promise(r => setTimeout(r, 2000));
         }
-      }
-      return false;
-    };
+        return false;
+      };
 
-    const isReady = await waitForBundler();
-    if (!isReady) {
-      console.error(`\n❌ Timeout: Bundler did not respond after 60 seconds.`);
-      rl.close();
-      return;
+      const isReady = await waitForBundler();
+      if (!isReady) {
+        console.error(`\n❌ Timeout: Bundler did not respond after 60 seconds.`);
+        rl.close();
+        return;
+      }
+      console.log(`✅ Bundler stable and ready to use!`);
     }
-    console.log(`✅ Bundler stable and ready to use!`);
 
     // 6. Launch Native App
     if (choice === 'a') {
-      console.log(`🤖 Compiling and sending to Android...`);
+      console.log(`🤖 Compiling and launching on Android...`);
       await runProcess('npx', ['expo', 'run:android', '--no-bundler'], cwd);
     } else if (choice === 'i') {
-      console.log(`🍎 Compiling and sending to iOS...`);
+      console.log(`🍎 Compiling and launching on iOS...`);
       await runProcess('npx', ['expo', 'run:ios', '--no-bundler'], cwd);
     } else if (choice === 'b') {
-      console.log(`✨ Bundler is running. You can open the app manually.`);
+      if (portBusy) {
+        console.log(`✨ Bundler is already active. You can launch manual native runs.`);
+      } else {
+        console.log(`✨ Bundler is running. You can open the app manually.`);
+      }
     }
 
     rl.close();

package/src/cli/utils/resolution.js

@@ -39,13 +39,13 @@ function listAvailableModules(configObj) {
   
   const entries = fs.readdirSync(workspaceRoot, { withFileTypes: true });
   const modules = entries
-    .filter(e => e.isDirectory() && e.name.startsWith(projectName))
+    .filter(e => e.isDirectory() && e.name.startsWith(projectName) && !e.name.endsWith('-host') && !e.name.endsWith('-cdn'))
     .map(e => {
       const name = e.name.replace(`${projectName}-`, '');
       return name;
     });
 
-  console.log(chalk.yellow('\nMódulos disponíveis:'));
+  console.log(chalk.yellow('\nAvailable modules:'));
   modules.forEach(m => console.log(chalk.blue(`- ${m}`)));
 }