tina4ruby 3.12.13 → 3.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65d79f819e3ac62c1e8d3447409b8c75530c239db2bb6a7df9066de4104495ed
-  data.tar.gz: d0b0af5dd0e914b880cc64a7b9aca29e6f46de65dcec3104b18e01ad174509b8
+  metadata.gz: bf3bb8bf3275f76f25951fdb75de731c304323b64cb2a495e4060ad7fcafdde1
+  data.tar.gz: a616d714a2a9beecfeb8d42a5b4124540d2abe07be8d9d2cd83ec5996596eb44
 SHA512:
-  metadata.gz: 2e59eac2e37d78d1f7752cd26680338ff404794f6ff23dbe9ab2a1570ce3f458200fd5f488fefb8ef6f5f0b1764aa355def94dbed13a50149df30b4ea798059a
-  data.tar.gz: 7021e0596f5275b4daf0969f0690400e99222fe10f30547b31fc8ee747f266c88086fb577927953813ac53b52dad9d8ce95a7ecb7ae48bfd2c1aa50fa8ff5e47
+  metadata.gz: be8986d4743a886d442d267add5953bff00a24fe85388b1947e57b1c9fa68447db08d63811b1f13d25cacb64eeea80b8e06fe366ec53961290c3125dbea69a1a
+  data.tar.gz: 535158f269ed6964d764e010efb319ac343991d9737a41bad8acbefe6eb8e8ff191694fb662a2df4cec684499c4b708ca924b6d80a7b1cfea306323eb697706b

data/lib/tina4/auth.rb

@@ -109,19 +109,25 @@ module Tina4
       end
 
 
-      def valid_token(token) # -> bool
+      # Verify a JWT signature + expiry.
+      #
+      # 3.13.0: return type changed from `Boolean` to `Hash | nil`. The
+      # decoded payload is returned on success, nil on failure. Matches
+      # firebase/jwt-ruby and Python's Auth.valid_token in 3.13.0.
+      #
+      # Legacy `if Tina4::Auth.valid_token(t)` patterns keep working
+      # because a non-empty Hash is truthy and nil is falsy.
+      def valid_token(token)
         if use_hmac?
-          !hmac_decode(token, hmac_secret).nil?
+          hmac_decode(token, hmac_secret) # returns Hash payload or nil
         else
           ensure_keys
           require "jwt"
-          JWT.decode(token, public_key, true, algorithm: "RS256")
-          true
+          decoded = JWT.decode(token, public_key, true, algorithm: "RS256")
+          decoded[0] # firebase/jwt-ruby returns [payload, header]
         end
-      rescue JWT::ExpiredSignature
-        false
-      rescue JWT::DecodeError
-        false
+      rescue JWT::ExpiredSignature, JWT::DecodeError
+        nil
       end
 
       def valid_token_detail(token)

data/lib/tina4/test.rb

@@ -0,0 +1,179 @@
+# frozen_string_literal: true
+
+# Tina4 — The Intelligent Native Application 4ramework
+# Copyright 2007 - current Tina4
+# License: MIT https://opensource.org/licenses/MIT
+
+module Tina4
+  # Tina4 xUnit-style test base class — class-based test suites with HTTP
+  # helpers and positional assertions. Zero external dependencies.
+  #
+  # Documentation chapter 18 has long described:
+  #
+  #     class UserApiTest < Tina4::Test
+  #       def test_health
+  #         resp = get("/health")
+  #         assert_equal_value(resp.status, 200)
+  #       end
+  #     end
+  #
+  # Until 3.13.0 this class did not exist — examples crashed with
+  # "uninitialized constant Tina4::Test". Ruby parity of the
+  # Python `tina4_python.test.Test` and PHP `Tina4\Test` classes.
+  #
+  # The class has a built-in runner (no Minitest/RSpec required):
+  #
+  #     results = Tina4::Test.run_all          # discovers all subclasses
+  #     # => { passed: 12, failed: 0, errors: 0, details: [...] }
+  #
+  # Or run a single suite class:
+  #
+  #     UserApiTest.run!
+  #
+  # HTTP helpers (get/post/put/patch/delete) delegate to TestClient.
+  # Positional assertions match the Python (actual, expected, message)
+  # shape used throughout the cross-framework docs.
+  class Test
+    # Class-level registry so run_all can discover every subclass without
+    # filesystem scanning.
+    @subclasses = []
+
+    class << self
+      attr_reader :subclasses
+
+      def inherited(subclass)
+        super
+        Test.subclasses << subclass
+      end
+
+      # Run every test method (`test_*`) on the calling subclass. Returns
+      # a hash with passed/failed/errors counts and per-test details.
+      def run!
+        instance_methods(false).grep(/\Atest_/).sort.each_with_object(
+          { passed: 0, failed: 0, errors: 0, details: [] }
+        ) do |method, results|
+          suite = new
+          begin
+            suite.send(:set_up)
+            suite.send(method)
+            suite.send(:tear_down)
+            results[:passed] += 1
+            results[:details] << { suite: name, test: method, status: "passed" }
+          rescue AssertionError => e
+            results[:failed] += 1
+            results[:details] << { suite: name, test: method, status: "failed", message: e.message }
+          rescue StandardError => e
+            results[:errors] += 1
+            results[:details] << { suite: name, test: method, status: "error", message: "#{e.class}: #{e.message}" }
+          end
+        end
+      end
+
+      # Discover and run every Tina4::Test subclass.
+      def run_all(quiet: false)
+        results = { passed: 0, failed: 0, errors: 0, details: [] }
+        Test.subclasses.each do |klass|
+          out = klass.run!
+          results[:passed] += out[:passed]
+          results[:failed] += out[:failed]
+          results[:errors] += out[:errors]
+          results[:details].concat(out[:details])
+        end
+        unless quiet
+          puts "Tina4 Test results: #{results[:passed]} passed, #{results[:failed]} failed, #{results[:errors]} errors"
+        end
+        results
+      end
+    end
+
+    # ── Lifecycle hooks ──────────────────────────────────────────────
+    # snake_case Tina4 idiom; override in subclasses.
+
+    def set_up
+    end
+
+    def tear_down
+    end
+
+    # ── HTTP test client (lazy) ───────────────────────────────────────
+
+    def test_client
+      @test_client ||= Tina4::TestClient.new
+    end
+
+    def get(path, headers: nil)
+      test_client.get(path, headers: headers)
+    end
+
+    def post(path, json: nil, body: nil, headers: nil)
+      test_client.post(path, json: json, body: body, headers: headers)
+    end
+
+    def put(path, json: nil, body: nil, headers: nil)
+      test_client.put(path, json: json, body: body, headers: headers)
+    end
+
+    def patch(path, json: nil, body: nil, headers: nil)
+      test_client.patch(path, json: json, body: body, headers: headers)
+    end
+
+    def delete(path, headers: nil)
+      test_client.delete(path, headers: headers)
+    end
+
+    # ── Positional assertions — (actual, expected, message) shape ─────
+
+    def assert_equal_value(actual, expected, message = nil)
+      return if actual == expected
+
+      raise AssertionError, message || "Expected #{expected.inspect}, got #{actual.inspect}"
+    end
+
+    def assert_not_equal_value(actual, expected, message = nil)
+      return unless actual == expected
+
+      raise AssertionError, message || "Expected #{actual.inspect} != #{expected.inspect}, but they are equal"
+    end
+
+    def assert_true(value, message = nil)
+      return if value
+
+      raise AssertionError, message || "Expected truthy, got #{value.inspect}"
+    end
+
+    def assert_false(value, message = nil)
+      return unless value
+
+      raise AssertionError, message || "Expected falsy, got #{value.inspect}"
+    end
+
+    def assert_nil_value(value, message = nil)
+      return if value.nil?
+
+      raise AssertionError, message || "Expected nil, got #{value.inspect}"
+    end
+
+    def assert_not_nil_value(value, message = nil)
+      return unless value.nil?
+
+      raise AssertionError, message || "Expected non-nil, got nil"
+    end
+
+    def assert_raises(expected_class, message = nil)
+      raise ArgumentError, "Block required" unless block_given?
+
+      begin
+        yield
+      rescue StandardError => e
+        return if e.is_a?(expected_class)
+
+        raise AssertionError,
+              message || "Expected #{expected_class}, got #{e.class}: #{e.message}"
+      end
+      raise AssertionError, message || "Expected #{expected_class} to be raised, but nothing was"
+    end
+  end
+
+  # AssertionError raised by Tina4::Test assertion helpers on failure.
+  class AssertionError < StandardError; end
+end

data/lib/tina4/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tina4
-  VERSION = "3.12.13"
+  VERSION = "3.13.0"
 end

data/lib/tina4.rb

@@ -54,6 +54,7 @@ require_relative "tina4/response_cache"
 require_relative "tina4/html_element"
 require_relative "tina4/error_overlay"
 require_relative "tina4/test_client"
+require_relative "tina4/test"
 require_relative "tina4/docs"
 require_relative "tina4/mcp"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tina4ruby
 version: !ruby/object:Gem::Version
-  version: 3.12.13
+  version: 3.13.0
 platform: ruby
 authors:
 - Tina4 Team
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-29 00:00:00.000000000 Z
+date: 2026-06-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rack
@@ -402,6 +402,7 @@ files:
 - lib/tina4/templates/errors/502.twig
 - lib/tina4/templates/errors/503.twig
 - lib/tina4/templates/errors/base.twig
+- lib/tina4/test.rb
 - lib/tina4/test_client.rb
 - lib/tina4/testing.rb
 - lib/tina4/validator.rb