one-for-all-framework 4.2.0 → 4.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1634666412d07dfeae3b9416c7a27b16436ba9d1a03f726df8b245e6f6fe71f7
-  data.tar.gz: 4240f873f851ecfccd556a7b061e2ac3c2020aa26d383b87a217506160c6295b
+  metadata.gz: 345583a2af3a1c7ee4eb6d923c1d87ea769a5f6e70c98537a36575d1ee89dc03
+  data.tar.gz: 596e7f2abe8bcf277d180e5044e9b5fb77fbfa894c894c92639d7cda3fc4136a
 SHA512:
-  metadata.gz: efb0120858fb436c64f1ec7a92433deda88fee6dc1738661af68a0a303d8874cb4f6a5a7f2583a527ad8e9a9188b0e67b16abaf201c205044a421cb2a3780635
-  data.tar.gz: ff176420fce31ecfec8fffcec1862e911d64f8b78478d3a073f3b317bd98fa553df7b9d05fd36b5a0c219582ec1b835a83eb854480cdeb62a624822c2df02170
+  metadata.gz: 9b5c07c96b28fc73548e35ecbb81113361d6b32575c4a681bf7bf0b916e2c39e4b18e34032f252c83176116a89d4377d8f1f58ee16acab90cdafb4d0ce467b03
+  data.tar.gz: bcb67f5526ebca56809ec9fa8009199b0911c2668445b8eb15ecd7f5995edde4fd8b33271b4168a416fc04aa87f768947d8109a1e0816a97b2620571cd1f911d

data/.env.example

@@ -2,3 +2,8 @@ DATABASE_URL="sqlite://db/development.sqlite3"
 CLOUDINARY_URL="cloudinary://API_KEY:API_SECRET@CLOUD_NAME"
 EKS_CENT_SECRET_KEY_BASE="your_secret_key"
 EKS_ENV="development"
+MAILER_FROM="admin@example.com"
+SMTP_ADDRESS="smtp.gmail.com"
+SMTP_PORT=587
+SMTP_USER_NAME="your_email@gmail.com"
+SMTP_PASSWORD="your_app_password"

data/Gemfile

@@ -13,6 +13,8 @@ gem 'mongo'
 gem 'dotenv'
 gem 'kramdown'
 gem 'kramdown-parser-gfm'
+gem 'mail'
+gem 'minitest'
 
 group :test do
   gem 'eksa-mination'

data/README.md

@@ -2,7 +2,7 @@
   <img src="public/images/logo.png" width="500" height="500" alt="OFA Framework Logo">
 </p>
 
-# ⚡ One-For-All (OFA) Framework v4.2.0
+# ⚡ One-For-All (OFA) Framework v4.4.0
 
 [![Ruby Version](https://img.shields.io/badge/ruby-%3E%3D%203.0.0-red.svg)](https://www.ruby-lang.org/)
 [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
@@ -21,6 +21,7 @@
 -   **🔐 Enterprise Ready**: Built-in CSRF protection, secure session management, and input validation.
 -   **🌐 Global Support**: Multi-language (I18n) support and SEO optimization ready.
 -   **🖋️ Rich Text Editor**: Integrated Trix Editor for seamless post and page creation with image upload support.
+-   **📡 Modern API**: Built-in JWT support and automated Swagger/OpenAPI documentation.
 
 ---
 
@@ -82,6 +83,8 @@ Boots the high-performance Eksa Server engine.
 ### 🏗️ Generators (Scaffolding)
 #### `ofa g controller NAME`
 *   **Output:** `✅ Created app/controllers/blog_controller.rb`
+#### `ofa g api NAME`
+*   **Output:** `✅ Created app/controllers/shop_controller.rb`
 #### `ofa g model NAME`
 *   **Output:** `✅ Created app/models/product.rb`
 #### `ofa g post TITLE [args]`
@@ -89,6 +92,11 @@ Creates a SEO-optimized blog post with metadata.
 *   **Example:** `./ofa g post "Hello World" --author Antigravity`
 *   **Output:** `✅ Created app/views/posts/hello_world.erb`
 
+### 📡 API & Documentation
+#### `ofa swagger`
+Generates a standards-compliant `openapi.json` file.
+*   **Output:** `✅ Documentation saved to: openapi.json`
+
 ### 📂 Database Management
 #### `ofa db switch TYPE [URL]`
 Switches your database adapter on the fly.
@@ -132,6 +140,9 @@ Securely manages admin credentials.
 | `ofa console` | **Interactive REPL.** Starts a Ruby console pre-loaded with your application environment and models for testing and debugging. |
 | `ofa doctor` | **System Health Check.** Validates `.env` config, database connectivity (SQL/MongoDB), Ruby version, and dependencies. |
 | `ofa routes` | **Route Inspection.** Lists all registered routes in your application in a clean tabular format. |
+| `ofa swagger` | **OpenAPI Generation.** Auto-generates `openapi.json` for your entire application. |
+| `ofa task NAME` | **Run Background Task.** Executes a task defined in `lib/tasks/`. |
+| `ofa test` | **Run Test Suite.** Executes all unit tests in the `test/` directory using Minitest. |
 | `ofa deploy` | **Production Deployment.** Automatically detects deployment targets (Railway/Docker/Git). |
 
 ---
@@ -142,8 +153,12 @@ Automate the creation of boilerplate code with the generator command.
 | Command | Description |
 | :--- | :--- |
 | `ofa g controller NAME` | Creates a new controller in `app/controllers/{name}_controller.rb` with a default `index` action. |
+| `ofa g api NAME` | Creates a JSON-based controller in `app/controllers/{name}_controller.rb` inheriting from `ApiController`. |
 | `ofa g model NAME` | Generates a database model in `app/models/{name}.rb` integrated with the Sequel ORM. |
 | `ofa g migration NAME` | Creates a timestamped migration file in `db/migrations/`. Use this to define your schema changes. |
+| `ofa g mailer NAME ACTION` | Generates a new mailer in `app/mailers/` and an ERB template in `app/views/mailers/`. |
+| `ofa g task NAME` | Creates a new background task file in `lib/tasks/`. |
+| `ofa g test NAME` | Generates a new Minitest unit test in `test/`. |
 | `ofa g post TITLE` | Creates a new Markdown/ERB post in `app/views/posts/`. <br> *Args:* `--category`, `--author`, `--image`. <br> *Example:* `./ofa g post "My First Journey" --category Tech --author "John Doe"` |
 
 ---

data/app/controllers/application_controller.rb

@@ -27,6 +27,10 @@ class ApplicationController
     @res.headers['Location'] = path
   end
 
+  def render_json(data, status: 200)
+    @res.json(data, status: status)
+  end
+
   # Validation Helper
   def validate!(required_params)
     missing = required_params.select { |p| params[p.to_s].nil? || params[p.to_s].empty? }

data/app/mailers/application_mailer.rb

@@ -0,0 +1,42 @@
+require 'mail'
+require 'erb'
+
+class ApplicationMailer
+  # Configure default settings if needed
+  def self.mail(to:, subject:, template:, locals: {})
+    # Template name expected: "welcome_mailer/welcome"
+    template_path = File.join(APP_ROOT, 'app', 'views', 'mailers', "#{template}.erb")
+    
+    unless File.exist?(template_path)
+      puts "❌ Mailer Error: Template not found at #{template_path}"
+      return
+    end
+
+    # Create rendering context
+    context = Object.new
+    locals.each { |k, v| context.instance_variable_set("@#{k}", v) }
+    
+    body_content = ERB.new(File.read(template_path)).result(context.instance_eval { binding })
+
+    mail = Mail.new do
+      from    ENV['MAILER_FROM'] || 'admin@example.com'
+      to      to
+      subject subject
+      body    body_content
+      
+      # Optional: set content type to HTML if needed
+      # content_type 'text/html; charset=UTF-8'
+    end
+
+    # In development/test, we might want to just log it
+    if ENV['EKS_ENV'] == 'production'
+      mail.deliver!
+    else
+      puts "--- 📧 EMAIL SENT ---"
+      puts "To:      #{to}"
+      puts "Subject: #{subject}"
+      puts "Body:\n#{body_content}"
+      puts "----------------------"
+    end
+  end
+end

data/app/middleware/jwt_middleware.rb

@@ -0,0 +1,31 @@
+begin
+  require 'jwt'
+rescue LoadError
+end
+
+class JwtMiddleware
+  def initialize(app)
+    @app = app
+  end
+
+  def call(env)
+    auth_header = env['HTTP_AUTHORIZATION']
+    if auth_header && auth_header.start_with?('Bearer ')
+      token = auth_header.split(' ').last
+      begin
+        secret = ENV['JWT_SECRET'] || 'one-for-all-secret-key'
+        if defined?(JWT)
+          decoded_token = JWT.decode(token, secret, true, { algorithm: 'HS256' })
+          env['current_user_id'] = decoded_token[0]['user_id']
+          env['jwt_payload'] = decoded_token[0]
+        end
+      rescue JWT::DecodeError
+        # If token is invalid, we don't halt here, just don't set current_user_id
+      rescue NameError
+        # JWT not defined
+      end
+    end
+
+    @app.call(env)
+  end
+end

data/app/views/docs.erb

@@ -1,6 +1,6 @@
 <div class="space-y-12 pb-20">
     <div class="text-left">
-        <div class="badge-premium">Documentation v4.2.0</div>
+        <div class="badge-premium">Documentation v4.4.0</div>
         <h1 class="text-5xl font-black tracking-tighter mb-4 text-slate-700 dark:text-white">Framework <span class="text-primary">Guide</span></h1>
         <p class="text-xl text-slate-500 max-w-2xl leading-relaxed">Everything you need to know about building premium web applications with the One-For-All framework.</p>
     </div>
@@ -16,6 +16,9 @@
                 <a href="#routing" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">Routing System</a>
                 <a href="#cms" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">CMS & Features</a>
                 <a href="#ecommerce" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">E-Commerce</a>
+                <a href="#api" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">API & Modern Web</a>
+                <a href="#advanced" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">Mailers & Background Jobs</a>
+                <a href="#testing" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">Automated Testing</a>
                 <a href="#deploy" class="block px-4 py-2 rounded-xl hover:bg-primary/5 text-slate-600 hover:text-primary transition-all font-semibold border-l-2 border-transparent hover:border-primary">Deployment</a>
             </nav>
         </aside>
@@ -74,24 +77,44 @@
                                 <td class="px-6 py-4 font-mono text-primary">./ofa routes</td>
                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">List all registered routes in a clean table.</td>
                             </tr>
-                            <tr>
-                                <td class="px-6 py-4 font-mono text-primary">./ofa deploy</td>
-                                <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs italic">Railway/Docker/Git auto-detection for production.</td>
-                            </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa deploy</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs italic">Railway/Docker/Git auto-detection for production.</td>
+                             </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa swagger</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Generate <code>openapi.json</code> for Swagger UI.</td>
+                             </tr>
 
                             <tr class="bg-slate-500/5"><td colspan="2" class="px-6 py-2 text-[10px] font-black uppercase tracking-tighter text-slate-400">Generators (Scaffolding)</td></tr>
-                            <tr>
-                                <td class="px-6 py-4 font-mono text-primary">./ofa g controller NAME</td>
-                                <td class="px-6 py-4 text-slate-600 dark:text-slate-400">Generates <code>app/controllers/{name}_controller.rb</code>.</td>
-                            </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g controller NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400">Generates <code>app/controllers/{name}_controller.rb</code>.</td>
+                             </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g api NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">JSON-based controller inheriting from ApiController.</td>
+                             </tr>
                             <tr>
                                 <td class="px-6 py-4 font-mono text-primary">./ofa g model NAME</td>
                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400">Creates model & migration linked to Sequel/NoSQL.</td>
                             </tr>
-                            <tr>
-                                <td class="px-6 py-4 font-mono text-primary">./ofa g migration NAME</td>
-                                <td class="px-6 py-4 text-slate-600 dark:text-slate-400">Creates timestamped migration in <code>db/migrations/</code>.</td>
-                            </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g migration NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Creates timestamped migration in <code>db/migrations/</code>.</td>
+                             </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g mailer NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Generates mailer class and ERB templates.</td>
+                             </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g task NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Creates a background task in <code>lib/tasks/</code>.</td>
+                             </tr>
+                             <tr>
+                                 <td class="px-6 py-4 font-mono text-primary">./ofa g test NAME</td>
+                                 <td class="px-6 py-4 text-slate-600 dark:text-slate-400 text-xs">Generates a Minitest unit test file.</td>
+                             </tr>
 
                             <tr class="bg-slate-500/5"><td colspan="2" class="px-6 py-2 text-[10px] font-black uppercase tracking-tighter text-slate-400">Customization</td></tr>
                             <tr>
@@ -310,6 +333,78 @@ resources :posts
                 </div>
             </section>
 
+            <!-- API & Modern Web -->
+            <section id="api" class="glass-panel p-8 md:p-12 text-left bg-gradient-to-br from-primary/10 to-transparent">
+                <h2 class="text-3xl font-black tracking-tight mb-6 flex items-center gap-3">
+                    <i class="fas fa-network-wired text-primary"></i> API & Modern Web
+                </h2>
+                <div class="markdown-content space-y-8">
+                    <div>
+                        <h4 class="font-bold text-lg mb-2">📡 JSON API Support</h4>
+                        <p class="text-sm text-slate-600 dark:text-slate-400">Build high-performance backends for mobile apps or SPAs. OFA provides a specialized <code>ApiController</code> and JSON rendering helpers.</p>
+                        <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mt-4 font-mono text-sm">
+                            ./ofa g api order
+                        </div>
+                    </div>
+
+                    <div>
+                        <h4 class="font-bold text-lg mb-2">🔐 JWT Authentication</h4>
+                        <p class="text-sm text-slate-600 dark:text-slate-400">Decoupled frontends require token-based auth. OFA automatically generates a <code>JWT_SECRET</code> during initialization and includes a <code>JwtMiddleware</code> to verify incoming requests.</p>
+                        <p class="text-[10px] text-slate-500 mt-2 italic">Note: Tokens are expected in the 'Authorization: Bearer <TOKEN>' header.</p>
+                    </div>
+
+                    <div>
+                        <h4 class="font-bold text-lg mb-2">📝 Swagger/OpenAPI Documentation</h4>
+                        <p class="text-sm text-slate-600 dark:text-slate-400">Keep your API documentation in sync with your code. The <code>ofa swagger</code> command scans your routes and generates a <code>openapi.json</code> file.</p>
+                        <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mt-4 font-mono text-sm">
+                            ./ofa swagger
+                        </div>
+                    </div>
+                </div>
+            </section>
+
+            <!-- Advanced Features -->
+            <section id="advanced" class="glass-panel p-8 md:p-12 text-left bg-gradient-to-br from-primary/10 to-transparent">
+                <h2 class="text-3xl font-black tracking-tight mb-6 flex items-center gap-3">
+                    <i class="fas fa-envelope text-primary"></i> Mailers & Tasks
+                </h2>
+                <div class="markdown-content space-y-8">
+                    <div>
+                        <h4 class="font-bold text-lg mb-2">📧 Email Mailers</h4>
+                        <p class="text-sm text-slate-600 dark:text-slate-400">Send transactional emails with ease using ERB templates. Mailers are stored in <code>app/mailers</code> and templates in <code>app/views/mailers</code>.</p>
+                        <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mt-4 font-mono text-sm">
+                            ./ofa g mailer welcome signup
+                        </div>
+                    </div>
+
+                    <div>
+                        <h4 class="font-bold text-lg mb-2">⚙️ Background Tasks</h4>
+                        <p class="text-sm text-slate-600 dark:text-slate-400">Run long-running processes or scheduled jobs using the Task runner. Defined in <code>lib/tasks/</code>.</p>
+                        <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mt-4 font-mono text-sm">
+                            ./ofa g task sync_data<br>
+                            ./ofa task sync_data
+                        </div>
+                    </div>
+                </div>
+            </section>
+
+            <!-- Testing -->
+            <section id="testing" class="glass-panel p-8 md:p-12 text-left">
+                <h2 class="text-3xl font-black tracking-tight mb-6 flex items-center gap-3">
+                    <i class="fas fa-vial text-primary"></i> Automated Testing
+                </h2>
+                <div class="markdown-content">
+                    <p class="text-slate-600 dark:text-slate-400 mb-6">OFA integrates <strong>Minitest</strong> out-of-the-box for reliable application testing. Run all your tests with a single command.</p>
+                    <div class="p-4 bg-slate-900 rounded-2xl font-mono text-sm text-green-400 mb-6">
+                        ./ofa test
+                    </div>
+                    <p class="text-sm text-slate-500">To create a new test file:</p>
+                    <div class="p-4 bg-white/5 border border-white/10 rounded-2xl mt-2 font-mono text-sm">
+                        ./ofa g test user_profile
+                    </div>
+                </div>
+            </section>
+
             <!-- Deployment -->
             <section id="deploy" class="glass-panel p-8 md:p-12 text-left border-primary/20">
                 <h2 class="text-3xl font-black tracking-tight mb-6 flex items-center gap-3">

data/app/views/index.erb

@@ -1,6 +1,6 @@
 <div class="text-center space-y-6 max-w-2xl mx-auto py-12">
     <div class="inline-flex items-center px-4 py-1.5 rounded-full bg-primary/10 border border-primary/20 text-primary text-xs font-bold uppercase tracking-wider animate-pulse">
-        Framework Version 4.2.0
+        Framework Version 4.4.0
     </div>
     
     <h1 class="text-5xl md:text-7xl font-black tracking-tight leading-tight">

data/bin/ofa

@@ -1,5 +1,16 @@
 #!/usr/bin/env ruby
 
+# --- Bundler Setup ---
+# This ensures that if we are in a project with a Gemfile, we use the correct 
+# gem versions specified in Gemfile.lock, preventing conflicts with system gems.
+if File.exist?(File.join(Dir.pwd, 'Gemfile'))
+  begin
+    require 'bundler/setup'
+  rescue LoadError
+    # Bundler not installed, proceed without it
+  end
+end
+
 require 'fileutils'
 require 'optparse'
 require 'json'
@@ -22,7 +33,7 @@ def help
   puts "  / __ \\/ ____/  /   |                      "
   puts " / / / / /_     / /| |  Framework           "
   puts "/ /_/ / __/    / ___ |  Premium MVC         "
-  puts "\\____/_/      /_/  |_|  v4.2.0              "
+  puts "\\____/_/      /_/  |_|  v4.4.0              "
   puts "                                            "
   puts "✨ One-For-All Framework CLI ✨"
   puts "-----------------------------"
@@ -30,8 +41,12 @@ def help
   puts "  ofa new NAME [TYPE]   - Create a new project + automatic bundle install"
   puts "  ofa init [TYPE]       - Initialize project in current folder"
   puts "  ofa g controller NAME - Generate a new controller"
+  puts "  ofa g api NAME        - Generate a new API controller (JSON)"
   puts "  ofa g model NAME      - Generate a new model"
   puts "  ofa g migration NAME  - Generate a new migration"
+  puts "  ofa g mailer NAME ACTION - Generate a new mailer and template"
+  puts "  ofa g task NAME       - Generate a new background task"
+  puts "  ofa g test NAME       - Generate a new unit test"
   puts "  ofa g post TITLE      - Create a new post [args: --category, --author, --image]"
   puts "  ofa feature ACTION F  - Toggle features: action=enable/disable, F=cms/auth/rich_text"
   puts "  ofa type NAME         - Set application type: portfolio, blog, landing_page, e_commerce"
@@ -45,6 +60,9 @@ def help
   puts "  ofa console           - Start interactive REPL session"
   puts "  ofa doctor            - Check system health (DB, config, gems)"
   puts "  ofa routes            - List all registered routes"
+  puts "  ofa swagger           - Auto-generate OpenAPI/Swagger documentation"
+  puts "  ofa task NAME         - Run a background task"
+  puts "  ofa test              - Run all application tests"
   puts "  ofa run               - Start the application server"
   puts "  ofa deploy            - Deploy project to production"
   puts "-----------------------------"
@@ -229,7 +247,7 @@ when 'init'
   puts "  / __ \\/ ____/  /   |                      "
   puts " / / / / /_     / /| |  Framework           "
   puts "/ /_/ / __/    / ___ |  Premium MVC         "
-  puts "\\____/_/      /_/  |_|  v4.2.0              "
+  puts "\\____/_/      /_/  |_|  v4.4.0              "
   puts "                                            "
   puts "Initializing One-For-All project as '#{app_type}' in #{PROJECT_ROOT}..."
 
@@ -260,7 +278,7 @@ when 'init'
   puts "-----------------------------\n"
 
   # Create directories
-  dirs = ['app/controllers', 'app/models', 'app/views', 'config', 'db/migrations', 'public/css', 'public/js', 'public/images', 'public/images/uploads']
+  dirs = ['app/controllers', 'app/models', 'app/views', 'app/mailers', 'lib/tasks', 'test', 'config', 'db/migrations', 'public/css', 'public/js', 'public/images', 'public/images/uploads']
   dirs.each { |dir| FileUtils.mkdir_p(File.join(PROJECT_ROOT, dir)) }
   
   # Copy framework core migrations
@@ -272,11 +290,27 @@ when 'init'
     end
   end
 
+  # Copy framework core helpers and test assets
+  ['lib/task_helper.rb', 'app/mailers/application_mailer.rb', 'test/test_helper.rb'].each do |file|
+    src = File.join(FRAMEWORK_ROOT, file)
+    dest = File.join(PROJECT_ROOT, file)
+    FileUtils.mkdir_p(File.dirname(dest))
+    if File.exist?(src)
+      content = File.read(src)
+      # Inject FRAMEWORK_ROOT into test_helper.rb
+      if file == 'test/test_helper.rb'
+        content.gsub!("require_relative '../config/boot'", "$LOAD_PATH.unshift '#{FRAMEWORK_ROOT}'\nrequire 'config/boot'")
+      end
+      File.write(dest, content)
+    end
+  end
+
   # Create .env
   env_content = []
   env_content << "EKS_ENV=development"
   env_content << "DATABASE_URL=#{db_url}" if db_type == 'mongodb'
   env_content << "CLOUDINARY_URL=#{cloudinary_url}" if img_storage == 'cloudinary'
+  env_content << "JWT_SECRET=#{Array.new(32){[*'0'..'9',*'a'..'z',*'A'..'Z'].sample}.join}"
   File.write(File.join(PROJECT_ROOT, '.env'), env_content.join("\n"))
 
   # Create config.ru
@@ -294,6 +328,7 @@ when 'init'
     use EksCent::Middleware::ShowExceptions
     use EksCent::Middleware::Session, secret: EksCent.secret_key_base
     use AuthMiddleware
+    use JwtMiddleware
     use CSRFMiddleware
     use EksCent::Middleware::Static, root: 'public'
     use EksCent::Middleware::Logger
@@ -317,6 +352,8 @@ when 'init'
     gem 'mysql2'
     gem 'kramdown'
     gem 'kramdown-parser-gfm'
+    gem 'mail'
+    gem 'minitest'
   RUBY
   File.write(File.join(PROJECT_ROOT, 'Gemfile'), gemfile_content)
 
@@ -463,11 +500,90 @@ when 'g'
       class #{class_name} < ApplicationController
         def index
           # Logic for #{name}
+          render_json({ message: "Welcome to #{class_name}" })
         end
       end
     RUBY
     File.write(file_name, content)
     puts "Created: #{file_name}"
+  elsif sub == 'api' && name
+    class_name = name.capitalize + "Controller"
+    file_name = File.join(PROJECT_ROOT, "app/controllers/#{name.downcase}_controller.rb")
+    content = <<~RUBY
+      require_relative 'api_controller'
+
+      class #{class_name} < ApiController
+        # GET /api/#{name.downcase}
+        def index
+          render_json({ 
+            status: 'success', 
+            message: "API endpoint for #{name} ready",
+            data: [] 
+          })
+        end
+
+        # POST /api/#{name.downcase}
+        def create
+          # TODO: Implement creation logic
+          render_json({ status: 'success', message: "#{name} created" }, status: 201)
+        end
+      end
+    RUBY
+    File.write(file_name, content)
+    puts "Created API Controller: #{file_name}"
+    puts "💡 Don't forget to register it in config/routes.rb"
+  elsif sub == 'mailer' && name
+    action = ARGV.shift || 'welcome'
+    class_name = name.capitalize + "Mailer"
+    file_name = File.join(PROJECT_ROOT, "app/mailers/#{name.downcase}_mailer.rb")
+    content = <<~RUBY
+      class #{class_name} < ApplicationMailer
+        def #{action}(user)
+          mail(
+            to: user.email,
+            subject: "Welcome to our platform!",
+            template: "#{name.downcase}_mailer/#{action}",
+            locals: { user: user }
+          )
+        end
+      end
+    RUBY
+    File.write(file_name, content)
+    
+    # Create template
+    template_dir = File.join(PROJECT_ROOT, "app/views/mailers/#{name.downcase}_mailer")
+    FileUtils.mkdir_p(template_dir)
+    template_file = File.join(template_dir, "#{action}.erb")
+    File.write(template_file, "<h1>Hello <%= @user.username %></h1>\n<p>Welcome to One-For-All Framework!</p>")
+    
+    puts "Created Mailer: #{file_name}"
+    puts "Created Template: #{template_file}"
+  elsif sub == 'task' && name
+    dir_path = File.join(PROJECT_ROOT, "lib/tasks")
+    FileUtils.mkdir_p(dir_path)
+    file_name = File.join(dir_path, "#{name.downcase}.rb")
+    content = <<~RUBY
+      desc "Description for #{name} task"
+      task :#{name.downcase} do
+        puts "Running task: #{name}"
+        # Your background job logic here
+      end
+    RUBY
+    File.write(file_name, content)
+    puts "Created Task: #{file_name}"
+  elsif sub == 'test' && name
+    file_name = File.join(PROJECT_ROOT, "test/#{name.downcase}_test.rb")
+    content = <<~RUBY
+      require_relative 'test_helper'
+
+      class #{name.capitalize}Test < Minitest::Test
+        def test_example
+          assert true
+        end
+      end
+    RUBY
+    File.write(file_name, content)
+    puts "Created Test: #{file_name}"
   elsif sub == 'model' && name
     class_name = name.capitalize
     file_name = File.join(PROJECT_ROOT, "app/models/#{name.downcase}.rb")
@@ -504,7 +620,7 @@ when 'g'
     File.write(file_name, content)
     puts "Created post: #{file_name}"
   else
-    puts "Usage: ofa g [controller|model|migration|post] NAME"
+    puts "Usage: ofa g [controller|api|model|migration|mailer|task|test|post] NAME"
   end
 
 when 'feature'
@@ -514,7 +630,8 @@ when 'feature'
   config_path = File.join(PROJECT_ROOT, 'config', 'features.json')
   config = JSON.parse(File.read(config_path))
   config[feature] = (action == 'enable')
-  File.write(config_path, JSON.pretty_generate(config))
+  File.open("#{config_path}.tmp", 'w') { |f| f.write(JSON.pretty_generate(config)) }
+  File.rename("#{config_path}.tmp", config_path)
   puts "Feature '#{feature}' has been #{action}d."
   
   if action == 'enable' && feature == 'cms' && !config['auth']
@@ -533,7 +650,8 @@ when 'type'
   config_path = File.join(PROJECT_ROOT, 'config', 'features.json')
   config = JSON.parse(File.read(config_path))
   config['type'] = name
-  File.write(config_path, JSON.pretty_generate(config))
+  File.open("#{config_path}.tmp", 'w') { |f| f.write(JSON.pretty_generate(config)) }
+  File.rename("#{config_path}.tmp", config_path)
   puts "Application type set to '#{name}'."
 
 when 'theme'
@@ -546,7 +664,8 @@ when 'theme'
   config_path = File.join(PROJECT_ROOT, 'config', 'features.json')
   config = JSON.parse(File.read(config_path))
   config['theme'] = name
-  File.write(config_path, JSON.pretty_generate(config))
+  File.open("#{config_path}.tmp", 'w') { |f| f.write(JSON.pretty_generate(config)) }
+  File.rename("#{config_path}.tmp", config_path)
   puts "Application theme set to '#{name}'."
 
 when 'storage'
@@ -609,7 +728,8 @@ when 'db'
         env_lines = File.exist?(env_path) ? File.readlines(env_path) : []
         env_lines.reject! { |l| l.start_with?('DATABASE_URL=') }
         env_lines << "DATABASE_URL=#{db_name}\n"
-        File.write(env_path, env_lines.join)
+        File.open("#{env_path}.tmp", 'w') { |f| f.write(env_lines.join) }
+        File.rename("#{env_path}.tmp", env_path)
         puts "✅ Connection string saved to .env"
       end
     when 'sqlite'
@@ -617,7 +737,8 @@ when 'db'
     else
       config = { "adapter" => type, "host" => "localhost", "user" => "root", "password" => "", "database" => db_name || "one_for_all" }
     end
-    File.write(config_path, JSON.pretty_generate(config))
+    File.open("#{config_path}.tmp", 'w') { |f| f.write(JSON.pretty_generate(config)) }
+    File.rename("#{config_path}.tmp", config_path)
     puts "Switched to #{type} mode."
   when 'migrate'
     run_migrations
@@ -702,7 +823,7 @@ when 'console'
   puts "  / __ \\/ ____/  /   |                      "
   puts " / / / / /_     / /| |  Framework           "
   puts "/ /_/ / __/    / ___ |  Console (REPL)      "
-  puts "\\____/_/      /_/  |_|  v4.2.0              "
+  puts "\\____/_/      /_/  |_|  v4.4.0              "
   puts "                                            "
   puts "✨ Loading environment... (Type 'exit' to quit)"
   
@@ -736,6 +857,53 @@ when 'routes'
   end
   puts "--------------------------------------------------------"
 
+when 'swagger'
+  ensure_initialized!
+  puts "📝 Generating OpenAPI 3.0 documentation..."
+  
+  Object.const_set(:APP_ROOT, PROJECT_ROOT) unless defined?(APP_ROOT)
+  ENV['EKS_ENV'] = 'test'
+  require File.join(FRAMEWORK_ROOT, 'config', 'boot')
+  
+  openapi = {
+    openapi: "3.0.0",
+    info: {
+      title: "#{File.basename(PROJECT_ROOT)} API",
+      version: "1.0.0",
+      description: "Auto-generated by One-For-All Framework"
+    },
+    paths: {}
+  }
+  
+  if defined?(ROUTES)
+    routes_hash = ROUTES.instance_variable_get(:@routes)
+    routes_hash.each do |verb, list|
+      list.each do |r|
+        path = r[:path].gsub(/:(\w+)/, '{\1}') # Convert :id to {id}
+        openapi[:paths][path] ||= {}
+        openapi[:paths][path][verb.to_s.downcase] = {
+          summary: "Endpoint for #{path}",
+          responses: {
+            "200" => { description: "Successful response" }
+          }
+        }
+        
+        # Add parameters if dynamic path
+        if path.include?('{')
+          params = path.scan(/\{(\w+)\}/).flatten
+          openapi[:paths][path][verb.to_s.downcase][:parameters] = params.map do |p|
+            { name: p, in: "path", required: true, schema: { type: "string" } }
+          end
+        end
+      end
+    end
+  end
+  
+  output_path = File.join(PROJECT_ROOT, 'openapi.json')
+  File.write(output_path, JSON.pretty_generate(openapi))
+  puts "✅ Documentation saved to: #{output_path}"
+  puts "💡 You can paste this into https://editor.swagger.io to view it."
+
 when 'run'
   ensure_initialized!
   # Check for config.ru
@@ -767,6 +935,63 @@ when 'deploy'
     puts "   This framework supports deployment via Docker or Git Push."
   end
 
+when 'task'
+  ensure_initialized!
+  name = ARGV.shift
+  if name.nil?
+    puts "Usage: ofa task NAME"
+    # List available tasks
+    tasks_dir = File.join(PROJECT_ROOT, 'lib/tasks')
+    if Dir.exist?(tasks_dir)
+      puts "\nAvailable tasks:"
+      Dir.glob(File.join(tasks_dir, '*.rb')).each do |f|
+        puts "  - #{File.basename(f, '.rb')}"
+      end
+    end
+    exit 1
+  end
+  
+  # Load framework & app
+  Object.const_set(:APP_ROOT, PROJECT_ROOT) unless defined?(APP_ROOT)
+  require File.join(FRAMEWORK_ROOT, 'config', 'boot')
+  require File.join(FRAMEWORK_ROOT, 'lib', 'task_helper')
+  
+  # Load all tasks in lib/tasks
+  Dir.glob(File.join(PROJECT_ROOT, 'lib/tasks/*.rb')).each { |f| require f }
+  
+  run_task(name)
+
+when 'test'
+  ensure_initialized!
+  puts "🧪 Running tests..."
+  puts "------------------------------------------"
+  
+  # Set environment to test
+  ENV['EKS_ENV'] = 'test'
+  Object.const_set(:APP_ROOT, PROJECT_ROOT) unless defined?(APP_ROOT)
+  
+  # Add project root to load path
+  $LOAD_PATH.unshift PROJECT_ROOT
+  $LOAD_PATH.unshift File.join(PROJECT_ROOT, 'test')
+  
+  # Find all tests (support both _test.rb and _spec.rb)
+  if ARGV.empty?
+    test_files = Dir.glob(File.join(PROJECT_ROOT, 'test/**/{*_test.rb,*_spec.rb}'))
+  else
+    test_files = ARGV.map { |arg| File.expand_path(arg, PROJECT_ROOT) }
+  end
+  
+  if test_files.empty?
+    puts "❌ No tests found in test/ directory."
+    exit 1
+  end
+  
+  # Run them by requiring
+  test_files.each { |f| require f }
+
+  # Trigger EksaMination execution if available
+  EksaMination.run if defined?(EksaMination)
+
 else
   help
 end

data/config/boot.rb

@@ -4,6 +4,10 @@ Bundler.require(:default)
 require 'eks-cent'
 require 'json'
 require 'kramdown'
+begin
+  require 'jwt'
+rescue LoadError
+end
 
 # Basic project structure constants
 APP_ROOT ||= File.expand_path('..', __dir__)
@@ -75,6 +79,12 @@ module EksCent
       @headers['Content-Type'] ||= 'text/html'
       @body << result
     end
+
+    def json(data, status: 200)
+      @status = status
+      @headers['Content-Type'] = 'application/json'
+      @body << data.to_json
+    end
   end
 end
 
@@ -83,7 +93,7 @@ require_relative 'database'
 
 # Autoloading (Framework Core first, then APP_ROOT)
 framework_app = File.expand_path('../app', __dir__)
-['controllers', 'models', 'middleware', 'helpers'].each do |folder|
+['controllers', 'models', 'middleware', 'helpers', 'mailers'].each do |folder|
   next if folder == 'models' && ENV['SKIP_MODELS']
   loaded = []
   # Load framework core

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: one-for-all-framework
 version: !ruby/object:Gem::Version
-  version: 4.2.0
+  version: 4.4.0
 platform: ruby
 authors:
 - Ishikawa Uta
@@ -169,6 +169,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '1.1'
+- !ruby/object:Gem::Dependency
+  name: jwt
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.10'
 description: One-For-All is a high-performance Ruby web framework built for speed
   and aesthetics. It features a built-in CMS, premium Glassmorphism design, and supports
   multiple databases including SQLite, MySQL, and MongoDB.
@@ -196,8 +210,10 @@ files:
 - app/controllers/products_controller.rb
 - app/controllers/projects_controller.rb
 - app/helpers/cloudinary_helper.rb
+- app/mailers/application_mailer.rb
 - app/middleware/auth_middleware.rb
 - app/middleware/csrf_middleware.rb
+- app/middleware/jwt_middleware.rb
 - app/models/page.rb
 - app/models/post.rb
 - app/models/product.rb
@@ -239,7 +255,6 @@ files:
 - db/data.sqlite3
 - db/development.sqlite3
 - db/migrations/20260502000000_create_products.rb
-- db/target.sqlite3
 - ofa
 - public/css/cms.css
 - public/images/logo.jpg