@codemoreira/esad 2.0.1-3 → 2.0.1-30

package/README.md

@@ -1,82 +1,88 @@
-# 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).
+# ESAD: Easy Super App Development 🚀
+
+**Zero-Config CLI & Framework for React Native Module Federation + Expo.**
+
+ESAD is a unified toolkit designed to abstract all the complexity of Super App development. It bridges **Expo SDK 52** and **Re.Pack 5 (Rspack)** into a professional, linear workflow.
+
+---
+
+## 🔥 Key Features
+
+- **⚡ Zero-Config Native**: Automatic Android/iOS patching via **Expo Config Plugins**. No more manual Gradle or Manifest edits.
+- **🚀 Rspack Powered**: Blazing fast bundle generation for both Host and Remote Modules.
+- **🛡️ Authenticated Remotes**: Built-in support for **JWT-signed bundle resolution** and dynamic module discovery.
+- **📦 Shared Memory Bridge**: Reactive global state across federation boundaries using the ESAD Client SDK.
+- **🧹 Lifecycle Maestro**: Automated `prebuild`, script fixing, and dev-server management.
+
+---
+
+## 🏗️ Quick Start (V2)
+
+### 1. Initialize a Workspace
+Creates the project root, a programmable `esad.config.js`, and the Host Application.
+```bash
+npx @codemoreira/esad init my-super-app
+```
+
+### 2. Expand your Workspace
+Create new Federated Modules with built-in navigation and shared state examples.
+```bash
+esad create my-feature --type module
+```
+
+### 3. Development Manager (The Maestro)
+The `dev` command handles everything: Prebuilds, Script Fixing, and Native Launch.
+
+**Run the Host App:**
+```bash
+esad dev
+```
+*Choose Android or iOS. The CLI will automatically run `expo prebuild` if native folders are missing.*
+
+**Run a specific Module (in a separate terminal):**
+```bash
+esad dev my-feature --port 9000
+```
+
+---
+
+## 🛠️ Toolset Usage
+
+### 🎨 Bundler Plugin (`@codemoreira/esad/plugin`)
+The `withESAD` wrapper automates Module Federation v2 setup and dynamic exposes:
+```javascript
+import { withESAD } from '@codemoreira/esad/plugin';
+
+export default withESAD(env, {
+  type: 'module', 
+  id: 'my-feature',
+  dirname: __dirname
+});
+```
+
+### ⚡ Client 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('auth_user');
+const [counter, setCounter] = useESADState('global_counter', 0);
+```
+
+---
+
+## 🏛️ Architecture & Deep Dive
+For technical diagrams, lifecycle details, and the "Zero-Config" philosophy, see [ESAD_ARCHITECTURE.md](./ESAD_ARCHITECTURE.md).
+
+---
+
+## 🏠 Modern Templates
+ESAD templates provide a high-end starting point:
+- **Navigation Multi-página**: Federated modules with internal stack navigators.
+- **Real Auth**: Integration-ready for Simple-CDN registries via JWT.
+- **Smart UI**: Pre-configured Skeletons, Typography, and Modern Dark Mode.
+
+---
+
+> [!TIP]
+> **Why ESAD?** React Native Module Federation is hard. ESAD makes it as easy as a standard Expo app while keeping the power of dynamic micro-frontends.

package/bin/esad.js

@@ -24,12 +24,13 @@ program
     await require('../src/cli/commands/create')(name, options);
   });
 
-// --- COMMAND: esad dev [moduleId] ---
+// --- COMMAND: esad dev [id] ---
 program
-  .command('dev [id]') // [id] as alias to -i for better UX
+  .command('dev [id]')
   .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 local mapping')
+  .option('--platform <platform>', 'Platform for host: android, ios, bundler')
+  .description('Starts the development environment. Run without [id] for Host App or with [id] for a specific Module.')
   .action(async (id, options) => {
     const opts = { ...options, id: id || options.id };
     await require('../src/cli/commands/dev')(opts);
@@ -40,7 +41,7 @@ program
   .command('build [id]')
   .option('-i, --id <moduleId>', 'The Module ID to build')
   .option('-p, --platform <platform>', 'Platform: android, ios', 'android')
-  .description('Builds a production bundle')
+  .description('Builds a production bundle for a module or the host application')
   .action(async (id, options) => {
     const opts = { ...options, id: id || options.id };
     await require('../src/cli/commands/build')(opts);
@@ -57,14 +58,6 @@ program
     await require('../src/cli/commands/deploy')(opts);
   });
 
-// --- COMMAND: esad host <sub> ---
-program
-  .command('host <subcommand>')
-  .description('Manage host application (android, ios, login)')
-  .action(async (sub) => {
-    await require('../src/cli/commands/host')(sub);
-  });
-
 // --- COMMAND: esad doctor ---
 program
   .command('doctor')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codemoreira/esad",
-  "version": "2.0.1-3",
+  "version": "2.0.1-30",
   "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,6 +16,9 @@
     "./client": {
       "types": "./src/client/index.d.ts",
       "default": "./src/client/index.js"
+    },
+    "./expo-plugin": {
+      "default": "./src/plugin/withRepack.js"
     }
   },
   "bin": {
@@ -37,13 +40,11 @@
     "@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.3.1",
+    "@module-federation/enhanced": "^2.4.0",
     "@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",

package/src/cli/commands/dev.js

@@ -1,72 +1,175 @@
-const { runProcess } = require('../utils/process');
-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 } = require('../utils/resolution');
-
-module.exports = async (options) => {
-  const configObj = getWorkspaceConfig();
-  if (!configObj) {
-    console.error(chalk.red(`❌ Error: esad.config.js not found. Run this from your project root.`));
-    process.exit(1);
-  }
-
-  const config = await configObj.load();
-  const workspaceRoot = configObj.root;
-  const projectName = config.default?.projectName || config.projectName;
-  
-  let cwd = process.cwd();
-  let selectedModuleId = options.id;
-
-  if (selectedModuleId) {
-    const targetDir = resolveProjectDir(selectedModuleId, configObj);
-    if (!targetDir) {
-      console.error(chalk.red(`❌ Error: Module not found: ${selectedModuleId}`));
-      process.exit(1);
-    }
-    cwd = targetDir;
-  }
-
-  const pkgPath = path.join(cwd, 'package.json');
-  const pkg = fs.readJsonSync(pkgPath);
-  const moduleId = selectedModuleId || pkg.name;
-  const port = options.port || '8081';
-
-  // Determine if it's a Host or Module
-  const isHost = pkg.name.endsWith('-host') || pkg.dependencies?.['@callstack/repack'];
-  
-  await prepareNative(cwd, 'all');
-
-  if (isHost && !selectedModuleId) {
-     console.log(`\n🚀 Starting ${chalk.green('Host App')} Dev Server (Re.Pack/Rspack)...\n`);
-     await runProcess('npx', ['react-native', 'webpack-start'], { cwd });
-     return;
-  }
-
-  const { updateDevMode, removeDevMode, syncContextDownwards } = require('../utils/transformer');
-  
-  console.log(`\n⚡ Starting ESAD Dev Server for ${chalk.cyan(moduleId)} on port ${port}...\n`);
-  
-  // Automate devMode update in esad.config.js
-  const localBundleUrl = `http://localhost:${port}/index.bundle`;
-  updateDevMode(configObj.path, moduleId, localBundleUrl);
-  syncContextDownwards(configObj);
-  console.log(chalk.gray(`📡 Mode: Module Dev. Host configured to load ${moduleId} from ${localBundleUrl}`));
-
-  const proc = runProcess('npx', ['react-native', 'webpack-start', '--port', port], { cwd });
-
-  const shutdown = async () => {
-    console.log(`\n🛑 Stopping ESAD Dev Server and reverting config...`);
-    removeDevMode(configObj.path, moduleId);
-    syncContextDownwards(configObj);
-    if (proc.kill) proc.kill();
-    process.exit(0);
-  };
-
-
-  process.on('SIGINT', shutdown);
-  process.on('SIGTERM', shutdown);
-};
-
+const { runProcess } = require('../utils/process');
+const { getWorkspaceConfig } = require('../utils/config');
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const http = require('http');
+const readline = require('readline');
+const { spawn } = require('cross-spawn');
+const { prepareNative } = require('../utils/scaffold');
+const { resolveProjectDir } = require('../utils/resolution');
+
+/**
+ * Check if a port is in use
+ */
+const isPortInUse = (port) => new Promise((resolve) => {
+  const req = http.get(`http://localhost:${port}`, (res) => {
+    resolve(true); 
+  });
+  req.on('error', () => {
+    resolve(false); 
+  });
+  req.end();
+});
+
+const runHostDevFlow = async (cwd, options = {}) => {
+  let choice = options.platform ? options.platform.charAt(0).toLowerCase() : null;
+
+  if (!choice) {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout
+    });
+    const askQuestion = (query) => new Promise((resolve) => rl.question(query, resolve));
+
+    console.log(`\n${chalk.bold('ESAD Host Dev Manager')}`);
+    console.log(chalk.dim(`---------------------`));
+    console.log(`[a] Run on Android`);
+    console.log(`[i] Run on iOS`);
+    console.log(`[b] Bundler Only`);
+    console.log(`[c] Cancel`);
+    
+    choice = (await askQuestion(`\nSelect platform: `)).toLowerCase();
+    rl.close();
+  }
+  
+  if (choice === 'c') {
+    console.log(`\n❌ Cancelled.`);
+    return;
+  }
+
+  const portBusy = await isPortInUse(8081);
+  let shouldStartBundler = true;
+
+  if (portBusy) {
+    console.log(`\n⚠️  Warning: Port 8081 is already in use.`);
+    console.log(`💡 Skipping Bundler startup. Proceeding with Native Build.\n`);
+    shouldStartBundler = false;
+  }
+
+  if (shouldStartBundler && choice !== 'c') {
+    console.log(`\n🛠️ Starting Rspack Bundler...`);
+    if (process.platform === 'win32') {
+      spawn('cmd', ['/c', 'start', '/D', cwd, 'npx.cmd', '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();
+    }
+
+    console.log(`⏳ Waiting for Rspack Bundler 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;
+    };
+
+    if (!(await waitForBundler())) {
+      console.error(`\n❌ Timeout: Bundler did not respond.`);
+      return;
+    }
+    console.log(`✅ Bundler ready!`);
+  }
+
+  if (choice === 'a') {
+    console.log(`🤖 Launching Android...`);
+    await runProcess('react-native', ['run-android', '--no-packager'], cwd);
+  } else if (choice === 'i') {
+    console.log(`🍎 Launching iOS...`);
+    await runProcess('react-native', ['run-ios', '--no-packager'], cwd);
+  } else if (choice === 'b') {
+    console.log(`✨ Bundler is active.`);
+  }
+};
+
+module.exports = async (options) => {
+  const configObj = getWorkspaceConfig();
+  if (!configObj) {
+    console.error(chalk.red(`❌ Error: esad.config.js not found. Run this from your project root.`));
+    process.exit(1);
+  }
+
+  const config = configObj.data;
+  const workspaceRoot = configObj.root;
+  const projectName = config.projectName;
+  
+  let cwd = process.cwd();
+  let selectedModuleId = options.id;
+
+  // 1. Module Dev Flow
+  if (selectedModuleId) {
+    const targetDir = resolveProjectDir(selectedModuleId, configObj);
+    if (!targetDir) {
+      console.error(chalk.red(`❌ Error: Module not found: ${selectedModuleId}`));
+      process.exit(1);
+    }
+    cwd = targetDir;
+    
+    const pkg = fs.readJsonSync(path.join(cwd, 'package.json'));
+    const moduleId = selectedModuleId || pkg.name;
+    const port = options.port || '8081';
+
+    await prepareNative(cwd, 'all');
+
+    const { updateDevMode, removeDevMode, syncContextDownwards } = require('../utils/transformer');
+    
+    console.log(`\n⚡ Starting ESAD Dev Server for ${chalk.cyan(moduleId)} on port ${port}...\n`);
+    const localBundleUrl = `http://localhost:${port}/index.bundle`;
+    updateDevMode(configObj.path, moduleId, localBundleUrl);
+    syncContextDownwards(configObj);
+
+    const proc = runProcess('npx', ['react-native', 'webpack-start', '--port', port], { cwd });
+
+    const shutdown = async () => {
+      console.log(`\n🛑 Stopping ESAD Dev Server and reverting config...`);
+      removeDevMode(configObj.path, moduleId);
+      syncContextDownwards(configObj);
+      if (proc.kill) proc.kill();
+      process.exit(0);
+    };
+
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    return;
+  }
+
+  // 2. Host Dev Flow (Auto-detection)
+  const pkgPath = path.join(cwd, 'package.json');
+  let isHost = fs.existsSync(pkgPath) && fs.readJsonSync(pkgPath).name.endsWith('-host');
+
+  if (!isHost) {
+    const hostDir = path.join(workspaceRoot, `${projectName}-host`);
+    if (fs.existsSync(hostDir)) {
+      cwd = hostDir;
+      isHost = true;
+      console.log(`📂 Auto-detected Host App: ${chalk.dim(path.relative(process.cwd(), hostDir))}`);
+    }
+  }
+
+  if (isHost) {
+    await prepareNative(cwd, 'all');
+    await runHostDevFlow(cwd, options);
+  } else {
+    console.error(chalk.red(`❌ Error: Could not detect Host or Module context.`));
+    console.log(`👉 Try: esad dev <module-id>`);
+  }
+};

package/src/cli/commands/init.js

@@ -75,7 +75,7 @@ export default {
     console.log(chalk.green(`\n🎉 ESAD Workspace Initialized successfully!`));
     console.log(chalk.cyan(`\n👉 Next steps:`));
     console.log(`   1. cd ${projectName}/${hostName}`);
-    console.log(`   2. esad host dev (to start Host)`);
+    console.log(`   2. esad dev (to start Host)`);
     console.log(`   3. esad dev (in a module folder to federate)\n`);
   } catch (err) {
     console.error(chalk.red(`\n❌ Failed to initialize workspace:`));

package/src/cli/utils/config.js

@@ -20,15 +20,14 @@ const getWorkspaceConfig = () => {
 
   try {
     const jiti = createJiti(__filename);
-    const configModule = jiti(configPath);
-    // jiti.import returns a promise for async imports if needed, but for esad.config.js 
-    // we expect a sync structure or we resolve it.
-    // However, jiti v2 import is async.
-    
+    let configData = jiti(configPath);
+    if (configData.default) configData = configData.default;
+
     return { 
       path: configPath, 
       root: path.dirname(configPath),
-      load: () => configModule 
+      data: configData,
+      load: () => configData 
     };
   } catch (err) {
     console.error(`❌ Failed to load esad.config.js: ${err.message}`);

package/src/cli/utils/scaffold.js

@@ -38,6 +38,13 @@ async function renameProject(targetDir, newName) {
       if (appJson.expo.android) {
         appJson.expo.android.package = `com.anonymous.${newName.replace(/[^a-zA-Z0-9]/g, '')}`;
       }
+      
+      // Auto-register ESAD Expo Config Plugin
+      if (!appJson.expo.plugins) appJson.expo.plugins = [];
+      if (!appJson.expo.plugins.includes('@codemoreira/esad/expo-plugin')) {
+        appJson.expo.plugins.push('@codemoreira/esad/expo-plugin');
+        console.log(`✅ Registered @codemoreira/esad/expo-plugin in app.json.`);
+      }
     } else {
       appJson.name = newName;
       appJson.slug = newName;
@@ -60,27 +67,32 @@ async function renameProject(targetDir, newName) {
 }
 
 /**
- * Prepares the native folders and applies Re.Pack patches
+ * Prepares the native folders and applies Re.Pack patches via Config Plugin
  */
 async function prepareNative(cwd, platform = 'android') {
-  if (!fs.existsSync(path.join(cwd, 'android')) && (platform === 'android' || platform === 'all')) {
-    console.log(`📦 Native folder not found. Running expo prebuild...`);
-    await runProcess('npx', ['expo', 'prebuild', '--platform', 'android'], cwd);
-  }
+  const hasAndroid = fs.existsSync(path.join(cwd, 'android'));
+  const hasIos = fs.existsSync(path.join(cwd, 'ios'));
+
+  if ((!hasAndroid && (platform === 'android' || platform === 'all')) || 
+      (!hasIos && (platform === 'ios' || platform === 'all'))) {
+    
+    console.log(`\n📦 Native folder(s) missing. Running expo prebuild...`);
+    await runProcess('npx', ['expo', 'prebuild', '--platform', platform === 'all' ? 'all' : platform], cwd);
 
-  // Apply Gradle Patch (Android)
-  const buildGradlePath = path.join(cwd, 'android/app/build.gradle');
-  if (fs.existsSync(buildGradlePath)) {
-    let content = await fs.readFile(buildGradlePath, 'utf8');
-    if (!content.includes('project.ext.react')) {
-      const patch = `\nproject.ext.react = [\n    bundleCommand: "repack-bundle",\n    bundleConfig: "rspack.config.mjs"\n]\n\n`;
-      content = content.replace(/react \{/, `${patch}react {`);
-      await fs.writeFile(buildGradlePath, content);
-      console.log(`✅ Patched android/app/build.gradle for Re.Pack.`);
+    // FIX SCRIPTS: Revert Expo's overwrite and point to ESAD CLI
+    console.log(`\n🧹 Cleaning up package.json scripts (pointing to ESAD CLI)...`);
+    const pkgPath = path.join(cwd, 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      const pkg = await fs.readJson(pkgPath);
+      pkg.scripts.android = 'esad dev --platform android';
+      pkg.scripts.ios = 'esad dev --platform ios';
+      pkg.scripts.start = 'esad dev';
+      await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+      console.log(`✅ Scripts updated to use ESAD CLI (start, android, ios).`);
     }
   }
 
-  // Create react-native.config.js if missing
+  // Create react-native.config.js if missing (Essential for Re.Pack commands)
   const rnConfigPath = path.join(cwd, 'react-native.config.js');
   if (!fs.existsSync(rnConfigPath)) {
     const content = `module.exports = {\n  commands: require('@callstack/repack/commands/rspack'),\n};\n`;

package/src/plugin/index.js

@@ -1,158 +1,83 @@
-const path = require('node:path');
-const fs = require('node:fs');
-const Repack = require('@callstack/repack');
-const { ExpoModulesPlugin } = require('@callstack/repack-plugin-expo-modules');
-const { ProvidePlugin, DefinePlugin } = require('@rspack/core');
-
-/**
- * ESAD Re.Pack Plugin Wrapper
- * Abstracts away the boilerplate of Module Federation and SDK integration for SuperApps.
- * 
- * @param {Object} env Rspack environment
- * @param {Object} options 
- * @param {string} options.type 'host' | 'module'
- * @param {string} options.id Unique module or host ID
- * @param {string} options.dirname Base directory (__dirname)
- * @param {Object} [options.shared] Additional shared dependencies
- * @param {Object} [options.exposes] Modules to expose (for modules)
- * @param {Object} [options.remotes] Remote modules (for host)
- */
-function withESAD(env, options) {
-  const { platform, dev } = env;
-  const isDev = dev !== false;
-  const dirname = options.dirname;
-  const pkgPath = path.resolve(dirname, 'package.json');
-  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
-  const id = options.id.replace(/-/g, '_');
-  const sdkPkgPath = path.resolve(__dirname, '..', '..', 'package.json');
-  const sdkPkg = JSON.parse(fs.readFileSync(sdkPkgPath, 'utf8'));
-  const clientPath = path.resolve(__dirname, '..', 'client', 'index.js');
-
-  console.log(`[ESAD] Applying Mega-Zero-Config profile for ${options.type.toUpperCase()} (${platform}): ${id}`);
-
-  const config = {
-    mode: isDev ? 'development' : 'production',
-    context: dirname,
-    entry: options.entry || './index.js',
-    output: {
-      path: path.resolve(dirname, 'build', platform),
-      filename: 'index.bundle',
-      clean: true,
-    },
-    resolve: {
-      ...Repack.getResolveOptions(),
-      alias: {
-        '@': path.resolve(dirname, '.'),
-        // Internal MFv2 & Re.Pack Aliases (Magic)
-        '@module-federation/runtime/helpers': path.resolve(dirname, 'node_modules/@module-federation/runtime/dist/helpers.js'),
-        '@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'),
-        
-        ...Repack.getResolveOptions().alias,
-        ...(options.alias || {}),
-      }
-    },
-    module: {
-      rules: [
-        {
-          oneOf: [
-            {
-              test: /\.[cm]?[jt]sx?$/,
-              include: [
-                /node_modules[\\/](react-native|@react-native|expo|expo-modules-core|@expo|react-navigation|@react-navigation|@unimodules|unimodules|native-base)/,
-              ],
-              type: 'javascript/auto',
-              resolve: { fullySpecified: false },
-              use: {
-                loader: 'babel-loader',
-                options: {
-                  presets: [
-                    [
-                      'babel-preset-expo',
-                      { native: { disableImportExportTransform: false } },
-                    ],
-                  ],
-                  sourceType: 'unambiguous',
-                  caller: { name: 'repack' },
-                },
-              },
-            },
-            {
-              test: /\.[cm]?[jt]sx?$/,
-              include: [dirname],
-              type: 'javascript/auto',
-              use: {
-                loader: 'babel-loader',
-                options: {
-                  presets: ['babel-preset-expo'],
-                  sourceType: 'unambiguous',
-                  caller: { name: 'repack' },
-                },
-              },
-            },
-            ...Repack.getJsTransformRules(),
-          ]
-        },
-        ...Repack.getAssetTransformRules(),
-      ],
-    },
-    plugins: [
-      new ProvidePlugin({
-        process: 'process/browser',
-      }),
-      new DefinePlugin({
-        'process.env.NODE_ENV': JSON.stringify(isDev ? 'development' : 'production'),
-        '__DEV__': JSON.stringify(isDev),
-      }),
-      new ExpoModulesPlugin(),
-      new Repack.RepackPlugin(),
-      new Repack.plugins.ModuleFederationPluginV2({
-        name: id,
-        filename: `${id}.container.js.bundle`,
-        remotes: options.remotes || {},
-        ...(options.type === 'module' ? { exposes: options.exposes || {} } : {}),
-        dts: false,
-        dev: isDev,
-        shared: {
-          'react': { singleton: true, eager: true, requiredVersion: pkg.dependencies.react },
-          '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: options.type === 'host',
-            version: sdkPkg.version,
-            requiredVersion: sdkPkg.version,
-            import: clientPath 
-          },
-          ...(options.shared || {})
-        }
-      })
-    ],
-  };
-
-  // Add Host-specific DevServer magic for Expo
-  if (options.type === 'host') {
-    config.devServer = {
-      setupMiddlewares: (middlewares) => {
-        middlewares.unshift((req, res, next) => {
-          if (req.url.startsWith('/.expo/.virtual-metro-entry.bundle')) {
-            const query = req.url.split('?')[1];
-            const isMap = req.url.includes('.map');
-            const target = isMap ? '/index.bundle.map' : '/index.bundle';
-            const location = query ? `${target}?${query}` : target;
-            res.writeHead(302, { Location: location });
-            res.end();
-            return;
-          }
-          next();
-        });
-        return middlewares;
-      },
-    };
-  }
-
-  return config;
-}
-
-module.exports = { withESAD };
+const path = require('node:path');
+const fs = require('node:fs');
+const Repack = require('@callstack/repack');
+const { ExpoModulesPlugin } = require('@callstack/repack-plugin-expo-modules');
+
+/**
+ * ESAD Re.Pack Plugin Wrapper (v2.0 - POC Mirror)
+ * Totalmente alinhado com a POC funcional para Expo 52 + Re.Pack 5.
+ * 
+ * @param {Object} env Rspack environment
+ * @param {Object} options 
+ */
+function withESAD(env, options) {
+  const { platform, dev } = env;
+  const isDev = dev !== false;
+
+  const dirname = options.dirname;
+  const pkgPath = path.resolve(dirname, 'package.json');
+  const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+  const id = options.id.replace(/-/g, '_');
+  
+  const sdkPkgPath = path.resolve(__dirname, '..', '..', 'package.json');
+  const sdkPkg = JSON.parse(fs.readFileSync(sdkPkgPath, 'utf8'));
+  const clientPath = path.resolve(__dirname, '..', 'client', 'index.js');
+
+  return Repack.defineRspackConfig({
+    context: dirname,
+    mode: isDev ? 'development' : 'production',
+    entry: options.entry || './index.js',
+    resolve: {
+      ...Repack.getResolveOptions(),
+      conditionNames: ['require', 'import', 'module', 'browser', 'react-native'],
+      exportsFields: ['exports'],
+    },
+    module: {
+      rules: [
+        {
+          test: /\.[cm]?[jt]sx?$/,
+          type: 'javascript/auto',
+          use: {
+            loader: '@callstack/repack/babel-swc-loader',
+            options: {
+              parallel: true,
+            },
+          },
+        },
+        ...Repack.getAssetTransformRules(),
+      ],
+    },
+    plugins: [
+      new Repack.RepackPlugin(),
+      new Repack.plugins.ModuleFederationPluginV2({
+        name: id,
+        filename: `${id}.container.js.bundle`,
+        remotes: options.remotes || {},
+        ...(options.type === 'module' ? { 
+          exposes: options.exposes || {
+            './Main': options.entry || './index.js'
+          } 
+        } : {}),
+        dts: false,
+        dev: isDev,
+        shared: {
+          'react': { singleton: true, eager: true, requiredVersion: pkg.dependencies.react },
+          '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: options.type === 'host',
+            version: sdkPkg.version,
+            requiredVersion: sdkPkg.version,
+            import: clientPath 
+          },
+          ...(options.shared || {})
+        }
+      }),
+      new ExpoModulesPlugin(),
+    ],
+  });
+}
+
+module.exports = { withESAD };

package/src/plugin/withRepack.js

@@ -0,0 +1,90 @@
+const { withAppBuildGradle, withProjectBuildGradle, withMainApplication, withMainActivity, withGradleProperties, withAndroidManifest } = require('@expo/config-plugins');
+
+/**
+ * ESAD Expo Config Plugin
+ * Automates native patches for Re.Pack 5 + Expo 52.
+ */
+const withESADRepack = (config) => {
+  // 1. Disable New Architecture (Fabric) for stability with MF
+  config = withGradleProperties(config, (config) => {
+    config.modResults = config.modResults.map((item) => {
+      if (item.key === 'newArchEnabled') {
+        return { ...item, value: 'false' };
+      }
+      return item;
+    });
+    return config;
+  });
+
+  // 2. Adjust root build.gradle (Kotlin 1.9.25 for Compose Compiler)
+  config = withProjectBuildGradle(config, (config) => {
+    if (config.modResults.language === 'groovy') {
+      config.modResults.contents = config.modResults.contents.replace(
+        /kotlinVersion = findProperty\('android\.kotlinVersion'\) \?: '.+?'/,
+        "kotlinVersion = findProperty('android.kotlinVersion') ?: '1.9.25'"
+      );
+      config.modResults.contents = config.modResults.contents.replace(
+        /classpath\('org\.jetbrains\.kotlin:kotlin-gradle-plugin'\)/,
+        'classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion")'
+      );
+    }
+    return config;
+  });
+
+  // 3. Adjust app/build.gradle (bundleCommand and ABI Filters)
+  config = withAppBuildGradle(config, (config) => {
+    if (config.modResults.language === 'groovy') {
+      let contents = config.modResults.contents;
+      
+      if (!contents.includes('bundleCommand = "repack-bundle"')) {
+        contents = contents.replace(
+          /react \{/,
+          'react {\n    bundleCommand = "repack-bundle"\n    bundleConfig = "rspack.config.mjs"'
+        );
+      }
+
+      if (!contents.includes('abiFilters')) {
+        contents = contents.replace(
+          /defaultConfig \{/,
+          'defaultConfig {\n        ndk {\n            abiFilters "armeabi-v7a", "arm64-v8a", "x86", "x86_64"\n        }'
+        );
+      }
+
+      config.modResults.contents = contents;
+    }
+    return config;
+  });
+
+  // 4. Android Manifest (Cleartext Traffic for Dev Server)
+  config = withAndroidManifest(config, (config) => {
+    const mainApplication = config.modResults.manifest.application[0];
+    mainApplication.$['android:usesCleartextTraffic'] = 'true';
+    return config;
+  });
+
+  // 5. MainApplication (JS Main Module Name)
+  config = withMainApplication(config, (config) => {
+    if (config.modResults.language === 'kotlin' || config.modResults.language === 'kt') {
+      config.modResults.contents = config.modResults.contents.replace(
+        /getJSMainModuleName\(\): String = .*/,
+        'getJSMainModuleName(): String = "index"'
+      );
+    }
+    return config;
+  });
+
+  // 6. MainActivity (Main Component Name Sync)
+  config = withMainActivity(config, (config) => {
+    if (config.modResults.language === 'kotlin' || config.modResults.language === 'kt') {
+      config.modResults.contents = config.modResults.contents.replace(
+        /getMainComponentName\(\): String = .*/,
+        `getMainComponentName(): String = "${config.name}"`
+      );
+    }
+    return config;
+  });
+
+  return config;
+};
+
+module.exports = withESADRepack;

package/src/cli/commands/host.js

@@ -1,152 +0,0 @@
-const { runProcess } = require('../utils/process');
-const path = require('path');
-const fs = require('fs-extra');
-const { spawn } = require('cross-spawn');
-const http = require('http');
-const readline = require('readline');
-const { getWorkspaceConfig } = require('../utils/config');
-const { prepareNative } = require('../utils/scaffold');
-
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-
-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');
-  
-  // Try to find workspace config to resolve host path from root
-  const configObj = getWorkspaceConfig();
-  if (configObj) {
-    const workspaceRoot = path.dirname(configObj.path);
-    const { projectName } = configObj.data;
-    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 (!fs.existsSync(pkgPath)) {
-    console.error(`❌ Error: Call this command from inside the Host App or the Workspace Root.`);
-    return;
-  }
-
-  const pkg = fs.readJsonSync(pkgPath);
-
-  // 1. Initial Checks & Automated Native Preparation
-  if (subcommand === 'dev' || subcommand === 'start') {
-    await prepareNative(cwd, 'all');
-
-    // 3. Platform Selection
-    console.log(`\nESAD Host Dev Manager`);
-    console.log(`---------------------`);
-    console.log(`[a] Run on Android`);
-    console.log(`[i] Run on iOS`);
-    console.log(`[b] Bundler Only`);
-    console.log(`[c] Cancel`);
-    
-    const choice = (await askQuestion(`\nSelect platform: `)).toLowerCase();
-    
-    if (choice === 'c') {
-      console.log(`\n❌ Cancelled.`);
-      rl.close();
-      return;
-    }
-
-    // 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;
-    }
-
-    // 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') {
-        const npxCmd = 'npx.cmd';
-        spawn('cmd', ['/c', 'start', '/D', cwd, npxCmd, '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;
-      };
-
-      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!`);
-    }
-
-    // 6. Launch Native App
-    if (choice === 'a') {
-      console.log(`🤖 Compiling and launching on Android...`);
-      await runProcess('react-native', ['run-android', '--no-packager'], cwd);
-    } else if (choice === 'i') {
-      console.log(`🍎 Compiling and launching on iOS...`);
-      await runProcess('react-native', ['run-ios', '--no-packager'], cwd);
-    } else if (choice === 'b') {
-      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();
-  } else {
-    // Other subcommands (android, ios directly)
-    try {
-      if (subcommand === 'android') {
-        await runProcess('react-native', ['run-android', '--no-packager'], cwd);
-      } else if (subcommand === 'ios') {
-        await runProcess('react-native', ['run-ios', '--no-packager'], cwd);
-      }
-    } catch (err) {
-      console.error(`❌ Error running host command: ${err.message}`);
-    }
-    rl.close();
-  }
-};