sorted-travel 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5d9bfa8d4533c0e406b5b22e215cd77fc14d56680f6ad5d6d70c680b02cc7ddb
+  data.tar.gz: 73b1eb43b52c5c3fca221ed04e67e074d7287bea6214134e737d6519e0bdf5fb
+SHA512:
+  metadata.gz: 8a3cf8bb19139741a2dd313fcc0ef2f54a9cd0a25665913fc0173ddb1bdb07a93597ea10a3c081a436987c3fc9c725e9eac55671d0bc5c2d3853b7ddacc400bf
+  data.tar.gz: faae7eea35289cfcc448d065a2bf907545d32a28328c69e10f593098d7b64e631d153a7b4a657bf6c87597df308876a1729d763b244bfada050d8346880f1364

data/README.md

@@ -0,0 +1,28 @@
+# sorted-travel Ruby SDK
+
+Official Ruby client and CLI for the [Sorted Travel](https://sorted.travel) REST API.
+
+- Homepage: [https://sorted.travel](https://sorted.travel)
+- Developer portal: [https://sorted.travel/developers](https://sorted.travel/developers)
+- SDK guide: [https://sorted.travel/sdks.md](https://sorted.travel/sdks.md)
+- Repository: [https://github.com/a-l-e-x-k/sorted-travel-sdk](https://github.com/a-l-e-x-k/sorted-travel-sdk)
+
+## Install
+
+```sh
+gem install sorted-travel
+```
+
+## Quickstart
+
+```ruby
+require "sorted_travel"
+
+client = SortedTravel::Client.new
+client.status
+client.list_destinations(limit: 20)
+```
+
+Destination catalog, status, sandbox, and jobs are zero-auth. Pass `api_key:` or set `SORTED_TRAVEL_API_KEY` only when a host requires Bearer auth.
+
+Interactive ranking, weather, and visa still go through MCP at `https://sorted.travel/mcp`.

data/bin/sorted-travel

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require_relative "../lib/sorted_travel"
+
+exit SortedTravel::CLI.run(ARGV)

data/lib/sorted_travel/cli.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+
+require "json"
+require "optparse"
+
+module SortedTravel
+  # Command-line entry point for the Sorted Travel REST SDK.
+  module CLI
+    module_function
+
+    # Run the sorted-travel CLI and return an exit code.
+    def run(argv = ARGV)
+      options = { api_key: nil, base_url: nil }
+      parser = OptionParser.new do |opts|
+        opts.banner = "Usage: sorted-travel [options] COMMAND"
+        opts.on("--base-url URL", "API origin (default https://sorted.travel or SORTED_TRAVEL_BASE_URL)") do |value|
+          options[:base_url] = value
+        end
+        opts.on("--api-key KEY", "Optional Bearer token (default SORTED_TRAVEL_API_KEY)") do |value|
+          options[:api_key] = value
+        end
+      end
+
+      positional = parser.order(argv)
+      parser.parse!(argv)
+      command = positional.shift
+      if command.nil?
+        warn parser
+        return 2
+      end
+
+      client = Client.new(api_key: options[:api_key], base_url: options[:base_url])
+
+      case command
+      when "status"
+        print_json(client.status)
+      when "sandbox"
+        print_json(client.sandbox)
+      when "api-key"
+        print_json(client.create_api_key)
+      when "destinations"
+        destination_options = { cursor: nil, limit: nil }
+        OptionParser.new do |opts|
+          opts.on("--cursor VALUE") { |value| destination_options[:cursor] = value }
+          opts.on("--limit INTEGER", Integer) { |value| destination_options[:limit] = value }
+        end.parse!(positional)
+        print_json(client.list_destinations(**destination_options))
+      when "create-job"
+        operation = positional.shift
+        if operation.nil?
+          warn "missing operation"
+          return 2
+        end
+        job_options = {}
+        OptionParser.new do |opts|
+          opts.on("--limit INTEGER", Integer) { |value| job_options[:limit] = value }
+        end.parse!(positional)
+        print_json(client.create_job(operation, **job_options))
+      when "job"
+        job_id = positional.shift
+        if job_id.nil?
+          warn "missing job_id"
+          return 2
+        end
+        print_json(client.get_job(job_id))
+      else
+        warn "unknown command #{command}"
+        return 2
+      end
+      0
+    rescue OptionParser::ParseError => err
+      warn err.message
+      2
+    end
+
+    def print_json(value)
+      puts JSON.pretty_generate(value)
+    end
+  end
+end

data/lib/sorted_travel/client.rb

@@ -0,0 +1,164 @@
+# frozen_string_literal: true
+
+require "json"
+require "net/http"
+require "uri"
+
+module SortedTravel
+  # Base error for this SDK.
+  class SortedTravelError < StandardError
+  end
+
+  # Returned for non-2xx HTTP responses.
+  class APIError < SortedTravelError
+    attr_reader :status, :body
+
+    # Store HTTP status and parsed response body.
+    def initialize(status, body)
+      @status = status
+      @body = body
+      super("HTTP #{status}: #{truncate_body(body)}")
+    end
+
+    private
+
+    def truncate_body(value, limit = 300)
+      text = value.is_a?(String) ? value : JSON.generate(value)
+      return text if text.length <= limit
+
+      "#{text[0, limit - 1]}…"
+    end
+  end
+
+  # Thin client for the Sorted Travel REST API.
+  class Client
+    DEFAULT_BASE_URL = "https://sorted.travel"
+    DEFAULT_TIMEOUT = 30.0
+    USER_AGENT = "sorted-travel-ruby/#{SortedTravel::VERSION} (+https://sorted.travel)"
+
+    # Build a client from options and optional environment variables.
+    def initialize(api_key: nil, base_url: nil, timeout: DEFAULT_TIMEOUT, transport: nil, env: ENV)
+      @api_key = api_key || env["SORTED_TRAVEL_API_KEY"]
+      configured_base = base_url || env["SORTED_TRAVEL_BASE_URL"] || DEFAULT_BASE_URL
+      @base_url = configured_base.sub(%r{/+\z}, "")
+      @timeout = timeout
+      @transport = transport || method(:default_transport)
+    end
+
+    # GET /api/v1/status.
+    def status
+      get("/api/v1/status")
+    end
+
+    # GET /sandbox.
+    def sandbox
+      get("/sandbox")
+    end
+
+    # GET /api/v1/destinations with cursor pagination.
+    def list_destinations(cursor: nil, limit: nil)
+      params = {}
+      params["cursor"] = cursor unless cursor.nil?
+      params["limit"] = limit unless limit.nil?
+      get("/api/v1/destinations", params)
+    end
+
+    # POST /api/v1/api-keys.
+    def create_api_key
+      post("/api/v1/api-keys", {})
+    end
+
+    # POST /api/v1/jobs.
+    def create_job(operation, **body)
+      post("/api/v1/jobs", { operation: operation, **body })
+    end
+
+    # GET /api/v1/jobs/{job_id}.
+    def get_job(job_id)
+      encoded_job_id = URI.encode_www_form_component(job_id)
+      get("/api/v1/jobs/#{encoded_job_id}")
+    end
+
+    # GET a host-relative REST path.
+    def get(path, params = {})
+      request("GET", path, params: params)
+    end
+
+    # POST JSON to a host-relative REST path.
+    def post(path, body)
+      request("POST", path, body: body)
+    end
+
+    private
+
+    def request(method, path, params: {}, body: nil)
+      raise ArgumentError, "REST paths must start with '/'" unless path.start_with?("/")
+
+      url = @base_url + path
+      unless params.empty?
+        query = URI.encode_www_form(stringify_params(params))
+        url = "#{url}?#{query}"
+      end
+
+      headers = {
+        "User-Agent" => USER_AGENT,
+        "Accept" => "application/json",
+      }
+      encoded_body = nil
+      unless body.nil?
+        headers["Content-Type"] = "application/json"
+        encoded_body = JSON.generate(body)
+      end
+      headers["Authorization"] = "Bearer #{@api_key}" if @api_key
+
+      status_code, _content_type, text = @transport.call(
+        url: url,
+        method: method,
+        headers: headers,
+        body: encoded_body,
+        timeout: @timeout,
+      )
+      value = parse_body(text)
+      raise APIError.new(status_code, value) if status_code < 200 || status_code >= 300
+
+      value
+    end
+
+    def stringify_params(params)
+      params.transform_values do |value|
+        case value
+        when true
+          "true"
+        when false
+          "false"
+        else
+          value.to_s
+        end
+      end
+    end
+
+    def parse_body(text)
+      return text if text.nil? || text.empty?
+
+      JSON.parse(text)
+    rescue JSON::ParserError
+      text
+    end
+
+    def default_transport(url:, method:, headers:, body:, timeout:)
+      uri = URI(url)
+      http = Net::HTTP.new(uri.host, uri.port)
+      http.use_ssl = uri.scheme == "https"
+      http.open_timeout = timeout
+      http.read_timeout = timeout
+
+      request_class = Net::HTTP.const_get(method.capitalize)
+      http_request = request_class.new(uri)
+      headers.each { |key, value| http_request[key] = value }
+      http_request.body = body if body
+
+      response = http.request(http_request)
+      [response.code.to_i, response["Content-Type"], response.body]
+    end
+  end
+end

data/lib/sorted_travel/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module SortedTravel
+  # Gem version, kept in sync with other language SDKs.
+  VERSION = "0.1.1"
+end

data/lib/sorted_travel.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require_relative "sorted_travel/version"
+require_relative "sorted_travel/client"
+require_relative "sorted_travel/cli"
+
+module SortedTravel
+end

metadata

@@ -0,0 +1,54 @@
+--- !ruby/object:Gem::Specification
+name: sorted-travel
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- Sorted Travel
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2026-09-20 00:00:00.000000000 Z
+dependencies: []
+description: Official Ruby SDK and CLI for the Sorted Travel REST API.
+email:
+- support@sorted.travel
+executables:
+- sorted-travel
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- bin/sorted-travel
+- lib/sorted_travel.rb
+- lib/sorted_travel/cli.rb
+- lib/sorted_travel/client.rb
+- lib/sorted_travel/version.rb
+homepage: https://sorted.travel
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://sorted.travel
+  source_code_uri: https://github.com/a-l-e-x-k/sorted-travel-sdk
+  documentation_uri: https://sorted.travel/sdks.md
+  rubygems_mfa_required: 'true'
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.22
+signing_key:
+specification_version: 4
+summary: Official Ruby SDK and CLI for the Sorted Travel REST API.
+test_files: []