robomart 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: cd2a2725dee3756af4ced35a76ca4da675eb960ac6bbeb2f7298cdf14102582a
+  data.tar.gz: ccb62fe68e1e5cd4f2813d90e0e8e03e8c926fbe3961f52cb3b3f300cfa9fe5c
+SHA512:
+  metadata.gz: 5841e066dc5d22e359ccea303eeb84863c090b923b0ae88e5d36dd81a2d0250ccd661140f08e3c9b134a3a233258e2c2df1e224e6bb9903fc612311518c850c7
+  data.tar.gz: ff161671c8a842d34d04e104923b8a226eecb50fd69673a6f50daf4eece56147ba37290608a7b3ea6f3e727a29c6bc72f3f079b0e4a196d367fa5db21bc12b29

data/README.md

@@ -0,0 +1,22 @@
+# robomart
+
+Ruby client for the Robomart Network Delivery API — coverage preview, one-step booking at posted flat rates, tracking, proof of delivery, and wallet reads.
+
+```ruby
+require "robomart"
+
+rm = Robomart::Client.new("rm_sk_test_...")
+
+route = rm.coverage(
+  pickup: { address: "8080 Park Ln, Dallas, TX" },
+  dropoff: { address: "2323 N Field St, Dallas, TX" }
+)
+
+order = rm.book({
+  pickup: { address: "...", contact: { name: "...", phone: "..." } },
+  dropoff: { address: "...", contact: { name: "...", phone: "..." } },
+  parcel: { length_in: 12, width_in: 10, height_in: 8, weight_lb: 5 }
+}, idempotency_key: "order-1")
+```
+
+Get a key at [console.robomart.ai](https://console.robomart.ai). AI agents can book directly through the Delivery MCP at `mcp.robomart.ai` with the same key.

data/lib/robomart.rb

@@ -0,0 +1,128 @@
+# Ruby client for the Robomart Network Delivery API.
+#
+# Prices are posted flat rates, so there is no quote step: preview a route
+# with coverage and book in one call.
+#
+#   rm = Robomart::Client.new("rm_sk_test_...")
+#   route = rm.coverage(pickup: { address: "..." }, dropoff: { address: "..." })
+#   order = rm.book({ ... }, idempotency_key: "order-1")
+
+require "json"
+require "net/http"
+require "uri"
+
+module Robomart
+  VERSION = "0.1.0"
+  DEFAULT_BASE_URL = "https://api.robomart.ai"
+  DEFAULT_API_VERSION = "2026-08-27"
+
+  # API error carrying the HTTP status and the error envelope.
+  class Error < StandardError
+    attr_reader :status, :type, :code
+
+    def initialize(message, status: nil, type: nil, code: nil)
+      super(message)
+      @status = status
+      @type = type
+      @code = code
+    end
+  end
+
+  class Client
+    def initialize(api_key, base_url: DEFAULT_BASE_URL, api_version: DEFAULT_API_VERSION)
+      @api_key = api_key
+      @base_url = base_url.sub(%r{/\z}, "")
+      @api_version = api_version
+    end
+
+    # Read-only route preview: eligibility, mode, and the posted fee.
+    def coverage(input)
+      post("/v1/coverage", input)
+    end
+
+    # One-step booking at the posted price. The idempotency key makes a
+    # retried call replay the original booking instead of double booking.
+    def book(input, idempotency_key:)
+      post("/v1/deliveries", input, { "Idempotency-Key" => idempotency_key }).fetch("data")
+    end
+
+    def delivery(id)
+      get("/v1/deliveries/#{id}").fetch("data")
+    end
+
+    def deliveries(limit: nil)
+      qs = limit ? "?limit=#{limit}" : ""
+      get("/v1/deliveries#{qs}").fetch("data")
+    end
+
+    # Cancel before pickup releases the full posted price. After pickup the
+    # trip stays charged and the call is refused.
+    def cancel(id)
+      post("/v1/deliveries/#{id}/cancel").fetch("data")
+    end
+
+    # Proof of delivery, available once the delivery is delivered.
+    def proof(id)
+      get("/v1/deliveries/#{id}/proof").fetch("data")
+    end
+
+    # Sandbox lifecycle driver. Test keys only.
+    def simulate(id, action)
+      post("/v1/deliveries/#{id}/simulate", { action: action }).fetch("data")
+    end
+
+    # Wallet reads. Cents throughout.
+    def balance
+      get("/v1/balance")
+    end
+
+    def ledger(limit: nil)
+      qs = limit ? "?limit=#{limit}" : ""
+      get("/v1/ledger#{qs}").fetch("data")
+    end
+
+    def topup_preview(amount_credited_cents)
+      get("/v1/topups/preview?amount_credited=#{amount_credited_cents}")
+    end
+
+    def topup_link
+      post("/v1/topups/link")
+    end
+
+    private
+
+    def get(path)
+      request(Net::HTTP::Get, path)
+    end
+
+    def post(path, body = nil, extra_headers = {})
+      request(Net::HTTP::Post, path, body, extra_headers)
+    end
+
+    def request(verb, path, body = nil, extra_headers = {})
+      uri = URI.parse(@base_url + path)
+      req = verb.new(uri)
+      req["Authorization"] = "Bearer #{@api_key}"
+      req["Content-Type"] = "application/json"
+      req["Robomart-Version"] = @api_version
+      req["User-Agent"] = "robomart-ruby/#{VERSION}"
+      extra_headers.each { |k, v| req[k] = v }
+      req.body = JSON.generate(body) if body
+
+      res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http|
+        http.request(req)
+      end
+      payload = begin
+        JSON.parse(res.body.to_s.empty? ? "{}" : res.body)
+      rescue JSON::ParserError
+        {}
+      end
+      return payload if res.is_a?(Net::HTTPSuccess)
+
+      detail = payload["error"].is_a?(Hash) ? payload["error"] : {}
+      message = detail["message"] || payload["error"] || payload["message"] ||
+                "Request failed with status #{res.code}"
+      raise Error.new(message, status: res.code.to_i, type: detail["type"], code: detail["code"])
+    end
+  end
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: robomart
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Robomart
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-08-30 00:00:00.000000000 Z
+dependencies: []
+description: Coverage preview, one-step booking at posted flat rates, tracking, proof
+  of delivery, and wallet reads for the Robomart Network.
+email:
+- ali@robomart.ai
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/robomart.rb
+homepage: https://robomart.ai
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/robomart-ai/api
+  documentation_uri: https://api.robomart.ai
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.6'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3.1
+signing_key: 
+specification_version: 4
+summary: Ruby client for the Robomart Network Delivery API
+test_files: []