stomp_base 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f766bad393da3ae69fa86a14e37ddd0757eb933c47b209b2ece04e2bc17ad7f0
-  data.tar.gz: cd1caea93843548baba429391a50b4cfac2852b0be1c5ff4534f38317df35c63
+  metadata.gz: 8b134d98cdd58b0e0f96d5045fdc83e9bc07379cd95e2bae7a7ee462d5ec9cc4
+  data.tar.gz: 3b1f9f0e9aada4b215c1c2d9277af0478a447ab309492004d76ab43a91171761
 SHA512:
-  metadata.gz: 4358c4e43a782e99b8c13d31ae7f00e3124b70a0db5ccb3c804cbebc68ac5b09960eaa22b6c388420e8dd9caeba08f0bc9d3390cc8b783ad4c7e43daf65558b9
-  data.tar.gz: 764692e137d6292629990b71f87a6e8952161a96fad790d0fe6ebbbdeae3e9133bfe7fe493e85d127956898f2c5aa30e5abd9a2ea7bb4208a4979b27131fb27e
+  metadata.gz: 49c1f34fc9b74d9c79e59e95a4acc47c518086f883f75586f04058338f8b27190a5de807569c09f4e1be37a2e765dc84bcf00a13324bfd466798c9e77a66f0c0
+  data.tar.gz: 7bd934b72a8ddaf2d29b65f71792d6a72883c9cb53272483b1f39b2c70205d41d65dab12b972328b87e5eda39ff22ccb607cddeb62918b2b93e25890742176eb

data/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2025-07-27
+
+### Added
+- **Terminal-Style Console Interface**: Complete redesign of the browser console
+  - Real terminal-like experience with command history and session persistence
+  - Session state management to maintain console state across page reloads
+  - Responsive design optimized for both desktop and mobile devices
+  - Comprehensive Japanese and English translations
+- **Enhanced Documentation**: Comprehensive documentation for API-only Rails support and authentication features
+
+### Improved
+- **Console Functionality**: Enhanced console session management and user experience
+- **Test Coverage**: Added comprehensive tests for terminal console interface
+- **Responsive Design**: Improved mobile and tablet compatibility for console interface
+
+### Fixed
+- **Timezone Dependencies**: Resolved timezone dependency issues in console specifications
+- **Session Persistence**: Fixed console session state persistence across browser reloads
+
 ## [0.2.1] - 2025-06-28
 
 ### Added
@@ -18,7 +37,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **Rails Demo API**: Complete API-only Rails demonstration application
   - Sample models, migrations, and authentication specifications
   - Proper bin/ directory with Rails binstubs
-  - Complete environment configurations
 
 ### Changed
 - **Settings Controller**: Improved settings save functionality with proper flash message handling
@@ -83,6 +101,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - 🔧 Easy Integration: Simple gem installation and mounting process
 - 🔐 Built-in Authentication: Simple authentication options (Basic Auth, API keys, Custom)
 
+[0.2.2]: https://github.com/snowwshiro/stomp_base/releases/tag/v0.2.2
 [0.2.1]: https://github.com/snowwshiro/stomp_base/releases/tag/v0.2.1
 [0.2.0]: https://github.com/snowwshiro/stomp_base/releases/tag/v0.2.0
 [0.1.0]: https://github.com/snowwshiro/stomp_base/releases/tag/v0.1.0

data/README.md

@@ -271,6 +271,9 @@ StompBase.configure do |config|
   config.locale = :ja                    # Set interface language
   config.available_locales = [:en, :ja]  # Available language options (read-only)
   
+  # Console configuration
+  config.allow_console_in_production = false # Allow console functionality in production (default: false)
+  
   # Authentication options
   config.enable_authentication(          # Enable authentication
     method: :basic_auth,                 # :basic_auth, :api_key, or :custom
@@ -296,6 +299,20 @@ StompBase.enable_authentication(method: :basic_auth, username: 'admin', password
 StompBase.disable_authentication
 ```
 
+### Console Configuration
+
+For security reasons, the Rails console functionality is disabled in production environments by default. You can enable it if needed:
+
+```ruby
+# config/initializers/stomp_base.rb
+StompBase.configure do |config|
+  # Enable console functionality in production (disabled by default for security)
+  config.allow_console_in_production = true
+end
+```
+
+**⚠️ Security Warning**: Enabling console functionality in production environments poses significant security risks. Only enable this feature if you fully understand the implications and have proper security measures in place.
+
 ### Direct Configuration
 
 ```ruby
@@ -461,6 +478,8 @@ StompBase.configure do |config|
       method: :api_key,
       keys: [ENV['STOMP_BASE_API_KEY']]
     )
+    # Console disabled in production by default for security
+    # config.allow_console_in_production = true  # Uncomment only if absolutely necessary
   elsif Rails.env.development?
     # Simple authentication for development
     config.enable_authentication(
@@ -468,6 +487,7 @@ StompBase.configure do |config|
       username: 'dev',
       password: 'dev'
     )
+    # Console enabled in development by default
   else
     # Disable authentication for test environment
     config.disable_authentication
@@ -481,6 +501,8 @@ end
 - Use HTTPS (especially when using Basic Authentication)
 - Update API keys regularly
 - Be careful not to output authentication information to log files
+- **Console functionality should remain disabled in production environments** unless absolutely necessary for debugging
+- If console access is required in production, ensure strong authentication is enabled and access is properly logged
 
 ## Implementation Summary
 

data/app/components/stomp_base/console/console_examples_component.html.erb

@@ -9,7 +9,7 @@
   <div style="display: grid; grid-template-columns: repeat(auto-fit, minmax(280px, 1fr)); gap: 0.5rem;">
     <% console_examples.each do |example| %>
       <button 
-        onclick="insertExampleCommand('<%= example[:command] %>')"
+        onclick="insertTerminalCommand('<%= example[:command] %>')"
         class="stomp-base-btn" 
         style="text-align: left; padding: 0.75rem; background-color: #f8fafc; color: #374151; border: 1px solid #e2e8f0; border-radius: 0.375rem; font-family: 'Courier New', monospace; font-size: 0.8125rem; transition: all 0.2s ease;"
         onmouseover="this.style.backgroundColor='#f1f5f9'; this.style.borderColor='#cbd5e1';"

data/app/components/stomp_base/console/terminal_component.html.erb

@@ -0,0 +1,317 @@
+<!-- Terminal-style Console Interface -->
+<div class="stomp-base-card" style="margin-bottom: 0.75rem; background-color: #1e1e1e; border: 1px solid #333; border-radius: 0.5rem; overflow: hidden;">
+  <div style="display: flex; align-items: center; justify-content: space-between; flex-wrap: wrap; gap: 0.5rem; padding: 0.75rem 1rem; background-color: #2d2d2d; border-bottom: 1px solid #333;">
+    <div style="display: flex; align-items: center; min-width: 0;">
+      <svg style="width: 1.25rem; height: 1.25rem; margin-right: 0.5rem; color: #10b981; flex-shrink: 0;" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 002 2z"></path>
+      </svg>
+      <span style="color: #e5e7eb; font-weight: 600; font-size: 0.875rem; white-space: nowrap;">Rails Console</span>
+    </div>
+    <div style="display: flex; gap: 0.5rem; flex-shrink: 0;">
+      <button onclick="clearTerminal()" class="stomp-base-btn" style="padding: 0.375rem 0.75rem; font-size: 0.75rem; background-color: #374151; color: #e5e7eb; border: 1px solid #4b5563; border-radius: 0.375rem; white-space: nowrap;">
+        <%= t('stomp_base.console.clear') %>
+      </button>
+      <button onclick="restartSession()" class="stomp-base-btn" style="padding: 0.375rem 0.75rem; font-size: 0.75rem; background-color: #dc2626; color: #fff; border: 1px solid #dc2626; border-radius: 0.375rem; white-space: nowrap;">
+        Restart
+      </button>
+    </div>
+  </div>
+
+  <!-- Terminal Display Area -->
+  <div 
+    id="terminal-display" 
+    style="height: 400px; max-height: 60vh; overflow-y: auto; padding: 1rem; background-color: #1e1e1e; font-family: 'Courier New', 'Monaco', 'Consolas', monospace; font-size: 0.875rem; line-height: 1.4; color: #e5e7eb;"
+  >
+    <div id="terminal-output">
+      <div style="color: #10b981; margin-bottom: 0.5rem;"><%= welcome_message %></div>
+    </div>
+    <div id="terminal-input-line" style="display: flex; align-items: flex-start; gap: 0.25rem;">
+      <span id="terminal-prompt" style="color: #10b981; flex-shrink: 0; user-select: none; font-size: 0.875rem; line-height: 1.4;"><%= initial_prompt %></span>
+      <div style="flex: 1; min-width: 0; position: relative;">
+        <textarea
+          id="terminal-input"
+          style="width: 100%; min-height: 1.4em; background: transparent; border: none; outline: none; color: #e5e7eb; font-family: inherit; font-size: inherit; line-height: inherit; resize: none; padding: 0; margin: 0; overflow: hidden; word-wrap: break-word;"
+          placeholder="<%= t('stomp_base.console.placeholder') %>"
+          rows="1"
+          onkeydown="handleTerminalKeydown(event)"
+          oninput="adjustTerminalInputHeight()"
+        ></textarea>
+      </div>
+    </div>
+  </div>
+
+  <!-- Hidden session ID for JavaScript -->
+  <input type="hidden" id="terminal-session-id" value="<%= session_id %>">
+</div>
+
+<style>
+  @media (max-width: 640px) {
+    #terminal-display {
+      height: 300px !important;
+      max-height: 50vh !important;
+      padding: 0.75rem !important;
+      font-size: 0.8125rem !important;
+    }
+    
+    #terminal-input {
+      font-size: 0.8125rem !important;
+    }
+    
+    #terminal-prompt {
+      font-size: 0.8125rem !important;
+    }
+  }
+  
+  @media (max-width: 480px) {
+    #terminal-display {
+      height: 250px !important;
+      max-height: 40vh !important;
+      padding: 0.5rem !important;
+      font-size: 0.75rem !important;
+    }
+    
+    #terminal-input {
+      font-size: 0.75rem !important;
+    }
+    
+    #terminal-prompt {
+      font-size: 0.75rem !important;
+    }
+  }
+</style>
+
+<script>
+// Terminal functionality
+let terminalHistory = [];
+let terminalHistoryIndex = -1;
+let terminalCommandCounter = 1;
+let terminalSessionId = document.getElementById('terminal-session-id').value;
+
+function handleTerminalKeydown(event) {
+  const input = event.target;
+  
+  // Execute on Enter (without Shift)
+  if (event.key === 'Enter' && !event.shiftKey) {
+    event.preventDefault();
+    executeTerminalCommand();
+    return;
+  }
+  
+  // Allow Shift+Enter for multi-line input
+  if (event.key === 'Enter' && event.shiftKey) {
+    // Let the default behavior handle the new line
+    setTimeout(() => adjustTerminalInputHeight(), 0);
+    return;
+  }
+  
+  // History navigation with Up/Down arrows
+  if (event.key === 'ArrowUp' && terminalHistory.length > 0) {
+    event.preventDefault();
+    terminalHistoryIndex = Math.min(terminalHistoryIndex + 1, terminalHistory.length - 1);
+    input.value = terminalHistory[terminalHistoryIndex];
+    adjustTerminalInputHeight();
+  } else if (event.key === 'ArrowDown') {
+    event.preventDefault();
+    if (terminalHistoryIndex > 0) {
+      terminalHistoryIndex--;
+      input.value = terminalHistory[terminalHistoryIndex];
+    } else {
+      terminalHistoryIndex = -1;
+      input.value = '';
+    }
+    adjustTerminalInputHeight();
+  }
+}
+
+function adjustTerminalInputHeight() {
+  const input = document.getElementById('terminal-input');
+  input.style.height = 'auto';
+  input.style.height = input.scrollHeight + 'px';
+}
+
+function showSessionPersistenceNotice() {
+  const notice = document.createElement('div');
+  notice.style.cssText = `
+    position: fixed;
+    top: 20px;
+    right: 20px;
+    background: #10b981;
+    color: white;
+    padding: 12px 16px;
+    border-radius: 6px;
+    font-size: 14px;
+    z-index: 1000;
+    opacity: 0;
+    transform: translateX(100%);
+    transition: all 0.3s ease;
+  `;
+  notice.textContent = '<%= t('stomp_base.console.variable_persistence') %>';
+  
+  document.body.appendChild(notice);
+  
+  setTimeout(() => {
+    notice.style.opacity = '1';
+    notice.style.transform = 'translateX(0)';
+  }, 100);
+  
+  setTimeout(() => {
+    notice.style.opacity = '0';
+    notice.style.transform = 'translateX(100%)';
+    setTimeout(() => notice.remove(), 300);
+  }, 3000);
+}
+
+// Show session persistence notice on first command
+let firstCommandExecuted = false;
+function executeTerminalCommand() {
+  const input = document.getElementById('terminal-input');
+  const command = input.value.trim();
+  
+  if (!command) return;
+  
+  // Show persistence notice on first command
+  if (!firstCommandExecuted) {
+    showSessionPersistenceNotice();
+    firstCommandExecuted = true;
+  }
+  
+  // Add to history
+  terminalHistory.unshift(command);
+  if (terminalHistory.length > 50) {
+    terminalHistory = terminalHistory.slice(0, 50);
+  }
+  terminalHistoryIndex = -1;
+  
+  // Display command in terminal
+  displayTerminalCommand(command);
+  
+  // Clear input and reset height
+  input.value = '';
+  input.style.height = 'auto';
+  
+  // Execute command via AJAX
+  fetch('<%= StompBase::Engine.routes.url_helpers.console_execute_path %>', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+      'X-CSRF-Token': document.querySelector('[name="csrf-token"]').content
+    },
+    body: JSON.stringify({ 
+      command: command, 
+      session_id: terminalSessionId,
+      command_counter: terminalCommandCounter
+    })
+  })
+  .then(response => response.json())
+  .then(data => {
+    if (data.success) {
+      displayTerminalOutput(data.result, data.command_counter);
+    } else {
+      displayTerminalError(data.error, data.command_counter);
+    }
+    terminalCommandCounter = data.command_counter ? data.command_counter + 1 : terminalCommandCounter + 1;
+    updateTerminalPrompt();
+  })
+  .catch(error => {
+    displayTerminalError(`Network error: ${error.message}`, terminalCommandCounter);
+    terminalCommandCounter++;
+    updateTerminalPrompt();
+  });
+}
+
+function displayTerminalCommand(command) {
+  const output = document.getElementById('terminal-output');
+  const commandDiv = document.createElement('div');
+  commandDiv.innerHTML = `<span style="color: #10b981;">${getCurrentPrompt()}</span>${escapeHtml(command)}`;
+  output.appendChild(commandDiv);
+  scrollTerminalToBottom();
+}
+
+function displayTerminalOutput(result, commandCounter) {
+  const output = document.getElementById('terminal-output');
+  const resultDiv = document.createElement('div');
+  resultDiv.style.color = '#e5e7eb';
+  resultDiv.style.marginBottom = '0.5rem';
+  resultDiv.style.whiteSpace = 'pre-wrap';
+  resultDiv.textContent = result;
+  output.appendChild(resultDiv);
+  scrollTerminalToBottom();
+}
+
+function displayTerminalError(error, commandCounter) {
+  const output = document.getElementById('terminal-output');
+  const errorDiv = document.createElement('div');
+  errorDiv.style.color = '#ef4444';
+  errorDiv.style.marginBottom = '0.5rem';
+  errorDiv.style.whiteSpace = 'pre-wrap';
+  errorDiv.textContent = error;
+  output.appendChild(errorDiv);
+  scrollTerminalToBottom();
+}
+
+function getCurrentPrompt() {
+  return `irb(main):${String(terminalCommandCounter).padStart(3, '0')}:0> `;
+}
+
+function updateTerminalPrompt() {
+  const prompt = document.getElementById('terminal-prompt');
+  prompt.textContent = getCurrentPrompt();
+}
+
+function scrollTerminalToBottom() {
+  const display = document.getElementById('terminal-display');
+  display.scrollTop = display.scrollHeight;
+}
+
+function clearTerminal() {
+  const output = document.getElementById('terminal-output');
+  output.innerHTML = `<div style="color: #10b981; margin-bottom: 0.5rem;"><%= welcome_message %></div>`;
+  terminalCommandCounter = 1;
+  updateTerminalPrompt();
+  document.getElementById('terminal-input').focus();
+}
+
+function restartSession() {
+  if (confirm('Are you sure you want to restart the console session? All variables will be lost.')) {
+    terminalSessionId = generateSessionId();
+    document.getElementById('terminal-session-id').value = terminalSessionId;
+    clearTerminal();
+    
+    // Notify server to clear session
+    fetch('<%= StompBase::Engine.routes.url_helpers.console_execute_path %>', {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        'X-CSRF-Token': document.querySelector('[name="csrf-token"]').content
+      },
+      body: JSON.stringify({ 
+        command: '__restart_session__', 
+        session_id: terminalSessionId 
+      })
+    });
+  }
+}
+
+function generateSessionId() {
+  return Math.random().toString(36).substr(2, 9);
+}
+
+function escapeHtml(text) {
+  const div = document.createElement('div');
+  div.textContent = text;
+  return div.innerHTML;
+}
+
+function insertTerminalCommand(command) {
+  const input = document.getElementById('terminal-input');
+  input.value = command;
+  input.focus();
+  adjustTerminalInputHeight();
+}
+
+// Focus input on page load
+document.addEventListener('DOMContentLoaded', function() {
+  document.getElementById('terminal-input').focus();
+  updateTerminalPrompt();
+});
+</script>

data/app/components/stomp_base/console/terminal_component.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module StompBase
+  module Console
+    class TerminalComponent < StompBase::BaseComponent
+      def initialize(session_id: nil)
+        super()
+        @session_id = session_id || SecureRandom.hex(8)
+      end
+
+      private
+
+      attr_reader :session_id
+
+      def initial_prompt
+        "irb(main):001:0> "
+      end
+
+      def welcome_message
+        "#{t("stomp_base.console.terminal_welcome")}\n#{t("stomp_base.console.terminal_help")}"
+      end
+    end
+  end
+end

data/app/components/stomp_base/pages/console_component.html.erb

@@ -3,21 +3,17 @@
   display_options: { 
     gradient_colors: { from: '#1f2937', to: '#374151' },
     status_message: t('stomp_base.console.welcome_message'),
-    custom_button: '<button onclick="clearConsoleOutput()" class="stomp-base-btn" style="display: inline-flex; align-items: center; padding: 0.375rem 0.625rem; font-size: 0.8125rem; background-color: rgba(255,255,255,0.2); color: white; border: 1px solid rgba(255,255,255,0.3); backdrop-filter: blur(10px);">
+    custom_button: '<button onclick="restartSession()" class="stomp-base-btn" style="display: inline-flex; align-items: center; padding: 0.375rem 0.625rem; font-size: 0.8125rem; background-color: rgba(220,38,38,0.8); color: white; border: 1px solid rgba(220,38,38,0.3); backdrop-filter: blur(10px);">
       <svg style="width: 0.75rem; height: 0.75rem; margin-right: 0.375rem;" fill="none" stroke="currentColor" viewBox="0 0 24 24">
-        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 7l-.867 12.142A2 2 0 0116.138 21H7.862a2 2 0 01-1.995-1.858L5 7m5 4v6m4-6v6m1-10V4a1 1 0 00-1-1h-4a1 1 0 00-1 1v3M4 7h16"></path>
+        <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M4 4v5h.582m15.356 2A8.001 8.001 0 004.582 9m0 0H9m11 11v-5h-.581m0 0a8.003 8.003 0 01-15.357-2m15.357 2H15"></path>
       </svg>
-      ' + t('stomp_base.console.clear') + '
+      Restart Session
     </button>'.html_safe
   }
 ) %>
 
 <%= render StompBase::Console::SecurityWarningComponent.new %>
 
-<%= render StompBase::Console::ConsoleInterfaceComponent.new %>
+<%= render StompBase::Console::TerminalComponent.new %>
 
 <%= render StompBase::Console::ConsoleExamplesComponent.new %>
-
-<%= render StompBase::Console::ConsoleJavascriptComponent.new %>
-
-<%= render StompBase::Console::ConsoleCssComponent.new %>

data/app/controllers/stomp_base/console_controller.rb

@@ -43,40 +43,50 @@ module StompBase
 
     def execute
       command = params[:command]&.strip
+      session_id = params[:session_id]
+      command_counter = params[:command_counter]&.to_i || 1
+
       return render_error(I18n.t("stomp_base.console.error")) if command.blank?
 
-      process_console_command(command)
+      # Handle session restart
+      if command == "__restart_session__"
+        clear_session_binding(session_id)
+        return render json: { success: true, result: "Session restarted", command_counter: 1 }
+      end
+
+      process_console_command(command, session_id, command_counter)
     rescue StandardError => e
-      handle_execution_error(e)
+      handle_execution_error(e, command_counter)
     end
 
-    def process_console_command(command)
+    def process_console_command(command, session_id, command_counter)
       Rails.logger.info "StompBase Console Command: #{command}"
       return render_dangerous_command_error if dangerous_command?(command)
 
-      result = execute_in_rails_console(command)
-      render_success(result)
+      result = execute_in_rails_console(command, session_id)
+      render_success(result, command_counter)
     end
 
-    def handle_execution_error(error)
+    def handle_execution_error(error, command_counter = 1)
       Rails.logger.error "StompBase Console Error: #{error.message}"
-      render_error(error.message)
+      render_error(error.message, command_counter)
     end
 
     private
 
-    def render_error(message)
-      render json: { success: false, error: message, result: nil }
+    def render_error(message, command_counter = 1)
+      render json: { success: false, error: message, result: nil, command_counter: command_counter }
     end
 
-    def render_success(result)
-      render json: { success: true, result: result.to_s, error: false }
+    def render_success(result, command_counter = 1)
+      render json: { success: true, result: result.to_s, error: false, command_counter: command_counter }
     end
 
     def render_dangerous_command_error
       render json: {
         success: false,
-        error: "Dangerous command detected. Execution denied."
+        error: "Dangerous command detected. Execution denied.",
+        command_counter: 1
       }
     end
 
@@ -90,10 +100,10 @@ module StompBase
       DANGEROUS_PATTERNS.any? { |pattern| command.match?(pattern) }
     end
 
-    def execute_in_rails_console(command)
+    def execute_in_rails_console(command, session_id)
       # Evaluate command in secure execution environment
-      # Simulate basic Rails console environment
-      binding_context = create_console_binding
+      # Maintain session state for each session_id
+      binding_context = get_or_create_session_binding(session_id)
 
       # Set timeout (10 seconds)
       result = Timeout.timeout(10) do
@@ -104,6 +114,47 @@ module StompBase
       format_result(result)
     end
 
+    # Class-level session storage to persist across requests
+    @@session_bindings = {}
+    @@session_mutex = Mutex.new
+    @@session_timestamps = {}
+
+    def get_or_create_session_binding(session_id)
+      @@session_mutex.synchronize do
+        # Clean up old sessions (older than 30 minutes)
+        cleanup_old_sessions
+
+        # Create or retrieve session binding
+        unless @@session_bindings[session_id]
+          @@session_bindings[session_id] = create_console_binding
+          @@session_timestamps[session_id] = Time.current
+        end
+
+        # Update timestamp
+        @@session_timestamps[session_id] = Time.current
+        @@session_bindings[session_id]
+      end
+    end
+
+    def clear_session_binding(session_id)
+      @@session_mutex.synchronize do
+        @@session_bindings.delete(session_id)
+        @@session_timestamps.delete(session_id)
+      end
+    end
+
+    def cleanup_old_sessions
+      current_time = Time.current
+      expired_sessions = @@session_timestamps.select do |_session_id, timestamp|
+        current_time - timestamp > 30.minutes
+      end
+
+      expired_sessions.each_key do |session_id|
+        @@session_bindings.delete(session_id)
+        @@session_timestamps.delete(session_id)
+      end
+    end
+
     def create_console_binding
       binding_object = ConsoleBindingHelper.new
       binding_object.instance_eval { binding }
@@ -207,5 +258,33 @@ module StompBase
     rescue StandardError => e
       "#{result} (inspect failed: #{e.message})"
     end
+
+    # Session management utility methods
+    def active_sessions_count
+      @@session_mutex.synchronize do
+        @@session_bindings.size
+      end
+    end
+
+    def session_info(session_id)
+      @@session_mutex.synchronize do
+        return nil unless @@session_bindings.key?(session_id)
+
+        {
+          session_id: session_id,
+          created_at: @@session_timestamps[session_id],
+          last_accessed: @@session_timestamps[session_id],
+          active: true
+        }
+      end
+    end
+
+    def all_sessions_info
+      @@session_mutex.synchronize do
+        @@session_bindings.keys.map do |session_id|
+          session_info(session_id)
+        end
+      end
+    end
   end
 end

data/config/locales/en.yml

@@ -82,10 +82,12 @@ en:
       available: "Available"
       open_console: "Open Console"
       welcome_message: "Rails Console"
-      placeholder: "Enter Ruby code (e.g., User.count)"
+      placeholder: "Type your Ruby code here..."
       execute: "Execute"
       clear: "Clear"
       clear_history: "Clear History"
+      restart_session: "Restart Session"
+      session_restarted: "Session restarted"
       history: "History"
       output: "Output"
       no_output: "No output"
@@ -97,6 +99,8 @@ en:
       sandbox_mode: "Sandbox Mode"
       enable_sandbox: "Enable Sandbox"
       disable_sandbox: "Disable Sandbox"
+      terminal_welcome: "Welcome to StompBase Rails Console"
+      terminal_help: "Type 'help' for available commands"
       examples:
         title: "Example Commands"
         user_count: "User.count"
@@ -181,3 +185,11 @@ en:
       table_name_label: "Table Name"
       record_count_label: "Records"
       null_value: "NULL"
+      session_info: "Session Information"
+      session_id: "Session ID"
+      session_active: "Active"
+      session_created_at: "Created At"
+      session_last_accessed: "Last Accessed"
+      active_sessions: "Active Sessions Count"
+      variable_persistence: "Variable state is maintained between commands"
+      session_timeout: "Sessions automatically expire after 30 minutes of inactivity"

data/config/locales/ja.yml

@@ -82,10 +82,12 @@ ja:
       available: "利用可能"
       open_console: "コンソールを開く"
       welcome_message: "Rails Console"
-      placeholder: "Rubyコードを入力してください（例: User.count）"
+      placeholder: "Rubyコードを入力してください..."
       execute: "実行"
       clear: "クリア"
       clear_history: "履歴をクリア"
+      restart_session: "セッションを再開"
+      session_restarted: "セッションが再開されました"
       history: "履歴"
       output: "出力"
       no_output: "出力がありません"
@@ -97,6 +99,7 @@ ja:
       sandbox_mode: "サンドボックスモード"
       enable_sandbox: "サンドボックスを有効にする"
       disable_sandbox: "サンドボックスを無効にする"
+      terminal_welcome: "StompBase Rails Console へようこそ"
       examples:
         title: "コマンド例"
         user_count: "User.count"
@@ -186,3 +189,11 @@ ja:
       table_name_label: "テーブル名"
       record_count_label: "レコード数"
       null_value: "NULL"
+      session_info: "セッション情報"
+      session_id: "セッションID"
+      session_active: "アクティブ"
+      session_created_at: "作成日時"
+      session_last_accessed: "最終アクセス"
+      active_sessions: "アクティブセッション数"
+      variable_persistence: "変数の状態はセッション間で保持されます"
+      session_timeout: "セッションは30分間非アクティブ状態が続くと自動的に終了します"

data/lib/stomp_base/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module StompBase
-  VERSION = "0.2.1"
+  VERSION = "0.2.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: stomp_base
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.2
 platform: ruby
 authors:
 - snowwshiro
@@ -69,6 +69,8 @@ files:
 - app/components/stomp_base/console/console_javascript_component.rb
 - app/components/stomp_base/console/security_warning_component.html.erb
 - app/components/stomp_base/console/security_warning_component.rb
+- app/components/stomp_base/console/terminal_component.html.erb
+- app/components/stomp_base/console/terminal_component.rb
 - app/components/stomp_base/dashboard/database_info_card_component.html.erb
 - app/components/stomp_base/dashboard/database_info_card_component.rb
 - app/components/stomp_base/dashboard/performance_metrics_card_component.html.erb