tarsier 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01eb416d71704d9bd9fa4ec5b9cbdf04cf8e4384343791a4895c57b97e275bcc
-  data.tar.gz: 1e4c18917ba174fda64094a4fe20bc2b5df714b3d797e0f7175b155829f0d8cd
+  metadata.gz: bf96475cd9f2aec9a31bc0c4686bfce7c54bc2e963bee68639b0c062847f6d11
+  data.tar.gz: 36028c91e5f5d7156f30b8f17ecc85ec8e9294f39db2b34b88978c7bbd335b32
 SHA512:
-  metadata.gz: 29edfa202c43d584aab94b16dd876824adf232425c500f57d2d89ba39cc5f992e8d7bc0e59a740c889b275dfd6a7533d0a4b4cb70c09d8514bff025ae32310ee
-  data.tar.gz: f0a3a46be85efeb607f0b4398be3e4b529d452c9f2f295982c5eff43be336429e69e57a27d4ab1be0c5835724a42e73ae0619f9e01f7594ad0e30d08b8de4a2b
+  metadata.gz: b888e28e58a2fa5444e9362a34baf1d5653f669d1d00652daf98522f700affbce6f4c0b2e52efe070e9c76fecfe38558b11300cff77154054369c0b30cc05660
+  data.tar.gz: c7658b5ce137659fd5cb6ecf0cfc8bc8e2bb6cb0cb318586889cf0b61290bcc09c24251e553e3da3f2cca901c39983a988aa256fd95a6a6231f9a4612222dde5

data/CHANGELOG.md

@@ -8,6 +8,41 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 
+## [0.1.1] - 2026-01-09
+
+### Fixed
+
+- **Router**: Fixed root path matching edge case with trailing slashes - paths like `/users/` now correctly match `/users`
+- **Response**: Fixed `content_type=` method signature - keyword arguments don't work with assignment syntax in Ruby. Added `set_content_type` method for charset option
+- **Errors**: Removed duplicate `ValidationError` and `RecordNotFoundError` class definitions from `model.rb` - now defined only in `errors.rb`
+- **Query**: `exists?` method now handles missing database connection gracefully
+- **CSRF Middleware**: Token is now exposed to views via `request.env["tarsier.csrf_token"]` and response header `X-CSRF-Token`
+- **Params**: Removed unused error variable in rescue block for cleaner code
+- **Controller**: `validated_params` now returns raw params as hash when no schema is defined, instead of empty hash
+- **Static Middleware**: Improved directory traversal protection with proper path resolution using `File.expand_path`
+- **Middleware::Base**: Fixed `after` hook to receive the response object instead of the result
+
+### Added
+
+- **Request**: Added `to_h` / `to_hash` method for debugging and logging request data
+- **Response**: Added `status_text` helper method to get human-readable status text (e.g., "OK", "Not Found")
+- **Router**: Added `route_exists?(method, path)` method for quick route existence checks
+- **Model**: Added `first`, `first!`, `last`, `last!` class methods for convenience
+- **Model**: Added `find_by!` class method that raises `RecordNotFoundError` when no record found
+- **Query**: Added `first!` and `last!` methods that raise `RecordNotFoundError` when no record found
+- **RateLimit Middleware**: Added `skip` option to bypass rate limiting for specific paths (e.g., health checks)
+- **Logger Middleware**: Added request ID tracking with `X-Request-Id` header propagation for distributed tracing
+- **Application**: Added `env` accessor method for direct access to current environment
+- **Database**: Added `ping` and `alive?` methods to check database connection health
+- **WebSocket**: Added `on_error` handler support for error handling during WebSocket connections
+- **CLI Generators**: Improved error messages with specific details for permission denied and other failures
+
+### Changed
+
+- **RecordNotFoundError**: Now accepts optional `id` parameter for more flexible error messages
+- **Logger Middleware**: Now generates/propagates request IDs by default (can be disabled with `request_id: false`)
+
+
 ## [0.1.0] - 2025-01-01
 
 ### Added

data/README.md

@@ -1,7 +1,7 @@
-# Tarsier
+# Tarsier 🐒
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/tarsier-rb/tarsier/main/assets/logo.png" alt="Tarsier Logo" width="200">
+  <img src="/assets/logo.png" alt="Tarsier Logo" width="200">
 </p>
 
 <p align="center">
@@ -10,21 +10,58 @@
 
 <p align="center">
   <a href="https://www.ruby-lang.org/"><img src="https://img.shields.io/badge/ruby-%3E%3D%203.3-red.svg" alt="Ruby"></a>
-  <a href="LICENSE.txt"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <a href="https://discord.gg/jkDzBpYA"><img src="https://img.shields.io/discord/YOUR_DISCORD_ID?color=7289da&label=discord&logo=discord&logoColor=white" alt="Discord"></a>
 </p>
 
 ---
 
 Tarsier delivers sub-millisecond routing through a compiled radix tree architecture while maintaining an intuitive API that feels natural to Ruby developers.
 
+## 🚀 Quick Start
+
+```bash
+# Install Tarsier
+gem install tarsier
+
+# Create a new app
+tarsier new my_app
+cd my_app
+
+# Start the server
+tarsier server
+# => Listening on http://localhost:7827
+```
+
+Or create a minimal app:
+
+```ruby
+# app.rb
+require 'tarsier'
+
+app = Tarsier.app do
+  get('/') { { message: 'Hello, World!' } }
+  get('/users/:id') { |req| { user_id: req.params[:id] } }
+end
+
+run app
+```
+
+### 📊 Performance Highlights
+
+- **700,000+** routes per second
+- **Sub-millisecond** response times
+- **Zero** runtime dependencies
+- **100%** type coverage with RBS
+
 ---
 
 ## Table of Contents
 
+- [Quick Start](#-quick-start)
 - [Features](#features)
 - [Requirements](#requirements)
 - [Installation](#installation)
-- [Quick Start](#quick-start)
 - [Command Line Interface](#command-line-interface)
 - [Routing](#routing)
 - [Controllers](#controllers)
@@ -36,6 +73,7 @@ Tarsier delivers sub-millisecond routing through a compiled radix tree architect
 - [Configuration](#configuration)
 - [Testing](#testing)
 - [Benchmarks](#benchmarks)
+- [Community](#community)
 - [Contributing](#contributing)
 - [License](#license)
 
@@ -43,14 +81,14 @@ Tarsier delivers sub-millisecond routing through a compiled radix tree architect
 
 ## Features
 
-- **High Performance**: Compiled radix tree router achieving 700,000+ routes per second
-- **Zero Runtime Dependencies**: Core framework operates without external dependencies
-- **Multi-Database Support**: Built-in support for SQLite, PostgreSQL, and MySQL
-- **Modern Ruby**: Built for Ruby 3.3+ with YJIT and Fiber scheduler support
-- **Async Native**: First-class support for Fiber-based concurrency patterns
-- **Type Safety Ready**: Complete RBS type signatures for static analysis
-- **Developer Experience**: Intuitive APIs, detailed error messages, minimal boilerplate
-- **Production Ready**: Built-in middleware for CORS, CSRF, rate limiting, and compression
+- ⚡ **High Performance**: Compiled radix tree router achieving 700,000+ routes per second
+- 📦 **Zero Runtime Dependencies**: Core framework operates without external dependencies
+- 🗄️ **Multi-Database Support**: Built-in support for SQLite, PostgreSQL, and MySQL
+- 💎 **Modern Ruby**: Built for Ruby 3.3+ with YJIT and Fiber scheduler support
+- 🔄 **Async Native**: First-class support for Fiber-based concurrency patterns
+- 📝 **Type Safety Ready**: Complete RBS type signatures for static analysis
+- 🚀 **Developer Experience**: Intuitive APIs, detailed error messages, minimal boilerplate
+- 🔒 **Production Ready**: Built-in middleware for CORS, CSRF, rate limiting, and compression
 
 ---
 
@@ -81,48 +119,7 @@ Or install globally for CLI access:
 gem install tarsier
 ```
 
----
-
-## Quick Start
-
-Create a new application:
-
-```bash
-tarsier new my_app
-cd my_app
-bin/server
-```
-
-Or create a minimal application manually:
-
-```ruby
-# app.rb
-require 'tarsier'
-
-# Flask-style minimal syntax
-app = Tarsier.app do
-  get('/') { { message: 'Hello, World!' } }
-  
-  get('/users/:id') do |req|
-    { user_id: req.params[:id] }
-  end
-  
-  post('/users') do |req, res|
-    res.status = 201
-    { created: true, name: req.params[:name] }
-  end
-end
-
-run app
-```
-
-Start the server:
-
-```bash
-rackup app.rb
-```
-
-Visit `http://localhost:9292` to see your application running.
+> 📖 **Need help getting started?** Check out our [comprehensive documentation website](https://tarsier-rb.github.io/tarsier) with step-by-step guides, examples, and API reference.
 
 ---
 
@@ -947,6 +944,24 @@ Benchmarks performed on Ruby 3.3 with YJIT enabled.
 
 ---
 
+## Community
+
+Join the Tarsier community to get help, share ideas, and contribute to the project:
+
+- 💬 **Discord**: [Join our Discord server](https://discord.gg/jkDzBpYA) for real-time discussions and support
+- �  **Documentation**: [Complete documentation website](https://tarsier-rb.github.io/tarsier) with guides and examples
+- � ***Issues**: [Report bugs or request features](https://github.com/tarsier-rb/tarsier/issues) on GitHub
+- 💎 **RubyGems**: [View package details](https://rubygems.org/gems/tarsier) and installation stats
+
+### Getting Help
+
+- Check the [documentation](https://tarsier-rb.github.io/tarsier) for comprehensive guides
+- Join our [Discord community](https://discord.gg/jkDzBpYA) for quick questions and discussions
+- Search [existing issues](https://github.com/tarsier-rb/tarsier/issues) before creating new ones
+- Follow the [contributing guidelines](#contributing) when submitting PRs
+
+---
+
 ## Contributing
 
 1. Fork the repository
@@ -975,10 +990,12 @@ bundle exec yard doc
 
 ## License
 
-Tarsier is released under the [MIT License](LICENSE.txt).
+Tarsier is released under the [MIT License](LICENSE).
 
 ---
 
 ## Acknowledgments
 
 Tarsier draws inspiration from the Ruby web framework ecosystem, particularly Rails, Sinatra, and Roda, while pursuing its own vision of performance and simplicity.
+
+Special thanks to our community members and contributors who help make Tarsier better every day. Join us on [Discord](https://discord.gg/jkDzBpYA) to be part of the journey!

data/lib/tarsier/application.rb

@@ -32,6 +32,11 @@ module Tarsier
     # @return [Configuration] application configuration
     attr_reader :config
 
+    # @return [String] current environment
+    def env
+      Tarsier.env
+    end
+
     # Create a new application
     def initialize
       @router = Router.new

data/lib/tarsier/cli/generators/app.rb

@@ -107,6 +107,9 @@ module Tarsier
               # Load application files
               Dir[File.expand_path("../app/**/*.rb", __dir__)].sort.each { |f| require f }
 
+              # Load routes
+              require_relative "routes"
+
               Tarsier.application do
                 configure do
                   self.secret_key = ENV.fetch("SECRET_KEY", "development_secret_\#{SecureRandom.hex(32)}")
@@ -115,17 +118,6 @@ module Tarsier
                 # Middleware
                 use Tarsier::Middleware::Logger
                 #{options[:api] ? "" : "use Tarsier::Middleware::Static, root: 'public'"}
-
-                # Routes
-                routes do
-                  root to: "home#index"
-
-                  # Add your routes here
-                  # resources :users
-                  # namespace :api do
-                  #   resources :posts
-                  # end
-                end
               end
             RUBY
           end
@@ -134,8 +126,8 @@ module Tarsier
             <<~RUBY
               # frozen_string_literal: true
 
-              # This file documents your routes.
-              # Routes are defined in config/application.rb within the routes block.
+              # Define your application routes here
+              # Routes are automatically loaded by config/application.rb
               #
               # Example routes:
               #   root to: "home#index"
@@ -144,6 +136,16 @@ module Tarsier
               #   namespace :api do
               #     resources :posts
               #   end
+
+              Tarsier.routes do
+                root to: "home#index"
+
+                # Add your routes here
+                # resources :users
+                # namespace :api do
+                #   resources :posts
+                # end
+              end
             RUBY
           end
 

data/lib/tarsier/cli/generators/base.rb

@@ -19,16 +19,33 @@ module Tarsier
 
         def create_file(path, content)
           dir = File.dirname(path)
-          FileUtils.mkdir_p(dir) unless File.directory?(dir)
+          
+          begin
+            FileUtils.mkdir_p(dir) unless File.directory?(dir)
+          rescue Errno::EACCES => e
+            puts "  \e[31merror\e[0m  Cannot create directory #{dir}: Permission denied"
+            return false
+          rescue StandardError => e
+            puts "  \e[31merror\e[0m  Cannot create directory #{dir}: #{e.message}"
+            return false
+          end
 
           if File.exist?(path)
             puts "  \e[33mskip\e[0m  #{path} (already exists)"
             return false
           end
 
-          File.write(path, content)
-          puts "  \e[32mcreate\e[0m  #{path}"
-          true
+          begin
+            File.write(path, content)
+            puts "  \e[32mcreate\e[0m  #{path}"
+            true
+          rescue Errno::EACCES
+            puts "  \e[31merror\e[0m  Cannot write to #{path}: Permission denied"
+            false
+          rescue StandardError => e
+            puts "  \e[31merror\e[0m  Cannot write to #{path}: #{e.message}"
+            false
+          end
         end
 
         def create_directory(path)
@@ -37,9 +54,17 @@ module Tarsier
             return false
           end
 
-          FileUtils.mkdir_p(path)
-          puts "  \e[32mcreate\e[0m  #{path}/"
-          true
+          begin
+            FileUtils.mkdir_p(path)
+            puts "  \e[32mcreate\e[0m  #{path}/"
+            true
+          rescue Errno::EACCES
+            puts "  \e[31merror\e[0m  Cannot create directory #{path}: Permission denied"
+            false
+          rescue StandardError => e
+            puts "  \e[31merror\e[0m  Cannot create directory #{path}: #{e.message}"
+            false
+          end
         end
 
         def append_to_file(path, content)
@@ -48,9 +73,17 @@ module Tarsier
             return false
           end
 
-          File.open(path, "a") { |f| f.puts content }
-          puts "  \e[32mappend\e[0m  #{path}"
-          true
+          begin
+            File.open(path, "a") { |f| f.puts content }
+            puts "  \e[32mappend\e[0m  #{path}"
+            true
+          rescue Errno::EACCES
+            puts "  \e[31merror\e[0m  Cannot append to #{path}: Permission denied"
+            false
+          rescue StandardError => e
+            puts "  \e[31merror\e[0m  Cannot append to #{path}: #{e.message}"
+            false
+          end
         end
 
         def camelize(string)

data/lib/tarsier/controller.rb

@@ -107,9 +107,10 @@ module Tarsier
     end
 
     # Get validated parameters
+    # Returns validated params if schema defined, otherwise returns raw params as hash
     # @return [Hash]
     def validated_params
-      @validated_params ||= {}
+      @validated_params ||= (self.class.param_schema ? {} : @params.to_h)
     end
 
     # Render a response

data/lib/tarsier/database.rb

@@ -166,6 +166,38 @@ module Tarsier
         @connected && !@raw_connection.nil?
       end
 
+      # Check if the database connection is alive
+      # Performs a simple query to verify connectivity
+      #
+      # @return [Boolean]
+      def alive?
+        return false unless connected?
+
+        ping
+      rescue StandardError
+        false
+      end
+
+      # Ping the database to check connectivity
+      #
+      # @return [Boolean]
+      # @raise [DatabaseError] if connection is not alive
+      def ping
+        return false unless connected?
+
+        case @adapter
+        when :sqlite
+          @raw_connection.execute("SELECT 1")
+        when :postgres
+          @raw_connection.exec("SELECT 1")
+        when :mysql
+          @raw_connection.ping
+        end
+        true
+      rescue StandardError => e
+        raise DatabaseError, "Database ping failed: #{e.message}"
+      end
+
       # Close the connection
       #
       # @return [void]

data/lib/tarsier/errors.rb

@@ -74,4 +74,23 @@ module Tarsier
       super("Streaming is not supported by the current server")
     end
   end
+
+  # Raised when a record is not found
+  class RecordNotFoundError < Error
+    # @return [Class] the model class
+    attr_reader :model
+
+    # @return [Object] the ID that was not found
+    attr_reader :id
+
+    def initialize(model, id = nil)
+      @model = model
+      @id = id
+      if id
+        super("#{model.name} with #{model.primary_key}=#{id} not found")
+      else
+        super("#{model.name} record not found")
+      end
+    end
+  end
 end

data/lib/tarsier/middleware/base.rb

@@ -21,7 +21,7 @@ module Tarsier
       def call(request, response)
         before(request, response)
         result = @app.call(request, response)
-        after(request, result)
+        after(request, response)
         result
       end
 

data/lib/tarsier/middleware/csrf.rb

@@ -26,10 +26,13 @@ module Tarsier
 
         if safe_request?(request)
           ensure_token(session)
+          # Expose CSRF token in response header and request env for views
+          expose_token(request, response, session[SESSION_KEY])
           @app.call(request, response)
         else
           if valid_token?(request, session)
             rotate_token(session) if @options[:rotate]
+            expose_token(request, response, session[SESSION_KEY])
             @app.call(request, response)
           else
             handle_invalid_token(response)
@@ -39,6 +42,13 @@ module Tarsier
 
       private
 
+      def expose_token(request, response, token)
+        # Make token available in request env for views/templates
+        request.env["tarsier.csrf_token"] = token
+        # Also set as response header for JavaScript access
+        response.set_header("X-CSRF-Token", token)
+      end
+
       def skip_csrf?(request)
         @skip_paths.any? { |path| request.path.start_with?(path) }
       end

data/lib/tarsier/middleware/logger.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "securerandom"
+
 module Tarsier
   module Middleware
     # Request logging middleware
@@ -13,42 +15,56 @@ module Tarsier
         reset: "\e[0m"
       }.freeze
 
+      REQUEST_ID_HEADER = "X-Request-Id"
+
       def initialize(app, logger: nil, **options)
         super(app, **options)
         @logger = logger || default_logger
         @colorize = options.fetch(:colorize, $stdout.tty?)
+        @include_request_id = options.fetch(:request_id, true)
       end
 
       def call(request, response)
         start_time = Process.clock_gettime(Process::CLOCK_MONOTONIC)
 
+        # Generate or propagate request ID
+        request_id = if @include_request_id
+                       existing_id = request.header(REQUEST_ID_HEADER)
+                       id = existing_id || SecureRandom.uuid
+                       request.env["tarsier.request_id"] = id
+                       response.set_header(REQUEST_ID_HEADER, id)
+                       id
+                     end
+
         @app.call(request, response)
 
         duration = Process.clock_gettime(Process::CLOCK_MONOTONIC) - start_time
-        log_request(request, response, duration)
+        log_request(request, response, duration, request_id)
 
         response
       end
 
       private
 
-      def log_request(request, response, duration)
+      def log_request(request, response, duration, request_id = nil)
         status = response.status
         method = request.method
         path = request.path
         duration_ms = (duration * 1000).round(2)
 
-        message = format_log(method, path, status, duration_ms)
+        message = format_log(method, path, status, duration_ms, request_id)
         @logger.info(message)
       end
 
-      def format_log(method, path, status, duration_ms)
+      def format_log(method, path, status, duration_ms, request_id = nil)
         if @colorize
           status_color = status_color(status)
-          "#{colorize(method.to_s.ljust(7), :cyan)} #{path} " \
+          base = "#{colorize(method.to_s.ljust(7), :cyan)} #{path} " \
             "#{colorize(status.to_s, status_color)} #{duration_ms}ms"
+          request_id ? "#{base} [#{request_id[0..7]}]" : base
         else
-          "#{method.to_s.ljust(7)} #{path} #{status} #{duration_ms}ms"
+          base = "#{method.to_s.ljust(7)} #{path} #{status} #{duration_ms}ms"
+          request_id ? "#{base} [#{request_id[0..7]}]" : base
         end
       end
 

data/lib/tarsier/middleware/rate_limit.rb

@@ -9,16 +9,21 @@ module Tarsier
         limit: 100,
         window: 60,
         key_prefix: "tarsier:rate_limit:",
-        headers: true
+        headers: true,
+        skip: []
       }.freeze
 
       def initialize(app, store: nil, **options)
         super(app, **options)
         @options = DEFAULT_OPTIONS.merge(options)
         @store = store || MemoryStore.new
+        @skip_paths = Array(@options[:skip])
       end
 
       def call(request, response)
+        # Skip rate limiting for configured paths
+        return @app.call(request, response) if skip_rate_limit?(request)
+
         key = rate_limit_key(request)
         current_time = Time.now.to_i
         window_start = current_time - @options[:window]
@@ -42,6 +47,10 @@ module Tarsier
 
       private
 
+      def skip_rate_limit?(request)
+        @skip_paths.any? { |path| request.path.start_with?(path) }
+      end
+
       def rate_limit_key(request)
         identifier = if @options[:key_generator]
                        @options[:key_generator].call(request)

data/lib/tarsier/middleware/static.rb

@@ -66,12 +66,14 @@ module Tarsier
       end
 
       def file_path(request_path)
-        # Prevent directory traversal
-        path = File.join(@root, request_path)
+        # Prevent directory traversal by expanding the path and checking it's within root
+        # First, clean the path of any traversal attempts
+        clean_path = request_path.gsub(/\.\./, "")
+        path = File.expand_path(File.join(@root, clean_path))
         path = File.join(path, @options[:index]) if File.directory?(path)
 
-        # Ensure path is within root
-        return nil unless path.start_with?(@root)
+        # Ensure the fully resolved path is within root directory
+        return nil unless path.start_with?("#{@root}/") || path == @root
 
         path
       end

data/lib/tarsier/model.rb

@@ -183,6 +183,45 @@ module Tarsier
         where(attributes).first
       end
 
+      # Find by attributes or raise
+      #
+      # @param attributes [Hash] attributes to match
+      # @return [Model]
+      # @raise [RecordNotFoundError]
+      def find_by!(**attributes)
+        find_by(**attributes) || raise(RecordNotFoundError.new(self))
+      end
+
+      # Get the first record
+      #
+      # @return [Model, nil]
+      def first
+        query.first
+      end
+
+      # Get the first record or raise
+      #
+      # @return [Model]
+      # @raise [RecordNotFoundError]
+      def first!
+        first || raise(RecordNotFoundError.new(self))
+      end
+
+      # Get the last record
+      #
+      # @return [Model, nil]
+      def last
+        query.last
+      end
+
+      # Get the last record or raise
+      #
+      # @return [Model]
+      # @raise [RecordNotFoundError]
+      def last!
+        last || raise(RecordNotFoundError.new(self))
+      end
+
       # Get all records
       #
       # @return [Array<Model>]
@@ -560,31 +599,4 @@ module Tarsier
       klass.find_by(config[:foreign_key] => id)
     end
   end
-
-  # Record not found error
-  class RecordNotFoundError < Error
-    # @return [Class] the model class
-    attr_reader :model
-
-    # @return [Object] the ID that was not found
-    attr_reader :id
-
-    def initialize(model, id)
-      @model = model
-      @id = id
-      super("#{model.name} with #{model.primary_key}=#{id} not found")
-    end
-  end
-
-  # Validation error
-  class ValidationError < Error
-    # @return [Hash] validation errors
-    attr_reader :errors
-
-    def initialize(errors)
-      @errors = errors
-      messages = errors.flat_map { |k, v| v.map { |m| "#{k} #{m}" } }
-      super("Validation failed: #{messages.join(', ')}")
-    end
-  end
 end

data/lib/tarsier/params.rb

@@ -152,7 +152,7 @@ module Tarsier
       raise TypeCoercionError.new(key, type, value) unless coercer
 
       coercer.call(value)
-    rescue ArgumentError, TypeError => e
+    rescue ArgumentError, TypeError
       raise TypeCoercionError.new(key, type, value)
     end
   end

data/lib/tarsier/query.rb

@@ -173,6 +173,14 @@ module Tarsier
       limit(1).to_a.first
     end
 
+    # Get first record or raise
+    #
+    # @return [Model]
+    # @raise [RecordNotFoundError]
+    def first!
+      first || raise(RecordNotFoundError.new(@model))
+    end
+
     # Get last record
     #
     # @return [Model, nil]
@@ -180,6 +188,14 @@ module Tarsier
       order(@model.primary_key => :desc).limit(1).to_a.first
     end
 
+    # Get last record or raise
+    #
+    # @return [Model]
+    # @raise [RecordNotFoundError]
+    def last!
+      last || raise(RecordNotFoundError.new(@model))
+    end
+
     # Get record count
     #
     # @return [Integer]

data/lib/tarsier/request.rb

@@ -15,7 +15,7 @@ module Tarsier
     # @param env [Hash] Rack environment hash
     # @param route_params [Hash] parameters extracted from route matching
     def initialize(env, route_params = {})
-      @env = env.freeze
+      @env = env
       @route_params = route_params.transform_keys(&:to_sym).freeze
       @parsed_body = nil
       @query_params = nil
@@ -201,6 +201,23 @@ module Tarsier
       %i[GET HEAD PUT DELETE OPTIONS].include?(method)
     end
 
+    # Convert request to hash (useful for debugging/logging)
+    # @return [Hash]
+    def to_h
+      {
+        method: method,
+        path: path,
+        url: url,
+        query_params: query_params,
+        headers: headers,
+        content_type: content_type,
+        ip: ip,
+        user_agent: user_agent
+      }
+    end
+
+    alias to_hash to_h
+
     private
 
     def parse_query_string

data/lib/tarsier/response.rb

@@ -81,9 +81,17 @@ module Tarsier
 
     # Set content type
     # @param type [String] content type
-    # @param charset [String] character set
+    # @param charset [String] character set (pass nil to omit)
     # @return [self]
-    def content_type=(type, charset: "utf-8")
+    def content_type=(type)
+      set_header("Content-Type", type.include?(";") ? type : "#{type}; charset=utf-8")
+    end
+
+    # Set content type with options
+    # @param type [String] content type
+    # @param charset [String, nil] character set
+    # @return [self]
+    def set_content_type(type, charset: "utf-8")
       set_header("Content-Type", charset ? "#{type}; charset=#{charset}" : type)
     end
 
@@ -209,6 +217,12 @@ module Tarsier
       @sent
     end
 
+    # Get the status text for the current status code
+    # @return [String]
+    def status_text
+      STATUS_CODES[@status] || "Unknown"
+    end
+
     # Mark response as sent
     def mark_sent!
       @sent = true

data/lib/tarsier/router/compiler.rb

@@ -49,10 +49,22 @@ module Tarsier
         tree = @trees[method.to_s.upcase.to_sym]
         return nil unless tree
 
-        segments = path == "/" ? [""] : path.split("/").drop(1)
+        # Normalize path: remove trailing slash (except for root)
+        normalized_path = path.chomp("/")
+        normalized_path = "/" if normalized_path.empty?
+
+        segments = normalized_path == "/" ? [""] : normalized_path.split("/").drop(1)
         match_segments(tree, segments, {})
       end
 
+      # Check if a route exists for the given method and path
+      # @param method [Symbol] HTTP method
+      # @param path [String] the path to check
+      # @return [Boolean]
+      def route_exists?(method, path)
+        !match(method, path).nil?
+      end
+
       # Get a named route
       # @param name [Symbol] route name
       # @return [Route, nil]

data/lib/tarsier/router.rb

@@ -42,6 +42,14 @@ module Tarsier
       @compiler.path_for(name, params)
     end
 
+    # Check if a route exists for the given method and path
+    # @param method [Symbol] HTTP method
+    # @param path [String] the path to check
+    # @return [Boolean]
+    def route_exists?(method, path)
+      @compiler.route_exists?(method, path)
+    end
+
     # Get all defined routes
     # @return [Array<Route>]
     def routes

data/lib/tarsier/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tarsier
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

data/lib/tarsier/websocket.rb

@@ -91,7 +91,11 @@ module Tarsier
           break
         end
       end
-    rescue IOError, Errno::ECONNRESET
+    rescue IOError, Errno::ECONNRESET => e
+      trigger(:error, e)
+      trigger(:close)
+    rescue StandardError => e
+      trigger(:error, e)
       trigger(:close)
     ensure
       cleanup

data/lib/tarsier.rb

@@ -117,8 +117,16 @@ module Tarsier
     # Define routes for the application
     #
     # @yield [Router] the router instance
+    # 
+    # @example In config/routes.rb
+    #   Tarsier.routes do
+    #     root to: "home#index"
+    #     resources :users
+    #   end
     def routes(&block)
-      current_app&.routes(&block)
+      # If called without a current app, create one
+      @current_app ||= Application.new
+      @current_app.routes(&block)
     end
 
     # Access the current router

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tarsier
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Eira Elif
@@ -159,7 +159,7 @@ extensions: []
 extra_rdoc_files: []
 files:
 - CHANGELOG.md
-- LICENSE.txt
+- LICENSE
 - README.md
 - exe/tarsier
 - lib/tarsier.rb