repull 0.2.8 → 0.2.9

data/lib/repull/models/listing_content_update_request_amenities.rb

@@ -0,0 +1,105 @@
+=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`, `custom`) are enforced separately and also surface as 429s; they include `tier`, `scope`, and `resets_at` fields.  ## Plan Limits (402 — `listings_limit_exceeded`) The Repull API also enforces a per-tier cap on **active listings**:  | Tier | Active listings cap | |---|---| | `free` | 3 | | `starter` | 50 | | `custom` | unlimited |  When a customer's active-listing count is above their tier cap, the API returns **`402 Payment Required`** with `error.code = \"listings_limit_exceeded\"` on every route EXCEPT:  - `/v1/health` — uptime probes are never gated. - `/v1/usage/*` — so dashboards can render the over-cap state. - Any `DELETE` — so the customer can trim listings to get back under the cap without paying.  Unlike 429, 402 is NOT a \"wait and retry\" condition — `Retry-After` is not set. The only paths back to 200 are:   1. `DELETE` enough listings to come back under the cap, or   2. Upgrade at `https://repull.dev/dashboard/billing`. The server-side usage cache is 60s, so the first 200 after an upgrade may take up to a minute.  The envelope mirrors `rate_limit_exceeded` for SDK ergonomics: `tier`, `limit`, `active_listings`, `upgrade_url`, plus the standard `code` / `message` / `fix` / `docs_url` / `request_id`.
+
+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 'date'
+require 'time'
+
+module Repull
+  # FULL replacement of the amenity set. Accepts canonical keys as a string[] or structured rows. Omit to leave amenities untouched; send `[]` to clear them.
+  module ListingContentUpdateRequestAmenities
+    class << self
+      # List of class defined in oneOf (OpenAPI v3)
+      def openapi_one_of
+        [
+          :'Array<ListingContentUpdateRequestAmenitiesOneOfInner>',
+          :'Array<String>'
+        ]
+      end
+
+      # Builds the object
+      # @param [Mixed] Data to be matched against the list of oneOf items
+      # @return [Object] Returns the model or the data itself
+      def build(data)
+        # Go through the list of oneOf items and attempt to identify the appropriate one.
+        # Note:
+        # - We do not attempt to check whether exactly one item matches.
+        # - No advanced validation of types in some cases (e.g. "x: { type: string }" will happily match { x: 123 })
+        #   due to the way the deserialization is made in the base_object template (it just casts without verifying).
+        # - TODO: scalar values are de facto behaving as if they were nullable.
+        # - TODO: logging when debugging is set.
+        openapi_one_of.each do |klass|
+          begin
+            next if klass == :AnyType # "nullable: true"
+            return find_and_cast_into_type(klass, data)
+          rescue # rescue all errors so we keep iterating even if the current item lookup raises
+          end
+        end
+
+        openapi_one_of.include?(:AnyType) ? data : nil
+      end
+
+      private
+
+      SchemaMismatchError = Class.new(StandardError)
+
+      # Note: 'File' is missing here because in the regular case we get the data _after_ a call to JSON.parse.
+      def find_and_cast_into_type(klass, data)
+        return if data.nil?
+
+        case klass.to_s
+        when 'Boolean'
+          return data if data.instance_of?(TrueClass) || data.instance_of?(FalseClass)
+        when 'Float'
+          return data if data.instance_of?(Float)
+        when 'Integer'
+          return data if data.instance_of?(Integer)
+        when 'Time'
+          return Time.parse(data)
+        when 'Date'
+          return Date.iso8601(data)
+        when 'String'
+          return data if data.instance_of?(String)
+        when 'Object' # "type: object"
+          return data if data.instance_of?(Hash)
+        when /\AArray<(?<sub_type>.+)>\z/ # "type: array"
+          if data.instance_of?(Array)
+            sub_type = Regexp.last_match[:sub_type]
+            return data.map { |item| find_and_cast_into_type(sub_type, item) }
+          end
+        when /\AHash<String, (?<sub_type>.+)>\z/ # "type: object" with "additionalProperties: { ... }"
+          if data.instance_of?(Hash) && data.keys.all? { |k| k.instance_of?(Symbol) || k.instance_of?(String) }
+            sub_type = Regexp.last_match[:sub_type]
+            return data.each_with_object({}) { |(k, v), hsh| hsh[k] = find_and_cast_into_type(sub_type, v) }
+          end
+        else # model
+          const = Repull.const_get(klass)
+          if const
+            if const.respond_to?(:openapi_one_of) # nested oneOf model
+              model = const.build(data)
+              return model if model
+            else
+              # raise if data contains keys that are not known to the model
+              raise if const.respond_to?(:acceptable_attributes) && !(data.keys - const.acceptable_attributes).empty?
+              model = const.build_from_hash(data)
+              return model if model
+            end
+          end
+        end
+
+        raise # if no match by now, raise
+      rescue
+        raise SchemaMismatchError, "#{data} doesn't match the #{klass} type"
+      end
+    end
+  end
+
+end

data/lib/repull/models/{create_studio_deployment_request.rb → listing_content_update_request_amenities_one_of_inner.rb}

@@ -14,14 +14,22 @@ require 'date'
 require 'time'
 
 module Repull
-  class CreateStudioDeploymentRequest < ApiModelBase
-    # Project to deploy.
-    attr_accessor :project_id
+  class ListingContentUpdateRequestAmenitiesOneOfInner < ApiModelBase
+    attr_accessor :amenity_key
+
+    attr_accessor :category
+
+    attr_accessor :is_present
+
+    attr_accessor :instruction
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'project_id' => :'project_id'
+        :'amenity_key' => :'amenityKey',
+        :'category' => :'category',
+        :'is_present' => :'isPresent',
+        :'instruction' => :'instruction'
       }
     end
 
@@ -38,13 +46,19 @@ module Repull
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'project_id' => :'String'
+        :'amenity_key' => :'String',
+        :'category' => :'String',
+        :'is_present' => :'Boolean',
+        :'instruction' => :'String'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'category',
+        :'is_present',
+        :'instruction'
       ])
     end
 
@@ -52,22 +66,36 @@ module Repull
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Repull::CreateStudioDeploymentRequest` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Repull::ListingContentUpdateRequestAmenitiesOneOfInner` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Repull::CreateStudioDeploymentRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Repull::ListingContentUpdateRequestAmenitiesOneOfInner`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'project_id')
-        self.project_id = attributes[:'project_id']
+      if attributes.key?(:'amenity_key')
+        self.amenity_key = attributes[:'amenity_key']
+      else
+        self.amenity_key = nil
+      end
+
+      if attributes.key?(:'category')
+        self.category = attributes[:'category']
+      end
+
+      if attributes.key?(:'is_present')
+        self.is_present = attributes[:'is_present']
       else
-        self.project_id = nil
+        self.is_present = true
+      end
+
+      if attributes.key?(:'instruction')
+        self.instruction = attributes[:'instruction']
       end
     end
 
@@ -76,8 +104,8 @@ module Repull
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @project_id.nil?
-        invalid_properties.push('invalid value for "project_id", project_id cannot be nil.')
+      if @amenity_key.nil?
+        invalid_properties.push('invalid value for "amenity_key", amenity_key cannot be nil.')
       end
 
       invalid_properties
@@ -87,18 +115,18 @@ module Repull
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @project_id.nil?
+      return false if @amenity_key.nil?
       true
     end
 
     # Custom attribute writer method with validation
-    # @param [Object] project_id Value to be assigned
-    def project_id=(project_id)
-      if project_id.nil?
-        fail ArgumentError, 'project_id cannot be nil'
+    # @param [Object] amenity_key Value to be assigned
+    def amenity_key=(amenity_key)
+      if amenity_key.nil?
+        fail ArgumentError, 'amenity_key cannot be nil'
       end
 
-      @project_id = project_id
+      @amenity_key = amenity_key
     end
 
     # Checks equality by comparing each attribute.
@@ -106,7 +134,10 @@ module Repull
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          project_id == o.project_id
+          amenity_key == o.amenity_key &&
+          category == o.category &&
+          is_present == o.is_present &&
+          instruction == o.instruction
     end
 
     # @see the `==` method
@@ -118,7 +149,7 @@ module Repull
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [project_id].hash
+      [amenity_key, category, is_present, instruction].hash
     end
 
     # Builds the object from hash

data/lib/repull/models/{create_studio_project_generation_request.rb → listing_content_update_request_occupancy.rb}

@@ -14,14 +14,23 @@ require 'date'
 require 'time'
 
 module Repull
-  class CreateStudioProjectGenerationRequest < ApiModelBase
-    # Prompt to send to Repull AI.
-    attr_accessor :prompt
+  class ListingContentUpdateRequestOccupancy < ApiModelBase
+    attr_accessor :max_guests
+
+    attr_accessor :bedrooms
+
+    attr_accessor :beds
+
+    # Decimal, e.g. 1.5.
+    attr_accessor :bathrooms
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'prompt' => :'prompt'
+        :'max_guests' => :'maxGuests',
+        :'bedrooms' => :'bedrooms',
+        :'beds' => :'beds',
+        :'bathrooms' => :'bathrooms'
       }
     end
 
@@ -38,13 +47,20 @@ module Repull
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'prompt' => :'String'
+        :'max_guests' => :'Integer',
+        :'bedrooms' => :'Integer',
+        :'beds' => :'Integer',
+        :'bathrooms' => :'Float'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'max_guests',
+        :'bedrooms',
+        :'beds',
+        :'bathrooms'
       ])
     end
 
@@ -52,22 +68,32 @@ module Repull
     # @param [Hash] attributes Model attributes in the form of hash
     def initialize(attributes = {})
       if (!attributes.is_a?(Hash))
-        fail ArgumentError, "The input argument (attributes) must be a hash in `Repull::CreateStudioProjectGenerationRequest` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `Repull::ListingContentUpdateRequestOccupancy` initialize method"
       end
 
       # check to see if the attribute exists and convert string to symbol for hash key
       acceptable_attribute_map = self.class.acceptable_attribute_map
       attributes = attributes.each_with_object({}) { |(k, v), h|
         if (!acceptable_attribute_map.key?(k.to_sym))
-          fail ArgumentError, "`#{k}` is not a valid attribute in `Repull::CreateStudioProjectGenerationRequest`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+          fail ArgumentError, "`#{k}` is not a valid attribute in `Repull::ListingContentUpdateRequestOccupancy`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
         end
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'prompt')
-        self.prompt = attributes[:'prompt']
-      else
-        self.prompt = nil
+      if attributes.key?(:'max_guests')
+        self.max_guests = attributes[:'max_guests']
+      end
+
+      if attributes.key?(:'bedrooms')
+        self.bedrooms = attributes[:'bedrooms']
+      end
+
+      if attributes.key?(:'beds')
+        self.beds = attributes[:'beds']
+      end
+
+      if attributes.key?(:'bathrooms')
+        self.bathrooms = attributes[:'bathrooms']
       end
     end
 
@@ -76,10 +102,6 @@ module Repull
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @prompt.nil?
-        invalid_properties.push('invalid value for "prompt", prompt cannot be nil.')
-      end
-
       invalid_properties
     end
 
@@ -87,26 +109,18 @@ module Repull
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @prompt.nil?
       true
     end
 
-    # Custom attribute writer method with validation
-    # @param [Object] prompt Value to be assigned
-    def prompt=(prompt)
-      if prompt.nil?
-        fail ArgumentError, 'prompt cannot be nil'
-      end
-
-      @prompt = prompt
-    end
-
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          prompt == o.prompt
+          max_guests == o.max_guests &&
+          bedrooms == o.bedrooms &&
+          beds == o.beds &&
+          bathrooms == o.bathrooms
     end
 
     # @see the `==` method
@@ -118,7 +132,7 @@ module Repull
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [prompt].hash
+      [max_guests, bedrooms, beds, bathrooms].hash
     end
 
     # Builds the object from hash

data/lib/repull/{api/ai_api.rb → models/listing_content_update_request_photos_inner.rb}

@@ -10,77 +10,95 @@ Generator version: 7.22.0
 
 =end
 
-require 'cgi'
+require 'date'
+require 'time'
 
 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 ...'
+  module ListingContentUpdateRequestPhotosInner
+    class << self
+      # List of class defined in oneOf (OpenAPI v3)
+      def openapi_one_of
+        [
+          :'ListingContentUpdateRequestPhotosInnerOneOf',
+          :'String'
+        ]
       end
-      # resource path
-      local_var_path = '/v1/ai'
 
-      # query parameters
-      query_params = opts[:query_params] || {}
+      # Builds the object
+      # @param [Mixed] Data to be matched against the list of oneOf items
+      # @return [Object] Returns the model or the data itself
+      def build(data)
+        # Go through the list of oneOf items and attempt to identify the appropriate one.
+        # Note:
+        # - We do not attempt to check whether exactly one item matches.
+        # - No advanced validation of types in some cases (e.g. "x: { type: string }" will happily match { x: 123 })
+        #   due to the way the deserialization is made in the base_object template (it just casts without verifying).
+        # - TODO: scalar values are de facto behaving as if they were nullable.
+        # - TODO: logging when debugging is set.
+        openapi_one_of.each do |klass|
+          begin
+            next if klass == :AnyType # "nullable: true"
+            return find_and_cast_into_type(klass, data)
+          rescue # rescue all errors so we keep iterating even if the current item lookup raises
+          end
+        end
 
-      # 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
+        openapi_one_of.include?(:AnyType) ? data : nil
       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'])
+      private
 
-      # return_type
-      return_type = opts[:debug_return_type] || 'CreateAiOperation200Response'
+      SchemaMismatchError = Class.new(StandardError)
 
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['bearerAuth']
+      # Note: 'File' is missing here because in the regular case we get the data _after_ a call to JSON.parse.
+      def find_and_cast_into_type(klass, data)
+        return if data.nil?
 
-      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
-      )
+        case klass.to_s
+        when 'Boolean'
+          return data if data.instance_of?(TrueClass) || data.instance_of?(FalseClass)
+        when 'Float'
+          return data if data.instance_of?(Float)
+        when 'Integer'
+          return data if data.instance_of?(Integer)
+        when 'Time'
+          return Time.parse(data)
+        when 'Date'
+          return Date.iso8601(data)
+        when 'String'
+          return data if data.instance_of?(String)
+        when 'Object' # "type: object"
+          return data if data.instance_of?(Hash)
+        when /\AArray<(?<sub_type>.+)>\z/ # "type: array"
+          if data.instance_of?(Array)
+            sub_type = Regexp.last_match[:sub_type]
+            return data.map { |item| find_and_cast_into_type(sub_type, item) }
+          end
+        when /\AHash<String, (?<sub_type>.+)>\z/ # "type: object" with "additionalProperties: { ... }"
+          if data.instance_of?(Hash) && data.keys.all? { |k| k.instance_of?(Symbol) || k.instance_of?(String) }
+            sub_type = Regexp.last_match[:sub_type]
+            return data.each_with_object({}) { |(k, v), hsh| hsh[k] = find_and_cast_into_type(sub_type, v) }
+          end
+        else # model
+          const = Repull.const_get(klass)
+          if const
+            if const.respond_to?(:openapi_one_of) # nested oneOf model
+              model = const.build(data)
+              return model if model
+            else
+              # raise if data contains keys that are not known to the model
+              raise if const.respond_to?(:acceptable_attributes) && !(data.keys - const.acceptable_attributes).empty?
+              model = const.build_from_hash(data)
+              return model if model
+            end
+          end
+        end
 
-      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}"
+        raise # if no match by now, raise
+      rescue
+        raise SchemaMismatchError, "#{data} doesn't match the #{klass} type"
       end
-      return data, status_code, headers
     end
   end
+
 end