tina4ruby 3.13.137 → 3.13.138

data/lib/tina4.rb

@@ -1,4 +1,10 @@
 # frozen_string_literal: true
+# Copyright (c) 2026 Code Infinity
+# SPDX-License-Identifier: MPL-2.0
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 
 # ── Core (always loaded) ──────────────────────────────────────────────
 require_relative "tina4/version"
@@ -144,6 +150,8 @@ module Tina4
 
   # ── Lazy-loaded: web server ───────────────────────────────────────────
   autoload :WebServer, File.expand_path("tina4/webserver", __dir__)
+  autoload :HttpServer, File.expand_path("tina4/http_server", __dir__)
+  autoload :FormParser, File.expand_path("tina4/form_parser", __dir__)
 
   # ── Lazy-loaded: optional modules ─────────────────────────────────────
   autoload :Swagger,             File.expand_path("tina4/swagger", __dir__)
@@ -351,6 +359,13 @@ module Tina4
 /_/  /_/_/ /_/\__,_/  /_/
   BANNER
 
+  # Environment variables that mean "this is a CI run" - the ADR-0070 union
+  # across the four frameworks and the CLI. No one is there to see a tab.
+  CI_ENV_VARS = %w[CI CONTINUOUS_INTEGRATION GITHUB_ACTIONS GITLAB_CI BUILDKITE
+                   JENKINS_URL TF_BUILD TEAMCITY_VERSION].freeze
+  # A CI variable set to one of these does not mean CI (ADR-0070 ci_false).
+  CI_FALSE_VALUES = %w[false 0 no off].freeze
+
   class << self
     attr_accessor :root_dir
     attr_reader :database
@@ -404,18 +419,14 @@ module Tina4
       log_level = (ENV["TINA4_LOG_LEVEL"] || "ALL").upcase
       display = (host == "0.0.0.0" || host == "::") ? "localhost" : host
 
-      # Auto-detect server name if not provided
+      # Auto-detect server name if not provided: Puma only when production
+      # would actually pick it (ADR-0067), otherwise Tina4's own server.
       if server_name.nil?
-        if is_debug
-          server_name = "WEBrick"
-        else
-          begin
-            require "puma"
-            server_name = "puma"
-          rescue LoadError
-            server_name = "WEBrick"
-          end
-        end
+        server_name = if !is_debug && !builtin_webserver_pinned? && puma_available?
+                        "puma"
+                      else
+                        Tina4::HttpServer::SOFTWARE
+                      end
       end
 
       puts "#{color}#{BANNER}#{reset}"
@@ -438,8 +449,10 @@ module Tina4
     def initialize!(root_dir = Dir.pwd)
       @root_dir = root_dir
 
-      # Print banner
-      print_banner
+      # No banner here. The server start prints it (start_puma_server,
+      # WebServer#start) once the bind host and port are resolved; printed from
+      # here it named print_banner's defaults, localhost:7147, whatever the
+      # server really bound. Python prints it from run() for the same reason.
 
       # Load environment. Precedence: real-env > .env.local > .env
       # (.env.local loads first, both first-wins, so a real env var always wins).
@@ -530,14 +543,48 @@ module Tina4
       start
     end
 
-    def open_browser(url)
+    # Open the app in a browser only when ALL of these hold (ADR-0070):
+    #   * development: TINA4_DEBUG is truthy - never production or Puma
+    #   * TINA4_NO_BROWSER is not truthy (true/1/yes/on, trimmed, any case)
+    #   * --no-browser was not passed, and no_browser: true was not given
+    #   * no CI variable vetoes (see ci_run?)
+    # open_browser used to check none of it, so every app.rb booted through
+    # run! - and every spec that did so - popped a real tab.
+    def browser_launch_allowed?(argv: ARGV, no_browser: false)
+      return false if no_browser
+      return false unless Tina4::Env.is_truthy(ENV["TINA4_DEBUG"])
+      return false if Tina4::Env.is_truthy(ENV["TINA4_NO_BROWSER"])
+      return false if argv.include?("--no-browser")
+
+      !ci_run?
+    end
+
+    # A CI variable vetoes when it is set to a non-empty value (after
+    # trimming) that is not one of CI_FALSE_VALUES, case-insensitively - so
+    # CI=woodpecker vetoes and CI=false does not (ADR-0070).
+    def ci_run?
+      CI_ENV_VARS.any? do |name|
+        value = ENV[name].to_s.strip.downcase
+        !value.empty? && !CI_FALSE_VALUES.include?(value)
+      end
+    end
+
+    # TINA4_BROWSER_COMMAND names the launcher to run instead of the OS default
+    # (open / start / xdg-open); it receives the URL as its only argument.
+    def open_browser(url, no_browser: false)
+      return unless browser_launch_allowed?(no_browser: no_browser)
+
       require "rbconfig"
+      command = ENV["TINA4_BROWSER_COMMAND"].to_s.strip
       Thread.new do
         sleep 2
-        case RbConfig::CONFIG["host_os"]
-        when /darwin/i then system("open", url)
-        when /mswin|mingw/i then system("start", url)
-        else system("xdg-open", url)
+        if !command.empty? then system(command, url)
+        else
+          case RbConfig::CONFIG["host_os"]
+          when /darwin/i then system("open", url)
+          when /mswin|mingw/i then system("start", url)
+          else system("xdg-open", url)
+          end
         end
       end
     end
@@ -550,18 +597,25 @@ module Tina4
       Tina4::Frond.register_live_endpoint!
     end
 
-    def run!(root_dir = nil, port: nil, host: nil, debug: nil)
+    # no_browser: true keeps the browser shut (Python run(no_browser=True));
+    # false never forces one open (ADR-0070).
+    def run!(root_dir = nil, port: nil, host: nil, debug: nil, no_browser: false)
       # Handle legacy call: run!(port: 7147) where root_dir receives the hash
       if root_dir.is_a?(Hash)
         port ||= root_dir[:port]
         host ||= root_dir[:host]
         debug = root_dir[:debug] if debug.nil? && root_dir.key?(:debug)
+        no_browser ||= root_dir[:no_browser]
         root_dir = nil
       end
       root_dir ||= Dir.pwd
 
-      ENV["PORT"] = port.to_s if port
-      ENV["HOST"] = host.to_s if host
+      # An explicit argument beats the environment (ADR-0041), so it goes into
+      # the framework's own variables, which outrank everything else. Written
+      # into the bare PORT/HOST it lost to TINA4_PORT/TINA4_HOST and warned the
+      # app about a deprecated variable it never set.
+      ENV["TINA4_PORT"] = port.to_s if port
+      ENV["TINA4_HOST"] = host.to_s if host
       ENV["TINA4_DEBUG"] = debug.to_s unless debug.nil?
 
       initialize!(root_dir) unless @root_dir
@@ -603,22 +657,21 @@ module Tina4
       app = Tina4::RackApp.new(root_dir: root_dir)
       is_debug = Tina4::Env.is_truthy(ENV["TINA4_DEBUG"])
 
-      # Try Puma first (production-grade), fall back to WEBrick
+      # Puma when the APPLICATION bundles it (ADR-0067), otherwise the
+      # built-in server - in development AND production, as in Python.
       if !is_debug && !builtin_webserver_pinned? && puma_available?
-        open_browser(url)
         start_puma_server(app, host: host, port: port)
         return
       end
 
-      Tina4::Log.info("Development server: WEBrick")
-      open_browser(url)
+      open_browser(url, no_browser: no_browser)
       server = Tina4::WebServer.new(app, host: host, port: port)
       server.start
     end
 
-    # TINA4_DEFAULT_WEBSERVER=TRUE pins Tina4's BUILT-IN server (WEBrick) even
-    # in production, where Puma would otherwise be chosen. Unset/FALSE keeps
-    # today's behaviour, so this is non-breaking.
+    # TINA4_DEFAULT_WEBSERVER=TRUE pins Tina4's BUILT-IN server even when the
+    # application bundles Puma, which production would otherwise pick
+    # (ADR-0067). Unset/FALSE: Puma if it is loadable, else the built-in server.
     #
     # This is NOT the remedy for a production shutdown problem - an operator
     # must never have to give up Puma to get their database connections closed.
@@ -628,8 +681,10 @@ module Tina4
       Tina4::Env.is_truthy(ENV["TINA4_DEFAULT_WEBSERVER"])
     end
 
-    # Is Puma loadable? Separate from start_puma_server so the caller can fall
-    # back to WEBrick BEFORE any side effect (opening a browser) happens.
+    # Is Puma loadable? Puma is NOT a Tina4 dependency (ADR-0067): it is used
+    # only when the application installs it (under Bundler, when its Gemfile
+    # lists it). Separate from start_puma_server so the caller can fall back to
+    # the built-in server BEFORE any side effect (opening a browser) happens.
     def puma_available?
       require "puma"
       require "puma/configuration"
@@ -674,6 +729,7 @@ module Tina4
         user_config.raise_exception_on_sigterm false
       end
 
+      print_banner(host: host, port: port, server_name: "puma")
       Tina4::Log.info("Production server: puma (TINA4_SHUTDOWN_TIMEOUT=#{shutdown_timeout}s)")
       begin
         Puma::Launcher.new(config).run
@@ -916,7 +972,7 @@ module Tina4
       if db_url && !db_url.empty?
         begin
           bind_database(Tina4::Database.new(db_url))
-          Tina4::Log.info("Database connected: #{db_url.sub(/:[^:@]+@/, ':***@')}")
+          Tina4::Log.info("Database connected: #{Tina4::DatabaseUrl.redact(db_url)}")
         rescue => e
           Tina4::Log.error("Database connection failed: #{e.message}")
         end

data/lib/tina4ruby.rb

@@ -1,4 +1,10 @@
 # frozen_string_literal: true
+# Copyright (c) 2026 Code Infinity
+# SPDX-License-Identifier: MPL-2.0
+# This Source Code Form is subject to the terms of the Mozilla Public
+# License, v. 2.0. If a copy of the MPL was not distributed with this
+# file, You can obtain one at https://mozilla.org/MPL/2.0/.
+
 
 # Alias: `require "tina4ruby"` loads the same code as `require "tina4"`
 require_relative "tina4"

metadata

@@ -1,183 +1,63 @@
 --- !ruby/object:Gem::Specification
 name: tina4ruby
 version: !ruby/object:Gem::Version
-  version: 3.13.137
+  version: 3.13.138
 platform: ruby
 authors:
 - Tina4 Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-23 00:00:00.000000000 Z
+date: 2026-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rack
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
+        version: '2.0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: rackup
+  name: listen
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
-  type: :runtime
+        version: '3.8'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '3.8'
 - !ruby/object:Gem::Dependency
   name: puma
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '6.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '6.0'
-- !ruby/object:Gem::Dependency
-  name: net-smtp
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
-- !ruby/object:Gem::Dependency
-  name: net-imap
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.5'
-- !ruby/object:Gem::Dependency
-  name: json
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.7'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.7'
-- !ruby/object:Gem::Dependency
-  name: rexml
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
-- !ruby/object:Gem::Dependency
-  name: webrick
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.8'
-- !ruby/object:Gem::Dependency
-  name: logger
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.6'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.6'
-- !ruby/object:Gem::Dependency
-  name: base64
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-- !ruby/object:Gem::Dependency
-  name: sqlite3
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '2.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+        version: '7.2'
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '2.0'
-- !ruby/object:Gem::Dependency
-  name: listen
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.8'
+        version: 7.2.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.8'
+        version: '7.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 7.2.1
 - !ruby/object:Gem::Dependency
   name: mongo
   requirement: !ruby/object:Gem::Requirement
@@ -290,8 +170,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.10'
-description: 'TINA4: The Intelligent Native Application 4ramework for Ruby. A Rack-based
-  backend with native Ruby conventions and shared cross-language contracts.'
+description: 'TINA4: The Intelligent Native Application 4ramework for Ruby. A zero-dependency
+  backend with its own HTTP server, native Ruby conventions and shared cross-language
+  contracts.'
 email:
 - info@tina4.com
 executables:
@@ -300,7 +181,10 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
+- COMMERCIAL-LICENSE.md
+- LICENSE
 - LICENSE.txt
+- NOTICE
 - README.md
 - exe/tina4ruby
 - lib/tina4.rb
@@ -310,6 +194,7 @@ files:
 - lib/tina4/auth.rb
 - lib/tina4/auto_crud.rb
 - lib/tina4/background.rb
+- lib/tina4/base64.rb
 - lib/tina4/cache.rb
 - lib/tina4/cache_backends.rb
 - lib/tina4/cache_backends/base_backend.rb
@@ -355,6 +240,7 @@ files:
 - lib/tina4/events.rb
 - lib/tina4/feedback.rb
 - lib/tina4/field_types.rb
+- lib/tina4/form_parser.rb
 - lib/tina4/frond.rb
 - lib/tina4/gallery/auth/meta.json
 - lib/tina4/gallery/auth/src/routes/api/gallery_auth.rb
@@ -375,10 +261,13 @@ files:
 - lib/tina4/graphql.rb
 - lib/tina4/health.rb
 - lib/tina4/html_element.rb
+- lib/tina4/http_server.rb
+- lib/tina4/imap_client.rb
 - lib/tina4/import_helper.rb
 - lib/tina4/job.rb
 - lib/tina4/localization.rb
 - lib/tina4/log.rb
+- lib/tina4/mail_socket.rb
 - lib/tina4/mcp.rb
 - lib/tina4/messenger.rb
 - lib/tina4/metrics.rb
@@ -388,11 +277,14 @@ files:
 - lib/tina4/mqtt.rb
 - lib/tina4/mqtt_message.rb
 - lib/tina4/orm.rb
+- lib/tina4/parse_json.rb
 - lib/tina4/plan.rb
 - lib/tina4/point.rb
 - lib/tina4/port_takeover.rb
 - lib/tina4/project_index.rb
+- lib/tina4/public/THIRD-PARTY-NOTICES.md
 - lib/tina4/public/__feedback/widget.js
+- lib/tina4/public/bundled-component-provenance.json
 - lib/tina4/public/css/tina4.css
 - lib/tina4/public/css/tina4.min.css
 - lib/tina4/public/favicon.ico
@@ -403,6 +295,13 @@ files:
 - lib/tina4/public/js/tina4-dev-admin.min.js
 - lib/tina4/public/js/tina4.min.js
 - lib/tina4/public/js/tina4js.min.js
+- lib/tina4/public/licenses/swagger-ui-3.10.0-original-notice.txt
+- lib/tina4/public/licenses/swagger-ui-5.17.14-NOTICE.txt
+- lib/tina4/public/licenses/swagger-ui-Apache-2.0.txt
+- lib/tina4/public/licenses/tina4-css-MIT.txt
+- lib/tina4/public/licenses/tina4-dev-admin-components.json
+- lib/tina4/public/licenses/tina4-dev-admin-third-party.txt
+- lib/tina4/public/licenses/tina4-js-MIT.txt
 - lib/tina4/public/swagger/index.html
 - lib/tina4/public/swagger/oauth2-redirect.html
 - lib/tina4/push.rb
@@ -428,6 +327,7 @@ files:
 - lib/tina4/response.rb
 - lib/tina4/response_cache.rb
 - lib/tina4/router.rb
+- lib/tina4/secret_file.rb
 - lib/tina4/seeder.rb
 - lib/tina4/service.rb
 - lib/tina4/service_runner.rb
@@ -441,7 +341,9 @@ files:
 - lib/tina4/session_handlers/resp_client.rb
 - lib/tina4/session_handlers/valkey_handler.rb
 - lib/tina4/shutdown.rb
+- lib/tina4/smtp_client.rb
 - lib/tina4/sql_translator.rb
+- lib/tina4/sqlite3_gem.rb
 - lib/tina4/sso.rb
 - lib/tina4/swagger.rb
 - lib/tina4/template.rb
@@ -463,10 +365,11 @@ files:
 - lib/tina4/websocket.rb
 - lib/tina4/websocket_backplane.rb
 - lib/tina4/wsdl.rb
+- lib/tina4/xml_parser.rb
 - lib/tina4ruby.rb
 homepage: https://tina4.com
 licenses:
-- MIT
+- MPL-2.0
 metadata:
   homepage_uri: https://tina4.com
 post_install_message: