@codemoreira/esad 1.3.16 → 1.4.1

package/README.md

@@ -23,11 +23,16 @@ npx esad create-module module-name
 npx esad create-cdn
 ```
 
-### 4. Development & Native Automation
-Starts the Rspack server and **automatically patches** native files (Gradle, Entry Points) if necessary.
+### 4. Development & Cloud-Sync
+Starts the Rspack server locally OR performs a **Dev-Cloud Sync** for remote preview.
 ```bash
-npx esad host dev  # Run the Host App
-npx esad dev --id module-name --port 9000  # Run a Module
+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
@@ -58,7 +63,7 @@ export default withESAD({
 ```
 
 ### ⚡ Global State SDK (`@codemoreira/esad/client`)
-Share state across the Host and all Remote Modules reactively:
+Share state across the Host and all Remote Modules reactively via a **Universal Singleton**:
 ```javascript
 import { useESADState } from '@codemoreira/esad/client';
 
@@ -67,6 +72,15 @@ 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:

package/bin/esad.js

@@ -27,8 +27,8 @@ program
 
 // --- COMMAND: esad create-cdn ---
 program
-  .command('create-cdn [cdn-name]')
-  .description('Scaffold the CDN / Registry backend')
+  .command('create-cdn')
+  .description('Scaffold the CDN backend (always named {{projectName}}-cdn)')
   .action(async (name) => {
      await createCdnCommand(name);
      process.exit(0);
@@ -37,7 +37,7 @@ program
 // --- COMMAND: esad host ---
 program
   .command('host <subcommand>')
-  .description('Manage the Host App (dev, android, ios)')
+  .description('Manage the Host App (Auto-Syncs config, runs android/ios)')
   .action(async (sub) => {
      await hostCommand(sub);
      process.exit(0);
@@ -78,9 +78,9 @@ program
 // --- 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')
+  .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);
      // Note: dev command has its own shutdown logic with SIGINT/SIGTERM

package/package.json

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

package/src/cli/commands/build.js

@@ -2,7 +2,7 @@ const { runProcess } = require('../utils/process');
 const path = require('path');
 const fs = require('fs-extra');
 const chalk = require('chalk');
-const { getWorkspaceConfig } = require('../utils/config');
+const { getWorkspaceConfig, syncHostConfig } = require('../utils/config');
 const { resolveProjectDir, listAvailableModules } = require('../utils/resolution');
 
 module.exports = async (options) => {
@@ -15,6 +15,8 @@ module.exports = async (options) => {
     process.exit(1);
   }
 
+  syncHostConfig(configObj);
+
   const { projectName } = configObj.data;
   
   if (options.id) {

package/src/cli/commands/createCdn.js

@@ -10,7 +10,8 @@ module.exports = async (cdnName) => {
     return;
   }
 
-  const finalCdnName = cdnName || `${configObj.data.projectName}-cdn`;
+  const { projectName } = configObj.data;
+  const finalCdnName = `${projectName}-cdn`;
   const cdnPath = path.join(process.cwd(), finalCdnName);
 
   if (fs.existsSync(cdnPath)) {

package/src/cli/commands/deploy.js

@@ -2,7 +2,7 @@ const fs = require('fs-extra');
 const path = require('path');
 const AdmZip = require('adm-zip');
 const chalk = require('chalk');
-const { getWorkspaceConfig } = require('../utils/config');
+const { getWorkspaceConfig, syncHostConfig } = require('../utils/config');
 const { resolveModuleMetadata, listAvailableModules } = require('../utils/resolution');
 
 module.exports = async (options) => {
@@ -19,6 +19,8 @@ module.exports = async (options) => {
   const workspaceRoot = path.dirname(configObj.path);
   const { projectName } = configObj.data;
   
+  syncHostConfig(configObj);
+  
   let moduleId = options.id;
   
   if (moduleId) {

package/src/cli/commands/dev.js

@@ -1,10 +1,11 @@
 const { spawn } = require('cross-spawn');
-const { getWorkspaceConfig } = require('../utils/config');
+const { getWorkspaceConfig, syncHostConfig } = 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');
+const { resolveModuleMetadata, listAvailableModules } = require('../utils/resolution');
+const { runProcess } = require('../utils/process');
+const AdmZip = require('adm-zip');
 
 module.exports = async (options) => {
   let cwd = process.cwd();
@@ -20,6 +21,9 @@ module.exports = async (options) => {
   const workspaceRoot = path.dirname(configObj.path);
   const { projectName } = configObj.data;
   
+  // Synchronize Host Config
+  syncHostConfig(configObj);
+  
   if (options.id) {
     const targetDir = resolveProjectDir(options.id, configObj);
     if (!targetDir) {
@@ -40,50 +44,80 @@ module.exports = async (options) => {
     }
   }
 
+  if (!fs.existsSync(pkgPath)) {
+    console.error(chalk.red(`❌ Error: package.json not found in ${cwd}.`));
+    process.exit(1);
+  }
+
   const pkg = fs.readJsonSync(pkgPath);
-  const moduleId = options.id || pkg.name;
-  const port = options.port || '8081';
+  moduleId = moduleId || pkg.name;
+  const platform = options.platform || 'android';
 
-  // Determine if it's a Host or Module
-  const isHost = pkg.name.endsWith('-host') || pkg.dependencies?.['@callstack/repack'];
+  console.log(chalk.cyan(`\n☁️  Starting ESAD Dev-Push for ${moduleId} (${platform})\n`));
   
-  // 1. Initial Checks & Automated Native Preparation
-  await prepareNative(cwd, 'all');
-
-  if (isHost && !options.id) {
-     console.log(`\n🚀 Starting Host App Dev Server (Re.Pack/Rspack)...\n`);
-     await spawn('npx', ['react-native', 'webpack-start'], { cwd, stdio: 'inherit', shell: true });
-     return;
+  const config = configObj ? configObj.data : null;
+  const devUrlBase = config?.deployEndpoint || config?.devEndpoint;
+  
+  if (!devUrlBase) {
+    console.error(chalk.red(`❌ Error: 'deployEndpoint' not configured in esad.config.json.`));
+    process.exit(1);
   }
 
-  console.log(`\n⚡ Starting ESAD Dev Server for ${moduleId} on port ${port}...\n`);
-  
-  const config = configObj ? configObj.data : null;
-  let devApiUrl = config?.devModeEndpoint ? config.devModeEndpoint.replace('{{moduleId}}', moduleId) : null;
+  const devUploadUrl = devUrlBase.replace('{{moduleId}}', moduleId) + '/dev';
+  console.log(`📡 Dev-Cloud Endpoint: ${devUploadUrl}`);
 
-  const setDevMode = async (isActive) => {
-    if (!devApiUrl) return;
-    try {
-      const body = { 
-        is_dev_mode: isActive, 
-        ...(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'} for module ${moduleId}`);
-    } catch(e) { /* ignore */ }
-  };
+  // 1. Build
+  console.log(`\n🏗️  Step 1/3: Building bundle...`);
+  const bundleOutput = path.join(cwd, 'build', platform, 'index.bundle');
+  await fs.ensureDir(path.dirname(bundleOutput));
+  
+  try {
+    await runProcess('npx', [
+      'react-native', 
+      'webpack-bundle', 
+      '--platform', platform, 
+      '--dev', 'false',
+      '--bundle-output', bundleOutput,
+      '--assets-dest', path.dirname(bundleOutput)
+    ], cwd);
+  } catch (err) {
+    console.error(chalk.red(`❌ Build failed.`));
+    process.exit(1);
+  }
 
-  await setDevMode(true);
+  // 2. Zip
+  console.log(`\n🗜️  Step 2/3: Zipping assets...`);
+  const zip = new AdmZip();
+  const buildDir = path.join(cwd, 'build');
+  zip.addLocalFolder(buildDir);
+  const zipPath = path.join(cwd, `dev-bundle-${moduleId}.zip`);
+  zip.writeZip(zipPath);
 
-  const proc = spawn('npx', ['react-native', 'webpack-start', '--port', port], { cwd, stdio: 'inherit', shell: true });
+  // 3. Upload
+  console.log(`\n🚀 Step 3/3: Pushing to Dev-Cloud...`);
+  try {
+    const FormData = require('form-data');
+    const form = new FormData();
+    form.append('bundle', fs.createReadStream(zipPath));
 
-  const shutdown = async () => {
-    console.log(`\n🛑 Stopping ESAD Dev Server and reverting registry status...`);
-    await setDevMode(false);
-    proc.kill();
-    process.exit(0);
-  };
+    const fetch = (...args) => import('node-fetch').then(({default: fetch}) => fetch(...args));
+    const response = await fetch(devUploadUrl, {
+      method: 'POST',
+      body: form,
+      headers: form.getHeaders(),
+    });
 
-  process.on('SIGINT', shutdown);
-  process.on('SIGTERM', shutdown);
+    if (response.ok) {
+      console.log(chalk.green(`\n✅ Successfully synced ${moduleId} to Dev-Cloud!`));
+      console.log(`📱 Host app configured with 'devModeFor: ["${options.id || moduleId}"]' will now load this version.\n`);
+    } else {
+      const errorText = await response.text();
+      console.error(chalk.red(`❌ Cloud Sync failed: ${response.status} ${response.statusText}`));
+      console.error(errorText);
+    }
+  } catch (err) {
+    console.error(chalk.red(`❌ Error during sync: ${err.message}`));
+  } finally {
+    if (fs.existsSync(zipPath)) fs.unlinkSync(zipPath);
+  }
 };

package/src/cli/utils/config.js

@@ -2,10 +2,36 @@ const fs = require('fs-extra');
 const path = require('path');
 
 const getWorkspaceConfig = () => {
-  let configPath = path.join(process.cwd(), 'esad.config.json');
-  if (!fs.existsSync(configPath)) configPath = path.join(process.cwd(), '../esad.config.json');
+  let cwd = process.cwd();
+  let configPath = path.join(cwd, 'esad.config.json');
+  
+  // Search up to 2 levels (root or project folder)
+  if (!fs.existsSync(configPath)) configPath = path.join(cwd, '..', 'esad.config.json');
+  if (!fs.existsSync(configPath)) configPath = path.join(cwd, '..', '..', 'esad.config.json');
+  
   if (!fs.existsSync(configPath)) return null;
   return { path: configPath, data: fs.readJsonSync(configPath) };
 };
 
-module.exports = { getWorkspaceConfig };
+const syncHostConfig = (configObj) => {
+  if (!configObj) return;
+  const { projectName } = configObj.data;
+  const workspaceRoot = path.dirname(configObj.path);
+  const hostDir = path.join(workspaceRoot, `${projectName}-host`);
+  
+  if (fs.existsSync(hostDir)) {
+    const hostConfigPath = path.join(hostDir, 'esad.config.json');
+    
+    // Only pass client-safe fields
+    const clientConfig = {
+      projectName: configObj.data.projectName,
+      registryUrl: configObj.data.registryUrl,
+      devModeFor: configObj.data.devModeFor || []
+    };
+    
+    fs.writeJsonSync(hostConfigPath, clientConfig, { spaces: 2 });
+    console.log(`\n🔄 Sync: Config propagated to ${path.relative(workspaceRoot, hostConfigPath)}`);
+  }
+};
+
+module.exports = { getWorkspaceConfig, syncHostConfig };

package/src/client/index.js

@@ -5,34 +5,47 @@ import { useState, useEffect } from 'react';
  * This class runs as a true Singleton across the Host and all Federated Modules,
  * allowing instant variable sharing without tight coupling.
  */
-class ESADEventEmitter {
-  constructor() {
-    this.state = {};
-    this.listeners = {};
-  }
+// Unique key to store the global state in the environment (shared across sessions)
+const GLOBAL_STORE_KEY = '__ESAD_GLOBAL_STATE__';
+
+// Initialize the global store if it doesn't already exist.
+// This ensures that even if different chunks/modules have their own copy 
+// of this JS file, they all point to the same memory object in globalThis.
+if (!globalThis[GLOBAL_STORE_KEY]) {
+  globalThis[GLOBAL_STORE_KEY] = {
+    state: {},
+    listeners: {}
+  };
+}
+
+const GlobalStore = globalThis[GLOBAL_STORE_KEY];
 
+class ESADEventEmitter {
   set(key, value) {
-    this.state[key] = value;
-    if (this.listeners[key]) {
-      this.listeners[key].forEach(callback => callback(value));
+    GlobalStore.state[key] = value;
+    if (GlobalStore.listeners[key]) {
+      GlobalStore.listeners[key].forEach(callback => callback(value));
     }
   }
 
   get(key) {
-    return this.state[key];
+    return GlobalStore.state[key];
   }
 
   subscribe(key, callback) {
-    if (!this.listeners[key]) this.listeners[key] = [];
-    this.listeners[key].push(callback);
+    if (!GlobalStore.listeners[key]) {
+      GlobalStore.listeners[key] = [];
+    }
+    GlobalStore.listeners[key].push(callback);
+    
+    // Return unsubscribe function
     return () => {
-      this.listeners[key] = this.listeners[key].filter(cb => cb !== callback);
+      GlobalStore.listeners[key] = GlobalStore.listeners[key].filter(cb => cb !== callback);
     };
   }
 }
 
-// Because this package is marked as a ModuleFederation Singleton,
-// this instance will be shared identically across all chunks!
+// Global instance (acts as a proxy to the globalStore)
 const ESADState = new ESADEventEmitter();
 
 /**

package/src/plugin/index.js

@@ -24,6 +24,7 @@ function withESAD(env, options) {
   const pkgPath = path.resolve(dirname, 'package.json');
   const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
   const id = options.id.replace(/-/g, '_');
+  const clientPath = path.resolve(__dirname, '..', 'client', 'index.js');
 
   console.log(`[ESAD] Applying Mega-Zero-Config profile for ${options.type.toUpperCase()} (${platform}): ${id}`);
 
@@ -96,8 +97,11 @@ 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 },
+          '@codemoreira/esad/client': { 
+            singleton: true, 
+            eager: options.type === 'host', // Only eager in host to ensure it's available
+            import: clientPath 
+          },
           ...(options.shared || {})
         }
       })