tina4ruby 3.11.13 → 3.11.15

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ca811aa2cb83ea336ce8be177f6f3688d014d6a7cb2ad4b90304a752a163d6aa
-  data.tar.gz: 51208212f5cf5b7c49fde4f77d80b042a99d65ec615f9e422228299dd04993c9
+  metadata.gz: 2de27368e39bd367b02f6576df9b9b63a11c380414c56fb88bb6e084d29d7375
+  data.tar.gz: 98466c233b46a441d18c45fef6b3b20cd081144cb1e71b16d837e3df8f2bb872
 SHA512:
-  metadata.gz: 8baf46841c98a50c37b767ce9f963404c04250802e58b33c97d4927847fd7895098e243affbde71caae19d872fd6238b388c2d08affc5d157f9b9a51aae73e46
-  data.tar.gz: bcc3047216b640f05573f7f450f6f591b8e3467979f12c503f80d2a652cdbb17cc513ed373b7e881b6c1305502b420910941bba6aefba401d827e45b21d918ec
+  metadata.gz: 97438a31fbdef07c05fea16802ec8b1f1adc1c6ec75c3f5773814a88c2d570ef85b306afefcd2401e401826ab5966a2d63af9150ed5a7ae0f76b77d12886daa4
+  data.tar.gz: 53af5a8cff1ba4ef87445eac76ac0f7e1d4e68b6349ab48b23a619758ddd7b681b4195f81b10e1d763c3de1a57d3d5ca6c92b6fd7654f1e5aef3ae4fb70c3cae

data/CHANGELOG.md

@@ -1,80 +1,80 @@
-# Changelog
-
-## [0.4.0] - 2026-03-18
-
-### Added
-- Multi-stage Dockerfile (ruby:3.3-alpine, build + runtime stages, optimized layer caching)
-- .dockerignore for clean Docker builds
-- `tina4ruby init` now generates Dockerfile and .dockerignore alongside project scaffolding
-
-## [0.3.0] - 2026-03-14
-
-### Added
-- Zero-dependency GraphQL implementation (matching tina4php-graphql)
-- Recursive descent GraphQL parser (queries, mutations, fragments, variables, aliases)
-- Depth-first AST executor with resolver pattern
-- GraphQL schema with programmatic type registration
-- ORM auto-schema generation (`schema.from_orm(User)`) — auto-creates CRUD queries/mutations
-- GraphiQL UI served at GET /graphql
-- Route integration via `gql.register_route("/graphql")`
-- Full GraphQL type system (scalars, objects, lists, non-null, input objects)
-
-## [0.2.0] - 2026-03-14
-
-### Added
-- Default auth protection for POST/PUT/PATCH/DELETE routes (matching tina4_python behavior)
-- API_KEY bypass in bearer auth — if `ENV["API_KEY"]` matches the bearer token, access is granted
-- `auth: false` option to make write routes public (equivalent to tina4_python's `@noauth()`)
-- `default_secure_auth` cached auth handler for performance
-- `resolve_auth` helper for flexible auth resolution
-- Puma as default production server (WEBrick fallback)
-- `add_header` method on Response object
-
-### Improved
-- Performance: lazy-initialized Request fields (headers, body, params, cookies, files)
-- Performance: pre-frozen CORS headers and OPTIONS response (zero allocation)
-- Performance: method-indexed route lookup (O(1) method filtering)
-- Performance: pre-computed static file roots at boot
-- Performance: fast-path for API routes skipping static file checks
-- Performance: cookie-less response fast path (no header duplication)
-- Router: normalized path computed once per request instead of per-route
-- Router: `match_path` returns params directly without redundant method check
-- Response: frozen content-type constants
-- Request: lazy `json_body` parsing
-- RackApp: skip `auto_detect` when handler returns response object directly
-
-### Changed
-- GET routes remain public by default
-- POST/PUT/PATCH/DELETE routes are now secured by default (use `auth: false` to make public)
-- `any` routes default to public (`auth: false`)
-- `secure_*` variants now use `default_secure_auth` (cached lambda)
-
-## [0.1.0] - 2026-03-14
-
-### Added
-- Core framework with Rack-based request pipeline
-- DSL routing (get, post, put, patch, delete, any)
-- Path parameters with type casting ({id:int}, {id:float}, {id:path})
-- Route groups with shared auth handlers
-- Request/Response objects with auto-type detection
-- Puma production server (WEBrick fallback)
-- SQLite, PostgreSQL, MySQL, MSSQL, Firebird database drivers
-- Database abstraction with parameterized queries
-- ORM with field types DSL and CRUD operations
-- SQL migration runner
-- JWT RS256 authentication + bcrypt password hashing
-- File-based sessions with JWT tokens
-- Before/after middleware hooks
-- OpenAPI 3.0 Swagger auto-generation
-- Twig-compatible template engine (ERB fallback)
-- CRUD scaffolding
-- REST API client helper
-- WebSocket support
-- Message queue abstraction (file, RabbitMQ, Kafka backends)
-- SCSS auto-compilation
-- Dev reload with file watching
-- i18n localization
-- Inline testing framework
-- CLI commands (init, start, migrate, test)
-- .env auto-creation and loading
-- Colored debug logging with rotation
+# Changelog
+
+## [0.4.0] - 2026-03-18
+
+### Added
+- Multi-stage Dockerfile (ruby:3.3-alpine, build + runtime stages, optimized layer caching)
+- .dockerignore for clean Docker builds
+- `tina4ruby init` now generates Dockerfile and .dockerignore alongside project scaffolding
+
+## [0.3.0] - 2026-03-14
+
+### Added
+- Zero-dependency GraphQL implementation (matching tina4php-graphql)
+- Recursive descent GraphQL parser (queries, mutations, fragments, variables, aliases)
+- Depth-first AST executor with resolver pattern
+- GraphQL schema with programmatic type registration
+- ORM auto-schema generation (`schema.from_orm(User)`) — auto-creates CRUD queries/mutations
+- GraphiQL UI served at GET /graphql
+- Route integration via `gql.register_route("/graphql")`
+- Full GraphQL type system (scalars, objects, lists, non-null, input objects)
+
+## [0.2.0] - 2026-03-14
+
+### Added
+- Default auth protection for POST/PUT/PATCH/DELETE routes (matching tina4_python behavior)
+- API_KEY bypass in bearer auth — if `ENV["API_KEY"]` matches the bearer token, access is granted
+- `auth: false` option to make write routes public (equivalent to tina4_python's `@noauth()`)
+- `default_secure_auth` cached auth handler for performance
+- `resolve_auth` helper for flexible auth resolution
+- Puma as default production server (WEBrick fallback)
+- `add_header` method on Response object
+
+### Improved
+- Performance: lazy-initialized Request fields (headers, body, params, cookies, files)
+- Performance: pre-frozen CORS headers and OPTIONS response (zero allocation)
+- Performance: method-indexed route lookup (O(1) method filtering)
+- Performance: pre-computed static file roots at boot
+- Performance: fast-path for API routes skipping static file checks
+- Performance: cookie-less response fast path (no header duplication)
+- Router: normalized path computed once per request instead of per-route
+- Router: `match_path` returns params directly without redundant method check
+- Response: frozen content-type constants
+- Request: lazy `json_body` parsing
+- RackApp: skip `auto_detect` when handler returns response object directly
+
+### Changed
+- GET routes remain public by default
+- POST/PUT/PATCH/DELETE routes are now secured by default (use `auth: false` to make public)
+- `any` routes default to public (`auth: false`)
+- `secure_*` variants now use `default_secure_auth` (cached lambda)
+
+## [0.1.0] - 2026-03-14
+
+### Added
+- Core framework with Rack-based request pipeline
+- DSL routing (get, post, put, patch, delete, any)
+- Path parameters with type casting ({id:int}, {id:float}, {id:path})
+- Route groups with shared auth handlers
+- Request/Response objects with auto-type detection
+- Puma production server (WEBrick fallback)
+- SQLite, PostgreSQL, MySQL, MSSQL, Firebird database drivers
+- Database abstraction with parameterized queries
+- ORM with field types DSL and CRUD operations
+- SQL migration runner
+- JWT RS256 authentication + bcrypt password hashing
+- File-based sessions with JWT tokens
+- Before/after middleware hooks
+- OpenAPI 3.0 Swagger auto-generation
+- Twig-compatible template engine (ERB fallback)
+- CRUD scaffolding
+- REST API client helper
+- WebSocket support
+- Message queue abstraction (file, RabbitMQ, Kafka backends)
+- SCSS auto-compilation
+- Dev reload with file watching
+- i18n localization
+- Inline testing framework
+- CLI commands (init, start, migrate, test)
+- .env auto-creation and loading
+- Colored debug logging with rotation

data/LICENSE.txt

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2024 Tina4 Team
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2024 Tina4 Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -1,137 +1,137 @@
-<p align="center">
-  <img src="https://tina4.com/logo.svg" alt="Tina4" width="200">
-</p>
-<h1 align="center">Tina4 Ruby</h1>
-<h3 align="center">TINA4 — The Intelligent Native Application 4ramework</h3>
-<p align="center"><em>Simple. Fast. Human. &nbsp;|&nbsp; Built for AI. Built for you.</em></p>
-<p align="center">55 built-in features. Zero runtime dependencies. One require, everything works.</p>
-<p align="center">
-  <a href="https://rubygems.org/gems/tina4ruby"><img src="https://img.shields.io/gem/v/tina4ruby?color=7b1fa2&label=RubyGems" alt="RubyGems"></a>
-  <img src="https://img.shields.io/badge/tests-2%2C508%20passing-brightgreen" alt="Tests">
-  <img src="https://img.shields.io/badge/features-55-blue" alt="Features">
-  <img src="https://img.shields.io/badge/dependencies-0-brightgreen" alt="Zero Deps">
-  <a href="https://tina4.com"><img src="https://img.shields.io/badge/docs-tina4.com-7b1fa2" alt="Docs"></a>
-</p>
-
----
-
-## Quick Start
-
-```bash
-# With the Tina4 CLI (recommended — enables SCSS + live reload)
-cargo install tina4    # or grab a binary from https://github.com/tina4stack/tina4/releases
-tina4 init ruby ./my-app
-cd my-app && tina4 serve
-
-# Without the Tina4 CLI
-gem install tina4ruby
-tina4ruby init my-app
-cd my-app && tina4ruby serve
-```
-
-Open http://localhost:7147
-
----
-
-## Code Examples
-
-```ruby
-Tina4.get "/api/hello" do |request, response|
-  response.call({ message: "Hello from Tina4!" }, Tina4::HTTP_OK)
-end
-
-class User < Tina4::ORM
-  integer_field :id, primary_key: true, auto_increment: true
-  string_field :name
-  string_field :email
-end
-
-db = Tina4::Database.new("sqlite://app.db")
-```
-
----
-
-## What's Included
-
-| Category | Features |
-|----------|----------|
-| **Core HTTP** (7) | Router with path params (`{id:int}`, `{p:path}`), Server, Request/Response, Middleware pipeline, Static file serving, CORS |
-| **Database** (6) | SQLite, PostgreSQL, MySQL, MSSQL, Firebird — unified adapter, connection pooling, query cache, transactions, race-safe ID generation, SQL dialect translation |
-| **ORM** (7) | Active Record with typed fields, relationships (`has_one`/`has_many`/`belongs_to`), soft delete, QueryBuilder + MongoDB support, Auto-CRUD generator, migrations with rollback |
-| **Auth & Security** (5) | JWT (HS256/RS256), password hashing (PBKDF2-SHA256), API key validation, rate limiting, CSRF form tokens |
-| **Templating** (3) | Frond engine (Twig/Jinja2-compatible, pre-compiled 2.8× faster), SCSS auto-compilation, built-in CSS (~24 KB) |
-| **API & Integration** (5) | HTTP client (zero-dep), GraphQL with ORM auto-schema + GraphiQL IDE, WSDL/SOAP with auto WSDL, WebSocket (RFC 6455) + Redis backplane, MCP server (24 dev tools) |
-| **Background** (3) | Job queue (File/RabbitMQ/Kafka/MongoDB) with priority, delay, retry, dead letters — service runner — event system (on/emit/once/off) |
-| **Data & Storage** (4) | Session (File/Redis/Valkey/MongoDB/DB), response cache (LRU, TTL), seeder + 50+ fake data generators, messenger (SMTP/IMAP) |
-| **Developer Tools** (7) | Dev dashboard (11 tabs), dev toolbar, error overlay (Catppuccin Mocha), dev mailbox, hot reload + CSS hot-reload, code metrics (complexity, coupling, maintainability), AI context installer (7 tools) |
-| **Utilities** (7) | DI container (transient + singleton), HtmlElement builder, inline testing (`@tests` decorator), i18n (6 languages), Swagger/OpenAPI auto-generation, CLI scaffolding (`generate model/route/migration/middleware`), structured logging |
-
-**2,508 tests. Zero runtime dependencies. Full parity across Python, PHP, Ruby, and Node.js.**
-
----
-
-## CLI Reference
-
-```bash
-tina4ruby serve [--port PORT]
-tina4ruby migrate
-tina4ruby seed
-tina4ruby ai [--all]
-tina4ruby generate model <name>
-```
-
----
-
-## Performance
-
-Benchmarked with `wrk` — 5,000 requests, 50 concurrent, median of 3 runs:
-
-| Framework | JSON req/s | Deps | Features |
-|-----------|-----------|------|----------|
-| **Tina4 Ruby** | **10,243** | 0 | 55 |
-| Sinatra | 9,548 | 5+ | ~4 |
-
-Tina4 Ruby outperforms Sinatra while delivering **55 features vs ~4** — with zero runtime dependencies.
-
-**Across all 4 Tina4 implementations:**
-
-| | Python | PHP | Ruby | Node.js |
-|---|--------|-----|------|---------|
-| **JSON req/s** | 6,508 | 29,293 | 10,243 | 84,771 |
-| **Dependencies** | 0 | 0 | 0 | 0 |
-| **Features** | 55 | 55 | 55 | 55 |
-
----
-
-## Cross-Framework Parity
-
-Tina4 ships identical features across four languages — same architecture, same conventions, same 55 features:
-
-| | Python | PHP | Ruby | Node.js |
-|---|--------|-----|------|---------|
-| **Package** | `tina4-python` | `tina4stack/tina4php` | `tina4ruby` | `@tina4/core` |
-| **Tests (v3.11.12)** | 2,281 | 2,073 | 2,508 | 2,897 |
-| **Default port** | 7146 | 7145 | 7147 | 7148 |
-
-**~9,700 tests** across all 4 frameworks. See [tina4.com](https://tina4.com).
-
----
-
-## Documentation
-
-Full guides, API reference, and examples at **[tina4.com](https://tina4.com)**.
-
-## License
-
-MIT (c) 2007-2026 Tina4 Stack
-https://opensource.org/licenses/MIT
-
----
-
-## Our Sponsors
-
-**Sponsored with 🩵 by Code Infinity**
-
-[<img src="https://codeinfinity.co.za/wp-content/uploads/2025/09/c8e-logo-github.png" alt="Code Infinity" width="100">](https://codeinfinity.co.za/about-open-source-policy?utm_source=github&utm_medium=website&utm_campaign=opensource_campaign&utm_id=opensource)
-
-*Supporting open source communities • Innovate • Code • Empower*
+<p align="center">
+  <img src="https://tina4.com/logo.svg" alt="Tina4" width="200">
+</p>
+<h1 align="center">Tina4 Ruby</h1>
+<h3 align="center">TINA4 — The Intelligent Native Application 4ramework</h3>
+<p align="center"><em>Simple. Fast. Human. &nbsp;|&nbsp; Built for AI. Built for you.</em></p>
+<p align="center">55 built-in features. Zero runtime dependencies. One require, everything works.</p>
+<p align="center">
+  <a href="https://rubygems.org/gems/tina4ruby"><img src="https://img.shields.io/gem/v/tina4ruby?color=7b1fa2&label=RubyGems" alt="RubyGems"></a>
+  <img src="https://img.shields.io/badge/tests-2%2C508%20passing-brightgreen" alt="Tests">
+  <img src="https://img.shields.io/badge/features-55-blue" alt="Features">
+  <img src="https://img.shields.io/badge/dependencies-0-brightgreen" alt="Zero Deps">
+  <a href="https://tina4.com"><img src="https://img.shields.io/badge/docs-tina4.com-7b1fa2" alt="Docs"></a>
+</p>
+
+---
+
+## Quick Start
+
+```bash
+# With the Tina4 CLI (recommended — enables SCSS + live reload)
+cargo install tina4    # or grab a binary from https://github.com/tina4stack/tina4/releases
+tina4 init ruby ./my-app
+cd my-app && tina4 serve
+
+# Without the Tina4 CLI
+gem install tina4ruby
+tina4ruby init my-app
+cd my-app && tina4ruby serve
+```
+
+Open http://localhost:7147
+
+---
+
+## Code Examples
+
+```ruby
+Tina4.get "/api/hello" do |request, response|
+  response.call({ message: "Hello from Tina4!" }, Tina4::HTTP_OK)
+end
+
+class User < Tina4::ORM
+  integer_field :id, primary_key: true, auto_increment: true
+  string_field :name
+  string_field :email
+end
+
+db = Tina4::Database.new("sqlite://app.db")
+```
+
+---
+
+## What's Included
+
+| Category | Features |
+|----------|----------|
+| **Core HTTP** (7) | Router with path params (`{id:int}`, `{p:path}`), Server, Request/Response, Middleware pipeline, Static file serving, CORS |
+| **Database** (6) | SQLite, PostgreSQL, MySQL, MSSQL, Firebird — unified adapter, connection pooling, query cache, transactions, race-safe ID generation, SQL dialect translation |
+| **ORM** (7) | Active Record with typed fields, relationships (`has_one`/`has_many`/`belongs_to`), soft delete, QueryBuilder + MongoDB support, Auto-CRUD generator, migrations with rollback |
+| **Auth & Security** (5) | JWT (HS256/RS256), password hashing (PBKDF2-SHA256), API key validation, rate limiting, CSRF form tokens |
+| **Templating** (3) | Frond engine (Twig/Jinja2-compatible, pre-compiled 2.8× faster), SCSS auto-compilation, built-in CSS (~24 KB) |
+| **API & Integration** (5) | HTTP client (zero-dep), GraphQL with ORM auto-schema + GraphiQL IDE, WSDL/SOAP with auto WSDL, WebSocket (RFC 6455) + Redis backplane, MCP server (24 dev tools) |
+| **Background** (3) | Job queue (File/RabbitMQ/Kafka/MongoDB) with priority, delay, retry, dead letters — service runner — event system (on/emit/once/off) |
+| **Data & Storage** (4) | Session (File/Redis/Valkey/MongoDB/DB), response cache (LRU, TTL), seeder + 50+ fake data generators, messenger (SMTP/IMAP) |
+| **Developer Tools** (7) | Dev dashboard (11 tabs), dev toolbar, error overlay (Catppuccin Mocha), dev mailbox, hot reload + CSS hot-reload, code metrics (complexity, coupling, maintainability), AI context installer (7 tools) |
+| **Utilities** (7) | DI container (transient + singleton), HtmlElement builder, inline testing (`@tests` decorator), i18n (6 languages), Swagger/OpenAPI auto-generation, CLI scaffolding (`generate model/route/migration/middleware`), structured logging |
+
+**2,508 tests. Zero runtime dependencies. Full parity across Python, PHP, Ruby, and Node.js.**
+
+---
+
+## CLI Reference
+
+```bash
+tina4ruby serve [--port PORT]
+tina4ruby migrate
+tina4ruby seed
+tina4ruby ai [--all]
+tina4ruby generate model <name>
+```
+
+---
+
+## Performance
+
+Benchmarked with `wrk` — 5,000 requests, 50 concurrent, median of 3 runs:
+
+| Framework | JSON req/s | Deps | Features |
+|-----------|-----------|------|----------|
+| **Tina4 Ruby** | **10,243** | 0 | 55 |
+| Sinatra | 9,548 | 5+ | ~4 |
+
+Tina4 Ruby outperforms Sinatra while delivering **55 features vs ~4** — with zero runtime dependencies.
+
+**Across all 4 Tina4 implementations:**
+
+| | Python | PHP | Ruby | Node.js |
+|---|--------|-----|------|---------|
+| **JSON req/s** | 6,508 | 29,293 | 10,243 | 84,771 |
+| **Dependencies** | 0 | 0 | 0 | 0 |
+| **Features** | 55 | 55 | 55 | 55 |
+
+---
+
+## Cross-Framework Parity
+
+Tina4 ships identical features across four languages — same architecture, same conventions, same 55 features:
+
+| | Python | PHP | Ruby | Node.js |
+|---|--------|-----|------|---------|
+| **Package** | `tina4-python` | `tina4stack/tina4php` | `tina4ruby` | `@tina4/core` |
+| **Tests (v3.11.12)** | 2,281 | 2,073 | 2,508 | 2,897 |
+| **Default port** | 7146 | 7145 | 7147 | 7148 |
+
+**~9,700 tests** across all 4 frameworks. See [tina4.com](https://tina4.com).
+
+---
+
+## Documentation
+
+Full guides, API reference, and examples at **[tina4.com](https://tina4.com)**.
+
+## License
+
+MIT (c) 2007-2026 Tina4 Stack
+https://opensource.org/licenses/MIT
+
+---
+
+## Our Sponsors
+
+**Sponsored with 🩵 by Code Infinity**
+
+[<img src="https://codeinfinity.co.za/wp-content/uploads/2025/09/c8e-logo-github.png" alt="Code Infinity" width="100">](https://codeinfinity.co.za/about-open-source-policy?utm_source=github&utm_medium=website&utm_campaign=opensource_campaign&utm_id=opensource)
+
+*Supporting open source communities • Innovate • Code • Empower*

data/exe/tina4ruby

@@ -1,5 +1,5 @@
-#!/usr/bin/env ruby
-# frozen_string_literal: true
-
-require_relative "../lib/tina4/cli"
-Tina4::CLI.start(ARGV)
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/tina4/cli"
+Tina4::CLI.start(ARGV)