respondo 2.1.2 → 2.1.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c72fa46b09dc6370fd885748d78c0a4cc878738fb994d43609edab1af1bee637
-  data.tar.gz: 47a068b005b488305b4bf30a096a38446015643a6650a5c71e7042fe5d49927d
+  metadata.gz: eac53474dd61508e20d695e46cc364e3bf9ebdb0b89a6e1b4ae93eda15ebc7b7
+  data.tar.gz: 8f1035182c1795269fe3266473bdf4b67bcfa56fcdaf10d6593c5e56739a955c
 SHA512:
-  metadata.gz: ed33945bff899f32f5f599bfeac0ed90906acafe2ddaa0ef8f19f8a1c24699839b9df78bcb033174e79bea720161bd3aa1a5841353193463ab69bbf329b2a9f0
-  data.tar.gz: ff5b519754b9ec2145feaf1611cd7ad29cfc2291f369781e131e175029025d507ad62fef92b4a6057ea2abf92cf77f3bacf6ae778b0f460f94fc6a810af76ce6
+  metadata.gz: b9540985dd09e11ee39c87cccccc13b9056f07cb762a8b6523a5e1a1666cdb4e0e8ca1ab6dfd9305706c5d48386c73bd5dfbabc070b05c7a1d92d08877fd5ba4
+  data.tar.gz: 53bdf553e918de4f9b4e0a3df8fc3fb894fcbe0efaae7a2daeaa97990a18974b8b80d18b094d2fa2f8f10c7098fae0c01067394c3b6be6fb45766e5f68dd04b3

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## [2.1.3] — Docs & Dependency Updates
+
+### Changed
+- README updated (add a one-line summary of what you changed)
+- Development dependencies updated to patched versions, fixing CVEs in
+  `concurrent-ruby`, `erb` and `rails-html-sanitizer`. These are test-only
+  dependencies, so there is no change to the gem's runtime behavior.
+
 ## [2.1.2] — Code Quality & Test Coverage
 
 ### Fixed

data/README.md

@@ -2,7 +2,7 @@
 
 # Respondo 🎯
 
-**Consistent JSON API responses for Rails — in one line.**
+Consistent JSON API responses for Rails, in one line.
 
 [![Gem Version](https://badge.fury.io/rb/respondo.svg)](https://rubygems.org/gems/respondo)
 [![Downloads](https://img.shields.io/gem/dt/respondo.svg)](https://rubygems.org/gems/respondo)
@@ -28,9 +28,9 @@ You're building an API consumed by a React frontend and a Flutter app. Three dev
 { "users": [...] }
 ```
 
-Your frontend devs are writing `if (res.data || res.result || res.users)`. Your Flutter devs are filing bugs. Your code reviews are arguments.
+Your frontend devs end up writing `if (res.data || res.result || res.users)` just to survive. The Front End team files bugs about the mismatch. Code review turns into an argument about whose format is "right."
 
-**Respondo fixes this permanently.** One response shape. Every controller. Every developer. Every time.
+Respondo fixes this: one response shape, enforced automatically across every controller. Every developer. Every time.
 
 ```json
 {
@@ -58,7 +58,7 @@ bundle install
 rails generate respondo:install
 ```
 
-That's it. No `include` in `ApplicationController`. No boilerplate. Respondo auto-injects via Railtie.
+That's it. No `include` in `ApplicationController`, no boilerplate — Respondo hooks in automatically via a Railtie.
 
 ---
 
@@ -87,11 +87,11 @@ class UsersController < ApplicationController
 end
 ```
 
-Your frontend now gets a **guaranteed** structure — forever.
+Now your frontend can count on getting the same shape back every time.
 
 ---
 
-## Why teams switch to Respondo
+## What changes
 
 | Without Respondo | With Respondo |
 |---|---|
@@ -100,13 +100,13 @@ Your frontend now gets a **guaranteed** structure — forever.
 | Pagination shape differs per endpoint | Pagination always in `meta.pagination` |
 | Validation errors in different keys | Always in `errors`, always a hash |
 | `render json:` boilerplate in every action | One expressive method call |
-| camelCase conversion scattered across code | `config.camelize_keys = true` — done |
+| camelCase conversion scattered across code | `config.camelize_keys = true`, done |
 
 ---
 
 ## What every response looks like
 
-Every response — success or error — has the same four keys:
+Every response, success or error, has the same four keys:
 
 | Key | Type | Description |
 |---|---|---|
@@ -189,12 +189,12 @@ class PostsController < ApplicationController
 end
 ```
 
-## Auto-Serialization
+## Auto-serialization
 
 Respondo automatically handles:
 
 | Input type                       | Output                              |
-|----------------------------------|-------------------------------------|
+|----------------------------------|--------------------------------------|
 | `ActiveRecord::Base` instance    | `record.as_json`                    |
 | `ActiveRecord::Relation`         | Array of `as_json` records          |
 | `ActiveModel::Errors`            | `{ field: ["message", ...] }`       |
@@ -252,7 +252,7 @@ config.serializer = ->(obj) { MySerializer.new(obj).as_json }
 
 ## Global error handling (recommended pattern)
 
-Add this to `ApplicationController` to handle exceptions app-wide without try/rescue in every action:
+Add this to `ApplicationController` to handle exceptions app-wide without a try/rescue in every action:
 
 ```ruby
 class ApplicationController < ActionController::API
@@ -275,7 +275,7 @@ end
 
 ## Complete HTTP helper reference
 
-Respondo covers every HTTP status code. Here are the helpers you'll use every day:
+There's a helper for basically every HTTP status code. Here are the ones you'll actually reach for:
 
 ### 2xx — Success
 
@@ -286,7 +286,7 @@ Respondo covers every HTTP status code. Here are the helpers you'll use every da
 | `render_accepted` | 202 | Async jobs — request queued |
 | `render_no_content` | 200* | After DELETE — no body |
 
-> *Rails renders 200 with a JSON body for `render_no_content` to preserve consistent structure.
+> *Rails renders 200 with a JSON body for `render_no_content` to keep the response shape consistent.
 
 ```ruby
 render_ok(data: @user, message: "Profile fetched")
@@ -422,5 +422,8 @@ Released under the [MIT License](LICENSE).
 ---
 
 <div align="center">
-  <sub>If Respondo saved you an hour, give it a ⭐ — it helps other developers find it.</sub>
+  <sub>If Respondo saved your an hour, give it a Star⭐.</sub>
+</div>
+<div align="center">
+  <sub>it helps other developers find it.</sub>
 </div>

data/lib/generators/respondo/install/install_generator.rb

@@ -1,352 +1,352 @@
-# frozen_string_literal: true
-
-require "rails/generators"
-
-module Respondo
-  module Generators
-    class InstallGenerator < Rails::Generators::Base
-      desc "Interactive setup — creates config/initializers/respondo.rb with your preferences."
-
-      # We bypass Thor's `say` entirely for all display output and use
-      # $stdout.puts / print directly. This prevents Thor from re-echoing
-      # buffered output and causing duplicate lines in the terminal.
-
-      def run_interactive_setup
-        # out LOGO
-        out logo_with_version
-        out divider
-        out line("  This wizard will generate config/initializers/respondo.rb")
-        out line("  tailored to your project — no need to read the full README.")
-        out blank
-        out line(yellow("  All settings can be changed later by editing the initializer."))
-        out divider
-        out blank
-
-        unless confirm("  Ready to configure Respondo? (y/n) ")
-          out blank
-          out line(yellow("  Skipped. Run this again any time:"))
-          out line("    rails generate respondo:install")
-          out blank
-          return
-        end
-
-        @cfg = {}
-
-        step_project_info
-        step_messages
-        step_request_id
-        step_camelize
-        step_default_meta
-        step_serializer
-
-        print_summary
-        write_initializer
-        print_done
-      end
-
-      private
-
-      # =========================================================================
-      # Steps
-      # =========================================================================
-
-      def step_project_info
-        out section("Project Info")
-        out line("  Project / app name")
-        out line(yellow("  (Used as a comment header in the initializer)"))
-        @cfg[:project_name] = prompt_default(Rails.application.class.module_parent_name)
-
-        out blank
-        out line("  API version")
-        out line(yellow("  (e.g. v1 — added to every response meta block)"))
-        @cfg[:api_version] = prompt_default("v1")
-      end
-
-      def step_messages
-        out section("Response Messages")
-        out line("  Fallback messages used when you don't pass message: explicitly.")
-        out blank
-
-        out line("  Default success message")
-        @cfg[:default_success_message] = prompt_default("Success")
-
-        out blank
-        out line("  Default error message")
-        @cfg[:default_error_message] = prompt_default("An error occurred")
-      end
-
-      def step_request_id
-        out section("Request ID")
-        out line("  When enabled, Rails request.request_id is included in every")
-        out line("  response meta block — useful for log correlation and debugging.")
-        out blank
-        @cfg[:include_request_id] = confirm("  Include request_id in every response? (y/n) ")
-      end
-
-      def step_camelize
-        out section("Key Format")
-        out line("  When enabled, all JSON keys are camelCased:")
-        out line(yellow('    { "createdAt": "...", "userId": 1 }'))
-        out line("  Recommended for Flutter, React, and JavaScript clients.")
-        out blank
-        @cfg[:camelize_keys] = confirm("  Camelize all response keys? (y/n) ")
-      end
-
-      def step_default_meta
-        out section("Global Meta Fields")
-        out line("  Static key=value pairs merged into the meta block of EVERY response.")
-        out line("  Example:  platform=mobile   environment=production")
-        out blank
-        out line(yellow("  Note: api_version from above is already included automatically."))
-        out blank
-
-        @cfg[:default_meta] = {}
-        return unless confirm("  Add extra global meta fields? (y/n) ")
-
-        out blank
-        out line("  Enter key=value one at a time. Blank line to finish.")
-        out blank
-
-        loop do
-          $stdout.print cyan("    key=value › ")
-          raw = $stdin.gets.to_s.strip
-          break if raw.empty?
-
-          unless raw.include?("=")
-            out line(yellow("    Use key=value format (e.g. platform=mobile). Skipping."))
-            next
-          end
-
-          key, value = raw.split("=", 2)
-
-          next out line(yellow("    Use key=value format.")) if key.nil? || key.strip.empty?
-
-          k = key.strip
-          v = (value || "").strip
-          @cfg[:default_meta][k] = v
-          out line(green("    ✓  #{k}: #{v.inspect}"))
-        end
-      end
-
-      def step_serializer
-        out section("Custom Serializer")
-        out line("  By default Respondo serializes ActiveRecord models, collections,")
-        out line("  hashes, and arrays automatically.")
-        out blank
-        out line("  You can override with any callable: ->(obj) { MySerializer.new(obj).as_json }")
-        out blank
-        @cfg[:custom_serializer] = confirm("  Add a custom serializer stub? (y/n) ")
-      end
-
-      # =========================================================================
-      # Summary
-      # =========================================================================
-
-      def print_summary
-        out blank
-        out divider
-        out line(cyan("  Configuration Summary"))
-        out divider
-        out blank
-        summary_row "Project",            @cfg[:project_name]
-        summary_row "API version",        @cfg[:api_version]
-        summary_row "Success message",    @cfg[:default_success_message]
-        summary_row "Error message",      @cfg[:default_error_message]
-        summary_row "Include request_id", @cfg[:include_request_id]
-        summary_row "Camelize keys",      @cfg[:camelize_keys]
-        summary_row "Custom serializer",  @cfg[:custom_serializer]
-
-        unless @cfg[:default_meta].empty?
-          out blank
-          out line("  Global meta:")
-          @cfg[:default_meta].each { |k, v| out line("    #{k}: #{v.inspect}") }
-        end
-
-        out blank
-        out divider
-        out blank
-      end
-
-      def summary_row(label, value)
-        bool_true = value == true
-        val_str   = bool_true ? green(value.inspect) : yellow(value.inspect)
-        out "  #{("#{label}:").ljust(24)}#{val_str}\n"
-      end
-
-      # =========================================================================
-      # Write file
-      # =========================================================================
-
-      def write_initializer
-        dir  = File.join(destination_root, "config", "initializers")
-        path = File.join(dir, "respondo.rb")
-        FileUtils.mkdir_p(dir)
-        File.write(path, build_content)
-        out line(green("  ✅  Created config/initializers/respondo.rb"))
-        out blank
-      end
-
-      def build_content
-        # meta = { "api_version" => @cfg[:api_version] }.merge(@cfg[:default_meta])
-        meta = @cfg[:default_meta].dup
-        meta["api_version"] = @cfg[:api_version] unless @cfg[:api_version].to_s.empty?
-        b    = Lines.new
-
-        b << "# frozen_string_literal: true"
-        b << ""
-        b << "# Respondo initializer — #{@cfg[:project_name]}"
-        b << "# Generated by: rails generate respondo:install"
-        b << "# Respondo version: #{Respondo::VERSION}"
-        b << "# Docs: https://github.com/your-org/respondo"
-        b << ""
-        b << "Respondo.configure do |config|"
-        b << ""
-        b << "  # ── Messages ─────────────────────────────────────────────────────────"
-        b << "  # Fallback when render_success / render_error is called without message:"
-        b << "  config.default_success_message = #{@cfg[:default_success_message].inspect}"
-        b << "  config.default_error_message   = #{@cfg[:default_error_message].inspect}"
-        b << ""
-        b << "  # ── Request ID ───────────────────────────────────────────────────────"
-        b << "  # Includes Rails request.request_id in every response meta block."
-        b << "  config.include_request_id = #{@cfg[:include_request_id]}"
-        b << ""
-        b << "  # ── Key Format ───────────────────────────────────────────────────────"
-        b << "  # CamelCase all JSON keys — recommended for Flutter / JS clients."
-        b << "  config.camelize_keys = #{@cfg[:camelize_keys]}"
-        b << ""
-        b << "  # ── Global Meta ──────────────────────────────────────────────────────"
-        b << "  # Static fields merged into the meta block of every response."
-
-        if meta.empty?
-          b << "  config.default_meta = {}"
-        else
-          b << "  config.default_meta = {"
-          meta.each_with_index do |(k, v), i|
-            comma = i < meta.size - 1 ? "," : ""
-            b << "    #{k}: #{v.inspect}#{comma}"
-          end
-          b << "  }"
-        end
-
-        if @cfg[:custom_serializer]
-          b << ""
-          b << "  # ── Custom Serializer ────────────────────────────────────────────────"
-          b << "  # Replace the lambda body with your own serialization logic."
-          b << "  # Examples:"
-          b << "  #   ActiveModelSerializers: ->(obj) { SomeSerializer.new(obj).as_json }"
-          b << "  #   Blueprinter:            ->(obj) { UserBlueprint.render_as_hash(obj) }"
-          b << "  #"
-          b << "  # config.serializer = ->(obj) { MySerializer.new(obj).as_json }"
-        end
-
-        b << ""
-        b << "end"
-        b << ""
-        b.to_s
-      end
-
-      # =========================================================================
-      # Done
-      # =========================================================================
-
-      def print_done
-        out divider
-        out blank
-        out line(cyan("  🎉  Respondo is ready!"))
-        out blank
-        out line("  Next steps:")
-        out line("    1. Review   config/initializers/respondo.rb")
-        out line("    2. Use      render_success / render_error in your controllers")
-        out line("    3. Re-run   rails generate respondo:install  to regenerate")
-        out blank
-        out divider
-        out blank
-      end
-
-      # =========================================================================
-      # Output primitives — all output goes through $stdout, never through Thor
-      # =========================================================================
-
-      def out(str)
-        $stdout.print str
-        $stdout.flush
-      end
-
-      def line(str) = "#{str}\n"
-      def blank     = "\n"
-
-      def divider
-        "  #{cyan("─" * 68)}\n"
-      end
-
-      def section(title)
-        dashes = "─" * [0, 54 - title.length].max
-        "\n  #{cyan("┌─ #{title} #{dashes}┐")}\n\n"
-      end
-
-      def prompt_default(default)
-        $stdout.print "  #{cyan("›")} #{yellow("[#{default}]")}: "
-        $stdout.flush
-        result = $stdin.gets.to_s.strip
-        result.empty? ? default.to_s : result
-      end
-
-      def confirm(question)
-        $stdout.print question
-        $stdout.flush
-        $stdin.gets.to_s.strip.downcase.start_with?("y")
-      end
-
-      # =========================================================================
-      # ANSI colors
-      # =========================================================================
-
-      def cyan(t)   = "\e[36m#{t}\e[0m"
-      def green(t)  = "\e[32m#{t}\e[0m"
-      def yellow(t) = "\e[33m#{t}\e[0m"
-
-      # =========================================================================
-      # ASCII logo
-      # =========================================================================
-
-      LOGOS = <<~'LOGO'
-
-          ██████╗ ███████╗███████╗██████╗  ██████╗ ███╗   ██╗██████╗  ██████╗
-          ██╔══██╗██╔════╝██╔════╝██╔══██╗██╔═══██╗████╗  ██║██╔══██╗██╔═══██╗
-          ██████╔╝█████╗  ███████╗██████╔╝██║   ██║██╔██╗ ██║██║  ██║██║   ██║
-          ██╔══██╗██╔══╝  ╚════██║██╔═══╝ ██║   ██║██║╚██╗██║██║  ██║██║   ██║
-          ██║  ██║███████╗███████║██║     ╚██████╔╝██║ ╚████║██████╔╝╚██████╔╝
-          ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═════╝  ╚═════╝
-
-                        Smart JSON API Response Formatter for Rails
-                                     ─── v#{Respondo::VERSION} ───
-
-      LOGO
-
-      def logo_with_version
-        green(<<~LOGO)
-          
-          ██████╗ ███████╗███████╗██████╗  ██████╗ ███╗   ██╗██████╗  ██████╗
-          ██╔══██╗██╔════╝██╔════╝██╔══██╗██╔═══██╗████╗  ██║██╔══██╗██╔═══██╗
-          ██████╔╝█████╗  ███████╗██████╔╝██║   ██║██╔██╗ ██║██║  ██║██║   ██║
-          ██╔══██╗██╔══╝  ╚════██║██╔═══╝ ██║   ██║██║╚██╗██║██║  ██║██║   ██║
-          ██║  ██║███████╗███████║██║     ╚██████╔╝██║ ╚████║██████╔╝╚██████╔╝
-          ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═════╝  ╚═════╝
-
-                      Smart JSON API Response Formatter for Rails
-                                ─── v#{Respondo::VERSION} ───
-
-        LOGO
-      end
-      # =========================================================================
-      # Simple line buffer for building file content
-      # =========================================================================
-
-      class Lines
-        def initialize = (@buf = [])
-        def <<(str)    = @buf << str
-        def to_s       = @buf.join("\n") + "\n"
-      end
-    end
-  end
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Respondo
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      desc "Interactive setup — creates config/initializers/respondo.rb with your preferences."
+
+      # We bypass Thor's `say` entirely for all display output and use
+      # $stdout.puts / print directly. This prevents Thor from re-echoing
+      # buffered output and causing duplicate lines in the terminal.
+
+      def run_interactive_setup
+        # out LOGO
+        out logo_with_version
+        out divider
+        out line("  This wizard will generate config/initializers/respondo.rb")
+        out line("  tailored to your project — no need to read the full README.")
+        out blank
+        out line(yellow("  All settings can be changed later by editing the initializer."))
+        out divider
+        out blank
+
+        unless confirm("  Ready to configure Respondo? (y/n) ")
+          out blank
+          out line(yellow("  Skipped. Run this again any time:"))
+          out line("    rails generate respondo:install")
+          out blank
+          return
+        end
+
+        @cfg = {}
+
+        step_project_info
+        step_messages
+        step_request_id
+        step_camelize
+        step_default_meta
+        step_serializer
+
+        print_summary
+        write_initializer
+        print_done
+      end
+
+      private
+
+      # =========================================================================
+      # Steps
+      # =========================================================================
+
+      def step_project_info
+        out section("Project Info")
+        out line("  Project / app name")
+        out line(yellow("  (Used as a comment header in the initializer)"))
+        @cfg[:project_name] = prompt_default(Rails.application.class.module_parent_name)
+
+        out blank
+        out line("  API version")
+        out line(yellow("  (e.g. v1 — added to every response meta block)"))
+        @cfg[:api_version] = prompt_default("v1")
+      end
+
+      def step_messages
+        out section("Response Messages")
+        out line("  Fallback messages used when you don't pass message: explicitly.")
+        out blank
+
+        out line("  Default success message")
+        @cfg[:default_success_message] = prompt_default("Success")
+
+        out blank
+        out line("  Default error message")
+        @cfg[:default_error_message] = prompt_default("An error occurred")
+      end
+
+      def step_request_id
+        out section("Request ID")
+        out line("  When enabled, Rails request.request_id is included in every")
+        out line("  response meta block — useful for log correlation and debugging.")
+        out blank
+        @cfg[:include_request_id] = confirm("  Include request_id in every response? (y/n) ")
+      end
+
+      def step_camelize
+        out section("Key Format")
+        out line("  When enabled, all JSON keys are camelCased:")
+        out line(yellow('    { "createdAt": "...", "userId": 1 }'))
+        out line("  Recommended for Flutter, React, and JavaScript clients.")
+        out blank
+        @cfg[:camelize_keys] = confirm("  Camelize all response keys? (y/n) ")
+      end
+
+      def step_default_meta
+        out section("Global Meta Fields")
+        out line("  Static key=value pairs merged into the meta block of EVERY response.")
+        out line("  Example:  platform=mobile   environment=production")
+        out blank
+        out line(yellow("  Note: api_version from above is already included automatically."))
+        out blank
+
+        @cfg[:default_meta] = {}
+        return unless confirm("  Add extra global meta fields? (y/n) ")
+
+        out blank
+        out line("  Enter key=value one at a time. Blank line to finish.")
+        out blank
+
+        loop do
+          $stdout.print cyan("    key=value › ")
+          raw = $stdin.gets.to_s.strip
+          break if raw.empty?
+
+          unless raw.include?("=")
+            out line(yellow("    Use key=value format (e.g. platform=mobile). Skipping."))
+            next
+          end
+
+          key, value = raw.split("=", 2)
+
+          next out line(yellow("    Use key=value format.")) if key.nil? || key.strip.empty?
+
+          k = key.strip
+          v = (value || "").strip
+          @cfg[:default_meta][k] = v
+          out line(green("    ✓  #{k}: #{v.inspect}"))
+        end
+      end
+
+      def step_serializer
+        out section("Custom Serializer")
+        out line("  By default Respondo serializes ActiveRecord models, collections,")
+        out line("  hashes, and arrays automatically.")
+        out blank
+        out line("  You can override with any callable: ->(obj) { MySerializer.new(obj).as_json }")
+        out blank
+        @cfg[:custom_serializer] = confirm("  Add a custom serializer stub? (y/n) ")
+      end
+
+      # =========================================================================
+      # Summary
+      # =========================================================================
+
+      def print_summary
+        out blank
+        out divider
+        out line(cyan("  Configuration Summary"))
+        out divider
+        out blank
+        summary_row "Project",            @cfg[:project_name]
+        summary_row "API version",        @cfg[:api_version]
+        summary_row "Success message",    @cfg[:default_success_message]
+        summary_row "Error message",      @cfg[:default_error_message]
+        summary_row "Include request_id", @cfg[:include_request_id]
+        summary_row "Camelize keys",      @cfg[:camelize_keys]
+        summary_row "Custom serializer",  @cfg[:custom_serializer]
+
+        unless @cfg[:default_meta].empty?
+          out blank
+          out line("  Global meta:")
+          @cfg[:default_meta].each { |k, v| out line("    #{k}: #{v.inspect}") }
+        end
+
+        out blank
+        out divider
+        out blank
+      end
+
+      def summary_row(label, value)
+        bool_true = value == true
+        val_str   = bool_true ? green(value.inspect) : yellow(value.inspect)
+        out "  #{("#{label}:").ljust(24)}#{val_str}\n"
+      end
+
+      # =========================================================================
+      # Write file
+      # =========================================================================
+
+      def write_initializer
+        dir  = File.join(destination_root, "config", "initializers")
+        path = File.join(dir, "respondo.rb")
+        FileUtils.mkdir_p(dir)
+        File.write(path, build_content)
+        out line(green("  ✅  Created config/initializers/respondo.rb"))
+        out blank
+      end
+
+      def build_content
+        # meta = { "api_version" => @cfg[:api_version] }.merge(@cfg[:default_meta])
+        meta = @cfg[:default_meta].dup
+        meta["api_version"] = @cfg[:api_version] unless @cfg[:api_version].to_s.empty?
+        b    = Lines.new
+
+        b << "# frozen_string_literal: true"
+        b << ""
+        b << "# Respondo initializer — #{@cfg[:project_name]}"
+        b << "# Generated by: rails generate respondo:install"
+        b << "# Respondo version: #{Respondo::VERSION}"
+        b << "# Docs: https://github.com/spatelpatidar/respondo"
+        b << ""
+        b << "Respondo.configure do |config|"
+        b << ""
+        b << "  # ── Messages ─────────────────────────────────────────────────────────"
+        b << "  # Fallback when render_success / render_error is called without message:"
+        b << "  config.default_success_message = #{@cfg[:default_success_message].inspect}"
+        b << "  config.default_error_message   = #{@cfg[:default_error_message].inspect}"
+        b << ""
+        b << "  # ── Request ID ───────────────────────────────────────────────────────"
+        b << "  # Includes Rails request.request_id in every response meta block."
+        b << "  config.include_request_id = #{@cfg[:include_request_id]}"
+        b << ""
+        b << "  # ── Key Format ───────────────────────────────────────────────────────"
+        b << "  # CamelCase all JSON keys — recommended for Flutter / JS clients."
+        b << "  config.camelize_keys = #{@cfg[:camelize_keys]}"
+        b << ""
+        b << "  # ── Global Meta ──────────────────────────────────────────────────────"
+        b << "  # Static fields merged into the meta block of every response."
+
+        if meta.empty?
+          b << "  config.default_meta = {}"
+        else
+          b << "  config.default_meta = {"
+          meta.each_with_index do |(k, v), i|
+            comma = i < meta.size - 1 ? "," : ""
+            b << "    #{k}: #{v.inspect}#{comma}"
+          end
+          b << "  }"
+        end
+
+        if @cfg[:custom_serializer]
+          b << ""
+          b << "  # ── Custom Serializer ────────────────────────────────────────────────"
+          b << "  # Replace the lambda body with your own serialization logic."
+          b << "  # Examples:"
+          b << "  #   ActiveModelSerializers: ->(obj) { SomeSerializer.new(obj).as_json }"
+          b << "  #   Blueprinter:            ->(obj) { UserBlueprint.render_as_hash(obj) }"
+          b << "  #"
+          b << "  # config.serializer = ->(obj) { MySerializer.new(obj).as_json }"
+        end
+
+        b << ""
+        b << "end"
+        b << ""
+        b.to_s
+      end
+
+      # =========================================================================
+      # Done
+      # =========================================================================
+
+      def print_done
+        out divider
+        out blank
+        out line(cyan("  🎉  Respondo is ready!"))
+        out blank
+        out line("  Next steps:")
+        out line("    1. Review   config/initializers/respondo.rb")
+        out line("    2. Use      render_success / render_error in your controllers")
+        out line("    3. Re-run   rails generate respondo:install  to regenerate")
+        out blank
+        out divider
+        out blank
+      end
+
+      # =========================================================================
+      # Output primitives — all output goes through $stdout, never through Thor
+      # =========================================================================
+
+      def out(str)
+        $stdout.print str
+        $stdout.flush
+      end
+
+      def line(str) = "#{str}\n"
+      def blank     = "\n"
+
+      def divider
+        "  #{cyan("─" * 68)}\n"
+      end
+
+      def section(title)
+        dashes = "─" * [0, 54 - title.length].max
+        "\n  #{cyan("┌─ #{title} #{dashes}┐")}\n\n"
+      end
+
+      def prompt_default(default)
+        $stdout.print "  #{cyan("›")} #{yellow("[#{default}]")}: "
+        $stdout.flush
+        result = $stdin.gets.to_s.strip
+        result.empty? ? default.to_s : result
+      end
+
+      def confirm(question)
+        $stdout.print question
+        $stdout.flush
+        $stdin.gets.to_s.strip.downcase.start_with?("y")
+      end
+
+      # =========================================================================
+      # ANSI colors
+      # =========================================================================
+
+      def cyan(t)   = "\e[36m#{t}\e[0m"
+      def green(t)  = "\e[32m#{t}\e[0m"
+      def yellow(t) = "\e[33m#{t}\e[0m"
+
+      # =========================================================================
+      # ASCII logo
+      # =========================================================================
+
+      LOGOS = <<~'LOGO'
+
+          ██████╗ ███████╗███████╗██████╗  ██████╗ ███╗   ██╗██████╗  ██████╗
+          ██╔══██╗██╔════╝██╔════╝██╔══██╗██╔═══██╗████╗  ██║██╔══██╗██╔═══██╗
+          ██████╔╝█████╗  ███████╗██████╔╝██║   ██║██╔██╗ ██║██║  ██║██║   ██║
+          ██╔══██╗██╔══╝  ╚════██║██╔═══╝ ██║   ██║██║╚██╗██║██║  ██║██║   ██║
+          ██║  ██║███████╗███████║██║     ╚██████╔╝██║ ╚████║██████╔╝╚██████╔╝
+          ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═════╝  ╚═════╝
+
+                        Smart JSON API Response Formatter for Rails
+                                     ─── v#{Respondo::VERSION} ───
+
+      LOGO
+
+      def logo_with_version
+        green(<<~LOGO)
+          
+          ██████╗ ███████╗███████╗██████╗  ██████╗ ███╗   ██╗██████╗  ██████╗
+          ██╔══██╗██╔════╝██╔════╝██╔══██╗██╔═══██╗████╗  ██║██╔══██╗██╔═══██╗
+          ██████╔╝█████╗  ███████╗██████╔╝██║   ██║██╔██╗ ██║██║  ██║██║   ██║
+          ██╔══██╗██╔══╝  ╚════██║██╔═══╝ ██║   ██║██║╚██╗██║██║  ██║██║   ██║
+          ██║  ██║███████╗███████║██║     ╚██████╔╝██║ ╚████║██████╔╝╚██████╔╝
+          ╚═╝  ╚═╝╚══════╝╚══════╝╚═╝      ╚═════╝ ╚═╝  ╚═══╝╚═════╝  ╚═════╝
+
+                      Smart JSON API Response Formatter for Rails
+                                ─── v#{Respondo::VERSION} ───
+
+        LOGO
+      end
+      # =========================================================================
+      # Simple line buffer for building file content
+      # =========================================================================
+
+      class Lines
+        def initialize = (@buf = [])
+        def <<(str)    = @buf << str
+        def to_s       = @buf.join("\n") + "\n"
+      end
+    end
+  end
 end

data/lib/respondo/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Respondo
-  VERSION = "2.1.2"
+  VERSION = "2.1.3"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: respondo
 version: !ruby/object:Gem::Version
-  version: 2.1.2
+  version: 2.1.3
 platform: ruby
 authors:
 - shailendra Kumar
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-05-13 00:00:00.000000000 Z
+date: 2026-10-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: railties