smplkit 3.0.8 → 3.0.9

data/lib/smplkit/_generated/app/lib/smplkit_app_client/models/{subscription_attributes.rb → subscription_item_response.rb}

@@ -14,39 +14,35 @@ require 'date'
 require 'time'
 
 module SmplkitGeneratedClient::App
-  # A subscription that grants the account access to a product on a plan.
-  class SubscriptionAttributes < ApiModelBase
-    # Product key the subscription is for, e.g. `flags`.
+  # One product enrollment as exposed in subscription responses.
+  class SubscriptionItemResponse < ApiModelBase
+    # Unique identifier for this enrollment.
+    attr_accessor :id
+
+    # Product key (e.g. `audit`, `config`, `flags`, `logging`).
     attr_accessor :product
 
-    # Plan key the subscription is on, e.g. `pro`.
+    # Current plan for this product (e.g. `STANDARD`, `PRO`).
     attr_accessor :plan
 
-    # Lifecycle state of the subscription, e.g. `active`, `trialing`, `past_due`, `canceled`.
-    attr_accessor :status
-
-    # When `true`, the subscription is complimentary and is not billed through the billing provider.
-    attr_accessor :comped
+    # Monthly list price for this enrollment, in cents. This value is locked at the time the enrollment was created or last had its plan changed; subsequent changes to the public price list do not affect this enrollment until the customer themselves changes their plan.
+    attr_accessor :price_monthly_cents
 
-    # When `true`, the subscription is billed through Stripe; otherwise it is a free or complimentary subscription that does not produce invoices.
-    attr_accessor :stripe_managed
+    # When a plan change is scheduled for the end of the current billing period, this is the plan that will take effect. Otherwise `null`. The value `FREE` indicates the enrollment will be dropped.
+    attr_accessor :pending_plan_change
 
-    # End of the current billing period (ISO 8601 timestamp).
-    attr_accessor :current_period_end
-
-    # Stripe payment intent client secret returned when a subscription create requires additional authentication (3DS). Returned only on create.
-    attr_accessor :client_secret
+    # ISO-8601 timestamp at which the pending plan change takes effect. Matches the subscription's `current_period_end`.
+    attr_accessor :scheduled_change_effective_at
 
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
+        :'id' => :'id',
         :'product' => :'product',
         :'plan' => :'plan',
-        :'status' => :'status',
-        :'comped' => :'comped',
-        :'stripe_managed' => :'stripe_managed',
-        :'current_period_end' => :'current_period_end',
-        :'client_secret' => :'client_secret'
+        :'price_monthly_cents' => :'price_monthly_cents',
+        :'pending_plan_change' => :'pending_plan_change',
+        :'scheduled_change_effective_at' => :'scheduled_change_effective_at'
       }
     end
 
@@ -63,22 +59,20 @@ module SmplkitGeneratedClient::App
     # Attribute type mapping.
     def self.openapi_types
       {
+        :'id' => :'String',
         :'product' => :'String',
         :'plan' => :'String',
-        :'status' => :'String',
-        :'comped' => :'Boolean',
-        :'stripe_managed' => :'Boolean',
-        :'current_period_end' => :'String',
-        :'client_secret' => :'String'
+        :'price_monthly_cents' => :'Integer',
+        :'pending_plan_change' => :'String',
+        :'scheduled_change_effective_at' => :'String'
       }
     end
 
     # List of attributes with nullable: true
     def self.openapi_nullable
       Set.new([
-        :'status',
-        :'current_period_end',
-        :'client_secret'
+        :'pending_plan_change',
+        :'scheduled_change_effective_at'
       ])
     end
 
@@ -86,18 +80,24 @@ module SmplkitGeneratedClient::App
     # @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 `SmplkitGeneratedClient::App::SubscriptionAttributes` initialize method"
+        fail ArgumentError, "The input argument (attributes) must be a hash in `SmplkitGeneratedClient::App::SubscriptionItemResponse` 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 `SmplkitGeneratedClient::App::SubscriptionAttributes`. 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 `SmplkitGeneratedClient::App::SubscriptionItemResponse`. 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?(:'id')
+        self.id = attributes[:'id']
+      else
+        self.id = nil
+      end
+
       if attributes.key?(:'product')
         self.product = attributes[:'product']
       else
@@ -110,28 +110,18 @@ module SmplkitGeneratedClient::App
         self.plan = nil
       end
 
-      if attributes.key?(:'status')
-        self.status = attributes[:'status']
-      end
-
-      if attributes.key?(:'comped')
-        self.comped = attributes[:'comped']
-      else
-        self.comped = nil
-      end
-
-      if attributes.key?(:'stripe_managed')
-        self.stripe_managed = attributes[:'stripe_managed']
+      if attributes.key?(:'price_monthly_cents')
+        self.price_monthly_cents = attributes[:'price_monthly_cents']
       else
-        self.stripe_managed = nil
+        self.price_monthly_cents = nil
       end
 
-      if attributes.key?(:'current_period_end')
-        self.current_period_end = attributes[:'current_period_end']
+      if attributes.key?(:'pending_plan_change')
+        self.pending_plan_change = attributes[:'pending_plan_change']
       end
 
-      if attributes.key?(:'client_secret')
-        self.client_secret = attributes[:'client_secret']
+      if attributes.key?(:'scheduled_change_effective_at')
+        self.scheduled_change_effective_at = attributes[:'scheduled_change_effective_at']
       end
     end
 
@@ -140,6 +130,10 @@ module SmplkitGeneratedClient::App
     def list_invalid_properties
       warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
       invalid_properties = Array.new
+      if @id.nil?
+        invalid_properties.push('invalid value for "id", id cannot be nil.')
+      end
+
       if @product.nil?
         invalid_properties.push('invalid value for "product", product cannot be nil.')
       end
@@ -148,12 +142,8 @@ module SmplkitGeneratedClient::App
         invalid_properties.push('invalid value for "plan", plan cannot be nil.')
       end
 
-      if @comped.nil?
-        invalid_properties.push('invalid value for "comped", comped cannot be nil.')
-      end
-
-      if @stripe_managed.nil?
-        invalid_properties.push('invalid value for "stripe_managed", stripe_managed cannot be nil.')
+      if @price_monthly_cents.nil?
+        invalid_properties.push('invalid value for "price_monthly_cents", price_monthly_cents cannot be nil.')
       end
 
       invalid_properties
@@ -163,13 +153,23 @@ module SmplkitGeneratedClient::App
     # @return true if the model is valid
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @id.nil?
       return false if @product.nil?
       return false if @plan.nil?
-      return false if @comped.nil?
-      return false if @stripe_managed.nil?
+      return false if @price_monthly_cents.nil?
       true
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] id Value to be assigned
+    def id=(id)
+      if id.nil?
+        fail ArgumentError, 'id cannot be nil'
+      end
+
+      @id = id
+    end
+
     # Custom attribute writer method with validation
     # @param [Object] product Value to be assigned
     def product=(product)
@@ -191,23 +191,13 @@ module SmplkitGeneratedClient::App
     end
 
     # Custom attribute writer method with validation
-    # @param [Object] comped Value to be assigned
-    def comped=(comped)
-      if comped.nil?
-        fail ArgumentError, 'comped cannot be nil'
-      end
-
-      @comped = comped
-    end
-
-    # Custom attribute writer method with validation
-    # @param [Object] stripe_managed Value to be assigned
-    def stripe_managed=(stripe_managed)
-      if stripe_managed.nil?
-        fail ArgumentError, 'stripe_managed cannot be nil'
+    # @param [Object] price_monthly_cents Value to be assigned
+    def price_monthly_cents=(price_monthly_cents)
+      if price_monthly_cents.nil?
+        fail ArgumentError, 'price_monthly_cents cannot be nil'
       end
 
-      @stripe_managed = stripe_managed
+      @price_monthly_cents = price_monthly_cents
     end
 
     # Checks equality by comparing each attribute.
@@ -215,13 +205,12 @@ module SmplkitGeneratedClient::App
     def ==(o)
       return true if self.equal?(o)
       self.class == o.class &&
+          id == o.id &&
           product == o.product &&
           plan == o.plan &&
-          status == o.status &&
-          comped == o.comped &&
-          stripe_managed == o.stripe_managed &&
-          current_period_end == o.current_period_end &&
-          client_secret == o.client_secret
+          price_monthly_cents == o.price_monthly_cents &&
+          pending_plan_change == o.pending_plan_change &&
+          scheduled_change_effective_at == o.scheduled_change_effective_at
     end
 
     # @see the `==` method
@@ -233,7 +222,7 @@ module SmplkitGeneratedClient::App
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [product, plan, status, comped, stripe_managed, current_period_end, client_secret].hash
+      [id, product, plan, price_monthly_cents, pending_plan_change, scheduled_change_effective_at].hash
     end
 
     # Builds the object from hash

data/lib/smplkit/_generated/app/lib/smplkit_app_client/models/subscription_preview_attributes.rb

@@ -0,0 +1,390 @@
+=begin
+#smplkit API
+
+#API for the smplkit platform.
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module SmplkitGeneratedClient::App
+  # Projected totals and per-change breakdown for a hypothetical change.
+  class SubscriptionPreviewAttributes < ApiModelBase
+    # Projected sum of item monthly list prices after the change.
+    attr_accessor :projected_subtotal_cents
+
+    # Projected discount percentage that will apply after the change.
+    attr_accessor :projected_discount_pct
+
+    # `VOLUME` when the projected discount comes from the multi-product schedule; `OVERRIDE` when an administrator's discount applies.
+    attr_accessor :projected_discount_source
+
+    # Projected discount amount in cents after the change.
+    attr_accessor :projected_discount_amount_cents
+
+    # Projected final monthly total in cents after the change.
+    attr_accessor :projected_total_cents
+
+    attr_accessor :projected_next_tier
+
+    # Per-product breakdown of changes the desired state would produce. Products that would remain unchanged are omitted.
+    attr_accessor :changes
+
+    # Total amount that would be charged at confirmation time, in cents. The sum of `prorated_charge_today_cents` across `IMMEDIATE` changes.
+    attr_accessor :total_charge_today_cents
+
+    # Projected total of the next monthly invoice in cents, after all scheduled changes have taken effect.
+    attr_accessor :next_invoice_total_cents
+
+    class EnumAttributeValidator
+      attr_reader :datatype
+      attr_reader :allowable_values
+
+      def initialize(datatype, allowable_values)
+        @allowable_values = allowable_values.map do |value|
+          case datatype.to_s
+          when /Integer/i
+            value.to_i
+          when /Float/i
+            value.to_f
+          else
+            value
+          end
+        end
+      end
+
+      def valid?(value)
+        !value || allowable_values.include?(value)
+      end
+    end
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'projected_subtotal_cents' => :'projected_subtotal_cents',
+        :'projected_discount_pct' => :'projected_discount_pct',
+        :'projected_discount_source' => :'projected_discount_source',
+        :'projected_discount_amount_cents' => :'projected_discount_amount_cents',
+        :'projected_total_cents' => :'projected_total_cents',
+        :'projected_next_tier' => :'projected_next_tier',
+        :'changes' => :'changes',
+        :'total_charge_today_cents' => :'total_charge_today_cents',
+        :'next_invoice_total_cents' => :'next_invoice_total_cents'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'projected_subtotal_cents' => :'Integer',
+        :'projected_discount_pct' => :'Integer',
+        :'projected_discount_source' => :'String',
+        :'projected_discount_amount_cents' => :'Integer',
+        :'projected_total_cents' => :'Integer',
+        :'projected_next_tier' => :'NextTierResponse',
+        :'changes' => :'Array<SubscriptionChangeProjection>',
+        :'total_charge_today_cents' => :'Integer',
+        :'next_invoice_total_cents' => :'Integer'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @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 `SmplkitGeneratedClient::App::SubscriptionPreviewAttributes` 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 `SmplkitGeneratedClient::App::SubscriptionPreviewAttributes`. 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?(:'projected_subtotal_cents')
+        self.projected_subtotal_cents = attributes[:'projected_subtotal_cents']
+      else
+        self.projected_subtotal_cents = nil
+      end
+
+      if attributes.key?(:'projected_discount_pct')
+        self.projected_discount_pct = attributes[:'projected_discount_pct']
+      else
+        self.projected_discount_pct = nil
+      end
+
+      if attributes.key?(:'projected_discount_source')
+        self.projected_discount_source = attributes[:'projected_discount_source']
+      else
+        self.projected_discount_source = nil
+      end
+
+      if attributes.key?(:'projected_discount_amount_cents')
+        self.projected_discount_amount_cents = attributes[:'projected_discount_amount_cents']
+      else
+        self.projected_discount_amount_cents = nil
+      end
+
+      if attributes.key?(:'projected_total_cents')
+        self.projected_total_cents = attributes[:'projected_total_cents']
+      else
+        self.projected_total_cents = nil
+      end
+
+      if attributes.key?(:'projected_next_tier')
+        self.projected_next_tier = attributes[:'projected_next_tier']
+      end
+
+      if attributes.key?(:'changes')
+        if (value = attributes[:'changes']).is_a?(Array)
+          self.changes = value
+        end
+      else
+        self.changes = nil
+      end
+
+      if attributes.key?(:'total_charge_today_cents')
+        self.total_charge_today_cents = attributes[:'total_charge_today_cents']
+      else
+        self.total_charge_today_cents = nil
+      end
+
+      if attributes.key?(:'next_invoice_total_cents')
+        self.next_invoice_total_cents = attributes[:'next_invoice_total_cents']
+      else
+        self.next_invoice_total_cents = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @projected_subtotal_cents.nil?
+        invalid_properties.push('invalid value for "projected_subtotal_cents", projected_subtotal_cents cannot be nil.')
+      end
+
+      if @projected_discount_pct.nil?
+        invalid_properties.push('invalid value for "projected_discount_pct", projected_discount_pct cannot be nil.')
+      end
+
+      if @projected_discount_source.nil?
+        invalid_properties.push('invalid value for "projected_discount_source", projected_discount_source cannot be nil.')
+      end
+
+      if @projected_discount_amount_cents.nil?
+        invalid_properties.push('invalid value for "projected_discount_amount_cents", projected_discount_amount_cents cannot be nil.')
+      end
+
+      if @projected_total_cents.nil?
+        invalid_properties.push('invalid value for "projected_total_cents", projected_total_cents cannot be nil.')
+      end
+
+      if @changes.nil?
+        invalid_properties.push('invalid value for "changes", changes cannot be nil.')
+      end
+
+      if @total_charge_today_cents.nil?
+        invalid_properties.push('invalid value for "total_charge_today_cents", total_charge_today_cents cannot be nil.')
+      end
+
+      if @next_invoice_total_cents.nil?
+        invalid_properties.push('invalid value for "next_invoice_total_cents", next_invoice_total_cents cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @projected_subtotal_cents.nil?
+      return false if @projected_discount_pct.nil?
+      return false if @projected_discount_source.nil?
+      projected_discount_source_validator = EnumAttributeValidator.new('String', ["VOLUME", "OVERRIDE"])
+      return false unless projected_discount_source_validator.valid?(@projected_discount_source)
+      return false if @projected_discount_amount_cents.nil?
+      return false if @projected_total_cents.nil?
+      return false if @changes.nil?
+      return false if @total_charge_today_cents.nil?
+      return false if @next_invoice_total_cents.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] projected_subtotal_cents Value to be assigned
+    def projected_subtotal_cents=(projected_subtotal_cents)
+      if projected_subtotal_cents.nil?
+        fail ArgumentError, 'projected_subtotal_cents cannot be nil'
+      end
+
+      @projected_subtotal_cents = projected_subtotal_cents
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] projected_discount_pct Value to be assigned
+    def projected_discount_pct=(projected_discount_pct)
+      if projected_discount_pct.nil?
+        fail ArgumentError, 'projected_discount_pct cannot be nil'
+      end
+
+      @projected_discount_pct = projected_discount_pct
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] projected_discount_source Object to be assigned
+    def projected_discount_source=(projected_discount_source)
+      validator = EnumAttributeValidator.new('String', ["VOLUME", "OVERRIDE"])
+      unless validator.valid?(projected_discount_source)
+        fail ArgumentError, "invalid value for \"projected_discount_source\", must be one of #{validator.allowable_values}."
+      end
+      @projected_discount_source = projected_discount_source
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] projected_discount_amount_cents Value to be assigned
+    def projected_discount_amount_cents=(projected_discount_amount_cents)
+      if projected_discount_amount_cents.nil?
+        fail ArgumentError, 'projected_discount_amount_cents cannot be nil'
+      end
+
+      @projected_discount_amount_cents = projected_discount_amount_cents
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] projected_total_cents Value to be assigned
+    def projected_total_cents=(projected_total_cents)
+      if projected_total_cents.nil?
+        fail ArgumentError, 'projected_total_cents cannot be nil'
+      end
+
+      @projected_total_cents = projected_total_cents
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] changes Value to be assigned
+    def changes=(changes)
+      if changes.nil?
+        fail ArgumentError, 'changes cannot be nil'
+      end
+
+      @changes = changes
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] total_charge_today_cents Value to be assigned
+    def total_charge_today_cents=(total_charge_today_cents)
+      if total_charge_today_cents.nil?
+        fail ArgumentError, 'total_charge_today_cents cannot be nil'
+      end
+
+      @total_charge_today_cents = total_charge_today_cents
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] next_invoice_total_cents Value to be assigned
+    def next_invoice_total_cents=(next_invoice_total_cents)
+      if next_invoice_total_cents.nil?
+        fail ArgumentError, 'next_invoice_total_cents cannot be nil'
+      end
+
+      @next_invoice_total_cents = next_invoice_total_cents
+    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 &&
+          projected_subtotal_cents == o.projected_subtotal_cents &&
+          projected_discount_pct == o.projected_discount_pct &&
+          projected_discount_source == o.projected_discount_source &&
+          projected_discount_amount_cents == o.projected_discount_amount_cents &&
+          projected_total_cents == o.projected_total_cents &&
+          projected_next_tier == o.projected_next_tier &&
+          changes == o.changes &&
+          total_charge_today_cents == o.total_charge_today_cents &&
+          next_invoice_total_cents == o.next_invoice_total_cents
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [projected_subtotal_cents, projected_discount_pct, projected_discount_source, projected_discount_amount_cents, projected_total_cents, projected_next_tier, changes, total_charge_today_cents, next_invoice_total_cents].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end