repull 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 73fcfa6042094c4266377e8d4331247b4987bdf4aa624ae09dc072ddfb0dde24
+  data.tar.gz: fd1da4ddbb5378b56ead52e6ecff3bf9f7e2aa9231cbcffdba7db3986f2e5edb
+SHA512:
+  metadata.gz: ab35981f126809d52a3050174f550d40a9fdcc7b556fe18f6b67f9de69497a4460ff36f18cd163b779f28a19fcdf777c7fe1a10ae263cae444a6b961296a9628
+  data.tar.gz: cfac2df0b68ef3f0b12109cdeab14d5b6d38355d0c664c4c74f3c2fa9fc2228d27126a707c57fb8e70bd01fedc81362f152a5c5e3d880945c01e13c5d3542e80

data/Gemfile

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+source 'https://rubygems.org'
+
+gemspec
+
+group :development, :test do
+  gem 'rake', '~> 13.0.1'
+  gem 'pry-byebug'
+  gem 'rubocop', '~> 1.60'
+end

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Divanova Inc.
+
+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,121 @@
+# Repull Ruby SDK
+
+> **Status:** v0.1.0 — alpha. RubyGems listing pending.
+
+Ruby SDK for [Repull](https://repull.dev) — the unified API for vacation-rental tech (50+ PMS platforms, Airbnb / Booking.com / VRBO / Plumguide channels, AI ops, white-label OAuth Connect). Generated from [api.repull.dev/openapi.json](https://api.repull.dev/openapi.json).
+
+## Install
+
+```bash
+# Once published to RubyGems:
+gem install repull
+```
+
+> **Not yet on RubyGems.** Until then, use the gem directly from this repo:
+>
+> ```ruby
+> # Gemfile
+> gem 'repull', git: 'https://github.com/ivannikolovbg/repull-ruby', branch: 'main'
+> ```
+>
+> Or build locally:
+>
+> ```bash
+> git clone https://github.com/ivannikolovbg/repull-ruby
+> cd repull-ruby
+> bundle install
+> gem build repull.gemspec
+> gem install ./repull-0.1.0.gem
+> ```
+
+## Quick start
+
+```ruby
+require 'repull'
+
+config = Repull::Configuration.new
+config.access_token = ENV['REPULL_API_KEY']
+config.host = 'api.repull.dev'
+
+api = Repull::ReservationsApi.new(Repull::ApiClient.new(config))
+result = api.v1_reservations_get(limit: 10)
+
+result.data.each do |r|
+  puts "#{r.id}\t#{r.check_in} -> #{r.check_out}\t#{r.platform}"
+end
+```
+
+See [`examples/quickstart.rb`](./examples/quickstart.rb) and [`examples/connect_airbnb.rb`](./examples/connect_airbnb.rb) for runnable scripts.
+
+## Authentication
+
+All requests use a Bearer token. Get an API key from [repull.dev/dashboard](https://repull.dev/dashboard). Sandbox keys start with `sk_test_`, production keys with `sk_live_`.
+
+```ruby
+Repull.configure do |c|
+  c.access_token = ENV['REPULL_API_KEY']
+end
+```
+
+The SDK adds the `Authorization: Bearer ...` header automatically on every request.
+
+## Examples
+
+| Script | What it does |
+|---|---|
+| [`examples/quickstart.rb`](./examples/quickstart.rb) | Health check + list reservations. |
+| [`examples/connect_airbnb.rb`](./examples/connect_airbnb.rb) | Mint an Airbnb OAuth Connect session and poll its status. |
+
+Run them:
+
+```bash
+export REPULL_API_KEY=sk_test_...
+bundle exec ruby examples/quickstart.rb
+```
+
+## What's in the box
+
+The SDK is generated from the OpenAPI spec snapshotted at [`openapi/v1.json`](./openapi/v1.json). It exposes one API class per tag:
+
+- `Repull::AIApi`
+- `Repull::AirbnbApi`
+- `Repull::AvailabilityApi`
+- `Repull::BillingApi`
+- `Repull::BookingComApi`
+- `Repull::ConnectApi`
+- `Repull::ConversationsApi`
+- `Repull::GuestsApi`
+- `Repull::PlumguideApi`
+- `Repull::PropertiesApi`
+- `Repull::ReservationsApi`
+- `Repull::SystemApi`
+- `Repull::VRBOApi`
+- `Repull::WebhooksApi`
+
+Per-class method docs live in [`docs/`](./docs).
+
+## Reference
+
+Full API reference at [repull.dev/docs](https://repull.dev/docs).
+
+## Regenerating
+
+The generated client tracks the live OpenAPI spec. To refresh:
+
+```bash
+./scripts/regen.sh
+```
+
+This re-snapshots `openapi/v1.json` from `https://api.repull.dev/openapi.json` and regenerates `lib/repull/`.
+
+## License
+
+[MIT](./LICENSE).
+
+## Status
+
+v0.1.0 — alpha. API surface may shift before v1.0. RubyGems listing pending. File issues at [github.com/ivannikolovbg/repull-ruby/issues](https://github.com/ivannikolovbg/repull-ruby/issues).
+
+---
+
+Powered by [Repull](https://repull.dev). AI features powered by [Vanio AI](https://vanio.ai).

data/Rakefile

@@ -0,0 +1,10 @@
+require "bundler/gem_tasks"
+
+begin
+  require 'rspec/core/rake_task'
+
+  RSpec::Core::RakeTask.new(:spec)
+  task default: :spec
+rescue LoadError
+  # no rspec available
+end

data/examples/connect_airbnb.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Connect a customer to Airbnb via Repull's hosted OAuth flow.
+#
+# Flow:
+#   1. POST /v1/connect/airbnb with redirectUrl + accessType — Repull mints a
+#      hosted OAuth session and returns a Connection record (and, server-side,
+#      logs an oauth_url to send the user to).
+#   2. The user completes consent at connect.repull.dev and lands on redirectUrl.
+#   3. Poll GET /v1/connect/airbnb to see the linked account.
+#
+# Usage: REPULL_API_KEY=sk_test_... bundle exec ruby examples/connect_airbnb.rb
+
+require 'repull'
+
+config = Repull::Configuration.new
+config.access_token = ENV.fetch('REPULL_API_KEY')
+config.host = 'api.repull.dev'
+
+api = Repull::ConnectApi.new(Repull::ApiClient.new(config))
+
+req = Repull::V1ConnectProviderPostRequest.new(
+  redirect_url: 'https://example.com/airbnb/return',
+  access_type: 'full_access'
+)
+
+connection = api.v1_connect_provider_post('airbnb', v1_connect_provider_post_request: req)
+puts "connection id=#{connection.id} status=#{connection.status}"
+puts "host: #{connection.host&.to_hash}" if connection.host
+
+status = api.v1_connect_provider_get('airbnb')
+puts "current airbnb status: #{status.to_hash}"

data/examples/quickstart.rb

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+# Quickstart: health check + list 10 reservations from api.repull.dev.
+# Usage: REPULL_API_KEY=sk_test_... bundle exec ruby examples/quickstart.rb
+
+require 'repull'
+
+config = Repull::Configuration.new
+config.access_token = ENV.fetch('REPULL_API_KEY')
+config.host = 'api.repull.dev'
+
+client = Repull::ApiClient.new(config)
+
+health = Repull::SystemApi.new(client).v1_health_get
+puts "health: #{health.status}"
+
+result = Repull::ReservationsApi.new(client).v1_reservations_get(limit: 10)
+puts "reservations: #{result.data.size} (total #{result.pagination&.total})"
+result.data.each do |r|
+  puts "  #{r.id}\t#{r.check_in} -> #{r.check_out}\t#{r.platform}"
+end

data/lib/repull/api/ai_api.rb

@@ -0,0 +1,86 @@
+=begin
+#Repull API
+
+#The unified API for vacation rental tech. Connect to 50+ PMS platforms and 4 OTA channels through one REST API. Built-in AI operations for guest communication, pricing, and listing optimization.  ## Designed for AI agents Every error response on this API includes machine-parseable fields so an LLM (Claude in MCP, Cursor, Cline, GPT, etc.) can self-recover without escalating to a human: - `error.code` — stable string identifier (e.g. `invalid_params`, `rate_limit_exceeded`) - `error.message` — human-readable cause - `error.fix` — exact recovery steps (e.g. \"Pass `check_in_after` as ISO 8601: `?check_in_after=2026-01-15`\") - `error.docs_url` — link to the canonical write-up at `https://repull.dev/docs/errors/{code}` - `error.request_id` — id to correlate with server-side logs - `error.field` / `error.value_received` / `error.valid_values` / `error.did_you_mean` — when the error is parameter-specific - `error.retry_after` — seconds to wait before retrying (rate-limit + transient upstream)  `Access-Control-Expose-Headers` lists `x-request-id` and the `X-RateLimit-*` family so browsers can read them on cross-origin responses.  ## Quick Start 1. Get an API key at https://repull.dev/dashboard 2. Connect a PMS: `POST /v1/connect/{provider}` 3. List properties: `GET /v1/properties` 4. Get reservations: `GET /v1/reservations`  ## Authentication All requests require a Bearer token: ``` Authorization: Bearer sk_test_YOUR_API_KEY ```  Sandbox keys start with `sk_test_`, production with `sk_live_`.  ## Request Correlation (X-Request-ID) Every response carries an `X-Request-ID` header, e.g. `X-Request-ID: req_01HXY...`. Include this id in support tickets and bug reports — we can trace the full request lifecycle (auth, rate limit, handler, downstream calls, log row) from a single id.  You may set the header on the inbound request to forward your own trace id; we will echo it back instead of generating a new one. Accepted format: `^[\\\\w.-]{1,128}$`.  The id is also embedded in error envelopes as `request_id` so server-side log diffs work even when the response headers are stripped by an intermediate proxy.  ## Rate Limits The public API enforces a per-API-key sliding-window rate limit on top of the per-tier monthly + daily-AI quotas.  **Default policy:** 600 requests per 60 seconds, per API key. Sliding window — there is no fixed-minute boundary you can burst across.  Every response includes:  | Header | Meaning | |---|---| | `X-RateLimit-Limit` | Requests permitted in the current window. | | `X-RateLimit-Remaining` | Requests left in the current window after this call. | | `X-RateLimit-Reset` | Unix epoch (seconds) when the next slot opens. | | `X-RateLimit-Policy` | Machine-readable policy descriptor, e.g. `600;w=60`. | | `Retry-After` | Seconds to wait before retrying. **Only present on 429 responses.** |  **On 429 (rate_limit_exceeded):** the response body matches the standard error envelope with `code: \"rate_limit_exceeded\"`, plus `limit`, `window_seconds`, `retry_after`, and `request_id` fields. SDKs MUST honor `Retry-After` and use exponential backoff with jitter on subsequent retries — never a tight loop.  Recommended backoff: ``` sleep_ms = (Retry-After * 1000) + random(0..250) ```  Monthly + daily-AI tier quotas (`free`, `starter`, `pro`, `enterprise`) are enforced separately and also surface as 429s; they include `tier`, `scope`, and `resets_at` fields.
+
+The version of the OpenAPI document: 1.0.0
+Contact: ivan@vanio.ai
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'cgi'
+
+module Repull
+  class AIApi
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # AI operation
+    # Perform an AI-powered operation.  Operations: - `respond-to-guest` — Generate a contextual guest response - `classify-intent` — Classify the intent of a guest message - `generate-listing` — Generate optimized listing description - `review-response` — Generate a review response - `price-suggestion` — Get AI pricing suggestions
+    # @param [Hash] opts the optional parameters
+    # @option opts [AIOperation] :ai_operation 
+    # @return [CreateAiOperation200Response]
+    def create_ai_operation(opts = {})
+      data, _status_code, _headers = create_ai_operation_with_http_info(opts)
+      data
+    end
+
+    # AI operation
+    # Perform an AI-powered operation.  Operations: - `respond-to-guest` — Generate a contextual guest response - `classify-intent` — Classify the intent of a guest message - `generate-listing` — Generate optimized listing description - `review-response` — Generate a review response - `price-suggestion` — Get AI pricing suggestions
+    # @param [Hash] opts the optional parameters
+    # @option opts [AIOperation] :ai_operation 
+    # @return [Array<(CreateAiOperation200Response, Integer, Hash)>] CreateAiOperation200Response data, response status code and response headers
+    def create_ai_operation_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AIApi.create_ai_operation ...'
+      end
+      # resource path
+      local_var_path = '/v1/ai'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json']) unless header_params['Accept']
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+          header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'ai_operation'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'CreateAiOperation200Response'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+
+      new_options = opts.merge(
+        :operation => :"AIApi.create_ai_operation",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AIApi#create_ai_operation\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end