@codemoreira/esad 1.3.3 → 1.3.5

package/README.md

@@ -9,28 +9,30 @@ ESAD is a unified toolkit designed to abstract all the complexity from Super App
 ## 🏗️ CLI Commands
 
 ### 1. Initialize a Workspace
-Clones the official Host Template and sets up a global workspace configuration.
 ```bash
 npx @codemoreira/esad init my-project
 ```
 
 ### 2. Create a Federated Module
-Clones the official Module Template and correctly configures it to join the Super App.
 ```bash
-npx esad create-module module-rh
+npx esad create-module module-name
 ```
 
-### 3. Development Mode
-Starts the local Rspack server and **automatically** prepares native folders (`android/ios`) with necessary Re.Pack patches (Gradle, Entry Points).
+### 3. Create a Local CDN / Registry
 ```bash
-npx esad host dev  # To run the Host
-npx esad dev --id module-rh --port 9000  # To run a Module
+npx esad create-cdn
 ```
 
-### 4. Deployment
-Builds, zips, and uploads the module bundle to the configured CDN registry.
+### 4. Development & Native Automation
+Starts the Rspack server and **automatically patches** native files (Gradle, Entry Points) if necessary.
 ```bash
-npx esad deploy --id module-rh --version 1.0.0
+npx esad host dev  # Run the Host App
+npx esad dev --id module-name --port 9000  # Run a Module
+```
+
+### 5. Deployment
+```bash
+npx esad deploy --id module-name --version 1.0.0
 ```
 
 ---
@@ -38,7 +40,7 @@ npx esad deploy --id module-rh --version 1.0.0
 ## 🛠️ Library Usage
 
 ### 🎨 Bundler Plugin (`@codemoreira/esad/plugin`)
-In your `rspack.config.mjs`, simplify everything:
+Wrap your configuration to enable ESAD's smart resolution and redirection logic:
 ```javascript
 import { withESAD } from '@codemoreira/esad/plugin';
 
@@ -48,30 +50,26 @@ export default withESAD({
 });
 ```
 
-### ⚡ Global State Hook (`@codemoreira/esad/client`)
-Share state across different modules and the Host instantly and reactively:
+### ⚡ Global State SDK (`@codemoreira/esad/client`)
+Share state across the Host and all Remote Modules reactively:
 ```javascript
 import { useESADState } from '@codemoreira/esad/client';
 
-const [token, setToken] = useESADState('auth_token');
+const [user, setUser] = useESADState('user');
 ```
 
 ---
 
 ## 🏠 Template Features (Host & Module)
 
-ESAD now uses a **Template-Based Scaffolding** system. Creating a project via CLI clones:
-- [esad-template-host](https://github.com/CodeMoreira/esad-template-host)
-- [esad-template-module](https://github.com/CodeMoreira/esad-template-module)
-
-**Features included by default:**
-- **🚀 Rspack + Re.Pack**: Blazing fast builds with Module Federation v2.
-- **🎨 NativeWind v4**: Utility-first styling with Tailwind CSS logic.
-- **🔐 Auth System**: Complete `AuthProvider` with `expo-secure-store`.
-- **🛤️ Protected Routes**: Automatic redirection logic.
-- **📦 Module Loader**: Robust dynamic remote loading via ESAD Registry.
+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.
 
 ---
 
 ## 🎨 Architecture & Workflow
-For a detailed view of the system's architecture and development cycles, see [ESAD_ARCHITECTURE.md](./ESAD_ARCHITECTURE.md).
+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.3",
+  "version": "1.3.5",
   "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

@@ -45,7 +45,7 @@ function listAvailableModules(configObj) {
       return name;
     });
 
-  console.log(chalk.yellow('\nMódulos disponíveis:'));
+  console.log(chalk.yellow('\nAvailable modules:'));
   modules.forEach(m => console.log(chalk.blue(`- ${m}`)));
 }
 

package/src/plugin/index.js

@@ -40,9 +40,6 @@ function withESAD(env, options) {
         '@module-federation/error-codes/browser': path.resolve(dirname, 'node_modules/@module-federation/error-codes/dist/browser.cjs'),
         '@module-federation/sdk': path.resolve(dirname, 'node_modules/@module-federation/sdk'),
         
-        // ESAD SDK Aliases (Zero-Config)
-        '@codemoreira/esad/client': path.resolve(dirname, 'node_modules/@codemoreira/esad/src/client/index.js'),
-        
         ...Repack.getResolveOptions().alias,
         ...(options.alias || {}),
       }
@@ -94,6 +91,7 @@ function withESAD(env, options) {
           'react/jsx-runtime': { singleton: true, eager: true, requiredVersion: pkg.dependencies.react },
           'react-native': { singleton: true, eager: true, requiredVersion: pkg.dependencies['react-native'] },
           'react-native-safe-area-context': { singleton: true, eager: true, requiredVersion: pkg.dependencies['react-native-safe-area-context'] },
+          '@codemoreira/esad/client': { singleton: true, eager: true },
           '@codemoreira/esad': { singleton: true, eager: true },
           ...(options.shared || {})
         }