blest 0.0.2 → 0.1.0

data/lib/blest.rb

@@ -1,14 +1,347 @@
 require 'socket'
 require 'json'
+require 'date'
+require 'concurrent'
+require 'securerandom'
+require 'net/http'
 
-def create_http_server(request_handler, options = nil)
-  
-  def parse_request(request_line)
+
+
+class Router
+  attr_reader :routes
+
+  def initialize(options = nil)
+    @middleware = []
+    @afterware = []
+    @timeout = 5000
+    @introspection = false
+    @routes = {}
+
+    if options
+      @timeout = options['timeout'] || options[:timeout] || 5000
+      @introspection = options['introspection'] || options[:introspection] || false
+    end
+  end
+
+  def before(&handler)
+    unless handler.is_a?(Proc)
+      raise ArgumentError, 'Before handlers should be procs'
+    end
+
+    arg_count = handler.arity
+    if arg_count <= 2
+      @middleware.push(handler)
+    else
+      raise ArgumentError, 'Before handlers should have at most three arguments'
+    end
+  end
+
+  def after(&handler)
+    unless handler.is_a?(Proc)
+      raise ArgumentError, 'After handlers should be procs'
+    end
+
+    arg_count = handler.arity
+    if arg_count <= 2
+      @afterware.push(handler)
+    else
+      raise ArgumentError, 'After handlers should have at most two arguments'
+    end
+  end
+
+  def route(route, &handler)
+    route_error = validate_route(route)
+    raise ArgumentError, route_error if route_error
+    raise ArgumentError, 'Route already exists' if @routes.key?(route)
+    raise ArgumentError, 'Handler should be a function' unless handler.respond_to?(:call)
+
+    @routes[route] = {
+      handler: [*@middleware, handler, *@afterware],
+      description: nil,
+      parameters: nil,
+      result: nil,
+      visible: @introspection,
+      validate: false,
+      timeout: @timeout
+    }
+  end
+
+  def describe(route, config)
+    raise ArgumentError, 'Route does not exist' unless @routes.key?(route)
+    raise ArgumentError, 'Configuration should be an object' unless config.is_a?(Hash)
+
+    if config.key?('description')
+      raise ArgumentError, 'Description should be a str' if !config['description'].nil? && !config['description'].is_a?(String)
+      @routes[route]['description'] = config['description']
+    end
+
+    if config.key?('parameters')
+      raise ArgumentError, 'Parameters should be a dict' if !config['parameters'].nil? && !config['parameters'].is_a?(Hash)
+      @routes[route]['parameters'] = config['parameters']
+    end
+
+    if config.key?('result')
+      raise ArgumentError, 'Result should be a dict' if !config['result'].nil? && !config['result'].is_a?(Hash)
+      @routes[route]['result'] = config['result']
+    end
+
+    if config.key?('visible')
+      raise ArgumentError, 'Visible should be True or False' if !config['visible'].nil? && ![true, false].include?(config['visible'])
+      @routes[route]['visible'] = config['visible']
+    end
+
+    if config.key?('validate')
+      raise ArgumentError, 'Validate should be True or False' if !config['validate'].nil? && ![true, false].include?(config['validate'])
+      @routes[route]['validate'] = config['validate']
+    end
+
+    if config.key?('timeout')
+      raise ArgumentError, 'Timeout should be a positive int' if !config['timeout'].nil? && (!config['timeout'].is_a?(Integer) || config['timeout'] <= 0)
+      @routes[route]['timeout'] = config['timeout']
+    end
+  end
+
+  def merge(router)
+    raise ArgumentError, 'Router is required' unless router.is_a?(Router)
+
+    new_routes = router.routes.keys
+    existing_routes = @routes.keys
+
+    raise ArgumentError, 'No routes to merge' if new_routes.empty?
+
+    new_routes.each do |route|
+      if existing_routes.include?(route)
+        raise ArgumentError, 'Cannot merge duplicate routes: ' + route
+      else
+        @routes[route] = {
+          **router.routes[route],
+          handler: @middleware + router.routes[route][:handler] + @afterware,
+          timeout: router.routes[route][:timeout] ||  @timeout
+        }
+      end
+    end
+  end
+
+  def namespace(prefix, router)
+    raise ArgumentError, 'Router is required' unless router.is_a?(Router)
+
+    prefix_error = validate_route(prefix)
+    raise ArgumentError, prefix_error if prefix_error
+
+    new_routes = router.routes.keys
+    existing_routes = @routes.keys
+
+    raise ArgumentError, 'No routes to namespace' if new_routes.empty?
+
+    new_routes.each do |route|
+      ns_route = "#{prefix}/#{route}"
+      if existing_routes.include?(ns_route)
+        raise ArgumentError, 'Cannot merge duplicate routes: ' + ns_route
+      else
+        @routes[ns_route] = {
+          **router.routes[route],
+          handler: @middleware + router.routes[route][:handler] + @afterware,
+          timeout: router.routes[route].fetch('timeout', @timeout)
+        }
+      end
+    end
+  end
+
+  def handle(request, context = {})
+    handle_request(@routes, request, context)
+  end
+
+end
+
+
+
+class Blest < Router
+  @options = nil
+  @errorhandler = nil
+
+  def initialize(options = nil)
+    @options = options
+    super(options)
+  end
+
+  def errorhandler(&errorhandler)
+    @errorhandler = errorhandler
+    puts 'The errorhandler method is not currently used'
+  end
+
+  def listen(*args)
+    request_handler = create_request_handler(@routes)
+    server = create_http_server(request_handler, @options)
+    server.call(*args)
+  end
+end
+
+
+
+class HttpClient
+  attr_reader :queue, :futures
+  attr_accessor :url, :max_batch_size, :buffer_delay, :headers
+
+  def initialize(url, max_batch_size = 25, buffer_delay = 10, headers = {})
+    @url = url
+    @max_batch_size = max_batch_size
+    @buffer_delay = buffer_delay
+    @headers = headers
+    @queue = Queue.new
+    @futures = {}
+    @lock = Mutex.new
+  end
+
+  def request(route, parameters=nil, selector=nil)
+    uuid = SecureRandom.uuid
+    future = Concurrent::Promises.resolvable_future
+    @lock.synchronize do
+      @futures[uuid] = future
+    end
+
+    @queue.push({ uuid: uuid, data: [uuid, route, parameters, selector] })
+    process_timeout()
+    future
+  end
+
+  private
+
+  def process_timeout
+    Thread.new do
+      sleep @buffer_delay / 1000.0
+      process
+    end
+  end
+
+  def process
+    until @queue.empty?
+      batch = []
+      batch << @queue.pop until batch.length >= @max_batch_size || @queue.empty?
+
+      unless batch.empty?
+        response = send_batch(batch)
+        process_response(response)
+      end
+    end
+  end
+
+  def send_batch(batch)
+    uri = URI(@url)
+    path = uri.path
+    path = '/' if uri.path.empty?
+    http = Net::HTTP.new(uri.host, uri.port)
+    http.use_ssl = true if uri.scheme == 'https'
+
+    request = Net::HTTP::Post.new(path, @headers.merge({ 'Accept' => 'application/json', 'Content-Type' => 'application/json' }))
+    request.body = JSON.generate(batch.map { |item| item[:data] })
+
+    http.request(request)
+  end
+
+  def process_response(response)
+    if response.is_a?(Net::HTTPSuccess)
+      
+      results = JSON.parse(response.body)
+      results.each do |result|
+        uuid = result[0]
+        data = result[2]
+        error = result[3]
+        future = nil
+
+        @lock.synchronize do
+          future = @futures.delete(uuid)
+        end
+
+        if future
+          if error
+            future.reject(error)
+          else
+            future.fulfill(data)
+          end
+        end
+      end
+
+    else
+      @lock.synchronize do
+        future = @futures.delete(uuid)
+      end
+
+      if future
+        error_message = "HTTP Error: #{response.code} - #{response.message}"
+        future.reject(error_message)
+      end
+    end
+  end
+end
+
+
+
+def get_value(hash, key)
+  if hash.key?(key.to_sym)
+    hash[key.to_sym]
+  elsif hash.key?(key.to_s)
+    hash[key.to_s]
+  end
+end
+
+
+
+class HttpServer
+  attr_reader :url, :host, :port, :cors, :headers
+
+  def initialize(request_handler, options = {})
+    unless request_handler.is_a?(Router)
+      raise ArgumentError, "request_handler must be an instance of Router class"
+    end
+    @request_handler = request_handler
+    if options
+      options_error = validate_server_options(options)
+      raise ArgumentError, options_error if options_error
+    else
+      @options = {}
+    end
+
+    @url = options && get_value(options, :url) || '/'
+    @host = options && get_value(options, :host) || 'localhost'
+    @port = options && get_value(options, :port) || 8080
+    @cors = options && get_value(options, :cors) || false
+    cors_default = cors == true ? '*' : cors || ''
+
+    @headers = {
+      'access-control-allow-origin' => options && get_value(options, :accessControlAllowOrigin) || cors_default,
+      'content-security-policy' => options && get_value(options, :contentSecurityPolicy) || "default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests",
+      'cross-origin-opener-policy' => options && get_value(options, :crossOriginOpenerPolicy) || 'same-origin',
+      'cross-origin-resource-policy' => options && get_value(options, :crossOriginResourcePolicy) || 'same-origin',
+      'origin-agent-cluster' => options && get_value(options, :originAgentCluster) || '?1',
+      'referrer-policy' => options && get_value(options, :referrerPolicy) || 'no-referrer',
+      'strict-transport-security' => options && get_value(options, :strictTransportSecurity) || 'max-age=1555200 includeSubDomains',
+      'x-content-type-options' => options && get_value(options, :xContentTypeOptions) || 'nosniff',
+      'x-dns-prefetch-control' => options && get_value(options, :xDnsPrefetchOptions) || 'off',
+      'x-download-options' => options && get_value(options, :xDownloadOptions) || 'noopen',
+      'x-frame-options' => options && get_value(options, :xFrameOptions) || 'SAMEORIGIN',
+      'x-permitted-cross-domain-policies' => options && get_value(options, :xPermittedCrossDomainPolicies) || 'none',
+      'x-xss-protection' => options && get_value(options, :xXssProtection) || '0'
+    }
+  end
+
+  def listen()
+    server = TCPServer.new(@host, @port)
+    puts "Server listening on port #{@port}"
+
+    loop do
+      client = server.accept
+      Thread.new { handle_http_request(client, @request_handler, @http_headers) }
+    end
+  end
+
+  private
+
+  def parse_http_request(request_line)
     method, path, _ = request_line.split(' ')
     { method: method, path: path }
   end
 
-  def parse_headers(client)
+  def parse_http_headers(client)
     headers = {}
 
     while (line = client.gets.chomp)
@@ -21,7 +354,7 @@ def create_http_server(request_handler, options = nil)
     headers
   end
 
-  def parse_body(client, content_length)
+  def parse_post_body(client, content_length)
     body = ''
   
     while content_length > 0
@@ -33,7 +366,7 @@ def create_http_server(request_handler, options = nil)
     body
   end
 
-  def build_response(status, headers, body)
+  def build_http_response(status, headers, body)
     response = "HTTP/1.1 #{status}\r\n"
     headers.each { |key, value| response += "#{key}: #{value}\r\n" }
     response += "\r\n"
@@ -41,30 +374,24 @@ def create_http_server(request_handler, options = nil)
     response
   end
 
-  def handle_request(client, request_handler)
+  def handle_http_request(client, request_handler, http_headers)
     request_line = client.gets
     return unless request_line
   
-    request = parse_request(request_line)
-    
-    headers = parse_headers(client)
+    request = parse_http_request(request_line)
     
-    cors_headers = {
-      'Access-Control-Allow-Origin' => '*',
-      'Access-Control-Allow-Methods' => 'POST, OPTIONS',
-      'Access-Control-Allow-Headers' => 'Content-Type'
-    }
+    headers = parse_http_headers(client)
   
     if request[:path] != '/'
-      response = build_response('404 Not Found', cors_headers, '')
+      response = build_http_response('404 Not Found', http_headers, '')
       client.print(response)
     elsif request[:method] == 'OPTIONS'
-      response = build_response('204 No Content', cors_headers, '')
+      response = build_http_response('204 No Content', http_headers, '')
       client.print(response)
     elsif request[:method] == 'POST'
 
       content_length = headers['Content-Length'].to_i
-      body = parse_body(client, content_length)
+      body = parse_post_body(client, content_length)
       
       begin
         json_data = JSON.parse(body)
@@ -72,7 +399,7 @@ def create_http_server(request_handler, options = nil)
           'headers' => headers
         }
 
-        response_headers = cors_headers.merge({
+        response_headers = http_headers.merge({
           'Content-Type' => 'application/json'
         })
 
@@ -80,202 +407,540 @@ def create_http_server(request_handler, options = nil)
 
         if error
             response_json = error.to_json
-            response = build_response('500 Internal Server Error', response_headers, response_json)
+            response = build_http_response('500 Internal Server Error', response_headers, response_json)
             client.print response
         elsif result
             response_json = result.to_json
-            response = build_response('200 OK', response_headers, response_json)
+            response = build_http_response('200 OK', response_headers, response_json)
             client.print response
         else
-          response = build_response('500 Internal Server Error', response_headers, { 'message' => 'Request handler failed to return a result' }.to_json)
+          response = build_http_response('500 Internal Server Error', response_headers, { 'message' => 'Request handler failed to return a result' }.to_json)
           client.print response
         end
 
       rescue JSON::ParserError
-        response = build_response('400 Bad Request', cors_headers, '')
+        response = build_http_response('400 Bad Request', http_headers, '')
       end
 
     else
-      response = build_response('405 Method Not Allowed', cors_headers, '')
+      response = build_http_response('405 Method Not Allowed', http_headers, '')
       client.print(response)
     end
     client.close()
   end
 
-  run = ->() do
+end
+
 
-    port = options&.fetch(:port, 8080) if options.is_a?(Hash)
-    port ||= 8080
 
-    server = TCPServer.new('localhost', 8080)
-    puts "Server listening on port #{port}"
 
-    loop do
-      client = server.accept
-      Thread.new { handle_request(client, request_handler) }
-    end
 
-  end
 
-  return run
-end
 
-def create_request_handler(routes, options = nil)
+def create_http_server(request_handler, options = nil)
   if options
-    puts 'The "options" argument is not yet used, but may be used in the future'
+    options_error = validate_server_options(options)
+    raise ArgumentError, options_error if options_error
+  end
+
+  url = options && get_value(options, :url) || '/'
+  port = options && get_value(options, :port) || 8080
+  cors = options && get_value(options, :cors) || false
+  cors_default = cors == true ? '*' : cors || ''
+  
+  http_headers = {
+    'access-control-allow-origin' => options && get_value(options, :accessControlAllowOrigin) || cors_default,
+    'content-security-policy' => options && get_value(options, :contentSecurityPolicy) || "default-src 'self';base-uri 'self';font-src 'self' https: data:;form-action 'self';frame-ancestors 'self';img-src 'self' data:;object-src 'none';script-src 'self';script-src-attr 'none';style-src 'self' https: 'unsafe-inline';upgrade-insecure-requests",
+    'cross-origin-opener-policy' => options && get_value(options, :crossOriginOpenerPolicy) || 'same-origin',
+    'cross-origin-resource-policy' => options && get_value(options, :crossOriginResourcePolicy) || 'same-origin',
+    'origin-agent-cluster' => options && get_value(options, :originAgentCluster) || '?1',
+    'referrer-policy' => options && get_value(options, :referrerPolicy) || 'no-referrer',
+    'strict-transport-security' => options && get_value(options, :strictTransportSecurity) || 'max-age=1555200 includeSubDomains',
+    'x-content-type-options' => options && get_value(options, :xContentTypeOptions) || 'nosniff',
+    'x-dns-prefetch-control' => options && get_value(options, :xDnsPrefetchOptions) || 'off',
+    'x-download-options' => options && get_value(options, :xDownloadOptions) || 'noopen',
+    'x-frame-options' => options && get_value(options, :xFrameOptions) || 'SAMEORIGIN',
+    'x-permitted-cross-domain-policies' => options && get_value(options, :xPermittedCrossDomainPolicies) || 'none',
+    'x-xss-protection' => options && get_value(options, :xXssProtection) || '0'
+  }
+
+  def parse_http_request(request_line)
+    method, path, _ = request_line.split(' ')
+    { method: method, path: path }
   end
 
-  def handle_result(result)
-    return [result, nil]
+  def parse_http_headers(client)
+    headers = {}
+
+    while (line = client.gets.chomp)
+      break if line.empty?
+
+      key, value = line.split(':', 2)
+      headers[key] = value.strip
+    end
+
+    headers
   end
 
-  def handle_error(code, message)
-    return [nil, { 'code' => code, 'message' => message }]
+  def parse_post_body(client, content_length)
+    body = ''
+  
+    while content_length > 0
+      chunk = client.readpartial([content_length, 4096].min)
+      body += chunk
+      content_length -= chunk.length
+    end
+  
+    body
   end
 
-  def route_not_found(_, _)
-    raise 'Route not found'
+  def build_http_response(status, headers, body)
+    response = "HTTP/1.1 #{status}\r\n"
+    headers.each { |key, value| response += "#{key}: #{value}\r\n" }
+    response += "\r\n"
+    response += body
+    response
   end
 
-  def route_reducer(handler, request, context = nil)
-    safe_context = context ? context.clone : {}
-    result = nil
+  def handle_http_request(client, request_handler, http_headers)
+    request_line = client.gets
+    return unless request_line
+  
+    request = parse_http_request(request_line)
+    
+    headers = parse_http_headers(client)
+  
+    if request[:path] != '/'
+      response = build_http_response('404 Not Found', http_headers, '')
+      client.print(response)
+    elsif request[:method] == 'OPTIONS'
+      response = build_http_response('204 No Content', http_headers, '')
+      client.print(response)
+    elsif request[:method] == 'POST'
+
+      content_length = headers['Content-Length'].to_i
+      body = parse_post_body(client, content_length)
+      
+      begin
+        json_data = JSON.parse(body)
+        context = {
+          'headers' => headers
+        }
 
-    if handler.is_a?(Array)
-      handler.each_with_index do |func, i|
-        temp_result = func.call(request[:parameters], safe_context)
+        response_headers = http_headers.merge({
+          'Content-Type' => 'application/json'
+        })
 
-        if i == handler.length - 1
-          result = temp_result
+        result, error = request_handler.(json_data, context)
+
+        if error
+            response_json = error.to_json
+            response = build_http_response('500 Internal Server Error', response_headers, response_json)
+            client.print response
+        elsif result
+            response_json = result.to_json
+            response = build_http_response('200 OK', response_headers, response_json)
+            client.print response
         else
-          raise 'Middleware should not return anything but may mutate context' if temp_result
+          response = build_http_response('500 Internal Server Error', response_headers, { 'message' => 'Request handler failed to return a result' }.to_json)
+          client.print response
         end
+
+      rescue JSON::ParserError
+        response = build_http_response('400 Bad Request', http_headers, '')
       end
+
     else
-      result = handler.call(request[:parameters], safe_context)
+      response = build_http_response('405 Method Not Allowed', http_headers, '')
+      client.print(response)
     end
+    client.close()
+  end
 
-    raise 'The result, if any, should be a JSON object' if result && !(result.is_a?(Hash))
+  run = ->() do
 
-    result = filter_object(result, request[:selector]) if result && request[:selector]
-    return [request[:id], request[:route], result, nil]
-  rescue StandardError => error
-    return [request[:id], request[:route], nil, { message: error.message }]
-  end
+    server = TCPServer.new('localhost', port)
+    puts "Server listening on port #{port}"
 
-  def filter_object(obj, arr)
-    if arr.is_a?(Array)
-      filtered_obj = {}
-      arr.each do |key|
-        if key.is_a?(String)
-          if obj.key?(key.to_sym)
-            filtered_obj[key.to_sym] = obj[key.to_sym]
-          end
-        elsif key.is_a?(Array)
-          nested_obj = obj[key[0].to_sym]
-          nested_arr = key[1]
-          if nested_obj.is_a?(Array)
-            filtered_arr = []
-            nested_obj.each do |nested_item|
-              filtered_nested_obj = filter_object(nested_item, nested_arr)
-              if filtered_nested_obj.keys.length > 0
-                filtered_arr << filtered_nested_obj
-              end
-            end
-            if filtered_arr.length > 0
-              filtered_obj[key[0].to_sym] = filtered_arr
-            end
-          elsif nested_obj.is_a?(Hash)
-            filtered_nested_obj = filter_object(nested_obj, nested_arr)
-            if filtered_nested_obj.keys.length > 0
-              filtered_obj[key[0].to_sym] = filtered_nested_obj
-            end
-          end
-        end
+    begin
+      loop do
+        client = server.accept
+        Thread.new { handle_http_request(client, request_handler, http_headers) }
       end
-      return filtered_obj
+    rescue Interrupt
+      exit 1
     end
-    return obj
+
   end
 
-  route_regex = /^[a-zA-Z][a-zA-Z0-9_\-\/]*[a-zA-Z0-9_\-]$/
+  return run
+end
 
-  handler = ->(requests, context = {}) do
-    if !requests || !requests.is_a?(Array)
-      return handle_error(400, 'Request body should be a JSON array')
-    end
 
-    unique_ids = []
-    promises = []
 
-    requests.each do |request|
-      if !request.is_a?(Array)
-        return handle_error(400, 'Request item should be an array')
+def validate_server_options(options)
+  if options.nil? || options.empty?
+    return nil
+  elsif !options.is_a?(Hash)
+    return 'Options should be a hash'
+  else
+    if options.key?(:url)
+      if !options[:url].is_a?(String)
+        return '"url" option should be a string'
+      elsif !options[:url].start_with?('/')
+        return '"url" option should begin with a forward slash'
       end
+    end
+
+    if options.key?(:cors)
+      if !options[:cors].is_a?(String) && !options[:cors].is_a?(TrueClass) && !options[:cors].is_a?(FalseClass)
+        return '"cors" option should be a string or boolean'
+      end
+    end
+  end
+
+  return nil
+end
+
 
-      id = request[0]
-      route = request[1]
-      parameters = request[2] || nil
-      selector = request[3] || nil
 
-      if !id || !id.is_a?(String)
-        return handle_error(400, 'Request item should have an ID')
+def create_request_handler(routes)
+  raise ArgumentError, 'A routes object is required' unless routes.is_a?(Hash)
+
+  my_routes = {}
+
+  routes.each do |key, route|
+    route_error = validate_route(key)
+    raise ArgumentError, "#{route_error}: #{key}" if route_error
+
+    if route.is_a?(Array)
+      raise ArgumentError, "Route has no handlers: #{key}" if route.empty?
+
+      route.each do |handler|
+        raise ArgumentError, "All route handlers must be functions: #{key}" unless handler.is_a?(Proc)
       end
 
-      if !route || !route.is_a?(String)
-        return handle_error(400, 'Request item should have a route')
+      my_routes[key] = { handler: route }
+    elsif route.is_a?(Hash)
+      unless route.key?(:handler)
+        raise ArgumentError, "Route has no handlers: #{key}"
       end
 
-      if !route_regex.match?(route)
-        route_length = route.length
-        if route_length < 2
-          return handle_error(400, 'Request item route should be at least two characters long')
-        elsif route[-1] == '/'
-          return handle_error(400, 'Request item route should not end in a forward slash')
-        elsif !/[a-zA-Z]/.match?(route[0])
-          return handle_error(400, 'Request item route should start with a letter')
-        else
-          return handle_error(
-            400,
-            'Request item route should contain only letters, numbers, dashes, underscores, and forward slashes'
-          )
+      if route[:handler].is_a?(Array)
+        route[:handler].each do |handler|
+          raise ArgumentError, "All route handlers must be functions: #{key}" unless handler.is_a?(Proc)
         end
-      end
 
-      if parameters && !parameters.is_a?(Hash)
-        return handle_error(400, 'Request item parameters should be a JSON object')
+        my_routes[key] = route
+      elsif route[:handler].is_a?(Proc)
+        my_routes[key] = { **route, handler: [route[:handler]] }
+      else
+        raise ArgumentError, "Route handler is not valid: #{key}"
       end
+    elsif route.is_a?(Proc)
+      my_routes[key] = { handler: [route] }
+    else
+      raise ArgumentError, "Route is missing handler: #{key}"
+    end
+  end
+
+  handler = lambda do |requests, context = {}|
+    handle_request(my_routes, requests, context)
+  end
+
+  return handler
+end
+
+
+
+def validate_route(route)
+  route_regex = /^[a-zA-Z][a-zA-Z0-9_\-\/]*[a-zA-Z0-9]$/
+  if route.nil? || route.empty?
+    return 'Route is required'
+  elsif !(route =~ route_regex)
+    route_length = route.length
+    if route_length < 2
+      return 'Route should be at least two characters long'
+    elsif route[-1] == '/'
+      return 'Route should not end in a forward slash'
+    elsif !(route[0] =~ /^[a-zA-Z]/)
+      return 'Route should start with a letter'
+    elsif !(route[-1] =~ /^[a-zA-Z0-9]/)
+      return 'Route should end with a letter or a number'
+    else
+      return 'Route should contain only letters, numbers, dashes, underscores, and forward slashes'
+    end
+  elsif route =~ /\/[^a-zA-Z]/
+    return 'Sub-routes should start with a letter'
+  elsif route =~ /[^a-zA-Z0-9]\//
+    return 'Sub-routes should end with a letter or a number'
+  elsif route =~ /\/[a-zA-Z0-9_\-]{0,1}\//
+    return 'Sub-routes should be at least two characters long'
+  elsif route =~ /\/[a-zA-Z0-9_\-]$/
+    return 'Sub-routes should be at least two characters long'
+  elsif route =~ /^[a-zA-Z0-9_\-]\//
+    return 'Sub-routes should be at least two characters long'
+  end
+
+  return nil
+end
+
+
+
+def handle_request(routes, requests, context = {})
+  if requests.nil? || !requests.is_a?(Array)
+    return handle_error(400, 'Request should be an array')
+  end
 
-      if selector && !selector.is_a?(Array)
-        return handle_error(400, 'Request item selector should be a JSON array')
+  unique_ids = []
+  promises = []
+
+  requests.each do |request|
+    request_length = request.length
+    if !request.is_a?(Array)
+      return handle_error(400, 'Request item should be an array')
+    end
+
+    id = request[0] || nil
+    route = request[1] || nil
+    parameters = request[2] || nil
+    selector = request[3] || nil
+
+    if id.nil? || !id.is_a?(String)
+      return handle_error(400, 'Request item should have an ID')
+    end
+
+    if route.nil? || !route.is_a?(String)
+      return handle_error(400, 'Request items should have a route')
+    end
+
+    if parameters && !parameters.is_a?(Hash)
+      return handle_error(400, 'Request item parameters should be an object')
+    end
+
+    if selector && !selector.is_a?(Array)
+      return handle_error(400, 'Request item selector should be an array')
+    end
+
+    if unique_ids.include?(id)
+      return handle_error(400, 'Request items should have unique IDs')
+    end
+
+    unique_ids << id
+    this_route = routes[route]
+    route_handler = nil
+    timeout = nil
+
+    if this_route.is_a?(Hash)
+      route_handler = this_route[:handler] || this_route['handler'] || method(:route_not_found)
+      timeout = this_route[:timeout] || this_route['timeout'] || nil
+    else
+      route_handler = this_route || method(:route_not_found)
+    end
+
+    request_object = {
+      id: id,
+      route: route,
+      parameters: parameters || {},
+      selector: selector
+    }
+
+    my_context = {
+      'requestId' => id,
+      'routeName' => route,
+      'selector' => selector,
+      'requestTime' => DateTime.now.to_time.to_i
+    }
+    if context.is_a?(Hash)
+      my_context = my_context.merge(context)
+    end
+
+    promises << Thread.new { route_reducer(route_handler, request_object, my_context, timeout) }
+  end
+
+  results = promises.map(&:value)
+  return handle_result(results)
+end
+
+
+
+def handle_result(result)
+  return result, nil
+end
+
+
+
+def handle_error(status, message)
+  return nil, {
+    'status' => status,
+    'message' => message
+  }
+end
+
+
+
+class BlestError < StandardError
+  attr_accessor :status
+  attr_accessor :code
+  attr_accessor :data
+  attr_accessor :stack
+
+  def initialize(message = nil)
+    @status = 500
+    @code = nil
+    @data = nil
+    @stack = nil
+    super(message)
+  end
+end
+
+
+
+def route_not_found(_, _)
+  error = BlestError.new
+  error.status = 404
+  error.stack = nil
+  raise error, 'Not Found'
+end
+
+
+
+def route_reducer(handler, request, context, timeout = nil)
+  safe_context = Marshal.load(Marshal.dump(context))
+  route = request[:route]
+  result = nil
+  error = nil
+
+  target = -> do
+    my_result = nil
+    if handler.is_a?(Array)
+      handler.each do |h|
+        break if error
+        temp_result = nil
+        if h.respond_to?(:call)
+          temp_result = Concurrent::Promises.future do
+            begin
+              h.call(request[:parameters], safe_context)
+            rescue => e
+              error = e
+            end
+          end.value
+        else
+          puts "Tried to resolve route '#{route}' with handler of type '#{h.class}'"
+          raise StandardError
+        end
+
+        if temp_result && temp_result != nil
+          if my_result && my_result != nil
+            puts result
+            puts temp_result
+            puts "Multiple handlers on the route '#{route}' returned results"
+            raise StandardError
+          else
+            my_result = temp_result
+          end
+        end
+      end
+    else
+      if handler.respond_to?(:call)
+        my_result = Concurrent::Promises.future do
+          begin
+            handler.call(request[:parameters], safe_context)
+          rescue => e
+            error = e
+          end
+        end.value
+      else
+        puts "Tried to resolve route '#{route}' with handler of type '#{handler.class}'"
+        raise StandardError
       end
+    end
+
+    if error
+      raise error
+    end
+
+    my_result
+  end
 
-      if unique_ids.include?(id)
-        return handle_error(400, 'Request items should have unique IDs')
+  begin
+    if timeout && timeout > 0
+      begin
+        result = Timeout.timeout(timeout / 1000.0) { target.call }
+      rescue Timeout::Error
+        puts "The route '#{route}' timed out after #{timeout} milliseconds"
+        return [request[:id], request[:route], nil, { 'message' => 'Internal Server Error', 'status' => 500 }]
       end
+    else
+      result = target.call
+    end
 
-      unique_ids << id
+    if result.nil? || !result.is_a?(Hash)
+      puts "The route '#{route}' did not return a result object"
+      return [request[:id], request[:route], nil, { 'message' => 'Internal Server Error', 'status' => 500 }]
+    end
 
-      route_handler = routes[route] || routes[route.to_sym] || method(:route_not_found)
+    if request[:selector]
+      result = filter_object(result, request[:selector])
+    end
 
-      request_object = {
-        id: id,
-        route: route,
-        parameters: parameters,
-        selector: selector,
-      }
+    [request[:id], request[:route], result, nil]
+  rescue => error
+    puts error.backtrace
+    response_error = {
+      'message' => error.message || 'Internal Server Error',
+      'status' => error.respond_to?(:status) ? error.status : 500
+    }
 
-      promises << route_reducer(route_handler, request_object, context)
+    if error.respond_to?(:code) && error.code.is_a?(String)
+      response_error['code'] = error.code
     end
 
-    results = []
+    if error.respond_to?(:data) && error.data.is_a?(Hash)
+      response_error['data'] = error.data
+    end
 
-    promises.each do |result|
-      results << result
+    if ENV['ENVIRONMENT'] != 'production' && ENV['APP_ENV'] != 'production' && ENV['RACK_ENV'] != 'production' && ENV['RAILS_ENV'] != 'production' && !error.respond_to?(:stack)
+      response_error['stack'] = error.backtrace
     end
 
-    return handle_result(results)
+    [request[:id], request[:route], nil, response_error]
   end
+end
 
-  return handler
+
+
+def filter_object(obj, arr)
+  if arr.is_a?(Array)
+    filtered_obj = {}
+    arr.each do |key|
+      if key.is_a?(String)
+        if obj.key?(key.to_sym)
+          filtered_obj[key.to_sym] = obj[key.to_sym]
+        end
+      elsif key.is_a?(Array)
+        nested_obj = obj[key[0].to_sym]
+        nested_arr = key[1]
+        if nested_obj.is_a?(Array)
+          filtered_arr = []
+          nested_obj.each do |nested_item|
+            filtered_nested_obj = filter_object(nested_item, nested_arr)
+            if filtered_nested_obj.keys.length > 0
+              filtered_arr << filtered_nested_obj
+            end
+          end
+          if filtered_arr.length > 0
+            filtered_obj[key[0].to_sym] = filtered_arr
+          end
+        elsif nested_obj.is_a?(Hash)
+          filtered_nested_obj = filter_object(nested_obj, nested_arr)
+          if filtered_nested_obj.keys.length > 0
+            filtered_obj[key[0].to_sym] = filtered_nested_obj
+          end
+        end
+      end
+    end
+    return filtered_obj
+  end
+  return obj
 end