leash-sdk 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8f4dcd4f62f60a894e5ec9b312dc228d3681fde09dab44d5d1c0af60eb3bf314
+  data.tar.gz: ff13bfe8d387c43d15852f9797d058c902afdeb0ead32444fbd753363b3f10b3
+SHA512:
+  metadata.gz: 70e3236a21000973213bd657a8ee8e3d0889e5d1e5479dc1d6ab70eed448b1f0c31e0548a146c6361acd3eebfc26bd1b98b31ffd08f593b6ff4a79a6892945ab
+  data.tar.gz: c9695b235f9b62181cde8794583eb9f59ea5d2b049faa8a52bcd601e7a297aeffe713b4cb02b48034d6bedadb48694eb2945a88355835a16c57c49c3b2c45391

data/Gemfile

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Leash
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,140 @@
+# Leash SDK for Ruby
+
+Ruby SDK for the [Leash](https://leash.build) platform integrations API. Access Gmail, Google Calendar, Google Drive, and more through the Leash platform proxy.
+
+## Installation
+
+Add to your Gemfile:
+
+```ruby
+gem "leash-sdk"
+```
+
+Or install directly:
+
+```
+gem install leash-sdk
+```
+
+## Quick Start
+
+```ruby
+require "leash"
+
+client = Leash::Integrations.new(auth_token: ENV["LEASH_AUTH_TOKEN"])
+
+# Gmail
+messages = client.gmail.list_messages(query: "is:unread", max_results: 10)
+message  = client.gmail.get_message("msg_id_123")
+client.gmail.send_message(to: "friend@example.com", subject: "Hello", body: "Hi there!")
+labels = client.gmail.list_labels
+
+# Google Calendar
+calendars = client.calendar.list_calendars
+events    = client.calendar.list_events(
+  time_min: "2026-04-10T00:00:00Z",
+  time_max: "2026-04-17T00:00:00Z",
+  single_events: true,
+  order_by: "startTime"
+)
+client.calendar.create_event(
+  summary: "Team standup",
+  start: { "dateTime" => "2026-04-11T09:00:00-04:00" },
+  end_time: { "dateTime" => "2026-04-11T09:30:00-04:00" }
+)
+
+# Google Drive
+files = client.drive.list_files
+file  = client.drive.get_file("file_id_123")
+results = client.drive.search_files("quarterly report", max_results: 5)
+```
+
+## Connection Management
+
+```ruby
+# Check if a provider is connected
+client.connected?("gmail")  # => true/false
+
+# Get all connections
+client.connections  # => [{ "providerId" => "gmail", "status" => "active", ... }]
+
+# Get OAuth connect URL (for UI buttons)
+url = client.connect_url("gmail", return_url: "https://myapp.com/settings")
+```
+
+## Error Handling
+
+```ruby
+begin
+  client.gmail.list_messages
+rescue Leash::NotConnectedError => e
+  # Redirect user to connect: e.connect_url
+  puts "Please connect Gmail: #{e.connect_url}"
+rescue Leash::TokenExpiredError => e
+  # Token needs refresh: e.connect_url
+  puts "Token expired, reconnect: #{e.connect_url}"
+rescue Leash::Error => e
+  # General API error
+  puts "Error (#{e.code}): #{e.message}"
+end
+```
+
+## Configuration
+
+```ruby
+# Custom platform URL
+client = Leash::Integrations.new(
+  auth_token: "your-token",
+  platform_url: "https://your-instance.leash.build"
+)
+```
+
+## API Reference
+
+### `Leash::Integrations.new(auth_token:, platform_url: "https://leash.build")`
+
+Creates a new client instance.
+
+### Gmail (`client.gmail`)
+
+| Method | Description |
+|--------|-------------|
+| `list_messages(query:, max_results:, label_ids:, page_token:)` | List messages |
+| `get_message(message_id, format:)` | Get a message by ID |
+| `send_message(to:, subject:, body:, cc:, bcc:)` | Send an email |
+| `search_messages(query, max_results:)` | Search messages |
+| `list_labels` | List all labels |
+
+### Calendar (`client.calendar`)
+
+| Method | Description |
+|--------|-------------|
+| `list_calendars` | List all calendars |
+| `list_events(calendar_id:, time_min:, time_max:, max_results:, single_events:, order_by:)` | List events |
+| `create_event(summary:, start:, end_time:, calendar_id:, description:, location:, attendees:)` | Create an event |
+| `get_event(event_id, calendar_id:)` | Get an event by ID |
+
+### Drive (`client.drive`)
+
+| Method | Description |
+|--------|-------------|
+| `list_files(query:, max_results:, folder_id:)` | List files |
+| `get_file(file_id)` | Get file metadata |
+| `search_files(query, max_results:)` | Search files |
+
+### Connections
+
+| Method | Description |
+|--------|-------------|
+| `connected?(provider_id)` | Check if provider is connected |
+| `connections` | Get all connection statuses |
+| `connect_url(provider_id, return_url:)` | Get OAuth connect URL |
+
+## Requirements
+
+- Ruby >= 3.0
+- No external dependencies (uses stdlib `net/http`, `json`, `uri`)
+
+## License
+
+MIT

data/leash-sdk.gemspec

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+require_relative "lib/leash"
+
+Gem::Specification.new do |spec|
+  spec.name          = "leash-sdk"
+  spec.version       = Leash::VERSION
+  spec.authors       = ["Leash"]
+  spec.email         = ["hello@leash.build"]
+
+  spec.summary       = "Ruby SDK for the Leash platform integrations API"
+  spec.description   = "Access Gmail, Google Calendar, Google Drive, and more through the Leash platform proxy. No API keys needed -- uses your Leash auth token."
+  spec.homepage      = "https://github.com/leash-build/leash-sdk-ruby"
+  spec.license       = "MIT"
+  spec.required_ruby_version = ">= 3.0"
+
+  spec.metadata["homepage_uri"]    = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"]   = "#{spec.homepage}/blob/main/CHANGELOG.md"
+
+  spec.files = Dir["lib/**/*.rb"] + ["leash-sdk.gemspec", "Gemfile", "README.md", "LICENSE"]
+  spec.require_paths = ["lib"]
+
+  # No runtime dependencies -- stdlib only (net/http, json, uri).
+end

data/lib/leash/calendar.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+module Leash
+  # Client for Google Calendar operations via the Leash platform proxy.
+  #
+  # Not instantiated directly -- use {Integrations#calendar} instead.
+  class CalendarClient
+    PROVIDER = "google_calendar"
+
+    # @api private
+    def initialize(call_fn)
+      @call = call_fn
+    end
+
+    # List all calendars accessible to the user.
+    #
+    # @return [Hash] hash with calendar list data
+    def list_calendars
+      @call.call(PROVIDER, "list-calendars", {})
+    end
+
+    # List events on a calendar.
+    #
+    # @param calendar_id [String, nil] calendar identifier (defaults to "primary" on the server)
+    # @param time_min [String, nil] lower bound for event start time (RFC 3339)
+    # @param time_max [String, nil] upper bound for event start time (RFC 3339)
+    # @param max_results [Integer, nil] maximum number of events to return
+    # @param single_events [Boolean, nil] whether to expand recurring events
+    # @param order_by [String, nil] sort order (e.g. "startTime", "updated")
+    # @return [Hash] hash with "items" list of events
+    def list_events(calendar_id: nil, time_min: nil, time_max: nil, max_results: nil, single_events: nil, order_by: nil)
+      params = {}
+      params["calendarId"] = calendar_id if calendar_id
+      params["timeMin"] = time_min if time_min
+      params["timeMax"] = time_max if time_max
+      params["maxResults"] = max_results if max_results
+      params["singleEvents"] = single_events unless single_events.nil?
+      params["orderBy"] = order_by if order_by
+      @call.call(PROVIDER, "list-events", params)
+    end
+
+    # Create a new calendar event.
+    #
+    # @param summary [String] event title
+    # @param start [Hash, String] start time -- either an RFC 3339 string or a hash
+    #   with keys "dateTime", "date", and/or "timeZone"
+    # @param end_time [Hash, String] end time (same format as +start+)
+    # @param calendar_id [String, nil] calendar identifier (defaults to "primary")
+    # @param description [String, nil] event description
+    # @param location [String, nil] event location
+    # @param attendees [Array<Hash>, nil] list of attendee hashes (e.g. [{ "email" => "a@b.com" }])
+    # @return [Hash] the created event object
+    def create_event(summary:, start:, end_time:, calendar_id: nil, description: nil, location: nil, attendees: nil)
+      params = { "summary" => summary, "start" => start, "end" => end_time }
+      params["calendarId"] = calendar_id if calendar_id
+      params["description"] = description if description
+      params["location"] = location if location
+      params["attendees"] = attendees if attendees
+      @call.call(PROVIDER, "create-event", params)
+    end
+
+    # Get a single event by ID.
+    #
+    # @param event_id [String] the event identifier
+    # @param calendar_id [String, nil] the calendar identifier
+    # @return [Hash] the event object
+    def get_event(event_id, calendar_id: nil)
+      params = { "eventId" => event_id }
+      params["calendarId"] = calendar_id if calendar_id
+      @call.call(PROVIDER, "get-event", params)
+    end
+  end
+end

data/lib/leash/drive.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Leash
+  # Client for Google Drive operations via the Leash platform proxy.
+  #
+  # Not instantiated directly -- use {Integrations#drive} instead.
+  class DriveClient
+    PROVIDER = "google_drive"
+
+    # @api private
+    def initialize(call_fn)
+      @call = call_fn
+    end
+
+    # List files in the user's Drive.
+    #
+    # @param query [String, nil] Drive search query (Google Drive API query syntax)
+    # @param max_results [Integer, nil] maximum number of files to return
+    # @param folder_id [String, nil] restrict to files within a specific folder
+    # @return [Hash] hash with "files" list
+    def list_files(query: nil, max_results: nil, folder_id: nil)
+      params = {}
+      params["query"] = query if query
+      params["maxResults"] = max_results if max_results
+      params["folderId"] = folder_id if folder_id
+      @call.call(PROVIDER, "list-files", params)
+    end
+
+    # Get file metadata by ID.
+    #
+    # @param file_id [String] the file identifier
+    # @return [Hash] the file metadata object
+    def get_file(file_id)
+      @call.call(PROVIDER, "get-file", { "fileId" => file_id })
+    end
+
+    # Search files using a query string.
+    #
+    # @param query [String] search query (Google Drive API query syntax)
+    # @param max_results [Integer, nil] maximum number of results
+    # @return [Hash] hash with "files" list
+    def search_files(query, max_results: nil)
+      params = { "query" => query }
+      params["maxResults"] = max_results if max_results
+      @call.call(PROVIDER, "search-files", params)
+    end
+  end
+end

data/lib/leash/errors.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Leash
+  # Base error class for all Leash SDK errors.
+  #
+  # @attr_reader [String, nil] code the error code from the platform
+  # @attr_reader [String, nil] connect_url the OAuth connect URL (present when provider is not connected)
+  class Error < StandardError
+    attr_reader :code, :connect_url
+
+    # @param message [String] human-readable error message
+    # @param code [String, nil] machine-readable error code
+    # @param connect_url [String, nil] URL to initiate OAuth connection
+    def initialize(message, code: nil, connect_url: nil)
+      super(message)
+      @code = code
+      @connect_url = connect_url
+    end
+  end
+
+  # Raised when the provider is not connected for the current user.
+  class NotConnectedError < Error
+    def initialize(message = "Integration not connected", connect_url: nil)
+      super(message, code: "not_connected", connect_url: connect_url)
+    end
+  end
+
+  # Raised when the OAuth token has expired and needs to be refreshed.
+  class TokenExpiredError < Error
+    def initialize(message = "Token expired", connect_url: nil)
+      super(message, code: "token_expired", connect_url: connect_url)
+    end
+  end
+end

data/lib/leash/gmail.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module Leash
+  # Client for Gmail operations via the Leash platform proxy.
+  #
+  # Not instantiated directly -- use {Integrations#gmail} instead.
+  class GmailClient
+    PROVIDER = "gmail"
+
+    # @api private
+    def initialize(call_fn)
+      @call = call_fn
+    end
+
+    # List messages in the user's mailbox.
+    #
+    # @param query [String, nil] Gmail search query (e.g. "from:user@example.com")
+    # @param max_results [Integer] maximum number of messages to return
+    # @param label_ids [Array<String>, nil] filter by label IDs (e.g. ["INBOX"])
+    # @param page_token [String, nil] token for fetching the next page of results
+    # @return [Hash] hash with "messages", "nextPageToken", and "resultSizeEstimate"
+    def list_messages(query: nil, max_results: 20, label_ids: nil, page_token: nil)
+      params = { "maxResults" => max_results }
+      params["query"] = query if query
+      params["labelIds"] = label_ids if label_ids
+      params["pageToken"] = page_token if page_token
+      @call.call(PROVIDER, "list-messages", params)
+    end
+
+    # Get a single message by ID.
+    #
+    # @param message_id [String] the message ID
+    # @param format [String] response format ("full", "metadata", "minimal", "raw")
+    # @return [Hash] the full message object
+    def get_message(message_id, format: "full")
+      @call.call(PROVIDER, "get-message", { "messageId" => message_id, "format" => format })
+    end
+
+    # Send an email message.
+    #
+    # @param to [String] recipient email address
+    # @param subject [String] email subject line
+    # @param body [String] email body text
+    # @param cc [String, nil] CC recipient(s)
+    # @param bcc [String, nil] BCC recipient(s)
+    # @return [Hash] the sent message metadata
+    def send_message(to:, subject:, body:, cc: nil, bcc: nil)
+      params = { "to" => to, "subject" => subject, "body" => body }
+      params["cc"] = cc if cc
+      params["bcc"] = bcc if bcc
+      @call.call(PROVIDER, "send-message", params)
+    end
+
+    # Search messages using a Gmail query string.
+    #
+    # @param query [String] Gmail search query
+    # @param max_results [Integer] maximum number of results to return
+    # @return [Hash] hash with "messages", "nextPageToken", and "resultSizeEstimate"
+    def search_messages(query, max_results: 20)
+      @call.call(PROVIDER, "search-messages", { "query" => query, "maxResults" => max_results })
+    end
+
+    # List all labels in the user's mailbox.
+    #
+    # @return [Hash] hash with "labels" list
+    def list_labels
+      @call.call(PROVIDER, "list-labels", {})
+    end
+  end
+end

data/lib/leash/integrations.rb

@@ -0,0 +1,146 @@
+# frozen_string_literal: true
+
+require "net/http"
+require "json"
+require "uri"
+
+require_relative "errors"
+require_relative "gmail"
+require_relative "calendar"
+require_relative "drive"
+
+module Leash
+  DEFAULT_PLATFORM_URL = "https://leash.build"
+
+  # Main client for accessing Leash platform integrations.
+  #
+  # @example
+  #   client = Leash::Integrations.new(auth_token: "your-jwt-token")
+  #   messages = client.gmail.list_messages(query: "is:unread")
+  #   events = client.calendar.list_events(time_min: "2026-04-10T00:00:00Z")
+  #   files = client.drive.list_files
+  class Integrations
+    # @param auth_token [String] the leash-auth JWT token
+    # @param platform_url [String] base URL of the Leash platform API
+    def initialize(auth_token:, platform_url: DEFAULT_PLATFORM_URL)
+      @auth_token = auth_token
+      @platform_url = platform_url.chomp("/")
+    end
+
+    # Gmail integration client.
+    #
+    # @return [GmailClient]
+    def gmail
+      @gmail ||= GmailClient.new(method(:call))
+    end
+
+    # Google Calendar integration client.
+    #
+    # @return [CalendarClient]
+    def calendar
+      @calendar ||= CalendarClient.new(method(:call))
+    end
+
+    # Google Drive integration client.
+    #
+    # @return [DriveClient]
+    def drive
+      @drive ||= DriveClient.new(method(:call))
+    end
+
+    # Generic proxy call for any provider action.
+    #
+    # @param provider [String] integration provider name (e.g. "gmail")
+    # @param action [String] action to perform (e.g. "list-messages")
+    # @param params [Hash, nil] optional request body parameters
+    # @return [Object] the "data" field from the platform response
+    # @raise [Leash::NotConnectedError] if the provider is not connected
+    # @raise [Leash::TokenExpiredError] if the OAuth token has expired
+    # @raise [Leash::Error] if the platform returns a non-success response
+    def call(provider, action, params = nil)
+      uri = URI("#{@platform_url}/api/integrations/#{provider}/#{action}")
+
+      request = Net::HTTP::Post.new(uri)
+      request["Content-Type"] = "application/json"
+      request["Authorization"] = "Bearer #{@auth_token}"
+      request.body = (params || {}).to_json
+
+      response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
+        http.request(request)
+      end
+
+      data = JSON.parse(response.body)
+
+      unless data["success"]
+        raise_error(data)
+      end
+
+      data["data"]
+    end
+
+    # Check if a provider is connected for the current user.
+    #
+    # @param provider_id [String] the provider identifier (e.g. "gmail")
+    # @return [Boolean]
+    def connected?(provider_id)
+      conn = connections.find { |c| c["providerId"] == provider_id }
+      conn&.dig("status") == "active"
+    rescue StandardError
+      false
+    end
+
+    # Get connection status for all providers.
+    #
+    # @return [Array<Hash>] list of connection status hashes
+    def connections
+      uri = URI("#{@platform_url}/api/integrations/connections")
+
+      request = Net::HTTP::Get.new(uri)
+      request["Authorization"] = "Bearer #{@auth_token}"
+
+      response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
+        http.request(request)
+      end
+
+      data = JSON.parse(response.body)
+
+      unless data["success"]
+        raise_error(data)
+      end
+
+      data["data"] || []
+    end
+
+    # Get the URL to connect a provider (for UI buttons).
+    #
+    # @param provider_id [String] the provider identifier
+    # @param return_url [String, nil] optional URL to redirect back to after connecting
+    # @return [String] the full URL to initiate the OAuth connection flow
+    def connect_url(provider_id, return_url: nil)
+      url = "#{@platform_url}/api/integrations/connect/#{provider_id}"
+      url += "?return_url=#{URI.encode_www_form_component(return_url)}" if return_url
+      url
+    end
+
+    private
+
+    # Map error codes to specific exception classes.
+    #
+    # @param data [Hash] the parsed error response
+    # @raise [Leash::NotConnectedError, Leash::TokenExpiredError, Leash::Error]
+    def raise_error(data)
+      message = data["error"] || "Unknown error"
+      code = data["code"]
+      connect_url = data["connectUrl"]
+
+      case code
+      when "not_connected"
+        raise NotConnectedError.new(message, connect_url: connect_url)
+      when "token_expired"
+        raise TokenExpiredError.new(message, connect_url: connect_url)
+      else
+        raise Error.new(message, code: code, connect_url: connect_url)
+      end
+    end
+  end
+end

data/lib/leash.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require_relative "leash/integrations"
+
+module Leash
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,57 @@
+--- !ruby/object:Gem::Specification
+name: leash-sdk
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Leash
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2026-04-10 00:00:00.000000000 Z
+dependencies: []
+description: Access Gmail, Google Calendar, Google Drive, and more through the Leash
+  platform proxy. No API keys needed -- uses your Leash auth token.
+email:
+- hello@leash.build
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- Gemfile
+- LICENSE
+- README.md
+- leash-sdk.gemspec
+- lib/leash.rb
+- lib/leash/calendar.rb
+- lib/leash/drive.rb
+- lib/leash/errors.rb
+- lib/leash/gmail.rb
+- lib/leash/integrations.rb
+homepage: https://github.com/leash-build/leash-sdk-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/leash-build/leash-sdk-ruby
+  source_code_uri: https://github.com/leash-build/leash-sdk-ruby
+  changelog_uri: https://github.com/leash-build/leash-sdk-ruby/blob/main/CHANGELOG.md
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.0'
+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 SDK for the Leash platform integrations API
+test_files: []