RubyGems - tina4ruby - Versions diffs - 0.5.2 → 3.2.1 - Mend

tina4ruby 0.5.2 → 3.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (90) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +1 -1
data/README.md +434 -544
data/exe/{tina4 → tina4ruby} +1 -0
data/lib/tina4/ai.rb +312 -0
data/lib/tina4/auth.rb +44 -3
data/lib/tina4/auto_crud.rb +163 -0
data/lib/tina4/cli.rb +389 -97
data/lib/tina4/constants.rb +46 -0
data/lib/tina4/cors.rb +74 -0
data/lib/tina4/database/sqlite3_adapter.rb +139 -0
data/lib/tina4/database.rb +144 -7
data/lib/tina4/debug.rb +4 -79
data/lib/tina4/dev_admin.rb +1162 -0
data/lib/tina4/dev_mailbox.rb +191 -0
data/lib/tina4/dev_reload.rb +9 -9
data/lib/tina4/drivers/firebird_driver.rb +19 -3
data/lib/tina4/drivers/mssql_driver.rb +3 -3
data/lib/tina4/drivers/mysql_driver.rb +4 -4
data/lib/tina4/drivers/postgres_driver.rb +9 -2
data/lib/tina4/drivers/sqlite_driver.rb +1 -1
data/lib/tina4/env.rb +42 -2
data/lib/tina4/error_overlay.rb +252 -0
data/lib/tina4/events.rb +90 -0
data/lib/tina4/field_types.rb +4 -0
data/lib/tina4/frond.rb +1497 -0
data/lib/tina4/gallery/auth/meta.json +1 -0
data/lib/tina4/gallery/auth/src/routes/api/gallery_auth.rb +114 -0
data/lib/tina4/gallery/database/meta.json +1 -0
data/lib/tina4/gallery/database/src/routes/api/gallery_db.rb +43 -0
data/lib/tina4/gallery/error-overlay/meta.json +1 -0
data/lib/tina4/gallery/error-overlay/src/routes/api/gallery_crash.rb +17 -0
data/lib/tina4/gallery/orm/meta.json +1 -0
data/lib/tina4/gallery/orm/src/routes/api/gallery_products.rb +16 -0
data/lib/tina4/gallery/queue/meta.json +1 -0
data/lib/tina4/gallery/queue/src/routes/api/gallery_queue.rb +325 -0
data/lib/tina4/gallery/rest-api/meta.json +1 -0
data/lib/tina4/gallery/rest-api/src/routes/api/gallery_hello.rb +14 -0
data/lib/tina4/gallery/templates/meta.json +1 -0
data/lib/tina4/gallery/templates/src/routes/gallery_page.rb +12 -0
data/lib/tina4/gallery/templates/src/templates/gallery_page.twig +257 -0
data/lib/tina4/health.rb +39 -0
data/lib/tina4/html_element.rb +148 -0
data/lib/tina4/localization.rb +2 -2
data/lib/tina4/log.rb +203 -0
data/lib/tina4/messenger.rb +562 -0
data/lib/tina4/migration.rb +132 -29
data/lib/tina4/orm.rb +463 -35
data/lib/tina4/public/css/tina4.css +178 -1
data/lib/tina4/public/css/tina4.min.css +1 -2
data/lib/tina4/public/favicon.ico +0 -0
data/lib/tina4/public/images/logo.svg +5 -0
data/lib/tina4/public/images/tina4-logo-icon.webp +0 -0
data/lib/tina4/public/js/frond.min.js +420 -0
data/lib/tina4/public/js/tina4-dev-admin.min.js +367 -0
data/lib/tina4/public/js/tina4.min.js +93 -0
data/lib/tina4/public/swagger/index.html +90 -0
data/lib/tina4/public/swagger/oauth2-redirect.html +63 -0
data/lib/tina4/queue.rb +162 -6
data/lib/tina4/queue_backends/lite_backend.rb +88 -0
data/lib/tina4/rack_app.rb +331 -27
data/lib/tina4/rate_limiter.rb +123 -0
data/lib/tina4/request.rb +61 -15
data/lib/tina4/response.rb +54 -24
data/lib/tina4/response_cache.rb +551 -0
data/lib/tina4/router.rb +90 -15
data/lib/tina4/scss_compiler.rb +2 -2
data/lib/tina4/seeder.rb +56 -61
data/lib/tina4/service_runner.rb +303 -0
data/lib/tina4/session.rb +85 -0
data/lib/tina4/session_handlers/mongo_handler.rb +1 -1
data/lib/tina4/session_handlers/valkey_handler.rb +43 -0
data/lib/tina4/shutdown.rb +84 -0
data/lib/tina4/sql_translation.rb +295 -0
data/lib/tina4/template.rb +36 -6
data/lib/tina4/templates/base.twig +2 -2
data/lib/tina4/templates/errors/302.twig +14 -0
data/lib/tina4/templates/errors/401.twig +9 -0
data/lib/tina4/templates/errors/403.twig +22 -15
data/lib/tina4/templates/errors/404.twig +22 -15
data/lib/tina4/templates/errors/500.twig +31 -15
data/lib/tina4/templates/errors/502.twig +9 -0
data/lib/tina4/templates/errors/503.twig +12 -0
data/lib/tina4/templates/errors/base.twig +37 -0
data/lib/tina4/version.rb +1 -1
data/lib/tina4/webserver.rb +28 -18
data/lib/tina4.rb +118 -21
metadata +68 -8
data/lib/tina4/public/js/tina4.js +0 -134
data/lib/tina4/public/js/tina4helper.js +0 -387

data/lib/tina4/gallery/auth/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Auth", "description": "JWT login form with token display", "try_url": "/gallery/auth"}

data/lib/tina4/gallery/auth/src/routes/api/gallery_auth.rb ADDED Viewed

@@ -0,0 +1,114 @@
+# Gallery: Auth — JWT login with a visual demo page.
+Tina4::Router.get("/gallery/auth") do |request, response|
+  html = <<~HTML
+    <!DOCTYPE html>
+    <html lang="en">
+    <head>
+    <meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+    <title>Auth Demo</title><link rel="stylesheet" href="/css/tina4.min.css">
+    </head>
+    <body class="bg-dark text-light">
+    <div class="container mt-5" style="max-width:600px;">
+        <h2 class="mb-4">JWT Authentication Demo</h2>
+        <div class="card mb-4">
+            <div class="card-header bg-primary text-white">Login</div>
+            <div class="card-body">
+                <div class="form-group mb-3">
+                    <label class="form-label">Username</label>
+                    <input type="text" id="username" class="form-control" placeholder="admin" value="admin">
+                </div>
+                <div class="form-group mb-3">
+                    <label class="form-label">Password</label>
+                    <input type="password" id="password" class="form-control" placeholder="secret" value="secret">
+                </div>
+                <button class="btn btn-primary" onclick="doLogin()">Login</button>
+            </div>
+        </div>
+        <div id="result" style="display:none;">
+            <div class="card mb-3">
+                <div class="card-header bg-success text-white">Token Received</div>
+                <div class="card-body">
+                    <pre id="token" style="word-break:break-all;white-space:pre-wrap;color:#4ade80;background:#1e293b;padding:1rem;border-radius:0.5rem;"></pre>
+                </div>
+            </div>
+            <div class="card mb-3">
+                <div class="card-header">Token Payload (decoded)</div>
+                <div class="card-body">
+                    <pre id="payload" style="color:#38bdf8;background:#1e293b;padding:1rem;border-radius:0.5rem;"></pre>
+                </div>
+            </div>
+            <button class="btn btn-outline-info" onclick="verifyToken()">Verify Token</button>
+            <span id="verify-result" class="ms-2"></span>
+        </div>
+        <div class="card bg-dark mt-4" style="border:1px solid #334155;">
+            <div class="card-body">
+                <h6 style="color:#e2e8f0;">How it works</h6>
+                <pre style="background:#0f172a;color:#4ade80;padding:1rem;border-radius:0.5rem;font-size:0.8rem;"><code>token = Tina4::Auth.create_token({ username: "admin" })
+    payload = Tina4::Auth.get_payload(token)
+    result = Tina4::Auth.validate_token(token)</code></pre>
+            </div>
+        </div>
+    </div>
+    <script>
+    var currentToken = '';
+    function doLogin() {
+        fetch('/api/gallery/auth/login', {
+            method: 'POST',
+            headers: {'Content-Type': 'application/json'},
+            body: JSON.stringify({
+                username: document.getElementById('username').value,
+                password: document.getElementById('password').value
+            })
+        }).then(r => r.json()).then(d => {
+            if (d.token) {
+                currentToken = d.token;
+                document.getElementById('token').textContent = d.token;
+                try {
+                    var parts = d.token.split('.');
+                    var payload = JSON.parse(atob(parts[1]));
+                    document.getElementById('payload').textContent = JSON.stringify(payload, null, 2);
+                } catch(e) {
+                    document.getElementById('payload').textContent = 'Could not decode';
+                }
+                document.getElementById('result').style.display = 'block';
+                document.getElementById('verify-result').textContent = '';
+            } else {
+                alert(d.error || 'Login failed');
+            }
+        });
+    }
+    function verifyToken() {
+        fetch('/api/gallery/auth/verify?token=' + encodeURIComponent(currentToken))
+        .then(r => r.json()).then(d => {
+            var el = document.getElementById('verify-result');
+            if (d.valid) {
+                el.innerHTML = '<span class="badge bg-success">Valid</span>';
+            } else {
+                el.innerHTML = '<span class="badge bg-danger">Invalid</span>';
+            }
+        });
+    }
+    </script>
+    </body></html>
+  HTML
+  response.html(html)
+end
+Tina4::Router.post("/api/gallery/auth/login") do |request, response|
+  body = request.body || {}
+  username = body["username"].to_s
+  password = body["password"].to_s
+  if !username.empty? && !password.empty?
+    token = Tina4::Auth.create_token({ username: username, role: "user" })
+    response.json({ token: token, message: "Welcome #{username}!" })
+  else
+    response.json({ error: "Username and password required" }, 401)
+  end
+end
+Tina4::Router.get("/api/gallery/auth/verify") do |request, response|
+  token = request.params["token"].to_s
+  result = Tina4::Auth.validate_token(token)
+  response.json({ valid: result[:valid] })
+end

data/lib/tina4/gallery/database/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Database", "description": "Raw SQL queries with the Database class", "try_url": "/api/gallery/db/tables"}

data/lib/tina4/gallery/database/src/routes/api/gallery_db.rb ADDED Viewed

@@ -0,0 +1,43 @@
+# Gallery: Database — raw SQL query demo.
+Tina4::Router.get("/api/gallery/db/tables") do |request, response|
+  begin
+    db = Tina4::Database.new("sqlite://data/gallery.db")
+    db.execute(<<~SQL)
+      CREATE TABLE IF NOT EXISTS gallery_notes (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        title TEXT NOT NULL,
+        body TEXT,
+        created_at DATETIME DEFAULT CURRENT_TIMESTAMP
+      )
+    SQL
+    tables = db.tables
+    response.json({ tables: tables, engine: "sqlite" })
+  rescue => e
+    response.json({ error: e.message }, 500)
+  end
+end
+Tina4::Router.post("/api/gallery/db/notes") do |request, response|
+  begin
+    db = Tina4::Database.new("sqlite://data/gallery.db")
+    body = request.body || {}
+    db.insert("gallery_notes", {
+      title: body["title"] || "Untitled",
+      body: body["body"] || ""
+    })
+    response.json({ created: true }, 201)
+  rescue => e
+    response.json({ error: e.message }, 500)
+  end
+end
+Tina4::Router.get("/api/gallery/db/notes") do |request, response|
+  begin
+    db = Tina4::Database.new("sqlite://data/gallery.db")
+    result = db.fetch("SELECT * FROM gallery_notes ORDER BY id DESC", [], limit: 50)
+    response.json(result.to_a)
+  rescue => e
+    response.json({ error: e.message }, 500)
+  end
+end

data/lib/tina4/gallery/error-overlay/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Error Overlay", "description": "See the rich debug error page with stack trace and source code", "try_url": "/api/gallery/crash"}

data/lib/tina4/gallery/error-overlay/src/routes/api/gallery_crash.rb ADDED Viewed

@@ -0,0 +1,17 @@
+# Gallery: Error Overlay — deliberately crash to demo the debug overlay.
+#
+# This route deliberately raises an error to showcase the error overlay.
+#
+# In debug mode (TINA4_DEBUG=true), you will see:
+# - Exception type and message
+# - Stack trace with syntax-highlighted source code
+# - The exact line that caused the error (highlighted)
+# - Request details (method, path, headers)
+# - Environment info (framework version, Ruby version)
+Tina4::Router.get("/api/gallery/crash") do |request, response|
+  # Simulate a realistic error — accessing a missing key
+  user = { name: "Alice", email: "alice@example.com" }
+  role = user.fetch(:role) # KeyError: key not found: :role — this line will be highlighted in the overlay
+  response.json({ role: role })
+end

data/lib/tina4/gallery/orm/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "ORM", "description": "Product model with CRUD endpoints", "try_url": "/api/gallery/products"}

data/lib/tina4/gallery/orm/src/routes/api/gallery_products.rb ADDED Viewed

@@ -0,0 +1,16 @@
+# Gallery: ORM — Product CRUD endpoints.
+Tina4::Router.get("/api/gallery/products") do |request, response|
+  response.json({
+    products: [
+      { id: 1, name: "Widget", price: 9.99 },
+      { id: 2, name: "Gadget", price: 24.99 }
+    ],
+    note: "Connect a database and deploy the ORM model for live data"
+  })
+end
+Tina4::Router.post("/api/gallery/products") do |request, response|
+  data = request.body || {}
+  response.json({ created: data, id: 3 }, 201)
+end

data/lib/tina4/gallery/queue/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Queue", "description": "Background job producer and consumer", "try_url": "/gallery/queue"}

data/lib/tina4/gallery/queue/src/routes/api/gallery_queue.rb ADDED Viewed

@@ -0,0 +1,325 @@
+# Gallery: Queue — interactive queue demo with visual web UI.
+#
+# Uses a SQLite database directly for the demo queue table,
+# matching the Python gallery demo's database-backed approach.
+require "json"
+def _gallery_queue_db
+  @_gallery_queue_db ||= begin
+    db = Tina4::Database.new("sqlite://data/gallery_queue.db")
+    unless db.table_exists?("tina4_queue")
+      db.execute("CREATE TABLE tina4_queue (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        topic TEXT NOT NULL,
+        data TEXT NOT NULL,
+        status TEXT NOT NULL DEFAULT 'pending',
+        priority INTEGER NOT NULL DEFAULT 0,
+        attempts INTEGER NOT NULL DEFAULT 0,
+        error TEXT,
+        available_at TEXT NOT NULL,
+        created_at TEXT NOT NULL,
+        completed_at TEXT,
+        reserved_at TEXT
+      )")
+    end
+    db
+  end
+end
+def _gallery_queue_now
+  Time.now.utc.iso8601
+end
+GALLERY_QUEUE_MAX_RETRIES = 3
+GALLERY_QUEUE_HTML = <<~'HTML'
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>Queue Gallery — Tina4 Ruby</title>
+    <link rel="stylesheet" href="/css/tina4.min.css">
+</head>
+<body>
+<div class="container mt-4 mb-4">
+    <h1>Queue Gallery</h1>
+    <p class="text-muted">Interactive demo of Tina4's database-backed job queue. Produce messages, consume them, simulate failures, and inspect dead letters.</p>
+    <div class="row mt-3">
+        <div class="col-md-6">
+            <div class="card">
+                <div class="card-header">Produce a Message</div>
+                <div class="card-body">
+                    <div class="d-flex gap-2">
+                        <input type="text" id="msgInput" class="form-control" placeholder="Enter a task message, e.g. send-email">
+                        <button class="btn btn-primary" onclick="produce()">Produce</button>
+                    </div>
+                </div>
+            </div>
+        </div>
+        <div class="col-md-6">
+            <div class="card">
+                <div class="card-header">Actions</div>
+                <div class="card-body d-flex gap-2 flex-wrap">
+                    <button class="btn btn-success" onclick="consume()">Consume Next</button>
+                    <button class="btn btn-danger" onclick="failNext()">Fail Next</button>
+                    <button class="btn btn-warning" onclick="retryFailed()">Retry Failed</button>
+                    <button class="btn btn-secondary" onclick="refresh()">Refresh</button>
+                </div>
+            </div>
+        </div>
+    </div>
+    <div id="alertArea" class="mt-3"></div>
+    <div class="card mt-3">
+        <div class="card-header d-flex justify-content-between align-items-center">
+            <span>Queue Messages</span>
+            <small class="text-muted" id="lastRefresh"></small>
+        </div>
+        <div class="card-body p-0">
+            <table class="table table-striped mb-0">
+                <thead>
+                    <tr>
+                        <th>ID</th>
+                        <th>Data</th>
+                        <th>Status</th>
+                        <th>Attempts</th>
+                        <th>Error</th>
+                        <th>Created</th>
+                    </tr>
+                </thead>
+                <tbody id="queueBody">
+                    <tr><td colspan="6" class="text-center text-muted">Loading...</td></tr>
+                </tbody>
+            </table>
+        </div>
+    </div>
+</div>
+<script>
+function statusBadge(status) {
+    var colors = {pending:"primary", reserved:"warning", completed:"success", failed:"danger", dead:"secondary"};
+    var color = colors[status] || "secondary";
+    return '<span class="badge bg-' + color + '">' + status + '</span>';
+}
+function showAlert(msg, type) {
+    var area = document.getElementById("alertArea");
+    area.innerHTML = '<div class="alert alert-' + type + ' alert-dismissible">' + msg +
+        '<button type="button" class="btn-close" onclick="this.parentElement.remove()"></button></div>';
+    setTimeout(function(){ area.innerHTML = ""; }, 3000);
+}
+function truncate(s, n) {
+    if (!s) return "";
+    return s.length > n ? s.substring(0, n) + "..." : s;
+}
+async function refresh() {
+    try {
+        var r = await fetch("/api/gallery/queue/status");
+        var data = await r.json();
+        var tbody = document.getElementById("queueBody");
+        if (!data.messages || data.messages.length === 0) {
+            tbody.innerHTML = '<tr><td colspan="6" class="text-center text-muted">No messages in queue. Produce one above.</td></tr>';
+        } else {
+            var html = "";
+            for (var i = 0; i < data.messages.length; i++) {
+                var m = data.messages[i];
+                html += "<tr><td>" + m.id + "</td><td><code>" + truncate(m.data, 60) + "</code></td><td>" +
+                    statusBadge(m.status) + "</td><td>" + m.attempts + "</td><td>" +
+                    truncate(m.error || "", 40) + "</td><td><small>" + (m.created_at || "") + "</small></td></tr>";
+            }
+            tbody.innerHTML = html;
+        }
+        document.getElementById("lastRefresh").textContent = "Updated " + new Date().toLocaleTimeString();
+    } catch (e) {
+        console.error(e);
+    }
+}
+async function produce() {
+    var input = document.getElementById("msgInput");
+    var task = input.value.trim() || "demo-task";
+    var r = await fetch("/api/gallery/queue/produce", {
+        method: "POST", headers: {"Content-Type":"application/json"},
+        body: JSON.stringify({task: task, data: {message: task}})
+    });
+    var d = await r.json();
+    showAlert("Produced message: " + task, "success");
+    input.value = "";
+    refresh();
+}
+async function consume() {
+    var r = await fetch("/api/gallery/queue/consume", {method:"POST"});
+    var d = await r.json();
+    if (d.consumed) {
+        showAlert("Consumed job #" + d.job_id + " successfully", "success");
+    } else {
+        showAlert(d.message || "Nothing to consume", "info");
+    }
+    refresh();
+}
+async function failNext() {
+    var r = await fetch("/api/gallery/queue/fail", {method:"POST"});
+    var d = await r.json();
+    if (d.failed) {
+        showAlert("Deliberately failed job #" + d.job_id, "danger");
+    } else {
+        showAlert(d.message || "Nothing to fail", "info");
+    }
+    refresh();
+}
+async function retryFailed() {
+    var r = await fetch("/api/gallery/queue/retry", {method:"POST"});
+    var d = await r.json();
+    showAlert("Retried " + (d.retried || 0) + " failed message(s)", "warning");
+    refresh();
+}
+refresh();
+setInterval(refresh, 2000);
+</script>
+</body>
+</html>
+HTML
+# ── Render the interactive HTML page ──────────────────────────
+Tina4::Router.get("/gallery/queue") do |request, response|
+  response.html(GALLERY_QUEUE_HTML)
+end
+# ── Produce — add a message to the queue ──────────────────────
+Tina4::Router.post("/api/gallery/queue/produce") do |request, response|
+  body = request.body || {}
+  task = body["task"] || "default-task"
+  data = body["data"] || {}
+  db = _gallery_queue_db
+  now = _gallery_queue_now
+  payload = JSON.generate({ task: task, data: data })
+  db.execute(
+    "INSERT INTO tina4_queue (topic, data, status, priority, attempts, available_at, created_at) VALUES (?, ?, 'pending', 0, 0, ?, ?)",
+    ["gallery-tasks", payload, now, now]
+  )
+  row = db.fetch_one("SELECT last_insert_rowid() as last_id")
+  job_id = row ? row["last_id"] : 0
+  response.json({ queued: true, task: task, job_id: job_id }, 201)
+end
+# ── Status — list all messages with statuses ──────────────────
+Tina4::Router.get("/api/gallery/queue/status") do |request, response|
+  db = _gallery_queue_db
+  result = db.fetch(
+    "SELECT * FROM tina4_queue WHERE topic = ? ORDER BY id DESC",
+    ["gallery-tasks"],
+    limit: 100
+  )
+  messages = []
+  counts = { pending: 0, reserved: 0, completed: 0, failed: 0 }
+  (result.respond_to?(:records) ? result.records : (result || [])).each do |row|
+    status = row["status"] || "pending"
+    attempts = (row["attempts"] || 0).to_i
+    display_status = status
+    if status == "failed" && attempts >= GALLERY_QUEUE_MAX_RETRIES
+      display_status = "dead"
+    end
+    counts[status.to_sym] = (counts[status.to_sym] || 0) + 1 if counts.key?(status.to_sym)
+    messages << {
+      id: row["id"],
+      data: row["data"] || "",
+      status: display_status,
+      attempts: attempts,
+      error: row["error"] || "",
+      created_at: row["created_at"] || ""
+    }
+  end
+  response.json({
+    topic: "gallery-tasks",
+    messages: messages,
+    counts: counts
+  })
+end
+# ── Consume — process the next pending message ────────────────
+Tina4::Router.post("/api/gallery/queue/consume") do |request, response|
+  db = _gallery_queue_db
+  now = _gallery_queue_now
+  row = db.fetch_one(
+    "SELECT * FROM tina4_queue WHERE topic = ? AND status = 'pending' AND available_at <= ? ORDER BY priority DESC, id ASC",
+    ["gallery-tasks", now]
+  )
+  if row.nil?
+    response.json({ consumed: false, message: "No pending messages to consume" })
+  else
+    db.execute(
+      "UPDATE tina4_queue SET status = 'completed', completed_at = ? WHERE id = ? AND status = 'pending'",
+      [now, row["id"]]
+    )
+    response.json({ consumed: true, job_id: row["id"], data: row["data"] })
+  end
+end
+# ── Fail — deliberately fail the next pending message ─────────
+Tina4::Router.post("/api/gallery/queue/fail") do |request, response|
+  db = _gallery_queue_db
+  now = _gallery_queue_now
+  row = db.fetch_one(
+    "SELECT * FROM tina4_queue WHERE topic = ? AND status = 'pending' AND available_at <= ? ORDER BY priority DESC, id ASC",
+    ["gallery-tasks", now]
+  )
+  if row.nil?
+    response.json({ failed: false, message: "No pending messages to fail" })
+  else
+    db.execute(
+      "UPDATE tina4_queue SET status = 'failed', error = ?, attempts = attempts + 1 WHERE id = ?",
+      ["Deliberately failed via gallery demo", row["id"]]
+    )
+    response.json({ failed: true, job_id: row["id"], data: row["data"] })
+  end
+end
+# ── Retry — re-queue failed messages ──────────────────────────
+Tina4::Router.post("/api/gallery/queue/retry") do |request, response|
+  db = _gallery_queue_db
+  now = _gallery_queue_now
+  db.execute(
+    "UPDATE tina4_queue SET status = 'pending', available_at = ? WHERE topic = ? AND status = 'failed' AND attempts < ?",
+    [now, "gallery-tasks", GALLERY_QUEUE_MAX_RETRIES]
+  )
+  row = db.fetch_one(
+    "SELECT COUNT(*) as cnt FROM tina4_queue WHERE topic = ? AND status = 'pending'",
+    ["gallery-tasks"]
+  )
+  retried = row ? row["cnt"].to_i : 0
+  response.json({ retried: retried })
+end

data/lib/tina4/gallery/rest-api/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "REST API", "description": "A simple JSON API with GET and POST endpoints", "try_url": "/api/gallery/hello"}

data/lib/tina4/gallery/rest-api/src/routes/api/gallery_hello.rb ADDED Viewed

@@ -0,0 +1,14 @@
+# Gallery: REST API — simple JSON endpoints.
+Tina4::Router.get("/api/gallery/hello") do |request, response|
+  response.json({ message: "Hello from Tina4!", method: "GET" })
+end
+Tina4::Router.get("/api/gallery/hello/{name}") do |request, response|
+  response.json({ message: "Hello #{request.params["name"]}!", method: "GET" })
+end
+Tina4::Router.post("/api/gallery/hello") do |request, response|
+  data = request.body || {}
+  response.json({ echo: data, method: "POST" }, 201)
+end

data/lib/tina4/gallery/templates/meta.json ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"name": "Templates", "description": "Twig template with dynamic data", "try_url": "/gallery/page"}

data/lib/tina4/gallery/templates/src/routes/gallery_page.rb ADDED Viewed

@@ -0,0 +1,12 @@
+# Gallery: Templates — render an HTML page with dynamic data via template.
+Tina4::Router.get "/gallery/page", template: "gallery_page.twig" do |request, response|
+  response.call({
+    title: "Gallery Demo Page",
+    items: [
+      { name: "Tina4 Ruby", description: "Zero-dep web framework", badge: "v3.0.0" },
+      { name: "Twig Engine", description: "Built-in template rendering", badge: "included" },
+      { name: "Auto-Reload", description: "Templates refresh on save", badge: "dev mode" }
+    ]
+  }, Tina4::HTTP_OK)
+end