@codemoreira/esad 1.3.1 → 1.3.3

package/README.md

@@ -1,51 +1,46 @@
 # 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.
+Clones the official Host Template and sets up a global workspace 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.
+Clones the official Module Template and correctly configures it to join the Super App.
 ```bash
 npx esad create-module module-rh
 ```
 
-### 3. Create a Service Registry / CDN
-Sets up the backend registry used for dynamic routing and file hosting.
+### 3. Development Mode
+Starts the local Rspack server and **automatically** prepares native folders (`android/ios`) with necessary Re.Pack patches (Gradle, Entry Points).
 ```bash
-npx esad create-cdn
+npx esad host dev  # To run the Host
+npx esad dev --id module-rh --port 9000  # To run a Module
 ```
 
-### 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. Deployment
+Builds, zips, and uploads the module bundle to the configured CDN registry.
 ```bash
-npx esad dev --id module-rh --port 8081
-```
-
-### 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-rh --version 1.0.0
 ```
 
 ---
 
 ## 🛠️ Library Usage
 
-### 🎨 Bundler Plugin (`esad/plugin`)
+### 🎨 Bundler Plugin (`@codemoreira/esad/plugin`)
 In your `rspack.config.mjs`, simplify everything:
 ```javascript
-import { withESAD } from 'esad/plugin';
+import { withESAD } from '@codemoreira/esad/plugin';
 
 export default withESAD({
   type: 'module', // or 'host'
@@ -53,22 +48,30 @@ export default withESAD({
 });
 ```
 
-### ⚡ Global State Hook (`esad/client`)
-Share state across different modules and the Host instantly and reatively:
+### ⚡ Global State Hook (`@codemoreira/esad/client`)
+Share state across different modules and the Host instantly and reactively:
 ```javascript
-import { useESADState } from 'esad/client';
+import { useESADState } from '@codemoreira/esad/client';
 
 const [token, setToken] = useESADState('auth_token');
 ```
 
 ---
 
-## 🏠 Host App Features (by Default)
+## 🏠 Template Features (Host & Module)
 
-When you run `esad init`, the generated Host App comes pre-configured with:
+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.
+
+---
 
-- **🎨 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 a detailed view of the system's architecture and development cycles, see [ESAD_ARCHITECTURE.md](./ESAD_ARCHITECTURE.md).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemoreira/esad",
-  "version": "1.3.1",
+  "version": "1.3.3",
   "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

@@ -1,39 +1,46 @@
 const fs = require('fs-extra');
 const path = require('path');
 const AdmZip = require('adm-zip');
+const chalk = require('chalk');
 const { getWorkspaceConfig } = require('../utils/config');
+const { resolveProjectDir, listAvailableModules } = require('../utils/resolution');
 
 module.exports = async (options) => {
   let cwd = process.cwd();
   let pkgPath = path.join(cwd, 'package.json');
   
-  // Try to find workspace config for root-level execution
+  // Enforce Workspace Root
   const configObj = getWorkspaceConfig();
-  if (configObj) {
-    const workspaceRoot = path.dirname(configObj.path);
-    const { projectName } = configObj.data;
-    
-    // If ID is provided, try to find that module/host folder
-    if (options.id) {
-       const targetDir = path.join(workspaceRoot, options.id);
-       if (fs.existsSync(targetDir)) {
-         cwd = targetDir;
-         pkgPath = path.join(cwd, 'package.json');
-         console.log(`📂 Auto-detected Project folder: ${path.relative(process.cwd(), targetDir)}`);
-       }
-    } else if (!fs.existsSync(pkgPath)) {
-       // If no ID and no package.json in current dir, assume we want to deploy the host from root
-       const hostDir = path.join(workspaceRoot, `${projectName}-host`);
-       if (fs.existsSync(hostDir)) {
-          cwd = hostDir;
-          pkgPath = path.join(cwd, 'package.json');
-          console.log(`📂 Auto-detected Host App folder: ${path.relative(process.cwd(), hostDir)}`);
-       }
+  if (!configObj) {
+    console.error(chalk.red(`❌ Erro: Comando deve ser executado na raiz do projeto (esad.config.json não encontrado).`));
+    process.exit(1);
+  }
+
+  const workspaceRoot = path.dirname(configObj.path);
+  const { projectName } = configObj.data;
+  
+  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}`));
+      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)}`));
+  } 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)}`));
     }
   }
 
   if (!fs.existsSync(pkgPath)) {
-    console.error(`❌ Error: Call this command from inside a Project directory or the Workspace Root.`);
+    console.error(chalk.red(`❌ Erro: Arquivo package.json não encontrado em ${cwd}.`));
     process.exit(1);
   }
 

package/src/cli/commands/dev.js

@@ -2,34 +2,41 @@ const { spawn } = require('cross-spawn');
 const { getWorkspaceConfig } = require('../utils/config');
 const fs = require('fs-extra');
 const path = require('path');
+const chalk = require('chalk');
 const { prepareNative } = require('../utils/scaffold');
+const { resolveProjectDir, listAvailableModules } = require('../utils/resolution');
 
 module.exports = async (options) => {
   let cwd = process.cwd();
   let pkgPath = path.join(cwd, 'package.json');
   
-  // Try to find workspace config for root-level execution
+  // Enforce Workspace Root
   const configObj = getWorkspaceConfig();
-  if (configObj) {
-    const workspaceRoot = path.dirname(configObj.path);
-    const { projectName } = configObj.data;
-    
-    if (options.id) {
-       // Target a specific module
-       const moduleDir = path.join(workspaceRoot, options.id);
-       if (fs.existsSync(moduleDir)) {
-         cwd = moduleDir;
-         pkgPath = path.join(cwd, 'package.json');
-         console.log(`📂 Auto-detected Module folder: ${path.relative(process.cwd(), moduleDir)}`);
-       }
-    } 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(`📂 Auto-detected Host App folder: ${path.relative(process.cwd(), hostDir)}`);
-       }
+  if (!configObj) {
+    console.error(chalk.red(`❌ Erro: Comando deve ser executado na raiz do projeto (esad.config.json não encontrado).`));
+    process.exit(1);
+  }
+
+  const workspaceRoot = path.dirname(configObj.path);
+  const { projectName } = configObj.data;
+  
+  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}`));
+      listAvailableModules(configObj);
+      process.exit(1);
+    }
+    cwd = targetDir;
+    pkgPath = path.join(cwd, 'package.json');
+    console.log(chalk.green(`📂 Módulo detectado: ${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)}`));
     }
   }
 

package/src/cli/utils/resolution.js

@@ -0,0 +1,55 @@
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+
+/**
+ * Resolves a project directory from a given ID, with support for prefixed names and auto-detection.
+ * @param {string} id The provided project ID
+ * @param {Object} configObj The workspace configuration object
+ * @returns {string|null} The absolute path to the project directory, or null if not found.
+ */
+function resolveProjectDir(id, configObj) {
+  if (!configObj) return null;
+  
+  const workspaceRoot = path.dirname(configObj.path);
+  const { projectName } = configObj.data;
+
+  // 1. Try exact match
+  let targetDir = path.join(workspaceRoot, id);
+  if (fs.existsSync(targetDir) && fs.statSync(targetDir).isDirectory()) {
+    return targetDir;
+  }
+
+  // 2. Try prefixed match (e.g., my-app-module-name)
+  targetDir = path.join(workspaceRoot, `${projectName}-${id}`);
+  if (fs.existsSync(targetDir) && fs.statSync(targetDir).isDirectory()) {
+    return targetDir;
+  }
+
+  return null;
+}
+
+/**
+ * Lists all available modules in the workspace, stripping the project prefix.
+ * @param {Object} configObj 
+ */
+function listAvailableModules(configObj) {
+  const workspaceRoot = path.dirname(configObj.path);
+  const { projectName } = configObj.data;
+  
+  const entries = fs.readdirSync(workspaceRoot, { withFileTypes: true });
+  const modules = entries
+    .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:'));
+  modules.forEach(m => console.log(chalk.blue(`- ${m}`)));
+}
+
+module.exports = {
+  resolveProjectDir,
+  listAvailableModules
+};