repull 0.2.15 → 0.2.17

data/lib/repull/models/listing_create_request.rb

@@ -14,23 +14,41 @@ require 'date'
 require 'time'
 
 module Repull
-  # Inputs for `POST /v1/listings`. Provide enough address detail (street + city + lat/lng) for downstream Airbnb publish to work.
+  # Inputs for `POST /v1/listings`.  **Address requirements — read this before you build the payload.** Publishing to Airbnb runs a create preflight that refuses the listing outright if the address is incomplete, and the refusal only surfaces later, at publish time. Airbnb requires `street` and `city` for every country. For a **US** property it additionally requires `state` and `postalCode`. Crucially, **omitting `countryCode` makes the listing behave as US**, so a listing created without a country needs `state` and `postalCode` too. Send `countryCode` explicitly for a non-US property. `lat`/`lng` alone are not enough — Airbnb rejects coordinates that are not backed by a full postal address. Use `GET /v1/listings/{id}/publish-status` to see which parts are still missing before you attempt a publish.
   class ListingCreateRequest < ApiModelBase
     # Public guest-facing title
     attr_accessor :name
 
     attr_accessor :property_type
 
+    # What the guest actually gets. Airbnb refuses to activate a listing that has not stated one, answering \"Please specify a valid room type\" — which reads like a beds problem and is not. It is never defaulted: most listings are an entire home, but hundreds are a private or hotel room, and publishing one of those as an entire home is a false claim about someone's property. Settable later with `PUT /v1/listings/{id}/content` under `details`.
+    attr_accessor :room_type_category
+
+    # Airbnb's finer property-type category, when you know it. Optional.
+    attr_accessor :property_type_category
+
+    # Street address including the number. Required by Airbnb for every country — a publish is refused without it.
     attr_accessor :street
 
+    # City / town. Required by Airbnb for every country — a publish is refused without it.
     attr_accessor :city
 
+    # State, province or region. **Required for a US property**, and a listing with no `countryCode` counts as US. Optional elsewhere, but stored and used wherever the channel carries it.
     attr_accessor :state
 
+    # Postal code — ZIP in the US, postcode in the UK, and so on. **Required for a US property**, and a listing with no `countryCode` counts as US. Send the complete code: Booking.com rejects a partial postcode such as `SW6` where the full value is `SW6 1EP`. Alias: `zipcode`.
+    attr_accessor :postal_code
+
+    # Alias for `postalCode`, accepted because it is the field name on the Airbnb mirror. `postalCode` wins if you send both. Prefer `postalCode` — the field holds non-US postcodes too.
+    attr_accessor :zipcode
+
+    # ISO-3166 alpha-2 country code. **Send this for any non-US property.** Omitting it does not mean \"unknown\" — the publish path treats a listing with no country as US, which then requires `state` and `postalCode` and will refuse the listing when they are absent.
     attr_accessor :country_code
 
+    # Latitude. Useful for map search, but never a substitute for the postal address — Airbnb rejects coordinates it cannot reconcile with a full address.
     attr_accessor :lat
 
+    # Longitude. See `lat`.
     attr_accessor :lng
 
     attr_accessor :bedrooms
@@ -68,9 +86,13 @@ module Repull
       {
         :'name' => :'name',
         :'property_type' => :'propertyType',
+        :'room_type_category' => :'roomTypeCategory',
+        :'property_type_category' => :'propertyTypeCategory',
         :'street' => :'street',
         :'city' => :'city',
         :'state' => :'state',
+        :'postal_code' => :'postalCode',
+        :'zipcode' => :'zipcode',
         :'country_code' => :'countryCode',
         :'lat' => :'lat',
         :'lng' => :'lng',
@@ -107,9 +129,13 @@ module Repull
       {
         :'name' => :'String',
         :'property_type' => :'String',
+        :'room_type_category' => :'String',
+        :'property_type_category' => :'String',
         :'street' => :'String',
         :'city' => :'String',
         :'state' => :'String',
+        :'postal_code' => :'String',
+        :'zipcode' => :'String',
         :'country_code' => :'String',
         :'lat' => :'Float',
         :'lng' => :'Float',
@@ -163,6 +189,14 @@ module Repull
         self.property_type = attributes[:'property_type']
       end
 
+      if attributes.key?(:'room_type_category')
+        self.room_type_category = attributes[:'room_type_category']
+      end
+
+      if attributes.key?(:'property_type_category')
+        self.property_type_category = attributes[:'property_type_category']
+      end
+
       if attributes.key?(:'street')
         self.street = attributes[:'street']
       end
@@ -175,6 +209,14 @@ module Repull
         self.state = attributes[:'state']
       end
 
+      if attributes.key?(:'postal_code')
+        self.postal_code = attributes[:'postal_code']
+      end
+
+      if attributes.key?(:'zipcode')
+        self.zipcode = attributes[:'zipcode']
+      end
+
       if attributes.key?(:'country_code')
         self.country_code = attributes[:'country_code']
       end
@@ -285,9 +327,13 @@ module Repull
       self.class == o.class &&
           name == o.name &&
           property_type == o.property_type &&
+          room_type_category == o.room_type_category &&
+          property_type_category == o.property_type_category &&
           street == o.street &&
           city == o.city &&
           state == o.state &&
+          postal_code == o.postal_code &&
+          zipcode == o.zipcode &&
           country_code == o.country_code &&
           lat == o.lat &&
           lng == o.lng &&
@@ -317,7 +363,7 @@ module Repull
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [name, property_type, street, city, state, country_code, lat, lng, bedrooms, bathrooms, beds, person_capacity, summary, description, default_daily_price, cleaning_fee, cancellation_policy, check_in_time_start, check_out_time, allows_pets, allows_smoking, allows_children, allows_events].hash
+      [name, property_type, room_type_category, property_type_category, street, city, state, postal_code, zipcode, country_code, lat, lng, bedrooms, bathrooms, beds, person_capacity, summary, description, default_daily_price, cleaning_fee, cancellation_policy, check_in_time_start, check_out_time, allows_pets, allows_smoking, allows_children, allows_events].hash
     end
 
     # Builds the object from hash

data/lib/repull/models/listing_created_event.rb

@@ -15,23 +15,29 @@ require 'time'
 
 module Repull
   class ListingCreatedEvent < ApiModelBase
-    attr_accessor :id
+    # The event name. This field is `event`, not `type`.
+    attr_accessor :event
 
-    attr_accessor :type
-
-    attr_accessor :created_at
+    # Stable across every delivery and replay of this logical event — dedupe on it.
+    attr_accessor :event_id
 
     attr_accessor :api_version
 
+    # When this delivery was built.
+    attr_accessor :timestamp
+
+    attr_accessor :account
+
     attr_accessor :data
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'id' => :'id',
-        :'type' => :'type',
-        :'created_at' => :'createdAt',
+        :'event' => :'event',
+        :'event_id' => :'eventId',
         :'api_version' => :'apiVersion',
+        :'timestamp' => :'timestamp',
+        :'account' => :'account',
         :'data' => :'data'
       }
     end
@@ -49,10 +55,11 @@ module Repull
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'id' => :'String',
-        :'type' => :'String',
-        :'created_at' => :'Time',
+        :'event' => :'String',
+        :'event_id' => :'String',
         :'api_version' => :'String',
+        :'timestamp' => :'Time',
+        :'account' => :'WebhookEventAccount',
         :'data' => :'ListingCreatedPayload'
       }
     end
@@ -60,6 +67,7 @@ module Repull
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'account',
       ])
     end
 
@@ -79,22 +87,32 @@ module Repull
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'id')
-        self.id = attributes[:'id']
-      end
-
-      if attributes.key?(:'type')
-        self.type = attributes[:'type']
+      if attributes.key?(:'event')
+        self.event = attributes[:'event']
       else
-        self.type = nil
+        self.event = nil
       end
 
-      if attributes.key?(:'created_at')
-        self.created_at = attributes[:'created_at']
+      if attributes.key?(:'event_id')
+        self.event_id = attributes[:'event_id']
+      else
+        self.event_id = nil
       end
 
       if attributes.key?(:'api_version')
         self.api_version = attributes[:'api_version']
+      else
+        self.api_version = nil
+      end
+
+      if attributes.key?(:'timestamp')
+        self.timestamp = attributes[:'timestamp']
+      else
+        self.timestamp = nil
+      end
+
+      if attributes.key?(:'account')
+        self.account = attributes[:'account']
       end
 
       if attributes.key?(:'data')
@@ -109,8 +127,20 @@ module Repull
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @type.nil?
-        invalid_properties.push('invalid value for "type", type cannot be nil.')
+      if @event.nil?
+        invalid_properties.push('invalid value for "event", event cannot be nil.')
+      end
+
+      if @event_id.nil?
+        invalid_properties.push('invalid value for "event_id", event_id cannot be nil.')
+      end
+
+      if @api_version.nil?
+        invalid_properties.push('invalid value for "api_version", api_version cannot be nil.')
+      end
+
+      if @timestamp.nil?
+        invalid_properties.push('invalid value for "timestamp", timestamp cannot be nil.')
       end
 
       if @data.nil?
@@ -124,19 +154,52 @@ module Repull
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @type.nil?
+      return false if @event.nil?
+      return false if @event_id.nil?
+      return false if @api_version.nil?
+      return false if @timestamp.nil?
       return false if @data.nil?
       true
     end
 
     # Custom attribute writer method with validation
-    # @param [Object] type Value to be assigned
-    def type=(type)
-      if type.nil?
-        fail ArgumentError, 'type cannot be nil'
+    # @param [Object] event Value to be assigned
+    def event=(event)
+      if event.nil?
+        fail ArgumentError, 'event cannot be nil'
+      end
+
+      @event = event
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] event_id Value to be assigned
+    def event_id=(event_id)
+      if event_id.nil?
+        fail ArgumentError, 'event_id cannot be nil'
+      end
+
+      @event_id = event_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] api_version Value to be assigned
+    def api_version=(api_version)
+      if api_version.nil?
+        fail ArgumentError, 'api_version cannot be nil'
+      end
+
+      @api_version = api_version
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] timestamp Value to be assigned
+    def timestamp=(timestamp)
+      if timestamp.nil?
+        fail ArgumentError, 'timestamp cannot be nil'
       end
 
-      @type = type
+      @timestamp = timestamp
     end
 
     # Custom attribute writer method with validation
@@ -154,10 +217,11 @@ module Repull
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          id == o.id &&
-          type == o.type &&
-          created_at == o.created_at &&
+          event == o.event &&
+          event_id == o.event_id &&
           api_version == o.api_version &&
+          timestamp == o.timestamp &&
+          account == o.account &&
           data == o.data
     end
 
@@ -170,7 +234,7 @@ module Repull
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, type, created_at, api_version, data].hash
+      [event, event_id, api_version, timestamp, account, data].hash
     end
 
     # Builds the object from hash

data/lib/repull/models/listing_deleted_event.rb

@@ -15,23 +15,29 @@ require 'time'
 
 module Repull
   class ListingDeletedEvent < ApiModelBase
-    attr_accessor :id
+    # The event name. This field is `event`, not `type`.
+    attr_accessor :event
 
-    attr_accessor :type
-
-    attr_accessor :created_at
+    # Stable across every delivery and replay of this logical event — dedupe on it.
+    attr_accessor :event_id
 
     attr_accessor :api_version
 
+    # When this delivery was built.
+    attr_accessor :timestamp
+
+    attr_accessor :account
+
     attr_accessor :data
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'id' => :'id',
-        :'type' => :'type',
-        :'created_at' => :'createdAt',
+        :'event' => :'event',
+        :'event_id' => :'eventId',
         :'api_version' => :'apiVersion',
+        :'timestamp' => :'timestamp',
+        :'account' => :'account',
         :'data' => :'data'
       }
     end
@@ -49,10 +55,11 @@ module Repull
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'id' => :'String',
-        :'type' => :'String',
-        :'created_at' => :'Time',
+        :'event' => :'String',
+        :'event_id' => :'String',
         :'api_version' => :'String',
+        :'timestamp' => :'Time',
+        :'account' => :'WebhookEventAccount',
         :'data' => :'ListingDeletedPayload'
       }
     end
@@ -60,6 +67,7 @@ module Repull
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
+        :'account',
       ])
     end
 
@@ -79,22 +87,32 @@ module Repull
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'id')
-        self.id = attributes[:'id']
-      end
-
-      if attributes.key?(:'type')
-        self.type = attributes[:'type']
+      if attributes.key?(:'event')
+        self.event = attributes[:'event']
       else
-        self.type = nil
+        self.event = nil
       end
 
-      if attributes.key?(:'created_at')
-        self.created_at = attributes[:'created_at']
+      if attributes.key?(:'event_id')
+        self.event_id = attributes[:'event_id']
+      else
+        self.event_id = nil
       end
 
       if attributes.key?(:'api_version')
         self.api_version = attributes[:'api_version']
+      else
+        self.api_version = nil
+      end
+
+      if attributes.key?(:'timestamp')
+        self.timestamp = attributes[:'timestamp']
+      else
+        self.timestamp = nil
+      end
+
+      if attributes.key?(:'account')
+        self.account = attributes[:'account']
       end
 
       if attributes.key?(:'data')
@@ -109,8 +127,20 @@ module Repull
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
-      if @type.nil?
-        invalid_properties.push('invalid value for "type", type cannot be nil.')
+      if @event.nil?
+        invalid_properties.push('invalid value for "event", event cannot be nil.')
+      end
+
+      if @event_id.nil?
+        invalid_properties.push('invalid value for "event_id", event_id cannot be nil.')
+      end
+
+      if @api_version.nil?
+        invalid_properties.push('invalid value for "api_version", api_version cannot be nil.')
+      end
+
+      if @timestamp.nil?
+        invalid_properties.push('invalid value for "timestamp", timestamp cannot be nil.')
       end
 
       if @data.nil?
@@ -124,19 +154,52 @@ module Repull
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
-      return false if @type.nil?
+      return false if @event.nil?
+      return false if @event_id.nil?
+      return false if @api_version.nil?
+      return false if @timestamp.nil?
       return false if @data.nil?
       true
     end
 
     # Custom attribute writer method with validation
-    # @param [Object] type Value to be assigned
-    def type=(type)
-      if type.nil?
-        fail ArgumentError, 'type cannot be nil'
+    # @param [Object] event Value to be assigned
+    def event=(event)
+      if event.nil?
+        fail ArgumentError, 'event cannot be nil'
+      end
+
+      @event = event
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] event_id Value to be assigned
+    def event_id=(event_id)
+      if event_id.nil?
+        fail ArgumentError, 'event_id cannot be nil'
+      end
+
+      @event_id = event_id
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] api_version Value to be assigned
+    def api_version=(api_version)
+      if api_version.nil?
+        fail ArgumentError, 'api_version cannot be nil'
+      end
+
+      @api_version = api_version
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] timestamp Value to be assigned
+    def timestamp=(timestamp)
+      if timestamp.nil?
+        fail ArgumentError, 'timestamp cannot be nil'
       end
 
-      @type = type
+      @timestamp = timestamp
     end
 
     # Custom attribute writer method with validation
@@ -154,10 +217,11 @@ module Repull
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
-          id == o.id &&
-          type == o.type &&
-          created_at == o.created_at &&
+          event == o.event &&
+          event_id == o.event_id &&
           api_version == o.api_version &&
+          timestamp == o.timestamp &&
+          account == o.account &&
           data == o.data
     end
 
@@ -170,7 +234,7 @@ module Repull
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, type, created_at, api_version, data].hash
+      [event, event_id, api_version, timestamp, account, data].hash
     end
 
     # Builds the object from hash

data/lib/repull/models/listing_deleted_payload.rb

@@ -14,20 +14,20 @@ require 'date'
 require 'time'
 
 module Repull
-  # Payload for `listing.deleted`. A property was removed from Repull or the upstream PMS.
+  # Payload for `listing.deleted`. The listing is no longer reachable on the channel — usually because the host unlinked it.
   class ListingDeletedPayload < ApiModelBase
-    attr_accessor :id
-
-    attr_accessor :deleted_at
+    attr_accessor :object
 
     attr_accessor :reason
 
+    attr_accessor :deleted_at
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'id' => :'id',
-        :'deleted_at' => :'deletedAt',
-        :'reason' => :'reason'
+        :'object' => :'object',
+        :'reason' => :'reason',
+        :'deleted_at' => :'deletedAt'
       }
     end
 
@@ -44,16 +44,16 @@ module Repull
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'id' => :'Integer',
-        :'deleted_at' => :'Time',
-        :'reason' => :'String'
+        :'object' => :'ListingWebhookObject',
+        :'reason' => :'String',
+        :'deleted_at' => :'Time'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
-        :'reason'
+        :'reason',
       ])
     end
 
@@ -73,17 +73,21 @@ module Repull
         h[k.to_sym] = v
       }
 
-      if attributes.key?(:'id')
-        self.id = attributes[:'id']
-      end
-
-      if attributes.key?(:'deleted_at')
-        self.deleted_at = attributes[:'deleted_at']
+      if attributes.key?(:'object')
+        self.object = attributes[:'object']
+      else
+        self.object = nil
       end
 
       if attributes.key?(:'reason')
         self.reason = attributes[:'reason']
       end
+
+      if attributes.key?(:'deleted_at')
+        self.deleted_at = attributes[:'deleted_at']
+      else
+        self.deleted_at = nil
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -91,6 +95,14 @@ module Repull
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
+      if @object.nil?
+        invalid_properties.push('invalid value for "object", object cannot be nil.')
+      end
+
+      if @deleted_at.nil?
+        invalid_properties.push('invalid value for "deleted_at", deleted_at cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -98,17 +110,39 @@ module Repull
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @object.nil?
+      return false if @deleted_at.nil?
       true
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] object Value to be assigned
+    def object=(object)
+      if object.nil?
+        fail ArgumentError, 'object cannot be nil'
+      end
+
+      @object = object
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] deleted_at Value to be assigned
+    def deleted_at=(deleted_at)
+      if deleted_at.nil?
+        fail ArgumentError, 'deleted_at cannot be nil'
+      end
+
+      @deleted_at = deleted_at
+    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 &&
-          id == o.id &&
-          deleted_at == o.deleted_at &&
-          reason == o.reason
+          object == o.object &&
+          reason == o.reason &&
+          deleted_at == o.deleted_at
     end
 
     # @see the `==` method
@@ -120,7 +154,7 @@ module Repull
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [id, deleted_at, reason].hash
+      [object, reason, deleted_at].hash
     end
 
     # Builds the object from hash