create-fluxstack 1.4.1 → 1.5.0

package/core/cli/generators/plugin.ts

@@ -33,11 +33,12 @@ export class PluginGenerator implements Generator {
 
         console.log(`\n✅ Generated plugin '${options.name}' with ${files.length} files`)
         console.log(`\n📦 Next steps:`)
-        console.log(`   1. Edit plugins/${options.name}/plugin.json with your plugin metadata`)
-        console.log(`   2. Implement your plugin logic in plugins/${options.name}/index.ts`)
-        console.log(`   3. Add server-side code in plugins/${options.name}/server/ (optional)`)
-        console.log(`   4. Add client-side code in plugins/${options.name}/client/ (optional)`)
-        console.log(`   5. Run: bun run cli plugin:deps install`)
+        console.log(`   1. Configure plugin in plugins/${options.name}/config/index.ts`)
+        console.log(`   2. Set environment variables (optional): ${options.name.toUpperCase().replace(/-/g, '_')}_*`)
+        console.log(`   3. Implement your plugin logic in plugins/${options.name}/index.ts`)
+        console.log(`   4. Add server-side code in plugins/${options.name}/server/ (optional)`)
+        console.log(`   5. Add client-side code in plugins/${options.name}/client/ (optional)`)
+        console.log(`   6. Run: bun run dev`)
     }
 
     private getTemplate(templateName?: string): Template {
@@ -59,31 +60,80 @@ export class PluginGenerator implements Generator {
             description: 'Basic plugin template with essential files',
             files: [
                 {
-                    path: 'plugins/{{name}}/plugin.json',
+                    path: 'plugins/{{name}}/package.json',
                     content: `{
-  "name": "{{name}}",
+  "name": "@fluxstack/{{name}}-plugin",
   "version": "1.0.0",
   "description": "{{description}}",
-  "author": "Your Name",
-  "type": "fluxstack-plugin",
   "main": "index.ts",
+  "types": "index.ts",
+  "exports": {
+    ".": {
+      "import": "./index.ts",
+      "types": "./index.ts"
+    },
+    "./config": {
+      "import": "./config/index.ts",
+      "types": "./config/index.ts"
+    }
+  },
+  "keywords": [
+    "fluxstack",
+    "plugin",
+    "{{name}}",
+    "typescript"
+  ],
+  "author": "FluxStack Developer",
+  "license": "MIT",
+  "peerDependencies": {},
   "dependencies": {},
-  "fluxstack": {
-    "minVersion": "1.4.0"
+  "devDependencies": {
+    "typescript": "^5.0.0"
   },
-  "hooks": {
-    "setup": true,
-    "onServerStart": false,
-    "onRequest": false,
-    "onResponse": false,
-    "onError": false
+  "fluxstack": {
+    "plugin": true,
+    "version": "^1.0.0",
+    "hooks": [
+      "setup",
+      "onServerStart"
+    ],
+    "category": "utility",
+    "tags": ["{{name}}"]
   }
 }
+`
+                },
+                {
+                    path: 'plugins/{{name}}/config/index.ts',
+                    content: `/**
+ * {{pascalName}} Plugin Configuration
+ * Declarative config using FluxStack config system
+ */
+
+import { defineConfig, config } from '@/core/utils/config-schema'
+
+const {{camelName}}ConfigSchema = {
+  // Enable/disable plugin
+  enabled: config.boolean('{{constantName}}_ENABLED', true),
+
+  // Add your configuration options here
+  // Example:
+  // apiKey: config.string('{{constantName}}_API_KEY', ''),
+  // timeout: config.number('{{constantName}}_TIMEOUT', 5000),
+  // debug: config.boolean('{{constantName}}_DEBUG', false),
+} as const
+
+export const {{camelName}}Config = defineConfig({{camelName}}ConfigSchema)
+
+export type {{pascalName}}Config = typeof {{camelName}}Config
+export default {{camelName}}Config
 `
                 },
                 {
                     path: 'plugins/{{name}}/index.ts',
                     content: `import type { FluxStackPlugin, PluginContext } from '@/core/types/plugin'
+// ✅ Plugin imports its own configuration
+import { {{camelName}}Config } from './config'
 
 /**
  * {{pascalName}} Plugin
@@ -97,6 +147,12 @@ export class {{pascalName}}Plugin implements FluxStackPlugin {
    * Setup hook - called when plugin is loaded
    */
   async setup(context: PluginContext): Promise<void> {
+    // Check if plugin is enabled
+    if (!{{camelName}}Config.enabled) {
+      context.logger.info(\`[{{name}}] Plugin disabled by configuration\`)
+      return
+    }
+
     console.log(\`[{{name}}] Plugin initialized\`)
 
     // Add your initialization logic here
@@ -107,6 +163,8 @@ export class {{pascalName}}Plugin implements FluxStackPlugin {
    * Server start hook - called when server starts
    */
   async onServerStart?(context: PluginContext): Promise<void> {
+    if (!{{camelName}}Config.enabled) return
+
     console.log(\`[{{name}}] Server started\`)
 
     // Add logic to run when server starts
@@ -116,6 +174,8 @@ export class {{pascalName}}Plugin implements FluxStackPlugin {
    * Request hook - called on each request
    */
   async onRequest?(context: PluginContext, request: Request): Promise<void> {
+    if (!{{camelName}}Config.enabled) return
+
     // Add request processing logic
   }
 
@@ -123,6 +183,8 @@ export class {{pascalName}}Plugin implements FluxStackPlugin {
    * Response hook - called on each response
    */
   async onResponse?(context: PluginContext, response: Response): Promise<void> {
+    if (!{{camelName}}Config.enabled) return
+
     // Add response processing logic
   }
 
@@ -156,17 +218,29 @@ This plugin is already in your FluxStack project. To use it:
    bun run cli plugin:deps install
    \`\`\`
 
+## Configuration
+
+This plugin uses FluxStack's declarative configuration system. Configure it by editing \`config/index.ts\` or by setting environment variables:
+
+\`\`\`bash
+# Enable/disable plugin
+{{constantName}}_ENABLED=true
+
+# Add your environment variables here
+# Example:
+# {{constantName}}_API_KEY=your-api-key
+# {{constantName}}_TIMEOUT=5000
+\`\`\`
+
+The plugin's configuration is located in \`plugins/{{name}}/config/index.ts\` and is self-contained, making the plugin fully portable.
+
 ## Usage
 
 \`\`\`typescript
 // The plugin is automatically loaded by FluxStack
-// Configure it in your app/server/index.ts if needed
+// It imports its own configuration from ./config
 \`\`\`
 
-## Configuration
-
-Add configuration options here.
-
 ## API
 
 Document your plugin's API here.
@@ -184,8 +258,8 @@ This plugin uses the following hooks:
 
 To modify this plugin:
 
-1. Edit \`index.ts\` with your logic
-2. Update \`plugin.json\` with metadata
+1. Edit \`config/index.ts\` to add configuration options
+2. Edit \`index.ts\` with your logic
 3. Test with: \`bun run dev\`
 
 ## License
@@ -204,7 +278,60 @@ MIT
             name: 'server-plugin',
             description: 'Plugin with server-side code',
             files: [
-                ...basic.files,
+                {
+                    path: 'plugins/{{name}}/package.json',
+                    content: `{
+  "name": "@fluxstack/{{name}}-plugin",
+  "version": "1.0.0",
+  "description": "{{description}}",
+  "main": "index.ts",
+  "types": "index.ts",
+  "exports": {
+    ".": {
+      "import": "./index.ts",
+      "types": "./index.ts"
+    },
+    "./config": {
+      "import": "./config/index.ts",
+      "types": "./config/index.ts"
+    },
+    "./server": {
+      "import": "./server/index.ts",
+      "types": "./server/index.ts"
+    }
+  },
+  "keywords": [
+    "fluxstack",
+    "plugin",
+    "{{name}}",
+    "server",
+    "typescript"
+  ],
+  "author": "FluxStack Developer",
+  "license": "MIT",
+  "peerDependencies": {
+    "elysia": "^1.0.0"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "fluxstack": {
+    "plugin": true,
+    "version": "^1.0.0",
+    "hooks": [
+      "setup",
+      "onServerStart",
+      "onRequest",
+      "onResponse"
+    ],
+    "category": "utility",
+    "tags": ["{{name}}", "server"]
+  }
+}
+`
+                },
+                ...basic.files.slice(1), // Skip package.json from basic
                 {
                     path: 'plugins/{{name}}/server/index.ts',
                     content: `/**
@@ -233,7 +360,65 @@ export const {{camelName}}Service = new {{pascalName}}Service()
             name: 'client-plugin',
             description: 'Plugin with client-side code',
             files: [
-                ...basic.files,
+                {
+                    path: 'plugins/{{name}}/package.json',
+                    content: `{
+  "name": "@fluxstack/{{name}}-plugin",
+  "version": "1.0.0",
+  "description": "{{description}}",
+  "main": "index.ts",
+  "types": "index.ts",
+  "exports": {
+    ".": {
+      "import": "./index.ts",
+      "types": "./index.ts"
+    },
+    "./config": {
+      "import": "./config/index.ts",
+      "types": "./config/index.ts"
+    },
+    "./client": {
+      "import": "./client/index.ts",
+      "types": "./client/index.ts"
+    }
+  },
+  "keywords": [
+    "fluxstack",
+    "plugin",
+    "{{name}}",
+    "react",
+    "client",
+    "typescript"
+  ],
+  "author": "FluxStack Developer",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "typescript": "^5.0.0"
+  },
+  "fluxstack": {
+    "plugin": true,
+    "version": "^1.0.0",
+    "hooks": [
+      "setup",
+      "onServerStart"
+    ],
+    "category": "utility",
+    "tags": ["{{name}}", "client", "react"]
+  }
+}
+`
+                },
+                ...basic.files.slice(1), // Skip package.json from basic
                 {
                     path: 'plugins/{{name}}/client/index.ts',
                     content: `/**
@@ -265,22 +450,127 @@ export const {{camelName}}Client = new {{pascalName}}Client()
             name: 'full-plugin',
             description: 'Complete plugin with server and client code',
             files: [
-                ...basic.files,
-                ...server.files.slice(basic.files.length), // Add server files
-                ...client.files.slice(basic.files.length), // Add client files
+                {
+                    path: 'plugins/{{name}}/package.json',
+                    content: `{
+  "name": "@fluxstack/{{name}}-plugin",
+  "version": "1.0.0",
+  "description": "{{description}}",
+  "main": "index.ts",
+  "types": "index.ts",
+  "exports": {
+    ".": {
+      "import": "./index.ts",
+      "types": "./index.ts"
+    },
+    "./config": {
+      "import": "./config/index.ts",
+      "types": "./config/index.ts"
+    },
+    "./server": {
+      "import": "./server/index.ts",
+      "types": "./server/index.ts"
+    },
+    "./client": {
+      "import": "./client/index.ts",
+      "types": "./client/index.ts"
+    },
+    "./types": {
+      "import": "./types.ts",
+      "types": "./types.ts"
+    }
+  },
+  "keywords": [
+    "fluxstack",
+    "plugin",
+    "{{name}}",
+    "react",
+    "server",
+    "client",
+    "typescript"
+  ],
+  "author": "FluxStack Developer",
+  "license": "MIT",
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "elysia": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "typescript": "^5.0.0"
+  },
+  "fluxstack": {
+    "plugin": true,
+    "version": "^1.0.0",
+    "hooks": [
+      "setup",
+      "onServerStart",
+      "onRequest",
+      "onResponse",
+      "onError"
+    ],
+    "category": "utility",
+    "tags": ["{{name}}", "server", "client", "react"]
+  }
+}
+`
+                },
+                ...basic.files.slice(1), // Skip package.json from basic
+                {
+                    path: 'plugins/{{name}}/server/index.ts',
+                    content: `/**
+ * Server-side logic for {{pascalName}} plugin
+ */
+
+export class {{pascalName}}Service {
+  async initialize() {
+    console.log(\`[{{name}}] Server service initialized\`)
+  }
+
+  // Add your server-side methods here
+}
+
+export const {{camelName}}Service = new {{pascalName}}Service()
+`
+                },
+                {
+                    path: 'plugins/{{name}}/client/index.ts',
+                    content: `/**
+ * Client-side logic for {{pascalName}} plugin
+ */
+
+export class {{pascalName}}Client {
+  initialize() {
+    console.log(\`[{{name}}] Client initialized\`)
+  }
+
+  // Add your client-side methods here
+}
+
+export const {{camelName}}Client = new {{pascalName}}Client()
+`
+                },
                 {
                     path: 'plugins/{{name}}/types.ts',
                     content: `/**
  * Type definitions for {{pascalName}} plugin
  */
 
-export interface {{pascalName}}Config {
-  // Add your configuration types here
-  enabled: boolean
-}
+// Config types are exported from ./config/index.ts
+// Import them like: import type { {{pascalName}}Config } from './config'
 
 export interface {{pascalName}}Options {
-  // Add your options types here
+  // Add your runtime options types here
+}
+
+export interface {{pascalName}}Event {
+  // Add your event types here
 }
 `
                 }

package/core/cli/generators/template-engine.ts

@@ -85,6 +85,7 @@ export class TemplateEngine {
       camelName: this.toCamelCase(options.name),
       pascalName: this.toPascalCase(options.name),
       snakeName: this.toSnakeCase(options.name),
+      constantName: this.toConstantCase(options.name), // SCREAMING_SNAKE_CASE
       timestamp: new Date().toISOString(),
       date: new Date().toLocaleDateString(),
       year: new Date().getFullYear(),
@@ -149,6 +150,10 @@ export class TemplateEngine {
       .replace(/[\s-]+/g, '_')
       .toLowerCase()
   }
+
+  private toConstantCase(str: string): string {
+    return this.toSnakeCase(str).toUpperCase()
+  }
 }
 
 export const templateEngine = new TemplateEngine()

package/core/cli/plugin-discovery.ts

@@ -10,14 +10,14 @@ export class CliPluginDiscovery {
   async discoverAndRegisterCommands(): Promise<void> {
     // 1. Load built-in plugins with CLI commands
     await this.loadBuiltInPlugins()
-    
+
     // 2. Load local plugins from project
     await this.loadLocalPlugins()
   }
 
   private async loadBuiltInPlugins(): Promise<void> {
     const builtInPluginsDir = join(__dirname, '../plugins/built-in')
-    
+
     if (!existsSync(builtInPluginsDir)) {
       return
     }
@@ -33,7 +33,7 @@ export class CliPluginDiscovery {
           const pluginPath = join(builtInPluginsDir, pluginName, 'index.ts')
           if (existsSync(pluginPath)) {
             const pluginModule = await import(pluginPath)
-            
+
             if (pluginModule.commands) {
               for (const command of pluginModule.commands) {
                 cliRegistry.register(command)
@@ -57,7 +57,7 @@ export class CliPluginDiscovery {
 
   private async loadLocalPlugins(): Promise<void> {
     const localPluginsDir = join(process.cwd(), 'plugins')
-    
+
     if (!existsSync(localPluginsDir)) {
       return
     }
@@ -65,17 +65,18 @@ export class CliPluginDiscovery {
     try {
       const fs = await import('fs')
       const entries = fs.readdirSync(localPluginsDir, { withFileTypes: true })
-      
+
       for (const entry of entries) {
+        // Buscar arquivos .ts/.js diretamente
         if (entry.isFile() && (entry.name.endsWith('.ts') || entry.name.endsWith('.js'))) {
           const pluginPath = join(localPluginsDir, entry.name)
-          
+
           try {
             const pluginModule = await import(pluginPath)
             const plugin = pluginModule.default || Object.values(pluginModule).find(
               (exp: any) => exp && typeof exp === 'object' && exp.name && exp.commands
             ) as Plugin
-            
+
             if (plugin && plugin.commands) {
               this.registerPluginCommands(plugin)
             }
@@ -83,6 +84,26 @@ export class CliPluginDiscovery {
             logger.debug(`Failed to load local plugin ${entry.name}:`, error)
           }
         }
+
+        // ✅ Buscar em subdiretórios (plugins/nome-plugin/index.ts)
+        if (entry.isDirectory()) {
+          const pluginIndexPath = join(localPluginsDir, entry.name, 'index.ts')
+
+          if (existsSync(pluginIndexPath)) {
+            try {
+              const pluginModule = await import(pluginIndexPath)
+              const plugin = pluginModule.default || Object.values(pluginModule).find(
+                (exp: any) => exp && typeof exp === 'object' && exp.name && exp.commands
+              ) as Plugin
+
+              if (plugin && plugin.commands) {
+                this.registerPluginCommands(plugin)
+              }
+            } catch (error) {
+              logger.debug(`Failed to load local plugin ${entry.name}:`, error)
+            }
+          }
+        }
       }
     } catch (error) {
       logger.debug('Failed to scan local plugins:', error)
@@ -103,9 +124,9 @@ export class CliPluginDiscovery {
           category: command.category || `Plugin: ${plugin.name}`,
           aliases: command.aliases?.map(alias => `${plugin.name}:${alias}`)
         }
-        
+
         cliRegistry.register(prefixedCommand)
-        
+
         // Also register without prefix if no conflict exists
         if (!cliRegistry.has(command.name)) {
           cliRegistry.register({
@@ -114,10 +135,10 @@ export class CliPluginDiscovery {
           })
         }
       }
-      
+
       this.loadedPlugins.add(plugin.name)
       logger.debug(`Registered ${plugin.commands.length} CLI commands from plugin: ${plugin.name}`)
-      
+
     } catch (error) {
       logger.error(`Failed to register CLI commands for plugin ${plugin.name}:`, error)
     }
@@ -128,4 +149,4 @@ export class CliPluginDiscovery {
   }
 }
 
-export const pluginDiscovery = new CliPluginDiscovery()
+export const pluginDiscovery = new CliPluginDiscovery()

package/core/framework/server.ts

@@ -469,6 +469,16 @@ export class FluxStackFramework {
         }
       }
 
+      // Mount plugin routes if they have a plugin property
+      for (const pluginName of loadOrder) {
+        const plugin = this.pluginRegistry.get(pluginName)!
+
+        if ((plugin as any).plugin) {
+          this.app.use((plugin as any).plugin)
+          logger.debug(`Plugin '${pluginName}' routes mounted`)
+        }
+      }
+
       // Call onServerStart hooks
       for (const pluginName of loadOrder) {
         const plugin = this.pluginRegistry.get(pluginName)!