@codemoreira/esad 1.4.6-9 → 2.0.0-rc.1

package/README.md

@@ -1,96 +1,82 @@
-# ESAD (Easy Super App Development) 🚀
-
-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 (Rspack)** and **Expo**.
-
----
-
-## 🏗️ CLI Commands
-
-### 1. Initialize a Workspace
-```bash
-npx @codemoreira/esad init my-project
-```
-
-### 2. Create a Federated Module
-```bash
-npx esad create-module module-name
-```
-
-### 3. Create a Local CDN / Registry
-```bash
-npx esad create-cdn
-```
-
-### 4. Development & Cloud-Sync
-Starts the Rspack server locally OR performs a **Dev-Cloud Sync** for remote preview.
-```bash
-npx esad dev --id module-name  # Builds and pushes bundle to Dev Cloud
-```
-
-### 5. Host Automation
-Manages the Host App and automatically synchronizes project-wide configurations (Auto-Sync).
-```bash
-npx esad host android  # Run Host on Android
-```
-
-### 5. Build for Production
-Prepares the bundle and chunks for deployment, generating a standardized `./build` directory.
-```bash
-npx esad build --id module-name --platform android
-```
-
-### 6. Deployment
-Packages the `./build` folder and uploads it to your configured Registry/CDN via multipart POST.
-```bash
-npx esad deploy --id module-name --version 1.0.0
-```
-
----
-
-## 🛠️ Library Usage
-
-### 🎨 Bundler Plugin (`@codemoreira/esad/plugin`)
-Wrap your configuration to enable ESAD's smart resolution and redirection logic:
-```javascript
-import { withESAD } from '@codemoreira/esad/plugin';
-
-export default withESAD({
-  type: 'module', // or 'host'
-  id: 'my-mini-app'
-});
-```
-
-### ⚡ Global State SDK (`@codemoreira/esad/client`)
-Share state across the Host and all Remote Modules reactively via a **Universal Singleton**:
-```javascript
-import { useESADState } from '@codemoreira/esad/client';
-
-const [user, setUser] = useESADState('user');
-```
-
----
-
-## ⚙️ Configuration (`esad.config.json`)
-
-ESAD supports a "Zero-Config" but powerful orchestration file at the root:
-- `projectName`: Your SuperApp identifier.
-- `devModeFor`: Array of **shorthand** module names (e.g. `["recebimento"]`) to load from the Dev Cloud instead of Production.
-- **Auto-Sync**: CLI commands (`dev`, `build`, `deploy`) automatically propagate this config to the Host App.
-
----
-
-## 🏠 Template Features (Host & Module)
-
-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 technical diagrams and the modular deployment lifecycle, see [ESAD_ARCHITECTURE.md](./ESAD_ARCHITECTURE.md).
+# ESAD (Easy Super App Development) 🚀
+
+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 (Rspack)** and **Expo**.
+
+---
+
+## 🏗️ CLI Commands
+
+### 1. Initialize a Workspace
+```bash
+npx @codemoreira/esad init my-project
+```
+
+### 2. Create a Federated Module
+```bash
+npx esad create-module module-name
+```
+
+### 3. Create a Local CDN / Registry
+```bash
+npx esad create-cdn
+```
+
+### 4. Development & Native Automation
+Starts the Rspack server and **automatically patches** native files (Gradle, Entry Points) if necessary.
+```bash
+npx esad host dev  # Run the Host App
+npx esad dev --id module-name --port 9000  # Run a Module
+```
+
+### 5. Build for Production
+Prepares the bundle and chunks for deployment, generating a standardized `./build` directory.
+```bash
+npx esad build --id module-name --platform android
+```
+
+### 6. Deployment
+Packages the `./build` folder and uploads it to your configured Registry/CDN via multipart POST.
+```bash
+npx esad deploy --id module-name --version 1.0.0
+```
+
+---
+
+## 🛠️ Library Usage
+
+### 🎨 Bundler Plugin (`@codemoreira/esad/plugin`)
+Wrap your configuration to enable ESAD's smart resolution and redirection logic:
+```javascript
+import { withESAD } from '@codemoreira/esad/plugin';
+
+export default withESAD({
+  type: 'module', // or 'host'
+  id: 'my-mini-app'
+});
+```
+
+### ⚡ Global State SDK (`@codemoreira/esad/client`)
+Share state across the Host and all Remote Modules reactively:
+```javascript
+import { useESADState } from '@codemoreira/esad/client';
+
+const [user, setUser] = useESADState('user');
+```
+
+---
+
+## 🏠 Template Features (Host & Module)
+
+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 technical diagrams and the modular deployment lifecycle, see [ESAD_ARCHITECTURE.md](./ESAD_ARCHITECTURE.md).

package/bin/esad.js

@@ -1,115 +1,89 @@
 #!/usr/bin/env node
-
-const { program } = require('commander');
-const pkg = require('../package.json');
-
-// Import Commands
-const initCommand = require('../src/cli/commands/init');
-const createModuleCommand = require('../src/cli/commands/createModule');
-const createCdnCommand = require('../src/cli/commands/createCdn');
-const deployCommand = require('../src/cli/commands/deploy');
-const devCommand = require('../src/cli/commands/dev');
-const hostCommand = require('../src/cli/commands/host');
-const buildCommand = require('../src/cli/commands/build');
-
-program
-  .version(pkg.version)
-  .description('esad - Easy Super App Development Toolkit');
-
-// --- COMMAND: esad init ---
-program
-  .command('init <project-name>')
-  .description('Scaffold a new ESAD workspace containing the Host App')
-  .action(async (name) => {
-     await initCommand(name);
-     process.exit(0);
-  });
-
-// --- COMMAND: esad create-cdn ---
-program
-  .command('create-cdn')
-  .description('Scaffold the CDN backend (always named {{projectName}}-cdn)')
-  .action(async (name) => {
-     await createCdnCommand(name);
-     process.exit(0);
-  });
-
-// --- COMMAND: esad dev ---
-program
-  .command('dev [platform]')
-  .description('Start the development environment for the Host App (platform: android, ios)')
-  .action(async (platform) => {
-     await hostCommand(platform);
-     process.exit(0);
-  });
-
-// --- COMMAND: esad android ---
-program
-  .command('android')
-  .description('Run Host on Android (alias for esad dev android)')
-  .action(async () => {
-     await hostCommand('android');
-     process.exit(0);
-  });
-
-// --- COMMAND: esad ios ---
-program
-  .command('ios')
-  .description('Run Host on iOS (alias for esad dev ios)')
-  .action(async () => {
-     await hostCommand('ios');
-     process.exit(0);
-  });
-
-// --- COMMAND: esad start ---
-program
-  .command('start')
-  .description('Alias for esad dev')
-  .action(async () => {
-     await hostCommand('dev');
-     process.exit(0);
-  });
-
-// --- COMMAND: esad push ---
-program
-  .command('push')
-  .option('-i, --id <moduleId>', 'The Module ID to sync to Dev-Cloud')
-  .option('-p, --platform <platform>', 'Platform (android, ios)', 'android')
-  .description('Build and Push the module bundle to the Dev-Cloud for global previewing')
-  .action(async (options) => {
-     await devCommand(options);
-  });
-
-// --- COMMAND: esad create-module ---
-program
-  .command('create-module <module-name>')
-  .description('Scaffold a React Native mini-app automatically configured for Module Federation via ESAD')
-  .action(async (name) => {
-     await createModuleCommand(name);
-     process.exit(0);
-  });
-
-// --- COMMAND: esad build ---
-program
-  .command('build')
-  .option('-i, --id <moduleId>', 'The Module ID to build')
-  .option('-p, --platform <platform>', 'Platform to build for (android, ios)', 'android')
-  .description('Builds a production bundle for the host or a specific module')
-  .action(async (options) => {
-     await buildCommand(options);
-     process.exit(0);
-  });
-
-// --- COMMAND: esad deploy ---
-program
-  .command('deploy')
-  .option('-v, --version <semver>', 'Version number (e.g., 1.0.0)')
-  .option('-i, --id <moduleId>', 'The Module ID to deploy')
-  .option('-e, --entry <entryFileName>', 'The name of the main entry bundle (e.g., index.bundle)', 'index.bundle')
-  .description('Zips the local dist directory and uploads it to the configured deployment endpoint')
-  .action(async (options) => {
-     await deployCommand(options);
-     process.exit(0);
-  });
-
-program.parse(process.argv);
+
+const { program } = require('commander');
+const pkg = require('../package.json');
+
+// Import Commands
+const initCommand = require('../src/cli/commands/init');
+const createModuleCommand = require('../src/cli/commands/createModule');
+const createCdnCommand = require('../src/cli/commands/createCdn');
+const deployCommand = require('../src/cli/commands/deploy');
+const devCommand = require('../src/cli/commands/dev');
+const hostCommand = require('../src/cli/commands/host');
+const buildCommand = require('../src/cli/commands/build');
+
+program
+  .version(pkg.version)
+  .description('esad - Easy Super App Development Toolkit');
+
+// --- COMMMAND: esad init ---
+program
+  .command('init <project-name>')
+  .description('Scaffold a new ESAD workspace containing the Host App')
+  .action(async (name) => {
+     await initCommand(name);
+     process.exit(0);
+  });
+
+// --- COMMAND: esad create-cdn ---
+program
+  .command('create-cdn [cdn-name]')
+  .description('Scaffold the CDN / Registry backend')
+  .action(async (name) => {
+     await createCdnCommand(name);
+     process.exit(0);
+  });
+
+// --- COMMAND: esad host ---
+program
+  .command('host <subcommand>')
+  .description('Manage the Host App (dev, android, ios)')
+  .action(async (sub) => {
+     await hostCommand(sub);
+     process.exit(0);
+  });
+
+// --- COMMAND: esad create-module ---
+program
+  .command('create-module <module-name>')
+  .description('Scaffold a React Native mini-app automatically configured for Module Federation via ESAD')
+  .action(async (name) => {
+     await createModuleCommand(name);
+     process.exit(0);
+  });
+
+// --- COMMAND: esad build ---
+program
+  .command('build')
+  .option('-i, --id <moduleId>', 'The Module ID to build')
+  .option('-p, --platform <platform>', 'Platform to build for (android, ios)', 'android')
+  .description('Builds a production bundle for the host or a specific module')
+  .action(async (options) => {
+     await buildCommand(options);
+     process.exit(0);
+  });
+
+// --- COMMAND: esad deploy ---
+program
+  .command('deploy')
+  .option('-v, --version <semver>', 'Version number (e.g., 1.0.0)')
+  .option('-i, --id <moduleId>', 'The Module ID to deploy')
+  .option('-e, --entry <entryFileName>', 'The name of the main entry bundle (e.g., index.bundle)', 'index.bundle')
+  .description('Zips the local dist directory and uploads it to the configured deployment endpoint')
+  .action(async (options) => {
+     await deployCommand(options);
+     process.exit(0);
+  });
+
+// --- COMMAND: esad dev ---
+program
+  .command('dev')
+  .option('-i, --id <moduleId>', 'The Module ID to run in dev mode')
+  .option('-p, --port <port>', 'The port to run the dev server on', '8081')
+  .description('Starts the dev server and updates the external registry to bypass CDN')
+  .action(async (options) => {
+     await devCommand(options);
+     // Note: dev command has its own shutdown logic with SIGINT/SIGTERM
+  });
+
+program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemoreira/esad",
-  "version": "1.4.6-9",
+  "version": "2.0.0-rc.1",
   "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",
@@ -16,8 +16,7 @@
     "./client": {
       "types": "./src/client/index.d.ts",
       "default": "./src/client/index.js"
-    },
-    "./config-plugin": "./src/plugin/config-plugin.js"
+    }
   },
   "bin": {
     "esad": "./bin/esad.js"
@@ -30,28 +29,29 @@
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"
   },
+  "overrides": {
+    "axios": "1.15.0",
+    "@xmldom/xmldom": "0.9.9"
+  },
   "dependencies": {
+    "@babel/core": "^7.20.0",
     "@callstack/repack": "^5.2.5",
     "@callstack/repack-plugin-expo-modules": "^5.2.5",
     "@callstack/repack-plugin-reanimated": "^5.2.5",
-    "@module-federation/enhanced": "^2.2.3",
+    "@module-federation/enhanced": "^2.3.1",
     "@rspack/core": "^1.7.8",
+    "@swc/core": "^1.7.0",
+    "@swc/helpers": "^0.5.11",
     "adm-zip": "^0.5.10",
+    "babel-loader": "^9.1.3",
+    "babel-preset-expo": "~12.0.0",
     "chalk": "^4.1.2",
     "commander": "^11.1.0",
     "cross-spawn": "^7.0.3",
-    "@babel/core": "^7.20.0",
-    "babel-loader": "^9.1.3",
-    "babel-preset-expo": "~12.0.0",
-    "expo": "~52.0.0",
-    "react-native-reanimated": "~3.16.1",
     "form-data": "^4.0.0",
     "fs-extra": "^11.2.0",
     "node-fetch": "^2.7.0",
-    "@babel/plugin-transform-flow-strip-types": "^7.20.0",
-    "@babel/plugin-transform-private-methods": "^7.20.0",
-    "@babel/plugin-transform-private-property-in-object": "^7.20.0",
-    "@babel/plugin-transform-class-properties": "^7.20.0"
+    "process": "^0.11.10"
   },
   "devDependencies": {
     "@rspack/core": "^1.7.9",

package/src/cli/commands/build.js

@@ -2,47 +2,42 @@ const { runProcess } = require('../utils/process');
 const path = require('path');
 const fs = require('fs-extra');
 const chalk = require('chalk');
-const { getWorkspaceConfig, syncHostConfig } = require('../utils/config');
-const { resolveProjectDir, listAvailableModules } = require('../utils/resolution');
-const { prepareNative } = require('../utils/scaffold');
+const { getWorkspaceConfig } = require('../utils/config');
+const { resolveProjectDir } = require('../utils/resolution');
+const { clearAllDevMode } = require('../utils/transformer');
 
 module.exports = async (options) => {
-  let cwd = process.cwd();
-  
-  // Enforce Workspace Root
   const configObj = getWorkspaceConfig();
   if (!configObj) {
-    console.error(chalk.red(`❌ Error: Call this command from the project root (esad.config.json not found).`));
+    console.error(chalk.red(`❌ Error: esad.config.js not found.`));
     process.exit(1);
   }
 
-  syncHostConfig(configObj);
-
-  const { projectName } = configObj.data;
+  const config = await configObj.load();
+  const workspaceRoot = configObj.root;
+  const projectName = config.default?.projectName || config.projectName;
+  
+  let cwd = process.cwd();
   
   if (options.id) {
     const targetDir = resolveProjectDir(options.id, configObj);
     if (!targetDir) {
-      console.error(chalk.red(`\n❌ Error: Module not found: ${options.id}`));
-      listAvailableModules(configObj);
+      console.error(chalk.red(`❌ Error: Module not found: ${options.id}`));
       process.exit(1);
     }
     cwd = targetDir;
-  } else {
-    // Build host by default if in root
-    const hostDir = path.join(path.dirname(configObj.path), `${projectName}-host`);
-    if (fs.existsSync(hostDir)) cwd = hostDir;
   }
 
   const platform = options.platform || 'android';
   
-  // Prepare Native Folders
-  await prepareNative(cwd, platform);
-
-  console.log(`\n🏗️  Building production bundle for ${path.basename(cwd)} (${platform})...\n`);
+  console.log(`\n🏗️  Building production bundle for ${chalk.cyan(path.basename(cwd))} (${platform})...\n`);
   
+  // 1. CLEANUP CONFIG (Avoid shipping local dev URLs)
+  console.log(chalk.gray(`🧹 Cleaning up devMode mappings in esad.config.js...`));
+  clearAllDevMode(configObj.path);
+
   try {
-    const bundleOutput = path.join(cwd, 'build', platform, 'index.bundle');
+    const bundleOutput = path.join(cwd, 'build', 'index.bundle'); // Simplified path as per V2
     fs.ensureDirSync(path.dirname(bundleOutput));
 
     // Run Re.Pack production build
@@ -52,14 +47,14 @@ module.exports = async (options) => {
       '--platform', platform, 
       '--dev', 'false',
       '--bundle-output', bundleOutput,
-      '--assets-dest', path.dirname(bundleOutput),
-      '--reset-cache'
-    ], cwd);
+      '--assets-dest', path.dirname(bundleOutput)
+    ], { cwd });
     
     console.log(chalk.green(`\n✅ Build complete! Assets generated in build/ directory.`));
-    console.log(`👉 You can now run: esad deploy ${options.id ? `--id ${options.id}` : ''}\n`);
+    console.log(`👉 Next step: 'esad deploy ${options.id || ''}'\n`);
   } catch (err) {
     console.error(chalk.red(`\n❌ Build failed: ${err.message}`));
     process.exit(1);
   }
 };
+

package/src/cli/commands/createCdn.js

@@ -1,45 +1,44 @@
-const { runProcess } = require('../utils/process');
-const { getWorkspaceConfig } = require('../utils/config');
-const fs = require('fs-extra');
-const path = require('path');
-
-module.exports = async (cdnName) => {
-  const configObj = getWorkspaceConfig();
-  if (!configObj) {
-    console.error(`❌ Error: Call this command from inside an ESAD workspace (esad.config.json not found).`);
-    return;
-  }
-
-  const { projectName } = configObj.data;
-  const finalCdnName = `${projectName}-cdn`;
-  const cdnPath = path.join(process.cwd(), finalCdnName);
-
-  if (fs.existsSync(cdnPath)) {
-    console.error(`❌ Error: Directory ./${finalCdnName} already exists.`);
-    return;
-  }
-
-  console.log(`\n📦 Initializing Flux Registry & CDN: ${finalCdnName}...\n`);
-
-  try {
-    // 1. Clone the template
-    console.log(`📡 Cloning template from GitHub...`);
-    await runProcess('git', ['clone', 'https://github.com/CodeMoreira/simple-cdn.git', finalCdnName]);
-
-    // 2. Remove .git from template
-    console.log(`🧹 Cleaning up template metadata...`);
-    await fs.remove(path.join(cdnPath, '.git'));
-
-    // 3. Install dependencies
-    console.log(`\n📥 Installing dependencies (this may take a minute)...`);
-    await runProcess('npm', ['install'], cdnPath);
-
-    console.log(`\n✅ CDN Registry created successfully in ./${finalCdnName}\n`);
-    console.log(`To start your CDN:`);
-    console.log(`  cd ${finalCdnName}`);
-    console.log(`  npm start\n`);
-
-  } catch (error) {
-    console.error(`\n❌ Failed to create CDN: ${error.message}`);
-  }
-};
+const { runProcess } = require('../utils/process');
+const { getWorkspaceConfig } = require('../utils/config');
+const fs = require('fs-extra');
+const path = require('path');
+
+module.exports = async (cdnName) => {
+  const configObj = getWorkspaceConfig();
+  if (!configObj) {
+    console.error(`❌ Error: Call this command from inside an ESAD workspace (esad.config.json not found).`);
+    return;
+  }
+
+  const finalCdnName = cdnName || `${configObj.data.projectName}-cdn`;
+  const cdnPath = path.join(process.cwd(), finalCdnName);
+
+  if (fs.existsSync(cdnPath)) {
+    console.error(`❌ Error: Directory ./${finalCdnName} already exists.`);
+    return;
+  }
+
+  console.log(`\n📦 Initializing Flux Registry & CDN: ${finalCdnName}...\n`);
+
+  try {
+    // 1. Clone the template
+    console.log(`📡 Cloning template from GitHub...`);
+    await runProcess('git', ['clone', 'https://github.com/CodeMoreira/simple-cdn.git', finalCdnName]);
+
+    // 2. Remove .git from template
+    console.log(`🧹 Cleaning up template metadata...`);
+    await fs.remove(path.join(cdnPath, '.git'));
+
+    // 3. Install dependencies
+    console.log(`\n📥 Installing dependencies (this may take a minute)...`);
+    await runProcess('npm', ['install'], cdnPath);
+
+    console.log(`\n✅ CDN Registry created successfully in ./${finalCdnName}\n`);
+    console.log(`To start your CDN:`);
+    console.log(`  cd ${finalCdnName}`);
+    console.log(`  npm start\n`);
+
+  } catch (error) {
+    console.error(`\n❌ Failed to create CDN: ${error.message}`);
+  }
+};

package/src/cli/commands/createModule.js

@@ -8,12 +8,15 @@ const templatesConfig = require('../templates/templates.json');
 module.exports = async (moduleName) => {
   const configObj = getWorkspaceConfig();
   if (!configObj) {
-    console.error(`❌ Error: Call this command from inside an ESAD workspace (esad.config.json not found).`);
+    console.error(`❌ Error: Call this command from inside an ESAD workspace (esad.config.js not found).`);
     return;
   }
 
-  const { projectName } = configObj.data;
+  const config = await configObj.load();
+  const projectName = config.default?.projectName || config.projectName;
+
   const isPrefixed = moduleName.startsWith(`${projectName}-`);
+
   const finalModuleName = isPrefixed ? moduleName : `${projectName}-${moduleName}`;
 
   const workspaceDir = path.dirname(configObj.path);